xytara 2.0.0 → 2.2.0

package/lib/phase_7_kafka_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase7KafkaRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-7-kafka-runtime-pack",
+    phase_ref: "phase_7",
+    ecosystem_refs: ["kafka"],
+    posture: "runtime_path",
+    integration_shape: {
+      event_modes: ["topic_stream_ingest", "consumer_group_handoff", "offset_checkpoint_carry"],
+      stream_modes: ["partitioned_topic_flow", "consumer_group_flow", "offset_checkpoint_flow"],
+      event_artifacts: ["topic_ref", "consumer_ref", "offset_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-7/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the Kafka runtime lane is public and inspectable",
+        "event ingestion posture stays attached to the lane",
+        "operator surfaces remain available for system-integration review",
+        "Phase 7 begins from explicit enterprise event legibility"
+      ]
+    },
+    first_path: {
+      purpose: "show the first public system-integration lane for enterprise event ingress and handoff carry",
+      first_http_sequence: [
+        "/v1/phases/phase-7/summary",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-7-kafka-runtime --summary",
+        "xytara-release --phase-7 --summary"
+      ],
+      expected_signals: [
+        "Kafka is visible as the first concrete Phase 7 system-integration lane",
+        "event ingestion posture is inspectable from a stable route",
+        "Phase 7 starts from enterprise integration clarity rather than generic adapter naming"
+      ]
+    }
+  };
+}
+
+function summarizePhase7KafkaRuntimePack() {
+  const pack = buildPhase7KafkaRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    event_mode_count: pack.integration_shape.event_modes.length,
+    stream_mode_count: pack.integration_shape.stream_modes.length,
+    event_artifact_count: pack.integration_shape.event_artifacts.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.integration_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase7KafkaRuntimePack,
+  summarizePhase7KafkaRuntimePack
+};

package/lib/phase_7_mqtt_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase7MqttRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-7-mqtt-runtime-pack",
+    phase_ref: "phase_7",
+    ecosystem_refs: ["mqtt"],
+    posture: "runtime_path",
+    integration_shape: {
+      event_modes: ["topic_publish_ingest", "device_message_handoff", "qos_state_carry"],
+      qos_modes: ["device_session_flow", "qos_delivery_flow", "retained_state_flow"],
+      event_artifacts: ["topic_ref", "message_ref", "qos_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-7/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the MQTT runtime lane is public and inspectable",
+        "device and message posture stays attached to the lane",
+        "operator surfaces remain available for system-integration review",
+        "Phase 7 includes device-oriented event ingress explicitly"
+      ]
+    },
+    first_path: {
+      purpose: "show the MQTT event path for device-linked ingress and qos-aware carry",
+      first_http_sequence: [
+        "/v1/phases/phase-7/summary",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-7-mqtt-runtime --summary",
+        "xytara-release --phase-7 --summary"
+      ],
+      expected_signals: [
+        "MQTT is visible as a concrete Phase 7 device-event lane",
+        "message and qos posture are inspectable from a stable route",
+        "Phase 7 is broadening toward real system ingress diversity"
+      ]
+    }
+  };
+}
+
+function summarizePhase7MqttRuntimePack() {
+  const pack = buildPhase7MqttRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    event_mode_count: pack.integration_shape.event_modes.length,
+    qos_mode_count: pack.integration_shape.qos_modes.length,
+    event_artifact_count: pack.integration_shape.event_artifacts.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.integration_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase7MqttRuntimePack,
+  summarizePhase7MqttRuntimePack
+};

package/lib/phase_7_nats_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase7NatsRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-7-nats-runtime-pack",
+    phase_ref: "phase_7",
+    ecosystem_refs: ["nats"],
+    posture: "runtime_path",
+    integration_shape: {
+      event_modes: ["subject_stream_ingest", "consumer_handoff", "delivery_ack_carry"],
+      subject_modes: ["subject_mesh_flow", "queue_group_flow", "ack_commit_flow"],
+      event_artifacts: ["subject_ref", "consumer_ref", "ack_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-7/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the NATS runtime lane is public and inspectable",
+        "event ingestion posture stays attached to the lane",
+        "operator surfaces remain available for system-integration review",
+        "Phase 7 broadens into enterprise messaging rather than a single bus"
+      ]
+    },
+    first_path: {
+      purpose: "show the NATS event path for subject-oriented ingress and durable handoff carry",
+      first_http_sequence: [
+        "/v1/phases/phase-7/summary",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-7-nats-runtime --summary",
+        "xytara-release --phase-7 --summary"
+      ],
+      expected_signals: [
+        "NATS is visible as a concrete Phase 7 system-integration lane",
+        "subject-stream posture is inspectable from a stable route",
+        "Phase 7 broadens beyond a single event-bus shape"
+      ]
+    }
+  };
+}
+
+function summarizePhase7NatsRuntimePack() {
+  const pack = buildPhase7NatsRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    event_mode_count: pack.integration_shape.event_modes.length,
+    subject_mode_count: pack.integration_shape.subject_modes.length,
+    event_artifact_count: pack.integration_shape.event_artifacts.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.integration_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase7NatsRuntimePack,
+  summarizePhase7NatsRuntimePack
+};

