steroids-cli 0.4.47

package/dist/commands/init.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * steroids init - Initialize steroids in current directory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const node_util_1 = require("node:util");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_child_process_1 = require("node:child_process");
+const connection_js_1 = require("../database/connection.js");
+const output_js_1 = require("../cli/output.js");
+const colors_js_1 = require("../cli/colors.js");
+const projects_js_1 = require("../runners/projects.js");
+const help_js_1 = require("../cli/help.js");
+const ai_setup_js_1 = require("../config/ai-setup.js");
+const HELP = (0, help_js_1.generateHelp)({
+    command: 'init',
+    description: 'Initialize Steroids in current directory',
+    details: `Sets up Steroids task management system in the current directory.
+Creates a .steroids directory with SQLite database for task tracking.
+Projects are only registered globally if inside a git repository.
+This prevents test/temporary directories from polluting the global registry.`,
+    usage: ['steroids init [options]'],
+    options: [
+        { short: 'y', long: 'yes', description: 'Accept all defaults without prompts (skips AI setup wizard)' },
+        { long: 'no-register', description: 'Skip global project registration' },
+        { long: 'skip-ai-setup', description: 'Skip AI provider configuration wizard' },
+    ],
+    examples: [
+        { command: 'steroids init', description: 'Initialize in current directory' },
+        { command: 'steroids init --yes', description: 'Initialize with defaults' },
+        { command: 'steroids init --no-register', description: 'Initialize without global registration' },
+        { command: 'steroids init --dry-run', description: 'Preview initialization' },
+    ],
+    related: [
+        { command: 'steroids sections add', description: 'Add task sections after init' },
+        { command: 'steroids tasks add', description: 'Add tasks after init' },
+        { command: 'steroids loop', description: 'Start automation after setup' },
+    ],
+    sections: [
+        {
+            title: 'CREATES',
+            content: `.steroids/steroids.db    SQLite database with task schema
+Registers project in global registry at ~/.steroids/steroids.db (if in git repo)`,
+        },
+    ],
+});
+/**
+ * Try to extract project name from package.json if it exists
+ * @param cwd - Current working directory
+ * @returns Project name or null if not found
+ */
+function getProjectName(cwd) {
+    try {
+        const packageJsonPath = (0, node_path_1.join)(cwd, 'package.json');
+        if ((0, node_fs_1.existsSync)(packageJsonPath)) {
+            const content = (0, node_fs_1.readFileSync)(packageJsonPath, 'utf-8');
+            const pkg = JSON.parse(content);
+            return pkg.name || null;
+        }
+    }
+    catch {
+        // Ignore errors - package.json might not exist or be invalid
+    }
+    return null;
+}
+/**
+ * Check if the directory is inside a git repository
+ * @param cwd - Current working directory
+ * @returns true if inside a git repo
+ */
+function isInsideGitRepo(cwd) {
+    try {
+        (0, node_child_process_1.execSync)('git rev-parse --is-inside-work-tree', {
+            cwd,
+            stdio: 'pipe',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function initCommand(args, flags) {
+    const out = (0, output_js_1.createOutput)({ command: 'init', flags });
+    const { values } = (0, node_util_1.parseArgs)({
+        args,
+        options: {
+            yes: { type: 'boolean', short: 'y', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+            'no-register': { type: 'boolean', default: false },
+            'skip-ai-setup': { type: 'boolean', default: false },
+        },
+        allowPositionals: false,
+    });
+    if (values.help || flags.help) {
+        out.log(HELP);
+        return;
+    }
+    const cwd = process.cwd();
+    const dbPath = (0, connection_js_1.getDbPath)(cwd);
+    if ((0, connection_js_1.isInitialized)(cwd)) {
+        if (flags.json) {
+            out.success({
+                message: 'Already initialized',
+                database: dbPath,
+                alreadyInitialized: true,
+            });
+        }
+        else {
+            out.log(colors_js_1.markers.info('Steroids already initialized in this directory.'));
+            out.log(`Database: ${colors_js_1.colors.cyan(dbPath)}`);
+        }
+        return;
+    }
+    out.verbose('Initializing Steroids...');
+    if (flags.dryRun) {
+        if (flags.json) {
+            out.success({
+                message: 'Dry run: Would initialize Steroids',
+                database: dbPath,
+                dryRun: true,
+            });
+        }
+        else {
+            out.log(colors_js_1.colors.yellow('Dry run: Would initialize Steroids'));
+            out.log(`Database would be created at: ${dbPath}`);
+        }
+        return;
+    }
+    const { close } = (0, connection_js_1.initDatabase)(cwd);
+    close();
+    // Register project in global registry (only if in a git repo and not --no-register)
+    const noRegister = values['no-register'];
+    const inGitRepo = isInsideGitRepo(cwd);
+    if (noRegister) {
+        out.verbose('Skipping global registration (--no-register flag)');
+    }
+    else if (!inGitRepo) {
+        out.verbose('Skipping global registration (not inside a git repository)');
+    }
+    else {
+        const projectName = getProjectName(cwd);
+        try {
+            (0, projects_js_1.registerProject)(cwd, projectName || undefined);
+            out.verbose(`Registered project globally${projectName ? ` as "${projectName}"` : ''}`);
+        }
+        catch (error) {
+            // Don't fail init if registration fails - just log it
+            out.verbose(`Warning: Failed to register project globally: ${error}`);
+        }
+    }
+    // Run AI setup wizard (unless --yes or --skip-ai-setup is used, or JSON output)
+    const skipAISetup = values.yes || values['skip-ai-setup'] || flags.json;
+    if (!skipAISetup) {
+        out.log('');
+        out.log(colors_js_1.markers.info('AI Provider Configuration'));
+        out.log('Configure AI providers for orchestrator, coder, and reviewer roles.');
+        out.log(`${colors_js_1.colors.dim('(You can skip this and configure later with "steroids config ai")')}`);
+        out.log('');
+        try {
+            // Run wizard for coder role first (most important)
+            await (0, ai_setup_js_1.runAISetup)({ role: 'coder', global: true });
+            // Ask if user wants to configure other roles
+            out.log('');
+            out.log(`${colors_js_1.colors.dim('Tip: Run "steroids config ai" to configure other roles (orchestrator, reviewer)')}`);
+        }
+        catch (error) {
+            // AI setup failed or was cancelled - don't fail init
+            out.verbose(`AI setup skipped or cancelled: ${error}`);
+        }
+    }
+    if (flags.json) {
+        out.success({
+            message: 'Initialized successfully',
+            database: dbPath,
+            nextSteps: [
+                'steroids config ai',
+                'steroids sections add "Phase 1"',
+                'steroids tasks add "My first task" --section "Phase 1"',
+                'steroids loop',
+            ],
+        });
+    }
+    else {
+        out.log('');
+        out.log(colors_js_1.markers.success('Steroids initialized successfully!'));
+        out.log(`Database: ${colors_js_1.colors.cyan(dbPath)}`);
+        out.log('');
+        out.log(colors_js_1.colors.bold('Next steps:'));
+        if (skipAISetup) {
+            out.log(`  ${colors_js_1.colors.dim('$')} steroids config ai  ${colors_js_1.colors.dim('# Configure AI providers')}`);
+        }
+        out.log(`  ${colors_js_1.colors.dim('$')} steroids sections add "Phase 1"`);
+        out.log(`  ${colors_js_1.colors.dim('$')} steroids tasks add "My first task" --section "Phase 1"`);
+        out.log(`  ${colors_js_1.colors.dim('$')} steroids loop`);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/llm.d.ts

@@ -0,0 +1,7 @@
+/**
+ * steroids llm - Compact instructions for LLM agents
+ * Call this when context is lost to quickly understand the system
+ */
+import type { GlobalFlags } from '../cli/flags.js';
+export declare function llmCommand(args: string[], flags: GlobalFlags): Promise<void>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/commands/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/commands/llm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA8JnD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA4HlF"}

package/dist/commands/llm.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * steroids llm - Compact instructions for LLM agents
+ * Call this when context is lost to quickly understand the system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.llmCommand = llmCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const projects_js_1 = require("../runners/projects.js");
+const daemon_js_1 = require("../runners/daemon.js");
+const connection_js_1 = require("../database/connection.js");
+const queries_js_1 = require("../database/queries.js");
+const help_js_1 = require("../cli/help.js");
+const LLM_INSTRUCTIONS = `# STEROIDS LLM QUICK REFERENCE
+
+## WHAT IS STEROIDS
+Steroids=automated task orchestration system.
+It manages tasks and invokes LLM agents (coders/reviewers) to execute them.
+The system spawns separate LLM processes for coding and reviewing.
+
+## TASK FLOW
+pending → in_progress (coder works) → review (reviewer checks) → completed OR rejected→pending
+Runner daemon picks tasks and invokes appropriate LLM agents automatically.
+
+## ARCHITECTURE
+- Tasks stored in .steroids/steroids.db (per project)
+- Runner daemon executes the loop (one per project)
+- Coder LLM: implements task, commits, submits for review
+- Reviewer LLM: verifies implementation, approves or rejects
+- You (reading this): likely helping user manage/debug the system
+
+## MULTI-PROJECT
+- Multiple projects can have runners simultaneously
+- Each runner bound to ONE project only
+- Global registry at ~/.steroids/steroids.db tracks all projects
+- NEVER modify files outside current project
+
+## KEY COMMANDS
+
+### View Tasks
+steroids tasks stats                    # task counts by status
+steroids tasks                          # pending tasks (current project)
+steroids tasks --status active          # in_progress+review (current project)
+steroids tasks --status active --global # active across ALL projects
+steroids tasks --status all             # all tasks
+steroids tasks audit <id>               # view task spec, history, rejection notes
+
+### Add Tasks
+steroids tasks add "Title" --section <id> --source <spec-file>
+steroids tasks add "Title" --section <id> --source spec.md --file src/foo.ts --line 42
+steroids tasks add "Advisory note" --feedback
+
+Options:
+  --section <id>     Section to add the task to (required unless --feedback)
+  --source <file>    Specification markdown file (required unless --feedback)
+  --file <path>      Anchor task to a specific file in the codebase
+                     File must be committed in git (not dirty/untracked)
+                     Auto-captures: commit SHA of last change + content hash
+                     Coder/reviewer prompts will reference this exact location
+  --line <number>    Line number in the anchored file (requires --file)
+  --feedback         Add to skipped "Needs User Input" section for human review
+                     Skips --section and --source requirements
+
+BEST PRACTICE: When generating tasks from documentation or specs, commit the
+documentation first, then fill in ALL values including optional ones:
+  --source pointing to the committed spec file
+  --file pointing to the relevant source file in the codebase
+  --line pointing to the exact line where work applies
+This gives the coder/reviewer maximum context and traceability.
+
+### Manage Tasks
+steroids tasks update <id> --status <s> --actor model --model <m>
+  statuses: pending, in_progress, review, completed, skipped, partial
+steroids tasks approve <id> --model <m> [--notes "msg"]     # mark completed
+steroids tasks reject <id> --model <m> --notes "feedback"   # back to pending
+steroids tasks skip <id> --notes "reason"                   # external setup, skip it
+steroids tasks skip <id> --partial --notes "reason"         # coded some, rest external
+
+### Sections
+steroids sections list                  # list sections
+steroids sections skip <id>             # exclude from runner
+steroids sections unskip <id>           # include in runner
+
+### Runners (daemon that executes tasks)
+steroids runners list                   # all runners (all projects)
+steroids runners start --detach         # start background daemon
+steroids runners start --section "X"    # focus on specific section
+steroids runners stop --all             # stop all
+steroids runners status                 # current state
+steroids runners logs <pid>             # view daemon output
+
+### Projects
+steroids projects list                  # all registered projects
+
+### Web Dashboard
+steroids web                            # clone (first run) and launch dashboard
+steroids web update                     # pull latest + reinstall deps
+steroids web stop                       # stop running dashboard
+steroids web status                     # check if dashboard is running
+
+## COMMON OPERATIONS
+
+### Start automation
+steroids runners start --detach         # daemon picks tasks and invokes coders/reviewers
+
+### Check what's happening
+steroids tasks --status active --global # see all active work
+steroids runners list                   # see all running daemons
+
+### Unblock stuck task in review
+steroids tasks approve <id> --model human   # approve manually
+steroids tasks reject <id> --model human --notes "reason"  # reject manually
+
+### Restart failed task
+steroids tasks update <id> --status pending --reset-rejections  # reset to pending with fresh count
+
+### Skip external setup task
+steroids tasks skip <id> --notes "spec says SKIP, needs Cloud SQL setup"
+# Use when: spec says SKIP/MANUAL, requires cloud console, account creation, etc.
+# --partial: use if you coded some parts but rest needs human action
+
+## TASK STATES
+- pending: waiting to be picked up
+- in_progress: coder is working on it
+- review: coder submitted, waiting for reviewer
+- completed: approved by reviewer
+- skipped: fully external (Cloud SQL, manual setup) - human must do
+- partial: some coded, rest external - human must complete
+- failed: exceeded 15 rejections, needs human intervention
+- disputed: coder/reviewer disagreement, needs human resolution
+
+## IMPORTANT NOTES
+- Task spec is in source file (see tasks audit output)
+- Max 15 rejections before task fails
+- Runner auto-restarts via cron (steroids runners cron install)
+- Each project isolated: own database, own runner
+`;
+const HELP = (0, help_js_1.generateHelp)({
+    command: 'llm',
+    description: 'Compact instructions for LLM agents',
+    details: 'Quick reference guide for AI agents working with Steroids. Shows key commands, task flow, and current context.',
+    usage: [
+        'steroids llm',
+        'steroids llm --context',
+    ],
+    options: [
+        { long: 'context', description: 'Include current project context (projects, runners, tasks)' },
+    ],
+    examples: [
+        { command: 'steroids llm', description: 'Show LLM quick reference' },
+        { command: 'steroids llm --context', description: 'Show reference with current context' },
+    ],
+    related: [
+        { command: 'steroids about', description: 'Explain what Steroids is' },
+        { command: 'steroids tasks', description: 'Manage tasks' },
+    ],
+    showGlobalOptions: false,
+    showEnvVars: false,
+    showExitCodes: false,
+});
+async function llmCommand(args, flags) {
+    // Check for help
+    if (flags.help || args.includes('-h') || args.includes('--help')) {
+        console.log(HELP);
+        return;
+    }
+    const includeContext = args.includes('--context');
+    // Always print instructions
+    console.log(LLM_INSTRUCTIONS);
+    // Optionally include current context
+    if (includeContext) {
+        console.log('## CURRENT CONTEXT\n');
+        // Current project
+        console.log(`Project: ${process.cwd()}`);
+        // Registered projects
+        try {
+            const projects = (0, projects_js_1.getRegisteredProjects)(false);
+            console.log(`Registered projects: ${projects.length}`);
+            if (projects.length > 1) {
+                console.log('WARNING: Multi-project environment. Only work on YOUR project.');
+            }
+        }
+        catch {
+            console.log('Registered projects: unknown');
+        }
+        // Active runners
+        try {
+            const runners = (0, daemon_js_1.listRunners)();
+            const activeRunners = runners.filter(r => r.status === 'running');
+            console.log(`Active runners: ${activeRunners.length}`);
+            for (const r of activeRunners) {
+                const proj = r.project_path ? r.project_path.split('/').pop() : 'unknown';
+                console.log(`  - ${r.id.slice(0, 8)} on ${proj} (PID ${r.pid})`);
+            }
+        }
+        catch {
+            console.log('Active runners: unknown');
+        }
+        // Global active tasks
+        console.log('');
+        console.log('Active tasks (all projects):');
+        try {
+            const projects = (0, projects_js_1.getRegisteredProjects)(false);
+            let totalActive = 0;
+            for (const project of projects) {
+                const dbPath = `${project.path}/.steroids/steroids.db`;
+                if (!(0, node_fs_1.existsSync)(dbPath))
+                    continue;
+                try {
+                    const { db, close } = (0, connection_js_1.openDatabase)(project.path);
+                    try {
+                        const inProgress = (0, queries_js_1.listTasks)(db, { status: 'in_progress' });
+                        const review = (0, queries_js_1.listTasks)(db, { status: 'review' });
+                        const active = [...inProgress, ...review];
+                        const projName = project.name || (0, node_path_1.basename)(project.path);
+                        for (const task of active) {
+                            totalActive++;
+                            const status = task.status === 'in_progress' ? 'CODING' : 'REVIEW';
+                            console.log(`  [${status}] ${projName}: ${task.title.slice(0, 50)} (${task.id.slice(0, 8)})`);
+                        }
+                    }
+                    finally {
+                        close();
+                    }
+                }
+                catch {
+                    // Skip inaccessible projects
+                }
+            }
+            if (totalActive === 0) {
+                console.log('  (none)');
+            }
+        }
+        catch {
+            console.log('  (unknown)');
+        }
+        // Skipped tasks requiring manual action
+        console.log('');
+        console.log('Skipped tasks (need manual action):');
+        try {
+            const projects = (0, projects_js_1.getRegisteredProjects)(false);
+            let totalSkipped = 0;
+            for (const project of projects) {
+                const dbPath = `${project.path}/.steroids/steroids.db`;
+                if (!(0, node_fs_1.existsSync)(dbPath))
+                    continue;
+                try {
+                    const { db, close } = (0, connection_js_1.openDatabase)(project.path);
+                    try {
+                        const skipped = (0, queries_js_1.listTasks)(db, { status: 'skipped' });
+                        const partial = (0, queries_js_1.listTasks)(db, { status: 'partial' });
+                        const allSkipped = [...skipped, ...partial];
+                        const projName = project.name || (0, node_path_1.basename)(project.path);
+                        for (const task of allSkipped) {
+                            totalSkipped++;
+                            const marker = task.status === 'skipped' ? '[S]' : '[s]';
+                            console.log(`  ${marker} ${projName}: ${task.title.slice(0, 50)} (${task.id.slice(0, 8)})`);
+                        }
+                    }
+                    finally {
+                        close();
+                    }
+                }
+                catch {
+                    // Skip inaccessible projects
+                }
+            }
+            if (totalSkipped === 0) {
+                console.log('  (none - all tasks are automated)');
+            }
+            else {
+                console.log('');
+                console.log('  [S] = Fully external (human must do entire task)');
+                console.log('  [s] = Partial (some coded, rest needs human)');
+                console.log('  Use: steroids tasks audit <id> to see what action is needed');
+            }
+        }
+        catch {
+            console.log('  (unknown)');
+        }
+        console.log('');
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/commands/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/commands/llm.ts"],"names":[],"mappings":"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"}

package/dist/commands/locks.d.ts

@@ -0,0 +1,3 @@
+import type { GlobalFlags } from '../cli/flags.js';
+export declare function locksCommand(args: string[], flags: GlobalFlags): Promise<void>;
+//# sourceMappingURL=locks.d.ts.map

package/dist/commands/locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../src/commands/locks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAoEnD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCpF"}