cc-agentic-framework 1.14.1

package/dist/lib/cli-context.js

@@ -0,0 +1,403 @@
+/**
+ * Unified CLI Context
+ *
+ * Combines project resolution and path resolution into a single, easy-to-use API
+ * for all CLI commands. Provides both async and sync variants, with caching support.
+ *
+ * @module cli-context
+ */
+import path from 'path';
+import fs from 'fs-extra';
+import yaml from 'yaml';
+import chalk from 'chalk';
+import { findProjectRoot, findProjectRootAsync, clearProjectCache, ProjectNotFoundError, } from './project-resolver.js';
+import { createPathResolver, createPathResolverSync, } from './path-resolver.js';
+// Re-export for convenience
+export * from './project-resolver.js';
+export * from './path-resolver.js';
+/**
+ * Unified CLI context providing project detection and path resolution.
+ *
+ * This class combines the functionality of project-resolver and path-resolver
+ * into a single, easy-to-use API. It provides:
+ *
+ * - Project root detection with multiple strategies
+ * - Framework manifest access (if present)
+ * - Semantic path resolution via routes.yml
+ * - Both async and sync variants
+ *
+ * @example
+ * ```typescript
+ * // In a command handler:
+ * const ctx = await CliContext.require();
+ * const ticketsDir = ctx.paths.getTicketPath('story');
+ * console.log(`Creating ticket in: ${ticketsDir}`);
+ *
+ * // Check if inside a project (without throwing):
+ * const ctx = await CliContext.create();
+ * if (ctx.isInsideProject) {
+ *   console.log(`Project found at: ${ctx.projectRoot}`);
+ * }
+ *
+ * // Use explicit path:
+ * const ctx = await CliContext.create({ path: '/path/to/project' });
+ * ```
+ */
+export class CliContext {
+    /**
+     * Absolute path to the project root directory.
+     * This is always set, even if not inside a project (falls back to cwd).
+     */
+    projectRoot;
+    /**
+     * Parsed framework manifest (.agentic-framework.json), or null if not found.
+     */
+    manifest;
+    /**
+     * Whether we found a valid project with framework markers.
+     * If false, projectRoot falls back to cwd or provided path.
+     */
+    isInsideProject;
+    /**
+     * Method used to detect the project root.
+     * - 'manifest': Found .agentic-framework.json
+     * - 'routes': Found routes.yml + CLAUDE.md
+     * - 'git+claude': Found .git + CLAUDE.md
+     * - 'cwd': No markers found
+     */
+    detectionMethod;
+    /**
+     * Path resolver for semantic path resolution.
+     * Provides methods like getTicketPath(), getPlanPath(), etc.
+     */
+    paths;
+    /**
+     * Private constructor - use static factory methods instead.
+     */
+    constructor(projectContext, pathResolver) {
+        this.projectRoot = projectContext.projectRoot;
+        this.manifest = projectContext.manifest;
+        this.isInsideProject = projectContext.isInsideProject;
+        this.detectionMethod = projectContext.detectionMethod;
+        this.paths = pathResolver;
+    }
+    /**
+     * Create a CLI context asynchronously.
+     *
+     * This is the preferred method for most use cases as it allows
+     * parallel filesystem operations during project detection.
+     *
+     * @param options - Optional configuration for context creation
+     * @returns Promise resolving to a CliContext instance
+     *
+     * @example
+     * ```typescript
+     * const ctx = await CliContext.create();
+     * if (ctx.isInsideProject) {
+     *   console.log(`Found project at: ${ctx.projectRoot}`);
+     *   console.log(`Detection method: ${ctx.detectionMethod}`);
+     * }
+     * ```
+     */
+    static async create(options) {
+        // Clear cache if fresh is requested
+        if (options?.fresh) {
+            clearProjectCache();
+        }
+        // Determine start path
+        const startPath = options?.path ? path.resolve(options.path) : undefined;
+        // Find project root
+        const projectContext = await findProjectRootAsync(startPath);
+        // Create path resolver
+        const pathResolver = await createPathResolver(projectContext.projectRoot);
+        return new CliContext(projectContext, pathResolver);
+    }
+    /**
+     * Create a CLI context synchronously.
+     *
+     * Use this when you need the context immediately and cannot use async/await,
+     * such as in synchronous command handlers or initialization code.
+     *
+     * @param options - Optional configuration for context creation
+     * @returns CliContext instance
+     *
+     * @example
+     * ```typescript
+     * const ctx = CliContext.createSync();
+     * console.log(`Project root: ${ctx.projectRoot}`);
+     * ```
+     */
+    static createSync(options) {
+        // Clear cache if fresh is requested
+        if (options?.fresh) {
+            clearProjectCache();
+        }
+        // Determine start path
+        const startPath = options?.path ? path.resolve(options.path) : undefined;
+        // Find project root synchronously
+        const projectContext = findProjectRoot(startPath);
+        // Load routes config synchronously
+        const routesConfig = loadRoutesConfigSync(projectContext.projectRoot);
+        // Create path resolver with pre-loaded config
+        const pathResolver = createPathResolverSync(projectContext.projectRoot, routesConfig);
+        return new CliContext(projectContext, pathResolver);
+    }
+    /**
+     * Create a CLI context asynchronously, throwing if not inside a project.
+     *
+     * Use this when your command requires being inside a valid project.
+     * Provides a clear error message guiding users to run `init`.
+     *
+     * @param options - Optional configuration for context creation
+     * @returns Promise resolving to a CliContext instance
+     * @throws ProjectNotFoundError if not inside a project
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const ctx = await CliContext.require();
+     *   // Guaranteed to have isInsideProject: true
+     *   const storiesDir = ctx.paths.getTicketPath('story');
+     *   console.log(`Working in: ${storiesDir}`);
+     * } catch (error) {
+     *   if (error instanceof ProjectNotFoundError) {
+     *     console.error(error.message);
+     *     process.exit(1);
+     *   }
+     * }
+     * ```
+     */
+    static async require(options) {
+        const context = await CliContext.create(options);
+        if (!context.isInsideProject) {
+            throw new ProjectNotFoundError(options?.path || process.cwd());
+        }
+        return context;
+    }
+    /**
+     * Create a CLI context synchronously, throwing if not inside a project.
+     *
+     * Synchronous version of `require()` for use in sync command handlers.
+     *
+     * @param options - Optional configuration for context creation
+     * @returns CliContext instance
+     * @throws ProjectNotFoundError if not inside a project
+     *
+     * @example
+     * ```typescript
+     * const ctx = CliContext.requireSync();
+     * console.log(`Working in project: ${ctx.projectRoot}`);
+     * ```
+     */
+    static requireSync(options) {
+        const context = CliContext.createSync(options);
+        if (!context.isInsideProject) {
+            throw new ProjectNotFoundError(options?.path || process.cwd());
+        }
+        return context;
+    }
+    /**
+     * Check if a specific module is installed in this project.
+     *
+     * @param moduleId - The module identifier to check
+     * @returns true if the module is installed
+     *
+     * @example
+     * ```typescript
+     * const ctx = await CliContext.require();
+     * if (ctx.hasModule('backlog')) {
+     *   console.log('Backlog module is installed');
+     * }
+     * ```
+     */
+    hasModule(moduleId) {
+        if (!this.manifest) {
+            return false;
+        }
+        return moduleId in this.manifest.modules;
+    }
+    /**
+     * Get the version of a specific installed module.
+     *
+     * @param moduleId - The module identifier
+     * @returns Module version string, or null if not installed
+     *
+     * @example
+     * ```typescript
+     * const ctx = await CliContext.require();
+     * const version = ctx.getModuleVersion('planning');
+     * if (version) {
+     *   console.log(`Planning module version: ${version}`);
+     * }
+     * ```
+     */
+    getModuleVersion(moduleId) {
+        if (!this.manifest) {
+            return null;
+        }
+        const moduleInfo = this.manifest.modules[moduleId];
+        if (!moduleInfo) {
+            return null;
+        }
+        // Handle both object format { version: string, ... } and string format
+        if (typeof moduleInfo === 'string') {
+            return moduleInfo;
+        }
+        return moduleInfo.version ?? null;
+    }
+    /**
+     * Get all installed module IDs.
+     *
+     * @returns Array of installed module identifiers
+     *
+     * @example
+     * ```typescript
+     * const ctx = await CliContext.require();
+     * const modules = ctx.getInstalledModules();
+     * console.log(`Installed modules: ${modules.join(', ')}`);
+     * ```
+     */
+    getInstalledModules() {
+        if (!this.manifest) {
+            return [];
+        }
+        return Object.keys(this.manifest.modules);
+    }
+    /**
+     * Get the framework version for this project.
+     *
+     * @returns Framework version string, or null if no manifest
+     *
+     * @example
+     * ```typescript
+     * const ctx = await CliContext.require();
+     * console.log(`Framework version: ${ctx.getFrameworkVersion()}`);
+     * ```
+     */
+    getFrameworkVersion() {
+        return this.manifest?.framework?.version ?? null;
+    }
+}
+/**
+ * Load routes.yml configuration synchronously.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @returns Parsed RoutesConfig or null if not found/invalid
+ */
+function loadRoutesConfigSync(projectRoot) {
+    const routesFilePath = path.join(projectRoot, 'routes.yml');
+    try {
+        if (!fs.pathExistsSync(routesFilePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(routesFilePath, 'utf-8');
+        const parsed = yaml.parse(content);
+        if (!parsed || typeof parsed !== 'object') {
+            return null;
+        }
+        // Validate that paths is an object if present
+        if (parsed.paths && typeof parsed.paths !== 'object') {
+            return null;
+        }
+        return {
+            paths: parsed.paths || {},
+            meta: parsed.meta,
+        };
+    }
+    catch {
+        // Return null on any parsing error - graceful degradation
+        return null;
+    }
+}
+/**
+ * Get CLI context with standard error handling.
+ *
+ * This is a convenience function for command handlers that provides
+ * consistent error handling. When `required: true` is set and the
+ * context cannot be found, it logs an error and exits the process.
+ *
+ * @param options - Configuration options including `required` flag
+ * @returns Promise resolving to CliContext, or null if not found and not required
+ *
+ * @example
+ * ```typescript
+ * // In a command handler that requires being in a project:
+ * const ctx = await getCliContext({ required: true });
+ * // If we get here, ctx is guaranteed to be non-null
+ * const ticketsDir = ctx!.paths.getTicketPath('story');
+ *
+ * // In a command that works without a project:
+ * const ctx = await getCliContext();
+ * if (ctx?.isInsideProject) {
+ *   console.log('Found project context');
+ * } else {
+ *   console.log('Working without project context');
+ * }
+ * ```
+ */
+export async function getCliContext(options) {
+    const { required = false, ...contextOptions } = options || {};
+    try {
+        if (required) {
+            return await CliContext.require(contextOptions);
+        }
+        else {
+            return await CliContext.create(contextOptions);
+        }
+    }
+    catch (error) {
+        if (error instanceof ProjectNotFoundError) {
+            console.error(chalk.red('\nError: Not inside an Agentic Framework project'));
+            console.error(chalk.dim(`Searched from: ${options?.path || process.cwd()}`));
+            console.error(chalk.dim('\nRun "agentic-framework init <project-name>" to create a new project.\n'));
+            process.exit(1);
+        }
+        // Re-throw unexpected errors
+        throw error;
+    }
+}
+/**
+ * Get CLI context synchronously with standard error handling.
+ *
+ * Synchronous version of getCliContext for use in sync command handlers.
+ *
+ * @param options - Configuration options including `required` flag
+ * @returns CliContext, or null if not found and not required
+ *
+ * @example
+ * ```typescript
+ * const ctx = getCliContextSync({ required: true });
+ * console.log(`Project: ${ctx!.projectRoot}`);
+ * ```
+ */
+export function getCliContextSync(options) {
+    const { required = false, ...contextOptions } = options || {};
+    try {
+        if (required) {
+            return CliContext.requireSync(contextOptions);
+        }
+        else {
+            return CliContext.createSync(contextOptions);
+        }
+    }
+    catch (error) {
+        if (error instanceof ProjectNotFoundError) {
+            console.error(chalk.red('\nError: Not inside an Agentic Framework project'));
+            console.error(chalk.dim(`Searched from: ${options?.path || process.cwd()}`));
+            console.error(chalk.dim('\nRun "agentic-framework init <project-name>" to create a new project.\n'));
+            process.exit(1);
+        }
+        // Re-throw unexpected errors
+        throw error;
+    }
+}
+/**
+ * Type guard to check if a value is a CliContext.
+ *
+ * @param value - Value to check
+ * @returns true if value is a CliContext instance
+ */
+export function isCliContext(value) {
+    return value instanceof CliContext;
+}
+//# sourceMappingURL=cli-context.js.map

package/dist/lib/cli-context.js.map

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

package/dist/lib/cli-version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Get the CLI package version from package.json
+ * This function works from compiled code by navigating relative to the compiled output
+ * @returns The version string from package.json
+ */
+export declare function getCliVersion(): Promise<string>;
+//# sourceMappingURL=cli-version.d.ts.map

package/dist/lib/cli-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-version.d.ts","sourceRoot":"","sources":["../../src/lib/cli-version.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAsBrD"}

package/dist/lib/cli-version.js

@@ -0,0 +1,30 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Get the CLI package version from package.json
+ * This function works from compiled code by navigating relative to the compiled output
+ * @returns The version string from package.json
+ */
+export async function getCliVersion() {
+    try {
+        // Get the directory of this compiled file
+        // In production: dist/lib/cli-version.js
+        // We need to go up to the package root: dist/lib/ -> dist/ -> root/
+        const currentFilePath = fileURLToPath(import.meta.url);
+        const currentDirPath = path.dirname(currentFilePath);
+        // Navigate from dist/lib/ -> dist/ -> root/ -> package.json
+        const packageJsonPath = path.join(currentDirPath, '..', '..', 'package.json');
+        if (await fs.pathExists(packageJsonPath)) {
+            const packageJson = await fs.readJson(packageJsonPath);
+            return packageJson.version || 'unknown';
+        }
+        // Fallback: unable to determine version
+        return 'unknown';
+    }
+    catch (_error) {
+        // If we can't read the version, return unknown rather than throwing
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=cli-version.js.map

package/dist/lib/cli-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-version.js","sourceRoot":"","sources":["../../src/lib/cli-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,0CAA0C;QAC1C,yCAAyC;QACzC,oEAAoE;QACpE,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAErD,4DAA4D;QAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAE9E,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;YACvD,OAAO,WAAW,CAAC,OAAO,IAAI,SAAS,CAAC;QAC1C,CAAC;QAED,wCAAwC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,oEAAoE;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/lib/command-factory.d.ts

@@ -0,0 +1,76 @@
+import { Command } from "commander";
+/**
+ * Command type - determines the command's behavior
+ */
+export type CommandType = "create" | "validate" | "sync" | "transform";
+/**
+ * Command option configuration
+ */
+export interface CommandOption {
+    name: string;
+    description: string;
+    required?: boolean;
+    default?: string;
+    choices?: string[];
+}
+/**
+ * Parsed command options from Commander.js
+ */
+export interface ParsedCommandOptions {
+    [key: string]: string | boolean | string[] | undefined;
+}
+/**
+ * Command configuration for factory
+ */
+export interface CommandConfig {
+    name: string;
+    description: string;
+    type: CommandType;
+    skill: string;
+    options: CommandOption[];
+    action?: (options: ParsedCommandOptions, command: Command) => void | Promise<void>;
+}
+/**
+ * Create a Commander.js command from configuration
+ * @param config - Command configuration
+ * @returns Commander.js Command instance
+ */
+export declare function createSkillCommand(config: CommandConfig): Command;
+/**
+ * Create a 'create' command (for generating files from templates)
+ */
+export declare function createCreateCommand(name: string, description: string, skill: string, options: CommandOption[], action: (options: ParsedCommandOptions, command: Command) => void | Promise<void>): Command;
+/**
+ * Create a 'validate' command (for validating files)
+ */
+export declare function createValidateCommand(name: string, description: string, skill: string, options: CommandOption[], action: (options: ParsedCommandOptions, command: Command) => void | Promise<void>): Command;
+/**
+ * Create a 'sync' command (for synchronizing data)
+ */
+export declare function createSyncCommand(name: string, description: string, skill: string, options: CommandOption[], action: (options: ParsedCommandOptions, command: Command) => void | Promise<void>): Command;
+/**
+ * Create a 'transform' command (for transforming files)
+ */
+export declare function createTransformCommand(name: string, description: string, skill: string, options: CommandOption[], action: (options: ParsedCommandOptions, command: Command) => void | Promise<void>): Command;
+/**
+ * Parse command options from CLI arguments
+ * Useful for testing and programmatic command execution
+ */
+export declare function parseCommandOptions(command: Command, args: string[]): ParsedCommandOptions;
+/**
+ * Get skill ID from a command
+ */
+export declare function getCommandSkillId(command: Command): string | undefined;
+/**
+ * Get command type from a command
+ */
+export declare function getCommandType(command: Command): CommandType | undefined;
+/**
+ * Validate command configuration
+ */
+export declare function validateCommandConfig(config: CommandConfig): boolean;
+/**
+ * Create multiple commands from configurations
+ */
+export declare function createCommands(configs: CommandConfig[]): Command[];
+//# sourceMappingURL=command-factory.d.ts.map

package/dist/lib/command-factory.d.ts.map

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