@zigrivers/scaffold 3.25.1 → 3.27.0

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

@@ -0,0 +1,109 @@
+import { parseMarkdown, headingsAtDepth, sectionAfterHeading, extractInlineTags, slugify } from './parse-markdown.js';
+const VALID_PRIORITIES = ['must', 'should', 'could', 'wont'];
+function nodeTextRecursive(n) {
+    if (n.type === 'text' || n.type === 'inlineCode')
+        return n.value ?? '';
+    if (Array.isArray(n.children))
+        return n.children.map(nodeTextRecursive).join('');
+    return '';
+}
+function priorityFromTags(tags) {
+    return VALID_PRIORITIES.includes(tags.priority)
+        ? tags.priority
+        : 'should';
+}
+function parseStoryHeading(text) {
+    const stripped = text.replace(/\[[^\]]*\]/g, '').trim();
+    const m = stripped.match(/^(?:Story\s+)?([A-Za-z0-9][\w-]+):\s*(.+)$/);
+    if (m)
+        return { storyKey: m[1], title: m[2].trim() };
+    return null;
+}
+function parseAcsFromSection(root, story, storyStartIdx, storyEndIdx) {
+    const out = [];
+    // (a) ### AC <n>: <title> headings
+    for (let i = storyStartIdx + 1; i < storyEndIdx; i++) {
+        const c = root.children[i];
+        if (c.type !== 'heading' || c.depth !== 3)
+            continue;
+        const headingText = nodeTextRecursive(c).trim();
+        const acMatch = headingText.match(/^AC\s*(\d+)\b\s*:?\s*(.*)$/i);
+        if (!acMatch)
+            continue;
+        const annotated = { node: c, textContent: headingText, depth: 3, startIndex: i };
+        const sectionText = sectionAfterHeading(root, annotated);
+        const acId = `ac:${story.id.replace(/^story:/, '')}.${acMatch[1]}`;
+        const bodyText = [acMatch[2] ? acMatch[2] : '', sectionText].filter(Boolean).join('\n\n').trim();
+        out.push({
+            id: acId,
+            story_id: story.id,
+            text: bodyText.slice(0, 500),
+            source_anchor: `docs/user-stories.md#${acId.replace(/[:.]/g, '-')}`,
+        });
+    }
+    if (out.length > 0)
+        return out;
+    // (b) ### Acceptance Criteria followed by ordered/unordered list
+    for (let i = storyStartIdx + 1; i < storyEndIdx; i++) {
+        const c = root.children[i];
+        if (c.type !== 'heading' || c.depth !== 3)
+            continue;
+        const headingText = nodeTextRecursive(c).trim();
+        if (!/^Acceptance\s+Criteria\b/i.test(headingText))
+            continue;
+        for (let j = i + 1; j < storyEndIdx; j++) {
+            const n = root.children[j];
+            if (n.type === 'heading' && n.depth <= 3)
+                break;
+            if (n.type !== 'list')
+                continue;
+            const list = n;
+            for (let k = 0; k < list.children.length; k++) {
+                const item = list.children[k];
+                const text = nodeTextRecursive(item).trim();
+                const acId = `ac:${story.id.replace(/^story:/, '')}.${k + 1}`;
+                out.push({
+                    id: acId,
+                    story_id: story.id,
+                    text: text.slice(0, 500),
+                    source_anchor: `docs/user-stories.md#${acId.replace(/[:.]/g, '-')}`,
+                });
+            }
+            break;
+        }
+    }
+    return out;
+}
+export function parseStories(md) {
+    const root = parseMarkdown(md);
+    const h2s = headingsAtDepth(root, 2);
+    const stories = [];
+    const acs = [];
+    for (let h = 0; h < h2s.length; h++) {
+        const head = h2s[h];
+        const parsed = parseStoryHeading(head.textContent);
+        if (!parsed)
+            continue;
+        const tags = extractInlineTags(head.textContent);
+        const priority = priorityFromTags(tags);
+        const kind = ['ui', 'api', 'data', 'infra', 'doc'].find((k) => k === tags.kind);
+        const rawFeature = tags.feature;
+        const featureId = rawFeature
+            ? `feature:${slugify(rawFeature.startsWith('feature:') ? rawFeature.slice('feature:'.length) : rawFeature)}`
+            : undefined;
+        const story = {
+            id: `story:${parsed.storyKey}`,
+            title: parsed.title,
+            priority,
+            kind,
+            feature_id: featureId,
+            source_anchor: `docs/user-stories.md#story-${parsed.storyKey}`,
+        };
+        stories.push(story);
+        const startIdx = head.startIndex;
+        const endIdx = h + 1 < h2s.length ? h2s[h + 1].startIndex : root.children.length;
+        acs.push(...parseAcsFromSection(root, story, startIdx, endIdx));
+    }
+    return { stories, acs };
+}
+//# sourceMappingURL=story-parser.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,66 @@
+import { describe, it, expect } from 'vitest';
+import { parseStories } from './story-parser.js';
+describe('parseStories', () => {
+    it('extracts stories with priority + kind from H2 headings', () => {
+        const md = `# User Stories
+
+## Story user-auth-1: Sign in with email [priority: must] [kind: ui]
+
+As a user, I want to sign in.
+
+### AC 1: Login form accepts valid email/password
+Given a registered user
+When they submit valid credentials
+Then they are signed in.
+
+### AC 2: Login form rejects invalid credentials
+Given a registered user
+When they submit invalid credentials
+Then they see an error.
+
+## Story user-auth-2: Password reset [priority: should]
+
+As a user, I want to reset my password.
+
+### AC 1: Reset link is emailed
+Given a registered user
+When they request reset
+Then they receive a reset email.
+`;
+        const { stories, acs } = parseStories(md);
+        expect(stories).toHaveLength(2);
+        expect(stories[0]).toMatchObject({
+            id: 'story:user-auth-1',
+            title: 'Sign in with email',
+            priority: 'must',
+            kind: 'ui',
+            source_anchor: 'docs/user-stories.md#story-user-auth-1',
+        });
+        expect(stories[1].priority).toBe('should');
+        expect(stories[1].kind).toBeUndefined();
+        expect(acs).toHaveLength(3);
+        expect(acs[0]).toMatchObject({ id: 'ac:user-auth-1.1', story_id: 'story:user-auth-1' });
+        expect(acs[0].text).toContain('Given a registered user');
+        expect(acs[2].story_id).toBe('story:user-auth-2');
+        expect(acs[2].id).toBe('ac:user-auth-2.1');
+    });
+    it('also accepts numbered-list AC format (### Acceptance Criteria)', () => {
+        const md = `## Story s-1: Foo [priority: must]
+
+As a user, I want X.
+
+### Acceptance Criteria
+1. The form validates input.
+2. Errors are localized.
+`;
+        const { acs } = parseStories(md);
+        expect(acs).toHaveLength(2);
+        expect(acs[0]).toMatchObject({ id: 'ac:s-1.1', story_id: 'story:s-1' });
+        expect(acs[0].text).toBe('The form validates input.');
+        expect(acs[1].text).toBe('Errors are localized.');
+    });
+    it('returns empty arrays for an empty document', () => {
+        expect(parseStories('# Heading\n')).toEqual({ stories: [], acs: [] });
+    });
+});
+//# sourceMappingURL=story-parser.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"story-parser.test.js","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/story-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBd,CAAA;QACG,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC,CAAA;QACzC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC/B,EAAE,EAAE,mBAAmB;YACvB,KAAK,EAAE,oBAAoB;YAC3B,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,IAAI;YACV,aAAa,EAAE,wCAAwC;SACxD,CAAC,CAAA;QACF,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAA;QAEvC,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,kBAAkB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAA;QACvF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAA;QACxD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,EAAE,GAAG;;;;;;;CAOd,CAAA;QACG,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC,CAAA;QAChC,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAA;QACvE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACrD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,3 @@
+import type { Test } from '../types.js';
+export declare function discoverTests(cwd: string): Promise<Test[]>;
+//# sourceMappingURL=test-discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-discovery.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/test-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AA8FvC,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAsBhE"}

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

