project-iris 0.0.13 → 0.0.14

package/dist/templates/inception/unit-brief-template.md

@@ -1,177 +0,0 @@
-# Unit Brief Template
-
-Use this template when creating unit briefs during decomposition. This is the **critical input for Construction**.
-
----
-
-## Frontmatter
-
-```yaml
----
-unit: {UUU}-{unit-name}
-intent: {NNN}-{intent-name}
-phase: inception
-status: draft|ready
-created: {YYYY-MM-DDTHH:MM:SSZ}
-updated: {YYYY-MM-DDTHH:MM:SSZ}
----
-```
-
-**Note**: The `unit` field uses the full folder name including the 3-digit prefix (e.g., `001-auth-service`). This matches the folder structure and enables direct path construction in scripts. Story naming uses the story title (e.g., `001-user-signup.md`).
-
----
-
-## Content
-
-```markdown
-# Unit Brief: {Unit Name}
-
-## Purpose
-
-{Clear, concise statement of what this unit does and why it exists}
-
-## Scope
-
-### In Scope
-- {What this unit IS responsible for}
-- {What this unit IS responsible for}
-
-### Out of Scope
-- {What this unit is NOT responsible for}
-- {What other units handle}
-
----
-
-## Assigned Requirements
-
-**These FRs from the intent are assigned to this unit. Stories will be created from these.**
-
-| FR | Requirement | Priority |
-|----|-------------|----------|
-| FR-{n} | {description from intent requirements.md} | Must/Should/Could |
-
----
-
-## Domain Concepts
-
-### Key Entities
-| Entity | Description | Attributes |
-|--------|-------------|------------|
-| {Entity 1} | {What it represents} | {Key properties} |
-| {Entity 2} | {What it represents} | {Key properties} |
-
-### Key Operations
-| Operation | Description | Inputs | Outputs |
-|-----------|-------------|--------|---------|
-| {Operation 1} | {What it does} | {Input data} | {Output data} |
-| {Operation 2} | {What it does} | {Input data} | {Output data} |
-
----
-
-## Story Summary
-
-| Metric | Count |
-|--------|-------|
-| Total Stories | {n} |
-| Must Have | {n} |
-| Should Have | {n} |
-| Could Have | {n} |
-
-### Stories
-
-| Story ID | Title | Priority | Status |
-|----------|-------|----------|--------|
-| {story-1} | {Title} | Must | Planned |
-| {story-2} | {Title} | Should | Planned |
-
----
-
-## Dependencies
-
-### Depends On
-| Unit | Reason |
-|------|--------|
-| {unit-name} | {Why this dependency exists} |
-
-### Depended By
-| Unit | Reason |
-|------|--------|
-| {unit-name} | {Why they depend on this} |
-
-### External Dependencies
-| System | Purpose | Risk |
-|--------|---------|------|
-| {External system} | {Why needed} | {Risk level} |
-
----
-
-## Technical Context
-
-### Suggested Technology
-{Recommendations based on tech stack standards}
-
-### Integration Points
-| Integration | Type | Protocol |
-|-------------|------|----------|
-| {System/Unit} | API/Event/DB | REST/GraphQL/Kafka |
-
-### Data Storage
-| Data | Type | Volume | Retention |
-|------|------|--------|-----------|
-| {Data type} | SQL/NoSQL/Cache | {Volume} | {Retention} |
-
----
-
-## Constraints
-
-- {Technical constraint specific to this unit}
-- {Business constraint specific to this unit}
-
----
-
-## Success Criteria
-
-### Functional
-- [ ] {Criterion 1: What must work}
-- [ ] {Criterion 2: What must work}
-
-### Non-Functional
-- [ ] {Performance target}
-- [ ] {Security requirement}
-
-### Quality
-- [ ] Code coverage > 80%
-- [ ] All acceptance criteria met
-- [ ] Code reviewed and approved
-
----
-
-## Bolt Suggestions
-
-Based on stories and complexity:
-
-| Bolt | Type | Stories | Objective |
-|------|------|---------|-----------|
-| bolt-{unit}-1 | DDD | S1, S2 | Core entities |
-| bolt-{unit}-2 | DDD | S3, S4 | API layer |
-
----
-
-## Notes
-
-{Any additional context, risks, or considerations for Construction}
-```
-
----
-
-## Quality Checklist
-
-Before marking unit brief as ready:
-
-- [ ] Purpose is clear and specific
-- [ ] Scope boundaries are defined
-- [ ] Key entities identified
-- [ ] Stories assigned to this unit
-- [ ] Dependencies mapped
-- [ ] Success criteria are measurable
-- [ ] Bolt suggestions provided

