xytara 2.0.0 → 2.2.0

package/lib/launch_narrative.js

@@ -0,0 +1,53 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildLaunchNarrativePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-launch-narrative",
+    why_now: "agents and machine systems increasingly need to cross weak-trust boundaries where payment, execution, proof, and replayability cannot stay disconnected",
+    problem_patchwork_misses: [
+      "runtime-only stacks do not carry pricing, settlement, and proof continuity together",
+      "payment-only stacks do not stay attached to real machine work and reusable spend posture",
+      "ad hoc glue leaves operators to reconstruct trust and consequence after the fact"
+    ],
+    strongest_public_claim: "quote pay execute prove in one governed machine flow",
+    first_proof_to_run: {
+      path_ref: "scenario.direct_pay.trust_verify",
+      why_this_first: "smallest strong-signal run that shows paid machine execution, inspectable records, and proof-aware followthrough",
+      cli: "xytara-run --url https://xytara.onrender.com --account acct_demo --command \"cli-run\" --task trust.verify --body-json '{\"subject_id\":\"subject-1\"}' --wallet-id merchant_wallet_main --wallet-secret YOUR_LOCAL_SIGNED_SECRET --txid YOUR_BSV_TXID"
+    },
+    first_success_looks_like: [
+      "one capability is discovered and quoted",
+      "payment or credits admission succeeds",
+      "transaction, payment, and settlement records are inspectable",
+      "result output can continue into xoonya instead of ending as runtime exhaust"
+    ],
+    immediate_should_care: [
+      "agent builders needing paid capability execution",
+      "tool and marketplace authors needing neutral transaction handling",
+      "operators needing credits-first repeat machine use",
+      "runtime teams needing proof-aware continuation"
+    ]
+  };
+}
+
+function summarizeLaunchNarrativePack() {
+  const pack = buildLaunchNarrativePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    patchwork_gap_count: pack.problem_patchwork_misses.length,
+    success_signal_count: pack.first_success_looks_like.length,
+    immediate_audience_count: pack.immediate_should_care.length,
+    first_path_ref: pack.first_proof_to_run.path_ref
+  };
+}
+
+module.exports = {
+  buildLaunchNarrativePack,
+  summarizeLaunchNarrativePack
+};

package/lib/outreach_copy_pack.js

@@ -0,0 +1,51 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildOutreachCopyPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-outreach-copy-pack",
+    short_post: {
+      headline: "xytara is live",
+      body: "xytara is a machine-commerce spine for builders who need quote, pay, execute, inspect, and continue into proof without stitching together separate systems. It supports direct paid execution, reusable credits, adapter-first extension, and proof-aware followthrough."
+    },
+    direct_message: {
+      subject: "xytara: paid execution plus proof-aware followthrough",
+      body: "We built xytara for agent builders, tool authors, and runtime teams that need a real machine-commerce path instead of patchwork glue. If you want, start with `xytara-release --center --summary` and then run one paid path with `xytara-run`."
+    },
+    adapter_partner_message: {
+      subject: "xytara adapter partner path",
+      body: "If you build tools or integrations, xytara now has a public third-party adapter starter, promotion path, and partner path. You can copy the minimal starter, validate it locally, inspect the promotion workflow, and see exactly what still blocks broader trust."
+    },
+    first_links: [
+      "/v1/release-center/summary",
+      "/v1/soft-launch/summary",
+      "/v1/adapter-partners/summary",
+      "/v1/outreach-proof/summary"
+    ],
+    first_ctas: [
+      "run xytara-release --center --summary",
+      "run one direct paid path with xytara-run",
+      "inspect the adapter partner path if you build integrations"
+    ]
+  };
+}
+
+function summarizeOutreachCopyPack() {
+  const pack = buildOutreachCopyPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    link_count: pack.first_links.length,
+    cta_count: pack.first_ctas.length,
+    headline: pack.short_post.headline
+  };
+}
+
+module.exports = {
+  buildOutreachCopyPack,
+  summarizeOutreachCopyPack
+};

package/lib/outreach_message_pack.js

