@objectstack/studio 9.4.0 → 9.5.0

package/dist/index.d.mts

@@ -1,4 +1,23 @@
 export { STUDIO_APP } from '@objectstack/platform-objects/apps';
+import { Doc } from '@objectstack/spec/system';
+
+/**
+ * Studio app overview doc (ADR-0046), registered in this package's manifest so
+ * it groups under "Studio" in the `/_console/docs` index.
+ *
+ * Authored inline rather than as a flat `src/docs/*.md` file because this is a
+ * TS-first code package built by tsup, not a user app built by `os build` —
+ * `defineStack({ docs })` / manifest `docs[]` is the supported path for those
+ * (see `DocSchema` in `@objectstack/spec/system`). The `content` below is plain
+ * CommonMark + GFM with no images/MDX, per ADR-0046 §3.4.
+ *
+ * Principle (from the HotCRM reference docs): document the *invisible*
+ * business logic, not what the Studio UI already shows on screen.
+ *
+ * `translations` carries per-locale variants (ADR-0046 i18n); the REST layer
+ * collapses the doc to the request's `Accept-Language` and serves one body.
+ */
+declare const STUDIO_OVERVIEW_DOC: Doc;
 
 /**
  * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack
@@ -49,4 +68,4 @@ declare class StudioAppPlugin {
 /** Convenience factory mirroring the rest of the plugin ecosystem. */
 declare function createStudioAppPlugin(): StudioAppPlugin;
 
-export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };
+export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, STUDIO_OVERVIEW_DOC, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };

package/dist/index.d.ts

@@ -1,4 +1,23 @@
 export { STUDIO_APP } from '@objectstack/platform-objects/apps';
+import { Doc } from '@objectstack/spec/system';
+
+/**
+ * Studio app overview doc (ADR-0046), registered in this package's manifest so
+ * it groups under "Studio" in the `/_console/docs` index.
+ *
+ * Authored inline rather than as a flat `src/docs/*.md` file because this is a
+ * TS-first code package built by tsup, not a user app built by `os build` —
+ * `defineStack({ docs })` / manifest `docs[]` is the supported path for those
+ * (see `DocSchema` in `@objectstack/spec/system`). The `content` below is plain
+ * CommonMark + GFM with no images/MDX, per ADR-0046 §3.4.
+ *
+ * Principle (from the HotCRM reference docs): document the *invisible*
+ * business logic, not what the Studio UI already shows on screen.
+ *
+ * `translations` carries per-locale variants (ADR-0046 i18n); the REST layer
+ * collapses the doc to the request's `Accept-Language` and serves one body.
+ */
+declare const STUDIO_OVERVIEW_DOC: Doc;
 
 /**
  * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack
@@ -49,4 +68,4 @@ declare class StudioAppPlugin {
 /** Convenience factory mirroring the rest of the plugin ecosystem. */
 declare function createStudioAppPlugin(): StudioAppPlugin;
 
-export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };
+export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, STUDIO_OVERVIEW_DOC, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };

package/dist/index.js

@@ -2,6 +2,85 @@
 
 var apps = require('@objectstack/platform-objects/apps');
 
