@gobing-ai/spur 0.4.7 → 0.4.9

package/plugins/sp/scripts/batch-plan.ts

@@ -1,145 +0,0 @@
-#!/usr/bin/env bun
-/**
- * batch-plan — letters-first batch plan surface (task 1104, feature I13).
- *
- * The projection logic lives in packages/app/src/workflow/plan-projection.ts (unit-tested
- * there); this script is ADR-130 glue — argv/IO only — over the bundled core in
- * ../lib/plan-projection.generated.* (regenerate: `bun run build:plugin-lib && bun run build:scripts`).
- *
- * Modes:
- *   waves --tasks <file>  file: JSON array of {wbs, name}; prints `{ waves: [...] }` — waves
- *                         of 24 tasks as A Prepare batch + A1..A4 + B..Y task rows + Z Batch report.
- *   order --tasks <file> [--concurrency <n>]
- *                         file: JSON array of {wbs, dependencies?, files?}; prints the scheduleBatch
- *                         result `{ order, waves, cycle, overlaps, mode, reason }` (dev-runall §2.4
- *                         order + the --mode auto recommendation). A cycle is data, not an error.
- *   task-children --letter <A-Z> --plan <file>
- *                         file: a `workflow show --format todo --json` payload (or a bare plan
- *                         array); prints the task's phase digits as a JSON array.
- * Exit 0 on success, 1 on unreadable/invalid input, 2 on usage error. Runs under bare
- * `node batch-plan.mjs` (committed twin) — keep the twin in lockstep.
- */
-import { readFileSync } from 'node:fs';
-import type { BatchTask, PhasedPlanItem, ScheduleTask } from '../lib/plan-projection.generated.mjs';
-import { buildBatchPlan, scheduleBatch, taskPhaseChildren } from '../lib/plan-projection.generated.mjs';
-
-export * from '../lib/plan-projection.generated.mjs';
-
-export const BATCH_PLAN_USAGE =
-    'usage: batch-plan.ts waves --tasks <tasks.json> | order --tasks <tasks.json> [--concurrency <n>] | task-children --letter <A-Z> --plan <plan.json>';
-
-function readJsonFile(path: string): unknown {
-    return JSON.parse(readFileSync(path, 'utf8'));
-}
-
-function isBatchTask(value: unknown): value is BatchTask {
-    return (
-        typeof value === 'object' &&
-        value !== null &&
-        typeof (value as BatchTask).wbs === 'string' &&
-        typeof (value as BatchTask).name === 'string'
-    );
-}
-
-function isStringArray(value: unknown): value is string[] {
-    return Array.isArray(value) && value.every((v) => typeof v === 'string');
-}
-
-function isScheduleTask(value: unknown): value is ScheduleTask {
-    if (typeof value !== 'object' || value === null) return false;
-    const t = value as ScheduleTask;
-    return (
-        typeof t.wbs === 'string' &&
-        (t.dependencies === undefined || isStringArray(t.dependencies)) &&
-        (t.files === undefined || isStringArray(t.files))
-    );
-}
-
-export function main(argv: string[]): number {
-    const mode = argv[0];
-    if (mode === 'waves') {
-        if (argv[1] !== '--tasks' || argv[2] === undefined) {
-            process.stderr.write(`${BATCH_PLAN_USAGE}\n`);
-            return 2;
-        }
-        let tasks: unknown;
-        try {
-            tasks = readJsonFile(argv[2]);
-        } catch (error) {
-            process.stderr.write(
-                `batch-plan: cannot read ${argv[2]} — ${error instanceof Error ? error.message : String(error)}\n`,
-            );
-            return 1;
-        }
-        if (!Array.isArray(tasks) || !tasks.every(isBatchTask)) {
-            process.stderr.write('batch-plan: --tasks file must be a JSON array of {wbs, name}\n');
-            return 1;
-        }
-        process.stdout.write(`${JSON.stringify({ waves: buildBatchPlan(tasks) })}\n`);
-        return 0;
-    }
-    if (mode === 'order') {
-        let tasksPath = '';
-        let concurrency = 2;
-        for (let i = 1; i + 1 < argv.length; i += 2) {
-            if (argv[i] === '--tasks') tasksPath = argv[i + 1] ?? '';
-            else if (argv[i] === '--concurrency') concurrency = Number(argv[i + 1]);
-        }
-        if (tasksPath === '' || !Number.isInteger(concurrency) || concurrency < 1) {
-            process.stderr.write(`${BATCH_PLAN_USAGE}\n`);
-            return 2;
-        }
-        let tasks: unknown;
-        try {
-            tasks = readJsonFile(tasksPath);
-        } catch (error) {
-            process.stderr.write(
-                `batch-plan: cannot read ${tasksPath} — ${error instanceof Error ? error.message : String(error)}\n`,
-            );
-            return 1;
-        }
-        if (!Array.isArray(tasks) || !tasks.every(isScheduleTask)) {
-            process.stderr.write('batch-plan: --tasks file must be a JSON array of {wbs, dependencies?, files?}\n');
-            return 1;
-        }
-        process.stdout.write(`${JSON.stringify(scheduleBatch(tasks, { concurrency }))}\n`);
-        return 0;
-    }
-    if (mode === 'task-children') {
-        let letter = '';
-        let planPath = '';
-        for (let i = 1; i + 1 < argv.length; i += 2) {
-            if (argv[i] === '--letter') letter = argv[i + 1] ?? '';
-            else if (argv[i] === '--plan') planPath = argv[i + 1] ?? '';
-        }
-        if (!/^[A-Z]$/.test(letter) || planPath === '') {
-            process.stderr.write(`${BATCH_PLAN_USAGE}\n`);
-            return 2;
-        }
-        let payload: unknown;
-        try {
-            payload = readJsonFile(planPath);
-        } catch (error) {
-            process.stderr.write(
-                `batch-plan: cannot read ${planPath} — ${error instanceof Error ? error.message : String(error)}\n`,
-            );
-            return 1;
-        }
-        // Accept a bare plan array or a full `workflow show --format todo --json` payload.
-        const plan = Array.isArray(payload) ? payload : (payload as { plan?: PhasedPlanItem[] }).plan;
-        if (!Array.isArray(plan)) {
-            process.stderr.write(
-                'batch-plan: --plan file must be a plan array or a todo --json payload with a `plan` field\n',
-            );
-            return 1;
-        }
-        process.stdout.write(`${JSON.stringify(taskPhaseChildren(letter, plan as PhasedPlanItem[]))}\n`);
-        return 0;
-    }
-    process.stderr.write(`${BATCH_PLAN_USAGE}\n`);
-    return 2;
-}
-
-if (import.meta.main) {
-    process.exit(main(process.argv.slice(2)));
-}

