@elevasis/sdk 1.44.3 → 1.46.0

package/dist/types/worker/platform.d.ts

@@ -1,90 +0,0 @@
-/**
- * Platform Tool Proxy (Worker Side)
- *
- * Provides platform.call() for external developers to invoke platform tools
- * from within worker threads. Communicates with the parent process via
- * postMessage() -- the parent dispatches to the real service layer.
- */
-/** Token usage metadata returned for tool calls with cost accounting. */
-interface TokenUsage {
-    inputTokens: number;
-    outputTokens: number;
-    cost?: number;
-    model?: string;
-}
-/** Inbound tool-result from parent */
-export interface ToolCallResponse {
-    type: 'tool-result';
-    id: string;
-    result?: unknown;
-    error?: string;
-    code?: string;
-    usage?: TokenUsage;
-}
-/** Inbound credential-result from parent */
-export interface CredentialResultMessage {
-    type: 'credential-result';
-    id: string;
-    provider?: string;
-    credentials?: Record<string, string>;
-    error?: string;
-    code?: string;
-}
-/** Resolved credential returned by platform.getCredential() */
-export interface PlatformCredential {
-    provider: string;
-    credentials: Record<string, string>;
-}
-export declare class PlatformToolError extends Error {
-    /** ToolingErrorType code from the platform */
-    readonly code: string;
-    /** Whether the error is retryable */
-    readonly retryable: boolean;
-    constructor(message: string, 
-    /** ToolingErrorType code from the platform */
-    code: string, 
-    /** Whether the error is retryable */
-    retryable: boolean);
-}
-/**
- * Handle a tool-result message from the parent process.
- * Called from the parentPort.on('message') handler in index.ts.
- */
-export declare function handleToolResult(msg: ToolCallResponse): void;
-/**
- * Handle a credential-result message from the parent process.
- * Called from the parentPort.on('message') handler in index.ts.
- */
-export declare function handleCredentialResult(msg: CredentialResultMessage): void;
-export declare const platform: {
-    /**
-     * Call a platform tool from the worker thread.
-     *
-     * @param options.tool - Tool name (e.g., 'gmail', 'storage', 'attio')
-     * @param options.method - Method name (e.g., 'sendEmail', 'upload')
-     * @param options.params - Method parameters
-     * @param options.credential - Credential name (required for integration tools)
-     * @returns Promise resolving to the tool result
-     * @throws PlatformToolError on failure (with code and retryable fields)
-     */
-    call(options: {
-        tool: string;
-        method: string;
-        params?: unknown;
-        credential?: string;
-    }): Promise<unknown>;
-    /**
-     * Request raw credential access from the platform.
-     *
-     * This is an explicit opt-in that causes the credential's secret values
-     * to enter worker memory. Use only when you need to initialise a
-     * third-party SDK (e.g. `new Stripe(key)`). Prefer `platform.call()`
-     * with the `http` tool for server-side credential injection.
-     *
-     * @param name - Credential name as configured in the command center
-     * @returns Promise resolving to { provider, credentials }
-     * @throws PlatformToolError on failure (credential not found, raw access denied, etc.)
-     */
-    getCredential(name: string): Promise<PlatformCredential>;
-};
-export {};

package/dist/types/worker/utils.d.ts

@@ -1,9 +0,0 @@
-export type PlatformToolErrorClassification = 'timeout' | 'rate_limit' | 'other';
-export interface ClassifyPlatformToolErrorOptions {
-    timeoutMessages?: readonly string[];
-    rateLimitCodes?: readonly string[];
-    rateLimitMessageCodes?: readonly string[];
-    rateLimitMessageIncludes?: readonly string[];
-}
-export declare function generateHmacToken(secret: string, data: string): string;
-export declare function classifyPlatformToolError(err: unknown, options?: ClassifyPlatformToolErrorOptions): PlatformToolErrorClassification;

package/reference/claude-config/Overview.md

@@ -1,230 +0,0 @@
-# Claude Code Configuration Overview
-
-Start here when working with the Claude agent scaffold for this project.
-This file is a routing map for the skill and rule inventories. For live CLI capability, run `elevasis-sdk cli`.
-
----
-
-## What Lives Here
-
-| Surface | Purpose                       | Source of truth                                          |
-| ------- | ----------------------------- | -------------------------------------------------------- |
-| Skills  | Slash-command entry points    | `.claude/skills/*/SKILL.md`                              |
-| Rules   | Path-scoped operating context | `operations/node_modules/@elevasis/sdk/reference/rules/` |
-| Hooks   | Claude lifecycle automation   | `.claude/hooks/*.mjs`, `.claude/settings.json`           |
-| CLI     | Live command + domain surface | `elevasis-sdk cli` (authoritative, run it)               |
-
-For CLI capability, run `elevasis-sdk cli` — it is the authoritative surface for what commands
-and domains are available.
-
-**This file is template-owned and replaced by sync.** It holds guidance that is true for every
-project built from this template: structure, stack, commands, and the skill surface. Project-specific
-facts (identity, client context, user preferences) live in `CLAUDE.md`, which sync never overwrites.
-Tenant-specific operational quirks live in `OPERATIONS.md`. Do not copy content between them — each
-fact should exist in exactly one of the three, owned by whoever can correct it.
-
----
-
-## Operating Model
-
-This project is skill-first with an always-on ambient vibe layer:
-
-1. Read `operations/node_modules/@elevasis/sdk/reference/rules/agent-start-here.md` — it owns session
-   bootstrap and task-class routing. Then read `CLAUDE.md` for this project's identity and preferences,
-   and `OPERATIONS.md` for tenant-specific quirks that override generic guidance.
-2. Every natural-language message is silently classified into an intent (Capture, Query, Describe,
-   Transition, Navigate, Codify, Toggle, Operate) before the agent responds — no slash command needed.
-   The classifier and intent definitions live in the bundled `vibe.md` rule.
-3. For explicit work, match intent to a skill in `.claude/skills/{name}/SKILL.md`.
-4. Load the relevant bundled rule from `operations/node_modules/@elevasis/sdk/reference/rules/` for the area
-   being changed (the local `.claude/rules/*.md` files are thin pointers to these).
-5. Use `elevasis-sdk cli` for the live command/domain surface — do not answer "what can I do" from memory.
-
----
-
-## Project Structure
-
-```
-├── ui/                  # React frontend app
-├── operations/          # Platform workflows + agents
-├── core/                # Cross-runtime organization model, types, Zod schemas, constants
-├── .claude/             # Claude Code config (this file, skills, hooks)
-├── pnpm-workspace.yaml  # Workspace definition
-└── .env                 # Environment variables
-```
-
-| Resource             | Path                            |
-| -------------------- | ------------------------------- |
-| Source — Routes      | `ui/src/routes/`                |
-| Source — Features    | `ui/src/features/`              |
-| Source — Lib         | `ui/src/lib/`                   |
-| Source — Assets      | `ui/src/assets/`                |
-| Platform — Workflows | `operations/src/`               |
-| Platform — Config    | `operations/elevasis.config.ts` |
-| Core Types           | `core/`                         |
-
-**Standalone repo** — this project is NOT part of the Elevasis monorepo pnpm workspace. Git, gh, and
-CLI commands work directly here (the monorepo boundary hook does not apply).
-
-- Use `pnpm` exclusively — never `npm`
-- Path aliases: `@/*` maps to `ui/src/*`, `@core/*` maps to `core/*`
-- Frontend and platform code are separate runtimes — share only types via `core/`
-- Release-train migration guidance lands in `.claude/sync-notes/`; run `/git-sync` to pull and surface
-  new notes before doing any manual reconciliation
-
----
-
-## Stack
-
-> **Package surface:** this project consumes `@elevasis/{sdk,ui,core}` from npm. The monorepo's
-> workspace-internal `@repo/elevasis-{core,operations}` packages are NOT installable here. See the
-> bundled `package-taxonomy.md` rule.
-
-### Frontend (`ui/`)
-
-| Layer        | Tech                                |
-| ------------ | ----------------------------------- |
-| UI           | React 19 + Mantine 8.2.7            |
-| Build        | Vite 8                              |
-| Language     | TypeScript 5.9 (strict)             |
-| Routing      | TanStack Router (file-based)        |
-| Server State | TanStack React Query                |
-| Client State | Zustand + Immer                     |
-| Charts       | Recharts via @mantine/charts        |
-| Graph Viz    | @xyflow/react (ReactFlow)           |
-| Icons        | @tabler/icons-react                 |
-| Testing      | Vitest                              |
-| Auth         | @elevasis/ui + AuthKit (WorkOS)     |
-| API Access   | `@elevasis/ui/api` (`useApiClient`) |
-
-### Platform (`operations/`)
-
-| Layer    | Tech                                              |
-| -------- | ------------------------------------------------- |
-| SDK      | @elevasis/sdk (workflows, agents, typed adapters) |
-| Language | TypeScript (strict, Node target)                  |
-| Schemas  | Zod                                               |
-| Deploy   | Elevasis Platform — see bundled `deployment.md`   |
-
-### Core (`core/`)
-
-Types and constants shared between frontend and platform workflows. Runtime-agnostic only — no
-React, no Node APIs, no SDK worker imports.
-
----
-
-## Commands
-
-| Command                          | Purpose                                                       |
-| -------------------------------- | ------------------------------------------------------------- |
-| `pnpm -C ui dev`                 | Dev server (port 4300, `strictPort` — fails fast if occupied) |
-| `pnpm -C ui build`               | Type-check + production build                                 |
-| `pnpm -C ui test`                | Run frontend tests                                            |
-| `pnpm -C ui lint`                | Type-check only (no emit)                                     |
-| `pnpm -C operations check`       | Validate SDK resource definitions                             |
-| `pnpm -C operations deploy`      | Deploy resources — **targets production by default**          |
-| `pnpm -C operations deploy:prod` | Deploy resources to production (explicit `--prod`)            |
-
-> **Deploy targets are safety-critical and the resolution order has exceptions.** The authoritative
-> rule is the bundled `deployment.md`, which ships with the CLI version this project actually runs.
-> Read it before deploying — and check `OPERATIONS.md`, which records whether this specific tenant
-> has a working dev target at all.
-
----
-
-## Skills
-
-**Location:** `.claude/skills/`
-
-Skills are the slash-command surface. Each skill is `.claude/skills/{name}/SKILL.md`:
-
-<!-- @generated:start:sync-overview-skills -->
-- **client** -- Client portfolio management -- list, resolve, inspect, and maintain client records and their lineage to companies, contacts, and source deals -- via the elevasis-sdk client:* CLI.
-- **deploy** -- Test, build, fix issues, then commit and push
-- **dsp** -- Dispatch subagents in parallel for implementation tasks
-- **elevasis** -- Elevasis platform operations -- check, deploy, execute, inspect, and debug SDK resources
-- **explore** -- Codebase exploration anchored to project documentation
-- **git-sync** -- Pull latest changes, surface new sync notes, install when needed, and run baseline verification without auto-reconciling template drift
-- **om** -- TRIGGER this skill when any of the following apply: - The user references organization-model entities by name or concept: identity, customers, offerings, roles, goals, techStack, systems, actions, labels, knowledge nodes, governance edges, mounts, playbook, outreach cadence, or any domain in the org model. - The user asks to read, list, find, show, query, navigate, describe, codify, add, edit, update, toggle, enable, or disable any organization-model domain or knowledge node. - The user asks "what governs X?", "what does X control?", "system governs", "what is our identity set to?", "what's our timezone?", "show me all reference docs", "list my roles", "where does outreach-cadence apply?", or similar. - An agent is editing files matching: core/config/organization-model.ts, core/config/organization-model/**, or core/config/knowledge/**. SKIP this skill when the task is purely UI layout, workflow authoring, or infrastructure work with no reference to org-model or knowledge-graph entities.
-- **project** -- Portfolio- and project-level work management -- orientation, intent routing, active projects, milestones, tasks, notes, and resume context -- via the elevasis-sdk project:* CLI.
-- **run-ui** -- Start the project's Vite UI dev server on port 4300 in the background, surfacing the URL once it's ready. Detects port conflicts and asks before killing the holder.
-- **save** -- Auto-manage project documentation and persist task resume context from conversation
-- **setup** -- First-time project setup — detect and replace template placeholders, install dependencies, verify build, then hand off to /om for org-model configuration
-- **status** -- Quick project health check
-- **submit-request** -- Submit a structured request report to the Elevasis platform via CLI — enforces pre-analysis before posting
-- **sync** -- Fresh reinstall and cache reset after local dependency or cache drift
-- **tutorial** -- Persona-aware onboarding tutorial that forks into a vibe-coder track (zero technical vocabulary, agent does all the work) or a technical track (full SDK depth, code-first). On first invocation, asks one gate question to determine the user's track and persists the choice to .claude/memory/profile.md. Subsequent invocations skip the question and display the track menu with current progress markers. Supports /tutorial switch (flip track) and /tutorial status (display-only).
-<!-- @generated:end:sync-overview-skills -->
-
----
-
-## Rules
-
-**Location:** `operations/node_modules/@elevasis/sdk/reference/rules/` (bundled with `@elevasis/sdk`)
-
-Path-scoped operating context loaded for substantial work in their areas. The project's local
-`.claude/rules/*.md` files are thin compatibility pointers; the authoritative content ships with
-the SDK and is listed here:
-
-<!-- @generated:start:sync-overview-rules -->
-- `operations/node_modules/@elevasis/sdk/reference/rules/active-change-index.md` -- Bridge between stable scaffold docs and higher-volatility in-progress architecture work that may override assumptions for agents working in the template
-- `operations/node_modules/@elevasis/sdk/reference/rules/agent-start-here.md` -- Canonical first-read for agents entering the template scaffold -- project continuity, task-class routing, and boundary resolution
-- `operations/node_modules/@elevasis/sdk/reference/rules/deployment.md` -- Deployment workflow -- check-first, dev vs prod, version bumping, common errors
-- `operations/node_modules/@elevasis/sdk/reference/rules/error-handling.md` -- Error handling -- ExecutionError vs PlatformToolError, retry logic, no auto-retry
-- `operations/node_modules/@elevasis/sdk/reference/rules/execution.md` -- Execution model -- timeouts, memory, concurrency, org isolation, runtime constraints
-- `operations/node_modules/@elevasis/sdk/reference/rules/frontend.md` -- Frontend conventions -- React, routing, state, styling, testing, pages
-- `operations/node_modules/@elevasis/sdk/reference/rules/observability.md` -- Observability -- context.logger API, execution inspection, step-level context
-- `operations/node_modules/@elevasis/sdk/reference/rules/operations.md` -- Platform workflows, agents, resource definitions, and deployment for the operations/ surface
-- `operations/node_modules/@elevasis/sdk/reference/rules/organization-model.md` -- Edits to the canonical organization model go through /om
-- `operations/node_modules/@elevasis/sdk/reference/rules/organization-os.md` -- Organization OS orientation -- the semantic contract layer relating Systems, Actions, ontology, resources, policies, roles, goals, and knowledge; consumed via published @elevasis/core / @elevasis/sdk
-- `operations/node_modules/@elevasis/sdk/reference/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
-- `operations/node_modules/@elevasis/sdk/reference/rules/platform.md` -- Platform conventions -- SDK workflows, agents, deployment, resource registry
-- `operations/node_modules/@elevasis/sdk/reference/rules/shared-types.md` -- Core type boundary -- what belongs in core/types, import rules, schema conventions
-- `operations/node_modules/@elevasis/sdk/reference/rules/task-tracking.md` -- In-progress task conventions -- doc format, status values, auto-save behavior
-- `operations/node_modules/@elevasis/sdk/reference/rules/ui.md` -- UI shell, route structure, auth flow, API access, and template customization points for the ui/ surface
-- `operations/node_modules/@elevasis/sdk/reference/rules/vibe.md` -- Ambient intent classifier -- routes natural-language input to intent buckets without a slash command; Codify and Toggle delegate to /om, Operate delegates to /elevasis
-<!-- @generated:end:sync-overview-rules -->
-
----
-
-## Skill Boundaries
-
-Use the owning skill instead of guessing from the name alone:
-
-| Need                                                     | Route             |
-| -------------------------------------------------------- | ----------------- |
-| SDK operations (check, deploy, exec, inspect, debug)     | `/elevasis`       |
-| Project and task lifecycle                               | `/project`        |
-| Client portfolio (list, resolve, inspect, maintain)      | `/client`         |
-| Organization Model read, codify, or governance           | `/om`             |
-| First-time project setup (placeholder replacement, deps) | `/setup`          |
-| Guided onboarding walkthrough                            | `/tutorial`       |
-| Conversation fanout (notes, task save, blockers)         | `/save`           |
-| Parallel agent dispatch                                  | `/dsp`            |
-| Test, build, commit, push                                | `/deploy`         |
-| Codebase exploration                                     | `/explore`        |
-| Pull latest, surface sync notes, baseline verify         | `/git-sync`       |
-| Project health check                                     | `/status`         |
-| Submit a request to the Elevasis team                    | `/submit-request` |
-| Fresh reinstall / cache reset                            | `/sync`           |
-| Start the Vite dev server on port 4300                   | `/run-ui`         |
-
----
-
-## Scaffold Maintenance
-
-This file is maintained upstream in the Elevasis monorepo template
-(`external/_template/.claude/Overview.md`) and delivered to this project via template
-sync (`/git-sync`). **The whole file is replace-managed** -- not just the generated blocks.
-Any local edit here is overwritten on the next sync, so corrections belong upstream, where
-every project receives them.
-
-The blocks marked `<!-- @generated:start:... -->` / `<!-- @generated:end -->` are additionally
-machine-written by `pnpm gen:overview` in the monorepo; do not hand-edit them even upstream.
-
-There is no monorepo command to run from inside this project; refreshes happen upstream and
-arrive through the normal sync flow.
-
-**If you were about to add project-specific detail to this file, stop** -- it will be lost.
-Project identity and preferences go in `CLAUDE.md`; tenant operational quirks go in
-`OPERATIONS.md`. Both are project-owned and never overwritten.

package/reference/claude-config/hooks/post-edit-validate.mjs

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-// post-edit-validate.mjs
-// PostToolUse hook — auto-formats with prettier, type-checks .ts/.tsx files.
-// Fires after Edit|Write|MultiEdit succeeds.
-
-import { existsSync, readFileSync } from 'node:fs'
-import { resolve, normalize, extname, join, dirname, relative } from 'node:path'
-import { execSync } from 'node:child_process'
-
-const ROOT = process.env.CLAUDE_PROJECT_DIR ?? process.cwd()
-
-// Extensions prettier should format
-const PRETTIER_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.json', '.css', '.md'])
-
-// Extensions that trigger type-checking
-const TS_EXTENSIONS = new Set(['.ts', '.tsx'])
-
-function findNearestTsconfig(startDir) {
-  let dir = startDir
-  const root = normalize(ROOT)
-  while (dir.length >= root.length) {
-    const candidate = join(dir, 'tsconfig.json')
-    if (existsSync(candidate)) return candidate
-    const parent = dirname(dir)
-    if (parent === dir) break
-    dir = parent
-  }
-  return null
-}
-
-try {
-  const chunks = []
-  for await (const chunk of process.stdin) chunks.push(chunk)
-  const input = JSON.parse(Buffer.concat(chunks).toString())
-
-  const filePath = input.tool_input?.file_path
-  if (!filePath) process.exit(0)
-
-  const ext = extname(filePath).toLowerCase()
-  const absPath = normalize(resolve(filePath))
-  if (!existsSync(absPath)) process.exit(0)
-
-  const results = []
-
-  // 1. Prettier (skip silently if not installed yet, e.g. before first pnpm install)
-  if (PRETTIER_EXTENSIONS.has(ext)) {
-    try {
-      execSync('pnpm exec prettier --version', { cwd: ROOT, stdio: 'pipe', timeout: 5_000 })
-      try {
-        execSync('pnpm exec prettier --write "' + absPath + '"', {
-          cwd: ROOT,
-          stdio: ['pipe', 'pipe', 'pipe'],
-          timeout: 10_000
-        })
-      } catch (err) {
-        const stderr = err.stderr?.toString().trim() || ''
-        if (stderr && !/ignored/i.test(stderr)) {
-          results.push('Prettier error: ' + stderr.slice(0, 300))
-        }
-      }
-    } catch {
-      // prettier not installed yet -- skip silently
-    }
-  }
-
-  // 2. Type-check for .ts/.tsx
-  if (TS_EXTENSIONS.has(ext)) {
-    const tsconfig = findNearestTsconfig(dirname(absPath))
-    if (tsconfig) {
-      try {
-        execSync('pnpm exec tsc --noEmit -p "' + tsconfig + '"', {
-          cwd: ROOT,
-          stdio: ['pipe', 'pipe', 'pipe'],
-          timeout: 30_000,
-          env: { ...process.env, NODE_OPTIONS: '--max-old-space-size=4096' }
-        })
-      } catch (err) {
-        if (err.killed) process.exit(0) // Don't block on timeout
-        const stdout = err.stdout?.toString() || ''
-        if (stdout.includes('error TS')) {
-          const errorLines = stdout
-            .split('\n')
-            .filter((l) => l.includes('error TS'))
-            .slice(0, 10)
-          results.push('Type errors after editing ' + filePath + ':\n' + errorLines.join('\n'))
-        }
-      }
-    }
-  }
-
-  // Output errors to Claude's context (silence = success)
-  if (results.length > 0) {
-    process.stderr.write(results.join('\n\n'))
-    process.exit(2) // Exit 2 = send stderr as feedback to Claude
-  }
-} catch {}
-
-process.exit(0)

package/reference/claude-config/hooks/scaffold-registry-reminder.mjs

@@ -1,187 +0,0 @@
-#!/usr/bin/env node
-// scaffold-registry-reminder.mjs
-// PostToolUse hook — reads the compiled scaffold registry and emits advisory
-// reminders when an edited file matches a registry source pattern.
-//
-// Template twin of the monorepo hook. Gracefully no-ops when the compiled
-// registry is absent (e.g. before SDK delivers scaffold-registry.compiled.json
-// to external projects — Step 7/SDK milestone).
-//
-// Exit 0 always (advisory hook — never blocks).
-
-import { readFileSync, writeFileSync, mkdirSync, appendFileSync } from 'node:fs'
-import { join, normalize, relative } from 'node:path'
-
-const ROOT = process.env.CLAUDE_PROJECT_DIR ?? process.cwd()
-const LOG_DIR = join(ROOT, '.claude', 'logs')
-const LOG_FILE = join(LOG_DIR, 'scaffold-registry-reminder.log')
-const STATE_FILE = join(LOG_DIR, 'scaffold-registry-reminder.state.json')
-const REGISTRY_FILE = join(ROOT, '.claude', 'registries', 'scaffold-registry.compiled.json')
-
-const DEFAULT_COOLDOWN_MS = 300_000 // 5 minutes
-
-const GENERATED_DIR_SEGMENTS = ['_generated', '_gen']
-const GENERATED_CONTENT_MARKER = '@generated'
-
-function log(msg) {
-  try {
-    mkdirSync(LOG_DIR, { recursive: true })
-    appendFileSync(LOG_FILE, `[${new Date().toISOString()}] ${msg}\n`)
-  } catch {}
-}
-
-function pathMatchesPattern(filePath, pattern) {
-  const normalizedFile = filePath.replace(/\\/g, '/')
-  const normalizedPattern = pattern.replace(/\\/g, '/')
-
-  if (normalizedFile === normalizedPattern) return true
-
-  if (normalizedPattern.endsWith('/**') || normalizedPattern.endsWith('/*')) {
-    const prefix = normalizedPattern.slice(0, normalizedPattern.lastIndexOf('/*'))
-    return normalizedFile.startsWith(prefix + '/')
-  }
-
-  if (normalizedPattern.includes('*')) {
-    const escaped = normalizedPattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '[^/]*')
-    return new RegExp(`^${escaped}$`).test(normalizedFile)
-  }
-
-  return normalizedFile.startsWith(normalizedPattern + '/')
-}
-
-function loadState() {
-  try {
-    return JSON.parse(readFileSync(STATE_FILE, 'utf-8'))
-  } catch {
-    return {}
-  }
-}
-
-function saveState(state) {
-  try {
-    mkdirSync(LOG_DIR, { recursive: true })
-    writeFileSync(STATE_FILE, JSON.stringify(state, null, 2) + '\n', 'utf-8')
-  } catch {}
-}
-
-function throttleKey(entryId, filePath) {
-  return `${entryId}:${filePath}`
-}
-
-function isCoolingDown(state, key, cooldownMs) {
-  const last = state[key]
-  if (!last) return false
-  return Date.now() - last < cooldownMs
-}
-
-function formatDependentLine(dep) {
-  const regen = dep.regen === 'manual' ? 'manual check' : dep.regen
-  const hint = dep.hint ? ` [${dep.hint}]` : ''
-  return `    - ${dep.path} -> ${regen}${hint}`
-}
-
-function emitReminder(entry, relFilePath) {
-  const lines = [
-    `\uD83D\uDD14 Scaffold reminder -- ${entry.id} (${relFilePath})`,
-    `  Downstream scaffolds that may need updating:`
-  ]
-  for (const dep of entry.dependents) {
-    lines.push(formatDependentLine(dep))
-  }
-  lines.push(
-    `  If this is a scaffold-sensitive pattern not in the registry, also add an entry to .claude/registries/scaffold-registry.yml.`
-  )
-  return lines.join('\n')
-}
-
-function emitMissingEntryHint(relFilePath) {
-  return [
-    `\uD83D\uDD14 Scaffold reminder -- unregistered generated path (${relFilePath})`,
-    `  This path looks scaffold-generated but has no registry entry.`,
-    `  If it is scaffold-sensitive, add a new entry to .claude/registries/scaffold-registry.yml`,
-    `  so the reminder hook and /work handoff can track it.`
-  ].join('\n')
-}
-
-function looksLikeGeneratedPath(filePath) {
-  const normalizedFile = filePath.replace(/\\/g, '/')
-  const segments = normalizedFile.split('/')
-  return segments.some((seg) => GENERATED_DIR_SEGMENTS.includes(seg))
-}
-
-function looksLikeGeneratedContent(absFilePath) {
-  try {
-    const content = readFileSync(absFilePath, 'utf-8').slice(0, 500)
-    return content.includes(GENERATED_CONTENT_MARKER)
-  } catch {
-    return false
-  }
-}
-
-try {
-  const chunks = []
-  for await (const chunk of process.stdin) chunks.push(chunk)
-  const input = JSON.parse(Buffer.concat(chunks).toString())
-
-  const rawFilePath = input.tool_input?.file_path
-  if (!rawFilePath) process.exit(0)
-
-  const absFilePath = normalize(rawFilePath)
-  const relFilePath = relative(ROOT, absFilePath).replace(/\\/g, '/')
-
-  // Graceful no-op when registry is absent (pre-SDK-delivery state)
-  let registry
-  try {
-    const raw = readFileSync(REGISTRY_FILE, 'utf-8')
-    registry = JSON.parse(raw)
-  } catch {
-    log(`SKIP — registry not found (pre-SDK-delivery)`)
-    process.exit(0)
-  }
-
-  const entries = registry?.entries ?? []
-
-  const matched = entries.filter((entry) =>
-    (entry.sources ?? []).some((pattern) => pathMatchesPattern(relFilePath, pattern))
-  )
-
-  const state = loadState()
-  const now = Date.now()
-  const messages = []
-
-  if (matched.length > 0) {
-    for (const entry of matched) {
-      const key = throttleKey(entry.id, relFilePath)
-      if (isCoolingDown(state, key, DEFAULT_COOLDOWN_MS)) {
-        log(`THROTTLED — ${entry.id} for ${relFilePath}`)
-        continue
-      }
-      messages.push(emitReminder(entry, relFilePath))
-      state[key] = now
-      log(`EMITTED — ${entry.id} for ${relFilePath}`)
-    }
-  } else {
-    const isGenerated = looksLikeGeneratedPath(relFilePath) || looksLikeGeneratedContent(absFilePath)
-
-    if (isGenerated) {
-      const key = throttleKey('__missing__', relFilePath)
-      if (!isCoolingDown(state, key, DEFAULT_COOLDOWN_MS)) {
-        messages.push(emitMissingEntryHint(relFilePath))
-        state[key] = now
-        log(`EMITTED missing-entry hint for ${relFilePath}`)
-      } else {
-        log(`THROTTLED missing-entry hint for ${relFilePath}`)
-      }
-    }
-  }
-
-  if (messages.length > 0) {
-    saveState(state)
-    process.stderr.write(messages.join('\n\n') + '\n')
-    process.exit(2)
-  }
-} catch (err) {
-  log(`ERROR: ${err.message}`)
-}
-
-process.exit(0)