codika 3.0.0

package/dist/cli/commands/deploy/use-case.js

@@ -0,0 +1,212 @@
+/**
+ * Deploy Use Case Command
+ *
+ * Deploys a use case to the Codika platform.
+ * Manages local version.json tracking and deployment archiving.
+ */
+import { Command } from 'commander';
+import { resolve, isAbsolute } from 'path';
+import { existsSync } from 'fs';
+import { deployUseCaseFromFolder, resolveUseCaseDeployment, isDeploySuccess } from '../../../utils/use-case-deployer.js';
+import { formatSuccess, formatError, toJson, exitWithError, formatDryRunDeployment } from '../../utils/output.js';
+import { resolveApiKey, resolveEndpointUrl, describeApiKeySource, API_KEY_MISSING_MESSAGE } from '../../../utils/config.js';
+import { validateUseCase } from '../../../validation/runner.js';
+import { readProjectJson, updateProjectJson } from '../../../utils/project-json.js';
+import { readVersion, writeVersion, parseSemver, formatSemver, incrementSemver, resolveVersionStrategies, } from '../../../utils/version-manager.js';
+import { archiveDeployment, updateProjectInfo } from '../../../utils/deployment-archiver.js';
+export const useCaseCommand = new Command('use-case')
+    .description('Deploy a use case to the Codika platform')
+    .argument('<path>', 'Path to the use case folder (containing config.ts and workflows/)')
+    .option('--api-url <url>', 'Codika API URL (env: CODIKA_API_URL)')
+    .option('--api-key <key>', 'Codika API key (env: CODIKA_API_KEY)')
+    .option('--project-id <id>', 'Override project ID (skips project.json and config.ts)')
+    .option('--project-file <path>', 'Path to custom project file (e.g., project-client-a.json)')
+    .option('--patch', 'Patch version bump (default)')
+    .option('--minor', 'Minor version bump')
+    .option('--major', 'Major version bump')
+    .option('--version <version>', 'Explicit API version (X.Y format)')
+    .option('--additional-file <absolutePath:relativePath>', 'Add file with its relative path (repeatable)', (value, previous) => previous.concat([value]), [])
+    .option('--json', 'Output result as JSON')
+    .option('--dry-run', 'Preview what would be deployed without calling the API')
+    .option('--profile <name>', 'Use a specific profile instead of the active one')
+    .action(async (path, options) => {
+    try {
+        await runDeployUseCase(path, options);
+    }
+    catch (error) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                success: false,
+                error: {
+                    code: 'CLI_ERROR',
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            }, null, 2));
+        }
+        else {
+            console.error(`\x1b[31mError:\x1b[0m ${error instanceof Error ? error.message : error}`);
+        }
+        process.exit(1);
+    }
+});
+async function runDeployUseCase(useCasePath, options) {
+    // Resolve path
+    const absolutePath = resolve(useCasePath);
+    // Validate path exists
+    if (!existsSync(absolutePath)) {
+        exitWithError(`Use case path does not exist: ${absolutePath}`);
+    }
+    // Resolve API URL: --api-url > CODIKA_API_URL env > config baseUrl + path > production default
+    const apiUrl = resolveEndpointUrl('deployUseCase', options.apiUrl, options.profile);
+    // Resolve API key: --api-key > CODIKA_API_KEY env > config file
+    const apiKey = resolveApiKey(options.apiKey, options.profile);
+    if (!apiKey) {
+        exitWithError(API_KEY_MISSING_MESSAGE);
+    }
+    // Resolve version strategies from shorthand flags
+    const { apiStrategy, localStrategy, explicitVersion } = resolveVersionStrategies({
+        patch: options.patch,
+        minor: options.minor,
+        major: options.major,
+        version: options.version,
+    });
+    // Read current local version and compute new version
+    const currentVersion = readVersion(absolutePath);
+    const currentSemver = parseSemver(currentVersion);
+    const newSemver = incrementSemver(currentSemver, localStrategy);
+    const newLocalVersion = formatSemver(newSemver);
+    // Parse additional files
+    const additionalFiles = options.additionalFile?.map((entry) => {
+        const colonIdx = entry.indexOf(':');
+        if (colonIdx === -1) {
+            exitWithError(`Invalid --additional-file format: "${entry}". Expected "absolutePath:relativePath"`);
+        }
+        const absPath = entry.slice(0, colonIdx);
+        const relPath = entry.slice(colonIdx + 1);
+        if (!relPath) {
+            exitWithError(`Missing relativePath in --additional-file: "${entry}"`);
+        }
+        // Resolve absolute path (support relative paths on command line)
+        const resolvedAbsPath = isAbsolute(absPath) ? absPath : resolve(absPath);
+        return {
+            absolutePath: resolvedAbsPath,
+            relativePath: relPath,
+        };
+    });
+    // Dry-run: resolve everything, run validation, display results, exit
+    if (options.dryRun) {
+        const resolved = await resolveUseCaseDeployment({
+            useCasePath: absolutePath,
+            apiUrl,
+            apiKey,
+            projectId: options.projectId,
+            projectFile: options.projectFile,
+            versionStrategy: apiStrategy,
+            explicitVersion,
+            additionalFiles,
+        });
+        // Run validation
+        const validationResult = await validateUseCase({ path: absolutePath });
+        // Build dry-run data
+        const dryRunData = {
+            useCasePath: absolutePath,
+            projectId: resolved.projectId,
+            projectIdSource: resolved.projectIdSource,
+            apiKeySource: describeApiKeySource(options.apiKey),
+            apiUrl: resolved.apiUrl,
+            version: {
+                current: currentVersion,
+                next: newLocalVersion,
+                localStrategy,
+                apiStrategy,
+                ...(explicitVersion && { explicitApiVersion: explicitVersion }),
+            },
+            configuration: {
+                title: resolved.configuration.title,
+                subtitle: resolved.configuration.subtitle,
+                workflowCount: resolved.configuration.workflows.length,
+                tags: resolved.configuration.tags || [],
+                integrations: resolved.configuration.integrationUids || [],
+            },
+            workflows: resolved.configuration.workflows.map(w => ({
+                templateId: w.workflowTemplateId,
+                name: w.workflowName,
+                triggerTypes: w.triggers?.map(t => t.type) || [],
+                base64Size: w.n8nWorkflowJsonBase64?.length || 0,
+            })),
+            metadataDocuments: resolved.metadataDocuments.length,
+            validation: {
+                valid: validationResult.valid,
+                summary: validationResult.summary,
+            },
+        };
+        if (options.json) {
+            console.log(JSON.stringify(dryRunData, null, 2));
+        }
+        else {
+            console.log(formatDryRunDeployment(dryRunData));
+        }
+        process.exit(validationResult.valid ? 0 : 1);
+        return;
+    }
+    // Deploy
+    const result = await deployUseCaseFromFolder({
+        useCasePath: absolutePath,
+        apiUrl,
+        apiKey,
+        projectId: options.projectId,
+        projectFile: options.projectFile,
+        versionStrategy: apiStrategy,
+        explicitVersion,
+        additionalFiles,
+    });
+    // On success: update version.json, archive, update project info
+    if (isDeploySuccess(result)) {
+        // Auto-save processInstanceId and deployment history to project.json
+        const existingProject = readProjectJson(absolutePath, options.projectFile);
+        const deployments = existingProject?.deployments ?? {};
+        deployments[result.data.version] = {
+            templateId: result.data.templateId,
+            createdAt: new Date().toISOString(),
+        };
+        const projectUpdate = { deployments };
+        if (result.data.processInstanceId) {
+            projectUpdate.devProcessInstanceId = result.data.processInstanceId;
+        }
+        updateProjectJson(absolutePath, projectUpdate, options.projectFile);
+        // Write bumped version to version.json
+        writeVersion(absolutePath, newLocalVersion);
+        // Archive deployment locally
+        await archiveDeployment({
+            useCasePath: absolutePath,
+            projectId: result.projectId,
+            apiVersion: result.data.version,
+            useCaseVersion: newLocalVersion,
+            result,
+        });
+        // Update project-info.json with version mapping
+        await updateProjectInfo(absolutePath, result.projectId, result.data.version, newLocalVersion);
+    }
+    // Output result
+    if (options.json) {
+        console.log(toJson(result, isDeploySuccess(result) ? newLocalVersion : undefined));
+    }
+    else if (isDeploySuccess(result)) {
+        console.log(formatSuccess(result, newLocalVersion));
+    }
+    else {
+        console.log(formatError(result));
+    }
+    // Exit with appropriate code
+    if (isDeploySuccess(result)) {
+        // Check for workflow-level failures
+        if (result.data.deploymentStatus === 'failed') {
+            process.exit(1);
+        }
+        process.exit(0);
+    }
+    else {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=use-case.js.map

package/dist/cli/commands/deploy/use-case.js.map

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

package/dist/cli/commands/get/execution.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Get Execution Command
+ *
+ * Fetches execution details from the Codika platform for a given
+ * execution ID and process instance ID.
+ */
+import { Command } from 'commander';
+export declare const executionCommand: Command;
+//# sourceMappingURL=execution.d.ts.map

package/dist/cli/commands/get/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/get/execution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,eAAO,MAAM,gBAAgB,SA6BzB,CAAC"}

package/dist/cli/commands/get/execution.js

@@ -0,0 +1,159 @@
+/**
+ * Get Execution Command
+ *
+ * Fetches execution details from the Codika platform for a given
+ * execution ID and process instance ID.
+ */
+import { Command } from 'commander';
+import { resolve } from 'path';
+import { writeFileSync } from 'fs';
+import { getExecutionDetailsOrThrow, } from '../../../utils/execution-client.js';
+import { resolveApiKey, resolveEndpointUrl, API_KEY_MISSING_MESSAGE } from '../../../utils/config.js';
+import { readProjectJson } from '../../../utils/project-json.js';
+export const executionCommand = new Command('execution')
+    .description('Fetch execution details from the Codika platform')
+    .argument('<executionId>', 'Codika execution ID (from triggerWebhookPublic response)')
+    .option('--process-instance-id <id>', 'Process instance ID')
+    .option('--path <path>', 'Path to use case folder (to auto-resolve from project.json)')
+    .option('--project-file <path>', 'Path to custom project file (e.g., project-client-a.json)')
+    .option('--deep', 'Recursively fetch sub-workflow executions')
+    .option('--slim', 'Strip noise for readability')
+    .option('-o, --output <path>', 'Save to file instead of stdout')
+    .option('--api-url <url>', 'Override API URL')
+    .option('--api-key <key>', 'Override API key')
+    .option('--json', 'Output result as JSON')
+    .option('--profile <name>', 'Use a specific profile instead of the active one')
+    .action(async (executionId, options) => {
+    try {
+        await runGetExecution(executionId, options);
+    }
+    catch (error) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                success: false,
+                error: {
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            }, null, 2));
+        }
+        else {
+            console.error(`\x1b[31mError:\x1b[0m ${error instanceof Error ? error.message : error}`);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Resolve process instance ID from multiple sources:
+ *   1. Explicit --process-instance-id flag
+ *   2. project.json in --path directory
+ *   3. project.json in current directory
+ */
+function resolveProcessInstanceId(options) {
+    // 1. Explicit flag
+    if (options.processInstanceId)
+        return options.processInstanceId;
+    // 2. project.json (or custom project file) in --path directory
+    if (options.path) {
+        const projectJson = readProjectJson(resolve(options.path), options.projectFile);
+        if (projectJson?.devProcessInstanceId)
+            return projectJson.devProcessInstanceId;
+    }
+    // 3. project.json (or custom project file) in current directory
+    const projectJson = readProjectJson(process.cwd(), options.projectFile);
+    if (projectJson?.devProcessInstanceId)
+        return projectJson.devProcessInstanceId;
+    return undefined;
+}
+async function runGetExecution(executionId, options) {
+    // Resolve process instance ID
+    const processInstanceId = resolveProcessInstanceId(options);
+    if (!processInstanceId) {
+        exitWithError(`Process instance ID is required. Either:\n` +
+            `  1. Run from a use case folder with project.json (after deploy)\n` +
+            `  2. Pass --path <path> to a use case folder\n` +
+            `  3. Pass --process-instance-id <id> directly`);
+    }
+    // Resolve API key: --api-key > CODIKA_API_KEY env > config file
+    const apiKey = resolveApiKey(options.apiKey, options.profile);
+    if (!apiKey) {
+        exitWithError(API_KEY_MISSING_MESSAGE);
+    }
+    // Resolve API URL: --api-url > env > config baseUrl + path > production default
+    const apiUrl = resolveEndpointUrl('getExecutionDetails', options.apiUrl, options.profile);
+    if (!options.json) {
+        console.log(`\nFetching execution "${executionId}"...`);
+        console.log(`  Process Instance: ${processInstanceId}`);
+        if (options.deep)
+            console.log('  Mode: deep (including sub-workflows)');
+        if (options.slim)
+            console.log('  Mode: slim (noise stripped)');
+        console.log('');
+    }
+    // Fetch execution details from the API
+    const result = await getExecutionDetailsOrThrow({
+        processInstanceId,
+        executionId,
+        deep: options.deep,
+        slim: options.slim,
+        apiUrl,
+        apiKey,
+    });
+    // --output: write JSON to file
+    if (options.output) {
+        const outputPath = resolve(options.output);
+        writeFileSync(outputPath, JSON.stringify(result, null, 2) + '\n');
+        if (!options.json) {
+            console.log(`\x1b[32m✓ Execution details saved to ${outputPath}\x1b[0m`);
+        }
+        else {
+            console.log(JSON.stringify({
+                success: true,
+                data: {
+                    outputPath,
+                    executionId: result.execution.codikaExecutionId,
+                    status: result.execution.status,
+                },
+            }, null, 2));
+        }
+        process.exit(0);
+    }
+    // --json: structured JSON output
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(0);
+    }
+    // Default: formatted summary
+    printExecutionSummary(result);
+    process.exit(0);
+}
+function printExecutionSummary(result) {
+    const { execution } = result;
+    const statusColor = execution.status === 'success' ? '\x1b[32m' : '\x1b[31m';
+    const resetColor = '\x1b[0m';
+    console.log(`${statusColor}● Execution Details${resetColor}`);
+    console.log('');
+    console.log(`  Codika Execution ID: ${execution.codikaExecutionId}`);
+    console.log(`  n8n Execution ID:    ${execution.n8nExecutionId}`);
+    console.log(`  Status:              ${statusColor}${execution.status}${resetColor}`);
+    if (execution.n8nExecution) {
+        const n8n = execution.n8nExecution;
+        if (n8n.startedAt) {
+            console.log(`  Started At:          ${n8n.startedAt}`);
+        }
+        if (n8n.stoppedAt) {
+            console.log(`  Stopped At:          ${n8n.stoppedAt}`);
+        }
+        if (n8n.data?.resultData?.runData) {
+            const nodeCount = Object.keys(n8n.data.resultData.runData).length;
+            console.log(`  Nodes Executed:      ${nodeCount}`);
+        }
+    }
+    console.log('');
+    console.log(`  Request ID: ${result.requestId}`);
+    console.log('');
+}
+function exitWithError(message) {
+    console.error(`\x1b[31mError:\x1b[0m ${message}`);
+    process.exit(2);
+}
+//# sourceMappingURL=execution.js.map

package/dist/cli/commands/get/execution.js.map

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

package/dist/cli/commands/get/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get Command
+ *
+ * Parent command that contains subcommands for fetching
+ * use cases and other resources from the Codika platform.
+ *
+ * Usage:
+ *   codika get use-case <projectId> [outputPath]
+ *   codika get execution <executionId> [options]
+ */
+import { Command } from 'commander';
+export declare const getCommand: Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/get/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/get/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,UAAU,SAIK,CAAC"}

package/dist/cli/commands/get/index.js

@@ -0,0 +1,20 @@
+/**
+ * Get Command
+ *
+ * Parent command that contains subcommands for fetching
+ * use cases and other resources from the Codika platform.
+ *
+ * Usage:
+ *   codika get use-case <projectId> [outputPath]
+ *   codika get execution <executionId> [options]
+ */
+import { Command } from 'commander';
+import { useCaseCommand } from './use-case.js';
+import { executionCommand } from './execution.js';
+import { skillsCommand } from './skills.js';
+export const getCommand = new Command('get')
+    .description('Fetch use cases and resources from the Codika platform')
+    .addCommand(useCaseCommand)
+    .addCommand(executionCommand)
+    .addCommand(skillsCommand);
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/get/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/get/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,wDAAwD,CAAC;KACrE,UAAU,CAAC,cAAc,CAAC;KAC1B,UAAU,CAAC,gBAAgB,CAAC;KAC5B,UAAU,CAAC,aAAa,CAAC,CAAC"}

package/dist/cli/commands/get/skills.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get Skills Command
+ *
+ * Fetches skill documents from a deployed process instance.
+ * Downloads them as Claude-compatible skill directories ({name}/SKILL.md).
+ *
+ * Usage:
+ *   codika get skills [processInstanceId]
+ *   codika get skills --path ./my-use-case
+ *   codika get skills --json
+ *   codika get skills --stdout
+ */
+import { Command } from 'commander';
+export declare const skillsCommand: Command;
+//# sourceMappingURL=skills.d.ts.map

package/dist/cli/commands/get/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/get/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,eAAO,MAAM,aAAa,SA4BtB,CAAC"}

package/dist/cli/commands/get/skills.js

@@ -0,0 +1,135 @@
+/**
+ * Get Skills Command
+ *
+ * Fetches skill documents from a deployed process instance.
+ * Downloads them as Claude-compatible skill directories ({name}/SKILL.md).
+ *
+ * Usage:
+ *   codika get skills [processInstanceId]
+ *   codika get skills --path ./my-use-case
+ *   codika get skills --json
+ *   codika get skills --stdout
+ */
+import { Command } from 'commander';
+import { resolve, join } from 'path';
+import { mkdirSync, writeFileSync } from 'fs';
+import { fetchSkills, isFetchSkillsSuccess } from '../../../utils/skills-client.js';
+import { resolveApiKey, resolveEndpointUrl, API_KEY_MISSING_MESSAGE } from '../../../utils/config.js';
+import { readProjectJson } from '../../../utils/project-json.js';
+export const skillsCommand = new Command('skills')
+    .description('Fetch skill documents from a deployed process instance')
+    .argument('[processInstanceId]', 'Process instance ID (resolves from project.json if omitted)')
+    .option('--process-instance-id <id>', 'Process instance ID (alternative to positional arg)')
+    .option('--path <path>', 'Path to use case folder (to auto-resolve from project.json)')
+    .option('--project-file <path>', 'Path to custom project file')
+    .option('-o, --output <dir>', 'Output directory for skill files (default: ./skills)')
+    .option('--stdout', 'Print skill content to stdout instead of writing files')
+    .option('--api-url <url>', 'Override API URL')
+    .option('--api-key <key>', 'Override API key')
+    .option('--json', 'Output result as JSON')
+    .option('--profile <name>', 'Use a specific profile instead of the active one')
+    .action(async (processInstanceIdArg, options) => {
+    try {
+        await runGetSkills(processInstanceIdArg, options);
+    }
+    catch (error) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                success: false,
+                error: {
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            }, null, 2));
+        }
+        else {
+            console.error(`\x1b[31mError:\x1b[0m ${error instanceof Error ? error.message : error}`);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Resolve process instance ID from multiple sources:
+ *   1. Positional argument
+ *   2. --process-instance-id flag
+ *   3. project.json in --path directory
+ *   4. project.json in current directory
+ */
+function resolveProcessInstanceId(arg, options) {
+    if (arg)
+        return arg;
+    if (options.processInstanceId)
+        return options.processInstanceId;
+    if (options.path) {
+        const projectJson = readProjectJson(resolve(options.path), options.projectFile);
+        if (projectJson?.devProcessInstanceId)
+            return projectJson.devProcessInstanceId;
+    }
+    const projectJson = readProjectJson(process.cwd(), options.projectFile);
+    if (projectJson?.devProcessInstanceId)
+        return projectJson.devProcessInstanceId;
+    return undefined;
+}
+async function runGetSkills(processInstanceIdArg, options) {
+    const processInstanceId = resolveProcessInstanceId(processInstanceIdArg, options);
+    if (!processInstanceId) {
+        throw new Error('Process instance ID is required.\n' +
+            'Provide it as an argument, via --process-instance-id, or ensure project.json has devProcessInstanceId.');
+    }
+    const apiKey = resolveApiKey(options.apiKey, options.profile);
+    if (!apiKey) {
+        throw new Error(API_KEY_MISSING_MESSAGE);
+    }
+    const apiUrl = resolveEndpointUrl('getProcessSkills', options.apiUrl, options.profile);
+    const response = await fetchSkills({
+        processInstanceId,
+        apiUrl,
+        apiKey,
+    });
+    if (!isFetchSkillsSuccess(response)) {
+        throw new Error(`Failed to fetch skills: ${response.error.message}`);
+    }
+    const { skills } = response.data;
+    if (options.json) {
+        console.log(JSON.stringify({
+            success: true,
+            processInstanceId,
+            skillCount: skills.length,
+            skills,
+        }, null, 2));
+        return;
+    }
+    if (skills.length === 0) {
+        console.log('No skills found for this process instance.');
+        return;
+    }
+    if (options.stdout) {
+        // Print all skills to stdout
+        for (const skill of skills) {
+            console.log(`\n${'='.repeat(60)}`);
+            console.log(`Skill: ${skill.name} (${skill.workflowTemplateId})`);
+            console.log('='.repeat(60));
+            console.log(skill.contentMarkdown);
+        }
+        return;
+    }
+    // Write as Claude-compatible skill directories
+    const outputDir = resolve(options.output || './skills');
+    for (const skill of skills) {
+        const skillDir = join(outputDir, skill.name);
+        mkdirSync(skillDir, { recursive: true });
+        writeFileSync(join(skillDir, 'SKILL.md'), skill.contentMarkdown);
+    }
+    console.log(`\x1b[32m✓\x1b[0m Downloaded ${skills.length} skill(s) to ${outputDir}/`);
+    console.log('');
+    for (const skill of skills) {
+        console.log(`  ${skill.name}/SKILL.md`);
+        console.log(`    ${skill.description}`);
+        console.log(`    Trigger: codika trigger ${skill.workflowTemplateId}`);
+        console.log('');
+    }
+    console.log('To use with Claude Code:');
+    console.log(`  codika get skills --output .claude/skills`);
+    console.log('');
+    console.log('Claude Code auto-discovers skills in .claude/skills/ at startup.');
+}
+//# sourceMappingURL=skills.js.map

package/dist/cli/commands/get/skills.js.map

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

package/dist/cli/commands/get/use-case.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Get Use Case Command
+ *
+ * Fetches metadata documents from a deployed use case and reconstructs
+ * the local folder structure, or lists documents without downloading.
+ */
+import { Command } from 'commander';
+export declare const useCaseCommand: Command;
+//# sourceMappingURL=use-case.d.ts.map

package/dist/cli/commands/get/use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/get/use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,eAAO,MAAM,cAAc,SA6BvB,CAAC"}