openpitstop 1.0.0

package/dist/graph/correlate.js

@@ -0,0 +1,246 @@
+import path from "node:path";
+import { buildEdges } from "../analyzers/dependencyGraph.js";
+import { findingIdFor, ledgerFindingId } from "../repro/ids.js";
+/**
+ * HEURISTIC (not magic):
+ * We treat every Phase-1 output that points at one or more files as a flat
+ * "finding". Findings are correlated when they touch the same file, or files
+ * that are within 1-2 hops of each other in the dependency graph (so e.g. a
+ * buggy leaf and its only caller group together). Within a correlated group we
+ * guess the root cause as the highest-scoring finding, where score combines
+ * severity with graph centrality: a file many other files depend on is more
+ * likely to be the root cause than a leaf file. This is a best-effort guess and
+ * is clearly labeled as such in the popup.
+ */
+const SEVERITY_RANK = {
+    critical: 5,
+    high: 4,
+    severe: 4,
+    error: 4,
+    medium: 3,
+    moderate: 3,
+    warning: 2,
+    low: 2,
+    info: 1,
+    unknown: 2,
+};
+function severityRank(s) {
+    return SEVERITY_RANK[s?.toLowerCase()] ?? 2;
+}
+/** Flatten Phase-1 results into a list of file-based findings. */
+export function collectFindings(repo, r) {
+    const findings = [];
+    for (const i of r.security.issues) {
+        findings.push({
+            id: findingIdFor("security", i.type, i.file, i.description),
+            source: "security",
+            severity: i.severity,
+            type: i.type,
+            description: i.description,
+            files: i.file ? [path.relative(repo, i.file)] : [],
+        });
+    }
+    for (const c of r.duplication.clones) {
+        findings.push({
+            id: findingIdFor("duplication", "duplication", c.files[0], `${c.lines}`),
+            source: "duplication",
+            severity: "low",
+            type: "duplication",
+            description: `duplicate code (${c.lines} lines)`,
+            files: c.files.map((f) => path.relative(repo, f)),
+        });
+    }
+    for (const cyc of r.dependencyGraph.circular) {
+        const files = cyc.map((f) => path.relative(repo, f));
+        findings.push({
+            id: findingIdFor("graph", "circular", cyc[0], files.join(" → ")),
+            source: "graph",
+            severity: "medium",
+            type: "circular",
+            description: `circular dependency: ${files.join(" → ")}`,
+            files,
+        });
+    }
+    for (const i of r.accessibility.issues) {
+        findings.push({
+            id: findingIdFor("a11y", i.type, i.file, i.description),
+            source: "a11y",
+            severity: i.severity,
+            type: "a11y",
+            description: i.description,
+            files: i.file ? [path.relative(repo, i.file)] : [],
+        });
+    }
+    for (const f of r.reliability.flakyTests) {
+        findings.push({
+            id: findingIdFor("reliability", "flaky-test", f.file, f.name),
+            source: "reliability",
+            severity: "warning",
+            type: "flaky-test",
+            description: `flaky test (outcome changed across ${r.reliability.runs} runs): ${f.name}`,
+            files: f.file ? [path.relative(repo, f.file)] : [],
+        });
+    }
+    for (const i of r.reliability.raceSmells) {
+        findings.push({
+            id: findingIdFor("reliability", "race-condition", i.file, i.description),
+            source: "reliability",
+            severity: i.severity,
+            type: "race-condition",
+            description: i.description,
+            files: i.file ? [path.relative(repo, i.file)] : [],
+        });
+    }
+    for (const i of r.devex.unusedExports) {
+        findings.push({
+            id: findingIdFor("devex", "unused-export", i.file, i.description),
+            source: "devex",
+            severity: i.severity,
+            type: "unused-export",
+            description: i.description,
+            files: i.file ? [path.relative(repo, i.file)] : [],
+        });
+    }
+    for (const d of r.devex.duplicateFunctions) {
+        findings.push({
+            id: findingIdFor("devex", "duplicate-function", d.files[0]?.file, `${d.name}@${d.files[0]?.file}`),
+            source: "devex",
+            severity: "medium",
+            type: "duplicate-function",
+            description: `near-identical function bodies (${(d.similarity * 100).toFixed(0)}% similar, ${d.lines} lines): ${d.name} in ${d.files
+                .map((f) => path.basename(f.file))
+                .join(" vs ")}`,
+            files: d.files.map((f) => path.relative(repo, f.file)),
+        });
+    }
+    return findings;
+}
+export function correlate(repo, r) {
+    const findings = collectFindings(repo, r);
+    const built = buildEdges(repo);
+    const edges = built?.edges ?? new Map();
+    // Centrality = in-degree in the dependency graph.
+    const inDegree = new Map();
+    for (const deps of edges.values()) {
+        for (const d of deps)
+            inDegree.set(d, (inDegree.get(d) ?? 0) + 1);
+    }
+    // Undirected adjacency for hop-distance checks.
+    const adj = new Map();
+    const link = (a, b) => {
+        if (!adj.has(a))
+            adj.set(a, new Set());
+        adj.get(a).add(b);
+    };
+    for (const [u, deps] of edges) {
+        link(u, u);
+        for (const v of deps) {
+            link(u, v);
+            link(v, u);
+        }
+    }
+    const resolve = (f) => path.resolve(repo, f);
+    const distance = (a, b) => {
+        if (!adj.has(a) || !adj.has(b))
+            return Infinity;
+        if (a === b)
+            return 0;
+        const q = [[a, 0]];
+        const seen = new Set([a]);
+        while (q.length) {
+            const [n, d] = q.shift();
+            for (const nb of adj.get(n) ?? []) {
+                if (nb === b)
+                    return d + 1;
+                if (!seen.has(nb)) {
+                    seen.add(nb);
+                    q.push([nb, d + 1]);
+                }
+            }
+        }
+        return Infinity;
+    };
+    const centrality = (f) => Math.max(0, ...f.files.map((fl) => inDegree.get(resolve(fl)) ?? 0));
+    const score = (f) => severityRank(f.severity) * 10 + centrality(f);
+    const correlated = (a, b) => {
+        if (a.files.some((f) => b.files.includes(f)))
+            return true;
+        for (const fa of a.files) {
+            for (const fb of b.files) {
+                if (distance(resolve(fa), resolve(fb)) <= 2)
+                    return true;
+            }
+        }
+        return false;
+    };
+    // Union-find clustering over the findings.
+    const parent = findings.map((_, i) => i);
+    const find = (x) => {
+        while (parent[x] !== x) {
+            parent[x] = parent[parent[x]];
+            x = parent[x];
+        }
+        return x;
+    };
+    const union = (a, b) => {
+        parent[find(a)] = find(b);
+    };
+    for (let i = 0; i < findings.length; i++) {
+        for (let j = i + 1; j < findings.length; j++) {
+            if (correlated(findings[i], findings[j]))
+                union(i, j);
+        }
+    }
+    const groups = new Map();
+    for (let i = 0; i < findings.length; i++) {
+        const root = find(i);
+        if (!groups.has(root))
+            groups.set(root, []);
+        groups.get(root).push(i);
+    }
+    const clusters = [];
+    for (const idxs of groups.values()) {
+        if (idxs.length < 2)
+            continue;
+        const group = idxs.map((i) => findings[i]);
+        // Root cause = highest score (severity + centrality). Ties broken by order.
+        let root = group[0];
+        for (const f of group)
+            if (score(f) > score(root))
+                root = f;
+        const symptoms = group.filter((f) => f !== root);
+        const sharedFiles = [...new Set(group.flatMap((f) => f.files))];
+        clusters.push({ rootCause: root, symptoms, sharedFiles, size: group.length });
+    }
+    clusters.sort((a, b) => b.size - a.size);
+    // A PROVEN double-charge from ledger mode is always the top-ranked cluster.
+    // Ledger findings are never merged into the heuristic clusters: they are
+    // observed facts (the mocked gateway was actually hit twice), not guesses, so
+    // they lead the report unconditionally.
+    const ledgerClusters = buildLedgerClusters(repo, r);
+    if (ledgerClusters.length > 0)
+        clusters.unshift(...ledgerClusters);
+    return { clusters, findings };
+}
+function buildLedgerClusters(repo, r) {
+    if (!r.ledger || r.ledger.evidence.length === 0)
+        return [];
+    return r.ledger.evidence.map((ev) => {
+        const files = ev.endpointFile ? [ev.endpointFile] : [];
+        const rootCause = {
+            id: ledgerFindingId(ev),
+            source: "ledger",
+            severity: "critical",
+            type: "proven-double-charge",
+            description: ev.summary,
+            files,
+        };
+        return {
+            rootCause,
+            symptoms: [],
+            sharedFiles: files,
+            size: 1,
+        };
+    });
+}
+//# sourceMappingURL=correlate.js.map