@@ -0,0 +1,122 @@
+import { readFileSync, readdirSync, statSync, existsSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { createHash } from 'node:crypto';
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.scaffold', '.beads', '.mmr', 'coverage']);
+const RULES = [
+    {
+        framework: 'vitest',
+        fileMatcher: (f) => /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(f),
+        extractTests: (c) => {
+            const results = [];
+            const skipDot = /\b(?:it|test)\.skip\s*\(\s*['"`](.+?)['"`]/g;
+            const xSkip = /\b(?:xit|xtest)\s*\(\s*['"`](.+?)['"`]/g;
+            const normal = /\b(?:it|test)\s*\(\s*['"`](.+?)['"`]/g;
+            for (const m of c.matchAll(skipDot))
+                results.push({ name: m[1], is_skipped: true });
+            for (const m of c.matchAll(xSkip))
+                results.push({ name: m[1], is_skipped: true });
+            for (const m of c.matchAll(normal))
+                results.push({ name: m[1], is_skipped: false });
+            return results;
+        },
+    },
+    {
+        framework: 'jest',
+        fileMatcher: (f) => /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(f),
+        extractTests: (c) => {
+            const results = [];
+            const skipDot = /\b(?:it|test)\.skip\s*\(\s*['"`](.+?)['"`]/g;
+            const xSkip = /\b(?:xit|xtest)\s*\(\s*['"`](.+?)['"`]/g;
+            const normal = /\b(?:it|test)\s*\(\s*['"`](.+?)['"`]/g;
+            for (const m of c.matchAll(skipDot))
+                results.push({ name: m[1], is_skipped: true });
+            for (const m of c.matchAll(xSkip))
+                results.push({ name: m[1], is_skipped: true });
+            for (const m of c.matchAll(normal))
+                results.push({ name: m[1], is_skipped: false });
+            return results;
+        },
+    },
+    {
+        framework: 'pytest',
+        fileMatcher: (f) => /^test_.+\.py$/.test(f) || /_test\.py$/.test(f),
+        extractTests: (c) => Array.from(c.matchAll(/^def\s+(test_[\w]+)\s*\(/gm), (m) => ({ name: m[1], is_skipped: false })),
+    },
+    {
+        framework: 'go-test',
+        fileMatcher: (f) => /_test\.go$/.test(f),
+        extractTests: (c) => Array.from(c.matchAll(/^func\s+(Test[\w]+)\s*\(/gm), (m) => ({ name: m[1], is_skipped: false })),
+    },
+    {
+        framework: 'bats',
+        fileMatcher: (f) => /\.bats$/.test(f),
+        extractTests: (c) => Array.from(c.matchAll(/^\s*@test\s+['"](.+?)['"]\s*\{/gm), (m) => ({ name: m[1], is_skipped: false })),
+    },
+];
+function chooseRule(cwd, file) {
+    const candidates = RULES.filter((r) => r.fileMatcher(file));
+    if (candidates.length === 0)
+        return null;
+    if (candidates.length === 1)
+        return candidates[0];
+    try {
+        const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8'));
+        const scripts = JSON.stringify(pkg.scripts ?? {});
+        if (/\bvitest\b/.test(scripts))
+            return candidates.find((r) => r.framework === 'vitest') ?? candidates[0];
+        if (/\bjest\b/.test(scripts))
+            return candidates.find((r) => r.framework === 'jest') ?? candidates[0];
+    }
+    catch { /* ignore */ }
+    return candidates[0];
+}
+function* walk(dir, base) {
+    for (const entry of readdirSync(dir)) {
+        if (SKIP_DIRS.has(entry))
+            continue;
+        const abs = join(dir, entry);
+        let s;
+        try {
+            s = statSync(abs);
+        }
+        catch {
+            continue;
+        }
+        if (s.isDirectory()) {
+            yield* walk(abs, base);
+        }
+        else if (s.isFile()) {
+            yield relative(base, abs).split(sep).join('/');
+        }
+    }
+}
+export async function discoverTests(cwd) {
+    const out = [];
+    if (!existsSync(cwd))
+        return out;
+    for (const rel of walk(cwd, cwd)) {
+        const filename = rel.split('/').pop() ?? '';
+        const rule = chooseRule(cwd, filename);
+        if (!rule)
+            continue;
+        let content;
+        try {
+            content = readFileSync(join(cwd, rel), 'utf8');
+        }
+        catch {
+            continue;
+        }
+        for (const { name, is_skipped } of rule.extractTests(content)) {
+            const idHash = createHash('sha256').update(`${rel}::${name}`).digest('hex').slice(0, 12);
+            out.push({
+                id: `test:${rel}::${idHash}`,
+                name,
+                file_path: rel,
+                framework: rule.framework,
+                last_status: (is_skipped ? 'skip' : 'unknown'),
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=test-discovery.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,39 @@
+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 { discoverTests } from './test-discovery.js';
+describe('discoverTests', () => {
+    let dir;
+    beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-td-')); });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('finds *.test.ts and *.spec.ts files and infers vitest framework', async () => {
+        mkdirSync(join(dir, 'src/auth'), { recursive: true });
+        writeFileSync(join(dir, 'package.json'), JSON.stringify({ scripts: { test: 'vitest run' } }));
+        writeFileSync(join(dir, 'src/auth/login.test.ts'), 'import { it, expect } from \'vitest\'\nit(\'signs in\', () => { expect(1).toBe(1) })\n');
+        writeFileSync(join(dir, 'src/auth/signup.spec.ts'), 'it(\'signs up\', () => {})\n');
+        const tests = await discoverTests(dir);
+        const sorted = tests.sort((a, b) => a.id.localeCompare(b.id));
+        expect(sorted).toHaveLength(2);
+        expect(sorted[0]).toMatchObject({
+            framework: 'vitest',
+            file_path: 'src/auth/login.test.ts',
+        });
+        expect(sorted[0].id).toMatch(/^test:src\/auth\/login\.test\.ts::/);
+        expect(sorted[0].name).toBe('signs in');
+    });
+    it('finds *_test.go files and infers go-test framework', async () => {
+        writeFileSync(join(dir, 'package.json'), '{}');
+        mkdirSync(join(dir, 'pkg/auth'), { recursive: true });
+        writeFileSync(join(dir, 'pkg/auth/login_test.go'), 'package auth\nimport "testing"\nfunc TestSignsIn(t *testing.T) {}\n');
+        const tests = await discoverTests(dir);
+        expect(tests).toHaveLength(1);
+        expect(tests[0].framework).toBe('go-test');
+        expect(tests[0].name).toBe('TestSignsIn');
+    });
+    it('returns empty array when no tests are found', async () => {
+        writeFileSync(join(dir, 'package.json'), '{}');
+        expect(await discoverTests(dir)).toEqual([]);
+    });
+});
+//# sourceMappingURL=test-discovery.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,67 @@
+import { parseMarkdown, headingsAtDepth, slugify } from './parse-markdown.js';
+const VALID_PRIORITY = ['must', 'should', 'could', 'wont'];
+const CATEGORY_MAP = {
+    colors: 'color', color: 'color',
+    spacing: 'spacing', space: 'spacing',
+    typography: 'typography', type: 'typography', text: 'typography',
+    shadows: 'shadow', shadow: 'shadow',
+    radius: 'radius', radii: 'radius',
+    motion: 'motion', animation: 'motion',
+};
+function nodeText(n) {
+    if (n.type === 'text' || n.type === 'inlineCode')
+        return n.value ?? '';
+    if (Array.isArray(n.children))
+        return n.children.map(nodeText).join('');
+    return '';
+}
+export function parseDesignTokens(md, sourcePath = 'docs/design-system.md') {
+    const root = parseMarkdown(md);
+    const h2s = headingsAtDepth(root, 2);
+    const out = [];
+    for (let h = 0; h < h2s.length; h++) {
+        const head = h2s[h];
+        const headText = head.textContent.replace(/\[[^\]]*\]/g, '').trim().toLowerCase();
+        const category = CATEGORY_MAP[headText];
+        if (!category)
+            continue;
+        const slugAnchor = slugify(head.textContent) || headText;
+        const start = head.startIndex + 1;
+        const end = h + 1 < h2s.length ? h2s[h + 1].startIndex : root.children.length;
+        for (let i = start; i < end; i++) {
+            const n = root.children[i];
+            if (n.type !== 'table')
+                continue;
+            const table = n;
+            const rows = table.children;
+            if (rows.length < 2)
+                continue;
+            const headerCells = rows[0].children.map((cell) => nodeText(cell).trim().toLowerCase());
+            const tokenIdx = headerCells.findIndex((c) => /token|name/.test(c));
+            const valueIdx = headerCells.findIndex((c) => /value/.test(c));
+            const priorityIdx = headerCells.findIndex((c) => /priority/.test(c));
+            if (tokenIdx < 0 || valueIdx < 0)
+                continue;
+            for (let r = 1; r < rows.length; r++) {
+                const cells = rows[r].children.map((cell) => nodeText(cell).trim());
+                const tokenText = cells[tokenIdx];
+                const valueText = cells[valueIdx];
+                const priorityText = priorityIdx >= 0 ? cells[priorityIdx].toLowerCase() : '';
+                if (!tokenText || !valueText)
+                    continue;
+                const priority = VALID_PRIORITY.includes(priorityText)
+                    ? priorityText
+                    : 'should';
+                out.push({
+                    id: `token:${tokenText}`,
+                    category,
+                    value: valueText,
+                    priority,
+                    source_anchor: `${sourcePath}#${slugAnchor}`,
+                });
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=token-parser.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,39 @@
+import { describe, it, expect } from 'vitest';
+import { parseDesignTokens } from './token-parser.js';
+describe('parseDesignTokens', () => {
+    it('extracts tokens from category tables', () => {
+        const md = `# Design System
+
+## Colors
+
+| Token | Value | Priority |
+|---|---|---|
+| --color-primary | #4f46e5 | must |
+| --color-danger | #ef4444 | must |
+| --color-muted | #94a3b8 | should |
+
+## Spacing
+
+| Token | Value | Priority |
+|---|---|---|
+| --sp-1 | 4px | should |
+| --sp-2 | 8px | should |
+`;
+        const tokens = parseDesignTokens(md);
+        expect(tokens).toHaveLength(5);
+        expect(tokens[0]).toMatchObject({
+            id: 'token:--color-primary',
+            category: 'color',
+            value: '#4f46e5',
+            priority: 'must',
+            source_anchor: 'docs/design-system.md#colors',
+        });
+        expect(tokens[3].category).toBe('spacing');
+    });
+    it('defaults priority to "should" when column is missing', () => {
+        const md = '## Colors\n\n| Token | Value |\n|---|---|\n| --color-x | #fff |\n';
+        const tokens = parseDesignTokens(md);
+        expect(tokens[0].priority).toBe('should');
+    });
+});
+//# sourceMappingURL=token-parser.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token-parser.test.js","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/token-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;CAgBd,CAAA;QACG,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC9B,EAAE,EAAE,uBAAuB;YAC3B,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,MAAM;YAChB,aAAa,EAAE,8BAA8B;SAC9C,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,GAAG,mEAAmE,CAAA;QAC9E,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/doc-graph/token-use-detector.d.ts

@@ -0,0 +1,10 @@
+import type { DesignToken } from '../types.js';
+export interface TokenUse {
+    file: string;
+    property: string;
+    value: string;
+    token_id: string;
+}
+export declare function detectCssTokenUses(source: string, tokens: DesignToken[], filePath: string): TokenUse[];
+export declare function detectJsxTokenUses(source: string, tokens: DesignToken[], filePath: string): TokenUse[];
+//# sourceMappingURL=token-use-detector.d.ts.map

package/dist/observability/engine/doc-graph/token-use-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-use-detector.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/doc-graph/token-use-detector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAW9C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAmBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAsBtG;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CA2CtG"}