@opensip-cli/yagni 0.1.11

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

@@ -0,0 +1,152 @@
+/**
+ * yagni-command-spec — declarative primary `yagni` command.
+ */
+import { definePrimaryCommand } from '@opensip-cli/core';
+import { YAGNI_LIVE_VIEW_KEY } from '../identity.js';
+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 { buildYagniRunPresentation } from './yagni-presentation.js';
+function parseGraphMode(raw) {
+    if (raw === 'auto' || raw === 'reuse' || raw === 'build' || raw === 'off')
+        return raw;
+    return undefined;
+}
+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 buildYagniLiveArgs(opts, graphMode, pathRoots) {
+    return {
+        cwd: opts.cwd,
+        verbose: opts.verbose === true,
+        quiet: opts.quiet === true,
+        graphMode,
+        minConfidence: parseMinConfidence(opts.minConfidence),
+        detectors: normalizeRepeatable(opts.detector),
+        categories: normalizeRepeatable(opts.category),
+        includeTests: opts.includeTests,
+        pathRoots,
+    };
+}
+async function deliverYagniRun(opts, cli, config, outcome) {
+    await cli.deliverSignals(outcome.envelope, {
+        cwd: opts.cwd,
+        reportTo: opts.reportTo,
+        apiKey: opts.apiKey,
+    });
+    await cli.maybeOpenReport({
+        openRequested: opts.open === true,
+        jsonOutput: opts.json === true,
+    });
+    // Re-affirm after delivery (--report-to may set exit 4; advisory policy wins otherwise).
+    applyAdvisoryExitCode(cli, config);
+}
+async function runYagniCommand(rawOpts, cli, setUpLiveView) {
+    const opts = rawOpts;
+    const config = loadYagniConfig(opts.cwd);
+    const graphMode = parseGraphMode(opts.graph) ?? config.graphMode ?? 'auto';
+    const positionals = opts._args ?? [];
+    const paths = (positionals[0] ?? []);
+    const pathRoots = paths.length > 0 ? resolveYagniPositionalPaths(paths, opts.cwd) : undefined;
+    const useLiveView = opts.json !== true && process.stdout.isTTY === true && pathRoots === undefined;
+    if (useLiveView) {
+        setUpLiveView(cli);
+        const completion = await cli.renderLive(YAGNI_LIVE_VIEW_KEY, buildYagniLiveArgs(opts, graphMode, pathRoots));
+        const envelope = completion?.envelope;
+        if (envelope !== undefined) {
+            await deliverYagniRun(opts, cli, config, { envelope });
+        }
+        return completion ?? {};
+    }
+    const startedAt = Date.now();
+    const outcome = await executeYagni({
+        cwd: opts.cwd,
+        config,
+        graphMode,
+        minConfidence: parseMinConfidence(opts.minConfidence),
+        detectors: normalizeRepeatable(opts.detector),
+        categories: normalizeRepeatable(opts.category),
+        includeTests: opts.includeTests ?? config.includeTests,
+        pathRoots,
+    }, cli);
+    // Clear exit codes leaked by in-process `executeGraph` before the host wraps
+    // the envelope (emitEnvelope snapshots getExitCode at write time).
+    applyAdvisoryExitCode(cli, config);
+    if (opts.json === true) {
+        cli.emitEnvelope(outcome.envelope);
+    }
+    else {
+        const durationMs = Math.max(0, Date.now() - startedAt);
+        const presentation = buildYagniRunPresentation({
+            envelope: outcome.envelope,
+            cwd: opts.cwd,
+            graphMode: outcome.session.payload.summary.graphMode ?? graphMode,
+            skippedDetectors: outcome.session.payload.summary.skippedDetectors,
+            verbose: opts.verbose === true,
+            durationMs,
+        });
+        await cli.render(presentation);
+    }
+    await deliverYagniRun(opts, cli, config, outcome);
+    return { session: outcome.session };
+}
+export function buildYagniCommandSpec(setUpLiveView) {
+    return definePrimaryCommand({
+        description: 'Run YAGNI reduction audit detectors (advisory; exit 0 by default)',
+        commonFlags: ['cwd', 'json', 'quiet', 'verbose', 'debug', 'reportTo', 'apiKey', 'open'],
+        options: [
+            {
+                flag: '--graph',
+                value: '<mode>',
+                description: 'Graph evidence mode: auto (reuse or build), reuse, build, or off (default from config)',
+                choices: ['auto', 'reuse', 'build', 'off'],
+            },
+            {
+                flag: '--min-confidence',
+                value: '<level>',
+                description: 'Minimum confidence level: low, medium, or high',
+                choices: ['low', 'medium', 'high'],
+            },
+            {
+                flag: '--detector',
+                value: '<slug>',
+                description: 'Run only the named detector (repeatable)',
+                arrayDefault: [],
+                parse: (val, prev) => [...prev, val],
+            },
+            {
+                flag: '--category',
+                value: '<name>',
+                description: 'Filter findings by reduction category (repeatable)',
+                arrayDefault: [],
+                parse: (val, prev) => [...prev, val],
+            },
+            {
+                flag: '--include-tests',
+                description: 'Include test and fixture code in analysis',
+                default: false,
+            },
+        ],
+        args: [
+            {
+                name: 'paths',
+                description: 'Limit analysis to one or more directory subtrees',
+                variadic: true,
+                optional: true,
+            },
+        ],
+        scope: 'project',
+        output: 'raw-stream',
+        rawStreamReason: 'runtime-render-dispatch',
+        handler: (rawOpts, cli) => runYagniCommand(rawOpts, cli, setUpLiveView),
+    });
+}
+//# sourceMappingURL=yagni-command-spec.js.map

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

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

