xytara 2.1.0 → 2.2.0

package/README.md

@@ -16,6 +16,8 @@ It exists to let agents, developers, and systems:
 
 This repo is the hot-state commerce layer. It does not define base proof semantics. It references and emits proof-compatible facts, while `xoonya` owns canonical proof.
 
+The 10-phase public program is now complete. `xytara` is in terminal closeout posture rather than active milestone build posture.
+
 ## Start Here
 
 If you are new to the public stack, use this order:
@@ -25,12 +27,45 @@ If you are new to the public stack, use this order:
 3. run `npm run verify:all`
 4. use [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/FINAL_CONTRACT.md) and [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/SERVICE_CONTRACT.md) as the durable public contract
 
+If you are evaluating the post-program operating posture, read:
+
+- [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PROGRAM_STATUS.md)
+- [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OPERATOR_START_HERE.md)
+- [OPERATIONS_RUNBOOK.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OPERATIONS_RUNBOOK.md)
+- [PROGRAM_COMPLETE_RELEASE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PROGRAM_COMPLETE_RELEASE.md)
+- [WHY_XYTARA_XOONYA.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/WHY_XYTARA_XOONYA.md)
+
+If you want one concrete cross-repo adoption story, start with:
+
+- [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/CARRIED_HANDOFF_DEMO.md)
+
+If you want the shortest neutral external-adoption bundle, continue with:
+
+- [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PARTNER_READY_PATH.md)
+- [PUBLIC_DEMO_SCRIPT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PUBLIC_DEMO_SCRIPT.md)
+- [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/EXAMPLE_PATHS.md)
+- `node examples/partner_launch_walkthrough.js`
+
 If you are building adapters, continue with:
 
+- [ADAPTER_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/ADAPTER_START_HERE.md)
+- [ADAPTER_PROMOTION_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/ADAPTER_PROMOTION_START_HERE.md)
+- [ADAPTER_PARTNER_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/ADAPTER_PARTNER_PATH.md)
+- [SOFT_LAUNCH_KIT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/SOFT_LAUNCH_KIT.md)
+- [OUTREACH_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OUTREACH_START_HERE.md)
+- [OUTREACH_MESSAGES.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OUTREACH_MESSAGES.md)
 - [adapters/AUTHORING_GUIDE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/AUTHORING_GUIDE.md)
 - [adapters/ONBOARDING_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/ONBOARDING_POSTURE.md)
 - [adapters/THIRD_PARTY_SUBMISSION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md)
 
+The fastest copy-and-adapt third-party starter now lives under:
+
+- `adapters/examples/minimal-third-party-execution-adapter.manifest.json`
+- `adapters/examples/minimal-third-party-execution-adapter.js`
+- `adapters/examples/minimal-third-party-execution-registration.record.json`
+- `adapters/examples/minimal-third-party-execution.certification-pack.json`
+- `adapters/examples/minimal-third-party-execution.submission-bundle.json`
+
 If you are wiring the native BSV settlement base, continue with:
 
 - [BSV_TERANODE_SETUP.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/BSV_TERANODE_SETUP.md)
@@ -173,6 +208,24 @@ For release-grade adoption posture, inspect:
 - `GET /v1/release-center/summary`
 - `GET /v1/release-history`
 - `GET /v1/release-history/summary`
+- `GET /v1/adapter-pack`
+- `GET /v1/adapter-pack/summary`
+- `GET /v1/adapter-promotion`
+- `GET /v1/adapter-promotion/summary`
+- `GET /v1/adapter-partners`
+- `GET /v1/adapter-partners/summary`
+- `GET /v1/soft-launch`
+- `GET /v1/soft-launch/summary`
+- `GET /v1/outreach-copy`
+- `GET /v1/outreach-copy/summary`
+- `GET /v1/outreach-targets`
+- `GET /v1/outreach-targets/summary`
+- `GET /v1/outreach-messages`
+- `GET /v1/outreach-messages/summary`
+- `GET /v1/phases`
+- `GET /v1/phases/summary`
+- `GET /v1/phases/phase-1`
+- `GET /v1/phases/phase-1/summary`
 - `GET /v1/publish-plan`
 - `GET /v1/publish-plan/summary`
 - `GET /v1/ecosystem-entry`
