project-iris 0.0.1

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/inception-log.md

@@ -0,0 +1,101 @@
+---
+intent: vscode-extension
+created: 2025-12-25T16:45:00Z
+completed: 2025-12-25T18:30:00Z
+status: complete
+---
+
+# Inception Log: vscode-extension
+
+## Overview
+
+**Intent**: VS Code extension with dashboard sidebar for browsing AI-DLC memory-bank artifacts
+**Type**: green-field
+**Created**: 2025-12-25
+
+## Artifacts Created
+
+| Artifact | Status | File |
+|----------|--------|------|
+| Requirements | ✅ | requirements.md |
+| System Context | ✅ | system-context.md |
+| Units | ✅ | units.md |
+| Stories | ✅ | units/{unit-name}/stories/*.md (17 stories) |
+| Bolt Plan | ✅ | memory-bank/bolts/bolt-*.md (6 bolts) |
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Functional Requirements | 7 (FR-1 to FR-7) |
+| Future Requirements | 2 (FR-8, FR-9) |
+| Non-Functional Requirements | 4 |
+| Units | 5 |
+| Stories | 17 |
+| Bolts Planned | 6 |
+
+## Units Breakdown
+
+| Unit | Stories | Bolts | Priority |
+|------|---------|-------|----------|
+| artifact-parser | 4 | bolt-artifact-parser-1 | Foundation |
+| file-watcher | 2 | bolt-file-watcher-1 | Core |
+| sidebar-provider | 5 | bolt-sidebar-provider-1, bolt-sidebar-provider-2 | Core |
+| welcome-view | 3 | bolt-welcome-view-1 | Core |
+| extension-core | 3 | bolt-extension-core-1 | Final |
+
+## Decision Log
+
+| Date | Decision | Rationale | Approved |
+|------|----------|-----------|----------|
+| 2025-12-25 | Separate extension, not fabriqa fork | Clean separation, different purpose | Yes |
+| 2025-12-25 | Dashboard only (no editor) Phase 1 | Reduce scope, faster delivery | Yes |
+| 2025-12-25 | Use default VS Code editor | Leverage existing tools | Yes |
+| 2025-12-25 | Location: vs-code-extension/ | Keep in irismd monorepo | Yes |
+| 2025-12-25 | No multi-root workspace support | Simplify implementation | Yes |
+| 2025-12-25 | Show ALL bolt stages (not just current) | Better visibility of progress | Yes |
+| 2025-12-25 | Extension name: "irismd extension" | Consistent branding | Yes |
+| 2025-12-25 | Add installation prompt for new projects | Onboarding experience | Yes |
+| 2025-12-25 | Use favicon.png for activity bar icon | Consistent branding | Yes |
+| 2025-12-25 | Add pixel logo fadeout footer in sidebar | Brand presence | Yes |
+| 2025-12-25 | Add refresh button in sidebar title bar | Manual refresh option | Yes |
+| 2025-12-25 | Real-time updates is Must priority | Core functionality | Yes |
+| 2025-12-25 | Specific status icons (gray/yellow/green) | Clear visual language | Yes |
+| 2025-12-25 | Sort intents by number prefix | Logical ordering | Yes |
+| 2025-12-25 | Bolts: in-progress first, configurable grouping | Prioritize active work | Yes |
+
+## Scope Changes
+
+| Date | Change | Reason | Impact |
+|------|--------|--------|--------|
+
+## Ready for Construction
+
+**Checklist**:
+- [x] All requirements documented
+- [x] System context defined
+- [x] Units decomposed
+- [x] Stories created for all units
+- [x] Bolts planned
+- [x] Human review complete (Checkpoint 3 approved)
+
+## Bolt Execution Order
+
+1. **bolt-artifact-parser-1** (foundation - no dependencies)
+2. **bolt-file-watcher-1** (depends on artifact-parser)
+3. **bolt-sidebar-provider-1** (depends on artifact-parser)
+4. **bolt-sidebar-provider-2** (depends on sidebar-provider-1)
+5. **bolt-welcome-view-1** (depends on artifact-parser, file-watcher)
+6. **bolt-extension-core-1** (final - depends on all above)
+
+## Next Steps
+
+Start Construction Phase:
+1. Run `/irismd-construction-agent`
+2. Begin with `bolt-artifact-parser-1`
+3. Follow bolt execution order above
+
+## Dependencies
+
+- Requires stable memory-bank schema (memory-bank.yaml)
+- No dependencies on other irismd intents

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/requirements.md

@@ -0,0 +1,282 @@
+---
+intent: vscode-extension
+phase: construction
+status: construction
+created: 2025-12-25
+updated: 2025-12-26
+---
+
+# Requirements: VS Code Extension
+
+## Intent Overview
+
+Create a VS Code extension ("irismd extension") that provides a dashboard sidebar for browsing and managing AI-DLC memory-bank artifacts. The extension displays intents, units, stories, bolts, and standards in a hierarchical tree view with real-time status indicators and file watching.
+
+**Extension Name**: irismd extension
+**Location**: `vs-code-extension/` folder in irismd root
+**Workspace**: Single workspace only (no multi-root support)
+
+**Inspiration**: fabriqa-markdown-editor sidebar patterns (separate project, not a fork)
+
+## Business Goals
+
+| Goal | Success Metric | Priority |
+|------|----------------|----------|
+| Enable visual navigation of memory-bank | Users can browse all artifacts in sidebar | Must |
+| Show AI-DLC progress at a glance | Status indicators visible for all artifacts | Must |
+| Real-time updates | Sidebar reflects file changes within 1 second | Must |
+| Reduce context switching | Users stay in VS Code for AI-DLC workflow | Should |
+
+---
+
+## Functional Requirements
+
+### FR-1: Sidebar Dashboard
+
+- FR-1.1: Extension SHALL provide a sidebar view in VS Code activity bar
+- FR-1.2: Sidebar SHALL display memory-bank artifacts in a tree structure
+- FR-1.3: Sidebar SHALL be titled "irismd" with icon from `docs.iris.md/images/favicon.png`
+- FR-1.4: Sidebar SHALL auto-detect irismd projects (presence of `memory-bank/` or `.irismd/`)
+- FR-1.5: Sidebar SHALL display iris.md pixel logo (`src/logo.png`) as fadeout footer at bottom
+- FR-1.6: Sidebar SHALL have a refresh icon button in the title bar actions
+
+### FR-2: Artifact Tree Structure
+
+- FR-2.1: Tree SHALL display **Intents** as top-level items under "Intents" section
+- FR-2.2: Tree SHALL display **Units** nested under their parent intent
+- FR-2.3: Tree SHALL display **Stories** nested under their parent unit
+- FR-2.4: Tree SHALL display **Bolts** in a separate "Bolts" section with unit grouping
+- FR-2.5: Tree SHALL display **Standards** in a separate "Standards" section
+- FR-2.6: Tree SHALL support expand/collapse for all parent nodes
+- FR-2.7: Intents SHALL be sorted by number prefix (001, 002, 003...)
+- FR-2.8: Bolts SHALL support configurable sorting:
+  - Default: In-progress first, then by number
+  - Option: Group by status (each group sorted by number)
+  - User can toggle between sort modes via context menu or settings
+
+### FR-3: Status Indicators
+
+- FR-3.1: Intents SHALL show status (draft, in-progress, complete)
+- FR-3.2: Units SHALL show completion status based on stories/bolts
+- FR-3.3: Stories SHALL show status (pending, in-progress, done)
+- FR-3.4: Bolts SHALL display:
+  - Status icon (planned/in-progress/completed) with color
+  - Bolt type badge (e.g., "DDD", "Simple") as small text
+  - Current stage name inline
+  - Expandable to show:
+    - **Stages** section: ALL stages as child nodes with individual status
+    - **Stories** section: Stories assigned to this bolt
+  - Stages and Stories SHALL be visually differentiated (different icons/grouping)
+- FR-3.5: Status SHALL be visually indicated via icons:
+  - Draft/Pending = gray circle
+  - In-Progress = yellow spinner
+  - Complete/Done = green checkmark
+  - Invalid/Unknown = yellow "?" icon with tooltip explaining the issue
+
+### FR-4: File Operations
+
+- FR-4.1: Single-clicking an artifact SHALL select it in the tree
+- FR-4.2: Double-clicking an artifact SHALL open it in VS Code's default editor for that file type
+- FR-4.3: Extension SHALL NOT provide custom editors in Phase 1
+- FR-4.4: Extension SHALL support "Reveal in Explorer" context menu
+- FR-4.5: Extension SHALL support "Copy Path" context menu
+
+### FR-5: File Watching
+
+- FR-5.1: Extension SHALL watch `memory-bank/` directory for changes
+- FR-5.2: Extension SHALL update tree view when files are added, modified, or deleted
+- FR-5.3: Extension SHALL update status indicators when artifact frontmatter changes
+- FR-5.4: Extension SHALL debounce rapid file changes (100ms)
+
+### FR-6: Memory Bank Parsing
+
+- FR-6.1: Extension SHALL use a central `MemoryBankSchema` class for all path/structure definitions
+- FR-6.2: `MemoryBankSchema` SHALL define hardcoded paths for Phase 1 (intents, units, stories, bolts, standards)
+- FR-6.3: `MemoryBankSchema` SHALL be designed for easy future migration to dynamic `memory-bank.yaml` discovery
+- FR-6.4: Extension SHALL parse artifact frontmatter for status fields
+- FR-6.5: Extension SHALL handle missing or malformed frontmatter gracefully
+- FR-6.6: Extension SHALL support standard memory-bank directory structure:
+  - `memory-bank/intents/{NNN}-{name}/` - Intent folders
+  - `memory-bank/intents/{intent}/units/{unit}/` - Unit folders
+  - `memory-bank/intents/{intent}/units/{unit}/stories/` - Story files
+  - `memory-bank/bolts/bolt-{unit}-{N}/` - Bolt folders
+  - `memory-bank/standards/` - Standards files
+
+### FR-7: Project Detection & Installation
+
+- FR-7.1: Extension SHALL detect if workspace lacks irismd (no `memory-bank/` AND no `.irismd/`)
+- FR-7.2: When no irismd detected, sidebar SHALL show welcome view with:
+  - iris.md pixel logo (`src/logo.png`) - clickable, links to https://iris.md
+  - Brief explanation of what irismd is
+  - Embedded quickstart video (https://asciinema.org/a/763995)
+  - "Quickstart Guide" link to iris.md quickstart page
+  - "Install" button
+  - Copyable command text (`npx irismd@latest install`) for manual copy without clicking Install
+- FR-7.3: When user clicks "Install", extension SHALL show confirmation dialog
+- FR-7.4: Upon confirmation, extension SHALL open VS Code integrated terminal
+- FR-7.5: Extension SHALL paste `npx irismd@latest install` command in terminal
+- FR-7.6: Extension SHALL NOT auto-execute command (user must press Enter)
+- FR-7.7: After installation detected (folders appear), sidebar SHALL auto-refresh to show artifacts
+
+### FR-8: Tab-Based Sidebar Architecture
+
+- FR-8.1: Sidebar SHALL display three tabs: **Bolts**, **Specs**, **Overview**
+- FR-8.2: **Bolts tab** SHALL show command center (current focus, queue, activity)
+- FR-8.3: **Specs tab** SHALL show Intent → Unit → Story hierarchy tree
+- FR-8.4: **Overview tab** SHALL show aggregate progress metrics and dashboards
+- FR-8.5: Active tab state SHALL persist across VS Code sessions
+- FR-8.6: Tabs SHALL use VS Code theming (dark/light mode support)
+
+### FR-9: Command Center (Bolts Tab)
+
+- FR-9.1: SHALL display "Current Intent" header with bolt statistics (active/queued/done counts)
+- FR-9.2: SHALL display "Current Focus" expandable card for the active bolt
+- FR-9.3: Current Focus card SHALL show:
+  - Progress ring visualization (percentage complete)
+  - Stage pipeline with status indicators (complete/active/pending)
+  - Stories checklist with completion status
+  - "Continue" and "Files" action buttons
+- FR-9.4: SHALL display "Up Next" queue section showing pending bolts
+- FR-9.5: Up Next queue SHALL order bolts by dependency priority:
+  - Unblocked bolts first (all `requires_bolts` complete)
+  - Among unblocked, prioritize by `enables_bolts` count (enables more work first)
+  - Blocked bolts shown last with blocker indication
+- FR-9.6: Blocked bolts SHALL display which bolts are blocking them
+- FR-9.7: SHALL display "Recent Activity" section with activity feed
+- FR-9.8: Activity feed SHALL support filtering: All, Stages, Bolts
+- FR-9.9: Activity section SHALL be resizable via drag handle (min 120px, max 500px)
+- FR-9.10: Activity section height SHALL persist across sessions
+
+### FR-10: Bolt Dependencies
+
+- FR-10.1: Parser SHALL read `requires_bolts` field from bolt frontmatter
+- FR-10.2: Parser SHALL read `enables_bolts` field from bolt frontmatter
+- FR-10.3: Parser SHALL compute `isBlocked` for pending bolts (true if any `requires_bolts` incomplete)
+- FR-10.4: Parser SHALL compute `blockedBy` list (IDs of incomplete required bolts)
+- FR-10.5: Parser SHALL compute `unblocksCount` (number of bolts this bolt enables)
+- FR-10.6: Status "blocked" SHALL be distinct from "pending" in UI
+
+### FR-11: Activity Feed
+
+- FR-11.1: Activity feed SHALL be derived from bolt timestamp fields (no separate log)
+- FR-11.2: Activity event types:
+  - `bolt-created`: from `created` timestamp
+  - `bolt-start`: from `started` timestamp
+  - `stage-complete`: from `stages_completed[].completed` timestamps
+  - `bolt-complete`: from `completed` timestamp
+- FR-11.3: Activity feed SHALL be sorted by timestamp descending (most recent first)
+- FR-11.4: Activity items SHALL display: icon, description, target bolt, tag (bolt/stage), relative time
+- FR-11.5: Activity feed SHALL update when file watcher detects bolt changes
+
+---
+
+## Future Requirements (Phase 2+)
+
+### FR-12: Bolt Actions (Future)
+
+- FR-12.1: Bolts SHALL have context menu with "Start Bolt" action
+- FR-12.2: "Start Bolt" SHALL copy command to clipboard for pasting in AI chat
+- FR-12.3: Bolts SHALL have context menu with "View Progress" action
+- FR-12.4: Extension MAY provide quick-pick command palette for bolt operations
+
+### FR-13: Custom Editors (Future)
+
+- FR-13.1: Extension MAY provide custom editor for bolt.md files
+- FR-13.2: Extension MAY provide custom editor for story files
+- FR-13.3: Custom editors MAY show rich UI for status, stages, acceptance criteria
+
+---
+
+## Non-Functional Requirements
+
+### Performance
+
+| Requirement | Metric | Target |
+|-------------|--------|--------|
+| Tree load time | Initial render | < 500ms for 100 artifacts |
+| File watch response | Update latency | < 1 second |
+| Memory usage | Extension footprint | < 50MB |
+
+### Usability
+
+| Requirement | Description |
+|-------------|-------------|
+| Discoverability | Extension visible in activity bar with clear icon |
+| Consistency | Follow VS Code UX patterns for tree views |
+| Accessibility | Support keyboard navigation |
+
+### Compatibility
+
+| Requirement | Target |
+|-------------|--------|
+| VS Code version | ^1.85.0 (matches fabriqa-markdown-editor) |
+| Node.js | LTS versions |
+| Platform | macOS, Windows, Linux |
+
+### Maintainability
+
+| Requirement | Description |
+|-------------|-------------|
+| Code style | TypeScript, ESLint, follow irismd coding standards |
+| Testing | Unit tests for tree providers, parsing logic |
+| Build | esbuild (fast bundling) |
+
+---
+
+## Constraints
+
+### Technical Constraints
+
+- Extension must be a separate VS Code extension, not part of CLI
+- Must use VS Code Extension API (not webview for sidebar)
+- Must handle projects without `.irismd/` folder (standalone memory-bank)
+
+### Business Constraints
+
+- Phase 1 focuses on read-only dashboard (no artifact creation/editing)
+- Must not conflict with fabriqa-markdown-editor if both installed
+
+---
+
+## Assumptions
+
+| Assumption | Risk if Invalid | Mitigation |
+|------------|-----------------|------------|
+| memory-bank structure is stable | Parser breaks | Version schema in memory-bank.yaml |
+| Users have memory-bank/ in workspace root | Extension won't detect project | Support configurable path |
+| Frontmatter follows YAML format | Parsing fails | Graceful fallback to "unknown" status |
+
+---
+
+## Resolved Questions
+
+| Question | Resolution |
+|----------|------------|
+| Should extension work with multi-root workspaces? | **No** - Single workspace only |
+| Should bolts show all stages or just current? | **All stages** - Show all with current highlighted |
+| Extension name? | **"irismd extension"** |
+| Sort intents by number or alphabetically? | **Number prefix** (001, 002...) |
+| Sort bolts by status or name? | **In-progress first**, then by number; configurable grouping |
+| User-configurable settings needed? | **None for Phase 1** (bolt sort toggle only) |
+| What to show for invalid frontmatter? | **"?" icon** with tooltip explaining the issue |
+| Bolt location in tree? | **Separate "Bolts" section** (not nested under units) |
+| Bolt stages display? | **Expandable** - current stage inline, expand to see all stages |
+| Show bolt type? | **Yes** - small badge text (DDD, Simple, etc.) |
+| Empty state UI? | **Welcome view** - logo (links to iris.md), explanation, Install button, copyable command |
+| Bolt expansion content? | **Stages + Stories** - visually differentiated |
+| Sidebar structure? | **Three tabs**: Bolts (command center), Specs (tree), Overview (metrics) |
+| Activity feed source? | **Derived from bolt timestamps** - no separate activity log needed |
+| Up Next queue ordering? | **Dependency-based**: unblocked first, then by enables_bolts count |
+| Blocked bolt display? | **Show blockers**: display which bolts are blocking in queue |
+| Activity panel sizing? | **Resizable**: drag handle, 120-500px range, persisted |
+| Progress visualization? | **Ring chart** for bolt progress, **pipeline** for stages |
+
+---
+
+## Out of Scope (Phase 1)
+
+- Custom markdown editors
+- Artifact creation/deletion from sidebar
+- Integration with AI chat (future phase)
+- Bolt execution from extension
+- Git integration for artifact versioning

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/system-context.md

@@ -0,0 +1,114 @@
+---
+intent: vscode-extension
+phase: inception
+status: context-defined
+updated: 2025-12-25
+---
+
+# VS Code Extension - System Context
+
+## System Overview
+
+A VS Code extension ("irismd extension") that provides a sidebar dashboard for browsing AI-DLC memory-bank artifacts. The extension runs entirely within VS Code, reading local files and providing a tree view interface for navigating intents, units, stories, bolts, and standards.
+
+## Context Diagram
+
+```mermaid
+C4Context
+    title System Context - irismd VS Code Extension
+
+    Person(dev, "Developer", "Uses VS Code for AI-DLC workflow")
+
+    System_Boundary(vscode, "VS Code") {
+        System(ext, "irismd Extension", "Sidebar dashboard for memory-bank")
+    }
+
+    System_Ext(fs, "File System", "memory-bank/ directory")
+    System_Ext(terminal, "VS Code Terminal", "Run install commands")
+    System_Ext(browser, "Web Browser", "Open iris.md website")
+    System_Ext(npm, "npm Registry", "irismd package")
+
+    Rel(dev, ext, "Views artifacts, clicks items")
+    Rel(ext, fs, "Reads/watches files")
+    Rel(ext, terminal, "Pastes install command")
+    Rel(ext, browser, "Opens iris.md link")
+    Rel(terminal, npm, "npx irismd@latest install")
+```
+
+## Actors
+
+| Actor | Type | Description |
+|-------|------|-------------|
+| Developer | Human | Primary user, browses memory-bank via sidebar |
+| VS Code | System | Host environment, provides Extension API |
+| File System | System | Source of memory-bank artifacts |
+| VS Code Terminal | System | Target for install command paste |
+| Web Browser | System | Opens iris.md website from logo click |
+
+## External Integrations
+
+| System | Purpose | Direction | Protocol |
+|--------|---------|-----------|----------|
+| VS Code Extension API | Host environment, tree view, commands | Bidirectional | TypeScript API |
+| File System | Read artifacts, watch for changes | Inbound | Node.js fs/vscode.workspace |
+| VS Code Terminal | Paste install command | Outbound | vscode.terminal API |
+| Web Browser | Open iris.md website | Outbound | vscode.env.openExternal |
+| npm Registry | irismd installation | Indirect | npm/npx (user-initiated) |
+
+## Data Flows
+
+### Inbound
+
+| Source | Data | Format | Processing |
+|--------|------|--------|------------|
+| File System | Artifact files | Markdown with YAML frontmatter | Parse frontmatter for status |
+| File System | Directory structure | Folders | Build tree hierarchy |
+| File Watcher | Change events | Create/Modify/Delete | Update tree view |
+| User | Click events | VS Code events | Open file / expand node |
+
+### Outbound
+
+| Target | Data | Format | Trigger |
+|--------|------|--------|---------|
+| VS Code Tree View | Artifact tree | TreeDataProvider | File changes, refresh |
+| VS Code Editor | File path | URI | Double-click |
+| VS Code Terminal | Install command | String | Install button click |
+| Web Browser | iris.md URL | URL | Logo click |
+| Clipboard | File path / command | String | Copy action |
+
+## High-Level Constraints
+
+| Constraint | Rationale |
+|------------|-----------|
+| VS Code ^1.85.0 | Minimum version for required APIs |
+| Single workspace only | No multi-root workspace support (Phase 1) |
+| Read-only dashboard | No artifact creation/modification (Phase 1) |
+| No custom editors | Use VS Code default editors (Phase 1) |
+| Local files only | No remote/cloud memory-bank support |
+
+## Key NFR Goals
+
+| Category | Goal |
+|----------|------|
+| Performance | Tree loads < 500ms for 100 artifacts |
+| Responsiveness | File changes reflected < 1 second |
+| Memory | Extension footprint < 50MB |
+| Reliability | Graceful handling of malformed files |
+| UX | Follow VS Code tree view conventions |
+
+## Assumptions
+
+| Assumption | Impact if Invalid |
+|------------|-------------------|
+| memory-bank at workspace root | Add configurable path setting |
+| Standard directory structure | Parser fails, show "?" status |
+| YAML frontmatter in artifacts | Fallback to "unknown" status |
+| Node.js available in VS Code | Core dependency, will fail |
+
+## Out of Scope
+
+- Remote/cloud memory-bank storage
+- Multi-root workspace support
+- Custom editors for artifacts
+- Direct bolt execution
+- Git integration

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/construction-log.md

@@ -0,0 +1,57 @@
+---
+unit: artifact-parser
+intent: 011-vscode-extension
+created: 2025-12-25
+last_updated: 2025-12-26
+---
+
+# Construction Log: artifact-parser
+
+## Original Plan
+
+**From Inception**: 1 bolt planned (initial), 1 bolt added (mockup scope)
+**Planned Date**: 2025-12-25
+
+| Bolt ID | Stories | Type |
+|---------|---------|------|
+| bolt-artifact-parser-1 | 001, 002, 003, 004 | simple-construction-bolt |
+| bolt-artifact-parser-2 | 005, 006 | simple-construction-bolt |
+
+## Replanning History
+
+| Date | Action | Change | Reason | Approved |
+|------|--------|--------|--------|----------|
+| 2025-12-26 | Added | bolt-artifact-parser-2 | variation-8-2 mockup requirements | Yes |
+
+## Current Bolt Structure
+
+| Bolt ID | Stories | Status | Changed |
+|---------|---------|--------|---------|
+| bolt-artifact-parser-1 | 001, 002, 003, 004 | ✅ completed | - |
+| bolt-artifact-parser-2 | 005, 006 | ⏳ in-progress | Added 2025-12-26 |
+
+## Execution History
+
+| Date | Bolt | Event | Details |
+|------|------|-------|---------|
+| 2025-12-25T18:45:00Z | bolt-artifact-parser-1 | started | Stage 1: Spec |
+| 2025-12-25T18:50:00Z | bolt-artifact-parser-1 | stage-complete | Spec → Implement |
+| 2025-12-25T19:00:00Z | bolt-artifact-parser-1 | stage-complete | Implement → Test |
+| 2025-12-25T19:15:00Z | bolt-artifact-parser-1 | completed | All 3 stages done |
+| 2025-12-26T11:00:00Z | bolt-artifact-parser-2 | started | Stage 1: Plan |
+
+## Execution Summary
+
+| Metric | Value |
+|--------|-------|
+| Original bolts planned | 1 |
+| Current bolt count | 2 |
+| Bolts completed | 1 |
+| Bolts in progress | 1 |
+| Bolts remaining | 0 |
+| Replanning events | 1 |
+
+## Notes
+
+Foundation unit - all other units depend on artifact-parser for memory-bank data.
+Bolt 2 added for dependency parsing and activity feed (command center UI support).

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/001-memory-bank-schema.md

@@ -0,0 +1,56 @@
+---
+id: vscode-extension-story-ap-001
+unit: artifact-parser
+intent: 011-vscode-extension
+status: complete
+priority: must
+created: 2025-12-25T17:00:00Z
+assigned_bolt: bolt-artifact-parser-1
+implemented: true
+---
+
+# Story: Memory Bank Schema Class
+
+## User Story
+
+**As a** extension developer
+**I want** a central MemoryBankSchema class that defines all memory-bank paths
+**So that** path definitions are in one place and easy to change for future dynamic discovery
+
+## Acceptance Criteria
+
+- [ ] **Given** a workspace path, **When** I call MemoryBankSchema.getIntentsPath(), **Then** I get `{workspace}/memory-bank/intents/`
+- [ ] **Given** a workspace path, **When** I call MemoryBankSchema.getBoltsPath(), **Then** I get `{workspace}/memory-bank/bolts/`
+- [ ] **Given** a workspace path, **When** I call MemoryBankSchema.getStandardsPath(), **Then** I get `{workspace}/memory-bank/standards/`
+- [ ] **Given** an intent name, **When** I call MemoryBankSchema.getUnitsPath(intent), **Then** I get the correct units path
+- [ ] **Given** a unit, **When** I call MemoryBankSchema.getStoriesPath(intent, unit), **Then** I get the correct stories path
+- [ ] **Given** a bolt id, **When** I call MemoryBankSchema.getBoltPath(boltId), **Then** I get the correct bolt folder path
+
+## Technical Notes
+
+- Class should be stateless (pure functions or static methods)
+- Design with dependency injection in mind for future dynamic loading from memory-bank.yaml
+- Export TypeScript interfaces for all return types
+- Follow naming from `.irismd/aidlc/memory-bank.yaml` schema section
+
+## Dependencies
+
+### Requires
+- None (foundation)
+
+### Enables
+- 002-project-detection
+- 003-artifact-parsing
+
+## Edge Cases
+
+| Scenario | Expected Behavior |
+|----------|-------------------|
+| Path with spaces | Properly escaped/handled |
+| Windows vs Unix paths | Use path.join for cross-platform |
+| Trailing slashes | Consistent (always or never) |
+
+## Out of Scope
+
+- Dynamic loading from memory-bank.yaml (Phase 2)
+- Custom path configuration

package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/002-project-detection.md

@@ -0,0 +1,54 @@
+---
+id: vscode-extension-story-ap-002
+unit: artifact-parser
+intent: 011-vscode-extension
+status: complete
+priority: must
+created: 2025-12-25T17:00:00Z
+assigned_bolt: bolt-artifact-parser-1
+implemented: true
+---
+
+# Story: Project Detection
+
+## User Story
+
+**As a** VS Code user opening a workspace
+**I want** the extension to detect if this is a irismd project
+**So that** I see the appropriate view (welcome or artifact tree)
+
+## Acceptance Criteria
+
+- [ ] **Given** a workspace with `memory-bank/` folder, **When** detectProject() is called, **Then** return true
+- [ ] **Given** a workspace with `.irismd/` folder, **When** detectProject() is called, **Then** return true
+- [ ] **Given** a workspace with both folders, **When** detectProject() is called, **Then** return true
+- [ ] **Given** a workspace with neither folder, **When** detectProject() is called, **Then** return false
+- [ ] **Given** a workspace with empty `memory-bank/` folder, **When** detectProject() is called, **Then** return true (folder exists)
+
+## Technical Notes
+
+- Use VS Code workspace API (vscode.workspace.workspaceFolders)
+- Check folder existence using fs.existsSync or vscode.workspace.fs
+- Should be fast (< 50ms) as it runs on activation
+
+## Dependencies
+
+### Requires
+- 001-memory-bank-schema (for path definitions)
+
+### Enables
+- welcome-view/001-welcome-view-ui
+- sidebar-provider/001-tree-data-provider-setup
+
+## Edge Cases
+
+| Scenario | Expected Behavior |
+|----------|-------------------|
+| No workspace open | Return false |
+| Multi-root workspace | Check first root only (single workspace support) |
+| Symlinked folders | Follow symlinks, detect project |
+
+## Out of Scope
+
+- Multi-root workspace detection
+- Remote workspace detection