@opensip-cli/yagni 0.1.11

package/dist/__tests__/yagni-golden.test.js

@@ -0,0 +1,135 @@
+/**
+ * JSON golden snapshots for the YAGNI tool envelope + session payload.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it, vi } from 'vitest';
+import { executeYagni } from '../cli/execute-yagni.js';
+import { duplicateBodyCandidateDetector } from '../detectors/duplicate-body-candidate.js';
+import { unusedConfigSurfaceDetector } from '../detectors/unused-config-surface.js';
+const HERE = dirname(fileURLToPath(import.meta.url));
+const FIXTURE_ROOT = join(HERE, 'fixtures', 'unused-config-surface', 'pkg');
+const GOLDEN_PATH = join(HERE, '__fixtures__', 'yagni-golden.json');
+function normalizeFixturePath(value) {
+    if (!value.startsWith(FIXTURE_ROOT))
+        return value;
+    return `<fixture>/${relative(FIXTURE_ROOT, value).split('\\').join('/')}`;
+}
+function stubCli() {
+    return {
+        scope: { datastore: () => undefined },
+        emitEnvelope: vi.fn(),
+        emitJson: vi.fn(),
+        emitError: vi.fn(),
+        render: vi.fn(() => Promise.resolve()),
+        renderLive: vi.fn(() => Promise.resolve()),
+        registerLiveView: vi.fn(),
+        setExitCode: vi.fn(),
+        deliverSignals: vi.fn(() => Promise.resolve({ delivered: false })),
+        writeSarif: vi.fn(() => Promise.resolve()),
+        maybeOpenReport: vi.fn(() => Promise.resolve()),
+    };
+}
+function stableJson(value) {
+    return JSON.parse(JSON.stringify(value, (key, v) => {
+        if (key === 'durationMs' && typeof v === 'number')
+            return 0;
+        if (key === 'fingerprint' && typeof v === 'string')
+            return '<fingerprint>';
+        if (key === 'id' && typeof v === 'string' && v.startsWith('sig_'))
+            return '<signalId>';
+        if (typeof v === 'string' && /^[0-9a-f-]{36}$/i.test(v))
+            return '<runId>';
+        if (typeof v === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(v))
+            return '<createdAt>';
+        if (typeof v === 'string')
+            return normalizeFixturePath(v);
+        return v;
+    }));
+}
+describe('yagni golden snapshots', () => {
+    it('unused-config-surface fixture emits a stable finding shape', async () => {
+        const result = await unusedConfigSurfaceDetector.run({
+            cwd: FIXTURE_ROOT,
+            config: { defaultMinConfidence: 'low' },
+            graphCatalog: null,
+            includeTests: true,
+        });
+        expect(result.signals).toHaveLength(1);
+        expect(result.signals[0]?.ruleId).toBe('yagni:unused-config-surface');
+        expect(result.signals[0]?.metadata.yagni).toMatchObject({
+            detector: 'unused-config-surface',
+            reductionCategory: 'config',
+            confidence: 'high',
+            evidence: expect.arrayContaining([
+                expect.objectContaining({
+                    kind: 'unused-config-property',
+                    data: expect.objectContaining({ property: 'orphanKnob' }),
+                }),
+            ]),
+        });
+    });
+    it('executeYagni with --graph off matches the checked-in golden envelope', async () => {
+        const outcome = await executeYagni({
+            cwd: FIXTURE_ROOT,
+            config: {
+                failOnErrors: 0,
+                failOnWarnings: 0,
+                graphMode: 'off',
+                defaultMinConfidence: 'low',
+            },
+            graphMode: 'off',
+            includeTests: true,
+        }, stubCli(), [unusedConfigSurfaceDetector, duplicateBodyCandidateDetector]);
+        expect(outcome.session.passed).toBe(true);
+        expect(outcome.envelope.verdict.passed).toBe(true);
+        expect(outcome.envelope.units.map((u) => u.slug)).toEqual(['yagni:unused-config-surface']);
+        expect(outcome.session.payload.summary.skippedDetectors).toEqual([
+            {
+                id: 'duplicate-body-candidate',
+                slug: 'yagni:duplicate-body-candidate',
+                reason: 'graph-required',
+                detail: 'graph evidence unavailable',
+            },
+        ]);
+        const actual = stableJson({
+            verdict: outcome.envelope.verdict,
+            units: outcome.envelope.units,
+            signals: outcome.envelope.signals.map((s) => ({
+                ruleId: s.ruleId,
+                message: s.message,
+                severity: s.severity,
+                filePath: s.filePath,
+                line: s.line,
+                metadata: s.metadata,
+            })),
+            sessionSummary: {
+                ...outcome.session.payload.summary,
+                yagni: outcome.session.payload.summary.yagni,
+            },
+        });
+        const expected = JSON.parse(readFileSync(GOLDEN_PATH, 'utf8'));
+        expect(actual).toEqual(expected);
+    });
+    it('executeYagni is deterministic for a fixed graph mode on the fixture', async () => {
+        const opts = {
+            cwd: FIXTURE_ROOT,
+            config: { graphMode: 'off', defaultMinConfidence: 'low' },
+            graphMode: 'off',
+            includeTests: true,
+        };
+        const firstRun = await executeYagni(opts, stubCli(), [
+            unusedConfigSurfaceDetector,
+            duplicateBodyCandidateDetector,
+        ]);
+        const secondRun = await executeYagni(opts, stubCli(), [
+            unusedConfigSurfaceDetector,
+            duplicateBodyCandidateDetector,
+        ]);
+        const first = stableJson(firstRun.envelope.signals);
+        const second = stableJson(secondRun.envelope.signals);
+        expect(first).toEqual(second);
+    });
+});
+//# sourceMappingURL=yagni-golden.test.js.map

package/dist/__tests__/yagni-golden.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-golden.test.js","sourceRoot":"","sources":["../../src/__tests__/yagni-golden.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAIpF,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,uBAAuB,EAAE,KAAK,CAAC,CAAC;AAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,mBAAmB,CAAC,CAAC;AAEpE,SAAS,oBAAoB,CAAC,KAAa;IACzC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,aAAa,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,OAAO;IACd,OAAO;QACL,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE;QACrC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;QACrB,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;QACjB,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;QAClB,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACtC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1C,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;QACzB,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;QACpB,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1C,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;KACnB,CAAC;AACjC,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,IAAI,CAAC,KAAK,CACf,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC/B,IAAI,GAAG,KAAK,YAAY,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,GAAG,KAAK,aAAa,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,eAAe,CAAC;QAC3E,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,YAAY,CAAC;QACvF,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1E,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,aAAa,CAAC;QACjF,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,GAAG,CAAC;YACnD,GAAG,EAAE,YAAY;YACjB,MAAM,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;YACvC,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QACtE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC;YACtD,QAAQ,EAAE,uBAAuB;YACjC,iBAAiB,EAAE,QAAQ;YAC3B,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC;gBAC/B,MAAM,CAAC,gBAAgB,CAAC;oBACtB,IAAI,EAAE,wBAAwB;oBAC9B,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;iBAC1D,CAAC;aACH,CAAC;SACH,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC;YACE,GAAG,EAAE,YAAY;YACjB,MAAM,EAAE;gBACN,YAAY,EAAE,CAAC;gBACf,cAAc,EAAE,CAAC;gBACjB,SAAS,EAAE,KAAK;gBAChB,oBAAoB,EAAE,KAAK;aAC5B;YACD,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,IAAI;SACnB,EACD,OAAO,EAAE,EACT,CAAC,2BAA2B,EAAE,8BAA8B,CAAC,CAC9D,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC;QAC3F,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC;YAC/D;gBACE,EAAE,EAAE,0BAA0B;gBAC9B,IAAI,EAAE,gCAAgC;gBACtC,MAAM,EAAE,gBAAgB;gBACxB,MAAM,EAAE,4BAA4B;aACrC;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;YACjC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK;YAC7B,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5C,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,CAAC,CAAC;YACH,cAAc,EAAE;gBACd,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO;gBAClC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK;aAC7C;SACF,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,IAAI,GAAG;YACX,GAAG,EAAE,YAAY;YACjB,MAAM,EAAE,EAAE,SAAS,EAAE,KAAc,EAAE,oBAAoB,EAAE,KAAc,EAAE;YAC3E,SAAS,EAAE,KAAc;YACzB,YAAY,EAAE,IAAI;SACnB,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACnD,2BAA2B;YAC3B,8BAA8B;SAC/B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACpD,2BAA2B;YAC3B,8BAA8B;SAC/B,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/yagni-presentation.test.d.ts

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

package/dist/__tests__/yagni-presentation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-presentation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/yagni-presentation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/yagni-presentation.test.js

@@ -0,0 +1,30 @@
+import { describe, expect, it, vi } from 'vitest';
+import { executeYagni } from '../cli/execute-yagni.js';
+import { buildYagniPresentationLines } from '../cli/yagni-presentation.js';
+import { duplicateBodyCandidateDetector } from '../detectors/duplicate-body-candidate.js';
+import { unusedConfigSurfaceDetector } from '../detectors/unused-config-surface.js';
+const FIXTURE_ROOT = new URL('fixtures/unused-config-surface/pkg', import.meta.url).pathname;
+function stubCli() {
+    return {
+        scope: { datastore: () => undefined },
+        deliverSignals: vi.fn(() => Promise.resolve({ delivered: false })),
+    };
+}
+describe('yagni presentation', () => {
+    it('renders compact summary with net footer for default output', async () => {
+        const outcome = await executeYagni({
+            cwd: FIXTURE_ROOT,
+            config: { graphMode: 'off', defaultMinConfidence: 'low' },
+            graphMode: 'off',
+            includeTests: true,
+        }, stubCli(), [unusedConfigSurfaceDetector, duplicateBodyCandidateDetector]);
+        const lines = buildYagniPresentationLines(outcome.envelope, FIXTURE_ROOT, 'off', outcome.session.payload.summary.skippedDetectors, false);
+        const text = lines.join('\n');
+        expect(text).toContain('YAGNI audit: 1 reduction candidates');
+        expect(text).toContain('High confidence');
+        expect(text).toContain('unused-config-surface');
+        expect(text).toContain('net: ~1 LOC possible');
+        expect(text).not.toContain('Run with --verbose for evidence');
+    });
+});
+//# sourceMappingURL=yagni-presentation.test.js.map

package/dist/__tests__/yagni-presentation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-presentation.test.js","sourceRoot":"","sources":["../../src/__tests__/yagni-presentation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAIpF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,oCAAoC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AAE7F,SAAS,OAAO;IACd,OAAO;QACL,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE;QACrC,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;KACtC,CAAC;AACjC,CAAC;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC;YACE,GAAG,EAAE,YAAY;YACjB,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE;YACzD,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,IAAI;SACnB,EACD,OAAO,EAAE,EACT,CAAC,2BAA2B,EAAE,8BAA8B,CAAC,CAC9D,CAAC;QACF,MAAM,KAAK,GAAG,2BAA2B,CACvC,OAAO,CAAC,QAAQ,EAChB,YAAY,EACZ,KAAK,EACL,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAChD,KAAK,CACN,CAAC;QACF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/baseline-strategy.d.ts

@@ -0,0 +1,9 @@
+/**
+ * yagni's fingerprint strategy for the host baseline/ratchet plane (ADR-0036).
+ *
+ * Stable identity: detector + normalized locations + symbol ids + evidence ids.
+ */
+import type { FingerprintStrategy } from '@opensip-cli/core';
+/** yagni's baseline identity: sha256(detector|locations|symbolIds|evidenceIds). */
+export declare const yagniFingerprintStrategy: FingerprintStrategy;
+//# sourceMappingURL=baseline-strategy.d.ts.map

