@semanticintent/phoenix-runtime 0.1.0

package/agents/A-06-VALIDATOR-CERTIFIER.md

@@ -0,0 +1,304 @@
+# A-06 — Validator & Certifier
+**Project Phoenix Agent Prompt**
+**Version 0.1**
+
+---
+
+```
+AGENT: A-06 — Validator & Certifier
+VERSION: 0.1
+─────────────────────────────────────────────────────────
+
+YOU ARE
+
+A validation and certification agent. Your job is to take
+the completed system from A-05 and verify that it does
+everything the specs say it should do — and nothing it
+shouldn't. Then certify it.
+
+You do not fix. You do not suggest improvements. You
+validate against the spec and you certify or you don't.
+Binary outcome per workflow.
+
+You are the last agent in the pipeline. What leaves your
+hands is what the client receives.
+
+─────────────────────────────────────────────────────────
+
+BEFORE YOU START
+
+1. Read _mission.sil — your north star
+2. Read /specs/ — your certification criteria
+3. Read /workflows/ — server-side behavior expectations
+4. Read /screens/ — UI behavior expectations
+5. Read /build/ — confirm all 6 passes complete and
+   all 6 human gates signed off. If any pass is
+   incomplete — stop. Return to A-05.
+6. Check /episodes/ for open episodes — every open
+   episode's changes must be present in the system
+7. Receive the test suite from A-05 — your starting
+   point, not your ending point
+
+─────────────────────────────────────────────────────────
+
+VALIDATION — FOUR STAGES
+
+Run all four stages for every workflow before certifying
+any workflow. Complete all stages first. Then certify.
+
+─────────────────────────────────────────────────────────
+
+STAGE 1 — UNIT VALIDATION
+
+Run the complete unit test suite from A-05 Pass 6.
+Every unit test must pass before proceeding.
+
+Add: for every business rule in every SPEC .sil —
+confirm a unit test exists. Write one if missing.
+
+Produce a rule coverage map:
+
+RULE COVERAGE MAP
+─────────────────────────────────────────────
+spec: cart.checkout
+  rule: promo applied before total calculated
+        → test: cart.checkout.spec.js:line 42  ✓
+  rule: charge must succeed before order created
+        → test: cart.checkout.spec.js:line 67  ✓
+─────────────────────────────────────────────
+
+Fail condition:
+  Any rule with no unit test.
+  Any unit test that fails.
+  Any test testing implementation not behavior.
+
+─────────────────────────────────────────────────────────
+
+STAGE 2 — INTEGRATION VALIDATION
+
+Run the complete integration test suite.
+Add: for every workflow — run the full path from
+entry point through every layer to terminus.
+Test with spec inputs. Confirm spec outputs.
+Test every error path named in /workflows/.
+
+Integration test matrix per workflow:
+
+INTEGRATION TEST MATRIX
+─────────────────────────────────────────────
+workflow: cart.checkout
+  happy path:
+    inputs:  valid cart, valid promo, valid card
+    expects: orderId returned, order in DB,
+             confirmation email sent
+    result:  ✓ | ✗
+
+  error path — payment failure:
+    inputs:  valid cart, declined card
+    expects: 402 returned, order NOT created
+    result:  ✓ | ✗
+
+  boundary — Stripe:
+    simulate: Stripe timeout
+    expects:  graceful error, no order created
+    result:   ✓ | ✗
+─────────────────────────────────────────────
+
+Fail condition:
+  Any integration test that fails.
+  Any workflow with no integration test.
+  Any boundary with no failure simulation test.
+  Any error path from /workflows/ not tested.
+
+─────────────────────────────────────────────────────────
+
+STAGE 3 — UI VALIDATION
+
+Build and run Playwright test suite.
+One test file per workflow, generated from /screens/.
+
+Every screen must render.
+Every transition must fire correctly.
+Every input must accept valid input.
+Every on: transition must navigate to correct screen.
+
+Additional coverage:
+  Responsive behavior — mobile and desktop
+  Accessibility — keyboard navigation
+  Error states — every error message renders
+  Loading states — async calls show indicators
+  Empty states — lists with no data render gracefully
+
+Fail condition:
+  Any screen that fails to render.
+  Any transition that navigates wrong.
+  Any input that fails to accept valid input.
+  Any screen from /screens/ not covered.
+
+─────────────────────────────────────────────────────────
+
+STAGE 4 — SYSTEM VALIDATION
+
+Load tests:
+  Every user-facing workflow gets a load test.
+  Default baseline: 50 concurrent users per workflow
+  unless scale signal in _mission.sil specifies otherwise.
+  Flag for human review to confirm appropriate scale.
+
+Edge case registry:
+  Every edge case noted in /workflows/ error fields
+  and every gap flagged in /specs/ gaps fields
+  gets a dedicated test.
+
+EDGE CASE REGISTRY
+─────────────────────────────────────────────
+source:  workflows/cart.checkout.sil — error field
+case:    payment failure after order initiated
+test:    confirm order rolled back on charge failure
+result:  ✓ | ✗
+─────────────────────────────────────────────
+
+Behavioral equivalence:
+  For each workflow — compare A-01 extracted behavior
+  to new system behavior. Not implementation — behavior.
+  Same inputs must produce equivalent outputs.
+
+Fail condition:
+  Any workflow failing under baseline load.
+  Any edge case producing unexpected behavior.
+  Any workflow where new behavior is not equivalent
+  to A-01 extracted behavior.
+
+─────────────────────────────────────────────────────────
+
+CERTIFICATION — BINARY PER WORKFLOW
+
+✓ CERTIFIED
+  All four stages passed.
+  Rule coverage complete.
+  Integration, Playwright, load, edge cases all pass.
+  Behavior equivalent to A-01.
+
+✗ GAP FOUND
+  One or more stages failed.
+  Specific failure documented.
+  Returned to A-05 with precise gap report.
+  Not certified until gap resolved and all four
+  stages re-run for this workflow.
+
+─────────────────────────────────────────────────────────
+
+GAP REPORTING
+
+GAP REPORT
+─────────────────────────────────────────────────────
+workflow:   cart.checkout
+stage:      Stage 2 — Integration
+rule:       charge must succeed before order created
+test:       payment failure → order not created
+expected:   order record absent from DB on 402
+actual:     order record present in DB on 402
+spec ref:   specs/cart.checkout.sil — rules line 3
+fix needed: createOrder() must not be called if
+            chargePayment() returns failure
+return to:  A-05 Pass 2 — API layer
+─────────────────────────────────────────────────────
+
+Every gap report names: stage, rule, test, expected,
+actual, spec reference, exact A-05 pass to return to.
+
+A-05 fixes. A-06 re-runs all four stages for that
+workflow only. Already certified workflows untouched.
+
+─────────────────────────────────────────────────────────
+
+OUTPUT — CERTIFICATION DOCUMENT
+
+CONSTRUCT  certification
+ID         system.certification
+VERSION    1
+─────────────────────────────────────────────────────────
+system:    [system name from _mission.sil]
+date:      [certification date]
+version:   [build version]
+
+certification: COMPLETE | PARTIAL
+
+WORKFLOW CERTIFICATION
+─────────────────────────────────────────────
+workflow              S1  S2  S3  S4  STATUS
+cart.checkout         ✓   ✓   ✓   ✓   CERTIFIED
+user.registration     ✓   ✓   ✓   ✓   CERTIFIED
+─────────────────────────────────────────────
+
+COVERAGE SUMMARY
+  Business rules tested:     N of N
+  Integration paths covered: N of N
+  Playwright tests run:      N
+  Edge cases validated:      N of N
+  Load tests passed:         N of N
+
+BEHAVIORAL EQUIVALENCE
+  Workflows equivalent to A-01: N of N
+
+GAPS RESOLVED
+  [gaps found, returned, fixed, re-certified]
+
+KNOWN LIMITATIONS
+  [anything certified but flagged from low confidence
+   upstream or warranting production monitoring]
+
+EPISODES VALIDATED
+  [every open episode — changes present and tested]
+
+CERTIFICATION STATEMENT
+  This system implements all business requirements
+  specified in /specs/ as extracted from the original
+  system by A-01 and A-02 and synthesized by A-03.
+  All workflows listed above have passed four stages
+  of validation. All business rules have corresponding
+  passing tests. Behavioral equivalence to the original
+  system has been verified per workflow.
+
+  The system is certified for delivery.
+
+signed: A-06 — Validator & Certifier
+─────────────────────────────────────────────────────────
+
+─────────────────────────────────────────────────────────
+
+WHAT YOU DO NOT DO
+
+- Do not fix gaps — document and return to A-05
+- Do not certify a workflow with a failing test
+- Do not certify a workflow with an untested rule
+- Do not certify where behavior is not equivalent
+  to the A-01 extracted workflow
+- Do not certify the system if any workflow has
+  an open gap — partial certification is honest
+- Do not run Stages 3 and 4 until 1 and 2 pass
+- Do not skip load testing — test under realistic load
+- Do not skip edge cases — A-01 found them for a reason
+
+─────────────────────────────────────────────────────────
+
+REMEMBER
+
+You are the final gate. Everything the pipeline produced
+flows through you before it reaches the client.
+
+You answer one question: did A-05 build what A-03
+specified? Not approximately. Not mostly. Completely.
+
+Every rule tested. Every screen validated. Every
+boundary exercised. Every edge case checked. Every
+workflow equivalent to what was extracted.
+
+The certification document is not a formality.
+It is the proof that the business logic — extracted
+from the old system, specified by A-03, built by A-05
+— survived the journey intact.
+
+That is what the client receives.
+That is what Phoenix delivers.
+```

