xytara 2.1.0 → 2.3.0

package/lib/phase_3_freeze_baseline_pack.js

@@ -0,0 +1,67 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3FreezeBaselinePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-freeze-baseline-pack",
+    phase_ref: "phase_3",
+    posture: "frozen_baseline",
+    baseline: {
+      lane_refs: [
+        "/v1/phases/phase-3/bsv-teranode/summary",
+        "/v1/phases/phase-3/metanet/summary",
+        "/v1/phases/phase-3/brc/summary"
+      ],
+      settlement_modes: ["bsv_teranode"],
+      identity_layers: ["metanet", "brc"],
+      baseline_status: "recorded",
+      frozen_outputs: [
+        "current native lane family is the recorded Phase 3 baseline",
+        "native family can now be judged against a stable shape rather than an open expansion set",
+        "only the final gate review remains before Phase 4"
+      ]
+    },
+    first_path: {
+      purpose: "show that the Phase 3 native lane family is now treated as a frozen baseline",
+      first_http_sequence: [
+        "/v1/phases/phase-3/summary",
+        "/v1/phases/phase-3/freeze-baseline/summary",
+        "/v1/phases/phase-3/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-freeze-baseline --summary",
+        "xytara-release --phase-3-summary"
+      ],
+      expected_signals: [
+        "the native lane family is now explicitly frozen",
+        "lane freeze is no longer part of the remaining Phase 3 uncertainty",
+        "the final open work is narrowed to gate review rather than shape definition"
+      ]
+    }
+  };
+}
+
+function summarizePhase3FreezeBaselinePack() {
+  const pack = buildPhase3FreezeBaselinePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.baseline.lane_refs.length,
+    settlement_mode_count: pack.baseline.settlement_modes.length,
+    identity_layer_count: pack.baseline.identity_layers.length,
+    baseline_status: pack.baseline.baseline_status,
+    frozen_output_count: pack.baseline.frozen_outputs.length,
+    signal_count: pack.first_path.expected_signals.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase3FreezeBaselinePack,
+  summarizePhase3FreezeBaselinePack
+};

package/lib/phase_3_freeze_review_pack.js

@@ -0,0 +1,80 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3FreezeReviewPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-freeze-review-pack",
+    phase_ref: "phase_3",
+    posture: "freeze_review",
+    current_shape: {
+      lane_refs: [
+        "/v1/phases/phase-3/bsv-teranode/summary",
+        "/v1/phases/phase-3/metanet/summary",
+        "/v1/phases/phase-3/brc/summary"
+      ],
+      settlement_modes: ["bsv_teranode"],
+      identity_layers: ["metanet", "brc"]
+    },
+    freeze_review: {
+      decision_posture: "gate_review_recorded",
+      review_questions: [
+        "Is the current native lane split the exact shape we want to preserve for Phase 3?",
+        "Do settlement and identity lanes communicate the native family clearly without overlap confusion?",
+        "Is the current operator and native coverage sufficient before opening the next phase?",
+        "Would adding more native sub-lanes materially improve Phase 3, or just create sprawl?"
+      ],
+      resolution_criteria: [
+        { ref: "criterion.freeze_review_surface_public", label: "Freeze-review surface is public and inspectable", satisfied: true },
+        { ref: "criterion.blockers_explicit", label: "Current blockers are explicit and bounded", satisfied: true },
+        { ref: "criterion.freeze_decision_recorded", label: "Final native lane freeze has been explicitly recorded", satisfied: true },
+        { ref: "criterion.gate_review_recorded", label: "Next-phase gate review has been explicitly recorded", satisfied: true }
+      ],
+      blockers: [],
+      freeze_outputs: [
+        "freeze decision recorded",
+        "ready_for_next_phase flipped deliberately",
+        "Phase 3 native shape treated as stable baseline going forward"
+      ]
+    },
+    first_path: {
+      purpose: "review the last open questions before freezing the native Phase 3 lane family",
+      first_http_sequence: [
+        "/v1/phases/phase-3/completion/summary",
+        "/v1/phases/phase-3/freeze-review/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-freeze-review --summary",
+        "xytara-release --phase-3-completion --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase3FreezeReviewPack() {
+  const pack = buildPhase3FreezeReviewPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.current_shape.lane_refs.length,
+    settlement_mode_count: pack.current_shape.settlement_modes.length,
+    identity_layer_count: pack.current_shape.identity_layers.length,
+    review_question_count: pack.freeze_review.review_questions.length,
+    resolution_criteria_count: pack.freeze_review.resolution_criteria.length,
+    satisfied_resolution_count: pack.freeze_review.resolution_criteria.filter((criterion) => criterion.satisfied === true).length,
+    unsatisfied_resolution_count: pack.freeze_review.resolution_criteria.filter((criterion) => criterion.satisfied !== true).length,
+    blocker_count: pack.freeze_review.blockers.length,
+    freeze_output_count: pack.freeze_review.freeze_outputs.length,
+    decision_posture: pack.freeze_review.decision_posture
+  };
+}
+
+module.exports = {
+  buildPhase3FreezeReviewPack,
+  summarizePhase3FreezeReviewPack
+};

