specrails-core 3.6.0 → 3.7.0

package/templates/commands/specrails/reconfig.md

@@ -21,7 +21,7 @@ If the file does not exist, stop and display:
 ```
 No .specrails/agents.yaml found.
 
-Run /specrails:setup to generate the config file, then edit it before running /specrails:reconfig.
+Run /specrails:enrich to generate the config file, then edit it before running /specrails:reconfig.
 ```
 
 If the file exists, parse it. Validate all `model:` values — only `opus`, `sonnet`, and `haiku` are accepted. If an invalid value is found, display a warning and skip that agent:

package/templates/settings/integration-contract.json

@@ -0,0 +1,88 @@
+{
+  "schemaVersion": "3.0",
+  "providers": {
+    "claude": {
+      "enrichCommand": "/specrails:enrich",
+      "enrichArgs": ["--from-config"],
+      "updateCommand": "/specrails:enrich",
+      "updateArgs": ["--update"],
+      "cli": {
+        "initArgs": [],
+        "enrichArgs": ["--dangerously-skip-permissions", "--output-format", "stream-json", "-p", "/specrails:enrich"],
+        "enrichFromConfigArgs": ["--dangerously-skip-permissions", "--output-format", "stream-json", "-p", "/specrails:enrich --from-config"]
+      }
+    },
+    "codex": {
+      "enrichCommand": "$enrich",
+      "enrichArgs": ["--from-config"],
+      "updateCommand": "$enrich",
+      "updateArgs": ["--update"],
+      "cli": {
+        "initArgs": [],
+        "enrichArgs": ["exec", "run enrich"],
+        "enrichFromConfigArgs": ["exec", "run enrich --from-config"]
+      }
+    }
+  },
+  "tiers": {
+    "quick": {
+      "description": "Template-based install with minimal defaults. No AI codebase analysis. Agents are functional immediately.",
+      "enrichFlag": "--quick",
+      "checkpoints": ["base_install", "agent_selection", "agent_generation"],
+      "requiresEnrich": false
+    },
+    "full": {
+      "description": "Full AI-powered install. Analyzes codebase, generates VPC personas, creates personalized agents.",
+      "enrichFlag": "--from-config",
+      "checkpoints": ["codebase_analysis", "vpc_discovery", "persona_synthesis", "agent_generation", "command_generation"],
+      "requiresEnrich": true
+    }
+  },
+  "configSchema": {
+    "file": ".specrails/install-config.yaml",
+    "version": 1,
+    "fields": {
+      "version": "number — schema version, currently 1",
+      "provider": "string — claude | codex | auto",
+      "tier": "string — full | quick",
+      "agents.selected": "string[] — agent names to install",
+      "agents.excluded": "string[] — agent names to skip",
+      "models.preset": "string — balanced | budget | max",
+      "models.defaults.model": "string — sonnet | opus | haiku (overrides preset)",
+      "models.overrides": "Record<string, string> — per-agent model (highest priority)",
+      "quick_context.product_description": "string — product description seed for VPC discovery",
+      "quick_context.target_users": "string — target users seed for VPC discovery",
+      "agent_teams": "boolean — install team-review and team-debug commands"
+    }
+  },
+  "checkpoints": {
+    "base_install": "Templates and directory structure copied",
+    "agent_selection": "Agent list finalized from config or TUI",
+    "codebase_analysis": "Codebase language/framework/architecture detected",
+    "vpc_discovery": "VPC personas researched and drafted",
+    "persona_synthesis": "Final persona files written",
+    "agent_generation": "All selected agents generated with placeholders filled",
+    "command_generation": "All workflow commands installed and configured"
+  },
+  "modelPresets": {
+    "balanced": {
+      "description": "Flagship models for architects and PMs, efficient models for others",
+      "defaults": { "model": "sonnet" },
+      "overrides": { "sr-architect": "opus", "sr-product-manager": "opus" }
+    },
+    "budget": {
+      "description": "All agents use the most cost-efficient model",
+      "defaults": { "model": "haiku" },
+      "overrides": {}
+    },
+    "max": {
+      "description": "All agents use the most capable model",
+      "defaults": { "model": "opus" },
+      "overrides": {}
+    }
+  },
+  "legacyCompat": {
+    "setupCommandAlias": true,
+    "note": "During transition, /specrails:setup may still be installed as an alias in some repos. Hub should prefer /specrails:enrich."
+  }
+}

