mindforge-cc 8.1.0 → 8.2.0

package/.mindforge/mirrors/mirror-sre-776a1cf9/.agent/workflows/mindforge:workstreams.md

@@ -0,0 +1,27 @@
+---
+description: Manage parallel feature tracks with isolated state
+---
+<objective>
+Enable developers to work on multiple features or bugs concurrently within the same codebase without state collision. Provides isolated tracking for each "workstream".
+</objective>
+
+<execution_context>
+.claude/commands/mindforge/workstreams.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (Switch subcommand)
+Storage: .planning/workstreams/
+State: Each workstream maintains its own subset of `STATE.md` or a local context file.
+</context>
+
+<process>
+1. **Route Subcommand**:
+    - `list`: Show all active and archived workstreams in `.planning/workstreams/`.
+    - `create <name>`: Initialize a new workstream directory and baseline state.
+    - `switch <name>`: Update the global pointer in `STATE.md` to the targeted workstream.
+    - `status`: Show the current active workstream and its progress.
+2. **Manage Isolation**:
+    - When switching, ensure current work is saved or stashed if necessary.
+3. **Confirm**: Success/Failure status message to user.
+</process>

package/.mindforge/mirrors/mirror-sre-776a1cf9/.agent/workflows/publish-release.md

@@ -0,0 +1,36 @@
+---
+description: Publish a new version of MindForge to npm
+---
+
+# MindForge Publishing Workflow
+
+This workflow automates the pre-verification and publishing of MindForge.
+
+## Pre-Flight Checks
+
+1. Verify structural integrity
+// turbo
+npm test
+
+2. Check package contents
+// turbo
+npm pack --dry-run
+
+## Publish Execution
+
+**Note**: If this is a prerelease (alpha, beta, rc), you must specify the tag.
+
+3. Publish to npm
+```bash
+# For stable:
+npm publish --access public
+
+# For alpha:
+npm publish --tag alpha --access public
+```
+
+4. Create Git Tag
+```bash
+git tag v$(node -p "require('./package.json').version")
+git push origin --tags
+```

package/.mindforge/mirrors/mirror-sre-776a1cf9/.czrc

@@ -0,0 +1,3 @@
+{
+  "path": "cz-conventional-changelog"
+}

package/.mindforge/mirrors/mirror-sre-776a1cf9/.github/pull_request_template.md

@@ -0,0 +1,29 @@
+# 🚀 MindForge - Pull Request
+
+## 🎯 Goal
+
+[Clearly describe the problem this PR solves or the feature it adds.]
+
+## 🛠 Proposed Changes
+
+[List the technical changes made, grouped by component or persona context.]
+
+- **[Component/Persona]**: [Brief description of change]
+- **[Component/Persona]**: [Brief description of change]
+
+## 🧪 Verification
+
+[Describe how you verified these changes.]
+
+- [ ] Unit tests passed (`npm test`)
+- [ ] Manual verification (Attach screenshots/recordings if applicable)
+- [ ] MindForge persona consistency check (Tool permissions, processes)
+
+## 🧠 Brain Context
+
+- **Task**: [link to task.md]
+- **Implementation Plan**: [link to implementation_plan.md]
+- **Walkthrough**: [link to walkthrough.md]
+
+---
+*Generated by MindForge Auto-PR Engine*

package/.mindforge/mirrors/mirror-sre-776a1cf9/.github/workflows/ai-intelligence.yml

@@ -0,0 +1,55 @@
+name: MindForge AI Intelligence
+
+on:
+  workflow_call:
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  review:
+    name: 🤖 Multi-Model Validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Cross-Model Review
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          node bin/mindforge-cli.js cross-review --models claude,gpt4o --focus security,architecture --output markdown > /tmp/review-summary.md
+
+      - name: Publish Review Comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const body = fs.readFileSync('/tmp/review-summary.md', 'utf8');
+            await github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: body
+            });
+
+      - name: Upload Review Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: ai-review-reports
+          path: |
+            CODE-REVIEW.md
+            CROSS-REVIEW.md

package/.mindforge/mirrors/mirror-sre-776a1cf9/.github/workflows/auto-pr.yml

