@zigrivers/scaffold 3.27.0 → 3.29.0

package/dist/cli/commands/knowledge-freshness-bump-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness-bump-version.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness-bump-version.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,OAAO,CAAA;AAIhD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAKD,QAAA,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,CAyB/E,CAAA;AAED,eAAe,kBAAkB,CAAA"}

package/dist/cli/commands/knowledge-freshness-bump-version.js

@@ -0,0 +1,34 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { findProjectRoot } from '../middleware/project-root.js';
+import { deriveBumpKind, bumpSemver } from '../../knowledge-freshness/bump-version.js';
+// Local-only explainability subcommand. Reads content/knowledge/VERSION, derives
+// the bump kind from a hypothetical PR title/body, and prints the planned diff.
+// Does NOT modify VERSION — the workflow does that on actual PR merge.
+const bumpVersionCommand = {
+    command: 'bump-version',
+    describe: 'Dry-run a KB VERSION bump from a PR title/body (does not write VERSION)',
+    builder: (y) => y
+        .option('title', {
+        type: 'string',
+        demandOption: true,
+        describe: 'Simulated PR title (Conventional Commits flavored)',
+    })
+        .option('body', {
+        type: 'string',
+        default: '',
+        describe: 'Simulated PR body (defaults to empty)',
+    }),
+    handler: (argv) => {
+        const cwd = findProjectRoot(process.cwd()) ?? process.cwd();
+        const versionPath = join(cwd, 'content', 'knowledge', 'VERSION');
+        const current = readFileSync(versionPath, 'utf8').trim();
+        const kind = deriveBumpKind(argv.title, argv.body);
+        const next = bumpSemver(current, kind);
+        process.stdout.write(`current: ${current}\n`);
+        process.stdout.write(`bump:    ${kind}\n`);
+        process.stdout.write(`next:    ${next}\n`);
+    },
+};
+export default bumpVersionCommand;
+//# sourceMappingURL=knowledge-freshness-bump-version.js.map

package/dist/cli/commands/knowledge-freshness-bump-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness-bump-version.js","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness-bump-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAA;AAOtF,iFAAiF;AACjF,gFAAgF;AAChF,uEAAuE;AACvE,MAAM,kBAAkB,GAA4D;IAClF,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,yEAAyE;IACnF,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACb,CAAC;SACE,MAAM,CAAC,OAAO,EAAE;QACf,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,oDAAoD;KAC/D,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,uCAAuC;KAClD,CAAqC;IAC1C,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;QAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;QAChE,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;QACxD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,IAAI,CAAC,CAAA;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,CAAA;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,CAAA;IAC5C,CAAC;CACF,CAAA;AAED,eAAe,kBAAkB,CAAA"}

package/dist/cli/commands/knowledge-freshness-deep-guidance-check.d.ts

@@ -0,0 +1,7 @@
+import type { CommandModule } from 'yargs';
+interface DeepGuidanceArgs {
+    files: string[];
+}
+declare const deepGuidanceCheckCommand: CommandModule<Record<string, unknown>, DeepGuidanceArgs>;
+export default deepGuidanceCheckCommand;
+//# sourceMappingURL=knowledge-freshness-deep-guidance-check.d.ts.map

package/dist/cli/commands/knowledge-freshness-deep-guidance-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness-deep-guidance-check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness-deep-guidance-check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,OAAO,CAAA;AAIhD,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,QAAA,MAAM,wBAAwB,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,CA6CtF,CAAA;AAED,eAAe,wBAAwB,CAAA"}

package/dist/cli/commands/knowledge-freshness-deep-guidance-check.js

