trackops 2.0.3 → 2.0.5

package/lib/preferences.js

@@ -1,74 +1,74 @@
-#!/usr/bin/env node
-
-const config = require("./config");
-const runtimeState = require("./runtime-state");
-const { setLocale, t } = require("./i18n");
-const { normalizeLocale } = require("./locale");
-
-function formatLocaleSource(source) {
-  return t(`locale.source.${String(source || "").trim()}`) || source || t("locale.none");
-}
-
-function resolveProjectLocale(root) {
-  const context = config.resolveWorkspaceContext(root || process.cwd());
-  if (!context) return null;
-  try {
-    return config.getLocale(config.loadControl(context));
-  } catch (_error) {
-    return null;
-  }
-}
-
-function cmdLocale(args = [], root) {
-  const sub = args[0];
-  const projectLocale = resolveProjectLocale(root);
-  const doctor = runtimeState.doctorLocale(projectLocale);
-  setLocale(doctor.effectiveLocale);
-
-  if (sub === "get" || !sub) {
-    console.log(`${t("locale.effective")}: ${doctor.effectiveLocale}`);
-    console.log(`${t("locale.source")}: ${formatLocaleSource(doctor.source)}`);
-    console.log(`${t("locale.global")}: ${doctor.globalLocale || t("locale.none")}`);
-    if (doctor.projectLocale) {
-      console.log(`${t("locale.project")}: ${doctor.projectLocale}`);
-    }
-    return;
-  }
-
-  if (sub === "set") {
-    const nextLocale = normalizeLocale(args[1]);
-    if (!nextLocale) {
-      throw new Error(t("locale.invalid", { value: String(args[1] || "") }));
-    }
-    runtimeState.writeRuntimeState({ locale: nextLocale, localeSource: "manual" });
-    setLocale(nextLocale);
-    console.log(t("locale.updated", { locale: nextLocale }));
-    return;
-  }
-
-  console.log(t("cli.usage.locale"));
-}
-
-function cmdDoctor(args = [], root) {
-  const sub = args[0];
-  if (sub !== "locale") {
-    console.log(t("cli.usage.doctor"));
-    return;
-  }
-
-  const projectLocale = resolveProjectLocale(root);
-  const doctor = runtimeState.doctorLocale(projectLocale);
-  setLocale(doctor.effectiveLocale);
-  console.log(`${t("locale.effective")}: ${doctor.effectiveLocale}`);
-  console.log(`${t("locale.source")}: ${formatLocaleSource(doctor.source)}`);
-  console.log(`${t("locale.global")}: ${doctor.globalLocale || t("locale.none")}`);
-  console.log(`${t("locale.project")}: ${doctor.projectLocale || t("locale.none")}`);
-  console.log(`${t("locale.env")}: ${doctor.envLocale || t("locale.none")}`);
-  console.log(`${t("locale.system")}: ${doctor.systemLocale}`);
-  console.log(`${t("locale.runtimeFile")}: ${doctor.runtimeFile}`);
-}
-
-module.exports = {
-  cmdLocale,
-  cmdDoctor,
-};
+#!/usr/bin/env node
+
+const config = require("./config");
+const runtimeState = require("./runtime-state");
+const { setLocale, t } = require("./i18n");
+const { normalizeLocale } = require("./locale");
+
+function formatLocaleSource(source) {
+  return t(`locale.source.${String(source || "").trim()}`) || source || t("locale.none");
+}
+
+function resolveProjectLocale(root) {
+  const context = config.resolveWorkspaceContext(root || process.cwd());
+  if (!context) return null;
+  try {
+    return config.getLocale(config.loadControl(context));
+  } catch (_error) {
+    return null;
+  }
+}
+
+function cmdLocale(args = [], root) {
+  const sub = args[0];
+  const projectLocale = resolveProjectLocale(root);
+  const doctor = runtimeState.doctorLocale(projectLocale);
+  setLocale(doctor.effectiveLocale);
+
+  if (sub === "get" || !sub) {
+    console.log(`${t("locale.effective")}: ${doctor.effectiveLocale}`);
+    console.log(`${t("locale.source")}: ${formatLocaleSource(doctor.source)}`);
+    console.log(`${t("locale.global")}: ${doctor.globalLocale || t("locale.none")}`);
+    if (doctor.projectLocale) {
+      console.log(`${t("locale.project")}: ${doctor.projectLocale}`);
+    }
+    return;
+  }
+
+  if (sub === "set") {
+    const nextLocale = normalizeLocale(args[1]);
+    if (!nextLocale) {
+      throw new Error(t("locale.invalid", { value: String(args[1] || "") }));
+    }
+    runtimeState.writeRuntimeState({ locale: nextLocale, localeSource: "manual" });
+    setLocale(nextLocale);
+    console.log(t("locale.updated", { locale: nextLocale }));
+    return;
+  }
+
+  console.log(t("cli.usage.locale"));
+}
+
+function cmdDoctor(args = [], root) {
+  const sub = args[0];
+  if (sub !== "locale") {
+    console.log(t("cli.usage.doctor"));
+    return;
+  }
+
+  const projectLocale = resolveProjectLocale(root);
+  const doctor = runtimeState.doctorLocale(projectLocale);
+  setLocale(doctor.effectiveLocale);
+  console.log(`${t("locale.effective")}: ${doctor.effectiveLocale}`);
+  console.log(`${t("locale.source")}: ${formatLocaleSource(doctor.source)}`);
+  console.log(`${t("locale.global")}: ${doctor.globalLocale || t("locale.none")}`);
+  console.log(`${t("locale.project")}: ${doctor.projectLocale || t("locale.none")}`);
+  console.log(`${t("locale.env")}: ${doctor.envLocale || t("locale.none")}`);
+  console.log(`${t("locale.system")}: ${doctor.systemLocale}`);
+  console.log(`${t("locale.runtimeFile")}: ${doctor.runtimeFile}`);
+}
+
+module.exports = {
+  cmdLocale,
+  cmdDoctor,
+};