+// src/index.ts
+
+// src/studio-overview.doc.ts
+var STUDIO_OVERVIEW_DOC = {
+  name: "studio_overview",
+  label: "Studio overview",
+  description: "Orientation for builders: the metadata-first model, overlay precedence, and publishing.",
+  content: `# Studio overview
+
+Studio is the builder app \u2014 the workbench for shaping the platform's
+*metadata*: objects, fields, views, flows, agents, and the rest. Most of its
+screens are self-explanatory; this page covers the one rule that is not visible
+on screen but governs everything you do here. For the full reference, see
+<https://docs.objectstack.ai>.
+
+## Metadata-first
+
+In Studio you do not edit a running database \u2014 you edit *definitions*. Every
+object, field, and view is a metadata record, and the live application is
+generated from that metadata. This is why a change in Studio can reshape the UI
+and the API at once: you are changing the model, not patching a screen.
+
+## Edits are overlays (the invisible rule)
+
+Your changes do not mutate the metadata shipped by a package in place. Studio
+writes an **overlay** on top of the base definition, and the runtime resolves
+the two by precedence: an unpublished **draft** wins for you while you work, a
+published **tenant overlay** wins over the package's baseline, and the package
+baseline is the fallback (ADR-0005, ADR-0033). The practical consequence: the
+base definition is never destroyed, so an overlay can always be reverted to
+recover the original \u2014 and a field that "won't change" is usually being shadowed
+by a higher-precedence layer.
+
+## Publishing & deploying
+
+A draft is visible only to you until you **publish** it, which promotes the
+overlay so the rest of the tenant sees it. Moving changes between environments
+(for example dev \u2192 production) is a separate **deploy** step, not an automatic
+side effect of publishing \u2014 keeping the two distinct is what lets you build
+safely in one environment before shipping.
+
+See <https://docs.objectstack.ai> for drafts, overlays, and deployment in depth.
+`,
+  translations: {
+    zh: {
+      label: "Studio \u6982\u89C8",
+      description: "\u642D\u5EFA\u8005\u5165\u95E8:\u5143\u6570\u636E\u4F18\u5148\u6A21\u578B\u3001\u8986\u76D6\u5C42\u4F18\u5148\u7EA7\u3001\u53D1\u5E03\u4E0E\u90E8\u7F72\u3002",
+      content: `# Studio \u6982\u89C8
+
+Studio \u662F\u642D\u5EFA\u8005\u5E94\u7528\u2014\u2014\u5851\u9020\u5E73\u53F0*\u5143\u6570\u636E*\u7684\u5DE5\u4F5C\u53F0:\u5BF9\u8C61\u3001\u5B57\u6BB5\u3001\u89C6\u56FE\u3001\u6D41\u7A0B\u3001\u667A\u80FD\u4F53\u7B49\u3002
+\u5B83\u7684\u5927\u591A\u6570\u754C\u9762\u4E00\u76EE\u4E86\u7136;\u672C\u9875\u8BB2\u7684\u662F\u90A3\u6761\u754C\u9762\u4E0A\u770B\u4E0D\u89C1\u3001\u5374\u652F\u914D\u4F60\u5728\u8FD9\u91CC\u4E00\u5207\u64CD\u4F5C\u7684\u89C4\u5219\u3002
+\u5B8C\u6574\u53C2\u8003\u89C1 <https://docs.objectstack.ai>\u3002
+
+## \u5143\u6570\u636E\u4F18\u5148
+
+\u5728 Studio \u91CC\u4F60\u7F16\u8F91\u7684\u4E0D\u662F\u8FD0\u884C\u4E2D\u7684\u6570\u636E\u5E93,\u800C\u662F*\u5B9A\u4E49*\u3002\u6BCF\u4E2A\u5BF9\u8C61\u3001\u5B57\u6BB5\u3001\u89C6\u56FE\u90FD\u662F\u4E00\u6761
+\u5143\u6570\u636E\u8BB0\u5F55,\u8FD0\u884C\u7684\u5E94\u7528\u7531\u8FD9\u4E9B\u5143\u6570\u636E\u751F\u6210\u3002\u8FD9\u5C31\u662F\u4E3A\u4EC0\u4E48 Studio \u91CC\u7684\u4E00\u5904\u6539\u52A8\u80FD\u540C\u65F6\u91CD\u5851
+UI \u548C API:\u4F60\u6539\u7684\u662F\u6A21\u578B,\u800C\u4E0D\u662F\u4FEE\u8865\u67D0\u4E2A\u754C\u9762\u3002
+
+## \u7F16\u8F91\u5373\u8986\u76D6\u5C42(\u770B\u4E0D\u89C1\u7684\u89C4\u5219)
+
+\u4F60\u7684\u6539\u52A8\u4E0D\u4F1A\u539F\u5730\u4FEE\u6539\u67D0\u4E2A\u5305\u53D1\u5E03\u7684\u5143\u6570\u636E\u3002Studio \u5728\u57FA\u7840\u5B9A\u4E49\u4E4B\u4E0A\u5199\u4E00\u5C42**\u8986\u76D6\u5C42**,
+\u8FD0\u884C\u65F6\u6309\u4F18\u5148\u7EA7\u89E3\u6790\u4E24\u8005:\u672A\u53D1\u5E03\u7684**\u8349\u7A3F**\u5728\u4F60\u7F16\u8F91\u65F6\u5BF9\u4F60\u751F\u6548,\u5DF2\u53D1\u5E03\u7684**\u79DF\u6237\u8986\u76D6\u5C42**
+\u4F18\u5148\u4E8E\u5305\u7684\u57FA\u7EBF,\u5305\u57FA\u7EBF\u5219\u662F\u515C\u5E95(ADR-0005\u3001ADR-0033)\u3002\u5B9E\u9645\u540E\u679C:\u57FA\u7840\u5B9A\u4E49\u6C38\u4E0D\u88AB
+\u9500\u6BC1,\u6240\u4EE5\u8986\u76D6\u5C42\u603B\u80FD\u56DE\u9000\u4EE5\u6062\u590D\u539F\u6837\u2014\u2014\u800C\u4E00\u4E2A"\u6539\u4E0D\u52A8"\u7684\u5B57\u6BB5,\u901A\u5E38\u662F\u88AB\u66F4\u9AD8\u4F18\u5148\u7EA7\u7684
+\u5C42\u906E\u4F4F\u4E86\u3002
+
+## \u53D1\u5E03\u4E0E\u90E8\u7F72
+
+\u8349\u7A3F\u53EA\u5BF9\u4F60\u81EA\u5DF1\u53EF\u89C1,\u76F4\u5230\u4F60**\u53D1\u5E03**\u5B83,\u628A\u8986\u76D6\u5C42\u63D0\u5347\u7ED9\u6574\u4E2A\u79DF\u6237\u770B\u5230\u3002\u5728\u73AF\u5883\u4E4B\u95F4\u642C\u8FD0
+\u6539\u52A8(\u4F8B\u5982\u5F00\u53D1 \u2192 \u751F\u4EA7)\u662F\u5355\u72EC\u7684**\u90E8\u7F72**\u6B65\u9AA4,\u4E0D\u662F\u53D1\u5E03\u7684\u81EA\u52A8\u526F\u4F5C\u7528\u2014\u2014\u628A\u4E24\u8005\u5206\u5F00,
+\u624D\u80FD\u8BA9\u4F60\u5728\u4E00\u4E2A\u73AF\u5883\u91CC\u5B89\u5168\u642D\u5EFA\u3001\u518D\u4E0A\u7EBF\u3002
+
+\u8349\u7A3F\u3001\u8986\u76D6\u5C42\u4E0E\u90E8\u7F72\u7684\u7EC6\u8282\u89C1 <https://docs.objectstack.ai>\u3002
+`
+    }
+  }
+};
+
 // src/index.ts
 var STUDIO_APP_PACKAGE_ID = "com.objectstack.studio";
 var STUDIO_APP_NAMESPACE = "studio";
