@xenosystem/agent-sdk 0.9.0 → 0.9.8

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 (83) hide show
  1. package/LICENSE +15 -15
  2. package/README.md +511 -511
  3. package/dist/agents/metafile-cjs.json +1 -1
  4. package/dist/agents/metafile-esm.json +1 -1
  5. package/dist/artifacts/index.cjs +1 -1
  6. package/dist/artifacts/index.js +1 -1
  7. package/dist/artifacts/metafile-cjs.json +1 -1
  8. package/dist/artifacts/metafile-esm.json +1 -1
  9. package/dist/automation/metafile-cjs.json +1 -1
  10. package/dist/automation/metafile-esm.json +1 -1
  11. package/dist/control-plane/index.cjs +1 -1
  12. package/dist/control-plane/index.js +1 -1
  13. package/dist/control-plane/metafile-cjs.json +1 -1
  14. package/dist/control-plane/metafile-esm.json +1 -1
  15. package/dist/control-room/metafile-cjs.json +1 -1
  16. package/dist/control-room/metafile-esm.json +1 -1
  17. package/dist/electron/metafile-cjs.json +1 -1
  18. package/dist/electron/metafile-esm.json +1 -1
  19. package/dist/governance/metafile-cjs.json +1 -1
  20. package/dist/governance/metafile-esm.json +1 -1
  21. package/dist/hooks/metafile-cjs.json +1 -1
  22. package/dist/hooks/metafile-esm.json +1 -1
  23. package/dist/hosted/metafile-cjs.json +1 -1
  24. package/dist/hosted/metafile-esm.json +1 -1
  25. package/dist/index.cjs +1 -1
  26. package/dist/index.d.cts +1 -1
  27. package/dist/index.d.ts +1 -1
  28. package/dist/index.js +1 -1
  29. package/dist/intelligence/metafile-cjs.json +1 -1
  30. package/dist/intelligence/metafile-esm.json +1 -1
  31. package/dist/mcp/metafile-cjs.json +1 -1
  32. package/dist/mcp/metafile-esm.json +1 -1
  33. package/dist/metafile-cjs.json +1 -1
  34. package/dist/metafile-esm.json +1 -1
  35. package/dist/oracle/metafile-cjs.json +1 -1
  36. package/dist/oracle/metafile-esm.json +1 -1
  37. package/dist/providers/metafile-cjs.json +1 -1
  38. package/dist/providers/metafile-esm.json +1 -1
  39. package/dist/recipes/metafile-cjs.json +1 -1
  40. package/dist/recipes/metafile-esm.json +1 -1
  41. package/dist/research/metafile-cjs.json +1 -1
  42. package/dist/research/metafile-esm.json +1 -1
  43. package/dist/session/index.cjs +1 -1
  44. package/dist/session/index.js +1 -1
  45. package/dist/session/metafile-cjs.json +1 -1
  46. package/dist/session/metafile-esm.json +1 -1
  47. package/dist/sharing/metafile-cjs.json +1 -1
  48. package/dist/sharing/metafile-esm.json +1 -1
  49. package/dist/skills/metafile-cjs.json +1 -1
  50. package/dist/skills/metafile-esm.json +1 -1
  51. package/dist/soul/metafile-cjs.json +1 -1
  52. package/dist/soul/metafile-esm.json +1 -1
  53. package/dist/terminal/metafile-cjs.json +1 -1
  54. package/dist/terminal/metafile-esm.json +1 -1
  55. package/dist/ui/metafile-cjs.json +1 -1
  56. package/dist/ui/metafile-esm.json +1 -1
  57. package/dist/utils/metafile-cjs.json +1 -1
  58. package/dist/utils/metafile-esm.json +1 -1
  59. package/native/mxc/LICENSE.microsoft-mxc-sdk.md +20 -20
  60. package/native/mxc/README.md +25 -25
  61. package/native/mxc/bin/arm64/lxc-exec +0 -0
  62. package/native/mxc/bin/arm64/mxc-exec-mac +0 -0
  63. package/native/mxc/bin/x64/lxc-exec +0 -0
  64. package/native/mxc/package.json +58 -58
  65. package/ownership/CLEAN_ROOM_CONTRIBUTOR_GUIDE.md +63 -63
  66. package/ownership/audit.mjs +727 -727
  67. package/ownership/evidence/PROPRIETARY-COMMAND-1/implementation-record.md +77 -77
  68. package/ownership/evidence/PROPRIETARY-COMMAND-1/provenance-review.md +51 -51
  69. package/ownership/evidence/PROPRIETARY-MEDIA-1/implementation-record.md +131 -131
  70. package/ownership/evidence/PROPRIETARY-MEDIA-1/provenance-review.md +50 -50
  71. package/ownership/evidence/PROPRIETARY-PTY-1/implementation-record.md +86 -86
  72. package/ownership/evidence/PROPRIETARY-PTY-1/provenance-review.md +52 -52
  73. package/ownership/evidence/PROPRIETARY-RUNTIME-1/implementation-record.md +68 -68
  74. package/ownership/evidence/PROPRIETARY-RUNTIME-1/provenance-review.md +32 -32
  75. package/ownership/evidence/PROPRIETARY-TOOLCHAIN-1/implementation-record.md +53 -53
  76. package/ownership/evidence/PROPRIETARY-TOOLCHAIN-1/provenance-review.md +32 -32
  77. package/ownership/evidence/PROPRIETARY-UI-1/implementation-record.md +96 -96
  78. package/ownership/evidence/PROPRIETARY-UI-1/provenance-review.md +46 -46
  79. package/ownership/ownership-policy.json +273 -273
  80. package/ownership/ownership-policy.schema.json +192 -192
  81. package/ownership/templates/clean-room-implementation-record.md +70 -70
  82. package/ownership/templates/provenance-review.md +51 -51
  83. package/package.json +1 -1
