project-iris 0.0.1

package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-inception-agent.md

@@ -0,0 +1,55 @@
+# Activate Inception Agent
+
+**Command**: `/irismd-inception-agent`
+
+---
+
+## Activation
+
+You are now the **Inception Agent** for irismd AI-DLC.
+
+**IMMEDIATELY** read and adopt the persona from:
+→ `.irismd/aidlc/agents/inception-agent.md`
+
+---
+
+## Parameters
+
+- `--intent` (Optional): Intent name to work on
+- `--skill` (Optional): Specific skill to execute
+
+---
+
+## Critical First Steps
+
+1. **Read Schema**: `.irismd/aidlc/memory-bank.yaml`
+2. **Load Intent**: If `--intent` provided, load that intent's artifacts
+3. **Determine State**: Check what inception artifacts exist
+4. **Present Menu or Execute**: Show menu or run specific skill
+
+---
+
+## Your Skills
+
+- **Create Intent**: `.irismd/aidlc/skills/inception/intent-create.md` → Start new feature
+- **List Intents**: `.irismd/aidlc/skills/inception/intent-list.md` → View all intents
+- **Gather Requirements**: `.irismd/aidlc/skills/inception/requirements.md` → Document FR/NFR
+- **Define Context**: `.irismd/aidlc/skills/inception/context.md` → Map system boundaries
+- **Decompose Units**: `.irismd/aidlc/skills/inception/units.md` → Break into units
+- **Create Stories**: `.irismd/aidlc/skills/inception/story-create.md` → Define user stories
+- **Plan Bolts**: `.irismd/aidlc/skills/inception/bolt-plan.md` → Group into bolts
+- **Review**: `.irismd/aidlc/skills/inception/review.md` → Complete inception
+- **Menu**: `.irismd/aidlc/skills/inception/navigator.md` → Show skills
+
+---
+
+## Transitions
+
+- **Inception complete** → Construction Agent
+- **User asks about other phase** → Master Agent
+
+---
+
+## Begin
+
+Activate now. Read your agent definition and guide the user through Inception.

package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-master-agent.md

@@ -0,0 +1,47 @@
+# Activate Master Agent
+
+**Command**: `/irismd-master-agent`
+
+> **Note**: This is the ONLY command to activate the Master Agent. There are no aliases like `/irismd-master`.
+
+---
+
+## Activation
+
+You are now the **Master Orchestrator** for irismd AI-DLC.
+
+**IMMEDIATELY** read and adopt the persona from:
+→ `.irismd/aidlc/agents/master-agent.md`
+
+---
+
+## Critical First Steps
+
+1. **Read Schema**: `.irismd/aidlc/memory-bank.yaml`
+2. **Check Initialization**: Verify `memory-bank/standards/` exists with at least one standard file
+3. **If NOT initialized** → Redirect to `project-init` skill (STOP HERE until initialized)
+4. **If initialized** → Analyze Context and route appropriately
+
+---
+
+## Your Skills
+
+- **Project Init**: `.irismd/aidlc/skills/master/project-init.md` → `project-init`, `init` - **Use for uninitialized projects**
+- **Analyze Context**: `.irismd/aidlc/skills/master/analyze-context.md` → Auto on activation (after initialization)
+- **Route Request**: `.irismd/aidlc/skills/master/route-request.md` → User wants to do something
+- **Explain Flow**: `.irismd/aidlc/skills/master/explain-flow.md` → User asks about AI-DLC
+- **Answer Question**: `.irismd/aidlc/skills/master/answer-question.md` → User has questions
+
+---
+
+## Routing Targets
+
+- **Planning**: Inception Agent → `/irismd-inception-agent`
+- **Building**: Construction Agent → `/irismd-construction-agent`
+- **Deploying**: Operations Agent → `/irismd-operations-agent`
+
+---
+
+## Begin
+
+Activate now. Read your agent definition and start the orchestration process.

package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-operations-agent.md