package/lib/phase_7_webhook_event_bus_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase7WebhookEventBusRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-7-webhook-event-bus-runtime-pack",
+    phase_ref: "phase_7",
+    ecosystem_refs: ["webhook_event_bus"],
+    posture: "runtime_path",
+    integration_shape: {
+      event_modes: ["webhook_ingest", "signed_callback_handoff", "delivery_retry_carry"],
+      callback_modes: ["signed_callback_flow", "retry_schedule_flow", "endpoint_contract_flow"],
+      event_artifacts: ["endpoint_ref", "callback_ref", "retry_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-7/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the webhook event-bus runtime lane is public and inspectable",
+        "callback posture stays attached to the lane",
+        "operator surfaces remain available for system-integration review",
+        "Phase 7 includes direct webhook ingress explicitly"
+      ]
+    },
+    first_path: {
+      purpose: "show the webhook event-bus path for callback ingress and retry-aware carry",
+      first_http_sequence: [
+        "/v1/phases/phase-7/summary",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-7-webhook-event-bus-runtime --summary",
+        "xytara-release --phase-7 --summary"
+      ],
+      expected_signals: [
+        "webhook_event_bus is visible as a concrete Phase 7 ingress lane",
+        "callback and retry posture are inspectable from a stable route",
+        "Phase 7 includes direct external event delivery alongside message buses"
+      ]
+    }
+  };
+}
+
+function summarizePhase7WebhookEventBusRuntimePack() {
+  const pack = buildPhase7WebhookEventBusRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    event_mode_count: pack.integration_shape.event_modes.length,
+    callback_mode_count: pack.integration_shape.callback_modes.length,
+    event_artifact_count: pack.integration_shape.event_artifacts.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.integration_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase7WebhookEventBusRuntimePack,
+  summarizePhase7WebhookEventBusRuntimePack
+};

package/lib/phase_8_closeout_pack.js

@@ -0,0 +1,46 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-closeout-pack",
+    phase_ref: "phase_8",
+    posture: "closeout_plan",
+    current_decision: "ready_for_phase_9",
+    blocking_actions: [],
+    action_steps: [
+      "confirm the current proof-bridge lane family is the final Phase 8 shape",
+      "confirm the recorded freeze baseline still matches the intended final Phase 8 shape",
+      "record the gate review outcome",
+      "recheck phase-8 gate summary for zero unsatisfied conditions",
+      "advance only once phase-8 gate resolves to ready_for_phase_9"
+    ],
+    completion_signals: [
+      "phase-8 completion shows no remaining focus",
+      "phase-8 decision record shows no pending records",
+      "phase-8 gate resolves to ready_for_phase_9"
+    ]
+  };
+}
+
+function summarizePhase8CloseoutPack() {
+  const pack = buildPhase8CloseoutPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    blocking_action_count: pack.blocking_actions.length,
+    action_step_count: pack.action_steps.length,
+    completion_signal_count: pack.completion_signals.length,
+    current_decision: pack.current_decision
+  };
+}
+
+module.exports = {
+  buildPhase8CloseoutPack,
+  summarizePhase8CloseoutPack
+};

package/lib/phase_8_completion_pack.js

