openlore 2.0.0

package/dist/constants.js

@@ -0,0 +1,382 @@
+/**
+ * Shared constants for openlore
+ *
+ * Centralises magic numbers so they're easy to find, reason about, and change.
+ */
+// ============================================================================
+// DIRECTORY / PATH NAMES
+// ============================================================================
+/** Hidden directory where openlore stores its state */
+export const OPENLORE_DIR = '.openlore';
+/** Analysis artifacts sub-directory */
+export const OPENLORE_ANALYSIS_SUBDIR = 'analysis';
+/** LLM log sub-directory */
+export const OPENLORE_LOGS_SUBDIR = 'logs';
+/** Verification reports sub-directory */
+export const OPENLORE_VERIFICATION_SUBDIR = 'verification';
+/** Generation outputs sub-directory */
+export const OPENLORE_OUTPUTS_SUBDIR = 'outputs';
+/** Spec backups sub-directory */
+export const OPENLORE_BACKUPS_SUBDIR = 'backups';
+/** Generation intermediate files sub-directory */
+export const OPENLORE_GENERATION_SUBDIR = 'generation';
+/** Run metadata sub-directory */
+export const OPENLORE_RUNS_SUBDIR = 'runs';
+/** Config file name inside OPENLORE_DIR */
+export const OPENLORE_CONFIG_FILENAME = 'config.json';
+/** Relative path to the openlore config file */
+export const OPENLORE_CONFIG_REL_PATH = `${OPENLORE_DIR}/${OPENLORE_CONFIG_FILENAME}`;
+/** Relative path to the analysis output directory */
+export const OPENLORE_ANALYSIS_REL_PATH = `${OPENLORE_DIR}/${OPENLORE_ANALYSIS_SUBDIR}`;
+/** Default openspec root directory name */
+export const OPENSPEC_DIR = 'openspec';
+/** Default relative path used when creating a new openspec directory */
+export const DEFAULT_OPENSPEC_PATH = './openspec';
+/** Default openspec specs sub-directory */
+export const OPENSPEC_SPECS_SUBDIR = 'specs';
+/** Default openspec decisions sub-directory */
+export const OPENSPEC_DECISIONS_SUBDIR = 'decisions';
+/** Config file name inside the openspec directory */
+export const OPENSPEC_CONFIG_FILENAME = 'config.yaml';
+// ============================================================================
+// ANALYSIS ARTIFACT FILENAMES
+// ============================================================================
+/** Filename for the repository structure artifact */
+export const ARTIFACT_REPO_STRUCTURE = 'repo-structure.json';
+/** Filename for the dependency graph artifact */
+export const ARTIFACT_DEPENDENCY_GRAPH = 'dependency-graph.json';
+/** Filename for the LLM context artifact */
+export const ARTIFACT_LLM_CONTEXT = 'llm-context.json';
+/** Filename for the requirement mapping artifact */
+export const ARTIFACT_MAPPING = 'mapping.json';
+/** Filename for the refactor priorities artifact */
+export const ARTIFACT_REFACTOR_PRIORITIES = 'refactor-priorities.json';
+/** Filename for the content-hash fingerprint used for cache invalidation */
+export const ARTIFACT_FINGERPRINT = 'fingerprint.json';
+/** Filename for the SQLite call-graph edge store */
+export const ARTIFACT_CALL_GRAPH_DB = 'call-graph.db';
+/** Filename for the repository map artifact (saved by RepositoryMapper) */
+export const ARTIFACT_REPOSITORY_MAP = 'repository-map.json';
+/** Filename for the generation report saved to outputs/ */
+export const ARTIFACT_GENERATION_REPORT = 'generation-report.json';
+/** Filename for the shutdown state file */
+export const ARTIFACT_SHUTDOWN_STATE = 'shutdown-state.json';
+export const ARTIFACT_RAG_MANIFEST = 'rag-manifest.json';
+/** Filename for the spec coverage snapshot artifact */
+export const ARTIFACT_SPEC_SNAPSHOT = 'spec-snapshot.json';
+/** Filename for the parity audit report artifact */
+export const ARTIFACT_AUDIT_REPORT = 'audit-report.json';
+/** Filename for the database schema inventory artifact */
+export const ARTIFACT_SCHEMA_INVENTORY = 'schema-inventory.json';
+/** Filename for the API route inventory artifact */
+export const ARTIFACT_ROUTE_INVENTORY = 'route-inventory.json';
+/** Filename for the middleware inventory artifact */
+export const ARTIFACT_MIDDLEWARE_INVENTORY = 'middleware-inventory.json';
+/** Filename for the UI component inventory artifact */
+export const ARTIFACT_UI_INVENTORY = 'ui-inventory.json';
+/** Filename for the environment variable inventory artifact */
+export const ARTIFACT_ENV_INVENTORY = 'env-inventory.json';
+/** Filename for the external package inventory artifact */
+export const ARTIFACT_EXTERNAL_PACKAGES = 'external-packages.json';
+// ============================================================================
+// LLM / PROVIDER LIMITS
+// ============================================================================
+/** Default maximum context window for Claude models (tokens) */
+export const CLAUDE_MAX_CONTEXT_TOKENS = 200_000;
+/** Default maximum context window for Mistral Vibe (tokens) */
+export const MISTRAL_VIBE_MAX_CONTEXT_TOKENS = 128_000;
+/** Default maximum output tokens for Claude models */
+export const CLAUDE_MAX_OUTPUT_TOKENS = 16_000;
+/** Default maximum output tokens for Mistral Vibe */
+export const MISTRAL_VIBE_MAX_OUTPUT_TOKENS = 4_096;
+/** Maximum buffer size for LLM CLI output (bytes) — 50 MB */
+export const LLM_CLI_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
+/** Timeout for LLM CLI calls (ms) — 5 minutes */
+export const LLM_CLI_TIMEOUT_MS = 300_000;
+// ============================================================================
+// ANALYSIS
+// ============================================================================
+/** Default maximum number of files to include in analysis (effectively uncapped) */
+export const DEFAULT_MAX_FILES = 100_000;
+/** Default maximum number of changed files to check in drift detection */
+export const DEFAULT_DRIFT_MAX_FILES = 100;
+/** How old (ms) an analysis can be before being considered stale (1 hour) */
+export const ANALYSIS_STALE_THRESHOLD_MS = 60 * 60 * 1000;
+/** How old (ms) an analysis can be before being re-used in 'run' (1 hour) */
+export const ANALYSIS_REUSE_THRESHOLD_MS = 60 * 60 * 1000;
+/** Grace period after consolidation during which the gate skips the no_decisions_recorded check (1 hour) */
+export const CONSOLIDATION_GRACE_PERIOD_MS = 60 * 60 * 1000;
+/** Canonical gate block reason codes — shared by gate handler, docs, tests, and AGENTS.md */
+export const GATE_REASONS = {
+    VERIFIED: 'verified',
+    APPROVED_NOT_SYNCED: 'approved_not_synced',
+    DRAFTS_PENDING_CONSOLIDATION: 'drafts_pending_consolidation',
+    NO_DECISIONS_RECORDED: 'no_decisions_recorded',
+};
+// ============================================================================
+// VIEWER / SERVER
+// ============================================================================
+/** Default port for the Vite viewer server */
+export const DEFAULT_VIEWER_PORT = 5173;
+/** Default host for the Vite viewer server */
+export const DEFAULT_VIEWER_HOST = '127.0.0.1';
+/** Maximum allowed chat request body size (bytes) — 512 KB */
+export const MAX_CHAT_BODY_BYTES = 512 * 1024;
+/** Maximum search query length (characters) */
+export const MAX_QUERY_LENGTH = 1_000;
+// ============================================================================
+// GENERATION
+// ============================================================================
+/** Estimated system prompt overhead per LLM call (tokens) */
+export const LLM_SYSTEM_PROMPT_OVERHEAD_TOKENS = 500;
+/** Estimated output / input token ratio for spec generation tasks */
+export const GENERATION_OUTPUT_RATIO = 0.4;
+// ============================================================================
+// DEFAULT MODELS (per provider)
+// ============================================================================
+export const DEFAULT_ANTHROPIC_MODEL = 'claude-sonnet-4-20250514';
+export const DEFAULT_OPENAI_MODEL = 'gpt-4o';
+export const DEFAULT_OPENAI_COMPAT_MODEL = 'mistral-large-latest';
+export const DEFAULT_GEMINI_MODEL = 'gemini-2.0-flash';
+export const DEFAULT_COPILOT_MODEL = 'gpt-4o';
+/** Lighter model used for interactive chat (lower cost, faster) */
+export const DEFAULT_CHAT_OPENAI_MODEL = 'gpt-4o-mini';
+// ============================================================================
+// DOCTOR / ENVIRONMENT CHECKS
+// ============================================================================
+/** Minimum Node.js major version required */
+export const MIN_NODE_MAJOR_VERSION = 20;
+/** Analysis age (hours) beyond which doctor warns it may be stale */
+export const ANALYSIS_AGE_WARNING_HOURS = 24;
+/** Minimum available disk space (MB) before doctor reports failure */
+export const MIN_DISK_SPACE_FAIL_MB = 200;
+/** Minimum available disk space (MB) before doctor reports a warning */
+export const MIN_DISK_SPACE_WARN_MB = 500;
+// ============================================================================
+// LLM SERVICE DEFAULTS
+// ============================================================================
+/** Default maximum number of retries for LLM API calls */
+export const DEFAULT_LLM_MAX_RETRIES = 3;
+/** Default initial retry delay (ms) */
+export const DEFAULT_LLM_INITIAL_DELAY_MS = 1_000;
+/** Default maximum retry delay (ms) */
+export const DEFAULT_LLM_MAX_DELAY_MS = 30_000;
+/** Default timeout for LLM API calls (ms) — 2 minutes */
+export const DEFAULT_LLM_TIMEOUT_MS = 120_000;
+/** Default cost warning threshold (USD) */
+export const DEFAULT_LLM_COST_WARNING_THRESHOLD = 10.0;
+/** Fraction of max context tokens at which a warning is emitted */
+export const CONTEXT_LIMIT_WARNING_RATIO = 0.9;
+// ============================================================================
+// DIFF / GIT
+// ============================================================================
+/** Maximum characters of diff content passed to LLM context */
+export const DIFF_MAX_CHARS = 4_000;
+// ============================================================================
+// GENERATION PIPELINE — per-stage LLM output token budgets
+// ============================================================================
+/** Stage 1 (project survey) max output tokens */
+export const STAGE1_MAX_TOKENS = 3_000;
+/** Stage 2 (entity extraction) max output tokens per file chunk */
+export const STAGE2_MAX_TOKENS = 4_000;
+/** Stage 3 (service analysis) max output tokens per file chunk */
+export const STAGE3_MAX_TOKENS = 4_000;
+/** Stage 4 (API extraction) max output tokens per file chunk */
+export const STAGE4_MAX_TOKENS = 4_000;
+/** Stage 5 (architecture synthesis) max output tokens */
+export const STAGE5_MAX_TOKENS = 3_000;
+/** Stage 6 (ADR enrichment) max output tokens */
+export const STAGE6_MAX_TOKENS = 5_000;
+/** Max file content characters passed per chunk to stages 2–4 */
+export const STAGE_CHUNK_MAX_CHARS = 8_000;
+/** Max characters of skeleton excerpt appended to graph prompt */
+export const SKELETON_EXCERPT_MAX_CHARS = 4_000;
+/** Max characters for a standalone skeleton used as fallback for large files without god functions */
+export const SKELETON_STANDALONE_MAX_CHARS = 10_000;
+/** Verification engine: max tokens for file-purpose prediction */
+export const VERIFICATION_PREDICTION_MAX_TOKENS = 1_000;
+/** Drift detector: max tokens for LLM change classification */
+export const DRIFT_CLASSIFICATION_MAX_TOKENS = 200;
+// ============================================================================
+// CHAT AGENT
+// ============================================================================
+/** Max output tokens for chat agent turns (Anthropic) */
+export const CHAT_AGENT_MAX_TOKENS = 4_096;
+/** Characters of API error body included in error messages */
+export const API_ERROR_PREVIEW_LENGTH = 300;
+// ============================================================================
+// ANALYSIS / COST ESTIMATION
+// ============================================================================
+/** Fallback estimated tokens for the project survey phase when not yet computed */
+export const DEFAULT_SURVEY_ESTIMATED_TOKENS = 2_000;
+// ============================================================================
+// REPOSITORY MAPPER — slice limits for summary output
+// ============================================================================
+/** Max high-value files retained after scoring */
+export const HIGH_VALUE_FILES_LIMIT = 50;
+/** Max high-value files shown in text summary */
+export const HIGH_VALUE_FILES_PREVIEW_LIMIT = 20;
+/** Max entry points shown in text summary */
+export const ENTRY_POINTS_PREVIEW_LIMIT = 10;
+/** Max languages shown in text summary */
+export const LANGUAGES_PREVIEW_LIMIT = 10;
+/** Max directories shown in text summary */
+export const DIRECTORIES_PREVIEW_LIMIT = 15;
+// ============================================================================
+// GRAPH ANALYSIS — risk scoring
+// ============================================================================
+/** Risk score weight for fan-in (callers) */
+export const RISK_SCORE_FAN_IN_WEIGHT = 4;
+/** Risk score weight for fan-out (callees) */
+export const RISK_SCORE_FAN_OUT_WEIGHT = 2;
+/** Risk score bonus when the node is a hub */
+export const RISK_SCORE_HUB_BONUS = 20;
+/** Risk score weight for blast radius */
+export const RISK_SCORE_BLAST_RADIUS_WEIGHT = 1.5;
+/** Risk score at or below which a function is considered low-risk */
+export const RISK_SCORE_LOW_THRESHOLD = 20;
+/** Risk score at or below which a function is considered medium-risk */
+export const RISK_SCORE_MEDIUM_THRESHOLD = 45;
+/** Fan-out at or above which a function is treated as a god-function */
+export const GOD_FUNCTION_FAN_OUT_THRESHOLD = 8;
+/** Fan-out threshold for SRP (single-responsibility) refactoring recommendation */
+export const REFACTOR_SRP_FAN_OUT_THRESHOLD = 5;
+/** Maximum fan-in for a node to be a low-risk refactor candidate */
+export const LOW_RISK_MAX_FAN_IN = 2;
+/** Maximum fan-out for a node to be a low-risk refactor candidate */
+export const LOW_RISK_MAX_FAN_OUT = 3;
+/** Default minimum fan-in to be classified as a critical hub */
+export const CRITICAL_HUBS_DEFAULT_MIN_FAN_IN = 3;
+/** Default subgraph traversal depth */
+export const SUBGRAPH_DEFAULT_MAX_DEPTH = 3;
+/** Maximum allowed subgraph traversal depth */
+export const SUBGRAPH_MAX_DEPTH_LIMIT = 20;
+/** Default max depth for trace_execution_path BFS */
+export const TRACE_PATH_DEFAULT_MAX_DEPTH = 6;
+/** Maximum number of paths returned by trace_execution_path */
+export const TRACE_PATH_MAX_PATHS = 10;
+/** Criticality score weight for fan-in */
+export const CRITICALITY_FAN_IN_WEIGHT = 3;
+/** Criticality score weight for fan-out */
+export const CRITICALITY_FAN_OUT_WEIGHT = 1.5;
+/** Criticality score bonus when a node has layer violations */
+export const CRITICALITY_VIOLATION_BONUS = 10;
+/** Fan-in at or above which a hub is treated as heavily depended-upon */
+export const HUB_HIGH_FAN_IN_THRESHOLD = 8;
+/** Fan-out at or above which a hub is treated as an orchestration-heavy god-function */
+export const HUB_HIGH_FAN_OUT_THRESHOLD = 5;
+/** Stability score at or above which a hub can be refactored now */
+export const STABILITY_SCORE_CAN_REFACTOR = 60;
+/** Stability score at or above which a hub can be refactored after stabilising deps */
+export const STABILITY_SCORE_STABILISE_FIRST = 30;
+/** Default number of refactor candidates to return */
+export const LOW_RISK_REFACTOR_CANDIDATES_DEFAULT_LIMIT = 5;
+/** Default number of leaf functions to return */
+export const LEAF_FUNCTIONS_DEFAULT_LIMIT = 20;
+// ============================================================================
+// MAPPING GENERATOR — similarity scoring
+// ============================================================================
+/** Similarity score returned for containment matches (one name includes the other) */
+export const SIMILARITY_CONTAINMENT_SCORE = 0.8;
+/** Weight applied to Jaccard token-overlap similarity */
+export const SIMILARITY_TOKEN_OVERLAP_WEIGHT = 0.7;
+/** Minimum heuristic similarity score to include a function as a candidate match */
+export const HEURISTIC_MATCH_MIN_SCORE = 0.7;
+/** Maximum number of heuristic fallback matches returned per operation */
+export const MAX_HEURISTIC_MATCHES_PER_OP = 2;
+// ============================================================================
+// STAGE 5 — architecture synthesis prompt limits
+// ============================================================================
+/** Max hub functions included in Stage 5 architecture prompt */
+export const STAGE5_HUB_FUNCTIONS_LIMIT = 8;
+/** Max entry points included in Stage 5 architecture prompt */
+export const STAGE5_ENTRY_POINTS_LIMIT = 8;
+/** Max layer violations included in Stage 5 architecture prompt */
+export const STAGE5_VIOLATIONS_LIMIT = 5;
+/** Max refactor priority entries (god functions, cycles, SRP violations) shown to Stage 5 */
+export const STAGE5_REFACTOR_PRIORITIES_LIMIT = 8;
+/** Max dependency cycles shown to Stage 5 */
+export const STAGE5_CYCLES_LIMIT = 3;
+// ============================================================================
+// ARTIFACT GENERATOR
+// ============================================================================
+/** Approximate tokens per character used for LLM context token estimation (~4 chars/token) */
+export const TOKENS_PER_CHAR_DEFAULT = 0.25;
+/** Max characters of file content included per file in Phase 2 (deep analysis) */
+export const PHASE2_FILE_CONTENT_MAX_CHARS = 10_000;
+/** Max characters of file content included per file in Phase 3 (validation) */
+export const PHASE3_FILE_CONTENT_MAX_CHARS = 5_000;
+/** Max files shown in dependency diagram (Mermaid) */
+export const DEPENDENCY_DIAGRAM_MAX_FILES = 30;
+// ============================================================================
+// MCP HANDLERS
+// ============================================================================
+/** Max number of top refactor issues returned by analyze_codebase */
+export const TOP_REFACTOR_ISSUES_LIMIT = 10;
+/** Composite score semantic weight for suggest_insertion_points */
+export const INSERTION_SEMANTIC_WEIGHT = 0.6;
+/** Composite score structural weight for suggest_insertion_points */
+export const INSERTION_STRUCTURAL_WEIGHT = 0.4;
+/** Structural bonus scores per insertion role */
+export const INSERTION_ROLE_BONUS_ENTRY_POINT = 1.0;
+export const INSERTION_ROLE_BONUS_ORCHESTRATOR = 0.8;
+export const INSERTION_ROLE_BONUS_HUB = 0.6;
+export const INSERTION_ROLE_BONUS_INTERNAL = 0.4;
+export const INSERTION_ROLE_BONUS_UTILITY = 0.3;
+/** Fan-out threshold at or above which a node is classified as an orchestrator */
+export const INSERTION_ORCHESTRATOR_FAN_OUT_THRESHOLD = 5;
+// ============================================================================
+// ANALYSIS ARTIFACT — LLM context file selection
+// ============================================================================
+/** Maximum files included in LLM deep analysis phase */
+export const MAX_DEEP_ANALYSIS_FILES = 20;
+/** Fraction of high-value files selected for LLM deep analysis */
+export const DEEP_ANALYSIS_FILE_RATIO = 0.3;
+/** Maximum files included in LLM validation phase */
+export const MAX_VALIDATION_FILES = 5;
+// ============================================================================
+// GENERATE COMMAND
+// ============================================================================
+/** Estimated cost (USD) above which the generate command prompts for confirmation */
+export const COST_CONFIRMATION_THRESHOLD = 0.5;
+// ============================================================================
+// REFACTOR ANALYZER — priority scoring
+// ============================================================================
+/** Base score added for each fan-in/fan-out excess block */
+export const REFACTOR_EXCESS_BASE_SCORE = 2;
+/** Maximum proportional score boost for excess fan-in */
+export const MAX_FAN_IN_SCORE_BOOST = 3;
+/** Maximum proportional score boost for excess fan-out */
+export const MAX_FAN_OUT_SCORE_BOOST = 3;
+/** Base score added for SRP violations */
+export const SRP_BASE_SCORE = 1.5;
+/** Per-requirement penalty above SRP_MAX_REQUIREMENTS */
+export const SRP_PER_REQUIREMENT_PENALTY = 0.5;
+/** Score added for clone group membership */
+export const CLONE_GROUP_MEMBERSHIP_SCORE = 1.5;
+/** Maximum call-graph depth considered "shallow" (bonus for refactoring) */
+export const SHALLOW_FUNCTION_DEPTH_MAX = 2;
+/** Score bonus for shallow functions with issues */
+export const SHALLOW_FUNCTION_SCORE_BONUS = 0.5;
+/** McCabe cyclomatic complexity threshold above which a function is flagged (≥10 = complex) */
+export const HIGH_COMPLEXITY_THRESHOLD = 10;
+/** Base priority score boost for high-complexity functions (scales with excess above threshold) */
+export const HIGH_COMPLEXITY_SCORE_BOOST = 1.5;
+/** Cap on the distance-weighted transitive caller score in detect_changes risk model */
+export const TRANSITIVE_SCORE_MAX = 10;
+// ============================================================================
+// DECISIONS
+// ============================================================================
+/** Sub-directory inside OPENLORE_DIR where pending decisions are stored */
+export const OPENLORE_DECISIONS_SUBDIR = 'decisions';
+/** Filename for the pending decisions store */
+export const DECISIONS_PENDING_FILE = 'pending.json';
+/** Maximum number of changed files passed to the consolidation LLM */
+export const DECISIONS_EXTRACTION_MAX_FILES = 50;
+/** Maximum diff characters fed to the consolidation LLM per file */
+export const DECISIONS_DIFF_MAX_CHARS = 12_000;
+/** Max output tokens for consolidation LLM call */
+export const DECISIONS_CONSOLIDATION_MAX_TOKENS = 2_000;
+/** Max output tokens for verification LLM call */
+export const DECISIONS_VERIFICATION_MAX_TOKENS = 1_500;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/core/analyzer/ai-config-generator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * AI Config File Generator
+ *
+ * Generates tool-specific AI context files during `openlore analyze`:
+ *   - .cursorrules            (Cursor IDE)
+ *   - .clinerules/openlore.md (Cline / Roo Code / Kilocode)
+ *   - CLAUDE.md               (Claude Code)
+ *   - .github/copilot-instructions.md  (GitHub Copilot)
+ *   - .windsurf/rules.md      (Windsurf)
+ *
+ * Files are NEVER overwritten — if a file already exists it is skipped silently.
+ * Returns the list of paths that were actually created.
+ */
+/** Supported AI assistant targets */
+export type AiTool = 'claude' | 'cursor' | 'cline' | 'copilot' | 'windsurf' | 'vibe' | 'agents';
+export interface AiConfigOptions {
+    /** Absolute path to the project root */
+    rootDir: string;
+    /** Relative path to the analysis output directory (e.g. ".openlore/analysis") */
+    analysisDir: string;
+    /** Project name shown in the generated header */
+    projectName: string;
+    /**
+     * Which tools to generate configs for.
+     * Defaults to all tools if omitted.
+     */
+    tools?: AiTool[];
+}
+interface ToolTarget {
+    tool: AiTool;
+    /** Display label shown in the interactive prompt */
+    label: string;
+    /** Relative path from project root */
+    rel: string;
+    /** Use @-import syntax (Claude Code) vs HTML comment */
+    forClaude: boolean;
+}
+export declare const AI_TOOL_TARGETS: ToolTarget[];
+/**
+ * Generate AI tool config files in the project root.
+ * Skips any file that already exists.
+ *
+ * @param options.tools - Which assistants to generate for. Defaults to all.
+ * @returns Relative paths (from rootDir) of files that were actually created.
+ */
+export interface AiConfigResult {
+    /** Relative path from rootDir */
+    rel: string;
+    /** true = created now, false = already existed */
+    created: boolean;
+}
+export declare function generateAiConfigs(options: AiConfigOptions): Promise<AiConfigResult[]>;
+export {};
+//# sourceMappingURL=ai-config-generator.d.ts.map

