prizmkit 1.1.99 → 1.1.101

package/bundled/dev-pipeline-windows/assets/prizm-dev-team-integration.md

@@ -1,137 +0,0 @@
-# prizm-dev-team Integration Guide
-
-## Overview
-
-dev-pipeline drives the prizm-dev-team multi-agent team through an outer shell loop. Each iteration spawns a new AI CLI session with a bootstrap prompt that instructs the agent to create and orchestrate the team for one feature.
-
-## Architecture
-
-```
-dev-pipeline (outer loop)
-    │
-    ├── run-feature.ps1                    PowerShell runner — picks next feature, spawns CLI
-    ├── scripts/                  Python state management scripts
-    ├── templates/bootstrap-prompt.md  Session prompt template
-    │
-    └── [per session] AI CLI
-            │
-            ├── Phase 0: Init (Orchestrator)
-            ├── Phase 1-2: Context snapshot + Specify + Plan (Orchestrator)
-            ├── Phase 3: Analyze (Reviewer agent) [tier2] / Phase 4: Analyze [tier3]
-            ├── Phase 3.5: Plan Challenge (Critic agent(s), 1 or 3 parallel) [tier2+]
-            ├── Phase 4: Implement (Dev agent) [tier2] / Phase 5: Implement [tier3]
-            ├── Phase 5: Review (Reviewer agent)
-            └── Phase 6: Retrospective & Commit (Orchestrator)
-            │
-            └── Write session-status.json → exit
-```
-
-## Agent Definitions (Source of Truth)
-
-| Agent | Definition Path | Type |
-|-------|----------------|------|
-| Dev | `.claude/agents/prizm-dev-team-dev.md` (or `.codebuddy/agents/`) | prizm-dev-team-dev |
-| Reviewer | `.claude/agents/prizm-dev-team-reviewer.md` (or `.codebuddy/agents/`) | prizm-dev-team-reviewer |
-| Critic | `.claude/agents/prizm-dev-team-critic.md` (or `.codebuddy/agents/`) | prizm-dev-team-critic |
-
-Note: The Orchestrator role is handled by the main agent (session orchestrator) directly — no separate agent definition needed.
-
-## Pipeline Scripts
-
-Located at `.prizmkit/dev-pipeline/scripts/`:
-
-| Script | Purpose |
-|--------|---------|
-| `init-dev-team.py` | Initialize `.dev-team/` + `.prizmkit/` directories |
-| `init-pipeline.py` | Initialize pipeline state directories and config |
-| `init-bugfix-pipeline.py` | Initialize bugfix pipeline state |
-| `generate-bootstrap-prompt.py` | Render tier-specific bootstrap prompt with feature context |
-| `generate-bugfix-prompt.py` | Render bugfix bootstrap prompt with bug context |
-| `update-feature-status.py` | Update feature status in feature-list.json after session |
-| `update-bug-status.py` | Update bug status in bug-fix-list.json after session |
-| `check-session-status.py` | Read and validate session-status.json output |
-| `detect-stuck.py` | Detect stuck/hung pipeline sessions via heartbeat |
-| `parse-stream-progress.py` | Parse AI CLI output stream for progress tracking |
-| `utils.py` | Shared utility functions for pipeline scripts |
-
-## Artifact Mapping
-
-### PrizmKit Artifacts (.prizmkit/)
-
-| Phase | File | Content |
-|-------|------|---------|
-| 1 | `specs/spec.md` | Feature specification (WHAT/WHY) |
-| 2 | `plans/plan.md` | Technical plan (architecture, API, tests) |
-| 3 | `tasks/tasks.md` | Executable task list with `[ ]` / `[x]` (legacy — now part of plan.md Tasks section) |
-| 4 | `analysis/analyze-report.md` | Consistency analysis |
-
-### Dev-Team Artifacts (.dev-team/)
-
-| Phase | File | Content |
-|-------|------|---------|
-| 1 | `specs/requirements.md` | Requirements with REQ-NNN IDs |
-| 2 | `contracts/*.contract.json` | Interface contracts |
-| 2 | `contracts/data-models.json` | Data entity definitions |
-| 3 | `tasks/task-manifest.json` | Structured tasks with T-NNN IDs |
-| 3 | `tasks/dependency-graph.json` | Task DAG |
-| 6 | `reports/dev/self-test-*.md` | Dev self-test reports |
-| 7 | `reports/qa/integration-test.md` | QA integration test report |
-| 7 | `reports/review/code-review.md` | Review report |
-
-## Session Lifecycle
-
-### 1. Session Start
-
-The bootstrap prompt instructs the agent to:
-- Execute phases directly as the session orchestrator
-- Spawn Dev and Reviewer agents as subagents for implementation and review phases
-- The orchestrator handles context building, planning, retrospective, and commit phases directly
-
-### 2. Pipeline Execution
-
-The Orchestrator drives the pipeline phases with checkpoints (CP-0 through CP-3). Each checkpoint validates artifacts.
-
-### 3. Session End
-
-The agent MUST write `session-status.json` before exiting:
-
-```json
-{
-  "session_id": "F-001-20260304100000",
-  "feature_id": "F-001",
-  "status": "success",
-  "completed_phases": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
-  "current_phase": 9,
-  "checkpoint_reached": "CP-7",
-  "tasks_completed": 12,
-  "tasks_total": 12,
-  "errors": [],
-  "can_resume": false,
-  "resume_from_phase": null,
-  "artifacts": {
-    "spec_path": ".prizmkit/specs/spec.md",
-    "plan_path": ".prizmkit/plans/plan.md"
-  },
-  "timestamp": "2026-03-04T11:30:00Z"
-}
-```
-
-## Failure Recovery
-
-| Session Outcome | Pipeline Action |
-|-----------------|-----------------|
-| `status: "success"` | Mark feature completed, pick next |
-| `status: "partial"`, `can_resume: true` | Resume from `resume_from_phase` |
-| `status: "partial"`, `can_resume: false` | Retry from scratch |
-| `status: "failed"` | Retry (up to MAX_RETRIES) |
-| No status file (crash) | Treat as failed, retry |
-
-## Team Naming Convention
-
-Each feature gets its own team instance: `prizm-dev-team-{FEATURE_ID}`
-
-Examples:
-- `prizm-dev-team-F-001` — User Authentication
-- `prizm-dev-team-F-002` — Dashboard
-
-This ensures clean isolation between features and allows multiple features to have separate artifact histories.

