@planu/cli 1.0.11 → 1.1.0

package/dist/engine/merge-risk-assessor/git-diff-parser.js

@@ -0,0 +1,48 @@
+// Planu — git diff parser for merge risk assessor
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Runs `git diff --stat {baseBranch}...{branch}` and parses the output.
+ * Uses execFile (not exec) to prevent shell injection.
+ */
+export async function getDiffStats(projectPath, branch, baseBranch) {
+    const { stdout } = await execFileAsync('git', ['diff', '--stat', `${baseBranch}...${branch}`], { cwd: projectPath });
+    return parseDiffStatOutput(stdout);
+}
+/**
+ * Parses the output of `git diff --stat` into structured stats.
+ * Example output:
+ *   src/foo.ts | 10 +++--
+ *   src/bar.ts |  4 +
+ *   2 files changed, 11 insertions(+), 4 deletions(-)
+ */
+export function parseDiffStatOutput(output) {
+    const lines = output.trim().split('\n').filter(Boolean);
+    if (lines.length === 0) {
+        return { filesChanged: 0, linesAdded: 0, linesRemoved: 0, files: [] };
+    }
+    const files = [];
+    for (const line of lines) {
+        // File lines contain a pipe character
+        if (line.includes('|')) {
+            const filePart = line.split('|')[0];
+            if (filePart !== undefined) {
+                const fileName = filePart.trim();
+                if (fileName) {
+                    files.push(fileName);
+                }
+            }
+        }
+    }
+    // Summary line: "N files changed, X insertions(+), Y deletions(-)"
+    const summaryLine = lines[lines.length - 1] ?? '';
+    const filesMatch = /(\d+) files? changed/.exec(summaryLine);
+    const insertionsMatch = /(\d+) insertions?/.exec(summaryLine);
+    const deletionsMatch = /(\d+) deletions?/.exec(summaryLine);
+    const filesChanged = filesMatch?.[1] ? parseInt(filesMatch[1], 10) : files.length;
+    const linesAdded = insertionsMatch?.[1] ? parseInt(insertionsMatch[1], 10) : 0;
+    const linesRemoved = deletionsMatch?.[1] ? parseInt(deletionsMatch[1], 10) : 0;
+    return { filesChanged, linesAdded, linesRemoved, files };
+}
+//# sourceMappingURL=git-diff-parser.js.map

package/dist/engine/merge-risk-assessor/git-diff-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff-parser.js","sourceRoot":"","sources":["../../../src/engine/merge-risk-assessor/git-diff-parser.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAKtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,MAAc,EACd,UAAkB;IAElB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,KAAK,EACL,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,MAAM,MAAM,EAAE,CAAC,EAC/C,EAAE,GAAG,EAAE,WAAW,EAAE,CACrB,CAAC;IAEF,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAExD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACxE,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,sCAAsC;QACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACjC,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,eAAe,GAAG,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IAClF,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AAC3D,CAAC"}

package/dist/engine/merge-risk-assessor/index.d.ts

@@ -0,0 +1,7 @@
+import type { MergeRiskResult, AssessMergeRiskOptions } from '../../types/index.js';
+/**
+ * Main orchestrator: runs all analyzers, computes weighted risk score,
+ * and returns a structured MergeRiskResult.
+ */
+export declare function assessMergeRisk(projectPath: string, options: AssessMergeRiskOptions): Promise<MergeRiskResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/merge-risk-assessor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/merge-risk-assessor/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAyDnG;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAyE1B"}

package/dist/engine/merge-risk-assessor/index.js

@@ -0,0 +1,98 @@
+import { getDiffStats } from './git-diff-parser.js';
+import { analyzeSecuritySurface, analyzeCoverageDelta, analyzeBlastRadius, analyzeReversibility, analyzeSpecCompliance, } from './analyzers.js';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+async function getCurrentBranch(projectPath) {
+    const { stdout } = await execFileAsync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+        cwd: projectPath,
+    });
+    return stdout.trim();
+}
+async function getDiff(projectPath, branch, baseBranch) {
+    const { stdout } = await execFileAsync('git', ['diff', `${baseBranch}...${branch}`], { cwd: projectPath });
+    return stdout;
+}
+function buildRecommendation(score) {
+    if (score <= 30) {
+        return 'auto-merge';
+    }
+    if (score <= 70) {
+        return 'human-review';
+    }
+    return 'block';
+}
+function buildHumanSummary(score, recommendation, topReason) {
+    const recommendationLabel = recommendation === 'auto-merge'
+        ? 'Safe to auto-merge'
+        : recommendation === 'human-review'
+            ? 'Human review required'
+            : 'Blocked — high risk';
+    return `Risk score ${score}/100 — ${recommendationLabel}. ${topReason}`;
+}
+/**
+ * Main orchestrator: runs all analyzers, computes weighted risk score,
+ * and returns a structured MergeRiskResult.
+ */
+export async function assessMergeRisk(projectPath, options) {
+    const baseBranch = options.baseBranch ?? 'main';
+    const branch = options.branch ?? (await getCurrentBranch(projectPath));
+    const [diffStats, diff] = await Promise.all([
+        getDiffStats(projectPath, branch, baseBranch),
+        getDiff(projectPath, branch, baseBranch),
+    ]);
+    const { filesChanged, linesAdded, linesRemoved, files } = diffStats;
+    const securityResult = analyzeSecuritySurface(files, diff);
+    const coverageResult = analyzeCoverageDelta(linesAdded, files);
+    const blastResult = analyzeBlastRadius(filesChanged, files);
+    const reversibilityResult = analyzeReversibility(files, diff);
+    const complianceResult = analyzeSpecCompliance(files, options.context);
+    const breakdown = [
+        {
+            category: 'Security Surface',
+            score: securityResult.score,
+            weight: 0.3,
+            reason: securityResult.reason,
+        },
+        {
+            category: 'Coverage Delta',
+            score: coverageResult.score,
+            weight: 0.25,
+            reason: coverageResult.reason,
+        },
+        {
+            category: 'Blast Radius',
+            score: blastResult.score,
+            weight: 0.2,
+            reason: blastResult.reason,
+        },
+        {
+            category: 'Reversibility',
+            score: reversibilityResult.score,
+            weight: 0.15,
+            reason: reversibilityResult.reason,
+        },
+        {
+            category: 'Spec Compliance',
+            score: complianceResult.score,
+            weight: 0.1,
+            reason: complianceResult.reason,
+        },
+    ];
+    const riskScore = Math.round(breakdown.reduce((acc, b) => acc + b.score * b.weight, 0));
+    const recommendation = buildRecommendation(riskScore);
+    // Top reason = highest weighted contribution
+    const topBreakdown = [...breakdown].sort((a, b) => b.score * b.weight - a.score * a.weight)[0];
+    const topReason = topBreakdown?.reason ?? 'No significant risk factors';
+    const humanSummary = buildHumanSummary(riskScore, recommendation, topReason);
+    return {
+        riskScore,
+        recommendation,
+        breakdown,
+        filesChanged,
+        linesAdded,
+        linesRemoved,
+        humanSummary,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/merge-risk-assessor/index.js.map

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

package/dist/engine/spec-prompt-generator.d.ts

@@ -0,0 +1,12 @@
+import type { SpecPromptDefinition, SpecPromptInput } from '../types/index.js';
+/**
+ * Builds the prompt name from spec id and slug, truncated to MAX_NAME_LENGTH.
+ * Format: `planu:{id}-{slug}` (e.g. `planu:SPEC-342-export-pdf`)
+ */
+export declare function buildPromptName(id: string, slug: string): string;
+/**
+ * Generates a SpecPromptDefinition from a Planu spec.
+ * The resulting definition can be registered as an MCP prompt via server.prompt().
+ */
+export declare function generatePromptFromSpec(spec: SpecPromptInput): SpecPromptDefinition;
+//# sourceMappingURL=spec-prompt-generator.d.ts.map

package/dist/engine/spec-prompt-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-prompt-generator.d.ts","sourceRoot":"","sources":["../../src/engine/spec-prompt-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA8B/E;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhE;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAgClF"}

package/dist/engine/spec-prompt-generator.js

@@ -0,0 +1,69 @@
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_NAME_LENGTH = 64;
+const CONTEXT_ARGUMENT = {
+    name: 'context',
+    description: 'Additional context for this spec execution',
+    required: false,
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Sanitizes a string into a valid MCP prompt name segment.
+ * Lowercases, replaces non-alphanumeric chars with hyphens,
+ * collapses repeated hyphens, and strips leading/trailing hyphens.
+ */
+function sanitizeSegment(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * Builds the prompt name from spec id and slug, truncated to MAX_NAME_LENGTH.
+ * Format: `planu:{id}-{slug}` (e.g. `planu:SPEC-342-export-pdf`)
+ */
+export function buildPromptName(id, slug) {
+    const idPart = sanitizeSegment(id);
+    const slugPart = sanitizeSegment(slug);
+    const full = `planu:${idPart}-${slugPart}`;
+    return full.slice(0, MAX_NAME_LENGTH);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generates a SpecPromptDefinition from a Planu spec.
+ * The resulting definition can be registered as an MCP prompt via server.prompt().
+ */
+export function generatePromptFromSpec(spec) {
+    const name = buildPromptName(spec.id, spec.slug);
+    const firstCriterion = spec.criteria?.[0];
+    const descriptionHint = firstCriterion !== undefined ? ` | ${firstCriterion}` : '';
+    const description = `${spec.title}${descriptionHint}`;
+    const criteriaLines = spec.criteria !== undefined && spec.criteria.length > 0
+        ? spec.criteria.map((c, i) => `${i + 1}. ${c}`).join('\n')
+        : 'No acceptance criteria defined.';
+    const summarySection = spec.summary !== undefined ? `\n\nSummary: ${spec.summary}` : '';
+    const template = [
+        `You are implementing spec ${spec.id}: ${spec.title}.`,
+        summarySection,
+        '',
+        'Acceptance criteria:',
+        criteriaLines,
+        '',
+        'Follow each criterion exactly. When done, run validate to confirm compliance.',
+    ]
+        .join('\n')
+        .trim();
+    return {
+        name,
+        description,
+        arguments: [{ ...CONTEXT_ARGUMENT }],
+        template,
+    };
+}
+//# sourceMappingURL=spec-prompt-generator.js.map

package/dist/engine/spec-prompt-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-prompt-generator.js","sourceRoot":"","sources":["../../src/engine/spec-prompt-generator.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,4CAA4C;IACzD,QAAQ,EAAE,KAAK;CACP,CAAC;AAEX,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;GAIG;AACH,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,IAAY;IACtD,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,SAAS,MAAM,IAAI,QAAQ,EAAE,CAAC;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAqB;IAC1D,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjD,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,eAAe,GAAG,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,KAAK,GAAG,eAAe,EAAE,CAAC;IAEtD,MAAM,aAAa,GACjB,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACrD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1D,CAAC,CAAC,iCAAiC,CAAC;IAExC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAExF,MAAM,QAAQ,GAAG;QACf,6BAA6B,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,GAAG;QACtD,cAAc;QACd,EAAE;QACF,sBAAsB;QACtB,aAAa;QACb,EAAE;QACF,+EAA+E;KAChF;SACE,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;IAEV,OAAO;QACL,IAAI;QACJ,WAAW;QACX,SAAS,EAAE,CAAC,EAAE,GAAG,gBAAgB,EAAE,CAAC;QACpC,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/engine/telemetry/health-checker.d.ts

@@ -0,0 +1,5 @@
+import type { TelemetryHealthResult } from '../../types/index.js';
+export declare function checkTelemetryHealth(projectPath: string, options?: {
+    sendTestEvent?: boolean;
+}): Promise<TelemetryHealthResult>;
+//# sourceMappingURL=health-checker.d.ts.map

package/dist/engine/telemetry/health-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-checker.d.ts","sourceRoot":"","sources":["../../../src/engine/telemetry/health-checker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AA2SlF,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,OAAO,CAAC,qBAAqB,CAAC,CAkDhC"}

package/dist/engine/telemetry/health-checker.js

@@ -0,0 +1,297 @@
+// engine/telemetry/health-checker.ts — SPEC-346: Diagnose why telemetry data is not reaching the dashboard.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readTelemetryConfig } from './telemetry-store.js';
+import { sendTelemetryEvent } from './telemetry-client.js';
+const NETWORK_TIMEOUT_MS = 5_000;
+const RECENT_EVENT_THRESHOLD_DAYS = 7;
+// ---------------------------------------------------------------------------
+// Individual checks
+// ---------------------------------------------------------------------------
+async function checkConfigEnabled() {
+    const config = await readTelemetryConfig();
+    if (!config?.enabled) {
+        return {
+            check: {
+                name: 'config-enabled',
+                status: 'fail',
+                detail: 'Telemetry is disabled in ~/.planu/telemetry.json',
+            },
+            enabled: false,
+        };
+    }
+    return {
+        check: {
+            name: 'config-enabled',
+            status: 'ok',
+            detail: 'Telemetry is enabled',
+        },
+        enabled: true,
+    };
+}
+function checkEndpointConfigured(endpoint) {
+    if (!endpoint || endpoint.trim() === '') {
+        return {
+            name: 'endpoint-configured',
+            status: 'fail',
+            detail: 'No telemetry endpoint configured. Set PLANU_TELEMETRY_ENDPOINT env var.',
+        };
+    }
+    return {
+        name: 'endpoint-configured',
+        status: 'ok',
+        detail: `Endpoint: ${endpoint}`,
+    };
+}
+async function checkNetworkReachable(endpoint) {
+    if (!endpoint) {
+        return {
+            name: 'network-reachable',
+            status: 'skip',
+            detail: 'Skipped — no endpoint to test',
+        };
+    }
+    try {
+        const response = await fetch(endpoint, {
+            method: 'GET',
+            signal: AbortSignal.timeout(NETWORK_TIMEOUT_MS),
+        });
+        if (response.ok || response.status < 500) {
+            return {
+                name: 'network-reachable',
+                status: 'ok',
+                detail: `Endpoint responded with HTTP ${response.status}`,
+            };
+        }
+        return {
+            name: 'network-reachable',
+            status: 'warn',
+            detail: `Endpoint returned HTTP ${response.status} — server may be experiencing issues`,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'network-reachable',
+            status: 'warn',
+            detail: `Could not reach endpoint: ${message}`,
+        };
+    }
+}
+async function checkLastEvent(projectPath) {
+    const candidates = [
+        join(projectPath, 'data', 'telemetry-events.json'),
+        join(projectPath, '.planu', 'telemetry-events.json'),
+        join(projectPath, 'data', 'telemetry.json'),
+    ];
+    for (const candidate of candidates) {
+        try {
+            const raw = await readFile(candidate, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed) || parsed.length === 0) {
+                continue;
+            }
+            const last = parsed[parsed.length - 1];
+            const ts = typeof last.timestamp === 'string' ? last.timestamp : undefined;
+            if (!ts) {
+                return {
+                    name: 'last-event',
+                    status: 'warn',
+                    detail: `Found event log at ${candidate} but last event has no timestamp`,
+                };
+            }
+            const daysAgo = (Date.now() - new Date(ts).getTime()) / (1000 * 60 * 60 * 24);
+            if (daysAgo > RECENT_EVENT_THRESHOLD_DAYS) {
+                return {
+                    name: 'last-event',
+                    status: 'warn',
+                    detail: `Last event was ${Math.floor(daysAgo)} days ago (${ts})`,
+                };
+            }
+            return {
+                name: 'last-event',
+                status: 'ok',
+                detail: `Last event: ${ts} (${Math.floor(daysAgo)} days ago)`,
+            };
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return {
+        name: 'last-event',
+        status: 'warn',
+        detail: 'No event log found — no events have been sent yet',
+    };
+}
+async function checkErrorLog(projectPath) {
+    const candidates = [
+        join(projectPath, 'data', 'telemetry-errors.json'),
+        join(projectPath, '.planu', 'telemetry-errors.json'),
+    ];
+    for (const candidate of candidates) {
+        try {
+            const raw = await readFile(candidate, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed)) {
+                continue;
+            }
+            const recent = parsed.slice(-5);
+            if (recent.length === 0) {
+                return {
+                    name: 'error-log',
+                    status: 'ok',
+                    detail: 'No telemetry errors recorded',
+                };
+            }
+            const summary = recent
+                .map((e) => {
+                if (typeof e.message === 'string') {
+                    return e.message;
+                }
+                if (typeof e.error === 'string') {
+                    return e.error;
+                }
+                return '[unknown error]';
+            })
+                .join('; ');
+            return {
+                name: 'error-log',
+                status: 'warn',
+                detail: `${recent.length} recent error(s): ${summary}`,
+            };
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return {
+        name: 'error-log',
+        status: 'ok',
+        detail: 'No error log found',
+    };
+}
+async function checkClientVersion(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    try {
+        const raw = await readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        const version = typeof pkg.version === 'string' ? pkg.version : 'unknown';
+        const name = typeof pkg.name === 'string' ? pkg.name : 'unknown';
+        return {
+            name: 'version',
+            status: 'ok',
+            detail: `Client: ${name}@${version}`,
+        };
+    }
+    catch {
+        return {
+            name: 'version',
+            status: 'warn',
+            detail: `Could not read package.json at ${pkgPath}`,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Test event
+// ---------------------------------------------------------------------------
+function sendTestDiagnosticEvent(installationId) {
+    sendTelemetryEvent({
+        event: 'tool_used',
+        properties: {
+            tool: 'telemetry_health',
+            diagnostic: true,
+            timestamp: new Date().toISOString(),
+        },
+        installationId,
+    });
+}
+// ---------------------------------------------------------------------------
+// Status helpers
+// ---------------------------------------------------------------------------
+function buildRecommendation(status) {
+    switch (status) {
+        case 'disabled':
+            return 'Run configure_telemetry to enable usage tracking';
+        case 'misconfigured':
+            return 'Set PLANU_TELEMETRY_ENDPOINT or run configure_telemetry';
+        case 'degraded':
+            return 'Check network connectivity or firewall rules blocking outbound requests';
+        case 'healthy':
+            return 'Telemetry is working. If no data shows in dashboard, check the dashboard filters.';
+    }
+}
+function buildHumanSummary(status, checks) {
+    const warnCount = checks.filter((c) => c.status === 'warn').length;
+    switch (status) {
+        case 'disabled':
+            return 'Telemetry is turned off — no usage data is being collected.';
+        case 'misconfigured':
+            return 'Telemetry cannot send data: configuration issue needs fixing.';
+        case 'degraded':
+            return `Telemetry is configured but ${warnCount} issue(s) may be preventing data from reaching the dashboard.`;
+        case 'healthy':
+            return 'Telemetry appears healthy. Data should be reaching the dashboard.';
+    }
+}
+function computeStatus(isEnabled, checks) {
+    if (!isEnabled) {
+        return 'disabled';
+    }
+    const endpointCheck = checks.find((c) => c.name === 'endpoint-configured');
+    if (endpointCheck?.status === 'fail') {
+        return 'misconfigured';
+    }
+    const hasWarn = checks.some((c) => c.status === 'warn');
+    if (hasWarn) {
+        return 'degraded';
+    }
+    return 'healthy';
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function checkTelemetryHealth(projectPath, options) {
+    const { check: enabledCheck, enabled } = await checkConfigEnabled();
+    if (!enabled) {
+        const checks = [enabledCheck];
+        const status = 'disabled';
+        return {
+            status,
+            checks,
+            recommendation: buildRecommendation(status),
+            humanSummary: buildHumanSummary(status, checks),
+        };
+    }
+    // Default endpoint from telemetry-client
+    const defaultEndpoint = 'https://canusqigtzldstnjddio.supabase.co/rest/v1/telemetry_events';
+    const endpoint = process.env.PLANU_TELEMETRY_ENDPOINT?.trim() ?? defaultEndpoint;
+    const [networkCheck, lastEventCheck, errorLogCheck, versionCheck] = await Promise.all([
+        checkNetworkReachable(endpoint),
+        checkLastEvent(projectPath),
+        checkErrorLog(projectPath),
+        checkClientVersion(projectPath),
+    ]);
+    const endpointCheck = checkEndpointConfigured(endpoint);
+    const checks = [
+        enabledCheck,
+        endpointCheck,
+        networkCheck,
+        lastEventCheck,
+        errorLogCheck,
+        versionCheck,
+    ];
+    const status = computeStatus(enabled, checks);
+    if (options?.sendTestEvent === true) {
+        const config = await readTelemetryConfig();
+        const installationId = config?.installationId ?? 'anonymous';
+        sendTestDiagnosticEvent(installationId);
+    }
+    return {
+        status,
+        checks,
+        recommendation: buildRecommendation(status),
+        humanSummary: buildHumanSummary(status, checks),
+    };
+}
+//# sourceMappingURL=health-checker.js.map

package/dist/engine/telemetry/health-checker.js.map

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

package/dist/engine/telemetry/index.d.ts

@@ -1,3 +1,4 @@
 export * from './telemetry-store.js';
 export * from './telemetry-client.js';
+export * from './health-checker.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/telemetry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/telemetry/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/telemetry/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}

package/dist/engine/telemetry/index.js

@@ -1,4 +1,5 @@
 // engine/telemetry/index.ts — SPEC-200: Barrel export for telemetry engine
 export * from './telemetry-store.js';
 export * from './telemetry-client.js';
+export * from './health-checker.js';
 //# sourceMappingURL=index.js.map

package/dist/engine/telemetry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/telemetry/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/telemetry/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -156,6 +156,10 @@ import { registerFilesystemHooksTools } from './tools/register-filesystem-hooks-
 import { registerSkillsEvalTools } from './tools/register-skills-eval-tools.js';
 import { registerTrialTools } from './tools/register-trial-tools.js';
 import { registerDepAuditTools } from './tools/register-dep-audit-tools.js';
+import { registerSpecPromptTools } from './tools/register-spec-prompt-tools.js';
+import { registerTelemetryHealthTools } from './tools/register-telemetry-health-tools.js';
+import { registerMergeRiskTools } from './tools/register-merge-risk-tools.js';
+import { registerDomainBundleTools } from './tools/register-domain-bundle-tools.js';
 // Server setup
 const SERVER_INSTRUCTIONS = [
     'CONTEXT — Why structured specs matter:',
@@ -377,11 +381,18 @@ function registerExtendedTools(s) {
     registerSpec323Tools(s);
     registerProductInsightsTools(s);
     registerSpec331Tools(s);
+    registerLatestSpecTools(s);
+    registerPrompts(s);
+}
+function registerLatestSpecTools(s) {
     registerFilesystemHooksTools(s);
     registerSkillsEvalTools(s);
     registerTrialTools(s);
     registerDepAuditTools(s);
-    registerPrompts(s);
+    registerSpecPromptTools(s);
+    registerTelemetryHealthTools(s);
+    registerMergeRiskTools(s);
+    registerDomainBundleTools(s);
 }
 function createMcpServer() {
     const s = withToolTracking(new McpServer({ name: 'planu', version: PLANU_VERSION }, { instructions: SERVER_INSTRUCTIONS }));