@@ -0,0 +1,51 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { checkDeepGuidance } from '../../knowledge-freshness/gates/deep-guidance-check.js';
+import { resolveTargetFiles } from '../../knowledge-freshness/gates/changed-files.js';
+const deepGuidanceCheckCommand = {
+    command: 'deep-guidance-check [files..]',
+    describe: 'CI gate: every changed entry must retain the literal `## Deep Guidance` heading',
+    builder: (y) => y
+        .positional('files', {
+        type: 'string',
+        array: true,
+        default: [],
+        describe: 'Knowledge entry paths to check (default: git diff origin/main...HEAD)',
+    })
+        .option('files-from', {
+        type: 'string',
+        describe: 'Read file list from a JSON array file (avoids shell-injection via filenames)',
+    }),
+    handler: async (argv) => {
+        const cwd = process.cwd();
+        const argvAny = argv;
+        const filesFrom = (argvAny['files-from'] ?? argvAny.filesFrom);
+        const files = resolveTargetFiles(argv.files ?? [], cwd, { filesFrom });
+        if (files.length === 0) {
+            process.stdout.write('deep-guidance-check: no changed knowledge entries\n');
+            return;
+        }
+        const inputs = files.map((abs) => ({
+            file: path.relative(cwd, abs),
+            content: fs.readFileSync(abs, 'utf8'),
+        }));
+        const findings = checkDeepGuidance(inputs);
+        let anyFail = false;
+        for (const f of findings) {
+            if (f.ok) {
+                process.stdout.write(`OK ${f.file}\n`);
+            }
+            else {
+                anyFail = true;
+                process.stdout.write(`::error file=${f.file}::deep-guidance-check: ${f.reason}\n`);
+            }
+        }
+        if (anyFail) {
+            process.stdout.write('deep-guidance-check: FAILED\n');
+            process.exit(1);
+        }
+        process.stdout.write('deep-guidance-check: OK\n');
+    },
+};
+export default deepGuidanceCheckCommand;
+//# sourceMappingURL=knowledge-freshness-deep-guidance-check.js.map

package/dist/cli/commands/knowledge-freshness-deep-guidance-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness-deep-guidance-check.js","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness-deep-guidance-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAA;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAA;AAMrF,MAAM,wBAAwB,GAA6D;IACzF,OAAO,EAAE,+BAA+B;IACxC,QAAQ,EAAE,iFAAiF;IAC3F,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SACd,UAAU,CAAC,OAAO,EAAE;QACnB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,uEAAuE;KAClF,CAAC;SACD,MAAM,CAAC,YAAY,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,8EAA8E;KACzF,CAAsC;IACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QACzB,MAAM,OAAO,GAAG,IAA0C,CAAA;QAC1D,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,SAAS,CAAuB,CAAA;QACpF,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;QACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAA;YAC3E,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;YAC7B,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC;SACtC,CAAC,CAAC,CAAA;QACH,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;QAC1C,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;gBACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAA;YACxC,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,IAAI,CAAA;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gBAAgB,CAAC,CAAC,IAAI,0BAA0B,CAAC,CAAC,MAAM,IAAI,CAC7D,CAAA;YACH,CAAC;QACH,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAA;IACnD,CAAC;CACF,CAAA;AAED,eAAe,wBAAwB,CAAA"}

package/dist/cli/commands/knowledge-freshness-link-check.d.ts

@@ -0,0 +1,7 @@
+import type { CommandModule } from 'yargs';
+interface LinkCheckArgs {
+    files: string[];
+}
+declare const linkCheckCommand: CommandModule<Record<string, unknown>, LinkCheckArgs>;
+export default linkCheckCommand;
+//# sourceMappingURL=knowledge-freshness-link-check.d.ts.map

package/dist/cli/commands/knowledge-freshness-link-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness-link-check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness-link-check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,OAAO,CAAA;AAKhD,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,QAAA,MAAM,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAiD3E,CAAA;AAED,eAAe,gBAAgB,CAAA"}

package/dist/cli/commands/knowledge-freshness-link-check.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseEntry } from '../../knowledge-freshness/gates/parse-entry.js';
+import { checkUrlsForEntries } from '../../knowledge-freshness/gates/link-check.js';
+import { resolveTargetFiles, loadLinkCheckSkip } from '../../knowledge-freshness/gates/changed-files.js';
+const linkCheckCommand = {
+    command: 'link-check [files..]',
+    describe: 'CI gate: verify every sources[*].url in changed knowledge entries returns 2xx',
+    builder: (y) => y
+        .positional('files', {
+        type: 'string',
+        array: true,
+        default: [],
+        describe: 'Knowledge entry paths to check (default: git diff origin/main...HEAD)',
+    })
+        .option('files-from', {
+        type: 'string',
+        describe: 'Read file list from a JSON array file (avoids shell-injection via filenames)',
+    }),
+    handler: async (argv) => {
+        const cwd = process.cwd();
+        const argvAny = argv;
+        const filesFrom = (argvAny['files-from'] ?? argvAny.filesFrom);
+        const files = resolveTargetFiles(argv.files ?? [], cwd, { filesFrom });
+        if (files.length === 0) {
+            process.stdout.write('link-check: no changed knowledge entries — gate passes trivially\n');
+            return;
+        }
+        const skip = loadLinkCheckSkip(cwd);
+        const entries = [];
+        for (const file of files) {
+            const content = fs.readFileSync(file, 'utf8');
+            const parsed = parseEntry(content);
+            entries.push({ file: path.relative(cwd, file), sourceUrls: parsed.sourceUrls });
+        }
+        const { ok, results } = await checkUrlsForEntries(entries, { skip });
+        for (const r of results) {
+            if (r.skipped) {
+                process.stdout.write(`SKIP ${r.url} (${r.file}) — operator opt-out\n`);
+            }
+            else if (r.ok) {
+                process.stdout.write(`OK   ${r.url} (${r.file}) [${r.status}]\n`);
+            }
+            else {
+                // GitHub annotation so the gate failure surfaces inline on the PR.
+                process.stdout.write(`::error file=${r.file}::link-check: ${r.url} — ${r.reason ?? `HTTP ${r.status}`}\n`);
+            }
+        }
+        if (!ok) {
+            process.stdout.write('link-check: FAILED — at least one source URL did not return 2xx\n');
+            process.exit(1);
+        }
+        process.stdout.write(`link-check: OK — ${results.length} URL(s) checked\n`);
+    },
+};
+export default linkCheckCommand;
+//# sourceMappingURL=knowledge-freshness-link-check.js.map

package/dist/cli/commands/knowledge-freshness-link-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness-link-check.js","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness-link-check.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/knowledge-freshness-lint-unsourced.d.ts

@@ -0,0 +1,8 @@
+import type { CommandModule } from 'yargs';
+interface LintUnsourcedArgs {
+    files: string[];
+    diff?: string;
+}
+declare const lintUnsourcedCommand: CommandModule<Record<string, unknown>, LintUnsourcedArgs>;
+export default lintUnsourcedCommand;
+//# sourceMappingURL=knowledge-freshness-lint-unsourced.d.ts.map

package/dist/cli/commands/knowledge-freshness-lint-unsourced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness-lint-unsourced.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness-lint-unsourced.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,OAAO,CAAA;AAIhD,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,QAAA,MAAM,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAuDnF,CAAA;AAED,eAAe,oBAAoB,CAAA"}

package/dist/cli/commands/knowledge-freshness-lint-unsourced.js

