prjct-cli 0.47.0 → 0.49.0

package/dist/bin/prjct.mjs

@@ -1944,10 +1944,130 @@ var init_branding = __esm({
   }
 });
 
+// core/utils/error-messages.ts
+function getError(code, overrides) {
+  const base = ERRORS[code];
+  return { ...base, ...overrides };
+}
+function createError(message, hint, options) {
+  return {
+    message,
+    hint,
+    ...options
+  };
+}
+var ERRORS;
+var init_error_messages = __esm({
+  "core/utils/error-messages.ts"() {
+    "use strict";
+    ERRORS = {
+      // Project errors
+      NO_PROJECT: {
+        message: "No prjct project found in this directory",
+        hint: "Run 'prjct init' to set up a new project",
+        file: ".prjct/prjct.config.json"
+      },
+      NO_PROJECT_ID: {
+        message: "Project ID not found",
+        hint: "Run 'prjct init' or check .prjct/prjct.config.json",
+        file: ".prjct/prjct.config.json"
+      },
+      CONFIG_NOT_FOUND: {
+        message: "Configuration file not found",
+        hint: "Run 'prjct init' to create project configuration",
+        file: ".prjct/prjct.config.json"
+      },
+      CONFIG_INVALID: {
+        message: "Invalid configuration file",
+        hint: "Check JSON syntax or delete .prjct/ and run init again",
+        file: ".prjct/prjct.config.json"
+      },
+      // Git errors
+      GIT_NOT_FOUND: {
+        message: "Git repository not detected",
+        hint: "Run 'git init' first, then 'prjct init'"
+      },
+      GIT_NO_COMMITS: {
+        message: "No commits in repository",
+        hint: "Make an initial commit before using prjct"
+      },
+      GIT_DIRTY: {
+        message: "Working directory has uncommitted changes",
+        hint: "Commit or stash changes, or use '--force' to override"
+      },
+      GIT_ON_MAIN: {
+        message: "Cannot ship from main/master branch",
+        hint: "Create a feature branch first: git checkout -b feature/your-feature"
+      },
+      GIT_OPERATION_FAILED: {
+        message: "Git operation failed",
+        hint: "Check git status and resolve any conflicts"
+      },
+      // Auth errors
+      GH_NOT_AUTHENTICATED: {
+        message: "GitHub CLI not authenticated",
+        hint: "Run 'gh auth login' to authenticate",
+        docs: "https://cli.github.com/manual/gh_auth_login"
+      },
+      LINEAR_NOT_CONFIGURED: {
+        message: "Linear integration not configured",
+        hint: "Run 'p. linear setup' to configure Linear"
+      },
+      LINEAR_API_ERROR: {
+        message: "Linear API error",
+        hint: "Check your API key or network connection"
+      },
+      // Task errors
+      NO_ACTIVE_TASK: {
+        message: "No active task",
+        hint: `Start a task with 'p. task "description"'`
+      },
+      TASK_ALREADY_ACTIVE: {
+        message: "A task is already in progress",
+        hint: "Complete it with 'p. done' or pause with 'p. pause'"
+      },
+      // Sync errors
+      SYNC_FAILED: {
+        message: "Project sync failed",
+        hint: "Check file permissions and try again"
+      },
+      // Ship errors
+      NOTHING_TO_SHIP: {
+        message: "Nothing to ship",
+        hint: "Make some changes first, then run ship"
+      },
+      PR_CREATE_FAILED: {
+        message: "Failed to create pull request",
+        hint: "Check GitHub auth and remote configuration"
+      },
+      // Provider errors
+      NO_AI_PROVIDER: {
+        message: "No AI provider detected",
+        hint: "Install Claude Code or Gemini CLI, then run 'prjct start'",
+        docs: "https://prjct.app/docs"
+      },
+      PROVIDER_NOT_CONFIGURED: {
+        message: "AI provider not configured for prjct",
+        hint: "Run 'prjct start' to configure your provider"
+      },
+      // Generic
+      UNKNOWN: {
+        message: "An unexpected error occurred",
+        hint: "Check the error details and try again"
+      }
+    };
+    __name(getError, "getError");
+    __name(createError, "createError");
+  }
+});
+
 // core/utils/output.ts
 var output_exports = {};
 __export(output_exports, {
+  ERRORS: () => ERRORS,
+  createError: () => createError,
   default: () => output_default,
+  getError: () => getError,
   isQuietMode: () => isQuietMode,
   setQuietMode: () => setQuietMode
 });
