@zigrivers/scaffold 3.25.1 → 3.26.0

package/dist/observability/checks/lens-c-standards.test.js

@@ -0,0 +1,79 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { lensCStandards } from './lens-c-standards.js';
+import { buildDocGraph } from '../engine/doc-graph/index.js';
+const stubAvail = {
+    git: { status: 'available' }, gh: { status: 'unavailable' },
+    pipeline_docs: { status: 'available' }, tests: { status: 'available' },
+    state: { status: 'available' }, beads: { status: 'unavailable' },
+    mmr: { status: 'available' }, audit_history: { status: 'unavailable' },
+    ledger: { events_read: 0, malformed_lines: 0, sources: [] },
+};
+describe('lensCStandards', () => {
+    let dir;
+    beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-lensC-')); });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('emits findings when pattern matches in source files (default P2)', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/coding-standards.md'), '# Coding Standards\n### Rule: no-console\n' +
+            '- pattern: `console\\.log\\(`\n- match: src/**/*.ts\n- language: typescript\n');
+        writeFileSync(join(dir, 'src/foo.ts'), 'console.log(\'debug\')\n');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensCStandards(graph, { events: [] }, stubAvail, [], new Set(['C-standards']));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].lens_id).toBe('C-standards');
+        expect(findings[0].severity).toBe('P2');
+        expect(findings[0].evidence.kind).toBe('rule_violation');
+        if (findings[0].evidence.kind === 'rule_violation') {
+            expect(findings[0].evidence.rule_id).toMatch(/no-console/);
+        }
+    });
+    it('honors explicit rule severity from the doc', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/coding-standards.md'), '### Rule: no-console\n- pattern: `console\\.log\\(`\n- match: src/**/*.ts\n- severity: P0\n');
+        writeFileSync(join(dir, 'src/foo.ts'), 'console.log(\'debug\')\n');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensCStandards(graph, { events: [] }, stubAvail, [], new Set(['C-standards']));
+        expect(findings[0].severity).toBe('P0');
+    });
+    it('escalates to P1 when the same rule is violated more than 5 times', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/coding-standards.md'), '### Rule: no-console\n- pattern: `console\\.log\\(`\n- match: src/**/*.ts\n');
+        writeFileSync(join(dir, 'src/foo.ts'), 'console.log(1)\nconsole.log(2)\nconsole.log(3)\nconsole.log(4)\nconsole.log(5)\nconsole.log(6)\n');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensCStandards(graph, { events: [] }, stubAvail, [], new Set(['C-standards']));
+        expect(findings).toHaveLength(6);
+        expect(findings.every((f) => f.severity === 'P1')).toBe(true);
+    });
+    it('honors observability.yaml rule_overrides over doc-declared severity', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src'), { recursive: true });
+        mkdirSync(join(dir, '.scaffold'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/coding-standards.md'), '### Rule: no-console\n- pattern: `console\\.log\\(`\n- match: src/**/*.ts\n- severity: P2\n');
+        writeFileSync(join(dir, 'src/foo.ts'), 'console.log(\'x\')\n');
+        writeFileSync(join(dir, '.scaffold/observability.yaml'), 'lenses:\n  C-standards:\n    rule_overrides:\n      no-console: P0\n');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensCStandards(graph, { events: [] }, stubAvail, [], new Set(['C-standards']));
+        expect(findings[0].severity).toBe('P0');
+    });
+    it('checks forbidden symbols too', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/coding-standards.md'), '### Rule: no-eval\n- forbidden: eval, new Function\n- match: src/**/*.ts\n');
+        writeFileSync(join(dir, 'src/foo.ts'), 'eval(\'1 + 1\')\n');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensCStandards(graph, { events: [] }, stubAvail, [], new Set(['C-standards']));
+        expect(findings[0].lens_id).toBe('C-standards');
+    });
+});
+//# sourceMappingURL=lens-c-standards.test.js.map

