@rasensio/aidlc 0.1.0

package/dist/commands/add-action.js

@@ -0,0 +1,437 @@
+/**
+ * `aidlc add action` command — AI-assisted action authoring.
+ *
+ * Translates a natural language description into a Lifecycle_Action entry
+ * in `.aidlc/actions.yaml`. Supports interactive confirmation, dry-run,
+ * and non-interactive mode.
+ *
+ * Requirements: 22.1, 22.5, 22.6, 22.7, 22.8, 22.9, 22.10, 22.11, 22.13, 20.2, 20.3
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import * as clack from '@clack/prompts';
+import { loadActionsConfig, emit } from '../events/event-bus.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const VALID_EVENTS = [
+    'on-instance-start',
+    'on-phase-enter',
+    'on-phase-exit',
+    'on-instance-complete',
+    'on-artifact-created',
+];
+const PHASE_NAMES = [
+    'ideation',
+    'requirements',
+    'design',
+    'implementation',
+    'testing',
+    'deployment',
+    'maintenance',
+];
+// ---------------------------------------------------------------------------
+// Inference rules (heuristic — full AI inference handled by skill 82-add-action)
+// ---------------------------------------------------------------------------
+/**
+ * Infer a lifecycle event from a natural language description.
+ *
+ * Rules:
+ * - "when starting" / "on start" → on-instance-start
+ * - "when entering" / "on enter" → on-phase-enter
+ * - "when exiting" / "on exit" / "after" → on-phase-exit
+ * - "when complete" / "on finish" → on-instance-complete
+ * - Otherwise → null (cannot infer)
+ */
+export function inferEvent(description) {
+    const lower = description.toLowerCase();
+    // on-instance-start patterns
+    if (/\b(when\s+starting|on\s+start|at\s+start|instance\s+start)\b/.test(lower)) {
+        return 'on-instance-start';
+    }
+    // on-instance-complete patterns
+    if (/\b(when\s+complete|on\s+finish|when\s+finished|when\s+done|on\s+complete|instance\s+complete)\b/.test(lower)) {
+        return 'on-instance-complete';
+    }
+    // on-phase-enter patterns
+    if (/\b(when\s+entering|on\s+enter|entering\s+phase|phase\s+enter)\b/.test(lower)) {
+        return 'on-phase-enter';
+    }
+    // on-phase-exit patterns
+    if (/\b(when\s+exiting|on\s+exit|exiting\s+phase|phase\s+exit|after\s+phase)\b/.test(lower)) {
+        return 'on-phase-exit';
+    }
+    // "after" + phase name → on-phase-exit
+    if (/\bafter\b/.test(lower)) {
+        for (const phase of PHASE_NAMES) {
+            if (lower.includes(phase)) {
+                return 'on-phase-exit';
+            }
+        }
+    }
+    // "when" + phase name + starts/begins → on-phase-enter
+    if (/\bwhen\b/.test(lower)) {
+        for (const phase of PHASE_NAMES) {
+            if (lower.includes(phase) && /\b(starts?|begins?)\b/.test(lower)) {
+                return 'on-phase-enter';
+            }
+        }
+    }
+    // Fallback: if it mentions a phase with a "done" / "finish" / "complete" → on-phase-exit
+    for (const phase of PHASE_NAMES) {
+        if (lower.includes(phase)) {
+            if (/\b(done|finish|complete|end)\b/.test(lower)) {
+                return 'on-phase-exit';
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Infer a phase filter from the description.
+ * Looks for known phase names in the text.
+ */
+export function inferPhase(description) {
+    const lower = description.toLowerCase();
+    for (const phase of PHASE_NAMES) {
+        if (lower.includes(phase)) {
+            return phase;
+        }
+    }
+    return undefined;
+}
+/**
+ * Infer whether the action should use a built-in or a custom command.
+ *
+ * Rules:
+ * - "create branch" / "git branch" → use: git-branch
+ * - "issue" / "github" → use: github-issue
+ * - Otherwise → run: <description as command>
+ */
+export function inferAction(description) {
+    const lower = description.toLowerCase();
+    // git-branch built-in
+    if (/\b(create\s+branch|git\s+branch|feature\s+branch)\b/.test(lower)) {
+        return { use: 'git-branch', with: { pattern: 'feature/{instance-name}' } };
+    }
+    // github-issue built-in
+    if (/\b(issue|github)\b/.test(lower)) {
+        return { use: 'github-issue' };
+    }
+    // doc-update built-in (append to doc, update doc, log file)
+    if (/\b(doc[-\s]?update|update\s+(a\s+)?doc|append\s+to\b|log\s+file)\b/.test(lower)) {
+        return { use: 'doc-update' };
+    }
+    // Default: treat as a shell command
+    return { run: description };
+}
+/**
+ * Generate a URL-safe action ID from the description.
+ */
+export function generateActionId(description) {
+    return description
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .slice(0, 40);
+}
+/**
+ * Full inference pipeline: take a natural language description and produce
+ * an InferredAction. Returns `null` for the event field if it cannot be inferred.
+ */
+export function inferActionFromDescription(description, eventOverride, blockingOverride) {
+    const event = eventOverride ?? inferEvent(description);
+    if (event === null) {
+        return { event: null, description };
+    }
+    const phase = inferPhase(description);
+    const action = inferAction(description);
+    const blocking = blockingOverride ?? false;
+    const id = generateActionId(description);
+    return {
+        id,
+        event,
+        phase,
+        ...action,
+        blocking,
+        description,
+    };
+}
+// ---------------------------------------------------------------------------
+// Schema validation
+// ---------------------------------------------------------------------------
+/**
+ * Validate a single action entry against the ActionsConfig schema.
+ * Returns null if valid, or an error string describing the violation.
+ */
+export function validateActionEntry(entry) {
+    if (!entry.id || typeof entry.id !== 'string') {
+        return "missing or invalid 'id' field";
+    }
+    if (!VALID_EVENTS.includes(entry.event)) {
+        return `invalid event '${entry.event}'; must be one of: ${VALID_EVENTS.join(', ')}`;
+    }
+    if (typeof entry.blocking !== 'boolean') {
+        return "missing or invalid 'blocking' field (expected boolean)";
+    }
+    if (typeof entry.description !== 'string' || !entry.description) {
+        return "missing or invalid 'description' field";
+    }
+    const hasUse = 'use' in entry && typeof entry.use === 'string' && entry.use.length > 0;
+    const hasRun = 'run' in entry && typeof entry.run === 'string' && entry.run.length > 0;
+    if (!hasUse && !hasRun) {
+        return "must have either 'use' or 'run' field";
+    }
+    if (hasUse && hasRun) {
+        return "cannot have both 'use' and 'run' fields";
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Actions file writer
+// ---------------------------------------------------------------------------
+/**
+ * Convert an InferredAction to an ActionDefinition for storage.
+ */
+function toActionDefinition(inferred) {
+    const base = {
+        id: inferred.id,
+        event: inferred.event,
+        ...(inferred.phase ? { phase: inferred.phase } : {}),
+        enabled: true,
+        blocking: inferred.blocking,
+        description: inferred.description,
+    };
+    if (inferred.use) {
+        return {
+            ...base,
+            use: inferred.use,
+            ...(inferred.with ? { with: inferred.with } : {}),
+        };
+    }
+    return {
+        ...base,
+        run: inferred.run,
+    };
+}
+/**
+ * Append an action to the actions.yaml file (create if it doesn't exist).
+ */
+export function appendAction(actionsPath, action) {
+    let config;
+    if (existsSync(actionsPath)) {
+        const raw = readFileSync(actionsPath, 'utf8');
+        config = parseYaml(raw);
+    }
+    else {
+        // Ensure directory exists
+        const dir = dirname(actionsPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        config = { version: 1, actions: [] };
+    }
+    const definition = toActionDefinition(action);
+    config.actions.push(definition);
+    const yaml = stringifyYaml(config, {
+        lineWidth: 0,
+        defaultKeyType: 'PLAIN',
+        defaultStringType: 'PLAIN',
+    });
+    writeFileSync(actionsPath, yaml, 'utf8');
+}
+// ---------------------------------------------------------------------------
+// YAML preview rendering
+// ---------------------------------------------------------------------------
+/**
+ * Render an InferredAction as a YAML preview for user confirmation.
+ */
+export function renderActionPreview(action) {
+    const lines = [];
+    lines.push(`- id: ${action.id}`);
+    lines.push(`  event: ${action.event}`);
+    if (action.phase) {
+        lines.push(`  phase: ${action.phase}`);
+    }
+    if (action.use) {
+        lines.push(`  use: ${action.use}`);
+        if (action.with) {
+            lines.push(`  with:`);
+            for (const [k, v] of Object.entries(action.with)) {
+                lines.push(`    ${k}: "${v}"`);
+            }
+        }
+    }
+    if (action.run) {
+        lines.push(`  run: '${action.run}'`);
+    }
+    lines.push(`  enabled: true`);
+    lines.push(`  blocking: ${action.blocking}`);
+    lines.push(`  description: "${action.description}"`);
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc add action` command on the given commander program.
+ */
+export function registerAddAction(program) {
+    const addCmd = program
+        .command('add')
+        .description('Add framework components');
+    addCmd
+        .command('action')
+        .description('Create a Lifecycle_Action from a natural language description')
+        .argument('<description>', 'Natural language description of the automation')
+        .option('--event <event>', 'Override the inferred lifecycle event')
+        .option('--blocking', 'Mark the action as blocking (halts transition on failure)')
+        .option('--non-interactive', 'Skip confirmation prompts; fail if event cannot be inferred')
+        .option('--dry-run', 'Show what would be added without writing')
+        .action(async (description, opts) => {
+        await runAddAction(description, opts);
+    });
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+async function runAddAction(description, opts) {
+    const projectRoot = process.cwd();
+    const actionsPath = join(projectRoot, '.aidlc', 'actions.yaml');
+    // Validate --event if provided
+    if (opts.event && !VALID_EVENTS.includes(opts.event)) {
+        process.stderr.write(`Error: invalid event '${opts.event}'\n` +
+            `Available events: ${VALID_EVENTS.join(', ')}\n`);
+        process.exitCode = 2;
+        return;
+    }
+    // Run inference
+    const result = inferActionFromDescription(description, opts.event, opts.blocking);
+    // Handle case where event cannot be inferred
+    if (result.event === null) {
+        if (opts.nonInteractive) {
+            process.stderr.write(`Error: could not infer lifecycle event from description.\n` +
+                `Available events: ${VALID_EVENTS.join(', ')}\n` +
+                `Use --event <event> to specify explicitly.\n`);
+            process.exitCode = 1;
+            return;
+        }
+        // Interactive: prompt for event selection (Req 22.11)
+        const selected = await clack.select({
+            message: 'Could not infer the lifecycle event. Please select one:',
+            options: VALID_EVENTS.map((e) => ({ value: e, label: e })),
+        });
+        if (clack.isCancel(selected)) {
+            process.stderr.write('Cancelled.\n');
+            process.exitCode = 1;
+            return;
+        }
+        // Re-run inference with the selected event
+        const retried = inferActionFromDescription(description, selected, opts.blocking);
+        if (retried.event === null) {
+            // Should not happen since we provided an override, but guard anyway
+            process.stderr.write('Error: unexpected inference failure.\n');
+            process.exitCode = 1;
+            return;
+        }
+        return await processInferredAction(retried, actionsPath, opts);
+    }
+    return await processInferredAction(result, actionsPath, opts);
+}
+async function processInferredAction(action, actionsPath, opts) {
+    // Validate against schema (Req 22.7, 22.9)
+    const validationError = validateActionEntry(action);
+    if (validationError) {
+        process.stderr.write(`Error: generated action fails schema validation: ${validationError}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Render preview
+    const preview = renderActionPreview(action);
+    if (opts.dryRun) {
+        // Dry run: show what would be added without writing
+        process.stdout.write('Dry run — would add the following action:\n\n');
+        process.stdout.write(preview + '\n\n');
+        process.stdout.write('No changes were written.\n');
+        return;
+    }
+    if (opts.nonInteractive) {
+        // Non-interactive: validate and write directly
+        appendAction(actionsPath, action);
+        process.stdout.write('Action saved to .aidlc/actions.yaml:\n\n');
+        process.stdout.write(preview + '\n\n');
+        offerTestFire(action);
+        return;
+    }
+    // Interactive: show preview and ask for confirmation (Req 22.5, 22.6)
+    process.stdout.write('\nProposed action entry:\n\n');
+    process.stdout.write(preview + '\n\n');
+    const confirmed = await clack.confirm({
+        message: 'Save this action to .aidlc/actions.yaml?',
+    });
+    if (clack.isCancel(confirmed) || !confirmed) {
+        process.stdout.write('Action was not saved.\n');
+        return;
+    }
+    // Save (Req 22.8)
+    appendAction(actionsPath, action);
+    process.stdout.write('Action saved to .aidlc/actions.yaml.\n');
+    // Offer test-fire (Req 22.13)
+    await offerTestFireInteractive(action);
+}
+// ---------------------------------------------------------------------------
+// Test-fire (Req 22.13)
+// ---------------------------------------------------------------------------
+function offerTestFire(action) {
+    process.stdout.write('Tip: use --dry-run on a lifecycle transition to test-fire this action with a sample payload.\n');
+}
+async function offerTestFireInteractive(action) {
+    const testFire = await clack.confirm({
+        message: 'Would you like to test-fire this action with a sample payload? (no real transition)',
+    });
+    if (clack.isCancel(testFire) || !testFire) {
+        return;
+    }
+    // Build a sample payload
+    const samplePayload = {
+        event: action.event,
+        instance: 'sample-instance',
+        phase: action.phase,
+        template: 'full-feature',
+    };
+    // Create a temp config with just this action for the dry-run emit
+    const config = {
+        version: 1,
+        actions: [
+            {
+                id: action.id,
+                event: action.event,
+                ...(action.phase ? { phase: action.phase } : {}),
+                enabled: true,
+                blocking: action.blocking,
+                description: action.description,
+                ...(action.use ? { use: action.use, ...(action.with ? { with: action.with } : {}) } : {}),
+                ...(action.run ? { run: action.run } : {}),
+            },
+        ],
+    };
+    const report = emit(samplePayload, config, { dryRun: true });
+    process.stdout.write('\nTest-fire (dry run):\n');
+    process.stdout.write(`  Event:    ${samplePayload.event}\n`);
+    process.stdout.write(`  Instance: ${samplePayload.instance}\n`);
+    if (samplePayload.phase) {
+        process.stdout.write(`  Phase:    ${samplePayload.phase}\n`);
+    }
+    process.stdout.write(`  Template: ${samplePayload.template}\n`);
+    process.stdout.write(`  Actions matched: ${report.fired.length}\n`);
+    if (report.fired.length > 0) {
+        process.stdout.write(`  → ${report.fired[0].id} would fire\n`);
+    }
+    process.stdout.write('\n');
+}
+//# sourceMappingURL=add-action.js.map

package/dist/commands/add-action.js.map

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

package/dist/commands/continue.d.ts

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

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

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