aiblueprint-cli 1.4.42 → 1.4.44

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 (25) hide show
  1. package/claude-code-config/skills/apex/SKILL.md +229 -84
  2. package/claude-code-config/skills/apex/scripts/setup-templates.sh +6 -50
  3. package/claude-code-config/skills/apex/steps/step-00-init.md +33 -39
  4. package/claude-code-config/skills/apex/steps/step-00b-interactive.md +1 -13
  5. package/claude-code-config/skills/apex/steps/step-01-analyze.md +17 -36
  6. package/claude-code-config/skills/apex/steps/step-02-plan.md +24 -353
  7. package/claude-code-config/skills/apex/steps/step-03-execute.md +0 -1
  8. package/claude-code-config/skills/apex/steps/step-04-validate.md +26 -41
  9. package/claude-code-config/skills/apex/templates/00-context.md +0 -10
  10. package/claude-code-config/skills/apex/templates/README.md +6 -25
  11. package/dist/cli.js +27 -1
  12. package/package.json +1 -1
  13. package/claude-code-config/skills/apex/steps/step-00b-save.md +0 -123
  14. package/claude-code-config/skills/apex/steps/step-02b-tasks.md +0 -301
  15. package/claude-code-config/skills/apex/steps/step-03-execute-teams.md +0 -296
  16. package/claude-code-config/skills/apex/steps/step-05-examine.md +0 -351
  17. package/claude-code-config/skills/apex/steps/step-06-resolve.md +0 -238
  18. package/claude-code-config/skills/apex/steps/step-07-tests.md +0 -250
  19. package/claude-code-config/skills/apex/steps/step-08-run-tests.md +0 -308
  20. package/claude-code-config/skills/apex/steps/step-09-finish.md +0 -223
  21. package/claude-code-config/skills/apex/templates/05-examine.md +0 -10
  22. package/claude-code-config/skills/apex/templates/06-resolve.md +0 -10
  23. package/claude-code-config/skills/apex/templates/07-tests.md +0 -10
  24. package/claude-code-config/skills/apex/templates/08-run-tests.md +0 -10
  25. package/claude-code-config/skills/apex/templates/09-finish.md +0 -10
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: step-04-validate
3
- description: Self-check - run tests, verify AC, audit implementation quality
3
+ description: Self-check - run tests, verify AC, audit implementation quality, complete workflow
4
4
  prev_step: steps/step-03-execute.md
5
- next_step: steps/step-05-examine.md
5
+ next_step: null
6
6
  ---
7
7
 
8
8
  # Step 4: Validate (Self-Check)
@@ -27,11 +27,10 @@ next_step: steps/step-05-examine.md
27
27
 
28
28
  ## CONTEXT BOUNDARIES:
29
29
 
30
- - Implementation from step-03 (or step-03-execute-teams) is complete
30
+ - Implementation from step-03 is complete
31
31
  - Tests may or may not pass yet
32
32
  - Type errors may exist
33
33
  - Focus is on verification, not new implementation
34
- - **If `{teams_mode}` = true:** The agent team is still alive. Do NOT shutdown or dismiss teammates. Team shutdown happens in step-09-finish only.
35
34
 
36
35
  ## YOUR TASK:
37
36
 
@@ -49,8 +48,7 @@ From previous steps:
49
48
  | `{acceptance_criteria}` | Success criteria |
50
49
  | `{auto_mode}` | Skip confirmations |
51
50
  | `{save_mode}` | Save outputs to files |
52
- | `{test_mode}` | Include test steps |
53
- | `{examine_mode}` | Auto-proceed to review |
51
+ | `{economy_mode}` | No subagents mode |
54
52
  | `{output_dir}` | Path to output (if save_mode) |
55
53
  | Implementation | Completed in step-03 |
56
54
  </available_state>
@@ -172,38 +170,28 @@ Both MUST pass.
172
170
  **Summary:** All checks passing, ready for next step.
173
171
  ```
174
172
 
175
- ### 8. Determine Next Step
173
+ ### 8. Complete Workflow
176
174
 
177
- **Decision tree:**
175
+ **Show final summary:**
178
176
 
179
177
  ```
180
- IF {test_mode} = true:
181
- → Load step-07-tests.md (test analysis and creation)
178
+ APEX Workflow Complete
182
179
 
183
- ELSE IF {examine_mode} = true:
184
- Load step-05-examine.md (adversarial review)
180
+ **Task:** {task_description}
181
+ **Task ID:** {task_id}
185
182
 
