@opensip-cli/yagni 0.1.11

package/dist/scoring/confidence.js

@@ -0,0 +1,106 @@
+const CONFIDENCE_RANK = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+const ESTIMATE_KIND_RANK = {
+    exact: 3,
+    'lower-bound': 2,
+    heuristic: 1,
+};
+const MIN_CONFIDENCE_RANK = {
+    low: 1,
+    medium: 2,
+    high: 3,
+};
+export function readYagniMetadata(signal) {
+    const raw = signal.metadata.yagni;
+    if (typeof raw !== 'object' || raw === null)
+        return undefined;
+    return raw;
+}
+/** Keep findings at or above the configured minimum confidence level. */
+export function filterByMinConfidence(signals, minConfidence) {
+    const floor = MIN_CONFIDENCE_RANK[minConfidence];
+    return signals.filter((signal) => {
+        const meta = readYagniMetadata(signal);
+        if (meta === undefined)
+            return true;
+        return CONFIDENCE_RANK[meta.confidence] >= floor;
+    });
+}
+export function filterByReductionCategories(signals, categories) {
+    if (categories.length === 0)
+        return [...signals];
+    const allowed = new Set(categories);
+    return signals.filter((signal) => {
+        const meta = readYagniMetadata(signal);
+        if (meta === undefined)
+            return true;
+        return allowed.has(meta.reductionCategory);
+    });
+}
+function locationKey(signal) {
+    const line = signal.line ?? 0;
+    const col = signal.column ?? 0;
+    return `${signal.filePath}:${String(line)}:${String(col)}`;
+}
+/** Stable sort: confidence DESC → estimateKind → netEstimate DESC → detector → location. */
+export function sortYagniSignals(signals) {
+    return [...signals].sort((a, b) => {
+        const ma = readYagniMetadata(a);
+        const mb = readYagniMetadata(b);
+        const confA = ma ? CONFIDENCE_RANK[ma.confidence] : 0;
+        const confB = mb ? CONFIDENCE_RANK[mb.confidence] : 0;
+        if (confA !== confB)
+            return confB - confA;
+        const kindA = ma?.locDelta ? ESTIMATE_KIND_RANK[ma.locDelta.estimateKind] : 0;
+        const kindB = mb?.locDelta ? ESTIMATE_KIND_RANK[mb.locDelta.estimateKind] : 0;
+        if (kindA !== kindB)
+            return kindB - kindA;
+        const netA = ma?.locDelta?.netEstimate ?? 0;
+        const netB = mb?.locDelta?.netEstimate ?? 0;
+        if (netA !== netB)
+            return netB - netA;
+        const detA = ma?.detector ?? '';
+        const detB = mb?.detector ?? '';
+        if (detA !== detB)
+            return detA.localeCompare(detB);
+        return locationKey(a).localeCompare(locationKey(b));
+    });
+}
+export function buildYagniRunSummary(signals, graphMode, skippedDetectors) {
+    let high = 0;
+    let medium = 0;
+    let low = 0;
+    let estimatedTotalLocReduction = 0;
+    for (const signal of signals) {
+        const meta = readYagniMetadata(signal);
+        if (meta === undefined)
+            continue;
+        if (meta.confidence === 'high')
+            high += 1;
+        else if (meta.confidence === 'medium')
+            medium += 1;
+        else
+            low += 1;
+        if (meta.locDelta !== undefined) {
+            estimatedTotalLocReduction += meta.locDelta.netEstimate;
+        }
+    }
+    return {
+        totalCandidates: signals.length,
+        byConfidence: { high, medium, low },
+        estimatedTotalLocReduction,
+        graphMode,
+        skippedDetectors: skippedDetectors.map((s) => ({
+            slug: s.slug,
+            reason: s.reason,
+            ...(s.detail === undefined ? {} : { detail: s.detail }),
+        })),
+    };
+}
+export function severityForConfidence(confidence) {
+    return confidence === 'high' ? 'medium' : 'low';
+}
+//# sourceMappingURL=confidence.js.map

package/dist/scoring/confidence.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * yagniTool — YAGNI reduction audit as a Tool plugin.
+ */
+import { type Tool } from '@opensip-cli/core';
+/**
+ * Per-tool contract version (ADR-0047).
+ */
+export declare const YAGNI_CONTRACT_VERSION = "1.0.0";
+export declare const YAGNI_STABLE_ID = "3aba9195-2297-4f20-99d5-906945092dfc";
+export declare const yagniTool: Tool;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAuD,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AASnG;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C,eAAO,MAAM,eAAe,yCAAyC,CAAC;AAQtE,eAAO,MAAM,SAAS,EAAE,IAkBtB,CAAC"}

package/dist/tool.js

