@rigstate/cli 0.7.35 → 0.7.37

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rigstate/cli",
-    "version": "0.7.35",
+    "version": "0.7.37",
     "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/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/link.ts

@@ -110,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
                 }));
 

package/src/commands/roadmap.ts

@@ -4,6 +4,7 @@ import chalk from 'chalk';
 import ora from 'ora';
 import axios from 'axios';
 import { getApiKey, getApiUrl, getProjectId } from '../utils/config.js';
+import { RoadmapChunk, ROADMAP_STATUS } from '@rigstate/shared';
 
 export function createRoadmapCommand(): Command {
     return new Command('roadmap')
@@ -30,7 +31,8 @@ export function createRoadmapCommand(): Command {
                     throw new Error(response.data.error || 'Failed to fetch roadmap');
                 }
 
-                const tasks = response.data.data.roadmap || [];
+
+                const tasks: RoadmapChunk[] = response.data.data.roadmap || [];
                 spinner.stop();
 
                 if (tasks.length === 0) {
@@ -41,16 +43,20 @@ export function createRoadmapCommand(): Command {
                 console.log('\n' + chalk.bold.underline('🛰️  TACTICAL OVERVIEW: PROJECT ROADMAP'));
                 console.log(chalk.dim('──────────────────────────────────────────────'));
 
-                const columns = {
-                    'IN_PROGRESS': [] as any[],
-                    'ACTIVE': [] as any[],
-                    'LOCKED': [] as any[],
-                    'PENDING': [] as any[]
+                // Initialize columns based on shared status definitions (or subset used here)
+                const columns: Record<string, RoadmapChunk[]> = {
+                    'IN_PROGRESS': [],
+                    'ACTIVE': [],
+                    'LOCKED': [],
+                    'PENDING': [],
+                    'TODO': [],
+                    'COMPLETED': []
                 };
 
-                tasks.forEach((t: any) => {
-                    if (columns[t.status as keyof typeof columns]) {
-                        columns[t.status as keyof typeof columns].push(t);
+                tasks.forEach((t) => {
+                    const status = t.status as string; // until API returns exact enum
+                    if (columns[status]) {
+                        columns[status].push(t);
                     }
                 });
 

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('');

package/src/utils/manifest.ts

@@ -7,8 +7,14 @@ export interface RigstateManifest {
     api_url?: string;
     linked_at?: string;
     api_key?: string;
+    // Genesis Protocol status (cached locally to avoid API calls)
+    genesis_complete?: boolean;
+    genesis_template?: string;
+    genesis_stack_key?: string;
+    genesis_initialized_at?: string;
 }
 
+
 export async function loadManifest(): Promise<RigstateManifest | null> {
     const cwd = process.cwd();
     const manifestPaths = [