Release: promote measured ClosedRoom candidate

.engineering/baseline.json

@@ -1,29 +1,21 @@
 {
   "schema_version": 1,
-  "standard": {
-    "source": "daniele21/repo-template-sw",
-    "version": "0.8.0"
-  },
+  "standard": {"source": "daniele21/repo-template-sw", "version": "0.10.0", "revision": "f392e4ded5cd3ec5efbf806934789c6cb9f10ded"},
   "target_level": "L2",
-  "profiles": [
-    "python",
-    "typescript",
-    "macos",
-    "local-ai",
-    "product-ui"
-  ],
+  "profiles": ["python", "typescript", "macos", "local-ai", "product-ui"],
   "skills": {
-    "plan-workstream": {"source_version": "0.1.0", "customized": false},
-    "structured-change": {"source_version": "0.6.0", "customized": false},
+    "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.8.0", "customized": false},
-    "preflight-change": {"source_version": "0.8.0", "customized": false},
-    "remote-preflight": {"source_version": "0.2.0", "customized": false},
-    "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"
+  "documentation": {"completed_workstreams": "delete-by-default", "historical_archive": "exception-only"},
+  "adoption": {
+    "development_velocity_0_9_2": {"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", "affected_automated_e2e_before_dev": "adopted", "integration_real_environment_deferred_to_release": "adopted", "release_real_environment_blocking": "adopted", "target_mac_real_environment_boundary": "preserved"},
+    "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,119 +1,39 @@
 {
   "schema_version": 1,
-  "contract_version": "0.5.0",
+  "contract_version": "0.7.0",
   "commands": {
     "setup": {"status": "required", "run": "./setup.sh && (cd frontend && pnpm install --frozen-lockfile)"},
     "doctor": {"status": "recommended", "run": "UV_CACHE_DIR=.cache/uv uv run local-asr doctor"},
     "dev": {"status": "recommended", "run": "./run.sh"},
-    "check": {"status": "required", "run": "python3 scripts/verify_repository.py && python3 scripts/verify_operations.py && python3 scripts/verify_e2e.py && python3 scripts/verify_product_experience.py && python3 scripts/verify_docs.py && python3 scripts/verify_agent_context.py && python3 -m unittest test.test_validation_profile_selector test.test_build_artifact_metadata -v && (cd frontend && pnpm run lint && pnpm exec tsc --noEmit)"},
+    "check": {"status": "required", "run": "python3 scripts/verify_repository.py && python3 scripts/verify_operations.py && python3 scripts/verify_e2e.py && python3 scripts/verify_stage_environment_policy.py && python3 scripts/verify_product_experience.py && python3 scripts/verify_docs.py && python3 scripts/verify_agent_context.py && python3 -m unittest test.test_validation_profile_selector test.test_build_artifact_metadata -v && (cd frontend && pnpm run lint && pnpm exec tsc --noEmit)"},
     "test": {"status": "required", "run": "UV_CACHE_DIR=.cache/uv uv run python -m unittest discover -s test -v"},
     "e2e": {"status": "recommended", "run": "UV_CACHE_DIR=.cache/uv uv run python -m unittest test.test_frontend_transcription_workflow test.test_recording_api test.test_native_capture -v"},
     "build": {"status": "required", "run": "bash scripts/build_artifact.sh --no-dmg"},
     "smoke": {"status": "recommended", "run": "python3 scripts/smoke_packaged_app.py"},
     "package": {"status": "optional", "run": "bash scripts/build_artifact.sh --dmg"},
-    "stop": {"status": "n/a", "run": ""},
+    "local_real_environment": {"status": "recommended", "run": "python3 scripts/run_local_real_environment_suite.py"},
+    "release_build": {"status": "required", "run": "python3 scripts/build_production_artifact.py"},
+    "release_evidence": {"status": "required", "run": "python3 scripts/measured_release_target_mac.py --app <exact-production-app> && python3 scripts/record_while_ai_busy_target_mac.py --app <exact-production-app>"},
+    "stop": {"status": "n/a", "run": "n/a"},
     "clean": {"status": "required", "run": "python3 scripts/clean_build_state.py"}
   },
-  "publication_gate": {
-    "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": "python3 scripts/select_validation_profile.py --base <base-revision> --head <head-revision>",
-    "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
-  },
-  "remote_preflight": {
-    "status": "required",
-    "trigger": ".github/workflows/preflight.yml on pull_request; checks out and validates the exact PR head SHA with read-only contents permission",
-    "default_profile": "auto",
-    "stronger_profile_override_allowed": true,
-    "weaker_profile_override_requires_explicit_justification": true,
-    "exact_head_required": true,
-    "trusted_requesters_only": true,
-    "same_repository_prs_only_by_default": true,
-    "execution_job_write_credentials": false,
-    "report_result_to_pr": true
-  },
-  "end_to_end": {
-    "recommended_when_full_workflow_boundary_exists": true,
-    "critical_journeys_prioritized": true,
-    "lower_level_tests_remain_primary": true,
-    "use_stack_native_tooling": true,
-    "run_against_built_artifact_when_material": true,
-    "failure_evidence_bounded": true,
-    "zero_residue_required": true
-  },
-  "build_identity": {
-    "unique_per_build": true,
-    "source_revision_required": true,
-    "dirty_state_required": true,
-    "lineage_fields": ["project", "platform", "architecture", "channel", "variant"],
-    "artifact_name_fields": ["product", "product_version", "build_id", "source_revision"]
-  },
-  "artifact_lifecycle": {
-    "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-or-equivalent",
-    "ci_retention_days": 7,
-    "release_store": "github-releases-or-equivalent",
-    "release_artifacts_immutable": true
-  },
-  "build_delta": {
-    "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
-  }
+  "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": "python3 scripts/select_validation_profile.py --base <base-revision> --head <head-revision> --stage <iteration|integration|release>", "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},
+  "remote_preflight": {"status": "required", "trigger": ".github/workflows/preflight.yml validates pull requests and integrated pushes using exact-head or safe tree-equivalent evidence", "default_profile": "auto", "stronger_profile_override_allowed": true, "weaker_profile_override_requires_explicit_justification": true, "exact_head_required": true, "reuse_successful_equivalent_evidence": true, "rerun_only_when_missing_stale_or_insufficient": true, "evidence_identity_fields": ["head", "source_tree", "target_base", "required_gates", "profile", "e2e_environment"], "post_merge_tree_equivalent_reuse_allowed": true, "post_merge_tree_reuse_requires_same_target_base": true, "direct_push_without_equivalent_evidence_must_validate": true, "trusted_requesters_only": true, "same_repository_prs_only_by_default": true, "execution_job_write_credentials": false, "report_result_to_pr": true},
+  "end_to_end": {"recommended_when_full_workflow_boundary_exists": true, "critical_journeys_prioritized": true, "lower_level_tests_remain_primary": true, "use_stack_native_tooling": true, "run_against_built_artifact_when_material": true, "failure_evidence_bounded": true, "zero_residue_required": true, "ui_evidence_modes": ["assertions", "screenshots", "full_media"], "ui_evidence_selection": "risk_based", "incidental_ui_does_not_force_full_media": true, "full_media_for_motion_timing_sequence_or_release_claims": true},
+  "validation_economics": {"status": "recommended", "optimize_for": "sufficient-confidence-per-feedback-time", "dimensions": ["duration", "flake_rate", "unique_regression_signal", "overlap"], "periodic_review": true},
+  "build_identity": {"unique_per_build": true, "source_revision_required": true, "dirty_state_required": true, "lineage_fields": ["project", "platform", "architecture", "channel", "variant"], "artifact_name_fields": ["product", "product_version", "build_id", "source_revision"]},
+  "artifact_lifecycle": {"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-or-equivalent", "ci_retention_days": 7, "release_store": "github-releases-or-equivalent", "release_artifacts_immutable": true},
+  "build_delta": {"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},
+  "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": 1000, "max_estimated_tokens": 12000},
-    "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": 1000, "max_estimated_tokens": 12000}, "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 API/persistence/runtime/native-audio boundary change; add docs/architecture.md only when system ownership/topology itself is material.", "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": 10000},
+    "ui": {"read_when": "Material ClosedRoom frontend/WKWebView UI iteration; add brand-kit for visual identity and use the integration route when preparing E2E evidence.", "files": ["AGENTS.md", ".engineering/commands.json", "skills/structured-change/SKILL.md", "skills/validate-change/SKILL.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 remote deterministic preflight.", "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 target-Mac evidence.", "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 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}
+  }
 }