@@ -0,0 +1,82 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8CompletionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-completion-pack",
+    phase_ref: "phase_8",
+    posture: "completion_review",
+    coverage: {
+      ecosystem_refs: ["external_result_import", "external_receipt_import", "proof_bundle_normalization"],
+      lane_refs: [
+        "/v1/phases/phase-8/external-result-import/summary",
+        "/v1/phases/phase-8/external-receipt-import/summary",
+        "/v1/phases/phase-8/proof-bundle-normalization/summary"
+      ],
+      import_modes: ["result_fact_capture", "receipt_handoff_capture", "proof_bundle_normalization"],
+      bridge_modes: ["result_ingest_bridge", "receipt_ingest_bridge", "bundle_normalization_bridge"],
+      result_modes: ["result_ingest_flow", "result_mapping_flow", "result_handoff_flow"],
+      receipt_modes: ["receipt_ingest_flow", "settlement_mapping_flow", "receipt_handoff_flow"],
+      normalization_modes: ["bundle_merge_flow", "shape_alignment_flow", "continuation_export_flow"],
+      normalization_artifacts: ["result_ref", "receipt_ref", "bundle_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-8/proof-bridge-continuity/summary"
+      ]
+    },
+    completion: {
+      checks: [
+        "broad Phase 8 proof-bridge pack is public and inspectable",
+        "all current Phase 8 proof-bridge lanes are public and inspectable",
+        "proof-bridge posture is visible at phase level",
+        "proof-bridge continuity is explicit across the lane family",
+        "release-center summary reflects Phase 8 breadth and lane coverage",
+        "Phase 8 closure criteria are explicit before opening Phase 9"
+      ],
+      readiness_criteria: [
+        { ref: "criterion.phase_surface_public", label: "Phase 8 broad summary is live and inspectable", satisfied: true },
+        { ref: "criterion.bridge_lane_coverage", label: "All current proof-bridge lanes are live and inspectable", satisfied: true },
+        { ref: "criterion.bridge_continuity_visible", label: "Proof-bridge continuity is visible at phase level", satisfied: true },
+        { ref: "criterion.operator_surfaces_attached", label: "Operator surfaces remain attached to the proof-bridge family", satisfied: true },
+        { ref: "criterion.freeze_shape_confirmed", label: "The final Phase 8 proof-bridge lane shape is explicitly frozen", satisfied: true },
+        { ref: "criterion.next_phase_gate_reviewed", label: "A final freeze review has been recorded before opening Phase 9", satisfied: true }
+      ],
+      ready_for_next_phase: true,
+      remaining_focus: []
+    }
+  };
+}
+
+function summarizePhase8CompletionPack() {
+  const pack = buildPhase8CompletionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.coverage.ecosystem_refs.length,
+    lane_count: pack.coverage.lane_refs.length,
+    import_mode_count: pack.coverage.import_modes.length,
+    bridge_mode_count: pack.coverage.bridge_modes.length,
+    result_mode_count: pack.coverage.result_modes.length,
+    receipt_mode_count: pack.coverage.receipt_modes.length,
+    normalization_mode_count: pack.coverage.normalization_modes.length,
+    normalization_artifact_count: pack.coverage.normalization_artifacts.length,
+    operator_surface_count: pack.coverage.operator_surfaces.length,
+    completion_check_count: pack.completion.checks.length,
+    readiness_criteria_count: pack.completion.readiness_criteria.length,
+    satisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied === true).length,
+    unsatisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied !== true).length,
+    remaining_focus_count: pack.completion.remaining_focus.length,
+    ready_for_next_phase: pack.completion.ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase8CompletionPack,
+  summarizePhase8CompletionPack
+};

package/lib/phase_8_decision_record_pack.js

@@ -0,0 +1,54 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8DecisionRecordPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-decision-record-pack",
+    phase_ref: "phase_8",
+    posture: "decision_record",
+    records: {
+      freeze_decision: {
+        status: "recorded",
+        description: "record the final proof-bridge lane shape as the frozen Phase 8 baseline"
+      },
+      gate_review: {
+        status: "recorded",
+        description: "record the final review that authorizes the move to Phase 9"
+      }
+    },
+    record_steps: [
+      "confirm the current proof-bridge lane family matches the intended final Phase 8 shape",
+      "record the freeze decision outcome",
+      "record the gate review outcome",
+      "recheck phase-8 gate summary for zero unsatisfied conditions"
+    ],
+    outputs: [
+      "freeze decision status moves out of pending_record",
+      "gate review status moves out of pending_record",
+      "phase-8 gate can be flipped deliberately"
+    ]
+  };
+}
+
+function summarizePhase8DecisionRecordPack() {
+  const pack = buildPhase8DecisionRecordPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    pending_record_count: Object.values(pack.records).filter((record) => record.status === "pending_record").length,
+    record_step_count: pack.record_steps.length,
+    output_count: pack.outputs.length,
+    freeze_decision_status: pack.records.freeze_decision.status,
+    gate_review_status: pack.records.gate_review.status
+  };
+}
+
+module.exports = {
+  buildPhase8DecisionRecordPack,
+  summarizePhase8DecisionRecordPack
+};

package/lib/phase_8_decision_resolution_pack.js

