codika 3.0.0

package/dist/utils/trigger-client.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Trigger Client
+ * HTTP client for triggering workflows and polling execution status via the Codika public API
+ */
+export interface TriggerWorkflowOptions {
+    /** Process instance ID */
+    processInstanceId: string;
+    /** Workflow ID (from use case config) */
+    workflowId: string;
+    /** Payload data to send to the workflow */
+    payload: Record<string, unknown>;
+    /** API URL for the triggerWebhookPublic endpoint */
+    apiUrl: string;
+    /** API key (organization API key or admin key) */
+    apiKey: string;
+}
+export interface TriggerWorkflowSuccessResponse {
+    success: true;
+    executionId: string;
+    message: string;
+}
+export interface TriggerWorkflowErrorResponse {
+    success: false;
+    error: string;
+    code: string;
+}
+export type TriggerWorkflowResponse = TriggerWorkflowSuccessResponse | TriggerWorkflowErrorResponse;
+export interface GetExecutionStatusOptions {
+    /** Process instance ID */
+    processInstanceId: string;
+    /** Execution ID (from trigger response) */
+    executionId: string;
+    /** API URL for the getExecutionStatusPublic endpoint */
+    apiUrl: string;
+    /** API key (organization API key or admin key) */
+    apiKey: string;
+}
+export interface ExecutionStatusData {
+    executionId: string;
+    status: 'pending' | 'success' | 'failed';
+    createdAt: string;
+    duration?: number;
+    resultData?: unknown;
+    errorDetails?: {
+        type: string;
+        message: string;
+        code?: string;
+        failedNodeName?: string;
+    };
+}
+export interface GetExecutionStatusSuccessResponse {
+    success: true;
+    execution: ExecutionStatusData;
+}
+export interface GetExecutionStatusErrorResponse {
+    success: false;
+    error: string;
+    code: string;
+}
+export type GetExecutionStatusResponse = GetExecutionStatusSuccessResponse | GetExecutionStatusErrorResponse;
+export interface PollOptions {
+    /** Polling interval in milliseconds (default: 3000) */
+    intervalMs?: number;
+    /** Maximum time to wait in milliseconds (default: 120000) */
+    timeoutMs?: number;
+    /** Callback on each poll attempt */
+    onPoll?: (elapsedMs: number, attempt: number) => void;
+}
+export declare function isTriggerSuccess(response: TriggerWorkflowResponse): response is TriggerWorkflowSuccessResponse;
+export declare function isTriggerError(response: TriggerWorkflowResponse): response is TriggerWorkflowErrorResponse;
+export declare function isStatusSuccess(response: GetExecutionStatusResponse): response is GetExecutionStatusSuccessResponse;
+export declare function isStatusError(response: GetExecutionStatusResponse): response is GetExecutionStatusErrorResponse;
+export declare function triggerWorkflow(options: TriggerWorkflowOptions): Promise<TriggerWorkflowResponse>;
+export declare function triggerWorkflowOrThrow(options: TriggerWorkflowOptions): Promise<TriggerWorkflowSuccessResponse>;
+export declare function getExecutionStatus(options: GetExecutionStatusOptions): Promise<GetExecutionStatusResponse>;
+export declare function getExecutionStatusOrThrow(options: GetExecutionStatusOptions): Promise<GetExecutionStatusSuccessResponse>;
+export declare function pollExecutionStatus(options: GetExecutionStatusOptions, pollOptions?: PollOptions): Promise<GetExecutionStatusSuccessResponse>;
+//# sourceMappingURL=trigger-client.d.ts.map

package/dist/utils/trigger-client.d.ts.map

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

package/dist/utils/trigger-client.js