@@ -0,0 +1,77 @@
+# Activate Operations Agent
+
+**Command**: `/irismd-operations-agent`
+
+---
+
+## Activation
+
+You are now the **Operations Agent** for irismd AI-DLC.
+
+**IMMEDIATELY** read and adopt the persona from:
+→ `.irismd/aidlc/agents/operations-agent.md`
+
+---
+
+## Parameters
+
+- `--unit` (Required): Unit to deploy/operate
+- `--env` (Optional): Target environment (dev/staging/prod)
+
+---
+
+## Critical First Steps
+
+1. **Read Schema**: `.irismd/aidlc/memory-bank.yaml`
+2. **Verify Unit**: Check all bolts are complete
+3. **Load Deployment Status**: Check `{unit}/deployment/` artifacts
+4. **Determine State**: What's built? What's deployed? What's verified?
+5. **Present Menu**: Show deployment status and options
+
+---
+
+## Your Skills
+
+- **Build**: `.irismd/aidlc/skills/operations/build.md` → Create deployment artifacts
+- **Deploy**: `.irismd/aidlc/skills/operations/deploy.md` → Deploy to environment
+- **Verify**: `.irismd/aidlc/skills/operations/verify.md` → Validate deployment
+- **Monitor**: `.irismd/aidlc/skills/operations/monitor.md` → Setup observability
+- **Menu**: `.irismd/aidlc/skills/operations/navigator.md` → Show skills
+
+---
+
+## Deployment Progression
+
+**ALWAYS** follow this progression:
+
+```text
+Build → Dev → Verify → Staging → Verify → Prod → Verify → Monitor
+```
+
+**NEVER** skip environments or verification.
+
+---
+
+## Forbidden Actions
+
+You are **NOT** authorized to execute bolt commands:
+
+- `bolt-plan`
+- `bolt-start`
+- `bolt-status`
+
+If user requests these, redirect to Construction Agent.
+
+---
+
+## Transitions
+
+- **Code needs fixes** → Construction Agent
+- **Need more features** → Inception Agent
+- **Operations complete** → Master Agent
+
+---
+
+## Begin
+
+Activate now. Read your agent definition and guide the user through Operations.

package/src/iris_bundle/frameworks/iris-core/.github/workflows/claude-code-review.yml

@@ -0,0 +1,57 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+

package/src/iris_bundle/frameworks/iris-core/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-ci.yml

@@ -0,0 +1,46 @@
+name: NPM Package CI
+
+on:
+  push:
+    branches: [main, dev]
+    paths:
+      - 'src/**'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'src/**'
+
+jobs:
+  npm-package-test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20, 22]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+          cache-dependency-path: src/package-lock.json
+
+      - name: Install dependencies
+        working-directory: src
+        run: npm ci
+
+      - name: Lint markdown files
+        working-directory: src
+        run: npm run lint:md
+
+      - name: Run schema validation tests
+        working-directory: src
+        run: npm run test:schema
+
+      - name: Run all tests
+        working-directory: src
+        run: npm test

package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-dev.yml

@@ -0,0 +1,59 @@
+name: NPM Package Dev Release
+
+on:
+  push:
+    branches: [dev]
+  workflow_dispatch:
+
+jobs:
+  npm-package-dev:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        working-directory: src
+        run: npm ci
+
+      - name: Run tests
+        working-directory: src
+        run: npm test
+
+      - name: Set incremental dev version
+        working-directory: src
+        run: |
+          # Get current @dev version from npm
+          CURRENT=$(npm view irismd@dev version 2>/dev/null || echo "0.0.0-dev.0")
+          # Extract and increment dev number (e.g., 0.1.2-dev.5 -> 0.1.2-dev.6)
+          if [[ $CURRENT =~ (.+-dev\.)([0-9]+) ]]; then
+            PREFIX="${BASH_REMATCH[1]}"
+            NUM="${BASH_REMATCH[2]}"
+            NEXT_VERSION="$PREFIX$((NUM + 1))"
+          elif [[ $CURRENT =~ ^([0-9]+\.[0-9]+\.[0-9]+) ]]; then
+            # Preserve base version if format is standard (e.g., 1.2.3 -> 1.2.3-dev.1)
+            BASE="${BASH_REMATCH[1]}"
+            NEXT_VERSION="$BASE-dev.1"
+          else
+            # Fallback for first dev release
+            NEXT_VERSION="0.0.0-dev.1"
+          fi
+          echo "Setting version: $NEXT_VERSION (previous: $CURRENT)"
+          npm version "$NEXT_VERSION" --no-git-tag-version
+
+      - name: Copy README to src for npm package
+        run: cp README.md src/README.md
+
+      - name: Publish to npm (dev tag)
+        working-directory: src
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --tag dev --access public

package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-release.yml

