From 849018b7cfa19e6a173b59bdb5f09cc08a0e7697 Mon Sep 17 00:00:00 2001 From: Doug Mealing Date: Mon, 26 Oct 2026 03:45:23 -0400 Subject: [PATCH] docs: restamp first-touch versions to 1.1.3 / 8.1.3; test: give server-backed D1/SQLite report tests load headroom --- AGENTS.md | 8 ++++---- README.md | 10 +++++----- docs/ports/csharp.md | 4 ++-- docs/ports/java.md | 4 ++-- docs/ports/kotlin.md | 2 +- docs/ports/typescript.md | 2 +- .../test/api-contract-report-sqlite.test.ts | 17 +++++++++++------ .../test/view-recreate-drift-sqlite.test.ts | 10 +++++++--- 8 files changed, 33 insertions(+), 24 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 27ac3574f..82ba30a61 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -39,9 +39,9 @@ because a conformance corpus gates the ports against each other and never agains in ADR-0035 **Amendment 3**. Do not reintroduce a waiting gate in any form. -**Where the versions are.** `latest` is **`1.1.2`** on npm, **`8.1.2`** on Maven Central, -**`1.1.2`** on PyPI and **`1.1.2`** on NuGet (the Maven major is always **npm major + 7**, so -1.1.2 is 8.1.2). **1.1.0, 1.1.1 and 1.1.2 are released.** 1.0.13 is the last 1.0.x release; the four registries moved together on 1.0.13, 1.0.12, 1.0.11, 1.0.10 and 1.0.9 (Maven skipped 8.0.8), and earlier Maven alone took 1.0.6 (8.0.6) while the other three skipped that +**Where the versions are.** `latest` is **`1.1.3`** on npm, **`8.1.3`** on Maven Central, +**`1.1.3`** on PyPI and **`1.1.3`** on NuGet (the Maven major is always **npm major + 7**, so +1.1.3 is 8.1.3). **1.1.0, 1.1.1, 1.1.2 and 1.1.3 are released.** 1.0.13 is the last 1.0.x release; the four registries moved together on 1.0.13, 1.0.12, 1.0.11, 1.0.10 and 1.0.9 (Maven skipped 8.0.8), and earlier Maven alone took 1.0.6 (8.0.6) while the other three skipped that number. Both patterns are the convergent-publishing rule working as intended. **1.0 is CUT** and **1.1 is released**: the 1.0.0-rc candidates through 1.0.13 are superseded, and npm's `next` tag is REPOINTED onto each release — not deleted, because `dist-tag rm` 403s for every token we hold (`docs/RELEASING.md` §4). `metamodelVersion` read **`1.0`** through 1.0.13 — C4 landed and G4 shipped it, and no 1.0.x patch @@ -80,7 +80,7 @@ PyPI has had no product change since `0.25.0` — nothing is broken. **Key cross-language features shipped:** FR5 family (a/b/c/d/e + WARN envelope-shape — actionable loader errors per ADR-0009); FR-003 (Java RDB runtime persistence + projections; schema migrations are TS-only — the Java migration engine was removed); FR-006 (template.output parser-on-receipt codegen per ADR-0010 in all 5 ports); FR-008 + FR-009 (cross-port REST API contract + the nine filter operators); FR-018 (M:N relationship codegen in all 5 ports — entity navigation + idiomatic ORM wiring [Drizzle m2m / EF Core `UsingEntity` / Spring repo+JPA / Exposed / Pydantic+route as the SQLAlchemy-secondary equivalent] + REST traversal `GET //{id}/` + Tier-2 docs, gated by the shared api-contract m2m corpus in both lanes + persistence-conformance; the TanStack M:N client hook is a deferred client-ergonomics follow-up); SP-H (field-subtype end-to-end hardening: every concrete `field.*` subtype write+read round-trips cross-port via the persistence `op: roundtrip` gate; cut `field.byte`/`field.short`/`field.class` non-functional stubs; cross-port filter-op reconciliation for uuid/currency); source v2 paradigm (ADR-0007); metadata-ktx Kotlin facade; per-target output directories (TS codegen); FR-044 (the reporting vocabulary — `dimension.attribute`/`dimension.time`, `measure.aggregate`/`measure.ratio`, `segment.filter`, `object.report`, `@spine` on a report to take rows from a to-one dimension entity, `@default` on a measure for empty aggregates, plus the relative-date filter value — registered and loader-validated in all five ports; a report that declares a read-only `source.rdb @kind: view` is lowered to a SQL view by `meta migrate` and read by every port, and served by a generated read-only list route in every port, gated by the api-contract `report/` sub-corpus; the TypeScript `cube-model` reference generator writes the vocabulary as Cube data-model files, gated by the `fixtures/cube-model/` corpus and a `cube` lane that loads the output into a real Cube; a served report gets the generated TanStack list hook (`useList`) but no grid or form, see [docs/features/reporting.md](docs/features/reporting.md) and [docs/features/cube-export.md](docs/features/cube-export.md)). -**Release 1.1.0** (released; npm `1.1.0`, PyPI `1.1.0`, NuGet `1.1.0` and Maven Central `8.1.0`; the latest is 1.1.2 / 8.1.2). The reporting release (FR-044): declare dimensions, measures, segments and an `object.report`, and get a SQL view, a served read-only list route in every port, a generated TanStack list hook, and a Cube data model, with `@spine` for rows that have no facts and `@default` for an empty measure. Also carries the first slice of requirements (the gate in every port's `verify`), the derived-key parity fix across the ports, and the list-hook and nested-average fixes found by the first adopter. See the `CHANGELOG.md` 1.1.0 section for the full scope, pre-release RC history, and the diffs to expect when you upgrade (ejected generators and keyless projections). It also makes documentation a set of generators in every port (ADR-0034 Amendment 9): the docs commands are removed, and `docs/features/migrations/docs-are-generators.md` is the upgrade path. The last 1.0.x release, 1.0.13 (2026-10-03), was a PATCH on 1.0.x. +**Release 1.1.0** (released; npm `1.1.0`, PyPI `1.1.0`, NuGet `1.1.0` and Maven Central `8.1.0`; the latest is 1.1.3 / 8.1.3). The reporting release (FR-044): declare dimensions, measures, segments and an `object.report`, and get a SQL view, a served read-only list route in every port, a generated TanStack list hook, and a Cube data model, with `@spine` for rows that have no facts and `@default` for an empty measure. Also carries the first slice of requirements (the gate in every port's `verify`), the derived-key parity fix across the ports, and the list-hook and nested-average fixes found by the first adopter. See the `CHANGELOG.md` 1.1.0 section for the full scope, pre-release RC history, and the diffs to expect when you upgrade (ejected generators and keyless projections). It also makes documentation a set of generators in every port (ADR-0034 Amendment 9): the docs commands are removed, and `docs/features/migrations/docs-are-generators.md` is the upgrade path. The last 1.0.x release, 1.0.13 (2026-10-03), was a PATCH on 1.0.x. Active and planned work lives in GitHub: issues labelled `FR`, milestones for releases, and the MetaObjects Roadmap project board. `spec/roadmap.md` keeps the release direction and the FR → issue → spec index. Process: `docs/ROADMAP-PROCESS.md`. diff --git a/README.md b/README.md index 6fcc69644..e2d2f31a7 100644 --- a/README.md +++ b/README.md @@ -146,11 +146,11 @@ first-week wedge plan — and `meta init` picks up from there. | Language | Status | Quickstart | Source | |---|---|---|---| -| TypeScript | **npm `1.1.2`** — the `@metaobjectsdev/*` packages | [`docs/ports/typescript.md`](docs/ports/typescript.md) | [`server/typescript/`](server/typescript/) · [`client/web/`](client/web/) | -| Java | **Maven Central `8.1.2`** (`com.metaobjects:*` — the JVM major is npm major + 7) — loader + OMDB + render + Maven plugin all shipped; full conformance green | [`docs/ports/java.md`](docs/ports/java.md) | [`server/java/`](server/java/) | -| Kotlin | **Maven Central `8.1.2`** — codegen tier on top of Java: 16 generators (entity, Exposed table, names, relations, repository, output-parser, output-prompt, render-helper, extractor, filter-allowlist, validator, Spring config, storedProc, Spring controller, requirement-tests, api-docs); 24 / 24 persistence-conformance | [`docs/ports/kotlin.md`](docs/ports/kotlin.md) | [`server/java/codegen-kotlin/`](server/java/codegen-kotlin/) · [`server/java/metadata-ktx/`](server/java/metadata-ktx/) | -| C# | **NuGet `1.1.2`** — loader + conformance + EF Core codegen + render engine + `dotnet meta` CLI all shipped | [`docs/ports/csharp.md`](docs/ports/csharp.md) | [`server/csharp/`](server/csharp/) | -| Python | **PyPI `1.1.2`** — loader + conformance + render + entity-model codegen + ObjectManager runtime shipped; schema migrations are TS-owned (ADR-0015) | [`docs/ports/python.md`](docs/ports/python.md) | [`server/python/`](server/python/) | +| TypeScript | **npm `1.1.3`** — the `@metaobjectsdev/*` packages | [`docs/ports/typescript.md`](docs/ports/typescript.md) | [`server/typescript/`](server/typescript/) · [`client/web/`](client/web/) | +| Java | **Maven Central `8.1.3`** (`com.metaobjects:*` — the JVM major is npm major + 7) — loader + OMDB + render + Maven plugin all shipped; full conformance green | [`docs/ports/java.md`](docs/ports/java.md) | [`server/java/`](server/java/) | +| Kotlin | **Maven Central `8.1.3`** — codegen tier on top of Java: 16 generators (entity, Exposed table, names, relations, repository, output-parser, output-prompt, render-helper, extractor, filter-allowlist, validator, Spring config, storedProc, Spring controller, requirement-tests, api-docs); 24 / 24 persistence-conformance | [`docs/ports/kotlin.md`](docs/ports/kotlin.md) | [`server/java/codegen-kotlin/`](server/java/codegen-kotlin/) · [`server/java/metadata-ktx/`](server/java/metadata-ktx/) | +| C# | **NuGet `1.1.3`** — loader + conformance + EF Core codegen + render engine + `dotnet meta` CLI all shipped | [`docs/ports/csharp.md`](docs/ports/csharp.md) | [`server/csharp/`](server/csharp/) | +| Python | **PyPI `1.1.3`** — loader + conformance + render + entity-model codegen + ObjectManager runtime shipped; schema migrations are TS-owned (ADR-0015) | [`docs/ports/python.md`](docs/ports/python.md) | [`server/python/`](server/python/) | ## Capability matrix diff --git a/docs/ports/csharp.md b/docs/ports/csharp.md index 97dc43777..ec5d181c3 100644 --- a/docs/ports/csharp.md +++ b/docs/ports/csharp.md @@ -6,7 +6,7 @@ Postgres + Npgsql. ## Install -Published to [NuGet](https://www.nuget.org/packages/MetaObjects) at `1.1.2` — four +Published to [NuGet](https://www.nuget.org/packages/MetaObjects) at `1.1.3` — four packages, version-locked to the C# port version: `MetaObjects` (loader), `MetaObjects.Codegen`, `MetaObjects.Render` and the `MetaObjects.Cli` tool. @@ -33,7 +33,7 @@ SQLite so it runs with nothing else installed; the same generated code runs on P enable - + diff --git a/docs/ports/java.md b/docs/ports/java.md index d5aa79d6b..27490bde7 100644 --- a/docs/ports/java.md +++ b/docs/ports/java.md @@ -12,7 +12,7 @@ Prompt / template drift is still checked via the `metaobjects-render` `Verify` A ## Install -Set `${metaobjects.version}` to the current Maven Central release (`8.1.2`) — both +Set `${metaobjects.version}` to the current Maven Central release (`8.1.3`) — both the dependency and plugin blocks below resolve it from one `` entry. The generated records need Java 17 or newer, so set the compiler level here too (Maven defaults to Java 8, where `mvn compile` fails with "records are not supported in -source 8"): @@ -20,7 +20,7 @@ defaults to Java 8, where `mvn compile` fails with "records are not supported in ```xml - 8.1.2 + 8.1.3 3.3.5 21 UTF-8 diff --git a/docs/ports/kotlin.md b/docs/ports/kotlin.md index f88aa82c3..e8fcb65a6 100644 --- a/docs/ports/kotlin.md +++ b/docs/ports/kotlin.md @@ -25,7 +25,7 @@ your own ``, `` and ``: ```xml - 8.1.2 + 8.1.3 2.0.21 3.3.5 0.55.0 diff --git a/docs/ports/typescript.md b/docs/ports/typescript.md index 203ef9fae..5861e6e41 100644 --- a/docs/ports/typescript.md +++ b/docs/ports/typescript.md @@ -1,6 +1,6 @@ # TypeScript port -The reference implementation. Published to npm at `1.1.2` as 14 +The reference implementation. Published to npm at `1.1.3` as 14 `@metaobjectsdev/*` packages on the `latest` tag. Targets Node-compatible runtimes; Bun-first dev workflow. diff --git a/server/typescript/packages/integration-tests/test/api-contract-report-sqlite.test.ts b/server/typescript/packages/integration-tests/test/api-contract-report-sqlite.test.ts index 91aa717a4..e1876a337 100644 --- a/server/typescript/packages/integration-tests/test/api-contract-report-sqlite.test.ts +++ b/server/typescript/packages/integration-tests/test/api-contract-report-sqlite.test.ts @@ -25,6 +25,11 @@ import { startSqliteReportServer, type SqliteReportEngine, type SqliteReportServ const SEED = JSON.parse(readFileSync(join(API_CONTRACT_REPORT_DIR, "seed.json"), "utf8")) as ReportSeed; const META_PATH = join(API_CONTRACT_REPORT_DIR, "meta.json"); +// Every test boots its own server; on D1 that is a Miniflare (workerd) process. Under the default +// parallel lane load (8 lanes) that start-up alone can pass bun's 5000ms default, so these +// server-backed tests get the same headroom as the other server-backed integration tests. +const SERVER_TEST_TIMEOUT_MS = 120_000; + const ENGINES: readonly SqliteReportEngine[] = ["sqlite", "d1"]; async function withServer( @@ -58,7 +63,7 @@ for (const engine of ENGINES) describe(`api contract report (FR-044) — GENERAT expect(row["invoices"]).toBe(5); expect(row["totalCents"]).toBe(315500); }); - }); + }, { timeout: SERVER_TEST_TIMEOUT_MS }); test("a ratio is a string in the withCount envelope too", async () => { await withServer(engine, async (server) => { @@ -68,14 +73,14 @@ for (const engine of ENGINES) describe(`api contract report (FR-044) — GENERAT expect(body.total).toBe(1); expect(typeof body.rows[0]!["paidShare"]).toBe("string"); }); - }); + }, { timeout: SERVER_TEST_TIMEOUT_MS }); test("a ratio over zero rows is null, not the string 'null' or 0", async () => { await withServer(engine, async (server) => { const rows = (await getJson(server, "/api/invoice_totals")) as Array>; expect(rows).toEqual([{ invoices: 0, totalCents: null, paidShare: null }]); }, { invoices: [] }); - }); + }, { timeout: SERVER_TEST_TIMEOUT_MS }); test("a report with no decimal field is untouched: every value keeps its type", async () => { await withServer(engine, async (server) => { @@ -89,7 +94,7 @@ for (const engine of ENGINES) describe(`api contract report (FR-044) — GENERAT SEED.reports!["ProductRevenue"], ); }); - }); + }, { timeout: SERVER_TEST_TIMEOUT_MS }); test("the filter and the sort on a ratio still compare numerically after the wire change", async () => { await withServer(engine, async (server) => { @@ -101,11 +106,11 @@ for (const engine of ENGINES) describe(`api contract report (FR-044) — GENERAT expect(await hit("/api/invoice_totals?filter[paidShare][eq]=0.4")).toBe(1); expect(await hit("/api/invoice_totals?sort=paidShare:desc")).toBe(1); }); - }); + }, { timeout: SERVER_TEST_TIMEOUT_MS }); for (const scenario of loadScenarios(API_CONTRACT_REPORT_SCENARIOS_DIR)) { test(`shared scenario: ${scenario.name}`, async () => { await withServer(engine, (server) => runScenario(scenario, server.baseUrl)); - }); + }, { timeout: SERVER_TEST_TIMEOUT_MS }); } }); diff --git a/server/typescript/packages/integration-tests/test/view-recreate-drift-sqlite.test.ts b/server/typescript/packages/integration-tests/test/view-recreate-drift-sqlite.test.ts index abf9bed45..34fd66cf5 100644 --- a/server/typescript/packages/integration-tests/test/view-recreate-drift-sqlite.test.ts +++ b/server/typescript/packages/integration-tests/test/view-recreate-drift-sqlite.test.ts @@ -34,6 +34,10 @@ function literalColumns(root: T): T { return root; } +// Each test opens its own libsql file database and runs migrate + diff on it; under the default +// parallel lane load that can pass bun's 5000ms default ("Unable to connect"). +const DB_TEST_TIMEOUT_MS = 60_000; + let tmpDir: string; let k: Kysely>; let canonical: MetaRoot; @@ -87,7 +91,7 @@ describe("D3 — a view recreated only around a table rebuild is not drift", () expect(drift.changes.some((c) => c.kind === "add-fk" && c.table === "weeks")).toBe(true); expect(drift.changes.filter(isViewChange)).toEqual([]); expect(drift.blocked.filter(isViewChange)).toEqual([]); - }); + }, { timeout: DB_TEST_TIMEOUT_MS }); test(`${dialect}: the diff still plans each pair, marked unchanged`, async () => { await migrateWithWeeksFkMissing(); @@ -101,7 +105,7 @@ describe("D3 — a view recreated only around a table rebuild is not drift", () const recreated = views.flatMap((c) => c.kind === "create-view" ? [c.view.name] : []); expect(recreated).toContain("v_program_minutes"); expect(recreated).toContain("v_program_roster"); - }); + }, { timeout: DB_TEST_TIMEOUT_MS }); } test("sqlite: the pair applies, and the database then matches the metadata", async () => { @@ -119,5 +123,5 @@ describe("D3 — a view recreated only around a table rebuild is not drift", () await applyRaw(up); const followup = await diff({ expected, actual: await introspectSqlite(k), dialect: "sqlite" }); expect(followup.changes.filter((c) => !isInetResidue(c))).toEqual([]); - }); + }, { timeout: DB_TEST_TIMEOUT_MS }); });