@xenosystem/agent-sdk 0.9.11 → 0.9.13

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 (100) hide show
  1. package/LICENSE +15 -15
  2. package/README.md +511 -511
  3. package/dist/agents/index.cjs +5 -5
  4. package/dist/agents/index.js +15 -15
  5. package/dist/agents/metafile-cjs.json +1 -1
  6. package/dist/agents/metafile-esm.json +1 -1
  7. package/dist/artifacts/index.cjs +1 -1
  8. package/dist/artifacts/index.js +1 -1
  9. package/dist/artifacts/metafile-cjs.json +1 -1
  10. package/dist/artifacts/metafile-esm.json +1 -1
  11. package/dist/automation/index.d.cts +1 -0
  12. package/dist/automation/index.d.ts +1 -0
  13. package/dist/automation/metafile-cjs.json +1 -1
  14. package/dist/automation/metafile-esm.json +1 -1
  15. package/dist/control-plane/index.cjs +1 -1
  16. package/dist/control-plane/index.js +1 -1
  17. package/dist/control-plane/metafile-cjs.json +1 -1
  18. package/dist/control-plane/metafile-esm.json +1 -1
  19. package/dist/control-room/metafile-cjs.json +1 -1
  20. package/dist/control-room/metafile-esm.json +1 -1
  21. package/dist/electron/index.cjs +107 -107
  22. package/dist/electron/index.d.cts +1 -0
  23. package/dist/electron/index.d.ts +1 -0
  24. package/dist/electron/index.js +103 -103
  25. package/dist/electron/metafile-cjs.json +1 -1
  26. package/dist/electron/metafile-esm.json +1 -1
  27. package/dist/governance/index.cjs +18 -18
  28. package/dist/governance/index.d.cts +1 -0
  29. package/dist/governance/index.d.ts +1 -0
  30. package/dist/governance/index.js +18 -18
  31. package/dist/governance/metafile-cjs.json +1 -1
  32. package/dist/governance/metafile-esm.json +1 -1
  33. package/dist/hooks/metafile-cjs.json +1 -1
  34. package/dist/hooks/metafile-esm.json +1 -1
  35. package/dist/hosted/metafile-cjs.json +1 -1
  36. package/dist/hosted/metafile-esm.json +1 -1
  37. package/dist/index.cjs +231 -231
  38. package/dist/index.d.cts +8 -1
  39. package/dist/index.d.ts +8 -1
  40. package/dist/index.js +276 -276
  41. package/dist/intelligence/metafile-cjs.json +1 -1
  42. package/dist/intelligence/metafile-esm.json +1 -1
  43. package/dist/mcp/index.d.cts +1 -0
  44. package/dist/mcp/index.d.ts +1 -0
  45. package/dist/mcp/metafile-cjs.json +1 -1
  46. package/dist/mcp/metafile-esm.json +1 -1
  47. package/dist/metafile-cjs.json +1 -1
  48. package/dist/metafile-esm.json +1 -1
  49. package/dist/oracle/metafile-cjs.json +1 -1
  50. package/dist/oracle/metafile-esm.json +1 -1
  51. package/dist/providers/metafile-cjs.json +1 -1
  52. package/dist/providers/metafile-esm.json +1 -1
  53. package/dist/recipes/metafile-cjs.json +1 -1
  54. package/dist/recipes/metafile-esm.json +1 -1
  55. package/dist/research/metafile-cjs.json +1 -1
  56. package/dist/research/metafile-esm.json +1 -1
  57. package/dist/session/index.cjs +1 -1
  58. package/dist/session/index.d.cts +1 -0
  59. package/dist/session/index.d.ts +1 -0
  60. package/dist/session/index.js +1 -1
  61. package/dist/session/metafile-cjs.json +1 -1
  62. package/dist/session/metafile-esm.json +1 -1
  63. package/dist/sharing/metafile-cjs.json +1 -1
  64. package/dist/sharing/metafile-esm.json +1 -1
  65. package/dist/skills/index.d.cts +1 -0
  66. package/dist/skills/index.d.ts +1 -0
  67. package/dist/skills/metafile-cjs.json +1 -1
  68. package/dist/skills/metafile-esm.json +1 -1
  69. package/dist/soul/metafile-cjs.json +1 -1
  70. package/dist/soul/metafile-esm.json +1 -1
  71. package/dist/terminal/metafile-cjs.json +1 -1
  72. package/dist/terminal/metafile-esm.json +1 -1
  73. package/dist/ui/index.d.cts +1 -0
  74. package/dist/ui/index.d.ts +1 -0
  75. package/dist/ui/metafile-cjs.json +1 -1
  76. package/dist/ui/metafile-esm.json +1 -1
  77. package/dist/utils/index.d.cts +1 -0
  78. package/dist/utils/index.d.ts +1 -0
  79. package/dist/utils/metafile-cjs.json +1 -1
  80. package/dist/utils/metafile-esm.json +1 -1
  81. package/native/mxc/LICENSE.microsoft-mxc-sdk.md +20 -20
  82. package/native/mxc/README.md +25 -25
  83. package/native/mxc/package.json +58 -58
  84. package/ownership/CLEAN_ROOM_CONTRIBUTOR_GUIDE.md +63 -63
  85. package/ownership/evidence/PROPRIETARY-COMMAND-1/implementation-record.md +77 -77
  86. package/ownership/evidence/PROPRIETARY-COMMAND-1/provenance-review.md +51 -51
  87. package/ownership/evidence/PROPRIETARY-MEDIA-1/implementation-record.md +131 -131
  88. package/ownership/evidence/PROPRIETARY-MEDIA-1/provenance-review.md +50 -50
  89. package/ownership/evidence/PROPRIETARY-PTY-1/implementation-record.md +86 -86
  90. package/ownership/evidence/PROPRIETARY-PTY-1/provenance-review.md +52 -52
  91. package/ownership/evidence/PROPRIETARY-RUNTIME-1/implementation-record.md +68 -68
  92. package/ownership/evidence/PROPRIETARY-RUNTIME-1/provenance-review.md +32 -32
  93. package/ownership/evidence/PROPRIETARY-TOOLCHAIN-1/implementation-record.md +53 -53
  94. package/ownership/evidence/PROPRIETARY-TOOLCHAIN-1/provenance-review.md +32 -32
  95. package/ownership/evidence/PROPRIETARY-UI-1/implementation-record.md +96 -96
  96. package/ownership/evidence/PROPRIETARY-UI-1/provenance-review.md +46 -46
  97. package/ownership/ownership-policy.schema.json +192 -192
  98. package/ownership/templates/clean-room-implementation-record.md +70 -70
  99. package/ownership/templates/provenance-review.md +51 -51
  100. package/package.json +1 -1