@@ -0,0 +1,71 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildOutreachMessagePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-outreach-message-pack",
+    messages: [
+      {
+        message_ref: "public_launch_post",
+        audience_ref: "general_builder",
+        channel: "public_post",
+        subject: "xytara is live",
+        body: "xytara is live. It is a machine-commerce spine for builders who need quote, pay, execute, inspect, and continue into proof without stitching together separate systems. Start with `/v1/release-center/summary` or run `xytara-release --center --summary`."
+      },
+      {
+        message_ref: "agent_builder_intro",
+        audience_ref: "agent_builder",
+        channel: "direct_message",
+        subject: "xytara for paid agent execution",
+        body: "If you need a real paid capability path for agents, xytara now gives you quote, pay, execute, inspect, and proof-aware followthrough on one public spine. Best first step: run `xytara-run` once, then inspect `/v1/release-center/summary`."
+      },
+      {
+        message_ref: "adapter_partner_intro",
+        audience_ref: "adapter_author",
+        channel: "direct_message",
+        subject: "xytara adapter partner path",
+        body: "If you build tools or integrations, xytara now has a public third-party adapter starter, promotion path, and partner path. You can copy the minimal starter, validate it locally, inspect promotion workflow, and see what still blocks broader trust."
+      },
+      {
+        message_ref: "runtime_team_intro",
+        audience_ref: "proof_aware_runtime_team",
+        channel: "direct_message",
+        subject: "xytara for runtime-to-proof followthrough",
+        body: "If your runtime results currently stop at logs, xytara gives you a machine-commerce path that can continue into proof review cleanly. Best first check: `/v1/outreach-proof/summary` and `xytara-release --outreach-proof --summary`."
+      }
+    ],
+    first_artifacts: [
+      "/v1/release-center/summary",
+      "/v1/adapter-partners/summary",
+      "/v1/outreach-proof/summary",
+      "/v1/soft-launch/summary"
+    ],
+    first_commands: [
+      "xytara-release --center --summary",
+      "xytara-release --adapter-partners --summary",
+      "xytara-release --outreach-proof --summary",
+      "xytara-run --url https://xytara.onrender.com --account acct_demo --command \"cli-run\" --task trust.verify --body-json '{\"subject_id\":\"subject-1\"}' --wallet-id merchant_wallet_main --wallet-secret YOUR_LOCAL_SIGNED_SECRET --txid YOUR_BSV_TXID"
+    ]
+  };
+}
+
+function summarizeOutreachMessagePack() {
+  const pack = buildOutreachMessagePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    message_count: pack.messages.length,
+    artifact_count: pack.first_artifacts.length,
+    command_count: pack.first_commands.length,
+    first_message: pack.messages[0] ? pack.messages[0].message_ref : null
+  };
+}
+
+module.exports = {
+  buildOutreachMessagePack,
+  summarizeOutreachMessagePack
+};

package/lib/outreach_proof.js

@@ -0,0 +1,71 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildOutreachProofPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-outreach-proof",
+    proven_live_today: [
+      "x402 payment admission for direct machine execution",
+      "native BSV settlement observe path with finalized state",
+      "credits-first account-funded spend and deterministic usage metering",
+      "operator inspection across payment, settlement, treasury, and proof carry"
+    ],
+    live_rails: [
+      {
+        rail_ref: "direct_machine_payment",
+        status: "proven_live",
+        trust_signal: "payment admitted, transaction recorded, settlement-linked execution path present"
+      },
+      {
+        rail_ref: "credits_first_repeat_use",
+        status: "proven_live",
+        trust_signal: "account credits consume against real runs with deterministic usage meters"
+      },
+      {
+        rail_ref: "native_bsv_settlement_observe",
+        status: "proven_live",
+        trust_signal: "observe runtime finalized against a real txid with confirmations"
+      }
+    ],
+    credible_public_proof_path: {
+      path_ref: "scenario.direct_pay.trust_verify",
+      why_credible: "smallest public run that already aligns with the demonstrated live payment and settlement posture",
+      cli: "xytara-run --url https://xytara.onrender.com --account acct_demo --command \"cli-run\" --task trust.verify --body-json '{\"subject_id\":\"subject-1\"}' --wallet-id merchant_wallet_main --wallet-secret YOUR_LOCAL_SIGNED_SECRET --txid YOUR_BSV_TXID"
+    },
+    trust_today_vs_later: {
+      trust_today: [
+        "direct paid machine execution",
+        "credits-first repeat usage",
+        "operator and launch surfaces",
+        "proof-aware runtime followthrough"
+      ],
+      later_depth: [
+        "broader ecosystem adoption after release",
+        "deeper settlement-path breadth beyond current proven posture",
+        "continued release-line expansion after public package launch"
+      ]
+    }
+  };
+}
+
+function summarizeOutreachProofPack() {
+  const pack = buildOutreachProofPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    proven_count: pack.proven_live_today.length,
+    live_rail_count: pack.live_rails.length,
+    trust_today_count: pack.trust_today_vs_later.trust_today.length,
+    later_depth_count: pack.trust_today_vs_later.later_depth.length,
+    first_path_ref: pack.credible_public_proof_path.path_ref
+  };
+}
+
+module.exports = {
+  buildOutreachProofPack,
+  summarizeOutreachProofPack
+};

package/lib/outreach_target_pack.js

