iranti-control-plane 0.5.2 → 0.5.4

package/README.md

@@ -57,8 +57,8 @@ npm run migrate
 npm run dev
 ```
 
-Open http://localhost:5173 for the frontend dev server.
-
+Open http://localhost:5173 for the frontend dev server.
+
 ### Port model
 
 The control plane has two common local startup modes:
@@ -145,4 +145,4 @@ See `docs/specs/control-plane-api.md` for the full API spec and `docs/prd/contro
 For release and manual publish checks, see [`docs/guides/releasing.md`](docs/guides/releasing.md).
 
 If npm publish is run from GitHub Actions, the repo `NPM_TOKEN` secret must be an npm **Automation token**. A standard token that still requires OTP will fail with `EOTP`.
-
+

package/bin/iranti-cp.js

@@ -31,6 +31,9 @@ Usage:
   iranti-cp doctor [iranti doctor args...]
   iranti-cp upgrade [self]
   iranti-cp upgrade iranti [iranti upgrade args...]
+  iranti-cp config [get]
+  iranti-cp config set port <n>
+  iranti-cp config unset port
 
 Commands:
   open      Open an existing Control Plane if one is running, otherwise start it in the background.
@@ -41,9 +44,13 @@ Commands:
   version   Print the installed iranti-control-plane version.
   doctor    Proxy to "iranti doctor".
   upgrade   Upgrade iranti-control-plane itself, or proxy to "iranti upgrade" for core Iranti.
+  config    Read or write persistent Control Plane configuration.
+            get            Show current config.
+            set port <n>   Set the default startup port (1024–65535).
+            unset port     Clear the default port, reverting to the 3000–3010 auto-range.
 
 Options:
