@rasensio/aidlc 0.1.0

package/dist/commands/continue.js

@@ -0,0 +1,238 @@
+/**
+ * `aidlc continue` command — resume an in-progress lifecycle instance.
+ *
+ * Behavior:
+ * - Load instance state, phase states, and resolve template.
+ * - Call `nextStep(state, phaseStates, template)` from the lifecycle engine.
+ * - Based on the result:
+ *   - `artifact`: print what artifact to produce, with context about the phase.
+ *   - `phase`: print what phase to enter next.
+ *   - `complete`: print that the lifecycle is complete.
+ * - Output is a pre-built continuation prompt that can be pasted into any AI agent.
+ * - With `--json`: output `{ nextStep, prompt }` as JSON.
+ *
+ * Requirements: 26.1, 26.3
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { existsSync, readdirSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { nextStep } from '../core/lifecycle.js';
+import { loadTemplates, resolveTemplate, } from '../core/template-resolver.js';
+import { loadSnapshot, listInstanceDirs } from '../state/snapshot-store.js';
+// ---------------------------------------------------------------------------
+// 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;
+}
+/**
+ * Synchronously load all phase state files for a given instance.
+ */
+function loadPhaseStates(stateDir, instanceName) {
+    const instanceDir = join(stateDir, instanceName);
+    const phaseStates = new Map();
+    if (!existsSync(instanceDir)) {
+        return phaseStates;
+    }
+    let entries;
+    try {
+        entries = readdirSync(instanceDir);
+    }
+    catch {
+        return phaseStates;
+    }
+    for (const entry of entries) {
+        if (entry.startsWith('phase-') && entry.endsWith('.yaml')) {
+            const phaseName = entry.slice('phase-'.length, -'.yaml'.length);
+            try {
+                const ps = loadSnapshot(stateDir, instanceName, entry);
+                phaseStates.set(phaseName, ps);
+            }
+            catch {
+                // Skip unreadable phase files
+            }
+        }
+    }
+    return phaseStates;
+}
+/**
+ * Build the continuation prompt text based on the next step result.
+ */
+function buildPrompt(instanceName, step, currentPhase) {
+    switch (step.kind) {
+        case 'artifact': {
+            const skillFile = `aidlc-${step.phase}.md`;
+            return [
+                `You are continuing work on lifecycle instance "${instanceName}".`,
+                `Current phase: ${step.phase}.`,
+                `Next artifact to produce: ${step.artifact}`,
+                '',
+                `Read \`.aidlc/skills/${skillFile}\` for phase instructions.`,
+                `Read \`.aidlc/state/${instanceName}/instance.yaml\` for current state.`,
+            ].join('\n');
+        }
+        case 'phase': {
+            const skillFile = `aidlc-${step.phase}.md`;
+            return [
+                `You are continuing work on lifecycle instance "${instanceName}".`,
+                `Current phase "${currentPhase}" is complete.`,
+                `Next phase to enter: ${step.phase}.`,
+                '',
+                `Read \`.aidlc/skills/${skillFile}\` for phase instructions.`,
+                `Read \`.aidlc/state/${instanceName}/instance.yaml\` for current state.`,
+            ].join('\n');
+        }
+        case 'complete': {
+            return [
+                `Lifecycle instance "${instanceName}" is complete.`,
+                `All phases and artifacts have been finished.`,
+            ].join('\n');
+        }
+    }
+}
+/**
+ * Build the human-readable text output.
+ */
+function buildTextOutput(instanceName, step, currentPhase) {
+    const prompt = buildPrompt(instanceName, step, currentPhase);
+    const lines = [];
+    switch (step.kind) {
+        case 'artifact':
+            lines.push(`Next step for "${instanceName}":`);
+            lines.push(`  Phase: ${step.phase}`);
+            lines.push(`  Produce: ${step.artifact}`);
+            break;
+        case 'phase':
+            lines.push(`Next step for "${instanceName}":`);
+            lines.push(`  Enter phase: ${step.phase}`);
+            break;
+        case 'complete':
+            lines.push(`Lifecycle "${instanceName}" is complete.`);
+            break;
+    }
+    lines.push('');
+    lines.push('Prompt:');
+    lines.push('---');
+    lines.push(prompt);
+    lines.push('---');
+    lines.push('');
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc continue` command on the given commander program.
+ */
+export function registerContinue(program) {
+    program
+        .command('continue')
+        .description('Resume the active lifecycle instance from the next incomplete step')
+        .argument('[instance]', 'Instance name to continue')
+        .option('--json', 'Output as JSON')
+        .action(async (instanceArg, opts) => {
+        await runContinue(instanceArg, opts);
+    });
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+async function runContinue(instanceArg, opts) {
+    const packageRoot = getPackageRoot();
+    const projectRoot = process.cwd();
+    const stateDir = join(projectRoot, '.aidlc', 'state');
+    // List all instances
+    const instanceNames = listInstanceDirs(stateDir);
+    if (instanceNames.length === 0) {
+        process.stderr.write('Error: no active lifecycle instance found. Run `aidlc start` to create one.\n');
+        process.exitCode = 1;
+        return;
+    }
+    // Determine which instance to continue
+    let targetInstance;
+    if (instanceArg) {
+        if (!instanceNames.includes(instanceArg)) {
+            process.stderr.write(`Error: instance '${instanceArg}' not found.\n` +
+                `Available instances: ${instanceNames.join(', ')}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        targetInstance = instanceArg;
+    }
+    else if (instanceNames.length === 1) {
+        // Only one instance — use it directly
+        targetInstance = instanceNames[0];
+    }
+    else {
+        // Multiple instances and no argument provided
+        process.stderr.write('Error: multiple active instances found. Specify which to continue:\n' +
+            instanceNames.map((n) => `  - ${n}`).join('\n') +
+            '\n');
+        process.exitCode = 1;
+        return;
+    }
+    // Load instance state
+    let instanceState;
+    try {
+        instanceState = loadSnapshot(stateDir, targetInstance, 'instance.yaml');
+    }
+    catch (err) {
+        process.stderr.write(`Error: failed to load instance state: ${err.message}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Load phase states
+    const phaseStates = loadPhaseStates(stateDir, targetInstance);
+    // Load and resolve template
+    const allTemplates = loadAllTemplates(packageRoot, projectRoot);
+    const rawTemplate = allTemplates.get(instanceState.template);
+    if (!rawTemplate) {
+        process.stderr.write(`Error: template '${instanceState.template}' not found.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    let resolvedTemplate;
+    try {
+        resolvedTemplate = resolveTemplate(rawTemplate, allTemplates);
+    }
+    catch (err) {
+        process.stderr.write(`Error resolving template: ${err.message}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Call nextStep
+    const step = nextStep(instanceState, phaseStates, resolvedTemplate);
+    // Output
+    if (opts.json) {
+        const prompt = buildPrompt(targetInstance, step, instanceState.current_phase);
+        const output = { nextStep: step, prompt };
+        process.stdout.write(JSON.stringify(output, null, 2) + '\n');
+    }
+    else {
+        const text = buildTextOutput(targetInstance, step, instanceState.current_phase);
+        process.stdout.write(text);
+    }
+}
+//# sourceMappingURL=continue.js.map

package/dist/commands/continue.js.map

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

package/dist/commands/discover.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `aidlc discover` command — scan codebase and generate Context_Docs.
+ *
+ * Behavior:
+ * - Call `scanCodebase(process.cwd())` to analyze the project.
+ * - Call `writeContextDocs(cwd, result)` to produce Context_Docs in `.aidlc/context/`.
+ * - Print a human-readable summary to stdout: primary language, frameworks, conventions.
+ * - With `--json`: output the full ScanResult as JSON.
+ *
+ * Requirements: 15.1, 15.3, 15.10
+ *
+ * @module
+ */
+import { Command } from 'commander';
+/**
+ * Register the `aidlc discover` command on the given commander program.
+ */
+export declare function registerDiscover(program: Command): void;
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/commands/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuDpC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsBvD"}

package/dist/commands/discover.js

@@ -0,0 +1,85 @@
+/**
+ * `aidlc discover` command — scan codebase and generate Context_Docs.
+ *
+ * Behavior:
+ * - Call `scanCodebase(process.cwd())` to analyze the project.
+ * - Call `writeContextDocs(cwd, result)` to produce Context_Docs in `.aidlc/context/`.
+ * - Print a human-readable summary to stdout: primary language, frameworks, conventions.
+ * - With `--json`: output the full ScanResult as JSON.
+ *
+ * Requirements: 15.1, 15.3, 15.10
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { scanCodebase, writeContextDocs } from '../discover/scanner.js';
+// ---------------------------------------------------------------------------
+// Summary renderer
+// ---------------------------------------------------------------------------
+/**
+ * Format a human-readable summary from the scan result.
+ */
+function formatSummary(result, docPaths) {
+    const lines = [];
+    // Languages
+    if (result.languages.length > 0) {
+        const langParts = result.languages
+            .slice(0, 5)
+            .map((l) => `${l.name} (${l.percentage}%)`);
+        lines.push(`Discovered: ${langParts.join(', ')}`);
+    }
+    else {
+        lines.push('Discovered: no source files detected');
+    }
+    // Frameworks
+    if (result.frameworks.length > 0) {
+        lines.push(`Frameworks: ${result.frameworks.join(', ')}`);
+    }
+    else {
+        lines.push('Frameworks: none detected');
+    }
+    // Conventions
+    const conventions = [];
+    if (result.conventions.indentation !== 'unknown') {
+        conventions.push(`${result.conventions.indentation} indentation`);
+    }
+    if (result.conventions.naming !== 'unknown') {
+        conventions.push(`${result.conventions.naming} naming`);
+    }
+    if (conventions.length > 0) {
+        lines.push(`Conventions: ${conventions.join(', ')}`);
+    }
+    // Context docs written
+    if (docPaths.length > 0) {
+        lines.push(`Context docs written: ${docPaths.join(', ')}`);
+    }
+    return lines.join('\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc discover` command on the given commander program.
+ */
+export function registerDiscover(program) {
+    program
+        .command('discover')
+        .description('Scan codebase and generate context documents')
+        .option('--json', 'Output full scan result as JSON')
+        .action((opts) => {
+        const cwd = process.cwd();
+        // Run the scanner
+        const result = scanCodebase(cwd);
+        // Write Context_Docs
+        const docPaths = writeContextDocs(cwd, result);
+        // Output
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        }
+        else {
+            const summary = formatSummary(result, docPaths);
+            process.stdout.write(summary);
+        }
+    });
+}
+//# sourceMappingURL=discover.js.map

package/dist/commands/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/commands/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGxE,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,SAAS,aAAa,CAAC,MAAkB,EAAE,QAAkB;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,YAAY;IACZ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS;aAC/B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACrD,CAAC;IAED,aAAa;IACb,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC1C,CAAC;IAED,cAAc;IACd,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,MAAM,CAAC,WAAW,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACjD,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,cAAc,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,SAAS,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,uBAAuB;IACvB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;SACnD,MAAM,CAAC,CAAC,IAAwB,EAAE,EAAE;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE1B,kBAAkB;QAClB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAEjC,qBAAqB;QACrB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAE/C,SAAS;QACT,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/docs.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `aidlc docs` command — generate onboarding documentation.
+ *
+ * Produces `.aidlc/ONBOARDING.md` explaining the AIDLC framework to new
+ * contributors. The content is assembled from the project's actual configuration:
+ * - Available workflow templates
+ * - Available phase guidance (skills)
+ * - Guidance layers from index.yaml
+ * - Quick-start commands
+ *
+ * Requirements: 12.1, 12.6
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import type { WorkflowTemplate, GuidanceIndexEntry } from '../core/types.js';
+/**
+ * Generate the ONBOARDING.md content from project configuration.
+ */
+export declare function generateOnboardingContent(templates: Map<string, WorkflowTemplate>, skillNames: string[], guidanceLayers: GuidanceIndexEntry[]): string;
+/**
+ * Register the `aidlc docs` command on the given commander program.
+ */
+export declare function registerDocs(program: Command): void;
+//# sourceMappingURL=docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAmF7E;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACxC,UAAU,EAAE,MAAM,EAAE,EACpB,cAAc,EAAE,kBAAkB,EAAE,GACnC,MAAM,CA2JR;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOnD"}

package/dist/commands/docs.js

@@ -0,0 +1,282 @@
+/**
+ * `aidlc docs` command — generate onboarding documentation.
+ *
+ * Produces `.aidlc/ONBOARDING.md` explaining the AIDLC framework to new
+ * contributors. The content is assembled from the project's actual configuration:
+ * - Available workflow templates
+ * - Available phase guidance (skills)
+ * - Guidance layers from index.yaml
+ * - Quick-start commands
+ *
+ * Requirements: 12.1, 12.6
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { existsSync, mkdirSync, writeFileSync, readdirSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml } from 'yaml';
+import { loadTemplates, resolveTemplate } from '../core/template-resolver.js';
+// ---------------------------------------------------------------------------
+// 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 skill names from the skills/ directory.
+ */
+function loadSkillNames(packageRoot) {
+    const skillsDir = join(packageRoot, 'skills');
+    if (!existsSync(skillsDir)) {
+        return [];
+    }
+    return readdirSync(skillsDir)
+        .filter((f) => f.endsWith('.md'))
+        .sort()
+        .map((f) => f.replace(/\.md$/, ''));
+}
+/**
+ * Load guidance layer entries from the project or package guidance index.
+ */
+function loadGuidanceEntries(projectRoot, packageRoot) {
+    // First try project-level guidance
+    const projectIndex = join(projectRoot, '.aidlc', 'guidance', 'index.yaml');
+    // Fall back to package-level guidance
+    const packageIndex = join(packageRoot, 'guidance', 'index.yaml');
+    const indexPath = existsSync(projectIndex) ? projectIndex : packageIndex;
+    if (!existsSync(indexPath)) {
+        return [];
+    }
+    try {
+        const raw = readFileSync(indexPath, 'utf8');
+        const data = parseYaml(raw);
+        if (data && Array.isArray(data.layers)) {
+            return data.layers;
+        }
+    }
+    catch {
+        // Ignore parse errors — guidance is optional
+    }
+    return [];
+}
+// ---------------------------------------------------------------------------
+// Content generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate the ONBOARDING.md content from project configuration.
+ */
+export function generateOnboardingContent(templates, skillNames, guidanceLayers) {
+    const lines = [];
+    // Header
+    lines.push('# AIDLC Framework — Onboarding Guide');
+    lines.push('');
+    lines.push('Welcome! This project uses the **AI Development Lifecycle (AIDLC)** framework');
+    lines.push('to provide structured, phase-driven guidance for AI-assisted development.');
+    lines.push('');
+    // What is AIDLC?
+    lines.push('## What is AIDLC?');
+    lines.push('');
+    lines.push('AIDLC is a lightweight framework that defines lifecycle phases (Ideation through');
+    lines.push('Maintenance), persists state in version-controlled files, and provides skills');
+    lines.push('that guide AI coding agents through each phase. It works across platforms');
+    lines.push('(Claude Code, Kiro, Cursor, Windsurf, Codex) and supports bare LLM endpoints.');
+    lines.push('');
+    // Available workflows
+    lines.push('## Available Workflow Templates');
+    lines.push('');
+    if (templates.size === 0) {
+        lines.push('_No templates found._');
+    }
+    else {
+        lines.push('| Template | Scope | Description |');
+        lines.push('|----------|-------|-------------|');
+        for (const [name, tpl] of templates) {
+            const desc = tpl.description || '—';
+            lines.push(`| ${name} | ${tpl.scope} | ${desc} |`);
+        }
+    }
+    lines.push('');
+    // Phases
+    lines.push('## Lifecycle Phases');
+    lines.push('');
+    lines.push('The standard AIDLC phases in order:');
+    lines.push('');
+    lines.push('1. **Ideation** — Explore the problem space, define goals and constraints');
+    lines.push('2. **Requirements** — Write acceptance criteria and user stories');
+    lines.push('3. **Design** — Architecture decisions, interfaces, data models');
+    lines.push('4. **Implementation** — Produce code following the design');
+    lines.push('5. **Testing** — Verify against requirements');
+    lines.push('6. **Deployment** — Release preparation and execution');
+    lines.push('7. **Maintenance** — Monitoring, iteration, documentation');
+    lines.push('');
+    lines.push('Not all phases apply to every task. The scope determines which phases are active:');
+    lines.push('');
+    lines.push('- **Full** — All 7 phases (starts at Ideation)');
+    lines.push('- **Standard** — Requirements through Deployment');
+    lines.push('- **Micro** — Implementation and Testing only');
+    lines.push('');
+    // Reading state
+    lines.push('## Reading Lifecycle State');
+    lines.push('');
+    lines.push('All state is stored under `.aidlc/state/<instance-name>/`:');
+    lines.push('');
+    lines.push('| File | Purpose |');
+    lines.push('|------|---------|');
+    lines.push('| `instance.yaml` | Instance metadata: template, scope, current phase, claim |');
+    lines.push('| `phase-<name>.yaml` | Per-phase status, artifacts, metrics |');
+    lines.push('| `transitions.log` | Append-only NDJSON log of all phase transitions |');
+    lines.push('');
+    lines.push('### instance.yaml');
+    lines.push('');
+    lines.push('```yaml');
+    lines.push('name: my-feature');
+    lines.push('template: full-feature');
+    lines.push('scope: full');
+    lines.push('current_phase: design');
+    lines.push('claim: null');
+    lines.push('```');
+    lines.push('');
+    lines.push('### phase-<name>.yaml');
+    lines.push('');
+    lines.push('```yaml');
+    lines.push('phase: requirements');
+    lines.push('status: complete        # pending | in-progress | complete | skipped');
+    lines.push('artifacts:');
+    lines.push('  - { name: requirements.md, status: complete }');
+    lines.push('```');
+    lines.push('');
+    lines.push('### transitions.log');
+    lines.push('');
+    lines.push('Each line is a JSON object:');
+    lines.push('');
+    lines.push('```json');
+    lines.push('{"at":"2025-01-15T10:00:00Z","by":"developer","from":"requirements","to":"design","type":"normal"}');
+    lines.push('```');
+    lines.push('');
+    // Skills
+    lines.push('## Available Skills');
+    lines.push('');
+    if (skillNames.length === 0) {
+        lines.push('_No skills found._');
+    }
+    else {
+        lines.push('Skills provide phase-specific guidance to AI agents:');
+        lines.push('');
+        for (const name of skillNames) {
+            lines.push(`- \`${name}\``);
+        }
+    }
+    lines.push('');
+    // Guidance layers
+    lines.push('## Guidance Layers');
+    lines.push('');
+    if (guidanceLayers.length === 0) {
+        lines.push('_No guidance layers configured._');
+    }
+    else {
+        lines.push('Guidance layers provide domain-specific rules referenced during implementation:');
+        lines.push('');
+        for (const layer of guidanceLayers) {
+            lines.push(`- **${layer.name}** — \`${layer.file}\``);
+        }
+    }
+    lines.push('');
+    // Quick-start commands
+    lines.push('## Quick-Start Commands');
+    lines.push('');
+    lines.push('```bash');
+    lines.push('# Start a new lifecycle instance');
+    lines.push('aidlc start [template]');
+    lines.push('');
+    lines.push('# Check lifecycle status');
+    lines.push('aidlc status');
+    lines.push('');
+    lines.push('# CI/CD gate check (exit 0 if phase complete)');
+    lines.push('aidlc gate <phase>');
+    lines.push('');
+    lines.push('# Advance to the next phase');
+    lines.push('aidlc transition --to <phase>');
+    lines.push('');
+    lines.push('# Resume work on an instance');
+    lines.push('aidlc continue');
+    lines.push('');
+    lines.push('# Generate platform-specific skills');
+    lines.push('aidlc init --platform <name>');
+    lines.push('```');
+    lines.push('');
+    // Further reading
+    lines.push('## Further Reading');
+    lines.push('');
+    lines.push('- Run `aidlc help [phase]` for details on any phase');
+    lines.push('- Check `.aidlc/context/` for project-specific style and architecture docs');
+    lines.push('- See `.aidlc/guidance/` for active guidance layers');
+    lines.push('- Templates live in `.aidlc/templates/` (custom) and the package `templates/` dir');
+    lines.push('');
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc docs` command on the given commander program.
+ */
+export function registerDocs(program) {
+    program
+        .command('docs')
+        .description('Generate onboarding documentation (.aidlc/ONBOARDING.md)')
+        .action(async () => {
+        await runDocs();
+    });
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+async function runDocs() {
+    const packageRoot = getPackageRoot();
+    const projectRoot = process.cwd();
+    // Load templates
+    const templates = loadAllTemplates(packageRoot, projectRoot);
+    if (templates.size === 0) {
+        process.stderr.write('Error: no workflow templates found. Cannot generate documentation.\n' +
+            'Ensure the package templates/ directory exists or add custom templates to .aidlc/templates/.\n');
+        process.exitCode = 1;
+        return;
+    }
+    // Load skill names
+    const skillNames = loadSkillNames(packageRoot);
+    // Load guidance layers
+    const guidanceLayers = loadGuidanceEntries(projectRoot, packageRoot);
+    // Generate content
+    const content = generateOnboardingContent(templates, skillNames, guidanceLayers);
+    // Ensure .aidlc/ directory exists
+    const aidlcDir = join(projectRoot, '.aidlc');
+    if (!existsSync(aidlcDir)) {
+        mkdirSync(aidlcDir, { recursive: true });
+    }
+    // Write the file
+    const outputPath = join(aidlcDir, 'ONBOARDING.md');
+    writeFileSync(outputPath, content, 'utf8');
+    process.stdout.write(`Wrote ${outputPath}\n`);
+}
+//# sourceMappingURL=docs.js.map