@planu/cli 0.88.1 → 0.90.1

package/dist/cli/commands/activate.d.ts

@@ -0,0 +1,14 @@
+import type { CliCommand } from '../../types/cli.js';
+type ToolFormat = 'standard' | 'zed';
+interface ConfigTarget {
+    name: string;
+    path: string;
+    format: ToolFormat;
+}
+declare function buildTargets(): ConfigTarget[];
+declare function hasPlanu(config: unknown, format: ToolFormat): boolean;
+declare function updateStandardToken(filePath: string, licenseKey: string): void;
+declare function updateZedToken(filePath: string, licenseKey: string): void;
+export { buildTargets, hasPlanu, updateStandardToken, updateZedToken };
+export declare const activateCommand: CliCommand;
+//# sourceMappingURL=activate.d.ts.map

package/dist/cli/commands/activate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/activate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,oBAAoB,CAAC;AAiClE,KAAK,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC;AAErC,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAQD,iBAAS,YAAY,IAAI,YAAY,EAAE,CAyCtC;AAiBD,iBAAS,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAO9D;AAED,iBAAS,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAYvE;AAED,iBAAS,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAYlE;AAGD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,CAAC;AAMvE,eAAO,MAAM,eAAe,EAAE,UA0F7B,CAAC"}

package/dist/cli/commands/activate.js