@@ -32,7 +111,12 @@ var StudioAppPlugin = class {
   async start(ctx) {
     const manifest = ctx?.getService?.("manifest");
     if (!manifest || typeof manifest.register !== "function") return;
-    manifest.register({ ...studioAppManifestHeader, apps: [apps.STUDIO_APP] });
+    manifest.register({
+      ...studioAppManifestHeader,
+      apps: [apps.STUDIO_APP],
+      // ADR-0046 package docs — grouped under "Studio" at /_console/docs.
+      docs: [STUDIO_OVERVIEW_DOC]
+    });
   }
 };
 function createStudioAppPlugin() {
@@ -46,6 +130,7 @@ Object.defineProperty(exports, "STUDIO_APP", {
 exports.STUDIO_APP_NAMESPACE = STUDIO_APP_NAMESPACE;
 exports.STUDIO_APP_PACKAGE_ID = STUDIO_APP_PACKAGE_ID;
 exports.STUDIO_APP_VERSION = STUDIO_APP_VERSION;
+exports.STUDIO_OVERVIEW_DOC = STUDIO_OVERVIEW_DOC;
 exports.StudioAppPlugin = StudioAppPlugin;
 exports.createStudioAppPlugin = createStudioAppPlugin;
 exports.studioAppManifestHeader = studioAppManifestHeader;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["STUDIO_APP"],"mappings":";;;;;AAuBO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,oBAAA,GAAuB;AAC7B,IAAM,kBAAA,GAAqB;AAG3B,IAAM,uBAAA,GAA0B;AAAA,EACrC,EAAA,EAAI,qBAAA;AAAA,EACJ,SAAA,EAAW,oBAAA;AAAA,EACX,OAAA,EAAS,kBAAA;AAAA,EACT,IAAA,EAAM,QAAA;AAAA,EACN,KAAA,EAAO,QAAA;AAAA,EACP,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EAAa,iDAAA;AAAA;AAAA;AAAA,EAGb,YAAA,EAAc,CAAC,6BAA6B;AAC9C;AAOO,IAAM,kBAAN,MAAsB;AAAA,EAAtB,WAAA,GAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,qBAAA;AAChB,IAAA,IAAA,CAAS,IAAA,GAAO,UAAA;AAChB,IAAA,IAAA,CAAS,OAAA,GAAU,kBAAA;AAGnB;AAAA;AAAA,IAAA,IAAA,CAAS,YAAA,GAAyB,CAAC,sBAAsB,CAAA;AAAA,EAAA;AAAA,EAEzD,MAAM,KAAK,IAAA,EAA0B;AAAA,EAErC;AAAA,EAEA,MAAM,MAAM,GAAA,EAAyB;AACnC,IAAA,MAAM,QAAA,GAAW,GAAA,EAAK,UAAA,GAAa,UAAU,CAAA;AAC7C,IAAA,IAAI,CAAC,QAAA,IAAY,OAAO,QAAA,CAAS,aAAa,UAAA,EAAY;AAC1D,IAAA,QAAA,CAAS,QAAA,CAAS,EAAE,GAAG,uBAAA,EAAyB,MAAM,CAACA,eAAU,GAAG,CAAA;AAAA,EACtE;AACF;AAGO,SAAS,qBAAA,GAAyC;AACvD,EAAA,OAAO,IAAI,eAAA,EAAgB;AAC7B","file":"index.js","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack\n * package (ADR-0048: one app per package).\n *\n * Studio is a console navigation-shell app (an `AppSchema`), not a kernel\n * extension — but it still needs a thin registration entry to publish its\n * manifest into the running kernel, mirroring how `@objectstack/plugin-auth`\n * registers its own manifest. Giving it a distinct package id\n * (`com.objectstack.studio`) is what lets `/apps/<packageId>` resolve to exactly\n * this app instead of being ambiguous inside a multi-app package.\n *\n * NOTE (transitional): the `STUDIO_APP` schema is still imported from\n * `@objectstack/platform-objects/apps`; a follow-up moves the definition into\n * this package and drops the dependency. This package is intentionally NOT yet\n * wired into the dev/serve plugin set — that boot-path switch (and removing the\n * app from plugin-auth's manifest) lands separately so it can be verified\n * against a live `os dev` boot.\n */\n\nimport { STUDIO_APP } from '@objectstack/platform-objects/apps';\n\nexport const STUDIO_APP_PACKAGE_ID = 'com.objectstack.studio';\nexport const STUDIO_APP_NAMESPACE = 'studio';\nexport const STUDIO_APP_VERSION = '9.3.0';\n\n/** Manifest header for the Studio app package. */\nexport const studioAppManifestHeader = {\n  id: STUDIO_APP_PACKAGE_ID,\n  namespace: STUDIO_APP_NAMESPACE,\n  version: STUDIO_APP_VERSION,\n  type: 'plugin' as const,\n  scope: 'system' as const,\n  name: 'Studio',\n  description: 'ObjectStack Studio — metadata builder app.',\n  // Studio navigates platform metadata owned by plugin-auth; declare the\n  // dependency so it loads after the auth objects are registered.\n  dependencies: ['com.objectstack.plugin-auth'],\n};\n\n/**\n * Thin plugin that registers the Studio app manifest. Structurally typed\n * against the kernel `Plugin` contract (no compile-time kernel dependency),\n * exactly like `AuthPlugin`.\n */\nexport class StudioAppPlugin {\n  readonly name = STUDIO_APP_PACKAGE_ID;\n  readonly type = 'standard';\n  readonly version = STUDIO_APP_VERSION;\n  // Kernel plugin dependency is matched by plugin NAME (AuthPlugin.name =\n  // 'com.objectstack.auth'), not by package id.\n  readonly dependencies: string[] = ['com.objectstack.auth'];\n\n  async init(_ctx: any): Promise<void> {\n    // No-op: registration happens in start() once the manifest service exists.\n  }\n\n  async start(ctx: any): Promise<void> {\n    const manifest = ctx?.getService?.('manifest');\n    if (!manifest || typeof manifest.register !== 'function') return;\n    manifest.register({ ...studioAppManifestHeader, apps: [STUDIO_APP] });\n  }\n}\n\n/** Convenience factory mirroring the rest of the plugin ecosystem. */\nexport function createStudioAppPlugin(): StudioAppPlugin {\n  return new StudioAppPlugin();\n}\n\nexport { STUDIO_APP };\n"]}
+{"version":3,"sources":["../src/studio-overview.doc.ts","../src/index.ts"],"names":["STUDIO_APP"],"mappings":";;;;;;;AAoBO,IAAM,mBAAA,GAA2B;AAAA,EACtC,IAAA,EAAM,iBAAA;AAAA,EACN,KAAA,EAAO,iBAAA;AAAA,EACP,WAAA,EAAa,yFAAA;AAAA,EACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,CAAA;AAAA,EAoCT,YAAA,EAAc;AAAA,IACZ,EAAA,EAAI;AAAA,MACF,KAAA,EAAO,qBAAA;AAAA,MACP,WAAA,EAAa,+JAAA;AAAA,MACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AA4BX;AAEJ;;;ACrEO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,oBAAA,GAAuB;AAC7B,IAAM,kBAAA,GAAqB;AAG3B,IAAM,uBAAA,GAA0B;AAAA,EACrC,EAAA,EAAI,qBAAA;AAAA,EACJ,SAAA,EAAW,oBAAA;AAAA,EACX,OAAA,EAAS,kBAAA;AAAA,EACT,IAAA,EAAM,QAAA;AAAA,EACN,KAAA,EAAO,QAAA;AAAA,EACP,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EAAa,iDAAA;AAAA;AAAA;AAAA,EAGb,YAAA,EAAc,CAAC,6BAA6B;AAC9C;AAOO,IAAM,kBAAN,MAAsB;AAAA,EAAtB,WAAA,GAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,qBAAA;AAChB,IAAA,IAAA,CAAS,IAAA,GAAO,UAAA;AAChB,IAAA,IAAA,CAAS,OAAA,GAAU,kBAAA;AAGnB;AAAA;AAAA,IAAA,IAAA,CAAS,YAAA,GAAyB,CAAC,sBAAsB,CAAA;AAAA,EAAA;AAAA,EAEzD,MAAM,KAAK,IAAA,EAA0B;AAAA,EAErC;AAAA,EAEA,MAAM,MAAM,GAAA,EAAyB;AACnC,IAAA,MAAM,QAAA,GAAW,GAAA,EAAK,UAAA,GAAa,UAAU,CAAA;AAC7C,IAAA,IAAI,CAAC,QAAA,IAAY,OAAO,QAAA,CAAS,aAAa,UAAA,EAAY;AAC1D,IAAA,QAAA,CAAS,QAAA,CAAS;AAAA,MAChB,GAAG,uBAAA;AAAA,MACH,IAAA,EAAM,CAACA,eAAU,CAAA;AAAA;AAAA,MAEjB,IAAA,EAAM,CAAC,mBAAmB;AAAA,KAC3B,CAAA;AAAA,EACH;AACF;AAGO,SAAS,qBAAA,GAAyC;AACvD,EAAA,OAAO,IAAI,eAAA,EAAgB;AAC7B","file":"index.js","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Doc } from '@objectstack/spec/system';\n\n/**\n * Studio app overview doc (ADR-0046), registered in this package's manifest so\n * it groups under \"Studio\" in the `/_console/docs` index.\n *\n * Authored inline rather than as a flat `src/docs/*.md` file because this is a\n * TS-first code package built by tsup, not a user app built by `os build` —\n * `defineStack({ docs })` / manifest `docs[]` is the supported path for those\n * (see `DocSchema` in `@objectstack/spec/system`). The `content` below is plain\n * CommonMark + GFM with no images/MDX, per ADR-0046 §3.4.\n *\n * Principle (from the HotCRM reference docs): document the *invisible*\n * business logic, not what the Studio UI already shows on screen.\n *\n * `translations` carries per-locale variants (ADR-0046 i18n); the REST layer\n * collapses the doc to the request's `Accept-Language` and serves one body.\n */\nexport const STUDIO_OVERVIEW_DOC: Doc = {\n  name: 'studio_overview',\n  label: 'Studio overview',\n  description: 'Orientation for builders: the metadata-first model, overlay precedence, and publishing.',\n  content: `# Studio overview\n\nStudio is the builder app — the workbench for shaping the platform's\n*metadata*: objects, fields, views, flows, agents, and the rest. Most of its\nscreens are self-explanatory; this page covers the one rule that is not visible\non screen but governs everything you do here. For the full reference, see\n<https://docs.objectstack.ai>.\n\n## Metadata-first\n\nIn Studio you do not edit a running database — you edit *definitions*. Every\nobject, field, and view is a metadata record, and the live application is\ngenerated from that metadata. This is why a change in Studio can reshape the UI\nand the API at once: you are changing the model, not patching a screen.\n\n## Edits are overlays (the invisible rule)\n\nYour changes do not mutate the metadata shipped by a package in place. Studio\nwrites an **overlay** on top of the base definition, and the runtime resolves\nthe two by precedence: an unpublished **draft** wins for you while you work, a\npublished **tenant overlay** wins over the package's baseline, and the package\nbaseline is the fallback (ADR-0005, ADR-0033). The practical consequence: the\nbase definition is never destroyed, so an overlay can always be reverted to\nrecover the original — and a field that \"won't change\" is usually being shadowed\nby a higher-precedence layer.\n\n## Publishing & deploying\n\nA draft is visible only to you until you **publish** it, which promotes the\noverlay so the rest of the tenant sees it. Moving changes between environments\n(for example dev → production) is a separate **deploy** step, not an automatic\nside effect of publishing — keeping the two distinct is what lets you build\nsafely in one environment before shipping.\n\nSee <https://docs.objectstack.ai> for drafts, overlays, and deployment in depth.\n`,\n  translations: {\n    zh: {\n      label: 'Studio 概览',\n      description: '搭建者入门:元数据优先模型、覆盖层优先级、发布与部署。',\n      content: `# Studio 概览\n\nStudio 是搭建者应用——塑造平台*元数据*的工作台:对象、字段、视图、流程、智能体等。\n它的大多数界面一目了然;本页讲的是那条界面上看不见、却支配你在这里一切操作的规则。\n完整参考见 <https://docs.objectstack.ai>。\n\n## 元数据优先\n\n在 Studio 里你编辑的不是运行中的数据库,而是*定义*。每个对象、字段、视图都是一条\n元数据记录,运行的应用由这些元数据生成。这就是为什么 Studio 里的一处改动能同时重塑\nUI 和 API:你改的是模型,而不是修补某个界面。\n\n## 编辑即覆盖层(看不见的规则)\n\n你的改动不会原地修改某个包发布的元数据。Studio 在基础定义之上写一层**覆盖层**,\n运行时按优先级解析两者:未发布的**草稿**在你编辑时对你生效,已发布的**租户覆盖层**\n优先于包的基线,包基线则是兜底(ADR-0005、ADR-0033)。实际后果:基础定义永不被\n销毁,所以覆盖层总能回退以恢复原样——而一个\"改不动\"的字段,通常是被更高优先级的\n层遮住了。\n\n## 发布与部署\n\n草稿只对你自己可见,直到你**发布**它,把覆盖层提升给整个租户看到。在环境之间搬运\n改动(例如开发 → 生产)是单独的**部署**步骤,不是发布的自动副作用——把两者分开,\n才能让你在一个环境里安全搭建、再上线。\n\n草稿、覆盖层与部署的细节见 <https://docs.objectstack.ai>。\n`,\n    },\n  },\n};\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack\n * package (ADR-0048: one app per package).\n *\n * Studio is a console navigation-shell app (an `AppSchema`), not a kernel\n * extension — but it still needs a thin registration entry to publish its\n * manifest into the running kernel, mirroring how `@objectstack/plugin-auth`\n * registers its own manifest. Giving it a distinct package id\n * (`com.objectstack.studio`) is what lets `/apps/<packageId>` resolve to exactly\n * this app instead of being ambiguous inside a multi-app package.\n *\n * NOTE (transitional): the `STUDIO_APP` schema is still imported from\n * `@objectstack/platform-objects/apps`; a follow-up moves the definition into\n * this package and drops the dependency. This package is intentionally NOT yet\n * wired into the dev/serve plugin set — that boot-path switch (and removing the\n * app from plugin-auth's manifest) lands separately so it can be verified\n * against a live `os dev` boot.\n */\n\nimport { STUDIO_APP } from '@objectstack/platform-objects/apps';\n\nimport { STUDIO_OVERVIEW_DOC } from './studio-overview.doc.js';\n\nexport const STUDIO_APP_PACKAGE_ID = 'com.objectstack.studio';\nexport const STUDIO_APP_NAMESPACE = 'studio';\nexport const STUDIO_APP_VERSION = '9.3.0';\n\n/** Manifest header for the Studio app package. */\nexport const studioAppManifestHeader = {\n  id: STUDIO_APP_PACKAGE_ID,\n  namespace: STUDIO_APP_NAMESPACE,\n  version: STUDIO_APP_VERSION,\n  type: 'plugin' as const,\n  scope: 'system' as const,\n  name: 'Studio',\n  description: 'ObjectStack Studio — metadata builder app.',\n  // Studio navigates platform metadata owned by plugin-auth; declare the\n  // dependency so it loads after the auth objects are registered.\n  dependencies: ['com.objectstack.plugin-auth'],\n};\n\n/**\n * Thin plugin that registers the Studio app manifest. Structurally typed\n * against the kernel `Plugin` contract (no compile-time kernel dependency),\n * exactly like `AuthPlugin`.\n */\nexport class StudioAppPlugin {\n  readonly name = STUDIO_APP_PACKAGE_ID;\n  readonly type = 'standard';\n  readonly version = STUDIO_APP_VERSION;\n  // Kernel plugin dependency is matched by plugin NAME (AuthPlugin.name =\n  // 'com.objectstack.auth'), not by package id.\n  readonly dependencies: string[] = ['com.objectstack.auth'];\n\n  async init(_ctx: any): Promise<void> {\n    // No-op: registration happens in start() once the manifest service exists.\n  }\n\n  async start(ctx: any): Promise<void> {\n    const manifest = ctx?.getService?.('manifest');\n    if (!manifest || typeof manifest.register !== 'function') return;\n    manifest.register({\n      ...studioAppManifestHeader,\n      apps: [STUDIO_APP],\n      // ADR-0046 package docs — grouped under \"Studio\" at /_console/docs.\n      docs: [STUDIO_OVERVIEW_DOC],\n    });\n  }\n}\n\n/** Convenience factory mirroring the rest of the plugin ecosystem. */\nexport function createStudioAppPlugin(): StudioAppPlugin {\n  return new StudioAppPlugin();\n}\n\nexport { STUDIO_APP };\nexport { STUDIO_OVERVIEW_DOC };\n"]}

