xoonya 2.1.0 → 2.2.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 (142) hide show
  1. package/CARRIED_HANDOFF_DEMO.md +60 -0
  2. package/EXAMPLE_PATHS.md +53 -0
  3. package/OPERATIONS_RUNBOOK.md +50 -0
  4. package/OPERATOR_START_HERE.md +67 -0
  5. package/PARTNER_READY_PATH.md +67 -0
  6. package/PROGRAM_COMPLETE_RELEASE.md +52 -0
  7. package/PROGRAM_STATUS.md +57 -0
  8. package/PUBLIC_DEMO_SCRIPT.md +79 -0
  9. package/PUBLISH_PLAN.md +7 -5
  10. package/README.md +27 -0
  11. package/RELEASE_CHECKLIST.md +8 -2
  12. package/RELEASE_NOTES.md +12 -3
  13. package/START_HERE.md +28 -0
  14. package/WHY_XYTARA_XOONYA.md +43 -0
  15. package/bin/xoonya-release.js +1181 -1
  16. package/examples/integration_boundary_walkthrough.js +37 -0
  17. package/examples/package_quickstart.js +1007 -0
  18. package/examples/partner_proof_walkthrough.js +68 -0
  19. package/examples/proof_review_walkthrough.js +66 -0
  20. package/examples/review_carried_handoff.js +72 -0
  21. package/lib/phase_10_closeout_pack.js +45 -0
  22. package/lib/phase_10_completion_pack.js +76 -0
  23. package/lib/phase_10_decision_record_pack.js +54 -0
  24. package/lib/phase_10_decision_resolution_pack.js +53 -0
  25. package/lib/phase_10_demand_signal_adapters_proof_pack.js +74 -0
  26. package/lib/phase_10_ecosystem_backlog_triage_proof_pack.js +74 -0
  27. package/lib/phase_10_freeze_baseline_pack.js +67 -0
  28. package/lib/phase_10_freeze_review_pack.js +64 -0
  29. package/lib/phase_10_gate_pack.js +57 -0
  30. package/lib/phase_10_long_tail_continuity_pack.js +80 -0
  31. package/lib/phase_10_long_tail_ecosystem_pack.js +68 -0
  32. package/lib/phase_10_niche_extension_registry_proof_pack.js +74 -0
  33. package/lib/phase_1_claude_mcp_pack.js +60 -0
  34. package/lib/phase_1_claude_mcp_proof_pack.js +57 -0
  35. package/lib/phase_1_ecosystem_pack.js +51 -0
  36. package/lib/phase_1_openai_codex_pack.js +60 -0
  37. package/lib/phase_1_openai_codex_proof_pack.js +57 -0
  38. package/lib/phase_2_base_proof_pack.js +71 -0
  39. package/lib/phase_2_base_usdc_proof_pack.js +72 -0
  40. package/lib/phase_2_closeout_pack.js +65 -0
  41. package/lib/phase_2_completion_pack.js +113 -0
  42. package/lib/phase_2_decision_record_pack.js +66 -0
  43. package/lib/phase_2_decision_resolution_pack.js +69 -0
  44. package/lib/phase_2_eth_proof_pack.js +70 -0
  45. package/lib/phase_2_evm_base_proof_pack.js +73 -0
  46. package/lib/phase_2_evm_proof_pack.js +71 -0
  47. package/lib/phase_2_flip_preview_pack.js +60 -0
  48. package/lib/phase_2_freeze_review_pack.js +99 -0
  49. package/lib/phase_2_gate_pack.js +77 -0
  50. package/lib/phase_2_payment_rails_pack.js +71 -0
  51. package/lib/phase_2_usdc_proof_pack.js +71 -0
  52. package/lib/phase_3_brc_proof_pack.js +81 -0
  53. package/lib/phase_3_bsv_teranode_proof_pack.js +81 -0
  54. package/lib/phase_3_closeout_pack.js +62 -0
  55. package/lib/phase_3_completion_pack.js +92 -0
  56. package/lib/phase_3_decision_record_pack.js +64 -0
  57. package/lib/phase_3_decision_resolution_pack.js +69 -0
  58. package/lib/phase_3_freeze_baseline_pack.js +67 -0
  59. package/lib/phase_3_freeze_review_pack.js +80 -0
  60. package/lib/phase_3_gate_pack.js +76 -0
  61. package/lib/phase_3_metanet_proof_pack.js +81 -0
  62. package/lib/phase_3_native_bsv_pack.js +89 -0
  63. package/lib/phase_3_native_continuity_pack.js +82 -0
  64. package/lib/phase_4_attestation_proof_pack.js +75 -0
  65. package/lib/phase_4_closeout_pack.js +45 -0
  66. package/lib/phase_4_completion_pack.js +82 -0
  67. package/lib/phase_4_decision_record_pack.js +54 -0
  68. package/lib/phase_4_decision_resolution_pack.js +45 -0
  69. package/lib/phase_4_erc8004_proof_pack.js +76 -0
  70. package/lib/phase_4_freeze_baseline_pack.js +67 -0
  71. package/lib/phase_4_freeze_review_pack.js +68 -0
  72. package/lib/phase_4_gate_pack.js +58 -0
  73. package/lib/phase_4_identity_registry_proof_pack.js +75 -0
  74. package/lib/phase_4_identity_trust_pack.js +73 -0
  75. package/lib/phase_4_trust_continuity_pack.js +86 -0
  76. package/lib/phase_5_antelope_proof_pack.js +76 -0
  77. package/lib/phase_5_closeout_pack.js +44 -0
  78. package/lib/phase_5_completion_pack.js +82 -0
  79. package/lib/phase_5_decision_record_pack.js +54 -0
  80. package/lib/phase_5_decision_resolution_pack.js +45 -0
  81. package/lib/phase_5_freeze_baseline_pack.js +67 -0
  82. package/lib/phase_5_freeze_review_pack.js +68 -0
  83. package/lib/phase_5_gate_pack.js +58 -0
  84. package/lib/phase_5_major_rails_continuity_pack.js +86 -0
  85. package/lib/phase_5_major_rails_pack.js +74 -0
  86. package/lib/phase_5_proton_xpr_proof_pack.js +76 -0
  87. package/lib/phase_5_solana_proof_pack.js +76 -0
  88. package/lib/phase_6_autogen_proof_pack.js +74 -0
  89. package/lib/phase_6_closeout_pack.js +46 -0
  90. package/lib/phase_6_completion_pack.js +77 -0
  91. package/lib/phase_6_decision_record_pack.js +54 -0
  92. package/lib/phase_6_decision_resolution_pack.js +53 -0
  93. package/lib/phase_6_framework_continuity_pack.js +81 -0
  94. package/lib/phase_6_framework_runtime_pack.js +68 -0
  95. package/lib/phase_6_freeze_baseline_pack.js +68 -0
  96. package/lib/phase_6_freeze_review_pack.js +65 -0
  97. package/lib/phase_6_gate_pack.js +59 -0
  98. package/lib/phase_6_langchain_proof_pack.js +74 -0
  99. package/lib/phase_6_langgraph_proof_pack.js +74 -0
  100. package/lib/phase_6_semantic_kernel_proof_pack.js +74 -0
  101. package/lib/phase_7_closeout_pack.js +45 -0
  102. package/lib/phase_7_completion_pack.js +85 -0
  103. package/lib/phase_7_decision_record_pack.js +53 -0
  104. package/lib/phase_7_decision_resolution_pack.js +53 -0
  105. package/lib/phase_7_event_system_continuity_pack.js +89 -0
  106. package/lib/phase_7_event_system_pack.js +76 -0
  107. package/lib/phase_7_freeze_baseline_pack.js +74 -0
  108. package/lib/phase_7_freeze_review_pack.js +65 -0
  109. package/lib/phase_7_gate_pack.js +58 -0
  110. package/lib/phase_7_kafka_proof_pack.js +76 -0
  111. package/lib/phase_7_mqtt_proof_pack.js +76 -0
  112. package/lib/phase_7_nats_proof_pack.js +76 -0
  113. package/lib/phase_7_webhook_event_bus_proof_pack.js +76 -0
  114. package/lib/phase_8_closeout_pack.js +46 -0
  115. package/lib/phase_8_completion_pack.js +82 -0
  116. package/lib/phase_8_decision_record_pack.js +54 -0
  117. package/lib/phase_8_decision_resolution_pack.js +53 -0
  118. package/lib/phase_8_external_receipt_import_proof_pack.js +74 -0
  119. package/lib/phase_8_external_result_import_proof_pack.js +74 -0
  120. package/lib/phase_8_freeze_baseline_pack.js +71 -0
  121. package/lib/phase_8_freeze_review_pack.js +64 -0
  122. package/lib/phase_8_gate_pack.js +58 -0
  123. package/lib/phase_8_proof_bridge_continuity_pack.js +86 -0
  124. package/lib/phase_8_proof_bridges_pack.js +72 -0
  125. package/lib/phase_8_proof_bundle_normalization_proof_pack.js +74 -0
  126. package/lib/phase_9_closeout_pack.js +46 -0
  127. package/lib/phase_9_completion_pack.js +82 -0
  128. package/lib/phase_9_custody_refs_proof_pack.js +74 -0
  129. package/lib/phase_9_decision_record_pack.js +54 -0
  130. package/lib/phase_9_decision_resolution_pack.js +53 -0
  131. package/lib/phase_9_freeze_baseline_pack.js +71 -0
  132. package/lib/phase_9_freeze_review_pack.js +64 -0
  133. package/lib/phase_9_gate_pack.js +58 -0
  134. package/lib/phase_9_operator_accounting_bridges_proof_pack.js +74 -0
  135. package/lib/phase_9_treasury_connectivity_pack.js +72 -0
  136. package/lib/phase_9_treasury_continuity_pack.js +86 -0
  137. package/lib/phase_9_treasury_destinations_proof_pack.js +74 -0
  138. package/lib/phase_program_pack.js +47 -0
  139. package/lib/release_center.js +924 -0
  140. package/lib/release_history.js +1 -1
  141. package/package.json +11 -1
  142. package/server.js +1652 -0
