@gobing-ai/spur 0.4.8 → 0.4.10

package/plugins/sp/scripts/dogfood-testing/detect-pipeline-driving.mjs

@@ -1,211 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from "node:module";
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-// plugins/sp/lib/dogfood-pipeline.ts
-var PIPELINE_TOKENS = [
-  "--next",
-  "dev-runall",
-  "dev-wrapall",
-  "dev-refineall",
-  "dev-verifyall",
-  "dev-run",
-  "dev-wrap",
-  "dev-idea",
-  "refineall",
-  "verifyall",
-  "runall",
-  "wrapall",
-  "run",
-  "wrap",
-  "idea"
-];
-var PIPELINE_DRIVING_REFUSE_MESSAGE = "⚠ pipeline-driving testee detected; pass --max-retry 0 (observe-only) or --max-retry N (fix mode, tree mutation acknowledged)";
-var MUTATING_FIX_REFUSE_MESSAGE = "⚠ mutating --fix mode detected (--fix all | --fix blockers-first); pass --max-retry 0 (observe-only for the driver; the testee still mutates the tree) or --max-retry N (fix mode, driver + testee both mutate)";
-var IMPLEMENT_HEAVY_ADVISORY_MESSAGE = "⚠ implement-heavy pipeline dogfood: prefer --max-retry 0 (observe-only) or step-split; operator --max-retry N overrides";
-var IMPLEMENT_HEAVY_TOKENS = [
-  "dev-runall",
-  "dev-wrapall",
-  "dev-run",
-  "dev-wrap",
-  "dev-idea",
-  "runall",
-  "wrapall",
-  "run",
-  "wrap",
-  "idea",
-  "implement"
-];
-function hasMutatingFixMode(step) {
-  return /(?<![\w-])--fix[=\s]+(all|blockers-first)(?![\w-])/i.test(step);
-}
-function tokenMatches(testee, token) {
-  const escaped = token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const re = new RegExp(`(?<![\\w-])${escaped}(?![\\w-])`, "i");
-  return re.test(testee);
-}
-function detectPipelineDriving(testee) {
-  if (typeof testee !== "string" || testee.length === 0) {
-    return false;
-  }
-  return PIPELINE_TOKENS.some((token) => tokenMatches(testee, token));
-}
-function isImplementHeavyStep(step) {
-  if (typeof step !== "string" || step.length === 0)
-    return false;
-  const nonMutatingOnly = tokenMatches(step, "dev-verify") || tokenMatches(step, "dev-review") || tokenMatches(step, "dev-unit");
-  const hasMutating = IMPLEMENT_HEAVY_TOKENS.some((token) => tokenMatches(step, token)) || hasMutatingFixMode(step);
-  if (nonMutatingOnly && !hasMutating)
-    return false;
-  if (tokenMatches(step, "dev-refine") && !hasMutating && !tokenMatches(step, "--next")) {
-    return false;
-  }
-  if (tokenMatches(step, "dev-refine") && tokenMatches(step, "--next")) {
-    return true;
-  }
-  return hasMutating;
-}
-function detectImplementHeavy(testee, derivedSteps = []) {
-  if (isImplementHeavyStep(testee))
-    return true;
-  if (!detectPipelineDriving(testee))
-    return false;
-  return derivedSteps.some((step) => isImplementHeavyStep(step));
-}
-function evaluateDogfoodGate(testee, options = {}) {
-  const maxRetryPresent = options.maxRetryPresent === true;
-  const steps = options.steps ?? [];
-  const pipelineDriving = detectPipelineDriving(testee);
-  const mutatingFix = hasMutatingFixMode(testee);
-  const implementHeavy = detectImplementHeavy(testee, steps);
-  if (pipelineDriving && !maxRetryPresent) {
-    return {
-      pipelineDriving,
-      mutatingFix,
-      maxRetryPresent,
-      implementHeavy,
-      refuse: true,
-      advisory: false,
-      message: PIPELINE_DRIVING_REFUSE_MESSAGE,
-      exitCode: 2
-    };
-  }
-  if (mutatingFix && !maxRetryPresent) {
-    return {
-      pipelineDriving,
-      mutatingFix,
-      maxRetryPresent,
-      implementHeavy,
-      refuse: true,
-      advisory: false,
-      message: MUTATING_FIX_REFUSE_MESSAGE,
-      exitCode: 2
-    };
-  }
-  if (implementHeavy) {
-    return {
-      pipelineDriving,
-      mutatingFix,
-      maxRetryPresent,
-      implementHeavy,
-      refuse: false,
-      advisory: true,
-      message: IMPLEMENT_HEAVY_ADVISORY_MESSAGE,
-      exitCode: 0
-    };
-  }
-  return {
-    pipelineDriving,
-    mutatingFix,
-    maxRetryPresent,
-    implementHeavy,
-    refuse: false,
-    advisory: false,
-    message: null,
-    exitCode: 0
-  };
-}
-// plugins/sp/scripts/dogfood-testing/detect-pipeline-driving.ts
-function parseCliArgs(argv) {
-  let testee = null;
-  let maxRetryPresent = false;
-  let steps = [];
-  let json = false;
-  let help = false;
-  for (let i = 0;i < argv.length; i++) {
-    const a = argv[i];
-    if (a === undefined)
-      continue;
-    if (a === "--help" || a === "-h") {
-      help = true;
-    } else if (a === "--json") {
-      json = true;
-    } else if (a === "--max-retry-present") {
-      maxRetryPresent = true;
-    } else if (a === "--testee") {
-      testee = argv[++i] ?? null;
-    } else if (a === "--steps") {
-      const raw = argv[++i] ?? "";
-      steps = raw.length === 0 ? [] : raw.split("||").map((s) => s.trim()).filter(Boolean);
-    } else if (a === "--") {
-      testee = argv.slice(i + 1).join(" ");
-      break;
-    } else if (!a.startsWith("-") && testee === null) {
-      testee = a;
-    }
-  }
-  return { testee, maxRetryPresent, steps, json, help };
-}
-var CLI_USAGE = `Usage:
-  bun plugins/sp/scripts/dogfood-testing/detect-pipeline-driving.ts \\
-    --testee "<testee string>" [--max-retry-present] [--steps "s1||s2"] [--json]
-
-Exit codes:
-  0  proceed (stdout may carry implement-heavy advisory)
-  2  refuse — pipeline-driving OR mutating --fix mode without --max-retry
-  1  usage error
-
-Phase 1.0: run BEFORE deriving steps (omit --steps).
-Phase 1 W8: re-run AFTER step derivation with --steps "label1||label2".`;
-function runCli(argv) {
-  const { testee, maxRetryPresent, steps, json, help } = parseCliArgs(argv);
-  if (help) {
-    return { exitCode: 0, stdout: "", stderr: CLI_USAGE };
-  }
-  if (testee === null || testee.length === 0) {
-    return { exitCode: 1, stdout: "", stderr: CLI_USAGE };
-  }
-  const result = evaluateDogfoodGate(testee, { maxRetryPresent, steps });
-  if (json) {
-    return { exitCode: result.exitCode, stdout: `${JSON.stringify(result, null, 2)}
-`, stderr: "" };
-  }
-  if (result.message) {
-    return { exitCode: result.exitCode, stdout: `${result.message}
-`, stderr: "" };
-  }
-  return { exitCode: result.exitCode, stdout: "", stderr: "" };
-}
-{
-  const { exitCode, stdout, stderr } = runCli(process.argv.slice(2));
-  if (stdout)
-    process.stdout.write(stdout);
-  if (stderr)
-    process.stderr.write(`${stderr}
-`);
-  process.exit(exitCode);
-}
-export {
-  CLI_USAGE,
-  IMPLEMENT_HEAVY_ADVISORY_MESSAGE,
-  MUTATING_FIX_REFUSE_MESSAGE,
-  PIPELINE_DRIVING_REFUSE_MESSAGE,
-  PIPELINE_TOKENS,
-  detectImplementHeavy,
-  detectPipelineDriving,
-  evaluateDogfoodGate,
-  hasMutatingFixMode,
-  isImplementHeavyStep,
-  parseCliArgs,
-  runCli
-};

