clawvault 3.2.0 → 3.3.0

package/dist/chunk-WMGIIABP.js

@@ -1,15 +0,0 @@
-// src/workgraph/types.ts
-var THREAD_STATUS_TRANSITIONS = {
-  open: ["active", "cancelled"],
-  active: ["blocked", "done", "cancelled", "open"],
-  // open = release
-  blocked: ["active", "cancelled"],
-  done: [],
-  // terminal
-  cancelled: ["open"]
-  // can be reopened
-};
-
-export {
-  THREAD_STATUS_TRANSITIONS
-};

package/dist/commands/workgraph.d.ts

@@ -1,124 +0,0 @@
-import { Command } from 'commander';
-
-/**
- * Workgraph CLI commands — agent-native coordination tools.
- *
- * Commands under 'clawvault wg' namespace:
- *   - wg status         Agent morning briefing with rich terminal output
- *   - wg thread create  Create a new thread
- *   - wg thread list    List threads with filters
- *   - wg thread claim   Claim a thread for work
- *   - wg thread done    Mark thread complete
- *   - wg thread block   Block thread on dependency
- *   - wg thread release Release thread back to pool
- *   - wg thread decompose  Break thread into sub-threads
- *   - wg ledger         View coordination history
- *   - wg define         Define new primitive type
- *   - wg types          List all primitive types
- *   - wg create         Create any primitive
- *   - wg board          Terminal kanban board
- */
-
-/**
- * Agent morning briefing with rich terminal output.
- */
-declare function statusCommand(vaultPath: string): Promise<void>;
-interface ThreadCreateOptions {
-    goal?: string;
-    priority?: string;
-    deps?: string;
-    tags?: string;
-}
-/**
- * Create a new thread.
- */
-declare function threadCreateCommand(vaultPath: string, title: string, options: ThreadCreateOptions): Promise<void>;
-interface ThreadListOptions {
-    status?: string;
-    owner?: string;
-    json?: boolean;
-}
-/**
- * List threads with filters.
- */
-declare function threadListCommand(vaultPath: string, options: ThreadListOptions): Promise<void>;
-/**
- * Claim a thread and show work brief.
- */
-declare function threadClaimCommand(vaultPath: string, threadPath: string): Promise<void>;
-interface ThreadDoneOptions {
-    output?: string;
-}
-/**
- * Mark thread as complete.
- */
-declare function threadDoneCommand(vaultPath: string, threadPath: string, options: ThreadDoneOptions): Promise<void>;
-interface ThreadBlockOptions {
-    by: string;
-    reason?: string;
-}
-/**
- * Block thread on dependency.
- */
-declare function threadBlockCommand(vaultPath: string, threadPath: string, options: ThreadBlockOptions): Promise<void>;
-interface ThreadReleaseOptions {
-    reason?: string;
-}
-/**
- * Release thread back to pool.
- */
-declare function threadReleaseCommand(vaultPath: string, threadPath: string, options: ThreadReleaseOptions): Promise<void>;
-interface ThreadDecomposeOptions {
-    into: string[];
-}
-/**
- * Break thread into sub-threads.
- */
-declare function threadDecomposeCommand(vaultPath: string, threadPath: string, options: ThreadDecomposeOptions): Promise<void>;
-interface LedgerOptions {
-    last?: number;
-    actor?: string;
-    target?: string;
-    json?: boolean;
-}
-/**
- * View coordination history.
- */
-declare function ledgerCommand(vaultPath: string, options: LedgerOptions): Promise<void>;
-interface DefineOptions {
-    fields?: string;
-    dir?: string;
-    description?: string;
-}
-/**
- * Define a new primitive type.
- */
-declare function defineCommand(vaultPath: string, typeName: string, options: DefineOptions): Promise<void>;
-interface TypesOptions {
-    json?: boolean;
-}
-/**
- * List all primitive types.
- */
-declare function typesCommand(vaultPath: string, options: TypesOptions): Promise<void>;
-interface CreateOptions {
-    body?: string;
-    [key: string]: string | undefined;
-}
-/**
- * Create any primitive instance.
- */
-declare function createCommand(vaultPath: string, typeName: string, title: string, options: CreateOptions): Promise<void>;
-interface BoardOptions {
-    width?: number;
-}
-/**
- * Terminal kanban board with box-drawing characters.
- */
-declare function boardCommand(vaultPath: string, options: BoardOptions): Promise<void>;
-/**
- * Register all workgraph commands under the 'wg' namespace.
- */
-declare function registerWorkgraphCommands(program: Command): void;
-
-export { type BoardOptions, type CreateOptions, type DefineOptions, type LedgerOptions, type ThreadBlockOptions, type ThreadCreateOptions, type ThreadDecomposeOptions, type ThreadDoneOptions, type ThreadListOptions, type ThreadReleaseOptions, type TypesOptions, boardCommand, createCommand, defineCommand, ledgerCommand, registerWorkgraphCommands, statusCommand, threadBlockCommand, threadClaimCommand, threadCreateCommand, threadDecomposeCommand, threadDoneCommand, threadListCommand, threadReleaseCommand, typesCommand };

