unforgit 0.3.2 → 0.5.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 Command31 } 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
@@ -3641,6 +3740,126 @@ async function runRemoteCurate(remoteUrl, options) {
   return client.runLifecycle(options);
 }
 
+// src/commands/suggestions.ts
+import { Command as Command30 } from "commander";
+import { getDbPath as getDbPath22, isInitialized as isInitialized18, loadConfig as loadConfig24 } from "unforgit-config";
+import { LocalStore as LocalStore21 } from "unforgit-db";
+import { generateSuggestions, persistReviewableSuggestions } from "unforgit-core";
+function openStore() {
+  if (!isInitialized18()) {
+    logger.error("Unforgit not initialized. Run 'unforgit init' first.");
+    process.exit(EXIT_CONFIG_ERROR);
+  }
+  const config = loadConfig24();
+  return {
+    config,
+    orgId: config.remote.orgId || "local",
+    repoId: config.remote.repoId || "local",
+    store: new LocalStore21(getDbPath22())
+  };
+}
+function formatSuggestionLine(suggestion) {
+  const memoryIds = suggestion.memoryIds.map((id) => id.slice(0, 8)).join(", ");
+  return [
+    `${suggestion.id.slice(0, 8)} [${suggestion.priority}] ${suggestion.type}`,
+    `  status: ${suggestion.status}`,
+    `  confidence: ${Math.round(suggestion.confidence * 100)}%`,
+    `  memories: ${memoryIds || "none"}`,
+    `  reason: ${suggestion.reason}`
+  ].join("\n");
+}
+function parseStatus(value) {
+  if (!value) return ["pending"];
+  const statuses = value.split(",").map((status) => status.trim()).filter(Boolean);
+  const allowed = /* @__PURE__ */ new Set(["pending", "approved", "rejected", "applied"]);
+  const invalid = statuses.find((status) => !allowed.has(status));
+  if (invalid) {
+    throw new Error(`Invalid suggestion status: ${invalid}`);
+  }
+  return statuses;
+}
+var suggestionsCommand = new Command30("suggestions").description("Reviewable curation suggestions inbox").addCommand(
+  new Command30("generate").description("Generate and persist pending review suggestions").option("--max <n>", "Maximum generated suggestions", (value) => Number.parseInt(value, 10), 20).option("--created-by <name>", "Actor name stored on generated suggestions", "cli").action((opts) => {
+    const { store, orgId, repoId } = openStore();
+    try {
+      const generated = generateSuggestions(store, orgId, repoId, {
+        maxSuggestions: opts.max
+      });
+      const persisted = persistReviewableSuggestions(
+        store,
+        orgId,
+        repoId,
+        generated.suggestions,
+        { createdBy: opts.createdBy }
+      );
+      const result = { ...generated.stats, ...persisted };
+      if (isJsonMode()) {
+        outputJson(result);
+        return;
+      }
+      logger.info(
+        `Generated ${generated.stats.suggestionsGenerated} suggestions; created ${persisted.created} pending review items; skipped ${persisted.skippedExisting} existing.`
+      );
+    } finally {
+      store.close();
+    }
+  })
+).addCommand(
+  new Command30("list").description("List curation suggestions by review status").option("--status <statuses>", "Comma-separated statuses (default: pending)").option("--limit <n>", "Maximum suggestions to show", (value) => Number.parseInt(value, 10), 20).action((opts) => {
+    const { store, orgId, repoId } = openStore();
+    try {
+      const status = parseStatus(opts.status);
+      const suggestions = store.listCurationSuggestions({
+        orgId,
+        repoId,
+        status,
+        limit: opts.limit
+      });
+      if (isJsonMode()) {
+        outputJson({ suggestions });
+        return;
+      }
+      const label = status?.join(",") ?? "all";
+      logger.info(`${label === "pending" ? "Pending" : label} curation suggestions`);
+      if (suggestions.length === 0) {
+        logger.info("No suggestions found.");
+        return;
+      }
+      for (const suggestion of suggestions) {
+        logger.info(formatSuggestionLine(suggestion));
+        logger.info("");
+      }
+    } finally {
+      store.close();
+    }
+  })
+).addCommand(
+  new Command30("review").description("Approve, reject, or mark a curation suggestion as applied").argument("<id>", "Suggestion id").option("--approve", "Mark suggestion as approved").option("--reject", "Mark suggestion as rejected").option("--applied", "Mark suggestion as applied").option("--reviewer <name>", "Reviewer name").option("--note <note>", "Review note").action((id, opts) => {
+    const selected = [opts.approve, opts.reject, opts.applied].filter(Boolean).length;
+    if (selected !== 1) {
+      logger.error("Choose exactly one of --approve, --reject, or --applied.");
+      process.exit(EXIT_ERROR);
+    }
+    const status = opts.approve ? "approved" : opts.reject ? "rejected" : "applied";
+    const { store } = openStore();
+    try {
+      const suggestion = store.reviewCurationSuggestion({
+        id,
+        status,
+        reviewedBy: opts.reviewer,
+        reviewNote: opts.note
+      });
+      if (isJsonMode()) {
+        outputJson(suggestion);
+        return;
+      }
+      logger.info(`Suggestion ${suggestion.id.slice(0, 8)} marked ${suggestion.status}.`);
+    } finally {
+      store.close();
+    }
+  })
+);
+
 // src/index.ts
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
@@ -3679,7 +3898,7 @@ process.on("unhandledRejection", (err) => {
   runCleanup();
   process.exit(EXIT_ERROR);
 });
-var program = new Command29();
+var program = new Command31();
 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,8 +3936,10 @@ program.addCommand(configCommand);
 program.addCommand(embeddingsCommand);
 program.addCommand(resetCommand);
 program.addCommand(backupsCommand);
+program.addCommand(dashboardCommand);
 program.addCommand(doctorCommand);
 program.addCommand(curateCommand);
+program.addCommand(suggestionsCommand);
 program.addCommand(completionCommand);
 program.parseAsync().catch((err) => {
   console.error(`fatal: ${err instanceof Error ? err.message : err}`);