sourcecode 2.0.0__py3-none-any.whl → 2.0.1__py3-none-any.whl

sourcecode/license.py

@@ -89,25 +89,9 @@ if _SUPABASE_URL != _DEFAULT_SUPABASE_URL:
 # which case prompts point to the documented Pro plans instead of a placeholder link.
 _PURCHASE_URL: str = os.environ.get("SOURCECODE_PURCHASE_URL", "").strip()
 
-# Config home: ~/.ask is canonical (product = ASK Engine). The legacy ~/.sourcecode
-# stays READABLE so no existing user loses their license — reads prefer ~/.ask and
-# fall back to ~/.sourcecode; writes always land in ~/.ask. Backward-compatible.
-_LICENSE_DIR: Path = Path.home() / ".ask"
-_LEGACY_LICENSE_DIR: Path = Path.home() / ".sourcecode"
+_LICENSE_DIR: Path = Path.home() / ".sourcecode"
 _LICENSE_FILE: Path = _LICENSE_DIR / "license.json"
 _DELTA_RUNS_FILE: Path = _LICENSE_DIR / "delta_runs.json"
-
-
-def _read_config_path(name: str) -> Path:
-    """Existing config file for `name`, preferring ~/.ask, else legacy ~/.sourcecode.
-    Returns the canonical ~/.ask path when neither exists (write target)."""
-    new = _LICENSE_DIR / name
-    if new.exists():
-        return new
-    legacy = _LEGACY_LICENSE_DIR / name
-    if legacy.exists():
-        return legacy
-    return new
 _CACHE_TTL_SECONDS: int = 1800  # 30 minutes default; CI env overrides to 24h (see _get_cache_ttl)
 _CACHE_TTL_CI_SECONDS: int = 86400  # 24 hours — CI containers must not re-validate mid-run
 
@@ -212,7 +196,7 @@ _PRO_UNLOCK_ALL = os.environ.get("SOURCECODE_PRO_UNLOCK", "1") != "0"
 
 
 def _secure_dir() -> None:
-    """Create ~/.ask owner-only (0700). Holds the license secret.
+    """Create ~/.sourcecode owner-only (0700). Holds the license secret.
 
     ``mkdir(mode=...)`` is ignored when the dir already exists, so chmod
     unconditionally. Best-effort: a chmod failure (e.g. Windows) is non-fatal.
@@ -251,9 +235,8 @@ def _write_license_file(data: dict) -> None:
 
 def _read_delta_runs() -> dict:
     try:
-        src = _read_config_path("delta_runs.json")
-        if src.exists():
-            return json.loads(src.read_text(encoding="utf-8"))
+        if _DELTA_RUNS_FILE.exists():
+            return json.loads(_DELTA_RUNS_FILE.read_text(encoding="utf-8"))
     except Exception:
         pass
     return {}
@@ -285,12 +268,11 @@ def check_delta_free_tier(repo_path: str) -> "tuple[bool, int, int]":
 
 
 def _load_license_file() -> Optional[dict]:
-    """Read the license file, preferring ~/.ask and falling back to the legacy
-    ~/.sourcecode. Returns parsed dict or None."""
+    """Read ~/.sourcecode/license.json. Returns parsed dict or None."""
     try:
-        src = _read_config_path("license.json")
-        if src.exists():
-            return json.loads(src.read_text(encoding="utf-8"))
+        if _LICENSE_FILE.exists():
+            raw = _LICENSE_FILE.read_text(encoding="utf-8")
+            return json.loads(raw)
     except Exception:
         pass
     return None
@@ -427,7 +409,7 @@ def _emit_upgrade_and_exit(headline: str, body_lines: list[str], payload: dict)
     lines.append("  Unlock Pro:")
     where = _PURCHASE_URL or "see Pro plans (docs/PRODUCT_TIERS.md)"
     lines.append(f"    1. Get a license:  {where}")
-    lines.append("    2. Activate:       ask activate <license_key>")
+    lines.append("    2. Activate:       sourcecode activate <license_key>")
     lines.append("")
     sys.stderr.write("\n".join(lines) + "\n")
     sys.stderr.flush()
@@ -497,9 +479,9 @@ def require_feature(
         "feature": feature_name,
         "message": (
             f"'{display}' requires a Pro license. "
-            "Run: ask activate <license_key>"
+            "Run: sourcecode activate <license_key>"
         ),
-        "upgrade_hint": "ask activate <license_key>",
+        "upgrade_hint": "sourcecode activate <license_key>",
     }
     if extra_fields:
         payload.update(extra_fields)