package/dist/cli/yagni-config-schema.d.ts

@@ -0,0 +1,28 @@
+/**
+ * yagni-config-schema — the YAGNI tool's namespaced Zod config schema.
+ *
+ * Mirrors {@link YagniConfig} one-for-one. Gate keys (`failOnErrors` /
+ * `failOnWarnings`) default to `0` so advisory findings never fail the run.
+ */
+import { z } from 'zod';
+import type { ToolConfigDeclaration } from '@opensip-cli/config';
+export declare const YagniConfigSchema: z.ZodObject<{
+    failOnErrors: z.ZodOptional<z.ZodNumber>;
+    failOnWarnings: z.ZodOptional<z.ZodNumber>;
+    defaultMinConfidence: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    graphMode: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        reuse: "reuse";
+        build: "build";
+        off: "off";
+    }>>;
+    includeTests: z.ZodOptional<z.ZodBoolean>;
+    disabledDetectors: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    detectorSettings: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+}, z.core.$strip>;
+export declare const yagniConfigDeclaration: ToolConfigDeclaration;
+//# sourceMappingURL=yagni-config-schema.d.ts.map

package/dist/cli/yagni-config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-config-schema.d.ts","sourceRoot":"","sources":["../../src/cli/yagni-config-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAKjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;iBAQ5B,CAAC;AAMH,eAAO,MAAM,sBAAsB,EAAE,qBAmBpC,CAAC"}

package/dist/cli/yagni-config-schema.js

@@ -0,0 +1,39 @@
+/**
+ * yagni-config-schema — the YAGNI tool's namespaced Zod config schema.
+ *
+ * Mirrors {@link YagniConfig} one-for-one. Gate keys (`failOnErrors` /
+ * `failOnWarnings`) default to `0` so advisory findings never fail the run.
+ */
+import { z } from 'zod';
+const graphMode = z.enum(['auto', 'reuse', 'build', 'off']);
+const confidenceLevel = z.enum(['low', 'medium', 'high']);
+export const YagniConfigSchema = z.object({
+    failOnErrors: z.number().int().min(0).optional(),
+    failOnWarnings: z.number().int().min(0).optional(),
+    defaultMinConfidence: confidenceLevel.optional(),
+    graphMode: graphMode.optional(),
+    includeTests: z.boolean().optional(),
+    disabledDetectors: z.array(z.string().min(1)).readonly().optional(),
+    detectorSettings: z.record(z.string(), z.record(z.string(), z.unknown())).readonly().optional(),
+});
+export const yagniConfigDeclaration = {
+    namespace: 'yagni',
+    schema: YagniConfigSchema,
+    defaults: {
+        failOnErrors: 0,
+        failOnWarnings: 0,
+        defaultMinConfidence: 'medium',
+        graphMode: 'auto',
+        includeTests: false,
+    },
+    env: [
+        { envVar: 'OPENSIP_YAGNI_GRAPH_MODE', key: 'graphMode' },
+        { envVar: 'OPENSIP_YAGNI_MIN_CONFIDENCE', key: 'defaultMinConfidence' },
+        {
+            envVar: 'OPENSIP_YAGNI_INCLUDE_TESTS',
+            key: 'includeTests',
+            type: 'boolean',
+        },
+    ],
+};
+//# sourceMappingURL=yagni-config-schema.js.map