@@ -0,0 +1,38 @@
+/**
+ * yagniTool — YAGNI reduction audit as a Tool plugin.
+ */
+import { defineTool, readPackageVersion } from '@opensip-cli/core';
+import { yagniFingerprintStrategy } from './baseline-strategy.js';
+import { collectYagniReportData } from './cli/report-data.js';
+import { buildYagniCommandSpec } from './cli/yagni-command-spec.js';
+import { yagniConfigDeclaration } from './cli/yagni-config-schema.js';
+import { renderYagniLive } from './cli/yagni-runner.js';
+import { YAGNI_IDENTITY, YAGNI_LIVE_VIEW_KEY } from './identity.js';
+/**
+ * Per-tool contract version (ADR-0047).
+ */
+export const YAGNI_CONTRACT_VERSION = '1.0.0';
+export const YAGNI_STABLE_ID = '3aba9195-2297-4f20-99d5-906945092dfc';
+function setUpYagniLiveView(cli) {
+    cli.registerLiveView(YAGNI_LIVE_VIEW_KEY, async (args, liveContext) => renderYagniLive(args, cli, liveContext));
+}
+export const yagniTool = defineTool({
+    identity: YAGNI_IDENTITY,
+    metadata: {
+        id: YAGNI_STABLE_ID,
+        version: readPackageVersion(import.meta.url),
+        description: 'YAGNI reduction audit — find speculative surface to remove',
+    },
+    commandSpecs: [buildYagniCommandSpec(setUpYagniLiveView)],
+    extensionPoints: {
+        yagniContractVersion: YAGNI_CONTRACT_VERSION,
+        config: {
+            schema: yagniConfigDeclaration.schema,
+            defaults: yagniConfigDeclaration.defaults,
+            env: yagniConfigDeclaration.env,
+        },
+        collectReportData: collectYagniReportData,
+        fingerprintStrategy: yagniFingerprintStrategy,
+    },
+});
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAkC,MAAM,mBAAmB,CAAC;AAEnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAsB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAC;AAEtE,SAAS,kBAAkB,CAAC,GAAmB;IAC7C,GAAG,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CACpE,eAAe,CAAC,IAAqB,EAAE,GAAG,EAAE,WAAW,CAAC,CACzD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAS,UAAU,CAAC;IACxC,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE;QACR,EAAE,EAAE,eAAe;QACnB,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5C,WAAW,EAAE,4DAA4D;KAC1E;IACD,YAAY,EAAE,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IACzD,eAAe,EAAE;QACf,oBAAoB,EAAE,sBAAsB;QAC5C,MAAM,EAAE;YACN,MAAM,EAAE,sBAAsB,CAAC,MAAM;YACrC,QAAQ,EAAE,sBAAsB,CAAC,QAAQ;YACzC,GAAG,EAAE,sBAAsB,CAAC,GAAG;SAChC;QACD,iBAAiB,EAAE,sBAAsB;QACzC,mBAAmB,EAAE,wBAAwB;KAC9C;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Resolved YAGNI tool configuration — mirrors the `yagni:` namespace block.
+ */
+import type { YagniConfidence } from './yagni-metadata.js';
+/** Graph evidence strategy used by YAGNI graph-backed detectors. */
+export type YagniGraphMode = 'auto' | 'reuse' | 'build' | 'off';
+/** Validated values from the `yagni:` config namespace. */
+export interface YagniConfig {
+    readonly failOnErrors?: number;
+    readonly failOnWarnings?: number;
+    readonly defaultMinConfidence?: YagniConfidence;
+    readonly graphMode?: YagniGraphMode;
+    readonly includeTests?: boolean;
+    readonly disabledDetectors?: readonly string[];
+    readonly detectorSettings?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+}
+export declare const DEFAULT_YAGNI_CONFIG: Required<Pick<YagniConfig, 'failOnErrors' | 'failOnWarnings' | 'defaultMinConfidence' | 'graphMode' | 'includeTests'>>;
+//# sourceMappingURL=yagni-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-config.d.ts","sourceRoot":"","sources":["../../src/types/yagni-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,oEAAoE;AACpE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAEhE,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,eAAe,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACzF;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CACzC,IAAI,CACF,WAAW,EACX,cAAc,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,WAAW,GAAG,cAAc,CAC1F,CAOF,CAAC"}

package/dist/types/yagni-config.js