package/update.sh

@@ -168,14 +168,20 @@ generate_manifest() {
     \"${relpath}\": \"${checksum}\""
     done < <(find "$SCRIPT_DIR/templates" -type f -not -path '*/node_modules/*' -not -name 'package-lock.json' -print0 | sort -z)
 
-    # Include commands/setup.md
-    local setup_checksum
-    setup_checksum="sha256:$(shasum -a 256 "$SCRIPT_DIR/commands/setup.md" | awk '{print $1}')"
+    # Include commands/enrich.md
+    local enrich_checksum
+    enrich_checksum="sha256:$(shasum -a 256 "$SCRIPT_DIR/commands/enrich.md" | awk '{print $1}')"
     if [ -n "$artifacts_json" ]; then
         artifacts_json="${artifacts_json},"
     fi
     artifacts_json="${artifacts_json}
-    \"commands/specrails/setup.md\": \"${setup_checksum}\""
+    \"commands/specrails/enrich.md\": \"${enrich_checksum}\""
+
+    # Include commands/doctor.md
+    local doctor_checksum
+    doctor_checksum="sha256:$(shasum -a 256 "$SCRIPT_DIR/commands/doctor.md" | awk '{print $1}')"
+    artifacts_json="${artifacts_json},
+    \"commands/specrails/doctor.md\": \"${doctor_checksum}\""
 
     # Include prompts/
     if [[ -d "$SCRIPT_DIR/prompts" ]]; then
@@ -299,18 +305,18 @@ except Exception:
             fi
         done < <(find "$SCRIPT_DIR/templates" -type f -not -path '*/node_modules/*' -not -name 'package-lock.json' -print0 | sort -z)
 
-        # Also check commands/setup.md
-        if [[ "$HAS_CHANGES" == false ]] && [[ -f "$SCRIPT_DIR/commands/setup.md" ]]; then
-            setup_checksum="sha256:$(shasum -a 256 "$SCRIPT_DIR/commands/setup.md" | awk '{print $1}')"
-            manifest_setup="$(python3 -c "
+        # Also check commands/enrich.md
+        if [[ "$HAS_CHANGES" == false ]] && [[ -f "$SCRIPT_DIR/commands/enrich.md" ]]; then
+            enrich_checksum="sha256:$(shasum -a 256 "$SCRIPT_DIR/commands/enrich.md" | awk '{print $1}')"
+            manifest_enrich="$(python3 -c "
 import json, sys
 try:
     data = json.load(open(sys.argv[1]))
-    print(data['artifacts'].get('commands/specrails/setup.md', data['artifacts'].get('commands/setup.md', '')))
+    print(data['artifacts'].get('commands/specrails/enrich.md', data['artifacts'].get('commands/enrich.md', '')))
 except Exception:
     print('')
 " "$local_manifest" 2>/dev/null || echo "")"
-            if [[ "$setup_checksum" != "$manifest_setup" ]]; then
+            if [[ "$enrich_checksum" != "$manifest_enrich" ]]; then
                 HAS_CHANGES=true
             fi
         fi
@@ -522,11 +528,11 @@ except Exception:
         return 1  # Unchanged
     }
 
-    # Update /specrails:setup command (selective)
+    # Update /specrails:enrich command (selective)
     mkdir -p "$REPO_ROOT/.claude/commands/specrails"
-    if _file_changed "$SCRIPT_DIR/commands/setup.md" "commands/specrails/setup.md"; then
-        cp "$SCRIPT_DIR/commands/setup.md" "$REPO_ROOT/.claude/commands/specrails/setup.md"
-        ok "Updated /specrails:setup command"
+    if _file_changed "$SCRIPT_DIR/commands/enrich.md" "commands/specrails/enrich.md"; then
+        cp "$SCRIPT_DIR/commands/enrich.md" "$REPO_ROOT/.claude/commands/specrails/enrich.md"
+        ok "Updated /specrails:enrich command"
         updated_count=$(( updated_count + 1 ))
     fi