ankhorage · artiphishle · Aug 6, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026
diff --git a/.changeset/neat-instance-properties.md b/.changeset/neat-instance-properties.md
@@ -0,0 +1,5 @@
+---
+'@ankhorage/studio': patch
+---
+
+Replace the raw Properties prop dump with a metadata-driven instance authoring model backed by the released ZORA authoring authority registry.
diff --git a/README.md b/README.md
@@ -3,7 +3,7 @@
 
 # @ankhorage/studio
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v0.11.4](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.11.11](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Standalone Studio authoring package for Ankhorage apps.
 
@@ -34,6 +34,7 @@ Manage Studio development and projects through the Ankh CLI.
 - [cloneWithNewIds sequence](././paradox/diagrams/sequences/clone-with-new-ids.mmd)
 - [createNodeFromCatalogEntry sequence](././paradox/diagrams/sequences/create-node-from-catalog-entry.mmd)
 - [findNodeById sequence](././paradox/diagrams/sequences/find-node-by-id.mmd)
+- [resolveStudioInstancePropertyGroups sequence](././paradox/diagrams/sequences/resolve-studio-instance-property-groups.mmd)
 - [updateNodeInTree sequence](././paradox/diagrams/sequences/update-node-in-tree.mmd)
 - [validateInsertRecipe sequence](././paradox/diagrams/sequences/validate-insert-recipe.mmd)
 - [validateNodePlacement sequence](././paradox/diagrams/sequences/validate-node-placement.mmd)

diff --git a/bun.lock b/bun.lock
diff --git a/docs/instance-properties.md b/docs/instance-properties.md
@@ -0,0 +1,32 @@
+# Metadata-driven instance Properties
+
+`/ankh/properties/{nodeId}` is the canonical per-node authoring surface.
+
+The page consumes the released ZORA component metadata registry at the concrete app/UI composition
+boundary. Package-neutral Studio helpers receive a structural metadata registry from their caller
+and never import or recreate concrete ZORA metadata.
+
+Only props classified with:
+
+```ts
+{
+  authoring: {
+    authority: 'instance';
+  }
+}
+```
+
+become fields. Theme-owned props and props without authoring metadata are intentionally absent.
+
+The initial editor set supports strings, numbers, booleans, and declared enum choices. Unsupported
+future authoring types remain explicit rather than falling back to arbitrary JSON or string editors.
+
+Node identity such as the node ID, component type, and optional alias remains read-only context. It
+is not treated as component prop metadata.
+
+Property changes update the selected node through the existing canonical manifest mutation and
+persistence flow. Studio does not create a second unsaved Properties model.
+
+This narrows the architectural gap between `apps/studio` and generated Ankhorage apps: both consume
+the same manifest nodes and package-owned component metadata, while Studio adds only the authoring
+interaction.
diff --git a/package.json b/package.json
@@ -140,6 +140,10 @@
       "types": "./dist/manifestState.d.ts",
       "import": "./dist/manifestState.js"
     },
