From 0d7a234a847e0223832bc218665bb6243beee496 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 1 Oct 2026 06:33:55 +0000 Subject: [PATCH] docs(quickstart): re-transcribe both boot samples against CLI 17.5.0 Refreshes the quickstart for @objectstack/cli 17.5.0 against a date-resolved 17.4.0 control (npm --before=2026-09-09T05:00:00.000Z), validated by its captures carrying the 17.4.0 blocks. Path A: Plugins 30 -> 31 loaded. Path B: Build complete timing re-transcribed, artifact 1.8 KB -> 1.9 KB, the dev-admin group gains its new three-line platform-admin caveat (published whole), Plugins 30 -> 36 loaded. Both pins move to 17.5.0. Declarations, by diffing each raw capture against its block: the _objectstack_sequences and sys_oauth_resource error lines are gone at 17.5.0 and leave both sentences; a new sys_migration paged-read warning and DATABASE_ERROR are named on both paths; Path B names boot diagnostics again; the MCP trailer wording now matches 10 of 10 boots landing inside the banner. Claude-Session: https://claude.ai/code/session_01FeA1nwBz1ohH65dvffUGKr Co-authored-by: Claude --- content/docs/quickstart.mdx | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/content/docs/quickstart.mdx b/content/docs/quickstart.mdx index 5223854..0f9b992 100644 --- a/content/docs/quickstart.mdx +++ b/content/docs/quickstart.mdx @@ -53,21 +53,21 @@ You'll see: Mode: production Driver: SqlDriver(better-sqlite3) → ~/.objectstack/data/objectstack.db Tenancy: single - Plugins: 30 loaded + Plugins: 31 loaded Press Ctrl+C to stop ``` That's it. You're running ObjectOS. -That block is transcribed from `@objectstack/cli` 17.4.0 booting an empty +That block is transcribed from `@objectstack/cli` 17.5.0 booting an empty kernel. Home paths show as `~/…` — the CLI prints yours expanded. Your own boot also prints a `No objectstack.config.ts or artifact found` line before the server starts, plus startup advisories (local storage driver, dev crypto key, boot diagnostics) and the full list of loaded plugin names, both of which -depend on your environment. It also logs two SQL-driver errors that do not stop -the server: a `DATABASE_ERROR` for a missing `_objectstack_sequences` table, and -an `Insert operation failed` on `sys_oauth_resource` with a stack trace. +depend on your environment. It also logs a SQL-driver warning, +`Paged read of 'sys_migration' is NOT deterministic`, and a `DATABASE_ERROR` +for a missing `sys_migration` table, neither of which stops the server. ### What's running @@ -162,7 +162,7 @@ You'll see: ◆ Compile ──────────────────────────────────────── - ✓ Build complete (97ms) + ✓ Build complete (175ms) Data: 1 Objects 3 Fields UI: 0 Apps @@ -170,7 +170,7 @@ You'll see: Security: 0 Positions 0 Permissions Runtime: 0 plugins - Artifact: my-app/dist/objectstack.json (1.8 KB) + Artifact: my-app/dist/objectstack.json (1.9 KB) → Starting dev server (local mode)... 🎯 Environment ID: env_local @@ -187,27 +187,30 @@ You'll see: 🔑 Dev admin: admin@objectos.ai / admin123 seeded on empty DB · dev only — do not use in production + platform admin — Setup, Studio and every record, but NO app-declared capability, so + an app that gates navigation on requiredPermissions may show it an empty menu; grant + it a permission set under Setup → Users, or sign in as an account your app seeds Config: objectstack.config.ts Mode: development Driver: SqlDriver(better-sqlite3) → my-app/.objectstack/data/objectstack.db Tenancy: single - Plugins: 30 loaded + Plugins: 36 loaded Press Ctrl+C to stop ``` That block is transcribed from `pnpm dev` on a scaffold created by -`@objectstack/cli` 17.4.0. Project paths show as `my-app/…` — the CLI prints +`@objectstack/cli` 17.5.0. Project paths show as `my-app/…` — the CLI prints yours expanded, and the `Build complete` timing is whatever the transcribing machine measured, so yours will differ. Your own run also prints pnpm's script header above the block, per-step compile progress, startup advisories (configuration load, dev secret-field crypto), the full list of loaded plugin -names, and an MCP connection trailer. A separate process prints that trailer, -so it usually follows `Press Ctrl+C to stop` but can land inside the banner. The -run also logs SQL-driver errors that do not stop the server: a `DATABASE_ERROR` -for a missing `_objectstack_sequences` table (printed twice), and an -`Insert operation failed` on `sys_oauth_resource` with a stack trace. +names, boot diagnostics, and an MCP connection trailer. A separate process +prints that trailer, so it usually lands inside the banner, often interleaved +line by line with it. The run also logs a SQL-driver warning, +`Paged read of 'sys_migration' is NOT deterministic`, and a `DATABASE_ERROR` +for a missing `sys_migration` table, neither of which stops the server. Note the dev server asks for port **3000**, the same port `os start` uses. If that port is taken it binds the next free one and says so: