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

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,273 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+
4
+ PACKAGE_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
5
+ SOURCE_ROOT="$PACKAGE_ROOT/afyx-forge"
6
+ ARTIFACT_STAGER="$PACKAGE_ROOT/scripts/afyx-forge-artifact.mjs"
7
+ runtime_root="${AFYX_FORGE_RUNTIME_ROOT:-$HOME/.afyx/forge}"
8
+ source_revision=""
9
+ update=false; repair=false; verify=false; uninstall=false; validate_only=false
10
+
11
+ while (($#)); do
12
+ case "$1" in
13
+ --runtime-root) (($# >= 2)) || { printf '%s\n' '--runtime-root requires a value.' >&2; exit 2; }; runtime_root="$2"; shift 2 ;;
14
+ --source-revision) (($# >= 2)) || { printf '%s\n' '--source-revision requires a value.' >&2; exit 2; }; source_revision="$2"; shift 2 ;;
15
+ --update) update=true; shift ;;
16
+ --repair) repair=true; shift ;;
17
+ --verify) verify=true; shift ;;
18
+ --uninstall) uninstall=true; shift ;;
19
+ --validate-only) validate_only=true; shift ;;
20
+ -h|--help) printf '%s\n' 'Usage: install-afyx-forge.sh [--runtime-root PATH] [--source-revision SHA] [--update|--repair|--verify|--uninstall|--validate-only]'; exit 0 ;;
21
+ *) printf 'Unknown option: %s\n' "$1" >&2; exit 2 ;;
22
+ esac
23
+ done
24
+
25
+ recovery_root="${runtime_root}.afyx-old"
26
+
27
+ # Path Safety & Canonical Ownership Validation
28
+ case "$runtime_root" in
29
+ /*|[A-Za-z]:/*|[A-Za-z]:\\*) ;;
30
+ *) printf '%s\n' 'Afyx Forge runtime root must be absolute.' >&2; exit 1 ;;
31
+ esac
32
+
33
+ case "$runtime_root" in
34
+ /|[A-Za-z]:/|[A-Za-z]:\\|[A-Za-z]:) printf '%s\n' 'Afyx Forge runtime root cannot be a filesystem root.' >&2; exit 1 ;;
35
+ esac
36
+
37
+ case "$runtime_root" in
38
+ *\.\.*|*\\..\\*|*/../*) printf '%s\n' 'Afyx Forge runtime root must not contain traversal segments.' >&2; exit 1 ;;
39
+ esac
40
+
41
+ normalize_path() {
42
+ local p="$1"
43
+ if [[ -d "$p" ]]; then
44
+ (cd "$p" && pwd)
45
+ else
46
+ local parent
47
+ parent="$(dirname "$p")"
48
+ if [[ -d "$parent" ]]; then
49
+ printf '%s/%s\n' "$(cd "$parent" && pwd)" "$(basename "$p")"
50
+ else
51
+ printf '%s\n' "$p"
52
+ fi
53
+ fi
54
+ }
55
+
56
+ host_path() {
57
+ if command -v cygpath >/dev/null 2>&1; then
58
+ cygpath -m "$1"
59
+ else
60
+ printf '%s\n' "$1"
61
+ fi
62
+ }
63
+
64
+ CANONICAL_SOURCE="$(normalize_path "$SOURCE_ROOT")"
65
+ CANONICAL_RUNTIME="$(normalize_path "$runtime_root")"
66
+
67
+ case "$CANONICAL_RUNTIME/" in "$CANONICAL_SOURCE/"*) printf '%s\n' 'Afyx Forge runtime root must not overlap bundled source.' >&2; exit 1 ;; esac
68
+ case "$CANONICAL_SOURCE/" in "$CANONICAL_RUNTIME/"*) printf '%s\n' 'Afyx Forge runtime root must not contain bundled source.' >&2; exit 1 ;; esac
69
+
70
+ for candidate in "$runtime_root" "$recovery_root"; do
71
+ probe="$candidate"
72
+ while [[ "$probe" != / && "$probe" != . && -n "$probe" && ! "$probe" =~ ^[A-Za-z]:[/\\]?$ ]]; do
73
+ if [[ "$probe" == "/var" || "$probe" == "/tmp" || "$probe" == "/etc" ]]; then
74
+ break
75
+ fi
76
+ [[ ! -L "$probe" ]] || { printf 'Afyx Forge runtime path must not traverse a symbolic link: %s\n' "$probe" >&2; exit 1; }
77
+ next_probe="$(dirname "$probe")"
78
+ [[ "$next_probe" != "$probe" ]] || break
79
+ probe="$next_probe"
80
+ done
81
+ done
82
+
83
+ sha256_file() {
84
+ if command -v sha256sum >/dev/null 2>&1; then
85
+ sha256sum "$1" | awk '{print $1}'
86
+ else
87
+ shasum -a 256 "$1" | awk '{print $1}'
88
+ fi
89
+ }
90
+
91
+ json_value() {
92
+ sed -n 's/.*"'"$2"'"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$1" | head -n 1
93
+ }
94
+
95
+ resolve_source_revision() {
96
+ if [[ -n "$source_revision" ]]; then
97
+ printf '%s\n' "$source_revision"
98
+ return 0
99
+ fi
100
+ if [[ -f "$PACKAGE_ROOT/.afyx-source-revision" ]]; then
101
+ tr -d '\r\n' < "$PACKAGE_ROOT/.afyx-source-revision"
102
+ printf '\n'
103
+ return 0
104
+ fi
105
+ if [[ -e "$PACKAGE_ROOT/.git" ]] && command -v git >/dev/null 2>&1; then
106
+ local rev
107
+ rev="$(git -C "$PACKAGE_ROOT" rev-parse HEAD 2>/dev/null || true)"
108
+ if [[ -n "$rev" ]]; then
109
+ printf '%s\n' "$rev"
110
+ return 0
111
+ fi
112
+ fi
113
+ printf '%s\n' 'unknown'
114
+ }
115
+
116
+ resolve_source_provenance() {
117
+ if [[ -f "$PACKAGE_ROOT/.afyx-source-revision" ]]; then
118
+ printf '%s\n' 'RELEASE_CANDIDATE_SNAPSHOT'
119
+ return 0
120
+ fi
121
+ if [[ -e "$PACKAGE_ROOT/.git" ]] && command -v git >/dev/null 2>&1 && git -C "$PACKAGE_ROOT" rev-parse HEAD >/dev/null 2>&1; then
122
+ local dirty
123
+ dirty="$(git -C "$PACKAGE_ROOT" status --porcelain -- afyx-forge 2>/dev/null || true)"
124
+ if [[ -n "$dirty" ]]; then
125
+ printf '%s\n' 'LOCAL_SOURCE_DIRTY'
126
+ else
127
+ printf '%s\n' 'LOCAL_SOURCE_CLEAN'
128
+ fi
129
+ return 0
130
+ fi
131
+ printf '%s\n' 'LOCAL_SOURCE_UNVERIFIED'
132
+ }
133
+
134
+ owned_runtime() {
135
+ local root="$1" metadata="$1/metadata.json"
136
+ [[ -f "$metadata" ]] || return 1
137
+ grep -q '"product_name"[[:space:]]*:[[:space:]]*"Afyx Forge Core"' "$metadata" || return 1
138
+ grep -q '"ownership_class"[[:space:]]*:[[:space:]]*"AFYX"' "$metadata" || return 1
139
+ return 0
140
+ }
141
+
142
+ healthy_runtime() {
143
+ local root="$1" metadata="$1/metadata.json" manifest="$1/integrity.sha256" identity="$1/current/identity.json"
144
+ local expected relative actual field line
145
+ owned_runtime "$root" || return 1
146
+ [[ -f "$root/current/bin/afyx-forge.js" && -f "$root/current/bin/afyx-forge" && -f "$root/current/LICENSE" ]] || return 1
147
+ [[ -f "$root/bin/afyx-forge" && -f "$identity" && -f "$manifest" ]] || return 1
148
+ for field in product_name product_version source_revision ownership_class build_provenance release_channel runtime_mode governance_state; do
149
+ [[ "$(json_value "$metadata" "$field")" == "$(json_value "$identity" "$field")" ]] || return 1
150
+ done
151
+ expected="$(json_value "$metadata" "artifact_digest")"
152
+ [[ ${#expected} -eq 64 && "$(sha256_file "$manifest")" == "$expected" ]] || return 1
153
+ while IFS= read -r line || [[ -n "$line" ]]; do
154
+ line="${line%$'\r'}"
155
+ [[ -n "$line" ]] || continue
156
+ expected="${line%% *}"
157
+ relative="${line#* }"
158
+ [[ "$expected" =~ ^[0-9a-f]{64}$ && "$relative" == current/* && "$relative" != *../* ]] || return 1
159
+ [[ -f "$root/$relative" && ! -L "$root/$relative" ]] || return 1
160
+ actual="$(sha256_file "$root/$relative")"
161
+ [[ "$actual" == "$expected" ]] || return 1
162
+ done < "$manifest"
163
+ return 0
164
+ }
165
+
166
+ # Transaction Recovery Check
167
+ if [[ -e "$recovery_root" ]]; then
168
+ [[ ! -e "$runtime_root" ]] || { printf '%s\n' 'Interrupted Afyx Forge transaction is ambiguous; runtime and recovery both exist.' >&2; exit 1; }
169
+ owned_runtime "$recovery_root" || { printf '%s\n' 'Interrupted Afyx Forge recovery ownership is invalid.' >&2; exit 1; }
170
+ if "$validate_only" || "$verify" || "$uninstall"; then printf '%s\n' 'Afyx Forge recovery is pending; read-only/uninstall operation will not mutate it.' >&2; exit 1; fi
171
+ mv -- "$recovery_root" "$runtime_root"
172
+ printf 'Recovered interrupted Afyx Forge transaction at %s.\n' "$runtime_root"
173
+ fi
174
+
175
+ # Determine Current State
176
+ if [[ ! -e "$runtime_root" ]]; then
177
+ state='NOT INSTALLED'
178
+ elif healthy_runtime "$runtime_root"; then
179
+ state='HEALTHY'
180
+ elif owned_runtime "$runtime_root"; then
181
+ state='BROKEN'
182
+ else
183
+ state='UNKNOWN'
184
+ fi
185
+
186
+ if "$validate_only" || "$verify"; then
187
+ rev_out=""
188
+ digest_out=""
189
+ if [[ "$state" == HEALTHY || "$state" == BROKEN ]] && [[ -f "$runtime_root/metadata.json" ]]; then
190
+ rev_out="$(json_value "$runtime_root/metadata.json" "source_revision")"
191
+ digest_out="$(json_value "$runtime_root/metadata.json" "artifact_digest")"
192
+ fi
193
+ printf 'Component: afyx-forge\nState: %s\nRuntimeRoot: %s\nVersion: 0.1.0\nSourceRevision: %s\nArtifactDigest: %s\n' "$state" "$runtime_root" "$rev_out" "$digest_out"
194
+ "$verify" && [[ "$state" != HEALTHY ]] && exit 1
195
+ exit 0
196
+ fi
197
+
198
+ if "$uninstall"; then
199
+ [[ "$state" == 'NOT INSTALLED' ]] && { printf '%s\n' 'Afyx Forge Core is already not installed.'; exit 0; }
200
+ [[ "$state" == HEALTHY || "$state" == BROKEN ]] || { printf 'Refusing to uninstall foreign or unverified directory at %s (state: %s).\n' "$runtime_root" "$state" >&2; exit 1; }
201
+ rm -rf -- "$runtime_root"
202
+ printf 'Afyx Forge Core: uninstalled from %s\n' "$runtime_root"
203
+ exit 0
204
+ fi
205
+
206
+ command -v node >/dev/null 2>&1 || { printf '%s\n' 'Node.js is required for Afyx Forge Core.' >&2; exit 1; }
207
+
208
+ [[ "$state" != UNKNOWN ]] || { printf 'Refusing to replace foreign or unowned directory at %s.\n' "$runtime_root" >&2; exit 1; }
209
+ if [[ "$state" == BROKEN && "$update" != true && "$repair" != true ]]; then
210
+ printf 'Installed Afyx Forge Core at %s is BROKEN (integrity or file drift detected). Use --repair or --update to restore it.\n' "$runtime_root" >&2
211
+ exit 1
212
+ fi
213
+ [[ "$state" != HEALTHY || "$update" == true || "$repair" == true ]] || { printf 'Afyx Forge Core: already installed and HEALTHY at %s. Use --update or --repair to reinstall.\n' "$runtime_root"; exit 0; }
214
+ if [[ "$state" == 'NOT INSTALLED' ]] && { "$update" || "$repair"; }; then
215
+ printf '%s\n' 'Update/repair requires an existing Afyx Forge runtime.' >&2
216
+ exit 1
217
+ fi
218
+
219
+ resolved_revision="$(resolve_source_revision)"
220
+ resolved_provenance="$(resolve_source_provenance)"
221
+ installed_at="$(date -u +'%Y-%m-%dT%H:%M:%SZ')"
222
+
223
+ parent="$(dirname "$runtime_root")"
224
+ mkdir -p -- "$parent"
225
+ prepared="$(mktemp -d "$parent/.forge-stage.XXXXXX")"
226
+ swapped=false
227
+
228
+ cleanup() {
229
+ local status=$?
230
+ if [[ -e "$prepared" ]]; then
231
+ rm -rf -- "$prepared" || true
232
+ fi
233
+ return "$status"
234
+ }
235
+ trap cleanup EXIT
236
+
237
+ node "$(host_path "$ARTIFACT_STAGER")" \
238
+ --source-root "$(host_path "$SOURCE_ROOT")" \
239
+ --stage-dir "$(host_path "$prepared")" \
240
+ --runtime-root "$(host_path "$CANONICAL_RUNTIME")" \
241
+ --revision "$resolved_revision" \
242
+ --provenance "$resolved_provenance" \
243
+ --installed-at "$installed_at"
244
+
245
+ # Pre-swap verification
246
+ healthy_runtime "$prepared" || { printf '%s\n' 'Staged Afyx Forge runtime failed integrity validation.' >&2; exit 1; }
247
+
248
+ # Swap with fail-closed recovery
249
+ if [[ -e "$runtime_root" ]]; then
250
+ mv -- "$runtime_root" "$recovery_root"
251
+ fi
252
+
253
+ if mv -- "$prepared" "$runtime_root"; then
254
+ swapped=true
255
+ prepared="$parent/.forge-stage-consumed"
256
+ else
257
+ [[ ! -e "$recovery_root" ]] || mv -- "$recovery_root" "$runtime_root"
258
+ printf '%s\n' 'Failed to swap staged Afyx Forge runtime into destination.' >&2
259
+ exit 1
260
+ fi
261
+
262
+ # Post-swap verification
263
+ if ! healthy_runtime "$runtime_root"; then
264
+ "$swapped" && rm -rf -- "$runtime_root"
265
+ [[ ! -e "$recovery_root" ]] || mv -- "$recovery_root" "$runtime_root"
266
+ printf '%s\n' 'Installed Afyx Forge runtime failed post-swap verification; previous state preserved.' >&2
267
+ exit 1
268
+ fi
269
+
270
+ [[ ! -e "$recovery_root" ]] || rm -rf -- "$recovery_root"
271
+
272
+ printf 'Afyx Forge Core 0.1.0: successfully installed at %s (revision=%s)\n' "$runtime_root" "$resolved_revision"
273
+ exit 0