+    "./propertiesAuthoringModel": {
+      "types": "./dist/propertiesAuthoringModel.d.ts",
+      "import": "./dist/propertiesAuthoringModel.js"
+    },
     "./manifestSync": {
       "types": "./dist/manifestSync.d.ts",
       "import": "./dist/manifestSync.js"
@@ -240,7 +244,7 @@
     "@ankhorage/supabase-auth": "^1.1.2",
     "@ankhorage/supabase-vault": "^0.2.4",
     "@ankhorage/templates": "^3.0.0",
-    "@ankhorage/zora": "^2.9.1",
+    "@ankhorage/zora": "^2.9.3",
     "@ankhorage/zora-chess": "^0.1.2",
     "@ankhorage/zora-tabletop": "^0.0.5",
     "@fastify/cors": "^11.2.0",

diff --git a/paradox/badges/npm.svg b/paradox/badges/npm.svg
diff --git a/paradox/diagrams/architecture-overview.mmd b/paradox/diagrams/architecture-overview.mmd
@@ -167,9 +167,20 @@ graph TD
   module_src_hooks_useWorkspaceActions_ts --> module_src_core_constants_ts
   module_src_host_auth_projectAuthHealthService_ts["src/host/auth/projectAuthHealthService.ts"]
   package__ankhorage_studio -.-> module_src_host_auth_projectAuthHealthService_ts
+  module_src_host_auth_projectAuthHealthService_ts --> module_src_host_auth_projectAuthRuntimeDiagnostics_ts
   module_src_host_auth_projectAuthHealthService_ts --> module_src_host_orchestrator_projectManager_ts
   module_src_host_auth_projectAuthHealthService_ts --> module_src_host_secrets_projectSecretService_ts
   module_src_host_auth_projectAuthHealthService_ts --> module_src_projectAuthHealth_ts
+  module_src_host_auth_projectAuthHealthService_ts --> module_src_projectAuthRuntimeDiagnostics_ts
+  module_src_host_auth_projectAuthRuntimeDiagnostics_test_ts["src/host/auth/projectAuthRuntimeDiagnostics.test.ts"]
+  package__ankhorage_studio -.-> module_src_host_auth_projectAuthRuntimeDiagnostics_test_ts
+  module_src_host_auth_projectAuthRuntimeDiagnostics_test_ts --> module_src_host_auth_projectAuthRuntimeDiagnostics_ts
+  module_src_host_auth_projectAuthRuntimeDiagnostics_ts["src/host/auth/projectAuthRuntimeDiagnostics.ts"]
+  package__ankhorage_studio -.-> module_src_host_auth_projectAuthRuntimeDiagnostics_ts
+  module_src_host_auth_projectAuthRuntimeDiagnostics_ts --> module_src_host_orchestrator_infraRuntime_ts
+  module_src_host_auth_projectAuthRuntimeDiagnostics_ts --> module_src_host_orchestrator_projectPaths_ts
+  module_src_host_auth_projectAuthRuntimeDiagnostics_ts --> module_src_projectAuthHealth_ts
+  module_src_host_auth_projectAuthRuntimeDiagnostics_ts --> module_src_projectAuthRuntimeDiagnostics_ts
   module_src_host_createStudioHost_ts["src/host/createStudioHost.ts"]
   package__ankhorage_studio -.-> module_src_host_createStudioHost_ts
   module_src_host_createStudioHost_ts --> module_src_host_orchestrator_infraRuntime_ts
@@ -187,6 +198,9 @@ graph TD
   module_src_host_generatedAuthAdapterRuntime_smoke_test_ts --> module_src_host_orchestrator_moduleManager_ts
   module_src_host_generatedAuthAdapterRuntime_smoke_test_ts --> module_src_host_orchestrator_projectManager_ts
   module_src_host_generatedAuthAdapterRuntime_smoke_test_ts --> module_src_host_templateRegistry_index_ts
+  module_src_host_generatedOAuthLifecycle_e2e_test_ts["src/host/generatedOAuthLifecycle.e2e.test.ts"]
+  package__ankhorage_studio -.-> module_src_host_generatedOAuthLifecycle_e2e_test_ts
+  module_src_host_generatedOAuthLifecycle_e2e_test_ts --> module_src_host_layout_templates_auth_oauth_ts
   module_src_host_hostLifecycle_smoke_test_ts["src/host/hostLifecycle.smoke.test.ts"]
   package__ankhorage_studio -.-> module_src_host_hostLifecycle_smoke_test_ts
   module_src_host_hostLifecycle_smoke_test_ts --> module_src_host_orchestrator_moduleManager_ts
@@ -273,10 +287,16 @@ graph TD
   module_src_host_layout_templates_auth_adapter_test_ts --> module_src_host_layout_templates_auth_adapter_ts
   module_src_host_layout_templates_auth_adapter_ts["src/host/layout/templates/auth/adapter.ts"]
   package__ankhorage_studio -.-> module_src_host_layout_templates_auth_adapter_ts
+  module_src_host_layout_templates_auth_callback_test_ts["src/host/layout/templates/auth/callback.test.ts"]
+  package__ankhorage_studio -.-> module_src_host_layout_templates_auth_callback_test_ts
+  module_src_host_layout_templates_auth_callback_test_ts --> module_src_host_layout_templates_auth_callback_ts
   module_src_host_layout_templates_auth_callback_ts["src/host/layout/templates/auth/callback.ts"]
   package__ankhorage_studio -.-> module_src_host_layout_templates_auth_callback_ts
   module_src_host_layout_templates_auth_callback_ts --> module_src_host_layout_templates_utils_routes_ts
   module_src_host_layout_templates_auth_callback_ts --> module_src_host_layout_utils_escapeStringLiteral_ts
+  module_src_host_layout_templates_auth_oauth_test_ts["src/host/layout/templates/auth/oauth.test.ts"]
+  package__ankhorage_studio -.-> module_src_host_layout_templates_auth_oauth_test_ts
+  module_src_host_layout_templates_auth_oauth_test_ts --> module_src_host_layout_templates_auth_oauth_ts
   module_src_host_layout_templates_auth_oauth_ts["src/host/layout/templates/auth/oauth.ts"]
   package__ankhorage_studio -.-> module_src_host_layout_templates_auth_oauth_ts
   module_src_host_layout_templates_auth_oauth_ts --> module_src_host_layout_auth_resolveAuthLayoutPlan_ts
@@ -579,6 +599,13 @@ graph TD
   module_src_projectAuthHealth_ts["src/projectAuthHealth.ts"]
   package__ankhorage_studio -.-> module_src_projectAuthHealth_ts
   module_src_projectAuthHealth_ts --> module_src_authSettings_ts
+  module_src_projectAuthRuntimeDiagnostics_test_ts["src/projectAuthRuntimeDiagnostics.test.ts"]
+  package__ankhorage_studio -.-> module_src_projectAuthRuntimeDiagnostics_test_ts
+  module_src_projectAuthRuntimeDiagnostics_test_ts --> module_src_projectAuthHealth_ts
+  module_src_projectAuthRuntimeDiagnostics_test_ts --> module_src_projectAuthRuntimeDiagnostics_ts
+  module_src_projectAuthRuntimeDiagnostics_ts["src/projectAuthRuntimeDiagnostics.ts"]
+  package__ankhorage_studio -.-> module_src_projectAuthRuntimeDiagnostics_ts
+  module_src_projectAuthRuntimeDiagnostics_ts --> module_src_projectAuthHealth_ts
   module_src_projectIdentity_test_ts["src/projectIdentity.test.ts"]
   package__ankhorage_studio -.-> module_src_projectIdentity_test_ts
   module_src_projectIdentity_test_ts --> module_src_projectIdentity_ts
@@ -600,6 +627,11 @@ graph TD
   package__ankhorage_studio -.-> module_src_projectSecretUsage_ts
   module_src_projectWorkspaceContracts_ts["src/projectWorkspaceContracts.ts"]
   package__ankhorage_studio -.-> module_src_projectWorkspaceContracts_ts
+  module_src_propertiesAuthoringModel_test_ts["src/propertiesAuthoringModel.test.ts"]
+  package__ankhorage_studio -.-> module_src_propertiesAuthoringModel_test_ts
+  module_src_propertiesAuthoringModel_test_ts --> module_src_index_ts
+  module_src_propertiesAuthoringModel_ts["src/propertiesAuthoringModel.ts"]
+  package__ankhorage_studio -.-> module_src_propertiesAuthoringModel_ts
   module_src_root_test_ts["src/root.test.ts"]
   package__ankhorage_studio -.-> module_src_root_test_ts
   module_src_root_ts["src/root.ts"]
@@ -708,6 +740,11 @@ graph TD
   module_src_studioAdminRouteModel_ts["src/studioAdminRouteModel.ts"]
   package__ankhorage_studio -.-> module_src_studioAdminRouteModel_ts
   module_src_studioAdminRouteModel_ts --> module_src_index_ts
+  module_src_studioRuntimeApi_test_ts["src/studioRuntimeApi.test.ts"]
+  package__ankhorage_studio -.-> module_src_studioRuntimeApi_test_ts
+  module_src_studioRuntimeApi_test_ts --> module_src_studioRuntimeApi_ts
+  module_src_studioRuntimeApi_ts["src/studioRuntimeApi.ts"]
+  package__ankhorage_studio -.-> module_src_studioRuntimeApi_ts
   module_src_studioSelectionModel_knip_test_ts["src/studioSelectionModel.knip.test.ts"]
   package__ankhorage_studio -.-> module_src_studioSelectionModel_knip_test_ts
   module_src_studioSelectionModel_knip_test_ts --> module_src_studioSelectionModel_ts
@@ -800,6 +837,7 @@ graph TD
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_projectAuthApi_ts
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_projectAuthHealth_ts
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_projectSecretApi_ts
+  module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_studioRuntimeApi_ts
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_ui_admin_AuthAdminSession_tsx
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_ui_admin_pages_adminAuthCredentialFlow_ts
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_ui_admin_pages_adminAuthHealthFlow_ts
@@ -814,8 +852,8 @@ graph TD
   package__ankhorage_studio -.-> module_src_ui_admin_pages_PropertiesAdminPage_tsx
   module_src_ui_admin_pages_PropertiesAdminPage_tsx --> module_src_core_StudioContext_ts
   module_src_ui_admin_pages_PropertiesAdminPage_tsx --> module_src_manifestState_ts
+  module_src_ui_admin_pages_PropertiesAdminPage_tsx --> module_src_propertiesAuthoringModel_ts
   module_src_ui_admin_pages_PropertiesAdminPage_tsx --> module_src_ui_admin_adminPagePrimitives_tsx
-  module_src_ui_admin_pages_PropertiesAdminPage_tsx --> module_src_ui_admin_adminPageUtils_ts
   module_src_ui_admin_pages_SecretsAdminPage_test_ts["src/ui/admin/pages/SecretsAdminPage.test.ts"]
   package__ankhorage_studio -.-> module_src_ui_admin_pages_SecretsAdminPage_test_ts
   module_src_ui_admin_pages_SecretsAdminPage_tsx["src/ui/admin/pages/SecretsAdminPage.tsx"]