@sixsevenai/ai-dlc-installer 1.4.1 → 1.4.2

package/library/commands/ai-dlc/maker-status.md

@@ -1,422 +1,422 @@
----
-command: ai-dlc:maker-status
-name: maker-status
-description: View MAKER execution status, metrics, and checkpoint information
-argument-hint: "[execution-id] [--checkpoint] [--metrics]"
-phase: cross-cutting
-allowed-tools: Task, Read, Glob, Grep
-arguments:
-  - name: execution-id
-    description: Specific MAKER execution ID to view (optional, shows list if omitted)
-    required: false
-  - name: --checkpoint
-    description: View specific checkpoint details
-    required: false
-  - name: --metrics
-    description: Show detailed metrics for recent executions
-    required: false
-  - name: --period
-    description: Time period for metrics - 24h, 7d, 30d (default 7d)
-    required: false
-  - name: --red-flags
-    description: Show red-flag analysis and statistics
-    required: false
-  - name: --costs
-    description: Show cost breakdown and optimization suggestions
-    required: false
-  - name: --voting
-    description: Show voting records and consensus details
-    required: false
----
-
-# /ai-dlc:maker-status
-
-## CRITICAL: User-Facing Output Rules
-
-**NEVER output internal CLI commands to users.**
-
-When presenting next steps to the user, ALWAYS use slash commands:
-- `/ai-dlc:maker-status`
-- `/ai-dlc:maker-execute`
-- `/ai-dlc:generate-code --maker`
-
-All CLI commands in this document are for your internal execution only - never show them to users.
-
----
-
-View MAKER execution status, metrics, checkpoints, and optimization insights.
-
-## ENFORCEMENT QUICK REFERENCE
-
-> **This command operates under TypeScript CLI orchestration.**
-> ```bash
-> # List all MAKER executions
-> ai-dlc maker list
->
-> # View specific execution status
-> ai-dlc maker status <execution-id>
->
-> # View with flags
-> ai-dlc maker status <execution-id> --checkpoint --metrics
-> ```
-
----
-
-## Execution (ENFORCED)
-
-### Step 1: PREPARE - Get Status Information
-
-**List all executions:**
-```bash
-ai-dlc maker list
-```
-
-**Success Response:**
-```json
-{
-  "success": true,
-  "executions": [
-    {
-      "executionId": "maker-20251220-143022",
-      "status": "completed",
-      "task": "Generate Order aggregate",
-      "createdAt": "2025-12-20T14:30:22Z",
-      "completedAt": "2025-12-20T14:31:07Z",
-      "stepsCompleted": 8,
-      "totalSteps": 8
-    },
-    {
-      "executionId": "maker-20251220-140515",
-      "status": "running",
-      "task": "Generate Payment service",
-      "createdAt": "2025-12-20T14:05:15Z",
-      "stepsCompleted": 3,
-      "totalSteps": 6
-    }
-  ],
-  "summary": {
-    "total": 2,
-    "completed": 1,
-    "running": 1,
-    "failed": 0
-  }
-}
-```
-
-### Step 2: VIEW - Get Detailed Status
-
-**View specific execution:**
-```bash
-ai-dlc maker status <execution-id>
-```
-
-**Success Response:**
-```json
-{
-  "success": true,
-  "execution": {
-    "executionId": "maker-20251220-143022",
-    "status": "completed",
-    "task": "Generate Order aggregate with CRUD operations",
-    "config": {
-      "k": 2,
-      "agents": 3,
-      "granularity": "function"
-    },
-    "progress": {
-      "completedSteps": 8,
-      "totalSteps": 8,
-      "currentStep": null
-    },
-    "timing": {
-      "createdAt": "2025-12-20T14:30:22Z",
-      "completedAt": "2025-12-20T14:31:07Z",
-      "duration": "45s"
-    }
-  }
-}
-```
-
-### Step 3: DETAILS - Optional Detail Views
-
-**View checkpoint details:**
-```bash
-ai-dlc maker status <execution-id> --checkpoint
-```
-
-**View metrics:**
-```bash
-ai-dlc maker status <execution-id> --metrics
-```
-
-**View red-flag log:**
-```bash
-ai-dlc maker status <execution-id> --red-flags
-```
-
-**View cost breakdown:**
-```bash
-ai-dlc maker status <execution-id> --costs
-```
-
-**View voting records:**
-```bash
-ai-dlc maker status <execution-id> --voting
-```
-
----
-
-## Internal CLI Commands (DO NOT OUTPUT TO USER)
-
-> **REMINDER**: These commands are for internal orchestration only. Never show CLI commands to users.
-
-### List Executions
-```bash
-# List all executions (default: last 7 days)
-ai-dlc maker list
-
-# List with period filter
-ai-dlc maker list --period 24h
-ai-dlc maker list --period 30d
-```
-
-### View Status
-```bash
-# Basic status
-ai-dlc maker status maker-20251220-143022
-
-# With checkpoint details
-ai-dlc maker status maker-20251220-143022 --checkpoint
-
-# With all details
-ai-dlc maker status maker-20251220-143022 --checkpoint --metrics --red-flags --costs --voting
-```
-
-### Validate Checkpoint
-```bash
-ai-dlc maker validate maker-20251220-143022
-```
-
----
-
-## Status Display Flags
-
-### --checkpoint (Checkpoint Details)
-
-Shows decomposition plan, step states, and file paths:
-
-```yaml
-checkpoint:
-  id: maker-20251220-143022
-  path: artifacts/maker/maker-20251220-143022/
-
-  steps:
-    - id: step-001
-      description: "Generate class signature"
-      status: completed
-      votingRounds: 0
-      tokens: 47
-      duration: 2.1s
-
-    - id: step-002
-      description: "Generate properties"
-      status: completed
-      votingRounds: 1
-      tokens: 89
-      duration: 2.8s
-
-  files:
-    - README.md: present
-    - decomposition-plan.yaml: present
-    - progress.yaml: present
-    - voting-records.yaml: present
-    - red-flag-log.yaml: present
-    - metrics-summary.yaml: present
-
-  progressMarker: absent  # Indicates successful completion
-```
-
-### --metrics (Execution Metrics)
-
-Shows reliability, performance, and accuracy:
-
-```yaml
-metrics:
-  reliability:
-    successRate: 0.982
-    consensusRate: 0.941
-    redFlagRate: 0.063
-
-  execution:
-    totalSteps: 8
-    votingRounds: 12
-    retries: 1
-
-  performance:
-    totalDuration: 45s
-    avgStepDuration: 5.6s
-    parallelEfficiency: 0.85
-```
-
-### --red-flags (Red-Flag Analysis)
-
-Shows filtered responses and reasons:
-
-```yaml
-redFlags:
-  totalFlagged: 2
-  totalResponses: 24
-  flagRate: 8.3%
-
-  byRule:
-    token_overflow: 1
-    hedging_language: 1
-    format_violation: 0
-    context_drift: 0
-    repetition: 0
-
-  flaggedResponses:
-    - stepId: step-004
-      agentId: agent-2
-      rule: token_overflow
-      tokenCount: 847
-      maxAllowed: 700
-
-    - stepId: step-006
-      agentId: agent-1
-      rule: hedging_language
-      phrase: "I think this might work"
-```
-
-### --costs (Cost Breakdown)
-
-Shows token usage and cost estimates:
-
-```yaml
-costs:
-  summary:
-    totalTokens: 4500
-    estimatedCost: $0.12
-    costPerStep: $0.015
-
-  byModel:
-    haiku:
-      tokens: 4500
-      cost: $0.12
-      percentage: 100%
-
-  votingOverhead:
-    additionalTokens: 1200
-    additionalCost: $0.03
-    overheadPercentage: 27%
-```
-
-### --voting (Voting Records)
-
-Shows consensus details for each step:
-
-```yaml
-voting:
-  totalRounds: 12
-  avgRoundsPerStep: 1.5
-  unanimousDecisions: 5
-
-  byStep:
-    - stepId: step-004
-      rounds: 2
-      k: 2
-      agents: 3
-      winner: "response-hash-abc123"
-      votes: [2, 1, 0]
-      consensus: true
-
-    - stepId: step-006
-      rounds: 3
-      k: 2
-      agents: 4
-      winner: "response-hash-def456"
-      votes: [3, 1, 0, 0]
-      consensus: true
-```
-
----
-
-## Checkpoint Structure
-
-```
-artifacts/maker/{execution-id}/
-├── .checkpoint-progress.yaml    # DELETED on success
-├── README.md                    # Human-readable summary
-├── decomposition-plan.yaml      # Task breakdown
-├── progress.yaml                # Execution state
-├── voting-records.yaml          # Voting data
-├── red-flag-log.yaml            # Filtered responses
-├── metrics-summary.yaml         # Performance metrics
-└── step-outputs/
-    ├── step-001.yaml
-    └── ...
-```
-
-**Quick Status Check**:
-- If `.checkpoint-progress.yaml` exists → Incomplete/In-Progress
-- If `.checkpoint-progress.yaml` absent → Complete (success)
-
----
-
-## Failed Execution Recovery
-
-When viewing a failed execution:
-
-```bash
-ai-dlc maker status maker-20251220-162045
-```
-
-**Failed Response:**
-```json
-{
-  "success": true,
-  "execution": {
-    "executionId": "maker-20251220-162045",
-    "status": "failed",
-    "task": "Generate authentication flow",
-    "failure": {
-      "step": "step-004",
-      "description": "Generate token validation",
-      "error": "No consensus after 15 rounds",
-      "lastVotes": {
-        "optionA": 4,
-        "optionB": 4,
-        "optionC": 2
-      }
-    },
-    "recovery": {
-      "resumable": true,
-      "completedSteps": ["step-001", "step-002", "step-003"],
-      "resumeFrom": "step-004"
-    }
-  },
-  "recommendations": [
-    "Clarify task requirements for step-004",
-    "Increase k to 3 for this step",
-    "Consider using sonnet model for complex logic"
-  ],
-  "resumeCommand": "ai-dlc maker resume maker-20251220-162045"
-}
-```
-
----
-
-## Related Commands
-
-- `/ai-dlc:maker-execute` - Execute tasks with MAKER patterns
-- `/ai-dlc:generate-code --maker` - Code generation with MAKER consensus
-- `/ai-dlc:review-code --maker` - Code review with MAKER consensus
-
-## Related Skills
-
-- `maker-orchestration` - MAKER framework theory and configuration
-- `voting-consensus` - Voting implementation details
-
----
-
-**Created**: Status from `artifacts/maker/` checkpoint files
+---
+command: ai-dlc:maker-status
+name: maker-status
+description: View MAKER execution status, metrics, and checkpoint information
+argument-hint: "[execution-id] [--checkpoint] [--metrics]"
+phase: cross-cutting
+allowed-tools: Task, Read, Glob, Grep
+arguments:
+  - name: execution-id
+    description: Specific MAKER execution ID to view (optional, shows list if omitted)
+    required: false
+  - name: --checkpoint
+    description: View specific checkpoint details
+    required: false
+  - name: --metrics
+    description: Show detailed metrics for recent executions
+    required: false
+  - name: --period
+    description: Time period for metrics - 24h, 7d, 30d (default 7d)
+    required: false
+  - name: --red-flags
+    description: Show red-flag analysis and statistics
+    required: false
+  - name: --costs
+    description: Show cost breakdown and optimization suggestions
+    required: false
+  - name: --voting
+    description: Show voting records and consensus details
+    required: false
+---
+
+# /ai-dlc:maker-status
+
+## CRITICAL: User-Facing Output Rules
+
+**NEVER output internal CLI commands to users.**
+
+When presenting next steps to the user, ALWAYS use slash commands:
+- `/ai-dlc:maker-status`
+- `/ai-dlc:maker-execute`
+- `/ai-dlc:generate-code --maker`
+
+All CLI commands in this document are for your internal execution only - never show them to users.
+
+---
+
+View MAKER execution status, metrics, checkpoints, and optimization insights.
+
+## ENFORCEMENT QUICK REFERENCE
+
+> **This command operates under TypeScript CLI orchestration.**
+> ```bash
+> # List all MAKER executions
+> ai-dlc maker list
+>
+> # View specific execution status
+> ai-dlc maker status <execution-id>
+>
+> # View with flags
+> ai-dlc maker status <execution-id> --checkpoint --metrics
+> ```
+
+---
+
+## Execution (ENFORCED)
+
+### Step 1: PREPARE - Get Status Information
+
+**List all executions:**
+```bash
+ai-dlc maker list
+```
+
+**Success Response:**
+```json
+{
+  "success": true,
+  "executions": [
+    {
+      "executionId": "maker-20251220-143022",
+      "status": "completed",
+      "task": "Generate Order aggregate",
+      "createdAt": "2025-12-20T14:30:22Z",
+      "completedAt": "2025-12-20T14:31:07Z",
+      "stepsCompleted": 8,
+      "totalSteps": 8
+    },
+    {
+      "executionId": "maker-20251220-140515",
+      "status": "running",
+      "task": "Generate Payment service",
+      "createdAt": "2025-12-20T14:05:15Z",
+      "stepsCompleted": 3,
+      "totalSteps": 6
+    }
+  ],
+  "summary": {
+    "total": 2,
+    "completed": 1,
+    "running": 1,
+    "failed": 0
+  }
+}
+```
+
+### Step 2: VIEW - Get Detailed Status
+
+**View specific execution:**
+```bash
+ai-dlc maker status <execution-id>
+```
+
+**Success Response:**
+```json
+{
+  "success": true,
+  "execution": {
+    "executionId": "maker-20251220-143022",
+    "status": "completed",
+    "task": "Generate Order aggregate with CRUD operations",
+    "config": {
+      "k": 2,
+      "agents": 3,
+      "granularity": "function"
+    },
+    "progress": {
+      "completedSteps": 8,
+      "totalSteps": 8,
+      "currentStep": null
+    },
+    "timing": {
+      "createdAt": "2025-12-20T14:30:22Z",
+      "completedAt": "2025-12-20T14:31:07Z",
+      "duration": "45s"
+    }
+  }
+}
+```
+
+### Step 3: DETAILS - Optional Detail Views
+
+**View checkpoint details:**
+```bash
+ai-dlc maker status <execution-id> --checkpoint
+```
+
+**View metrics:**
+```bash
+ai-dlc maker status <execution-id> --metrics
+```
+
+**View red-flag log:**
+```bash
+ai-dlc maker status <execution-id> --red-flags
+```
+
+**View cost breakdown:**
+```bash
+ai-dlc maker status <execution-id> --costs
+```
+
+**View voting records:**
+```bash
+ai-dlc maker status <execution-id> --voting
+```
+
+---
+
+## Internal CLI Commands (DO NOT OUTPUT TO USER)
+
+> **REMINDER**: These commands are for internal orchestration only. Never show CLI commands to users.
+
+### List Executions
+```bash
+# List all executions (default: last 7 days)
+ai-dlc maker list
+
+# List with period filter
+ai-dlc maker list --period 24h
+ai-dlc maker list --period 30d
+```
+
+### View Status
+```bash
+# Basic status
+ai-dlc maker status maker-20251220-143022
+
+# With checkpoint details
+ai-dlc maker status maker-20251220-143022 --checkpoint
+
+# With all details
+ai-dlc maker status maker-20251220-143022 --checkpoint --metrics --red-flags --costs --voting
+```
+
+### Validate Checkpoint
+```bash
+ai-dlc maker validate maker-20251220-143022
+```
+
+---
+
+## Status Display Flags
+
+### --checkpoint (Checkpoint Details)
+
+Shows decomposition plan, step states, and file paths:
+
+```yaml
+checkpoint:
+  id: maker-20251220-143022
+  path: artifacts/maker/maker-20251220-143022/
+
+  steps:
+    - id: step-001
+      description: "Generate class signature"
+      status: completed
+      votingRounds: 0
+      tokens: 47
+      duration: 2.1s
+
+    - id: step-002
+      description: "Generate properties"
+      status: completed
+      votingRounds: 1
+      tokens: 89
+      duration: 2.8s
+
+  files:
+    - README.md: present
+    - decomposition-plan.yaml: present
+    - progress.yaml: present
+    - voting-records.yaml: present
+    - red-flag-log.yaml: present
+    - metrics-summary.yaml: present
+
+  progressMarker: absent  # Indicates successful completion
+```
+
+### --metrics (Execution Metrics)
+
+Shows reliability, performance, and accuracy:
+
+```yaml
+metrics:
+  reliability:
+    successRate: 0.982
+    consensusRate: 0.941
+    redFlagRate: 0.063
+
+  execution:
+    totalSteps: 8
+    votingRounds: 12
+    retries: 1
+
+  performance:
+    totalDuration: 45s
+    avgStepDuration: 5.6s
+    parallelEfficiency: 0.85
+```
+
+### --red-flags (Red-Flag Analysis)
+
+Shows filtered responses and reasons:
+
+```yaml
+redFlags:
+  totalFlagged: 2
+  totalResponses: 24
+  flagRate: 8.3%
+
+  byRule:
+    token_overflow: 1
+    hedging_language: 1
+    format_violation: 0
+    context_drift: 0
+    repetition: 0
+
+  flaggedResponses:
+    - stepId: step-004
+      agentId: agent-2
+      rule: token_overflow
+      tokenCount: 847
+      maxAllowed: 700
+
+    - stepId: step-006
+      agentId: agent-1
+      rule: hedging_language
+      phrase: "I think this might work"
+```
+
+### --costs (Cost Breakdown)
+
+Shows token usage and cost estimates:
+
+```yaml
+costs:
+  summary:
+    totalTokens: 4500
+    estimatedCost: $0.12
+    costPerStep: $0.015
+
+  byModel:
+    haiku:
+      tokens: 4500
+      cost: $0.12
+      percentage: 100%
+
+  votingOverhead:
+    additionalTokens: 1200
+    additionalCost: $0.03
+    overheadPercentage: 27%
+```
+
+### --voting (Voting Records)
+
+Shows consensus details for each step:
+
+```yaml
+voting:
+  totalRounds: 12
+  avgRoundsPerStep: 1.5
+  unanimousDecisions: 5
+
+  byStep:
+    - stepId: step-004
+      rounds: 2
+      k: 2
+      agents: 3
+      winner: "response-hash-abc123"
+      votes: [2, 1, 0]
+      consensus: true
+
+    - stepId: step-006
+      rounds: 3
+      k: 2
+      agents: 4
+      winner: "response-hash-def456"
+      votes: [3, 1, 0, 0]
+      consensus: true
+```
+
+---
+
+## Checkpoint Structure
+
+```
+artifacts/maker/{execution-id}/
+├── .checkpoint-progress.yaml    # DELETED on success
+├── README.md                    # Human-readable summary
+├── decomposition-plan.yaml      # Task breakdown
+├── progress.yaml                # Execution state
+├── voting-records.yaml          # Voting data
+├── red-flag-log.yaml            # Filtered responses
+├── metrics-summary.yaml         # Performance metrics
+└── step-outputs/
+    ├── step-001.yaml
+    └── ...
+```
+
+**Quick Status Check**:
+- If `.checkpoint-progress.yaml` exists → Incomplete/In-Progress
+- If `.checkpoint-progress.yaml` absent → Complete (success)
+
+---
+
+## Failed Execution Recovery
+
+When viewing a failed execution:
+
+```bash
+ai-dlc maker status maker-20251220-162045
+```
+
+**Failed Response:**
+```json
+{
+  "success": true,
+  "execution": {
+    "executionId": "maker-20251220-162045",
+    "status": "failed",
+    "task": "Generate authentication flow",
+    "failure": {
+      "step": "step-004",
+      "description": "Generate token validation",
+      "error": "No consensus after 15 rounds",
+      "lastVotes": {
+        "optionA": 4,
+        "optionB": 4,
+        "optionC": 2
+      }
+    },
+    "recovery": {
+      "resumable": true,
+      "completedSteps": ["step-001", "step-002", "step-003"],
+      "resumeFrom": "step-004"
+    }
+  },
+  "recommendations": [
+    "Clarify task requirements for step-004",
+    "Increase k to 3 for this step",
+    "Consider using sonnet model for complex logic"
+  ],
+  "resumeCommand": "ai-dlc maker resume maker-20251220-162045"
+}
+```
+
+---
+
+## Related Commands
+
+- `/ai-dlc:maker-execute` - Execute tasks with MAKER patterns
+- `/ai-dlc:generate-code --maker` - Code generation with MAKER consensus
+- `/ai-dlc:review-code --maker` - Code review with MAKER consensus
+
+## Related Skills
+
+- `maker-orchestration` - MAKER framework theory and configuration
+- `voting-consensus` - Voting implementation details
+
+---
+
+**Created**: Status from `artifacts/maker/` checkpoint files