project-iris 0.0.7 → 0.0.11

package/dist/workflows/intent-inception.js

@@ -14,75 +14,97 @@ import { appendEvent, saveRun } from "../iris/run-state.js";
 export async function executeIntentInception(runState, connector, options) {
     console.log(kleur.bold("Intent Inception Stage"));
     console.log(kleur.dim("Clarifying requirements and creating intent artifacts\n"));
-    // Step 1: Generate clarifying questions
-    console.log(kleur.cyan("→ Generating clarifying questions..."));
-    const questionsTaskId = randomUUID();
-    const questionsPacket = {
-        taskId: questionsTaskId,
-        intent: runState.intent,
-        stage: WorkflowStage.INTENT_INCEPTION,
-        agent: "iris-inception-agent",
-        instructions: `Based on the intent "${runState.intent}", generate 3-8 clarifying questions to better understand:
-- The problem being solved
-- Success criteria
-- Scope and constraints
-- Technical requirements
-- User expectations
-
-Return the questions as a JSON array of strings in the result message.`,
-        inputs: [],
-        expectedOutputs: [],
-        metadata: { step: "clarifying_questions" }
-    };
-    appendEvent(runState.runId, {
-        stage: WorkflowStage.INTENT_INCEPTION,
-        action: "Requesting clarifying questions",
-        taskId: questionsTaskId
-    });
-    if (options.noBridge) {
-        console.log(kleur.yellow("  Bridge disabled. Task packet written to:"));
-        console.log(kleur.dim(`  .iris/bridge/inbox/${questionsTaskId}.json`));
-        console.log(kleur.dim("  Manually create result in .iris/bridge/outbox/\n"));
-        return;
-    }
     try {
-        await connector.sendTask(questionsPacket);
-        console.log(kleur.dim(`  Task sent: ${questionsTaskId}`));
-        console.log(kleur.dim("  Waiting for IDE agent response...\n"));
-        const questionsResult = await connector.waitResult(questionsTaskId, {
-            timeoutMs: 300000 // 5 minutes
-        });
-        if (questionsResult.status === "error") {
-            throw new Error(questionsResult.error || "Failed to generate questions");
-        }
-        // Parse questions from result
-        let questions;
-        try {
-            questions = JSON.parse(questionsResult.message);
+        // Step 1: Clarification Loop (Ping-Pong)
+        console.log(kleur.cyan("→ Starting clarification loop..."));
+        const history = [];
+        let isDone = false;
+        let turnCount = 0;
+        const MAX_TURNS = 10;
+        while (!isDone && turnCount < MAX_TURNS) {
+            turnCount++;
+            const turnId = randomUUID();
+            // Prepare context for the agent
+            const contextStr = history.map(h => `Q: ${h.question}\nA: ${h.answer}`).join("\n\n");
+            const instructions = `You are an expert product manager refining a user's intent.
+Intent: "${runState.intent}"
+
+Current Understanding (Q&A History):
+${contextStr || "(None yet)"}
+
+Task:
+Analyze the intent and history.
+You MUST clarify the following aspects before finishing:
+1. Target User & Use Case
+2. Technical Constraints (Language, Frameworks, Database)
+3. Success Criteria (Specific requirements)
+4. Non-Goals (What to avoid)
+
+Instructions:
+1. If you have clear answers for ALL the above aspects, return exactly the string "DONE".
+2. If any aspect is missing or vague, ask the SINGLE most important clarifying question to ask the user next.
+
+Return ONLY the question string or "DONE". Do not include JSON or explanation.`;
+            const packet = {
+                taskId: turnId,
+                intent: runState.intent,
+                stage: WorkflowStage.INTENT_INCEPTION,
+                agent: "iris-inception-agent",
+                instructions,
+                inputs: [],
+                expectedOutputs: [],
+                metadata: { step: "clarify_turn", turn: turnCount }
+            };
+            if (options.noBridge) {
+                console.log(kleur.yellow(`  [Turn ${turnCount}] Bridge disabled. Write result to .iris/bridge/inbox/${turnId}.json`));
+                return; // Cannot proceed in loop without bridge in this mock implementation
+            }
+            // Inner try/catch for turn resilience
+            try {
+                await connector.sendTask(packet);
+                // Show loading spinner or status?
+                const turnResult = await connector.waitResult(turnId, { timeoutMs: 120000 }); // 2 mins per turn
+                if (turnResult.status === "error") {
+                    throw new Error(turnResult.error || "Agent failed to respond");
+                }
+                const agentResponse = turnResult.message.trim();
+                if (agentResponse === "DONE" || agentResponse.includes('"DONE"')) {
+                    isDone = true;
+                    console.log(kleur.green("\n✓ Intent clarified. Proceeding to design...\n"));
+                }
+                else {
+                    // It's a question
+                    const question = agentResponse.replace(/^"|"$/g, ""); // strip quotes if present
+                    console.log(kleur.bold(`\n${question}`));
+                    const { answer } = await inquirer.prompt([
+                        {
+                            type: "input",
+                            name: "answer",
+                            message: "Answer:",
+                            validate: (val) => val.trim().length > 0 || "Please provide an answer"
+                        }
+                    ]);
+                    history.push({ question, answer });
+                    // Append event for tracking
+                    appendEvent(runState.runId, {
+                        stage: WorkflowStage.INTENT_INCEPTION,
+                        action: "Q&A Turn",
+                        message: `Q: ${question}\nA: ${answer}`
+                    });
+                }
+            }
+            catch (e) {
+                console.error(kleur.red(`Error in clarification loop: ${e.message}`));
+                break; // Exit loop on error to save partial progress
+            }
         }
-        catch {
-            // Fallback: treat message as newline-separated questions
-            questions = questionsResult.message.split("\n").filter(q => q.trim());
+        if (history.length > 0) {
+            console.log(kleur.dim(`Captured ${history.length} clarification points.`));
         }
-        console.log(kleur.green("✓ Questions received\n"));
-        // Step 2: Prompt user for answers
-        console.log(kleur.bold("Clarifying Questions:"));
+        // Prepare answers object for artifact generation (format match)
         const answers = {};
-        for (let i = 0; i < questions.length; i++) {
-            const { answer } = await inquirer.prompt([
-                {
-                    type: "input",
-                    name: "answer",
-                    message: `${i + 1}. ${questions[i]}`
-                }
-            ]);
-            answers[questions[i]] = answer;
-        }
-        console.log("");
-        appendEvent(runState.runId, {
-            stage: WorkflowStage.INTENT_INCEPTION,
-            action: "User answered clarifying questions",
-            message: `${questions.length} questions answered`
+        history.forEach((h, i) => {
+            answers[`${i + 1}. ${h.question}`] = h.answer;
         });
         // Step 3: Generate intent artifacts
         console.log(kleur.cyan("→ Generating intent artifacts..."));

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "project-iris",
-  "version": "0.0.07",
+  "version": "0.0.11",
   "type": "module",
   "bin": {
     "iris": "dist/cli.js",
     "project-iris": "dist/cli.js"
   },
   "files": [
-    "dist/**",
-    "src/iris_bundle/**"
+    "dist/**"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
@@ -21,8 +20,10 @@
     "link:iris": "npm run build && chmod +x dist/cli.js && npm link && echo '\n✓ iris linked globally' && echo 'Run: iris doctor' && echo 'If iris is not found, add global bin to PATH:' && echo '  export PATH=\"$(npm prefix -g)/bin:$PATH\"'",
     "unlink:iris": "npm unlink -g && echo '✓ iris unlinked'",
     "doctor": "npm run iris -- doctor",
-    "prepublishOnly": "npm run build && node dist/cli.js --help",
-    "test:smoke": "npm run build && node scripts/smoke-install.js"
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:integration": "vitest run test/integration",
+    "test:smoke": "npm run build && vitest run test/smoke --sequence.concurrent false"
   },
   "dependencies": {
     "@types/js-yaml": "^4.0.9",
@@ -37,6 +38,7 @@
     "@types/inquirer": "^9.0.9",
     "@types/node": "^22.10.2",
     "ts-node": "^10.9.2",
-    "typescript": "^5.6.3"
+    "typescript": "^5.6.3",
+    "vitest": "^4.0.16"
   }
 }

package/src/iris_bundle/.iris/aidlc/README.md

@@ -1,16 +0,0 @@
-# IRIS AI-DLC Doctrine (Full SDLC) — Core Pack (#1–#4)
-
-This folder is the **authoritative doctrine** for IRIS: a strict, file-based SDLC operating system for AI-assisted development.
-
-## What is implemented in this pack
-1. **Frozen doctrine layout**
-2. **Strict doc schema applied to core docs**
-3. **Canonical SDLC artifacts + templates**
-4. **Phase transitions (preconditions + exit criteria)**
-
-## Non‑negotiables
-- Doctrine governs; tools execute.
-- If it isn't in files, it is unknown.
-- Missing prerequisites are a hard stop.
-
-Start with: `quick-start.md` then `standards/phases-and-gates.md`.

package/src/iris_bundle/.iris/aidlc/agents/iris-construction-agent.md

@@ -1,35 +0,0 @@
-# IRIS Construction Agent
-
-## Purpose
-Implement approved units/bolts with verifiable evidence.
-
-## Inputs
-- Approved unit(s)
-- Ready bolts (optional but recommended)
-
-## Outputs
-- Code changes
-- Verification evidence (review/log)
-- Construction completion log
-
-
-## Hard Rules (Global)
-- MUST follow `standards/phases-and-gates.md`.
-- MUST treat missing prerequisites as a hard stop (`validation/phase-preconditions.md`).
-- MUST log non-trivial decisions (`standards/decision-logging.md`).
-- MUST produce file-addressable outputs (exact paths).
-- MUST NOT invent project state.
-
-## Default Output Format
-- Plan (short)
-- File path list (create/modify)
-- Gate mapping (which checklist items are satisfied)
-- Stop conditions (if blocked)
-
-
-## Procedure
-1. Load unit + bolt(s).
-2. Implement smallest change set.
-3. Verify (`skills/reasoning/verification.md`).
-4. Record evidence.
-5. If scope expands, STOP and request Inception update.

package/src/iris_bundle/.iris/aidlc/agents/iris-inception-agent.md

@@ -1,30 +0,0 @@
-# IRIS Inception Agent
-
-## Purpose
-Create and approve intent + units with testable acceptance criteria.
-
-## Outputs
-- Approved intent + approved units
-- Inception kickoff log
-
-
-## Hard Rules (Global)
-- MUST follow `standards/phases-and-gates.md`.
-- MUST treat missing prerequisites as a hard stop (`validation/phase-preconditions.md`).
-- MUST log non-trivial decisions (`standards/decision-logging.md`).
-- MUST produce file-addressable outputs (exact paths).
-- MUST NOT invent project state.
-
-## Default Output Format
-- Plan (short)
-- File path list (create/modify)
-- Gate mapping (which checklist items are satisfied)
-- Stop conditions (if blocked)
-
-
-## Procedure
-1. Draft intent (`templates/intent.md`) and refine until measurable.
-2. Decompose into units (`skills/reasoning/decomposition.md`).
-3. Add risks/rollback (`skills/reasoning/risk-analysis.md`).
-4. Approve only when gates pass; otherwise keep Draft.
-5. Log key decisions.

package/src/iris_bundle/.iris/aidlc/agents/iris-master-agent.md

@@ -1,35 +0,0 @@
-# IRIS Master Agent
-
-## Purpose
-Route work, enforce gates, and resolve conflicts across phases.
-
-## Inputs
-- Doctrine: `.iris/aidlc/**`
-- Project memory: `memory-bank/**`
-
-## Outputs
-- Routing decisions
-- Gate decisions + reviews
-- Decision logs for architecture-level choices
-
-
-## Hard Rules (Global)
-- MUST follow `standards/phases-and-gates.md`.
-- MUST treat missing prerequisites as a hard stop (`validation/phase-preconditions.md`).
-- MUST log non-trivial decisions (`standards/decision-logging.md`).
-- MUST produce file-addressable outputs (exact paths).
-- MUST NOT invent project state.
-
-## Default Output Format
-- Plan (short)
-- File path list (create/modify)
-- Gate mapping (which checklist items are satisfied)
-- Stop conditions (if blocked)
-
-
-## Procedure
-1. Identify current phase + requested action.
-2. Load required artifacts for that phase.
-3. If prerequisites missing, STOP and request exact file(s).
-4. Route to the correct phase agent.
-5. Enforce gate completion before any transition.

package/src/iris_bundle/.iris/aidlc/agents/iris-operations-agent.md

@@ -1,29 +0,0 @@
-# IRIS Operations Agent
-
-## Purpose
-Operate and stabilize: handover, monitoring, incidents, maintenance.
-
-## Outputs
-- Ops handover log
-- Incident logs and postmortems (when needed)
-
-
-## Hard Rules (Global)
-- MUST follow `standards/phases-and-gates.md`.
-- MUST treat missing prerequisites as a hard stop (`validation/phase-preconditions.md`).
-- MUST log non-trivial decisions (`standards/decision-logging.md`).
-- MUST produce file-addressable outputs (exact paths).
-- MUST NOT invent project state.
-
-## Default Output Format
-- Plan (short)
-- File path list (create/modify)
-- Gate mapping (which checklist items are satisfied)
-- Stop conditions (if blocked)
-
-
-## Procedure
-1. Confirm Ops entry prerequisites.
-2. Maintain runbooks/logs.
-3. For incidents: log → triage → resolve → postmortem (if major).
-4. Feed learnings into standards or new intents.

package/src/iris_bundle/.iris/aidlc/commands/iris-construction-agent.md

@@ -1,18 +0,0 @@
-# /iris-construction-agent
-
-## Purpose
-Run the Construction Agent: implement approved work with evidence.
-
-## Loads
-- `.iris/aidlc/standards/**`
-- `.iris/aidlc/validation/**`
-- `.iris/aidlc/memory/**`
-- `.iris/aidlc/agents/iris-construction-agent.md`
-- `memory-bank/**`
-
-## Required inputs
-See: `.iris/aidlc/validation/phase-preconditions.md`
-
-## Output expectations
-- File-addressable deliverables
-- Evidence and logs where required

package/src/iris_bundle/.iris/aidlc/commands/iris-inception-agent.md

@@ -1,18 +0,0 @@
-# /iris-inception-agent
-
-## Purpose
-Run the Inception Agent: produce approved intent and units.
-
-## Loads
-- `.iris/aidlc/standards/**`
-- `.iris/aidlc/validation/**`
-- `.iris/aidlc/memory/**`
-- `.iris/aidlc/agents/iris-inception-agent.md`
-- `memory-bank/**`
-
-## Required inputs
-See: `.iris/aidlc/validation/phase-preconditions.md`
-
-## Output expectations
-- File-addressable deliverables
-- Evidence and logs where required

package/src/iris_bundle/.iris/aidlc/commands/iris-master-agent.md

@@ -1,18 +0,0 @@
-# /iris-master-agent
-
-## Purpose
-Run the Master Agent: route work and enforce SDLC gates.
-
-## Loads
-- `.iris/aidlc/standards/**`
-- `.iris/aidlc/validation/**`
-- `.iris/aidlc/memory/**`
-- `.iris/aidlc/agents/iris-master-agent.md`
-- `memory-bank/**`
-
-## Required inputs
-See: `.iris/aidlc/validation/phase-preconditions.md`
-
-## Output expectations
-- File-addressable deliverables
-- Evidence and logs where required

package/src/iris_bundle/.iris/aidlc/commands/iris-operations-agent.md

@@ -1,18 +0,0 @@
-# /iris-operations-agent
-
-## Purpose
-Run the Operations Agent: stabilize and maintain.
-
-## Loads
-- `.iris/aidlc/standards/**`
-- `.iris/aidlc/validation/**`
-- `.iris/aidlc/memory/**`
-- `.iris/aidlc/agents/iris-operations-agent.md`
-- `memory-bank/**`
-
-## Required inputs
-See: `.iris/aidlc/validation/phase-preconditions.md`
-
-## Output expectations
-- File-addressable deliverables
-- Evidence and logs where required

package/src/iris_bundle/.iris/aidlc/context/context-map.md

@@ -1,25 +0,0 @@
-# Context Map
-
-## Purpose
-Define what IRIS loads as context per phase.
-
-## Always load
-- `.iris/aidlc/standards/**`
-- `.iris/aidlc/memory/**`
-- `.iris/aidlc/validation/**`
-
-## Phase-specific
-### Inception
-- templates: `intent.md`, `unit.md`
-- standards: `phases-and-gates.md`
-
-### Construction
-- approved unit(s) + related bolts
-- templates: `bolt.md`, `review.md`
-
-### Operations
-- handover + incident/process logs
-- template: `log.md`
-
-## Hard Rules
-- Context MUST be minimal but sufficient.

package/src/iris_bundle/.iris/aidlc/context/exclusion-rules.md

@@ -1,13 +0,0 @@
-# Exclusion Rules
-
-## Purpose
-Prevent context bloat and leakage.
-
-## Hard Rules
-- MUST NOT load:
-  - `node_modules/`, build artifacts, binaries
-  - secrets (`.env`, keys, credentials)
-  - large generated files unless required for verification
-
-## Recovery
-If context is too large, reduce to: intent + unit + relevant code + checklist.

package/src/iris_bundle/.iris/aidlc/context/load-order.md

@@ -1,25 +0,0 @@
-# Context Load Order (Canonical)
-
-Tools and runners MUST load context in this order:
-
-1. IRIS phase doctrine
-   - `.iris/aidlc/standards/phases-and-gates.md`
-   - `.iris/aidlc/validation/phase-preconditions.md`
-
-2. IRIS artifact doctrine
-   - `.iris/aidlc/standards/artifacts-registry.md`
-   - `.iris/aidlc/memory/memory-bank.yaml`
-   - `.iris/aidlc/memory/*-rules.md`
-
-3. The requested entrypoint
-   - `.iris/aidlc/commands/<command>.md`
-
-4. Repo-local project signals (if present)
-   - `specs.md`, `README.md`, `package.json`, `tsconfig.json`, relevant `src/**`
-
-5. Phase-specific memory-bank artifacts (if present)
-   - Inception: `memory-bank/intents/**`
-   - Construction: `memory-bank/units/**`, `memory-bank/bolts/**`
-   - Operations: `memory-bank/logs/**`, `memory-bank/standards/**`
-
-If required artifacts are missing, IRIS MUST stop and request creation using templates.

package/src/iris_bundle/.iris/aidlc/memory/intent-rules.md

@@ -1,9 +0,0 @@
-# Intent Rules
-
-## Hard Rules
-- Every repo MUST have at least one active intent.
-- Intent MUST include: Problem, Goals, Non-goals, Constraints, Definition of Done.
-- Any intent change MUST be logged.
-
-## Quality Gate
-If goals are not measurable, the intent is not ready.

package/src/iris_bundle/.iris/aidlc/memory/log-rules.md

@@ -1,5 +0,0 @@
-# Log Rules
-
-## Hard Rules
-- Logs are append-only via new files.
-- Any architecture/behavior decision MUST be logged using `templates/log.md`.

package/src/iris_bundle/.iris/aidlc/memory/memory-bank.yaml

@@ -1,39 +0,0 @@
-name: iris-memory-bank
-version: '1.0'
-root: memory-bank
-folders:
-  intents:
-    required: true
-    description: High-level problems and DoD.
-  units:
-    required: true
-    description: Work units with acceptance + approvals.
-  bolts:
-    required: true
-    description: Implementation briefs linked to units.
-  standards:
-    required: true
-    description: Project-local standards (cannot contradict doctrine).
-  logs:
-    required: true
-    description: Decisions, reviews, incidents (append-only).
-naming:
-  style: kebab-case
-  log_prefix: YYYY-MM-DD__
-  status_values:
-  - Draft
-  - Approved
-  - In Progress
-  - Done
-  - Archived
-minimum_required_by_phase:
-  Inception:
-  - intents/<intent>.md (Approved)
-  - units/<unit>/unit.md (Approved)
-  - logs/<date>__inception-kickoff.md
-  Construction:
-  - units/<unit>/unit.md (Approved)
-  - bolts/<unit>/<bolt>/bolt.md (Ready)
-  - logs/<date>__construction-start.md
-  Operations:
-  - logs/<date>__ops-handover.md

package/src/iris_bundle/.iris/aidlc/memory/unit-rules.md

@@ -1,9 +0,0 @@
-# Unit Rules
-
-## Hard Rules
-- Units MUST be testable and scoped.
-- Units MUST include: Scope, Acceptance, Test Plan, Risks, Rollback.
-- Construction MUST reference an approved unit.
-
-## Approval
-A unit is approved when `Status: Approved` is set and an approval log exists.

package/src/iris_bundle/.iris/aidlc/quick-start.md

@@ -1,24 +0,0 @@
-# Quick Start (IRIS Doctrine)
-
-## 1) Create the canonical memory bank (repo root)
-```
-memory-bank/
-  intents/
-  units/
-  bolts/
-  standards/
-  logs/
-```
-
-## 2) Work in phases
-- **Inception** → define & approve intent + units
-- **Construction** → implement approved units/bolts with evidence
-- **Operations** → maintain, monitor, respond, stabilize
-
-## 3) Use templates
-Templates live in `.iris/aidlc/templates/`. Create artifacts in `memory-bank/`.
-
-## 4) Gate everything
-Before changing phases, validate with:
-- `.iris/aidlc/validation/phase-preconditions.md`
-- `.iris/aidlc/validation/quality-checklist.md`

package/src/iris_bundle/.iris/aidlc/skills/execution/implementation.md

@@ -1,14 +0,0 @@
-# Skill: Implementation
-
-## Purpose
-Implement bolts against approved units with traceable verification.
-
-## Hard Rules
-- MUST stay within unit scope.
-- MUST run verification per unit test plan.
-- MUST log significant decisions.
-
-## Procedure
-1. Read unit + bolt.
-2. Implement smallest change set.
-3. Verify and record evidence.

package/src/iris_bundle/.iris/aidlc/skills/execution/refactoring.md

@@ -1,13 +0,0 @@
-# Skill: Refactoring
-
-## Purpose
-Improve internal quality without changing behavior unless approved.
-
-## Hard Rules
-- MUST NOT change behavior without updating intent/unit.
-- MUST re-run tests.
-
-## Procedure
-1. Define invariants.
-2. Refactor in small steps.
-3. Verify after each step.

package/src/iris_bundle/.iris/aidlc/skills/execution/scaffold-generation.md

@@ -1,15 +0,0 @@
-# Skill: Scaffold Generation
-
-## Purpose
-Create minimal structure required by the unit.
-
-## Hard Rules
-- MUST create only what the unit requires.
-- MUST NOT create speculative modules.
-- MUST keep changes reviewable.
-
-## Procedure
-1. Identify required modules and interfaces.
-2. Generate minimal files.
-3. Ensure it builds/runs (if applicable).
-4. Record created paths in the unit.

package/src/iris_bundle/.iris/aidlc/skills/governance/escalation.md

@@ -1,13 +0,0 @@
-# Skill: Escalation
-
-## Hard Rules
-Escalate to Master Agent when:
-- artifacts conflict
-- a phase transition is requested without prerequisites
-- an architectural decision is required
-
-## Procedure
-1. Summarize conflict.
-2. Provide options + tradeoffs.
-3. Request explicit decision.
-4. Log outcome.

package/src/iris_bundle/.iris/aidlc/skills/governance/quality-gates.md

@@ -1,14 +0,0 @@
-# Skill: Quality Gates
-
-## Purpose
-Fail-closed quality enforcement.
-
-## Hard Rules
-- MUST fail closed: missing evidence = gate failed.
-- MUST record pass/fail in a review/log.
-- MUST NOT proceed after a failed gate.
-
-## Procedure
-1. Run checklist.
-2. Verify artifacts exist.
-3. Record results + evidence.