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.
- package/.env.example +29 -0
- package/BSV_TERANODE_SETUP.md +43 -0
- package/README.md +66 -7
- package/REAL_PAYMENT_SETUP.md +61 -0
- package/RELEASE_NOTES.md +12 -6
- package/SERVICE_CONTRACT.md +31 -0
- package/START_HERE.md +107 -6
- package/TREASURY_DESTINATIONS.example.json +66 -0
- package/TREASURY_DESTINATIONS.production.template.json +108 -0
- package/adapters/examples/langchain-reference-execution-adapter.js +81 -0
- package/adapters/examples/langchain-reference-execution-adapter.manifest.json +79 -0
- package/adapters/examples/langgraph-reference-execution-adapter.js +81 -0
- package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +79 -0
- package/bin/xytara-first-run.js +244 -0
- package/bin/xytara.js +30 -5
- package/integrations/dispatch.js +7 -2
- package/integrations/registry.js +123 -2
- package/lib/activity_audit_contract.js +322 -0
- package/lib/adapter_depth_contract.js +156 -0
- package/lib/bolt_lane_contract.js +55 -0
- package/lib/bolt_payment_front.js +172 -0
- package/lib/capability_execution_truth.js +269 -0
- package/lib/capability_registry.js +39 -2
- package/lib/checkout_event_security.js +142 -0
- package/lib/command_flow.js +169 -36
- package/lib/commerce_artifacts.js +23 -4
- package/lib/commerce_checkout.js +134 -4
- package/lib/commerce_client.js +20 -0
- package/lib/commerce_economics.js +109 -9
- package/lib/commerce_runtime.js +38 -2
- package/lib/commerce_shell.js +4 -2
- package/lib/external_execution_runtime.js +132 -0
- package/lib/go_live_operator_pack.js +339 -0
- package/lib/http_transport.js +32 -0
- package/lib/integration_matrix_contract.js +6 -0
- package/lib/l402_lane_contract.js +55 -0
- package/lib/l402_payment_front.js +192 -0
- package/lib/network_transport.js +110 -0
- package/lib/operator_intelligence.js +215 -1
- package/lib/payment_config.js +80 -3
- package/lib/payment_front_registry.js +53 -0
- package/lib/payment_protocol_contract.js +165 -0
- package/lib/payment_verification.js +23 -3
- package/lib/pricing_optimization_contract.js +556 -0
- package/lib/release_history.js +15 -0
- package/lib/request_rate_limit.js +144 -0
- package/lib/runtime_bridge.js +10 -2
- package/lib/runtime_operations_worker.js +282 -0
- package/lib/settlement_bsv_live.js +79 -4
- package/lib/stripe_mpp_lane_contract.js +3 -0
- package/lib/stripe_mpp_payment_front.js +158 -0
- package/lib/treasury_destinations_contract.js +543 -0
- package/lib/treasury_egress_policy_contract.js +91 -0
- package/package.json +14 -21
- package/server.js +627 -88
- package/OPERATIONS_RUNBOOK.md +0 -66
- package/OPERATOR_START_HERE.md +0 -63
- package/PROGRAM_COMPLETE_RELEASE.md +0 -63
- package/PROGRAM_STATUS.md +0 -57
- package/PUBLISH_PLAN.md +0 -14
- package/RELEASE_CHECKLIST.md +0 -16
package/OPERATIONS_RUNBOOK.md
DELETED
|
@@ -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.
|
package/OPERATOR_START_HERE.md
DELETED
|
@@ -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.
|
package/RELEASE_CHECKLIST.md
DELETED
|
@@ -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.
|