@mmerterden/multi-agent-pipeline 15.4.0 → 15.5.0

package/CHANGELOG.md

@@ -16,6 +16,15 @@ Internal file-layout changes that don't affect the slash-command surface are sti
 
 ## [Unreleased]
 
+## [15.5.0] - 2026-08-18
+
+### Added
+- **`sharedUtilities` census bucket** - the bind-don't-rebuild inventory: formatter families, validation rule types + per-module facades and design-token namespaces living outside screen slices, counted with samples; Phase 3 treats a non-empty bucket as binding.
+
+### Fixed
+- **Smoke runs never touch the live dashboard** - run-smokes exports `MULTI_AGENT_SMOKE=1` and phase-tracker's live ping returns under it (test gates were leaving phantom "running" rows on the timeline).
+- **Routing resolves the multi-agent-plugins toolkit first** - the public toolkit family is the pipeline's standard companion; a corporate variant is the fallback, not the default.
+
 ## [15.4.0] - 2026-08-18
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "15.4.0",
+  "version": "15.5.0",
   "description": "8-phase AI development pipeline with full orchestration on Claude Code, Copilot CLI and Codex CLI. Analysis, planning, TDD, CLI-aware parallel review with consensus surfacing + Fable triage, default-FAIL evidence gates, secret + intent guards, per-phase cost ledger, persistent learnings memory, wiki generation, commit automation. Token-preserving uninstall.",
   "type": "module",
   "main": "index.js",

package/pipeline/lib/extract-conventions.sh