@@ -0,0 +1,80 @@
+name: MindForge Auto-PR
+
+on:
+  push:
+    branches-ignore:
+      - main
+      - master
+      - develop
+      - "release/**"
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  create-pr:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create PR if missing
+        uses: actions/github-script@v7
+        env:
+          BRANCH_NAME: ${{ github.ref_name }}
+          BASE_BRANCH: main
+          COMMIT_MESSAGE: ${{ github.event.head_commit.message }}
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const fs = require('fs');
+            const path = require('path');
+            const { owner, repo } = context.repo;
+            const headBranch = process.env.BRANCH_NAME;
+            const baseBranch = process.env.BASE_BRANCH;
+
+            if (!headBranch || headBranch === baseBranch) {
+              core.info(`Skipping PR creation for head branch: ${headBranch}`);
+              return;
+            }
+
+            const head = `${owner}:${headBranch}`;
+            const existing = await github.rest.pulls.list({
+              owner,
+              repo,
+              state: 'open',
+              head,
+              base: baseBranch,
+            });
+
+            if (existing.data.length > 0) {
+              core.info(`Open PR already exists for ${head} -> ${baseBranch}.`);
+              return;
+            }
+
+            // Detect template
+            let body = '';
+            const templatePath = '.github/pull_request_template.md';
+            if (fs.existsSync(templatePath)) {
+              body = fs.readFileSync(templatePath, 'utf8');
+            } else {
+              core.warning(`PR template not found at ${templatePath}`);
+              body = 'Draft PR created by MindForge Auto-PR Engine.';
+            }
+
+            const title = (process.env.COMMIT_MESSAGE || `feat: update ${headBranch}`).split('\n')[0].trim();
+
+            const created = await github.rest.pulls.create({
+              owner,
+              repo,
+              title,
+              body,
+              head: headBranch,
+              base: baseBranch,
+              draft: true
+            });
+
+            core.info(`Created Draft PR #${created.data.number}: ${created.data.html_url}`);

package/.mindforge/mirrors/mirror-sre-776a1cf9/.github/workflows/control-plane.yml

