@fraction12/deepclean 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/identity.d.ts

@@ -0,0 +1,15 @@
+import { type CandidateObservationRecord, type CandidateRecord, type EvidenceRecord, type FindingRecord, type FindingSignature, type LifecycleEventRecord } from "./types.js";
+export interface IdentityResult {
+    candidates: CandidateRecord[];
+    findings: FindingRecord[];
+    observations: CandidateObservationRecord[];
+    lifecycleEvents: LifecycleEventRecord[];
+}
+export declare function attachStableIdentity(options: {
+    runId: string;
+    candidates: CandidateRecord[];
+    evidence: EvidenceRecord[];
+    existingFindings: FindingRecord[];
+    observedAt: string;
+}): IdentityResult;
+export declare function signatureForCandidate(candidate: CandidateRecord, evidenceById: Map<string, EvidenceRecord>): FindingSignature;

package/dist/identity.js

@@ -0,0 +1,183 @@
+import { stableId } from "./ids.js";
+import { schemaVersion, } from "./types.js";
+export function attachStableIdentity(options) {
+    const evidenceById = new Map(options.evidence.map((record) => [record.id, record]));
+    const findingsBySignature = new Map(options.existingFindings.map((finding) => [finding.signature.value, finding]));
+    const findingsById = new Map(options.existingFindings.map((finding) => [finding.id, finding]));
+    const observations = [];
+    const lifecycleEvents = [];
+    const candidates = options.candidates.map((candidate) => {
+        const signature = signatureForCandidate(candidate, evidenceById);
+        const existing = findingsBySignature.get(signature.value);
+        const findingId = existing?.id ?? stableId("finding", signature.value, 16);
+        const observationId = stableId("observation", `${options.runId}:${candidate.id}:${signature.value}`, 16);
+        const identified = {
+            ...candidate,
+            findingId,
+            signature,
+            identityConfidence: "high",
+            lifecycleState: "open",
+            baselineStatus: "new",
+        };
+        const observation = {
+            schemaVersion,
+            recordType: "candidate_observation",
+            id: observationId,
+            findingId,
+            candidateId: candidate.id,
+            runId: options.runId,
+            signature,
+            identityConfidence: "high",
+            baselineStatus: existing ? "existing" : "new",
+            evidenceFreshness: "fresh",
+            observedAt: options.observedAt,
+        };
+        observations.push(observation);
+        if (!existing) {
+            const finding = {
+                schemaVersion,
+                recordType: "finding",
+                id: findingId,
+                signature,
+                identityConfidence: "high",
+                title: candidate.title,
+                category: candidate.category,
+                status: candidate.status,
+                lifecycleState: "open",
+                priority: candidate.priority,
+                confidence: candidate.confidence,
+                impact: candidate.impact,
+                effort: candidate.effort,
+                risk: candidate.risk,
+                files: candidate.files,
+                evidenceIds: candidate.evidenceIds,
+                observationIds: [observationId],
+                currentObservationId: observationId,
+                createdAt: options.observedAt,
+                updatedAt: options.observedAt,
+            };
+            findingsBySignature.set(signature.value, finding);
+            findingsById.set(finding.id, finding);
+            lifecycleEvents.push(lifecycleEvent({
+                kind: "created",
+                targetId: finding.id,
+                findingId: finding.id,
+                runId: options.runId,
+                toState: "open",
+                command: "scan",
+                createdAt: options.observedAt,
+            }));
+        }
+        else {
+            findingsById.set(existing.id, {
+                ...existing,
+                title: candidate.title,
+                category: candidate.category,
+                status: candidate.status,
+                lifecycleState: "open",
+                priority: candidate.priority,
+                confidence: candidate.confidence,
+                impact: candidate.impact,
+                effort: candidate.effort,
+                risk: candidate.risk,
+                files: candidate.files,
+                evidenceIds: candidate.evidenceIds,
+                observationIds: appendUnique(existing.observationIds, observationId),
+                currentObservationId: observationId,
+                updatedAt: options.observedAt,
+            });
+        }
+        lifecycleEvents.push(lifecycleEvent({
+            kind: "observed",
+            targetId: findingId,
+            findingId,
+            runId: options.runId,
+            toState: "open",
+            command: "scan",
+            createdAt: options.observedAt,
+            data: {
+                candidateId: candidate.id,
+                observationId,
+                baselineStatus: observation.baselineStatus,
+            },
+        }));
+        return identified;
+    });
+    return {
+        candidates,
+        findings: [...findingsById.values()].sort((a, b) => a.id.localeCompare(b.id)),
+        observations,
+        lifecycleEvents,
+    };
+}
+export function signatureForCandidate(candidate, evidenceById) {
+    const evidence = candidate.evidenceIds
+        .map((id) => evidenceById.get(id))
+        .filter((record) => Boolean(record));
+    const evidenceKinds = [...new Set(evidence.map((record) => record.kind))].sort();
+    const analyzerRuleIds = [...new Set(evidence.flatMap((record) => analyzerRuleId(record)))].sort();
+    const graphNeighborhood = [...new Set(evidence.flatMap((record) => graphEdges(record)))].sort().slice(0, 20);
+    const primaryAnchors = [...candidate.files]
+        .sort((a, b) => a.path.localeCompare(b.path))
+        .slice(0, 8)
+        .map((file) => ({ path: file.path }));
+    const components = {
+        category: candidate.category,
+        normalizedTitle: normalizeTitle(candidate.title),
+        evidenceKinds,
+        primaryAnchors,
+        ...(graphNeighborhood.length > 0 ? { graphNeighborhood } : {}),
+        ...(analyzerRuleIds.length > 0 ? { analyzerRuleIds } : {}),
+    };
+    const value = stableId("sig", JSON.stringify(components), 20);
+    return {
+        version: "1",
+        value,
+        components,
+    };
+}
+function lifecycleEvent(input) {
+    const id = stableId("event", `${input.runId}:${input.findingId}:${input.kind}:${JSON.stringify(input.data ?? {})}`, 16);
+    return {
+        schemaVersion,
+        recordType: "lifecycle_event",
+        id,
+        targetType: "finding",
+        targetId: input.targetId,
+        findingId: input.findingId,
+        runId: input.runId,
+        kind: input.kind,
+        toState: input.toState,
+        command: input.command,
+        createdAt: input.createdAt,
+        ...(input.data ? { data: input.data } : {}),
+    };
+}
+function normalizeTitle(title) {
+    return title.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
+}
+function analyzerRuleId(record) {
+    const ruleId = record.data["ruleId"];
+    return typeof ruleId === "string" ? [ruleId] : [];
+}
+function graphEdges(record) {
+    const edges = record.data["edges"];
+    if (!Array.isArray(edges)) {
+        return [];
+    }
+    return edges.flatMap((edge) => {
+        if (edge
+            && typeof edge === "object"
+            && "from" in edge
+            && "to" in edge
+            && typeof edge.from === "string"
+            && typeof edge.to === "string") {
+            return [`${edge.from}->${edge.to}`];
+        }
+        return [];
+    });
+}
+function appendUnique(values, value) {
+    return values.includes(value) ? values : [...values, value];
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/locks.d.ts

@@ -0,0 +1,37 @@
+import { type Diagnostic, type LockRecord } from "./types.js";
+import { type StatePaths } from "./state.js";
+export declare class LockContentionError extends Error {
+    readonly diagnostic: Diagnostic;
+    readonly record?: LockRecord;
+    readonly recoveryCommand: string;
+    readonly stale: boolean;
+    constructor(options: {
+        message: string;
+        record?: LockRecord | undefined;
+        stale: boolean;
+        recoveryCommand: string;
+    });
+}
+export interface LockStatus {
+    filePath: string;
+    record?: LockRecord;
+    stale: boolean;
+    reason?: string;
+    recoveryCommand: string;
+}
+export declare function withStateWriteLock<T>(paths: StatePaths, options: {
+    command: string;
+    wait?: boolean | undefined;
+    timeoutMs?: number | undefined;
+    staleAfterMs?: number | undefined;
+}, fn: () => Promise<T>): Promise<T>;
+export declare function readLockStatuses(paths: StatePaths, options?: {
+    staleAfterMs?: number | undefined;
+}): Promise<LockStatus[]>;
+export declare function recoverStaleLocks(paths: StatePaths, options?: {
+    staleAfterMs?: number | undefined;
+}): Promise<{
+    removed: LockStatus[];
+    active: LockStatus[];
+}>;
+export declare function lockRecoveryCommand(paths: StatePaths): string;

package/dist/locks.js

@@ -0,0 +1,179 @@
+import { mkdir, open, readFile, readdir, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { schemaVersion, lockRecordSchema } from "./types.js";
+const stateWriterLockId = "state-writer";
+const defaultStaleLockMs = 30 * 60 * 1000;
+const defaultLockPollMs = 100;
+const defaultLockTimeoutMs = 0;
+export class LockContentionError extends Error {
+    diagnostic;
+    record;
+    recoveryCommand;
+    stale;
+    constructor(options) {
+        super(options.message);
+        this.name = "LockContentionError";
+        if (options.record) {
+            this.record = options.record;
+        }
+        this.stale = options.stale;
+        this.recoveryCommand = options.recoveryCommand;
+        this.diagnostic = {
+            level: "error",
+            code: options.stale ? "stale_lock" : "lock_contention",
+            message: options.message,
+        };
+    }
+}
+export async function withStateWriteLock(paths, options, fn) {
+    const acquired = await acquireStateWriteLock(paths, options);
+    try {
+        return await fn();
+    }
+    finally {
+        await releaseLock(acquired.filePath);
+    }
+}
+export async function readLockStatuses(paths, options = {}) {
+    let files;
+    try {
+        files = (await readdir(paths.locksDir)).filter((file) => file.endsWith(".json"));
+    }
+    catch {
+        return [];
+    }
+    const statuses = [];
+    for (const file of files) {
+        const filePath = path.join(paths.locksDir, file);
+        const record = await readLockFile(filePath);
+        const stale = await lockIsStale(record, options.staleAfterMs);
+        statuses.push({
+            filePath,
+            stale: stale.stale,
+            recoveryCommand: recoveryCommand(paths),
+            ...(record ? { record } : {}),
+            ...(stale.reason ? { reason: stale.reason } : {}),
+        });
+    }
+    return statuses.sort((a, b) => a.filePath.localeCompare(b.filePath));
+}
+export async function recoverStaleLocks(paths, options = {}) {
+    const statuses = await readLockStatuses(paths, options);
+    const removed = [];
+    const active = [];
+    for (const status of statuses) {
+        if (status.stale) {
+            await releaseLock(status.filePath);
+            removed.push(status);
+        }
+        else {
+            active.push(status);
+        }
+    }
+    return { removed, active };
+}
+export function lockRecoveryCommand(paths) {
+    return recoveryCommand(paths);
+}
+async function acquireStateWriteLock(paths, options) {
+    await mkdir(paths.locksDir, { recursive: true });
+    const filePath = path.join(paths.locksDir, `${stateWriterLockId}.json`);
+    const startedAt = Date.now();
+    const timeoutMs = options.timeoutMs ?? defaultLockTimeoutMs;
+    while (true) {
+        try {
+            const handle = await open(filePath, "wx");
+            const now = new Date().toISOString();
+            const record = {
+                schemaVersion,
+                recordType: "lock",
+                id: stateWriterLockId,
+                owner: `${os.userInfo().username}@${os.hostname()}`,
+                pid: process.pid,
+                command: options.command,
+                statePath: paths.stateDir,
+                createdAt: now,
+            };
+            lockRecordSchema.parse(record);
+            await handle.writeFile(`${JSON.stringify(record, null, 2)}\n`, "utf8");
+            await handle.close();
+            return { filePath, record };
+        }
+        catch (error) {
+            if (!isAlreadyExistsError(error)) {
+                throw error;
+            }
+            const existing = await readLockFile(filePath);
+            const stale = await lockIsStale(existing, options.staleAfterMs);
+            if (stale.stale) {
+                throw new LockContentionError({
+                    message: `Stale Deepclean lock blocks writes at ${path.relative(paths.root, filePath)}. Run \`${recoveryCommand(paths)}\` before retrying.`,
+                    record: existing,
+                    stale: true,
+                    recoveryCommand: recoveryCommand(paths),
+                });
+            }
+            if (!options.wait || Date.now() - startedAt >= timeoutMs) {
+                throw new LockContentionError({
+                    message: `Another Deepclean writer is active${existing?.command ? ` (${existing.command})` : ""}. Retry after it exits or use --wait-lock.`,
+                    record: existing,
+                    stale: false,
+                    recoveryCommand: recoveryCommand(paths),
+                });
+            }
+            await sleep(defaultLockPollMs);
+        }
+    }
+}
+async function readLockFile(filePath) {
+    try {
+        const raw = await readFile(filePath, "utf8");
+        return lockRecordSchema.parse(JSON.parse(raw));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function lockIsStale(record, staleAfterMs = defaultStaleLockMs) {
+    if (!record) {
+        return { stale: true, reason: "lock record is unreadable" };
+    }
+    const createdAt = Date.parse(record.createdAt);
+    if (!Number.isFinite(createdAt)) {
+        return { stale: true, reason: "lock timestamp is invalid" };
+    }
+    if (Date.now() - createdAt > staleAfterMs) {
+        return { stale: true, reason: "lock exceeded stale threshold" };
+    }
+    if (!processIsAlive(record.pid)) {
+        return { stale: true, reason: "lock process is not running" };
+    }
+    return { stale: false };
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (typeof error === "object" && error && "code" in error && error.code === "EPERM") {
+            return true;
+        }
+        return false;
+    }
+}
+async function releaseLock(filePath) {
+    await rm(filePath, { force: true });
+}
+function recoveryCommand(paths) {
+    const stateDir = path.relative(paths.root, paths.stateDir) || paths.stateDir;
+    return `deepclean unlock --stale --state-dir ${stateDir}`;
+}
+function isAlreadyExistsError(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST";
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=locks.js.map

package/dist/locks.js.map

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

package/dist/reporting.js

@@ -33,7 +33,7 @@ export function renderMarkdownReport(candidates) {
     ];
     lines.push("## Candidate Appendix", "");
     for (const candidate of candidates.slice(0, 40)) {
-        lines.push(`## ${candidate.priority} ${candidate.id}: ${candidate.title}`, "", `- Status: ${candidate.status}`, `- Category: ${candidate.category}`, `- Confidence: ${candidate.confidence}`, `- Impact: ${candidate.impact}`, `- Effort: ${candidate.effort}`, `- Risk: ${candidate.risk}`, `- Files: ${candidate.files.map((file) => formatFile(file)).join(", ") || "n/a"}`, "", `Why it matters: ${candidate.whyItMatters}`, "", `Likely root cause: ${candidate.likelyRootCause}`, "", `Suggested direction: ${candidate.suggestedDirection}`, "", `Verification: ${candidate.verification.join(", ")}`, "");
+        lines.push(`## ${candidate.priority} ${candidate.id}: ${candidate.title}`, "", `- Status: ${candidate.status}`, `- Finding: ${candidate.findingId ?? "unlinked"}`, `- Revalidation: ${candidate.lifecycleState ?? "open"}`, `- Category: ${candidate.category}`, `- Confidence: ${candidate.confidence}`, `- Impact: ${candidate.impact}`, `- Effort: ${candidate.effort}`, `- Risk: ${candidate.risk}`, `- Files: ${candidate.files.map((file) => formatFile(file)).join(", ") || "n/a"}`, "", `Why it matters: ${candidate.whyItMatters}`, "", `Likely root cause: ${candidate.likelyRootCause}`, "", `Suggested direction: ${candidate.suggestedDirection}`, "", `Verification: ${candidate.verification.join(", ")}`, "");
     }
     if (candidates.length > 40) {
         lines.push(`_Appendix truncated to 40 candidates. Full candidate records are in the JSON artifact._`, "");
@@ -153,6 +153,8 @@ function candidateMarkdown(candidate) {
         `### ${candidate.priority} ${candidate.id}: ${candidate.title}`,
         "",
         `- Status: ${candidate.status}`,
+        `- Finding: ${candidate.findingId ?? "unlinked"}`,
+        `- Revalidation: ${candidate.lifecycleState ?? "open"}`,
         `- Category: ${candidate.category}`,
         `- Confidence: ${candidate.confidence}`,
         `- Impact: ${candidate.impact}`,

package/dist/reporting.js.map

@@ -1 +1 @@
-{"version":3,"file":"reporting.js","sourceRoot":"","sources":["../src/reporting.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAMd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,UAA6B,EAC7B,WAA4B,EAAE;IAE9B,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,aAAa;QACb,UAAU,EAAE,QAAQ;QACpB,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC;QACzB,KAAK;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE;YACP,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;YAC1E,KAAK,EAAE,UAAU,CAAC,MAAM;YACxB,UAAU;SACX;QACD,eAAe,EAAE,0BAA0B,CAAC,UAAU,EAAE,QAAQ,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAA6B;IAChE,MAAM,eAAe,GAAG,0BAA0B,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC;IAC7G,MAAM,KAAK,GAAG;QACZ,oBAAoB;QACpB,EAAE;QACF,SAAS,UAAU,CAAC,MAAM,qBAAqB,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;QACpF,EAAE;QACF,GAAG,sBAAsB,CAAC,eAAe,CAAC;QAC1C,GAAG,kBAAkB,CAAC,gBAAgB,CAAC;KACxC,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACxC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CACR,MAAM,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,KAAK,EAAE,EAC9D,EAAE,EACF,aAAa,SAAS,CAAC,MAAM,EAAE,EAC/B,eAAe,SAAS,CAAC,QAAQ,EAAE,EACnC,iBAAiB,SAAS,CAAC,UAAU,EAAE,EACvC,aAAa,SAAS,CAAC,MAAM,EAAE,EAC/B,aAAa,SAAS,CAAC,MAAM,EAAE,EAC/B,WAAW,SAAS,CAAC,IAAI,EAAE,EAC3B,YAAY,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,EACjF,EAAE,EACF,mBAAmB,SAAS,CAAC,YAAY,EAAE,EAC3C,EAAE,EACF,sBAAsB,SAAS,CAAC,eAAe,EAAE,EACjD,EAAE,EACF,wBAAwB,SAAS,CAAC,kBAAkB,EAAE,EACtD,EAAE,EACF,iBAAiB,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACpD,EAAE,CACH,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,yFAAyF,EAAE,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,UAA6B,EAC7B,QAAyB;IAEzB,MAAM,eAAe,GAAG,0BAA0B,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACzE,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC;IAC7G,MAAM,KAAK,GAAG;QACZ,oBAAoB;QACpB,EAAE;QACF,SAAS,UAAU,CAAC,MAAM,qBAAqB,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,QAAQ,CAAC,MAAM,SAAS,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;QACvJ,EAAE;QACF,GAAG,sBAAsB,CAAC,eAAe,CAAC;QAC1C,GAAG,kBAAkB,CAAC,gBAAgB,CAAC;KACxC,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,IAAI,SAAS,CAAC,KAAK,SAAS,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,IAAI,SAAS,CAAC,KAAK,WAAW,CAAC,CAAC;QACjG,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CACR,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE,EACzD,EAAE,EACF,iBAAiB,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAClD,eAAe,OAAO,CAAC,QAAQ,EAAE,EACjC,iBAAiB,OAAO,CAAC,UAAU,EAAE,EACrC,aAAa,OAAO,CAAC,MAAM,EAAE,EAC7B,aAAa,OAAO,CAAC,MAAM,EAAE,EAC7B,WAAW,OAAO,CAAC,IAAI,EAAE,EACzB,oBAAoB,OAAO,CAAC,aAAa,IAAI,SAAS,EAAE,EACxD,YAAY,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,EAC/E,EAAE,EACF,GAAG,sBAAsB,CAAC,OAAO,CAAC,EAClC,OAAO,CAAC,SAAS,EACjB,EAAE,EACF,wBAAwB,OAAO,CAAC,kBAAkB,EAAE,EACpD,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACxC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,yFAAyF,EAAE,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,kBAAkB,CAAC,UAA6B;IACvD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACrC,KAAK,MAAM,SAAS,IAAI,GAAG,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3F,KAAK,CAAC,IAAI,CACR,KAAK,SAAS,CAAC,EAAE,IAAI,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,KAAK,MAAM,KAAK,SAAS,CAAC,UAAU,GAAG,EACjG,YAAY,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,EAC7E,mBAAmB,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAsB;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,0BAA0B,CACjC,UAA6B,EAC7B,QAAyB;IAEzB,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACrF,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,IAAI,SAAS,CAAC,KAAK,SAAS,CAAC,CAAC;IACvG,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;IACvH,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,cAAc,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,UAAU;QAC1B,CAAC,CAAC;YACA,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,IAAI,EAAE,OAAgB;YACtB,MAAM,EAAE,sFAAsF;SAC/F;QACD,CAAC,CAAC,cAAc;YACd,CAAC,CAAC;gBACA,EAAE,EAAE,cAAc,CAAC,EAAE;gBACrB,IAAI,EAAE,WAAoB;gBAC1B,MAAM,EAAE,+EAA+E;aACxF;YACD,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO;QACL,SAAS;QACT,eAAe;QACf,WAAW;QACX,QAAQ;QACR,oBAAoB,EAAE,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,UAA6B;IACzD,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,iBAAiB,CAAC,CAAC;IAC5G,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CACvD,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,iBAAiB;WAC9C,CAAC,qBAAqB,CAAC,SAAS,CAAC,CACrC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAClD,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,iBAAiB;WAC9C,qBAAqB,CAAC,SAAS,CAAC,CACpC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,eAAe,EAAE,GAAG,eAAe,EAAE,GAAG,UAAU,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,qBAAqB,CAAC,SAA0B;IACvD,IAAI,SAAS,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC,QAAQ,KAAK,YAAY,IAAI,SAAS,CAAC,QAAQ,KAAK,aAAa,CAAC;AACrF,CAAC;AAED,SAAS,sBAAsB,CAAC,eAA6D;IAC3F,MAAM,KAAK,GAAa,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CACR,QAAQ,eAAe,CAAC,SAAS,CAAC,IAAI,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,SAAS,EAC/E,EAAE,EACF,eAAe,CAAC,SAAS,CAAC,MAAM,EAChC,EAAE,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,yCAAyC,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,eAAe,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,2BAA2B,eAAe,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,SAA0B;IACnD,OAAO;QACL,OAAO,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,KAAK,EAAE;QAC/D,EAAE;QACF,aAAa,SAAS,CAAC,MAAM,EAAE;QAC/B,eAAe,SAAS,CAAC,QAAQ,EAAE;QACnC,iBAAiB,SAAS,CAAC,UAAU,EAAE;QACvC,aAAa,SAAS,CAAC,MAAM,EAAE;QAC/B,aAAa,SAAS,CAAC,MAAM,EAAE;QAC/B,WAAW,SAAS,CAAC,IAAI,EAAE;QAC3B,YAAY,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE;QACjF,EAAE;QACF,mBAAmB,SAAS,CAAC,YAAY,EAAE;QAC3C,EAAE;QACF,sBAAsB,SAAS,CAAC,eAAe,EAAE;QACjD,EAAE;QACF,wBAAwB,SAAS,CAAC,kBAAkB,EAAE;QACtD,EAAE;QACF,iBAAiB,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACpD,EAAE;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,SAA0B,EAC1B,QAA0B,EAC1B,MAAc;IAEd,OAAO;QACL,aAAa;QACb,UAAU,EAAE,SAAS;QACrB,EAAE,EAAE,WAAW,CAAC,SAAS,CAAC;QAC1B,WAAW,EAAE,SAAS,CAAC,EAAE;QACzB,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,SAA0B,EAC1B,QAA0B;IAE1B,OAAO;QACL,qDAAqD,SAAS,CAAC,EAAE,EAAE;QACnE,EAAE;QACF,YAAY,SAAS,CAAC,KAAK,EAAE;QAC7B,EAAE;QACF,aAAa,SAAS,CAAC,QAAQ,EAAE;QACjC,aAAa,SAAS,CAAC,QAAQ,EAAE;QACjC,eAAe,SAAS,CAAC,UAAU,EAAE;QACrC,WAAW,SAAS,CAAC,MAAM,EAAE;QAC7B,WAAW,SAAS,CAAC,MAAM,EAAE;QAC7B,SAAS,SAAS,CAAC,IAAI,EAAE;QACzB,EAAE;QACF,iBAAiB;QACjB,SAAS,CAAC,YAAY;QACtB,EAAE;QACF,WAAW;QACX,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzG,EAAE;QACF,oBAAoB;QACpB,SAAS,CAAC,eAAe;QACzB,EAAE;QACF,sBAAsB;QACtB,SAAS,CAAC,kBAAkB;QAC5B,EAAE;QACF,cAAc;QACd,gFAAgF;QAChF,0CAA0C;QAC1C,uCAAuC;QACvC,EAAE;QACF,eAAe;QACf,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC;KAC3D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAID,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACnC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}
+{"version":3,"file":"reporting.js","sourceRoot":"","sources":["../src/reporting.ts"],"names":[],"mappings":"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"}

package/dist/revalidation.d.ts

@@ -0,0 +1,8 @@
+import { type CandidateRecord, type FindingRecord, type RevalidationRecord } from "./types.js";
+export declare function classifyRevalidation(options: {
+    root: string;
+    finding: FindingRecord | undefined;
+    currentCandidates: CandidateRecord[];
+    runId: string;
+    createdAt: string;
+}): Promise<RevalidationRecord>;

package/dist/revalidation.js

@@ -0,0 +1,114 @@
+import { stat } from "node:fs/promises";
+import path from "node:path";
+import { schemaVersion, } from "./types.js";
+import { timestampId } from "./ids.js";
+export async function classifyRevalidation(options) {
+    const diagnostics = [];
+    if (!options.finding) {
+        return revalidationRecord({
+            runId: options.runId,
+            outcome: "inconclusive",
+            evidenceIds: [],
+            diagnostics: [{
+                    level: "warning",
+                    code: "finding_missing",
+                    message: "The target finding could not be resolved before revalidation.",
+                }],
+            createdAt: options.createdAt,
+        });
+    }
+    const matching = options.currentCandidates.find((candidate) => candidate.findingId === options.finding?.id);
+    if (matching) {
+        return revalidationRecord({
+            targetId: options.finding.id,
+            runId: options.runId,
+            outcome: "unchanged",
+            evidenceIds: matching.evidenceIds,
+            previousObservationId: options.finding.currentObservationId,
+            diagnostics,
+            createdAt: options.createdAt,
+        });
+    }
+    const filesExist = await anyFindingFilesExist(options.root, options.finding);
+    if (!filesExist) {
+        return revalidationRecord({
+            targetId: options.finding.id,
+            runId: options.runId,
+            outcome: "fixed",
+            evidenceIds: [],
+            previousObservationId: options.finding.currentObservationId,
+            diagnostics,
+            createdAt: options.createdAt,
+        });
+    }
+    const related = relatedCandidates(options.finding, options.currentCandidates);
+    const replacement = related.find((candidate) => candidate.impact === "cross-cutting" || candidate.priority < options.finding.priority);
+    if (replacement?.findingId) {
+        return revalidationRecord({
+            targetId: options.finding.id,
+            runId: options.runId,
+            outcome: "superseded",
+            evidenceIds: replacement.evidenceIds,
+            previousObservationId: options.finding.currentObservationId,
+            supersededByFindingId: replacement.findingId,
+            diagnostics,
+            createdAt: options.createdAt,
+        });
+    }
+    if (related.length > 0) {
+        return revalidationRecord({
+            targetId: options.finding.id,
+            runId: options.runId,
+            outcome: "changed",
+            evidenceIds: related.flatMap((candidate) => candidate.evidenceIds),
+            previousObservationId: options.finding.currentObservationId,
+            diagnostics,
+            createdAt: options.createdAt,
+        });
+    }
+    return revalidationRecord({
+        targetId: options.finding.id,
+        runId: options.runId,
+        outcome: "stale",
+        evidenceIds: [],
+        previousObservationId: options.finding.currentObservationId,
+        diagnostics,
+        createdAt: options.createdAt,
+    });
+}
+function revalidationRecord(input) {
+    return {
+        schemaVersion,
+        recordType: "revalidation",
+        id: timestampId("revalidation"),
+        targetType: input.targetId ? "finding" : "all",
+        ...(input.targetId ? { targetId: input.targetId } : {}),
+        runId: input.runId,
+        outcome: input.outcome,
+        evidenceIds: input.evidenceIds,
+        ...(input.previousObservationId ? { previousObservationId: input.previousObservationId } : {}),
+        ...(input.newObservationId ? { newObservationId: input.newObservationId } : {}),
+        ...(input.supersededByFindingId ? { supersededByFindingId: input.supersededByFindingId } : {}),
+        diagnostics: input.diagnostics,
+        createdAt: input.createdAt,
+    };
+}
+async function anyFindingFilesExist(root, finding) {
+    for (const file of finding.files) {
+        try {
+            await stat(path.join(root, file.path));
+            return true;
+        }
+        catch {
+            // Keep checking other files.
+        }
+    }
+    return false;
+}
+function relatedCandidates(finding, candidates) {
+    const findingFiles = new Set(finding.files.map((file) => file.path));
+    return candidates.filter((candidate) => (candidate.category === finding.category
+        && candidate.findingId !== finding.id
+        && candidate.files.some((file) => findingFiles.has(file.path))));
+}
+//# sourceMappingURL=revalidation.js.map

package/dist/revalidation.js.map

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