afyx-engineering-kit 0.0.0-stage → 0.1.0-alpha.3

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 (208) hide show
  1. package/.afyx-source-revision +1 -0
  2. package/LICENSE +21 -0
  3. package/README.md +377 -2
  4. package/SECURITY.md +74 -0
  5. package/afyx-context/LICENSE +21 -0
  6. package/afyx-context/README.md +155 -0
  7. package/afyx-context/afyx-context.json +30 -0
  8. package/afyx-context/contracts/integration-v1.schema.json +34 -0
  9. package/afyx-context/package-lock.json +53 -0
  10. package/afyx-context/package.json +34 -0
  11. package/afyx-context/scripts/benchmark.mjs +39 -0
  12. package/afyx-context/scripts/build.mjs +15 -0
  13. package/afyx-context/scripts/comparative-benchmark.mjs +342 -0
  14. package/afyx-context/scripts/comparative-worker.mjs +74 -0
  15. package/afyx-context/scripts/graph-integration-e2e.mjs +188 -0
  16. package/afyx-context/scripts/integrated-dogfood.mjs +309 -0
  17. package/afyx-context/src/budget.js +166 -0
  18. package/afyx-context/src/cli.js +110 -0
  19. package/afyx-context/src/coordination.js +343 -0
  20. package/afyx-context/src/engine.js +198 -0
  21. package/afyx-context/src/errors.js +14 -0
  22. package/afyx-context/src/graph-integration-worker.js +70 -0
  23. package/afyx-context/src/graph-integration.js +373 -0
  24. package/afyx-context/src/graph-mcp-bridge.js +103 -0
  25. package/afyx-context/src/index.js +25 -0
  26. package/afyx-context/src/integrations.js +87 -0
  27. package/afyx-context/src/memory.js +255 -0
  28. package/afyx-context/src/storage.js +364 -0
  29. package/afyx-context/test-fixtures/coordination-worker.mjs +52 -0
  30. package/afyx-context/test-fixtures/graph-consumer-repo/addons/sale_extension/__init__.py +1 -0
  31. package/afyx-context/test-fixtures/graph-consumer-repo/addons/sale_extension/__manifest__.py +4 -0
  32. package/afyx-context/test-fixtures/graph-consumer-repo/addons/sale_extension/models/__init__.py +1 -0
  33. package/afyx-context/test-fixtures/graph-consumer-repo/addons/sale_extension/models/sale_order.py +5 -0
  34. package/afyx-context/test-fixtures/integrated-dogfood-repo/addons/integrated_sales/__init__.py +1 -0
  35. package/afyx-context/test-fixtures/integrated-dogfood-repo/addons/integrated_sales/__manifest__.py +10 -0
  36. package/afyx-context/test-fixtures/integrated-dogfood-repo/addons/integrated_sales/models/__init__.py +2 -0
  37. package/afyx-context/test-fixtures/integrated-dogfood-repo/addons/integrated_sales/models/sale_order.py +20 -0
  38. package/afyx-context/test-fixtures/integrated-dogfood-repo/addons/integrated_sales/models/sale_order_audit.py +11 -0
  39. package/afyx-context/test-fixtures/integrated-dogfood-repo/addons/integrated_sales/security/ir.model.access.csv +2 -0
  40. package/afyx-context/test-fixtures/integrated-dogfood-repo/addons/integrated_sales/views/sale_order_views.xml +14 -0
  41. package/afyx-forge/LICENSE +55 -0
  42. package/afyx-forge/README.md +126 -0
  43. package/afyx-forge/afyx-forge.json +28 -0
  44. package/afyx-forge/bin/afyx-forge +4 -0
  45. package/afyx-forge/bin/afyx-forge.cmd +3 -0
  46. package/afyx-forge/bin/afyx-forge.js +16 -0
  47. package/afyx-forge/contracts/forge-plan-v1.schema.json +172 -0
  48. package/afyx-forge/package.json +26 -0
  49. package/afyx-forge/src/classifier.js +190 -0
  50. package/afyx-forge/src/cli.js +111 -0
  51. package/afyx-forge/src/doctor.js +105 -0
  52. package/afyx-forge/src/guidance.js +120 -0
  53. package/afyx-forge/src/index.js +273 -0
  54. package/afyx-forge/src/planning.js +107 -0
  55. package/afyx-forge/src/policy.js +109 -0
  56. package/afyx-forge/src/workflow-refiner.js +151 -0
  57. package/afyx-graph/afyx-graph.json +20 -0
  58. package/afyx-graph/engine/LICENSE +21 -0
  59. package/afyx-graph/engine/README.md +104 -0
  60. package/afyx-graph/engine/release/RELEASE-MANIFEST.json +21 -0
  61. package/afyx-graph/engine/release/SHA256SUMS +2 -0
  62. package/afyx-graph/engine/release/afyx-graph-linux-x64.tar.gz +0 -0
  63. package/afyx-graph/engine/release/afyx-graph-win32-x64.zip +0 -0
  64. package/afyx-graph/engine/scripts/distribution-contract.mjs +212 -0
  65. package/afyx-graph/engine/scripts/distribution-product.json +33 -0
  66. package/bin/afyx-engineering-kit.mjs +61 -0
  67. package/install.ps1 +1053 -0
  68. package/install.sh +617 -0
  69. package/package.json +66 -4
  70. package/scripts/afyx-capability-orchestrator.mjs +752 -0
  71. package/scripts/afyx-claude-integration.mjs +547 -0
  72. package/scripts/afyx-context-artifact.mjs +105 -0
  73. package/scripts/afyx-credential-broker.mjs +75 -0
  74. package/scripts/afyx-doctor.ps1 +152 -0
  75. package/scripts/afyx-doctor.sh +146 -0
  76. package/scripts/afyx-forge-artifact.mjs +183 -0
  77. package/scripts/afyx-global-routing-policy.md +12 -0
  78. package/scripts/afyx-global-routing.mjs +168 -0
  79. package/scripts/afyx-graph-artifact.mjs +178 -0
  80. package/scripts/afyx-host-adapters.mjs +543 -0
  81. package/scripts/afyx-host-bridge-lifecycle.mjs +174 -0
  82. package/scripts/afyx-host-bridge.mjs +288 -0
  83. package/scripts/afyx-integration-contracts.mjs +825 -0
  84. package/scripts/afyx-mcp-integration.mjs +528 -0
  85. package/scripts/afyx-modular-integration.mjs +361 -0
  86. package/scripts/afyx-modular-runtime.mjs +451 -0
  87. package/scripts/afyx-native-skill-host.mjs +124 -0
  88. package/scripts/afyx-npm-installer.mjs +486 -0
  89. package/scripts/afyx-project.ps1 +205 -0
  90. package/scripts/afyx-project.sh +207 -0
  91. package/scripts/afyx-provider-backup.mjs +1206 -0
  92. package/scripts/afyx-provider-integration.mjs +724 -0
  93. package/scripts/afyx-provider-inventory.mjs +147 -0
  94. package/scripts/afyx-security-auditor.mjs +224 -0
  95. package/scripts/afyx-skill-engineering.mjs +354 -0
  96. package/scripts/afyx-tool-family-routing.mjs +64 -0
  97. package/scripts/afyx-universal-runtime.mjs +530 -0
  98. package/scripts/alpha_acceptance_preflight.py +240 -0
  99. package/scripts/benchmark-graph-memory.mjs +96 -0
  100. package/scripts/benchmark_capability_orchestrator.mjs +64 -0
  101. package/scripts/build-windows-installer.ps1 +259 -0
  102. package/scripts/build_forge_synthetic_image.py +328 -0
  103. package/scripts/check-reference-staleness.py +71 -0
  104. package/scripts/components.json +254 -0
  105. package/scripts/contracts/afyx-capability-request-v1.schema.json +189 -0
  106. package/scripts/contracts/afyx-capability-result-v1.schema.json +32 -0
  107. package/scripts/dogfood_engineering_comparison.mjs +303 -0
  108. package/scripts/engineering-assurance.json +28 -0
  109. package/scripts/install-afyx-context.ps1 +142 -0
  110. package/scripts/install-afyx-context.sh +126 -0
  111. package/scripts/install-afyx-forge.ps1 +265 -0
  112. package/scripts/install-afyx-forge.sh +273 -0
  113. package/scripts/install-afyx-graph.ps1 +571 -0
  114. package/scripts/install-afyx-graph.sh +438 -0
  115. package/scripts/install-codex-usage-tracker.ps1 +172 -0
  116. package/scripts/lib/AfyxComponents.psm1 +399 -0
  117. package/scripts/lib/AfyxSkillLifecycle.psm1 +289 -0
  118. package/scripts/lib/AfyxTerminal.psm1 +838 -0
  119. package/scripts/lib/afyx-components.sh +256 -0
  120. package/scripts/lib/afyx-skill-lifecycle.sh +271 -0
  121. package/scripts/link-global-dev.ps1 +193 -0
  122. package/scripts/link-global-dev.sh +130 -0
  123. package/scripts/phase8-paired-evidence.mjs +195 -0
  124. package/scripts/phase8-representative-workload.mjs +771 -0
  125. package/scripts/phase8-session-recorder.mjs +157 -0
  126. package/scripts/phase8_event_ledger.py +248 -0
  127. package/scripts/phase8_evidence_discovery.py +189 -0
  128. package/scripts/prepare-g6-package.mjs +349 -0
  129. package/scripts/resolve-git-release-artifacts.mjs +321 -0
  130. package/scripts/stage-npm-release.mjs +94 -0
  131. package/scripts/validate-afyx-graph.py +203 -0
  132. package/scripts/validate-components.py +194 -0
  133. package/scripts/validate-engineering-assurance.py +281 -0
  134. package/scripts/verify-graph-archive.mjs +64 -0
  135. package/skills/afyx-context/SKILL.md +26 -0
  136. package/skills/afyx-engineering-expert/README.md +42 -0
  137. package/skills/afyx-engineering-expert/SKILL.md +70 -0
  138. package/skills/afyx-engineering-expert/assets/result-template.md +15 -0
  139. package/skills/afyx-engineering-expert/references/ai-ml-engineer.md +17 -0
  140. package/skills/afyx-engineering-expert/references/business-analyst.md +17 -0
  141. package/skills/afyx-engineering-expert/references/clean-code-engineer.md +26 -0
  142. package/skills/afyx-engineering-expert/references/code-reviewer.md +24 -0
  143. package/skills/afyx-engineering-expert/references/cybersecurity-devsecops.md +17 -0
  144. package/skills/afyx-engineering-expert/references/data-analyst-bi.md +24 -0
  145. package/skills/afyx-engineering-expert/references/data-engineer.md +24 -0
  146. package/skills/afyx-engineering-expert/references/database-administrator.md +17 -0
  147. package/skills/afyx-engineering-expert/references/debugging-specialist.md +24 -0
  148. package/skills/afyx-engineering-expert/references/embedded-iot-engineer.md +24 -0
  149. package/skills/afyx-engineering-expert/references/erp-technical-specialist.md +17 -0
  150. package/skills/afyx-engineering-expert/references/hardware-diagnostics-auditor.md +24 -0
  151. package/skills/afyx-engineering-expert/references/hardware-electronics-engineer.md +24 -0
  152. package/skills/afyx-engineering-expert/references/integration-engineer.md +24 -0
  153. package/skills/afyx-engineering-expert/references/legacy-modernization-engineer.md +24 -0
  154. package/skills/afyx-engineering-expert/references/llmops-prompt-engineer.md +24 -0
  155. package/skills/afyx-engineering-expert/references/network-engineer.md +24 -0
  156. package/skills/afyx-engineering-expert/references/performance-benchmark-engineer.md +24 -0
  157. package/skills/afyx-engineering-expert/references/platform-engineer.md +24 -0
  158. package/skills/afyx-engineering-expert/references/product-manager.md +17 -0
  159. package/skills/afyx-engineering-expert/references/qa-engineer.md +17 -0
  160. package/skills/afyx-engineering-expert/references/site-reliability-engineer.md +17 -0
  161. package/skills/afyx-engineering-expert/references/software-engineer.md +17 -0
  162. package/skills/afyx-engineering-expert/references/solutions-architect.md +17 -0
  163. package/skills/afyx-engineering-expert/references/specialists-index.md +33 -0
  164. package/skills/afyx-engineering-expert/references/subject-matter-expert.md +17 -0
  165. package/skills/afyx-engineering-expert/references/system-analyst.md +17 -0
  166. package/skills/afyx-engineering-expert/references/technical-project-manager.md +24 -0
  167. package/skills/afyx-engineering-expert/references/technical-writer.md +24 -0
  168. package/skills/afyx-engineering-expert/references/ui-ux-designer.md +17 -0
  169. package/skills/afyx-engineering-expert/workflows/ai-data-erp.md +20 -0
  170. package/skills/afyx-engineering-expert/workflows/debugging.md +10 -0
  171. package/skills/afyx-engineering-expert/workflows/discovery-design.md +11 -0
  172. package/skills/afyx-engineering-expert/workflows/implementation.md +12 -0
  173. package/skills/afyx-engineering-expert/workflows/incident-reliability.md +12 -0
  174. package/skills/afyx-engineering-expert/workflows/review-audit.md +13 -0
  175. package/skills/afyx-forge/SKILL.md +43 -0
  176. package/skills/afyx-forge/references/adaptive-policy.md +19 -0
  177. package/skills/efficient-coding/SKILL.md +33 -0
  178. package/skills/efficient-coding/references/investigation.md +27 -0
  179. package/skills/efficient-coding/references/token-efficiency.md +25 -0
  180. package/skills/efficient-coding/references/tool-routing.md +13 -0
  181. package/skills/odoo-engineering/SKILL.md +33 -0
  182. package/skills/odoo-engineering/references/common.md +9 -0
  183. package/skills/odoo-engineering/references/odoo-10.md +32 -0
  184. package/skills/odoo-engineering/references/odoo-11.md +26 -0
  185. package/skills/odoo-engineering/references/odoo-12.md +31 -0
  186. package/skills/odoo-engineering/references/odoo-13.md +27 -0
  187. package/skills/odoo-engineering/references/odoo-14.md +31 -0
  188. package/skills/odoo-engineering/references/odoo-15.md +34 -0
  189. package/skills/odoo-engineering/references/odoo-16.md +37 -0
  190. package/skills/odoo-engineering/references/odoo-17.md +37 -0
  191. package/skills/odoo-engineering/references/odoo-18.md +48 -0
  192. package/skills/odoo-engineering/references/odoo-19.md +43 -0
  193. package/skills/odoo-engineering/references/odoo-20.md +39 -0
  194. package/skills/odoo-engineering/references/reference-schema.md +16 -0
  195. package/skills/odoo-engineering/references/version-detection.md +13 -0
  196. package/tools/codex-usage/CodexUsage.psm1 +496 -0
  197. package/tools/codex-usage/codex-usage-doctor.ps1 +150 -0
  198. package/tools/codex-usage/codex-usage-pricing.json +25 -0
  199. package/tools/codex-usage/codex-usage-stop.ps1 +167 -0
  200. package/tools/codex-usage/codex-usage-watch.ps1 +250 -0
  201. package/tools/codex-usage/vscode-user-task.json +31 -0
  202. package/tools/windows-setup/SetupBootstrapper.cs +258 -0
  203. package/uninstall.ps1 +189 -0
  204. package/uninstall.sh +167 -0
  205. package/update.ps1 +95 -0
  206. package/update.sh +67 -0
  207. package/verify.ps1 +411 -0
  208. package/verify.sh +265 -0