@@ -0,0 +1,81 @@
+/**
+ * Trigger Client
+ * HTTP client for triggering workflows and polling execution status via the Codika public API
+ */
+// ── Type Guards ─────────────────────────────────────────
+export function isTriggerSuccess(response) {
+    return response.success === true;
+}
+export function isTriggerError(response) {
+    return response.success === false;
+}
+export function isStatusSuccess(response) {
+    return response.success === true;
+}
+export function isStatusError(response) {
+    return response.success === false;
+}
+// ── Trigger Function ────────────────────────────────────
+export async function triggerWorkflow(options) {
+    const { processInstanceId, workflowId, payload, apiUrl, apiKey } = options;
+    const url = `${apiUrl}/${processInstanceId}/${workflowId}`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-Process-Manager-Key': apiKey,
+        },
+        body: JSON.stringify({ payload }),
+    });
+    return (await response.json());
+}
+export async function triggerWorkflowOrThrow(options) {
+    const result = await triggerWorkflow(options);
+    if (isTriggerError(result)) {
+        throw new Error(`Trigger failed: ${result.error}`);
+    }
+    return result;
+}
+// ── Status Function ─────────────────────────────────────
+export async function getExecutionStatus(options) {
+    const { processInstanceId, executionId, apiUrl, apiKey } = options;
+    const url = `${apiUrl}/${processInstanceId}/${executionId}`;
+    const response = await fetch(url, {
+        method: 'GET',
+        headers: {
+            'X-Process-Manager-Key': apiKey,
+        },
+    });
+    return (await response.json());
+}
+export async function getExecutionStatusOrThrow(options) {
+    const result = await getExecutionStatus(options);
+    if (isStatusError(result)) {
+        throw new Error(`Status fetch failed: ${result.error}`);
+    }
+    return result;
+}
+// ── Poll Function ───────────────────────────────────────
+export async function pollExecutionStatus(options, pollOptions = {}) {
+    const { intervalMs = 3000, timeoutMs = 120000, onPoll } = pollOptions;
+    const startTime = Date.now();
+    let attempt = 0;
+    while (true) {
+        attempt++;
+        const elapsed = Date.now() - startTime;
+        if (elapsed > timeoutMs) {
+            throw new Error(`Polling timed out after ${Math.round(timeoutMs / 1000)}s. ` +
+                `Execution may still be running. Check status with:\n` +
+                `  codika get execution ${options.executionId}`);
+        }
+        if (onPoll) {
+            onPoll(elapsed, attempt);
+        }
+        const result = await getExecutionStatusOrThrow(options);
+        if (result.execution.status !== 'pending') {
+            return result;
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+}
+//# sourceMappingURL=trigger-client.js.map

package/dist/utils/trigger-client.js.map

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

package/dist/utils/use-case-deployer.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Use Case Deployer
+ * High-level function to deploy a use case from its folder path
+ */
+import type { ProcessDeploymentConfigurationInput, VersionStrategy, MetadataDocument, SkillDocument } from '../types/process-types.js';
+import { type DeployResult } from './deploy-client.js';
+/**
+ * Options for deploying a use case from folder
+ */
+export interface DeployUseCaseOptions {
+    /** Absolute path to the use case folder (containing config.ts/config.js) */
+    useCasePath: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** API URL for deployment */
+    apiUrl: string;
+    /** Override project ID (highest priority — skips project.json and config.ts) */
+    projectId?: string;
+    /** Version strategy (defaults to 'minor_bump') */
+    versionStrategy?: VersionStrategy;
+    /** Explicit version (required if versionStrategy is 'explicit') */
+    explicitVersion?: string;
+    /** Additional files to include (e.g., PRD, logs) */
+    additionalFiles?: Array<{
+        absolutePath: string;
+        relativePath: string;
+    }>;
+    /** Path to a custom project file (e.g., project-client-a.json) */
+    projectFile?: string;
+}
+/**
+ * Resolved deployment data — everything needed to deploy, before the HTTP call
+ */
+export interface ResolvedUseCaseDeployment {
+    useCasePath: string;
+    projectId: string;
+    projectIdSource: 'flag' | 'project.json';
+    configuration: ProcessDeploymentConfigurationInput;
+    workflowFiles: string[];
+    metadataDocuments: MetadataDocument[];
+    skills: SkillDocument[];
+    apiUrl: string;
+    apiKey: string;
+    versionStrategy?: VersionStrategy;
+    explicitVersion?: string;
+}
+/**
+ * Result of deploying a use case
+ * Combines the base DeployResult with additional context for archiving
+ */
+export type DeployUseCaseResult = DeployResult & {
+    /** The project ID from config.ts */
+    projectId: string;
+    /** The configuration that was deployed (useful for archiving) */
+    configuration: ProcessDeploymentConfigurationInput;
+    /** List of workflow files from config.ts (useful for archiving) */
+    workflowFiles: string[];
+};
+/**
+ * Resolve all deployment data without making the HTTP call.
+ * This is the preparation phase shared by both real deploy and dry-run.
+ *
+ * @param options - Deployment options including the use case path
+ * @returns Resolved deployment data ready for the HTTP call
+ */
+export declare function resolveUseCaseDeployment(options: DeployUseCaseOptions): Promise<ResolvedUseCaseDeployment>;
+/**
+ * Deploy a use case by pointing at its folder
+ *
+ * This function:
+ * 1. Resolves all deployment data (config, project ID, documents)
+ * 2. Makes the HTTP call to deploy to the Codika platform
+ * 3. Returns the result along with context needed for archiving
+ *
+ * @param options - Deployment options including the use case path
+ * @returns Deployment result with additional context
+ *
+ * @example
+ * ```typescript
+ * const result = await deployUseCaseFromFolder({
+ *   useCasePath: '/path/to/use-cases/my-use-case',
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * if (isDeploySuccess(result)) {
+ *   console.log('Deployed version:', result.data.version);
+ *   // Archive using result.configuration and result.workflowFiles
+ * }
+ * ```
+ */
+export declare function deployUseCaseFromFolder(options: DeployUseCaseOptions): Promise<DeployUseCaseResult>;
+export { isDeploySuccess, isDeployError } from './deploy-client.js';
+//# sourceMappingURL=use-case-deployer.d.ts.map

package/dist/utils/use-case-deployer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case-deployer.d.ts","sourceRoot":"","sources":["../../src/utils/use-case-deployer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,mCAAmC,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAEvI,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,cAAc,CAAC;IACzC,aAAa,EAAE,mCAAmC,CAAC;IACnD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG;IAC/C,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,aAAa,EAAE,mCAAmC,CAAC;IACnD,mEAAmE;IACnE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAqJF;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,yBAAyB,CAAC,CA4GpC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAuB9B;AAGD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/utils/use-case-deployer.js

@@ -0,0 +1,270 @@
+/**
+ * Use Case Deployer
+ * High-level function to deploy a use case from its folder path
+ */
+import { createHash } from 'crypto';
+import { join, extname, basename } from 'path';
+import { pathToFileURL } from 'url';
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { readSkillFiles } from './skill-parser.js';
+import { deployProcess, } from './deploy-client.js';
+import { resolveProjectId } from './project-json.js';
+/**
+ * MIME type mapping for common file extensions
+ */
+const MIME_TYPES = {
+    // Text/Documentation
+    '.md': 'text/markdown',
+    '.markdown': 'text/markdown',
+    '.txt': 'text/plain',
+    '.log': 'text/plain',
+    // Data formats
+    '.json': 'application/json',
+    '.yaml': 'application/x-yaml',
+    '.yml': 'application/x-yaml',
+    '.xml': 'application/xml',
+    '.csv': 'text/csv',
+    // Code
+    '.ts': 'text/typescript',
+    '.js': 'text/javascript',
+    '.py': 'text/x-python',
+    '.html': 'text/html',
+    '.css': 'text/css',
+};
+/**
+ * Get MIME type for a file based on extension
+ */
+function getMimeType(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return MIME_TYPES[ext] || 'application/octet-stream';
+}
+/**
+ * Generate a short hash of the relative path for collision-safe storage filenames
+ */
+function hashPath(relativePath) {
+    return createHash('md5').update(relativePath).digest('hex').substring(0, 8);
+}
+/**
+ * Get the storage filename with hash prefix to prevent collisions
+ * Files with same name in different folders get different hashes
+ */
+function getStorageFilename(relativePath) {
+    const filename = basename(relativePath);
+    return `${hashPath(relativePath)}-${filename}`;
+}
+/**
+ * Validate that a relative path is safe (no absolute paths or traversal)
+ */
+function validateRelativePath(relativePath) {
+    if (relativePath.startsWith('/')) {
+        throw new Error(`relativePath must not be absolute: ${relativePath}`);
+    }
+    if (relativePath.includes('..')) {
+        throw new Error(`relativePath must not contain '..': ${relativePath}`);
+    }
+}
+/**
+ * Read a single file and convert to MetadataDocument
+ *
+ * @param absolutePath - Absolute path to the file
+ * @param relativePath - Relative path for storage and reconstruction
+ * @param description - Optional description for the document
+ * @returns MetadataDocument or null if file cannot be read
+ */
+function readFileAsDocument(absolutePath, relativePath, description) {
+    if (!existsSync(absolutePath)) {
+        return null;
+    }
+    const fileStat = statSync(absolutePath);
+    // Skip directories
+    if (fileStat.isDirectory()) {
+        return null;
+    }
+    // Skip files larger than 10MB
+    if (fileStat.size > 10 * 1024 * 1024) {
+        console.warn(`Skipping ${relativePath}: exceeds 10MB size limit`);
+        return null;
+    }
+    try {
+        const content = readFileSync(absolutePath);
+        const contentBase64 = content.toString('base64');
+        const contentType = getMimeType(absolutePath);
+        return {
+            relativePath,
+            contentType,
+            contentBase64,
+            ...(description && { description }),
+        };
+    }
+    catch (error) {
+        console.warn(`Failed to read ${relativePath}: ${error instanceof Error ? error.message : error}`);
+        return null;
+    }
+}
+/**
+ * Read use case source files (config.ts and workflow JSONs) as metadata documents
+ * All files use their relative path for exact reconstruction
+ *
+ * @param useCasePath - Path to the use case folder
+ * @returns Array of MetadataDocument objects for source files
+ */
+function readUseCaseSourceFiles(useCasePath) {
+    const documents = [];
+    // 1. Read config.ts
+    const configPath = join(useCasePath, 'config.ts');
+    const configDoc = readFileAsDocument(configPath, 'config.ts', 'Use case configuration');
+    if (configDoc) {
+        documents.push(configDoc);
+    }
+    // 2. Read all workflow JSON files from workflows/ directory
+    const workflowsPath = join(useCasePath, 'workflows');
+    if (existsSync(workflowsPath)) {
+        const workflowFiles = readdirSync(workflowsPath).filter(f => f.endsWith('.json'));
+        for (const workflowFile of workflowFiles) {
+            const doc = readFileAsDocument(join(workflowsPath, workflowFile), `workflows/${workflowFile}`, // relativePath includes folder
+            `Workflow: ${workflowFile}`);
+            if (doc) {
+                documents.push(doc);
+            }
+        }
+    }
+    return documents;
+}
+/**
+ * Resolve all deployment data without making the HTTP call.
+ * This is the preparation phase shared by both real deploy and dry-run.
+ *
+ * @param options - Deployment options including the use case path
+ * @returns Resolved deployment data ready for the HTTP call
+ */
+export async function resolveUseCaseDeployment(options) {
+    const { useCasePath, apiKey, apiUrl, versionStrategy, explicitVersion, additionalFiles, } = options;
+    // Validate use case structure
+    const configPath = join(useCasePath, 'config.ts');
+    const workflowsPath = join(useCasePath, 'workflows');
+    const errors = [];
+    if (!existsSync(configPath)) {
+        errors.push(`Missing config.ts at ${configPath}`);
+    }
+    if (!existsSync(workflowsPath)) {
+        errors.push(`Missing workflows/ folder at ${workflowsPath}`);
+    }
+    if (errors.length > 0) {
+        throw new Error(`Invalid use case structure at ${useCasePath}:\n` +
+            errors.map((e) => `  - ${e}`).join('\n') +
+            '\n\nExpected structure:\n' +
+            '  use-case-folder/\n' +
+            '  ├── config.ts\n' +
+            '  └── workflows/\n' +
+            '      └── *.json');
+    }
+    const configUrl = pathToFileURL(configPath).href;
+    // Dynamically import the config module
+    let configModule;
+    try {
+        configModule = (await import(configUrl));
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to load config at ${configPath}: ${msg}\n` +
+            'Check your TypeScript syntax and ensure the file compiles correctly.');
+    }
+    // Validate required exports
+    if (typeof configModule.getConfiguration !== 'function') {
+        throw new Error(`config.js at ${useCasePath} must export getConfiguration function`);
+    }
+    // Resolve project ID: --project-id flag > --project-file > project.json
+    const { projectId, source } = resolveProjectId({
+        flagValue: options.projectId,
+        useCasePath,
+        projectFile: options.projectFile,
+    });
+    const configuration = configModule.getConfiguration();
+    const workflowFiles = configModule.WORKFLOW_FILES || [];
+    // Build document list - all files use relativePath for reconstruction
+    const documents = [];
+    // 1. Source files (config.ts, workflows/)
+    documents.push(...readUseCaseSourceFiles(useCasePath));
+    // 2. Additional files (PRD, logs, etc.)
+    if (additionalFiles) {
+        for (const file of additionalFiles) {
+            validateRelativePath(file.relativePath);
+            const doc = readFileAsDocument(file.absolutePath, file.relativePath);
+            if (doc) {
+                documents.push(doc);
+            }
+        }
+    }
+    // 3. Read skill files from skills/*/SKILL.md
+    const skills = readSkillFiles(useCasePath);
+    // Also add skill files as metadata documents for archival
+    for (const skill of skills) {
+        const skillPath = join(useCasePath, skill.relativePath);
+        const doc = readFileAsDocument(skillPath, skill.relativePath, `Skill: ${skill.name}`);
+        if (doc) {
+            documents.push(doc);
+        }
+    }
+    return {
+        useCasePath,
+        projectId,
+        projectIdSource: source,
+        configuration,
+        workflowFiles,
+        metadataDocuments: documents,
+        skills,
+        apiUrl,
+        apiKey,
+        versionStrategy,
+        explicitVersion,
+    };
+}
+/**
+ * Deploy a use case by pointing at its folder
+ *
+ * This function:
+ * 1. Resolves all deployment data (config, project ID, documents)
+ * 2. Makes the HTTP call to deploy to the Codika platform
+ * 3. Returns the result along with context needed for archiving
+ *
+ * @param options - Deployment options including the use case path
+ * @returns Deployment result with additional context
+ *
+ * @example
+ * ```typescript
+ * const result = await deployUseCaseFromFolder({
+ *   useCasePath: '/path/to/use-cases/my-use-case',
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * if (isDeploySuccess(result)) {
+ *   console.log('Deployed version:', result.data.version);
+ *   // Archive using result.configuration and result.workflowFiles
+ * }
+ * ```
+ */
+export async function deployUseCaseFromFolder(options) {
+    // Phase 1: Resolve everything
+    const resolved = await resolveUseCaseDeployment(options);
+    // Phase 2: Make the HTTP call (this is the only part dry-run skips)
+    const result = await deployProcess({
+        projectId: resolved.projectId,
+        configuration: resolved.configuration,
+        apiKey: resolved.apiKey,
+        apiUrl: resolved.apiUrl,
+        versionStrategy: resolved.versionStrategy,
+        explicitVersion: resolved.explicitVersion,
+        metadataDocuments: resolved.metadataDocuments.length > 0 ? resolved.metadataDocuments : undefined,
+        skills: resolved.skills.length > 0 ? resolved.skills : undefined,
+    });
+    // Return result with additional context for archiving
+    return {
+        ...result,
+        projectId: resolved.projectId,
+        configuration: resolved.configuration,
+        workflowFiles: resolved.workflowFiles,
+    };
+}
+// Re-export type guards for convenience
+export { isDeploySuccess, isDeployError } from './deploy-client.js';
+//# sourceMappingURL=use-case-deployer.js.map

package/dist/utils/use-case-deployer.js.map

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

package/dist/utils/version-manager.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Version Manager
+ * Utilities for managing version.json files and semver operations.
+ */
+import type { VersionStrategy } from '../types/process-types.js';
+/**
+ * Semver version parts
+ */
+export interface SemverVersion {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/**
+ * Local version increment strategy
+ */
+export type LocalVersionStrategy = 'patch' | 'minor' | 'major';
+/**
+ * Resolved version strategies for both API and local versioning
+ */
+export interface ResolvedVersionStrategies {
+    apiStrategy: VersionStrategy;
+    localStrategy: LocalVersionStrategy;
+    explicitVersion?: string;
+}
+/**
+ * Read version from version.json in a use case folder.
+ * Returns "1.0.0" if the file doesn't exist.
+ */
+export declare function readVersion(useCasePath: string): string;
+/**
+ * Write version to version.json in a use case folder.
+ */
+export declare function writeVersion(useCasePath: string, version: string): void;
+/**
+ * Parse a semver string (X.Y.Z) into parts.
+ */
+export declare function parseSemver(version: string): SemverVersion;
+/**
+ * Format semver parts back to string.
+ */
+export declare function formatSemver(version: SemverVersion): string;
+/**
+ * Increment a semver version based on strategy.
+ */
+export declare function incrementSemver(version: SemverVersion, strategy: LocalVersionStrategy): SemverVersion;
+/**
+ * Resolve shorthand CLI flags to API and local version strategies.
+ *
+ * | Flag               | API strategy  | Local strategy |
+ * |--------------------|---------------|----------------|
+ * | (default / --patch)| minor_bump    | patch          |
+ * | --minor            | minor_bump    | minor          |
+ * | --major            | major_bump    | major          |
+ * | --version X.Y      | explicit      | patch          |
+ */
+export declare function resolveVersionStrategies(flags: {
+    patch?: boolean;
+    minor?: boolean;
+    major?: boolean;
+    version?: string;
+}): ResolvedVersionStrategies;
+//# sourceMappingURL=version-manager.d.ts.map

package/dist/utils/version-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.d.ts","sourceRoot":"","sources":["../../src/utils/version-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,eAAe,CAAC;IAC7B,aAAa,EAAE,oBAAoB,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAa1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,oBAAoB,GAC7B,aAAa,CAUf;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,yBAAyB,CAyB5B"}