aontu 0.52.1 → 0.54.0

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 (310) hide show
  1. package/README.md +88 -0
  2. package/bin/aontu-mcp.js +4 -0
  3. package/dist/agentsmd.d.ts +16 -0
  4. package/dist/agentsmd.js +107 -0
  5. package/dist/agentsmd.js.map +1 -0
  6. package/dist/aontu.d.ts +15 -3
  7. package/dist/aontu.js +126 -5
  8. package/dist/aontu.js.map +1 -1
  9. package/dist/cli.d.ts +45 -1
  10. package/dist/cli.js +2845 -69
  11. package/dist/cli.js.map +1 -1
  12. package/dist/ctx.d.ts +18 -0
  13. package/dist/ctx.js +44 -0
  14. package/dist/ctx.js.map +1 -1
  15. package/dist/diff.d.ts +22 -0
  16. package/dist/diff.js +141 -0
  17. package/dist/diff.js.map +1 -0
  18. package/dist/err.d.ts +3 -1
  19. package/dist/err.js +45 -8
  20. package/dist/err.js.map +1 -1
  21. package/dist/graph.d.ts +13 -0
  22. package/dist/graph.js +110 -0
  23. package/dist/graph.js.map +1 -0
  24. package/dist/hcanon.d.ts +3 -0
  25. package/dist/hcanon.js +145 -0
  26. package/dist/hcanon.js.map +1 -0
  27. package/dist/hints.js +235 -8
  28. package/dist/hints.js.map +1 -1
  29. package/dist/jsonschema.d.ts +20 -0
  30. package/dist/jsonschema.js +425 -0
  31. package/dist/jsonschema.js.map +1 -0
  32. package/dist/lang.js +955 -110
  33. package/dist/lang.js.map +1 -1
  34. package/dist/lsp.d.ts +9 -2
  35. package/dist/lsp.js +343 -48
  36. package/dist/lsp.js.map +1 -1
  37. package/dist/mcp-server.d.ts +20 -0
  38. package/dist/mcp-server.js +147 -0
  39. package/dist/mcp-server.js.map +1 -0
  40. package/dist/mcp.d.ts +42 -0
  41. package/dist/mcp.js +941 -0
  42. package/dist/mcp.js.map +1 -0
  43. package/dist/mod-tool.d.ts +58 -0
  44. package/dist/mod-tool.js +532 -0
  45. package/dist/mod-tool.js.map +1 -0
  46. package/dist/mod.d.ts +35 -0
  47. package/dist/mod.js +345 -0
  48. package/dist/mod.js.map +1 -0
  49. package/dist/patch.d.ts +49 -0
  50. package/dist/patch.js +506 -0
  51. package/dist/patch.js.map +1 -0
  52. package/dist/provenance.d.ts +41 -0
  53. package/dist/provenance.js +336 -0
  54. package/dist/provenance.js.map +1 -0
  55. package/dist/query.d.ts +27 -0
  56. package/dist/query.js +294 -0
  57. package/dist/query.js.map +1 -0
  58. package/dist/reach.d.ts +15 -0
  59. package/dist/reach.js +168 -0
  60. package/dist/reach.js.map +1 -0
  61. package/dist/relation.d.ts +23 -0
  62. package/dist/relation.js +230 -0
  63. package/dist/relation.js.map +1 -0
  64. package/dist/report-sarif.d.ts +14 -0
  65. package/dist/report-sarif.js +102 -0
  66. package/dist/report-sarif.js.map +1 -0
  67. package/dist/sig.d.ts +25 -0
  68. package/dist/sig.js +277 -0
  69. package/dist/sig.js.map +1 -0
  70. package/dist/sigdecl.d.ts +2 -0
  71. package/dist/sigdecl.js +11 -0
  72. package/dist/sigdecl.js.map +1 -0
  73. package/dist/siggate.d.ts +4 -0
  74. package/dist/siggate.js +90 -0
  75. package/dist/siggate.js.map +1 -0
  76. package/dist/site.d.ts +4 -0
  77. package/dist/site.js +31 -0
  78. package/dist/site.js.map +1 -1
  79. package/dist/std.d.ts +1 -0
  80. package/dist/std.js +129 -0
  81. package/dist/std.js.map +1 -0
  82. package/dist/subsume.d.ts +39 -0
  83. package/dist/subsume.js +573 -0
  84. package/dist/subsume.js.map +1 -0
  85. package/dist/trim.d.ts +19 -0
  86. package/dist/trim.js +155 -0
  87. package/dist/trim.js.map +1 -0
  88. package/dist/tsconfig.tsbuildinfo +1 -1
  89. package/dist/type.d.ts +17 -1
  90. package/dist/type.js.map +1 -1
  91. package/dist/unify.d.ts +2 -1
  92. package/dist/unify.js +234 -38
  93. package/dist/unify.js.map +1 -1
  94. package/dist/utility.d.ts +8 -1
  95. package/dist/utility.js +68 -1
  96. package/dist/utility.js.map +1 -1
  97. package/dist/val/AggFuncVal.d.ts +44 -0
  98. package/dist/val/AggFuncVal.js +364 -0
  99. package/dist/val/AggFuncVal.js.map +1 -0
  100. package/dist/val/ArithFuncVal.d.ts +31 -0
  101. package/dist/val/ArithFuncVal.js +62 -0
  102. package/dist/val/ArithFuncVal.js.map +1 -0
  103. package/dist/val/BagVal.d.ts +7 -0
  104. package/dist/val/BagVal.js +150 -11
  105. package/dist/val/BagVal.js.map +1 -1
  106. package/dist/val/CloseFuncVal.js +9 -1
  107. package/dist/val/CloseFuncVal.js.map +1 -1
  108. package/dist/val/ConjunctVal.d.ts +1 -1
  109. package/dist/val/ConjunctVal.js +19 -0
  110. package/dist/val/ConjunctVal.js.map +1 -1
  111. package/dist/val/ConstraintVal.d.ts +7 -1
  112. package/dist/val/ConstraintVal.js +523 -45
  113. package/dist/val/ConstraintVal.js.map +1 -1
  114. package/dist/val/ContainerKindVal.d.ts +35 -0
  115. package/dist/val/ContainerKindVal.js +99 -0
  116. package/dist/val/ContainerKindVal.js.map +1 -0
  117. package/dist/val/CopyFuncVal.d.ts +1 -2
  118. package/dist/val/CopyFuncVal.js.map +1 -1
  119. package/dist/val/Decimal.d.ts +1 -0
  120. package/dist/val/Decimal.js +13 -0
  121. package/dist/val/Decimal.js.map +1 -1
  122. package/dist/val/DeprecateFuncVal.d.ts +11 -0
  123. package/dist/val/DeprecateFuncVal.js +47 -0
  124. package/dist/val/DeprecateFuncVal.js.map +1 -0
  125. package/dist/val/DisjunctVal.d.ts +1 -2
  126. package/dist/val/DisjunctVal.js +269 -53
  127. package/dist/val/DisjunctVal.js.map +1 -1
  128. package/dist/val/EachFuncVal.d.ts +15 -0
  129. package/dist/val/EachFuncVal.js +75 -0
  130. package/dist/val/EachFuncVal.js.map +1 -0
  131. package/dist/val/ExpectVal.js +62 -4
  132. package/dist/val/ExpectVal.js.map +1 -1
  133. package/dist/val/FeatureVal.js +1 -1
  134. package/dist/val/FeatureVal.js.map +1 -1
  135. package/dist/val/FilterFuncVal.d.ts +15 -0
  136. package/dist/val/FilterFuncVal.js +91 -0
  137. package/dist/val/FilterFuncVal.js.map +1 -0
  138. package/dist/val/FuncBaseVal.d.ts +7 -1
  139. package/dist/val/FuncBaseVal.js +183 -2
  140. package/dist/val/FuncBaseVal.js.map +1 -1
  141. package/dist/val/GraphAtomVal.d.ts +39 -0
  142. package/dist/val/GraphAtomVal.js +184 -0
  143. package/dist/val/GraphAtomVal.js.map +1 -0
  144. package/dist/val/HideFuncVal.js.map +1 -1
  145. package/dist/val/JunctionVal.js +24 -1
  146. package/dist/val/JunctionVal.js.map +1 -1
  147. package/dist/val/KeyFuncVal.d.ts +1 -1
  148. package/dist/val/KeyFuncVal.js +38 -30
  149. package/dist/val/KeyFuncVal.js.map +1 -1
  150. package/dist/val/ListVal.js +94 -14
  151. package/dist/val/ListVal.js.map +1 -1
  152. package/dist/val/LowerFuncVal.js.map +1 -1
  153. package/dist/val/MapVal.d.ts +1 -0
  154. package/dist/val/MapVal.js +146 -14
  155. package/dist/val/MapVal.js.map +1 -1
  156. package/dist/val/MatchFuncVal.d.ts +15 -0
  157. package/dist/val/MatchFuncVal.js +107 -0
  158. package/dist/val/MatchFuncVal.js.map +1 -0
  159. package/dist/val/MoveFuncVal.js.map +1 -1
  160. package/dist/val/NilVal.js +24 -0
  161. package/dist/val/NilVal.js.map +1 -1
  162. package/dist/val/OpBaseVal.d.ts +1 -1
  163. package/dist/val/OpBaseVal.js +19 -1
  164. package/dist/val/OpBaseVal.js.map +1 -1
  165. package/dist/val/OpenFuncVal.js +4 -1
  166. package/dist/val/OpenFuncVal.js.map +1 -1
  167. package/dist/val/PackFuncVal.d.ts +15 -0
  168. package/dist/val/PackFuncVal.js +108 -0
  169. package/dist/val/PackFuncVal.js.map +1 -0
  170. package/dist/val/PathFuncVal.d.ts +2 -2
  171. package/dist/val/PathFuncVal.js +75 -16
  172. package/dist/val/PathFuncVal.js.map +1 -1
  173. package/dist/val/PathVal.d.ts +25 -0
  174. package/dist/val/PathVal.js +150 -0
  175. package/dist/val/PathVal.js.map +1 -0
  176. package/dist/val/PlaceVal.d.ts +13 -0
  177. package/dist/val/PlaceVal.js +131 -0
  178. package/dist/val/PlaceVal.js.map +1 -0
  179. package/dist/val/PlusOpVal.d.ts +2 -1
  180. package/dist/val/PlusOpVal.js +61 -37
  181. package/dist/val/PlusOpVal.js.map +1 -1
  182. package/dist/val/PrefFuncVal.js.map +1 -1
  183. package/dist/val/PrefVal.d.ts +4 -2
  184. package/dist/val/PrefVal.js +223 -41
  185. package/dist/val/PrefVal.js.map +1 -1
  186. package/dist/val/RecurseVal.d.ts +19 -0
  187. package/dist/val/RecurseVal.js +217 -0
  188. package/dist/val/RecurseVal.js.map +1 -0
  189. package/dist/val/RefVal.d.ts +3 -2
  190. package/dist/val/RefVal.js +181 -66
  191. package/dist/val/RefVal.js.map +1 -1
  192. package/dist/val/ReferFuncVal.d.ts +59 -0
  193. package/dist/val/ReferFuncVal.js +604 -0
  194. package/dist/val/ReferFuncVal.js.map +1 -0
  195. package/dist/val/ScalarKindVal.d.ts +4 -3
  196. package/dist/val/ScalarKindVal.js +12 -12
  197. package/dist/val/ScalarKindVal.js.map +1 -1
  198. package/dist/val/SuperFuncVal.d.ts +4 -2
  199. package/dist/val/SuperFuncVal.js +118 -14
  200. package/dist/val/SuperFuncVal.js.map +1 -1
  201. package/dist/val/TopVal.d.ts +1 -1
  202. package/dist/val/TopVal.js.map +1 -1
  203. package/dist/val/TypeFuncVal.js.map +1 -1
  204. package/dist/val/UpperFuncVal.js.map +1 -1
  205. package/dist/val/Val.d.ts +7 -1
  206. package/dist/val/Val.js +170 -2
  207. package/dist/val/Val.js.map +1 -1
  208. package/dist/val/VarVal.js.map +1 -1
  209. package/dist/val/arith.d.ts +6 -0
  210. package/dist/val/arith.js +173 -0
  211. package/dist/val/arith.js.map +1 -0
  212. package/dist/vet.d.ts +45 -0
  213. package/dist/vet.js +802 -0
  214. package/dist/vet.js.map +1 -0
  215. package/dist/view.d.ts +85 -0
  216. package/dist/view.js +1948 -0
  217. package/dist/view.js.map +1 -0
  218. package/dist/walk.d.ts +2 -0
  219. package/dist/walk.js +91 -0
  220. package/dist/walk.js.map +1 -0
  221. package/grammar/aontu.gbnf +138 -0
  222. package/grammar/aontu.lark +118 -0
  223. package/grammar/aontu.tmLanguage.json +184 -0
  224. package/package.json +30 -8
  225. package/skill/SKILL.md +37 -0
  226. package/skill/error-codes.md +62 -0
  227. package/skill/examples.md +99 -0
  228. package/skill/grammar-card.md +56 -0
  229. package/src/agentsmd.ts +135 -0
  230. package/src/aontu.ts +166 -5
  231. package/src/cli.ts +3324 -72
  232. package/src/ctx.ts +93 -1
  233. package/src/diff.ts +198 -0
  234. package/src/err.ts +50 -8
  235. package/src/graph.ts +185 -0
  236. package/src/hcanon.ts +167 -0
  237. package/src/hints.ts +291 -8
  238. package/src/jsonschema.ts +552 -0
  239. package/src/lang.ts +1049 -110
  240. package/src/lsp.ts +351 -49
  241. package/src/mcp-server.ts +187 -0
  242. package/src/mcp.ts +1130 -0
  243. package/src/mod-tool.ts +718 -0
  244. package/src/mod.ts +453 -0
  245. package/src/patch.ts +628 -0
  246. package/src/provenance.ts +437 -0
  247. package/src/query.ts +381 -0
  248. package/src/reach.ts +213 -0
  249. package/src/relation.ts +298 -0
  250. package/src/report-sarif.ts +137 -0
  251. package/src/sig.ts +345 -0
  252. package/src/sigdecl.ts +11 -0
  253. package/src/siggate.ts +144 -0
  254. package/src/site.ts +36 -1
  255. package/src/std.ts +131 -0
  256. package/src/subsume.ts +739 -0
  257. package/src/trim.ts +195 -0
  258. package/src/tsconfig.json +10 -4
  259. package/src/type.ts +51 -2
  260. package/src/unify.ts +253 -38
  261. package/src/utility.ts +79 -1
  262. package/src/val/AggFuncVal.ts +546 -0
  263. package/src/val/ArithFuncVal.ts +108 -0
  264. package/src/val/BagVal.ts +158 -12
  265. package/src/val/CloseFuncVal.ts +9 -1
  266. package/src/val/ConjunctVal.ts +20 -0
  267. package/src/val/ConstraintVal.ts +576 -48
  268. package/src/val/ContainerKindVal.ts +158 -0
  269. package/src/val/CopyFuncVal.ts +0 -1
  270. package/src/val/Decimal.ts +15 -0
  271. package/src/val/DeprecateFuncVal.ts +84 -0
  272. package/src/val/DisjunctVal.ts +282 -59
  273. package/src/val/EachFuncVal.ts +133 -0
  274. package/src/val/ExpectVal.ts +65 -8
  275. package/src/val/FeatureVal.ts +1 -1
  276. package/src/val/FilterFuncVal.ts +154 -0
  277. package/src/val/FuncBaseVal.ts +206 -2
  278. package/src/val/GraphAtomVal.ts +264 -0
  279. package/src/val/HideFuncVal.ts +0 -2
  280. package/src/val/JunctionVal.ts +24 -1
  281. package/src/val/KeyFuncVal.ts +39 -35
  282. package/src/val/ListVal.ts +101 -15
  283. package/src/val/LowerFuncVal.ts +0 -1
  284. package/src/val/MapVal.ts +153 -14
  285. package/src/val/MatchFuncVal.ts +176 -0
  286. package/src/val/MoveFuncVal.ts +0 -2
  287. package/src/val/NilVal.ts +25 -0
  288. package/src/val/OpBaseVal.ts +20 -1
  289. package/src/val/OpenFuncVal.ts +4 -2
  290. package/src/val/PackFuncVal.ts +175 -0
  291. package/src/val/PathFuncVal.ts +107 -20
  292. package/src/val/PathVal.ts +221 -0
  293. package/src/val/PlaceVal.ts +193 -0
  294. package/src/val/PlusOpVal.ts +67 -39
  295. package/src/val/PrefFuncVal.ts +0 -1
  296. package/src/val/PrefVal.ts +251 -60
  297. package/src/val/RecurseVal.ts +285 -0
  298. package/src/val/RefVal.ts +183 -78
  299. package/src/val/ReferFuncVal.ts +732 -0
  300. package/src/val/ScalarKindVal.ts +12 -13
  301. package/src/val/SuperFuncVal.ts +137 -13
  302. package/src/val/TopVal.ts +1 -2
  303. package/src/val/TypeFuncVal.ts +0 -2
  304. package/src/val/UpperFuncVal.ts +0 -1
  305. package/src/val/Val.ts +216 -4
  306. package/src/val/VarVal.ts +0 -1
  307. package/src/val/arith.ts +319 -0
  308. package/src/vet.ts +1025 -0
  309. package/src/view.ts +2563 -0
  310. package/src/walk.ts +99 -0
