clawvault 2.5.3 → 2.6.0

package/dist/commands/template.js

@@ -1,3 +1,11 @@
+import {
+  TEMPLATE_EXTENSION,
+  buildTemplateIndex,
+  listTemplateDefinitions,
+  normalizeTemplateName,
+  parseTemplateDefinition,
+  renderDocumentFromTemplate
+} from "../chunk-MFAWT5O5.js";
 import {
   buildTemplateVariables,
   renderTemplate
@@ -6,26 +14,8 @@ import {
 // src/commands/template.ts
 import * as fs from "fs";
 import * as path from "path";
-import { fileURLToPath } from "url";
 var VAULT_CONFIG_FILE = ".clawvault.json";
-var TEMPLATE_EXTENSION = ".md";
-function resolveBuiltinTemplatesDir(override) {
-  if (override) {
-    const resolved = path.resolve(override);
-    return fs.existsSync(resolved) ? resolved : null;
-  }
-  const moduleDir = path.dirname(fileURLToPath(import.meta.url));
-  const candidates = [
-    path.resolve(moduleDir, "../templates"),
-    path.resolve(moduleDir, "../../templates")
-  ];
-  for (const candidate of candidates) {
-    if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
-      return candidate;
-    }
-  }
-  return null;
-}
+var TEMPLATE_LIST_IGNORED_BUILTINS = /* @__PURE__ */ new Set(["daily"]);
 function findVaultRoot(start) {
   let current = path.resolve(start);
   while (true) {
@@ -48,53 +38,41 @@ function resolveVaultPath(options) {
   const cwd = options.cwd ?? process.cwd();
   return findVaultRoot(cwd);
 }
-function normalizeTemplateName(name) {
-  const base = path.basename(name, path.extname(name));
-  return base.trim();
-}
 function slugify(text) {
   return text.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").trim();
 }
-function listTemplateFiles(dir, ignore) {
-  const entries = /* @__PURE__ */ new Map();
-  if (!fs.existsSync(dir)) return entries;
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    if (!entry.isFile() || !entry.name.endsWith(TEMPLATE_EXTENSION)) continue;
-    const name = normalizeTemplateName(entry.name);
-    if (!name) continue;
-    if (ignore?.has(name)) continue;
-    entries.set(name, path.join(dir, entry.name));
-  }
-  return entries;
+function buildTemplateIndexForContext(options) {
+  const vaultPath = resolveVaultPath(options) ?? void 0;
+  return buildTemplateIndex({
+    vaultPath,
+    builtinDir: options.builtinDir,
+    ignoreBuiltinNames: TEMPLATE_LIST_IGNORED_BUILTINS
+  });
 }
-function buildTemplateIndex(options) {
-  const index = /* @__PURE__ */ new Map();
-  const builtinDir = resolveBuiltinTemplatesDir(options.builtinDir);
-  if (builtinDir) {
-    const ignore = /* @__PURE__ */ new Set(["daily"]);
-    for (const [name, filePath] of listTemplateFiles(builtinDir, ignore)) {
-      index.set(name, filePath);
-    }
-  }
-  const vaultPath = resolveVaultPath(options);
-  if (vaultPath) {
-    const vaultTemplatesDir = path.join(vaultPath, "templates");
-    for (const [name, filePath] of listTemplateFiles(vaultTemplatesDir)) {
-      index.set(name, filePath);
-    }
-  }
-  return index;
+function listTemplateDefinitions2(options = {}) {
+  const vaultPath = resolveVaultPath(options) ?? void 0;
+  return listTemplateDefinitions({
+    vaultPath,
+    builtinDir: options.builtinDir,
+    ignoreBuiltinNames: TEMPLATE_LIST_IGNORED_BUILTINS
+  }).map((definition) => ({
+    name: definition.name,
+    primitive: definition.primitive,
+    description: definition.description,
+    fields: Object.keys(definition.fields),
+    path: definition.path,
+    format: definition.format
+  }));
 }
 function listTemplates(options = {}) {
-  const index = buildTemplateIndex(options);
-  return [...index.keys()].sort();
+  return listTemplateDefinitions2(options).map((definition) => definition.name);
 }
 function createFromTemplate(name, options = {}) {
   const templateName = normalizeTemplateName(name);
   if (!templateName) {
     throw new Error("Template name is required.");
   }
-  const index = buildTemplateIndex(options);
+  const index = buildTemplateIndexForContext(options);
   const templatePath = index.get(templateName);
   if (!templatePath) {
     const available = [...index.keys()].sort();
@@ -107,7 +85,20 @@ function createFromTemplate(name, options = {}) {
   const type = options.type ?? templateName;
   const title = options.title ?? `${type} ${date}`.trim();
   const variables = buildTemplateVariables({ title, type, date }, now);
-  const rendered = renderTemplate(raw, variables);
+  const parsedTemplate = parseTemplateDefinition(raw, templateName, templatePath);
+  const rendered = parsedTemplate.format === "schema" ? renderDocumentFromTemplate(parsedTemplate, {
+    title,
+    type,
+    now,
+    variables: {
+      ...variables,
+      content: "",
+      links_line: "",
+      owner_link: "",
+      project_link: "",
+      team_links_line: ""
+    }
+  }).markdown : renderTemplate(raw, variables);
   const cwd = options.cwd ?? process.cwd();
   const slug = slugify(title) || slugify(templateName) || `template-${date}`;
   const outputPath = path.join(cwd, `${slug}${TEMPLATE_EXTENSION}`);
@@ -143,5 +134,6 @@ function addTemplate(file, options) {
 export {
   addTemplate,
   createFromTemplate,
+  listTemplateDefinitions2 as listTemplateDefinitions,
   listTemplates
 };

package/dist/commands/wake.js

@@ -4,11 +4,11 @@ import {
 import "../chunk-7ZRP733D.js";
 import {
   ClawVault
-} from "../chunk-AY4PGUVL.js";
+} from "../chunk-KL4NAOMO.js";
 import {
   parseObservationMarkdown
 } from "../chunk-FHFUXL6G.js";
-import "../chunk-O7XHXF7F.js";
+import "../chunk-MAKNAHAW.js";
 import "../chunk-2CDEETQN.js";
 import "../chunk-ZZA73MFY.js";
 import {

package/dist/index.js

@@ -1,7 +1,3 @@
-import {
-  buildTemplateVariables,
-  renderTemplate
-} from "./chunk-7766SIJP.js";
 import {
   buildSessionRecap,
   formatSessionRecapMarkdown,
@@ -9,7 +5,7 @@ import {
 } from "./chunk-ZKGY7WTT.js";
 import {
   setupCommand
-} from "./chunk-M25QVSJM.js";
+} from "./chunk-RVYA52PY.js";
 import {
   registerSyncBdCommand,
   syncBdCommand
@@ -22,14 +18,14 @@ import {
 import {
   rebuildCommand,
   registerRebuildCommand
-} from "./chunk-TPDH3JPP.js";
+} from "./chunk-PBEE567J.js";
 import {
   registerReplayCommand,
   replayCommand
-} from "./chunk-4IV3R2F5.js";
+} from "./chunk-4TE4JMLA.js";
 import {
   doctor
-} from "./chunk-LMEMZGUV.js";
+} from "./chunk-UEOUADMO.js";
 import "./chunk-7ZRP733D.js";
 import {
   graphCommand,
@@ -44,12 +40,12 @@ import {
   kanbanCommand,
   parseKanbanMarkdown,
   syncKanbanBoard
-} from "./chunk-J5EMBUPK.js";
+} from "./chunk-4OXMU5S2.js";
 import "./chunk-4VQTUVH7.js";
 import "./chunk-J7ZWCI2C.js";
 import {
   registerCliCommands
-} from "./chunk-FG6RJMCN.js";
+} from "./chunk-HA5M6KJB.js";
 import {
   registerTailscaleCommands,
   registerTailscaleDiscoverCommand,
@@ -60,7 +56,7 @@ import {
   tailscaleServeCommand,
   tailscaleStatusCommand,
   tailscaleSyncCommand
-} from "./chunk-NZ4ZZNSR.js";
+} from "./chunk-THRJVD4L.js";
 import {
   CLAWVAULT_SERVE_PATH,
   DEFAULT_SERVE_PORT,
@@ -81,13 +77,13 @@ import {
   serveVault,
   stopTailscaleServe,
   syncWithPeer
-} from "./chunk-4GBPTBFJ.js";
-import "./chunk-CLE2HHNT.js";
+} from "./chunk-TIGW564L.js";
+import "./chunk-IVRIKYFE.js";
 import {
   SessionWatcher,
   observeCommand,
   registerObserveCommand
-} from "./chunk-OSMS7QIG.js";
+} from "./chunk-ME37YNW3.js";
 import {
   parseSessionFile
 } from "./chunk-P5EPF6MB.js";
@@ -106,19 +102,19 @@ import {
   normalizeContextProfileInput,
   registerContextCommand,
   resolveContextProfile
-} from "./chunk-GFJ3LIIB.js";
+} from "./chunk-XAVB4GB4.js";
 import {
   getObserverStaleness,
   getScaledObservationThresholdBytes,
   observeActiveSessions,
   parseSessionSourceLabel
-} from "./chunk-IZEY5S74.js";
+} from "./chunk-IEVLHNLU.js";
 import "./chunk-HRLWZGMA.js";
 import {
   Compressor,
   Observer,
   Reflector
-} from "./chunk-S2IG7VNM.js";
+} from "./chunk-Q2J5YTUF.js";
 import {
   archiveProject,
   createProject,
@@ -127,17 +123,17 @@ import {
   listProjects,
   readProject,
   updateProject
-} from "./chunk-5GZFTAL7.js";
+} from "./chunk-AZYOKJYC.js";
 import {
   ClawVault,
   createVault,
   findVault
-} from "./chunk-AY4PGUVL.js";
+} from "./chunk-KL4NAOMO.js";
 import "./chunk-FHFUXL6G.js";
 import {
   embedCommand,
   registerEmbedCommand
-} from "./chunk-3FP5BJ42.js";
+} from "./chunk-4QYGFWRM.js";
 import {
   QMD_INSTALL_COMMAND,
   QMD_INSTALL_URL,
@@ -148,7 +144,7 @@ import {
   hasQmd,
   qmdEmbed,
   qmdUpdate
-} from "./chunk-O7XHXF7F.js";
+} from "./chunk-MAKNAHAW.js";
 import {
   buildInjectionResult,
   deterministicInjectMatches,
@@ -211,7 +207,12 @@ import {
   queryTransitions,
   readAllTransitions,
   updateTask
-} from "./chunk-IOALNTAN.js";
+} from "./chunk-QWQ3TIKS.js";
+import "./chunk-MFAWT5O5.js";
+import {
+  buildTemplateVariables,
+  renderTemplate
+} from "./chunk-7766SIJP.js";
 import {
   checkOpenClawCompatibility,
   compatCommand,

package/dist/lib/project-utils.js

@@ -6,8 +6,10 @@ import {
   listProjects,
   readProject,
   updateProject
-} from "../chunk-5GZFTAL7.js";
-import "../chunk-IOALNTAN.js";
+} from "../chunk-AZYOKJYC.js";
+import "../chunk-QWQ3TIKS.js";
+import "../chunk-MFAWT5O5.js";
+import "../chunk-7766SIJP.js";
 export {
   archiveProject,
   createProject,

package/dist/lib/tailscale.js

@@ -21,8 +21,8 @@ import {
   serveVault,
   stopTailscaleServe,
   syncWithPeer
-} from "../chunk-4GBPTBFJ.js";
-import "../chunk-CLE2HHNT.js";
+} from "../chunk-TIGW564L.js";
+import "../chunk-IVRIKYFE.js";
 export {
   CLAWVAULT_SERVE_PATH,
   DEFAULT_SERVE_PORT,

package/dist/lib/task-utils.d.ts

@@ -63,6 +63,19 @@ interface TaskTransitionOptions {
     confidence?: number;
     reason?: string | null;
 }
+type CreateTaskOptions = {
+    source?: string;
+    owner?: string;
+    project?: string;
+    priority?: TaskPriority;
+    due?: string;
+    content?: string;
+    tags?: string[];
+    description?: string;
+    estimate?: string;
+    parent?: string;
+    depends_on?: string[];
+};
 /**
  * Slugify a title for use as filename
  * Deterministic: same title = same slug
@@ -111,19 +124,7 @@ declare function listBacklogItems(vaultPath: string, filters?: BacklogFilterOpti
 /**
  * Create a new task
  */
-declare function createTask(vaultPath: string, title: string, options?: {
-    source?: string;
-    owner?: string;
-    project?: string;
-    priority?: TaskPriority;
-    due?: string;
-    content?: string;
-    tags?: string[];
-    description?: string;
-    estimate?: string;
-    parent?: string;
-    depends_on?: string[];
-}): Task;
+declare function createTask(vaultPath: string, title: string, options?: CreateTaskOptions): Task;
 /**
  * Update an existing task
  */

package/dist/lib/task-utils.js

@@ -23,7 +23,9 @@ import {
   slugify,
   updateBacklogItem,
   updateTask
-} from "../chunk-IOALNTAN.js";
+} from "../chunk-QWQ3TIKS.js";
+import "../chunk-MFAWT5O5.js";
+import "../chunk-7766SIJP.js";
 export {
   completeTask,
   createBacklogItem,

package/dist/lib/template-engine.d.ts

@@ -3,6 +3,7 @@ interface TemplateVariables {
     date: string;
     datetime: string;
     type: string;
+    [key: string]: string | number | boolean | null | undefined;
 }
 declare function buildTemplateVariables(input?: Partial<TemplateVariables>, now?: Date): TemplateVariables;
 declare function renderTemplate(template: string, variables: TemplateVariables): string;

package/dist/lib/webdav.js

@@ -14,7 +14,7 @@ import {
   handlePut,
   isPathSafe,
   resolveWebDAVPath
-} from "../chunk-CLE2HHNT.js";
+} from "../chunk-IVRIKYFE.js";
 export {
   WEBDAV_PREFIX,
   checkAuth,

package/hooks/clawvault/HOOK.md

@@ -1,83 +1,83 @@
----
-name: clawvault
-description: "Context resilience - recovery detection, auto-checkpoint, and session context injection"
-metadata:
-  openclaw:
-    emoji: "🐘"
-    events: ["gateway:startup", "gateway:heartbeat", "command:new", "session:start", "compaction:memoryFlush", "cron.weekly"]
-    requires:
-      bins: ["clawvault"]
----
-
-# ClawVault Hook
-
-Integrates ClawVault's context death resilience into OpenClaw:
-
-- **On gateway startup**: Checks for context death, alerts agent
-- **On heartbeat**: Runs cheap threshold checks and observes active sessions when needed
-- **On /new command**: Auto-checkpoints before session reset
-- **On context compaction**: Forces incremental observation flush before context is lost
-- **On session start**: Injects relevant vault context for the initial prompt
-- **On weekly cron**: Runs `clawvault reflect` every Sunday midnight (UTC)
-
-## Installation
-
-```bash
-npm install -g clawvault
-openclaw hooks install clawvault
-openclaw hooks enable clawvault
-
-# Verify
-openclaw hooks list --verbose
-openclaw hooks info clawvault
-openclaw hooks check
-```
-
-After enabling, restart your OpenClaw gateway process so hook registration reloads.
-
-## Requirements
-
-- ClawVault CLI installed globally
-- Vault initialized (`clawvault setup` or `CLAWVAULT_PATH` set)
-
-## What It Does
-
-### Gateway Startup
-
-1. Runs `clawvault recover --clear`
-2. If context death detected, injects warning into first agent turn
-3. Clears dirty death flag for clean session start
-
-### Command: /new
-
-1. Creates automatic checkpoint with session info
-2. Captures state even if agent forgot to handoff
-3. Ensures continuity across session resets
-
-### Session Start
-
-1. Extracts the initial user prompt (`context.initialPrompt` or first user message)
-2. Runs `clawvault context "<prompt>" --format json --profile auto -v <vaultPath>`
-   - Delegates profile selection to the shared context intent policy (`incident`, `planning`, `handoff`, or `default`)
-3. Injects up to 4 relevant context bullets into session messages
-
-Injection format:
-
-```text
-[ClawVault] Relevant context for this task:
-- <title> (<age>): <snippet>
-- <title> (<age>): <snippet>
-```
-
-### Event Compatibility
-
-The hook accepts canonical OpenClaw events (`gateway:startup`, `gateway:heartbeat`, `command:new`, `session:start`, `compaction:memoryFlush`, `cron.weekly`) and tolerates alias payload shapes (`event`, `eventName`, `name`, `hook`, `trigger`) to remain robust across runtime wrappers.
-
-## Configuration Notes
-
-The hook auto-detects vault path via:
-
-1. `CLAWVAULT_PATH` environment variable
-2. Walking up from cwd to find `.clawvault.json`
-
-If `openclaw hooks enable clawvault` fails with hook-not-found, run `openclaw hooks install clawvault` first and verify discovery with `openclaw hooks list --verbose`.
+---
+name: clawvault
+description: "Context resilience - recovery detection, auto-checkpoint, and session context injection"
+metadata:
+  openclaw:
+    emoji: "🐘"
+    events: ["gateway:startup", "gateway:heartbeat", "command:new", "session:start", "compaction:memoryFlush", "cron.weekly"]
+    requires:
+      bins: ["clawvault"]
+---
+
+# ClawVault Hook
+
+Integrates ClawVault's context death resilience into OpenClaw:
+
+- **On gateway startup**: Checks for context death, alerts agent
+- **On heartbeat**: Runs cheap threshold checks and observes active sessions when needed
+- **On /new command**: Auto-checkpoints before session reset
+- **On context compaction**: Forces incremental observation flush before context is lost
+- **On session start**: Injects relevant vault context for the initial prompt
+- **On weekly cron**: Runs `clawvault reflect` every Sunday midnight (UTC)
+
+## Installation
+
+```bash
+npm install -g clawvault
+openclaw hooks install clawvault
+openclaw hooks enable clawvault
+
+# Verify
+openclaw hooks list --verbose
+openclaw hooks info clawvault
+openclaw hooks check
+```
+
+After enabling, restart your OpenClaw gateway process so hook registration reloads.
+
+## Requirements
+
+- ClawVault CLI installed globally
+- Vault initialized (`clawvault setup` or `CLAWVAULT_PATH` set)
+
+## What It Does
+
+### Gateway Startup
+
+1. Runs `clawvault recover --clear`
+2. If context death detected, injects warning into first agent turn
+3. Clears dirty death flag for clean session start
+
+### Command: /new
+
+1. Creates automatic checkpoint with session info
+2. Captures state even if agent forgot to handoff
+3. Ensures continuity across session resets
+
+### Session Start
+
+1. Extracts the initial user prompt (`context.initialPrompt` or first user message)
+2. Runs `clawvault context "<prompt>" --format json --profile auto -v <vaultPath>`
+   - Delegates profile selection to the shared context intent policy (`incident`, `planning`, `handoff`, or `default`)
+3. Injects up to 4 relevant context bullets into session messages
+
+Injection format:
+
+```text
+[ClawVault] Relevant context for this task:
+- <title> (<age>): <snippet>
+- <title> (<age>): <snippet>
+```
+
+### Event Compatibility
+
+The hook accepts canonical OpenClaw events (`gateway:startup`, `gateway:heartbeat`, `command:new`, `session:start`, `compaction:memoryFlush`, `cron.weekly`) and tolerates alias payload shapes (`event`, `eventName`, `name`, `hook`, `trigger`) to remain robust across runtime wrappers.
+
+## Configuration Notes
+
+The hook auto-detects vault path via:
+
+1. `CLAWVAULT_PATH` environment variable
+2. Walking up from cwd to find `.clawvault.json`
+
+If `openclaw hooks enable clawvault` fails with hook-not-found, run `openclaw hooks install clawvault` first and verify discovery with `openclaw hooks list --verbose`.