@openora/core 0.4.1-canary.13 → 0.4.1-canary.130

package/README.md

@@ -21,16 +21,16 @@ The rolling `canary` dev channel (`@openora/core@canary`) publishes on every `de
 
 ## What's inside (subpath exports)
 
-| Subpath                          | Surface                                                                                        |
-| -------------------------------- | ---------------------------------------------------------------------------------------------- |
-| `@openora/core/contracts`        | Isomorphic Zod schemas, contract composition, adapter ports + DI tokens                        |
-| `@openora/core/server`           | The engine: `createApp`, plugin host (`definePlugin`), DI container, EventBus, Drizzle service |
-| `@openora/core/react`            | Typed client, auth, realtime hooks for your frontend (no UI components)                        |
-| `@openora/core/<domain>`         | A domain's public contract surface, eg `wallet`, `compliance`, `engagement`                    |
-| `@openora/core/<domain>/schema`  | Read-only Drizzle tables for cross-module reads                                                |
-| `@openora/core/<domain>/plugins` | The domain's plugin entry for your composition root                                            |
+| Subpath                          | Surface                                                                                  |
+| -------------------------------- | ---------------------------------------------------------------------------------------- |
+| `@openora/core/contracts`        | Isomorphic Zod schemas, contract composition, adapter ports + DI tokens                  |
+| `@openora/core/server`           | The engine: `createApp`, plugin host (`Plugin`), DI container, EventBus, Drizzle service |
+| `@openora/core/react`            | Typed client, auth, realtime hooks for your frontend (no UI components)                  |
+| `@openora/core/<domain>`         | A domain's public contract surface, eg `wallet`, `compliance`, `engagement`              |
+| `@openora/core/<domain>/schema`  | Read-only Drizzle tables for cross-module reads                                          |
+| `@openora/core/<domain>/plugins` | The domain's plugin entry for your composition root                                      |
 
-Everything enters through plugins - `definePlugin({ id, dependsOn, register })` - wired explicitly in your app's `extensions.config.ts`. No decorators, no auto-discovery.
+Everything enters through typed plugin objects - `{ id, dependsOn, register } satisfies Plugin<CoreTokenCatalog>` - wired explicitly in your app's `extensions.config.ts`. No decorators, no auto-discovery.
 
 ## Principles
 
@@ -38,7 +38,7 @@ Everything enters through plugins - `definePlugin({ id, dependsOn, register })`
 - **Zod-first** - every wire shape is a schema; types are inferred, never hand-written.
 - **Swappable vendor seams** - PSP, KYC, game aggregator, realtime, job queue, and message broker are ports with in-process defaults and adapter overrides.
 - **Regulatory-grade audit** - append-only, sha256 hash-chained log; every state-changing action leaves a trail.
-- **AI-native** - machine-readable catalog, per-module agent docs, and a queryable MCP server ([`@openora/mcp`](https://www.npmjs.com/package/@openora/mcp)).
+- **AI-native** - machine-readable catalog and a queryable MCP server ([`@openora/mcp`](https://www.npmjs.com/package/@openora/mcp)).
 
 ## Getting started
 

package/bin/migrate.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { dirname, join, parse } from 'node:path';
+import { config } from 'dotenv';
+
+const findEnvFile = (from) => {
+  const { root } = parse(from);
+  for (let dir = from; ; dir = dirname(dir)) {
+    const candidate = join(dir, '.env');
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+    if (dir === root) {
+      return undefined;
+    }
+  }
+};
+
+config({ path: findEnvFile(process.cwd()), quiet: true });
+
+const packageRoot = new URL('../', import.meta.url);
+const manifest = JSON.parse(await readFile(new URL('package.json', packageRoot), 'utf8'));
+
+const toLabel = (key) =>
+  key
+    .replace(/^\.\//, '')
+    .split('/')
+    .filter((segment) => segment !== 'migrate')
+    .join('/');
+
+const toEntry = ([key, value]) => ({
+  label: toLabel(key),
+  url: new URL(
+    (typeof value === 'string' ? value : (value.import ?? value.default)).replace(/^\.\//, ''),
+    packageRoot,
+  ).href,
+});
+
+const isMigrateKey = (key) => key.split('/').includes('migrate');
+const engineFirst = (a, b) =>
+  Number(b.label === 'server') - Number(a.label === 'server') || a.label.localeCompare(b.label);
+
+const sets = Object.entries(manifest.exports)
+  .filter(([key]) => isMigrateKey(key))
+  .map(toEntry)
+  .sort(engineFirst);
+
+for (const { label, url } of sets) {
+  process.stdout.write(`\n> migrate ${label}\n`);
+  const { migrate } = await import(url);
+  await migrate();
+}
+
+process.stdout.write(`\nDone: ${sets.length} migration set(s) applied.\n`);