cc-agentic-framework 1.14.1

package/dist/lib/telemetry/types.d.ts

@@ -0,0 +1,302 @@
+/**
+ * Telemetry Types
+ * TypeScript interfaces for telemetry events, configuration, and exporters
+ */
+/**
+ * Telemetry event types
+ */
+export type TelemetryEventType = 'discovery' | 'sync' | 'cli' | 'integration' | 'validation' | 'mcp' | 'agent';
+/**
+ * Telemetry log levels
+ */
+export type TelemetryLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Session context for correlating events
+ */
+export interface SessionContext {
+    /** Unique session identifier (e.g., sess_abc123def456) */
+    session_id: string;
+    /** Parent session ID for delegated/spawned agents */
+    parent_session_id?: string;
+    /** Correlation ID for tracing related operations within a session */
+    correlation_id?: string;
+    /** Timestamp when the session started */
+    session_start?: string;
+    /** Machine/environment identifier (optional) */
+    machine_id?: string;
+}
+/**
+ * Base telemetry event structure
+ */
+export interface BaseTelemetryEvent {
+    timestamp: string;
+    event_type: TelemetryEventType;
+    operation: string;
+    /** Session ID for correlating events across a Claude session */
+    session_id?: string;
+    /** Parent session ID for delegated agents */
+    parent_session_id?: string;
+    /** Correlation ID for tracing related operations */
+    correlation_id?: string;
+    success?: boolean;
+    duration_ms?: number;
+    error?: {
+        message: string;
+        stack?: string;
+    };
+}
+/**
+ * Discovery operation event
+ */
+export interface DiscoveryEvent extends BaseTelemetryEvent {
+    event_type: 'discovery';
+    agent_id: string;
+    module_id: string;
+    variant?: 'full' | 'slim';
+    capabilities_requested: string[];
+    skills_discovered: Array<{
+        skill_id: string;
+        module: string;
+        source: string;
+    }>;
+    unfulfilled_capabilities: string[];
+    discovery_duration_ms: number;
+    cache_hit?: boolean;
+}
+/**
+ * Sync operation event
+ */
+export interface SyncEvent extends BaseTelemetryEvent {
+    event_type: 'sync';
+    files_processed: number;
+    changes_detected: number;
+    files_written: number;
+    errors: number;
+}
+/**
+ * CLI command event
+ */
+export interface CLIEvent extends BaseTelemetryEvent {
+    event_type: 'cli';
+    command: string;
+    subcommand?: string;
+    options?: Record<string, unknown>;
+    result?: {
+        skills_synced?: number;
+        agents_synced?: number;
+        errors?: number;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Integration operation event (Jira, Confluence, etc.)
+ */
+export interface IntegrationEvent extends BaseTelemetryEvent {
+    event_type: 'integration';
+    integration_type: 'jira' | 'confluence';
+    items_processed?: number;
+    api_calls?: number;
+    retries?: number;
+    rate_limit_hits?: number;
+}
+/**
+ * Validation event
+ */
+export interface ValidationEvent extends BaseTelemetryEvent {
+    event_type: 'validation';
+    validator_type: string;
+    items_validated: number;
+    errors_found: number;
+    warnings_found: number;
+}
+/**
+ * MCP operation event
+ */
+export interface MCPEvent extends BaseTelemetryEvent {
+    event_type: 'mcp';
+    /** MCP architecture layer: 1=Reference MCPs, 2=CLI tools, 3=Dynamic discovery, 3b=Web */
+    layer: '1' | '2' | '3' | '3b';
+    operation_type: 'mcp-find' | 'mcp-add' | 'mcp-exec' | 'mcp-remove' | 'mcp-config-set' | 'tool-call';
+    /** MCP server name (e.g., 'MCP_DOCKER', 'graphiti', 'jetbrains') */
+    server_name?: string;
+    /** Tool name (e.g., 'agentic_init', 'search_memory_facts') */
+    tool_name?: string;
+    /** Sanitized arguments (secrets removed) */
+    arguments?: Record<string, unknown>;
+    /** Token usage metrics */
+    token_usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+    /** Estimated cost in USD */
+    cost_usd?: number;
+    /** Operation result */
+    result?: {
+        success: boolean;
+        items_returned?: number;
+        error_code?: string;
+    };
+}
+/**
+ * Claude Agent/Command execution event
+ */
+export interface AgentEvent extends BaseTelemetryEvent {
+    event_type: 'agent';
+    /** Type of execution: 'command', 'agent', 'subagent' */
+    execution_type: 'command' | 'agent' | 'subagent';
+    /** Name of the command/agent executed (e.g., '/ai-architect', 'ai-app-developer-slim') */
+    name: string;
+    /** Parent agent ID if this is a subagent */
+    parent_agent_id?: string;
+    /** Subagent type if spawned via Task tool */
+    subagent_type?: string;
+    /** Model used (e.g., 'opus', 'sonnet', 'haiku') */
+    model?: string;
+    /** Prompt/task provided to the agent */
+    prompt?: string;
+    /** Token usage metrics */
+    token_usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+    /** Estimated cost in USD */
+    cost_usd?: number;
+    /** Execution result */
+    result?: {
+        success: boolean;
+        output_summary?: string;
+        error_code?: string;
+    };
+}
+/**
+ * Union type of all telemetry events
+ */
+export type TelemetryEvent = DiscoveryEvent | SyncEvent | CLIEvent | IntegrationEvent | ValidationEvent | MCPEvent | AgentEvent;
+/**
+ * JSON file exporter configuration
+ */
+export interface JsonFileExporterConfig {
+    enabled: boolean;
+    path: string;
+    maxSize: string;
+    rotation: 'daily' | 'size' | 'none';
+}
+/**
+ * Session file exporter configuration
+ * Creates separate log files per session for easy parallel run distinction
+ */
+export interface SessionFileExporterConfig {
+    enabled: boolean;
+    /** Directory for session log files */
+    directory: string;
+    /** Maximum number of session files to keep */
+    maxFiles: number;
+    /** Maximum age of session files in days */
+    maxAgeDays: number;
+}
+/**
+ * OpenTelemetry exporter configuration
+ */
+export interface OtelExporterConfig {
+    enabled: boolean;
+    endpoint: string;
+    serviceName: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Console exporter configuration
+ */
+export interface ConsoleExporterConfig {
+    enabled: boolean;
+    pretty: boolean;
+    level: TelemetryLevel;
+    colors: boolean;
+}
+/**
+ * Instrumentation configuration
+ */
+export interface InstrumentationConfig {
+    discovery: boolean;
+    sync: boolean;
+    cli: boolean;
+    integrations?: boolean;
+    validator?: boolean;
+    mcp?: boolean;
+    agent?: boolean;
+}
+/**
+ * Session configuration
+ */
+export interface SessionConfig {
+    /** Enable session tracking */
+    enabled: boolean;
+    /** Include machine identifier in session context */
+    includeMachineId: boolean;
+}
+/**
+ * Complete telemetry configuration
+ */
+export interface TelemetryConfig {
+    enabled: boolean;
+    level: TelemetryLevel;
+    session: SessionConfig;
+    exporters: {
+        jsonFile: JsonFileExporterConfig;
+        sessionFile: SessionFileExporterConfig;
+        otel: OtelExporterConfig;
+        console: ConsoleExporterConfig;
+    };
+    instrumentation: InstrumentationConfig;
+}
+/**
+ * Telemetry exporter interface
+ */
+export interface TelemetryExporter {
+    export(event: TelemetryEvent): Promise<void>;
+    flush?(): Promise<void>;
+    shutdown?(): Promise<void>;
+}
+/**
+ * Span attributes for OpenTelemetry
+ * Includes OpenTelemetry GenAI Semantic Conventions v1.37+
+ */
+export interface SpanAttributes {
+    'gen_ai.system'?: string;
+    'gen_ai.request.model'?: string;
+    'gen_ai.response.finish_reasons'?: string[];
+    'gen_ai.usage.input_tokens'?: number;
+    'gen_ai.usage.output_tokens'?: number;
+    'gen_ai.usage.total_tokens'?: number;
+    'gen_ai.response.id'?: string;
+    'gen_ai.prompt'?: string;
+    'gen_ai.operation.name'?: string;
+    'gen_ai.agent.id'?: string;
+    'gen_ai.agent.variant'?: 'full' | 'slim';
+    'gen_ai.capability'?: string;
+    'gen_ai.skill.id'?: string;
+    'gen_ai.context.level'?: 'basic' | 'advanced' | 'expert';
+    'mcp.layer'?: '1' | '2' | '3' | '3b';
+    'mcp.server.name'?: string;
+    'mcp.tool.name'?: string;
+    'mcp.operation.type'?: string;
+    'framework.module'?: string;
+    'framework.operation'?: string;
+    'framework.version'?: string;
+    'cli.command'?: string;
+    'cli.subcommand'?: string;
+    'integration.type'?: 'jira' | 'confluence';
+    'integration.operation'?: string;
+    [key: string]: string | number | boolean | string[] | undefined;
+}
+/**
+ * Telemetry span interface
+ */
+export interface TelemetrySpan {
+    end(): void;
+    recordException(error: Error): void;
+    setAttribute(key: string, value: string | number | boolean): void;
+    setAttributes(attributes: SpanAttributes): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/telemetry/types.d.ts.map

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

package/dist/lib/telemetry/types.js

@@ -0,0 +1,6 @@
+/**
+ * Telemetry Types
+ * TypeScript interfaces for telemetry events, configuration, and exporters
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/telemetry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/telemetry/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/lib/template-engine.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Copy context templates to project
+ */
+export declare function copyTemplates(projectPath: string, templateName: string): Promise<void>;
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/lib/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/lib/template-engine.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/lib/template-engine.js

@@ -0,0 +1,294 @@
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Copy context templates to project
+ */
+export async function copyTemplates(projectPath, templateName) {
+    const contextPath = path.join(projectPath, 'ai', 'context');
+    await fs.ensureDir(contextPath);
+    // Create business context template
+    await fs.writeFile(path.join(contextPath, 'business-basic.md'), createBusinessTemplate(templateName));
+    // Create technical context template
+    await fs.writeFile(path.join(contextPath, 'technical-basic.md'), createTechnicalTemplate(templateName));
+    // Create process context template
+    await fs.writeFile(path.join(contextPath, 'process-basic.md'), createProcessTemplate(templateName));
+}
+function createBusinessTemplate(templateName) {
+    if (templateName === 'minimal') {
+        return `# Business Context (Basic)
+
+<!-- TEMPLATE: Fill in your project's business context -->
+
+## Product Overview
+
+<!-- TEMPLATE: What does your product do? Who is it for? -->
+
+## User Roles
+
+<!-- TEMPLATE: List primary user personas and their needs -->
+
+## Key Features
+
+<!-- TEMPLATE: List main features and capabilities -->
+`;
+    }
+    // Full template
+    return `# Business Context (Basic)
+
+## Product Overview
+
+<!-- TEMPLATE: Describe your product's core purpose and value proposition -->
+
+**Product Name:** [Your Product Name]
+
+**Description:**
+[Brief description of what your product does and the problem it solves]
+
+**Target Users:**
+[Who are the primary users of this product?]
+
+---
+
+## User Roles
+
+### Role 1: [Role Name]
+<!-- TEMPLATE: Describe this user role -->
+
+**Responsibilities:**
+- [Responsibility 1]
+- [Responsibility 2]
+
+**Primary Goals:**
+- [Goal 1]
+- [Goal 2]
+
+---
+
+### Role 2: [Role Name]
+<!-- TEMPLATE: Describe this user role -->
+
+**Responsibilities:**
+- [Responsibility 1]
+- [Responsibility 2]
+
+**Primary Goals:**
+- [Goal 1]
+- [Goal 2]
+
+---
+
+## Key Features
+
+### Feature 1: [Feature Name]
+<!-- TEMPLATE: Describe this feature -->
+
+**Description:** [What does this feature do?]
+
+**User Value:** [Why is this valuable to users?]
+
+---
+
+### Feature 2: [Feature Name]
+<!-- TEMPLATE: Describe this feature -->
+
+**Description:** [What does this feature do?]
+
+**User Value:** [Why is this valuable to users?]
+
+---
+
+## Business Rules
+
+<!-- TEMPLATE: Document important business rules and constraints -->
+
+1. [Business Rule 1]
+2. [Business Rule 2]
+3. [Business Rule 3]
+`;
+}
+function createTechnicalTemplate(templateName) {
+    if (templateName === 'minimal') {
+        return `# Technical Context (Basic)
+
+<!-- TEMPLATE: Fill in your project's technical context -->
+
+## Tech Stack
+
+<!-- TEMPLATE: List technologies used -->
+
+## Architecture Overview
+
+<!-- TEMPLATE: Describe high-level architecture -->
+
+## Key Patterns
+
+<!-- TEMPLATE: Document important patterns and conventions -->
+`;
+    }
+    // Full template
+    return `# Technical Context (Basic)
+
+## Tech Stack
+
+### Frontend
+<!-- TEMPLATE: Describe frontend technologies -->
+
+- **Framework:** [React/Vue/Angular/etc.]
+- **Language:** [TypeScript/JavaScript]
+- **State Management:** [Redux/Zustand/etc.]
+- **Styling:** [Tailwind/CSS Modules/etc.]
+
+### Backend
+<!-- TEMPLATE: Describe backend technologies -->
+
+- **Framework:** [NestJS/Express/Django/etc.]
+- **Language:** [TypeScript/Python/Go/etc.]
+- **Database:** [PostgreSQL/MongoDB/etc.]
+- **API Style:** [REST/GraphQL/gRPC]
+
+### Infrastructure
+<!-- TEMPLATE: Describe infrastructure -->
+
+- **Cloud Provider:** [AWS/GCP/Azure]
+- **Containerization:** [Docker/Kubernetes]
+- **CI/CD:** [GitHub Actions/Jenkins/etc.]
+
+---
+
+## Architecture Overview
+
+<!-- TEMPLATE: Describe your system architecture -->
+
+### System Diagram
+
+\`\`\`
+[Draw or describe your architecture here]
+\`\`\`
+
+### Key Components
+
+1. **[Component 1]:** [Description]
+2. **[Component 2]:** [Description]
+3. **[Component 3]:** [Description]
+
+---
+
+## Key Patterns
+
+### Code Organization
+<!-- TEMPLATE: Describe code organization patterns -->
+
+- [Pattern 1]
+- [Pattern 2]
+
+### Error Handling
+<!-- TEMPLATE: Describe error handling approach -->
+
+### Testing Strategy
+<!-- TEMPLATE: Describe testing approach -->
+
+- Unit Tests: [Coverage/approach]
+- Integration Tests: [Coverage/approach]
+- E2E Tests: [Coverage/approach]
+
+---
+
+## Repository Structure
+
+\`\`\`
+<!-- TEMPLATE: Show your repository structure -->
+project/
+├── src/
+├── tests/
+└── docs/
+\`\`\`
+`;
+}
+function createProcessTemplate(templateName) {
+    if (templateName === 'minimal') {
+        return `# Process Context (Basic)
+
+<!-- TEMPLATE: Fill in your project's process context -->
+
+## Development Workflow
+
+<!-- TEMPLATE: Describe development process -->
+
+## Team Structure
+
+<!-- TEMPLATE: Describe team organization -->
+
+## Release Process
+
+<!-- TEMPLATE: Describe release workflow -->
+`;
+    }
+    // Full template
+    return `# Process Context (Basic)
+
+## Development Workflow
+
+### Branching Strategy
+<!-- TEMPLATE: Describe your git workflow -->
+
+- **Main Branch:** [main/master]
+- **Feature Branches:** [naming convention]
+- **Release Branches:** [naming convention]
+
+### Code Review Process
+<!-- TEMPLATE: Describe code review -->
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+### Definition of Done
+<!-- TEMPLATE: What must be true before a task is complete? -->
+
+- [ ] Code reviewed and approved
+- [ ] Tests passing
+- [ ] Documentation updated
+- [ ] [Other criteria]
+
+---
+
+## Team Structure
+
+### Roles
+<!-- TEMPLATE: Describe team roles -->
+
+- **[Role 1]:** [Responsibilities]
+- **[Role 2]:** [Responsibilities]
+
+### Communication
+<!-- TEMPLATE: Describe communication channels -->
+
+- Daily standups: [Time/platform]
+- Sprint planning: [Cadence]
+- Retrospectives: [Cadence]
+
+---
+
+## Release Process
+
+### Release Cadence
+<!-- TEMPLATE: How often do you release? -->
+
+[Weekly/bi-weekly/continuous]
+
+### Release Steps
+<!-- TEMPLATE: Describe release process -->
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+### Environments
+<!-- TEMPLATE: Describe deployment environments -->
+
+- Development: [URL/description]
+- Staging: [URL/description]
+- Production: [URL/description]
+`;
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/lib/template-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../src/lib/template-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEhC,mCAAmC;IACnC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,EAC3C,sBAAsB,CAAC,YAAY,CAAC,CACrC,CAAC;IAEF,oCAAoC;IACpC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,EAC5C,uBAAuB,CAAC,YAAY,CAAC,CACtC,CAAC;IAEF,kCAAkC;IAClC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,EAC1C,qBAAqB,CAAC,YAAY,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,YAAoB;IAClD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;;;;;;;;;;;;;;;CAeV,CAAC;IACA,CAAC;IAED,gBAAgB;IAChB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuER,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB,CAAC,YAAoB;IACnD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;;;;;;;;;;;;;;;CAeV,CAAC;IACA,CAAC;IAED,gBAAgB;IAChB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ER,CAAC;AACF,CAAC;AAED,SAAS,qBAAqB,CAAC,YAAoB;IACjD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;;;;;;;;;;;;;;;CAeV,CAAC;IACA,CAAC;IAED,gBAAgB;IAChB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiER,CAAC;AACF,CAAC"}

package/dist/lib/unified-template-engine/computed-variables.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Computed Variables
+ *
+ * Functions for generating computed template variables (date, number, uuid, user).
+ */
+import type { ComputedVariable } from './types.js';
+/**
+ * Get current date in ISO format (YYYY-MM-DD)
+ */
+export declare function getDate(): string;
+/**
+ * Get current datetime in ISO format
+ */
+export declare function getDatetime(): string;
+/**
+ * Get current year
+ */
+export declare function getYear(): string;
+/**
+ * Generate a random UUID
+ */
+export declare function getUuid(): string;
+/**
+ * Get current git user name (or fallback to system user)
+ */
+export declare function getUser(): string;
+/**
+ * Compute all computed variables based on the list provided
+ */
+export declare function computeVariables(computedList: ComputedVariable[], _options?: {
+    numberingDirectory?: string;
+    getNextNumber?: () => Promise<number>;
+}): Record<string, string>;
+/**
+ * Format a number with zero-padding
+ */
+export declare function formatNumber(num: number, padding: number): string;
+//# sourceMappingURL=computed-variables.d.ts.map

package/dist/lib/unified-template-engine/computed-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-variables.d.ts","sourceRoot":"","sources":["../../../src/lib/unified-template-engine/computed-variables.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAYhC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,gBAAgB,EAAE,EAChC,QAAQ,CAAC,EAAE;IACT,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC,GACA,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE"}