wingfoil 0.2.1 → 0.3.0

package/dist/memory/git-log.d.ts

@@ -21,12 +21,24 @@
  * a single leading `\n` on each record's first field after the first, and that is stripped; both call
  * sites put `%H` first, which never legitimately begins with one.
  *
- * Returns `[]` — never throws — both when `root` is not a git repository at all and when none of
- * `pathspecs` has any matching history; "not a repo"/"not found" is a caller concern, not this
- * primitive's (mirrors `getMemoryHistory`'s original contract). That now holds at EVERY arity: with
- * no matching commits git prints nothing, the split yields one piece, and dropping it leaves nothing
- * to group. An empty `fields` requests nothing and likewise yields `[]`, rather than looping forever
- * over zero-width groups.
+ * Returns `[]` when none of `pathspecs` has any matching history — git prints nothing, the split
+ * yields one piece, and dropping it leaves nothing to group, at EVERY arity — and when the repository
+ * has no commit yet: an unborn `HEAD` makes git exit `128`, and `isUnbornHead` confirms that
+ * is the reason. An empty `fields` requests nothing and likewise yields `[]`, rather than looping
+ * forever over zero-width groups.
+ *
+ * `--no-show-signature` is passed so a `log.showSignature` configuration cannot print signature text
+ * before a commit's formatted output, where it would land in the record's first field (`task-268`,
+ * `bug-291`); and every `%H` field is checked to be a full commit name (`requireCommitName`), so
+ * whatever arrives there anyway is refused rather than used.
+ *
+ * **Every other failure throws** `StorageError` `E_GIT_READ_FAILED` carrying git's own message
+ * (`task-142`): a `root` that is not a repository, a tree git cannot read, an output past the read
+ * buffer. It used to return `[]` for all of them, so an oversized walk — Node's 1 MiB default buffer,
+ * `ENOBUFS` — read as "this document has no history", and an audit over it as a clean pass
+ * (`bug-072-oversized-git-log-becomes-empty-history`). git runs through `runGitRead`
+ * (`src/storage/git-read.ts`), so its stderr travels inside that error and never reaches the
+ * operator's terminal (`bug-093-two-more-git-calls-inherit-the-operator-stderr`).
  */
 export declare function walkGitLogFields(root: string, fields: readonly string[], pathspecs: readonly string[], extraArgs?: readonly string[]): string[][];
 //# sourceMappingURL=git-log.d.ts.map

package/dist/memory/git-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-log.d.ts","sourceRoot":"","sources":["../../src/memory/git-log.ts"],"names":[],"mappings":"AA2CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,MAAM,EAAE,EAAE,CA6BZ"}
+{"version":3,"file":"git-log.d.ts","sourceRoot":"","sources":["../../src/memory/git-log.ts"],"names":[],"mappings":"AAwDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,MAAM,EAAE,EAAE,CA4BZ"}

package/dist/memory/git-log.js

@@ -8,7 +8,18 @@ exports.walkGitLogFields = walkGitLogFields;
  * first" plumbing over a different field set/pathspec shape; this is that one shared primitive, so
  * the record-separator convention lives in exactly one place instead of being copy-pasted twice.
  */