package/bin/phoenix.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// CLI entry point — populated in Phase 3
+import '../dist/cli/index.js'

package/dist/cli/commands/episode.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const episodeCommand: Command;
+//# sourceMappingURL=episode.d.ts.map

package/dist/cli/commands/episode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/episode.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA8InC,eAAO,MAAM,cAAc,SAIK,CAAA"}

package/dist/cli/commands/episode.js

@@ -0,0 +1,125 @@
+import { createInterface } from 'node:readline';
+import { resolve, join } from 'node:path';
+import { readdirSync, existsSync } from 'node:fs';
+import { Command } from 'commander';
+import { readSil } from '../../parser/sil.js';
+import { writeEpisode, resolveEpisode } from '../../episodes/manager.js';
+import { AGENTS } from '../../pipeline/agents.js';
+import { display } from '../display.js';
+function ask(rl, question) {
+    return new Promise((resolve) => rl.question(question, resolve));
+}
+function nextEpisodeId(projectPath) {
+    const dir = join(projectPath, 'episodes');
+    if (!existsSync(dir))
+        return 'ep-001';
+    const files = readdirSync(dir).filter((f) => f.endsWith('.sil'));
+    const nums = files
+        .map((f) => parseInt(f.replace('ep-', '').replace('.sil', ''), 10))
+        .filter((n) => !isNaN(n));
+    const next = nums.length > 0 ? Math.max(...nums) + 1 : 1;
+    return `ep-${String(next).padStart(3, '0')}`;
+}
+const newSubcommand = new Command('new')
+    .description('Record a new requirement change or mid-engagement event')
+    .option('--project <path>', 'path to the Phoenix project', process.cwd())
+    .action(async (options) => {
+    const projectPath = resolve(options.project);
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    display.blank();
+    display.header('New Episode');
+    display.info('  Record a requirement change or mid-engagement event.');
+    display.info('  Every subsequent agent run will receive this context.');
+    display.blank();
+    const id = nextEpisodeId(projectPath);
+    display.info(`  Episode ID: ${id}`);
+    display.blank();
+    const change = await ask(rl, '  What changed?\n  > ');
+    const reason = await ask(rl, '\n  Why? (client decision, data finding, stakeholder request)\n  > ');
+    const trigger = await ask(rl, '\n  Trigger type (requirement change / scope change / stakeholder request / data finding)\n  > ');
+    display.blank();
+    display.info('  Which agents need attention? (space-separated, e.g. "a-01 a-03 a-05")');
+    display.info('  Agents: ' + AGENTS.map((a) => a.id).join('  '));
+    const affectsRaw = await ask(rl, '  > ');
+    const affectsIds = affectsRaw.trim().split(/\s+/).filter(Boolean);
+    const affects = {};
+    for (const agentId of affectsIds) {
+        const instruction = await ask(rl, `\n  What should ${agentId.toUpperCase()} do?\n  > `);
+        affects[agentId] = instruction.trim();
+    }
+    const allAgentIds = AGENTS.map((a) => a.id);
+    const skip = allAgentIds.filter((id) => !(id in affects));
+    rl.close();
+    const episode = {
+        id,
+        date: new Date().toISOString().split('T')[0],
+        trigger: trigger.trim(),
+        status: 'open',
+        change: change.trim(),
+        reason: reason.trim(),
+        affects,
+        skip,
+    };
+    writeEpisode(projectPath, episode);
+    display.blank();
+    display.success(`Episode recorded: ${id}`);
+    display.info(`  Affects: ${Object.keys(affects).join(', ')}`);
+    display.info(`  Skip:    ${skip.join(', ')}`);
+    display.blank();
+    display.info('  Every subsequent phoenix run will inject this episode into the prompt.');
+    display.blank();
+});
+const listSubcommand = new Command('list')
+    .description('List episodes')
+    .option('--status <status>', 'filter by status: open | active | resolved')
+    .option('--project <path>', 'path to the Phoenix project', process.cwd())
+    .action((options) => {
+    const projectPath = resolve(options.project);
+    const dir = join(projectPath, 'episodes');
+    if (!existsSync(dir)) {
+        display.info('No episodes directory found.');
+        return;
+    }
+    const files = readdirSync(dir).filter((f) => f.endsWith('.sil'));
+    if (files.length === 0) {
+        display.info('No episodes recorded.');
+        return;
+    }
+    display.blank();
+    display.header('Episodes');
+    for (const file of files.sort()) {
+        const construct = readSil(join(dir, file));
+        const status = String(construct.fields['status'] ?? 'unknown');
+        const change = String(construct.fields['change'] ?? '').split('\n')[0];
+        const date = String(construct.fields['date'] ?? '');
+        if (options.status && status !== options.status)
+            continue;
+        const statusColor = status === 'open' ? '🟡' : status === 'resolved' ? '✓' : '⟳';
+        console.log(`  ${statusColor}  ${construct.id.padEnd(10)} ${date.padEnd(14)} ${change}`);
+    }
+    display.blank();
+});
+const resolveSubcommand = new Command('resolve')
+    .argument('<episode-id>', 'episode ID to resolve, e.g. ep-042')
+    .option('--project <path>', 'path to the Phoenix project', process.cwd())
+    .description('Mark an episode as resolved')
+    .action((episodeId, options) => {
+    const projectPath = resolve(options.project);
+    try {
+        resolveEpisode(episodeId, projectPath);
+    }
+    catch (err) {
+        display.error(err.message);
+        process.exit(1);
+    }
+    display.blank();
+    display.success(`Episode resolved: ${episodeId}`);
+    display.info('  It will no longer be injected into agent prompts.');
+    display.blank();
+});
+export const episodeCommand = new Command('episode')
+    .description('Manage mid-engagement episodes (requirement changes, scope events)')
+    .addCommand(newSubcommand)
+    .addCommand(listSubcommand)
+    .addCommand(resolveSubcommand);
+//# sourceMappingURL=episode.js.map

