@aligndottech/cli 0.65.2 → 0.66.1

package/dist/lib/stale-code.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Code still built on a replaced decision.
+ *
+ * For each `supersedes` link (new replaces old) take the OLD decision's source, find the commit it
+ * names, list the files that commit touched, and `git blame` those files on the default branch. A line
+ * whose blame is still that commit has not been rewritten since the decision it came from was replaced.
+ * That is a fact about history, not a verdict: the line may be fine. Everything is local git, no model.
+ */
+export interface StaleLink {
+    oldId: string;
+    oldTitle: string;
+    oldSourceUrl: string | null;
+    newId: string;
+    newTitle: string;
+    newSourceUrl: string | null;
+    confidence: number;
+    /** A person confirmed the link. False means a classifier wrote it. */
+    humanConfirmed: boolean;
+}
+export interface StaleOptions {
+    cwd: string;
+    /** Also use links a classifier wrote and no person confirmed. Default false. */
+    includeAi?: boolean;
+    /** Most files blamed for one old decision. */
+    maxFilesPerDecision?: number;
+    /** Wall-clock budget for the whole run. */
+    budgetMs?: number;
+}
+export type LineRange = [start: number, end: number];
+export interface StaleFileHit {
+    file: string;
+    lines: number;
+    ranges: LineRange[];
+}
+export interface StaleFinding {
+    replaced: {
+        id: string;
+        title: string;
+        sourceUrl: string | null;
+    };
+    replacedBy: {
+        id: string;
+        title: string;
+        sourceUrl: string | null;
+    };
+    commit: string;
+    confirmation: 'confirmed' | 'ai-suggested';
+    /** Present for an AI-suggested link, so the reader can weigh it. */
+    confidence?: number;
+    files: StaleFileHit[];
+    totalLines: number;
+}
+export interface StaleSkip {
+    decisionId: string;
+    title: string;
+    reason: string;
+}
+export interface StaleReport {
+    findings: StaleFinding[];
+    skipped: StaleSkip[];
+    /** Per-decision file cap hits: old decisions with more touched files than the cap. */
+    filesCapped: number;
+    budgetExceeded: boolean;
+    linksConsidered: number;
+    /** AI-suggested links left out because --include-ai was not set. */
+    aiExcluded: number;
+    ref: string;
+}
+export declare class StaleError extends Error {
+}
+export declare const DEFAULT_MAX_FILES = 40;
+export declare const DEFAULT_BUDGET_MS = 90000;
+type Git = (args: string[]) => Promise<string>;
+/** The branch decisions land on: origin/HEAD, else main, else master, else the checked-out HEAD. */
+export declare function defaultRef(git: Git): Promise<string>;
+type Source = {
+    kind: 'commit';
+    sha: string;
+    repo: string;
+} | {
+    kind: 'pr';
+    number: string;
+    repo: string;
+};
+export declare function parseSource(url: string | null): Source | null;
+export declare function findStaleCode(links: StaleLink[], opts: StaleOptions): Promise<StaleReport>;
+export {};
+//# sourceMappingURL=stale-code.d.ts.map

package/dist/lib/stale-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-code.d.ts","sourceRoot":"","sources":["../../src/lib/stale-code.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE;AAElF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClE,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,WAAW,GAAG,cAAc,CAAC;IAC3C,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAEhF,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAGxC,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAQ/C,oGAAoG;AACpG,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1D;AAED,KAAK,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3G,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAQ7D;AAiBD,wBAAsB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6DhG"}

package/dist/lib/stale-code.js

