ctxloom-pro 1.0.31 → 1.1.0

package/apps/dashboard/dist/server/index.js

@@ -169,12 +169,12 @@ var init_VectorStore = __esm({
 // server/index.ts
 import express from "express";
 import cors from "cors";
-import path38 from "path";
-import fs31 from "fs";
+import path40 from "path";
+import fs32 from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // server/loader.ts
-import path32 from "path";
+import path34 from "path";
 
 // ../../packages/core/src/graph/DependencyGraph.ts
 import fs7 from "fs";
@@ -3133,8 +3133,8 @@ var CoChangeIndex = class _CoChangeIndex {
     if (event.isBulk || event.isMerge) return;
     const paths = event.files.map((f) => f.path);
     if (paths.length === 0) return;
-    for (const path39 of paths) {
-      this.nodeCounts.set(path39, (this.nodeCounts.get(path39) ?? 0) + 1);
+    for (const path41 of paths) {
+      this.nodeCounts.set(path41, (this.nodeCounts.get(path41) ?? 0) + 1);
     }
     for (let i = 0; i < paths.length; i++) {
       for (let j = i + 1; j < paths.length; j++) {
@@ -3281,8 +3281,8 @@ var ChurnIndex = class _ChurnIndex {
    */
   snapshot() {
     const nodes = {};
-    for (const [path39, raw] of this.nodes) {
-      nodes[path39] = {
+    for (const [path41, raw] of this.nodes) {
+      nodes[path41] = {
         commits: raw.commits,
         churnLines: raw.churnLines,
         bugCommits: raw.bugCommits,
@@ -3297,8 +3297,8 @@ var ChurnIndex = class _ChurnIndex {
    */
   static load(s) {
     const idx = new _ChurnIndex();
-    for (const [path39, raw] of Object.entries(s.nodes)) {
-      idx.nodes.set(path39, {
+    for (const [path41, raw] of Object.entries(s.nodes)) {
+      idx.nodes.set(path41, {
         commits: raw.commits,
         churnLines: raw.churnLines,
         bugCommits: raw.bugCommits,
@@ -3311,8 +3311,8 @@ var ChurnIndex = class _ChurnIndex {
   // -------------------------------------------------------------------------
   // Private helpers
   // -------------------------------------------------------------------------
-  getOrCreate(path39) {
-    const existing = this.nodes.get(path39);
+  getOrCreate(path41) {
+    const existing = this.nodes.get(path41);
     if (existing !== void 0) return existing;
     const fresh = {
       commits: 0,
@@ -3321,7 +3321,7 @@ var ChurnIndex = class _ChurnIndex {
       authorCounts: {},
       lastTouch: 0
     };
-    this.nodes.set(path39, fresh);
+    this.nodes.set(path41, fresh);
     return fresh;
   }
 };
@@ -3402,12 +3402,12 @@ var OwnershipIndex = class _OwnershipIndex {
    */
   snapshot() {
     const nodes = {};
-    for (const [path39, raw] of this.nodes) {
+    for (const [path41, raw] of this.nodes) {
       const authorWeights = {};
       for (const [email, entry] of Object.entries(raw.authorWeights)) {
         authorWeights[email] = { ...entry };
       }
-      nodes[path39] = { authorWeights, lastTouch: raw.lastTouch };
+      nodes[path41] = { authorWeights, lastTouch: raw.lastTouch };
     }
     return { version: 1, nodes };
   }
@@ -3416,23 +3416,23 @@ var OwnershipIndex = class _OwnershipIndex {
    */
   static load(s) {
     const idx = new _OwnershipIndex();
-    for (const [path39, raw] of Object.entries(s.nodes)) {
+    for (const [path41, raw] of Object.entries(s.nodes)) {
       const authorWeights = {};
       for (const [email, entry] of Object.entries(raw.authorWeights)) {
         authorWeights[email] = { ...entry };
       }
-      idx.nodes.set(path39, { authorWeights, lastTouch: raw.lastTouch });
+      idx.nodes.set(path41, { authorWeights, lastTouch: raw.lastTouch });
     }
     return idx;
   }
   // -------------------------------------------------------------------------
   // Private helpers
   // -------------------------------------------------------------------------
-  getOrCreate(path39) {
-    const existing = this.nodes.get(path39);
+  getOrCreate(path41) {
+    const existing = this.nodes.get(path41);
     if (existing !== void 0) return existing;
     const fresh = { authorWeights: {}, lastTouch: 0 };
-    this.nodes.set(path39, fresh);
+    this.nodes.set(path41, fresh);
     return fresh;
   }
 };
@@ -4670,8 +4670,8 @@ function getErrorMap() {
 
 // ../../node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path39, errorMaps, issueData } = params;
-  const fullPath = [...path39, ...issueData.path || []];
+  const { data, path: path41, errorMaps, issueData } = params;
+  const fullPath = [...path41, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -4787,11 +4787,11 @@ var errorUtil;
 
 // ../../node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path39, key) {
+  constructor(parent, value, path41, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path39;
+    this._path = path41;
     this._key = key;
   }
   get path() {
@@ -8233,21 +8233,33 @@ var coerce = {
 };
 var NEVER = INVALID;
 
+// ../../packages/core/src/tools/projectRootParam.ts
+var PROJECT_ROOT_DESCRIPTION = "Absolute path or registered alias of the project to operate on. Falls back to CTXLOOM_ROOT env, then server cwd. Register aliases with `ctxloom register <path> --alias <name>`.";
+var ProjectRootField = external_exports.string().optional().describe(PROJECT_ROOT_DESCRIPTION);
+
+// ../../packages/core/src/tools/registry.ts
+init_logger();
+
 // ../../packages/core/src/tools/search.ts
 init_embedder();
 var Schema = external_exports.object({
   query: external_exports.string().describe("Search query \u2014 natural language or code fragment"),
-  limit: external_exports.number().max(100).optional().default(10).describe("Maximum results to return")
+  limit: external_exports.number().max(100).optional().default(10).describe("Maximum results to return"),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/file.ts
-var Schema2 = external_exports.object({ path: external_exports.string().describe("Relative path to the file") });
+var Schema2 = external_exports.object({
+  path: external_exports.string().describe("Relative path to the file"),
+  project_root: ProjectRootField
+});
 
 // ../../packages/core/src/tools/context-packet.ts
 import path16 from "path";
 var Schema3 = external_exports.object({
   target_file: external_exports.string().describe("Relative path to the primary file"),
-  mode: external_exports.enum(["edit", "read"]).optional().default("edit").describe("Context mode")
+  mode: external_exports.enum(["edit", "read"]).optional().default("edit").describe("Context mode"),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/findCallers.ts
@@ -8258,17 +8270,25 @@ var Schema4 = external_exports.object({
   symbol: external_exports.string().describe("Symbol name to search for"),
   direction: external_exports.enum(["callers", "callees"]).optional().default("callers").describe("Traversal direction"),
   depth: external_exports.number().max(10).optional().default(1).describe("Transitive traversal depth (max 10)"),
-  target_file: external_exports.string().optional().describe("Optional: relative file path to start from")
+  target_file: external_exports.string().optional().describe("Optional: relative file path to start from"),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/definition.ts
-var Schema5 = external_exports.object({ symbol: external_exports.string().describe("Symbol name to look up") });
+var Schema5 = external_exports.object({
+  symbol: external_exports.string().describe("Symbol name to look up"),
+  project_root: ProjectRootField
+});
+
+// ../../packages/core/src/tools/rules.ts
+var Schema6 = external_exports.object({ project_root: ProjectRootField });
 
 // ../../packages/core/src/tools/similar-files.ts
 init_embedder();
-var Schema6 = external_exports.object({
+var Schema7 = external_exports.object({
   target_file: external_exports.string().describe("Relative path to the file to find similar files for"),
-  limit: external_exports.number().max(100).optional().default(10).describe("Maximum results to return")
+  limit: external_exports.number().max(100).optional().default(10).describe("Maximum results to return"),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/blast-radius.ts
@@ -8276,37 +8296,40 @@ import { exec } from "child_process";
 import { promisify } from "util";
 init_logger();
 var execAsync = promisify(exec);
-var Schema7 = external_exports.object({
+var Schema8 = external_exports.object({
   changed_files: external_exports.array(external_exports.string()).optional().describe("Changed file paths (relative). Defaults to git diff HEAD~1."),
   depth: external_exports.number().min(1).max(10).optional().default(3).describe("Traversal depth (default: 3)"),
   use_git: external_exports.boolean().optional().default(true).describe("Auto-detect changed files from git diff HEAD~1"),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) returns full per-file listings. "minimal" returns counts only \u2014 ~60% fewer tokens.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/hub-nodes.ts
-var Schema8 = external_exports.object({
+var Schema9 = external_exports.object({
   limit: external_exports.number().min(1).max(100).optional().default(20).describe("Number of hub nodes to return (default: 20)"),
   min_degree: external_exports.number().min(0).optional().default(2).describe("Minimum total degree to include (default: 2)"),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) returns full per-file listings. "minimal" returns counts only \u2014 ~60% fewer tokens.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/bridge-nodes.ts
-var Schema9 = external_exports.object({
+var Schema10 = external_exports.object({
   limit: external_exports.number().min(1).max(100).optional().default(20).describe("Number of bridge nodes to return (default: 20)"),
   sample: external_exports.number().min(10).max(1e3).optional().default(200).describe(
     "Max source nodes for BFS sampling (default: 200). Lower = faster but approximate."
   ),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) returns full per-file listings. "minimal" returns counts only \u2014 ~60% fewer tokens.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/community-list.ts
-var Schema10 = external_exports.object({
+var Schema11 = external_exports.object({
   show_files: external_exports.boolean().optional().default(false).describe(
     "Include member file paths in output (default: false for compact output)"
   ),
@@ -8321,22 +8344,24 @@ var Schema10 = external_exports.object({
   ),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) returns paged community list. "minimal" returns counts only \u2014 useful for a quick size check before paging.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/architecture-overview.ts
-var Schema11 = external_exports.object({
+var Schema12 = external_exports.object({
   hub_limit: external_exports.number().min(1).max(10).optional().default(3).describe(
     "Number of top hub files to show per community (default: 3)"
   ),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) returns full per-community listings. "minimal" returns counts only \u2014 ~60% fewer tokens.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/knowledge-gaps.ts
 import path18 from "path";
-var Schema12 = external_exports.object({
+var Schema13 = external_exports.object({
   min_importers: external_exports.number().min(1).max(50).optional().default(3).describe(
     "Minimum importers to qualify as an untested hub (default: 3)"
   ),
@@ -8345,11 +8370,12 @@ var Schema12 = external_exports.object({
   ),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) returns full per-file listings. "minimal" returns counts only \u2014 ~60% fewer tokens.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/surprising-connections.ts
-var Schema13 = external_exports.object({
+var Schema14 = external_exports.object({
   max_cycles: external_exports.number().min(1).max(100).optional().default(20).describe(
     "Max circular dependency cycles to report (default: 20)"
   ),
@@ -8358,25 +8384,28 @@ var Schema13 = external_exports.object({
   ),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) returns full per-item listings. "minimal" returns counts only \u2014 ~60% fewer tokens.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/wiki-generate.ts
 import fs16 from "fs";
-var Schema14 = external_exports.object({
+var Schema15 = external_exports.object({
   force: external_exports.boolean().optional().default(false).describe(
     "Regenerate all pages even if content unchanged (default: false)"
   ),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) lists each written page with size. "minimal" returns counts only.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/graph-export.ts
-var Schema15 = external_exports.object({
+var Schema16 = external_exports.object({
   format: external_exports.enum(["graphml", "dot", "obsidian", "svg", "html"]).describe(
     "Output format: graphml (Gephi/yEd), dot (Graphviz), obsidian (wikilink vault), svg (inline, no dependencies), html (interactive D3.js browser view)"
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/git-diff-review.ts
@@ -8384,7 +8413,7 @@ import { execFile } from "child_process";
 import { promisify as promisify2 } from "util";
 init_logger();
 var execFileAsync = promisify2(execFile);
-var Schema16 = external_exports.object({
+var Schema17 = external_exports.object({
   changed_files: external_exports.array(external_exports.string()).optional().describe(
     "Changed file paths (relative to project root). Omit to auto-detect from git diff HEAD~1."
   ),
@@ -8395,22 +8424,24 @@ var Schema16 = external_exports.object({
   ),
   max_diff_lines: external_exports.number().min(10).max(2e3).optional().default(300).describe(
     "Max diff lines to include per file (default: 300)"
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/refactor-preview.ts
 import fs17 from "fs";
 import path19 from "path";
-var Schema17 = external_exports.object({
+var Schema18 = external_exports.object({
   symbol: external_exports.string().min(1).describe("Symbol name to rename (exact match, case-sensitive)"),
   new_name: external_exports.string().min(1).describe("New name for the symbol"),
   max_files: external_exports.number().min(1).max(200).optional().default(50).describe(
     "Maximum number of files to scan for occurrences (default: 50)"
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/execution-flow.ts
-var Schema18 = external_exports.object({
+var Schema19 = external_exports.object({
   entry_point: external_exports.string().min(1).describe("Symbol name to start the execution flow from"),
   entry_file: external_exports.string().optional().describe(
     "File path containing the entry symbol (relative). Disambiguates when the same symbol name appears in multiple files."
@@ -8418,7 +8449,8 @@ var Schema18 = external_exports.object({
   depth: external_exports.number().min(1).max(20).optional().default(10).describe("Max traversal depth (default: 10)"),
   max_nodes: external_exports.number().min(1).max(200).optional().default(50).describe(
     "Max total steps to include in output (default: 50)"
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/cross-repo-search.ts
@@ -8427,20 +8459,21 @@ init_VectorStore();
 init_logger();
 import fs18 from "fs";
 import path20 from "path";
-var Schema19 = external_exports.object({
+var Schema20 = external_exports.object({
   query: external_exports.string().min(1).describe("Search query \u2014 natural language or code fragment"),
   limit: external_exports.number().min(1).max(100).optional().default(10).describe(
     "Maximum total results across all repos (default: 10)"
   ),
   repos: external_exports.array(external_exports.string()).optional().describe(
     "Specific repo root paths to search. Omit to search all registered repos."
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/apply-refactor.ts
 import fs19 from "fs";
 import path21 from "path";
-var Schema20 = external_exports.object({
+var Schema21 = external_exports.object({
   symbol: external_exports.string().min(1).describe("Symbol name to rename (exact, case-sensitive)"),
   new_name: external_exports.string().min(1).describe("New name for the symbol"),
   dry_run: external_exports.boolean().optional().default(false).describe(
@@ -8448,7 +8481,8 @@ var Schema20 = external_exports.object({
   ),
   max_files: external_exports.number().min(1).max(200).optional().default(50).describe(
     "Maximum candidate files to process (default: 50)"
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/detect-changes.ts
@@ -8456,24 +8490,26 @@ import { exec as exec2 } from "child_process";
 import { promisify as promisify3 } from "util";
 init_logger();
 var execAsync2 = promisify3(exec2);
-var Schema21 = external_exports.object({
+var Schema22 = external_exports.object({
   changed_files: external_exports.array(external_exports.string()).optional(),
   use_git: external_exports.boolean().optional().default(true),
   depth: external_exports.number().min(1).max(10).optional().default(3),
   detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
     '"standard" (default) returns full per-file risk details. "minimal" returns counts only \u2014 ~60% fewer tokens.'
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/full-text-search.ts
 import fs20 from "fs";
 import path22 from "path";
-var Schema22 = external_exports.object({
+var Schema23 = external_exports.object({
   query: external_exports.string().min(1).describe("Search term \u2014 literal or /regex/"),
   mode: external_exports.enum(["hybrid", "keyword", "semantic"]).optional().default("hybrid"),
   case_sensitive: external_exports.boolean().optional().default(false),
   limit: external_exports.number().min(1).max(100).optional().default(20),
-  context_lines: external_exports.number().min(0).max(5).optional().default(1)
+  context_lines: external_exports.number().min(0).max(5).optional().default(1),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/suggested-questions.ts
@@ -8481,14 +8517,16 @@ init_logger();
 import { exec as exec3 } from "child_process";
 import { promisify as promisify4 } from "util";
 var execAsync3 = promisify4(exec3);
-var Schema23 = external_exports.object({
+var Schema24 = external_exports.object({
   changed_files: external_exports.array(external_exports.string()).optional(),
-  use_git: external_exports.boolean().optional().default(true)
+  use_git: external_exports.boolean().optional().default(true),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/get-workflow.ts
-var Schema24 = external_exports.object({
-  workflow: external_exports.enum(["review", "debug", "onboard", "refactor", "audit"])
+var Schema25 = external_exports.object({
+  workflow: external_exports.enum(["review", "debug", "onboard", "refactor", "audit"]),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/graph-snapshot.ts
@@ -8500,7 +8538,8 @@ var schema = external_exports.object({
   ),
   overwrite: external_exports.boolean().default(false).describe(
     "If true, overwrite an existing snapshot with the same name."
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/graph-diff.ts
@@ -8508,7 +8547,8 @@ import fs22 from "fs";
 import path24 from "path";
 var schema2 = external_exports.object({
   baseline: external_exports.string().min(1).describe('Name of the baseline snapshot (the "before" state).'),
-  current: external_exports.string().min(1).describe('Name of the current snapshot (the "after" state).')
+  current: external_exports.string().min(1).describe('Name of the current snapshot (the "after" state).'),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/find-large-functions.ts
@@ -8521,20 +8561,23 @@ var schema3 = external_exports.object({
   ),
   limit: external_exports.number().int().min(1).max(200).default(30).describe(
     "Maximum results to return (default: 30)."
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/git-coupling.ts
-var Schema25 = external_exports.object({
+var Schema26 = external_exports.object({
   file: external_exports.string().describe("File path to look up co-changed siblings for"),
   limit: external_exports.number().int().min(1).max(50).default(10),
   min_confidence: external_exports.number().min(0).max(1).default(0.05),
-  half_life_days: external_exports.number().int().min(1).max(3650).default(90)
+  half_life_days: external_exports.number().int().min(1).max(3650).default(90),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/risk-overlay.ts
-var Schema26 = external_exports.object({
-  nodes: external_exports.array(external_exports.string()).min(1).max(200).describe("File paths to score")
+var Schema27 = external_exports.object({
+  nodes: external_exports.array(external_exports.string()).min(1).max(200).describe("File paths to score"),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/rules/loadConfig.ts
@@ -11140,12 +11183,15 @@ var RulesConfigSchema = external_exports.object({
   rules: external_exports.array(RuleSchema).default([])
 });
 
+// ../../packages/core/src/tools/rules-check.ts
+var Schema28 = external_exports.object({ project_root: ProjectRootField });
+
 // ../../packages/core/src/tools/get-affected-flows.ts
 init_logger();
 import { exec as exec4 } from "child_process";
 import { promisify as promisify5 } from "util";
 var execAsync4 = promisify5(exec4);
-var Schema27 = external_exports.object({
+var Schema29 = external_exports.object({
   changed_files: external_exports.array(external_exports.string()).optional().describe(
     "Changed file paths (relative). Defaults to auto-detection from git diff HEAD~1."
   ),
@@ -11160,7 +11206,8 @@ var Schema27 = external_exports.object({
   ),
   max_steps_per_flow: external_exports.number().min(1).max(100).optional().default(30).describe(
     "Max call chain steps per flow (default: 30)"
-  )
+  ),
+  project_root: ProjectRootField
 });
 
 // ../../packages/core/src/tools/ruleManager.ts
@@ -11226,9 +11273,19 @@ var TELEMETRY_DISABLED = process.env["CTXLOOM_NO_TELEMETRY"] === "1" || process.
 var POSTHOG_KEY = process.env["POSTHOG_API_KEY"] ?? (typeof __TELEMETRY_POSTHOG_KEY__ === "string" ? __TELEMETRY_POSTHOG_KEY__ : "");
 var SENTRY_DSN = process.env["SENTRY_DSN"] ?? (typeof __TELEMETRY_SENTRY_DSN__ === "string" ? __TELEMETRY_SENTRY_DSN__ : "");
 
+// ../../packages/core/src/server/ProjectState.ts
+import path32 from "path";
+
+// ../../packages/core/src/server/ProjectStateManager.ts
+init_logger();
+
+// ../../packages/core/src/server/resolveProjectRoot.ts
+import fs29 from "fs";
+import path33 from "path";
+
 // server/loader.ts
 async function loadContext(root) {
-  const absRoot = path32.resolve(root);
+  const absRoot = path34.resolve(root);
   const overlay = new GitOverlayStore(absRoot);
   const gitEnabled = await overlay.loadSnapshot();
   const graph = new DependencyGraph();
@@ -11481,21 +11538,21 @@ function buildOwnershipRouter(ctx) {
 
 // server/routes/file.ts
 import { Router as Router7 } from "express";
-import fs29 from "fs/promises";
-import path33 from "path";
+import fs30 from "fs/promises";
+import path35 from "path";
 function buildFileRouter(ctx) {
   const router = Router7();
   router.get("/", async (req, res) => {
     const rel = req.query.path;
     if (!rel) return res.status(400).json({ error: "missing path" });
-    const abs = path33.resolve(ctx.root, rel);
-    const rootBoundary = ctx.root.endsWith(path33.sep) ? ctx.root : ctx.root + path33.sep;
+    const abs = path35.resolve(ctx.root, rel);
+    const rootBoundary = ctx.root.endsWith(path35.sep) ? ctx.root : ctx.root + path35.sep;
     if (abs !== ctx.root && !abs.startsWith(rootBoundary)) {
       return res.status(403).json({ error: "forbidden" });
     }
     try {
-      const content = await fs29.readFile(abs, "utf-8");
-      const ext = path33.extname(abs).slice(1);
+      const content = await fs30.readFile(abs, "utf-8");
+      const ext = path35.extname(abs).slice(1);
       res.json({ content, lines: content.split("\n").length, ext });
     } catch {
       res.status(404).json({ error: "not found" });
@@ -11507,7 +11564,7 @@ function buildFileRouter(ctx) {
 // server/routes/open.ts
 import { Router as Router8 } from "express";
 import { execFile as execFile2 } from "child_process";
-import path34 from "path";
+import path36 from "path";
 function tryOpen(bin, abs) {
   return new Promise((resolve) => {
     execFile2(bin, [abs], { timeout: 5e3 }, (err) => resolve(!err));
@@ -11518,8 +11575,8 @@ function buildOpenRouter(ctx) {
   router.post("/", async (req, res) => {
     const rel = req.body?.path;
     if (!rel || typeof rel !== "string") return res.status(400).json({ error: "missing path" });
-    const abs = path34.resolve(ctx.root, rel);
-    const rootBoundary = ctx.root.endsWith(path34.sep) ? ctx.root : ctx.root + path34.sep;
+    const abs = path36.resolve(ctx.root, rel);
+    const rootBoundary = ctx.root.endsWith(path36.sep) ? ctx.root : ctx.root + path36.sep;
     if (abs !== ctx.root && !abs.startsWith(rootBoundary)) {
       return res.status(403).json({ error: "forbidden" });
     }
@@ -11531,8 +11588,8 @@ function buildOpenRouter(ctx) {
 
 // server/routes/tokens.ts
 import { Router as Router9 } from "express";
-import path35 from "path";
-import fs30 from "fs";
+import path37 from "path";
+import fs31 from "fs";
 var CHARS_PER_TOKEN = 4;
 var cache = null;
 function buildTokensRouter(ctx) {
@@ -11547,9 +11604,9 @@ function buildTokensRouter(ctx) {
     let fullChars = 0;
     let skeletonChars = 0;
     for (const file of files) {
-      const absPath = path35.join(ctx.root, file);
+      const absPath = path37.join(ctx.root, file);
       try {
-        const content = fs30.readFileSync(absPath, "utf-8");
+        const content = fs31.readFileSync(absPath, "utf-8");
         fullChars += content.length;
         const skeleton = await skeletonizer.skeletonize(absPath);
         skeletonChars += skeleton.length;
@@ -11650,17 +11707,17 @@ function buildFileTrendsRouter(ctx) {
 
 // server/routes/projects.ts
 import { Router as Router12 } from "express";
-import path37 from "path";
+import path39 from "path";
 
 // server/projects.ts
 import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
 import os4 from "os";
-import path36 from "path";
+import path38 from "path";
 import crypto5 from "crypto";
 var HOME = os4.homedir();
-var REGISTRY_PATH = path36.join(HOME, ".ctxloom", "repos.json");
+var REGISTRY_PATH = path38.join(HOME, ".ctxloom", "repos.json");
 function slugFor(root) {
-  const abs = path36.resolve(root);
+  const abs = path38.resolve(root);
   return crypto5.createHash("sha1").update(abs).digest("hex").slice(0, 12);
 }
 function readRegistry() {
@@ -11675,28 +11732,30 @@ function readRegistry() {
   }
 }
 function listProjects(defaultRoot) {
-  const absDefault = path36.resolve(defaultRoot);
+  const absDefault = path38.resolve(defaultRoot);
   const out = [
     {
       slug: slugFor(absDefault),
-      name: path36.basename(absDefault) || absDefault,
+      name: path38.basename(absDefault) || absDefault,
       root: absDefault,
       isDefault: true,
-      hasSnapshot: existsSync2(path36.join(absDefault, ".ctxloom"))
+      hasSnapshot: existsSync2(path38.join(absDefault, ".ctxloom"))
     }
   ];
   const seen = /* @__PURE__ */ new Set([absDefault]);
   for (const entry of readRegistry()) {
-    const abs = path36.resolve(entry.root);
+    const abs = path38.resolve(entry.root);
     if (seen.has(abs)) continue;
     seen.add(abs);
-    out.push({
+    const item = {
       slug: slugFor(abs),
-      name: entry.name ?? (path36.basename(abs) || abs),
+      name: entry.name ?? (path38.basename(abs) || abs),
       root: abs,
       isDefault: false,
-      hasSnapshot: existsSync2(path36.join(abs, ".ctxloom"))
-    });
+      hasSnapshot: existsSync2(path38.join(abs, ".ctxloom"))
+    };
+    if (entry.alias !== void 0) item.alias = entry.alias;
+    out.push(item);
   }
   return out;
 }
@@ -11746,7 +11805,7 @@ function buildProjectsRouter(deps) {
     } catch (err) {
       const detail = err instanceof Error ? err.message : String(err);
       res.status(500).json({
-        error: `failed to switch to ${path37.basename(target.root)}: ${detail}`
+        error: `failed to switch to ${path39.basename(target.root)}: ${detail}`
       });
     }
   });
@@ -11754,7 +11813,7 @@ function buildProjectsRouter(deps) {
 }
 
 // server/index.ts
-var __dirname2 = path38.dirname(fileURLToPath2(import.meta.url));
+var __dirname2 = path40.dirname(fileURLToPath2(import.meta.url));
 async function startDashboard(options) {
   const { root, port, open } = options;
   console.log(`ctxloom dashboard \u2014 loading context from ${root}...`);
@@ -11813,9 +11872,9 @@ async function startDashboard(options) {
       }
       activeWatcher = null;
     }
-    const snapshotDir = path38.join(targetRoot, ".ctxloom");
+    const snapshotDir = path40.join(targetRoot, ".ctxloom");
     try {
-      activeWatcher = fs31.watch(snapshotDir, (_event, filename) => {
+      activeWatcher = fs32.watch(snapshotDir, (_event, filename) => {
         if (!filename || !filename.includes("snapshot")) return;
         if (debounce) clearTimeout(debounce);
         debounce = setTimeout(async () => {
@@ -11843,12 +11902,12 @@ async function startDashboard(options) {
       attachSnapshotWatcher(newRoot);
     }
   }));
-  const clientDist = path38.join(__dirname2, "../dashboard/client");
-  const clientDistExists = fs31.existsSync(path38.join(clientDist, "index.html"));
+  const clientDist = path40.join(__dirname2, "../dashboard/client");
+  const clientDistExists = fs32.existsSync(path40.join(clientDist, "index.html"));
   if (clientDistExists) {
     app.use(express.static(clientDist, { dotfiles: "allow" }));
     app.get(/.*/, (_req, res) => {
-      res.sendFile(path38.join(clientDist, "index.html"), { dotfiles: "allow" });
+      res.sendFile(path40.join(clientDist, "index.html"), { dotfiles: "allow" });
     });
   } else {
     app.get(/^\/(?!api\/).*/, (_req, res) => {