package/dist/commands/workgraph.js

@@ -1,38 +0,0 @@
-import {
-  boardCommand,
-  createCommand,
-  defineCommand,
-  ledgerCommand,
-  registerWorkgraphCommands,
-  statusCommand,
-  threadBlockCommand,
-  threadClaimCommand,
-  threadCreateCommand,
-  threadDecomposeCommand,
-  threadDoneCommand,
-  threadListCommand,
-  threadReleaseCommand,
-  typesCommand
-} from "../chunk-GGA32J2R.js";
-import "../chunk-VSL7KY3M.js";
-import "../chunk-QVEERJSP.js";
-import "../chunk-4BQTQMJP.js";
-import "../chunk-MM6QGW3P.js";
-import "../chunk-WMGIIABP.js";
-import "../chunk-2ZDO52B4.js";
-export {
-  boardCommand,
-  createCommand,
-  defineCommand,
-  ledgerCommand,
-  registerWorkgraphCommands,
-  statusCommand,
-  threadBlockCommand,
-  threadClaimCommand,
-  threadCreateCommand,
-  threadDecomposeCommand,
-  threadDoneCommand,
-  threadListCommand,
-  threadReleaseCommand,
-  typesCommand
-};

package/dist/ledger-B7g7jhqG.d.ts

@@ -1,44 +0,0 @@
-import { LedgerEntry, LedgerOp } from './workgraph/types.js';
-
-/**
- * Append-only event ledger.
- *
- * Every mutation to the workgraph is logged here. This is the source of truth
- * for coordination: who claimed what, when, and what's available.
- *
- * Format: one JSON object per line (.jsonl) in `.clawvault/ledger.jsonl`.
- * Agents read the ledger to know the state of the world.
- */
-
-declare function ledgerPath(vaultPath: string): string;
-declare function append(vaultPath: string, actor: string, op: LedgerOp, target: string, type?: string, data?: Record<string, unknown>): LedgerEntry;
-declare function readAll(vaultPath: string): LedgerEntry[];
-declare function readSince(vaultPath: string, since: string): LedgerEntry[];
-/** Get the current owner of a target (last claim without a subsequent release/done). */
-declare function currentOwner(vaultPath: string, target: string): string | null;
-/** Check if a target is currently claimed by any agent. */
-declare function isClaimed(vaultPath: string, target: string): boolean;
-/** Get all entries for a specific target. */
-declare function historyOf(vaultPath: string, target: string): LedgerEntry[];
-/** Get all entries by a specific actor. */
-declare function activityOf(vaultPath: string, actor: string): LedgerEntry[];
-/** Get all currently claimed targets and their owners. */
-declare function allClaims(vaultPath: string): Map<string, string>;
-/** Get recent ledger entries (last N). */
-declare function recent(vaultPath: string, count?: number): LedgerEntry[];
-
-declare const ledger_activityOf: typeof activityOf;
-declare const ledger_allClaims: typeof allClaims;
-declare const ledger_append: typeof append;
-declare const ledger_currentOwner: typeof currentOwner;
-declare const ledger_historyOf: typeof historyOf;
-declare const ledger_isClaimed: typeof isClaimed;
-declare const ledger_ledgerPath: typeof ledgerPath;
-declare const ledger_readAll: typeof readAll;
-declare const ledger_readSince: typeof readSince;
-declare const ledger_recent: typeof recent;
-declare namespace ledger {
-  export { ledger_activityOf as activityOf, ledger_allClaims as allClaims, ledger_append as append, ledger_currentOwner as currentOwner, ledger_historyOf as historyOf, ledger_isClaimed as isClaimed, ledger_ledgerPath as ledgerPath, ledger_readAll as readAll, ledger_readSince as readSince, ledger_recent as recent };
-}
-
-export { activityOf as a, allClaims as b, append as c, currentOwner as d, ledgerPath as e, readSince as f, recent as g, historyOf as h, isClaimed as i, ledger as l, readAll as r };

