project-iris 0.0.11 → 0.0.12

package/dist/cli.js

@@ -15,11 +15,12 @@ import { bridgeCommand } from "./commands/bridge.js";
 import { frameworkCommand } from "./commands/framework.js";
 import { generateCommand } from "./commands/generate.js";
 import { useCommand } from "./commands/use.js";
+import { createCommand } from "./commands/create.js";
 const program = new Command();
 program
     .name("iris")
     .description("IRIS CLI - Intelligent Repository for Intent-driven Systems")
-    .version("0.0.11")
+    .version("0.0.12")
     .addCommand(installCommand)
     .addCommand(uninstallCommand)
     .addCommand(frameworkCommand)
@@ -34,5 +35,6 @@ program
     .addCommand(doctorCommand)
     .addCommand(developCommand)
     .addCommand(bridgeCommand)
-    .addCommand(useCommand);
+    .addCommand(useCommand)
+    .addCommand(createCommand);
 program.parseAsync(process.argv);

package/dist/commands/create.js

@@ -0,0 +1,25 @@
+import { Command } from "commander";
+import { generateMemoryBankStructure } from "../workflows/memory-bank-generator.js";
+import { createConnector } from "../bridge/connector-factory.js";
+import kleur from "kleur";
+export const createCommand = new Command("create")
+    .description("Create memory bank artifacts")
+    .addCommand(new Command("intent")
+    .description("Create a new intent with full structure")
+    .argument("<intent>", "Intent description")
+    .action(async (intent) => {
+    console.log(kleur.bold(`Creating intent: ${intent}`));
+    const connector = createConnector("auto");
+    try {
+        await generateMemoryBankStructure({
+            intent,
+            answers: {}, // No answers for pure creation, or we could prompt
+            connector
+        });
+        console.log(kleur.green("✓ Intent created successfully"));
+    }
+    catch (error) {
+        console.error(kleur.red(`Failed to create intent: ${error.message}`));
+        process.exit(1);
+    }
+}));

package/dist/iris_bundle/frameworks/iris-core/framework.yaml

@@ -0,0 +1,9 @@
+apiVersion: iris.framework/v1
+kind: Framework
+metadata:
+  name: iris-core
+  version: 0.0.1
+  description: Core IRIS framework with AIDLC templates
+components:
+  - templates
+  - policy

package/dist/iris_bundle/frameworks/iris-core/memory/memory-bank.yaml

@@ -0,0 +1 @@
+metadata: true

package/dist/iris_bundle/frameworks/iris-core/policy.yaml

@@ -0,0 +1,7 @@
+apiVersion: iris.policy/v1
+kind: Policy
+metadata:
+  name: default-policy
+rules:
+  - rule: "Use Templates"
+    level: "strict"

package/dist/iris_bundle/frameworks/iris-core/templates/config/memory-bank.yaml

@@ -0,0 +1 @@
+metadata: true

package/dist/iris_bundle/frameworks/iris-core/templates/construction/bolt-template.md

