@localctl/cli 0.2.0 → 0.3.0

package/src/lib/profileStore.js

@@ -1,134 +1,134 @@
-const fs = require('fs');
-const { HOME_STATE_DIR, PROFILES_PATH } = require('./paths');
-const { DEFAULT_CLUSTER_NAME, DEFAULT_HTTP_PORT, DEFAULT_HTTPS_PORT, REGISTRY_HOST_PORT } = require('./constants');
-
-// ~/.localctl/profiles.json is the single source of truth for every project this machine knows
-// about, and which one ad-hoc/global commands (doctor, hosts, addons) currently target.
-//
-// Two kinds of profile, distinguished by `isolation`:
-//   - "cluster" (a "Main project"): owns a real, separate k3d cluster/registry - `cluster`,
-//     `exclusive`, and (for a non-exclusive one, which needs its own ports since two clusters
-//     can't both bind host :80/:443) `httpPort`/`httpsPort`/`registryPort` all live here.
-//   - "namespace" (nested under exactly one Main project via `parent`): shares that Main
-//     project's cluster/registry/cert, isolated only by a namespace + subdomain prefix
-//     (`namespace`, defaulting to its own name).
-//
-// "default" always exists - it's today's single always-there cluster, `local-dev`.
-function defaultRegistry() {
-  return {
-    active: 'default',
-    profiles: {
-      default: { isolation: 'cluster', cluster: DEFAULT_CLUSTER_NAME, exclusive: true },
-    },
-  };
-}
-
-function ensureRegistry() {
-  if (!fs.existsSync(HOME_STATE_DIR)) fs.mkdirSync(HOME_STATE_DIR, { recursive: true });
-  if (!fs.existsSync(PROFILES_PATH)) save(defaultRegistry());
-}
-
-function load() {
-  ensureRegistry();
-  return JSON.parse(fs.readFileSync(PROFILES_PATH, 'utf8'));
-}
-
-function save(data) {
-  fs.writeFileSync(PROFILES_PATH, JSON.stringify(data, null, 2));
-}
-
-function getProfile(name) {
-  return load().profiles[name] || null;
-}
-
-function upsertProfile(name, def) {
-  const data = load();
-  data.profiles[name] = def;
-  save(data);
-}
-
-function listProfiles() {
-  return load().profiles;
-}
-
-function getActive() {
-  return load().active;
-}
-
-function setActive(name) {
-  const data = load();
-  if (!data.profiles[name]) throw new Error(`Unknown profile "${name}". Run "localctl profiles list".`);
-  data.active = name;
-  save(data);
-}
-
-// Climbs `parent` links up to the Main (isolation: "cluster") project that actually owns a
-// cluster - a namespace-level project's own entry never has one.
-function mainProjectFor(name) {
-  const { profiles } = load();
-  let cur = name;
-  const seen = new Set();
-  for (;;) {
-    if (seen.has(cur)) throw new Error(`Circular "parent" chain detected starting at profile "${cur}".`);
-    seen.add(cur);
-    const def = profiles[cur];
-    if (!def) {
-      throw new Error(`Unknown profile "${cur}". Run "localctl profiles list", or "localctl profiles new ${cur}" to create it.`);
-    }
-    if (def.isolation === 'cluster') return { name: cur, def };
-    cur = def.parent;
-  }
-}
-
-function clusterNameFor(name) {
-  return mainProjectFor(name).def.cluster;
-}
-
-function portsFor(name) {
-  const { def } = mainProjectFor(name);
-  return {
-    httpPort: def.httpPort || DEFAULT_HTTP_PORT,
-    httpsPort: def.httpsPort || DEFAULT_HTTPS_PORT,
-    registryPort: def.registryPort || REGISTRY_HOST_PORT,
-  };
-}
-
-// The namespace/subdomain prefix a namespace-level project's apps get scoped under - null for a
-// Main project itself (it owns the whole cluster, nothing to prefix).
-function namespaceScopeFor(name) {
-  const def = getProfile(name);
-  if (!def) throw new Error(`Unknown profile "${name}". Run "localctl profiles list".`);
-  if (def.isolation === 'cluster') return null;
-  return def.namespace || name;
-}
-
-// Every namespace-level project nested under a given Main project, for `profiles list`.
-function childrenOf(mainName) {
-  const { profiles } = load();
-  return Object.entries(profiles)
-    .filter(([, def]) => def.isolation === 'namespace' && def.parent === mainName)
-    .map(([name]) => name);
-}
-
-function removeProfile(name) {
-  const data = load();
-  delete data.profiles[name];
-  if (data.active === name) data.active = 'default';
-  save(data);
-}
-
-module.exports = {
-  load,
-  save,
-  getProfile,
-  upsertProfile,
-  removeProfile,
-  listProfiles,
-  getActive,
-  setActive,
-  mainProjectFor,
-  clusterNameFor,
-  portsFor,
-  namespaceScopeFor,
-  childrenOf,
-};
+const fs = require('fs');
+const { HOME_STATE_DIR, PROFILES_PATH } = require('./paths');
+const { DEFAULT_CLUSTER_NAME, DEFAULT_HTTP_PORT, DEFAULT_HTTPS_PORT, REGISTRY_HOST_PORT } = require('./constants');
+
+// ~/.localctl/profiles.json is the single source of truth for every project this machine knows
+// about, and which one ad-hoc/global commands (doctor, hosts, addons) currently target.
+//
+// Two kinds of profile, distinguished by `isolation`:
+//   - "cluster" (a "Main project"): owns a real, separate k3d cluster/registry - `cluster`,
+//     `exclusive`, and (for a non-exclusive one, which needs its own ports since two clusters
+//     can't both bind host :80/:443) `httpPort`/`httpsPort`/`registryPort` all live here.
+//   - "namespace" (nested under exactly one Main project via `parent`): shares that Main
+//     project's cluster/registry/cert, isolated only by a namespace + subdomain prefix
+//     (`namespace`, defaulting to its own name).
+//
+// "default" always exists - it's today's single always-there cluster, `local-dev`.
+function defaultRegistry() {
+  return {
+    active: 'default',
+    profiles: {
+      default: { isolation: 'cluster', cluster: DEFAULT_CLUSTER_NAME, exclusive: true },
+    },
+  };
+}
+
+function ensureRegistry() {
+  if (!fs.existsSync(HOME_STATE_DIR)) fs.mkdirSync(HOME_STATE_DIR, { recursive: true });
+  if (!fs.existsSync(PROFILES_PATH)) save(defaultRegistry());
+}
+
+function load() {
+  ensureRegistry();
+  return JSON.parse(fs.readFileSync(PROFILES_PATH, 'utf8'));
+}
+
+function save(data) {
+  fs.writeFileSync(PROFILES_PATH, JSON.stringify(data, null, 2));
+}
+
+function getProfile(name) {
+  return load().profiles[name] || null;
+}
+
+function upsertProfile(name, def) {
+  const data = load();
+  data.profiles[name] = def;
+  save(data);
+}
+
+function listProfiles() {
+  return load().profiles;
+}
+
+function getActive() {
+  return load().active;
+}
+
+function setActive(name) {
+  const data = load();
+  if (!data.profiles[name]) throw new Error(`Unknown profile "${name}". Run "localctl profiles list".`);
+  data.active = name;
+  save(data);
+}
+
+// Climbs `parent` links up to the Main (isolation: "cluster") project that actually owns a
+// cluster - a namespace-level project's own entry never has one.
+function mainProjectFor(name) {
+  const { profiles } = load();
+  let cur = name;
+  const seen = new Set();
+  for (;;) {
+    if (seen.has(cur)) throw new Error(`Circular "parent" chain detected starting at profile "${cur}".`);
+    seen.add(cur);
+    const def = profiles[cur];
+    if (!def) {
+      throw new Error(`Unknown profile "${cur}". Run "localctl profiles list", or "localctl profiles new ${cur}" to create it.`);
+    }
+    if (def.isolation === 'cluster') return { name: cur, def };
+    cur = def.parent;
+  }
+}
+
+function clusterNameFor(name) {
+  return mainProjectFor(name).def.cluster;
+}
+
+function portsFor(name) {
+  const { def } = mainProjectFor(name);
+  return {
+    httpPort: def.httpPort || DEFAULT_HTTP_PORT,
+    httpsPort: def.httpsPort || DEFAULT_HTTPS_PORT,
+    registryPort: def.registryPort || REGISTRY_HOST_PORT,
+  };
+}
+
+// The namespace/subdomain prefix a namespace-level project's apps get scoped under - null for a
+// Main project itself (it owns the whole cluster, nothing to prefix).
+function namespaceScopeFor(name) {
+  const def = getProfile(name);
+  if (!def) throw new Error(`Unknown profile "${name}". Run "localctl profiles list".`);
+  if (def.isolation === 'cluster') return null;
+  return def.namespace || name;
+}
+
+// Every namespace-level project nested under a given Main project, for `profiles list`.
+function childrenOf(mainName) {
+  const { profiles } = load();
+  return Object.entries(profiles)
+    .filter(([, def]) => def.isolation === 'namespace' && def.parent === mainName)
+    .map(([name]) => name);
+}
+
+function removeProfile(name) {
+  const data = load();
+  delete data.profiles[name];
+  if (data.active === name) data.active = 'default';
+  save(data);
+}
+
+module.exports = {
+  load,
+  save,
+  getProfile,
+  upsertProfile,
+  removeProfile,
+  listProfiles,
+  getActive,
+  setActive,
+  mainProjectFor,
+  clusterNameFor,
+  portsFor,
+  namespaceScopeFor,
+  childrenOf,
+};

