@zigrivers/scaffold 3.25.1 → 3.26.0

package/dist/observability/engine/doc-graph/index.test.js

@@ -0,0 +1,82 @@
+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 { buildDocGraph } from './index.js';
+describe('buildDocGraph', () => {
+    let dir;
+    beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-graph-')); });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('produces a complete graph from a small project fixture', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/auth'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), JSON.stringify({ scripts: { test: 'vitest run' } }));
+        writeFileSync(join(dir, 'docs/plan.md'), '# PRD\n\n## Features\n\n### User Auth [priority: must]\n\nUsers sign in.\n');
+        writeFileSync(join(dir, 'docs/user-stories.md'), '# Stories\n\n## Story user-auth-1: Sign in [priority: must]\n\n' +
+            '### AC 1: signs in\nGiven valid credentials, the user signs in.\n');
+        writeFileSync(join(dir, 'docs/implementation-plan.md'), '# Plan\n\n## Task T-001: Login form [story: user-auth-1] [status: done]\n');
+        writeFileSync(join(dir, 'src/auth/login.test.ts'), 'import { it, expect } from \'vitest\'\nit(\'AC 1: signs in\', () => { expect(1).toBe(1) })\n');
+        const graph = await buildDocGraph(dir);
+        expect(graph.features).toHaveLength(1);
+        expect(graph.stories).toHaveLength(1);
+        expect(graph.acceptance_criteria).toHaveLength(1);
+        expect(graph.plan_tasks).toHaveLength(1);
+        expect(graph.tests.length).toBeGreaterThanOrEqual(1);
+        expect(graph.edges.find((e) => e.kind === 'story_to_ac')).toBeDefined();
+        expect(graph.edges.find((e) => e.kind === 'story_to_plan_task')).toBeDefined();
+        expect(graph.edges.find((e) => e.kind === 'test_to_file')).toBeDefined();
+        expect(graph.provenance['feature:user-auth']).toBe('pipeline_docs');
+        expect(graph.provenance[graph.tests[0].id]).toBe('git');
+    });
+    it('returns an empty graph when no docs exist', async () => {
+        writeFileSync(join(dir, 'package.json'), '{}');
+        const graph = await buildDocGraph(dir);
+        expect(graph.features).toEqual([]);
+        expect(graph.stories).toEqual([]);
+        expect(graph.edges).toEqual([]);
+    });
+    it('emits file_to_token_use and file_to_component_use edges when detectors match', async () => {
+        mkdirSync(join(dir, 'docs'), { recursive: true });
+        mkdirSync(join(dir, 'src/styles'), { recursive: true });
+        mkdirSync(join(dir, 'src/lib'), { recursive: true });
+        mkdirSync(join(dir, '.scaffold'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{}');
+        writeFileSync(join(dir, 'docs/design-system.md'), [
+            '# Design System',
+            '',
+            '## Color',
+            '',
+            '| Token | Value | Priority |',
+            '|-------|-------|----------|',
+            '| --color-primary | #4f46e5 | must |',
+            '',
+        ].join('\n'));
+        writeFileSync(join(dir, 'docs/tech-stack.md'), [
+            '# Tech Stack',
+            '',
+            '## Frontend',
+            '',
+            '### React',
+            '',
+            'package_or_url: react@18',
+            'layer: frontend',
+            '',
+        ].join('\n'));
+        writeFileSync(join(dir, 'src/styles/btn.css'), '.btn { color: #4f46e5; background: #abcdef; }\n');
+        writeFileSync(join(dir, 'src/lib/auth.ts'), 'import React from \'react\'\nimport { something } from \'unknown-pkg\'\n');
+        writeFileSync(join(dir, '.scaffold/observability.yaml'), [
+            'lenses:',
+            '  E-design:',
+            '    ui_glob: "src/styles/**/*.css,src/styles/**/*.scss"',
+        ].join('\n'));
+        const graph = await buildDocGraph(dir);
+        const tokenEdge = graph.edges.find((e) => e.kind === 'file_to_token_use');
+        expect(tokenEdge).toBeDefined();
+        expect(tokenEdge?.from).toBe('file:src/styles/btn.css');
+        const componentEdges = graph.edges.filter((e) => e.kind === 'file_to_component_use');
+        expect(componentEdges.length).toBeGreaterThanOrEqual(2);
+        expect(componentEdges.find((e) => e.to === 'component:react')).toBeDefined();
+        expect(componentEdges.find((e) => e.to.startsWith('unsanctioned'))).toBeDefined();
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/observability/engine/doc-graph/index.test.js.map

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

package/dist/observability/engine/doc-graph/parse-markdown.d.ts

@@ -0,0 +1,15 @@
+import type { Root, Heading, RootContent } from 'mdast';
+export interface AnnotatedHeading {
+    node: Heading;
+    textContent: string;
+    depth: number;
+    startIndex: number;
+}
+export declare function parseMarkdown(input: string): Root;
+export declare function headingsAtDepth(root: Root, depth: number): AnnotatedHeading[];
+export declare function sectionAfterHeading(root: Root, heading: AnnotatedHeading): string;
+export declare function sectionRawText(root: Root, heading: AnnotatedHeading): string;
+export declare function sectionNodes(root: Root, heading: AnnotatedHeading): RootContent[];
+export declare function extractInlineTags(text: string): Record<string, string>;
+export declare function slugify(text: string): string;
+//# sourceMappingURL=parse-markdown.d.ts.map

package/dist/observability/engine/doc-graph/parse-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-markdown.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/parse-markdown.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACnB;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjD;AAiBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAS7E;AAeD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAIjF;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAG5E;AAGD,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,WAAW,EAAE,CAGjF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMtE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5C"}

package/dist/observability/engine/doc-graph/parse-markdown.js

@@ -0,0 +1,79 @@
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import remarkStringify from 'remark-stringify';
+const parser = unified().use(remarkParse).use(remarkGfm).use(remarkStringify, { bullet: '-' });
+export function parseMarkdown(input) {
+    return parser.parse(input);
+}
+function nodeText(node) {
+    if (node.type === 'text' || node.type === 'inlineCode')
+        return node.value;
+    // Put each list item on its own line so field-extraction regexes work.
+    if (node.type === 'listItem') {
+        return (node.children).map(nodeText).join('').trim();
+    }
+    if (node.type === 'list') {
+        return (node.children).map(nodeText).join('\n').trim();
+    }
+    if ('children' in node && Array.isArray(node.children)) {
+        return (node.children).map(nodeText).join('');
+    }
+    return '';
+}
+export function headingsAtDepth(root, depth) {
+    const out = [];
+    for (let i = 0; i < root.children.length; i++) {
+        const c = root.children[i];
+        if (c.type === 'heading' && c.depth === depth) {
+            out.push({ node: c, textContent: nodeText(c).trim(), depth, startIndex: i });
+        }
+    }
+    return out;
+}
+function sectionRange(root, heading) {
+    const start = heading.startIndex + 1;
+    let end = root.children.length;
+    for (let i = start; i < root.children.length; i++) {
+        const c = root.children[i];
+        if (c.type === 'heading' && c.depth <= heading.depth) {
+            end = i;
+            break;
+        }
+    }
+    return [start, end];
+}
+export function sectionAfterHeading(root, heading) {
+    const [start, end] = sectionRange(root, heading);
+    const slice = { type: 'root', children: root.children.slice(start, end) };
+    return parser.stringify(slice).trim();
+}
+// Returns raw text content of the section using AST-level text extraction
+// (avoids remark-stringify escaping, preserves inline code verbatim).
+export function sectionRawText(root, heading) {
+    const [start, end] = sectionRange(root, heading);
+    return root.children.slice(start, end).map((n) => nodeText(n)).join('\n\n').trim();
+}
+// Returns raw AST nodes in the section.
+export function sectionNodes(root, heading) {
+    const [start, end] = sectionRange(root, heading);
+    return root.children.slice(start, end);
+}
+export function extractInlineTags(text) {
+    const tags = {};
+    for (const match of text.matchAll(/\[([a-z_][a-z0-9_-]*)\s*:\s*([^\]]+?)\s*\]/gi)) {
+        tags[match[1]] = match[2].trim();
+    }
+    return tags;
+}
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/\[[^\]]*\]/g, '') // strip inline tags
+        .replace(/[^\w\s-]+/g, ' ') // remove non-word chars including em-dash
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=parse-markdown.js.map

package/dist/observability/engine/doc-graph/parse-markdown.js.map

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

package/dist/observability/engine/doc-graph/parse-markdown.test.d.ts

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

package/dist/observability/engine/doc-graph/parse-markdown.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-markdown.test.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/parse-markdown.test.ts"],"names":[],"mappings":""}

package/dist/observability/engine/doc-graph/parse-markdown.test.js

@@ -0,0 +1,50 @@
+import { describe, it, expect } from 'vitest';
+import { parseMarkdown, headingsAtDepth, sectionAfterHeading, slugify, extractInlineTags } from './parse-markdown.js';
+describe('parse-markdown', () => {
+    const sample = `# Title
+
+Some intro text.
+
+## First Heading [priority: must]
+
+Body of first section.
+
+### Sub heading
+
+More content.
+
+## Second Heading [priority: should]
+
+Final section.
+`;
+    it('parseMarkdown returns a remark AST root', () => {
+        const root = parseMarkdown(sample);
+        expect(root.type).toBe('root');
+        expect(root.children.length).toBeGreaterThan(0);
+    });
+    it('headingsAtDepth(2) returns the two ## headings with their text', () => {
+        const root = parseMarkdown(sample);
+        const h2s = headingsAtDepth(root, 2);
+        expect(h2s.map((h) => h.textContent)).toEqual([
+            'First Heading [priority: must]',
+            'Second Heading [priority: should]',
+        ]);
+    });
+    it('sectionAfterHeading returns markdown text until the next same-or-higher heading', () => {
+        const root = parseMarkdown(sample);
+        const h2s = headingsAtDepth(root, 2);
+        const body = sectionAfterHeading(root, h2s[0]);
+        expect(body).toContain('Body of first section.');
+        expect(body).toContain('Sub heading');
+        expect(body).not.toContain('Final section.');
+    });
+    it('extractInlineTags pulls [key: value] tags from a heading text', () => {
+        const tags = extractInlineTags('First Heading [priority: must] [kind: ui]');
+        expect(tags).toEqual({ priority: 'must', kind: 'ui' });
+    });
+    it('slugify produces stable kebab-case ids', () => {
+        expect(slugify('First Heading [priority: must]')).toBe('first-heading');
+        expect(slugify('User Auth — Login & Signup')).toBe('user-auth-login-signup');
+    });
+});
+//# sourceMappingURL=parse-markdown.test.js.map

package/dist/observability/engine/doc-graph/parse-markdown.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-markdown.test.js","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/parse-markdown.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAErH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;CAehB,CAAA;IAEC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;QAClC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;QAClC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5C,gCAAgC;YAChC,mCAAmC;SACpC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;QAClC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACpC,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAA;QAChD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,IAAI,GAAG,iBAAiB,CAAC,2CAA2C,CAAC,CAAA;QAC3E,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QACvE,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/doc-graph/plan-task-parser.d.ts

@@ -0,0 +1,3 @@
+import type { PlanTask } from '../types.js';
+export declare function parsePlanTasks(md: string, sourcePath?: string): PlanTask[];
+//# sourceMappingURL=plan-task-parser.d.ts.map

package/dist/observability/engine/doc-graph/plan-task-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-task-parser.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/plan-task-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAU3C,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,SAAgC,GAAG,QAAQ,EAAE,CA6BjG"}

package/dist/observability/engine/doc-graph/plan-task-parser.js

@@ -0,0 +1,38 @@
+import { parseMarkdown, extractInlineTags } from './parse-markdown.js';
+const VALID_STATUS = ['todo', 'in_flight', 'done', 'skipped'];
+function headingText(h) {
+    return h.children.map((c) => ('value' in c ? c.value : '')).join('').trim();
+}
+export function parsePlanTasks(md, sourcePath = 'docs/implementation-plan.md') {
+    const root = parseMarkdown(md);
+    const tasks = [];
+    for (const node of root.children) {
+        if (node.type !== 'heading')
+            continue;
+        const h = node;
+        if (h.depth !== 2 && h.depth !== 3)
+            continue;
+        const text = headingText(h);
+        const m = text.match(/^Task\s+([A-Za-z0-9][\w-]+):\s*(.+?)(?:\s*\[.*)?$/);
+        if (!m)
+            continue;
+        const [, key, rawTitle] = m;
+        const title = rawTitle.replace(/\s*\[[^\]]*\]\s*$/g, '').trim();
+        const tags = extractInlineTags(text);
+        const status = VALID_STATUS.includes(tags.status)
+            ? tags.status
+            : 'todo';
+        tasks.push({
+            id: `plan_task:${key}`,
+            title,
+            status,
+            story_id: tags.story
+                ? (tags.story.startsWith('story:') ? tags.story : `story:${tags.story}`)
+                : undefined,
+            wave: tags.wave,
+            source_anchor: `${sourcePath}#task-${key.toLowerCase()}`,
+        });
+    }
+    return tasks;
+}
+//# sourceMappingURL=plan-task-parser.js.map

package/dist/observability/engine/doc-graph/plan-task-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-task-parser.js","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/plan-task-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGtE,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAU,CAAA;AAEtE,SAAS,WAAW,CAAC,CAAU;IAC7B,OAAQ,CAAC,CAAC,QAA0B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAE,CAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AACvH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,UAAU,GAAG,6BAA6B;IACnF,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAe,EAAE,CAAA;IAE5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,SAAQ;QACrC,MAAM,CAAC,GAAG,IAAe,CAAA;QACzB,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;YAAE,SAAQ;QAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACzE,IAAI,CAAC,CAAC;YAAE,SAAQ;QAChB,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/D,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,MAAM,GAAI,YAAkC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YACtE,CAAC,CAAE,IAAI,CAAC,MAA6B;YACrC,CAAC,CAAC,MAAM,CAAA;QACV,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,aAAa,GAAG,EAAE;YACtB,KAAK;YACL,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,KAAK;gBAClB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;gBACxE,CAAC,CAAC,SAAS;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,GAAG,UAAU,SAAS,GAAG,CAAC,WAAW,EAAE,EAAE;SACzD,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/observability/engine/doc-graph/plan-task-parser.test.d.ts

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

package/dist/observability/engine/doc-graph/plan-task-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-task-parser.test.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/plan-task-parser.test.ts"],"names":[],"mappings":""}

package/dist/observability/engine/doc-graph/plan-task-parser.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect } from 'vitest';
+import { parsePlanTasks } from './plan-task-parser.js';
+describe('parsePlanTasks', () => {
+    it('extracts tasks from H2 with story/wave/status tags', () => {
+        const md = `# Implementation Plan
+
+## Task T-001: Build login form [story: user-auth-1] [wave: wave-1] [status: done]
+
+Files: src/auth/login.tsx
+ACs: 1.1, 1.2
+
+## Task T-002: Server-side validation [story: user-auth-1] [wave: wave-1]
+
+(no status tag → todo)
+
+## Task T-003: Password reset [story: user-auth-2] [wave: wave-2] [status: in_flight]
+`;
+        const tasks = parsePlanTasks(md);
+        expect(tasks).toHaveLength(3);
+        expect(tasks[0]).toMatchObject({
+            id: 'plan_task:T-001',
+            title: 'Build login form',
+            status: 'done',
+            story_id: 'story:user-auth-1',
+            wave: 'wave-1',
+            source_anchor: 'docs/implementation-plan.md#task-t-001',
+        });
+        expect(tasks[1].status).toBe('todo');
+        expect(tasks[2].status).toBe('in_flight');
+    });
+    it('also accepts H3 task headings (deep methodology format)', () => {
+        const md = '# Implementation Plan\n\n## Wave 1\n\n### Task T-001: Foo [story: s-1]\nBody.\n';
+        const tasks = parsePlanTasks(md);
+        expect(tasks).toHaveLength(1);
+        expect(tasks[0].id).toBe('plan_task:T-001');
+    });
+});
+//# sourceMappingURL=plan-task-parser.test.js.map

