@rasensio/aidlc 0.1.0

package/dist/commands/review.js

@@ -0,0 +1,264 @@
+/**
+ * `aidlc review` command — invoke adversarial review on an artifact.
+ *
+ * Behavior:
+ * - `aidlc review <instance> <artifact>` — create or show findings for an artifact.
+ * - Writes structured findings to `.aidlc/state/<instance>/<artifact>.review.md`.
+ * - In non-orchestrator mode: creates a placeholder findings file and prints
+ *   instructions for manual review (the skill `80-review.md` guides AI agents).
+ * - With `--json`: output findings structure as JSON.
+ * - Integrates with review gate: `evaluateTransition` already checks for `*.review.md`
+ *   files and parses findings from them.
+ *
+ * Requirements: 24.1, 24.2, 24.4
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { atomicWrite, instancePath } from '../state/snapshot-store.js';
+// ---------------------------------------------------------------------------
+// Findings file parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a review findings markdown file into structured data.
+ *
+ * Expected format:
+ * ```
+ * ---
+ * artifact: <filename>
+ * reviewed_at: <ISO 8601>
+ * reviewer: <session-id>
+ * ---
+ *
+ * ## Finding 1
+ * - **Severity:** critical | major | minor | info
+ * - **Section:** <reference>
+ * - **Issue:** <description>
+ * - **Suggestion:** <resolution>
+ * - **Status:** open | resolved | accepted-risk | rejected
+ * ```
+ */
+export function parseFindingsFile(content) {
+    const meta = parseFrontmatter(content);
+    const findings = parseFindings(content);
+    return {
+        artifact: meta.artifact,
+        reviewed_at: meta.reviewed_at,
+        reviewer: meta.reviewer,
+        findings,
+    };
+}
+/**
+ * Parse YAML-like frontmatter from the findings file.
+ */
+function parseFrontmatter(content) {
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch) {
+        return { artifact: '', reviewed_at: '', reviewer: '' };
+    }
+    const fmBlock = fmMatch[1];
+    const artifact = extractField(fmBlock, 'artifact') ?? '';
+    const reviewed_at = extractField(fmBlock, 'reviewed_at') ?? '';
+    const reviewer = extractField(fmBlock, 'reviewer') ?? '';
+    return { artifact, reviewed_at, reviewer };
+}
+/**
+ * Extract a simple key: value field from a YAML block.
+ */
+function extractField(block, key) {
+    const regex = new RegExp(`^${key}:\\s*(.+)$`, 'm');
+    const match = block.match(regex);
+    return match ? match[1].trim() : undefined;
+}
+/**
+ * Parse finding blocks from the markdown body.
+ */
+function parseFindings(content) {
+    const findings = [];
+    // Remove frontmatter
+    const bodyMatch = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)/);
+    const body = bodyMatch ? bodyMatch[1] : content;
+    // Split on ## Finding N or ## F<N>: headings
+    const findingBlocks = body.split(/^## /m).filter((b) => b.trim().length > 0);
+    for (const block of findingBlocks) {
+        const finding = parseSingleFinding(block, findings.length + 1);
+        if (finding) {
+            findings.push(finding);
+        }
+    }
+    return findings;
+}
+/**
+ * Parse a single finding block.
+ */
+function parseSingleFinding(block, index) {
+    const lines = block.split('\n');
+    const titleLine = lines[0]?.trim() ?? '';
+    // Extract title — may be "Finding 1" or "F1: Title [severity] [status]"
+    const titleMatch = titleLine.match(/^(?:Finding\s+\d+|F\d+)(?::\s*(.+?))?(?:\s*\[(\w+)\]\s*\[(\w+)\])?$/i);
+    const title = titleMatch?.[1]?.trim() ?? titleLine;
+    // Parse fields from bullet points
+    const severity = extractBulletField(block, 'Severity');
+    const section = extractBulletField(block, 'Section');
+    const issue = extractBulletField(block, 'Issue');
+    const suggestion = extractBulletField(block, 'Suggestion');
+    const status = extractBulletField(block, 'Status');
+    // A finding must have at least a severity to be valid
+    if (!severity && !titleMatch?.[2]) {
+        return null;
+    }
+    const effectiveSeverity = (severity ?? titleMatch?.[2] ?? 'info');
+    const effectiveStatus = (status ?? titleMatch?.[3] ?? 'open');
+    return {
+        id: `F${index}`,
+        title: title || `Finding ${index}`,
+        severity: effectiveSeverity,
+        status: effectiveStatus,
+        section: section ?? undefined,
+        issue: issue ?? undefined,
+        suggested_resolution: suggestion ?? undefined,
+    };
+}
+/**
+ * Extract a bullet field value: `- **FieldName:** value`
+ */
+function extractBulletField(block, fieldName) {
+    const regex = new RegExp(`^\\s*-\\s*\\*\\*${fieldName}:\\*\\*\\s*(.+)$`, 'mi');
+    const match = block.match(regex);
+    return match ? match[1].trim() : undefined;
+}
+// ---------------------------------------------------------------------------
+// Findings file generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate a placeholder findings file for manual review.
+ */
+export function generatePlaceholderFindings(artifactName, reviewer) {
+    const now = new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+    return `---
+artifact: ${artifactName}
+reviewed_at: ${now}
+reviewer: ${reviewer}
+---
+
+## Finding 1
+- **Severity:** info
+- **Section:** (pending review)
+- **Issue:** Review has not yet been performed. Run this command with an AI agent or perform manual review following the instructions in skills/80-review.md.
+- **Suggestion:** Complete the adversarial review for this artifact.
+- **Status:** open
+`;
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc review` command on the given commander program.
+ */
+export function registerReview(program) {
+    program
+        .command('review')
+        .description('Run an adversarial review of a lifecycle artifact, recording structured findings')
+        .argument('<instance>', 'Lifecycle instance name')
+        .argument('<artifact>', 'Artifact filename to review (e.g., requirements.md)')
+        .option('--json', 'Output findings as structured JSON')
+        .action((instance, artifact, opts) => {
+        runReview(instance, artifact, opts);
+    });
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+function runReview(instanceArg, artifactArg, opts) {
+    const projectRoot = process.cwd();
+    const stateDir = join(projectRoot, '.aidlc', 'state');
+    // Validate instance exists
+    const instDir = instancePath(stateDir, instanceArg);
+    if (!existsSync(instDir)) {
+        process.stderr.write(`Error: instance '${instanceArg}' not found.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Check if a findings file already exists
+    const findingsFileName = `${artifactArg}.review.md`;
+    const findingsFilePath = join(instDir, findingsFileName);
+    if (existsSync(findingsFilePath)) {
+        // Read and output existing findings
+        const content = readFileSync(findingsFilePath, 'utf8');
+        const parsed = parseFindingsFile(content);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(parsed, null, 2) + '\n');
+        }
+        else {
+            printFindingsSummary(parsed);
+        }
+        return;
+    }
+    // No findings file exists — create a placeholder
+    const reviewer = getReviewerIdentity();
+    const placeholder = generatePlaceholderFindings(artifactArg, reviewer);
+    // Write the findings file atomically
+    atomicWrite(findingsFilePath, placeholder);
+    // Parse what we just wrote for output
+    const parsed = parseFindingsFile(placeholder);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(parsed, null, 2) + '\n');
+    }
+    else {
+        process.stdout.write(`Review findings file created:\n`);
+        process.stdout.write(`  ${findingsFileName}\n\n`);
+        process.stdout.write(`Location: .aidlc/state/${instanceArg}/${findingsFileName}\n\n`);
+        process.stdout.write(`Next steps:\n`);
+        process.stdout.write(`  1. Run an adversarial review using an AI agent (skill: 80-review.md)\n`);
+        process.stdout.write(`  2. Or manually edit the findings file to record review results\n`);
+        process.stdout.write(`  3. The review gate will block phase transitions while critical findings are open\n`);
+        process.stdout.write(`\n`);
+        printFindingsSummary(parsed);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Determine reviewer identity from environment.
+ */
+function getReviewerIdentity() {
+    return (process.env.AIDLC_SESSION ||
+        process.env.USER ||
+        process.env.USERNAME ||
+        process.env.LOGNAME ||
+        'unknown');
+}
+/**
+ * Print a human-readable findings summary.
+ */
+function printFindingsSummary(output) {
+    const { findings } = output;
+    process.stdout.write(`Review summary for "${output.artifact}":\n`);
+    process.stdout.write(`  Reviewed at: ${output.reviewed_at}\n`);
+    process.stdout.write(`  Reviewer:    ${output.reviewer}\n`);
+    process.stdout.write(`  Findings:    ${findings.length}\n`);
+    if (findings.length === 0) {
+        process.stdout.write(`  No findings recorded.\n`);
+        return;
+    }
+    // Count by severity
+    const bySeverity = {};
+    for (const f of findings) {
+        bySeverity[f.severity] = (bySeverity[f.severity] || 0) + 1;
+    }
+    process.stdout.write(`\n  By severity:\n`);
+    for (const sev of ['critical', 'major', 'minor', 'info']) {
+        if (bySeverity[sev]) {
+            process.stdout.write(`    ${sev}: ${bySeverity[sev]}\n`);
+        }
+    }
+    // Check if critical open findings exist (blocks transition)
+    const criticalOpen = findings.filter((f) => f.severity === 'critical' && f.status === 'open');
+    if (criticalOpen.length > 0) {
+        process.stdout.write(`\n  ⚠ ${criticalOpen.length} critical finding(s) with status "open" — review gate will block phase transition.\n`);
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/commands/review.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `aidlc setup` command — interactive setup or update of AIDLC configuration.
+ *
+ * Behavior:
+ * - Detect existing `.aidlc/config.yaml` → update mode vs fresh-setup mode.
+ * - In interactive mode: use @clack/prompts to collect SetupAnswers.
+ * - In non-interactive mode (`--non-interactive`): use empty answers (preserve
+ *   existing or apply defaults).
+ * - Call `computeSetup(existingConfig, answers)` to produce the config.
+ * - Write the result to `.aidlc/config.yaml` using `saveYaml`.
+ * - Run `aidlc init` for each configured platform.
+ * - Run `aidlc discover` to generate context docs.
+ * - Print summary.
+ *
+ * Requirements: 21.1, 21.9, 7.8
+ *
+ * @module
+ */
+import { Command } from 'commander';
+/**
+ * Register the `aidlc setup` command on the given commander program.
+ */
+export declare function registerSetup(program: Command): void;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+HpC;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQpD"}

package/dist/commands/setup.js

@@ -0,0 +1,206 @@
+/**
+ * `aidlc setup` command — interactive setup or update of AIDLC configuration.
+ *
+ * Behavior:
+ * - Detect existing `.aidlc/config.yaml` → update mode vs fresh-setup mode.
+ * - In interactive mode: use @clack/prompts to collect SetupAnswers.
+ * - In non-interactive mode (`--non-interactive`): use empty answers (preserve
+ *   existing or apply defaults).
+ * - Call `computeSetup(existingConfig, answers)` to produce the config.
+ * - Write the result to `.aidlc/config.yaml` using `saveYaml`.
+ * - Run `aidlc init` for each configured platform.
+ * - Run `aidlc discover` to generate context docs.
+ * - Print summary.
+ *
+ * Requirements: 21.1, 21.9, 7.8
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import * as clack from '@clack/prompts';
+import { computeSetup } from '../setup/setup-compute.js';
+import { loadYaml, saveYaml } from '../state/yaml-helpers.js';
+import { supportedPlatforms } from '../compile/adapters/index.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const PROJECT_TYPES = ['web-app', 'library', 'cli', 'api'];
+const COMPLEXITIES = ['simple', 'moderate', 'complex'];
+const AVAILABLE_TEMPLATES = ['micro-task', 'full-feature', 'quick-feature', 'bugfix', 'spike'];
+const AVAILABLE_SCOPES = ['full', 'standard', 'micro'];
+/**
+ * Mapping from complexity to default scope and template (Req 21.5).
+ */
+const COMPLEXITY_DEFAULTS = {
+    simple: { scope: 'micro', template: 'micro-task' },
+    moderate: { scope: 'standard', template: 'quick-feature' },
+    complex: { scope: 'full', template: 'full-feature' },
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Load existing config from `.aidlc/config.yaml`, or null if it doesn't exist.
+ */
+function loadExistingConfig(projectRoot) {
+    const configPath = join(projectRoot, '.aidlc', 'config.yaml');
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        return loadYaml(configPath);
+    }
+    catch {
+        // Malformed config → treat as fresh setup
+        return null;
+    }
+}
+/**
+ * Collect answers interactively using @clack/prompts.
+ */
+async function collectInteractiveAnswers(existing) {
+    clack.intro('aidlc setup');
+    if (existing) {
+        clack.note(`Existing configuration found. Current platforms: ${existing.platforms.join(', ') || 'none'}\n` +
+            `Scope: ${existing.defaults.scope}, Template: ${existing.defaults.template}`, 'Update mode');
+    }
+    // Project type
+    const projectType = await clack.select({
+        message: 'Project type:',
+        options: PROJECT_TYPES.map((t) => ({ value: t, label: t })),
+    });
+    if (clack.isCancel(projectType))
+        return null;
+    // Complexity
+    const complexity = await clack.select({
+        message: 'Complexity:',
+        options: COMPLEXITIES.map((c) => ({
+            value: c,
+            label: c,
+            hint: c === 'simple'
+                ? 'tasks then execution only'
+                : c === 'complex'
+                    ? 'all phases including requirements and design'
+                    : 'requirements, design, implementation',
+        })),
+    });
+    if (clack.isCancel(complexity))
+        return null;
+    // Platforms
+    const platforms = await clack.multiselect({
+        message: 'Platforms to support:',
+        options: supportedPlatforms.map((p) => ({
+            value: p,
+            label: p,
+        })),
+        required: false,
+    });
+    if (clack.isCancel(platforms))
+        return null;
+    // Default template
+    const template = await clack.select({
+        message: 'Default template:',
+        options: AVAILABLE_TEMPLATES.map((t) => ({ value: t, label: t })),
+        initialValue: COMPLEXITY_DEFAULTS[complexity]?.template ?? 'micro-task',
+    });
+    if (clack.isCancel(template))
+        return null;
+    // Default scope
+    const scope = await clack.select({
+        message: 'Default scope:',
+        options: AVAILABLE_SCOPES.map((s) => ({ value: s, label: s })),
+        initialValue: COMPLEXITY_DEFAULTS[complexity]?.scope ?? 'micro',
+    });
+    if (clack.isCancel(scope))
+        return null;
+    return {
+        projectType: projectType,
+        complexity: complexity,
+        platforms: platforms,
+        template: template,
+        scope: scope,
+    };
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc setup` command on the given commander program.
+ */
+export function registerSetup(program) {
+    program
+        .command('setup')
+        .description('Interactive setup or update of AIDLC configuration')
+        .option('--non-interactive', 'Skip prompts, use defaults or existing config')
+        .action(async (opts) => {
+        await runSetup(opts);
+    });
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+async function runSetup(opts) {
+    const projectRoot = process.cwd();
+    const configPath = join(projectRoot, '.aidlc', 'config.yaml');
+    // Load existing config
+    const existing = loadExistingConfig(projectRoot);
+    const isUpdate = existing !== null;
+    let answers;
+    if (opts.nonInteractive) {
+        // Non-interactive: use empty answers (preserve existing or apply defaults)
+        answers = {};
+    }
+    else {
+        // Interactive: collect answers via prompts
+        const collected = await collectInteractiveAnswers(existing);
+        if (collected === null) {
+            process.stderr.write('Setup cancelled.\n');
+            process.exitCode = 1;
+            return;
+        }
+        answers = collected;
+    }
+    // Compute the resulting config
+    const config = computeSetup(existing, answers);
+    // Write `.aidlc/config.yaml`
+    saveYaml(configPath, config);
+    // Run `aidlc init` for each configured platform
+    if (config.platforms.length > 0) {
+        const { registerInit } = await import('./init.js');
+        for (const platform of config.platforms) {
+            process.stderr.write(`Running init for platform: ${platform}\n`);
+            const initProgram = new Command();
+            initProgram.exitOverride();
+            registerInit(initProgram);
+            try {
+                await initProgram.parseAsync(['init', '--platform', platform], { from: 'user' });
+            }
+            catch {
+                // commander throws on exitOverride; non-fatal for setup
+            }
+        }
+    }
+    // Run discover to generate context docs
+    process.stderr.write('Running discover...\n');
+    try {
+        const { registerDiscover } = await import('./discover.js');
+        const discoverProgram = new Command();
+        discoverProgram.exitOverride();
+        registerDiscover(discoverProgram);
+        await discoverProgram.parseAsync(['discover'], { from: 'user' });
+    }
+    catch {
+        // Non-fatal: discover may fail on empty projects
+    }
+    // Print summary
+    process.stdout.write(`\n${isUpdate ? 'Configuration updated' : 'Setup complete'}:\n`);
+    process.stdout.write(`  Config:    ${configPath}\n`);
+    process.stdout.write(`  Scope:     ${config.defaults.scope}\n`);
+    process.stdout.write(`  Template:  ${config.defaults.template}\n`);
+    process.stdout.write(`  Platforms: ${config.platforms.length > 0 ? config.platforms.join(', ') : 'none'}\n`);
+    process.stdout.write(`  Actions:   ${config.actions.length > 0 ? config.actions.join(', ') : 'none'}\n`);
+    process.stdout.write('\n');
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/start.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `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';
+/**
+ * Register the `aidlc start` command on the given commander program.
+ */
+export declare function registerStart(program: Command): void;
+//# sourceMappingURL=start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkGpC;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBpD"}