strikethroo 3.21.3 → 3.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/README.md +10 -0
  2. package/dist/__tests__/built-skills.d.ts +15 -0
  3. package/dist/__tests__/built-skills.d.ts.map +1 -0
  4. package/dist/__tests__/built-skills.js +53 -0
  5. package/dist/__tests__/built-skills.js.map +1 -0
  6. package/dist/cli.js +19 -1
  7. package/dist/cli.js.map +1 -1
  8. package/dist/index.d.ts +2 -0
  9. package/dist/index.d.ts.map +1 -1
  10. package/dist/index.js +50 -15
  11. package/dist/index.js.map +1 -1
  12. package/dist/resolve-init-harnesses.d.ts +30 -0
  13. package/dist/resolve-init-harnesses.d.ts.map +1 -0
  14. package/dist/resolve-init-harnesses.js +44 -0
  15. package/dist/resolve-init-harnesses.js.map +1 -0
  16. package/dist/types.d.ts +32 -1
  17. package/dist/types.d.ts.map +1 -1
  18. package/dist/types.js.map +1 -1
  19. package/dist/update.d.ts +28 -0
  20. package/dist/update.d.ts.map +1 -0
  21. package/dist/update.js +198 -0
  22. package/dist/update.js.map +1 -0
  23. package/dist-web/assets/{arc-8Mxnwqfp.js → arc-Hwddr2kO.js} +1 -1
  24. package/dist-web/assets/{architectureDiagram-3BPJPVTR-CjR6ApxR.js → architectureDiagram-3BPJPVTR-i11AtK7_.js} +1 -1
  25. package/dist-web/assets/{blockDiagram-GPEHLZMM-DhGYH8V9.js → blockDiagram-GPEHLZMM-BBT6cVNX.js} +1 -1
  26. package/dist-web/assets/{c4Diagram-AAUBKEIU-BpUJqbui.js → c4Diagram-AAUBKEIU-C3vqlA6y.js} +1 -1
  27. package/dist-web/assets/channel-Cur0s-J7.js +1 -0
  28. package/dist-web/assets/{chunk-2J33WTMH-BX8NM2bi.js → chunk-2J33WTMH-B2qLeglu.js} +1 -1
  29. package/dist-web/assets/{chunk-4BX2VUAB-ChNDzlNh.js → chunk-4BX2VUAB-BOoURq0p.js} +1 -1
  30. package/dist-web/assets/{chunk-55IACEB6-62ChSXXQ.js → chunk-55IACEB6-DucbZmPO.js} +1 -1
  31. package/dist-web/assets/{chunk-727SXJPM-DM_m3yWL.js → chunk-727SXJPM-D1jwNHG5.js} +1 -1
  32. package/dist-web/assets/{chunk-AQP2D5EJ-DZcEQaCW.js → chunk-AQP2D5EJ-DEqgF-yl.js} +1 -1
  33. package/dist-web/assets/{chunk-FMBD7UC4-jITTRsf2.js → chunk-FMBD7UC4-DyqowetS.js} +1 -1
  34. package/dist-web/assets/{chunk-ND2GUHAM-D73huh8-.js → chunk-ND2GUHAM-B5m1NGQ0.js} +1 -1
  35. package/dist-web/assets/{chunk-QZHKN3VN-DqdeIFoN.js → chunk-QZHKN3VN-DuDvOVer.js} +1 -1
  36. package/dist-web/assets/classDiagram-4FO5ZUOK-CjiILMRI.js +1 -0
  37. package/dist-web/assets/classDiagram-v2-Q7XG4LA2-CjiILMRI.js +1 -0
  38. package/dist-web/assets/{cose-bilkent-S5V4N54A-B6y8LQMc.js → cose-bilkent-S5V4N54A-C9HUgr5R.js} +1 -1
  39. package/dist-web/assets/{dagre-BM42HDAG-CEudzPZe.js → dagre-BM42HDAG-DT3KjQHY.js} +1 -1
  40. package/dist-web/assets/{diagram-2AECGRRQ-ADCpFrWI.js → diagram-2AECGRRQ-DrCpXRj9.js} +1 -1
  41. package/dist-web/assets/{diagram-5GNKFQAL-BQcNfKgC.js → diagram-5GNKFQAL-QcCYThB2.js} +1 -1
  42. package/dist-web/assets/{diagram-KO2AKTUF-2Y25ZUgl.js → diagram-KO2AKTUF-BsaZwGbo.js} +1 -1
  43. package/dist-web/assets/{diagram-LMA3HP47-qiLQPz0R.js → diagram-LMA3HP47-B6ZqNLaZ.js} +1 -1
  44. package/dist-web/assets/{diagram-OG6HWLK6-5tV6wHg0.js → diagram-OG6HWLK6-ZfJLCrYD.js} +1 -1
  45. package/dist-web/assets/{erDiagram-TEJ5UH35-C9KwzSBJ.js → erDiagram-TEJ5UH35-BlnJ9PIz.js} +1 -1
  46. package/dist-web/assets/{flowDiagram-I6XJVG4X-DWFT6yjl.js → flowDiagram-I6XJVG4X-CIfl3CnE.js} +1 -1
  47. package/dist-web/assets/{ganttDiagram-6RSMTGT7-CwOaaOj-.js → ganttDiagram-6RSMTGT7-CPrwdiin.js} +1 -1
  48. package/dist-web/assets/{gitGraphDiagram-PVQCEYII-D9GwiRiE.js → gitGraphDiagram-PVQCEYII-DcY9oRGk.js} +1 -1
  49. package/dist-web/assets/{index-R-j45X6T.js → index-COfame-T.js} +4 -4
  50. package/dist-web/assets/{index-CJtNiGoR.js → index-DGtMmSy6.js} +1 -1
  51. package/dist-web/assets/{index-CXzu9Ojw.js → index-j2lPssdc.js} +1 -1
  52. package/dist-web/assets/{infoDiagram-5YYISTIA-8s7z_vpg.js → infoDiagram-5YYISTIA-DVU5i5FV.js} +1 -1
  53. package/dist-web/assets/{ishikawaDiagram-YF4QCWOH-mkZLBAJy.js → ishikawaDiagram-YF4QCWOH-B8Ga6Rav.js} +1 -1
  54. package/dist-web/assets/{journeyDiagram-JHISSGLW-CrSmLI8k.js → journeyDiagram-JHISSGLW-DOzvgBoA.js} +1 -1
  55. package/dist-web/assets/{kanban-definition-UN3LZRKU-jB_Pkb2G.js → kanban-definition-UN3LZRKU-BGc6pe_I.js} +1 -1
  56. package/dist-web/assets/{linear-BmZe-JSe.js → linear-BpZOijWC.js} +1 -1
  57. package/dist-web/assets/{mermaid.core-kJp9v7BU.js → mermaid.core-C_2qQ8rS.js} +4 -4
  58. package/dist-web/assets/{mindmap-definition-RKZ34NQL-BygLhP5m.js → mindmap-definition-RKZ34NQL-DkMM_7Yr.js} +1 -1
  59. package/dist-web/assets/{pieDiagram-4H26LBE5-CERgWyaB.js → pieDiagram-4H26LBE5-1TkSQl-I.js} +1 -1
  60. package/dist-web/assets/{quadrantDiagram-W4KKPZXB-BA_bITko.js → quadrantDiagram-W4KKPZXB-cmPoFli_.js} +1 -1
  61. package/dist-web/assets/{requirementDiagram-4Y6WPE33-BkZUv4kJ.js → requirementDiagram-4Y6WPE33-BRm2ySws.js} +1 -1
  62. package/dist-web/assets/{sankeyDiagram-5OEKKPKP-DpAA7Nm0.js → sankeyDiagram-5OEKKPKP-Bm7c5KA3.js} +1 -1
  63. package/dist-web/assets/{sequenceDiagram-3UESZ5HK-D1A1wk57.js → sequenceDiagram-3UESZ5HK-TsJi1UnU.js} +1 -1
  64. package/dist-web/assets/{stateDiagram-AJRCARHV-GNvrUmkz.js → stateDiagram-AJRCARHV-C96-LO_W.js} +1 -1
  65. package/dist-web/assets/stateDiagram-v2-BHNVJYJU-DyP066tY.js +1 -0
  66. package/dist-web/assets/{timeline-definition-PNZ67QCA-GEOSAbn6.js → timeline-definition-PNZ67QCA-CXS_QOle.js} +1 -1
  67. package/dist-web/assets/{vennDiagram-CIIHVFJN-D_IwvMPq.js → vennDiagram-CIIHVFJN-C2GyjnKb.js} +1 -1
  68. package/dist-web/assets/{wardley-L42UT6IY-CpNQq-PK.js → wardley-L42UT6IY-B4Z1vQiy.js} +1 -1
  69. package/dist-web/assets/{wardleyDiagram-YWT4CUSO-DjyTS7lS.js → wardleyDiagram-YWT4CUSO-C4rdUwqJ.js} +1 -1
  70. package/dist-web/assets/{xychartDiagram-2RQKCTM6-Bi0kYEuJ.js → xychartDiagram-2RQKCTM6-ldEuZMCT.js} +1 -1
  71. package/dist-web/index.html +1 -1
  72. package/package.json +5 -1
  73. package/templates/strikethroo/config/templates/UPDATE_NOTICE_TEMPLATE.md +1 -0
  74. package/dist-web/assets/channel-BJWsQ6W2.js +0 -1
  75. package/dist-web/assets/classDiagram-4FO5ZUOK-yCIjCNKh.js +0 -1
  76. package/dist-web/assets/classDiagram-v2-Q7XG4LA2-yCIjCNKh.js +0 -1
  77. package/dist-web/assets/stateDiagram-v2-BHNVJYJU-DkJ7czmr.js +0 -1
  78. package/templates/harness/skills/st-code-review/SKILL.md +0 -52
  79. package/templates/harness/skills/st-code-review/references/review-example.xml.md +0 -18
  80. package/templates/harness/skills/st-code-review/scripts/code-review.cjs +0 -3887
  81. package/templates/harness/skills/st-code-review/scripts/find-strikethroo-root.cjs +0 -116
  82. package/templates/harness/skills/st-code-review/scripts/validate-plan-blueprint.cjs +0 -429
  83. package/templates/harness/skills/st-create-plan/SKILL.md +0 -100
  84. package/templates/harness/skills/st-create-plan/scripts/find-strikethroo-root.cjs +0 -116
  85. package/templates/harness/skills/st-create-plan/scripts/get-next-plan-id.cjs +0 -197
  86. package/templates/harness/skills/st-execute-blueprint/SKILL.md +0 -184
  87. package/templates/harness/skills/st-execute-blueprint/scripts/capture-base-commit.cjs +0 -330
  88. package/templates/harness/skills/st-execute-blueprint/scripts/check-phase-readiness.cjs +0 -471
  89. package/templates/harness/skills/st-execute-blueprint/scripts/create-feature-branch.cjs +0 -374
  90. package/templates/harness/skills/st-execute-blueprint/scripts/dispatch-task-execution.cjs +0 -6815
  91. package/templates/harness/skills/st-execute-blueprint/scripts/find-strikethroo-root.cjs +0 -116
  92. package/templates/harness/skills/st-execute-blueprint/scripts/validate-plan-blueprint.cjs +0 -429
  93. package/templates/harness/skills/st-execute-task/SKILL.md +0 -138
  94. package/templates/harness/skills/st-execute-task/scripts/check-task-dependencies.cjs +0 -462
  95. package/templates/harness/skills/st-execute-task/scripts/dispatch-task-execution.cjs +0 -6815
  96. package/templates/harness/skills/st-execute-task/scripts/find-strikethroo-root.cjs +0 -116
  97. package/templates/harness/skills/st-execute-task/scripts/validate-plan-blueprint.cjs +0 -429
  98. package/templates/harness/skills/st-full-workflow/SKILL.md +0 -453
  99. package/templates/harness/skills/st-full-workflow/references/complexity-rubric.md +0 -8
  100. package/templates/harness/skills/st-full-workflow/scripts/capture-base-commit.cjs +0 -330
  101. package/templates/harness/skills/st-full-workflow/scripts/check-phase-readiness.cjs +0 -471
  102. package/templates/harness/skills/st-full-workflow/scripts/create-feature-branch.cjs +0 -374
  103. package/templates/harness/skills/st-full-workflow/scripts/dispatch-task-execution.cjs +0 -6815
  104. package/templates/harness/skills/st-full-workflow/scripts/find-strikethroo-root.cjs +0 -116
  105. package/templates/harness/skills/st-full-workflow/scripts/get-next-plan-id.cjs +0 -197
  106. package/templates/harness/skills/st-full-workflow/scripts/get-next-task-id.cjs +0 -295
  107. package/templates/harness/skills/st-full-workflow/scripts/route-task-execution.cjs +0 -2874
  108. package/templates/harness/skills/st-full-workflow/scripts/validate-plan-blueprint.cjs +0 -429
  109. package/templates/harness/skills/st-generate-tasks/SKILL.md +0 -207
  110. package/templates/harness/skills/st-generate-tasks/references/complexity-rubric.md +0 -8
  111. package/templates/harness/skills/st-generate-tasks/scripts/find-strikethroo-root.cjs +0 -116
  112. package/templates/harness/skills/st-generate-tasks/scripts/get-next-task-id.cjs +0 -295
  113. package/templates/harness/skills/st-generate-tasks/scripts/route-task-execution.cjs +0 -2874
  114. package/templates/harness/skills/st-generate-tasks/scripts/validate-plan-blueprint.cjs +0 -429
  115. package/templates/harness/skills/st-refine-plan/SKILL.md +0 -121
  116. package/templates/harness/skills/st-refine-plan/scripts/find-strikethroo-root.cjs +0 -116
  117. package/templates/harness/skills/st-refine-plan/scripts/validate-plan-blueprint.cjs +0 -429