@@ -1963,6 +2083,8 @@ var init_output = __esm({
   "core/utils/output.ts"() {
     "use strict";
     init_branding();
+    init_error_messages();
+    init_error_messages();
     _FRAMES = branding_default.spinner.frames;
     SPEED = branding_default.spinner.speed;
     interval = null;
@@ -2015,6 +2137,24 @@ var init_output = __esm({
         console.error(`${chalk2.red("\u2717")} ${truncate(msg, 65)}`);
         return this;
       },
+      // Rich error with context and recovery hint
+      failWithHint(error) {
+        this.stop();
+        const err = typeof error === "string" ? getError(error) : error;
+        console.error();
+        console.error(`${chalk2.red("\u2717")} ${err.message}`);
+        if (err.file) {
+          console.error(chalk2.dim(`  File: ${err.file}`));
+        }
+        if (err.hint) {
+          console.error(chalk2.yellow(`  \u{1F4A1} ${err.hint}`));
+        }
+        if (err.docs) {
+          console.error(chalk2.dim(`  Docs: ${err.docs}`));
+        }
+        console.error();
+        return this;
+      },
       warn(msg) {
         this.stop();
         if (!quietMode) console.log(`${chalk2.yellow("\u26A0")} ${truncate(msg, 65)}`);
@@ -5863,7 +6003,7 @@ function formatSubtaskLine(index, subtask, spinnerFrame = "\u25B6") {
   const num = `${DIM2}${String(index + 1).padStart(2)}${RESET2}`;
   const domainColor = getDomainColor(subtask.domain);
   const domain = `${domainColor}${subtask.domain.padEnd(10)}${RESET2}`;
-  const desc = subtask.description.length > 32 ? subtask.description.slice(0, 29) + "..." : subtask.description.padEnd(32);
+  const desc = subtask.description.length > 32 ? `${subtask.description.slice(0, 29)}...` : subtask.description.padEnd(32);
   let status;
   switch (subtask.status) {
     case "completed":
@@ -8755,7 +8895,9 @@ var init_memory_system = __esm({
           const matchingIds = /* @__PURE__ */ new Set();
           for (const tag of parsedTags) {
             const ids = db.index[tag];
-            ids.forEach((id) => matchingIds.add(id));
+            for (const id of ids) {
+              matchingIds.add(id);
+            }
           }
           return db.memories.filter((m) => matchingIds.has(m.id));
         }
@@ -9986,14 +10128,18 @@ var init_markdown_builder = __esm({
        * Add multiple list items
        */
       list(items, options) {
-        items.forEach((item) => this.li(item, options));
+        for (const item of items) {
+          this.li(item, options);
+        }
         return this;
       }
       /**
        * Add multiple numbered list items
        */
       orderedList(items) {
-        items.forEach((item, i) => this.oli(item, i + 1));
+        for (let i = 0; i < items.length; i++) {
+          this.oli(items[i], i + 1);
+        }
         return this;
       }
       /**
@@ -10079,7 +10225,9 @@ var init_markdown_builder = __esm({
        * Iterate and build for each item
        */
       each(items, builder) {
-        items.forEach((item, i) => builder(this, item, i));
+        for (let i = 0; i < items.length; i++) {
+          builder(this, items[i], i);
+        }
         return this;
       }
       /**
@@ -12415,12 +12563,16 @@ Stack: ${stack}
           parts.push("\n## THINK FIRST (reasoning from analysis)\n");
           if (thinkBlock.conclusions && thinkBlock.conclusions.length > 0) {
             parts.push("Conclusions:\n");
-            thinkBlock.conclusions.forEach((c) => parts.push(`  \u2192 ${c}
-`));
+            for (const c of thinkBlock.conclusions) {
+              parts.push(`  \u2192 ${c}
+`);
+            }
           }
           parts.push("Plan:\n");
-          thinkBlock.plan.forEach((p, i) => parts.push(`  ${i + 1}. ${p}
-`));
+          for (let i = 0; i < thinkBlock.plan.length; i++) {
+            parts.push(`  ${i + 1}. ${thinkBlock.plan[i]}
+`);
+          }
           parts.push(`Confidence: ${Math.round((thinkBlock.confidence || 0.5) * 100)}%
 `);
         }
@@ -13378,10 +13530,100 @@ var init_update_checker = __esm({
   }
 });
 
+// core/utils/preserve-sections.ts
+function createPreserveStartRegex() {
+  return /<!-- prjct:preserve(?::([\w-]+))? -->/g;
+}
+function extractPreservedSections(content) {
+  const sections = [];
+  const regex = createPreserveStartRegex();
+  let match;
+  let sectionIndex = 0;
+  while ((match = regex.exec(content)) !== null) {
+    const startIndex = match.index;
+    const startTag = match[0];
+    const sectionId = match[1] || `section-${sectionIndex++}`;
+    const endTagStart = content.indexOf(PRESERVE_END_PATTERN, startIndex + startTag.length);
+    if (endTagStart === -1) {
+      continue;
+    }
+    const endIndex = endTagStart + PRESERVE_END_PATTERN.length;
+    const fullContent = content.substring(startIndex, endIndex);
+    sections.push({
+      id: sectionId,
+      content: fullContent,
+      startIndex,
+      endIndex
+    });
+  }
+  return sections;
+}
+function mergePreservedSections(newContent, oldContent) {
+  const preservedSections = extractPreservedSections(oldContent);
+  if (preservedSections.length === 0) {
+    return newContent;
+  }
+  let merged = newContent.trimEnd();
+  merged += "\n\n---\n\n";
+  merged += "## Your Customizations\n\n";
+  merged += "_The sections below are preserved during sync. Edit freely._\n\n";
+  for (const section of preservedSections) {
+    merged += section.content;
+    merged += "\n\n";
+  }
+  return `${merged.trimEnd()}
+`;
+}
+function validatePreserveBlocks(content) {
+  const errors = [];
+  const startMatches = content.match(/<!-- prjct:preserve(?::\w+)? -->/g) || [];
+  const endMatches = content.match(/<!-- \/prjct:preserve -->/g) || [];
+  if (startMatches.length !== endMatches.length) {
+    errors.push(
+      `Mismatched preserve markers: ${startMatches.length} opening, ${endMatches.length} closing`
+    );
+  }
+  let depth = 0;
+  let maxDepth = 0;
+  const lines = content.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (/<!-- prjct:preserve(?::\w+)? -->/.test(line)) {
+      depth++;
+      maxDepth = Math.max(maxDepth, depth);
+    }
+    if (line.includes(PRESERVE_END_PATTERN)) {
+      depth--;
+    }
+    if (depth > 1) {
+      errors.push(`Nested preserve blocks detected at line ${i + 1} (not supported)`);
+    }
+    if (depth < 0) {
+      errors.push(`Unexpected closing marker at line ${i + 1}`);
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+var PRESERVE_END_PATTERN;
+var init_preserve_sections = __esm({
+  "core/utils/preserve-sections.ts"() {
+    "use strict";
+    PRESERVE_END_PATTERN = "<!-- /prjct:preserve -->";
+    __name(createPreserveStartRegex, "createPreserveStartRegex");
+    __name(extractPreservedSections, "extractPreservedSections");
+    __name(mergePreservedSections, "mergePreservedSections");
+    __name(validatePreserveBlocks, "validatePreserveBlocks");
+  }
+});
+
 // core/services/agent-generator.ts
 var init_agent_generator = __esm({
   "core/services/agent-generator.ts"() {
     "use strict";
+    init_preserve_sections();
   }
 });
 
@@ -16636,7 +16878,7 @@ Generated: ${(/* @__PURE__ */ new Date()).toLocaleString()}
           }
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           output_default.spin(`planning ${description}...`);
@@ -16693,7 +16935,7 @@ Generated: ${(/* @__PURE__ */ new Date()).toLocaleString()}
           }
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           output_default.spin("tracking bug...");
@@ -16816,7 +17058,7 @@ ${"=".repeat(60)}`);
           }
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           const wordCount = description.split(/\s+/).length;
@@ -16874,7 +17116,7 @@ Generated: ${(/* @__PURE__ */ new Date()).toLocaleString()}
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           if (!featureName) {
@@ -17312,60 +17554,6 @@ var init_formatters = __esm({
   }
 });
 
-// core/utils/preserve-sections.ts
-function createPreserveStartRegex() {
-  return /<!-- prjct:preserve(?::([\w-]+))? -->/g;
-}
-function extractPreservedSections(content) {
-  const sections = [];
-  const regex = createPreserveStartRegex();
-  let match;
-  let sectionIndex = 0;
-  while ((match = regex.exec(content)) !== null) {
-    const startIndex = match.index;
-    const startTag = match[0];
-    const sectionId = match[1] || `section-${sectionIndex++}`;
-    const endTagStart = content.indexOf(PRESERVE_END_PATTERN, startIndex + startTag.length);
-    if (endTagStart === -1) {
-      continue;
-    }
-    const endIndex = endTagStart + PRESERVE_END_PATTERN.length;
-    const fullContent = content.substring(startIndex, endIndex);
-    sections.push({
-      id: sectionId,
-      content: fullContent,
-      startIndex,
-      endIndex
-    });
-  }
-  return sections;
-}
-function mergePreservedSections(newContent, oldContent) {
-  const preservedSections = extractPreservedSections(oldContent);
-  if (preservedSections.length === 0) {
-    return newContent;
-  }
-  let merged = newContent.trimEnd();
-  merged += "\n\n---\n\n";
-  merged += "## Your Customizations\n\n";
-  merged += "_The sections below are preserved during sync. Edit freely._\n\n";
-  for (const section of preservedSections) {
-    merged += section.content;
-    merged += "\n\n";
-  }
-  return merged.trimEnd() + "\n";
-}
-var PRESERVE_END_PATTERN;
-var init_preserve_sections = __esm({
-  "core/utils/preserve-sections.ts"() {
-    "use strict";
-    PRESERVE_END_PATTERN = "<!-- /prjct:preserve -->";
-    __name(createPreserveStartRegex, "createPreserveStartRegex");
-    __name(extractPreservedSections, "extractPreservedSections");
-    __name(mergePreservedSections, "mergePreservedSections");
-  }
-});
-
 // core/ai-tools/registry.ts
 import { execSync as execSync4 } from "node:child_process";
 import fs34 from "node:fs";
@@ -17515,6 +17703,13 @@ async function generateForTool(context2, config, globalPath, repoPath) {
     await fs35.mkdir(path38.dirname(outputPath), { recursive: true });
     try {
       const existingContent = await fs35.readFile(outputPath, "utf-8");
+      const validation = validatePreserveBlocks(existingContent);
+      if (!validation.valid) {
+        console.warn(`\u26A0\uFE0F  ${config.outputFile} has invalid preserve blocks:`);
+        for (const error of validation.errors) {
+          console.warn(`   ${error}`);
+        }
+      }
       content = mergePreservedSections(content, existingContent);
     } catch {
     }
@@ -17573,6 +17768,27 @@ var init_context_generator = __esm({
       constructor(config) {
         this.config = config;
       }
+      /**
+       * Write file with preserved sections from existing content
+       * This ensures user customizations survive regeneration
+       */
+      async writeWithPreservation(filePath, content) {
+        let finalContent = content;
+        try {
+          const existingContent = await fs36.readFile(filePath, "utf-8");
+          const validation = validatePreserveBlocks(existingContent);
+          if (!validation.valid) {
+            const filename = path39.basename(filePath);
+            console.warn(`\u26A0\uFE0F  ${filename} has invalid preserve blocks:`);
+            for (const error of validation.errors) {
+              console.warn(`   ${error}`);
+            }
+          }
+          finalContent = mergePreservedSections(content, existingContent);
+        } catch {
+        }
+        await fs36.writeFile(filePath, finalContent, "utf-8");
+      }
       /**
        * Generate all context files in parallel
        */
@@ -17672,13 +17888,7 @@ Load from \`~/.prjct-cli/projects/${this.config.projectId}/agents/\`:
 **Domain**: ${domainAgents.join(", ") || "none"}
 `;
         const claudePath = path39.join(contextPath, "CLAUDE.md");
-        let finalContent = content;
-        try {
-          const existingContent = await fs36.readFile(claudePath, "utf-8");
-          finalContent = mergePreservedSections(content, existingContent);
-        } catch {
-        }
-        await fs36.writeFile(claudePath, finalContent, "utf-8");
+        await this.writeWithPreservation(claudePath, content);
       }
       /**
        * Generate now.md - current task status
@@ -17703,7 +17913,7 @@ _No active task_
 
 Use \`p. task "description"\` to start working.
 `;
-        await fs36.writeFile(path39.join(contextPath, "now.md"), content, "utf-8");
+        await this.writeWithPreservation(path39.join(contextPath, "now.md"), content);
       }
       /**
        * Generate next.md - task queue
@@ -17719,7 +17929,7 @@ Use \`p. task "description"\` to start working.
 
 ${queue.tasks.length > 0 ? queue.tasks.map((t, i) => `${i + 1}. ${t.description}${t.priority ? ` [${t.priority}]` : ""}`).join("\n") : "_Empty queue_"}
 `;
-        await fs36.writeFile(path39.join(contextPath, "next.md"), content, "utf-8");
+        await this.writeWithPreservation(path39.join(contextPath, "next.md"), content);
       }
       /**
        * Generate ideas.md - captured ideas
@@ -17735,7 +17945,7 @@ ${queue.tasks.length > 0 ? queue.tasks.map((t, i) => `${i + 1}. ${t.description}
 
 ${ideas.ideas.length > 0 ? ideas.ideas.map((i) => `- ${i.text}${i.priority ? ` [${i.priority}]` : ""}`).join("\n") : "_No ideas captured yet_"}
 `;
-        await fs36.writeFile(path39.join(contextPath, "ideas.md"), content, "utf-8");
+        await this.writeWithPreservation(path39.join(contextPath, "ideas.md"), content);
       }
       /**
        * Generate shipped.md - completed features
@@ -17755,7 +17965,7 @@ ${shipped.shipped.length > 0 ? shipped.shipped.slice(-10).map((s) => `- **${s.na
 
 **Total shipped:** ${shipped.shipped.length}
 `;
-        await fs36.writeFile(path39.join(contextPath, "shipped.md"), content, "utf-8");
+        await this.writeWithPreservation(path39.join(contextPath, "shipped.md"), content);
       }
     };
   }
@@ -20997,7 +21207,7 @@ var init_analytics = __esm({
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           const projectName = path45.basename(projectPath);
@@ -21173,7 +21383,9 @@ ${"\u2550".repeat(50)}`);
             }
             if (command.features) {
               console.log("\nFeatures:");
-              command.features.forEach((f) => console.log(`  \u2022 ${f}`));
+              for (const f of command.features) {
+                console.log(`  \u2022 ${f}`);
+              }
             }
             console.log(`
 ${"\u2550".repeat(50)}
@@ -21435,7 +21647,7 @@ async function cleanup(options = {}, projectPath = process.cwd()) {
     output_default.spin("cleaning up...");
     const projectId = await config_manager_default.getProjectId(projectPath);
     if (!projectId) {
-      output_default.fail("no project ID");
+      output_default.failWithHint("NO_PROJECT_ID");
       return { success: false, error: "No project ID found" };
     }
     const cleaned = [];
@@ -21594,7 +21806,7 @@ async function recover(projectPath = process.cwd()) {
   try {
     const projectId = await config_manager_default.getProjectId(projectPath);
     if (!projectId) {
-      output_default.fail("no project ID");
+      output_default.failWithHint("NO_PROJECT_ID");
       return { success: false, error: "No project ID found" };
     }
     output_default.spin("checking for abandoned sessions...");
@@ -21638,7 +21850,7 @@ async function undo(projectPath = process.cwd()) {
     output_default.spin("creating undo point...");
     const projectId = await config_manager_default.getProjectId(projectPath);
     if (!projectId) {
-      output_default.fail("no project ID");
+      output_default.failWithHint("NO_PROJECT_ID");
       return { success: false, error: "No project ID found" };
     }
     const snapshotsPath = path49.join(path_manager_default.getGlobalProjectPath(projectId), "snapshots");
@@ -21683,7 +21895,7 @@ async function undo(projectPath = process.cwd()) {
       output_default.done("changes stashed (use /p:redo to restore)");
       return { success: true, snapshotId: stashMessage };
     } catch (gitError) {
-      output_default.fail("git operation failed");
+      output_default.failWithHint("GIT_OPERATION_FAILED");
       return { success: false, error: gitError.message };
     }
   } catch (error) {
@@ -21696,7 +21908,7 @@ async function redo(projectPath = process.cwd()) {
     output_default.spin("restoring changes...");
     const projectId = await config_manager_default.getProjectId(projectPath);
     if (!projectId) {
-      output_default.fail("no project ID");
+      output_default.failWithHint("NO_PROJECT_ID");
       return { success: false, error: "No project ID found" };
     }
     const snapshotsPath = path49.join(path_manager_default.getGlobalProjectPath(projectId), "snapshots");
@@ -21744,7 +21956,7 @@ async function redo(projectPath = process.cwd()) {
       output_default.done("changes restored");
       return { success: true };
     } catch (gitError) {
-      output_default.fail("git operation failed");
+      output_default.failWithHint("GIT_OPERATION_FAILED");
       return { success: false, error: gitError.message };
     }
   } catch (error) {
@@ -21756,7 +21968,7 @@ async function history(projectPath = process.cwd()) {
   try {
     const projectId = await config_manager_default.getProjectId(projectPath);
     if (!projectId) {
-      output_default.fail("no project ID");
+      output_default.failWithHint("NO_PROJECT_ID");
       return { success: false, error: "No project ID found" };
     }
     const snapshotsPath = path49.join(path_manager_default.getGlobalProjectPath(projectId), "snapshots");
@@ -22411,7 +22623,7 @@ ${result.stderr}`.trim();
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           let featureName = feature;
@@ -23485,7 +23697,7 @@ var init_workflow = __esm({
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           if (task) {
@@ -23577,7 +23789,7 @@ var init_workflow = __esm({
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           const currentTask = await stateStorage.getCurrentTask(projectId);
@@ -23643,7 +23855,7 @@ var init_workflow = __esm({
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           const tasks = await queueStorage.getActiveTasks(projectId);
@@ -23668,7 +23880,7 @@ var init_workflow = __esm({
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           const currentTask = await stateStorage.getCurrentTask(projectId);
@@ -23701,7 +23913,7 @@ var init_workflow = __esm({
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           const currentTask = await stateStorage.getCurrentTask(projectId);
@@ -23739,7 +23951,7 @@ var init_workflow = __esm({
           if (!initResult.success) return initResult;
           const projectId = await config_manager_default.getProjectId(projectPath);
           if (!projectId) {
-            output_default.fail("no project ID");
+            output_default.failWithHint("NO_PROJECT_ID");
             return { success: false, error: "No project ID found" };
           }
           if (!input) {
@@ -23903,7 +24115,7 @@ var init_commands = __esm({
         return this.setupCmds.installStatusLine();
       }
       showAsciiArt() {
-        return this.setupCmds.showAsciiArt();
+        this.setupCmds.showAsciiArt();
       }
       // ========== Delegated Base Methods ==========
       async initializeAgent() {
@@ -24008,7 +24220,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.47.0",
+      version: "0.49.0",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {