@stackmemoryai/stackmemory 1.10.2 → 1.10.4

package/dist/src/cli/commands/wiki.js

@@ -0,0 +1,265 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { Command } from "commander";
+import chalk from "chalk";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import {
+  WikiCompiler
+} from "../../core/wiki/wiki-compiler.js";
+import {
+  generateChronologicalDigest
+} from "../../core/digest/chronological-digest.js";
+function resolveWikiDir() {
+  const configPath = join(process.cwd(), ".stackmemory", "config.yaml");
+  if (!existsSync(configPath)) return null;
+  const content = readFileSync(configPath, "utf-8");
+  const vaultMatch = content.match(
+    /obsidian:\s*\n\s+vaultPath:\s*["']?([^\n"']+)/
+  );
+  if (!vaultMatch) return null;
+  const vaultPath = (vaultMatch[1] ?? "").trim();
+  const subdirMatch = content.match(
+    /obsidian:\s*\n(?:\s+\w+:.*\n)*\s+subdir:\s*["']?([^\n"']+)/
+  );
+  const subdir = subdirMatch?.[1]?.trim() || "stackmemory";
+  return join(vaultPath, subdir, "wiki");
+}
+function getCompiler(wikiDirOverride) {
+  const wikiDir = wikiDirOverride || resolveWikiDir();
+  if (!wikiDir) {
+    console.error(
+      chalk.red(
+        "Wiki not configured. Set obsidian.vaultPath in .stackmemory/config.yaml"
+      )
+    );
+    console.error(chalk.gray("  Or pass --wiki-dir <path>"));
+    process.exit(1);
+  }
+  return new WikiCompiler({ wikiDir });
+}
+async function openDb() {
+  const dbPath = join(process.cwd(), ".stackmemory", "context.db");
+  if (!existsSync(dbPath)) {
+    console.error(
+      chalk.red('StackMemory not initialized. Run "stackmemory init" first.')
+    );
+    process.exit(1);
+  }
+  const { default: Database } = await import("better-sqlite3");
+  return new Database(dbPath);
+}
+function queryContext(db, opts) {
+  const since = opts.sinceEpoch ?? 0;
+  const limit = opts.limit ?? 1e4;
+  const digests = db.prepare(
+    `SELECT frame_id, name as frame_name, type as frame_type,
+              digest_text, created_at, closed_at
+       FROM frames
+       WHERE state = 'closed' AND digest_text IS NOT NULL
+         AND created_at >= ?
+       ORDER BY created_at DESC
+       LIMIT ?`
+  ).all(since, limit);
+  const entities = db.prepare(
+    `SELECT entity_name, relation, value, context,
+              source_frame_id, valid_from, superseded_at
+       FROM entity_states
+       WHERE valid_from >= ?
+       ORDER BY valid_from DESC
+       LIMIT ?`
+  ).all(since, limit);
+  const anchors = db.prepare(
+    `SELECT a.anchor_id, a.frame_id, f.name as frame_name,
+              a.type, a.text, a.priority, a.created_at
+       FROM anchors a
+       JOIN frames f ON f.frame_id = a.frame_id
+       WHERE a.created_at >= ?
+       ORDER BY a.created_at DESC
+       LIMIT ?`
+  ).all(since, limit);
+  return { digests, entities, anchors };
+}
+function createWikiCommand() {
+  const cmd = new Command("wiki").description(
+    "LLM knowledge base \u2014 compile context into a persistent wiki"
+  );
+  cmd.command("create").description("Generate wiki from all existing context").option("--wiki-dir <path>", "Override wiki directory").option(
+    "--period <period>",
+    "Include session digest (today|yesterday|week)",
+    "week"
+  ).option("--json", "Output as JSON").action(async (options) => {
+    const compiler = getCompiler(options.wikiDir);
+    await compiler.initialize();
+    const db = await openDb();
+    const ctx = queryContext(db, {});
+    let sessionDigest;
+    try {
+      const projectId = db.prepare(
+        `SELECT project_id FROM frames ORDER BY created_at DESC LIMIT 1`
+      ).get()?.project_id || "default";
+      const content = generateChronologicalDigest(
+        db,
+        options.period,
+        projectId
+      );
+      sessionDigest = {
+        period: options.period,
+        content,
+        generatedAt: Date.now()
+      };
+    } catch {
+    }
+    db.close();
+    const result = await compiler.create({
+      ...ctx,
+      sessionDigest
+    });
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(chalk.green("\nWiki created."));
+    console.log(chalk.gray(`  Digests compiled:  ${ctx.digests.length}`));
+    console.log(chalk.gray(`  Entity states:     ${ctx.entities.length}`));
+    console.log(chalk.gray(`  Anchors processed: ${ctx.anchors.length}`));
+    console.log(chalk.gray(`  Articles created:  ${result.created.length}`));
+    console.log(chalk.gray(`  Total articles:    ${result.totalArticles}`));
+  });
+  cmd.command("update").description("Incrementally update wiki with new context").option("--wiki-dir <path>", "Override wiki directory").option(
+    "--since <date>",
+    "Update from this date (ISO format, default: last compile)"
+  ).option("--json", "Output as JSON").action(async (options) => {
+    const compiler = getCompiler(options.wikiDir);
+    await compiler.initialize();
+    const db = await openDb();
+    let sinceEpoch;
+    if (options.since) {
+      sinceEpoch = Math.floor(new Date(options.since).getTime() / 1e3);
+    } else {
+      const lastCompile = compiler.getLastCompileTime();
+      sinceEpoch = lastCompile ?? 0;
+    }
+    if (sinceEpoch === 0) {
+      console.log(
+        chalk.yellow(
+          "No previous compile found. Running full create instead."
+        )
+      );
+      db.close();
+      cmd.commands.find((c) => c.name() === "create")?.parseAsync(["create", "--wiki-dir", compiler["config"].wikiDir], {
+        from: "user"
+      });
+      return;
+    }
+    const ctx = queryContext(db, { sinceEpoch });
+    db.close();
+    if (ctx.digests.length === 0 && ctx.entities.length === 0 && ctx.anchors.length === 0) {
+      console.log(chalk.yellow("No new context since last compile."));
+      return;
+    }
+    const result = await compiler.update(ctx);
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(chalk.green("\nWiki updated."));
+    console.log(chalk.gray(`  New digests:       ${ctx.digests.length}`));
+    console.log(chalk.gray(`  New entity states: ${ctx.entities.length}`));
+    console.log(chalk.gray(`  New anchors:       ${ctx.anchors.length}`));
+    console.log(chalk.gray(`  Articles created:  ${result.created.length}`));
+    console.log(chalk.gray(`  Articles updated:  ${result.updated.length}`));
+    console.log(chalk.gray(`  Total articles:    ${result.totalArticles}`));
+  });
+  cmd.command("lint").description("Health check the wiki for issues").option("--wiki-dir <path>", "Override wiki directory").option("--json", "Output as JSON").action(async (options) => {
+    const compiler = getCompiler(options.wikiDir);
+    await compiler.initialize();
+    const result = await compiler.lint();
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(chalk.cyan("\nWiki Lint Report"));
+    console.log(chalk.gray(`  Total articles: ${result.totalArticles}`));
+    if (result.orphans.length > 0) {
+      console.log(
+        chalk.yellow(
+          `
+  Orphan pages (no inbound links): ${result.orphans.length}`
+        )
+      );
+      result.orphans.slice(0, 10).forEach((o) => console.log(chalk.gray(`    - ${o}`)));
+      if (result.orphans.length > 10) {
+        console.log(
+          chalk.gray(`    ...and ${result.orphans.length - 10} more`)
+        );
+      }
+    }
+    if (result.brokenLinks.length > 0) {
+      console.log(
+        chalk.red(`
+  Broken links: ${result.brokenLinks.length}`)
+      );
+      result.brokenLinks.slice(0, 10).forEach(
+        (l) => console.log(chalk.gray(`    - ${l.source} -> ${l.target}`))
+      );
+    }
+    if (result.stale.length > 0) {
+      console.log(
+        chalk.yellow(`
+  Stale articles (>30 days): ${result.stale.length}`)
+      );
+      result.stale.slice(0, 10).forEach((s) => console.log(chalk.gray(`    - ${s}`)));
+    }
+    if (result.orphans.length === 0 && result.brokenLinks.length === 0 && result.stale.length === 0) {
+      console.log(chalk.green("\n  No issues found."));
+    }
+  });
+  cmd.command("search <query>").description("Search wiki articles by keyword").option("--wiki-dir <path>", "Override wiki directory").option("-n, --limit <n>", "Max results", "20").option("--json", "Output as JSON").action(async (query, options) => {
+    const compiler = getCompiler(options.wikiDir);
+    await compiler.initialize();
+    const results = compiler.search(query).slice(0, parseInt(options.limit));
+    if (options.json) {
+      console.log(JSON.stringify(results, null, 2));
+      return;
+    }
+    if (results.length === 0) {
+      console.log(chalk.yellow(`No results for "${query}".`));
+      return;
+    }
+    console.log(
+      chalk.cyan(`
+Search: "${query}" \u2014 ${results.length} results
+`)
+    );
+    for (const r of results) {
+      console.log(`  ${chalk.white(r.title)}`);
+      console.log(chalk.gray(`    ${r.path} (${r.matches} matches)`));
+    }
+  });
+  cmd.command("status").description("Show wiki statistics").option("--wiki-dir <path>", "Override wiki directory").option("--json", "Output as JSON").action(async (options) => {
+    const compiler = getCompiler(options.wikiDir);
+    await compiler.initialize();
+    const status = compiler.getStatus();
+    if (options.json) {
+      console.log(JSON.stringify(status, null, 2));
+      return;
+    }
+    console.log(chalk.cyan("\nWiki Status"));
+    console.log(chalk.gray(`  Total articles: ${status.totalArticles}`));
+    for (const [cat, count] of Object.entries(status.byCategory)) {
+      console.log(chalk.gray(`    ${cat}: ${count}`));
+    }
+    if (status.lastCompile) {
+      console.log(chalk.gray(`  Last compile: ${status.lastCompile}`));
+    } else {
+      console.log(chalk.gray(`  Last compile: never`));
+    }
+  });
+  return cmd;
+}
+export {
+  createWikiCommand
+};

package/dist/src/cli/index.js

@@ -61,6 +61,7 @@ import { createConductorCommands } from "./commands/orchestrate.js";
 import { createPreflightCommand } from "./commands/preflight.js";
 import { createRulesCommand } from "./commands/rules.js";
 import { createSnapshotCommand } from "./commands/snapshot.js";
+import { createWikiCommand } from "./commands/wiki.js";
 import { createLoopCommand } from "./commands/loop.js";
 import { createSkillCommand } from "./commands/skill.js";
 import chalk from "chalk";
@@ -198,6 +199,8 @@ program.command("status").description("Show current StackMemory status").option(
       await UpdateChecker.checkForUpdates(VERSION);
       await sessionManager.initialize();
       await sharedContextLayer.initialize();
+      const { initObsidianVault } = await import("../core/storage/obsidian-vault-adapter.js");
+      await initObsidianVault();
       const session = await sessionManager.getOrCreateSession({
         projectPath: projectRoot,
         sessionId: options.session
@@ -484,18 +487,24 @@ program.command("board").description("Open the StackMemory Board (agent kanban +
   const { spawn: spawnProc } = await import("child_process");
   const { join: join2 } = await import("path");
   const { existsSync: existsSync2 } = await import("fs");
+  const { fileURLToPath: toPath } = await import("url");
+  const pkgRoot = join2(
+    toPath(import.meta.url),
+    "..",
+    "..",
+    "..",
+    "..",
+    "tools",
+    "agent-viewer",
+    "server.cjs"
+  );
   const candidates = [
     join2(process.cwd(), "tools", "agent-viewer", "server.js"),
-    join2(
-      process.env.PROVENANTAI_ROOT || "",
-      "tools",
-      "agent-viewer",
-      "server.js"
-    ),
+    pkgRoot,
     join2(
       process.env.HOME || "",
       "Dev",
-      "provenantai",
+      "stackmemory",
       "tools",
       "agent-viewer",
       "server.js"
@@ -504,7 +513,7 @@ program.command("board").description("Open the StackMemory Board (agent kanban +
   const serverPath = candidates.find((c) => existsSync2(c));
   if (!serverPath) {
     console.error(
-      "Board server not found. Run from a repo with tools/agent-viewer/server.js"
+      "Board server not found. Run from the stackmemory repo or install globally."
     );
     process.exit(1);
   }
@@ -513,6 +522,19 @@ program.command("board").description("Open the StackMemory Board (agent kanban +
     stdio: "inherit",
     env: { ...process.env, FORCE_COLOR: "1" }
   });
+  if (options.open !== false) {
+    setTimeout(async () => {
+      const url = `http://localhost:${options.port}`;
+      const cp = await import("child_process");
+      try {
+        cp.execSync(
+          process.platform === "darwin" ? `open ${url}` : `xdg-open ${url}`,
+          { stdio: "ignore" }
+        );
+      } catch {
+      }
+    }, 1e3);
+  }
   child.on("close", (code) => process.exit(code || 0));
   process.on("SIGINT", () => {
     child.kill("SIGINT");
@@ -555,6 +577,7 @@ program.addCommand(createDesiresCommands());
 program.addCommand(createConductorCommands());
 program.addCommand(createPreflightCommand());
 program.addCommand(createSnapshotCommand());
+program.addCommand(createWikiCommand());
 program.addCommand(createLoopCommand());
 program.addCommand(createRulesCommand());
 program.addCommand(createSkillCommand());

package/dist/src/core/config/config-manager.js

@@ -77,7 +77,8 @@ class ConfigManager {
       },
       performance: { ...DEFAULT_CONFIG.performance, ...loaded.performance },
       enrichment: { ...DEFAULT_ENRICHMENT, ...loaded.enrichment },
-      profiles: { ...PRESET_PROFILES, ...loaded.profiles }
+      profiles: { ...PRESET_PROFILES, ...loaded.profiles },
+      obsidian: loaded.obsidian
     };
     if (config.profile && config.profiles?.[config.profile]) {
       this.applyProfile(config, config.profiles[config.profile]);