specrails-hub 1.12.0 → 1.13.0

package/cli/dist/specrails-hub.js

@@ -20,6 +20,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KNOWN_VERBS = void 0;
 exports.parseArgs = parseArgs;
+exports.getVersion = getVersion;
 exports.detectWebManager = detectWebManager;
 exports.formatDuration = formatDuration;
 exports.formatTokens = formatTokens;
@@ -89,6 +90,9 @@ function parseArgs(argv) {
             i--;
         }
     }
+    if (args[0] === '--version' || args[0] === '-v') {
+        return { mode: 'version' };
+    }
     if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
         return { mode: 'help' };
     }
@@ -125,20 +129,55 @@ function parseArgs(argv) {
     const resolved = args.join(' ');
     return { mode: 'raw', resolved, port };
 }
+function getVersion() {
+    for (const rel of ['../package.json', '../../package.json']) {
+        try {
+            const pkgPath = path_1.default.join(__dirname, rel);
+            const pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf8'));
+            if (typeof pkg.version === 'string')
+                return pkg.version;
+        }
+        catch {
+            // try next
+        }
+    }
+    return 'unknown';
+}
+function printVersion() {
+    process.stdout.write(`specrails-hub v${getVersion()}\n`);
+}
 function printHelp() {
+    const version = getVersion();
     process.stdout.write(`
-${bold('specrails-hub')} — specrails CLI bridge
+${bold(`specrails-hub v${version}`)} — specrails CLI bridge
+
+${bold('Project Required:')}
+  Every command runs in the context of a project registered for the current
+  directory. Register your project once before running any commands:
+
+    ${dim('# Register your project (run once per project):')}
+    specrails-hub hub add .
+
+    ${dim('# Then run commands from that directory:')}
+    specrails-hub implement #42
 
 ${bold('Usage:')}
   specrails-hub implement #42                Run a known specrails verb (prepends /sr:)
-  specrails-hub batch-implement #40 #41      Known verbs: ${[...exports.KNOWN_VERBS].join(', ')}
+  specrails-hub batch-implement #40 #41      Batch implementation across issues
+  specrails-hub why                          Explain recent changes
+  specrails-hub product-backlog              View prioritized product backlog
+  specrails-hub update-product-driven-backlog  Generate new feature ideas
+  specrails-hub refactor-recommender        Find refactoring opportunities
+  specrails-hub health-check                Run codebase health check
+  specrails-hub compat-check                Check for breaking API changes
   specrails-hub "any raw prompt"             Pass a raw prompt directly to claude
   specrails-hub --status                     Print manager status and exit
   specrails-hub --jobs                       Print recent job history and exit
-  specrails-hub start|stop|add|list         Manage the hub (shorthand, no 'hub' prefix needed)
+  specrails-hub start|stop|add|remove|list  Manage the hub (shorthand, no 'hub' prefix)
   specrails-hub hub <subcommand>             Same, with explicit 'hub' prefix
   specrails-hub --port <n>                   Override default port (${DEFAULT_PORT})
-  specrails-hub --help                       Show this help text
+  specrails-hub --version, -v               Print version and exit
+  specrails-hub --help, -h                  Show this help text
 
 ${bold('Execution paths:')}
   Manager running → POST /api/spawn + stream logs via WebSocket
@@ -928,6 +967,10 @@ ${bold('Usage:')}
 async function main() {
     const argv = process.argv.slice(2);
     const parsed = parseArgs(argv);
+    if (parsed.mode === 'version') {
+        printVersion();
+        process.exit(0);
+    }
     if (parsed.mode === 'help') {
         printHelp();
         process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specrails-hub",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/server/dist/setup-manager.js

@@ -217,6 +217,19 @@ class SetupManager {
             return;
         }
         this._initCheckpoints(projectId);
+        // Pre-create the directory structure that /setup will write to.
+        // Claude Code's Write tool does not create parent directories automatically —
+        // if a target directory doesn't exist the write fails and Claude reports a
+        // misleading "write permissions aren't enabled" error.  Creating the dirs
+        // here ensures setup runs transparently without any user intervention.
+        try {
+            (0, fs_1.mkdirSync)((0, path_1.join)(projectPath, '.claude', 'agents', 'personas'), { recursive: true });
+            (0, fs_1.mkdirSync)((0, path_1.join)(projectPath, '.claude', 'commands', 'sr'), { recursive: true });
+            (0, fs_1.mkdirSync)((0, path_1.join)(projectPath, '.claude', 'rules'), { recursive: true });
+        }
+        catch (err) {
+            console.warn(`[SetupManager] Failed to pre-create setup directories: ${err}`);
+        }
         const args = [
             '-p', '/setup',
             '--dangerously-skip-permissions',