chore: align repo-template-sw to 0.10.0

.engineering/baseline.json

@@ -1,37 +1,22 @@
 {
   "schema_version": 1,
-  "standard": {
-    "source": "daniele21/repo-template-sw",
-    "version": "0.9.2",
-    "revision": "8aa95d10254846e7d63f4bd5c60d61b18d21060c"
-  },
+  "standard": {"source": "daniele21/repo-template-sw", "version": "0.10.0", "revision": "f392e4ded5cd3ec5efbf806934789c6cb9f10ded"},
   "target_level": "L2",
   "profiles": ["python", "typescript", "product-ui"],
   "skills": {
-    "plan-workstream": {"source_version": "0.9.0", "customized": true},
-    "structured-change": {"source_version": "0.9.0", "customized": true},
+    "plan-workstream": {"source_version": "0.10.0", "customized": true},
+    "structured-change": {"source_version": "0.10.0", "customized": true},
     "design-product-experience": {"source_version": "0.5.0", "customized": false},
-    "validate-change": {"source_version": "0.9.0", "customized": true},
-    "preflight-change": {"source_version": "0.9.0", "customized": true},
-    "remote-preflight": {"source_version": "0.9.1", "customized": true},
-    "finalize-workstream": {"source_version": "0.1.0", "customized": false},
+    "validate-change": {"source_version": "0.10.0", "customized": true},
+    "preflight-change": {"source_version": "0.10.0", "customized": true},
+    "remote-preflight": {"source_version": "0.10.0", "customized": true},
+    "finalize-workstream": {"source_version": "0.10.0", "customized": true},
     "review-reference-quality": {"source_version": "0.4.0", "customized": false}
   },
   "documentation": {"completed_workstreams": "delete-by-default", "historical_archive": "exception-only"},
   "adoption": {
-    "development_velocity_0_9_1": {
-      "staged_delivery": "adopted",
-      "risk_to_gate_selection": "adopted",
-      "exact_head_evidence_reuse": "adopted",
-      "post_merge_tree_equivalent_reuse": "adopted-on-dev",
-      "risk_based_ui_evidence": "adopted",
-      "automatic_pr_workflow_consolidation": "adopted"
-    },
-    "development_velocity_0_9_2": {
-      "automated_integration_before_dev": "adopted",
-      "real_environment_integration_blocking": false,
-      "real_environment_release_gate": "adopted",
-      "material_ui_integration_full_media": "adopted"
-    }
+    "development_velocity_0_9_1": {"staged_delivery": "adopted", "risk_to_gate_selection": "adopted", "exact_head_evidence_reuse": "adopted", "post_merge_tree_equivalent_reuse": "adopted-on-dev", "risk_based_ui_evidence": "adopted", "automatic_pr_workflow_consolidation": "adopted"},
+    "development_velocity_0_9_2": {"automated_integration_before_dev": "adopted", "real_environment_integration_blocking": false, "real_environment_release_gate": "adopted", "material_ui_integration_full_media": "adopted"},
+    "development_velocity_0_10_0": {"bounded_agent_reporting": "adopted", "schema2_context_routes": "adopted", "two-failed-repair_diagnostic_pivot": "adopted", "resume_checkpoint": "adopted", "template_revision": "f392e4ded5cd3ec5efbf806934789c6cb9f10ded"}
   }
 }

.engineering/commands.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "contract_version": "0.6.1",
+  "contract_version": "0.7.0",
   "commands": {
     "setup": {"status": "required", "run": "uv python install 3.12 && uv sync --extra dev --locked && corepack enable && corepack install --global pnpm@11.24.0 && pnpm --dir frontend install --frozen-lockfile && pnpm --dir frontend exec playwright install chromium"},
     "doctor": {"status": "recommended", "run": "uv run --extra dev --locked python scripts/doctor.py"},
@@ -15,15 +15,7 @@
     "stop": {"status": "recommended", "run": "Ctrl-C the foreground performance-lab-ui process; release smoke and packaged E2E verify listener cleanup"},
     "clean": {"status": "required", "run": "uv run --extra dev --locked python scripts/clean.py"}
   },
