@planu/cli 0.90.2 → 0.92.0

package/dist/tools/approval-handler.js

@@ -0,0 +1,193 @@
+// tools/approval-handler.ts — Handlers for approval workflow tools (SPEC-283)
+import { hashProjectPath, projectDataDir } from '../storage/base-store.js';
+import * as approvalStore from '../storage/approval-store.js';
+import * as specStore from '../storage/spec-store.js';
+import { buildApprovalStatus } from '../engine/approval-workflow.js';
+import { appendEvent } from '../engine/audit-trail/index.js';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function auditLogPath(projectId) {
+    return join(projectDataDir(projectId), 'audit-log.jsonl');
+}
+// ---------------------------------------------------------------------------
+// configure_approval_policy
+// ---------------------------------------------------------------------------
+export async function handleConfigureApprovalPolicy(args) {
+    const projectId = hashProjectPath(args.projectPath);
+    const policy = await approvalStore.savePolicy(projectId, {
+        requiredApprovals: args.requiredApprovals,
+        reviewSLAHours: args.reviewSLAHours,
+        ...(args.escalateTo !== undefined ? { escalateTo: args.escalateTo } : {}),
+        ...(args.requireRoles !== undefined ? { requireRoles: args.requireRoles } : {}),
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Approval policy configured: ${String(policy.requiredApprovals)} approval(s) required, ` +
+                    `SLA ${String(policy.reviewSLAHours)}h.` +
+                    (policy.escalateTo !== undefined ? ` Escalate to: ${policy.escalateTo}.` : '') +
+                    (policy.requireRoles !== undefined && policy.requireRoles.length > 0
+                        ? ` Required roles: ${policy.requireRoles.join(', ')}.`
+                        : ''),
+            },
+        ],
+        structuredContent: { policy },
+    };
+}
+// ---------------------------------------------------------------------------
+// approve_spec
+// ---------------------------------------------------------------------------
+export async function handleApproveSpec(args) {
+    const projectId = hashProjectPath(args.projectPath);
+    const spec = await specStore.getSpec(projectId, args.specId);
+    if (spec === null) {
+        return {
+            content: [{ type: 'text', text: `Spec ${args.specId} not found.` }],
+            isError: true,
+        };
+    }
+    const record = {
+        specId: args.specId,
+        reviewer: args.reviewer,
+        action: 'approved',
+        timestamp: new Date().toISOString(),
+        ...(args.role !== undefined ? { role: args.role } : {}),
+        ...(args.comment !== undefined ? { comment: args.comment } : {}),
+    };
+    const records = await approvalStore.appendRecord(projectId, args.specId, record);
+    const policy = await approvalStore.getPolicy(projectId);
+    const status = buildApprovalStatus(args.specId, records, policy, undefined);
+    // Audit trail — fire-and-forget
+    appendEvent(auditLogPath(projectId), {
+        eventType: 'spec.approved',
+        specId: args.specId,
+        userId: args.reviewer,
+        action: 'approve_spec',
+        details: {
+            reviewer: args.reviewer,
+            role: args.role ?? null,
+            comment: args.comment ?? null,
+            approvalCount: status.approvalCount,
+            gateOpen: status.gateOpen,
+        },
+    }).catch(() => {
+        // audit failure must never block the tool
+    });
+    const gateMsg = status.gateOpen
+        ? ` Approval gate is now OPEN (${String(status.approvalCount)}/${String(policy?.requiredApprovals ?? status.approvalCount)}).`
+        : ` Gate still needs ${String(status.approvalsNeeded)} more approval(s).`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${args.reviewer} approved ${args.specId}.${gateMsg}`,
+            },
+        ],
+        structuredContent: { record, status },
+    };
+}
+// ---------------------------------------------------------------------------
+// request_changes
+// ---------------------------------------------------------------------------
+export async function handleRequestChanges(args) {
+    const projectId = hashProjectPath(args.projectPath);
+    const spec = await specStore.getSpec(projectId, args.specId);
+    if (spec === null) {
+        return {
+            content: [{ type: 'text', text: `Spec ${args.specId} not found.` }],
+            isError: true,
+        };
+    }
+    const record = {
+        specId: args.specId,
+        reviewer: args.reviewer,
+        action: 'changes_requested',
+        timestamp: new Date().toISOString(),
+        comment: args.comment,
+        ...(args.role !== undefined ? { role: args.role } : {}),
+    };
+    // Append the changes_requested record and clear prior approvals for this spec
+    await approvalStore.appendRecord(projectId, args.specId, record);
+    await approvalStore.clearRecords(projectId, args.specId);
+    // Re-append only the changes_requested record so the history is preserved
+    const records = await approvalStore.appendRecord(projectId, args.specId, record);
+    // Move spec back to draft
+    await specStore.updateSpec(projectId, args.specId, { status: 'draft' });
+    // Audit trail — fire-and-forget
+    appendEvent(auditLogPath(projectId), {
+        eventType: 'spec.status_changed',
+        specId: args.specId,
+        userId: args.reviewer,
+        action: 'request_changes',
+        details: {
+            reviewer: args.reviewer,
+            role: args.role ?? null,
+            comment: args.comment,
+            changesRequested: true,
+        },
+    }).catch(() => {
+        // audit failure must never block the tool
+    });
+    void records;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${args.reviewer} requested changes on ${args.specId}. ` +
+                    `Spec moved back to draft. Comment: "${args.comment}"`,
+            },
+        ],
+        structuredContent: { record, specStatus: 'draft' },
+    };
+}
+// ---------------------------------------------------------------------------
+// approval_status
+// ---------------------------------------------------------------------------
+export async function handleApprovalStatus(args) {
+    const projectId = hashProjectPath(args.projectPath);
+    const [spec, records, policy] = await Promise.all([
+        specStore.getSpec(projectId, args.specId),
+        approvalStore.getRecords(projectId, args.specId),
+        approvalStore.getPolicy(projectId),
+    ]);
+    if (spec === null) {
+        return {
+            content: [{ type: 'text', text: `Spec ${args.specId} not found.` }],
+            isError: true,
+        };
+    }
+    // Determine when spec entered review (use updatedAt as proxy if in review)
+    const reviewStartedAt = spec.status === 'review' ? spec.updatedAt : undefined;
+    const status = buildApprovalStatus(args.specId, records, policy, reviewStartedAt);
+    const lines = [
+        `Approval Status — ${args.specId}`,
+        `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+        `Approvals: ${String(status.approvalCount)} / ${String(policy?.requiredApprovals ?? '(no policy)')}`,
+        `Gate: ${status.gateOpen ? 'OPEN' : `BLOCKED — needs ${String(status.approvalsNeeded)} more`}`,
+    ];
+    if (status.approvers.length > 0) {
+        lines.push(`Approved by: ${status.approvers.join(', ')}`);
+    }
+    if (policy !== null) {
+        lines.push(`SLA: ${String(policy.reviewSLAHours)}h`);
+        if (spec.status === 'review') {
+            lines.push(`In review: ${String(status.hoursInReview)}h`);
+            if (status.slaBreached) {
+                lines.push(`⚠ SLA BREACHED by ${String(status.slaBreachHours)}h` +
+                    (policy.escalateTo !== undefined ? ` — escalate to ${policy.escalateTo}` : ''));
+            }
+        }
+    }
+    const changeRequests = records.filter((r) => r.action === 'changes_requested');
+    if (changeRequests.length > 0) {
+        lines.push(`Change requests: ${String(changeRequests.length)}`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        structuredContent: { status },
+    };
+}
+//# sourceMappingURL=approval-handler.js.map

