@zigrivers/scaffold 3.25.0 → 3.26.0

package/dist/observability/checks/lens-b-ac-coverage.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from 'vitest';
+import { lensBAcCoverage } from './lens-b-ac-coverage.js';
+function graphOf(input) {
+    return {
+        cwd: '',
+        features: [], stories: input.stories,
+        acceptance_criteria: input.acs,
+        plan_tasks: [], playbook_tasks: [],
+        tests: input.tests, pull_requests: [], files: [],
+        rules: [], components: [], tokens: [], decisions: [],
+        edges: input.edges, provenance: {}, unresolved_globs: [],
+    };
+}
+function makeAvail(testsStatus) {
+    return {
+        git: { status: 'available' }, gh: { status: 'unavailable' },
+        pipeline_docs: { status: 'available' }, tests: { status: testsStatus },
+        state: { status: 'available' }, beads: { status: 'unavailable' },
+        mmr: { status: 'available' }, audit_history: { status: 'unavailable' },
+        ledger: { events_read: 0, malformed_lines: 0, sources: [] },
+    };
+}
+const story = { id: 'story:s-1', title: 'Sign in', priority: 'must', source_anchor: '' };
+const ac = { id: 'ac:s-1.1', story_id: 'story:s-1', text: 'AC', source_anchor: '' };
+const test = {
+    id: 'test:src/x.test.ts::abc123', name: 'AC 1', file_path: 'src/x.test.ts', framework: 'vitest', last_status: 'fail',
+};
+describe('lensBAcCoverage', () => {
+    it('emits P1 for AC without ac_to_test edge (structural)', async () => {
+        const graph = graphOf({ stories: [story], acs: [ac], tests: [], edges: [] });
+        const findings = await lensBAcCoverage(graph, { events: [] }, makeAvail('unavailable'), [], new Set(['B-ac-coverage']));
+        const f = findings.find((x) => x.evidence.kind === 'ac_not_covered');
+        expect(f?.severity).toBe('P1');
+    });
+    it('emits P0 for AC with failing test when tests adapter is available', async () => {
+        const edges = [{ kind: 'ac_to_test', from: ac.id, to: test.id }];
+        const graph = graphOf({ stories: [story], acs: [ac], tests: [test], edges });
+        const findings = await lensBAcCoverage(graph, { events: [] }, makeAvail('available'), [], new Set(['B-ac-coverage']));
+        const f = findings.find((x) => /failing/i.test(x.title));
+        expect(f?.severity).toBe('P0');
+    });
+    it('does NOT emit failing-test findings when tests adapter is unavailable', async () => {
+        const edges = [{ kind: 'ac_to_test', from: ac.id, to: test.id }];
+        const graph = graphOf({ stories: [story], acs: [ac], tests: [test], edges });
+        const findings = await lensBAcCoverage(graph, { events: [] }, makeAvail('unavailable'), [], new Set(['B-ac-coverage']));
+        const failingFinding = findings.find((x) => /failing/i.test(x.title));
+        expect(failingFinding).toBeUndefined();
+    });
+    it('emits no findings when ACs have passing tests and tests adapter is available', async () => {
+        const passingTest = { ...test, last_status: 'pass' };
+        const graph = graphOf({
+            stories: [story], acs: [ac], tests: [passingTest],
+            edges: [{ kind: 'ac_to_test', from: ac.id, to: passingTest.id }],
+        });
+        const findings = await lensBAcCoverage(graph, { events: [] }, makeAvail('available'), [], new Set(['B-ac-coverage']));
+        expect(findings).toEqual([]);
+    });
+});
+//# sourceMappingURL=lens-b-ac-coverage.test.js.map

package/dist/observability/checks/lens-b-ac-coverage.test.js.map

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

package/dist/observability/checks/lens-c-standards.d.ts

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

package/dist/observability/checks/lens-c-standards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-c-standards.d.ts","sourceRoot":"","sources":["../../../src/observability/checks/lens-c-standards.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AA6CxD,eAAO,MAAM,cAAc,EAAE,MAiD5B,CAAA"}

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

