strikethroo 3.22.0 → 3.23.0

package/templates/harness/skills/st-create-plan/scripts/find-strikethroo-root.cjs

@@ -1,116 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/skill-scripts/find-strikethroo-root.ts
-var find_strikethroo_root_exports = {};
-__export(find_strikethroo_root_exports, {
-  main: () => main
-});
-module.exports = __toCommonJS(find_strikethroo_root_exports);
-
-// src/skill-scripts/shared/root.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
-var EXPECTED_SCHEMA = true ? 4 : 4;
-var isValidStrikethrooRoot = (strikethrooPath) => {
-  try {
-    if (!fs.existsSync(strikethrooPath)) return false;
-    if (!fs.lstatSync(strikethrooPath).isDirectory()) return false;
-    const metadataPath = path.join(strikethrooPath, ".init-metadata.json");
-    if (!fs.existsSync(metadataPath)) return false;
-    const metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-    return metadata && typeof metadata === "object" && "version" in metadata;
-  } catch (_err) {
-    return false;
-  }
-};
-var getStrikethrooAt = (directory) => {
-  const strikethrooPath = path.join(directory, ".ai", "strikethroo");
-  return isValidStrikethrooRoot(strikethrooPath) ? strikethrooPath : null;
-};
-var getParentPaths = (currentPath, acc = []) => {
-  const absolutePath = path.resolve(currentPath);
-  const nextAcc = [...acc, absolutePath];
-  const parentPath = path.dirname(absolutePath);
-  if (parentPath === absolutePath) return nextAcc;
-  return getParentPaths(parentPath, nextAcc);
-};
-var checkWorkspaceSchema = (metadataPath) => {
-  let metadata;
-  try {
-    metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-  } catch {
-    return;
-  }
-  const actual = typeof metadata.workspaceSchemaVersion === "number" ? metadata.workspaceSchemaVersion : 1;
-  if (actual === EXPECTED_SCHEMA) return;
-  if (actual < EXPECTED_SCHEMA) {
-    process.stderr.write(
-      `Workspace schema v${actual} is older than this skill requires (v${EXPECTED_SCHEMA}). Re-run \`npx strikethroo init\` with the latest CLI to update.
-`
-    );
-  } else {
-    process.stderr.write(
-      `This skill (built for workspace schema v${EXPECTED_SCHEMA}) is older than the workspace (v${actual}). Re-run \`npx skills add e0ipso/strikethroo\` to update skills.
-`
-    );
-  }
-  process.exit(1);
-};
-var findStrikethrooRoot = (startPath = process.cwd()) => {
-  const paths = getParentPaths(startPath);
-  const found = paths.find((p) => getStrikethrooAt(p));
-  if (!found) return null;
-  const root = getStrikethrooAt(found);
-  if (root) checkWorkspaceSchema(path.join(root, ".init-metadata.json"));
-  return root;
-};
-
-// src/skill-scripts/find-strikethroo-root.ts
-var main = () => {
-  const startPath = process.argv[2] || process.cwd();
-  const root = findStrikethrooRoot(startPath);
-  if (!root) {
-    process.stderr.write(
-      `Could not find .ai/strikethroo root from ${startPath} or any parent directory.
-`
-    );
-    process.exit(1);
-  }
-  process.stdout.write(`${root}
-`);
-  process.exit(0);
-};
-if (require.main === module) {
-  main();
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  main
-});

package/templates/harness/skills/st-create-plan/scripts/get-next-plan-id.cjs