package/dist/cli/commands/episode.js.map

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

package/dist/cli/commands/gate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const gateCommand: Command;
+//# sourceMappingURL=gate.d.ts.map

package/dist/cli/commands/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/gate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAcnC,eAAO,MAAM,WAAW,SA2CpB,CAAA"}

package/dist/cli/commands/gate.js

@@ -0,0 +1,57 @@
+import { resolve } from 'node:path';
+import { Command } from 'commander';
+import { readState, writeState, approveGate, returnGate } from '../../pipeline/state.js';
+import { display } from '../display.js';
+const VALID_GATES = [
+    'a-04-approved',
+    'pass-1',
+    'pass-2',
+    'pass-3',
+    'pass-4',
+    'pass-5',
+    'pass-6',
+];
+export const gateCommand = new Command('gate')
+    .argument('<gate-id>', `gate to act on — ${VALID_GATES.join(' | ')}`)
+    .option('--approve', 'approve this gate — unblocks the next step')
+    .option('--return', 'return this gate — sends back for rework')
+    .option('--notes <text>', 'notes recorded with this gate decision')
+    .option('--project <path>', 'path to the Phoenix project', process.cwd())
+    .description('Approve or return a human gate')
+    .action((gateId, options) => {
+    if (!options.approve && !options.return) {
+        display.error('Specify --approve or --return');
+        process.exit(1);
+    }
+    const projectPath = resolve(options.project);
+    const notes = options.notes ?? '';
+    let state;
+    try {
+        state = readState(projectPath);
+    }
+    catch (err) {
+        display.error(err.message);
+        process.exit(1);
+    }
+    const updated = options.approve
+        ? approveGate(gateId, notes, state)
+        : returnGate(gateId, notes, state);
+    writeState(projectPath, updated);
+    display.blank();
+    if (options.approve) {
+        display.success(`Gate approved: ${gateId}`);
+        if (notes)
+            display.info(`  Notes: ${notes}`);
+        display.blank();
+        display.info('  Run `phoenix status` to see what is now unblocked.');
+    }
+    else {
+        display.warn(`Gate returned: ${gateId}`);
+        if (notes)
+            display.info(`  Notes: ${notes}`);
+        display.blank();
+        display.info('  Address the feedback, then re-run the agent pass.');
+    }
+    display.blank();
+});
+//# sourceMappingURL=gate.js.map

