unforgit 0.3.2 → 0.4.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command29 } from "commander";
+import { Command as Command30 } from "commander";
 
 // src/commands/init.ts
 import fs2 from "fs";
@@ -3108,14 +3108,111 @@ Examples:
   }
 });
 
-// src/commands/doctor.ts
+// src/commands/dashboard.ts
+import { spawn as spawn2 } from "child_process";
+import fs5 from "fs";
+import path4 from "path";
+import { fileURLToPath } from "url";
 import { Command as Command26 } from "commander";
+function assertSafeDashboardBind(host, allowNetwork = false) {
+  if ((host === "0.0.0.0" || host === "::") && !allowNetwork) {
+    throw new Error(
+      `Refusing to bind dashboard to ${host} without --allow-network. Use a specific Tailscale/LAN IP when possible.`
+    );
+  }
+}
+function parseDashboardPort(port) {
+  const value = port === void 0 ? 3838 : Number(port);
+  if (!Number.isInteger(value) || value < 1 || value > 65535) {
+    throw new Error("--port must be between 1 and 65535");
+  }
+  return value;
+}
+function buildDashboardLaunchOptions(input) {
+  const host = input.host ?? "127.0.0.1";
+  assertSafeDashboardBind(host, input.allowNetwork ?? false);
+  const port = parseDashboardPort(input.port);
+  const workspace = path4.resolve(input.workspace ?? input.cwd);
+  return {
+    host,
+    port,
+    workspace,
+    url: `http://${host}:${port}`
+  };
+}
+function resolveDashboardAppDir(moduleUrl = import.meta.url) {
+  if (process.env.UNFORGIT_DASHBOARD_APP_DIR) {
+    return path4.resolve(process.env.UNFORGIT_DASHBOARD_APP_DIR);
+  }
+  const thisFile = fileURLToPath(moduleUrl);
+  const dir = path4.dirname(thisFile);
+  if (path4.basename(dir) === "dist") {
+    return path4.resolve(dir, "../../web");
+  }
+  return path4.resolve(dir, "../../../web");
+}
+var dashboardCommand = new Command26("dashboard").description("Start the local Unforgit memory dashboard").option("--host <host>", "Host/IP to bind (default: 127.0.0.1)").option("--port <port>", "Port to listen on (default: 3838)").option("--workspace <path>", "Workspace containing .unforgit/ (default: current directory)").option(
+  "--allow-network",
+  "Allow wildcard binds such as 0.0.0.0. Prefer a specific Tailscale/LAN IP instead."
+).addHelpText("after", `
+Examples:
+  unforgit dashboard
+  unforgit dashboard --port 4848
+  unforgit dashboard --workspace ~/.hermes/unforgit-memory --host 100.81.12.32`).action((opts) => {
+  let launch;
+  try {
+    launch = buildDashboardLaunchOptions({
+      cwd: process.cwd(),
+      host: opts.host,
+      port: opts.port,
+      workspace: opts.workspace,
+      allowNetwork: opts.allowNetwork
+    });
+  } catch (err) {
+    logger.error(err instanceof Error ? err.message : String(err));
+    process.exit(EXIT_ERROR);
+  }
+  const dashboardAppDir = resolveDashboardAppDir();
+  if (!fs5.existsSync(path4.join(dashboardAppDir, "package.json"))) {
+    logger.error(`Dashboard app not found at ${dashboardAppDir}.`);
+    logger.error("Set UNFORGIT_DASHBOARD_APP_DIR to the apps/web directory.");
+    process.exit(EXIT_ERROR);
+  }
+  logger.info(`Starting Unforgit dashboard: ${launch.url}`);
+  logger.info(`Workspace: ${launch.workspace}`);
+  if (launch.host !== "127.0.0.1" && launch.host !== "localhost") {
+    logger.warn("Dashboard is bound to a network address. Use only on trusted private networks such as Tailscale.");
+  }
+  const child = spawn2(
+    "pnpm",
+    ["exec", "next", "dev", "-p", String(launch.port), "-H", launch.host],
+    {
+      cwd: dashboardAppDir,
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        UNFORGIT_WORKSPACE: launch.workspace
+      }
+    }
+  );
+  child.on("error", (err) => {
+    logger.error(`Failed to start dashboard: ${err.message}`);
+    process.exit(EXIT_ERROR);
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) process.kill(process.pid, signal);
+    process.exit(code ?? 0);
+  });
+});
+
+// src/commands/doctor.ts
+import { Command as Command27 } from "commander";
 import { loadConfig as loadConfig22, getDbPath as getDbPath20, isInitialized as isInitialized16, getConfigPath as getConfigPath2 } from "unforgit-config";
 import { LocalStore as LocalStore19 } from "unforgit-db";
 import { RemoteClient as RemoteClient13 } from "unforgit-config";
-import fs5 from "fs";
+import fs6 from "fs";
 import YAML from "yaml";