@@ -0,0 +1,58 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { lintUnsourcedClaims, parseUnifiedDiff } from '../../knowledge-freshness/gates/lint-unsourced.js';
+import { resolveTargetFiles, gitDiffForFiles } from '../../knowledge-freshness/gates/changed-files.js';
+const lintUnsourcedCommand = {
+    command: 'lint-unsourced [files..]',
+    describe: 'CI gate (advisory): warn on added normative claims with no nearby source link',
+    builder: (y) => y
+        .positional('files', {
+        type: 'string',
+        array: true,
+        default: [],
+        describe: 'Knowledge entry paths to scan (default: git diff origin/main...HEAD)',
+    })
+        .option('diff', {
+        type: 'string',
+        describe: 'Path to a unified diff file (default: compute from origin/main...HEAD)',
+    })
+        .option('files-from', {
+        type: 'string',
+        describe: 'Read file list from a JSON array file (avoids shell-injection via filenames)',
+    }),
+    handler: async (argv) => {
+        const cwd = process.cwd();
+        const argvAny = argv;
+        const filesFrom = (argvAny['files-from'] ?? argvAny.filesFrom);
+        const files = resolveTargetFiles(argv.files ?? [], cwd, { filesFrom });
+        if (files.length === 0) {
+            process.stdout.write('lint-unsourced: no changed knowledge entries\n');
+            return;
+        }
+        // Diff source: explicit --diff file, or git-derived for the resolved files.
+        const diffText = argv.diff
+            ? fs.readFileSync(path.resolve(cwd, argv.diff), 'utf8')
+            : gitDiffForFiles(cwd, files);
+        const perFile = parseUnifiedDiff(diffText);
+        // Build the lint inputs: each entry needs the post-change content and the
+        // added-line list. Files in `files` but not in `perFile` are noops.
+        const byFile = new Map(perFile.map((p) => [p.file, p.addedLines]));
+        const inputs = files.map((abs) => {
+            const rel = path.relative(cwd, abs);
+            return {
+                file: rel,
+                content: fs.readFileSync(abs, 'utf8'),
+                addedLines: byFile.get(rel) ?? [],
+            };
+        });
+        const findings = lintUnsourcedClaims(inputs);
+        for (const f of findings) {
+            // ::warning:: is advisory — surfaces in the Files-changed tab but
+            // doesn't fail the job (spec §A.5 explicit requirement).
+            process.stdout.write(`::warning file=${f.file},line=${f.line}::unsourced-claim: ${f.reason} — "${f.text}"\n`);
+        }
+        process.stdout.write(`lint-unsourced: ${findings.length} warning(s) across ${inputs.length} file(s) — advisory only\n`);
+    },
+};
+export default lintUnsourcedCommand;
+//# sourceMappingURL=knowledge-freshness-lint-unsourced.js.map

package/dist/cli/commands/knowledge-freshness-lint-unsourced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness-lint-unsourced.js","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness-lint-unsourced.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/knowledge-freshness.d.ts

@@ -0,0 +1,4 @@
+import type { CommandModule } from 'yargs';
+declare const knowledgeFreshnessCommand: CommandModule;
+export default knowledgeFreshnessCommand;
+//# sourceMappingURL=knowledge-freshness.d.ts.map

package/dist/cli/commands/knowledge-freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAU1C,QAAA,MAAM,yBAAyB,EAAE,aAehC,CAAA;AAED,eAAe,yBAAyB,CAAA"}

package/dist/cli/commands/knowledge-freshness.js

@@ -0,0 +1,25 @@
+import auditPrefilterCommand from './knowledge-freshness-audit-prefilter.js';
+import auditRunEntryCommand from './knowledge-freshness-audit-run-entry.js';
+import auditApplyCommand from './knowledge-freshness-audit-apply.js';
+import linkCheckCommand from './knowledge-freshness-link-check.js';
+import lintUnsourcedCommand from './knowledge-freshness-lint-unsourced.js';
+import antiOverRewriteCommand from './knowledge-freshness-anti-over-rewrite.js';
+import deepGuidanceCheckCommand from './knowledge-freshness-deep-guidance-check.js';
+import bumpVersionCommand from './knowledge-freshness-bump-version.js';
+const knowledgeFreshnessCommand = {
+    command: 'knowledge-freshness <command>',
+    describe: 'Knowledge-base freshness audit commands',
+    builder: (y) => y
+        .command(auditPrefilterCommand)
+        .command(auditRunEntryCommand)
+        .command(auditApplyCommand)
+        .command(linkCheckCommand)
+        .command(lintUnsourcedCommand)
+        .command(antiOverRewriteCommand)
+        .command(deepGuidanceCheckCommand)
+        .command(bumpVersionCommand)
+        .demandCommand(1, 'Specify a knowledge-freshness subcommand'),
+    handler: () => { },
+};
+export default knowledgeFreshnessCommand;
+//# sourceMappingURL=knowledge-freshness.js.map

