@claudetools/cli 0.13.12 → 0.13.15

package/dist/stacks/io.js

@@ -0,0 +1,179 @@
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { parse as parseYaml } from 'yaml';
+import { requireAuth } from '../auth/config.js';
+import { getApiClient, ApiError } from '../lib/api.js';
+import { findStackByNameOrSlug } from './utils.js';
+/**
+ * Parse stack YAML using the yaml package
+ */
+function parseStackYaml(content) {
+    const parsed = parseYaml(content);
+    if (!parsed || !parsed.name) {
+        throw new Error('Stack YAML must have a name');
+    }
+    // Ensure extensions is always an array
+    if (!parsed.extensions) {
+        parsed.extensions = [];
+    }
+    return parsed;
+}
+/**
+ * Generate YAML from a stack
+ */
+function generateStackYaml(stack) {
+    const lines = [];
+    lines.push(`name: "${stack.name}"`);
+    if (stack.description) {
+        lines.push(`description: "${stack.description}"`);
+    }
+    if (stack.extends && stack.extends.length > 0) {
+        lines.push('extends:');
+        for (const ref of stack.extends) {
+            lines.push(`  - "${ref}"`);
+        }
+    }
+    if (stack.extensions.length > 0) {
+        lines.push('extensions:');
+        for (const ext of stack.extensions) {
+            lines.push(`  - type: ${ext.type}`);
+            lines.push(`    slug: ${ext.slug}`);
+            if (ext.version) {
+                lines.push(`    version: ${ext.version}`);
+            }
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * Export a stack to a YAML file
+ */
+export async function runStacksExport(nameOrSlug, outputPath) {
+    await requireAuth();
+    if (!nameOrSlug) {
+        console.error('Error: Missing stack name or slug');
+        console.log('Usage: claudetools stacks export <name> [output.yaml]');
+        process.exit(1);
+    }
+    try {
+        const client = getApiClient({ authenticated: true });
+        // Get all stacks
+        const listResponse = await client.get('/stacks');
+        if (!listResponse.success || !listResponse.data) {
+            console.error('Failed to fetch stacks');
+            process.exit(1);
+        }
+        const stack = findStackByNameOrSlug(listResponse.data.stacks, nameOrSlug);
+        if (!stack) {
+            console.error(`Stack not found: ${nameOrSlug}`);
+            process.exit(1);
+        }
+        // Get full stack details
+        const stackResponse = await client.get(`/stacks/${stack.id}`);
+        if (!stackResponse.success || !stackResponse.data) {
+            console.error('Failed to fetch stack details');
+            process.exit(1);
+        }
+        const fullStack = stackResponse.data;
+        // Generate YAML
+        const yaml = generateStackYaml(fullStack);
+        // Output to file or stdout
+        const filePath = outputPath || `${fullStack.slug}.yaml`;
+        if (outputPath === '-') {
+            // Output to stdout
+            console.log(yaml);
+        }
+        else {
+            writeFileSync(filePath, yaml, { encoding: 'utf-8' });
+            console.log();
+            console.log(`  Exported stack "${fullStack.name}" to ${filePath}`);
+            console.log();
+        }
+    }
+    catch (error) {
+        if (error instanceof ApiError) {
+            console.error(`Error: ${error.message}`);
+        }
+        else {
+            console.error('Failed to export stack');
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Import a stack from a YAML file
+ */
+export async function runStacksImport(inputPath, options) {
+    await requireAuth();
+    if (!inputPath) {
+        console.error('Error: Missing input file path');
+        console.log('Usage: claudetools stacks import <file.yaml>');
+        process.exit(1);
+    }
+    if (!existsSync(inputPath)) {
+        console.error(`File not found: ${inputPath}`);
+        process.exit(1);
+    }
+    try {
+        // Read and parse YAML
+        const content = readFileSync(inputPath, 'utf-8');
+        const stackData = parseStackYaml(content);
+        const client = getApiClient({ authenticated: true });
+        // Check if stack already exists
+        const listResponse = await client.get('/stacks');
+        if (!listResponse.success || !listResponse.data) {
+            console.error('Failed to fetch stacks');
+            process.exit(1);
+        }
+        const existing = findStackByNameOrSlug(listResponse.data.stacks, stackData.name);
+        if (existing && !options?.update) {
+            console.error(`Stack "${stackData.name}" already exists.`);
+            console.log('Use --update flag to update the existing stack.');
+            process.exit(1);
+        }
+        if (existing && options?.update) {
+            // Update existing stack
+            const response = await client.put(`/stacks/${existing.id}`, {
+                name: stackData.name,
+                description: stackData.description,
+                extensions: stackData.extensions,
+            });
+            if (!response.success) {
+                console.error('Failed to update stack');
+                process.exit(1);
+            }
+            console.log();
+            console.log(`  Updated stack "${stackData.name}"`);
+            console.log(`  Extensions: ${stackData.extensions.length}`);
+            console.log();
+        }
+        else {
+            // Create new stack
+            const response = await client.post('/stacks', {
+                name: stackData.name,
+                description: stackData.description,
+                extensions: stackData.extensions,
+            });
+            if (!response.success) {
+                console.error('Failed to create stack');
+                process.exit(1);
+            }
+            console.log();
+            console.log(`  Imported stack "${stackData.name}"`);
+            console.log(`  Extensions: ${stackData.extensions.length}`);
+            console.log();
+        }
+    }
+    catch (error) {
+        if (error instanceof ApiError) {
+            console.error(`Error: ${error.message}`);
+        }
+        else if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+        }
+        else {
+            console.error('Failed to import stack');
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=io.js.map

package/dist/stacks/io.js.map

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

package/dist/stacks/rollback.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Run the rollback command
+ */
+export declare function runStacksRollback(nameOrSlug: string): Promise<void>;
+//# sourceMappingURL=rollback.d.ts.map

package/dist/stacks/rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../src/stacks/rollback.ts"],"names":[],"mappings":"AAgEA;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6HzE"}

package/dist/stacks/rollback.js

@@ -0,0 +1,162 @@
+import { requireAuth, loadConfig } from '../auth/config.js';
+import { getApiClient, ApiError } from '../lib/api.js';
+import * as readline from 'readline';
+import { findStackByNameOrSlug } from './utils.js';
+/**
+ * Prompt user to select from a list
+ */
+async function promptSelect(message, choices) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    console.log();
+    console.log(`  ${message}`);
+    console.log();
+    choices.forEach((choice, index) => {
+        console.log(`  ${index + 1}. ${choice.name}`);
+    });
+    console.log();
+    return new Promise((resolve) => {
+        rl.question('  Enter number (or press Enter to cancel): ', (answer) => {
+            rl.close();
+            const num = parseInt(answer.trim(), 10);
+            if (isNaN(num) || num < 1 || num > choices.length) {
+                resolve(null);
+            }
+            else {
+                const choice = choices[num - 1];
+                resolve(choice ? choice.value : null);
+            }
+        });
+    });
+}
+/**
+ * Prompt user for confirmation
+ */
+async function promptConfirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    return new Promise((resolve) => {
+        rl.question(`  ${message} (y/N): `, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y');
+        });
+    });
+}
+/**
+ * Format date for display
+ */
+function formatDate(isoString) {
+    const date = new Date(isoString);
+    return date.toLocaleString();
+}
+/**
+ * Run the rollback command
+ */
+export async function runStacksRollback(nameOrSlug) {
+    await requireAuth();
+    const config = loadConfig();
+    if (!config?.tier || config.tier === 'free') {
+        console.log();
+        console.log('  Stack rollback requires Pro or Team tier.');
+        console.log('  Upgrade: claudetools upgrade');
+        console.log();
+        process.exit(1);
+    }
+    if (!nameOrSlug) {
+        console.error('Error: Missing stack name or slug');
+        console.log('Usage: claudetools stacks rollback <name>');
+        process.exit(1);
+    }
+    try {
+        const client = getApiClient({ authenticated: true });
+        // Find stack by name or slug
+        const listResponse = await client.get('/stacks');
+        if (!listResponse.success || !listResponse.data) {
+            console.error('Failed to fetch stacks');
+            process.exit(1);
+        }
+        const foundStack = findStackByNameOrSlug(listResponse.data.stacks, nameOrSlug);
+        if (!foundStack) {
+            console.error(`Stack not found: ${nameOrSlug}`);
+            process.exit(1);
+        }
+        // Get history
+        console.log();
+        console.log('  Loading history...');
+        const historyResponse = await client.get(`/stacks/${foundStack.id}/history`);
+        if (!historyResponse.success || !historyResponse.data) {
+            if (historyResponse.error?.code === 'FEATURE_UNAVAILABLE') {
+                console.log();
+                console.log('  Stack history requires Pro or Team tier.');
+                console.log('  Upgrade: claudetools upgrade');
+                console.log();
+            }
+            else {
+                console.error('Failed to load history');
+            }
+            process.exit(1);
+        }
+        const { history } = historyResponse.data;
+        if (history.length === 0) {
+            console.log();
+            console.log('  No history available for this stack.');
+            console.log();
+            return;
+        }
+        // Show history and prompt for selection
+        const choices = history.map((h) => ({
+            name: `${formatDate(h.createdAt)} - ${h.changeType}`,
+            value: h.id
+        }));
+        choices.push({ name: 'Cancel', value: null });
+        const selectedHistoryId = await promptSelect('Select version to rollback to:', choices);
+        if (selectedHistoryId === null) {
+            console.log();
+            console.log('  Rollback cancelled.');
+            console.log();
+            return;
+        }
+        // Confirm rollback
+        const proceed = await promptConfirm('This will restore the stack to the selected version. Continue?');
+        if (!proceed) {
+            console.log();
+            console.log('  Rollback cancelled.');
+            console.log();
+            return;
+        }
+        // Perform rollback
+        console.log();
+        console.log('  Rolling back...');
+        const rollbackResponse = await client.post(`/stacks/${foundStack.id}/rollback`, { historyId: selectedHistoryId });
+        if (!rollbackResponse.success || !rollbackResponse.data) {
+            console.error('Rollback failed');
+            process.exit(1);
+        }
+        console.log('  Stack rolled back successfully.');
+        console.log();
+        console.log(`  Restored to ${rollbackResponse.data.rolledBackTo}`);
+        console.log();
+    }
+    catch (error) {
+        if (error instanceof ApiError) {
+            if (error.code === 'FEATURE_UNAVAILABLE') {
+                console.log();
+                console.log('  Stack rollback requires Pro or Team tier.');
+                console.log('  Upgrade: claudetools upgrade');
+                console.log();
+            }
+            else {
+                console.error(`Error: ${error.message}`);
+            }
+        }
+        else {
+            console.error('Failed to rollback stack');
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=rollback.js.map

package/dist/stacks/rollback.js.map

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

package/dist/stacks/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Canonical Stack type definitions
+ * All stacks commands should import these types
+ */
+export interface Extension {
+    type: string;
+    slug: string;
+    version?: string;
+}
+export interface Stack {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    visibility?: 'private' | 'team' | 'public';
+    teamSlug?: string;
+    extensions: Extension[];
+    extends?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface StacksListResponse {
+    stacks: Stack[];
+    quota: {
+        used: number;
+        limit: number | null;
+        tier: string;
+    };
+}
+/** API returns stack data directly in response.data, not nested under .stack */
+export type StackResponse = Stack;
+export interface StackCheckResponse {
+    valid: boolean;
+    extensions: Extension[];
+    conflicts: StackConflict[];
+    warnings: StackConflict[];
+    chain: string[];
+    appliedPolicy?: {
+        required: Extension[];
+        blocked: Extension[];
+        approvedOnly: boolean;
+    };
+}
+export interface StackConflict {
+    id: string;
+    type: 'port' | 'file' | 'env' | 'semantic' | 'policy';
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    extensions: Array<{
+        type: string;
+        slug: string;
+        detail?: string;
+    }>;
+    suggestion?: string;
+}
+export interface HistoryEntry {
+    id: number;
+    stackId: string;
+    changeType: string;
+    createdAt: string;
+    snapshot: Record<string, unknown>;
+}
+export interface HistoryResponse {
+    history: HistoryEntry[];
+}
+export interface RollbackResponse {
+    stack: Stack;
+    rolledBackTo: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/stacks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/stacks/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtD,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/stacks/types.js

@@ -0,0 +1,6 @@
+/**
+ * Canonical Stack type definitions
+ * All stacks commands should import these types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/stacks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/stacks/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/stacks/utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared utilities for stacks commands
+ */
+import type { Stack } from './types.js';
+/**
+ * Find stack by name or slug (case-insensitive)
+ */
+export declare function findStackByNameOrSlug(stacks: Stack[], nameOrSlug: string): Stack | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/stacks/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/stacks/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAKvF"}

package/dist/stacks/utils.js

@@ -0,0 +1,11 @@
+/**
+ * Shared utilities for stacks commands
+ */
+/**
+ * Find stack by name or slug (case-insensitive)
+ */
+export function findStackByNameOrSlug(stacks, nameOrSlug) {
+    const lower = nameOrSlug.toLowerCase();
+    return stacks.find(s => s.slug === lower || s.name.toLowerCase() === lower) ?? null;
+}
+//# sourceMappingURL=utils.js.map

package/dist/stacks/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/stacks/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,UAAkB;IACvE,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACrB,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CACnD,IAAI,IAAI,CAAC;AACZ,CAAC"}

package/dist/start/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Start Module - First-Time User Onboarding
+ *
+ * Guides new users through initial setup:
+ * 1. Check sync engine installation -> prompt to install if missing
+ * 2. Check authentication -> run device flow login if not logged in
+ * 3. Create first stack -> prompt for name, offer popular extensions
+ * 4. Show next steps / quick reference
+ */
+export interface StartOptions {
+    force?: boolean;
+    skipSyncEngine?: boolean;
+    skipStack?: boolean;
+}
+/**
+ * Run the first-time user onboarding flow
+ */
+export declare function runStart(options?: StartOptions): Promise<void>;
+/**
+ * Reset onboarding state (for testing)
+ */
+export declare function runStartReset(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/start/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwDH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA8GD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0OxE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CASnD"}