@gobing-ai/spur 0.4.8 → 0.4.9

package/plugins/sp/lib/residual-scan.generated.d.mts

@@ -1,93 +0,0 @@
-/**
- * GENERATED by scripts/commands/bundle-plugin-lib.ts — do not edit.
- * Source of truth: packages/app/src/services/residual-scan.ts (task 1003 R5).
- */
-export declare type ResidualCategory =
-    | 'review-finding'
-    | 'diff-marker'
-    | 'unchecked-box'
-    | 'staging-residue'
-    | 'review-contract';
-export declare type ResidualClass = 'blocking' | 'deferrable' | 'advisory' | 'housekeeping';
-export declare interface ResidualItem {
-    id: string;
-    category: ResidualCategory;
-    class: ResidualClass;
-    priority?: string;
-    location: string;
-    text: string;
-}
-export declare interface ResidualArtifact {
-    wbs: string;
-    base: string | null;
-    scanned: Record<ResidualCategory, boolean>;
-    items: ResidualItem[];
-    counts: { blocking: number; deferrable: number; advisory: number; housekeeping: number };
-}
-export declare interface Deferral {
-    id: string;
-    reason: string;
-}
-export declare interface ResidualScanInputs {
-    wbs: string;
-    base: string | null;
-    taskContent: string;
-    addedLines: Array<{ file: string; line: number; text: string }>;
-    stagingResidue: string[];
-    deferrals: Deferral[];
-}
-export declare interface FoldResult {
-    verdict: 'PASS' | 'PARTIAL' | 'FAIL';
-    checks: Array<{ name: string; status: string; evidence: string }>;
-    findings: string;
-}
-export declare interface ParsedScanArgs {
-    mode: string;
-    wbs: string;
-    spurBin?: string;
-    root: string;
-    tmpDir: string;
-}
-export declare const ALLOW_PRAGMA: 'residual-scan:allow';
-export declare function recordedVerdictPath(runDir: string, wbs: string, fs: Pick<typeof import('node:fs'), 'lstatSync' | 'existsSync'>): string;
-export declare function makeItemId(category: ResidualCategory, location: string, text: string): string;
-export declare function normalizeAnchor(location: string): string;
-export declare function locationOf(locationCell: string, finding: string): string;
-export declare function parseReviewFindings(
-    taskContent: string,
-): Array<{ priority: string; location: string; text: string; deferral?: string }>;
-export declare function parseDiffMarkers(
-    addedLines: Array<{ file: string; line: number; text: string }>,
-): Array<{ location: string; text: string }>;
-export declare function findUncheckedBoxes(taskContent: string): Array<{ location: string; text: string }>;
-export declare function classify(
-    items: Array<Omit<ResidualItem, 'id' | 'class'> & { category: ResidualCategory }>,
-    deferrals: Deferral[],
-): ResidualItem[];
-export declare function scanResiduals(inputs: ResidualScanInputs): ResidualArtifact;
-export declare function parseDeferralEntries(raw: unknown): Deferral[];
-export declare function blockingReviewFindings(taskContent: string, deferrals: Deferral[]): ResidualItem[];
-export declare function reviewContractViolations(taskContent: string): Array<{ location: string; text: string }>;
-export declare function buildReviewGateArtifact(
-    wbs: string,
-    taskContent: string,
-    deferrals: Deferral[],
-): { artifact: ResidualArtifact; note: string };
-export declare function parseScanArgs(
-    argv: readonly (string | undefined)[],
-    cwd: string,
-    defaultTmpDir: string,
-): ParsedScanArgs | null;
-export declare function blockingAnchors(items: ResidualItem[]): string[];
-export declare function foldVerdict(
-    verdict: { verdict: string; checks: Array<{ name: string; status: string; evidence: string }> },
-    scan: ResidualArtifact,
-    existingFindings: string,
-    maxFindings?: number,
-): FoldResult;
-export declare function renderReport(wbs: string, items: ResidualItem[], attemptCount: number): string;
-export declare function verdictDisagreementNote(
-    runDir: string,
-    wbs: string,
-    fs: Pick<typeof import('node:fs'), 'existsSync' | 'readFileSync' | 'statSync'>,
-): string | null;

package/plugins/sp/lib/residual-scan.generated.mjs