package/dist/core/analyzer/ai-config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config-generator.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/ai-config-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,qCAAqC;AACrC,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,EAAE,UAAU,EAQvC,CAAC;AAuEF;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAe3F"}

package/dist/core/analyzer/ai-config-generator.js

@@ -0,0 +1,98 @@
+/**
+ * AI Config File Generator
+ *
+ * Generates tool-specific AI context files during `openlore analyze`:
+ *   - .cursorrules            (Cursor IDE)
+ *   - .clinerules/openlore.md (Cline / Roo Code / Kilocode)
+ *   - CLAUDE.md               (Claude Code)
+ *   - .github/copilot-instructions.md  (GitHub Copilot)
+ *   - .windsurf/rules.md      (Windsurf)
+ *
+ * Files are NEVER overwritten — if a file already exists it is skipped silently.
+ * Returns the list of paths that were actually created.
+ */
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileExists } from '../../utils/command-helpers.js';
+export const AI_TOOL_TARGETS = [
+    { tool: 'claude', label: 'Claude Code    (CLAUDE.md)', rel: 'CLAUDE.md', forClaude: true },
+    { tool: 'cursor', label: 'Cursor         (.cursorrules)', rel: '.cursorrules', forClaude: false },
+    { tool: 'cline', label: 'Cline / Roo    (.clinerules/openlore.md)', rel: '.clinerules/openlore.md', forClaude: false },
+    { tool: 'copilot', label: 'GitHub Copilot (.github/copilot-instructions.md)', rel: '.github/copilot-instructions.md', forClaude: false },
+    { tool: 'windsurf', label: 'Windsurf       (.windsurf/rules.md)', rel: '.windsurf/rules.md', forClaude: false },
+    { tool: 'vibe', label: 'Mistral Vibe   (.vibe/skills/openlore.md)', rel: '.vibe/skills/openlore.md', forClaude: false },
+    { tool: 'agents', label: 'OpenAI Codex  (AGENTS.md)', rel: 'AGENTS.md', forClaude: false },
+];
+// ============================================================================
+// TEMPLATE
+// ============================================================================
+const MCP_TOOLS_TABLE = `
+## openlore MCP workflow
+
+**Follow this sequence for every task:**
+
+1. **\`orient "<task description>"\`** — always start here. Returns relevant functions, files, spec domains, call paths, and insertion points in one call.
+2. **If the task involves data models, APIs, or config** — call the relevant inventory tool:
+   \`get_schema_inventory\` · \`get_route_inventory\` · \`get_env_vars\` · \`get_ui_components\` · \`get_middleware_inventory\`
+3. **If debugging a call flow** ("how does X reach Y?") — \`trace_execution_path\`
+4. **Before modifying a function** — \`get_subgraph\` to understand blast radius
+5. **Before opening a PR** — \`check_spec_drift\`
+
+**On-demand** (when orient's results aren't enough):
+\`search_code\` · \`suggest_insertion_points\` · \`get_spec <domain>\` · \`search_specs\` · \`analyze_impact\` · \`get_function_body\` · \`get_function_skeleton\`
+
+## Architectural decisions
+
+When making a significant design choice, call \`record_decision\` **before** writing the code.
+
+Significant choices: data structure, library/dependency, API contract, auth strategy, module boundary, database schema, caching approach, error handling pattern.
+
+\`\`\`
+record_decision({
+  title: "Use JWTs for stateless auth",         // short imperative
+  rationale: "Avoids session store in infra",   // why this choice
+  consequences: "Tokens can't be revoked early", // trade-offs
+  affectedFiles: ["src/auth/middleware.ts"],    // optional
+  supersedes: "a1b2c3d4"                        // 8-char ID of prior decision being reversed
+})
+\`\`\`
+
+Decisions are consolidated in the background immediately after \`record_decision\` is called — the pre-commit gate reads the already-consolidated store and adds no LLM latency.
+
+**Performance note**: if you skip \`record_decision\`, the gate detects unrecorded source changes at commit time and triggers a slow LLM extraction on the *next* commit (~10-30s). Calling \`record_decision\` proactively keeps every commit instant. Do not record trivial choices (variable names, formatting).
+`.trim();
+function buildContent(analysisDir, projectName, forClaude) {
+    const digestRef = forClaude
+        ? `@${analysisDir}/CODEBASE.md`
+        : `<!-- Import or paste ${analysisDir}/CODEBASE.md here for full project context -->`;
+    return [
+        `# ${projectName} — AI context (generated by openlore)`,
+        '',
+        digestRef,
+        '',
+        MCP_TOOLS_TABLE,
+    ].join('\n');
+}
+// ============================================================================
+// HELPERS
+// ============================================================================
+async function writeIfAbsent(filePath, content) {
+    if (await fileExists(filePath))
+        return false;
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, content, 'utf-8');
+    return true;
+}
+export async function generateAiConfigs(options) {
+    const { rootDir, analysisDir, projectName, tools } = options;
+    const targets = tools
+        ? AI_TOOL_TARGETS.filter(t => tools.includes(t.tool))
+        : AI_TOOL_TARGETS;
+    return Promise.all(targets.map(async ({ rel, forClaude }) => {
+        const absPath = join(rootDir, rel);
+        const content = buildContent(analysisDir, projectName, forClaude);
+        const created = await writeIfAbsent(absPath, content);
+        return { rel, created };
+    }));
+}
+//# sourceMappingURL=ai-config-generator.js.map

