@klitchevo/code-council 0.0.16 → 0.1.1

package/dist/chunk-YLBGX3Y3.js

@@ -0,0 +1,110 @@
+import {
+  init_esm_shims
+} from "./chunk-W4FYPS5Z.js";
+
+// src/config/loader.ts
+init_esm_shims();
+import { existsSync } from "fs";
+import { join } from "path";
+import { createJiti } from "jiti";
+
+// src/config/schema.ts
+init_esm_shims();
+import { z } from "zod";
+var modelArraySchema = z.array(z.string().min(1)).optional().describe("Array of OpenRouter model IDs");
+var ModelsConfigSchema = z.object({
+  defaultModels: modelArraySchema,
+  codeReview: modelArraySchema,
+  frontendReview: modelArraySchema,
+  backendReview: modelArraySchema,
+  planReview: modelArraySchema,
+  discussion: modelArraySchema,
+  tpsAudit: modelArraySchema
+}).optional();
+var ConsensusConfigSchema = z.object({
+  enabled: z.boolean().optional(),
+  modelWeights: z.record(z.string(), z.number().positive()).optional(),
+  highConfidenceThreshold: z.number().min(0).max(1).optional(),
+  moderateConfidenceThreshold: z.number().min(0).max(1).optional(),
+  extractionModel: z.string().min(1).optional(),
+  fallbackOnError: z.boolean().optional(),
+  hostExtraction: z.boolean().optional()
+}).optional();
+var LLMConfigSchema = z.object({
+  temperature: z.number().min(0).max(2).optional(),
+  maxTokens: z.number().int().positive().optional()
+}).optional();
+var SessionConfigSchema = z.object({
+  maxSessions: z.number().int().positive().optional(),
+  maxMessagesPerModel: z.number().int().positive().optional(),
+  ttlMs: z.number().int().positive().optional(),
+  rateLimitPerMinute: z.number().int().positive().optional()
+}).optional();
+var InputLimitsConfigSchema = z.object({
+  maxCodeLength: z.number().int().positive().optional(),
+  maxContextLength: z.number().int().positive().optional(),
+  maxModels: z.number().int().positive().optional()
+}).optional();
+var CodeCouncilConfigSchema = z.object({
+  models: ModelsConfigSchema,
+  consensus: ConsensusConfigSchema,
+  llm: LLMConfigSchema,
+  session: SessionConfigSchema,
+  inputLimits: InputLimitsConfigSchema
+});
+
+// src/config/loader.ts
+var CONFIG_LOCATIONS = [
+  ".code-council/config.ts",
+  ".code-council/config.js",
+  "code-council.config.ts",
+  "code-council.config.js"
+];
+function findConfigFile(cwd = process.cwd()) {
+  for (const location of CONFIG_LOCATIONS) {
+    const fullPath = join(cwd, location);
+    if (existsSync(fullPath)) {
+      return fullPath;
+    }
+  }
+  return null;
+}
+async function loadConfigFile(configPath) {
+  const jiti = createJiti(import.meta.url, {
+    interopDefault: true
+  });
+  const loaded = await jiti.import(configPath);
+  const rawConfig = loaded.default ?? loaded;
+  const result = CodeCouncilConfigSchema.safeParse(rawConfig);
+  if (!result.success) {
+    const errors = result.error.issues.map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`).join("\n");
+    throw new Error(`Invalid configuration in ${configPath}:
+${errors}`);
+  }
+  return result.data;
+}
+async function loadConfig(cwd = process.cwd()) {
+  const configPath = findConfigFile(cwd);
+  if (!configPath) {
+    return { config: {}, configPath: null };
+  }
+  const config = await loadConfigFile(configPath);
+  return { config, configPath };
+}
+function hasConfigFile(cwd = process.cwd()) {
+  return findConfigFile(cwd) !== null;
+}
+
+export {
+  ModelsConfigSchema,
+  ConsensusConfigSchema,
+  LLMConfigSchema,
+  SessionConfigSchema,
+  InputLimitsConfigSchema,
+  CodeCouncilConfigSchema,
+  findConfigFile,
+  loadConfigFile,
+  loadConfig,
+  hasConfigFile
+};
+//# sourceMappingURL=chunk-YLBGX3Y3.js.map

package/dist/config/index.d.ts

@@ -0,0 +1,351 @@
+import { z } from 'zod';
+
+/**
+ * TypeScript configuration interfaces for Code Council
+ *
+ * These types provide full autocompletion support when using defineConfig()
+ */
+/**
+ * Known OpenRouter model IDs for autocomplete.
+ * This is not exhaustive - any valid OpenRouter model ID string will work.
+ *
+ * Find all models at: https://openrouter.ai/models
+ */
+type KnownModel = "anthropic/claude-opus-4" | "anthropic/claude-opus-4.5" | "anthropic/claude-sonnet-4" | "anthropic/claude-sonnet-4.5" | "anthropic/claude-haiku-4" | "anthropic/claude-haiku-4.5" | "anthropic/claude-3.5-sonnet" | "anthropic/claude-3.5-haiku" | "anthropic/claude-3-opus" | "anthropic/claude-3-sonnet" | "anthropic/claude-3-haiku" | "openai/gpt-4o" | "openai/gpt-4o-mini" | "openai/gpt-4-turbo" | "openai/gpt-4" | "openai/gpt-3.5-turbo" | "openai/o1" | "openai/o1-mini" | "openai/o1-preview" | "openai/o3" | "openai/o3-mini" | "openai/gpt-5" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.0-pro" | "google/gemini-2.0-flash" | "google/gemini-2.0-flash-001" | "google/gemini-pro" | "google/gemini-pro-vision" | "google/gemini-3-pro-preview" | "google/gemini-3-flash-preview" | "meta-llama/llama-3.3-70b-instruct" | "meta-llama/llama-3.2-90b-vision-instruct" | "meta-llama/llama-3.2-11b-vision-instruct" | "meta-llama/llama-3.1-405b-instruct" | "meta-llama/llama-3.1-70b-instruct" | "meta-llama/llama-3.1-8b-instruct" | "meta-llama/llama-4-maverick" | "meta-llama/llama-4-scout" | "mistralai/mistral-large" | "mistralai/mistral-large-2512" | "mistralai/mistral-medium" | "mistralai/mistral-small" | "mistralai/mistral-small-creative" | "mistralai/mixtral-8x7b-instruct" | "mistralai/mixtral-8x22b-instruct" | "mistralai/codestral" | "mistralai/devstral-2512" | "deepseek/deepseek-chat" | "deepseek/deepseek-coder" | "deepseek/deepseek-r1" | "deepseek/deepseek-v3" | "deepseek/deepseek-v3.1" | "deepseek/deepseek-v3.2" | "qwen/qwen-2.5-72b-instruct" | "qwen/qwen-2.5-coder-32b-instruct" | "qwen/qwen-2-72b-instruct" | "qwen/qwq-32b" | "qwen/qwen3-vl-32b-instruct" | "x-ai/grok-2" | "x-ai/grok-2-vision" | "x-ai/grok-3" | "x-ai/grok-4" | "x-ai/grok-4.1-fast" | "amazon/nova-pro-v1" | "amazon/nova-lite-v1" | "amazon/nova-micro-v1" | "amazon/nova-premier-v1" | "amazon/nova-2-lite-v1" | "cohere/command-r-plus" | "cohere/command-r" | "cohere/command" | "minimax/minimax-m2" | "minimax/minimax-m2.1" | "z-ai/glm-4.7" | "moonshotai/kimi-k2-thinking" | "perplexity/sonar-pro" | "perplexity/sonar-pro-search" | "nvidia/nemotron-3-nano-30b-a3b";
+/**
+ * Model identifier - accepts known models for autocomplete, but any string is valid
+ */
+type ModelId = KnownModel | (string & {});
+/**
+ * Models configuration - arrays of OpenRouter model IDs
+ *
+ * Use `defaultModels` to set models for all review types at once,
+ * or specify individual arrays to override for specific types.
+ *
+ * Find models at: https://openrouter.ai/models
+ *
+ * @example
+ * ```typescript
+ * // Use same models for everything
+ * models: {
+ *   defaultModels: ["anthropic/claude-sonnet-4", "openai/gpt-4o"],
+ * }
+ *
+ * // Or customize per review type
+ * models: {
+ *   defaultModels: ["anthropic/claude-sonnet-4"],
+ *   frontendReview: ["anthropic/claude-sonnet-4", "openai/gpt-4o"],
+ * }
+ * ```
+ */
+interface ModelsConfig {
+    /**
+     * Default models used for all review types.
+     * Individual review type arrays override this for that specific type.
+     */
+    defaultModels?: ModelId[];
+    /** Models for general code review (overrides defaultModels) */
+    codeReview?: ModelId[];
+    /** Models for frontend-specific review (overrides defaultModels) */
+    frontendReview?: ModelId[];
+    /** Models for backend-specific review (overrides defaultModels) */
+    backendReview?: ModelId[];
+    /** Models for implementation plan review (overrides defaultModels) */
+    planReview?: ModelId[];
+    /** Models for council discussions (overrides defaultModels) */
+    discussion?: ModelId[];
+    /** Models for TPS audits (overrides defaultModels) */
+    tpsAudit?: ModelId[];
+}
+/**
+ * Consensus analysis configuration
+ */
+interface ConsensusConfig {
+    /**
+     * @deprecated This option is ignored. All review tools now use host extraction
+     * by default, which provides consensus-formatted output without additional API calls.
+     * This setting is kept for backwards compatibility but will be removed in a future version.
+     */
+    enabled?: boolean;
+    /** Custom model weights for scoring (default: equal weights) */
+    modelWeights?: Record<string, number>;
+    /** High confidence threshold (default: 0.8) */
+    highConfidenceThreshold?: number;
+    /** Moderate confidence threshold (default: 0.5) */
+    moderateConfidenceThreshold?: number;
+    /**
+     * Model used for finding extraction when hostExtraction is false.
+     * @deprecated Host extraction is now the default. This is only used if you explicitly
+     * disable host extraction, which is not recommended.
+     */
+    extractionModel?: ModelId;
+    /** Fall back to raw reviews if consensus fails (default: true) */
+    fallbackOnError?: boolean;
+    /**
+     * Let the MCP host model do extraction instead of making API calls.
+     * When true (default), returns raw reviews formatted for the host
+     * model to analyze. This is the recommended approach since the host
+     * model (e.g., Claude) can do the extraction work itself without
+     * additional API calls.
+     *
+     * This is now always true by default for all review tools.
+     */
+    hostExtraction?: boolean;
+}
+/**
+ * LLM behavior configuration
+ */
+interface LLMConfig {
+    /** Temperature for responses (default: 0.3) */
+    temperature?: number;
+    /** Maximum tokens for responses (default: 16384) */
+    maxTokens?: number;
+}
+/**
+ * Session limits for multi-turn discussions
+ */
+interface SessionConfig {
+    /** Maximum concurrent sessions (default: 100) */
+    maxSessions?: number;
+    /** Maximum messages per model (default: 50) */
+    maxMessagesPerModel?: number;
+    /** Session TTL in milliseconds (default: 30 min) */
+    ttlMs?: number;
+    /** Rate limit per minute (default: 10) */
+    rateLimitPerMinute?: number;
+}
+/**
+ * Input limits for safety
+ */
+interface InputLimitsConfig {
+    /** Maximum code length in characters (default: 100KB) */
+    maxCodeLength?: number;
+    /** Maximum context length (default: 5KB) */
+    maxContextLength?: number;
+    /** Maximum number of parallel models (default: 10) */
+    maxModels?: number;
+}
+/**
+ * Complete code-council configuration
+ *
+ * @example
+ * ```typescript
+ * import { defineConfig } from "@klitchevo/code-council/config";
+ *
+ * // Simple: use same models for all review types
+ * export default defineConfig({
+ *   models: {
+ *     defaultModels: ["anthropic/claude-sonnet-4", "openai/gpt-4o"],
+ *   },
+ * });
+ *
+ * // Advanced: customize models per review type
+ * export default defineConfig({
+ *   models: {
+ *     defaultModels: ["anthropic/claude-sonnet-4"],
+ *     frontendReview: ["anthropic/claude-sonnet-4", "openai/gpt-4o"],
+ *     backendReview: ["deepseek/deepseek-v3.2", "openai/gpt-4o"],
+ *   },
+ *   consensus: {
+ *     enabled: true,
+ *     highConfidenceThreshold: 0.8,
+ *   },
+ * });
+ * ```
+ */
+interface CodeCouncilConfig {
+    /** Model configurations for different review types */
+    models?: ModelsConfig;
+    /** Consensus analysis settings */
+    consensus?: ConsensusConfig;
+    /** LLM behavior settings */
+    llm?: LLMConfig;
+    /** Session management settings */
+    session?: SessionConfig;
+    /** Input limit settings */
+    inputLimits?: InputLimitsConfig;
+}
+
+/**
+ * Helper function for creating code-council configuration with full type support.
+ *
+ * This function provides autocompletion and type checking for your configuration.
+ * It's a no-op at runtime - it simply returns the config object unchanged.
+ *
+ * @example
+ * ```typescript
+ * // .code-council/config.ts
+ * import { defineConfig } from "@klitchevo/code-council/config";
+ *
+ * export default defineConfig({
+ *   models: {
+ *     codeReview: ["anthropic/claude-sonnet-4", "openai/gpt-4o"],
+ *     frontendReview: ["anthropic/claude-sonnet-4"],
+ *   },
+ *   consensus: {
+ *     enabled: true,
+ *     modelWeights: { "anthropic/claude-sonnet-4": 1.2 },
+ *     highConfidenceThreshold: 0.8,
+ *   },
+ *   llm: {
+ *     temperature: 0.3,
+ *     maxTokens: 16384,
+ *   },
+ * });
+ * ```
+ *
+ * @param config - The configuration object
+ * @returns The same configuration object (identity function for type inference)
+ */
+declare function defineConfig(config: CodeCouncilConfig): CodeCouncilConfig;
+
+/**
+ * Configuration loader for Code Council
+ *
+ * Discovers and loads TypeScript/JavaScript configuration files,
+ * validates them with Zod, and merges with environment variables.
+ */
+
+/**
+ * Result of loading configuration
+ */
+interface LoadConfigResult {
+    /** The validated configuration object */
+    config: CodeCouncilConfig;
+    /** Path to the config file that was loaded, or null if none found */
+    configPath: string | null;
+}
+/**
+ * Discover config file in project
+ *
+ * Searches for configuration files in the following order:
+ * 1. .code-council/config.ts
+ * 2. .code-council/config.js
+ * 3. code-council.config.ts
+ * 4. code-council.config.js
+ *
+ * @param cwd - Directory to search in (defaults to process.cwd())
+ * @returns Full path to config file, or null if not found
+ */
+declare function findConfigFile(cwd?: string): string | null;
+/**
+ * Load configuration from a file
+ *
+ * Uses jiti to load TypeScript files without requiring compilation.
+ *
+ * @param configPath - Path to the configuration file
+ * @returns The loaded and validated configuration
+ * @throws Error if the config file is invalid
+ */
+declare function loadConfigFile(configPath: string): Promise<CodeCouncilConfig>;
+/**
+ * Load configuration from file (if exists)
+ *
+ * This function discovers and loads the configuration file without
+ * merging with environment variables. Use `loadAndMergeConfig` for
+ * the full configuration with env var fallbacks.
+ *
+ * @param cwd - Directory to search in (defaults to process.cwd())
+ * @returns Configuration and the path it was loaded from
+ */
+declare function loadConfig(cwd?: string): Promise<LoadConfigResult>;
+/**
+ * Check if a config file exists in the given directory
+ *
+ * @param cwd - Directory to check
+ * @returns true if a config file exists
+ */
+declare function hasConfigFile(cwd?: string): boolean;
+
+/**
+ * Zod schemas for validating code-council configuration
+ */
+
+/**
+ * Schema for models configuration
+ */
+declare const ModelsConfigSchema: z.ZodOptional<z.ZodObject<{
+    defaultModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    codeReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    frontendReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    backendReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    planReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    discussion: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tpsAudit: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+/**
+ * Schema for consensus configuration
+ */
+declare const ConsensusConfigSchema: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    modelWeights: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    highConfidenceThreshold: z.ZodOptional<z.ZodNumber>;
+    moderateConfidenceThreshold: z.ZodOptional<z.ZodNumber>;
+    extractionModel: z.ZodOptional<z.ZodString>;
+    fallbackOnError: z.ZodOptional<z.ZodBoolean>;
+    hostExtraction: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>;
+/**
+ * Schema for LLM configuration
+ */
+declare const LLMConfigSchema: z.ZodOptional<z.ZodObject<{
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Schema for session configuration
+ */
+declare const SessionConfigSchema: z.ZodOptional<z.ZodObject<{
+    maxSessions: z.ZodOptional<z.ZodNumber>;
+    maxMessagesPerModel: z.ZodOptional<z.ZodNumber>;
+    ttlMs: z.ZodOptional<z.ZodNumber>;
+    rateLimitPerMinute: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Schema for input limits configuration
+ */
+declare const InputLimitsConfigSchema: z.ZodOptional<z.ZodObject<{
+    maxCodeLength: z.ZodOptional<z.ZodNumber>;
+    maxContextLength: z.ZodOptional<z.ZodNumber>;
+    maxModels: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Complete schema for code-council configuration
+ */
+declare const CodeCouncilConfigSchema: z.ZodObject<{
+    models: z.ZodOptional<z.ZodObject<{
+        defaultModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        codeReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        frontendReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        backendReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        planReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        discussion: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        tpsAudit: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    consensus: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        modelWeights: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        highConfidenceThreshold: z.ZodOptional<z.ZodNumber>;
+        moderateConfidenceThreshold: z.ZodOptional<z.ZodNumber>;
+        extractionModel: z.ZodOptional<z.ZodString>;
+        fallbackOnError: z.ZodOptional<z.ZodBoolean>;
+        hostExtraction: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    llm: z.ZodOptional<z.ZodObject<{
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    session: z.ZodOptional<z.ZodObject<{
+        maxSessions: z.ZodOptional<z.ZodNumber>;
+        maxMessagesPerModel: z.ZodOptional<z.ZodNumber>;
+        ttlMs: z.ZodOptional<z.ZodNumber>;
+        rateLimitPerMinute: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    inputLimits: z.ZodOptional<z.ZodObject<{
+        maxCodeLength: z.ZodOptional<z.ZodNumber>;
+        maxContextLength: z.ZodOptional<z.ZodNumber>;
+        maxModels: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+export { type CodeCouncilConfig, CodeCouncilConfigSchema, type ConsensusConfig, ConsensusConfigSchema, type InputLimitsConfig, InputLimitsConfigSchema, type KnownModel, type LLMConfig, LLMConfigSchema, type LoadConfigResult, type ModelId, type ModelsConfig, ModelsConfigSchema, type SessionConfig, SessionConfigSchema, defineConfig, findConfigFile, hasConfigFile, loadConfig, loadConfigFile };

package/dist/config/index.js

@@ -0,0 +1,38 @@
+import {
+  CodeCouncilConfigSchema,
+  ConsensusConfigSchema,
+  InputLimitsConfigSchema,
+  LLMConfigSchema,
+  ModelsConfigSchema,
+  SessionConfigSchema,
+  findConfigFile,
+  hasConfigFile,
+  loadConfig,
+  loadConfigFile
+} from "../chunk-YLBGX3Y3.js";
+import {
+  init_esm_shims
+} from "../chunk-W4FYPS5Z.js";
+
+// src/config/index.ts
+init_esm_shims();
+
+// src/config/define-config.ts
+init_esm_shims();
+function defineConfig(config) {
+  return config;
+}
+export {
+  CodeCouncilConfigSchema,
+  ConsensusConfigSchema,
+  InputLimitsConfigSchema,
+  LLMConfigSchema,
+  ModelsConfigSchema,
+  SessionConfigSchema,
+  defineConfig,
+  findConfigFile,
+  hasConfigFile,
+  loadConfig,
+  loadConfigFile
+};
+//# sourceMappingURL=index.js.map

package/dist/formatter-ZWJ44CI5.js

@@ -0,0 +1,10 @@
+import {
+  formatReport,
+  init_formatter
+} from "./chunk-JAGOVGRD.js";
+import "./chunk-W4FYPS5Z.js";
+init_formatter();
+export {
+  formatReport
+};
+//# sourceMappingURL=formatter-ZWJ44CI5.js.map