@@ -548,9 +530,9 @@ def require_repo_or_pro(
             f"This repository exceeds the free-tier limit of "
             f"{_FREE_REPO_JAVA_FILE_LIMIT} Java source files. "
             "Pro unlocks enterprise-scale monoliths. "
-            "Run: ask activate <license_key>"
+            "Run: sourcecode activate <license_key>"
         ),
-        "upgrade_hint": "ask activate <license_key>",
+        "upgrade_hint": "sourcecode activate <license_key>",
     }
     if extra_fields:
         payload.update(extra_fields)

sourcecode/mcp/onboarding/applier.py

@@ -6,10 +6,9 @@ import os
 from pathlib import Path
 
 _MCP_SERVERS_KEY = "mcpServers"
-_ENTRY_NAME = "ask"                 # canonical (product = ASK Engine)
-_LEGACY_ENTRY_NAME = "sourcecode"   # deprecated alias — still recognized/cleaned
+_ENTRY_NAME = "sourcecode"
 _ENTRY_VALUE: dict[str, object] = {
-    "command": "ask",
+    "command": "sourcecode",
     "args": ["mcp", "serve"],
 }
 
@@ -26,31 +25,24 @@ def read_config(path: Path) -> dict:
 
 
 def is_installed(config: dict) -> bool:
-    """True if the ASK Engine entry (canonical `ask` or legacy `sourcecode`) is
-    already present in mcpServers."""
-    servers = config.get(_MCP_SERVERS_KEY, {})
-    return _ENTRY_NAME in servers or _LEGACY_ENTRY_NAME in servers
+    """True if sourcecode entry already present in mcpServers."""
+    return _ENTRY_NAME in config.get(_MCP_SERVERS_KEY, {})
 
 
 def apply_entry(config: dict) -> dict:
-    """Return new config dict with the canonical `ask` entry merged into mcpServers.
-    Any legacy `sourcecode` entry is migrated away (removed) so the client launches
-    a single server."""
+    """Return new config dict with sourcecode merged into mcpServers."""
     config = dict(config)
     servers: dict = dict(config.get(_MCP_SERVERS_KEY, {}))
-    servers.pop(_LEGACY_ENTRY_NAME, None)
     servers[_ENTRY_NAME] = _ENTRY_VALUE
     config[_MCP_SERVERS_KEY] = servers
     return config
 
 
 def remove_entry(config: dict) -> dict:
-    """Return new config dict with the ASK Engine entry removed — both the canonical
-    `ask` key and any legacy `sourcecode` key."""
+    """Return new config dict with sourcecode removed from mcpServers."""
     config = dict(config)
     servers: dict = dict(config.get(_MCP_SERVERS_KEY, {}))
     servers.pop(_ENTRY_NAME, None)
-    servers.pop(_LEGACY_ENTRY_NAME, None)
     if servers:
         config[_MCP_SERVERS_KEY] = servers
     elif _MCP_SERVERS_KEY in config:

sourcecode/mcp/registry.py

@@ -416,7 +416,7 @@ def make_tool_callable(spec: ToolSpec) -> Callable[..., Any]:
 
 def _canonical_spec_for_runtime_command(runtime: RuntimeCommand) -> ToolSpec:
     params = tuple(_click_to_param_spec(param) for param in runtime.command.params)
-    runtime_command = " ".join(runtime.path) if runtime.path else "ask"
+    runtime_command = " ".join(runtime.path) if runtime.path else "sourcecode"
     name = _tool_name_for_path(runtime.path)
     doc = runtime.docstring or runtime.help or ""
     description = _first_doc_line(doc) or f"CLI command: {runtime_command}"
@@ -510,7 +510,7 @@ def _alias_spec(
         not_exposed_to_cli=not_exposed_to_cli,
         mcp_hidden=mcp_hidden,
         docstring=doc,
-        runtime_command=" ".join(cli_path) if cli_path else "ask",
+        runtime_command=" ".join(cli_path) if cli_path else "sourcecode",
         _argv_builder=argv_builder,
         validator=validator,
     )
@@ -552,7 +552,7 @@ Returns: stacks, entry points, dependency summary, architecture summary, confide
 Includes security_surface, mybatis, and transactional_boundaries for Java/Spring projects.
 For richer machine-oriented detail (deeper signals, more sections), use get_agent_context.
 
