@arvoretech/hub 0.2.0 → 0.4.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -747,6 +747,18 @@ ${prompt.sections.after_pipeline.trim()}`);
   if (prompt?.sections?.after_delivery) {
     sections.push(`
 ${prompt.sections.after_delivery.trim()}`);
+  }
+  if (config.memory) {
+    sections.push(`
+## Team Memory
+
+This workspace has a team memory knowledge base available via the \`team-memory\` MCP.
+
+**Before starting any task**, use \`search_memories\` to find relevant context \u2014 past decisions, conventions, known issues, and domain knowledge. This avoids repeating mistakes and ensures consistency with previous choices.
+
+**After completing a task**, if you discovered something valuable (a decision, a gotcha, a convention, domain insight), use \`add_memory\` to capture it for the team.
+
+Available tools: \`search_memories\`, \`get_memory\`, \`add_memory\`, \`list_memories\`, \`archive_memory\`, \`remove_memory\`.`);
   }
   sections.push(`
 ## Troubleshooting and Debugging
@@ -803,6 +815,10 @@ Follow each step sequentially, applying the role-specific instructions from the
     }
     const stepTitle = step.step.charAt(0).toUpperCase() + step.step.slice(1);
     parts.push(`### ${stepTitle}`);
+    if (step.mode === "plan") {
+      parts.push(`**This step is a planning phase.** Do NOT make any code changes. Focus on reading, analyzing, and collaborating with the user to define requirements before proceeding.`);
+      parts.push(``);
+    }
     if (step.agent) {
       parts.push(`Follow the instructions from the \`agent-${step.agent}.md\` steering file.${step.output ? ` Write output to \`${step.output}\`.` : ""}`);
       if (step.step === "refinement") {
@@ -913,6 +929,18 @@ ${prompt.sections.after_pipeline.trim()}`);
   if (prompt?.sections?.after_delivery) {
     sections.push(`
 ${prompt.sections.after_delivery.trim()}`);
+  }
+  if (config.memory) {
+    sections.push(`
+## Team Memory
+
+This workspace has a team memory knowledge base available via the \`team-memory\` MCP.
+
+**Before starting any task**, use \`search_memories\` to find relevant context \u2014 past decisions, conventions, known issues, and domain knowledge. This avoids repeating mistakes and ensures consistency with previous choices.
+
+**After completing a task**, if you discovered something valuable (a decision, a gotcha, a convention, domain insight), use \`add_memory\` to capture it for the team.
+
+Available tools: \`search_memories\`, \`get_memory\`, \`add_memory\`, \`list_memories\`, \`archive_memory\`, \`remove_memory\`.`);
   }
   sections.push(`
 ## Troubleshooting and Debugging
@@ -997,6 +1025,10 @@ function buildPipelineSection(steps) {
     }
     const stepTitle = step.step.charAt(0).toUpperCase() + step.step.slice(1);
     parts.push(`### ${stepTitle}`);
+    if (step.mode === "plan") {
+      parts.push(`**Before starting this step, switch to Plan Mode** by calling \`SwitchMode\` with \`target_mode_id: "plan"\`. This ensures collaborative planning with the user in a read-only context before any implementation begins.`);
+      parts.push(``);
+    }
     if (step.agent) {
       parts.push(`Call the \`${step.agent}\` agent.${step.output ? ` It writes to \`${step.output}\`.` : ""}`);
       if (step.step === "refinement") {
@@ -1032,6 +1064,10 @@ If any coding agent has doubts, they will write questions in their document. App
 If any validation agent leaves comments requiring fixes, call the relevant coding agents again to address them.`);
       }
     }
+    if (step.mode === "plan") {
+      parts.push(`
+**After this step is complete and approved**, switch back to Agent Mode to proceed with the next step.`);
+    }
     parts.push("");
   }
   return parts.join("\n");
@@ -1294,6 +1330,14 @@ function buildGitignoreLines(config) {
     "# Task documents",
     "tasks/"
   );