package/dist/templates/inception/units-template.md

@@ -1,52 +0,0 @@
----
-intent: {NNN}-{intent-name}
-phase: inception
-status: units-decomposed
-updated: {YYYY-MM-DDTHH:MM:SSZ}
----
-
-# {Intent Name} - Unit Decomposition
-
-## Units Overview
-
-This intent decomposes into {N} units of work:
-
-### Unit 1: {unit-name}
-
-**Description**: {What this unit does}
-
-**Stories**:
-
-- Story-1: {Title}
-- Story-3: {Title}
-
-**Deliverables**:
-
-- {Specific artifacts this unit produces}
-
-**Dependencies**:
-
-- Depends on: {Other units}
-- Depended by: {Units that need this}
-
-**Estimated Complexity**: S/M/L/XL
-
-### Unit 2: {unit-name}
-
-...
-
-## Unit Dependency Graph
-
-```text
-[Unit A] ──> [Unit B] ──> [Unit D]
-   │            │
-   └────> [Unit C] ──┘
-```
-
-## Execution Order
-
-Based on dependencies:
-
-1. Day 1-2: Unit A (foundation)
-2. Day 2-4: Unit B, Unit C (parallel)
-3. Day 5-6: Unit D (integration)

package/dist/utils/exit-codes.js

@@ -1,7 +0,0 @@
-export const EXIT_CODES = {
-    SUCCESS: 0,
-    INVALID: 2, // Missing artifacts, failed gates, invalid transition
-    VALID_WITH_WARNINGS: 3,
-    POLICY_ERROR: 4, // Policy invalid
-    STATE_ERROR: 5, // State invalid/unwritable
-};

package/dist/utils/logo.js

@@ -1,17 +0,0 @@
-import kleur from "kleur";
-/**
- * Display the OSiris Operating System IRIS logo banner
- */
-export function displayLogo(version = "0.0.11") {
-    const logo = `
- ██████╗ ███████╗██╗██████╗ ██╗███████╗
-██╔═══██╗██╔════╝██║██╔══██╗██║██╔════╝
-██║   ██║███████╗██║██████╔╝██║███████╗
-██║   ██║╚════██║██║██╔══██╗██║╚════██║
-╚██████╔╝███████║██║██║  ██║██║███████║
- ╚═════╝ ╚══════╝╚═╝╚═╝  ╚═╝╚═╝╚══════╝`;
-    console.log(kleur.yellow(logo));
-    console.log("");
-    console.log(kleur.yellow().bold("OSiris Operating System") + kleur.yellow(" Intelligent Repository for Intent-driven Systems") + kleur.gray(` v${version}`));
-    console.log("");
-}

package/dist/workflows/bolt-execution.js

