@planu/cli 4.11.0 → 4.11.2

package/dist/config/elicitation-dimensions.json

@@ -1,51 +0,0 @@
-[
-  {
-    "id": "target",
-    "headerKey": "questions.target.header",
-    "questionKey": "questions.target.question",
-    "suppressWhen": "hasTarget",
-    "optionSet": "target",
-    "multiSelect": false
-  },
-  {
-    "id": "payment_provider",
-    "headerKey": "questions.payment.providerHeader",
-    "questionKey": "questions.payment.providerQuestion",
-    "requiresSignal": "hasBilling",
-    "suppressWhen": "namedProvider",
-    "optionSet": "payment_provider",
-    "multiSelect": false
-  },
-  {
-    "id": "billing_model",
-    "headerKey": "questions.payment.modelHeader",
-    "questionKey": "questions.payment.modelQuestion",
-    "requiresSignal": "hasBilling",
-    "optionSet": "billing_model",
-    "multiSelect": false
-  },
-  {
-    "id": "scope",
-    "headerKey": "questions.scope.header",
-    "questionKey": "questions.scope.question",
-    "suppressWhen": "hasScope",
-    "optionSet": "scope",
-    "multiSelect": false
-  },
-  {
-    "id": "database",
-    "headerKey": "questions.database.header",
-    "questionKey": "questions.database.question",
-    "requiresSignal": "hasDatabase",
-    "optionSet": "database",
-    "multiSelect": true
-  },
-  {
-    "id": "uiType",
-    "headerKey": "questions.uiType.header",
-    "questionKey": "questions.uiType.question",
-    "requiresSignal": "hasUi",
-    "optionSet": "uiType",
-    "multiSelect": false
-  }
-]

package/dist/engine/actuals-estimator.d.ts

@@ -1,14 +0,0 @@
-import type { Actuals, Estimation } from '../types/index.js';
-/** Returns true when all token/cost actuals are zero (agent did not provide them). */
-export declare function actualsAreMissing(actuals: Actuals): boolean;
-/**
- * Auto-fills zero token/cost fields in actuals using the spec's estimation data.
- * Marks the result with `estimated: true` so reports can distinguish real vs auto values.
- */
-export declare function autoFillActuals(actuals: Actuals, estimation: Estimation): Actuals;
-/**
- * Creates a default Actuals object from the spec's estimation when the agent
- * did not provide actuals at all. Token/cost fields are auto-estimated.
- */
-export declare function createDefaultActuals(estimation: Estimation): Actuals;
-//# sourceMappingURL=actuals-estimator.d.ts.map

package/dist/engine/actuals-estimator.js

@@ -1,64 +0,0 @@
-// Rough tokens consumed per dev-hour of Claude Code work (empirical approximation)
-const OPUS_TOKENS_PER_DEV_HOUR = 25_000;
-const SONNET_TOKENS_PER_DEV_HOUR = 45_000;
-// Blended input+output cost per token (Anthropic 2026 pricing)
-const OPUS_COST_PER_TOKEN = 0.00004; // ~$40/1M blended
-const SONNET_COST_PER_TOKEN = 0.000008; // ~$8/1M blended
-/** Returns true when all token/cost actuals are zero (agent did not provide them). */
-export function actualsAreMissing(actuals) {
-    return actuals.tokensOpus === 0 && actuals.tokensSonnet === 0 && actuals.apiCostUsd === 0;
-}
-/**
- * Auto-fills zero token/cost fields in actuals using the spec's estimation data.
- * Marks the result with `estimated: true` so reports can distinguish real vs auto values.
- */
-export function autoFillActuals(actuals, estimation) {
-    if (!actualsAreMissing(actuals)) {
-        return actuals;
-    }
-    const hours = actuals.devHours > 0 ? actuals.devHours : estimation.devHours;
-    let tokensOpus = 0;
-    let tokensSonnet = 0;
-    if (estimation.recommendedModel === 'opus') {
-        tokensOpus = Math.round(hours * OPUS_TOKENS_PER_DEV_HOUR);
-    }
-    else if (estimation.recommendedModel === 'sonnet') {
-        tokensSonnet = Math.round(hours * SONNET_TOKENS_PER_DEV_HOUR);
-    }
-    else {
-        // mixed: 40% opus, 60% sonnet
-        tokensOpus = Math.round(hours * OPUS_TOKENS_PER_DEV_HOUR * 0.4);
-        tokensSonnet = Math.round(hours * SONNET_TOKENS_PER_DEV_HOUR * 0.6);
-    }
-    const apiCostUsd = tokensOpus * OPUS_COST_PER_TOKEN + tokensSonnet * SONNET_COST_PER_TOKEN;
-    const humanCostUsd = actuals.humanCostUsd > 0 ? actuals.humanCostUsd : hours * estimation.hourlyRate;
-    const totalCostUsd = apiCostUsd + humanCostUsd;
-    return {
-        ...actuals,
-        tokensOpus,
-        tokensSonnet,
-        apiCostUsd: parseFloat(apiCostUsd.toFixed(4)),
-        humanCostUsd: parseFloat(humanCostUsd.toFixed(4)),
-        totalCostUsd: parseFloat(totalCostUsd.toFixed(4)),
-        estimated: true,
-    };
-}
-/**
- * Creates a default Actuals object from the spec's estimation when the agent
- * did not provide actuals at all. Token/cost fields are auto-estimated.
- */
-export function createDefaultActuals(estimation) {
-    const base = {
-        devHours: estimation.devHours,
-        reviewHours: estimation.reviewHours,
-        tokensOpus: 0,
-        tokensSonnet: 0,
-        apiCostUsd: 0,
-        humanCostUsd: estimation.humanCostUsd,
-        totalCostUsd: 0,
-        completedAt: new Date().toISOString(),
-        notes: '',
-    };
-    return autoFillActuals(base, estimation);
-}
-//# sourceMappingURL=actuals-estimator.js.map

