@atlashub/smartstack-cli 3.39.0 → 3.41.0

package/templates/skills/ralph-loop/steps/step-05-report.md

@@ -1,175 +1,175 @@
----
-name: step-05-report
-description: Generate final report from prd.json structured data
-next_step: null
----
-
-# Step 5: Generate Report
-
-## YOUR TASK:
-
-Generate a comprehensive feature report using structured data from prd.json.
-
----
-
-## 1. Load Data
-
-```javascript
-const prd = readJSON('.ralph/prd.json');
-const stats = {
-  feature: prd.feature, status: prd.status,
-  iterations_used: prd.config.current_iteration - 1,
-  tasks: {
-    total: prd.tasks.length,
-    completed: prd.tasks.filter(t => t.status === 'completed').length,
-    failed: prd.tasks.filter(t => t.status === 'failed').length,
-    blocked: prd.tasks.filter(t => t.status === 'blocked').length
-  }
-};
-
-// Aggregate files from all tasks (populated by apex during execution)
-const filesCreated = [...new Set(prd.tasks.flatMap(t => t.files_changed?.created || []))];
-const filesModified = [...new Set(prd.tasks.flatMap(t => t.files_changed?.modified || []))];
-const totalDuration = prd.history.reduce((sum, h) => sum + (h.duration_seconds || 0), 0);
-```
-
-### 1b. Multi-Module Aggregation
-
-```javascript
-const queuePath = '.ralph/modules-queue.json';
-let moduleStats = null;
-if (fileExists(queuePath)) {
-  const queue = readJSON(queuePath);
-  moduleStats = { totalModules: queue.totalModules, completedModules: queue.completedModules, modules: [] };
-  for (const mod of queue.modules) {
-    const modPrd = readJSON(mod.prdFile);
-    moduleStats.modules.push({
-      code: mod.code, status: mod.status,
-      tasks: { total: modPrd.tasks.length, completed: modPrd.tasks.filter(t => t.status === 'completed').length, failed: modPrd.tasks.filter(t => t.status === 'failed').length },
-      filesCreated: [...new Set(modPrd.tasks.flatMap(t => t.files_changed?.created || []))].length,
-      commits: [...new Set(modPrd.tasks.filter(t => t.commit_hash).map(t => t.commit_hash))].length
-    });
-  }
-}
-```
-
-### 1c. Test Metrics (from PRD)
-
-> **Note:** Apex already ran tests and recorded results. Source metrics from PRD task data.
-
-```javascript
-const testTasks = prd.tasks.filter(t => t.category === 'test');
-const testsPassed = testTasks.filter(t => t.status === 'completed').length;
-const testsFailed = testTasks.filter(t => t.status === 'failed').length;
-```
-
-## 2. Generate Report
-
-Write to `.ralph/reports/{feature-slug}.md`:
-
-```markdown
-# Feature Report: {feature}
-
-## Summary
-| Field | Value |
-|-------|-------|
-| Status | {status} |
-| Iterations | {iterations_used} / {max} |
-| Branch | {branch} |
-| Duration | {totalDuration}s ({min} min) |
-| Execution | Delegated to /apex |
-
-## Tasks
-| # | Task | Category | Status | Commit |
-|---|------|----------|--------|--------|
-{for each task:}
-| {id} | {description} | {category} | {status_emoji} | {commit_hash} |
-
-**{completed}/{total} completed, {failed} failed, {blocked} blocked**
-
-{if moduleStats:}
-## Modules
-| Module | Status | Tasks | Completed | Failed | Files | Commits |
-|--------|--------|-------|-----------|--------|-------|---------|
-{for each mod:}
-| {code} | {status} | {total} | {completed} | {failed} | {filesCreated} | {commits} |
-
-**{completedModules}/{totalModules} modules completed**
-{end if}
-
-{if prd._sectionSplit?.enabled:}
-## Section Split Execution
-| Phase | Type | Section | Entities | Status |
-|-------|------|---------|----------|--------|
-{for each phase:}
-| {phase} | {type} | {sectionCode || '-'} | {entities.length} | {status} |
-
-{end if}
-
-## Test Metrics
-| Metric | Value |
-|--------|-------|
-| Test Tasks | {testTasks.length} |
-| Passed | {testsPassed} |
-| Failed | {testsFailed} |
-
-## Failed Tasks
-{table of failed tasks with error messages, or "None"}
-
-## Files
-- Created: {filesCreated.length}
-- Modified: {filesModified.length}
-
-## Commits
-{unique commits list}
-
----
-*Auto-generated by Ralph Loop — SmartStack CLI*
-```
-
-## 3. Finalize
-
-```javascript
-// Clean up section-split temporary files
-if (prd._sectionSplit?.enabled) {
-  for (const phase of prd._sectionSplit.phases) {
-    if (fileExists(phase.prdFile) && phase.prdFile !== '.ralph/prd.json') {
-      deleteFile(phase.prdFile);
-    }
-  }
-  delete prd._sectionSplit;
-}
-
-prd.updated_at = new Date().toISOString();
-writeJSON('.ralph/prd.json', prd);
-```
-
-## 4. Display Summary
-
-```
-RALPH LOOP COMPLETE
-Feature: {feature} | Status: {status}
-Iterations: {n} | Tasks: {completed}/{total}
-{moduleStats ? `Modules: ${completedModules}/${totalModules}` : ""}
-Files: {created} created, {modified} modified
-Report: .ralph/reports/{slug}.md
-```
-
-## 5. Completion Promise (if applicable)
-
-```
-<promise>{completion_promise}</promise>
-```
-
-## 6. Next Steps
-
-```
-1. Review report: .ralph/reports/{slug}.md
-2. Run full test suite: dotnet test
-3. Create PR: /gitflow pr
-4. Clean up: rm -rf .ralph/ (optional)
-```
-
----
-
-Ralph loop complete. No more steps.
+---
+name: step-05-report
+description: Generate final report from prd.json structured data
+next_step: null
+---
+
+# Step 5: Generate Report
+
+## YOUR TASK:
+
+Generate a comprehensive feature report using structured data from prd.json.
+
+---
+
+## 1. Load Data
+
+```javascript
+const prd = readJSON('.ralph/prd.json');
+const stats = {
+  feature: prd.feature, status: prd.status,
+  iterations_used: prd.config.current_iteration - 1,
+  tasks: {
+    total: prd.tasks.length,
+    completed: prd.tasks.filter(t => t.status === 'completed').length,
+    failed: prd.tasks.filter(t => t.status === 'failed').length,
+    blocked: prd.tasks.filter(t => t.status === 'blocked').length
+  }
+};
+
+// Aggregate files from all tasks (populated by apex during execution)
+const filesCreated = [...new Set(prd.tasks.flatMap(t => t.files_changed?.created || []))];
+const filesModified = [...new Set(prd.tasks.flatMap(t => t.files_changed?.modified || []))];
+const totalDuration = prd.history.reduce((sum, h) => sum + (h.duration_seconds || 0), 0);
+```
+
+### 1b. Multi-Module Aggregation
+
+```javascript
+const queuePath = '.ralph/modules-queue.json';
+let moduleStats = null;
+if (fileExists(queuePath)) {
+  const queue = readJSON(queuePath);
+  moduleStats = { totalModules: queue.totalModules, completedModules: queue.completedModules, modules: [] };
+  for (const mod of queue.modules) {
+    const modPrd = readJSON(mod.prdFile);
+    moduleStats.modules.push({
+      code: mod.code, status: mod.status,
+      tasks: { total: modPrd.tasks.length, completed: modPrd.tasks.filter(t => t.status === 'completed').length, failed: modPrd.tasks.filter(t => t.status === 'failed').length },
+      filesCreated: [...new Set(modPrd.tasks.flatMap(t => t.files_changed?.created || []))].length,
+      commits: [...new Set(modPrd.tasks.filter(t => t.commit_hash).map(t => t.commit_hash))].length
+    });
+  }
+}
+```
+
+### 1c. Test Metrics (from PRD)
+
+> **Note:** Apex already ran tests and recorded results. Source metrics from PRD task data.
+
+```javascript
+const testTasks = prd.tasks.filter(t => t.category === 'test');
+const testsPassed = testTasks.filter(t => t.status === 'completed').length;
+const testsFailed = testTasks.filter(t => t.status === 'failed').length;
+```
+
+## 2. Generate Report
+
+Write to `.ralph/reports/{feature-slug}.md`:
+
+```markdown
+# Feature Report: {feature}
+
+## Summary
+| Field | Value |
+|-------|-------|
+| Status | {status} |
+| Iterations | {iterations_used} / {max} |
+| Branch | {branch} |
+| Duration | {totalDuration}s ({min} min) |
+| Execution | Delegated to /apex |
+
+## Tasks
+| # | Task | Category | Status | Commit |
+|---|------|----------|--------|--------|
+{for each task:}
+| {id} | {description} | {category} | {status_emoji} | {commit_hash} |
+
+**{completed}/{total} completed, {failed} failed, {blocked} blocked**
+
+{if moduleStats:}
+## Modules
+| Module | Status | Tasks | Completed | Failed | Files | Commits |
+|--------|--------|-------|-----------|--------|-------|---------|
+{for each mod:}
+| {code} | {status} | {total} | {completed} | {failed} | {filesCreated} | {commits} |
+
+**{completedModules}/{totalModules} modules completed**
+{end if}
+
+{if prd._sectionSplit?.enabled:}
+## Section Split Execution
+| Phase | Type | Section | Entities | Status |
+|-------|------|---------|----------|--------|
+{for each phase:}
+| {phase} | {type} | {sectionCode || '-'} | {entities.length} | {status} |
+
+{end if}
+
+## Test Metrics
+| Metric | Value |
+|--------|-------|
+| Test Tasks | {testTasks.length} |
+| Passed | {testsPassed} |
+| Failed | {testsFailed} |
+
+## Failed Tasks
+{table of failed tasks with error messages, or "None"}
+
+## Files
+- Created: {filesCreated.length}
+- Modified: {filesModified.length}
+
+## Commits
+{unique commits list}
+
+---
+*Auto-generated by Ralph Loop — SmartStack CLI*
+```
+
+## 3. Finalize
+
+```javascript
+// Clean up section-split temporary files
+if (prd._sectionSplit?.enabled) {
+  for (const phase of prd._sectionSplit.phases) {
+    if (fileExists(phase.prdFile) && phase.prdFile !== '.ralph/prd.json') {
+      deleteFile(phase.prdFile);
+    }
+  }
+  delete prd._sectionSplit;
+}
+
+prd.updated_at = new Date().toISOString();
+writeJSON('.ralph/prd.json', prd);
+```
+
+## 4. Display Summary
+
+```
+RALPH LOOP COMPLETE
+Feature: {feature} | Status: {status}
+Iterations: {n} | Tasks: {completed}/{total}
+{moduleStats ? `Modules: ${completedModules}/${totalModules}` : ""}
+Files: {created} created, {modified} modified
+Report: .ralph/reports/{slug}.md
+```
+
+## 5. Completion Promise (if applicable)
+
+```
+<promise>{completion_promise}</promise>
+```
+
+## 6. Next Steps
+
+```
+1. Review report: .ralph/reports/{slug}.md
+2. Run full test suite: dotnet test
+3. Create PR: /gitflow pr
+4. Clean up: rm -rf .ralph/ (optional)
+```
+
+---
+
+Ralph loop complete. No more steps.