@@ -0,0 +1,79 @@
+name: MindForge Control Plane
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+permissions:
+  contents: read
+  pull-requests: write
+  security-events: write
+
+jobs:
+  classify:
+    name: 🔍 Change Classification
+    runs-on: ubuntu-latest
+    outputs:
+      tier: ${{ steps.classifier.outputs.tier }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Run Classifier
+        id: classifier
+        run: node bin/change-classifier.js
+
+      - name: Tier Summary
+        run: |
+          echo "### 🔍 Change Classification Result" >> $GITHUB_STEP_SUMMARY
+          echo "- **Governance Tier:** ${{ steps.classifier.outputs.tier }}" >> $GITHUB_STEP_SUMMARY
+          if [ "${{ steps.classifier.outputs.tier }}" == "3" ]; then
+            echo "- ⚠️ **High Risk Changes Detected** — Tier 3 Governance Gate Enforced." >> $GITHUB_STEP_SUMMARY
+          fi
+
+  governance-gate:
+    name: ⚖️ Governance Enforcement
+    needs: classify
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Check Tier 3 Compliance
+        if: needs.classify.outputs.tier == '3'
+        run: |
+          APPROVAL_COUNT=$(ls .planning/approvals/*.json 2>/dev/null | wc -l)
+          if [ "$APPROVAL_COUNT" -eq 0 ]; then
+            echo "❌ ERROR: Tier 3 changes detected but no approval signature found in .planning/approvals/"
+            echo "Please run /mindforge:approve and commit the resulting approval file."
+            exit 1
+          fi
+          echo "✅ Tier 3 approval found."
+
+      - name: Security Scan
+        run: node bin/mindforge-cli.js security-scan
+
+  routing:
+    name: 🚀 Pipeline Routing
+    needs: [classify, governance-gate]
+    if: needs.governance-gate.result == 'success'
+    uses: ./.github/workflows/execution-plane.yml
+    secrets: inherit
+
+  ai-review:
+    name: 🤖 AI Intelligence Layer
+    needs: [classify, governance-gate]
+    if: github.event_name == 'pull_request' && needs.governance-gate.result == 'success'
+    uses: ./.github/workflows/ai-intelligence.yml
+    secrets: inherit

package/.mindforge/mirrors/mirror-sre-776a1cf9/.github/workflows/execution-plane.yml

@@ -0,0 +1,52 @@
+name: MindForge Execution Plane
+
+on:
+  workflow_call:
+    inputs:
+      phase:
+        type: string
+        default: 'current'
+      dry_run:
+        type: boolean
+        default: false
+
+jobs:
+  headless-agent:
+    name: ⚡ Agent Runtime
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Health Check
+        run: node bin/mindforge-cli.js health --repair
+
+      - name: Execute Workflow
+        run: |
+          DRY_FLAG=""
+          if [ "${{ inputs.dry_run }}" == "true" ]; then DRY_FLAG="--dry-run"; fi
+          node bin/mindforge-cli.js headless --phase ${{ inputs.phase }} $DRY_FLAG --output json > /tmp/headless-results.json
+
+      - name: Verification
+        run: |
+          npm test
+          npm run lint
+
+      - name: Upload Artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: execution-artifacts-${{ github.run_id }}
+          path: |
+            .planning/HANDOFF.json
+            .planning/AUDIT.jsonl
+            AUTONOMOUS-REPORT.md
+            /tmp/headless-results.json

package/.mindforge/mirrors/mirror-sre-776a1cf9/.github/workflows/mindforge-ai-review.yml

@@ -0,0 +1,68 @@
+name: MindForge AI Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  ai-reviewer:
+    name: Cross-Model Code Review
+    runs-on: ubuntu-latest
+    if: contains(github.event.pull_request.labels.*.name, 'needs-review') || github.event_name == 'pull_request'
+    env:
+      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run AI Review
+        id: review
+        run: |
+          echo "::group::AI Review Execution"
+          # Run the cross-review engine with designated models
+          node bin/review/cross-review-engine.js --models claude,gpt4o --output json > /tmp/review-results.json
+          echo "::endgroup::"
+          
+          # Generate review markdown
+          node -e "
+            const results = JSON.parse(require('fs').readFileSync('/tmp/review-results.json', 'utf8'));
+            const md = '# 🧠 MindForge AI Review\n\n' + 
+                       '## Summary\n' + results.summary + '\n\n' +
+                       '## Findings\n' + results.findings.map(f => '- ' + f).join('\n');
+            require('fs').writeFileSync('/tmp/mindforge-review.md', md);
+          "
+
+      - name: Post AI Review Comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const reviewContent = fs.readFileSync('/tmp/mindforge-review.md', 'utf8');
+            
+            await github.rest.pulls.createReview({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.issue.number,
+              body: reviewContent,
+              event: 'COMMENT'
+            });
+
+      - name: Upload Review Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: ai-review-reports
+          path: |
+            CODE-REVIEW.md
+            CROSS-REVIEW.md

package/.mindforge/mirrors/mirror-sre-776a1cf9/.github/workflows/mindforge-autonomous.yml

@@ -0,0 +1,70 @@
+name: MindForge Autonomous Engine
+
+on:
+  workflow_dispatch:
+    inputs:
+      phase:
+        description: 'Phase number to execute'
+        required: true
+        default: '1'
+      timeout:
+        description: 'Execution timeout (minutes)'
+        required: true
+        default: '60'
+      dry_run:
+        description: 'Run in dry-run mode'
+        type: boolean
+        default: false
+  schedule:
+    - cron: '0 0 * * *' # Daily at midnight
+
+env:
+  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+
+jobs:
+  headless-agent:
+    name: Headless Execution (Phase ${{ github.event.inputs.phase || 'Auto' }})
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+      - run: npm ci
+
+      - name: Start Autonomous Session
+        run: |
+          DRY_RUN_FLAG=""
+          if [ "${{ github.event.inputs.dry_run }}" = "true" ]; then
+            DRY_RUN_FLAG="--dry-run"
+          fi
+          
+          PHASE_ARG="--phase ${{ github.event.inputs.phase || 'current' }}"
+          
+          # Run the headless runner
+          node bin/autonomous/headless.js $PHASE_ARG --timeout ${{ github.event.inputs.timeout || 60 }} $DRY_RUN_FLAG \
+            --output json > /tmp/autonomous-results.json
+
+      - name: Generate Report
+        run: |
+          node -e "
+            const fs = require('fs');
+            const results = JSON.parse(fs.readFileSync('/tmp/autonomous-results.json', 'utf8'));
+            const report = '# 🤖 Autonomous Execution Report\n\n' +
+                           '| Metric | Value |\n| --- | --- |\n' +
+                           '| Status | ' + results.status + ' |\n' +
+                           '| Phase | ' + results.phase + ' |\n' +
+                           '| Duration | ' + results.duration + 'ms |\n\n' +
+                           '## Outcome\n' + results.outcome;
+            fs.writeFileSync('AUTONOMOUS-REPORT.md', report);
+          " 2>/dev/null || echo "Report generation failed" > AUTONOMOUS-REPORT.md
+
+      - name: Upload Session Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: autonomous-session-${{ github.run_id }}
+          path: |
+            .planning/HANDOFF.json
+            .planning/AUDIT.jsonl
+            AUTONOMOUS-REPORT.md