@zigrivers/scaffold 3.28.0 → 3.30.0

package/dist/observability/checks/lens-i-lessons-scanner.d.ts

@@ -0,0 +1,16 @@
+import type { KnowledgeGapSignalPayload } from '../engine/types.js';
+/**
+ * Normalize a captured topic phrase to a validator-compatible
+ * kebab-case slug. Matches the spec §2.3 contract — must always
+ * produce strings satisfying ^[a-z0-9]+(-[a-z0-9]+)*$ or empty string.
+ */
+export declare function normalizeTopic(raw: string): string;
+/**
+ * Reads an absolute path to a lessons.md file and returns synthetic
+ * gap-signal payloads. Returns [] on missing/empty file (no throws).
+ *
+ * Lens I owns path resolution; this scanner reads exactly the path
+ * it's given.
+ */
+export declare function scanLessonsForGaps(absPath: string): KnowledgeGapSignalPayload[];
+//# sourceMappingURL=lens-i-lessons-scanner.d.ts.map

package/dist/observability/checks/lens-i-lessons-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-i-lessons-scanner.d.ts","sourceRoot":"","sources":["../../../src/observability/checks/lens-i-lessons-scanner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAyBnE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,EAAE,CAqD/E"}

package/dist/observability/checks/lens-i-lessons-scanner.js