package/dist/baseline-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-strategy.d.ts","sourceRoot":"","sources":["../src/baseline-strategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAY7D,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,EAAE,mBAetC,CAAC"}

package/dist/baseline-strategy.js

@@ -0,0 +1,30 @@
+/**
+ * yagni's fingerprint strategy for the host baseline/ratchet plane (ADR-0036).
+ *
+ * Stable identity: detector + normalized locations + symbol ids + evidence ids.
+ */
+import { createHash } from 'node:crypto';
+import { readYagniMetadata } from './scoring/confidence.js';
+function normalizedLocation(s) {
+    const line = s.line ?? 0;
+    const col = s.column ?? 0;
+    return `${s.filePath}:${String(line)}:${String(col)}`;
+}
+/** yagni's baseline identity: sha256(detector|locations|symbolIds|evidenceIds). */
+export const yagniFingerprintStrategy = (s) => {
+    const meta = readYagniMetadata(s);
+    const detector = meta?.detector ?? s.ruleId;
+    const location = normalizedLocation(s);
+    const symbolIds = meta?.evidence
+        .map((e) => e.data?.qualifiedName)
+        .filter((v) => typeof v === 'string')
+        .sort()
+        .join(',');
+    const evidenceIds = (meta?.evidence ?? [])
+        .map((e) => e.id)
+        .sort()
+        .join(',');
+    const payload = `${detector}|${location}|${symbolIds}|${evidenceIds}`;
+    return createHash('sha256').update(payload).digest('hex');
+};
+//# sourceMappingURL=baseline-strategy.js.map

