@danmoisan/drm-copilot-mcp 1.0.21 → 1.0.23

package/resources/claude-customizations/.claude/skills/parallel-run/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: parallel-run
+description: Execute a previously planned parallel run by replaying the committed parallel-kickoff artifact through the parallel-orchestrator agent. Use after /parallel-plan has prepared the run (manifest, per-item folders, research, specs, atomic plans, preflight clearance, seeded cohorts) and the user is ready to execute end-to-end.
+argument-hint: "[parallel-slug]"
+context: fork
+agent: parallel-orchestrator
+---
+
+# Parallel Run Skill
+
+A user invocation (`/parallel-run <parallel-slug>`) forks the `parallel-orchestrator` agent to
+execute a parallel run that `parallel-planner` has already prepared. The parallel slug (or a path
+under `docs/features/parallel/`) for this run is:
+
+$ARGUMENTS
+
+## Procedure
+
+1. Resolve the parallel home. A bare slug resolves to `docs/features/parallel/<parallel-slug>/`; a
+   path argument resolves to its containing parallel run folder.
+2. Resolve the committed kickoff artifact
+   `docs/features/parallel/<parallel-slug>/parallel-kickoff.md`. Discovery is a single local path
+   lookup in the invoking worktree. This surface has no integration branch, so there is no
+   integration ref to fetch, no ref-existence probe to run, and no ref-reading fallback to attempt:
+   the durable copy of the kickoff artifact is committed by `/parallel-plan` on the planner branch
+   `parallel/<parallel-slug>-plan` and is reachable from the checkout that invokes this skill.
+   - STOP without delegating anything when that path does not exist. Report that the run has no
+     committed kickoff artifact: the user must run `/parallel-plan` first (or, for a run whose
+     manifest was authored manually, invoke `/parallel-orchestrate <manifest-path>` directly).
+   - Do not synthesize a kickoff prompt, do not fall back to the planner's working copy under
+     `artifacts/orchestration/`, and do not launch a partial run in place of the STOP.
+3. Execute the kickoff artifact's `## Invocation Prompt` section as the run objective, applying the
+   `parallel-orchestrate` skill procedure and the `## Prepared-Run Execution` section of
+   `.claude/agents/parallel-orchestrator.md`: each item's child `Agent(orchestrator)` delegation
+   resumes at atomic execution from that item's committed `plan-path` rather than re-running
+   promotion, research, or planning. Feature-document authoring and preflight clearance are
+   likewise not repeated: those outputs are already committed and preflight-clear on each item's
+   own pushed feature branch.
+4. Honor existing checkpoint state: if `artifacts/orchestration/parallel-orchestrator-state.json`
+   already tracks this `parallel_slug`, resume per the `parallel-orchestrate` skill's resume
+   procedure instead of restarting, re-deriving durable ground truth from
+   `git worktree list --porcelain`, `git branch`, and `gh pr view --json state,mergedAt,headRefOid`
+   before acting on any recorded value.
+
+## Scope
+
+This skill adds no procedure of its own beyond kickoff-artifact resolution. Cohort consumption and
+ordering, the cohort barrier, `max_concurrency` slot filling, the per-item branch and worktree
+lifecycle, the child kickoff parameter, model selection, per-item merge to `main` on green,
+per-item merge-conflict handling, worktree cleanup, `parallel-status.md` maintenance, checkpoint
+persistence, and mode-dependent completion are governed entirely by the `parallel-orchestrate`
+skill (`.claude/skills/parallel-orchestrate/SKILL.md`).
+
+There is no final integration pull request on this surface, and no fan-in step follows the items:
+each item's pull request targets `main` directly and is merged individually by
+`parallel-orchestrator` after its checks are durably confirmed green.