@@ -0,0 +1,188 @@
1
+ import assert from 'node:assert/strict';
2
+ import crypto from 'node:crypto';
3
+ import fs from 'node:fs';
4
+ import os from 'node:os';
5
+ import path from 'node:path';
6
+ import process from 'node:process';
7
+ import { fileURLToPath, pathToFileURL } from 'node:url';
8
+ import { getEncoding } from 'js-tiktoken';
9
+ import { createGraphAceConsumer, deriveGraphAceIdentity } from '../src/index.js';
10
+
11
+ const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
12
+ const repositoryRoot = path.resolve(root, '..');
13
+ const fixtureSource = path.join(root, 'test-fixtures', 'graph-consumer-repo');
14
+ const graphDist = path.join(repositoryRoot, 'afyx-graph', 'engine', 'dist');
15
+ const encoder = getEncoding('o200k_base');
16
+
17
+ function sha256(value) {
18
+ return crypto.createHash('sha256').update(value).digest('hex');
19
+ }
20
+
21
+ function fingerprint(directory) {
22
+ const files = [];
23
+ const visit = (current) => {
24
+ for (const entry of fs.readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
25
+ const target = path.join(current, entry.name);
26
+ if (entry.isDirectory()) visit(target);
27
+ else if (entry.isFile()) files.push(path.relative(directory, target).replaceAll('\\', '/'));
28
+ }
29
+ };
30
+ visit(directory);
31
+ const content = files.map((file) => `${file}\0${sha256(fs.readFileSync(path.join(directory, file)))}`).join('\n');
32
+ return { files, sha256: sha256(content) };
33
+ }
34
+
35
+ function tokens(value) {
36
+ return encoder.encode(value).length;
37
+ }
38
+
39
+ function outputPath(args) {
40
+ const index = args.indexOf('--output');
41
+ if (index === -1) return null;
42
+ if (!args[index + 1]) throw new Error('--output requires a path');
43
+ return path.resolve(args[index + 1]);
44
+ }
45
+
46
+ async function main() {
47
+ if (!fs.existsSync(path.join(graphDist, 'index.js'))) {
48
+ throw new Error('Afyx Graph dist is missing; run its clean build before this E2E');
49
+ }
50
+ // macOS exposes /var as an alias to /private/var. Graph correctly rejects
51
+ // aliased external-state ancestors, so create the disposable lab beneath the
52
+ // canonical temp root rather than weakening that safety boundary.
53
+ const canonicalTempRoot = fs.realpathSync.native(os.tmpdir());
54
+ const lab = fs.mkdtempSync(path.join(canonicalTempRoot, 'afyx-293-real-consumer-'));
55
+ const projectRoot = path.join(lab, 'tracked-fixture-copy');
56
+ const graphState = path.join(lab, 'graph-state');
57
+ const trackedFixtureBefore = fingerprint(fixtureSource);
58
+ fs.cpSync(fixtureSource, projectRoot, { recursive: true, errorOnExist: true });
59
+ const sourceBefore = fingerprint(projectRoot);
60
+ const sourceIdentity = `sha256:${sourceBefore.sha256}`;
61
+ const priorGraphState = process.env.AFYX_GRAPH_STATE_DIR;
62
+ process.env.AFYX_GRAPH_STATE_DIR = graphState;
63
+
64
+ let graph;
65
+ try {
66
+ const graphModule = await import(pathToFileURL(path.join(graphDist, 'index.js')).href);
67
+ const toolsModule = await import(pathToFileURL(path.join(graphDist, 'mcp', 'tools.js')).href);
68
+ const Graph = graphModule.default?.default ?? graphModule.default;
69
+ graph = Graph.initSync(projectRoot);
70
+ await graph.indexAll();
71
+ const handler = new toolsModule.ToolHandler(graph);
72
+ const executeGraph = (toolName, args) => handler.execute(toolName, args);
73
+ const inventoryArgs = { declaration: '_inherit', value: 'sale.order', limit: 100 };
74
+ const matchingArgs = { query: 'SaleOrder synthetic_total', limit: 100 };
75
+ const uniqueArgs = { query: 'SyntheticSaleExtensionManifest', limit: 100 };
76
+ const inventory = await executeGraph('afyx_graph_inventory', inventoryArgs);
77
+ assert.equal(inventory.isError, undefined);
78
+ assert.match(inventory.content[0].text, /sale_extension\/models\/sale_order\.py/);
79
+ assert.match(inventory.content[0].text, /COMPLETE FOR SUPPORTED LITERAL DECLARATIONS/);
80
+ const raw = await executeGraph('afyx_graph_search', matchingArgs);
81
+ assert.equal(raw.isError, undefined);
82
+ assert.match(raw.content[0].text, /sale_order\.py/);
83
+
84
+ const makeConsumer = (scenario) => {
85
+ const identity = deriveGraphAceIdentity({ projectRoot, sourceIdentity, consumerId: `afyx-293-${scenario}` });
86
+ return createGraphAceConsumer({
87
+ enabled: true,
88
+ stateDir: path.join(lab, `ace-${scenario}`),
89
+ ...identity,
90
+ timeoutMs: 5_000,
91
+ });
92
+ };
93
+ const base = { executeGraph, toolName: 'afyx_graph_search', projectRoot, sourceIdentity };
94
+
95
+ const repeatedConsumer = makeConsumer('repeated');
96
+ await repeatedConsumer.execute({ ...base, args: matchingArgs });
97
+ const repeated = await repeatedConsumer.execute({ ...base, args: matchingArgs });
98
+ const repeatedReference = repeated.ace.items.find((item) => item.disposition === 'reference');
99
+ assert.ok(repeatedReference);
100
+ const recovered = await repeatedConsumer.recover(repeatedReference.reference);
101
+ assert.equal(recovered.content, raw.content[0].text);
102
+ assert.ok(recovered.observations.some((observation) =>
103
+ observation.provenance?.sourceIdentity === sourceIdentity
104
+ && observation.provenance?.projectRoot === fs.realpathSync.native(projectRoot)));
105
+
106
+ const uniqueConsumer = makeConsumer('unique');
107
+ await uniqueConsumer.execute({ ...base, args: matchingArgs });
108
+ const mostlyUnique = await uniqueConsumer.execute({ ...base, args: uniqueArgs });
109
+ assert.equal(mostlyUnique.ace.items[0].disposition, 'original');
110
+
111
+ const protectedConsumer = makeConsumer('protected');
112
+ const protectedResult = await protectedConsumer.execute({
113
+ ...base,
114
+ toolName: 'afyx_graph_explore',
115
+ args: { query: 'SaleOrder synthetic_total' },
116
+ });
117
+ assert.equal(protectedResult.status, 'bypassed');
118
+ assert.equal(protectedResult.ace, null);
119
+ assert.match(protectedResult.consumerResult.content[0].text, /synthetic_total/);
120
+
121
+ const off = createGraphAceConsumer();
122
+ const offResult = await off.execute({ ...base, args: matchingArgs });
123
+ assert.deepEqual(offResult.consumerResult, raw);
124
+
125
+ const rawText = raw.content.map((item) => item.text).join('\n');
126
+ const reducedText = repeated.consumerResult.content.map((item) => item.text).join('\n');
127
+ const recoveryRequest = JSON.stringify({ operation: 'ace.get/v1', reference: repeatedReference.reference });
128
+ const rawTokens = tokens(rawText);
129
+ const grossTokens = tokens(reducedText);
130
+ const recoveryTokens = tokens(recoveryRequest) + tokens(recovered.content);
131
+ const netTokens = grossTokens + recoveryTokens;
132
+ const sourceAfter = fingerprint(projectRoot);
133
+ assert.deepEqual(sourceAfter, sourceBefore);
134
+ assert.deepEqual(fingerprint(fixtureSource), trackedFixtureBefore);
135
+
136
+ const report = {
137
+ contract: 'afyx-293.graph-ace-evidence/v1',
138
+ source: {
139
+ stackHead: process.env.AFYX_SOURCE_SHA ?? null,
140
+ fixtureIdentity: sourceIdentity,
141
+ fixtureFiles: sourceBefore.files,
142
+ sourcePreserved: true,
143
+ trackedFixturePreserved: true,
144
+ },
145
+ graph: {
146
+ runtimeVersion: graphModule.VERSION ?? null,
147
+ externalState: true,
148
+ query: { toolName: 'afyx_graph_search', args: matchingArgs },
149
+ inventoryQuery: { toolName: 'afyx_graph_inventory', args: inventoryArgs },
150
+ inventoryComplete: true,
151
+ },
152
+ scenarios: {
153
+ off: offResult.status,
154
+ repeated: repeated.status,
155
+ mostlyUniqueDisposition: mostlyUnique.ace.items[0].disposition,
156
+ protectedStatus: protectedResult.status,
157
+ recoveryExact: recovered.content === rawText,
158
+ },
159
+ cost: {
160
+ tokenizer: { package: 'js-tiktoken', version: '1.0.21', encoding: 'o200k_base' },
161
+ rawTokens,
162
+ grossTokens,
163
+ grossReductionTokens: rawTokens - grossTokens,
164
+ recoveryTokens,
165
+ netTokens,
166
+ netReductionTokens: rawTokens - netTokens,
167
+ disclaimer: 'Counts are tokenizer context accounting, not provider billing, cache savings, or generalized performance.',
168
+ },
169
+ };
170
+ const serialized = `${JSON.stringify(report, null, 2)}\n`;
171
+ const destination = outputPath(process.argv.slice(2));
172
+ if (destination) {
173
+ fs.mkdirSync(path.dirname(destination), { recursive: true });
174
+ fs.writeFileSync(destination, serialized, { encoding: 'utf8', flag: 'wx' });
175
+ }
176
+ process.stdout.write(serialized);
177
+ } finally {
178
+ try { graph?.close(); } catch {}
179
+ if (priorGraphState === undefined) delete process.env.AFYX_GRAPH_STATE_DIR;
180
+ else process.env.AFYX_GRAPH_STATE_DIR = priorGraphState;
181
+ fs.rmSync(lab, { recursive: true, force: true });
182
+ }
183
+ }
184
+
185
+ main().catch((error) => {
186
+ process.stderr.write(`${error instanceof Error ? error.stack : String(error)}\n`);
187
+ process.exitCode = 1;
188
+ });
@@ -0,0 +1,309 @@
1
+ import assert from 'node:assert/strict';
2
+ import crypto from 'node:crypto';
3
+ import fs from 'node:fs';
4
+ import os from 'node:os';
5
+ import path from 'node:path';
6
+ import process from 'node:process';
7
+ import { performance } from 'node:perf_hooks';
8
+ import { fileURLToPath, pathToFileURL } from 'node:url';
9
+ import { getEncoding } from 'js-tiktoken';
10
+ import { AceError, createGraphAceConsumer, deriveGraphAceIdentity } from '../src/index.js';
11
+ import { nativeAceRunner } from '../src/graph-integration.js';
12
+
13
+ const contextRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
14
+ const repositoryRoot = path.resolve(contextRoot, '..');
15
+ const fixtureSource = path.join(contextRoot, 'test-fixtures', 'integrated-dogfood-repo');
16
+ const graphDist = path.join(repositoryRoot, 'afyx-graph', 'engine', 'dist');
17
+ const encoder = getEncoding('o200k_base');
18
+
19
+ const sha256 = (value) => crypto.createHash('sha256').update(value).digest('hex');
20
+ const tokens = (value) => encoder.encode(value).length;
21
+ const textOf = (result) => result.content.map((item) => item.text).join('\n');
22
+
23
+ function option(name) {
24
+ const index = process.argv.indexOf(name);
25
+ if (index === -1) return null;
26
+ if (!process.argv[index + 1]) throw new Error(`${name} requires a path`);
27
+ return path.resolve(process.argv[index + 1]);
28
+ }
29
+
30
+ function fingerprint(directory) {
31
+ const files = [];
32
+ const visit = (current) => {
33
+ for (const entry of fs.readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
34
+ const target = path.join(current, entry.name);
35
+ if (entry.isDirectory()) visit(target);
36
+ else if (entry.isFile()) files.push(path.relative(directory, target).replaceAll('\\', '/'));
37
+ }
38
+ };
39
+ visit(directory);
40
+ return {
41
+ files,
42
+ sha256: sha256(files.map((file) => `${file}\0${sha256(fs.readFileSync(path.join(directory, file)))}`).join('\n')),
43
+ };
44
+ }
45
+
46
+ function entriesNamed(directory, suffix) {
47
+ const found = [];
48
+ const visit = (current) => {
49
+ if (!fs.existsSync(current)) return;
50
+ for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
51
+ const target = path.join(current, entry.name);
52
+ if (entry.name.endsWith(suffix)) found.push(path.relative(directory, target).replaceAll('\\', '/'));
53
+ if (entry.isDirectory()) visit(target);
54
+ }
55
+ };
56
+ visit(directory);
57
+ return found.sort();
58
+ }
59
+
60
+ async function measured(action) {
61
+ const started = performance.now();
62
+ const value = await action();
63
+ return { value, milliseconds: Number((performance.now() - started).toFixed(3)) };
64
+ }
65
+
66
+ async function main() {
67
+ if (!fs.existsSync(path.join(graphDist, 'index.js'))) {
68
+ throw new Error('Afyx Graph dist is missing; run its clean build before integrated dogfood');
69
+ }
70
+ const explicitLab = option('--lab');
71
+ const lab = explicitLab ?? fs.mkdtempSync(path.join(fs.realpathSync.native(os.tmpdir()), 'afyx-296-integrated-'));
72
+ if (explicitLab) fs.mkdirSync(lab, { recursive: false });
73
+ const projectRoot = path.join(lab, 'source-fixture');
74
+ const graphState = path.join(lab, 'graph-state');
75
+ const aceRoot = path.join(lab, 'ace-state');
76
+ const evidenceRoot = path.join(lab, 'evidence');
77
+ fs.mkdirSync(evidenceRoot);
78
+ fs.cpSync(fixtureSource, projectRoot, { recursive: true, errorOnExist: true });
79
+ const fixtureBefore = fingerprint(fixtureSource);
80
+ const sourceBefore = fingerprint(projectRoot);
81
+ const sourceIdentity = `sha256:${sourceBefore.sha256}`;
82
+ const priorGraphState = process.env.AFYX_GRAPH_STATE_DIR;
83
+ process.env.AFYX_GRAPH_STATE_DIR = graphState;
84
+
85
+ let graph;
86
+ try {
87
+ const graphModule = await import(pathToFileURL(path.join(graphDist, 'index.js')).href);
88
+ const toolsModule = await import(pathToFileURL(path.join(graphDist, 'mcp', 'tools.js')).href);
89
+ const Graph = graphModule.default?.default ?? graphModule.default;
90
+ graph = Graph.initSync(projectRoot);
91
+ const indexing = await measured(() => graph.indexAll());
92
+ const handler = new toolsModule.ToolHandler(graph);
93
+ const executeGraph = (toolName, args) => handler.execute(toolName, args);
94
+ const repeatedArgs = { query: 'afyx_repeated_summary', limit: 100 };
95
+ const uniqueArgs = { query: 'afyx_total_snapshot', limit: 100 };
96
+ const inventoryArgs = { declaration: '_inherit', value: 'sale.order', limit: 100 };
97
+ const raw = await executeGraph('afyx_graph_search', repeatedArgs);
98
+ const uniqueRaw = await executeGraph('afyx_graph_search', uniqueArgs);
99
+ const inventory = await executeGraph('afyx_graph_inventory', inventoryArgs);
100
+ const inventoryPage = await executeGraph('afyx_graph_inventory', { ...inventoryArgs, limit: 1 });
101
+ const xmlFiles = await executeGraph('afyx_graph_files', { pattern: '**/*.xml', format: 'flat' });
102
+ assert.equal(raw.isError, undefined);
103
+ assert.equal(uniqueRaw.isError, undefined);
104
+ assert.match(textOf(raw), /sale_order\.py/);
105
+ assert.match(textOf(inventory), /sale_order\.py/);
106
+ assert.match(textOf(inventory), /sale_order_audit\.py/);
107
+ assert.match(textOf(inventory), /COMPLETE FOR SUPPORTED LITERAL DECLARATIONS/);
108
+ assert.match(textOf(inventoryPage), /PARTIAL PAGE|INCOMPLETE|TRUNCATED|remain/i);
109
+ assert.match(textOf(xmlFiles), /sale_order_views\.xml/);
110
+
111
+ const makeConsumer = (scenario, overrides = {}) => {
112
+ const identity = deriveGraphAceIdentity({ projectRoot, sourceIdentity, consumerId: `afyx-296-${scenario}` });
113
+ return createGraphAceConsumer({
114
+ enabled: true,
115
+ stateDir: path.join(aceRoot, scenario),
116
+ ...identity,
117
+ timeoutMs: 5_000,
118
+ ...overrides,
119
+ });
120
+ };
121
+ const base = { executeGraph, toolName: 'afyx_graph_search', projectRoot, sourceIdentity };
122
+ const offMeasured = await measured(() => createGraphAceConsumer().execute({ ...base, args: repeatedArgs }));
123
+ assert.equal(offMeasured.value.status, 'disabled');
124
+ assert.deepEqual(offMeasured.value.consumerResult, raw);
125
+
126
+ const repeatedConsumer = makeConsumer('session');
127
+ const first = await measured(() => repeatedConsumer.execute({ ...base, args: repeatedArgs }));
128
+ const repeated = await measured(() => repeatedConsumer.execute({ ...base, args: repeatedArgs }));
129
+ const repeatedItem = repeated.value.ace.items.find((item) => item.disposition === 'reference');
130
+ assert.ok(repeatedItem);
131
+ const recovered = await measured(() => repeatedConsumer.recover(repeatedItem.reference));
132
+ assert.equal(recovered.value.content, textOf(raw));
133
+ assert.ok(recovered.value.observations.some((item) => item.provenance?.sourceIdentity === sourceIdentity));
134
+
135
+ const unique = await makeConsumer('unique').execute({ ...base, args: uniqueArgs });
136
+ assert.equal(unique.ace.items[0].disposition, 'original');
137
+ const sourceProtected = await makeConsumer('source').execute({
138
+ ...base,
139
+ toolName: 'afyx_graph_explore',
140
+ args: { query: 'SaleOrder afyx_total_snapshot' },
141
+ });
142
+ assert.equal(sourceProtected.status, 'bypassed');
143
+ assert.equal(sourceProtected.ace, null);
144
+ const diagnostic = await makeConsumer('diagnostic').execute({ ...base, toolName: 'afyx_graph_status', args: {} });
145
+ assert.equal(diagnostic.status, 'bypassed');
146
+ assert.equal(diagnostic.ace, null);
147
+ const security = await makeConsumer('security').execute({
148
+ ...base,
149
+ args: { query: 'SECURITY', limit: 100 },
150
+ });
151
+ assert.equal(security.ace.items[0].classification, 'security');
152
+ assert.equal(security.ace.items[0].disposition, 'original');
153
+
154
+ const failures = {};
155
+ for (const [name, runner, expected] of [
156
+ ['unavailable', async () => { throw new Error('unavailable'); }, 'ACE_UNAVAILABLE'],
157
+ ['malformed', async () => ({ unexpected: true }), 'INVALID_ACE_RESULT'],
158
+ ['timeout', (_message, { signal }) => new Promise((_, reject) => {
159
+ signal.addEventListener('abort', () => reject(new AceError('ACE_TIMEOUT', 'timeout')), { once: true });
160
+ }), 'ACE_TIMEOUT'],
161
+ ['incomplete', async () => ({ status: 'fallback', failureCode: 'INVALID_INPUT', originalComplete: false }), 'INVALID_INPUT'],
162
+ ]) {
163
+ const result = await makeConsumer(`failure-${name}`, { timeoutMs: name === 'timeout' ? 10 : 500, aceRunner: runner })
164
+ .execute({ ...base, args: repeatedArgs });
165
+ assert.equal(result.status, 'fallback');
166
+ assert.equal(result.failureCode, expected);
167
+ assert.deepEqual(result.consumerResult, raw);
168
+ failures[name] = expected;
169
+ }
170
+
171
+ const concurrentConsumer = makeConsumer('concurrent');
172
+ const concurrent = await Promise.all([
173
+ concurrentConsumer.execute({ ...base, args: repeatedArgs }),
174
+ concurrentConsumer.execute({ ...base, args: repeatedArgs }),
175
+ ]);
176
+ assert.ok(concurrent.every((item) => item.status === 'optimized'));
177
+
178
+ const interruptionState = path.join(aceRoot, 'interrupted');
179
+ const interruptionIdentity = deriveGraphAceIdentity({ projectRoot, sourceIdentity, consumerId: 'afyx-296-interrupted' });
180
+ const readyPath = path.join(evidenceRoot, 'interrupted-lock-acquired');
181
+ const interruptedConsumer = createGraphAceConsumer({
182
+ enabled: true,
183
+ stateDir: interruptionState,
184
+ ...interruptionIdentity,
185
+ timeoutMs: 500,
186
+ aceRunner: (message, options) => nativeAceRunner({
187
+ ...message,
188
+ testControl: { phase: 'after-lock-acquired', readyPath },
189
+ }, options),
190
+ });
191
+ const interrupted = await interruptedConsumer.execute({ ...base, args: repeatedArgs });
192
+ assert.equal(interrupted.status, 'fallback');
193
+ assert.equal(interrupted.failureCode, 'ACE_TIMEOUT');
194
+ assert.deepEqual(interrupted.consumerResult, raw);
195
+ assert.equal(fs.existsSync(readyPath), true);
196
+ const retryConsumer = createGraphAceConsumer({ enabled: true, stateDir: interruptionState, ...interruptionIdentity });
197
+ const retry = await retryConsumer.execute({ ...base, args: repeatedArgs });
198
+ assert.equal(retry.status, 'optimized');
199
+
200
+ const foreign = createGraphAceConsumer({
201
+ enabled: true,
202
+ stateDir: path.join(aceRoot, 'session'),
203
+ ...deriveGraphAceIdentity({ projectRoot, sourceIdentity: `${sourceIdentity}-foreign`, consumerId: 'afyx-296-session' }),
204
+ });
205
+ await assert.rejects(foreign.recover(repeatedItem.reference), (error) => error.code === 'REFERENCE_BOUNDARY');
206
+ const unsafe = createGraphAceConsumer({
207
+ enabled: true,
208
+ stateDir: path.join(projectRoot, '.unsafe-ace-state'),
209
+ ...deriveGraphAceIdentity({ projectRoot, sourceIdentity, consumerId: 'afyx-296-unsafe' }),
210
+ });
211
+ const unsafeResult = await unsafe.execute({ ...base, args: repeatedArgs });
212
+ assert.equal(unsafeResult.status, 'fallback');
213
+ assert.equal(unsafeResult.failureCode, 'UNSAFE_STATE_PATH');
214
+ assert.equal(fs.existsSync(path.join(projectRoot, '.unsafe-ace-state')), false);
215
+
216
+ const rawText = textOf(raw);
217
+ const grossText = textOf(repeated.value.consumerResult);
218
+ const referenceRequest = JSON.stringify({ operation: 'ace.get/v1', reference: repeatedItem.reference });
219
+ const rawTokens = tokens(rawText);
220
+ const grossTokens = tokens(grossText);
221
+ const referenceTokens = tokens(referenceRequest);
222
+ const recoveredTokens = tokens(recovered.value.content);
223
+ const netTokens = grossTokens + referenceTokens + recoveredTokens;
224
+ const sourceAfter = fingerprint(projectRoot);
225
+ assert.deepEqual(sourceAfter, sourceBefore);
226
+ assert.deepEqual(fingerprint(fixtureSource), fixtureBefore);
227
+ const locks = entriesNamed(aceRoot, '.ace-lock');
228
+ const temporaries = entriesNamed(aceRoot, '.tmp');
229
+ assert.deepEqual(locks, []);
230
+ assert.deepEqual(temporaries, []);
231
+
232
+ const report = {
233
+ contract: 'afyx-296.integrated-dogfood/v1',
234
+ source: {
235
+ candidateHead: process.env.AFYX_SOURCE_SHA ?? null,
236
+ baseHead: '54b4832204a9465d93e166ea780d07f39e0cdf25',
237
+ fixtureIdentity: sourceIdentity,
238
+ fixtureFiles: sourceBefore.files,
239
+ sourcePreserved: true,
240
+ trackedFixturePreserved: true,
241
+ },
242
+ isolation: {
243
+ lab,
244
+ sourceRoot: projectRoot,
245
+ graphState,
246
+ aceRoot,
247
+ separateRoots: new Set([projectRoot, graphState, aceRoot]).size === 3,
248
+ locksRemaining: locks,
249
+ temporariesRemaining: temporaries,
250
+ },
251
+ graph: {
252
+ externalState: true,
253
+ indexingMilliseconds: indexing.milliseconds,
254
+ inventoryComplete: true,
255
+ boundedInventoryIncomplete: true,
256
+ sourcePathEvidence: ['sale_order.py', 'sale_order_audit.py', 'sale_order_views.xml'],
257
+ },
258
+ scenarios: {
259
+ off: offMeasured.value.status,
260
+ repeated: repeated.value.status,
261
+ uniqueDisposition: unique.ace.items[0].disposition,
262
+ protected: {
263
+ source: sourceProtected.status,
264
+ diagnostic: diagnostic.status,
265
+ security: security.ace.items[0].disposition,
266
+ },
267
+ recoveryExact: recovered.value.content === rawText,
268
+ failures,
269
+ concurrent: concurrent.map((item) => item.status),
270
+ interrupted: interrupted.failureCode,
271
+ sameStateRetry: retry.status,
272
+ foreignRecovery: 'REFERENCE_BOUNDARY',
273
+ unsafeState: unsafeResult.failureCode,
274
+ },
275
+ latencyMilliseconds: {
276
+ off: offMeasured.milliseconds,
277
+ firstOn: first.milliseconds,
278
+ repeatedOn: repeated.milliseconds,
279
+ recovery: recovered.milliseconds,
280
+ },
281
+ cost: {
282
+ tokenizer: { package: 'js-tiktoken', version: '1.0.21', encoding: 'o200k_base' },
283
+ rawTokens,
284
+ grossTokens,
285
+ grossReductionTokens: rawTokens - grossTokens,
286
+ referenceRequestTokens: referenceTokens,
287
+ recoveredOriginalTokens: recoveredTokens,
288
+ netTokens,
289
+ netReductionTokens: rawTokens - netTokens,
290
+ disclaimer: 'Tokenizer context accounting only; not provider billing, cache savings, or generalized performance.',
291
+ },
292
+ };
293
+ const serialized = `${JSON.stringify(report, null, 2)}\n`;
294
+ const destination = option('--output') ?? path.join(evidenceRoot, 'integrated-dogfood.json');
295
+ fs.mkdirSync(path.dirname(destination), { recursive: true });
296
+ fs.writeFileSync(destination, serialized, { encoding: 'utf8', flag: 'wx' });
297
+ process.stdout.write(serialized);
298
+ } finally {
299
+ try { graph?.close(); } catch {}
300
+ if (priorGraphState === undefined) delete process.env.AFYX_GRAPH_STATE_DIR;
301
+ else process.env.AFYX_GRAPH_STATE_DIR = priorGraphState;
302
+ if (!explicitLab) fs.rmSync(lab, { recursive: true, force: true });
303
+ }
304
+ }
305
+
306
+ main().catch((error) => {
307
+ process.stderr.write(`${error instanceof Error ? error.stack : String(error)}\n`);
308
+ process.exitCode = 1;
309
+ });
@@ -0,0 +1,166 @@
1
+ /**
2
+ * AFYX Context Engine - Deterministic Context Budgeting & Compression
3
+ *
4
+ * Provides deterministic token and byte estimation, redundancy detection,
5
+ * and adaptive evidence compression without external model telemetry.
6
+ * Ensures critical source references (file paths, symbol names, error spans)
7
+ * remain recoverable when trimming oversized tool outputs.
8
+ */
9
+
10
+ export const DEFAULT_CONTEXT_BUDGET = Object.freeze({
11
+ maxTokens: 4000,
12
+ maxBytes: 16000,
13
+ maxLines: 250,
14
+ });
15
+
16
+ /**
17
+ * Deterministic token counter heuristic (provider-agnostic: ~4 chars per token).
18
+ */
19
+ export function estimateTokens(text) {
20
+ if (!text) return 0;
21
+ const str = typeof text === 'string' ? text : JSON.stringify(text);
22
+ // Accurate code token heuristic: words + punctuation chunks
23
+ const wordTokens = str.split(/\s+/).filter(Boolean).length;
24
+ const charTokens = Math.ceil(str.length / 4);
25
+ return Math.max(wordTokens, charTokens);
26
+ }
27
+
28
+ /**
29
+ * Calculates byte size in UTF-8.
30
+ */
31
+ export function estimateBytes(text) {
32
+ if (!text) return 0;
33
+ const str = typeof text === 'string' ? text : JSON.stringify(text);
34
+ return Buffer.byteLength(str, 'utf8');
35
+ }
36
+
37
+ /**
38
+ * Detects repetitive / redundant lines across text blocks.
39
+ */
40
+ export function detectRedundancy(lines, { minRepeatCount = 3 } = {}) {
41
+ const lineCounts = new Map();
42
+ for (const line of lines) {
43
+ const trimmed = line.trim();
44
+ if (trimmed.length > 10) {
45
+ lineCounts.set(trimmed, (lineCounts.get(trimmed) || 0) + 1);
46
+ }
47
+ }
48
+ const redundant = new Set();
49
+ for (const [line, count] of lineCounts.entries()) {
50
+ if (count >= minRepeatCount) {
51
+ redundant.add(line);
52
+ }
53
+ }
54
+ return redundant;
55
+ }
56
+
57
+ /**
58
+ * Compresses an array of text sections or source files within a bounded budget,
59
+ * preserving critical references and recording exact truncation metadata.
60
+ *
61
+ * @param {Array<{ id: string, text: string, priority?: number, references?: string[] }>} items
62
+ * @param {Object} [budget]
63
+ * @param {number} [budget.maxTokens]
64
+ * @param {number} [budget.maxBytes]
65
+ * @param {number} [budget.maxLines]
66
+ * @returns {Object} Compressed result with retained items and truncation receipts
67
+ */
68
+ export function compressContextItems(items, budget = {}) {
69
+ const maxBytes = budget.maxBytes || DEFAULT_CONTEXT_BUDGET.maxBytes;
70
+ const maxTokens = budget.maxTokens || DEFAULT_CONTEXT_BUDGET.maxTokens;
71
+ const maxLines = budget.maxLines || DEFAULT_CONTEXT_BUDGET.maxLines;
72
+
73
+ // Sort by priority descending (higher priority admitted first)
74
+ const sorted = [...items].sort((a, b) => (b.priority || 0) - (a.priority || 0));
75
+
76
+ let currentBytes = 0;
77
+ let currentTokens = 0;
78
+ let currentLines = 0;
79
+
80
+ const admitted = [];
81
+ const truncated = [];
82
+ const omitted = [];
83
+ const preservedReferences = new Set();
84
+
85
+ for (const item of sorted) {
86
+ const itemBytes = estimateBytes(item.text);
87
+ const itemTokens = estimateTokens(item.text);
88
+ const itemLinesList = item.text.split('\n');
89
+ const itemLinesCount = itemLinesList.length;
90
+
91
+ // Register references
92
+ if (Array.isArray(item.references)) {
93
+ for (const ref of item.references) preservedReferences.add(ref);
94
+ }
95
+
96
+ // Check if item fits fully
97
+ if (
98
+ currentBytes + itemBytes <= maxBytes &&
99
+ currentTokens + itemTokens <= maxTokens &&
100
+ currentLines + itemLinesCount <= maxLines
101
+ ) {
102
+ admitted.push({
103
+ id: item.id,
104
+ text: item.text,
105
+ status: 'FULL',
106
+ originalBytes: itemBytes,
107
+ originalTokens: itemTokens,
108
+ });
109
+ currentBytes += itemBytes;
110
+ currentTokens += itemTokens;
111
+ currentLines += itemLinesCount;
112
+ continue;
113
+ }
114
+
115
+ // Partial budget remaining: try bounded slice
116
+ const remainingBytes = Math.max(0, maxBytes - currentBytes);
117
+ const remainingLines = Math.max(0, maxLines - currentLines);
118
+
119
+ if (remainingBytes > 300 && remainingLines > 5) {
120
+ const halfLines = Math.floor(remainingLines / 2);
121
+ const head = itemLinesList.slice(0, halfLines);
122
+ const tail = itemLinesList.slice(-halfLines);
123
+ const omittedLineCount = itemLinesCount - head.length - tail.length;
124
+
125
+ const marker = `\n<!-- AFYX-TRUNCATED: [id=${item.id}] original=${itemLinesCount} lines, omitted=${omittedLineCount} lines; full evidence recoverable on disk -->\n`;
126
+ const compressedText = [...head, marker, ...tail].join('\n');
127
+
128
+ admitted.push({
129
+ id: item.id,
130
+ text: compressedText,
131
+ status: 'PARTIAL',
132
+ originalBytes: itemBytes,
133
+ compressedBytes: estimateBytes(compressedText),
134
+ omittedLines: omittedLineCount,
135
+ });
136
+ truncated.push(item.id);
137
+ currentBytes += estimateBytes(compressedText);
138
+ currentLines += remainingLines;
139
+ break;
140
+ } else {
141
+ omitted.push({
142
+ id: item.id,
143
+ originalBytes: itemBytes,
144
+ references: item.references || [],
145
+ });
146
+ }
147
+ }
148
+
149
+ return {
150
+ contract: 'afyx-context-budget-v1',
151
+ budget: { maxBytes, maxTokens, maxLines },
152
+ metrics: {
153
+ totalOriginalItems: items.length,
154
+ admittedItemsCount: admitted.length,
155
+ truncatedItemsCount: truncated.length,
156
+ omittedItemsCount: omitted.length,
157
+ consumedBytes: currentBytes,
158
+ consumedTokens: currentTokens,
159
+ consumedLines: currentLines,
160
+ },
161
+ admitted,
162
+ truncated,
163
+ omitted,
164
+ preservedReferences: Array.from(preservedReferences),
165
+ };
166
+ }