@planu/cli 0.91.0 → 0.93.0

package/dist/tools/domain-criteria-handler.js

@@ -0,0 +1,216 @@
+// tools/domain-criteria-handler.ts — Handlers for suggest_criteria and inject_criteria (SPEC-290)
+import { readFile, writeFile } from 'node:fs/promises';
+import { specStore } from '../storage/index.js';
+import { detectDomains } from '../engine/domain-detector.js';
+import { computeSuggestions } from '../engine/best-practices-library.js';
+// ---------------------------------------------------------------------------
+// Formatting helpers
+// ---------------------------------------------------------------------------
+function formatSuggestResult(result) {
+    const lines = [];
+    lines.push(`# Domain Criteria Suggestions — ${result.specId}`);
+    lines.push(`**Spec**: ${result.specTitle}`);
+    lines.push('');
+    if (result.suggestions.length === 0) {
+        lines.push('No domain detected in this spec. No suggestions available.');
+        return lines.join('\n');
+    }
+    for (const suggestion of result.suggestions) {
+        lines.push(`## Domain: \`${suggestion.domain}\``);
+        lines.push('');
+        if (suggestion.suggestedCriteria.length > 0) {
+            lines.push('### Suggested Criteria (not yet covered)');
+            lines.push('');
+            for (const c of suggestion.suggestedCriteria) {
+                lines.push(`- [ ] ${c}`);
+            }
+            lines.push('');
+        }
+        if (suggestion.alreadyCovered.length > 0) {
+            lines.push('### Already Covered');
+            lines.push('');
+            for (const c of suggestion.alreadyCovered) {
+                lines.push(`- [x] ${c}`);
+            }
+            lines.push('');
+        }
+        if (suggestion.hasCriticalGaps) {
+            lines.push('> **WARNING**: This domain has critical criteria missing. ' +
+                'Readiness score will be penalized until resolved.');
+            lines.push('');
+        }
+    }
+    lines.push(`---`);
+    lines.push(`Total suggested: **${result.totalSuggested}** criteria across ${result.suggestions.length} domain(s).`);
+    if (result.hasCriticalGaps) {
+        lines.push('');
+        lines.push('**ACTION REQUIRED**: Use `inject_criteria` to add the missing critical criteria to the spec.');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// suggest_criteria handler
+// ---------------------------------------------------------------------------
+export async function handleSuggestCriteria(args) {
+    const { projectId, specId, projectHash } = args;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Spec '${specId}' not found in project '${projectId}'`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Read spec file content for coverage analysis
+    let specContent = `${spec.title} ${spec.tags.join(' ')}`;
+    if (spec.specPath) {
+        try {
+            const fileContent = await readFile(spec.specPath, 'utf-8');
+            specContent += ' ' + fileContent;
+        }
+        catch {
+            // File not readable — use metadata only
+        }
+    }
+    const detection = detectDomains(spec.title, specContent);
+    if (detection.domains.length === 0) {
+        const result = {
+            specId,
+            specTitle: spec.title,
+            suggestions: [],
+            totalSuggested: 0,
+            hasCriticalGaps: false,
+        };
+        return {
+            content: [{ type: 'text', text: formatSuggestResult(result) }],
+            structuredContent: result,
+        };
+    }
+    const suggestions = computeSuggestions(detection.domains, specContent, projectHash);
+    const totalSuggested = suggestions.reduce((sum, s) => sum + s.suggestedCriteria.length, 0);
+    const hasCriticalGaps = suggestions.some((s) => s.hasCriticalGaps);
+    const result = {
+        specId,
+        specTitle: spec.title,
+        suggestions,
+        totalSuggested,
+        hasCriticalGaps,
+    };
+    return {
+        content: [{ type: 'text', text: formatSuggestResult(result) }],
+        structuredContent: result,
+    };
+}
+// ---------------------------------------------------------------------------
+// inject_criteria handler
+// ---------------------------------------------------------------------------
+export async function handleInjectCriteria(args) {
+    const { projectId, specId, criteriaIds, projectHash } = args;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Spec '${specId}' not found in project '${projectId}'`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (!spec.specPath) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Spec '${specId}' has no specPath — cannot inject criteria`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Read current spec content
+    let specContent;
+    try {
+        specContent = await readFile(spec.specPath, 'utf-8');
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Cannot read spec file at '${spec.specPath}': ${String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Compute which criteria to inject
+    const detection = detectDomains(spec.title, specContent);
+    const suggestions = computeSuggestions(detection.domains, specContent, projectHash);
+    // Collect all criteria to inject (filtered by criteriaIds if provided)
+    const toInject = [];
+    for (const suggestion of suggestions) {
+        for (let i = 0; i < suggestion.suggestedCriteria.length; i++) {
+            const id = suggestion.suggestedIds[i];
+            const criterion = suggestion.suggestedCriteria[i];
+            if (criterion === undefined) {
+                continue;
+            }
+            if (criteriaIds && id !== undefined && !criteriaIds.includes(id)) {
+                continue;
+            }
+            toInject.push(criterion);
+        }
+    }
+    if (toInject.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No criteria to inject for spec '${specId}'. All domain criteria are already covered, or no domain was detected.`,
+                },
+            ],
+        };
+    }
+    // Find the ## Acceptance Criteria section and append
+    const acHeader = '## Acceptance Criteria';
+    const acIndex = specContent.indexOf(acHeader);
+    let updatedContent;
+    const injectedLines = toInject
+        .map((c) => `- [ ] ${c}\n  <!-- injected by inject_criteria (SPEC-290) -->`)
+        .join('\n');
+    if (acIndex !== -1) {
+        // Find the end of the section header line and insert after it
+        const afterHeader = specContent.indexOf('\n', acIndex) + 1;
+        updatedContent =
+            specContent.slice(0, afterHeader) + injectedLines + '\n' + specContent.slice(afterHeader);
+    }
+    else {
+        // Append a new Acceptance Criteria section
+        updatedContent = specContent.trimEnd() + '\n\n' + acHeader + '\n\n' + injectedLines + '\n';
+    }
+    await writeFile(spec.specPath, updatedContent, 'utf-8');
+    const injResult = {
+        specId,
+        injectedCount: toInject.length,
+        injectedCriteria: toInject,
+        updatedFilePath: spec.specPath,
+    };
+    const text = [
+        `# Criteria Injected — ${specId}`,
+        '',
+        `Injected **${toInject.length}** criteria into \`${spec.specPath}\`:`,
+        '',
+        ...toInject.map((c) => `- [ ] ${c}`),
+    ].join('\n');
+    return {
+        content: [{ type: 'text', text }],
+        structuredContent: injResult,
+    };
+}
+//# sourceMappingURL=domain-criteria-handler.js.map

