xytara 2.5.0 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/.env.example +29 -0
  2. package/BSV_TERANODE_SETUP.md +43 -0
  3. package/README.md +66 -7
  4. package/REAL_PAYMENT_SETUP.md +61 -0
  5. package/RELEASE_NOTES.md +12 -6
  6. package/SERVICE_CONTRACT.md +31 -0
  7. package/START_HERE.md +107 -6
  8. package/TREASURY_DESTINATIONS.example.json +66 -0
  9. package/TREASURY_DESTINATIONS.production.template.json +108 -0
  10. package/adapters/examples/langchain-reference-execution-adapter.js +81 -0
  11. package/adapters/examples/langchain-reference-execution-adapter.manifest.json +79 -0
  12. package/adapters/examples/langgraph-reference-execution-adapter.js +81 -0
  13. package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +79 -0
  14. package/bin/xytara-first-run.js +244 -0
  15. package/bin/xytara.js +30 -5
  16. package/integrations/dispatch.js +7 -2
  17. package/integrations/registry.js +123 -2
  18. package/lib/activity_audit_contract.js +322 -0
  19. package/lib/adapter_depth_contract.js +156 -0
  20. package/lib/bolt_lane_contract.js +55 -0
  21. package/lib/bolt_payment_front.js +172 -0
  22. package/lib/capability_execution_truth.js +269 -0
  23. package/lib/capability_registry.js +39 -2
  24. package/lib/checkout_event_security.js +142 -0
  25. package/lib/command_flow.js +169 -36
  26. package/lib/commerce_artifacts.js +23 -4
  27. package/lib/commerce_checkout.js +134 -4
  28. package/lib/commerce_client.js +20 -0
  29. package/lib/commerce_economics.js +109 -9
  30. package/lib/commerce_runtime.js +38 -2
  31. package/lib/commerce_shell.js +4 -2
  32. package/lib/external_execution_runtime.js +132 -0
  33. package/lib/go_live_operator_pack.js +339 -0
  34. package/lib/http_transport.js +32 -0
  35. package/lib/integration_matrix_contract.js +6 -0
  36. package/lib/l402_lane_contract.js +55 -0
  37. package/lib/l402_payment_front.js +192 -0
  38. package/lib/network_transport.js +110 -0
  39. package/lib/operator_intelligence.js +215 -1
  40. package/lib/payment_config.js +80 -3
  41. package/lib/payment_front_registry.js +53 -0
  42. package/lib/payment_protocol_contract.js +165 -0
  43. package/lib/payment_verification.js +23 -3
  44. package/lib/pricing_optimization_contract.js +556 -0
  45. package/lib/release_history.js +15 -0
  46. package/lib/request_rate_limit.js +144 -0
  47. package/lib/runtime_bridge.js +10 -2
  48. package/lib/runtime_operations_worker.js +282 -0
  49. package/lib/settlement_bsv_live.js +79 -4
  50. package/lib/stripe_mpp_lane_contract.js +3 -0
  51. package/lib/stripe_mpp_payment_front.js +158 -0
  52. package/lib/treasury_destinations_contract.js +543 -0
  53. package/lib/treasury_egress_policy_contract.js +91 -0
  54. package/package.json +14 -21
  55. package/server.js +627 -88
  56. package/OPERATIONS_RUNBOOK.md +0 -66
  57. package/OPERATOR_START_HERE.md +0 -63
  58. package/PROGRAM_COMPLETE_RELEASE.md +0 -63
  59. package/PROGRAM_STATUS.md +0 -57
  60. package/PUBLISH_PLAN.md +0 -14
  61. package/RELEASE_CHECKLIST.md +0 -16
