@dotcontext/cli 0.8.0

package/dist/generators/agents/templates/indexTemplate.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentIndex = renderAgentIndex;
+const agentConfig_1 = require("../agentConfig");
+function renderAgentIndex(agentTypes) {
+    const agentEntries = agentTypes.map(type => {
+        const title = formatTitle(type);
+        const primaryResponsibility = agentConfig_1.AGENT_RESPONSIBILITIES[type]?.[0] || 'Document responsibilities here.';
+        return `- [${title}](./${type}.md) — ${primaryResponsibility}`;
+    }).join('\n');
+    return `# Agent Handbook
+
+This directory contains ready-to-customize playbooks for AI agents collaborating on the repository.
+
+## Available Agents
+${agentEntries}
+
+## How To Use These Playbooks
+1. Pick the agent that matches your task.
+2. Enrich the template with project-specific context or links.
+3. Share the final prompt with your AI assistant.
+4. Capture learnings in the relevant documentation file so future runs improve.
+
+## Related Resources
+- [Documentation Index](../docs/README.md)
+- [Agent Knowledge Base](../../AGENTS.md)
+- [Contributor Guidelines](../../CONTRIBUTING.md)
+`;
+}
+function formatTitle(agentType) {
+    return agentType
+        .split('-')
+        .map(segment => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=indexTemplate.js.map

package/dist/generators/agents/templates/indexTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/indexTemplate.ts"],"names":[],"mappings":";;AAGA,4CAyBC;AA3BD,gDAAwD;AAExD,SAAgB,gBAAgB,CAAC,UAAgC;IAC/D,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACzC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,qBAAqB,GAAG,oCAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,iCAAiC,CAAC;QACrG,OAAO,MAAM,KAAK,OAAO,IAAI,UAAU,qBAAqB,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;;;EAKP,YAAY;;;;;;;;;;;;CAYb,CAAC;AACF,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB;IACpC,OAAO,SAAS;SACb,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/generators/agents/templates/types.d.ts

@@ -0,0 +1,22 @@
+import { AgentType } from '../agentTypes';
+import { SemanticContext } from '../../../services/semantic';
+export interface DocTouchpoint {
+    title: string;
+    path: string;
+}
+export interface KeySymbolInfo {
+    name: string;
+    kind: string;
+    file: string;
+    line: number;
+}
+export interface AgentTemplateContext {
+    agentType: AgentType;
+    topLevelDirectories: string[];
+    docTouchpoints: DocTouchpoint[];
+    responsibilities: string[];
+    bestPractices: string[];
+    semantics?: SemanticContext;
+    relevantSymbols?: KeySymbolInfo[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/generators/agents/templates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;CACnC"}

package/dist/generators/agents/templates/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/generators/agents/templates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/types.ts"],"names":[],"mappings":""}

package/dist/generators/documentation/codebaseMapGenerator.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Codebase Map Generator
+ *
+ * Generates a JSON file that serves as a quick LLM-readable summary
+ * of the entire codebase structure, symbols, and architecture.
+ */
+import { RepoStructure } from '../../types';
+import { SemanticContext } from '../../services/semantic';
+import { StackInfo } from '../../services/stack';
+export interface SymbolSummary {
+    name: string;
+    kind: string;
+    file: string;
+    line: number;
+    exported: boolean;
+    signature?: string;
+    description?: string;
+}
+export interface KeyFile {
+    path: string;
+    description: string;
+    category: 'entrypoint' | 'config' | 'types' | 'service' | 'generator' | 'util';
+}
+export interface NavigationHints {
+    tests: string;
+    config: string[];
+    types: string[];
+    mainLogic: string[];
+}
+export interface CodebaseMap {
+    version: string;
+    generated: string;
+    stack: {
+        primaryLanguage: string | null;
+        languages: string[];
+        frameworks: string[];
+        buildTools: string[];
+        testFrameworks: string[];
+        packageManager: string | null;
+        isMonorepo: boolean;
+        hasDocker: boolean;
+        hasCI: boolean;
+        nodeVersion?: string;
+        runtimeEnvironment?: 'node' | 'browser' | 'both';
+    };
+    structure: {
+        totalFiles: number;
+        rootPath?: string;
+        topDirectories: Array<{
+            name: string;
+            fileCount: number;
+            description?: string;
+        }>;
+        languageDistribution: Array<{
+            extension: string;
+            count: number;
+        }>;
+    };
+    architecture: {
+        layers: Array<{
+            name: string;
+            description: string;
+            directories: string[];
+            symbolCount: number;
+            dependsOn: string[];
+        }>;
+        patterns: Array<{
+            name: string;
+            confidence: number;
+            description: string;
+            occurrences: number;
+        }>;
+        entryPoints: string[];
+        mainEntryPoints?: string[];
+        moduleExports?: string[];
+    };
+    symbols: {
+        classes: SymbolSummary[];
+        interfaces: SymbolSummary[];
+        functions: SymbolSummary[];
+        types: SymbolSummary[];
+        enums: SymbolSummary[];
+    };
+    publicAPI: SymbolSummary[];
+    dependencies: {
+        mostImported: Array<{
+            file: string;
+            importedBy: number;
+            description?: string;
+        }>;
+    };
+    stats: {
+        totalSymbols: number;
+        exportedSymbols: number;
+        analysisTimeMs: number;
+    };
+    keyFiles?: KeyFile[];
+    navigation?: NavigationHints;
+}
+export interface CodebaseMapOptions {
+    maxSymbolsPerCategory?: number;
+}
+export declare class CodebaseMapGenerator {
+    private maxSymbols;
+    constructor(options?: CodebaseMapOptions);
+    generate(repoStructure: RepoStructure, semantics?: SemanticContext, stackInfo?: StackInfo): CodebaseMap;
+    private buildStackSection;
+    private buildStructureSection;
+    private getDirectoryDescription;
+    private buildArchitectureSection;
+    /**
+     * Categorize entry points into main (actual CLI/server/library) vs barrel exports
+     */
+    private categorizeEntryPoints;
+    private buildSymbolsSection;
+    private buildPublicAPISection;
+    private buildDependenciesSection;
+    /**
+     * Infer a description for a file based on its path and name
+     */
+    private inferFileDescription;
+    private buildStatsSection;
+    private extractSymbols;
+    private toSymbolSummary;
+    private relativePath;
+    /**
+     * Build key files section with descriptions and categories
+     */
+    private buildKeyFilesSection;
+    /**
+     * Enhance a file description with semantic context if available
+     */
+    private enhanceFileDescription;
+    /**
+     * Infer category from file path
+     */
+    private inferCategory;
+    /**
+     * Build navigation hints section
+     */
+    private buildNavigationSection;
+}
+//# sourceMappingURL=codebaseMapGenerator.d.ts.map

package/dist/generators/documentation/codebaseMapGenerator.d.ts.map

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