@@ -0,0 +1,11 @@
+/**
+ * Resolved YAGNI tool configuration — mirrors the `yagni:` namespace block.
+ */
+export const DEFAULT_YAGNI_CONFIG = {
+    failOnErrors: 0,
+    failOnWarnings: 0,
+    defaultMinConfidence: 'medium',
+    graphMode: 'auto',
+    includeTests: false,
+};
+//# sourceMappingURL=yagni-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-config.js","sourceRoot":"","sources":["../../src/types/yagni-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,MAAM,CAAC,MAAM,oBAAoB,GAK7B;IACF,YAAY,EAAE,CAAC;IACf,cAAc,EAAE,CAAC;IACjB,oBAAoB,EAAE,QAAQ;IAC9B,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,KAAK;CACpB,CAAC"}

package/dist/types/yagni-metadata.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Canonical `metadata.yagni` shape stamped on every YAGNI finding signal (spec §7).
+ */
+export type YagniConfidence = 'low' | 'medium' | 'high';
+/** Reduction class used to group YAGNI findings by intended simplification. */
+export type YagniReductionCategory = 'delete' | 'collapse' | 'inline' | 'dedupe' | 'stdlib' | 'native' | 'dependency' | 'config' | 'shrink';
+/** Confidence level for the LOC estimate attached to a finding. */
+export type YagniEstimateKind = 'exact' | 'lower-bound' | 'heuristic';
+/** Estimated line-count impact for applying a reduction candidate. */
+export interface YagniLocDelta {
+    readonly remove: number;
+    readonly add: number;
+    readonly netEstimate: number;
+    readonly estimateKind: YagniEstimateKind;
+}
+/** Evidence item supporting a YAGNI reduction candidate. */
+export interface YagniEvidence {
+    readonly id: string;
+    readonly kind: string;
+    readonly summary: string;
+    readonly data?: Readonly<Record<string, unknown>>;
+}
+/** Metadata payload carried on each YAGNI signal. */
+export interface YagniFindingMetadata {
+    readonly detector: string;
+    readonly reductionCategory: YagniReductionCategory;
+    readonly confidence: YagniConfidence;
+    readonly locDelta?: YagniLocDelta;
+    readonly preservationArgument: string;
+    readonly suggestedAction: string;
+    readonly validationRequired: readonly string[];
+    readonly riskTags: readonly string[];
+    readonly evidence: readonly YagniEvidence[];
+}
+/** Aggregate summary persisted with a YAGNI run session. */
+export interface YagniRunSummary {
+    readonly totalCandidates: number;
+    readonly byConfidence: {
+        readonly high: number;
+        readonly medium: number;
+        readonly low: number;
+    };
+    readonly estimatedTotalLocReduction: number;
+    readonly graphMode: string;
+    readonly skippedDetectors: readonly {
+        readonly slug: string;
+        readonly reason: string;
+        readonly detail?: string;
+    }[];
+}
+//# sourceMappingURL=yagni-metadata.d.ts.map

package/dist/types/yagni-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-metadata.d.ts","sourceRoot":"","sources":["../../src/types/yagni-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,QAAQ,CAAC;AAEb,mEAAmE;AACnE,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,CAAC;AAEtE,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAC1C;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,SAAS;QAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B,EAAE,CAAC;CACL"}

package/dist/types/yagni-metadata.js

@@ -0,0 +1,5 @@
+/**
+ * Canonical `metadata.yagni` shape stamped on every YAGNI finding signal (spec §7).
+ */
+export {};
+//# sourceMappingURL=yagni-metadata.js.map

package/dist/types/yagni-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yagni-metadata.js","sourceRoot":"","sources":["../../src/types/yagni-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@opensip-cli/yagni",
+  "version": "0.1.11",
+  "license": "Apache-2.0",
+  "description": "YAGNI reduction audit for OpenSIP CLI",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/yagni/engine"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "opensipTools": {
+    "kind": "tool",
+    "id": "yagni",
+    "identity": {
+      "name": "yagni",
+      "aliases": [
+        "yag"
+      ]
+    },
+    "stableId": "3aba9195-2297-4f20-99d5-906945092dfc",
+    "apiVersion": 1,
+    "commands": [
+      {
+        "name": "yagni",
+        "aliases": [
+          "yag"
+        ],
+        "description": "Run YAGNI reduction audit detectors"
+      }
+    ]
+  },
+  "dependencies": {
+    "commander": "^15.0.0",
+    "react": "^19.2.7",
+    "typescript": "~6.0.3",
+    "zod": "^4.4.3",
+    "@opensip-cli/cli-live": "0.1.11",
+    "@opensip-cli/cli-ui": "0.1.11",
+    "@opensip-cli/config": "0.1.11",
+    "@opensip-cli/contracts": "0.1.11",
+    "@opensip-cli/core": "0.1.11",
+    "@opensip-cli/datastore": "0.1.11",
+    "@opensip-cli/graph": "0.1.11",
+    "@opensip-cli/lang-typescript": "0.1.11"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "@types/react": "^19.2.17",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}