esedre 0.1.4 → 0.1.6

package/dist/esedre.mjs

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
 
 // bin/esedre.ts
-import fs8 from "node:fs";
-import path8 from "node:path";
+import fs9 from "node:fs";
+import path9 from "node:path";
 
 // src/storage/filesystem.ts
 import fs3 from "node:fs";
 import path3 from "node:path";
 
 // src/types.ts
+var CURRENT_ESEDRE_VERSION = "0.1.6";
 var EsedreConflictError = class extends Error {
   constructor(ticketId, currentHash, lastHash) {
     super(
@@ -27,9 +28,18 @@ var EsedreConflictError = class extends Error {
 // src/config.ts
 import fs from "node:fs";
 import path from "node:path";
+import os from "node:os";
 var DEFAULT_ESEDRE_PORT = 5674;
-var MAX_PROJECT_CODE_LENGTH = 6;
-var PROJECT_CODE_REGEX = /^[a-zA-Z0-9]{1,6}$/;
+var MAX_PROJECT_CODE_LENGTH = 7;
+var PROJECT_CODE_REGEX = /^[a-zA-Z0-9]{1,7}$/;
+var MAX_PROJECT_NAME_LENGTH = 48;
+function resolvePorts(config, overrides) {
+  const globalConfig = readGlobalConfig();
+  const gateway = overrides?.gatewayPort ?? overrides?.port ?? overrides?.ports?.gateway ?? config?.ports?.gateway ?? config?.port ?? globalConfig?.ports?.gateway ?? globalConfig?.port ?? DEFAULT_ESEDRE_PORT;
+  const ui = overrides?.uiPort ?? overrides?.ports?.ui ?? config?.ports?.ui ?? globalConfig?.ports?.ui ?? gateway + 1;
+  const api = overrides?.apiPort ?? overrides?.ports?.api ?? config?.ports?.api ?? globalConfig?.ports?.api ?? gateway + 2;
+  return { gateway, ui, api };
+}
 var EsedreAuthorizationError = class extends Error {
   constructor(projectCode, message) {
     super(message || `Access Denied: Project '${projectCode}' is outside this workspace's authorized scope.`);
@@ -46,7 +56,7 @@ function validateProjectCode(code, existingCodes) {
   if (!PROJECT_CODE_REGEX.test(trimmed)) {
     return {
       valid: false,
-      error: `Project code '${trimmed}' is invalid. It must be 1 to ${MAX_PROJECT_CODE_LENGTH} alphanumeric characters (e.g. CORE, WEB, DOCS).`
+      error: `Project code '${trimmed}' is invalid. It must be 1 to ${MAX_PROJECT_CODE_LENGTH} alphanumeric characters (e.g. CORE, ALCE, WEB).`
     };
   }
   if (existingCodes && existingCodes.length > 0) {
@@ -61,6 +71,22 @@ function validateProjectCode(code, existingCodes) {
   }
   return { valid: true };
 }
+function validateProjectName(name) {
+  if (!name || typeof name !== "string") {
+    return { valid: false, error: "Project name is required." };
+  }
+  const trimmed = name.trim();
+  if (trimmed.length === 0) {
+    return { valid: false, error: "Project name cannot be empty." };
+  }
+  if (trimmed.length > MAX_PROJECT_NAME_LENGTH) {
+    return {
+      valid: false,
+      error: `Project name '${trimmed}' exceeds maximum length of ${MAX_PROJECT_NAME_LENGTH} characters.`
+    };
+  }
+  return { valid: true };
+}
 function isProjectAuthorized(projectCode, allowedProjects) {
   if (!allowedProjects || allowedProjects.length === 0) {
     return true;
@@ -72,35 +98,277 @@ function isProjectAuthorized(projectCode, allowedProjects) {
   const normalized = projectCode.trim().toUpperCase();
   return normalizedList.includes(normalized);
 }
-function findEsedreConfig(startDir) {
+function getGlobalConfigDir() {
+  if (process.env.ESEDRE_GLOBAL_DIR) {
+    return process.env.ESEDRE_GLOBAL_DIR;
+  }
+  return path.join(os.homedir(), ".esedre");
+}
+function getGlobalConfigPath() {
+  return path.join(getGlobalConfigDir(), "config.json");
+}
+function expandHome(filePath) {
+  if (!filePath) return filePath;
+  if (filePath === "~" || filePath.startsWith("~/") || filePath.startsWith("~\\")) {
+    return path.join(os.homedir(), filePath.slice(1));
+  }
+  return filePath;
+}
+function readGlobalConfig() {
+  const configPath = getGlobalConfigPath();
+  if (!fs.existsSync(configPath)) {
+    return null;
+  }
+  try {
+    const raw = fs.readFileSync(configPath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function writeGlobalConfig(config) {
+  const dir = getGlobalConfigDir();
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  const configPath = getGlobalConfigPath();
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  try {
+    writeGlobalVersion(config.version || CURRENT_ESEDRE_VERSION);
+  } catch {
+  }
+}
+function getGlobalVersionPath() {
+  return path.join(getGlobalConfigDir(), "version");
+}
+function writeGlobalVersion(version = CURRENT_ESEDRE_VERSION) {
+  const dir = getGlobalConfigDir();
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(getGlobalVersionPath(), version.trim() + "\n", "utf-8");
+}
+function addLocationToGlobalConfig(targetPath) {
+  const resolved = path.resolve(expandHome(targetPath));
+  if (!fs.existsSync(resolved)) {
+    throw new Error(`Target path does not exist: "${targetPath}" (resolved: ${resolved})`);
+  }
+  const current = readGlobalConfig() || { version: CURRENT_ESEDRE_VERSION, port: DEFAULT_ESEDRE_PORT };
+  const hasProjectsDir = fs.existsSync(path.join(resolved, "projects"));
+  const hasProjectsJson = fs.existsSync(path.join(resolved, "projects.json"));
+  if (hasProjectsDir || hasProjectsJson) {
+    let projectCount = 0;
+    if (hasProjectsJson) {
+      try {
+        const pjs = JSON.parse(fs.readFileSync(path.join(resolved, "projects.json"), "utf-8"));
+        if (Array.isArray(pjs)) projectCount = pjs.length;
+      } catch {
+      }
+    } else if (hasProjectsDir) {
+      try {
+        projectCount = fs.readdirSync(path.join(resolved, "projects")).filter((e) => {
+          return fs.statSync(path.join(resolved, "projects", e)).isDirectory();
+        }).length;
+      } catch {
+      }
+    }
+    const currentDataDirs = Array.isArray(current.dataDir) ? current.dataDir : current.dataDir ? [current.dataDir] : [];
+    const normalizedResolved = resolved.replace(/\\/g, "/");
+    const existingIdx = currentDataDirs.findIndex(
+      (d) => path.resolve(expandHome(d)).replace(/\\/g, "/") === normalizedResolved
+    );
+    if (existingIdx === -1) {
+      currentDataDirs.push(normalizedResolved);
+    }
+    current.dataDir = currentDataDirs.length === 1 ? currentDataDirs[0] : currentDataDirs;
+    writeGlobalConfig(current);
+    return { type: "hub", path: normalizedResolved, projectCount };
+  }
+  const inRepoConfig = path.join(resolved, ".esedre", "esedre.json");
+  const inRepoRootConfig = path.join(resolved, "esedre.json");
+  const inRepoProjectJson = path.join(resolved, ".esedre", "project.json");
+  const inRepoRootProjectJson = path.join(resolved, "project.json");
+  let code;
+  let name;
+  for (const cand of [inRepoConfig, inRepoRootConfig, inRepoProjectJson, inRepoRootProjectJson]) {
+    if (fs.existsSync(cand)) {
+      try {
+        const parsed = JSON.parse(fs.readFileSync(cand, "utf-8"));
+        if (parsed.projectCode) code = parsed.projectCode;
+        if (parsed.code && !code) code = parsed.code;
+        if (parsed.projectName) name = parsed.projectName;
+        if (parsed.name && !name) name = parsed.name;
+        if (code) break;
+      } catch {
+      }
+    }
+  }
+  if (code) {
+    const normalizedCode = code.toUpperCase();
+    const normalizedResolved = resolved.replace(/\\/g, "/");
+    if (!current.projects) {
+      current.projects = {};
+    }
+    current.projects[normalizedCode] = normalizedResolved;
+    writeGlobalConfig(current);
+    return { type: "project", code: normalizedCode, name, path: normalizedResolved };
+  }
+  return { type: "uninitialized", path: resolved.replace(/\\/g, "/") };
+}
+function removeLocationFromGlobalConfig(identifier) {
+  const current = readGlobalConfig();
+  if (!current) return { removed: false };
+  const trimmed = identifier.trim();
+  const normalizedId = trimmed.toUpperCase();
+  if (current.projects && current.projects[normalizedId]) {
+    const target = current.projects[normalizedId];
+    delete current.projects[normalizedId];
+    if (Object.keys(current.projects).length === 0) {
+      delete current.projects;
+    }
+    writeGlobalConfig(current);
+    return { removed: true, type: "project", target };
+  }
+  if (current.projects) {
+    for (const [code, p] of Object.entries(current.projects)) {
+      if (path.resolve(expandHome(p)).toLowerCase() === path.resolve(expandHome(trimmed)).toLowerCase()) {
+        delete current.projects[code];
+        if (Object.keys(current.projects).length === 0) {
+          delete current.projects;
+        }
+        writeGlobalConfig(current);
+        return { removed: true, type: "project", target: p };
+      }
+    }
+  }
+  if (current.dataDir) {
+    const currentDataDirs = Array.isArray(current.dataDir) ? current.dataDir : [current.dataDir];
+    const initialLen = currentDataDirs.length;
+    const remaining = currentDataDirs.filter(
+      (d) => path.resolve(expandHome(d)).toLowerCase() !== path.resolve(expandHome(trimmed)).toLowerCase()
+    );
+    if (remaining.length !== initialLen) {
+      current.dataDir = remaining.length === 0 ? void 0 : remaining.length === 1 ? remaining[0] : remaining;
+      writeGlobalConfig(current);
+      return { removed: true, type: "hub", target: trimmed };
+    }
+  }
+  return { removed: false };
+}
+function getGlobalConfigKey(key) {
+  const current = readGlobalConfig();
+  if (!current) return void 0;
+  if (key.includes(".")) {
+    const parts = key.split(".");
+    let val = current;
+    for (const part of parts) {
+      if (val === void 0 || val === null) return void 0;
+      val = val[part];
+    }
+    return val;
+  }
+  return current[key];
+}
+function setGlobalConfigKey(key, value) {
+  const current = readGlobalConfig() || { version: CURRENT_ESEDRE_VERSION, port: DEFAULT_ESEDRE_PORT };
+  let parsedValue = value;
+  if ((key === "port" || key.endsWith(".port") || key.startsWith("ports.")) && typeof value === "string") {
+    const num = parseInt(value, 10);
+    if (!isNaN(num)) parsedValue = num;
+  }
+  if (key.includes(".")) {
+    const parts = key.split(".");
+    let obj = current;
+    for (let i = 0; i < parts.length - 1; i++) {
+      if (!obj[parts[i]] || typeof obj[parts[i]] !== "object") {
+        obj[parts[i]] = {};
+      }
+      obj = obj[parts[i]];
+    }
+    obj[parts[parts.length - 1]] = parsedValue;
+  } else {
+    current[key] = parsedValue;
+  }
+  writeGlobalConfig(current);
+  return { key, value: parsedValue };
+}
+function findEsedreConfig(startDir, options) {
   let current = path.resolve(startDir || process.cwd());
   const candidates = [
     [".esedre", "esedre.json"],
     ["esedre.json"]
   ];
+  let localConfig = null;
+  let localConfigPath = null;
+  let localWorkspaceRoot = current;
   while (true) {
     for (const segs of candidates) {
       const candidatePath = path.join(current, ...segs);
       if (fs.existsSync(candidatePath)) {
         try {
           const raw = fs.readFileSync(candidatePath, "utf-8");
-          const parsed = JSON.parse(raw);
-          return {
-            config: parsed,
-            configPath: candidatePath,
-            workspaceRoot: current
-          };
+          localConfig = JSON.parse(raw);
+          localConfigPath = candidatePath;
+          localWorkspaceRoot = current;
+          break;
         } catch (err) {
           throw new Error(`Failed to parse Esedre configuration at ${candidatePath}: ${err.message}`);
         }
       }
     }
+    if (localConfig) break;
     const parent = path.dirname(current);
     if (parent === current) {
       break;
     }
     current = parent;
   }
+  const globalConfig = readGlobalConfig();
+  if (localConfig) {
+    const merged = {
+      ...localConfig,
+      port: localConfig.port !== void 0 ? localConfig.port : globalConfig?.port || DEFAULT_ESEDRE_PORT,
+      ports: localConfig.ports || globalConfig?.ports
+    };
+    return {
+      config: merged,
+      configPath: localConfigPath,
+      workspaceRoot: localWorkspaceRoot
+    };
+  }
+  if (options?.fallbackToGlobal) {
+    let checkDir = path.resolve(startDir || process.cwd());
+    let hasInRepoMarkers = false;
+    let inRepoRoot = checkDir;
+    while (true) {
+      const candidateMarkers = [
+        path.join(checkDir, ".esedre", "tickets"),
+        path.join(checkDir, "tickets"),
+        path.join(checkDir, "src", "data", "planning", "tickets"),
+        path.join(checkDir, ".esedre", "projects.json"),
+        path.join(checkDir, ".esedre", "project.json"),
+        path.join(checkDir, "projects.json"),
+        path.join(checkDir, "project.json"),
+        path.join(checkDir, "src", "data", "planning", "projects.json"),
+        path.join(checkDir, "src", "data", "planning", "projects", "projects.json")
+      ];
+      if (candidateMarkers.some((m) => fs.existsSync(m))) {
+        hasInRepoMarkers = true;
+        inRepoRoot = checkDir;
+        break;
+      }
+      const parent = path.dirname(checkDir);
+      if (parent === checkDir) break;
+      checkDir = parent;
+    }
+    if (!hasInRepoMarkers && globalConfig && (globalConfig.dataDir || globalConfig.projects || globalConfig.port || globalConfig.projectCode)) {
+      return {
+        config: globalConfig,
+        configPath: getGlobalConfigPath(),
+        workspaceRoot: process.cwd()
+      };
+    }
+  }
   return {
     config: {},
     configPath: null,
@@ -150,14 +418,16 @@ function appendSnapshotToGitIgnore(workspaceRoot) {
     return false;
   }
 }
-function migrateEsedreConfig(raw, targetVersion = "0.1.0") {
+function migrateEsedreConfig(raw, targetVersion = CURRENT_ESEDRE_VERSION) {
   const migrated = {
     version: targetVersion,
     projectCode: raw?.projectCode || void 0,
+    projectName: raw?.projectName || void 0,
     allowedProjects: Array.isArray(raw?.allowedProjects) ? raw.allowedProjects : void 0,
     dataDir: Array.isArray(raw?.dataDir) ? raw.dataDir : typeof raw?.dataDir === "string" ? raw.dataDir : void 0,
     serverUrl: raw?.serverUrl,
-    port: typeof raw?.port === "number" ? raw.port : DEFAULT_ESEDRE_PORT,
+    port: typeof raw?.port === "number" && raw.port !== DEFAULT_ESEDRE_PORT ? raw.port : void 0,
+    ports: typeof raw?.ports === "object" && raw?.ports ? raw.ports : void 0,
     projects: typeof raw?.projects === "object" && raw?.projects ? raw.projects : void 0
   };
   return migrated;
@@ -239,7 +509,7 @@ async function generateProjectSnapshot(storage, projectCode, outputDir) {
     });
   }
   const snapshot = {
-    version: "0.1.0",
+    version: CURRENT_ESEDRE_VERSION,
     projectCode,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     totalTickets: entries.length,
@@ -331,9 +601,28 @@ var FilesystemStorageAdapter = class {
   resolveProjectLocations() {
     const locations = [];
     const seenCodes = /* @__PURE__ */ new Set();
-    const rawDataDirs = Array.isArray(this.config.dataDir) ? this.config.dataDir : this.config.dataDir ? [this.config.dataDir] : [];
+    const rawDataDirs = Array.isArray(this.config.dataDir) ? [...this.config.dataDir] : this.config.dataDir ? [this.config.dataDir] : [];
+    if (rawDataDirs.length === 0) {
+      const candidateHubDirs = [
+        this.workspaceRoot,
+        path3.join(this.workspaceRoot, "data"),
+        path3.join(this.workspaceRoot, ".esedre")
+      ];
+      for (const cand of candidateHubDirs) {
+        const pSub = path3.join(cand, "projects");
+        if (fs3.existsSync(pSub)) {
+          try {
+            if (fs3.statSync(pSub).isDirectory()) {
+              rawDataDirs.push(cand);
+              break;
+            }
+          } catch {
+          }
+        }
+      }
+    }
     for (const dDir of rawDataDirs) {
-      const resolvedHub = path3.resolve(this.workspaceRoot, dDir);
+      const resolvedHub = path3.resolve(this.workspaceRoot, expandHome(dDir));
       if (!fs3.existsSync(resolvedHub)) continue;
       const projectsSubDir = path3.join(resolvedHub, "projects");
       if (fs3.existsSync(projectsSubDir)) {
@@ -351,6 +640,9 @@ var FilesystemStorageAdapter = class {
           if (fs3.existsSync(pJsonPath)) {
             try {
               desc = JSON.parse(fs3.readFileSync(pJsonPath, "utf-8"));
+              if (desc && !desc.slug) {
+                desc.slug = (desc.code || ent.name).toLowerCase();
+              }
             } catch {
             }
           }
@@ -436,7 +728,7 @@ var FilesystemStorageAdapter = class {
     }
     if (this.config.projects && typeof this.config.projects === "object") {
       for (const [code, rawPath] of Object.entries(this.config.projects)) {
-        const projectDir = path3.resolve(this.workspaceRoot, rawPath);
+        const projectDir = path3.resolve(this.workspaceRoot, expandHome(rawPath));
         if (!fs3.existsSync(projectDir)) continue;
         let actualTicketsDir = path3.join(projectDir, "tickets");
         if (fs3.existsSync(path3.join(projectDir, ".esedre", "tickets"))) {
@@ -455,6 +747,9 @@ var FilesystemStorageAdapter = class {
           if (fs3.existsSync(cand)) {
             try {
               desc = JSON.parse(fs3.readFileSync(cand, "utf-8"));
+              if (desc && !desc.slug) {
+                desc.slug = (desc.code || code).toLowerCase();
+              }
               break;
             } catch {
             }
@@ -486,7 +781,14 @@ var FilesystemStorageAdapter = class {
         path3.join(this.workspaceRoot, "tickets"),
         path3.join(this.workspaceRoot, "src", "data", "planning", "tickets")
       ];
-      const foundTicketsDir = candidateDirs.find((d) => fs3.existsSync(d)) || path3.join(this.workspaceRoot, ".esedre", "tickets");
+      const existingDirs = candidateDirs.filter((d) => fs3.existsSync(d));
+      const foundTicketsDir = existingDirs.find((d) => {
+        try {
+          return fs3.readdirSync(d).length > 0;
+        } catch {
+          return false;
+        }
+      }) || existingDirs[0] || path3.join(this.workspaceRoot, ".esedre", "tickets");
       let descs = [];
       const pJsonCandidates = [
         path3.join(this.workspaceRoot, ".esedre", "projects.json"),
@@ -541,7 +843,7 @@ var FilesystemStorageAdapter = class {
   }
   async registerProject(input) {
     const rawCode = input.code.trim();
-    const cleanCode = rawCode.toUpperCase();
+    const cleanCode = rawCode;
     const cleanName = input.name?.trim() || cleanCode;
     const cleanDesc = input.description?.trim() || `${cleanName} project`;
     const slug = cleanCode.toLowerCase();
@@ -550,10 +852,29 @@ var FilesystemStorageAdapter = class {
       dot: "bg-cyan-400",
       border: "border-cyan-500/40"
     };
-    const rawDataDirs = Array.isArray(this.config.dataDir) ? this.config.dataDir : this.config.dataDir ? [this.config.dataDir] : [];
+    const rawDataDirs = Array.isArray(this.config.dataDir) ? [...this.config.dataDir] : this.config.dataDir ? [this.config.dataDir] : [];
+    if (rawDataDirs.length === 0) {
+      const candidateHubDirs = [
+        this.workspaceRoot,
+        path3.join(this.workspaceRoot, "data"),
+        path3.join(this.workspaceRoot, ".esedre")
+      ];
+      for (const cand of candidateHubDirs) {
+        const pSub = path3.join(cand, "projects");
+        if (fs3.existsSync(pSub)) {
+          try {
+            if (fs3.statSync(pSub).isDirectory()) {
+              rawDataDirs.push(cand);
+              break;
+            }
+          } catch {
+          }
+        }
+      }
+    }
     let targetHub = null;
     for (const dDir of rawDataDirs) {
-      const resolved = path3.resolve(this.workspaceRoot, dDir);
+      const resolved = path3.resolve(this.workspaceRoot, expandHome(dDir));
       if (fs3.existsSync(resolved)) {
         targetHub = resolved;
         break;
@@ -574,7 +895,9 @@ var FilesystemStorageAdapter = class {
         } catch {
         }
       }
-      const id2 = existingPJson2?.id || (await this.getProjects()).length + 1;
+      const existingProjects = await this.getProjects();
+      const maxId = existingProjects.reduce((max, p) => Math.max(max, p.id || 0), 0);
+      const id2 = existingPJson2?.id || maxId + 1;
       const projectDesc2 = {
         id: id2,
         code: cleanCode,
@@ -643,7 +966,7 @@ var FilesystemStorageAdapter = class {
     const locations = this.resolveProjectLocations();
     if (locations.length === 0) return null;
     const strId = String(id).trim();
-    const prefixMatch = strId.match(/^([a-zA-Z0-9]{1,6})[-_:](\d+)$/i);
+    const prefixMatch = strId.match(/^([a-zA-Z0-9]{1,7})[-_:](\d+)$/i);
     if (prefixMatch) {
       const code = prefixMatch[1].toLowerCase();
       const num2 = parseInt(prefixMatch[2], 10);
@@ -926,7 +1249,7 @@ var FilesystemStorageAdapter = class {
     if (requestedIdentifier) {
       const lower = String(requestedIdentifier).trim().toLowerCase();
       targetLoc = locations.find(
-        (l) => l.project.code.toLowerCase() === lower || l.project.slug.toLowerCase() === lower || String(l.project.id) === lower || l.project.name.toLowerCase() === lower
+        (l) => l.project.code?.toLowerCase() === lower || l.project.slug?.toLowerCase() === lower || String(l.project.id) === lower || l.project.name?.toLowerCase() === lower
       );
       if (!targetLoc) {
         throw new Error(`Project '${requestedIdentifier}' is invalid or not registered in this workspace.`);
@@ -1222,22 +1545,22 @@ function formatTicketListTable(tickets) {
   const rows = tickets.map((t) => {
     const id = t.projectDescriptor?.code ? `${t.projectDescriptor.code}-${t.meta.id}` : `#${t.meta.id}`;
     const project = t.projectDescriptor?.code || "CORE";
-    const category = t.meta.category;
+    const type = t.meta.type || t.meta.category || "Feature";
     const status = t.meta.status;
     const title = t.meta.title;
-    return { id, project, category, status, title };
+    return { id, project, type, status, title };
   });
   const idWidth = Math.max(4, ...rows.map((r) => r.id.length));
   const projWidth = Math.max(7, ...rows.map((r) => r.project.length));
-  const catWidth = Math.max(8, ...rows.map((r) => r.category.length));
+  const typeWidth = Math.max(8, ...rows.map((r) => r.type.length));
   const statusWidth = Math.max(14, ...rows.map((r) => r.status.length));
-  const header = `${colors.bold}${pad("ID", idWidth)}  ${pad("Project", projWidth)}  ${pad("Category", catWidth)}  ${pad("Status", statusWidth)}  Title${colors.reset}`;
-  const divider = `${colors.dim}${"-".repeat(idWidth)}  ${"-".repeat(projWidth)}  ${"-".repeat(catWidth)}  ${"-".repeat(statusWidth)}  ${"-".repeat(40)}${colors.reset}`;
+  const header = `${colors.bold}${pad("ID", idWidth)}  ${pad("Project", projWidth)}  ${pad("Type", typeWidth)}  ${pad("Status", statusWidth)}  Title${colors.reset}`;
+  const divider = `${colors.dim}${"-".repeat(idWidth)}  ${"-".repeat(projWidth)}  ${"-".repeat(typeWidth)}  ${"-".repeat(statusWidth)}  ${"-".repeat(40)}${colors.reset}`;
   const formattedRows = rows.map((r) => {
     const statusColored = colorStatus(r.status);
-    const catColored = colorCategory(r.category);
+    const typeColored = colorType(r.type);
     const projColored = `${colors.magenta}${r.project}${colors.reset}`;
-    return `${colors.bold}${pad(r.id, idWidth)}${colors.reset}  ${pad(projColored, projWidth + (isColorSupported ? colors.magenta.length + colors.reset.length : 0))}  ${pad(catColored, catWidth + (isColorSupported ? 9 : 0))}  ${pad(statusColored, statusWidth + (isColorSupported ? 9 : 0))}  ${r.title}`;
+    return `${colors.bold}${pad(r.id, idWidth)}${colors.reset}  ${pad(projColored, projWidth + (isColorSupported ? colors.magenta.length + colors.reset.length : 0))}  ${pad(typeColored, typeWidth + (isColorSupported ? 9 : 0))}  ${pad(statusColored, statusWidth + (isColorSupported ? 9 : 0))}  ${r.title}`;
   });
   return [header, divider, ...formattedRows].join("\n");
 }
@@ -1247,7 +1570,7 @@ function formatTicketDetail(ticket) {
   lines.push(`${colors.bold}${colors.cyan}Ticket #${meta.project ? `${meta.project}-${meta.id}` : meta.id}: ${meta.title}${colors.reset}`);
   lines.push(`${colors.dim}${"=".repeat(60)}${colors.reset}`);
   lines.push(`${colors.bold}Project:${colors.reset}     ${projectDescriptor ? `${projectDescriptor.code} - ${projectDescriptor.name}` : "Default"}`);
-  lines.push(`${colors.bold}Category:${colors.reset}    ${colorCategory(meta.category)}`);
+  lines.push(`${colors.bold}Type:${colors.reset}        ${colorType(meta.type || meta.category || "Feature")}`);
   lines.push(`${colors.bold}Status:${colors.reset}      ${colorStatus(meta.status)}`);
   lines.push(`${colors.bold}Complexity:${colors.reset}  ${meta.complexity || "Medium"}`);
   lines.push(`${colors.bold}Effort:${colors.reset}      ${meta.estimatedEffort || "N/A"}`);
@@ -1281,9 +1604,12 @@ function formatTicketDetail(ticket) {
       lines.push(`  \u2022 ${q}`);
     }
   }
-  lines.push("");
-  lines.push(`${colors.bold}Implementation Plan:${colors.reset} ${planMarkdown ? `${colors.green}Available (${planMarkdown.split("\n").length} lines)${colors.reset}` : `${colors.dim}None recorded${colors.reset}`}`);
-  if (comments.length > 0) {
+  if (planMarkdown) {
+    lines.push("");
+    lines.push(`${colors.bold}Implementation Plan:${colors.reset}`);
+    lines.push(planMarkdown.trim());
+  }
+  if (comments && comments.length > 0) {
     lines.push("");
     lines.push(`${colors.bold}Comments (${comments.length}):${colors.reset}`);
     for (const c of comments) {
@@ -1307,20 +1633,20 @@ function colorStatus(status) {
       return `${colors.cyan}${status}${colors.reset}`;
   }
 }
-function colorCategory(category) {
-  switch (category) {
+function colorType(type) {
+  switch (type) {
     case "Feature":
-      return `${colors.blue}${category}${colors.reset}`;
+      return `${colors.blue}${type}${colors.reset}`;
     case "Platform":
-      return `${colors.magenta}${category}${colors.reset}`;
+      return `${colors.magenta}${type}${colors.reset}`;
     case "Tools":
-      return `${colors.yellow}${category}${colors.reset}`;
+      return `${colors.yellow}${type}${colors.reset}`;
     case "Bug":
-      return `${colors.red}${category}${colors.reset}`;
+      return `${colors.red}${type}${colors.reset}`;
     case "Idea":
-      return `${colors.green}${category}${colors.reset}`;
+      return `${colors.green}${type}${colors.reset}`;
     default:
-      return category;
+      return type;
   }
 }
 
@@ -1522,17 +1848,26 @@ Status: ${ticket.meta.status}`;
       }
     }
   }
+  parseTicketId(val) {
+    if (typeof val === "number") return val;
+    const str = String(val).trim();
+    if (/^\d+$/.test(str)) {
+      return parseInt(str, 10);
+    }
+    return str;
+  }
   getToolDefinitions() {
     return [
       {
         name: "esedre_list_tickets",
-        description: "List roadmap tickets with optional project code, status, category, or search query.",
+        description: "List roadmap tickets with optional project code, status, type, category, or search query.",
         inputSchema: {
           type: "object",
           properties: {
             project: { type: "string", description: "Project code (e.g. CORE, WEB, DOCS)" },
             status: { type: "string", enum: ["Planned", "In Development", "Completed", "Rejected"], description: "Ticket status" },
-            category: { type: "string", enum: ["Feature", "Platform", "Tools", "Idea", "Bug"], description: "Ticket category" },
+            type: { type: "string", enum: ["Feature", "Platform", "Tools", "Idea", "Bug"], description: "Ticket type" },
+            category: { type: "string", enum: ["Feature", "Platform", "Tools", "Idea", "Bug"], description: "Ticket category (legacy alias for type)" },
             search: { type: "string", description: "Search keywords in title or ID" }
           }
         }
@@ -1543,7 +1878,7 @@ Status: ${ticket.meta.status}`;
         inputSchema: {
           type: "object",
           properties: {
-            ticketId: { type: "integer", description: "Numeric ticket ID (e.g. 96, 101)" }
+            ticketId: { type: ["integer", "string"], description: "Numeric ticket ID (e.g. 96, 101) or compound key (e.g. Profe-96)" }
           },
           required: ["ticketId"]
         }
@@ -1554,7 +1889,7 @@ Status: ${ticket.meta.status}`;
         inputSchema: {
           type: "object",
           properties: {
-            ticketId: { type: "integer", description: "Numeric ticket ID" }
+            ticketId: { type: ["integer", "string"], description: "Numeric ticket ID or compound key" }
           },
           required: ["ticketId"]
         }
@@ -1565,7 +1900,7 @@ Status: ${ticket.meta.status}`;
         inputSchema: {
           type: "object",
           properties: {
-            ticketId: { type: "integer", description: "Numeric ticket ID" },
+            ticketId: { type: ["integer", "string"], description: "Numeric ticket ID or compound key" },
             planMarkdown: { type: "string", description: "Implementation plan markdown content" },
             lastHash: { type: "string", description: "Optimistic concurrency control: last known sha1 hash of the ticket" }
           },
@@ -1580,24 +1915,29 @@ Status: ${ticket.meta.status}`;
           properties: {
             title: { type: "string", description: "Ticket title (max 48 characters)" },
             project: { type: "string", description: "Target project code (e.g. CORE, WEB, DOCS)" },
+            type: { type: "string", enum: ["Feature", "Platform", "Tools", "Idea", "Bug"], description: "Ticket type" },
             category: { type: "string", enum: ["Feature", "Platform", "Tools", "Idea", "Bug"], description: "Ticket category" },
             complexity: { type: "string", description: "Complexity (e.g. Low, Medium, High)" },
-            effort: { type: "string", description: "Estimated effort (e.g. 2.0 \u2013 4.0 hours)" },
+            effort: { type: "string", description: "Estimated effort (e.g. 2.0 - 4.0 hours)" },
             summary: { type: "string", description: "Initial feature summary" },
             author: { type: "string", description: "Submitting author name" }
           },
-          required: ["title", "category"]
+          required: ["title"]
         }
       },
       {
         name: "esedre_update_ticket",
-        description: "Update an existing ticket state (status, title, active planning flag, or feature flag).",
+        description: "Update an existing ticket state (status, type, title, complexity, effort, active planning flag, or feature flag).",
         inputSchema: {
           type: "object",
           properties: {
-            ticketId: { type: "integer", description: "Numeric ticket ID" },
+            ticketId: { type: ["integer", "string"], description: "Numeric ticket ID or compound key" },
             status: { type: "string", enum: ["Planned", "In Development", "Completed", "Rejected"] },
+            type: { type: "string", enum: ["Feature", "Platform", "Tools", "Idea", "Bug"] },
+            category: { type: "string", enum: ["Feature", "Platform", "Tools", "Idea", "Bug"] },
             title: { type: "string", description: "New title (max 48 characters)" },
+            complexity: { type: "string", description: "Complexity (e.g. Low, Medium, High)" },
+            effort: { type: "string", description: "Estimated effort (e.g. 2.0 - 4.0 hours)" },
             inDevelopment: { type: "boolean", description: "Active development toggle" },
             featureFlag: { type: "string", description: "Feature flag name" },
             lastHash: { type: "string", description: "Optimistic concurrency control: last known sha1 hash of the ticket" }
@@ -1607,11 +1947,11 @@ Status: ${ticket.meta.status}`;
       },
       {
         name: "esedre_add_comment",
-        description: "Append a developer or companion agent comment to a ticket.",
+        description: "Append a developer or LLM agent comment to a ticket.",
         inputSchema: {
           type: "object",
           properties: {
-            ticketId: { type: "integer", description: "Numeric ticket ID" },
+            ticketId: { type: ["integer", "string"], description: "Numeric ticket ID or compound key" },
             text: { type: "string", description: "Comment message" },
             author: { type: "string", description: "Author name (e.g. Antigravity, Developer)" }
           },
@@ -1624,16 +1964,19 @@ Status: ${ticket.meta.status}`;
     const canonical = name.replace(/^esedre_/, "");
     switch (canonical) {
       case "list_tickets": {
+        const type = args.type || args.category;
         const tickets = await this.storage.listTickets({
           project: args.project,
           status: args.status,
-          category: args.category,
+          type,
+          category: type,
           search: args.search
         });
         return tickets.map((t) => ({
           id: t.meta.id,
           title: t.meta.title,
-          category: t.meta.category,
+          type: t.meta.type || t.meta.category,
+          category: t.meta.type || t.meta.category,
           status: t.meta.status,
           complexity: t.meta.complexity,
           effort: t.meta.estimatedEffort,
@@ -1642,26 +1985,27 @@ Status: ${ticket.meta.status}`;
         }));
       }
       case "get_ticket": {
-        const id = parseInt(String(args.ticketId), 10);
+        const id = this.parseTicketId(args.ticketId);
         const ticket = await this.storage.getTicket(id);
         if (!ticket) throw new Error(`Ticket #${id} not found`);
         return ticket;
       }
       case "get_plan": {
-        const id = parseInt(String(args.ticketId), 10);
+        const id = this.parseTicketId(args.ticketId);
         const plan = await this.storage.getPlan(id);
         return { ticketId: id, planMarkdown: plan || null };
       }
       case "save_plan": {
-        const id = parseInt(String(args.ticketId), 10);
+        const id = this.parseTicketId(args.ticketId);
         await this.storage.savePlan(id, args.planMarkdown, args.lastHash);
         return { success: true, message: `Implementation plan saved for Ticket #${id}` };
       }
       case "create_ticket": {
+        const type = args.type || args.category || "Feature";
         const created = await this.storage.createTicket({
           title: args.title,
-          type: args.type || args.category,
-          category: args.type || args.category,
+          type,
+          category: type,
           projectCode: args.project,
           complexity: args.complexity,
           estimatedEffort: args.effort,
@@ -1671,17 +2015,24 @@ Status: ${ticket.meta.status}`;
         return created;
       }
       case "update_ticket": {
-        const id = parseInt(String(args.ticketId), 10);
+        const id = this.parseTicketId(args.ticketId);
         const updates = {};
+        const type = args.type || args.category;
+        if (type) {
+          updates.type = type;
+          updates.category = type;
+        }
         if (args.status) updates.status = args.status;
         if (args.title) updates.title = args.title;
+        if (args.complexity) updates.complexity = args.complexity;
+        if (args.effort) updates.estimatedEffort = args.effort;
         if (args.inDevelopment !== void 0) updates.isActivePlanning = Boolean(args.inDevelopment);
         if (args.featureFlag) updates.featureFlag = args.featureFlag;
         const updated = await this.storage.updateTicket(id, updates, args.lastHash);
         return updated;
       }
       case "add_comment": {
-        const id = parseInt(String(args.ticketId), 10);
+        const id = this.parseTicketId(args.ticketId);
         const comment = await this.storage.addComment(id, {
           text: args.text,
           author: args.author || "Agent"
@@ -1694,47 +2045,235 @@ Status: ${ticket.meta.status}`;
   }
 };
 
+// src/utils/manifestDetector.ts
+import fs4 from "node:fs";
+import path4 from "node:path";
+function sanitizeCode(input) {
+  const clean = input.replace(/[^a-zA-Z0-9]/g, "");
+  return clean.slice(0, MAX_PROJECT_CODE_LENGTH) || "APP";
+}
+function detectProjectManifest(targetDir) {
+  const dirBase = path4.basename(targetDir);
+  for (const settingsFile of ["settings.gradle.kts", "settings.gradle"]) {
+    const fullPath = path4.join(targetDir, settingsFile);
+    if (fs4.existsSync(fullPath)) {
+      try {
+        const content = fs4.readFileSync(fullPath, "utf-8");
+        const match = content.match(/rootProject\.name\s*=\s*["']([^"']+)["']/);
+        if (match && match[1].trim()) {
+          const rawName = match[1].trim();
+          return {
+            candidateCode: sanitizeCode(rawName),
+            candidateName: rawName,
+            manifestType: "gradle",
+            manifestFile: settingsFile
+          };
+        }
+      } catch {
+      }
+    }
+  }
+  for (const buildFile of [
+    path4.join("app", "build.gradle.kts"),
+    "build.gradle.kts",
+    path4.join("app", "build.gradle"),
+    "build.gradle"
+  ]) {
+    const fullPath = path4.join(targetDir, buildFile);
+    if (fs4.existsSync(fullPath)) {
+      try {
+        const content = fs4.readFileSync(fullPath, "utf-8");
+        const match = content.match(/(?:namespace|applicationId)\s*=\s*["']([^"']+)["']/);
+        if (match && match[1].trim()) {
+          const ns = match[1].trim();
+          const lastSegment = ns.split(".").pop() || dirBase;
+          const candidateName = lastSegment.charAt(0).toUpperCase() + lastSegment.slice(1);
+          return {
+            candidateCode: sanitizeCode(candidateName),
+            candidateName,
+            manifestType: "gradle",
+            manifestFile: buildFile
+          };
+        }
+      } catch {
+      }
+    }
+  }
+  const pomPath = path4.join(targetDir, "pom.xml");
+  if (fs4.existsSync(pomPath)) {
+    try {
+      const content = fs4.readFileSync(pomPath, "utf-8");
+      const stripped = content.replace(/<!--[\s\S]*?-->/g, "").replace(/<parent>[\s\S]*?<\/parent>/g, "");
+      const nameMatch = stripped.match(/<name>\s*([^<]+)\s*<\/name>/);
+      const artifactMatch = stripped.match(/<artifactId>\s*([^<]+)\s*<\/artifactId>/) || content.match(/<artifactId>\s*([^<]+)\s*<\/artifactId>/);
+      let rawName = nameMatch?.[1]?.trim();
+      if (!rawName || rawName.startsWith("${")) {
+        rawName = artifactMatch?.[1]?.trim();
+      }
+      if (rawName) {
+        return {
+          candidateCode: sanitizeCode(rawName),
+          candidateName: rawName,
+          manifestType: "maven",
+          manifestFile: "pom.xml"
+        };
+      }
+    } catch {
+    }
+  }
+  const pkgPath = path4.join(targetDir, "package.json");
+  if (fs4.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs4.readFileSync(pkgPath, "utf-8"));
+      if (pkg.name && typeof pkg.name === "string") {
+        const baseName = pkg.name.replace(/^@[\w-]+\//, "");
+        return {
+          candidateCode: sanitizeCode(baseName),
+          candidateName: baseName,
+          manifestType: "node",
+          manifestFile: "package.json"
+        };
+      }
+    } catch {
+    }
+  }
+  const cargoPath = path4.join(targetDir, "Cargo.toml");
+  if (fs4.existsSync(cargoPath)) {
+    try {
+      const content = fs4.readFileSync(cargoPath, "utf-8");
+      const match = content.match(/\[package\][\s\S]*?name\s*=\s*["']([^"']+)["']/);
+      if (match && match[1].trim()) {
+        const rawName = match[1].trim();
+        return {
+          candidateCode: sanitizeCode(rawName),
+          candidateName: rawName,
+          manifestType: "rust",
+          manifestFile: "Cargo.toml"
+        };
+      }
+    } catch {
+    }
+  }
+  const pyprojectPath = path4.join(targetDir, "pyproject.toml");
+  if (fs4.existsSync(pyprojectPath)) {
+    try {
+      const content = fs4.readFileSync(pyprojectPath, "utf-8");
+      const match = content.match(/name\s*=\s*["']([^"']+)["']/);
+      if (match && match[1].trim()) {
+        const rawName = match[1].trim();
+        return {
+          candidateCode: sanitizeCode(rawName),
+          candidateName: rawName,
+          manifestType: "python",
+          manifestFile: "pyproject.toml"
+        };
+      }
+    } catch {
+    }
+  }
+  const setupCfgPath = path4.join(targetDir, "setup.cfg");
+  if (fs4.existsSync(setupCfgPath)) {
+    try {
+      const content = fs4.readFileSync(setupCfgPath, "utf-8");
+      const match = content.match(/^name\s*=\s*([^\r\n]+)/m);
+      if (match && match[1].trim()) {
+        const rawName = match[1].trim();
+        return {
+          candidateCode: sanitizeCode(rawName),
+          candidateName: rawName,
+          manifestType: "python",
+          manifestFile: "setup.cfg"
+        };
+      }
+    } catch {
+    }
+  }
+  const setupPyPath = path4.join(targetDir, "setup.py");
+  if (fs4.existsSync(setupPyPath)) {
+    try {
+      const content = fs4.readFileSync(setupPyPath, "utf-8");
+      const match = content.match(/name\s*=\s*["']([^"']+)["']/);
+      if (match && match[1].trim()) {
+        const rawName = match[1].trim();
+        return {
+          candidateCode: sanitizeCode(rawName),
+          candidateName: rawName,
+          manifestType: "python",
+          manifestFile: "setup.py"
+        };
+      }
+    } catch {
+    }
+  }
+  const goModPath = path4.join(targetDir, "go.mod");
+  if (fs4.existsSync(goModPath)) {
+    try {
+      const content = fs4.readFileSync(goModPath, "utf-8");
+      const match = content.match(/^module\s+([^\r\n\s]+)/m);
+      if (match && match[1].trim()) {
+        const modPath = match[1].trim();
+        const baseName = modPath.split("/").pop() || dirBase;
+        return {
+          candidateCode: sanitizeCode(baseName),
+          candidateName: baseName,
+          manifestType: "go",
+          manifestFile: "go.mod"
+        };
+      }
+    } catch {
+    }
+  }
+  return {
+    candidateCode: sanitizeCode(dirBase),
+    candidateName: dirBase,
+    manifestType: "directory"
+  };
+}
+
 // src/upgrade.ts
 import crypto2 from "node:crypto";
-import fs5 from "node:fs";
-import path5 from "node:path";
+import fs6 from "node:fs";
+import path6 from "node:path";
 
 // src/server/daemon.ts
-import fs4 from "node:fs";
-import path4 from "node:path";
-import os from "node:os";
+import fs5 from "node:fs";
+import path5 from "node:path";
+import os2 from "node:os";
 import http from "node:http";
 import { spawn, spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = path4.dirname(__filename);
+var __dirname = path5.dirname(__filename);
 function getGlobalEsedreDir() {
-  return path4.join(os.homedir(), ".esedre");
+  if (process.env.ESEDRE_GLOBAL_DIR) {
+    return process.env.ESEDRE_GLOBAL_DIR;
+  }
+  return path5.join(os2.homedir(), ".esedre");
 }
 function ensureGlobalEsedreStore() {
   const globalDir = getGlobalEsedreDir();
-  const runDir = path4.join(globalDir, "run");
-  const logsDir = path4.join(globalDir, "logs");
+  const runDir = path5.join(globalDir, "run");
+  const logsDir = path5.join(globalDir, "logs");
   try {
-    fs4.mkdirSync(runDir, { recursive: true });
-    fs4.mkdirSync(logsDir, { recursive: true });
+    fs5.mkdirSync(runDir, { recursive: true });
+    fs5.mkdirSync(logsDir, { recursive: true });
     try {
-      const runEntries = fs4.readdirSync(runDir);
+      const runEntries = fs5.readdirSync(runDir);
       for (const entry of runEntries) {
         if (entry.startsWith(".probe-")) {
-          fs4.unlinkSync(path4.join(runDir, entry));
+          fs5.unlinkSync(path5.join(runDir, entry));
         }
       }
     } catch {
     }
-    const testProbe = path4.join(runDir, `.probe-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`);
+    const testProbe = path5.join(runDir, `.probe-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`);
     try {
-      fs4.writeFileSync(testProbe, "ok", "utf-8");
+      fs5.writeFileSync(testProbe, "ok", "utf-8");
       return { ok: true, path: globalDir };
     } finally {
-      if (fs4.existsSync(testProbe)) {
+      if (fs5.existsSync(testProbe)) {
         try {
-          fs4.unlinkSync(testProbe);
+          fs5.unlinkSync(testProbe);
         } catch {
         }
       }
@@ -1749,10 +2288,10 @@ function resolveStoreDir(workspaceRoot) {
     return globalStore.path;
   }
   if (workspaceRoot) {
-    const localStore = path4.join(workspaceRoot, ".esedre");
+    const localStore = path5.join(workspaceRoot, ".esedre");
     try {
-      fs4.mkdirSync(path4.join(localStore, "run"), { recursive: true });
-      fs4.mkdirSync(path4.join(localStore, "logs"), { recursive: true });
+      fs5.mkdirSync(path5.join(localStore, "run"), { recursive: true });
+      fs5.mkdirSync(path5.join(localStore, "logs"), { recursive: true });
       return localStore;
     } catch {
     }
@@ -1761,32 +2300,32 @@ function resolveStoreDir(workspaceRoot) {
 }
 function getDaemonStateFile(port, workspaceRoot) {
   const store = resolveStoreDir(workspaceRoot);
-  return path4.join(store, "run", `daemon-${port}.json`);
+  return path5.join(store, "run", `daemon-${port}.json`);
 }
 function getDaemonLogFile(port, workspaceRoot) {
   const store = resolveStoreDir(workspaceRoot);
-  return path4.join(store, "logs", `daemon-${port}.log`);
+  return path5.join(store, "logs", `daemon-${port}.log`);
 }
 function getDaemonState(port, workspaceRoot) {
   const stateFile = getDaemonStateFile(port, workspaceRoot);
-  if (!fs4.existsSync(stateFile)) {
+  if (!fs5.existsSync(stateFile)) {
     return null;
   }
   try {
-    const raw = fs4.readFileSync(stateFile, "utf-8").trim();
+    const raw = fs5.readFileSync(stateFile, "utf-8").trim();
     if (!raw) {
-      fs4.unlinkSync(stateFile);
+      fs5.unlinkSync(stateFile);
       return null;
     }
     const state = JSON.parse(raw);
     if (!state || typeof state.pid !== "number" || typeof state.port !== "number") {
-      fs4.unlinkSync(stateFile);
+      fs5.unlinkSync(stateFile);
       return null;
     }
     return state;
   } catch {
     try {
-      fs4.unlinkSync(stateFile);
+      fs5.unlinkSync(stateFile);
     } catch {
     }
     return null;
@@ -1838,7 +2377,7 @@ function pingDaemon(port, timeoutMs = 200) {
   });
 }
 async function startDaemon(options = {}) {
-  const port = options.port || 5674;
+  const port = resolvePorts(void 0, { port: options.port }).gateway;
   const workspaceRoot = options.workspaceRoot || process.cwd();
   const stateFile = getDaemonStateFile(port, workspaceRoot);
   const logFile = getDaemonLogFile(port, workspaceRoot);
@@ -1849,12 +2388,15 @@ async function startDaemon(options = {}) {
       if (ping.responding && ping.isEsedre) {
         if (!options.quiet) {
           console.log(`\x1B[36m\u26A1 Esedre daemon already running on http://localhost:${port} (PID ${existingState.pid})\x1B[0m`);
+          if (existingState.version && existingState.version !== CURRENT_ESEDRE_VERSION) {
+            console.log(`\x1B[33m\u26A0\uFE0F  Warning: Daemon is running v${existingState.version}, but v${CURRENT_ESEDRE_VERSION} is installed. Run 'ese stop && ese start' to reload.\x1B[0m`);
+          }
         }
         return existingState;
       }
     }
     try {
-      fs4.unlinkSync(stateFile);
+      fs5.unlinkSync(stateFile);
     } catch {
     }
   }
@@ -1867,33 +2409,33 @@ async function startDaemon(options = {}) {
       pid: process.pid,
       port,
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      version: "0.1.0",
+      version: CURRENT_ESEDRE_VERSION,
       workspaceRoot,
       logFile
     };
   }
   resolveStoreDir(workspaceRoot);
-  fs4.mkdirSync(path4.dirname(logFile), { recursive: true });
-  fs4.mkdirSync(path4.dirname(stateFile), { recursive: true });
-  const logFd = fs4.openSync(logFile, "a");
-  const isEsedreArgv1 = process.argv[1] && /esedre/i.test(path4.basename(process.argv[1]));
+  fs5.mkdirSync(path5.dirname(logFile), { recursive: true });
+  fs5.mkdirSync(path5.dirname(stateFile), { recursive: true });
+  const logFd = fs5.openSync(logFile, "a");
+  const isEsedreArgv1 = process.argv[1] && /esedre/i.test(path5.basename(process.argv[1]));
   const cliCandidates = [
-    isEsedreArgv1 ? process.argv[1] : void 0,
-    path4.resolve(workspaceRoot, "dist", "esedre.mjs"),
-    path4.resolve(workspaceRoot, "../esedre/dist", "esedre.mjs"),
-    path4.resolve(__dirname, "esedre.mjs"),
-    path4.resolve(__dirname, "..", "dist", "esedre.mjs"),
-    path4.resolve(__dirname, "..", "..", "dist", "esedre.mjs"),
-    path4.resolve(__dirname, "..", "..", "bin", "esedre.js"),
-    path4.resolve(__dirname, "..", "..", "bin", "esedre.ts"),
-    path4.resolve(__dirname, "..", "esedre.mjs"),
-    path4.resolve(__dirname, "../../../esedre/dist", "esedre.mjs")
+    isEsedreArgv1 ? path5.resolve(process.argv[1]) : void 0,
+    path5.resolve(workspaceRoot, "dist", "esedre.mjs"),
+    path5.resolve(workspaceRoot, "../esedre/dist", "esedre.mjs"),
+    path5.resolve(__dirname, "esedre.mjs"),
+    path5.resolve(__dirname, "..", "dist", "esedre.mjs"),
+    path5.resolve(__dirname, "..", "..", "dist", "esedre.mjs"),
+    path5.resolve(__dirname, "..", "..", "bin", "esedre.js"),
+    path5.resolve(__dirname, "..", "..", "bin", "esedre.ts"),
+    path5.resolve(__dirname, "..", "esedre.mjs"),
+    path5.resolve(__dirname, "../../../esedre/dist", "esedre.mjs")
   ].filter(Boolean);
-  const cliPath = cliCandidates.find((c) => fs4.existsSync(c) && (c.endsWith(".mjs") || c.endsWith(".js") || c.endsWith(".ts"))) || cliCandidates[0];
-  if (!fs4.existsSync(cliPath)) {
+  const cliPath = cliCandidates.find((c) => fs5.existsSync(c) && (c.endsWith(".mjs") || c.endsWith(".js") || c.endsWith(".ts"))) || cliCandidates[0];
+  if (!fs5.existsSync(cliPath)) {
     throw new Error(`Could not locate Esedre executable. Searched candidates: ${cliCandidates.join(", ")}`);
   }
-  const child = spawn(process.execPath, [cliPath, "serve", "--port", String(port)], {
+  const child = spawn(process.execPath, [cliPath, "start", "--foreground", "--port", String(port)], {
     detached: true,
     stdio: ["ignore", logFd, logFd],
     cwd: workspaceRoot,
@@ -1901,6 +2443,10 @@ async function startDaemon(options = {}) {
     windowsHide: true
   });
   child.unref();
+  try {
+    fs5.closeSync(logFd);
+  } catch {
+  }
   const pid = child.pid;
   if (!pid) {
     throw new Error("Failed to spawn Esedre daemon background process.");
@@ -1932,18 +2478,18 @@ async function startDaemon(options = {}) {
     uiPort: port + 1,
     apiPort: port + 2,
     startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    version: "0.1.0",
+    version: CURRENT_ESEDRE_VERSION,
     workspaceRoot,
     logFile
   };
   const tmpState = `${stateFile}.tmp.${Date.now()}`;
-  fs4.writeFileSync(tmpState, JSON.stringify(state, null, 2) + "\n", "utf-8");
+  fs5.writeFileSync(tmpState, JSON.stringify(state, null, 2) + "\n", "utf-8");
   try {
-    fs4.renameSync(tmpState, stateFile);
+    fs5.renameSync(tmpState, stateFile);
   } catch {
-    fs4.writeFileSync(stateFile, JSON.stringify(state, null, 2) + "\n", "utf-8");
+    fs5.writeFileSync(stateFile, JSON.stringify(state, null, 2) + "\n", "utf-8");
     try {
-      fs4.unlinkSync(tmpState);
+      fs5.unlinkSync(tmpState);
     } catch {
     }
   }
@@ -1955,7 +2501,7 @@ async function startDaemon(options = {}) {
   return state;
 }
 async function stopDaemon(options = {}) {
-  const port = options.port || 5674;
+  const port = resolvePorts(void 0, { port: options.port }).gateway;
   const workspaceRoot = options.workspaceRoot || process.cwd();
   const stateFile = getDaemonStateFile(port, workspaceRoot);
   const state = getDaemonState(port, workspaceRoot);
@@ -1985,8 +2531,8 @@ async function stopDaemon(options = {}) {
     }
   }
   try {
-    if (fs4.existsSync(stateFile)) {
-      fs4.unlinkSync(stateFile);
+    if (fs5.existsSync(stateFile)) {
+      fs5.unlinkSync(stateFile);
     }
   } catch {
   }
@@ -1996,7 +2542,7 @@ async function stopDaemon(options = {}) {
   return true;
 }
 async function getDaemonStatus(options = {}) {
-  const port = options.port || 5674;
+  const port = resolvePorts(void 0, { port: options.port }).gateway;
   const workspaceRoot = options.workspaceRoot || process.cwd();
   const state = getDaemonState(port, workspaceRoot);
   const stateFile = getDaemonStateFile(port, workspaceRoot);
@@ -2005,6 +2551,8 @@ async function getDaemonStatus(options = {}) {
   if (state && isProcessAlive(state.pid) && ping.responding && ping.isEsedre) {
     const startedMs = Date.parse(state.startedAt) || Date.now();
     const uptimeSeconds = Math.max(0, Math.floor((Date.now() - startedMs) / 1e3));
+    const daemonVersion = state.version;
+    const isStale = Boolean(daemonVersion && daemonVersion !== CURRENT_ESEDRE_VERSION);
     return {
       running: true,
       pid: state.pid,
@@ -2013,12 +2561,15 @@ async function getDaemonStatus(options = {}) {
       startedAt: state.startedAt,
       workspaceRoot: state.workspaceRoot,
       projects: ping.projects,
-      logFile: state.logFile || logFile
+      logFile: state.logFile || logFile,
+      version: daemonVersion,
+      staleVersion: isStale,
+      installedVersion: CURRENT_ESEDRE_VERSION
     };
   }
   if (state && !isProcessAlive(state.pid)) {
     try {
-      fs4.unlinkSync(stateFile);
+      fs5.unlinkSync(stateFile);
     } catch {
     }
   }
@@ -2026,18 +2577,21 @@ async function getDaemonStatus(options = {}) {
     running: ping.responding && ping.isEsedre,
     port,
     projects: ping.projects,
-    logFile
+    logFile,
+    version: state?.version,
+    staleVersion: Boolean(state?.version && state.version !== CURRENT_ESEDRE_VERSION),
+    installedVersion: CURRENT_ESEDRE_VERSION
   };
 }
 function printDaemonLogs(options = {}) {
-  const port = options.port || 5674;
+  const port = resolvePorts(void 0, { port: options.port }).gateway;
   const workspaceRoot = options.workspaceRoot || process.cwd();
   const logFile = getDaemonLogFile(port, workspaceRoot);
-  if (!fs4.existsSync(logFile)) {
+  if (!fs5.existsSync(logFile)) {
     console.log(`\x1B[33mNo logs found at: ${logFile}\x1B[0m`);
     return;
   }
-  const content = fs4.readFileSync(logFile, "utf-8");
+  const content = fs5.readFileSync(logFile, "utf-8");
   const count = options.lines || 40;
   const allLines = content.split(/\r?\n/);
   const tail = allLines.slice(-count).join("\n");
@@ -2047,7 +2601,6 @@ function printDaemonLogs(options = {}) {
 }
 
 // src/upgrade.ts
-var CURRENT_ESEDRE_VERSION = "0.1.4";
 function computeNormalizedHash(content) {
   const normalized = content.replace(/\r\n/g, "\n").trim();
   return crypto2.createHash("sha1").update(normalized, "utf-8").digest("hex");
@@ -2175,10 +2728,129 @@ var ESE_WRAPPER_BASH = `#!/usr/bin/env bash
 DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" >/dev/null 2>&1 && pwd)"
 exec "$DIR/esedre" "$@"
 `;
-var ESEDRE_SKILL_TEMPLATE = '---\nname: esedre\ndescription: Tooling and workflow reference for interacting with the Esedre developer ticketing and roadmap system. Use this skill whenever inspecting planned work, viewing ticket specs, updating implementation plans, or posting developer notes.\n---\n\n# Esedre Planning & Roadmap Workflow\n\nEsedre is the developer ticketing and companion LLM coding agent coordination platform. The engine codebase resides in the standalone repository `aellinsar/esedre` (`../esedre`), and operates on decoupled ticket repositories (such as `aellinsar/esedre-data` configured in `.esedre/esedre.json`). In `ProfessorArwamSleepCenter`, interact with tickets via the compiled bridge artifact `tools/esedre.mjs` (`node tools/esedre.mjs <command>`), in-repo shell wrappers in `.esedre/` (`.esedre/ese`), or the global `ese` CLI.\n\n## 0. Instant Zero-Latency Context (`.esedre/snapshot.json`)\n\nBefore querying tickets over the network or CLI, check `.esedre/snapshot.json` in the workspace root. It provides a local read-only projection containing all active and completed tickets, summaries, implementation plans, revision numbers, completion dates (`completedAt`), and staleness metrics (`daysSinceUpdate`).\n\n## 1. Model Context Protocol (MCP) Tools\n\nWhen Esedre MCP is active in your agent session (`.agents/mcp_config.json`), use these tools directly:\n\n| Tool | Purpose | Key Arguments |\n|---|---|---|\n| `esedre_list_tickets` | List roadmap tickets with filters | `project` (e.g. `Profe`, `Esedre`, `Alce`), `status`, `type`, `search` |\n| `esedre_get_ticket` | Full specification, summary, comments, revision & sha1 | `ticketId` (numeric or compound e.g. `Profe-35`) |\n| `esedre_get_plan` | Active implementation plan markdown | `ticketId` (numeric or compound) |\n| `esedre_save_plan` | Save implementation plan markdown with OCC | `ticketId`, `planMarkdown`, `lastHash` |\n| `esedre_create_ticket` | Mint a new ticket with auto sequential ID | `title` (max 48 chars), `type`, `project`, `effort`, `summary` |\n| `esedre_update_ticket` | Update ticket attributes with OCC | `ticketId`, `status`, `title`, `inDevelopment`, `featureFlag`, `lastHash` |\n\n## 2. Core CLI Commands (Fallback via `run_command`)\n\nBoth `esedre` and `ese` work interchangeably:\n\n### List Tickets\n```bash\n.esedre/ese list [-p|--project <code|all>] [-s|--status <status>] [-t|--type <type>] [-q|--search <q>] [--json]\n```\n\n### Read Ticket Details\n```bash\n.esedre/ese get <ticketId> [--json]\n```\n\n### Read or Update Implementation Plans\n```bash\n.esedre/ese plan <ticketId>\n.esedre/ese plan <ticketId> --file <planFilePath>\n.esedre/ese plan <ticketId> --set "<markdownContent>" [--last-hash <hash>]\n```\n\n### Create a Ticket\n```bash\n.esedre/ese create --title "..." [-p|--project Profe] [-t|--type Feature] [--complexity Medium] [--effort "2.0 - 4.0 hours"] [--json]\n```\n\n### Update Ticket Status\n```bash\n.esedre/ese update <ticketId> --status "In Development"\n.esedre/ese update <ticketId> --status "Completed"\n```\n\n### Append Comments or Notes\n```bash\n.esedre/ese comment <ticketId> --text "Verified implementation." --author "Antigravity"\n```\n\n### Regenerate Snapshot\n```bash\n.esedre/ese snapshot\n```\n\n### Background Daemon Management\n```bash\n# Start background daemon on port 5674 (idempotent)\n.esedre/ese daemon start [--port 5674] [--quiet] [--json]\n\n# Check daemon health and diagnostics\n.esedre/ese daemon status [--port 5674] [--json]\n\n# View recent daemon activity logs\n.esedre/ese daemon logs\n\n# Stop background daemon\n.esedre/ese daemon stop [--port 5674] [--quiet] [--json]\n```\n\n### Foreground Gateway Server\n```bash\n.esedre/ese serve [--port 5674]\n```\n- Starts the unified gateway on port 5674, routing `/app` to Esedre UI (port 5675) and `/api` to Esedre REST API (port 5676).\n- Transparently rewrites `/` to `/app/`.\n\n### Workspace Configuration & Vite Proxy Setup\n```bash\n.esedre/ese configure [--project <code>] [--name <name>] [--port <n>] [--proxy] [--no-proxy] [-y]\n```\n- Automatically detects `vite.config.ts`/`vite.config.js`. In interactive mode or with `--proxy`, configures a reverse proxy for `/esedre` targeting port 5674 (`http://127.0.0.1:5674`).\n- If Vite is absent or declined, displays the recommended reverse proxy block for embedding the planner UI in the host app.\n\n## 3. Embedded View & Theme Token Contract\n\nWhen embedding `<PlannedWorkView />` inside a host app (e.g. `PlannedWorkModal.tsx`):\n\n### Zero-Effort Drop-in (Default Fallback)\n`PlannedWorkView` incorporates an internal CSS fallback bridge (`.esedre-host-bridge` / `.esedre-theme-root` with `ESEDRE_THEME_FALLBACK_CSS`).\nIf an embedding application supplies **zero CSS variables**, the component automatically falls back to clean, high-contrast light or dark themes matching the user\'s OS preference (`prefers-color-scheme: dark`) or host `.dark` / `[data-theme="night"]` classes.\n\n### Theme Token Customization\nIf the host application declares any or all of the 12 core design tokens on `:root` or an ancestor container, `PlannedWorkView` automatically adopts them:\n- **Surface**: `--bg-surface`, `--bg-surface-elevated`, `--bg-input`\n- **Borders**: `--border-subtle`, `--border-strong`, `--border-accent`\n- **Text**: `--text-primary`, `--text-secondary`, `--text-muted`\n- **Accent**: `--accent-primary`, `--accent-bg-subtle`, `--accent-border-subtle`\n\n## 4. Safety & Invariants\n- **Always use `--json`** for CLI programmatic inspection.\n- **Optimistic Concurrency**: Writes support `--last-hash <hash>` to prevent overwriting concurrent updates.\n- **Universal Type Naming**: Always use `type` (`Feature`, `Platform`, `Tools`, `Idea`, `Bug`). The legacy name `category` is deprecated.\n- **Compound IDs for Multi-Project Portfolios**: In `project=all`, ticket IDs are `${projectCode}-${id}` (e.g. `Profe-1`, `Esedre-1`). DOM anchors strictly use `feature-card-${projectCode}-${id}`.\n- **Never delete tickets** directly via filesystem.\n- **Agent Project Allow-List**: Providing isolation of projects planning that you don\'t want an agent to access. A repository only accesses projects declared in its `.esedre/esedre.json` (`allowedProjects`). Unauthorized cross-project access is strictly blocked.\n- **Secret Developer Hash Route (`#/planner`, `#/plan`, `#planner`, `#plan`)**:\n  - In web applications embedding Esedre (such as Professor Arwam), `#/planner` and `#/plan` serve as direct secret developer entry routes.\n  - **SEO Invariant**: These developer routes are private and MUST NEVER be exposed in `sitemap.xml`, `robots.txt`, `llms.txt`, or public navigation links.\n  - The URL hash is preserved across hard page refreshes (F5) without falling back to `#/chat` or other views.\n';
+var HISTORIC_SKILL_HASHES = [
+  "8611116c276fdfb598b965c716b251ce7c77c7f7",
+  "05f129fb6e06a18df00215af105567abcbf0bc67"
+];
+var ESEDRE_SKILL_TEMPLATE = `---
+name: esedre
+description: Tooling and workflow reference for interacting with the Esedre developer ticketing and roadmap system. Use this skill whenever inspecting planned work, viewing ticket specs, updating implementation plans, or posting developer notes.
+---
+
+# Esedre Planning & Roadmap Workflow
+
+Esedre is the developer ticketing and LLM coding partner coordination platform. The engine codebase resides in the standalone repository \`aellinsar/esedre\` (\`../esedre\`), and operates on decoupled ticket repositories (such as \`aellinsar/esedre-data\` configured in \`.esedre/esedre.json\`). Interact with tickets via in-repo shell wrappers in \`.esedre/\` (\`.esedre/ese\`), or the global \`ese\` CLI.
+
+## 0. Instant Zero-Latency Context (\`.esedre/snapshot.json\`)
+
+Before querying tickets over the network or CLI, check \`.esedre/snapshot.json\` in the workspace root. It provides a local read-only projection containing all active and completed tickets, summaries, implementation plans, revision numbers, completion dates (\`completedAt\`), and staleness metrics (\`daysSinceUpdate\`).
+
+## 1. Model Context Protocol (MCP) Tools
+
+When Esedre MCP is active in your agent session (\`.agents/mcp_config.json\`), use these tools directly:
+
+| Tool | Purpose | Key Arguments |
+|---|---|---|
+| \`esedre_list_tickets\` | List roadmap tickets with filters | \`project\` (e.g. \`Profe\`, \`Esedre\`, \`Alce\`), \`status\`, \`type\`, \`search\` |
+| \`esedre_get_ticket\` | Full specification, summary, comments, revision & sha1 | \`ticketId\` (numeric e.g. \`96\` or compound e.g. \`Profe-96\`) |
+| \`esedre_get_plan\` | Active implementation plan markdown | \`ticketId\` (numeric or compound) |
+| \`esedre_save_plan\` | Save implementation plan markdown with OCC | \`ticketId\`, \`planMarkdown\`, \`lastHash\` |
+| \`esedre_create_ticket\` | Mint a new ticket with auto sequential ID | \`title\` (max 48 chars), \`type\`, \`project\`, \`effort\`, \`summary\` |
+| \`esedre_update_ticket\` | Update ticket attributes with OCC | \`ticketId\`, \`status\`, \`type\`, \`title\`, \`complexity\`, \`effort\`, \`inDevelopment\`, \`featureFlag\`, \`lastHash\` |
+| \`esedre_add_comment\` | Append developer or agent comment | \`ticketId\`, \`text\`, \`author\` |
+
+## 2. Core CLI Commands (Fallback via \`run_command\`)
+
+Both \`esedre\` and \`ese\` work interchangeably:
+
+### List Tickets
+\`\`\`bash
+.esedre/ese list [-p|--project <code|all>] [-s|--status <status>] [-t|--type <type>] [-q|--search <q>] [--json]
+\`\`\`
+
+### Read Ticket Details
+\`\`\`bash
+.esedre/ese get <ticketId> [--json]
+\`\`\`
+
+### Read or Update Implementation Plans
+\`\`\`bash
+.esedre/ese plan <ticketId>
+.esedre/ese plan <ticketId> --file <planFilePath>
+.esedre/ese plan <ticketId> --set "<markdownContent>" [--last-hash <hash>]
+\`\`\`
+
+### Create a Ticket
+\`\`\`bash
+.esedre/ese create --title "..." [-p|--project <code>] [-t|--type Feature] [--complexity Medium] [--effort "2.0 - 4.0 hours"] [--json]
+\`\`\`
+
+### Update Ticket Status & Attributes
+\`\`\`bash
+.esedre/ese update <ticketId> --status "In Development"
+.esedre/ese update <ticketId> --status "Completed"
+.esedre/ese update <ticketId> --type Feature --complexity Medium --effort "2.0 - 4.0 hours"
+\`\`\`
+
+### Append Comments or Notes
+\`\`\`bash
+.esedre/ese comment <ticketId> "Verified implementation." --author "Agent"
+.esedre/ese comment <ticketId> --text "Verified implementation." --author "Agent"
+\`\`\`
+
+### Regenerate Snapshot
+\`\`\`bash
+.esedre/ese snapshot
+\`\`\`
+
+### Server Lifecycle & Daemon Management
+\`\`\`bash
+# Start background server daemon on port 5674 (default)
+.esedre/ese start [--port 5674] [--quiet] [--json]
+
+# Run foreground gateway server directly (Ctrl+C to stop)
+.esedre/ese start -f [--port 5674]
+
+# Check daemon health and diagnostics
+.esedre/ese status [--port 5674] [--json]
+
+# View recent daemon activity logs
+.esedre/ese logs [--port 5674] [--lines <n>]
+
+# Stop background server daemon
+.esedre/ese stop [--port 5674] [--quiet] [--json]
+\`\`\`
+
+## 3. Embedded View & Theme Token Contract
+
+When embedding \`<PlannedWorkView />\` inside a host app (e.g. \`PlannedWorkModal.tsx\`):
+
+### Zero-Effort Drop-in (Default Fallback)
+\`PlannedWorkView\` incorporates an internal CSS fallback bridge (\`.esedre-host-bridge\` / \`.esedre-theme-root\` with \`ESEDRE_THEME_FALLBACK_CSS\`).
+If an embedding application supplies **zero CSS variables**, the component automatically falls back to clean, high-contrast light or dark themes matching the user's OS preference (\`prefers-color-scheme: dark\`) or host \`.dark\` / \`[data-theme="night"]\` classes.
+
+### Theme Token Customization
+If the host application declares any or all of the 12 core design tokens on \`:root\` or an ancestor container, \`PlannedWorkView\` automatically adopts them:
+- **Surface**: \`--bg-surface\`, \`--bg-surface-elevated\`, \`--bg-input\`
+- **Borders**: \`--border-subtle\`, \`--border-strong\`, \`--border-accent\`
+- **Text**: \`--text-primary\`, \`--text-secondary\`, \`--text-muted\`
+- **Accent**: \`--accent-primary\`, \`--accent-bg-subtle\`, \`--accent-border-subtle\`
+
+## 4. Safety & Invariants
+- **Always use \`--json\`** for CLI programmatic inspection.
+- **Optimistic Concurrency**: Writes support \`--last-hash <hash>\` to prevent overwriting concurrent updates.
+- **Universal Type Naming**: Always use \`type\` (\`Feature\`, \`Platform\`, \`Tools\`, \`Idea\`, \`Bug\`). The legacy name \`category\` is deprecated.
+- **Compound IDs for Multi-Project Portfolios**: In \`project=all\`, ticket IDs are \`\${projectCode}-\${id}\` (e.g. \`Profe-1\`, \`Esedre-1\`). DOM anchors strictly use \`feature-card-\${projectCode}-\${id}\`.
+- **Never delete tickets** directly via filesystem.
+- **Workspace Scoping**: An LLM coding partner operates strictly within the authorized project scope declared in the local repository configuration. Central repository linking and system-level configuration are managed separately; focus roadmap work, implementation plans, and verification notes on this project.
+- **Secret Developer Hash Route (\`#/planner\`, \`#/plan\`, \`#planner\`, \`#plan\`)**:
+  - In web applications embedding Esedre (such as Professor Arwam), \`#/planner\` and \`#/plan\` serve as direct secret developer entry routes.
+  - **SEO Invariant**: These developer routes are private and MUST NEVER be exposed in \`sitemap.xml\`, \`robots.txt\`, \`llms.txt\`, or public navigation links.
+  - The URL hash is preserved across hard page refreshes (F5) without falling back to \`#/chat\` or other views.
+`;
 function plantWrappers(targetDir) {
-  const esedreDir = path5.join(targetDir, ".esedre");
-  fs5.mkdirSync(esedreDir, { recursive: true });
+  const esedreDir = path6.join(targetDir, ".esedre");
+  fs6.mkdirSync(esedreDir, { recursive: true });
   const wrappers = [
     { name: "esedre.cmd", content: WRAPPER_CMD, exec: false },
     { name: "esedre.ps1", content: WRAPPER_PS1, exec: false },
@@ -2188,24 +2860,24 @@ function plantWrappers(targetDir) {
     { name: "ese", content: ESE_WRAPPER_BASH, exec: true }
   ];
   for (const w of wrappers) {
-    const fullPath = path5.join(esedreDir, w.name);
-    fs5.writeFileSync(fullPath, w.content, "utf-8");
+    const fullPath = path6.join(esedreDir, w.name);
+    fs6.writeFileSync(fullPath, w.content, "utf-8");
     if (w.exec) {
       try {
-        fs5.chmodSync(fullPath, 493);
+        fs6.chmodSync(fullPath, 493);
       } catch {
       }
     }
   }
 }
 function setupMcpConfig(targetDir) {
-  const agentsDir = path5.join(targetDir, ".agents");
-  fs5.mkdirSync(agentsDir, { recursive: true });
-  const mcpConfigPath = path5.join(agentsDir, "mcp_config.json");
+  const agentsDir = path6.join(targetDir, ".agents");
+  fs6.mkdirSync(agentsDir, { recursive: true });
+  const mcpConfigPath = path6.join(agentsDir, "mcp_config.json");
   let configObj = { mcpServers: {} };
-  if (fs5.existsSync(mcpConfigPath)) {
+  if (fs6.existsSync(mcpConfigPath)) {
     try {
-      configObj = JSON.parse(fs5.readFileSync(mcpConfigPath, "utf-8"));
+      configObj = JSON.parse(fs6.readFileSync(mcpConfigPath, "utf-8"));
       if (!configObj.mcpServers) configObj.mcpServers = {};
     } catch {
     }
@@ -2222,28 +2894,29 @@ function setupMcpConfig(targetDir) {
     };
   }
   try {
-    fs5.writeFileSync(mcpConfigPath, JSON.stringify(configObj, null, 2) + "\n", "utf-8");
+    fs6.writeFileSync(mcpConfigPath, JSON.stringify(configObj, null, 2) + "\n", "utf-8");
     return true;
   } catch {
     return false;
   }
 }
-function setupSkill(targetDir) {
-  const skillDir = path5.join(targetDir, ".agents", "skills", "esedre");
-  fs5.mkdirSync(skillDir, { recursive: true });
-  const skillFile = path5.join(skillDir, "SKILL.md");
-  if (!fs5.existsSync(skillFile)) {
-    fs5.writeFileSync(skillFile, ESEDRE_SKILL_TEMPLATE, "utf-8");
+function setupSkill(targetDir, options = {}) {
+  const skillDir = path6.join(targetDir, ".agents", "skills", "esedre");
+  fs6.mkdirSync(skillDir, { recursive: true });
+  const skillFile = path6.join(skillDir, "SKILL.md");
+  if (!fs6.existsSync(skillFile)) {
+    fs6.writeFileSync(skillFile, ESEDRE_SKILL_TEMPLATE, "utf-8");
     return { status: "MISSING", updated: true };
   }
-  const currentContent = fs5.readFileSync(skillFile, "utf-8");
-  const status = classifyContent(currentContent, ESEDRE_SKILL_TEMPLATE, []);
-  if (status === "LATEST") {
+  const currentContent = fs6.readFileSync(skillFile, "utf-8");
+  const status = classifyContent(currentContent, ESEDRE_SKILL_TEMPLATE, HISTORIC_SKILL_HASHES);
+  if (status === "LATEST" && !options.force) {
     return { status, updated: false };
   }
-  if (status === "HISTORIC_DEFAULT" || status === "MISSING") {
-    fs5.writeFileSync(skillFile, ESEDRE_SKILL_TEMPLATE, "utf-8");
-    return { status, updated: true };
+  const hasBannedOrDeprecatedTerms = currentContent.includes("companion agent") || currentContent.includes("companion LLM") || currentContent.includes("tools/esedre.mjs");
+  if (options.force || status === "HISTORIC_DEFAULT" || status === "MISSING" || hasBannedOrDeprecatedTerms) {
+    fs6.writeFileSync(skillFile, ESEDRE_SKILL_TEMPLATE, "utf-8");
+    return { status: "LATEST", updated: true };
   }
   return { status, updated: false };
 }
@@ -2256,8 +2929,8 @@ var VITE_CONFIG_FILES = [
 ];
 function findViteConfig(targetDir) {
   for (const name of VITE_CONFIG_FILES) {
-    const fullPath = path5.join(targetDir, name);
-    if (fs5.existsSync(fullPath)) {
+    const fullPath = path6.join(targetDir, name);
+    if (fs6.existsSync(fullPath)) {
       return fullPath;
     }
   }
@@ -2321,10 +2994,10 @@ function configureViteProxy(targetDir, port = DEFAULT_ESEDRE_PORT, setupProxy) {
       recommendedProxySnippet: snippet
     };
   }
-  const relativeName = path5.basename(configPath);
+  const relativeName = path6.basename(configPath);
   let content = "";
   try {
-    content = fs5.readFileSync(configPath, "utf-8");
+    content = fs6.readFileSync(configPath, "utf-8");
   } catch {
     return {
       status: "MANUAL_REQUIRED",
@@ -2355,7 +3028,7 @@ function configureViteProxy(targetDir, port = DEFAULT_ESEDRE_PORT, setupProxy) {
     };
   }
   try {
-    fs5.writeFileSync(configPath, injected, "utf-8");
+    fs6.writeFileSync(configPath, injected, "utf-8");
     return {
       status: "CONFIGURED",
       configFile: relativeName,
@@ -2370,25 +3043,27 @@ function configureViteProxy(targetDir, port = DEFAULT_ESEDRE_PORT, setupProxy) {
   }
 }
 function configureWorkspace(targetDir, options = {}) {
-  const esedreDir = path5.join(targetDir, ".esedre");
-  if (!fs5.existsSync(esedreDir)) {
-    fs5.mkdirSync(esedreDir, { recursive: true });
+  const esedreDir = path6.join(targetDir, ".esedre");
+  if (!fs6.existsSync(esedreDir)) {
+    fs6.mkdirSync(esedreDir, { recursive: true });
   }
-  const esedreJsonPath = path5.join(esedreDir, "esedre.json");
+  const esedreJsonPath = path6.join(esedreDir, "esedre.json");
   let existingRaw = null;
-  if (fs5.existsSync(esedreJsonPath)) {
+  if (fs6.existsSync(esedreJsonPath)) {
     try {
-      existingRaw = JSON.parse(fs5.readFileSync(esedreJsonPath, "utf-8"));
+      existingRaw = JSON.parse(fs6.readFileSync(esedreJsonPath, "utf-8"));
     } catch {
     }
   }
   let config;
   const projectCode = options.projectCode || existingRaw?.projectCode;
   const projectName = options.projectName || existingRaw?.projectName || (projectCode ? projectCode : void 0);
+  const dataDir = options.dataDir !== void 0 ? options.dataDir : existingRaw?.dataDir;
   if (existingRaw) {
     config = migrateEsedreConfig(existingRaw, CURRENT_ESEDRE_VERSION);
     if (projectCode) config.projectCode = projectCode;
     if (projectName) config.projectName = projectName;
+    if (dataDir) config.dataDir = dataDir;
     if (options.allowedProjects) {
       config.allowedProjects = options.allowedProjects;
     } else if (projectCode) {
@@ -2405,18 +3080,20 @@ function configureWorkspace(targetDir, options = {}) {
       projectCode: projectCode || void 0,
       projectName: projectName || void 0,
       allowedProjects: options.allowedProjects || (projectCode ? [projectCode] : void 0),
-      port: options.port || DEFAULT_ESEDRE_PORT
+      dataDir: dataDir || void 0,
+      port: options.port || void 0
     };
   }
-  fs5.writeFileSync(esedreJsonPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  fs6.writeFileSync(esedreJsonPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
   let projectRegistered = false;
   if (projectCode) {
-    const ticketsDir = path5.join(esedreDir, "tickets");
-    if (!fs5.existsSync(ticketsDir)) {
-      fs5.mkdirSync(ticketsDir, { recursive: true });
+    const hasExistingTicketsDir = fs6.existsSync(path6.join(targetDir, "tickets")) || fs6.existsSync(path6.join(targetDir, "src", "data", "planning", "tickets"));
+    const ticketsDir = path6.join(esedreDir, "tickets");
+    if (!hasExistingTicketsDir && !fs6.existsSync(ticketsDir)) {
+      fs6.mkdirSync(ticketsDir, { recursive: true });
     }
-    const inRepoPJson = path5.join(esedreDir, "project.json");
-    if (!fs5.existsSync(inRepoPJson)) {
+    const inRepoPJson = path6.join(esedreDir, "project.json");
+    if (!fs6.existsSync(inRepoPJson)) {
       const projDesc = {
         id: 1,
         code: projectCode.toUpperCase(),
@@ -2429,14 +3106,14 @@ function configureWorkspace(targetDir, options = {}) {
           border: "border-cyan-500/40"
         }
       };
-      fs5.writeFileSync(inRepoPJson, JSON.stringify(projDesc, null, 2) + "\n", "utf-8");
+      fs6.writeFileSync(inRepoPJson, JSON.stringify(projDesc, null, 2) + "\n", "utf-8");
       projectRegistered = true;
     } else if (projectName) {
       try {
-        const existing = JSON.parse(fs5.readFileSync(inRepoPJson, "utf-8"));
+        const existing = JSON.parse(fs6.readFileSync(inRepoPJson, "utf-8"));
         if (existing.name !== projectName) {
           existing.name = projectName;
-          fs5.writeFileSync(inRepoPJson, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+          fs6.writeFileSync(inRepoPJson, JSON.stringify(existing, null, 2) + "\n", "utf-8");
         }
       } catch {
       }
@@ -2448,8 +3125,9 @@ function configureWorkspace(targetDir, options = {}) {
   if (options.setupMcp !== false) {
     mcpConfigured = setupMcpConfig(targetDir);
   }
-  const skillRes = setupSkill(targetDir);
-  const proxyRes = configureViteProxy(targetDir, config.port || DEFAULT_ESEDRE_PORT, options.setupProxy);
+  const skillRes = setupSkill(targetDir, { force: options.force });
+  const targetPort = resolvePorts(config).gateway;
+  const proxyRes = configureViteProxy(targetDir, targetPort, options.setupProxy);
   const globalStoreRes = ensureGlobalEsedreStore();
   if (!globalStoreRes.ok) {
     console.warn(`\x1B[33m\u26A0\uFE0F Warning: Could not initialize global store at ${globalStoreRes.path}: ${globalStoreRes.error}\x1B[0m`);
@@ -2471,17 +3149,41 @@ function configureWorkspace(targetDir, options = {}) {
     globalStoreError: globalStoreRes.error
   };
 }
+var initWorkspace = configureWorkspace;
+function initHub(targetDir) {
+  const resolved = path6.resolve(targetDir);
+  if (!fs6.existsSync(resolved)) {
+    fs6.mkdirSync(resolved, { recursive: true });
+  }
+  const projectsDir = path6.join(resolved, "projects");
+  let projectsDirCreated = false;
+  if (!fs6.existsSync(projectsDir)) {
+    fs6.mkdirSync(projectsDir, { recursive: true });
+    projectsDirCreated = true;
+  }
+  const projectsJsonPath = path6.join(resolved, "projects.json");
+  let projectsJsonCreated = false;
+  if (!fs6.existsSync(projectsJsonPath)) {
+    fs6.writeFileSync(projectsJsonPath, "[]\n", "utf-8");
+    projectsJsonCreated = true;
+  }
+  return {
+    projectsJsonCreated,
+    projectsDirCreated,
+    hubDir: resolved.replace(/\\/g, "/")
+  };
+}
 
 // src/server/gateway.ts
-import fs7 from "node:fs";
+import fs8 from "node:fs";
 import http4 from "node:http";
-import path7 from "node:path";
+import path8 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/server/uiServer.ts
 import http2 from "node:http";
-import fs6 from "node:fs";
-import path6 from "node:path";
+import fs7 from "node:fs";
+import path7 from "node:path";
 var MIME_TYPES = {
   ".html": "text/html; charset=utf-8",
   ".js": "application/javascript; charset=utf-8",
@@ -2511,20 +3213,20 @@ function startUiServer(port, webDir) {
     if (!reqPath || reqPath === "/") {
       reqPath = "/index.html";
     }
-    const safePath = path6.normalize(reqPath).replace(/^(\.\.[/\\])+/, "");
-    let filePath = path6.join(webDir, safePath);
-    if (!fs6.existsSync(filePath) || fs6.statSync(filePath).isDirectory()) {
-      filePath = path6.join(webDir, "index.html");
+    const safePath = path7.normalize(reqPath).replace(/^(\.\.[/\\])+/, "");
+    let filePath = path7.join(webDir, safePath);
+    if (!fs7.existsSync(filePath) || fs7.statSync(filePath).isDirectory()) {
+      filePath = path7.join(webDir, "index.html");
     }
-    if (!fs6.existsSync(filePath)) {
+    if (!fs7.existsSync(filePath)) {
       res.writeHead(404, { "Content-Type": "text/plain" });
       res.end("Esedre UI: index.html not found. Run npm run build first.");
       return;
     }
-    const ext = path6.extname(filePath).toLowerCase();
+    const ext = path7.extname(filePath).toLowerCase();
     const contentType = MIME_TYPES[ext] || "application/octet-stream";
     try {
-      const content = fs6.readFileSync(filePath);
+      const content = fs7.readFileSync(filePath);
       res.writeHead(200, { "Content-Type": contentType });
       res.end(content);
     } catch (err) {
@@ -2605,6 +3307,10 @@ function createApiHandler(storage, workspaceRoot) {
     }
     try {
       if (req.method === "GET") {
+        if (pathname === "/api/ping") {
+          sendJson(res, 200, { status: "ok", esedre: true });
+          return true;
+        }
         if (pathname === "/api/planning/projects") {
           const projects = await storage.getProjects();
           sendJson(res, 200, projects);
@@ -2628,7 +3334,7 @@ function createApiHandler(storage, workspaceRoot) {
         }
         if (pathname.startsWith("/api/planning/ticket/")) {
           const idStr = pathname.slice("/api/planning/ticket/".length);
-          if (!idStr || !/^([a-zA-Z0-9]{1,6}-)?\d+$/.test(idStr)) {
+          if (!idStr || !/^([a-zA-Z0-9]{1,7}-)?\d+$/.test(idStr)) {
             sendJson(res, 400, { error: "Invalid ticket ID" });
             return true;
           }
@@ -2780,6 +3486,11 @@ function createApiHandler(storage, workspaceRoot) {
             sendJson(res, 400, { error: codeVal.error });
             return true;
           }
+          const nameVal = validateProjectName(name);
+          if (!nameVal.valid) {
+            sendJson(res, 400, { error: nameVal.error });
+            return true;
+          }
           invalidateApiCache();
           const project = await storage.registerProject({
             code,
@@ -2859,35 +3570,35 @@ function startApiServer(port, storage, workspaceRoot) {
 
 // src/server/gateway.ts
 var __filename2 = fileURLToPath2(import.meta.url);
-var __dirname2 = path7.dirname(__filename2);
+var __dirname2 = path8.dirname(__filename2);
 function resolveWebDir(explicitWebDir, workspaceRoot) {
-  if (explicitWebDir && fs7.existsSync(path7.join(explicitWebDir, "index.html"))) {
+  if (explicitWebDir && fs8.existsSync(path8.join(explicitWebDir, "index.html"))) {
     return explicitWebDir;
   }
   const candidates = [
     // 1. Packaged layout right next to executable (e.g. tools/web)
-    path7.resolve(__dirname2, "web"),
+    path8.resolve(__dirname2, "web"),
     // 2. From workspace root: <workspaceRoot>/dist/web
-    workspaceRoot ? path7.resolve(workspaceRoot, "dist", "web") : "",
+    workspaceRoot ? path8.resolve(workspaceRoot, "dist", "web") : "",
     // 3. In-repo legacy subfolder: <workspaceRoot>/esedre/dist/web
-    workspaceRoot ? path7.resolve(workspaceRoot, "esedre", "dist", "web") : "",
+    workspaceRoot ? path8.resolve(workspaceRoot, "esedre", "dist", "web") : "",
     // 4. Sibling standalone repository from workspace root: <workspaceRoot>/../esedre/dist/web
-    workspaceRoot ? path7.resolve(workspaceRoot, "..", "esedre", "dist", "web") : "",
+    workspaceRoot ? path8.resolve(workspaceRoot, "..", "esedre", "dist", "web") : "",
     // 5. Packaged layout inside dist/web
-    path7.resolve(__dirname2, "dist", "web"),
+    path8.resolve(__dirname2, "dist", "web"),
     // 6. Sibling standalone repository from __dirname: <__dirname>/../../esedre/dist/web
-    path7.resolve(__dirname2, "..", "..", "esedre", "dist", "web"),
+    path8.resolve(__dirname2, "..", "..", "esedre", "dist", "web"),
     // 7. Source tree layout: esedre/src/server/ -> esedre/dist/web
-    path7.resolve(__dirname2, "..", "..", "dist", "web"),
+    path8.resolve(__dirname2, "..", "..", "dist", "web"),
     // 8. Legacy layout from __dirname
-    path7.resolve(__dirname2, "..", "esedre", "dist", "web")
+    path8.resolve(__dirname2, "..", "esedre", "dist", "web")
   ].filter(Boolean);
   for (const candidate of candidates) {
-    if (fs7.existsSync(path7.join(candidate, "index.html"))) {
+    if (fs8.existsSync(path8.join(candidate, "index.html"))) {
       return candidate;
     }
   }
-  return candidates[0] || path7.resolve(__dirname2, "web");
+  return candidates[0] || path8.resolve(__dirname2, "web");
 }
 function proxyRequest(req, res, targetPort, rewritePath) {
   const targetPath = rewritePath ? rewritePath(req.url || "/") : req.url || "/";
@@ -2917,7 +3628,12 @@ function proxyRequest(req, res, targetPort, rewritePath) {
   req.pipe(proxyReq, { end: true });
 }
 function startGatewayCluster(options) {
-  const gatewayPort = options.gatewayPort !== void 0 ? options.gatewayPort : 5674;
+  const resolved = resolvePorts(void 0, {
+    gatewayPort: options.gatewayPort,
+    uiPort: options.uiPort,
+    apiPort: options.apiPort
+  });
+  const gatewayPort = resolved.gateway;
   const uiPort = options.uiPort !== void 0 ? options.uiPort : gatewayPort ? gatewayPort + 1 : 0;
   const apiPort = options.apiPort !== void 0 ? options.apiPort : gatewayPort ? gatewayPort + 2 : 0;
   const webDir = resolveWebDir(options.webDir, options.workspaceRoot);
@@ -2971,18 +3687,23 @@ function startGatewayCluster(options) {
 }
 
 // bin/esedre.ts
-function printHelp() {
+function printHelp(config) {
+  const port = config?.port || DEFAULT_ESEDRE_PORT;
+  const projectCode = config?.projectCode;
+  const webUrl = `http://localhost:${port}/app${projectCode ? "?project=" + encodeURIComponent(projectCode) : "?project=all"}`;
   console.log(`
-${colors.bold}${colors.cyan}Esedre CLI (/eh-seh-dreh/)${colors.reset}: Developer Roadmap & Companion LLM Coordination Engine
+${colors.bold}${colors.cyan}Esedre CLI (/eh-seh-dreh/)${colors.reset}: Developer Roadmap & LLM Coding Partner Coordination Engine
+
+${colors.bold}WEB UI:${colors.reset}
+  Interactive Planner: ${colors.cyan}${webUrl}${colors.reset}
 
 ${colors.bold}USAGE:${colors.reset}
   .esedre/esedre <command> [options]
   .esedre/ese <command> [options]
   esedre <command> [options]
   ese <command> [options]
-  node tools/esedre.mjs <command> [options]
 
-${colors.bold}COMMANDS:${colors.reset}
+${colors.bold}ROADMAP COMMANDS (Pair Programming & LLM Agents):${colors.reset}
   ${colors.bold}list${colors.reset}        [-p|--project <code|all>] [-s|--status <status>] [-t|--type <type>] [-q|--search <q>] [--json]
                List roadmap tickets with optional filters (defaults to active project).
                \u2022 Status values: 'Planned', 'In Development', 'Completed', 'Rejected'
@@ -2997,46 +3718,48 @@ ${colors.bold}COMMANDS:${colors.reset}
   ${colors.bold}create${colors.reset}      --title "..." [-p|--project <code>] [-t|--type <type>] [--complexity <c>] [--effort "<e>"] [--summary "<s>"] [--json]
                Mint a new roadmap ticket with sequential numeric ID.
 
-  ${colors.bold}update${colors.reset}      <id> [-s|--status <status>] [--title "..."] [--flag] [--no-flag] [--last-hash <sha1>] [--force] [--json]
-               Mutate ticket status, title, active state, or feature flag with OCC protection.
+  ${colors.bold}update${colors.reset}      <id> [-s|--status <status>] [-t|--type <type>] [--title "..."] [--complexity <c>] [--effort "<e>"] [--in-dev] [--flag <name>] [--last-hash <sha1>] [--force] [--json]
+               Mutate ticket status, type, title, complexity, effort, active state, or feature flag with OCC protection.
 
-  ${colors.bold}comment${colors.reset}     <id> --text "..." [--author "..."] [--json]
+  ${colors.bold}comment${colors.reset}     <id> ["<text>"] [--text "..."] [--author "..."] [--json]
                Append a research finding, test verification, or note to ticket history.
 
   ${colors.bold}snapshot${colors.reset}    [--project <code>] [--json]
                Generate lean read-only projection snapshot (.esedre/snapshot.json) for zero-latency agent context.
 
-  ${colors.bold}configure${colors.reset}   [--project <code>] [-n|--name <name>] [--allow <c1,c2>] [--port <n>] [--no-mcp] [--proxy] [--no-proxy] [-y|--yes] [--json]
-               Initialize or update .esedre footprint, register project code & display name in Esedre,
-               plant wrappers (.esedre/esedre.cmd, .esedre/ese.cmd, etc.), configure .gitignore,
-               MCP server config, agent skill templates, and display guided next steps.
-
-  ${colors.bold}upgrade${colors.reset}     [--json]
-               Upgrade workspace configuration schema, wrappers, and agent skills. Refreshes snapshot.
-
-  ${colors.bold}projects${colors.reset}    [--json]
-               List registered workspace projects, project codes (e.g. 'CORE', 'WEB', 'DOCS'), and descriptions.
-
-  ${colors.bold}daemon${colors.reset}      [start|stop|status|logs] [--port <n>] [--quiet] [--json]
-               Manage background daemon process (start, stop, check status, or view logs).
-
-  ${colors.bold}serve${colors.reset}       [--port <n>]
-               Run the unified gateway & web server in foreground (default 5674).
-
-  ${colors.bold}start${colors.reset}       [--port <n>] [--quiet] [--json]
-               Alias for 'daemon start'. Start Esedre background daemon process.
+${colors.bold}SERVICE DAEMON COMMANDS:${colors.reset}
+  ${colors.bold}start${colors.reset}       [--port <n>] [--foreground | -f] [--quiet] [--json]
+               Start the Esedre background server and web UI daemon (default port ${DEFAULT_ESEDRE_PORT}).
+               Use --foreground (-f) to run directly in terminal foreground (blocks terminal, Ctrl+C to stop).
 
   ${colors.bold}stop${colors.reset}        [--port <n>] [--quiet] [--json]
-               Alias for 'daemon stop'. Stop the running Esedre background daemon process.
+               Stop the running Esedre background server daemon.
 
   ${colors.bold}status${colors.reset}      [--port <n>] [--json]
-               Alias for 'daemon status'. Check health and diagnostics of the daemon process.
+               Check health, uptime, and diagnostics of the running Esedre server.
 
   ${colors.bold}logs${colors.reset}        [--port <n>] [--lines <n>]
-               Tail recent output logs from the Esedre daemon process.
+               Tail recent logs from the Esedre background server.
 
   ${colors.bold}mcp${colors.reset}         Start the Model Context Protocol (MCP) JSON-RPC 2.0 stdio server for autonomous LLM coding agents.
 
+${colors.bold}DEVELOPER ADMINISTRATION (Human Setup & Configuration):${colors.reset}
+  ${colors.bold}init${colors.reset}        [<path>] [--project <code>] [-n|--name <name>] [--allow <c1,c2>] [--port <n>] [--hub] [--proxy] [--no-proxy] [-y|--yes] [--json]
+               Bring a project repository online (.esedre footprint, wrappers, snapshot) or bootstrap a data hub (--hub).
+
+  ${colors.bold}configure${colors.reset}   [add <path> | remove <code|path> | set <key> <val> | get <key>] [--json]
+               Inspect or mutate central Esedre configuration (~/.esedre/config.json).
+               \u2022 add <path>       Smart-detect and link a data hub or project repository
+               \u2022 remove <target>  Unlink a project or data hub
+               \u2022 set <key> <val>  Update a central configuration setting
+
+  ${colors.bold}upgrade${colors.reset}     [<path>] [--force|-f] [--json]
+               Upgrade workspace configuration schema, wrappers, and agent skills. Refreshes snapshot.
+               Pass --force to overwrite customized skills with the latest official template.
+
+  ${colors.bold}projects${colors.reset}    [--json]
+               List registered workspace projects, project codes (e.g. 'CORE', 'WEB', 'DOCS'), and descriptions.
+
 ${colors.bold}OPTIONS:${colors.reset}
   -p, --project <code> Project code (e.g. CORE, ALCE, DOCS).
   -n, --name <name>    Project display name (e.g. "Alce Web Reader").
@@ -3046,6 +3769,7 @@ ${colors.bold}OPTIONS:${colors.reset}
   --json              Output raw machine-readable JSON (strongly recommended for autonomous LLM coding agents).
   --last-hash <hash>  Optimistic concurrency control: last known sha1 hash of the ticket from 'get'.
   --force             Bypass optimistic concurrency last-hash conflict checks on writes.
+  -v, --version       Show the current version number.
   -h, --help          Show this help reference.
 
 ${colors.bold}TYPICAL AGENT WORKFLOW:${colors.reset}
@@ -3102,50 +3826,97 @@ function parseArgs(rawArgs) {
   if (flags["n"] && !flags["name"]) flags["name"] = flags["n"];
   if (flags["s"] && !flags["status"]) flags["status"] = flags["s"];
   if (flags["q"] && !flags["search"]) flags["search"] = flags["q"];
+  if (flags["f"] && !flags["foreground"]) flags["foreground"] = flags["f"];
   return { command, positionals, flags };
 }
 async function main() {
   const rawArgs = process.argv.slice(2);
   const { command, positionals, flags } = parseArgs(rawArgs);
+  try {
+    writeGlobalVersion();
+  } catch {
+  }
+  const discovered = findEsedreConfig(process.cwd(), { fallbackToGlobal: true });
+  const isJson = Boolean(flags["json"]);
+  if (flags["version"] || flags["v"] || command === "version") {
+    if (isJson) {
+      console.log(JSON.stringify({ version: CURRENT_ESEDRE_VERSION }));
+    } else {
+      console.log(`esedre v${CURRENT_ESEDRE_VERSION}`);
+    }
+    return;
+  }
   if (!command || flags["help"] || flags["h"]) {
-    printHelp();
+    printHelp(discovered.config);
     return;
   }
-  const isJson = Boolean(flags["json"]);
-  const discovered = findEsedreConfig(process.cwd());
   const rawStorage = new FilesystemStorageAdapter(discovered.workspaceRoot, discovered.config);
   const storage = new SecurityFilter(rawStorage, discovered.config);
   try {
     switch (command) {
-      case "configure": {
+      case "init": {
+        const targetDir = positionals[0] ? path9.resolve(positionals[0]) : discovered.workspaceRoot;
+        const isHub = Boolean(flags["hub"]);
+        if (isHub) {
+          const hubRes = initHub(targetDir);
+          try {
+            addLocationToGlobalConfig(targetDir);
+          } catch {
+          }
+          if (isJson) {
+            console.log(JSON.stringify(hubRes, null, 2));
+          } else {
+            console.log(`${colors.bold}${colors.green}\u2714 Initialized Esedre ticket data hub!${colors.reset}`);
+            console.log(`  \u2022 Location:      ${hubRes.hubDir}`);
+            console.log(`  \u2022 Projects file: ${hubRes.projectsJsonCreated ? "Created projects.json" : "Existing projects.json"}`);
+            console.log(`  \u2022 Projects dir:  ${hubRes.projectsDirCreated ? "Created projects/ directory" : "Existing projects/ directory"}`);
+            console.log(`  \u2022 Global Config: Registered as dataDir in ~/.esedre/config.json`);
+            console.log(`
+${colors.bold}Next Steps:${colors.reset}`);
+            console.log(`  1. Link project repositories to this hub using:`);
+            console.log(`     ${colors.cyan}ese configure add <projectPath>${colors.reset}`);
+            console.log(`  2. Start the Esedre background server:`);
+            console.log(`     ${colors.cyan}ese start${colors.reset}`);
+          }
+          return;
+        }
         let projectCode = flags["project"] || flags["p"] || discovered.config?.projectCode;
         let projectName = flags["name"] || flags["n"] || discovered.config?.projectName;
         const allowArg = flags["allow"];
-        const port = flags["port"] ? parseInt(String(flags["port"]), 10) : discovered.config?.port || 5674;
+        const port = flags["port"] ? parseInt(String(flags["port"]), 10) : void 0;
         const setupMcp = flags["no-mcp"] ? false : true;
         const isYes = Boolean(flags["yes"] || flags["y"]);
-        if (process.stdin.isTTY && (!projectCode || !projectName) && !isJson) {
+        const detected = detectProjectManifest(targetDir);
+        const candidateCode = detected.candidateCode;
+        const candidateName = detected.candidateName;
+        if (!isJson && detected.manifestFile && !projectCode) {
+          console.log(`${colors.dim}  \u2022 Detected ${detected.manifestType} project (${detected.manifestFile}): ${candidateName}${colors.reset}`);
+        }
+        if (isYes) {
+          if (!projectCode) projectCode = candidateCode;
+          if (!projectName) projectName = candidateName || projectCode;
+        } else if (process.stdin.isTTY && (!projectCode || !projectName) && !isJson) {
           const readline2 = await import("node:readline/promises");
           const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
           try {
             if (!projectCode) {
-              const codeAnswer = await rl.question(
-                `${colors.cyan}?${colors.reset} Project code (1-6 alphanumeric characters, e.g. ALCE, DOCS): `
-              );
-              projectCode = codeAnswer.trim();
+              const promptMsg = candidateCode ? `${colors.cyan}?${colors.reset} Project code (1-${MAX_PROJECT_CODE_LENGTH} alphanumeric characters) [${candidateCode}]: ` : `${colors.cyan}?${colors.reset} Project code (1-${MAX_PROJECT_CODE_LENGTH} alphanumeric characters, e.g. ALCE, DOCS): `;
+              const codeAnswer = await rl.question(promptMsg);
+              projectCode = codeAnswer.trim() || candidateCode;
             }
             if (!projectName && projectCode) {
+              const defaultDisplayName = candidateName || `${projectCode} App`;
               const nameAnswer = await rl.question(
-                `${colors.cyan}?${colors.reset} Project display name (e.g. ${projectCode} App) [${projectCode}]: `
+                `${colors.cyan}?${colors.reset} Project display name [${defaultDisplayName}]: `
               );
-              projectName = nameAnswer.trim() || projectCode;
+              projectName = nameAnswer.trim() || defaultDisplayName;
             }
           } finally {
             rl.close();
           }
         }
         if (!projectCode) {
-          console.error(`${colors.red}Error: Project code is required (--project <code>, -p <code>, or configure projectCode in esedre.json).${colors.reset}`);
+          console.error(`${colors.red}Error: Project code is required (--project <code>, -p <code>, or in esedre.json).${colors.reset}`);
           process.exit(1);
         }
         const codeVal = validateProjectCode(projectCode);
@@ -3156,6 +3927,11 @@ async function main() {
         if (!projectName) {
           projectName = projectCode;
         }
+        const nameVal = validateProjectName(projectName);
+        if (!nameVal.valid) {
+          console.error(`${colors.red}Error: ${nameVal.error}${colors.reset}`);
+          process.exit(1);
+        }
         const existingProjects = await storage.getProjects();
         const existing = existingProjects.find(
           (p) => p.code.toLowerCase() === projectCode.toLowerCase()
@@ -3184,10 +3960,10 @@ async function main() {
         } else if (flags["no-proxy"] !== void 0) {
           setupProxy = false;
         }
-        const viteConfigPath = findViteConfig(discovered.workspaceRoot);
+        const viteConfigPath = findViteConfig(targetDir);
         if (viteConfigPath && setupProxy === void 0 && !isJson) {
           try {
-            const rawContent = fs8.readFileSync(viteConfigPath, "utf-8");
+            const rawContent = fs9.readFileSync(viteConfigPath, "utf-8");
             const alreadyConfigured = rawContent.includes("'/esedre'") || rawContent.includes('"/esedre"');
             if (!alreadyConfigured) {
               if (isYes) {
@@ -3197,7 +3973,7 @@ async function main() {
                 const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
                 try {
                   const answer = await rl.question(
-                    `${colors.cyan}?${colors.reset} Detected ${colors.bold}${path8.basename(viteConfigPath)}${colors.reset}. Would you like to configure a reverse proxy for ${colors.bold}/esedre${colors.reset} targeting http://127.0.0.1:${port}? [Y/n] `
+                    `${colors.cyan}?${colors.reset} Detected ${colors.bold}${path9.basename(viteConfigPath)}${colors.reset}. Would you like to configure a reverse proxy for ${colors.bold}/esedre${colors.reset} targeting http://127.0.0.1:${port}? [Y/n] `
                   );
                   const trimmed = answer.trim().toLowerCase();
                   setupProxy = trimmed === "" || trimmed === "y" || trimmed === "yes";
@@ -3209,20 +3985,36 @@ async function main() {
           } catch {
           }
         }
-        const res = configureWorkspace(discovered.workspaceRoot, {
+        const rawHub = flags["data-dir"] || flags["hub"] || discovered.config?.dataDir;
+        let hubRelPath = void 0;
+        if (rawHub) {
+          const singleHub = Array.isArray(rawHub) ? rawHub[0] : rawHub;
+          const resolvedHub = path9.resolve(expandHome(singleHub));
+          if (fs9.existsSync(resolvedHub)) {
+            const rel = path9.relative(targetDir, resolvedHub).replace(/\\/g, "/");
+            hubRelPath = rel.startsWith(".") ? rel : "./" + rel;
+          }
+        }
+        const res = initWorkspace(targetDir, {
           projectCode,
           projectName: registeredProj.name,
           allowedProjects,
+          dataDir: hubRelPath,
           port,
           setupMcp,
           setupProxy
         });
+        try {
+          addLocationToGlobalConfig(targetDir);
+        } catch {
+        }
         let snapshotTickets = 0;
         try {
-          const snapshot = await generateProjectSnapshot(storage, projectCode, discovered.workspaceRoot);
+          const snapshot = await generateProjectSnapshot(storage, projectCode, targetDir);
           snapshotTickets = snapshot.totalTickets;
         } catch {
         }
+        const effectivePort = resolvePorts(discovered.config, { port }).gateway;
         if (isJson) {
           console.log(JSON.stringify({
             ...res,
@@ -3230,9 +4022,9 @@ async function main() {
             projectNewlyRegistered,
             snapshotTickets,
             urls: {
-              ui: `http://localhost:${port}/app?project=${projectCode}`,
-              portfolio: `http://localhost:${port}/app?project=all`,
-              api: `http://localhost:${port}/api`
+              ui: `http://localhost:${effectivePort}/app?project=${projectCode}`,
+              portfolio: `http://localhost:${effectivePort}/app?project=all`,
+              api: `http://localhost:${effectivePort}/api`
             },
             commands: {
               start: "ese start",
@@ -3243,7 +4035,7 @@ async function main() {
             }
           }, null, 2));
         } else {
-          console.log(`${colors.bold}${colors.green}\u2714 Esedre workspace configured successfully!${colors.reset}`);
+          console.log(`${colors.bold}${colors.green}\u2714 Esedre workspace initialized successfully!${colors.reset}`);
           console.log(`  \u2022 Config: .esedre/esedre.json (Project: ${projectCode} (${registeredProj.name}), Version: ${CURRENT_ESEDRE_VERSION})`);
           if (projectNewlyRegistered) {
             console.log(`  \u2022 Project: ${colors.green}Registered new project '${projectCode}' (${registeredProj.name}) in Esedre${colors.reset}`);
@@ -3255,13 +4047,9 @@ async function main() {
           console.log(`  \u2022 Snapshot: Generated .esedre/snapshot.json (${snapshotTickets} tickets projected)`);
           console.log(`  \u2022 MCP: ${res.mcpConfigured ? "Configured in .agents/mcp_config.json" : "Skipped"}`);
           console.log(`  \u2022 Skill: ${res.skillConfigured ? "Updated .agents/skills/esedre/SKILL.md" : `Retained (${res.skillStatus})`}`);
-          if (res.globalStoreStatus === "ready") {
-            console.log(`  \u2022 Global Store: ${res.globalStorePath} (verified write permissions)`);
-          } else if (res.globalStoreStatus === "warning") {
-            console.log(`  \u2022 ${colors.yellow}Global Store: Fallback to ${res.globalStorePath} (${res.globalStoreError})${colors.reset}`);
-          }
+          console.log(`  \u2022 Central Config: Linked into ~/.esedre/config.json`);
           if (res.viteProxyStatus === "CONFIGURED") {
-            console.log(`  \u2022 ${colors.green}Vite Proxy: Added /esedre proxy to ${res.viteConfigFile} targeting http://127.0.0.1:${port}${colors.reset}`);
+            console.log(`  \u2022 ${colors.green}Vite Proxy: Added /esedre proxy to ${res.viteConfigFile} targeting http://127.0.0.1:${effectivePort}${colors.reset}`);
           } else if (res.viteProxyStatus === "ALREADY_CONFIGURED") {
             console.log(`  \u2022 Vite Proxy: /esedre is already configured in ${res.viteConfigFile}`);
           } else if (res.viteProxyStatus === "SKIPPED") {
@@ -3271,7 +4059,7 @@ ${colors.bold}Recommendation:${colors.reset} To embed the dev planner within you
             console.log(colors.dim + (res.recommendedProxySnippet?.split("\n").map((l) => "    " + l).join("\n") || "") + colors.reset);
           } else if (res.viteProxyStatus === "NOT_APPLICABLE") {
             console.log(`
-${colors.bold}Recommendation:${colors.reset} If you wish to embed the dev planner within your project's UI, configure a reverse proxy for '/esedre' targeting http://127.0.0.1:${port}:`);
+${colors.bold}Recommendation:${colors.reset} If you wish to embed the dev planner within your project's UI, configure a reverse proxy for '/esedre' targeting http://127.0.0.1:${effectivePort}:`);
             console.log(colors.dim + (res.recommendedProxySnippet?.split("\n").map((l) => "    " + l).join("\n") || "") + colors.reset);
           } else if (res.viteProxyStatus === "MANUAL_REQUIRED") {
             console.log(`  \u2022 ${colors.yellow}Vite Proxy: Could not automatically inject proxy into ${res.viteConfigFile}.${colors.reset}`);
@@ -3281,11 +4069,11 @@ ${colors.bold}Recommendation:${colors.reset} Please manually add this proxy to y
           }
           console.log(`
 ${colors.bold}Next Steps:${colors.reset}`);
-          console.log(`  1. ${colors.bold}Start the background daemon:${colors.reset}`);
+          console.log(`  1. ${colors.bold}Start the background server:${colors.reset}`);
           console.log(`     ${colors.cyan}ese start${colors.reset}   (or: ${colors.dim}.esedre/ese start${colors.reset})`);
           console.log(`
   2. ${colors.bold}Open the visual Web UI:${colors.reset}`);
-          console.log(`     ${colors.cyan}http://localhost:${port}/app?project=${projectCode}${colors.reset}`);
+          console.log(`     ${colors.cyan}http://localhost:${effectivePort}/app?project=${projectCode}${colors.reset}`);
           if (res.viteProxyStatus === "CONFIGURED" || res.viteProxyStatus === "ALREADY_CONFIGURED") {
             console.log(`     ${colors.dim}Embedded via host dev server:${colors.reset} http://localhost:5173/esedre/app?project=${projectCode}`);
           }
@@ -3298,18 +4086,129 @@ ${colors.bold}Next Steps:${colors.reset}`);
         }
         return;
       }
+      case "configure": {
+        const subAction = positionals[0]?.toLowerCase();
+        if (subAction === "add") {
+          const targetPath = positionals[1] || ".";
+          const addRes = addLocationToGlobalConfig(targetPath);
+          if (isJson) {
+            console.log(JSON.stringify(addRes, null, 2));
+            return;
+          }
+          if (addRes.type === "hub") {
+            console.log(`${colors.bold}${colors.green}\u2714 Detected Esedre Data Hub (${addRes.projectCount || 0} projects)${colors.reset}`);
+            console.log(`  \u2022 Registered in ~/.esedre/config.json -> dataDir: ${addRes.path}`);
+          } else if (addRes.type === "project") {
+            console.log(`${colors.bold}${colors.green}\u2714 Detected Esedre project '${addRes.code}'${addRes.name ? ` (${addRes.name})` : ""}${colors.reset}`);
+            console.log(`  \u2022 Linked in ~/.esedre/config.json -> projects.${addRes.code}: ${addRes.path}`);
+          } else {
+            console.log(`${colors.yellow}\u26A0\uFE0F No Esedre project or data hub detected at "${addRes.path}"${colors.reset}`);
+            console.log(`\u{1F449} Run 'ese init ${targetPath}' to bring this repository online first.`);
+          }
+          return;
+        }
+        if (subAction === "remove" || subAction === "rm") {
+          const target = positionals[1];
+          if (!target) {
+            console.error(`${colors.red}Error: Project code or directory path required (e.g. ese configure remove ALCE)${colors.reset}`);
+            process.exit(1);
+          }
+          const rmRes = removeLocationFromGlobalConfig(target);
+          if (isJson) {
+            console.log(JSON.stringify(rmRes, null, 2));
+            return;
+          }
+          if (rmRes.removed) {
+            console.log(`${colors.green}\u2714 Removed ${rmRes.type || "entry"} "${rmRes.target || target}" from central configuration (~/.esedre/config.json)${colors.reset}`);
+          } else {
+            console.log(`${colors.yellow}\u25CB "${target}" not found in central configuration.${colors.reset}`);
+          }
+          return;
+        }
+        if (subAction === "set") {
+          const key = positionals[1];
+          const val = positionals[2];
+          if (!key || val === void 0) {
+            console.error(`${colors.red}Error: Key and value required (e.g. ese configure set port 5674)${colors.reset}`);
+            process.exit(1);
+          }
+          const parsedVal = /^\d+$/.test(val) ? parseInt(val, 10) : val;
+          const setRes = setGlobalConfigKey(key, parsedVal);
+          if (isJson) {
+            console.log(JSON.stringify(setRes, null, 2));
+            return;
+          }
+          console.log(`${colors.green}\u2714 Updated central configuration: ${key} = ${JSON.stringify(parsedVal)}${colors.reset}`);
+          return;
+        }
+        if (subAction === "get") {
+          const key = positionals[1];
+          const cfg = readGlobalConfig() || {};
+          const val = key ? getGlobalConfigKey(key) : cfg;
+          if (isJson) {
+            console.log(JSON.stringify({ key, value: val }, null, 2));
+          } else {
+            console.log(val !== void 0 ? typeof val === "object" ? JSON.stringify(val, null, 2) : String(val) : `${colors.dim}(not set)${colors.reset}`);
+          }
+          return;
+        }
+        const globalCfg = readGlobalConfig() || {};
+        const configPath = getGlobalConfigPath();
+        if (isJson) {
+          console.log(JSON.stringify({
+            configPath,
+            config: globalCfg
+          }, null, 2));
+          return;
+        }
+        console.log(`
+${colors.bold}${colors.cyan}Esedre Central Configuration${colors.reset}`);
+        console.log(`  \u2022 Config File:  ${configPath} ${fs9.existsSync(configPath) ? colors.green + "(active)" + colors.reset : colors.dim + "(default)" + colors.reset}`);
+        console.log(`  \u2022 Default Port: ${globalCfg.port || DEFAULT_ESEDRE_PORT}`);
+        console.log(`
+${colors.bold}Data Hubs (dataDir):${colors.reset}`);
+        if (globalCfg.dataDir) {
+          const hubs = Array.isArray(globalCfg.dataDir) ? globalCfg.dataDir : [globalCfg.dataDir];
+          for (const h of hubs) {
+            console.log(`  \u2022 ${colors.cyan}${h}${colors.reset}`);
+          }
+        } else {
+          console.log(`  ${colors.dim}(none configured: add with 'ese configure add <hubPath>')${colors.reset}`);
+        }
+        console.log(`
+${colors.bold}Linked Projects (projects):${colors.reset}`);
+        if (globalCfg.projects && Object.keys(globalCfg.projects).length > 0) {
+          for (const [code, p] of Object.entries(globalCfg.projects)) {
+            console.log(`  \u2022 ${colors.bold}${code}${colors.reset}: ${colors.cyan}${p}${colors.reset}`);
+          }
+        } else {
+          console.log(`  ${colors.dim}(none linked: link with 'ese configure add <projectPath>')${colors.reset}`);
+        }
+        console.log(`
+${colors.bold}Commands:${colors.reset}`);
+        console.log(`  \u2022 Link a hub or project:   ${colors.cyan}ese configure add <path>${colors.reset}`);
+        console.log(`  \u2022 Unlink a project or hub: ${colors.cyan}ese configure remove <code|path>${colors.reset}`);
+        console.log(`  \u2022 Set setting value:       ${colors.cyan}ese configure set <key> <value>${colors.reset}`);
+        console.log(`  \u2022 Bring new repo online:   ${colors.cyan}ese init [path]${colors.reset}`);
+        return;
+      }
       case "upgrade": {
-        const res = configureWorkspace(discovered.workspaceRoot, {
-          projectCode: discovered.config?.projectCode,
-          allowedProjects: discovered.config?.allowedProjects,
-          port: discovered.config?.port
+        const targetDir = positionals[0] ? path9.resolve(positionals[0]) : discovered.workspaceRoot;
+        const targetDiscovered = targetDir === discovered.workspaceRoot ? discovered : findEsedreConfig(targetDir, { fallbackToGlobal: true });
+        const isForce = Boolean(flags["force"] || flags["f"]);
+        const res = configureWorkspace(targetDir, {
+          projectCode: targetDiscovered.config?.projectCode,
+          allowedProjects: targetDiscovered.config?.allowedProjects,
+          port: targetDiscovered.config?.port,
+          force: isForce
         });
-        const projectCode = discovered.config?.projectCode;
+        const projectCode = targetDiscovered.config?.projectCode;
         if (!projectCode) {
           console.error(`${colors.red}Error: "projectCode" is required in esedre.json configuration (no default fallback).${colors.reset}`);
           process.exit(1);
         }
-        const snapshot = await generateProjectSnapshot(storage, projectCode, discovered.workspaceRoot);
+        const targetStorage = targetDir === discovered.workspaceRoot ? storage : new SecurityFilter(new FilesystemStorageAdapter(targetDir, targetDiscovered.config), targetDiscovered.config);
+        const snapshot = await generateProjectSnapshot(targetStorage, projectCode, targetDir);
         if (isJson) {
           console.log(JSON.stringify({ upgrade: res, snapshot: { totalTickets: snapshot.totalTickets } }, null, 2));
         } else {
@@ -3317,8 +4216,10 @@ ${colors.bold}Next Steps:${colors.reset}`);
           console.log(`  \u2022 Esedre Engine Version: ${CURRENT_ESEDRE_VERSION}`);
           console.log(`  \u2022 Wrappers updated in .esedre/`);
           console.log(`  \u2022 Refreshed .esedre/snapshot.json (${snapshot.totalTickets} tickets projected)`);
-          if (res.skillStatus === "CUSTOMIZED") {
-            console.log(`  \u2022 ${colors.yellow}Notice: .agents/skills/esedre/SKILL.md is customized; preserved user modifications.${colors.reset}`);
+          if (res.skillConfigured) {
+            console.log(`  \u2022 ${colors.green}Updated .agents/skills/esedre/SKILL.md to latest template${colors.reset}`);
+          } else if (res.skillStatus === "CUSTOMIZED") {
+            console.log(`  \u2022 ${colors.yellow}Notice: .agents/skills/esedre/SKILL.md is customized; preserved user modifications (use --force to overwrite).${colors.reset}`);
           }
         }
         return;
@@ -3346,7 +4247,32 @@ ${colors.bold}Next Steps:${colors.reset}`);
         return;
       }
       case "start": {
-        const port = flags["port"] ? parseInt(String(flags["port"]), 10) : discovered.config?.port || 5674;
+        const flagPort = flags["port"] ? parseInt(String(flags["port"]), 10) : void 0;
+        const ports = resolvePorts(discovered.config, { port: flagPort });
+        const port = ports.gateway;
+        const isForeground = Boolean(flags["foreground"] || flags["f"]);
+        if (isForeground) {
+          const cluster = startGatewayCluster({
+            gatewayPort: ports.gateway,
+            uiPort: ports.ui,
+            apiPort: ports.api,
+            storage,
+            workspaceRoot: discovered.workspaceRoot
+          });
+          console.log(`${colors.bold}${colors.green}\u2714 Esedre Server active on http://localhost:${ports.gateway}${colors.reset}`);
+          console.log(`  \u2022 Web UI:      http://localhost:${ports.gateway}/app (internal: ${ports.ui})`);
+          console.log(`  \u2022 REST API:    http://localhost:${ports.gateway}/api (internal: ${ports.api})`);
+          console.log(`  \u2022 Rewrite /:   http://localhost:${ports.gateway}/ -> http://localhost:${ports.gateway}/app/`);
+          console.log(`  \u2022 Portfolio:   http://localhost:${ports.gateway}/app?project=all`);
+          console.log(`  \u2022 Press Ctrl+C to stop.`);
+          process.on("SIGINT", async () => {
+            console.log(`
+${colors.dim}Shutting down Esedre cluster...${colors.reset}`);
+            await cluster.close();
+            process.exit(0);
+          });
+          return;
+        }
         const quiet = Boolean(flags["quiet"] || isJson);
         const state = await startDaemon({ port, quiet, workspaceRoot: discovered.workspaceRoot });
         if (isJson) {
@@ -3355,7 +4281,8 @@ ${colors.bold}Next Steps:${colors.reset}`);
         return;
       }
       case "stop": {
-        const port = flags["port"] ? parseInt(String(flags["port"]), 10) : discovered.config?.port || 5674;
+        const flagPort = flags["port"] ? parseInt(String(flags["port"]), 10) : void 0;
+        const port = resolvePorts(discovered.config, { port: flagPort }).gateway;
         const quiet = Boolean(flags["quiet"] || isJson);
         const stopped = await stopDaemon({ port, quiet, workspaceRoot: discovered.workspaceRoot });
         if (isJson) {
@@ -3364,7 +4291,8 @@ ${colors.bold}Next Steps:${colors.reset}`);
         return;
       }
       case "status": {
-        const port = flags["port"] ? parseInt(String(flags["port"]), 10) : discovered.config?.port || 5674;
+        const flagPort = flags["port"] ? parseInt(String(flags["port"]), 10) : void 0;
+        const port = resolvePorts(discovered.config, { port: flagPort }).gateway;
         const status = await getDaemonStatus({ port, workspaceRoot: discovered.workspaceRoot });
         if (isJson) {
           console.log(JSON.stringify(status, null, 2));
@@ -3373,13 +4301,19 @@ ${colors.bold}Next Steps:${colors.reset}`);
             console.log(`${colors.bold}${colors.green}\u25CF Esedre daemon is RUNNING${colors.reset}`);
             console.log(`  \u2022 Port:        ${status.port}`);
             if (status.pid) console.log(`  \u2022 PID:         ${status.pid}`);
+            if (status.version) console.log(`  \u2022 Version:     v${status.version}`);
             if (status.uptimeSeconds !== void 0) console.log(`  \u2022 Uptime:      ${status.uptimeSeconds}s`);
             if (status.startedAt) console.log(`  \u2022 Started:     ${status.startedAt}`);
             if (status.projects?.length) console.log(`  \u2022 Projects:    ${status.projects.join(", ")}`);
             if (status.logFile) console.log(`  \u2022 Logs:        ${status.logFile}`);
+            if (status.staleVersion) {
+              console.log(`
+${colors.yellow}\u26A0\uFE0F  Warning: Daemon is running v${status.version}, but v${status.installedVersion} is installed.${colors.reset}`);
+              console.log(`   Restart to apply updates: ${colors.cyan}ese stop && ese start${colors.reset}`);
+            }
           } else {
             console.log(`${colors.yellow}\u25CB Esedre daemon is STOPPED (port ${status.port})${colors.reset}`);
-            if (status.logFile && fs8.existsSync(status.logFile)) {
+            if (status.logFile && fs9.existsSync(status.logFile)) {
               console.log(`  \u2022 Recent Logs: ${status.logFile}`);
             }
           }
@@ -3387,80 +4321,12 @@ ${colors.bold}Next Steps:${colors.reset}`);
         return;
       }
       case "logs": {
-        const port = flags["port"] ? parseInt(String(flags["port"]), 10) : discovered.config?.port || 5674;
+        const flagPort = flags["port"] ? parseInt(String(flags["port"]), 10) : void 0;
+        const port = resolvePorts(discovered.config, { port: flagPort }).gateway;
         const lines = flags["lines"] ? parseInt(String(flags["lines"]), 10) : 40;
         printDaemonLogs({ port, lines, workspaceRoot: discovered.workspaceRoot });
         return;
       }
-      case "serve": {
-        const gatewayPort = flags["port"] ? parseInt(String(flags["port"]), 10) : discovered.config?.port || 5674;
-        const cluster = startGatewayCluster({
-          gatewayPort,
-          uiPort: gatewayPort + 1,
-          apiPort: gatewayPort + 2,
-          storage,
-          workspaceRoot: discovered.workspaceRoot
-        });
-        console.log(`${colors.bold}${colors.green}\u2714 Esedre Server active on http://localhost:${gatewayPort}${colors.reset}`);
-        console.log(`  \u2022 Web UI:      http://localhost:${gatewayPort}/app (internal: ${gatewayPort + 1})`);
-        console.log(`  \u2022 REST API:    http://localhost:${gatewayPort}/api (internal: ${gatewayPort + 2})`);
-        console.log(`  \u2022 Rewrite /:   http://localhost:${gatewayPort}/ -> http://localhost:${gatewayPort}/app/`);
-        console.log(`  \u2022 Portfolio:   http://localhost:${gatewayPort}/app?project=all`);
-        console.log(`  \u2022 Press Ctrl+C to stop.`);
-        process.on("SIGINT", async () => {
-          console.log(`
-${colors.dim}Shutting down Esedre cluster...${colors.reset}`);
-          await cluster.close();
-          process.exit(0);
-        });
-        return;
-      }
-      case "daemon": {
-        const sub = positionals[0] || "status";
-        const port = flags["port"] ? parseInt(String(flags["port"]), 10) : discovered.config?.port || 5674;
-        const quiet = Boolean(flags["quiet"] || isJson);
-        if (sub === "start") {
-          const state = await startDaemon({ port, quiet, workspaceRoot: discovered.workspaceRoot });
-          if (isJson) console.log(JSON.stringify(state, null, 2));
-          return;
-        } else if (sub === "stop") {
-          const stopped = await stopDaemon({ port, quiet, workspaceRoot: discovered.workspaceRoot });
-          if (isJson) console.log(JSON.stringify({ port, stopped }, null, 2));
-          return;
-        } else if (sub === "status") {
-          const status = await getDaemonStatus({ port, workspaceRoot: discovered.workspaceRoot });
-          if (isJson) {
-            console.log(JSON.stringify(status, null, 2));
-          } else {
-            if (status.running) {
-              console.log(`${colors.bold}${colors.green}\u25CF Esedre daemon is RUNNING${colors.reset}`);
-              console.log(`  \u2022 Port:        ${status.port}`);
-              if (status.pid) console.log(`  \u2022 PID:         ${status.pid}`);
-              if (status.uptimeSeconds !== void 0) console.log(`  \u2022 Uptime:      ${status.uptimeSeconds}s`);
-              if (status.startedAt) console.log(`  \u2022 Started:     ${status.startedAt}`);
-              if (status.projects?.length) console.log(`  \u2022 Projects:    ${status.projects.join(", ")}`);
-              if (status.logFile) console.log(`  \u2022 Logs:        ${status.logFile}`);
-            } else {
-              console.log(`${colors.yellow}\u25CB Esedre daemon is STOPPED (port ${status.port})${colors.reset}`);
-              if (status.logFile && fs8.existsSync(status.logFile)) {
-                console.log(`  \u2022 Recent Logs: ${status.logFile}`);
-              }
-            }
-          }
-          return;
-        } else if (sub === "logs") {
-          const logFile = path8.resolve(discovered.workspaceRoot || process.cwd(), ".esedre", "daemon.log");
-          if (fs8.existsSync(logFile)) {
-            console.log(fs8.readFileSync(logFile, "utf-8"));
-          } else {
-            console.log(`${colors.dim}No daemon log file found at ${logFile}${colors.reset}`);
-          }
-          return;
-        } else {
-          console.error(`${colors.red}Unknown daemon subcommand: '${sub}'. Expected 'start', 'stop', 'status', or 'logs'.${colors.reset}`);
-          process.exit(1);
-        }
-      }
       case "projects": {
         const projects = await storage.getProjects();
         if (isJson) {
@@ -3494,9 +4360,22 @@ ${colors.dim}Shutting down Esedre cluster...${colors.reset}`);
             sha1: t.sha1 || t.meta.sha1
           })), null, 2));
         } else {
-          console.log(formatTicketListTable(tickets));
-          console.log(`
+          if (tickets.length === 0) {
+            console.log(`${colors.dim}No tickets found matching criteria.${colors.reset}`);
+            const projects = await storage.getProjects();
+            if (discovered.config?.projectCode) {
+              console.log(`${colors.dim}Tip: Create your first ticket with 'ese create --title "..." --type Feature'.${colors.reset}`);
+            } else if (projects.length > 0) {
+              const codes = projects.map((p) => p.code).join(", ");
+              console.log(`${colors.dim}Tip: Create a ticket with 'ese create --title "..." --type Feature --project <${codes}>'.${colors.reset}`);
+            } else {
+              console.log(`${colors.dim}Tip: Run 'ese init' to initialize this repository.${colors.reset}`);
+            }
+          } else {
+            console.log(formatTicketListTable(tickets));
+            console.log(`
 ${colors.dim}Total: ${tickets.length} tickets${colors.reset}`);
+          }
         }
         return;
       }
@@ -3535,11 +4414,11 @@ ${colors.dim}Total: ${tickets.length} tickets${colors.reset}`);
         if (setPlan || filePath) {
           let content = setPlan;
           if (filePath) {
-            if (!fs8.existsSync(filePath)) {
+            if (!fs9.existsSync(filePath)) {
               console.error(`${colors.red}Error: Plan file "${filePath}" not found.${colors.reset}`);
               process.exit(1);
             }
-            content = fs8.readFileSync(filePath, "utf-8");
+            content = fs9.readFileSync(filePath, "utf-8");
           }
           await storage.savePlan(id, content, lastHash);
           console.log(`${colors.green}\u2714 Implementation plan saved for Ticket #${id}${colors.reset}`);
@@ -3568,10 +4447,11 @@ ${colors.dim}Total: ${tickets.length} tickets${colors.reset}`);
         const projectCode = flags["project"] || discovered.config?.projectCode;
         if (!projectCode) {
           console.error(`${colors.red}Error: Project is required to create a ticket (--project <code> or configure projectCode in esedre.json).${colors.reset}`);
+          console.error(`${colors.dim}Tip: Run 'ese init' to initialize this repository.${colors.reset}`);
           process.exit(1);
         }
         const complexity = flags["complexity"] || "Medium";
-        const estimatedEffort = flags["effort"] || "2.0 \u2013 4.0 hours";
+        const estimatedEffort = flags["effort"] || "2.0 - 4.0 hours";
         const summary = flags["summary"] || void 0;
         const submittedBy = flags["author"] || "Developer";
         const val = validateProjectCode(projectCode);
@@ -3599,14 +4479,11 @@ ${colors.dim}Total: ${tickets.length} tickets${colors.reset}`);
       case "update": {
         const idStr = positionals[0];
         if (!idStr) {
-          console.error(`${colors.red}Error: Ticket ID is required (e.g. ese update 96 --status "Completed")${colors.reset}`);
-          process.exit(1);
-        }
-        const id = parseInt(idStr, 10);
-        if (isNaN(id)) {
-          console.error(`${colors.red}Error: Invalid Ticket ID "${idStr}"${colors.reset}`);
+          console.error(`${colors.red}Error: Ticket ID is required (e.g. ese update 96 --status "Completed" or ese update Profe-96)${colors.reset}`);
           process.exit(1);
         }
+        const projectFlag = flags["project"];
+        const lookupKey = projectFlag && /^\d+$/.test(idStr) ? `${projectFlag}-${idStr}` : idStr;
         const status = flags["status"];
         const title = flags["title"];
         const complexity = flags["complexity"];
@@ -3627,36 +4504,34 @@ ${colors.dim}Total: ${tickets.length} tickets${colors.reset}`);
         if (effort) updates.estimatedEffort = effort;
         if (inDev !== void 0) updates.isActivePlanning = inDev;
         if (flag) updates.featureFlag = flag;
-        const updated = await storage.updateTicket(id, updates, lastHash);
+        const updated = await storage.updateTicket(lookupKey, updates, lastHash);
         if (isJson) {
           console.log(JSON.stringify(updated, null, 2));
         } else {
-          console.log(`${colors.green}\u2714 Updated Ticket #${id}: ${updated.meta.title} (Status: ${updated.meta.status}, SHA-1: ${updated.sha1?.slice(0, 8)})${colors.reset}`);
+          console.log(`${colors.green}\u2714 Updated Ticket #${lookupKey}: ${updated.meta.title} (Status: ${updated.meta.status}, SHA-1: ${updated.sha1?.slice(0, 8)})${colors.reset}`);
         }
         return;
       }
       case "comment": {
         const idStr = positionals[0];
         if (!idStr) {
-          console.error(`${colors.red}Error: Ticket ID is required (e.g. ese comment 96 --text "...")`);
-          process.exit(1);
-        }
-        const id = parseInt(idStr, 10);
-        if (isNaN(id)) {
-          console.error(`${colors.red}Error: Invalid Ticket ID "${idStr}"`);
+          console.error(`${colors.red}Error: Ticket ID is required (e.g. ese comment 96 --text "..." or ese comment Profe-96)${colors.reset}`);
           process.exit(1);
         }
-        const text = flags["text"];
+        const projectFlag = flags["project"];
+        const lookupKey = projectFlag && /^\d+$/.test(idStr) ? `${projectFlag}-${idStr}` : idStr;
+        const positionalText = positionals.slice(1).join(" ").trim();
+        const text = flags["text"] || (positionalText || void 0);
         if (!text) {
-          console.error(`${colors.red}Error: --text is required`);
+          console.error(`${colors.red}Error: Comment text is required (e.g. ese comment 96 "Verified tests" or --text "...")${colors.reset}`);
           process.exit(1);
         }
         const author = flags["author"] || "User";
-        const comment = await storage.addComment(id, { author, text });
+        const comment = await storage.addComment(lookupKey, { author, text });
         if (isJson) {
           console.log(JSON.stringify(comment, null, 2));
         } else {
-          console.log(`${colors.green}\u2714 Added comment to Ticket #${id} by ${comment.author}${colors.reset}`);
+          console.log(`${colors.green}\u2714 Added comment to Ticket #${lookupKey} by ${comment.author}${colors.reset}`);
         }
         return;
       }