package/dist/cli/yagni-config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-config-schema.js","sourceRoot":"","sources":["../../src/cli/yagni-config-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAC5D,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClD,oBAAoB,EAAE,eAAe,CAAC,QAAQ,EAAE;IAChD,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnE,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAChG,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,sBAAsB,GAA0B;IAC3D,SAAS,EAAE,OAAO;IAClB,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE;QACR,YAAY,EAAE,CAAC;QACf,cAAc,EAAE,CAAC;QACjB,oBAAoB,EAAE,QAAQ;QAC9B,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,KAAK;KACpB;IACD,GAAG,EAAE;QACH,EAAE,MAAM,EAAE,0BAA0B,EAAE,GAAG,EAAE,WAAW,EAAE;QACxD,EAAE,MAAM,EAAE,8BAA8B,EAAE,GAAG,EAAE,sBAAsB,EAAE;QACvE;YACE,MAAM,EAAE,6BAA6B;YACrC,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,SAAS;SAChB;KACF;CACF,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * yagni-config — load the resolved `yagni:` block of `opensip-cli.config.yml`
+ * into a {@link YagniConfig}.
+ *
+ * ADR-0023, Phase 4: the resolved `yagni:` block rides on the per-run scope
+ * (`scope.toolConfig.yagni`) — the host already strict-validated +
+ * precedence-resolved (flag > env > file > defaults) the whole document before
+ * dispatch, using yagni's own namespaced {@link YagniConfigSchema} (the same
+ * schema yagni contributes via `yagniConfigDeclaration`). So when a scope is
+ * present (every CLI dispatch path goes through the pre-action hook) this returns
+ * the SCOPE value and does NOT re-read YAML — mirroring `loadGraphConfig` /
+ * `readSimulationRecipe`. The YAML read below is the fallback for a scope-less
+ * direct caller (a unit test driving `loadYagniConfig`); there it stays
+ * best-effort: a missing config, malformed YAML, an absent `yagni:` key, or a
+ * block that fails the schema all collapse to the merged defaults.
+ *
+ * This loader is the yagni peer of graph's `graph-config.ts` and sim's
+ * `sim-config.ts` config-loader bridges — it is allowlisted in the
+ * `dogfood-one-config-document-ratchet` check's sanctioned config readers for
+ * exactly this reason.
+ */
+import type { YagniConfig } from '../types/yagni-config.js';
+/**
+ * Load the `yagni:` namespace for a run. Prefers the host-resolved scope value.
+ */
+export declare function loadYagniConfig(cwd: string, explicitPath?: string): YagniConfig;
+//# sourceMappingURL=yagni-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-config.d.ts","sourceRoot":"","sources":["../../src/cli/yagni-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAoB5D;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CA0B/E"}

package/dist/cli/yagni-config.js