@@ -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
@@ -1,131 +1,131 @@
1
- # Clean-Room Implementation Record: Xeno-Owned Media Stack
2
-
3
- ## Identity
4
-
5
- - Component: Xeno-owned zlib/DEFLATE, PNG, JPEG, GIF, VP8/VP8L WebP, image metadata/color, and secure SVG preview stack
6
- - Replacement milestone: PROPRIETARY-MEDIA-1
7
- - Repository and paths: `xeno-agent-sdk/src/media/`, `src/tools/read-image.ts`, `scripts/generate-vp8-tables.mjs`
8
- - Record owner: Xeno engineering, final owner assignment pending
9
- - Implementer(s): Codex implementation assistant; human codec/security review pending
10
- - Contract author(s): Xeno engineering requirements in `switch-to-proprietary.md`
11
- - Started at (UTC): 2026-07-12
12
- - Candidate revision: `a59066e477c904e077b1aceed8a65fa9c2767535` plus recorded working-tree changes
13
- - Status: engineering candidate complete for the documented SDK matrix; independent provenance, corpus/fuzz, counsel, and release gates pending
14
-
15
- ## Frozen behavioral contract
16
-
17
- - Capability matrix: `docs/owned-media-matrix.md` is the authoritative list of accepted profiles, deterministic policies, limits, and explicit rejections.
18
- - Compression: owned zlib/DEFLATE decode validates framing, final-block consumption, output limit, and Adler-32; deterministic zlib/gzip encode is owned.
19
- - PNG: every legal color-type/bit-depth family, all filters, Adam7, palette/transparency, bounded color metadata, Exif orientation, and deterministic RGB8 encode.
20
- - JPEG: Huffman baseline/progressive DCT, sampling, restart intervals, grayscale/RGB/YCbCr/CMYK/YCCK, and Exif orientation; unsupported coding modes reject.
21
- - GIF: GIF87a/GIF89a palettes, LZW, interlace, transparency, logical-canvas composition, delay, disposal, and loop metadata; preview policy is first rendered frame.
22
- - WebP: strict RIFF/VP8X, owned VP8 key-frame decode, VP8L, ALPH, bounded RGB matrix/TRC ICC, Exif, and validated first-frame animation composition.
23
- - SVG: bounded UTF-8 XML, paths/curves/arcs, transforms, simple CSS, gradients, clipping, masks, bounded local references, owned bitmap text, and supersampling.
24
- - Security: no external URL/entity/script/image/document load; byte, pixel, frame, recursion, path, node, sample, operation, and output limits.
25
- - Integration: ReadImage uses only owned media paths for supported bounded previews; no direct-compressed escape hatch is used when an owned decoder exists.
26
- - Intentional incompatibilities: unsupported profiles fail explicitly or follow the documented still/first-frame policy. The stack does not claim every JPEG/WebP/SVG extension.
27
-
28
- ## Normative and permitted inputs
29
-
30
- | Source | Revision/date | Purpose | Terms reviewed by | Evidence path |
31
- | --- | --- | --- | --- | --- |
32
- | Xeno proprietary migration specification | 2026-07-12 | Media ownership, compatibility, security, and release gates | Engineering; counsel pending | `switch-to-proprietary.md` |
33
- | RFC 1950, RFC 1951, RFC 1952 | published RFC revisions | zlib, DEFLATE, and gzip framing/bitstream behavior | Engineering; counsel pending | public RFC text |
34
- | W3C PNG Third Edition | accessed 2026-07-12 | PNG chunk, color, filtering, interlace, and error behavior | Engineering; counsel pending | `https://www.w3.org/TR/png-3/` |
35
- | ITU-T T.81 and T.871 | public recommendations | JPEG DCT/Huffman and JFIF behavior | Engineering; counsel pending | ITU public recommendations |
36
- | GIF89a specification | public specification | GIF blocks, LZW, interlace, control extensions, and animation | Engineering; counsel pending | public GIF89a text |
37
- | RFC 6386 | source SHA-256 `e89d0369d8e8c2ab0b080ef142bd27bebb2f228285ea34bd35d55b8e623d3259` | VP8 syntax, probabilities, prediction, transforms, and filtering | Engineering; counsel pending | generated-table source metadata |
38
- | Google WebP RIFF and lossless specifications | accessed 2026-07-12 | WebP container, VP8L, ALPH, metadata, and animation | Engineering; counsel pending | public Google specifications |
39
- | W3C SVG 2 and SVG Paths | accessed 2026-07-12 | vector geometry, transforms, rendering, gradients, clipping, masks, and text contract | Engineering; counsel pending | public W3C specifications |
40
- | Existing Xeno ReadImage contracts | candidate working tree | preview lifecycle, transport limits, private artifacts, and source immutability | Engineering | `src/tools/read-image.ts`, focused tests |
41
-
42
- ## Contributor source-exposure disclosure
43
-
44
- | Contributor | Inspected replaced source? | Date/range | Separation or review decision | Counsel reference |
45
- | --- | --- | --- | --- | --- |
46
- | Codex implementation assistant | No third-party codec implementation source was inspected. Public specifications and black-box oracle outputs were used. | 2026-07-12 | Independent source/provenance review required | Pending |
47
- | Codex implementation assistant | Xeno-owned sibling SVG files were inspected only to determine that they depended on browser DOM/canvas or were stubs; no source was copied into this implementation. | 2026-07-12 | Cross-repository Xeno ownership must be independently confirmed | Pending |
48
- | Human contributors | Disclosure not yet collected | Pending | Must be completed before capability approval | Pending |
49
-
50
- ## Implementation log
51
-
52
- | Date (UTC) | Decision | Contract/source basis | Author | Evidence path |
53
- | --- | --- | --- | --- | --- |
54
- | 2026-07-12 | Replace Node zlib with owned bounded DEFLATE/zlib/gzip logic | FR-052 | Codex implementation assistant | `src/media/xeno-deflate.ts` |
55
- | 2026-07-12 | Complete PNG profile and deterministic encode | FR-051 | Codex implementation assistant | `src/media/xeno-raster.ts`, `tests/xeno-png.test.mjs` |
56
- | 2026-07-12 | Implement baseline/progressive JPEG, Exif, CMYK, and YCCK | FR-053 | Codex implementation assistant | `src/media/xeno-jpeg.ts` |
57
- | 2026-07-12 | Implement full bounded GIF frame composition and first-frame policy | FR-054 | Codex implementation assistant | `src/media/xeno-gif.ts` |
58
- | 2026-07-12 | Generate normative VP8 tables from a pinned RFC hash and implement VP8 key-frame decode | FR-055 | Codex implementation assistant | `scripts/generate-vp8-tables.mjs`, `src/media/xeno-vp8*.ts` |
59
- | 2026-07-12 | Implement VP8L, ALPH, metadata, container validation, and first-frame animation | FR-055 | Codex implementation assistant | `src/media/xeno-webp.ts` |
60
- | 2026-07-12 | Add bounded RGB matrix/TRC ICC and shared Exif orientation | media color/metadata contract | Codex implementation assistant | `src/media/xeno-image-metadata.ts` |
61
- | 2026-07-12 | Replace the line-only SVG subset with the approved secure owned renderer | FR-056 through FR-058 | Codex implementation assistant | `src/media/xeno-svg.ts`, `src/media/xeno-svg-geometry.ts` |
62
- | 2026-07-12 | Remove stale direct-compressed claims and document exact profiles | FR-050 | Codex implementation assistant | `docs/owned-media-matrix.md`, README, tool description |
63
- | 2026-07-12 | Classify black-box oracle tools and external corpora while preserving production exclusion | ownership policy | Codex implementation assistant | ownership policy revision 10 |
64
- | 2026-07-12 | Audit and reject current `xeno-lib` media integration because its still-image/vector graph remains external-backed | cross-repository ownership gate | Codex implementation assistant | `docs/xeno-lib-media-boundary.md` |
65
- | 2026-07-12 | Run pinned external PNG/JPEG/WebP/SVG corpora and fix WebP unknown-chunk interoperability | media conformance and WebP RIFF specification | Codex implementation assistant | `docs/external-media-corpora.md`, `docs/compliance/external-media-corpora.json` |
66
- | 2026-07-12 | Run a deterministic 60-second external-corpus mutation campaign | media fuzz engineering gate | Codex implementation assistant | `scripts/fuzz-external-media.mjs`, `docs/compliance/external-media-fuzz.json` |
67
- | 2026-07-12 | Reacquire every pinned corpus, reproduce all digests/outcomes, and run a separate five-minute deterministic mutation campaign | sustained local media engineering evidence | Codex implementation assistant | `docs/compliance/external-media-fuzz-sustained.json` |
68
- | 2026-07-12 | Add a supervised V8 precise-coverage feedback loop with deterministic mutation, per-codec gates, current-case persistence, and tested idle/hard watchdogs across all nine claimed decoder paths | feedback-guided fuzz engineering gate | Codex implementation assistant | `scripts/fuzz-external-media-coverage*.mjs`, `tests/external-media-coverage-fuzz.test.mjs`, `docs/compliance/external-media-fuzz-coverage-sustained.json` |
69
-
70
- ## AI assistance and test-oracle use
71
-
72
- - Models/tools used: OpenAI Codex coding agent, local PowerShell, TypeScript, tsup, and Node test runner.
73
- - Prompt or retained prompt-summary path: active Xeno proprietary migration goal and `switch-to-proprietary.md`.
74
- - Black-box oracles: Node zlib, Pillow, ImageMagick, libwebp, and libvpx were used only to generate or compare isolated fixture outputs. Their implementations are not imported, linked, bundled, dynamically discovered, or invoked by production code.
75
- - Normative generation: RFC 6386 numeric tables are generated from a caller-supplied source with an exact pinned SHA-256. Reproduction on 2026-07-12 produced checked-in SHA-256 `89f8368f813f8c07cfb070c0c070d8ca1179d4051ca248e97de71125c2ca5d9e` byte-for-byte.
76
- - Confirmation that no third-party implementation entered the prompt: no codec source was supplied or inspected; oracle pixels/containers and public specification text were used.
77
- - Human review performed: pending.
78
-
79
- ## Verification evidence
80
-
81
- - Focused media/read-image/fuzz-supervisor gate: 69 passed, 0 failed after adding feedback-guided coverage and watchdog regressions.
82
- - External corpus engineering run: PNGSuite 60/60 accepted; libjpeg-turbo 2 supported images accepted and 2 documented unsupported profiles rejected; WebM Project WebP 130/131 accepted with the intentionally truncated vector rejected; all 525 unmodified W3C SVG files rejected at the secure-subset boundary. Exact per-file hashes and outcomes are recorded in `docs/compliance/external-media-corpora.json`.
83
- - External mutation engineering run: 48,334 iterations in 60 seconds across PNG/JPEG/WebP/SVG, zero output invariant failures, and peak RSS 302,944,256 bytes. This does not replace the independently approved sustained fuzz gate.
84
- - Independent corpus reacquisition rerun: exact upstream revisions plus W3C archive SHA reproduce all four recorded corpus digests and all 720 accepted/rejected outcomes with zero expectation failures.
85
- - Five-minute mutation engineering run: 279,559 iterations across PNG/JPEG/WebP/SVG, zero output invariant failures, and peak RSS 321,949,696 bytes. Report SHA-256 is `5d22c7acc275d6e43ec83feebc61e8576e048ee930eae735b7164565c456c604`. This remains deterministic engineering evidence, not independently approved coverage-guided fuzzing.
86
- - Five-minute feedback-guided engineering run: 78,978 mutations across PNG/JPEG/WebP/SVG/GIF/BMP/PBM/PGM/PPM, 1,415 unique executed owned-bundle ranges, 232 retained coverage-increasing inputs, zero output invariant failures, zero slow inputs, zero watchdog terminations, and 459,878,400-byte peak RSS. Report SHA-256 is `4fae930893f14e7170da85e9bc2e621f340cbc327f5c863fac3139b91113b018`; formal approval remains false pending independent threshold, sanitizer, corpus, and triage review.
87
- - Paired local SDK/CLI candidate tarballs passed clean installation, ownership parity, canvas exclusion, residue scan, packaged command/benchmark checks, and the owned preview doctor check before the strict verifier stopped on the unsigned PTY release gate. Candidate hashes and scope are in the CLI `docs/compliance/paired-package-candidate.md` record.
88
- - Full SDK regression: 501 passed, 2 platform-dependent skips, 0 failures.
89
- - Linked CLI integration: source and CLI typechecks pass, the CLI bundle builds, and Vitest reports 163 files with 1,490 passed, 1 skipped, and 0 failures.
90
- - Type verification: `npm run typecheck` and `npm run typecheck:tests` pass.
91
- - Ownership proof: artifact-inclusive SDK audit reports pre-P1, target P2, 823 component records, and 0 violations. Capability remains pre-P1 because P1 evidence gates are intentionally not approved.
92
- - Runtime exclusion scan: no `node:zlib`, canvas package, resvg, sharp, Jimp, React DOM, or equivalent media fallback in the scanned SDK production source/manifest/lock graph.
93
- - Source hashes:
94
- - `xeno-deflate.ts`: `61badde76048cba77a432a9a1e737de4fe49ffd6b877833b76062133851b0ae3`
95
- - `xeno-raster.ts`: `6a7069fdd3dc6c4045feff36731fdf942fdaba71876b95b19cc8b2db49fc3ec6`
96
- - `xeno-image-metadata.ts`: `544e1b8e14b30c1948a79887495077727fea62cbcea118edf3a108ebf8cf7973`
97
- - `xeno-jpeg.ts`: `ad57118e4d35c29d8c5bb69f98b0be0f2442f500dc78cdf14f1f5e9330001280`
98
- - `xeno-gif.ts`: `bda46489a77176b7ef910ab980b19468ea21a581db44333e71899495120998be`
99
- - `xeno-vp8.ts`: `e0808f97bc9c2c727fc22e91fc0c7660b0b2ebd597bb44593a7afd43975fca07`
100
- - `xeno-vp8-tables.ts`: `89f8368f813f8c07cfb070c0c070d8ca1179d4051ca248e97de71125c2ca5d9e`
101
- - `xeno-webp.ts`: `54f65311182391c67759361b49a7ab2b8cd744ce9034bdc1ee6b88b33b0faee3`
102
- - `xeno-svg-geometry.ts`: `89fcbc0ddf7ae852cfa9f7c0323ff3da7e510a4581288c76c40060ae80abbcb0`
103
- - `xeno-svg.ts`: `edc1f03f20208efd26fa3a40afff039fccfe87936d1b5a60fb8b5a9c60eab638`
104
- - `generate-vp8-tables.mjs`: `00ce9cac50fcf6e12a059da6a0744cb807e9dbda0c4e3d2df93ca9b634d1f9e4`
105
- - `run-external-media-corpora.mjs`: `5e4c9910cd5fc403d331b5ca382b100cb367f0008c8f5275106e73301541232c`
106
- - `external-media-corpora.json`: `a98533c06ff3929cc7b4d961739536f7f7532ad6583429f948c9f5e0c2477084`
107
- - `fuzz-external-media.mjs`: `0c3dc2c1baf15b8325fc7b9692485947e28521269c4304289883c1b025584072`
108
- - `external-media-fuzz.json`: `a2c4e32e9ebc914595d300636538d5f6a36f786b10b8cbff1374c71f444510cd`
109
- - `external-media-fuzz-sustained.json`: `5d22c7acc275d6e43ec83feebc61e8576e048ee930eae735b7164565c456c604`
110
- - `read-image.ts`: `151f009e882bd561345d380df204e8b8add56db081e89ee09d1b234f649e28e2`
111
- - `fuzz-external-media-coverage.mjs`: `14e383b65995ab3f942c0411e070843cd18c16999373c9943bff1141c76d0fcd`
112
- - `fuzz-external-media-coverage-worker.mjs`: `fd557232dc38ea6b2ce6b95f79cde983f417d35bb49ecf39383f9b1f1d3f6636`
113
- - `external-media-fuzz-coverage-sustained.json`: `4fae930893f14e7170da85e9bc2e621f340cbc327f5c863fac3139b91113b018`
114
-
115
- ## Open legal, provenance, and engineering questions
116
-
117
- - Independent clean-room/source-structure review is pending.
118
- - Contributor source-exposure disclosures and counsel disposition are pending.
119
- - JPEG, GIF history, VP8/WebP, ICC, DEFLATE, SVG/font rendering, and specification-table rights require counsel review before public claims.
120
- - The committed tests plus deterministic and feedback-guided five-minute campaigns are not self-approving evidence; independent reviewers must approve coverage/duration thresholds, native sanitizer and release-architecture scope, corpus terms, and triage policy.
121
- - Pinned external corpora are selected, classified, hashed, and run for engineering evidence, but their terms/counsel disposition, independent rerun, pixel-oracle comparisons, and an approved secure-SVG subset corpus remain pending.
122
- - ARM, macOS, signed release, and self-contained-product artifact coverage remain outside this engineering record. A local paired npm clean-install audit reached only the expected unsigned-PTY blocker and is not a completed release gate.
123
- - `xeno-lib` reconciliation is decided and documented in `docs/xeno-lib-media-boundary.md`: its current `image` and `vtracer` bootstrap-engine graph is not accepted as a production owner. Future integration remains gated on a separately proprietary graph and full cross-repository evidence.
124
-
125
- ## Handoff
126
-
127
- - Engineering implementation complete for documented SDK matrix: yes
128
- - Evidence complete: no
129
- - Capability gate may be marked achieved: no
130
- - Ready for independent provenance review: yes, after corpus licensing/classification and contributor disclosure collection
131
- - Author/date: Codex implementation assistant, 2026-07-12
1
+ # Clean-Room Implementation Record: Xeno-Owned Media Stack
2
+
3
+ ## Identity
4
+
5
+ - Component: Xeno-owned zlib/DEFLATE, PNG, JPEG, GIF, VP8/VP8L WebP, image metadata/color, and secure SVG preview stack
6
+ - Replacement milestone: PROPRIETARY-MEDIA-1
7
+ - Repository and paths: `xeno-agent-sdk/src/media/`, `src/tools/read-image.ts`, `scripts/generate-vp8-tables.mjs`
8
+ - Record owner: Xeno engineering, final owner assignment pending
9
+ - Implementer(s): Codex implementation assistant; human codec/security review pending
10
+ - Contract author(s): Xeno engineering requirements in `switch-to-proprietary.md`
11
+ - Started at (UTC): 2026-07-12
12
+ - Candidate revision: `a59066e477c904e077b1aceed8a65fa9c2767535` plus recorded working-tree changes
13
+ - Status: engineering candidate complete for the documented SDK matrix; independent provenance, corpus/fuzz, counsel, and release gates pending
14
+
15
+ ## Frozen behavioral contract
16
+
17
+ - Capability matrix: `docs/owned-media-matrix.md` is the authoritative list of accepted profiles, deterministic policies, limits, and explicit rejections.
18
+ - Compression: owned zlib/DEFLATE decode validates framing, final-block consumption, output limit, and Adler-32; deterministic zlib/gzip encode is owned.
19
+ - PNG: every legal color-type/bit-depth family, all filters, Adam7, palette/transparency, bounded color metadata, Exif orientation, and deterministic RGB8 encode.
20
+ - JPEG: Huffman baseline/progressive DCT, sampling, restart intervals, grayscale/RGB/YCbCr/CMYK/YCCK, and Exif orientation; unsupported coding modes reject.
21
+ - GIF: GIF87a/GIF89a palettes, LZW, interlace, transparency, logical-canvas composition, delay, disposal, and loop metadata; preview policy is first rendered frame.
22
+ - WebP: strict RIFF/VP8X, owned VP8 key-frame decode, VP8L, ALPH, bounded RGB matrix/TRC ICC, Exif, and validated first-frame animation composition.
23
+ - SVG: bounded UTF-8 XML, paths/curves/arcs, transforms, simple CSS, gradients, clipping, masks, bounded local references, owned bitmap text, and supersampling.
24
+ - Security: no external URL/entity/script/image/document load; byte, pixel, frame, recursion, path, node, sample, operation, and output limits.
25
+ - Integration: ReadImage uses only owned media paths for supported bounded previews; no direct-compressed escape hatch is used when an owned decoder exists.
26
+ - Intentional incompatibilities: unsupported profiles fail explicitly or follow the documented still/first-frame policy. The stack does not claim every JPEG/WebP/SVG extension.
27
+
28
+ ## Normative and permitted inputs
29
+
30
+ | Source | Revision/date | Purpose | Terms reviewed by | Evidence path |
31
+ | --- | --- | --- | --- | --- |
32
+ | Xeno proprietary migration specification | 2026-07-12 | Media ownership, compatibility, security, and release gates | Engineering; counsel pending | `switch-to-proprietary.md` |
33
+ | RFC 1950, RFC 1951, RFC 1952 | published RFC revisions | zlib, DEFLATE, and gzip framing/bitstream behavior | Engineering; counsel pending | public RFC text |
34
+ | W3C PNG Third Edition | accessed 2026-07-12 | PNG chunk, color, filtering, interlace, and error behavior | Engineering; counsel pending | `https://www.w3.org/TR/png-3/` |
35
+ | ITU-T T.81 and T.871 | public recommendations | JPEG DCT/Huffman and JFIF behavior | Engineering; counsel pending | ITU public recommendations |
36
+ | GIF89a specification | public specification | GIF blocks, LZW, interlace, control extensions, and animation | Engineering; counsel pending | public GIF89a text |
37
+ | RFC 6386 | source SHA-256 `e89d0369d8e8c2ab0b080ef142bd27bebb2f228285ea34bd35d55b8e623d3259` | VP8 syntax, probabilities, prediction, transforms, and filtering | Engineering; counsel pending | generated-table source metadata |
38
+ | Google WebP RIFF and lossless specifications | accessed 2026-07-12 | WebP container, VP8L, ALPH, metadata, and animation | Engineering; counsel pending | public Google specifications |
39
+ | W3C SVG 2 and SVG Paths | accessed 2026-07-12 | vector geometry, transforms, rendering, gradients, clipping, masks, and text contract | Engineering; counsel pending | public W3C specifications |
40
+ | Existing Xeno ReadImage contracts | candidate working tree | preview lifecycle, transport limits, private artifacts, and source immutability | Engineering | `src/tools/read-image.ts`, focused tests |
41
+
42
+ ## Contributor source-exposure disclosure
43
+
44
+ | Contributor | Inspected replaced source? | Date/range | Separation or review decision | Counsel reference |
45
+ | --- | --- | --- | --- | --- |
46
+ | Codex implementation assistant | No third-party codec implementation source was inspected. Public specifications and black-box oracle outputs were used. | 2026-07-12 | Independent source/provenance review required | Pending |
47
+ | Codex implementation assistant | Xeno-owned sibling SVG files were inspected only to determine that they depended on browser DOM/canvas or were stubs; no source was copied into this implementation. | 2026-07-12 | Cross-repository Xeno ownership must be independently confirmed | Pending |
48
+ | Human contributors | Disclosure not yet collected | Pending | Must be completed before capability approval | Pending |
49
+
50
+ ## Implementation log
51
+
52
+ | Date (UTC) | Decision | Contract/source basis | Author | Evidence path |
53
+ | --- | --- | --- | --- | --- |
54
+ | 2026-07-12 | Replace Node zlib with owned bounded DEFLATE/zlib/gzip logic | FR-052 | Codex implementation assistant | `src/media/xeno-deflate.ts` |
55
+ | 2026-07-12 | Complete PNG profile and deterministic encode | FR-051 | Codex implementation assistant | `src/media/xeno-raster.ts`, `tests/xeno-png.test.mjs` |
56
+ | 2026-07-12 | Implement baseline/progressive JPEG, Exif, CMYK, and YCCK | FR-053 | Codex implementation assistant | `src/media/xeno-jpeg.ts` |
57
+ | 2026-07-12 | Implement full bounded GIF frame composition and first-frame policy | FR-054 | Codex implementation assistant | `src/media/xeno-gif.ts` |
58
+ | 2026-07-12 | Generate normative VP8 tables from a pinned RFC hash and implement VP8 key-frame decode | FR-055 | Codex implementation assistant | `scripts/generate-vp8-tables.mjs`, `src/media/xeno-vp8*.ts` |
59
+ | 2026-07-12 | Implement VP8L, ALPH, metadata, container validation, and first-frame animation | FR-055 | Codex implementation assistant | `src/media/xeno-webp.ts` |
60
+ | 2026-07-12 | Add bounded RGB matrix/TRC ICC and shared Exif orientation | media color/metadata contract | Codex implementation assistant | `src/media/xeno-image-metadata.ts` |
61
+ | 2026-07-12 | Replace the line-only SVG subset with the approved secure owned renderer | FR-056 through FR-058 | Codex implementation assistant | `src/media/xeno-svg.ts`, `src/media/xeno-svg-geometry.ts` |
62
+ | 2026-07-12 | Remove stale direct-compressed claims and document exact profiles | FR-050 | Codex implementation assistant | `docs/owned-media-matrix.md`, README, tool description |
63
+ | 2026-07-12 | Classify black-box oracle tools and external corpora while preserving production exclusion | ownership policy | Codex implementation assistant | ownership policy revision 10 |
64
+ | 2026-07-12 | Audit and reject current `xeno-lib` media integration because its still-image/vector graph remains external-backed | cross-repository ownership gate | Codex implementation assistant | `docs/xeno-lib-media-boundary.md` |
65
+ | 2026-07-12 | Run pinned external PNG/JPEG/WebP/SVG corpora and fix WebP unknown-chunk interoperability | media conformance and WebP RIFF specification | Codex implementation assistant | `docs/external-media-corpora.md`, `docs/compliance/external-media-corpora.json` |
66
+ | 2026-07-12 | Run a deterministic 60-second external-corpus mutation campaign | media fuzz engineering gate | Codex implementation assistant | `scripts/fuzz-external-media.mjs`, `docs/compliance/external-media-fuzz.json` |
67
+ | 2026-07-12 | Reacquire every pinned corpus, reproduce all digests/outcomes, and run a separate five-minute deterministic mutation campaign | sustained local media engineering evidence | Codex implementation assistant | `docs/compliance/external-media-fuzz-sustained.json` |
68
+ | 2026-07-12 | Add a supervised V8 precise-coverage feedback loop with deterministic mutation, per-codec gates, current-case persistence, and tested idle/hard watchdogs across all nine claimed decoder paths | feedback-guided fuzz engineering gate | Codex implementation assistant | `scripts/fuzz-external-media-coverage*.mjs`, `tests/external-media-coverage-fuzz.test.mjs`, `docs/compliance/external-media-fuzz-coverage-sustained.json` |
69
+
70
+ ## AI assistance and test-oracle use
71
+
72
+ - Models/tools used: OpenAI Codex coding agent, local PowerShell, TypeScript, tsup, and Node test runner.
73
+ - Prompt or retained prompt-summary path: active Xeno proprietary migration goal and `switch-to-proprietary.md`.
74
+ - Black-box oracles: Node zlib, Pillow, ImageMagick, libwebp, and libvpx were used only to generate or compare isolated fixture outputs. Their implementations are not imported, linked, bundled, dynamically discovered, or invoked by production code.
75
+ - Normative generation: RFC 6386 numeric tables are generated from a caller-supplied source with an exact pinned SHA-256. Reproduction on 2026-07-12 produced checked-in SHA-256 `89f8368f813f8c07cfb070c0c070d8ca1179d4051ca248e97de71125c2ca5d9e` byte-for-byte.
76
+ - Confirmation that no third-party implementation entered the prompt: no codec source was supplied or inspected; oracle pixels/containers and public specification text were used.
77
+ - Human review performed: pending.
78
+
79
+ ## Verification evidence
80
+
81
+ - Focused media/read-image/fuzz-supervisor gate: 69 passed, 0 failed after adding feedback-guided coverage and watchdog regressions.
82
+ - External corpus engineering run: PNGSuite 60/60 accepted; libjpeg-turbo 2 supported images accepted and 2 documented unsupported profiles rejected; WebM Project WebP 130/131 accepted with the intentionally truncated vector rejected; all 525 unmodified W3C SVG files rejected at the secure-subset boundary. Exact per-file hashes and outcomes are recorded in `docs/compliance/external-media-corpora.json`.
83
+ - External mutation engineering run: 48,334 iterations in 60 seconds across PNG/JPEG/WebP/SVG, zero output invariant failures, and peak RSS 302,944,256 bytes. This does not replace the independently approved sustained fuzz gate.
84
+ - Independent corpus reacquisition rerun: exact upstream revisions plus W3C archive SHA reproduce all four recorded corpus digests and all 720 accepted/rejected outcomes with zero expectation failures.
85
+ - Five-minute mutation engineering run: 279,559 iterations across PNG/JPEG/WebP/SVG, zero output invariant failures, and peak RSS 321,949,696 bytes. Report SHA-256 is `5d22c7acc275d6e43ec83feebc61e8576e048ee930eae735b7164565c456c604`. This remains deterministic engineering evidence, not independently approved coverage-guided fuzzing.
86
+ - Five-minute feedback-guided engineering run: 78,978 mutations across PNG/JPEG/WebP/SVG/GIF/BMP/PBM/PGM/PPM, 1,415 unique executed owned-bundle ranges, 232 retained coverage-increasing inputs, zero output invariant failures, zero slow inputs, zero watchdog terminations, and 459,878,400-byte peak RSS. Report SHA-256 is `4fae930893f14e7170da85e9bc2e621f340cbc327f5c863fac3139b91113b018`; formal approval remains false pending independent threshold, sanitizer, corpus, and triage review.
87
+ - Paired local SDK/CLI candidate tarballs passed clean installation, ownership parity, canvas exclusion, residue scan, packaged command/benchmark checks, and the owned preview doctor check before the strict verifier stopped on the unsigned PTY release gate. Candidate hashes and scope are in the CLI `docs/compliance/paired-package-candidate.md` record.
88
+ - Full SDK regression: 501 passed, 2 platform-dependent skips, 0 failures.
89
+ - Linked CLI integration: source and CLI typechecks pass, the CLI bundle builds, and Vitest reports 163 files with 1,490 passed, 1 skipped, and 0 failures.
90
+ - Type verification: `npm run typecheck` and `npm run typecheck:tests` pass.
91
+ - Ownership proof: artifact-inclusive SDK audit reports pre-P1, target P2, 823 component records, and 0 violations. Capability remains pre-P1 because P1 evidence gates are intentionally not approved.
92
+ - Runtime exclusion scan: no `node:zlib`, canvas package, resvg, sharp, Jimp, React DOM, or equivalent media fallback in the scanned SDK production source/manifest/lock graph.
93
+ - Source hashes:
94
+ - `xeno-deflate.ts`: `61badde76048cba77a432a9a1e737de4fe49ffd6b877833b76062133851b0ae3`
95
+ - `xeno-raster.ts`: `6a7069fdd3dc6c4045feff36731fdf942fdaba71876b95b19cc8b2db49fc3ec6`
96
+ - `xeno-image-metadata.ts`: `544e1b8e14b30c1948a79887495077727fea62cbcea118edf3a108ebf8cf7973`
97
+ - `xeno-jpeg.ts`: `ad57118e4d35c29d8c5bb69f98b0be0f2442f500dc78cdf14f1f5e9330001280`
98
+ - `xeno-gif.ts`: `bda46489a77176b7ef910ab980b19468ea21a581db44333e71899495120998be`
99
+ - `xeno-vp8.ts`: `e0808f97bc9c2c727fc22e91fc0c7660b0b2ebd597bb44593a7afd43975fca07`
100
+ - `xeno-vp8-tables.ts`: `89f8368f813f8c07cfb070c0c070d8ca1179d4051ca248e97de71125c2ca5d9e`
101
+ - `xeno-webp.ts`: `54f65311182391c67759361b49a7ab2b8cd744ce9034bdc1ee6b88b33b0faee3`
102
+ - `xeno-svg-geometry.ts`: `89fcbc0ddf7ae852cfa9f7c0323ff3da7e510a4581288c76c40060ae80abbcb0`
103
+ - `xeno-svg.ts`: `edc1f03f20208efd26fa3a40afff039fccfe87936d1b5a60fb8b5a9c60eab638`
104
+ - `generate-vp8-tables.mjs`: `00ce9cac50fcf6e12a059da6a0744cb807e9dbda0c4e3d2df93ca9b634d1f9e4`
105
+ - `run-external-media-corpora.mjs`: `5e4c9910cd5fc403d331b5ca382b100cb367f0008c8f5275106e73301541232c`
106
+ - `external-media-corpora.json`: `a98533c06ff3929cc7b4d961739536f7f7532ad6583429f948c9f5e0c2477084`
107
+ - `fuzz-external-media.mjs`: `0c3dc2c1baf15b8325fc7b9692485947e28521269c4304289883c1b025584072`
108
+ - `external-media-fuzz.json`: `a2c4e32e9ebc914595d300636538d5f6a36f786b10b8cbff1374c71f444510cd`
109
+ - `external-media-fuzz-sustained.json`: `5d22c7acc275d6e43ec83feebc61e8576e048ee930eae735b7164565c456c604`
110
+ - `read-image.ts`: `151f009e882bd561345d380df204e8b8add56db081e89ee09d1b234f649e28e2`
111
+ - `fuzz-external-media-coverage.mjs`: `14e383b65995ab3f942c0411e070843cd18c16999373c9943bff1141c76d0fcd`
112
+ - `fuzz-external-media-coverage-worker.mjs`: `fd557232dc38ea6b2ce6b95f79cde983f417d35bb49ecf39383f9b1f1d3f6636`
113
+ - `external-media-fuzz-coverage-sustained.json`: `4fae930893f14e7170da85e9bc2e621f340cbc327f5c863fac3139b91113b018`
114
+
115
+ ## Open legal, provenance, and engineering questions
116
+
117
+ - Independent clean-room/source-structure review is pending.
118
+ - Contributor source-exposure disclosures and counsel disposition are pending.
119
+ - JPEG, GIF history, VP8/WebP, ICC, DEFLATE, SVG/font rendering, and specification-table rights require counsel review before public claims.
120
+ - The committed tests plus deterministic and feedback-guided five-minute campaigns are not self-approving evidence; independent reviewers must approve coverage/duration thresholds, native sanitizer and release-architecture scope, corpus terms, and triage policy.
121
+ - Pinned external corpora are selected, classified, hashed, and run for engineering evidence, but their terms/counsel disposition, independent rerun, pixel-oracle comparisons, and an approved secure-SVG subset corpus remain pending.
122
+ - ARM, macOS, signed release, and self-contained-product artifact coverage remain outside this engineering record. A local paired npm clean-install audit reached only the expected unsigned-PTY blocker and is not a completed release gate.
123
+ - `xeno-lib` reconciliation is decided and documented in `docs/xeno-lib-media-boundary.md`: its current `image` and `vtracer` bootstrap-engine graph is not accepted as a production owner. Future integration remains gated on a separately proprietary graph and full cross-repository evidence.
124
+
125
+ ## Handoff
126
+
127
+ - Engineering implementation complete for documented SDK matrix: yes
128
+ - Evidence complete: no
129
+ - Capability gate may be marked achieved: no
130
+ - Ready for independent provenance review: yes, after corpus licensing/classification and contributor disclosure collection
131
+ - Author/date: Codex implementation assistant, 2026-07-12