bonescript-compiler 0.2.0 → 0.3.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 (146) hide show
  1. package/LICENSE +21 -21
  2. package/dist/algorithm_catalog.js +166 -166
  3. package/dist/cli.d.ts +2 -1
  4. package/dist/cli.js +75 -543
  5. package/dist/cli.js.map +1 -1
  6. package/dist/commands/check.d.ts +5 -0
  7. package/dist/commands/check.js +34 -0
  8. package/dist/commands/check.js.map +1 -0
  9. package/dist/commands/compile.d.ts +5 -0
  10. package/dist/commands/compile.js +183 -0
  11. package/dist/commands/compile.js.map +1 -0
  12. package/dist/commands/debug.d.ts +5 -0
  13. package/dist/commands/debug.js +59 -0
  14. package/dist/commands/debug.js.map +1 -0
  15. package/dist/commands/diff.d.ts +5 -0
  16. package/dist/commands/diff.js +125 -0
  17. package/dist/commands/diff.js.map +1 -0
  18. package/dist/commands/fmt.d.ts +5 -0
  19. package/dist/commands/fmt.js +49 -0
  20. package/dist/commands/fmt.js.map +1 -0
  21. package/dist/commands/init.d.ts +5 -0
  22. package/dist/commands/init.js +69 -0
  23. package/dist/commands/init.js.map +1 -0
  24. package/dist/commands/ir.d.ts +5 -0
  25. package/dist/commands/ir.js +27 -0
  26. package/dist/commands/ir.js.map +1 -0
  27. package/dist/commands/lex.d.ts +5 -0
  28. package/dist/commands/lex.js +21 -0
  29. package/dist/commands/lex.js.map +1 -0
  30. package/dist/commands/parse.d.ts +5 -0
  31. package/dist/commands/parse.js +30 -0
  32. package/dist/commands/parse.js.map +1 -0
  33. package/dist/commands/test.d.ts +5 -0
  34. package/dist/commands/test.js +61 -0
  35. package/dist/commands/test.js.map +1 -0
  36. package/dist/commands/verify_determinism.d.ts +5 -0
  37. package/dist/commands/verify_determinism.js +64 -0
  38. package/dist/commands/verify_determinism.js.map +1 -0
  39. package/dist/commands/watch.d.ts +5 -0
  40. package/dist/commands/watch.js +50 -0
  41. package/dist/commands/watch.js.map +1 -0
  42. package/dist/emit_auth.d.ts +6 -0
  43. package/dist/emit_auth.js +69 -0
  44. package/dist/emit_auth.js.map +1 -0
  45. package/dist/emit_capability.d.ts +13 -0
  46. package/dist/emit_capability.js +235 -125
  47. package/dist/emit_capability.js.map +1 -1
  48. package/dist/emit_database.d.ts +7 -0
  49. package/dist/emit_database.js +74 -0
  50. package/dist/emit_database.js.map +1 -0
  51. package/dist/emit_deploy.js +162 -162
  52. package/dist/emit_events.js +274 -274
  53. package/dist/emit_full.js +102 -95
  54. package/dist/emit_full.js.map +1 -1
  55. package/dist/emit_index.d.ts +6 -0
  56. package/dist/emit_index.js +157 -0
  57. package/dist/emit_index.js.map +1 -0
  58. package/dist/emit_maintenance.js +249 -249
  59. package/dist/emit_package.d.ts +7 -0
  60. package/dist/emit_package.js +70 -0
  61. package/dist/emit_package.js.map +1 -0
  62. package/dist/emit_router.d.ts +12 -0
  63. package/dist/emit_router.js +375 -0
  64. package/dist/emit_router.js.map +1 -0
  65. package/dist/emit_runtime.d.ts +17 -11
  66. package/dist/emit_runtime.js +29 -686
  67. package/dist/emit_runtime.js.map +1 -1
  68. package/dist/emit_sourcemap.js +66 -66
  69. package/dist/extension_manager.d.ts +2 -2
  70. package/dist/extension_manager.js +6 -3
  71. package/dist/extension_manager.js.map +1 -1
  72. package/dist/lowering.d.ts +5 -14
  73. package/dist/lowering.js +32 -417
  74. package/dist/lowering.js.map +1 -1
  75. package/dist/lowering_channels.d.ts +11 -0
  76. package/dist/lowering_channels.js +102 -0
  77. package/dist/lowering_channels.js.map +1 -0
  78. package/dist/lowering_entities.d.ts +11 -0
  79. package/dist/lowering_entities.js +222 -0
  80. package/dist/lowering_entities.js.map +1 -0
  81. package/dist/lowering_helpers.d.ts +13 -0
  82. package/dist/lowering_helpers.js +76 -0
  83. package/dist/lowering_helpers.js.map +1 -0
  84. package/dist/module_loader.d.ts +2 -2
  85. package/dist/module_loader.js +20 -23
  86. package/dist/module_loader.js.map +1 -1
  87. package/dist/scaffold.d.ts +2 -2
  88. package/dist/scaffold.js +316 -319
  89. package/dist/scaffold.js.map +1 -1
  90. package/package.json +62 -52
  91. package/src/algorithm_catalog.ts +345 -345
  92. package/src/ast.ts +334 -334
  93. package/src/cli.ts +98 -624
  94. package/src/commands/check.ts +33 -0
  95. package/src/commands/compile.ts +160 -0
  96. package/src/commands/debug.ts +33 -0
  97. package/src/commands/diff.ts +108 -0
  98. package/src/commands/fmt.ts +22 -0
  99. package/src/commands/init.ts +46 -0
  100. package/src/commands/ir.ts +23 -0
  101. package/src/commands/lex.ts +17 -0
  102. package/src/commands/parse.ts +24 -0
  103. package/src/commands/test.ts +36 -0
  104. package/src/commands/verify_determinism.ts +66 -0
  105. package/src/commands/watch.ts +25 -0
  106. package/src/emit_auth.ts +67 -0
  107. package/src/emit_batch.ts +140 -140
  108. package/src/emit_capability.ts +562 -436
  109. package/src/emit_composition.ts +196 -196
  110. package/src/emit_database.ts +75 -0
  111. package/src/emit_deploy.ts +190 -190
  112. package/src/emit_events.ts +307 -307
  113. package/src/emit_extras.ts +240 -240
  114. package/src/emit_full.ts +316 -309
  115. package/src/emit_index.ts +161 -0
  116. package/src/emit_maintenance.ts +459 -459
  117. package/src/emit_package.ts +69 -0
  118. package/src/emit_router.ts +395 -0
  119. package/src/emit_runtime.ts +17 -728
  120. package/src/emit_sourcemap.ts +140 -140
  121. package/src/emit_tests.ts +205 -205
  122. package/src/emit_websocket.ts +229 -229
  123. package/src/emitter.ts +566 -566
  124. package/src/extension_manager.ts +189 -187
  125. package/src/formatter.ts +297 -297
  126. package/src/index.ts +88 -88
  127. package/src/ir.ts +215 -215
  128. package/src/lexer.ts +630 -630
  129. package/src/lowering.ts +124 -556
  130. package/src/lowering_channels.ts +107 -0
  131. package/src/lowering_entities.ts +248 -0
  132. package/src/lowering_helpers.ts +75 -0
  133. package/src/module_loader.ts +112 -114
  134. package/src/optimizer.ts +196 -196
  135. package/src/parse_decls.ts +409 -409
  136. package/src/parse_decls2.ts +244 -244
  137. package/src/parse_expr.ts +197 -197
  138. package/src/parse_types.ts +54 -54
  139. package/src/parser.ts +1 -1
  140. package/src/parser_base.ts +57 -57
  141. package/src/parser_recovery.ts +153 -153
  142. package/src/scaffold.ts +372 -375
  143. package/src/solver.ts +330 -330
  144. package/src/typechecker.ts +591 -591
  145. package/src/types.ts +122 -122
  146. package/src/verifier.ts +348 -348