-Maps to: ask <repo_path> --compact [--git-context]
+Maps to: sourcecode <repo_path> --compact [--git-context]
 repo_path: absolute path to the repository (default: current working directory).
 git_context: include git log and branch context in the analysis.
 """
@@ -565,7 +565,7 @@ lacks sufficient detail. Includes all compact fields plus: env_map, code_notes,
 architecture layers, security surface, transactional boundaries, module graph summary.
 Prefer get_compact_context for quick orientation or token-constrained workflows.
 
-Maps to: ask <repo_path> --agent [--git-context]
+Maps to: sourcecode <repo_path> --agent [--git-context]
 repo_path: absolute path to the repository (default: current working directory).
 git_context: include git log and branch context in the analysis.
 """
@@ -573,7 +573,7 @@ git_context: include git log and branch context in the analysis.
     _GET_MODULE_DOC = """\
 Compact analysis of a specific module or subdirectory within a repository.
 
-Maps to: ask <repo_path>/<module> --compact
+Maps to: sourcecode <repo_path>/<module> --compact
 repo_path: absolute path to the repository root.
 module: subdirectory name relative to repo_path (e.g. 'src/auth', 'api', 'core').
 Returns: same fields as get_compact_context but scoped to the module subtree.
@@ -582,7 +582,7 @@ Returns: same fields as get_compact_context but scoped to the module subtree.
     _TELEMETRY_DOC = """\
 Manage telemetry settings.
 
-Maps to: ask telemetry <action>
+Maps to: sourcecode telemetry <action>
 action: one of "status" (show current state), "enable" (opt in), "disable" (opt out).
 Valid values: "status" | "enable" | "disable"
 """
@@ -689,7 +689,7 @@ def _prepare_context_aliases() -> list[ToolSpec]:
     _GET_DELTA_DOC = """\
 Incremental context: git-changed files since a reference commit.
 
-Maps to: ask prepare-context delta <repo_path> --since <since>
+Maps to: sourcecode prepare-context delta <repo_path> --since <since>
 repo_path: absolute path to the repository (default: current working directory).
 since: git ref to diff against (e.g. HEAD~3, main, origin/main).
        If empty or omitted, auto-detects merge-base with origin/main (or
@@ -700,7 +700,7 @@ since: git ref to diff against (e.g. HEAD~3, main, origin/main).
     _REVIEW_PR_DOC = """\
 Execution paths and risk analysis for changed files in a pull request.
 
-Maps to: ask prepare-context review-pr <repo_path> [--since <since>]
+Maps to: sourcecode prepare-context review-pr <repo_path> [--since <since>]
 Returns: compact_base + execution_paths (diff-scoped) + hotspots for changed files.
 repo_path: absolute path to the repository (default: current working directory).
 since: git ref to diff against (e.g. HEAD~3, main, origin/main).
@@ -710,7 +710,7 @@ since: git ref to diff against (e.g. HEAD~3, main, origin/main).
     _FIX_BUG_DOC = """\
 Risk-ranked files for bug investigation, optionally focused by symptom.
 
-Maps to: ask prepare-context fix-bug <repo_path> [--symptom <symptom>]
+Maps to: sourcecode prepare-context fix-bug <repo_path> [--symptom <symptom>]
 Includes compact_base: security_surface, transactional_boundaries, spring_profiles.
 repo_path: absolute path to the repository (default: current working directory).
 symptom: optional error message or class name to focus the file ranking
@@ -722,7 +722,7 @@ symptom: optional error message or class name to focus the file ranking
     _ONBOARD_DOC = """\
 Onboarding context: structured overview for new contributors.
 
-Maps to: ask prepare-context onboard <repo_path>
+Maps to: sourcecode prepare-context onboard <repo_path>
 Returns: project structure, key entry points, architectural patterns, getting-started guide.
 repo_path: absolute path to the repository (default: current working directory).
 """
@@ -730,7 +730,7 @@ repo_path: absolute path to the repository (default: current working directory).
     _EXPLAIN_DOC = """\
 Architecture and entry-point explanation for a repository.
 
-Maps to: ask prepare-context explain <repo_path>
+Maps to: sourcecode prepare-context explain <repo_path>
 Returns: project summary, architecture overview, entry points, key dependencies.
 repo_path: absolute path to the repository (default: current working directory).
 """
@@ -738,7 +738,7 @@ repo_path: absolute path to the repository (default: current working directory).
     _REFACTOR_DOC = """\
 Structural issues and refactor opportunities for a repository.
 
-Maps to: ask prepare-context refactor <repo_path>
+Maps to: sourcecode prepare-context refactor <repo_path>
 Returns: structural issues, coupling hotspots, high-churn files, improvement opportunities.
 repo_path: absolute path to the repository (default: current working directory).
 """
@@ -746,7 +746,7 @@ repo_path: absolute path to the repository (default: current working directory).
     _GENERATE_TESTS_DOC = """\
 Untested source files and test gap analysis for a repository.
 
-Maps to: ask prepare-context generate-tests <repo_path> [--all]
+Maps to: sourcecode prepare-context generate-tests <repo_path> [--all]
 Returns: test_gaps list of untested files ranked by risk.
         On large repos (>2000 classes) analysis is bounded by SOURCECODE_TESTS_TIMEOUT_MS
         (default: 15000 ms). If timeout elapses, returns truncated=true with partial results.
@@ -757,7 +757,7 @@ include_all: return full test_gaps list without truncating to top 20.
     _IR_SUMMARY_DOC = """\
 Deterministic symbol-level IR summary for Java repositories. Java only.
 
-Maps to: ask repo-ir <repo_path> --summary-only
+Maps to: sourcecode repo-ir <repo_path> --summary-only
 Returns: reverse_graph, route_surface (top 50 endpoints),
          subsystems (top 15), impact, analysis. Full graph nodes/edges omitted.
 
@@ -770,7 +770,7 @@ subsystems: list of detected subsystem cluster dicts.
 analysis: metadata — total_classes, total_edges, analysis_ms.
 
 Output is bounded to ~100 KB for LLM safety. For full IR (can exceed 10 MB
-on large repos), use the CLI: ask repo-ir <path> --output ir.json
+on large repos), use the CLI: sourcecode repo-ir <path> --output ir.json
 Use get_compact_context or get_agent_context for non-Java repos.
 
 repo_path: absolute path to the Java repository (default: current working directory).
