clawvault 3.0.0-beta.1 → 3.0.0-beta.2

package/bin/register-core-commands.js

@@ -221,4 +221,24 @@ export function registerCoreCommands(
         process.exit(1);
       }
     });
+  // === PLUGIN-PATH ===
+  program
+    .command('plugin-path')
+    .description('Print the OpenClaw plugin path for configuration')
+    .action(() => {
+      const pluginDir = path.dirname(path.dirname(new URL(import.meta.url).pathname));
+      const pluginPath = path.join(pluginDir, 'dist', 'plugin', 'index.js');
+      if (fs.existsSync(pluginPath)) {
+        console.log(pluginPath);
+      } else {
+        // Dev mode — use source
+        const srcPath = path.join(pluginDir, 'src', 'plugin', 'index.ts');
+        if (fs.existsSync(srcPath)) {
+          console.log(srcPath);
+        } else {
+          console.error('Plugin not found. Run: npm run build');
+          process.exit(1);
+        }
+      }
+    });
 }

package/dist/{chunk-DEFFDRVP.js → chunk-2TM7DLOL.js}

@@ -800,54 +800,6 @@ function importToVault(vaultPath, extracted, force) {
   }
   return summary;
 }
-function printImportSummary(summary) {
-  const totalCreated = summary.created.people.length + summary.created.preferences.length + summary.created.decisions.length + summary.created.tasks.length;
-  const totalSkipped = summary.skipped.people.length + summary.skipped.preferences.length + summary.skipped.decisions.length + summary.skipped.tasks.length;
-  console.log("\n\u{1F4E5} Memory Import Summary");
-  console.log("\u2500".repeat(40));
-  if (summary.created.people.length > 0) {
-    console.log(`\u2713 People (${summary.created.people.length}):`);
-    for (const name of summary.created.people.slice(0, 5)) {
-      console.log(`    - ${name}`);
-    }
-    if (summary.created.people.length > 5) {
-      console.log(`    ... and ${summary.created.people.length - 5} more`);
-    }
-  }
-  if (summary.created.preferences.length > 0) {
-    console.log(`\u2713 Preferences (${summary.created.preferences.length}):`);
-    for (const pref of summary.created.preferences.slice(0, 5)) {
-      console.log(`    - ${pref}`);
-    }
-    if (summary.created.preferences.length > 5) {
-      console.log(`    ... and ${summary.created.preferences.length - 5} more`);
-    }
-  }
-  if (summary.created.decisions.length > 0) {
-    console.log(`\u2713 Decisions (${summary.created.decisions.length}):`);
-    for (const dec of summary.created.decisions.slice(0, 5)) {
-      console.log(`    - ${dec}`);
-    }
-    if (summary.created.decisions.length > 5) {
-      console.log(`    ... and ${summary.created.decisions.length - 5} more`);
-    }
-  }
-  if (summary.created.tasks.length > 0) {
-    console.log(`\u2713 Tasks (${summary.created.tasks.length}):`);
-    for (const task of summary.created.tasks.slice(0, 5)) {
-      console.log(`    - ${task}`);
-    }
-    if (summary.created.tasks.length > 5) {
-      console.log(`    ... and ${summary.created.tasks.length - 5} more`);
-    }
-  }
-  if (totalSkipped > 0) {
-    console.log(`
-\u2298 Skipped ${totalSkipped} items (already exist or similar)`);
-  }
-  console.log("\u2500".repeat(40));
-  console.log(`Total: ${totalCreated} created, ${totalSkipped} skipped`);
-}
 async function setupCommand(options = {}) {
   const target = resolveVaultTarget(options.vault);
   if (target.existed && !fs.statSync(target.vaultPath).isDirectory()) {
@@ -864,17 +816,22 @@ async function setupCommand(options = {}) {
     if (!fs.existsSync(sourcePath)) {
       throw new Error(`Source path does not exist: ${sourcePath}`);
     }
+    const files = scanMarkdownFiles(sourcePath);
     console.log(`
-\u{1F4C2} Scanning source: ${sourcePath}`);
-    const extracted = scanAndExtract(sourcePath);
-    const totalFound = extracted.people.length + extracted.preferences.length + extracted.decisions.length + extracted.tasks.length;
-    if (totalFound === 0) {
-      console.log("\u2298 No structured data found in source files.");
-    } else {
-      console.log(`Found: ${extracted.people.length} people, ${extracted.preferences.length} preferences, ${extracted.decisions.length} decisions, ${extracted.tasks.length} tasks`);
-      const summary = importToVault(target.vaultPath, extracted, force);
-      printImportSummary(summary);
-    }
+\u{1F4C2} Found ${files.length} markdown files in ${sourcePath}`);
+    console.log("\nVault setup from existing memory is best done by your agent.");
+    console.log("Give your agent this directive:\n");
+    console.log("---");
+    console.log(`Read the markdown files in ${sourcePath}.`);
+    console.log(`Read the template schemas in ${target.vaultPath}/templates/ to understand primitive types.`);
+    console.log("For each piece of durable knowledge:");
+    console.log("  - People with contact info \u2192 create people/<name>.md using person template");
+    console.log("  - Decisions made \u2192 create decisions/<slug>.md using decision template");
+    console.log("  - Lessons learned \u2192 create lessons/<slug>.md using lesson template");
+    console.log("  - Active tasks \u2192 create tasks/<slug>.md using task template");
+    console.log("  - Preferences/facts \u2192 create memories/<slug>.md using memory-event template");
+    console.log("Deduplicate: search existing vault files before creating new ones.");
+    console.log("---");
   }
   const explicitFlags = options.graphColors !== void 0 || options.bases !== void 0;
   const fromOnly = options.from && !explicitFlags;

package/dist/commands/setup.cjs

@@ -1207,54 +1207,6 @@ function importToVault(vaultPath, extracted, force) {
   }
   return summary;
 }
-function printImportSummary(summary) {
-  const totalCreated = summary.created.people.length + summary.created.preferences.length + summary.created.decisions.length + summary.created.tasks.length;
-  const totalSkipped = summary.skipped.people.length + summary.skipped.preferences.length + summary.skipped.decisions.length + summary.skipped.tasks.length;
-  console.log("\n\u{1F4E5} Memory Import Summary");
-  console.log("\u2500".repeat(40));
-  if (summary.created.people.length > 0) {
-    console.log(`\u2713 People (${summary.created.people.length}):`);
-    for (const name of summary.created.people.slice(0, 5)) {
-      console.log(`    - ${name}`);
-    }
-    if (summary.created.people.length > 5) {
-      console.log(`    ... and ${summary.created.people.length - 5} more`);
-    }
-  }
-  if (summary.created.preferences.length > 0) {
-    console.log(`\u2713 Preferences (${summary.created.preferences.length}):`);
-    for (const pref of summary.created.preferences.slice(0, 5)) {
-      console.log(`    - ${pref}`);
-    }
-    if (summary.created.preferences.length > 5) {
-      console.log(`    ... and ${summary.created.preferences.length - 5} more`);
-    }
-  }
-  if (summary.created.decisions.length > 0) {
-    console.log(`\u2713 Decisions (${summary.created.decisions.length}):`);
-    for (const dec of summary.created.decisions.slice(0, 5)) {
-      console.log(`    - ${dec}`);
-    }
-    if (summary.created.decisions.length > 5) {
-      console.log(`    ... and ${summary.created.decisions.length - 5} more`);
-    }
-  }
-  if (summary.created.tasks.length > 0) {
-    console.log(`\u2713 Tasks (${summary.created.tasks.length}):`);
-    for (const task of summary.created.tasks.slice(0, 5)) {
-      console.log(`    - ${task}`);
-    }
-    if (summary.created.tasks.length > 5) {
-      console.log(`    ... and ${summary.created.tasks.length - 5} more`);
-    }
-  }
-  if (totalSkipped > 0) {
-    console.log(`
-\u2298 Skipped ${totalSkipped} items (already exist or similar)`);
-  }
-  console.log("\u2500".repeat(40));
-  console.log(`Total: ${totalCreated} created, ${totalSkipped} skipped`);
-}
 async function setupCommand(options = {}) {
   const target = resolveVaultTarget(options.vault);
   if (target.existed && !fs2.statSync(target.vaultPath).isDirectory()) {
@@ -1271,17 +1223,22 @@ async function setupCommand(options = {}) {
     if (!fs2.existsSync(sourcePath)) {
       throw new Error(`Source path does not exist: ${sourcePath}`);
     }
+    const files = scanMarkdownFiles(sourcePath);
     console.log(`
-\u{1F4C2} Scanning source: ${sourcePath}`);
-    const extracted = scanAndExtract(sourcePath);
-    const totalFound = extracted.people.length + extracted.preferences.length + extracted.decisions.length + extracted.tasks.length;
-    if (totalFound === 0) {
-      console.log("\u2298 No structured data found in source files.");
-    } else {
-      console.log(`Found: ${extracted.people.length} people, ${extracted.preferences.length} preferences, ${extracted.decisions.length} decisions, ${extracted.tasks.length} tasks`);
-      const summary = importToVault(target.vaultPath, extracted, force);
-      printImportSummary(summary);
-    }
+\u{1F4C2} Found ${files.length} markdown files in ${sourcePath}`);
+    console.log("\nVault setup from existing memory is best done by your agent.");
+    console.log("Give your agent this directive:\n");
+    console.log("---");
+    console.log(`Read the markdown files in ${sourcePath}.`);
+    console.log(`Read the template schemas in ${target.vaultPath}/templates/ to understand primitive types.`);
+    console.log("For each piece of durable knowledge:");
+    console.log("  - People with contact info \u2192 create people/<name>.md using person template");
+    console.log("  - Decisions made \u2192 create decisions/<slug>.md using decision template");
+    console.log("  - Lessons learned \u2192 create lessons/<slug>.md using lesson template");
+    console.log("  - Active tasks \u2192 create tasks/<slug>.md using task template");
+    console.log("  - Preferences/facts \u2192 create memories/<slug>.md using memory-event template");
+    console.log("Deduplicate: search existing vault files before creating new ones.");
+    console.log("---");
   }
   const explicitFlags = options.graphColors !== void 0 || options.bases !== void 0;
   const fromOnly = options.from && !explicitFlags;

package/dist/commands/setup.js

@@ -7,7 +7,7 @@ import {
   importToVault,
   scanAndExtract,
   setupCommand
-} from "../chunk-DEFFDRVP.js";
+} from "../chunk-2TM7DLOL.js";
 import "../chunk-LYHGEHXG.js";
 import "../chunk-7766SIJP.js";
 import "../chunk-K234IDRJ.js";