@@ -0,0 +1,72 @@
+/**
+ * yagni-config — load the resolved `yagni:` block of `opensip-cli.config.yml`
+ * into a {@link YagniConfig}.
+ *
+ * ADR-0023, Phase 4: the resolved `yagni:` block rides on the per-run scope
+ * (`scope.toolConfig.yagni`) — the host already strict-validated +
+ * precedence-resolved (flag > env > file > defaults) the whole document before
+ * dispatch, using yagni's own namespaced {@link YagniConfigSchema} (the same
+ * schema yagni contributes via `yagniConfigDeclaration`). So when a scope is
+ * present (every CLI dispatch path goes through the pre-action hook) this returns
+ * the SCOPE value and does NOT re-read YAML — mirroring `loadGraphConfig` /
+ * `readSimulationRecipe`. The YAML read below is the fallback for a scope-less
+ * direct caller (a unit test driving `loadYagniConfig`); there it stays
+ * best-effort: a missing config, malformed YAML, an absent `yagni:` key, or a
+ * block that fails the schema all collapse to the merged defaults.
+ *
+ * This loader is the yagni peer of graph's `graph-config.ts` and sim's
+ * `sim-config.ts` config-loader bridges — it is allowlisted in the
+ * `dogfood-one-config-document-ratchet` check's sanctioned config readers for
+ * exactly this reason.
+ */
+import { currentScope, readYamlFile, resolveProjectConfigPath } from '@opensip-cli/core';
+import { DEFAULT_YAGNI_CONFIG } from '../types/yagni-config.js';
+import { YagniConfigSchema } from './yagni-config-schema.js';
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function mergeDefaults(parsed) {
+    return {
+        failOnErrors: parsed.failOnErrors ?? DEFAULT_YAGNI_CONFIG.failOnErrors,
+        failOnWarnings: parsed.failOnWarnings ?? DEFAULT_YAGNI_CONFIG.failOnWarnings,
+        defaultMinConfidence: parsed.defaultMinConfidence ?? DEFAULT_YAGNI_CONFIG.defaultMinConfidence,
+        graphMode: parsed.graphMode ?? DEFAULT_YAGNI_CONFIG.graphMode,
+        includeTests: parsed.includeTests ?? DEFAULT_YAGNI_CONFIG.includeTests,
+        ...(parsed.disabledDetectors === undefined
+            ? {}
+            : { disabledDetectors: parsed.disabledDetectors }),
+        ...(parsed.detectorSettings === undefined ? {} : { detectorSettings: parsed.detectorSettings }),
+    };
+}
+/**
+ * Load the `yagni:` namespace for a run. Prefers the host-resolved scope value.
+ */
+export function loadYagniConfig(cwd, explicitPath) {
+    // Scope-first: the resolved, strict-validated `yagni:` block (env/flag
+    // precedence already folded in by the composer). Present on every CLI dispatch
+    // path; absent only off-CLI (direct unit-test calls), where we fall back to the
+    // YAML read below.
+    const scope = currentScope();
+    const scoped = scope?.toolConfig?.yagni;
+    if (isPlainObject(scoped)) {
+        const parsed = YagniConfigSchema.safeParse(scoped);
+        if (parsed.success)
+            return mergeDefaults(parsed.data);
+    }
+    if (scope !== undefined) {
+        // A scope-bound dispatch has already had its config composed. If there is no
+        // resolved `yagni:` block, do not perform a second YAML read; use the merged
+        // tool defaults instead (mirrors loadGraphConfig / readSimulationRecipe).
+        return mergeDefaults({});
+    }
+    const configPath = resolveProjectConfigPath(cwd, explicitPath);
+    const doc = readYamlFile(configPath);
+    if (!isPlainObject(doc) || !isPlainObject(doc.yagni)) {
+        return mergeDefaults({});
+    }
+    const parsed = YagniConfigSchema.safeParse(doc.yagni);
+    if (!parsed.success)
+        return mergeDefaults({});
+    return mergeDefaults(parsed.data);
+}
+//# sourceMappingURL=yagni-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-config.js","sourceRoot":"","sources":["../../src/cli/yagni-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAEzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,aAAa,CAAC,MAAmB;IACxC,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,oBAAoB,CAAC,YAAY;QACtE,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,oBAAoB,CAAC,cAAc;QAC5E,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,oBAAoB,CAAC,oBAAoB;QAC9F,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,oBAAoB,CAAC,SAAS;QAC7D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,oBAAoB,CAAC,YAAY;QACtE,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACpD,GAAG,CAAC,MAAM,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC;KAChG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,YAAqB;IAChE,uEAAuE;IACvE,+EAA+E;IAC/E,gFAAgF;IAChF,mBAAmB;IACnB,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC;IACxC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,6EAA6E;QAC7E,6EAA6E;QAC7E,0EAA0E;QAC1E,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,UAAU,GAAG,wBAAwB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;IAC9C,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Human presentation for YAGNI audit runs (spec §11).
+ */
+import type { SkippedDetector } from '../detectors/types.js';
+import type { RunPresentation, SignalEnvelope } from '@opensip-cli/contracts';
+export declare function buildYagniPresentationLines(envelope: SignalEnvelope, cwd: string, graphMode: string, skippedDetectors: readonly SkippedDetector[], verbose: boolean): string[];
+export declare function buildYagniRunPresentation(input: {
+    readonly envelope: SignalEnvelope;
+    readonly cwd: string;
+    readonly graphMode: string;
+    readonly skippedDetectors: readonly SkippedDetector[];
+    readonly verbose: boolean;
+    readonly durationMs?: number;
+}): RunPresentation;
+//# sourceMappingURL=yagni-presentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-presentation.d.ts","sourceRoot":"","sources":["../../src/cli/yagni-presentation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAiB,MAAM,wBAAwB,CAAC;AAqD7F,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,SAAS,eAAe,EAAE,EAC5C,OAAO,EAAE,OAAO,GACf,MAAM,EAAE,CA8BV;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;IACtD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,eAAe,CAelB"}

