trackops 1.1.0 → 2.0.0

package/bin/trackops.js

@@ -2,22 +2,39 @@
 
 const path = require("path");
 const config = require("../lib/config");
+const runtimeState = require("../lib/runtime-state");
+const { setLocale, t } = require("../lib/i18n");
 const pkg = require("../package.json");
-
-const command = process.argv[2];
-const args = process.argv.slice(3);
-
+
+const command = process.argv[2];
+const args = process.argv.slice(3);
+
+function initCliLocale() {
+  let projectLocale = null;
+  try {
+    const context = config.resolveWorkspaceContext();
+    if (context) {
+      projectLocale = config.getLocale(config.loadControl(context));
+    }
+  } catch (_error) {
+    projectLocale = null;
+  }
+  const doctor = runtimeState.doctorLocale(projectLocale);
+  setLocale(doctor.effectiveLocale);
+}
+
 function resolveRoot() {
   const context = config.resolveWorkspaceContext();
   if (!context) {
-    console.error("No TrackOps workspace found in this directory or any parent.");
+    console.error(t("cli.error.noWorkspace"));
     process.exit(1);
   }
   return context.workspaceRoot;
 }
-
-async function run() {
-  try {
+
+async function run() {
+  initCliLocale();
+  try {
     switch (command) {
       case "init":
         await require("../lib/init").cmdInit(args);
@@ -65,7 +82,7 @@ async function run() {
         const root = config.resolveProjectRoot() || process.cwd();
         if (sub === "status") workspace.cmdStatus(root);
         else if (sub === "migrate") workspace.cmdMigrate(root, args.slice(1));
-        else console.log("Usage: trackops workspace <status|migrate>");
+        else console.log(t("cli.usage.workspace"));
         break;
       }
 
@@ -75,7 +92,7 @@ async function run() {
         const root = config.resolveProjectRoot() || process.cwd();
         if (sub === "status") env.cmdStatus(root);
         else if (sub === "sync") env.cmdSync(root);
-        else console.log("Usage: trackops env <status|sync>");
+        else console.log(t("cli.usage.env"));
         break;
       }
 
@@ -83,18 +100,27 @@ async function run() {
         require("../lib/release").cmdRelease(config.resolveProjectRoot() || process.cwd(), args);
         break;
 
+      case "locale":
+        require("../lib/preferences").cmdLocale(args, config.resolveProjectRoot() || process.cwd());
+        break;
+
+      case "doctor":
+        require("../lib/preferences").cmdDoctor(args, config.resolveProjectRoot() || process.cwd());
+        break;
+
       case "opera": {
         const opera = require("../lib/opera");
         const sub = args[0];
-        const root = config.resolveProjectRoot() || process.cwd();
-        if (sub === "install") await opera.cmdInstall(root, args.slice(1));
-        else if (sub === "bootstrap") await opera.cmdBootstrap(root, args.slice(1));
-        else if (sub === "status") opera.cmdStatus(root);
-        else if (sub === "configure") opera.cmdConfigure(root, args.slice(1));
-        else if (sub === "upgrade") opera.cmdUpgrade(root);
-        else { console.log("Usage: trackops opera <install|bootstrap|status|configure|upgrade>"); }
-        break;
-      }
+        const root = config.resolveProjectRoot() || process.cwd();
+        if (sub === "install") await opera.cmdInstall(root, args.slice(1));
+        else if (sub === "bootstrap") await opera.cmdBootstrap(root, args.slice(1));
+        else if (sub === "handoff") opera.cmdHandoff(root, args.slice(1));
+        else if (sub === "status") opera.cmdStatus(root);
+        else if (sub === "configure") opera.cmdConfigure(root, args.slice(1));
+        else if (sub === "upgrade") opera.cmdUpgrade(root, args.slice(1));
+        else { console.log(t("cli.usage.opera")); }
+        break;
+      }
 
       case "skill": {
         const skills = require("../lib/skills");
@@ -104,7 +130,7 @@ async function run() {
         else if (sub === "list") skills.cmdList(root);
         else if (sub === "remove") skills.cmdRemove(root, args[1]);
         else if (sub === "catalog") skills.cmdCatalog();
-        else { console.log("Usage: trackops skill <install|list|remove|catalog> [name]"); }
+        else { console.log(t("cli.usage.skill")); }
         break;
       }
 
@@ -118,14 +144,14 @@ async function run() {
       case "--help":
       case "-h":
       case undefined:
-        require("../lib/control").cmdHelp();
-        break;
-
-      default:
-        console.error(`Unknown command: ${command}`);
-        console.error("Run 'trackops help' for usage.");
-        process.exit(1);
-    }
+        require("../lib/control").cmdHelp();
+        break;
+
+      default:
+        console.error(t("cli.error.unknownCommand", { command }));
+        console.error(t("cli.error.runHelp"));
+        process.exit(1);
+    }
   } catch (error) {
     console.error(error.message);
     process.exit(1);

package/lib/config.js

@@ -86,8 +86,15 @@ function createSplitContext(workspaceRoot, manifest = {}) {
       taskPlan: path.join(opsRoot, "task_plan.md"),
       progress: path.join(opsRoot, "progress.md"),
       findings: path.join(opsRoot, "findings.md"),
+      architectureDir: path.join(opsRoot, "architecture"),
       hooksDir: path.join(opsRoot, ".githooks"),
       tmpDir: path.join(opsRoot, ".tmp"),
+      bootstrapDir: path.join(opsRoot, "bootstrap"),
+      contractDir: path.join(opsRoot, "contract"),
+      contractFile: path.join(opsRoot, "contract", "operating-contract.json"),
+      policyDir: path.join(opsRoot, "policy"),
+      autonomyPolicyFile: path.join(opsRoot, "policy", "autonomy.json"),
+      reviewsDir: path.join(opsRoot, "reviews"),
       skillsDir: path.join(opsRoot, ".agents", "skills"),
       registryPath: path.join(opsRoot, ".agents", "skills", "_registry.md"),
       agentHubDir: path.join(opsRoot, ".agent", "hub"),
@@ -137,8 +144,15 @@ function createLegacyContext(rootDir) {
       taskPlan: path.join(root, "task_plan.md"),
       progress: path.join(root, "progress.md"),
       findings: path.join(root, "findings.md"),
+      architectureDir: path.join(root, "architecture"),
       hooksDir: path.join(root, ".githooks"),
       tmpDir: path.join(root, ".tmp"),
+      bootstrapDir: path.join(root, "bootstrap"),
+      contractDir: path.join(root, "contract"),
+      contractFile: path.join(root, "contract", "operating-contract.json"),
+      policyDir: path.join(root, "policy"),
+      autonomyPolicyFile: path.join(root, "policy", "autonomy.json"),
+      reviewsDir: path.join(root, "reviews"),
       skillsDir: path.join(root, ".agents", "skills"),
       registryPath: path.join(root, ".agents", "skills", "_registry.md"),
       agentHubDir: path.join(root, ".agent", "hub"),
@@ -255,14 +269,6 @@ function getOperaVersion(control) {
   return control.meta?.opera?.version || null;
 }
 
-function isEtapaInstalled(control) {
-  return isOperaInstalled(control);
-}
-
-function getEtapaVersion(control) {
-  return getOperaVersion(control);
-}
-
 function loadControl(contextOrRoot) {
   const filePath = controlFilePath(contextOrRoot);
   return JSON.parse(fs.readFileSync(filePath, "utf8"));
@@ -315,8 +321,6 @@ module.exports = {
   getLocale,
   isOperaInstalled,
   getOperaVersion,
-  isEtapaInstalled,
-  getEtapaVersion,
   loadControl,
   saveControl,
 };

package/lib/control.js

@@ -442,6 +442,12 @@ function cmdStatus(root) {
   }
   if (control.meta?.opera?.bootstrap?.status) {
     console.log(t("cli.status.bootstrap", { status: control.meta.opera.bootstrap.status, locale: config.getLocale(control) }));
+    if (control.meta.opera.bootstrap.mode) {
+      console.log(`Bootstrap mode: ${control.meta.opera.bootstrap.mode}`);
+    }
+    if (control.meta.opera.bootstrap.routeReason) {
+      console.log(`Bootstrap route: ${control.meta.opera.bootstrap.routeReason}`);
+    }
   }
   console.log(t("cli.status.tasks", {
     completed: state.totals.completed, inProgress: state.totals.inProgress,
@@ -541,51 +547,57 @@ function cmdInstallHooks(root) {
 }
 
 function cmdHelp() {
-  console.log("trackops — Operational project control");
+  console.log(`trackops — ${t("cli.help.title")}`);
   console.log("");
-  console.log("Usage: trackops <command> [args]");
+  console.log(`${t("cli.help.usage")} trackops <command> [args]`);
   console.log("");
-  console.log("Commands:");
+  console.log(t("cli.help.commands"));
   console.log("  init [--with-opera] [--legacy-layout] [--locale es|en] [--name \"...\"] [--no-bootstrap]");
-  console.log("    Legacy alias available: --with-etapa");
-  console.log("    Initialize trackops in the current directory.");
+  console.log("       [--bootstrap-mode auto|direct|handoff] [--technical-level low|medium|high|senior]");
+  console.log("       [--project-state idea|draft|existing_repo|advanced] [--docs-state none|notes|sos|spec_dossier|repo_docs]");
+  console.log("       [--decision-ownership user|shared|agent]");
+  console.log(`    ${t("cli.help.init.desc")}`);
   console.log("  workspace status|migrate");
-  console.log("    Show or migrate the current workspace layout.");
+  console.log(`    ${t("cli.help.workspace.desc")}`);
   console.log("  env status|sync");
-  console.log("    Audit or sync the workspace .env contract.");
+  console.log(`    ${t("cli.help.env.desc")}`);
   console.log("  release [--push]");
-  console.log("    Publish the configured app/ branch snapshot.");
+  console.log(`    ${t("cli.help.release.desc")}`);
   console.log("  version");
-  console.log("    Print the installed trackops version.");
+  console.log(`    ${t("cli.help.version.desc")}`);
   console.log("  status");
-  console.log("    Show project state: focus, active phase, ready tasks, blockers, repo.");
-  console.log("  next");
-  console.log("    Prioritized queue of next executable tasks.");
-  console.log("  sync");
-  console.log("    Regenerate task_plan.md, progress.md, findings.md from project_control.json.");
-  console.log("  dashboard [--port N] [--host HOST] [--public] [--strict-port]");
-  console.log("    Launch local web dashboard on a free port and print local/network URLs.");
+  console.log(`    ${t("cli.help.status.desc")}`);
+  console.log("  next");
+  console.log(`    ${t("cli.help.next.desc")}`);
+  console.log("  sync");
+  console.log(`    ${t("cli.help.sync.desc")}`);
+  console.log("  dashboard [--port N] [--host HOST] [--public] [--strict-port]");
+  console.log(`    ${t("cli.help.dashboard.desc")}`);
   console.log("  refresh-repo [--quiet]");
-  console.log("    Update the repo runtime snapshot with git state.");
+  console.log(`    ${t("cli.help.refreshRepo.desc")}`);
   console.log("  install-hooks");
-  console.log("    Configure git core.hooksPath to use the TrackOps hooks dir.");
-  console.log("  register");
-  console.log("    Register current project in the multi-project portfolio.");
-  console.log("  projects");
-  console.log("    List registered projects.");
-  console.log("  task <action> <id> [note]");
-  console.log("    Actions: start, review, complete, block, pending, cancel, note.");
-  console.log("  opera install|bootstrap|status|configure|upgrade");
-  console.log("    Manage OPERA methodology.");
+  console.log(`    ${t("cli.help.installHooks.desc")}`);
+  console.log("  register");
+  console.log(`    ${t("cli.help.register.desc")}`);
+  console.log("  projects");
+  console.log(`    ${t("cli.help.projects.desc")}`);
+  console.log("  task <action> <id> [note]");
+  console.log(`    ${t("cli.help.task.desc")}`);
+  console.log("  opera install|bootstrap|handoff|status|configure|upgrade");
+  console.log(`    ${t("cli.help.opera.desc")}`);
+  console.log(`    ${t("cli.help.opera.upgradeHint")}`);
+  console.log("  locale get|set [es|en]");
+  console.log(`    ${t("cli.help.locale.desc")}`);
+  console.log("  doctor locale");
+  console.log(`    ${t("cli.help.doctor.desc")}`);
   console.log("  skill install|list|remove|catalog <name>");
-  console.log("    Manage skills.");
+  console.log(`    ${t("cli.help.skill.desc")}`);
   console.log("  help");
-  console.log("    Show this help.");
+  console.log(`    ${t("cli.help.help.desc")}`);
   console.log("");
-  console.log("Global agent workflow:");
-  console.log("  Install with 'npx skills add Baxahaun/trackops --skill trackops --full-depth'");
-  console.log("  and the agent/global flags you need, then use 'trackops init' and");
-  console.log("  'trackops opera install' explicitly inside each project you want to manage.");
+  console.log(t("cli.help.globalWorkflow"));
+  console.log(`  ${t("cli.help.globalWorkflow.line1")}`);
+  console.log(`  ${t("cli.help.globalWorkflow.line2")}`);
 }
 
 /* ── project-scoped API (used by server) ── */

package/lib/env.js

@@ -59,8 +59,13 @@ function normalizeEnvironmentMeta(control, context) {
 function inferRequiredKeys(control, contextOrRoot) {
   const envMeta = control.meta?.environment || {};
   const fromMeta = unique([...(envMeta.requiredKeys || []), ...(envMeta.optionalKeys || [])]);
+  const contractServices = readContractServices(contextOrRoot, control);
+  const bootstrapServices = unique([
+    ...(control.meta?.opera?.bootstrap?.discovery?.externalServices || []),
+    ...(control.meta?.opera?.bootstrap?.externalServices || []),
+  ]);
   const fromServices = unique(
-    (control.meta?.opera?.bootstrap?.discovery?.externalServices || [])
+    (contractServices.length ? contractServices : bootstrapServices)
       .flatMap((service) => SERVICE_ENV_KEYS[service] || []),
   );
   const context = config.ensureContext(contextOrRoot || process.cwd());
@@ -68,6 +73,18 @@ function inferRequiredKeys(control, contextOrRoot) {
   return unique([...fromMeta, ...fromServices, ...fromExample]);
 }
 
+function readContractServices(contextOrRoot, control) {
+  const context = config.ensureContext(contextOrRoot || process.cwd());
+  const contractFile = context.paths.contractFile;
+  if (!fs.existsSync(contractFile)) return [];
+  try {
+    const contract = JSON.parse(fs.readFileSync(contractFile, "utf8"));
+    return Array.isArray(contract?.system?.externalServices) ? contract.system.externalServices : [];
+  } catch (_error) {
+    return [];
+  }
+}
+
 function ensureFileWithHeader(filePath, lines) {
   if (fs.existsSync(filePath)) return;
   fs.mkdirSync(path.dirname(filePath), { recursive: true });

package/lib/init.js

@@ -10,6 +10,7 @@ const env = require("./env");
 const workspace = require("./workspace");
 const { t, setLocale } = require("./i18n");
 const { detectSystemLocale, promptForLocale, resolveLocale } = require("./locale");
+const runtimeState = require("./runtime-state");
 
 const GENERATED_SCRIPT_COMMANDS = {
   ops: "npx --yes trackops",
@@ -33,13 +34,23 @@ function parseArgs(args) {
     phases: null,
     noBootstrap: false,
     legacyLayout: false,
+    bootstrapMode: "auto",
+    technicalLevel: null,
+    projectState: null,
+    docsState: null,
+    decisionOwnership: null,
   };
   for (let i = 0; i < args.length; i += 1) {
     if (args[i] === "--locale" && args[i + 1]) { options.locale = args[i + 1]; i += 1; }
     else if (args[i] === "--name" && args[i + 1]) { options.name = args[i + 1]; i += 1; }
-    else if (args[i] === "--with-opera" || args[i] === "--with-etapa") { options.withOpera = true; }
+    else if (args[i] === "--with-opera") { options.withOpera = true; }
     else if (args[i] === "--no-bootstrap") { options.noBootstrap = true; }
     else if (args[i] === "--legacy-layout") { options.legacyLayout = true; }
+    else if (args[i] === "--bootstrap-mode" && args[i + 1]) { options.bootstrapMode = args[i + 1]; i += 1; }
+    else if (args[i] === "--technical-level" && args[i + 1]) { options.technicalLevel = args[i + 1]; i += 1; }
+    else if (args[i] === "--project-state" && args[i + 1]) { options.projectState = args[i + 1]; i += 1; }
+    else if (args[i] === "--docs-state" && args[i + 1]) { options.docsState = args[i + 1]; i += 1; }
+    else if (args[i] === "--decision-ownership" && args[i + 1]) { options.decisionOwnership = args[i + 1]; i += 1; }
     else if (args[i] === "--phases" && args[i + 1]) {
       try { options.phases = JSON.parse(args[i + 1]); } catch (_e) { /* ignore */ }
       i += 1;
@@ -62,7 +73,7 @@ function detectProjectName(root) {
 }
 
 function buildDefaultControl(context, options) {
-  const locale = resolveLocale(options.locale, config.DEFAULT_LOCALE);
+  const locale = resolveLocale(options.locale, runtimeState.getGlobalLocale() || config.DEFAULT_LOCALE);
   const phases = options.phases || config.buildDefaultPhases(locale);
   const isSplit = context.layout === "split";
   setLocale(locale);
@@ -96,6 +107,16 @@ function buildDefaultControl(context, options) {
         optionalKeys: [],
         lastAuditAt: null,
       },
+      userProfile: {
+        technicalLevel: null,
+        explanationMode: null,
+        capturedAt: null,
+      },
+      discovery: {
+        projectState: null,
+        documentationState: null,
+        availableArtifacts: [],
+      },
     },
     checks: {
       lastBuild: { status: "pending", date: null, note: "" },
@@ -188,7 +209,7 @@ function initSplitProject(root, options) {
   workspace.ensureRootGitignore(targetRoot);
 
   const control = buildDefaultControl(context, options);
-  control.meta.projectName = options.name || detectProjectName(context.appRoot);
+  control.meta.projectName = options.name || detectProjectName(context.workspaceRoot);
   config.saveControl(context, control);
 
   installHooks(context);
@@ -261,7 +282,7 @@ function initLegacyProject(root, options) {
 
 function initProject(root, options) {
   const normalized = { ...(options || {}) };
-  normalized.locale = resolveLocale(normalized.locale, config.DEFAULT_LOCALE);
+  normalized.locale = resolveLocale(normalized.locale, runtimeState.getGlobalLocale() || config.DEFAULT_LOCALE);
   setLocale(normalized.locale);
   if (normalized.legacyLayout) {
     return initLegacyProject(root, normalized);
@@ -271,9 +292,17 @@ function initProject(root, options) {
 
 async function cmdInit(args) {
   const options = parseArgs(args || []);
-  options.locale = resolveLocale(options.locale, null);
-  if (!options.locale) {
+  const explicitLocale = resolveLocale(options.locale, null);
+  const globalLocale = runtimeState.getGlobalLocale();
+  if (explicitLocale) {
+    options.locale = explicitLocale;
+  } else if (!globalLocale) {
     options.locale = await promptForLocale(detectSystemLocale());
+  } else {
+    options.locale = globalLocale;
+  }
+  if (!globalLocale) {
+    await runtimeState.ensureGlobalLocale({ preferredLocale: options.locale, interactive: false });
   }
   setLocale(options.locale || config.DEFAULT_LOCALE);
 
@@ -284,6 +313,11 @@ async function cmdInit(args) {
     await opera.install(result.root, {
       locale: options.locale,
       bootstrap: !options.noBootstrap,
+      bootstrapMode: options.bootstrapMode,
+      technicalLevel: options.technicalLevel,
+      projectState: options.projectState,
+      docsState: options.docsState,
+      decisionOwnership: options.decisionOwnership,
     });
   }
 }