memorix 1.4.3 → 1.4.4

package/src/cli/commands/hooks-status.ts

@@ -1,71 +1,71 @@
-/**
- * CLI Command: memorix hooks status
- *
- * Show hook installation status for all agents.
+/**
+ * CLI Command: memorix hooks status
+ *
+ * Show hook installation status for all agents.
  * Status marks:
  *   [OK]  - installed and verified (config-based agent, file read directly)
  *   [??]  - installed but unverified (plugin-based agent, runtime load not confirmed)
  *   [!!]  - installed but outdated
  *   [ ]   - not installed
- */
-
-import { defineCommand } from 'citty';
-
-export default defineCommand({
-  meta: {
-    name: 'status',
-    description: 'Show hook installation status for all agents',
-  },
-  run: async () => {
-    const { getHookStatus } = await import('../../hooks/installers/index.js');
-    const { AGENT_SUPPORT_TIER } = await import('../../hooks/types.js');
-    const os = await import('node:os');
-    let cwd: string;
-    try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
-
-    const statuses = await getHookStatus(cwd);
-
-    console.log('\nMemorix Hooks Status');
+ */
+
+import { defineCommand } from 'citty';
+
+export default defineCommand({
+  meta: {
+    name: 'status',
+    description: 'Show hook installation status for all agents',
+  },
+  run: async () => {
+    const { getHookStatus } = await import('../../hooks/installers/index.js');
+    const { AGENT_SUPPORT_TIER } = await import('../../hooks/types.js');
+    const os = await import('node:os');
+    let cwd: string;
+    try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
+
+    const statuses = await getHookStatus(cwd);
+
+    console.log('\nMemorix Hooks Status');
     console.log('-'.repeat(50));
-
-    let hasOutdated = false;
-    let hasUnverified = false;
-    let hasRuntimeIssue = false;
-    for (const { agent, installed, outdated, verified, runtimeReady, configPath } of statuses) {
-      const icon = installed
-        ? (!runtimeReady ? '[!!]' : (outdated ? '[!!]' : (verified ? '[OK]' : '[??]')))
-        : '[ ]';
-      const label = agent.charAt(0).toUpperCase() + agent.slice(1);
-      const tier = AGENT_SUPPORT_TIER[agent];
+
+    let hasOutdated = false;
+    let hasUnverified = false;
+    let hasRuntimeIssue = false;
+    for (const { agent, installed, outdated, verified, runtimeReady, configPath } of statuses) {
+      const icon = installed
+        ? (!runtimeReady ? '[!!]' : (outdated ? '[!!]' : (verified ? '[OK]' : '[??]')))
+        : '[ ]';
+      const label = agent.charAt(0).toUpperCase() + agent.slice(1);
+      const tier = AGENT_SUPPORT_TIER[agent];
       const tierLabel = tier === 'core' ? '[core]' : tier === 'extended' ? '[extended]' : '[community]';
-      const suffix = !runtimeReady && installed
-        ? ' (installed but runtime NOT ready — missing pwsh on Windows)'
-        : outdated
-          ? ' (outdated - re-run `memorix hooks install`)'
-          : (!verified && installed ? ' (plugin file installed, runtime load unverified)' : '');
-      console.log(`${icon} ${tierLabel} ${label.padEnd(12)} ${installed ? configPath + suffix : '(not installed)'}`);
-      if (outdated) hasOutdated = true;
-      if (!verified && installed) hasUnverified = true;
-      if (!runtimeReady && installed) hasRuntimeIssue = true;
-    }
-
+      const suffix = !runtimeReady && installed
+        ? ' (installed but runtime NOT ready — missing pwsh on Windows)'
+        : outdated
+          ? ' (outdated - re-run `memorix hooks install`)'
+          : (!verified && installed ? ' (plugin file installed, runtime load unverified)' : '');
+      console.log(`${icon} ${tierLabel} ${label.padEnd(12)} ${installed ? configPath + suffix : '(not installed)'}`);
+      if (outdated) hasOutdated = true;
+      if (!verified && installed) hasUnverified = true;
+      if (!runtimeReady && installed) hasRuntimeIssue = true;
+    }
+
     console.log('\nSupport tiers: [core] core | [extended] extended | [community] community');
-
-    if (hasOutdated) {
-      console.log('\n[warn] Outdated hooks detected. Run `memorix hooks install` to update.');
-    }
-    if (hasUnverified) {
-      console.log('\n[info] [??] = plugin file installed but runtime load unverified.');
-      console.log('       For OpenCode: verify by running `opencode --log-level DEBUG` and checking');
-      console.log('       for [memorix-plugin] messages in the log output.');
-    }
-    if (hasRuntimeIssue) {
-      console.log('\n[warn] [!!] = installed but runtime will fail.');
-      console.log('       Copilot on Windows requires PowerShell v6+ (pwsh.exe) for hook execution.');
-      console.log('       Install pwsh: https://learn.microsoft.com/powershell/scripting/install/installing-powershell');
-      console.log('       Without pwsh, Copilot hooks will fail at runtime with "spawn pwsh.exe ENOENT".');
-    }
-
-    console.log('\nRun `memorix hooks install` to set up hooks for detected agents.');
-  },
-});
+
+    if (hasOutdated) {
+      console.log('\n[warn] Outdated hooks detected. Run `memorix hooks install` to update.');
+    }
+    if (hasUnverified) {
+      console.log('\n[info] [??] = plugin file installed but runtime load unverified.');
+      console.log('       For OpenCode: verify by running `opencode --log-level DEBUG` and checking');
+      console.log('       for [memorix-plugin] messages in the log output.');
+    }
+    if (hasRuntimeIssue) {
+      console.log('\n[warn] [!!] = installed but runtime will fail.');
+      console.log('       Copilot on Windows requires PowerShell v6+ (pwsh.exe) for hook execution.');
+      console.log('       Install pwsh: https://learn.microsoft.com/powershell/scripting/install/installing-powershell');
+      console.log('       Without pwsh, Copilot hooks will fail at runtime with "spawn pwsh.exe ENOENT".');
+    }
+
+    console.log('\nRun `memorix hooks install` to set up hooks for detected agents.');
+  },
+});