@@ -1,25 +1,25 @@
1
- # Microsoft MXC native assets
2
-
3
- This directory contains only the seven release-reviewed executables needed by
4
- XENO's containment adapter and Windows host preparation. They were extracted from the integrity-pinned
5
- `@microsoft/mxc-sdk@0.7.0` npm artifact recorded in `package.json`.
6
-
7
- XENO does not execute or redistribute that package's JavaScript wrapper or its
8
- `node-pty`, `node-addon-api`, or `semver` dependency graph. Every executable is
9
- checked against both this manifest and the compiled XENO trust table before it
10
- can be probed or launched.
11
-
12
- The two `wxc-host-prep.exe` assets are invoked only by the explicit
13
- `prepareMxcWindowsHost()` setup API. They apply MXC's idempotent
14
- `prepare-system-drive` and `prepare-null-device` operations from an elevated
15
- host setup context; normal agent execution never attempts to elevate. Windows
16
- 11 on Arm runs the reviewed x64 host-preparation helper through the operating
17
- system's x64 emulation layer because these operations are architecture-neutral
18
- and MXC's ARM64 helper can stall while applying the system-drive metadata ACEs.
19
- The containment runtime itself remains the native ARM64 `wxc-exec.exe`.
20
-
21
- The original Microsoft MIT license is preserved in
22
- `LICENSE.microsoft-mxc-sdk.md`. Presence of these assets is not containment
23
- certification: XENO still requires a candidate-bound, platform-bound, signed
24
- certification and independent reviewer approval before advertising or using
25
- `contained` execution.
1
+ # Microsoft MXC native assets
2
+
3
+ This directory contains only the seven release-reviewed executables needed by
4
+ XENO's containment adapter and Windows host preparation. They were extracted from the integrity-pinned
5
+ `@microsoft/mxc-sdk@0.7.0` npm artifact recorded in `package.json`.
6
+
7
+ XENO does not execute or redistribute that package's JavaScript wrapper or its
8
+ `node-pty`, `node-addon-api`, or `semver` dependency graph. Every executable is
9
+ checked against both this manifest and the compiled XENO trust table before it
10
+ can be probed or launched.
11
+
12
+ The two `wxc-host-prep.exe` assets are invoked only by the explicit
13
+ `prepareMxcWindowsHost()` setup API. They apply MXC's idempotent
14
+ `prepare-system-drive` and `prepare-null-device` operations from an elevated
15
+ host setup context; normal agent execution never attempts to elevate. Windows
16
+ 11 on Arm runs the reviewed x64 host-preparation helper through the operating
17
+ system's x64 emulation layer because these operations are architecture-neutral
18
+ and MXC's ARM64 helper can stall while applying the system-drive metadata ACEs.
19
+ The containment runtime itself remains the native ARM64 `wxc-exec.exe`.
20
+
21
+ The original Microsoft MIT license is preserved in
22
+ `LICENSE.microsoft-mxc-sdk.md`. Presence of these assets is not containment
23
+ certification: XENO still requires a candidate-bound, platform-bound, signed
24
+ certification and independent reviewer approval before advertising or using
25
+ `contained` execution.
@@ -1,58 +1,58 @@
1
- {
2
- "name": "microsoft-mxc-native-assets",
3
- "version": "0.7.0",
4
- "private": true,
5
- "license": "MIT",
6
- "sourcePackage": {
7
- "name": "@microsoft/mxc-sdk",
8
- "version": "0.7.0",
9
- "integrity": "sha512-EWhz2pKkcPluZHAOI1yneV+JK0NO/3hdh7nABBb0x4PjyUWMeSWPTBAjtIu+BhtMYOqlaijSPZMZ0Hs/J4ZL4A==",
10
- "shasum": "561a269b8cb5a4eb7e71fc9158ffd0f74760b640"
11
- },
12
- "assets": [
13
- {
14
- "platform": "win32",
15
- "arch": "x64",
16
- "path": "bin/x64/wxc-exec.exe",
17
- "sha256": "db0a3422be9e1b396cc1b2547c70ff16b27412438a31c10a45abf370cac86ae2"
18
- },
19
- {
20
- "platform": "win32",
21
- "arch": "arm64",
22
- "path": "bin/arm64/wxc-exec.exe",
23
- "sha256": "e430d0e4f44f616e91db684f8d825a6dc93e06a1262b8d00bcaac7522a317aab"
24
- },
25
- {
26
- "platform": "win32",
27
- "arch": "x64",
28
- "purpose": "host-preparation",
29
- "path": "bin/x64/wxc-host-prep.exe",
30
- "sha256": "531fb3cdb4b0c964908fd71b71d40961417afb399cbab72f92a25e95309a6416"
31
- },
32
- {
33
- "platform": "win32",
34
- "arch": "arm64",
35
- "purpose": "host-preparation",
36
- "path": "bin/arm64/wxc-host-prep.exe",
37
- "sha256": "3ef702332286a39153fc259310b5021e3de3c191751d7522684f6475f73af5ef"
38
- },
39
- {
40
- "platform": "linux",
41
- "arch": "x64",
42
- "path": "bin/x64/lxc-exec",
43
- "sha256": "1efe3f817f5ae9ba9f9f2fd59142e79b2dde7a4dd024576b0ddb635fc87edeb5"
44
- },
45
- {
46
- "platform": "linux",
47
- "arch": "arm64",
48
- "path": "bin/arm64/lxc-exec",
49
- "sha256": "fdc00ccecf362ae3ddd8ccad93fd7c8b5b1f03c68897ab05ef1c9f1d327ea3fe"
50
- },
51
- {
52
- "platform": "darwin",
53
- "arch": "arm64",
54
- "path": "bin/arm64/mxc-exec-mac",
55
- "sha256": "77c07a86f483ed91dd5be290cd77878ac0c56fe113cdb8c764e7e5201c744ad2"
56
- }
57
- ]
58
- }
1
+ {
2
+ "name": "microsoft-mxc-native-assets",
3
+ "version": "0.7.0",
4
+ "private": true,
5
+ "license": "MIT",
6
+ "sourcePackage": {
7
+ "name": "@microsoft/mxc-sdk",
8
+ "version": "0.7.0",
9
+ "integrity": "sha512-EWhz2pKkcPluZHAOI1yneV+JK0NO/3hdh7nABBb0x4PjyUWMeSWPTBAjtIu+BhtMYOqlaijSPZMZ0Hs/J4ZL4A==",
10
+ "shasum": "561a269b8cb5a4eb7e71fc9158ffd0f74760b640"
11
+ },
12
+ "assets": [
13
+ {
14
+ "platform": "win32",
15
+ "arch": "x64",
16
+ "path": "bin/x64/wxc-exec.exe",
17
+ "sha256": "db0a3422be9e1b396cc1b2547c70ff16b27412438a31c10a45abf370cac86ae2"
18
+ },
19
+ {
20
+ "platform": "win32",
21
+ "arch": "arm64",
22
+ "path": "bin/arm64/wxc-exec.exe",
23
+ "sha256": "e430d0e4f44f616e91db684f8d825a6dc93e06a1262b8d00bcaac7522a317aab"
24
+ },
25
+ {
26
+ "platform": "win32",
27
+ "arch": "x64",
28
+ "purpose": "host-preparation",
29
+ "path": "bin/x64/wxc-host-prep.exe",
30
+ "sha256": "531fb3cdb4b0c964908fd71b71d40961417afb399cbab72f92a25e95309a6416"
31
+ },
32
+ {
33
+ "platform": "win32",
34
+ "arch": "arm64",
35
+ "purpose": "host-preparation",
36
+ "path": "bin/arm64/wxc-host-prep.exe",
37
+ "sha256": "3ef702332286a39153fc259310b5021e3de3c191751d7522684f6475f73af5ef"
38
+ },
39
+ {
40
+ "platform": "linux",
41
+ "arch": "x64",
42
+ "path": "bin/x64/lxc-exec",
43
+ "sha256": "1efe3f817f5ae9ba9f9f2fd59142e79b2dde7a4dd024576b0ddb635fc87edeb5"
44
+ },
45
+ {
46
+ "platform": "linux",
47
+ "arch": "arm64",
48
+ "path": "bin/arm64/lxc-exec",
49
+ "sha256": "fdc00ccecf362ae3ddd8ccad93fd7c8b5b1f03c68897ab05ef1c9f1d327ea3fe"
50
+ },
51
+ {
52
+ "platform": "darwin",
53
+ "arch": "arm64",
54
+ "path": "bin/arm64/mxc-exec-mac",
55
+ "sha256": "77c07a86f483ed91dd5be290cd77878ac0c56fe113cdb8c764e7e5201c744ad2"
56
+ }
57
+ ]
58
+ }
@@ -1,63 +1,63 @@
1
- # Xeno Clean-Room Contributor Guide
2
-
3
- Status: engineering control draft. Legal counsel approval is required before Xeno makes a public clean-room or proprietary-ownership claim.
4
-
5
- ## Purpose
6
-
7
- This guide governs replacement of third-party implementation code with independently authored Xeno code. It is an engineering provenance control, not legal advice and not proof by itself that a replacement is clean-room work.
8
-
9
- ## Required roles
10
-
11
- - The contract author records behavior from Xeno-owned tests, public standards, public API documentation, and black-box observations.
12
- - The implementer writes the replacement from the approved contract and declared normative sources.
13
- - The provenance reviewer independently reviews the implementation, evidence, and contributor disclosures.
14
- - Counsel determines whether contributor separation or additional review is required for a specific component.
15
-
16
- One person may not approve their own provenance review. High-risk native, codec, parser, and cryptographic work also requires a domain reviewer.
17
-
18
- ## Before implementation
19
-
20
- 1. Create a clean-room implementation record from `templates/clean-room-implementation-record.md`.
21
- 2. Freeze the required behavior and compatibility fixtures before reading implementation source from the component being replaced.
22
- 3. List every normative standard, public API document, Xeno-owned test, and black-box observation used.
23
- 4. Disclose whether each contributor previously inspected the replaced implementation source and when.
24
- 5. Obtain a written role/separation decision for contributors who inspected that source.
25
- 6. Record patents, trademarks, specification licenses, and export-control questions for counsel.
26
-
27
- ## Allowed inputs
28
-
29
- - Published standards whose terms permit the intended use.
30
- - Public API and user documentation used only to define observable behavior.
31
- - Xeno-owned requirements, tests, fixtures, traces, and interoperability captures.
32
- - Black-box behavior measured through a documented harness.
33
- - Operating-system and language-host API documentation for approved platform boundaries.
34
-
35
- ## Prohibited inputs and actions
36
-
37
- - Copying third-party source, comments, tests, identifiers, non-normative constants, or internal architecture.
38
- - Asking an AI model to translate, rewrite, disguise, or recreate third-party source.
39
- - Including third-party source in prompts, tickets, implementation records, fixtures, or generated-code context.
40
- - Claiming clean-room status when source-exposure disclosures or counsel review are incomplete.
41
- - Using a compatibility result as evidence of independent authorship.
42
-
43
- ## During implementation
44
-
45
- 1. Keep the implementation record current with design decisions and source citations.
46
- 2. Add conformance, malformed-input, resource-limit, and fuzz tests appropriate to the surface.
47
- 3. Record any behavior that differs from the frozen contract and obtain an explicit versioning decision.
48
- 4. Keep generated artifacts traceable to Xeno-owned source and the approved build process.
49
- 5. Stop and escalate if an undeclared source, copied fragment, or provenance ambiguity is discovered.
50
-
51
- AI-generated contributions follow the same rules. Prompts must request independent, standards-based implementation and must be retained or summarized in the implementation record without sensitive user data.
52
-
53
- ## Required completion evidence
54
-
55
- - Completed clean-room implementation record.
56
- - Completed independent provenance review.
57
- - Contributor source-exposure disclosures and counsel disposition.
58
- - Contract fixtures and conformance results.
59
- - Fuzz and security evidence where required.
60
- - Ownership inventory, bundle graph, native hashes, SBOM, and clean-install report for the candidate release.
61
- - Commit or source revision and reviewer identities.
62
-
63
- The ownership capability gate remains false until all required evidence exists and the designated reviewer signs the provenance record. Public ownership language additionally requires counsel and product approval.
1
+ # Xeno Clean-Room Contributor Guide
2
+
3
+ Status: engineering control draft. Legal counsel approval is required before Xeno makes a public clean-room or proprietary-ownership claim.
4
+
5
+ ## Purpose
6
+
7
+ This guide governs replacement of third-party implementation code with independently authored Xeno code. It is an engineering provenance control, not legal advice and not proof by itself that a replacement is clean-room work.
8
+
9
+ ## Required roles
10
+
11
+ - The contract author records behavior from Xeno-owned tests, public standards, public API documentation, and black-box observations.
12
+ - The implementer writes the replacement from the approved contract and declared normative sources.
13
+ - The provenance reviewer independently reviews the implementation, evidence, and contributor disclosures.
14
+ - Counsel determines whether contributor separation or additional review is required for a specific component.
15
+
16
+ One person may not approve their own provenance review. High-risk native, codec, parser, and cryptographic work also requires a domain reviewer.
17
+
18
+ ## Before implementation
19
+
20
+ 1. Create a clean-room implementation record from `templates/clean-room-implementation-record.md`.
21
+ 2. Freeze the required behavior and compatibility fixtures before reading implementation source from the component being replaced.
22
+ 3. List every normative standard, public API document, Xeno-owned test, and black-box observation used.
23
+ 4. Disclose whether each contributor previously inspected the replaced implementation source and when.
24
+ 5. Obtain a written role/separation decision for contributors who inspected that source.
25
+ 6. Record patents, trademarks, specification licenses, and export-control questions for counsel.
26
+
27
+ ## Allowed inputs
28
+
29
+ - Published standards whose terms permit the intended use.
30
+ - Public API and user documentation used only to define observable behavior.
31
+ - Xeno-owned requirements, tests, fixtures, traces, and interoperability captures.
32
+ - Black-box behavior measured through a documented harness.
33
+ - Operating-system and language-host API documentation for approved platform boundaries.
34
+
35
+ ## Prohibited inputs and actions
36
+
37
+ - Copying third-party source, comments, tests, identifiers, non-normative constants, or internal architecture.
38
+ - Asking an AI model to translate, rewrite, disguise, or recreate third-party source.
39
+ - Including third-party source in prompts, tickets, implementation records, fixtures, or generated-code context.
40
+ - Claiming clean-room status when source-exposure disclosures or counsel review are incomplete.
41
+ - Using a compatibility result as evidence of independent authorship.
42
+
43
+ ## During implementation
44
+
45
+ 1. Keep the implementation record current with design decisions and source citations.
46
+ 2. Add conformance, malformed-input, resource-limit, and fuzz tests appropriate to the surface.
47
+ 3. Record any behavior that differs from the frozen contract and obtain an explicit versioning decision.
48
+ 4. Keep generated artifacts traceable to Xeno-owned source and the approved build process.
49
+ 5. Stop and escalate if an undeclared source, copied fragment, or provenance ambiguity is discovered.
50
+
51
+ AI-generated contributions follow the same rules. Prompts must request independent, standards-based implementation and must be retained or summarized in the implementation record without sensitive user data.
52
+
53
+ ## Required completion evidence
54
+
55
+ - Completed clean-room implementation record.
56
+ - Completed independent provenance review.
57
+ - Contributor source-exposure disclosures and counsel disposition.
58
+ - Contract fixtures and conformance results.
59
+ - Fuzz and security evidence where required.
60
+ - Ownership inventory, bundle graph, native hashes, SBOM, and clean-install report for the candidate release.
61
+ - Commit or source revision and reviewer identities.
62
+
63
+ The ownership capability gate remains false until all required evidence exists and the designated reviewer signs the provenance record. Public ownership language additionally requires counsel and product approval.
@@ -1,77 +1,77 @@
1
- # Clean-Room Implementation Record: Xeno Command Runtime
2
-
3
- ## Identity
4
-
5
- - Component: Xeno-owned command schema, parser, help renderer, runner, discovery, and completion metadata
6
- - Replacement milestone: PROPRIETARY-COMMAND-1
7
- - Repository and paths: `xeno-agent-cli/apps/xeno-agent-cli/src/cli/`
8
- - Record owner: Xeno engineering, final owner assignment pending
9
- - Implementer(s): Codex implementation assistant; human engineering review pending
10
- - Contract author(s): Xeno engineering behavior capture; final attribution pending
11
- - Started at (UTC): 2026-07-12
12
- - Candidate revision: `87ae64b55aa1b8c2e126294e717b229e0945db65` plus recorded working-tree changes
13
- - Status: implementation complete; provenance approval pending
14
-
15
- ## Frozen behavioral contract
16
-
17
- - Public API and observable behavior: the 201-command Xeno command tree, option and argument metadata, help and usage output, aliases, defaults, action invocation, parent option access, typed errors, and completion/discovery data.
18
- - Compatibility fixtures: `tests/fixtures/command-runtime/commander-golden.json`, captured before the replacement runtime was selected.
19
- - Intentional incompatibilities and versioning decision: parse failures are typed and do not call `process.exit` below the top-level host boundary. No user-visible command or help incompatibility is accepted.
20
- - Security and resource limits: parsing is bounded by the supplied argument vector; suggestions use deterministic edit distance over declared flags and commands; no command text is evaluated.
21
- - Supported platforms and architectures: host-tokenized arguments on supported Node 20+ Windows, macOS, and Linux environments. Windows behavior has been exercised locally; cross-platform CI remains required.
22
-
23
- ## Normative and permitted inputs
24
-
25
- | Source | Revision/date | Purpose | Terms reviewed by | Evidence path |
26
- | --- | --- | --- | --- | --- |
27
- | Xeno proprietary migration specification | 2026-07-12 | Required command behavior and ownership constraints | Engineering; counsel pending | `switch-to-proprietary.md` |
28
- | Frozen Xeno command runtime fixture | schema version 2 | Black-box compatibility oracle for Xeno's public command surface | Engineering | `tests/fixtures/command-runtime/commander-golden.json` |
29
- | Xeno command declarations and handlers | candidate working tree | Names, arguments, options, descriptions, defaults, and action contracts | Engineering | `apps/xeno-agent-cli/src/index.ts`, `apps/xeno-agent-cli/src/commands/` |
30
- | Xeno-owned compatibility and fuzz tests | candidate working tree | Parser, runner, discovery, completion, and failure behavior | Engineering | `tests/command-runtime.test.ts` |
31
-
32
- ## Contributor source-exposure disclosure
33
-
34
- | Contributor | Inspected replaced source? | Date/range | Separation or review decision | Counsel reference |
35
- | --- | --- | --- | --- | --- |
36
- | Codex implementation assistant | No Commander implementation source was inspected during this implementation session. Work used Xeno declarations and the frozen black-box fixture. | 2026-07-12 | Independent provenance review required | Pending |
37
- | Human contributors | Disclosure not yet collected | Pending | Must be completed before capability approval | Pending |
38
-
39
- ## Implementation log
40
-
41
- | Date (UTC) | Decision | Contract/source basis | Author | Evidence path |
42
- | --- | --- | --- | --- | --- |
43
- | 2026-07-12 | Use a Xeno schema and parser with a migration builder facade | FR-020 through FR-025 | Codex implementation assistant | `apps/xeno-agent-cli/src/cli/` |
44
- | 2026-07-12 | Keep local and global option views separate | Existing Xeno handlers and action contract | Codex implementation assistant | `command-parser.ts`, `command-runner.ts` |
45
- | 2026-07-12 | Generate help, usage, discovery, and completion from one tree | FR-023 | Codex implementation assistant | `command-help.ts`, `command-completion.ts` |
46
- | 2026-07-12 | Reject Commander runtime residue during release verification | Phase 2 exit gate | Codex implementation assistant | `scripts/verify-release-package.mjs` |
47
-
48
- ## AI assistance
49
-
50
- - Models/tools used: OpenAI Codex coding agent and local PowerShell tooling.
51
- - Prompt or retained prompt-summary path: active Xeno proprietary migration goal and `switch-to-proprietary.md`.
52
- - Confirmation that no third-party source entered the prompt: no Commander source was supplied or inspected in this implementation session; only Xeno-owned command declarations and black-box output fixtures were used.
53
- - Human review performed: pending.
54
-
55
- ## Verification evidence
56
-
57
- - Unit and compatibility tests: `tests/command-runtime.test.ts`; all 201 frozen records match.
58
- - Conformance corpus: every production command help path and deterministic unknown-option path.
59
- - Fuzz campaign and duration: deterministic 20,000-case argument corpus completes in the focused test suite.
60
- - Security/resource-limit tests: typed parse failures, no lower-layer `process.exit`, conflicts, choices, mandatory options, implications, hidden commands.
61
- - Cross-platform results: Windows local pass; Linux and macOS CI pending.
62
- - Performance comparison: focused suite completes within normal test duration; formal benchmark pending.
63
- - Bundle/native/SBOM evidence: artifact ownership audit and paired clean-package smoke must be attached after candidate packaging.
64
-
65
- ## Open legal or provenance questions
66
-
67
- - Patents/specification terms: counsel review pending.
68
- - Trademarks: Commander name appears only as historical fixture provenance and development-toolchain inventory; counsel disposition pending.
69
- - Export or distribution constraints: none identified by engineering; counsel review pending.
70
- - Other: collect all human source-exposure disclosures and assign an independent reviewer.
71
-
72
- ## Handoff
73
-
74
- - Implementation complete: yes
75
- - Evidence complete: no
76
- - Ready for independent provenance review: after cross-platform and candidate-package evidence is attached
77
- - Author/date: Codex implementation assistant, 2026-07-12
1
+ # Clean-Room Implementation Record: Xeno Command Runtime
2
+
3
+ ## Identity
4
+
5
+ - Component: Xeno-owned command schema, parser, help renderer, runner, discovery, and completion metadata
6
+ - Replacement milestone: PROPRIETARY-COMMAND-1
7
+ - Repository and paths: `xeno-agent-cli/apps/xeno-agent-cli/src/cli/`
8
+ - Record owner: Xeno engineering, final owner assignment pending
9
+ - Implementer(s): Codex implementation assistant; human engineering review pending
10
+ - Contract author(s): Xeno engineering behavior capture; final attribution pending
11
+ - Started at (UTC): 2026-07-12
12
+ - Candidate revision: `87ae64b55aa1b8c2e126294e717b229e0945db65` plus recorded working-tree changes
13
+ - Status: implementation complete; provenance approval pending
14
+
15
+ ## Frozen behavioral contract
16
+
17
+ - Public API and observable behavior: the 201-command Xeno command tree, option and argument metadata, help and usage output, aliases, defaults, action invocation, parent option access, typed errors, and completion/discovery data.
18
+ - Compatibility fixtures: `tests/fixtures/command-runtime/commander-golden.json`, captured before the replacement runtime was selected.
19
+ - Intentional incompatibilities and versioning decision: parse failures are typed and do not call `process.exit` below the top-level host boundary. No user-visible command or help incompatibility is accepted.
20
+ - Security and resource limits: parsing is bounded by the supplied argument vector; suggestions use deterministic edit distance over declared flags and commands; no command text is evaluated.
21
+ - Supported platforms and architectures: host-tokenized arguments on supported Node 20+ Windows, macOS, and Linux environments. Windows behavior has been exercised locally; cross-platform CI remains required.
22
+
23
+ ## Normative and permitted inputs
24
+
25
+ | Source | Revision/date | Purpose | Terms reviewed by | Evidence path |
26
+ | --- | --- | --- | --- | --- |
27
+ | Xeno proprietary migration specification | 2026-07-12 | Required command behavior and ownership constraints | Engineering; counsel pending | `switch-to-proprietary.md` |
28
+ | Frozen Xeno command runtime fixture | schema version 2 | Black-box compatibility oracle for Xeno's public command surface | Engineering | `tests/fixtures/command-runtime/commander-golden.json` |
29
+ | Xeno command declarations and handlers | candidate working tree | Names, arguments, options, descriptions, defaults, and action contracts | Engineering | `apps/xeno-agent-cli/src/index.ts`, `apps/xeno-agent-cli/src/commands/` |
30
+ | Xeno-owned compatibility and fuzz tests | candidate working tree | Parser, runner, discovery, completion, and failure behavior | Engineering | `tests/command-runtime.test.ts` |
31
+
32
+ ## Contributor source-exposure disclosure
33
+
34
+ | Contributor | Inspected replaced source? | Date/range | Separation or review decision | Counsel reference |
35
+ | --- | --- | --- | --- | --- |
36
+ | Codex implementation assistant | No Commander implementation source was inspected during this implementation session. Work used Xeno declarations and the frozen black-box fixture. | 2026-07-12 | Independent provenance review required | Pending |
37
+ | Human contributors | Disclosure not yet collected | Pending | Must be completed before capability approval | Pending |
38
+
39
+ ## Implementation log
40
+
41
+ | Date (UTC) | Decision | Contract/source basis | Author | Evidence path |
42
+ | --- | --- | --- | --- | --- |
43
+ | 2026-07-12 | Use a Xeno schema and parser with a migration builder facade | FR-020 through FR-025 | Codex implementation assistant | `apps/xeno-agent-cli/src/cli/` |
44
+ | 2026-07-12 | Keep local and global option views separate | Existing Xeno handlers and action contract | Codex implementation assistant | `command-parser.ts`, `command-runner.ts` |
45
+ | 2026-07-12 | Generate help, usage, discovery, and completion from one tree | FR-023 | Codex implementation assistant | `command-help.ts`, `command-completion.ts` |
46
+ | 2026-07-12 | Reject Commander runtime residue during release verification | Phase 2 exit gate | Codex implementation assistant | `scripts/verify-release-package.mjs` |
47
+
48
+ ## AI assistance
49
+
50
+ - Models/tools used: OpenAI Codex coding agent and local PowerShell tooling.
51
+ - Prompt or retained prompt-summary path: active Xeno proprietary migration goal and `switch-to-proprietary.md`.
52
+ - Confirmation that no third-party source entered the prompt: no Commander source was supplied or inspected in this implementation session; only Xeno-owned command declarations and black-box output fixtures were used.
53
+ - Human review performed: pending.
54
+
55
+ ## Verification evidence
56
+
57
+ - Unit and compatibility tests: `tests/command-runtime.test.ts`; all 201 frozen records match.
58
+ - Conformance corpus: every production command help path and deterministic unknown-option path.
59
+ - Fuzz campaign and duration: deterministic 20,000-case argument corpus completes in the focused test suite.
60
+ - Security/resource-limit tests: typed parse failures, no lower-layer `process.exit`, conflicts, choices, mandatory options, implications, hidden commands.
61
+ - Cross-platform results: Windows local pass; Linux and macOS CI pending.
62
+ - Performance comparison: focused suite completes within normal test duration; formal benchmark pending.
63
+ - Bundle/native/SBOM evidence: artifact ownership audit and paired clean-package smoke must be attached after candidate packaging.
64
+
65
+ ## Open legal or provenance questions
66
+
67
+ - Patents/specification terms: counsel review pending.
68
+ - Trademarks: Commander name appears only as historical fixture provenance and development-toolchain inventory; counsel disposition pending.
69
+ - Export or distribution constraints: none identified by engineering; counsel review pending.
70
+ - Other: collect all human source-exposure disclosures and assign an independent reviewer.
71
+
72
+ ## Handoff
73
+
74
+ - Implementation complete: yes
75
+ - Evidence complete: no
76
+ - Ready for independent provenance review: after cross-platform and candidate-package evidence is attached
77
+ - Author/date: Codex implementation assistant, 2026-07-12
@@ -1,51 +1,51 @@
1
- # Independent Provenance Review: Xeno Command Runtime
2
-
3
- ## Review identity
4
-
5
- - Component: Xeno-owned command runtime
6
- - Replacement milestone: PROPRIETARY-COMMAND-1
7
- - Implementation record path: `ownership/evidence/PROPRIETARY-COMMAND-1/implementation-record.md`
8
- - Candidate revision: `87ae64b55aa1b8c2e126294e717b229e0945db65` plus recorded working-tree changes
9
- - Reviewer: pending
10
- - Domain reviewer (required): pending
11
- - Review date (UTC): pending
12
- - Reviewer independent of implementation: pending
13
-
14
- ## Evidence checks
15
-
16
- - [ ] Behavioral contract predates or is independent from implementation work.
17
- - [ ] Normative and public sources are listed with revisions and evidence paths.
18
- - [ ] Contributor source-exposure disclosures are complete.
19
- - [ ] Required separation/counsel decisions are attached.
20
- - [ ] No copied source, comments, tests, identifiers, non-normative constants, or distinctive internal structure were found.
21
- - [ ] AI inputs and human review satisfy the contributor guide.
22
- - [ ] Intentional incompatibilities are approved and versioned.
23
- - [ ] Conformance, malformed-input, security, resource-limit, and fuzz evidence meets the component gate.
24
- - [ ] Bundle graph, native hashes, SBOM, ownership inventory, and clean-install graph agree.
25
- - [ ] Licenses, patents, trademarks, and specification terms have an explicit disposition.
26
-
27
- ## Similarity and provenance review method
28
-
29
- - Files and revisions reviewed: pending
30
- - Comparison method and tools: pending
31
- - Findings: pending
32
- - False positives and disposition: pending
33
-
34
- ## Verification summary
35
-
36
- | Gate | Evidence | Result | Notes |
37
- | --- | --- | --- | --- |
38
- | Contract compatibility | `tests/fixtures/command-runtime/commander-golden.json`, `tests/command-runtime.test.ts` | engineering pass | Independent confirmation pending |
39
- | Security/resource limits | typed-error and bounded parser tests | engineering pass | Domain review pending |
40
- | Fuzz/conformance | deterministic 20,000-case corpus | engineering pass | Independent rerun pending |
41
- | Cross-platform | Windows local | partial | Linux and macOS CI pending |
42
- | Artifact ownership | ownership audit and package verifier | pending | Attach candidate reports |
43
-
44
- ## Decision
45
-
46
- - Engineering provenance decision: needs-work
47
- - Capability gate may be marked achieved: no
48
- - Public clean-room/proprietary claim approved by this review: no
49
- - Required follow-up: assign independent and domain reviewers, collect contributor disclosures, run cross-platform and package gates, attach counsel disposition.
50
- - Reviewer signature/date: pending
51
- - Counsel approval reference (required for public claim): pending
1
+ # Independent Provenance Review: Xeno Command Runtime
2
+
3
+ ## Review identity
4
+
5
+ - Component: Xeno-owned command runtime
6
+ - Replacement milestone: PROPRIETARY-COMMAND-1
7
+ - Implementation record path: `ownership/evidence/PROPRIETARY-COMMAND-1/implementation-record.md`
8
+ - Candidate revision: `87ae64b55aa1b8c2e126294e717b229e0945db65` plus recorded working-tree changes
9
+ - Reviewer: pending
10
+ - Domain reviewer (required): pending
11
+ - Review date (UTC): pending
12
+ - Reviewer independent of implementation: pending
13
+
14
+ ## Evidence checks
15
+
16
+ - [ ] Behavioral contract predates or is independent from implementation work.
17
+ - [ ] Normative and public sources are listed with revisions and evidence paths.
18
+ - [ ] Contributor source-exposure disclosures are complete.
19
+ - [ ] Required separation/counsel decisions are attached.
20
+ - [ ] No copied source, comments, tests, identifiers, non-normative constants, or distinctive internal structure were found.
21
+ - [ ] AI inputs and human review satisfy the contributor guide.
22
+ - [ ] Intentional incompatibilities are approved and versioned.
23
+ - [ ] Conformance, malformed-input, security, resource-limit, and fuzz evidence meets the component gate.
24
+ - [ ] Bundle graph, native hashes, SBOM, ownership inventory, and clean-install graph agree.
25
+ - [ ] Licenses, patents, trademarks, and specification terms have an explicit disposition.
26
+
27
+ ## Similarity and provenance review method
28
+
29
+ - Files and revisions reviewed: pending
30
+ - Comparison method and tools: pending
31
+ - Findings: pending
32
+ - False positives and disposition: pending
33
+
34
+ ## Verification summary
35
+
36
+ | Gate | Evidence | Result | Notes |
37
+ | --- | --- | --- | --- |
38
+ | Contract compatibility | `tests/fixtures/command-runtime/commander-golden.json`, `tests/command-runtime.test.ts` | engineering pass | Independent confirmation pending |
39
+ | Security/resource limits | typed-error and bounded parser tests | engineering pass | Domain review pending |
40
+ | Fuzz/conformance | deterministic 20,000-case corpus | engineering pass | Independent rerun pending |
41
+ | Cross-platform | Windows local | partial | Linux and macOS CI pending |
42
+ | Artifact ownership | ownership audit and package verifier | pending | Attach candidate reports |
43
+
44
+ ## Decision
45
+
46
+ - Engineering provenance decision: needs-work
47
+ - Capability gate may be marked achieved: no
48
+ - Public clean-room/proprietary claim approved by this review: no
49
+ - Required follow-up: assign independent and domain reviewers, collect contributor disclosures, run cross-platform and package gates, attach counsel disposition.
50
+ - Reviewer signature/date: pending
51
+ - Counsel approval reference (required for public claim): pending