@@ -0,0 +1,106 @@
+import fs from 'node:fs';
+const EXPLICIT_MARKER_RE = /<!--\s*gap-topic:\s*([a-z0-9]+(?:-[a-z0-9]+)*)\s*-->/g;
+// Sentence-terminating . ! ? end the capture only when followed by
+// whitespace or end-of-line. This preserves version-style dots inside
+// topics (e.g. "react-19.0") while still terminating real sentence
+// ends ("missing knowledge: foo." captures "foo"). Quotes/backticks
+// terminate unconditionally. Bare $ handles unpunctuated bullets at
+// end-of-line (e.g. "No knowledge entry for retry-with-jitter" with
+// no trailing punctuation) — the line-by-line scanner makes $ anchor
+// per line.
+const TERM = '(?:["`]|[.!?](?=\\s|$)|$)';
+const HEURISTIC_PATTERNS = [
+    new RegExp('(?:would have helped to have|missing) (?:a )?' +
+        '(?:guide|knowledge entry|entry) (?:on|for|about) ' +
+        `["\`']?(.+?)${TERM}`, 'i'),
+    new RegExp(`no (?:knowledge|kb) entry for ["\`']?(.+?)${TERM}`, 'i'),
+    new RegExp(`missing knowledge:\\s*["\`']?(.+?)${TERM}`, 'i'),
+];
+const FENCE_RE = /^\s*```/;
+/**
+ * Normalize a captured topic phrase to a validator-compatible
+ * kebab-case slug. Matches the spec §2.3 contract — must always
+ * produce strings satisfying ^[a-z0-9]+(-[a-z0-9]+)*$ or empty string.
+ */
+export function normalizeTopic(raw) {
+    return raw.toLowerCase()
+        .replace(/['\u2018\u2019]/g, '') // strip ASCII + U+2018 + U+2019 smart-quote apostrophes
+        .replace(/[^a-z0-9-]+/g, '-') // any other non-slug char becomes a hyphen
+        .replace(/-{2,}/g, '-') // collapse repeated hyphens
+        .replace(/^-+|-+$/g, ''); // trim leading/trailing hyphens
+}
+/**
+ * Reads an absolute path to a lessons.md file and returns synthetic
+ * gap-signal payloads. Returns [] on missing/empty file (no throws).
+ *
+ * Lens I owns path resolution; this scanner reads exactly the path
+ * it's given.
+ */
+export function scanLessonsForGaps(absPath) {
+    let content;
+    try {
+        content = fs.readFileSync(absPath, 'utf8');
+    }
+    catch {
+        return []; // missing file is the default expected state
+    }
+    if (content.trim() === '')
+        return [];
+    const out = [];
+    // Normalize CRLF → LF before splitting so trailing \r doesn't leak into captures.
+    const lines = content.replace(/\r\n/g, '\n').split('\n');
+    let insideFence = false;
+    for (const line of lines) {
+        if (FENCE_RE.test(line)) {
+            insideFence = !insideFence;
+            continue;
+        }
+        if (insideFence)
+            continue;
+        // Pass 1 — explicit markers (multiple per line OK via /g)
+        EXPLICIT_MARKER_RE.lastIndex = 0;
+        let m;
+        while ((m = EXPLICIT_MARKER_RE.exec(line)) !== null) {
+            const slug = m[1];
+            if (slug && isValidTopic(slug)) {
+                out.push({
+                    topic: slug,
+                    source: 'lessons',
+                    project_id: 'lessons',
+                    agent_excerpt: line.slice(0, 200),
+                });
+            }
+        }
+        // Pass 2 — heuristic patterns (first match per line per regex is enough)
+        for (const re of HEURISTIC_PATTERNS) {
+            const match = re.exec(line);
+            if (!match)
+                continue;
+            const normalized = normalizeTopic(match[1] ?? '');
+            if (!isValidTopic(normalized))
+                continue;
+            out.push({
+                topic: normalized,
+                source: 'lessons',
+                project_id: 'lessons',
+                agent_excerpt: line.slice(0, 200),
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Synthetic payloads from this scanner never round-trip through the
+ * runtime validator (they're consumed in-memory by Lens I), but the
+ * scanner enforces the same kebab-case-slug ≤80-chars contract here
+ * so the in-process payloads remain shape-compatible with
+ * KnowledgeGapSignalPayload from the canonical types. Drops
+ * (rather than truncates) overlong topics — an 80+ char topic is
+ * almost always a runaway regex capture, not a real gap.
+ */
+const TOPIC_MAX = 80;
+const TOPIC_SLUG_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+function isValidTopic(topic) {
+    return topic.length > 0 && topic.length <= TOPIC_MAX && TOPIC_SLUG_RE.test(topic);
+}
+//# sourceMappingURL=lens-i-lessons-scanner.js.map

package/dist/observability/checks/lens-i-lessons-scanner.js.map

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

package/dist/observability/checks/lens-i-lessons-scanner.test.d.ts

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

package/dist/observability/checks/lens-i-lessons-scanner.test.d.ts.map

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

package/dist/observability/checks/lens-i-lessons-scanner.test.js

@@ -0,0 +1,174 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { describe, it, expect, afterEach } from 'vitest';
+import { scanLessonsForGaps, normalizeTopic } from './lens-i-lessons-scanner.js';
+const tmpFiles = [];
+function writeTmp(content) {
+    const p = path.join(os.tmpdir(), `lessons-test-${crypto.randomUUID()}.md`);
+    fs.writeFileSync(p, content, 'utf8');
+    tmpFiles.push(p);
+    return p;
+}
+afterEach(() => {
+    while (tmpFiles.length > 0) {
+        const f = tmpFiles.pop();
+        try {
+            fs.unlinkSync(f);
+        }
+        catch { /* ignore */ }
+    }
+});
+describe('scanLessonsForGaps', () => {
+    it('returns [] when the file does not exist', () => {
+        const nonexistent = path.join(os.tmpdir(), `does-not-exist-${crypto.randomUUID()}.md`);
+        expect(scanLessonsForGaps(nonexistent)).toEqual([]);
+    });
+    it('returns [] when the file is empty', () => {
+        const p = writeTmp('');
+        expect(scanLessonsForGaps(p)).toEqual([]);
+    });
+    it('extracts an explicit <!-- gap-topic: slug --> marker verbatim', () => {
+        const p = writeTmp('## Lesson\n\n<!-- gap-topic: agent-eval-harnesses -->\n\nbody\n');
+        const signals = scanLessonsForGaps(p);
+        expect(signals).toHaveLength(1);
+        expect(signals[0].topic).toBe('agent-eval-harnesses');
+        expect(signals[0].source).toBe('lessons');
+        expect(signals[0].project_id).toBe('lessons');
+    });
+    it('extracts a "would have helped" heuristic match', () => {
+        const p = writeTmp('## Lesson\n\nWould have helped to have a guide on "agent eval harnesses".\n');
+        const signals = scanLessonsForGaps(p);
+        expect(signals).toHaveLength(1);
+        expect(signals[0].topic).toBe('agent-eval-harnesses');
+    });
+    it('extracts a "no knowledge entry for" heuristic match', () => {
+        const p = writeTmp('No knowledge entry for "retry-with-jitter".\n');
+        const signals = scanLessonsForGaps(p);
+        expect(signals).toHaveLength(1);
+        expect(signals[0].topic).toBe('retry-with-jitter');
+    });
+    it('extracts a "missing knowledge:" heuristic match', () => {
+        const p = writeTmp('Missing knowledge: `circuit-breaker-patterns`.\n');
+        const signals = scanLessonsForGaps(p);
+        expect(signals).toHaveLength(1);
+        expect(signals[0].topic).toBe('circuit-breaker-patterns');
+    });
+    it('matches sentences ending in ! or ?', () => {
+        const p = writeTmp([
+            'Would have helped to have a guide on agent eval harnesses!',
+            'No knowledge entry for retry-with-jitter?',
+        ].join('\n'));
+        const signals = scanLessonsForGaps(p);
+        const topics = signals.map(s => s.topic).sort();
+        expect(topics).toContain('agent-eval-harnesses');
+        expect(topics).toContain('retry-with-jitter');
+    });
+    it('strips apostrophes via normalizeTopic (smart and ASCII)', () => {
+        const p = writeTmp([
+            'Would have helped to have a guide on "agent’s eval harnesses".',
+            'No knowledge entry for "agent\'s eval harnesses".',
+        ].join('\n'));
+        const signals = scanLessonsForGaps(p);
+        for (const s of signals) {
+            expect(s.topic).toBe('agents-eval-harnesses');
+        }
+    });
+    it('normalizes punctuation to validator-compatible kebab slug (direct normalizeTopic test)', () => {
+        // Direct test of normalizeTopic — covers cases that are independent
+        // of the heuristic capture path.
+        expect(normalizeTopic('react-19.0')).toBe('react-19-0');
+        expect(normalizeTopic('agent eval?')).toBe('agent-eval');
+        expect(normalizeTopic('Foo_Bar')).toBe('foo-bar');
+    });
+    it('captures version-numbered topics through the heuristic path without truncating', () => {
+        // The closing class uses [.!?](?=\s|$) so an internal dot followed
+        // by a digit (like "react-19.0") survives the capture; only the
+        // sentence-terminating dot ends the match.
+        const p = writeTmp('No knowledge entry for "react-19.0".\n');
+        const signals = scanLessonsForGaps(p);
+        expect(signals).toHaveLength(1);
+        expect(signals[0].topic).toBe('react-19-0');
+    });
+    it('produces multiple signals when the same topic appears on different lines', () => {
+        const p = writeTmp([
+            '<!-- gap-topic: foo-bar -->',
+            'No knowledge entry for "foo-bar".',
+        ].join('\n'));
+        const signals = scanLessonsForGaps(p);
+        expect(signals).toHaveLength(2);
+        expect(signals.every(s => s.topic === 'foo-bar')).toBe(true);
+    });
+    it('does NOT extract topic mentions from inside a fenced code block', () => {
+        const p = writeTmp([
+            '## Lesson',
+            '',
+            'Real prose: would have helped to have a guide on "real-topic".',
+            '',
+            '```bash',
+            '# this is a code example, NOT a real lesson',
+            '# no knowledge entry for "fake-topic-in-code"',
+            '```',
+            '',
+            'More prose.',
+        ].join('\n'));
+        const signals = scanLessonsForGaps(p);
+        const topics = signals.map(s => s.topic);
+        expect(topics).toContain('real-topic');
+        expect(topics).not.toContain('fake-topic-in-code');
+    });
+    it('handles multiple fenced blocks (toggle in/out works)', () => {
+        const p = writeTmp([
+            'No knowledge entry for "first-topic".',
+            '```',
+            'No knowledge entry for "ignored-1"',
+            '```',
+            'No knowledge entry for "second-topic".',
+            '```bash',
+            'No knowledge entry for "ignored-2"',
+            '```',
+            'No knowledge entry for "third-topic".',
+        ].join('\n'));
+        const signals = scanLessonsForGaps(p);
+        const topics = signals.map(s => s.topic).sort();
+        expect(topics).toEqual(['first-topic', 'second-topic', 'third-topic']);
+    });
+    it('caps agent_excerpt to 200 chars', () => {
+        const longSuffix = 'x'.repeat(300);
+        const p = writeTmp(`No knowledge entry for "long-topic". ${longSuffix}.\n`);
+        const signals = scanLessonsForGaps(p);
+        expect(signals[0].agent_excerpt.length).toBeLessThanOrEqual(200);
+    });
+    it('handles Windows CRLF line endings without crashing', () => {
+        const p = writeTmp('<!-- gap-topic: crlf-topic -->\r\nbody\r\n');
+        const signals = scanLessonsForGaps(p);
+        expect(signals[0].topic).toBe('crlf-topic');
+    });
+    it('drops topics exceeding the 80-char validator limit (heuristic)', () => {
+        // A runaway capture would violate the canonical
+        // KnowledgeGapSignalPayload contract; the scanner enforces the
+        // ≤80-char kebab-slug rule locally before emitting.
+        const longish = 'a'.repeat(90);
+        const p = writeTmp(`No knowledge entry for "${longish}".\n`);
+        const signals = scanLessonsForGaps(p);
+        expect(signals).toEqual([]);
+    });
+    it('drops explicit markers whose slug exceeds 80 chars', () => {
+        const longSlug = 'a'.repeat(81);
+        const p = writeTmp(`<!-- gap-topic: ${longSlug} -->\n`);
+        const signals = scanLessonsForGaps(p);
+        expect(signals).toEqual([]);
+    });
+    it('matches unpunctuated lines at end-of-line (no trailing quote/punctuation)', () => {
+        const p = writeTmp([
+            'No knowledge entry for retry-with-jitter',
+            'Missing knowledge: circuit-breaker',
+        ].join('\n'));
+        const signals = scanLessonsForGaps(p);
+        const topics = signals.map(s => s.topic).sort();
+        expect(topics).toContain('retry-with-jitter');
+        expect(topics).toContain('circuit-breaker');
+    });
+});
+//# sourceMappingURL=lens-i-lessons-scanner.test.js.map