package/dist/registry-BR4326o0.d.ts

@@ -1,30 +0,0 @@
-import { FieldDefinition, PrimitiveTypeDefinition, Registry } from './workgraph/types.js';
-
-/**
- * Dynamic primitive type registry.
- *
- * Agents can define new primitive types at runtime. The registry is stored
- * as `.clawvault/registry.json` in the vault. Built-in types are seeded on
- * first access and cannot be deleted (but CAN be extended with new fields).
- */
-
-declare function registryPath(vaultPath: string): string;
-declare function loadRegistry(vaultPath: string): Registry;
-declare function saveRegistry(vaultPath: string, registry: Registry): void;
-declare function defineType(vaultPath: string, name: string, description: string, fields: Record<string, FieldDefinition>, actor: string, directory?: string): PrimitiveTypeDefinition;
-declare function getType(vaultPath: string, name: string): PrimitiveTypeDefinition | undefined;
-declare function listTypes(vaultPath: string): PrimitiveTypeDefinition[];
-declare function extendType(vaultPath: string, name: string, newFields: Record<string, FieldDefinition>, actor: string): PrimitiveTypeDefinition;
-
-declare const registry_defineType: typeof defineType;
-declare const registry_extendType: typeof extendType;
-declare const registry_getType: typeof getType;
-declare const registry_listTypes: typeof listTypes;
-declare const registry_loadRegistry: typeof loadRegistry;
-declare const registry_registryPath: typeof registryPath;
-declare const registry_saveRegistry: typeof saveRegistry;
-declare namespace registry {
-  export { registry_defineType as defineType, registry_extendType as extendType, registry_getType as getType, registry_listTypes as listTypes, registry_loadRegistry as loadRegistry, registry_registryPath as registryPath, registry_saveRegistry as saveRegistry };
-}
-
-export { loadRegistry as a, registryPath as b, defineType as d, extendType as e, getType as g, listTypes as l, registry as r, saveRegistry as s };

package/dist/store-CA-6sKCJ.d.ts

@@ -1,34 +0,0 @@
-import { PrimitiveInstance } from './workgraph/types.js';
-
-/**
- * Workgraph store — CRUD for primitive instances.
- *
- * Primitives are markdown files with YAML frontmatter. The store reads/writes
- * them and logs every mutation to the ledger. Schemas are soft: unknown fields
- * are preserved, missing optional fields get defaults.
- */
-
-declare function create(vaultPath: string, typeName: string, fields: Record<string, unknown>, body: string, actor: string): PrimitiveInstance;
-declare function read(vaultPath: string, relPath: string): PrimitiveInstance | null;
-declare function list(vaultPath: string, typeName: string): PrimitiveInstance[];
-declare function update(vaultPath: string, relPath: string, fieldUpdates: Record<string, unknown>, bodyUpdate: string | undefined, actor: string): PrimitiveInstance;
-declare function remove(vaultPath: string, relPath: string, actor: string): void;
-declare function findByField(vaultPath: string, typeName: string, field: string, value: unknown): PrimitiveInstance[];
-declare function openThreads(vaultPath: string): PrimitiveInstance[];
-declare function activeThreads(vaultPath: string): PrimitiveInstance[];
-declare function blockedThreads(vaultPath: string): PrimitiveInstance[];
-
-declare const store_activeThreads: typeof activeThreads;
-declare const store_blockedThreads: typeof blockedThreads;
-declare const store_create: typeof create;
-declare const store_findByField: typeof findByField;
-declare const store_list: typeof list;
-declare const store_openThreads: typeof openThreads;
-declare const store_read: typeof read;
-declare const store_remove: typeof remove;
-declare const store_update: typeof update;
-declare namespace store {
-  export { store_activeThreads as activeThreads, store_blockedThreads as blockedThreads, store_create as create, store_findByField as findByField, store_list as list, store_openThreads as openThreads, store_read as read, store_remove as remove, store_update as update };
-}
-
-export { activeThreads as a, blockedThreads as b, create as c, remove as d, findByField as f, list as l, openThreads as o, read as r, store as s, update as u };

package/dist/thread-B9LhXNU0.d.ts