@@ -779,7 +779,7 @@ repo_path: absolute path to the Java repository (default: current working direct
     _IMPACT_CONTEXT_DOC = """\
 Blast-radius analysis: who calls a class and what breaks if it changes? Java only.
 
-Maps to: ask impact <target> <repo_path> [--depth <depth>]
+Maps to: sourcecode impact <target> <repo_path> [--depth <depth>]
 Returns: direct_callers, indirect_callers, endpoints_affected,
          transactional_boundaries_touched, risk_score, risk_level, stats.
 
@@ -797,7 +797,7 @@ depth: BFS depth for indirect caller traversal (1–8, default: 4).
     _MODERNIZE_DOC = """\
 Analyzes codebase for modernization opportunities: dead zones, hotspot scores, upgrade candidates.
 
-Maps to: ask modernize <repo_path>
+Maps to: sourcecode modernize <repo_path>
 Returns: hotspot_candidates (high fan-in + git churn), statically_unreferenced (zero-caller classes — NOT confirmed dead; verify no framework dispatch) + framework_dispatched,
          high_coupling_nodes, subsystem_summary, cross_module_tangles, recommendation.
 
@@ -852,7 +852,7 @@ REST API endpoint surface extraction from Java source files. JAVA ONLY.
 Do NOT call this on non-Java repositories — it will return empty results.
 Use get_compact_context or get_agent_context for non-Java repos.
 
-Maps to: ask endpoints <repo_path>
+Maps to: sourcecode endpoints <repo_path>
 Returns: endpoints list with method, path, controller, handler fields;
          security dict always present (policy: roles_allowed|permit_all|deny_all|
          authenticated|...|none_detected); none_detected = no auth annotation found.
@@ -879,7 +879,7 @@ must satisfy before generating a payload, a test, or reasoning about a 400:
   * hand-written custom validators (@Constraint + ConstraintValidator, e.g.
     PetAgeValidator), linked to fields via x-field-extra-annotation.
 
-Maps to: ask validation <repo_path>
+Maps to: sourcecode validation <repo_path>
 Returns: endpoints[] (method, path, controller, handler, schema, validatedFields[
   {name, rules[{kind,value}], customValidators[{annotation,validators,message,resolved}]}]),
   custom_validators[] (catalog: annotation, validators, message, validatedTypes, targets),
@@ -894,7 +894,7 @@ gaps_only: when true, return only the gaps section (endpoints lacking validation
     _CACHE_STATUS_DOC = """\
 Report cache metadata for a repository.
 
-Maps to: ask cache status <repo_path> --json
+Maps to: sourcecode cache status <repo_path> --json
 Returns: cache entries with git_head, timestamps, size info.
 Use check_freshness for RIS-specific freshness checking (faster, richer).
 repo_path: absolute path to the repository (default: current working directory).
@@ -903,7 +903,7 @@ repo_path: absolute path to the repository (default: current working directory).
     _CACHE_WARM_DOC = """\
 Warm the cache for a repository (builds compact and agent analysis snapshots).
 
-Maps to: ask cache warm <repo_path>
+Maps to: sourcecode cache warm <repo_path>
 Builds or refreshes the Repository Intelligence Snapshot (RIS).
 Use before analytical workflows to ensure fast subsequent tool calls (~8s first run,
 instant after).
@@ -913,7 +913,7 @@ repo_path: absolute path to the repository (default: current working directory).
     _CACHE_CLEAR_DOC = """\
 Clear cached analysis for a repository.
 
-Maps to: ask cache clear <repo_path> [--include-ris]
+Maps to: sourcecode cache clear <repo_path> [--include-ris]
 Removes cached context files. After clearing, run get_compact_context or cache_warm to rebuild.
 include_ris: also remove the RIS snapshot in addition to analysis cache (default: False).
 repo_path: absolute path to the repository (default: current working directory).

sourcecode/mcp/runner.py

@@ -66,7 +66,7 @@ def run_command(args: list[str]) -> Any:
                 payload = _parsed
                 break
         raise CommandError(
-            f"ask command failed (exit {result.exit_code}). Args: {args}",
+            f"sourcecode command failed (exit {result.exit_code}). Args: {args}",
             exit_code=result.exit_code,
             stdout=stdout,
             stderr=stderr,
@@ -76,7 +76,7 @@ def run_command(args: list[str]) -> Any:
     output = (result.output or "").strip()
     if not output:
         raise RuntimeError(
-            f"ask command produced no output.\n"
+            f"sourcecode command produced no output.\n"
             f"Args: {args}"
         )
 

sourcecode/mcp/server.py

@@ -108,14 +108,14 @@ def _coerce_cli_error(exc: Exception, default_message: str) -> CallToolResult:
             and "pro" in payload.get("error", "").lower()
         ):
             feature = payload.get("feature", "")
-            msg = payload.get("message", f"'{feature}' requires a Pro license. Run: ask activate <key>")
+            msg = payload.get("message", f"'{feature}' requires a Pro license. Run: sourcecode activate <key>")
             structured = {
                 "success": False,
                 "data": None,
                 "error": build_error_object(
                     "PRO_REQUIRED",
                     msg,
-                    hint="ask activate <license_key>",
+                    hint="sourcecode activate <license_key>",
                     expected="Active Pro license.",
                 ),
             }
@@ -627,7 +627,7 @@ def get_compact_context(repo_path: str = ".", git_context: bool = False) -> dict
     Includes security_surface, mybatis, and transactional_boundaries for Java/Spring projects.
     For richer machine-oriented detail (deeper signals, more sections), use get_agent_context.
 
-    Maps to: ask <repo_path> --compact [--git-context]
+    Maps to: sourcecode <repo_path> --compact [--git-context]
     repo_path: absolute path to the repository (default: current working directory).
     git_context: include git log and branch context in the analysis.
     """
@@ -661,7 +661,7 @@ def get_agent_context(repo_path: str = ".", git_context: bool = False) -> dict:
     architecture layers, security surface, transactional boundaries, module graph summary.
     Prefer get_compact_context for quick orientation or token-constrained workflows.
 
-    Maps to: ask <repo_path> --agent [--git-context]
+    Maps to: sourcecode <repo_path> --agent [--git-context]
     repo_path: absolute path to the repository (default: current working directory).
     git_context: include git log and branch context in the analysis.
     """
@@ -696,7 +696,7 @@ def get_endpoints(repo_path: str = ".") -> dict:
     Do NOT call this on non-Java repositories — it will return empty results.
     Use get_compact_context or get_agent_context for non-Java repos.
 
-    Maps to: ask endpoints <repo_path>
+    Maps to: sourcecode endpoints <repo_path>
     Returns: endpoints list with method, path, controller, handler fields;
              security dict always present (policy: roles_allowed|permit_all|deny_all|
              authenticated|...|none_detected); none_detected = no auth annotation found.
@@ -733,7 +733,7 @@ def get_spring_audit(repo_path: str = ".", scope: str = "all") -> dict:
 
     Do NOT call this on non-Java repositories — it will return spring_detected=false.
 
-    Maps to: ask spring-audit <repo_path> --scope <scope>
+    Maps to: sourcecode spring-audit <repo_path> --scope <scope>
     Returns: SpringAuditResult with schema_version, spring_detected, scope, summary,
              findings list (id, pattern_id, category, severity, confidence, title,
              symbol, source_file, evidence, explanation, fix_hint), limitations, metadata.
@@ -790,7 +790,7 @@ def get_migration_readiness(repo_path: str = ".", min_severity: str = "low") ->
     the goal is migration planning — not ongoing audit.
     Do NOT call on non-Java repositories — returns readiness_score=null (N/A) with no findings.
 
-    Maps to: ask migrate-check <repo_path> --min-severity <min_severity>
+    Maps to: sourcecode migrate-check <repo_path> --min-severity <min_severity>
     Returns: MigrationReport with schema_version, readiness_score (0–100, or null=N/A when no migration target applies; 100=ready to migrate),
              jakarta_readiness / boot3_readiness / jdk_modernization / hibernate_readiness
              (per-dimension 0–100), headline_blocker (e.g. "hibernate_rewrite" or null),
@@ -847,7 +847,7 @@ def get_impact_chain(repo_path: str = ".", symbol: str = "", depth: int = 4) ->
 
     Do NOT call this on non-Java repositories — it will return resolution=not_found.
 
-    Maps to: ask impact-chain <symbol> <repo_path> [--depth <depth>]
+    Maps to: sourcecode impact-chain <symbol> <repo_path> [--depth <depth>]
     Returns: ImpactChainResult with schema_version, symbol, resolution,
              direct_callers, indirect_callers, endpoints_affected,
              transaction_boundary (propagation/isolation/read_only),
@@ -901,7 +901,7 @@ def get_impact_chain(repo_path: str = ".", symbol: str = "", depth: int = 4) ->
 def get_module_context(repo_path: str = ".", module: str = "") -> dict:
     """Compact analysis of a specific module or subdirectory within a repository.
 
-    Maps to: ask <repo_path>/<module> --compact
+    Maps to: sourcecode <repo_path>/<module> --compact
     repo_path: absolute path to the repository root.
     module: subdirectory name relative to repo_path (e.g. 'src/auth', 'api', 'core').
     """
@@ -944,7 +944,7 @@ def _auto_since(repo_path: str) -> str:
 def get_delta(repo_path: str = ".", since: str = "") -> dict:
     """Incremental context: git-changed files since a reference commit.
 
-    Maps to: ask prepare-context delta <repo_path> --since <since>
+    Maps to: sourcecode prepare-context delta <repo_path> --since <since>
     repo_path: absolute path to the repository (default: current working directory).
     since: git ref to diff against (e.g. HEAD~3, main, origin/main).
            If empty or omitted, auto-detects merge-base with origin/main (or
@@ -1055,12 +1055,12 @@ def check_freshness(repo_path: str = ".") -> dict:
 def get_ir_summary(repo_path: str = ".") -> dict:
     """Deterministic symbol-level IR summary for Java repositories. Java only.
 
-    Maps to: ask repo-ir <repo_path> --summary-only
+    Maps to: sourcecode repo-ir <repo_path> --summary-only
     Returns: reverse_graph (top 10 hubs), route_surface (top 50 endpoints),
              subsystems (top 15), impact, analysis. Full graph nodes/edges omitted.
 
     Output is bounded to ~100 KB for LLM safety. For full IR (can exceed 10 MB
-    on large repos), use the CLI: ask repo-ir <path> --output ir.json
+    on large repos), use the CLI: sourcecode repo-ir <path> --output ir.json
     Use get_compact_context or get_agent_context for non-Java repos.
 
     IR access paths (for full IR via CLI):
@@ -1097,7 +1097,7 @@ def get_ir_summary(repo_path: str = ".") -> dict:
 def fix_bug_context(repo_path: str = ".", symptom: str = "") -> dict:
     """Risk-ranked files for bug investigation, optionally focused by symptom.
 
-    Maps to: ask prepare-context fix-bug <repo_path> [--symptom <symptom>]
+    Maps to: sourcecode prepare-context fix-bug <repo_path> [--symptom <symptom>]
     Includes compact_base: security_surface, transactional_boundaries, spring_profiles.
     repo_path: absolute path to the repository (default: current working directory).
     symptom: optional error message or class name to focus the file ranking
@@ -1126,7 +1126,7 @@ def fix_bug_context(repo_path: str = ".", symptom: str = "") -> dict:
 def review_pr_context(repo_path: str = ".", since: str = "") -> dict:
     """Execution paths and risk analysis for changed files in a pull request.
 
-    Maps to: ask prepare-context review-pr <repo_path> [--since <since>]
+    Maps to: sourcecode prepare-context review-pr <repo_path> [--since <since>]
     Returns: compact_base + execution_paths (diff-scoped) + hotspots for changed files.
     repo_path: absolute path to the repository (default: current working directory).
     since: git ref to diff against (e.g. HEAD~3, main, origin/main).
@@ -1155,7 +1155,7 @@ def review_pr_context(repo_path: str = ".", since: str = "") -> dict:
 def onboard_context(repo_path: str = ".") -> dict:
     """Onboarding context: structured overview for new contributors.
 
-    Maps to: ask prepare-context onboard <repo_path>
+    Maps to: sourcecode prepare-context onboard <repo_path>
     repo_path: absolute path to the repository (default: current working directory).
     """
     _raw = repo_path
@@ -1178,7 +1178,7 @@ def onboard_context(repo_path: str = ".") -> dict:
 def explain_context(repo_path: str = ".") -> dict:
     """Architecture and entry-point explanation for a repository.
 
-    Maps to: ask prepare-context explain <repo_path>
+    Maps to: sourcecode prepare-context explain <repo_path>
     Returns: project summary, architecture, entry points, key dependencies.
     repo_path: absolute path to the repository (default: current working directory).
     """
@@ -1202,7 +1202,7 @@ def explain_context(repo_path: str = ".") -> dict:
 def refactor_context(repo_path: str = ".") -> dict:
     """Structural issues and refactor opportunities for a repository.
 
-    Maps to: ask prepare-context refactor <repo_path>
+    Maps to: sourcecode prepare-context refactor <repo_path>
     Returns: structural issues, coupling hotspots, improvement opportunities.
     repo_path: absolute path to the repository (default: current working directory).
     """
@@ -1226,7 +1226,7 @@ def refactor_context(repo_path: str = ".") -> dict:
 def generate_tests_context(repo_path: str = ".", include_all: bool = False) -> dict:
     """Untested source files and test gap analysis for a repository.
 
-    Maps to: ask prepare-context generate-tests <repo_path> [--all]
+    Maps to: sourcecode prepare-context generate-tests <repo_path> [--all]
     Returns: test_gaps list of untested files ranked by risk.
             On large repos (>2000 classes) analysis is bounded by SOURCECODE_TESTS_TIMEOUT_MS
             (default: 15000 ms). If timeout elapses, returns truncated=true with partial results.
@@ -1279,7 +1279,7 @@ def generate_tests_context(repo_path: str = ".", include_all: bool = False) -> d
 def get_impact_context(repo_path: str = ".", target: str = "", depth: int = 4) -> dict:
     """Blast-radius analysis: who calls a class and what breaks if it changes? Java only.
 
-    Maps to: ask impact <target> <repo_path> [--depth <depth>]
+    Maps to: sourcecode impact <target> <repo_path> [--depth <depth>]
     Returns: direct_callers, indirect_callers, endpoints_affected,
              transactional_boundaries_touched, risk_score, risk_level, stats.
 
@@ -1334,7 +1334,7 @@ def get_impact_context(repo_path: str = ".", target: str = "", depth: int = 4) -
 def modernize_context(repo_path: str = ".", format: str = "json") -> dict:
     """Analyzes codebase for modernization opportunities: dead zones, hotspot scores, upgrade candidates.
 
-    Maps to: ask modernize <repo_path>
+    Maps to: sourcecode modernize <repo_path>
     Returns: hotspot_candidates (high fan-in + git churn), statically_unreferenced (zero-caller classes — NOT confirmed dead; verify no framework dispatch) + framework_dispatched,
              high_coupling_nodes, subsystem_summary, cross_module_tangles, recommendation.
 
@@ -1368,9 +1368,9 @@ _TELEMETRY_ACTIONS = frozenset({"status", "enable", "disable"})
 
 @mcp.tool()
 def version() -> dict:
-    """Return ASK Engine version and MCP compatibility metadata.
+    """Return sourcecode version and MCP compatibility metadata.
 
-    Maps to: ask version
+    Maps to: sourcecode version
     Returns structured JSON: cli_version, mcp_schema_version, compatibility_schema_version.
     cli_version and mcp_schema_version are always identical (released together).
     """
@@ -1381,7 +1381,7 @@ def version() -> dict:
 def config() -> dict:
     """Show sourcecode CLI configuration.
 
-    Maps to: ask config
+    Maps to: sourcecode config
     """
     return _execute(["config"])
 
@@ -1390,7 +1390,7 @@ def config() -> dict:
 def telemetry(action: str) -> dict:
     """Manage telemetry settings.
 
-    Maps to: ask telemetry <action>
+    Maps to: sourcecode telemetry <action>
     action: one of "status" (show current state), "enable" (opt in), "disable" (opt out).
     Valid values: "status" | "enable" | "disable"
     """

sourcecode/mcp_nudge.py

@@ -26,7 +26,7 @@ _FLAG: Path = Path.home() / ".sourcecode" / "nudge_shown"
 
 _MSG = (
     "→ Claude Desktop detected. "
-    "Run `ask mcp init` to enable agent integration.\n"
+    "Run `sourcecode mcp init` to enable agent integration.\n"
 )
 
 # Module-level imports so names are patchable in tests.

sourcecode/migrate_check.py

@@ -1308,6 +1308,33 @@ def _dimension_score(
     return max(0, 100 - deduction)
 
 
+# --- Compact projection (output-shaping only) --------------------------------
+# `--compact` renders a bounded, decision-grade view of the SAME report: it caps
+# each large leaf collection to its top-N items and reports total/omitted counts.
+# It performs NO new analysis — it is a pure projection over the dict `to_dict()`
+# already produces (Semantic IR / ContextGraph / semantic engines untouched).
+# The default (full) output is unchanged and remains the baseline-oracle form.
+# FUTURE (not this increment): invert the default — emit compact by default and
+# add `--full` for the complete report — once the oracle baseline is recaptured.
+_COMPACT_TOP_N = 5
+
+
+def _cap_collection(items: list, top_n: int, key=None) -> dict:
+    """Project a list into a bounded `{total, shown, omitted, items}` view. Items
+    are optionally reordered by `key` (stable) so the retained slice is the most
+    important; ordering falls back to the engine's own emission order. No values
+    are recomputed — only selected and counted."""
+    total = len(items)
+    ordered = sorted(items, key=key) if key is not None else items
+    shown = ordered[:top_n]
+    return {
+        "total": total,
+        "shown": len(shown),
+        "omitted": max(0, total - len(shown)),
+        "items": shown,
+    }
+
+
 @dataclass
 class MigrationReport:
     schema_version: str = "1.4"
@@ -1679,6 +1706,43 @@ class MigrationReport:
             "metadata": self.metadata,
         }
 
+    def to_compact_dict(self, top_n: int = _COMPACT_TOP_N) -> dict:
+        """Bounded, decision-grade projection of `to_dict()`.
+
+        Keeps every decision field verbatim (readiness_score, per-dimension
+        readiness, headline_blocker, blocking_count, estimated_effort_days,
+        effort_breakdown, summary, Hibernate classification, aggregate counts) and
+        caps only the large leaf collections — top-level `findings` and the
+        Hibernate `rewrite_targets` / `findings` / `critical_call_chains` /
+        `golden_sql_hotspots` — to their top-`top_n` items, each wrapped as
+        `{total, shown, omitted, items}`. It reuses the already-computed
+        `to_dict()` output and recomputes nothing (output-shaping only)."""
+        full = self.to_dict()
+        compact = dict(full)
+        compact["mode"] = "compact"
+        compact["compact_note"] = (
+            f"Bounded decision summary: large collections are capped to the top {top_n} "
+            "items (see each collection's total/omitted). Run without --compact (JSON "
+            "default) for the complete report. A future release will invert this — "
+            "compact by default with --full for the full detail."
+        )
+        # Top-level findings: retain the most severe first, then engine order.
+        compact["findings"] = _cap_collection(
+            full["findings"], top_n,
+            key=lambda f: SEVERITY_ORDER.get(f.get("severity"), 3),
+        )
+        hib = full.get("hibernate")
+        if isinstance(hib, dict):
+            h = dict(hib)
+            for _col in (
+                "rewrite_targets", "findings",
+                "critical_call_chains", "golden_sql_hotspots",
+            ):
+                if isinstance(h.get(_col), list):
+                    h[_col] = _cap_collection(h[_col], top_n)
+            compact["hibernate"] = h
+        return compact
+
     def to_text(self, min_severity: str = "low") -> str:
         min_order = SEVERITY_ORDER.get(min_severity, 3)
         visible = [f for f in self.findings if SEVERITY_ORDER.get(f.severity, 3) <= min_order]