spec-gen-cli 1.1.0 → 1.2.0

package/dist/constants.js

@@ -0,0 +1,320 @@
+/**
+ * Shared constants for spec-gen
+ *
+ * Centralises magic numbers so they're easy to find, reason about, and change.
+ */
+// ============================================================================
+// DIRECTORY / PATH NAMES
+// ============================================================================
+/** Hidden directory where spec-gen stores its state */
+export const SPEC_GEN_DIR = '.spec-gen';
+/** Analysis artifacts sub-directory */
+export const SPEC_GEN_ANALYSIS_SUBDIR = 'analysis';
+/** LLM log sub-directory */
+export const SPEC_GEN_LOGS_SUBDIR = 'logs';
+/** Verification reports sub-directory */
+export const SPEC_GEN_VERIFICATION_SUBDIR = 'verification';
+/** Generation outputs sub-directory */
+export const SPEC_GEN_OUTPUTS_SUBDIR = 'outputs';
+/** Spec backups sub-directory */
+export const SPEC_GEN_BACKUPS_SUBDIR = 'backups';
+/** Generation intermediate files sub-directory */
+export const SPEC_GEN_GENERATION_SUBDIR = 'generation';
+/** Run metadata sub-directory */
+export const SPEC_GEN_RUNS_SUBDIR = 'runs';
+/** Config file name inside SPEC_GEN_DIR */
+export const SPEC_GEN_CONFIG_FILENAME = 'config.json';
+/** Relative path to the spec-gen config file */
+export const SPEC_GEN_CONFIG_REL_PATH = `${SPEC_GEN_DIR}/${SPEC_GEN_CONFIG_FILENAME}`;
+/** Relative path to the analysis output directory */
+export const SPEC_GEN_ANALYSIS_REL_PATH = `${SPEC_GEN_DIR}/${SPEC_GEN_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 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';
+// ============================================================================
+// 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 */
+export const DEFAULT_MAX_FILES = 500;
+/** 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;
+// ============================================================================
+// 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';
+/** 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;
+/** 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;
+/** 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;
+// ============================================================================
+// 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;
+//# 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/artifact-generator.d.ts

@@ -140,6 +140,14 @@ export interface ArtifactGeneratorOptions {
     /** Approximate tokens per character for estimation */
     tokensPerChar?: number;
 }
+/**
+ * Convert a serialised RepoStructure (from repo-structure.json on disk) back
+ * to a minimal RepositoryMap-compatible object.  Only the fields that
+ * consumers of the cached-analysis path actually use are populated; the
+ * file-level arrays (`allFiles`, `highValueFiles`, etc.) are left empty
+ * because the original per-file data is not persisted to disk.
+ */
+export declare function repoStructureToRepoMap(rs: RepoStructure): RepositoryMap;
 /**
  * Generates analysis artifacts from repository map and dependency graph
  */

package/dist/core/analyzer/artifact-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-generator.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/artifact-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWpD;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE;QACZ,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,GAAG,SAAS,CAAC;QAC1E,MAAM,EAAE,iBAAiB,EAAE,CAAC;KAC7B,CAAC;IACF,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,eAAe,CAAC;IAC/B,WAAW,EAAE,eAAe,CAAC;IAC7B,iBAAiB,EAAE,eAAe,CAAC;IACnC,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,0BAA0B,EAAE,gBAAgB,EAAE,CAAC;IACnE,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,iBAAiB,EAAE,mBAAmB,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAAqC;gBAExC,OAAO,EAAE,wBAAwB;IAU7C;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,iBAAiB,CAAC;IAe7B;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,iBAAiB,CAAC;IA6B7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoD7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAoCjC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA2ElC;;OAEG;IACH,OAAO,CAAC,eAAe;IAgEvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA4I/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAajC;;OAEG;YACW,kBAAkB;CAoKjC;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}
+{"version":3,"file":"artifact-generator.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/artifact-generator.ts"],"names":[],"mappings":"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"}

package/dist/core/analyzer/artifact-generator.js

@@ -6,6 +6,7 @@
  */
 import { writeFile, mkdir, readFile } from 'node:fs/promises';
 import { join, basename } from 'node:path';
+import { TOKENS_PER_CHAR_DEFAULT, PHASE2_FILE_CONTENT_MAX_CHARS, PHASE3_FILE_CONTENT_MAX_CHARS, DEPENDENCY_DIAGRAM_MAX_FILES, ARTIFACT_REPO_STRUCTURE, ARTIFACT_LLM_CONTEXT, ARTIFACT_MAPPING, ARTIFACT_REFACTOR_PRIORITIES, } from '../../constants.js';
 import { toMermaidFormat } from './dependency-graph.js';
 /**
  * Heuristic to detect test/spec files across languages.
@@ -30,6 +31,47 @@ export function isTestFile(filePath) {
         /[A-Z][a-zA-Z0-9]*Spec\.(kt|scala|rb)$/.test(name) // Kotlin/Ruby: FooSpec.kt
     );
 }
+/**
+ * Convert a serialised RepoStructure (from repo-structure.json on disk) back
+ * to a minimal RepositoryMap-compatible object.  Only the fields that
+ * consumers of the cached-analysis path actually use are populated; the
+ * file-level arrays (`allFiles`, `highValueFiles`, etc.) are left empty
+ * because the original per-file data is not persisted to disk.
+ */
+export function repoStructureToRepoMap(rs) {
+    return {
+        metadata: {
+            projectName: rs.projectName,
+            projectType: (rs.projectType === 'node-typescript' ? 'nodejs' : rs.projectType),
+            rootPath: '',
+            analyzedAt: '',
+            version: '',
+        },
+        summary: {
+            totalFiles: rs.statistics.totalFiles,
+            analyzedFiles: rs.statistics.analyzedFiles,
+            skippedFiles: rs.statistics.skippedFiles,
+            languages: [],
+            frameworks: rs.frameworks.map(name => ({
+                name,
+                category: 'other',
+                confidence: 'medium',
+                evidence: [],
+            })),
+            directories: [],
+        },
+        highValueFiles: [],
+        entryPoints: [],
+        schemaFiles: [],
+        configFiles: [],
+        clusters: {
+            byDirectory: {},
+            byDomain: {},
+            byLayer: { presentation: [], business: [], data: [], infrastructure: [] },
+        },
+        allFiles: [],
+    };
+}
 // ============================================================================
 // ARTIFACT GENERATOR
 // ============================================================================
@@ -44,7 +86,7 @@ export class AnalysisArtifactGenerator {
             outputDir: options.outputDir,
             maxDeepAnalysisFiles: options.maxDeepAnalysisFiles ?? 20,
             maxValidationFiles: options.maxValidationFiles ?? 5,
-            tokensPerChar: options.tokensPerChar ?? 0.25, // ~4 chars per token
+            tokensPerChar: options.tokensPerChar ?? TOKENS_PER_CHAR_DEFAULT,
         };
     }
     /**
@@ -72,10 +114,10 @@ export class AnalysisArtifactGenerator {
         await mkdir(this.options.outputDir, { recursive: true });
         // Save each artifact
         await Promise.all([
-            writeFile(join(this.options.outputDir, 'repo-structure.json'), JSON.stringify(artifacts.repoStructure, null, 2)),
+            writeFile(join(this.options.outputDir, ARTIFACT_REPO_STRUCTURE), JSON.stringify(artifacts.repoStructure, null, 2)),
             writeFile(join(this.options.outputDir, 'SUMMARY.md'), artifacts.summaryMarkdown),
             writeFile(join(this.options.outputDir, 'dependencies.mermaid'), artifacts.dependencyDiagram),
-            writeFile(join(this.options.outputDir, 'llm-context.json'), JSON.stringify(artifacts.llmContext, null, 2)),
+            writeFile(join(this.options.outputDir, ARTIFACT_LLM_CONTEXT), JSON.stringify(artifacts.llmContext, null, 2)),
         ]);
         return artifacts;
     }
@@ -488,6 +530,12 @@ export class AnalysisArtifactGenerator {
                 lines.push(`- ${cycleFiles.join(' → ')}`);
             }
         }
+        // HTTP cross-language edges
+        if (depGraph.statistics.httpEdgeCount > 0) {
+            lines.push('');
+            lines.push(`**HTTP Cross-Language Edges**: ${depGraph.statistics.httpEdgeCount} edge(s) detected between JS/TS callers and Python route handlers`);
+            lines.push(`  (${depGraph.statistics.importEdgeCount} static import edges + ${depGraph.statistics.httpEdgeCount} HTTP edges = ${depGraph.statistics.edgeCount} total)`);
+        }
         // Orphans
         if (depGraph.rankings.orphanNodes.length > 0) {
             lines.push('');
@@ -554,8 +602,8 @@ export class AnalysisArtifactGenerator {
     generateDependencyDiagram(depGraph) {
         // Use the built-in Mermaid converter with clustering
         const lines = ['```mermaid'];