-  "development_velocity": {
-    "default_stage": "iteration",
-    "stages": ["iteration", "integration", "release"],
-    "iteration": {"target_feedback_minutes": 3, "exact_head_required": false, "full_diff_review_required": false, "durable_documentation_current_required": false, "remote_preflight_required": false, "e2e_default": "risk_only"},
-    "integration": {"target_feedback_minutes": 8, "exact_head_required": true, "full_diff_review_required": true, "durable_documentation_current_required": true, "remote_preflight_when_required_gates_unavailable_local": true, "e2e_default": "affected_critical_journeys", "automated_e2e_required_when_affected": true, "real_environment_blocking": false, "real_environment_deferred_to_release": true},
-    "release": {"exact_head_required": true, "full_diff_review_required": true, "durable_documentation_current_required": true, "full_validation_required": true, "e2e_default": "release_critical_journeys", "required_real_environment_blocking": true},
-    "parallel_development_prefers_early_convergence": true,
-    "stacked_publication_exception_only": true
-  },
+  "development_velocity": {"default_stage": "iteration", "stages": ["iteration", "integration", "release"], "iteration": {"target_feedback_minutes": 3, "exact_head_required": false, "full_diff_review_required": false, "durable_documentation_current_required": false, "remote_preflight_required": false, "e2e_default": "risk_only"}, "integration": {"target_feedback_minutes": 8, "exact_head_required": true, "full_diff_review_required": true, "durable_documentation_current_required": true, "remote_preflight_when_required_gates_unavailable_local": true, "e2e_default": "affected_critical_journeys", "automated_e2e_required_when_affected": true, "real_environment_blocking": false, "real_environment_deferred_to_release": true}, "release": {"exact_head_required": true, "full_diff_review_required": true, "durable_documentation_current_required": true, "full_validation_required": true, "e2e_default": "release_critical_journeys", "required_real_environment_blocking": true}, "parallel_development_prefers_early_convergence": true, "stacked_publication_exception_only": true},
   "publication_gate": {"applies_from_stage": "integration", "agent_preflight_required": true, "target_base_freshness_required": true, "full_diff_review_required": true, "material_ambiguity_must_be_resolved": true, "failure_root_cause_required": true, "execution_capability_classification_required": true, "blast_radius_profile_selection_required": true, "automatable_gates_must_not_be_delegated_to_user": true, "remote_automated_fallback_required_when_agent_local_unavailable": true, "deterministic_ci_command_parity_required": true, "non_automated_evidence_must_be_declared": true, "exact_head_evidence_required": true},
   "validation_execution": {"classes": ["agent_local", "remote_automated", "real_environment"], "no_human_runner_for_automatable_gates": true, "remote_automation_required_when_agent_local_unavailable": true},
   "validation_profiles": {"default": "auto", "profiles": ["lean", "scoped", "strong", "full"], "selector": "uv run --extra dev --locked python scripts/select_validation_profile.py --base \"$BASE_SHA\" --head \"$HEAD_SHA\" --stage \"$STAGE\"", "selector_output": "risk_dimensions_and_required_gates", "profiles_are_shorthand": true, "gate_selection_preferred_over_suite_selection": true, "unknown_executable_paths_fail_safe": true, "selector_changes_force_full": true, "promotion_validation_full": true, "automatic_escalation_allowed": true, "silent_downgrade_below_auto_forbidden": true, "report_selected_profile_and_reason": true},
@@ -34,5 +26,6 @@
   "artifact_lifecycle": {"implementation_status": "implemented-by-REL-UI-001", "immutable_successful_artifacts": true, "promote_only_after_success": true, "manifest_required": true, "manifest_name": "build-manifest.json", "checksum_algorithm": "sha256", "local_keep_successful_per_lineage": 2, "ci_store": "github-actions", "ci_retention_days": 7, "release_store": "github-releases", "release_artifacts_immutable": true},
   "build_delta": {"implementation_status": "implemented-by-REL-UI-001", "required": true, "compare_to": "previous-successful-comparable-build", "output": "BUILD_CHANGELOG.md", "bundle_with_artifact": true, "dimensions": ["source", "dependencies", "toolchain", "configuration", "compatibility_migrations", "artifact_metrics", "validation"]},
   "local_runtime": {"applicable": true, "bind_default": "loopback", "port_strategy": "configurable-with-collision-check", "foreground_default": true, "readiness_required": true, "graceful_shutdown_required": true, "verify_no_project_listener_after_stop": true},
-  "ephemeral_resources": {"run_identity": true, "isolated_workspace": true, "cleanup_paths": ["success", "failure", "timeout", "cancellation", "interrupt", "partial-initialization"], "stale_resource_recovery": true, "ownership_required_before_cleanup": true, "post_cleanup_verification": true}
+  "ephemeral_resources": {"run_identity": true, "isolated_workspace": true, "cleanup_paths": ["success", "failure", "timeout", "cancellation", "interrupt", "partial-initialization"], "stale_resource_recovery": true, "ownership_required_before_cleanup": true, "post_cleanup_verification": true},
+  "agent_reporting": {"schema_version": 1, "format": "summary_with_evidence_references", "required_summary_fields": ["stage", "source_identity", "risks", "profile", "required_gates", "evidence", "remaining_gaps", "next_action"], "gate_fields": ["id", "reason", "executor", "status"], "source_identity_fields": ["head", "source_tree", "target_base", "dirty"], "bounded_output": true, "full_report_on_demand": true, "preserve_failed_pending_gates": true, "summary_is_not_evidence_verification": true}
 }