@@ -194,6 +247,15 @@ For release-grade adoption posture, inspect:
 - `xytara-release --notes --summary`
 - `xytara-release --center --summary`
 - `xytara-release --history --summary`
+- `xytara-release --adapters --summary`
+- `xytara-release --adapter-promotion --summary`
+- `xytara-release --adapter-partners --summary`
+- `xytara-release --soft-launch --summary`
+- `xytara-release --outreach-copy --summary`
+- `xytara-release --outreach-targets --summary`
+- `xytara-release --outreach-messages --summary`
+- `xytara-release --phases --summary`
+- `xytara-release --phase-1 --summary`
 - `xytara-release --ecosystem --summary`
 - `xytara-release --narrative --summary`
 - `xytara-release --outreach-proof --summary`
@@ -908,6 +970,10 @@ The durability and native-settlement readiness surfaces are also intended to mak
 - `/v1/settlement/bsv-teranode/readiness` exposes whether merchant identity, transport, verification mode, and runtime mode are production-ready, plus the next manual inputs still required
 - `/v1/payment-ledger/:payment_id/operator-pack` and `/v1/settlement/bsv-teranode/:settlement_id/operator-pack` collapse payment, settlement, treasury, proof, and economic-consequence carry into one operator-facing pack so direct-pay and funded-runtime paths are easier to inspect without stitching raw records together
 
+If you use grants, entitlements, or usage metering in deployed `xytara`, `XYTARA_STATE_FILE` should point at persistent disk rather than ephemeral container storage. Otherwise those economics records will reset across restart.
+
+If your host does not provide persistent disk, use the Supabase-backed runtime state path documented in [SUPABASE_RUNTIME_STATE_SETUP.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/SUPABASE_RUNTIME_STATE_SETUP.md).
+
 ## Verification
 
 Local verification commands:

package/RELEASE_CHECKLIST.md

@@ -2,9 +2,15 @@
 
 1. Run `npm run verify:release-candidate`.
 2. Confirm `npm pack --dry-run --json` includes the public docs and both CLI entrypoints.
+3. Run `node examples/partner_launch_walkthrough.js`.
 3. Redeploy the service and verify:
    - `/v1/release-center/summary`
    - `/v1/announcement-pack/summary`
    - `/v1/outreach-proof/summary`
-4. Run the first public proof path.
-5. Only then publish the npm package.
+   - `/v1/runtime/durability`
+4. Confirm the program-complete docs are packaged:
+   - `PROGRAM_COMPLETE_RELEASE.md`
+   - `WHY_XYTARA_XOONYA.md`
+   - `PARTNER_READY_PATH.md`
+5. Run the first public proof path.
+6. Only then publish the npm package.

package/RELEASE_NOTES.md

@@ -1,6 +1,6 @@
-# xytara 2.1.0 Release Notes
+# xytara 2.2.0 Release Notes
 
-`xytara` 2.1.0 is the public machine-commerce release-candidate line.
+`xytara` 2.2.0 is the public machine-commerce program-complete line.
 
 Highlights:
 
@@ -10,10 +10,19 @@ Highlights:
 - credits-first reusable spend posture
 - native settlement-aware runtime inspection
 - proof-compatible handoff into `xoonya`
+- partner-ready onboarding and launch docs
+- explicit runtime durability posture, including Supabase-backed persistence on hosts without persistent disk
 
 Recommended first checks:
 
 1. `npm install xytara`
 2. `xytara-release --candidate --summary`
 3. `npm run verify:release-candidate`
-4. inspect `/v1/release-candidate/summary` on the deployed service
+4. `node examples/partner_launch_walkthrough.js`
+5. inspect `/v1/release-candidate/summary` and `/v1/runtime/durability` on the deployed service
+
+Recommended first docs:
+
+- `PROGRAM_COMPLETE_RELEASE.md`
+- `WHY_XYTARA_XOONYA.md`
+- `PARTNER_READY_PATH.md`

package/START_HERE.md

@@ -2,6 +2,8 @@
 
 This is the shortest reliable path for understanding and using the public `xytara` package in production-facing order.
 