-  --port <n>  Prefer a specific Control Plane port for open/start/status.
+  --port <n>  Prefer a specific Control Plane port for open/start/status (one-time override).
   --json      Emit machine-readable output for status.
   -h, --help  Show this help.
 `);
@@ -86,6 +93,26 @@ function parseArgs(argv) {
   return { help, port, json, positionals };
 }
 
+function getUserConfigPath() {
+  return path.join(require('os').homedir(), '.iranti-runtime', 'iranti-cp-config.json');
+}
+
+function readUserConfig() {
+  try {
+    const raw = fs.readFileSync(getUserConfigPath(), 'utf8');
+    const parsed = JSON.parse(raw);
+    return typeof parsed === 'object' && parsed !== null ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+
+function writeUserConfig(config) {
+  const configPath = getUserConfigPath();
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}
+
 function preferredPorts(explicitPort) {
   const seen = new Set();
   const ordered = [];
@@ -100,11 +127,64 @@ function preferredPorts(explicitPort) {
 
   add(explicitPort);
   add(process.env.CONTROL_PLANE_PORT);
+  add(readUserConfig().defaultPort);
   for (let port = 3000; port <= 3010; port += 1) add(port);
   add(3002);
   return ordered;
 }
 
+async function handleConfig(subcommands) {
+  const sub = subcommands[0];
+
+  if (!sub || sub === 'get') {
+    const config = readUserConfig();
+    const portDisplay = config.defaultPort != null
+      ? String(config.defaultPort)
+      : '(not set — uses 3000–3010 auto-range)';
+    console.log(`defaultPort: ${portDisplay}`);
+    return 0;
+  }
+
+  if (sub === 'set') {
+    const key = subcommands[1];
+    const value = subcommands[2];
+    if (key === 'port') {
+      if (!value) {
+        console.error('iranti-cp config set port: missing port number');
+        return 1;
+      }
+      const parsed = Number.parseInt(value, 10);
+      if (!Number.isFinite(parsed) || parsed < 1024 || parsed > 65535) {
+        console.error(`iranti-cp config set port: "${value}" is not a valid port (1024–65535)`);
+        return 1;
+      }
+      const config = readUserConfig();
+      config.defaultPort = parsed;
+      writeUserConfig(config);
+      console.log(`Default port set to ${parsed}. Takes effect on next iranti-cp start.`);
+      return 0;
+    }
+    console.error(`iranti-cp config set: unknown key "${key !== undefined ? key : ''}". Supported: port`);
+    return 1;
+  }
+
+  if (sub === 'unset') {
+    const key = subcommands[1];
+    if (key === 'port') {
+      const config = readUserConfig();
+      delete config.defaultPort;
+      writeUserConfig(config);
+      console.log('Default port cleared. Will use 3000–3010 auto-range on next start.');
+      return 0;
+    }
+    console.error(`iranti-cp config unset: unknown key "${key !== undefined ? key : ''}". Supported: port`);
+    return 1;
+  }
+
+  console.error(`iranti-cp config: unknown subcommand "${sub}". Use get, set, or unset.`);
+  return 1;
+}
+
 async function fetchJson(url, timeoutMs = 1500) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -527,6 +607,8 @@ async function main() {
     exitCode = await runIrantiProxy(['doctor', ...rest]);
   } else if (command === 'upgrade') {
     exitCode = await handleUpgrade(rest[0] || 'self', rest.slice(1));
+  } else if (command === 'config') {
+    exitCode = await handleConfig(rest);
   } else {
     console.error(`iranti-cp: unknown command "${command}".`);
     printHelp();

package/dist/server/bundle.cjs

@@ -18410,7 +18410,7 @@ var require_view = __commonJS({
     var dirname10 = path3.dirname;
     var basename7 = path3.basename;
     var extname3 = path3.extname;
-    var join13 = path3.join;
+    var join14 = path3.join;
     var resolve10 = path3.resolve;
     module2.exports = View;
     function View(name, options) {
@@ -18458,12 +18458,12 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve11(dir, file2) {
       var ext = this.ext;
-      var path4 = join13(dir, file2);
+      var path4 = join14(dir, file2);
       var stat2 = tryStat(path4);
       if (stat2 && stat2.isFile()) {
         return path4;
       }
-      path4 = join13(dir, basename7(file2, ext), "index" + ext);
+      path4 = join14(dir, basename7(file2, ext), "index" + ext);
       stat2 = tryStat(path4);
       if (stat2 && stat2.isFile()) {
         return path4;
@@ -19096,7 +19096,7 @@ var require_send = __commonJS({
     var Stream = require("stream");
     var util2 = require("util");
     var extname3 = path3.extname;
-    var join13 = path3.join;
+    var join14 = path3.join;
     var normalize = path3.normalize;
     var resolve10 = path3.resolve;
     var sep = path3.sep;
@@ -19315,7 +19315,7 @@ var require_send = __commonJS({
           return res;
         }
         parts = path4.split(sep);
-        path4 = normalize(join13(root, path4));
+        path4 = normalize(join14(root, path4));
       } else {
         if (UP_PATH_REGEXP.test(path4)) {
           debug('malicious path "%s"', path4);
@@ -19450,7 +19450,7 @@ var require_send = __commonJS({
           if (err) return self.onStatError(err);
           return self.error(404);
         }
-        var p = join13(path4, self._index[i]);
+        var p = join14(path4, self._index[i]);
         debug('stat "%s"', p);
         fs2.stat(p, function(err2, stat2) {
           if (err2) return next(err2);
@@ -20589,7 +20589,7 @@ var require_application = __commonJS({
   "src/server/node_modules/express/lib/application.js"(exports2, module2) {
     "use strict";
     var finalhandler = require_finalhandler();
-    var Router33 = require_router();
+    var Router34 = require_router();
     var methods = require_methods();
     var middleware = require_init();
     var query2 = require_query();
@@ -20654,7 +20654,7 @@ var require_application = __commonJS({
     };
     app2.lazyrouter = function lazyrouter() {
       if (!this._router) {
-        this._router = new Router33({
+        this._router = new Router34({
           caseSensitive: this.enabled("case sensitive routing"),
           strict: this.enabled("strict routing")
         });
@@ -22518,7 +22518,7 @@ var require_express = __commonJS({
     var mixin = require_merge_descriptors();
     var proto = require_application();
     var Route = require_route();
-    var Router33 = require_router();
+    var Router34 = require_router();
     var req = require_request();
     var res = require_response();
     exports2 = module2.exports = createApplication;
@@ -22541,7 +22541,7 @@ var require_express = __commonJS({
     exports2.request = req;
     exports2.response = res;
     exports2.Route = Route;
-    exports2.Router = Router33;
+    exports2.Router = Router34;
     exports2.json = bodyParser.json;
     exports2.query = require_query();
     exports2.raw = bodyParser.raw;
@@ -28044,12 +28044,24 @@ function ancestorBindingCandidates(startDir) {
   }
   return candidates;
 }
+function discoverInstanceEnvCandidates(homeDir) {
+  const explicitName = (process.env["IRANTI_INSTANCE"] ?? process.env["IRANTI_INSTANCE_NAME"] ?? "").trim();
+  const instancesDir = resolvePortable(homeDir, ".iranti-runtime", "instances");
+  if (explicitName) {
+    return [resolvePortable(instancesDir, explicitName, ".env")];
+  }
+  try {
+    return (0, import_fs.readdirSync)(instancesDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => resolvePortable(instancesDir, entry.name, ".env"));
+  } catch {
+    return [resolvePortable(instancesDir, "local", ".env")];
+  }
+}
 function envFileCandidates(startDir, homeDir = (0, import_os.homedir)(), isSea = false, execPath = process.execPath) {
   return [
     ...isSea ? [resolvePortable(dirnamePortable(execPath), ".env.iranti")] : [],
     ...ancestorBindingCandidates(startDir),
     resolvePortable(homeDir, ".iranti-runtime", ".env.iranti"),
-    resolvePortable(homeDir, ".iranti-runtime", "instances", "local", ".env")
+    ...discoverInstanceEnvCandidates(homeDir)
   ];
 }
 function loadEnv() {
@@ -35370,11 +35382,11 @@ __export(runner_exports, {
 });
 function resolveMigrationPath(file2) {
   const candidates = [
-    (0, import_path19.resolve)(__dirname2, file2),
-    (0, import_path19.resolve)(__dirname2, "..", "..", "migrations", file2)
+    (0, import_path20.resolve)(__dirname2, file2),
+    (0, import_path20.resolve)(__dirname2, "..", "..", "migrations", file2)
   ];
   for (const candidate of candidates) {
-    if ((0, import_fs13.existsSync)(candidate)) return candidate;
+    if ((0, import_fs14.existsSync)(candidate)) return candidate;
   }
   return candidates[0];
 }
@@ -35388,7 +35400,7 @@ async function run() {
   ];
   try {
     for (const file2 of migrations) {
-      const sql = (0, import_fs13.readFileSync)(resolveMigrationPath(file2), "utf8");
+      const sql = (0, import_fs14.readFileSync)(resolveMigrationPath(file2), "utf8");
       console.log(`[migrate] Running ${file2}`);
       await migrationPool.query(sql);
       console.log(`[migrate] Done: ${file2}`);
@@ -35398,17 +35410,17 @@ async function run() {
     await migrationPool.end();
   }
 }
-var import_fs13, import_path19, import_url2, __dirname2;
+var import_fs14, import_path20, import_url2, __dirname2;
 var init_runner = __esm({
   "src/server/migrations/runner.ts"() {
     "use strict";
-    import_fs13 = require("fs");
-    import_path19 = require("path");
+    import_fs14 = require("fs");
+    import_path20 = require("path");
     import_url2 = require("url");
     init_esm();
     init_db();
-    __dirname2 = (0, import_path19.dirname)((0, import_url2.fileURLToPath)(__importmeta_url));
-    if (process.argv[1] && (0, import_path19.resolve)(process.argv[1]) === (0, import_url2.fileURLToPath)(__importmeta_url)) {
+    __dirname2 = (0, import_path20.dirname)((0, import_url2.fileURLToPath)(__importmeta_url));
+    if (process.argv[1] && (0, import_path20.resolve)(process.argv[1]) === (0, import_url2.fileURLToPath)(__importmeta_url)) {
       run().catch((err) => {
         console.error("[migrate] Failed:", err);
         process.exitCode = 1;
@@ -35762,16 +35774,16 @@ __export(index_exports, {
   VERSION: () => VERSION
 });
 module.exports = __toCommonJS(index_exports);
-var import_express33 = __toESM(require_express2(), 1);
+var import_express34 = __toESM(require_express2(), 1);
 var import_cors = __toESM(require_lib3(), 1);
 var import_net = __toESM(require("net"), 1);
-var import_path20 = require("path");
-var import_fs14 = require("fs");
+var import_path21 = require("path");
+var import_fs15 = require("fs");
 var import_url3 = require("url");
 var import_module = require("module");
 
 // src/server/routes/control-plane/index.ts
-var import_express32 = __toESM(require_express2(), 1);
+var import_express33 = __toESM(require_express2(), 1);
 
 // src/server/routes/control-plane/kb.ts
 var import_express = __toESM(require_express2(), 1);
@@ -55984,7 +55996,10 @@ init_db();
 var chatRouter = (0, import_express10.Router)();
 var inFlightControllers = /* @__PURE__ */ new Map();
 function getIrantiUrl() {
-  return (env["IRANTI_URL"] ?? process.env["IRANTI_URL"] ?? "http://localhost:3001").replace(/\/$/, "");
+  const explicit = env["IRANTI_URL"] ?? process.env["IRANTI_URL"] ?? "";
+  if (explicit.trim()) return explicit.trim().replace(/\/$/, "");
+  const port = env["IRANTI_PORT"] ?? process.env["IRANTI_PORT"] ?? "3001";
+  return `http://localhost:${port}`;
 }
 function getIrantiApiKey2() {
   return env["IRANTI_API_KEY"] ?? process.env["IRANTI_API_KEY"] ?? "";
@@ -56479,7 +56494,10 @@ var import_express12 = __toESM(require_express2(), 1);
 init_db();
 var agentsRouter = (0, import_express12.Router)();
 function getIrantiUrl2() {
-  return (env["IRANTI_URL"] ?? process.env["IRANTI_URL"] ?? "http://localhost:3001").replace(/\/$/, "");
+  const explicit = env["IRANTI_URL"] ?? process.env["IRANTI_URL"] ?? "";
+  if (explicit.trim()) return explicit.trim().replace(/\/$/, "");
+  const port = env["IRANTI_PORT"] ?? process.env["IRANTI_PORT"] ?? "3001";
+  return `http://localhost:${port}`;
 }
 function getIrantiApiKey3() {
   return env["IRANTI_API_KEY"] ?? process.env["IRANTI_API_KEY"] ?? "";
@@ -57785,7 +57803,10 @@ async function fetchOverviewAgentDetails(baseUrl, headers, agentId) {
   }
 }
 function getIrantiUrl4() {
-  return (env["IRANTI_URL"] ?? process.env["IRANTI_URL"] ?? "http://localhost:3001").replace(/\/$/, "");
+  const explicit = env["IRANTI_URL"] ?? process.env["IRANTI_URL"] ?? "";
+  if (explicit.trim()) return explicit.trim().replace(/\/$/, "");
+  const port = env["IRANTI_PORT"] ?? process.env["IRANTI_PORT"] ?? "3001";
+  return `http://localhost:${port}`;
 }
 function getIrantiApiKey5() {
   return env["IRANTI_API_KEY"] ?? process.env["IRANTI_API_KEY"] ?? "";
@@ -57883,7 +57904,10 @@ var import_express17 = __toESM(require_express2(), 1);
 init_db();
 var sessionsRouter = (0, import_express17.Router)();
 function getIrantiUrl5() {
-  return (env["IRANTI_URL"] ?? process.env["IRANTI_URL"] ?? "http://localhost:3001").replace(/\/$/, "");
+  const explicit = env["IRANTI_URL"] ?? process.env["IRANTI_URL"] ?? "";
+  if (explicit.trim()) return explicit.trim().replace(/\/$/, "");
+  const port = env["IRANTI_PORT"] ?? process.env["IRANTI_PORT"] ?? "3001";
+  return `http://localhost:${port}`;
 }
 function getIrantiApiKey6() {
   return env["IRANTI_API_KEY"] ?? process.env["IRANTI_API_KEY"] ?? "";
@@ -62183,8 +62207,54 @@ sessionLedgerRouter.use((err, _req, res, _next) => {
   });
 });
 
+// src/server/routes/control-plane/cp-config.ts
+var import_express32 = __toESM(require_express2(), 1);
+var import_os6 = require("os");
+var import_fs13 = require("fs");
+var import_path19 = require("path");
+var cpConfigRouter = (0, import_express32.Router)();
+function getConfigPath() {
+  return (0, import_path19.join)((0, import_os6.homedir)(), ".iranti-runtime", "iranti-cp-config.json");
+}
+function readConfig() {
+  try {
+    const raw = (0, import_fs13.readFileSync)(getConfigPath(), "utf8");
+    const parsed = JSON.parse(raw);
+    return typeof parsed === "object" && parsed !== null ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function writeConfig(config2) {
+  (0, import_fs13.mkdirSync)((0, import_path19.join)((0, import_os6.homedir)(), ".iranti-runtime"), { recursive: true });
+  (0, import_fs13.writeFileSync)(getConfigPath(), JSON.stringify(config2, null, 2) + "\n", "utf8");
+}
+cpConfigRouter.get("/cp-config", (_req, res) => {
+  const config2 = readConfig();
+  res.json({ defaultPort: config2.defaultPort ?? null });
+});
+cpConfigRouter.patch("/cp-config", (req, res) => {
+  const { defaultPort } = req.body;
+  if (defaultPort === null || defaultPort === void 0) {
+    const config3 = readConfig();
+    delete config3.defaultPort;
+    writeConfig(config3);
+    res.json({ ok: true, defaultPort: null });
+    return;
+  }
+  const parsed = Number.parseInt(String(defaultPort), 10);
+  if (!Number.isFinite(parsed) || parsed < 1024 || parsed > 65535) {
+    res.status(400).json({ error: `Invalid port: "${defaultPort}". Must be 1024\u201365535.` });
+    return;
+  }
+  const config2 = readConfig();
+  config2.defaultPort = parsed;
+  writeConfig(config2);
+  res.json({ ok: true, defaultPort: parsed });
+});
+
 // src/server/routes/control-plane/index.ts
-var controlPlaneRouter = (0, import_express32.Router)();
+var controlPlaneRouter = (0, import_express33.Router)();
 controlPlaneRouter.use("/", archivistRouter);
 controlPlaneRouter.use("/", kbRouter);
 controlPlaneRouter.use("/", whoknowsRouter);
@@ -62217,6 +62287,7 @@ controlPlaneRouter.use("/auth-keys", authKeysRouter);
 controlPlaneRouter.use("/", instanceLifecycleRouter);
 controlPlaneRouter.use("/integrations", codexIntegrationRouter);
 controlPlaneRouter.use("/debug", attendantDebugRouter);
+controlPlaneRouter.use("/", cpConfigRouter);
 
 // src/server/lib/staff-event-adapter.ts
 init_db();
@@ -62619,18 +62690,18 @@ function buildPortSelectionPlan(params) {
 
 // src/server/index.ts
 var _isSea = typeof process.isSea === "function" && process.isSea();
-var __dirname3 = _isSea ? (0, import_path20.dirname)(process.execPath) : (0, import_path20.dirname)((0, import_url3.fileURLToPath)(__importmeta_url));
-var clientDistCandidates = process.env.IRANTI_CP_ASSETS_DIR ? [(0, import_path20.resolve)(process.env.IRANTI_CP_ASSETS_DIR)] : _isSea ? [(0, import_path20.resolve)((0, import_path20.dirname)(process.execPath), "public", "control-plane")] : [
-  (0, import_path20.resolve)(__dirname3, "../../../public/control-plane"),
-  (0, import_path20.resolve)(__dirname3, "../../public/control-plane"),
-  (0, import_path20.resolve)(process.cwd(), "../../public/control-plane"),
-  (0, import_path20.resolve)(process.cwd(), "../public/control-plane")
+var __dirname3 = _isSea ? (0, import_path21.dirname)(process.execPath) : (0, import_path21.dirname)((0, import_url3.fileURLToPath)(__importmeta_url));
+var clientDistCandidates = process.env.IRANTI_CP_ASSETS_DIR ? [(0, import_path21.resolve)(process.env.IRANTI_CP_ASSETS_DIR)] : _isSea ? [(0, import_path21.resolve)((0, import_path21.dirname)(process.execPath), "public", "control-plane")] : [
+  (0, import_path21.resolve)(__dirname3, "../../../public/control-plane"),
+  (0, import_path21.resolve)(__dirname3, "../../public/control-plane"),
+  (0, import_path21.resolve)(process.cwd(), "../../public/control-plane"),
+  (0, import_path21.resolve)(process.cwd(), "../public/control-plane")
 ];
-var clientDist = clientDistCandidates.find((candidate) => (0, import_fs14.existsSync)((0, import_path20.resolve)(candidate, "index.html"))) ?? clientDistCandidates[0];
+var clientDist = clientDistCandidates.find((candidate) => (0, import_fs15.existsSync)((0, import_path21.resolve)(candidate, "index.html"))) ?? clientDistCandidates[0];
 var _version = "0.0.0";
 try {
   if (_isSea) {
-    const pkgPath = (0, import_path20.resolve)((0, import_path20.dirname)(process.execPath), "package.json");
+    const pkgPath = (0, import_path21.resolve)((0, import_path21.dirname)(process.execPath), "package.json");
     const _require = (0, import_module.createRequire)((0, import_url3.pathToFileURL)(process.execPath).href);
     const pkg = _require(pkgPath);
     _version = pkg.version ?? "0.0.0";
@@ -62673,9 +62744,9 @@ async function findAvailablePort(start, end) {
     `[iranti-cp] No available port in range ${start}\u2013${end}. Free one of those ports and try again.`
   );
 }
-var app = (0, import_express33.default)();
+var app = (0, import_express34.default)();
 app.use((0, import_cors.default)({ origin: `http://localhost:5173` }));
-app.use(import_express33.default.json());
+app.use(import_express34.default.json());
 app.get("/api/control-plane/ping", (_req, res) => {
   res.json({
     ok: true,
@@ -62684,9 +62755,9 @@ app.get("/api/control-plane/ping", (_req, res) => {
   });
 });
 app.use("/api/control-plane", controlPlaneRouter);
-app.use("/control-plane", import_express33.default.static(clientDist));
+app.use("/control-plane", import_express34.default.static(clientDist));
 app.get("/control-plane/*", (_req, res) => {
-  res.sendFile((0, import_path20.resolve)(clientDist, "index.html"));
+  res.sendFile((0, import_path21.resolve)(clientDist, "index.html"));
 });
 app.get("/", (_req, res) => res.redirect("/control-plane"));
 app.use(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iranti-control-plane",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Operator control plane for Iranti - local-first agent memory management",
   "bin": {
     "iranti-cp": "bin/iranti-cp.js"