package/dist/cli/yagni-presentation.js

@@ -0,0 +1,92 @@
+/**
+ * Human presentation for YAGNI audit runs (spec §11).
+ */
+import { relative } from 'node:path';
+import { buildYagniRunSummary, readYagniMetadata } from '../scoring/confidence.js';
+const CONFIDENCE_SECTION_ORDER = ['high', 'medium', 'low'];
+function formatYagniSignalLocation(signal, cwd) {
+    if (signal.filePath === '')
+        return '<unknown>';
+    const rel = relative(cwd, signal.filePath).split('\\').join('/');
+    return signal.line === undefined ? rel : `${rel}:${String(signal.line)}`;
+}
+function formatLocSuffix(signal) {
+    const meta = readYagniMetadata(signal);
+    if (meta?.locDelta === undefined)
+        return '';
+    const { netEstimate, estimateKind } = meta.locDelta;
+    return `(~${String(netEstimate)} LOC, ${estimateKind})`;
+}
+function formatCandidateBlock(signal, cwd, verbose) {
+    const meta = readYagniMetadata(signal);
+    if (meta === undefined)
+        return [];
+    const loc = formatYagniSignalLocation(signal, cwd);
+    const block = [
+        `  ${meta.reductionCategory.padEnd(6)} ${meta.detector.padEnd(28)} ${loc}`,
+        `           → ${meta.suggestedAction.padEnd(44)} ${formatLocSuffix(signal)}`,
+    ];
+    if (!verbose)
+        return block;
+    block.push(`           preservation: ${meta.preservationArgument}`);
+    if (meta.validationRequired.length > 0) {
+        block.push(`           validation: ${meta.validationRequired.join('; ')}`);
+    }
+    if (meta.riskTags.length > 0) {
+        block.push(`           risks: ${meta.riskTags.join(', ')}`);
+    }
+    for (const ev of meta.evidence) {
+        block.push(`           evidence [${ev.kind}]: ${ev.summary}`);
+    }
+    return block;
+}
+function candidateLines(signals, cwd, verbose) {
+    const lines = [];
+    for (const confidence of CONFIDENCE_SECTION_ORDER) {
+        const bucket = signals.filter((s) => readYagniMetadata(s)?.confidence === confidence);
+        if (bucket.length === 0)
+            continue;
+        lines.push('', `${confidence.charAt(0).toUpperCase()}${confidence.slice(1)} confidence`);
+        for (const signal of bucket) {
+            lines.push(...formatCandidateBlock(signal, cwd, verbose));
+        }
+    }
+    return lines;
+}
+export function buildYagniPresentationLines(envelope, cwd, graphMode, skippedDetectors, verbose) {
+    const summary = buildYagniRunSummary(envelope.signals, graphMode, skippedDetectors);
+    const visibleSignals = verbose
+        ? envelope.signals
+        : envelope.signals.filter((s) => {
+            const conf = readYagniMetadata(s)?.confidence;
+            return conf === 'high' || conf === 'medium';
+        });
+    const { high, medium } = summary.byConfidence;
+    const headline = `YAGNI audit: ${String(summary.totalCandidates)} reduction candidates (${String(high)} high, ${String(medium)} medium)`;
+    const ran = envelope.units.length;
+    const skipped = skippedDetectors.length;
+    const metaLine = `Graph: ${graphMode} · ${String(ran)} detectors ran · ${String(skipped)} skipped`;
+    const lines = [headline, metaLine, ...candidateLines(visibleSignals, cwd, verbose)];
+    if (summary.estimatedTotalLocReduction > 0) {
+        lines.push('', `net: ~${String(summary.estimatedTotalLocReduction)} LOC possible`);
+    }
+    if (verbose && skippedDetectors.length > 0) {
+        lines.push('', 'Skipped detectors:');
+        for (const skip of skippedDetectors) {
+            const detail = skip.detail === undefined ? '' : ` (${skip.detail})`;
+            lines.push(`  ${skip.slug}: ${skip.reason}${detail}`);
+        }
+    }
+    return lines;
+}
+export function buildYagniRunPresentation(input) {
+    const lines = buildYagniPresentationLines(input.envelope, input.cwd, input.graphMode, input.skippedDetectors, input.verbose);
+    return {
+        type: 'run-presentation',
+        tool: 'yagni',
+        envelope: input.envelope,
+        ...(input.verbose ? { verboseDetail: { kind: 'lines', lines } } : {}),
+        ...(input.durationMs === undefined ? {} : { durationMs: input.durationMs }),
+    };
+}
+//# sourceMappingURL=yagni-presentation.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * yagni-runner — live-view entry for `opensip yagni` via @opensip-cli/cli-live.
+ */
+import { type LiveViewContext, type ToolCliContext } from '@opensip-cli/core';
+import type { YagniGraphMode } from '../types/yagni-config.js';
+import type { YagniConfidence } from '../types/yagni-metadata.js';
+export { YAGNI_LIVE_VIEW_KEY } from '../identity.js';
+export interface YagniLiveArgs {
+    readonly cwd: string;
+    readonly verbose?: boolean;
+    readonly quiet?: boolean;
+    readonly graphMode: YagniGraphMode;
+    readonly minConfidence?: YagniConfidence;
+    readonly detectors?: readonly string[];
+    readonly categories?: readonly string[];
+    readonly includeTests?: boolean;
+    readonly pathRoots?: readonly string[];
+}
+export declare function renderYagniLive(args: YagniLiveArgs, cli: ToolCliContext, liveContext?: LiveViewContext): Promise<import("@opensip-cli/core").ToolRunCompletion>;
+//# sourceMappingURL=yagni-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-runner.d.ts","sourceRoot":"","sources":["../../src/cli/yagni-runner.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AASlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,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;CACxC;AA2BD,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,cAAc,EACnB,WAAW,CAAC,EAAE,eAAe,0DAmE9B"}

