@elevasis/sdk 1.44.2 → 1.45.0

package/reference/claude-config/hooks/tool-failure-recovery.mjs

@@ -1,73 +0,0 @@
-#!/usr/bin/env node
-// tool-failure-recovery.mjs
-// PostToolUseFailure hook — pattern-matches known Bash errors and returns
-// recovery advice via stderr + exit 2 (feedback to Claude).
-
-const RECOVERY_TABLE = [
-  {
-    test: (r) => /JavaScript heap out of memory/i.test(r),
-    advice: 'Out of memory.',
-    fix: 'Run the command with NODE_OPTIONS="--max-old-space-size=4096".',
-    why: 'Large TypeScript projects can exceed Node default heap limit.'
-  },
-  {
-    test: (r) => /ENOENT/.test(r) && /node_modules/.test(r),
-    advice: 'Missing node_modules dependency.',
-    fix: 'Run: pnpm install',
-    why: 'Dependencies are not installed or were cleared.'
-  },
-  {
-    test: (r) => /ERR_MODULE_NOT_FOUND/.test(r),
-    advice: 'Module not found at import path.',
-    fix: 'Check the import path and verify the package is installed (pnpm install).',
-    why: 'The import path does not match any installed package or local file.'
-  },
-  {
-    test: (r) => /TS2307/.test(r) || (/cannot find/i.test(r) && /declaration/i.test(r)),
-    advice: 'TypeScript cannot resolve module or declaration file.',
-    fix: 'Check that the package is installed and tsconfig paths are correct.',
-    why: 'Missing dependency or incorrect TypeScript configuration.'
-  },
-  {
-    test: (r) => /EPERM/.test(r) || /permission denied/i.test(r),
-    advice: 'Permission denied (EPERM).',
-    fix: 'Close the file in any other process (editor, terminal, or dev server) and retry.',
-    why: 'On Windows, files locked by another process cannot be written to.'
-  },
-  {
-    test: (r) => /lockfile/i.test(r) && /conflict|outdated|ERR_PNPM/i.test(r),
-    advice: 'pnpm lockfile conflict or outdated.',
-    fix: 'Run: pnpm install to regenerate the lockfile.',
-    why: 'The lockfile is out of sync with package.json changes.'
-  },
-  {
-    test: (r) => /EADDRINUSE/.test(r),
-    advice: 'Port already in use.',
-    fix: 'Find and kill the process using the port, or use a different port.',
-    why: 'A previous dev server or process is still holding the port.'
-  }
-]
-
-function formatRecovery(entry) {
-  let msg = 'FAILED: ' + entry.advice + '\nFIX: ' + entry.fix
-  if (entry.why) msg += '\nWHY: ' + entry.why
-  if (entry.see) msg += '\nSEE: ' + entry.see
-  return msg
-}
-
-try {
-  const chunks = []
-  for await (const chunk of process.stdin) chunks.push(chunk)
-  const input = JSON.parse(Buffer.concat(chunks).toString())
-
-  const response = input.tool_response ?? ''
-
-  for (const entry of RECOVERY_TABLE) {
-    if (entry.test(response)) {
-      process.stderr.write(formatRecovery(entry))
-      process.exit(2)
-    }
-  }
-} catch {}
-
-process.exit(0)

package/reference/claude-config/registries/graph-skills.json

@@ -1,4 +0,0 @@
-{
-  "generatedBy": "generate-knowledge-nodes",
-  "domains": {}
-}

package/reference/claude-config/registries/knowledge-flags.json

@@ -1,154 +0,0 @@
-{
-  "generatedBy": "generate-knowledge-nodes",
-  "routingMode": "deterministic-keyword",
-  "flags": {
-    "--kind-playbook": {
-      "flag": "--kind-playbook",
-      "label": "Kind Playbook",
-      "kind": "playbook",
-      "tags": [
-        "browser",
-        "delete",
-        "dev",
-        "first",
-        "knowledge",
-        "mdx",
-        "node",
-        "playbook",
-        "proves",
-        "rewrite",
-        "start",
-        "starter",
-        "welcome",
-        "welcome-mdx",
-        "wiring",
-        "works"
-      ],
-      "queryTerms": [
-        "2026",
-        "2026-05-04",
-        "anywhere",
-        "appear",
-        "browser",
-        "codegen",
-        "config",
-        "core",
-        "delete",
-        "each",
-        "file",
-        "kind",
-        "knowledge",
-        "mdx",
-        "node",
-        "nodes",
-        "playbook",
-        "reference",
-        "starter",
-        "strategy",
-        "string",
-        "title",
-        "welcome",
-        "welcome-mdx"
-      ],
-      "cliBindings": [
-        {
-          "command": "pnpm exec elevasis-sdk knowledge:cat knowledge.welcome",
-          "description": "Read Welcome to the Knowledge Browser"
-        },
-        {
-          "command": "pnpm exec elevasis-sdk knowledge:ls /by-kind/playbook",
-          "description": "List playbook knowledge nodes"
-        }
-      ],
-      "nodes": [
-        {
-          "id": "knowledge.welcome",
-          "title": "Welcome to the Knowledge Browser",
-          "kind": "playbook",
-          "sourcePath": "welcome.mdx",
-          "tags": [
-            "browser",
-            "delete",
-            "dev",
-            "first",
-            "knowledge",
-            "mdx",
-            "node",
-            "playbook",
-            "proves",
-            "rewrite",
-            "start",
-            "starter",
-            "welcome",
-            "welcome-mdx",
-            "wiring",
-            "works"
-          ],
-          "routingTerms": [
-            "knowledge",
-            "nodes",
-            "browser",
-            "mdx",
-            "welcome",
-            "file",
-            "node",
-            "playbook",
-            "codegen",
-            "config",
-            "core",
-            "delete",
-            "each",
-            "kind",
-            "reference",
-            "starter",
-            "strategy",
-            "string",
-            "title",
-            "welcome-mdx",
-            "2026",
-            "2026-05-04",
-            "anywhere",
-            "appear"
-          ],
-          "links": [],
-          "cliBindings": [
-            {
-              "command": "pnpm exec elevasis-sdk knowledge:cat knowledge.welcome",
-              "description": "Read Welcome to the Knowledge Browser"
-            },
-            {
-              "command": "pnpm exec elevasis-sdk knowledge:ls /by-kind/playbook",
-              "description": "List playbook knowledge nodes"
-            }
-          ]
-        }
-      ]
-    }
-  },
-  "aliases": {
-    "2026": "--kind-playbook",
-    "2026-05-04": "--kind-playbook",
-    "anywhere": "--kind-playbook",
-    "appear": "--kind-playbook",
-    "browser": "--kind-playbook",
-    "codegen": "--kind-playbook",
-    "config": "--kind-playbook",
-    "core": "--kind-playbook",
-    "delete": "--kind-playbook",
-    "dev": "--kind-playbook",
-    "each": "--kind-playbook",
-    "file": "--kind-playbook",
-    "first": "--kind-playbook",
-    "kind": "--kind-playbook",
-    "kind playbook": "--kind-playbook",
-    "kind-playbook": "--kind-playbook",
-    "knowledge": "--kind-playbook",
-    "mdx": "--kind-playbook",
-    "node": "--kind-playbook",
-    "playbook": "--kind-playbook",
-    "proves": "--kind-playbook",
-    "rewrite": "--kind-playbook",
-    "start": "--kind-playbook",
-    "starter": "--kind-playbook"
-  }
-}

package/reference/claude-config/registries/skill-coverage.json

@@ -1,20 +0,0 @@
-{
-  "skills": {
-    "project": { "domains": ["project"] },
-    "elevasis": { "domains": ["platform"] },
-    "om": { "domains": ["knowledge", "om"] },
-    "submit-request": { "domains": ["request"] },
-    "client": { "domains": ["client"] }
-  },
-  "waived": {
-    "acquisition": "read-only, surfaced via lead-gen UI",
-    "agent": "operator-facing deployed-agent introspection",
-    "session": "operator-facing session introspection",
-    "queue": "HITL approval queue — surfaced in the UI",
-    "grant": "operator-facing public agent access management",
-    "schedule": "operator-facing scheduler control",
-    "note": "CLI-only in tenant context; /notes is monorepo-internal, not propagated",
-    "ui": "infra-only dev toggle (ui:use-local / ui:use-published)",
-    "skill": "SDK meta-tooling (skill:scaffold, skill:check-coverage) — developer-facing build utilities, not agent-facing workflow commands"
-  }
-}

package/reference/claude-config/rules/active-change-index.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Active Change Index rule bundled with @elevasis/sdk
----
-
-# Active Change Index
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/active-change-index.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/active-change-index.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/active-change-index.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/agent-start-here.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Agent Start Here rule bundled with @elevasis/sdk
----
-
-# Agent Start Here
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/agent-start-here.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/agent-start-here.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/agent-start-here.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/deployment.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Deployment rule bundled with @elevasis/sdk
----
-
-# Deployment
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/deployment.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/deployment.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/deployment.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/error-handling.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Error Handling rule bundled with @elevasis/sdk
----
-
-# Error Handling
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/error-handling.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/error-handling.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/error-handling.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/execution.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Execution rule bundled with @elevasis/sdk
----
-
-# Execution
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/execution.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/execution.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/execution.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/frontend.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Frontend rule bundled with @elevasis/sdk
----
-
-# Frontend
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/frontend.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/frontend.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/frontend.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/observability.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Observability rule bundled with @elevasis/sdk
----
-
-# Observability
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/observability.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/observability.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/observability.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/operations.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Operations rule bundled with @elevasis/sdk
----
-
-# Operations
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/operations.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/operations.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/operations.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/organization-model.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Organization Model rule bundled with @elevasis/sdk
----
-
-# Organization Model
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/organization-model.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/organization-model.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/organization-model.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/organization-os.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Organization Os rule bundled with @elevasis/sdk
----
-
-# Organization Os
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/organization-os.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/organization-os.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/organization-os.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/package-taxonomy.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Package Taxonomy rule bundled with @elevasis/sdk
----
-
-# Package Taxonomy
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/package-taxonomy.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/package-taxonomy.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/package-taxonomy.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/platform.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Platform rule bundled with @elevasis/sdk
----
-
-# Platform
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/platform.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/platform.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/platform.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/shared-types.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Shared Types rule bundled with @elevasis/sdk
----
-
-# Shared Types
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/shared-types.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/shared-types.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/shared-types.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/task-tracking.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Task Tracking rule bundled with @elevasis/sdk
----
-
-# Task Tracking
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/task-tracking.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/task-tracking.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/task-tracking.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.

package/reference/claude-config/rules/topbar-actions.md

@@ -1,70 +0,0 @@
----
-description: OM-declared topbar actions — navigation.topbar field and TOPBAR_ACTION_MANIFESTS registry pattern
-paths:
-  - ui/src/lib/components/AppTopbar*
-  - ui/src/routes/__root*
-  - core/config/organization-model/**
----
-
-# Topbar Actions (Template Mirror Discipline — Tier 1 Note)
-
-> **Scope:** This note documents substrate that has landed in the monorepo but is not yet published
-> to `@elevasis/sdk/reference/rules/`. It will be superseded by the bundled rule once the
-> `@elevasis/ui` minor that carries the topbar substrate ships. Until then, use this file.
-
-## navigation.topbar OM Field
-
-The Organization Model now has a `navigation.topbar` region for declaring topbar action items.
-Each entry is a distinct node type — OM owns data and visibility; a registry binds behavior.
-
-```ts
-// core/config/organization-model.ts (navigation section)
-navigation: {
-  topbar: {
-    request: {
-      id: 'request',
-      label: 'Request a feature or report an issue',
-      tooltip: 'Request a feature or report an issue',
-      icon: 'message-plus',
-      order: 10,
-      enabled: true
-    }
-  }
-}
-```
-
-Topbar items are toggled via `/org-os manage` exactly like sidebar surfaces. The `surfaceType`
-enum (`page | dashboard | list | detail | graph | settings`) does NOT apply to topbar items —
-they are a separate node type, not surfaces.
-
-## TOPBAR_ACTION_MANIFESTS Registry
-
-Behavior for each `navigation.topbar` key is bound through a manifest registry in
-`@elevasis/ui`. Each manifest maps a key to a render function:
-
-```ts
-// Registered in packages/ui/src/features/registry/manifests.ts
-TOPBAR_ACTION_MANIFESTS = {
-  request: requestTopbarActionManifest
-}
-```
-
-The `requestTopbarActionManifest` renders `<RequestActionIcon />` from
-`@elevasis/ui/features/monitoring/requests`. It owns its own disclosure state and modal —
-no wiring needed at the call site.
-
-## Template Authoring (Tier 2 — Post-Publish)
-
-Declaring `navigation.topbar.request` in the template OM and rendering `<TopbarActions />`
-in `AppTopbar` is **Tier 2 post-publish authoring** — it runs after the `@elevasis/ui` minor
-bump lands in `external/_template`. Do NOT edit `core/config/organization-model/**` for this
-until the publish + baseline bump step completes.
-
-The requests-page `RequestButton` (entry point C) is a CC-level app-local addition in the
-platform `apps/command-center` routes. Template projects add their own equivalent in
-`ui/src/routes/monitoring/requests.index.tsx` after the surface is present in their navigation.
-
-## Related Rules
-
-- `operations/node_modules/@elevasis/sdk/reference/rules/organization-model.md` — OM schema and authoring ceremony
-- `operations/node_modules/@elevasis/sdk/reference/rules/organization-os.md` — `/org-os manage` toggle surface

package/reference/claude-config/rules/ui.md

@@ -1,22 +0,0 @@
----
-description: Compatibility pointer for the canonical Ui rule bundled with @elevasis/sdk
----
-
-# Ui
-
-Canonical rule source:
-
-`operations/node_modules/@elevasis/sdk/reference/rules/ui.md`
-
-When working in the monorepo template snapshot before dependencies are installed,
-use the repo-local generated fallback:
-
-`packages/sdk/reference/rules/ui.md`
-
-If the generated fallback is stale or missing, use the source:
-
-`packages/sdk/docs/agent-rules/ui.md`
-
-Read the bundled rule first when available. This local file is intentionally kept
-as a thin compatibility pointer for existing local rule references in skills,
-sync notes, and older prompts.