-        // Generate diagram with top 30 files
-        const mermaid = toMermaidFormat(depGraph, 30);
+        // Generate diagram with top files
+        const mermaid = toMermaidFormat(depGraph, DEPENDENCY_DIAGRAM_MAX_FILES);
         lines.push(mermaid);
         lines.push('```');
         return lines.join('\n');
@@ -569,7 +617,7 @@ export class AnalysisArtifactGenerator {
             purpose: 'Initial project categorization',
             files: [
                 {
-                    path: 'repo-structure.json',
+                    path: ARTIFACT_REPO_STRUCTURE,
                     tokens: 2000, // Estimate
                 },
             ],
@@ -587,7 +635,7 @@ export class AnalysisArtifactGenerator {
                 const tokens = Math.ceil(content.length * this.options.tokensPerChar);
                 phase2Files.push({
                     path: file.path,
-                    content: content.slice(0, 10000), // Limit content size
+                    content: content.slice(0, PHASE2_FILE_CONTENT_MAX_CHARS),
                     tokens,
                 });
             }
@@ -622,7 +670,7 @@ export class AnalysisArtifactGenerator {
                 const tokens = Math.ceil(content.length * this.options.tokensPerChar);
                 phase3Files.push({
                     path: file.path,
-                    content: content.slice(0, 5000),
+                    content: content.slice(0, PHASE3_FILE_CONTENT_MAX_CHARS),
                     tokens,
                 });
             }
@@ -642,7 +690,7 @@ export class AnalysisArtifactGenerator {
         const { CallGraphBuilder, serializeCallGraph } = await import('./call-graph.js');
         const { detectDuplicates } = await import('./duplicate-detector.js');
         const { analyzeForRefactoring } = await import('./refactor-analyzer.js');
-        const CALL_GRAPH_LANGS = new Set(['Python', 'TypeScript', 'JavaScript', 'Go', 'Rust', 'Ruby', 'Java']);
+        const CALL_GRAPH_LANGS = new Set(['Python', 'TypeScript', 'JavaScript', 'Go', 'Rust', 'Ruby', 'Java', 'C++']);
         const signatures = [];
         const callGraphFiles = [];
         for (const file of repoMap.allFiles) {
@@ -682,7 +730,7 @@ export class AnalysisArtifactGenerator {
         // Refactoring priorities (structural — enriched after generate)
         let mappings;
         try {
-            const mappingRaw = await readFile(join(this.options.outputDir, 'mapping.json'), 'utf-8');
+            const mappingRaw = await readFile(join(this.options.outputDir, ARTIFACT_MAPPING), 'utf-8');
             const mappingJson = JSON.parse(mappingRaw);
             mappings = mappingJson.mappings;
         }
@@ -692,7 +740,7 @@ export class AnalysisArtifactGenerator {
         const refactorReport = analyzeForRefactoring(callGraph, mappings, duplicates);
         // Save refactor priorities
         try {
-            await writeFile(join(this.options.outputDir, 'refactor-priorities.json'), JSON.stringify(refactorReport, null, 2));
+            await writeFile(join(this.options.outputDir, ARTIFACT_REFACTOR_PRIORITIES), JSON.stringify(refactorReport, null, 2));
         }
         catch {
             // non-fatal