package/dist/baseline-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-strategy.js","sourceRoot":"","sources":["../src/baseline-strategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAI5D,SAAS,kBAAkB,CAAC,CAI3B;IACC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,wBAAwB,GAAwB,CAAC,CAAC,EAAE,EAAE;IACjE,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,EAAE,QAAQ;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;SACjD,IAAI,EAAE;SACN,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChB,IAAI,EAAE;SACN,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,QAAQ,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;IACtE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC"}

package/dist/cli/__tests__/yagni-runner.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * yagni-runner produce() mapping — compact vs verbose LiveRunOutcome shape.
+ */
+export {};
+//# sourceMappingURL=yagni-runner.test.d.ts.map

package/dist/cli/__tests__/yagni-runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-runner.test.d.ts","sourceRoot":"","sources":["../../../src/cli/__tests__/yagni-runner.test.tsx"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli/__tests__/yagni-runner.test.js

@@ -0,0 +1,126 @@
+/**
+ * yagni-runner produce() mapping — compact vs verbose LiveRunOutcome shape.
+ */
+import { buildSignalEnvelope } from '@opensip-cli/contracts';
+import { HOST_VERDICT_POLICY_FALLBACK } from '@opensip-cli/core';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { executeYagni } from '../execute-yagni.js';
+import { renderYagniLive } from '../yagni-runner.js';
+const runToolLiveView = vi.hoisted(() => vi.fn());
+vi.mock('@opensip-cli/cli-live', () => ({
+    runToolLiveView,
+}));
+vi.mock('../yagni-config.js', () => ({
+    loadYagniConfig: vi.fn(() => ({})),
+}));
+vi.mock('../execute-yagni.js', () => ({
+    executeYagni: vi.fn(),
+}));
+const executeYagniMock = executeYagni;
+function stubCli() {
+    return {
+        scope: { datastore: () => undefined },
+        deliverSignals: vi.fn(() => Promise.resolve({ delivered: false })),
+    };
+}
+function yagniEnvelope() {
+    return buildSignalEnvelope({
+        tool: 'yagni',
+        runId: 'run-yagni',
+        createdAt: '2026-06-04T00:00:00.000Z',
+        units: [{ slug: 'yagni:unused-config-surface', passed: false, durationMs: 12 }],
+        signals: [],
+        policy: HOST_VERDICT_POLICY_FALLBACK,
+        runFaulted: false,
+    });
+}
+function stubExecuteOutcome() {
+    return {
+        envelope: yagniEnvelope(),
+        session: {
+            tool: 'yagni',
+            cwd: '/proj',
+            score: 80,
+            passed: false,
+            payload: {
+                __version: 1,
+                summary: {
+                    total: 1,
+                    passed: 0,
+                    failed: 1,
+                    errors: 0,
+                    warnings: 1,
+                    skippedDetectors: [],
+                    graphMode: 'off',
+                    yagni: {
+                        totalCandidates: 1,
+                        byConfidence: { high: 1, medium: 0, low: 0 },
+                        estimatedTotalLocReduction: 10,
+                        graphMode: 'off',
+                        skippedDetectors: [],
+                    },
+                },
+                checks: [],
+            },
+        },
+    };
+}
+let capturedSpec;
+let capturedGlue;
+beforeEach(() => {
+    capturedSpec = undefined;
+    capturedGlue = undefined;
+    runToolLiveView.mockReset();
+    executeYagniMock.mockReset();
+    executeYagniMock.mockResolvedValue(stubExecuteOutcome());
+    runToolLiveView.mockImplementation((spec, glue) => {
+        capturedSpec = spec;
+        capturedGlue = glue;
+        return Promise.resolve({});
+    });
+});
+describe('renderYagniLive produce mapping', () => {
+    it('routes through runToolLiveView with the yagni tool key', async () => {
+        await renderYagniLive({ cwd: '/proj', graphMode: 'off' }, stubCli());
+        expect(runToolLiveView).toHaveBeenCalledTimes(1);
+        expect(capturedSpec?.tool).toBe('yagni');
+    });
+    it('passes the host exit-code hook to runToolLiveView', async () => {
+        const setExitCode = vi.fn();
+        await renderYagniLive({ cwd: '/proj', graphMode: 'off' }, {
+            ...stubCli(),
+            setExitCode,
+        });
+        expect(capturedGlue).toMatchObject({ setExitCode });
+    });
+    it('omits verbose table and lines on compact runs', async () => {
+        await renderYagniLive({ cwd: '/proj', graphMode: 'off', verbose: false }, stubCli());
+        const outcome = await capturedSpec.produce(vi.fn(), {
+            setRunning: vi.fn(),
+            setHeaderMetadata: vi.fn(),
+            setShowRunHeader: vi.fn(),
+        });
+        expect(outcome.kind).toBe('done');
+        if (outcome.kind !== 'done')
+            return;
+        expect(outcome.done.verboseLines).toBeUndefined();
+        expect(outcome.done.table).toBeUndefined();
+        expect(outcome.done.summary).toMatchObject({ passed: true, errors: 0, warnings: 0 });
+        expect(outcome.session?.tool).toBe('yagni');
+        expect(outcome.session?.passed).toBe(false);
+    });
+    it('includes verbose table and lines when --verbose is set', async () => {
+        await renderYagniLive({ cwd: '/proj', graphMode: 'off', verbose: true }, stubCli());
+        const outcome = await capturedSpec.produce(vi.fn(), {
+            setRunning: vi.fn(),
+            setHeaderMetadata: vi.fn(),
+            setShowRunHeader: vi.fn(),
+        });
+        expect(outcome.kind).toBe('done');
+        if (outcome.kind !== 'done')
+            return;
+        expect(outcome.done.verboseLines?.length).toBeGreaterThan(0);
+        expect(outcome.done.table?.length).toBe(1);
+    });
+});
+//# sourceMappingURL=yagni-runner.test.js.map

