@aperant/framework 0.6.2 → 0.6.3

package/dist/__tests__/dispatch-wrap.test.js

@@ -1,133 +0,0 @@
-/**
- * dispatch-wrap.test.ts — D-02 (c) wrap() adapter tests (subtask 5,
- * post-S20 shape).
- *
- * Verifies the two happy-path return shapes (JSON envelope, RAW-TEXT) and
- * the ≥7 fail-fast cases for non-conforming shapes — including `undefined`,
- * which used to be the legacy-tolerance branch and is now a hard error
- * (Codex pass 2 revision A + subtask 20).
- *
- * The RAW-TEXT shape was added in subtask 15 (originally planned for
- * subtask 20) so cmds emitting non-JSON content (template, effects list,
- * consistency check --format human, statusline plain, precompact-hook,
- * init TTY mode) can carry an exit code without calling process.exit()
- * inside the cmd body.
- *
- * Strategy: wrap() calls process.exit + process.stdout.write. We use the
- * runCmd harness from D-05 to trap those calls and assert on stdout / the
- * captured exit code.
- */
-import { describe, expect, it } from 'vitest';
-import { runCmd } from '../__test-helpers/run-cmd.mjs';
-import { wrap } from '../cli/dispatch.mjs';
-describe('wrap() — D-02 (c)', () => {
-    describe('happy paths', () => {
-        it('NEW shape — sync cmd returning { envelope, exitCode: 0 } emits envelope on stdout, exits 0 (no exit call)', async () => {
-            const cmd = () => ({
-                envelope: { status: 'ok', command: 'test-sync', value: 1 },
-                exitCode: 0,
-            });
-            const handler = wrap(cmd);
-            const r = await runCmd(handler);
-            expect(r.exitCode).toBe(0);
-            expect(r.stdout).toContain('"command": "test-sync"');
-            expect(r.stdout).toContain('"value": 1');
-        });
-        it('NEW shape — async cmd returning { envelope, exitCode: 2 } emits + exits 2', async () => {
-            const cmd = async () => {
-                await Promise.resolve();
-                return {
-                    envelope: { status: 'busy', command: 'pr-review-acquire-lock' },
-                    exitCode: 2,
-                };
-            };
-            const handler = wrap(cmd);
-            const r = await runCmd(handler, [], { strictExit: false });
-            expect(r.exitCode).toBe(2);
-            expect(r.stdout).toContain('"status": "busy"');
-        });
-        it('RAW-TEXT shape — { rawText, exitCode: 0 } emits text on stdout, exits 0', async () => {
-            const cmd = () => ({ rawText: 'plain raw output line\n', exitCode: 0 });
-            const handler = wrap(cmd);
-            const r = await runCmd(handler);
-            expect(r.exitCode).toBe(0);
-            // Raw text is written verbatim — no JSON envelope wrapping.
-            expect(r.stdout).toBe('plain raw output line\n');
-        });
-        it('RAW-TEXT shape — { rawText, exitCode: 1 } emits text + exits 1', async () => {
-            const cmd = () => ({ rawText: 'human-format failure report\n', exitCode: 1 });
-            const handler = wrap(cmd);
-            const r = await runCmd(handler, [], { strictExit: false });
-            expect(r.exitCode).toBe(1);
-            expect(r.stdout).toBe('human-format failure report\n');
-        });
-    });
-    describe('fail-fast on non-conforming shapes (Codex pass 2 revision A)', () => {
-        const NON_CONFORMING_SHAPES = [
-            { label: 'bare envelope without exitCode', value: { status: 'ok' } },
-            { label: 'string', value: 'string' },
-            { label: 'number', value: 42 },
-            { label: 'null', value: null },
-            {
-                label: 'envelope with non-numeric exitCode',
-                value: { envelope: { status: 'ok' }, exitCode: 'two' },
-            },
-            { label: 'envelope with missing exitCode', value: { envelope: { status: 'ok' } } },
-            // Subtask 20: undefined is no longer accepted silently. After
-            // end-of-Wave-3 every cmd returns one of the recognised shapes;
-            // an undefined return is indistinguishable from a partial-migration
-            // regression and trips fail() with the same non-conforming-shape
-            // message as any other invalid return value.
-            { label: 'undefined (legacy-tolerance removed)', value: undefined },
-        ];
-        for (const { label, value } of NON_CONFORMING_SHAPES) {
-            it(`trips fail() on: ${label}`, async () => {
-                const cmd = () => value;
-                const handler = wrap(cmd);
-                const r = await runCmd(handler, [], { strictExit: false });
-                expect(r.exitCode).toBe(1);
-                expect(r.stdout).toContain('non-conforming shape');
-                expect(r.stdout).toContain('expected { envelope, exitCode } or { rawText, exitCode }');
-            });
-        }
-        it('async cmd returning a non-conforming Promise.resolve("not-a-tuple") trips fail()', async () => {
-            const cmd = async () => 'not-a-tuple';
-            const handler = wrap(cmd);
-            const r = await runCmd(handler, [], { strictExit: false });
-            expect(r.exitCode).toBe(1);
-            expect(r.stdout).toContain('non-conforming shape');
-        });
-        it('preview is truncated at 200 chars to keep error scannable', async () => {
-            const huge = { envelope: 'x'.repeat(500) /* no exitCode */ };
-            const cmd = () => huge;
-            const handler = wrap(cmd);
-            const r = await runCmd(handler, [], { strictExit: false });
-            expect(r.exitCode).toBe(1);
-            expect(r.stdout).toContain('…'); // truncation marker
-            // And the full 500-char x-string must NOT appear verbatim.
-            expect(r.stdout).not.toContain('x'.repeat(500));
-        });
-    });
-    describe('thrown errors → fail()', () => {
-        it('cmd that throws an Error becomes fail(err.message) — exit 1 + structured envelope', async () => {
-            const cmd = () => {
-                throw new Error('boom — domain error');
-            };
-            const handler = wrap(cmd);
-            const r = await runCmd(handler, [], { strictExit: false });
-            expect(r.exitCode).toBe(1);
-            expect(r.stdout).toContain('"error"');
-            expect(r.stdout).toContain('boom — domain error');
-        });
-        it('async cmd that rejects becomes fail(err.message)', async () => {
-            const cmd = async () => {
-                throw new Error('async boom');
-            };
-            const handler = wrap(cmd);
-            const r = await runCmd(handler, [], { strictExit: false });
-            expect(r.exitCode).toBe(1);
-            expect(r.stdout).toContain('async boom');
-        });
-    });
-});
-//# sourceMappingURL=dispatch-wrap.test.js.map