package/src/aontu.ts CHANGED
@@ -12,7 +12,19 @@ import { MapVal } from './val/MapVal'
12
12
  import { Decimal } from './val/Decimal'
13
13
  import { exactJSON } from './exactjson'
14
14
  import { formatExplain } from './utility'
15
- import { makeNilErr, descErr, AontuError } from './err'
15
+ import { makeNilErr, descErr, AontuError, setColor, colorActive } from './err'
16
+ import { vet } from './vet'
17
+ import { sarifReport } from './report-sarif'
18
+ import { subsume } from './subsume'
19
+ import { trimCheck } from './trim'
20
+ import { hcanon, canonHash } from './hcanon'
21
+ import { get, why } from './query'
22
+ import { patch } from './patch'
23
+ import { diff } from './diff'
24
+ import { agentsMd } from './agentsmd'
25
+ import { graphOf } from './graph'
26
+ import { relationCheck, relationErrors } from './relation'
27
+ import { view, viewSet, viewTree } from './view'
16
28
 
17
29
 
18
30
  // VERSION is the Aontu npm package version, and mirrors
@@ -22,7 +34,18 @@ import { makeNilErr, descErr, AontuError } from './err'
22
34
  // Kept in step with package.json by the `version` npm lifecycle script,
23
35
  // which runs on `npm version` / `npm run repo-bump`. version.test.ts