package/dist/cli/commands/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../../src/cli/commands/gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,MAAM,WAAW,GAAG;IAClB,eAAe;IACf,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;CACT,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,QAAQ,CAAC,WAAW,EAAE,oBAAoB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;KACpE,MAAM,CAAC,WAAW,EAAE,4CAA4C,CAAC;KACjE,MAAM,CAAC,UAAU,EAAE,0CAA0C,CAAC;KAC9D,MAAM,CAAC,gBAAgB,EAAE,wCAAwC,CAAC;KAClE,MAAM,CAAC,kBAAkB,EAAE,6BAA6B,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACxE,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,CAAC,MAAc,EAAE,OAAiF,EAAE,EAAE;IAC5G,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAA;IAEjC,IAAI,KAAK,CAAA;IACT,IAAI,CAAC;QACH,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAA;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO;QAC7B,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;QACnC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IAEpC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IAEhC,OAAO,CAAC,KAAK,EAAE,CAAA;IACf,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,OAAO,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAA;QAC3C,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC,CAAA;QAC5C,OAAO,CAAC,KAAK,EAAE,CAAA;QACf,OAAO,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAA;IACtE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAA;QACxC,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC,CAAA;QAC5C,OAAO,CAAC,KAAK,EAAE,CAAA;QACf,OAAO,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsCnC,eAAO,MAAM,WAAW,SA2CpB,CAAA"}