package/dist/cli/commands/knowledge-freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-freshness.js","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-freshness.ts"],"names":[],"mappings":"AACA,OAAO,qBAAqB,MAAM,0CAA0C,CAAA;AAC5E,OAAO,oBAAoB,MAAM,0CAA0C,CAAA;AAC3E,OAAO,iBAAiB,MAAM,sCAAsC,CAAA;AACpE,OAAO,gBAAgB,MAAM,qCAAqC,CAAA;AAClE,OAAO,oBAAoB,MAAM,yCAAyC,CAAA;AAC1E,OAAO,sBAAsB,MAAM,4CAA4C,CAAA;AAC/E,OAAO,wBAAwB,MAAM,8CAA8C,CAAA;AACnF,OAAO,kBAAkB,MAAM,uCAAuC,CAAA;AAEtE,MAAM,yBAAyB,GAAkB;IAC/C,OAAO,EAAE,+BAA+B;IACxC,QAAQ,EAAE,yCAAyC;IACnD,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACb,CAAC;SACE,OAAO,CAAC,qBAAqB,CAAC;SAC9B,OAAO,CAAC,oBAAoB,CAAC;SAC7B,OAAO,CAAC,iBAAiB,CAAC;SAC1B,OAAO,CAAC,gBAAgB,CAAC;SACzB,OAAO,CAAC,oBAAoB,CAAC;SAC7B,OAAO,CAAC,sBAAsB,CAAC;SAC/B,OAAO,CAAC,wBAAwB,CAAC;SACjC,OAAO,CAAC,kBAAkB,CAAC;SAC3B,aAAa,CAAC,CAAC,EAAE,0CAA0C,CAAC;IACjE,OAAO,EAAE,GAAG,EAAE,GAA+C,CAAC;CAC/D,CAAA;AAED,eAAe,yBAAyB,CAAA"}

package/dist/cli/commands/observe.d.ts