package/plugins/sp/scripts/dogfood-testing/detect-pipeline-driving.ts

@@ -1,110 +0,0 @@
-/**
- * detect-pipeline-driving — live Phase 1.0 CLI gate over the @1.2 detector (task 0277 W7).
- *
- * The detector and its policy helpers are application-owned in
- * `plugins/sp/lib/dogfood-pipeline.ts` (task 1173); this script keeps the shell entry the dogfood
- * driver calls, with argv, usage, exit codes and refusal messages unchanged. Callers and tests may
- * keep importing this path — every former export is re-exported.
- *
- *   bun plugins/sp/scripts/dogfood-testing/detect-pipeline-driving.ts \
- *     --testee "/sp:dev-run 0125 --auto --next" [--max-retry-present] \
- *     [--steps "step1||step2"] [--json]
- *
- * Exit codes:
- *   0 — proceed (may print implement-heavy advisory on stderr)
- *   2 — refuse: pipeline-driving without explicit --max-retry
- *   1 — usage / argument error
- */
-
-import { evaluateDogfoodGate } from '../../lib/dogfood-pipeline';
-
-export * from '../../lib/dogfood-pipeline';
-
-export interface CliArgs {
-    testee: string | null;
-    maxRetryPresent: boolean;
-    steps: string[];
-    json: boolean;
-    help: boolean;
-}
-
-/** Parse CLI argv (everything after the script name). Exported for unit tests. */
-export function parseCliArgs(argv: string[]): CliArgs {
-    let testee: string | null = null;
-    let maxRetryPresent = false;
-    let steps: string[] = [];
-    let json = false;
-    let help = false;
-
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === undefined) continue;
-        if (a === '--help' || a === '-h') {
-            help = true;
-        } else if (a === '--json') {
-            json = true;
-        } else if (a === '--max-retry-present') {
-            maxRetryPresent = true;
-        } else if (a === '--testee') {
-            testee = argv[++i] ?? null;
-        } else if (a === '--steps') {
-            const raw = argv[++i] ?? '';
-            steps =
-                raw.length === 0
-                    ? []
-                    : raw
-                          .split('||')
-                          .map((s) => s.trim())
-                          .filter(Boolean);
-        } else if (a === '--') {
-            testee = argv.slice(i + 1).join(' ');
-            break;
-        } else if (!a.startsWith('-') && testee === null) {
-            testee = a;
-        }
-    }
-
-    return { testee, maxRetryPresent, steps, json, help };
-}
-
-export const CLI_USAGE = `Usage:
-  bun plugins/sp/scripts/dogfood-testing/detect-pipeline-driving.ts \\
-    --testee "<testee string>" [--max-retry-present] [--steps "s1||s2"] [--json]
-
-Exit codes:
-  0  proceed (stdout may carry implement-heavy advisory)
-  2  refuse — pipeline-driving OR mutating --fix mode without --max-retry
-  1  usage error
-
-Phase 1.0: run BEFORE deriving steps (omit --steps).
-Phase 1 W8: re-run AFTER step derivation with --steps "label1||label2".`;
-
-/**
- * Pure CLI runner for tests: returns { exitCode, stdout, stderr } without
- * process.exit / console I/O side effects.
- */
-export function runCli(argv: string[]): { exitCode: number; stdout: string; stderr: string } {
-    const { testee, maxRetryPresent, steps, json, help } = parseCliArgs(argv);
-    if (help) {
-        return { exitCode: 0, stdout: '', stderr: CLI_USAGE };
-    }
-    if (testee === null || testee.length === 0) {
-        return { exitCode: 1, stdout: '', stderr: CLI_USAGE };
-    }
-
-    const result = evaluateDogfoodGate(testee, { maxRetryPresent, steps });
-    if (json) {
-        return { exitCode: result.exitCode, stdout: `${JSON.stringify(result, null, 2)}\n`, stderr: '' };
-    }
-    if (result.message) {
-        return { exitCode: result.exitCode, stdout: `${result.message}\n`, stderr: '' };
-    }
-    return { exitCode: result.exitCode, stdout: '', stderr: '' };
-}
-
-if (import.meta.main) {
-    const { exitCode, stdout, stderr } = runCli(process.argv.slice(2));
-    if (stdout) process.stdout.write(stdout);
-    if (stderr) process.stderr.write(`${stderr}\n`);
-    process.exit(exitCode);
-}