package/dist/engine/cascade-hooks/hooks/living-specs.hook.d.ts

@@ -1,3 +0,0 @@
-import type { CascadeHook } from '../../../types/cascade-hooks.js';
-export declare const livingSpecsHook: CascadeHook;
-//# sourceMappingURL=living-specs.hook.d.ts.map

package/dist/engine/cascade-hooks/hooks/living-specs.hook.js

@@ -1,19 +0,0 @@
-async function handler(ctx) {
-    const { specId, projectPath } = ctx;
-    if (!projectPath) {
-        return;
-    }
-    await import('../../living-specs/index.js')
-        .then(({ reconcileSpec }) => reconcileSpec(specId, projectPath))
-        .catch((err) => {
-        console.error('[planu] living-specs auto-reconcile failed:', err);
-    });
-}
-export const livingSpecsHook = {
-    id: 'living-specs',
-    triggers: ['implementing', 'done'],
-    requiresProjectPath: true,
-    label: 'Auto-reconcile living specs on implementing/done (SPEC-330)',
-    handler,
-};
-//# sourceMappingURL=living-specs.hook.js.map

package/dist/engine/elicitation/option-builder.d.ts

@@ -1,9 +0,0 @@
-import type { ProjectKnowledge, InteractiveOption } from '../../types/index.js';
-/** Payment provider options — puts DNA-detected provider first when found. */
-export declare function buildPaymentProviderOptions(knowledge: ProjectKnowledge | null): InteractiveOption[];
-export declare function buildBillingModelOptions(): InteractiveOption[];
-export declare function buildTargetOptions(): InteractiveOption[];
-export declare function buildScopeOptions(): InteractiveOption[];
-export declare function buildDatabaseOptions(): InteractiveOption[];
-export declare function buildUiTypeOptions(): InteractiveOption[];
-//# sourceMappingURL=option-builder.d.ts.map

package/dist/engine/elicitation/option-builder.js

