@tiic-tech/openworkflow 0.1.1 → 0.1.2

package/dist/core/src/artifacts/registry.js

@@ -87,6 +87,12 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
         },
         evidencePolicy: "Reference human notes when intent needs explanation; do not embed long brainstorming transcript.",
         handoffKey: "handoff.next_command",
+        summaryPolicy: {
+            strategy: "current_slice",
+            path: "vision_delta",
+            loadBeforeFull: true,
+            refreshWhen: "Update the current slice when stable_answers or unresolved_questions change.",
+        },
         template: {
             schema_version: "0.1.0",
             contract_id: "vision:<id>",
@@ -99,14 +105,78 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
             unresolved_questions: [],
             vision_delta: {
                 one_sentence: "",
+                problem: "",
                 goals: [],
                 non_goals: [],
                 users: [],
                 quality_bar: [],
+                ai_native_role: "",
+                success_signals: [],
+                failure_signals: [],
+            },
+            strategic_core: {
+                target_user: "",
+                context: "",
+                current_alternative: "",
+                pain: "",
+                desired_behavior_change: "",
+                core_mechanism: "",
+                core_differentiator: "",
+                strongest_success_signal: "",
+                failure_signals: [],
+            },
+            product_system_seed: {
+                product_thesis: "",
+                primary_loop: [],
+                interaction_model: "",
+                feature_system: [],
+                emotional_value: "",
+                functional_value: "",
+                trust_boundary: "",
+                privacy_boundary: "",
+                anti_goals: [],
+                future_opportunities: [],
+            },
+            proto_readiness: {
+                status: "missing",
+                missing_for_proto: [],
+                prototype_direction_seeds: [],
+                prompt_constraints: [],
+                validation_target: "",
+                downstream_notes: [],
+            },
+            coverage: {
+                target_user: {
+                    status: "missing",
+                    evidence: [],
+                    follow_up_question: "",
+                },
+                differentiator: {
+                    status: "missing",
+                    evidence: [],
+                    follow_up_question: "",
+                },
+                success_signal: {
+                    status: "missing",
+                    evidence: [],
+                    follow_up_question: "",
+                },
+                trust_boundary: {
+                    status: "missing",
+                    evidence: [],
+                    follow_up_question: "",
+                },
+                proto_readiness: {
+                    status: "missing",
+                    evidence: [],
+                    follow_up_question: "",
+                },
             },
             handoff: {
                 ready: false,
                 next_command: null,
+                blockers: [],
+                readiness_notes: [],
             },
             updated_at: null,
         },
@@ -125,12 +195,21 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
         disclosureLevel: 2,
         requiredKeys: [
             "artifact_type",
+            "trigger",
             "core_question",
+            "central_uncertainty",
+            "hypothesis",
+            "target_behavior",
             "feature_classification",
             "critical_assumptions",
             "prototype_scope",
+            "prototype_experiment",
+            "observable_signals",
             "acceptance",
+            "decision_rules",
             "decision_options",
+            "vision_gaps",
+            "agent_readiness_gate",
         ],
         readPolicy: {
             loadByDefault: true,
@@ -146,8 +225,14 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
             idKey: "validation_id",
             pathKey: "path",
         },
-        evidencePolicy: "Rank features and assumptions in YAML; keep rationale compact and defer examples to NOTE.md.",
+        evidencePolicy: "Compile one prototype validation target in YAML; keep rationale compact and defer examples to NOTE.md.",
         handoffKey: "prototype_scope",
+        summaryPolicy: {
+            strategy: "current_slice",
+            path: "core_question + central_uncertainty + target_behavior + prototype_experiment + observable_signals + decision_rules + agent_readiness_gate",
+            loadBeforeFull: true,
+            refreshWhen: "Update the current slice when the experiment target, evidence signals, decision rules, or readiness gate changes.",
+        },
         template: {
             schema_version: "0.1.0",
             contract_id: "validation:<id>",
@@ -155,7 +240,15 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
             artifact_type: "validation_target",
             title: "<short validation target title>",
             status: "draft",
+            trigger: {
+                mode: "user_explicit",
+                requested_command: "/ow:validation",
+                reason: "user_invoked_validation",
+            },
             core_question: "",
+            central_uncertainty: "",
+            hypothesis: "",
+            target_behavior: "",
             feature_classification: {
                 existential: [],
                 supporting: [],
@@ -167,8 +260,32 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
                 include: [],
                 exclude: [],
             },
+            prototype_experiment: {
+                scenario: "",
+                must_show: [],
+                must_not_show: [],
+            },
+            observable_signals: {
+                pass: [],
+                fail: [],
+                ambiguous: [],
+            },
             acceptance: [],
+            decision_rules: {
+                continue: [],
+                revise: [],
+                pivot: [],
+                stop: [],
+                needs_more_evidence: [],
+            },
             decision_options: ["continue", "revise", "pivot", "stop", "needs_more_evidence"],
+            vision_gaps: [],
+            agent_readiness_gate: {
+                status: "thin_validation",
+                blockers: [],
+                warnings: [],
+                write_authority: "/ow:validation",
+            },
             updated_at: null,
         },
     },