+  if (config.memory) {
+    const memPath = config.memory.path || "memories";
+    lines.push(
+      "",
+      "# Memory vector store (generated from markdown files)",
+      `${memPath}/.lancedb/`
+    );
+  }
   return lines;
 }
 var generators = {
@@ -1304,6 +1348,25 @@ var generators = {
 var generateCommand = new Command4("generate").description("Generate editor-specific configuration files from hub.yaml").option("-e, --editor <editor>", "Target editor (cursor, claude-code, kiro)", "cursor").action(async (opts) => {
   const hubDir = process.cwd();
   const config = await loadHubConfig(hubDir);
+  if (config.memory) {
+    const hasMemoryMcp = config.mcps?.some(
+      (m) => m.name === "team-memory" || m.package === "@arvoretech/memory-mcp"
+    );
+    if (!hasMemoryMcp) {
+      console.log(chalk4.red(`
+  Error: 'memory' is configured but no memory MCP is declared in 'mcps'.
+`));
+      console.log(chalk4.yellow(`  Add this to your hub.yaml:
+`));
+      console.log(chalk4.dim(`  mcps:`));
+      console.log(chalk4.dim(`    - name: team-memory`));
+      console.log(chalk4.dim(`      package: "@arvoretech/memory-mcp"`));
+      console.log(chalk4.dim(`      env:`));
+      console.log(chalk4.dim(`        MEMORY_PATH: ${config.memory.path || "./memories"}
+`));
+      process.exit(1);
+    }
+  }
   const generator = generators[opts.editor];
   if (!generator) {
     console.log(
@@ -1892,17 +1955,32 @@ async function listLocalSkills(hubDir) {
   }
   return skills;
 }
-async function installSkillsFromDir(sourceSkillsDir, hubDir, opts) {
-  if (!existsSync6(sourceSkillsDir)) {
-    console.log(chalk8.red("  No skills/ directory found in source"));
-    return;
+async function findSkillFolders(rootDir) {
+  const skillsDir = join9(rootDir, "skills");
+  if (existsSync6(skillsDir)) {
+    const entries = await readdir2(skillsDir);
+    const folders = entries.filter(
+      (f) => existsSync6(join9(skillsDir, f, "SKILL.md"))
+    );
+    if (folders.length > 0) return { dir: skillsDir, folders };
   }
-  const available = await readdir2(sourceSkillsDir);
-  const skillFolders = available.filter(
-    (f) => existsSync6(join9(sourceSkillsDir, f, "SKILL.md"))
-  );
+  if (existsSync6(rootDir)) {
+    const entries = await readdir2(rootDir);
+    const folders = entries.filter(
+      (f) => !f.startsWith(".") && f !== "node_modules" && existsSync6(join9(rootDir, f, "SKILL.md"))
+    );
+    if (folders.length > 0) return { dir: rootDir, folders };
+  }
+  if (existsSync6(join9(rootDir, "SKILL.md"))) {
+    return { dir: join9(rootDir, ".."), folders: [rootDir.split("/").pop()] };
+  }
+  return { dir: skillsDir, folders: [] };
+}
+async function installSkillsFromDir(sourceSkillsDir, hubDir, opts) {
+  const rootDir = sourceSkillsDir.endsWith("/skills") ? sourceSkillsDir.replace(/\/skills$/, "") : sourceSkillsDir;
+  const { dir, folders: skillFolders } = await findSkillFolders(rootDir);
   if (skillFolders.length === 0) {
-    console.log(chalk8.red("  No skills found (looking for skills/*/SKILL.md)"));
+    console.log(chalk8.red("  No skills found (looked in skills/, root dirs, and SKILL.md)"));
     return;
   }
   const toInstall = opts.skill ? skillFolders.filter((s) => s === opts.skill) : skillFolders;
@@ -1913,7 +1991,7 @@ async function installSkillsFromDir(sourceSkillsDir, hubDir, opts) {
   const targetBase = opts.global ? join9(process.env.HOME || "~", ".cursor", "skills") : join9(hubDir, "skills");
   await mkdir4(targetBase, { recursive: true });
   for (const skill of toInstall) {
-    const src = join9(sourceSkillsDir, skill);
+    const src = join9(dir, skill);
     const dest = join9(targetBase, skill);
     await cp2(src, dest, { recursive: true });
     console.log(chalk8.green(`  Installed: ${skill}`));
@@ -1952,42 +2030,80 @@ async function addFromRegistry(skillName, hubDir, opts) {
 }
 async function addFromGitHubSkill(owner, repo, skillName, hubDir, opts) {
   const fullRepo = `${owner}/${repo}`;
-  const remotePath = `skills/${skillName}`;
   const targetBase = opts.global ? join9(process.env.HOME || "~", ".cursor", "skills") : join9(hubDir, "skills");
   const dest = join9(targetBase, skillName);
+  const pathsToTry = [
+    `skills/${skillName}`,
+    skillName
+  ];
   console.log(chalk8.cyan(`  Downloading ${skillName} from ${fullRepo} via GitHub API...`));
-  try {
-    await downloadDirFromGitHub(fullRepo, remotePath, dest);
-    if (!existsSync6(join9(dest, "SKILL.md"))) {
+  for (const remotePath of pathsToTry) {
+    try {
+      await downloadDirFromGitHub(fullRepo, remotePath, dest);
+      if (existsSync6(join9(dest, "SKILL.md"))) {
+        console.log(chalk8.green(`  Installed: ${skillName} (from ${fullRepo})`));
+        console.log(chalk8.green(`
+  1 skill(s) installed to ${opts.global ? "global" : "project"}
+`));
+        return;
+      }
+      await rm(dest, { recursive: true }).catch(() => {
+      });
+    } catch {
       await rm(dest, { recursive: true }).catch(() => {
       });
-      console.log(chalk8.red(`  Skill '${skillName}' not found in ${fullRepo}/skills/`));
-      console.log(chalk8.dim(`  Check available skills: hub skills add ${fullRepo} --list`));
-      return;
     }
-    console.log(chalk8.green(`  Installed: ${skillName} (from ${fullRepo})`));
-    console.log(chalk8.green(`
-  1 skill(s) installed to ${opts.global ? "global" : "project"}
-`));
-  } catch (err) {
-    console.log(chalk8.red(`  Failed to download: ${err.message}`));
   }
+  console.log(chalk8.red(`  Skill '${skillName}' not found in ${fullRepo}`));
+  console.log(chalk8.dim(`  Check available skills: hub skills add ${fullRepo} --list`));
 }
 async function listRemoteSkills(owner, repo) {
   const fullRepo = `${owner}/${repo}`;
   console.log(chalk8.cyan(`  Fetching skills from ${fullRepo}...
 `));
+  const headers = { Accept: "application/vnd.github.v3+json" };
   try {
-    const apiUrl = `https://api.github.com/repos/${fullRepo}/contents/skills`;
-    const res = await fetch(apiUrl, {
-      headers: { Accept: "application/vnd.github.v3+json" }
-    });
-    if (!res.ok) {
-      console.log(chalk8.red(`  Could not list skills from ${fullRepo}`));
-      return;
+    let dirs = [];
+    const skillsRes = await fetch(
+      `https://api.github.com/repos/${fullRepo}/contents/skills`,
+      { headers }
+    );
+    if (skillsRes.ok) {
+      const items = await skillsRes.json();
+      dirs = items.filter((i) => i.type === "dir");
+    }
+    if (dirs.length === 0) {
+      const rootRes = await fetch(
+        `https://api.github.com/repos/${fullRepo}/contents`,
+        { headers }
+      );
+      if (rootRes.ok) {
+        const items = await rootRes.json();
+        const candidates = items.filter(
+          (i) => i.type === "dir" && !i.name.startsWith(".")
+        );
+        for (const c of candidates) {
+          const checkRes = await fetch(
+            `https://api.github.com/repos/${fullRepo}/contents/${c.name}/SKILL.md`,
+            { headers }
+          );
+          if (checkRes.ok) dirs.push({ name: c.name });
+        }
+      }
+    }
+    if (dirs.length === 0) {
+      const rootSkill = await fetch(
+        `https://api.github.com/repos/${fullRepo}/contents/SKILL.md`,
+        { headers }
+      );
+      if (rootSkill.ok) {
+        console.log(chalk8.green(`  This repo is a single skill.
+`));
+        console.log(chalk8.dim(`  Install with: hub skills add ${fullRepo}
+`));
+        return;
+      }
     }
-    const items = await res.json();
-    const dirs = items.filter((i) => i.type === "dir");
     if (dirs.length === 0) {
       console.log(chalk8.dim("  No skills found."));
       return;
@@ -2015,8 +2131,7 @@ async function addFromLocalPath(localPath, hubDir, opts) {
     console.log(chalk8.red(`  Path is not a directory: ${absPath}`));
     return;
   }
-  const sourceSkillsDir = join9(absPath, "skills");
-  await installSkillsFromDir(sourceSkillsDir, hubDir, opts);
+  await installSkillsFromDir(absPath, hubDir, opts);
 }
 async function addFromGitRepo(source, hubDir, opts) {
   const tmp = tmpDir();
@@ -2031,8 +2146,7 @@ async function addFromGitRepo(source, hubDir, opts) {
       console.log(chalk8.dim("  Make sure the URL is correct and you have access to the repository."));
       return;
     }
-    const sourceSkillsDir = join9(tmp, "skills");
-    await installSkillsFromDir(sourceSkillsDir, hubDir, opts);
+    await installSkillsFromDir(tmp, hubDir, opts);
   } finally {
     if (existsSync6(tmp)) {
       await rm(tmp, { recursive: true });
@@ -2049,7 +2163,7 @@ function parseGitHubSource(source) {
   return null;
 }
 var skillsCommand = new Command8("skills").description("Manage agent skills").addCommand(
-  new Command8("add").description("Install skills from registry, GitHub (skills.sh compatible), git URL, or local path").argument("<source>", "Skill name, owner/repo, owner/repo/skill, git URL, or local path").option("-s, --skill <name>", "Install a specific skill only (for repo sources)").option("-g, --global", "Install to global ~/.cursor/skills/").option("-r, --repo <repo>", "Registry repository (owner/repo)").option("-l, --list", "List available skills without installing").action(async (source, opts) => {
+  new Command8("add").description("Install skills from registry, GitHub, git URL, or local path").argument("<source>", "Skill name, owner/repo, owner/repo/skill, git URL, or local path").option("-s, --skill <name>", "Install a specific skill only (for repo sources)").option("-g, --global", "Install to global ~/.cursor/skills/").option("-r, --repo <repo>", "Registry repository (owner/repo)").option("-l, --list", "List available skills without installing").action(async (source, opts) => {
     const hubDir = process.cwd();
     if (isLocalPath(source)) {
       console.log(chalk8.blue(`
@@ -2094,9 +2208,10 @@ Installing skill ${source} from registry
     await addFromRegistry(source, hubDir, opts);
   })
 ).addCommand(
-  new Command8("find").description("Browse community skills on skills.sh").argument("[query]", "Search term (opens skills.sh)").action(async (query) => {
-    const url = query ? `https://skills.sh/?q=${encodeURIComponent(query)}` : "https://skills.sh";
-    console.log(chalk8.blue("\n  Browse community skills at:\n"));
+  new Command8("find").description("Browse curated skills in the Repo Hub directory").argument("[query]", "Search term").action(async (query) => {
+    const base = "https://rhm-website.vercel.app/directory?type=skill";
+    const url = query ? `${base}&q=${encodeURIComponent(query)}` : base;
+    console.log(chalk8.blue("\n  Browse curated skills at:\n"));
     console.log(chalk8.cyan(`  ${url}
 `));
     console.log(chalk8.dim("  Install with: hub skills add <owner>/<repo>/<skill-name>"));
@@ -2203,18 +2318,33 @@ async function addFromLocalPath2(localPath, hubDir, opts) {
     console.log(chalk9.red(`  Path not found: ${absPath}`));
     return;
   }
-  const sourceAgentsDir = statSync2(absPath).isDirectory() ? join10(absPath, "agents") : absPath;
-  await installAgentsFromDir(sourceAgentsDir, hubDir, opts);
-}
-async function installAgentsFromDir(sourceAgentsDir, hubDir, opts) {
-  if (!existsSync7(sourceAgentsDir)) {
-    console.log(chalk9.red("  No agents/ directory found in source"));
+  if (!statSync2(absPath).isDirectory()) {
+    console.log(chalk9.red(`  Path is not a directory: ${absPath}`));
     return;
   }
-  const files = await readdir3(sourceAgentsDir);
-  const mdFiles = files.filter((f) => f.endsWith(".md"));
+  await installAgentsFromDir(absPath, hubDir, opts);
+}
+async function findAgentFiles(rootDir) {
+  const agentsDir = join10(rootDir, "agents");
+  if (existsSync7(agentsDir)) {
+    const entries = await readdir3(agentsDir);
+    const mdFiles = entries.filter((f) => f.endsWith(".md"));
+    if (mdFiles.length > 0) return { dir: agentsDir, files: mdFiles };
+  }
+  if (existsSync7(rootDir)) {
+    const entries = await readdir3(rootDir);
+    const mdFiles = entries.filter(
+      (f) => f.endsWith(".md") && !f.startsWith(".") && f !== "README.md" && f !== "CHANGELOG.md"
+    );
+    if (mdFiles.length > 0) return { dir: rootDir, files: mdFiles };
+  }
+  return { dir: agentsDir, files: [] };
+}
+async function installAgentsFromDir(sourceDir, hubDir, opts) {
+  const rootDir = sourceDir.endsWith("/agents") ? sourceDir.replace(/\/agents$/, "") : sourceDir;
+  const { dir, files: mdFiles } = await findAgentFiles(rootDir);
   if (mdFiles.length === 0) {
-    console.log(chalk9.red("  No agent files found (looking for agents/*.md)"));
+    console.log(chalk9.red("  No agent files found (looked in agents/ and root .md files)"));
     return;
   }
   const toInstall = opts.agent ? mdFiles.filter((f) => f === `${opts.agent}.md` || f === opts.agent) : mdFiles;
@@ -2226,7 +2356,7 @@ async function installAgentsFromDir(sourceAgentsDir, hubDir, opts) {
   const targetBase = opts.global ? join10(process.env.HOME || "~", ".cursor", "agents") : join10(hubDir, "agents");
   await mkdir5(targetBase, { recursive: true });
   for (const file of toInstall) {
-    await copyFile2(join10(sourceAgentsDir, file), join10(targetBase, file));
+    await copyFile2(join10(dir, file), join10(targetBase, file));
     console.log(chalk9.green(`  Installed: ${file.replace(/\.md$/, "")}`));
   }
   console.log(
@@ -2249,8 +2379,7 @@ async function addFromGitRepo2(source, hubDir, opts) {
       console.log(chalk9.red(`  Repository not found or not accessible: ${source}`));
       return;
     }
-    const sourceAgentsDir = join10(tmp, "agents");
-    await installAgentsFromDir(sourceAgentsDir, hubDir, opts);
+    await installAgentsFromDir(tmp, hubDir, opts);
   } finally {
     if (existsSync7(tmp)) {
       await rm2(tmp, { recursive: true });
@@ -2325,6 +2454,16 @@ Agent '${name}' not found in ${opts.global ? "global" : "project"}
 Removed agent: ${name}
 `));
   })
+).addCommand(
+  new Command9("find").description("Browse curated agents in the Repo Hub directory").argument("[query]", "Search term").action(async (query) => {
+    const base = "https://rhm-website.vercel.app/directory?type=agent";
+    const url = query ? `${base}&q=${encodeURIComponent(query)}` : base;
+    console.log(chalk9.blue("\n  Browse curated agents at:\n"));
+    console.log(chalk9.cyan(`  ${url}
+`));
+    console.log(chalk9.dim("  Install with: hub agents add <owner>/<repo>"));
+    console.log(chalk9.dim("  Example:      hub agents add my-org/my-agents\n"));
+  })
 ).addCommand(
   new Command9("sync").description("Install all agents referenced in hub.yaml from the registry").option("-g, --global", "Install to global ~/.cursor/agents/").option("-r, --repo <repo>", "Registry repository (owner/repo)").option("-f, --force", "Re-install even if the agent already exists locally").action(async (opts) => {
     const hubDir = process.cwd();
@@ -3329,17 +3468,253 @@ function extractVersion(s) {
   return match?.[1] || s;
 }
 
-// src/commands/update.ts
+// src/commands/memory.ts
 import { Command as Command16 } from "commander";
+import { existsSync as existsSync14 } from "fs";
+import { mkdir as mkdir9, readdir as readdir6, readFile as readFile9, writeFile as writeFile11, rm as rm5, appendFile as appendFile2 } from "fs/promises";
+import { join as join17, resolve as resolve6, basename as basename2 } from "path";
+import chalk16 from "chalk";
+async function ensureLanceDbIgnored(memoriesDir, hubDir) {
+  const relative = memoriesDir.replace(hubDir + "/", "");
+  const pattern = `${relative}/.lancedb/`;
+  const gitignorePath = join17(hubDir, ".gitignore");
+  if (existsSync14(gitignorePath)) {
+    const content = await readFile9(gitignorePath, "utf-8");
+    if (content.includes(".lancedb")) return;
+    await appendFile2(gitignorePath, `
+# Memory vector store (generated)
+${pattern}
+`);
+  } else {
+    await writeFile11(gitignorePath, `# Memory vector store (generated)
+${pattern}
+`, "utf-8");
+  }
+}
+var VALID_CATEGORIES = [
+  "decisions",
+  "conventions",
+  "incidents",
+  "domain",
+  "gotchas"
+];
+function getMemoriesPath(hubDir, configPath) {
+  return resolve6(hubDir, configPath || "memories");
+}
+function parseFrontmatter(raw) {
+  const match = raw.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!match) return { data: {}, content: raw };
+  const data = {};
+  for (const line of match[1].split("\n")) {
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    let value = line.slice(idx + 1).trim();
+    if (typeof value === "string" && value.startsWith("[") && value.endsWith("]")) {
+      value = value.slice(1, -1).split(",").map((s) => s.trim());
+    }
+    data[key] = value;
+  }
+  return { data, content: match[2] };
+}
+function buildFrontmatter(data) {
+  const lines = ["---"];
+  for (const [key, value] of Object.entries(data)) {
+    if (value === void 0) continue;
+    if (Array.isArray(value)) {
+      lines.push(`${key}: [${value.join(", ")}]`);
+    } else {
+      lines.push(`${key}: ${value}`);
+    }
+  }
+  lines.push("---");
+  return lines.join("\n");
+}
+async function listMemories(memoriesDir, opts) {
+  if (!existsSync14(memoriesDir)) {
+    console.log(chalk16.dim("  No memories directory found."));
+    return;
+  }
+  let total = 0;
+  for (const cat of VALID_CATEGORIES) {
+    if (opts.category && opts.category !== cat) continue;
+    const catDir = join17(memoriesDir, cat);
+    if (!existsSync14(catDir)) continue;
+    const files = (await readdir6(catDir)).filter((f) => f.endsWith(".md"));
+    if (files.length === 0) continue;
+    const entries = [];
+    for (const file of files) {
+      const raw = await readFile9(join17(catDir, file), "utf-8");
+      const { data } = parseFrontmatter(raw);
+      const status = data.status || "active";
+      if (opts.status && status !== opts.status) continue;
+      entries.push({
+        id: basename2(file, ".md"),
+        title: data.title || basename2(file, ".md"),
+        date: data.date || "unknown",
+        status,
+        tags: data.tags || []
+      });
+    }
+    if (entries.length === 0) continue;
+    console.log(chalk16.cyan(`
+  ${cat} (${entries.length})`));
+    for (const e of entries) {
+      const statusIcon = e.status === "active" ? chalk16.green("\u25CF") : chalk16.dim("\u25CB");
+      const tags = e.tags.length > 0 ? chalk16.dim(` [${e.tags.join(", ")}]`) : "";
+      console.log(`    ${statusIcon} ${chalk16.yellow(e.id)} \u2014 ${e.title} ${chalk16.dim(`(${e.date})`)}${tags}`);
+    }
+    total += entries.length;
+  }
+  if (total === 0) {
+    console.log(chalk16.dim("  No memories found."));
+  } else {
+    console.log(chalk16.green(`
+  Total: ${total} memories
+`));
+  }
+}
+var memoryCommand = new Command16("memory").description("Manage team memories \u2014 persistent knowledge base for AI context").addCommand(
+  new Command16("add").description("Create a new memory entry").argument("<category>", `Category: ${VALID_CATEGORIES.join(", ")}`).argument("<title>", "Memory title").option("-c, --content <content>", "Memory content (or provide via stdin)").option("-t, --tags <tags>", "Comma-separated tags").option("-a, --author <author>", "Author name").action(
+    async (category, title, opts) => {
+      if (!VALID_CATEGORIES.includes(category)) {
+        console.log(
+          chalk16.red(`
+  Invalid category: ${category}. Valid: ${VALID_CATEGORIES.join(", ")}
+`)
+        );
+        return;
+      }
+      const hubDir = process.cwd();
+      let memoriesDir;
+      try {
+        const config = await loadHubConfig(hubDir);
+        memoriesDir = getMemoriesPath(hubDir, config.memory?.path);
+      } catch {
+        memoriesDir = getMemoriesPath(hubDir);
+      }
+      const catDir = join17(memoriesDir, category);
+      await mkdir9(catDir, { recursive: true });
+      await ensureLanceDbIgnored(memoriesDir, hubDir);
+      const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+      const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+      const id = `${date}-${slug}`;
+      const filePath = join17(catDir, `${id}.md`);
+      const fm = {
+        title,
+        category,
+        date,
+        status: "active"
+      };
+      if (opts.author) fm.author = opts.author;
+      if (opts.tags) fm.tags = opts.tags.split(",").map((t) => t.trim());
+      const content = opts.content || `## Context
+
+
+
+## Details
+
+`;
+      const fileContent = `${buildFrontmatter(fm)}
+
+${content}
+`;
+      await writeFile11(filePath, fileContent, "utf-8");
+      console.log(chalk16.green(`
+  Created: ${category}/${id}.md`));
+      console.log(chalk16.dim(`  Path: ${filePath}`));
+      if (!opts.content) {
+        console.log(chalk16.yellow("  Edit the file to add content.\n"));
+      } else {
+        console.log();
+      }
+    }
+  )
+).addCommand(
+  new Command16("list").description("List all memories").option("-c, --category <category>", "Filter by category").option("-s, --status <status>", "Filter by status (active, archived, superseded)").action(async (opts) => {
+    const hubDir = process.cwd();
+    let memoriesDir;
+    try {
+      const config = await loadHubConfig(hubDir);
+      memoriesDir = getMemoriesPath(hubDir, config.memory?.path);
+    } catch {
+      memoriesDir = getMemoriesPath(hubDir);
+    }
+    console.log(chalk16.blue("\nTeam Memories"));
+    await listMemories(memoriesDir, opts);
+  })
+).addCommand(
+  new Command16("archive").description("Archive a memory (soft-delete)").argument("<id>", "Memory ID (filename without .md)").action(async (id) => {
+    const hubDir = process.cwd();
+    let memoriesDir;
+    try {
+      const config = await loadHubConfig(hubDir);
+      memoriesDir = getMemoriesPath(hubDir, config.memory?.path);
+    } catch {
+      memoriesDir = getMemoriesPath(hubDir);
+    }
+    let found = false;
+    for (const cat of VALID_CATEGORIES) {
+      const filePath = join17(memoriesDir, cat, `${id}.md`);
+      if (!existsSync14(filePath)) continue;
+      const raw = await readFile9(filePath, "utf-8");
+      const { data, content } = parseFrontmatter(raw);
+      data.status = "archived";
+      const updated = `${buildFrontmatter(data)}
+${content}`;
+      await writeFile11(filePath, updated, "utf-8");
+      console.log(chalk16.green(`
+  Archived: ${cat}/${id}.md
+`));
+      found = true;
+      break;
+    }
+    if (!found) {
+      console.log(chalk16.red(`
+  Memory "${id}" not found.
+`));
+    }
+  })
+).addCommand(
+  new Command16("remove").description("Permanently delete a memory").argument("<id>", "Memory ID (filename without .md)").action(async (id) => {
+    const hubDir = process.cwd();
+    let memoriesDir;
+    try {
+      const config = await loadHubConfig(hubDir);
+      memoriesDir = getMemoriesPath(hubDir, config.memory?.path);
+    } catch {
+      memoriesDir = getMemoriesPath(hubDir);
+    }
+    let found = false;
+    for (const cat of VALID_CATEGORIES) {
+      const filePath = join17(memoriesDir, cat, `${id}.md`);
+      if (!existsSync14(filePath)) continue;
+      await rm5(filePath);
+      console.log(chalk16.green(`
+  Removed: ${cat}/${id}.md
+`));
+      found = true;
+      break;
+    }
+    if (!found) {
+      console.log(chalk16.red(`
+  Memory "${id}" not found.
+`));
+    }
+  })
+);
+
+// src/commands/update.ts
+import { Command as Command17 } from "commander";
 import { execSync as execSync12 } from "child_process";
 import { readFileSync } from "fs";
-import { join as join17, dirname } from "path";
+import { join as join18, dirname } from "path";
 import { fileURLToPath } from "url";
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 var PACKAGE_NAME = "@arvoretech/hub";
 function getCurrentVersion() {
   const __dirname = dirname(fileURLToPath(import.meta.url));
-  const pkgPath = join17(__dirname, "..", "package.json");
+  const pkgPath = join18(__dirname, "..", "package.json");
   const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
   return pkg.version;
 }
@@ -3362,54 +3737,54 @@ function detectPackageManager() {
     }
   }
 }
-var updateCommand = new Command16("update").description("Update hub CLI to the latest version").option("--check", "Only check for updates without installing").action(async (opts) => {
+var updateCommand = new Command17("update").description("Update hub CLI to the latest version").option("--check", "Only check for updates without installing").action(async (opts) => {
   const currentVersion = getCurrentVersion();
-  console.log(chalk16.blue(`
+  console.log(chalk17.blue(`
   Current version: ${currentVersion}`));
   let latestVersion;
   try {
     latestVersion = await getLatestVersion();
   } catch (err) {
-    console.log(chalk16.red(`  Failed to check for updates: ${err.message}
+    console.log(chalk17.red(`  Failed to check for updates: ${err.message}
 `));
     return;
   }
-  console.log(chalk16.blue(`  Latest version:  ${latestVersion}`));
+  console.log(chalk17.blue(`  Latest version:  ${latestVersion}`));
   if (currentVersion === latestVersion) {
-    console.log(chalk16.green("\n  You're already on the latest version.\n"));
+    console.log(chalk17.green("\n  You're already on the latest version.\n"));
     return;
   }
-  console.log(chalk16.yellow(`
+  console.log(chalk17.yellow(`
   Update available: ${currentVersion} \u2192 ${latestVersion}`));
   if (opts.check) {
     const pm2 = detectPackageManager();
-    console.log(chalk16.dim(`
+    console.log(chalk17.dim(`
   Run 'hub update' or '${pm2} install -g ${PACKAGE_NAME}@latest' to update.
 `));
     return;
   }
   const pm = detectPackageManager();
   const installCmd = pm === "pnpm" ? `pnpm install -g ${PACKAGE_NAME}@latest` : pm === "yarn" ? `yarn global add ${PACKAGE_NAME}@latest` : `npm install -g ${PACKAGE_NAME}@latest`;
-  console.log(chalk16.cyan(`
+  console.log(chalk17.cyan(`
   Updating with ${pm}...
 `));
-  console.log(chalk16.dim(`  $ ${installCmd}
+  console.log(chalk17.dim(`  $ ${installCmd}
 `));
   try {
     execSync12(installCmd, { stdio: "inherit" });
-    console.log(chalk16.green(`
+    console.log(chalk17.green(`
   Updated to ${latestVersion} successfully.
 `));
   } catch {
-    console.log(chalk16.red(`
+    console.log(chalk17.red(`
   Update failed. Try running manually:`));
-    console.log(chalk16.dim(`  $ ${installCmd}
+    console.log(chalk17.dim(`  $ ${installCmd}
 `));
   }
 });
 
 // src/index.ts
-var program = new Command17();
+var program = new Command18();
 program.name("hub").description(
   "Give your AI coding assistant the full picture. Multi-repo context, agent orchestration, and end-to-end workflows."
 ).version("0.2.0").enablePositionalOptions();
@@ -3430,5 +3805,6 @@ program.addCommand(execCommand);
 program.addCommand(worktreeCommand);
 program.addCommand(doctorCommand);
 program.addCommand(toolsCommand);
+program.addCommand(memoryCommand);
 program.addCommand(updateCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvoretech/hub",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "CLI for managing AI-aware multi-repository workspaces",
   "main": "dist/index.js",
   "type": "module",