specrails-core 4.1.0 → 4.2.0

package/bin/doctor.sh

@@ -1,127 +0,0 @@
-#!/bin/bash
-# specrails doctor — health check for specrails-core installations
-# Usage: specrails doctor
-# Exit 0 if all checks pass, 1 if any check fails.
-
-set -uo pipefail
-
-# Colors
-GREEN='\033[0;32m'
-RED='\033[0;31m'
-NC='\033[0m'
-BOLD='\033[1m'
-
-PASS=0
-FAIL=0
-RESULTS=()
-
-pass() { RESULTS+=("$(printf "${GREEN}✅${NC} $1")"); PASS=$((PASS + 1)); }
-fail() { RESULTS+=("$(printf "${RED}❌${NC} $1\n   Fix: $2")"); FAIL=$((FAIL + 1)); }
-
-echo ""
-echo -e "${BOLD}specrails doctor${NC}"
-echo ""
-
-# Determine project root (current working directory)
-PROJECT_ROOT="${PWD}"
-
-# ─────────────────────────────────────────────
-# Check 1: Claude Code CLI
-# ─────────────────────────────────────────────
-if CLAUDE_PATH=$(command -v claude 2>/dev/null); then
-    pass "Claude Code CLI: found (${CLAUDE_PATH})"
-else
-    fail "Claude Code CLI: not found" "Install Claude Code: https://claude.ai/download"
-fi
-
-# ─────────────────────────────────────────────
-# Check 2: Claude authentication
-# ─────────────────────────────────────────────
-if command -v claude &>/dev/null; then
-    _claude_authed=false
-    if claude config list 2>/dev/null | grep -q "api_key"; then
-        _claude_authed=true
-    elif [[ -n "${ANTHROPIC_API_KEY:-}" ]]; then
-        _claude_authed=true
-    elif [[ -f "${HOME}/.claude.json" ]] && grep -q '"oauthAccount"' "${HOME}/.claude.json" 2>/dev/null; then
-        _claude_authed=true
-    fi
-
-    if [[ "$_claude_authed" == "true" ]]; then
-        pass "Claude: authenticated"
-    else
-        fail "Claude: not authenticated" "Option 1: claude config set api_key <your-key>  |  Option 2: claude auth login"
-    fi
-fi
-
-# ─────────────────────────────────────────────
-# Check 3: Agent files present
-# ─────────────────────────────────────────────
-AGENTS_DIR="${PROJECT_ROOT}/agents"
-if [[ -d "${AGENTS_DIR}" ]]; then
-    AGENT_COUNT=$(find "${AGENTS_DIR}" -name "AGENTS.md" 2>/dev/null | wc -l | tr -d ' ')
-    if [[ "${AGENT_COUNT}" -ge 1 ]]; then
-        AGENT_NAMES=$(find "${AGENTS_DIR}" -name "AGENTS.md" -exec dirname {} \; | xargs -I{} basename {} | tr '\n' ', ' | sed 's/,$//')
-        pass "Agent files: ${AGENT_COUNT} agent(s) found (${AGENT_NAMES})"
-    else
-        fail "Agent files: agents/ exists but no AGENTS.md found" "Run specrails-core init to set up agents"
-    fi
-else
-    fail "Agent files: agents/ directory not found" "Run specrails-core init to set up agents"
-fi
-
-# ─────────────────────────────────────────────
-# Check 4: CLAUDE.md present
-# ─────────────────────────────────────────────
-if [[ -f "${PROJECT_ROOT}/CLAUDE.md" ]]; then
-    pass "CLAUDE.md: present"
-else
-    fail "CLAUDE.md: missing" "Run /specrails:setup inside Claude Code to regenerate"
-fi
-
-# ─────────────────────────────────────────────
-# Check 5: Git initialized
-# ─────────────────────────────────────────────
-if [[ -d "${PROJECT_ROOT}/.git" ]]; then
-    pass "Git: initialized"
-else
-    fail "Git: not a git repository" "Initialize with: git init"
-fi
-
-# ─────────────────────────────────────────────
-# Check 6: npm present
-# ─────────────────────────────────────────────
-if NPM_VERSION=$(npm --version 2>/dev/null); then
-    pass "npm: found (v${NPM_VERSION})"
-else
-    fail "npm: not found" "Install npm: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm"
-fi
-
-# ─────────────────────────────────────────────
-# Output results
-# ─────────────────────────────────────────────
-for line in "${RESULTS[@]}"; do
-    echo -e "${line}"
-done
-
-echo ""
-
-if [[ "${FAIL}" -eq 0 ]]; then
-    TOTAL=$((PASS + FAIL))
-    echo -e "All ${TOTAL} checks passed. Run ${BOLD}/specrails:get-backlog-specs${NC} to get started."
-else
-    echo "${FAIL} check(s) failed."
-fi
-
-# ─────────────────────────────────────────────
-# Append to ~/.specrails/doctor.log
-# ─────────────────────────────────────────────
-LOG_DIR="${HOME}/.specrails"
-mkdir -p "${LOG_DIR}"
-TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u)
-TOTAL=$((PASS + FAIL))
-echo "${TIMESTAMP}  checks=${TOTAL} passed=${PASS} failed=${FAIL}" >> "${LOG_DIR}/doctor.log"
-
-echo ""
-
-exit $([[ "${FAIL}" -eq 0 ]] && echo 0 || echo 1)

