strikethroo 3.22.0 → 3.23.0

package/templates/harness/skills/st-generate-tasks/scripts/validate-plan-blueprint.cjs

@@ -1,429 +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/validate-plan-blueprint.ts
-var validate_plan_blueprint_exports = {};
-__export(validate_plan_blueprint_exports, {
-  main: () => main
-});
-module.exports = __toCommonJS(validate_plan_blueprint_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));
-  });
-};
-
-// src/skill-scripts/shared/plan-resolve.ts
-var fs3 = __toESM(require("fs"));
-var path3 = __toESM(require("path"));
-var isValidRootDir = (strikethrooPath) => {
-  try {
-    if (!fs3.existsSync(strikethrooPath)) return false;
-    if (!fs3.lstatSync(strikethrooPath).isDirectory()) return false;
-    const metadataPath = path3.join(strikethrooPath, ".init-metadata.json");
-    if (!fs3.existsSync(metadataPath)) return false;
-    const metadata = JSON.parse(fs3.readFileSync(metadataPath, "utf8"));
-    return metadata && typeof metadata === "object" && "version" in metadata;
-  } catch (_err) {
-    return false;
-  }
-};
-var checkStandardRootShortcut = (filePath) => {
-  const planDir = path3.dirname(filePath);
-  const parentDir = path3.dirname(planDir);
-  const possibleRoot = path3.dirname(parentDir);
-  const parentBase = path3.basename(parentDir);
-  if (parentBase !== "plans" && parentBase !== "archive") return null;
-  if (path3.basename(possibleRoot) !== "strikethroo") return null;
-  const dotAiDir = path3.dirname(possibleRoot);
-  if (path3.basename(dotAiDir) !== ".ai") return null;
-  return isValidRootDir(possibleRoot) ? possibleRoot : null;
-};
-var resolveByPath = (absolutePath) => {
-  let content;
-  try {
-    content = fs3.readFileSync(absolutePath, "utf8");
-  } catch (_err) {
-    return null;
-  }
-  const planId = extractPlanId(content, absolutePath);
-  if (planId === null) return null;
-  const tmRoot = checkStandardRootShortcut(absolutePath) || findStrikethrooRoot(path3.dirname(absolutePath));
-  if (!tmRoot) return null;
-  return {
-    planFile: absolutePath,
-    planDir: path3.dirname(absolutePath),
-    strikethrooRoot: tmRoot,
-    planId
-  };
-};
-var resolveByIdInAncestry = (planId, startPath, searched = /* @__PURE__ */ new Set()) => {
-  const tmRoot = findStrikethrooRoot(startPath);
-  if (!tmRoot) return null;
-  const normalized = path3.normalize(tmRoot);
-  if (searched.has(normalized)) return null;
-  searched.add(normalized);
-  const plans = getAllPlans(tmRoot);
-  const match = plans.find((p) => p.id === planId);
-  if (match) {
-    return {
-      planFile: match.file,
-      planDir: match.dir,
-      strikethrooRoot: tmRoot,
-      planId
-    };
-  }
-  const parentOfRoot = path3.dirname(path3.dirname(tmRoot));
-  if (parentOfRoot === tmRoot) return null;
-  return resolveByIdInAncestry(planId, parentOfRoot, searched);
-};
-var resolvePlan = (input, startPath = process.cwd()) => {
-  if (input === null || input === void 0 || input === "") return null;
-  const inputStr = String(input);
-  if (inputStr.startsWith("/")) {
-    return resolveByPath(inputStr);
-  }
-  const planId = parseInt(inputStr, 10);
-  if (Number.isNaN(planId)) return null;
-  return resolveByIdInAncestry(planId, startPath);
-};
-
-// src/skill-scripts/shared/blueprint-detection.ts
-var fs4 = __toESM(require("fs"));
-var hasExecutionBlueprint = (planFile) => {
-  try {
-    const content = fs4.readFileSync(planFile, "utf8");
-    return /^## Execution Blueprint/m.test(content);
-  } catch (_err) {
-    return false;
-  }
-};
-
-// src/skill-scripts/shared/task-count.ts
-var fs5 = __toESM(require("fs"));
-var path4 = __toESM(require("path"));
-var countTaskFiles = (planDir) => {
-  const tasksDir = path4.join(planDir, "tasks");
-  if (!fs5.existsSync(tasksDir)) return 0;
-  try {
-    const stat = fs5.lstatSync(tasksDir);
-    if (!stat.isDirectory()) return 0;
-    return fs5.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).length;
-  } catch (_err) {
-    return 0;
-  }
-};
-
-// src/skill-scripts/shared/task-complexity.ts
-var fs6 = __toESM(require("fs"));
-var path5 = __toESM(require("path"));
-
-// src/skill-scripts/shared/complexity-score.ts
-var validateComplexityScore = (value) => {
-  const trimmed = value.trim();
-  if (!/^\d+$/.test(trimmed)) {
-    return { valid: false, reason: "non-integer" };
-  }
-  const parsed = Number.parseInt(trimmed, 10);
-  if (parsed < 1 || parsed > 10) {
-    return { valid: false, reason: "out-of-range", value: parsed };
-  }
-  return { valid: true, value: parsed };
-};
-
-// src/skill-scripts/shared/task-file.ts
-var extractFrontmatter = (content) => {
-  const match = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
-  return match && match[1] ? match[1] : null;
-};
-
-// src/skill-scripts/shared/task-complexity.ts
-var validateTaskComplexityScores = (planDir) => {
-  const tasksDir = path5.join(planDir, "tasks");
-  if (!fs6.existsSync(tasksDir)) return [];
-  let files;
-  try {
-    if (!fs6.lstatSync(tasksDir).isDirectory()) return [];
-    files = fs6.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).sort();
-  } catch (_err) {
-    return [];
-  }
-  const invalid = [];
-  for (const file of files) {
-    let content;
-    try {
-      content = fs6.readFileSync(path5.join(tasksDir, file), "utf8");
-    } catch (_err) {
-      invalid.push(`${file}: unreadable`);
-      continue;
-    }
-    const frontmatter = extractFrontmatter(content);
-    const match = frontmatter ? frontmatter.match(/^\s*complexity_score\s*:\s*(.*?)\s*(?:#.*)?$/im) : null;
-    if (!match || match[1] === void 0) {
-      invalid.push(`${file}: missing complexity_score`);
-      continue;
-    }
-    const raw = match[1].trim();
-    const result = validateComplexityScore(raw);
-    if (result.valid) continue;
-    if (result.reason === "non-integer") {
-      invalid.push(`${file}: non-integer complexity_score "${raw}"`);
-      continue;
-    }
-    invalid.push(`${file}: complexity_score ${result.value} out of range 1-10`);
-  }
-  return invalid;
-};
-
-// src/skill-scripts/validate-plan-blueprint.ts
-var VALID_FIELDS = [
-  "planFile",
-  "planDir",
-  "taskCount",
-  "blueprintExists",
-  "strikethrooRoot",
-  "planId",
-  "complexityScoresValid",
-  "invalidComplexityTasks"
-];
-var usage = () => {
-  const lines = [
-    "Plan ID or absolute path is required",
-    "",
-    "Usage: node validate-plan-blueprint.cjs <plan-id-or-path> [field-name]",
-    "",
-    "Examples:",
-    "  node validate-plan-blueprint.cjs 47",
-    "  node validate-plan-blueprint.cjs /path/to/plan.md",
-    "  node validate-plan-blueprint.cjs 47 planFile",
-    "  node validate-plan-blueprint.cjs 47 blueprintExists"
-  ];
-  lines.forEach((l) => process.stderr.write(`[ERROR] ${l}
-`));
-};
-var listAvailablePlans = (startPath) => {
-  const tmRoot = findStrikethrooRoot(startPath);
-  if (!tmRoot) return [];
-  const plans = getAllPlans(tmRoot);
-  return plans.map((p) => p.name).sort((a, b) => {
-    const aMatch = a.match(/^(\d+)--/);
-    const bMatch = b.match(/^(\d+)--/);
-    if (!aMatch || !bMatch || !aMatch[1] || !bMatch[1]) return 0;
-    return parseInt(aMatch[1], 10) - parseInt(bMatch[1], 10);
-  });
-};
-var main = () => {
-  const inputId = process.argv[2];
-  const fieldName = process.argv[3];
-  if (!inputId) {
-    usage();
-    process.exit(1);
-  }
-  const numericInput = parseInt(inputId, 10);
-  const isNumeric = !Number.isNaN(numericInput);
-  const isAbsolutePath = inputId.startsWith("/");
-  if (!isNumeric && !isAbsolutePath) {
-    process.stderr.write(`[ERROR] Invalid plan ID: "${inputId}" is not a valid number
-`);
-    process.exit(1);
-  }
-  const resolved = resolvePlan(inputId);
-  if (!resolved) {
-    process.stderr.write(`[ERROR] Plan ID ${inputId} not found or invalid
-`);
-    process.stderr.write("[ERROR] \n");
-    const available = listAvailablePlans(process.cwd());
-    if (available.length > 0) {
-      process.stderr.write("[ERROR] Available plans:\n");
-      available.forEach((name) => process.stderr.write(`[ERROR]   ${name}
-`));
-    }
-    process.exit(1);
-  }
-  const invalidComplexity = validateTaskComplexityScores(resolved.planDir);
-  const result = {
-    planFile: resolved.planFile,
-    planDir: resolved.planDir,
-    strikethrooRoot: resolved.strikethrooRoot,
-    planId: resolved.planId,
-    taskCount: countTaskFiles(resolved.planDir),
-    blueprintExists: hasExecutionBlueprint(resolved.planFile) ? "yes" : "no",
-    complexityScoresValid: invalidComplexity.length === 0 ? "yes" : "no",
-    invalidComplexityTasks: invalidComplexity.join("; ")
-  };
-  if (fieldName) {
-    if (!VALID_FIELDS.includes(fieldName)) {
-      process.stderr.write(`[ERROR] Invalid field name: ${fieldName}
-`);
-      process.stderr.write(`[ERROR] Valid fields: ${VALID_FIELDS.join(", ")}
-`);
-      process.exit(1);
-    }
-    const value = result[fieldName];
-    process.stdout.write(`${String(value)}
-`);
-  } else {
-    process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
-  }
-  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-refine-plan/SKILL.md

@@ -1,132 +0,0 @@
----
-name: st-refine-plan
-description: Use when the user asks to review, refine, improve, interrogate, pressure-test, or update an existing Strikethroo plan by plan ID in this repository — triggers include refine plan, improve plan, review plan, red-team the plan, update plan. Do not use to create a new plan, to generate tasks, or for generic brainstorming outside Strikethroo.
----
-
-# st-refine-plan
-
-## Inputs
-
-The user supplies the numeric plan ID conversationally, plus any optional refinement notes.
-
-## 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.
-
-### 3. Load project context
-
-Read `<root>/config/STRIKETHROO.md` for this project's directory conventions.
-Read `<root>/config/hooks/PRE_PLAN.md` and execute its instructions before
-proceeding. Read `<root>/config/templates/PLAN_TEMPLATE.md`; the refined plan
-must still conform to it. Read `<root>/config/shared/clarification-gate.md`
-and apply it in the Clarification Loop.
-
-### 4. Baseline Review
-
-Read the entire plan end-to-end without modifying it. Record every
-contradiction and every gap you find under these lenses:
-
-- **Context gaps**: missing background, assumptions, competing priorities.
-- **Technical gaps**: underspecified architecture, unclear interfaces, missing diagrams.
-- **Risk gaps**: untracked risks, missing mitigations, hand-wavy success metrics.
-- **Scope issues**: gold-plating, ambiguous boundaries, requirements that
-  contradict YAGNI.
-
-Document each one as `{section, issue, severity, proposed fix}`.
-
-### 5. Clarification Loop
-
-**Default to Interactive Clarification.** Switch to **Autonomous
-Clarification** only when one of these holds without interpretation:
-
-- The user's request names the mode by intent, with a keyword such as "auto",
-  "autonomous", "non-interactive", "without asking me", or "don't ask".
-- An upstream orchestrator (for example the `st-full-workflow` skill) declared
-  autonomous operation for this invocation in the prompt passed to this skill.
-
-Otherwise use Interactive Clarification, even when the user's presence is
-uncertain. Do not infer autonomous mode from indirect signals such as terse
-prompts, scripted-looking input, or absence of recent user messages.
-
-Either branch starts from the gaps documented in the Baseline Review. Think
-harder before raising one: only put forward an uncertainty you can cite.
-Append every resolution to the plan document's "Plan Clarifications" table in
-its existing question/answer format, marking each entry's source.
-
-#### Interactive Clarification
-
-Follow the clarification cadence in `<root>/config/shared/clarification-gate.md`.
-
-1. Ask one question at a time per that cadence; never dump them as a batch.
-2. Prefill each question with the most plausible answer, and always offer an
-   "Other / open-ended" option for the nuances you did not anticipate.
-3. **STOP AND ASK**: Put each question to the user and halt execution to await
-   their input. Do not simulate the user's response. Do not proceed to step 6
-   until you have received explicit answers and confirmed the resolved scope.
-4. Record a question the user cannot or will not answer as unresolved, with
-   mitigation notes so downstream assistants know the risk, then proceed with
-   the available context.
-5. Re-evaluate whether the answers opened new gaps. If so, repeat this loop.
-
-#### Autonomous Clarification
-
-1. Resolve each gap from the codebase, its configuration files, its
-   documentation, and the project's established patterns. Fall back to a
-   reasonable assumption only where those do not answer it.
-2. Mark each resolution's source as "auto-resolved" (confirmed in the
-   codebase) or "assumption" (best-effort guess, with its rationale).
-3. Record a gap you can resolve neither way as unresolved, with mitigation
-   notes so downstream assistants know the risk.
-
-### 6. Refinement Implementation
-
-Refine the plan in place, at the path step 2 resolved.
-
-1. **Maintain Identity**: Keep the existing `id` and directory. Never allocate
-   a new plan ID and never move the plan.
-2. **Structure Compliance**: Keep the plan conformant to
-   `<root>/config/templates/PLAN_TEMPLATE.md`, adding any missing section.
-3. **Content Updates**:
-   - Refresh the executive summary against the clarifications.
-   - Update the architectural sections, diagrams, and risk mitigations the
-     gaps named.
-   - Trim scope creep that is not explicitly required.
-   - Point each affected section back at the Q&A table.
-4. **Net-New Sections**: Add a subsection the plan now needs (Decision Log,
-   Data Contracts) under `Notes`, clearly labeled.
-5. **Change Log**: Append to `Notes` a bullet stating what this session
-   changed, such as
-   `- 2025-03-16: Clarified auth flow tokens and updated architecture diagram`.
-
-### 7. Run the post-plan hook
-
-Execute `<root>/config/hooks/POST_PLAN.md`.
-
-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.
-
-## Failure Modes
-
-- **A helper script fails unexpectedly.** Surface stderr to the user and
-  stop — do not fall back to manual path discovery.