package/dist/index.mjs

@@ -1,6 +1,85 @@
 import { STUDIO_APP } from '@objectstack/platform-objects/apps';
 export { STUDIO_APP } from '@objectstack/platform-objects/apps';
 
+// src/index.ts
+
+// src/studio-overview.doc.ts
+var STUDIO_OVERVIEW_DOC = {
+  name: "studio_overview",
+  label: "Studio overview",
+  description: "Orientation for builders: the metadata-first model, overlay precedence, and publishing.",
+  content: `# Studio overview
+
+Studio is the builder app \u2014 the workbench for shaping the platform's
+*metadata*: objects, fields, views, flows, agents, and the rest. Most of its
+screens are self-explanatory; this page covers the one rule that is not visible
+on screen but governs everything you do here. For the full reference, see
+<https://docs.objectstack.ai>.
+
+## Metadata-first
+
+In Studio you do not edit a running database \u2014 you edit *definitions*. Every
+object, field, and view is a metadata record, and the live application is
+generated from that metadata. This is why a change in Studio can reshape the UI
+and the API at once: you are changing the model, not patching a screen.
+
+## Edits are overlays (the invisible rule)
+
+Your changes do not mutate the metadata shipped by a package in place. Studio
+writes an **overlay** on top of the base definition, and the runtime resolves
+the two by precedence: an unpublished **draft** wins for you while you work, a
+published **tenant overlay** wins over the package's baseline, and the package
+baseline is the fallback (ADR-0005, ADR-0033). The practical consequence: the
+base definition is never destroyed, so an overlay can always be reverted to
+recover the original \u2014 and a field that "won't change" is usually being shadowed
+by a higher-precedence layer.
+
+## Publishing & deploying
+
+A draft is visible only to you until you **publish** it, which promotes the
+overlay so the rest of the tenant sees it. Moving changes between environments
+(for example dev \u2192 production) is a separate **deploy** step, not an automatic
+side effect of publishing \u2014 keeping the two distinct is what lets you build
+safely in one environment before shipping.
+
+See <https://docs.objectstack.ai> for drafts, overlays, and deployment in depth.
+`,
+  translations: {
+    zh: {
+      label: "Studio \u6982\u89C8",
+      description: "\u642D\u5EFA\u8005\u5165\u95E8:\u5143\u6570\u636E\u4F18\u5148\u6A21\u578B\u3001\u8986\u76D6\u5C42\u4F18\u5148\u7EA7\u3001\u53D1\u5E03\u4E0E\u90E8\u7F72\u3002",
+      content: `# Studio \u6982\u89C8
+
+Studio \u662F\u642D\u5EFA\u8005\u5E94\u7528\u2014\u2014\u5851\u9020\u5E73\u53F0*\u5143\u6570\u636E*\u7684\u5DE5\u4F5C\u53F0:\u5BF9\u8C61\u3001\u5B57\u6BB5\u3001\u89C6\u56FE\u3001\u6D41\u7A0B\u3001\u667A\u80FD\u4F53\u7B49\u3002
+\u5B83\u7684\u5927\u591A\u6570\u754C\u9762\u4E00\u76EE\u4E86\u7136;\u672C\u9875\u8BB2\u7684\u662F\u90A3\u6761\u754C\u9762\u4E0A\u770B\u4E0D\u89C1\u3001\u5374\u652F\u914D\u4F60\u5728\u8FD9\u91CC\u4E00\u5207\u64CD\u4F5C\u7684\u89C4\u5219\u3002
+\u5B8C\u6574\u53C2\u8003\u89C1 <https://docs.objectstack.ai>\u3002
+
+## \u5143\u6570\u636E\u4F18\u5148
+
+\u5728 Studio \u91CC\u4F60\u7F16\u8F91\u7684\u4E0D\u662F\u8FD0\u884C\u4E2D\u7684\u6570\u636E\u5E93,\u800C\u662F*\u5B9A\u4E49*\u3002\u6BCF\u4E2A\u5BF9\u8C61\u3001\u5B57\u6BB5\u3001\u89C6\u56FE\u90FD\u662F\u4E00\u6761
+\u5143\u6570\u636E\u8BB0\u5F55,\u8FD0\u884C\u7684\u5E94\u7528\u7531\u8FD9\u4E9B\u5143\u6570\u636E\u751F\u6210\u3002\u8FD9\u5C31\u662F\u4E3A\u4EC0\u4E48 Studio \u91CC\u7684\u4E00\u5904\u6539\u52A8\u80FD\u540C\u65F6\u91CD\u5851
+UI \u548C API:\u4F60\u6539\u7684\u662F\u6A21\u578B,\u800C\u4E0D\u662F\u4FEE\u8865\u67D0\u4E2A\u754C\u9762\u3002
+
+## \u7F16\u8F91\u5373\u8986\u76D6\u5C42(\u770B\u4E0D\u89C1\u7684\u89C4\u5219)
+
+\u4F60\u7684\u6539\u52A8\u4E0D\u4F1A\u539F\u5730\u4FEE\u6539\u67D0\u4E2A\u5305\u53D1\u5E03\u7684\u5143\u6570\u636E\u3002Studio \u5728\u57FA\u7840\u5B9A\u4E49\u4E4B\u4E0A\u5199\u4E00\u5C42**\u8986\u76D6\u5C42**,
+\u8FD0\u884C\u65F6\u6309\u4F18\u5148\u7EA7\u89E3\u6790\u4E24\u8005:\u672A\u53D1\u5E03\u7684**\u8349\u7A3F**\u5728\u4F60\u7F16\u8F91\u65F6\u5BF9\u4F60\u751F\u6548,\u5DF2\u53D1\u5E03\u7684**\u79DF\u6237\u8986\u76D6\u5C42**
+\u4F18\u5148\u4E8E\u5305\u7684\u57FA\u7EBF,\u5305\u57FA\u7EBF\u5219\u662F\u515C\u5E95(ADR-0005\u3001ADR-0033)\u3002\u5B9E\u9645\u540E\u679C:\u57FA\u7840\u5B9A\u4E49\u6C38\u4E0D\u88AB
+\u9500\u6BC1,\u6240\u4EE5\u8986\u76D6\u5C42\u603B\u80FD\u56DE\u9000\u4EE5\u6062\u590D\u539F\u6837\u2014\u2014\u800C\u4E00\u4E2A"\u6539\u4E0D\u52A8"\u7684\u5B57\u6BB5,\u901A\u5E38\u662F\u88AB\u66F4\u9AD8\u4F18\u5148\u7EA7\u7684
+\u5C42\u906E\u4F4F\u4E86\u3002
+
+## \u53D1\u5E03\u4E0E\u90E8\u7F72
+
+\u8349\u7A3F\u53EA\u5BF9\u4F60\u81EA\u5DF1\u53EF\u89C1,\u76F4\u5230\u4F60**\u53D1\u5E03**\u5B83,\u628A\u8986\u76D6\u5C42\u63D0\u5347\u7ED9\u6574\u4E2A\u79DF\u6237\u770B\u5230\u3002\u5728\u73AF\u5883\u4E4B\u95F4\u642C\u8FD0
+\u6539\u52A8(\u4F8B\u5982\u5F00\u53D1 \u2192 \u751F\u4EA7)\u662F\u5355\u72EC\u7684**\u90E8\u7F72**\u6B65\u9AA4,\u4E0D\u662F\u53D1\u5E03\u7684\u81EA\u52A8\u526F\u4F5C\u7528\u2014\u2014\u628A\u4E24\u8005\u5206\u5F00,
+\u624D\u80FD\u8BA9\u4F60\u5728\u4E00\u4E2A\u73AF\u5883\u91CC\u5B89\u5168\u642D\u5EFA\u3001\u518D\u4E0A\u7EBF\u3002
+
+\u8349\u7A3F\u3001\u8986\u76D6\u5C42\u4E0E\u90E8\u7F72\u7684\u7EC6\u8282\u89C1 <https://docs.objectstack.ai>\u3002
+`
+    }
+  }
+};
+
 // src/index.ts
 var STUDIO_APP_PACKAGE_ID = "com.objectstack.studio";
 var STUDIO_APP_NAMESPACE = "studio";