package/dist/cli/__tests__/yagni-runner.test.js.map

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

package/dist/cli/execute-yagni.d.ts

@@ -0,0 +1,32 @@
+import { buildYagniSessionPayload } from '../persistence/session-payload.js';
+import type { YagniDetector } from '../detectors/types.js';
+import type { YagniConfig, YagniGraphMode } from '../types/yagni-config.js';
+import type { YagniConfidence } from '../types/yagni-metadata.js';
+import type { SignalEnvelope } from '@opensip-cli/contracts';
+import type { ToolCliContext } from '@opensip-cli/core';
+/** Runtime options for one YAGNI detector pass. */
+export interface ExecuteYagniOptions {
+    readonly cwd: string;
+    readonly config?: YagniConfig;
+    readonly graphMode?: YagniGraphMode;
+    readonly minConfidence?: YagniConfidence;
+    readonly detectors?: readonly string[];
+    readonly categories?: readonly string[];
+    readonly includeTests?: boolean;
+    readonly pathRoots?: readonly string[];
+    readonly onProgress?: (completed: number, total: number) => void;
+}
+/** Envelope plus session payload returned to the host command runner. */
+export interface ExecuteYagniResult {
+    readonly envelope: SignalEnvelope;
+    readonly session: {
+        readonly tool: 'yagni';
+        readonly cwd: string;
+        readonly score: number;
+        readonly passed: boolean;
+        readonly payload: ReturnType<typeof buildYagniSessionPayload>;
+    };
+}
+/** Run the selected YAGNI detectors and build the persisted signal envelope. */
+export declare function executeYagni(opts: ExecuteYagniOptions, cli: ToolCliContext, detectors?: readonly YagniDetector[]): Promise<ExecuteYagniResult>;
+//# sourceMappingURL=execute-yagni.d.ts.map

