@rigstate/cli 0.7.34 → 0.7.36

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rigstate/cli",
-    "version": "0.7.34",
+    "version": "0.7.36",
     "description": "Rigstate CLI - Code audit, sync and supervision tool",
     "type": "module",
     "main": "./dist/index.js",
@@ -17,7 +17,6 @@
     "dependencies": {
         "@rigstate/rules-engine": "*",
         "@rigstate/shared": "*",
-        "uuid": "^9.0.1",
         "@types/diff": "^7.0.2",
         "@types/inquirer": "^9.0.9",
         "axios": "^1.6.5",
@@ -29,7 +28,9 @@
         "dotenv": "^16.4.1",
         "glob": "^10.3.10",
         "inquirer": "^9.3.8",
-        "ora": "^8.0.1"
+        "ora": "^8.0.1",
+        "simple-git": "^3.31.1",
+        "uuid": "^9.0.1"
     },
     "devDependencies": {
         "@types/node": "^20.11.5",
@@ -50,4 +51,4 @@
     ],
     "author": "Rigstate",
     "license": "MIT"
-}
+}

package/src/commands/env.ts

@@ -141,12 +141,9 @@ export function createEnvPullCommand() {
             projectId = getProjectId();
 
             if (!projectId) {
-                try {
-                    const manifestPath = path.join(process.cwd(), '.rigstate');
-                    const content = await fs.readFile(manifestPath, 'utf-8');
-                    const manifest = JSON.parse(content);
-                    projectId = manifest.project_id;
-                } catch (e) { }
+                const { loadManifest } = await import('../utils/manifest.js');
+                const manifest = await loadManifest();
+                if (manifest?.project_id) projectId = manifest.project_id;
             }
 
             if (!projectId) {

package/src/commands/focus.ts

@@ -30,12 +30,9 @@ export function createFocusCommand() {
 
             projectId = getProjectId();
             if (!projectId) {
-                try {
-                    const manifestPath = path.join(process.cwd(), '.rigstate');
-                    const content = await fs.readFile(manifestPath, 'utf-8');
-                    const manifest = JSON.parse(content);
-                    projectId = manifest.project_id;
-                } catch (e) { }
+                const { loadManifest } = await import('../utils/manifest.js');
+                const manifest = await loadManifest();
+                if (manifest?.project_id) projectId = manifest.project_id;
             }
 
             if (!projectId) {

package/src/commands/genesis.ts

@@ -0,0 +1,305 @@
+/* eslint-disable no-console */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import axios from 'axios';
+import { getApiKey, getApiUrl, getProjectId } from '../utils/config.js';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+interface GenesisStep {
+    id: string;
+    title: string;
+    step_number: number;
+    icon: string;
+    verification_path?: string;
+}
+
+interface GenesisStatusResponse {
+    success: boolean;
+    data: {
+        genesis_complete: boolean;
+        genesis_steps: GenesisStep[];
+        genesis_count: number;
+        total_roadmap_steps: number;
+        detected_template: string;
+        detected_stack_key: string;
+        project_name: string;
+    };
+    error?: string;
+}
+
+interface GenesisTriggerResponse {
+    success: boolean;
+    data: {
+        project_name: string;
+        template: string;
+        stack_key: string;
+        steps_created: number;
+        steps: GenesisStep[];
+        existing_steps_shifted: number;
+        message: string;
+    };
+    error?: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Command Definition
+// ─────────────────────────────────────────────────────────────────────────────
+export function createGenesisCommand(): Command {
+    return new Command('genesis')
+        .description('Initialize project foundation (Phase 0). Detects stack and injects foundation steps.')
+        .option('--force', 'Re-run genesis even if already initialized (use with caution)')
+        .option('--status', 'Check genesis status without triggering')
+        .option('--project-id <id>', 'Override project ID (defaults to linked project)')
+        .action(async (options) => {
+            const apiKey = getApiKey();
+            const apiUrl = getApiUrl();
+            const projectId = options.projectId || getProjectId();
+
+            if (!projectId) {
+                console.error(chalk.red('❌ No project linked. Run: rigstate link'));
+                process.exit(1);
+            }
+
+            if (!apiKey) {
+                console.error(chalk.red('❌ Not authenticated. Run: rigstate login'));
+                process.exit(1);
+            }
+
+            if (options.status) {
+                await checkGenesisStatus(projectId, apiKey, apiUrl);
+            } else {
+                await triggerGenesis(projectId, apiKey, apiUrl, options.force ?? false);
+            }
+        });
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Status Check
+// ─────────────────────────────────────────────────────────────────────────────
+export async function checkGenesisStatus(
+    projectId: string,
+    apiKey: string,
+    apiUrl: string
+): Promise<{ complete: boolean; stepCount: number }> {
+    // ── Offline-first: check local manifest cache ─────────────────────────────
+    try {
+        const { loadManifest } = await import('../utils/manifest.js');
+        const manifest = await loadManifest();
+        if (manifest?.genesis_complete) {
+            // Local cache hit — skip API call
+            return { complete: true, stepCount: 0 }; // stepCount not cached, but complete is enough
+        }
+    } catch {
+        // Ignore manifest read errors
+    }
+
+    const spinner = ora('Checking Genesis status...').start();
+
+    try {
+        const response = await axios.get<GenesisStatusResponse>(
+            `${apiUrl}/api/v1/genesis`,
+            {
+                params: { project_id: projectId },
+                headers: { Authorization: `Bearer ${apiKey}` },
+                timeout: 10000
+            }
+        );
+
+        spinner.stop();
+
+        if (!response.data.success) {
+            console.log(chalk.yellow(`⚠️  Could not check genesis status: ${response.data.error}`));
+            return { complete: false, stepCount: 0 };
+        }
+
+        const { data } = response.data;
+
+        console.log('');
+        console.log(chalk.bold('🏗️  GENESIS STATUS'));
+        console.log(chalk.dim('────────────────────────────────────────'));
+        console.log(`${chalk.bold('Project:')}        ${chalk.cyan(data.project_name)}`);
+        console.log(`${chalk.bold('Stack:')}          ${chalk.magenta(data.detected_template)}`);
+        console.log(`${chalk.bold('Genesis:')}        ${data.genesis_complete ? chalk.green('✅ Complete') : chalk.yellow('⚠️  Pending')}`);
+        console.log(`${chalk.bold('Foundation:')}     ${chalk.white(data.genesis_count)} steps`);
+        console.log(`${chalk.bold('Total Roadmap:')}  ${chalk.white(data.total_roadmap_steps)} steps`);
+
+        if (data.genesis_complete && data.genesis_steps.length > 0) {
+            console.log('');
+            console.log(chalk.dim('Foundation Steps:'));
+            data.genesis_steps.forEach(step => {
+                console.log(`  ${step.icon}  ${chalk.bold(`T-${step.step_number}`)}: ${step.title}`);
+            });
+        } else if (!data.genesis_complete) {
+            console.log('');
+            console.log(chalk.yellow('⚡ Genesis not yet initialized.'));
+            console.log(chalk.dim('   Run: ') + chalk.white('rigstate genesis'));
+        }
+
+        console.log(chalk.dim('────────────────────────────────────────'));
+        console.log('');
+
+        return { complete: data.genesis_complete, stepCount: data.genesis_count };
+
+    } catch (err: any) {
+        spinner.stop();
+        if (err.response?.status === 422) {
+            console.log(chalk.yellow('⚠️  Genesis pending: Complete onboarding with Frank first.'));
+            console.log(chalk.dim('   Then run: rigstate genesis'));
+        }
+        return { complete: false, stepCount: 0 };
+    }
+}
+
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Trigger Genesis
+// ─────────────────────────────────────────────────────────────────────────────
+export async function triggerGenesis(
+    projectId: string,
+    apiKey: string,
+    apiUrl: string,
+    force = false
+): Promise<boolean> {
+    console.log('');
+    console.log(chalk.bold.blue('🏗️  GENESIS PROTOCOL'));
+    console.log(chalk.dim('Initializing project foundation...'));
+    console.log('');
+
+    const spinner = ora('Detecting tech stack...').start();
+
+    try {
+        // Step 1: Check status first (unless force)
+        if (!force) {
+            const statusRes = await axios.get<GenesisStatusResponse>(
+                `${apiUrl}/api/v1/genesis`,
+                {
+                    params: { project_id: projectId },
+                    headers: { Authorization: `Bearer ${apiKey}` },
+                    timeout: 10000
+                }
+            );
+
+            if (statusRes.data.success && statusRes.data.data.genesis_complete) {
+                spinner.stop();
+                console.log(chalk.green('✅ Genesis already complete.'));
+                console.log(chalk.dim(`   ${statusRes.data.data.genesis_count} foundation steps already in roadmap.`));
+                console.log(chalk.dim('   Use --force to re-initialize.'));
+                console.log('');
+                return true;
+            }
+
+            if (statusRes.data.success) {
+                spinner.text = `Stack detected: ${statusRes.data.data.detected_template}. Generating foundation...`;
+            }
+        } else {
+            spinner.text = 'Force mode: Re-generating foundation...';
+        }
+
+        // Step 2: Trigger Genesis
+        const response = await axios.post<GenesisTriggerResponse>(
+            `${apiUrl}/api/v1/genesis`,
+            { project_id: projectId, force },
+            {
+                headers: { Authorization: `Bearer ${apiKey}` },
+                timeout: 60000 // AI enrichment can take time
+            }
+        );
+
+        spinner.stop();
+
+        if (!response.data.success) {
+            // Handle specific error cases
+            if ((response as any).status === 409) {
+                console.log(chalk.yellow('⚠️  Genesis already initialized. Use --force to re-run.'));
+                return true;
+            }
+            if ((response as any).status === 422) {
+                console.log('');
+                console.log(chalk.yellow('⚠️  Cannot initialize Genesis yet.'));
+                console.log(chalk.dim('   Complete onboarding with Frank first to define your tech stack.'));
+                console.log(chalk.dim('   Then run: ') + chalk.white('rigstate genesis'));
+                console.log('');
+                return false;
+            }
+            console.error(chalk.red(`❌ Genesis failed: ${response.data.error}`));
+            return false;
+        }
+
+        const { data } = response.data;
+
+        // ── Success Output ────────────────────────────────────────────────────
+        console.log(chalk.bold.green('✅ GENESIS COMPLETE'));
+        console.log(chalk.dim('────────────────────────────────────────'));
+        console.log(`${chalk.bold('Project:')}   ${chalk.cyan(data.project_name)}`);
+        console.log(`${chalk.bold('Stack:')}     ${chalk.magenta(data.template)}`);
+        console.log(`${chalk.bold('Created:')}   ${chalk.white(data.steps_created)} foundation steps`);
+
+        if (data.existing_steps_shifted > 0) {
+            console.log(`${chalk.bold('Shifted:')}   ${chalk.dim(`${data.existing_steps_shifted} existing steps moved down`)}`);
+        }
+
+        console.log('');
+        console.log(chalk.bold('📋 Foundation Steps:'));
+        data.steps.forEach(step => {
+            console.log(`  ${step.icon}  ${chalk.bold(`T-${step.step_number}`)}: ${step.title}`);
+            if (step.verification_path) {
+                console.log(`       ${chalk.dim(`Verify: ${step.verification_path}`)}`);
+            }
+        });
+
+        console.log('');
+        console.log(chalk.bold.yellow('⚡ NEXT MOVE:'));
+        if (data.steps.length > 0) {
+            const firstStep = data.steps[0];
+            console.log(`  ${chalk.white(`> rigstate work start ${firstStep.id}`)}  ${chalk.dim(`(Start: ${firstStep.title})`)}`);
+        }
+        console.log(chalk.dim('────────────────────────────────────────'));
+        console.log('');
+
+        // ── Persist genesis status to local manifest (enables offline checks) ──
+        try {
+            const { saveManifest } = await import('../utils/manifest.js');
+            await saveManifest({
+                genesis_complete: true,
+                genesis_template: data.template,
+                genesis_stack_key: data.stack_key,
+                genesis_initialized_at: new Date().toISOString()
+            });
+        } catch {
+            // Non-critical: local cache write failure doesn't break the flow
+        }
+
+        return true;
+
+
+    } catch (err: any) {
+        spinner.stop();
+
+        // Handle axios error responses
+        if (err.response?.status === 409) {
+            console.log(chalk.green('✅ Genesis already complete.'));
+            console.log(chalk.dim('   Use --force to re-initialize.'));
+            return true;
+        }
+
+        if (err.response?.status === 422) {
+            console.log('');
+            console.log(chalk.yellow('⚠️  Genesis pending: Onboarding not complete.'));
+            console.log(chalk.dim('   Finish the Frank conversation to define your tech stack.'));
+            console.log(chalk.dim('   Then run: ') + chalk.white('rigstate genesis'));
+            console.log('');
+            return false;
+        }
+
+        if (err.code === 'ECONNREFUSED' || err.code === 'ENOTFOUND') {
+            console.log(chalk.dim('   (Genesis skipped: API unreachable)'));
+            return false;
+        }
+
+        console.error(chalk.red(`❌ Genesis error: ${err.response?.data?.error || err.message}`));
+        return false;
+    }
+}

package/src/commands/init.ts

@@ -181,13 +181,12 @@ export function createInitCommand() {
                 setProjectId(projectId);
 
                 // Write local manifest
-                const manifestPath = path.join(process.cwd(), '.rigstate');
-                const manifestContent = {
+                const { saveManifest } = await import('../utils/manifest.js');
+                await saveManifest({
                     project_id: projectId,
-                    last_linked: new Date().toISOString(),
+                    linked_at: new Date().toISOString(),
                     api_url: apiUrl
-                };
-                await fs.writeFile(manifestPath, JSON.stringify(manifestContent, null, 2), 'utf-8');
+                });
 
                 // Initialize git if needed
                 try {

package/src/commands/link.ts

@@ -74,33 +74,23 @@ export function createLinkCommand() {
                 }
             }
 
-            const manifestPath = path.join(process.cwd(), '.rigstate');
-
-            const content: any = {
-                project_id: projectId,
-                linked_at: new Date().toISOString()
-            };
-
-            // Only store api_url locally if it's NOT the production default
-            const currentUrl = getApiUrl();
-            if (currentUrl !== 'https://app.rigstate.com') {
-                content.api_url = currentUrl;
-            }
-
+            const cwd = process.cwd();
             try {
-                // Ensure .rigstate dir exists
-                await fs.mkdir(path.dirname(manifestPath), { recursive: true });
+                const { saveManifest } = await import('../utils/manifest.js');
+                const targetFile = await saveManifest({
+                    project_id: projectId,
+                    linked_at: new Date().toISOString(),
+                    api_url: getApiUrl() !== 'https://app.rigstate.com' ? getApiUrl() : undefined
+                });
 
-                await fs.writeFile(manifestPath, JSON.stringify(content, null, 2), 'utf-8');
                 console.log(chalk.green(`✔ Linked to project ID: ${projectId}`));
-                console.log(chalk.dim(`Created local context manifest at .rigstate`));
+                console.log(chalk.dim(`Created local identity manifest at ${path.relative(cwd, targetFile)}`));
 
                 // === SMART AUTOMATION ===
                 console.log('');
                 console.log(chalk.bold('🤖 Rigstate Automation Detected'));
                 console.log('');
 
-                const { getApiKey: _getApiKey, getApiUrl: _getApiUrl } = await import('../utils/config.js');
                 const apiKey = getApiKey();
                 const apiUrl = getApiUrl();
 
@@ -120,12 +110,28 @@ export function createLinkCommand() {
                     await installHooks(process.cwd());
                     await hardenGitIgnore(process.cwd());
 
+                    // 4. Genesis Protocol (Smart Detection)
+                    console.log(chalk.blue('🏗️  Checking Genesis status...'));
+                    const { checkGenesisStatus, triggerGenesis } = await import('./genesis.js');
+                    const genesisStatus = await checkGenesisStatus(projectId, apiKey, apiUrl);
+
+                    if (!genesisStatus.complete) {
+                        // Try to trigger automatically — will fail gracefully if spec not ready
+                        const triggered = await triggerGenesis(projectId, apiKey, apiUrl, false);
+                        if (!triggered) {
+                            console.log(chalk.dim('   💡 Run "rigstate genesis" after completing onboarding with Frank.'));
+                        }
+                    } else {
+                        console.log(chalk.green(`   ✔ Genesis complete (${genesisStatus.stepCount} foundation steps ready)`));
+                    }
+
                     console.log('');
                     console.log(chalk.bold.green('🚀 Link Complete! Your environment is ready.'));
 
-                    // 4. Tactical Suggestion
+                    // 5. Tactical Suggestion
                     const { suggestNextMove } = await import('./suggest.js');
                     await suggestNextMove(projectId, apiKey, apiUrl);
+
                 } else {
                     console.log('');
                     console.log(chalk.bold.green('🚀 Link Complete!'));

package/src/commands/plan.ts

@@ -43,9 +43,9 @@ export async function executePlan(taskId?: string) {
             const tasks: any[] = response.data.data.roadmap || [];
 
             const choices = tasks
-                .filter(t => ['ACTIVE', 'IN_PROGRESS', 'PENDING'].includes(t.status))
+                .filter(t => ['ACTIVE', 'IN_PROGRESS', 'PENDING', 'LOCKED'].includes(t.status))
                 .map(t => ({
-                    name: `T-${t.step_number}: ${t.title}`,
+                    name: `${t.status === 'LOCKED' ? '🔒 ' : ''}T-${t.step_number}: ${t.title}${t.origin_id === 'GENESIS' ? chalk.dim(' [Foundation]') : ''}`,
                     value: t
                 }));
 
@@ -137,15 +137,32 @@ ${taskDescription}
         // 4. Update Status (Optional - maybe set to IN_PROGRESS?)
         // For now, let's keep it pure planning.
 
+        // 4. Trigger Bridge Task (Autonomous Bridge)
+        try {
+            spinner.start('📡 Signaling Frank to start drafting...');
+            await axios.post(`${apiUrl}/api/v1/agent/bridge`, {
+                project_id: projectId,
+                task_id: realId,
+                status: 'APPROVED',
+                proposal: `draft_plan:${taskId}`,
+                summary: `Requesting implementation plan for ${taskTitle}`
+            }, {
+                headers: { 'Authorization': `Bearer ${apiKey}` }
+            });
+            spinner.succeed('Signal sent to Agent Bridge.');
+        } catch (e) {
+            spinner.info(chalk.dim('Agent Bridge signal skipped (non-critical).'));
+        }
+
         console.log('');
         console.log(chalk.bold.blue('🚀 Planning Mode Activated'));
         console.log(chalk.dim('────────────────────────────────────────'));
         console.log(`1. Context loaded into: ${chalk.bold('.rigstate/CURRENT_CONTEXT.md')}`);
         console.log(`2. Plan template ready: ${chalk.bold('IMPLEMENTATION_PLAN.md')}`);
         console.log('');
-        console.log(chalk.yellow('👉 NEXT STEP:'));
-        console.log(`   Open ${chalk.bold('IMPLEMENTATION_PLAN.md')} in your IDE.`);
-        console.log(`   Tell Frank: ${chalk.italic('"Read the context and draft the plan."')}`);
+        console.log(chalk.green('✨ FRANK IS ON IT!'));
+        console.log(chalk.dim('   He has received the bridge signal and will begin drafting shortly.'));
+        console.log(chalk.dim('   No further manual steps required once he wakes up.'));
         console.log('');
 
     } catch (e: any) {

package/src/commands/sync.ts

@@ -30,12 +30,9 @@ export function createSyncCommand() {
 
                 // Check local .rigstate manifest
                 if (!projectId) {
-                    try {
-                        const manifestPath = path.join(process.cwd(), '.rigstate');
-                        const manifestContent = await fs.readFile(manifestPath, 'utf-8');
-                        const manifest = JSON.parse(manifestContent);
-                        if (manifest.project_id) projectId = manifest.project_id;
-                    } catch (e) { }
+                    const { loadManifest } = await import('../utils/manifest.js');
+                    const manifest = await loadManifest();
+                    if (manifest?.project_id) projectId = manifest.project_id;
                 }
 
                 // Check global config
@@ -79,14 +76,12 @@ export function createSyncCommand() {
 
                 // 4b. Write Context Manifest (.rigstate) - CONTEXT GUARD
                 try {
-                    const manifestPath = path.join(process.cwd(), '.rigstate');
-                    const manifestContent = {
+                    const { saveManifest } = await import('../utils/manifest.js');
+                    await saveManifest({
                         project_id: projectId,
-                        project_name: project,
-                        last_synced: timestamp,
+                        linked_at: timestamp, // Using timestamp as linked_at for consistency
                         api_url: apiUrl
-                    };
-                    await fs.writeFile(manifestPath, JSON.stringify(manifestContent, null, 2), 'utf-8');
+                    });
                 } catch (e) {
                     // Fail silently
                 }

package/src/commands/watch.ts

@@ -42,13 +42,9 @@ export function createWatchCommand() {
 
             projectId = getProjectId();
             if (!projectId) {
-                // Try to read from local manifest
-                try {
-                    const manifestPath = path.join(process.cwd(), '.rigstate');
-                    const content = await fs.readFile(manifestPath, 'utf-8');
-                    const manifest = JSON.parse(content);
-                    projectId = manifest.project_id;
-                } catch (e) { }
+                const { loadManifest } = await import('../utils/manifest.js');
+                const manifest = await loadManifest();
+                if (manifest?.project_id) projectId = manifest.project_id;
             }
 
             if (!projectId) {

package/src/index.ts

@@ -23,6 +23,7 @@ import { createReleaseCommand } from './commands/release.js';
 import { createRoadmapCommand } from './commands/roadmap.js';
 import { createCouncilCommand } from './commands/council.js';
 import { createPlanCommand } from './commands/plan.js';
+import { createGenesisCommand } from './commands/genesis.js';
 import { checkVersion } from './utils/version.js';
 import dotenv from 'dotenv';
 
@@ -63,6 +64,7 @@ program.addCommand(createReleaseCommand());
 program.addCommand(createRoadmapCommand());
 program.addCommand(createCouncilCommand());
 program.addCommand(createPlanCommand());
+program.addCommand(createGenesisCommand());
 
 program.hook('preAction', async () => {
     await checkVersion();
@@ -79,6 +81,12 @@ program.on('--help', () => {
     console.log(chalk.cyan('  $ rigstate scan'));
     console.log(chalk.dim('    Scan the current directory'));
     console.log('');
+    console.log(chalk.cyan('  $ rigstate genesis'));
+    console.log(chalk.dim('    Initialize project foundation (auto-detects stack)'));
+    console.log('');
+    console.log(chalk.cyan('  $ rigstate genesis --status'));
+    console.log(chalk.dim('    Check genesis status without triggering'));
+    console.log('');
     console.log(chalk.cyan('  $ rigstate scan ./src --project abc123'));
     console.log(chalk.dim('    Scan a specific directory with project ID'));
     console.log('');