186
- ELSE IF {auto_mode} = false:
187
- Ask user:
188
- ```
183
+ **Validation Results:**
184
+ - Typecheck: ✓ Passed
185
+ - Lint: ✓ Passed
186
+ - Tests: ✓ Passed
189
187
 
190
- ```yaml
191
- questions:
192
- - header: "Next"
193
- question: "Validation complete. What would you like to do?"
194
- options:
195
- - label: "Run adversarial review"
196
- description: "Deep review for security, logic, and quality"
197
- - label: "Complete workflow"
198
- description: "Skip review and finalize"
199
- - label: "Add tests"
200
- description: "Create additional tests first"
201
- multiSelect: false
202
- ```
188
+ **Acceptance Criteria:**
189
+ - [✓] AC1: Verified
190
+ - [✓] AC2: Verified
203
191
 
204
- ```
205
- ELSE:
206
- Complete workflow (show final summary)
192
+ **Files Modified:** {list}
193
+
194
+ 🎉 Implementation complete and validated!
207
195
  ```
208
196
 
209
197
  ### 9. Complete Save Output (if save_mode)
@@ -218,10 +206,12 @@ Append to `{output_dir}/04-validate.md`:
218
206
  **Typecheck:** ✓
219
207
  **Lint:** ✓
220
208
  **Tests:** ✓
221
- **Next:** {next step based on flags}
209
+ **Workflow:** Complete
222
210
  **Timestamp:** {ISO timestamp}
223
211
  ```
224
212
 
213
+ Run: `bash {skill_dir}/scripts/update-progress.sh "{task_id}" "04" "validate" "complete"`
214
+
225
215
  ---
226
216
 
227
217
  ## SUCCESS METRICS:
@@ -232,6 +222,7 @@ Append to `{output_dir}/04-validate.md`:
232
222
  ✅ All AC verified
233
223
  ✅ Code formatted
234
224
  ✅ User informed of status
225
+ ✅ Workflow completed
235
226
 
236
227
  ## FAILURE MODES:
237
228
 
@@ -240,7 +231,6 @@ Append to `{output_dir}/04-validate.md`:
240
231
  ❌ Skipping tests for modified code
241
232
  ❌ Missing AC verification
242
233
  ❌ Proceeding with failures
243
- ❌ **CRITICAL**: Not using AskUserQuestion for next step
244
234
 
245
235
  ## VALIDATION PROTOCOLS:
246
236
 
@@ -252,15 +242,10 @@ Append to `{output_dir}/04-validate.md`:
252
242
 
253
243
  ---
254
244
 
255
- ## NEXT STEP:
245
+ ## WORKFLOW COMPLETE
256
246
 
257
- Based on flags (check in order):
258
- - **If test_mode:** Load `./step-07-tests.md`
259
- - **If examine_mode OR user requests:** Load `./step-05-examine.md`
260
- - **If pr_mode:** Load `./step-09-finish.md` to create pull request
261
- - **Otherwise:** Workflow complete - show summary
247
+ This is the final step. After validation passes, the APEX workflow is complete.
262
248
 
263
249
  <critical>
264
- Remember: NEVER proceed with failing checks - fix everything first!
265
- If teams_mode is active: NEVER shutdown teammates — they stay alive until step-09-finish!
250
+ Remember: NEVER claim completion with failing checks - fix everything first!
266
251
  </critical>
@@ -10,14 +10,10 @@
10
10
  | Flag | Value |
11
11
  |------|-------|
12
12
  | Auto mode (`-a`) | {{auto_mode}} |
13
- | Examine mode (`-x`) | {{examine_mode}} |
14
13
  | Save mode (`-s`) | {{save_mode}} |
15
- | Test mode (`-t`) | {{test_mode}} |
16
14
  | Economy mode (`-e`) | {{economy_mode}} |
17
15
  | Branch mode (`-b`) | {{branch_mode}} |
18
- | PR mode (`-pr`) | {{pr_mode}} |
19
16
  | Interactive mode (`-i`) | {{interactive_mode}} |
20
- | Tasks mode (`-k`) | {{tasks_mode}} |
21
17
  | Branch name | {{branch_name}} |
22
18
 
23
19
  ---
@@ -43,11 +39,5 @@ _To be defined in step-01-analyze.md_
43
39
  | 00-init | ⏸ Pending | |
44
40
  | 01-analyze | ⏸ Pending | |