@@ -0,0 +1,60 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildOutreachTargetPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-outreach-target-pack",
+    target_groups: [
+      {
+        target_ref: "agent_builders",
+        why_now: "need a first paid capability path with governed execution and proof-aware followthrough",
+        first_artifact: "/v1/release-center/summary",
+        first_cli: "xytara-run --url https://xytara.onrender.com --account acct_demo --command \"cli-run\" --task trust.verify --body-json '{\"subject_id\":\"subject-1\"}' --wallet-id merchant_wallet_main --wallet-secret YOUR_LOCAL_SIGNED_SECRET --txid YOUR_BSV_TXID"
+      },
+      {
+        target_ref: "adapter_authors",
+        why_now: "need a public starter plus a visible promotion path",
+        first_artifact: "/v1/adapter-partners/summary",
+        first_cli: "xytara-release --adapter-partners --summary"
+      },
+      {
+        target_ref: "tool_and_marketplace_authors",
+        why_now: "need a machine-commerce layer without stitching together payment, execution, and review",
+        first_artifact: "/v1/launch-narrative/summary",
+        first_cli: "xytara-release --launch --summary"
+      },
+      {
+        target_ref: "proof_aware_runtime_teams",
+        why_now: "need runtime results that continue cleanly into proof instead of stopping at logs",
+        first_artifact: "/v1/outreach-proof/summary",
+        first_cli: "xytara-release --outreach-proof --summary"
+      }
+    ],
+    first_wave_guidance: [
+      "start with a small technically strong set, not a broad audience",
+      "lead each target to one first artifact, not the whole surface map",
+      "watch which first cli or route they actually use",
+      "tighten language before expanding beyond the first wave"
+    ]
+  };
+}
+
+function summarizeOutreachTargetPack() {
+  const pack = buildOutreachTargetPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    target_count: pack.target_groups.length,
+    first_target: pack.target_groups[0] ? pack.target_groups[0].target_ref : null,
+    guidance_count: pack.first_wave_guidance.length
+  };
+}
+
+module.exports = {
+  buildOutreachTargetPack,
+  summarizeOutreachTargetPack
+};

package/lib/phase_10_closeout_pack.js

@@ -0,0 +1,45 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-closeout-pack",
+    phase_ref: "phase_10",
+    posture: "closeout_plan",
+    current_decision: "ready_for_program_closeout",
+    blocking_actions: [],
+    action_steps: [
+      "confirm the current long-tail lane family is the intended final Phase 10 shape",
+      "record the terminal program closeout review",
+      "recheck phase-10 gate summary for zero unsatisfied conditions",
+      "advance only once phase-10 gate resolves to ready_for_program_closeout"
+    ],
+    completion_signals: [
+      "phase-10 completion shows no remaining focus",
+      "phase-10 decision record shows no pending records",
+      "phase-10 gate resolves to ready_for_program_closeout"
+    ]
+  };
+}
+
+function summarizePhase10CloseoutPack() {
+  const pack = buildPhase10CloseoutPack();
+  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 = {
+  buildPhase10CloseoutPack,
+  summarizePhase10CloseoutPack
+};

package/lib/phase_10_completion_pack.js

@@ -0,0 +1,76 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10CompletionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-completion-pack",
+    phase_ref: "phase_10",
+    posture: "completion_review",
+    coverage: {
+      ecosystem_refs: ["demand_signal_adapters", "niche_extension_registry", "ecosystem_backlog_triage"],
+      lane_refs: [
+        "/v1/phases/phase-10/demand-signal-adapters/summary",
+        "/v1/phases/phase-10/niche-extension-registry/summary",
+        "/v1/phases/phase-10/ecosystem-backlog-triage/summary"
+      ],
+      extension_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
+      extension_artifacts: ["demand_signal_ref", "extension_registry_ref", "triage_queue_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-10/long-tail-continuity/summary"
+      ]
+    },
+    completion: {
+      checks: [
+        "broad Phase 10 long-tail ecosystem pack is public and inspectable",
+        "all current Phase 10 long-tail lanes are public and inspectable",
+        "extension posture is visible at phase level",
+        "long-tail continuity is explicit across the lane family",
+        "release-center summary reflects Phase 10 breadth and lane coverage",
+        "Phase 10 closeout criteria are explicit before final program closeout"
+      ],
+      readiness_criteria: [
+        { ref: "criterion.phase_surface_public", label: "Phase 10 broad summary is live and inspectable", satisfied: true },
+        { ref: "criterion.long_tail_lane_coverage", label: "All current long-tail lanes are live and inspectable", satisfied: true },
+        { ref: "criterion.long_tail_continuity_visible", label: "Long-tail continuity is visible at phase level", satisfied: true },
+        { ref: "criterion.operator_surfaces_attached", label: "Operator surfaces remain attached to the long-tail family", satisfied: true },
+        { ref: "criterion.freeze_shape_confirmed", label: "The final Phase 10 long-tail lane shape is explicitly frozen", satisfied: true },
+        { ref: "criterion.program_closeout_reviewed", label: "A final program closeout review has been recorded", satisfied: true }
+      ],
+      ready_for_next_phase: false,
+      remaining_focus: []
+    }
+  };
+}
+
+function summarizePhase10CompletionPack() {
+  const pack = buildPhase10CompletionPack();
+  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,
+    extension_mode_count: pack.coverage.extension_modes.length,
+    demand_mode_count: pack.coverage.demand_modes.length,
+    extension_artifact_count: pack.coverage.extension_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 = {
+  buildPhase10CompletionPack,
+  summarizePhase10CompletionPack
+};

package/lib/phase_10_decision_record_pack.js

@@ -0,0 +1,54 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10DecisionRecordPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-decision-record-pack",
+    phase_ref: "phase_10",
+    posture: "decision_record",
+    records: {
+      freeze_decision: {
+        status: "recorded",
+        description: "record the final long-tail lane shape as the frozen Phase 10 baseline"
+      },
+      program_closeout_review: {
+        status: "recorded",
+        description: "record the final review that authorizes terminal program closeout"
+      }
+    },
+    record_steps: [
+      "confirm the current long-tail lane family matches the intended final Phase 10 shape",
+      "record the freeze decision outcome",
+      "record the program closeout review outcome",
+      "recheck phase-10 gate summary for the remaining terminal blockers"
+    ],
+    outputs: [
+      "freeze decision status is recorded and inspectable",
+      "program closeout review status is recorded and inspectable",
+      "phase-10 terminal gate can be flipped deliberately"
+    ]
+  };
+}
+
+function summarizePhase10DecisionRecordPack() {
+  const pack = buildPhase10DecisionRecordPack();
+  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,
+    program_closeout_review_status: pack.records.program_closeout_review.status
+  };
+}
+
+module.exports = {
+  buildPhase10DecisionRecordPack,
+  summarizePhase10DecisionRecordPack
+};

