memorix 1.5.1 → 1.6.0

package/src/cli/commands/task.ts

@@ -1,4 +1,4 @@
-import { defineCommand } from 'citty';
+import { defineCommand } from 'citty';
 import {
   emitError,
   emitResult,
@@ -8,194 +8,194 @@ import {
   resolveCliActorId,
   shortId,
 } from './operator-shared.js';
-
-export default defineCommand({
-  meta: {
-    name: 'task',
-    description: 'Create, claim, complete, and inspect team tasks',
-  },
-  args: {
-    description: { type: 'string', description: 'Task description (for create)' },
-    deps: { type: 'string', description: 'Comma-separated dependency task IDs' },
-    taskId: { type: 'string', description: 'Task ID for claim, complete, fail, or release' },
-    agentId: { type: 'string', description: 'Agent ID for claim, complete, fail, release, or agent-aware list' },
-    result: { type: 'string', description: 'Completion or failure summary' },
-    status: { type: 'string', description: 'Filter by status for list' },
-    available: { type: 'boolean', description: 'Show only claimable tasks' },
-    metadata: { type: 'string', description: 'JSON metadata object for create' },
-    requiredRole: { type: 'string', description: 'Required role for this task' },
-    preferredRole: { type: 'string', description: 'Preferred role for this task' },
-    json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
-  },
-  run: async ({ args }) => {
-    const action = (args._ as string[])?.[0] || '';
-    const asJson = !!args.json;
-
-    try {
+
+export default defineCommand({
+  meta: {
+    name: 'task',
+    description: 'Create, claim, complete, and inspect team tasks',
+  },
+  args: {
+    description: { type: 'string', description: 'Task description (for create)' },
+    deps: { type: 'string', description: 'Comma-separated dependency task IDs' },
+    taskId: { type: 'string', description: 'Task ID for claim, complete, fail, or release' },
+    agentId: { type: 'string', description: 'Agent ID for claim, complete, fail, release, or agent-aware list' },
+    result: { type: 'string', description: 'Completion or failure summary' },
+    status: { type: 'string', description: 'Filter by status for list' },
+    available: { type: 'boolean', description: 'Show only claimable tasks' },
+    metadata: { type: 'string', description: 'JSON metadata object for create' },
+    requiredRole: { type: 'string', description: 'Required role for this task' },
+    preferredRole: { type: 'string', description: 'Preferred role for this task' },
+    json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
+  },
+  run: async ({ args }) => {
+    const action = (args._ as string[])?.[0] || '';
+    const asJson = !!args.json;
+
+    try {
       const { project, teamStore, identity } = await getCliProjectContext();
       const agentId = resolveCliActorId(args.agentId, identity);
-
-      switch (action) {
-        case 'create': {
-          if (!args.description) {
-            emitError('description is required for "memorix task create"', asJson);
-            return;
-          }
-
-          const metadata = parseOptionalJsonObject(args.metadata as string | undefined, 'metadata');
-          if (metadata) {
-            const { checkPipelineGuards } = await import('../../orchestrate/planner.js');
-            const guard = checkPipelineGuards({
-              existingTasks: teamStore.listTasks(project.id),
-              newTaskMeta: metadata,
-            });
-            if (!guard.allowed) {
-              emitError(guard.reason, asJson);
-              return;
-            }
-          }
-
-          const task = teamStore.createTask({
-            projectId: project.id,
-            description: args.description as string,
-            deps: parseCsvList(args.deps as string | undefined),
-            metadata,
+
+      switch (action) {
+        case 'create': {
+          if (!args.description) {
+            emitError('description is required for "memorix task create"', asJson);
+            return;
+          }
+
+          const metadata = parseOptionalJsonObject(args.metadata as string | undefined, 'metadata');
+          if (metadata) {
+            const { checkPipelineGuards } = await import('../../orchestrate/planner.js');
+            const guard = checkPipelineGuards({
+              existingTasks: teamStore.listTasks(project.id),
+              newTaskMeta: metadata,
+            });
+            if (!guard.allowed) {
+              emitError(guard.reason, asJson);
+              return;
+            }
+          }
+
+          const task = teamStore.createTask({
+            projectId: project.id,
+            description: args.description as string,
+            deps: parseCsvList(args.deps as string | undefined),
+            metadata,
             createdBy: agentId,
-            requiredRole: args.requiredRole as string | undefined,
-            preferredRole: args.preferredRole as string | undefined,
-          });
-          const deps = teamStore.getTaskDeps(task.task_id);
-          emitResult(
-            { project, task, deps },
-            `Task created: ${shortId(task.task_id)} "${task.description}"${deps.length > 0 ? ` (${deps.length} dep)` : ''}`,
-            asJson,
-          );
-          return;
-        }
-
-        case 'claim': {
+            requiredRole: args.requiredRole as string | undefined,
+            preferredRole: args.preferredRole as string | undefined,
+          });
+          const deps = teamStore.getTaskDeps(task.task_id);
+          emitResult(
+            { project, task, deps },
+            `Task created: ${shortId(task.task_id)} "${task.description}"${deps.length > 0 ? ` (${deps.length} dep)` : ''}`,
+            asJson,
+          );
+          return;
+        }
+
+        case 'claim': {
           if (!args.taskId || !agentId) {
             emitError('taskId and an active CLI identity or agentId are required for "memorix task claim"', asJson);
             return;
           }
           const result = teamStore.claimTask(args.taskId as string, agentId);
-          if (!result.success) {
-            emitError(result.reason ?? 'Unable to claim task', asJson);
-            return;
-          }
-          emitResult(
-            { project, result },
-            `Task claimed: ${result.task?.description ?? args.taskId}${result.hint ? `\nHint: ${result.hint}` : ''}`,
-            asJson,
-          );
-          return;
-        }
-
-        case 'complete': {
+          if (!result.success) {
+            emitError(result.reason ?? 'Unable to claim task', asJson);
+            return;
+          }
+          emitResult(
+            { project, result },
+            `Task claimed: ${result.task?.description ?? args.taskId}${result.hint ? `\nHint: ${result.hint}` : ''}`,
+            asJson,
+          );
+          return;
+        }
+
+        case 'complete': {
           if (!args.taskId || !agentId || !args.result) {
             emitError('taskId, result, and an active CLI identity or agentId are required for "memorix task complete"', asJson);
             return;
           }
           const result = teamStore.completeTask(args.taskId as string, agentId, args.result as string);
-          if (!result.success) {
-            emitError(result.reason ?? 'Unable to complete task', asJson);
-            return;
-          }
-          emitResult(
-            { project, task: teamStore.getTask(args.taskId as string), result: args.result },
-            `Task completed: ${shortId(args.taskId as string)}`,
-            asJson,
-          );
-          return;
-        }
-
-        case 'fail': {
+          if (!result.success) {
+            emitError(result.reason ?? 'Unable to complete task', asJson);
+            return;
+          }
+          emitResult(
+            { project, task: teamStore.getTask(args.taskId as string), result: args.result },
+            `Task completed: ${shortId(args.taskId as string)}`,
+            asJson,
+          );
+          return;
+        }
+
+        case 'fail': {
           if (!args.taskId || !agentId || !args.result) {
             emitError('taskId, result, and an active CLI identity or agentId are required for "memorix task fail"', asJson);
             return;
           }
           const result = teamStore.failTask(args.taskId as string, agentId, args.result as string);
-          if (!result.success) {
-            emitError(result.reason ?? 'Unable to fail task', asJson);
-            return;
-          }
-          emitResult(
-            { project, task: teamStore.getTask(args.taskId as string), result: args.result },
-            `Task failed: ${shortId(args.taskId as string)}`,
-            asJson,
-          );
-          return;
-        }
-
-        case 'release': {
+          if (!result.success) {
+            emitError(result.reason ?? 'Unable to fail task', asJson);
+            return;
+          }
+          emitResult(
+            { project, task: teamStore.getTask(args.taskId as string), result: args.result },
+            `Task failed: ${shortId(args.taskId as string)}`,
+            asJson,
+          );
+          return;
+        }
+
+        case 'release': {
           if (!args.taskId || !agentId) {
             emitError('taskId and an active CLI identity or agentId are required for "memorix task release"', asJson);
             return;
           }
           const result = teamStore.releaseTask(args.taskId as string, agentId);
-          if (!result.success) {
-            emitError(result.reason ?? 'Unable to release task', asJson);
-            return;
-          }
-          emitResult(
-            { project, task: teamStore.getTask(args.taskId as string) },
-            `Task released: ${shortId(args.taskId as string)}`,
-            asJson,
-          );
-          return;
-        }
-
-        case 'list': {
-          const tasks =
+          if (!result.success) {
+            emitError(result.reason ?? 'Unable to release task', asJson);
+            return;
+          }
+          emitResult(
+            { project, task: teamStore.getTask(args.taskId as string) },
+            `Task released: ${shortId(args.taskId as string)}`,
+            asJson,
+          );
+          return;
+        }
+
+        case 'list': {
+          const tasks =
             args.available && agentId
               ? teamStore.listTasksForAgent(project.id, agentId)
-              : teamStore.listTasks(
-                  project.id,
-                  args.available
-                    ? { available: true }
-                    : args.status
-                      ? { status: args.status as string }
-                      : undefined,
-                );
-          const payload = tasks.map((task) => ({
-            ...task,
-            deps: teamStore.getTaskDeps(task.task_id),
-          }));
-          emitResult(
-            { project, tasks: payload },
-            tasks.length === 0
-              ? 'No tasks found.'
-              : payload
-                  .map((task) => {
-                    const assignee = task.assignee_agent_id
-                      ? teamStore.getAgent(task.assignee_agent_id)?.name ?? shortId(task.assignee_agent_id)
-                      : 'unassigned';
-                    const roleTag = task.required_role
-                      ? `[${task.required_role}${task.preferred_role && task.preferred_role !== task.required_role ? ` -> ${task.preferred_role}` : ''}]`
-                      : task.preferred_role
-                        ? `[~${task.preferred_role}]`
-                        : '';
-                    return `- ${task.status}: ${shortId(task.task_id)} "${task.description}" - ${assignee} ${roleTag}`.trim();
-                  })
-                  .join('\n'),
-            asJson,
-          );
-          return;
-        }
-
-        default:
-          console.log('Memorix Task Commands');
-          console.log('');
-          console.log('Usage:');
-          console.log('  memorix task create --description "..." [--agentId <id>] [--deps id1,id2]');
-          console.log('  memorix task claim --taskId <id> --agentId <id>');
-          console.log('  memorix task complete --taskId <id> --agentId <id> --result "..."');
-          console.log('  memorix task fail --taskId <id> --agentId <id> --result "..."');
-          console.log('  memorix task release --taskId <id> --agentId <id>');
-          console.log('  memorix task list [--status pending|in_progress|completed|failed] [--available --agentId <id>]');
-      }
-    } catch (error) {
-      emitError(error instanceof Error ? error.message : String(error), asJson);
-    }
-  },
-});
+              : teamStore.listTasks(
+                  project.id,
+                  args.available
+                    ? { available: true }
+                    : args.status
+                      ? { status: args.status as string }
+                      : undefined,
+                );
+          const payload = tasks.map((task) => ({
+            ...task,
+            deps: teamStore.getTaskDeps(task.task_id),
+          }));
+          emitResult(
+            { project, tasks: payload },
+            tasks.length === 0
+              ? 'No tasks found.'
+              : payload
+                  .map((task) => {
+                    const assignee = task.assignee_agent_id
+                      ? teamStore.getAgent(task.assignee_agent_id)?.name ?? shortId(task.assignee_agent_id)
+                      : 'unassigned';
+                    const roleTag = task.required_role
+                      ? `[${task.required_role}${task.preferred_role && task.preferred_role !== task.required_role ? ` -> ${task.preferred_role}` : ''}]`
+                      : task.preferred_role
+                        ? `[~${task.preferred_role}]`
+                        : '';
+                    return `- ${task.status}: ${shortId(task.task_id)} "${task.description}" - ${assignee} ${roleTag}`.trim();
+                  })
+                  .join('\n'),
+            asJson,
+          );
+          return;
+        }
+
+        default:
+          console.log('Memorix Task Commands');
+          console.log('');
+          console.log('Usage:');
+          console.log('  memorix task create --description "..." [--agentId <id>] [--deps id1,id2]');
+          console.log('  memorix task claim --taskId <id> --agentId <id>');
+          console.log('  memorix task complete --taskId <id> --agentId <id> --result "..."');
+          console.log('  memorix task fail --taskId <id> --agentId <id> --result "..."');
+          console.log('  memorix task release --taskId <id> --agentId <id>');
+          console.log('  memorix task list [--status pending|in_progress|completed|failed] [--available --agentId <id>]');
+      }
+    } catch (error) {
+      emitError(error instanceof Error ? error.message : String(error), asJson);
+    }
+  },
+});

package/src/cli/commands/transfer.ts

@@ -35,28 +35,28 @@ async function writeExportPayload(projectRoot: string, output: string, payload:
   await fs.writeFile(outputPath, payload, 'utf8');
   return outputPath;
 }
-
-export default defineCommand({
-  meta: {
-    name: 'transfer',
-    description: 'Export or import project memory snapshots',
-  },
-  args: {
+
+export default defineCommand({
+  meta: {
+    name: 'transfer',
+    description: 'Export or import project memory snapshots',
+  },
+  args: {
     format: { type: 'string', description: 'Export format: json or markdown' },
     data: { type: 'string', description: 'JSON payload from a previous export' },
     file: { type: 'string', description: 'File containing a JSON payload to import' },
     stdin: { type: 'boolean', description: 'Read a JSON import payload from standard input' },
     out: { type: 'string', description: 'Write the export payload to this file instead of stdout' },
-    json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
-  },
-  run: async ({ args }) => {
-    const action = (args._ as string[])?.[0] || '';
-    const asJson = !!args.json;
-
-    try {
+    json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
+  },
+  run: async ({ args }) => {
+    const action = (args._ as string[])?.[0] || '';
+    const asJson = !!args.json;
+
+    try {
       const { project, dataDir, reader } = await getCliProjectContext();
-
-      switch (action) {
+
+      switch (action) {
         case 'export': {
           const format = (args.format as string | undefined) === 'markdown' ? 'markdown' : 'json';
           if (format === 'markdown') {
@@ -87,40 +87,40 @@ export default defineCommand({
             serialized,
             asJson,
           );
-          return;
-        }
-
-        case 'import': {
+          return;
+        }
+
+        case 'import': {
           const raw = (await readImportPayload(args as Record<string, unknown>, project.rootPath)).trim();
           if (!raw) throw new Error('Import payload is empty.');
-          let parsed: Parameters<typeof importFromJson>[1];
-          try {
-            parsed = JSON.parse(raw);
-          } catch (error) {
-            emitError(`Invalid JSON import payload: ${error instanceof Error ? error.message : String(error)}`, asJson);
-            return;
-          }
-          const result = await importFromJson(dataDir, parsed);
-          emitResult(
-            { project, result },
-            `Import complete: ${result.observationsImported} observation(s), ${result.sessionsImported} session(s), ${result.skipped} skipped.`,
-            asJson,
-          );
-          return;
-        }
-
-        default:
-          console.log('Memorix Transfer Commands');
-          console.log('');
-          console.log('Usage:');
+          let parsed: Parameters<typeof importFromJson>[1];
+          try {
+            parsed = JSON.parse(raw);
+          } catch (error) {
+            emitError(`Invalid JSON import payload: ${error instanceof Error ? error.message : String(error)}`, asJson);
+            return;
+          }
+          const result = await importFromJson(dataDir, parsed);
+          emitResult(
+            { project, result },
+            `Import complete: ${result.observationsImported} observation(s), ${result.sessionsImported} session(s), ${result.skipped} skipped.`,
+            asJson,
+          );
+          return;
+        }
+
+        default:
+          console.log('Memorix Transfer Commands');
+          console.log('');
+          console.log('Usage:');
           console.log('  memorix transfer export [--format json|markdown] [--out ./.memorix-export.json]');
           console.log('  memorix transfer import --file ./.memorix-export.json');
           console.log('  memorix transfer import --stdin');
           console.log('  memorix transfer import --data "<json>"');
-      }
-    } catch (error) {
-      emitError(error instanceof Error ? error.message : String(error), asJson);
-    }
-  },
-});
-
+      }
+    } catch (error) {
+      emitError(error instanceof Error ? error.message : String(error), asJson);
+    }
+  },
+});
+