+The phase program is now complete, so this file is the right starting point for a closed and release-shaped runtime rather than an in-flight milestone build.
+
 ## 1. Understand The Role
 
 `xytara` is the transaction-side half of the public stack.
@@ -24,6 +26,17 @@ node examples/quickstart.js
 
 This is the fastest way to see the intended package story end-to-end.
 
+If you want the clearest cross-repo adoption path instead of the broad package tour, continue with:
+
+- [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/CARRIED_HANDOFF_DEMO.md)
+
+If you want the shortest neutral external-adoption bundle, continue with:
+
+- [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PARTNER_READY_PATH.md)
+- [PUBLIC_DEMO_SCRIPT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PUBLIC_DEMO_SCRIPT.md)
+- [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/EXAMPLE_PATHS.md)
+- `node examples/partner_launch_walkthrough.js`
+
 ## 3. Verify The Whole Package
 
 Run:
@@ -40,6 +53,13 @@ For long-term product understanding, read:
 
 - [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/FINAL_CONTRACT.md)
 - [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/SERVICE_CONTRACT.md)
+- [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PROGRAM_STATUS.md)
+- [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OPERATOR_START_HERE.md)
+- [OPERATIONS_RUNBOOK.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OPERATIONS_RUNBOOK.md)
+- [PROGRAM_COMPLETE_RELEASE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PROGRAM_COMPLETE_RELEASE.md)
+- [WHY_XYTARA_XOONYA.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/WHY_XYTARA_XOONYA.md)
+- [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/CARRIED_HANDOFF_DEMO.md)
+- [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PARTNER_READY_PATH.md)
 - [BSV_TERANODE_SETUP.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/BSV_TERANODE_SETUP.md)
 - [REAL_PAYMENT_SETUP.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/REAL_PAYMENT_SETUP.md)
 - [TERMINOLOGY.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/TERMINOLOGY.md)
@@ -48,6 +68,7 @@ For long-term product understanding, read:
 
 Continue with:
 
+- [ADAPTER_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/ADAPTER_START_HERE.md)
 - [adapters/AUTHORING_GUIDE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/AUTHORING_GUIDE.md)
 - [adapters/ONBOARDING_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/ONBOARDING_POSTURE.md)
 - [adapters/THIRD_PARTY_SUBMISSION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md)
@@ -61,3 +82,14 @@ The main public path is no longer "read every milestone layer."
 It is:
 
 discover -> preview/quote -> execute -> inspect -> hand off to `xoonya`
+
+## 7. If You Are Operating The Closed Program
+
+Use:
+
+- [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PROGRAM_STATUS.md)
+- [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OPERATOR_START_HERE.md)
+
+If you depend on hidden-account grants, credits, or usage meters in production, set `XYTARA_STATE_FILE` to a path on persistent disk before you trust restart durability.
+
+If your host does not provide persistent disk, use [SUPABASE_RUNTIME_STATE_SETUP.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/SUPABASE_RUNTIME_STATE_SETUP.md) instead.

package/SUPABASE_RUNTIME_STATE_SETUP.md

@@ -0,0 +1,61 @@
+# xytara Supabase Runtime State Setup
+
+Use this when `xytara` runs on infrastructure without persistent disk, such as a free Render service.
+
+## What This Solves
+
+This keeps runtime economics state durable across restart:
+
+- external credit grants
+- entitlements
+- credit spends
+- usage meters
+- hidden-account economics carry
+
+## 1. Create The Table In Supabase
+
+Run this SQL:
+
+```sql
+create table if not exists public.xytara_runtime_state (
+  state_key text primary key,
+  snapshot jsonb not null,
+  persisted_at_iso timestamptz not null default now()
+);
+```
+
+## 2. Configure xytara
+
+Set these environment variables on the deployed service:
+
+```text
+XYTARA_SUPABASE_URL=https://<project-ref>.supabase.co
+XYTARA_SUPABASE_SERVICE_ROLE_KEY=<service-role-key>
+XYTARA_SUPABASE_STATE_TABLE=xytara_runtime_state
+XYTARA_SUPABASE_STATE_KEY=default
+XYTARA_STATE_SNAPSHOT_INTERVAL_MS=5000
+```
+
+If `XYTARA_SUPABASE_URL` and `XYTARA_SUPABASE_SERVICE_ROLE_KEY` are set, `xytara` will use Supabase-backed runtime persistence instead of local file snapshots.
+
+## 3. Verify Runtime Durability
+
+Inspect:
+
+- `GET /v1/runtime/durability`
+
+Expected direction:
+
+- `storage_mode: "supabase"`
+- `remote_reachable: true`
+- `remote_table_ready: true`
+- `snapshot_exists: true` after the first persisted mutation
+
+## 4. Verify The Real Economics Path
+
+1. issue a hidden-account grant
+2. confirm balance and entitlements exist
+3. restart or redeploy `xytara`
+4. confirm the same hidden account still has balance and entitlements
+5. spend once
+6. confirm usage meter and spend history survive another restart

