@planu/cli 1.0.7 → 1.0.9

package/dist/tools/clarify-requirements/multiple-choice.js

@@ -0,0 +1,292 @@
+// tools/clarify-requirements/multiple-choice.ts — SPEC-337
+// Structured multiple-choice options for clarify_requirements interview mode.
+// Provides: per-question options[], stack detection, suggestedDescription builder.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const OPTIONS_CATALOG = {
+    stack_frontend: [
+        'Next.js',
+        'Remix',
+        'Nuxt',
+        'SvelteKit',
+        'Astro',
+        'Vite + React',
+        'Angular',
+        'Other: ___',
+    ],
+    stack_backend: [
+        'Express',
+        'Fastify',
+        'NestJS',
+        'Hono',
+        'FastAPI',
+        'Django',
+        'Spring Boot',
+        'Other: ___',
+    ],
+    stack_database: [
+        'PostgreSQL',
+        'MySQL',
+        'SQLite',
+        'MongoDB',
+        'Redis',
+        'Supabase',
+        'PlanetScale',
+        'Other: ___',
+    ],
+    stack_language: ['TypeScript', 'JavaScript', 'Python', 'Go', 'Java', 'Rust', 'Other: ___'],
+    auth_method: [
+        'Email + password',
+        'Google OAuth',
+        'GitHub OAuth',
+        'Magic link',
+        'JWT (custom)',
+        'Session-based',
+        'API key',
+        'Other: ___',
+    ],
+    scope_type: ['New feature', 'Improvement to existing', 'Bug fix', 'Refactor', 'Other: ___'],
+    user_type: ['End user', 'Admin', 'Developer / internal', 'All users', 'Other: ___'],
+    mvp_scope: [
+        'Core happy path only',
+        'Happy path + error handling',
+        'Full feature with edge cases',
+        'MVP first, iterate later',
+        'Other: ___',
+    ],
+    performance_target: [
+        '< 100ms (real-time)',
+        '< 500ms (interactive)',
+        '< 2s (acceptable)',
+        'No strict SLA',
+        'Other: ___',
+    ],
+    ui_mockup: [
+        'Yes, Figma mockup available',
+        'Rough sketch only',
+        'No mockup — describe in text',
+        'Other: ___',
+    ],
+    login_method: [
+        'Email/password',
+        'Google',
+        'Apple',
+        'Magic link',
+        'GitHub',
+        'SSO / SAML',
+        'Other: ___',
+    ],
+};
+/**
+ * Detect the project stack by reading package.json and/or requirements.txt
+ * from the given project path.
+ */
+export async function detectStack(projectPath) {
+    const result = {
+        framework: null,
+        language: null,
+        database: null,
+        detectedLibs: [],
+    };
+    try {
+        const pkgRaw = await readFile(join(projectPath, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(pkgRaw);
+        const allDeps = {
+            ...(pkg.dependencies ?? {}),
+            ...(pkg.devDependencies ?? {}),
+        };
+        const libs = Object.keys(allDeps);
+        result.detectedLibs = libs;
+        // Framework detection
+        if (libs.includes('next')) {
+            result.framework = 'Next.js';
+        }
+        else if (libs.includes('@remix-run/react') || libs.includes('@remix-run/node')) {
+            result.framework = 'Remix';
+        }
+        else if (libs.includes('nuxt')) {
+            result.framework = 'Nuxt';
+        }
+        else if (libs.includes('@sveltejs/kit')) {
+            result.framework = 'SvelteKit';
+        }
+        else if (libs.includes('astro')) {
+            result.framework = 'Astro';
+        }
+        else if (libs.includes('fastify')) {
+            result.framework = 'Fastify';
+        }
+        else if (libs.includes('@nestjs/core')) {
+            result.framework = 'NestJS';
+        }
+        else if (libs.includes('express')) {
+            result.framework = 'Express';
+        }
+        else if (libs.includes('hono')) {
+            result.framework = 'Hono';
+        }
+        // Language (TypeScript presence)
+        if (libs.includes('typescript') || libs.includes('ts-node') || libs.includes('tsx')) {
+            result.language = 'TypeScript';
+        }
+        else {
+            result.language = 'JavaScript';
+        }
+        // Database detection
+        if (libs.includes('pg') || libs.includes('postgres')) {
+            result.database = 'PostgreSQL';
+        }
+        else if (libs.includes('mysql2') || libs.includes('mysql')) {
+            result.database = 'MySQL';
+        }
+        else if (libs.includes('better-sqlite3') || libs.includes('sqlite3')) {
+            result.database = 'SQLite';
+        }
+        else if (libs.includes('mongoose') || libs.includes('mongodb')) {
+            result.database = 'MongoDB';
+        }
+        else if (libs.includes('@supabase/supabase-js')) {
+            result.database = 'Supabase';
+        }
+        else if (libs.includes('ioredis') || libs.includes('redis')) {
+            result.database = 'Redis';
+        }
+    }
+    catch {
+        // No package.json — try requirements.txt for Python
+        try {
+            const reqRaw = await readFile(join(projectPath, 'requirements.txt'), 'utf-8');
+            const lines = reqRaw
+                .split('\n')
+                .map((l) => (l.split('=')[0] ?? l).split('>')[0]?.split('<')[0]?.trim().toLowerCase() ?? '');
+            result.detectedLibs = lines.filter(Boolean);
+            if (lines.includes('django') || lines.includes('django-rest-framework')) {
+                result.framework = 'Django';
+                result.language = 'Python';
+            }
+            else if (lines.includes('fastapi')) {
+                result.framework = 'FastAPI';
+                result.language = 'Python';
+            }
+            else if (lines.includes('flask')) {
+                result.framework = 'Flask';
+                result.language = 'Python';
+            }
+            else {
+                result.language = 'Python';
+            }
+            if (lines.includes('psycopg2') || lines.includes('psycopg2-binary')) {
+                result.database = 'PostgreSQL';
+            }
+            else if (lines.includes('pymysql') || lines.includes('mysql-connector-python')) {
+                result.database = 'MySQL';
+            }
+            else if (lines.includes('motor') || lines.includes('pymongo')) {
+                result.database = 'MongoDB';
+            }
+        }
+        catch {
+            // No manifest files found — detection yields nulls
+        }
+    }
+    return result;
+}
+/**
+ * Returns true if the question should be skipped because the stack already
+ * provides a definitive answer.
+ */
+export function shouldSkipQuestion(question, stack) {
+    const lower = question.question.toLowerCase();
+    if ((lower.includes('stack') || lower.includes('framework') || lower.includes('language')) &&
+        (stack.framework !== null || stack.language !== null)) {
+        return true;
+    }
+    if (lower.includes('database') && stack.database !== null) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Resolves option list from a catalog key.
+ */
+function resolveOptions(key) {
+    return OPTIONS_CATALOG[key];
+}
+/**
+ * Attaches structured `options[]` to a question based on its content.
+ * Each question gets 3-8 concrete choices + 'Other: ___' fallback.
+ */
+export function attachOptions(question) {
+    const lower = question.question.toLowerCase();
+    let options;
+    if (lower.includes('login') || lower.includes('sign in') || lower.includes('sign up')) {
+        options = resolveOptions('login_method');
+    }
+    else if (lower.includes('auth')) {
+        options = resolveOptions('auth_method');
+    }
+    else if (lower.includes('frontend') || lower.includes('ui framework')) {
+        options = resolveOptions('stack_frontend');
+    }
+    else if (lower.includes('backend') || lower.includes('server framework')) {
+        options = resolveOptions('stack_backend');
+    }
+    else if (lower.includes('database') || lower.includes('db')) {
+        options = resolveOptions('stack_database');
+    }
+    else if (lower.includes('stack') || lower.includes('framework') || lower.includes('language')) {
+        options = resolveOptions('stack_language');
+    }
+    else if (lower.includes('new feature') ||
+        lower.includes('improvement') ||
+        lower.includes('feature or')) {
+        options = resolveOptions('scope_type');
+    }
+    else if (lower.includes('user') &&
+        (lower.includes('who') || lower.includes('primary') || lower.includes('persona'))) {
+        options = resolveOptions('user_type');
+    }
+    else if (lower.includes('must-have') ||
+        lower.includes('minimum viable') ||
+        lower.includes('mvp') ||
+        lower.includes('first version')) {
+        options = resolveOptions('mvp_scope');
+    }
+    else if (lower.includes('performance') ||
+        lower.includes('response time') ||
+        lower.includes('latency')) {
+        options = resolveOptions('performance_target');
+    }
+    else if (lower.includes('mockup') ||
+        lower.includes('design') ||
+        lower.includes('reference design')) {
+        options = resolveOptions('ui_mockup');
+    }
+    else if (lower.includes('scope') && lower.includes('done')) {
+        options = resolveOptions('mvp_scope');
+    }
+    if (options === undefined) {
+        return question;
+    }
+    return { ...question, options };
+}
+/**
+ * Builds a `suggestedDescription` string from accumulated answers.
+ * The returned string is suitable for passing directly to create_spec.
+ */
+export function buildSuggestedDescription(topic, answers, questions) {
+    const parts = [`Feature: ${topic}.`];
+    for (const q of questions) {
+        const answer = answers[q.id];
+        if (answer === undefined || answer.trim() === '') {
+            continue;
+        }
+        const trimmedAnswer = answer.trim();
+        const shortQuestion = q.question
+            .replace(/^(What|Who|Is|Are|Does|Do|How|Which)\s+/i, '')
+            .replace(/\?$/, '');
+        parts.push(`${shortQuestion}: ${trimmedAnswer}.`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=multiple-choice.js.map

package/dist/tools/clarify-requirements/multiple-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiple-choice.js","sourceRoot":"","sources":["../../../src/tools/clarify-requirements/multiple-choice.ts"],"names":[],"mappings":"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"}

package/dist/tools/clarify-requirements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clarify-requirements.d.ts","sourceRoot":"","sources":["../../src/tools/clarify-requirements.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EAGxB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAyF3B,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,UAAU,CAAC,CA2FrB"}
+{"version":3,"file":"clarify-requirements.d.ts","sourceRoot":"","sources":["../../src/tools/clarify-requirements.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EAGxB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAwG3B,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,UAAU,CAAC,CA4HrB"}

package/dist/tools/clarify-requirements.js

@@ -3,6 +3,7 @@ import { knowledgeStore } from '../storage/index.js';
 import { randomUUID } from 'node:crypto';
 import { isShortTopic, generateMetaQuestions, detectContradictions, buildSuggestedAnswers, } from './clarify-requirements/questions.js';
 import { generateQuestions } from './clarify-requirements/questions-context.js';
+import { detectStack, shouldSkipQuestion, attachOptions, buildSuggestedDescription, } from './clarify-requirements/multiple-choice.js';
 /** Resume an existing clarification session with new answers. */
 async function handleResumeSession(projectId, sessionId, newAnswers, knowledge) {
     const existing = await knowledgeStore.getClarification(projectId, sessionId).catch(() => null);
@@ -32,6 +33,9 @@ async function handleResumeSession(projectId, sessionId, newAnswers, knowledge)
         ...q,
         suggestedAnswers: q.suggestedAnswers ?? buildSuggestedAnswers(q, knowledge),
     }));
+    const suggestedDescription = specReady
+        ? buildSuggestedDescription(existing.topic, mergedAnswers, enriched)
+        : undefined;
     const updated = {
         ...existing,
         questions: enriched,
@@ -39,11 +43,14 @@ async function handleResumeSession(projectId, sessionId, newAnswers, knowledge)
         isComplete: specReady,
         contradictions: contradictions.length > 0 ? contradictions : undefined,
         specReady,
+        interviewMode: 'multiple-choice',
+        ...(suggestedDescription !== undefined ? { suggestedDescription } : {}),
     };
     await knowledgeStore.addClarification(projectId, updated);
     const result = {
         sessionId: existing.id,
         topic: existing.topic,
+        interviewMode: 'multiple-choice',
         questionsCount: existing.questions.length,
         questions: enriched.map((q) => ({
             id: q.id,
@@ -51,9 +58,12 @@ async function handleResumeSession(projectId, sessionId, newAnswers, knowledge)
             category: q.category,
             importance: q.importance,
             suggestedAnswers: q.suggestedAnswers,
+            options: q.options,
+            skipped: q.skipped,
             answered: mergedAnswers[q.id] !== undefined,
         })),
         specReady,
+        ...(suggestedDescription !== undefined ? { suggestedDescription } : {}),
         answeredCount: Object.keys(mergedAnswers).length,
         ...(contradictions.length > 0
             ? {
@@ -86,31 +96,57 @@ export async function handleClarifyRequirements(params) {
         // Generate main clarification questions (cap total at maxQuestions)
         const mainMaxQ = Math.max(1, maxQuestions - metaQuestions.length);
         const mainQuestions = generateQuestions(topic, context, knowledge, mainMaxQ);
-        const questions = [...metaQuestions, ...mainQuestions].slice(0, maxQuestions);
-        // Determine if spec is ready (all critical questions have non-empty answers)
-        const criticalIds = questions.filter((q) => q.importance === 'critical').map((q) => q.id);
+        const rawQuestions = [...metaQuestions, ...mainQuestions].slice(0, maxQuestions);
+        // Detect project stack for auto-skip and option filtering (SPEC-337)
+        const projectPath = knowledge?.projectPath ?? '';
+        const stack = projectPath !== ''
+            ? await detectStack(projectPath).catch(() => ({
+                framework: null,
+                language: null,
+                database: null,
+                detectedLibs: [],
+            }))
+            : { framework: null, language: null, database: null, detectedLibs: [] };
+        // Apply multiple-choice options + mark skipped questions (SPEC-337)
+        const questions = rawQuestions.map((q) => {
+            const withOptions = attachOptions(q);
+            const skipped = shouldSkipQuestion(q, stack);
+            return skipped ? { ...withOptions, skipped: true } : withOptions;
+        });
+        // Determine if spec is ready (all non-skipped critical questions have non-empty answers)
+        const criticalIds = questions
+            .filter((q) => q.importance === 'critical' && q.skipped !== true)
+            .map((q) => q.id);
         const specReady = answers !== undefined &&
             criticalIds.every((id) => {
                 const ans = answers[id];
                 return ans !== undefined && ans.trim() !== '';
             });
+        // Build suggestedDescription when spec is ready (SPEC-337)
+        const currentAnswers = answers ?? {};
+        const suggestedDescription = specReady
+            ? buildSuggestedDescription(topic, currentAnswers, questions)
+            : undefined;
         // Create a clarification session
         const session = {
             id: randomUUID().slice(0, 8),
             projectId,
             topic,
             questions,
-            answers: answers ?? {},
+            answers: currentAnswers,
             isComplete: specReady,
             createdAt: new Date().toISOString(),
             contradictions: contradictions.length > 0 ? contradictions : undefined,
             specReady,
+            interviewMode: 'multiple-choice',
+            ...(suggestedDescription !== undefined ? { suggestedDescription } : {}),
         };
         // Persist the session
         await knowledgeStore.addClarification(projectId, session);
         const result = {
             sessionId: session.id,
             topic,
+            interviewMode: 'multiple-choice',
             questionsCount: questions.length,
             hasMetaQuestions: metaQuestions.length > 0,
             questions: questions.map((q) => ({
@@ -121,8 +157,11 @@ export async function handleClarifyRequirements(params) {
                 suggestedAnswer: q.suggestedAnswer,
                 /* v8 ignore next 1 */
                 suggestedAnswers: q.suggestedAnswers ?? [],
+                options: q.options,
+                skipped: q.skipped,
             })),
             specReady,
+            ...(suggestedDescription !== undefined ? { suggestedDescription } : {}),
             instructions: specReady
                 ? 'All critical questions answered. Call create_spec with clarificationSessionId to create a precise spec.'
                 : 'Answer the questions above, then call create_spec with the gathered context. You can skip nice-to-have questions if the user does not have strong opinions.',

package/dist/tools/clarify-requirements.js.map

@@ -1 +1 @@
-{"version":3,"file":"clarify-requirements.js","sourceRoot":"","sources":["../../src/tools/clarify-requirements.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"clarify-requirements.js","sourceRoot":"","sources":["../../src/tools/clarify-requirements.ts"],"names":[],"mappings":"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"}

package/dist/tools/export-pdf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-pdf.d.ts","sourceRoot":"","sources":["../../src/tools/export-pdf.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmFzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiB7D"}
+{"version":3,"file":"export-pdf.d.ts","sourceRoot":"","sources":["../../src/tools/export-pdf.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0EzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiB7D"}

package/dist/tools/export-pdf.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { safeLicensed } from './safe-handler.js';
-import { htmlToPdf, findBrowserSync } from '../engine/pdf/index.js';
+import { htmlToPdf } from '../engine/pdf/index.js';
 // ── Zod schema ────────────────────────────────────────────────────────────────
 const ExportPdfInputSchema = {
     htmlPath: z
@@ -32,19 +32,13 @@ const ExportPdfInputSchema = {
 };
 // ── Handler ───────────────────────────────────────────────────────────────────
 async function handleExportPdf(args) {
-    // Validate browser availability upfront for a clearer error message
-    const browserInfo = findBrowserSync();
-    if (!browserInfo) {
-        throw new Error('No compatible browser found. Install Google Chrome or Chromium (or set PLANU_CHROME_PATH), then retry. ' +
-            'PDF generation requires a system browser to render HTML accurately.');
-    }
     const options = {
         outputPath: args.outputPath ?? '',
         format: args.format ?? 'A4',
         landscape: args.landscape ?? false,
         printBackground: args.printBackground ?? true,
         scale: args.scale ?? 1,
-        timeout: args.timeout ?? 30000,
+        timeout: args.timeout ?? 60000,
         watermark: args.watermark,
         includeToc: args.includeToc ?? false,
         pageNumbers: args.pageNumbers ?? true,

package/dist/tools/export-pdf.js.map

@@ -1 +1 @@
-{"version":3,"file":"export-pdf.js","sourceRoot":"","sources":["../../src/tools/export-pdf.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"export-pdf.js","sourceRoot":"","sources":["../../src/tools/export-pdf.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,iFAAiF;AAEjF,MAAM,oBAAoB,GAAG;IAC3B,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,oEAAoE,CAAC;IACjF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;SAC/B,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtF,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,uEAAuE,CAAC;IACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC1F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC/F,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;IACnF,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC/F,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CACzF,CAAC;AAEF,iFAAiF;AAEjF,KAAK,UAAU,eAAe,CAC5B,IAAmB;IAEnB,MAAM,OAAO,GAAwB;QACnC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK;QAClC,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;QAC7C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;QACtB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;QAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK;QACpC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;KACtC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEvD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE;oBACJ,4BAA4B;oBAC5B,SAAS,MAAM,CAAC,OAAO,EAAE;oBACzB,SAAS,MAAM,CAAC,iBAAiB,EAAE;oBACnC,YAAY,MAAM,CAAC,OAAO,EAAE;oBAC5B,WAAW,IAAI,CAAC,MAAM,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE;iBACnF,CAAC,IAAI,CAAC,IAAI,CAAC;aACb;SACF;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,WAAW,EACT,iFAAiF;YACjF,mFAAmF;QACrF,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE;YACX,KAAK,EAAE,eAAe;YACtB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,YAAY,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAqB,CAAC,CAAC,CACnF,CAAC;AACJ,CAAC"}

package/dist/tools/resolve-project-id.d.ts

@@ -1,13 +1,57 @@
-import type { ToolResult } from '../types/index.js';
+import type { ToolResult, RegisteredProjectSummary } from '../types/index.js';
 /**
  * Resolve projectId from either projectId or projectPath.
  * projectPath takes precedence when both are provided.
  * Returns null when neither is provided.
+ *
+ * This is the SYNC fast path for callers that always have an explicit param.
+ * For zero-config auto-detection use resolveProjectIdOrAutoDetect().
  */
 export declare function resolveProjectId(params: {
     projectId?: string;
     projectPath?: string;
 }): string | null;
-/** Error result returned when neither projectId nor projectPath is provided. */
+/**
+ * Result returned by resolveProjectIdOrAutoDetect.
+ * On success: { ok: true, projectId, projectPath, autoDetected }
+ * On failure: { ok: false, errorResult } — return errorResult directly to the caller.
+ */
+export type ResolveResult = {
+    ok: true;
+    projectId: string;
+    projectPath: string;
+    autoDetected: boolean;
+} | {
+    ok: false;
+    errorResult: ToolResult;
+};
+/**
+ * Resolve a projectId with full zero-config auto-detection (SPEC-341).
+ *
+ * Falls back to PLANU_PROJECT_PATH env var and the global project registry
+ * when neither projectId nor projectPath is passed explicitly.
+ *
+ * Returns a discriminated union so callers can early-return on failure:
+ *
+ * ```ts
+ * const resolved = await resolveProjectIdOrAutoDetect(params);
+ * if (!resolved.ok) return resolved.errorResult;
+ * const { projectId, projectPath, autoDetected } = resolved;
+ * ```
+ */
+export declare function resolveProjectIdOrAutoDetect(params: {
+    projectId?: string;
+    projectPath?: string;
+}): Promise<ResolveResult>;
+/**
+ * Build a ToolResult error for the "missing project" case.
+ * Includes a registeredProjects[] list so the user can see their options.
+ */
+export declare function buildMissingProjectError(registeredProjects: RegisteredProjectSummary[]): ToolResult;
+/**
+ * Build a ToolResult error for the "ambiguous project" case (multiple registered).
+ * Lists all known projects with their id + path so the user can pick one.
+ */
+export declare function buildAmbiguousProjectError(registeredProjects: RegisteredProjectSummary[]): ToolResult;
 export declare const missingProjectIdError: ToolResult;
 //# sourceMappingURL=resolve-project-id.d.ts.map

package/dist/tools/resolve-project-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-project-id.d.ts","sourceRoot":"","sources":["../../src/tools/resolve-project-id.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,GAAG,IAAI,CAQhB;AAED,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,EAAE,UAQnC,CAAC"}
+{"version":3,"file":"resolve-project-id.d.ts","sourceRoot":"","sources":["../../src/tools/resolve-project-id.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,GAAG,IAAI,CAQhB;AAMD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBzB;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,kBAAkB,EAAE,wBAAwB,EAAE,GAC7C,UAAU,CASZ;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,kBAAkB,EAAE,wBAAwB,EAAE,GAC7C,UAAU,CAUZ;AAKD,eAAO,MAAM,qBAAqB,EAAE,UAQnC,CAAC"}