package/src/cli/commands/ingest.ts

@@ -1,44 +1,44 @@
-/**
- * CLI Command: memorix ingest
- *
- * Parent command for Git→Memory and image ingestion.
- */
-
-import { defineCommand } from 'citty';
-
-export default defineCommand({
-  meta: {
-    name: 'ingest',
-    description: 'Ingest engineering knowledge from Git and images',
-  },
-  subCommands: {
-    commit: () => import('./ingest-commit.js').then((module) => module.default),
-    log: () => import('./ingest-log.js').then((module) => module.default),
-    image: () => import('./ingest-image.js').then((module) => module.default),
-  },
-  run: async ({ args }) => {
-    const action = (args._ as string[])?.[0] || '';
-    if (action === 'commit') {
-      const module = await import('./ingest-commit.js');
-      await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
-      return;
-    }
-    if (action === 'log') {
-      const module = await import('./ingest-log.js');
-      await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
-      return;
-    }
-    if (action === 'image') {
-      const module = await import('./ingest-image.js');
-      await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
-      return;
-    }
-
-    console.log('Memorix Ingest Commands');
-    console.log('');
-    console.log('Usage:');
-    console.log('  memorix ingest commit [--ref HEAD]');
-    console.log('  memorix ingest log [--count 10]');
-    console.log('  memorix ingest image --path ./diagram.png');
-  },
-});
+/**
+ * CLI Command: memorix ingest
+ *
+ * Parent command for Git→Memory and image ingestion.
+ */
+
+import { defineCommand } from 'citty';
+
+export default defineCommand({
+  meta: {
+    name: 'ingest',
+    description: 'Ingest engineering knowledge from Git and images',
+  },
+  subCommands: {
+    commit: () => import('./ingest-commit.js').then((module) => module.default),
+    log: () => import('./ingest-log.js').then((module) => module.default),
+    image: () => import('./ingest-image.js').then((module) => module.default),
+  },
+  run: async ({ args }) => {
+    const action = (args._ as string[])?.[0] || '';
+    if (action === 'commit') {
+      const module = await import('./ingest-commit.js');
+      await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
+      return;
+    }
+    if (action === 'log') {
+      const module = await import('./ingest-log.js');
+      await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
+      return;
+    }
+    if (action === 'image') {
+      const module = await import('./ingest-image.js');
+      await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
+      return;
+    }
+
+    console.log('Memorix Ingest Commands');
+    console.log('');
+    console.log('Usage:');
+    console.log('  memorix ingest commit [--ref HEAD]');
+    console.log('  memorix ingest log [--count 10]');
+    console.log('  memorix ingest image --path ./diagram.png');
+  },
+});