package/src/lowering.ts CHANGED
@@ -1,556 +1,124 @@
1
- /**
2
- * bone ir Lowering — Stage 4 of the compilation pipeline.
3
- * Converts typed AST into the Architecture IR (spec/07_IR_SPEC.md).
4
- *
5
- * Rules:
6
- * - One module per semantic component
7
- * - All IDs are deterministic (derived from system name + component name)
8
- * - All ontology-entailed fields are inserted
9
- * - Effects are serialized in declaration order
10
- */
11
-
12
- import { createHash } from "crypto";
13
- import * as AST from "./ast";
14
- import * as IR from "./ir";
15
-
16
- function toSnakeCase(s: string): string {
17
- return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
18
- }
19
-
20
- // ─── Deterministic ID Generation ─────────────────────────────────────────────
21
-
22
- function makeId(systemName: string, kind: string, name: string): string {
23
- const input = `${systemName}.${kind}.${name}`;
24
- return createHash("sha256").update(input).digest("hex").slice(0, 16);
25
- }
26
-
27
- // ─── Duration Parsing ────────────────────────────────────────────────────────
28
-
29
- function parseDurationMs(dur: string | null): number | null {
30
- if (!dur) return null;
31
- const match = dur.match(/^(\d+)(ms|s|m|h|d)$/);
32
- if (!match) return null;
33
- const value = parseInt(match[1], 10);
34
- switch (match[2]) {
35
- case "ms": return value;
36
- case "s": return value * 1000;
37
- case "m": return value * 60_000;
38
- case "h": return value * 3_600_000;
39
- case "d": return value * 86_400_000;
40
- default: return null;
41
- }
42
- }
43
-
44
- // ─── Type Expression Serialization ───────────────────────────────────────────
45
-
46
- function serializeType(t: AST.TypeExprNode): string {
47
- switch (t.kind) {
48
- case "PrimitiveType": return t.name;
49
- case "GenericType": return `${t.name}<${t.typeArgs.map(serializeType).join(", ")}>`;
50
- case "EntityRefType": return t.name;
51
- case "TupleType": return `(${t.elements.map(serializeType).join(", ")})`;
52
- case "UnionType": return t.members.map(serializeType).join(" | ");
53
- }
54
- }
55
-
56
- // ─── Expression Serialization ────────────────────────────────────────────────
57
-
58
- function serializeExpr(e: AST.ExprNode): string {
59
- switch (e.kind) {
60
- case "Literal":
61
- if (e.type === "string") return `"${e.value}"`;
62
- if (e.type === "list") return `[${(e.value as AST.ExprNode[]).map(serializeExpr).join(", ")}]`;
63
- return String(e.value);
64
- case "FieldRef":
65
- return e.path.join(".");
66
- case "BinaryExpr":
67
- return `(${serializeExpr(e.left)} ${e.op} ${serializeExpr(e.right)})`;
68
- case "UnaryExpr":
69
- return `(${e.op} ${serializeExpr(e.operand)})`;
70
- case "CallExpr":
71
- return `${e.name}(${e.args.map(serializeExpr).join(", ")})`;
72
- case "TernaryExpr":
73
- return `(${serializeExpr(e.condition)} ? ${serializeExpr(e.consequent)} : ${serializeExpr(e.alternate)})`;
74
- }
75
- }
76
-
77
- // ─── Lowering Engine ─────────────────────────────────────────────────────────
78
-
79
- export class Lowering {
80
- private systemName: string = "";
81
-
82
- lower(program: AST.ProgramNode, sourceHash: string): IR.IRSystem[] {
83
- const systems: IR.IRSystem[] = [];
84
-
85
- for (const sys of program.systems) {
86
- systems.push(this.lowerSystem(sys, sourceHash));
87
- }
88
-
89
- return systems;
90
- }
91
-
92
- private lowerSystem(sys: AST.SystemDeclNode, sourceHash: string): IR.IRSystem {
93
- this.systemName = sys.name;
94
-
95
- const modules: IR.IRModule[] = [];
96
- const events: IR.IREvent[] = [];
97
- const flows: IR.IRFlow[] = [];
98
- const invariants: IR.IRInvariant[] = [];
99
-
100
- // Collect declarations by type
101
- const entities = sys.declarations.filter((d): d is AST.EntityDeclNode => d.kind === "EntityDecl");
102
- const capabilities = sys.declarations.filter((d): d is AST.CapabilityDeclNode => d.kind === "CapabilityDecl");
103
- const channels = sys.declarations.filter((d): d is AST.ChannelDeclNode => d.kind === "ChannelDecl");
104
- const stores = sys.declarations.filter((d): d is AST.StoreDeclNode => d.kind === "StoreDecl");
105
- const eventDecls = sys.declarations.filter((d): d is AST.EventDeclNode => d.kind === "EventDecl");
106
- const constraints = sys.declarations.filter((d): d is AST.ConstraintDeclNode => d.kind === "ConstraintDecl");
107
- const policies = sys.declarations.filter((d): d is AST.PolicyDeclNode => d.kind === "PolicyDecl");
108
- const flowDecls = sys.declarations.filter((d): d is AST.FlowDeclNode => d.kind === "FlowDecl");
109
- const extensionPoints = sys.declarations.filter((d): d is AST.ExtensionPointDeclNode => d.kind === "ExtensionPointDecl");
110
-
111
- // Lower stores → data_store modules
112
- for (const store of stores) {
113
- modules.push(this.lowerStore(store));
114
- }
115
-
116
- // Lower entities → api_service modules (with CRUD + capabilities)
117
- for (const entity of entities) {
118
- const relatedCaps = capabilities.filter(c =>
119
- c.params.some(p => p.type.kind === "EntityRefType" && p.type.name === entity.name)
120
- );
121
- modules.push(this.lowerEntity(entity, relatedCaps, stores));
122
- }
123
-
124
- // Lower channels → realtime_service modules
125
- for (const channel of channels) {
126
- modules.push(this.lowerChannel(channel));
127
- }
128
-
129
- // Lower events
130
- for (const ev of eventDecls) {
131
- events.push(this.lowerEvent(ev));
132
- }
133
-
134
- // Lower flows
135
- for (const flow of flowDecls) {
136
- flows.push(this.lowerFlow(flow));
137
- }
138
-
139
- // Lower constraints → invariants
140
- for (const c of constraints) {
141
- invariants.push({
142
- id: makeId(this.systemName, "invariant", c.name),
143
- expression: serializeExpr(c.expr),
144
- scope: "global",
145
- });
146
- }
147
-
148
- // Add gateway module (ontology: always present)
149
- const gatewayConfig: Record<string, string | number | boolean> = {
150
- rate_limit: 1000,
151
- cors: true,
152
- tls: true,
153
- };
154
- if (policies.length > 0) {
155
- const mainPolicy = policies[0];
156
- if (mainPolicy.rateLimit) {
157
- gatewayConfig["rate_limit"] = mainPolicy.rateLimit.count;
158
- }
159
- if (mainPolicy.encryption) {
160
- gatewayConfig["encryption"] = mainPolicy.encryption;
161
- }
162
- }
163
- modules.push({
164
- id: makeId(this.systemName, "gateway", "APIGateway"),
165
- kind: "gateway",
166
- name: "APIGateway",
167
- interfaces: [],
168
- models: [],
169
- events: [],
170
- state_machines: [],
171
- relations: [],
172
- dependencies: modules.filter(m => m.kind === "api_service" || m.kind === "realtime_service").map(m => m.id),
173
- config: gatewayConfig,
174
- });
175
-
176
- return {
177
- name: sys.name,
178
- version: "1.0.0",
179
- source_hash: sourceHash,
180
- domain: sys.domain,
181
- modules,
182
- events,
183
- flows,
184
- invariants,
185
- resolution: {},
186
- extension_points: extensionPoints.map(ep => ({
187
- name: ep.name,
188
- params: ep.params.map(p => ({ name: p.name, type: serializeType(p.type) })),
189
- returns: ep.returns ? serializeType(ep.returns) : null,
190
- stable: ep.stable,
191
- })),
192
- };
193
- }
194
-
195
- // ─── Store Lowering ────────────────────────────────────────────────────────
196
-
197
- private lowerStore(store: AST.StoreDeclNode): IR.IRModule {
198
- // Strip "Store" suffix from model name so SellerStore → Seller → table "sellers"
199
- const entityName = store.name.replace(/Store$/, "") || store.name;
200
- const model: IR.IRModel = {
201
- name: entityName,
202
- fields: store.schema.map(f => this.lowerField(f)),
203
- primary_key: "id",
204
- indexes: [],
205
- constraints: [],
206
- };
207
-
208
- // Add id field if not present
209
- if (!model.fields.find(f => f.name === "id")) {
210
- model.fields.unshift({
211
- name: "id", type: "uuid", nullable: false, unique: true, indexed: true, default_value: "gen_random_uuid()",
212
- });
213
- }
214
-
215
- return {
216
- id: makeId(this.systemName, "data_store", store.name),
217
- kind: "data_store",
218
- name: store.name,
219
- interfaces: [],
220
- models: [model],
221
- events: [],
222
- state_machines: [],
223
- relations: [],
224
- dependencies: [],
225
- config: {
226
- engine: store.engine || "postgresql",
227
- replicas: store.replicas || 1,
228
- ...(store.retention ? { retention_ms: parseDurationMs(store.retention) || 0 } : {}),
229
- ...(store.partition ? { partition_key: store.partition } : {}),
230
- },
231
- };
232
- }
233
-
234
- // ─── Entity Lowering ───────────────────────────────────────────────────────
235
-
236
- private lowerEntity(entity: AST.EntityDeclNode, capabilities: AST.CapabilityDeclNode[], stores: AST.StoreDeclNode[]): IR.IRModule {
237
- const moduleId = makeId(this.systemName, "api_service", `${entity.name}Service`);
238
-
239
- // Build model from entity fields + ontology entailments
240
- const fields: IR.IRField[] = [
241
- { name: "id", type: "uuid", nullable: false, unique: true, indexed: true, default_value: "gen_random_uuid()" },
242
- { name: "created_at", type: "timestamp", nullable: false, unique: false, indexed: true, default_value: "now()" },
243
- { name: "updated_at", type: "timestamp", nullable: false, unique: false, indexed: false, default_value: "now()" },
244
- ];
245
- for (const f of entity.owns) {
246
- fields.push(this.lowerField(f));
247
- }
248
-
249
- // Add derived fields as generated columns (stored: false = virtual)
250
- const derivedFields: IR.IRField[] = entity.derived.map(d => ({
251
- name: d.name,
252
- type: "json", // type inferred at runtime
253
- nullable: true,
254
- unique: false,
255
- indexed: false,
256
- default_value: `GENERATED ALWAYS AS (${serializeExpr(d.expr)}) STORED`,
257
- }));
258
-
259
- // Build indexes from entity index declarations
260
- const indexes: IR.IRIndex[] = [];
261
- for (const idx of entity.indexes) {
262
- indexes.push({ fields: idx, unique: false });
263
- }
264
-
265
- // Build constraints from entity constraints
266
- const modelConstraints: IR.IRModelConstraint[] = [];
267
- for (const c of entity.constraints) {
268
- const serialized = serializeExpr(c);
269
- // Detect unique constraints
270
- if (c.kind === "FieldRef" && c.path[c.path.length - 1] === "unique") {
271
- const field = c.path.slice(0, -1).join(".");
272
- modelConstraints.push({ kind: "unique", target: field, params: {} });
273
- indexes.push({ fields: [field], unique: true });
274
- } else {
275
- modelConstraints.push({ kind: "check", target: entity.name, params: { expression: serialized } });
276
- }
277
- }
278
-
279
- const model: IR.IRModel = {
280
- name: entity.name,
281
- fields: [...fields, ...derivedFields],
282
- primary_key: "id",
283
- indexes,
284
- constraints: modelConstraints,
285
- };
286
-
287
- // Build state machine if entity has states
288
- const stateMachines: IR.IRStateMachine[] = [];
289
- if (entity.states) {
290
- const states = entity.states.nodes.map(n => n.name);
291
- const transitions: IR.IRTransition[] = [];
292
- for (const node of entity.states.nodes) {
293
- for (const target of node.transitions) {
294
- transitions.push({ from: node.name, to: target, trigger: `${node.name}_to_${target}`, guard: null });
295
- }
296
- for (const target of node.branches) {
297
- transitions.push({ from: node.name, to: target, trigger: `${node.name}_to_${target}`, guard: null });
298
- }
299
- }
300
- stateMachines.push({
301
- entity: entity.name,
302
- states,
303
- initial: states[0],
304
- transitions,
305
- });
306
- }
307
-
308
- // Build interface from capabilities
309
- const methods: IR.IRMethod[] = [];
310
-
311
- // CRUD methods (always generated for entities)
312
- methods.push(this.makeCrudMethod("create", entity.name, fields));
313
- methods.push(this.makeCrudMethod("read", entity.name, fields));
314
- methods.push(this.makeCrudMethod("update", entity.name, fields));
315
- methods.push(this.makeCrudMethod("delete", entity.name, fields));
316
- methods.push(this.makeCrudMethod("list", entity.name, fields));
317
-
318
- // Capability-derived methods
319
- for (const cap of capabilities) {
320
- methods.push(this.lowerCapability(cap));
321
- }
322
-
323
- const iface: IR.IRInterface = {
324
- name: `I${entity.name}Service`,
325
- methods,
326
- };
327
-
328
- // Find related store
329
- const relatedStore = stores.find(s => s.name.toLowerCase().includes(entity.name.toLowerCase()));
330
- const deps: string[] = [];
331
- if (relatedStore) {
332
- deps.push(makeId(this.systemName, "data_store", relatedStore.name));
333
- }
334
-
335
- // Lower relations
336
- const relations: IR.IRRelation[] = entity.relations.map(rel => {
337
- const fromTable = toSnakeCase(entity.name) + "s";
338
- const toTable = toSnakeCase(rel.target) + "s";
339
- let foreignKey: string;
340
- let junctionTable: string | undefined;
341
-
342
- switch (rel.relationType) {
343
- case "belongs_to":
344
- foreignKey = toSnakeCase(rel.target) + "_id";
345
- break;
346
- case "has_one":
347
- case "has_many":
348
- foreignKey = toSnakeCase(entity.name) + "_id";
349
- break;
350
- case "many_to_many":
351
- foreignKey = toSnakeCase(entity.name) + "_id";
352
- junctionTable = [fromTable, toTable].sort().join("_");
353
- break;
354
- default:
355
- foreignKey = toSnakeCase(rel.target) + "_id";
356
- }
357
-
358
- return {
359
- name: rel.name,
360
- kind: rel.relationType,
361
- from_entity: entity.name,
362
- to_entity: rel.target,
363
- from_table: fromTable,
364
- to_table: toTable,
365
- foreign_key: foreignKey,
366
- junction_table: junctionTable,
367
- };
368
- });
369
-
370
- return {
371
- id: moduleId,
372
- kind: "api_service",
373
- name: `${entity.name}Service`,
374
- interfaces: [iface],
375
- models: [model],
376
- events: [],
377
- state_machines: stateMachines,
378
- relations,
379
- dependencies: deps,
380
- config: {
381
- authenticated: entity.auth !== null && entity.auth !== "none",
382
- auth_method: entity.auth || "none",
383
- },
384
- };
385
- }
386
-
387
- private makeCrudMethod(op: string, entityName: string, fields: IR.IRField[]): IR.IRMethod {
388
- const input: IR.IRField[] = op === "create" || op === "update"
389
- ? fields.filter(f => f.name !== "id" && f.name !== "created_at" && f.name !== "updated_at")
390
- : op === "list"
391
- ? [
392
- { name: "page", type: "uint", nullable: true, unique: false, indexed: false, default_value: "1" },
393
- { name: "page_size", type: "uint", nullable: true, unique: false, indexed: false, default_value: "50" },
394
- ]
395
- : [{ name: "id", type: "uuid", nullable: false, unique: true, indexed: true, default_value: null }];
396
-
397
- return {
398
- name: op,
399
- input,
400
- output: op === "list" ? `list<${entityName}>` : op === "delete" ? "bool" : entityName,
401
- preconditions: [],
402
- effects: [],
403
- emissions: [],
404
- idempotent: op === "read" || op === "list",
405
- authenticated: true,
406
- timeout_ms: 30000,
407
- retry: null,
408
- pipeline: null,
409
- algorithm: null,
410
- sync: null,
411
- };
412
- }
413
-
414
- private lowerCapability(cap: AST.CapabilityDeclNode): IR.IRMethod {
415
- const input: IR.IRField[] = cap.params.map(p => ({
416
- name: p.name,
417
- type: serializeType(p.type),
418
- nullable: false,
419
- unique: false,
420
- indexed: false,
421
- default_value: null,
422
- }));
423
-
424
- const preconditions: IR.IRPrecondition[] = cap.requires.map(r => ({
425
- expression: serializeExpr(r),
426
- description: serializeExpr(r),
427
- }));
428
-
429
- const effects: IR.IREffect[] = cap.effects.map(e => ({
430
- target: e.target.path.join("."),
431
- op: e.op === "=" ? "assign" as const : e.op === "+=" ? "add" as const : "remove" as const,
432
- value: serializeExpr(e.value),
433
- }));
434
-
435
- const emissions = cap.emits.map(e => e.eventName);
436
-
437
- // Lower pipeline if present
438
- let pipeline: IR.IRPipeline | null = null;
439
- if (cap.pipeline) {
440
- pipeline = {
441
- parallel: cap.pipeline.parallel,
442
- steps: cap.pipeline.steps.map(step => ({
443
- call_name: step.call.name,
444
- call_args: step.call.args.map(a => serializeExpr(a)),
445
- bind_as: step.bindAs,
446
- })),
447
- on_error: cap.pipeline.onError ? {
448
- action: cap.pipeline.onError.action,
449
- call_name: cap.pipeline.onError.call?.name || null,
450
- call_args: cap.pipeline.onError.call?.args.map(a => serializeExpr(a)) || [],
451
- } : null,
452
- };
453
- }
454
-
455
- // Lower algorithm if present
456
- let algorithm: IR.IRAlgorithm | null = null;
457
- if (cap.algorithm) {
458
- algorithm = {
459
- catalog_name: cap.algorithm.name,
460
- bindings: cap.algorithm.using.map(b => ({
461
- param: b.param,
462
- value: serializeExpr(b.value),
463
- })),
464
- };
465
- }
466
-
467
- return {
468
- name: cap.name,
469
- input,
470
- output: cap.returns ? serializeType(cap.returns) : "result<void, error>",
471
- preconditions,
472
- effects,
473
- emissions,
474
- idempotent: cap.idempotent || false,
475
- authenticated: true,
476
- timeout_ms: parseDurationMs(cap.timeout) || 30000,
477
- retry: cap.retry ? {
478
- max_attempts: cap.retry.maxAttempts || 3,
479
- backoff: (cap.retry.backoff as IR.IRRetryPolicy["backoff"]) || "exponential",
480
- interval_ms: parseDurationMs(cap.retry.interval) || 1000,
481
- } : null,
482
- pipeline,
483
- algorithm,
484
- sync: cap.sync,
485
- };
486
- }
487
-
488
- // ─── Channel Lowering ──────────────────────────────────────────────────────
489
-
490
- private lowerChannel(channel: AST.ChannelDeclNode): IR.IRModule {
491
- return {
492
- id: makeId(this.systemName, "realtime_service", channel.name),
493
- kind: "realtime_service",
494
- name: channel.name,
495
- interfaces: [{
496
- name: `I${channel.name}Channel`,
497
- methods: [
498
- { name: "connect", input: [], output: "connection", preconditions: [], effects: [], emissions: [], idempotent: false, authenticated: true, timeout_ms: 5000, retry: null, pipeline: null, algorithm: null, sync: null },
499
- { name: "subscribe", input: [{ name: "topic", type: "string", nullable: false, unique: false, indexed: false, default_value: null }], output: "subscription", preconditions: [], effects: [], emissions: [], idempotent: true, authenticated: true, timeout_ms: 5000, retry: null, pipeline: null, algorithm: null, sync: null },
500
- { name: "publish", input: [{ name: "message", type: "json", nullable: false, unique: false, indexed: false, default_value: null }], output: "void", preconditions: [], effects: [], emissions: [], idempotent: false, authenticated: true, timeout_ms: 5000, retry: null, pipeline: null, algorithm: null, sync: null },
501
- ],
502
- }],
503
- models: [],
504
- events: [],
505
- state_machines: [],
506
- relations: [],
507
- dependencies: [],
508
- config: {
509
- transport: channel.transport || "websocket",
510
- ordering: channel.ordering || "fifo",
511
- persistence: channel.persistence || "none",
512
- max_size: channel.maxSize || 10000,
513
- },
514
- };
515
- }
516
-
517
- // ─── Event Lowering ────────────────────────────────────────────────────────
518
-
519
- private lowerEvent(ev: AST.EventDeclNode): IR.IREvent {
520
- return {
521
- id: makeId(this.systemName, "event", ev.name),
522
- name: ev.name,
523
- payload: ev.payload.map(f => this.lowerField(f)),
524
- source: "unknown", // resolved during dependency resolution
525
- delivery: (ev.delivery as IR.IRDeliveryMode) || "at_least_once",
526
- ordering: "fifo",
527
- ttl_ms: parseDurationMs(ev.ttl),
528
- };
529
- }
530
-
531
- // ─── Flow Lowering ─────────────────────────────────────────────────────────
532
-
533
- private lowerFlow(flow: AST.FlowDeclNode): IR.IRFlow {
534
- return {
535
- name: flow.name,
536
- steps: flow.steps.map(s => ({
537
- name: s.name,
538
- action: `${s.action.name}(${s.action.args.map(serializeExpr).join(", ")})`,
539
- compensation: s.compensate ? `${s.compensate.name}(${s.compensate.args.map(serializeExpr).join(", ")})` : null,
540
- })),
541
- };
542
- }
543
-
544
- // ─── Field Lowering ────────────────────────────────────────────────────────
545
-
546
- private lowerField(f: AST.FieldNode): IR.IRField {
547
- return {
548
- name: f.name,
549
- type: serializeType(f.type),
550
- nullable: f.type.kind === "GenericType" && f.type.name === "optional",
551
- unique: false,
552
- indexed: false,
553
- default_value: f.defaultValue ? serializeExpr(f.defaultValue) : null,
554
- };
555
- }
556
- }
1
+ /**
2
+ * BoneScript Lowering Stage 4 of the compilation pipeline.
3
+ * Converts typed AST into the Architecture IR (spec/07_IR_SPEC.md).
4
+ *
5
+ * This file is the orchestrator. The actual lowering logic lives in:
6
+ * lowering_helpers.ts — makeId, parseDurationMs, serializeExpr/Type
7
+ * lowering_entities.ts — lowerEntity, lowerCapability, lowerField, makeCrudMethod
8
+ * lowering_channels.ts — lowerStore, lowerChannel, lowerEvent, lowerFlow
9
+ */
10
+
11
+ import * as AST from "./ast";
12
+ import * as IR from "./ir";
13
+ import { makeId, serializeExpr, serializeType } from "./lowering_helpers";
14
+ import { lowerEntity } from "./lowering_entities";
15
+ import { lowerStore, lowerChannel, lowerEvent, lowerFlow } from "./lowering_channels";
16
+
17
+ export class Lowering {
18
+ private systemName: string = "";
19
+
20
+ lower(program: AST.ProgramNode, sourceHash: string): IR.IRSystem[] {
21
+ return program.systems.map(sys => this.lowerSystem(sys, sourceHash));
22
+ }
23
+
24
+ private lowerSystem(sys: AST.SystemDeclNode, sourceHash: string): IR.IRSystem {
25
+ this.systemName = sys.name;
26
+
27
+ const modules: IR.IRModule[] = [];
28
+ const events: IR.IREvent[] = [];
29
+ const flows: IR.IRFlow[] = [];
30
+ const invariants: IR.IRInvariant[] = [];
31
+
32
+ // Partition declarations by kind
33
+ const entities = sys.declarations.filter((d): d is AST.EntityDeclNode => d.kind === "EntityDecl");
34
+ const capabilities = sys.declarations.filter((d): d is AST.CapabilityDeclNode => d.kind === "CapabilityDecl");
35
+ const channels = sys.declarations.filter((d): d is AST.ChannelDeclNode => d.kind === "ChannelDecl");
36
+ const stores = sys.declarations.filter((d): d is AST.StoreDeclNode => d.kind === "StoreDecl");
37
+ const eventDecls = sys.declarations.filter((d): d is AST.EventDeclNode => d.kind === "EventDecl");
38
+ const constraints = sys.declarations.filter((d): d is AST.ConstraintDeclNode => d.kind === "ConstraintDecl");
39
+ const policies = sys.declarations.filter((d): d is AST.PolicyDeclNode => d.kind === "PolicyDecl");
40
+ const flowDecls = sys.declarations.filter((d): d is AST.FlowDeclNode => d.kind === "FlowDecl");
41
+ const extensionPoints = sys.declarations.filter((d): d is AST.ExtensionPointDeclNode => d.kind === "ExtensionPointDecl");
42
+
43
+ // Stores → data_store modules
44
+ for (const store of stores) {
45
+ modules.push(lowerStore(this.systemName, store));
46
+ }
47
+
48
+ // Entities api_service modules (with CRUD + related capabilities)
49
+ for (const entity of entities) {
50
+ const relatedCaps = capabilities.filter(c =>
51
+ c.params.some(p => p.type.kind === "EntityRefType" && p.type.name === entity.name)
52
+ );
53
+ modules.push(lowerEntity(this.systemName, entity, relatedCaps, stores));
54
+ }
55
+
56
+ // Channels realtime_service modules
57
+ for (const channel of channels) {
58
+ modules.push(lowerChannel(this.systemName, channel));
59
+ }
60
+
61
+ // Events
62
+ for (const ev of eventDecls) {
63
+ events.push(lowerEvent(this.systemName, ev));
64
+ }
65
+
66
+ // Flows
67
+ for (const flow of flowDecls) {
68
+ flows.push(lowerFlow(this.systemName, flow));
69
+ }
70
+
71
+ // Constraints → invariants
72
+ for (const c of constraints) {
73
+ invariants.push({
74
+ id: makeId(this.systemName, "invariant", c.name),
75
+ expression: serializeExpr(c.expr),
76
+ scope: "global",
77
+ });
78
+ }
79
+
80
+ // Gateway module (always present per ontology)
81
+ const gatewayConfig: Record<string, string | number | boolean> = {
82
+ rate_limit: 1000,
83
+ cors: true,
84
+ tls: true,
85
+ };
86
+ if (policies.length > 0) {
87
+ const mainPolicy = policies[0];
88
+ if (mainPolicy.rateLimit) gatewayConfig["rate_limit"] = mainPolicy.rateLimit.count;
89
+ if (mainPolicy.encryption) gatewayConfig["encryption"] = mainPolicy.encryption;
90
+ }
91
+ modules.push({
92
+ id: makeId(this.systemName, "gateway", "APIGateway"),
93
+ kind: "gateway",
94
+ name: "APIGateway",
95
+ interfaces: [],
96
+ models: [],
97
+ events: [],
98
+ state_machines: [],
99
+ relations: [],
100
+ dependencies: modules
101
+ .filter(m => m.kind === "api_service" || m.kind === "realtime_service")
102
+ .map(m => m.id),
103
+ config: gatewayConfig,
104
+ });
105
+
106
+ return {
107
+ name: sys.name,
108
+ version: "1.0.0",
109
+ source_hash: sourceHash,
110
+ domain: sys.domain,
111
+ modules,
112
+ events,
113
+ flows,
114
+ invariants,
115
+ resolution: {},
116
+ extension_points: extensionPoints.map(ep => ({
117
+ name: ep.name,
118
+ params: ep.params.map(p => ({ name: p.name, type: serializeType(p.type) })),
119
+ returns: ep.returns ? serializeType(ep.returns) : null,
120
+ stable: ep.stable,
121
+ })),
122
+ };
123
+ }
124
+ }