package/plugins/sp/scripts/dogfood-testing/validate-report.mjs

@@ -1,282 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from "node:module";
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-// plugins/sp/scripts/dogfood-testing/validate-report.ts
-import { readFileSync } from "node:fs";
-
-// plugins/sp/lib/dogfood-report.ts
-var REQUIRED_SECTIONS = [1, 2, 3, 4, 5, 6];
-var CANONICAL_PROTOCOL = "sp:dogfood-testing@1.2";
-function countSectionHeadings(markdown, section) {
-  const re = new RegExp(`^### ${section}\\.`, "gm");
-  return (markdown.match(re) ?? []).length;
-}
-function countLedgerDataRows(markdown) {
-  const heading = markdown.match(/^### 3\. Monitor Ledger\s*$/m);
-  if (!heading || heading.index === undefined)
-    return null;
-  const after = markdown.slice(heading.index + heading[0].length);
-  const nextHeading = after.search(/^### /m);
-  const body = nextHeading === -1 ? after : after.slice(0, nextHeading);
-  const rows = body.split(`
-`).filter((line) => line.trim().startsWith("|")).filter((line) => !/^\|[\s:|-]+\|?\s*$/.test(line.trim())).filter((line) => !/^\|\s*`?drift:/.test(line.trim()));
-  return Math.max(rows.length - 1, 0);
-}
-function declaredExecutedSteps(markdown) {
-  const match = markdown.match(/\*\*Steps:\*\*\s*\d+\s+derived,\s*(\d+)\s+executed/)?.[1];
-  return match ? Number.parseInt(match, 10) : null;
-}
-var UNKNOWN_CELLS = new Set(["~unknown", "unknown", "—", "-", "?", "n/a", "~n/a"]);
-var CACHE_SHARE_TOLERANCE = 1;
-function sectionBody(markdown, headingRe) {
-  const heading = markdown.match(headingRe);
-  if (!heading || heading.index === undefined)
-    return null;
-  const after = markdown.slice(heading.index + heading[0].length);
-  const nextHeading = after.search(/^###? /m);
-  return nextHeading === -1 ? after : after.slice(0, nextHeading);
-}
-function parseTokensLine(line) {
-  const match = line.match(/~(?<total>n\/a|\d+)\s+total\s*\|\s*~(?<cached>n\/a|\d+)\s+cached(?:\s*\(\s*~?(?<pct>n\/a|\d+(?:\.\d+)?)%\s*hit rate\))?/i);
-  if (!match)
-    return null;
-  const num = (v) => v === undefined ? null : v === "n/a" ? "n/a" : Number.parseInt(v, 10);
-  return { total: num(match.groups?.total), cached: num(match.groups?.cached), pct: num(match.groups?.pct) };
-}
-function parseTokenCell(cell) {
-  const t = cell.trim();
-  if (UNKNOWN_CELLS.has(t))
-    return null;
-  const m = t.match(/~?(\d+)/)?.[1];
-  return m ? Number.parseInt(m, 10) : null;
-}
-function parsePctCell(cell) {
-  const t = cell.trim();
-  if (UNKNOWN_CELLS.has(t))
-    return null;
-  const m = t.match(/(\d+(?:\.\d+)?)\s*%/)?.[1];
-  return m ? Number.parseFloat(m) : null;
-}
-function ledgerCostRows(markdown) {
-  const body = sectionBody(markdown, /^### 3\. Monitor Ledger\s*$/m);
-  if (body === null)
-    return [];
-  return body.split(`
-`).filter((line) => line.trim().startsWith("|")).filter((line) => !/^\|[\s:|-]+\|?\s*$/.test(line.trim())).filter((line) => !/^\|\s*`?drift:/.test(line.trim())).slice(1).map((line) => {
-    const cells = line.split("|").map((c) => c.trim()).filter((c, i, a) => !(i === 0 && c === "") && !(i === a.length - 1 && c === ""));
-    const freshCell = cells[5] ?? "";
-    const cachedCell = cells[6] ?? "";
-    return {
-      step: cells[0] ?? "",
-      fresh: parseTokenCell(freshCell),
-      cached: parseTokenCell(cachedCell),
-      cachePct: parsePctCell(cells[7] ?? ""),
-      unknownCell: UNKNOWN_CELLS.has(freshCell) || UNKNOWN_CELLS.has(cachedCell)
-    };
-  });
-}
-function validateCostEvidence(markdown, errors) {
-  const costBlock = sectionBody(markdown, /^#### Cost\s*$/m);
-  if (costBlock === null) {
-    errors.push("missing_cost_block");
-    return;
-  }
-  for (const field of ["Ledger estimate", "Method", "Meter"]) {
-    if (!costBlock.includes(`**${field}:**`))
-      errors.push(`missing_cost_field:${field}`);
-  }
-  const ledgerLine = costBlock.split(`
-`).find((l) => l.includes("**Ledger estimate:**")) ?? "";
-  const costTotals = parseTokensLine(ledgerLine);
-  if (ledgerLine !== "" && costTotals === null)
-    errors.push("malformed_cost_line");
-  const footerLine = markdown.split(`
-`).find((l) => l.trim().startsWith("Tokens:"));
-  const footerTotals = footerLine ? parseTokensLine(footerLine) : null;
-  if (footerLine !== undefined && footerTotals === null)
-    errors.push("malformed_footer");
-  if (footerLine === undefined && markdown.includes("── Dogfood Summary ──")) {
-    errors.push("missing_footer_tokens");
-  }
-  const pctScopes = [costBlock, footerLine ?? ""];
-  for (const row of ledgerCostRows(markdown)) {
-    if (row.cachePct !== null)
-      pctScopes.push(`${row.cachePct}%`);
-  }
-  for (const scope of pctScopes) {
-    for (const m of scope.matchAll(/(\d+(?:\.\d+)?)\s*%/g)) {
-      const pct = Number.parseFloat(m[1] ?? "");
-      if (pct < 0 || pct > 100)
-        errors.push(`impossible_percentage:${m[0].trim()}`);
-    }
-  }
-  const rows = ledgerCostRows(markdown);
-  for (const row of rows) {
-    if (row.unknownCell && row.cachePct !== null)
-      errors.push("unknown_row_with_numeric_cache");
-  }
-  for (const row of rows) {
-    if (row.fresh === null || row.cached === null || row.cachePct === null)
-      continue;
-    const basis = row.fresh + row.cached;
-    if (basis === 0)
-      continue;
-    const expected = Math.round(row.cached / basis * 100);
-    if (Math.abs(row.cachePct - expected) > CACHE_SHARE_TOLERANCE) {
-      errors.push(`cache_pct_mismatch:${row.step}_expected_${expected}`);
-    }
-  }
-  const observable = rows.filter((r) => r.fresh !== null && r.cached !== null);
-  const sumFresh = observable.reduce((acc, r) => acc + (r.fresh ?? 0), 0);
-  const sumCached = observable.reduce((acc, r) => acc + (r.cached ?? 0), 0);
-  const checkTotals = (label, totals) => {
-    if (totals === null)
-      return;
-    if (observable.length > 0) {
-      const expectedTotal = sumFresh + sumCached;
-      if (typeof totals.total === "number" && totals.total !== expectedTotal) {
-        errors.push(`cost_total_mismatch:${label}_expected_${expectedTotal}`);
-      }
-      if (typeof totals.cached === "number" && totals.cached !== sumCached) {
-        errors.push(`cost_total_mismatch:${label}_cached_expected_${sumCached}`);
-      }
-      const expectedPct = expectedTotal > 0 ? Math.round(sumCached / expectedTotal * 100) : null;
-      if (expectedPct !== null) {
-        if (totals.pct === "n/a" || totals.pct === null) {
-          errors.push(`missing_cache_share:${label}`);
-        } else if (typeof totals.pct === "number" && Math.abs(totals.pct - expectedPct) > CACHE_SHARE_TOLERANCE) {
-          errors.push(`cache_share_mismatch:${label}_expected_${expectedPct}`);
-        }
-      }
-    } else if (typeof totals.total === "number" || typeof totals.cached === "number" || typeof totals.pct === "number") {
-      errors.push(`fabricated_cache_share:${label}`);
-    }
-  };
-  checkTotals("cost", costTotals);
-  checkTotals("footer", footerTotals);
-}
-function validateReport(markdown) {
-  const errors = [];
-  if (!markdown.includes("── Dogfood Summary ──"))
-    errors.push("missing_footer");
-  if (!markdown.includes("[Live:"))
-    errors.push("missing_live_path");
-  if (!markdown.includes("[Report:"))
-    errors.push("missing_report_path");
-  for (const section of REQUIRED_SECTIONS) {
-    const count = countSectionHeadings(markdown, section);
-    if (count === 0)
-      errors.push(`missing_section:${section}`);
-    if (count > 1)
-      errors.push(`duplicate_section:${section}`);
-  }
-  if (!markdown.includes("#### Fixed") || !markdown.includes("#### Unresolved")) {
-    errors.push("missing_issues_subheads");
-  }
-  const protocolMatch = markdown.match(/^protocol:\s*(\S+)\s*$/m);
-  if (!protocolMatch || protocolMatch[1] !== CANONICAL_PROTOCOL) {
-    errors.push("protocol_string");
-  }
-  const executed = declaredExecutedSteps(markdown);
-  if (executed === null) {
-    errors.push("missing_steps_declared");
-  } else {
-    const rows = countLedgerDataRows(markdown);
-    if (rows === null || rows !== executed) {
-      errors.push("ledger_cardinality");
-    }
-  }
-  validateCostEvidence(markdown, errors);
-  return { ok: errors.length === 0, errors };
-}
-// plugins/sp/scripts/dogfood-testing/validate-report.ts
-function parseValidateCliArgs(argv) {
-  let file = null;
-  let json = false;
-  let help = false;
-  for (let i = 0;i < argv.length; i++) {
-    const a = argv[i];
-    if (a === undefined)
-      continue;
-    if (a === "--help" || a === "-h")
-      help = true;
-    else if (a === "--json")
-      json = true;
-    else if (a === "--file")
-      file = argv[++i] ?? null;
-    else if (!a.startsWith("-") && file === null)
-      file = a;
-  }
-  return { file, json, help };
-}
-var VALIDATE_CLI_USAGE = `Usage:
-  bun plugins/sp/scripts/dogfood-testing/validate-report.ts --file <report.md> [--json]
-
-Exit codes:
-  0  report validates clean (complete-report shape)
-  2  validation failed (errors on stdout / --json)
-  1  usage error
-
-Cost evidence (task 0913): a complete report must carry the Cost block
-(Ledger estimate / Method / Meter), percentages within 0..100, totals equal to
-the ledger sums of observable rows (fresh + cached), and 'n/a' (never a
-fabricated number) when no observable rows exist. Display-rounding tolerance
-for the cache share is ±1 percentage point.
-
-Phase 4 finalize MUST run this before status: complete (task 0278 R6).
-On exit 2: set status: aborted and list error codes under #### Unresolved.`;
-function runValidateCli(argv, readFile) {
-  const { file, json, help } = parseValidateCliArgs(argv);
-  if (help)
-    return { exitCode: 0, stdout: "", stderr: VALIDATE_CLI_USAGE };
-  if (file === null || file.length === 0) {
-    return { exitCode: 1, stdout: "", stderr: VALIDATE_CLI_USAGE };
-  }
-  let markdown;
-  try {
-    markdown = readFile(file);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { exitCode: 1, stdout: "", stderr: `Failed to read ${file}: ${msg}` };
-  }
-  const result = validateReport(markdown);
-  if (json) {
-    return {
-      exitCode: result.ok ? 0 : 2,
-      stdout: `${JSON.stringify(result, null, 2)}
-`,
-      stderr: ""
-    };
-  }
-  if (result.ok) {
-    return { exitCode: 0, stdout: `ok
-`, stderr: "" };
-  }
-  return {
-    exitCode: 2,
-    stdout: `${result.errors.join(`
-`)}
-`,
-    stderr: ""
-  };
-}
-function mainCli(argv = process.argv.slice(2)) {
-  const { exitCode, stdout, stderr } = runValidateCli(argv, (p) => readFileSync(p, "utf8"));
-  if (stdout)
-    process.stdout.write(stdout);
-  if (stderr)
-    process.stderr.write(`${stderr}
-`);
-  return exitCode;
-}
-{
-  process.exit(mainCli());
-}
-export {
-  VALIDATE_CLI_USAGE,
-  mainCli,
-  parseValidateCliArgs,
-  runValidateCli,
-  validateReport
-};

package/plugins/sp/scripts/dogfood-testing/validate-report.ts

@@ -1,98 +0,0 @@
-/**
- * validate-report — CLI entry for the @1.2 dogfood report contract checker (task 0276 W6, 0278 R6).
- *
- * The validation logic is application-owned in `plugins/sp/lib/dogfood-report.ts` (task 1173); this
- * script opens the file, runs the check and prints — argv, usage, exit codes and every exported
- * symbol stay as they were, so callers and tests keep importing this path.
- *
- * CLI (task 0278 R6): `bun …/validate-report.ts --file <report.md> [--json]`
- */
-
-import { readFileSync } from 'node:fs';
-import { validateReport } from '../../lib/dogfood-report';
-
-export * from '../../lib/dogfood-report';
-
-export interface ValidateCliArgs {
-    file: string | null;
-    json: boolean;
-    help: boolean;
-}
-
-export function parseValidateCliArgs(argv: string[]): ValidateCliArgs {
-    let file: string | null = null;
-    let json = false;
-    let help = false;
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === undefined) continue;
-        if (a === '--help' || a === '-h') help = true;
-        else if (a === '--json') json = true;
-        else if (a === '--file') file = argv[++i] ?? null;
-        else if (!a.startsWith('-') && file === null) file = a;
-    }
-    return { file, json, help };
-}
-
-export const VALIDATE_CLI_USAGE = `Usage:
-  bun plugins/sp/scripts/dogfood-testing/validate-report.ts --file <report.md> [--json]
-
-Exit codes:
-  0  report validates clean (complete-report shape)
-  2  validation failed (errors on stdout / --json)
-  1  usage error
-
-Cost evidence (task 0913): a complete report must carry the Cost block
-(Ledger estimate / Method / Meter), percentages within 0..100, totals equal to
-the ledger sums of observable rows (fresh + cached), and 'n/a' (never a
-fabricated number) when no observable rows exist. Display-rounding tolerance
-for the cache share is ±1 percentage point.
-
-Phase 4 finalize MUST run this before status: complete (task 0278 R6).
-On exit 2: set status: aborted and list error codes under #### Unresolved.`;
-
-export function runValidateCli(
-    argv: string[],
-    readFile: (path: string) => string,
-): { exitCode: number; stdout: string; stderr: string } {
-    const { file, json, help } = parseValidateCliArgs(argv);
-    if (help) return { exitCode: 0, stdout: '', stderr: VALIDATE_CLI_USAGE };
-    if (file === null || file.length === 0) {
-        return { exitCode: 1, stdout: '', stderr: VALIDATE_CLI_USAGE };
-    }
-    let markdown: string;
-    try {
-        markdown = readFile(file);
-    } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        return { exitCode: 1, stdout: '', stderr: `Failed to read ${file}: ${msg}` };
-    }
-    const result = validateReport(markdown);
-    if (json) {
-        return {
-            exitCode: result.ok ? 0 : 2,
-            stdout: `${JSON.stringify(result, null, 2)}\n`,
-            stderr: '',
-        };
-    }
-    if (result.ok) {
-        return { exitCode: 0, stdout: 'ok\n', stderr: '' };
-    }
-    return {
-        exitCode: 2,
-        stdout: `${result.errors.join('\n')}\n`,
-        stderr: '',
-    };
-}
-
-/** CLI entry for Phase 4 self-validate (import.meta.main). */
-export function mainCli(argv: string[] = process.argv.slice(2)): number {
-    const { exitCode, stdout, stderr } = runValidateCli(argv, (p) => readFileSync(p, 'utf8'));
-    if (stdout) process.stdout.write(stdout);
-    if (stderr) process.stderr.write(`${stderr}\n`);
-    return exitCode;
-}
-
-if (import.meta.main) {
-    process.exit(mainCli());
-}