package/dist/observability/engine/doc-graph/plan-task-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-task-parser.test.js","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/plan-task-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,GAAG;;;;;;;;;;;;CAYd,CAAA;QACG,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,CAAA;QAChC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC7B,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,kBAAkB;YACzB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,mBAAmB;YAC7B,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,wCAAwC;SACxD,CAAC,CAAA;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,EAAE,GAAG,iFAAiF,CAAA;QAC5F,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,CAAA;QAChC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/doc-graph/playbook-task-parser.d.ts

@@ -0,0 +1,3 @@
+import type { PlaybookTask } from '../types.js';
+export declare function parsePlaybookTasks(md: string, sourcePath?: string): PlaybookTask[];
+//# sourceMappingURL=playbook-task-parser.d.ts.map

package/dist/observability/engine/doc-graph/playbook-task-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-task-parser.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/playbook-task-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAU/C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,SAAoC,GAAG,YAAY,EAAE,CA+B7G"}

package/dist/observability/engine/doc-graph/playbook-task-parser.js

@@ -0,0 +1,40 @@
+import { parseMarkdown, extractInlineTags } from './parse-markdown.js';
+const VALID_STATUS = ['todo', 'in_flight', 'done', 'skipped'];
+function headingText(h) {
+    return h.children.map((c) => ('value' in c ? c.value : '')).join('').trim();
+}
+export function parsePlaybookTasks(md, sourcePath = 'docs/implementation-playbook.md') {
+    const root = parseMarkdown(md);
+    const out = [];
+    for (const node of root.children) {
+        if (node.type !== 'heading')
+            continue;
+        const h = node;
+        if (h.depth !== 2 && h.depth !== 3)
+            continue;
+        const text = headingText(h);
+        const m = text.match(/^Task\s+([A-Za-z0-9][\w-]+):\s*(.+?)(?:\s*\[.*)?$/);
+        if (!m)
+            continue;
+        const [, key, rawTitle] = m;
+        const title = rawTitle.replace(/\s*\[[^\]]*\]\s*$/g, '').trim();
+        const tags = extractInlineTags(text);
+        const status = VALID_STATUS.includes(tags.status)
+            ? tags.status
+            : 'todo';
+        out.push({
+            id: `playbook_task:${key}`,
+            title,
+            status,
+            story_id: tags.story
+                ? (tags.story.startsWith('story:') ? tags.story : `story:${tags.story}`)
+                : undefined,
+            plan_task_id: tags.plan_task
+                ? (tags.plan_task.startsWith('plan_task:') ? tags.plan_task : `plan_task:${tags.plan_task}`)
+                : undefined,
+            source_anchor: `${sourcePath}#task-${key.toLowerCase()}`,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=playbook-task-parser.js.map

package/dist/observability/engine/doc-graph/playbook-task-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-task-parser.js","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/playbook-task-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGtE,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAU,CAAA;AAEtE,SAAS,WAAW,CAAC,CAAU;IAC7B,OAAQ,CAAC,CAAC,QAA0B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAE,CAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AACvH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,UAAU,GAAG,iCAAiC;IAC3F,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,CAAC,CAAA;IAC9B,MAAM,GAAG,GAAmB,EAAE,CAAA;IAE9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,SAAQ;QACrC,MAAM,CAAC,GAAG,IAAe,CAAA;QACzB,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;YAAE,SAAQ;QAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACzE,IAAI,CAAC,CAAC;YAAE,SAAQ;QAChB,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/D,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,MAAM,GAAI,YAAkC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YACtE,CAAC,CAAE,IAAI,CAAC,MAAiC;YACzC,CAAC,CAAC,MAAM,CAAA;QACV,GAAG,CAAC,IAAI,CAAC;YACP,EAAE,EAAE,iBAAiB,GAAG,EAAE;YAC1B,KAAK;YACL,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,KAAK;gBAClB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;gBACxE,CAAC,CAAC,SAAS;YACb,YAAY,EAAE,IAAI,CAAC,SAAS;gBAC1B,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC5F,CAAC,CAAC,SAAS;YACb,aAAa,EAAE,GAAG,UAAU,SAAS,GAAG,CAAC,WAAW,EAAE,EAAE;SACzD,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/observability/engine/doc-graph/playbook-task-parser.test.d.ts

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

package/dist/observability/engine/doc-graph/playbook-task-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-task-parser.test.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/playbook-task-parser.test.ts"],"names":[],"mappings":""}

package/dist/observability/engine/doc-graph/playbook-task-parser.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest';
+import { parsePlaybookTasks } from './playbook-task-parser.js';
+describe('parsePlaybookTasks', () => {
+    it('extracts playbook tasks linking back to plan tasks via [plan_task: ID]', () => {
+        const md = `# Playbook
+
+## Task T-001: Build login form [plan_task: T-001] [story: user-auth-1] [status: done]
+
+Files modified: src/auth/login.tsx
+
+## Task TB-001: Hotfix for login crash [story: user-auth-1] [status: done] [unplanned: true]
+
+Triaged from prod incident.
+`;
+        const tasks = parsePlaybookTasks(md);
+        expect(tasks).toHaveLength(2);
+        expect(tasks[0]).toMatchObject({
+            id: 'playbook_task:T-001',
+            title: 'Build login form',
+            status: 'done',
+            story_id: 'story:user-auth-1',
+            plan_task_id: 'plan_task:T-001',
+        });
+        expect(tasks[1]).toMatchObject({
+            id: 'playbook_task:TB-001',
+            plan_task_id: undefined,
+            story_id: 'story:user-auth-1',
+        });
+    });
+});
+//# sourceMappingURL=playbook-task-parser.test.js.map

package/dist/observability/engine/doc-graph/playbook-task-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-task-parser.test.js","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/playbook-task-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE9D,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,EAAE,GAAG;;;;;;;;;CASd,CAAA;QACG,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAA;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC7B,EAAE,EAAE,qBAAqB;YACzB,KAAK,EAAE,kBAAkB;YACzB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,mBAAmB;YAC7B,YAAY,EAAE,iBAAiB;SAChC,CAAC,CAAA;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC7B,EAAE,EAAE,sBAAsB;YAC1B,YAAY,EAAE,SAAS;YACvB,QAAQ,EAAE,mBAAmB;SAC9B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/doc-graph/rule-parser.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types.js';
+export declare function parseRules(md: string, sourcePath: string): Rule[];
+//# sourceMappingURL=rule-parser.d.ts.map

package/dist/observability/engine/doc-graph/rule-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-parser.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/rule-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAgCvC,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,CAyBjE"}

package/dist/observability/engine/doc-graph/rule-parser.js

@@ -0,0 +1,65 @@
+import { parseMarkdown, headingsAtDepth, sectionRawText, slugify } from './parse-markdown.js';
+const VALID_SEVERITY = ['P0', 'P1', 'P2', 'P3'];
+const VALID_ENFORCE = ['linter', 'engine', 'llm'];
+function parseRuleSection(body) {
+    const out = {};
+    const descMatch = body.match(/^Description:\s*(.+?)(?=\n|$)/im);
+    if (descMatch)
+        out.description = descMatch[1].trim();
+    const fieldRe = /^\s*([a-z][\w-]*)\s*:\s*(.+?)\s*$/gim;
+    let m;
+    while ((m = fieldRe.exec(body)) !== null) {
+        const key = m[1].replace(/-/g, '_').toLowerCase();
+        const raw = m[2].trim();
+        switch (key) {
+            case 'pattern':
+                out.pattern = raw;
+                break;
+            case 'forbidden':
+                out.forbidden = raw.split(',').map((s) => s.trim()).filter(Boolean);
+                break;
+            case 'match':
+                out.match = raw;
+                break;
+            case 'language':
+                out.language = raw;
+                break;
+            case 'severity':
+                if (VALID_SEVERITY.includes(raw))
+                    out.severity = raw;
+                break;
+            case 'enforce_via':
+                if (VALID_ENFORCE.includes(raw))
+                    out.enforce_via = raw;
+                break;
+        }
+    }
+    return out;
+}
+export function parseRules(md, sourcePath) {
+    const root = parseMarkdown(md);
+    const rules = [];
+    for (const depth of [2, 3]) {
+        for (const head of headingsAtDepth(root, depth)) {
+            const m = head.textContent.match(/^Rule:\s*(.+?)\s*$/i);
+            if (!m)
+                continue;
+            const id = `rule:${slugify(m[1])}`;
+            const body = sectionRawText(root, head);
+            const parsed = parseRuleSection(body);
+            rules.push({
+                id,
+                description: parsed.description ?? m[1],
+                pattern: parsed.pattern,
+                forbidden: parsed.forbidden,
+                match: parsed.match,
+                language: parsed.language,
+                severity: parsed.severity,
+                enforce_via: parsed.enforce_via,
+                source_anchor: `${sourcePath}#${slugify(m[1])}`,
+            });
+        }
+    }
+    return rules;
+}
+//# sourceMappingURL=rule-parser.js.map

package/dist/observability/engine/doc-graph/rule-parser.js.map

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

package/dist/observability/engine/doc-graph/rule-parser.test.d.ts

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

package/dist/observability/engine/doc-graph/rule-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-parser.test.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/rule-parser.test.ts"],"names":[],"mappings":""}

package/dist/observability/engine/doc-graph/rule-parser.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { parseRules } from './rule-parser.js';
+describe('parseRules', () => {
+    it('extracts H3 Rule blocks with structured fields', () => {
+        const md = `# Coding Standards
+
+## TypeScript
+
+### Rule: no-console
+
+Description: Avoid \`console.log\` in production source.
+
+- pattern: \`console\\.log\\(\`
+- match: src/**/*.ts
+- language: typescript
+- severity: P1
+- enforce-via: linter
+
+### Rule: prefer-const
+
+Description: Use \`const\` for never-reassigned bindings.
+
+- forbidden: let immutable, var
+- language: typescript
+`;
+        const rules = parseRules(md, 'docs/coding-standards.md');
+        expect(rules).toHaveLength(2);
+        expect(rules[0]).toMatchObject({
+            id: 'rule:no-console',
+            pattern: 'console\\.log\\(',
+            match: 'src/**/*.ts',
+            language: 'typescript',
+            severity: 'P1',
+            enforce_via: 'linter',
+        });
+        expect(rules[0].description).toContain('console.log');
+        expect(rules[1].forbidden).toEqual(['let immutable', 'var']);
+    });
+    it('returns [] when no Rule headings exist', () => {
+        const md = '# Coding Standards\n\n## TypeScript\n\nUse TypeScript everywhere.\n';
+        expect(parseRules(md, 'docs/coding-standards.md')).toEqual([]);
+    });
+});
+//# sourceMappingURL=rule-parser.test.js.map

package/dist/observability/engine/doc-graph/rule-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-parser.test.js","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/rule-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;CAoBd,CAAA;QACG,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,EAAE,0BAA0B,CAAC,CAAA;QACxD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC7B,EAAE,EAAE,iBAAiB;YACrB,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,QAAQ;SACtB,CAAC,CAAA;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;QACrD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,EAAE,GAAG,qEAAqE,CAAA;QAChF,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,0BAA0B,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/doc-graph/story-parser.d.ts

@@ -0,0 +1,8 @@
+import type { Story, AcceptanceCriterion } from '../types.js';
+interface ParsedStories {
+    stories: Story[];
+    acs: AcceptanceCriterion[];
+}
+export declare function parseStories(md: string): ParsedStories;
+export {};
+//# sourceMappingURL=story-parser.d.ts.map

package/dist/observability/engine/doc-graph/story-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-parser.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/story-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAI7D,UAAU,aAAa;IAAG,OAAO,EAAE,KAAK,EAAE,CAAC;IAAC,GAAG,EAAE,mBAAmB,EAAE,CAAA;CAAE;AA2ExE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAgCtD"}