@@ -182,25 +299,31 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
         indexPath: ".openworkflow/prototypes/PROTOTYPE_INDEX.yaml",
         indexCollectionKey: "prototypes",
         notePath: ".openworkflow/prototypes/<id>/NOTE.md",
-        reviewPath: ".openworkflow/prototypes/<id>/review.html",
+        reviewPath: null,
         disclosureLevel: 2,
         requiredKeys: [
             "artifact_type",
             "validation_target",
             "core_question",
             "prototype_mode",
-            "reference_analysis",
-            "visual_direction",
-            "visual_concept_policy",
-            "concept_evidence",
-            "prototype_artifact",
-            "run",
-            "implementation_evidence",
-            "observations",
-            "evidence",
-            "verification",
-            "self_critique",
-            "known_limits",
+            "prompt_pack_type",
+            "validation_input",
+            "source",
+            "internal_pipeline",
+            "preflight_quality_gate",
+            "direction_count_policy",
+            "normalized_input",
+            "strategic_core",
+            "product_experience_model",
+            "prototype_system_contract",
+            "prototype_reality_gate",
+            "directions",
+            "build_recommendation",
+            "prompt_text_manifest",
+            "post_validate",
+            "image_generation",
+            "negative_constraints",
+            "review_plan",
             "result",
             "handoff",
         ],
@@ -218,8 +341,14 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
             idKey: "prototype_id",
             pathKey: "path",
         },
-        evidencePolicy: "Reference visual concepts, reference analyses, runnable artifacts, screenshots, logs, critique, and URLs by path; keep concept evidence distinct from implementation evidence and do not paste bulky evidence into YAML.",
+        evidencePolicy: "Reference strategic prompt packs, refined prompt packs, generated images, review notes, and decision evidence by path; keep image binaries out of YAML and do not turn prompt packs into production tasks.",
         handoffKey: "handoff.next_command",