package/WHY_XYTARA_XOONYA.md

@@ -0,0 +1,63 @@
+# Why xytara And xoonya
+
+The public stack is intentionally split into two repos because runtime commerce and canonical proof have different operating constraints.
+
+## xytara
+
+`xytara` owns the transaction-side path:
+
+- discover
+- preview or quote
+- fund or spend
+- execute
+- inspect
+- export carry
+
+It is the right place for:
+
+- payment posture
+- credits and entitlements
+- settlement visibility
+- adapter registration and promotion
+- operator-facing runtime state
+
+## xoonya
+
+`xoonya` owns the proof-side path:
+
+- receive handoff
+- review preserved context
+- emit proof-native completion
+- verify the final bundle
+
+It is the right place for:
+
+- canonical event shape
+- receipts
+- proof bundles
+- narrow proof-adjacent integrations
+- reviewable proof followthrough
+
+## Why the split matters
+
+If commerce and proof are collapsed together, one side usually becomes muddy:
+
+- the runtime becomes too rigid
+- or the proof layer absorbs workflow and settlement semantics it should not own
+
+This split keeps both sides legible:
+
+- `xytara` stays execution and economics aware
+- `xoonya` stays canonical and proof aware
+
+## What builders get
+
+Builders do not need to choose between “commerce first” and “proof first.”
+
+They can:
+
+1. run the machine path in `xytara`
+2. export or carry the result
+3. complete the proof path in `xoonya`
+
+That is the public stack story.

package/adapters/examples/minimal-third-party-execution-adapter.js

@@ -0,0 +1,61 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const manifest = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, "minimal-third-party-execution-adapter.manifest.json"), "utf8")
+);
+
+async function getHealth() {
+  return {
+    status: "ok",
+    readiness: "ready",
+    adapter_id: manifest.adapter_id
+  };
+}
+
+function describeCapabilities() {
+  return {
+    adapter_id: manifest.adapter_id,
+    adapter_class: manifest.adapter_class,
+    capabilities: manifest.capabilities.slice(),
+    execution_modes: Array.isArray(manifest.execution_modes) ? manifest.execution_modes.slice() : []
+  };
+}
+
+async function preview(request) {
+  return {
+    adapter_id: manifest.adapter_id,
+    accepted: true,
+    preview: {
+      task_ref: request && request.task_ref ? request.task_ref : "example.task",
+      mode: "preview",
+      echoed_body: request && request.body ? request.body : {}
+    }
+  };
+}
+
+async function execute(request) {
+  return {
+    adapter_id: manifest.adapter_id,
+    status: "completed",
+    result: {
+      task_ref: request && request.task_ref ? request.task_ref : "example.task",
+      mode: "execute",
+      echoed_body: request && request.body ? request.body : {}
+    },
+    proof_facts: {
+      emits_proof_compatible_facts: manifest.proof_contract.emits_proof_compatible_facts,
+      proof_mode: manifest.proof_contract.proof_mode
+    }
+  };
+}
+
+module.exports = {
+  manifest,
+  getHealth,
+  describeCapabilities,
+  preview,
+  execute
+};

package/adapters/examples/minimal-third-party-execution-adapter.manifest.json