-const child_process_1 = require("child_process");
+const storage_1 = require("../storage");
+/** The exit status git uses for `fatal:` — a broken repository, and an unborn `HEAD` alike. */
+const GIT_FATAL = 128;
+/**
+ * Whether `root` is a repository with no commit yet — the one `fatal:` of a `git log` that is an
+ * answer ("nothing has been recorded") rather than a failure. `rev-parse --verify --quiet` exits `1`,
+ * printing nothing, for a `HEAD` that names no commit; outside a repository it exits `128` like the
+ * walk did. Asked only after the walk has failed, so a healthy walk costs no extra process.
+ */
+function isUnbornHead(root) {
+    return (0, storage_1.runGitRead)(root, ['rev-parse', '--verify', '--quiet', 'HEAD^{commit}'], { accepted: [0, 1, GIT_FATAL] }).status === 1;
+}
 /**
  * The `--format` placeholder git expands to a single NUL byte, used to delimit BOTH the fields of a
  * commit and one commit's record from the next. A literal NUL cannot be written into the format
@@ -64,24 +75,37 @@ const NUL = String.fromCharCode(0);
  * a single leading `\n` on each record's first field after the first, and that is stripped; both call
  * sites put `%H` first, which never legitimately begins with one.
  *
- * Returns `[]` — never throws — both when `root` is not a git repository at all and when none of
- * `pathspecs` has any matching history; "not a repo"/"not found" is a caller concern, not this
- * primitive's (mirrors `getMemoryHistory`'s original contract). That now holds at EVERY arity: with
- * no matching commits git prints nothing, the split yields one piece, and dropping it leaves nothing
- * to group. An empty `fields` requests nothing and likewise yields `[]`, rather than looping forever
- * over zero-width groups.
+ * Returns `[]` when none of `pathspecs` has any matching history — git prints nothing, the split
+ * yields one piece, and dropping it leaves nothing to group, at EVERY arity — and when the repository
+ * has no commit yet: an unborn `HEAD` makes git exit `128`, and `isUnbornHead` confirms that
+ * is the reason. An empty `fields` requests nothing and likewise yields `[]`, rather than looping
+ * forever over zero-width groups.
+ *
+ * `--no-show-signature` is passed so a `log.showSignature` configuration cannot print signature text
+ * before a commit's formatted output, where it would land in the record's first field (`task-268`,
+ * `bug-291`); and every `%H` field is checked to be a full commit name (`requireCommitName`), so
+ * whatever arrives there anyway is refused rather than used.
+ *
+ * **Every other failure throws** `StorageError` `E_GIT_READ_FAILED` carrying git's own message
+ * (`task-142`): a `root` that is not a repository, a tree git cannot read, an output past the read
+ * buffer. It used to return `[]` for all of them, so an oversized walk — Node's 1 MiB default buffer,
+ * `ENOBUFS` — read as "this document has no history", and an audit over it as a clean pass
+ * (`bug-072-oversized-git-log-becomes-empty-history`). git runs through `runGitRead`
+ * (`src/storage/git-read.ts`), so its stderr travels inside that error and never reaches the
+ * operator's terminal (`bug-093-two-more-git-calls-inherit-the-operator-stderr`).
  */
 function walkGitLogFields(root, fields, pathspecs, extraArgs = []) {
     if (fields.length === 0)
         return [];
     const format = fields.map((field) => `${field}${NUL_PLACEHOLDER}`).join('');
-    let stdout;
-    try {
-        stdout = (0, child_process_1.execFileSync)('git', ['-C', root, 'log', ...extraArgs, `--format=${format}`, '--', ...pathspecs], { encoding: 'utf-8' });
-    }
-    catch {
-        return [];
+    const args = ['log', '--no-show-signature', ...extraArgs, `--format=${format}`, '--', ...pathspecs];
+    const run = (0, storage_1.runGitRead)(root, args, { accepted: [0, GIT_FATAL] });
+    if (run.status === GIT_FATAL) {
+        if (isUnbornHead(root))
+            return [];
+        throw new storage_1.StorageError(storage_1.E_GIT_READ_FAILED, `git ${args.join(' ')} failed in ${root}: ${run.stderr.trim()}`);
     }
+    const stdout = run.stdout;
     // The stream is `<f1>NUL<f2>NUL…<fn>NUL` per commit, each run terminated by git's own newline, so
     // the text after the FINAL NUL is never a field — it is that newline, or the empty string when git
     // printed nothing at all. Drop it before grouping; at `fields.length === 1` it would otherwise be
@@ -89,10 +113,13 @@ function walkGitLogFields(root, fields, pathspecs, extraArgs = []) {
     // are records thereafter.
     const pieces = stdout.split(NUL);
     pieces.pop();
+    const commitNameSlots = fields.flatMap((field, index) => (field === '%H' ? [index] : []));
     const records = [];
     for (let index = 0; index + fields.length <= pieces.length; index += fields.length) {
         const record = pieces.slice(index, index + fields.length);
         record[0] = record[0].replace(/^\n+/, '');
+        for (const index of commitNameSlots)
+            (0, storage_1.requireCommitName)(record[index], 'git log');
         records.push(record);
     }
     return records.reverse();

package/dist/memory/git-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"git-log.js","sourceRoot":"","sources":["../../src/memory/git-log.ts"],"names":[],"mappings":";;AAyEA,4CAkCC;AA3GD;;;;;;GAMG;AACH,iDAA6C;AAE7C;;;;;GAKG;AACH,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,gBAAgB,CAC9B,IAAY,EACZ,MAAyB,EACzB,SAA4B,EAC5B,YAA+B,EAAE;IAEjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5E,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,4BAAY,EACnB,KAAK,EACL,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,YAAY,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,EAC3E,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,kGAAkG;IAClG,mGAAmG;IACnG,kGAAkG;IAClG,kGAAkG;IAClG,0BAA0B;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,EAAE,CAAC;IACb,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACnF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,GAAI,MAAM,CAAC,CAAC,CAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"git-log.js","sourceRoot":"","sources":["../../src/memory/git-log.ts"],"names":[],"mappings":"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"}

package/dist/memory/history.d.ts

@@ -20,7 +20,29 @@ export interface MemoryHistoryEntry {
      * (`task-097-memory-history-reads-each-commit-at-its-historical-path`).
      */
     readonly path: string;
+    /**
+     * The root-relative path the document occupied in this commit's **first parent** — where its state
+     * before the commit is read (`task-278`, `bug-308`) — or `null` when the commit created it there:
+     * an `A` edge, or a `C` edge from the template the element was copied from (which the parent holds,
+     * not the element). The source of a rename (`R`), the commit's own path otherwise.
+     *
+     * Read off the same `--follow --name-status` line as {@link path} ({@link parseParentPaths}), never
+     * from the walk's previous entry: the walk is ordered by date, not by ancestry, so on interleaved
+     * branches the previous entry is another branch's commit. Set on every entry
+     * {@link getMemoryHistory} returns ({@link WalkedHistoryEntry}); optional here only so that the pure
+     * helpers' inputs, built before it is known, keep this shape. A commit git printed no diff for
+     * (a merge) gets its own {@link path} ({@link attachParentPaths}).
+     */
+    readonly parentPath?: string | null;
 }
+/**
+ * A {@link MemoryHistoryEntry} as {@link getMemoryHistory} returns it: {@link MemoryHistoryEntry.parentPath}
+ * is always set (`task-278`), so a reader never has to guess where the commit's first parent held the
+ * document.
+ */
+export type WalkedHistoryEntry = MemoryHistoryEntry & {
+    readonly parentPath: string | null;
+};
 /**
  * The sha of the commit that introduced `relativePath` as a COPY of a file that outlives it — the
  * element's own creation — or `null` when the followed chain contains no copy edge at all.
@@ -29,13 +51,13 @@ export interface MemoryHistoryEntry {
  * kinds of edge, and they mean opposite things for an audit trail:
  *
  *  - **`R` (rename)** — the element continuing under a new name. Keep following. This is not a
- *    hypothetical requirement: `docs/self/docs/04_memory/planning/v1/*` became `planning/rl-v1/*` in
+ *    hypothetical requirement: the Memory folder's `planning/v1/*` became `planning/rl-v1/*` in
  *    one commit in this repository, moving five `release` elements at once, because the `release`
  *    type's `path` pattern interpolates the release-line id (`memory.yaml`). For one of them a plain
  *    `git log -- <path>` returns a single commit where the followed walk returns seven, so dropping
  *    `--follow` would delete five sixths of that element's recorded history.
  *  - **`C` (copy)** — the element being born out of a file that still exists. `wingfoil memory add`
- *    copies the type's template verbatim (CLAUDE.md §5.1), and `wingfoil init` has already committed
+ *    copies the type's template verbatim (AGENTS.md §5.1), and `wingfoil init` has already committed
  *    that template, so this edge is how every scaffolded element begins. Everything strictly older
  *    than it is the template's history, not the element's.
  *
@@ -43,10 +65,10 @@ export interface MemoryHistoryEntry {
  * whatever the source itself was copied from. `git log` prints newest first, so that is the first
  * line.
  *
- * **Throws** — never returns `null` — when git itself fails. "git could not answer" and "this
+ * **Throws** `StorageError` `E_GIT_READ_FAILED` — never returns `null` — when git itself fails,
+ * with git's own message in the error (`readOrExplain`). "git could not answer" and "this
  * element was never copied from anything" are different answers, and collapsing the first into the
- * second would silently restore the phantom entry; it is also why this cannot borrow
- * `walkGitLogFields`, whose `catch` returns `[]` (`bug-072-oversized-git-log-becomes-empty-history`).
+ * second would silently restore the phantom entry.
  * {@link getMemoryHistory} calls this only once the main walk has already returned commits, so at
  * that point the repository and the path are both known good and a failure here is genuinely
  * exceptional.
@@ -74,7 +96,7 @@ export declare function findElementCreationSha(root: string, relativePath: strin
  * @param creationSha - The element's creation commit, from {@link findElementCreationSha}.
  * @returns `entries` from the creation commit onward (a new array; `entries` is not mutated).
  */
-export declare function dropPreCreationAncestry(entries: readonly MemoryHistoryEntry[], creationSha: string | null): MemoryHistoryEntry[];
+export declare function dropPreCreationAncestry<Entry extends MemoryHistoryEntry>(entries: readonly Entry[], creationSha: string | null): Entry[];
 /**
  * Where `relativePath`'s document lived at each commit of its `--follow` walk, keyed by sha.
  *
@@ -89,7 +111,8 @@ export declare function dropPreCreationAncestry(entries: readonly MemoryHistoryE
  * absent from the map; {@link attachHistoricalPaths} decides what to do about that, so the rule is
  * testable without a repository.
  *
- * **Throws** — never returns an empty map — when git itself fails, for the same reason
+ * **Throws** `StorageError` `E_GIT_READ_FAILED` — never returns an empty map — when git itself
+ * fails, with git's own message in the error (`readOrExplain`), for the same reason
  * {@link findElementCreationSha} does: "git could not answer" and "this element was never renamed"
  * are different answers, and folding the first into the second silently reinstates `bug-080` by
  * reading every commit at the current path again. {@link getMemoryHistory} calls this only once the
@@ -100,6 +123,28 @@ export declare function dropPreCreationAncestry(entries: readonly MemoryHistoryE
  * @returns sha → the root-relative path the document occupied at that commit.
  */
 export declare function collectHistoricalPaths(root: string, relativePath: string): Map<string, string>;
+/**
+ * Parse {@link collectHistoricalPaths}' `git log --follow --name-status --format=%H` output into
+ * sha → the path at that commit. Pure: no git. Every line without a tab must be a full commit name and
+ * a status line must follow one; anything else is refused with `StorageError` `E_GIT_READ_FAILED`
+ * (`requireCommitName`) rather than skipped (`task-268`, `bug-291`).
+ *
+ * @param stdout - The probe's output.
+ * @returns sha → the root-relative path the document occupied at that commit (first status line wins).
+ */
+export declare function parseHistoricalPaths(stdout: string): Map<string, string>;
+/**
+ * Parse the same probe output into sha → the path the document occupied in that commit's first
+ * parent (`task-278`, `bug-308`): the FIRST path of a rename line (`R<score> <old> <new>`), `null` for
+ * a creation — `A`, or `C<score> <source> <path>`, whose source is the template the element was copied
+ * from and not the element — and the line's single path otherwise (`M`, `D`, `T`). `git log` diffs a
+ * non-merge commit against its only parent, so the line describes exactly that edge. Pure: no git;
+ * refuses what {@link parseHistoricalPaths} refuses.
+ *
+ * @param stdout - The probe's output.
+ * @returns sha → the first parent's root-relative path, or `null` (first status line wins).
+ */
+export declare function parseParentPaths(stdout: string): Map<string, string | null>;
 /**
  * Stamp each walked commit with the path the element occupied at it, from
  * {@link collectHistoricalPaths}' map.
@@ -119,6 +164,20 @@ export declare function collectHistoricalPaths(root: string, relativePath: strin
  * @returns A new array; `entries` is not mutated.
  */
 export declare function attachHistoricalPaths(entries: readonly MemoryHistoryEntry[], pathBySha: ReadonlyMap<string, string>, fallbackPath: string): MemoryHistoryEntry[];
+/**
+ * Stamp each walked commit with the path the element occupied in its first parent, from
+ * {@link parseParentPaths}' map (`task-278`, `bug-308`). Pure, like {@link attachHistoricalPaths},
+ * and with the same fallback for a sha the probe printed no line for — git shows no diff for a merge:
+ * the entry's own {@link MemoryHistoryEntry.path}, so a merge is read against its first parent at the
+ * path it holds itself. (`git log --follow` lists no merge commit in the shapes this repository
+ * produces — `bug-308`'s reproduction walked the three non-merge commits only — so the fallback is
+ * the rule for one, not a path the walk is known to take.)
+ *
+ * @param entries - The walk, oldest first, each already carrying its own path.
+ * @param parentPathBySha - sha → the first parent's path or `null`, from {@link parseParentPaths}.
+ * @returns A new array; `entries` is not mutated.
+ */
+export declare function attachParentPaths(entries: readonly MemoryHistoryEntry[], parentPathBySha: ReadonlyMap<string, string | null>): WalkedHistoryEntry[];
 /**
  * Walk every commit that touched `relativePath`, oldest first (P1.10-memory-history.feature: "lists
  * ... entries in chronological order") — `git log` itself returns newest-first, reversed by
@@ -126,11 +185,13 @@ export declare function attachHistoricalPaths(entries: readonly MemoryHistoryEnt
  * disk keeps its history, but stops at the element's own creation rather than continuing into the
  * template it was copied from ({@link findElementCreationSha}).
  *
- * Returns `[]`, rather than throwing, both when `root` has no commits touching the path at all and
- * when `root` is not a git repository — "document not found" is a caller/feature-layer concern
- * (task-021/026-style CLI error rendering), not this primitive's. That is also why the creation
- * probe runs only on a non-empty walk: on an empty one there is nothing to truncate and nothing to
- * conclude from git's silence — and the same for the path probe.
+ * Returns `[]` when no commit touches the path, or the repository has none yet — "document not
+ * found" is a caller/feature-layer concern (task-021/026-style CLI error rendering), not this
+ * primitive's. That is also why the creation probe runs only on a non-empty walk: on an empty one
+ * there is nothing to truncate and nothing to conclude from git's silence — and the same for the path
+ * probe. **A git failure throws** `StorageError` `E_GIT_READ_FAILED` — a `root` that is not a
+ * repository included — rather than reading as an empty history (task-142, `bug-072`; see
+ * {@link walkGitLogFields}).
  *
  * Every returned entry carries the path the element occupied at its own commit
  * ({@link MemoryHistoryEntry.path}), not the one the caller named. That is what makes this walk the
@@ -138,5 +199,5 @@ export declare function attachHistoricalPaths(entries: readonly MemoryHistoryEnt
  * commit — `./audit`'s `reconstructMemoryTransitions`, which reads the frontmatter `status:` — must
  * take the path from here rather than re-using its own argument (`bug-080`).
  */
-export declare function getMemoryHistory(root: string, relativePath: string): MemoryHistoryEntry[];
+export declare function getMemoryHistory(root: string, relativePath: string): WalkedHistoryEntry[];
 //# sourceMappingURL=history.d.ts.map

package/dist/memory/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/memory/history.ts"],"names":[],"mappings":"AAiCA,sGAAsG;AACtG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAexF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,kBAAkB,EAAE,CAUtB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B9F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,YAAY,EAAE,MAAM,GACnB,kBAAkB,EAAE,CAEtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA4BzF"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/memory/history.ts"],"names":[],"mappings":"AAiCA,sGAAsG;AACtG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAgC7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASxF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,kBAAkB,EACtE,OAAO,EAAE,SAAS,KAAK,EAAE,EACzB,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,KAAK,EAAE,CAUT;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE9F;AAoCD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAS3E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,YAAY,EAAE,MAAM,GACnB,kBAAkB,EAAE,CAEtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAClD,kBAAkB,EAAE,CAKtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA8BzF"}

package/dist/memory/history.js

@@ -3,7 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.findElementCreationSha = findElementCreationSha;
 exports.dropPreCreationAncestry = dropPreCreationAncestry;
 exports.collectHistoricalPaths = collectHistoricalPaths;
+exports.parseHistoricalPaths = parseHistoricalPaths;
+exports.parseParentPaths = parseParentPaths;
 exports.attachHistoricalPaths = attachHistoricalPaths;
+exports.attachParentPaths = attachParentPaths;
 exports.getMemoryHistory = getMemoryHistory;
 /**
  * Memory history primitive (task-008-dna-memory-query-latency, REQ-PERF-02) — the git-log walk
@@ -15,7 +18,7 @@ exports.getMemoryHistory = getMemoryHistory;
  * Scope (see task-008's Execution Notes): this returns *structured commit records* (sha, author
  * name/email, ISO-8601 author date, subject, body) — the walk itself. Deriving a human-facing
  * "state change" (e.g. "pending -> backlog") from the commit body's `Approver:`/`Reason:` lines
- * (CLAUDE.md §5.1) is not this primitive's concern; the raw `body` field carries that text verbatim
+ * (AGENTS.md §5.1) is not this primitive's concern; the raw `body` field carries that text verbatim
  * for a caller to parse, and `./audit`'s `reconstructMemoryTransitions` is the caller that does — the
  * `memoryHistory` operation projects that reconstruction rather than re-reading this walk itself.
  *
@@ -34,9 +37,24 @@ exports.getMemoryHistory = getMemoryHistory;
  * {@link findElementCreationSha} for the distinction that resolves it and why rename-following is
  * kept rather than traded away.
  */
-const child_process_1 = require("child_process");
+const storage_1 = require("../storage");
 const git_log_1 = require("./git-log");
 const LOG_FIELDS = ['%H', '%an', '%ae', '%aI', '%s', '%b'];
+/**
+ * Run one of this module's probes through `runGitRead` (`src/storage/git-read.ts`, task-142) and
+ * return its stdout, or throw `StorageError` `E_GIT_READ_FAILED` whose message says what the failure
+ * leaves unknown (`what`) and then git's own text. stderr is captured, never inherited: git's `fatal:`
+ * reaches the caller inside this error, not the operator's terminal on its own
+ * (`bug-093-two-more-git-calls-inherit-the-operator-stderr`, `bug-097`).
+ */
+function readOrExplain(root, args, what) {
+    try {
+        return (0, storage_1.runGitRead)(root, args).stdout;
+    }
+    catch (error) {
+        throw new storage_1.StorageError(storage_1.E_GIT_READ_FAILED, `${what}: ${error.message.replace(/^E_GIT_READ_FAILED: /, '')}`);
+    }
+}
 /**
  * The same `--follow` walk as {@link getMemoryHistory}, narrowed by git to the commits whose edge for
  * this path is a **copy**, and printing nothing but the sha. Deliberately a second `git log`
@@ -44,6 +62,9 @@ const LOG_FIELDS = ['%H', '%an', '%ae', '%aI', '%s', '%b'];
  * records by field arity over a stream of `<field>NUL` groups, so anything git appends outside the
  * `--format` string — `--name-status` output, for instance — would be read as the next record's
  * first field (task-086).
+ *
+ * Like every `git log` reader, it runs with `--no-show-signature` (`task-268`, `bug-291`): under
+ * `log.showSignature` git printed "No signature" here as the first line, read as the creation commit.
  */
 const CREATION_PROBE_ARGS = ['--follow', '--diff-filter=C', '--format=%H'];
 /**
@@ -54,13 +75,13 @@ const CREATION_PROBE_ARGS = ['--follow', '--diff-filter=C', '--format=%H'];
  * kinds of edge, and they mean opposite things for an audit trail:
  *
  *  - **`R` (rename)** — the element continuing under a new name. Keep following. This is not a
- *    hypothetical requirement: `docs/self/docs/04_memory/planning/v1/*` became `planning/rl-v1/*` in
+ *    hypothetical requirement: the Memory folder's `planning/v1/*` became `planning/rl-v1/*` in
  *    one commit in this repository, moving five `release` elements at once, because the `release`
  *    type's `path` pattern interpolates the release-line id (`memory.yaml`). For one of them a plain
  *    `git log -- <path>` returns a single commit where the followed walk returns seven, so dropping
  *    `--follow` would delete five sixths of that element's recorded history.
  *  - **`C` (copy)** — the element being born out of a file that still exists. `wingfoil memory add`
- *    copies the type's template verbatim (CLAUDE.md §5.1), and `wingfoil init` has already committed
+ *    copies the type's template verbatim (AGENTS.md §5.1), and `wingfoil init` has already committed
  *    that template, so this edge is how every scaffolded element begins. Everything strictly older
  *    than it is the template's history, not the element's.
  *
@@ -68,10 +89,10 @@ const CREATION_PROBE_ARGS = ['--follow', '--diff-filter=C', '--format=%H'];
  * whatever the source itself was copied from. `git log` prints newest first, so that is the first
  * line.
  *
- * **Throws** — never returns `null` — when git itself fails. "git could not answer" and "this
+ * **Throws** `StorageError` `E_GIT_READ_FAILED` — never returns `null` — when git itself fails,
+ * with git's own message in the error (`readOrExplain`). "git could not answer" and "this
  * element was never copied from anything" are different answers, and collapsing the first into the
- * second would silently restore the phantom entry; it is also why this cannot borrow
- * `walkGitLogFields`, whose `catch` returns `[]` (`bug-072-oversized-git-log-becomes-empty-history`).
+ * second would silently restore the phantom entry.
  * {@link getMemoryHistory} calls this only once the main walk has already returned commits, so at
  * that point the repository and the path are both known good and a failure here is genuinely
  * exceptional.
@@ -81,17 +102,9 @@ const CREATION_PROBE_ARGS = ['--follow', '--diff-filter=C', '--format=%H'];
  * @returns The creation commit's full sha, or `null` when the chain has no copy edge.
  */
 function findElementCreationSha(root, relativePath) {
-    let stdout;
-    try {
-        stdout = (0, child_process_1.execFileSync)('git', ['-C', root, 'log', ...CREATION_PROBE_ARGS, '--', relativePath], {
-            encoding: 'utf-8',
-        });
-    }
-    catch (cause) {
-        throw new Error(`git log --follow --diff-filter=C failed for ${relativePath}: cannot establish where the element was created`, { cause });
-    }
+    const stdout = readOrExplain(root, ['log', '--no-show-signature', ...CREATION_PROBE_ARGS, '--', relativePath], `git log --follow --diff-filter=C failed for ${relativePath}: cannot establish where the element was created`);
     const newestCopy = stdout.split('\n').find((line) => line.trim().length > 0);
-    return newestCopy === undefined ? null : newestCopy.trim();
+    return newestCopy === undefined ? null : (0, storage_1.requireCommitName)(newestCopy.trim(), 'git log --follow --diff-filter=C');
 }
 /**
  * Drop the part of an oldest-first walk that precedes the element's creation, keeping the creation
@@ -130,11 +143,12 @@ function dropPreCreationAncestry(entries, creationSha) {
  * `core.quotePath=false` is set for the invocation (never written to the repository's config) so a
  * path carrying non-ASCII bytes arrives as its own UTF-8 rather than as git's `"\303\251"` escape
  * form — the parser would otherwise have to un-escape it to hand `git show` something that resolves.
+ * Load-bearing, and pinned: `test/memory/history-rename-path.test.ts` (task-142 AC3, `bug-097`) goes
+ * red when the flag is removed. `--no-show-signature`, as on every `git log` reader (`task-268`,
+ * `bug-291`), keeps signature text out of the lines parsed as names.
  */
 const PATH_PROBE_ARGS = ['-c', 'core.quotePath=false'];
 const PATH_PROBE_LOG_ARGS = ['--follow', '--name-status', '--format=%H'];
-/** A full sha on a line of its own — git's `--format=%H` output, which carries nothing else. */
-const SHA_LINE_RE = /^[0-9a-f]{40}$/;
 /**
  * Where `relativePath`'s document lived at each commit of its `--follow` walk, keyed by sha.
  *
@@ -149,7 +163,8 @@ const SHA_LINE_RE = /^[0-9a-f]{40}$/;
  * absent from the map; {@link attachHistoricalPaths} decides what to do about that, so the rule is
  * testable without a repository.
  *
- * **Throws** — never returns an empty map — when git itself fails, for the same reason
+ * **Throws** `StorageError` `E_GIT_READ_FAILED` — never returns an empty map — when git itself
+ * fails, with git's own message in the error (`readOrExplain`), for the same reason
  * {@link findElementCreationSha} does: "git could not answer" and "this element was never renamed"
  * are different answers, and folding the first into the second silently reinstates `bug-080` by
  * reading every commit at the current path again. {@link getMemoryHistory} calls this only once the
@@ -160,32 +175,78 @@ const SHA_LINE_RE = /^[0-9a-f]{40}$/;
  * @returns sha → the root-relative path the document occupied at that commit.
  */
 function collectHistoricalPaths(root, relativePath) {
-    let stdout;
-    try {
-        stdout = (0, child_process_1.execFileSync)('git', ['-C', root, ...PATH_PROBE_ARGS, 'log', ...PATH_PROBE_LOG_ARGS, '--', relativePath], 
-        // Same `stdio` rule as `./audit`'s `readStatusAt`, for the same reason
-        // (`bug-071-read-status-at-leaks-git-stderr`): the failure is reported by the throw below, so
-        // git's own `fatal:` must land in a pipe this process owns rather than on the operator's
-        // terminal. A call added while closing that bug must not reopen it somewhere else.
-        { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] });
-    }
-    catch (cause) {
-        throw new Error(`git log --follow --name-status failed for ${relativePath}: cannot establish where the element lived at each commit`, { cause });
-    }
-    const pathBySha = new Map();
+    return parseHistoricalPaths(readPathProbe(root, relativePath));
+}
+/** The `--follow --name-status` probe's output, which {@link parseHistoricalPaths} and {@link parseParentPaths} both read. */
+function readPathProbe(root, relativePath) {
+    return readOrExplain(root, [...PATH_PROBE_ARGS, 'log', '--no-show-signature', ...PATH_PROBE_LOG_ARGS, '--', relativePath], `git log --follow --name-status failed for ${relativePath}: cannot establish where the element lived at each commit`);
+}
+/**
+ * sha → the tab-separated fields of that commit's first status line in the probe's output (`M`,
+ * `<path>`, or `R<score>`, `<old>`, `<new>`). Every line without a tab must be a full commit name and
+ * a status line must follow one; anything else is refused with `StorageError` `E_GIT_READ_FAILED`
+ * (`requireCommitName`) rather than skipped (`task-268`, `bug-291`).
+ */
+function parseStatusLines(stdout) {
+    const fieldsBySha = new Map();
     let currentSha = null;
     for (const line of stdout.split('\n')) {
-        if (SHA_LINE_RE.test(line)) {
-            currentSha = line;
+        if (line === '')
+            continue;
+        // A line with no tab is `--format=%H`'s: a commit name, or refused — never skipped (task-268,
+        // `bug-291`: signature text printed under `log.showSignature` was skipped here, silently).
+        if (!line.includes('\t')) {
+            currentSha = (0, storage_1.requireCommitName)(line, 'git log --follow --name-status');
             continue;
         }
-        if (currentSha === null || !line.includes('\t') || pathBySha.has(currentSha))
+        // A status line before any name is not what `--format=%H` prints: refused like any other line.
+        if (currentSha === null)
+            currentSha = (0, storage_1.requireCommitName)(line, 'git log --follow --name-status');
+        if (fieldsBySha.has(currentSha))
             continue;
-        const fields = line.split('\t');
-        pathBySha.set(currentSha, fields[fields.length - 1]);
+        fieldsBySha.set(currentSha, line.split('\t'));
     }
+    return fieldsBySha;
+}
+/**
+ * Parse {@link collectHistoricalPaths}' `git log --follow --name-status --format=%H` output into
+ * sha → the path at that commit. Pure: no git. Every line without a tab must be a full commit name and
+ * a status line must follow one; anything else is refused with `StorageError` `E_GIT_READ_FAILED`
+ * (`requireCommitName`) rather than skipped (`task-268`, `bug-291`).
+ *
+ * @param stdout - The probe's output.
+ * @returns sha → the root-relative path the document occupied at that commit (first status line wins).
+ */
+function parseHistoricalPaths(stdout) {
+    const pathBySha = new Map();
+    for (const [sha, fields] of parseStatusLines(stdout))
+        pathBySha.set(sha, fields[fields.length - 1]);
     return pathBySha;
 }
+/**
+ * Parse the same probe output into sha → the path the document occupied in that commit's first
+ * parent (`task-278`, `bug-308`): the FIRST path of a rename line (`R<score> <old> <new>`), `null` for
+ * a creation — `A`, or `C<score> <source> <path>`, whose source is the template the element was copied
+ * from and not the element — and the line's single path otherwise (`M`, `D`, `T`). `git log` diffs a
+ * non-merge commit against its only parent, so the line describes exactly that edge. Pure: no git;
+ * refuses what {@link parseHistoricalPaths} refuses.
+ *
+ * @param stdout - The probe's output.
+ * @returns sha → the first parent's root-relative path, or `null` (first status line wins).
+ */
+function parseParentPaths(stdout) {
+    const parentPathBySha = new Map();
+    for (const [sha, fields] of parseStatusLines(stdout)) {
+        const status = fields[0];
+        if (status.startsWith('A') || status.startsWith('C'))
+            parentPathBySha.set(sha, null);
+        else if (status.startsWith('R'))
+            parentPathBySha.set(sha, fields[1]);
+        else
+            parentPathBySha.set(sha, fields[fields.length - 1]);
+    }
+    return parentPathBySha;
+}
 /**
  * Stamp each walked commit with the path the element occupied at it, from
  * {@link collectHistoricalPaths}' map.
@@ -207,6 +268,25 @@ function collectHistoricalPaths(root, relativePath) {
 function attachHistoricalPaths(entries, pathBySha, fallbackPath) {
     return entries.map((entry) => ({ ...entry, path: pathBySha.get(entry.sha) ?? fallbackPath }));
 }
+/**
+ * Stamp each walked commit with the path the element occupied in its first parent, from
+ * {@link parseParentPaths}' map (`task-278`, `bug-308`). Pure, like {@link attachHistoricalPaths},
+ * and with the same fallback for a sha the probe printed no line for — git shows no diff for a merge:
+ * the entry's own {@link MemoryHistoryEntry.path}, so a merge is read against its first parent at the
+ * path it holds itself. (`git log --follow` lists no merge commit in the shapes this repository
+ * produces — `bug-308`'s reproduction walked the three non-merge commits only — so the fallback is
+ * the rule for one, not a path the walk is known to take.)
+ *
+ * @param entries - The walk, oldest first, each already carrying its own path.
+ * @param parentPathBySha - sha → the first parent's path or `null`, from {@link parseParentPaths}.
+ * @returns A new array; `entries` is not mutated.
+ */
+function attachParentPaths(entries, parentPathBySha) {
+    return entries.map((entry) => ({
+        ...entry,
+        parentPath: parentPathBySha.has(entry.sha) ? parentPathBySha.get(entry.sha) : entry.path,
+    }));
+}
 /**
  * Walk every commit that touched `relativePath`, oldest first (P1.10-memory-history.feature: "lists
  * ... entries in chronological order") — `git log` itself returns newest-first, reversed by
@@ -214,11 +294,13 @@ function attachHistoricalPaths(entries, pathBySha, fallbackPath) {
  * disk keeps its history, but stops at the element's own creation rather than continuing into the
  * template it was copied from ({@link findElementCreationSha}).
  *
- * Returns `[]`, rather than throwing, both when `root` has no commits touching the path at all and
- * when `root` is not a git repository — "document not found" is a caller/feature-layer concern
- * (task-021/026-style CLI error rendering), not this primitive's. That is also why the creation
- * probe runs only on a non-empty walk: on an empty one there is nothing to truncate and nothing to
- * conclude from git's silence — and the same for the path probe.
+ * Returns `[]` when no commit touches the path, or the repository has none yet — "document not
+ * found" is a caller/feature-layer concern (task-021/026-style CLI error rendering), not this
+ * primitive's. That is also why the creation probe runs only on a non-empty walk: on an empty one
+ * there is nothing to truncate and nothing to conclude from git's silence — and the same for the path
+ * probe. **A git failure throws** `StorageError` `E_GIT_READ_FAILED` — a `root` that is not a
+ * repository included — rather than reading as an empty history (task-142, `bug-072`; see
+ * {@link walkGitLogFields}).
  *
  * Every returned entry carries the path the element occupied at its own commit
  * ({@link MemoryHistoryEntry.path}), not the one the caller named. That is what makes this walk the
@@ -243,8 +325,10 @@ function getMemoryHistory(root, relativePath) {
         return { sha, authorName, authorEmail, date, subject, body: body.trim(), path: relativePath };
     });
     if (entries.length === 0)
-        return entries;
-    const located = attachHistoricalPaths(entries, collectHistoricalPaths(root, relativePath), relativePath);
+        return [];
+    // One probe answers both questions: where the document was at each commit, and in its first parent.
+    const probe = readPathProbe(root, relativePath);
+    const located = attachParentPaths(attachHistoricalPaths(entries, parseHistoricalPaths(probe), relativePath), parseParentPaths(probe));
     return dropPreCreationAncestry(located, findElementCreationSha(root, relativePath));
 }
 //# sourceMappingURL=history.js.map

package/dist/memory/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/memory/history.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/memory/history.ts"],"names":[],"mappings":"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"}