@@ -0,0 +1,107 @@
+name: NPM Package Release
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'src/**'
+
+jobs:
+  npm-package-test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20, 22]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+          cache-dependency-path: src/package-lock.json
+
+      - name: Install dependencies
+        working-directory: src
+        run: npm ci
+
+      - name: Lint markdown files
+        working-directory: src
+        run: npm run lint:md
+
+      - name: Run schema validation tests
+        working-directory: src
+        run: npm run test:schema
+
+      - name: Run all tests
+        working-directory: src
+        run: npm test
+
+  npm-package-release:
+    needs: npm-package-test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        working-directory: src
+        run: npm ci
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump patch version
+        id: version
+        working-directory: src
+        run: |
+          # Bump patch version (e.g., 1.0.5 -> 1.0.6)
+          npm version patch --no-git-tag-version
+          NEW_VERSION=$(node -p "require('./package.json').version")
+          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "Bumped to version $NEW_VERSION"
+
+      - name: Commit version bump
+        run: |
+          git add src/package.json src/package-lock.json
+          git commit -m "chore(npm): bump version to ${{ steps.version.outputs.version }} [skip ci]"
+          git push origin main
+
+      - name: Copy README to src for npm package
+        run: cp README.md src/README.md
+
+      - name: Publish to npm
+        working-directory: src
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Create tag
+          git tag -a "v${{ steps.version.outputs.version }}" -m "irismd v${{ steps.version.outputs.version }}"
+          git push origin "v${{ steps.version.outputs.version }}"
+          # Create GitHub release
+          gh release create "v${{ steps.version.outputs.version }}" \
+            --title "irismd v${{ steps.version.outputs.version }}" \
+            --notes "## irismd v${{ steps.version.outputs.version }}
+
+          Install from npm:
+          \`\`\`bash
+          npx irismd@${{ steps.version.outputs.version }} install
+          \`\`\`"

package/src/iris_bundle/frameworks/iris-core/.github/workflows/vscode-publish.yml

@@ -0,0 +1,113 @@
+name: VS Code Extension CI/Release
+
+on:
+  push:
+    branches: [main, dev]
+    paths:
+      - 'vs-code-extension/**'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'vs-code-extension/**'
+
+jobs:
+  vs-code-extension-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: vs-code-extension/package-lock.json
+
+      - name: Install dependencies
+        working-directory: vs-code-extension
+        run: npm ci
+
+      - name: Lint
+        working-directory: vs-code-extension
+        run: npm run lint
+
+      - name: Compile
+        working-directory: vs-code-extension
+        run: npm run compile
+
+      - name: Run tests
+        working-directory: vs-code-extension
+        run: npm test
+
+  vs-code-extension-publish:
+    needs: vs-code-extension-test
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        working-directory: vs-code-extension
+        run: npm ci
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump patch version
+        id: version
+        working-directory: vs-code-extension
+        run: |
+          # Bump patch version (e.g., 1.0.5 -> 1.0.6)
+          npm version patch --no-git-tag-version
+          NEW_VERSION=$(node -p "require('./package.json').version")
+          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "Bumped to version $NEW_VERSION"
+
+      - name: Commit version bump
+        run: |
+          git add vs-code-extension/package.json vs-code-extension/package-lock.json
+          git commit -m "chore(vscode): bump version to ${{ steps.version.outputs.version }} [skip ci]"
+          git push origin main
+
+      - name: Package extension
+        working-directory: vs-code-extension
+        run: npm run package
+
+      - name: Validate package
+        working-directory: vs-code-extension
+        run: |
+          # Check VSIX was created
+          ls -la *.vsix
+          # Verify package contents
+          npx vsce ls
+
+      - name: Publish to VS Code Marketplace
+        working-directory: vs-code-extension
+        run: npx vsce publish -p ${{ secrets.VSCE_PAT }}
+
+      - name: Create GitHub Release with VSIX
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Create tag
+          git tag -a "vscode-v${{ steps.version.outputs.version }}" -m "VS Code Extension v${{ steps.version.outputs.version }}"
+          git push origin "vscode-v${{ steps.version.outputs.version }}"
+          # Create GitHub release with VSIX attached
+          gh release create "vscode-v${{ steps.version.outputs.version }}" \
+            --title "VS Code Extension v${{ steps.version.outputs.version }}" \
+            --notes "## irismd VS Code Extension v${{ steps.version.outputs.version }}
+
+          Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=fabriqaai.irismd) or download the VSIX below." \
+            vs-code-extension/*.vsix