+        summaryPolicy: {
+            strategy: "summary_file",
+            path: ".openworkflow/prototypes/<id>/SUMMARY.yaml",
+            loadBeforeFull: true,
+            refreshWhen: "Refresh after prompt pack, review evidence, result, or handoff changes.",
+        },
         template: {
             schema_version: "0.1.0",
             contract_id: "prototype:<id>",
@@ -227,59 +356,293 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
             artifact_type: "prototype_evidence",
             title: "<short prototype evidence title>",
             status: "draft",
-            validation_target: "validation:<id>",
+            validation_target: null,
             core_question: "",
-            prototype_mode: "visual|interaction|technical_feasibility|3d_material|workflow|data_logic",
-            reference_analysis: [],
-            visual_direction: {
-                source: null,
-                summary: "",
-                tokens: {
-                    background: "",
-                    surface: "",
-                    foreground: "",
-                    muted: "",
-                    border: "",
-                    accent: "",
-                    display_font: "",
-                    body_font: "",
-                    radius: "",
-                    spacing: "",
-                    motion: "",
-                    density: "",
+            prototype_mode: "image_prompt_pack",
+            prompt_pack_type: "strategic_proto_prompt_pack",
+            validation_input: {
+                mode: "validation_present|agent_auto_generated",
+                refs: [],
+                notes: [],
+            },
+            source: {
+                refs: [],
+                target_tool: "image_generation",
+                output_language: "",
+            },
+            internal_pipeline: {
+                orchestrator_command: "/ow:proto",
+                user_visible_command: "/ow:proto",
+                current_stage: "proto-preflight",
+                stages: [
+                    {
+                        stage_id: "proto-preflight",
+                        command: "/ow:proto",
+                        visibility: "user",
+                        status: "pending",
+                        outputs: [],
+                    },
+                    {
+                        stage_id: "vision2prompt",
+                        command: "/ow:vision2prompt",
+                        visibility: "internal",
+                        status: "pending",
+                        outputs: [],
+                    },
+                    {
+                        stage_id: "prompt2proto",
+                        command: "/ow:prompt2proto",
+                        visibility: "internal",
+                        status: "pending",
+                        outputs: [],
+                    },
+                ],
+            },
+            preflight_quality_gate: {
+                vision_status: "missing|thin|ready",
+                validation_status: "missing|thin|ready",
+                can_proceed: false,
+                blockers: [],
+                next_command_when_blocked: "/ow:vision",
+                required_followup_questions: [],
+            },
+            direction_count_policy: {
+                requested_count: null,
+                resolved_count: 3,
+                source: "user_input|agent_default_after_user_delegation",
+                ask_user_question_required: true,
+                ask_user_question: "How many strategically different prototype directions should /ow:proto generate?",
+            },
+            normalized_input: {
+                product_domain: "",
+                primary_user: "",
+                usage_context: "",
+                current_alternative: "",
+                core_pain: "",
+                desired_behavior_change: "",
+                strongest_success_signal: "",
+                core_differentiator: "",
+                emotional_value: "",
+                functional_value: "",
+                trust_requirements: [],
+                privacy_requirements: [],
+                non_goals: [],
+                future_opportunities: [],
+                validation_target: "",
+            },
+            strategic_core: {
+                target_user: "",
+                behavior_change: "",
+                mechanism: "",
+                differentiator: "",
+                boundary_conditions: [],
+                central_uncertainty: "",
+            },
+            product_experience_model: {
+                product_archetype: "",
+                primary_canvas: "",
+                information_architecture: [],
+                domain_object_model: [],
+                primary_task_loop: [],
+                interaction_state_model: [],
+                data_realism_requirements: [],
+                visual_language: [],
+                anti_generic_constraints: [],
+                category_quality_bar: [],
+            },
+            prototype_system_contract: {
+                stable_app_shell: [],
+                navigation_taxonomy: [],
+                data_vocabulary: [],
+                domain_object_anatomy: [],
+                object_detail_anatomy: [],
+                action_bar_contract: [],
+                audit_trust_pattern: [],
+                copy_tone: "",
+                allowed_screen_deltas: [],
+            },
+            prototype_reality_gate: {
+                status: "pending",
+                trigger: "before_image_generation",
+                required_when_prompt_text_ready: true,
+                dimensions: [
+                    "product_category_fit",
+                    "primary_canvas_fit",
+                    "domain_object_realism",
+                    "task_loop_completeness",
+                    "interaction_state_coverage",
+                    "data_realism",
+                    "anti_generic_constraints",
+                ],
+                failures: [],
+                outcome_notes: [],
+                repair_route: "/ow:vision2prompt",
+            },
+            directions: [
+                {
+                    direction_id: "",
+                    name: "",
+                    strategic_hypothesis: "",
+                    validates: "",
+                    main_risk: "",
+                    distinctness_rationale: "",
+                    prototype_prompt: "",
+                    screen_prompts: [],
+                    pm_judgment: "",
                 },
+            ],
+            build_recommendation: {
+                first_direction_id: "",
+                why_first: "",
+                success_signals: [],
+                failure_signals: [],
+                next_test_if_it_works: "",
             },
-            visual_concept_policy: {
-                image_generation: "generated|skipped_by_user|not_applicable",
-                skip_reason: null,
+            tune_input: {
+                baseline_source_type: "images|prompt_pack|screen_descriptions|mixed",
+                baseline_refs: [],
+                tune_request: "",
+                target_form_factor: "",
+                regeneration_scope: "all_screens|selected_screens|one_screen|new_screens_only|design_system_pass",
+                target_screen_count: null,
+                locked_screens: [],
+                locked_elements: [],
+                constraints: [],
             },
-            concept_evidence: [],
-            prototype_artifact: {
-                path: "",
-                type: "",
+            baseline_resolution: {
+                latest_approved_baseline_group_id: "",
+                latest_approved_baseline_ref: "",
+                baseline_lineage: [],
+                resolution_rule: "Use the latest approved prototype group or refined prompt pack unless the user explicitly selects an older baseline.",
+                stale_source_guard: "Do not silently revert to an earlier source screen group during repeated tune passes.",
             },
-            run: {
-                command: "",
-                url: null,
+            carry_forward: {
+                locked_screens: [],
+                locked_elements: [],
+                preserved_improvements: [],
+                explicit_unlocks: [],
+                cumulative_drift_guard: "Carry forward accepted improvements and locked elements unless the tune request explicitly unlocks or removes them.",
+            },
+            baseline_audit: [
+                {
+                    source_screen_id: "",
+                    screen_name: "",
+                    journey_stage: "",
+                    user_goal: "",
+                    system_state: "",
+                    components: [],
+                    copy_tone: "",
+                    represented_feature: "",
+                    ai_or_system_behavior: "",
+                    trust_controls: [],
+                    visual_cues: [],
+                    must_preserve: [],
+                    transform_or_remove: [],
+                    assumptions: [],
+                },
+            ],
+            product_system: {
+                product_thesis: "",
+                target_user: "",
+                primary_loop: "",
+                brand_promise: "",
+                interaction_model: "",
+                information_architecture: [],
+                design_language: [],
+                component_vocabulary: [],
+                copywriting_style: "",
+                feature_system: [],
+                trust_and_boundary_system: [],
+                anti_goals: [],
+                stable_constants: [],
+                adaptable_variables: [],
             },
-            implementation_evidence: [],
+            delta_rules: {
+                must_inherit: [],
+                must_add: [],
+                must_remove: [],
+                flexible_change: [],
+            },
+            screen_delta_matrix: [
+                {
+                    target_screen_id: "",
+                    source_screen_ids: [],
+                    preserve: [],
+                    add: [],
+                    remove: [],
+                    transform: [],
+                    flexible: [],
+                    acceptance_criteria: [],
+                },
+            ],
+            screen_manifest: [
+                {
+                    target_screen_id: "",
+                    source_screen_ids: [],
+                    screen_name: "",
+                    target_form_factor: "",
+                    generation_scope: "",
+                    dependencies: [],
+                },
+            ],
+            global_design_prompt: "",
+            screen_prompts: [
+                {
+                    prompt_id: "",
+                    target_screen_id: "",
+                    source_screen_ids: [],
+                    screen_name: "",
+                    image_role: "",
+                    prompt: "",
+                    negative_prompt: "",
+                    acceptance_criteria: [],
+                },
+            ],
+            generation_order: [],
+            acceptance_checklist: [],
+            prompt_text_manifest: {
+                status: "draft",
+                directions_ready: false,
+                direction_count: 0,
+                prompt_text_refs: [],
+            },
+            post_validate: {
+                status: "pending",
+                trigger: "after_prompt_assets_ready",
+                required_when_direction_count_gte: 2,
+                skip_when_resolved_count: 1,
+                threshold_policy: {
+                    method: "strategic_fingerprint_similarity",
+                    max_pairwise_similarity: 0.65,
+                    comparison: "pairwise",
+                },
+                fingerprint_dimensions: [
+                    "product_form",
+                    "trigger",
+                    "interaction_model",
+                    "emotional_driver",
+                    "retention_mechanism",
+                    "metric",
+                    "main_risk",
+                    "trust_model",
+                    "privacy_model",
+                ],
+                comparisons: [],
+                failures: [],
+                outcome_notes: [],
+                repair_route: "/ow:vision2prompt",
+            },
+            image_generation: {
+                status: "not_started",
+                batch_strategy: "Generate each selected direction as a coherent multi-image screen group after prompt_text_manifest.status is ready_for_image_generation.",
+                generated_images: [],
+                collection_notes: [],
+            },
+            negative_constraints: [],
+            review_plan: {},
             observations: [],
             evidence: [],
-            verification: {
-                browser_checks: [],
-                screenshots: [],
-                logs: [],
-            },
-            self_critique: {
-                philosophy: "",
-                hierarchy: "",
-                execution: "",
-                specificity: "",
-                restraint: "",
-                accessibility: "",
-                responsive_behavior: "",
-                repairs: [],
-            },
+            generated_images: [],
             known_limits: [],
             result: "not_reviewed",
             handoff: {
@@ -327,6 +690,12 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
         },
         evidencePolicy: "Reference reviewed evidence and user feedback; summarize rationale without copying full review transcripts.",
         handoffKey: "next_command",
+        summaryPolicy: {
+            strategy: "current_slice",
+            path: "outcome + rationale + next_command + follow_up_questions",
+            loadBeforeFull: true,
+            refreshWhen: "Update whenever the decision outcome or next command changes.",
+        },
         template: {
             schema_version: "0.1.0",
             contract_id: "decision:<id>",
@@ -388,6 +757,12 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
         },
         evidencePolicy: "Reference accepted prototype evidence and decision records by path; keep product design decisions in PRODUCT_DESIGN.yaml.",
         handoffKey: "spec_readiness.next_command",
+        summaryPolicy: {
+            strategy: "summary_file",
+            path: ".openworkflow/design/<id>/SUMMARY.yaml",
+            loadBeforeFull: true,
+            refreshWhen: "Refresh after product design scope, open questions, or spec readiness changes.",
+        },
         conditionalPackets: [
             {
                 artifactType: "tech_spec",
@@ -467,6 +842,258 @@ export const DISCOVERY_ARTIFACT_CONTRACTS = [
             updated_at: null,
         },
     },
+    {
+        artifactType: "production_spec",
+        contractType: "spec",
+        command: "/ow:spec",
+        title: "Production spec",
+        sourceOfTruthPath: ".openworkflow/specs/<id>/SPEC.yaml",
+        templatePath: ".openworkflow/specs/_templates/SPEC.yaml",
+        indexPath: ".openworkflow/specs/SPEC_INDEX.yaml",
+        indexCollectionKey: "specs",
+        notePath: ".openworkflow/specs/<id>/NOTE.md",
+        reviewPath: null,
+        disclosureLevel: 2,
+        requiredKeys: [
+            "artifact_type",
+            "source_design",
+            "goal",
+            "scope",
+            "requirements",
+            "interfaces",
+            "acceptance",
+            "verification",
+            "risks",
+            "change_readiness",
+        ],
+        readPolicy: {
+            loadByDefault: true,
+            agentReadOrder: 70,
+            maxYamlLines: 220,
+            maxNoteLines: 60,
+            rawEvidence: "only_when_referenced",
+        },
+        activePointer: {
+            indexPath: ".openworkflow/specs/SPEC_INDEX.yaml",
+            pointerKey: "current_spec",
+            collectionKey: "specs",
+            idKey: "spec_id",
+            pathKey: "path",
+        },
+        evidencePolicy: "Reference product design and conditional design packets by path; keep implementation requirements concrete and bounded.",
+        handoffKey: "change_readiness.next_command",
+        summaryPolicy: {
+            strategy: "summary_file",
+            path: ".openworkflow/specs/<id>/SUMMARY.yaml",
+            loadBeforeFull: true,
+            refreshWhen: "Refresh after scope, interfaces, acceptance, verification, risks, or change readiness changes.",
+        },
+        template: {
+            schema_version: "0.1.0",
+            contract_id: "spec:<id>",
+            contract_type: "spec",
+            artifact_type: "production_spec",
+            title: "<short production spec title>",
+            status: "draft",
+            source_design: "",
+            goal: "",
+            scope: {
+                in: [],
+                out: [],
+            },
+            requirements: {
+                user_facing: [],
+                functional: [],
+                non_functional: [],
+            },
+            interfaces: {
+                ui: [],
+                api: [],
+                data: [],
+                integrations: [],
+            },
+            acceptance: [],
+            verification: {
+                commands: [],
+                manual_checks: [],
+            },
+            risks: [],
+            change_readiness: {
+                ready: false,
+                blockers: [],
+                next_command: null,
+            },
+            updated_at: null,
+        },
+    },
+    {
+        artifactType: "production_change",
+        contractType: "change",
+        command: "/ow:change",
+        title: "Production change",
+        sourceOfTruthPath: ".openworkflow/changes/<id>/CHANGE.yaml",
+        templatePath: ".openworkflow/changes/_templates/CHANGE.yaml",
+        indexPath: ".openworkflow/changes/CHANGE_INDEX.yaml",
+        indexCollectionKey: "changes",
+        notePath: ".openworkflow/changes/<id>/NOTE.md",
+        reviewPath: null,
+        disclosureLevel: 2,
+        requiredKeys: [
+            "artifact_type",
+            "source_spec",
+            "problem",
+            "goals",
+            "non_goals",
+            "affected_paths",
+            "acceptance",
+            "validation",
+            "work_items",
+            "risks",
+            "runtime_readiness",
+        ],
+        readPolicy: {
+            loadByDefault: true,
+            agentReadOrder: 80,
+            maxYamlLines: 220,
+            maxNoteLines: 60,
+            rawEvidence: "only_when_referenced",
+        },
+        activePointer: {
+            indexPath: ".openworkflow/changes/CHANGE_INDEX.yaml",
+            pointerKey: "current_change",
+            collectionKey: "changes",
+            idKey: "change_id",
+            pathKey: "path",
+        },
+        evidencePolicy: "Reference the source spec and repo inspection notes; keep implementation planning traceable and scoped.",
+        handoffKey: "runtime_readiness.next_command",
+        summaryPolicy: {
+            strategy: "summary_file",
+            path: ".openworkflow/changes/<id>/SUMMARY.yaml",
+            loadBeforeFull: true,
+            refreshWhen: "Refresh after affected paths, work items, validation, risks, or runtime readiness changes.",
+        },
+        conditionalPackets: [
+            {
+                artifactType: "work_items",
+                path: ".openworkflow/changes/<id>/WORK_ITEMS.yaml",
+                requiredByDefault: true,
+                when: "Use for ordered implementation tasks with owned paths, dependencies, acceptance, and verification.",
+            },
+        ],
+        template: {
+            schema_version: "0.1.0",
+            contract_id: "change:<id>",
+            contract_type: "change",
+            artifact_type: "production_change",
+            title: "<short production change title>",
+            status: "draft",
+            source_spec: "",
+            problem: "",
+            goals: [],
+            non_goals: [],
+            affected_paths: [],
+            acceptance: [],
+            validation: [],
+            work_items: {
+                path: ".openworkflow/changes/<id>/WORK_ITEMS.yaml",
+                summary: [],
+            },
+            risks: [],
+            runtime_readiness: {
+                ready: false,
+                blockers: [],
+                next_command: null,
+            },
+            updated_at: null,
+        },
+    },
+    {
+        artifactType: "team_runtime",
+        contractType: "runtime",
+        command: "/ow:team",
+        title: "Team runtime",
+        sourceOfTruthPath: ".openworkflow/runtime/<id>/STATE.yaml",
+        templatePath: ".openworkflow/runtime/_templates/STATE.yaml",
+        indexPath: ".openworkflow/runtime/RUNTIME_INDEX.yaml",
+        indexCollectionKey: "runs",
+        notePath: ".openworkflow/runtime/<id>/NOTE.md",
+        reviewPath: null,
+        disclosureLevel: 2,
+        requiredKeys: [
+            "artifact_type",
+            "source_change",
+            "active_work_item",
+            "execution_mode",
+            "work_queue",
+            "agents",
+            "verification",
+            "issues",
+            "checkpoints",
+            "handoff",
+        ],
+        readPolicy: {
+            loadByDefault: true,
+            agentReadOrder: 90,
+            maxYamlLines: 220,
+            maxNoteLines: 80,
+            rawEvidence: "only_when_referenced",
+        },
+        activePointer: {
+            indexPath: ".openworkflow/runtime/RUNTIME_INDEX.yaml",
+            pointerKey: "current_run",
+            collectionKey: "runs",
+            idKey: "run_id",
+            pathKey: "path",
+        },
+        evidencePolicy: "Reference change, work items, verification logs, issues, and checkpoints by path; keep current execution state compact.",
+        handoffKey: "handoff.next_action",
+        summaryPolicy: {
+            strategy: "summary_file",
+            path: ".openworkflow/runtime/<id>/SUMMARY.yaml",
+            loadBeforeFull: true,
+            refreshWhen: "Refresh after active work item, verification, issues, checkpoints, or handoff changes.",
+        },
+        conditionalPackets: [
+            {
+                artifactType: "runtime_issues",
+                path: ".openworkflow/runtime/<id>/ISSUES.yaml",
+                requiredByDefault: false,
+                when: "Use when implementation or verification finds blockers, regressions, or follow-up issues.",
+            },
+            {
+                artifactType: "runtime_checkpoints",
+                path: ".openworkflow/runtime/<id>/CHECKPOINTS.yaml",
+                requiredByDefault: false,
+                when: "Use when recording commits, verification gates, QA checkpoints, or release readiness.",
+            },
+        ],
+        template: {
+            schema_version: "0.1.0",
+            contract_id: "runtime:<id>",
+            contract_type: "runtime",
+            artifact_type: "team_runtime",
+            title: "<short runtime title>",
+            status: "active",
+            source_change: "",
+            active_work_item: null,
+            execution_mode: "single_agent|agent_team|reconcile|qa_fix",
+            work_queue: [],
+            agents: [],
+            verification: {
+                commands: [],
+                results: [],
+            },
+            issues: [],
+            checkpoints: [],
+            handoff: {
+                status: "in_progress",
+                next_action: null,
+                blockers: [],
+            },
+            updated_at: null,
+        },
+    },
 ];
 export function getDiscoveryArtifactContracts() {
     return DISCOVERY_ARTIFACT_CONTRACTS;