package/resources/claude-customizations/config/blast-radius.json

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "shared_surfaces": [
+    ".claude/settings.json",
+    "config/orchestration-routing.json",
+    "config/blast-radius.json"
+  ],
+  "shared_surface_globs": [],
+  "modules": {
+    "claude-runtime": [".claude/**"],
+    "config": ["config/**"],
+    "docs": ["docs/**"],
+    "tests": ["tests/**"]
+  },
+  "over_breadth_fraction": 0.25
+}

package/resources/claude-customizations/config/orchestration-routing.json

@@ -0,0 +1,355 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "version": 1,
+  "routes": {
+    "small": {
+      "description": "Minor-audit path for work inside the applicable language budget.",
+      "codex_topology_requirement": {
+        "receipt_key": "codex_topology_receipts",
+        "required_execution_context": "standalone",
+        "required_route": "small",
+        "delegation_agent_source": "resolved_language_typed_engineer"
+      },
+      "required_agents": [
+        "atomic-planner",
+        "atomic-executor",
+        "feature-review"
+      ],
+      "required_skills": [
+        "orchestrate",
+        "feature-promotion-lifecycle",
+        "atomic-plan-contract",
+        "acceptance-criteria-tracking",
+        "pr-context-artifacts",
+        "pr-base-branch-merge-base"
+      ],
+      "required_mcp_tools": [
+        "new_potential_entry",
+        "potential_to_issue",
+        "new_active_feature_folder",
+        "collect_pr_context",
+        "validate_orchestration_artifacts"
+      ]
+    },
+    "large": {
+      "description": "Full feature or bug path for work outside small-path budget.",
+      "requires_pr_gate": true,
+      "required_agents": [
+        "task-researcher",
+        "prd-feature",
+        "atomic-planner",
+        "atomic-executor",
+        "feature-review",
+        "pr-author"
+      ],
+      "required_skills": [
+        "orchestrate",
+        "feature-promotion-lifecycle",
+        "atomic-plan-contract",
+        "acceptance-criteria-tracking",
+        "pr-context-artifacts",
+        "pr-base-branch-merge-base"
+      ],
+      "required_mcp_tools": [
+        "new_potential_entry",
+        "potential_to_issue",
+        "new_active_feature_folder",
+        "collect_pr_context",
+        "validate_orchestration_artifacts"
+      ]
+    },
+    "remediation": {
+      "description": "Review-triggered remediation loop.",
+      "required_agents": [
+        "atomic-planner",
+        "atomic-executor",
+        "feature-review"
+      ],
+      "required_skills": [
+        "orchestrate",
+        "atomic-plan-contract",
+        "acceptance-criteria-tracking",
+        "pr-context-artifacts"
+      ],
+      "required_mcp_tools": [
+        "collect_pr_context",
+        "validate_orchestration_artifacts"
+      ]
+    },
+    "preparation": {
+      "description": "Epic preparation path driven by epic-planner: promotion, research, feature documents, atomic planning, and preflight clearance only. Atomic execution, PR authoring, and CI monitoring are out of scope and deferred to the epic execution phase, so this route requires no CI gate at completion.",
+      "requires_ci_gate": false,
+      "required_agents": [
+        "task-researcher",
+        "prd-feature",
+        "atomic-planner",
+        "atomic-executor"
+      ],
+      "required_skills": [
+        "orchestrate",
+        "feature-promotion-lifecycle",
+        "atomic-plan-contract"
+      ],
+      "required_mcp_tools": [
+        "new_potential_entry",
+        "potential_to_issue",
+        "new_active_feature_folder",
+        "validate_orchestration_artifacts"
+      ]
+    },
+    "parallel": {
+      "description": "Parallel path for scheduling independent items into blast-radius cohorts across parallel worktrees; each item PRs to main independently with no integration branch.",
+      "requires_pr_gate": false,
+      "required_agents": [
+        "orchestrator",
+        "pr-author"
+      ],
+      "required_skills": [
+        "parallel-orchestrate",
+        "orchestrate",
+        "feature-promotion-lifecycle",
+        "atomic-plan-contract",
+        "acceptance-criteria-tracking",
+        "evidence-and-timestamp-conventions",
+        "pr-context-artifacts",
+        "pr-base-branch-merge-base"
+      ],
+      "required_mcp_tools": [
+        "collect_pr_context",
+        "validate_orchestration_artifacts"
+      ]
+    },
+    "epic": {
+      "description": "Epic path for scheduling a dependency graph of child features across parallel worktrees with fan-in via a shared integration branch.",
+      "requires_pr_gate": true,
+      "required_agents": [
+        "orchestrator",
+        "pr-author"
+      ],
+      "required_skills": [
+        "epic-orchestrate",
+        "orchestrate",
+        "feature-promotion-lifecycle",
+        "atomic-plan-contract",
+        "acceptance-criteria-tracking",
+        "evidence-and-timestamp-conventions",
+        "pr-context-artifacts",
+        "pr-base-branch-merge-base"
+      ],
+      "required_mcp_tools": [
+        "collect_pr_context",
+        "validate_orchestration_artifacts"
+      ]
+    }
+  },
+  "model_policy": {
+    "description": "Judgment-based complexity-band model selection. This block governs only the delegation model tier. It is not a route input, and route is not an input to model selection.",
+    "tier_order": [
+      "haiku",
+      "sonnet",
+      "opus",
+      "fable"
+    ],
+    "complexity": {
+      "scale": "C1 trivial or mechanical change with no behavior effect. C2 localized feature or bug change confined to a small surface. C3 cross-cutting change that alters an invariant, contract, or behavior across module boundaries. C4 novel, ambiguous, or research-heavy change requiring the most capable tier; C4 is reached only by judgment and is never floor-forced.",
+      "signals": [
+        {
+          "name": "classifier_or_model_logic",
+          "floor": true,
+          "anchor": "Changes to classifier engines, scoring, or model-affecting logic (T1 modules)."
+        },
+        {
+          "name": "auth_or_token_handling",
+          "floor": true,
+          "anchor": "Changes to authentication, token handling, or other security-sensitive paths."
+        },
+        {
+          "name": "concurrency_or_ordering",
+          "floor": true,
+          "anchor": "Introduces or modifies concurrency, ordering, or state-transition invariants."
+        },
+        {
+          "name": "cross_module_contract_change",
+          "floor": true,
+          "anchor": "Alters a public contract or schema consumed across module boundaries."
+        },
+        {
+          "name": "single_file_localized_edit",
+          "floor": false,
+          "anchor": "A localized edit confined to one file with no cross-cutting effect."
+        },
+        {
+          "name": "mechanical_rename_or_move",
+          "floor": false,
+          "anchor": "A mechanical rename, move, or formatting change with no behavior change."
+        },
+        {
+          "name": "docs_or_comment_only",
+          "floor": false,
+          "anchor": "A documentation-only or comment-only change."
+        }
+      ]
+    },
+    "complexity_to_model": {
+      "C1": "haiku",
+      "C2": "sonnet",
+      "C3": "opus",
+      "C4": "fable"
+    },
+    "preferred_overlay": {
+      "description": "Applied only under fable_policy preferred. Changes only the C3 cell to fable, and only for the listed agents. No other agent and no other band is affected.",
+      "agents": [
+        "atomic-planner",
+        "prd-feature",
+        "feature-review",
+        "task-researcher"
+      ],
+      "band": "C3",
+      "model": "fable"
+    }
+  },
+  "model_budget": {
+    "description": "Session-level model budget. fable_policy is a three-way switch controlling whether the fable tier is disabled (removed and clamped to opus), available (used as-is), or preferred (applies the preferred_overlay).",
+    "fable_policy": "preferred"
+  },
+  "codex_topology_policy": {
+    "description": "Codex-native production-file-count routing. This axis selects the initial implementation topology independently from C1-C4 model selection.",
+    "execution_contexts": [
+      "standalone",
+      "epic_preparation_child",
+      "epic_execution_child"
+    ],
+    "language_budgets": {
+      "python": {
+        "direct_mode_enabled": true,
+        "max_production_files": 3,
+        "max_test_files": 3,
+        "logical_agent": "python-typed-engineer"
+      },
+      "powershell": {
+        "direct_mode_enabled": true,
+        "max_production_files": 2,
+        "max_test_files": 3,
+        "logical_agent": "powershell-typed-engineer"
+      },
+      "csharp": {
+        "direct_mode_enabled": true,
+        "max_production_files": 3,
+        "max_test_files": 3,
+        "logical_agent": "csharp-typed-engineer"
+      },
+      "typescript": {
+        "direct_mode_enabled": false,
+        "max_production_files": 0,
+        "max_test_files": 0,
+        "logical_agent": "typescript-engineer"
+      }
+    },
+    "orchestrator_logical_agent": "orchestrator",
+    "epic_child_contexts": [
+      "epic_preparation_child",
+      "epic_execution_child"
+    ],
+      "forced_root_personas": [
+        "epic-planner",
+        "epic-orchestrator"
+      ],
+      "parallelism": {
+        "default_max_parallel_features": 4,
+        "hard_max_parallel_features": 8
+      },
+      "escalation_precedence": [
+      "epic_child_context",
+      "invalid_estimate",
+      "cross_language",
+      "unsupported_language",
+      "cross_cutting",
+        "direct_mode_disabled",
+        "production_budget_exceeded"
+    ],
+    "receipt_key": "codex_topology_receipts"
+  },
+  "codex_model_policy": {
+    "description": "Codex-native deployment profiles. Complexity selects model and reasoning independently from the file-count route; exact model slugs are mandatory and unavailable profiles do not fall back silently.",
+    "profile_order": [
+      "c1",
+      "c2",
+      "c3",
+      "c3-elevated",
+      "c4"
+    ],
+    "execution_contexts": [
+      "standalone",
+      "epic_preparation_child",
+      "epic_execution_child"
+    ],
+    "logical_agent_aliases": {
+      "feature-review": "feature-reviewer"
+    },
+    "complexity_to_profile": {
+      "C1": {
+        "suffix": "c1",
+        "model": "gpt-5.6-luna",
+        "model_reasoning_effort": "low"
+      },
+      "C2": {
+        "suffix": "c2",
+        "model": "gpt-5.6-terra",
+        "model_reasoning_effort": "medium"
+      },
+      "C3": {
+        "suffix": "c3",
+        "model": "gpt-5.6-terra",
+        "model_reasoning_effort": "high"
+      },
+      "C4": {
+        "suffix": "c4",
+        "model": "gpt-5.6-sol",
+        "model_reasoning_effort": "max"
+      }
+    },
+      "c3_elevated_profile": {
+      "suffix": "c3-elevated",
+      "model": "gpt-5.6-sol",
+      "model_reasoning_effort": "high",
+      "activation": {
+        "operator": "any",
+        "execution_contexts": [
+          "epic_execution_child",
+          "epic_preparation_child"
+        ],
+        "orchestration_complexity_ceiling": "C4"
+      }
+      },
+      "ceiling_transition_policy": {
+        "monotonic": true,
+        "receipt_key": "ceiling_transition",
+        "affected_delegation_ids_required_on_increase": true
+      },
+      "forced_personas": {
+      "epic-planner": {
+        "suffix": "",
+        "model": "gpt-5.6-sol",
+        "model_reasoning_effort": "ultra"
+      },
+      "epic-orchestrator": {
+        "suffix": "",
+        "model": "gpt-5.6-sol",
+        "model_reasoning_effort": "ultra"
+      }
+    },
+    "generated_agent_families": [
+      "orchestrator",
+      "atomic-planner",
+      "atomic-executor",
+      "feature-reviewer",
+      "task-researcher",
+      "prd-feature",
+      "pr-author",
+      "python-typed-engineer",
+      "powershell-typed-engineer",
+      "csharp-typed-engineer",
+      "typescript-engineer"
+    ]
+  }
+}