package/lib/phase_3_gate_pack.js

@@ -0,0 +1,76 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const { summarizePhase3CompletionPack } = require("./phase_3_completion_pack");
+const { summarizePhase3FreezeReviewPack } = require("./phase_3_freeze_review_pack");
+
+function buildPhase3GatePack() {
+  const completion = summarizePhase3CompletionPack();
+  const freezeReview = summarizePhase3FreezeReviewPack();
+  const unsatisfiedGateCount =
+    completion.unsatisfied_criteria_count +
+    freezeReview.unsatisfied_resolution_count;
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-gate-pack",
+    phase_ref: "phase_3",
+    posture: "phase_gate",
+    gate: {
+      decision: unsatisfiedGateCount === 0 ? "ready_for_phase_4" : "hold_phase_3",
+      ready_for_next_phase: unsatisfiedGateCount === 0,
+      satisfied_gate_count:
+        completion.satisfied_criteria_count +
+        freezeReview.satisfied_resolution_count,
+      unsatisfied_gate_count: unsatisfiedGateCount,
+      blockers: unsatisfiedGateCount === 0 ? [] : [
+        "next-phase gate review has not been explicitly recorded"
+      ],
+      advance_when: [
+        "freeze decision is explicitly recorded",
+        "gate review is explicitly recorded",
+        "completion and freeze-review surfaces both show no unsatisfied gate criteria"
+      ]
+    },
+    sources: {
+      completion_summary: "/v1/phases/phase-3/completion/summary",
+      freeze_review_summary: "/v1/phases/phase-3/freeze-review/summary",
+      release_center_summary: "/v1/release-center/summary"
+    },
+    first_path: {
+      purpose: "decide whether Phase 3 can be deliberately closed and Phase 4 can open",
+      first_http_sequence: [
+        "/v1/phases/phase-3/completion/summary",
+        "/v1/phases/phase-3/freeze-review/summary",
+        "/v1/phases/phase-3/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-gate --summary",
+        "xytara-release --phase-3-completion --summary",
+        "xytara-release --phase-3-freeze-review --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase3GatePack() {
+  const pack = buildPhase3GatePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    satisfied_gate_count: pack.gate.satisfied_gate_count,
+    unsatisfied_gate_count: pack.gate.unsatisfied_gate_count,
+    blocker_count: pack.gate.blockers.length,
+    advance_when_count: pack.gate.advance_when.length,
+    decision: pack.gate.decision,
+    ready_for_next_phase: pack.gate.ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase3GatePack,
+  summarizePhase3GatePack
+};

package/lib/phase_3_metanet_runtime_pack.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3MetanetRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-metanet-runtime-pack",
+    phase_ref: "phase_3",
+    ecosystem_refs: ["metanet"],
+    posture: "runtime_path",
+    identity_shape: {
+      rail_family: "bsv_native_identity",
+      identity_layers: ["metanet"],
+      graph_modes: ["node_linkage", "path_carry", "subject_continuity"],
+      continuity_artifacts: ["subject_ref", "metanet_path", "handoff_ref"],
+      continuity_refs: [
+        "/v1/phases/phase-3/native-continuity/summary",
+        "/v1/phases/phase-3/bsv-teranode/summary",
+        "/v1/phases/phase-3/brc/summary"
+      ],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-3/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the Metanet runtime lane is public and inspectable",
+        "native identity-layer posture stays attached to the runtime lane",
+        "operator surfaces remain available for native identity review",
+        "Phase 3 shows native identity expansion beyond settlement-only work"
+      ]
+    },
+    first_path: {
+      purpose: "show the native Metanet runtime lane for BSV-linked identity and continuity",
+      first_http_sequence: [
+        "/v1/phases/phase-3/summary",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-metanet-runtime --summary",
+        "xytara-release --phase-3 --summary"
+      ],
+      expected_signals: [
+        "Metanet is visible as a first-class native runtime lane",
+        "native identity continuity is inspectable from a stable route",
+        "Phase 3 broadens beyond settlement into native graph-linked posture"
+      ]
+    }
+  };
+}
+
+function summarizePhase3MetanetRuntimePack() {
+  const pack = buildPhase3MetanetRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    identity_layer_count: pack.identity_shape.identity_layers.length,
+    graph_mode_count: pack.identity_shape.graph_modes.length,
+    continuity_artifact_count: pack.identity_shape.continuity_artifacts.length,
+    continuity_ref_count: pack.identity_shape.continuity_refs.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.identity_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase3MetanetRuntimePack,
+  summarizePhase3MetanetRuntimePack
+};

