gemkit-cli 0.2.3 → 0.3.0

package/dist/commands/plan/index.js

@@ -0,0 +1,247 @@
+/**
+ * Plan command - list, status, create, set, info
+ * Replaces: gk-set-active-plan.cjs (set), get_plan_info.js (info)
+ *
+ * Subcommands organized with custom help display.
+ */
+import { listPlans, createPlan, setActivePlan, getPlanInfo } from '../../domains/plan/index.js';
+import { getActivePlan, getActiveGkSessionId, readEnv } from '../../domains/session/env.js';
+import { logger } from '../../services/logger.js';
+import { brand, ui, pc } from '../../utils/colors.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// HELP FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════
+function showMainHelp() {
+    console.log();
+    console.log(pc.bold(brand.geminiPurple('Plan Management')));
+    console.log();
+    console.log('Usage:');
+    console.log(`  ${brand.primary('gk plan')} <subcommand> [options]`);
+    console.log();
+    console.log('Subcommands:');
+    console.log(`  ${brand.primary('list')}              List all plans (default)`);
+    console.log(`  ${brand.primary('status')}            Show active plan status`);
+    console.log(`  ${brand.primary('create')} <name>     Create new plan`);
+    console.log(`  ${brand.primary('set')} <name>        Set active plan`);
+    console.log(`  ${brand.primary('info')}              Get plan info from .env`);
+    console.log();
+    console.log('Options:');
+    console.log(`  ${brand.dim('--json')}            Output as JSON`);
+    console.log(`  ${brand.dim('-a, --active')}      [info] Show only ACTIVE_PLAN value`);
+    console.log(`  ${brand.dim('-s, --suggested')}   [info] Show only SUGGESTED_PLAN value`);
+    console.log(`  ${brand.dim('-f, --format')}      [info] Show only PLAN_DATE_FORMAT value`);
+    console.log();
+    console.log('Examples:');
+    console.log(`  ${brand.dim('gk plan list')}`);
+    console.log(`  ${brand.dim('gk plan create my-feature')}`);
+    console.log(`  ${brand.dim('gk plan set my-feature')}`);
+    console.log(`  ${brand.dim('gk plan info --active')}`);
+    console.log();
+}
+export function registerPlanCommand(cli) {
+    cli
+        .command('plan [subcommand] [name]', 'Plan management (list, status, create, set, info)')
+        .alias('p')
+        .option('--json', '[all] Output as JSON')
+        .option('-a, --active', '[info] Show only ACTIVE_PLAN value')
+        .option('-s, --suggested', '[info] Show only SUGGESTED_PLAN value')
+        .option('-f, --format', '[info] Show only PLAN_DATE_FORMAT value')
+        .action(async (subcommand, name, options) => {
+        const sub = subcommand || 'list';
+        switch (sub) {
+            case 'list':
+                await handleList(options);
+                break;
+            case 'status':
+                await handleStatus(options);
+                break;
+            case 'create':
+                if (!name) {
+                    console.log();
+                    logger.error('Plan name required');
+                    console.log(brand.dim('Usage: gk plan create <name>'));
+                    console.log();
+                    process.exit(1);
+                }
+                await handleCreate(name);
+                break;
+            case 'set':
+                if (!name) {
+                    console.log();
+                    logger.error('Plan name required');
+                    console.log(brand.dim('Usage: gk plan set <name>'));
+                    console.log();
+                    process.exit(1);
+                }
+                await handleSet(name);
+                break;
+            case 'info':
+                await handleInfo(options);
+                break;
+            default:
+                showMainHelp();
+        }
+    });
+}
+async function handleList(options) {
+    const plans = listPlans();
+    if (options.json) {
+        console.log(JSON.stringify(plans, null, 2));
+        return;
+    }
+    console.log();
+    console.log(pc.bold(brand.geminiPurple('Project Plans')));
+    console.log();
+    if (plans.length === 0) {
+        logger.info('No plans found. Create one with "gk plan create <name>".');
+        console.log();
+        return;
+    }
+    for (const p of plans) {
+        const icon = p.isActive ? brand.success('→') : brand.dim('○');
+        const activeMarker = p.isActive ? brand.success(' (active)') : '';
+        console.log(`  ${icon} ${brand.primary(p.name)}${activeMarker}`);
+        console.log(`    ${brand.dim('Created:')} ${brand.dim(new Date(p.createdAt).toLocaleDateString())}`);
+    }
+    console.log();
+}
+async function handleStatus(options) {
+    const activeName = getActivePlan();
+    if (!activeName) {
+        if (options.json) {
+            console.log(JSON.stringify({ active: false }, null, 2));
+        }
+        else {
+            console.log();
+            logger.info('No active plan set.');
+            console.log();
+        }
+        return;
+    }
+    const info = getPlanInfo(activeName);
+    if (options.json) {
+        console.log(JSON.stringify(info, null, 2));
+        return;
+    }
+    console.log();
+    console.log(ui.line());
+    console.log(pc.bold(brand.geminiPurple('Active Plan')));
+    console.log(ui.line());
+    console.log();
+    console.log(`  ${brand.primary(activeName)}`);
+    console.log();
+}
+async function handleCreate(name) {
+    try {
+        const newPlan = createPlan(name);
+        console.log();
+        logger.success(`Plan created: ${brand.primary(name)}`);
+        logger.info(`Path: ${brand.dim(newPlan.path)}`);
+        // Auto-activate
+        setActivePlan(name);
+        logger.info('Set as active plan.');
+        console.log();
+    }
+    catch (error) {
+        console.log();
+        logger.error(`Failed to create plan: ${error instanceof Error ? error.message : String(error)}`);
+        console.log();
+    }
+}
+async function handleSet(name) {
+    const plans = listPlans();
+    const exists = plans.some(p => p.name === name);
+    if (!exists) {
+        console.log();
+        logger.error(`Plan not found: ${name}`);
+        console.log();
+        return;
+    }
+    const success = setActivePlan(name);
+    if (!success) {
+        console.log();
+        logger.error('Failed to update session or env file');
+        console.log();
+        return;
+    }
+    // Get session info for display
+    const gkSessionId = getActiveGkSessionId();
+    console.log();
+    if (gkSessionId) {
+        logger.success(`Session ${gkSessionId.slice(0, 20)}...: activePlan set to: ${brand.primary(name)}`);
+    }
+    logger.info(`Environment updated: ACTIVE_PLAN = ${name}`);
+    console.log();
+    logger.success(`Active plan set to: ${brand.primary(name)}`);
+    console.log();
+}
+/**
+ * Handle plan info - Get plan information from .env
+ * Replaces: get_plan_info.js
+ */
+async function handleInfo(options) {
+    const env = readEnv();
+    const info = {
+        activePlan: env.ACTIVE_PLAN || null,
+        suggestedPlan: env.SUGGESTED_PLAN || null,
+        planDateFormat: env.PLAN_DATE_FORMAT || null,
+        gkSessionId: env.ACTIVE_GK_SESSION_ID || null,
+        projectDir: env.PROJECT_DIR || null
+    };
+    // Handle single-field requests
+    if (options.active) {
+        if (options.json) {
+            console.log(JSON.stringify({ activePlan: info.activePlan }));
+        }
+        else {
+            console.log(info.activePlan || '');
+        }
+        return;
+    }
+    if (options.suggested) {
+        if (options.json) {
+            console.log(JSON.stringify({ suggestedPlan: info.suggestedPlan }));
+        }
+        else {
+            console.log(info.suggestedPlan || '');
+        }
+        return;
+    }
+    if (options.format) {
+        if (options.json) {
+            console.log(JSON.stringify({ planDateFormat: info.planDateFormat }));
+        }
+        else {
+            console.log(info.planDateFormat || '');
+        }
+        return;
+    }
+    // Full output
+    if (options.json) {
+        console.log(JSON.stringify({
+            activePlan: info.activePlan,
+            suggestedPlan: info.suggestedPlan,
+            planDateFormat: info.planDateFormat,
+            context: {
+                gkSessionId: info.gkSessionId,
+                projectDir: info.projectDir
+            }
+        }, null, 2));
+    }
+    else {
+        console.log();
+        console.log(ui.line());
+        console.log(pc.bold(brand.geminiPurple('Plan Information')));
+        console.log(ui.line());
+        console.log();
+        console.log(`  ${brand.dim('Active Plan:')}      ${info.activePlan || brand.dim('(not set)')}`);
+        console.log(`  ${brand.dim('Suggested Plan:')}   ${info.suggestedPlan || brand.dim('(not set)')}`);
+        console.log(`  ${brand.dim('Date Format:')}      ${info.planDateFormat || brand.dim('(not set)')}`);
+        console.log();
+        console.log(ui.line());
+        const shortSession = info.gkSessionId ? info.gkSessionId.substring(0, 25) + '...' : brand.dim('(no session)');
+        console.log(`  ${brand.dim('Session:')}          ${shortSession}`);
+        console.log(`  ${brand.dim('Project:')}          ${info.projectDir || brand.dim('(unknown)')}`);
+        console.log();
+    }
+}