package/resources/claude-customizations/pack-manifests/core.json

@@ -14,6 +14,8 @@
     ".claude/agents/legacy-parity-analyst.md",
     ".claude/agents/migration-coverage-reviewer.md",
     ".claude/agents/orchestrator.md",
+    ".claude/agents/parallel-orchestrator.md",
+    ".claude/agents/parallel-planner.md",
     ".claude/agents/prd-feature.md",
     ".claude/agents/requirements-reconciler.md",
     ".claude/agents/runtime-characterization-analyst.md",
@@ -31,6 +33,11 @@
     ".claude/hooks/enforce-feature-folder-order.ps1",
     ".claude/hooks/enforce-model-routing-receipt.ps1",
     ".claude/hooks/enforce-orchestration-preimplementation-gate.ps1",
+    ".claude/hooks/enforce-parallel-abandon-gate.ps1",
+    ".claude/hooks/enforce-parallel-cohort-barrier.ps1",
+    ".claude/hooks/enforce-parallel-drift-gate.ps1",
+    ".claude/hooks/enforce-parallel-drift-gate-helpers.ps1",
+    ".claude/hooks/enforce-parallel-worktree-removal-gate.ps1",
     ".claude/hooks/enforce-pr-author-skill.epic-base-branch.ps1",
     ".claude/hooks/enforce-pr-author-skill.ps1",
     ".claude/hooks/enforce-prd-feature-before-planner.ps1",