package/templates/skills/refactor/SKILL.md

@@ -1,56 +1,56 @@
----
-name: refactor
-description: Refactor code by finding files, grouping them, and launching parallel Snipper agents
-argument-hint: <search-pattern-or-description>
-disable-model-invocation: true
----
-
-<objective>
-Refactor code matching the given pattern across the codebase using parallel Snipper agents for maximum speed.
-
-This skill finds all relevant files, creates ONE instruction file, then launches Snipper agents in parallel with batches of max 3 files each.
-</objective>
-
-<quick_start>
-```bash
-/refactor rename getUserData to fetchUserProfile
-/refactor replace console.log with logger.info
-/refactor convert class components to functional
-/refactor update deprecated API calls
-```
-</quick_start>
-
-<workflow>
-
-## Phase 1: Discovery
-1. Parse the refactor request (method name, pattern, code smell)
-2. Find all affected files (Grep for code, Glob for file patterns)
-3. Analyze scope — if >15 files, confirm with user
-
-See [steps/step-01-discover.md](steps/step-01-discover.md) for search strategy and instruction file template.
-
-## Phase 2: Create Instructions
-4. Create task folder: `.claude/tasks/refactor-{timestamp}/`
-5. Create ONE `instructions.md` with: Objective, Pattern, Transformation, Examples, Constraints
-
-## Phase 3: Group and Execute
-6. Group files into batches (max 3 per batch)
-7. Launch ALL Snipper agents in parallel (single message, multiple Task calls)
-8. Wait for completion
-
-## Phase 4: Verification
-9. Validate changes (lint/typecheck/build)
-10. Provide summary report
-
-See [steps/step-02-execute.md](steps/step-02-execute.md) for execution details and report format.
-
-</workflow>
-
-<success_criteria>
-- All target files identified
-- ONE instruction file created in `.claude/tasks/refactor-{id}/instructions.md`
-- Snipper agents launched in parallel (max 3 files per agent)
-- All batches completed successfully
-- Lint/type checks pass
-- Summary provided to user
-</success_criteria>
+---
+name: refactor
+description: Refactor code by finding files, grouping them, and launching parallel Snipper agents
+argument-hint: <search-pattern-or-description>
+disable-model-invocation: true
+---
+
+<objective>
+Refactor code matching the given pattern across the codebase using parallel Snipper agents for maximum speed.
+
+This skill finds all relevant files, creates ONE instruction file, then launches Snipper agents in parallel with batches of max 3 files each.
+</objective>
+
+<quick_start>
+```bash
+/refactor rename getUserData to fetchUserProfile
+/refactor replace console.log with logger.info
+/refactor convert class components to functional
+/refactor update deprecated API calls
+```
+</quick_start>
+
+<workflow>
+
+## Phase 1: Discovery
+1. Parse the refactor request (method name, pattern, code smell)
+2. Find all affected files (Grep for code, Glob for file patterns)
+3. Analyze scope — if >15 files, confirm with user
+
+See [steps/step-01-discover.md](steps/step-01-discover.md) for search strategy and instruction file template.
+
+## Phase 2: Create Instructions
+4. Create task folder: `.claude/tasks/refactor-{timestamp}/`
+5. Create ONE `instructions.md` with: Objective, Pattern, Transformation, Examples, Constraints
+
+## Phase 3: Group and Execute
+6. Group files into batches (max 3 per batch)
+7. Launch ALL Snipper agents in parallel (single message, multiple Task calls)
+8. Wait for completion
+
+## Phase 4: Verification
+9. Validate changes (lint/typecheck/build)
+10. Provide summary report
+
+See [steps/step-02-execute.md](steps/step-02-execute.md) for execution details and report format.
+
+</workflow>
+
+<success_criteria>
+- All target files identified
+- ONE instruction file created in `.claude/tasks/refactor-{id}/instructions.md`
+- Snipper agents launched in parallel (max 3 files per agent)
+- All batches completed successfully
+- Lint/type checks pass
+- Summary provided to user
+</success_criteria>