package/src/lib/projectContext.js

@@ -1,32 +1,32 @@
-const fs = require('fs');
-const path = require('path');
-
-// Same lookup shape as git finding .git, or Claude finding .claude: walk up from a directory
-// looking for the nearest `.local/project.json`, at that directory or any ancestor. This lets a
-// single project.json at a parent folder govern every app subfolder underneath it, or a single
-// `.local` folder hold both the project.json and an app's own config.json together - whichever
-// layout a given repo uses.
-function findProjectFile(startDir) {
-  let dir = startDir;
-  for (;;) {
-    const candidate = path.join(dir, '.local', 'project.json');
-    if (fs.existsSync(candidate)) return candidate;
-    const parent = path.dirname(dir);
-    if (parent === dir) return null; // reached the filesystem root
-    dir = parent;
-  }
-}
-
-// Which profile governs `startDir` - the name from the nearest ancestor's project.json, or
-// "default" if none exists anywhere above it. This is independent of app config resolution
-// (CONFIG_PATH is always just cwd's own .local/config.json) - only the profile/cluster scope
-// walks up.
-function resolveProfileName(startDir = process.cwd()) {
-  const file = findProjectFile(startDir);
-  if (!file) return 'default';
-  const raw = JSON.parse(fs.readFileSync(file, 'utf8'));
-  if (!raw.profile) throw new Error(`${file} is missing a "profile" field.`);
-  return raw.profile;
-}
-
-module.exports = { findProjectFile, resolveProfileName };
+const fs = require('fs');
+const path = require('path');
+
+// Same lookup shape as git finding .git, or Claude finding .claude: walk up from a directory
+// looking for the nearest `.local/project.json`, at that directory or any ancestor. This lets a
+// single project.json at a parent folder govern every app subfolder underneath it, or a single
+// `.local` folder hold both the project.json and an app's own config.json together - whichever
+// layout a given repo uses.
+function findProjectFile(startDir) {
+  let dir = startDir;
+  for (;;) {
+    const candidate = path.join(dir, '.local', 'project.json');
+    if (fs.existsSync(candidate)) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) return null; // reached the filesystem root
+    dir = parent;
+  }
+}
+
+// Which profile governs `startDir` - the name from the nearest ancestor's project.json, or
+// "default" if none exists anywhere above it. This is independent of app config resolution
+// (CONFIG_PATH is always just cwd's own .local/config.json) - only the profile/cluster scope
+// walks up.
+function resolveProfileName(startDir = process.cwd()) {
+  const file = findProjectFile(startDir);
+  if (!file) return 'default';
+  const raw = JSON.parse(fs.readFileSync(file, 'utf8'));
+  if (!raw.profile) throw new Error(`${file} is missing a "profile" field.`);
+  return raw.profile;
+}
+
+module.exports = { findProjectFile, resolveProfileName };

