@opensip-cli/yagni 0.1.13 → 0.1.15

package/README.md

@@ -25,8 +25,8 @@ This package is published for the CLI and advanced plugin authors; most users sh
 ## Documentation
 
 - 📚 Project docs: https://opensip.ai/docs/opensip-cli/
-- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.13/docs/public/70-reference/02-package-catalog.md
-- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.13/packages/yagni/engine
+- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.15/docs/public/70-reference/02-package-catalog.md
+- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.15/packages/yagni/engine
 
 ## License
 

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

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

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

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

package/dist/cli/__tests__/yagni-command-spec.test.js

@@ -0,0 +1,128 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { buildYagniCommandSpec } from '../yagni-command-spec.js';
+const executeYagniMock = vi.hoisted(() => vi.fn());
+const loadYagniConfigMock = vi.hoisted(() => vi.fn(() => ({
+    failOnErrors: 0,
+    failOnWarnings: 1,
+    defaultMinConfidence: 'medium',
+    includeTests: false,
+})));
+const runYagniGateModeMock = vi.hoisted(() => vi.fn());
+const applyAdvisoryExitCodeMock = vi.hoisted(() => vi.fn());
+vi.mock('../execute-yagni.js', () => ({
+    executeYagni: executeYagniMock,
+}));
+vi.mock('../yagni-config.js', () => ({
+    loadYagniConfig: loadYagniConfigMock,
+}));
+vi.mock('../yagni-gate-mode.js', () => ({
+    runYagniGateMode: runYagniGateModeMock,
+}));
+vi.mock('../../lib/apply-advisory-exit.js', () => ({
+    applyAdvisoryExitCode: applyAdvisoryExitCodeMock,
+}));
+function envelope() {
+    return {
+        schemaVersion: 2,
+        tool: 'yagni',
+        runId: 'run-1',
+        createdAt: '2026-01-01T00:00:00.000Z',
+        verdict: {
+            score: 100,
+            passed: true,
+            summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+        },
+        units: [],
+        signals: [],
+        baselineIdentity: {
+            fingerprintStrategyId: 'yagni.sha256-detector-locations',
+            fingerprintStrategyVersion: 1,
+        },
+    };
+}
+function mockCli() {
+    return {
+        emitEnvelope: vi.fn(),
+        render: vi.fn(() => Promise.resolve()),
+        deliverSignals: vi.fn(() => Promise.resolve()),
+        maybeOpenReport: vi.fn(() => Promise.resolve()),
+        writeSarif: vi.fn(() => Promise.resolve()),
+        renderLive: vi.fn(),
+        setExitCode: vi.fn(),
+        logger: console,
+    };
+}
+beforeEach(() => {
+    vi.clearAllMocks();
+    executeYagniMock.mockResolvedValue({
+        envelope: envelope(),
+        session: {
+            tool: 'yagni',
+            cwd: '/repo',
+            score: 100,
+            passed: true,
+            payload: { summary: { skippedDetectors: [] } },
+        },
+    });
+    runYagniGateModeMock.mockResolvedValue({ session: { tool: 'yagni', cwd: '/repo' } });
+});
+describe('buildYagniCommandSpec', () => {
+    it('delegates gate flags to runYagniGateMode', async () => {
+        const spec = buildYagniCommandSpec(() => undefined);
+        const cli = mockCli();
+        await spec.handler?.({ cwd: '/repo', gateSave: true }, cli);
+        expect(runYagniGateModeMock).toHaveBeenCalledWith(expect.objectContaining({ cwd: '/repo', gateSave: true }), cli);
+        expect(executeYagniMock).not.toHaveBeenCalled();
+    });
+    it('emits the envelope on --json and writes SARIF when requested', async () => {
+        const spec = buildYagniCommandSpec(() => undefined);
+        const cli = mockCli();
+        await spec.handler?.({ cwd: '/repo', json: true, sarif: 'out.sarif' }, cli);
+        expect(cli.emitEnvelope).toHaveBeenCalled();
+        expect(cli.writeSarif).toHaveBeenCalledWith(expect.anything(), 'out.sarif');
+        expect(cli.render).not.toHaveBeenCalled();
+        expect(applyAdvisoryExitCodeMock).toHaveBeenCalled();
+        expect(cli.deliverSignals).toHaveBeenCalled();
+    });
+    it('renders a presentation on non-json, non-tty runs', async () => {
+        const spec = buildYagniCommandSpec(() => undefined);
+        const cli = mockCli();
+        const isTTY = Object.getOwnPropertyDescriptor(process.stdout, 'isTTY');
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, configurable: true });
+        try {
+            await spec.handler?.({ cwd: '/repo', json: false }, cli);
+        }
+        finally {
+            if (isTTY === undefined)
+                Reflect.deleteProperty(process.stdout, 'isTTY');
+            else
+                Object.defineProperty(process.stdout, 'isTTY', isTTY);
+        }
+        expect(cli.render).toHaveBeenCalledWith(expect.objectContaining({ type: 'run-presentation', tool: 'yagni' }));
+        expect(cli.emitEnvelope).not.toHaveBeenCalled();
+    });
+    it('uses renderLive on a tty when no positional paths are provided', async () => {
+        const setUpLiveView = vi.fn();
+        const spec = buildYagniCommandSpec(setUpLiveView);
+        const cli = mockCli();
+        cli.renderLive.mockResolvedValue({
+            envelope: envelope(),
+            session: { tool: 'yagni', cwd: '/repo' },
+        });
+        const isTTY = Object.getOwnPropertyDescriptor(process.stdout, 'isTTY');
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        try {
+            await spec.handler?.({ cwd: '/repo', json: false }, cli);
+        }
+        finally {
+            if (isTTY === undefined)
+                Reflect.deleteProperty(process.stdout, 'isTTY');
+            else
+                Object.defineProperty(process.stdout, 'isTTY', isTTY);
+        }
+        expect(setUpLiveView).toHaveBeenCalledWith(cli);
+        expect(cli.renderLive).toHaveBeenCalled();
+        expect(executeYagniMock).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=yagni-command-spec.test.js.map

package/dist/cli/__tests__/yagni-command-spec.test.js.map

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

package/dist/cli/__tests__/yagni-gate-mode.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ADR-0020 + ADR-0036: `yagni --gate-save` must hard-fail when the findings
+ * policy is not satisfied. Yagni findings are warning-rung (`low`/`medium`), so
+ * the dogfood gate uses `failOnWarnings` (not `isErrorSignal`).
+ */
+export {};
+//# sourceMappingURL=yagni-gate-mode.test.d.ts.map

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

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

package/dist/cli/__tests__/yagni-gate-mode.test.js

@@ -0,0 +1,155 @@
+/**
+ * ADR-0020 + ADR-0036: `yagni --gate-save` must hard-fail when the findings
+ * policy is not satisfied. Yagni findings are warning-rung (`low`/`medium`), so
+ * the dogfood gate uses `failOnWarnings` (not `isErrorSignal`).
+ */
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { createSignal } from '@opensip-cli/core';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { runYagniGateMode } from '../yagni-gate-mode.js';
+function signal(over = {}) {
+    return createSignal({
+        source: 'yagni',
+        severity: 'medium',
+        ruleId: 'yagni:unused-config-surface',
+        message: 'msg',
+        code: { file: 'src/a.ts', line: 1 },
+        ...over,
+    });
+}
+function envelopeOf(signals, passed = signals.length === 0) {
+    const warnings = signals.filter((s) => s.severity === 'medium' || s.severity === 'low').length;
+    const errors = signals.length - warnings;
+    return {
+        schemaVersion: 2,
+        tool: 'yagni',
+        runId: 'test-run',
+        createdAt: '1970-01-01T00:00:00.000Z',
+        verdict: {
+            score: passed ? 100 : 0,
+            passed,
+            summary: {
+                total: signals.length,
+                passed: passed ? signals.length : 0,
+                failed: passed ? 0 : signals.length,
+                errors,
+                warnings,
+            },
+        },
+        units: [],
+        signals,
+        baselineIdentity: {
+            fingerprintStrategyId: 'yagni.sha256-detector-locations',
+            fingerprintStrategyVersion: 1,
+        },
+    };
+}
+function mockCli() {
+    const saveBaseline = vi.fn(() => Promise.resolve());
+    const deliverSignals = vi.fn(() => Promise.resolve());
+    const render = vi.fn((_result) => Promise.resolve());
+    const setExitCode = vi.fn();
+    const cli = {
+        saveBaseline,
+        deliverSignals,
+        render,
+        setExitCode,
+        logger: console,
+        reportFailure: vi.fn(async (detail) => {
+            if (detail.exitCode !== undefined)
+                setExitCode(detail.exitCode);
+            if (detail.message)
+                await render({ type: 'error', message: detail.message });
+        }),
+    };
+    return { cli, saveBaseline, deliverSignals, render, setExitCode };
+}
+const executeYagniMock = vi.hoisted(() => vi.fn());
+const loadYagniConfigMock = vi.hoisted(() => vi.fn(() => ({
+    failOnErrors: 0,
+    failOnWarnings: 1,
+    defaultMinConfidence: 'medium',
+    includeTests: false,
+})));
+vi.mock('../execute-yagni.js', () => ({
+    executeYagni: executeYagniMock,
+}));
+vi.mock('../yagni-config.js', () => ({
+    loadYagniConfig: loadYagniConfigMock,
+}));
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('runYagniGateMode --gate-save', () => {
+    it('saves the baseline and passes runFailed=false when the policy passes', async () => {
+        const { cli, saveBaseline, deliverSignals, setExitCode } = mockCli();
+        const envelope = envelopeOf([]);
+        executeYagniMock.mockResolvedValue({
+            envelope,
+            session: { tool: 'yagni', cwd: '/x', score: 100, passed: true, payload: {} },
+        });
+        await runYagniGateMode({ cwd: '/x', gateSave: true }, cli);
+        expect(saveBaseline).toHaveBeenCalledWith('yagni', envelope);
+        expect(setExitCode).not.toHaveBeenCalled();
+        expect(deliverSignals).toHaveBeenCalledWith(envelope, expect.objectContaining({ runFailed: false }));
+    });
+    it('feeds runFailed=true when the envelope verdict fails the policy', async () => {
+        const { cli, deliverSignals } = mockCli();
+        const envelope = envelopeOf([signal()], false);
+        executeYagniMock.mockResolvedValue({
+            envelope,
+            session: { tool: 'yagni', cwd: '/x', score: 0, passed: false, payload: {} },
+        });
+        await runYagniGateMode({ cwd: '/x', gateSave: true }, cli);
+        expect(deliverSignals).toHaveBeenCalledWith(envelope, expect.objectContaining({ runFailed: true }));
+    });
+    it('writes SARIF after gate-save when --sarif is set', async () => {
+        const { cli, deliverSignals } = mockCli();
+        const writeSarif = vi.fn(() => Promise.resolve());
+        Object.assign(cli, { writeSarif });
+        const envelope = envelopeOf([]);
+        executeYagniMock.mockResolvedValue({
+            envelope,
+            session: { tool: 'yagni', cwd: '/x', score: 100, passed: true, payload: {} },
+        });
+        await runYagniGateMode({ cwd: '/x', gateSave: true, sarif: 'yagni.sarif' }, cli);
+        expect(writeSarif).toHaveBeenCalledWith(envelope, 'yagni.sarif');
+        expect(deliverSignals).toHaveBeenCalled();
+    });
+});
+describe('runYagniGateMode --gate-compare', () => {
+    it('rejects mutually exclusive gate flags', async () => {
+        const { cli, setExitCode } = mockCli();
+        await runYagniGateMode({ cwd: '/x', gateSave: true, gateCompare: true }, cli);
+        expect(setExitCode).toHaveBeenCalledWith(EXIT_CODES.CONFIGURATION_ERROR);
+        expect(executeYagniMock).not.toHaveBeenCalled();
+    });
+    it('passes when compareBaseline reports no regressions', async () => {
+        const { cli, deliverSignals } = mockCli();
+        const compareBaseline = vi.fn(() => Promise.resolve({ degraded: false, added: [], resolved: [1] }));
+        const writeSarif = vi.fn(() => Promise.resolve());
+        Object.assign(cli, { compareBaseline, writeSarif });
+        const envelope = envelopeOf([]);
+        executeYagniMock.mockResolvedValue({
+            envelope,
+            session: { tool: 'yagni', cwd: '/x', score: 100, passed: true, payload: {} },
+        });
+        await runYagniGateMode({ cwd: '/x', gateCompare: true, sarif: 'yagni.sarif' }, cli);
+        expect(compareBaseline).toHaveBeenCalledWith('yagni', envelope);
+        expect(deliverSignals).toHaveBeenCalledWith(envelope, expect.objectContaining({ runFailed: false }));
+        expect(writeSarif).toHaveBeenCalledWith(envelope, 'yagni.sarif');
+    });
+    it('fails when compareBaseline reports regressions', async () => {
+        const { cli, deliverSignals } = mockCli();
+        const compareBaseline = vi.fn(() => Promise.resolve({ degraded: true, added: [1], resolved: [] }));
+        Object.assign(cli, { compareBaseline });
+        const envelope = envelopeOf([signal()]);
+        executeYagniMock.mockResolvedValue({
+            envelope,
+            session: { tool: 'yagni', cwd: '/x', score: 0, passed: false, payload: {} },
+        });
+        await runYagniGateMode({ cwd: '/x', gateCompare: true }, cli);
+        expect(deliverSignals).toHaveBeenCalledWith(envelope, expect.objectContaining({ runFailed: true }));
+    });
+});
+//# sourceMappingURL=yagni-gate-mode.test.js.map

package/dist/cli/__tests__/yagni-gate-mode.test.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"yagni-command-spec.d.ts","sourceRoot":"","sources":["../../src/cli/yagni-command-spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AA8H3E,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,gFA4CjF"}
+{"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,gFA6DjF"}

package/dist/cli/yagni-command-spec.js

@@ -7,6 +7,7 @@ import { applyAdvisoryExitCode } from '../lib/apply-advisory-exit.js';
 import { resolveYagniPositionalPaths } from '../lib/resolve-positional-paths.js';
 import { executeYagni } from './execute-yagni.js';
 import { loadYagniConfig } from './yagni-config.js';
+import { runYagniGateMode } from './yagni-gate-mode.js';
 import { buildYagniRunPresentation } from './yagni-presentation.js';
 function parseMinConfidence(raw) {
     if (raw === 'low' || raw === 'medium' || raw === 'high')
@@ -45,6 +46,9 @@ async function deliverYagniRun(opts, cli, config, outcome) {
 }
 async function runYagniCommand(rawOpts, cli, setUpLiveView) {
     const opts = rawOpts;
+    if (opts.gateSave === true || opts.gateCompare === true) {
+        return (await runYagniGateMode(opts, cli)) ?? {};
+    }
     const config = loadYagniConfig(opts.cwd);
     const positionals = opts._args ?? [];
     const paths = (positionals[0] ?? []);
@@ -87,13 +91,31 @@ async function runYagniCommand(rawOpts, cli, setUpLiveView) {
         await cli.render(presentation);
     }
     await deliverYagniRun(opts, cli, config, outcome);
+    if (opts.sarif !== undefined && opts.sarif !== '') {
+        await cli.writeSarif(outcome.envelope, opts.sarif);
+    }
     return { session: outcome.session };
 }
 export function buildYagniCommandSpec(setUpLiveView) {
     return definePrimaryCommand({
-        description: 'Run YAGNI reduction audit detectors (advisory; exit 0 by default)',
+        description: 'Run YAGNI reduction audit detectors',
         commonFlags: ['cwd', 'json', 'quiet', 'verbose', 'debug', 'reportTo', 'apiKey', 'open'],
         options: [
+            {
+                flag: '--gate-save',
+                description: 'Architecture-gate: save current findings as baseline in the project SQLite store (mutually exclusive with --gate-compare)',
+                default: false,
+            },
+            {
+                flag: '--gate-compare',
+                description: 'Architecture-gate: compare current findings against the saved baseline; exit 1 on regression',
+                default: false,
+            },
+            {
+                flag: '--sarif',
+                value: '<path>',
+                description: 'Write this run findings as SARIF 2.1.0 (composes with --gate-save)',
+            },
             {
                 flag: '--min-confidence',
                 value: '<level>',

package/dist/cli/yagni-command-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"yagni-command-spec.js","sourceRoot":"","sources":["../../src/cli/yagni-command-spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"yagni-command-spec.js","sourceRoot":"","sources":["../../src/cli/yagni-command-spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAwBpE,SAAS,kBAAkB,CAAC,GAAuB;IACjD,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAkC;IAC7D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAyB,EACzB,SAAwC;IAExC,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI;QAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;QAC1B,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC;QACrD,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC7C,UAAU,EAAE,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,SAAS;KACV,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,IAAyB,EACzB,GAAmB,EACnB,MAA0C,EAC1C,OAAmE;IAEnE,MAAM,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE;QACzC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,eAAe,CAAC;QACxB,aAAa,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI;QACjC,UAAU,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI;KAC/B,CAAC,CAAC;IAEH,yFAAyF;IACzF,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,OAAgB,EAChB,GAAmB,EACnB,aAA4C;IAE5C,MAAM,IAAI,GAAG,OAA8B,CAAC;IAC5C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACxD,OAAO,CAAC,MAAM,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,WAAW,GAAI,IAAkD,CAAC,KAAK,IAAI,EAAE,CAAC;IACpF,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAsB,CAAC;IAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,MAAM,WAAW,GACf,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,CAAC;IAEjF,IAAI,WAAW,EAAE,CAAC;QAChB,aAAa,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,UAAU,CACrC,mBAAmB,EACnB,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,CACpC,CAAC;QACF,MAAM,QAAQ,GAAG,UAAU,EAAE,QAAsC,CAAC;QACpE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,UAAU,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC;QACE,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM;QACN,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC;QACrD,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC7C,UAAU,EAAE,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY;QACtD,SAAS;KACV,EACD,GAAG,CACJ,CAAC;IAEF,oEAAoE;IACpE,kFAAkF;IAClF,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,yBAAyB,CAAC;YAC7C,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB;YAClE,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI;YAC9B,UAAU;SACX,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QAClD,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,aAA4C;IAChF,OAAO,oBAAoB,CAA0B;QACnD,WAAW,EAAE,qCAAqC;QAClD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC;QACvF,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EACT,2HAA2H;gBAC7H,OAAO,EAAE,KAAK;aACf;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EACT,8FAA8F;gBAChG,OAAO,EAAE,KAAK;aACf;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,oEAAoE;aAClF;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,gDAAgD;gBAC7D,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;aACnC;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,0CAA0C;gBACvD,YAAY,EAAE,EAAE;gBAChB,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAI,IAAiB,EAAE,GAAG,CAAC;aACnD;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,oDAAoD;gBACjE,YAAY,EAAE,EAAE;gBAChB,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAI,IAAiB,EAAE,GAAG,CAAC;aACnD;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,2CAA2C;gBACxD,OAAO,EAAE,KAAK;aACf;SACF;QACD,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,kDAAkD;gBAC/D,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,IAAI;aACf;SACF;QACD,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,YAAY;QACpB,eAAe,EAAE,yBAAyB;QAC1C,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC;KACxE,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/yagni-gate-mode.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Gate mode for `opensip yagni` (`--gate-save` / `--gate-compare`).
+ *
+ * Host-owned baseline persistence and exit (ADR-0036 / ADR-0035): yagni hands
+ * the fingerprint-stamped envelope to the baseline seams and feeds the findings
+ * verdict to `deliverSignals` runFailed — no tool-side `setExitCode`.
+ */
+import { type ToolCliContext, type ToolRunCompletion } from '@opensip-cli/core';
+export interface YagniGateCommandOptions {
+    readonly cwd: string;
+    readonly json?: boolean;
+    readonly reportTo?: string;
+    readonly apiKey?: string;
+    readonly gateSave?: boolean;
+    readonly gateCompare?: boolean;
+    readonly sarif?: string;
+    readonly minConfidence?: string;
+    readonly detector?: string | string[];
+    readonly category?: string | string[];
+    readonly includeTests?: boolean;
+}
+export declare function runYagniGateMode(opts: YagniGateCommandOptions, cli: ToolCliContext): Promise<ToolRunCompletion | undefined>;
+//# sourceMappingURL=yagni-gate-mode.d.ts.map

package/dist/cli/yagni-gate-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-gate-mode.d.ts","sourceRoot":"","sources":["../../src/cli/yagni-gate-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAQ3B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AA6CD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,uBAAuB,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAqDxC"}

package/dist/cli/yagni-gate-mode.js

@@ -0,0 +1,90 @@
+/**
+ * Gate mode for `opensip yagni` (`--gate-save` / `--gate-compare`).
+ *
+ * Host-owned baseline persistence and exit (ADR-0036 / ADR-0035): yagni hands
+ * the fingerprint-stamped envelope to the baseline seams and feeds the findings
+ * verdict to `deliverSignals` runFailed — no tool-side `setExitCode`.
+ */
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { resolveFailOnDegraded, } from '@opensip-cli/core';
+import { executeYagni } from './execute-yagni.js';
+import { loadYagniConfig } from './yagni-config.js';
+function parseMinConfidence(raw) {
+    if (raw === 'low' || raw === 'medium' || raw === 'high')
+        return raw;
+    return undefined;
+}
+function normalizeRepeatable(raw) {
+    if (raw === undefined)
+        return [];
+    return Array.isArray(raw) ? raw : [raw];
+}
+function renderGateCompareLines(result) {
+    return result.degraded
+        ? [`YAGNI gate FAILED: ${String(result.added.length)} new finding(s) since baseline.`]
+        : [
+            `YAGNI gate PASS: no regressions (${String(result.resolved.length)} resolved since baseline).`,
+        ];
+}
+/**
+ * Finalize a gate run: deliver the signal envelope and (when `--sarif` is set)
+ * write the SARIF report. The two are independent I/O — signal egress vs. a
+ * local file write, both read-only over the same envelope — so they run
+ * concurrently. Shared by the gate-save and gate-compare tails (identical
+ * finalize sequence; the only difference is how `runFailed` is derived).
+ */
+async function deliverAndExport(cli, envelope, runFailed, deliverOpts, sarifPath) {
+    const tasks = [cli.deliverSignals(envelope, { ...deliverOpts, runFailed })];
+    if (sarifPath !== undefined && sarifPath !== '') {
+        tasks.push(cli.writeSarif(envelope, sarifPath));
+    }
+    await Promise.all(tasks);
+}
+export async function runYagniGateMode(opts, cli) {
+    if (opts.gateSave === true && opts.gateCompare === true) {
+        await cli.reportFailure({
+            message: 'Error: --gate-save and --gate-compare are mutually exclusive.',
+            exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+            jsonRequested: opts.json === true,
+        });
+        return undefined;
+    }
+    const config = loadYagniConfig(opts.cwd);
+    const outcome = await executeYagni({
+        cwd: opts.cwd,
+        config,
+        minConfidence: parseMinConfidence(opts.minConfidence),
+        detectors: normalizeRepeatable(opts.detector),
+        categories: normalizeRepeatable(opts.category),
+        includeTests: opts.includeTests ?? config.includeTests,
+    }, cli);
+    const deliverOpts = {
+        cwd: opts.cwd,
+        reportTo: opts.reportTo,
+        apiKey: opts.apiKey,
+    };
+    if (opts.gateSave === true) {
+        await cli.saveBaseline('yagni', outcome.envelope);
+        const runFailed = !outcome.envelope.verdict.passed;
+        await cli.render({
+            type: 'gate-done',
+            lines: runFailed
+                ? [
+                    `YAGNI baseline saved (${String(outcome.envelope.signals.length)} signal(s))`,
+                    'YAGNI gate FAILED: findings policy not satisfied.',
+                ]
+                : [`YAGNI baseline saved (${String(outcome.envelope.signals.length)} signal(s))`],
+        });
+        await deliverAndExport(cli, outcome.envelope, runFailed, deliverOpts, opts.sarif);
+        return { session: outcome.session };
+    }
+    const result = await cli.compareBaseline('yagni', outcome.envelope);
+    const runFailed = result.degraded && resolveFailOnDegraded('yagni');
+    await cli.render({
+        type: 'gate-done',
+        lines: renderGateCompareLines(result),
+    });
+    await deliverAndExport(cli, outcome.envelope, runFailed, deliverOpts, opts.sarif);
+    return { session: outcome.session };
+}
+//# sourceMappingURL=yagni-gate-mode.js.map

package/dist/cli/yagni-gate-mode.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensip-cli/yagni",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "license": "Apache-2.0",
   "description": "YAGNI reduction audit for OpenSIP CLI",
   "keywords": [
@@ -54,19 +54,19 @@
     "react": "^19.2.7",
     "typescript": "~6.0.3",
     "zod": "^4.4.3",
-    "@opensip-cli/cli-live": "0.1.13",
-    "@opensip-cli/clone-detection": "0.1.13",
-    "@opensip-cli/contracts": "0.1.13",
-    "@opensip-cli/config": "0.1.13",
-    "@opensip-cli/core": "0.1.13",
-    "@opensip-cli/lang-typescript": "0.1.13",
-    "@opensip-cli/cli-ui": "0.1.13"
+    "@opensip-cli/cli-live": "0.1.15",
+    "@opensip-cli/config": "0.1.15",
+    "@opensip-cli/contracts": "0.1.15",
+    "@opensip-cli/clone-detection": "0.1.15",
+    "@opensip-cli/core": "0.1.15",
+    "@opensip-cli/lang-typescript": "0.1.15",
+    "@opensip-cli/cli-ui": "0.1.15"
   },
   "devDependencies": {
     "@types/node": "^24.13.2",
     "@types/react": "^19.2.17",
     "vitest": "^4.1.8",
-    "@opensip-cli/graph-typescript": "0.1.13"
+    "@opensip-cli/graph-typescript": "0.1.15"
   },
   "scripts": {
     "build": "tsc",