package/templates/skills/refactor/steps/step-01-discover.md

@@ -1,60 +1,60 @@
-# Phase 1: Discovery & Instructions
-
-## 1. Parse the Refactor Request
-
-Understand what the pattern means:
-- Could be: method name, component name, pattern, code smell, etc.
-- Identify the search strategy (Grep for code patterns, Glob for file patterns)
-
-## 2. Find All Affected Files
-
-```
-Use Grep to search for the pattern in the codebase
-Use Glob if searching by file name patterns
-Exclude: node_modules, .git, dist, build, bin, obj
-```
-
-## 3. Analyze Scope
-
-- Count total files found
-- If more than 15 files, ask user to confirm or narrow scope
-- Show preview of files to refactor
-
-## 4. Create Task Folder
-
-```
-Generate unique ID: refactor-{timestamp}
-Create folder: .claude/tasks/refactor-{timestamp}/
-```
-
-## 5. Create ONE Instruction File
-
-Create `.claude/tasks/refactor-{id}/instructions.md`:
-
-```markdown
-# Refactor: {title}
-
-## Objective
-{What needs to be refactored - derived from user request}
-
-## Pattern to Find
-{Exact code pattern, method name, or structure to locate}
-
-## Transformation
-{How to transform the found pattern - be specific and adaptive}
-
-## Examples
-Before:
-{example of current code}
-
-After:
-{example of refactored code}
-
-## Constraints
-- Only modify code matching the pattern
-- Preserve all existing functionality
-- Follow codebase conventions
-- No comments unless necessary
-```
-
-**IMPORTANT**: Make instructions adaptive - they should work for ANY file in the list.
+# Phase 1: Discovery & Instructions
+
+## 1. Parse the Refactor Request
+
+Understand what the pattern means:
+- Could be: method name, component name, pattern, code smell, etc.
+- Identify the search strategy (Grep for code patterns, Glob for file patterns)
+
+## 2. Find All Affected Files
+
+```
+Use Grep to search for the pattern in the codebase
+Use Glob if searching by file name patterns
+Exclude: node_modules, .git, dist, build, bin, obj
+```
+
+## 3. Analyze Scope
+
+- Count total files found
+- If more than 15 files, ask user to confirm or narrow scope
+- Show preview of files to refactor
+
+## 4. Create Task Folder
+
+```
+Generate unique ID: refactor-{timestamp}
+Create folder: .claude/tasks/refactor-{timestamp}/
+```
+
+## 5. Create ONE Instruction File
+
+Create `.claude/tasks/refactor-{id}/instructions.md`:
+
+```markdown
+# Refactor: {title}
+
+## Objective
+{What needs to be refactored - derived from user request}
+
+## Pattern to Find
+{Exact code pattern, method name, or structure to locate}
+
+## Transformation
+{How to transform the found pattern - be specific and adaptive}
+
+## Examples
+Before:
+{example of current code}
+
+After:
+{example of refactored code}
+
+## Constraints
+- Only modify code matching the pattern
+- Preserve all existing functionality
+- Follow codebase conventions
+- No comments unless necessary
+```
+
+**IMPORTANT**: Make instructions adaptive - they should work for ANY file in the list.