package/lib/registry.js

@@ -1,196 +1,214 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-
-const config = require("./config");
-const { t } = require("./i18n");
-
-const REGISTRY_DIR = path.join(os.homedir(), ".codex", "trackops");
-const REGISTRY_FILE = path.join(REGISTRY_DIR, "registry.json");
-
-function nowIso() {
-  return new Date().toISOString();
-}
-
-function slugify(value) {
-  return String(value || "")
-    .normalize("NFD")
-    .replace(/[\u0300-\u036f]/g, "")
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "")
-    .slice(0, 48);
-}
-
-function shortHash(value) {
-  let hash = 0;
-  const input = String(value || "");
-  for (let index = 0; index < input.length; index += 1) {
-    hash = (hash * 31 + input.charCodeAt(index)) >>> 0;
-  }
-  return hash.toString(36).slice(0, 6);
-}
-
-function ensureRegistryDir() {
-  fs.mkdirSync(REGISTRY_DIR, { recursive: true });
-}
-
-function loadRegistry() {
-  ensureRegistryDir();
-  if (!fs.existsSync(REGISTRY_FILE)) {
-    return { version: 2, updatedAt: nowIso(), projects: [] };
-  }
-  const registry = JSON.parse(fs.readFileSync(REGISTRY_FILE, "utf8"));
-  if (!registry.version) registry.version = 1;
-  return registry;
-}
-
-function saveRegistry(registry) {
-  ensureRegistryDir();
-  registry.updatedAt = nowIso();
-  fs.writeFileSync(REGISTRY_FILE, `${JSON.stringify(registry, null, 2)}\n`, "utf8");
-}
-
-function isProjectInstalled(rootDir) {
-  const context = config.resolveWorkspaceContext(rootDir);
-  return Boolean(context && fs.existsSync(context.controlFile));
-}
-
-function inspectProject(rootDir) {
-  const context = config.resolveWorkspaceContext(rootDir) || config.createLegacyContext(rootDir);
-  const root = context.workspaceRoot;
-  const controlStateFile = context.controlFile;
-
-  if (!fs.existsSync(controlStateFile)) {
-    throw new Error(`Project '${root}' does not have trackops installed.`);
-  }
-
-  let packageJson = {};
-  const packageFile = context.packageFile;
-  if (fs.existsSync(packageFile)) {
-    packageJson = JSON.parse(fs.readFileSync(packageFile, "utf8"));
-  }
-
-  const controlState = JSON.parse(fs.readFileSync(controlStateFile, "utf8"));
-  const projectName =
-    controlState.meta?.projectName || packageJson.displayName || packageJson.name || path.basename(root);
-
-  return {
-    id: `${slugify(projectName) || "project"}-${shortHash(root)}`,
-    name: projectName,
-    root,
-    workspaceRoot: root,
-    appRoot: context.appRoot,
-    opsRoot: context.opsRoot,
-    layout: context.layout,
-    packageName: packageJson.name || null,
-    controlStateFile,
-    registeredAt: nowIso(),
-    lastSeenAt: nowIso(),
-  };
-}
-
-function registerProject(rootDir) {
-  const registry = loadRegistry();
-  const entry = inspectProject(rootDir);
-  const existingIndex = registry.projects.findIndex((p) => (p.workspaceRoot || p.root) === entry.workspaceRoot);
-
-  if (existingIndex >= 0) {
-    registry.projects[existingIndex] = {
-      ...registry.projects[existingIndex],
-      ...entry,
-      registeredAt: registry.projects[existingIndex].registeredAt || entry.registeredAt,
-      lastSeenAt: nowIso(),
-    };
-  } else {
-    registry.projects.push(entry);
-  }
-
-  registry.projects.sort((a, b) => a.name.localeCompare(b.name));
-  saveRegistry(registry);
-  return registry.projects.find((p) => (p.workspaceRoot || p.root) === entry.workspaceRoot);
-}
-
-function unregisterProject(rootDir) {
-  const context = config.resolveWorkspaceContext(rootDir) || config.createLegacyContext(rootDir);
-  const root = context.workspaceRoot;
-  const registry = loadRegistry();
-  registry.projects = registry.projects.filter((p) => (p.workspaceRoot || p.root) !== root);
-  saveRegistry(registry);
-  return registry;
-}
-
-function listProjects() {
-  const registry = loadRegistry();
-  return registry.projects.map((project) => {
-    const available = isProjectInstalled(project.root);
-    return { ...project, available };
-  });
-}
-
-function resolveProject(projectRef, fallbackRoot) {
-  const projects = listProjects();
-
-  if (!projectRef) {
-    if (fallbackRoot) {
-      const resolved = config.resolveWorkspaceContext(fallbackRoot);
-      const target = resolved ? resolved.workspaceRoot : path.resolve(fallbackRoot);
-      return projects.find((p) => (p.workspaceRoot || p.root) === target) || null;
-    }
-    return projects[0] || null;
-  }
-
-  const normalizedRef = path.resolve(projectRef);
-  return (
-    projects.find((p) => p.id === projectRef) ||
-    projects.find((p) => (p.workspaceRoot || p.root) === normalizedRef) ||
-    null
-  );
-}
-
-/* ── CLI commands ── */
-
-function cmdRegister(root) {
-  const project = registerProject(root);
-  console.log(`${t("init.registered")} ${project.name}`);
-  console.log(project.root);
-}
-
-function cmdList() {
-  const projects = listProjects();
-  if (!projects.length) {
-    console.log("No registered projects.");
-    return;
-  }
-  projects.forEach((project, index) => {
-    console.log(`${index + 1}. ${project.name}`);
-    console.log(`   id: ${project.id}`);
-    console.log(`   root: ${project.workspaceRoot || project.root}`);
-    console.log(`   app: ${project.appRoot}`);
-    console.log(`   ops: ${project.opsRoot}`);
-    console.log(`   available: ${project.available ? "yes" : "no"}`);
-  });
-}
-
-function cmdWhere() {
-  console.log(REGISTRY_FILE);
-}
-
-module.exports = {
-  REGISTRY_DIR,
-  REGISTRY_FILE,
-  inspectProject,
-  isProjectInstalled,
-  listProjects,
-  loadRegistry,
-  registerProject,
-  resolveProject,
-  saveRegistry,
-  slugify,
-  unregisterProject,
-  cmdRegister,
-  cmdList,
-  cmdWhere,
-};
+#!/usr/bin/env node
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const config = require("./config");
+const { t } = require("./i18n");
+
+const REGISTRY_DIR = path.join(os.homedir(), ".codex", "trackops");
+const REGISTRY_FILE = path.join(REGISTRY_DIR, "registry.json");
+
+function nowIso() {
+  return new Date().toISOString();
+}
+
+function slugify(value) {
+  return String(value || "")
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 48);
+}
+
+function shortHash(value) {
+  let hash = 0;
+  const input = String(value || "");
+  for (let index = 0; index < input.length; index += 1) {
+    hash = (hash * 31 + input.charCodeAt(index)) >>> 0;
+  }
+  return hash.toString(36).slice(0, 6);
+}
+
+function ensureRegistryDir() {
+  fs.mkdirSync(REGISTRY_DIR, { recursive: true });
+}
+
+function loadRegistry() {
+  ensureRegistryDir();
+  if (!fs.existsSync(REGISTRY_FILE)) {
+    return { version: 2, updatedAt: nowIso(), projects: [] };
+  }
+  const registry = JSON.parse(fs.readFileSync(REGISTRY_FILE, "utf8"));
+  if (!registry.version) registry.version = 1;
+  return registry;
+}
+
+function saveRegistry(registry) {
+  ensureRegistryDir();
+  registry.updatedAt = nowIso();
+  fs.writeFileSync(REGISTRY_FILE, `${JSON.stringify(registry, null, 2)}\n`, "utf8");
+}
+
+function isProjectInstalled(rootDir) {
+  const context = config.resolveWorkspaceContext(rootDir);
+  return Boolean(context && fs.existsSync(context.controlFile));
+}
+
+function inspectProject(rootDir) {
+  const context = config.resolveWorkspaceContext(rootDir) || config.createLegacyContext(rootDir);
+  const root = context.workspaceRoot;
+  const controlStateFile = context.controlFile;
+
+  if (!fs.existsSync(controlStateFile)) {
+    throw new Error(`Project '${root}' does not have trackops installed.`);
+  }
+
+  let packageJson = {};
+  const packageFile = context.packageFile;
+  if (fs.existsSync(packageFile)) {
+    packageJson = JSON.parse(fs.readFileSync(packageFile, "utf8"));
+  }
+
+  const controlState = JSON.parse(fs.readFileSync(controlStateFile, "utf8"));
+  const projectName =
+    controlState.meta?.projectName || packageJson.displayName || packageJson.name || path.basename(root);
+
+  return {
+    id: `${slugify(projectName) || "project"}-${shortHash(root)}`,
+    name: projectName,
+    root,
+    workspaceRoot: root,
+    appRoot: context.appRoot,
+    opsRoot: context.opsRoot,
+    layout: context.layout,
+    packageName: packageJson.name || null,
+    controlStateFile,
+    registeredAt: nowIso(),
+    lastSeenAt: nowIso(),
+  };
+}
+
+function registerProject(rootDir) {
+  const registry = loadRegistry();
+  const entry = inspectProject(rootDir);
+  const existingIndex = registry.projects.findIndex((p) => (p.workspaceRoot || p.root) === entry.workspaceRoot);
+
+  if (existingIndex >= 0) {
+    registry.projects[existingIndex] = {
+      ...registry.projects[existingIndex],
+      ...entry,
+      registeredAt: registry.projects[existingIndex].registeredAt || entry.registeredAt,
+      lastSeenAt: nowIso(),
+    };
+  } else {
+    registry.projects.push(entry);
+  }
+
+  registry.projects.sort((a, b) => a.name.localeCompare(b.name));
+  saveRegistry(registry);
+  return registry.projects.find((p) => (p.workspaceRoot || p.root) === entry.workspaceRoot);
+}
+
+function unregisterProject(rootDir) {
+  const context = config.resolveWorkspaceContext(rootDir) || config.createLegacyContext(rootDir);
+  const root = context.workspaceRoot;
+  const registry = loadRegistry();
+  registry.projects = registry.projects.filter((p) => (p.workspaceRoot || p.root) !== root);
+  saveRegistry(registry);
+  return registry;
+}
+
+function unregisterById(projectId) {
+  const registry = loadRegistry();
+  registry.projects = registry.projects.filter((p) => p.id !== projectId);
+  saveRegistry(registry);
+  return registry;
+}
+
+function purgeUnavailable() {
+  const registry = loadRegistry();
+  const before = registry.projects.length;
+  registry.projects = registry.projects.filter((p) => isProjectInstalled(p.workspaceRoot || p.root));
+  const removed = before - registry.projects.length;
+  saveRegistry(registry);
+  return { removed, registry };
+}
+
+function listProjects() {
+  const registry = loadRegistry();
+  return registry.projects.map((project) => {
+    const available = isProjectInstalled(project.root);
+    return { ...project, available };
+  });
+}
+
+function resolveProject(projectRef, fallbackRoot) {
+  const projects = listProjects();
+
+  if (!projectRef) {
+    if (fallbackRoot) {
+      const resolved = config.resolveWorkspaceContext(fallbackRoot);
+      const target = resolved ? resolved.workspaceRoot : path.resolve(fallbackRoot);
+      return projects.find((p) => (p.workspaceRoot || p.root) === target) || null;
+    }
+    return projects[0] || null;
+  }
+
+  const normalizedRef = path.resolve(projectRef);
+  return (
+    projects.find((p) => p.id === projectRef) ||
+    projects.find((p) => (p.workspaceRoot || p.root) === normalizedRef) ||
+    null
+  );
+}
+
+/* ── CLI commands ── */
+
+function cmdRegister(root) {
+  const project = registerProject(root);
+  console.log(`${t("init.registered")} ${project.name}`);
+  console.log(project.root);
+}
+
+function cmdList() {
+  const projects = listProjects();
+  if (!projects.length) {
+    console.log("No registered projects.");
+    return;
+  }
+  projects.forEach((project, index) => {
+    console.log(`${index + 1}. ${project.name}`);
+    console.log(`   id: ${project.id}`);
+    console.log(`   root: ${project.workspaceRoot || project.root}`);
+    console.log(`   app: ${project.appRoot}`);
+    console.log(`   ops: ${project.opsRoot}`);
+    console.log(`   available: ${project.available ? "yes" : "no"}`);
+  });
+}
+
+function cmdWhere() {
+  console.log(REGISTRY_FILE);
+}
+
+module.exports = {
+  REGISTRY_DIR,
+  REGISTRY_FILE,
+  inspectProject,
+  isProjectInstalled,
+  listProjects,
+  loadRegistry,
+  purgeUnavailable,
+  registerProject,
+  resolveProject,
+  saveRegistry,
+  slugify,
+  unregisterById,
+  unregisterProject,
+  cmdRegister,
+  cmdList,
+  cmdWhere,
+};

