@unoverse-platform/studio 0.1.96 → 0.1.97

package/bin/studio.mjs

@@ -14,7 +14,7 @@
  * to avoid. So the tool starts the same dev server `npm run dev` does.
  *
  * No database, no Redis, no engine, no Docker, and no account: those belong to running a
- * universe, which is a different job. See docs/architecture/LOCAL_STUDIO.md.
+ * universe, which is a different job. See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { createServer } from "vite";
 import { dirname, resolve, join, basename } from "path";

package/local/authoring.ts

@@ -16,7 +16,7 @@
  * completion list is not a hint, it is the whole legal set, and it knows the developer's
  * real tokens in a way a JSON Schema in a text editor cannot.
  *
- * See docs/architecture/LOCAL_STUDIO.md §Authoring in Studio.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md §Authoring in Studio.
  */
 import { designHome } from "./design-home.mjs";
 import { resolve } from "path";

package/local/catalog.ts

@@ -8,7 +8,7 @@
  * the exact problem this migration exists to fix). It imports the SAME modules and sets
  * RX_PATH to the developer's folder before they load.
  *
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { hasDesignHome } from "./design-home.mjs";
 import { resolve } from "path";
@@ -24,6 +24,8 @@ type Loaders = {
   inputPropKeys: (props: unknown) => string[];
   themeOrgs: () => string[];
   listThemeNames: (org: string) => string[];
+  /** The identity documents of one org or every org: `<org>/<doc>` items with manifest and briefed props. */
+  listIdentity: (org?: string) => unknown[];
   resolveTheme: (name: string) => unknown;
   DEFAULT_ORG: string;
   /** A project's on-disk home. The writable set is built from these (see source.ts). */
@@ -94,6 +96,8 @@ export async function loadCatalog(
   const defs = await load(resolve(baseSrc, "definitions/definitions.ts"));
   const theme = await load(resolve(baseSrc, "definitions/theme.ts"));
   const inputs = await load(resolve(baseSrc, "definitions/inputs.ts"));
+  const homes = await load(resolve(baseSrc, "definitions/registry/homes.ts"));
+  const identity = await load(resolve(baseSrc, "definitions/registry/orgDocuments.ts"));
 
   return {
     listDefinitions: defs.listDefinitions as Loaders["listDefinitions"],
@@ -104,6 +108,18 @@ export async function loadCatalog(
     inputPropKeys: inputs.inputPropKeys as Loaders["inputPropKeys"],
     themeOrgs: theme.themeOrgs as Loaders["themeOrgs"],
     listThemeNames: theme.listThemeNames as Loaders["listThemeNames"],
+    listIdentity: ((org?: string) => {
+      const orgs: string[] = org && org !== "all" ? [org] : (homes.listOrgs as () => string[])();
+      const out: unknown[] = [];
+      for (const o of orgs) {
+        const root = (homes.projectDir as (n: string) => string)(o);
+        for (const doc of identity.ORG_DOCUMENTS as readonly string[]) {
+          const read = (identity.readOrgDocument as (r: string, d: string) => { manifest: unknown; props: unknown; path: string } | null)(root, doc);
+          if (read) out.push({ name: `${o}/${doc}`, org: o, doc, manifest: read.manifest, props: read.props, path: read.path });
+        }
+      }
+      return out;
+    }) as Loaders["listIdentity"],
     resolveTheme: theme.resolveTheme as Loaders["resolveTheme"],
     DEFAULT_ORG: theme.DEFAULT_ORG as string,
     projectDir: defs.projectDir as Loaders["projectDir"],

package/local/keys.ts

@@ -13,7 +13,7 @@
  * snake-cased, so `airtableCredential.personalAccessToken` reads from
  * `AIRTABLE_PERSONAL_ACCESS_TOKEN`.
  *
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { resolve } from "path";
 import { existsSync, readFileSync } from "fs";

package/local/nodes.ts

@@ -14,7 +14,7 @@
  * The bootstrap comment is explicit that this path touches neither Redis nor the
  * workflow service, which is what makes it usable with no backend.
  *
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { resolve } from "path";
 import { existsSync } from "fs";

package/local/plugin.ts

@@ -8,12 +8,12 @@
  *
  * Routes mirror the server's shapes exactly, because the screens parse those shapes:
  *   GET /dev/orgs        GET /dev/themes?org=      GET /dev/components?org=
- *   GET /dev/apps?org=   GET /dev/atoms
+ *   GET /dev/apps?org=   GET /dev/atoms         GET /dev/identity?org=
  *   GET /local/theme?ref=     GET /local/definition?uri=
  *   GET /skills  /skills/:name   GET /prompt-blocks
  *   GET|POST /registry/state  (no database locally, see below)
  *
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { designHome } from "./design-home.mjs";
 import { createRequire } from "node:module";
@@ -360,6 +360,10 @@ export function localStudioHost(): Plugin {
             case path === "/dev/apps":
               return json(res, { apps: c.listAppsForWorkbench(org) });
 
+            // The org's identity documents (design/<org>/identity/<doc>/), one org or all.
+            case path === "/dev/identity":
+              return json(res, { items: c.listIdentity(org) });
+
             case path === "/dev/atoms":
               return json(res, { atoms: c.listDefinitions("atom") });
 

package/local/sample-identity/brand/brand.yaml

@@ -0,0 +1,88 @@
+unoverse: "1.0"
+# THE BRAND, declared the way a component declares its props: each description is the brief
+# the writer follows; the defaults are this org's own words, as they stand.
+type: identity
+name: brand
+category: Identity
+props:
+  name:
+    type: string
+    input: true
+    description: >-
+      The brand name as the enterprise presents it, which may differ from its trading name
+      (a bank's card brand, a group's consumer brand). The site's logo text or title, not
+      the legal entity.
+    maxLength: 80
+    default: ""
+  standsFor:
+    type: string
+    input: true
+    description: >-
+      What the name stands for, in one sentence, in the enterprise's own words where it says
+      so (a tagline, a strapline, the meaning of the name, a 'who we are' line). Empty when
+      it does not say.
+    maxLength: 300
+    default: ""
+  promise:
+    type: string
+    input: true
+    description: >-
+      The expectation the brand sets: what people can expect from it, in one or two
+      sentences, drawn from the promises the site repeats on its home, about and brand
+      pages. Written to the customer.
+    maxLength: 400
+    default: ""
+  represents:
+    type: string
+    input: true
+    description: >-
+      How the brand carries the purpose (read purpose.yaml first): in one paragraph, how the
+      name, the promise and the way it presents itself express why the enterprise exists. In
+      the enterprise's own words where it connects the two; empty when it does not.
+    maxLength: 500
+    default: ""
+  audience:
+    type: string
+    input: true
+    description: >-
+      Whom the brand speaks to and how it wants to be seen by them, in one or two sentences,
+      from the way the site addresses its customers and describes its position. Never
+      invented segments.
+    maxLength: 400
+    default: ""
+  differentiators:
+    type: array
+    input: true
+    description: >-
+      What the enterprise claims sets its brand apart, three to six items, each in its own
+      words (a first, a leadership claim, a partnership, a heritage). Only claims it makes
+      itself.
+    maxItems: 6
+    default: []
+  brands:
+    type: array
+    input: true
+    description: >-
+      The brand tree: the sub-brands and product brands the enterprise presents under this
+      brand (a card family, an app, a loyalty programme, a subsidiary), one entry per brand
+      with its name as written and one sentence on what it is for, nested in `brands` where
+      the enterprise nests them. Empty when it presents none; never invented.
+    maxItems: 20
+    default: []
+  rules:
+    type: array
+    input: true
+    description: >-
+      Three to six rules the site's copy visibly follows, each as 'Do this' or 'Never that':
+      the person it addresses (you, we), its register (plain, formal, warm), sentence
+      length, what it capitalises, what it never says.
+    maxItems: 6
+    default: []
+  examples:
+    type: array
+    input: true
+    description: >-
+      Three to five sentences copied verbatim from the site that show the voice. Quotes,
+      never paraphrase.
+    maxItems: 5
+    default: []

package/local/sample-identity/brand/manifest.yaml

@@ -0,0 +1,13 @@
+# The Brand (docs/edgy/elements/brand.md): our name and what it stands for. The written half;
+# styles/ is the visual half. Published, it is one row on the org's map, found by meaning.
+title: Brand
+description: >-
+  The name and what it stands for: the promise it makes, whom it speaks to, what sets it
+  apart, the brands inside it, and how it sounds.
+whenToUse: >-
+  Answer what the brand stands for, what to expect from it, whom it is for and what sets it
+  apart; name the brands inside it; and give any writing its voice, the rules it follows and
+  sentences in its own words. Not for what the organisation is or does, that is the
+  Organisation, and not for why it exists, that is the Purpose.
+category: Identity
+version: 1.0.0

package/local/sample-identity/organisation/manifest.yaml

@@ -0,0 +1,15 @@
+# The Organisation (docs/edgy/elements/organisation.md): the one that owns this spatial. This
+# manifest says what the document is for; organisation.yaml is the document. It never sits
+# on the map: it is the scope on every row and the grounding every extraction and every
+# agent wakes with.
+title: Organisation
+description: >-
+  Who this organisation is and what it does, in its own words, and the words it uses for its
+  products, its customers and itself.
+whenToUse: >-
+  Ground any extraction, any agent or any piece of writing in who the organisation is and
+  how it speaks. Read whole at wake, never searched for. Not for what it offers, that is the
+  products on the map, and not for why it exists or where it came from, those are Purpose
+  and Story.
+category: Identity
+version: 1.0.0

package/local/sample-identity/organisation/organisation.yaml

@@ -0,0 +1,53 @@
+unoverse: "1.0"
+# THE ORGANISATION, declared the way a component declares its props. Each prop's description
+# is the brief: direction to the writer that fills it, including what not to do. The
+# platform compiles briefs into a tool schema, so an Agent fills this from research the way
+# a copywriter fills an email, and a person reads the same words as guidance. The defaults
+# are this org's own words, as they stand.
+type: identity
+name: organisation
+category: Identity
+props:
+  name:
+    type: string
+    input: true
+    description: >-
+      The org's name as it trades, exactly as its website writes it in its own header or
+      footer. Never a legal suffix unless the site uses one.
+    maxLength: 80
+    default: ""
+  what:
+    type: string
+    input: true
+    description: >-
+      One paragraph, 60 to 120 words, in the third person: what the business is, what it
+      does, whom it serves, where. Taken from the site's own about, home and footer copy.
+      This paragraph grounds every extraction, so it must name the business's actual lines
+      of work, not adjectives. Never a slogan, never an industry generality.
+    maxLength: 900
+    default: ""
+  units:
+    type: array
+    input: true
+    description: >-
+      The organisation map: every unit the organisation names in its own publications, the
+      ones that face customers (divisions, lines of business, regions) and the ones that run
+      the organisation (operations, technology, people and HR, finance, risk, legal,
+      marketing, and the rest). Sources: the about and careers pages, the annual report's
+      organisation or leadership section, a published org chart. One entry per unit with its
+      name as the organisation writes it and one sentence on what it does or serves, nested
+      in `units` where the organisation nests them. Empty when the sources name none; never
+      invented.
+    maxItems: 40
+    default: []
+  vocabulary:
+    type: string
+    input: true
+    description: >-
+      The words the business uses, as one paragraph separated by semicolons: its product and
+      service names as it spells them, its programme and membership names, the terms it uses
+      for its customers, and anything it capitalises. Every name is copied from the site,
+      never paraphrased. This is the domain prompt every extraction reads, so completeness
+      beats elegance.
+    maxLength: 2000
+    default: ""

package/local/sample-identity/purpose/manifest.yaml

@@ -0,0 +1,12 @@
+# The Purpose (docs/edgy/elements/purpose.md): why the enterprise exists and the goals it pursues.
+# Published, it is one row on the org's map, found by meaning.
+title: Purpose
+description: >-
+  Why the organisation exists: what its people believe in, what it aims to achieve, and the
+  goals it is working toward.
+whenToUse: >-
+  Answer why the organisation exists, what its people believe in, what it aims to achieve
+  and the goals it is working toward. Read before the Brand, which represents it. Not for
+  its history or its scale, that is the Story, and not for its products.
+category: Identity
+version: 1.0.0

package/local/sample-identity/purpose/purpose.yaml

@@ -0,0 +1,46 @@
+unoverse: "1.0"
+# THE PURPOSE, declared the way a component declares its props: each description is the brief
+# the writer follows; the defaults are this org's own words, as they stand.
+type: identity
+name: purpose
+category: Identity
+props:
+  statement:
+    type: string
+    input: true
+    description: >-
+      Why the enterprise exists, in its own words: the purpose or mission statement it
+      publishes, quoted where one exists. When it publishes none, one sentence composed only
+      from what its about page says it is for. Never a marketing slogan.
+    maxLength: 400
+    default: ""
+  values:
+    type: array
+    input: true
+    description: >-
+      What the people of the enterprise believe in and consider valuable: the values it
+      publishes, each with its name as the enterprise writes it and the one sentence it
+      gives for it. From the values, culture or about pages. Empty when none are published;
+      never invented.
+    maxItems: 8
+    default: []
+  ambition:
+    type: string
+    input: true
+    description: >-
+      The far end of the purpose: what the enterprise says it aims to achieve for its
+      customers, its country or society, in one paragraph, quoted where a vision or ambition
+      statement exists, with the horizon it names. Not the goals below; the outcome they
+      serve.
+    maxLength: 700
+    default: ""
+  goals:
+    type: array
+    input: true
+    description: >-
+      The goal tree: the strategic goals, pillars or commitments the enterprise names (a
+      strategy page, a strategy section of the annual report, 'our commitments'). One entry
+      per goal with its name as the enterprise writes it and one sentence on why, nested in
+      `goals` where it nests them. Empty when none are named; never invented.
+    maxItems: 12
+    default: []

package/local/sample-identity/story/manifest.yaml

@@ -0,0 +1,12 @@
+# The Story (docs/edgy/elements/story.md): the way the enterprise makes sense of itself.
+# History, present, vision. Published, it is one row on the org's map, found by meaning.
+title: Story
+description: >-
+  Where the organisation came from, what it is now and where it is going, and what that
+  story says it is for.
+whenToUse: >-
+  Answer when and how the organisation began, its milestones, what it is today (its scale,
+  its lines of business), where it says it is going, and whom its story is about. Read with
+  the Purpose, which it puts in context. Not for why it exists, that is the Purpose.
+category: Identity
+version: 1.0.0

package/local/sample-identity/story/story.yaml

@@ -0,0 +1,63 @@
+unoverse: "1.0"
+# THE STORY, declared the way a component declares its props: each description is the brief
+# the writer follows; the defaults are this org's own words, as they stand.
+type: identity
+name: story
+category: Identity
+props:
+  history:
+    type: string
+    input: true
+    description: >-
+      Where the enterprise came from, one paragraph of 60 to 120 words: founding year and
+      place, the names it has carried, the mergers and milestones its about or history page
+      states, in order. Only dated facts it gives; empty when it gives none.
+    maxLength: 900
+    default: ""
+  milestones:
+    type: array
+    input: true
+    description: >-
+      The story's beats, in order: one entry per dated event the enterprise itself records
+      (a founding, a merger, a name, a first, a listing), with the year as its name and one
+      sentence on what happened and why it mattered. From its history page, its timeline or
+      its annual report. Empty when it records none; never invented.
+    maxItems: 20
+    default: []
+  present:
+    type: string
+    input: true
+    description: >-
+      What the enterprise is now, one paragraph of 60 to 120 words: its scale as it states
+      it (customers, branches, countries, staff, assets), its main lines of business, its
+      position in its market in its own words, with the date those figures carry.
+    maxLength: 900
+    default: ""
+  vision:
+    type: string
+    input: true
+    description: >-
+      Where the enterprise is going, one paragraph: the vision, strategy or ambition it
+      publishes, quoted where a vision statement exists, with the horizon it names (a year,
+      a plan). Empty when it says nothing about the future.
+    maxLength: 900
+    default: ""
+  people:
+    type: string
+    input: true
+    description: >-
+      Whom the story is about and for: the people the enterprise names as the protagonists
+      of its story and the ones it tells it to (customers, employees, partners, a country, a
+      community), in its own words. Empty when it names none.
+    maxLength: 400
+    default: ""
+  meaning:
+    type: string
+    input: true
+    description: >-
+      What the story says the enterprise is for: one paragraph on how the history, the
+      present and the vision explain why it does what it does, connecting them to the
+      purpose (read purpose.yaml first). In the enterprise's own words where it makes the
+      connection; empty when it does not.
+    maxLength: 500
+    default: ""

package/local/scaffold.mjs

@@ -11,7 +11,7 @@
  * alike and disagree about what a starting component contains. So this file is plain ESM
  * rather than TypeScript, because the CLI runs unbuilt and cannot transpile.
  *
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { existsSync, mkdirSync, writeFileSync, cpSync, readdirSync, readFileSync } from "node:fs";
 import { designHome } from "./design-home.mjs";
@@ -61,7 +61,7 @@ const WELCOME = [
 ].join("\n");
 
 /**
- * Create `design/<name>/` under `home`, with its three authoring folders and one component.
+ * Create `design/<name>/` under `home`, with its authoring folders, one component and the identity.
  *
  * Refuses an existing name rather than merging into it: "create" that silently adopts a
  * folder is how a developer ends up publishing someone else's work under their own project.
@@ -77,7 +77,7 @@ export function createProject(home, name) {
   // beside components/apps/styles so a skill is org-scoped exactly like a component —
   // two orgs may each ship an `hr-education-coach` without colliding on one flat name
   // (items/collect.ts qualifies a skill's row `<org>/<name>`).
-  for (const d of ["components/welcome", "apps", "styles", "skills", "blocks"]) mkdirSync(join(root, d), { recursive: true });
+  for (const d of ["components/welcome", "apps", "styles", "skills", "blocks", "identity"]) mkdirSync(join(root, d), { recursive: true });
   writeFileSync(join(root, "components/welcome/welcome.yaml"), WELCOME);
 
   // Worked example styles (sample-styles: brand ingredients + the override rules), so
@@ -90,6 +90,15 @@ export function createProject(home, name) {
     cpSync(sampleStyles, join(root, "styles"), { recursive: true });
   }
 
+  // THE IDENTITY (sample-identity: organisation, brand, purpose, story), four definitions
+  // with their briefs written and their defaults empty, so the org's own words have a
+  // place to land from day one. Mirrors @unoverse-platform/base identitySeed.ts file for
+  // file (a guard test holds them equal). Same rule: copied only into an empty folder.
+  const sampleIdentity = join(dirname(fileURLToPath(import.meta.url)), "sample-identity");
+  if (existsSync(sampleIdentity) && readdirSync(join(root, "identity")).length === 0) {
+    cpSync(sampleIdentity, join(root, "identity"), { recursive: true });
+  }
+
   // A worked example APP (a generic chat: focus overlay + the chat region),
   // so apps/ is never an empty folder and the first app is a rename away. Same
   // rule as the styles: copied only into an empty folder, then the developer's.

package/local/source.ts

@@ -20,7 +20,7 @@
  * Everything else is readable and not writable, the marketplace and anything resolved out
  * of node_modules included.
  *
- * See docs/architecture/LOCAL_STUDIO.md §Authoring in Studio.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md §Authoring in Studio.
  */
 import { designHome } from "./design-home.mjs";
 import { resolve, sep, relative } from "path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unoverse-platform/studio",
-  "version": "0.1.96",
+  "version": "0.1.97",
   "type": "module",
   "description": "Unoverse Studio: the local authoring app. Reads your own rx/ folder, no backend.",
   "scripts": {

package/screens/IdentityHeader.tsx

@@ -75,7 +75,7 @@ export function IdentityHeader({
         {id && <div className="mt-0.5 font-mono text-[11px] text-gray-400">{id}</div>}
         {description && <p className="mt-1 max-w-3xl text-sm leading-relaxed text-gray-600">{description}</p>}
         {whenToUse && (
-          <div className="mt-2 max-w-3xl rounded-r py-1.5 pl-3" style={{ borderLeft: `3px solid ${accent}`, background: "#f3f4f6" }}>
+          <div className="mt-2 max-w-3xl rounded-lg px-3 py-2" style={{ background: "#f3f4f6" }}>
             <div className="mb-0.5 text-[10px] font-semibold uppercase tracking-wider" style={{ color: accent }}>
               When to use
             </div>

package/screens/IdentityView.tsx

@@ -0,0 +1,206 @@
+/**
+ * Identity view — the org's four documents (organisation, brand, purpose, story) as the
+ * pack holds them: design/<org>/identity/<doc>/. Left: a navigator, one group per org
+ * (or the one org this Studio is bound to). Right: the selected document's manifest words,
+ * then each prop with its brief and its default, the org's own words.
+ *
+ * READ-ONLY, like Skills: the documents are authored in the pack (the create skill fills
+ * them from the org's own sources) and published with it. The one control is the same
+ * master switch every other kind has: Available puts a document in the spatial catalogue,
+ * and each canvas installs it from there. The Organisation's switch is the grounding: on,
+ * every run as this org wakes with it; it never sits on the map
+ * (docs/edgy/elements/organisation.md).
+ *
+ * Shared by both Studios (packages/studio/screens); the host supplies fetch + toggles.
+ */
+import { useEffect, useMemo, useState } from "react";
+import { fetchUnoverse } from "studio-host";
+import { usePersistentState, useRegistryToggles, ToggleSwitch } from "studio-host";
+import { IdentityHeader } from "./IdentityHeader";
+import { DOC, EMPTY, NAV, NAV_SECTION, PANE, SCREEN, navItem } from "./chrome";
+import { EmptyLibrary } from "./EmptyLibrary";
+
+interface IdentityProp {
+  name: string;
+  type: string;
+  description: string;
+  maxLength?: number;
+  maxItems?: number;
+  default: unknown;
+}
+
+interface IdentityItem {
+  /** The registry name, `<org>/<doc>`: the same word every other surface addresses it by. */
+  name: string;
+  org: string;
+  doc: "organisation" | "brand" | "purpose" | "story";
+  manifest: { title?: string; description?: string; whenToUse?: string; category?: string; version?: string };
+  props: IdentityProp[];
+  path: string;
+}
+
+const ORDER = ["organisation", "brand", "purpose", "story"] as const;
+const isEmpty = (v: unknown): boolean => v == null || (typeof v === "string" && !v.trim()) || (Array.isArray(v) && v.length === 0);
+
+function Value({ value }: { value: unknown }) {
+  if (isEmpty(value)) return <div className="rounded-lg border border-dashed border-gray-200 px-4 py-3 text-[13px] italic text-gray-400">Not written yet.</div>;
+  if (typeof value === "string") return <p className="whitespace-pre-wrap text-[15px] leading-7 text-gray-900">{value}</p>;
+  if (Array.isArray(value)) return <Tree items={value} />;
+  return <pre className="rounded-lg bg-gray-50 p-3 text-xs text-gray-700">{JSON.stringify(value, null, 2)}</pre>;
+}
+
+function Tree({ items, depth = 0 }: { items: unknown[]; depth?: number }) {
+  if (items.every((it) => typeof it === "string")) {
+    return (
+      <ul className="space-y-2">
+        {items.map((it, i) => (
+          <li key={i} className="flex gap-3 text-[15px] leading-7 text-gray-900">
+            <span className="mt-[11px] h-1.5 w-1.5 shrink-0 rounded-full bg-gray-300" />
+            <span>{String(it)}</span>
+          </li>
+        ))}
+      </ul>
+    );
+  }
+  return (
+    <div className={depth ? "ml-5 mt-2" : "divide-y divide-gray-100 rounded-xl border border-gray-200"}>
+      {items.map((it, i) => {
+        const o = (it ?? {}) as Record<string, unknown>;
+        const kids = (o.units ?? o.goals ?? o.brands) as unknown[] | undefined;
+        const sentence = (o.what ?? o.why) as string | undefined;
+        return (
+          <div key={i} className={depth ? "py-2" : "px-4 py-3"}>
+            <div className="text-[14px] font-semibold text-gray-900">{String(o.name ?? "")}</div>
+            {sentence ? <div className="mt-0.5 text-[13.5px] leading-6 text-gray-600">{sentence}</div> : null}
+            {Array.isArray(kids) && kids.length > 0 ? <Tree items={kids} depth={depth + 1} /> : null}
+          </div>
+        );
+      })}
+    </div>
+  );
+}
+
+/** One prop: its name, the value set as reading text, and the brief behind a small toggle. */
+function Field({ prop }: { prop: IdentityProp }) {
+  const [brief, setBrief] = useState(false);
+  const limit = prop.maxItems ? `up to ${prop.maxItems}` : prop.maxLength ? `up to ${prop.maxLength} characters` : "";
+  return (
+    <section className="py-6 first:pt-0 last:pb-0">
+      <div className="mb-2 flex items-baseline justify-between gap-4">
+        <h3 className="text-[11px] font-semibold uppercase tracking-[0.12em] text-gray-500">{prop.name}</h3>
+        {prop.description ? (
+          <button type="button" onClick={() => setBrief((b) => !b)} className={`text-[11px] font-medium transition ${brief ? "text-indigo-600" : "text-gray-400 hover:text-gray-600"}`}>
+            {brief ? "Hide the brief" : "Brief"}
+          </button>
+        ) : null}
+      </div>
+      {brief && prop.description ? (
+        <div className="mb-3 rounded-lg border border-indigo-100 bg-indigo-50/60 px-4 py-3 text-[12.5px] leading-relaxed text-indigo-900">
+          {prop.description}
+          {limit ? <div className="mt-1.5 text-[11px] text-indigo-500">{limit}</div> : null}
+        </div>
+      ) : null}
+      <Value value={prop.default} />
+    </section>
+  );
+}
+
+export function IdentityView({ org = "all" }: { org?: string } = {}) {
+  const [items, setItems] = useState<IdentityItem[]>([]);
+  const [error, setError] = useState<string | null>(null);
+  const [selected, setSelected] = usePersistentState<string | null>("wb:identity:selected", null);
+  const available = useRegistryToggles("identity");
+
+  useEffect(() => {
+    fetchUnoverse(`/dev/identity${org !== "all" ? `?org=${encodeURIComponent(org)}` : ""}`)
+      .then((r) => (r.ok ? r.json() : Promise.reject(new Error(`HTTP ${r.status}`))))
+      .then((d) => {
+        const list: IdentityItem[] = d.items ?? [];
+        setItems(list);
+        const restore = list.find((i) => i.name === selected) ?? list[0];
+        setSelected(restore ? restore.name : null);
+      })
+      .catch((e) => setError(String(e?.message ?? e)));
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [org]);
+
+  const byOrg = useMemo(
+    () =>
+      Object.entries(
+        items.reduce<Record<string, IdentityItem[]>>((acc, i) => {
+          (acc[i.org] ??= []).push(i);
+          return acc;
+        }, {}),
+      )
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([o, docs]) => [o, [...docs].sort((a, b) => ORDER.indexOf(a.doc) - ORDER.indexOf(b.doc))] as const),
+    [items],
+  );
+  const current = items.find((i) => i.name === selected) ?? null;
+
+  if (items.length === 0) {
+    return (
+      <div className={SCREEN}>
+        <nav className={NAV} />
+        <EmptyLibrary
+          noun="identity documents"
+          org={org}
+          folder="identity"
+          shape="identity/ holds four definitions: organisation, brand, purpose and story, each a manifest and a document whose props carry the brief and the org's own words."
+          error={error}
+        />
+      </div>
+    );
+  }
+
+  return (
+    <div className={SCREEN}>
+      <nav className={NAV}>
+        {byOrg.map(([o, docs]) => (
+          <div key={o} className="mb-3">
+            <div className={NAV_SECTION}>{o}</div>
+            {docs.map((d) => (
+              <button key={d.name} onClick={() => setSelected(d.name)} className={`block w-full rounded px-2 py-1.5 text-left transition ${navItem(selected === d.name)}`}>
+                <div className="text-sm font-medium">{d.manifest.title ?? d.doc}</div>
+                <div className="truncate text-[11px] text-gray-500">{d.manifest.description}</div>
+              </button>
+            ))}
+          </div>
+        ))}
+      </nav>
+
+      <div className={PANE}>
+        {!current ? (
+          <div className={EMPTY}>Select a document</div>
+        ) : (
+          <div className={DOC}>
+            <IdentityHeader
+              name={current.name}
+              category={current.manifest.category}
+              version={current.manifest.version}
+              id={`design/${current.org}/${current.path}`}
+              description={current.manifest.description}
+              whenToUse={current.manifest.whenToUse}
+              right={<ToggleSwitch on={available.isEnabled(current.name)} onClick={() => available.toggle(current.name)} label={current.doc === "organisation" ? "Grounding" : "Available"} />}
+            />
+            <p className="mb-6 text-[12px] leading-relaxed text-gray-500">
+              {current.doc === "organisation"
+                ? "Grounding on means every extraction and every Agent that runs as this org reads this document whole: its what and its vocabulary. Off, the org grounds on nothing."
+                : "Available puts this document in the spatial catalogue. Which maps carry it is chosen per canvas, in Canvas’s Content Library."}
+              {" "}Written in the pack; the create skill fills it from the org’s own sources.
+            </p>
+            <p className="mb-6 text-[11px] text-gray-500">
+              Reference in a prompt as <span className="font-mono text-gray-600">{`{{identity.${current.doc}}}`}</span> for the whole document
+              {current.props[0] ? <>, or one field as <span className="font-mono text-gray-600">{`{{identity.${current.doc}.${current.props[0].name}}}`}</span></> : null}.
+              Every document at once is <span className="font-mono text-gray-600">{"{{identity}}"}</span>.
+            </p>
+
+            <div className="divide-y divide-gray-100">
+              {current.props.map((p) => <Field key={p.name} prop={p} />)}
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}

package/screens/SourceView.tsx

@@ -19,7 +19,7 @@
  * lost on the next install, and the design system is what keeps the token contract stable.
  * The verdict is the host's, never a rule reimplemented here.
  *
- * See docs/architecture/LOCAL_STUDIO.md §Authoring in Studio.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md §Authoring in Studio.
  */
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Compartment, EditorState } from "@codemirror/state";

package/screens/index.ts

@@ -1,7 +1,7 @@
 /**
  * studio: the Studio screens, owned once and imported by BOTH Studios,
  * the Canvas-embedded catalog and the standalone local authoring app.
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  *
  * These screens contain NO transport, auth or persistence of their own. Everything
  * host-specific is imported from the bare specifier `studio-host`, which each app
@@ -24,6 +24,7 @@ export { TemplatesView } from "./TemplatesView";
 export { TemplatesLibraryView } from "./TemplatesLibraryView";
 export { DesignSystemView } from "./DesignSystemView";
 export { SkillsView } from "./SkillsView";
+export { IdentityView } from "./IdentityView";
 export { PromptBlocksView } from "./PromptBlocksView";
 export { IdentityHeader } from "./IdentityHeader";
 export { stateActivation } from "./states";
@@ -32,5 +33,5 @@ export { stateActivation } from "./states";
 // so it is shared even though neither shares the screen around it.
 export { ConfigForm, defaultsFromSchema } from "./ConfigForm";
 // The source view renders only where the host grants source access, so it is exported
-// unconditionally and returns null in Canvas (docs/architecture/LOCAL_STUDIO.md).
+// unconditionally and returns null in Canvas (docs/architecture/authoring/LOCAL_STUDIO.md).
 export { SourceView } from "./SourceView";

package/src/App.tsx

@@ -5,7 +5,7 @@
  * Studio renders. This file only does what a host must: pick the project, pick the
  * theme variant, resolve the theme, and choose which screen is showing.
  *
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { useEffect, useState } from "react";
 import type { ResolvedTheme } from "@unoverse/sdk";
@@ -16,6 +16,7 @@ import {
   TemplatesLibraryView,
   DesignSystemView,
   SkillsView,
+  IdentityView,
   PromptBlocksView,
 } from "@unoverse/studio";
 import { client, usePersistentState } from "./host";
@@ -33,10 +34,11 @@ import {
   Sparkles,
   SquareDashed,
   TextQuote,
+  Landmark,
   type LucideIcon,
 } from "lucide-react";
 
-type View = "apps" | "templates" | "components" | "atoms" | "tokens" | "skills" | "prompts" | "nodes";
+type View = "apps" | "templates" | "components" | "atoms" | "tokens" | "identity" | "skills" | "prompts" | "nodes";
 
 const NAV: { key: View; label: string; group: string; Icon: LucideIcon }[] = [
   { key: "apps", label: "Apps", group: "Build", Icon: LayoutDashboard },
@@ -44,6 +46,7 @@ const NAV: { key: View; label: string; group: string; Icon: LucideIcon }[] = [
   { key: "components", label: "Components", group: "Build", Icon: SquareDashed },
   { key: "atoms", label: "Atoms", group: "Build", Icon: Atom },
   { key: "tokens", label: "Styles", group: "Build", Icon: Palette },
+  { key: "identity", label: "Identity", group: "AI", Icon: Landmark },
   { key: "skills", label: "Skills", group: "AI", Icon: Sparkles },
   { key: "prompts", label: "Prompt Blocks", group: "AI", Icon: TextQuote },
   { key: "nodes", label: "Nodes", group: "Code", Icon: Boxes },
@@ -201,6 +204,8 @@ function Shell() {
           <AtomsView theme={theme} />
         ) : view === "tokens" ? (
           <DesignSystemView theme={theme} foundation={foundation} org={org} />
+        ) : view === "identity" ? (
+          <IdentityView org={org} />
         ) : view === "skills" ? (
           <SkillsView org={org} />
         ) : view === "nodes" ? (

package/src/NodeKeys.tsx

@@ -9,7 +9,7 @@
  * So this panel is read-only. It names the exact variable each field wants and says
  * whether it is set. Entering the value happens in the editor they are already in.
  *
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { useEffect, useState } from "react";
 

package/src/host.ts

@@ -9,7 +9,7 @@
  * There is no auth here on purpose. Local Studio is offline and single-user: the files
  * are already yours. Authentication belongs to a universe, not to a folder.
  *
- * See docs/architecture/LOCAL_STUDIO.md.
+ * See docs/architecture/authoring/LOCAL_STUDIO.md.
  */
 import { useCallback, useEffect, useState } from "react";
 import type { ResolvedTheme, UnoverseDefinition, UnoverseClient } from "@unoverse/sdk";
@@ -44,7 +44,7 @@ export function liveUniverseUrl(): string | null {
  * The capability lives on the host for the reason `hasAuth` does: a shared screen must
  * never branch on which app it is running in. Canvas leaves it false, so hosted surfaces
  * render and never edit, by construction rather than by discipline
- * (docs/architecture/LOCAL_STUDIO.md §The capability gate).
+ * (docs/architecture/authoring/LOCAL_STUDIO.md §The capability gate).
  */
 export const hasSourceAccess = true;
 
@@ -187,7 +187,7 @@ export function usePersistentState<T>(key: string, initial: T): [T, React.Dispat
   return [value, setValue];
 }
 
-export type RegistryKind = "node" | "skill" | "app" | "prompt" | "component" | "template";
+export type RegistryKind = "node" | "skill" | "app" | "prompt" | "component" | "template" | "identity";
 
 /**
  * Registry toggles decide what a RUNNING universe exposes; they persist to

package/vendor/base/src/agent-mcp/memoryIngest.ts

@@ -5,7 +5,7 @@
  * (config.enableUserMemory) is ON, each completed turn (original user input +
  * final agent answer — never intermediate iterations or tool chatter) is
  * POSTed to the memory server's /memory/ingest, which feeds the L1→L4
- * cascade (see docs/architecture/MEMORY_SPEC.md). Replaces the retired
+ * cascade (see docs/architecture/memory/MEMORY_SPEC.md). Replaces the retired
  * GravityMemoryStore canvas node.
  *
  * Every agent family calls this at turn completion with its own node type;

package/vendor/base/src/definitions/registry/identitySeed.ts

@@ -0,0 +1,17 @@
+/**
+ * THE IDENTITY SEED: design/<org>/identity/, four definitions with their briefs written and
+ * their defaults empty. GENERATED from the one source (the identity-defs script in the
+ * session that ruled it, 2026-09-05) and mirrored file for file by
+ * packages/studio/local/sample-identity/, which the Studio scaffold copies; a guard test
+ * holds the two equal. Edit the briefs here and there together, or regenerate both.
+ */
+export const IDENTITY_SEED: Readonly<Record<string, string>> = {
+  "organisation/manifest.yaml": "# The Organisation (docs/edgy/elements/organisation.md): the one that owns this spatial. This\n# manifest says what the document is for; organisation.yaml is the document. It never sits\n# on the map: it is the scope on every row and the grounding every extraction and every\n# agent wakes with.\ntitle: Organisation\ndescription: >-\n  Who this organisation is and what it does, in its own words, and the words it uses for its\n  products, its customers and itself.\nwhenToUse: >-\n  Ground any extraction, any agent or any piece of writing in who the organisation is and\n  how it speaks. Read whole at wake, never searched for. Not for what it offers, that is the\n  products on the map, and not for why it exists or where it came from, those are Purpose\n  and Story.\ncategory: Identity\nversion: 1.0.0\n",
+  "organisation/organisation.yaml": "unoverse: \"1.0\"\n# THE ORGANISATION, declared the way a component declares its props. Each prop's description\n# is the brief: direction to the writer that fills it, including what not to do. The\n# platform compiles briefs into a tool schema, so an Agent fills this from research the way\n# a copywriter fills an email, and a person reads the same words as guidance. The defaults\n# are this org's own words, as they stand.\ntype: identity\nname: organisation\ncategory: Identity\nprops:\n  name:\n    type: string\n    input: true\n    description: >-\n      The org's name as it trades, exactly as its website writes it in its own header or\n      footer. Never a legal suffix unless the site uses one.\n    maxLength: 80\n    default: \"\"\n  what:\n    type: string\n    input: true\n    description: >-\n      One paragraph, 60 to 120 words, in the third person: what the business is, what it\n      does, whom it serves, where. Taken from the site's own about, home and footer copy.\n      This paragraph grounds every extraction, so it must name the business's actual lines\n      of work, not adjectives. Never a slogan, never an industry generality.\n    maxLength: 900\n    default: \"\"\n  units:\n    type: array\n    input: true\n    description: >-\n      The organisation map: every unit the organisation names in its own publications, the\n      ones that face customers (divisions, lines of business, regions) and the ones that run\n      the organisation (operations, technology, people and HR, finance, risk, legal,\n      marketing, and the rest). Sources: the about and careers pages, the annual report's\n      organisation or leadership section, a published org chart. One entry per unit with its\n      name as the organisation writes it and one sentence on what it does or serves, nested\n      in `units` where the organisation nests them. Empty when the sources name none; never\n      invented.\n    maxItems: 40\n    default: []\n  vocabulary:\n    type: string\n    input: true\n    description: >-\n      The words the business uses, as one paragraph separated by semicolons: its product and\n      service names as it spells them, its programme and membership names, the terms it uses\n      for its customers, and anything it capitalises. Every name is copied from the site,\n      never paraphrased. This is the domain prompt every extraction reads, so completeness\n      beats elegance.\n    maxLength: 2000\n    default: \"\"\n",
+  "brand/manifest.yaml": "# The Brand (docs/edgy/elements/brand.md): our name and what it stands for. The written half;\n# styles/ is the visual half. Published, it is one row on the org's map, found by meaning.\ntitle: Brand\ndescription: >-\n  The name and what it stands for: the promise it makes, whom it speaks to, what sets it\n  apart, the brands inside it, and how it sounds.\nwhenToUse: >-\n  Answer what the brand stands for, what to expect from it, whom it is for and what sets it\n  apart; name the brands inside it; and give any writing its voice, the rules it follows and\n  sentences in its own words. Not for what the organisation is or does, that is the\n  Organisation, and not for why it exists, that is the Purpose.\ncategory: Identity\nversion: 1.0.0\n",
+  "brand/brand.yaml": "unoverse: \"1.0\"\n# THE BRAND, declared the way a component declares its props: each description is the brief\n# the writer follows; the defaults are this org's own words, as they stand.\ntype: identity\nname: brand\ncategory: Identity\nprops:\n  name:\n    type: string\n    input: true\n    description: >-\n      The brand name as the enterprise presents it, which may differ from its trading name\n      (a bank's card brand, a group's consumer brand). The site's logo text or title, not\n      the legal entity.\n    maxLength: 80\n    default: \"\"\n  standsFor:\n    type: string\n    input: true\n    description: >-\n      What the name stands for, in one sentence, in the enterprise's own words where it says\n      so (a tagline, a strapline, the meaning of the name, a 'who we are' line). Empty when\n      it does not say.\n    maxLength: 300\n    default: \"\"\n  promise:\n    type: string\n    input: true\n    description: >-\n      The expectation the brand sets: what people can expect from it, in one or two\n      sentences, drawn from the promises the site repeats on its home, about and brand\n      pages. Written to the customer.\n    maxLength: 400\n    default: \"\"\n  represents:\n    type: string\n    input: true\n    description: >-\n      How the brand carries the purpose (read purpose.yaml first): in one paragraph, how the\n      name, the promise and the way it presents itself express why the enterprise exists. In\n      the enterprise's own words where it connects the two; empty when it does not.\n    maxLength: 500\n    default: \"\"\n  audience:\n    type: string\n    input: true\n    description: >-\n      Whom the brand speaks to and how it wants to be seen by them, in one or two sentences,\n      from the way the site addresses its customers and describes its position. Never\n      invented segments.\n    maxLength: 400\n    default: \"\"\n  differentiators:\n    type: array\n    input: true\n    description: >-\n      What the enterprise claims sets its brand apart, three to six items, each in its own\n      words (a first, a leadership claim, a partnership, a heritage). Only claims it makes\n      itself.\n    maxItems: 6\n    default: []\n  brands:\n    type: array\n    input: true\n    description: >-\n      The brand tree: the sub-brands and product brands the enterprise presents under this\n      brand (a card family, an app, a loyalty programme, a subsidiary), one entry per brand\n      with its name as written and one sentence on what it is for, nested in `brands` where\n      the enterprise nests them. Empty when it presents none; never invented.\n    maxItems: 20\n    default: []\n  rules:\n    type: array\n    input: true\n    description: >-\n      Three to six rules the site's copy visibly follows, each as 'Do this' or 'Never that':\n      the person it addresses (you, we), its register (plain, formal, warm), sentence\n      length, what it capitalises, what it never says.\n    maxItems: 6\n    default: []\n  examples:\n    type: array\n    input: true\n    description: >-\n      Three to five sentences copied verbatim from the site that show the voice. Quotes,\n      never paraphrase.\n    maxItems: 5\n    default: []\n",
+  "purpose/manifest.yaml": "# The Purpose (docs/edgy/elements/purpose.md): why the enterprise exists and the goals it pursues.\n# Published, it is one row on the org's map, found by meaning.\ntitle: Purpose\ndescription: >-\n  Why the organisation exists: what its people believe in, what it aims to achieve, and the\n  goals it is working toward.\nwhenToUse: >-\n  Answer why the organisation exists, what its people believe in, what it aims to achieve\n  and the goals it is working toward. Read before the Brand, which represents it. Not for\n  its history or its scale, that is the Story, and not for its products.\ncategory: Identity\nversion: 1.0.0\n",
+  "purpose/purpose.yaml": "unoverse: \"1.0\"\n# THE PURPOSE, declared the way a component declares its props: each description is the brief\n# the writer follows; the defaults are this org's own words, as they stand.\ntype: identity\nname: purpose\ncategory: Identity\nprops:\n  statement:\n    type: string\n    input: true\n    description: >-\n      Why the enterprise exists, in its own words: the purpose or mission statement it\n      publishes, quoted where one exists. When it publishes none, one sentence composed only\n      from what its about page says it is for. Never a marketing slogan.\n    maxLength: 400\n    default: \"\"\n  values:\n    type: array\n    input: true\n    description: >-\n      What the people of the enterprise believe in and consider valuable: the values it\n      publishes, each with its name as the enterprise writes it and the one sentence it\n      gives for it. From the values, culture or about pages. Empty when none are published;\n      never invented.\n    maxItems: 8\n    default: []\n  ambition:\n    type: string\n    input: true\n    description: >-\n      The far end of the purpose: what the enterprise says it aims to achieve for its\n      customers, its country or society, in one paragraph, quoted where a vision or ambition\n      statement exists, with the horizon it names. Not the goals below; the outcome they\n      serve.\n    maxLength: 700\n    default: \"\"\n  goals:\n    type: array\n    input: true\n    description: >-\n      The goal tree: the strategic goals, pillars or commitments the enterprise names (a\n      strategy page, a strategy section of the annual report, 'our commitments'). One entry\n      per goal with its name as the enterprise writes it and one sentence on why, nested in\n      `goals` where it nests them. Empty when none are named; never invented.\n    maxItems: 12\n    default: []\n",
+  "story/manifest.yaml": "# The Story (docs/edgy/elements/story.md): the way the enterprise makes sense of itself.\n# History, present, vision. Published, it is one row on the org's map, found by meaning.\ntitle: Story\ndescription: >-\n  Where the organisation came from, what it is now and where it is going, and what that\n  story says it is for.\nwhenToUse: >-\n  Answer when and how the organisation began, its milestones, what it is today (its scale,\n  its lines of business), where it says it is going, and whom its story is about. Read with\n  the Purpose, which it puts in context. Not for why it exists, that is the Purpose.\ncategory: Identity\nversion: 1.0.0\n",
+  "story/story.yaml": "unoverse: \"1.0\"\n# THE STORY, declared the way a component declares its props: each description is the brief\n# the writer follows; the defaults are this org's own words, as they stand.\ntype: identity\nname: story\ncategory: Identity\nprops:\n  history:\n    type: string\n    input: true\n    description: >-\n      Where the enterprise came from, one paragraph of 60 to 120 words: founding year and\n      place, the names it has carried, the mergers and milestones its about or history page\n      states, in order. Only dated facts it gives; empty when it gives none.\n    maxLength: 900\n    default: \"\"\n  milestones:\n    type: array\n    input: true\n    description: >-\n      The story's beats, in order: one entry per dated event the enterprise itself records\n      (a founding, a merger, a name, a first, a listing), with the year as its name and one\n      sentence on what happened and why it mattered. From its history page, its timeline or\n      its annual report. Empty when it records none; never invented.\n    maxItems: 20\n    default: []\n  present:\n    type: string\n    input: true\n    description: >-\n      What the enterprise is now, one paragraph of 60 to 120 words: its scale as it states\n      it (customers, branches, countries, staff, assets), its main lines of business, its\n      position in its market in its own words, with the date those figures carry.\n    maxLength: 900\n    default: \"\"\n  vision:\n    type: string\n    input: true\n    description: >-\n      Where the enterprise is going, one paragraph: the vision, strategy or ambition it\n      publishes, quoted where a vision statement exists, with the horizon it names (a year,\n      a plan). Empty when it says nothing about the future.\n    maxLength: 900\n    default: \"\"\n  people:\n    type: string\n    input: true\n    description: >-\n      Whom the story is about and for: the people the enterprise names as the protagonists\n      of its story and the ones it tells it to (customers, employees, partners, a country, a\n      community), in its own words. Empty when it names none.\n    maxLength: 400\n    default: \"\"\n  meaning:\n    type: string\n    input: true\n    description: >-\n      What the story says the enterprise is for: one paragraph on how the history, the\n      present and the vision explain why it does what it does, connecting them to the\n      purpose (read purpose.yaml first). In the enterprise's own words where it makes the\n      connection; empty when it does not.\n    maxLength: 500\n    default: \"\"\n"
+};

package/vendor/base/src/definitions/registry/orgDocuments.ts

@@ -0,0 +1,67 @@
+/**
+ * THE ORG'S IDENTITY DOCUMENTS, READ (docs/unoverse/UNOVERSE_ORGANISATION.md section 5).
+ *
+ * Four definitions in design/<slug>/identity/, each a folder like a component's:
+ *
+ *   identity/<doc>/manifest.yaml   title, description, whenToUse, category, version
+ *   identity/<doc>/<doc>.yaml      type: identity, props: each with its brief and its default
+ *
+ * The defaults ARE the document: this org's own words. The briefs are the instructions a
+ * writer (an Agent with the create skill, or a person) follows to fill them. This module
+ * only reads; Studio authors, the platform renders. Nothing here writes a byte.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse } from "yaml";
+
+export const ORG_DOCUMENTS = ["organisation", "brand", "purpose", "story"] as const;
+export type OrgDocument = (typeof ORG_DOCUMENTS)[number];
+
+export interface IdentityProp {
+  name: string;
+  type: string;
+  /** The brief: what belongs in the field, as direction to a writer. */
+  description: string;
+  maxLength?: number;
+  maxItems?: number;
+  /** The org's own words, as they stand. */
+  default: unknown;
+}
+
+export interface IdentityDocument {
+  manifest: { title?: string; description?: string; whenToUse?: string; category?: string; version?: string };
+  definition: { type?: string; name?: string; category?: string };
+  props: IdentityProp[];
+  /** prop name -> default, the document as a plain object. */
+  values: Record<string, unknown>;
+  /** Where it lives in the pack, relative to design/<slug>/. */
+  path: string;
+}
+
+/** design/<slug>/identity/<doc>/ */
+export const identityDir = (root: string, doc: OrgDocument): string => join(root, "identity", doc);
+
+/** One identity definition as the pack holds it. Null when the folder is missing. */
+export function readOrgDocument(root: string, doc: OrgDocument): IdentityDocument | null {
+  const dir = identityDir(root, doc);
+  const file = join(dir, `${doc}.yaml`);
+  if (!existsSync(file)) return null;
+  const definition = (parse(readFileSync(file, "utf8")) as Record<string, any>) ?? {};
+  const manifestFile = join(dir, "manifest.yaml");
+  const manifest = existsSync(manifestFile) ? ((parse(readFileSync(manifestFile, "utf8")) as Record<string, any>) ?? {}) : {};
+  const props: IdentityProp[] = Object.entries((definition.props ?? {}) as Record<string, any>).map(([name, p]) => ({
+    name,
+    type: String(p?.type ?? "string"),
+    description: String(p?.description ?? ""),
+    ...(p?.maxLength != null ? { maxLength: Number(p.maxLength) } : {}),
+    ...(p?.maxItems != null ? { maxItems: Number(p.maxItems) } : {}),
+    default: p?.default,
+  }));
+  return {
+    manifest: { title: manifest.title, description: manifest.description, whenToUse: manifest.whenToUse, category: manifest.category, version: manifest.version },
+    definition: { type: definition.type, name: definition.name, category: definition.category },
+    props,
+    values: Object.fromEntries(props.map((p) => [p.name, p.default])),
+    path: `identity/${doc}/${doc}.yaml`,
+  };
+}

package/vendor/base/src/definitions/registry/orgPack.ts

@@ -0,0 +1,50 @@
+/**
+ * CREATE AN ORG'S DESIGN PACK (docs/unoverse/UNOVERSE_ORGANISATION.md section 5).
+ *
+ * The one implementation, used by the `new-org` script and by the server's POST /dev/orgs.
+ * The slug is the one word for the org everywhere: this folder, the URL, the org Studio
+ * publishes into, the world a run gets. The pack holds:
+ *
+ *   design/<slug>/
+ *     identity/           the Identity facet (owner ruling 2026-09-05): a Studio asset
+ *       organisation.yaml the org itself: name, what, units, vocabulary
+ *       brand.yaml        the written half of the brand (styles/ is the visual half)
+ *       purpose.yaml      why it exists
+ *       story.yaml        history, present, vision
+ *     apps/  components/  the org's own
+ *     styles/themes/      brand themes seeded from the marketplace foundation; base and
+ *                         semantic tokens are INHERITED at resolve time (an org is a theme)
+ *
+ * Shapes: each definition declares its own props with their briefs (identitySeed.ts). Nothing is
+ * invented: the defaults are empty until a writer fills them from the org's own sources.
+ */
+import { cpSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { IDENTITY_SEED } from "./identitySeed.js";
+
+export const ORG_SLUG = /^[a-z][a-z0-9-]{0,63}$/;
+
+/**
+ * Make design/<slug>/ under `designHome`. Throws if the slug is malformed or the pack
+ * exists; never overwrites. Returns the pack's path.
+ */
+export function createOrgPack(designHome: string, slug: string, name: string): string {
+  if (!ORG_SLUG.test(slug)) throw new Error("slug: lowercase letters, digits and hyphens, starting with a letter");
+  const dest = join(designHome, slug);
+  if (existsSync(dest)) throw new Error(`design/${slug} already exists`);
+  const themes = join(designHome, "marketplace", "styles", "themes");
+  if (!existsSync(themes)) throw new Error("the marketplace theme foundation is missing; cannot seed the org's themes");
+
+  mkdirSync(join(dest, "apps"), { recursive: true });
+  mkdirSync(join(dest, "components"), { recursive: true });
+  mkdirSync(join(dest, "identity"), { recursive: true });
+  cpSync(themes, join(dest, "styles", "themes"), { recursive: true });
+  // THE IDENTITY SEED: four definitions, briefs written, defaults empty (identitySeed.ts,
+  // mirrored by the Studio scaffold's sample-identity). The name is the org row's, not the
+  // document's: the writer fills `name` from the organisation's own site.
+  for (const [rel, text] of Object.entries(IDENTITY_SEED)) {
+    mkdirSync(dirname(join(dest, "identity", rel)), { recursive: true });
+    writeFileSync(join(dest, "identity", rel), text);
+  }
+  return dest;
+}

package/vendor/base/src/items/collect.ts

@@ -108,7 +108,8 @@ export function collectProject(designRoot: string, project: string): CollectedIt
   // A prompt block is NEVER qualified this way — see the blocks/ walk below for why.
   // Apps keep their bare ids: those are org-qualified by convention
   // (`<org>-chat`). docs/unoverse/UNOVERSE_COMPONENT_ORGS.md.
-  const QUALIFIED_KINDS = new Set(["component", "skill", "template"]);
+  // `identity` (2026-09-05): the org's four documents, `<org>/brand` like a component.
+  const QUALIFIED_KINDS = new Set(["component", "skill", "template", "identity"]);
   const add = (kind: string, name: string, definition: CollectedItem["definition"]) =>
     items.push({
       kind,
@@ -134,7 +135,10 @@ export function collectProject(designRoot: string, project: string): CollectedIt
   // 029): apps publish as kind `app` and the Template Model kind owns the bare
   // word. Forgetting a design dir here ships deploys that silently drop every
   // artifact of that kind.
-  for (const [dir, kind] of [["components", "component"], ["apps", "app"], ["templates", "template"], ["atoms", "atom"]] as const) {
+  // IDENTITY (owner ruling 2026-09-05): design/<org>/identity/<doc>/ publishes as kind
+  // `identity`, the same walk as a component folder, so it reaches the registry, the
+  // spatial catalogue and the map through the one publish path everything else takes.
+  for (const [dir, kind] of [["components", "component"], ["apps", "app"], ["templates", "template"], ["atoms", "atom"], ["identity", "identity"]] as const) {
     const home = join(root, dir);
     if (!existsSync(home)) continue;
     for (const e of readdirSync(home, { withFileTypes: true })) {

package/vendor/base/src/items/publish.ts

@@ -10,7 +10,7 @@
  * new, changed, unchanged, or refused because the name belongs to someone else. Publishing
  * blind is how a project half-lands and nobody can tell by looking.
  *
- * See docs/architecture/DECLARATIVE_NODES.md §9.
+ * See docs/architecture/authoring/DECLARATIVE_NODES.md §9.
  */
 import { existsSync } from "node:fs";
 import { join } from "node:path";

package/vendor/base/src/lint/design/vocabulary.mjs

@@ -57,7 +57,7 @@ export const PROP_KEYS = [
  */
 export const INTERFACE_FIELDS = new Set([
   "universal_id", "title", "description", "object_type", "key_need", "source_url", "source_id",
-  "tagline", "shortDescription", "introParagraph", "callToAction", "actionPrompt", "primaryImage", "images", "action",
+  "tagline", "shortDescription", "introParagraph", "callToAction", "primaryImage", "images", "action",
   "bodyCopy", "features", "mainCategory", "section", "needs",
 ]);
 

package/vendor/base/src/lint/nodes/index.mjs

@@ -13,7 +13,7 @@
  * without it is the gap LOCAL_STUDIO.md:246 names: "a malformed definition is one restart
  * from a broken server", and a published row does not even need the restart.
  *
- * FOUR TIERS (docs/architecture/DECLARATIVE_NODES.md §6). This is tiers 2 and 3.
+ * FOUR TIERS (docs/architecture/authoring/DECLARATIVE_NODES.md §6). This is tiers 2 and 3.
  *   1  editor    $schema pointers + .vscode yaml.schemas, no tool
  *   2  structural   every part validated against the node schemas (packages/docs/schemas/nodes)
  *   3  semantic     the cross-file rules a schema cannot express

package/vendor/base/src/manifests/compose.ts

@@ -13,7 +13,7 @@
  * scripts/lib/lint-nodes.mjs, which must run without the server (it ships in the
  * starter kit). Keep the two in step; the linter is the one developers see first.
  *
- * See docs/architecture/DECLARATIVE_NODES.md §5.
+ * See docs/architecture/authoring/DECLARATIVE_NODES.md §5.
  */
 import * as YAML from "yaml";
 import type { RawNode, RawPackage } from "./source.js";

package/vendor/base/src/manifests/executor/context.ts

@@ -59,6 +59,9 @@ export function contextFor(node: ComposedNode, inputs: any, config: any, executi
     scope: {
       userId: executionContext?.publishingContext?.userId ?? executionContext?.workflow?.variables?.userId,
       workflowId: executionContext?.workflowId ?? executionContext?.workflow?.id,
+      // THE WORLD THIS RUN WORKS IN (docs/unoverse/UNOVERSE_SPATIAL_ORG.md): named by the run,
+      // else the canvas's default. The spatial and ingest packages send it as the map's scope.
+      org: executionContext?.publishingContext?.org ?? executionContext?.workflow?.org,
       conversationId:
         executionContext?.publishingContext?.conversationId ?? executionContext?.workflow?.variables?.conversationId,
       chatId: executionContext?.publishingContext?.chatId ?? executionContext?.workflow?.variables?.chatId,

package/vendor/base/src/manifests/index.ts

@@ -11,7 +11,7 @@
  * updating a node should never restart a universe. When the source becomes Postgres,
  * an install is a row write followed by this call.
  *
- * See docs/architecture/DECLARATIVE_NODES.md.
+ * See docs/architecture/authoring/DECLARATIVE_NODES.md.
  */
 import {
   getNodeRegistry,

package/vendor/base/src/manifests/runtime/context.ts

@@ -85,7 +85,7 @@ export interface RunContext {
    * its own address. Loopback, because :4106 is the ungated internal listener and is published to
    * 127.0.0.1 only.
    */
-  scope: { userId?: string; workflowId?: string; conversationId?: string; chatId?: string; executionId?: string; nodeId?: string; platformUrl?: string; engineUrl?: string };
+  scope: { userId?: string; workflowId?: string; org?: string; conversationId?: string; chatId?: string; executionId?: string; nodeId?: string; platformUrl?: string; engineUrl?: string };
   /**
    * THE CONVERSATION SO FAR, for a tool loop against a vendor with no chain id.
    *

package/vendor/base/src/manifests/source.ts

@@ -9,7 +9,7 @@
  * Everything past this file works on the composed definition and never learns where
  * it came from.
  *
- * See docs/architecture/DECLARATIVE_NODES.md.
+ * See docs/architecture/authoring/DECLARATIVE_NODES.md.
  */
 import * as fs from "fs";
 import * as path from "path";

package/vendor/base/src/plugins/README.md

@@ -54,4 +54,4 @@ The two Vite warnings a developer sees when starting Studio come from `discovery
 `loader.ts` (dynamic `import()` of a package by name). They are correct, they are
 unfixable while this folder exists, and they leave when it does.
 
-See `docs/architecture/DECLARATIVE_NODES.md` §7a and §10.
+See `docs/architecture/authoring/DECLARATIVE_NODES.md` §7a and §10.

package/vendor/sdk/appEngine.tsx

@@ -274,7 +274,7 @@ export function AppEngine(cfg: AppConfig) {
                 // — nothing to write.
                 const declared = parsed?.manifest?.defaultState ?? parsed?.manifest?.mode ?? parsed?.defaultState ?? parsed?.mode;
                 if (declared && declared !== "app") store.mergeAppState({ defaultState: declared });
-                conn.trigger({ app, metadata: { targetTriggerNode: b.trigger } });
+                conn.trigger({ app, metadata: { targetTriggerNode: b.trigger, ...(def?.org ? { org: def.org } : {}) } });
               })
               .catch((e: any) => console.error("[app] launch failed:", e));
             return;

package/vite.config.ts

@@ -1,5 +1,5 @@
 /**
- * Local Studio — the standalone developer tool (docs/architecture/LOCAL_STUDIO.md).
+ * Local Studio — the standalone developer tool (docs/architecture/authoring/LOCAL_STUDIO.md).
  *
  * Runs entirely offline against the developer's own project folder. No Postgres, no
  * Redis, no engine, no Docker: the catalog routes are served straight off disk by the