brainclaw 0.25.3 → 0.27.0

package/dist/core/registries.js

@@ -0,0 +1,120 @@
+/**
+ * Dedicated registries for project capabilities and tools.
+ *
+ * Replaces the legacy hack of storing capabilities/tools as decisions
+ * with 'capability'/'tool' tags. Items are now persisted as individual
+ * JSON files under discovery/capabilities/ and discovery/tools/.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { resolveEntityDir } from './io.js';
+import { loadVersionedJsonFile, saveVersionedJsonFile } from './migration.js';
+import { ProjectCapabilitySchema, ProjectToolSchema } from './schema.js';
+import { generateIdWithLabel, nowISO } from './ids.js';
+import { appendEvent } from './event-log.js';
+// --- Capabilities ---
+export function listCapabilities(cwd) {
+    const dir = resolveEntityDir('capabilities', cwd, 'read');
+    if (!dir || !fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.json'));
+    const items = [];
+    for (const file of files) {
+        try {
+            const result = loadVersionedJsonFile('capability', path.join(dir, file));
+            items.push(ProjectCapabilitySchema.parse(result.document));
+        }
+        catch {
+            // skip invalid
+        }
+    }
+    return items;
+}
+export function saveCapability(cap, cwd) {
+    const dir = resolveEntityDir('capabilities', cwd, 'write');
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    saveVersionedJsonFile('capability', path.join(dir, `${cap.id}.json`), cap);
+}
+export function deleteCapability(id, cwd) {
+    const dir = resolveEntityDir('capabilities', cwd, 'read');
+    if (!dir)
+        return false;
+    const fp = path.join(dir, `${id}.json`);
+    if (!fs.existsSync(fp))
+        return false;
+    fs.unlinkSync(fp);
+    return true;
+}
+export function createCapability(opts, cwd) {
+    const idObj = generateIdWithLabel('cap');
+    const cap = {
+        id: idObj.id,
+        name: opts.name,
+        description: opts.description,
+        category: opts.category ?? 'general',
+        tags: opts.tags ?? [],
+        status: 'stable',
+        created_at: nowISO(),
+        author: opts.author,
+        author_id: opts.authorId,
+        model: opts.model,
+    };
+    saveCapability(cap, cwd);
+    appendEvent({ action: 'create', item_type: 'decision', item_id: cap.id, agent: opts.author, agent_id: opts.authorId, summary: `capability: ${opts.name}` }, cwd);
+    return cap;
+}
+// --- Tools ---
+export function listTools(cwd) {
+    const dir = resolveEntityDir('tools', cwd, 'read');
+    if (!dir || !fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.json'));
+    const items = [];
+    for (const file of files) {
+        try {
+            const result = loadVersionedJsonFile('tool', path.join(dir, file));
+            items.push(ProjectToolSchema.parse(result.document));
+        }
+        catch {
+            // skip invalid
+        }
+    }
+    return items;
+}
+export function saveTool(tool, cwd) {
+    const dir = resolveEntityDir('tools', cwd, 'write');
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    saveVersionedJsonFile('tool', path.join(dir, `${tool.id}.json`), tool);
+}
+export function deleteTool(id, cwd) {
+    const dir = resolveEntityDir('tools', cwd, 'read');
+    if (!dir)
+        return false;
+    const fp = path.join(dir, `${id}.json`);
+    if (!fs.existsSync(fp))
+        return false;
+    fs.unlinkSync(fp);
+    return true;
+}
+export function createTool(opts, cwd) {
+    const idObj = generateIdWithLabel('tol');
+    const tool = {
+        id: idObj.id,
+        name: opts.name,
+        description: opts.description,
+        type: (opts.type ?? 'utility'),
+        implementation: opts.implementation ?? '',
+        tags: opts.tags ?? [],
+        status: 'stable',
+        created_at: nowISO(),
+        author: opts.author,
+        author_id: opts.authorId,
+        model: opts.model,
+    };
+    saveTool(tool, cwd);
+    appendEvent({ action: 'create', item_type: 'decision', item_id: tool.id, agent: opts.author, agent_id: opts.authorId, summary: `tool: ${opts.name}` }, cwd);
+    return tool;
+}
+//# sourceMappingURL=registries.js.map

package/dist/core/schema.js

@@ -42,6 +42,7 @@ export const PrioritySchema = z.enum(['low', 'medium', 'high']);
 export const MemoryVisibilitySchema = z.enum(['shared', 'machine', 'private']);
 export const HandoffStatusSchema = z.enum(['open', 'accepted', 'closed']);
 export const DecisionOutcomeSchema = z.enum(['approved', 'rejected', 'deferred', 'pending']);
+export const MemoryScopeSchema = z.enum(['project', 'machine', 'user']).default('project');
 export const ConstraintSchema = z.object({
     schema_version: z.number().int().positive().optional(),
     id: z.string(),
@@ -56,6 +57,7 @@ export const ConstraintSchema = z.object({
     session_id: z.string().optional(),
     status: ConstraintStatusSchema,
     category: ConstraintCategorySchema.optional(),
+    scope: MemoryScopeSchema.optional(),
     tags: z.array(z.string()),
     related_paths: z.array(z.string()).optional(),
     expires_at: z.string().optional(),
@@ -73,6 +75,7 @@ export const DecisionSchema = z.object({
     host_id: z.string().optional(),
     session_id: z.string().optional(),
     outcome: DecisionOutcomeSchema.optional(),
+    scope: MemoryScopeSchema.optional(),
     related_paths: z.array(z.string()).optional(),
     plan_id: z.string().optional(),
     tags: z.array(z.string()),
@@ -90,6 +93,7 @@ export const TrapSchema = z.object({
     session_id: z.string().optional(),
     status: TrapStatusSchema.default('active'),
     severity: SeveritySchema,
+    scope: MemoryScopeSchema.optional(),
     tags: z.array(z.string()),
     related_paths: z.array(z.string()).optional(),
     plan_id: z.string().optional(),
@@ -122,10 +126,11 @@ export const HandoffSchema = z.object({
     }).optional(),
 });
 export const PlanStatusSchema = z.enum(['todo', 'in_progress', 'blocked', 'done', 'dropped']);
+export const PlanStepStatusSchema = z.enum(['todo', 'in_progress', 'testing', 'done', 'blocked']);
 export const PlanStepSchema = z.object({
     id: z.string(),
     text: z.string(),
-    status: z.enum(['todo', 'done']),
+    status: PlanStepStatusSchema.default('todo'),
     assignee: z.string().optional(),
     created_at: z.string(),
     updated_at: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainclaw",
-  "version": "0.25.3",
+  "version": "0.27.0",
   "description": "Shared project memory for humans and coding agents.",
   "type": "module",
   "bin": {
@@ -13,6 +13,12 @@
     "README.md",
     "LICENSE"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsc && node dist/cli.js",