@@ -1,41 +0,0 @@
-import { PrimitiveInstance } from './workgraph/types.js';
-
-/**
- * Thread lifecycle operations.
- *
- * Threads are the core coordination primitive. This module handles the
- * claim/release/block/done lifecycle with ledger-backed exclusivity.
- */
-
-declare function createThread(vaultPath: string, title: string, goal: string, actor: string, opts?: {
-    priority?: string;
-    deps?: string[];
-    parent?: string;
-    context_refs?: string[];
-    tags?: string[];
-}): PrimitiveInstance;
-declare function claim(vaultPath: string, threadPath: string, actor: string): PrimitiveInstance;
-declare function release(vaultPath: string, threadPath: string, actor: string, reason?: string): PrimitiveInstance;
-declare function block(vaultPath: string, threadPath: string, actor: string, blockedBy: string, reason?: string): PrimitiveInstance;
-declare function unblock(vaultPath: string, threadPath: string, actor: string): PrimitiveInstance;
-declare function done(vaultPath: string, threadPath: string, actor: string, output?: string): PrimitiveInstance;
-declare function cancel(vaultPath: string, threadPath: string, actor: string, reason?: string): PrimitiveInstance;
-declare function decompose(vaultPath: string, parentPath: string, subthreads: Array<{
-    title: string;
-    goal: string;
-    deps?: string[];
-}>, actor: string): PrimitiveInstance[];
-
-declare const thread_block: typeof block;
-declare const thread_cancel: typeof cancel;
-declare const thread_claim: typeof claim;
-declare const thread_createThread: typeof createThread;
-declare const thread_decompose: typeof decompose;
-declare const thread_done: typeof done;
-declare const thread_release: typeof release;
-declare const thread_unblock: typeof unblock;
-declare namespace thread {
-  export { thread_block as block, thread_cancel as cancel, thread_claim as claim, thread_createThread as createThread, thread_decompose as decompose, thread_done as done, thread_release as release, thread_unblock as unblock };
-}
-
-export { claim as a, block as b, cancel as c, createThread as d, decompose as e, done as f, release as r, thread as t, unblock as u };

package/dist/workgraph/index.d.ts

@@ -1,5 +0,0 @@
-export { FieldDefinition, LedgerEntry, LedgerOp, PrimitiveInstance, PrimitiveTypeDefinition, Registry, THREAD_STATUS_TRANSITIONS, ThreadStatus } from './types.js';
-export { r as registry } from '../registry-BR4326o0.js';
-export { l as ledger } from '../ledger-B7g7jhqG.js';
-export { s as store } from '../store-CA-6sKCJ.js';
-export { t as thread } from '../thread-B9LhXNU0.js';

package/dist/workgraph/index.js

@@ -1,23 +0,0 @@
-import {
-  thread_exports
-} from "../chunk-VSL7KY3M.js";
-import {
-  store_exports
-} from "../chunk-QVEERJSP.js";
-import {
-  ledger_exports
-} from "../chunk-4BQTQMJP.js";
-import {
-  registry_exports
-} from "../chunk-MM6QGW3P.js";
-import {
-  THREAD_STATUS_TRANSITIONS
-} from "../chunk-WMGIIABP.js";
-import "../chunk-2ZDO52B4.js";
-export {
-  THREAD_STATUS_TRANSITIONS,
-  ledger_exports as ledger,
-  registry_exports as registry,
-  store_exports as store,
-  thread_exports as thread
-};

package/dist/workgraph/ledger.d.ts

@@ -1,2 +0,0 @@
-import './types.js';
-export { a as activityOf, b as allClaims, c as append, d as currentOwner, h as historyOf, i as isClaimed, e as ledgerPath, r as readAll, f as readSince, g as recent } from '../ledger-B7g7jhqG.js';

package/dist/workgraph/ledger.js

@@ -1,25 +0,0 @@
-import {
-  activityOf,
-  allClaims,
-  append,
-  currentOwner,
-  historyOf,
-  isClaimed,
-  ledgerPath,
-  readAll,
-  readSince,
-  recent
-} from "../chunk-4BQTQMJP.js";
-import "../chunk-2ZDO52B4.js";
-export {
-  activityOf,
-  allClaims,
-  append,
-  currentOwner,
-  historyOf,
-  isClaimed,
-  ledgerPath,
-  readAll,
-  readSince,
-  recent
-};

package/dist/workgraph/registry.d.ts

@@ -1,2 +0,0 @@
-import './types.js';
-export { d as defineType, e as extendType, g as getType, l as listTypes, a as loadRegistry, b as registryPath, s as saveRegistry } from '../registry-BR4326o0.js';

package/dist/workgraph/registry.js

@@ -1,19 +0,0 @@
-import {
-  defineType,
-  extendType,
-  getType,
-  listTypes,
-  loadRegistry,
-  registryPath,
-  saveRegistry
-} from "../chunk-MM6QGW3P.js";
-import "../chunk-2ZDO52B4.js";
-export {
-  defineType,
-  extendType,
-  getType,
-  listTypes,
-  loadRegistry,
-  registryPath,
-  saveRegistry
-};

