npm - @dzhechkov/harness-core - Versions diffs - 0.3.142 → 0.3.143 - Mend

@dzhechkov/harness-core 0.3.142 → 0.3.143

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/.dz-manifest.json CHANGED Viewed

@@ -9,7 +9,7 @@
       },
       {
         "path": "README.md",
-        "sha256": "68be78c9e65964e48cf4a9334c069f079b572f37367bc84404400eb6a5bc013a"
+        "sha256": "1b9db50b623f5737dd95a3b949d9ea85293387a010a09f4204e6a476f5127d57"
       },
       {
         "path": "coverage/coverage-final.json",
@@ -85,19 +85,19 @@
       },
       {
         "path": "dist/backlog.d.ts",
-        "sha256": "0e6b229ff5dfe8026018173f8bbc13398fe2a88411d9cedc0c4c679d6a1c2fc8"
+        "sha256": "3f3fbdb7a59c0152d0750291092b6453b0ae1ff6f6f910e99cb5facfd93b6e53"
       },
       {
         "path": "dist/backlog.d.ts.map",
-        "sha256": "99520bcd3dc3045df2e678a2be16f925b7f0f858f88ca4cc60526290c8e7c1aa"
+        "sha256": "0c96dddbd4aebe4bf085b641fcfaaa0ad149b5572471449f984364c94f78c7b3"
       },
       {
         "path": "dist/backlog.js",
-        "sha256": "f6c541c38343a7d7ac6e07e5bca60bb0910d83d1fe3c22089b2dae9ba41eadc9"
+        "sha256": "9208cce6400957bed310d8c0405a15128315fba59b447962e06e48fca11f6fe6"
       },
       {
         "path": "dist/backlog.js.map",
-        "sha256": "d211992f2a33bd28a164b19f3e2a9da798ccf679c29e92748742de14d8f009ff"
+        "sha256": "1dfc72d3ba2c896a43504425d4fdeb6b34dccb7d7867bc2f9a792981a57a5c48"
       },
       {
         "path": "dist/benchmark.d.ts",
@@ -405,19 +405,19 @@
       },
       {
         "path": "dist/guard.d.ts",
-        "sha256": "de51710fa4c97f71bd835b77740634708ef1fb6791e946c0c1124f3800c93bd6"
+        "sha256": "7a1df1aa511a5d96669e660b99d29ba633393e1a20dc346e1dedfa9aec221260"
       },
       {
         "path": "dist/guard.d.ts.map",
-        "sha256": "65bc9e2e658380ecfb061377d88640569f5be259093ff619c99e5d9cc8db8869"
+        "sha256": "be03334a1746d3261afe69252f119c82f3718e0608957eebf5de311acf9d8a04"
       },
       {
         "path": "dist/guard.js",
-        "sha256": "012b8841fa90e6f6b03059d3ef1ae201ba22c0c2f20cfd828ae636ba2057db7a"
+        "sha256": "dc20d0ea9ff7e1299b52ed3ce03dbd2f8bb13b1b86ee2799a49837f33ec33883"
       },
       {
         "path": "dist/guard.js.map",
-        "sha256": "46a8ef893bfba84586883fbcabdf031e151cf59d3cb4947958549a5d451bc5b8"
+        "sha256": "1696212693b8cd400ff6d2af843e2901ad0e79679ddd09ea9831306aa75e342a"
       },
       {
         "path": "dist/import-ecc.d.ts",
@@ -1029,7 +1029,7 @@
       },
       {
         "path": "package.json",
-        "sha256": "22f5f6bac0cc06e227e205b14388ae2ca8dd17a1a6a3abfa8458a21d104df772"
+        "sha256": "55ce25bcbdeef7f26e93f1e14db495bf858644a0285b5d0bf3236a69d8d8013c"
       },
       {
         "path": "src/__tests__/golden-baseline.test.ts",
@@ -1049,7 +1049,7 @@
       },
       {
         "path": "src/backlog.ts",
-        "sha256": "e5173f2eafa803a5aaf0be03e238b5bc567f876fcb3caed4bae2148173baa998"
+        "sha256": "7418f3809477f66b524d69f3f438aaaea818451396b360fe509285f52db21767"
       },
       {
         "path": "src/benchmark.ts",
@@ -1129,7 +1129,7 @@
       },
       {
         "path": "src/guard.ts",
-        "sha256": "c0c8e4a58aff130a35c60d5de694ab7de851ea518008b70ad0b14b76318ebefd"
+        "sha256": "f56d5f5e59e9ddecae339b054b9f888b81b3410c56d3a09eedd7be3c11d3438c"
       },
       {
         "path": "src/import-ecc.ts",
@@ -1305,7 +1305,7 @@
       },
       {
         "path": "test/backlog.test.ts",
-        "sha256": "551e107380c9be270770266ebb258495825d942150c12c305345970de7f666b5"
+        "sha256": "9b6bf3726a14f774913440ee3053276e88a4dcaf1265ae48d8015bc4985489f1"
       },
       {
         "path": "test/benchmark-s15.test.ts",
@@ -1425,7 +1425,7 @@
       },
       {
         "path": "test/guard.test.ts",
-        "sha256": "faf423970912978594624a70674aa152605819aa3407fdbae45770f3006bdc0b"
+        "sha256": "49829d24440130cfe403a410b9068a76631c68e9baa2cfc978f5029df2d72f3a"
       },
       {
         "path": "test/harmonize.test.ts",
@@ -1609,5 +1609,5 @@
       }
     ]
   },