@@ -0,0 +1,60 @@
1
+ # xoonya Carried Handoff Demo
2
+
3
+ This is the shortest proof-side adoption story after the program closed.
4
+
5
+ The goal is to take a carried result-package handoff from `xytara`, inspect it, and prove it.
6
+
7
+ ## 1. Generate The Handoff In xytara
8
+
9
+ From the `xytara` repo root, run:
10
+
11
+ ```bash
12
+ node examples/export_carried_handoff.js
13
+ ```
14
+
15
+ That writes:
16
+
17
+ ```text
18
+ examples/generated.carried-handoff.json
19
+ ```
20
+
21
+ ## 2. Review It In xoonya
22
+
23
+ From the `xoonya` repo root, run:
24
+
25
+ ```bash
26
+ xoonya-review --file ../xytara/examples/generated.carried-handoff.json --summary
27
+ ```
28
+
29
+ This is the compact operator review path.
30
+
31
+ ## 3. Run The Proof-Side Example
32
+
33
+ To run the same carried handoff through the proof SDK:
34
+
35
+ ```bash
36
+ node examples/review_carried_handoff.js --file ../xytara/examples/generated.carried-handoff.json
37
+ ```
38
+
39
+ ## 4. Why This Matters
40
+
41
+ This is the highest-signal end-to-end adoption path now:
42
+
43
+ - runtime-side work ends in a portable handoff bundle
44
+ - proof-side review is explicit and inspectable
45
+ - proof-side continuation is deterministic instead of implicit
46
+
47
+ ## 5. Related Surfaces
48
+
49
+ Review:
50
+
51
+ - `POST /v1/proof-center/result-package-handoff/review`
52
+ - `POST /v1/proof-center/result-package-handoff/review/summary`
53
+
54
+ Run:
55
+
56
+ - `POST /v1/proof-center/result-package-handoff/run`
57
+
58
+ Guided CLI:
59
+
60
+ - `xoonya-review --file ./handoff.json --summary`
@@ -0,0 +1,53 @@
1
+ # xoonya Example Paths
2
+
3
+ These are the recommended public examples for `xoonya`.
4
+
5
+ ## Broad package tour
6
+
7
+ Run:
8
+
9
+ ```bash
10
+ node examples/package_quickstart.js
11
+ ```
12
+
13
+ Use this when you want the widest proof-package walkthrough.
14
+
15
+ ## Cross-repo carried handoff review
16
+
17
+ Run:
18
+
19
+ ```bash
20
+ node examples/review_carried_handoff.js
21
+ ```
22
+
23
+ Use this when you want the clearest carried runtime-to-proof path.
24
+
25
+ ## Partner proof walkthrough
26
+
27
+ Run:
28
+
29
+ ```bash
30
+ node examples/partner_proof_walkthrough.js
31
+ ```
32
+
33
+ Use this when you want the shortest launch oriented proof story.
34
+
35
+ ## Proof review walkthrough
36
+
37
+ Run:
38
+
39
+ ```bash
40
+ node examples/proof_review_walkthrough.js
41
+ ```
42
+
43
+ Use this when you want the compact result-package review path.
44
+
45
+ ## Integration boundary walkthrough
46
+
47
+ Run:
48
+
49
+ ```bash
50
+ node examples/integration_boundary_walkthrough.js
51
+ ```
52
+
53
+ Use this when you want the narrow proof-integration boundary rather than the full package tour.
@@ -0,0 +1,50 @@
1
+ # xoonya Operations Runbook
2
+
3
+ Use this runbook for the normal post-program proof-side operating posture.
4
+
5
+ ## Daily checks
6
+
7
+ Run:
8
+
9
+ ```bash
10
+ xoonya-release --center --summary
11
+ xoonya-release --candidate --summary
12
+ ```
13
+
14
+ Inspect:
15
+
16
+ - `/v1/release-center/summary`
17
+ - `/v1/release-candidate/summary`
18
+ - `/v1/proof-center/summary`
19
+
20
+ ## Proof-side confidence checks
21
+
22
+ Run:
23
+
24
+ ```bash
25
+ npm run verify:examples
26
+ npm run verify:release-candidate
27
+ ```
28
+
29
+ ## Handoff review checks
30
+
31
+ Keep these ready:
32
+
33
+ - `/v1/proof-center/result-package-handoff/review/summary`
34
+ - `CARRIED_HANDOFF_DEMO.md`
35
+ - `PARTNER_READY_PATH.md`
36
+ - `PUBLIC_DEMO_SCRIPT.md`
37
+
38
+ ## If an outside team asks “what belongs here?”
39
+
40
+ Point them to:
41
+
42
+ 1. `START_HERE.md`
43
+ 2. `PARTNER_READY_PATH.md`
44
+ 3. `integrations/PROOF_INTEGRATION_PROCESS.md`
45
+
46
+ ## Boundary rule
47
+
48
+ If a question depends on payment, funding, settlement, or workflow orchestration, move it back to `xytara`.
49
+
50
+ If it depends on reviewable proof carry and deterministic proof emission, it can stay in `xoonya`.
@@ -0,0 +1,67 @@
1
+ # xoonya Operator Start Here
2
+
3
+ This is the shortest path for an operator who needs to evaluate `xoonya` after the 10-phase program has already closed.
4
+
5
+ ## 1. Confirm Terminal Program State
6
+
7
+ Run:
8
+
9
+ ```bash
10
+ xoonya-release --phases --summary
11
+ xoonya-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
+ xoonya-release --center --summary
26
+ xoonya-release --candidate --summary
27
+ ```
28
+
29
+ These are the fastest checks for "is the proof package live, coherent, and publish-shaped?"
30
+
31
+ ## 3. Exercise The Proof Path
32
+
33
+ Run:
34
+
35
+ ```bash
36
+ node examples/package_quickstart.js
37
+ ```
38
+
39
+ For direct handoff review, also run:
40
+
41
+ ```bash
42
+ xoonya-review --file ./handoff.json --summary
43
+ ```
44
+
45
+ ## 4. Verify Confidence
46
+
47
+ Run:
48
+
49
+ ```bash
50
+ npm run verify:all
51
+ npm run verify:release-candidate
52
+ ```
53
+
54
+ For the compact day-two operator path, also read:
55
+
56
+ - `OPERATIONS_RUNBOOK.md`
57
+
58
+ ## 5. Choose The Next Workstream
59
+
60
+ After the program is closed, the next useful work is one of:
61
+
62
+ - productization
63
+ - real carried-handoff integration
64
+ - operational hardening
65
+ - launch and release packaging
66
+
67
+ If you only pick one, pick a real integration and keep the docs/productization work close behind it.
@@ -0,0 +1,67 @@
1
+ # xoonya Partner-Ready Path
2
+
3
+ Use this path when you want to evaluate `xoonya` as an external proof-side integration surface without relying on private milestone history.
4
+
5
+ ## What this path is for
6
+
7
+ This is the shortest partner-facing route for teams that need to:
8
+
9
+ - review the proof-side boundary after runtime execution
10
+ - understand what belongs in `xoonya` versus `xytara`
11
+ - confirm how proof-adjacent integrations stay narrow and reviewable
12
+ - leave with one concrete demo path, one proof contract path, and one lightweight integration path
13
+
14
+ ## Recommended reading order
15
+
16
+ 1. Read `START_HERE.md`.
17
+ 2. Read `CARRIED_HANDOFF_DEMO.md`.
18
+ 3. Read `CROSS_RUNTIME_POSTURE.md`.
19
+ 4. Read `integrations/PROOF_INTEGRATION_PROCESS.md`.
20
+ 5. Read `COMPATIBILITY_NOTE.md` if you need the narrower legacy bridge posture.
21
+
22
+ ## Recommended first commands
23
+
24
+ Run these from a cloned `xoonya` repository:
25
+
26
+ ```bash
27
+ node examples/package_quickstart.js
28
+ npm run verify:examples
29
+ npm run verify:release-candidate
30
+ node scripts/registry_cli.js validate-registration --example verifier
31
+ node scripts/registry_cli.js promotion-readiness --integration partner.verifier.lattice_notary
32
+ ```
33
+
34
+ ## Recommended first surfaces
35
+
36
+ - `/v1/release-center/summary`
37
+ - `/v1/proof-center/summary`
38
+ - `/v1/proof-center/result-package-handoff/summary`
39
+ - `/v1/integrations/summary`
40
+ - `/v1/integrations/promotion-readiness`
41
+
42
+ ## First success standard
43
+
44
+ First success is not "expand proof scope until it acts like the runtime."
45
+
46
+ First success is:
47
+
48
+ 1. receive one reviewable handoff from `xytara`
49
+ 2. inspect proof-side review posture
50
+ 3. emit one proof-native completion path
51
+ 4. validate one lightweight proof-adjacent integration boundary
52
+ 5. keep commerce, pricing, workflow, and settlement semantics outside the proof kernel
53
+
54
+ ## Boundary rule
55
+
56
+ If an integration needs pricing, funding, workflow orchestration, or settlement logic to make sense, it belongs in `xytara`.
57
+
58
+ If it can remain a narrow proof helper, registry reference, or verifier-facing addition, it can belong in `xoonya`.
59
+
60
+ ## Hand-off rule
61
+
62
+ If an outside team leaves this path with only four references, they should be these:
63
+
64
+ - `START_HERE.md`
65
+ - `CARRIED_HANDOFF_DEMO.md`
66
+ - `CROSS_RUNTIME_POSTURE.md`
67
+ - `integrations/PROOF_INTEGRATION_PROCESS.md`
@@ -0,0 +1,52 @@
1
+ # xoonya Program-Complete Release
2
+
3
+ `xoonya` is no longer an in-flight proof milestone. The public 10-phase program is complete, and this repository now represents a release-shaped proof system.
4
+
5
+ ## What is complete
6
+
7
+ - the full phase program is closed
8
+ - the canonical proof model is stable
9
+ - runtime-to-proof followthrough is documented and runnable
10
+ - proof-center, bridge, and governance surfaces are present
11
+ - operator and partner-facing docs now exist alongside the package
12
+ - proof-side integration posture is explicit and narrow
13
+
14
+ ## What this release means
15
+
16
+ This release is the point where `xoonya` should be evaluated as a public proof system, not as an unfinished internal proof kernel.
17
+
18
+ The recommended evaluation path is now:
19
+
20
+ 1. read `START_HERE.md`
21
+ 2. run `node examples/package_quickstart.js`
22
+ 3. run `node examples/partner_proof_walkthrough.js`
23
+ 4. inspect `CARRIED_HANDOFF_DEMO.md`
24
+ 5. inspect `PARTNER_READY_PATH.md`
25
+
26
+ ## Public outcome
27
+
28
+ An external builder should now be able to:
29
+
30
+ - understand the proof-side role quickly
31
+ - review one carried runtime handoff
32
+ - emit and verify proof-native completion
33
+ - understand the narrow proof-integration boundary without private guidance
34
+
35
+ ## Recommended live checks
36
+
37
+ - `/v1/release-center/summary`
38
+ - `/v1/proof-center/summary`
39
+ - `/v1/proof-center/result-package-handoff/review/summary`
40
+ - `/v1/integrations/promotion-readiness`
41
+
42
+ ## Release rule
43
+
44
+ Do not describe this repository as “proof support that still needs the rest of the roadmap.”
45
+
46
+ The correct external posture is:
47
+
48
+ - program complete
49
+ - proof public
50
+ - handoff-ready
51
+ - narrow by design
52
+ - reviewable by default
@@ -0,0 +1,57 @@
1
+ # xoonya Program Status
2
+
3
+ `xoonya` is no longer in an active milestone-build posture.
4
+
5
+ The public phase program is complete and the proof system 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
+ - proof-side review, run, and verification surfaces
17
+ - release-center and phase-program inspection surfaces
18
+ - cross-runtime handoff and proof-integration guidance
19
+ - proof continuity and governance surfaces through the full 10-phase program
20
+ - machine-readable terminal closeout 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 proof adoption docs
29
+ 2. real integrations: wire real carried handoff bundles from `xytara` or external systems
30
+ 3. operational hardening: improve operator audit posture, telemetry, and deployment checks
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
+ xoonya-release --phases --summary
39
+ xoonya-release --phase-10 --summary
40
+ xoonya-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/xoonya/START_HERE.md)
53
+ 2. [README.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/README.md)
54
+ 3. [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/FINAL_CONTRACT.md)
55
+ 4. [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/SERVICE_CONTRACT.md)
56
+ 5. [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_STATUS.md)
57
+ 6. [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
@@ -0,0 +1,79 @@
1
+ # xoonya Public Demo Script
2
+
3
+ Use this script when you need a short external-facing walkthrough of `xoonya` that does not depend on milestone history.
4
+
5
+ ## Goal
6
+
7
+ Show the proof side of the public stack in one compact flow:
8
+
9
+ 1. package is live
10
+ 2. proof center is understandable
11
+ 3. runtime handoff review is concrete
12
+ 4. proof-side integration posture is narrow and explicit
13
+
14
+ ## Recommended order
15
+
16
+ ### 1. Release posture
17
+
18
+ Run:
19
+
20
+ ```bash
21
+ xoonya-release --center --summary
22
+ xoonya-release --candidate --summary
23
+ ```
24
+
25
+ Or inspect:
26
+
27
+ - `/v1/release-center/summary`
28
+ - `/v1/release-candidate/summary`
29
+
30
+ ### 2. Proof center posture
31
+
32
+ Inspect:
33
+
34
+ - `/v1/proof-center/summary`
35
+ - `/v1/proof-center/result-package-handoff/review/summary`
36
+
37
+ Key sentence to say out loud:
38
+
39
+ `xoonya` is the proof-native completion layer, not a second runtime.
40
+
41
+ ### 3. Public proof walkthrough
42
+
43
+ Run:
44
+
45
+ ```bash
46
+ node examples/partner_proof_walkthrough.js
47
+ ```
48
+
49
+ Then, if you want the broader package tour:
50
+
51
+ ```bash
52
+ node examples/package_quickstart.js
53
+ ```
54
+
55
+ ### 4. Partner adoption path
56
+
57
+ Open:
58
+
59
+ - `PARTNER_READY_PATH.md`
60
+ - `integrations/PROOF_INTEGRATION_PROCESS.md`
61
+
62
+ Key sentence to say out loud:
63
+
64
+ Proof-adjacent integrations stay narrow and reviewable instead of absorbing commerce logic.
65
+
66
+ ### 5. Stack positioning
67
+
68
+ Open:
69
+
70
+ - `CARRIED_HANDOFF_DEMO.md`
71
+ - `WHY_XYTARA_XOONYA.md`
72
+
73
+ Key sentence to say out loud:
74
+
75
+ `xoonya` receives carry from `xytara`, reviews it, and emits deterministic proof-native completion.
76
+
77
+ ## Good ending line
78
+
79
+ `xoonya` is the public proof system: receive carry, review posture, emit proof, verify the final bundle.
package/PUBLISH_PLAN.md CHANGED
@@ -1,12 +1,14 @@
1
1
  # xoonya Publish Plan
2
2
 
3
3
  1. Run `npm run verify:release-candidate`.
4
- 2. Run `npm pack --dry-run --json` and confirm the package contents.
5
- 3. Publish with `npm publish --access public`.
6
- 4. Redeploy the live service surfaces.
7
- 5. Verify:
4
+ 2. Run `node examples/partner_proof_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:
8
9
  - `/v1/release-candidate/summary`
9
10
  - `/v1/release-center/summary`
10
11
  - `/v1/announcement-pack/summary`
11
12
  - `/v1/outreach-proof/summary`
12
- 6. Run the first public proof-side review path.
13
+ - `/v1/proof-center/summary`
14
+ 7. Run the first public proof-side review path.
package/README.md CHANGED
@@ -12,6 +12,8 @@ It exists to make machine evidence:
12
12
 
13
13
  This repo is the proof-side half of the final two-repo public stack. It focuses on canonical events, receipts, proof bundles, and verification. It does not own pricing, catalogs, workflow orchestration, payment rails, or settlement policy.
14
14
 
15
+ The 10-phase public program is now complete. `xoonya` is in terminal closeout posture rather than active milestone build posture.
16
+
15
17
  ## Start Here
16
18
 
17
19
  If you are new to the proof-side package, use this order:
@@ -21,6 +23,25 @@ If you are new to the proof-side package, use this order:
21
23
  3. run `npm run verify:all`
22
24
  4. use [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/FINAL_CONTRACT.md) and [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/SERVICE_CONTRACT.md) as the durable public contract
23
25
 
26
+ If you are evaluating the post-program operating posture, read:
27
+
28
+ - [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_STATUS.md)
29
+ - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/OPERATOR_START_HERE.md)
30
+ - [OPERATIONS_RUNBOOK.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/OPERATIONS_RUNBOOK.md)
31
+ - [PROGRAM_COMPLETE_RELEASE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_COMPLETE_RELEASE.md)
32
+ - [WHY_XYTARA_XOONYA.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/WHY_XYTARA_XOONYA.md)
33
+
34
+ If you want one concrete cross-repo adoption story, start with:
35
+
36
+ - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
37
+
38
+ If you want the shortest neutral external-adoption bundle, continue with:
39
+
40
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
41
+ - [PUBLIC_DEMO_SCRIPT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PUBLIC_DEMO_SCRIPT.md)
42
+ - [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/EXAMPLE_PATHS.md)
43
+ - `node examples/partner_proof_walkthrough.js`
44
+
24
45
  If you are integrating from outside the stack, also read:
25
46
 
26
47
  - [CROSS_RUNTIME_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CROSS_RUNTIME_POSTURE.md)
@@ -63,6 +84,10 @@ For release-grade adoption posture, inspect:
63
84
  - `GET /v1/release-center/summary`
64
85
  - `GET /v1/release-history`
65
86
  - `GET /v1/release-history/summary`
87
+ - `GET /v1/phases`
88
+ - `GET /v1/phases/summary`
89
+ - `GET /v1/phases/phase-1`
90
+ - `GET /v1/phases/phase-1/summary`
66
91
  - `GET /v1/publish-plan`
67
92
  - `GET /v1/publish-plan/summary`
68
93
  - `GET /v1/ecosystem-entry`
@@ -84,6 +109,8 @@ For release-grade adoption posture, inspect:
84
109
  - `xoonya-release --notes --summary`
85
110
  - `xoonya-release --center --summary`
86
111
  - `xoonya-release --history --summary`
112
+ - `xoonya-release --phases --summary`
113
+ - `xoonya-release --phase-1 --summary`
87
114
  - `xoonya-release --ecosystem --summary`
88
115
  - `xoonya-release --narrative --summary`
89
116
  - `xoonya-release --outreach-proof --summary`
@@ -2,9 +2,15 @@
2
2
 
3
3
  1. Run `npm run verify:release-candidate`.
4
4
  2. Confirm `npm pack --dry-run --json` includes the public docs and both CLI entrypoints.
5
+ 3. Run `node examples/partner_proof_walkthrough.js`.
5
6
  3. Redeploy the service and verify:
6
7
  - `/v1/release-center/summary`
7
8
  - `/v1/announcement-pack/summary`
8
9
  - `/v1/outreach-proof/summary`
9
- 4. Run the first public proof-side review path.
10
- 5. Only then publish the npm package.
10
+ - `/v1/proof-center/summary`
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-side review path.
16
+ 6. Only then publish the npm package.
package/RELEASE_NOTES.md CHANGED
@@ -1,6 +1,6 @@
1
- # xoonya 2.1.0 Release Notes
1
+ # xoonya 2.2.0 Release Notes
2
2
 
3
- `xoonya` 2.1.0 is the public proof-spine release-candidate line.
3
+ `xoonya` 2.2.0 is the public proof-spine program-complete line.
4
4
 
5
5
  Highlights:
6
6
 
@@ -10,10 +10,19 @@ Highlights:
10
10
  - canonical event, receipt, and proof-bundle model
11
11
  - bridge and governance surfaces for reviewable proof posture
12
12
  - stable runtime-to-proof followthrough
13
+ - partner-ready onboarding and launch docs
14
+ - clearer stack-positioning docs for why proof stays separate from runtime commerce
13
15
 
14
16
  Recommended first checks:
15
17
 
16
18
  1. `npm install xoonya`
17
19
  2. `xoonya-release --candidate --summary`
18
20
  3. `npm run verify:release-candidate`
19
- 4. inspect `/v1/release-candidate/summary` on the deployed service
21
+ 4. `node examples/partner_proof_walkthrough.js`
22
+ 5. inspect `/v1/release-candidate/summary` and `/v1/proof-center/summary` on the deployed service
23
+
24
+ Recommended first docs:
25
+
26
+ - `PROGRAM_COMPLETE_RELEASE.md`
27
+ - `WHY_XYTARA_XOONYA.md`
28
+ - `PARTNER_READY_PATH.md`
package/START_HERE.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  This is the shortest reliable path for understanding and using the public `xoonya` package in production-facing order.
4
4
 
5
+ The phase program is now complete, so this file is the right starting point for a closed and release-shaped proof system rather than an in-flight milestone build.
6
+
5
7
  ## 1. Understand The Role
6
8
 
7
9
  `xoonya` is the proof-side half of the public stack.
@@ -23,6 +25,17 @@ node examples/package_quickstart.js
23
25
 
24
26
  This is the fastest way to see the intended proof-side package story end-to-end.
25
27
 
28
+ If you want the clearest cross-repo adoption path instead of the broad package tour, continue with:
29
+
30
+ - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
31
+
32
+ If you want the shortest neutral external-adoption bundle, continue with:
33
+
34
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
35
+ - [PUBLIC_DEMO_SCRIPT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PUBLIC_DEMO_SCRIPT.md)
36
+ - [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/EXAMPLE_PATHS.md)
37
+ - `node examples/partner_proof_walkthrough.js`
38
+
26
39
  ## 3. Verify The Whole Package
27
40
 
28
41
  Run:
@@ -39,6 +52,13 @@ For long-term product understanding, read:
39
52
 
40
53
  - [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/FINAL_CONTRACT.md)
41
54
  - [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/SERVICE_CONTRACT.md)
55
+ - [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_STATUS.md)
56
+ - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/OPERATOR_START_HERE.md)
57
+ - [OPERATIONS_RUNBOOK.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/OPERATIONS_RUNBOOK.md)
58
+ - [PROGRAM_COMPLETE_RELEASE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_COMPLETE_RELEASE.md)
59
+ - [WHY_XYTARA_XOONYA.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/WHY_XYTARA_XOONYA.md)
60
+ - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
61
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
42
62
  - [TERMINOLOGY.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/TERMINOLOGY.md)
43
63
 
44
64
  ## 5. If You Are Integrating From Outside
@@ -47,6 +67,7 @@ Continue with:
47
67
 
48
68
  - [CROSS_RUNTIME_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CROSS_RUNTIME_POSTURE.md)
49
69
  - [integrations/PROOF_INTEGRATION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/integrations/PROOF_INTEGRATION_PROCESS.md)
70
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
50
71
  - [COMPATIBILITY_NOTE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/COMPATIBILITY_NOTE.md)
51
72
 
52
73
  ## 6. Production Reading Rule
@@ -58,3 +79,10 @@ The main public path is no longer "understand every proof helper first."
58
79
  It is:
59
80
 
60
81
  receive handoff -> inspect review posture -> confirm run posture -> emit and verify proof
82
+
83
+ ## 7. If You Are Operating The Closed Program
84
+
85
+ Use:
86
+
87
+ - [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_STATUS.md)
88
+ - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/OPERATOR_START_HERE.md)