package/dist/cli/yagni-runner.js

@@ -0,0 +1,95 @@
+/**
+ * yagni-runner — live-view entry for `opensip yagni` via @opensip-cli/cli-live.
+ */
+import { runToolLiveView } from '@opensip-cli/cli-live';
+import { groupSignalsBySource } from '@opensip-cli/contracts';
+import { isErrorSignal, currentScope, } from '@opensip-cli/core';
+import { executeYagni } from './execute-yagni.js';
+import { loadYagniConfig } from './yagni-config.js';
+import { buildYagniPresentationLines } from './yagni-presentation.js';
+const YAGNI_TOOL_TITLE = 'YAGNI Audit';
+const YAGNI_TOOL_DESCRIPTION = 'Scanning for speculative surface to remove.';
+const YAGNI_RUNNING_SURFACE = { shape: 'pool', label: 'Running detectors...' };
+const YAGNI_LOADING_SURFACE = { shape: 'pool', label: 'Loading detectors...' };
+export { YAGNI_LIVE_VIEW_KEY } from '../identity.js';
+function rowStatus(unit) {
+    if (unit.error !== undefined)
+        return 'ERROR';
+    return unit.passed ? 'PASS' : 'FAIL';
+}
+function envelopeToLiveRunTableRows(envelope) {
+    const bySource = groupSignalsBySource(envelope.signals);
+    return envelope.units.map((unit) => {
+        const unitSignals = bySource.get(unit.slug) ?? [];
+        let errors = 0;
+        let warnings = 0;
+        for (const s of unitSignals) {
+            if (isErrorSignal(s))
+                errors += 1;
+            else
+                warnings += 1;
+        }
+        return {
+            unit: unit.slug,
+            status: rowStatus(unit),
+            errors,
+            warnings,
+            durationMs: unit.durationMs,
+        };
+    });
+}
+export async function renderYagniLive(args, cli, liveContext) {
+    const config = loadYagniConfig(args.cwd);
+    return runToolLiveView({
+        tool: 'yagni',
+        meta: { title: YAGNI_TOOL_TITLE, description: YAGNI_TOOL_DESCRIPTION },
+        surface: YAGNI_RUNNING_SURFACE,
+        loadingSurface: YAGNI_LOADING_SURFACE,
+        verbose: args.verbose === true,
+        quiet: args.quiet === true,
+        projectPath: args.cwd,
+        walkedUp: currentScope()?.projectContext?.walkedUp,
+        produce: async (emit, helpers) => {
+            emit({ type: 'stage-start', stage: 'detectors', label: 'Running detectors...' });
+            helpers.setRunning(() => {
+                // In-process run — progress events flow through emit() directly.
+            });
+            const executeOpts = {
+                cwd: args.cwd,
+                config,
+                graphMode: args.graphMode,
+                minConfidence: args.minConfidence,
+                detectors: args.detectors,
+                categories: args.categories,
+                includeTests: args.includeTests,
+                pathRoots: args.pathRoots,
+                onProgress: (completed, total) => {
+                    emit({ type: 'stage-progress', stage: 'detectors', completed, total });
+                },
+            };
+            const outcome = await executeYagni(executeOpts, cli);
+            const graphMode = outcome.session.payload.summary.graphMode ?? args.graphMode;
+            const skippedDetectors = outcome.session.payload.summary.skippedDetectors;
+            const verboseLines = buildYagniPresentationLines(outcome.envelope, args.cwd, graphMode, skippedDetectors, args.verbose === true);
+            return {
+                kind: 'done',
+                done: {
+                    summary: {
+                        passed: outcome.envelope.verdict.passed,
+                        errors: outcome.envelope.verdict.summary.errors,
+                        warnings: outcome.envelope.verdict.summary.warnings,
+                    },
+                    ...(args.verbose === true
+                        ? {
+                            verboseLines,
+                            table: envelopeToLiveRunTableRows(outcome.envelope),
+                        }
+                        : {}),
+                },
+                envelope: outcome.envelope,
+                session: outcome.session,
+            };
+        },
+    }, { liveContext, setExitCode: cli.setExitCode });
+}
+//# sourceMappingURL=yagni-runner.js.map

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

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