package/dist/__tests__/dispatch-wrap.test.js.map

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

package/dist/__tests__/docs-audit-drift-detection.test.d.ts

@@ -1,10 +0,0 @@
-/**
- * docs-audit-drift-detection.test.ts — coverage for the grep engine +
- * audit orchestrator (C33).
- *
- * AC6: flag-drift finding on stale CLAUDE.md claim
- * AC7: auto-update patch plan entry for registry
- * AC22: docs-audit on clean tree returns {status: ok, findings: []}
- */
-export {};
-//# sourceMappingURL=docs-audit-drift-detection.test.d.ts.map

package/dist/__tests__/docs-audit-drift-detection.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-audit-drift-detection.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/docs-audit-drift-detection.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/docs-audit-drift-detection.test.js

@@ -1,185 +0,0 @@
-/**
- * docs-audit-drift-detection.test.ts — coverage for the grep engine +
- * audit orchestrator (C33).
- *
- * AC6: flag-drift finding on stale CLAUDE.md claim
- * AC7: auto-update patch plan entry for registry
- * AC22: docs-audit on clean tree returns {status: ok, findings: []}
- */
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-import { auditDocsDrift } from '../cli/docs-audit/audit.mjs';
-import { findStaleClaimsInMarkdown } from '../cli/docs-audit/grep-claims.mjs';
-// Helper that casts the .mjs return into our known shape for typechecking.
-function callGrep(path, facts) {
-    return findStaleClaimsInMarkdown(path, facts);
-}
-function writeMd(dir, name, content) {
-    mkdirSync(dir, { recursive: true });
-    const path = join(dir, name);
-    writeFileSync(path, content);
-    return path;
-}
-describe('findStaleClaimsInMarkdown — basic cases', () => {
-    let tmpDir;
-    beforeEach(() => {
-        tmpDir = mkdtempSync(join(tmpdir(), 'apt-drift-'));
-    });
-    afterEach(() => rmSync(tmpDir, { recursive: true, force: true }));
-    it('high-confidence: plain prose referencing a deleted path → 1 finding (AC6)', () => {
-        const path = writeMd(tmpDir, 'doc.md', 'See `packages/foo` for details.\n');
-        const hits = callGrep(path, {
-            deletedPaths: ['packages/foo'],
-            renamedPaths: [],
-            addedExports: [],
-            removedExports: [],
-        });
-        expect(hits).toHaveLength(1);
-        expect(hits[0].confidence).toBe('high');
-        expect(hits[0].line).toBe(1);
-        expect(hits[0].stale_claim).toBe('packages/foo');
-        expect(hits[0].kind).toBe('deleted-path');
-    });
-    it('fenced code block → 0 findings (R3 mitigation)', () => {
-        const path = writeMd(tmpDir, 'doc.md', ['Some prose.', '', '```', 'packages/foo lives here', '```', ''].join('\n'));
-        const hits = callGrep(path, {
-            deletedPaths: ['packages/foo'],
-            renamedPaths: [],
-            addedExports: [],
-            removedExports: [],
-        });
-        expect(hits).toHaveLength(0);
-    });
-    it('HTML comment → 0 findings', () => {
-        const path = writeMd(tmpDir, 'doc.md', '<!-- packages/foo exists here -->\n');
-        const hits = callGrep(path, {
-            deletedPaths: ['packages/foo'],
-            renamedPaths: [],
-            addedExports: [],
-            removedExports: [],
-        });
-        expect(hits).toHaveLength(0);
-    });
-    it('medium-confidence: parent dir mention when leaf was deleted', () => {
-        const path = writeMd(tmpDir, 'doc.md', 'Things live under `packages/foo/` here.\n');
-        const hits = callGrep(path, {
-            deletedPaths: ['packages/foo/bar.ts'],
-            renamedPaths: [],
-            addedExports: [],
-            removedExports: [],
-        });
-        expect(hits.length).toBeGreaterThanOrEqual(1);
-        const med = hits.find((h) => h.confidence === 'medium');
-        expect(med).toBeDefined();
-        expect(med?.stale_claim).toBe('packages/foo');
-        expect(med?.kind).toBe('deleted-parent');
-    });
-    it('rename case — finding points at stale reference, carries suggested_rewrite', () => {
-        const path = writeMd(tmpDir, 'doc.md', 'The module at `packages/old` handles it.\n');
-        const hits = callGrep(path, {
-            deletedPaths: [],
-            renamedPaths: [{ from: 'packages/old', to: 'packages/new' }],
-            addedExports: [],
-            removedExports: [],
-        });
-        expect(hits).toHaveLength(1);
-        expect(hits[0].kind).toBe('renamed-path');
-        expect(hits[0].suggested_rewrite).toBe('packages/new');
-    });
-    it('no match → empty array', () => {
-        const path = writeMd(tmpDir, 'doc.md', 'Nothing to see here.\n');
-        const hits = callGrep(path, {
-            deletedPaths: ['packages/does-not-appear'],
-            renamedPaths: [],
-            addedExports: [],
-            removedExports: [],
-        });
-        expect(hits).toEqual([]);
-    });
-    it('word-boundary enforcement: `packages/foo` does not match `packages/foobar`', () => {
-        const path = writeMd(tmpDir, 'doc.md', 'The module `packages/foobar` is fine.\n');
-        const hits = callGrep(path, {
-            deletedPaths: ['packages/foo'],
-            renamedPaths: [],
-            addedExports: [],
-            removedExports: [],
-        });
-        expect(hits).toEqual([]);
-    });
-});
-describe('auditDocsDrift — orchestrator bucketing', () => {
-    let tmpDir;
-    beforeEach(() => {
-        tmpDir = mkdtempSync(join(tmpdir(), 'apt-audit-'));
-    });
-    afterEach(() => rmSync(tmpDir, { recursive: true, force: true }));
-    it('policy bucketing: flag-drift → findings, auto-update → patch_plan, skip → dropped (AC7)', async () => {
-        // 3 surfaces, 3 policies.
-        writeFileSync(join(tmpDir, 'CLAUDE.md'), 'Touches `packages/ghost/file.ts` directly.\n');
-        mkdirSync(join(tmpDir, '.aperant', 'features'), { recursive: true });
-        writeFileSync(join(tmpDir, '.aperant', 'features', 'REGISTRY.md'), '| ghost | `packages/ghost/file.ts` | 1 | 1 |\n');
-        writeFileSync(join(tmpDir, 'random.md'), 'Contains `packages/ghost/file.ts`.\n');
-        const policy = {
-            'CLAUDE.md': 'flag-drift',
-            '.aperant/features/REGISTRY.md': 'auto-update',
-            'random.md': 'skip',
-        };
-        const result = (await auditDocsDrift({
-            projectDir: tmpDir,
-            policy,
-            diffFacts: {
-                deletedPaths: ['packages/ghost/file.ts'],
-                renamedPaths: [],
-                addedExports: [],
-                removedExports: [],
-            },
-            surfaces: ['CLAUDE.md', '.aperant/features/REGISTRY.md', 'random.md'],
-        }));
-        // flag-drift → findings, with category docs-drift
-        expect(result.findings.length).toBeGreaterThanOrEqual(1);
-        expect(result.findings[0].category).toBe('docs-drift');
-        expect(result.findings[0].policy).toBe('flag-drift');
-        expect(result.findings[0].severity).toBe('warning');
-        expect(result.findings[0].file).toBe('CLAUDE.md');
-        // auto-update → patch_plan
-        expect(result.patch_plan.length).toBeGreaterThanOrEqual(1);
-        expect(result.patch_plan[0].policy).toBe('auto-update');
-        expect(result.patch_plan[0].file).toBe('.aperant/features/REGISTRY.md');
-        // skip → dropped (recorded but no findings)
-        const randomDropped = result.dropped.find((d) => d.file === 'random.md');
-        expect(randomDropped).toBeDefined();
-        expect(randomDropped?.policy).toBe('skip');
-    });
-    it('AC22: empty diff on clean tree returns empty findings + patch_plan', async () => {
-        writeFileSync(join(tmpDir, 'CLAUDE.md'), 'Everything is fine.\n');
-        const result = (await auditDocsDrift({
-            projectDir: tmpDir,
-            policy: { 'CLAUDE.md': 'flag-drift' },
-            diffFacts: { deletedPaths: [], renamedPaths: [], addedExports: [], removedExports: [] },
-            surfaces: ['CLAUDE.md'],
-        }));
-        expect(result.findings).toEqual([]);
-        expect(result.patch_plan).toEqual([]);
-    });
-    it('unmatched policy surface → dropped (no findings emitted)', async () => {
-        writeFileSync(join(tmpDir, 'unknown.md'), 'Mentions packages/ghost.\n');
-        const result = (await auditDocsDrift({
-            projectDir: tmpDir,
-            policy: {}, // empty policy — nothing matches
-            diffFacts: {
-                deletedPaths: ['packages/ghost'],
-                renamedPaths: [],
-                addedExports: [],
-                removedExports: [],
-            },
-            surfaces: ['unknown.md'],
-        }));
-        expect(result.findings).toEqual([]);
-        expect(result.patch_plan).toEqual([]);
-        expect(result.dropped).toHaveLength(1);
-        expect(result.dropped[0].file).toBe('unknown.md');
-    });
-});
-//# sourceMappingURL=docs-audit-drift-detection.test.js.map