@@ -77,6 +84,12 @@
     ".claude/skills/identify-session-id/SKILL.md",
     ".claude/skills/make-skill-template/SKILL.md",
     ".claude/skills/orchestrate/SKILL.md",
+    ".claude/skills/parallel-add/SKILL.md",
+    ".claude/skills/parallel-close/SKILL.md",
+    ".claude/skills/parallel-orchestrate/SKILL.md",
+    ".claude/skills/parallel-plan/SKILL.md",
+    ".claude/skills/parallel-remove/SKILL.md",
+    ".claude/skills/parallel-run/SKILL.md",
     ".claude/skills/policy-audit-template-usage/SKILL.md",
     ".claude/skills/policy-compliance-order/SKILL.md",
     ".claude/skills/pr-author/SKILL.md",
@@ -93,6 +106,24 @@
     ".claude/skills/update-status/SKILL.md",
     ".claude/lib/model-routing/ModelRouting.psm1",
     ".claude/lib/orchestrator-state/OrchestratorState.psm1",
-    ".claude/lib/orchestrator-state/OrchestratorStateCompletion.psm1"
+    ".claude/lib/orchestrator-state/OrchestratorStateCompletion.psm1",
+    ".claude/lib/blast-radius/BlastRadiusExtraction.psm1",
+    ".claude/lib/blast-radius/BlastRadiusGlob.psm1",
+    ".claude/lib/blast-radius/BlastRadiusConfig.psm1",
+    ".claude/lib/blast-radius/BlastRadiusValidation.psm1",
+    ".claude/lib/blast-radius/BlastRadius.psm1",
+    ".claude/rules/parallel-orchestration.md",
+    ".claude/rules/shell.md",
+    ".claude/lib/bash/compute-cohorts.sh",
+    ".claude/lib/bash/compute-concurrency-batches.sh",
+    ".claude/lib/bash/parallel-cohorts.sh",
+    ".claude/lib/bash/parallel-common.sh",
+    ".claude/lib/bash/parallel-items-validate.sh",
+    ".claude/lib/bash/parallel-manifest-validate.sh",
+    ".claude/lib/bash/parallel-yaml-emit.sh",
+    ".claude/lib/bash/parallel-yaml-scan.sh",
+    ".claude/lib/bash/validate-parallel-manifest.sh",
+    "config/orchestration-routing.json",
+    "config/blast-radius.json"
   ]
 }