package/bundled/dev-pipeline-windows/launch-bugfix-daemon.ps1

@@ -1,9 +0,0 @@
-#!/usr/bin/env pwsh
-. "$PSScriptRoot\lib\daemon.ps1"
-try {
-  Invoke-PrizmDaemon -Kind bugfix -ScriptRoot $PSScriptRoot -RunScript (Join-Path $PSScriptRoot 'run-bugfix.ps1') -Args $args
-  exit $global:PRIZM_DAEMON_EXIT_CODE
-} catch {
-  Write-PrizmError $_.Exception.Message
-  exit 1
-}

package/bundled/dev-pipeline-windows/launch-feature-daemon.ps1

@@ -1,9 +0,0 @@
-#!/usr/bin/env pwsh
-. "$PSScriptRoot\lib\daemon.ps1"
-try {
-  Invoke-PrizmDaemon -Kind feature -ScriptRoot $PSScriptRoot -RunScript (Join-Path $PSScriptRoot 'run-feature.ps1') -Args $args
-  exit $global:PRIZM_DAEMON_EXIT_CODE
-} catch {
-  Write-PrizmError $_.Exception.Message
-  exit 1
-}

package/bundled/dev-pipeline-windows/launch-refactor-daemon.ps1

@@ -1,9 +0,0 @@
-#!/usr/bin/env pwsh
-. "$PSScriptRoot\lib\daemon.ps1"
-try {
-  Invoke-PrizmDaemon -Kind refactor -ScriptRoot $PSScriptRoot -RunScript (Join-Path $PSScriptRoot 'run-refactor.ps1') -Args $args
-  exit $global:PRIZM_DAEMON_EXIT_CODE
-} catch {
-  Write-PrizmError $_.Exception.Message
-  exit 1
-}

package/bundled/dev-pipeline-windows/lib/branch.ps1