@@ -0,0 +1,174 @@
+// cli/commands/activate.ts — planu activate <key>: add/update license in all installed configs (SPEC-237)
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { bold, green, yellow, dim, cyan } from '../colors.js';
+import { activateLicense } from '../../engine/license-validator.js';
+// ---------------------------------------------------------------------------
+// Constants — same paths as install.ts
+// ---------------------------------------------------------------------------
+const PLANU_KEY = 'planu';
+function buildTargets() {
+    const home = homedir();
+    return [
+        {
+            name: 'Claude Code',
+            path: join(home, '.claude.json'),
+            format: 'standard',
+        },
+        {
+            name: 'Cursor',
+            path: join(home, '.cursor', 'mcp.json'),
+            format: 'standard',
+        },
+        {
+            name: 'Windsurf',
+            path: join(home, '.codeium', 'windsurf', 'mcp_config.json'),
+            format: 'standard',
+        },
+        {
+            name: 'Zed',
+            path: join(home, '.config', 'zed', 'settings.json'),
+            format: 'zed',
+        },
+        {
+            name: 'Cline',
+            path: join(home, '.vscode', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+            format: 'standard',
+        },
+        {
+            name: 'Continue',
+            path: join(home, '.continue', 'config.json'),
+            format: 'standard',
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function readJson(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    const raw = readFileSync(filePath, 'utf-8').trim();
+    if (!raw) {
+        return null;
+    }
+    return JSON.parse(raw);
+}
+function hasPlanu(config, format) {
+    if (format === 'zed') {
+        const zed = config;
+        return Boolean(zed.context_servers?.[PLANU_KEY]);
+    }
+    const std = config;
+    return Boolean(std.mcpServers?.[PLANU_KEY]);
+}
+function updateStandardToken(filePath, licenseKey) {
+    const parsed = readJson(filePath);
+    if (!parsed) {
+        return;
+    }
+    const raw = parsed;
+    const entry = raw.mcpServers?.[PLANU_KEY];
+    if (!entry) {
+        return;
+    }
+    entry.env = { ...(entry.env ?? {}), SDD_OWNER_TOKEN: licenseKey };
+    writeFileSync(filePath, JSON.stringify(raw, null, 2) + '\n', 'utf-8');
+}
+function updateZedToken(filePath, licenseKey) {
+    const parsed = readJson(filePath);
+    if (!parsed) {
+        return;
+    }
+    const raw = parsed;
+    const entry = raw.context_servers?.[PLANU_KEY];
+    if (!entry) {
+        return;
+    }
+    entry.env = { ...(entry.env ?? {}), SDD_OWNER_TOKEN: licenseKey };
+    writeFileSync(filePath, JSON.stringify(raw, null, 2) + '\n', 'utf-8');
+}
+// Exported for tests
+export { buildTargets, hasPlanu, updateStandardToken, updateZedToken };
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+export const activateCommand = {
+    name: 'activate',
+    description: 'Activate a Pro license key in all installed Planu configs',
+    usage: 'planu activate <license-key>',
+    async run(args, _flags) {
+        const licenseKey = args[0];
+        if (!licenseKey) {
+            process.stderr.write(`${yellow('!')} Usage: planu activate <license-key>\n` +
+                `Example: planu activate PLN-XXXX-XXXX-XXXX\n`);
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write(`\n${bold('Planu License Activation')}\n\n`);
+        process.stdout.write(`${dim('Validating license key...')}\n`);
+        // Validate key via license API
+        let customerEmail;
+        let variantName;
+        try {
+            const result = await activateLicense(licenseKey, 'planu-cli');
+            if (!result.activated) {
+                const errMsg = result.error ?? 'Invalid license key';
+                process.stderr.write(`${yellow('!')} License validation failed: ${errMsg}\n`);
+                process.exitCode = 1;
+                return;
+            }
+            customerEmail = result.meta.customer_email;
+            variantName = result.meta.variant_name;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`${yellow('!')} License API error: ${msg}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write(`${green('+')} ${variantName} license — ${customerEmail}\n\n`);
+        process.stdout.write(`${cyan('Updating Planu configs:')}\n`);
+        const targets = buildTargets();
+        let updated = 0;
+        for (const target of targets) {
+            let config;
+            try {
+                config = readJson(target.path);
+            }
+            catch {
+                process.stdout.write(`  ${yellow('!')} ${target.name}: could not read config\n`);
+                continue;
+            }
+            if (config === null || !hasPlanu(config, target.format)) {
+                process.stdout.write(`  ${dim('\u25a1')} ${target.name} — Planu not installed here\n`);
+                continue;
+            }
+            try {
+                if (target.format === 'zed') {
+                    updateZedToken(target.path, licenseKey);
+                }
+                else {
+                    updateStandardToken(target.path, licenseKey);
+                }
+                process.stdout.write(`  ${green('+')} ${target.name} — updated\n`);
+                updated++;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                process.stdout.write(`  ${yellow('!')} ${target.name}: failed to write — ${msg}\n`);
+            }
+        }
+        process.stdout.write('\n');
+        if (updated === 0) {
+            process.stdout.write(`${yellow('!')} Planu is not installed in any tool. Run ${cyan('planu install')} first.\n\n`);
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write(`${green('+')} License activated in ${String(updated)} config(s). ` +
+            `${dim('Restart your AI tools to apply.')}\n\n`);
+    },
+};
+//# sourceMappingURL=activate.js.map

package/dist/cli/commands/activate.js.map

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

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,16 @@
+import type { CliCommand } from '../../types/cli.js';
+interface ToolReport {
+    name: string;
+    configPath: string;
+    status: 'ok' | 'not-installed' | 'invalid-config' | 'not-found';
+    detail?: string;
+}
+interface ToolCheck {
+    name: string;
+    paths: string[];
+    format: 'standard' | 'zed';
+}
+declare function checkTool(check: ToolCheck): ToolReport[];
+export { checkTool };
+export declare const doctorCommand: CliCommand;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,oBAAoB,CAAC;AAQlE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,eAAe,GAAG,gBAAgB,GAAG,WAAW,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;CAC5B;AA6DD,iBAAS,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,EAAE,CAkCjD;AAyCD,OAAO,EAAE,SAAS,EAAE,CAAC;AAMrB,eAAO,MAAM,aAAa,EAAE,UA8C3B,CAAC"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,162 @@
+// cli/commands/doctor.ts — planu doctor: verify MCP installations health (SPEC-236)
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { bold, cyan, green, yellow, red, dim } from '../colors.js';
+import { readJsonFile, hasPlanuEntry } from './install.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const CHECKS = [
+    {
+        name: 'Claude Code',
+        paths: [join(homedir(), '.claude.json'), join(process.cwd(), '.claude.json')],
+        format: 'standard',
+    },
+    {
+        name: 'Cursor',
+        paths: [join(homedir(), '.cursor', 'mcp.json'), join(process.cwd(), '.cursor', 'mcp.json')],
+        format: 'standard',
+    },
+    {
+        name: 'Windsurf',
+        paths: [
+            join(homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+            join(process.cwd(), '.windsurf', 'mcp.json'),
+        ],
+        format: 'standard',
+    },
+    {
+        name: 'Zed',
+        paths: [
+            join(homedir(), '.config', 'zed', 'settings.json'),
+            join(process.cwd(), '.zed', 'settings.json'),
+        ],
+        format: 'zed',
+    },
+    {
+        name: 'Cline',
+        paths: [
+            join(homedir(), '.vscode', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+        ],
+        format: 'standard',
+    },
+    {
+        name: 'Continue',
+        paths: [
+            join(homedir(), '.continue', 'config.json'),
+            join(process.cwd(), '.continue', 'config.json'),
+        ],
+        format: 'standard',
+    },
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function checkTool(check) {
+    const reports = [];
+    for (const configPath of check.paths) {
+        if (!existsSync(configPath)) {
+            continue; // skip non-existent paths silently
+        }
+        let config;
+        try {
+            config = readJsonFile(configPath);
+        }
+        catch {
+            reports.push({
+                name: check.name,
+                configPath,
+                status: 'invalid-config',
+                detail: 'Config file contains invalid JSON',
+            });
+            continue;
+        }
+        if (hasPlanuEntry(config, check.format)) {
+            reports.push({ name: check.name, configPath, status: 'ok' });
+        }
+        else {
+            reports.push({
+                name: check.name,
+                configPath,
+                status: 'not-installed',
+                detail: 'Planu MCP entry not found in config',
+            });
+        }
+    }
+    return reports;
+}
+function statusIcon(status) {
+    switch (status) {
+        case 'ok':
+            return green('+');
+        case 'not-installed':
+            return dim('-');
+        case 'invalid-config':
+            return yellow('!');
+        case 'not-found':
+            return dim('?');
+    }
+}
+function statusLabel(status) {
+    switch (status) {
+        case 'ok':
+            return green('OK');
+        case 'not-installed':
+            return dim('not installed');
+        case 'invalid-config':
+            return yellow('invalid config');
+        case 'not-found':
+            return dim('tool not found');
+    }
+}
+function printReports(allReports) {
+    for (const report of allReports) {
+        const icon = statusIcon(report.status);
+        const label = statusLabel(report.status);
+        const pathStr = report.configPath ? ` ${dim(report.configPath)}` : '';
+        process.stdout.write(`  [${icon}] ${report.name.padEnd(14)} ${label}${pathStr}\n`);
+        if (report.detail) {
+            process.stdout.write(`       ${dim(report.detail)}\n`);
+        }
+    }
+}
+// Exported for tests
+export { checkTool };
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+export const doctorCommand = {
+    name: 'doctor',
+    description: 'Check Planu MCP installation health',
+    usage: 'planu doctor',
+    run(_args, _flags) {
+        process.stdout.write(`\n${bold('Planu Doctor')}\n\n`);
+        const allReports = [];
+        for (const check of CHECKS) {
+            const reports = checkTool(check);
+            if (reports.length === 0) {
+                allReports.push({ name: check.name, configPath: '', status: 'not-found' });
+            }
+            else {
+                allReports.push(...reports);
+            }
+        }
+        printReports(allReports);
+        const installed = allReports.filter((r) => r.status === 'ok').length;
+        const invalid = allReports.filter((r) => r.status === 'invalid-config').length;
+        process.stdout.write('\n');
+        if (invalid > 0) {
+            process.stdout.write(`${yellow('Warning:')} ${String(invalid)} config file(s) have invalid JSON. Run ${cyan('planu install')} to fix.\n`);
+        }
+        if (installed === 0) {
+            process.stdout.write(`${red('Planu is not installed in any AI tool.')} Run ${cyan('planu install')} to set it up.\n\n`);
+            process.exitCode = 1;
+        }
+        else {
+            process.stdout.write(`${green('Planu is installed in')} ${bold(String(installed))} ${green('location(s).')} ${dim('Run `planu install` to add more.')}\n\n`);
+        }
+        return Promise.resolve();
+    },
+};
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

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

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,48 @@
+import type { CliCommand } from '../../types/cli.js';
+export interface LicenseActivationResult {
+    key: string;
+    customerEmail: string;
+    variantName: string;
+}
+interface McpEntry {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+interface StandardMcpConfig {
+    mcpServers?: Record<string, McpEntry>;
+}
+interface ZedCommandFormat {
+    path: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+interface ZedContextServer {
+    command?: ZedCommandFormat;
+    env?: Record<string, string>;
+}
+interface ZedConfig {
+    context_servers?: Record<string, ZedContextServer>;
+}
+type ToolConfig = StandardMcpConfig | ZedConfig;
+interface ToolDefinition {
+    name: string;
+    userScopePath: string;
+    projectScopePath: string | null;
+    format: 'standard' | 'zed';
+}
+declare function buildMcpEntry(licenseKey?: string): McpEntry;
+declare function readJsonFile(filePath: string): ToolConfig;
+declare function hasPlanuEntry(config: ToolConfig, format: ToolDefinition['format']): boolean;
+declare function writeStandardEntry(filePath: string, entry: McpEntry): void;
+declare function writeZedEntry(filePath: string, entry: McpEntry): void;
+declare function removeEntry(filePath: string, format: ToolDefinition['format']): void;
+/**
+ * Prompt the user for a license key and activate it.
+ * Returns the activation result or null if the user skips.
+ * In CI/headless mode (SDD_OWNER_TOKEN already set), returns a synthetic result immediately.
+ */
+export declare function promptLicense(): Promise<LicenseActivationResult | null>;
+export { buildMcpEntry, readJsonFile, hasPlanuEntry, writeStandardEntry, writeZedEntry, removeEntry, };
+export declare const installCommand: CliCommand;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,oBAAoB,CAAC;AASlE,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,UAAU,iBAAiB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACvC;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,UAAU,gBAAgB;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,UAAU,SAAS;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACpD;AAED,KAAK,UAAU,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAEhD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;CAC5B;AA0DD,iBAAS,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAYpD;AAED,iBAAS,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CASlD;AAED,iBAAS,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,OAAO,CAOpF;AASD,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAWnE;AAED,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAiB9D;AA4BD,iBAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAc7E;AAMD;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAgD7E;AAGD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,CAAC;AA+FF,eAAO,MAAM,cAAc,EAAE,UA+E5B,CAAC"}