package/bin/perf-check.sh

@@ -1,21 +0,0 @@
-#!/bin/bash
-# Performance regression check for specrails-core.
-# This is a template/installer repo — no runtime benchmarks apply.
-# Reports NO_PERF_IMPACT so the CI workflow exits cleanly.
-set -euo pipefail
-
-FILES="${MODIFIED_FILES_LIST:-}"
-CONTEXT="${2:-}"
-
-# Determine if any performance-sensitive files were modified.
-# For specrails-core (a shell installer + markdown template repo), there are
-# no runtime execution paths to benchmark. All changes are to installer scripts
-# or template files that have no measurable latency or throughput impact.
-
-echo "specrails-core performance check"
-echo "Modified files: ${FILES:-<none>}"
-echo ""
-echo "This repository contains shell installer scripts and Markdown templates."
-echo "No runtime benchmarks apply — skipping performance regression analysis."
-echo ""
-echo "PERF_STATUS: NO_PERF_IMPACT"

package/bin/specrails-core.js

@@ -1,262 +0,0 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require("child_process");
-const { resolve } = require("path");
-
-const ROOT = resolve(__dirname, "..");
-const COMMANDS = {
-  init: "install.sh",
-  update: "update.sh",
-  doctor: "bin/doctor.sh",
-  "perf-check": "bin/perf-check.sh",
-  enrich: null,
-  version: null,
-  profile: null,
-};
-
-const args = process.argv.slice(2);
-const subcommand = args[0];
-
-// ─── Global --version / -V flag ──────────────────────────────────────────────
-
-if (args.includes("--version") || args.includes("-V")) {
-  const pkg = require(resolve(ROOT, "package.json"));
-  console.log(`specrails-core v${pkg.version}`);
-  process.exit(0);
-}
-
-if (!subcommand) {
-  console.log(`specrails-core — Agent Workflow System for Claude Code
-
-Usage:
-  specrails-core init       [--root-dir <path>] [--yes|-y]   Install into a repository
-  specrails-core update     [--only <component>]             Update an existing installation
-  specrails-core doctor                                      Run health checks
-  specrails-core perf-check [--files <list>]                 Performance regression check (CI)
-  specrails-core enrich     [--from-config <path>]           Run /specrails:enrich via Claude CLI
-  specrails-core profile    <validate|show> [<path>]         Validate or pretty-print a profile JSON
-  specrails-core version                                     Show installed version
-
-Flags for init:
-  --root-dir <path>   Target repository path (default: current directory)
-  --yes | -y          Non-interactive; use defaults, skip TUI
-  --provider <value>  Force provider: claude or codex
-  --no-direct         Skip TUI; use the legacy interactive bash installer
-  --from-config       Skip TUI; use existing .specrails/install-config.yaml
-
-Global flags:
-  --version | -V    Show installed version
-
-More info: https://github.com/fjpulidop/specrails-core`);
-  process.exit(0);
-}
-
-if (!(subcommand in COMMANDS)) {
-  console.error(`Unknown command: ${subcommand}\n`);
-  console.error("Available commands: init, update, doctor, perf-check, enrich, version");
-  process.exit(1);
-}
-
-const script = COMMANDS[subcommand];
-
-// Allowlisted flags per subcommand
-const ALLOWED_FLAGS = {
-  init: ["--root-dir", "--yes", "-y", "--provider", "--no-direct", "--from-config", "--quick", "--hub-json", "--agent-teams"],
-  update: ["--only"],
-  doctor: [],
-  "perf-check": ["--files", "--context"],
-  enrich: ["--from-config", "--quick"],
-  version: [],
-  profile: [],
-};
-
-const subargs = args.slice(1);
-const allowed = ALLOWED_FLAGS[subcommand] ?? [];
-
-for (const arg of subargs) {
-  if (arg.startsWith("-") && !allowed.includes(arg)) {
-    console.error(`Unknown flag: ${arg}`);
-    process.exit(1);
-  }
-}
-
-// ─── version subcommand ──────────────────────────────────────────────────────
-
-if (subcommand === "version") {
-  const pkg = require(resolve(ROOT, "package.json"));
-  console.log(`specrails-core v${pkg.version}`);
-  process.exit(0);
-}
-
-// ─── profile subcommand ──────────────────────────────────────────────────────
-// `specrails-core profile validate [path]`  — validate a profile JSON against v1 schema
-// `specrails-core profile show [path]`      — pretty-print the resolved profile
-// Resolution order when no path: $SPECRAILS_PROFILE_PATH → .specrails/profiles/project-default.json
-
-if (subcommand === "profile") {
-  const { existsSync, readFileSync } = require("fs");
-  const action = subargs[0];
-  const pathArg = subargs[1];
-
-  if (!action || (action !== "validate" && action !== "show")) {
-    console.error("Usage: specrails-core profile validate [<path>]");
-    console.error("       specrails-core profile show     [<path>]");
-    process.exit(1);
-  }
-
-  const resolveProfilePath = () => {
-    if (pathArg) return resolve(pathArg);
-    if (process.env.SPECRAILS_PROFILE_PATH) return resolve(process.env.SPECRAILS_PROFILE_PATH);
-    const projectDefault = resolve(process.cwd(), ".specrails/profiles/project-default.json");
-    if (existsSync(projectDefault)) return projectDefault;
-    return null;
-  };
-
-  const profilePath = resolveProfilePath();
-  if (!profilePath) {
-    console.error("No profile path given and none could be resolved.");
-    console.error("Pass an explicit path or set SPECRAILS_PROFILE_PATH, or place a profile at");
-    console.error("  .specrails/profiles/project-default.json");
-    process.exit(1);
-  }
-  if (!existsSync(profilePath)) {
-    console.error(`Profile file not found: ${profilePath}`);
-    process.exit(1);
-  }
-
-  let profile;
-  try {
-    profile = JSON.parse(readFileSync(profilePath, "utf8"));
-  } catch (e) {
-    console.error(`Profile is not valid JSON: ${e.message}`);
-    process.exit(1);
-  }
-
-  if (action === "show") {
-    console.log(JSON.stringify(profile, null, 2));
-    process.exit(0);
-  }
-
-  // action === "validate"
-  const schemaPath = resolve(ROOT, "schemas/profile.v1.json");
-  if (!existsSync(schemaPath)) {
-    console.error(`Schema not found at ${schemaPath} — install may be corrupt`);
-    process.exit(1);
-  }
-
-  let Ajv;
-  try {
-    Ajv = require("ajv/dist/2020.js").default;
-  } catch {
-    console.error("'ajv' is not installed. Run `npm install` in the specrails-core package directory first,");
-    console.error("or rely on the hub's own validator for user-facing flows.");
-    process.exit(1);
-  }
-
-  const schema = JSON.parse(readFileSync(schemaPath, "utf8"));
-  const ajv = new Ajv({ allErrors: true, strict: false });
-  const validate = ajv.compile(schema);
-
-  if (validate(profile)) {
-    console.log(`✓ ${profilePath} is a valid v1 profile.`);
-    process.exit(0);
-  } else {
-    console.error(`✗ ${profilePath} failed validation:`);
-    for (const err of validate.errors || []) {
-      console.error(`    ${err.instancePath || "/"} ${err.message} (${JSON.stringify(err.params)})`);
-    }
-    process.exit(1);
-  }
-}
-
-// ─── enrich subcommand ───────────────────────────────────────────────────────
-// Launches `claude --command "/specrails:enrich [flags]"` so the AI-powered
-// enrichment runs inside Claude Code with full model access.
-
-if (subcommand === "enrich") {
-  const enrichFlags = subargs.join(" ");
-  const claudeCmd = `/specrails:enrich${enrichFlags ? " " + enrichFlags : ""}`;
-  const claudeResult = spawnSync("claude", ["--command", claudeCmd, "--dangerously-skip-permissions"], {
-    stdio: "inherit",
-    cwd: process.cwd(),
-  });
-
-  if (claudeResult.error) {
-    console.error(
-      "\nFailed to launch Claude CLI for enrich:",
-      claudeResult.error.message,
-      "\nEnsure Claude Code is installed: npm install -g @anthropic-ai/claude-code\n"
-    );
-    process.exit(1);
-  }
-
-  process.exit(claudeResult.status ?? (claudeResult.error ? 1 : 0));
-}
-
-// ─── Direct mode (TUI) for `init` ─────────────────────────────────────────────
-//
-// Default behaviour: run the Node.js TUI to collect agent/model configuration,
-// write .specrails/install-config.yaml, then hand off to install.sh.
-//
-// Opt-out with: --no-direct   (legacy interactive bash installer)
-//               --from-config (config already on disk; skip TUI)
-//               --yes / -y    (write default config, no prompts)
-
-const isInit       = subcommand === "init";
-const hasNoTui     = subargs.includes("--no-direct") || subargs.includes("--from-config");
-const autoYes      = subargs.includes("--yes") || subargs.includes("-y");
-const useTui       = isInit && !hasNoTui;
-
-if (useTui) {
-  // Resolve the target directory for the TUI
-  const rootDirIdx = subargs.indexOf("--root-dir");
-  const rootDir    = rootDirIdx >= 0 ? resolve(subargs[rootDirIdx + 1]) : process.cwd();
-
-  // Build TUI args: pass rootDir + --yes if set
-  const tuiArgs = [resolve(ROOT, "bin/tui-installer.mjs"), rootDir];
-  if (autoYes) tuiArgs.push("--yes");
-
-  const tuiResult = spawnSync("node", tuiArgs, {
-    stdio: "inherit",
-    cwd: process.cwd(),
-  });
-
-  if (tuiResult.error) {
-    // @inquirer/prompts not installed (e.g. during development without npm install)
-    console.error(
-      "\nFailed to launch TUI installer:",
-      tuiResult.error.message,
-      "\nRun: npm install   or use --no-direct for the legacy installer.\n"
-    );
-    process.exit(1);
-  }
-
-  if (tuiResult.status !== 0) {
-    process.exit(tuiResult.status ?? 1);
-  }
-
-  // TUI succeeded — run install.sh with --from-config so it reads provider/
-  // agent_teams from install-config.yaml rather than prompting interactively.
-  const installArgs = subargs
-    .filter(a => a !== "--no-direct") // strip internal flags
-    .concat(["--yes", "--from-config"]);
-
-  const result = spawnSync("bash", [resolve(ROOT, script), ...installArgs], {
-    stdio: "inherit",
-    cwd: process.cwd(),
-  });
-
-  process.exit(result.status ?? (result.error ? 1 : 0));
-}
-
-// ─── Legacy / non-TUI path ────────────────────────────────────────────────────
-
-// Strip only --no-direct (internal flag) before passing args to the shell script
-const cleanArgs = subargs.filter(a => a !== "--no-direct");
-
-const result = spawnSync("bash", [resolve(ROOT, script), ...cleanArgs], {
-  stdio: "inherit",
-  cwd: process.cwd(),
-});
-
-process.exit(result.status ?? (result.error ? 1 : 0));