package/src/lib/prompt.js

@@ -1,97 +1,97 @@
-const readline = require('readline');
-
-// Deliberately not using rl.question() in a loop: with piped (non-TTY) stdin, all lines can
-// arrive before a later rl.question() call attaches its listener, silently dropping answers.
-// Async-iterating the readline interface instead queues lines correctly either way.
-async function askAll(questions) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
-  const answers = [];
-  let idx = 0;
-  const prompt = (q) => process.stdout.write(`${q.text}${q.def ? ` (${q.def})` : ''}: `);
-
-  prompt(questions[0]);
-  for await (const line of rl) {
-    answers.push(line.trim() || questions[idx].def);
-    idx += 1;
-    if (idx >= questions.length) break;
-    prompt(questions[idx]);
-  }
-  rl.close();
-  return answers;
-}
-
-// Same underlying fix as askAll, but for a wizard whose later questions depend on an earlier
-// answer (so a fixed up-front question list won't do). Manually driving the readline interface's
-// async iterator - rather than attaching a fresh 'line' listener per question - is what actually
-// queues lines correctly under piped stdin; ad hoc listeners are what askAll's comment warns about.
-function makePrompter() {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
-  const iterator = rl[Symbol.asyncIterator]();
-
-  async function ask(text, def) {
-    process.stdout.write(`${text}${def ? ` (${def})` : ''}: `);
-    const { value, done } = await iterator.next();
-    if (done) return def || '';
-    return value.trim() || def || '';
-  }
-
-  return { ask, close: () => rl.close() };
-}
-
-// Same resolve-before-close ordering as the fix in the old uninstall.js confirm(): rl.close()
-// synchronously re-enters the 'close' handler below, which would resolve('') first and win the
-// race if this ran second. Shared now by `uninstall` and `app prune`.
-function confirm(question) {
-  return new Promise((resolve) => {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
-    process.stdout.write(question);
-    rl.on('line', (line) => {
-      resolve(line.trim());
-      rl.close();
-    });
-    rl.on('close', () => resolve(''));
-  });
-}
-
-// Reads one line without echoing it back - for secret values, so they don't land in your shell's
-// scrollback or a screen-share. Piped/non-TTY stdin (tests, CI) can't be hidden anyway, so it
-// just falls back to a plain read there instead of failing.
-function promptHidden(question) {
-  return new Promise((resolve) => {
-    if (!process.stdin.isTTY) {
-      const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
-      rl.on('line', (line) => {
-        resolve(line.trim());
-        rl.close();
-      });
-      rl.on('close', () => resolve(''));
-      process.stdout.write(`${question}: `);
-      return;
-    }
-
-    process.stdout.write(`${question}: `);
-    process.stdin.setRawMode(true);
-    process.stdin.resume();
-    process.stdin.setEncoding('utf8');
-    let value = '';
-    const onData = (char) => {
-      if (char === '\n' || char === '\r' || char === '') {
-        process.stdin.setRawMode(false);
-        process.stdin.pause();
-        process.stdin.removeListener('data', onData);
-        process.stdout.write('\n');
-        resolve(value);
-        return;
-      }
-      if (char === '') process.exit(130); // Ctrl-C
-      if (char === '' || char === '\b') {
-        value = value.slice(0, -1);
-        return;
-      }
-      value += char;
-    };
-    process.stdin.on('data', onData);
-  });
-}
-
-module.exports = { askAll, makePrompter, confirm, promptHidden };
+const readline = require('readline');
+
+// Deliberately not using rl.question() in a loop: with piped (non-TTY) stdin, all lines can
+// arrive before a later rl.question() call attaches its listener, silently dropping answers.
+// Async-iterating the readline interface instead queues lines correctly either way.
+async function askAll(questions) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+  const answers = [];
+  let idx = 0;
+  const prompt = (q) => process.stdout.write(`${q.text}${q.def ? ` (${q.def})` : ''}: `);
+
+  prompt(questions[0]);
+  for await (const line of rl) {
+    answers.push(line.trim() || questions[idx].def);
+    idx += 1;
+    if (idx >= questions.length) break;
+    prompt(questions[idx]);
+  }
+  rl.close();
+  return answers;
+}
+
+// Same underlying fix as askAll, but for a wizard whose later questions depend on an earlier
+// answer (so a fixed up-front question list won't do). Manually driving the readline interface's
+// async iterator - rather than attaching a fresh 'line' listener per question - is what actually
+// queues lines correctly under piped stdin; ad hoc listeners are what askAll's comment warns about.
+function makePrompter() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+  const iterator = rl[Symbol.asyncIterator]();
+
+  async function ask(text, def) {
+    process.stdout.write(`${text}${def ? ` (${def})` : ''}: `);
+    const { value, done } = await iterator.next();
+    if (done) return def || '';
+    return value.trim() || def || '';
+  }
+
+  return { ask, close: () => rl.close() };
+}
+
+// Same resolve-before-close ordering as the fix in the old uninstall.js confirm(): rl.close()
+// synchronously re-enters the 'close' handler below, which would resolve('') first and win the
+// race if this ran second. Shared now by `uninstall` and `app prune`.
+function confirm(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+    process.stdout.write(question);
+    rl.on('line', (line) => {
+      resolve(line.trim());
+      rl.close();
+    });
+    rl.on('close', () => resolve(''));
+  });
+}
+
+// Reads one line without echoing it back - for secret values, so they don't land in your shell's
+// scrollback or a screen-share. Piped/non-TTY stdin (tests, CI) can't be hidden anyway, so it
+// just falls back to a plain read there instead of failing.
+function promptHidden(question) {
+  return new Promise((resolve) => {
+    if (!process.stdin.isTTY) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+      rl.on('line', (line) => {
+        resolve(line.trim());
+        rl.close();
+      });
+      rl.on('close', () => resolve(''));
+      process.stdout.write(`${question}: `);
+      return;
+    }
+
+    process.stdout.write(`${question}: `);
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    let value = '';
+    const onData = (char) => {
+      if (char === '\n' || char === '\r' || char === '') {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.removeListener('data', onData);
+        process.stdout.write('\n');
+        resolve(value);
+        return;
+      }
+      if (char === '') process.exit(130); // Ctrl-C
+      if (char === '' || char === '\b') {
+        value = value.slice(0, -1);
+        return;
+      }
+      value += char;
+    };
+    process.stdin.on('data', onData);
+  });
+}
+
+module.exports = { askAll, makePrompter, confirm, promptHidden };

