@elevasis/sdk 0.5.21 → 0.5.24

package/dist/cli.cjs

@@ -43873,7 +43873,7 @@ async function apiDelete(endpoint, apiUrl = resolveApiUrl()) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "0.5.21",
+  version: "0.5.24",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -45210,7 +45210,7 @@ var import_path3 = require("path");
 var import_promises2 = require("fs/promises");
 
 // src/cli/commands/templates/core/workspace.ts
-var TEMPLATE_VERSION = 31;
+var TEMPLATE_VERSION = 32;
 function configTemplate() {
   return `import type { ElevasConfig } from '@elevasis/sdk'
 
@@ -46980,6 +46980,7 @@ This file is yours. The other \`.claude/rules/\` files are SDK-owned and updated
 - \`memory-conventions.md\` -- memory system structure and pruning
 - \`project-map.md\` -- auto-generated project map conventions
 - \`task-tracking.md\` -- in-progress task conventions
+- \`logging.md\` -- context.logger usage, console.log prohibition, logging standard
 
 ## When to Add a Rule
 
@@ -47119,6 +47120,77 @@ When all plan steps are marked COMPLETE, **suggest** completing the task -- neve
 - Completed tasks move OUT of \`docs/in-progress/\` to \`docs/<relevant-dir>/\`
 `;
 }
+function claudeLoggingRuleTemplate() {
+  return `---
+description: Logging conventions for workflow and agent handlers
+paths:
+  - src/**
+---
+
+# Logging
+
+## Always Use \`context.logger\` in Handlers
+
+**Never use \`console.log\`, \`console.warn\`, or \`console.error\` in step/agent handlers.**
+The platform does not capture \`console.*\` output \u2014 it will not appear in execution logs.
+
+\`\`\`typescript
+// \u274C WRONG \u2014 invisible in Command Center
+handler: async (rawInput) => {
+  console.log('Processing...')
+}
+
+// \u2705 CORRECT \u2014 visible in Command Center
+handler: async (rawInput, context) => {
+  context.logger.info('Processing...')
+}
+\`\`\`
+
+## Logger Methods
+
+\`\`\`typescript
+context.logger.debug('Verbose detail \u2014 shown in debug mode only')
+context.logger.info('Normal progress messages')
+context.logger.warn('Non-fatal issue \u2014 skipped, retried, partial result')
+context.logger.error('Fatal error or unexpected failure')
+\`\`\`
+
+## Extensive Logging Standard
+
+Every handler should log:
+
+1. **Entry** \u2014 step name + key input params (category, count, domain, etc.)
+2. **Progress** \u2014 inside loops: per-item status (processed, skipped, failed)
+3. **Decisions** \u2014 idempotency skips, early exits, conditional branches
+4. **Summary** \u2014 counts at the end (X processed, Y skipped, Z errors)
+
+\`\`\`typescript
+handler: async (rawInput, context) => {
+  const data = rawInput as SomeType
+  context.logger.info(\`[step-name] Starting \u2014 \${data.items.length} items\`)
+
+  let processed = 0, skipped = 0
+  for (const item of data.items) {
+    if (item.alreadyDone) {
+      skipped++
+      context.logger.info(\`[step-name] Skipping \${item.name} \u2014 already complete\`)
+      continue
+    }
+    // ...
+    processed++
+    context.logger.info(\`[step-name] Processed \${item.name}\`)
+  }
+
+  context.logger.info(\`[step-name] Done \u2014 \${processed} processed, \${skipped} skipped\`)
+}
+\`\`\`
+
+## Warnings vs Errors
+
+- \`warn\`: skipped item, not found in DB, LLM timeout on one domain (processing continues)
+- \`error\`: step-level failures that propagate as thrown errors (log before throwing if possible)
+`;
+}
 function claudePostEditValidateHookTemplate() {
   return `#!/usr/bin/env node
 // post-edit-validate.mjs
@@ -47498,7 +47570,8 @@ function getManagedTemplates(ctx = {}) {
     ".claude/rules/docs-authoring.md": claudeDocsAuthoringRuleTemplate,
     ".claude/rules/memory-conventions.md": claudeMemoryConventionsRuleTemplate,
     ".claude/rules/project-map.md": claudeProjectMapRuleTemplate,
-    ".claude/rules/task-tracking.md": claudeTaskTrackingRuleTemplate
+    ".claude/rules/task-tracking.md": claudeTaskTrackingRuleTemplate,
+    ".claude/rules/logging.md": claudeLoggingRuleTemplate
   };
 }
 
@@ -47713,6 +47786,7 @@ var MANAGED_FILES = [
   ".claude/rules/memory-conventions.md",
   ".claude/rules/project-map.md",
   ".claude/rules/task-tracking.md",
+  ".claude/rules/logging.md",
   ".claude/scripts/statusline-command.js"
 ];
 var SCAFFOLD_FILES = [...INIT_ONLY_FILES, ...MANAGED_FILES];
@@ -47784,6 +47858,7 @@ function registerInitCommand(program3) {
         ".claude/rules/memory-conventions.md": claudeMemoryConventionsRuleTemplate(),
         ".claude/rules/project-map.md": claudeProjectMapRuleTemplate(),
         ".claude/rules/task-tracking.md": claudeTaskTrackingRuleTemplate(),
+        ".claude/rules/logging.md": claudeLoggingRuleTemplate(),
         ".claude/scripts/statusline-command.js": claudeStatuslineScriptTemplate()
       };
       if (options2.ui) {