@elevasis/sdk 1.7.0 → 1.8.0

package/dist/index.d.ts

@@ -2425,10 +2425,8 @@ type Database = {
             };
             deployments: {
                 Row: {
-                    compiled_docs: Json | null;
                     created_at: string;
                     deployment_version: string | null;
-                    documentation: Json | null;
                     error_message: string | null;
                     id: string;
                     organization_id: string;
@@ -2440,10 +2438,8 @@ type Database = {
                     updated_at: string;
                 };
                 Insert: {
-                    compiled_docs?: Json | null;
                     created_at?: string;
                     deployment_version?: string | null;
-                    documentation?: Json | null;
                     error_message?: string | null;
                     id?: string;
                     organization_id: string;
@@ -2455,10 +2451,8 @@ type Database = {
                     updated_at?: string;
                 };
                 Update: {
-                    compiled_docs?: Json | null;
                     created_at?: string;
                     deployment_version?: string | null;
-                    documentation?: Json | null;
                     error_message?: string | null;
                     id?: string;
                     organization_id?: string;
@@ -2970,6 +2964,13 @@ type Database = {
                     updated_at?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "fk_milestones_project";
+                        columns: ["project_id"];
+                        isOneToOne: false;
+                        referencedRelation: "prj_projects";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "prj_milestones_organization_id_fkey";
                         columns: ["organization_id"];
@@ -3030,6 +3031,34 @@ type Database = {
                     type?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "fk_notes_created_by";
+                        columns: ["created_by"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "fk_notes_milestone";
+                        columns: ["milestone_id"];
+                        isOneToOne: false;
+                        referencedRelation: "prj_milestones";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "fk_notes_project";
+                        columns: ["project_id"];
+                        isOneToOne: false;
+                        referencedRelation: "prj_projects";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "fk_notes_task";
+                        columns: ["task_id"];
+                        isOneToOne: false;
+                        referencedRelation: "prj_tasks";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "prj_notes_created_by_fkey";
                         columns: ["created_by"];
@@ -3120,6 +3149,20 @@ type Database = {
                     updated_at?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "fk_projects_company";
+                        columns: ["client_company_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_companies";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "fk_projects_deal";
+                        columns: ["deal_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_deals";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "prj_projects_client_company_id_fkey";
                         columns: ["client_company_id"];
@@ -3202,6 +3245,27 @@ type Database = {
                     updated_at?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "fk_tasks_milestone";
+                        columns: ["milestone_id"];
+                        isOneToOne: false;
+                        referencedRelation: "prj_milestones";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "fk_tasks_parent";
+                        columns: ["parent_task_id"];
+                        isOneToOne: false;
+                        referencedRelation: "prj_tasks";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "fk_tasks_project";
+                        columns: ["project_id"];
+                        isOneToOne: false;
+                        referencedRelation: "prj_projects";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "prj_tasks_milestone_id_fkey";
                         columns: ["milestone_id"];
@@ -6569,8 +6633,8 @@ declare const ProjectSchemas: {
         type: z.ZodOptional<z.ZodEnum<{
             code: "code";
             other: "other";
-            documentation: "documentation";
             research: "research";
+            documentation: "documentation";
             report: "report";
             design: "design";
             refactor: "refactor";
@@ -6605,8 +6669,8 @@ declare const ProjectSchemas: {
         type: z.ZodOptional<z.ZodEnum<{
             code: "code";
             other: "other";
-            documentation: "documentation";
             research: "research";
+            documentation: "documentation";
             report: "report";
             design: "design";
             refactor: "refactor";
@@ -8677,14 +8741,6 @@ interface ElevasConfig {
     dev?: {
         port?: number;
     };
-    /**
-     * Directory (relative to CWD) to scan for deployable documentation.
-     * Defaults to 'docs'. Use '../docs' when running the SDK from a subdirectory
-     * and wanting to consolidate docs at the project root.
-     *
-     * Set to `false` to disable documentation scanning entirely.
-     */
-    docsDir?: string | false;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -44,7 +44,7 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.6.0",
+    "@repo/core": "0.7.0",
     "@repo/typescript-config": "0.0.0"
   },
   "scripts": {

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

@@ -42,17 +42,6 @@ try {
 
   const results = []
 
-  // 0. Frontmatter check for docs/*.md (except docs/index.md which is auto-generated)
-  const docsDir = normalize(join(ROOT, 'docs'))
-  const indexPath = normalize(join(docsDir, 'index.md'))
-  if (ext === '.md' && absPath.startsWith(docsDir) && absPath !== indexPath) {
-    const content = readFileSync(absPath, 'utf-8')
-    if (!content.startsWith('---\n') && !content.startsWith('---\r\n')) {
-      const rel = relative(ROOT, absPath).replace(/\\/g, '/')
-      results.push(`Missing frontmatter in ${rel}. All docs require:\n---\ntitle: ...\ndescription: ...\n---`)
-    }
-  }
-
   // 1. Prettier (skip silently if not installed yet, e.g. before first pnpm install)
   if (PRETTIER_EXTENSIONS.has(ext)) {
     try {

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

@@ -0,0 +1,188 @@
+#!/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', '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/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/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)
+      const cooldown = entry.cooldown_ms ?? DEFAULT_COOLDOWN_MS
+      if (isCoolingDown(state, key, cooldown)) {
+        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)

package/reference/claude-config/logs/pre-edit-vibe-gate.log

@@ -21,3 +21,20 @@
 [2026-04-20T09:40:20.762Z] tool=Edit path=foundations/config/extensions/deal-ecom.ts protected=true VIBE_APPROVED=true decision=ALLOW
 [2026-04-20T09:40:20.807Z] tool=Write path=ui/src/routes/__root.tsx protected=false VIBE_APPROVED=false decision=ALLOW
 [2026-04-20T09:40:20.905Z] tool=Edit path=operations/src/index.ts protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:33:54.792Z] tool=Write path=../../apps/docs/content/docs/in-progress/active-development/elevasis-sdk-cli-audit/index.mdx protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:34:53.555Z] tool=Edit path=CLAUDE.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:34:54.867Z] tool=Edit path=.claude/skills/deploy/SKILL.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:01.437Z] tool=Edit path=.claude/skills/project/SKILL.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:12.254Z] tool=Edit path=.claude/skills/deploy/SKILL.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:14.878Z] tool=Edit path=.claude/skills/status/SKILL.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:16.589Z] tool=Edit path=.claude/rules/observability.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:22.331Z] tool=Edit path=.claude/skills/save/SKILL.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:23.493Z] tool=Edit path=.claude/skills/save/SKILL.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:24.652Z] tool=Edit path=.claude/skills/save/SKILL.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:40.826Z] tool=Edit path=.claude/skills/submit-request/SKILL.md protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:46.042Z] tool=Edit path=../../apps/docs/content/docs/in-progress/active-development/elevasis-sdk-cli-audit/index.mdx protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:35:52.609Z] tool=Edit path=../../apps/docs/content/docs/in-progress/active-development/elevasis-sdk-cli-audit/index.mdx protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:38:11.027Z] tool=Edit path=../../apps/docs/content/docs/in-progress/active-development/elevasis-sdk-cli-audit/index.mdx protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:40:59.364Z] tool=Edit path=../../apps/docs/content/docs/in-progress/active-development/elevasis-sdk-cli-audit/index.mdx protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:46:47.829Z] tool=Edit path=../../apps/docs/content/docs/in-progress/active-development/elevasis-sdk-cli-audit/index.mdx protected=false VIBE_APPROVED=false decision=ALLOW
+[2026-04-21T02:46:54.250Z] tool=Edit path=../../apps/docs/content/docs/in-progress/active-development/elevasis-sdk-cli-audit/index.mdx protected=false VIBE_APPROVED=false decision=ALLOW

package/reference/claude-config/logs/scaffold-registry-reminder.log

@@ -0,0 +1,17 @@
+[2026-04-21T02:33:54.962Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:34:53.682Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:00.720Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:01.648Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:12.366Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:15.057Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:16.874Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:22.469Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:23.677Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:24.831Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:41.027Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:46.206Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:35:52.776Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:38:11.201Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:40:59.696Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:46:47.986Z] SKIP — registry not found (pre-SDK-delivery)
+[2026-04-21T02:46:54.532Z] SKIP — registry not found (pre-SDK-delivery)

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

@@ -0,0 +1,80 @@
+---
+description: Bridge between stable scaffold docs and higher-volatility in-progress architecture work that may override assumptions for agents working in the template
+---
+
+# Active Change Index
+
+Use this rule to decide whether stable scaffold docs are enough, or whether you also need to load in-progress platform architecture docs from the monorepo.
+
+> **Note:** Paths prefixed with `apps/` or `packages/` are monorepo-internal and unavailable in standalone projects. For those areas, use the stable scaffold docs under `node_modules/@elevasis/sdk/reference/scaffold/` as the primary reference. The monorepo paths are retained for contributors working within the monorepo.
+
+## Current Watch Areas
+
+### Organization OS
+
+Use when the task touches:
+
+- organization model semantics
+- feature/provider runtime
+- feature manifests or shell composition
+- graph or command-view concepts
+- downstream propagation of scaffold contract changes
+
+Load:
+
+- `apps/docs/content/docs/technical/architecture/core/organization-model/index.mdx`
+- `apps/docs/content/docs/technical/architecture/core/organization-model/graph.mdx`
+- `apps/docs/content/docs/technical/architecture/ui/feature-shell.mdx`
+- `apps/docs/content/docs/technical/architecture/ui/composition-extensibility.mdx`
+
+Stable scaffold docs affected:
+
+- `node_modules/@elevasis/sdk/reference/scaffold/reference/contracts.md`
+- `.claude/rules/ui.md`
+- `node_modules/@elevasis/sdk/reference/scaffold/ui/customization.md`
+- `node_modules/@elevasis/sdk/reference/scaffold/ui/feature-flags-and-gating.md`
+
+### Package Surface / Reference System
+
+Use when the task touches:
+
+- published `@elevasis/core`, `@elevasis/ui`, or `@elevasis/sdk` surfaces
+- generated package maps
+- contract drift between source and scaffold docs
+
+Load:
+
+- `packages/core/src/organization-model/README.md`
+- `packages/ui/src/provider/README.md`
+- `packages/ui/src/features/README.md`
+- `packages/sdk/reference/_navigation.md`
+
+Stable scaffold docs affected:
+
+- `node_modules/@elevasis/sdk/reference/scaffold/reference/contracts.md`
+
+### Resource / Topology Mapping
+
+Use when the task touches:
+
+- resource registration
+- triggers, integrations, relationships, human checkpoints
+- topology-aware navigation or impact analysis
+
+Load:
+
+- `operations/src/README.md`
+- `operations/src/index.ts`
+
+Stable scaffold docs affected:
+
+- `.claude/rules/operations.md`
+
+## Working Rule
+
+When a task touches one of the watch areas above:
+
+1. Read the stable scaffold doc.
+2. Read the listed in-progress or package-local source-of-truth docs.
+3. Prefer source and in-progress architecture docs if they disagree with scaffold prose.
+4. Flag drift instead of silently trusting the scaffold doc.