godpowers 2.3.1 → 2.4.1

package/lib/workflow-runner.js

@@ -31,6 +31,7 @@ const path = require('path');
 const parser = require('./workflow-parser');
 const asyncFs = require('./fs-async');
 const agentRefs = require('./agent-refs');
+const helperGroups = require('./workflow-helper-groups');
 
 /**
  * @typedef {Object} WorkflowPlanStep
@@ -134,7 +135,8 @@ function plan(workflow, ctx = {}) {
         review: job.review || null,
         'on-pass': job['on-pass'] || null,
         'on-fail': job['on-fail'] || null,
-        localHelpers: job['local-helpers'] || [],
+        localHelperGroups: job['local-helper-groups'] || [],
+        localHelpers: helperGroups.expand(job['local-helper-groups'] || [], job['local-helpers'] || []),
         with: job.with || null
       });
     }
@@ -221,6 +223,9 @@ function serializePlan(p) {
       if (step.tier) lines.push(`        tier: ${step.tier}`);
       if (step.agent) lines.push(`        agent: ${step.agent}`);
       if (step.uses)  lines.push(`        uses: ${step.uses}`);
+      if (step.localHelperGroups && step.localHelperGroups.length) {
+        lines.push(`        local-helper-groups: [${step.localHelperGroups.join(', ')}]`);
+      }
       if (step.localHelpers && step.localHelpers.length) {
         lines.push(`        local-helpers: [${step.localHelpers.join(', ')}]`);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godpowers",
-  "version": "2.3.1",
+  "version": "2.4.1",
   "description": "AI-powered development system: 112 slash commands and 40 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
   "bin": {
     "godpowers": "./bin/install.js"

package/routing/god-add-backlog.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-add-backlog
   description: Add idea to backlog (less urgent than todo)
   tier: 0
+  family: capture
 
 prerequisites:
   required: []

package/routing/god-add-tests.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-add-tests
   description: Add tests to legacy code
   tier: 0
+  family: build
 
 prerequisites:
   required:

package/routing/god-add-todo.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-add-todo
   description: Capture a todo from current context
   tier: 0
+  family: capture
 
 prerequisites:
   required: []

package/routing/god-agent-audit.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-agent-audit
   description: Validate agents/*.md against agent contract
   tier: 0
+  family: verify
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-arch.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-arch
   description: Design system architecture
   tier: 1
+  family: start
 
 prerequisites:
   required:

package/routing/god-archaeology.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-archaeology
   description: Deep brownfield code archaeology
   tier: 0
+  family: start
 
 prerequisites:
   required: []

package/routing/god-audit.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-audit
   description: Score artifacts against have-nots
   tier: 0
+  family: verify
 
 prerequisites:
   required:

package/routing/god-automation-setup.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-automation-setup
   description: Prepare opt-in host automation setup
   tier: 0
+  family: configure
 
 prerequisites:
   required: []

package/routing/god-automation-status.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-automation-status
   description: Show host automation provider support
   tier: 0
+  family: configure
 
 prerequisites:
   required: []

package/routing/god-budget.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-budget
   description: 
   tier: 0
+  family: configure
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-build-agent.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-build-agent
   description: Generate custom specialist agent
   tier: 0
+  family: extend
 
 prerequisites:
   required: []

package/routing/god-build.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-build
   description: Build slices with TDD enforcement and two-stage review
   tier: 2
+  family: build
 
 prerequisites:
   required:

package/routing/god-cache-clear.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-cache-clear
   description: 
   tier: 0
+  family: configure
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-check-todos.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-check-todos
   description: List pending todos; optionally route to one
   tier: 0
+  family: capture
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-context-scan.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-context-scan
   description: 
   tier: 0
+  family: maintain
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-context.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-context
   description: Manage Godpowers fence in AGENTS.md / CLAUDE.md / GEMINI.md / others
   tier: 0
+  family: maintain
 
 prerequisites:
   required:

package/routing/god-cost.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-cost
   description: 
   tier: 0
+  family: configure
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-debug.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-debug
   description: 4-phase systematic debug
   tier: 0
+  family: build
 
 prerequisites:
   required:

package/routing/god-deploy.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-deploy
   description: Set up deploy pipeline
   tier: 3
+  family: operate
 
 prerequisites:
   required:

package/routing/god-design-impact.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-design-impact
   description: What-if analysis on DESIGN.md change
   tier: 1
+  family: start
 
 prerequisites:
   required:
@@ -16,6 +17,11 @@ execution:
 
 success-path:
   next-recommended: /god-design or /god-sync
+  outcome:
+    type: requires-selection
+    label: User selection required
+    reason: The route offers multiple valid next commands and the user should choose one.
+    allowed-next: [/god-design, /god-sync]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-design.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-design
   description: Design lifecycle (DESIGN.md + PRODUCT.md) bridged to impeccable
   tier: 1
+  family: start
 
 prerequisites:
   required:

package/routing/god-discuss.yaml

@@ -4,6 +4,13 @@ metadata:
   command: /god-discuss
   description: Pre-planning discussion
   tier: 0
+  family: start
+  trigger-precedence:
+    - trigger: think through
+      prefer: /god-explore
+      when: broad-idea
+      fallback: /god-discuss
+      reason: Broad ideation starts in explore while concrete decisions stay in discuss.
 
 prerequisites:
   required:
@@ -18,6 +25,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-docs.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-docs
   description: Documentation work
   tier: 0
+  family: maintain
 
 prerequisites:
   required:

package/routing/god-doctor.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-doctor
   description: Diagnose install + state
   tier: 0
+  family: recover
 
 prerequisites:
   required:
@@ -18,6 +19,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-dogfood.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-dogfood
   description: Run messy-repo dogfood scenarios for release and autonomy readiness.
   tier: 0
+  family: verify
 
 prerequisites:
   required: []

package/routing/god-explore.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-explore
   description: Pre-init Socratic ideation
   tier: 0
+  family: start
 
 prerequisites:
   required:

package/routing/god-export-otel.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-export-otel
   description: Export Godpowers events to OpenTelemetry OTLP JSON traces
   tier: 0
+  family: operate
 
 prerequisites:
   required: []

package/routing/god-extension-add.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-extension-add
   description: 
   tier: 0
+  family: extend
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-extension-info.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-extension-info
   description: 
   tier: 0
+  family: extend
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-extension-list.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-extension-list
   description: 
   tier: 0
+  family: extend
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-extension-remove.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-extension-remove
   description: 
   tier: 0
+  family: extend
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-extension-scaffold.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-extension-scaffold
   description: Create a publishable extension pack skeleton
   tier: 0
+  family: extend
 
 prerequisites:
   required: []

package/routing/god-extract-learnings.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-extract-learnings
   description: Capture decisions/lessons/patterns from completed work
   tier: 0
+  family: capture
 
 prerequisites:
   required: []

package/routing/god-fast.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-fast
   description: Trivial inline edit
   tier: 0
+  family: build
 
 prerequisites:
   required:

package/routing/god-feature.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-feature
   description: Add feature to existing project
   tier: 0
+  family: build
 
 prerequisites:
   required:

package/routing/god-graph.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-graph
   description: Build/query project knowledge graph
   tier: 0
+  family: capture
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-harden.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-harden
   description: Adversarial security review
   tier: 3
+  family: operate
 
 prerequisites:
   required:

package/routing/god-help.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-help
   description: Discoverable contextual help
   tier: 0
+  family: configure
 
 prerequisites:
   required:
@@ -18,6 +19,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-hotfix.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-hotfix
   description: Urgent production bug fix
   tier: 0
+  family: operate
 
 prerequisites:
   required:

package/routing/god-hygiene.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-hygiene
   description: Composite health check
   tier: 0
+  family: verify
 
 prerequisites:
   required:

package/routing/god-init.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-init
   description: Initialize a Godpowers project. Detects mode and scale.
   tier: 0
+  family: start
 
 prerequisites:
   required: []  # No prerequisites; this is the entry point

package/routing/god-intel.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-intel
   description: Query/refresh codebase intel
   tier: 0
+  family: maintain
 
 prerequisites:
   required: []

package/routing/god-launch.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-launch
   description: Launch the product
   tier: 3
+  family: operate
 
 prerequisites:
   required:
@@ -31,6 +32,11 @@ standards:
 
 success-path:
   next-recommended: steady-state
+  outcome:
+    type: steady-state
+    label: Steady state
+    reason: The project run has completed and ongoing work should start from steady-state commands.
+    allowed-next: [/god-status, /god-feature, /god-hygiene]
 
   post-success-actions:
     - run: /god-scan

package/routing/god-lifecycle.yaml

@@ -4,6 +4,13 @@ metadata:
   command: /god-lifecycle
   description: Show project phase
   tier: 0
+  family: continue
+  trigger-precedence:
+    - trigger: where am i
+      prefer: /god-locate
+      when: checkpoint-or-handoff-exists
+      fallback: /god-lifecycle
+      reason: Resume artifacts go to locate while normal phase questions stay in lifecycle.
 
 prerequisites:
   required:
@@ -18,6 +25,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-link.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-link
   description: Manually add/remove a code-artifact link
   tier: 0
+  family: maintain
 
 prerequisites:
   required: []

package/routing/god-lint.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-lint
   description: Mechanical have-nots validation
   tier: 0
+  family: verify
 
 prerequisites:
   required: []