@@ -0,0 +1,226 @@
+# Bolt Instance Template
+
+## Mandatory Output Rules (READ FIRST)
+
+- 🚫 **NEVER** use ASCII tables for options - they break at different terminal widths
+- ✅ **ALWAYS** use numbered list format: `N - **Option**: Description`
+- ✅ **ALWAYS** use status indicators: ✅ (done) ⏳ (current) [ ] (pending) 🚫 (blocked)
+
+---
+
+Use this template when creating new bolt instances during bolt planning.
+
+**Directory Structure**: Each bolt gets its own directory containing the bolt metadata and stage artifacts:
+
+```text
+memory-bank/bolts/{bolt-id}/
+├── bolt.md                      # Bolt instance metadata (this template)
+├── ddd-01-domain-model.md       # Stage 1 artifact (created during execution)
+├── ddd-02-technical-design.md   # Stage 2 artifact (created during execution)
+└── ddd-03-test-report.md        # Stage 4 artifact (created during execution)
+```
+
+---
+
+## Frontmatter
+
+```yaml
+---
+id: bolt-{unit}-{sequence}
+unit: {UUU}-{unit-name}
+intent: {NNN}-{intent-name}
+type: ddd-construction-bolt
+status: planned
+stories:
+  - story-1
+  - story-2
+created: {YYYY-MM-DDTHH:MM:SSZ}
+started: null
+completed: null
+current_stage: null
+stages_completed: []
+
+# Bolt Dependencies (for execution ordering)
+requires_bolts: []          # Bolts that must complete before this bolt can start
+enables_bolts: []           # Bolts that become unblocked when this bolt completes
+requires_units: []          # Units that must exist (usually empty)
+blocks: false               # Computed: true if any requires_bolts are incomplete
+
+# Complexity Assessment (aggregate of included stories)
+complexity:
+  avg_complexity: 2        # 1=Low, 2=Medium, 3=High
+  avg_uncertainty: 1       # 1=Low, 2=Medium, 3=High
+  max_dependencies: 2      # Highest dependency score among stories
+  testing_scope: 2         # 1=Unit, 2=Integration, 3=E2E
+---
+```
+
+---
+
+## Required Frontmatter Fields (VALIDATION CHECKLIST)
+
+Before creating a bolt, verify ALL required fields are present:
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `id` | **YES** | Bolt identifier (format: `{BBB}-{unit-name}`) |
+| `unit` | **YES** | Parent unit ID |
+| `intent` | **YES** | Parent intent ID |
+| `type` | **YES** | Bolt type (`ddd-construction-bolt` or `simple-construction-bolt`) |
+| `status` | **YES** | Current status (`planned`, `in-progress`, `completed`, `blocked`) |
+| `stories` | **YES** | Array of story IDs included in this bolt |
+| `created` | **YES** | Creation timestamp |
+| `requires_bolts` | **YES** | Array of bolt IDs this depends on (can be empty `[]`) |
+| `enables_bolts` | **YES** | Array of bolt IDs waiting on this (can be empty `[]`) |
+| `complexity` | **YES** | Complexity assessment block |
+
+**If any required field is missing, the bolt is INVALID.**
+
+---
+
+## Content
+
+```markdown
+# Bolt: {bolt-id}
+
+## Overview
+
+{Brief description of what this bolt will accomplish}
+
+## Objective
+
+{Specific goal of this bolt tied to the stories it covers}
+
+## Stories Included
+
+- **{story-1}**: {title} (Must)
+- **{story-2}**: {title} (Should)
+
+## Bolt Type
+
+**Type**: {type name}
+**Definition**: `.iris/aidlc/templates/construction/bolt-types/{type}.md`
+
+## Stages
+
+- [ ] **1. {stage-1}**: Pending → {artifact}
+- [ ] **2. {stage-2}**: Pending → {artifact}
+- [ ] **3. {stage-3}**: Pending → {artifact}
+- [ ] **4. {stage-4}**: Pending → {artifact}
+
+## Dependencies
+
+### Requires
+- {Previous bolt or None}
+
+### Enables
+- {Next bolt or deployment}
+
+## Success Criteria
+
+- [ ] All stories implemented
+- [ ] All acceptance criteria met
+- [ ] Tests passing
+- [ ] Code reviewed
+
+## Notes
+
+{Any additional context or considerations}
+```
+
+---
+
+## Status Values
+
+- **planned**: Bolt created, not started
+- **in-progress**: Currently being executed
+- **completed**: All stages done
+- **blocked**: Cannot proceed due to dependency
+
+---
+
+## Stage Status Symbols
+
+- [ ] = Pending
+- ⏳ = In Progress
+- ✅ = Complete
+- 🚫 = Blocked
+
+---
+
+## Example
+
+```yaml
+---
+id: bolt-auth-service-1
+unit: 001-auth-service
+intent: 001-user-authentication
+type: ddd-construction-bolt
+status: in-progress
+stories:
+  - story-1
+  - story-2
+created: 2024-12-05
+started: 2024-12-05
+completed: null
+current_stage: design
+stages_completed:
+  - name: model
+    completed: 2024-12-05T10:00:00Z
+    artifact: ddd-01-domain-model.md
+
+requires_bolts: []
+enables_bolts:
+  - bolt-auth-service-2
+requires_units: []
+blocks: false
+
+complexity:
+  avg_complexity: 2
+  avg_uncertainty: 1
+  max_dependencies: 1
+  testing_scope: 2
+---
+
+# Bolt: bolt-auth-service-1
+
+## Overview
+
+First bolt for authentication service covering user registration and login.
+
+## Objective
+
+Implement core authentication functionality including user registration with email verification and secure login.
+
+## Stories Included
+
+- **story-1**: User can register (Must)
+- **story-2**: User can login (Must)
+
+## Bolt Type
+
+**Type**: DDD Construction Bolt
+**Definition**: `.iris/aidlc/templates/construction/bolt-types/ddd-construction-bolt.md`
+
+## Stages
+
+- ✅ **1. model**: Complete → ddd-01-domain-model.md
+- ⏳ **2. design**: In Progress → ddd-02-technical-design.md ← current
+- [ ] **3. implement**: Pending → src/auth-service/
+- [ ] **4. test**: Pending → ddd-03-test-report.md
+
+## Dependencies
+
+### Requires
+- None (first bolt)
+
+### Enables
+- bolt-auth-service-2 (MFA implementation)
+
+## Success Criteria
+
+- ✅ Domain model defined
+- [ ] API design complete
+- [ ] Implementation complete
+- [ ] Tests passing
+```