@@ -0,0 +1,53 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8DecisionResolutionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-decision-resolution-pack",
+    phase_ref: "phase_8",
+    posture: "decision_resolution",
+    transitions: [
+      {
+        ref: "freeze_decision",
+        from: "pending_record",
+        to: "recorded"
+      },
+      {
+        ref: "gate_review",
+        from: "pending_record",
+        to: "recorded"
+      }
+    ],
+    resolution_steps: [
+      "confirm the proof-bridge lane family is the intended final Phase 8 shape",
+      "record the freeze decision outcome",
+      "record the gate review outcome",
+      "recheck phase-8 completion and freeze-review summaries",
+      "confirm phase-8 gate resolves to ready_for_phase_9"
+    ],
+    target_gate_decision: "ready_for_phase_9",
+    target_ready_for_next_phase: true
+  };
+}
+
+function summarizePhase8DecisionResolutionPack() {
+  const pack = buildPhase8DecisionResolutionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    transition_count: pack.transitions.length,
+    resolution_step_count: pack.resolution_steps.length,
+    target_gate_decision: pack.target_gate_decision,
+    target_ready_for_next_phase: pack.target_ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase8DecisionResolutionPack,
+  summarizePhase8DecisionResolutionPack
+};

package/lib/phase_8_external_receipt_import_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8ExternalReceiptImportRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-external-receipt-import-runtime-pack",
+    phase_ref: "phase_8",
+    posture: "runtime_path",
+    ecosystems: ["external_receipt_import"],
+    runtime_shape: {
+      import_modes: ["receipt_fact_capture", "settlement_receipt_handoff", "proof_bundle_normalization"],
+      receipt_modes: ["receipt_ingest_flow", "settlement_mapping_flow", "receipt_handoff_flow"],
+      normalization_artifacts: ["receipt_ref", "settlement_ref", "bundle_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-8/summary"
+      ]
+    },
+    first_path: {
+      purpose: "show the Phase 8 receipt-import bridge path from external receipts into normalized proof handoff",
+      first_http_sequence: [
+        "/v1/phases/phase-8/summary",
+        "/v1/phases/phase-8/external-receipt-import/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-8-external-receipt-import-runtime --summary",
+        "xytara-release --phase-8 --summary"
+      ],
+      expected_signals: [
+        "external receipt import is a public Phase 8 lane",
+        "receipt normalization artifacts are explicit at the lane level",
+        "proof-bridge posture is visible across more than one bridge lane"
+      ]
+    },
+    completion: {
+      completion_checks: [
+        "external receipt import lane is public and inspectable",
+        "receipt normalization artifacts are visible at lane level",
+        "operator surfaces remain attached to the receipt-import lane",
+        "the lane is ready to deepen broader proof-bridge breadth"
+      ]
+    }
+  };
+}
+
+function summarizePhase8ExternalReceiptImportRuntimePack() {
+  const pack = buildPhase8ExternalReceiptImportRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    import_mode_count: pack.runtime_shape.import_modes.length,
+    receipt_mode_count: pack.runtime_shape.receipt_modes.length,
+    normalization_artifact_count: pack.runtime_shape.normalization_artifacts.length,
+    completion_check_count: pack.completion.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.runtime_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase8ExternalReceiptImportRuntimePack,
+  summarizePhase8ExternalReceiptImportRuntimePack
+};

package/lib/phase_8_external_result_import_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8ExternalResultImportRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-external-result-import-runtime-pack",
+    phase_ref: "phase_8",
+    posture: "runtime_path",
+    ecosystems: ["external_result_import"],
+    runtime_shape: {
+      import_modes: ["result_fact_capture", "receipt_handoff_capture", "proof_bundle_normalization"],
+      result_modes: ["result_ingest_flow", "result_mapping_flow", "result_handoff_flow"],
+      normalization_artifacts: ["result_ref", "receipt_ref", "bundle_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-8/summary"
+      ]
+    },
+    first_path: {
+      purpose: "show the first Phase 8 proof-bridge import path from runtime-side facts into normalized proof handoff",
+      first_http_sequence: [
+        "/v1/phases/phase-8/summary",
+        "/v1/phases/phase-8/external-result-import/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-8-external-result-import-runtime --summary",
+        "xytara-release --phase-8 --summary"
+      ],
+      expected_signals: [
+        "external result import is a public Phase 8 lane",
+        "normalization artifacts are explicit at the lane level",
+        "proof-bridge posture is visible before broader Phase 8 expansion"
+      ]
+    },
+    completion: {
+      completion_checks: [
+        "external result import lane is public and inspectable",
+        "normalization artifacts are visible at lane level",
+        "operator surfaces remain attached to the import lane",
+        "the lane is ready to anchor broader proof-bridge breadth"
+      ]
+    }
+  };
+}
+
+function summarizePhase8ExternalResultImportRuntimePack() {
+  const pack = buildPhase8ExternalResultImportRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    import_mode_count: pack.runtime_shape.import_modes.length,
+    result_mode_count: pack.runtime_shape.result_modes.length,
+    normalization_artifact_count: pack.runtime_shape.normalization_artifacts.length,
+    completion_check_count: pack.completion.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.runtime_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase8ExternalResultImportRuntimePack,
+  summarizePhase8ExternalResultImportRuntimePack
+};