@@ -0,0 +1,135 @@
+import { execa } from 'execa';
+import { githubRepoOf, isProseOrGeneratedFile } from './blame-attribution.js';
+export class StaleError extends Error {
+}
+export const DEFAULT_MAX_FILES = 40;
+export const DEFAULT_BUDGET_MS = 90_000;
+const GIT_TIMEOUT_MS = 30_000;
+function gitIn(cwd) {
+    return async (args) => (await execa('git', args, { cwd, timeout: GIT_TIMEOUT_MS, stdin: 'ignore', maxBuffer: 256 * 1024 * 1024 })).stdout;
+}
+const ok = (git, args) => git(args).then(() => true, () => false);
+/** The branch decisions land on: origin/HEAD, else main, else master, else the checked-out HEAD. */
+export async function defaultRef(git) {
+    const head = await git(['symbolic-ref', '--short', 'refs/remotes/origin/HEAD']).catch(() => '');
+    if (head.trim() && await ok(git, ['rev-parse', '--verify', '-q', head.trim()]))
+        return head.trim();
+    for (const name of ['main', 'master'])
+        if (await ok(git, ['rev-parse', '--verify', '-q', name]))
+            return name;
+    return 'HEAD';
+}
+export function parseSource(url) {
+    if (!url)
+        return null;
+    const m = /^https?:\/\/github\.com\/([^/\s]+)\/([^/\s]+)\/(commit|pull)\/([0-9a-f]+|\d+)(?:[/?#].*)?$/i.exec(url.trim());
+    if (!m)
+        return null;
+    const repo = `${m[1]}/${m[2]}`.toLowerCase();
+    if (m[3] === 'commit' && /^[0-9a-f]{7,40}$/i.test(m[4]))
+        return { kind: 'commit', sha: m[4].toLowerCase(), repo };
+    if (m[3] === 'pull' && /^\d+$/.test(m[4]))
+        return { kind: 'pr', number: m[4], repo };
+    return null;
+}
+async function blameRanges(git, ref, file, sha) {
+    const out = await git(['blame', '-w', '-M', '--line-porcelain', ref, '--', file]);
+    const lines = [];
+    for (const row of out.split('\n')) {
+        const m = /^([0-9a-f]{40}) \d+ (\d+)/.exec(row);
+        if (m && m[1] === sha)
+            lines.push(Number(m[2]));
+    }
+    const ranges = [];
+    for (const n of lines) {
+        const last = ranges[ranges.length - 1];
+        if (last && last[1] === n - 1)
+            last[1] = n;
+        else
+            ranges.push([n, n]);
+    }
+    return ranges;
+}
+export async function findStaleCode(links, opts) {
+    const git = gitIn(opts.cwd);
+    if (!await ok(git, ['rev-parse', '--git-dir']))
+        throw new StaleError('This is not a git repository. Run align stale inside the repository to check.');
+    if ((await git(['rev-parse', '--is-shallow-repository'])).trim() === 'true') {
+        throw new StaleError('This is a shallow clone, so the commits that wrote the old code are missing and every result would read as "nothing found". Run `git fetch --unshallow` and try again.');
+    }
+    const ref = await defaultRef(git);
+    const origin = githubRepoOf(await git(['remote', 'get-url', 'origin']).catch(() => ''));
+    const maxFiles = opts.maxFilesPerDecision ?? DEFAULT_MAX_FILES;
+    const deadline = Date.now() + (opts.budgetMs ?? DEFAULT_BUDGET_MS);
+    const usable = opts.includeAi ? links : links.filter((l) => l.humanConfirmed);
+    const report = {
+        findings: [], skipped: [], filesCapped: 0, budgetExceeded: false,
+        linksConsidered: usable.length, aiExcluded: links.length - usable.length, ref,
+    };
+    const hitsBySha = new Map();
+    for (const link of usable) {
+        const skip = (reason) => report.skipped.push({ decisionId: link.oldId, title: link.oldTitle, reason });
+        if (Date.now() > deadline) {
+            report.budgetExceeded = true;
+            skip('time budget used up before this decision');
+            continue;
+        }
+        const src = parseSource(link.oldSourceUrl);
+        if (!src) {
+            skip('its source is not a GitHub commit or pull request link');
+            continue;
+        }
+        if (origin && src.repo !== origin) {
+            skip(`its source is in ${src.repo}, not this repository`);
+            continue;
+        }
+        let sha = null;
+        if (src.kind === 'commit') {
+            sha = (await git(['rev-parse', '--verify', '-q', `${src.sha}^{commit}`]).catch(() => '')).trim() || null;
+            if (!sha) {
+                skip('its commit is not in this clone');
+                continue;
+            }
+        }
+        else {
+            sha = (await git(['log', ref, '-F', '--grep', `(#${src.number})`, '-1', '--format=%H']).catch(() => '')).trim() || null;
+            if (!sha) {
+                skip(`no commit on ${ref} mentions (#${src.number})`);
+                continue;
+            }
+        }
+        let hits = hitsBySha.get(sha);
+        if (!hits) {
+            const touched = (await git(['show', '--name-only', '--format=', sha])).split('\n').filter((f) => f && !isProseOrGeneratedFile(f));
+            if (touched.length > maxFiles)
+                report.filesCapped++;
+            hits = [];
+            for (const file of touched.slice(0, maxFiles)) {
+                if (Date.now() > deadline) {
+                    report.budgetExceeded = true;
+                    break;
+                }
+                // A file the commit touched may be gone or renamed on the default branch: nothing left to blame there.
+                const ranges = await blameRanges(git, ref, file, sha).catch(() => []);
+                const lines = ranges.reduce((n, [s, e]) => n + (e - s + 1), 0);
+                if (lines > 0)
+                    hits.push({ file, lines, ranges });
+            }
+            hitsBySha.set(sha, hits);
+        }
+        if (!hits.length)
+            continue;
+        report.findings.push({
+            replaced: { id: link.oldId, title: link.oldTitle, sourceUrl: link.oldSourceUrl },
+            replacedBy: { id: link.newId, title: link.newTitle, sourceUrl: link.newSourceUrl },
+            commit: sha,
+            confirmation: link.humanConfirmed ? 'confirmed' : 'ai-suggested',
+            ...(link.humanConfirmed ? {} : { confidence: link.confidence }),
+            files: hits,
+            totalLines: hits.reduce((n, h) => n + h.lines, 0),
+        });
+    }
+    report.findings.sort((a, b) => b.totalLines - a.totalLines);
+    return report;
+}
+//# sourceMappingURL=stale-code.js.map

package/dist/lib/stale-code.js.map

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

package/dist/lib/stale-links.d.ts

@@ -0,0 +1,27 @@
+import type { EnvironmentConfig } from './config.js';
+import type { DecisionLink } from './gateway-client.js';
+import type { StaleLink } from './stale-code.js';
+/** The slice of the gateway client this needs; the cloud client satisfies it, the local one does not. */
+export interface LinkSourceClient {
+    listDecisionLinks(filters?: {
+        relation?: string;
+    }): Promise<{
+        links: DecisionLink[];
+        total_count: number;
+    }>;
+    getDecision(id: string): Promise<{
+        source_url?: string | null;
+    }>;
+}
+export interface LoadedLinks {
+    links: StaleLink[];
+    /** Why the set is smaller than expected, to print instead of an empty result. */
+    notes: string[];
+}
+export declare const LOCAL_EMPTY_NOTE: string;
+/** A person's `align mark ... replaces` writes its link under a `mark:` id; every other local edge is the classifier's. */
+export declare function loadLocalLinks(dbPath: string): LoadedLinks;
+/** Link rows from the team graph, plus each endpoint's source URL from /snapshots/:id. A link is a person's only when the gateway names a non-"ai" method. */
+export declare function loadTeamLinks(client: LinkSourceClient): Promise<LoadedLinks>;
+export declare function loadStaleLinks(env: EnvironmentConfig, client: LinkSourceClient | null): Promise<LoadedLinks>;
+//# sourceMappingURL=stale-links.d.ts.map

package/dist/lib/stale-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-links.d.ts","sourceRoot":"","sources":["../../src/lib/stale-links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,yGAAyG;AACzG,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5G,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,iFAAiF;IACjF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB,QAE0G,CAAC;AAExI,2HAA2H;AAC3H,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAkB1D;AAED,8JAA8J;AAC9J,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkBlF;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAIlH"}

package/dist/lib/stale-links.js

@@ -0,0 +1,58 @@
+import { createLocalDb } from './local-db.js';
+export const LOCAL_EMPTY_NOTE = 'The local graph has no supersedes links. A keyless git import records only "relates" links between commits, ' +
+    'so nothing says which decision replaced which. Record one with `align mark <new> replaces <old>`, or use a team graph (--env prod).';
+/** A person's `align mark ... replaces` writes its link under a `mark:` id; every other local edge is the classifier's. */
+export function loadLocalLinks(dbPath) {
+    const db = createLocalDb(dbPath);
+    try {
+        const rows = db.listLinks({ relation: 'supersedes' });
+        const links = rows.flatMap((r) => {
+            const nu = db.getDecisionById(r.sourceId);
+            const old = db.getDecisionById(r.targetId);
+            if (!nu || !old)
+                return [];
+            return [{
+                    oldId: old.id, oldTitle: old.title, oldSourceUrl: old.sourceUrl,
+                    newId: nu.id, newTitle: nu.title, newSourceUrl: nu.sourceUrl,
+                    confidence: r.confidence, humanConfirmed: r.id.startsWith('mark:'),
+                }];
+        });
+        return { links, notes: links.length ? [] : [LOCAL_EMPTY_NOTE] };
+    }
+    finally {
+        db.close();
+    }
+}
+/** Link rows from the team graph, plus each endpoint's source URL from /snapshots/:id. A link is a person's only when the gateway names a non-"ai" method. */
+export async function loadTeamLinks(client) {
+    const { links: rows, total_count } = await client.listDecisionLinks({ relation: 'supersedes' });
+    const notes = [];
+    if (total_count > rows.length)
+        notes.push(`Read the first ${rows.length} of ${total_count} supersedes links.`);
+    const urls = new Map();
+    const sourceOf = (id) => {
+        let p = urls.get(id);
+        if (!p) {
+            p = client.getDecision(id).then((d) => d.source_url ?? null, () => null);
+            urls.set(id, p);
+        }
+        return p;
+    };
+    const links = await Promise.all(rows.map(async (l) => ({
+        oldId: l.to_decision.id, oldTitle: l.to_decision.title, oldSourceUrl: await sourceOf(l.to_decision.id),
+        newId: l.from_decision.id, newTitle: l.from_decision.title, newSourceUrl: await sourceOf(l.from_decision.id),
+        confidence: Number(l.confidence ?? 0),
+        humanConfirmed: typeof l.detection_method === 'string' && l.detection_method !== '' && l.detection_method !== 'ai',
+    })));
+    if (!links.length)
+        notes.push('The team graph has no supersedes links.');
+    return { links, notes };
+}
+export async function loadStaleLinks(env, client) {
+    if (env.mode === 'local-embedded')
+        return loadLocalLinks(env.localDbPath ?? ':memory:');
+    if (!client)
+        throw new Error('No gateway client for this environment.');
+    return loadTeamLinks(client);
+}
+//# sourceMappingURL=stale-links.js.map

package/dist/lib/stale-links.js.map

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

package/dist/lib/stale-render.d.ts

@@ -0,0 +1,6 @@
+import type { StaleFinding, StaleReport } from './stale-code.js';
+/** The wording the command and the MCP tool both use: never "wrong", only built on a replaced decision. */
+export declare function renderFinding(f: StaleFinding): string[];
+export declare function reportNotes(r: StaleReport, extra: string[], includeAi: boolean): string[];
+export declare function renderReport(r: StaleReport, extra: string[], includeAi: boolean): string;
+//# sourceMappingURL=stale-render.d.ts.map

package/dist/lib/stale-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-render.d.ts","sourceRoot":"","sources":["../../src/lib/stale-render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMjE,2GAA2G;AAC3G,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAWvD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,CASzF;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAWxF"}

package/dist/lib/stale-render.js

@@ -0,0 +1,47 @@
+import chalk from 'chalk';
+const plural = (n, w) => `${n} ${w}${n === 1 ? '' : 's'}`;
+const rangeText = (r) => (r[0] === r[1] ? `${r[0]}` : `${r[0]}-${r[1]}`);
+const shortRanges = (rs) => { const t = rs.slice(0, 6).map(rangeText).join(', '); return rs.length > 6 ? `${t}, +${rs.length - 6} more` : t; };
+/** The wording the command and the MCP tool both use: never "wrong", only built on a replaced decision. */
+export function renderFinding(f) {
+    const out = [
+        `${plural(f.totalLines, 'line')} built on a decision that was replaced`,
+        `  Replaced:     ${f.replaced.title}${f.replaced.sourceUrl ? `  ${f.replaced.sourceUrl}` : ''}`,
+        `  Replaced by:  ${f.replacedBy.title}${f.replacedBy.sourceUrl ? `  ${f.replacedBy.sourceUrl}` : ''}`,
+        f.confirmation === 'ai-suggested'
+            ? `  Link:         AI-suggested, not confirmed (confidence ${Number(f.confidence ?? 0).toFixed(2)})`
+            : '  Link:         confirmed by a person',
+    ];
+    for (const h of f.files)
+        out.push(`  ${h.file}  ${plural(h.lines, 'line')}  (${h.lines === 1 ? "line" : "lines"} ${shortRanges(h.ranges)})`);
+    return out;
+}
+export function reportNotes(r, extra, includeAi) {
+    const notes = [...extra];
+    if (!includeAi && r.aiExcluded > 0) {
+        notes.push(`${plural(r.aiExcluded, 'AI-suggested supersedes link')} left out because no person confirmed ${r.aiExcluded === 1 ? 'it' : 'them'}. Add --include-ai to include ${r.aiExcluded === 1 ? 'it' : 'them'}.`);
+    }
+    if (r.skipped.length)
+        notes.push(`Skipped ${plural(r.skipped.length, 'replaced decision')}: ${[...new Set(r.skipped.map((s) => s.reason))].join('; ')}.`);
+    if (r.filesCapped)
+        notes.push(`${plural(r.filesCapped, 'replaced decision')} touched more files than the per-decision cap, so only the first files were checked.`);
+    if (r.budgetExceeded)
+        notes.push('The time budget ran out before every decision was checked.');
+    return notes;
+}
+export function renderReport(r, extra, includeAi) {
+    const lines = [];
+    if (!r.findings.length) {
+        lines.push(`No code on ${r.ref} is still built on a replaced decision (checked ${plural(r.linksConsidered, 'supersedes link')}).`);
+    }
+    else {
+        const total = r.findings.reduce((n, f) => n + f.totalLines, 0);
+        lines.push(chalk.bold(`${plural(total, 'line')} still built on ${plural(r.findings.length, 'replaced decision')} (blame on ${r.ref})`), '');
+        for (const f of r.findings)
+            lines.push(...renderFinding(f), '');
+    }
+    for (const n of reportNotes(r, extra, includeAi))
+        lines.push(chalk.dim(n));
+    return lines.join('\n');
+}
+//# sourceMappingURL=stale-render.js.map

package/dist/lib/stale-render.js.map

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

package/dist/lib/stale-run.d.ts

@@ -0,0 +1,22 @@
+import type { EnvironmentConfig } from './config.js';
+import { type StaleOptions, type StaleReport } from './stale-code.js';
+import { type LinkSourceClient } from './stale-links.js';
+export interface StaleResult {
+    ref: string;
+    findings: StaleReport['findings'];
+    skipped: StaleReport['skipped'];
+    notes: string[];
+    counts: {
+        linksConsidered: number;
+        aiExcluded: number;
+        filesCapped: number;
+        budgetExceeded: boolean;
+    };
+}
+/** Load the supersedes links for this environment, then look for code still built on the replaced side. Shared by the command and the MCP tool. */
+export declare function runStale(env: EnvironmentConfig, client: LinkSourceClient | null, opts: Pick<StaleOptions, 'cwd' | 'includeAi' | 'maxFilesPerDecision' | 'budgetMs'>): Promise<{
+    report: StaleReport;
+    loadNotes: string[];
+    result: StaleResult;
+}>;
+//# sourceMappingURL=stale-run.d.ts.map

package/dist/lib/stale-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-run.d.ts","sourceRoot":"","sources":["../../src/lib/stale-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,KAAK,gBAAgB,EAAkB,MAAM,kBAAkB,CAAC;AAGzE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAClC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CACvG;AAED,mJAAmJ;AACnJ,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAC/B,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,WAAW,GAAG,qBAAqB,GAAG,UAAU,CAAC,GACjF,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,CAW5E"}

package/dist/lib/stale-run.js

@@ -0,0 +1,17 @@
+import { findStaleCode } from './stale-code.js';
+import { loadStaleLinks } from './stale-links.js';
+import { reportNotes } from './stale-render.js';
+/** Load the supersedes links for this environment, then look for code still built on the replaced side. Shared by the command and the MCP tool. */
+export async function runStale(env, client, opts) {
+    const loaded = await loadStaleLinks(env, client);
+    const report = await findStaleCode(loaded.links, opts);
+    const result = {
+        ref: report.ref,
+        findings: report.findings,
+        skipped: report.skipped,
+        notes: reportNotes(report, loaded.notes, opts.includeAi === true),
+        counts: { linksConsidered: report.linksConsidered, aiExcluded: report.aiExcluded, filesCapped: report.filesCapped, budgetExceeded: report.budgetExceeded },
+    };
+    return { report, loadNotes: loaded.notes, result };
+}
+//# sourceMappingURL=stale-run.js.map

package/dist/lib/stale-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-run.js","sourceRoot":"","sources":["../../src/lib/stale-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAuC,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAyB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD,mJAAmJ;AACnJ,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAsB,EACtB,MAA+B,EAC/B,IAAkF;IAElF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,GAAgB;QAC1B,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;QACjE,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE;KAC3J,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;AACrD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligndottech/cli",
-  "version": "0.65.2",
+  "version": "0.66.1",
   "mcpName": "io.github.aligndottech/cli",
   "type": "module",
   "description": "Align CLI - capture decisions, check alignment, and manage connectors",