package/dist/__tests__/docs-audit-drift-detection.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-audit-drift-detection.test.js","sourceRoot":"","sources":["../../src/__tests__/docs-audit-drift-detection.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/docs-audit-policy.test.d.ts

@@ -1,9 +0,0 @@
-/**
- * docs-audit-policy.test.ts — unit + drift-prevention coverage for the
- * docs-coherence policy module (C33).
- *
- * Covers AC11 (config without docs_policy loads cleanly + defaults apply) and
- * AC15 (the JSON template mirrors DEFAULT_DOCS_POLICY byte-for-byte).
- */
-export {};
-//# sourceMappingURL=docs-audit-policy.test.d.ts.map

package/dist/__tests__/docs-audit-policy.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-audit-policy.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/docs-audit-policy.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/docs-audit-policy.test.js

@@ -1,121 +0,0 @@
-/**
- * docs-audit-policy.test.ts — unit + drift-prevention coverage for the
- * docs-coherence policy module (C33).
- *
- * Covers AC11 (config without docs_policy loads cleanly + defaults apply) and
- * AC15 (the JSON template mirrors DEFAULT_DOCS_POLICY byte-for-byte).
- */
-import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join, resolve } from 'node:path';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-import { DEFAULT_DOCS_POLICY, loadDocsPolicy, matchSurfaceToPolicy, } from '../cli/docs-audit/policy.mjs';
-describe('matchSurfaceToPolicy — default bucketing', () => {
-    // Table-driven coverage of every hardcoded default (8+ entries).
-    const cases = [
-        // flag-drift bucket (external prose)
-        ['CLAUDE.md', 'flag-drift'],
-        ['AGENTS.md', 'flag-drift'],
-        ['README.md', 'flag-drift'],
-        ['packages/ui/README.md', 'flag-drift'],
-        ['docs/foo/bar.md', 'flag-drift'],
-        ['docs/guide/deep/nested/doc.md', 'flag-drift'],
-        // auto-update bucket (internal state)
-        ['.aperant/roadmap/framework/milestones.json', 'auto-update'],
-        ['.aperant/features/REGISTRY.md', 'auto-update'],
-        ['.aperant/features/pipeline.json', 'auto-update'],
-        ['.aperant/features/some-new-area.json', 'auto-update'],
-        ['.aperant/project_index.json', 'auto-update'],
-        ['.aperant/tasks/some-id/spec.md', 'auto-update'],
-        ['.aperant/tasks/foo/bar.json', 'auto-update'],
-        // unknown path → null (no coerced default)
-        ['random/unrelated/file.txt', null],
-        ['some-leaf.ts', null],
-    ];
-    for (const [path, expected] of cases) {
-        it(`matches "${path}" → ${expected}`, () => {
-            expect(matchSurfaceToPolicy(path, DEFAULT_DOCS_POLICY)).toBe(expected);
-        });
-    }
-});
-describe('matchSurfaceToPolicy — specificity ordering', () => {
-    it('literal surface wins over a matching glob', () => {
-        const policy = {
-            '.aperant/features/*.json': 'flag-drift',
-            '.aperant/features/REGISTRY.md': 'auto-update',
-        };
-        // REGISTRY.md is literal (doesn't match the glob) — sanity check: no cross-match.
-        expect(matchSurfaceToPolicy('.aperant/features/REGISTRY.md', policy)).toBe('auto-update');
-    });
-    it('literal beats glob when both match the same path', () => {
-        const policy = {
-            '**': 'flag-drift',
-            'CLAUDE.md': 'skip',
-        };
-        expect(matchSurfaceToPolicy('CLAUDE.md', policy)).toBe('skip');
-    });
-    it('longer glob wins over shorter glob when both match', () => {
-        const policy = {
-            '**': 'flag-drift',
-            'docs/**': 'auto-update',
-        };
-        expect(matchSurfaceToPolicy('docs/readme.md', policy)).toBe('auto-update');
-    });
-});
-describe('loadDocsPolicy — config overrides', () => {
-    let tmpDir;
-    beforeEach(() => {
-        tmpDir = mkdtempSync(join(tmpdir(), 'apt-docs-policy-'));
-    });
-    afterEach(() => {
-        rmSync(tmpDir, { recursive: true, force: true });
-    });
-    it('returns defaults when config.json is missing', () => {
-        const p = loadDocsPolicy(tmpDir);
-        expect(p['CLAUDE.md']).toBe('flag-drift');
-        expect(p['.aperant/features/REGISTRY.md']).toBe('auto-update');
-    });
-    it('returns defaults when config.json has no docs_policy block', () => {
-        mkdirSync(join(tmpDir, '.aperant'), { recursive: true });
-        writeFileSync(join(tmpDir, '.aperant', 'config.json'), JSON.stringify({ version: 4, project_type: 'unknown' }, null, 2));
-        const p = loadDocsPolicy(tmpDir);
-        expect(p['CLAUDE.md']).toBe('flag-drift');
-    });
-    it('overrides a single surface without disturbing others', () => {
-        mkdirSync(join(tmpDir, '.aperant'), { recursive: true });
-        writeFileSync(join(tmpDir, '.aperant', 'config.json'), JSON.stringify({ version: 4, docs_policy: { 'CLAUDE.md': 'skip' } }, null, 2));
-        const p = loadDocsPolicy(tmpDir);
-        expect(p['CLAUDE.md']).toBe('skip');
-        // Other defaults still present
-        expect(p['AGENTS.md']).toBe('flag-drift');
-        expect(p['.aperant/features/REGISTRY.md']).toBe('auto-update');
-        // matchSurfaceToPolicy reflects the override
-        expect(matchSurfaceToPolicy('CLAUDE.md', p)).toBe('skip');
-    });
-    it('ignores malformed override blocks gracefully', () => {
-        mkdirSync(join(tmpDir, '.aperant'), { recursive: true });
-        writeFileSync(join(tmpDir, '.aperant', 'config.json'), JSON.stringify({ docs_policy: 'not-an-object' }, null, 2));
-        const p = loadDocsPolicy(tmpDir);
-        expect(p['CLAUDE.md']).toBe('flag-drift');
-    });
-    it('ignores unknown policy values (not one of auto-update/flag-drift/skip)', () => {
-        mkdirSync(join(tmpDir, '.aperant'), { recursive: true });
-        writeFileSync(join(tmpDir, '.aperant', 'config.json'), JSON.stringify({ docs_policy: { 'CLAUDE.md': 'banana' } }, null, 2));
-        const p = loadDocsPolicy(tmpDir);
-        expect(p['CLAUDE.md']).toBe('flag-drift'); // untouched
-    });
-});
-describe('drift-prevention: template JSON ↔ DEFAULT_DOCS_POLICY', () => {
-    it('templates/docs-policy-defaults.json deep-equals DEFAULT_DOCS_POLICY (AC15)', () => {
-        // Resolve the template relative to this test file so the test works in
-        // the worktree and the main repo without depending on cwd.
-        // src/__tests__ → src/ → packages/framework/ → templates/
-        const templatePath = resolve(__dirname, '..', '..', 'templates', 'docs-policy-defaults.json');
-        const raw = JSON.parse(readFileSync(templatePath, 'utf-8'));
-        // Drop the $comment descriptor — it's documentation, not a surface.
-        const { $comment, ...surfaces } = raw;
-        expect(typeof $comment).toBe('string');
-        expect(surfaces).toEqual(DEFAULT_DOCS_POLICY);
-    });
-});
-//# sourceMappingURL=docs-audit-policy.test.js.map

package/dist/__tests__/docs-audit-policy.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-audit-policy.test.js","sourceRoot":"","sources":["../../src/__tests__/docs-audit-policy.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/docs-features-reader.test.d.ts

@@ -1,10 +0,0 @@
-/**
- * docs-features-reader.test.ts — C49 deliverable 10a.
- *
- * Pins the deterministic features-registry reader: per-area JSON parses,
- * wiring-status normalization (true → wired, 'stubbed'|'partial' → stubbed,
- * everything else → unwired), partial-load tolerance for malformed files,
- * and the three sentinel states (missing / empty / ok).
- */
-export {};
-//# sourceMappingURL=docs-features-reader.test.d.ts.map

package/dist/__tests__/docs-features-reader.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-features-reader.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/docs-features-reader.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}