package/dist/cli/execute-yagni.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-yagni.d.ts","sourceRoot":"","sources":["../../src/cli/execute-yagni.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAQ7E,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAED,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;KAC/D,CAAC;CACH;AAsDD,gFAAgF;AAChF,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,cAAc,EACnB,SAAS,GAAE,SAAS,aAAa,EAAoB,GACpD,OAAO,CAAC,kBAAkB,CAAC,CAkF7B"}

package/dist/cli/execute-yagni.js

@@ -0,0 +1,127 @@
+import { randomUUID } from 'node:crypto';
+import { buildSignalEnvelope } from '@opensip-cli/contracts';
+import { isErrorSignal } from '@opensip-cli/core';
+import { yagniFingerprintStrategy } from '../baseline-strategy.js';
+import { YAGNI_DETECTORS } from '../detectors/registry.js';
+import { resolveGraphEvidence } from '../evidence/graph-evidence.js';
+import { YAGNI_LAYOUT_KEY } from '../identity.js';
+import { buildYagniSessionPayload } from '../persistence/session-payload.js';
+import { buildYagniRunSummary, filterByMinConfidence, filterByReductionCategories, sortYagniSignals, } from '../scoring/confidence.js';
+function isDisabled(detector, config) {
+    const disabled = config.disabledDetectors ?? [];
+    return disabled.includes(detector.id) || disabled.includes(detector.slug);
+}
+function matchesDetectorFilter(detector, filter) {
+    if (filter.length === 0)
+        return true;
+    return filter.some((slug) => slug === detector.id ||
+        slug === detector.slug ||
+        slug === detector.slug.replace(/^yagni:/, ''));
+}
+function planDetectors(detectors, config, graphAvailable, detectorFilter) {
+    const run = [];
+    const skipped = [];
+    for (const detector of detectors) {
+        if (!matchesDetectorFilter(detector, detectorFilter))
+            continue;
+        if (isDisabled(detector, config)) {
+            skipped.push({
+                id: detector.id,
+                slug: detector.slug,
+                reason: 'disabled',
+            });
+            continue;
+        }
+        if (detector.requiresGraph && !graphAvailable) {
+            skipped.push({
+                id: detector.id,
+                slug: detector.slug,
+                reason: 'graph-required',
+                detail: 'graph evidence unavailable',
+            });
+            continue;
+        }
+        run.push(detector);
+    }
+    return { run, skipped };
+}
+/** Run the selected YAGNI detectors and build the persisted signal envelope. */
+export async function executeYagni(opts, cli, detectors = YAGNI_DETECTORS) {
+    const config = opts.config ?? {};
+    const graphMode = opts.graphMode ?? config.graphMode ?? 'auto';
+    const graphEvidence = await resolveGraphEvidence(opts.cwd, graphMode, cli);
+    const graphAvailable = graphEvidence.catalog !== null;
+    const includeTests = opts.includeTests ?? config.includeTests ?? false;
+    const minConfidence = opts.minConfidence ?? config.defaultMinConfidence ?? 'medium';
+    const { run, skipped } = planDetectors(detectors, config, graphAvailable, opts.detectors ?? []);
+    const allSignals = [];
+    const units = [];
+    const total = run.length;
+    opts.onProgress?.(0, total);
+    for (const detector of run) {
+        const started = Date.now();
+        try {
+            const result = await detector.run({
+                cwd: opts.cwd,
+                config,
+                graphCatalog: graphEvidence.catalog,
+                includeTests,
+                ...(opts.pathRoots === undefined ? {} : { pathRoots: opts.pathRoots }),
+            });
+            const filtered = filterByMinConfidence(result.signals, minConfidence);
+            allSignals.push(...filtered);
+            const violationCount = filtered.length;
+            units.push({
+                slug: detector.slug,
+                passed: violationCount === 0 || filtered.every((s) => !isErrorSignal(s)),
+                violationCount,
+                durationMs: result.durationMs || Date.now() - started,
+            });
+        }
+        catch (error) {
+            units.push({
+                slug: detector.slug,
+                passed: false,
+                durationMs: Date.now() - started,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        opts.onProgress?.(units.length, total);
+    }
+    const categoryFiltered = filterByReductionCategories(allSignals, opts.categories ?? []);
+    const sortedSignals = sortYagniSignals(categoryFiltered);
+    const runId = randomUUID();
+    const createdAt = new Date().toISOString();
+    const policy = {
+        failOnErrors: config.failOnErrors ?? 0,
+        failOnWarnings: config.failOnWarnings ?? 0,
+    };
+    const envelope = buildSignalEnvelope({
+        tool: 'yagni',
+        runId,
+        createdAt,
+        units,
+        signals: sortedSignals,
+        policy,
+        runFaulted: units.some((u) => u.error !== undefined),
+        fingerprintStrategy: yagniFingerprintStrategy,
+    });
+    const yagniSummary = buildYagniRunSummary(envelope.signals, graphEvidence.mode, skipped);
+    const sessionPayload = buildYagniSessionPayload(envelope, skipped, {
+        graphMode: graphEvidence.mode,
+        graphBuilt: graphEvidence.built,
+        graphDetail: graphEvidence.detail,
+        yagniSummary,
+    });
+    return {
+        envelope,
+        session: {
+            tool: YAGNI_LAYOUT_KEY,
+            cwd: opts.cwd,
+            score: envelope.verdict.score,
+            passed: true,
+            payload: sessionPayload,
+        },
+    };
+}
+//# sourceMappingURL=execute-yagni.js.map

package/dist/cli/execute-yagni.js.map

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

package/dist/cli/report-data.d.ts

@@ -0,0 +1,23 @@
+/**
+ * report-data contribution — yagni's inputs to the cross-tool HTML report.
+ */
+import type { ToolScope } from '@opensip-cli/core';
+/** Detector catalog entry for the dashboard. */
+export interface YagniDetectorCatalogEntry {
+    readonly id: string;
+    readonly slug: string;
+    readonly description: string;
+    readonly requiresGraph: boolean;
+}
+/** Static summary of the bundled detector catalog. */
+export interface YagniSummaryCatalog {
+    readonly detectorCount: number;
+    readonly graphBackedCount: number;
+    readonly contractVersion: string;
+}
+/**
+ * Yagni's report-data contribution. Returns detector catalog + summary under
+ * yagni-namespaced keys the dashboard consumes.
+ */
+export declare function collectYagniReportData(_scope: ToolScope): Record<string, unknown>;
+//# sourceMappingURL=report-data.d.ts.map

package/dist/cli/report-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-data.d.ts","sourceRoot":"","sources":["../../src/cli/report-data.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAajF"}

package/dist/cli/report-data.js

@@ -0,0 +1,23 @@
+/**
+ * report-data contribution — yagni's inputs to the cross-tool HTML report.
+ */
+import { YAGNI_DETECTORS } from '../detectors/registry.js';
+/**
+ * Yagni's report-data contribution. Returns detector catalog + summary under
+ * yagni-namespaced keys the dashboard consumes.
+ */
+export function collectYagniReportData(_scope) {
+    const yagniCatalog = YAGNI_DETECTORS.map((d) => ({
+        id: d.id,
+        slug: d.slug,
+        description: d.description,
+        requiresGraph: d.requiresGraph,
+    }));
+    const yagniSummary = {
+        detectorCount: YAGNI_DETECTORS.length,
+        graphBackedCount: YAGNI_DETECTORS.filter((d) => d.requiresGraph).length,
+        contractVersion: '1.0.0',
+    };
+    return { yagniCatalog, yagniSummary };
+}
+//# sourceMappingURL=report-data.js.map

package/dist/cli/report-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-data.js","sourceRoot":"","sources":["../../src/cli/report-data.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAmB3D;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,YAAY,GAAgC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5E,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;KAC/B,CAAC,CAAC,CAAC;IACJ,MAAM,YAAY,GAAwB;QACxC,aAAa,EAAE,eAAe,CAAC,MAAM;QACrC,gBAAgB,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM;QACvE,eAAe,EAAE,OAAO;KACzB,CAAC;IACF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC"}

package/dist/cli/yagni-command-spec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * yagni-command-spec — declarative primary `yagni` command.
+ */
+import type { ToolCliContext } from '@opensip-cli/core';
+export declare function buildYagniCommandSpec(setUpLiveView: (cli: ToolCliContext) => void): import("@opensip-cli/core").PrimaryCommandSpecDraft<unknown, ToolCliContext>;
+//# sourceMappingURL=yagni-command-spec.d.ts.map

package/dist/cli/yagni-command-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-command-spec.d.ts","sourceRoot":"","sources":["../../src/cli/yagni-command-spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAyI3E,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,gFAmDjF"}