package/resources/codex-and-agents-customizations/.codex/config.toml

@@ -2,7 +2,7 @@ default_permissions = ":danger-full-access"
 
 [mcp_servers.drm-copilot]
 command = "npx"
-args = ["-y", "@danmoisan/drm-copilot-mcp@1.0.21"]
+args = ["-y", "@danmoisan/drm-copilot-mcp@1.0.23"]
 required = true
 enabled_tools = [
     "collect_commit_context",

package/resources/config/orchestration-routing.json

@@ -97,6 +97,28 @@
         "validate_orchestration_artifacts"
       ]
     },
+    "parallel": {
+      "description": "Parallel path for scheduling independent items into blast-radius cohorts across parallel worktrees; each item PRs to main independently with no integration branch.",
+      "requires_pr_gate": false,
+      "required_agents": [
+        "orchestrator",
+        "pr-author"
+      ],
+      "required_skills": [
+        "parallel-orchestrate",
+        "orchestrate",
+        "feature-promotion-lifecycle",
+        "atomic-plan-contract",
+        "acceptance-criteria-tracking",
+        "evidence-and-timestamp-conventions",
+        "pr-context-artifacts",
+        "pr-base-branch-merge-base"
+      ],
+      "required_mcp_tools": [
+        "collect_pr_context",
+        "validate_orchestration_artifacts"
+      ]
+    },
     "epic": {
       "description": "Epic path for scheduling a dependency graph of child features across parallel worktrees with fan-in via a shared integration branch.",
       "requires_pr_gate": true,

package/resources/powershell/PoshQC/settings/pester.runsettings.psd1

@@ -114,6 +114,35 @@
             # changed production surface is not excluded from coverage.
             '.codex/hooks/enforce-epic-child-worktree-binding.ps1'
             '.codex/hooks/enforce-epic-planning-only.ps1'
+            # Issue #447 added the .claude-resident PowerShell blast-radius library, the
+            # two-language mirror of scripts/dev_tools/compute_blast_radius.py and its
+            # helper modules. The set is split across five files only to satisfy the
+            # 500-line limit; measured here so no new production module is excluded from
+            # coverage.
+            '.claude/lib/blast-radius/BlastRadiusExtraction.psm1'
+            '.claude/lib/blast-radius/BlastRadiusGlob.psm1'
+            '.claude/lib/blast-radius/BlastRadiusConfig.psm1'
+            '.claude/lib/blast-radius/BlastRadiusValidation.psm1'
+            '.claude/lib/blast-radius/BlastRadius.psm1'
+            # Issue #440 added the two parallel enforcement hooks (the Layer 1 cohort
+            # barrier and the worktree removal gate) and extended the invocation-origin
+            # hook with the parallel-agent family; measured here so no new or changed
+            # production hook is excluded from coverage.
+            '.claude/hooks/enforce-parallel-cohort-barrier.ps1'
+            '.claude/hooks/enforce-parallel-worktree-removal-gate.ps1'
+            '.claude/hooks/enforce-epic-invocation-origin.ps1'
+            # Issue #446 added this Layer-1 parallel drift-gate PreToolUse hook; measured here so
+            # the new production hook is not excluded from coverage.
+            '.claude/hooks/enforce-parallel-drift-gate.ps1'
+            # Issue #446 remediation cycle 1 split the seven shape-and-derivation helpers out of
+            # that hook into this dot-sourced sibling module; measured here so the Coverage
+            # Exclusion Policy's no-production-file-excluded rule still holds after the split.
+            '.claude/hooks/enforce-parallel-drift-gate-helpers.ps1'
+            # Issue #442 added this PreToolUse abandon-gate hook, which guards the destructive
+            # parallel abandon disposition; measured here so the new production hook is not
+            # excluded from coverage. The test suite dot-sources the file (guarded body) so
+            # line attribution is valid.
+            '.claude/hooks/enforce-parallel-abandon-gate.ps1'
         )
         # Optional: don't fail the run on coverage percentage
         CoveragePercentTarget = 0