package/dist/iris_bundle/frameworks/iris-core/templates/construction/bolt-types/ddd-construction-bolt/adr-template.md

@@ -0,0 +1,49 @@
+---
+bolt: {bolt-id}
+created: {YYYY-MM-DDTHH:MM:SSZ}
+status: proposed | accepted | deprecated | superseded
+superseded_by: {adr-number if applicable}
+---
+
+# ADR-{number}: {title}
+
+## Context
+
+{Describe the situation that requires a decision. What is the problem or opportunity? What constraints exist? What forces are at play?}
+
+## Decision
+
+{State the decision clearly. What did we decide to do?}
+
+## Rationale
+
+{Explain why this decision was made. What alternatives were considered? Why were they rejected?}
+
+### Alternatives Considered
+
+| Alternative | Pros | Cons | Why Rejected |
+|-------------|------|------|--------------|
+| {option 1} | | | |
+| {option 2} | | | |
+
+## Consequences
+
+### Positive
+
+- {Benefit 1}
+- {Benefit 2}
+
+### Negative
+
+- {Trade-off 1}
+- {Trade-off 2}
+
+### Risks
+
+- {Risk 1 and mitigation}
+
+## Related
+
+- **Stories**: {related story IDs}
+- **Standards**: {if this should be added to standards later}
+- **Previous ADRs**: {related ADR numbers}

package/dist/iris_bundle/frameworks/iris-core/templates/construction/bolt-types/ddd-construction-bolt/ddd-01-domain-model-template.md

@@ -0,0 +1,55 @@
+---
+unit: {UUU}-{unit-name}
+bolt: {BBB}-{unit-name}
+stage: model
+status: complete
+updated: {YYYY-MM-DDTHH:MM:SSZ}
+---
+
+# Static Model - {Unit Name}
+
+## Bounded Context
+
+{Define the bounded context for this unit}
+
+## Domain Entities
+
+| Entity | Properties | Business Rules |
+|--------|------------|----------------|
+| {Entity} | {properties} | {rules} |
+
+## Value Objects
+
+| Value Object | Properties | Constraints |
+|--------------|------------|-------------|
+| {ValueObject} | {properties} | {constraints} |
+
+## Aggregates
+
+| Aggregate Root | Members | Invariants |
+|----------------|---------|------------|
+| {Root} | {members} | {invariants} |
+
+## Domain Events
+
+| Event | Trigger | Payload |
+|-------|---------|---------|
+| {Event} | {trigger} | {payload} |
+
+## Domain Services
+
+| Service | Operations | Dependencies |
+|---------|------------|--------------|
+| {Service} | {operations} | {dependencies} |
+
+## Repository Interfaces
+
+| Repository | Entity | Methods |
+|------------|--------|---------|
+| {Repository} | {entity} | {methods} |
+
+## Ubiquitous Language
+
+| Term | Definition |
+|------|------------|
+| {term} | {definition} |