45
41
  | 02-plan | ⏸ Pending | |
46
- | 02b-tasks | {{tasks_status}} | |
47
42
  | 03-execute | ⏸ Pending | |
48
43
  | 04-validate | ⏸ Pending | |
49
- | 05-examine | {{examine_status}} | |
50
- | 06-resolve | {{examine_status}} | |
51
- | 07-tests | {{test_status}} | |
52
- | 08-run-tests | {{test_status}} | |
53
- | 09-finish | {{pr_status}} | |
@@ -12,12 +12,7 @@ This directory contains template files used to initialize APEX workflow outputs
12
12
  | `01-analyze.md` | Analysis findings | Always (if save_mode) |
13
13
  | `02-plan.md` | Implementation plan | Always (if save_mode) |
14
14
  | `03-execute.md` | Implementation log | Always (if save_mode) |
15
- | `04-validate.md` | Validation results | Always (if save_mode) |
16
- | `05-examine.md` | Adversarial review findings | Only if examine_mode enabled |
17
- | `06-resolve.md` | Finding resolution log | Only if examine_mode enabled |
18
- | `07-tests.md` | Test analysis and creation | Only if test_mode enabled |
19
- | `08-run-tests.md` | Test runner log | Only if test_mode enabled |
20
- | `09-finish.md` | PR creation log | Only if pr_mode enabled |
15
+ | `04-validate.md` | Validation results and workflow completion | Always (if save_mode) |
21
16
  | `step-complete.md` | Completion marker template | Referenced in steps |
22
17
 
23
18
  ## Template Variables
@@ -30,18 +25,12 @@ Templates use `{{variable}}` syntax for placeholders:
30
25
  | `{{task_description}}` | Plain text task description | `add authentication middleware` |
31
26
  | `{{timestamp}}` | ISO 8601 timestamp | `2026-01-12T10:30:00Z` |
32
27
  | `{{auto_mode}}` | Auto mode flag | `true` or `false` |
33
- | `{{examine_mode}}` | Examine mode flag | `true` or `false` |
34
28
  | `{{save_mode}}` | Save mode flag | `true` or `false` |
35
- | `{{test_mode}}` | Test mode flag | `true` or `false` |
36
29
  | `{{economy_mode}}` | Economy mode flag | `true` or `false` |
37
30
  | `{{branch_mode}}` | Branch mode flag | `true` or `false` |
38
- | `{{pr_mode}}` | PR mode flag | `true` or `false` |
39
31
  | `{{interactive_mode}}` | Interactive mode flag | `true` or `false` |
40
32
  | `{{branch_name}}` | Git branch name | `feature/add-auth` |
41
33
  | `{{original_input}}` | Raw user input | `/apex -a -s add auth` |
42
- | `{{examine_status}}` | Progress status for examine steps | `⏸ Pending` or `⏭ Skip` |
43
- | `{{test_status}}` | Progress status for test steps | `⏸ Pending` or `⏭ Skip` |
44
- | `{{pr_status}}` | Progress status for PR step | `⏸ Pending` or `⏭ Skip` |
45
34
 
46
35
  ## Setup Script
47
36
 
@@ -52,15 +41,12 @@ Initializes all template files in the output directory with variables replaced.
52
41
  **Usage:**
53
42
  ```bash
54
43
  bash scripts/setup-templates.sh \
55
- "task_id" \
44
+ "feature_name" \
56
45
  "task_description" \
57
46
  "auto_mode" \
58
- "examine_mode" \
59
47
  "save_mode" \
60
- "test_mode" \
61
48
  "economy_mode" \
62
49
  "branch_mode" \
63
- "pr_mode" \
64
50
  "interactive_mode" \
65
51
  "branch_name" \
66
52
  "original_input"
@@ -73,12 +59,7 @@ bash scripts/setup-templates.sh \
73
59
  ├── 01-analyze.md # Always created
74
60
  ├── 02-plan.md # Always created
75
61
  ├── 03-execute.md # Always created
76
- ├── 04-validate.md # Always created
77
- ├── 05-examine.md # Only if examine_mode
78
- ├── 06-resolve.md # Only if examine_mode
79
- ├── 07-tests.md # Only if test_mode
80
- ├── 08-run-tests.md # Only if test_mode
81
- └── 09-finish.md # Only if pr_mode
62
+ └── 04-validate.md # Always created
82
63
  ```
83
64
 
84
65
  ## Progress Update Script
