strikethroo 3.7.0 → 3.9.0

package/templates/harness/skills/st-generate-tasks/SKILL.md

@@ -160,7 +160,42 @@ A task B depends on A if B requires A's output or artifacts, modifies code
 created by A, or tests functionality implemented by A. Validate that the
 final dependency graph is acyclic.
 
-### 8. Allocate task IDs
+### 8. Complexity analysis
+
+For every candidate task, assign a `complexity_score` (integer 1–10) before
+writing any file. Base the score on these four dimensions:
+
+| Score | Skill breadth | Acceptance-criteria clarity | Integration surface | Decomposition depth |
+| --- | --- | --- | --- | --- |
+| 1–3 | One well-known skill | Criteria are concrete and observable | None or a single file/module | No further split possible |
+| 4–5 | One primary skill plus a familiar adjacent skill | Criteria are clear with few edge cases | One component or API boundary | Already atomic |
+| 6–7 | Two distinct skills, or one skill with ambiguous requirements | Criteria need clarification or have multiple edge cases | Multiple components or contracts | Could still be split |
+| 8–10 | Three or more skills, or cross-cutting design decisions | Criteria are vague, unknown, or depend on unresolved choices | Wide integration surface or external systems | Must be decomposed further |
+
+**Pre-emission sanity rules** — apply these before any task is written:
+
+- 3+ skills assigned → split the task into smaller tasks, each with 1–2 skills.
+- Vague acceptance criteria → sharpen them until they include at least one
+  concrete, runnable verification step.
+- Trivially small adjacent tasks → merge them into a single task.
+- Score ≥ 8 → decompose further; do not emit as-is.
+- Score 6–7 → either sharpen criteria or split; do not emit without an
+  explicit reason.
+
+**Required frontmatter:**
+
+- Every emitted task MUST include `complexity_score` (integer 1–10).
+- Optionally include `complexity_notes` when the score needs justification,
+  such as "Ambiguous API contract" or "Decomposed from a higher-score parent".
+
+**Loop-back rule:**
+
+After applying split, sharpen, or merge, re-run dependency analysis and
+re-score the adjusted tasks. Repeat this loop no more than three times. If
+complexity is still unresolved after three passes, stop and surface the
+blocker to the user.
+
+### 9. Allocate task IDs
 
 Run `scripts/get-next-task-id.cjs <plan-id>` to obtain the first available
 task ID. Allocate subsequent IDs by incrementing in-process; do not invoke
@@ -170,7 +205,7 @@ field and the zero-padded form (`{padded-id}--{slug}`) for the filename.
 The slug derives from a short task title: lowercase, alphanumeric and
 hyphens only, collapsed, trimmed.
 
-### 9. Emit the task files
+### 10. Emit the task files
 
 Write each task to:
 
@@ -188,11 +223,15 @@ including required frontmatter fields:
 - `created` (YYYY-MM-DD)
 - `skills` (array of 1–2 kebab-case skills)
 
-Optional frontmatter for high-complexity or decomposed tasks:
+Required additional frontmatter:
+
+- `complexity_score` (integer 1–10, required on every emitted task)
+
+Optional frontmatter:
 
-- `complexity_score` (number, 1–10, include only if >4 or for decomposed
-  tasks)
-- `complexity_notes` (string)
+- `complexity_notes` (string) — include when the score needs justification,
+  such as "Decomposed from a cross-cutting parent task" or "Ambiguous API
+  contract".
 
 The body sections (Objective, Skills Required, Acceptance Criteria, Technical
 Requirements, Input Dependencies, Output Artifacts, Implementation Notes)
@@ -200,7 +239,7 @@ must be filled with task-specific content. Place detailed implementation
 guidance inside a `<details>` block under "Implementation Notes" — write it
 so a non-thinking LLM could execute the task from that section alone.
 
-### 10. Validation checklist
+### 11. Validation checklist
 
 Before declaring task generation complete, verify:
 
@@ -218,21 +257,27 @@ Before declaring task generation complete, verify:
 - Minimization applied (20–30% reduction target).
 - Test tasks focus on business logic, not framework functionality.
 - No gold-plating: only plan requirements are addressed.
+- After writing the task files, run
+  `scripts/validate-plan-blueprint.cjs <plan-id> complexityScoresValid`. Stop
+  unless it prints `yes`; if it prints `no`, run
+  `scripts/validate-plan-blueprint.cjs <plan-id> invalidComplexityTasks` to see
+  which files are missing, non-integer, or out-of-range, fix them, and re-run.
+  Every generated task must carry an integer `complexity_score` from 1 to 10.
+- Add `complexity_notes` only when a score needs explanation (typically atomic
+  tasks scoring greater than 4).
 
-### 11. Run the POST_TASK_GENERATION_ALL hook
+### 12. Run the POST_TASK_GENERATION_ALL hook
 
 Read `<root>/config/hooks/POST_TASK_GENERATION_ALL.md` and follow its
 instructions. This typically requires:
 