@@ -6,6 +6,8 @@ export interface HandleEventInput {
     branch: string;
     taskId: string | null;
     keyValues: Record<string, string>;
+    /** Optional override of the `bd` binary path — used by tests; defaults to "bd" via beadsAdapter. */
+    bdBin?: string;
 }
 export declare function handleEvent(input: HandleEventInput): Promise<number>;
 export interface HandleProgressInput {
@@ -43,6 +45,10 @@ export interface HandleAuditInput {
     fix?: boolean;
     ghBin?: string;
     bdBin?: string;
+    /** Operator-supplied --knowledge-root override, forwarded to both
+     *  runAudit and runFixFlow so Lens I suppression behavior is
+     *  consistent across the whole --fix lifecycle. */
+    knowledgeRootOverride?: string;
 }
 export declare function handleAudit(input: HandleAuditInput): Promise<number>;
 export interface HandleAckInput {

package/dist/cli/commands/observe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/observe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,qCAAqC,CAAA;AAmClF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AA2BD,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB1E;AAID,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,OAAO,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ChF;AAID,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B9E;AAID,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,0BAA0B,CAAA;IACnC,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgF1E;AAID,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,cAAc,GAAG,MAAM,CAAA;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA0BD,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCtE;AAID,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEtC,QAAA,MAAM,cAAc,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAgJnD,CAAA;AAED,eAAe,cAAc,CAAA"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/observe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAG1C,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,qCAAqC,CAAA;AAoClF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,oGAAoG;IACpG,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AA2BD,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B1E;AAID,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,OAAO,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ChF;AAID,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B9E;AAID,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,0BAA0B,CAAA;IACnC,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;uDAEmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsF1E;AAID,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,cAAc,GAAG,MAAM,CAAA;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA0BD,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCtE;AAID,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEtC,QAAA,MAAM,cAAc,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAuJnD,CAAA;AAED,eAAe,cAAc,CAAA"}

package/dist/cli/commands/observe.js

@@ -1,4 +1,5 @@
 import { writeEvent } from '../../observability/engine/ledger-writer.js';
+import { beadsAdapter } from '../../observability/adapters/beads.js';
 import { EVENT_PAYLOAD_KEYS } from '../../observability/engine/event-schemas.js';
 import { runProgress, runAudit } from '../../observability/engine/api.js';
 import { redactRendered } from '../../observability/engine/redact.js';
@@ -16,6 +17,7 @@ import { findProjectRoot } from '../middleware/project-root.js';
 import { runFixFlow } from '../../observability/engine/fix-flow.js';
 import { captureSnapshot, restoreSnapshot } from '../../observability/engine/abort-snapshot.js';
 import { recoverStaleArchives } from '../../observability/engine/harvester.js';
+import { KnowledgeRootCliInvalidError } from '../../observability/knowledge-index.js';
 async function writeMarkdownReport(cwd, out, body, reportId, overridePath) {
     const relPath = sidecarPath(reportId, out.invocation.command).replace(/\.json$/, '.md');
     const absPath = overridePath
@@ -59,12 +61,19 @@ function buildPayload(type, kv) {
 export async function handleEvent(input) {
     const payload = buildPayload(input.type, input.keyValues);
     try {
-        await writeEvent(input.cwd, {
+        const written = await writeEvent(input.cwd, {
             type: input.type,
             branch: input.branch,
             task_id: input.taskId,
             payload,
         });
+        // Cross-link to Beads when the event is task_claimed and a task_id is present.
+        // Fail-soft: claimWithEvent returns false on missing .beads/, missing bd, or any
+        // bd error — we don't propagate failures to the caller, since the ledger
+        // write succeeded.
+        if (input.type === 'task_claimed' && input.taskId) {
+            await beadsAdapter.claimWithEvent(input.cwd, { id: input.taskId, eventId: written.event_id }, input.bdBin ? { bdBin: input.bdBin } : undefined);
+        }
         return 0;
     }
     catch (err) {
@@ -167,6 +176,7 @@ export async function handleAudit(input) {
             fixThresholdOverride: input.fixThresholdOverride,
             ghBin: input.ghBin,
             bdBin: input.bdBin,
+            knowledgeRootOverride: input.knowledgeRootOverride,
             args: { profile: input.profile, scope: input.scope, sinceHours: input.sinceHours, lensIds: input.lensIds },
         });
         if (input.outputMode === 'mmr-findings') {
@@ -221,6 +231,7 @@ export async function handleAudit(input) {
                 const fixResult = await runFixFlow({
                     primaryRoot: input.cwd, initial: out, abortSnapshot: snapshot,
                     ghBin: input.ghBin, bdBin: input.bdBin,
+                    knowledgeRootOverride: input.knowledgeRootOverride,
                 });
                 process.stdout.write(`[fix] fixed ${fixResult.fixed.length}, failed ${fixResult.failed.length}\n`);
                 process.stdout.write(`[fix] post-fix report: ${fixResult.postfix_markdown_path}\n`);
@@ -238,6 +249,10 @@ export async function handleAudit(input) {
         return out.verdict === 'blocked' ? 1 : 0;
     }
     catch (err) {
+        if (err instanceof KnowledgeRootCliInvalidError) {
+            process.stderr.write(`scaffold observe audit: ${err.message}\n`);
+            return 1;
+        }
         process.stderr.write(`scaffold observe audit: ${err instanceof Error ? err.message : String(err)}\n`);
         return 3;
     }
@@ -393,6 +408,11 @@ const observeCommand = {
         .option('fix', {
         type: 'boolean', default: false,
         describe: 'Dispatch the fix flow for blocking findings after audit',
+    })
+        .option('knowledge-root', {
+        type: 'string',
+        describe: 'Path to a content/knowledge directory; overrides yaml + auto-detect '
+            + 'for Lens I existing-entry suppression',
     }), async (argv) => {
         const code = await handleAudit({
             cwd: findProjectRoot(process.cwd()) ?? process.cwd(),
@@ -408,6 +428,7 @@ const observeCommand = {
             render: argv.render,
             outputMode: argv['output-mode'],
             fix: !!(argv.fix),
+            knowledgeRootOverride: (argv['knowledge-root'] ?? argv.knowledgeRoot),
         });
         process.exitCode = code;
     })

package/dist/cli/commands/observe.js.map

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

package/dist/cli/commands/observe.test.js

@@ -30,6 +30,42 @@ describe('observe event subcommand', () => {
         expect(obj.payload.task_title).toBe('Hello world');
         expect(obj.payload.wave).toBe('wave-2');
     });
+    it('task_claimed cross-links to Beads via claimWithEvent when .beads/ + bd available', async () => {
+        mkdirSync(join(dir, '.beads'), { recursive: true });
+        const log = join(dir, 'bd-invocations.log');
+        const shim = join(dir, 'fake-bd.sh');
+        writeFileSync(shim, `#!/usr/bin/env bash
+if [ "$1" = "--version" ]; then echo "bd version 1.0.4"; exit 0; fi
+if [ "$1" = "update" ]; then echo "$@" >> "${log}"; exit 0; fi
+exit 0
+`, { mode: 0o755 });
+        const exitCode = await handleEvent({
+            cwd: dir,
+            type: 'task_claimed',
+            branch: 'feat',
+            taskId: 'bd-a3f8',
+            keyValues: { 'task-title': 'Atomic claim wiring' },
+            bdBin: shim,
+        });
+        expect(exitCode).toBe(0);
+        expect(existsSync(log)).toBe(true);
+        const logged = readFileSync(log, 'utf-8');
+        expect(logged).toMatch(/update bd-a3f8/);
+        expect(logged).toMatch(/--set-metadata ledger_event_id=[0-9A-Z]+/); // ULID
+        expect(logged).toMatch(/--claim/);
+    });
+    it('task_claimed does NOT call bd when .beads/ is absent (fail-soft)', async () => {
+        // No .beads/ dir; the event should still be written, no bd invocation attempted.
+        const exitCode = await handleEvent({
+            cwd: dir,
+            type: 'task_claimed',
+            branch: 'feat',
+            taskId: 'T-001',
+            keyValues: { 'task-title': 'No Beads here' },
+        });
+        expect(exitCode).toBe(0);
+        expect(existsSync(join(dir, '.scaffold/activity.jsonl'))).toBe(true);
+    });
     it('exits with code 2 on schema-invalid input (missing payload field)', async () => {
         const exitCode = await handleEvent({
             cwd: dir,
@@ -449,4 +485,50 @@ describe('observe harvest --recover', () => {
         expect(captured).toMatch(/rotated 1/);
     });
 });
+describe('handleEvent — knowledge_gap_signal', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'observe-cli-kgs-'));
+        ensureIdentity(dir, 'agent-alice');
+    });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('persists all five payload fields through the CLI flow', async () => {
+        const exitCode = await handleEvent({
+            cwd: dir,
+            type: 'knowledge_gap_signal',
+            branch: 'main',
+            taskId: null,
+            keyValues: {
+                topic: 'agent-eval-harnesses',
+                source: 'agent_search',
+                'project-id': 'a'.repeat(64),
+                'step-name': 'tech-stack',
+                'agent-excerpt': 'a manual smoke test',
+            },
+        });
+        expect(exitCode).toBe(0);
+        const ledgerPath = join(dir, '.scaffold/activity.jsonl');
+        expect(existsSync(ledgerPath)).toBe(true);
+        const lastLine = readFileSync(ledgerPath, 'utf8').trim().split('\n').pop();
+        const obj = JSON.parse(lastLine);
+        expect(obj['type']).toBe('knowledge_gap_signal');
+        expect(obj['payload']).toEqual({
+            topic: 'agent-eval-harnesses',
+            source: 'agent_search',
+            project_id: 'a'.repeat(64),
+            step_name: 'tech-stack',
+            agent_excerpt: 'a manual smoke test',
+        });
+    });
+    it('rejects project_id="lessons" with non-lessons source (validator rule)', async () => {
+        const exitCode = await handleEvent({
+            cwd: dir,
+            type: 'knowledge_gap_signal',
+            branch: 'main',
+            taskId: null,
+            keyValues: { topic: 'foo', source: 'agent_search', 'project-id': 'lessons' },
+        });
+        expect(exitCode).toBe(2); // validation-failure exit code
+    });
+});
 //# sourceMappingURL=observe.test.js.map