package/dist/core/analyzer/ai-config-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config-generator.js","sourceRoot":"","sources":["../../../src/core/analyzer/ai-config-generator.ts"],"names":[],"mappings":"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"}

package/dist/core/analyzer/architecture-writer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Architecture Writer
+ *
+ * Shared logic for building a high-level architecture overview from cached
+ * static analysis artifacts (dependency-graph.json + llm-context.json).
+ *
+ * Used by:
+ *   - MCP tool `get_architecture_overview` (mcp.ts)
+ *   - `openlore analyze` — writes ARCHITECTURE.md to the project root
+ */
+import type { DependencyGraphResult } from './dependency-graph.js';
+import type { LLMContext } from './artifact-generator.js';
+export interface ClusterSummary {
+    id: string;
+    name: string;
+    fileCount: number;
+    role: string;
+    entryPointCount: number;
+    hubCount: number;
+    dependsOn: string[];
+    keyFiles: string[];
+}
+export interface ArchitectureOverview {
+    generatedAt: string;
+    summary: {
+        totalFiles: number;
+        totalClusters: number;
+        totalEdges: number;
+        cycles: number;
+        layerViolations: number;
+    };
+    clusters: ClusterSummary[];
+    globalEntryPoints: Array<{
+        name: string;
+        file: string;
+        language: string;
+    }>;
+    criticalHubs: Array<{
+        name: string;
+        file: string;
+        fanIn: number;
+        fanOut: number;
+    }>;
+}
+/**
+ * Infer a module cluster's architectural role from aggregate metrics.
+ */
+export declare function inferClusterRole(entryCount: number, hubCount: number, fileCount: number): string;
+/**
+ * Build an ArchitectureOverview from pre-loaded dependency graph and LLM context.
+ * Both can be null if one artifact is missing; at least one must be non-null.
+ *
+ * @param depGraph  Parsed dependency-graph.json (or null)
+ * @param ctx       Parsed llm-context.json (or null)
+ * @param absDir    Absolute project root path — used to normalize cluster file paths
+ */
+export declare function buildArchitectureOverview(depGraph: DependencyGraphResult | null, ctx: LLMContext | null, absDir: string): ArchitectureOverview;
+/**
+ * Render an ArchitectureOverview as a Markdown document (ARCHITECTURE.md).
+ */
+export declare function renderArchitectureMarkdown(overview: ArchitectureOverview): string;
+/**
+ * Write ARCHITECTURE.md to the project root.
+ * Returns the path written.
+ */
+export declare function writeArchitectureMd(rootPath: string, overview: ArchitectureOverview): Promise<string>;
+//# sourceMappingURL=architecture-writer.d.ts.map

package/dist/core/analyzer/architecture-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-writer.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/architecture-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAM1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,iBAAiB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAMR;AAMD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,EACtC,GAAG,EAAE,UAAU,GAAG,IAAI,EACtB,MAAM,EAAE,MAAM,GACb,oBAAoB,CA4EtB;AAcD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAmFjF;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAIjB"}