@@ -1,85 +0,0 @@
-// src/engine/elicitation/option-builder.ts
-// SPEC-624: Builds InteractiveOption lists from project DNA instead of hardcoded arrays.
-import { t } from '../../i18n/index.js';
-const DNA_PROVIDERS = ['stripe', 'paypal', 'paddle', 'braintree', 'adyen'];
-function capitalize(s) {
-    return s.charAt(0).toUpperCase() + s.slice(1);
-}
-/** Payment provider options — puts DNA-detected provider first when found. */
-export function buildPaymentProviderOptions(knowledge) {
-    const stack = knowledge?.stack ?? [];
-    const services = (knowledge?.externalServices ?? []).map((s) => s.toLowerCase());
-    const detected = DNA_PROVIDERS.filter((p) => stack.some((s) => s.toLowerCase().includes(p)) || services.some((s) => s.includes(p)));
-    const [firstProvider, ...restProviders] = detected;
-    if (firstProvider !== undefined) {
-        const firstLabel = `${capitalize(firstProvider)} (Recommended)`;
-        const rest = restProviders.slice(0, 2).map((p) => ({
-            label: capitalize(p),
-            description: t(`questions.payment.${p}Desc`),
-        }));
-        return [
-            { label: firstLabel, description: t(`questions.payment.${firstProvider}Desc`) },
-            ...rest,
-            { label: t('questions.payment.other'), description: t('questions.payment.otherDesc') },
-        ].slice(0, 4);
-    }
-    return [
-        { label: t('questions.payment.stripe'), description: t('questions.payment.stripeDesc') },
-        { label: t('questions.payment.paypal'), description: t('questions.payment.paypalDesc') },
-        { label: t('questions.payment.paddle'), description: t('questions.payment.paddleDesc') },
-        { label: t('questions.payment.other'), description: t('questions.payment.otherDesc') },
-    ];
-}
-export function buildBillingModelOptions() {
-    return [
-        { label: t('questions.payment.oneTime'), description: t('questions.payment.oneTimeDesc') },
-        { label: t('questions.payment.recurring'), description: t('questions.payment.recurringDesc') },
-        {
-            label: t('questions.payment.usageBased'),
-            description: t('questions.payment.usageBasedDesc'),
-        },
-        { label: t('questions.payment.freemium'), description: t('questions.payment.freemiumDesc') },
-    ];
-}
-export function buildTargetOptions() {
-    return [
-        { label: t('questions.target.frontend'), description: t('questions.target.frontendDesc') },
-        { label: t('questions.target.backend'), description: t('questions.target.backendDesc') },
-        { label: t('questions.target.fullstack'), description: t('questions.target.fullstackDesc') },
-        { label: t('questions.target.infra'), description: t('questions.target.infraDesc') },
-    ];
-}
-export function buildScopeOptions() {
-    return [
-        { label: t('questions.scope.feature'), description: t('questions.scope.featureDesc') },
-        { label: t('questions.scope.crossModule'), description: t('questions.scope.crossModuleDesc') },
-        { label: t('questions.scope.trivial'), description: t('questions.scope.trivialDesc') },
-        {
-            label: t('questions.scope.architectural'),
-            description: t('questions.scope.architecturalDesc'),
-        },
-    ];
-}
-export function buildDatabaseOptions() {
-    return [
-        { label: t('questions.database.none'), description: t('questions.database.noneDesc') },
-        { label: t('questions.database.schema'), description: t('questions.database.schemaDesc') },
-        { label: t('questions.database.rls'), description: t('questions.database.rlsDesc') },
-        { label: t('questions.database.rpc'), description: t('questions.database.rpcDesc') },
-    ];
-}
-export function buildUiTypeOptions() {
-    return [
-        {
-            label: t('questions.uiType.newComponent'),
-            description: t('questions.uiType.newComponentDesc'),
-        },
-        { label: t('questions.uiType.modify'), description: t('questions.uiType.modifyDesc') },
-        {
-            label: t('questions.uiType.serverAction'),
-            description: t('questions.uiType.serverActionDesc'),
-        },
-        { label: t('questions.uiType.noUi'), description: t('questions.uiType.noUiDesc') },
-    ];
-}
-//# sourceMappingURL=option-builder.js.map

package/dist/engine/progress-writer.d.ts

@@ -1,10 +0,0 @@
-import type { Spec } from '../types/index.js';
-/**
- * Generate initial ## Progress content for a newly created spec.
- */
-export declare function generateProgressContent(spec: Spec): string;
-/**
- * Generate updated ## Progress content reflecting a status change.
- */
-export declare function generateProgressUpdate(spec: Spec, previousStatus: string, existingContent: string): string;
-//# sourceMappingURL=progress-writer.d.ts.map

package/dist/engine/progress-writer.js