package/dist/observability/checks/lens-i-lessons-scanner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-i-lessons-scanner.test.js","sourceRoot":"","sources":["../../../src/observability/checks/lens-i-lessons-scanner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEhF,MAAM,QAAQ,GAAa,EAAE,CAAA;AAE7B,SAAS,QAAQ,CAAC,OAAe;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAC1E,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,OAAO,CAAC,CAAA;AACV,CAAC;AAED,SAAS,CAAC,GAAG,EAAE;IACb,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAG,CAAA;QACzB,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QACtF,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;QACtB,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,GAAG,QAAQ,CAAC,iEAAiE,CAAC,CAAA;QACrF,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QACrD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACzC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,QAAQ,CAAC,6EAA6E,CAAC,CAAA;QACjG,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,GAAG,QAAQ,CAAC,+CAA+C,CAAC,CAAA;QACnE,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,QAAQ,CAAC,kDAAkD,CAAC,CAAA;QACtE,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,QAAQ,CAAC;YACjB,4DAA4D;YAC5D,2CAA2C;SAC5C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACb,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAA;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,GAAG,QAAQ,CAAC;YACjB,gEAAgE;YAChE,mDAAmD;SACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACb,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wFAAwF,EAAE,GAAG,EAAE;QAChG,oEAAoE;QACpE,iCAAiC;QACjC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACvD,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACxD,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,mEAAmE;QACnE,gEAAgE;QAChE,2CAA2C;QAC3C,MAAM,CAAC,GAAG,QAAQ,CAAC,wCAAwC,CAAC,CAAA;QAC5D,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,CAAC,GAAG,QAAQ,CAAC;YACjB,6BAA6B;YAC7B,mCAAmC;SACpC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACb,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,GAAG,QAAQ,CAAC;YACjB,WAAW;YACX,EAAE;YACF,gEAAgE;YAChE,EAAE;YACF,SAAS;YACT,6CAA6C;YAC7C,+CAA+C;YAC/C,KAAK;YACL,EAAE;YACF,aAAa;SACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACb,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,GAAG,QAAQ,CAAC;YACjB,uCAAuC;YACvC,KAAK;YACL,oCAAoC;YACpC,KAAK;YACL,wCAAwC;YACxC,SAAS;YACT,oCAAoC;YACpC,KAAK;YACL,uCAAuC;SACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACb,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,wCAAwC,UAAU,KAAK,CAAC,CAAA;QAC3E,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAc,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,QAAQ,CAAC,4CAA4C,CAAC,CAAA;QAChE,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,gDAAgD;QAChD,+DAA+D;QAC/D,oDAAoD;QACpD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC9B,MAAM,CAAC,GAAG,QAAQ,CAAC,2BAA2B,OAAO,MAAM,CAAC,CAAA;QAC5D,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,mBAAmB,QAAQ,QAAQ,CAAC,CAAA;QACvD,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,CAAC,GAAG,QAAQ,CAAC;YACjB,0CAA0C;YAC1C,oCAAoC;SACrC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACb,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/api.d.ts