package/src/cli/commands/integrate-shared.ts

@@ -1,15 +1,15 @@
-import { homedir } from 'node:os';
-
-export function getIntegrationTargetRoot(
-  useGlobalDefaults: boolean,
-  cwd: string,
-  homeDir = homedir(),
-): string {
-  return useGlobalDefaults ? homeDir : cwd;
-}
-
-export function getIntegrationScopeLabel(useGlobalDefaults: boolean): string {
-  return useGlobalDefaults
-    ? 'global defaults'
-    : 'current project';
-}
+import { homedir } from 'node:os';
+
+export function getIntegrationTargetRoot(
+  useGlobalDefaults: boolean,
+  cwd: string,
+  homeDir = homedir(),
+): string {
+  return useGlobalDefaults ? homeDir : cwd;
+}
+
+export function getIntegrationScopeLabel(useGlobalDefaults: boolean): string {
+  return useGlobalDefaults
+    ? 'global defaults'
+    : 'current project';
+}

package/src/cli/commands/lock.ts

@@ -1,97 +1,97 @@
-import { defineCommand } from 'citty';
+import { defineCommand } from 'citty';
 import { emitError, emitResult, getCliProjectContext, resolveCliActorId, shortId } from './operator-shared.js';
-
-export default defineCommand({
-  meta: {
-    name: 'lock',
-    description: 'Acquire, release, and inspect advisory team file locks',
-  },
-  args: {
-    file: { type: 'string', description: 'File path to lock or inspect' },
-    agentId: { type: 'string', description: 'Agent ID acquiring or releasing the lock' },
-    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: 'lock',
+    description: 'Acquire, release, and inspect advisory team file locks',
+  },
+  args: {
+    file: { type: 'string', description: 'File path to lock or inspect' },
+    agentId: { type: 'string', description: 'Agent ID acquiring or releasing the lock' },
+    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 'lock': {
+
+      switch (action) {
+        case 'lock': {
           if (!args.file || !agentId) {
             emitError('file and an active CLI identity or agentId are required for "memorix lock lock"', asJson);
             return;
           }
           const result = teamStore.acquireLock(project.id, args.file as string, agentId);
-          if (!result.success) {
-            emitError(`File is already locked by ${shortId(result.lockedBy)}`, asJson);
-            return;
-          }
-          emitResult(
+          if (!result.success) {
+            emitError(`File is already locked by ${shortId(result.lockedBy)}`, asJson);
+            return;
+          }
+          emitResult(
             { project, file: args.file, lockedBy: agentId },
-            `Locked: ${args.file as string}`,
-            asJson,
-          );
-          return;
-        }
-
-        case 'unlock': {
+            `Locked: ${args.file as string}`,
+            asJson,
+          );
+          return;
+        }
+
+        case 'unlock': {
           if (!args.file || !agentId) {
             emitError('file and an active CLI identity or agentId are required for "memorix lock unlock"', asJson);
             return;
           }
           const released = teamStore.releaseLock(project.id, args.file as string, agentId);
-          if (!released) {
-            emitError('Cannot unlock: not the owner or the file is not locked', asJson);
-            return;
-          }
-          emitResult(
-            { project, file: args.file, released: true },
-            `Unlocked: ${args.file as string}`,
-            asJson,
-          );
-          return;
-        }
-
-        case 'status': {
-          if (args.file) {
-            const lock = teamStore.getLockStatus(project.id, args.file as string);
-            emitResult(
-              { project, lock },
-              lock
-                ? `Locked by ${teamStore.getAgent(lock.locked_by)?.name ?? shortId(lock.locked_by)}: ${args.file as string}`
-                : `Unlocked: ${args.file as string}`,
-              asJson,
-            );
-            return;
-          }
-
+          if (!released) {
+            emitError('Cannot unlock: not the owner or the file is not locked', asJson);
+            return;
+          }
+          emitResult(
+            { project, file: args.file, released: true },
+            `Unlocked: ${args.file as string}`,
+            asJson,
+          );
+          return;
+        }
+
+        case 'status': {
+          if (args.file) {
+            const lock = teamStore.getLockStatus(project.id, args.file as string);
+            emitResult(
+              { project, lock },
+              lock
+                ? `Locked by ${teamStore.getAgent(lock.locked_by)?.name ?? shortId(lock.locked_by)}: ${args.file as string}`
+                : `Unlocked: ${args.file as string}`,
+              asJson,
+            );
+            return;
+          }
+
           const locks = teamStore.listLocks(project.id, agentId);
-          emitResult(
-            { project, locks },
-            locks.length === 0
-              ? 'No active file locks.'
-              : locks
-                  .map((lock) => `- ${lock.file} -> ${teamStore.getAgent(lock.locked_by)?.name ?? shortId(lock.locked_by)}`)
-                  .join('\n'),
-            asJson,
-          );
-          return;
-        }
-
-        default:
-          console.log('Memorix Lock Commands');
-          console.log('');
-          console.log('Usage:');
-          console.log('  memorix lock lock --file src/app.ts --agentId <id>');
-          console.log('  memorix lock unlock --file src/app.ts --agentId <id>');
-          console.log('  memorix lock status [--file src/app.ts] [--agentId <id>]');
-      }
-    } catch (error) {
-      emitError(error instanceof Error ? error.message : String(error), asJson);
-    }
-  },
-});
+          emitResult(
+            { project, locks },
+            locks.length === 0
+              ? 'No active file locks.'
+              : locks
+                  .map((lock) => `- ${lock.file} -> ${teamStore.getAgent(lock.locked_by)?.name ?? shortId(lock.locked_by)}`)
+                  .join('\n'),
+            asJson,
+          );
+          return;
+        }
+
+        default:
+          console.log('Memorix Lock Commands');
+          console.log('');
+          console.log('Usage:');
+          console.log('  memorix lock lock --file src/app.ts --agentId <id>');
+          console.log('  memorix lock unlock --file src/app.ts --agentId <id>');
+          console.log('  memorix lock status [--file src/app.ts] [--agentId <id>]');
+      }
+    } catch (error) {
+      emitError(error instanceof Error ? error.message : String(error), asJson);
+    }
+  },
+});

package/src/cli/commands/media-image.ts

@@ -0,0 +1,27 @@
+import { readFile, stat } from 'node:fs/promises';
+
+import { MAX_VISION_IMAGE_BYTES } from '../../multimodal/image-payload.js';
+
+function matchesImagePrefix(bytes: Buffer, prefix: number[]): boolean {
+  return prefix.every((byte, index) => bytes[index] === byte);
+}
+
+function detectReferenceImageMimeType(bytes: Buffer): string | undefined {
+  if (bytes.length >= 8 && matchesImagePrefix(bytes, [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])) return 'image/png';
+  if (bytes.length >= 3 && matchesImagePrefix(bytes, [0xff, 0xd8, 0xff])) return 'image/jpeg';
+  if (bytes.length >= 6 && (bytes.subarray(0, 6).toString('ascii') === 'GIF87a' || bytes.subarray(0, 6).toString('ascii') === 'GIF89a')) return 'image/gif';
+  if (bytes.length >= 12 && bytes.subarray(0, 4).toString('ascii') === 'RIFF' && bytes.subarray(8, 12).toString('ascii') === 'WEBP') return 'image/webp';
+  return undefined;
+}
+
+export async function readSubjectImage(filePath: string): Promise<{ data: string; mimeType: string }> {
+  const fileStats = await stat(filePath);
+  if (fileStats.size > MAX_VISION_IMAGE_BYTES) {
+    throw new Error(`Reference image exceeds the ${MAX_VISION_IMAGE_BYTES}-byte visual analysis limit`);
+  }
+  const bytes = await readFile(filePath);
+  if (bytes.length === 0) throw new Error(`Reference image is empty: ${filePath}`);
+  const mimeType = detectReferenceImageMimeType(bytes);
+  if (!mimeType) throw new Error('Reference image must be a PNG, JPEG, GIF, or WebP file');
+  return { data: bytes.toString('base64'), mimeType };
+}