@@ -1,429 +0,0 @@
1
- "use strict";
2
- var __create = Object.create;
3
- var __defProp = Object.defineProperty;
4
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
- var __getOwnPropNames = Object.getOwnPropertyNames;
6
- var __getProtoOf = Object.getPrototypeOf;
7
- var __hasOwnProp = Object.prototype.hasOwnProperty;
8
- var __export = (target, all) => {
9
- for (var name in all)
10
- __defProp(target, name, { get: all[name], enumerable: true });
11
- };
12
- var __copyProps = (to, from, except, desc) => {
13
- if (from && typeof from === "object" || typeof from === "function") {
14
- for (let key of __getOwnPropNames(from))
15
- if (!__hasOwnProp.call(to, key) && key !== except)
16
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
17
- }
18
- return to;
19
- };
20
- var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
- // If the importer is in node compatibility mode or this is not an ESM
22
- // file that has been converted to a CommonJS file using a Babel-
23
- // compatible transform (i.e. "__esModule" has not been set), then set
24
- // "default" to the CommonJS "module.exports" for node compatibility.
25
- isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
- mod
27
- ));
28
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
29
-
30
- // src/skill-scripts/validate-plan-blueprint.ts
31
- var validate_plan_blueprint_exports = {};
32
- __export(validate_plan_blueprint_exports, {
33
- main: () => main
34
- });
35
- module.exports = __toCommonJS(validate_plan_blueprint_exports);
36
-
37
- // src/skill-scripts/shared/root.ts
38
- var fs = __toESM(require("fs"));
39
- var path = __toESM(require("path"));
40
- var EXPECTED_SCHEMA = true ? 4 : 4;
41
- var isValidStrikethrooRoot = (strikethrooPath) => {
42
- try {
43
- if (!fs.existsSync(strikethrooPath)) return false;
44
- if (!fs.lstatSync(strikethrooPath).isDirectory()) return false;
45
- const metadataPath = path.join(strikethrooPath, ".init-metadata.json");
46
- if (!fs.existsSync(metadataPath)) return false;
47
- const metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
48
- return metadata && typeof metadata === "object" && "version" in metadata;
49
- } catch (_err) {
50
- return false;
51
- }
52
- };
53
- var getStrikethrooAt = (directory) => {
54
- const strikethrooPath = path.join(directory, ".ai", "strikethroo");
55
- return isValidStrikethrooRoot(strikethrooPath) ? strikethrooPath : null;
56
- };
57
- var getParentPaths = (currentPath, acc = []) => {
58
- const absolutePath = path.resolve(currentPath);
59
- const nextAcc = [...acc, absolutePath];
60
- const parentPath = path.dirname(absolutePath);
61
- if (parentPath === absolutePath) return nextAcc;
62
- return getParentPaths(parentPath, nextAcc);
63
- };
64
- var checkWorkspaceSchema = (metadataPath) => {
65
- let metadata;
66
- try {
67
- metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
68
- } catch {
69
- return;
70
- }
71
- const actual = typeof metadata.workspaceSchemaVersion === "number" ? metadata.workspaceSchemaVersion : 1;
72
- if (actual === EXPECTED_SCHEMA) return;
73
- if (actual < EXPECTED_SCHEMA) {
74
- process.stderr.write(
75
- `Workspace schema v${actual} is older than this skill requires (v${EXPECTED_SCHEMA}). Re-run \`npx strikethroo init\` with the latest CLI to update.
76
- `
77
- );
78
- } else {
79
- process.stderr.write(
80
- `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.
81
- `
82
- );
83
- }
84
- process.exit(1);
85
- };
86
- var findStrikethrooRoot = (startPath = process.cwd()) => {
87
- const paths = getParentPaths(startPath);
88
- const found = paths.find((p) => getStrikethrooAt(p));
89
- if (!found) return null;
90
- const root = getStrikethrooAt(found);
91
- if (root) checkWorkspaceSchema(path.join(root, ".init-metadata.json"));
92
- return root;
93
- };
94
-
95
- // src/skill-scripts/shared/plan-scan.ts
96
- var fs2 = __toESM(require("fs"));
97
- var path2 = __toESM(require("path"));
98
-
99
- // src/skill-scripts/shared/frontmatter.ts
100
- var ID_PATTERNS = [
101
- /^\s*["']?id["']?\s*:\s*["']?([+-]?\d+)["']?\s*(?:#.*)?$/im,
102
- /^\s*id\s*:\s*([+-]?\d+)\s*(?:#.*)?$/im,
103
- /^\s*["']?id["']?\s*:\s*"([+-]?\d+)"\s*(?:#.*)?$/im,
104
- /^\s*["']?id["']?\s*:\s*'([+-]?\d+)'\s*(?:#.*)?$/im,
105
- /^\s*["']id["']\s*:\s*([+-]?\d+)\s*(?:#.*)?$/im,
106
- /^\s*id\s*:\s*[|>]\s*([+-]?\d+)\s*$/im
107
- ];
108
- var validateId = (rawId) => {
109
- const id = parseInt(rawId, 10);
110
- if (Number.isNaN(id) || id < 0 || id > Number.MAX_SAFE_INTEGER) return null;
111
- return id;
112
- };
113
- var extractIdFromMarkdown = (content) => {
114
- const frontmatterMatch = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
115
- if (!frontmatterMatch || !frontmatterMatch[1]) return null;
116
- const block = frontmatterMatch[1];
117
- for (const pattern of ID_PATTERNS) {
118
- const match = block.match(pattern);
119
- if (match && match[1]) {
120
- const id = validateId(match[1]);
121
- if (id !== null) return id;
122
- }
123
- }
124
- return null;
125
- };
126
- var extractPlanId = (content, _filePath) => {
127
- return extractIdFromMarkdown(content);
128
- };
129
-
130
- // src/skill-scripts/shared/plan-scan.ts
131
- var PLAN_EXTENSIONS = [".md"];
132
- var scanPlanDir = (planDirPath, dirName, isArchive) => {
133
- let entries;
134
- try {
135
- entries = fs2.readdirSync(planDirPath, { withFileTypes: true });
136
- } catch (_err) {
137
- return [];
138
- }
139
- return entries.filter((e) => e.isFile() && PLAN_EXTENSIONS.some((ext) => e.name.endsWith(ext))).flatMap((e) => {
140
- const filePath = path2.join(planDirPath, e.name);
141
- try {
142
- const content = fs2.readFileSync(filePath, "utf8");
143
- const id = extractPlanId(content, filePath);
144
- if (id === null) return [];
145
- return [{ id, file: filePath, dir: planDirPath, isArchive, name: dirName }];
146
- } catch (_err) {
147
- return [];
148
- }
149
- });
150
- };
151
- var getAllPlans = (taskManagerRoot) => {
152
- const sources = [
153
- { dir: path2.join(taskManagerRoot, "plans"), isArchive: false },
154
- { dir: path2.join(taskManagerRoot, "archive"), isArchive: true }
155
- ];
156
- return sources.flatMap(({ dir, isArchive }) => {
157
- if (!fs2.existsSync(dir)) return [];
158
- let entries;
159
- try {
160
- entries = fs2.readdirSync(dir, { withFileTypes: true });
161
- } catch (_err) {
162
- return [];
163
- }
164
- return entries.filter((e) => e.isDirectory()).flatMap((e) => scanPlanDir(path2.join(dir, e.name), e.name, isArchive));
165
- });
166
- };
167
-
168
- // src/skill-scripts/shared/plan-resolve.ts
169
- var fs3 = __toESM(require("fs"));
170
- var path3 = __toESM(require("path"));
171
- var isValidRootDir = (strikethrooPath) => {
172
- try {
173
- if (!fs3.existsSync(strikethrooPath)) return false;
174
- if (!fs3.lstatSync(strikethrooPath).isDirectory()) return false;
175
- const metadataPath = path3.join(strikethrooPath, ".init-metadata.json");
176
- if (!fs3.existsSync(metadataPath)) return false;
177
- const metadata = JSON.parse(fs3.readFileSync(metadataPath, "utf8"));
178
- return metadata && typeof metadata === "object" && "version" in metadata;
179
- } catch (_err) {
180
- return false;
181
- }
182
- };
183
- var checkStandardRootShortcut = (filePath) => {
184
- const planDir = path3.dirname(filePath);
185
- const parentDir = path3.dirname(planDir);
186
- const possibleRoot = path3.dirname(parentDir);
187
- const parentBase = path3.basename(parentDir);
188
- if (parentBase !== "plans" && parentBase !== "archive") return null;
189
- if (path3.basename(possibleRoot) !== "strikethroo") return null;
190
- const dotAiDir = path3.dirname(possibleRoot);
191
- if (path3.basename(dotAiDir) !== ".ai") return null;
192
- return isValidRootDir(possibleRoot) ? possibleRoot : null;
193
- };
194
- var resolveByPath = (absolutePath) => {
195
- let content;
196
- try {
197
- content = fs3.readFileSync(absolutePath, "utf8");
198
- } catch (_err) {
199
- return null;
200
- }
201
- const planId = extractPlanId(content, absolutePath);
202
- if (planId === null) return null;
203
- const tmRoot = checkStandardRootShortcut(absolutePath) || findStrikethrooRoot(path3.dirname(absolutePath));
204
- if (!tmRoot) return null;
205
- return {
206
- planFile: absolutePath,
207
- planDir: path3.dirname(absolutePath),
208
- strikethrooRoot: tmRoot,
209
- planId
210
- };
211
- };
212
- var resolveByIdInAncestry = (planId, startPath, searched = /* @__PURE__ */ new Set()) => {
213
- const tmRoot = findStrikethrooRoot(startPath);
214
- if (!tmRoot) return null;
215
- const normalized = path3.normalize(tmRoot);
216
- if (searched.has(normalized)) return null;
217
- searched.add(normalized);
218
- const plans = getAllPlans(tmRoot);
219
- const match = plans.find((p) => p.id === planId);
220
- if (match) {
221
- return {
222
- planFile: match.file,
223
- planDir: match.dir,
224
- strikethrooRoot: tmRoot,
225
- planId
226
- };
227
- }
228
- const parentOfRoot = path3.dirname(path3.dirname(tmRoot));
229
- if (parentOfRoot === tmRoot) return null;
230
- return resolveByIdInAncestry(planId, parentOfRoot, searched);
231
- };
232
- var resolvePlan = (input, startPath = process.cwd()) => {
233
- if (input === null || input === void 0 || input === "") return null;
234
- const inputStr = String(input);
235
- if (inputStr.startsWith("/")) {
236
- return resolveByPath(inputStr);
237
- }
238
- const planId = parseInt(inputStr, 10);
239
- if (Number.isNaN(planId)) return null;
240
- return resolveByIdInAncestry(planId, startPath);
241
- };
242
-
243
- // src/skill-scripts/shared/blueprint-detection.ts
244
- var fs4 = __toESM(require("fs"));
245
- var hasExecutionBlueprint = (planFile) => {
246
- try {
247
- const content = fs4.readFileSync(planFile, "utf8");
248
- return /^## Execution Blueprint/m.test(content);
249
- } catch (_err) {
250
- return false;
251
- }
252
- };
253
-
254
- // src/skill-scripts/shared/task-count.ts
255
- var fs5 = __toESM(require("fs"));
256
- var path4 = __toESM(require("path"));
257
- var countTaskFiles = (planDir) => {
258
- const tasksDir = path4.join(planDir, "tasks");
259
- if (!fs5.existsSync(tasksDir)) return 0;
260
- try {
261
- const stat = fs5.lstatSync(tasksDir);
262
- if (!stat.isDirectory()) return 0;
263
- return fs5.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).length;
264
- } catch (_err) {
265
- return 0;
266
- }
267
- };
268
-
269
- // src/skill-scripts/shared/task-complexity.ts
270
- var fs6 = __toESM(require("fs"));
271
- var path5 = __toESM(require("path"));
272
-
273
- // src/skill-scripts/shared/complexity-score.ts
274
- var validateComplexityScore = (value) => {
275
- const trimmed = value.trim();
276
- if (!/^\d+$/.test(trimmed)) {
277
- return { valid: false, reason: "non-integer" };
278
- }
279
- const parsed = Number.parseInt(trimmed, 10);
280
- if (parsed < 1 || parsed > 10) {
281
- return { valid: false, reason: "out-of-range", value: parsed };
282
- }
283
- return { valid: true, value: parsed };
284
- };
285
-
286
- // src/skill-scripts/shared/task-file.ts
287
- var extractFrontmatter = (content) => {
288
- const match = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
289
- return match && match[1] ? match[1] : null;
290
- };
291
-
292
- // src/skill-scripts/shared/task-complexity.ts
293
- var validateTaskComplexityScores = (planDir) => {
294
- const tasksDir = path5.join(planDir, "tasks");
295
- if (!fs6.existsSync(tasksDir)) return [];
296
- let files;
297
- try {
298
- if (!fs6.lstatSync(tasksDir).isDirectory()) return [];
299
- files = fs6.readdirSync(tasksDir).filter((f) => f.endsWith(".md")).sort();
300
- } catch (_err) {
301
- return [];
302
- }
303
- const invalid = [];
304
- for (const file of files) {
305
- let content;
306
- try {
307
- content = fs6.readFileSync(path5.join(tasksDir, file), "utf8");
308
- } catch (_err) {
309
- invalid.push(`${file}: unreadable`);
310
- continue;
311
- }
312
- const frontmatter = extractFrontmatter(content);
313
- const match = frontmatter ? frontmatter.match(/^\s*complexity_score\s*:\s*(.*?)\s*(?:#.*)?$/im) : null;
314
- if (!match || match[1] === void 0) {
315
- invalid.push(`${file}: missing complexity_score`);
316
- continue;
317
- }
318
- const raw = match[1].trim();
319
- const result = validateComplexityScore(raw);
320
- if (result.valid) continue;
321
- if (result.reason === "non-integer") {
322
- invalid.push(`${file}: non-integer complexity_score "${raw}"`);
323
- continue;
324
- }
325
- invalid.push(`${file}: complexity_score ${result.value} out of range 1-10`);
326
- }
327
- return invalid;
328
- };
329
-
330
- // src/skill-scripts/validate-plan-blueprint.ts
331
- var VALID_FIELDS = [
332
- "planFile",
333
- "planDir",
334
- "taskCount",
335
- "blueprintExists",
336
- "strikethrooRoot",
337
- "planId",
338
- "complexityScoresValid",
339
- "invalidComplexityTasks"
340
- ];
341
- var usage = () => {
342
- const lines = [
343
- "Plan ID or absolute path is required",
344
- "",
345
- "Usage: node validate-plan-blueprint.cjs <plan-id-or-path> [field-name]",
346
- "",
347
- "Examples:",
348
- " node validate-plan-blueprint.cjs 47",
349
- " node validate-plan-blueprint.cjs /path/to/plan.md",
350
- " node validate-plan-blueprint.cjs 47 planFile",
351
- " node validate-plan-blueprint.cjs 47 blueprintExists"
352
- ];
353
- lines.forEach((l) => process.stderr.write(`[ERROR] ${l}
354
- `));
355
- };
356
- var listAvailablePlans = (startPath) => {
357
- const tmRoot = findStrikethrooRoot(startPath);
358
- if (!tmRoot) return [];
359
- const plans = getAllPlans(tmRoot);
360
- return plans.map((p) => p.name).sort((a, b) => {
361
- const aMatch = a.match(/^(\d+)--/);
362
- const bMatch = b.match(/^(\d+)--/);
363
- if (!aMatch || !bMatch || !aMatch[1] || !bMatch[1]) return 0;
364
- return parseInt(aMatch[1], 10) - parseInt(bMatch[1], 10);
365
- });
366
- };
367
- var main = () => {
368
- const inputId = process.argv[2];
369
- const fieldName = process.argv[3];
370
- if (!inputId) {
371
- usage();
372
- process.exit(1);
373
- }
374
- const numericInput = parseInt(inputId, 10);
375
- const isNumeric = !Number.isNaN(numericInput);
376
- const isAbsolutePath = inputId.startsWith("/");
377
- if (!isNumeric && !isAbsolutePath) {
378
- process.stderr.write(`[ERROR] Invalid plan ID: "${inputId}" is not a valid number
379
- `);
380
- process.exit(1);
381
- }
382
- const resolved = resolvePlan(inputId);
383
- if (!resolved) {
384
- process.stderr.write(`[ERROR] Plan ID ${inputId} not found or invalid
385
- `);
386
- process.stderr.write("[ERROR] \n");
387
- const available = listAvailablePlans(process.cwd());
388
- if (available.length > 0) {
389
- process.stderr.write("[ERROR] Available plans:\n");
390
- available.forEach((name) => process.stderr.write(`[ERROR] ${name}
391
- `));
392
- }
393
- process.exit(1);
394
- }
395
- const invalidComplexity = validateTaskComplexityScores(resolved.planDir);
396
- const result = {
397
- planFile: resolved.planFile,
398
- planDir: resolved.planDir,
399
- strikethrooRoot: resolved.strikethrooRoot,
400
- planId: resolved.planId,
401
- taskCount: countTaskFiles(resolved.planDir),
402
- blueprintExists: hasExecutionBlueprint(resolved.planFile) ? "yes" : "no",
403
- complexityScoresValid: invalidComplexity.length === 0 ? "yes" : "no",
404
- invalidComplexityTasks: invalidComplexity.join("; ")
405
- };
406
- if (fieldName) {
407
- if (!VALID_FIELDS.includes(fieldName)) {
408
- process.stderr.write(`[ERROR] Invalid field name: ${fieldName}
409
- `);
410
- process.stderr.write(`[ERROR] Valid fields: ${VALID_FIELDS.join(", ")}
411
- `);
412
- process.exit(1);
413
- }
414
- const value = result[fieldName];
415
- process.stdout.write(`${String(value)}
416
- `);
417
- } else {
418
- process.stdout.write(`${JSON.stringify(result, null, 2)}
419
- `);
420
- }
421
- process.exit(0);
422
- };
423
- if (require.main === module) {
424
- main();
425
- }
426
- // Annotate the CommonJS export names for ESM import in node:
427
- 0 && (module.exports = {
428
- main
429
- });
@@ -1,207 +0,0 @@
1
- ---
2
- name: st-generate-tasks
3
- description: Use when the user asks to decompose, break down, or generate tasks for an existing Strikethroo plan ID in this repository — triggers include generate tasks, break down the plan, decompose plan, create the task blueprint. Do not use to create a new plan, to execute tasks, or for generic project planning outside Strikethroo.
4
- ---
5
-
6
- # st-generate-tasks
7
-
8
- ## Inputs
9
-
10
- The user supplies the numeric plan ID conversationally.
11
-
12
- ## Operating Procedure
13
-
14
- ### 1. Locate the strikethroo root
15
-
16
- Run `scripts/find-strikethroo-root.cjs` from the user's working directory. If
17
- it exits non-zero, stop and ask the user to run `npx strikethroo init`.
18
-
19
- Treat the path it prints as `<root>` for every subsequent step.
20
-
21
- ### 2. Resolve the plan
22
-
23
- Run `scripts/validate-plan-blueprint.cjs <plan-id> planFile` for the plan
24
- file's absolute path. Another field name prints that field instead.
25
-
26
- If the script exits non-zero, stop and ask the user to confirm the plan ID.
27
- Do not guess a different ID.
28
-
29
- ### 3. Load project context
30
-
31
- Read these files, in order:
32
-
33
- - `<root>/config/STRIKETHROO.md` — project and directory conventions.
34
- - The plan body at the path returned by step 2 — the contract for
35
- what tasks must exist.
36
- - `<root>/config/templates/TASK_TEMPLATE.md` — the schema every task file
37
- must match.
38
- - `<root>/config/shared/anti-rationalization.md` — apply in step 4.
39
-
40
- ### 4. Analyze and decompose the plan
41
-
42
- Read the entire plan. Identify all concrete deliverables **explicitly stated**.
43
- Decompose each deliverable into atomic tasks only when genuinely needed.
44
-
45
- **Task minimization (mandatory):**
46
-
47
- - Create only the minimum number of tasks necessary. Target a 20–30%
48
- reduction from comprehensive lists by questioning the necessity of each
49
- candidate.
50
- - Every task corresponds to an explicit requirement, never a nice-to-have, a
51
- "best practice", or future extensibility the plan does not mention.
52
- - Each task has a unique, non-overlapping purpose.
53
- - Keep error handling inside the task that owns the behavior it guards.
54
-
55
- Apply `<root>/config/shared/anti-rationalization.md` to this rationalization table:
56
-
57
- | You catch yourself thinking… | The binding rule |
58
- | --- | --- |
59
- | "One extra task won't hurt." | It violates the 20–30% minimization target. Every task traces to an **explicitly stated** deliverable or it does not exist. |
60
- | "This edge case deserves its own task." | Fold it into the task that owns the behavior. Do not split trivially small operations into separate units. |
61
- | "I'll add a test suite to be safe." | Comprehensive tests for trivial functionality are gold-plating. Follow the test philosophy — meaningful tests only. |
62
- | "Future extensibility justifies this task." | YAGNI. The plan does not mention it, so it is not a task. |
63
-
64
- ### 5. Apply granularity and skill rules
65
-
66
- Each task must be:
67
-
68
- - **Single-purpose** — one clear deliverable.
69
- - **Atomic** — cannot be meaningfully split further.
70
- - **Skill-specific** — executable by an agent with 1–2 technical skills.
71
- - **Verifiable** — has explicit acceptance criteria that include at least one
72
- concrete, runnable verification step (a command plus its expected output, or
73
- another observable signal). Never settle for a vague "works correctly".
74
-
75
- Infer skills in kebab-case from the task's technical requirements. Use one
76
- skill for a single-domain task and two for complementary domains, such as
77
- `["api-endpoints", "database"]`. Three or more means the task must be broken
78
- down further.
79
-
80
- ### 6. Test philosophy: "write a few tests, mostly integration"
81
-
82
- **Write tests for:**
83
-
84
- - Custom business logic and algorithms.
85
- - Critical user workflows and data transformations.
86
- - Edge cases and error conditions in core functionality.
87
- - Integration points between components.
88
- - Complex validation or calculation logic.
89
-
90
- **Do not write tests for:**
91
-
92
- - Third-party library and framework functionality.
93
- - Simple CRUD without custom logic.
94
- - Trivial getters/setters and static configuration.
95
- - Obvious functionality that would break immediately if incorrect.
96
-
97
- Combine related test scenarios into one task ("Test user authentication flow",
98
- not separate tasks for login, logout, and validation). Favor integration and
99
- critical-path coverage over per-method unit tests. Never create one test task
100
- per CRUD operation.
101
-
102
- Copy these rules into the "Implementation Notes" of every test task you
103
- generate.
104
-
105
- ### 7. Dependency analysis
106
-
107
- Task B depends on task A when B requires A's output or artifacts, modifies
108
- code created by A, or tests functionality implemented by A. Record it as a
109
- **hard dependency** when B cannot start before A completes and as a **soft
110
- dependency** when B merely runs better after A. Validate that the final
111
- dependency graph is acyclic.
112
-
113
- ### 8. Complexity analysis
114
-
115
- For every candidate task, assign a `complexity_score` (integer 1–10) before
116
- writing any file. Read `references/complexity-rubric.md` before scoring; it
117
- defines the four dimensions each band is judged on. Then apply these rules:
118
-
119
- - Score ≥ 8 → decompose further; do not emit as-is.
120
- - Score 6–7 → sharpen or split; do not emit without an explicit reason.
121
- - Vague acceptance criteria → sharpen them into a concrete, runnable
122
- verification step.
123
- - Trivially small adjacent tasks → merge them.
124
-
125
- **Loop-back rule:** after applying split, sharpen, or merge, re-run dependency
126
- analysis and re-score the adjusted tasks. Repeat no more than three times. If
127
- complexity is still unresolved after three passes, stop and surface the
128
- blocker to the user.
129
-
130
- ### 9. Allocate task IDs
131
-
132
- Run `scripts/get-next-task-id.cjs <plan-id>` once for the first available task
133
- ID, then allocate the rest by incrementing in-process. Use the unpadded
134
- integer in the task frontmatter `id` field and the zero-padded form in the
135
- filename. The slug derives from a short task title: lowercase, alphanumeric
136
- and hyphens only, collapsed, trimmed.
137
-
138
- ### 10. Emit the task files
139
-
140
- Write each task to:
141
-
142
- ```
143
- <root>/plans/<plan-dir-name>/tasks/{padded-id}--{slug}.md
144
- ```
145
-
146
- Each file must conform to `<root>/config/templates/TASK_TEMPLATE.md`. Add
147
- `complexity_notes` only when the score needs justification. Never write
148
- `execution_profile`; the routing helper writes it.
149
-
150
- Fill every body section with task-specific content. Place detailed
151
- implementation guidance inside a `<details>` block under "Implementation
152
- Notes", written so a non-thinking LLM could execute the task from that
153
- section alone.
154
-
155
- ### 11. Validation checklist
156
-
157
- Before declaring task generation complete, verify:
158
-
159
- - Every **explicitly stated** deliverable in the plan is covered by a task.
160
- - No two tasks overlap in purpose.
161
- - Dependencies form an acyclic graph, with no orphan or circular references.
162
- - Groups are consistent across the plan.
163
- - After writing the task files, run
164
- `scripts/validate-plan-blueprint.cjs <plan-id> complexityScoresValid`. Stop
165
- unless it prints `yes`; if it prints `no`, run
166
- `scripts/validate-plan-blueprint.cjs <plan-id> invalidComplexityTasks` to see
167
- which files are missing, non-integer, or out-of-range, fix them, and re-run.
168
-
169
- ### 12. Route task execution
170
-
171
- Read `<root>/config/hooks/TASK_EXECUTION_ROUTING.md` and follow its
172
- instructions together with this procedure:
173
-
174
- 1. Run `scripts/route-task-execution.cjs profiles <plan-id>`. On `no-config`
175
- or `disabled`, routing is off; skip the remaining routing steps and
176
- continue. On `invalid-config`, stop and surface the errors to the user; do
177
- not generate the blueprint.
178
- 2. Assign every task in the plan's `tasks/` directory exactly one configured
179
- profile name. Classify the tasks generated in this run from the content
180
- already in your context. If the plan carried task files from an earlier
181
- generation run, read those files to classify them.
182
- 3. Write the complete task-ID-to-profile mapping as a JSON object to a
183
- temporary file, for example `{"1": "routine", "2": "demanding"}`.
184
- 4. Run `scripts/route-task-execution.cjs apply <plan-id> <mapping-file>`.
185
- Target selection happens later at task dispatch, never during generation.
186
- 5. On `routed`, delete the temporary mapping file and continue. On any failure
187
- result (`invalid-assignments`, `invalid-tasks`, `routing-failure`,
188
- `infrastructure-failure`), stop and surface the JSON errors to the user.
189
- Never continue to blueprint generation with partially routed tasks.
190
-
191
- Never hand-write a concrete execution target into task frontmatter or task
192
- bodies.
193
-
194
- ### 13. Run the POST_TASK_GENERATION_ALL hook
195
-
196
- Read `<root>/config/hooks/POST_TASK_GENERATION_ALL.md` and follow its
197
- instructions, using `<root>/config/templates/BLUEPRINT_TEMPLATE.md` for the
198
- Execution Blueprint structure. Run the hook only after routing succeeded or
199
- reported routing off.
200
-
201
- ## Failure Modes
202
-
203
- - **User declines to clarify a blocking ambiguity.** Mark the affected tasks
204
- with `status: "needs-clarification"` and document the open question in the
205
- task's "Implementation Notes". Do not invent answers.
206
- - **A helper script fails unexpectedly.** Surface stderr to the user and
207
- stop — do not fall back to manual ID allocation or path discovery.
@@ -1,8 +0,0 @@
1
- # Complexity rubric
2
-
3
- | Score | Skill breadth | Acceptance-criteria clarity | Integration surface | Decomposition depth |
4
- | --- | --- | --- | --- | --- |
5
- | 1–3 | One well-known skill | Criteria are concrete and observable | None or a single file/module | No further split possible |
6
- | 4–5 | One primary skill plus a familiar adjacent skill | Criteria are clear with few edge cases | One component or API boundary | Already atomic |
7
- | 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
- | 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 |