package/dist/detectors/create-yagni-signal.d.ts

@@ -0,0 +1,8 @@
+import type { YagniFindingMetadata } from '../types/yagni-metadata.js';
+import type { CreateSignalInput, Signal } from '@opensip-cli/core';
+export interface YagniSignalInput extends Omit<CreateSignalInput, 'metadata'> {
+    readonly yagni: YagniFindingMetadata;
+}
+/** Stamp a finding with full `metadata.yagni` and the canonical rule id shape. */
+export declare function createYagniSignal(input: YagniSignalInput): Signal;
+//# sourceMappingURL=create-yagni-signal.d.ts.map

package/dist/detectors/create-yagni-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-yagni-signal.d.ts","sourceRoot":"","sources":["../../src/detectors/create-yagni-signal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;IAC3E,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAMjE"}

package/dist/detectors/create-yagni-signal.js

@@ -0,0 +1,10 @@
+import { createSignal } from '@opensip-cli/core';
+/** Stamp a finding with full `metadata.yagni` and the canonical rule id shape. */
+export function createYagniSignal(input) {
+    return createSignal({
+        ...input,
+        provider: input.provider ?? 'yagni',
+        metadata: { yagni: input.yagni },
+    });
+}
+//# sourceMappingURL=create-yagni-signal.js.map

package/dist/detectors/create-yagni-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-yagni-signal.js","sourceRoot":"","sources":["../../src/detectors/create-yagni-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,OAAO,YAAY,CAAC;QAClB,GAAG,KAAK;QACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,OAAO;QACnC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/detectors/duplicate-body-candidate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * duplicate-body-candidate — surfaces cross-occurrence duplicate function bodies
+ * from a graph catalog bodyHash grouping as consolidation candidates.
+ */
+import type { YagniDetector } from './types.js';
+export declare const duplicateBodyCandidateDetector: YagniDetector;
+//# sourceMappingURL=duplicate-body-candidate.d.ts.map