-  "signature": "jv05WfJ6g7MzLtIGL0VFAprgoBluIXiJCK2LmIHlimELGbeQSF9j483u0mG9VpGm6w/WVY4GBJTVedRsauZwBA=="
+  "signature": "jw8HFZWuwcRLzgJr47J6p0zqYUFwkZJPqVArPEjlMNp7wZt3jP9dD1XEzGizuP5AlfJzsYsb5iO4MIt+z847AQ=="
 }

package/README.md CHANGED Viewed

@@ -11,7 +11,8 @@ and any other consumer.
 | `apply` | `applyEmitResult` | Write an adapter `EmitResult` to disk — **additively** |
 | `targets` | `TARGETS`, `TargetName`, `isTargetName` | `--target` name → platform adapter |
 | `sign` (walks) | `listPackFiles`, `listSignablePackFiles` | Shared node_modules/.git exclusions; verify sees MORE than sign (smuggled symlinks still fail) |
-| `guard` | `evaluateGuard`, `resolveRules`, `scanSecrets`, `DEFAULT_RULES` | Declarative HARD/SOFT constraint engine behind `dz guard` (publish/teach/consolidate pre-flight; fail-closed) |
+| `guard` | `evaluateGuard`, `resolveRules`, `scanSecrets`, `DEFAULT_RULES`, `parsePnpmLockImporters` | Declarative HARD/SOFT constraint engine behind `dz guard` (publish/teach/consolidate pre-flight; fail-closed). The SOFT `lockfile-in-sync` rule compares each workspace package's `@dzhechkov/*` dep specs against the specifier `pnpm-lock.yaml` records for that importer — the `ERR_PNPM_OUTDATED_LOCKFILE` CI break, caught at publish. Its lockfile reader (`parsePnpmLockImporters`) is a pure RECOGNISE-OR-REFUSE parser (no YAML dependency): it reads only the `lockfileVersion: 9`+ importer layout and returns `undefined` for a legacy v5/v6 file, a truncated one, or any shape that leaves an importer with zero specifiers — because a half-parse reports every real dependency as "not recorded". The rule FAILS OPEN on that `undefined` (no violation) and is pinned SOFT-only via `SOFT_ONLY_RULES`, so no config can turn a parser that admits uncertainty into a publish blocker |
+| `backlog` | `dedupIdea`, `classifyDedup`, `alignIdea`, `spinRoulette`, `readGoalMapDetailed`, `parseEffort`, `ensureBacklogGitignored`, `harmonizeBacklog` | The Smart Backlog engine behind `dz backlog`: content-addressed idea records in `.dz/backlog/ideas.jsonl`, semantic dedup over the REUSED agentdb vector namespace (`dz-backlog` — no second store), weighted-max GoalMap alignment, and a seeded weighted roulette. Every band/weight decision is a PURE function. `classifyDedup` also reports the top-1 match id alongside the cosine (the calibration surface for the 0.92 duplicate band — observational, it never moves the verdict); `readGoalMapDetailed` returns the entries the defensive reader DROPPED with a reason AND the fields it REPAIRED with their raw values (a weight clamped before validation made the validator's out-of-range branch dead code), so `goals --validate` can never report a vacuous "valid (0 goals)" nor hide a `weight: 7`; `parseEffort` returns a printable note for every clamp; `ensureBacklogGitignored` gitignores the store on first write (raw ideas are private prompt-class content) — atomically, preserving the file's dominant EOL, recognising every plain spelling of an existing rule (`/.dz/`, `.dz/**`, …) via `backlogIgnoreStatus`, and obeying a `!` negation as an explicit user opt-out instead of overriding it |
 | `feature-adr-setup` (P3) | `renderGuardsConfig`, `renderGuardsRunner` | Scaffolds deterministic guard tests into a TARGET project: `guards.config.json` + a zero-dependency `check.mjs` runner (loc-cap, secret-scan, frozen-file sha256 pins, waivers-with-reasons) — `dz feature-adr-setup --guards` |
 | `usage` | `computeUsage`, `TOKEN_WEIGHTS`, `readUsageLimits`, `deriveUsageCalibration` | Read-only Claude usage ESTIMATE behind `dz usage`. Tokens are COST-WEIGHTED input-equivalents (input 1x, cache-write 1.25x / 1h 2x, cache-read 0.1x, output 5x) — a flat sum is 89-99.7% cache-read (MEASURED) and tracks conversation length, not work. Scans subagent transcripts too (`<session>/subagents/*.jsonl`), follows no symlinks, reads only regular files (symlinked FILES and DIRECTORY components alike are skipped), and caps the walk BY RECENCY so a huge history cannot discard current usage. `pct` stays `null` while limits are unconfigured — an unconfigured estimate is never dressed up as a number |
 | `compounding` | `mulberry32`, `bootstrapDelta`, `decidePromotion`, `assembleCompoundingReport` | Pure learning-loop payoff engine behind `dz compounding`: seeded deterministic bootstrap (conservative nearest-rank lower-95), promotion that refuses non-finite/malformed input and anything under 5 samples per arm, and dz-native measurements (pool write-only ratio, guard trajectory by RATE, replay readiness over unique untruncated prompt events). A gate without data says INSUFFICIENT_DATA — never a verdict. Compaction keeps the newest query-bearing rows verbatim and aggregates ONLY the rest (read totals are invariant across compactions) |

package/dist/backlog.d.ts CHANGED Viewed

@@ -52,10 +52,33 @@ export interface DedupVerdict {
     /** Top-1 raw cosine (ADR-002 — never an RRF score). `-1` when there is nothing to compare against. */
     readonly cosine: number;
     readonly matchedId: string | undefined;
+    /**
+     * The id of the TOP-1 candidate whatever band it landed in — the ADR-002 CALIBRATION surface (idea
+     * ce914ac2). `matchedId` is only set for a DUPLICATE, so a RELATED verdict used to report a cosine with
+     * no way to see WHICH idea produced it; a user calibrating the 0.92 band needs the pair, not the number.
+     * Purely observational: it never changes the verdict.
+     */
+    readonly topMatchId: string | undefined;
     readonly relatedIds: readonly string[];
     /** True when the embedder was unavailable and dedup degraded to exact-text (ADR-002 §degrade). */
     readonly exactTextOnly: boolean;
 }
+/** The result of interpreting a `--effort` argument, with the note the CLI must ECHO when it altered it. */
+export interface EffortParse {
+    readonly effort: number;
+    /** True when the parsed value was altered (clamped, floored, or rejected) — the CLI prints `note`. */
+    readonly adjusted: boolean;
+    /** Human line, e.g. `effort 13 → clamped to 5 (scale 1-5)`. Present iff `adjusted`. */
+    readonly note?: string;
+}
+export declare const EFFORT_MIN = 1;
+export declare const EFFORT_MAX = 5;
+/**
+ * PURE `--effort` interpreter. `dz backlog add --effort 13` used to store 5 and say NOTHING, so the user
+ * kept a wrong mental model of the scale (idea 86096d6d). Every alteration now carries a printable note;
+ * an in-range integer is returned untouched with `adjusted:false` (no noise on the happy path).
+ */
+export declare function parseEffort(raw: string | undefined, fallback: number): EffortParse;
 export declare const DEFAULT_DUPLICATE_THRESHOLD = 0.92;
 export declare const DEFAULT_RELATEDNESS_FLOOR = 0.35;
 export declare const DEFAULT_ROULETTE_ALPHA = 1.5;
@@ -96,6 +119,36 @@ export declare function isSafeId(id: unknown): id is string;
 export declare function readIdeas(projectRoot: string): IdeaRecord[];
 /** Atomic full rewrite (tmp + rename) so a crash mid-write never truncates the store. */
 export declare function writeIdeas(projectRoot: string, ideas: readonly IdeaRecord[]): void;
+export type GitignoreAction = 'created' | 'appended' | 'already-covered' | 'user-opted-out' | 'skipped';
+export interface GitignoreScaffold {
+    readonly action: GitignoreAction;
+    readonly path: string;
+    /** Set for `skipped` (the I/O reason) and `user-opted-out` (the negation line we obeyed). */
+    readonly reason?: string;
+}
+export type BacklogIgnoreStatus = 'covered' | 'negated' | 'uncovered';
+/**
+ * PURE .gitignore verdict for the backlog store. Deliberately NOT a full gitignore engine — it
+ * recognises the plain-path spellings of the rule (`/.dz/`, `.dz/**`, `.dz/backlog`, …) and refuses to
+ * interpret anything else, because a wrong-but-clever matcher either double-appends or silently
+ * decides a store is private when it is not.
+ *
+ * `negated` wins over `covered`: a `!.dz/backlog/` line (anchored or not) is the user saying *"track
+ * this on purpose"*. We obey it — appending a rule that overrides the user's explicit opt-out would be
+ * this tool deciding it knows better.
+ */
+export declare function backlogIgnoreStatus(gitignoreText: string): BacklogIgnoreStatus;
+/** Back-compat shim: "is it ignored?" — a negation is NOT coverage (the store is tracked on purpose). */
+export declare function backlogIgnoreCovered(gitignoreText: string): boolean;
+/**
+ * Ensure the backlog store is gitignored, at the moment the feature FIRST creates it (idea ec4cd60d).
+ * Creates a `.gitignore` when there is none; appends the entry (+ its comment) when the project has one
+ * that does not cover the store; touches NOTHING when it is already covered OR when the user explicitly
+ * negated the rule. The write is ATOMIC and preserves the file's dominant EOL.
+ * Never throws — an unwritable .gitignore degrades to `skipped`, and the CALLER must say so out loud
+ * (a silently un-ignored store is exactly the privacy leak this function exists to prevent).
+ */
+export declare function ensureBacklogGitignored(projectRoot: string): GitignoreScaffold;
 /** Pre-mutation snapshot (NFR-6) — mirrors `snapshotStore`. A failed snapshot returns `{error}` so
  *  the caller ABORTS the mutation (no partial merge). */
 export interface SnapshotResult {
@@ -139,7 +192,50 @@ export interface DedupDeps {
  * blocking capture (NFR-2 / ADR-002 T-002e).
  */
 export declare function dedupIdea(projectRoot: string, text: string, cfg: BacklogConfig, deps?: DedupDeps): Promise<DedupVerdict>;
-/** Defensive GoalMap reader — never throws; a missing/corrupt file ⇒ empty compass. */
+/** One goal entry the reader REFUSED, with the reason — the anti-vacuous-valid evidence (idea 960c9f26). */
+export interface DroppedGoal {
+    /** 0-based index of the entry in the file's `goals` array. */
+    readonly index: number;
+    /** Machine-stable reason, e.g. `missing "statement"`. */
+    readonly reason: string;
+}
+/**
+ * What the defensive read actually SAW. `readGoalMap` throws away the drops (correct for runtime paths —
+ * a corrupt compass must never break capture), but `goals --validate` needs them: a goals.json whose every
+ * entry was silently dropped previously reported *"valid (0 goal(s))"* — a vacuous pass that hid the user's
+ * typo (`text` instead of `statement`). This variant is the validate-facing reader.
+ */
+export interface GoalMapRead {
+    readonly goalMap: GoalMap;
+    /** Entries present in the file's `goals` array (kept + dropped). */
+    readonly present: number;
+    readonly dropped: readonly DroppedGoal[];
+    /**
+     * Fields the reader REPAIRED to keep the runtime safe. The clamp happens BEFORE any validation could
+     * see the original, so a `weight: 7` becomes a legal 1 and the validator's out-of-range branch is
+     * unreachable — a silent repair reported as "valid". These carry the RAW value so `goals --validate`
+     * can warn about what the user actually wrote while the runtime keeps the clamped value.
+     */
+    readonly repaired: readonly RepairedGoalField[];
+    /** Set when the file exists but could not be parsed / has no `goals` array. */
+    readonly parseError?: string;
+}
+/** One field the defensive reader clamped/replaced, with both the raw and the used value. */
+export interface RepairedGoalField {
+    readonly index: number;
+    readonly id: string;
+    readonly field: 'weight';
+    readonly raw: unknown;
+    readonly used: number;
+    /** Human reason, e.g. `weight 7 is out of (0,1]`. */
+    readonly reason: string;
+}
+/**
+ * Detailed GoalMap read — never throws, and REPORTS what it dropped (idea 960c9f26). `readGoalMap` is the
+ * lossy runtime view of this; both share one parser so they can never disagree about what a goal is.
+ */
+export declare function readGoalMapDetailed(projectRoot: string): GoalMapRead;
+/** Defensive GoalMap reader — never throws; a missing/corrupt file ⇒ empty compass (the runtime path). */
 export declare function readGoalMap(projectRoot: string): GoalMap;
 /** The text embedded for a goal: statement + keywords (same convention across cache + score). */
 export declare function goalEmbedText(goal: Goal): string;

package/dist/backlog.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"backlog.d.ts","sourceRoot":"","sources":["../src/backlog.ts"],"names":[],"mappings":"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~~uFAAuF~~;~~AACvF~~,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,~~CAuBxD~~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"}
1	+ {"version":3,"file":"backlog.d.ts","sourceRoot":"","sources":["../src/backlog.ts"],"names":[],"mappings":"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"}

package/dist/backlog.js CHANGED Viewed

@@ -29,6 +29,29 @@ import { resolveEmbedModel } from './embedding-config.js';
 import { mulberry32 } from './compounding.js';
 /** The vector-store namespace that isolates ideas from lessons (ADR-001/005). */
 export const BACKLOG_TASK_TYPE = 'dz-backlog';
+export const EFFORT_MIN = 1;
+export const EFFORT_MAX = 5;
+/**
+ * PURE `--effort` interpreter. `dz backlog add --effort 13` used to store 5 and say NOTHING, so the user
+ * kept a wrong mental model of the scale (idea 86096d6d). Every alteration now carries a printable note;
+ * an in-range integer is returned untouched with `adjusted:false` (no noise on the happy path).
+ */
+export function parseEffort(raw, fallback) {
+    if (raw === undefined)
+        return { effort: fallback, adjusted: false };
+    const v = Number(raw);
+    if (!Number.isFinite(v)) {
+        return { effort: fallback, adjusted: true, note: `effort ${JSON.stringify(raw)} → not a number, using ${fallback} (scale ${EFFORT_MIN}-${EFFORT_MAX})` };
+    }
+    if (v < EFFORT_MIN)
+        return { effort: EFFORT_MIN, adjusted: true, note: `effort ${raw} → clamped to ${EFFORT_MIN} (scale ${EFFORT_MIN}-${EFFORT_MAX})` };
+    if (v > EFFORT_MAX)
+        return { effort: EFFORT_MAX, adjusted: true, note: `effort ${raw} → clamped to ${EFFORT_MAX} (scale ${EFFORT_MIN}-${EFFORT_MAX})` };
+    const floored = Math.floor(v);
+    if (floored !== v)
+        return { effort: floored, adjusted: true, note: `effort ${raw} → rounded down to ${floored} (scale ${EFFORT_MIN}-${EFFORT_MAX}, whole numbers)` };
+    return { effort: floored, adjusted: false };
+}
 /* ================================================================== */
 /*  CONFIG (readBacklogConfig) — defensive, Number.isFinite clamps.     */
 /* ================================================================== */
@@ -189,6 +212,105 @@ export function writeIdeas(projectRoot, ideas) {
     writeFileSync(tmp, body);
     renameSync(tmp, path);
 }
+/** The entry + its one-line rationale, written verbatim so the file explains itself. */
+const BACKLOG_IGNORE_ENTRY = '.dz/backlog/';
+const BACKLOG_IGNORE_COMMENT = '# dz backlog — captured ideas are private prompt-class content';
+/**
+ * Normalise ONE .gitignore pattern to the bare path it targets, so the equally-valid spellings of the
+ * same rule compare equal: a leading `/` (repo-root anchor), a trailing `/**` or `/*` (recursive glob),
+ * and a trailing `/` (directory marker) are all decoration around the same path. Returns `undefined`
+ * for anything that is not a plain path pattern (a comment, an empty line, or a pattern carrying a
+ * wildcard we do NOT interpret) — an uninterpretable pattern must never be read as coverage.
+ */
+function normaliseIgnorePattern(body) {
+    let p = body.trim();
+    if (p === '' || p.startsWith('#'))
+        return undefined;
+    if (p.startsWith('/'))
+        p = p.slice(1); // repo-root anchor: `/.dz/` ≡ `.dz/`
+    p = p.replace(/\/\*\*$/, '').replace(/\/\*$/, ''); // `.dz/**` / `.dz/*` ≡ `.dz`
+    p = p.replace(/\/+$/, ''); // trailing directory marker
+    if (p === '' || p.includes('*') || p.includes('?') || p.includes('['))
+        return undefined; // not a plain path
+    return p;
+}
+/** True when the pattern targets the backlog store (directly or via its `.dz` parent). */
+function targetsBacklogStore(pattern) {
+    return pattern === '.dz' || pattern === '.dz/backlog';
+}
+/**
+ * PURE .gitignore verdict for the backlog store. Deliberately NOT a full gitignore engine — it
+ * recognises the plain-path spellings of the rule (`/.dz/`, `.dz/**`, `.dz/backlog`, …) and refuses to
+ * interpret anything else, because a wrong-but-clever matcher either double-appends or silently
+ * decides a store is private when it is not.
+ *
+ * `negated` wins over `covered`: a `!.dz/backlog/` line (anchored or not) is the user saying *"track
+ * this on purpose"*. We obey it — appending a rule that overrides the user's explicit opt-out would be
+ * this tool deciding it knows better.
+ */
+export function backlogIgnoreStatus(gitignoreText) {
+    let covered = false;
+    for (const raw of String(gitignoreText).split('\n')) {
+        const line = raw.trim();
+        if (line === '' || line.startsWith('#'))
+            continue;
+        const negated = line.startsWith('!');
+        const pattern = normaliseIgnorePattern(negated ? line.slice(1) : line);
+        if (pattern === undefined || !targetsBacklogStore(pattern))
+            continue;
+        if (negated)
+            return 'negated'; // explicit user intent — decided, no further scanning
+        covered = true;
+    }
+    return covered ? 'covered' : 'uncovered';
+}
+/** Back-compat shim: "is it ignored?" — a negation is NOT coverage (the store is tracked on purpose). */
+export function backlogIgnoreCovered(gitignoreText) {
+    return backlogIgnoreStatus(gitignoreText) === 'covered';
+}
+/** The file's dominant line ending, so an append does not mix CRLF and LF in one file. */
+function dominantEol(text) {
+    const crlf = (text.match(/\r\n/g) ?? []).length;
+    const lf = (text.match(/\n/g) ?? []).length - crlf;
+    return crlf > lf ? '\r\n' : '\n';
+}
+/** Atomic write (tmp + rename in the SAME dir) — the ideas.jsonl discipline: a crash never truncates. */
+function writeFileAtomic(path, body) {
+    const tmp = `${path}.tmp-${process.pid}`;
+    writeFileSync(tmp, body);
+    renameSync(tmp, path);
+}
+/**
+ * Ensure the backlog store is gitignored, at the moment the feature FIRST creates it (idea ec4cd60d).
+ * Creates a `.gitignore` when there is none; appends the entry (+ its comment) when the project has one
+ * that does not cover the store; touches NOTHING when it is already covered OR when the user explicitly
+ * negated the rule. The write is ATOMIC and preserves the file's dominant EOL.
+ * Never throws — an unwritable .gitignore degrades to `skipped`, and the CALLER must say so out loud
+ * (a silently un-ignored store is exactly the privacy leak this function exists to prevent).
+ */
+export function ensureBacklogGitignored(projectRoot) {
+    const path = join(projectRoot, '.gitignore');
+    try {
+        if (!existsSync(path)) {
+            writeFileAtomic(path, `${BACKLOG_IGNORE_COMMENT}\n${BACKLOG_IGNORE_ENTRY}\n`);
+            return { action: 'created', path };
+        }
+        const text = readFileSync(path, 'utf-8');
+        const status = backlogIgnoreStatus(text);
+        if (status === 'covered')
+            return { action: 'already-covered', path };
+        if (status === 'negated') {
+            return { action: 'user-opted-out', path, reason: 'a "!" negation for the backlog store is present — respecting the explicit opt-out and adding nothing' };
+        }
+        const eol = dominantEol(text);
+        const sep = text === '' || text.endsWith('\n') ? '' : eol;
+        writeFileAtomic(path, `${text}${sep}${eol}${BACKLOG_IGNORE_COMMENT}${eol}${BACKLOG_IGNORE_ENTRY}${eol}`);
+        return { action: 'appended', path };
+    }
+    catch (err) {
+        return { action: 'skipped', path, reason: err instanceof Error ? err.message : String(err) };
+    }
+}
 export function snapshotIdeas(projectRoot, dest) {
     try {
         const ideas = readIdeas(projectRoot);
@@ -215,15 +337,15 @@ export function classifyDedup(candidates, cfg, opts = {}) {
     const top = sorted[0];
     const exactTextOnly = opts.exactTextOnly === true;
     if (top === undefined)
-        return { action: 'new', cosine: -1, matchedId: undefined, relatedIds: [], exactTextOnly };
+        return { action: 'new', cosine: -1, matchedId: undefined, topMatchId: undefined, relatedIds: [], exactTextOnly };
     if (top.cosine >= cfg.duplicateThreshold) {
-        return { action: 'duplicate', cosine: top.cosine, matchedId: top.id, relatedIds: [], exactTextOnly };
+        return { action: 'duplicate', cosine: top.cosine, matchedId: top.id, topMatchId: top.id, relatedIds: [], exactTextOnly };
     }
     const related = sorted.filter((c) => c.cosine >= cfg.relatednessFloor && c.cosine < cfg.duplicateThreshold);
     if (related.length > 0) {
-        return { action: 'related', cosine: top.cosine, matchedId: undefined, relatedIds: related.map((c) => c.id), exactTextOnly };
+        return { action: 'related', cosine: top.cosine, matchedId: undefined, topMatchId: top.id, relatedIds: related.map((c) => c.id), exactTextOnly };
     }
-    return { action: 'new', cosine: top.cosine, matchedId: undefined, relatedIds: [], exactTextOnly };
+    return { action: 'new', cosine: top.cosine, matchedId: undefined, topMatchId: top.id, relatedIds: [], exactTextOnly };
 }
 /**
  * Production dedup: embed+search the `dz-backlog` vectors (RAW COSINE via `searchAgentdbPatterns`,
@@ -255,41 +377,102 @@ export async function dedupIdea(projectRoot, text, cfg, deps = {}) {
         // idempotency, ADR-002 §degrade). Otherwise NEW — the RELATED band needs cosine and is skipped.
         const match = ideas.find((i) => i.text === text);
         if (match !== undefined)
-            return { action: 'duplicate', cosine: 1, matchedId: match.id, relatedIds: [], exactTextOnly: true };
-        return { action: 'new', cosine: -1, matchedId: undefined, relatedIds: [], exactTextOnly: result.error !== undefined };
+            return { action: 'duplicate', cosine: 1, matchedId: match.id, topMatchId: match.id, relatedIds: [], exactTextOnly: true };
+        return { action: 'new', cosine: -1, matchedId: undefined, topMatchId: undefined, relatedIds: [], exactTextOnly: result.error !== undefined };
     }
     return classifyDedup(candidates, cfg.dedup);
 }
-/* ================================================================== */
-/*  ALIGNMENT (AM-3 / ADR-003) — weighted-MAX cosine over the GoalMap.  */
-/* ================================================================== */
-/** Defensive GoalMap reader — never throws; a missing/corrupt file ⇒ empty compass. */
-export function readGoalMap(projectRoot) {
+/** Reason an entry cannot become a Goal — `undefined` when it is well-formed. */
+function goalDropReason(o) {
+    if (o === null || typeof o !== 'object' || Array.isArray(o))
+        return 'not an object';
+    const r = o;
+    if (typeof r.id !== 'string')
+        return 'missing "id"';
+    if (typeof r.statement !== 'string')
+        return 'missing "statement"';
+    return undefined;
+}
+/**
+ * Detailed GoalMap read — never throws, and REPORTS what it dropped (idea 960c9f26). `readGoalMap` is the
+ * lossy runtime view of this; both share one parser so they can never disagree about what a goal is.
+ */
+export function readGoalMapDetailed(projectRoot) {
     const path = goalsPath(projectRoot);
     if (!existsSync(path))
-        return { version: 1, goals: [] };
+        return { goalMap: { version: 1, goals: [] }, present: 0, dropped: [], repaired: [] };
+    let parsed;
     try {
-        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
-        const goals = Array.isArray(parsed.goals)
-            ? parsed.goals
-                .map((g) => {
-                const o = g;
-                if (typeof o.id !== 'string' || typeof o.statement !== 'string')
-                    return undefined;
-                return {
-                    id: o.id,
-                    statement: o.statement,
-                    weight: clampNum(o.weight, Number.MIN_VALUE, 1, 1),
-                    keywords: Array.isArray(o.keywords) ? o.keywords.filter((k) => typeof k === 'string') : [],
-                };
-            })
-                .filter((g) => g !== undefined)
-            : [];
-        return { version: typeof parsed.version === 'number' ? parsed.version : 1, goals };
+        parsed = JSON.parse(readFileSync(path, 'utf-8'));
     }
-    catch {
-        return { version: 1, goals: [] };
+    catch (err) {
+        return {
+            goalMap: { version: 1, goals: [] },
+            present: 0,
+            dropped: [],
+            repaired: [],
+            parseError: `goals.json is not valid JSON: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // Valid JSON that is not an object (null, a number, an array) must not crash the never-throw
+    // reader: `parsed.version` on null is a TypeError (Codex re-QE HIGH).
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return {
+            goalMap: { version: 1, goals: [] },
+            present: 0,
+            dropped: [],
+            repaired: [],
+            parseError: 'goals.json is valid JSON but not an object',
+        };
+    }
+    const version = typeof parsed.version === 'number' ? parsed.version : 1;
+    if (!Array.isArray(parsed.goals)) {
+        return {
+            goalMap: { version, goals: [] },
+            present: 0,
+            dropped: [],
+            repaired: [],
+            parseError: 'goals.json has no `goals` array',
+        };
     }
+    const goals = [];
+    const dropped = [];
+    const repaired = [];
+    parsed.goals.forEach((g, index) => {
+        const reason = goalDropReason(g);
+        if (reason !== undefined) {
+            dropped.push({ index, reason });
+            return;
+        }
+        const o = g;
+        const id = o.id;
+        // The clamp keeps the RUNTIME safe; the raw value is recorded so validation can still see what the
+        // user wrote (MED-7: clamping before validating made the validator's out-of-range branch dead code).
+        const weight = clampNum(o.weight, Number.MIN_VALUE, 1, 1);
+        if (o.weight !== undefined && o.weight !== weight) {
+            repaired.push({
+                index,
+                id,
+                field: 'weight',
+                raw: o.weight,
+                used: weight,
+                reason: typeof o.weight === 'number' && Number.isFinite(o.weight)
+                    ? `weight ${o.weight} is out of (0,1]`
+                    : `weight ${JSON.stringify(o.weight) ?? String(o.weight)} is not a number in (0,1]`,
+            });
+        }
+        goals.push({
+            id,
+            statement: o.statement,
+            weight,
+            keywords: Array.isArray(o.keywords) ? o.keywords.filter((k) => typeof k === 'string') : [],
+        });
+    });
+    return { goalMap: { version, goals }, present: parsed.goals.length, dropped, repaired };
+}
+/** Defensive GoalMap reader — never throws; a missing/corrupt file ⇒ empty compass (the runtime path). */
+export function readGoalMap(projectRoot) {
+    return readGoalMapDetailed(projectRoot).goalMap;
 }
 /** The text embedded for a goal: statement + keywords (same convention across cache + score). */
 export function goalEmbedText(goal) {