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,530 @@
1
+ #!/usr/bin/env node
2
+
3
+ /** Native installed-component discovery and execution for AfyxUniversalInterop/v1. */
4
+
5
+ import { createHash } from 'node:crypto';
6
+ import { spawnSync } from 'node:child_process';
7
+ import {
8
+ existsSync,
9
+ lstatSync,
10
+ readFileSync,
11
+ realpathSync,
12
+ readdirSync,
13
+ statSync,
14
+ } from 'node:fs';
15
+ import { homedir } from 'node:os';
16
+ import {
17
+ isAbsolute,
18
+ join,
19
+ relative,
20
+ resolve,
21
+ } from 'node:path';
22
+ import { fileURLToPath } from 'node:url';
23
+
24
+ import {
25
+ classifyTaskIntent,
26
+ executeAfyxCapabilityRoute,
27
+ } from './afyx-capability-orchestrator.mjs';
28
+ import { createInstalledHostAdapters } from './afyx-host-adapters.mjs';
29
+ import { createNativeSkillHostAdapter } from './afyx-native-skill-host.mjs';
30
+
31
+ export const AFYX_UNIVERSAL_RUNTIME_CONTRACT = 'AfyxUniversalRuntime/v1';
32
+ export const AFYX_COMPONENT_MANIFEST_CONTRACT = 'AfyxComponentManifest/v1';
33
+
34
+ const COMPONENT_ID_PATTERN = /^[a-z0-9][a-z0-9-]{1,63}$/;
35
+ const DYNAMIC_PROTOCOL = 'AfyxCapabilityRequest/v1-json-stdio';
36
+ const COMPONENT_REGISTRY = JSON.parse(
37
+ readFileSync(new URL('./components.json', import.meta.url), 'utf8'),
38
+ );
39
+ const HOST_RUNTIME_ENTRYPOINTS = Object.freeze({
40
+ 'afyx-graph': Object.freeze(['current/lib/dist/bin/afyx-graph.js']),
41
+ });
42
+
43
+ function splitRequiredFiles(value) {
44
+ return typeof value === 'string' ? value.split(';').filter(Boolean) : [];
45
+ }
46
+
47
+ const KNOWN_LAYOUT = Object.freeze(Object.fromEntries(
48
+ COMPONENT_REGISTRY.components.map((component) => {
49
+ const platformRequired = process.platform === 'win32'
50
+ ? component.required_files_windows
51
+ : component.required_files_unix;
52
+ const required = [
53
+ ...splitRequiredFiles(component.required_files),
54
+ ...splitRequiredFiles(platformRequired),
55
+ ...(HOST_RUNTIME_ENTRYPOINTS[component.id] ?? []),
56
+ ];
57
+ const codexTools = component.type === 'toolset';
58
+ const root = component.type === 'skill'
59
+ ? ['skills', component.install_path]
60
+ : (component.type === 'runtime' ? [component.id.replace(/^afyx-/, '')] : []);
61
+ return [component.id, Object.freeze({
62
+ root: Object.freeze(root),
63
+ required: Object.freeze([...new Set(required)]),
64
+ identity: component.marker_file || component.version_source?.split('#')[0] || required[0],
65
+ codexTools,
66
+ })];
67
+ }),
68
+ ));
69
+
70
+ function sha256File(path) {
71
+ return createHash('sha256').update(readFileSync(path)).digest('hex');
72
+ }
73
+
74
+ function readJson(path) {
75
+ try {
76
+ return JSON.parse(readFileSync(path, 'utf8'));
77
+ } catch {
78
+ return null;
79
+ }
80
+ }
81
+
82
+ function isWithin(parent, child) {
83
+ const rel = relative(parent, child);
84
+ return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));
85
+ }
86
+
87
+ function metadataIdentity(root, identityFile) {
88
+ const path = join(root, identityFile);
89
+ if (!existsSync(path) || !statSync(path).isFile()) return null;
90
+ if (identityFile.endsWith('.json')) {
91
+ const metadata = readJson(path);
92
+ if (!metadata) return null;
93
+ const declared = metadata?.source_revision ?? metadata?.sourceRevision ??
94
+ metadata?.artifact_digest ?? metadata?.artifactDigest ??
95
+ metadata?.requested_checkout_revision;
96
+ if (typeof declared === 'string' && declared.trim() && declared !== 'UNKNOWN') {
97
+ return declared.trim();
98
+ }
99
+ }
100
+ return `sha256:${sha256File(path)}`;
101
+ }
102
+
103
+ function componentEnabled(componentId, settings, environment) {
104
+ if (settings?.enabled === false) return false;
105
+ const envName = `AFYX_${componentId.replaceAll('-', '_').toUpperCase()}_ENABLED`;
106
+ if (String(environment?.[envName] ?? '').trim() === '0') return false;
107
+ if (componentId === 'afyx-context' && String(environment?.AFYX_CONTEXT_OPT_IN ?? '').trim() === '0') {
108
+ return false;
109
+ }
110
+ return true;
111
+ }
112
+
113
+ function inspectGraphIndex(projectRoot, entrypoint, nodePath, environment) {
114
+ // Graph's status command is the authority for ancestor resolution, ownership,
115
+ // extraction compatibility, pending changes and incomplete indexes.
116
+ const result = spawnSync(nodePath, [entrypoint, 'status', projectRoot, '--json'], {
117
+ encoding: 'utf8', windowsHide: true, timeout: 10_000,
118
+ maxBuffer: 2 * 1024 * 1024, env: environment,
119
+ });
120
+ if (result.status !== 0 || result.error) return { indexReady: false, indexFresh: false };
121
+ let status;
122
+ try { status = JSON.parse(result.stdout); } catch { return { indexReady: false, indexFresh: false }; }
123
+ let indexRoot;
124
+ let trustedRoot = false;
125
+ let safeState = false;
126
+ try {
127
+ indexRoot = status.projectPath && resolve(status.projectPath);
128
+ const project = realpathSync(projectRoot);
129
+ // Only the project or its immediate workspace parent may own an implicit index.
130
+ // Reject aliases, unrelated worktrees and reparse-point state directories.
131
+ trustedRoot = Boolean(indexRoot && [project, resolve(project, '..')].includes(indexRoot)
132
+ && realpathSync(indexRoot) === indexRoot);
133
+ const statePath = status.indexPath && resolve(status.indexPath);
134
+ const database = statePath && join(statePath, 'afyx-graph.db');
135
+ safeState = Boolean(statePath && existsSync(statePath)
136
+ && !lstatSync(statePath).isSymbolicLink()
137
+ && realpathSync(statePath) === statePath
138
+ && database && existsSync(database) && lstatSync(database).isFile());
139
+ } catch { return { indexReady: false, indexFresh: false }; }
140
+ const indexReady = status.initialized === true && trustedRoot && safeState
141
+ && !status.worktreeMismatch && status.index?.state === 'complete'
142
+ && status.index?.pendingRefs === 0;
143
+ const health = status.health ?? {};
144
+ const indexFresh = Boolean(indexReady && status.index?.reindexRecommended === false
145
+ && health.pendingChanges?.state === 'CURRENT'
146
+ && health.compatibility?.reindexRecommended === false
147
+ && health.gitFreshness?.state !== 'STALE');
148
+ return { indexReady: Boolean(indexReady), indexFresh, indexRoot: indexReady ? indexRoot : null };
149
+ }
150
+
151
+ function skillRootFor(provider, componentId, providerSkillRoots) {
152
+ const explicit = providerSkillRoots?.[provider];
153
+ const base = explicit ?? (provider === 'codex' ? join(homedir(), '.agents', 'skills')
154
+ : provider === 'antigravity' ? join(homedir(), '.gemini', 'config', 'skills')
155
+ : provider === 'antigravity-cli' ? join(homedir(), '.gemini', 'antigravity-cli', 'skills') : null);
156
+ return base ? join(resolve(base), componentId) : null;
157
+ }
158
+
159
+ function ownedSkill(root, componentId) {
160
+ if (!root || !existsSync(root) || lstatSync(root).isSymbolicLink()) return false;
161
+ const marker = readJson(join(root, '.afyx-install.json'));
162
+ if (marker?.schema !== 1 || marker.product !== 'Afyx Codex Engineering Kit'
163
+ || marker.component !== componentId || marker.owner !== 'afyx'
164
+ || !/^[0-9a-f]{64}$/.test(marker.content_sha256 ?? '')) return false;
165
+ const files = [];
166
+ function visit(dir) {
167
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
168
+ if (entry.name === '.afyx-install.json' || entry.name === '.git') continue;
169
+ const path = join(dir, entry.name);
170
+ if (lstatSync(path).isSymbolicLink()) throw new Error('UNSAFE_SKILL_REPARSE_POINT');
171
+ if (entry.isDirectory()) visit(path);
172
+ else if (entry.isFile()) files.push(path);
173
+ }
174
+ }
175
+ try { visit(root); } catch { return false; }
176
+ files.sort((a, b) => {
177
+ const left = a.toUpperCase();
178
+ const right = b.toUpperCase();
179
+ return left < right ? -1 : (left > right ? 1 : 0);
180
+ });
181
+ const lines = files.map((path) => `${sha256File(path).toUpperCase()} ./${relative(root, path).replaceAll('\\', '/')}`);
182
+ const digest = createHash('sha256').update(`${lines.join('\n')}\n`).digest('hex');
183
+ return digest === marker.content_sha256;
184
+ }
185
+
186
+ function inspectKnownComponents({
187
+ installRoot,
188
+ projectRoot,
189
+ provider,
190
+ providerSkillRoots,
191
+ codexToolsRoot,
192
+ nodePath,
193
+ componentSettings,
194
+ authorizations,
195
+ environment,
196
+ componentStateOverrides,
197
+ }) {
198
+ const states = {};
199
+ const evidence = [];
200
+ for (const [componentId, layout] of Object.entries(KNOWN_LAYOUT)) {
201
+ const providerRoot = layout.root[0] === 'skills'
202
+ ? skillRootFor(provider, componentId, providerSkillRoots) : null;
203
+ const root = layout.codexTools
204
+ ? codexToolsRoot
205
+ : (providerRoot && existsSync(providerRoot) ? providerRoot : join(installRoot, ...layout.root));
206
+ const requiredPaths = root
207
+ ? layout.required.map((item) => join(root, ...item.split('/')))
208
+ : [];
209
+ const installed = Boolean(root) && (!providerRoot || root !== providerRoot || ownedSkill(root, componentId))
210
+ && requiredPaths.every((path) => existsSync(path) && statSync(path).isFile());
211
+ const sourceIdentity = installed ? metadataIdentity(root, layout.identity) : null;
212
+ const enabled = installed && componentEnabled(
213
+ componentId,
214
+ componentSettings?.[componentId],
215
+ environment,
216
+ );
217
+ const graph = componentId === 'afyx-graph' && installed
218
+ ? inspectGraphIndex(projectRoot, join(root, 'current', 'lib', 'dist', 'bin', 'afyx-graph.js'), nodePath, environment)
219
+ : (componentId === 'afyx-graph' ? { indexReady: false, indexFresh: false } : {});
220
+ const override = componentStateOverrides?.[componentId] ?? {};
221
+ states[componentId] = {
222
+ installed,
223
+ enabled,
224
+ healthy: installed && override.healthy !== false,
225
+ compatible: installed && override.compatible !== false,
226
+ authorized: authorizations?.[componentId] === true,
227
+ sourceIdentity: installed
228
+ ? (typeof override.sourceIdentity === 'string' ? override.sourceIdentity : sourceIdentity)
229
+ : null,
230
+ observationSource: override.observationSource ?? 'NATIVE_FILESYSTEM_DISCOVERY',
231
+ ...graph,
232
+ ...(componentId === 'afyx-graph' ? {
233
+ indexReady: override.indexReady ?? graph.indexReady,
234
+ indexFresh: override.indexFresh ?? graph.indexFresh,
235
+ } : {}),
236
+ };
237
+ evidence.push(Object.freeze({
238
+ componentId,
239
+ root,
240
+ requiredFiles: Object.freeze(requiredPaths),
241
+ installed,
242
+ sourceIdentity,
243
+ }));
244
+ }
245
+ return { states, evidence };
246
+ }
247
+
248
+ function dynamicAdapter(entrypoint, nodePath) {
249
+ return async (request) => {
250
+ const result = spawnSync(nodePath, [entrypoint], {
251
+ input: JSON.stringify(request),
252
+ encoding: 'utf8',
253
+ windowsHide: true,
254
+ timeout: Math.min(60_000, Math.max(1, request.budgetLimits?.maxExecutionMs ?? 5_000)),
255
+ maxBuffer: Math.min(
256
+ 16 * 1_048_576,
257
+ Math.max(1_048_576, request.budgetLimits?.maxContextBytes ?? 65_536),
258
+ ),
259
+ });
260
+ if (result.error || result.status !== 0) {
261
+ return {
262
+ status: 'FAILED',
263
+ reason: result.error?.message || result.stderr?.trim() || `Exit code ${result.status}`,
264
+ output: null,
265
+ };
266
+ }
267
+ try {
268
+ return JSON.parse(result.stdout);
269
+ } catch {
270
+ return { status: 'FAILED', reason: 'INVALID_COMPONENT_JSON_RESULT', output: null };
271
+ }
272
+ };
273
+ }
274
+
275
+ function discoverDynamicComponents({
276
+ installRoot,
277
+ componentSettings,
278
+ authorizations,
279
+ environment,
280
+ nodePath,
281
+ }) {
282
+ const componentsRoot = join(installRoot, 'components');
283
+ const states = {};
284
+ const adapters = {};
285
+ const evidence = [];
286
+ if (!existsSync(componentsRoot) || !statSync(componentsRoot).isDirectory()) {
287
+ return { states, adapters, evidence };
288
+ }
289
+
290
+ for (const entry of readdirSync(componentsRoot, { withFileTypes: true })) {
291
+ if (!entry.isDirectory() || !COMPONENT_ID_PATTERN.test(entry.name)) continue;
292
+ const root = join(componentsRoot, entry.name);
293
+ const manifestPath = join(root, 'afyx-component.json');
294
+ const manifest = readJson(manifestPath);
295
+ const relativeEntrypoint = manifest?.runtime?.entrypoint;
296
+ const entrypoint = typeof relativeEntrypoint === 'string'
297
+ ? resolve(root, relativeEntrypoint)
298
+ : null;
299
+ const rootRealPath = realpathSync(root);
300
+ const entrypointRealPath = entrypoint && existsSync(entrypoint)
301
+ ? realpathSync(entrypoint)
302
+ : null;
303
+ const valid = !Object.hasOwn(KNOWN_LAYOUT, entry.name) &&
304
+ manifest?.contract === AFYX_COMPONENT_MANIFEST_CONTRACT &&
305
+ manifest.id === entry.name && manifest.ownershipClass === 'AFYX' &&
306
+ typeof manifest.primaryCapability === 'string' && manifest.primaryCapability.length > 0 &&
307
+ manifest.runtime?.protocol === DYNAMIC_PROTOCOL && entrypoint !== null &&
308
+ entrypointRealPath !== null && isWithin(rootRealPath, entrypointRealPath) &&
309
+ statSync(entrypointRealPath).isFile();
310
+ if (!valid) {
311
+ evidence.push(Object.freeze({
312
+ componentId: entry.name,
313
+ root,
314
+ installed: false,
315
+ reason: 'INVALID_COMPONENT_MANIFEST',
316
+ }));
317
+ continue;
318
+ }
319
+
320
+ const sourceIdentity = typeof manifest.sourceIdentity === 'string' && manifest.sourceIdentity
321
+ ? manifest.sourceIdentity
322
+ : `sha256:${sha256File(manifestPath)}`;
323
+ states[manifest.id] = {
324
+ installed: true,
325
+ enabled: componentEnabled(manifest.id, componentSettings?.[manifest.id], environment),
326
+ healthy: true,
327
+ compatible: true,
328
+ authorized: authorizations?.[manifest.id] === true,
329
+ sourceIdentity,
330
+ observationSource: 'NATIVE_COMPONENT_MANIFEST',
331
+ canonicalName: manifest.canonicalName ?? manifest.id,
332
+ type: manifest.type ?? 'runtime',
333
+ capability: manifest.primaryCapability,
334
+ domainAuthority: manifest.domainAuthority ?? `${manifest.id} authoritative domain`,
335
+ ownershipClass: manifest.ownershipClass,
336
+ };
337
+ adapters[manifest.id] = dynamicAdapter(entrypointRealPath, nodePath);
338
+ evidence.push(Object.freeze({
339
+ componentId: manifest.id,
340
+ root,
341
+ manifestPath,
342
+ entrypoint: entrypointRealPath,
343
+ installed: true,
344
+ sourceIdentity,
345
+ }));
346
+ }
347
+ return { states, adapters, evidence };
348
+ }
349
+
350
+ /** Discover installed components and construct executable host adapters. */
351
+ export function createInstalledAfyxRuntime({
352
+ installRoot,
353
+ projectRoot,
354
+ provider = null,
355
+ providerSkillRoots = {},
356
+ stateRoot = null,
357
+ codexToolsRoot = null,
358
+ componentSettings = {},
359
+ authorizations = {},
360
+ componentStateOverrides = {},
361
+ environment = process.env,
362
+ nodePath = process.execPath,
363
+ trustedSkillEngineering = null,
364
+ } = {}) {
365
+ if (typeof installRoot !== 'string' || !installRoot.trim() ||
366
+ typeof projectRoot !== 'string' || !projectRoot.trim()) {
367
+ throw new TypeError('installRoot and projectRoot are required non-empty paths');
368
+ }
369
+ const resolvedInstallRoot = resolve(installRoot);
370
+ const resolvedProjectRoot = resolve(projectRoot);
371
+ // Usage Tracking is a Codex/Windows toolset installed under the provider's
372
+ // tools root, outside the shared AFYX runtime directory.
373
+ const resolvedToolsRoot = provider === 'codex' && process.platform === 'win32'
374
+ ? resolve(codexToolsRoot ?? join(homedir(), '.codex', 'tools')) : null;
375
+ const known = inspectKnownComponents({
376
+ installRoot: resolvedInstallRoot,
377
+ projectRoot: resolvedProjectRoot,
378
+ provider,
379
+ providerSkillRoots,
380
+ codexToolsRoot: resolvedToolsRoot,
381
+ nodePath,
382
+ componentSettings,
383
+ authorizations,
384
+ environment,
385
+ componentStateOverrides,
386
+ });
387
+ const dynamic = discoverDynamicComponents({
388
+ installRoot: resolvedInstallRoot,
389
+ componentSettings,
390
+ authorizations,
391
+ environment,
392
+ nodePath,
393
+ });
394
+ // A native skill adapter exists only when a trusted in-process host supplies
395
+ // the complete write plan and a callable owner-approval boundary. Never infer
396
+ // this from an agent task or the general AFYX source inventory.
397
+ if (trustedSkillEngineering && trustedSkillEngineering.provider !== provider) {
398
+ throw new Error('TRUSTED_SKILL_PROVIDER_MISMATCH');
399
+ }
400
+ const nativeSkill = trustedSkillEngineering
401
+ ? createNativeSkillHostAdapter(trustedSkillEngineering) : null;
402
+ const nativeSkillState = nativeSkill ? {
403
+ installed: true,
404
+ enabled: componentEnabled('afyx-skill-engineering', componentSettings?.['afyx-skill-engineering'], environment),
405
+ healthy: true, compatible: true,
406
+ authorized: authorizations?.['afyx-skill-engineering'] === true,
407
+ sourceIdentity: nativeSkill.sourceIdentity,
408
+ observationSource: 'TRUSTED_HOST_ADAPTER',
409
+ } : null;
410
+ const adapters = {
411
+ ...createInstalledHostAdapters({
412
+ installRoot: resolvedInstallRoot,
413
+ projectRoot: resolvedProjectRoot,
414
+ graphIndexRoot: known.states['afyx-graph']?.indexRoot ?? null,
415
+ skillRoots: Object.fromEntries(known.evidence
416
+ .filter((item) => KNOWN_LAYOUT[item.componentId]?.root[0] === 'skills' && item.installed)
417
+ .map((item) => [item.componentId, item.root])),
418
+ stateRoot,
419
+ codexToolsRoot: resolvedToolsRoot,
420
+ nodePath,
421
+ environment,
422
+ }),
423
+ ...dynamic.adapters,
424
+ ...(nativeSkill ? { 'afyx-skill-engineering': nativeSkill.adapter } : {}),
425
+ };
426
+ return Object.freeze({
427
+ contract: AFYX_UNIVERSAL_RUNTIME_CONTRACT,
428
+ installRoot: resolvedInstallRoot,
429
+ projectRoot: resolvedProjectRoot,
430
+ provider,
431
+ providerSkillRoots,
432
+ componentStates: Object.freeze({ ...known.states, ...dynamic.states,
433
+ ...(nativeSkillState ? { 'afyx-skill-engineering': nativeSkillState } : {}) }),
434
+ adapters: Object.freeze(adapters),
435
+ discoveryEvidence: Object.freeze([...known.evidence, ...dynamic.evidence,
436
+ ...(nativeSkill ? [Object.freeze({ componentId: 'afyx-skill-engineering',
437
+ installed: true, sourceIdentity: nativeSkill.sourceIdentity,
438
+ observationSource: 'TRUSTED_HOST_ADAPTER' })] : [])]),
439
+ dispose() {},
440
+ });
441
+ }
442
+
443
+ /** Discover, select, and execute only the capabilities justified by one task. */
444
+ export async function runInstalledAfyxWorkflow(options = {}) {
445
+ const task = options.task ?? {};
446
+ const routeOptions = {
447
+ task,
448
+ provider: options.provider ?? null,
449
+ providerPermissions: options.providerPermissions ?? {},
450
+ hostAuthorizations: options.hostAuthorizations ?? {},
451
+ userPreferences: options.userPreferences ?? {},
452
+ budgetLimits: options.budgetLimits,
453
+ environment: options.environment ?? process.env,
454
+ };
455
+ if (classifyTaskIntent(task).directSource) {
456
+ return executeAfyxCapabilityRoute({
457
+ ...routeOptions,
458
+ componentStates: {},
459
+ adapters: {},
460
+ });
461
+ }
462
+ const runtime = createInstalledAfyxRuntime(options);
463
+ try {
464
+ return await executeAfyxCapabilityRoute({
465
+ ...routeOptions,
466
+ componentStates: runtime.componentStates,
467
+ adapters: runtime.adapters,
468
+ });
469
+ } finally {
470
+ runtime.dispose();
471
+ }
472
+ }
473
+
474
+ export {
475
+ AFYX_HOST_BRIDGE_CONTRACT,
476
+ invokeHostWorkflow,
477
+ serveHostMcpBridge,
478
+ } from './afyx-host-bridge.mjs';
479
+
480
+ function argumentValue(flag) {
481
+ const index = process.argv.indexOf(flag);
482
+ return index >= 0 && index + 1 < process.argv.length ? process.argv[index + 1] : null;
483
+ }
484
+
485
+ async function main() {
486
+ if (process.argv.includes('--mcp') || (process.argv.includes('serve') && process.argv.includes('--mcp'))) {
487
+ const { serveHostMcpBridge } = await import('./afyx-host-bridge.mjs');
488
+ const installRoot = argumentValue('--install-root');
489
+ const projectRoot = argumentValue('--project-root');
490
+ const provider = argumentValue('--provider') || 'antigravity';
491
+ serveHostMcpBridge({ installRoot, projectRoot, provider });
492
+ return;
493
+ }
494
+
495
+ const installRoot = argumentValue('--install-root') || process.env.AFYX_INSTALL_ROOT;
496
+ const projectRoot = argumentValue('--project-root') || process.cwd();
497
+ const taskFile = argumentValue('--task-file');
498
+ const taskArg = argumentValue('--task');
499
+ const provider = argumentValue('--provider');
500
+ const authorizedIds = new Set((argumentValue('--authorize') ?? '').split(',').filter(Boolean));
501
+ if (!installRoot || !projectRoot || (!taskFile && !taskArg)) {
502
+ throw new Error('--install-root, --project-root, and either --task-file or --task are required');
503
+ }
504
+ let task = null;
505
+ if (taskArg) {
506
+ task = JSON.parse(taskArg);
507
+ } else if (taskFile === '-') {
508
+ task = JSON.parse(readFileSync(0, 'utf8'));
509
+ } else {
510
+ task = JSON.parse(readFileSync(resolve(taskFile), 'utf8'));
511
+ }
512
+ const authorizations = Object.fromEntries([...authorizedIds].map((id) => [id, true]));
513
+ const result = await runInstalledAfyxWorkflow({
514
+ installRoot,
515
+ projectRoot,
516
+ task,
517
+ provider,
518
+ authorizations,
519
+ providerPermissions: authorizations,
520
+ });
521
+ process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
522
+ if (result.status === 'FAILED' || result.status === 'BLOCKED') process.exitCode = 2;
523
+ }
524
+
525
+ if (process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1])) {
526
+ main().catch((error) => {
527
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
528
+ process.exitCode = 1;
529
+ });
530
+ }