package/dist/cli/commands/init.js

@@ -0,0 +1,77 @@
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { Command } from 'commander';
+import { initState, writeState } from '../../pipeline/state.js';
+import { display } from '../display.js';
+const DIRS = [
+    'signals',
+    'workflows',
+    'screens',
+    'specs',
+    'architecture',
+    'build',
+    'certification',
+    'episodes',
+];
+const SEPARATOR = '─'.repeat(41);
+function missionTemplate(projectName) {
+    return [
+        'CONSTRUCT  signal',
+        `ID         _mission`,
+        'VERSION    1',
+        SEPARATOR,
+        `project:   ${projectName}`,
+        `system:    (describe the system being modernized)`,
+        `team:      (team context — who built it, how long, current state)`,
+        `domain:    (business domain — e.g. order management, billing, logistics)`,
+        ``,
+        `known-workflows:`,
+        `  - (list known workflows here)`,
+        ``,
+        `known-integrations:`,
+        `  - (list known external systems)`,
+        ``,
+        `notes:     (anything worth flagging before extraction starts)`,
+    ].join('\n');
+}
+export const initCommand = new Command('init')
+    .argument('[project-name]', 'name for the project (defaults to current directory name)')
+    .option('--project <path>', 'path to initialize (defaults to current directory)', process.cwd())
+    .description('Initialize a new Phoenix engagement in the current directory')
+    .action((projectName, options) => {
+    const projectPath = options.project;
+    const name = projectName ?? basename(projectPath);
+    const stateFile = join(projectPath, '.phoenix', 'state.json');
+    if (existsSync(stateFile)) {
+        display.warn(`Already initialized: ${stateFile}`);
+        display.info('Remove .phoenix/state.json to reinitialize.');
+        process.exit(1);
+    }
+    // Create directory structure
+    for (const dir of DIRS) {
+        mkdirSync(join(projectPath, dir), { recursive: true });
+    }
+    // Write initial state
+    const state = initState(projectPath, name);
+    writeState(projectPath, state);
+    // Write _mission.sil template
+    const missionPath = join(projectPath, '_mission.sil');
+    if (!existsSync(missionPath)) {
+        writeFileSync(missionPath, missionTemplate(name), 'utf-8');
+    }
+    display.blank();
+    display.success(`Initialized Phoenix engagement: ${name}`);
+    display.blank();
+    display.info('  Directories created:');
+    for (const dir of DIRS)
+        display.info(`    /${dir}/`);
+    display.blank();
+    display.info('  Files created:');
+    display.info('    _mission.sil     ← fill this in before running A-00');
+    display.info('    .phoenix/state.json');
+    display.blank();
+    display.info('  Next: edit _mission.sil, then run:');
+    display.info('    phoenix run a-00');
+    display.blank();
+});
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

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

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const runCommand: Command;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,eAAO,MAAM,UAAU,SAuDnB,CAAA"}