@@ -1,235 +0,0 @@
-Set-StrictMode -Version 2.0
-$ErrorActionPreference = 'Stop'
-
-function Get-PrizmGitStatusSafe {
-  param([string]$ProjectRoot)
-  $hiddenToolWorktreeExcludes = Get-PrizmHiddenToolWorktreeExcludes
-  $lines = & git -C $ProjectRoot status --porcelain -- . @hiddenToolWorktreeExcludes 2>$null
-  return @($lines)
-}
-
-function Add-PrizmGitAllSafe {
-  param([string]$ProjectRoot)
-  $hiddenToolWorktreeExcludes = Get-PrizmHiddenToolWorktreeExcludes
-  & git -C $ProjectRoot add -A -- . @hiddenToolWorktreeExcludes *> $null
-  return $LASTEXITCODE -eq 0
-}
-
-function Get-PrizmCurrentBranch {
-  param([string]$ProjectRoot)
-  $branch = & git -C $ProjectRoot rev-parse --abbrev-ref HEAD 2>$null
-  if ($LASTEXITCODE -eq 0 -and $branch) { return [string]($branch | Select-Object -First 1) }
-  return ''
-}
-
-function Test-PrizmTrackedDirty {
-  param([string]$ProjectRoot)
-  $trackedDirty = & git -C $ProjectRoot diff --name-only 2>$null
-  $stagedDirty = & git -C $ProjectRoot diff --cached --name-only 2>$null
-  return -not [string]::IsNullOrWhiteSpace((@($trackedDirty) + @($stagedDirty) -join "`n"))
-}
-
-function New-PrizmDevBranch {
-  param(
-    [string]$ProjectRoot,
-    [string]$DevBranch,
-    [string]$SourceBranch
-  )
-
-  if (-not $DevBranch -or -not $SourceBranch) { return $false }
-
-  & git -C $ProjectRoot rev-parse --verify $DevBranch *> $null
-  if ($LASTEXITCODE -eq 0) {
-    Write-PrizmInfo "Branch already exists: $DevBranch - checking out"
-    & git -C $ProjectRoot checkout $DevBranch *> $null
-    if ($LASTEXITCODE -ne 0) {
-      Write-PrizmError "Failed to checkout existing branch: $DevBranch"
-      return $false
-    }
-    return $true
-  }
-
-  & git -C $ProjectRoot checkout -b $DevBranch $SourceBranch *> $null
-  if ($LASTEXITCODE -ne 0) {
-    Write-PrizmWarn "Failed to create branch: $DevBranch from $SourceBranch"
-    return $false
-  }
-
-  Write-PrizmInfo "Created and checked out branch: $DevBranch (from $SourceBranch)"
-  return $true
-}
-
-function Switch-PrizmOriginalBranch {
-  param(
-    [string]$ProjectRoot,
-    [string]$OriginalBranch
-  )
-
-  if (-not $OriginalBranch) { return $false }
-  $currentBranch = Get-PrizmCurrentBranch $ProjectRoot
-  if ($currentBranch -eq $OriginalBranch) { return $true }
-
-  & git -C $ProjectRoot checkout $OriginalBranch *> $null
-  if ($LASTEXITCODE -ne 0) {
-    Write-PrizmError "Failed to checkout original branch: $OriginalBranch"
-    return $false
-  }
-
-  Write-PrizmInfo "Returned to branch: $OriginalBranch"
-  return $true
-}
-
-function Save-PrizmBranchWip {
-  param(
-    [string]$ProjectRoot,
-    [string]$DevBranch
-  )
-
-  if (-not $DevBranch) { return $true }
-
-  $currentBranch = Get-PrizmCurrentBranch $ProjectRoot
-  if ($currentBranch -ne $DevBranch) { return $true }
-
-  $changes = Get-PrizmGitStatusSafe $ProjectRoot
-  if ([string]::IsNullOrWhiteSpace(($changes -join "`n"))) { return $true }
-
-  Write-PrizmWarn "Saving uncommitted work-in-progress on branch: $DevBranch"
-  if (-not (Add-PrizmGitAllSafe $ProjectRoot)) {
-    Write-PrizmWarn "git add failed - uncommitted work may remain on $DevBranch"
-    return $true
-  }
-
-  & git -C $ProjectRoot commit --no-verify `
-    -m "wip($DevBranch): interrupted - uncommitted work saved" `
-    -m "Pipeline was interrupted or failed. This commit preserves work-in-progress." `
-    -m "To resume: git checkout $DevBranch" *> $null
-
-  if ($LASTEXITCODE -eq 0) {
-    Write-PrizmInfo "Saved uncommitted work on branch $DevBranch"
-  } else {
-    Write-PrizmWarn "git commit failed - uncommitted work may remain on $DevBranch"
-  }
-
-  return $true
-}
-
-function Merge-PrizmDevBranch {
-  param(
-    [string]$ProjectRoot,
-    [string]$DevBranch,
-    [string]$OriginalBranch,
-    [bool]$AutoPush = $false
-  )
-
-  if (-not $DevBranch -or -not $OriginalBranch) { return $false }
-
-  $hadStash = $false
-  if (Test-PrizmTrackedDirty $ProjectRoot) {
-    & git -C $ProjectRoot stash push -m 'pipeline-merge-stash' *> $null
-    if ($LASTEXITCODE -eq 0) {
-      $hadStash = $true
-    } else {
-      Write-PrizmWarn "git stash failed - tracked changes may block branch merge"
-    }
-  }
-
-  Write-PrizmInfo "Merging $DevBranch into $OriginalBranch..."
-  & git -C $ProjectRoot rebase $OriginalBranch $DevBranch
-  if ($LASTEXITCODE -ne 0) {
-    Write-PrizmError "Rebase of $DevBranch onto $OriginalBranch failed - resolve manually"
-    & git -C $ProjectRoot rebase --abort *> $null
-    if ($hadStash) {
-      & git -C $ProjectRoot stash pop *> $null
-      if ($LASTEXITCODE -ne 0) { Write-PrizmWarn "git stash pop failed after rebase abort" }
-    }
-    return $false
-  }
-
-  & git -C $ProjectRoot checkout $OriginalBranch *> $null
-  if ($LASTEXITCODE -ne 0) {
-    Write-PrizmError "Failed to checkout $OriginalBranch for merge"
-    if ($hadStash) {
-      & git -C $ProjectRoot stash pop *> $null
-      if ($LASTEXITCODE -ne 0) { Write-PrizmWarn "git stash pop failed after checkout failure" }
-    }
-    return $false
-  }
-
-  & git -C $ProjectRoot merge --ff-only $DevBranch
-  if ($LASTEXITCODE -ne 0) {
-    Write-PrizmError "Merge failed after rebase - resolve manually"
-    if ($hadStash) {
-      & git -C $ProjectRoot stash pop *> $null
-      if ($LASTEXITCODE -ne 0) { Write-PrizmWarn "git stash pop failed after merge failure" }
-    }
-    return $false
-  }
-
-  Write-PrizmSuccess "Merged $DevBranch into $OriginalBranch"
-
-  if ($AutoPush) {
-    Write-PrizmInfo "Pushing $OriginalBranch to remote..."
-    & git -C $ProjectRoot push *> $null
-    if ($LASTEXITCODE -eq 0) {
-      Write-PrizmSuccess "Pushed $OriginalBranch to remote"
-    } else {
-      Write-PrizmWarn "Push failed - run git push manually"
-    }
-  }
-
-  & git -C $ProjectRoot branch -d $DevBranch *> $null
-  if ($LASTEXITCODE -eq 0) { Write-PrizmInfo "Deleted merged branch: $DevBranch" }
-
-  if ($hadStash) {
-    & git -C $ProjectRoot stash pop *> $null
-    if ($LASTEXITCODE -ne 0) { Write-PrizmWarn "git stash pop failed after merge" }
-  }
-
-  return $true
-}
-
-function Restore-PrizmOriginalBranch {
-  param(
-    [string]$ProjectRoot,
-    [string]$OriginalBranch,
-    [string]$DevBranch = ''
-  )
-
-  if (-not $OriginalBranch) { return $true }
-
-  & git -C $ProjectRoot rebase --show-current-patch *> $null
-  if ($LASTEXITCODE -eq 0) {
-    Write-PrizmWarn "Aborting in-progress rebase..."
-    & git -C $ProjectRoot rebase --abort *> $null
-  }
-
-  $currentBranch = Get-PrizmCurrentBranch $ProjectRoot
-  if ($currentBranch -eq $OriginalBranch) { return $true }
-
-  $wipBranch = if ($DevBranch) { $DevBranch } else { $currentBranch }
-  if ($wipBranch -and $wipBranch -ne $OriginalBranch) {
-    Save-PrizmBranchWip $ProjectRoot $wipBranch | Out-Null
-  }
-
-  Write-PrizmInfo "Ensuring return to original branch: $OriginalBranch (currently on: $currentBranch)"
-
-  $hadStash = $false
-  if (Test-PrizmTrackedDirty $ProjectRoot) {
-    & git -C $ProjectRoot stash push -m 'pipeline-ensure-return-stash' *> $null
-    if ($LASTEXITCODE -eq 0) { $hadStash = $true }
-  }
-
-  & git -C $ProjectRoot checkout $OriginalBranch *> $null
-  if ($LASTEXITCODE -eq 0) {
-    Write-PrizmInfo "Returned to branch: $OriginalBranch"
-  } else {
-    Write-PrizmError "Failed to checkout $OriginalBranch - manual recovery needed"
-  }
-
-  if ($hadStash) {
-    & git -C $ProjectRoot stash pop *> $null
-    if ($LASTEXITCODE -ne 0) { Write-PrizmWarn "git stash pop failed during branch return" }
-  }
-
-  return $true
-}