package/dist/iris_bundle/frameworks/iris-core/templates/construction/bolt-types/ddd-construction-bolt/ddd-02-technical-design-template.md

@@ -0,0 +1,67 @@
+---
+unit: {UUU}-{unit-name}
+bolt: {BBB}-{unit-name}
+stage: design
+status: complete
+updated: {YYYY-MM-DDTHH:MM:SSZ}
+---
+
+# Technical Design - {Unit Name}
+
+## Architecture Pattern
+
+{Selected pattern and rationale - e.g., Hexagonal, Clean Architecture}
+
+## Layer Structure
+
+```text
+┌─────────────────────────────┐
+│      Presentation           │  API/UI
+├─────────────────────────────┤
+│      Application            │  Use Cases
+├─────────────────────────────┤
+│        Domain               │  Business Logic
+├─────────────────────────────┤
+│     Infrastructure          │  Database/External
+└─────────────────────────────┘
+```
+
+## API Design
+
+| Endpoint | Method | Request | Response |
+|----------|--------|---------|----------|
+| {endpoint} | {GET/POST/etc} | {request schema} | {response schema} |
+
+## Data Persistence
+
+| Table | Columns | Relationships |
+|-------|---------|---------------|
+| {table} | {columns} | {relationships} |
+
+## Security Design
+
+| Concern | Approach |
+|---------|----------|
+| Authentication | {approach} |
+| Authorization | {approach} |
+| Data Encryption | {approach} |
+
+## NFR Implementation
+
+| Requirement | Design Approach |
+|-------------|-----------------|
+| Performance | {approach} |
+| Scalability | {approach} |
+| Reliability | {approach} |
+
+## Error Handling
+
+| Error Type | Code | Response |
+|------------|------|----------|
+| {type} | {code} | {response} |
+
+## External Dependencies
+
+| Service | Purpose | Integration |
+|---------|---------|-------------|
+| {service} | {purpose} | {REST/Event/etc} |

package/dist/iris_bundle/frameworks/iris-core/templates/construction/bolt-types/ddd-construction-bolt/ddd-03-test-report-template.md

@@ -0,0 +1,62 @@
+---
+unit: {UUU}-{unit-name}
+bolt: {BBB}-{unit-name}
+stage: test
+status: complete
+updated: {YYYY-MM-DDTHH:MM:SSZ}
+---
+
+# Test Report - {Unit Name}
+
+## Test Summary
+
+| Category | Passed | Failed | Skipped | Coverage |
+|----------|--------|--------|---------|----------|
+| Unit | {n} | {n} | {n} | {n}% |
+| Integration | {n} | {n} | {n} | {n}% |
+| Security | {n} | {n} | {n} | - |
+| Performance | {n} | {n} | {n} | - |
+| **Total** | {n} | {n} | {n} | {n}% |
+
+## Acceptance Criteria Validation
+
+| Story | Criteria | Status |
+|-------|----------|--------|
+| {story-id} | {criteria} | ✅/❌ |
+
+## Unit Tests
+
+{Unit test results and notable tests}
+
+## Integration Tests
+
+{Integration test results}
+
+## Security Tests
+
+{Security test results - authentication, authorization, injection, etc.}
+
+## Performance Tests
+
+| Metric | Target | Actual | Status |
+|--------|--------|--------|--------|
+| Response Time (p95) | {target} | {actual} | ✅/❌ |
+| Throughput | {target} | {actual} | ✅/❌ |
+
+## Coverage Report
+
+{Coverage details by module/layer}
+
+## Issues Found
+
+| Issue | Severity | Status |
+|-------|----------|--------|
+| {issue} | {High/Medium/Low} | {Fixed/Open} |
+
+## Ready for Operations
+
+- [ ] All acceptance criteria met
+- [ ] Code coverage > 80%
+- [ ] No critical/high severity issues open
+- [ ] Performance targets met
+- [ ] Security tests passing