@@ -18,6 +18,10 @@ export interface RunAuditInput {
     ghBin?: string;
     bdBin?: string;
     args?: Record<string, unknown>;
+    /** Operator-supplied --knowledge-root override. Set by handleAudit
+     *  when the flag was passed; left undefined by all internal callers
+     *  except runFixFlow (which forwards from its own input). */
+    knowledgeRootOverride?: string;
 }
 export declare function runAudit(input: RunAuditInput): Promise<EngineOutput>;
 export declare function runProgress(input: RunProgressInput): Promise<EngineOutput>;

package/dist/observability/engine/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAmD,MAAM,YAAY,CAAA;AAgB/F,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AA2BD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAoBD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAyD1E;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6FhF"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAmD,MAAM,YAAY,CAAA;AAiB/F,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AA2BD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B;;iEAE6D;IAC7D,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAoBD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAyE1E;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6FhF"}

package/dist/observability/engine/api.js

@@ -9,6 +9,7 @@ import { LENS_REGISTRY, makeLensImplementations } from './checks/registry.js';
 import { aggregate } from './checks/findings-aggregator.js';
 import { resolveFixThreshold } from './checks/fix-threshold.js';
 import { loadObservabilityConfig } from './checks/observability-config.js';
+import { resolveKnowledgeRoot } from '../knowledge-index.js';
 import { gitAdapter } from '../adapters/git.js';
 import { ghAdapter } from '../adapters/gh.js';
 import { mmrAdapter } from '../adapters/mmr.js';