package/dist/tools/approval-handler.js.map

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

package/dist/tools/checkpoint-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-handler.d.ts","sourceRoot":"","sources":["../../src/tools/checkpoint-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAkE5E,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B/F"}
+{"version":3,"file":"checkpoint-handler.d.ts","sourceRoot":"","sources":["../../src/tools/checkpoint-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAwF5E,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8C/F"}

package/dist/tools/checkpoint-handler.js

@@ -46,6 +46,22 @@ async function resolveActiveSpecs(projectPath, projectId) {
     return getActiveSpecIds(projectPath);
 }
 // ---------------------------------------------------------------------------
+// Worktree teardown recommendation (SPEC-279)
+// ---------------------------------------------------------------------------
+function buildWorktreeTeardownRecommendation(activeSpecs) {
+    const specNames = activeSpecs.map((s) => s.replace(/ \(implementing\)$/, '')).join(', ');
+    return {
+        type: 'worktree-teardown',
+        message: `Parallel sprint detected — ${String(activeSpecs.length)} specs in progress (${specNames}). Run these steps to close the sprint safely:`,
+        steps: [
+            'For each worktree: bash scripts/auto-merge.sh  (full pipeline + merge to develop)',
+            'bash scripts/prune-worktrees.sh  (clean up merged/orphan worktrees)',
+            'pnpm test:coverage  (verify thresholds before promoting to main)',
+            'git checkout main && git merge --ff-only develop && git push origin main',
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
 // Handler
 // ---------------------------------------------------------------------------
 export async function handleSessionCheckpoint(args) {
@@ -61,6 +77,18 @@ export async function handleSessionCheckpoint(args) {
         nextSteps,
     });
     const handoff = buildHandoffBlock(savedAt, activeSpecs, decisions, nextSteps, stagedFiles);
+    // SPEC-256: always include /btw tip in checkpoint recommendations
+    const recommendations = [
+        {
+            type: 'context-tip',
+            message: 'Use /btw for side questions during implementation — keeps context clean for the task. Example: /btw what does useEffect cleanup do?',
+            command: '/btw your question here',
+        },
+    ];
+    // SPEC-279: emit worktree teardown instructions when a parallel sprint is detected
+    if (activeSpecs.length >= 2) {
+        recommendations.push(buildWorktreeTeardownRecommendation(activeSpecs));
+    }
     const text = [
         `Session checkpoint saved — ${savedAt}`,
         '',
@@ -71,6 +99,9 @@ export async function handleSessionCheckpoint(args) {
     ].join('\n');
     return {
         content: [{ type: 'text', text }],
+        structuredContent: {
+            recommendations,
+        },
     };
 }
 //# sourceMappingURL=checkpoint-handler.js.map

package/dist/tools/checkpoint-handler.js.map

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

package/dist/tools/clarify-requirements/interview-mode.d.ts

@@ -0,0 +1,42 @@
+export type InterviewDimension = 'technical' | 'ux' | 'edge-cases' | 'tradeoffs' | 'security' | 'performance' | 'integration';
+export interface CoverageMap {
+    technical: boolean;
+    ux: boolean;
+    'edge-cases': boolean;
+    tradeoffs: boolean;
+    security: boolean;
+    performance: boolean;
+    integration: boolean;
+}
+export interface InterviewState {
+    sessionId: string;
+    coverageMap: CoverageMap;
+    completionPercent: number;
+    accumulatedAnswers: Record<string, string>;
+    nextDimension: InterviewDimension | null;
+    ready: boolean;
+}
+/**
+ * Analyzes answers to update which dimensions are covered.
+ * Merges with an existing coverage map if provided.
+ */
+export declare function updateCoverageFromAnswers(answers: Record<string, string>, existing?: CoverageMap): CoverageMap;
+/**
+ * Returns the lowest-priority uncovered dimension, or null if all are covered.
+ */
+export declare function pickNextDimension(coverage: CoverageMap): InterviewDimension | null;
+/**
+ * Generates a targeted follow-up question for a specific dimension.
+ * Takes existing answers into account to avoid repeating covered ground.
+ */
+export declare function generateDimensionQuestion(dimension: InterviewDimension, topic: string, answers: Record<string, string>): string;
+/**
+ * Computes completion percentage based on how many dimensions are covered (0–100).
+ */
+export declare function computeCompletion(coverage: CoverageMap): number;
+/**
+ * Returns true if the topic is too simple for interview mode.
+ * Delegates to isShortTopic from questions.ts.
+ */
+export declare function shouldSkipInterview(topic: string): boolean;
+//# sourceMappingURL=interview-mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interview-mode.d.ts","sourceRoot":"","sources":["../../../src/tools/clarify-requirements/interview-mode.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,IAAI,GACJ,YAAY,GACZ,WAAW,GACX,UAAU,GACV,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,aAAa,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC;CAChB;AAyRD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,CAAC,EAAE,WAAW,GACrB,WAAW,CA2Bb;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,kBAAkB,GAAG,IAAI,CAOlF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAI/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/tools/clarify-requirements/interview-mode.js

@@ -0,0 +1,342 @@
+// tools/clarify-requirements/interview-mode.ts — Structured Interview Mode (SPEC-252)
+// Tracks coverage across 7 dimensions and guides toward create_spec
+import { isShortTopic } from './questions.js';
+/** Keywords per dimension used to detect coverage from answer text. */
+const DIMENSION_KEYWORDS = {
+    technical: [
+        'typescript',
+        'javascript',
+        'python',
+        'java',
+        'rust',
+        'go',
+        'database',
+        'sql',
+        'nosql',
+        'api',
+        'rest',
+        'graphql',
+        'grpc',
+        'microservice',
+        'monolith',
+        'architecture',
+        'framework',
+        'library',
+        'sdk',
+        'algorithm',
+        'data structure',
+        'cache',
+        'queue',
+        'message broker',
+        'docker',
+        'kubernetes',
+        'serverless',
+        'function',
+        'endpoint',
+        'backend',
+        'frontend',
+        'fullstack',
+        'stack',
+        'implementation',
+        'deploy',
+        'build',
+        'compile',
+        'runtime',
+    ],
+    ux: [
+        'user',
+        'ui',
+        'interface',
+        'ux',
+        'experience',
+        'design',
+        'layout',
+        'screen',
+        'page',
+        'form',
+        'input',
+        'button',
+        'menu',
+        'navigation',
+        'mobile',
+        'responsive',
+        'accessible',
+        'accessibility',
+        'a11y',
+        'wcag',
+        'flow',
+        'journey',
+        'onboarding',
+        'dashboard',
+        'view',
+        'visual',
+        'theme',
+        'color',
+        'typography',
+        'component',
+        'widget',
+    ],
+    'edge-cases': [
+        'edge case',
+        'corner case',
+        'error',
+        'failure',
+        'invalid',
+        'empty',
+        'null',
+        'undefined',
+        'exception',
+        'boundary',
+        'limit',
+        'overflow',
+        'timeout',
+        'retry',
+        'fallback',
+        'race condition',
+        'concurrent',
+        'duplicate',
+        'missing',
+        'malformed',
+        'validation',
+        'constraint',
+        'maximum',
+        'minimum',
+        'zero',
+        'negative',
+        'large',
+        'empty list',
+        'not found',
+        '404',
+        'conflict',
+    ],
+    tradeoffs: [
+        'tradeoff',
+        'trade-off',
+        'vs',
+        'versus',
+        'alternative',
+        'option',
+        'approach',
+        'decision',
+        'pros',
+        'cons',
+        'advantage',
+        'disadvantage',
+        'balance',
+        'priority',
+        'complexity',
+        'simplicity',
+        'maintainability',
+        'scalability',
+        'cost',
+        'benefit',
+        'risk',
+        'impact',
+        'consistency',
+        'availability',
+        'partition',
+        'cap theorem',
+        'eventual',
+        'strong consistency',
+    ],
+    security: [
+        'security',
+        'auth',
+        'authentication',
+        'authorization',
+        'permission',
+        'role',
+        'rbac',
+        'jwt',
+        'token',
+        'session',
+        'cookie',
+        'csrf',
+        'xss',
+        'sql injection',
+        'sanitize',
+        'encrypt',
+        'encryption',
+        'https',
+        'tls',
+        'ssl',
+        'secret',
+        'credential',
+        'password',
+        'hash',
+        'salt',
+        'oauth',
+        'saml',
+        'sso',
+        'rate limit',
+        'ddos',
+        'audit log',
+        'pii',
+        'gdpr',
+        'data protection',
+        'vulnerability',
+        'threat',
+        'attack',
+        'penetration',
+    ],
+    performance: [
+        'performance',
+        'latency',
+        'throughput',
+        'response time',
+        'speed',
+        'fast',
+        'slow',
+        'optimization',
+        'cache',
+        'caching',
+        'cdn',
+        'load',
+        'scale',
+        'concurrent',
+        'async',
+        'parallel',
+        'batch',
+        'benchmark',
+        'profile',
+        'metric',
+        'monitor',
+        'sla',
+        'p99',
+        'p95',
+        'millisecond',
+        'second',
+        'rps',
+        'tps',
+        'qps',
+        'memory',
+        'cpu',
+        'bandwidth',
+        'bottleneck',
+    ],
+    integration: [
+        'integration',
+        'integrate',
+        'api',
+        'webhook',
+        'event',
+        'third-party',
+        'external',
+        'service',
+        'provider',
+        'vendor',
+        'sdk',
+        'library',
+        'plugin',
+        'connector',
+        'adapter',
+        'interface',
+        'contract',
+        'protocol',
+        'format',
+        'json',
+        'xml',
+        'csv',
+        'import',
+        'export',
+        'sync',
+        'async',
+        'push',
+        'pull',
+        'poll',
+        'stream',
+        'batch',
+        'migration',
+        'interop',
+    ],
+};
+/** Priority order for picking the next uncovered dimension. */
+const DIMENSION_PRIORITY = [
+    'technical',
+    'security',
+    'edge-cases',
+    'performance',
+    'integration',
+    'tradeoffs',
+    'ux',
+];
+/** Questions template per dimension. Avoids trivial things a senior dev already knows. */
+const DIMENSION_QUESTION_TEMPLATES = {
+    technical: (topic) => `For "${topic}", which architectural constraints or technology choices are non-negotiable — and which are open to discussion?`,
+    ux: (topic) => `Who are the distinct user personas for "${topic}", and what are the critical interaction flows that must feel seamless?`,
+    'edge-cases': (topic) => `What are the failure modes for "${topic}" that could silently corrupt data or leave the system in an inconsistent state?`,
+    tradeoffs: (topic) => `What tradeoffs are you willing to accept for "${topic}" — e.g., consistency vs. availability, simplicity vs. extensibility, speed to ship vs. completeness?`,
+    security: (topic) => `What is the threat model for "${topic}"? Which data is sensitive, who are the adversaries, and which attack vectors are in scope?`,
+    performance: (topic) => `What are the concrete SLAs for "${topic}" — target latency (p95/p99), throughput (rps), and acceptable degradation under load?`,
+    integration: (topic) => `Which external systems or third-party services must "${topic}" integrate with, and what are the contract/version constraints?`,
+};
+/**
+ * Analyzes answers to update which dimensions are covered.
+ * Merges with an existing coverage map if provided.
+ */
+export function updateCoverageFromAnswers(answers, existing) {
+    const base = existing ?? {
+        technical: false,
+        ux: false,
+        'edge-cases': false,
+        tradeoffs: false,
+        security: false,
+        performance: false,
+        integration: false,
+    };
+    const allText = Object.values(answers).join(' ').toLowerCase();
+    const dimensions = Object.keys(DIMENSION_KEYWORDS);
+    const updated = { ...base };
+    for (const dim of dimensions) {
+        if (updated[dim]) {
+            continue;
+        } // already covered
+        const keywords = DIMENSION_KEYWORDS[dim];
+        if (keywords.some((kw) => allText.includes(kw))) {
+            updated[dim] = true;
+        }
+    }
+    return updated;
+}
+/**
+ * Returns the lowest-priority uncovered dimension, or null if all are covered.
+ */
+export function pickNextDimension(coverage) {
+    for (const dim of DIMENSION_PRIORITY) {
+        if (!coverage[dim]) {
+            return dim;
+        }
+    }
+    return null;
+}
+/**
+ * Generates a targeted follow-up question for a specific dimension.
+ * Takes existing answers into account to avoid repeating covered ground.
+ */
+export function generateDimensionQuestion(dimension, topic, answers) {
+    const alreadyMentioned = Object.values(answers).join(' ').toLowerCase();
+    const baseQuestion = DIMENSION_QUESTION_TEMPLATES[dimension](topic);
+    // Add context hint if the answer set is non-empty and hints at partial coverage
+    const keywords = DIMENSION_KEYWORDS[dimension];
+    const partiallyMentioned = keywords.filter((kw) => alreadyMentioned.includes(kw));
+    if (partiallyMentioned.length > 0 && partiallyMentioned.length < 3) {
+        return `${baseQuestion} (You mentioned ${partiallyMentioned.slice(0, 2).join(', ')} — go deeper on constraints and non-obvious implications.)`;
+    }
+    return baseQuestion;
+}
+/**
+ * Computes completion percentage based on how many dimensions are covered (0–100).
+ */
+export function computeCompletion(coverage) {
+    const total = Object.keys(coverage).length;
+    const covered = Object.values(coverage).filter(Boolean).length;
+    return total === 0 ? 0 : Math.round((covered / total) * 100);
+}
+/**
+ * Returns true if the topic is too simple for interview mode.
+ * Delegates to isShortTopic from questions.ts.
+ */
+export function shouldSkipInterview(topic) {
+    return isShortTopic(topic);
+}
+//# sourceMappingURL=interview-mode.js.map