@@ -0,0 +1,104 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { minimatch } from 'minimatch';
+import { loadObservabilityConfig } from '../engine/checks/observability-config.js';
+const lensId = 'C-standards';
+const DEFAULT_ESCALATION_THRESHOLD = 5;
+function makeFindingId(parts) {
+    return createHash('sha256').update(parts.join('::')).digest('hex').slice(0, 16);
+}
+function findPatternViolations(rule, file, content) {
+    const out = [];
+    if (rule.pattern) {
+        let re;
+        try {
+            re = new RegExp(rule.pattern);
+        }
+        catch {
+            return out;
+        }
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            if (re.test(lines[i])) {
+                out.push({ rule, file, lineStart: i + 1, lineEnd: i + 1 });
+            }
+        }
+    }
+    if (rule.forbidden) {
+        const lines = content.split('\n');
+        for (const sym of rule.forbidden) {
+            const escaped = sym.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/\s+/g, '\\s+');
+            const symRe = new RegExp(`\\b${escaped}\\b`);
+            for (let i = 0; i < lines.length; i++) {
+                if (symRe.test(lines[i]))
+                    out.push({ rule, file, lineStart: i + 1, lineEnd: i + 1 });
+            }
+        }
+    }
+    return out;
+}
+function severityFor(rule, totalCount, escalationThreshold, override) {
+    if (override)
+        return override;
+    const VALID = ['P0', 'P1', 'P2', 'P3'];
+    if (rule.severity && VALID.includes(rule.severity))
+        return rule.severity;
+    if (totalCount > escalationThreshold)
+        return 'P1';
+    return 'P2';
+}
+export const lensCStandards = async (graph) => {
+    const findings = [];
+    const now = new Date().toISOString();
+    const cwd = graph.cwd;
+    const config = loadObservabilityConfig(cwd);
+    const overrides = config.lenses['C-standards']?.rule_overrides ?? {};
+    const escalationThreshold = config.lenses['C-standards']?.escalation_threshold ?? DEFAULT_ESCALATION_THRESHOLD;
+    const fileContents = new Map();
+    for (const f of graph.files) {
+        try {
+            fileContents.set(f.path, readFileSync(join(cwd, f.path), 'utf8'));
+        }
+        catch { /* skip unreadable */ }
+    }
+    const violationsByRule = new Map();
+    for (const rule of graph.rules) {
+        const matches = (file) => !rule.match || minimatch(file, rule.match);
+        for (const f of graph.files) {
+            if (!matches(f.path))
+                continue;
+            const content = fileContents.get(f.path);
+            if (content === undefined)
+                continue;
+            const vs = findPatternViolations(rule, f.path, content);
+            if (vs.length === 0)
+                continue;
+            const list = violationsByRule.get(rule.id) ?? [];
+            list.push(...vs);
+            violationsByRule.set(rule.id, list);
+        }
+    }
+    for (const [ruleId, vs] of violationsByRule) {
+        const rule = graph.rules.find((r) => r.id === ruleId);
+        if (!rule)
+            continue;
+        const ruleKey = rule.id.replace(/^rule:/, '');
+        const override = overrides[ruleKey];
+        const severity = severityFor(rule, vs.length, escalationThreshold, override);
+        for (const v of vs) {
+            findings.push({
+                id: makeFindingId([lensId, ruleId, v.file, String(v.lineStart)]),
+                lens_id: lensId, severity,
+                title: `${rule.description ?? ruleId} (${v.file}:${v.lineStart})`,
+                description: `Rule ${ruleId} violated at ${v.file}:${v.lineStart}.`,
+                source_doc: 'docs/coding-standards.md',
+                evidence: { kind: 'rule_violation', rule_id: ruleId, file: `file:${v.file}`, lines: [v.lineStart, v.lineEnd] },
+                confidence: 'high', first_seen: now, last_seen: now, status: 'open',
+                fix_hint: { kind: 'edit_doc', target: v.file, prompt: `Address rule ${ruleId} at ${v.file}:${v.lineStart}.` },
+            });
+        }
+    }
+    return findings;
+};
+//# sourceMappingURL=lens-c-standards.js.map

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

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

package/dist/observability/checks/lens-c-standards.test.d.ts

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

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

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

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":"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"}

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":""}