package/src/cli/commands/media.ts

@@ -18,6 +18,7 @@ import {
 import { launchMediaVideoRunner, queueMiniMaxVideoGeneration } from '../../media/video-jobs.js';
 import { launchMediaAudioRunner, queueAudioTranscription } from '../../media/audio-jobs.js';
 import type { MediaKind } from '../../media/types.js';
+import { readSubjectImage } from './media-image.js';
 import {
   emitError,
   emitResult,
@@ -118,7 +119,7 @@ function help(): string {
     '  memorix media attach --asset <asset-id> [--title "Architecture"] [--text "..."]',
     '  memorix media embed --asset <asset-id>',
     '  memorix media similar --asset <asset-id> [--limit 10]',
-    '  memorix media generate image --prompt "..." [--model image-01] [--attach]',
+    '  memorix media generate image --prompt "..." [--model image-01] [--image ./reference.png] [--attach]',
     '  memorix media generate video --prompt "..." [--model MiniMax-H3] [--duration 5] [--ratio 16:9] [--attach]',
     '  memorix media status --job <media-job-id>',
     '  memorix media cancel --job <media-job-id>',
@@ -145,6 +146,7 @@ export default defineCommand({
     concepts: { type: 'string', description: 'Comma-separated concepts when attaching' },
     visibility: { type: 'string', description: 'Observation visibility when attaching' },
     prompt: { type: 'string', description: 'Generation prompt' },
+    image: { type: 'string', description: 'Path to a reference image for image-to-image generation' },
     model: { type: 'string', description: 'Provider model' },
     provider: { type: 'string', description: 'Audio transcription provider: openai or groq' },
     language: { type: 'string', description: 'Optional ISO-639-1 hint for audio transcription' },
@@ -223,6 +225,10 @@ export default defineCommand({
             );
             return;
           }
+          const referenceImagePath = getValue(args.image);
+          const subjectImages = referenceImagePath
+            ? [await readSubjectImage(referenceImagePath)]
+            : undefined;
           const generated = await generateMiniMaxImages({
             dataDir,
             projectId: project.id,
@@ -235,6 +241,7 @@ export default defineCommand({
             height: parseOptionalInteger(args.height, 'height', 1, 8_192),
             seed: parseOptionalInteger(args.seed, 'seed', 0, 2_147_483_647),
             promptOptimizer: args.promptOptimizer === true || args['prompt-optimizer'] === true,
+            subjectImages,
             maxBytes: parseByteLimit(args.maxBytes ?? args['max-bytes'], 100 * 1024 * 1024),
           });
           const observations = args.attach === true