@planu/cli 0.91.0 → 0.93.0

package/dist/engine/domain-detector.js

@@ -0,0 +1,286 @@
+// engine/domain-detector.ts — Detects spec domains from title + description (SPEC-290)
+//
+// Analyzes spec text to identify which technical domains apply.
+// Detection is keyword-based and returns evidence for each domain found.
+const DOMAIN_KEYWORDS = [
+    {
+        domain: 'payments',
+        keywords: [
+            'payment',
+            'payments',
+            'stripe',
+            'paypal',
+            'billing',
+            'invoice',
+            'checkout',
+            'subscription',
+            'transaction',
+            'charge',
+            'refund',
+            'pci',
+            'credit card',
+            'debit card',
+            'wallet',
+            'purchase',
+        ],
+    },
+    {
+        domain: 'authentication',
+        keywords: [
+            'authentication',
+            'login',
+            'logout',
+            'sign in',
+            'sign up',
+            'register',
+            'password',
+            'credentials',
+            'jwt',
+            'oauth',
+            'saml',
+            'sso',
+            'mfa',
+            '2fa',
+            'two factor',
+            'magic link',
+        ],
+    },
+    {
+        domain: 'authorization',
+        keywords: [
+            'authorization',
+            'permission',
+            'role',
+            'rbac',
+            'abac',
+            'access control',
+            'acl',
+            'privilege',
+            'grant',
+            'revoke',
+            'policy',
+            'can i',
+        ],
+    },
+    {
+        domain: 'file-upload',
+        keywords: [
+            'file upload',
+            'upload',
+            'attachment',
+            'file storage',
+            'blob',
+            's3',
+            'gcs',
+            'azure blob',
+            'media upload',
+            'image upload',
+            'document upload',
+            'multipart',
+        ],
+    },
+    {
+        domain: 'email',
+        keywords: [
+            'email',
+            'e-mail',
+            'smtp',
+            'sendgrid',
+            'mailgun',
+            'ses',
+            'newsletter',
+            'transactional email',
+            'email template',
+            'inbox',
+            'mailer',
+        ],
+    },
+    {
+        domain: 'notifications',
+        keywords: [
+            'notification',
+            'push notification',
+            'fcm',
+            'apns',
+            'alert',
+            'in-app notification',
+            'toast',
+            'bell icon',
+            'notify',
+        ],
+    },
+    {
+        domain: 'search',
+        keywords: [
+            'search',
+            'full-text search',
+            'elasticsearch',
+            'algolia',
+            'meilisearch',
+            'typesense',
+            'solr',
+            'query',
+            'filter results',
+            'autocomplete',
+            'typeahead',
+        ],
+    },
+    {
+        domain: 'mobile-offline',
+        keywords: [
+            'offline',
+            'offline first',
+            'offline mode',
+            'sync',
+            'synchronization',
+            'local database',
+            'sqlite',
+            'realm',
+            'pouchdb',
+            'service worker',
+            'cache first',
+            'background sync',
+        ],
+    },
+    {
+        domain: 'realtime',
+        keywords: [
+            'realtime',
+            'real-time',
+            'websocket',
+            'socket.io',
+            'sse',
+            'server-sent events',
+            'live update',
+            'live feed',
+            'pub/sub',
+            'presence',
+            'collaborative',
+            'live collaboration',
+        ],
+    },
+    {
+        domain: 'background-jobs',
+        keywords: [
+            'background job',
+            'queue',
+            'worker',
+            'cron',
+            'scheduled task',
+            'bull',
+            'celery',
+            'sidekiq',
+            'job processor',
+            'async job',
+            'job runner',
+            'task queue',
+            'message queue',
+        ],
+    },
+    {
+        domain: 'api-public',
+        keywords: [
+            'public api',
+            'rest api',
+            'graphql api',
+            'api key',
+            'third-party integration',
+            'webhook',
+            'sdk',
+            'developer portal',
+            'external api',
+            'openapi',
+        ],
+    },
+    {
+        domain: 'data-export',
+        keywords: [
+            'export',
+            'download',
+            'report',
+            'csv export',
+            'excel export',
+            'data export',
+            'bulk export',
+            'generate report',
+            'export data',
+        ],
+    },
+    {
+        domain: 'multi-tenant',
+        keywords: [
+            'multi-tenant',
+            'multitenant',
+            'tenant',
+            'organization',
+            'workspace',
+            'team isolation',
+            'account isolation',
+            'saas',
+        ],
+    },
+    {
+        domain: 'gdpr',
+        keywords: [
+            'gdpr',
+            'privacy',
+            'personal data',
+            'pii',
+            'data protection',
+            'right to erasure',
+            'right to be forgotten',
+            'consent',
+            'dpa',
+            'data subject',
+            'data processor',
+            'ccpa',
+            'lgpd',
+        ],
+    },
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detect domains from spec title + description text.
+ * Returns each detected domain with the matching keywords as evidence.
+ */
+export function detectDomains(title, description) {
+    const combinedText = `${title} ${description}`;
+    const lower = combinedText.toLowerCase();
+    const domains = [];
+    const evidence = {};
+    for (const entry of DOMAIN_KEYWORDS) {
+        const matched = entry.keywords.filter((kw) => lower.includes(kw.toLowerCase()));
+        if (matched.length > 0) {
+            domains.push(entry.domain);
+            evidence[entry.domain] = matched;
+        }
+    }
+    return { domains, evidence, analyzedText: combinedText };
+}
+/**
+ * Detect a single dominant domain (highest keyword hit count).
+ * Returns null if no domain is detected.
+ */
+export function detectPrimaryDomain(title, description) {
+    const result = detectDomains(title, description);
+    if (result.domains.length === 0) {
+        return null;
+    }
+    const firstDomain = result.domains[0];
+    if (!firstDomain) {
+        return null;
+    }
+    let best = firstDomain;
+    let bestCount = result.evidence[best]?.length ?? 0;
+    for (const domain of result.domains.slice(1)) {
+        const count = result.evidence[domain]?.length ?? 0;
+        if (count > bestCount) {
+            best = domain;
+            bestCount = count;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=domain-detector.js.map

package/dist/engine/domain-detector.js.map

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

package/dist/engine/email-digest-generator.d.ts

@@ -0,0 +1,8 @@
+import type { Spec, DigestContent } from '../types/index.js';
+/**
+ * Build a DigestContent from the given list of specs and period (days).
+ * Only specs with updatedAt within the last `periodDays` days are considered
+ * "recent" for the completedInPeriod stat.
+ */
+export declare function generateDigestContent(specs: Spec[], periodDays: number): DigestContent;
+//# sourceMappingURL=email-digest-generator.d.ts.map

package/dist/engine/email-digest-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-digest-generator.d.ts","sourceRoot":"","sources":["../../src/engine/email-digest-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAkC,MAAM,mBAAmB,CAAC;AAuK7F;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,CA8CtF"}

package/dist/engine/email-digest-generator.js

@@ -0,0 +1,192 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function toSummary(spec) {
+    return {
+        id: spec.id,
+        title: spec.title,
+        status: spec.status,
+        updatedAt: spec.updatedAt,
+    };
+}
+function isWithinPeriod(updatedAt, periodDays) {
+    if (!updatedAt) {
+        return false;
+    }
+    const cutoff = Date.now() - periodDays * 24 * 60 * 60 * 1000;
+    return new Date(updatedAt).getTime() >= cutoff;
+}
+// ---------------------------------------------------------------------------
+// HTML template (inline CSS — no external dependencies)
+// ---------------------------------------------------------------------------
+function buildHtml(content) {
+    const { subject, stats, completedSpecs, wipSpecs, blockedSpecs, upcomingSpecs, periodDays } = content;
+    const specRows = (specs) => {
+        if (specs.length === 0) {
+            return '<p style="color:#888;font-size:14px;">None</p>';
+        }
+        return specs
+            .map((s) => `<tr>
+            <td style="padding:6px 10px;font-family:monospace;font-size:13px;">${s.id}</td>
+            <td style="padding:6px 10px;font-size:13px;">${s.title}</td>
+            <td style="padding:6px 10px;font-size:12px;color:#555;">${s.status}</td>
+          </tr>`)
+            .join('\n');
+    };
+    const section = (title, specs, color) => `
+    <h2 style="color:${color};font-size:16px;margin-top:24px;">${title} (${specs.length})</h2>
+    <table style="width:100%;border-collapse:collapse;background:#fff;">
+      <thead>
+        <tr style="background:#f5f5f5;">
+          <th style="padding:6px 10px;text-align:left;font-size:12px;color:#555;">ID</th>
+          <th style="padding:6px 10px;text-align:left;font-size:12px;color:#555;">Title</th>
+          <th style="padding:6px 10px;text-align:left;font-size:12px;color:#555;">Status</th>
+        </tr>
+      </thead>
+      <tbody>${specRows(specs)}</tbody>
+    </table>`;
+    return `<!DOCTYPE html>
+<html lang="en">
+<head><meta charset="UTF-8"><title>${subject}</title></head>
+<body style="font-family:Arial,sans-serif;background:#f9f9f9;margin:0;padding:20px;">
+  <div style="max-width:700px;margin:0 auto;background:#fff;border-radius:8px;
+       padding:32px;box-shadow:0 2px 8px rgba(0,0,0,0.08);">
+
+    <h1 style="font-size:22px;color:#333;border-bottom:2px solid #e2e8f0;
+        padding-bottom:12px;">${subject}</h1>
+
+    <p style="color:#666;font-size:14px;">
+      Planu digest for the last <strong>${periodDays} day${periodDays === 1 ? '' : 's'}</strong>.
+      Generated on <strong>${content.generatedAt.slice(0, 10)}</strong>.
+    </p>
+
+    <h2 style="color:#333;font-size:16px;margin-top:24px;">Overview</h2>
+    <table style="border-collapse:collapse;">
+      <tr>
+        <td style="padding:4px 16px 4px 0;font-size:14px;color:#555;">Total specs</td>
+        <td style="padding:4px 0;font-size:14px;font-weight:bold;">${stats.total}</td>
+      </tr>
+      <tr>
+        <td style="padding:4px 16px 4px 0;font-size:14px;color:#555;">
+          Completed in period</td>
+        <td style="padding:4px 0;font-size:14px;font-weight:bold;color:#22c55e;">
+          ${stats.completedInPeriod}</td>
+      </tr>
+      <tr>
+        <td style="padding:4px 16px 4px 0;font-size:14px;color:#555;">In progress</td>
+        <td style="padding:4px 0;font-size:14px;font-weight:bold;color:#3b82f6;">
+          ${stats.wipCount}</td>
+      </tr>
+      <tr>
+        <td style="padding:4px 16px 4px 0;font-size:14px;color:#555;">Blocked</td>
+        <td style="padding:4px 0;font-size:14px;font-weight:bold;color:#ef4444;">
+          ${stats.blockedCount}</td>
+      </tr>
+      <tr>
+        <td style="padding:4px 16px 4px 0;font-size:14px;color:#555;">Upcoming (approved)</td>
+        <td style="padding:4px 0;font-size:14px;font-weight:bold;color:#f59e0b;">
+          ${stats.upcomingCount}</td>
+      </tr>
+    </table>
+
+    ${section('Completed', completedSpecs, '#22c55e')}
+    ${section('In Progress', wipSpecs, '#3b82f6')}
+    ${section('Blocked', blockedSpecs, '#ef4444')}
+    ${section('Upcoming', upcomingSpecs, '#f59e0b')}
+
+    <p style="margin-top:32px;font-size:11px;color:#aaa;border-top:1px solid #e2e8f0;
+        padding-top:12px;">
+      Generated by <a href="https://planu.dev" style="color:#aaa;">Planu</a>
+    </p>
+  </div>
+</body>
+</html>`;
+}
+// ---------------------------------------------------------------------------
+// Plain text template
+// ---------------------------------------------------------------------------
+function buildText(content) {
+    const { subject, stats, completedSpecs, wipSpecs, blockedSpecs, upcomingSpecs, periodDays } = content;
+    const specLines = (specs) => {
+        if (specs.length === 0) {
+            return '  (none)';
+        }
+        return specs.map((s) => `  - ${s.id}: ${s.title} [${s.status}]`).join('\n');
+    };
+    return [
+        subject,
+        '='.repeat(subject.length),
+        '',
+        `Planu digest — last ${periodDays} day${periodDays === 1 ? '' : 's'}`,
+        `Generated: ${content.generatedAt.slice(0, 10)}`,
+        '',
+        'OVERVIEW',
+        `  Total specs:          ${stats.total}`,
+        `  Completed in period:  ${stats.completedInPeriod}`,
+        `  In progress:          ${stats.wipCount}`,
+        `  Blocked:              ${stats.blockedCount}`,
+        `  Upcoming (approved):  ${stats.upcomingCount}`,
+        '',
+        `COMPLETED (${completedSpecs.length})`,
+        specLines(completedSpecs),
+        '',
+        `IN PROGRESS (${wipSpecs.length})`,
+        specLines(wipSpecs),
+        '',
+        `BLOCKED (${blockedSpecs.length})`,
+        specLines(blockedSpecs),
+        '',
+        `UPCOMING (${upcomingSpecs.length})`,
+        specLines(upcomingSpecs),
+        '',
+        '-- Generated by Planu (https://planu.dev)',
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Build a DigestContent from the given list of specs and period (days).
+ * Only specs with updatedAt within the last `periodDays` days are considered
+ * "recent" for the completedInPeriod stat.
+ */
+export function generateDigestContent(specs, periodDays) {
+    const days = Math.max(1, periodDays);
+    const completedSpecs = specs
+        .filter((s) => s.status === 'done' && isWithinPeriod(s.updatedAt, days))
+        .map(toSummary);
+    const wipSpecs = specs
+        .filter((s) => s.status === 'implementing' || s.status === 'review')
+        .map(toSummary);
+    // Specs considered "blocked" are those with implementing/review status
+    // that have non-empty blockedBy dependencies
+    const blockedSpecs = specs
+        .filter((s) => Array.isArray(s.blockedBy) && s.blockedBy.length > 0)
+        .map(toSummary);
+    const upcomingSpecs = specs.filter((s) => s.status === 'approved').map(toSummary);
+    const stats = {
+        total: specs.length,
+        completedInPeriod: completedSpecs.length,
+        wipCount: wipSpecs.length,
+        blockedCount: blockedSpecs.length,
+        upcomingCount: upcomingSpecs.length,
+    };
+    const generatedAt = new Date().toISOString();
+    const subject = `Planu Digest — ${days === 1 ? 'Last 24h' : `Last ${days} days`}`;
+    const partial = {
+        subject,
+        stats,
+        completedSpecs,
+        wipSpecs,
+        blockedSpecs,
+        upcomingSpecs,
+        periodDays: days,
+        generatedAt,
+    };
+    return {
+        ...partial,
+        html: buildHtml(partial),
+        text: buildText(partial),
+    };
+}
+//# sourceMappingURL=email-digest-generator.js.map

package/dist/engine/email-digest-generator.js.map

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

package/dist/engine/email-sender.d.ts

@@ -0,0 +1,22 @@
+import type { DigestContent, EmailDigestConfig } from '../types/index.js';
+/**
+ * Save digest HTML to disk at data/projects/{hash}/digests/YYYY-MM-DD.html
+ * Returns the file path that was written.
+ */
+export declare function sendViaFile(content: DigestContent, projectHash: string): Promise<string>;
+/**
+ * Send digest via SendGrid transactional email API.
+ * Uses globalThis.fetch (Node 18+).
+ */
+export declare function sendViaSendGrid(content: DigestContent, config: EmailDigestConfig): Promise<void>;
+/**
+ * SMTP delivery is not implemented in this build.
+ * Node's built-in `net` module can open a raw TCP connection but does not
+ * handle TLS negotiation or SMTP AUTH without a third-party library, which
+ * is not permitted in this project.
+ *
+ * Use provider='file' to write digests locally, or provider='sendgrid' for
+ * transactional email.
+ */
+export declare function sendViaSmtp(_content: DigestContent, _config: EmailDigestConfig): Promise<void>;
+//# sourceMappingURL=email-sender.d.ts.map

package/dist/engine/email-sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-sender.d.ts","sourceRoot":"","sources":["../../src/engine/email-sender.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAM1E;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ9F;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAMD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9F"}

package/dist/engine/email-sender.js

@@ -0,0 +1,78 @@
+// engine/email-sender.ts — Email delivery adapters (SPEC-293)
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+// ---------------------------------------------------------------------------
+// File provider
+// ---------------------------------------------------------------------------
+/**
+ * Save digest HTML to disk at data/projects/{hash}/digests/YYYY-MM-DD.html
+ * Returns the file path that was written.
+ */
+export async function sendViaFile(content, projectHash) {
+    const dateSlug = content.generatedAt.slice(0, 10);
+    const filePath = join('data', 'projects', projectHash, 'digests', `${dateSlug}.html`);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, content.html, 'utf-8');
+    return filePath;
+}
+// ---------------------------------------------------------------------------
+// SendGrid provider
+// ---------------------------------------------------------------------------
+/**
+ * Send digest via SendGrid transactional email API.
+ * Uses globalThis.fetch (Node 18+).
+ */
+export async function sendViaSendGrid(content, config) {
+    const { apiKey, fromEmail = 'digest@planu.dev', fromName = 'Planu Digest' } = config.credentials;
+    if (!apiKey) {
+        throw new Error('SendGrid API key is not configured. ' +
+            'Run configure_email_digest with provider=sendgrid and credentials.apiKey.');
+    }
+    if (config.recipients.length === 0) {
+        throw new Error('No recipients configured. Add at least one recipient email address.');
+    }
+    const body = {
+        personalizations: [
+            {
+                to: config.recipients.map((email) => ({ email })),
+                subject: content.subject,
+            },
+        ],
+        from: { email: fromEmail, name: fromName },
+        content: [
+            { type: 'text/plain', value: content.text },
+            { type: 'text/html', value: content.html },
+        ],
+    };
+    const response = await globalThis.fetch('https://api.sendgrid.com/v3/mail/send', {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => '(no body)');
+        throw new Error(`SendGrid API returned ${response.status}: ${errorText}. ` +
+            'Check your API key and sender domain verification.');
+    }
+}
+// ---------------------------------------------------------------------------
+// SMTP provider (not implemented — requires external library)
+// ---------------------------------------------------------------------------
+/**
+ * SMTP delivery is not implemented in this build.
+ * Node's built-in `net` module can open a raw TCP connection but does not
+ * handle TLS negotiation or SMTP AUTH without a third-party library, which
+ * is not permitted in this project.
+ *
+ * Use provider='file' to write digests locally, or provider='sendgrid' for
+ * transactional email.
+ */
+export function sendViaSmtp(_content, _config) {
+    return Promise.reject(new Error('SMTP delivery is not supported without an external SMTP library. ' +
+        "Please use provider='sendgrid' for transactional email " +
+        "or provider='file' to save digests locally."));
+}
+//# sourceMappingURL=email-sender.js.map

package/dist/engine/email-sender.js.map

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

package/dist/engine/estimation-calibrator.d.ts

@@ -0,0 +1,19 @@
+import type { ActualRecord, EstimationAccuracyReport, CalibrationFactors, SpecScope, SpecType } from '../types/index.js';
+/**
+ * Compute deviation percentage: positive = over estimate, negative = under estimate.
+ * Returns 0 when estimatedHours is 0 to avoid division by zero.
+ */
+export declare function computeDeviationPct(estimatedHours: number, actualHours: number): number;
+export declare function generateAccuracyReport(projectId: string, records: ActualRecord[]): EstimationAccuracyReport;
+/**
+ * Compute calibration factors from historical actuals.
+ * Only creates a multiplier when sample size >= minSamples.
+ * A positive avg deviation means we historically underestimate → multiplier > 1.
+ */
+export declare function computeCalibrationFactors(projectId: string, records: ActualRecord[], minSamples: number): CalibrationFactors;
+/**
+ * Apply stored calibration factors to a base estimation hours value.
+ * Returns the adjusted hours (or the original if no factor found).
+ */
+export declare function applyCalibration(baseHours: number, scope: SpecScope, type: SpecType, factors: CalibrationFactors | null): number;
+//# sourceMappingURL=estimation-calibrator.d.ts.map

package/dist/engine/estimation-calibrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimation-calibrator.d.ts","sourceRoot":"","sources":["../../src/engine/estimation-calibrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,wBAAwB,EACxB,kBAAkB,EAIlB,SAAS,EACT,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAM3B;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAKvF;AA6ED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,wBAAwB,CAgC1B;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,EACvB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CA6CpB;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,kBAAkB,GAAG,IAAI,GACjC,MAAM,CAcR"}