-- Sanity-checking complexity (3+ technologies/skills → split; vague criteria
-  → sharpen; trivially small → merge).
 - Appending an Execution Blueprint section to the plan document, including a
   Mermaid dependency diagram and explicit phase groupings (Phase 1 contains
   zero-dependency tasks; each subsequent phase contains tasks whose
   dependencies all live in earlier phases). Use
   `<root>/config/templates/BLUEPRINT_TEMPLATE.md` for structure.
 
-### 12. Emit the structured summary
+### 13. Emit the structured summary
 
 Conclude with exactly this block as the final output:
 

package/templates/harness/skills/st-generate-tasks/scripts/find-strikethroo-root.cjs

@@ -37,7 +37,7 @@ 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 ? 2 : 2;
+var EXPECTED_SCHEMA = true ? 3 : 3;
 var isValidStrikethrooRoot = (strikethrooPath) => {
   try {
     if (!fs.existsSync(strikethrooPath)) return false;

package/templates/harness/skills/st-generate-tasks/scripts/get-next-task-id.cjs

@@ -41,7 +41,7 @@ var path3 = __toESM(require("path"));
 // src/skill-scripts/shared/root.ts
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
-var EXPECTED_SCHEMA = true ? 2 : 2;
+var EXPECTED_SCHEMA = true ? 3 : 3;
 var isValidStrikethrooRoot = (strikethrooPath) => {
   try {
     if (!fs.existsSync(strikethrooPath)) return false;

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

@@ -33,13 +33,11 @@ __export(validate_plan_blueprint_exports, {
   main: () => main
 });
 module.exports = __toCommonJS(validate_plan_blueprint_exports);
-var fs4 = __toESM(require("fs"));
-var path4 = __toESM(require("path"));
 
 // src/skill-scripts/shared/root.ts
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
-var EXPECTED_SCHEMA = true ? 2 : 2;
+var EXPECTED_SCHEMA = true ? 3 : 3;
 var isValidStrikethrooRoot = (strikethrooPath) => {
   try {
     if (!fs.existsSync(strikethrooPath)) return false;
@@ -242,34 +240,104 @@ var resolvePlan = (input, startPath = process.cwd()) => {
   return resolveByIdInAncestry(planId, startPath);
 };
 
-// src/skill-scripts/validate-plan-blueprint.ts
-var VALID_FIELDS = [
-  "planFile",
-  "planDir",
-  "taskCount",
-  "blueprintExists",
-  "strikethrooRoot",
-  "planId"
-];
-var countTasks = (planDir) => {
+// 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 (!fs4.existsSync(tasksDir)) return 0;
+  if (!fs5.existsSync(tasksDir)) return 0;
   try {
-    const stat = fs4.lstatSync(tasksDir);
+    const stat = fs5.lstatSync(tasksDir);
     if (!stat.isDirectory()) return 0;
-    return fs4.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).length;
+    return fs5.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).length;
   } catch (_err) {
     return 0;
   }
 };
-var checkBlueprintExists = (planFile) => {
+
+// 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 {
-    const content = fs4.readFileSync(planFile, "utf8");
-    return /^## Execution Blueprint/m.test(content);
+    if (!fs6.lstatSync(tasksDir).isDirectory()) return [];
+    files = fs6.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).sort();
   } catch (_err) {
-    return false;
+    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",
@@ -324,13 +392,16 @@ var main = () => {
     }
     process.exit(1);
   }
+  const invalidComplexity = validateTaskComplexityScores(resolved.planDir);
   const result = {
     planFile: resolved.planFile,
     planDir: resolved.planDir,
     strikethrooRoot: resolved.strikethrooRoot,
     planId: resolved.planId,
-    taskCount: countTasks(resolved.planDir),
-    blueprintExists: checkBlueprintExists(resolved.planFile) ? "yes" : "no"
+    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)) {

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

@@ -37,7 +37,7 @@ 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 ? 2 : 2;
+var EXPECTED_SCHEMA = true ? 3 : 3;
 var isValidStrikethrooRoot = (strikethrooPath) => {
   try {
     if (!fs.existsSync(strikethrooPath)) return false;

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

@@ -33,13 +33,11 @@ __export(validate_plan_blueprint_exports, {
   main: () => main
 });
 module.exports = __toCommonJS(validate_plan_blueprint_exports);
-var fs4 = __toESM(require("fs"));
-var path4 = __toESM(require("path"));
 
 // src/skill-scripts/shared/root.ts
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
-var EXPECTED_SCHEMA = true ? 2 : 2;
+var EXPECTED_SCHEMA = true ? 3 : 3;
 var isValidStrikethrooRoot = (strikethrooPath) => {
   try {
     if (!fs.existsSync(strikethrooPath)) return false;
@@ -242,34 +240,104 @@ var resolvePlan = (input, startPath = process.cwd()) => {
   return resolveByIdInAncestry(planId, startPath);
 };
 
-// src/skill-scripts/validate-plan-blueprint.ts
-var VALID_FIELDS = [
-  "planFile",
-  "planDir",
-  "taskCount",
-  "blueprintExists",
-  "strikethrooRoot",
-  "planId"
-];
-var countTasks = (planDir) => {
+// 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 (!fs4.existsSync(tasksDir)) return 0;
+  if (!fs5.existsSync(tasksDir)) return 0;
   try {
-    const stat = fs4.lstatSync(tasksDir);
+    const stat = fs5.lstatSync(tasksDir);
     if (!stat.isDirectory()) return 0;
-    return fs4.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).length;
+    return fs5.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).length;
   } catch (_err) {
     return 0;
   }
 };
-var checkBlueprintExists = (planFile) => {
+
+// 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 {
-    const content = fs4.readFileSync(planFile, "utf8");
-    return /^## Execution Blueprint/m.test(content);
+    if (!fs6.lstatSync(tasksDir).isDirectory()) return [];
+    files = fs6.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).sort();
   } catch (_err) {
-    return false;
+    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",
@@ -324,13 +392,16 @@ var main = () => {
     }
     process.exit(1);
   }
+  const invalidComplexity = validateTaskComplexityScores(resolved.planDir);
   const result = {
     planFile: resolved.planFile,
     planDir: resolved.planDir,
     strikethrooRoot: resolved.strikethrooRoot,
     planId: resolved.planId,
-    taskCount: countTasks(resolved.planDir),
-    blueprintExists: checkBlueprintExists(resolved.planFile) ? "yes" : "no"
+    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)) {

package/templates/strikethroo/README.md

@@ -4,4 +4,4 @@ This directory contains AI-assisted task management files for this project.
 
 Managed by the [Strikethroo](https://www.github.com/e0ipso/strikethroo) project.
 
-**Documentation**: https://mateuaguilo.com/strikethroo
+**Documentation**: https://strikethroo.canpicasoft.com

package/templates/strikethroo/config/hooks/POST_TASK_GENERATION_ALL.md

@@ -1,20 +1,10 @@
 # POST_TASK_GENERATION_ALL Hook
 
-After all tasks have been generated, perform these two steps:
+After all tasks have been generated, update the plan with the execution blueprint.
 
-## 1. Review Task Complexity
+## 1. Update Plan with Blueprint
 
-For each generated task, do a quick sanity check:
-
-- **Too complex?** If a task spans 3+ technologies or requires 3+ skills, split it.
-- **Too vague?** If acceptance criteria are unclear, sharpen them.
-- **Too trivial?** If two tasks could be one without adding complexity, merge them.
-
-Target: every task should be completable with 1-2 skills and have clear acceptance criteria.
-
-## 2. Update Plan with Blueprint
-
-After finalizing tasks, append to the plan document:
+Append to the plan document:
 
 ### Dependency Diagram
 

package/templates/strikethroo/config/templates/TASK_TEMPLATE.md

@@ -7,6 +7,7 @@ created: [YYYY-MM-DD]
 skills: # Technical skills required for this task
   - [SKILL-1]
   - [SKILL-2]
+complexity_score: [1-10]  # Required on every newly generated task
 ---
 # [TASK-TITLE]
 

package/dist-web/assets/channel-Cmb5ngmL.js

@@ -1 +0,0 @@
-import{U as a,C as n}from"./mermaid.core-B7AM5BmV.js";const t=(r,o)=>a.lang.round(n.parse(r)[o]);export{t as c};

package/dist-web/assets/classDiagram-4FO5ZUOK-Dh2pEfOy.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as e,C as t}from"./chunk-727SXJPM--kGZcEL_.js";import{b as i}from"./mermaid.core-B7AM5BmV.js";import"./chunk-FMBD7UC4-CIkH8fwk.js";import"./chunk-ND2GUHAM-BqrY0fV2.js";import"./chunk-55IACEB6-CoVGj0A6.js";import"./chunk-2J33WTMH-D4OfjzqG.js";import"./index-uk0kSvAs.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};

package/dist-web/assets/classDiagram-v2-Q7XG4LA2-Dh2pEfOy.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as e,C as t}from"./chunk-727SXJPM--kGZcEL_.js";import{b as i}from"./mermaid.core-B7AM5BmV.js";import"./chunk-FMBD7UC4-CIkH8fwk.js";import"./chunk-ND2GUHAM-BqrY0fV2.js";import"./chunk-55IACEB6-CoVGj0A6.js";import"./chunk-2J33WTMH-D4OfjzqG.js";import"./index-uk0kSvAs.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};

package/dist-web/assets/stateDiagram-v2-BHNVJYJU-qo6que2v.js

@@ -1 +0,0 @@
-import{b as e,a as r,s as a,S as s}from"./chunk-AQP2D5EJ-dK8X6Knv.js";import{b as i}from"./mermaid.core-B7AM5BmV.js";import"./chunk-55IACEB6-CoVGj0A6.js";import"./chunk-2J33WTMH-D4OfjzqG.js";import"./index-uk0kSvAs.js";var u={parser:a,get db(){return new s(2)},renderer:r,styles:e,init:i(t=>{t.state||(t.state={}),t.state.arrowMarkerAbsolute=t.arrowMarkerAbsolute},"init")};export{u as diagram};