package/dist/index.cjs

@@ -11551,9 +11551,6 @@ function getQmdConfig(vaultPath) {
   }
   return { collection: path26.basename(vaultPath), root: vaultPath };
 }
-function slugify2(text) {
-  return text.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "").trim();
-}
 function scanMarkdownFiles(dirPath) {
   const files = [];
   const resolvedPath = path26.resolve(dirPath);
@@ -11578,533 +11575,6 @@ function scanMarkdownFiles(dirPath) {
   }
   return files;
 }
-function extractPeople(content) {
-  const people = [];
-  const seenNames = /* @__PURE__ */ new Set();
-  const emailPattern = /([A-Z][a-z]+(?:\s+[A-Z][a-z]+)+)\s*<([^>]+@[^>]+)>/g;
-  let match;
-  while ((match = emailPattern.exec(content)) !== null) {
-    const name = match[1].trim();
-    const email = match[2].trim();
-    if (!seenNames.has(name.toLowerCase())) {
-      seenNames.add(name.toLowerCase());
-      people.push({ name, email });
-    }
-  }
-  const rolePatterns = [
-    /([A-Z][a-z]+(?:\s+[A-Z][a-z]+)+)\s*\(([^)]+)\)/g,
-    /([A-Z][a-z]+(?:\s+[A-Z][a-z]+)+),\s*(CEO|CTO|CFO|COO|VP|Director|Manager|Engineer|Designer|Lead|Head of [A-Za-z]+)/gi
-  ];
-  for (const pattern of rolePatterns) {
-    while ((match = pattern.exec(content)) !== null) {
-      const name = match[1].trim();
-      const role = match[2].trim();
-      if (!seenNames.has(name.toLowerCase())) {
-        seenNames.add(name.toLowerCase());
-        people.push({ name, role });
-      }
-    }
-  }
-  const contextPatterns = [
-    /(?:contact|met with|spoke with|emailed|called|messaged|talked to|meeting with)\s+([A-Z][a-zA-Z]*(?:\s+[A-Z][a-zA-Z]*)+)/g,
-    /([A-Z][a-zA-Z]*(?:\s+[A-Z][a-zA-Z]*)+)\s+(?:said|mentioned|suggested|recommended|asked|told me)/g
-  ];
-  for (const pattern of contextPatterns) {
-    while ((match = pattern.exec(content)) !== null) {
-      const name = match[1].trim();
-      if (!seenNames.has(name.toLowerCase()) && name.split(" ").length >= 2) {
-        seenNames.add(name.toLowerCase());
-        const lineStart = content.lastIndexOf("\n", match.index) + 1;
-        const lineEnd = content.indexOf("\n", match.index + match[0].length);
-        const context = content.slice(lineStart, lineEnd === -1 ? void 0 : lineEnd).trim();
-        people.push({ name, context: context.slice(0, 200) });
-      }
-    }
-  }
-  return people;
-}
-function extractPreferences2(content) {
-  const preferences = [];
-  const seenPrefs = /* @__PURE__ */ new Set();
-  const patterns = [
-    // "prefers X" / "prefer X" / "I prefer X"
-    /(?:I\s+)?prefer(?:s)?\s+(?:to\s+)?([^.,\n]+)/gi,
-    // "likes X" / "like X"
-    /(?:I\s+)?like(?:s)?\s+(?:to\s+)?([^.,\n]+)/gi,
-    // "always use X"
-    /always\s+(?:use|uses?)\s+([^.,\n]+)/gi,
-    // "never use X"
-    /never\s+(?:use|uses?)\s+([^.,\n]+)/gi,
-    // "favorite X is Y"
-    /(?:my\s+)?favorite\s+(\w+)\s+is\s+([^.,\n]+)/gi,
-    // "prefer X over Y"
-    /prefer(?:s)?\s+([^.,\n]+)\s+over\s+([^.,\n]+)/gi,
-    // "use X instead of Y"
-    /use(?:s)?\s+([^.,\n]+)\s+instead\s+of\s+([^.,\n]+)/gi
-  ];
-  for (const pattern of patterns) {
-    let match;
-    while ((match = pattern.exec(content)) !== null) {
-      const fullMatch = match[0].trim();
-      const key = fullMatch.toLowerCase();
-      if (!seenPrefs.has(key) && fullMatch.length > 5 && fullMatch.length < 200) {
-        seenPrefs.add(key);
-        const lineStart = content.lastIndexOf("\n", match.index) + 1;
-        const lineEnd = content.indexOf("\n", match.index + match[0].length);
-        const context = content.slice(lineStart, lineEnd === -1 ? void 0 : lineEnd).trim();
-        let subject = "general";
-        let preference = fullMatch;
-        if (match[2]) {
-          subject = match[1].trim();
-          preference = match[2].trim();
-        } else if (match[1]) {
-          preference = match[1].trim();
-        }
-        preferences.push({ subject, preference, context: context.slice(0, 200) });
-      }
-    }
-  }
-  return preferences;
-}
-function extractDecisions(content) {
-  const decisions = [];
-  const seenDecisions = /* @__PURE__ */ new Set();
-  const patterns = [
-    // "decided to X"
-    /(?:I\s+|we\s+)?decided\s+(?:to\s+)?([^.,\n]+)/gi,
-    // "decision: X" or "Decision - X"
-    /decision[:\s-]+([^.,\n]+)/gi,
-    // "we chose X" / "chose to X"
-    /(?:we\s+)?chose\s+(?:to\s+)?([^.,\n]+)/gi,
-    // "going with X"
-    /going\s+with\s+([^.,\n]+)/gi,
-    // "settled on X"
-    /settled\s+on\s+([^.,\n]+)/gi,
-    // "will use X" / "using X going forward"
-    /(?:will\s+use|using)\s+([^.,\n]+)\s+(?:going\s+forward|from\s+now\s+on)/gi
-  ];
-  for (const pattern of patterns) {
-    let match;
-    while ((match = pattern.exec(content)) !== null) {
-      const decision = match[1].trim();
-      const key = decision.toLowerCase();
-      if (!seenDecisions.has(key) && decision.length > 5 && decision.length < 200) {
-        seenDecisions.add(key);
-        const lineStart = content.lastIndexOf("\n", match.index) + 1;
-        const lineEnd = content.indexOf("\n", match.index + match[0].length);
-        const context = content.slice(lineStart, lineEnd === -1 ? void 0 : lineEnd).trim();
-        const title = decision.length > 50 ? decision.slice(0, 50).trim() + "..." : decision;
-        decisions.push({ title, decision, context: context.slice(0, 200) });
-      }
-    }
-  }
-  return decisions;
-}
-function extractTasks(content) {
-  const tasks = [];
-  const seenTasks = /* @__PURE__ */ new Set();
-  const patterns = [
-    // Markdown checkbox "- [ ] task"
-    /^[\s]*[-*]\s*\[\s*\]\s*(.+)$/gm,
-    // "TODO: task" or "TODO - task"
-    /TODO[:\s-]+(.+)/gi,
-    // "FIXME: task"
-    /FIXME[:\s-]+(.+)/gi,
-    // "need to X"
-    /(?:I\s+|we\s+)?need\s+to\s+([^.,\n]+)/gi,
-    // "should X" (but not "should have" which is past)
-    /(?:I\s+|we\s+)?should\s+(?!have)([^.,\n]+)/gi,
-    // "must X"
-    /(?:I\s+|we\s+)?must\s+([^.,\n]+)/gi,
-    // "remember to X"
-    /remember\s+to\s+([^.,\n]+)/gi,
-    // "don't forget to X"
-    /don'?t\s+forget\s+to\s+([^.,\n]+)/gi
-  ];
-  for (const pattern of patterns) {
-    let match;
-    while ((match = pattern.exec(content)) !== null) {
-      const taskText = match[1].trim();
-      const key = taskText.toLowerCase();
-      if (!seenTasks.has(key) && taskText.length > 3 && taskText.length < 200) {
-        seenTasks.add(key);
-        let priority = "medium";
-        const lowerTask = taskText.toLowerCase();
-        if (lowerTask.includes("urgent") || lowerTask.includes("asap") || lowerTask.includes("critical")) {
-          priority = "critical";
-        } else if (lowerTask.includes("important") || lowerTask.includes("high priority")) {
-          priority = "high";
-        } else if (lowerTask.includes("low priority") || lowerTask.includes("eventually") || lowerTask.includes("someday")) {
-          priority = "low";
-        }
-        tasks.push({ title: taskText, priority });
-      }
-    }
-  }
-  return tasks;
-}
-function extractFromContent(content) {
-  return {
-    people: extractPeople(content),
-    preferences: extractPreferences2(content),
-    decisions: extractDecisions(content),
-    tasks: extractTasks(content)
-  };
-}
-function scanAndExtract(sourcePath) {
-  const files = scanMarkdownFiles(sourcePath);
-  const combined = {
-    people: [],
-    preferences: [],
-    decisions: [],
-    tasks: []
-  };
-  for (const file of files) {
-    try {
-      const content = fs26.readFileSync(file, "utf-8");
-      const extracted = extractFromContent(content);
-      combined.people.push(...extracted.people);
-      combined.preferences.push(...extracted.preferences);
-      combined.decisions.push(...extracted.decisions);
-      combined.tasks.push(...extracted.tasks);
-    } catch {
-    }
-  }
-  const seenPeople = /* @__PURE__ */ new Set();
-  combined.people = combined.people.filter((p) => {
-    const key = p.name.toLowerCase();
-    if (seenPeople.has(key)) return false;
-    seenPeople.add(key);
-    return true;
-  });
-  const seenPrefs = /* @__PURE__ */ new Set();
-  combined.preferences = combined.preferences.filter((p) => {
-    const key = `${p.subject}:${p.preference}`.toLowerCase();
-    if (seenPrefs.has(key)) return false;
-    seenPrefs.add(key);
-    return true;
-  });
-  const seenDecisions = /* @__PURE__ */ new Set();
-  combined.decisions = combined.decisions.filter((d) => {
-    const key = d.decision.toLowerCase();
-    if (seenDecisions.has(key)) return false;
-    seenDecisions.add(key);
-    return true;
-  });
-  const seenTasks = /* @__PURE__ */ new Set();
-  combined.tasks = combined.tasks.filter((t) => {
-    const key = t.title.toLowerCase();
-    if (seenTasks.has(key)) return false;
-    seenTasks.add(key);
-    return true;
-  });
-  return combined;
-}
-function fileExistsWithSimilarName(dir, slug) {
-  if (!fs26.existsSync(dir)) return false;
-  const files = fs26.readdirSync(dir);
-  const targetSlug = slug.toLowerCase();
-  return files.some((f) => {
-    const fileSlug = path26.basename(f, ".md").toLowerCase();
-    return fileSlug === targetSlug || fileSlug.includes(targetSlug) || targetSlug.includes(fileSlug);
-  });
-}
-function writePerson(vaultPath, person, force) {
-  const peopleDir = path26.join(vaultPath, "people");
-  fs26.mkdirSync(peopleDir, { recursive: true });
-  const slug = slugify2(person.name);
-  if (!slug) return null;
-  const filePath = path26.join(peopleDir, `${slug}.md`);
-  if (!force && (fs26.existsSync(filePath) || fileExistsWithSimilarName(peopleDir, slug))) {
-    return null;
-  }
-  const template = loadTemplateDefinition("person");
-  const now = /* @__PURE__ */ new Date();
-  const date = now.toISOString().split("T")[0];
-  let content;
-  if (template) {
-    const rendered = renderDocumentFromTemplate(template, {
-      title: person.name,
-      now,
-      overrides: {
-        relationship: person.role ? "colleague" : "contact"
-      }
-    });
-    let body = rendered.content;
-    if (person.context) {
-      body = body.replace(/## Context\n-\s*/, `## Context
-- ${person.context}
-`);
-    }
-    if (person.email || person.role) {
-      const details = [];
-      if (person.email) details.push(`- Contact: ${person.email}`);
-      if (person.role) details.push(`- Role: ${person.role}`);
-      body = body.replace(/## Details\n- Contact:\n- Role:\n- Timezone:/, `## Details
-${details.join("\n")}
-- Timezone:`);
-    }
-    content = import_gray_matter7.default.stringify(body, rendered.frontmatter);
-  } else {
-    const frontmatter = {
-      title: person.name,
-      date,
-      type: "person",
-      relationship: person.role ? "colleague" : "contact"
-    };
-    let body = `# ${person.name}
-
-## Context
-`;
-    if (person.context) body += `- ${person.context}
-`;
-    else body += "- \n";
-    body += "\n## Details\n";
-    if (person.email) body += `- Contact: ${person.email}
-`;
-    else body += "- Contact:\n";
-    if (person.role) body += `- Role: ${person.role}
-`;
-    else body += "- Role:\n";
-    body += "- Timezone:\n";
-    body += `
-## History
-- ${date}: Added from memory import
-`;
-    content = import_gray_matter7.default.stringify(body, frontmatter);
-  }
-  fs26.writeFileSync(filePath, content);
-  return slug;
-}
-function writePreference(vaultPath, pref, force) {
-  const prefsDir = path26.join(vaultPath, "preferences");
-  fs26.mkdirSync(prefsDir, { recursive: true });
-  const slug = slugify2(`${pref.subject}-${pref.preference}`.slice(0, 60));
-  if (!slug) return null;
-  const filePath = path26.join(prefsDir, `${slug}.md`);
-  if (!force && (fs26.existsSync(filePath) || fileExistsWithSimilarName(prefsDir, slug))) {
-    return null;
-  }
-  const now = /* @__PURE__ */ new Date();
-  const date = now.toISOString().split("T")[0];
-  const frontmatter = {
-    title: `${pref.subject}: ${pref.preference}`.slice(0, 100),
-    date,
-    type: "preference",
-    category: pref.subject
-  };
-  let body = `# ${frontmatter.title}
-
-`;
-  body += `## Preference
-- ${pref.preference}
-`;
-  if (pref.context) {
-    body += `
-## Context
-- ${pref.context}
-`;
-  }
-  body += `
-## Source
-- Imported from memory on ${date}
-`;
-  const content = import_gray_matter7.default.stringify(body, frontmatter);
-  fs26.writeFileSync(filePath, content);
-  return slug;
-}
-function writeDecision(vaultPath, decision, force) {
-  const decisionsDir = path26.join(vaultPath, "decisions");
-  fs26.mkdirSync(decisionsDir, { recursive: true });
-  const slug = slugify2(decision.title);
-  if (!slug) return null;
-  const filePath = path26.join(decisionsDir, `${slug}.md`);
-  if (!force && (fs26.existsSync(filePath) || fileExistsWithSimilarName(decisionsDir, slug))) {
-    return null;
-  }
-  const template = loadTemplateDefinition("decision");
-  const now = /* @__PURE__ */ new Date();
-  const date = now.toISOString().split("T")[0];
-  let content;
-  if (template) {
-    const rendered = renderDocumentFromTemplate(template, {
-      title: decision.title,
-      now,
-      overrides: {
-        status: "decided"
-      }
-    });
-    let body = rendered.content;
-    if (decision.context) {
-      body = body.replace(/## Context\n-\s*/, `## Context
-- ${decision.context}
-`);
-    }
-    body = body.replace(/## Decision\n-\s*/, `## Decision
-- ${decision.decision}
-`);
-    body = body.replace(/## Consequences\n-\s*/, `## Consequences
-- Imported from memory on ${date}
-`);
-    content = import_gray_matter7.default.stringify(body, rendered.frontmatter);
-  } else {
-    const frontmatter = {
-      title: decision.title,
-      date,
-      type: "decision",
-      status: "decided"
-    };
-    let body = `# Decision: ${decision.title}
-
-`;
-    body += `## Context
-`;
-    if (decision.context) body += `- ${decision.context}
-`;
-    else body += "- \n";
-    body += `
-## Decision
-- ${decision.decision}
-`;
-    body += `
-## Consequences
-- Imported from memory on ${date}
-`;
-    content = import_gray_matter7.default.stringify(body, frontmatter);
-  }
-  fs26.writeFileSync(filePath, content);
-  return slug;
-}
-function writeTask(vaultPath, task, force) {
-  const tasksDir = path26.join(vaultPath, "tasks");
-  fs26.mkdirSync(tasksDir, { recursive: true });
-  const slug = slugify2(task.title);
-  if (!slug) return null;
-  const filePath = path26.join(tasksDir, `${slug}.md`);
-  if (!force && (fs26.existsSync(filePath) || fileExistsWithSimilarName(tasksDir, slug))) {
-    return null;
-  }
-  const template = loadTemplateDefinition("task");
-  const now = /* @__PURE__ */ new Date();
-  const datetime = now.toISOString();
-  let content;
-  if (template) {
-    const rendered = renderDocumentFromTemplate(template, {
-      title: task.title,
-      now,
-      overrides: {
-        status: "open",
-        priority: task.priority || "medium",
-        source: "memory-import",
-        description: task.description
-      },
-      frontmatter: { pruneEmpty: true }
-    });
-    content = rendered.markdown;
-  } else {
-    const frontmatter = {
-      status: "open",
-      source: "memory-import",
-      created: datetime,
-      updated: datetime,
-      priority: task.priority || "medium"
-    };
-    if (task.description) frontmatter.description = task.description;
-    const body = `# ${task.title}
-
-`;
-    content = import_gray_matter7.default.stringify(body, frontmatter);
-  }
-  fs26.writeFileSync(filePath, content);
-  return slug;
-}
-function importToVault(vaultPath, extracted, force) {
-  const summary = {
-    created: { people: [], preferences: [], decisions: [], tasks: [] },
-    skipped: { people: [], preferences: [], decisions: [], tasks: [] }
-  };
-  for (const person of extracted.people) {
-    const slug = writePerson(vaultPath, person, force);
-    if (slug) {
-      summary.created.people.push(person.name);
-    } else {
-      summary.skipped.people.push(person.name);
-    }
-  }
-  for (const pref of extracted.preferences) {
-    const slug = writePreference(vaultPath, pref, force);
-    if (slug) {
-      summary.created.preferences.push(`${pref.subject}: ${pref.preference}`.slice(0, 50));
-    } else {
-      summary.skipped.preferences.push(`${pref.subject}: ${pref.preference}`.slice(0, 50));
-    }
-  }
-  for (const decision of extracted.decisions) {
-    const slug = writeDecision(vaultPath, decision, force);
-    if (slug) {
-      summary.created.decisions.push(decision.title);
-    } else {
-      summary.skipped.decisions.push(decision.title);
-    }
-  }
-  for (const task of extracted.tasks) {
-    const slug = writeTask(vaultPath, task, force);
-    if (slug) {
-      summary.created.tasks.push(task.title);
-    } else {
-      summary.skipped.tasks.push(task.title);
-    }
-  }
-  return summary;
-}
-function printImportSummary(summary) {
-  const totalCreated = summary.created.people.length + summary.created.preferences.length + summary.created.decisions.length + summary.created.tasks.length;
-  const totalSkipped = summary.skipped.people.length + summary.skipped.preferences.length + summary.skipped.decisions.length + summary.skipped.tasks.length;
-  console.log("\n\u{1F4E5} Memory Import Summary");
-  console.log("\u2500".repeat(40));
-  if (summary.created.people.length > 0) {
-    console.log(`\u2713 People (${summary.created.people.length}):`);
-    for (const name of summary.created.people.slice(0, 5)) {
-      console.log(`    - ${name}`);
-    }
-    if (summary.created.people.length > 5) {
-      console.log(`    ... and ${summary.created.people.length - 5} more`);
-    }
-  }
-  if (summary.created.preferences.length > 0) {
-    console.log(`\u2713 Preferences (${summary.created.preferences.length}):`);
-    for (const pref of summary.created.preferences.slice(0, 5)) {
-      console.log(`    - ${pref}`);
-    }
-    if (summary.created.preferences.length > 5) {
-      console.log(`    ... and ${summary.created.preferences.length - 5} more`);
-    }
-  }
-  if (summary.created.decisions.length > 0) {
-    console.log(`\u2713 Decisions (${summary.created.decisions.length}):`);
-    for (const dec of summary.created.decisions.slice(0, 5)) {
-      console.log(`    - ${dec}`);
-    }
-    if (summary.created.decisions.length > 5) {
-      console.log(`    ... and ${summary.created.decisions.length - 5} more`);
-    }
-  }
-  if (summary.created.tasks.length > 0) {
-    console.log(`\u2713 Tasks (${summary.created.tasks.length}):`);
-    for (const task of summary.created.tasks.slice(0, 5)) {
-      console.log(`    - ${task}`);
-    }
-    if (summary.created.tasks.length > 5) {
-      console.log(`    ... and ${summary.created.tasks.length - 5} more`);
-    }
-  }
-  if (totalSkipped > 0) {
-    console.log(`
-\u2298 Skipped ${totalSkipped} items (already exist or similar)`);
-  }
-  console.log("\u2500".repeat(40));
-  console.log(`Total: ${totalCreated} created, ${totalSkipped} skipped`);
-}
 async function setupCommand(options = {}) {
   const target = resolveVaultTarget(options.vault);
   if (target.existed && !fs26.statSync(target.vaultPath).isDirectory()) {
@@ -12121,17 +11591,22 @@ async function setupCommand(options = {}) {
     if (!fs26.existsSync(sourcePath)) {
       throw new Error(`Source path does not exist: ${sourcePath}`);
     }
+    const files = scanMarkdownFiles(sourcePath);
     console.log(`
-\u{1F4C2} Scanning source: ${sourcePath}`);
-    const extracted = scanAndExtract(sourcePath);
-    const totalFound = extracted.people.length + extracted.preferences.length + extracted.decisions.length + extracted.tasks.length;
-    if (totalFound === 0) {
-      console.log("\u2298 No structured data found in source files.");
-    } else {
-      console.log(`Found: ${extracted.people.length} people, ${extracted.preferences.length} preferences, ${extracted.decisions.length} decisions, ${extracted.tasks.length} tasks`);
-      const summary = importToVault(target.vaultPath, extracted, force);
-      printImportSummary(summary);
-    }
+\u{1F4C2} Found ${files.length} markdown files in ${sourcePath}`);
+    console.log("\nVault setup from existing memory is best done by your agent.");
+    console.log("Give your agent this directive:\n");
+    console.log("---");
+    console.log(`Read the markdown files in ${sourcePath}.`);
+    console.log(`Read the template schemas in ${target.vaultPath}/templates/ to understand primitive types.`);
+    console.log("For each piece of durable knowledge:");
+    console.log("  - People with contact info \u2192 create people/<name>.md using person template");
+    console.log("  - Decisions made \u2192 create decisions/<slug>.md using decision template");
+    console.log("  - Lessons learned \u2192 create lessons/<slug>.md using lesson template");
+    console.log("  - Active tasks \u2192 create tasks/<slug>.md using task template");
+    console.log("  - Preferences/facts \u2192 create memories/<slug>.md using memory-event template");
+    console.log("Deduplicate: search existing vault files before creating new ones.");
+    console.log("---");
   }
   const explicitFlags = options.graphColors !== void 0 || options.bases !== void 0;
   const fromOnly = options.from && !explicitFlags;

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   setupCommand
-} from "./chunk-DEFFDRVP.js";
+} from "./chunk-2TM7DLOL.js";
 import {
   rebuildCommand,
   registerRebuildCommand

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "3.0.0-beta.1",
+  "version": "3.0.0-beta.2",
   "description": "Structured memory system for AI agents — typed storage, knowledge graph, context profiles, canvas dashboards, neural graph themes, and Obsidian-native task views. An elephant never forgets. 🐘",
   "type": "module",
   "main": "dist/index.cjs",