@elevasis/sdk 1.45.0 → 1.46.0

package/reference/sdk/cli-management.mdx

@@ -5,6 +5,8 @@ description: elevasis-sdk management commands -- project, note, acquisition, cli
 
 This page covers the domain management commands for `elevasis-sdk`. For core SDK commands (check, deploy, exec, resources, executions, describe, creds, rename), see [CLI Reference](cli.mdx).
 
+Every command family on this page -- `project`, `note`, `acquisition`, `client`, `agent`, `session`, `queue`, `schedule`, `om:doctor`, and `request` -- also accepts `--prod` to target production, overriding `NODE_ENV=development` (live as of `@elevasis/sdk` 1.45.0). See [CLI Reference's Global Flags](cli.mdx#global-flags) for the full description; per-command flag tables below list `--api-url` and other command-specific flags only, not `--prod` or `--json`.
+
 ---
 
 ## JSON-valued options
@@ -94,10 +96,16 @@ elevasis-sdk project:task:get <id>
 elevasis-sdk project:task:create --project <id> --title "Implement API"
 elevasis-sdk project:task:create --project <id> --title "Implement API" --checklist @json:tmp/task-checklist.json
 elevasis-sdk project:task:update <id> --status in_progress
+elevasis-sdk project:task:update <id> --parent <parent-task-id>
+elevasis-sdk project:task:update <id> --clear-milestone
 elevasis-sdk project:task:update <id> --checklist @json:tmp/task-checklist.json
 elevasis-sdk project:task:delete <id>
 ```
 
+`milestone_id` and `parent_task_id` are nullable, and `--clear-milestone` / `--clear-parent` are how they are set to null. Each is mutually exclusive with its set-flag and exits `CONFLICTING_FLAGS` if both are passed, matching `project:update --client` / `--clear-client`. An empty string does **not** clear either one -- `--milestone ""` fails UUID validation rather than detaching.
+
+`--sequence <n>` on `project:milestone:create` and `project:milestone:update` writes the display order that `project:milestone:list` sorts by. It takes a non-negative integer and rejects anything else with `INVALID_SEQUENCE` before the request is sent.
+
 Task commands also expose agent-oriented resume state:
 
 ```bash
@@ -186,9 +194,9 @@ elevasis-sdk request:get <id>
 
 Most `project:*` commands support:
 
-| Flag              | Description                                        |
-| ----------------- | -------------------------------------------------- |
-| `--pretty`        | Human-readable terminal output instead of raw JSON |
+| Flag                | Description                                        |
+| ------------------- | -------------------------------------------------- |
+| `--pretty`          | Human-readable terminal output instead of raw JSON |
 | `--api-url <url>` | Override the API base URL                          |
 
 For exact required flags and accepted enum values, see the command source under `packages/sdk/src/cli/commands/project/`.
@@ -667,13 +675,14 @@ At least one field must be provided. `--description` and `--clear-description` a
 
 ## elevasis-sdk om:\*
 
-Knowledge map inspection. The `om:*` (Organization Model) commands expose knowledge graph traversal via the CLI. `om:*` and `knowledge:*` are aliases of the same subcommands.
+Knowledge graph inspection, plus an Organization Model write surface (`om:scaffold:*`, `om:rename`, `om:deprecate`). The `om:*` (Organization Model) commands expose knowledge graph traversal via the CLI. `om:*` and `knowledge:*` are aliases of the same subcommands for the read-only surface described below -- the write commands are registered under `om:*` only, with no `knowledge:*` alias.
 
 **Path axes for `knowledge:ls` / `om:ls`:** `/by-system/<id>`, `/by-ontology/<ontologyId>`, `/by-kind/<kind>`, `/by-owner/<ownerId>`, `/by-domain/<domain>` (enumerate all items in a domain: `clients`, `roles`, `policies`, `customers`, `offerings`, `goals`), `/by-item/<domain>/<itemId>` (single domain-item profile), `/graph/<nodeId>/governs`, `/graph/<nodeId>/governed-by`, `/<nodeId>` (single node), `/all-systems`, `/all-resources`, `/all-roles`.
 
 - `knowledge:ls <path>` -- list nodes/edges for the mount; default output is an id + summary table, `--json` returns `{ path, mount, args, results }`.
 - `knowledge:cat <id>` -- render a node's `body` MDX to stdout; `--json` returns the full node object (body, links, owners, timestamps).
 - `knowledge:graph <id>` -- show outgoing + incoming edges grouped by edge kind.
+- `om:doctor` -- validate Organization Model integrity against published `@elevasis/core/organization-model` primitives. This is a deliberately reduced 3-check command: two of the monorepo platform CLI's five checks assert monorepo-only paths that do not exist in a tenant project, so they are not ported. `--json` output includes `checksRun: 3` so a caller can tell it apart from the platform CLI's 5-check version.
 
 In tenant projects, SDK read commands load `core/config/organization-model.ts` through the SDK's layout-aware TypeScript loader. The temporary bundle and dependency resolution are anchored at the package root that owns SDK dependencies, so hoisted pnpm workspaces resolve `esbuild` and `@elevasis/core` correctly. Missing org-model files still return the default model; malformed files or files with no usable export emit diagnostics. `knowledge:generate` / `om:generate` is the exception because it reads MDX and codegen inputs directly.
 
@@ -687,6 +696,7 @@ elevasis-sdk knowledge:search <query>
 elevasis-sdk knowledge:describe <nodeId>
 elevasis-sdk knowledge:skills <nodeId>
 elevasis-sdk knowledge:generate
+elevasis-sdk om:doctor --org <OrgName>
 ```
 
 These are registered as `knowledge:*` subcommands on `elevasis-sdk`. Both the SDK CLI (`elevasis-sdk knowledge:*`) and the platform CLI (`elevasis knowledge:*`) call the same query functions in `@repo/core/knowledge/queries`.
@@ -763,6 +773,81 @@ elevasis-sdk knowledge:generate [--source <path>] [--output <path>] [--flags-out
 elevasis-sdk om:generate
 ```
 
+### om:scaffold:\*
+
+Six scaffolders that splice new Organization Model entries into project source files: `om:scaffold:system`, `om:scaffold:resource`, `om:scaffold:role`, `om:scaffold:knowledge`, `om:scaffold:ontology`, `om:scaffold:fill`. There is no `knowledge:scaffold:*` alias.
+
+```bash
+elevasis-sdk om:scaffold:system --id sales.pipeline --title "Sales Pipeline" --kind operational
+elevasis-sdk om:scaffold:resource --id lead-discovery-workflow --system-path sales.pipeline --title "Lead Discovery"
+elevasis-sdk om:scaffold:role --id ops-lead --title "Ops Lead" --responsibility "Own weekly pipeline review"
+elevasis-sdk om:scaffold:knowledge --id outreach-playbook --kind playbook --system-path sales.pipeline
+elevasis-sdk om:scaffold:ontology --id deal --system-path sales.pipeline --kind object
+elevasis-sdk om:scaffold:fill --gaps tmp/conformance-gaps.json
+```
+
+**Default is dry-run.** Every `om:scaffold:*` command previews its change and writes nothing unless `--write` is passed (the one exception, `om:scaffold:ontology`, never writes at all -- see below). This inverted from earlier behavior, where these commands applied by default. An existing invocation that does not pass `--write` now only previews and silently stops applying -- this is the single most important thing to know about this command family.
+
+**`--dry-run` is not a flag on any `om:scaffold:*` command.** It exists only as a deprecated programmatic/TypeScript option consumed internally by the handler functions; passing `--dry-run` on the command line is an unrecognized-option error. `om:rename` and `om:deprecate`, documented in the next section, are different commands with their own real `--dry-run` flag -- do not carry that convention over here.
+
+**Splice targets:**
+
+| Subcommand              | Writes                                                                                                                                    |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `om:scaffold:system`    | Splices `core/config/organization-model/systems.ts`                                                                                       |
+| `om:scaffold:resource`  | Splices `core/config/organization-model/systems.ts` -- **known-broken, see below**                                                        |
+| `om:scaffold:role`      | Splices `core/config/organization-model/profile.ts`                                                                                       |
+| `om:scaffold:knowledge` | Writes a new `core/config/knowledge/nodes/<id>.mdx` file (no splice)                                                                    |
+| `om:scaffold:ontology`  | Print-only by design -- writes nothing, and carries no `--write` flag                                                                     |
+| `om:scaffold:fill`      | Writes new `core/config/organization-model/api-interfaces/<systemPath>.ts` const files and splices the import + field into `systems.ts` |
+
+**`om:scaffold:resource` is currently non-functional against all three real project layouts.** Its splice anchor never received the anchor-scoping fix that landed for `om:scaffold:role` on 2026-08-11, so it still searches for the resource-descriptors closing brace unscoped -- in a real file that closing-brace shape recurs, and it splices into the wrong one, producing invalid TypeScript. The command's own post-write validation catches this and rolls the file back, so it fails safely, but it does not currently produce a usable result. Do not rely on it until the anchor fix ships.
+
+**Common flag:**
+
+| Flag      | Description                                                                  |
+| --------- | ---------------------------------------------------------------------------- |
+| `--write` | Apply the change. Default (omitted) is a dry-run preview -- no files written |
+
+`om:scaffold:ontology` has no `--write` flag; it is always print-only. Each subcommand also has its own identifying flags (`--id`, `--title`, `--system-path`, and so on) -- omit any of them to be prompted interactively. `om:scaffold:fill` is the exception: it is non-interactive and requires `--gaps <path>` pointing at a conformance-gap JSON file.
+
+### om:rename / om:deprecate
+
+Plan or apply an Organization Model system rename cascade, or a lifecycle transition (deprecate/archive). Neither has a `knowledge:*` alias.
+
+```bash
+elevasis-sdk om:rename sales.crm sales.pipeline
+elevasis-sdk om:rename sales.crm sales.pipeline --write
+
+elevasis-sdk om:deprecate sales.crm --to deprecated
+elevasis-sdk om:deprecate sales.crm --to archived --force --confirm archive:sales.crm --write
+```
+
+**Unlike `om:scaffold:*`, both commands default to preview via a real `--dry-run` flag, not the absence of `--write`.** `--write` applies the edit, regenerates knowledge nodes when needed, and runs `om:doctor`. The two conventions on this page name their default state differently -- `om:scaffold:*` has no flag describing its default at all, while `om:rename` / `om:deprecate` spell it out with `--dry-run` -- so do not assume one family's flag shape from the other.
+
+`om:rename` cannot re-parent a system: root-to-nested or nested-to-root moves must be done by hand.
+
+**`om:rename <oldPath> <newPath>` flags:**
+
+| Flag        | Description                                                              |
+| ----------- | ------------------------------------------------------------------------ |
+| `--dry-run` | Preview only (default)                                                   |
+| `--write`   | Apply edits, regenerate knowledge nodes when needed, and run `om:doctor` |
+| `--json`    | Output JSON                                                              |
+
+**`om:deprecate <systemPath>` flags:**
+
+| Flag                  | Description                                                                |
+| --------------------- | -------------------------------------------------------------------------- |
+| `--to <lifecycle>`  | Target lifecycle: `deprecated` or `archived`. Default: `deprecated`        |
+| `--dry-run`           | Preview only (default)                                                     |
+| `--write`             | Apply the lifecycle edit and run `om:doctor`                               |
+| `--force`             | Allow archiving despite live dependents when paired with exact `--confirm` |
+| `--confirm <token>` | Exact archive confirmation token: `archive:<systemPath>`                   |
+| `--json`              | Output JSON                                                                |
+
+**Implementation:** `packages/sdk/src/cli/commands/om/rename.ts`, `packages/sdk/src/cli/commands/om/deprecate.ts` -- registered in `packages/sdk/src/cli/index.ts`
+
 ---
 
 ## elevasis-sdk ui:use-local / ui:use-published
@@ -840,4 +925,4 @@ A domain should meet all four criteria before gaining a `*:list` / `*:get` surfa
 
 ---
 
-**Last Updated:** 2026-05-19
+**Last Updated:** 2026-08-12

package/reference/sdk/cli.mdx

@@ -39,11 +39,7 @@ elevasis-sdk check
   - Relationship declarations referencing non-existent resources
 - Exits with code 0 on success, code 1 on validation failure
 
-**Flags:**
-
-| Flag                | Description               |
-| ------------------- | ------------------------- |
-| `--api-url <url>` | Override the API base URL |
+`check` declares no `--api-url` flag -- it validates project source locally and never calls the API, so there is no base URL to override.
 
 **Example output (success):**
 
@@ -88,10 +84,10 @@ elevasis-sdk deploy
 
 **Flags:**
 
-| Flag                | Description                                                               |
-| ------------------- | ------------------------------------------------------------------------- |
-| `--api-url <url>` | Override the API base URL (default: production)                           |
-| `--prod`            | Force production target, overriding `NODE_ENV=development` (internal use) |
+| Flag                | Description                                                |
+| ------------------- | ---------------------------------------------------------- |
+| `--api-url <url>` | Override the API base URL (default: production)            |
+| `--prod`            | Force production target, overriding `NODE_ENV=development` |
 
 **Environment variables:**
 
@@ -320,6 +316,84 @@ elevasis-sdk execution onboard-client exec_abc001
 
 ---
 
+## elevasis-sdk execution:cancel
+
+Cancel a running execution.
+
+**Synopsis:**
+
+```
+elevasis-sdk execution:cancel <resourceId> <executionId>
+```
+
+**Behavior:**
+
+- Calls `POST /api/external/executions/:resourceId/:executionId/cancel`
+- The result reports which method was used: an in-memory signal if the execution's worker process is still reachable, or a database fallback if not
+- A 409 response means the execution is not in a running state -- it already finished. That is a normal race, not a command failure
+
+**Flags:**
+
+| Flag                | Description                                          |
+| ------------------- | ---------------------------------------------------- |
+| `--prod`            | Target production (overrides `NODE_ENV=development`) |
+| `--api-url <url>` | Override the API base URL                            |
+| `--json`            | Output raw JSON response                             |
+
+**Example:**
+
+```bash
+elevasis-sdk execution:cancel my-workflow 9c47c944-67eb-4c84-98cb-bb951d05ede3
+```
+
+```
+  Execution cancelled
+    Resource:     my-workflow
+    Execution ID: 9c47c944-67eb-4c84-98cb-bb951d05ede3
+    Method:       in-memory signal
+```
+
+**Implementation:** `packages/sdk/src/cli/commands/execution-cancel.ts`, registered in `packages/sdk/src/cli/index.ts`
+
+---
+
+## elevasis-sdk executions:delete
+
+Delete a resource's execution history (destructive).
+
+**Synopsis:**
+
+```
+elevasis-sdk executions:delete <resourceId> [--force]
+```
+
+**Behavior:**
+
+- Calls `DELETE /api/external/executions/:resourceId`
+- Requires a typed `DELETE` confirmation at an interactive prompt unless `--force` is passed
+- `--resource-status <status>` (`dev` or `prod`) scopes the delete to runs from one deployment lane only
+- `--json` without `--force` is a hard error -- it throws `executions:delete requires --force when --json is set`, because a JSON caller is assumed non-interactive and there is nothing to answer the confirmation prompt
+
+**Flags:**
+
+| Flag                           | Description                                                  |
+| ------------------------------ | ------------------------------------------------------------ |
+| `--prod`                       | Target production (overrides `NODE_ENV=development`)         |
+| `--api-url <url>`            | Override the API base URL                                    |
+| `--resource-status <status>` | Only delete runs from this deployment lane (`dev` | `prod`) |
+| `--force`                      | Skip the typed confirmation prompt                           |
+| `--json`                       | Output raw JSON response                                     |
+
+**Example:**
+
+```bash
+elevasis-sdk executions:delete my-workflow --force
+```
+
+**Implementation:** `packages/sdk/src/cli/commands/executions-delete.ts`, registered in `packages/sdk/src/cli/index.ts`
+
+---
+
 ## elevasis-sdk deployments
 
 List all deployments for your organization.
@@ -541,7 +615,8 @@ elevasis-sdk cli [domain] [--format markdown|json]
 | --------------------- | ----------------------------------------------------------- |
 | `--domain <domain>` | Filter output to one domain (alternative to positional arg) |
 | `--format <format>` | Output format: `markdown` (default) or `json`               |
-| `--api-url <url>`   | Override the API base URL                                   |
+
+`cli` declares no `--api-url` flag -- it walks the locally registered Commander command graph and never calls the API.
 
 **Examples:**
 
@@ -579,7 +654,7 @@ Check that your Elevasis project is correctly configured.
 **Synopsis:**
 
 ```
-elevasis-sdk doctor [--verbose]
+elevasis-sdk doctor [--verbose] [--prod]
 ```
 
 **Behavior:**
@@ -596,6 +671,7 @@ Runs four sequential checks and reports `[OK]` / `[FAIL]` / `[WARN]` for each. E
 | Flag        | Description                                                         |
 | ----------- | ------------------------------------------------------------------- |
 | `--verbose` | Print full paths, response bodies, and error details for each check |
+| `--prod`    | Report against production (overrides `NODE_ENV=development`)        |
 
 **Example output (all passing):**
 
@@ -623,14 +699,15 @@ These flags are accepted by all commands:
 | ------------------- | --------------------------------------------------------------------------------------------------- |
 | `--api-url <url>` | Override the API base URL. Priority: flag > `ELEVASIS_API_URL` env var > `NODE_ENV`-based default |
 | `--json`            | Output raw JSON (available on most commands)                                                        |
+| `--prod`            | Target production, overriding `NODE_ENV=development`                                                |
 
 **API base URL resolution:**
 
 - Production (default): `https://api.elevasis.io`
 - Development (`NODE_ENV=development`): `http://localhost:<port>`
 - Override: set `ELEVASIS_API_URL` or pass `--api-url`
-- Force production: pass `--prod` on `deploy` (overrides `NODE_ENV=development`)
+- Force production: pass `--prod` after the command name on any authenticated command (overrides `NODE_ENV=development`). Live as of `@elevasis/sdk` 1.45.0; `--api-url https://api.elevasis.io` is the equivalent form on older installs.
 
 ---
 
-**Last Updated:** 2026-05-19
+**Last Updated:** 2026-08-12

package/reference/sdk/framework/agent.mdx

@@ -67,6 +67,12 @@ There is no `/meta`, `/docs`, or `/work` skill. The template's own boundary guid
 
 **`/git-sync`** -- Pulls the latest template changes, checks the installed `@elevasis/sdk` version against the declared range, reinstalls if the dependency baseline changed, and runs baseline verification (`ui check-types`, `ui build`, `operations check`, `operations check-types`). It stops after verifying -- it never auto-reconciles template drift or overwrites project-owned files. Release guidance is not delivered here; it ships inside the `@elevasis/sdk` reference bundle, which is always current for your installed version.
 
+On a green verification it also **bumps your app version**. The literal lives in `ui/src/config/app-version.ts` (exported as `APP_VERSION`, consumed by `ui/src/config/app-config.ts` and rendered in the topbar), and the agent picks the segment by judging the whole run: **minor** for new capability or a changed `@elevasis/*` dependency baseline, **patch** for everything else. **Major is never automatic** -- if a run genuinely looks major the report says so and leaves the version alone.
+
+The gate is **outgoing commits**, checked with `git rev-list --count @{u}..HEAD` before the bump commit is written. Nothing deploys off a run with nothing to push, so a pull-only run reports `Version: unchanged (nothing to push)` while a run with local commits and an empty pull does bump. The bump lands as its own `chore(ui): bump app version to x.y.z` commit and is not pushed. It is skipped when there is no upstream, when the pull or verification failed, when the project has no `ui/src/config/app-version.ts`, and inside the template itself.
+
+`app-version.ts` is a separate file from `app-config.ts` deliberately. It is registered `never-touch` / `verify-only`, so the sync engine protects your value; folding it back into `app-config.ts` -- a critical manual-merge surface -- would flag every project as behind the template on every sync for a difference that is working as intended.
+
 **`/tutorial`** -- Persona-aware onboarding; see [Tutorial System](tutorial-system.mdx) for the full lesson breakdown.
 
 ## The Ambient Vibe Layer

package/reference/sdk/platform-tools/adapters-platform.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Platform Adapters"
-description: "Auto-generated table of all 12 platform (singleton, no credential) adapters exported from @elevasis/sdk/worker, derived from static analysis of the adapter source files."
+description: "Auto-generated table of all 14 platform (singleton, no credential) adapters exported from @elevasis/sdk/worker, derived from static analysis of the adapter source files."
 ---
 
 {/* @generated by .claude/_gen/sync-sdk-adapters.ts — DO NOT EDIT */}
@@ -22,3 +22,5 @@ Platform adapters are singletons — import them directly, no credential require
 | Approval | `approval` | `create`, `deleteByMetadata` | Approval — create and manage HITL (human-in-the-loop) tasks. |
 | Execution | `execution` | `trigger`, `triggerAsync` | Execution — trigger other workflows or agents within the same organization. |
 | Email | `email` | `send` | Email — send platform emails (from notifications@elevasis.io) to organization members. |
+| Artifacts | `artifacts` | `listArtifacts`, `createArtifact`, `getActive` | Artifacts — org-scoped governing-document store for rules documents, idea banks, and ICP docs. |
+| Content | `content` | `createItem`, `getItem`, `listItems`, `updateItem`, `createAttempt`, `listAttempts`, `createDistribution`, `updateDistribution` | Content — create and query content_items/content_item_attempts/content_distributions rows for the content pipeline. |

package/reference/ui/exports.mdx

@@ -20,6 +20,7 @@ description: "Auto-generated catalog of all published @elevasis/ui subpath expor
 | `@elevasis/ui/organization` | Organization | Foundation | Published organization shell, store, and helper surface. |
 | `@elevasis/ui/features/auth` | Features Auth | Features | Published auth feature surface for downstream shells. |
 | `@elevasis/ui/features/clients` | Features Clients | Features | Published clients feature surface for downstream shells. |
+| `@elevasis/ui/features/content` | Features Content | Features | Published, data-free content review card surface (ContentReviewCard and its sub-components) for downstream shells. |
 | `@elevasis/ui/features/crm` | Features CRM | Features | Published CRM feature surface for downstream shells. |
 | `@elevasis/ui/features/dashboard` | Features Dashboard | Features | Published dashboard feature surface for downstream shells. |
 | `@elevasis/ui/features/delivery` | Features Delivery | Features | Published delivery feature surface for downstream shells. |