@@ -1,197 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/skill-scripts/get-next-plan-id.ts
-var get_next_plan_id_exports = {};
-__export(get_next_plan_id_exports, {
-  main: () => main
-});
-module.exports = __toCommonJS(get_next_plan_id_exports);
-
-// src/skill-scripts/shared/root.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
-var EXPECTED_SCHEMA = true ? 4 : 4;
-var isValidStrikethrooRoot = (strikethrooPath) => {
-  try {
-    if (!fs.existsSync(strikethrooPath)) return false;
-    if (!fs.lstatSync(strikethrooPath).isDirectory()) return false;
-    const metadataPath = path.join(strikethrooPath, ".init-metadata.json");
-    if (!fs.existsSync(metadataPath)) return false;
-    const metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-    return metadata && typeof metadata === "object" && "version" in metadata;
-  } catch (_err) {
-    return false;
-  }
-};
-var getStrikethrooAt = (directory) => {
-  const strikethrooPath = path.join(directory, ".ai", "strikethroo");
-  return isValidStrikethrooRoot(strikethrooPath) ? strikethrooPath : null;
-};
-var getParentPaths = (currentPath, acc = []) => {
-  const absolutePath = path.resolve(currentPath);
-  const nextAcc = [...acc, absolutePath];
-  const parentPath = path.dirname(absolutePath);
-  if (parentPath === absolutePath) return nextAcc;
-  return getParentPaths(parentPath, nextAcc);
-};
-var checkWorkspaceSchema = (metadataPath) => {
-  let metadata;
-  try {
-    metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-  } catch {
-    return;
-  }
-  const actual = typeof metadata.workspaceSchemaVersion === "number" ? metadata.workspaceSchemaVersion : 1;
-  if (actual === EXPECTED_SCHEMA) return;
-  if (actual < EXPECTED_SCHEMA) {
-    process.stderr.write(
-      `Workspace schema v${actual} is older than this skill requires (v${EXPECTED_SCHEMA}). Re-run \`npx strikethroo init\` with the latest CLI to update.
-`
-    );
-  } else {
-    process.stderr.write(
-      `This skill (built for workspace schema v${EXPECTED_SCHEMA}) is older than the workspace (v${actual}). Re-run \`npx skills add e0ipso/strikethroo\` to update skills.
-`
-    );
-  }
-  process.exit(1);
-};
-var findStrikethrooRoot = (startPath = process.cwd()) => {
-  const paths = getParentPaths(startPath);
-  const found = paths.find((p) => getStrikethrooAt(p));
-  if (!found) return null;
-  const root = getStrikethrooAt(found);
-  if (root) checkWorkspaceSchema(path.join(root, ".init-metadata.json"));
-  return root;
-};
-
-// src/skill-scripts/shared/plan-scan.ts
-var fs2 = __toESM(require("fs"));
-var path2 = __toESM(require("path"));
-
-// src/skill-scripts/shared/frontmatter.ts
-var ID_PATTERNS = [
-  /^\s*["']?id["']?\s*:\s*["']?([+-]?\d+)["']?\s*(?:#.*)?$/im,
-  /^\s*id\s*:\s*([+-]?\d+)\s*(?:#.*)?$/im,
-  /^\s*["']?id["']?\s*:\s*"([+-]?\d+)"\s*(?:#.*)?$/im,
-  /^\s*["']?id["']?\s*:\s*'([+-]?\d+)'\s*(?:#.*)?$/im,
-  /^\s*["']id["']\s*:\s*([+-]?\d+)\s*(?:#.*)?$/im,
-  /^\s*id\s*:\s*[|>]\s*([+-]?\d+)\s*$/im
-];
-var validateId = (rawId) => {
-  const id = parseInt(rawId, 10);
-  if (Number.isNaN(id) || id < 0 || id > Number.MAX_SAFE_INTEGER) return null;
-  return id;
-};
-var extractIdFromMarkdown = (content) => {
-  const frontmatterMatch = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
-  if (!frontmatterMatch || !frontmatterMatch[1]) return null;
-  const block = frontmatterMatch[1];
-  for (const pattern of ID_PATTERNS) {
-    const match = block.match(pattern);
-    if (match && match[1]) {
-      const id = validateId(match[1]);
-      if (id !== null) return id;
-    }
-  }
-  return null;
-};
-var extractPlanId = (content, _filePath) => {
-  return extractIdFromMarkdown(content);
-};
-
-// src/skill-scripts/shared/plan-scan.ts
-var PLAN_EXTENSIONS = [".md"];
-var scanPlanDir = (planDirPath, dirName, isArchive) => {
-  let entries;
-  try {
-    entries = fs2.readdirSync(planDirPath, { withFileTypes: true });
-  } catch (_err) {
-    return [];
-  }
-  return entries.filter((e) => e.isFile() && PLAN_EXTENSIONS.some((ext) => e.name.endsWith(ext))).flatMap((e) => {
-    const filePath = path2.join(planDirPath, e.name);
-    try {
-      const content = fs2.readFileSync(filePath, "utf8");
-      const id = extractPlanId(content, filePath);
-      if (id === null) return [];
-      return [{ id, file: filePath, dir: planDirPath, isArchive, name: dirName }];
-    } catch (_err) {
-      return [];
-    }
-  });
-};
-var getAllPlans = (taskManagerRoot) => {
-  const sources = [
-    { dir: path2.join(taskManagerRoot, "plans"), isArchive: false },
-    { dir: path2.join(taskManagerRoot, "archive"), isArchive: true }
-  ];
-  return sources.flatMap(({ dir, isArchive }) => {
-    if (!fs2.existsSync(dir)) return [];
-    let entries;
-    try {
-      entries = fs2.readdirSync(dir, { withFileTypes: true });
-    } catch (_err) {
-      return [];
-    }
-    return entries.filter((e) => e.isDirectory()).flatMap((e) => scanPlanDir(path2.join(dir, e.name), e.name, isArchive));
-  });
-};
-var computeNextPlanId = (taskManagerRoot) => {
-  const plans = getAllPlans(taskManagerRoot);
-  return plans.reduce((max, p) => Math.max(max, p.id), 0) + 1;
-};
-
-// src/skill-scripts/get-next-plan-id.ts
-var main = () => {
-  const rootArg = process.argv[2];
-  let root;
-  if (rootArg) {
-    root = rootArg;
-  } else {
-    root = findStrikethrooRoot(process.cwd());
-  }
-  if (!root) {
-    process.stderr.write(
-      "No .ai/strikethroo root found. Run this from inside an initialized strikethroo workspace.\n"
-    );
-    process.exit(1);
-  }
-  process.stdout.write(`${computeNextPlanId(root)}
-`);
-  process.exit(0);
-};
-if (require.main === module) {
-  main();
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  main
-});

package/templates/harness/skills/st-execute-blueprint/SKILL.md

@@ -1,195 +0,0 @@
----
-name: st-execute-blueprint
-description: Use when the user asks to run, execute, implement, or carry out a Strikethroo plan or its blueprint by plan ID in this repository — triggers include execute blueprint, run the plan, implement plan, build the plan. Do not use to create a plan, to only generate tasks, to run a single task, or for generic development outside Strikethroo.
----
-
-# st-execute-blueprint
-
-## Inputs
-
-The user supplies the numeric plan ID conversationally.
-
-## Operating Procedure
-
-### 1. Locate the strikethroo root
-
-Run `scripts/find-strikethroo-root.cjs` from the user's working directory. If
-it exits non-zero, stop and ask the user to run `npx strikethroo init`.
-
-Treat the path it prints as `<root>` for every subsequent step.
-
-Delegated execution workers skip this step and do not emit update notices.
-
-Run `scripts/check-for-updates.cjs "<root>"` as a separate command using this
-skill's script path. Keep the user's working directory. Read the one JSON line
-on stdout. When `notice` is present, retain its exact text for the final
-user-facing response. Never pause for permission and never run an update.
-
-### 2. Resolve the plan
-
-Run `scripts/validate-plan-blueprint.cjs <plan-id> planFile` for the plan
-file's absolute path. Another field name prints that field instead.
-
-If the script exits non-zero, stop and ask the user to confirm the plan ID.
-Do not guess a different ID.
-
-Run `scripts/validate-plan-blueprint.cjs <plan-id> planDir` and treat the
-printed path as `<plan-dir>`.
-
-### 3. Validate tasks and blueprint existence
-
-Run `scripts/validate-plan-blueprint.cjs <plan-id> taskCount` and
-`scripts/validate-plan-blueprint.cjs <plan-id> blueprintExists`.
-
-### 4. Auto-generate tasks and blueprint if missing
-
-If `taskCount` is 0 or `blueprintExists` is `no`:
-
-Notify the user: "Tasks or execution blueprint not found. Generating tasks automatically..."
-
-- Follow the `st-generate-tasks` skill for this plan ID. Execute its operating procedure in full, including running `POST_TASK_GENERATION_ALL.md` to write the Execution Blueprint.
-- Re-run the `planFile`, `planDir`, `taskCount`, and `blueprintExists` queries to refresh the resolved paths and counts.
-
-If the plan still has no tasks or no blueprint, stop and report failure.
-
-### 5. Optionally create a feature branch
-
-Run `scripts/create-feature-branch.cjs <plan-id>` once before phase execution. A skip is not a failure. Continue on the current branch, and never create the branch by hand. Uncommitted or untracked changes are permitted only inside the repository-root `.ai/strikethroo` subtree. An error result halts execution; report it.
-
-Then run `scripts/capture-base-commit.cjs <plan-id>` once to record the commit the review gate diffs against. A `skipped` result continues execution and means the review gate will skip. Only an `error` result halts.
-
-### 6. Load project context and execution blueprint
-
-Read these files, in order:
-
-- `<root>/config/STRIKETHROO.md`
-- The plan document at the path from step 2, including its Execution Blueprint section, which defines the phase groupings and task dispatch order.
-- `<root>/config/shared/verification-gate.md` and `<root>/config/shared/anti-rationalization.md`, both applied in the phase loop below.
-
-### 7. Execute phases in order
-
-Use an internal task or todo tracker to monitor progress. For each phase defined in the Execution Blueprint:
-
-#### 7a. Phase pre-execution
-Run `scripts/check-phase-readiness.cjs <plan-id> <phase-number>`. If the script exits non-zero, halt the phase and report the blocking issues before continuing.
-
-Read `<root>/config/hooks/PRE_PHASE.md` and execute its instructions before starting the phase.
-
-#### 7b. Task dispatch
-Identify all tasks scheduled for this phase whose dependencies are fully satisfied. Read `<root>/config/hooks/PRE_TASK_ASSIGNMENT.md` and follow its instructions for agent selection before dispatching tasks.
-
-Resolve every selected task's execution route first. Invoke one resolver per selected
-task simultaneously in a single parallel tool operation:
-
-```text
-scripts/dispatch-task-execution.cjs resolve <task-file> <current-harness> <workspace> <plan-id> <task-id>
-```
-
-Resolvers never launch external processes. After interpreting all route results, issue
-every external execution and every sub-agent **together in one parallel
-tool operation**. External execution uses:
-
-```text
-scripts/dispatch-task-execution.cjs execute <handoff> <task-file> <current-harness> <workspace> <plan-id> <task-id>
-```
-
-`<current-harness>` is the exact supported harness identifier running this
-skill; `<workspace>` is the project working directory.
-
-Interpret the one-line JSON result and act on its `kind` exactly once:
-
-| `kind` | Required action |
-| --- | --- |
-| `native-default` | Dispatch natively with no execution-setting prose. |
-| `native-override` | Dispatch natively, explicitly requiring the exact returned `model`. Require the returned `reasoningEffort` only when that property is present. |
-| `external-override` | Run the `execute` command with the returned `handoff`, then read its result against this same table. |
-| `fallback` | Nothing launched. Record the returned `reason` and `detail` visibly, then dispatch natively with no execution-setting prose. |
-| `launched-success` | The external process exited zero. Do not dispatch natively; review status and evidence as you would for a native agent. |
-| `launched-failure` | A failed task. Set its status to `failed` and run `<root>/config/hooks/POST_ERROR_DETECTION.md`. Never retry it natively. |
-| `infrastructure-failure` | Handle exactly as the preceding row. |
-
-Handoff rules:
-
-- Pass the exact opaque `handoff` string the resolver returned for that task. Never reconstruct one.
-- Never reuse a handoff for another task, and never rerun resolution after launches begin.
-
-Deploy all remaining native sub-agents simultaneously. Each sub-agent must read and execute `<root>/config/hooks/PRE_TASK_EXECUTION.md` before any implementation work, then execute the task and update its status. Do not run `scripts/check-for-updates.cjs`; delegated workers do not consume update notices.
-
-#### 7c. Phase completion verification
-Ensure every task in the phase has status `completed` and collect its outputs. Do not accept a subagent's report of success as proof. Apply the evidence gate in `<root>/config/shared/verification-gate.md` before marking the phase complete.
-
-#### 7d. Phase post-execution
-Read `<root>/config/hooks/POST_PHASE.md` and execute its instructions. Do not proceed to the next phase until this hook succeeds.
-
-Update the phase status to `completed` in the plan's Execution Blueprint section.
-
-Repeat for the next phase until all phases are complete.
-
-Apply `<root>/config/shared/anti-rationalization.md` to this rationalization table:
-
-| You catch yourself thinking… | The binding rule |
-| --- | --- |
-| "The subagent reported success, so the task is done." | A report is a claim, not evidence. Apply the verification gate before marking the phase complete. |
-| "The tests probably pass." | "Probably" is a red flag. Run the proving command, read its output and exit code, then state the result. |
-| "I'll verify later, after the next phase." | A phase is not complete until `POST_PHASE.md` succeeds against verified evidence. Verify now; do not advance on an unverified phase. |
-
-### 8. Post-execution validation
-
-Read `<root>/config/hooks/POST_EXECUTION.md` and execute its instructions. If validation fails, halt execution. The plan remains in `plans/` for debugging.
-
-Before declaring execution complete, apply the evidence gate in `<root>/config/shared/verification-gate.md` to the plan's Success Criteria and Self Validation steps.
-
-#### Run the code review gate
-
-After `POST_EXECUTION.md` reports green, follow the `st-code-review` skill and run its bundled mechanism:
-
-```text
-code-review.cjs <plan-id> <current-harness>
-```
-
-Resolve `code-review.cjs` from the `st-code-review` skill's sibling `scripts` directory and pass the exact supported harness identifier running this skill. If the `st-code-review` skill is not installed, record that outcome in the execution summary and continue to summary and archival.
-
-Handle the one JSON line it prints on stdout, in this order:
-
-1. Copy it verbatim into the execution summary's review outcome. Do not reformat it or omit fields.
-2. Follow its top-level `action`. If it is `halt`, stop and report the top-level `detail`. If it is `continue`, proceed to the execution summary and archival.
-3. Only when `verdict.kind` is `review-recorded`, read `<plan-dir>/review/review.xml` and `<plan-dir>/review/findings.json`, then decide which findings to act on. `severity` and `confidence` are advisory labels, not instructions.
-
-Never report an uncertified review as clean.
-
-Hard rules:
-
-- The review runs once. Do not re-run the gate to check a fix.
-- Detection uses the reviewer route. Dispatch each fix on the implementer route; the reviewer does not fix its findings.
-- After any fix, re-run `POST_EXECUTION.md` in full before declaring execution complete. The earlier green result no longer applies.
-
-### 9. Append execution summary
-
-Append an execution summary section to the plan document, filling every field of `<root>/config/templates/EXECUTION_SUMMARY_TEMPLATE.md`. Under Noteworthy Events, always record the review gate's JSON line verbatim, then which findings you acted on versus ignored and why.
-
-### 10. Archive the plan
-
-Move the completed plan directory from `<root>/plans/<plan-folder>` to `<root>/archive/<plan-folder>`, preserving the entire folder structure. If the move fails, log the error but do not fail the overall execution.
-
-## Failure Modes
-
-- **Execution errors.** If a task fails, read `<root>/config/hooks/POST_ERROR_DETECTION.md`, document the error in Noteworthy Events, halt the phase, and request user direction before continuing.
-
-## Execution Summary
-
-Conclude with exactly this block (a retained update notice, when present, follows separately):
-
-```
----
-Execution Summary:
-- Plan ID: [numeric-id]
-- Status: Archived
-- Location: [absolute path to archive directory]
----
-```
-
-The summary is consumed by downstream automation; keep the format exact.
-
-When the retained update `notice` is present, append that exact sentence after
-the structured summary block, or after your final response when this skill emits
-no summary block. Nothing may follow the notice.