@rasensio/aidlc 0.1.0

package/dist/commands/start.js

@@ -0,0 +1,243 @@
+/**
+ * `aidlc start` command — begin a new lifecycle instance.
+ *
+ * Behavior:
+ * - Load templates from the package `templates/` dir and `.aidlc/templates/` (custom).
+ * - If no template argument is given:
+ *   - In interactive mode: list available templates and prompt for selection (Req 8.2).
+ *   - In non-interactive mode: exit with error.
+ * - Resolve the template (apply inheritance if needed).
+ * - Determine scope from `--scope` option or template default.
+ * - Determine initial phase based on scope (Req 5.1):
+ *   full → ideation, standard → requirements, micro → implementation.
+ * - Create instance namespace under `.aidlc/state/<name>/`.
+ * - Write `instance.yaml` with initial state.
+ * - Write initial `phase-<name>.yaml` files for all applicable phases (status: pending).
+ * - Print summary to stdout.
+ *
+ * Requirements: 5.1, 8.2, 23.1
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import * as clack from '@clack/prompts';
+import { loadTemplates, resolveTemplate, phasesForScope, } from '../core/template-resolver.js';
+import { saveSnapshot, createInstanceDir } from '../state/snapshot-store.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maps cycle scope to the initial phase (Req 5.1). */
+const INITIAL_PHASE = {
+    full: 'ideation',
+    standard: 'requirements',
+    micro: 'implementation',
+};
+const VALID_SCOPES = ['full', 'standard', 'micro'];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the package root directory.
+ */
+function getPackageRoot() {
+    const thisFile = fileURLToPath(import.meta.url);
+    return resolve(thisFile, '..', '..', '..');
+}
+/**
+ * Load all templates: built-in from the package + custom from the project.
+ */
+function loadAllTemplates(packageRoot, projectRoot) {
+    const builtInDir = join(packageRoot, 'templates');
+    const customDir = join(projectRoot, '.aidlc', 'templates');
+    const templates = loadTemplates(builtInDir);
+    // Custom templates override/supplement built-in ones
+    if (existsSync(customDir)) {
+        const custom = loadTemplates(customDir);
+        for (const [name, tpl] of custom) {
+            templates.set(name, tpl);
+        }
+    }
+    return templates;
+}
+/**
+ * Determine the creator identity from environment.
+ * Prefers git user, falls back to OS username.
+ */
+function getCreatorIdentity() {
+    // Try common env vars
+    return (process.env.USER ||
+        process.env.USERNAME ||
+        process.env.LOGNAME ||
+        'unknown');
+}
+/**
+ * Generate a URL-safe instance name from a template name.
+ * Appends a short timestamp suffix for uniqueness.
+ */
+function generateInstanceName(templateName) {
+    const base = templateName.replace(/[^a-z0-9-]/gi, '-').toLowerCase();
+    const suffix = Date.now().toString(36).slice(-6);
+    return `${base}-${suffix}`;
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc start` command on the given commander program.
+ */
+export function registerStart(program) {
+    program
+        .command('start')
+        .description('Begin a new lifecycle instance')
+        .argument('[template]', 'Workflow template to use')
+        .option('--name <instance-name>', 'Instance name (URL-safe)')
+        .option('--scope <scope>', `Cycle scope (${VALID_SCOPES.join(', ')})`)
+        .option('--non-interactive', 'Disable interactive prompts (for AI agents)')
+        .action(async (templateArg, opts) => {
+        await runStart(templateArg, opts);
+    });
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+async function runStart(templateArg, opts) {
+    const packageRoot = getPackageRoot();
+    const projectRoot = process.cwd();
+    const stateDir = join(projectRoot, '.aidlc', 'state');
+    // Load all available templates
+    const allTemplates = loadAllTemplates(packageRoot, projectRoot);
+    if (allTemplates.size === 0) {
+        process.stderr.write('Error: no templates found. Ensure the package templates/ directory exists.\n');
+        process.exitCode = 1;
+        return;
+    }
+    // Select template
+    let selectedTemplateName;
+    if (templateArg) {
+        if (!allTemplates.has(templateArg)) {
+            process.stderr.write(`Error: unknown template '${templateArg}'\n` +
+                `Available templates: ${[...allTemplates.keys()].join(', ')}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        selectedTemplateName = templateArg;
+    }
+    else if (opts.nonInteractive) {
+        process.stderr.write('Error: template must be specified in non-interactive mode.\n' +
+            `Available templates: ${[...allTemplates.keys()].join(', ')}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    else {
+        // Interactive: prompt for template selection (Req 8.2)
+        const templateOptions = [...allTemplates.entries()].map(([name, tpl]) => ({
+            value: name,
+            label: name,
+            hint: tpl.description || '',
+        }));
+        const selected = await clack.select({
+            message: 'Select a workflow template:',
+            options: templateOptions,
+        });
+        if (clack.isCancel(selected)) {
+            process.stderr.write('Cancelled.\n');
+            process.exitCode = 1;
+            return;
+        }
+        selectedTemplateName = selected;
+    }
+    // Resolve the template (apply inheritance)
+    const rawTemplate = allTemplates.get(selectedTemplateName);
+    let resolvedTemplate;
+    try {
+        resolvedTemplate = resolveTemplate(rawTemplate, allTemplates);
+    }
+    catch (err) {
+        process.stderr.write(`Error resolving template: ${err.message}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Determine scope
+    let scope;
+    if (opts.scope) {
+        if (!VALID_SCOPES.includes(opts.scope)) {
+            process.stderr.write(`Error: invalid scope '${opts.scope}'. Must be one of: ${VALID_SCOPES.join(', ')}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        scope = opts.scope;
+    }
+    else {
+        scope = resolvedTemplate.scope;
+    }
+    // Determine instance name
+    const instanceName = opts.name || generateInstanceName(selectedTemplateName);
+    // Check for existing instance with the same name
+    const instanceDir = join(stateDir, instanceName);
+    if (existsSync(instanceDir)) {
+        process.stderr.write(`Error: instance '${instanceName}' already exists.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Determine initial phase (Req 5.1)
+    const currentPhase = INITIAL_PHASE[scope];
+    // Get applicable phases for the scope
+    const applicablePhases = phasesForScope(resolvedTemplate, scope);
+    // Create instance namespace (Req 23.1)
+    createInstanceDir(stateDir, instanceName);
+    // Write instance.yaml
+    const now = new Date().toISOString();
+    const createdBy = getCreatorIdentity();
+    const instanceState = {
+        name: instanceName,
+        template: selectedTemplateName,
+        scope,
+        created_at: now,
+        created_by: createdBy,
+        current_phase: currentPhase,
+        claim: null,
+        scope_history: [],
+    };
+    saveSnapshot(stateDir, instanceName, 'instance.yaml', instanceState);
+    // Write phase-<name>.yaml for each applicable phase (status: pending)
+    for (const phase of applicablePhases) {
+        const artifacts = phase.required_artifacts.map((a) => ({
+            name: a.name,
+            status: 'not-started',
+        }));
+        // Include optional artifacts too if present
+        if (phase.optional_artifacts) {
+            for (const a of phase.optional_artifacts) {
+                artifacts.push({ name: a.name, status: 'not-started' });
+            }
+        }
+        const phaseState = {
+            phase: phase.name,
+            status: 'pending',
+            owner: null,
+            entered_at: null,
+            completed_at: null,
+            completed_by: null,
+            skip_reason: null,
+            artifacts,
+            metrics: {
+                elapsed_seconds: 0,
+                artifact_count: 0,
+            },
+        };
+        saveSnapshot(stateDir, instanceName, `phase-${phase.name}.yaml`, phaseState);
+    }
+    // Print summary to stdout
+    process.stdout.write(`\nLifecycle instance created:\n`);
+    process.stdout.write(`  Name:     ${instanceName}\n`);
+    process.stdout.write(`  Template: ${selectedTemplateName}\n`);
+    process.stdout.write(`  Scope:    ${scope}\n`);
+    process.stdout.write(`  Phase:    ${currentPhase}\n`);
+    process.stdout.write(`  Phases:   ${applicablePhases.map((p) => p.name).join(' → ')}\n`);
+    process.stdout.write(`  Path:     .aidlc/state/${instanceName}/\n`);
+    process.stdout.write(`\n`);
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AAWxC,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE7E,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,aAAa,GAAkC;IACnD,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,cAAc;IACxB,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF,MAAM,YAAY,GAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,SAAS,cAAc;IACrB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,WAAmB,EACnB,WAAmB;IAEnB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAE3D,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAE5C,qDAAqD;IACrD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;YACjC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB;IACzB,sBAAsB;IACtB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,IAAI;QAChB,OAAO,CAAC,GAAG,CAAC,QAAQ;QACpB,OAAO,CAAC,GAAG,CAAC,OAAO;QACnB,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,YAAoB;IAChD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAC;SAClD,MAAM,CAAC,wBAAwB,EAAE,0BAA0B,CAAC;SAC5D,MAAM,CACL,iBAAiB,EACjB,gBAAgB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3C;SACA,MAAM,CACL,mBAAmB,EACnB,6CAA6C,CAC9C;SACA,MAAM,CAAC,KAAK,EAAE,WAA+B,EAAE,IAAe,EAAE,EAAE;QACjE,MAAM,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACP,CAAC;AAQD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,KAAK,UAAU,QAAQ,CACrB,WAA+B,EAC/B,IAAe;IAEf,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEtD,+BAA+B;IAC/B,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEhE,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8EAA8E,CAC/E,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,kBAAkB;IAClB,IAAI,oBAA4B,CAAC;IAEjC,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4BAA4B,WAAW,KAAK;gBAC1C,wBAAwB,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAClE,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,oBAAoB,GAAG,WAAW,CAAC;IACrC,CAAC;SAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8DAA8D;YAC5D,wBAAwB,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAClE,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;SAAM,CAAC;QACN,uDAAuD;QACvD,MAAM,eAAe,GAAG,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACxE,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;SAC5B,CAAC,CAAC,CAAC;QAEJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;YAClC,OAAO,EAAE,6BAA6B;YACtC,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,oBAAoB,GAAG,QAAkB,CAAC;IAC5C,CAAC;IAED,2CAA2C;IAC3C,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,oBAAoB,CAAE,CAAC;IAC5D,IAAI,gBAAkC,CAAC;IACvC,IAAI,CAAC;QACH,gBAAgB,GAAG,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6BAA8B,GAAa,CAAC,OAAO,IAAI,CACxD,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,kBAAkB;IAClB,IAAI,KAAiB,CAAC;IACtB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAmB,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yBAAyB,IAAI,CAAC,KAAK,sBAAsB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACrF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,KAAK,GAAG,IAAI,CAAC,KAAmB,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,IAAI,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAE7E,iDAAiD;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACjD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oBAAoB,YAAY,qBAAqB,CACtD,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,oCAAoC;IACpC,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAE1C,sCAAsC;IACtC,MAAM,gBAAgB,GAAG,cAAc,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAEjE,uCAAuC;IACvC,iBAAiB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE1C,sBAAsB;IACtB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IAEvC,MAAM,aAAa,GAAkB;QACnC,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,oBAAoB;QAC9B,KAAK;QACL,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,YAAY;QAC3B,KAAK,EAAE,IAAI;QACX,aAAa,EAAE,EAAE;KAClB,CAAC;IAEF,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;IAErE,sEAAsE;IACtE,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAoB,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtE,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,aAAsB;SAC/B,CAAC,CAAC,CAAC;QAEJ,4CAA4C;QAC5C,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;gBACzC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAe;YAC7B,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,IAAI;YACjB,SAAS;YACT,OAAO,EAAE;gBACP,eAAe,EAAE,CAAC;gBAClB,cAAc,EAAE,CAAC;aAClB;SACF,CAAC;QAEF,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,KAAK,CAAC,IAAI,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/E,CAAC;IAED,0BAA0B;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,YAAY,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,oBAAoB,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,YAAY,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,YAAY,KAAK,CAAC,CAAC;IACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `aidlc status` command — show progress across active lifecycle instances.
+ *
+ * Behavior:
+ * - Scan `.aidlc/state/` for instance directories.
+ * - For each instance: load instance.yaml, load phase states, resolve template.
+ * - Compute: completionPercent, isStalled, current owner.
+ * - Output a table (default) or JSON array (with --json).
+ *
+ * Table columns: Name | Template | Phase | Completion | Owner | Stalled
+ *
+ * Options:
+ *   --json       Machine-readable JSON output (Req 9.2, 11.4)
+ *   --all        Include instances from all local branches (Req 23.6)
+ *
+ * Requirements: 11.1, 11.2, 11.3, 11.4
+ *
+ * @module
+ */
+import { Command } from 'commander';
+/**
+ * Register the `aidlc status` command on the given commander program.
+ */
+export declare function registerStatus(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoQpC;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASrD"}

package/dist/commands/status.js

@@ -0,0 +1,263 @@
+/**
+ * `aidlc status` command — show progress across active lifecycle instances.
+ *
+ * Behavior:
+ * - Scan `.aidlc/state/` for instance directories.
+ * - For each instance: load instance.yaml, load phase states, resolve template.
+ * - Compute: completionPercent, isStalled, current owner.
+ * - Output a table (default) or JSON array (with --json).
+ *
+ * Table columns: Name | Template | Phase | Completion | Owner | Stalled
+ *
+ * Options:
+ *   --json       Machine-readable JSON output (Req 9.2, 11.4)
+ *   --all        Include instances from all local branches (Req 23.6)
+ *
+ * Requirements: 11.1, 11.2, 11.3, 11.4
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { fileURLToPath } from 'node:url';
+import { listInstanceDirs, loadSnapshot } from '../state/snapshot-store.js';
+import { completionPercent, isStalled } from '../core/lifecycle.js';
+import { loadTemplates, resolveTemplate } from '../core/template-resolver.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Default stalled threshold in days (Req 11.3). */
+const DEFAULT_STALLED_THRESHOLD_DAYS = 7;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the package root directory.
+ */
+function getPackageRoot() {
+    const thisFile = fileURLToPath(import.meta.url);
+    return resolve(thisFile, '..', '..', '..');
+}
+/**
+ * Load all templates: built-in from the package + custom from the project.
+ */
+function loadAllTemplates(packageRoot, projectRoot) {
+    const builtInDir = join(packageRoot, 'templates');
+    const customDir = join(projectRoot, '.aidlc', 'templates');
+    const templates = loadTemplates(builtInDir);
+    if (existsSync(customDir)) {
+        const custom = loadTemplates(customDir);
+        for (const [name, tpl] of custom) {
+            templates.set(name, tpl);
+        }
+    }
+    return templates;
+}
+/**
+ * Load stalled threshold from project config if it exists.
+ */
+function loadStalledThreshold(projectRoot) {
+    const configPath = join(projectRoot, '.aidlc', 'config.yaml');
+    try {
+        if (existsSync(configPath)) {
+            const raw = readFileSync(configPath, 'utf8');
+            const config = parseYaml(raw);
+            if (config &&
+                typeof config.stalled_threshold_days === 'number' &&
+                config.stalled_threshold_days > 0) {
+                return config.stalled_threshold_days;
+            }
+        }
+    }
+    catch {
+        // Fall through to default
+    }
+    return DEFAULT_STALLED_THRESHOLD_DAYS;
+}
+/**
+ * Load all phase state files for a given instance.
+ *
+ * Scans for `phase-*.yaml` files in the instance directory.
+ */
+function loadPhaseStates(stateDir, instanceName) {
+    const phases = new Map();
+    const instanceDir = join(stateDir, instanceName);
+    let entries;
+    try {
+        entries = readdirSync(instanceDir);
+    }
+    catch {
+        return phases;
+    }
+    const phaseFiles = entries.filter((f) => f.startsWith('phase-') && f.endsWith('.yaml'));
+    for (const file of phaseFiles) {
+        try {
+            const phaseState = loadSnapshot(stateDir, instanceName, file);
+            if (phaseState && phaseState.phase) {
+                phases.set(phaseState.phase, phaseState);
+            }
+        }
+        catch {
+            // Skip corrupt phase files — status should still report what it can
+        }
+    }
+    return phases;
+}
+/**
+ * Determine the owner of an instance.
+ *
+ * Checks the current phase's owner first, then falls back to the instance claim session.
+ */
+function determineOwner(instanceState, phaseStates) {
+    // Check current phase owner
+    const currentPhase = phaseStates.get(instanceState.current_phase);
+    if (currentPhase?.owner) {
+        return currentPhase.owner;
+    }
+    // Fall back to instance claim
+    if (instanceState.claim?.session) {
+        return instanceState.claim.session;
+    }
+    return null;
+}
+/**
+ * Build an InstanceSummary for a single instance.
+ */
+function buildInstanceSummary(stateDir, instanceName, allTemplates, now, thresholdDays) {
+    // Load instance.yaml
+    let instanceState;
+    try {
+        instanceState = loadSnapshot(stateDir, instanceName, 'instance.yaml');
+    }
+    catch {
+        // Cannot load instance — skip with no output
+        return null;
+    }
+    // Load phase states
+    const phaseStates = loadPhaseStates(stateDir, instanceName);
+    // Resolve template
+    let resolvedTemplate = null;
+    const rawTemplate = allTemplates.get(instanceState.template);
+    if (rawTemplate) {
+        try {
+            resolvedTemplate = resolveTemplate(rawTemplate, allTemplates);
+        }
+        catch {
+            // Template resolution failed — use raw if it has phases
+            if (rawTemplate.phases && rawTemplate.phases.length > 0) {
+                resolvedTemplate = rawTemplate;
+            }
+        }
+    }
+    // Compute completion and stall
+    let percent = 0;
+    let stalled = false;
+    if (resolvedTemplate) {
+        percent = completionPercent(phaseStates, resolvedTemplate, instanceState.scope);
+        stalled = isStalled(instanceState, phaseStates, resolvedTemplate, now, thresholdDays);
+    }
+    // Determine owner
+    const owner = determineOwner(instanceState, phaseStates);
+    // Determine last updated — use the most recent entered_at or completed_at across phases
+    let lastUpdated = instanceState.created_at;
+    for (const [, ps] of phaseStates) {
+        if (ps.completed_at && ps.completed_at > lastUpdated) {
+            lastUpdated = ps.completed_at;
+        }
+        if (ps.entered_at && ps.entered_at > lastUpdated) {
+            lastUpdated = ps.entered_at;
+        }
+    }
+    return {
+        name: instanceState.name,
+        template: instanceState.template,
+        current_phase: instanceState.current_phase,
+        owner,
+        completion_percent: percent,
+        last_updated: lastUpdated,
+        stalled,
+    };
+}
+// ---------------------------------------------------------------------------
+// Output formatting
+// ---------------------------------------------------------------------------
+/**
+ * Render a text table from instance summaries.
+ *
+ * Columns: Name | Template | Phase | Completion | Owner | Stalled
+ */
+function renderTable(summaries) {
+    if (summaries.length === 0) {
+        return 'No active lifecycle instances.\n';
+    }
+    // Column headers
+    const headers = ['Name', 'Template', 'Phase', 'Completion', 'Owner', 'Stalled'];
+    // Build rows
+    const rows = summaries.map((s) => [
+        s.name,
+        s.template,
+        String(s.current_phase),
+        `${s.completion_percent}%`,
+        s.owner || '-',
+        s.stalled ? 'yes' : 'no',
+    ]);
+    // Calculate column widths
+    const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+    // Format header
+    const headerLine = headers
+        .map((h, i) => h.padEnd(colWidths[i]))
+        .join('  ');
+    const separator = colWidths.map((w) => '-'.repeat(w)).join('  ');
+    // Format rows
+    const dataLines = rows.map((row) => row.map((cell, i) => cell.padEnd(colWidths[i])).join('  '));
+    return [headerLine, separator, ...dataLines, ''].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc status` command on the given commander program.
+ */
+export function registerStatus(program) {
+    program
+        .command('status')
+        .description('Show progress across active lifecycle instances')
+        .option('--json', 'Output in JSON format for machine consumption')
+        .option('--all', 'Include instances from all local branches')
+        .action((opts) => {
+        runStatus(opts);
+    });
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+function runStatus(opts) {
+    const packageRoot = getPackageRoot();
+    const projectRoot = process.cwd();
+    const stateDir = join(projectRoot, '.aidlc', 'state');
+    // Load templates for resolving instance templates
+    const allTemplates = loadAllTemplates(packageRoot, projectRoot);
+    // Load configuration for stalled threshold
+    const thresholdDays = loadStalledThreshold(projectRoot);
+    const now = new Date();
+    // List all instance directories
+    const instanceNames = listInstanceDirs(stateDir);
+    // Build summaries
+    const summaries = [];
+    for (const name of instanceNames) {
+        const summary = buildInstanceSummary(stateDir, name, allTemplates, now, thresholdDays);
+        if (summary) {
+            summaries.push(summary);
+        }
+    }
+    // Output
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(summaries, null, 2) + '\n');
+    }
+    else {
+        process.stdout.write(renderTable(summaries));
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/transition.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `aidlc transition <instance>` command — evaluate gates and advance phase.
+ *
+ * Behavior:
+ * - Load instance state, phase states, and resolve template.
+ * - Call `evaluateTransition(state, phaseStates, template, actor, findings, override)`.
+ * - Call `nextStep(state, phaseStates, template)` to determine the target phase.
+ * - If transition is allowed:
+ *   - Update current_phase in instance.yaml to the next phase.
+ *   - Update source phase status to 'complete'.
+ *   - Update target phase status to 'in-progress'.
+ *   - Append a TransitionRecord to transitions.log.
+ *   - Fire on-phase-exit and on-phase-enter events.
+ *   - Print success message.
+ * - If blocked: print all violations, exit code 1.
+ *
+ * Options:
+ *   --override    Override ownership gate
+ *   --json        Output result as JSON
+ *
+ * Requirements: 3.6, 6.6, 11.5, 5.5
+ *
+ * @module
+ */
+import { Command } from 'commander';
+/**
+ * Register the `aidlc transition` command on the given commander program.
+ */
+export declare function registerTransition(program: Command): void;
+//# sourceMappingURL=transition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../../src/commands/transition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4KpC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUzD"}