cc-agentic-framework 1.14.1

package/dist/lib/project-resolver.js

@@ -0,0 +1,362 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { ManifestManager } from './manifest-manager.js';
+/**
+ * Error thrown when a project context is required but not found.
+ */
+export class ProjectNotFoundError extends Error {
+    constructor(startDir) {
+        super(`Not inside an Agentic Framework project. ` +
+            `Searched from '${startDir}' to filesystem root. ` +
+            `Run 'agentic-framework init' to create a new project.`);
+        this.name = 'ProjectNotFoundError';
+    }
+}
+/** Cached project context for session (lazy singleton) */
+let cachedContext = null;
+/**
+ * Marker files and their detection priorities.
+ * Lower priority number = higher precedence.
+ */
+const DETECTION_MARKERS = [
+    {
+        method: 'manifest',
+        priority: 1,
+        check: async (dir) => {
+            const manifestPath = path.join(dir, '.agentic-framework.json');
+            return fs.pathExists(manifestPath);
+        },
+    },
+    {
+        method: 'routes',
+        priority: 2,
+        check: async (dir) => {
+            const routesPath = path.join(dir, 'routes.yml');
+            const claudePath = path.join(dir, 'CLAUDE.md');
+            const [hasRoutes, hasClaude] = await Promise.all([
+                fs.pathExists(routesPath),
+                fs.pathExists(claudePath),
+            ]);
+            return hasRoutes && hasClaude;
+        },
+    },
+    {
+        method: 'git+claude',
+        priority: 3,
+        check: async (dir) => {
+            const gitPath = path.join(dir, '.git');
+            const claudePath = path.join(dir, 'CLAUDE.md');
+            const [hasGit, hasClaude] = await Promise.all([
+                fs.pathExists(gitPath),
+                fs.pathExists(claudePath),
+            ]);
+            return hasGit && hasClaude;
+        },
+    },
+];
+/**
+ * Check if a path is at or above the home directory or filesystem root.
+ * Used to prevent scanning system directories.
+ *
+ * @param dir - Directory path to check
+ * @returns true if we should stop walking up
+ */
+function isSystemBoundary(dir) {
+    const homeDir = os.homedir();
+    const root = path.parse(dir).root;
+    // Stop at home directory or filesystem root
+    return dir === homeDir || dir === root;
+}
+/**
+ * Try to load the framework manifest from a directory.
+ *
+ * @param dir - Directory containing the manifest
+ * @returns Parsed manifest or null if not found/invalid
+ */
+async function tryLoadManifest(dir) {
+    try {
+        const manager = new ManifestManager(dir);
+        if (await manager.exists()) {
+            return await manager.read();
+        }
+    }
+    catch {
+        // Manifest exists but failed to parse - return null
+        return null;
+    }
+    return null;
+}
+/**
+ * Check a single directory for project markers.
+ *
+ * @param dir - Directory to check
+ * @returns Detection method if found, null otherwise
+ */
+async function checkDirectoryForMarkers(dir) {
+    // Check markers in priority order
+    for (const marker of DETECTION_MARKERS) {
+        if (await marker.check(dir)) {
+            return marker.method;
+        }
+    }
+    return null;
+}
+/**
+ * Walk up the directory tree to find a project root.
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Object with found directory and detection method, or null
+ */
+async function walkUpForProject(startDir) {
+    let currentDir = path.resolve(startDir);
+    while (true) {
+        const method = await checkDirectoryForMarkers(currentDir);
+        if (method) {
+            return { dir: currentDir, method };
+        }
+        // Check if we've reached system boundary
+        if (isSystemBoundary(currentDir)) {
+            return null;
+        }
+        // Move to parent directory
+        const parentDir = path.dirname(currentDir);
+        // Safety check: if we can't go up anymore
+        if (parentDir === currentDir) {
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+/**
+ * Find the project root by walking up the directory tree.
+ *
+ * Detection strategy (priority order):
+ * 1. `.agentic-framework.json` - Primary marker (most specific)
+ * 2. `routes.yml` + `CLAUDE.md` - Secondary marker
+ * 3. `.git` + `CLAUDE.md` - Fallback for git repos with framework
+ * 4. If nothing found, returns current directory with `isInsideProject: false`
+ *
+ * The result is cached for the session to avoid repeated filesystem scans.
+ *
+ * @param startDir - Directory to start searching from (defaults to process.cwd())
+ * @returns ProjectContext with resolved project information
+ *
+ * @example
+ * ```typescript
+ * const context = findProjectRoot();
+ * if (context.isInsideProject) {
+ *   console.log(`Found project at: ${context.projectRoot}`);
+ *   console.log(`Detected via: ${context.detectionMethod}`);
+ * }
+ * ```
+ */
+export function findProjectRoot(startDir) {
+    // Return cached result if available and no explicit startDir provided
+    if (cachedContext && !startDir) {
+        return cachedContext;
+    }
+    // Use sync wrapper for the async implementation
+    // This allows the function to be used synchronously in CLI commands
+    const resolvedStartDir = startDir ? path.resolve(startDir) : process.cwd();
+    // We need to run this synchronously for CLI compatibility
+    // Using a synchronous implementation
+    const result = findProjectRootSync(resolvedStartDir);
+    // Cache the result if using default start directory
+    if (!startDir) {
+        cachedContext = result;
+    }
+    return result;
+}
+/**
+ * Synchronous implementation of project root detection.
+ *
+ * @param startDir - Resolved absolute path to start searching from
+ * @returns ProjectContext with resolved project information
+ */
+function findProjectRootSync(startDir) {
+    let currentDir = startDir;
+    while (true) {
+        // Check markers in priority order (synchronous)
+        for (const marker of DETECTION_MARKERS) {
+            const detected = checkMarkerSync(currentDir, marker.method);
+            if (detected) {
+                const manifest = tryLoadManifestSync(currentDir);
+                return {
+                    projectRoot: currentDir,
+                    manifest,
+                    isInsideProject: true,
+                    detectionMethod: marker.method,
+                };
+            }
+        }
+        // Check if we've reached system boundary
+        if (isSystemBoundary(currentDir)) {
+            break;
+        }
+        // Move to parent directory
+        const parentDir = path.dirname(currentDir);
+        // Safety check: if we can't go up anymore
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    // No project found, return cwd context
+    return {
+        projectRoot: startDir,
+        manifest: null,
+        isInsideProject: false,
+        detectionMethod: 'cwd',
+    };
+}
+/**
+ * Synchronously check if a marker exists in a directory.
+ *
+ * @param dir - Directory to check
+ * @param method - Detection method to check for
+ * @returns true if marker is found
+ */
+function checkMarkerSync(dir, method) {
+    switch (method) {
+        case 'manifest':
+            return fs.pathExistsSync(path.join(dir, '.agentic-framework.json'));
+        case 'routes': {
+            const hasRoutes = fs.pathExistsSync(path.join(dir, 'routes.yml'));
+            const hasClaude = fs.pathExistsSync(path.join(dir, 'CLAUDE.md'));
+            return hasRoutes && hasClaude;
+        }
+        case 'git+claude': {
+            const hasGit = fs.pathExistsSync(path.join(dir, '.git'));
+            const hasClaude = fs.pathExistsSync(path.join(dir, 'CLAUDE.md'));
+            return hasGit && hasClaude;
+        }
+        default:
+            return false;
+    }
+}
+/**
+ * Synchronously try to load the framework manifest.
+ *
+ * @param dir - Directory containing the manifest
+ * @returns Parsed manifest or null if not found/invalid
+ */
+function tryLoadManifestSync(dir) {
+    const manifestPath = path.join(dir, '.agentic-framework.json');
+    if (!fs.pathExistsSync(manifestPath)) {
+        return null;
+    }
+    try {
+        return fs.readJsonSync(manifestPath);
+    }
+    catch {
+        // Manifest exists but failed to parse
+        return null;
+    }
+}
+/**
+ * Find the project root, throwing an error if not inside a project.
+ *
+ * Use this when the command requires being inside a valid project.
+ * Provides a clear error message guiding users to run `init`.
+ *
+ * @param startDir - Directory to start searching from (defaults to process.cwd())
+ * @returns ProjectContext with resolved project information
+ * @throws ProjectNotFoundError if not inside a project
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const context = requireProjectContext();
+ *   // Guaranteed to have isInsideProject: true
+ *   console.log(`Working in: ${context.projectRoot}`);
+ * } catch (error) {
+ *   if (error instanceof ProjectNotFoundError) {
+ *     console.error(error.message);
+ *     process.exit(1);
+ *   }
+ * }
+ * ```
+ */
+export function requireProjectContext(startDir) {
+    const context = findProjectRoot(startDir);
+    if (!context.isInsideProject) {
+        throw new ProjectNotFoundError(startDir || process.cwd());
+    }
+    return context;
+}
+/**
+ * Async version of findProjectRoot for use in async contexts.
+ * Provides better performance for operations that can be parallelized.
+ *
+ * @param startDir - Directory to start searching from (defaults to process.cwd())
+ * @returns Promise resolving to ProjectContext
+ *
+ * @example
+ * ```typescript
+ * const context = await findProjectRootAsync();
+ * if (context.isInsideProject) {
+ *   console.log(`Detected via: ${context.detectionMethod}`);
+ * }
+ * ```
+ */
+export async function findProjectRootAsync(startDir) {
+    const resolvedStartDir = startDir ? path.resolve(startDir) : process.cwd();
+    const result = await walkUpForProject(resolvedStartDir);
+    if (result) {
+        const manifest = await tryLoadManifest(result.dir);
+        return {
+            projectRoot: result.dir,
+            manifest,
+            isInsideProject: true,
+            detectionMethod: result.method,
+        };
+    }
+    // No project found, return cwd context
+    return {
+        projectRoot: resolvedStartDir,
+        manifest: null,
+        isInsideProject: false,
+        detectionMethod: 'cwd',
+    };
+}
+/**
+ * Async version of requireProjectContext.
+ *
+ * @param startDir - Directory to start searching from (defaults to process.cwd())
+ * @returns Promise resolving to ProjectContext
+ * @throws ProjectNotFoundError if not inside a project
+ */
+export async function requireProjectContextAsync(startDir) {
+    const context = await findProjectRootAsync(startDir);
+    if (!context.isInsideProject) {
+        throw new ProjectNotFoundError(startDir || process.cwd());
+    }
+    return context;
+}
+/**
+ * Clear the cached project context.
+ *
+ * Useful for testing or when the project structure has changed.
+ * Subsequent calls to findProjectRoot() will re-scan the filesystem.
+ *
+ * @example
+ * ```typescript
+ * // In tests
+ * beforeEach(() => {
+ *   clearProjectCache();
+ * });
+ * ```
+ */
+export function clearProjectCache() {
+    cachedContext = null;
+}
+/**
+ * Get the cached project context without triggering a new scan.
+ *
+ * @returns Cached ProjectContext or null if not yet resolved
+ */
+export function getCachedContext() {
+    return cachedContext;
+}
+//# sourceMappingURL=project-resolver.js.map

package/dist/lib/project-resolver.js.map

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

package/dist/lib/registry-generator.d.ts

@@ -0,0 +1,11 @@
+import type { ModuleManifest } from './module-loader.js';
+/**
+ * Generate project registries based on installed modules
+ */
+export declare function generateRegistries(projectPath: string, modules: ModuleManifest[]): Promise<void>;
+/**
+ * Regenerate only context.json registry.
+ * Used after context files are created during init.
+ */
+export declare function regenerateContextRegistry(projectPath: string, modules: ModuleManifest[]): Promise<void>;
+//# sourceMappingURL=registry-generator.d.ts.map

package/dist/lib/registry-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-generator.d.ts","sourceRoot":"","sources":["../../src/lib/registry-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAkBf;AA+VD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/lib/registry-generator.js

@@ -0,0 +1,288 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { DiscoveryEngine } from './discovery-engine.js';
+/**
+ * Generate project registries based on installed modules
+ */
+export async function generateRegistries(projectPath, modules) {
+    const registriesPath = path.join(projectPath, '.claude', 'registries');
+    await fs.ensureDir(registriesPath);
+    // Generate agents.json
+    await generateAgentsRegistry(registriesPath, modules);
+    // Generate skills.json
+    await generateSkillsRegistry(registriesPath, modules);
+    // Generate discovery-map.json
+    await generateDiscoveryMap(registriesPath, modules);
+    // Generate context.json with file existence validation
+    await generateContextRegistry(registriesPath, modules, projectPath);
+    // Copy static registries (skill-triggers.json)
+    await copyStaticRegistries(registriesPath, modules);
+}
+/**
+ * Copy static registry files from core module to project registries
+ */
+async function copyStaticRegistries(registriesPath, modules) {
+    const frameworkRoot = getFrameworkRoot(modules);
+    if (!frameworkRoot) {
+        return;
+    }
+    // Copy skill-triggers.json from core module
+    const skillTriggersSource = path.join(frameworkRoot, 'modules', 'core', 'registries', 'skill-triggers.json');
+    if (await fs.pathExists(skillTriggersSource)) {
+        const skillTriggersTarget = path.join(registriesPath, 'skill-triggers.json');
+        await fs.copy(skillTriggersSource, skillTriggersTarget);
+    }
+}
+/**
+ * Derive the framework root from module source paths.
+ * Module _sourcePath is like: /path/to/framework/modules/core
+ * Framework root should be: /path/to/framework (two levels up)
+ */
+function getFrameworkRoot(modules) {
+    for (const module of modules) {
+        if (module._sourcePath) {
+            // Go up two levels: from .../framework/modules/core to .../framework
+            return path.resolve(module._sourcePath, '..', '..');
+        }
+    }
+    return null;
+}
+async function generateAgentsRegistry(registriesPath, modules) {
+    // Handle empty modules array
+    const frameworkRoot = getFrameworkRoot(modules);
+    if (!frameworkRoot) {
+        await fs.writeJson(path.join(registriesPath, 'agents.json'), { version: '1.0.0', agents: [] }, { spaces: 2 });
+        return;
+    }
+    // Use DiscoveryEngine to parse agent frontmatter
+    const discoveryEngine = new DiscoveryEngine(frameworkRoot);
+    await discoveryEngine.loadModules();
+    const allAgentDefs = await discoveryEngine.getAllAgents();
+    // Filter agents by installed modules
+    const installedModuleIds = modules.map(m => m.id);
+    const agentDefs = allAgentDefs.filter(agent => installedModuleIds.includes(agent.moduleId));
+    // Build agents array from parsed definitions
+    const agents = agentDefs.map(agent => {
+        // Compute cumulative context files
+        const contextFiles = discoveryEngine.getContextFilesForAgent(agent);
+        // Build base agent object
+        const agentObj = {
+            id: agent.id,
+            module: agent.moduleId,
+            file: `.claude/commands/${agent.id}.md`,
+            'capability-needs': agent.capabilityNeeds,
+            'context-category-needs': agent.contextCategoryNeeds,
+            'context-files': contextFiles,
+            'token-budget': agent.tokenBudget,
+            variant: agent.variant || 'full',
+        };
+        // Add essential-skills if they exist and are non-empty
+        if (agent.essentialSkills && agent.essentialSkills.length > 0) {
+            agentObj['essential-skills'] = agent.essentialSkills;
+        }
+        // Add available-skills if they exist and are non-empty
+        if (agent.availableSkills && agent.availableSkills.length > 0) {
+            agentObj['available-skills'] = agent.availableSkills;
+        }
+        // Add delegation fields only if they exist and are non-empty
+        if (agent.delegatesTo && agent.delegatesTo.length > 0) {
+            agentObj['delegates-to'] = agent.delegatesTo;
+        }
+        if (agent.parentAgent) {
+            agentObj['parent-agent'] = agent.parentAgent;
+        }
+        return agentObj;
+    });
+    await fs.writeJson(path.join(registriesPath, 'agents.json'), { version: '1.0.0', agents }, { spaces: 2 });
+}
+async function generateSkillsRegistry(registriesPath, modules) {
+    // Handle empty modules array
+    const frameworkRoot = getFrameworkRoot(modules);
+    if (!frameworkRoot) {
+        await fs.writeJson(path.join(registriesPath, 'skills.json'), { version: '1.0.0', skills: [] }, { spaces: 2 });
+        return;
+    }
+    // Use DiscoveryEngine to parse skill frontmatter
+    const discoveryEngine = new DiscoveryEngine(frameworkRoot);
+    await discoveryEngine.loadModules();
+    const allSkillDefs = await discoveryEngine.getAllSkills();
+    // Filter skills by installed modules
+    const installedModuleIds = modules.map(m => m.id);
+    const skillDefs = allSkillDefs.filter(skill => installedModuleIds.includes(skill.moduleId));
+    // Build skills array from parsed definitions
+    const skills = skillDefs.map(skill => {
+        const skillObj = {
+            id: skill.id,
+            module: skill.moduleId,
+            'capabilities-provided': skill.capabilitiesProvided,
+            location: `.claude/skills/${skill.id}/`,
+        };
+        // Include description if available (used by skill-reminder hook for trigger matching)
+        if (skill.description) {
+            skillObj.description = skill.description;
+        }
+        return skillObj;
+    });
+    await fs.writeJson(path.join(registriesPath, 'skills.json'), { version: '1.0.0', skills }, { spaces: 2 });
+}
+async function generateDiscoveryMap(registriesPath, modules) {
+    // Handle empty modules array
+    const frameworkRoot = getFrameworkRoot(modules);
+    if (!frameworkRoot) {
+        await fs.writeJson(path.join(registriesPath, 'discovery-map.json'), { version: '1.0.0', capabilities: [] }, { spaces: 2 });
+        return;
+    }
+    // Use DiscoveryEngine to parse agent/skill frontmatter
+    const discoveryEngine = new DiscoveryEngine(frameworkRoot);
+    await discoveryEngine.loadModules();
+    const allAgentDefs = await discoveryEngine.getAllAgents();
+    const allSkillDefs = await discoveryEngine.getAllSkills();
+    // Filter by installed modules
+    const installedModuleIds = modules.map(m => m.id);
+    const agentDefs = allAgentDefs.filter(agent => installedModuleIds.includes(agent.moduleId));
+    const skillDefs = allSkillDefs.filter(skill => installedModuleIds.includes(skill.moduleId));
+    // Build capability map from parsed definitions
+    const capabilities = {};
+    // Map skills to their provided capabilities
+    for (const skill of skillDefs) {
+        for (const capability of skill.capabilitiesProvided) {
+            if (!capabilities[capability]) {
+                capabilities[capability] = { skills: [], agents: [] };
+            }
+            if (!capabilities[capability].skills.includes(skill.id)) {
+                capabilities[capability].skills.push(skill.id);
+            }
+        }
+    }
+    // Map agents to their required capabilities
+    for (const agent of agentDefs) {
+        for (const capability of agent.capabilityNeeds) {
+            if (!capabilities[capability]) {
+                capabilities[capability] = { skills: [], agents: [] };
+            }
+            if (!capabilities[capability].agents.includes(agent.id)) {
+                capabilities[capability].agents.push(agent.id);
+            }
+        }
+    }
+    const discoveryMap = Object.entries(capabilities).map(([capability, mapping]) => ({
+        capability,
+        'skills-providing': mapping.skills,
+        'used-by-agents': mapping.agents,
+    }));
+    await fs.writeJson(path.join(registriesPath, 'discovery-map.json'), { version: '1.0.0', capabilities: discoveryMap }, { spaces: 2 });
+}
+/**
+ * Standard context file definitions for the 3x3 matrix:
+ * - Categories: business, technical, process
+ * - Levels: basic, advanced, expert (cumulative loading)
+ */
+const STANDARD_CONTEXT_FILES = [
+    // Business context
+    {
+        id: 'business-basic',
+        category: 'business',
+        level: 'basic',
+        location: '.claude/context/business-basic.md',
+        responsibility: 'Product overview, user roles, key features',
+    },
+    {
+        id: 'business-advanced',
+        category: 'business',
+        level: 'advanced',
+        location: '.claude/context/business-advanced.md',
+        responsibility: 'Business strategy, market context, competitive landscape',
+    },
+    {
+        id: 'business-expert',
+        category: 'business',
+        level: 'expert',
+        location: '.claude/context/business-expert.md',
+        responsibility: 'Strategic vision, long-term planning, business architecture',
+    },
+    // Technical context
+    {
+        id: 'technical-basic',
+        category: 'technical',
+        level: 'basic',
+        location: '.claude/context/technical-basic.md',
+        responsibility: 'Tech stack, architecture overview',
+    },
+    {
+        id: 'technical-advanced',
+        category: 'technical',
+        level: 'advanced',
+        location: '.claude/context/technical-advanced.md',
+        responsibility: 'Design patterns, integration points, technical debt',
+    },
+    {
+        id: 'technical-expert',
+        category: 'technical',
+        level: 'expert',
+        location: '.claude/context/technical-expert.md',
+        responsibility: 'Architecture decisions, system evolution, technical strategy',
+    },
+    // Process context
+    {
+        id: 'process-basic',
+        category: 'process',
+        level: 'basic',
+        location: '.claude/context/process-basic.md',
+        responsibility: 'Workflow, team structure',
+    },
+    {
+        id: 'process-advanced',
+        category: 'process',
+        level: 'advanced',
+        location: '.claude/context/process-advanced.md',
+        responsibility: 'Development processes, quality gates, release management',
+    },
+    {
+        id: 'process-expert',
+        category: 'process',
+        level: 'expert',
+        location: '.claude/context/process-expert.md',
+        responsibility: 'Process optimization, team scaling, operational excellence',
+    },
+];
+async function generateContextRegistry(registriesPath, modules, projectPath) {
+    const contextFiles = [];
+    // Add standard context files (only if they exist)
+    for (const contextDef of STANDARD_CONTEXT_FILES) {
+        const contextFilePath = path.join(projectPath, contextDef.location);
+        if (await fs.pathExists(contextFilePath)) {
+            contextFiles.push({ ...contextDef });
+        }
+    }
+    // Add module-specific context files (only if they exist)
+    for (const module of modules) {
+        if (module.context) {
+            for (const [category, files] of Object.entries(module.context)) {
+                for (const file of files || []) {
+                    const contextFilePath = path.join(projectPath, 'ai', 'context', file);
+                    // Only add if the file actually exists
+                    if (await fs.pathExists(contextFilePath)) {
+                        contextFiles.push({
+                            id: file.replace('.md', ''),
+                            category,
+                            level: 'advanced',
+                            location: `.claude/context/${file}`,
+                            module: module.id,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    await fs.writeJson(path.join(registriesPath, 'context.json'), { version: '1.0.0', context: contextFiles }, { spaces: 2 });
+}
+/**
+ * Regenerate only context.json registry.
+ * Used after context files are created during init.
+ */
+export async function regenerateContextRegistry(projectPath, modules) {
+    const registriesPath = path.join(projectPath, '.claude', 'registries');
+    await fs.ensureDir(registriesPath);
+    await generateContextRegistry(registriesPath, modules, projectPath);
+}
+//# sourceMappingURL=registry-generator.js.map