package/dist/graph/correlate.js.map

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

package/dist/graph/integrity.d.ts

@@ -0,0 +1,22 @@
+import type { FileChange, IntegrityFinding, IntegrityReport, Verdict } from "../analyzers/integrity/types.js";
+import { runDetectors } from "../analyzers/integrity/index.js";
+/**
+ * Combine all detector output into a single integrity report with an overall
+ * verdict.
+ *
+ * CALIBRATION (the contract that keeps this feature trustworthy):
+ *   - CLEAN           : no detector fired.
+ *   - SUSPICIOUS      : only "suspicious" findings — human judgment required,
+ *                       NEVER auto-blocked.
+ *   - CONFIRMED_CHEAT : at least one "confirmed" finding — auto-blocked, because
+ *                       the pattern is unambiguous (whole test file deleted, a
+ *                       whole test-case block removed, or process.exit(0) added
+ *                       inside application code).
+ *
+ * Everything that is merely suggestive stays "suspicious" so a legitimate
+ * refactor that updates a test (because the spec changed) surfaces with full
+ * evidence for a human to judge — it is never silently reverted.
+ */
+export declare function buildIntegrityReport(repo: string, from: string, to: string, changes: FileChange[]): IntegrityReport;
+export { runDetectors };
+export type { IntegrityReport, Verdict, IntegrityFinding };