@@ -1026,6 +1026,43 @@ bucket_di_registration() {
 # =============================================================================
 # Assemble final JSON
 # =============================================================================
+
+# =============================================================================
+# C13 - sharedUtilities: the bind-don't-rebuild inventory
+# =============================================================================
+# What shared machinery already exists OUTSIDE screen slices - formatter families,
+# validation rule types + per-module rule facades, design-token namespaces. A dev
+# phase that sees a non-empty bucket binds these instead of hand-rolling a
+# duplicate; the counts say how settled each family is.
+bucket_shared_utilities() {
+  local ext screens_seg
+  case "$PLATFORM" in
+    ios)     ext='*.swift' ; screens_seg='/Screens/' ;;
+    android) ext='*.kt'    ; screens_seg='/screens/' ;;
+    *)       empty_bucket; return ;;
+  esac
+  local files
+  files=$(run_find -type f -name "$ext" 2>/dev/null | grep -v "$screens_seg" | grep -viE '/tests?/|/generated/' || true)
+  if [ -z "$files" ]; then empty_bucket; return; fi
+  local fmt rules facades tokens
+  fmt=$(printf '%s
+' "$files"    | grep -cE '(Formatter|Format)\.(swift|kt)$' || true)
+  rules=$(printf '%s
+' "$files"  | grep -cE '[A-Za-z]Rule\.(swift|kt)$' || true)
+  facades=$(printf '%s
+' "$files"| grep -cE '(FormRules|ValidationRules)\.(swift|kt)$' || true)
+  tokens=$(printf '%s
+' "$files" | grep -cE '(Tokens?|Spacing|Radius|Typography)[A-Za-z]*\.(swift|kt)$' || true)
+  fmt=${fmt:-0}; rules=${rules:-0}; facades=${facades:-0}; tokens=${tokens:-0}
+  local total=$((fmt + rules + facades + tokens))
+  if [ "$total" -eq 0 ]; then empty_bucket; return; fi
+  local sample
+  sample=$(printf '%s
+' "$files" | grep -E '(Formatter|Format|Rule|FormRules|ValidationRules|Tokens?|Spacing|Radius|Typography)[A-Za-z]*\.(swift|kt)$' | head -5 | sed "s|^$REPO_PATH/||")
+  emit_bucket "formatters:$fmt rules:$rules facades:$facades tokens:$tokens"     "$(printf '%s
+' "$sample" | head -1)"     "$(confidence_for "$total")"     "$(files_to_json "$sample")" "[]"
+}
+
 folderStructure=$(run_bucket_with_timeout bucket_folder_structure)
 stateHolderNaming=$(run_bucket_with_timeout bucket_state_holder)
 viewNaming=$(run_bucket_with_timeout bucket_view_naming)
@@ -1038,6 +1075,7 @@ testMethodNaming=$(run_bucket_with_timeout bucket_test_method_naming)
 accessibilityIdentifier=$(run_bucket_with_timeout bucket_accessibility_identifier)
 localizationKey=$(run_bucket_with_timeout bucket_localization_key)
 diRegistration=$(run_bucket_with_timeout bucket_di_registration)
+sharedUtilities=$(run_bucket_with_timeout bucket_shared_utilities)
 
 jq -n \
   --argjson folderStructure "$folderStructure" \
@@ -1052,6 +1090,7 @@ jq -n \
   --argjson accessibilityIdentifier "$accessibilityIdentifier" \
   --argjson localizationKey "$localizationKey" \
   --argjson diRegistration "$diRegistration" \
+  --argjson sharedUtilities "$sharedUtilities" \
   '{
     folderStructure: $folderStructure,
     stateHolderNaming: $stateHolderNaming,
@@ -1064,7 +1103,8 @@ jq -n \
     testMethodNaming: $testMethodNaming,
     accessibilityIdentifier: $accessibilityIdentifier,
     localizationKey: $localizationKey,
-    diRegistration: $diRegistration
+    diRegistration: $diRegistration,
+    sharedUtilities: $sharedUtilities
   }'
 
 exit 0

package/pipeline/multi-agent-refs/features/stack-skill-routing.md

@@ -22,15 +22,15 @@ Platform comes from the same mapping component dispatch uses, so the two cannot
 
 | `state.platform` / detected stack | Toolkit candidates, first enabled wins |
 |---|---|
-| ios, swift | `ai-ios-engineering-toolkit`, then `ai-ios-toolkit` |
-| android, kotlin | `ai-android-engineering-toolkit`, then `ai-android-toolkit` |
+| ios, swift | `ai-ios-toolkit`, then `ai-ios-engineering-toolkit` |
+| android, kotlin | `ai-android-toolkit`, then `ai-android-engineering-toolkit` |
 | anything else | no toolkit  -  step is a recorded no-op |
 
-A row is an ORDERED candidate list, not one name: the corporate toolkit (where one exists)
-carries the project-specific doctrine and outranks its public derivation, so it resolves first.
-Probe the candidates in order against the enabled plugins and take the first hit. When none is
-enabled, the recorded no-op names every candidate probed - a repo that enabled a corporate
-toolkit the table did not know about must show up as a probe miss, never as silence.
+A row is an ORDERED candidate list, not one name: the multi-agent-plugins toolkit is the
+pipeline's standard companion and resolves first; a corporate variant is the fallback for a
+repo that enables only it. Probe the candidates in order against the enabled plugins and take
+the first hit. When none is enabled, the recorded no-op names every candidate probed - an
+enabled toolkit the table did not know about must show up as a probe miss, never as silence.
 
 The toolkit is enabled per repo (`.claude/settings.local.json` / `~/.claude/settings.json` `enabledPlugins`). **Not enabled is not an error here**, unlike component dispatch: a backend or web repo legitimately has no toolkit, and halting would make the pipeline unusable outside mobile. Record the no-op and continue.
 

package/pipeline/multi-agent-refs/phases/phase-3-dev.md

@@ -26,7 +26,7 @@ Pre-flight steps (run in order, abort on failure).
 
 5. **Standards binding citations**: read `analysis Section 21 References` table. For each row with `Rol: bağlayıcı / binding`, persist the source path into `state.dev.standardsBindings[]`. Phase 3 Dev tasks MUST cite at least one binding source per architectural decision (pre-existing Locked decision 8).
 
-6. **Conventions handoff**: read `analysis Section 13.1 Concept Table` (Pass B output with footnotes). Persist concept-to-realization mapping into `state.dev.conventions[<concept>]`. Phase 3 implementation uses these names verbatim (e.g., if Section 13.1 says "State holder: PassengerFlightViewModel", Phase 3 names the class exactly `PassengerFlightViewModel`).
+6. **Conventions handoff**: read `analysis Section 13.1 Concept Table` (Pass B output with footnotes). Persist concept-to-realization mapping into `state.dev.conventions[<concept>]`. Phase 3 implementation uses these names verbatim, and a non-empty `sharedUtilities` bucket is binding: bind those formatters/rule-facades/tokens, never hand-roll a duplicate (e.g., if Section 13.1 says "State holder: PassengerFlightViewModel", Phase 3 names the class exactly `PassengerFlightViewModel`).
 
 7. **MCP forbidden**: calling `mcp__claude_ai_Figma__*` in Phase 3 is a violation. `smoke-no-mcp-in-dev-phases.sh` reads `state.telemetry.mcpCalls[]` after the run and fails if Phase 3 contributed an entry.
 

package/pipeline/schemas/conventions-output.schema.json

@@ -18,27 +18,61 @@
     "testMethodNaming",
     "accessibilityIdentifier",
     "localizationKey",
-    "diRegistration"
+    "diRegistration",
+    "sharedUtilities"
   ],
   "properties": {
-    "folderStructure": { "$ref": "#/$defs/conventionBucket" },
-    "stateHolderNaming": { "$ref": "#/$defs/conventionBucket" },
-    "viewNaming": { "$ref": "#/$defs/conventionBucket" },
-    "navigatorNaming": { "$ref": "#/$defs/conventionBucket" },
-    "useCaseNaming": { "$ref": "#/$defs/conventionBucket" },
-    "repositoryNaming": { "$ref": "#/$defs/conventionBucket" },
-    "dtoNaming": { "$ref": "#/$defs/conventionBucket" },
-    "uiStateModel": { "$ref": "#/$defs/conventionBucket" },
-    "testMethodNaming": { "$ref": "#/$defs/conventionBucket" },
-    "accessibilityIdentifier": { "$ref": "#/$defs/conventionBucket" },
-    "localizationKey": { "$ref": "#/$defs/conventionBucket" },
-    "diRegistration": { "$ref": "#/$defs/conventionBucket" }
+    "folderStructure": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "stateHolderNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "viewNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "navigatorNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "useCaseNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "repositoryNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "dtoNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "uiStateModel": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "testMethodNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "accessibilityIdentifier": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "localizationKey": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "diRegistration": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "sharedUtilities": {
+      "$ref": "#/$defs/conventionBucket"
+    }
   },
   "$defs": {
     "conventionBucket": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["pattern", "example", "confidence", "evidenceFiles", "alternativeCandidates"],
+      "required": [
+        "pattern",
+        "example",
+        "confidence",
+        "evidenceFiles",
+        "alternativeCandidates"
+      ],
       "properties": {
         "pattern": {
           "type": "string",
@@ -50,18 +84,27 @@
         },
         "confidence": {
           "type": "string",
-          "enum": ["high", "medium", "low", "none"],
+          "enum": [
+            "high",
+            "medium",
+            "low",
+            "none"
+          ],
           "description": "high: 5+ examples; medium: 3-4; low: 1-2 or mixed; none: no evidence."
         },
         "evidenceFiles": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "maxItems": 5,
           "description": "Repo-relative or absolute paths backing the detection (capped at 5)."
         },
         "alternativeCandidates": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Competing patterns that were observed but lost the majority vote."
         }
       }

package/pipeline/scripts/phase-tracker.sh

@@ -121,6 +121,9 @@ need_jq() {
 # the Phase 7 / halt emit that reads the real run status. The emitter no-ops
 # unless prefs.global.usageLog.enabled; detached so it never blocks a boundary.
 usage_live_ping() {
+  # Smoke runs exercise this script's state handling, never the live dashboard -
+  # a test gate must not leave phantom "running" rows on the timeline.
+  [ -n "${MULTI_AGENT_SMOKE:-}" ] && return 0
   local task="$1" phase="$2"
   local script="$HOME/.claude/scripts/usage-report.mjs"
   local prefs="$HOME/.claude/multi-agent-preferences.json"