package/dist/workgraph/store.d.ts

@@ -1,2 +0,0 @@
-import './types.js';
-export { a as activeThreads, b as blockedThreads, c as create, f as findByField, l as list, o as openThreads, r as read, d as remove, u as update } from '../store-CA-6sKCJ.js';

package/dist/workgraph/store.js

@@ -1,25 +0,0 @@
-import {
-  activeThreads,
-  blockedThreads,
-  create,
-  findByField,
-  list,
-  openThreads,
-  read,
-  remove,
-  update
-} from "../chunk-QVEERJSP.js";
-import "../chunk-4BQTQMJP.js";
-import "../chunk-MM6QGW3P.js";
-import "../chunk-2ZDO52B4.js";
-export {
-  activeThreads,
-  blockedThreads,
-  create,
-  findByField,
-  list,
-  openThreads,
-  read,
-  remove,
-  update
-};

package/dist/workgraph/thread.d.ts

@@ -1,2 +0,0 @@
-import './types.js';
-export { b as block, c as cancel, a as claim, d as createThread, e as decompose, f as done, r as release, u as unblock } from '../thread-B9LhXNU0.js';

package/dist/workgraph/thread.js

@@ -1,25 +0,0 @@
-import {
-  block,
-  cancel,
-  claim,
-  createThread,
-  decompose,
-  done,
-  release,
-  unblock
-} from "../chunk-VSL7KY3M.js";
-import "../chunk-QVEERJSP.js";
-import "../chunk-4BQTQMJP.js";
-import "../chunk-MM6QGW3P.js";
-import "../chunk-WMGIIABP.js";
-import "../chunk-2ZDO52B4.js";
-export {
-  block,
-  cancel,
-  claim,
-  createThread,
-  decompose,
-  done,
-  release,
-  unblock
-};

package/dist/workgraph/types.d.ts

@@ -1,54 +0,0 @@
-/**
- * Workgraph type definitions.
- *
- * Three layers:
- *   1. Registry  — what primitive types exist (agent-extensible)
- *   2. Ledger    — what happened (append-only, source of truth for claims/state)
- *   3. Store     — the actual markdown files (the primitives themselves)
- */
-interface FieldDefinition {
-    type: 'string' | 'number' | 'boolean' | 'list' | 'date' | 'ref' | 'any';
-    required?: boolean;
-    default?: unknown;
-    description?: string;
-}
-interface PrimitiveTypeDefinition {
-    name: string;
-    description: string;
-    fields: Record<string, FieldDefinition>;
-    /** Directory under vault root where instances live (default: `<name>s/`). */
-    directory: string;
-    /** Whether this type was defined by an agent at runtime vs built-in. */
-    builtIn: boolean;
-    /** ISO timestamp of when this type was registered. */
-    createdAt: string;
-    /** Who registered it (agent name or "system"). */
-    createdBy: string;
-}
-interface Registry {
-    version: number;
-    types: Record<string, PrimitiveTypeDefinition>;
-}
-type LedgerOp = 'create' | 'update' | 'delete' | 'claim' | 'release' | 'block' | 'unblock' | 'done' | 'cancel' | 'define' | 'decompose';
-interface LedgerEntry {
-    ts: string;
-    actor: string;
-    op: LedgerOp;
-    target: string;
-    type?: string;
-    data?: Record<string, unknown>;
-}
-type ThreadStatus = 'open' | 'active' | 'blocked' | 'done' | 'cancelled';
-declare const THREAD_STATUS_TRANSITIONS: Record<ThreadStatus, ThreadStatus[]>;
-interface PrimitiveInstance {
-    /** File path relative to vault root. */
-    path: string;
-    /** Primitive type name. */
-    type: string;
-    /** Frontmatter fields. */
-    fields: Record<string, unknown>;
-    /** Markdown body content. */
-    body: string;
-}
-
-export { type FieldDefinition, type LedgerEntry, type LedgerOp, type PrimitiveInstance, type PrimitiveTypeDefinition, type Registry, THREAD_STATUS_TRANSITIONS, type ThreadStatus };

package/dist/workgraph/types.js

@@ -1,7 +0,0 @@
-import {
-  THREAD_STATUS_TRANSITIONS
-} from "../chunk-WMGIIABP.js";
-import "../chunk-2ZDO52B4.js";
-export {
-  THREAD_STATUS_TRANSITIONS
-};