@@ -37,7 +38,7 @@ function scaffoldVersion() {
         return '0.0.0';
     }
 }
-const SCOPE_DOC_LENSES = new Set(['H-cross-doc']);
+const SCOPE_DOC_LENSES = new Set(['H-cross-doc', 'I-knowledge-gaps']);
 const SCOPE_CODE_LENSES = new Set([
     'A-tdd', 'B-ac-coverage', 'C-standards', 'D-stack', 'E-design', 'F-scope', 'G-decisions',
 ]);
@@ -68,6 +69,19 @@ export async function runAudit(input) {
     for (const disabled of config.disabled_lenses)
         enabledIds.delete(disabled);
     const fix_threshold = resolveFixThreshold(input.primaryRoot, input.fixThresholdOverride);
+    // The selfLocation anchors the auto-detect parent-walk to the CLI
+    // install directory. Without it, a downstream user auditing their
+    // own project (~/my-project/) would have the walk start from
+    // ~/my-project/ and never find the scaffold install's package.json.
+    // api.ts always lives inside the install (dist/observability/engine/
+    // after build), so dirname(fileURLToPath(import.meta.url)) is the
+    // correct anchor.
+    const resolution = resolveKnowledgeRoot({
+        override: input.knowledgeRootOverride,
+        cwd: input.primaryRoot,
+        selfLocation: dirname(fileURLToPath(import.meta.url)),
+    });
+    const warnedKeys = new Set();
     const rawFindings = await runChecks({
         registry: LENS_REGISTRY,
         lenses: makeLensImplementations(input.primaryRoot),
@@ -77,6 +91,8 @@ export async function runAudit(input) {
         profile: input.profile,
         cwd: input.primaryRoot,
         enabledIds,
+        knowledgeRootResolution: resolution,
+        warnedKeys,
     });
     const { findings, summary } = aggregate(rawFindings, merged.events, fix_threshold);
     const verdict = deriveVerdict(summary.blocking, summary.skipped_lenses);

package/dist/observability/engine/api.js.map

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

package/dist/observability/engine/checks/observability-config.d.ts

@@ -13,6 +13,9 @@ export interface FLensConfig {
 export interface GLensConfig {
     keywords_file?: string;
 }
+export interface ILensConfig {
+    knowledge_root?: string;
+}
 export interface DLensConfig {
     path_to_layer?: Array<{
         glob: string;
@@ -47,6 +50,7 @@ export interface ObservabilityConfig {
         'H-cross-doc'?: {
             skip_phase_subsets?: string[];
         };
+        'I-knowledge-gaps'?: ILensConfig;
     };
     disabled_lenses: string[];
     stall: StallConfig;

package/dist/observability/engine/checks/observability-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability-config.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/checks/observability-config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AACD,MAAM,WAAW,WAAW;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AACD,MAAM,WAAW,WAAW;IAC1B,2BAA2B,CAAC,EAAE,MAAM,CAAA;CACrC;AACD,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAChC,mBAAmB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACpC,yBAAyB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CAC3C;AAED,MAAM,WAAW,SAAS;IAGxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACvC,aAAa,CAAC,EAAE,WAAW,CAAA;QAC3B,SAAS,CAAC,EAAE,WAAW,CAAA;QACvB,UAAU,CAAC,EAAE,WAAW,CAAA;QACxB,SAAS,CAAC,EAAE,WAAW,CAAA;QACvB,aAAa,CAAC,EAAE,WAAW,CAAA;QAC3B,aAAa,CAAC,EAAE;YAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAA;KAClD,CAAA;IACD,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,KAAK,EAAE,WAAW,CAAA;IAClB,WAAW,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;IACvE,GAAG,EAAE,SAAS,CAAA;IACd,GAAG,EAAE,SAAS,CAAA;CACf;AAED,eAAO,MAAM,cAAc,EAAE,mBAgB5B,CAAA;AAmBD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAUxE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAInD"}
+{"version":3,"file":"observability-config.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/checks/observability-config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AACD,MAAM,WAAW,WAAW;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AACD,MAAM,WAAW,WAAW;IAC1B,2BAA2B,CAAC,EAAE,MAAM,CAAA;CACrC;AACD,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAChC,mBAAmB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACpC,yBAAyB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CAC3C;AAED,MAAM,WAAW,SAAS;IAGxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACvC,aAAa,CAAC,EAAE,WAAW,CAAA;QAC3B,SAAS,CAAC,EAAE,WAAW,CAAA;QACvB,UAAU,CAAC,EAAE,WAAW,CAAA;QACxB,SAAS,CAAC,EAAE,WAAW,CAAA;QACvB,aAAa,CAAC,EAAE,WAAW,CAAA;QAC3B,aAAa,CAAC,EAAE;YAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAA;QACjD,kBAAkB,CAAC,EAAE,WAAW,CAAA;KACjC,CAAA;IACD,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,KAAK,EAAE,WAAW,CAAA;IAClB,WAAW,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;IACvE,GAAG,EAAE,SAAS,CAAA;IACd,GAAG,EAAE,SAAS,CAAA;CACf;AAED,eAAO,MAAM,cAAc,EAAE,mBAiB5B,CAAA;AAmBD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAUxE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAInD"}

package/dist/observability/engine/checks/observability-config.js

@@ -8,6 +8,7 @@ export const DEFAULT_CONFIG = {
         'F-scope': { untouched_story_grace_hours: 168 },
         'G-decisions': {},
         'H-cross-doc': {},
+        'I-knowledge-gaps': {},
     },
     disabled_lenses: [],
     stall: {

package/dist/observability/engine/checks/observability-config.js.map

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

package/dist/observability/engine/checks/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/checks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAOvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAGrE,MAAM,MAAM,MAAM,GAAG,CACnB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,EAAE,YAAY,EAAE,eAAe,EAC3E,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,KACzC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AAEvB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAC7B,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EAiBvC,CAAA;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpE;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASvD,CAAA;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAE7B,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/checks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAOvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAIrE,MAAM,MAAM,MAAM,GAAG,CACnB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,EAAE,YAAY,EAAE,eAAe,EAC3E,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,KACzC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AAEvB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAC7B,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EAsBvC,CAAA;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpE;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUvD,CAAA;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAE7B,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnF"}

package/dist/observability/engine/checks/registry.js

@@ -6,6 +6,7 @@ import { lensEDesign } from '../../checks/lens-e-design.js';
 import { lensFScope } from '../../checks/lens-f-scope.js';
 import { makeLensGDecisions } from '../../checks/lens-g-decisions.js';
 import { lensHCrossDoc } from '../../checks/lens-h-cross-doc.js';
+import { lensIKnowledgeGaps } from '../../checks/lens-i-knowledge-gaps.js';
 export const LENS_REGISTRY = [
     { id: 'A-tdd', name: 'TDD violations', profiles: ['fast', 'full'],
         required: ['git', 'pipeline_docs'], optional: ['tests'] },
@@ -23,6 +24,11 @@ export const LENS_REGISTRY = [
         required: ['git', 'pipeline_docs'], optional: [], depends_on: ['D-stack'] },
     { id: 'H-cross-doc', name: 'Cross-doc inconsistency', profiles: ['fast', 'full'],
         required: ['pipeline_docs'], optional: [] },
+    {
+        id: 'I-knowledge-gaps', name: 'Knowledge gaps',
+        profiles: ['fast', 'full'],
+        required: [], optional: [],
+    },
 ];
 export function getLensManifest(id) {
     return LENS_REGISTRY.find((m) => m.id === id);
@@ -36,6 +42,7 @@ export const LENS_IMPLEMENTATIONS = {
     'F-scope': lensFScope,
     'G-decisions': makeLensGDecisions(process.cwd()),
     'H-cross-doc': lensHCrossDoc,
+    'I-knowledge-gaps': lensIKnowledgeGaps,
 };
 export { makeLensGDecisions };
 export function makeLensImplementations(projectRoot) {

package/dist/observability/engine/checks/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/observability/engine/checks/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAgBhE,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,EAAE,EAAE,EAAE,OAAO,EAAU,IAAI,EAAE,gBAAgB,EAAW,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAChF,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;IAC3D,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAY,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAChF,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;IAC1D,EAAE,EAAE,EAAE,aAAa,EAAI,IAAI,EAAE,wBAAwB,EAAG,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAChF,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;IAC3D,EAAE,EAAE,EAAE,SAAS,EAAQ,IAAI,EAAE,kBAAkB,EAAS,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAChF,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IACpD,EAAE,EAAE,EAAE,UAAU,EAAO,IAAI,EAAE,qBAAqB,EAAM,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAChF,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IACpD,EAAE,EAAE,EAAE,SAAS,EAAQ,IAAI,EAAE,eAAe,EAAY,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAChF,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;IACnE,EAAE,EAAE,EAAE,aAAa,EAAI,IAAI,EAAE,wBAAwB,EAAG,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAChF,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;IAC7E,EAAE,EAAE,EAAE,aAAa,EAAI,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAChF,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;CAC9C,CAAA;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,OAAO,EAAU,QAAQ;IACzB,eAAe,EAAE,eAAe;IAChC,aAAa,EAAI,cAAc;IAC/B,SAAS,EAAQ,UAAU;IAC3B,UAAU,EAAO,WAAW;IAC5B,SAAS,EAAQ,UAAU;IAC3B,aAAa,EAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAClD,aAAa,EAAI,aAAa;CAC/B,CAAA;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAE7B,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO,EAAE,GAAG,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAA;AACpF,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/observability/engine/checks/registry.ts"],"names":[],"mappings":"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"}

package/dist/observability/engine/checks/registry.test.js

@@ -1,10 +1,11 @@
 import { describe, it, expect } from 'vitest';
 import { LENS_REGISTRY, getLensManifest } from './registry.js';
 describe('LENS_REGISTRY', () => {
-    it('has all eight lenses', () => {
+    it('has all nine lenses', () => {
         const ids = LENS_REGISTRY.map((m) => m.id).sort();
         expect(ids).toEqual([
-            'A-tdd', 'B-ac-coverage', 'C-standards', 'D-stack', 'E-design', 'F-scope', 'G-decisions', 'H-cross-doc',
+            'A-tdd', 'B-ac-coverage', 'C-standards', 'D-stack',
+            'E-design', 'F-scope', 'G-decisions', 'H-cross-doc', 'I-knowledge-gaps',
         ]);
     });
     it('every entry declares fast profile membership', () => {

package/dist/observability/engine/checks/registry.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../../../src/observability/engine/checks/registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE9D,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa;SACxG,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,KAAK,MAAM,CAAC,IAAI,aAAa;YAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,CAAC,GAAG,eAAe,CAAC,aAAa,CAAC,CAAA;QACxC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uFAAuF,EAAE,GAAG,EAAE;QAC/F,MAAM,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;QAC3E,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../../../src/observability/engine/checks/registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE9D,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS;YAClD,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB;SACxE,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,KAAK,MAAM,CAAC,IAAI,aAAa;YAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,CAAC,GAAG,eAAe,CAAC,aAAa,CAAC,CAAA;QACxC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uFAAuF,EAAE,GAAG,EAAE;QAC/F,MAAM,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;QAC3E,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/checks/runner.d.ts

@@ -1,8 +1,25 @@
 import type { Event, Finding, AvailabilityMap, DocGraph } from '../types.js';
 import type { LensManifest } from './registry.js';
+import type { KnowledgeRootAttempt } from '../../knowledge-index.js';
 export interface LensContext {
     profile: 'fast' | 'full';
     cwd: string;
+    /** Validated absolute path to a content/knowledge/ directory whose
+     *  entry slugs are used to suppress Lens I findings. Undefined when
+     *  no path was resolved (or when a caller bypassed runAudit). Lens I
+     *  treats undefined/null as "no suppression". */
+    knowledgeRoot?: string | null;
+    /** Pre-loaded index Set, populated by resolveKnowledgeRoot during
+     *  validation. Lens I reads this directly — does NOT call
+     *  loadKnowledgeIndex itself. */
+    knowledgeIndex?: Set<string> | null;
+    /** Audit trail of which knowledge-root tiers were tried. Lens I
+     *  uses this to compose a precise warn-once message when
+     *  knowledgeRoot is null. Defaults to empty when undefined. */
+    knowledgeRootAttempts?: KnowledgeRootAttempt[];
+    /** Per-audit-run Set passed to emitOnceForAudit for deduplicating
+     *  warnings. Fresh Set per runAudit invocation. */
+    warnedKeys?: Set<string>;
 }
 export type LensFn = (graph: DocGraph, ledger: {
     events: Event[];
@@ -18,6 +35,19 @@ export interface RunChecksInput {
     profile: 'fast' | 'full';
     cwd?: string;
     enabledIds?: Set<string>;
+    /** Optional pre-computed knowledge-root resolution. When provided
+     *  the runner threads root/index/attempts into every LensContext.
+     *  runAudit populates this; tests that bypass runAudit can leave
+     *  it undefined (the lens treats that as "no suppression"). */
+    knowledgeRootResolution?: {
+        root: string | null;
+        index: Set<string> | null;
+        attempts: KnowledgeRootAttempt[];
+    };
+    /** Optional caller-provided warn-once Set. runAudit creates a fresh
+     *  one per invocation; tests bypassing runAudit may leave it
+     *  undefined (runChecks then creates an empty Set per call). */
+    warnedKeys?: Set<string>;
 }
 export declare function runChecks(input: RunChecksInput): Promise<Finding[]>;
 //# sourceMappingURL=runner.d.ts.map

package/dist/observability/engine/checks/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/checks/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAa,QAAQ,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,MAAM,MAAM,GAAG,CACnB,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE;IAAE,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,EAC3B,YAAY,EAAE,eAAe,EAC7B,gBAAgB,EAAE,OAAO,EAAE,EAC3B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AAEvB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,EAAE,CAAA;KAAE,CAAA;IAC3B,YAAY,EAAE,eAAe,CAAA;IAC7B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACzB;AA6CD,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAuBzE"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/checks/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAa,QAAQ,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAEpE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,GAAG,EAAE,MAAM,CAAA;IACX;;;qDAGiD;IACjD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;qCAEiC;IACjC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IACnC;;mEAE+D;IAC/D,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAC9C;uDACmD;IACnD,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACzB;AAED,MAAM,MAAM,MAAM,GAAG,CACnB,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE;IAAE,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,EAC3B,YAAY,EAAE,eAAe,EAC7B,gBAAgB,EAAE,OAAO,EAAE,EAC3B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AAEvB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,EAAE,CAAA;KAAE,CAAA;IAC3B,YAAY,EAAE,eAAe,CAAA;IAC7B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACxB;;;mEAG+D;IAC/D,uBAAuB,CAAC,EAAE;QACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;QACzB,QAAQ,EAAE,oBAAoB,EAAE,CAAA;KACjC,CAAA;IACD;;oEAEgE;IAChE,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACzB;AA6CD,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA8BzE"}