@@ -0,0 +1,79 @@
+{
+  "adapter_id": "partner.execution.minimal_echo",
+  "adapter_class": "execution_adapter",
+  "adapter_version": "0.1.0",
+  "interface_version": "commerce-adapter-interface/v1",
+  "display_name": "Minimal Third-Party Echo Adapter",
+  "description": "Minimal third-party execution adapter starter for external builders copying the public xytara contract.",
+  "capabilities": [
+    "task.execute",
+    "task.preview"
+  ],
+  "compatibility": {
+    "node": ">=18",
+    "commerce_contract": "xytara/v1",
+    "proof_contract": "xoonya/v1"
+  },
+  "health_contract": {
+    "check_kind": "self_reported",
+    "supports_readiness": true
+  },
+  "idempotency_contract": {
+    "strategy": "caller_supplied_key",
+    "scope": "task_execution"
+  },
+  "failure_contract": {
+    "categories": [
+      "invalid_input",
+      "timeout",
+      "upstream_unavailable"
+    ],
+    "retryable_categories": [
+      "timeout",
+      "upstream_unavailable"
+    ]
+  },
+  "proof_contract": {
+    "emits_proof_compatible_facts": true,
+    "proof_mode": "execution_facts_only"
+  },
+  "latency_class": "interactive",
+  "pricing_basis": "per_task",
+  "execution_modes": [
+    "sync"
+  ],
+  "required_secrets": [
+    "MINIMAL_EXECUTION_TOKEN"
+  ],
+  "required_permissions": [
+    "network:outbound"
+  ],
+  "supported_profiles": [
+    "partner"
+  ],
+  "supported_regions": [
+    "global"
+  ],
+  "supported_settlement_modes": [
+    "evm_payment"
+  ],
+  "registration_contract": {
+    "integration_id": "partner.execution.minimal_echo",
+    "integration_maturity": "reference_example",
+    "bundled": false,
+    "default_selection_enabled": false,
+    "selection_priority": 600,
+    "requires_explicit_selection": true
+  },
+  "certification_contract": {
+    "certification_state": "reference_example",
+    "certification_scope": [
+      "contract_shape",
+      "example_behavior"
+    ],
+    "verified_with": [
+      "npm run verify:adapters"
+    ],
+    "last_verified_contract_version": "commerce-adapter-interface/v1"
+  }
+}

package/adapters/examples/minimal-third-party-execution-registration.record.json

@@ -0,0 +1,26 @@
+{
+  "integration_id": "partner.execution.minimal_echo",
+  "adapter_id": "partner.execution.minimal_echo",
+  "adapter_class": "execution_adapter",
+  "registration_state": "staging_registered",
+  "integration_maturity": "staging_candidate",
+  "certification_state": "self_attested",
+  "bundled": false,
+  "default_selection_enabled": false,
+  "selection_priority": 600,
+  "requires_explicit_selection": true,
+  "registered_at": "2026-03-28T00:00:00.000Z",
+  "registered_by": "partner:minimal",
+  "verified_with": [
+    "npm run verify:adapters",
+    "minimal_smoke"
+  ],
+  "task_refs": [
+    "task.execute"
+  ],
+  "protocols": [],
+  "settlement_modes": [
+    "evm_payment"
+  ],
+  "notes": "Minimal third-party execution registration record for adapter starter flow."
+}

package/adapters/examples/minimal-third-party-execution.certification-pack.json

@@ -0,0 +1,22 @@
+{
+  "integration_id": "partner.execution.minimal_echo",
+  "adapter_id": "partner.execution.minimal_echo",
+  "adapter_class": "execution_adapter",
+  "certification_state": "self_attested",
+  "certification_scope": [
+    "self_attested_contract_shape",
+    "minimal_smoke"
+  ],
+  "verified_with": [
+    "npm run verify:adapters",
+    "minimal_smoke"
+  ],
+  "submitted_at": "2026-03-28T00:00:00Z",
+  "submitted_by": "partner:minimal",
+  "last_verified_contract_version": "xytara/v1",
+  "evidence_refs": [
+    "memory://minimal-execution/certification/schema-report",
+    "memory://minimal-execution/certification/smoke-report"
+  ],
+  "notes": "Minimal third-party execution certification pack for adapter starter flow."
+}

package/adapters/examples/minimal-third-party-execution.submission-bundle.json