package/dist/tools/domain-criteria-handler.js.map

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

package/dist/tools/email-digest-handler.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult, ConfigureEmailDigestInput, GenerateDigestInput, SendDigestInput, EmailDigestStatusInput } from '../types/index.js';
+export declare function handleConfigureEmailDigest(input: ConfigureEmailDigestInput): Promise<ToolResult>;
+export declare function handleGenerateDigest(input: GenerateDigestInput): Promise<ToolResult>;
+export declare function handleSendDigest(input: SendDigestInput): Promise<ToolResult>;
+export declare function handleEmailDigestStatus(input: EmailDigestStatusInput): Promise<ToolResult>;
+//# sourceMappingURL=email-digest-handler.d.ts.map

package/dist/tools/email-digest-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-digest-handler.d.ts","sourceRoot":"","sources":["../../src/tools/email-digest-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EAKvB,MAAM,mBAAmB,CAAC;AAkB3B,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,UAAU,CAAC,CA8BrB;AAMD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC1F;AAMD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAoElF;AAMD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8ChG"}

package/dist/tools/email-digest-handler.js

@@ -0,0 +1,198 @@
+import { getEmailDigestConfig, saveEmailDigestConfig, getDeliveryLog, appendDelivery, } from '../storage/email-digest-store.js';
+import { generateDigestContent } from '../engine/email-digest-generator.js';
+import { sendViaFile, sendViaSendGrid, sendViaSmtp } from '../engine/email-sender.js';
+import { hashProjectPath } from '../storage/base-store.js';
+import { listSpecs } from '../storage/spec-store.js';
+const DEFAULT_PERIOD_DAYS = 7;
+// ---------------------------------------------------------------------------
+// configure_email_digest
+// ---------------------------------------------------------------------------
+export async function handleConfigureEmailDigest(input) {
+    const config = {
+        provider: input.provider,
+        frequency: input.frequency,
+        recipients: input.recipients,
+        credentials: input.credentials ?? {},
+        updatedAt: new Date().toISOString(),
+    };
+    await saveEmailDigestConfig(input.projectPath, config);
+    const lines = [
+        'Email digest configured.',
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| Provider | ${config.provider} |`,
+        `| Frequency | ${config.frequency} |`,
+        `| Recipients | ${config.recipients.join(', ')} |`,
+        `| Updated At | ${config.updatedAt.slice(0, 10)} |`,
+    ];
+    if (config.provider === 'sendgrid' && !config.credentials.apiKey) {
+        lines.push('', '> Warning: No API key set. Run again with credentials.apiKey to complete setup.');
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// generate_digest
+// ---------------------------------------------------------------------------
+export async function handleGenerateDigest(input) {
+    const days = input.days ?? DEFAULT_PERIOD_DAYS;
+    const projectId = hashProjectPath(input.projectPath);
+    const specs = await listSpecs(projectId);
+    const digest = generateDigestContent(specs, days);
+    const lines = [
+        `Digest generated for the last **${days} day${days === 1 ? '' : 's'}**.`,
+        '',
+        '**Stats:**',
+        `- Total specs: ${digest.stats.total}`,
+        `- Completed in period: ${digest.stats.completedInPeriod}`,
+        `- In progress: ${digest.stats.wipCount}`,
+        `- Blocked: ${digest.stats.blockedCount}`,
+        `- Upcoming (approved): ${digest.stats.upcomingCount}`,
+        '',
+        '---',
+        '',
+        digest.text,
+    ];
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        structuredContent: {
+            stats: digest.stats,
+            completedSpecs: digest.completedSpecs,
+            wipSpecs: digest.wipSpecs,
+            blockedSpecs: digest.blockedSpecs,
+            upcomingSpecs: digest.upcomingSpecs,
+            generatedAt: digest.generatedAt,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// send_digest
+// ---------------------------------------------------------------------------
+export async function handleSendDigest(input) {
+    const config = await getEmailDigestConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Email digest is not configured for this project. ' +
+                        'Run configure_email_digest first.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    const days = input.days ?? DEFAULT_PERIOD_DAYS;
+    const projectId = hashProjectPath(input.projectPath);
+    const specs = await listSpecs(projectId);
+    const digest = generateDigestContent(specs, days);
+    const deliveryId = generateDeliveryId();
+    const delivery = {
+        id: deliveryId,
+        sentAt: new Date().toISOString(),
+        status: 'sent',
+        provider: config.provider,
+    };
+    try {
+        await dispatchDigest(digest, config, projectId);
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        delivery.status = 'failed';
+        delivery.error = errMsg;
+        await appendDelivery(input.projectPath, delivery);
+        return {
+            content: [{ type: 'text', text: `Digest delivery failed: ${errMsg}` }],
+            isError: true,
+        };
+    }
+    if (config.provider === 'file') {
+        delivery.status = 'saved';
+    }
+    await appendDelivery(input.projectPath, delivery);
+    const providerLabel = config.provider === 'file'
+        ? `saved to disk (delivery ID: ${deliveryId})`
+        : `sent via ${config.provider} (delivery ID: ${deliveryId})`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `Digest ${providerLabel}.`,
+                    '',
+                    `Period: last ${days} day${days === 1 ? '' : 's'}`,
+                    `Recipients: ${config.recipients.join(', ') || '(file mode — no recipients)'}`,
+                    `Stats: ${digest.stats.completedInPeriod} completed, ${digest.stats.wipCount} in-progress, ${digest.stats.blockedCount} blocked`,
+                ].join('\n'),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// email_digest_status
+// ---------------------------------------------------------------------------
+export async function handleEmailDigestStatus(input) {
+    const [config, log] = await Promise.all([
+        getEmailDigestConfig(input.projectPath),
+        getDeliveryLog(input.projectPath),
+    ]);
+    if (config === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No email digest configuration found. ' +
+                        'Run configure_email_digest to set up digests for this project.',
+                },
+            ],
+        };
+    }
+    const lines = [
+        '**Email Digest Configuration**',
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| Provider | ${config.provider} |`,
+        `| Frequency | ${config.frequency} |`,
+        `| Recipients | ${config.recipients.join(', ') || '(none)'} |`,
+        `| Updated At | ${config.updatedAt.slice(0, 10)} |`,
+        '',
+        `**Delivery Log** (last ${log.length})`,
+    ];
+    if (log.length === 0) {
+        lines.push('', 'No deliveries yet.');
+    }
+    else {
+        lines.push('', '| ID | Date | Status | Provider |', '|----|------|--------|----------|');
+        for (const d of log) {
+            const errNote = d.error ? ` — ${d.error.slice(0, 60)}` : '';
+            lines.push(`| ${d.id} | ${d.sentAt.slice(0, 10)} | ${d.status}${errNote} | ${d.provider} |`);
+        }
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        structuredContent: { config, deliveries: log },
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+let _deliveryCounter = 0;
+function generateDeliveryId() {
+    _deliveryCounter += 1;
+    return `DLV-${String(_deliveryCounter).padStart(3, '0')}`;
+}
+async function dispatchDigest(digest, config, projectHash) {
+    const provider = config.provider;
+    if (provider === 'file') {
+        await sendViaFile(digest, projectHash);
+        return;
+    }
+    if (provider === 'sendgrid') {
+        await sendViaSendGrid(digest, config);
+        return;
+    }
+    /* v8 ignore next 2 */
+    await sendViaSmtp(digest, config);
+}
+//# sourceMappingURL=email-digest-handler.js.map

package/dist/tools/email-digest-handler.js.map

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

package/dist/tools/estimate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/tools/estimate.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE,wBAAsB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA6F7E"}
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/tools/estimate.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE,wBAAsB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAoH7E"}

package/dist/tools/estimate.js

@@ -1,6 +1,8 @@
 // tools/estimate.ts — Estimate difficulty, hours, tokens, costs for a spec
 // Uses the estimator engine with historical metrics for calibration.
 import { specStore, metricsStore, globalStore, knowledgeStore } from '../storage/index.js';
+import { getCalibration } from '../storage/actuals-store.js';
+import { applyCalibration } from '../engine/estimation-calibrator.js';
 import { estimateSpec } from '../engine/estimator.js';
 import { classifyOperation, recommendModel } from '../engine/token-tracker.js';
 import { ti } from '../i18n/index.js';
@@ -32,6 +34,25 @@ export async function handleEstimate(args) {
     const metricsHistory = await metricsStore.getMetricsHistory(projectId);
     // 5. Run estimation engine
     const result = estimateSpec(spec, configOverrides, metricsHistory.entries);
+    // 5a. SPEC-287: Apply SPEC-287 calibration factors on top of existing estimation
+    const calibrationFactors = await getCalibration(projectId).catch(() => null);
+    let calibrationNote = null;
+    if (calibrationFactors) {
+        const rawHours = result.estimation.devHours + result.estimation.reviewHours;
+        const calibratedHours = applyCalibration(rawHours, spec.scope, spec.type, calibrationFactors);
+        if (calibratedHours !== rawHours) {
+            const ratio = calibratedHours / rawHours;
+            result.estimation.devHours = Math.round(result.estimation.devHours * ratio * 10) / 10;
+            result.estimation.reviewHours = Math.round(result.estimation.reviewHours * ratio * 10) / 10;
+            result.estimation.humanCostUsd =
+                Math.round((result.estimation.devHours + result.estimation.reviewHours) *
+                    result.estimation.hourlyRate *
+                    100) / 100;
+            result.estimation.totalCostUsd =
+                Math.round((result.estimation.apiCostUsd + result.estimation.humanCostUsd) * 100) / 100;
+            calibrationNote = `Calibration applied (${spec.scope}/${spec.type}): ${String(rawHours)}h → ${String(calibratedHours)}h`;
+        }
+    }
     // 6. Update spec with estimation data
     await specStore.updateSpec(projectId, specId, {
         estimation: result.estimation,
@@ -66,6 +87,7 @@ export async function handleEstimate(args) {
         reasoning: result.reasoning,
         similarSpecs: result.similarSpecs,
         historyUsed: metricsHistory.entries.length > 0,
+        calibrationApplied: calibrationNote,
     };
     const level = knowledge?.experienceLevel ?? 'intermediate';
     const summary = formatByLevel(ti('tools.estimate.success', {

package/dist/tools/estimate.js.map

@@ -1 +1 @@
-{"version":3,"file":"estimate.js","sourceRoot":"","sources":["../../src/tools/estimate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"estimate.js","sourceRoot":"","sources":["../../src/tools/estimate.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AAErE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGlF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAmB;IACtD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAEnC,eAAe;IACf,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,EAAE,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAC/E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,eAAe,EAAE,CAAC;IAEzD,oDAAoD;IACpD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,eAAe,GAAG;QACtB,GAAG,YAAY;QACf,GAAG,CAAC,SAAS,EAAE,eAAe,KAAK,UAAU;YAC3C,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,GAAG,GAAG,EAAE;YAC/C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,EAAE,eAAe,KAAK,QAAQ;YACzC,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,GAAG,GAAG,EAAE;YAC/C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IAEF,6CAA6C;IAC7C,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEvE,2BAA2B;IAC3B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3E,iFAAiF;IACjF,MAAM,kBAAkB,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7E,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,kBAAkB,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC;QAC5E,MAAM,eAAe,GAAG,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QAC9F,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,eAAe,GAAG,QAAQ,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;YACtF,MAAM,CAAC,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,GAAG,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;YAC5F,MAAM,CAAC,UAAU,CAAC,YAAY;gBAC5B,IAAI,CAAC,KAAK,CACR,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC;oBAC1D,MAAM,CAAC,UAAU,CAAC,UAAU;oBAC5B,GAAG,CACN,GAAG,GAAG,CAAC;YACV,MAAM,CAAC,UAAU,CAAC,YAAY;gBAC5B,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YAC1F,eAAe,GAAG,wBAAwB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC;QAC3H,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,MAAM,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE;QAC5C,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;IAEH,kBAAkB;IAClB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC;IAC9B,2EAA2E;IAC3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG;QACb,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE;YACV,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;YAClE,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;SACzC;QACD,aAAa,EAAE;YACb,aAAa,EAAE,SAAS;YACxB,gBAAgB,EAAE,cAAc;YAChC,cAAc,EAAE,OAAO,cAAc,qDAAqD;SAC3F;QACD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC9C,kBAAkB,EAAE,eAAe;KACpC,CAAC;IAEF,MAAM,KAAK,GAAG,SAAS,EAAE,eAAe,IAAI,cAAc,CAAC;IAC3D,MAAM,OAAO,GAAG,aAAa,CAC3B,EAAE,CAAC,wBAAwB,EAAE;QAC3B,MAAM;QACN,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;KACvC,CAAC,EACF,EAAE,CAAC,wBAAwB,EAAE;QAC3B,MAAM;QACN,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;KACvC,CAAC,EACF,GAAG,MAAM,KAAK,GAAG,CAAC,QAAQ,YAAY,GAAG,CAAC,YAAY,sBAAsB,MAAM,CAAC,UAAU,EAAE,EAC/F,KAAK,CACN,CAAC;IAEF,OAAO;QACL,UAAU,EAAE,qBAAqB,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,CAAC;QAC5E,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnD,iGAAiG;QACjG,iBAAiB,EAAE,MAAiC;KACrD,CAAC;AACJ,CAAC"}

package/dist/tools/estimation-accuracy-handler.d.ts

@@ -0,0 +1,5 @@
+import type { ToolResult, RecordActualInput, AccuracyReportInput, CalibrateInput } from '../types/index.js';
+export declare function handleRecordActual(input: RecordActualInput): Promise<ToolResult>;
+export declare function handleEstimationAccuracyReport(input: AccuracyReportInput): Promise<ToolResult>;
+export declare function handleCalibrateEstimates(input: CalibrateInput): Promise<ToolResult>;
+//# sourceMappingURL=estimation-accuracy-handler.d.ts.map

package/dist/tools/estimation-accuracy-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimation-accuracy-handler.d.ts","sourceRoot":"","sources":["../../src/tools/estimation-accuracy-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EAIf,MAAM,mBAAmB,CAAC;AA4B3B,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqEtF;AAMD,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,UAAU,CAAC,CAuDrB;AAMD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA6CzF"}