@@ -1,63 +0,0 @@
-/**
- * Generate initial ## Progress content for a newly created spec.
- */
-export function generateProgressContent(spec) {
-    const sections = [
-        { title: 'Progress', content: buildHeader(spec) },
-        { title: 'Status History', content: buildStatusHistory(spec) },
-        { title: 'Metrics', content: buildMetrics(spec) },
-    ];
-    return sections.map((s) => `## ${s.title}\n\n${s.content}`).join('\n\n---\n\n');
-}
-/**
- * Generate updated ## Progress content reflecting a status change.
- */
-export function generateProgressUpdate(spec, previousStatus, existingContent) {
-    const timestamp = new Date().toISOString();
-    const entry = `| ${timestamp} | ${previousStatus} → ${spec.status} |`;
-    if (existingContent.includes('| Timestamp')) {
-        return existingContent.replace(/((?:\|[^\n]*\n)+)/, `$1${entry}\n`);
-    }
-    return generateProgressContent(spec);
-}
-function buildHeader(spec) {
-    const lines = [
-        `**Spec:** ${spec.id}`,
-        `**Title:** ${spec.title}`,
-        `**Status:** ${spec.status}`,
-        `**Created:** ${spec.createdAt}`,
-        `**Last Updated:** ${spec.updatedAt}`,
-        '',
-        `**Difficulty:** ${spec.difficulty} | **Risk:** ${spec.risk}`,
-        `**Target:** ${spec.target} | **Scope:** ${spec.scope}`,
-    ];
-    if (spec.gitBranch) {
-        lines.push(`**Branch:** \`${spec.gitBranch}\``);
-    }
-    return lines.join('\n');
-}
-function buildStatusHistory(spec) {
-    return [
-        '| Timestamp | Transition |',
-        '|-----------|-----------|',
-        `| ${spec.createdAt} | → ${spec.status} |`,
-    ].join('\n');
-}
-function buildMetrics(spec) {
-    const est = spec.estimation;
-    const lines = [
-        '| Metric | Estimated | Actual |',
-        '|--------|-----------|--------|',
-        `| Dev Hours | ${String(est.devHours)} | - |`,
-        `| Review Hours | ${String(est.reviewHours)} | - |`,
-        `| Total Cost (USD) | $${String(est.totalCostUsd)} | - |`,
-    ];
-    if (spec.actuals) {
-        const act = spec.actuals;
-        lines[2] = `| Dev Hours | ${String(est.devHours)} | ${String(act.devHours)} |`;
-        lines[3] = `| Review Hours | ${String(est.reviewHours)} | ${String(act.reviewHours)} |`;
-        lines[4] = `| Total Cost (USD) | $${String(est.totalCostUsd)} | $${String(act.totalCostUsd)} |`;
-    }
-    return lines.join('\n');
-}
-//# sourceMappingURL=progress-writer.js.map

package/dist/tools/update-status/mode-hints.d.ts

@@ -1,4 +0,0 @@
-import type { ModeSuggestion } from '../../types/index.js';
-/** Returns the suggested Claude Code permission mode for a given spec status, or undefined for unknown statuses. */
-export declare function getSuggestedMode(newStatus: string): ModeSuggestion | undefined;
-//# sourceMappingURL=mode-hints.d.ts.map

package/dist/tools/update-status/mode-hints.js

@@ -1,24 +0,0 @@
-// tools/update-status/mode-hints.ts — Map spec status to suggested Claude Code permission mode
-// SPEC-494: Claude Code mode hints per spec phase
-const MODE_MAP = {
-    draft: 'default',
-    review: 'default',
-    approved: 'plan',
-    implementing: 'acceptEdits',
-    done: 'default',
-    discarded: 'default',
-};
-const MODE_HINTS = {
-    default: 'Spec is in an early phase — Claude will ask before each change.',
-    plan: 'Spec is approved. Use `/mode plan` to prevent accidental edits while reviewing the implementation plan.',
-    acceptEdits: 'Spec is the contract — safe to auto-accept file edits. Use `/mode acceptEdits`. Bash commands still ask for approval.',
-};
-/** Returns the suggested Claude Code permission mode for a given spec status, or undefined for unknown statuses. */
-export function getSuggestedMode(newStatus) {
-    const mode = MODE_MAP[newStatus];
-    if (mode === undefined) {
-        return undefined;
-    }
-    return { mode, hint: MODE_HINTS[mode] ?? '' };
-}
-//# sourceMappingURL=mode-hints.js.map