@elevasis/sdk 0.4.5 → 0.4.7

package/dist/cli.cjs

@@ -6622,14 +6622,14 @@ var require_async_iterator = __commonJS({
       };
     }
     function readAndResolve(iter) {
-      var resolve5 = iter[kLastResolve];
-      if (resolve5 !== null) {
+      var resolve6 = iter[kLastResolve];
+      if (resolve6 !== null) {
         var data = iter[kStream].read();
         if (data !== null) {
           iter[kLastPromise] = null;
           iter[kLastResolve] = null;
           iter[kLastReject] = null;
-          resolve5(createIterResult(data, false));
+          resolve6(createIterResult(data, false));
         }
       }
     }
@@ -6637,13 +6637,13 @@ var require_async_iterator = __commonJS({
       process.nextTick(readAndResolve, iter);
     }
     function wrapForNext(lastPromise, iter) {
-      return function(resolve5, reject) {
+      return function(resolve6, reject) {
         lastPromise.then(function() {
           if (iter[kEnded]) {
-            resolve5(createIterResult(void 0, true));
+            resolve6(createIterResult(void 0, true));
             return;
           }
-          iter[kHandlePromise](resolve5, reject);
+          iter[kHandlePromise](resolve6, reject);
         }, reject);
       };
     }
@@ -6663,12 +6663,12 @@ var require_async_iterator = __commonJS({
           return Promise.resolve(createIterResult(void 0, true));
         }
         if (this[kStream].destroyed) {
-          return new Promise(function(resolve5, reject) {
+          return new Promise(function(resolve6, reject) {
             process.nextTick(function() {
               if (_this[kError]) {
                 reject(_this[kError]);
               } else {
-                resolve5(createIterResult(void 0, true));
+                resolve6(createIterResult(void 0, true));
               }
             });
           });
@@ -6691,13 +6691,13 @@ var require_async_iterator = __commonJS({
       return this;
     }), _defineProperty(_Object$setPrototypeO, "return", function _return() {
       var _this2 = this;
-      return new Promise(function(resolve5, reject) {
+      return new Promise(function(resolve6, reject) {
         _this2[kStream].destroy(null, function(err) {
           if (err) {
             reject(err);
             return;
           }
-          resolve5(createIterResult(void 0, true));
+          resolve6(createIterResult(void 0, true));
         });
       });
     }), _Object$setPrototypeO), AsyncIteratorPrototype);
@@ -6719,15 +6719,15 @@ var require_async_iterator = __commonJS({
         value: stream._readableState.endEmitted,
         writable: true
       }), _defineProperty(_Object$create, kHandlePromise, {
-        value: function value(resolve5, reject) {
+        value: function value(resolve6, reject) {
           var data = iterator[kStream].read();
           if (data) {
             iterator[kLastPromise] = null;
             iterator[kLastResolve] = null;
             iterator[kLastReject] = null;
-            resolve5(createIterResult(data, false));
+            resolve6(createIterResult(data, false));
           } else {
-            iterator[kLastResolve] = resolve5;
+            iterator[kLastResolve] = resolve6;
             iterator[kLastReject] = reject;
           }
         },
@@ -6746,12 +6746,12 @@ var require_async_iterator = __commonJS({
           iterator[kError] = err;
           return;
         }
-        var resolve5 = iterator[kLastResolve];
-        if (resolve5 !== null) {
+        var resolve6 = iterator[kLastResolve];
+        if (resolve6 !== null) {
           iterator[kLastPromise] = null;
           iterator[kLastResolve] = null;
           iterator[kLastReject] = null;
-          resolve5(createIterResult(void 0, true));
+          resolve6(createIterResult(void 0, true));
         }
         iterator[kEnded] = true;
       });
@@ -6766,7 +6766,7 @@ var require_async_iterator = __commonJS({
 var require_from = __commonJS({
   "../../node_modules/.pnpm/readable-stream@3.6.2/node_modules/readable-stream/lib/internal/streams/from.js"(exports2, module2) {
     "use strict";
-    function asyncGeneratorStep(gen, resolve5, reject, _next, _throw, key, arg) {
+    function asyncGeneratorStep(gen, resolve6, reject, _next, _throw, key, arg) {
       try {
         var info = gen[key](arg);
         var value = info.value;
@@ -6775,7 +6775,7 @@ var require_from = __commonJS({
         return;
       }
       if (info.done) {
-        resolve5(value);
+        resolve6(value);
       } else {
         Promise.resolve(value).then(_next, _throw);
       }
@@ -6783,13 +6783,13 @@ var require_from = __commonJS({
     function _asyncToGenerator(fn) {
       return function() {
         var self2 = this, args = arguments;
-        return new Promise(function(resolve5, reject) {
+        return new Promise(function(resolve6, reject) {
           var gen = fn.apply(self2, args);
           function _next(value) {
-            asyncGeneratorStep(gen, resolve5, reject, _next, _throw, "next", value);
+            asyncGeneratorStep(gen, resolve6, reject, _next, _throw, "next", value);
           }
           function _throw(err) {
-            asyncGeneratorStep(gen, resolve5, reject, _next, _throw, "throw", err);
+            asyncGeneratorStep(gen, resolve6, reject, _next, _throw, "throw", err);
           }
           _next(void 0);
         });
@@ -26489,7 +26489,7 @@ var require_gray_matter = __commonJS({
 
 // src/cli/index.ts
 var import_dotenv = __toESM(require_main(), 1);
-var import_path4 = require("path");
+var import_path5 = require("path");
 
 // ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -40224,7 +40224,7 @@ var GPT5OptionsSchema = external_exports.object({
 var GPT5ConfigSchema = external_exports.object({
   model: external_exports.enum(["gpt-5", "gpt-5-mini"]),
   provider: external_exports.enum(["openai"]),
-  apiKey: external_exports.string().min(1),
+  apiKey: external_exports.string(),
   temperature: external_exports.literal(1),
   // Required to be exactly 1
   maxTokens: external_exports.number().min(4e3).optional(),
@@ -40254,7 +40254,7 @@ var OpenRouterConfigSchema = external_exports.object({
     "openrouter/x-ai/grok-4.1-fast"
   ]),
   provider: external_exports.literal("openrouter"),
-  apiKey: external_exports.string().min(1),
+  apiKey: external_exports.string(),
   temperature: external_exports.number().min(0).max(2).optional(),
   maxTokens: external_exports.number().min(500).optional(),
   topP: external_exports.number().min(0).max(1).optional(),
@@ -40267,7 +40267,7 @@ var GoogleOptionsSchema = external_exports.object({
 var GoogleConfigSchema = external_exports.object({
   model: external_exports.enum(["gemini-3-flash-preview"]),
   provider: external_exports.literal("google"),
-  apiKey: external_exports.string().min(1),
+  apiKey: external_exports.string(),
   temperature: external_exports.literal(1).optional(),
   // Must be 1 for Gemini 3 (changing degrades performance)
   maxTokens: external_exports.number().min(500).optional(),
@@ -40278,7 +40278,7 @@ var AnthropicOptionsSchema = external_exports.object({});
 var AnthropicConfigSchema = external_exports.object({
   model: external_exports.enum(["claude-opus-4-5", "claude-sonnet-4-5", "claude-haiku-4-5"]),
   provider: external_exports.literal("anthropic"),
-  apiKey: external_exports.string().min(1),
+  apiKey: external_exports.string(),
   temperature: external_exports.number().min(0).max(1).optional(),
   maxTokens: external_exports.number().min(1e3).optional(),
   // Anthropic requires max_tokens
@@ -42868,6 +42868,12 @@ var zodToJsonSchema = (schema, options2) => {
   return combined;
 };
 
+// ../core/src/execution/engine/workflow/types.ts
+var StepType = {
+  LINEAR: "linear",
+  CONDITIONAL: "conditional"
+};
+
 // ../core/src/execution/engine/base/serialization.ts
 function serializeDefinition(definition, options2) {
   const opts = {
@@ -42952,13 +42958,13 @@ function serializeKnowledgeMap(km, ctx) {
 }
 function serializeNextConfig(nextConfig, _context) {
   if (!nextConfig) return null;
-  if (nextConfig.type === "linear" /* LINEAR */) {
+  if (nextConfig.type === StepType.LINEAR) {
     return {
       type: nextConfig.type,
       target: nextConfig.target
     };
   }
-  if (nextConfig.type === "conditional" /* CONDITIONAL */) {
+  if (nextConfig.type === StepType.CONDITIONAL) {
     return {
       type: nextConfig.type,
       routes: nextConfig.routes?.map((route) => ({
@@ -43010,7 +43016,7 @@ function isKnowledgeMapObject(value) {
   return value && typeof value === "object" && "nodes" in value && typeof value.nodes === "object";
 }
 function isNextConfigObject(value) {
-  return value && typeof value === "object" && "type" in value && (value.type === "linear" /* LINEAR */ || value.type === "conditional" /* CONDITIONAL */);
+  return value && typeof value === "object" && "type" in value && (value.type === StepType.LINEAR || value.type === StepType.CONDITIONAL);
 }
 function isSecretKey(key) {
   const lower = key.toLowerCase();
@@ -43774,41 +43780,9 @@ async function apiPost(endpoint, body, apiUrl = resolveApiUrl()) {
   }
   return response.json();
 }
-async function apiPut(endpoint, body, apiUrl = resolveApiUrl()) {
-  const response = await fetch(`${apiUrl}${endpoint}`, {
-    method: "PUT",
-    headers: {
-      Authorization: `Bearer ${getApiKey()}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify(body)
-  });
-  if (!response.ok) {
-    const errorText = await response.text();
-    throw new Error(`API request failed (${response.status}): ${errorText}`);
-  }
-  if (response.status === 204) {
-    return {};
-  }
-  return response.json();
-}
-async function apiDelete(endpoint, apiUrl = resolveApiUrl()) {
-  const response = await fetch(`${apiUrl}${endpoint}`, {
-    method: "DELETE",
-    headers: { Authorization: `Bearer ${getApiKey()}` }
-  });
-  if (!response.ok) {
-    const errorText = await response.text();
-    throw new Error(`API request failed (${response.status}): ${errorText}`);
-  }
-  if (response.status === 204) {
-    return {};
-  }
-  return response.json();
-}
 
 // src/cli/version.ts
-var SDK_VERSION = "0.4.5";
+var SDK_VERSION = "0.4.6";
 
 // src/cli/commands/deploy.ts
 var import_meta2 = {};
@@ -44459,27 +44433,37 @@ function registerDescribeCommand(program3) {
 // src/cli/commands/init.ts
 var import_path3 = require("path");
 var import_promises2 = require("fs/promises");
-var SCAFFOLD_FILES = [
-  "elevasis.config.ts",
+var TEMPLATE_VERSION = 4;
+var INIT_ONLY_FILES = [
   "package.json",
   "pnpm-workspace.yaml",
   "tsconfig.json",
   ".env",
   ".env.example",
   ".npmrc",
-  ".gitignore",
   "src/index.ts",
+  "src/workflows/echo.ts",
   "docs/index.mdx",
+  "docs/in-progress/.gitkeep"
+];
+var MANAGED_FILES = [
+  "elevasis.config.ts",
+  ".gitignore",
   "CLAUDE.md",
   ".claude/settings.json",
   ".claude/commands/docs.md",
   ".claude/commands/resource.md",
-  ".claude/commands/deploy.md",
-  ".claude/commands/inspect.md",
-  ".claude/commands/env.md"
+  ".claude/commands/tutorial.md",
+  ".claude/commands/help.md",
+  ".claude/commands/templates.md",
+  ".claude/commands/database.md",
+  ".claude/commands/agent.md",
+  ".claude/commands/profile.md",
+  ".claude/commands/meta.md"
 ];
+var SCAFFOLD_FILES = [...INIT_ONLY_FILES, ...MANAGED_FILES];
 function registerInitCommand(program3) {
-  program3.command("init [directory]").description("Scaffold a new Elevasis project\n  Example: elevasis init my-project").option("--force", "Overwrite existing files").action(wrapAction("init", async (directory, options2) => {
+  program3.command("init [directory]").description("Scaffold a new Elevasis workspace\n  Example: elevasis init my-workspace").option("--force", "Overwrite existing files").action(wrapAction("init", async (directory, options2) => {
     const targetDir = directory ? (0, import_path3.resolve)(directory) : process.cwd();
     const orgSlug = toSlug((0, import_path3.basename)(targetDir));
     if (!options2.force) {
@@ -44500,8 +44484,8 @@ function registerInitCommand(program3) {
         throw new Error("Scaffold conflict");
       }
     }
-    await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "src"), { recursive: true });
-    await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "docs"), { recursive: true });
+    await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "src/workflows"), { recursive: true });
+    await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "docs/in-progress"), { recursive: true });
     await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, ".claude/commands"), { recursive: true });
     const files = {
       "elevasis.config.ts": configTemplate(),
@@ -44513,19 +44497,25 @@ function registerInitCommand(program3) {
       ".npmrc": npmrcTemplate(),
       ".gitignore": gitignoreTemplate(),
       "src/index.ts": starterTemplate(),
+      "src/workflows/echo.ts": starterWorkflowTemplate(),
       "docs/index.mdx": docsIndexTemplate(orgSlug),
+      "docs/in-progress/.gitkeep": "",
       "CLAUDE.md": claudeMdTemplate(),
       ".claude/settings.json": claudeSettingsTemplate(),
       ".claude/commands/docs.md": claudeDocsCommandTemplate(),
       ".claude/commands/resource.md": claudeResourceCommandTemplate(),
-      ".claude/commands/deploy.md": claudeDeployCommandTemplate(),
-      ".claude/commands/inspect.md": claudeInspectCommandTemplate(),
-      ".claude/commands/env.md": claudeEnvCommandTemplate()
+      ".claude/commands/tutorial.md": claudeTutorialCommandTemplate(),
+      ".claude/commands/help.md": claudeHelpCommandTemplate(),
+      ".claude/commands/templates.md": claudeTemplatesCommandTemplate(),
+      ".claude/commands/database.md": claudeDatabaseCommandTemplate(),
+      ".claude/commands/agent.md": claudeAgentCommandTemplate(),
+      ".claude/commands/profile.md": claudeProfileCommandTemplate(),
+      ".claude/commands/meta.md": claudeMetaCommandTemplate()
     };
     for (const [filePath, content] of Object.entries(files)) {
       await (0, import_promises2.writeFile)((0, import_path3.resolve)(targetDir, filePath), content, "utf-8");
     }
-    console.log(source_default.green.bold("  Project created!"));
+    console.log(source_default.green.bold("  Workspace created!"));
     console.log("");
     console.log(source_default.gray("  Next steps:"));
     if (directory) {
@@ -44539,12 +44529,13 @@ function registerInitCommand(program3) {
 }
 function toSlug(name) {
   const slug = name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/^[^a-z]+/, "").replace(/-+/g, "-").replace(/-$/, "");
-  return slug.length >= 3 ? slug : "my-project";
+  return slug.length >= 3 ? slug : "my-workspace";
 }
 function configTemplate() {
   return `import type { ElevasConfig } from '@elevasis/sdk'
 
 export default {
+  templateVersion: ${TEMPLATE_VERSION},
   // defaultStatus: 'dev',     // Default status for new resources ('dev' | 'production')
   // dev: { port: 5170 },      // Local API port (internal development only)
 } satisfies ElevasConfig
@@ -44607,19 +44598,19 @@ function gitignoreTemplate() {
 dist/
 __elevasis_worker.ts
 .claude/settings.local.json
-.claude/profile.json
+.claude/memory/
 `;
 }
 function docsIndexTemplate(organization) {
   return `---
 title: ${organization}
-description: Documentation for the ${organization} Elevasis project
+description: Documentation for the ${organization} Elevasis workspace
 order: 1
 ---
 
 # ${organization}
 
-An [Elevasis](https://elevasis.io) project built with the \`@elevasis/sdk\`.
+An [Elevasis](https://elevasis.io) workspace built with the \`@elevasis/sdk\`.
 
 ## Setup
 
@@ -44642,16 +44633,15 @@ elevasis exec <resourceId> --input '...'  # Execute a resource
 elevasis resources                    # List deployed resources
 elevasis describe <resourceId>        # Show resource definition + schemas
 elevasis executions <resourceId>      # View execution history
-elevasis env list                     # List platform env var names
-elevasis env set NAME VALUE           # Set env var (requires redeploy)
 \`\`\`
 
 ## Project Structure
 
-- \`elevasis.config.ts\` -- Project config (optional settings)
-- \`src/index.ts\` -- Resource definitions (workflows, agents)
+- \`elevasis.config.ts\` -- Workspace config (optional settings)
+- \`src/index.ts\` -- Resource registry (imports and exports all workflows)
+- \`src/workflows/\` -- Workflow definitions (one per file)
 - \`docs/\` -- Documentation (.mdx files, deployed alongside code)
-- \`.env\` -- API key and environment variables
+- \`.env\` -- API key for CLI authentication
 
 ## Resources
 
@@ -44672,202 +44662,60 @@ function claudeSettingsTemplate() {
   return JSON.stringify({ autoCompact: false }, null, 2) + "\n";
 }
 function claudeMdTemplate() {
-  return `# CLAUDE.md
-
-Project instructions for Claude Code when working with this Elevasis SDK project.
-
-## Welcome & Profiling
-
-On first interaction, check if \`.claude/profile.json\` exists.
-
-**If it does NOT exist**, run a one-time welcome:
-
-1. Greet the developer and explain this is a quick one-time setup to personalize help
-2. Ask these questions:
-   - What kind of business or team is this for? (e.g., marketing agency, SaaS, e-commerce)
-   - What are the main goals for this project? (e.g., email automation, CRM sync, lead scoring)
-   - Which external tools or services will your workflows integrate with? (e.g., Gmail, Attio, Slack)
-   - How would you describe your experience with TypeScript and AI automation? (beginner/intermediate/advanced)
-3. Write answers to \`.claude/profile.json\`:
-   \`\`\`json
-   {
-     "organization": { "name": "", "industry": "", "size": "" },
-     "developer": { "experience": "", "aiExperience": "" },
-     "project": { "description": "", "existingTools": [], "primaryGoals": [] },
-     "preferences": { "verbosity": "concise" }
-   }
-   \`\`\`
-4. Summarize what you will help them build and suggest a first resource to create
-
-**If it exists**, read it at session start to personalize your responses (suggest
-relevant tools, calibrate explanation depth, reference their goals).
-
-## What This Is
-
-An Elevasis SDK project -- external resources (workflows, agents) that deploy to
-the Elevasis platform via \`elevasis deploy\`. The platform handles execution,
-scheduling, and integration tools.
-
-## Project Structure
-
-- \`src/index.ts\` -- Resource definitions (workflows, agents). Exports
-  \`OrganizationResources\` as default export.
-- \`docs/\` -- Documentation files (.mdx). Deployed alongside code, rendered in
-  platform UI. Max 100KB per file, 1MB total per deployment.
-- \`elevasis.config.ts\` -- Project configuration (optional).
-- \`.env\` -- API key (\`ELEVASIS_API_KEY\`) and environment variables.
-- \`dist/\` -- Generated by \`elevasis deploy\` (gitignored, never commit).
-- \`.claude/profile.json\` -- Your profile (created on first session, gitignored).
-
-## CLI Reference
-
-\`\`\`bash
-elevasis check                              # Validate resource definitions (--entry to override)
-elevasis deploy                             # Bundle + deploy to platform (--entry, --api-url)
-elevasis exec <id> -i '{"key":"val"}'       # Execute a resource (--async for background)
-elevasis resources                          # List deployed resources (--json)
-elevasis describe <id>                      # Show resource definition + schemas (--json)
-elevasis executions <id>                    # Execution history (--limit, --status, --json)
-elevasis execution <id> <execId>            # Execution detail (--logs-only, --input, --result)
-elevasis deployments                        # Deployment history (--json)
-elevasis env list                           # List platform env var names (--json)
-elevasis env set <NAME> <VALUE>             # Set env var (requires redeploy to take effect)
-elevasis env remove <NAME>                  # Remove env var (requires redeploy to take effect)
-\`\`\`
-
-## SDK Patterns
-
-### Single-Step Workflow
-
-\`\`\`typescript
-import type { WorkflowDefinition, OrganizationResources } from '@elevasis/sdk'
-import { z } from 'zod'
-
-const myInput = z.object({ message: z.string() })
-const myOutput = z.object({ result: z.string() })
-type MyInput = z.infer<typeof myInput>
-
-const myWorkflow: WorkflowDefinition = {
-  config: {
-    resourceId: 'my-workflow',
-    name: 'My Workflow',
-    type: 'workflow',
-    description: 'What it does',
-    version: '1.0.0',
-    status: 'dev', // 'dev' | 'production'
-  },
-  contract: {
-    inputSchema: myInput,
-    outputSchema: myOutput,
-  },
-  steps: {
-    'process': {
-      id: 'process',
-      name: 'Process',
-      description: 'Process the input',
-      handler: async (input) => {
-        const { message } = input as MyInput
-        return { result: message.toUpperCase() }
-      },
-      inputSchema: myInput,
-      outputSchema: myOutput,
-      next: null, // terminal step
-    },
-  },
-  entryPoint: 'process',
-}
-
-const org: OrganizationResources = { workflows: [myWorkflow] }
-export default org
-\`\`\`
-
-### Multi-Step Workflow
-
-Use \`StepType\` (runtime value) from \`'@elevasis/sdk'\` to chain steps:
-
-\`\`\`typescript
-import { StepType } from '@elevasis/sdk'
-
-steps: {
-  'step-one': {
-    id: 'step-one',
-    name: 'Step One',
-    handler: async (input) => { /* ... */ },
-    inputSchema: stepOneInput,
-    outputSchema: stepOneOutput,
-    next: { type: StepType.LINEAR, target: 'step-two' }, // linear chain
-  },
-  'step-two': {
-    id: 'step-two',
-    name: 'Step Two',
-    handler: async (input) => { /* ... */ },
-    inputSchema: stepTwoInput,
-    outputSchema: stepTwoOutput,
-    next: null, // terminal
-  },
-},
-entryPoint: 'step-one',
-\`\`\`
-
-### Conditional Routing
-
-Route to different steps based on output data:
-
-\`\`\`typescript
-import { StepType } from '@elevasis/sdk'
-
-next: {
-  type: StepType.CONDITIONAL,
-  routes: [
-    { target: 'approved', condition: (data: any) => data.score >= 80 },
-    { target: 'review', condition: (data: any) => data.score >= 50 },
-  ],
-  default: 'rejected', // fallback if no condition matches
-},
-\`\`\`
-
-### Platform Tools
-
-Call 70+ platform tools from step handlers via \`platform.call()\`:
-
-\`\`\`typescript
-import { platform, PlatformToolError } from '@elevasis/sdk/worker'
-
-handler: async (input) => {
-  try {
-    const result = await platform.call({
-      tool: 'gmail',           // tool name
-      method: 'sendEmail',     // method
-      params: { to: '...', subject: '...', body: '...' },
-      credential: 'my-gmail',  // credential name (required for integrations)
-    })
-    return { sent: true, result }
-  } catch (err) {
-    if (err instanceof PlatformToolError) {
-      console.error(err.code, err.retryable)
-    }
-    throw err
-  }
-}
-\`\`\`
-
-Each \`platform.call()\` has a 60-second timeout. The \`credential\` field names a
-credential configured in the Elevasis platform for your organization.
-
-### ExecutionContext
-
-Step handlers receive \`(input, context)\`. The context includes:
-
-- \`context.executionId\` -- Unique ID for this execution
-- \`context.organizationId\` -- Your organization ID
-- \`context.resourceId\` -- The resource being executed
-- \`context.logger\` -- \`{ debug, info, warn, error }\` for structured logging
-- \`context.store\` -- \`Map<string, unknown>\` for passing data between steps
-
-### Zod Schemas
-
-All schemas use Zod 4.1+. Input and output schemas are converted to JSON Schema
-at deploy time via \`z.toJSONSchema()\`.
+  return `<!-- initialized: false -->
+
+# CLAUDE.md
+
+## Session Initialization
+
+At the start of every session:
+
+0. Check the \`<!-- initialized: ... -->\` flag at the top of this file.
+   If \`false\`, read \`.claude/commands/meta.md\` and run the \`/meta init\` flow.
+   After initialization completes, change the flag to \`<!-- initialized: true -->\`.
+   If \`true\`, proceed with steps below.
+1. Read \`.claude/memory/profile/skills.md\` -- adapt all responses to the user's
+   assessed skill levels (see Interaction Guidance below).
+2. Read \`.claude/memory/index.md\` -- drill into relevant topic files as needed.
+   Balance context relevance against token usage.
+3. Check installed \`@elevasis/sdk\` template version against \`templateVersion\`
+   in \`elevasis.config.ts\`. If newer, notify and suggest \`/meta update\`.
+4. If \`.claude/memory/\` does not exist, suggest \`/meta init\`.
+5. If user TypeScript level is beginner (from skills.md) and
+   \`.claude/memory/tutorial-progress.md\` does not exist, suggest \`/tutorial\`.
+
+Do this silently. Do not narrate the steps to the user.
+
+## Identity
+
+You are the development agent for an Elevasis workspace. You help the user
+design, build, and deploy business automation workflows on the Elevasis
+platform. You are not just a code assistant -- you are a guide who translates
+business intent into working automation.
+
+Your users range from experienced developers to business operators who have
+never written code. Read the user's skill profile at session start and adapt
+every interaction -- vocabulary, code completeness, explanation depth, and
+proactivity -- to their assessed levels.
+
+## Navigation
+
+| Resource | Location | When to Load |
+| --- | --- | --- |
+| Workspace concepts | \`reference/concepts/index.mdx\` | User asks "what is...?" or needs conceptual grounding |
+| SDK patterns and examples | \`reference/resources/patterns.mdx\` | Building or modifying a workflow |
+| Platform tool catalog | \`reference/platform-tools/index.mdx\` | Connecting to external services |
+| CLI reference | \`reference/cli/index.mdx\` | Running CLI operations |
+| Credential model | \`reference/security/credentials.mdx\` | Setting up integrations or tool access |
+| Interaction guidance | \`reference/developer/interaction-guidance.mdx\` | Unsure how to adapt for a skill combination |
+| Error history | \`.claude/memory/errors/index.md\` | Debugging errors, checking past fixes |
+| SDK error reference | \`reference/troubleshooting/common-errors.mdx\` | Unknown error not in workspace memory |
+| Project resource map | \`docs/navigation.mdx\` | Understanding what's deployed |
+| Project priorities | \`docs/priorities.mdx\` | Deciding what to work on next |
+| User profile and skills | \`.claude/memory/profile/skills.md\` | Session start (mandatory) |
+| Cross-session memory | \`.claude/memory/index.md\` | Session start, recalling past context |
+
+All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 
 ## Rules
 
@@ -44876,22 +44724,95 @@ at deploy time via \`z.toJSONSchema()\`.
 - Do not import from \`@repo/core\` -- use \`@elevasis/sdk\` types only
 - \`StepType\`, \`ExecutionError\`, \`ToolingError\` are runtime imports from \`'@elevasis/sdk'\`
 - \`platform\`, \`PlatformToolError\` are runtime imports from \`'@elevasis/sdk/worker'\`
-- Environment variables go in \`.env\` (never commit API keys)
-- Env vars set via \`elevasis env set\` require \`elevasis deploy\` to take effect
+- \`.env\` is for CLI authentication only (\`ELEVASIS_API_KEY\`) -- never deployed, never in workers
+- Integration credentials are managed via the platform credential system (command center UI)
 - Documentation goes in \`docs/\` as \`.mdx\` files
 - \`dist/\` is generated by deploy -- never commit it
 - \`resourceId\` must be lowercase with hyphens, unique per organization
+- When an error occurs, check \`.claude/memory/errors/\` first for past fixes.
+  If the error is new, check \`reference/troubleshooting/common-errors.mdx\`.
+  After resolving, record the error in \`memory/errors/\` with context and fix.
+  If an error recurs 3+ times, promote it to a rule in this section.
+
+## Interaction Guidance
+
+Adapt your communication based on \`.claude/memory/profile/skills.md\`.
+Read the profile at session start (Step 1). Adjust every response --
+vocabulary, code completeness, explanation depth, and proactivity --
+based on what you find.
+
+- Match vocabulary to the user's level. Avoid jargon for beginners;
+  be precise for experts. Define technical terms in parentheses the first time.
+- Show complete, working files for users below intermediate programming.
+  Never show code fragments they can't place.
+- Explain "why" before "how" for users new to automation.
+- For users comfortable with code, focus on SDK-specific patterns.
+- Leverage domain expertise -- if the user knows sales but not code,
+  ask for business process descriptions and translate.
+- When growth is observed, note it in the skills.md Growth Log.
+
+For detailed per-dimension adaptation rules, read
+\`reference/developer/interaction-guidance.mdx\`.
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| \`/meta\` | Project lifecycle: init, status, update, fix, deploy, health, develop |
+| \`/docs\` | Documentation lifecycle: create, checkpoint, cleanup, resume, verify |
+| \`/database\` | Database operations: init, browse, query, schema, import |
+| \`/resource\` | Scaffold a new workflow or agent |
+| \`/templates\` | Discover and apply workflow templates |
+| \`/agent\` | Agent development (placeholder) |
+| \`/tutorial\` | Progressive learning path |
+| \`/help\` | Command tree and navigation map |
+| \`/profile\` | View and update developer profile |
+
+## Maintaining Memory
+
+### What Memory Is
+
+Memory stores persistent state and observations that inform future sessions.
+Every file must contain data the agent writes and later reads to make better
+decisions. File names must clearly indicate they contain state or data
+(e.g., \`deployment-state.md\`, \`tutorial-progress.md\`, \`skills.md\`).
+
+Priorities live in \`docs/priorities.mdx\`, not in memory. Memory is for internal
+agent state; priorities are project documentation the user may also read.
+
+### What Memory Is NOT
+
+Do not store in \`.claude/memory/\`:
+- Instructions, commands, or procedures (belong in \`.claude/commands/\`)
+- Reference documentation or teaching material (belong in \`docs/\` or SDK reference)
+- Templates or boilerplate code
+- Conversation transcripts or chat history
+- Anything the agent reads but never updates
+
+### Structure
+
+- \`memory/index.md\` is the root -- maps to topic files and subdirectories
+- Every subdirectory has its own \`index.md\` mapping to children
+- Start at the root index and drill down
+- When a file outgrows a single document, split into a subdirectory
+
+### Pruning
+
+- Keep ~20 recent entries per table; drop stale patterns (30+ days, no recurrence)
+- If a file/index references a missing child, remove the row
+- If a child exists without an index entry, add it
+- If an error pattern recurs 3+ times, promote to Rules above
 `;
 }
 function claudeDocsCommandTemplate() {
   return `# /docs command
 
-You are a documentation assistant for this Elevasis SDK project.
+You are a documentation assistant for this Elevasis workspace.
 
 ## Context
 
 Read the project's CLAUDE.md and all files in docs/ to understand the project.
-Read src/index.ts to understand the resource definitions.
+Read src/index.ts and src/workflows/ to understand the resource definitions.
 
 ## Operations
 
@@ -44904,26 +44825,64 @@ Populate with content based on the resource definitions in src/.
 
 **\`review\`:** Review all docs/ files for accuracy against the actual resource
 definitions. Flag mismatches between documented schemas and code.
+
+**\`checkpoint\`:** Save current work progress for session resume.
+Create or update \`docs/in-progress/<topic>.mdx\` with:
+- Current state and decisions made
+- Remaining work and blockers
+- Update \`docs/priorities.mdx\` with task status
+
+**\`cleanup\`:** Move completed documents from \`docs/in-progress/\` to their
+final location in \`docs/\`. Review each in-progress doc to determine if it's
+complete. Incomplete docs remain in \`docs/in-progress/\`.
+Also rebuild \`docs/navigation.mdx\` from the current project state.
+
+**\`resume\`:** Start-of-session command. Review in-progress docs, priorities,
+and recent deployment state. Present a summary: what's in progress, what's
+blocking, what's next. Offer to continue the highest-priority item.
+
+**\`verify [path]\`:** Cross-reference documentation with the codebase.
+Read the specified doc (or all docs if no path), compare claims against actual
+code (resource IDs, schema fields, platform tools used), and report
+discrepancies. Useful before \`/meta deploy\` to ensure docs are accurate.
 `;
 }
 function claudeResourceCommandTemplate() {
   return `# /resource command
 
-You are a resource scaffolding assistant for this Elevasis SDK project.
+You are a resource scaffolding assistant for this Elevasis workspace.
 
 ## Context
 
-Read CLAUDE.md for SDK patterns (single-step, multi-step, conditional, platform tools).
-Read src/index.ts for existing resource definitions and the OrganizationResources export.
+Read CLAUDE.md for navigation to SDK patterns (reference/resources/patterns.mdx).
+Read src/index.ts for the registry and src/workflows/ for existing resources.
+
+Before suggesting tools, read \`.claude/memory/profile/identity.md\` if it exists
+to check the user's known integrations and suggest relevant platform tools.
+
+## Guided Mode
+
+Before any operation, check \`.claude/memory/profile/skills.md\`. If the user's
+programming level is \`none\` or \`minimal\`, or automation level is \`none\`,
+activate Guided Mode:
+
+1. Ask: "What does this workflow need to do?" -- let user describe in plain English
+2. Based on description, suggest a resourceId, input schema fields, output schema
+   fields, and whether platform tools are needed
+3. Show suggestions and ask for confirmation before generating code
+4. Generate the complete resource using the confirmed structure
+
+This wraps existing operations with conversational discovery for users who
+cannot specify schemas directly.
 
 ## Operations
 
-**\`workflow <name>\`:** Create a new single-step workflow definition with:
+**\`workflow <name>\`:** Create a new workflow in \`src/workflows/<name>.ts\` with:
 - Zod input/output schemas with \`z.infer\` type aliases
 - Config object (resourceId, name, type, description, version, status)
 - Contract with schemas
 - Step definition with handler
-- Add to the OrganizationResources export
+- Add the import to \`src/index.ts\` registry
 
 **\`multi-step <name>\`:** Create a multi-step workflow with:
 - Multiple steps connected via StepType.LINEAR or StepType.CONDITIONAL
@@ -44932,6 +44891,7 @@ Read src/index.ts for existing resource definitions and the OrganizationResource
 - Linear: \`next: { type: StepType.LINEAR, target: 'step-two' }\`
 - Conditional: \`next: { type: StepType.CONDITIONAL, routes: [...], default: 'fallback' }\`
 - Last step: \`next: null\`
+- Add to \`src/index.ts\` registry
 
 **\`tool-step <name>\`:** Create a step that calls a platform tool:
 - Import \`{ platform, PlatformToolError }\` from '@elevasis/sdk/worker'
@@ -44940,106 +44900,479 @@ Read src/index.ts for existing resource definitions and the OrganizationResource
 - Note: 60s timeout per call, credential required for integration tools
 `;
 }
-function claudeDeployCommandTemplate() {
-  return `# /deploy command
+function claudeTutorialCommandTemplate() {
+  return `# /tutorial command
 
-You are a deployment assistant for this Elevasis SDK project.
+You are a tutorial guide for this Elevasis workspace.
 
-## Pre-deploy Checklist
+## Context
 
-Before deploying, verify:
-1. Run \`elevasis check\` -- fix any validation errors
-2. Ensure .env has ELEVASIS_API_KEY set
-3. Review resource status fields (dev vs production)
+Read \`.claude/memory/profile/skills.md\` to adapt lesson pacing and vocabulary.
+Read \`.claude/memory/tutorial-progress.md\` to check current lesson progress.
+Read \`reference/concepts/index.mdx\` for teaching vocabulary and concept definitions.
+
+## Invocation
+
+- \`/tutorial\` -- Resume from current lesson. If no progress exists, start Lesson 1.
+- \`/tutorial start\` -- Reset progress and begin from Lesson 1.
+- \`/tutorial <number>\` -- Jump to a specific lesson (1-7).
+
+## Lesson Flow
+
+Each lesson follows this flow:
+1. Announce lesson title and what they'll learn (1-2 sentences)
+2. Explain the concept (read concepts page, adapt to skill level)
+3. Guide user to build or modify something (show complete code for beginners)
+4. Verify it works (run CLI command, check output)
+5. Celebrate success, record observations in \`.claude/memory/tutorial-progress.md\`
+6. Ask: "Ready for the next lesson, or want to practice more?"
+
+## Lessons
+
+**Lesson 1: Welcome & Orientation**
+Tour project files: src/index.ts (registry), src/workflows/echo.ts (starter
+workflow), elevasis.config.ts, .env, docs/. Explain the execution model.
+Verify: run \`elevasis resources\`. Observation focus: cloud deployment model.
+
+**Lesson 2: Your First Custom Workflow**
+Modify the echo workflow. Walk through each part: config, contract, steps,
+entryPoint. Deploy: \`elevasis check\` then \`elevasis deploy\`. Test with
+\`elevasis exec echo --input '{"message":"hello"}'\`.
+Observation focus: TypeScript syntax comfort.
+
+**Lesson 3: Understanding Data (Schemas)**
+Explain schemas in plain English (concepts page). Show common Zod types.
+Explain \`z.infer\`. Build a new workflow with real-world input schema based
+on the user's goals (read .claude/memory/profile/identity.md).
+Observation focus: optional fields, types, suggesting own fields.
+
+**Lesson 4: Using Platform Tools**
+Explain platform tools (concepts page). Browse available tools via
+reference/platform-tools/index.mdx. Pick a tool based on user's goals.
+Build: add a platform.call() step. Explain credential setup.
+Observation focus: credential model, async/await.
+
+**Lesson 5: Multi-Step Workflows**
+Chain steps with StepType.LINEAR. Build a 2-step workflow. Explain data
+flow between steps. Deploy and test.
+Observation focus: data flow reasoning.
+
+**Lesson 6: Decision Points**
+Conditional routing with StepType.CONDITIONAL. Add a condition to the
+multi-step workflow from Lesson 5. Test both paths.
+Observation focus: branching logic reasoning.
+
+**Lesson 7: Going to Production**
+Change status from dev to production. Show monitoring: elevasis executions,
+elevasis execution. Cover error handling: try/catch, ExecutionError,
+PlatformToolError. Suggest next steps based on goals.
+Observation focus: readiness for independent development.
+
+## Adaptation Rules
+
+- If user is intermediate/advanced (from skills.md), condense explanations
+- If user struggles, slow down with more plain-English explanation
+- If user is fast, acknowledge and offer to skip ahead
+- After each lesson, update \`.claude/memory/tutorial-progress.md\`
+- If user demonstrates a level change, promote to skills.md Growth Log
+
+## Progress Format
+
+Store in \`.claude/memory/tutorial-progress.md\`:
+- Current Lesson number
+- Started and Last Session dates
+- Completed Lessons table (lesson, title, completed, duration)
+- Capability Observations table (lesson, observation)
+- Assessment Notes (bullet points)
+`;
+}
+function claudeHelpCommandTemplate() {
+  return `# /help command
+
+You are a navigation assistant for this Elevasis workspace.
+
+## Operations
+
+**\`/help\` (no args):** Display the full command tree:
+
+\`\`\`
+Available Commands:
+
+/meta            Project lifecycle
+  /meta init       First-run setup and onboarding
+  /meta status     Project health and template version
+  /meta update     SDK upgrade and template merge
+  /meta fix        Drift repair
+  /meta deploy     Full deploy pipeline (validate, git, deploy, verify)
+  /meta health     Execution debugging and resource status
+  /meta develop    Development navigation hub (resources, tools, examples)
+
+/docs            Documentation lifecycle
+  /docs            Show documentation status
+  /docs create     Create new documentation page
+  /docs checkpoint Save progress for session resume
+  /docs cleanup    Move completed docs, rebuild navigation maps
+  /docs resume     Review in-progress work and priorities
+  /docs verify     Cross-reference docs with codebase for accuracy
+
+/database        Database operations
+  /database init     Connect Supabase project
+  /database browse   Query and display table contents
+  /database query    Run filtered queries
+  /database schema   View/compare schema documentation
+  /database import   Import CSV/JSON data
+
+/resource        Scaffold a new workflow or agent
+/templates       Discover and apply workflow templates
+/agent           Agent development (placeholder)
+/tutorial        Progressive learning path
+/profile         View and update developer profile
+/help            This help menu
+
+Navigation:
+- docs/navigation.mdx     Resource and documentation map
+- docs/priorities.mdx      Current goals and priorities
+- memory/index.md          Cross-session knowledge
+\`\`\`
+
+**\`/help <command>\`:** Show detailed help for a specific command with its
+subcommands and usage examples. Read the corresponding command file at
+\`.claude/commands/<command>.md\` and present a summary.
+`;
+}
+function claudeTemplatesCommandTemplate() {
+  return `# /templates command
+
+You are a workflow template assistant for this Elevasis workspace.
+
+## Context
+
+Read \`reference/templates/\` in node_modules/@elevasis/sdk/reference/templates/
+for available template definitions. Read src/index.ts for the current registry.
+Read \`.claude/memory/profile/skills.md\` to adapt generated code to skill level.
 
 ## Operations
 
-**No arguments (default):**
-1. Run \`elevasis check\` to validate
-2. If check passes, run \`elevasis deploy\`
-3. If deploy fails, analyze the error and suggest fixes
+**\`/templates\` (no args):** Show available template categories:
+- Data Collection (web scraper, RSS feed reader, form handler)
+- Data Processing (CSV import, data enrichment, deduplication)
+- Communication (email sender, notification dispatcher)
+- CRM (contact sync, lead scoring, pipeline update)
+- Documents (PDF generator, report builder, invoice creator)
+- AI (text classifier, data extractor, summarizer)
+- Scheduling (recurring job, delayed task, batch processor)
+
+**\`/templates <category>\`:** Show templates in the category with descriptions.
+
+**\`/templates apply <name>\`:** Generate a workflow from the template:
+1. Read the template definition from reference/templates/<name>.mdx
+2. Generate a workflow file in src/workflows/<name>.ts
+3. Add the import to src/index.ts registry
+4. If the template uses platform tools, prompt for credential setup
+5. If the template uses the database, check that /database init has been run
+6. Run \`elevasis check\` to validate
+
+Templates are documentation-based. The agent reads the template definition
+and generates context-aware code adapted to the user's existing schemas,
+credentials, skill level, and naming conventions.
+`;
+}
+function claudeDatabaseCommandTemplate() {
+  return `# /database command
+
+You are a database assistant for this Elevasis workspace.
+
+## Context
+
+Read \`data/schema.ts\` if it exists for the current schema documentation.
+Read \`.claude/memory/deployment-state.md\` for database connection status.
+Read \`.claude/memory/profile/skills.md\` to adapt explanations.
+
+## Operations
+
+**\`/database init\`:** Guide user through Supabase project setup:
+1. Explain Supabase (free, great dashboard, integrates with workflows)
+2. Walk through: create project at supabase.com/dashboard
+3. Collect Project URL and service_role key
+4. Store as platform credential named 'my-database' via command center
+5. Test connection
+6. Create data/schema.ts with initial table documentation
+7. Record database connection in memory/deployment-state.md
+
+**\`/database\` (no args):** Show database connection status, tables, row counts.
+
+**\`/database add <table>\`:** Create a migration script:
+1. Generate scripts/migrations/NNN-create-<table>.ts
+2. Show the script and explain each statement
+3. Confirm before execution
+4. Update data/schema.ts and docs/database.mdx
+
+**\`/database browse <table>\`:** Query and display table contents via CLI.
+
+**\`/database schema\`:** Show data/schema.ts contents, compare against live DB.
+
+**\`/database import <table> --file <path>\`:** Import CSV/JSON into a table.
 
-**\`status\`:** Run \`elevasis deployments\` to show current deployment status,
-then \`elevasis resources\` to list deployed resources.
+## Database Safety
+
+ALWAYS confirm with the user before:
+- DROP TABLE or DROP COLUMN operations
+- DELETE without a WHERE clause (bulk delete)
+- TRUNCATE operations
+- ALTER TABLE that removes columns
+- Any operation that cannot be undone
+
+For read operations and targeted writes (INSERT, UPDATE with WHERE),
+proceed normally.
+
+## Supabase Platform Tool
+
+Workflows access the database via platform.call({ tool: 'supabase', ... }).
+Methods: insert, select, update, delete, upsert, rpc, count.
+Filter syntax uses PostgREST format (eq, neq, gt, gte, lt, lte, like, ilike, in, is).
+`;
+}
+function claudeAgentCommandTemplate() {
+  return `# /agent command
+
+You are an agent development assistant for this Elevasis workspace.
+
+## Current State
+
+Agent definitions are accepted by the SDK and appear in the registry.
+Autonomous agent execution (multi-turn tool use loops) is deferred.
+LLM calls are available via \`platform.call({ tool: 'llm' })\` as a workaround.
+
+## Operations
+
+**\`/agent\` (no args):** Explain the current state:
+- Agent definitions are accepted by the SDK and appear in the registry
+- Autonomous agent execution (multi-turn tool use loops) is deferred
+- LLM calls are available via platform.call({ tool: 'llm' }) as a workaround
+- Show the AgentDefinition pattern for future use
+
+**\`/agent scaffold <name>\`:** Create an agent definition with:
+- Config (resourceId, name, type, description, version, status)
+- System prompt
+- Available tools list
+- Note that execution will fail until agent runtime is implemented
+- Add to src/index.ts registry
 `;
 }
-function claudeInspectCommandTemplate() {
-  return `# /inspect command
+function claudeProfileCommandTemplate() {
+  return `# /profile command
 
-You are a deployment health and execution debugging assistant.
+You are a profile management assistant for this Elevasis workspace.
 
 ## Context
 
-Read CLAUDE.md for project context and CLI reference.
+Read \`.claude/memory/profile/index.md\` to discover profile sub-files.
+Read the sub-files (identity.md, skills.md, preferences.md) to load the current profile.
+
+If \`.claude/memory/profile/\` does not exist, suggest running \`/meta init\` to create it.
 
 ## Operations
 
-**No arguments (default):** Run a health overview:
-1. Run \`elevasis deployments\` to show deployment status
-2. Run \`elevasis resources\` to list deployed resources
-3. Summarize: deployment age, resource count, any issues
-
-**\`executions <resourceId>\`:** Show execution history:
-1. Run \`elevasis executions <resourceId>\`
-2. Summarize: success/failure counts, recent trends
-3. If failures exist, suggest drilling into specific executions
-
-**\`describe <resourceId>\`:** Show resource schemas:
-1. Run \`elevasis describe <resourceId>\`
-2. Display input/output schemas in a readable format
-3. Generate an example \`elevasis exec\` command from the input schema
-
-**\`execution <resourceId> <executionId>\`:** Drill into a specific execution:
-1. Run \`elevasis execution <resourceId> <executionId>\`
-2. Show status, timing, input, output
-3. If failed, analyze the error and suggest fixes
-
-**\`failed <resourceId>\`:** Find and analyze recent failures:
-1. Run \`elevasis executions <resourceId> --status failed --limit 5\`
-2. For each failure, run \`elevasis execution <resourceId> <id> --logs-only\`
-3. Identify patterns and suggest fixes
+**No arguments (default):** Display the current profile in a readable format.
+Show organization, industry, experience level, goals, known integrations, and preferences.
+Ask if anything needs updating.
+
+**\`update\`:** Walk through each profile section, showing current values and
+asking if they should change. Only update fields the user wants to change.
+Write changes to the appropriate memory/profile/ file.
+
+**\`level\`:** Assess the user's current skill level based on their project
+history (resources created, successful deploys, error handling patterns).
+Suggest updating memory/profile/skills.md if the assessment differs from the stored level.
+
+**\`assess\`:** Re-run the competency assessment questions from /meta init.
+Update all skill dimensions in memory/profile/skills.md.
 `;
 }
-function claudeEnvCommandTemplate() {
-  return `# /env command
+function claudeMetaCommandTemplate() {
+  return `# /meta command
 
-You are an environment variable management assistant.
+You are a project management assistant for this Elevasis workspace.
 
 ## Context
 
-Read CLAUDE.md for project context and CLI reference.
-Read .env for local environment variables.
+Read \`elevasis.config.ts\` to get the current \`templateVersion\`.
+Read \`package.json\` to get the installed \`@elevasis/sdk\` version.
+Read \`.claude/memory/index.md\` if it exists for project state.
 
 ## Operations
 
-**No arguments (default):** Compare local vs platform:
-1. Read .env file and extract variable names
-2. Run \`elevasis env list\` to get platform variables
-3. Show comparison: what is local-only, platform-only, or in both
-4. Suggest actions for any mismatches
-
-**\`set <NAME> <VALUE>\`:** Set a platform variable:
-1. Run \`elevasis env set <NAME> <VALUE>\`
-2. Remind user to redeploy: \`elevasis deploy\`
-
-**\`sync\`:** Walk .env and sync to platform:
-1. Read .env file
-2. For each variable (except ELEVASIS_API_KEY), check if it exists on platform
-3. Show what would be added/updated
-4. Ask for confirmation before running \`elevasis env set\` for each
-5. Remind user to redeploy after syncing
+### \`/meta init\` -- First-Run Setup
+
+Guided setup for a freshly scaffolded workspace. Triggered automatically
+by the \`<!-- initialized: false -->\` flag in CLAUDE.md, or run manually.
+
+1. **Install dependencies**
+   Run \`pnpm install\`. Wait for completion. Report any errors.
+
+2. **Setup environment**
+   Check if \`.env\` has \`ELEVASIS_API_KEY\` set.
+   If not, ask the user for their API key and write it to \`.env\`.
+   Validate the key works: run \`elevasis resources\` (should return empty list,
+   not an auth error).
+
+3. **Competency Assessment**
+   Ask these questions to build the user's profile:
+
+   Identity & Goals (3 questions):
+   - "What does your business or team do?"
+   - "What do you want to automate with Elevasis?"
+   - "Which tools does your team already use?" (email, CRM, spreadsheets, etc.)
+
+   Competency (2-3 questions with conditional skipping):
+   - "Have you written code before? If so, what kind?"
+     No code -> programming: none, skip next question
+     HTML/CSS/Excel -> programming: minimal, skip next question
+     Scripts/websites -> programming: intermediate, ask next question
+     Production apps -> programming: advanced, ask next question
+   - (Only if scripts+) "Have you used TypeScript or a typed language?"
+     No -> typescript: none
+     Read it / used typed language -> typescript: exposure
+     Written TypeScript projects -> typescript: proficient
+   - "Have you used automation tools? (Zapier, Make, cron jobs, scripts)"
+     No -> automation: none
+     Zapier/Make flows -> automation: low-code
+     Custom scripts -> automation: custom
+
+   Communication (1 question):
+   - "Step-by-step explanations or concise answers?"
+
+   Write responses to memory:
+   - Create \`.claude/memory/index.md\` (root index)
+   - Create \`.claude/memory/profile/index.md\` (profile index)
+   - Create \`.claude/memory/profile/identity.md\` (org, goals, tools)
+   - Create \`.claude/memory/profile/skills.md\` (multi-dimensional assessment)
+   - Create \`.claude/memory/profile/preferences.md\` (verbosity, guidance)
+
+4. **Git check**
+   - If \`.git/\` exists: note git is configured in memory/profile/preferences.md
+   - If \`.git/\` does not exist: suggest \`git init\` and optionally GitHub
+   - If git remote exists: note remote URL in memory/profile/preferences.md
+
+5. **Verify project**
+   Run \`elevasis check\` to confirm the starter resource is valid.
+   Optionally deploy the echo workflow.
+
+6. **Report**
+   Summary of what was set up. Suggest next steps based on goals.
+
+   If the user's TypeScript level is beginner or automation level is new,
+   suggest /tutorial start: "I recommend starting with /tutorial -- it walks
+   you through building workflows step by step, at your own pace."
+
+7. **Update flag**
+   Change \`<!-- initialized: false -->\` to \`<!-- initialized: true -->\`
+   in CLAUDE.md.
+
+### \`/meta\` (no arguments) -- Project Status
+
+Display a project health summary:
+1. Current template version vs latest available
+2. SDK package version from package.json
+3. Profile summary (from memory/profile/skills.md)
+4. Quick drift check: count of missing managed files, missing gitignore entries
+
+### \`/meta update\` -- Full Upgrade
+
+Upgrade the SDK and merge template changes:
+
+1. Run \`pnpm update @elevasis/sdk\` to pull the latest SDK
+2. Run \`elevasis update\` to add missing files and flag conflicts
+3. For each flagged file in the output:
+   - Read the current project file
+   - Read the new template from \`@elevasis/sdk/templates\`
+   - Compare and merge intelligently:
+     - Add new sections that don't exist
+     - Preserve user customizations
+     - If a section differs, show both versions and let user choose
+4. Return a report of changes
+
+### \`/meta fix\` -- Fix Drift
+
+Detect and repair drift without a version upgrade:
+
+1. **Missing managed files:** Regenerate from templates
+2. **Gitignore drift:** Append missing entries
+3. **CLAUDE.md sections:** Add missing sections in correct position
+4. **Memory structure:** Verify index consistency
+5. **Doc cross-references:** Scan for broken links
+6. **Settings consistency:** Verify expected fields
+
+### \`/meta deploy\` -- Full Deploy Pipeline
+
+1. Run \`elevasis check\` (validation)
+2. Type check if \`tsconfig.json\` exists
+3. Verify docs reflect current resources
+4. If git configured: stage changes, commit with deploy message
+5. Run \`elevasis deploy\`
+6. Bump deployment version in \`docs/navigation.mdx\` metadata
+7. Verify deployment via platform
+8. Update \`memory/deployment-state.md\` with count, timestamp, inventory
+9. If git configured and remote exists: optionally push
+
+Each step reports its result. Pipeline stops on failure with suggested fix.
+
+### \`/meta health\` -- Execution Debugging
+
+Renamed from /inspect. Checks:
+- Show recent executions with status (completed/failed)
+- For failed executions: analyze logs, cross-reference with memory/errors/
+- Check resource deployment status (deployed, outdated, never deployed)
+- Verify environment: API key valid, credentials accessible, DB connected
+
+### \`/meta develop\` -- Development Navigation Hub
+
+Primary development entry point. Loads a navigation map and offers actions.
+
+1. **Project Resource Map** -- from docs/navigation.mdx. Shows deployed
+   resources: resourceId, name, status, tools used, last deployment.
+2. **Development Actions** -- contextual based on resource map:
+   - Edit/extend a workflow
+   - Test a workflow
+   - Debug a failed execution
+   - Browse platform tools (read reference/platform-tools/index.mdx)
+   - Set up credentials
+   - View examples (read reference/resources/patterns.mdx)
+3. **SDK Reference Navigation** -- pointers to reference files
+4. **Upkeep Detection** -- check navigation freshness, in-progress items,
+   pending priorities. Suggest /docs cleanup or /docs resume if needed.
+
+## Merge Strategy
+
+- **CLAUDE.md:** Add new sections in correct position. Preserve customizations.
+- **Commands:** Usually additive. Show diff for changes.
+- **.gitignore:** Append-only -- never remove existing entries.
+
+## Template Access
+
+The agent reads current templates from the installed SDK:
+\`@elevasis/sdk/templates\` subpath exports all template functions.
 `;
 }
 function starterTemplate() {
-  return `import type { WorkflowDefinition, OrganizationResources } from '@elevasis/sdk'
+  return `import type { OrganizationResources } from '@elevasis/sdk'
+import { echo } from './workflows/echo.js'
+
+const org: OrganizationResources = {
+  workflows: [echo],
+}
+export default org
+`;
+}
+function starterWorkflowTemplate() {
+  return `import type { WorkflowDefinition } from '@elevasis/sdk'
 import { z } from 'zod'
 
 const echoInput = z.object({ message: z.string() })
 const echoOutput = z.object({ echo: z.string() })
-
 type EchoInput = z.infer<typeof echoInput>
 
-const echo: WorkflowDefinition = {
+export const echo: WorkflowDefinition = {
   config: {
     resourceId: 'echo',
     name: 'Echo',
@@ -45053,7 +45386,7 @@ const echo: WorkflowDefinition = {
     outputSchema: echoOutput,
   },
   steps: {
-    'echo': {
+    echo: {
       id: 'echo',
       name: 'Echo Message',
       description: 'Returns the input message',
@@ -45063,73 +45396,158 @@ const echo: WorkflowDefinition = {
       },
       inputSchema: echoInput,
       outputSchema: echoOutput,
-      next: null, // terminal step -- single-step workflow
+      next: null,
     },
   },
   entryPoint: 'echo',
 }
-
-const org: OrganizationResources = {
-  workflows: [echo],
-}
-export default org
 `;
 }
 
-// src/cli/commands/env.ts
-function registerEnvCommand(program3) {
-  const env2 = program3.command("env").description("Manage environment variables for your deployment");
-  env2.command("list").description("List environment variable names").option("--api-url <url>", "API URL").option("--json", "Output as JSON").action(wrapAction("env list", async (options2) => {
-    const apiUrl = resolveApiUrl(options2.apiUrl);
-    const spinner = ora("Fetching environment variables...").start();
-    const data = await apiGet(
-      "/api/external/env",
-      apiUrl
-    );
-    spinner.stop();
-    if (options2.json) {
-      console.log(JSON.stringify(data.envVars, null, 2));
-      return;
+// src/cli/commands/update.ts
+var import_path4 = require("path");
+var import_promises3 = require("fs/promises");
+function registerUpdateCommand(program3) {
+  program3.command("update").description("Update project scaffold to latest template version").action(wrapAction("update", async () => {
+    const cwd = process.cwd();
+    const configPath = (0, import_path4.resolve)(cwd, "elevasis.config.ts");
+    let currentVersion = 0;
+    let configContents = "";
+    try {
+      configContents = await (0, import_promises3.readFile)(configPath, "utf-8");
+      const match = configContents.match(/templateVersion:\s*(\d+)/);
+      if (match) {
+        currentVersion = parseInt(match[1], 10);
+      }
+    } catch {
     }
-    if (data.envVars.length === 0) {
-      console.log(source_default.yellow("No environment variables set."));
-      console.log(source_default.gray("Set one with: elevasis env set NAME VALUE"));
+    if (currentVersion >= TEMPLATE_VERSION) {
+      console.log(source_default.green(`  Project is up to date (template version ${TEMPLATE_VERSION})`));
       return;
     }
-    console.log(source_default.cyan("Environment Variables:"));
-    for (const v of data.envVars) {
-      console.log(source_default.white(`  ${source_default.bold(v.name)}  ${source_default.gray(`(updated ${v.updatedAt})`)}  ${source_default.gray("********")}`));
+    const templateMap = {
+      "elevasis.config.ts": configTemplate,
+      ".gitignore": gitignoreTemplate,
+      "CLAUDE.md": claudeMdTemplate,
+      ".claude/settings.json": claudeSettingsTemplate,
+      ".claude/commands/docs.md": claudeDocsCommandTemplate,
+      ".claude/commands/resource.md": claudeResourceCommandTemplate,
+      ".claude/commands/tutorial.md": claudeTutorialCommandTemplate,
+      ".claude/commands/help.md": claudeHelpCommandTemplate,
+      ".claude/commands/templates.md": claudeTemplatesCommandTemplate,
+      ".claude/commands/database.md": claudeDatabaseCommandTemplate,
+      ".claude/commands/agent.md": claudeAgentCommandTemplate,
+      ".claude/commands/profile.md": claudeProfileCommandTemplate,
+      ".claude/commands/meta.md": claudeMetaCommandTemplate
+    };
+    const added = [];
+    const flagged = [];
+    const appendedGitignore = [];
+    for (const file2 of MANAGED_FILES) {
+      const filePath = (0, import_path4.resolve)(cwd, file2);
+      const templateFn = templateMap[file2];
+      if (!templateFn) continue;
+      const templateContent = templateFn();
+      if (file2 === ".gitignore") {
+        try {
+          await (0, import_promises3.access)(filePath);
+          const existingContent = await (0, import_promises3.readFile)(filePath, "utf-8");
+          const existingLines = existingContent.split("\n");
+          const templateLines = templateContent.split("\n");
+          const linesToAppend = [];
+          for (const line of templateLines) {
+            if (line.trim() === "") continue;
+            if (!existingLines.includes(line)) {
+              linesToAppend.push(line);
+            }
+          }
+          if (linesToAppend.length > 0) {
+            const appendContent = (existingContent.endsWith("\n") ? "" : "\n") + linesToAppend.join("\n") + "\n";
+            await (0, import_promises3.writeFile)(filePath, existingContent + appendContent, "utf-8");
+            appendedGitignore.push(...linesToAppend);
+          }
+        } catch {
+          await (0, import_promises3.mkdir)((0, import_path4.dirname)(filePath), { recursive: true });
+          await (0, import_promises3.writeFile)(filePath, templateContent, "utf-8");
+          added.push(file2);
+        }
+        continue;
+      }
+      if (file2 === "elevasis.config.ts") {
+        if (configContents) {
+          if (/templateVersion:\s*\d+/.test(configContents)) {
+            const updated = configContents.replace(
+              /templateVersion:\s*\d+/,
+              `templateVersion: ${TEMPLATE_VERSION}`
+            );
+            await (0, import_promises3.writeFile)(filePath, updated, "utf-8");
+          } else {
+            const updated = configContents.replace(
+              /\bexport default\s*\{/,
+              `export default {
+  templateVersion: ${TEMPLATE_VERSION},`
+            );
+            await (0, import_promises3.writeFile)(filePath, updated, "utf-8");
+          }
+        } else {
+          await (0, import_promises3.mkdir)((0, import_path4.dirname)(filePath), { recursive: true });
+          await (0, import_promises3.writeFile)(filePath, templateContent, "utf-8");
+          added.push(file2);
+        }
+        continue;
+      }
+      let exists = false;
+      try {
+        await (0, import_promises3.access)(filePath);
+        exists = true;
+      } catch {
+      }
+      if (!exists) {
+        await (0, import_promises3.mkdir)((0, import_path4.dirname)(filePath), { recursive: true });
+        await (0, import_promises3.writeFile)(filePath, templateContent, "utf-8");
+        added.push(file2);
+      } else {
+        const existingContent = await (0, import_promises3.readFile)(filePath, "utf-8");
+        if (existingContent === templateContent) {
+        } else {
+          flagged.push(file2);
+        }
+      }
+    }
+    console.log("");
+    console.log(source_default.green.bold(`  Updated @elevasis/sdk template v${currentVersion} -> v${TEMPLATE_VERSION}`));
+    if (added.length > 0) {
+      console.log("");
+      console.log("  Added:");
+      for (const file2 of added) {
+        console.log(source_default.green(`    ${file2}`));
+      }
     }
-    console.log(source_default.gray(`
-${data.envVars.length} variable(s)`));
-  }));
-  env2.command("set <name> <value>").description("Set an environment variable (creates or updates)").option("--api-url <url>", "API URL").action(wrapAction("env set", async (name, value, options2) => {
-    const apiUrl = resolveApiUrl(options2.apiUrl);
-    const spinner = ora(`Setting ${name}...`).start();
-    await apiPut(
-      `/api/external/env/${encodeURIComponent(name)}`,
-      { value },
-      apiUrl
-    );
-    spinner.stop();
-    console.log(source_default.green(`Set ${source_default.bold(name)}`));
-    console.log(source_default.yellow("Redeploy to apply changes: elevasis deploy"));
-  }));
-  env2.command("remove <name>").description("Remove an environment variable").option("--api-url <url>", "API URL").action(wrapAction("env remove", async (name, options2) => {
-    const apiUrl = resolveApiUrl(options2.apiUrl);
-    const spinner = ora(`Removing ${name}...`).start();
-    await apiDelete(
-      `/api/external/env/${encodeURIComponent(name)}`,
-      apiUrl
-    );
-    spinner.stop();
-    console.log(source_default.green(`Removed ${source_default.bold(name)}`));
-    console.log(source_default.yellow("Redeploy to apply changes: elevasis deploy"));
+    if (appendedGitignore.length > 0) {
+      console.log("");
+      console.log("  Appended to .gitignore:");
+      for (const entry of appendedGitignore) {
+        console.log(source_default.yellow(`    ${entry}`));
+      }
+    }
+    if (flagged.length > 0) {
+      console.log("");
+      console.log("  Needs agent review:");
+      for (const file2 of flagged) {
+        console.log(source_default.cyan(`    ${file2} (differs from template)`));
+      }
+    }
+    if (flagged.length > 0) {
+      console.log("");
+      console.log(source_default.gray("  Run /meta update in Claude Code to merge flagged files."));
+      console.log(source_default.gray("  Or run /meta fix to verify and repair the full framework."));
+    }
+    console.log("");
   }));
 }
 
 // src/cli/index.ts
-(0, import_dotenv.config)({ path: (0, import_path4.resolve)(process.cwd(), ".env"), override: false });
+(0, import_dotenv.config)({ path: (0, import_path5.resolve)(process.cwd(), ".env"), override: false });
 var program2 = new Command();
 program2.name("elevasis").description(
   source_default.cyan("Elevasis SDK CLI") + `
@@ -45143,10 +45561,8 @@ Commands:
   elevasis executions <resourceId>              List execution history
   elevasis execution <resourceId> <id>          Get execution details
   elevasis deployments                          List deployments
-  elevasis env list                              List environment variables
-  elevasis env set NAME VALUE                    Set an environment variable
-  elevasis env remove NAME                       Remove an environment variable
-  elevasis init [directory]                     Scaffold a new project
+  elevasis update                              Update workspace scaffold to latest template
+  elevasis init [directory]                     Scaffold a new workspace
 
 Use "elevasis <command> --help" for more information about a command.`
 ).version(SDK_VERSION);
@@ -45159,7 +45575,7 @@ registerExecutionCommand(program2);
 registerDescribeCommand(program2);
 registerDeploymentsCommand(program2);
 registerInitCommand(program2);
-registerEnvCommand(program2);
+registerUpdateCommand(program2);
 program2.parse();
 /*! Bundled license information: