@planu/cli 4.14.1 → 5.1.1

package/dist/tools/webhook.js

@@ -1,150 +0,0 @@
-// tools/webhook.ts — Handlers for webhook management MCP tools.
-// start_webhook, stop_webhook, webhook_status
-import { startWebhookServer, stopWebhookServer, getWebhookState, setWebhookSecret, } from '../engine/webhook/index.js';
-// ---------------------------------------------------------------------------
-// Tool handlers
-// ---------------------------------------------------------------------------
-export async function handleStartWebhook(args) {
-    const port = args.port ?? 2358;
-    const secret = args.secret ?? '';
-    if (port < 1 || port > 65535) {
-        return {
-            content: [{ type: 'text', text: 'Error: port must be between 1 and 65535.' }],
-            isError: true,
-        };
-    }
-    const current = getWebhookState();
-    if (current.running) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: [
-                        'Webhook server is already running.',
-                        `Port: ${String(current.port)}`,
-                        `Started: ${current.startedAt ?? 'unknown'}`,
-                        '',
-                        'Use stop_webhook first to restart on a different port.',
-                    ].join('\n'),
-                },
-            ],
-        };
-    }
-    if (secret) {
-        setWebhookSecret(secret);
-    }
-    try {
-        const state = await startWebhookServer(port);
-        const secretMsg = secret
-            ? 'HMAC-SHA256 signature validation enabled.'
-            : 'Warning: no webhook secret set — all requests will be accepted.';
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: [
-                        'Webhook server started.',
-                        `URL: http://localhost:${String(state.port)}/`,
-                        `Port: ${String(state.port)}`,
-                        `Started: ${state.startedAt ?? 'unknown'}`,
-                        '',
-                        secretMsg,
-                        '',
-                        'Configure this URL in your Lemon Squeezy dashboard under:',
-                        '  Settings > Webhooks > Add webhook',
-                        '',
-                        'Supported events:',
-                        '  • subscription_cancelled',
-                        '  • subscription_updated',
-                        '  • license_key_created',
-                    ].join('\n'),
-                },
-            ],
-        };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: [
-                        `Failed to start webhook server: ${message}`,
-                        '',
-                        'Common causes:',
-                        `• Port ${String(port)} is already in use — try a different port`,
-                        '• Insufficient permissions for ports below 1024',
-                    ].join('\n'),
-                },
-            ],
-            isError: true,
-        };
-    }
-}
-export async function handleStopWebhook(_args) {
-    const current = getWebhookState();
-    if (!current.running) {
-        return {
-            content: [{ type: 'text', text: 'Webhook server is not running.' }],
-        };
-    }
-    // force flag reserved for future use (e.g., drop active connections)
-    try {
-        await stopWebhookServer();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: [
-                        'Webhook server stopped.',
-                        `Events processed during session: ${String(current.eventsProcessed)}`,
-                    ].join('\n'),
-                },
-            ],
-        };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return {
-            content: [{ type: 'text', text: `Failed to stop webhook server: ${message}` }],
-            isError: true,
-        };
-    }
-}
-export function handleWebhookStatus(args) {
-    const state = getWebhookState();
-    const includeEvents = args.includeEvents ?? true;
-    const lines = [
-        `Status: ${state.running ? 'RUNNING' : 'STOPPED'}`,
-        `Port: ${String(state.port)}`,
-        `Started: ${state.startedAt ?? 'N/A'}`,
-        `Events processed: ${String(state.eventsProcessed)}`,
-    ];
-    if (includeEvents && state.recentEvents.length > 0) {
-        lines.push('', 'Recent events:');
-        for (const event of state.recentEvents) {
-            const status = event.processed ? 'OK' : 'FAIL';
-            lines.push(`  [${status}] ${event.receivedAt} | ${event.eventType} | ${event.summary}`);
-        }
-    }
-    else if (includeEvents) {
-        lines.push('', 'No events received yet.');
-    }
-    if (!state.running) {
-        lines.push('', 'Use start_webhook to begin receiving Lemon Squeezy events.');
-    }
-    return {
-        content: [{ type: 'text', text: lines.join('\n') }],
-    };
-}
-// ---------------------------------------------------------------------------
-// Internal helper (exported for testing)
-// ---------------------------------------------------------------------------
-export function formatStateForDisplay(state) {
-    return [
-        `running=${String(state.running)}`,
-        `port=${String(state.port)}`,
-        `eventsProcessed=${String(state.eventsProcessed)}`,
-    ].join(', ');
-}
-//# sourceMappingURL=webhook.js.map

package/dist/types/changelog.d.ts

@@ -1,49 +0,0 @@
-export type ChangelogEntryType = 'criteria_added' | 'criteria_removed' | 'status_changed' | 'scope_changed' | 'progress_updated' | 'reconciled';
-export interface CriteriaDiff {
-    added: string[];
-    removed: string[];
-    modified: {
-        before: string;
-        after: string;
-    }[];
-}
-export interface SpecSnapshot {
-    criteriaCount: number;
-    completedCount: number;
-    status: string;
-}
-export interface SpecChangelogEntry {
-    timestamp: string;
-    type: ChangelogEntryType;
-    description: string;
-    triggeredBy: string;
-    before?: SpecSnapshot;
-    after?: SpecSnapshot;
-    diff?: CriteriaDiff;
-}
-export interface SpecChangelogData {
-    specId: string;
-    entries: SpecChangelogEntry[];
-}
-export interface AppendChangelogOptions {
-    specDir: string;
-    specId: string;
-    entry: SpecChangelogEntry;
-}
-export interface ReadChangelogOptions {
-    specDir: string;
-    specId: string;
-}
-export interface SpecHistoryInput {
-    specId: string;
-    specDir: string;
-    filter?: string;
-}
-export interface SpecHistoryResult {
-    specId: string;
-    entries: SpecChangelogEntry[];
-    totalEntries: number;
-    filtered: boolean;
-    message: string;
-}
-//# sourceMappingURL=changelog.d.ts.map

package/dist/types/changelog.js

@@ -1,3 +0,0 @@
-// types/changelog.ts — Changelog and spec diff types for SPEC-067
-export {};
-//# sourceMappingURL=changelog.js.map

package/dist/types/licensing.d.ts

@@ -1,109 +0,0 @@
-import type { PricingTier } from './common/primitives.js';
-export interface LicenseState {
-    /** License key from Lemon Squeezy */
-    readonly licenseKey: string;
-    /** Unique instance identifier for this activation */
-    readonly instanceId: string;
-    /** Resolved tier from the license variant */
-    readonly tier: PricingTier;
-    /** ISO 8601 timestamp of when the license was activated locally */
-    readonly activatedAt: string;
-    /** ISO 8601 timestamp of the last successful remote validation */
-    readonly lastValidatedAt: string;
-    /** Lemon Squeezy variant name (e.g. "Planu Pro Monthly") */
-    readonly variantName: string;
-    /** Customer name from Lemon Squeezy */
-    readonly customerName: string;
-    /** Customer email from Lemon Squeezy */
-    readonly customerEmail: string;
-    /** SHA-256 fingerprint of the machine that activated this license */
-    readonly machineFingerprint: string;
-    /** Maximum number of activations allowed by Lemon Squeezy */
-    readonly activationLimit: number;
-    /** Current number of activations used */
-    readonly activationUsage: number;
-}
-export interface TierLimits {
-    readonly maxProjects: number;
-    readonly maxActiveSpecs: number;
-}
-export interface LicensePlanConfig {
-    readonly tiers: Record<PricingTier, TierLimits>;
-    readonly freeTools: readonly string[];
-    readonly proTools: readonly string[];
-    readonly alwaysAllowed: readonly string[];
-    readonly upgradeUrl: string;
-    /**
-     * ISO date string (YYYY-MM-DD). Until this date all PRO tools are accessible
-     * to free-tier users — promotional "open access" window.
-     */
-    readonly freeUntil?: string;
-}
-export interface LicenseCheckResult {
-    readonly allowed: boolean;
-    readonly currentTier: PricingTier;
-    readonly requiredTier: PricingTier;
-    readonly message: string;
-}
-export interface LemonSqueezyMeta {
-    readonly store_id: number;
-    readonly order_id: number;
-    readonly order_item_id: number;
-    readonly product_id: number;
-    readonly product_name: string;
-    readonly variant_id: number;
-    readonly variant_name: string;
-    readonly customer_id: number;
-    readonly customer_name: string;
-    readonly customer_email: string;
-}
-export interface LemonSqueezyInstance {
-    readonly id: string;
-    readonly name: string;
-    readonly created_at: string;
-}
-export interface LemonSqueezyActivateResponse {
-    readonly activated: boolean;
-    readonly error: string | null;
-    readonly license_key: {
-        readonly id: number;
-        readonly status: string;
-        readonly key: string;
-        readonly activation_limit: number;
-        readonly activation_usage: number;
-        readonly created_at: string;
-        readonly expires_at: string | null;
-    };
-    readonly instance: LemonSqueezyInstance;
-    readonly meta: LemonSqueezyMeta;
-}
-export interface LemonSqueezyValidateResponse {
-    readonly valid: boolean;
-    readonly error: string | null;
-    readonly license_key: {
-        readonly id: number;
-        readonly status: string;
-        readonly key: string;
-        readonly activation_limit: number;
-        readonly activation_usage: number;
-        readonly created_at: string;
-        readonly expires_at: string | null;
-    };
-    readonly instance: LemonSqueezyInstance;
-    readonly meta: LemonSqueezyMeta;
-}
-export interface LemonSqueezyDeactivateResponse {
-    readonly deactivated: boolean;
-    readonly error: string | null;
-}
-export interface ActivateLicenseInput {
-    readonly licenseKey: string;
-    readonly instanceName?: string;
-}
-export interface DeactivateLicenseInput {
-    readonly confirm: boolean;
-}
-export interface LicenseStatusInput {
-    readonly projectId?: string;
-}
-//# sourceMappingURL=licensing.d.ts.map

package/dist/types/licensing.js

@@ -1,4 +0,0 @@
-// types/licensing.ts — License management types for Planu SDD MCP Server.
-// Supports offline-first licensing via Lemon Squeezy as Merchant of Record.
-export {};
-//# sourceMappingURL=licensing.js.map

package/dist/types/product-intelligence.d.ts

@@ -1,60 +0,0 @@
-export interface ToolAdoptionRow {
-    tool: string;
-    totalCalls: number;
-    uniqueInstalls: number;
-    errorRate: number;
-    blockedRate: number;
-    lastSeenAt: string;
-    trend: 'rising' | 'stable' | 'falling' | 'new' | 'dead';
-}
-export interface WorkflowCompletionRow {
-    installationId: string;
-    hasCreateSpec: boolean;
-    hasValidate: boolean;
-    hasDone: boolean;
-    completionRate: number;
-}
-export interface FrictionPointRow {
-    tool: string;
-    blockedCount: number;
-    totalCalls: number;
-    blockedRate: number;
-    topMessage: string | null;
-}
-export interface VersionAdoptionRow {
-    planVersion: string;
-    userCount: number;
-    pct: number;
-    isLatest: boolean;
-}
-export interface ProductInsightsReport {
-    generatedAt: string;
-    periodDays: number;
-    totalEvents: number;
-    uniqueInstalls: number;
-    adoption: ToolAdoptionRow[];
-    frictionPoints: FrictionPointRow[];
-    versionAdoption: VersionAdoptionRow[];
-    deadTools: string[];
-    summary: string;
-}
-export type ProductInsightsReport_Report = 'adoption' | 'friction' | 'versions' | 'dead_tools' | 'full';
-export interface TelemetryEventRow {
-    event_name: string;
-    properties: Record<string, unknown>;
-    installation_id: string;
-    created_at: string;
-}
-export interface AdoptionStats {
-    total: number;
-    installs: Set<string>;
-    errors: number;
-    blocked: number;
-    lastSeen: string;
-}
-export interface FrictionStats {
-    blocked: number;
-    total: number;
-    messages: string[];
-}
-//# sourceMappingURL=product-intelligence.d.ts.map

package/dist/types/product-intelligence.js

@@ -1,3 +0,0 @@
-// types/product-intelligence.ts — SPEC-328: Product Intelligence Layer types
-export {};
-//# sourceMappingURL=product-intelligence.js.map

package/dist/types/session.d.ts