package/lib/phase_3_native_bsv_pack.js

@@ -0,0 +1,91 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3NativeBsvPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-native-bsv-pack",
+    phase_ref: "phase_3",
+    status: "active",
+    ecosystems: ["bsv", "teranode", "metanet", "brc"],
+    lane_refs: [
+      "/v1/phases/phase-3/bsv-teranode/summary",
+      "/v1/phases/phase-3/metanet/summary",
+      "/v1/phases/phase-3/brc/summary"
+    ],
+    continuity_refs: [
+      "/v1/phases/phase-3/native-continuity/summary"
+    ],
+    native_shape: {
+      rail_family: "bsv_native",
+      settlement_modes: ["bsv_teranode"],
+      identity_layers: ["metanet", "brc"],
+      native_depth: {
+        submission_modes: ["signed_submit", "operator_replay"],
+        finality_stages: ["accepted", "observed", "settled"],
+        graph_modes: ["node_linkage", "path_carry", "subject_continuity"],
+        registry_modes: ["record_linkage", "attestation_lookup", "subject_resolution"]
+      },
+      lane_coverage: {
+        settlement_lane_refs: ["/v1/phases/phase-3/bsv-teranode/summary"],
+        identity_lane_refs: [
+          "/v1/phases/phase-3/metanet/summary",
+          "/v1/phases/phase-3/brc/summary"
+        ]
+      },
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "broad native BSV phase pack is public and inspectable",
+        "BSV plus Teranode, Metanet, and BRC runtime lanes are public and inspectable",
+        "native identity expansion is visible alongside native settlement work",
+        "native settlement and operator surfaces stay attached to the Phase 3 rail family",
+        "release-center summary reflects Phase 3 activation and the first native runtime lane"
+      ]
+    },
+    goal: "fully solidify the native differentiated BSV-centered rail family as the next active program slice",
+    done_means: [
+      "Phase 2 is no longer the active program slice",
+      "native BSV work has a public runtime-facing entry path",
+      "BSV, Teranode, Metanet, and BRC are visible as an explicit Phase 3 lane family",
+      "the first native lane family feels operational rather than like a placeholder"
+    ]
+  };
+}
+
+function summarizePhase3NativeBsvPack() {
+  const pack = buildPhase3NativeBsvPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    lane_count: pack.lane_refs.length,
+    continuity_ref_count: pack.continuity_refs.length,
+    settlement_mode_count: pack.native_shape.settlement_modes.length,
+    identity_layer_count: pack.native_shape.identity_layers.length,
+    submission_mode_count: pack.native_shape.native_depth.submission_modes.length,
+    finality_stage_count: pack.native_shape.native_depth.finality_stages.length,
+    graph_mode_count: pack.native_shape.native_depth.graph_modes.length,
+    registry_mode_count: pack.native_shape.native_depth.registry_modes.length,
+    settlement_lane_count: pack.native_shape.lane_coverage.settlement_lane_refs.length,
+    identity_lane_count: pack.native_shape.lane_coverage.identity_lane_refs.length,
+    operator_surface_count: pack.native_shape.operator_surfaces.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    done_mean_count: pack.done_means.length,
+    first_ecosystem: pack.ecosystems[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase3NativeBsvPack,
+  summarizePhase3NativeBsvPack
+};

package/lib/phase_3_native_continuity_pack.js

@@ -0,0 +1,82 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3NativeContinuityPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-native-continuity-pack",
+    phase_ref: "phase_3",
+    posture: "native_family_continuity",
+    lane_refs: [
+      "/v1/phases/phase-3/bsv-teranode/summary",
+      "/v1/phases/phase-3/metanet/summary",
+      "/v1/phases/phase-3/brc/summary"
+    ],
+    continuity_shape: {
+      rail_family: "bsv_native",
+      settlement_lane_refs: ["/v1/phases/phase-3/bsv-teranode/summary"],
+      identity_lane_refs: [
+        "/v1/phases/phase-3/metanet/summary",
+        "/v1/phases/phase-3/brc/summary"
+      ],
+      continuity_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/integrations/settlement-modes",
+        "/v1/publish-plan/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the native continuity family is public and inspectable",
+        "settlement and identity-native lanes remain attached to one Phase 3 family",
+        "Metanet and BRC stay legible as identity-continuity extensions of the BSV-native rail family",
+        "operator-facing native continuity review remains available from stable public routes"
+      ]
+    },
+    first_path: {
+      purpose: "show the native BSV family as one continuity path spanning settlement and identity-linked carry",
+      first_http_sequence: [
+        "/v1/phases/phase-3/summary",
+        "/v1/phases/phase-3/bsv-teranode/summary",
+        "/v1/phases/phase-3/metanet/summary",
+        "/v1/phases/phase-3/brc/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-native-continuity --summary",
+        "xytara-release --phase-3 --summary"
+      ],
+      expected_signals: [
+        "Phase 3 reads as one BSV-native family rather than disconnected lanes",
+        "native settlement and native identity expansion stay visibly linked",
+        "operators can inspect one continuity posture before drilling into lane-specific details",
+        "the differentiated native rail family feels more operational and coherent"
+      ]
+    }
+  };
+}
+
+function summarizePhase3NativeContinuityPack() {
+  const pack = buildPhase3NativeContinuityPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.lane_refs.length,
+    settlement_lane_count: pack.continuity_shape.settlement_lane_refs.length,
+    identity_lane_count: pack.continuity_shape.identity_lane_refs.length,
+    continuity_surface_count: pack.continuity_shape.continuity_surfaces.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,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase3NativeContinuityPack,
+  summarizePhase3NativeContinuityPack
+};