@@ -0,0 +1,126 @@
+{
+  "bundle_version": "xytara/integration-submission-bundle/v1",
+  "manifest": {
+    "adapter_id": "partner.execution.minimal_echo",
+    "adapter_class": "execution_adapter",
+    "adapter_version": "0.1.0",
+    "interface_version": "commerce-adapter-interface/v1",
+    "display_name": "Minimal Third-Party Echo Adapter",
+    "description": "Minimal third-party execution adapter starter for external builders copying the public xytara contract.",
+    "capabilities": [
+      "task.execute",
+      "task.preview"
+    ],
+    "required_secrets": [
+      "MINIMAL_EXECUTION_TOKEN"
+    ],
+    "required_permissions": [
+      "network:outbound"
+    ],
+    "supported_profiles": [
+      "partner"
+    ],
+    "supported_regions": [
+      "global"
+    ],
+    "supported_settlement_modes": [
+      "evm_payment"
+    ],
+    "pricing_basis": "per_task",
+    "latency_class": "interactive",
+    "registration_contract": {
+      "integration_id": "partner.execution.minimal_echo",
+      "integration_maturity": "reference_example",
+      "bundled": false,
+      "default_selection_enabled": false,
+      "requires_explicit_selection": true
+    },
+    "certification_contract": {
+      "certification_state": "reference_example",
+      "certification_scope": [
+        "contract_shape",
+        "example_behavior"
+      ],
+      "verified_with": [
+        "npm run verify:adapters"
+      ],
+      "last_verified_contract_version": "xytara/v1"
+    },
+    "compatibility": {
+      "node": ">=18",
+      "commerce_contract": "xytara/v1",
+      "proof_contract": "xoonya/v1"
+    },
+    "health_contract": {
+      "check_kind": "self_reported",
+      "supports_readiness": true
+    },
+    "idempotency_contract": {
+      "strategy": "caller_supplied_key",
+      "scope": "task_execution"
+    },
+    "failure_contract": {
+      "categories": [
+        "invalid_input",
+        "timeout",
+        "upstream_unavailable"
+      ],
+      "retryable_categories": [
+        "timeout",
+        "upstream_unavailable"
+      ]
+    },
+    "proof_contract": {
+      "emits_proof_compatible_facts": true,
+      "proof_mode": "execution_facts_only"
+    }
+  },
+  "registration_record": {
+    "integration_id": "partner.execution.minimal_echo",
+    "adapter_id": "partner.execution.minimal_echo",
+    "adapter_class": "execution_adapter",
+    "registration_state": "staging_registered",
+    "integration_maturity": "staging_candidate",
+    "certification_state": "self_attested",
+    "bundled": false,
+    "default_selection_enabled": false,
+    "requires_explicit_selection": true,
+    "registered_at": "2026-03-28T00:00:00.000Z",
+    "registered_by": "partner:minimal",
+    "verified_with": [
+      "npm run verify:adapters",
+      "minimal_smoke"
+    ],
+    "task_refs": [
+      "task.execute"
+    ],
+    "protocols": [],
+    "settlement_modes": [
+      "evm_payment"
+    ],
+    "notes": "Minimal third-party execution registration record for adapter starter flow."
+  },
+  "certification_pack": {
+    "integration_id": "partner.execution.minimal_echo",
+    "adapter_id": "partner.execution.minimal_echo",
+    "adapter_class": "execution_adapter",
+    "certification_state": "self_attested",
+    "certification_scope": [
+      "self_attested_contract_shape",
+      "minimal_smoke"
+    ],
+    "verified_with": [
+      "npm run verify:adapters",
+      "minimal_smoke"
+    ],
+    "submitted_at": "2026-03-28T00:00:00Z",
+    "submitted_by": "partner:minimal",
+    "last_verified_contract_version": "xytara/v1",
+    "evidence_refs": [
+      "memory://minimal-execution/certification/schema-report",
+      "memory://minimal-execution/certification/smoke-report"
+    ],
+    "notes": "Minimal third-party execution certification pack for adapter starter flow."
+  },
+  "notes": "Minimal third-party execution submission bundle for copy-and-adapt onboarding."
+}