@@ -31,13 +110,18 @@ var StudioAppPlugin = class {
   async start(ctx) {
     const manifest = ctx?.getService?.("manifest");
     if (!manifest || typeof manifest.register !== "function") return;
-    manifest.register({ ...studioAppManifestHeader, apps: [STUDIO_APP] });
+    manifest.register({
+      ...studioAppManifestHeader,
+      apps: [STUDIO_APP],
+      // ADR-0046 package docs — grouped under "Studio" at /_console/docs.
+      docs: [STUDIO_OVERVIEW_DOC]
+    });
   }
 };
 function createStudioAppPlugin() {
   return new StudioAppPlugin();
 }
 
-export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };
+export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, STUDIO_OVERVIEW_DOC, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;AAuBO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,oBAAA,GAAuB;AAC7B,IAAM,kBAAA,GAAqB;AAG3B,IAAM,uBAAA,GAA0B;AAAA,EACrC,EAAA,EAAI,qBAAA;AAAA,EACJ,SAAA,EAAW,oBAAA;AAAA,EACX,OAAA,EAAS,kBAAA;AAAA,EACT,IAAA,EAAM,QAAA;AAAA,EACN,KAAA,EAAO,QAAA;AAAA,EACP,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EAAa,iDAAA;AAAA;AAAA;AAAA,EAGb,YAAA,EAAc,CAAC,6BAA6B;AAC9C;AAOO,IAAM,kBAAN,MAAsB;AAAA,EAAtB,WAAA,GAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,qBAAA;AAChB,IAAA,IAAA,CAAS,IAAA,GAAO,UAAA;AAChB,IAAA,IAAA,CAAS,OAAA,GAAU,kBAAA;AAGnB;AAAA;AAAA,IAAA,IAAA,CAAS,YAAA,GAAyB,CAAC,sBAAsB,CAAA;AAAA,EAAA;AAAA,EAEzD,MAAM,KAAK,IAAA,EAA0B;AAAA,EAErC;AAAA,EAEA,MAAM,MAAM,GAAA,EAAyB;AACnC,IAAA,MAAM,QAAA,GAAW,GAAA,EAAK,UAAA,GAAa,UAAU,CAAA;AAC7C,IAAA,IAAI,CAAC,QAAA,IAAY,OAAO,QAAA,CAAS,aAAa,UAAA,EAAY;AAC1D,IAAA,QAAA,CAAS,QAAA,CAAS,EAAE,GAAG,uBAAA,EAAyB,MAAM,CAAC,UAAU,GAAG,CAAA;AAAA,EACtE;AACF;AAGO,SAAS,qBAAA,GAAyC;AACvD,EAAA,OAAO,IAAI,eAAA,EAAgB;AAC7B","file":"index.mjs","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack\n * package (ADR-0048: one app per package).\n *\n * Studio is a console navigation-shell app (an `AppSchema`), not a kernel\n * extension — but it still needs a thin registration entry to publish its\n * manifest into the running kernel, mirroring how `@objectstack/plugin-auth`\n * registers its own manifest. Giving it a distinct package id\n * (`com.objectstack.studio`) is what lets `/apps/<packageId>` resolve to exactly\n * this app instead of being ambiguous inside a multi-app package.\n *\n * NOTE (transitional): the `STUDIO_APP` schema is still imported from\n * `@objectstack/platform-objects/apps`; a follow-up moves the definition into\n * this package and drops the dependency. This package is intentionally NOT yet\n * wired into the dev/serve plugin set — that boot-path switch (and removing the\n * app from plugin-auth's manifest) lands separately so it can be verified\n * against a live `os dev` boot.\n */\n\nimport { STUDIO_APP } from '@objectstack/platform-objects/apps';\n\nexport const STUDIO_APP_PACKAGE_ID = 'com.objectstack.studio';\nexport const STUDIO_APP_NAMESPACE = 'studio';\nexport const STUDIO_APP_VERSION = '9.3.0';\n\n/** Manifest header for the Studio app package. */\nexport const studioAppManifestHeader = {\n  id: STUDIO_APP_PACKAGE_ID,\n  namespace: STUDIO_APP_NAMESPACE,\n  version: STUDIO_APP_VERSION,\n  type: 'plugin' as const,\n  scope: 'system' as const,\n  name: 'Studio',\n  description: 'ObjectStack Studio — metadata builder app.',\n  // Studio navigates platform metadata owned by plugin-auth; declare the\n  // dependency so it loads after the auth objects are registered.\n  dependencies: ['com.objectstack.plugin-auth'],\n};\n\n/**\n * Thin plugin that registers the Studio app manifest. Structurally typed\n * against the kernel `Plugin` contract (no compile-time kernel dependency),\n * exactly like `AuthPlugin`.\n */\nexport class StudioAppPlugin {\n  readonly name = STUDIO_APP_PACKAGE_ID;\n  readonly type = 'standard';\n  readonly version = STUDIO_APP_VERSION;\n  // Kernel plugin dependency is matched by plugin NAME (AuthPlugin.name =\n  // 'com.objectstack.auth'), not by package id.\n  readonly dependencies: string[] = ['com.objectstack.auth'];\n\n  async init(_ctx: any): Promise<void> {\n    // No-op: registration happens in start() once the manifest service exists.\n  }\n\n  async start(ctx: any): Promise<void> {\n    const manifest = ctx?.getService?.('manifest');\n    if (!manifest || typeof manifest.register !== 'function') return;\n    manifest.register({ ...studioAppManifestHeader, apps: [STUDIO_APP] });\n  }\n}\n\n/** Convenience factory mirroring the rest of the plugin ecosystem. */\nexport function createStudioAppPlugin(): StudioAppPlugin {\n  return new StudioAppPlugin();\n}\n\nexport { STUDIO_APP };\n"]}
+{"version":3,"sources":["../src/studio-overview.doc.ts","../src/index.ts"],"names":[],"mappings":";;;;;;AAoBO,IAAM,mBAAA,GAA2B;AAAA,EACtC,IAAA,EAAM,iBAAA;AAAA,EACN,KAAA,EAAO,iBAAA;AAAA,EACP,WAAA,EAAa,yFAAA;AAAA,EACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,CAAA;AAAA,EAoCT,YAAA,EAAc;AAAA,IACZ,EAAA,EAAI;AAAA,MACF,KAAA,EAAO,qBAAA;AAAA,MACP,WAAA,EAAa,+JAAA;AAAA,MACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AA4BX;AAEJ;;;ACrEO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,oBAAA,GAAuB;AAC7B,IAAM,kBAAA,GAAqB;AAG3B,IAAM,uBAAA,GAA0B;AAAA,EACrC,EAAA,EAAI,qBAAA;AAAA,EACJ,SAAA,EAAW,oBAAA;AAAA,EACX,OAAA,EAAS,kBAAA;AAAA,EACT,IAAA,EAAM,QAAA;AAAA,EACN,KAAA,EAAO,QAAA;AAAA,EACP,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EAAa,iDAAA;AAAA;AAAA;AAAA,EAGb,YAAA,EAAc,CAAC,6BAA6B;AAC9C;AAOO,IAAM,kBAAN,MAAsB;AAAA,EAAtB,WAAA,GAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,qBAAA;AAChB,IAAA,IAAA,CAAS,IAAA,GAAO,UAAA;AAChB,IAAA,IAAA,CAAS,OAAA,GAAU,kBAAA;AAGnB;AAAA;AAAA,IAAA,IAAA,CAAS,YAAA,GAAyB,CAAC,sBAAsB,CAAA;AAAA,EAAA;AAAA,EAEzD,MAAM,KAAK,IAAA,EAA0B;AAAA,EAErC;AAAA,EAEA,MAAM,MAAM,GAAA,EAAyB;AACnC,IAAA,MAAM,QAAA,GAAW,GAAA,EAAK,UAAA,GAAa,UAAU,CAAA;AAC7C,IAAA,IAAI,CAAC,QAAA,IAAY,OAAO,QAAA,CAAS,aAAa,UAAA,EAAY;AAC1D,IAAA,QAAA,CAAS,QAAA,CAAS;AAAA,MAChB,GAAG,uBAAA;AAAA,MACH,IAAA,EAAM,CAAC,UAAU,CAAA;AAAA;AAAA,MAEjB,IAAA,EAAM,CAAC,mBAAmB;AAAA,KAC3B,CAAA;AAAA,EACH;AACF;AAGO,SAAS,qBAAA,GAAyC;AACvD,EAAA,OAAO,IAAI,eAAA,EAAgB;AAC7B","file":"index.mjs","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Doc } from '@objectstack/spec/system';\n\n/**\n * Studio app overview doc (ADR-0046), registered in this package's manifest so\n * it groups under \"Studio\" in the `/_console/docs` index.\n *\n * Authored inline rather than as a flat `src/docs/*.md` file because this is a\n * TS-first code package built by tsup, not a user app built by `os build` —\n * `defineStack({ docs })` / manifest `docs[]` is the supported path for those\n * (see `DocSchema` in `@objectstack/spec/system`). The `content` below is plain\n * CommonMark + GFM with no images/MDX, per ADR-0046 §3.4.\n *\n * Principle (from the HotCRM reference docs): document the *invisible*\n * business logic, not what the Studio UI already shows on screen.\n *\n * `translations` carries per-locale variants (ADR-0046 i18n); the REST layer\n * collapses the doc to the request's `Accept-Language` and serves one body.\n */\nexport const STUDIO_OVERVIEW_DOC: Doc = {\n  name: 'studio_overview',\n  label: 'Studio overview',\n  description: 'Orientation for builders: the metadata-first model, overlay precedence, and publishing.',\n  content: `# Studio overview\n\nStudio is the builder app — the workbench for shaping the platform's\n*metadata*: objects, fields, views, flows, agents, and the rest. Most of its\nscreens are self-explanatory; this page covers the one rule that is not visible\non screen but governs everything you do here. For the full reference, see\n<https://docs.objectstack.ai>.\n\n## Metadata-first\n\nIn Studio you do not edit a running database — you edit *definitions*. Every\nobject, field, and view is a metadata record, and the live application is\ngenerated from that metadata. This is why a change in Studio can reshape the UI\nand the API at once: you are changing the model, not patching a screen.\n\n## Edits are overlays (the invisible rule)\n\nYour changes do not mutate the metadata shipped by a package in place. Studio\nwrites an **overlay** on top of the base definition, and the runtime resolves\nthe two by precedence: an unpublished **draft** wins for you while you work, a\npublished **tenant overlay** wins over the package's baseline, and the package\nbaseline is the fallback (ADR-0005, ADR-0033). The practical consequence: the\nbase definition is never destroyed, so an overlay can always be reverted to\nrecover the original — and a field that \"won't change\" is usually being shadowed\nby a higher-precedence layer.\n\n## Publishing & deploying\n\nA draft is visible only to you until you **publish** it, which promotes the\noverlay so the rest of the tenant sees it. Moving changes between environments\n(for example dev → production) is a separate **deploy** step, not an automatic\nside effect of publishing — keeping the two distinct is what lets you build\nsafely in one environment before shipping.\n\nSee <https://docs.objectstack.ai> for drafts, overlays, and deployment in depth.\n`,\n  translations: {\n    zh: {\n      label: 'Studio 概览',\n      description: '搭建者入门:元数据优先模型、覆盖层优先级、发布与部署。',\n      content: `# Studio 概览\n\nStudio 是搭建者应用——塑造平台*元数据*的工作台:对象、字段、视图、流程、智能体等。\n它的大多数界面一目了然;本页讲的是那条界面上看不见、却支配你在这里一切操作的规则。\n完整参考见 <https://docs.objectstack.ai>。\n\n## 元数据优先\n\n在 Studio 里你编辑的不是运行中的数据库,而是*定义*。每个对象、字段、视图都是一条\n元数据记录,运行的应用由这些元数据生成。这就是为什么 Studio 里的一处改动能同时重塑\nUI 和 API:你改的是模型,而不是修补某个界面。\n\n## 编辑即覆盖层(看不见的规则)\n\n你的改动不会原地修改某个包发布的元数据。Studio 在基础定义之上写一层**覆盖层**,\n运行时按优先级解析两者:未发布的**草稿**在你编辑时对你生效,已发布的**租户覆盖层**\n优先于包的基线,包基线则是兜底(ADR-0005、ADR-0033)。实际后果:基础定义永不被\n销毁,所以覆盖层总能回退以恢复原样——而一个\"改不动\"的字段,通常是被更高优先级的\n层遮住了。\n\n## 发布与部署\n\n草稿只对你自己可见,直到你**发布**它,把覆盖层提升给整个租户看到。在环境之间搬运\n改动(例如开发 → 生产)是单独的**部署**步骤,不是发布的自动副作用——把两者分开,\n才能让你在一个环境里安全搭建、再上线。\n\n草稿、覆盖层与部署的细节见 <https://docs.objectstack.ai>。\n`,\n    },\n  },\n};\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack\n * package (ADR-0048: one app per package).\n *\n * Studio is a console navigation-shell app (an `AppSchema`), not a kernel\n * extension — but it still needs a thin registration entry to publish its\n * manifest into the running kernel, mirroring how `@objectstack/plugin-auth`\n * registers its own manifest. Giving it a distinct package id\n * (`com.objectstack.studio`) is what lets `/apps/<packageId>` resolve to exactly\n * this app instead of being ambiguous inside a multi-app package.\n *\n * NOTE (transitional): the `STUDIO_APP` schema is still imported from\n * `@objectstack/platform-objects/apps`; a follow-up moves the definition into\n * this package and drops the dependency. This package is intentionally NOT yet\n * wired into the dev/serve plugin set — that boot-path switch (and removing the\n * app from plugin-auth's manifest) lands separately so it can be verified\n * against a live `os dev` boot.\n */\n\nimport { STUDIO_APP } from '@objectstack/platform-objects/apps';\n\nimport { STUDIO_OVERVIEW_DOC } from './studio-overview.doc.js';\n\nexport const STUDIO_APP_PACKAGE_ID = 'com.objectstack.studio';\nexport const STUDIO_APP_NAMESPACE = 'studio';\nexport const STUDIO_APP_VERSION = '9.3.0';\n\n/** Manifest header for the Studio app package. */\nexport const studioAppManifestHeader = {\n  id: STUDIO_APP_PACKAGE_ID,\n  namespace: STUDIO_APP_NAMESPACE,\n  version: STUDIO_APP_VERSION,\n  type: 'plugin' as const,\n  scope: 'system' as const,\n  name: 'Studio',\n  description: 'ObjectStack Studio — metadata builder app.',\n  // Studio navigates platform metadata owned by plugin-auth; declare the\n  // dependency so it loads after the auth objects are registered.\n  dependencies: ['com.objectstack.plugin-auth'],\n};\n\n/**\n * Thin plugin that registers the Studio app manifest. Structurally typed\n * against the kernel `Plugin` contract (no compile-time kernel dependency),\n * exactly like `AuthPlugin`.\n */\nexport class StudioAppPlugin {\n  readonly name = STUDIO_APP_PACKAGE_ID;\n  readonly type = 'standard';\n  readonly version = STUDIO_APP_VERSION;\n  // Kernel plugin dependency is matched by plugin NAME (AuthPlugin.name =\n  // 'com.objectstack.auth'), not by package id.\n  readonly dependencies: string[] = ['com.objectstack.auth'];\n\n  async init(_ctx: any): Promise<void> {\n    // No-op: registration happens in start() once the manifest service exists.\n  }\n\n  async start(ctx: any): Promise<void> {\n    const manifest = ctx?.getService?.('manifest');\n    if (!manifest || typeof manifest.register !== 'function') return;\n    manifest.register({\n      ...studioAppManifestHeader,\n      apps: [STUDIO_APP],\n      // ADR-0046 package docs — grouped under \"Studio\" at /_console/docs.\n      docs: [STUDIO_OVERVIEW_DOC],\n    });\n  }\n}\n\n/** Convenience factory mirroring the rest of the plugin ecosystem. */\nexport function createStudioAppPlugin(): StudioAppPlugin {\n  return new StudioAppPlugin();\n}\n\nexport { STUDIO_APP };\nexport { STUDIO_OVERVIEW_DOC };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/studio",
-  "version": "9.4.0",
+  "version": "9.5.0",
   "license": "Apache-2.0",
   "description": "ObjectStack Studio — the metadata builder app, packaged as its own ObjectStack app package (ADR-0048: one app per package).",
   "main": "dist/index.js",
@@ -13,8 +13,8 @@
     }
   },
   "dependencies": {
-    "@objectstack/platform-objects": "9.4.0",
-    "@objectstack/spec": "9.4.0"
+    "@objectstack/platform-objects": "9.5.0",
+    "@objectstack/spec": "9.5.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",