24
36
  // fails if the two ever drift.
25
- const VERSION = '0.52.1'
37
+ const VERSION = '0.54.0'
38
+
39
+
40
+ // A module file's VALUE, as far as it goes. COLLECTED, not raised: a
41
+ // module file that does not stand up has no `mod.main` to read, and
42
+ // the default entry name is the answer -- the resolution itself fails
43
+ // later, on the file that is not there, rather than here on a metadata
44
+ // read. That is what a collecting context does, so there is nothing to
45
+ // catch: it answers what it could generate and records the rest.
46
+ function genQuiet(val: any, aontu: Aontu): any {
47
+ return val.gen(aontu.ctx({ collect: true }))
48
+ }
26
49
 
27
50
 
28
51
  class Aontu {
@@ -32,6 +55,42 @@ class Aontu {
32
55
 
33
56
  constructor(popts?: AontuOptions) {
34
57
  this.opts = popts ?? {}
58
+
59
+ // THE MODULE EVALUATOR (G6 phase 2, ts/src/mod.ts). Resolving a
60
+ // module import needs two answers that only evaluation can give:
61
+ // what a module file SAYS (its `mod.main`), and what a module
62
+ // MEANS (its canon-hash, for the integrity check). Injected here
63
+ // rather than imported there, because the resolver runs inside a
64
+ // parse that this class started, and the file it runs in cannot
65
+ // import this one without closing a cycle around the language.
66
+ //
67
+ // COLLECTED, not raised: a module that leans on consumer context
68
+ // (a `$.x` its importer supplies) does not stand up alone, and its
69
+ // hash is still the hash of what it says — that residue is part of
70
+ // the hashed meaning, which is why `hcanon` keeps it in textual
71
+ // form (docs/capability-review/g6-distribution.md).
72
+ ;(this.opts as any).mod = {
73
+ ...((this.opts as any).mod ?? {}),
74
+ eval: (this.opts as any).mod?.eval ?? ((src: string, path: string) => {
75
+ // One deeper: a module verified from inside a module
76
+ // verification is one more level of nesting, and the resolver
77
+ // refuses past its bound (MODULE_MAX_DEPTH in ts/src/mod.ts).
78
+ const inner = new Aontu({
79
+ ...this.opts,
80
+ mod: {
81
+ // Never absent: the assignment this closure is part of has
82
+ // already run by the time it is called.
83
+ ...(this.opts as any).mod,
84
+ eval: undefined,
85
+ depth: (((this.opts as any).mod?.depth ?? 0) as number) + 1,
86
+ },
87
+ } as any)
88
+ const ctx = inner.ctx({ collect: true })
89
+ const val = inner.unify(src, { path }, ctx)
90
+ return { gen: genQuiet(val, inner), hash: canonHash(val) }
91
+ }),
92
+ }
93
+
35
94
  this.lang = new Lang(this.opts)
36
95
  }
37
96
 
@@ -40,6 +99,11 @@ class Aontu {
40
99
  ctx(cfg?: AontuContextConfig): AontuContext {
41
100
  cfg = cfg ?? {}
42
101
  cfg.fs = cfg.fs ?? this.opts.fs
102
+ // The trust profile rides the instance (its resolver is built once,
103
+ // in the Lang constructor); the context needs it too, for the
104
+ // budgets (G5, docs/trust.md).
105
+ cfg.opts = cfg.opts ?? {}
106
+ ; (cfg.opts as any).trust = (cfg.opts as any).trust ?? this.opts.trust
43
107
  const ac = new AontuContext(cfg)
44
108
  return ac
45
109
  }
@@ -85,7 +149,11 @@ class Aontu {
85
149
 
86
150
  if (0 === errs.length) {
87
151
  out = runparse(src, this.lang, ac)
88
- out.deps = ac.deps
152
+ // The include MANIFEST (G5, docs/trust.md): the resolved include
153
+ // closure as `{ path, capability }`, sorted and deduplicated so
154
+ // it is deterministic — the "file set" of hermeticity clause 1
155
+ // made observable. Content hashing and pinning stay with G6.
156
+ out.deps = manifestOf(ac.manifest)
89
157
  ac.root = out
90
158
  }
91
159
 
@@ -130,6 +198,11 @@ class Aontu {
130
198
  out = uni.res
131
199
 
132
200
  out.deps = pval.deps
201
+ // THE DERIVED STRUCTURE (G4 phase 3): the edge set, computed
202
+ // once from the unified tree. Cheap on a document with no links
203
+ // — one guarded walk — and the thing impact analysis and the
204
+ // relation checks are traversals over.
205
+ out.graph = graphOf(out)
133
206
  out.err = errs
134
207
  ac.root = out
135
208
  }
@@ -169,7 +242,33 @@ class Aontu {
169
242
 
170
243
  if (undefined !== uval && 0 === uval.err.length) {
171
244
 
172
- out = uval.isNil ? (ac.adderr(uval as any), undefined) : uval.gen(ac as any)
245
+ out = uval.isNil ? (ac.adderr(uval as any), undefined)
246
+ : 0 < ac.err.length ? undefined
247
+ : uval.gen(ac as any)
248
+
249
+ // The relation verdict (RELATIONS P2): declarations the
250
+ // graph atoms registered during unification are decided
251
+ // HERE, where no more information can arrive -- the sizing
252
+ // atoms' model. A violated declaration is a located
253
+ // evaluation error at the offending edge, and the generated
254
+ // value is discarded below.
255
+ //
256
+ // AFTER GENERATION, and only when generation SUCCEEDED. A
257
+ // document that cannot be generated has no finished model
258
+ // to have a graph verdict about: an unsettled disjunction
259
+ // leaves alternatives the graph walk cannot read, so a
260
+ // mirror the document writes is absent from the edge set
261
+ // and `inverse(n)` reports it missing -- a false finding,
262
+ // and one that buried the `disjunct_no_gen` that actually
263
+ // stopped the document. The check that a broken document is
264
+ // not blamed on its relations (`relations` verb, finding F)
265
+ // holds here too.
266
+ if (!uval.isNil && 0 === ac.err.length) {
267
+ relationErrors(ac as any, uval)
268
+ if (0 < ac.err.length) {
269
+ out = undefined
270
+ }
271
+ }
173
272
 
174
273
  if (0 < ac.err.length) {
175
274
  if (!ac.collect) {
@@ -266,12 +365,38 @@ function findConflictMarker(src: string): {
266
365
  }
267
366
 
268
367
 
368
+ // Sort and deduplicate the raw manifest sink into the deterministic
369
+ // include closure: by path then capability, code-point order, one entry
370
+ // per (path, capability) pair.
371
+ function manifestOf(
372
+ sink: { path: string, capability: string }[]
373
+ ): { path: string, capability: string }[] {
374
+ const seen = new Set<string>()
375
+ const out: { path: string, capability: string }[] = []
376
+ for (const dep of sink) {
377
+ const key = dep.path + ' ' + dep.capability
378
+ if (!seen.has(key)) {
379
+ seen.add(key)
380
+ out.push({ path: dep.path, capability: dep.capability })
381
+ }
382
+ }
383
+ // No equal case: entries were deduplicated on exactly this key.
384
+ out.sort((a, b) => {
385
+ const ka = a.path + ' ' + a.capability
386
+ const kb = b.path + ' ' + b.capability
387
+ return ka < kb ? -1 : 1
388
+ })
389
+ return out
390
+ }
391
+
392
+
269
393
  // Perform parse of source code (minor customizations over Lang.parse).
270
394
  function runparse(src: string, lang: Lang, ctx: AontuContext): Val {
271
395
  const popts = {
272
396
  deps: ctx.deps,
273
397
  fs: ctx.fs,
274
- path: ctx.opts.path
398
+ path: ctx.opts.path,
399
+ manifest: ctx.manifest,
275
400
  }
276
401
  let val
277
402
 
@@ -301,6 +426,8 @@ export {
301
426
  AontuOptions,
302
427
  AontuContext,
303
428
  AontuError,
429
+ setColor,
430
+ colorActive,
304
431
 
305
432
  Val,
306
433
  Lang,
@@ -314,6 +441,40 @@ export {
314
441
  // `biginteger` generates as the language's own `bigint`).
315
442
  exactJSON,
316
443
  Decimal,
444
+
445
+ // G2 phase 2 -- the validation verb. The engine only: the CLI verb
446
+ // and the text/JSON renderers are phase 3, the Go port phase 4.
447
+ // `sarifReport` (phase 5) is library API so an embedder can emit the
448
+ // interchange form without shelling out.
449
+ vet,
450
+ sarifReport,
451
+
452
+ // G3 -- subsumption as a first-class query: does the general value
453
+ // admit every instance the specific value admits? Three-valued, with
454
+ // G2-shaped findings (class `compat`).
455
+ subsume,
456
+ trimCheck,
457
+
458
+ // G6 -- the hash form and the canon-hash pin. `hcanon` is the
459
+ // unify-level canon plus the close()/type()/hide() wrappers that
460
+ // close its semantic gaps; `canonHash` is
461
+ // "aon1-" + base64url(SHA-256(UTF-8(hcanon(v)))).
462
+ hcanon,
463
+ canonHash,
464
+
465
+ // G7 -- the machine-facing query surface: select one node by path
466
+ // and render it, plainly (json/canon) or as a lattice ABSTRACTION
467
+ // (types/depth/keys) that subsumes the truth it summarises.
468
+ get,
469
+ why,
470
+ patch,
471
+ diff,
472
+ agentsMd,
473
+ graphOf,
474
+ relationCheck,
475
+ view,
476
+ viewSet,
477
+ viewTree,
317
478
  }
318
479
 
319
480