package/dist/commands/session/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Session command - status, list, info, agents, init
+ * Replaces: gk-init.cjs (init subcommand)
+ *
+ * Subcommands organized with custom help display.
+ */
+import type { CAC } from 'cac';
+export declare function registerSessionCommand(cli: CAC): void;

package/dist/commands/session/index.js

@@ -0,0 +1,289 @@
+/**
+ * Session command - status, list, info, agents, init
+ * Replaces: gk-init.cjs (init subcommand)
+ *
+ * Subcommands organized with custom help display.
+ */
+import { getSession, listSessions, getMetrics, getActiveGkSessionId, getProjectDir, readEnv, initializeNonGeminiSession, addAgent, parseGkSessionId, getTerminalPid } from '../../domains/session/index.js';
+import { logger } from '../../services/logger.js';
+import { brand, ui, pc } from '../../utils/colors.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// HELP FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════
+function showMainHelp() {
+    console.log();
+    console.log(pc.bold(brand.geminiPurple('Session Management')));
+    console.log();
+    console.log('Usage:');
+    console.log(`  ${brand.primary('gk session')} <subcommand> [options]`);
+    console.log();
+    console.log('Subcommands:');
+    console.log(`  ${brand.primary('status')}            Show active session (default)`);
+    console.log(`  ${brand.primary('list')}              List recent sessions`);
+    console.log(`  ${brand.primary('info')} <id>         Show session details`);
+    console.log(`  ${brand.primary('agents')} [id]       List agents in session`);
+    console.log(`  ${brand.primary('init')} [app]        Initialize new session`);
+    console.log();
+    console.log('Options:');
+    console.log(`  ${brand.dim('--json')}            Output as JSON`);
+    console.log(`  ${brand.dim('-n, --limit <n>')}   Number of results for list (default: 10)`);
+    console.log();
+    console.log('Examples:');
+    console.log(`  ${brand.dim('gk session status')}`);
+    console.log(`  ${brand.dim('gk session list -n 20')}`);
+    console.log(`  ${brand.dim('gk session info abc123')}`);
+    console.log(`  ${brand.dim('gk session agents')}`);
+    console.log(`  ${brand.dim('gk session init myapp')}`);
+    console.log();
+}
+export function registerSessionCommand(cli) {
+    cli
+        .command('session [subcommand] [id]', 'Session management (status, list, info, agents, init)')
+        .alias('s')
+        .option('--json', '[all] Output as JSON')
+        .option('-n, --limit <n>', '[list] Number of results', { default: 10 })
+        .action(async (subcommand, id, options) => {
+        const sub = subcommand || 'status';
+        switch (sub) {
+            case 'status':
+                await handleStatus(options);
+                break;
+            case 'list':
+                await handleList(options);
+                break;
+            case 'info':
+                if (!id) {
+                    console.log();
+                    logger.error('Session ID required');
+                    console.log(brand.dim('Usage: gk session info <id>'));
+                    console.log();
+                    process.exit(1);
+                }
+                await handleInfo(id, options);
+                break;
+            case 'agents':
+                await handleAgents(id, options);
+                break;
+            case 'init':
+                await handleInit(id || 'app', options);
+                break;
+            default:
+                showMainHelp();
+        }
+    });
+}
+async function handleStatus(options) {
+    const env = readEnv();
+    const projectDir = getProjectDir();
+    const gkSessionId = env.ACTIVE_GK_SESSION_ID;
+    if (!gkSessionId) {
+        if (options.json) {
+            console.log(JSON.stringify({ active: false, projectDir }, null, 2));
+        }
+        else {
+            console.log();
+            logger.info('No active GemKit session.');
+            console.log(brand.dim(`  Project: ${projectDir}`));
+            console.log();
+        }
+        return;
+    }
+    const session = getSession(projectDir, gkSessionId);
+    if (options.json) {
+        console.log(JSON.stringify(session || { active: false, gkSessionId }, null, 2));
+        return;
+    }
+    if (!session) {
+        console.log();
+        logger.warn(`Session ID in .env but file not found: ${gkSessionId}`);
+        console.log(brand.dim(`  Project: ${projectDir}`));
+        console.log();
+        return;
+    }
+    const metrics = getMetrics(projectDir, gkSessionId);
+    const mainAgent = session.agents?.find(a => a.agentType === 'Main Agent');
+    const status = mainAgent?.status || 'active';
+    console.log();
+    console.log(pc.bold(brand.geminiPurple('Active Session')));
+    console.log(ui.line());
+    console.log();
+    console.log(`  ${brand.dim('GK Session ID:')}     ${brand.primary(session.gkSessionId)}`);
+    console.log(`  ${brand.dim('Gemini Session ID:')} ${session.geminiSessionId || brand.dim('N/A')}`);
+    console.log(`  ${brand.dim('Project Dir:')}       ${session.projectDir}`);
+    console.log(`  ${brand.dim('App Name:')}          ${session.appName}`);
+    console.log(`  ${brand.dim('PID:')}               ${session.pid}`);
+    console.log(`  ${brand.dim('Status:')}            ${ui.statusIcon(status)} ${status}`);
+    console.log(`  ${brand.dim('Started:')}           ${session.initTimestamp}`);
+    if (session.activePlan) {
+        console.log(`  ${brand.dim('Active Plan:')}       ${brand.primary(session.activePlan)}`);
+    }
+    console.log();
+    console.log(`  ${brand.dim('Agents:')} ${metrics.total} total (${metrics.mainAgents} main, ${metrics.subAgents} sub)`);
+    console.log(`          ${brand.success(String(metrics.completed))} completed, ${brand.error(String(metrics.failed))} failed, ${metrics.active} active`);
+    console.log();
+}
+async function handleList(options) {
+    const projectDir = getProjectDir();
+    const sessions = listSessions(projectDir, { limit: options.limit });
+    if (options.json) {
+        console.log(JSON.stringify(sessions, null, 2));
+        return;
+    }
+    console.log();
+    console.log(pc.bold(brand.geminiPurple('Recent Sessions')));
+    console.log(brand.dim(`  Project: ${projectDir}`));
+    console.log();
+    if (sessions.length === 0) {
+        logger.info('  No sessions found.');
+        console.log();
+        return;
+    }
+    for (const s of sessions) {
+        const date = new Date(s.initTimestamp).toLocaleString();
+        const mainAgent = s.agents?.find(a => a.agentType === 'Main Agent');
+        const status = mainAgent?.status || 'active';
+        const shortId = s.gkSessionId.length > 25 ? s.gkSessionId.slice(0, 25) + '...' : s.gkSessionId;
+        console.log(`  ${ui.statusIcon(status)} ${brand.primary(shortId)}  ${brand.dim(date)}`);
+        if (s.activePlan) {
+            console.log(`    ${brand.dim('Plan:')} ${s.activePlan}`);
+        }
+    }
+    console.log();
+    console.log(brand.dim(`  Showing ${sessions.length} sessions (limit: ${options.limit})`));
+    console.log();
+}
+async function handleInfo(id, options) {
+    const projectDir = getProjectDir();
+    const session = getSession(projectDir, id);
+    if (!session) {
+        console.log();
+        logger.error(`Session not found: ${id}`);
+        console.log(brand.dim(`  Looked in: ~/.gemkit/projects/${projectDir}/`));
+        console.log();
+        process.exit(1);
+    }
+    if (options.json) {
+        console.log(JSON.stringify(session, null, 2));
+        return;
+    }
+    console.log();
+    console.log(pc.bold(brand.geminiPurple(`Session: ${session.gkSessionId}`)));
+    console.log(ui.line());
+    console.log();
+    console.log(JSON.stringify(session, null, 2));
+    console.log();
+}
+async function handleAgents(id, options) {
+    const projectDir = getProjectDir();
+    const sessionId = id || getActiveGkSessionId();
+    if (!sessionId) {
+        console.log();
+        logger.error('No session ID provided and no active session found.');
+        console.log();
+        process.exit(1);
+    }
+    const session = getSession(projectDir, sessionId);
+    if (!session) {
+        console.log();
+        logger.error(`Session not found: ${sessionId}`);
+        console.log();
+        process.exit(1);
+    }
+    const agents = session.agents || [];
+    if (options.json) {
+        console.log(JSON.stringify(agents, null, 2));
+        return;
+    }
+    const shortId = sessionId.length > 30 ? sessionId.slice(0, 30) + '...' : sessionId;
+    console.log();
+    console.log(pc.bold(brand.geminiPurple(`Agents in Session`)));
+    console.log(brand.dim(`  ${shortId}`));
+    console.log();
+    if (agents.length === 0) {
+        logger.info('  No agents in this session.');
+        console.log();
+        return;
+    }
+    for (let i = 0; i < agents.length; i++) {
+        const a = agents[i];
+        const role = a.agentRole || 'unknown';
+        const model = a.model || 'default';
+        const type = a.agentType === 'Main Agent' ? brand.primary('MAIN') : brand.dim('SUB');
+        console.log(`  ${ui.statusIcon(a.status)} [${type}] ${brand.primary(role)} ${brand.dim(`(${model})`)}`);
+        if (a.prompt) {
+            const shortPrompt = a.prompt.length > 60 ? a.prompt.slice(0, 60) + '...' : a.prompt;
+            console.log(`    ${brand.dim('Prompt:')} ${shortPrompt}`);
+        }
+        if (a.tokenUsage) {
+            console.log(`    ${brand.dim('Tokens:')} ${a.tokenUsage.total.toLocaleString()} total`);
+        }
+        if (a.geminiSessionId) {
+            console.log(`    ${brand.dim('Gemini ID:')} ${a.geminiSessionId.slice(0, 8)}...`);
+        }
+    }
+    console.log();
+    console.log(brand.dim(`  Total: ${agents.length} agents`));
+    console.log();
+}
+/**
+ * Handle session init - Initialize a non-Gemini GemKit session
+ * Replaces: gk-init.cjs
+ */
+async function handleInit(appName, options) {
+    const env = readEnv();
+    const existingSessionId = env.ACTIVE_GK_SESSION_ID;
+    if (existingSessionId) {
+        // Parse PID from existing session ID
+        const parsed = parseGkSessionId(existingSessionId);
+        const projectDir = getProjectDir();
+        if (parsed) {
+            // Get current terminal PID to compare
+            const currentTerminalPid = getTerminalPid();
+            // Check if session exists and has same PID (same terminal)
+            const existingSession = getSession(projectDir, existingSessionId);
+            if (existingSession && parsed.pid === currentTerminalPid) {
+                // Session already exists for this terminal
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        status: 'existing',
+                        gkSessionId: existingSessionId,
+                        pid: parsed.pid
+                    }, null, 2));
+                }
+                else {
+                    console.log();
+                    logger.info(`GemKit session already active: ${brand.primary(existingSessionId.slice(0, 30) + '...')}`);
+                    console.log(brand.dim(`  PID: ${parsed.pid}`));
+                    console.log();
+                }
+                return;
+            }
+        }
+    }
+    // Initialize new non-Gemini session
+    const { session, gkSessionId, pid, projectDir } = initializeNonGeminiSession(appName);
+    // Add main agent entry to session
+    addAgent(projectDir, gkSessionId, {
+        gkSessionId: gkSessionId,
+        pid: pid,
+        geminiSessionId: null,
+        parentGkSessionId: null,
+        agentRole: 'main',
+        prompt: null,
+        model: null
+    });
+    if (options.json) {
+        console.log(JSON.stringify({
+            status: 'initialized',
+            gkSessionId: gkSessionId,
+            pid: pid,
+            projectDir: projectDir
+        }, null, 2));
+    }
+    else {
+        console.log();
+        logger.success(`GemKit session initialized: ${brand.primary(gkSessionId.slice(0, 30) + '...')}`);
+        console.log(brand.dim(`  PID: ${pid}`));
+        console.log();
+    }
+}

package/dist/commands/tokens/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tokens command - Session token usage analysis
+ * Matches token_stats.py --latest output format
+ */
+import type { CAC } from 'cac';
+export declare function registerTokensCommand(cli: CAC): void;