.engineering/documentation-policy.json

@@ -1,22 +1,18 @@
 {
-  "schema_version": 1,
+  "schema_version": 2,
   "estimated_token_characters": 4,
-  "budgets": {
-    "root_agents": {"max_lines": 180, "max_estimated_tokens": 2500},
-    "scoped_agents": {"max_lines": 150, "max_estimated_tokens": 2000},
-    "current_state": {"max_lines": 120, "max_estimated_tokens": 1500},
-    "active_workstream": {"max_lines": 220, "max_estimated_tokens": 3000},
-    "architecture": {"max_lines": 400, "max_estimated_tokens": 5500},
-    "feature_doc": {"max_lines": 400, "max_estimated_tokens": 5500}
-  },
-  "context_targets": {
-    "bootstrap_max_estimated_tokens": 2500,
-    "root_scoped_workstream_max_estimated_tokens": 6000
-  },
+  "budgets": {"root_agents": {"max_lines": 120, "max_estimated_tokens": 1200}, "scoped_agents": {"max_lines": 150, "max_estimated_tokens": 2000}, "current_state": {"max_lines": 120, "max_estimated_tokens": 1500}, "active_workstream": {"max_lines": 220, "max_estimated_tokens": 3000}, "architecture": {"max_lines": 400, "max_estimated_tokens": 5500}, "feature_doc": {"max_lines": 400, "max_estimated_tokens": 5500}},
+  "context_targets": {"bootstrap_max_estimated_tokens": 1200, "root_scoped_workstream_max_estimated_tokens": 6000},
   "duplicate_min_characters": 240,
-  "completed_workstream_markers": [
-    "Status: complete",
-    "Status: completed",
-    "Status: done"
-  ]
+  "completed_workstream_markers": ["Status: complete", "Status: completed", "Status: done"],
+  "context_exclude_directories": [".git", "node_modules", ".venv", "venv", ".gradle", ".build", "build", "dist", "frontend/node_modules", "__pycache__"],
+  "context_routes": {
+    "docs": {"read_when": "Pure documentation/copy without executable or policy changes.", "files": ["AGENTS.md", "docs/README.md"], "include_scoped_guides": true, "include_workstream": false, "max_estimated_tokens": 5000},
+    "bug": {"read_when": "Meaningful owner-local bug during iteration.", "files": ["AGENTS.md", ".engineering/commands.json", "skills/structured-change/SKILL.md", "skills/validate-change/SKILL.md"], "include_scoped_guides": true, "include_workstream": false, "max_estimated_tokens": 7000},
+    "contract": {"read_when": "Shared comparability/evidence/API/storage boundary change.", "files": ["AGENTS.md", ".engineering/commands.json", "skills/structured-change/SKILL.md", "skills/validate-change/SKILL.md", "docs/architecture.md"], "include_scoped_guides": true, "include_workstream": false, "max_estimated_tokens": 10000},
+    "ui": {"read_when": "Material Performance Lab product-UI iteration. This route owns UX/design context; compose with bug for behavior and commands, add brand-kit for visual identity, and use integration when preparing E2E evidence.", "files": ["AGENTS.md", "skills/design-product-experience/SKILL.md", "design/ux-contract.json"], "include_scoped_guides": true, "include_workstream": false, "max_estimated_tokens": 12000, "requires_profile": "product-ui"},
+    "integration": {"read_when": "Candidate readiness including repository-owned automatic validation.", "files": ["AGENTS.md", ".engineering/commands.json", "skills/preflight-change/SKILL.md", ".engineering/e2e.json", "skills/remote-preflight/SKILL.md", "docs/README.md"], "include_scoped_guides": true, "include_workstream": false, "max_estimated_tokens": 10000},
+    "release": {"read_when": "Release readiness including RUNTIME-1 evidence owners.", "files": ["AGENTS.md", ".engineering/commands.json", "skills/preflight-change/SKILL.md", ".engineering/e2e.json", "skills/remote-preflight/SKILL.md", "docs/README.md"], "include_scoped_guides": true, "include_workstream": false, "max_estimated_tokens": 10000},
+    "resume": {"read_when": "Resume a multi-session bug/implementation/evidence workstream.", "files": ["AGENTS.md", ".engineering/commands.json", "skills/structured-change/SKILL.md", "skills/validate-change/SKILL.md"], "include_scoped_guides": true, "include_workstream": true, "max_estimated_tokens": 9500}
+  }
 }