package/lib/phase_10_decision_resolution_pack.js

@@ -0,0 +1,53 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10DecisionResolutionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-decision-resolution-pack",
+    phase_ref: "phase_10",
+    posture: "decision_resolution",
+    transitions: [
+      {
+        ref: "freeze_decision",
+        from: "pending_record",
+        to: "recorded"
+      },
+      {
+        ref: "program_closeout_review",
+        from: "pending_record",
+        to: "recorded"
+      }
+    ],
+    resolution_steps: [
+      "confirm the long-tail lane family is the intended final Phase 10 shape",
+      "record the freeze decision outcome",
+      "record the terminal program closeout review outcome",
+      "recheck phase-10 completion and freeze-review summaries",
+      "confirm phase-10 gate resolves to ready_for_program_closeout"
+    ],
+    target_gate_decision: "ready_for_program_closeout",
+    target_ready_for_next_phase: false
+  };
+}
+
+function summarizePhase10DecisionResolutionPack() {
+  const pack = buildPhase10DecisionResolutionPack();
+  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 = {
+  buildPhase10DecisionResolutionPack,
+  summarizePhase10DecisionResolutionPack
+};

package/lib/phase_10_demand_signal_adapters_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10DemandSignalAdaptersRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-demand-signal-adapters-runtime-pack",
+    phase_ref: "phase_10",
+    posture: "runtime_path",
+    ecosystems: ["demand_signal_adapters"],
+    runtime_shape: {
+      extension_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
+      extension_artifacts: ["signal_ref", "fit_ref", "triage_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-10/summary"
+      ]
+    },
+    first_path: {
+      purpose: "show the first Phase 10 path from incoming ecosystem demand into governed extension triage",
+      first_http_sequence: [
+        "/v1/phases/phase-10/summary",
+        "/v1/phases/phase-10/demand-signal-adapters/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-10-demand-signal-adapters-runtime --summary",
+        "xytara-release --phase-10 --summary"
+      ],
+      expected_signals: [
+        "demand signal adapters is a public Phase 10 lane",
+        "extension artifacts are explicit at the lane level",
+        "extension posture is visible before broader Phase 10 expansion"
+      ]
+    },
+    completion: {
+      completion_checks: [
+        "demand signal adapters lane is public and inspectable",
+        "extension artifacts are visible at lane level",
+        "operator surfaces remain attached to the extension lane",
+        "the lane is ready to anchor broader long-tail ecosystem breadth"
+      ]
+    }
+  };
+}
+
+function summarizePhase10DemandSignalAdaptersRuntimePack() {
+  const pack = buildPhase10DemandSignalAdaptersRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    extension_mode_count: pack.runtime_shape.extension_modes.length,
+    demand_mode_count: pack.runtime_shape.demand_modes.length,
+    extension_artifact_count: pack.runtime_shape.extension_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 = {
+  buildPhase10DemandSignalAdaptersRuntimePack,
+  summarizePhase10DemandSignalAdaptersRuntimePack
+};