@@ -1,238 +0,0 @@
-import { randomUUID } from "crypto";
-import inquirer from "inquirer";
-import kleur from "kleur";
-import { WorkflowStage } from "../bridge/types.js";
-import { appendEvent, saveRun } from "../iris/run-state.js";
-/**
- * Execute Bolt Execution stage
- * For each bolt:
- * 1. Design notes (optional gate)
- * 2. Implementation
- * 3. Testing
- * 4. Gate after implementation
- */
-export async function executeBoltExecution(runState, connector, options) {
-    console.log(kleur.bold("Bolt Execution Stage"));
-    console.log(kleur.dim(`Executing ${runState.bolts.length} bolt(s)\n`));
-    // Execute each bolt in order
-    while (runState.currentBoltIndex < runState.bolts.length) {
-        const bolt = runState.bolts[runState.currentBoltIndex];
-        console.log(kleur.bold(kleur.cyan(`\n=== Bolt ${runState.currentBoltIndex + 1}/${runState.bolts.length}: ${bolt.id} ===\n`)));
-        bolt.status = "in_progress";
-        saveRun(runState);
-        try {
-            await executeSingleBolt(runState, bolt, connector, options);
-            bolt.status = "completed";
-            runState.currentBoltIndex++;
-            saveRun(runState);
-            console.log(kleur.green(`✓ Bolt "${bolt.id}" completed\n`));
-        }
-        catch (error) {
-            console.error(kleur.red(`✗ Bolt "${bolt.id}" failed: ${error.message}\n`));
-            bolt.status = "failed";
-            saveRun(runState);
-            throw error;
-        }
-    }
-    // All bolts complete
-    console.log(kleur.bold(kleur.green("\n✓ All bolts executed successfully!")));
-    runState.stage = WorkflowStage.DONE;
-    saveRun(runState);
-}
-async function executeSingleBolt(runState, bolt, connector, options) {
-    // Step 1: Design (optional)
-    console.log(kleur.cyan("→ Design phase..."));
-    const designTaskId = randomUUID();
-    const designPacket = {
-        taskId: designTaskId,
-        intent: runState.intent,
-        stage: WorkflowStage.BOLT_EXECUTION,
-        agent: "iris-construction-agent",
-        instructions: `Design phase for bolt: ${bolt.id}
-
-Review the bolt file: memory-bank/operations/bolts/${bolt.id}.md
-
-Create design notes covering:
-- Domain model (if applicable)
-- Technical approach
-- Key decisions (ADRs if needed)
-- File structure
-
-You may create design notes inline in the bolt file or in separate files.
-This is optional but recommended for complex bolts.`,
-        inputs: [
-            `memory-bank/operations/bolts/${bolt.id}.md`,
-            ...runState.artifacts
-        ],
-        expectedOutputs: [],
-        metadata: { step: "design", boltId: bolt.id }
-    };
-    appendEvent(runState.runId, {
-        stage: WorkflowStage.BOLT_EXECUTION,
-        boltId: bolt.id,
-        action: "Design phase started",
-        taskId: designTaskId
-    });
-    if (!options.noBridge) {
-        await connector.sendTask(designPacket);
-        console.log(kleur.dim(`  Task sent: ${designTaskId}`));
-        console.log(kleur.dim("  Waiting for design notes...\n"));
-        const designResult = await connector.waitResult(designTaskId, {
-            timeoutMs: 600000 // 10 minutes
-        });
-        if (designResult.status === "ok") {
-            console.log(kleur.green("✓ Design complete"));
-            if (designResult.filesChanged) {
-                designResult.filesChanged.forEach(file => console.log(kleur.dim(`  - ${file}`)));
-            }
-            console.log("");
-            bolt.designCompleted = true;
-            appendEvent(runState.runId, {
-                stage: WorkflowStage.BOLT_EXECUTION,
-                boltId: bolt.id,
-                action: "Design completed",
-                outputs: designResult.filesChanged,
-                resultStatus: "ok"
-            });
-        }
-    }
-    else {
-        console.log(kleur.yellow("  Bridge disabled. Skipping design phase.\n"));
-    }
-    // Step 2: Implementation
-    console.log(kleur.cyan("→ Implementation phase..."));
-    const implTaskId = randomUUID();
-    const implPacket = {
-        taskId: implTaskId,
-        intent: runState.intent,
-        stage: WorkflowStage.BOLT_EXECUTION,
-        agent: "iris-construction-agent",
-        instructions: `Implementation phase for bolt: ${bolt.id}
-
-Review:
-- Bolt file: memory-bank/operations/bolts/${bolt.id}.md
-- Intent artifacts in memory-bank/intents/
-- Any design notes created
-
-Implement all tasks listed in the bolt file.
-Create/modify code files as needed.
-Follow the project's coding standards.
-
-Mark tasks as complete in the bolt file as you finish them.`,
-        inputs: [
-            `memory-bank/operations/bolts/${bolt.id}.md`,
-            ...runState.artifacts
-        ],
-        expectedOutputs: [],
-        gates: ["Implementation complete - ready for testing"],
-        metadata: { step: "implementation", boltId: bolt.id }
-    };
-    appendEvent(runState.runId, {
-        stage: WorkflowStage.BOLT_EXECUTION,
-        boltId: bolt.id,
-        action: "Implementation started",
-        taskId: implTaskId
-    });
-    if (!options.noBridge) {
-        await connector.sendTask(implPacket);
-        console.log(kleur.dim(`  Task sent: ${implTaskId}`));
-        console.log(kleur.dim("  Waiting for implementation...\n"));
-        const implResult = await connector.waitResult(implTaskId, {
-            timeoutMs: 1200000 // 20 minutes
-        });
-        if (implResult.status === "error") {
-            throw new Error(implResult.error || "Implementation failed");
-        }
-        console.log(kleur.green("✓ Implementation complete"));
-        if (implResult.filesChanged) {
-            implResult.filesChanged.forEach(file => console.log(kleur.dim(`  - ${file}`)));
-        }
-        console.log("");
-        bolt.implementationCompleted = true;
-        appendEvent(runState.runId, {
-            stage: WorkflowStage.BOLT_EXECUTION,
-            boltId: bolt.id,
-            action: "Implementation completed",
-            outputs: implResult.filesChanged,
-            resultStatus: "ok"
-        });
-    }
-    else {
-        console.log(kleur.yellow("  Bridge disabled. Skipping implementation.\n"));
-    }
-    // Step 3: Testing
-    console.log(kleur.cyan("→ Testing phase..."));
-    const testTaskId = randomUUID();
-    const testPacket = {
-        taskId: testTaskId,
-        intent: runState.intent,
-        stage: WorkflowStage.BOLT_EXECUTION,
-        agent: "iris-construction-agent",
-        instructions: `Testing phase for bolt: ${bolt.id}
-
-Run tests or propose test commands for the implemented changes.
-
-If tests exist, run them and report results.
-If no tests exist, propose what should be tested and expected outcomes.
-
-Include:
-- Test commands run
-- Test results
-- Any issues found`,
-        inputs: [
-            `memory-bank/operations/bolts/${bolt.id}.md`
-        ],
-        expectedOutputs: [],
-        metadata: { step: "testing", boltId: bolt.id }
-    };
-    appendEvent(runState.runId, {
-        stage: WorkflowStage.BOLT_EXECUTION,
-        boltId: bolt.id,
-        action: "Testing started",
-        taskId: testTaskId
-    });
-    if (!options.noBridge) {
-        await connector.sendTask(testPacket);
-        console.log(kleur.dim(`  Task sent: ${testTaskId}`));
-        console.log(kleur.dim("  Waiting for test results...\n"));
-        const testResult = await connector.waitResult(testTaskId, {
-            timeoutMs: 600000 // 10 minutes
-        });
-        console.log(kleur.green("✓ Testing complete"));
-        console.log(kleur.dim(`  ${testResult.message}`));
-        console.log("");
-        bolt.testingCompleted = true;
-        appendEvent(runState.runId, {
-            stage: WorkflowStage.BOLT_EXECUTION,
-            boltId: bolt.id,
-            action: "Testing completed",
-            message: testResult.message,
-            resultStatus: testResult.status
-        });
-    }
-    else {
-        console.log(kleur.yellow("  Bridge disabled. Skipping testing.\n"));
-    }
-    // Step 4: Gate - Approve bolt?
-    if (options.gate === "manual") {
-        console.log(kleur.bold(kleur.yellow("Gate: Bolt Completion")));
-        const { approved } = await inquirer.prompt([
-            {
-                type: "confirm",
-                name: "approved",
-                message: `Approve bolt "${bolt.id}" and continue?`,
-                default: true
-            }
-        ]);
-        appendEvent(runState.runId, {
-            stage: WorkflowStage.BOLT_EXECUTION,
-            boltId: bolt.id,
-            action: "Gate decision",
-            userGateDecision: approved ? "approved" : "rejected"
-        });
-        if (!approved) {
-            throw new Error("Bolt rejected by user");
-        }
-        console.log(kleur.green("✓ Bolt approved\n"));
-    }
-}