package/lib/phase_4_attestation_runtime_pack.js

@@ -0,0 +1,75 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4AttestationRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-4-attestation-runtime-pack",
+    phase_ref: "phase_4",
+    ecosystem_ref: "attestation",
+    status: "active",
+    trust_shape: {
+      identity_layers: ["attestation"],
+      attestation_modes: ["subject_attestation", "attester_resolution", "review_carry"],
+      review_modes: ["subject_attestation", "attester_resolution", "review_carry"],
+      trust_artifacts: ["attestation_ref", "attester_ref", "review_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-4/summary"
+      ]
+    },
+    first_steps: {
+      http: [
+        "/v1/phases/phase-4/summary",
+        "/v1/phases/phase-4/attestation/summary",
+        "/v1/release-center/summary"
+      ],
+      cli: [
+        "xytara-release --phase-4 --summary",
+        "xytara-release --phase-4-attestation-runtime --summary"
+      ]
+    },
+    success_signals: [
+      "attestation lane is public and inspectable",
+      "attester resolution and review carry are visible",
+      "trust artifacts stay explicit at lane level"
+    ],
+    completion_shape: {
+      completion_checks: [
+        "attestation runtime lane is public and inspectable",
+        "attestation and attester resolution modes are visible",
+        "trust artifacts are explicit at lane level",
+        "operator surfaces stay attached to the lane"
+      ]
+    }
+  };
+}
+
+function summarizePhase4AttestationRuntimePack() {
+  const pack = buildPhase4AttestationRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.trust_shape.identity_layers.length,
+    identity_layer_count: pack.trust_shape.identity_layers.length,
+    attestation_mode_count: pack.trust_shape.attestation_modes.length,
+    review_mode_count: pack.trust_shape.review_modes.length,
+    trust_artifact_count: pack.trust_shape.trust_artifacts.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_steps.http.length,
+    cli_step_count: pack.first_steps.cli.length,
+    signal_count: pack.success_signals.length,
+    operator_surface_count: pack.trust_shape.operator_surfaces.length,
+    first_http_step: pack.first_steps.http[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase4AttestationRuntimePack,
+  summarizePhase4AttestationRuntimePack
+};

package/lib/phase_4_closeout_pack.js

@@ -0,0 +1,45 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-4-closeout-pack",
+    phase_ref: "phase_4",
+    posture: "phase_closeout",
+    current_decision: "ready_for_phase_5",
+    blocking_actions: [],
+    action_steps: [
+      "confirm the current trust lane family remains the recorded Phase 4 baseline",
+      "confirm the gate review is recorded",
+      "recheck phase-4 gate summary for zero unsatisfied conditions",
+      "advance to Phase 5 only after the gate is explicitly ready"
+    ],
+    completion_signals: [
+      "freeze baseline is recorded",
+      "gate review is recorded",
+      "phase-4 gate resolves to ready_for_phase_5"
+    ]
+  };
+}
+
+function summarizePhase4CloseoutPack() {
+  const pack = buildPhase4CloseoutPack();
+  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 = {
+  buildPhase4CloseoutPack,
+  summarizePhase4CloseoutPack
+};