Skip to content
Cockpit0.29.0
A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live

I1987

A knowledge record's file provenance survives the file's deletion

Where it stands

devtask.issue
Readiness
complete completion is recorded and every required evidence token is present
Status
DONE
Can start
not now
Milestone
Milestone status
ACTIVE
Wave
0
Waiting on
none
Holds back
none
Behind it in all
0
Evidence
1 of 1
A move writes the repository: it stamps one field of this issue's record and appends one event to the ledger, and a commit will carry both.
The same moves from a terminal

majordomus plan start I1987

majordomus plan verify I1987

majordomus plan done I1987

What it is

Objective
Let derived_from name a file at a commit (`file:<path>@<commit>`), or resolve `file:` at the record's own commit, so that deleting a cited file does not break knowledge check.
Why
OSCILLA 5467193: derived_from file:tests/engine.cjs and file:tests/smoke.cjs dangled after its V2 removed those files; under 0.12 knowledge check failed and knowledge edges exited 10, and the only fix was to cite a commit instead.
Now
file: references are resolved against the working tree only.
Wanted
A historical file reference resolves through git; knowledge check reports it as historical, not dangling.
Done when
unknown: the record declares no `completion`
Risk
unknown: the record declares no `risk`

Acceptance

  • A record citing a since-deleted file at its commit passes knowledge check
  • A file reference that never existed still fails
Validation
bin/majordomus plan validateMJ_TEST_JOBS=4 bash test/run.sh <the case this issue adds>
Evidence required
historical_file_reference_case
Evidence present
historical_file_reference_case

Scope

Touches
lib/knowledge.shshare/schemasdocs/KNOWLEDGE.mdtest/cases
Not
unknown: the record declares no `non_scope`
Depends on
unknown: the record declares no `depends_on`
Priority
p2
Profile
implementation
Parallel safe
true
Owner
unknown: the record declares no `owner`

The work so far

Branches
none
Merged
none
Commits
0
Trunk
master
Sessions
none
Created
2026-10-04
Updated
2026-10-14T14:53:24Z
Started
2026-10-14T14:53:04Z
Verified
unknown: the record declares no `verified_at`
Completed
2026-10-14T14:53:24Z

Synchronisation

Adapter
scripts/github-sync
Repository
unknown: the derived plan's header carries no repository
External issue
unknown: a live GitHub state; this executable makes no network call, so only `scripts/github-sync --check` can answer it
State there
unknown: a live GitHub state; this executable makes no network call, so only `scripts/github-sync --check` can answer it

Findings

Nothing is wrong with these records.