@@ -1,383 +0,0 @@
-// packages/app/src/services/residual-scan.ts
-import { join } from "node:path";
-import { createHash } from "node:crypto";
-
-// packages/app/src/services/verify-answer-lint.ts
-var CLAIM_MARKERS = [
-  /@[a-z0-9._-]+\/[a-z0-9._-]+/i,
-  /\bnode_modules\//,
-  /\b\d+\.\d+\.\d+\b/,
-  /`[A-Za-z_$][\w.$]*\s*\([^`]*\)`/
-];
-var CITATION_FORMS = [
-  /`[^`\s]+:\d+(?:-\d+)?`/,
-  /`[^`]+`\s+lines?\s+\d+/i,
-  /\b[\w./-]+\.[A-Za-z0-9]+:\d+(?:-\d+)?\b/,
-  /https?:\/\/\S+/i
-];
-function hasClaimMarker(evidence) {
-  return CLAIM_MARKERS.some((re) => re.test(evidence));
-}
-function hasCitationForm(evidence) {
-  return CITATION_FORMS.some((re) => re.test(evidence));
-}
-
-// packages/app/src/services/residual-scan.ts
-var MARKER_PATTERN = /TODO|FIXME|XXX|HACK/;
-var PRIORITY_PATTERN = /^P[1-4]/;
-var RANGE_PRIORITY = /^P[1-4]\s*[\u2013\u2014-]\s*P?[1-4]/;
-var NONE_FINDING = /^(none( found)?|no (findings?|issues?)( found)?|\u2014)\s*(\(.*\))?\.?$/i;
-var DISPOSITION_HEADER = /^(Disposition|Action|Status|Resolution|Fixed)$/i;
-var RESOLVED_DISPOSITION = /^(FIXED|RESOLVED|DONE)\b/i;
-var DEFERRED_DISPOSITION = /^DEFER(RED)?\b/i;
-var ANCHOR_PATTERN = /[A-Za-z0-9_./-]+\.[A-Za-z]+:[0-9]+/g;
-var RANGE_ANCHOR = /([A-Za-z0-9_./-]+\.[A-Za-z]+):([0-9]+)-[0-9]+/g;
-var EXCLUDED_PATHS = ["docs/tasks", "docs/features/", ".spur/"];
-var ALLOW_PRAGMA = "residual-scan:allow";
-function makeItemId(category, location, text) {
-  const normalized = text.trim().replace(/\s+/g, " ");
-  const hex = createHash("sha256").update(`${location}${normalized}`).digest("hex");
-  return `${category}:${hex.slice(0, 8)}`;
-}
-function normalizeAnchor(location) {
-  return location.replace(RANGE_ANCHOR, "$1:$2");
-}
-function locationOf(locationCell, finding) {
-  const cell = locationCell.trim().replace(/`/g, "");
-  if (cell.length > 0 && cell !== "—")
-    return normalizeAnchor(cell);
-  const backtick = finding.match(/`([^`]+)`/)?.[1];
-  return backtick === undefined ? "" : normalizeAnchor(backtick);
-}
-function reviewBody(taskContent) {
-  const section = taskContent.split(/^### Review\b/m)[1];
-  return section === undefined ? null : section.split(/^### /m)[0] ?? "";
-}
-function parseReviewFindings(taskContent) {
-  const section = reviewBody(taskContent);
-  if (section === null)
-    return [];
-  const body = section;
-  const out = [];
-  const lines = body.split(`
-`);
-  for (let i = 0;i < lines.length; i++) {
-    const line = lines[i];
-    if (line === undefined || !line.trimStart().startsWith("|"))
-      continue;
-    const header = splitRow(line);
-    const priorityCol = header.findIndex((h) => h.trim() === "Priority");
-    if (priorityCol === -1) {
-      while (i + 1 < lines.length && lines[i + 1]?.trimStart().startsWith("|"))
-        i++;
-      continue;
-    }
-    const findingCol = header.findIndex((h) => h.trim() === "Finding");
-    const locationCol = header.findIndex((h) => h.trim() === "Location");
-    const dispositionCol = header.findIndex((h) => DISPOSITION_HEADER.test(h.trim()));
-    i++;
-    const sep = lines[i];
-    if (sep !== undefined && /^\s*\|[\s:|-]+\|\s*$/.test(sep))
-      i++;
-    while (i < lines.length) {
-      const row = lines[i];
-      if (row === undefined || !row.trimStart().startsWith("|"))
-        break;
-      const cells = splitRow(row);
-      const priority = (cells[priorityCol] ?? "").trim();
-      const finding = (cells[findingCol] ?? "").trim();
-      const disposition = dispositionCol === -1 ? "" : (cells[dispositionCol] ?? "").trim();
-      if (PRIORITY_PATTERN.test(priority) && !RANGE_PRIORITY.test(priority) && !NONE_FINDING.test(finding) && finding.length > 0 && !RESOLVED_DISPOSITION.test(disposition)) {
-        const location = locationOf(cells[locationCol] ?? "", finding);
-        out.push(DEFERRED_DISPOSITION.test(disposition) ? { priority, location, text: finding, deferral: disposition } : { priority, location, text: finding });
-      }
-      i++;
-    }
-  }
-  return out;
-}
-function splitRow(line) {
-  return line.trim().replace(/^\|/, "").replace(/\|$/, "").split(/(?<!\\)\|/).map((c) => c.trim());
-}
-function parseDiffMarkers(addedLines) {
-  return addedLines.filter((l) => !EXCLUDED_PATHS.some((p) => l.file.startsWith(p))).filter((l) => !l.text.includes(ALLOW_PRAGMA)).filter((l) => MARKER_PATTERN.test(l.text)).map((l) => ({ location: `${l.file}:${l.line}`, text: l.text.trim() }));
-}
-function findUncheckedBoxes(taskContent) {
-  const path = "task-file";
-  return taskContent.split(`
-`).map((text, idx) => ({ text: text.trim(), line: idx + 1 })).filter((l) => l.text.startsWith("- [ ]")).map((l) => ({ location: `${path}:${l.line}`, text: l.text }));
-}
-function classify(items, deferrals) {
-  const deferred = new Map(deferrals.map((d) => [d.id, d.reason]));
-  return items.map((item) => {
-    const id = makeItemId(item.category, item.location, item.text);
-    let klass;
-    if (item.category === "review-finding")
-      klass = item.priority?.startsWith("P4") ? "advisory" : "blocking";
-    else if (item.category === "staging-residue")
-      klass = "housekeeping";
-    else
-      klass = "blocking";
-    if (klass === "blocking" && item.category !== "unchecked-box") {
-      const p3Like = item.category === "diff-marker" || item.category === "review-finding" && (item.priority ?? "").startsWith("P3");
-      const reason = deferred.get(id);
-      if (p3Like && reason !== undefined && reason.trim().length > 0)
-        klass = "deferrable";
-    }
-    return {
-      id,
-      category: item.category,
-      class: klass,
-      priority: item.priority,
-      location: item.location,
-      text: item.text
-    };
-  });
-}
-function scanResiduals(inputs) {
-  const { wbs, base, taskContent, addedLines, stagingResidue, deferrals } = inputs;
-  const reviewRows = parseReviewFindings(taskContent);
-  const tableDeferrals = reviewRows.flatMap((r) => r.deferral === undefined ? [] : [{ id: makeItemId("review-finding", r.location, r.text), reason: r.deferral }]);
-  const review = reviewRows.map((r) => ({
-    category: "review-finding",
-    priority: r.priority,
-    location: r.location,
-    text: r.text
-  }));
-  const markers = base === null ? [] : parseDiffMarkers(addedLines).map((m) => ({
-    category: "diff-marker",
-    location: m.location,
-    text: m.text
-  }));
-  const boxes = findUncheckedBoxes(taskContent).map((b) => ({
-    category: "unchecked-box",
-    location: b.location,
-    text: b.text
-  }));
-  const residue = stagingResidue.map((p) => ({
-    category: "staging-residue",
-    location: p,
-    text: p
-  }));
-  const items = classify([...review, ...markers, ...boxes, ...residue], [...tableDeferrals, ...deferrals]);
-  const counts = { blocking: 0, deferrable: 0, advisory: 0, housekeeping: 0 };
-  for (const item of items)
-    counts[item.class]++;
-  return {
-    wbs,
-    base,
-    scanned: {
-      "review-finding": true,
-      "diff-marker": base !== null,
-      "unchecked-box": true,
-      "staging-residue": true,
-      "review-contract": false
-    },
-    items,
-    counts
-  };
-}
-function parseDeferralEntries(raw) {
-  const isDeferral = (e) => typeof e === "object" && e !== null && typeof e.id === "string" && typeof e.reason === "string" && e.reason.trim().length > 0;
-  return (Array.isArray(raw) ? raw : []).filter(isDeferral);
-}
-function blockingReviewFindings(taskContent, deferrals) {
-  const rows = parseReviewFindings(taskContent);
-  const tableDeferrals = rows.flatMap((r) => r.deferral === undefined ? [] : [{ id: makeItemId("review-finding", r.location, r.text), reason: r.deferral }]);
-  const items = rows.map((r) => ({
-    category: "review-finding",
-    priority: r.priority,
-    location: r.location,
-    text: r.text
-  }));
-  return classify(items, [...tableDeferrals, ...deferrals]);
-}
-function reviewContractViolations(taskContent) {
-  const violations = [];
-  for (const row of parseReviewFindings(taskContent)) {
-    if (hasClaimMarker(row.text) && !hasCitationForm(row.text)) {
-      violations.push({
-        location: row.location.length > 0 ? row.location : "task-file:Review",
-        text: `${row.priority} finding asserts an external API/library/version claim without a ` + "same-cell citation (add a repo `path:line`, an external named-origin form, or a URL " + `to the Finding cell): ${row.text.slice(0, 80)}`
-      });
-    }
-  }
-  return violations;
-}
-function buildReviewGateArtifact(wbs, taskContent, deferrals) {
-  const contractViolations = reviewContractViolations(taskContent);
-  const items = [
-    ...blockingReviewFindings(taskContent, deferrals),
-    ...contractViolations.map((v) => ({
-      id: makeItemId("review-contract", v.location, v.text),
-      category: "review-contract",
-      class: "blocking",
-      location: v.location,
-      text: v.text
-    }))
-  ];
-  const blocking = items.filter((i) => i.class === "blocking");
-  const counts = { blocking: 0, deferrable: 0, advisory: 0, housekeeping: 0 };
-  for (const item of items)
-    counts[item.class]++;
-  const artifact = {
-    wbs,
-    base: null,
-    scanned: {
-      "review-finding": true,
-      "diff-marker": false,
-      "unchecked-box": false,
-      "staging-residue": false,
-      "review-contract": true
-    },
-    items,
-    counts
-  };
-  const note = `residual-review-gate: ${wbs} blocking=${counts.blocking}` + (blocking.length > 0 ? ` ids=${blocking.map((i) => i.id).join(",")} anchors=${blockingAnchors(blocking).join(",")}` : "") + `
-`;
-  return { artifact, note };
-}
-function blockingAnchors(items) {
-  const anchors = new Set;
-  for (const item of items) {
-    if (item.class !== "blocking")
-      continue;
-    for (const m of normalizeAnchor(item.location).matchAll(ANCHOR_PATTERN))
-      anchors.add(m[0]);
-  }
-  return [...anchors];
-}
-function foldVerdict(verdict, scan, existingFindings, maxFindings = 20) {
-  const blocking = scan.items.filter((i) => i.class === "blocking");
-  const deferrable = scan.items.filter((i) => i.class === "deferrable");
-  const evidence = `blocking=${blocking.length} deferrable=${deferrable.length} advisory=${scan.counts.advisory} housekeeping=${scan.counts.housekeeping}` + (blocking.length > 0 ? `; blocking ids: ${blocking.map((i) => i.id).join(", ")}` : "") + (deferrable.length > 0 ? `; deferrable ids: ${deferrable.map((i) => i.id).join(", ")}` : "");
-  const checks = verdict.checks.filter((c) => c.name !== "residual-sweep");
-  checks.push({ name: "residual-sweep", status: blocking.length > 0 ? "fail" : "pass", evidence });
-  const merged = new Set([
-    ...existingFindings.split(/\s+/).filter((a) => a.length > 0),
-    ...blockingAnchors(scan.items)
-  ]);
-  const findings = [...merged].sort().slice(0, maxFindings).map((a) => `${a} `).join("");
-  let verdictStatus = verdict.verdict === "PASS" ? "PASS" : "FAIL";
-  if (verdict.verdict === "PARTIAL")
-    verdictStatus = "PARTIAL";
-  else if (verdict.verdict === "FAIL")
-    verdictStatus = "FAIL";
-  else if (blocking.length > 0)
-    verdictStatus = "PARTIAL";
-  return { verdict: verdictStatus, checks, findings };
-}
-function renderReport(wbs, items, attemptCount) {
-  const lines = [
-    `# Residual report — ${wbs}`,
-    "",
-    `Attempt: ${attemptCount}`,
-    "",
-    "| Category | Class | Location | Text |",
-    "| --- | --- | --- | --- |"
-  ];
-  for (const item of items) {
-    lines.push(`| ${item.category} | ${item.class} | ${item.location} | ${item.text.replace(/\|/g, "\\|")} |`);
-  }
-  return `${lines.join(`
-`)}
-`;
-}
-function recordedVerdictPath(runDir, wbs, fs) {
-  const evidence = join(runDir, "..", "memory", "evidence");
-  const durable = join(evidence, `${wbs}-verdict.json`);
-  const run = join(runDir, `${wbs}-verdict.json`);
-  for (const path of [join(runDir, ".."), join(evidence, ".."), evidence, durable, run]) {
-    try {
-      if (fs.lstatSync(path).isSymbolicLink())
-        throw new Error(`residual-scan: symlink evidence path: ${path}`);
-    } catch (error) {
-      if (error.code !== "ENOENT")
-        throw error;
-    }
-  }
-  if (!fs.existsSync(durable))
-    return run;
-  if (!fs.existsSync(run))
-    return durable;
-  const newer = (a, b) => mtimeOf(fs, b) > mtimeOf(fs, a) ? b : a;
-  return newer(run, durable);
-}
-function mtimeOf(fs, path) {
-  try {
-    return fs.statSync(path).mtimeMs;
-  } catch {
-    return 0;
-  }
-}
-function verdictDisagreementNote(runDir, wbs, fs) {
-  const run = join(runDir, `${wbs}-verdict.json`);
-  const durable = join(runDir, "..", "memory", "evidence", `${wbs}-verdict.json`);
-  if (!fs.existsSync(run) || !fs.existsSync(durable))
-    return null;
-  const bytes = (path) => {
-    try {
-      return fs.statSync(path).isFile() ? fs.readFileSync(path, "utf8") : null;
-    } catch {
-      return null;
-    }
-  };
-  const runBytes = bytes(run);
-  if (runBytes === null || runBytes === bytes(durable))
-    return null;
-  const value = (path) => {
-    try {
-      return JSON.parse(bytes(path) ?? "{}").verdict ?? "?";
-    } catch {
-      return "?";
-    }
-  };
-  const winner = mtimeOf(fs, durable) > mtimeOf(fs, run) ? "durable" : "run";
-  return `residual-fold: ${wbs} verdict copies disagree — run=${run} (${value(run)}) durable=${durable} (${value(durable)})` + ` → chose ${winner} (newer mtime)`;
-}
-function parseScanArgs(argv, cwd, defaultTmpDir) {
-  let mode = "";
-  let wbs = "";
-  let spurBin;
-  let root = cwd;
-  let tmpDir = defaultTmpDir;
-  for (let i = 0;i < argv.length; i++) {
-    const a = argv[i];
-    if (a === undefined)
-      break;
-    if (a === "--spur-bin")
-      spurBin = argv[++i];
-    else if (a === "--root")
-      root = argv[++i] ?? root;
-    else if (a === "--tmp-dir")
-      tmpDir = argv[++i] ?? tmpDir;
-    else if (a === "--help" || a === "-h")
-      return null;
-    else if (mode === "")
-      mode = a;
-    else if (wbs === "")
-      wbs = a;
-  }
-  return mode === "" || wbs === "" ? null : { mode, wbs, spurBin, root, tmpDir };
-}
-export {
-  ALLOW_PRAGMA,
-  blockingAnchors,
-  blockingReviewFindings,
-  buildReviewGateArtifact,
-  classify,
-  findUncheckedBoxes,
-  foldVerdict,
-  locationOf,
-  makeItemId,
-  normalizeAnchor,
-  parseDeferralEntries,
-  parseDiffMarkers,
-  parseReviewFindings,
-  parseScanArgs,
-  recordedVerdictPath,
-  renderReport,
-  reviewContractViolations,
-  scanResiduals,
-  verdictDisagreementNote
-};