@@ -137,7 +118,7 @@ Update `00-context.md` progress:
137
118
  ```
138
119
  ```
139
120
 
140
- **Token cost per step:** ~200 tokens × 9 steps = ~1,800 tokens
121
+ **Token cost per step:** ~200 tokens × 5 steps = ~1,000 tokens
141
122
 
142
123
  ### After Optimization
143
124
 
@@ -158,9 +139,9 @@ bash {skill_dir}/scripts/update-progress.sh "{task_id}" "01" "analyze" "in_progr
158
139
  Append your findings to `01-analyze.md` as you work.
159
140
  ```
160
141
 
161
- **Token cost per step:** ~50 tokens × 9 steps = ~450 tokens
142
+ **Token cost per step:** ~50 tokens × 5 steps = ~250 tokens
162
143
 
163
- **Total savings:** ~1,350 tokens per workflow execution (75% reduction)
144
+ **Total savings:** ~750 tokens per workflow execution (75% reduction)
164
145
 
165
146
  ## How It Works
166
147
 
package/dist/cli.js CHANGED
@@ -33294,6 +33294,26 @@ async function updateSettings(options, claudeDir) {
33294
33294
  };
33295
33295
  }
33296
33296
  }
33297
+ if (!settings.permissions) {
33298
+ settings.permissions = {};
33299
+ }
33300
+ settings.permissions.defaultMode = "bypassPermissions";
33301
+ if (!settings.permissions.deny) {
33302
+ settings.permissions.deny = [];
33303
+ }
33304
+ const denyRules = [
33305
+ "Bash(rm -rf *)",
33306
+ "Bash(sudo *)",
33307
+ "Bash(curl * | bash)",
33308
+ "Bash(wget * | bash)",
33309
+ "Read(./.env)",
33310
+ "Read(./.env.*)"
33311
+ ];
33312
+ for (const rule of denyRules) {
33313
+ if (!settings.permissions.deny.includes(rule)) {
33314
+ settings.permissions.deny.push(rule);
33315
+ }
33316
+ }
33297
33317
  if (!settings.hooks) {
33298
33318
  settings.hooks = {};
33299
33319
  }
@@ -33512,6 +33532,7 @@ async function setupCommand(params = {}) {
33512
33532
  "customStatusline",
33513
33533
  "aiblueprintCommands",
33514
33534
  "aiblueprintAgents",
33535
+ "aiblueprintSkills",
33515
33536
  "notificationSounds",
33516
33537
  "codexSymlink",
33517
33538
  "openCodeSymlink"
@@ -33554,6 +33575,11 @@ async function setupCommand(params = {}) {
33554
33575
  name: "Notification sounds - Audio alerts for events",
33555
33576
  checked: true
33556
33577
  },
33578
+ {
33579
+ value: "aiblueprintSkills",
33580
+ name: "AIBlueprint skills - Pre-built skills (apex, commit, oneshot, etc.)",
33581
+ checked: true
33582
+ },
33557
33583
  {
33558
33584
  value: "codexSymlink",
33559
33585
  name: "Codex symlink - Link commands to ~/.codex/prompts",
@@ -33579,7 +33605,7 @@ async function setupCommand(params = {}) {
33579
33605
  customStatusline: features.includes("customStatusline"),
33580
33606
  aiblueprintCommands: features.includes("aiblueprintCommands"),
33581
33607
  aiblueprintAgents: features.includes("aiblueprintAgents"),
33582
- aiblueprintSkills: false,
33608
+ aiblueprintSkills: features.includes("aiblueprintSkills"),
33583
33609
  notificationSounds: features.includes("notificationSounds"),
33584
33610
  codexSymlink: features.includes("codexSymlink"),
33585
33611
  openCodeSymlink: features.includes("openCodeSymlink"),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aiblueprint-cli",
3
- "version": "1.4.42",
3
+ "version": "1.4.44",
4
4
  "description": "AIBlueprint CLI for setting up Claude Code configurations",
5
5
  "author": "AIBlueprint",
6
6
  "license": "MIT",
@@ -1,123 +0,0 @@
1
- ---
2
- name: step-00b-save
3
- description: Setup save output structure for APEX workflow
4
- returns_to: step-00-init.md
5
- ---
6
-
7
- # Step 0b: Save Mode Setup
8
-
9
- ## MANDATORY EXECUTION RULES (READ FIRST):
10
-
11
- - 🛑 NEVER start analysis or implementation
12
- - ✅ ALWAYS run the setup script to create output structure
13
- - ✅ ALWAYS capture the generated `{task_id}` from the script output
14
- - 📋 YOU ARE A SETUP MANAGER, not an implementer
15
- - 🚫 FORBIDDEN to start any analysis work
16
-
17
- ## CONTEXT BOUNDARIES:
18
-
19
- - Variables available: `{feature_name}`, `{task_description}`, all flag variables, `{branch_name}`
20
- - This sub-step sets: `{task_id}`, `{output_dir}`
21
- - Return to step-00-init.md after completion
22
-
23
- ## YOUR TASK:
24
-
25
- Create the output directory structure and initialize all output files for the APEX workflow.
26
-
27
- ---
28
-
29
- ## OUTPUT STRUCTURE:
30
-
31
- When save_mode is enabled, all outputs go to the PROJECT directory:
32
-
33
- ```
34
- .claude/output/apex/{task-id}/
35
- ├── 00-context.md # Params, user request, timestamp
36
- ├── 01-analyze.md # Analysis findings
37
- ├── 02-plan.md # Implementation plan
38
- ├── 03-execute.md # Execution log
39
- ├── 04-validate.md # Validation results
40
- ├── 02b-tasks/ # Task breakdown (if -k or -m)
41
- │ ├── README.md
42
- │ └── task-NN-*.md
43
- ├── 05-examine.md # Review findings (if -x)
44
- ├── 06-resolve.md # Resolution log (if -x)
45
- ├── 07-tests.md # Test analysis (if -t)
46
- ├── 08-run-tests.md # Test runner log (if -t)
47
- └── 09-finish.md # PR creation (if -pr)
48
- ```
49
-
50
- ## EXECUTION SEQUENCE:
51
-
52
- ### 1. Run Template Setup Script
53
-
54
- ```bash
55
- bash {skill_dir}/scripts/setup-templates.sh \
56
- "{feature_name}" \
57
- "{task_description}" \
58
- "{auto_mode}" \
59
- "{examine_mode}" \
60
- "{save_mode}" \
61
- "{test_mode}" \
62
- "{economy_mode}" \
63
- "{branch_mode}" \
64
- "{pr_mode}" \
65
- "{interactive_mode}" \
66
- "{tasks_mode}" \
67
- "{branch_name}" \
68
- "{original_input}"
69
- ```
70
-
71
- **Note:** Pass `{feature_name}` (without number prefix), NOT `{task_id}`.
72
-
73
- The script:
74
- - Auto-generates `{task_id}` = `NN-{feature_name}` (next available number)
75
- - Creates `.claude/output/apex/{task_id}/` directory
76
- - Initializes `00-context.md` with configuration and progress table
77
- - Pre-creates all step files from templates
78
- - Only creates files for enabled steps (examine, tests, PR)
79
- - Outputs the generated `{task_id}`
80
-
81
- ### 2. Capture Output Variables
82
-
83
- From the script output, set:
84
- - `{task_id}` = the generated ID (e.g., `01-add-auth-middleware`)
85
- - `{output_dir}` = `.claude/output/apex/{task_id}`
86
-
87
- ### 3. Return
88
-
89
- → Return to step-00-init.md with `{task_id}` and `{output_dir}` set
90
-
91
- ---
92
-
93
- ## SAVE OUTPUT PATTERN (for all subsequent steps):
94
-
95
- Each step uses this pattern:
96
-
97
- 1. `bash {skill_dir}/scripts/update-progress.sh "{task_id}" "{step_num}" "{step_name}" "in_progress"`
98
- 2. Append findings/outputs to the pre-created step file
99
- 3. `bash {skill_dir}/scripts/update-progress.sh "{task_id}" "{step_num}" "{step_name}" "complete"`
100
-
101
- ---
102
-
103
- ## SUCCESS METRICS:
104
-
105
- ✅ Output directory created
106
- ✅ `{task_id}` generated and captured
107
- ✅ `{output_dir}` set
108
- ✅ All template files initialized
109
-
110
- ## FAILURE MODES:
111
-
112
- ❌ Not capturing `{task_id}` from script output
113
- ❌ Starting analysis before returning
114
-
115
- ---
116
-
117
- ## RETURN:
118
-
119
- After setup complete, return to `./step-00-init.md` to continue initialization.
120
-
121
- <critical>
122
- Remember: This sub-step ONLY creates the output structure. Return immediately after setting {task_id} and {output_dir}.
123
- </critical>