package/src/lib/toolInstall.js

@@ -1,30 +1,30 @@
-const { commandExists, run } = require('./exec');
-const logger = require('./logger');
-
-// macId: Homebrew formula name. winId: winget package id.
-function installIfMissing(bin, macId, winId) {
-  if (commandExists(bin)) {
-    logger.success(`${bin} already installed`);
-    return;
-  }
-  if (process.platform === 'darwin') {
-    if (!commandExists('brew')) {
-      throw new Error('Homebrew is required to install missing tools. Install from https://brew.sh and re-run.');
-    }
-    logger.step(`Installing ${macId} via brew...`);
-    run('brew', ['install', macId]);
-  } else if (process.platform === 'win32') {
-    if (!commandExists('winget')) {
-      throw new Error('winget is required to install missing tools (ships with modern Windows / App Installer).');
-    }
-    logger.step(`Installing ${bin} via winget...`);
-    run('winget', [
-      'install', '--id', winId, '-e', '--source', 'winget',
-      '--accept-package-agreements', '--accept-source-agreements',
-    ]);
-  } else {
-    throw new Error(`"${bin}" is missing and automatic install isn't supported on this platform. Install it manually.`);
-  }
-}
-
-module.exports = { installIfMissing };
+const { commandExists, run } = require('./exec');
+const logger = require('./logger');
+
+// macId: Homebrew formula name. winId: winget package id.
+function installIfMissing(bin, macId, winId) {
+  if (commandExists(bin)) {
+    logger.success(`${bin} already installed`);
+    return;
+  }
+  if (process.platform === 'darwin') {
+    if (!commandExists('brew')) {
+      throw new Error('Homebrew is required to install missing tools. Install from https://brew.sh and re-run.');
+    }
+    logger.step(`Installing ${macId} via brew...`);
+    run('brew', ['install', macId]);
+  } else if (process.platform === 'win32') {
+    if (!commandExists('winget')) {
+      throw new Error('winget is required to install missing tools (ships with modern Windows / App Installer).');
+    }
+    logger.step(`Installing ${bin} via winget...`);
+    run('winget', [
+      'install', '--id', winId, '-e', '--source', 'winget',
+      '--accept-package-agreements', '--accept-source-agreements',
+    ]);
+  } else {
+    throw new Error(`"${bin}" is missing and automatic install isn't supported on this platform. Install it manually.`);
+  }
+}
+
+module.exports = { installIfMissing };