@@ -1,84 +0,0 @@
-/** A spec that was active during a session. */
-export interface SessionActiveSpec {
-    specId: string;
-    status: string;
-    summary: string;
-}
-/** A decision made during a session. */
-export interface SessionDecision {
-    timestamp: string;
-    decision: string;
-    rationale: string;
-    specId?: string;
-}
-/** A file touched during a session. */
-export interface SessionFile {
-    path: string;
-    action: 'created' | 'modified' | 'deleted';
-}
-/** A persisted session snapshot. */
-export interface Session {
-    id: string;
-    projectId: string;
-    startedAt: string;
-    lastSavedAt: string;
-    activeSpecs: SessionActiveSpec[];
-    decisions: SessionDecision[];
-    modifiedFiles: SessionFile[];
-    contextSummary: string;
-    toolCallCount: number;
-    metadata: Record<string, unknown>;
-}
-/** Diff between two sessions. */
-export interface SessionDiff {
-    newSpecs: SessionActiveSpec[];
-    completedSpecs: SessionActiveSpec[];
-    newDecisions: SessionDecision[];
-    fileChanges: SessionFile[];
-}
-/** Cross-conversation memory of decisions. */
-export interface SessionMemory {
-    projectId: string;
-    decisions: SessionDecision[];
-    updatedAt: string;
-}
-/** Lightweight session info for list views. */
-export interface SessionListItem {
-    id: string;
-    startedAt: string;
-    lastSavedAt: string;
-    contextSummary: string;
-    toolCallCount: number;
-}
-/** Input for restore_session tool. */
-export interface RestoreSessionInput {
-    projectPath: string;
-    sessionId?: string;
-    /** PR number to resume session from (auto-linked when PR created inside Claude Code). */
-    fromPr?: number;
-}
-/** Input for list_sessions tool. */
-export interface ListSessionsInput {
-    projectPath: string;
-    limit?: number;
-}
-/** Input for export_session tool. */
-export interface ExportSessionInput {
-    projectPath: string;
-    sessionId?: string;
-    format?: 'markdown' | 'json';
-}
-/** Data shape for the formatAsMarkdown function parameter. */
-export interface SessionExportData {
-    id: string;
-    projectId: string;
-    startedAt: string;
-    lastSavedAt: string;
-    contextSummary: string;
-    activeSpecs: SessionActiveSpec[];
-    decisions: SessionDecision[];
-    modifiedFiles: SessionFile[];
-    toolCallCount: number;
-    metadata: Record<string, unknown>;
-}
-//# sourceMappingURL=session.d.ts.map

package/dist/types/session.js

@@ -1,3 +0,0 @@
-// session.ts — Types for session persistence (SPEC-081)
-export {};
-//# sourceMappingURL=session.js.map

package/dist/types/webhook.d.ts

@@ -1,62 +0,0 @@
-export type WebhookEventType = 'subscription_cancelled' | 'subscription_updated' | 'license_key_created' | 'order_created' | 'subscription_created' | 'subscription_paused' | 'subscription_unpaused' | 'subscription_expired' | 'subscription_payment_success' | 'subscription_payment_failed' | 'subscription_payment_recovered';
-export interface LemonSqueezyWebhookAttributes {
-    readonly status?: string;
-    readonly cancelled?: boolean;
-    readonly variant_id?: number;
-    readonly variant_name?: string;
-    readonly product_name?: string;
-    readonly customer_id?: number;
-    readonly user_name?: string;
-    readonly user_email?: string;
-    readonly ends_at?: string | null;
-    readonly renews_at?: string | null;
-    readonly trial_ends_at?: string | null;
-    readonly created_at?: string;
-    readonly updated_at?: string;
-}
-export interface LemonSqueezyWebhookData {
-    readonly id: string;
-    readonly type: string;
-    readonly attributes: LemonSqueezyWebhookAttributes;
-}
-export interface LemonSqueezyWebhookPayload {
-    readonly meta: {
-        readonly event_name: string;
-        readonly custom_data?: Record<string, unknown>;
-        readonly webhook_id?: string;
-    };
-    readonly data: LemonSqueezyWebhookData;
-}
-export interface WebhookEventRecord {
-    readonly id: string;
-    readonly eventType: WebhookEventType;
-    readonly receivedAt: string;
-    readonly processed: boolean;
-    readonly error?: string;
-    readonly summary: string;
-}
-export interface WebhookServerState {
-    readonly running: boolean;
-    readonly port: number;
-    readonly startedAt: string | null;
-    readonly eventsProcessed: number;
-    readonly recentEvents: WebhookEventRecord[];
-}
-export interface WebhookProcessResult {
-    readonly success: boolean;
-    readonly eventType: string;
-    readonly message: string;
-    readonly statusCode: number;
-}
-export type EventHandler = (payload: LemonSqueezyWebhookPayload) => WebhookProcessResult;
-export interface StartWebhookInput {
-    readonly port?: number;
-    readonly secret?: string;
-}
-export interface StopWebhookInput {
-    readonly force?: boolean;
-}
-export interface WebhookStatusInput {
-    readonly includeEvents?: boolean;
-}
-//# sourceMappingURL=webhook.d.ts.map

package/dist/types/webhook.js

@@ -1,4 +0,0 @@
-// types/webhook.ts — Webhook event types for Lemon Squeezy subscription events.
-// Used by the webhook engine (src/engine/webhook/) and tools (src/tools/webhook.ts).
-export {};
-//# sourceMappingURL=webhook.js.map