package/dist/graph/integrity.js

@@ -0,0 +1,39 @@
+import { runDetectors } from "../analyzers/integrity/index.js";
+/**
+ * Combine all detector output into a single integrity report with an overall
+ * verdict.
+ *
+ * CALIBRATION (the contract that keeps this feature trustworthy):
+ *   - CLEAN           : no detector fired.
+ *   - SUSPICIOUS      : only "suspicious" findings — human judgment required,
+ *                       NEVER auto-blocked.
+ *   - CONFIRMED_CHEAT : at least one "confirmed" finding — auto-blocked, because
+ *                       the pattern is unambiguous (whole test file deleted, a
+ *                       whole test-case block removed, or process.exit(0) added
+ *                       inside application code).
+ *
+ * Everything that is merely suggestive stays "suspicious" so a legitimate
+ * refactor that updates a test (because the spec changed) surfaces with full
+ * evidence for a human to judge — it is never silently reverted.
+ */
+export function buildIntegrityReport(repo, from, to, changes) {
+    const findings = runDetectors(changes);
+    const confirmed = findings.filter((f) => f.confidence === "confirmed").length;
+    const suspicious = findings.filter((f) => f.confidence === "suspicious").length;
+    let verdict = "CLEAN";
+    if (confirmed > 0)
+        verdict = "CONFIRMED_CHEAT";
+    else if (suspicious > 0)
+        verdict = "SUSPICIOUS";
+    return {
+        timestamp: new Date().toISOString(),
+        repo,
+        from,
+        to,
+        verdict,
+        findings,
+        summary: { confirmed, suspicious, total: findings.length },
+    };
+}
+export { runDetectors };
+//# sourceMappingURL=integrity.js.map

package/dist/graph/integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.js","sourceRoot":"","sources":["../../src/graph/integrity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,IAAY,EACZ,EAAU,EACV,OAAqB;IAErB,MAAM,QAAQ,GAAuB,YAAY,CAAC,OAAO,CAAC,CAAC;IAE3D,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAC9E,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC;IAEhF,IAAI,OAAO,GAAY,OAAO,CAAC;IAC/B,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,GAAG,iBAAiB,CAAC;SAC1C,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,GAAG,YAAY,CAAC;IAEhD,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI;QACJ,IAAI;QACJ,EAAE;QACF,OAAO;QACP,QAAQ;QACR,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE;KAC3D,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/installer/targets.d.ts

@@ -0,0 +1,23 @@
+export interface InstallTarget {
+    path: string;
+    tool: string;
+    level: "project" | "home";
+    transform?: "skill" | "workflow" | "gemini";
+    note?: string;
+}
+/** Absolute project-level targets, relative to the given repo/cwd. */
+export declare function projectTargets(cwd: string): InstallTarget[];
+/** Absolute user-level (home) targets. */
+export declare function homeTargets(): InstallTarget[];
+export declare function getTargets(cwd: string): InstallTarget[];
+/** Locate templates/pitstop.prompt.md relative to this module or cwd. */
+export declare function resolveTemplatePath(): string;
+/**
+ * Render the file content for a target. The Claude Code skill variant rewrites
+ * the frontmatter to { name, description } as skills require. The Antigravity
+ * workflow variant normalizes the frontmatter to `description` only (their
+ * required field) and keeps the title + numbered steps body as-is. The Gemini
+ * CLI variant converts to TOML ({ description = "...", prompt = """ body """ }),
+ * the format .gemini/commands/*.toml files must use.
+ */
+export declare function renderContent(target: InstallTarget, templateText: string): string;

package/dist/installer/targets.js

@@ -0,0 +1,162 @@
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+/** Absolute project-level targets, relative to the given repo/cwd. */
+export function projectTargets(cwd) {
+    const p = (...parts) => path.resolve(cwd, ...parts);
+    return [
+        { path: p(".claude", "commands", "pitstop.md"), tool: "Claude Code (project)", level: "project" },
+        {
+            path: p(".claude", "skills", "pitstop", "SKILL.md"),
+            tool: "Claude Code Skill",
+            level: "project",
+            transform: "skill",
+        },
+        { path: p(".cursor", "commands", "pitstop.md"), tool: "Cursor (project)", level: "project" },
+        { path: p(".opencode", "commands", "pitstop.md"), tool: "OpenCode (project)", level: "project" },
+        {
+            path: p(".opencode", "command", "pitstop.md"),
+            tool: "OpenCode (project, legacy)",
+            level: "project",
+        },
+        // Antigravity workflows: markdown files in .agent/workflows/ (singular,
+        // current docs) with YAML frontmatter `description` + title + steps,
+        // invoked as /pitstop. Older versions/3rd-party guides use the plural
+        // .agents/workflows/ — write both, one is harmless dead weight.
+        {
+            path: p(".agent", "workflows", "pitstop.md"),
+            tool: "Antigravity (project)",
+            level: "project",
+            transform: "workflow",
+        },
+        {
+            path: p(".agents", "workflows", "pitstop.md"),
+            tool: "Antigravity (project, plural legacy)",
+            level: "project",
+            transform: "workflow",
+        },
+        // Kilo Code current docs: slash commands live in .kilo/commands/ (project)
+        // and ~/.config/kilo/commands/ (global). .kilocode/workflows/ is the LEGACY
+        // location the new extension auto-migrates on startup — kept for old builds.
+        { path: p(".kilo", "commands", "pitstop.md"), tool: "Kilo Code (project)", level: "project" },
+        {
+            path: p(".kilocode", "workflows", "pitstop.md"),
+            tool: "Kilo Code (project, legacy — auto-migrated)",
+            level: "project",
+        },
+        {
+            path: p(".gemini", "commands", "pitstop.toml"),
+            tool: "Gemini CLI (project)",
+            level: "project",
+            transform: "gemini",
+        },
+    ];
+}
+/** Absolute user-level (home) targets. */
+export function homeTargets() {
+    const h = (...parts) => path.join(os.homedir(), ...parts);
+    return [
+        {
+            path: h(".codex", "prompts", "pitstop.md"),
+            tool: "Codex CLI (user)",
+            level: "home",
+            note: "Codex supports prompts only at user level",
+        },
+        { path: h(".claude", "commands", "pitstop.md"), tool: "Claude Code (user)", level: "home" },
+        { path: h(".cursor", "commands", "pitstop.md"), tool: "Cursor (user)", level: "home" },
+        // OpenCode current docs: global commands in ~/.config/opencode/commands/;
+        // ~/.opencode/commands/ is the older location — keep both.
+        {
+            path: h(".config", "opencode", "commands", "pitstop.md"),
+            tool: "OpenCode (user)",
+            level: "home",
+        },
+        {
+            path: h(".opencode", "commands", "pitstop.md"),
+            tool: "OpenCode (user, legacy)",
+            level: "home",
+        },
+        // Antigravity global workflows (home) mirror the project layout.
+        {
+            path: h(".agent", "workflows", "pitstop.md"),
+            tool: "Antigravity (user)",
+            level: "home",
+            transform: "workflow",
+        },
+        {
+            path: h(".agents", "workflows", "pitstop.md"),
+            tool: "Antigravity (user, plural legacy)",
+            level: "home",
+            transform: "workflow",
+        },
+        { path: h(".config", "kilo", "commands", "pitstop.md"), tool: "Kilo Code (user)", level: "home" },
+        {
+            path: h(".kilocode", "workflows", "pitstop.md"),
+            tool: "Kilo Code (user, legacy — auto-migrated)",
+            level: "home",
+        },
+        {
+            path: h(".gemini", "commands", "pitstop.toml"),
+            tool: "Gemini CLI (user)",
+            level: "home",
+            transform: "gemini",
+        },
+    ];
+}
+export function getTargets(cwd) {
+    return [...projectTargets(cwd), ...homeTargets()];
+}
+/** Locate templates/pitstop.prompt.md relative to this module or cwd. */
+export function resolveTemplatePath() {
+    const fromModule = fileURLToPath(new URL("../../templates/pitstop.prompt.md", import.meta.url));
+    if (fs.existsSync(fromModule))
+        return fromModule;
+    const fromCwd = path.resolve(process.cwd(), "templates", "pitstop.prompt.md");
+    if (fs.existsSync(fromCwd))
+        return fromCwd;
+    throw new Error("could not locate templates/pitstop.prompt.md");
+}
+/**
+ * Render the file content for a target. The Claude Code skill variant rewrites
+ * the frontmatter to { name, description } as skills require. The Antigravity
+ * workflow variant normalizes the frontmatter to `description` only (their
+ * required field) and keeps the title + numbered steps body as-is. The Gemini
+ * CLI variant converts to TOML ({ description = "...", prompt = """ body """ }),
+ * the format .gemini/commands/*.toml files must use.
+ */
+export function renderContent(target, templateText) {
+    if (target.transform === "skill") {
+        const m = templateText.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
+        if (!m)
+            return templateText;
+        const fm = m[1];
+        const body = m[2];
+        const descMatch = fm.match(/description:\s*(.+?)\s*$/m);
+        const description = descMatch ? descMatch[1].trim() : "";
+        return `---\nname: pitstop\ndescription: ${description}\n---\n\n${body}`;
+    }
+    if (target.transform === "workflow") {
+        const m = templateText.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
+        if (!m)
+            return templateText;
+        const fm = m[1];
+        const body = m[2];
+        const descMatch = fm.match(/description:\s*(.+?)\s*$/m);
+        const description = descMatch ? descMatch[1].trim() : "";
+        return `---\ndescription: ${description}\n---\n\n${body}`;
+    }
+    if (target.transform === "gemini") {
+        const m = templateText.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
+        if (!m)
+            return templateText;
+        const fm = m[1];
+        const body = m[2];
+        const descMatch = fm.match(/description:\s*(.+?)\s*$/m);
+        let description = descMatch ? descMatch[1].trim() : "";
+        description = description.replace(/^"|"$/g, "");
+        return `description = "${description}"\nprompt = """\n${body.trim()}\n"""\n`;
+    }
+    return templateText;
+}
+//# sourceMappingURL=targets.js.map

package/dist/installer/targets.js.map

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

package/dist/memory/store.d.ts

@@ -0,0 +1,33 @@
+export type MemoryType = "decision" | "fix" | "rejection";
+export interface MemoryEntry {
+    id: string;
+    timestamp: string;
+    type: MemoryType;
+    summary: string;
+    context: string;
+    relatedFiles: string[];
+}
+/**
+ * Identify "this repo" by hashing the git remote URL (fallback: absolute path).
+ * The hash determines the memory file name so memory is stable across checkouts.
+ */
+export declare function identifyRepo(repo: string): string;
+export declare function globalMemoryPath(repo: string): string;
+export declare function localMemoryPath(repo: string): string;
+export declare function loadEntries(repo: string): MemoryEntry[];
+export interface AddInput {
+    type: MemoryType;
+    summary: string;
+    context?: string;
+    relatedFiles?: string[];
+    mirror?: boolean;
+}
+export declare function addEntry(repo: string, input: AddInput): MemoryEntry;
+/**
+ * 1–2 hop undirected neighborhood of the given files in the dependency graph,
+ * as a set of absolute paths. Used to decide whether a memory entry is
+ * "relevant" to a file or cluster.
+ */
+export declare function buildNeighborhood(repo: string, files: string[]): Set<string>;
+export declare function relevantEntriesForFiles(repo: string, files: string[]): MemoryEntry[];
+export declare function relevantEntries(repo: string, filePath: string): MemoryEntry[];