package/plugins/sp/scripts/batch-preflight.mjs

@@ -1,423 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from "node:module";
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-// plugins/sp/lib/plan-projection.generated.mjs
-function isTaskFrozen(status) {
-  return status?.toLowerCase() === "deprecated";
-}
-function undeprecateTaskCommand(wbs) {
-  return `spur task update ${wbs} todo`;
-}
-var NON_ABORTING_PREFLIGHT_CODES = new Set([
-  "L4.scenario-unverified",
-  "L4.verifying-incomplete-tasks"
-]);
-function classifyFeaturePreflightFindings(findings) {
-  const aborting = [];
-  const nonAborting = [];
-  for (const f of findings) {
-    if (f.severity === "error") {
-      if (NON_ABORTING_PREFLIGHT_CODES.has(f.code)) {
-        nonAborting.push(f);
-      } else {
-        aborting.push(f);
-      }
-    } else {
-      nonAborting.push(f);
-    }
-  }
-  return {
-    aborting,
-    nonAborting,
-    shouldAbort: aborting.length > 0
-  };
-}
-function quickReadiness(input) {
-  const status = (input.status ?? "").toLowerCase();
-  const operation = input.operation;
-  if (operation !== "run" && operation !== "refine" && operation !== "verify") {
-    return {
-      action: "invalid",
-      code: "IV",
-      reason: `quick-readiness: unknown operation '${operation}' (${input.wbs})`
-    };
-  }
-  if (input.filteredCount !== undefined) {
-    if (input.filteredCount < 0) {
-      return {
-        action: "invalid",
-        code: "IV",
-        reason: `quick-readiness: invalid negative filtered count '${input.filteredCount}' (${input.wbs})`
-      };
-    }
-    if (input.filteredCount === 0) {
-      return {
-        action: "skipped",
-        code: "EMPTY",
-        reason: `quick-readiness: empty status-filtered set — nothing to ${operation} (${input.wbs})`
-      };
-    }
-  }
-  if (isTaskFrozen(status)) {
-    return {
-      action: "skipped",
-      code: "DEPRECATED",
-      reason: `quick-readiness: deprecated (frozen) — no ${operation} hop; un-deprecate with \`${undeprecateTaskCommand(input.wbs)}\` (${input.wbs})`
-    };
-  }
-  if (status === "cancelled" || status === "done") {
-    if (operation === "verify" && input.force === true) {
-      return {
-        action: "runnable",
-        code: "FORCE",
-        reason: `quick-readiness: verify --force re-verification of ${status} task ${input.wbs}`
-      };
-    }
-    return {
-      action: "skipped",
-      code: status === "done" ? "DONE" : "CANCELLED",
-      reason: `quick-readiness: already ${status} — no ${operation} hop (${input.wbs})`
-    };
-  }
-  if (status === "blocked") {
-    return {
-      action: "blocked",
-      code: "BLK",
-      reason: `quick-readiness: blocked — human/handover first (${input.wbs})`
-    };
-  }
-  if (operation === "run" && input.dependencies && input.dependencies.length > 0) {
-    const unmet = input.dependencies.filter((d) => (input.depStatuses?.[d] ?? "missing").toLowerCase() !== "done");
-    if (unmet.length > 0) {
-      const frozen = unmet.filter((d) => isTaskFrozen(input.depStatuses?.[d]));
-      const hint = frozen.length > 0 ? ` — ${frozen.map((d) => `${d} deprecated (frozen); re-point the edge or un-deprecate: \`${undeprecateTaskCommand(d)}\``).join("; ")}` : "";
-      return {
-        action: "blocked",
-        code: "DEP",
-        reason: `quick-readiness: unmet deps — ${unmet.join(", ")} (${input.wbs})${hint}`,
-        unmetDeps: unmet
-      };
-    }
-  }
-  const required = input.requiredSections ?? [];
-  const present = input.presentSections ?? [];
-  const gaps = required.filter((s) => {
-    const finding = input.sectionFindings?.[s];
-    return !present.includes(s) || finding !== undefined && finding !== "";
-  });
-  if (operation === "refine") {
-    if (status !== "backlog" && status !== "todo") {
-      return {
-        action: "skipped",
-        code: "NONPLAN",
-        reason: `quick-readiness: refine targets backlog/todo only, not '${status}' (${input.wbs})`
-      };
-    }
-    return {
-      action: "runnable",
-      code: "OK",
-      reason: `quick-readiness: refine ready for ${input.wbs} (${gaps.length} planning gap(s) to fill)`
-    };
-  }
-  if (operation === "verify") {
-    if (status !== "testing" && status !== "wip") {
-      return {
-        action: "invalid",
-        code: "NOVERIFY",
-        reason: `quick-readiness: verify needs testing/wip, not '${status}' (${input.wbs})`
-      };
-    }
-    return {
-      action: "runnable",
-      code: "OK",
-      reason: `quick-readiness: verify ready for ${input.wbs}`
-    };
-  }
-  if (status !== "todo" && status !== "wip" && status !== "testing") {
-    return {
-      action: "invalid",
-      code: "NORUN",
-      reason: `quick-readiness: run needs todo/wip/testing, not '${status}' (${input.wbs})`
-    };
-  }
-  if (gaps.length > 0) {
-    return {
-      action: "needs-refinement",
-      code: "REFINE",
-      reason: `quick-readiness: implementation sections incomplete (${input.wbs})`,
-      gaps
-    };
-  }
-  return {
-    action: "runnable",
-    code: "OK",
-    reason: `quick-readiness: run ready for ${input.wbs}`
-  };
-}
-function preflightTask(input) {
-  const status = (input.status ?? "").toLowerCase();
-  const deps = input.dependencies ?? [];
-  const depStatuses = input.depStatuses ?? {};
-  if (status === "cancelled") {
-    return {
-      action: "skip",
-      code: "A9",
-      reason: `dev-next: cancelled — nothing to advance (${input.wbs})`
-    };
-  }
-  if (status === "done") {
-    return {
-      action: "skip",
-      code: "A8",
-      reason: `dev-next: already done — batch does not auto-wrap (${input.wbs})`
-    };
-  }
-  if (status === "blocked") {
-    return {
-      action: "skip",
-      code: "A7",
-      reason: `dev-next: blocked — do not launch pipeline; human/handover first (${input.wbs})`
-    };
-  }
-  if (isTaskFrozen(status)) {
-    return {
-      action: "skip",
-      code: "DEPRECATED",
-      reason: `dev-next: deprecated (frozen) — un-deprecate first: ${undeprecateTaskCommand(input.wbs)} (${input.wbs})`
-    };
-  }
-  if (status === "todo" || status === "backlog") {
-    const unmet = deps.filter((d) => {
-      const st = (depStatuses[d] ?? "missing").toLowerCase();
-      return st !== "done";
-    });
-    if (unmet.length > 0) {
-      return {
-        action: "skip",
-        code: "A2",
-        reason: `dev-next: blocked by deps — unmet: ${unmet.join(", ")} (${input.wbs})`,
-        unmetDeps: unmet
-      };
-    }
-  }
-  return { action: "run", code: "OK", reason: `preflight clear — launch task-pipeline for ${input.wbs}` };
-}
-var OPERATOR_TOOLS = new Set(["AskUserQuestion", "ask_user_question"]);
-var SHELL_TOOLS = new Set(["bash", "shell", "exec", "exec_command", "run_command", "command"]);
-var SUBAGENT_TOOLS = new Set(["agent", "task", "invoke_subagent", "subagent", "dispatch_agent"]);
-var LOWERCASE_OPERATOR_TOOLS = new Set(["askuserquestion", "ask_user_question"]);
-var SENSITIVE_PREFIXES = ["drizzle/", "packages/config/", ".github/", "plugins/sp/hooks/"];
-var SENSITIVE_GLOBS = ["apps/server/src/**/auth*", "**/*secret*", "**/*.sql"];
-function globToRegex(glob) {
-  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replaceAll("**/", "\x00").replaceAll("**", "\x01").replaceAll("*", "[^/]*").replaceAll("\x00", "(?:.*/)?").replaceAll("\x01", ".*");
-  return new RegExp(`^${escaped}$`, "s");
-}
-var SENSITIVE_MATCHERS = [
-  ...SENSITIVE_PREFIXES.map((prefix) => ({
-    label: prefix,
-    test: (path) => path.startsWith(prefix)
-  })),
-  ...SENSITIVE_GLOBS.map((glob) => {
-    const regex = globToRegex(glob);
-    return { label: glob, test: (path) => regex.test(path) };
-  })
-];
-
-// plugins/sp/scripts/batch-preflight.ts
-function recoveryHint(status, wbs) {
-  const st = (status ?? "").toLowerCase();
-  switch (st) {
-    case "backlog":
-      return { code: "A1", command: `/sp:dev-refine ${wbs} --auto --next` };
-    case "todo":
-      return { code: "A3", command: `/sp:dev-run ${wbs} --auto --next` };
-    case "wip":
-      return { code: "A5", command: `/sp:dev-run ${wbs} --mode implement --auto --next` };
-    case "testing":
-      return { code: "A6", command: `/sp:dev-verify ${wbs} --auto --next` };
-    case "blocked":
-      return {
-        code: "A7",
-        command: `/sp:dev-handover "blocked task ${wbs} — see Notes/History"`
-      };
-    default:
-      return null;
-  }
-}
-function parsePreflightCliArgs(argv) {
-  let status = null;
-  let deps = [];
-  const depStatuses = {};
-  let wbs = "0000";
-  let recovery = false;
-  let help = false;
-  let json = false;
-  let operation = null;
-  let force = false;
-  let filteredCount = null;
-  let requiredSections = [];
-  let presentSections = [];
-  let classifyFeature = null;
-  for (let i = 0;i < argv.length; i++) {
-    const a = argv[i];
-    if (a === "--help" || a === "-h")
-      help = true;
-    else if (a === "--json")
-      json = true;
-    else if (a === "--recovery")
-      recovery = true;
-    else if (a === "--force")
-      force = true;
-    else if (a === "--operation") {
-      const v = argv[++i] ?? "";
-      operation = v === "run" || v === "refine" || v === "verify" ? v : null;
-    } else if (a === "--filtered-count") {
-      const v = Number(argv[++i]);
-      filteredCount = Number.isFinite(v) ? v : null;
-    } else if (a === "--required-sections") {
-      const raw = argv[++i] ?? "";
-      requiredSections = raw.length === 0 ? [] : raw.split(",").map((s) => s.trim()).filter(Boolean);
-    } else if (a === "--present-sections") {
-      const raw = argv[++i] ?? "";
-      presentSections = raw.length === 0 ? [] : raw.split(",").map((s) => s.trim()).filter(Boolean);
-    } else if (a === "--wbs")
-      wbs = argv[++i] ?? wbs;
-    else if (a === "--classify-feature") {
-      classifyFeature = argv[++i] ?? "[]";
-    } else if (a === "--status")
-      status = argv[++i] ?? null;
-    else if (a === "--deps") {
-      const raw = argv[++i] ?? "";
-      deps = raw.length === 0 ? [] : raw.split(",").map((s) => s.trim()).filter(Boolean);
-    } else if (a === "--dep-status") {
-      const raw = argv[++i] ?? "";
-      for (const part of raw.split(",")) {
-        const [k, v] = part.split(":");
-        if (k && v)
-          depStatuses[k.trim()] = v.trim();
-      }
-    }
-  }
-  return {
-    status,
-    deps,
-    depStatuses,
-    wbs,
-    recovery,
-    help,
-    json,
-    operation,
-    force,
-    filteredCount,
-    requiredSections,
-    presentSections,
-    classifyFeature
-  };
-}
-var PREFLIGHT_CLI_USAGE = `Usage:
-  bun plugins/sp/scripts/batch-preflight.ts --wbs <wbs> --status <status> \\
-    [--deps 0275,0276] [--dep-status 0275:done,0276:todo] [--recovery] [--json]
-  bun plugins/sp/scripts/batch-preflight.ts --operation <run|refine|verify> --wbs <wbs> --status <status>     [--filtered-count <n>] [--required-sections A,B] [--present-sections A,B] [--force] [--json]
-
-Exit: 0 = run (or recovery hint printed); 2 = skip; 1 = usage.`;
-function runPreflightCli(argv) {
-  const args = parsePreflightCliArgs(argv);
-  if (args.help)
-    return { exitCode: 0, stdout: "", stderr: PREFLIGHT_CLI_USAGE };
-  if (args.classifyFeature !== null) {
-    try {
-      const findings = JSON.parse(args.classifyFeature);
-      const res = classifyFeaturePreflightFindings(Array.isArray(findings) ? findings : []);
-      return {
-        exitCode: res.shouldAbort ? 1 : 0,
-        stdout: `${JSON.stringify(res, null, 2)}
-`,
-        stderr: ""
-      };
-    } catch (e) {
-      return {
-        exitCode: 1,
-        stdout: "",
-        stderr: `Invalid JSON for --classify-feature: ${String(e)}`
-      };
-    }
-  }
-  if (!args.status)
-    return { exitCode: 1, stdout: "", stderr: PREFLIGHT_CLI_USAGE };
-  if (args.recovery) {
-    const hint = recoveryHint(args.status, args.wbs);
-    const body = args.json ? `${JSON.stringify({ recovery: hint }, null, 2)}
-` : hint ? `${hint.command}
-` : `no recovery hop
-`;
-    return { exitCode: 0, stdout: body, stderr: "" };
-  }
-  if (args.operation !== null) {
-    const result = quickReadiness({
-      wbs: args.wbs,
-      status: args.status,
-      operation: args.operation,
-      dependencies: args.deps,
-      depStatuses: args.depStatuses,
-      ...args.filteredCount !== null ? { filteredCount: args.filteredCount } : {},
-      ...args.requiredSections.length > 0 ? { requiredSections: args.requiredSections } : {},
-      ...args.presentSections.length > 0 ? { presentSections: args.presentSections } : {},
-      ...args.force ? { force: true } : {}
-    });
-    const runnable = result.action === "runnable" || result.action === "needs-refinement";
-    if (args.json) {
-      return { exitCode: runnable ? 0 : 2, stdout: `${JSON.stringify(result, null, 2)}
-`, stderr: "" };
-    }
-    return {
-      exitCode: runnable ? 0 : 2,
-      stdout: `${result.action}${result.code ? ` ${result.code}` : ""}: ${result.reason}
-`,
-      stderr: ""
-    };
-  }
-  const result = preflightTask({
-    wbs: args.wbs,
-    status: args.status,
-    dependencies: args.deps,
-    depStatuses: args.depStatuses
-  });
-  if (args.json) {
-    return {
-      exitCode: result.action === "run" ? 0 : 2,
-      stdout: `${JSON.stringify(result, null, 2)}
-`,
-      stderr: ""
-    };
-  }
-  if (result.action === "run") {
-    return { exitCode: 0, stdout: `run: ${result.reason ?? "ok"}
-`, stderr: "" };
-  }
-  return {
-    exitCode: 2,
-    stdout: `skip ${result.code}: ${result.reason}
-`,
-    stderr: ""
-  };
-}
-{
-  const { exitCode, stdout, stderr } = runPreflightCli(process.argv.slice(2));
-  if (stdout)
-    process.stdout.write(stdout);
-  if (stderr)
-    process.stderr.write(`${stderr}
-`);
-  process.exit(exitCode);
-}
-export {
-  NON_ABORTING_PREFLIGHT_CODES,
-  PREFLIGHT_CLI_USAGE,
-  classifyFeaturePreflightFindings,
-  parsePreflightCliArgs,
-  preflightTask,
-  quickReadiness,
-  recoveryHint,
-  runPreflightCli
-};