@elevasis/sdk 1.46.0 → 1.48.0

package/dist/worker/index.d.ts

@@ -2482,6 +2482,7 @@ type Database = {
             activities: {
                 Row: {
                     activity_type: string;
+                    actor_api_key_id: string | null;
                     actor_id: string | null;
                     actor_type: string | null;
                     created_at: string;
@@ -2498,6 +2499,7 @@ type Database = {
                 };
                 Insert: {
                     activity_type: string;
+                    actor_api_key_id?: string | null;
                     actor_id?: string | null;
                     actor_type?: string | null;
                     created_at?: string;
@@ -2514,6 +2516,7 @@ type Database = {
                 };
                 Update: {
                     activity_type?: string;
+                    actor_api_key_id?: string | null;
                     actor_id?: string | null;
                     actor_type?: string | null;
                     created_at?: string;
@@ -2529,6 +2532,13 @@ type Database = {
                     title?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "activities_actor_api_key_id_fkey";
+                        columns: ["actor_api_key_id"];
+                        isOneToOne: false;
+                        referencedRelation: "api_keys";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "activities_actor_id_fkey";
                         columns: ["actor_id"];
@@ -2616,6 +2626,7 @@ type Database = {
             api_keys: {
                 Row: {
                     created_at: string | null;
+                    created_by: string | null;
                     id: string;
                     key_hash: string;
                     last_used_at: string | null;
@@ -2624,6 +2635,7 @@ type Database = {
                 };
                 Insert: {
                     created_at?: string | null;
+                    created_by?: string | null;
                     id?: string;
                     key_hash: string;
                     last_used_at?: string | null;
@@ -2632,6 +2644,7 @@ type Database = {
                 };
                 Update: {
                     created_at?: string | null;
+                    created_by?: string | null;
                     id?: string;
                     key_hash?: string;
                     last_used_at?: string | null;
@@ -2639,6 +2652,13 @@ type Database = {
                     organization_id?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "api_keys_created_by_fkey";
+                        columns: ["created_by"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "api_keys_organization_id_fkey";
                         columns: ["organization_id"];
@@ -2966,6 +2986,7 @@ type Database = {
                     organization_id: string;
                     payload: Json;
                     source_execution_id: string | null;
+                    status: string;
                     step_key: string | null;
                 };
                 Insert: {
@@ -2977,6 +2998,7 @@ type Database = {
                     organization_id: string;
                     payload?: Json;
                     source_execution_id?: string | null;
+                    status: string;
                     step_key?: string | null;
                 };
                 Update: {
@@ -2988,6 +3010,7 @@ type Database = {
                     organization_id?: string;
                     payload?: Json;
                     source_execution_id?: string | null;
+                    status?: string;
                     step_key?: string | null;
                 };
                 Relationships: [
@@ -3139,6 +3162,7 @@ type Database = {
                     kind: string;
                     metadata: Json;
                     organization_id: string;
+                    payload: Json;
                     processing_state: Json;
                     storage_path: string | null;
                     title: string;
@@ -3152,6 +3176,7 @@ type Database = {
                     kind: string;
                     metadata?: Json;
                     organization_id: string;
+                    payload?: Json;
                     processing_state?: Json;
                     storage_path?: string | null;
                     title: string;
@@ -3165,6 +3190,7 @@ type Database = {
                     kind?: string;
                     metadata?: Json;
                     organization_id?: string;
+                    payload?: Json;
                     processing_state?: Json;
                     storage_path?: string | null;
                     title?: string;
@@ -6628,7 +6654,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         route: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>>>;
-}, z.core.$strip>>;
+}, z.core.$strict>>;
 type OntologyScope = z.infer<typeof OntologyScopeSchema>;
 
 declare const SystemApiInterfaceSchema: z.ZodObject<{
@@ -7275,7 +7301,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             route: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>>>;
-    }, z.core.$strip>>>;
+    }, z.core.$strict>>>;
     resources: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
         order: z.ZodDefault<z.ZodNumber>;
@@ -9778,6 +9804,20 @@ declare const ProjectSchemas: {
     }, z.core.$strip>;
 };
 
+/**
+ * `'running'` is the only in-flight value; every other member is terminal.
+ * Added 2026-08-14 (the step-state model): a producer writes `'running'`
+ * when it starts a step and patches the same row to a terminal status when
+ * the step finishes (`updateAttempt`) — see `CreateContentItemAttemptRequestSchema`
+ * / `UpdateContentItemAttemptRequestSchema` below.
+ */
+declare const ContentStepStatusSchema: z.ZodEnum<{
+    error: "error";
+    success: "success";
+    running: "running";
+    no_result: "no_result";
+    skipped: "skipped";
+}>;
 /** D18: `pipeline_id` is an OM ontology id (free text), not a UUID. */
 declare const ContentPipelineIdSchema: z.ZodString;
 /** `content:catalog/status` entries. Free text, model-owned. */
@@ -9812,9 +9852,13 @@ declare const ContentItemResponseSchema: z.ZodObject<{
         status: z.ZodEnum<{
             error: "error";
             success: "success";
+            running: "running";
             no_result: "no_result";
             skipped: "skipped";
         }>;
+        attemptId: z.ZodString;
+        executionId: z.ZodNullable<z.ZodString>;
+        attemptedAt: z.ZodString;
         data: z.ZodOptional<z.ZodUnknown>;
     }, z.core.$loose>>;
     reviewedAt: z.ZodNullable<z.ZodString>;
@@ -9842,9 +9886,13 @@ declare const ContentItemListResponseSchema: z.ZodObject<{
             status: z.ZodEnum<{
                 error: "error";
                 success: "success";
+                running: "running";
                 no_result: "no_result";
                 skipped: "skipped";
             }>;
+            attemptId: z.ZodString;
+            executionId: z.ZodNullable<z.ZodString>;
+            attemptedAt: z.ZodString;
             data: z.ZodOptional<z.ZodUnknown>;
         }, z.core.$loose>>;
         reviewedAt: z.ZodNullable<z.ZodString>;
@@ -9866,6 +9914,13 @@ declare const ContentItemAttemptResponseSchema: z.ZodObject<{
     contentItemId: z.ZodString;
     attemptNumber: z.ZodNumber;
     stepKey: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        error: "error";
+        success: "success";
+        running: "running";
+        no_result: "no_result";
+        skipped: "skipped";
+    }>;
     payload: z.ZodUnknown;
     sourceExecutionId: z.ZodNullable<z.ZodString>;
     createdBy: z.ZodNullable<z.ZodString>;
@@ -9878,12 +9933,45 @@ declare const ContentItemAttemptListResponseSchema: z.ZodObject<{
         contentItemId: z.ZodString;
         attemptNumber: z.ZodNumber;
         stepKey: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            error: "error";
+            success: "success";
+            running: "running";
+            no_result: "no_result";
+            skipped: "skipped";
+        }>;
         payload: z.ZodUnknown;
         sourceExecutionId: z.ZodNullable<z.ZodString>;
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+declare const ContentSourceAssetResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    organizationId: z.ZodString;
+    kind: z.ZodString;
+    title: z.ZodString;
+    externalUrl: z.ZodNullable<z.ZodString>;
+    storagePath: z.ZodNullable<z.ZodString>;
+    durationSeconds: z.ZodNullable<z.ZodNumber>;
+    metadata: z.ZodUnknown;
+    payload: z.ZodUnknown;
+    processingState: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<{
+            error: "error";
+            success: "success";
+            running: "running";
+            no_result: "no_result";
+            skipped: "skipped";
+        }>;
+        attemptId: z.ZodString;
+        executionId: z.ZodNullable<z.ZodString>;
+        attemptedAt: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
 declare const ContentDistributionResponseSchema: z.ZodObject<{
     id: z.ZodString;
     organizationId: z.ZodString;
@@ -9899,9 +9987,13 @@ declare const ContentDistributionResponseSchema: z.ZodObject<{
         status: z.ZodEnum<{
             error: "error";
             success: "success";
+            running: "running";
             no_result: "no_result";
             skipped: "skipped";
         }>;
+        attemptId: z.ZodString;
+        executionId: z.ZodNullable<z.ZodString>;
+        attemptedAt: z.ZodString;
         data: z.ZodOptional<z.ZodUnknown>;
     }, z.core.$loose>>;
     publishMethod: z.ZodNullable<z.ZodString>;
@@ -9913,6 +10005,7 @@ declare const ContentDistributionResponseSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
+type ContentStepStatus = z.infer<typeof ContentStepStatusSchema>;
 type ContentPipelineId = z.infer<typeof ContentPipelineIdSchema>;
 type ContentItemStatus = z.infer<typeof ContentItemStatusSchema>;
 type ContentPillar = z.infer<typeof ContentPillarSchema>;
@@ -9924,6 +10017,7 @@ type ContentItemResponse = z.infer<typeof ContentItemResponseSchema>;
 type ContentItemListResponse = z.infer<typeof ContentItemListResponseSchema>;
 type ContentItemAttemptResponse = z.infer<typeof ContentItemAttemptResponseSchema>;
 type ContentItemAttemptListResponse = z.infer<typeof ContentItemAttemptListResponseSchema>;
+type ContentSourceAssetResponse = z.infer<typeof ContentSourceAssetResponseSchema>;
 type ContentDistributionResponse = z.infer<typeof ContentDistributionResponseSchema>;
 
 /**
@@ -10956,6 +11050,13 @@ type ContentToolMap = {
             /** Which step this attempt implements. Stored as-is; NULL when omitted. */
             stepKey?: string | null;
             sourceExecutionId?: string | null;
+            /**
+             * The status the row is created with. Optional so a producer starting a
+             * step can write `'running'` before doing the work -- the "write-at-start"
+             * half of write-at-start/patch-at-end. Omitted, the column's own default
+             * applies, which is why a producer that means `'running'` must say so.
+             */
+            status?: ContentStepStatus;
         };
         result: ContentItemAttemptResponse;
     };
@@ -10966,6 +11067,69 @@ type ContentToolMap = {
         };
         result: ContentItemAttemptListResponse;
     };
+    /**
+     * Patch an existing attempt to its terminal status -- the "patch-at-end"
+     * half of write-at-start/patch-at-end (see `ContentStepStatus`'s
+     * `'running'` value). `attemptNumber`, `stepKey`, and `sourceExecutionId`
+     * are immutable once written; only `status` and `payload` change here.
+     */
+    updateAttempt: {
+        params: {
+            attemptId: string;
+            status?: ContentStepStatus;
+            payload?: ContentPayloadEnvelope;
+        };
+        result: ContentItemAttemptResponse;
+    };
+    /**
+     * Insert a new `content_source_assets` row. `payload` is an open envelope
+     * (D5, content-source-asset-write-path.mdx) -- per-`kind` field membership
+     * is declared in the OM catalog, not enforced by this transport type.
+     */
+    createSourceAsset: {
+        params: {
+            kind: string;
+            title: string;
+            externalUrl?: string | null;
+            storagePath?: string | null;
+            durationSeconds?: number | null;
+            metadata?: Record<string, unknown>;
+            payload?: ContentPayloadEnvelope;
+        };
+        result: ContentSourceAssetResponse;
+    };
+    /** Fetch a single source asset by id, org-scoped. */
+    getSourceAsset: {
+        params: {
+            sourceAssetId: string;
+        };
+        result: ContentSourceAssetResponse | null;
+    };
+    /** Query source assets -- e.g. a producer picking material for the next item. */
+    listSourceAssets: {
+        params: {
+            kind?: string;
+            limit?: number;
+            offset?: number;
+        };
+        result: {
+            data: ContentSourceAssetResponse[];
+        };
+    };
+    /** Update a source asset's mutable fields. */
+    updateSourceAsset: {
+        params: {
+            sourceAssetId: string;
+            kind?: string;
+            title?: string;
+            externalUrl?: string | null;
+            storagePath?: string | null;
+            durationSeconds?: number | null;
+            metadata?: Record<string, unknown>;
+            payload?: ContentPayloadEnvelope;
+        };
+        result: ContentSourceAssetResponse;
+    };
     /** Insert a `content_distributions` row for one platform/format target. */
     createDistribution: {
         params: {
@@ -12375,7 +12539,7 @@ declare const notifications: TypedAdapter<NotificationToolMap>;
  * Typed wrapper over platform.call() for acquisition lead management.
  * Singleton export -- no credential needed (platform tool).
  *
- * 56 methods covering lists, companies, contacts, deals, list-stage updates, deal-sync, deal notes, deal tasks, enrichment, and social monitoring operations.
+ * 60 methods covering lists, companies, contacts, deals, list-stage updates, deal-sync, deal notes, deal tasks, enrichment, and social monitoring operations.
  * organizationId is injected server-side by the dispatcher -- never sent from the SDK.
  */
 
@@ -12449,9 +12613,9 @@ declare const list: TypedAdapter<ListToolMap>;
 /**
  * Artifacts Platform Tool Adapter
  *
- * Focused wrapper for the org-scoped governing-document store (rules
- * documents, idea banks, ICP docs). Singleton export -- no credential needed
- * (platform tool).
+ * Focused wrapper for the org-scoped governing-document store, keyed by
+ * owner and kind, for acquisition's audits, proposals, and ICP docs.
+ * Singleton export -- no credential needed (platform tool).
  *
  * `kind` convention: any artifact written for the content pipeline (an
  * `ownerKind: 'organization'` document -- a selection brief, an idea bank,
@@ -12470,16 +12634,48 @@ declare const artifacts: TypedAdapter<ArtifactsToolMap>;
  * Content Platform Tool Adapter
  *
  * Typed wrapper over platform.call() for the content System's producer
- * surface (`content_items`, `content_item_attempts`, `content_distributions`).
- * Singleton export -- no credential needed (platform tool).
+ * surface (`content_items`, `content_item_attempts`, `content_distributions`,
+ * `content_source_assets`). Singleton export -- no credential needed
+ * (platform tool).
  *
  * `organizationId` is injected server-side by the dispatcher -- never sent
  * from the SDK. There is deliberately no `updateProcessingState` method:
  * `content_items.processing_state` and `content_distributions.processing_state`
  * are not writable through this adapter (content-pipeline execution plan
  * Decision 4, enforced by omission).
+ *
+ * `createAttempt.sourceExecutionId` is `string | null | undefined` on the
+ * underlying `ContentToolMap`, and this adapter narrows it to a **required
+ * key with a nullable value**: the caller must supply it, but may supply
+ * `null`. Requiring the key is the SDK-layer analog of `organizationId` never
+ * appearing in the params type at all -- a worker always has its own
+ * `context.executionId`, so a producer cannot silently forget it, which is
+ * what the step-state model's write-at-start/patch-at-end contract depends on
+ * (see `mock-pipeline-shared.ts`).
+ *
+ * Permitting `null` is what makes a backfill expressible. The narrowing was
+ * briefly `sourceExecutionId: string`, which excluded the one-time import of
+ * records that have no execution behind them and never will -- core's
+ * `CreateContentItemAttemptRequestSchema` types it `UuidSchema.nullable().optional()`
+ * and the DB column is nullable, so the restriction was an SDK compile-time
+ * guard rather than a data constraint, and the API already accepts null
+ * (`reviewItem` writes a review attempt with `sourceExecutionId: null`).
+ * Passing `null` states "no execution, and never will be"; it is not an
+ * invitation to invent an execution id to satisfy the type.
+ *
+ * `createAttempt.status` is a real field on `ContentToolMap` -- a producer
+ * starting a step sends `'running'` and the dispatcher forwards it. It was
+ * briefly missing from both the tool map and the dispatcher's forward, which
+ * meant a create-time status was accepted by the Zod schema and then dropped,
+ * landing the row on the column default. Both were closed on 2026-08-15.
  */
 
+/** The content adapter's public shape -- `TypedAdapter<ContentToolMap>` with `createAttempt` narrowed. */
+type ContentAdapter = Omit<TypedAdapter<ContentToolMap>, 'createAttempt'> & {
+    createAttempt: (params: Omit<ContentToolMap['createAttempt']['params'], 'sourceExecutionId'> & {
+        sourceExecutionId: string | null;
+    }) => Promise<ContentToolMap['createAttempt']['result']>;
+};
 /**
  * Typed content adapter for the content pipeline's producer surface.
  *
@@ -12488,10 +12684,17 @@ declare const artifacts: TypedAdapter<ArtifactsToolMap>;
  * import { content } from '@elevasis/sdk/worker'
  *
  * const item = await content.createItem({ title: 'Draft', pipelineId: 'long-form-to-shorts' })
- * const attempt = await content.createAttempt({ contentItemId: item.id, payload: { body: '...' } })
+ * const attempt = await content.createAttempt({
+ *   contentItemId: item.id,
+ *   stepKey: 'clip-proposal',
+ *   status: 'running',
+ *   payload: {},
+ *   sourceExecutionId: context.executionId
+ * })
+ * const settled = await content.updateAttempt({ attemptId: attempt.id, status: 'success', payload: { body: '...' } })
  * ```
  */
-declare const content: TypedAdapter<ContentToolMap>;
+declare const content: ContentAdapter;
 
 /**
  * Typed PDF adapter for document rendering.

package/dist/worker/index.js

@@ -6700,6 +6700,8 @@ var acqDb = createAdapter("acqDb", [
   "addCompaniesToList",
   "updateCompanyStage",
   "updateContactStage",
+  "clearCompanyStages",
+  "clearContactStages",
   // Company operations
   "createCompany",
   "upsertCompany",
@@ -6726,6 +6728,8 @@ var acqDb = createAdapter("acqDb", [
   "getDealById",
   "getContactById",
   "getCompanyById",
+  "listDeals",
+  "getDealPipelineAnalytics",
   // Deal transitions
   "updateDiscoveryData",
   "updateProposalData",
@@ -6803,6 +6807,8 @@ var list = createAdapter("list", [
   "recordExecution",
   "updateCompanyStage",
   "updateContactStage",
+  "clearCompanyStages",
+  "clearContactStages",
   "listPendingCompanyIds",
   "listPendingContactIds"
 ]);
@@ -6815,16 +6821,22 @@ var artifacts = createAdapter("artifacts", [
 ]);
 
 // src/worker/adapters/content.ts
-var content = createAdapter("content", [
+var METHODS14 = [
   "createItem",
   "getItem",
   "listItems",
   "updateItem",
   "createAttempt",
   "listAttempts",
+  "updateAttempt",
+  "createSourceAsset",
+  "getSourceAsset",
+  "listSourceAssets",
+  "updateSourceAsset",
   "createDistribution",
   "updateDistribution"
-]);
+];
+var content = createAdapter("content", METHODS14);
 
 // src/worker/adapters/pdf.ts
 var pdf = createAdapter("pdf", ["render", "renderToBuffer"]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.46.0",
+  "version": "1.48.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -55,7 +55,7 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.61.0",
+    "@repo/core": "0.63.0",
     "@repo/typescript-config": "0.0.0",
     "@repo/eslint-config": "0.0.0"
   },

package/reference/_navigation.md

@@ -194,7 +194,7 @@ Universal scaffold documentation for all SDK projects. Source locations are co-l
 | Gate by System or Admin | `scaffold/recipes/gate-by-feature-or-admin.md` | Decision table and recipes for gating routes, sidebar entries, and UI elements with AccessGuard and the unified Access Model. |
 | Build and Extend CRM | `scaffold/recipes/extend-crm.md` | Map the CRM platform primitives available to SDK projects: shared UI pages, sidebar composition, data hooks, action definitions, workflow adapters, System Interfaces, and org-model extension boundaries. |
 | Build and Extend Lead Gen | `scaffold/recipes/extend-lead-gen.md` | Map the lead-gen platform primitives available to SDK projects: shared UI pages, provider-injected Organization Model config, data hooks, list/member state, artifacts, workflow adapters, System Interfaces, and tenant-owned extension boundaries. |
-| Build and Extend Content | `scaffold/recipes/extend-content.md` | Map the content platform primitives available to SDK projects: pipeline and step catalogs, shared review/pipeline/distribution pages, data hooks, the content workflow adapter, artifacts as rules documents, and org-model extension boundaries. |
+| Build and Extend Content | `scaffold/recipes/extend-content.md` | Map the content platform primitives available to SDK projects: pipeline and step catalogs, shared review/pipeline/distribution pages, data hooks, the content workflow adapter, and org-model extension boundaries. |
 | Customize CRM Actions | `scaffold/recipes/customize-crm-actions.md` | Add, hide, or replace CRM deal action buttons in a template-derived project, and override default platform action workflows with project-owned implementations. |
 | Customize Knowledge Browser | `scaffold/recipes/customize-knowledge-browser.md` | Author knowledge nodes and customize the Knowledge Browser in a template-derived project -- from zero-config authoring through sidebar composition, custom dispatchers, and direct query access. |
 | Query the Knowledge Graph | `scaffold/recipes/query-the-knowledge-graph.md` | Use the `knowledge:*` CLI subcommands on `elevasis-sdk` (external projects) and `elevasis` (monorepo) to browse, inspect, and traverse the OrganizationModel knowledge graph via six mount axes. |
@@ -210,7 +210,7 @@ Universal scaffold documentation for all SDK projects. Source locations are co-l
 
 The bundled agent-rule corpus. Locations are relative to this file -- the `reference/` root of the installed `@elevasis/sdk` package -- so every row resolves offline in a cloned project with no monorepo.
 
-Agent rules indexed: 18.
+Agent rules indexed: 19.
 
 ### Core Config
 
@@ -226,6 +226,7 @@ Agent rules indexed: 18.
 | Operations | `rules/operations.md` | Platform workflows, agents, resource definitions, and deployment for the operations/ surface | Editing anything under `operations/` -- workflows, agents, or resource definitions. |
 | Platform | `rules/platform.md` | Platform conventions -- SDK workflows, agents, deployment, resource registry | Authoring a workflow or agent definition, or registering a resource in the registry. |
 | Deployment | `rules/deployment.md` | Deployment workflow -- check-first, dev vs prod, version bumping, common errors | Before any deploy -- a plain `run deploy` targets production by default. |
+| Content | `rules/content.md` | Building the content System behind the shipped pipeline, item, and distribution routes -- which recipe to read, and the catalog vocabulary that is model-owned rather than coded | Editing anything under `ui/src/routes/content/` -- items, pipelines, distributions, or a review gate. |
 | Execution Model | `rules/execution.md` | Execution model -- timeouts, memory, concurrency, org isolation, runtime constraints | Hitting a timeout, memory ceiling, concurrency limit, or org-isolation question at runtime. |
 | Agent Runtime | `rules/agent-runtime.md` | Agent runtime behavior -- iteration response shape, session memory and replay, prose normalization, and why a redeploy is what makes a platform fix live | Debugging an agent turn -- a missing reply, a corrupted one, a session that forgot, or an unenforced schema. |
 | Error Handling | `rules/error-handling.md` | Error handling -- ExecutionError vs PlatformToolError, retry logic, no auto-retry | Writing or debugging a step handler that throws, catches, or retries. |
@@ -235,7 +236,7 @@ Agent rules indexed: 18.
 
 | Rule | Location | Description | When to Load |
 | --- | --- | --- | --- |
-| Organization OS | `rules/organization-os.md` | Organization OS orientation -- what the semantic contract layer is, which surface owns what, and where the full reference docs live; concrete edit rules live in organization-model.md | Before an org-model change, to see how Systems, ontology, resources, policies, and knowledge relate. |
+| Organization OS | `rules/organization-os.md` | Organization OS orientation -- what the semantic contract layer is, which surface owns what, and where the full reference docs live; concrete edit rules live in organization-model.md | Before an org-model change, to see how Systems, ontology, resources, roles, and knowledge relate. |
 | Package Taxonomy | `rules/package-taxonomy.md` | Package taxonomy (consumer view) -- external projects consume the published @elevasis/* surface only; workspace-internal @repo/elevasis-* packages are not installable here | Adding a dependency, or resolving an `@elevasis/*` import or subpath question. |
 | Active Change Index | `rules/active-change-index.md` | Which bundled references to load for platform areas under active change, and how to resolve drift between the bundled snapshot and live platform behavior | Before trusting a stable scaffold doc in a fast-moving area -- lists what in-progress work overrides. |
 
@@ -280,7 +281,7 @@ Docs-site pages indexed: 38.
 
 | Page | Location | Description |
 | --- | --- | --- |
-| CLI Management Commands | `sdk/cli-management.mdx` | elevasis-sdk management commands -- project, note, acquisition, client, agent, session, queue, schedule, om, ui, and skill subcommand families |
+| CLI Management Commands | `sdk/cli-management.mdx` | elevasis-sdk management commands -- project, note, acquisition, client, agent, session, queue, schedule, om, ui, skill, and content subcommand families |
 | CLI Reference | `sdk/cli.mdx` | Core elevasis-sdk CLI commands -- validate, deploy, execute, inspect resources, manage credentials, rename, and enumerate the command catalog |
 | Concepts Reference | `sdk/concepts.mdx` | Plain-English explanations of Elevasis SDK concepts -- glossary, workflow analogies, Zod schemas, execution model, platform tools, and design decisions |
 | When to Reach for the define* Builders | `sdk/define-builders.mdx` | defineWorkflow, defineStep, defineContract, defineResource, and defineTopology exist for two different reasons -- this page teaches which reason applies before you pick a builder over a plain object literal. |

package/reference/_reference-manifest.json

@@ -949,6 +949,16 @@
       "sourcePath": "packages/sdk/docs/agent-rules/deployment.md",
       "referencePath": "rules/deployment.md"
     },
+    {
+      "packageName": "@elevasis/sdk",
+      "title": "Content",
+      "description": "Building the content System behind the shipped pipeline, item, and distribution routes -- which recipe to read, and the catalog vocabulary that is model-owned rather than coded",
+      "group": "Operations",
+      "order": 4,
+      "loadWhen": "Editing anything under `ui/src/routes/content/` -- items, pipelines, distributions, or a review gate.",
+      "sourcePath": "packages/sdk/docs/agent-rules/content.md",
+      "referencePath": "rules/content.md"
+    },
     {
       "packageName": "@elevasis/sdk",
       "title": "Execution Model",
@@ -995,7 +1005,7 @@
       "description": "Organization OS orientation -- what the semantic contract layer is, which surface owns what, and where the full reference docs live; concrete edit rules live in organization-model.md",
       "group": "Orientation",
       "order": 1,
-      "loadWhen": "Before an org-model change, to see how Systems, ontology, resources, policies, and knowledge relate.",
+      "loadWhen": "Before an org-model change, to see how Systems, ontology, resources, roles, and knowledge relate.",
       "sourcePath": "packages/sdk/docs/agent-rules/organization-os.md",
       "referencePath": "rules/organization-os.md"
     },

package/reference/packages/core/src/content/README.md

@@ -1,18 +1,23 @@
 # @elevasis/core/content
 
-Content pipeline API schemas and platform-content typed interfaces. Browser-safe (no Node APIs).
+Content pipeline API schemas, platform-content typed interfaces, and the pure placement helpers the API, the CLI, and the Command Center all share. Browser-safe (no Node APIs).
+
+The helpers live here rather than in `@repo/ui` because they have three consumers and only one of them is a React app. `packages/sdk` has no `@repo/ui` dependency, so a CLI board would have needed its own copy of the placement rule — and two copies of a rule like this diverge. That is not hypothetical: the open-review-gate predicate was inline in the `/queue` handler, was about to be hand-copied into review validation and the review page, and had already produced a live wrong answer before it was consolidated into `review-gates.ts` on 2026-08-15. `derive-board.ts` and `item-identity.ts` moved here the same day for the same reason; `@repo/ui` re-exports both from `features/content/board/`.
 
 ## Surface
 
-| Export                                                                                                                                         | Purpose                                                                                                                                                                 |
-| ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ContentItemResponseSchema`, `CreateContentItemRequestSchema`, `UpdateContentItemRequestSchema`                                                | `content_items` transport shape. `processingState` is intentionally absent from create/update — factory-write-only.                                                     |
-| `ContentProcessingStateSchema`                                                                                                                 | `{ stepKey: { status, data? } }`, keyed by `ContentStepKeySchema` — a content-specific key, not lead-gen's `LeadGenStageKeySchema`.                                     |
-| `ContentPayloadEnvelopeSchema`                                                                                                                 | The producer's immutable emission stored in `payload`. Never edited — `body` is the human's canonical text.                                                             |
-| `ReviewContentItemRequestSchema`                                                                                                               | Approve, or reject with a required `rejectReason`. Writes `reviewed_at` / `reviewed_by`.                                                                                |
-| `ContentItemAttemptResponseSchema`, `CreateContentItemAttemptRequestSchema`                                                                    | `content_item_attempts` transport shape. No `attemptNumber` field on create — the API service assigns it inside the write. `stepKey` is producer-supplied and nullable. |
-| `ContentDistributionResponseSchema`, `CreateContentDistributionRequestSchema`, `UpdateContentDistributionRequestSchema`                        | `content_distributions` transport shape, including the manual-publish fields (`publishMethod`, `platformPostId`, `platformUrl`).                                        |
-| `PlatformContent`, `YouTubeContent`, `LinkedInContent`, `InstagramContent`, `XContent`, `AnyPlatformContent`, `PlatformContentMap`, `Platform` | Typed interfaces for platform-specific content stored in `content_distributions.platform_content`.                                                                      |
+| Export                                                                                                                                         | Purpose                                                                                                                                                                                         |
+| ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ContentItemResponseSchema`, `CreateContentItemRequestSchema`, `UpdateContentItemRequestSchema`                                                | `content_items` transport shape. `processingState` is intentionally absent from create/update — factory-write-only.                                                                             |
+| `ContentProcessingStateSchema`                                                                                                                 | `{ stepKey: { status, data? } }`, keyed by `ContentStepKeySchema` — a content-specific key, not lead-gen's `LeadGenStageKeySchema`.                                                             |
+| `ContentPayloadEnvelopeSchema`                                                                                                                 | The producer's immutable emission stored in `payload`. Never edited — `body` is the human's canonical text.                                                                                     |
+| `ReviewContentItemRequestSchema`                                                                                                               | Approve, or reject with a required `rejectReason`. Writes `reviewed_at` / `reviewed_by`.                                                                                                        |
+| `ContentItemAttemptResponseSchema`, `CreateContentItemAttemptRequestSchema`                                                                    | `content_item_attempts` transport shape. No `attemptNumber` field on create — the API service assigns it inside the write. `stepKey` is producer-supplied and nullable.                         |
+| `ContentDistributionResponseSchema`, `CreateContentDistributionRequestSchema`, `UpdateContentDistributionRequestSchema`                        | `content_distributions` transport shape, including the manual-publish fields (`publishMethod`, `platformPostId`, `platformUrl`).                                                                |
+| `PlatformContent`, `YouTubeContent`, `LinkedInContent`, `InstagramContent`, `XContent`, `AnyPlatformContent`, `PlatformContentMap`, `Platform` | Typed interfaces for platform-specific content stored in `content_distributions.platform_content`.                                                                                              |
+| `isOpenContentReviewGate`, `getOpenContentReviewGates`                                                                                         | The one predicate deciding whether a `processing_state` entry is an open, unreviewed `queued` gate. Consumed by the `/queue` handler, `reviewItem`'s `stepKey` validation, and the review page. |
+| `deriveContentBoard`, `ContentBoard`, `ContentBoardCard`, `ContentBoardColumn`, `ContentBoardGate`                                             | Placement: `(items, pipeline, now)` to columns, gates, waiting counts, plus the `done` and `unplaced` buckets. Pure. Consumed by the Command Center board and `elevasis-sdk content:board`.     |
+| `getContentItemIdentity`                                                                                                                       | Names an item for display when `title` cannot — first non-blank line of `body`, then the first string payload field, then `title`, then `'Untitled'`.                                           |
 
 ## Step catalog reconciliation