package/lib/release.js

@@ -1,56 +1,56 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require("child_process");
-const config = require("./config");
-
-function git(args, cwd) {
-  return spawnSync("git", args, { cwd, encoding: "utf8" });
-}
-
-function runGit(args, cwd, errorMessage) {
-  const result = git(args, cwd);
-  if (result.status !== 0) {
-    throw new Error(result.stderr || result.stdout || errorMessage);
-  }
-  return result.stdout.trim();
-}
-
-function parseArgs(args = []) {
-  return {
-    push: args.includes("--push"),
-  };
-}
-
-function cmdRelease(root, args = []) {
-  const context = config.ensureContext(root);
-  if (context.layout !== "split") {
-    throw new Error("trackops release requires a split workspace.");
-  }
-
-  const options = parseArgs(args);
-  const status = runGit(["status", "--porcelain"], context.workspaceRoot, "git status failed");
-  if (context.publish.requireCleanWorktree && status.trim()) {
-    throw new Error("trackops release requires a clean git worktree.");
-  }
-
-  const currentBranch = runGit(["branch", "--show-current"], context.workspaceRoot, "git branch failed");
-  if (currentBranch !== context.branches.development) {
-    throw new Error(`trackops release must run from '${context.branches.development}'.`);
-  }
-
-  const splitCommit = runGit(
-    ["subtree", "split", "--prefix", context.publish.sourceDir, context.branches.development],
-    context.workspaceRoot,
-    "git subtree split failed",
-  );
-
-  runGit(["branch", "-f", context.branches.publish, splitCommit], context.workspaceRoot, "git branch update failed");
-
-  if (options.push) {
-    runGit(["push", "origin", context.branches.publish, "--force-with-lease"], context.workspaceRoot, "git push failed");
-  }
-
-  console.log(`Release branch '${context.branches.publish}' updated from '${context.branches.development}'.`);
-}
-
-module.exports = { cmdRelease };
+#!/usr/bin/env node
+
+const { spawnSync } = require("child_process");
+const config = require("./config");
+
+function git(args, cwd) {
+  return spawnSync("git", args, { cwd, encoding: "utf8" });
+}
+
+function runGit(args, cwd, errorMessage) {
+  const result = git(args, cwd);
+  if (result.status !== 0) {
+    throw new Error(result.stderr || result.stdout || errorMessage);
+  }
+  return result.stdout.trim();
+}
+
+function parseArgs(args = []) {
+  return {
+    push: args.includes("--push"),
+  };
+}
+
+function cmdRelease(root, args = []) {
+  const context = config.ensureContext(root);
+  if (context.layout !== "split") {
+    throw new Error("trackops release requires a split workspace.");
+  }
+
+  const options = parseArgs(args);
+  const status = runGit(["status", "--porcelain"], context.workspaceRoot, "git status failed");
+  if (context.publish.requireCleanWorktree && status.trim()) {
+    throw new Error("trackops release requires a clean git worktree.");
+  }
+
+  const currentBranch = runGit(["branch", "--show-current"], context.workspaceRoot, "git branch failed");
+  if (currentBranch !== context.branches.development) {
+    throw new Error(`trackops release must run from '${context.branches.development}'.`);
+  }
+
+  const splitCommit = runGit(
+    ["subtree", "split", "--prefix", context.publish.sourceDir, context.branches.development],
+    context.workspaceRoot,
+    "git subtree split failed",
+  );
+
+  runGit(["branch", "-f", context.branches.publish, splitCommit], context.workspaceRoot, "git branch update failed");
+
+  if (options.push) {
+    runGit(["push", "origin", context.branches.publish, "--force-with-lease"], context.workspaceRoot, "git push failed");
+  }
+
+  console.log(`Release branch '${context.branches.publish}' updated from '${context.branches.development}'.`);
+}
+
+module.exports = { cmdRelease };