package/dist/observability/checks/lens-c-standards.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-c-standards.test.js","sourceRoot":"","sources":["../../../src/observability/checks/lens-c-standards.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAE5D,MAAM,SAAS,GAAG;IAChB,GAAG,EAAE,EAAE,MAAM,EAAE,WAAoB,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,aAAsB,EAAE;IAC7E,aAAa,EAAE,EAAE,MAAM,EAAE,WAAoB,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,WAAoB,EAAE;IACxF,KAAK,EAAE,EAAE,MAAM,EAAE,WAAoB,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,aAAsB,EAAE;IAClF,GAAG,EAAE,EAAE,MAAM,EAAE,WAAoB,EAAE,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,aAAsB,EAAE;IACxF,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;CAC5D,CAAA;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,GAAW,CAAA;IACf,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IACzE,SAAS,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAElE,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAA;QAC9C,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,EACjD,4CAA4C;YAC5C,+EAA+E,CAAC,CAAA;QAClF,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,0BAA0B,CAAC,CAAA;QAElE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QACrG,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAC/C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QACxD,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAA;QAC9C,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,EACjD,6FAA6F,CAAC,CAAA;QAChG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,0BAA0B,CAAC,CAAA;QAClE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QACrG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAA;QAC9C,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,EACjD,6EAA6E,CAAC,CAAA;QAChF,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EACnC,kGAAkG,CAAC,CAAA;QACrG,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QACrG,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAA;QAC9C,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,EACjD,6FAA6F,CAAC,CAAA;QAChG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,sBAAsB,CAAC,CAAA;QAC9D,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,8BAA8B,CAAC,EACrD,sEAAsE,CAAC,CAAA;QACzE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QACrG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAA;QAC9C,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,EACjD,4EAA4E,CAAC,CAAA;QAC/E,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,mBAAmB,CAAC,CAAA;QAC3D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QACrG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/checks/lens-d-stack.d.ts

@@ -0,0 +1,3 @@
+import type { LensFn } from '../engine/checks/runner.js';
+export declare const lensDStack: LensFn;
+//# sourceMappingURL=lens-d-stack.d.ts.map

package/dist/observability/checks/lens-d-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-d-stack.d.ts","sourceRoot":"","sources":["../../../src/observability/checks/lens-d-stack.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AA2CxD,eAAO,MAAM,UAAU,EAAE,MA2DxB,CAAA"}

package/dist/observability/checks/lens-d-stack.js

@@ -0,0 +1,108 @@
+import { createHash } from 'node:crypto';
+import { minimatch } from 'minimatch';
+import { loadObservabilityConfig } from '../engine/checks/observability-config.js';
+const lensId = 'D-stack';
+function makeFindingId(parts) {
+    return createHash('sha256').update(parts.join('::')).digest('hex').slice(0, 16);
+}
+const DEFAULT_PATH_TO_LAYER = [
+    { glob: 'src/api/**', layer: 'backend' },
+    { glob: 'src/server/**', layer: 'backend' },
+    { glob: 'src/components/**', layer: 'frontend' },
+    { glob: 'src/pages/**', layer: 'frontend' },
+    { glob: 'src/styles/**', layer: 'frontend' },
+    { glob: 'src/db/**', layer: 'data' },
+    { glob: 'src/migrations/**', layer: 'data' },
+];
+function fileLayer(path, pathToLayer) {
+    for (const { glob, layer } of pathToLayer) {
+        if (minimatch(path, glob))
+            return layer;
+    }
+    return null;
+}
+function decisionsCoverPath(events, filePath, specifier) {
+    for (const e of events) {
+        if (e.type !== 'decision_recorded')
+            continue;
+        const raw = e.payload.affects;
+        const affects = Array.isArray(raw) ? raw.filter((g) => typeof g === 'string') : [];
+        if (!affects.some((g) => minimatch(filePath, g)))
+            continue;
+        // If decision names specific packages, require the specifier to appear there.
+        const pkgs = e.payload.packages;
+        if (Array.isArray(pkgs)) {
+            if (pkgs.some((p) => p === specifier))
+                return true;
+            continue;
+        }
+        return true;
+    }
+    return false;
+}
+export const lensDStack = async (graph, ledger) => {
+    const findings = [];
+    const now = new Date().toISOString();
+    const config = loadObservabilityConfig(graph.cwd);
+    const pathToLayer = config.lenses['D-stack']?.path_to_layer ?? DEFAULT_PATH_TO_LAYER;
+    // (a) unsanctioned dependency without a recorded decision (one finding per file+specifier)
+    const seenUnsanctioned = new Set();
+    for (const edge of graph.edges) {
+        if (edge.kind !== 'file_to_component_use')
+            continue;
+        const to = edge.to;
+        if (!to.startsWith('unsanctioned'))
+            continue;
+        const from = edge.from;
+        const specifier = to.includes(':') ? to.split(':').slice(1).join(':') : '';
+        const dedupKey = `${from}::${specifier}`;
+        if (seenUnsanctioned.has(dedupKey))
+            continue;
+        seenUnsanctioned.add(dedupKey);
+        const filePath = from.replace(/^file:/, '');
+        if (decisionsCoverPath(ledger.events, filePath, specifier))
+            continue;
+        findings.push({
+            id: makeFindingId([lensId, 'unsanctioned', from, specifier]),
+            lens_id: lensId, severity: 'P0',
+            title: `unsanctioned dependency: '${specifier}' in ${filePath}`,
+            description: `${filePath} imports '${specifier}' which is not in the sanctioned stack.` +
+                ' Record a decision or remove the import.',
+            source_doc: 'docs/tech-stack.md',
+            evidence: { kind: 'rule_violation', rule_id: 'tech-stack-unsanctioned', file: from },
+            confidence: 'high', first_seen: now, last_seen: now, status: 'open',
+            fix_hint: {
+                kind: 'record_decision', target: 'decisions.jsonl',
+                prompt: `Record a decision for '${specifier}' in ${filePath}.`,
+            },
+        });
+    }
+    // (b) sanctioned component used outside its declared layer (path-heuristic)
+    for (const edge of graph.edges) {
+        if (edge.kind !== 'file_to_component_use')
+            continue;
+        const to = edge.to;
+        if (!to.startsWith('component:'))
+            continue;
+        const from = edge.from;
+        const filePath = from.replace(/^file:/, '');
+        const component = graph.components.find((c) => c.id === to);
+        if (!component?.layer)
+            continue;
+        const inferredLayer = fileLayer(filePath, pathToLayer);
+        if (!inferredLayer || inferredLayer === component.layer)
+            continue;
+        findings.push({
+            id: makeFindingId([lensId, 'layer', from, to]),
+            lens_id: lensId, severity: 'P1',
+            title: `component used outside its layer: ${component.id} in ${filePath}`,
+            description: `${component.id} is declared in layer "${component.layer}" but is used from` +
+                ` ${filePath} (inferred layer "${inferredLayer}").`,
+            source_doc: 'docs/tech-stack.md',
+            evidence: { kind: 'rule_violation', rule_id: 'tech-stack-layer', file: from },
+            confidence: 'medium', first_seen: now, last_seen: now, status: 'open',
+        });
+    }
+    return findings;
+};
+//# sourceMappingURL=lens-d-stack.js.map

package/dist/observability/checks/lens-d-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-d-stack.js","sourceRoot":"","sources":["../../../src/observability/checks/lens-d-stack.ts"],"names":[],"mappings":"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"}

package/dist/observability/checks/lens-d-stack.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lens-d-stack.test.d.ts.map

package/dist/observability/checks/lens-d-stack.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-d-stack.test.d.ts","sourceRoot":"","sources":["../../../src/observability/checks/lens-d-stack.test.ts"],"names":[],"mappings":""}

package/dist/observability/checks/lens-d-stack.test.js

@@ -0,0 +1,60 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { lensDStack } from './lens-d-stack.js';
+import { buildDocGraph } from '../engine/doc-graph/index.js';
+const stubAvail = {
+    git: { status: 'available' }, gh: { status: 'unavailable' },
+    pipeline_docs: { status: 'available' }, tests: { status: 'available' },
+    state: { status: 'available' }, beads: { status: 'unavailable' },
+    mmr: { status: 'available' }, audit_history: { status: 'unavailable' },
+    ledger: { events_read: 0, malformed_lines: 0, sources: [] },
+};
+describe('lensDStack', () => {
+    let dir;
+    beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-lensD-')); });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('emits P0 for unsanctioned dependency without a recorded decision', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/lib'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/tech-stack.md'), '## Frontend\n\n### React\n\npackage_or_url: react@18\n');
+        writeFileSync(join(dir, 'src/lib/x.ts'), 'import { uniq } from \'lodash\'\n');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensDStack(graph, { events: [] }, stubAvail, [], new Set(['D-stack']));
+        expect(findings.length).toBe(1);
+        expect(findings[0].severity).toBe('P0');
+        expect(findings[0].title).toContain('unsanctioned');
+        if (findings[0].evidence.kind === 'rule_violation') {
+            expect(findings[0].evidence.file).toBe('file:src/lib/x.ts');
+        }
+    });
+    it('does NOT emit when the unsanctioned import has a matching decision_recorded ledger event', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/lib'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/tech-stack.md'), '## Frontend\n\n### React\n\npackage_or_url: react@18\n');
+        writeFileSync(join(dir, 'src/lib/x.ts'), 'import { uniq } from \'lodash\'\n');
+        const graph = await buildDocGraph(dir);
+        const events = [{
+                event_id: 'ulid-x', worktree_id: 'wid', actor_label: 'a', branch: 'b', task_id: null,
+                type: 'decision_recorded', ts: '2026-05-04T00:00:00Z',
+                payload: { key: 'lodash-allowed', summary: 'Allow lodash for now', affects: ['src/lib/**'], links: [] },
+            }];
+        const findings = await lensDStack(graph, { events }, stubAvail, [], new Set(['D-stack']));
+        expect(findings.find((f) => /unsanctioned/i.test(f.title))).toBeUndefined();
+    });
+    it('emits P1 for sanctioned component used outside its layer (heuristic)', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/api'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/tech-stack.md'), '## Frontend\n\n### React\n\npackage_or_url: react@18\nlayer: frontend\n');
+        writeFileSync(join(dir, 'src/api/handler.ts'), 'import React from \'react\'\n');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensDStack(graph, { events: [] }, stubAvail, [], new Set(['D-stack']));
+        const layerFinding = findings.find((f) => /layer/i.test(f.title));
+        expect(layerFinding?.severity).toBe('P1');
+    });
+});
+//# sourceMappingURL=lens-d-stack.test.js.map

package/dist/observability/checks/lens-d-stack.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-d-stack.test.js","sourceRoot":"","sources":["../../../src/observability/checks/lens-d-stack.test.ts"],"names":[],"mappings":"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"}

package/dist/observability/checks/lens-e-design.d.ts

@@ -0,0 +1,3 @@
+import type { LensFn } from '../engine/checks/runner.js';
+export declare const lensEDesign: LensFn;
+//# sourceMappingURL=lens-e-design.d.ts.map

package/dist/observability/checks/lens-e-design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-e-design.d.ts","sourceRoot":"","sources":["../../../src/observability/checks/lens-e-design.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAUxD,eAAO,MAAM,WAAW,EAAE,MA+DzB,CAAA"}

package/dist/observability/checks/lens-e-design.js

@@ -0,0 +1,76 @@
+import { createHash } from 'node:crypto';
+import { loadObservabilityConfig } from '../engine/checks/observability-config.js';
+import { categoryOfProp } from '../engine/doc-graph/design-props.js';
+const lensId = 'E-design';
+function makeFindingId(parts) {
+    return createHash('sha256').update(parts.join('::')).digest('hex').slice(0, 16);
+}
+export const lensEDesign = async (graph) => {
+    const findings = [];
+    const now = new Date().toISOString();
+    const config = loadObservabilityConfig(graph.cwd);
+    const threshold = config.lenses['E-design']?.ad_hoc_token_threshold ?? 3;
+    // (a) per-file ad-hoc threshold
+    const adHocByFile = new Map();
+    for (const e of graph.edges) {
+        if (e.kind !== 'file_to_token_use')
+            continue;
+        if (!e.to.startsWith('ad_hoc'))
+            continue;
+        const fileId = e.from;
+        adHocByFile.set(fileId, (adHocByFile.get(fileId) ?? 0) + 1);
+    }
+    for (const [fileId, count] of adHocByFile) {
+        if (count <= threshold)
+            continue;
+        findings.push({
+            id: makeFindingId([lensId, 'ad-hoc', fileId]),
+            lens_id: lensId, severity: 'P1',
+            title: `${count} ad-hoc design values in ${fileId.replace(/^file:/, '')} (threshold: ${threshold})`,
+            description: `${fileId.replace(/^file:/, '')} has ${count} style values` +
+                ' that don\'t resolve to design-system tokens.',
+            source_doc: 'docs/design-system.md',
+            evidence: { kind: 'rule_violation', rule_id: 'design-ad-hoc-threshold', file: fileId },
+            confidence: 'high', first_seen: now, last_seen: now, status: 'open',
+            fix_hint: {
+                kind: 'rename_token', target: fileId.replace(/^file:/, ''),
+                prompt: `Replace ad-hoc values with design-system tokens in ${fileId.replace(/^file:/, '')}.`,
+            },
+        });
+    }
+    // (b) per-property must-priority bypass — uses the `property` field on the edge
+    const mustCategories = new Set(graph.tokens.filter((t) => t.priority === 'must').map((t) => t.category));
+    if (mustCategories.size > 0) {
+        const seenMustBypass = new Set();
+        for (const e of graph.edges) {
+            if (e.kind !== 'file_to_token_use')
+                continue;
+            if (!e.to.startsWith('ad_hoc'))
+                continue;
+            const ed = e;
+            const cat = categoryOfProp(ed.property);
+            if (!cat || !mustCategories.has(cat))
+                continue;
+            const dedupeKey = `${ed.from}::${ed.property ?? ''}`;
+            if (seenMustBypass.has(dedupeKey))
+                continue;
+            seenMustBypass.add(dedupeKey);
+            findings.push({
+                id: makeFindingId([lensId, 'must-priority', ed.from, ed.property ?? '']),
+                lens_id: lensId, severity: 'P0',
+                title: `must-priority token bypassed in ${ed.from.replace(/^file:/, '')} (property: ${ed.property})`,
+                description: `${ed.from.replace(/^file:/, '')} uses an ad-hoc value for property "${ed.property}"` +
+                    ` whose category (${cat}) has a must-priority token.`,
+                source_doc: 'docs/design-system.md',
+                evidence: { kind: 'rule_violation', rule_id: 'design-must-token', file: ed.from },
+                confidence: 'high', first_seen: now, last_seen: now, status: 'open',
+                fix_hint: {
+                    kind: 'rename_token', target: ed.from.replace(/^file:/, ''),
+                    prompt: `Replace the ad-hoc ${ed.property} value with the corresponding must-priority token.`,
+                },
+            });
+        }
+    }
+    return findings;
+};
+//# sourceMappingURL=lens-e-design.js.map