@@ -1,66 +0,0 @@
1
- # xytara Operations Runbook
2
-
3
- Use this runbook for the normal post-program operating posture.
4
-
5
- ## Daily checks
6
-
7
- Run:
8
-
9
- ```bash
10
- xytara-release --center --summary
11
- xytara-release --candidate --summary
12
- ```
13
-
14
- Inspect:
15
-
16
- - `/v1/release-center/summary`
17
- - `/v1/release-candidate/summary`
18
- - `/v1/runtime/durability`
19
-
20
- ## Runtime durability checks
21
-
22
- Healthy durability should show:
23
-
24
- - `enabled: true`
25
- - recoverable posture present
26
- - no active persistence blocker
27
-
28
- If you use hidden-account grants, credits, entitlements, or usage meters, durability is not optional.
29
-
30
- ## Release confidence checks
31
-
32
- Run:
33
-
34
- ```bash
35
- npm run verify:examples
36
- npm run verify:release-candidate
37
- npm run verify:production-readiness
38
- ```
39
-
40
- ## Partner-facing checks
41
-
42
- Keep these ready:
43
-
44
- - `PROGRAM_COMPLETE_RELEASE.md`
45
- - `PARTNER_READY_PATH.md`
46
- - `PUBLIC_DEMO_SCRIPT.md`
47
- - `CARRIED_HANDOFF_DEMO.md`
48
-
49
- ## If durability looks wrong
50
-
51
- Check in this order:
52
-
53
- 1. `/v1/runtime/durability`
54
- 2. persistence configuration
55
- 3. the most recent persisted timestamp
56
- 4. whether the last real grant/write advanced persistence state
57
-
58
- ## If an external adopter asks “where do I start?”
59
-
60
- Point them to:
61
-
62
- 1. `START_HERE.md`
63
- 2. `PARTNER_READY_PATH.md`
64
- 3. `PUBLIC_DEMO_SCRIPT.md`
65
-
66
- Do not send a raw dump of all docs first.
@@ -1,63 +0,0 @@
1
- # xytara Operator Start Here
2
-
3
- This is the shortest path for an operator who needs to evaluate `xytara` after the 10-phase program has already closed.
4
-
5
- ## 1. Confirm Terminal Program State
6
-
7
- Run:
8
-
9
- ```bash
10
- xytara-release --phases --summary
11
- xytara-release --phase-10 --summary
12
- ```
13
-
14
- Or inspect:
15
-
16
- - `GET /v1/phases/summary`
17
- - `GET /v1/phases/phase-10/gate/summary`
18
- - `GET /v1/phases/phase-10/completion/summary`
19
-
20
- ## 2. Confirm Release Posture
21
-
22
- Run:
23
-
24
- ```bash
25
- xytara-release --center --summary
26
- xytara-release --candidate --summary
27
- ```
28
-
29
- These are the fastest checks for "is the package live, coherent, and publish-shaped?"
30
-
31
- ## 3. Exercise The Runtime Path
32
-
33
- Run:
34
-
35
- ```bash
36
- node examples/quickstart.js
37
- ```
38
-
39
- This remains the fastest package-level execution story.
40
-
41
- ## 4. Verify Confidence
42
-
43
- Run:
44
-
45
- ```bash
46
- npm run verify:all
47
- npm run verify:release-candidate
48
- ```
49
-
50
- For the compact day-two operator path, also read:
51
-
52
- - `OPERATIONS_RUNBOOK.md`
53
-
54
- ## 5. Choose The Next Workstream
55
-
56
- After the program is closed, the next useful work is one of:
57
-
58
- - productization
59
- - real partner/internal integration
60
- - operational hardening
61
- - launch and release packaging
62
-
63
- If you only pick one, pick a real integration and keep the docs/productization work close behind it.
@@ -1,63 +0,0 @@
1
- # xytara Program-Complete Release
2
-
3
- `xytara` is no longer an in-flight phase build. The public 10-phase program is complete, and this repository now represents a release-shaped machine-commerce runtime.
4
-
5
- ## What is complete
6
-
7
- - the full phase program is closed
8
- - the default runtime path is stable
9
- - reusable credits and entitlements exist on the public spine
10
- - cross-repo handoff into `xoonya` is documented and runnable
11
- - operator and partner-facing docs now exist alongside the package
12
- - runtime durability is explicit instead of hidden
13
- - Supabase-backed durability is available when persistent disk is not
14
-
15
- ## What this release means
16
-
17
- This release is the point where `xytara` should be evaluated as a public runtime and commerce surface, not as an unfinished internal roadmap.
18
-
19
- The recommended evaluation path is now:
20
-
21
- 1. read `START_HERE.md`
22
- 2. run `node examples/quickstart.js`
23
- 3. run `node examples/partner_launch_walkthrough.js`
24
- 4. inspect `CARRIED_HANDOFF_DEMO.md`
25
- 5. inspect `PARTNER_READY_PATH.md`
26
-
27
- ## Public outcome
28
-
29
- An external builder should now be able to:
30
-
31
- - understand the runtime role quickly
32
- - run a first machine-commerce path locally
33
- - inspect release and launch posture through summary surfaces
34
- - understand partner adapter onboarding without private explanation
35
- - understand how proof-side followthrough continues into `xoonya`
36
-
37
- ## Operator outcome
38
-
39
- An operator should now be able to:
40
-
41
- - inspect runtime durability explicitly
42
- - verify release-candidate posture quickly
43
- - onboard generic external builders without writing one-off handoff notes
44
- - point durability-sensitive adopters to the correct persistence path
45
-
46
- ## Recommended live checks
47
-
48
- - `/v1/release-center/summary`
49
- - `/v1/release-candidate/summary`
50
- - `/v1/runtime/durability`
51
- - `/v1/adapter-partners/summary`
52
-
53
- ## Release rule
54
-
55
- Do not describe this repository as “phase-complete but still basically internal.”
56
-
57
- The correct external posture is:
58
-
59
- - program complete
60
- - runtime public
61
- - partner-ready
62
- - proof-aware
63
- - operationally inspectable
package/PROGRAM_STATUS.md DELETED
@@ -1,57 +0,0 @@
1
- # xytara Program Status
2
-
3
- `xytara` is no longer in an active milestone-build posture.
4
-
5
- The public phase program is complete and the runtime now sits in terminal closeout posture:
6
-
7
- - `current_phase: "program_closed"`
8
- - `completed_phase_count: 10`
9
- - `active_phase_count: 0`
10
- - Phase 10 decision: `ready_for_program_closeout`
11
-
12
- ## What Exists Now
13
-
14
- The live package now includes:
15
-
16
- - transaction discovery, quoting, execution, and lifecycle inspection
17
- - release-center and phase-program inspection surfaces
18
- - production-facing adapter onboarding and third-party registration material
19
- - multi-rail settlement and continuity surfaces through the full 10-phase program
20
- - machine-readable closeout state instead of an indefinitely open final phase
21
-
22
- ## Best Next Work
23
-
24
- The highest-value next work is no longer "add more phases."
25
-
26
- It is:
27
-
28
- 1. productization: tighten onboarding, examples, install paths, and first-contact docs
29
- 2. real integrations: wire 1-3 actual partner or internal use cases end to end
30
- 3. operational hardening: improve observability, deployment metadata, and operator audit posture
31
- 4. commercial packaging: prepare demos, launch collateral, and versioned release framing
32
-
33
- ## Operator Checks
34
-
35
- For a quick terminal-state inspection, use:
36
-
37
- ```bash
38
- xytara-release --phases --summary
39
- xytara-release --phase-10 --summary
40
- xytara-release --center --summary
41
- ```
42
-
43
- Or inspect the live HTTP surfaces:
44
-
45
- - `GET /v1/phases/summary`
46
- - `GET /v1/phases/phase-10/completion/summary`
47
- - `GET /v1/phases/phase-10/gate/summary`
48
- - `GET /v1/release-center/summary`
49
-
50
- ## Recommended Reading Order
51
-
52
- 1. [START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/START_HERE.md)
53
- 2. [README.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/README.md)
54
- 3. [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/FINAL_CONTRACT.md)
55
- 4. [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/SERVICE_CONTRACT.md)
56
- 5. [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PROGRAM_STATUS.md)
57
- 6. [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/CARRIED_HANDOFF_DEMO.md)
package/PUBLISH_PLAN.md DELETED
@@ -1,14 +0,0 @@
1
- # xytara Publish Plan
2
-
3
- 1. Run `npm run verify:release-candidate`.
4
- 2. Run `node examples/partner_launch_walkthrough.js`.
5
- 3. Run `npm pack --dry-run --json` and confirm the package contents.
6
- 4. Publish with `npm publish --access public`.
7
- 5. Redeploy the live service surfaces.
8
- 6. Verify:
9
- - `/v1/release-candidate/summary`
10
- - `/v1/release-center/summary`
11
- - `/v1/announcement-pack/summary`
12
- - `/v1/outreach-proof/summary`
13
- - `/v1/runtime/durability`
14
- 7. Run the first public machine proof path.
@@ -1,16 +0,0 @@
1
- # xytara Release Checklist
2
-
3
- 1. Run `npm run verify:release-candidate`.
4
- 2. Confirm `npm pack --dry-run --json` includes the public docs and both CLI entrypoints.
5
- 3. Run `node examples/partner_launch_walkthrough.js`.
6
- 3. Redeploy the service and verify:
7
- - `/v1/release-center/summary`
8
- - `/v1/announcement-pack/summary`
9
- - `/v1/outreach-proof/summary`
10
- - `/v1/runtime/durability`
11
- 4. Confirm the program-complete docs are packaged:
12
- - `PROGRAM_COMPLETE_RELEASE.md`
13
- - `WHY_XYTARA_XOONYA.md`
14
- - `PARTNER_READY_PATH.md`
15
- 5. Run the first public proof path.
16
- 6. Only then publish the npm package.