-var doctorCommand = new Command26("doctor").description("Check system health and diagnose common issues").action(async () => {
+var doctorCommand = new Command27("doctor").description("Check system health and diagnose common issues").action(async () => {
   const results = [];
   if (!isInitialized16()) {
     results.push({
@@ -3149,7 +3246,7 @@ var doctorCommand = new Command26("doctor").description("Check system health and
     }
     if (process.platform !== "win32") {
       try {
-        const stat = fs5.statSync(configPath);
+        const stat = fs6.statSync(configPath);
         const mode = stat.mode & 511;
         if (mode & 36) {
           results.push({
@@ -3325,7 +3422,7 @@ function exitForResults(results) {
 }
 function findDeprecatedConfigKeys(configPath) {
   try {
-    const raw = fs5.readFileSync(configPath, "utf-8");
+    const raw = fs6.readFileSync(configPath, "utf-8");
     const parsed = YAML.parse(raw) ?? {};
     const deprecated = [];
     if (parsed.remote?.apiKey) {
@@ -3361,14 +3458,14 @@ function printResults(results) {
 }
 
 // src/commands/completion.ts
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 var BASH_COMPLETION = `
 _unforgit_completions() {
   local cur prev commands
   COMPREPLY=()
   cur="\${COMP_WORDS[COMP_CWORD]}"
   prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  commands="init add recall promote consolidate deprecate supersede delete restore web link unlink links merge remerge similar history auto-consolidate unconsolidate status push pull remote log diff keys auth config embeddings reset doctor curate completion"
+  commands="init add recall promote consolidate deprecate supersede delete restore web dashboard link unlink links merge remerge similar history auto-consolidate unconsolidate status push pull remote log diff keys auth config embeddings reset doctor curate completion"
 
   case "\${prev}" in
     unforgit)
@@ -3424,6 +3521,7 @@ _unforgit() {
     'delete:Soft delete a memory'
     'restore:Restore a soft-deleted memory'
     'web:Start the web dashboard'
+    'dashboard:Start the local memory dashboard'
     'link:Create a link between memories'
     'unlink:Remove a link between memories'
     'links:List links for a memory'
@@ -3479,6 +3577,7 @@ complete -c unforgit -n '__fish_use_subcommand' -a 'supersede' -d 'Supersede a m
 complete -c unforgit -n '__fish_use_subcommand' -a 'delete' -d 'Delete a memory'
 complete -c unforgit -n '__fish_use_subcommand' -a 'restore' -d 'Restore a memory'
 complete -c unforgit -n '__fish_use_subcommand' -a 'web' -d 'Start web dashboard'
+complete -c unforgit -n '__fish_use_subcommand' -a 'dashboard' -d 'Start local memory dashboard'
 complete -c unforgit -n '__fish_use_subcommand' -a 'link' -d 'Link two memories'
 complete -c unforgit -n '__fish_use_subcommand' -a 'unlink' -d 'Unlink memories'
 complete -c unforgit -n '__fish_use_subcommand' -a 'links' -d 'List links'
@@ -3506,7 +3605,7 @@ complete -c unforgit -l verbose -d 'Enable verbose output'
 complete -c unforgit -l quiet -d 'Suppress non-essential output'
 complete -c unforgit -l json -d 'Output as JSON'
 `.trim();
-var completionCommand = new Command27("completion").description("Generate shell completion scripts").argument("<shell>", "Shell type (bash, zsh, fish)").addHelpText("after", `
+var completionCommand = new Command28("completion").description("Generate shell completion scripts").argument("<shell>", "Shell type (bash, zsh, fish)").addHelpText("after", `
 Examples:
   unforgit completion bash >> ~/.bashrc
   unforgit completion zsh >> ~/.zshrc
@@ -3528,7 +3627,7 @@ Examples:
 });
 
 // src/commands/curate.ts
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 import { getDbPath as getDbPath21, isInitialized as isInitialized17, loadConfig as loadConfig23 } from "unforgit-config";
 import { LocalStore as LocalStore20 } from "unforgit-db";
 import { RemoteClient as RemoteClient14 } from "unforgit-config";
@@ -3545,7 +3644,7 @@ function formatCandidatePreview2(candidate) {
   }
   return lines.join("\n");
 }
-var curateCommand = new Command28("curate").description("Preview or run lifecycle maintenance for repository memories").option("--remote", "Run maintenance against the remote server").option("--execute", "Apply changes instead of previewing them").option("--model <model>", "OpenAI model to use for consolidation").option("--no-preserve", "Do not preserve original memories during consolidation").addHelpText("after", `
+var curateCommand = new Command29("curate").description("Preview or run lifecycle maintenance for repository memories").option("--remote", "Run maintenance against the remote server").option("--execute", "Apply changes instead of previewing them").option("--model <model>", "OpenAI model to use for consolidation").option("--no-preserve", "Do not preserve original memories during consolidation").addHelpText("after", `
 Examples:
   unforgit curate
   unforgit curate --execute
@@ -3679,7 +3778,7 @@ process.on("unhandledRejection", (err) => {
   runCleanup();
   process.exit(EXIT_ERROR);
 });
-var program = new Command29();
+var program = new Command30();
 program.name("unforgit").description("Unforgit \u2014 repository memory for agents and developers").version(pkg.version).option("--verbose", "Enable verbose output").option("--quiet", "Suppress non-essential output").option("--json", "Output results as JSON (for scripting)").hook("preAction", () => {
   const opts = program.opts();
   if (opts.quiet) setVerbosity(0);
@@ -3717,6 +3816,7 @@ program.addCommand(configCommand);
 program.addCommand(embeddingsCommand);
 program.addCommand(resetCommand);
 program.addCommand(backupsCommand);
+program.addCommand(dashboardCommand);
 program.addCommand(doctorCommand);
 program.addCommand(curateCommand);
 program.addCommand(completionCommand);