package/dist/observability/checks/lens-e-design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-e-design.js","sourceRoot":"","sources":["../../../src/observability/checks/lens-e-design.ts"],"names":[],"mappings":"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"}

package/dist/observability/checks/lens-e-design.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lens-e-design.test.d.ts.map

package/dist/observability/checks/lens-e-design.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-e-design.test.d.ts","sourceRoot":"","sources":["../../../src/observability/checks/lens-e-design.test.ts"],"names":[],"mappings":""}

package/dist/observability/checks/lens-e-design.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { lensEDesign } from './lens-e-design.js';
+import { buildDocGraph } from '../engine/doc-graph/index.js';
+const stubAvail = {
+    git: { status: 'available' }, gh: { status: 'unavailable' },
+    pipeline_docs: { status: 'available' }, tests: { status: 'available' },
+    state: { status: 'available' }, beads: { status: 'unavailable' },
+    mmr: { status: 'available' }, audit_history: { status: 'unavailable' },
+    ledger: { events_read: 0, malformed_lines: 0, sources: [] },
+};
+describe('lensEDesign', () => {
+    let dir;
+    beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-lensE-')); });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('emits P1 when a UI file has more than the configured ad-hoc threshold (default 3)', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/components'), { recursive: true });
+        mkdirSync(join(dir, '.scaffold'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/design-system.md'), '## Colors\n\n| Token | Value | Priority |\n|---|---|---|\n| --color-primary | #4f46e5 | must |\n');
+        writeFileSync(join(dir, '.scaffold/observability.yaml'), 'lenses:\n  E-design:\n    ui_glob: "src/components/**/*.tsx"\n    ad_hoc_token_threshold: 3\n');
+        writeFileSync(join(dir, 'src/components/Big.tsx'), 'export const Big = () => ' +
+            '<div style={{ color: \'#abc\', background: \'#def\', borderColor: \'#123\', padding: \'13px\' }} />');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensEDesign(graph, { events: [] }, stubAvail, [], new Set(['E-design']));
+        expect(findings.find((f) => /ad-hoc/i.test(f.title))).toBeDefined();
+        expect(findings.find((f) => /ad-hoc/i.test(f.title))?.severity).toBe('P1');
+    });
+    it('emits P0 when a must-priority token is replaced by a literal', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/components'), { recursive: true });
+        mkdirSync(join(dir, '.scaffold'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/design-system.md'), '## Colors\n\n| Token | Value | Priority |\n|---|---|---|\n| --color-primary | #4f46e5 | must |\n');
+        writeFileSync(join(dir, '.scaffold/observability.yaml'), 'lenses:\n  E-design:\n    ui_glob: "src/components/**/*.tsx"\n');
+        writeFileSync(join(dir, 'src/components/Btn.tsx'), 'export const Btn = () => <button style={{ color: \'#zz0011\' }}>X</button>');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensEDesign(graph, { events: [] }, stubAvail, [], new Set(['E-design']));
+        const must = findings.find((f) => /must-priority/i.test(f.title));
+        expect(must?.severity).toBe('P0');
+    });
+    it('emits P0 only for ad-hoc uses on properties whose category has a must-priority token', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/components'), { recursive: true });
+        mkdirSync(join(dir, '.scaffold'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        // Only color is must-priority; spacing is not in the design system at all.
+        writeFileSync(join(dir, 'docs/design-system.md'), '## Colors\n\n| Token | Value | Priority |\n|---|---|---|\n| --color-primary | #4f46e5 | must |\n');
+        writeFileSync(join(dir, '.scaffold/observability.yaml'), 'lenses:\n  E-design:\n    ui_glob: "src/components/**/*.tsx"\n    ad_hoc_token_threshold: 100\n');
+        writeFileSync(join(dir, 'src/components/Btn.tsx'), 'export const Btn = () => <button style={{ color: \'#zz0011\', padding: \'13px\' }} />');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensEDesign(graph, { events: [] }, stubAvail, [], new Set(['E-design']));
+        expect(findings.find((f) => /must-priority/i.test(f.title) && /color/i.test(f.description))?.severity).toBe('P0');
+        expect(findings.find((f) => /must-priority/i.test(f.title) && /padding/i.test(f.description))).toBeUndefined();
+    });
+    it('does NOT emit must-priority P0 when the design-system declares no must tokens', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/components'), { recursive: true });
+        mkdirSync(join(dir, '.scaffold'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/design-system.md'), '## Colors\n\n| Token | Value | Priority |\n|---|---|---|\n| --color-primary | #4f46e5 | should |\n');
+        writeFileSync(join(dir, '.scaffold/observability.yaml'), 'lenses:\n  E-design:\n    ui_glob: "src/components/**/*.tsx"\n');
+        writeFileSync(join(dir, 'src/components/Btn.tsx'), 'export const Btn = () => ' +
+            '<button style={{ color: \'#aaa\', background: \'#bbb\', borderColor: \'#ccc\', padding: \'11px\' }} />');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensEDesign(graph, { events: [] }, stubAvail, [], new Set(['E-design']));
+        expect(findings.find((f) => /must-priority/i.test(f.title))).toBeUndefined();
+    });
+    it('emits no findings when files use tokens correctly', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/components'), { recursive: true });
+        mkdirSync(join(dir, '.scaffold'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/design-system.md'), '## Colors\n\n| Token | Value | Priority |\n|---|---|---|\n| --color-primary | #4f46e5 | must |\n');
+        writeFileSync(join(dir, '.scaffold/observability.yaml'), 'lenses:\n  E-design:\n    ui_glob: "src/components/**/*.tsx"\n');
+        writeFileSync(join(dir, 'src/components/Btn.tsx'), 'export const Btn = () => <button style={{ color: \'#4f46e5\' }}>X</button>');
+        const graph = await buildDocGraph(dir);
+        const findings = await lensEDesign(graph, { events: [] }, stubAvail, [], new Set(['E-design']));
+        expect(findings).toEqual([]);
+    });
+});
+//# sourceMappingURL=lens-e-design.test.js.map

package/dist/observability/checks/lens-e-design.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-e-design.test.js","sourceRoot":"","sources":["../../../src/observability/checks/lens-e-design.test.ts"],"names":[],"mappings":"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"}

package/dist/observability/checks/lens-f-scope.d.ts

@@ -0,0 +1,3 @@
+import type { LensFn } from '../engine/checks/runner.js';
+export declare const lensFScope: LensFn;
+//# sourceMappingURL=lens-f-scope.d.ts.map

package/dist/observability/checks/lens-f-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-f-scope.d.ts","sourceRoot":"","sources":["../../../src/observability/checks/lens-f-scope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AASxD,eAAO,MAAM,UAAU,EAAE,MAmFxB,CAAA"}

package/dist/observability/checks/lens-f-scope.js

@@ -0,0 +1,92 @@
+import { createHash } from 'node:crypto';
+import { loadObservabilityConfig } from '../engine/checks/observability-config.js';
+const lensId = 'F-scope';
+function makeFindingId(parts) {
+    return createHash('sha256').update(parts.join('::')).digest('hex').slice(0, 16);
+}
+export const lensFScope = async (graph, ledger, availability) => {
+    const findings = [];
+    const now = new Date().toISOString();
+    // (a) Feature without a story
+    for (const feat of graph.features) {
+        if (feat.priority !== 'must' && feat.priority !== 'should')
+            continue;
+        const covered = graph.edges.some((e) => e.kind === 'feature_to_story' && e.from === feat.id);
+        if (covered)
+            continue;
+        findings.push({
+            id: makeFindingId([lensId, 'feature-no-story', feat.id]),
+            lens_id: lensId, severity: feat.priority === 'must' ? 'P0' : 'P1',
+            title: `feature has no story: ${feat.title}`,
+            description: `Feature ${feat.id} (priority: ${feat.priority}) has no covering story.`,
+            source_doc: feat.source_anchor,
+            evidence: {
+                kind: 'orphan_node', graph_query: `feature_to_story.from = ${feat.id}`, node_id: feat.id,
+            },
+            confidence: 'high', first_seen: now, last_seen: now, status: 'open',
+            fix_hint: {
+                kind: 'edit_doc', target: 'docs/user-stories.md',
+                prompt: `Add a story for feature "${feat.title}".`,
+            },
+        });
+    }
+    // (b) Story without plan or playbook
+    for (const s of graph.stories) {
+        if (s.priority !== 'must' && s.priority !== 'should')
+            continue;
+        const hasPlan = graph.edges.some((e) => e.kind === 'story_to_plan_task' && e.from === s.id);
+        const hasPlaybook = graph.edges.some((e) => e.kind === 'playbook_task_to_story' && e.to === s.id);
+        if (hasPlan || hasPlaybook)
+            continue;
+        findings.push({
+            id: makeFindingId([lensId, 'no plan task', s.id]),
+            lens_id: lensId, severity: s.priority === 'must' ? 'P0' : 'P1',
+            title: `story has no plan task or playbook: ${s.title}`,
+            description: `Story ${s.id} (priority: ${s.priority}) has no plan task or playbook task.`,
+            source_doc: s.source_anchor,
+            evidence: {
+                kind: 'orphan_node',
+                graph_query: `story_to_plan_task.from = ${s.id} OR playbook_task_to_story.to = ${s.id}`,
+                node_id: s.id,
+            },
+            confidence: 'high', first_seen: now, last_seen: now, status: 'open',
+            fix_hint: {
+                kind: 'edit_doc', target: 'docs/implementation-plan.md',
+                prompt: `Add a plan task tracking story ${s.id}.`,
+            },
+        });
+    }
+    // (c) Story planned but untouched — only when state adapter is available
+    if (availability.state.status === 'available') {
+        const config = loadObservabilityConfig(graph.cwd);
+        const graceHours = config.lenses['F-scope']?.untouched_story_grace_hours ?? 168;
+        const graceCutoff = Date.now() - graceHours * 3_600_000;
+        const eventTimestamps = ledger.events.map((e) => new Date(e.ts).getTime()).filter(isFinite);
+        const oldestEventTs = eventTimestamps.length > 0 ? Math.min(...eventTimestamps) : Date.now();
+        if (oldestEventTs < graceCutoff) {
+            const claimedTaskIds = new Set(ledger.events.filter((e) => e.type === 'task_claimed' && e.task_id).map((e) => e.task_id));
+            for (const s of graph.stories) {
+                const planTasks = graph.plan_tasks.filter((p) => p.story_id === s.id);
+                if (planTasks.length === 0)
+                    continue;
+                const allTodo = planTasks.every((p) => p.status === 'todo');
+                if (!allTodo)
+                    continue;
+                const everClaimed = planTasks.some((p) => claimedTaskIds.has(p.id.replace(/^plan_task:/, '')));
+                if (everClaimed)
+                    continue;
+                findings.push({
+                    id: makeFindingId([lensId, 'untouched', s.id]),
+                    lens_id: lensId, severity: 'P2',
+                    title: `story planned but untouched: ${s.title}`,
+                    description: `Story ${s.id} has plan tasks but none have been claimed.`,
+                    source_doc: s.source_anchor,
+                    evidence: { kind: 'orphan_node', graph_query: `task_claimed for story ${s.id}`, node_id: s.id },
+                    confidence: 'low', first_seen: now, last_seen: now, status: 'open',
+                });
+            }
+        }
+    }
+    return findings;
+};
+//# sourceMappingURL=lens-f-scope.js.map