iranti 0.2.21 → 0.2.22

package/README.md

@@ -9,10 +9,10 @@
 
 Iranti gives agents persistent, identity-based memory. Facts written by one agent are retrievable by any other agent through exact entity+key lookup. Iranti also supports hybrid search (lexical + vector) when exact keys are unknown. Memory persists across sessions and survives context window limits.
 
-**Latest release:** [`v0.2.20`](https://github.com/nfemmanuel/iranti/releases/tag/v0.2.20)  
+**Latest release:** [`v0.2.21`](https://github.com/nfemmanuel/iranti/releases/tag/v0.2.21)  
 Published packages:
-- `iranti@0.2.20`
-- `@iranti/sdk@0.2.20`
+- `iranti@0.2.21`
+- `@iranti/sdk@0.2.21`
 
 ---
 
@@ -52,27 +52,26 @@ Vector databases answer "what's similar to X?" Iranti answers "what do we know a
 
 ## Benchmark Summary
 
-Iranti has now been rerun against a broader benchmark program covering 13 capability tracks. The current picture is stronger and narrower than the early validation story: exact, durable, shared memory is benchmark-backed; broad semantic-memory claims still need tighter boundaries.
+Iranti has now been rerun against a broader benchmark program covering 11 active capability tracks in `v0.2.21`. The current picture is stronger and narrower than the early validation story: exact, durable, shared memory is benchmark-backed; broad semantic-memory and autonomous-memory claims still need tighter boundaries.
 
 ### Confirmed Strengths
 
-- **Exact lookup (`iranti_query`)**: O(1) retrieval confirmed up to 276k-token haystacks, with a positive differential over baseline at large context size.
-- **Persistence**: Facts survive across sessions and across version upgrades with no observed data loss.
+- **Exact lookup (`iranti_query`)**: Retrieval remains exact and durable across genuine session and process breaks. At tested scale (`N=1938`, about `107k` tokens), the measured advantage is efficiency, not accuracy: Iranti answered `10/10` with zero haystack tokens while the baseline also answered `10/10` after reading the full document.
+- **Persistence across sessions**: Facts survive context-window loss and genuine process boundaries. `iranti_query` remained `8/8` across isolated session breaks in the rerun.
 - **Conflict handling**: Reliable when confidence differentials are large and explicit.
-- **Multi-agent coordination**: Agents can share memory with correct separation and attribution.
-- **Provenance**: `agentId` attribution is preserved correctly.
-- **Relationships**: Relationship writes, reads, and depth traversal are working.
-- **Ingest**: Prose extraction is working and benchmark-confirmed in `v0.2.16`.
-- **Search**: Effective for structured attribute-value retrieval.
-- **Observe / Attend**: Automatic detection and injection behavior improved materially and now works in realistic benchmark conditions.
+- **Multi-agent coordination**: Agents can share memory across genuine subprocess boundaries with zero shared conversational context.
+- **Provenance on writes**: Write-side attribution through stored source metadata is working and benchmark-confirmed.
+- **Ingest**: Prose extraction is accurate on clean entities in `v0.2.21`. Reliability under conflict-heavy transactional conditions should still be treated as a separate, narrower claim.
+- **Observe with hints**: `iranti_observe` recovers facts reliably when given the right entity hint, with higher-confidence facts returned first.
 - **Session recovery**: Interrupted-session recovery now performs substantially better than baseline.
-- **Upgrade safety**: Memory durability was preserved across three version upgrades.
 
 ### Current Limits
 
-- **Search is not yet full semantic paraphrase retrieval.**
-- **Observe still performs better on confidence ranking than on broad progress-fact discovery.**
-- **Structured search is operational, but not yet broad semantic paraphrase retrieval.**
+- **Search is lexical-first today, not semantic multi-hop retrieval.** In the current rerun, hop-value discovery was `0/4`; bare entity-token lookup worked, but `vectorScore` stayed `0` across results.
+- **`iranti_attend` is not yet a reliable autonomous classifier.** Natural-language attend classification still falls back to `classification_parse_failed_default_false`; `forceInject` works as an operator bypass, not as proof of autonomous injection.
+- **Observe performs better with explicit entity hints than with cold-start discovery.**
+- **Upgrade durability should be scoped carefully.** The `v0.2.21` upgrade procedure reinitialized the instance under test; do not assume KB data survives upgrades without an explicit preservation or migration path.
+- **Relationship and provenance reflection surfaces remain partially permission-gated in benchmark sessions.** The rerun did not prove `iranti_relate`, `iranti_related`, `iranti_related_deep`, or `iranti_who_knows` end-to-end under the benchmark session policy.
 
 ### Practical Position
 
@@ -82,9 +81,8 @@ Iranti is strongest today as **structured memory infrastructure for multi-agent
 - provenance-aware writes
 - conflict-aware storage
 - session-aware recovery
-- upgrade-safe persistence
 
-It should not yet be described as a fully general semantic-memory or autonomous-extraction system.
+It should not yet be described as a fully general semantic-memory, semantic-search, or autonomous-memory-injection system.
 
 Historical benchmark material remains available here:
 - [`docs/internal/validation_results.md`](docs/internal/validation_results.md)
@@ -106,7 +104,7 @@ The current competitive case for Iranti is strongest when a team needs memory th
 - Explicit per-fact confidence scores
 - Per-agent memory injection through the Attendant
 - Temporal exact lookup with `asOf` and ordered `history()`
-- Relationship primitives through `relate()`, `getRelated()`, and `getRelatedDeep()`
+- Relationship primitives through `relate()`, `getRelated()`, and `getRelatedDeep()` at the product surface, with benchmark confirmation for those MCP-accessible paths still pending
 - Hybrid retrieval when exact keys are unknown
 - Local install + project binding flow for Claude Code and Codex
 - Published npm / PyPI surfaces with machine-level CLI setup
@@ -163,11 +161,12 @@ The current landscape splits into three buckets:
 Iranti is strongest today as infrastructure for developers building multi-agent systems who need shared, structured, queryable memory rather than pure semantic recall. The current benchmark base now supports a more concrete product claim:
 
 - exact cross-agent fact transfer works at meaningful context scales
-- facts survive session loss and version upgrades
+- facts survive session loss and genuine process breaks
 - same-key conflicting writes are serialized and observable
-- relationship traversal, prose ingest, and attended recovery are usable surfaces
+- prose ingest is accurate on clean entities
+- attended recovery works with explicit hints, while autonomous attend classification remains a known defect
 
-That is still not a claim that multi-agent memory is solved. It is a claim that Iranti now has broader evidence for durable, structured, attribution-aware memory with recovery and upgrade safety.
+That is still not a claim that multi-agent memory is solved. It is a claim that Iranti now has broader evidence for durable, structured, attribution-aware memory with exact retrieval and bounded recovery behavior.
 
 The next leverage is still product simplicity: setup, operations, and day-to-day inspection need to be simple enough that real users keep Iranti in the loop.
 
@@ -316,7 +315,7 @@ iranti codex-setup
 codex -C /path/to/your/project
 ```
 
-When `iranti codex-setup` is run from a project directory, it automatically captures that project's `.env.iranti` as `IRANTI_PROJECT_ENV` so Codex resolves the correct Iranti instance consistently.
+By default, `iranti codex-setup` does not pin a project binding globally. `iranti mcp` resolves `.env.iranti` from the active project/workspace at runtime. Use `--project-env` only if you deliberately want to pin Codex globally to one project binding.
 
 Alias:
 

package/dist/scripts/codex-setup.js

@@ -71,7 +71,8 @@ function printHelp() {
         'Notes:',
         '  - Registers a global Codex MCP entry using `codex mcp add`.',
         '  - Prefers the installed CLI path: `iranti mcp`.',
-        '  - Auto-detects .env.iranti from the current working directory and stores it as IRANTI_PROJECT_ENV.',
+        '  - By default does not pin IRANTI_PROJECT_ENV, so Codex can resolve .env.iranti from the active project/workspace at runtime.',
+        '  - Use --project-env only when you deliberately want to pin Codex globally to one project binding.',
         '  - Use --local-script only if you need to point Codex at this repo build directly.',
         '  - Does not store DATABASE_URL in Codex config; iranti-mcp loads project/instance env at runtime.',
         '  - Replaces any existing MCP entry with the same name.',
@@ -141,8 +142,7 @@ function resolveProjectEnv(options) {
         }
         return resolved;
     }
-    const candidate = node_path_1.default.resolve(process.cwd(), '.env.iranti');
-    return node_fs_1.default.existsSync(candidate) ? candidate : undefined;
+    return undefined;
 }
 function canUseInstalledIranti(repoRoot) {
     try {
@@ -204,7 +204,10 @@ function main() {
     if (useInstalled) {
         console.log('Registration target: installed CLI (`iranti mcp`)');
         if (projectEnv) {
-            console.log(`Project binding: ${projectEnv}`);
+            console.log(`Pinned project binding: ${projectEnv}`);
+        }
+        else {
+            console.log('Project binding: not pinned; `iranti mcp` will resolve `.env.iranti` from the active project/workspace at runtime.');
         }
         console.log('Launch Codex in the project you want to bind to Iranti, for example:');
         console.log('  codex -C C:\\path\\to\\your\\project');
@@ -212,7 +215,10 @@ function main() {
     else {
         console.log(`Registration target: repo build (${mcpScript})`);
         if (projectEnv) {
-            console.log(`Project binding: ${projectEnv}`);
+            console.log(`Pinned project binding: ${projectEnv}`);
+        }
+        else {
+            console.log('Project binding: not pinned; `iranti mcp` will resolve `.env.iranti` from the active project/workspace at runtime.');
         }
         console.log(`Launch with: codex -C "${repoRoot}"`);
     }

package/dist/scripts/iranti-cli.js

@@ -16,6 +16,7 @@ const net_1 = __importDefault(require("net"));
 const client_1 = require("../src/library/client");
 const apiKeys_1 = require("../src/security/apiKeys");
 const escalationPaths_1 = require("../src/lib/escalationPaths");
+const dockerCliParsing_1 = require("../src/lib/dockerCliParsing");
 const runtimeEnv_1 = require("../src/lib/runtimeEnv");
 const resolutionist_1 = require("../src/resolutionist");
 const chat_1 = require("../src/chat");
@@ -676,8 +677,9 @@ async function withPromptSession(run) {
         secret: async (prompt, currentValue) => {
             const placeholder = currentValue ? `${redactSecret(currentValue)} (enter new value to replace)` : 'leave blank to skip';
             const suffix = placeholder ? ` [${placeholder}]` : '';
+            process.stdout.write(`${prompt}${suffix}: `);
             muted = true;
-            const answer = (await rl.question(`${prompt}${suffix}: `)).trim();
+            const answer = (await rl.question('')).trim();
             muted = false;
             process.stdout.write('\n');
             if (!answer || answer === placeholder)
@@ -689,8 +691,9 @@ async function withPromptSession(run) {
         secretRequired: async (prompt, currentValue) => {
             const placeholder = currentValue ? `${redactSecret(currentValue)} (enter new value to replace)` : 'required';
             const suffix = placeholder ? ` [${placeholder}]` : '';
+            process.stdout.write(`${prompt}${suffix}: `);
             muted = true;
-            const answer = (await rl.question(`${prompt}${suffix}: `)).trim();
+            const answer = (await rl.question('')).trim();
             muted = false;
             process.stdout.write('\n');
             if (!answer || answer === placeholder)
@@ -840,6 +843,18 @@ async function promptRequiredSecret(session, prompt, currentValue) {
         console.log(`${warnLabel()} ${prompt} is required.`);
     }
 }
+async function promptSecretWithDefault(session, prompt, defaultValue) {
+    while (true) {
+        const value = (await session.secret(`${prompt} (blank uses local-dev default)`, undefined) ?? '').trim();
+        if (!value) {
+            console.log(`${infoLabel()} Using the local development default for ${prompt}.`);
+            return defaultValue;
+        }
+        if (!detectPlaceholder(value))
+            return value;
+        console.log(`${warnLabel()} ${prompt} still looks like a placeholder. Enter a real value or leave it blank to use the local-dev default.`);
+    }
+}
 function makeLegacyInstanceApiKey(instanceName) {
     const keyId = sanitizeIdentifier(`${instanceName}_${os_1.default.userInfo().username}`, 'iranti');
     return (0, apiKeys_1.formatApiKeyToken)(keyId, (0, apiKeys_1.generateApiKeySecret)());
@@ -990,6 +1005,76 @@ function resolveAttendMessage(args) {
         return fromPositionals;
     throw new Error('Missing latest message. Usage: iranti attend [message] [--message <text>] [--context <text>] [--json]');
 }
+function parseDelimitedList(raw) {
+    if (!raw?.trim())
+        return [];
+    const delimiter = raw.includes('||') ? '||' : ',';
+    return raw
+        .split(delimiter)
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function resolveTaskEntity(args) {
+    const entity = (args.subcommand ?? args.positionals[0] ?? getFlag(args, 'entity') ?? '').trim();
+    if (!entity) {
+        throw new Error('Missing task entity. Usage: iranti handoff task/<task_id> --next-step <text> [--json]');
+    }
+    if (!entity.includes('/')) {
+        throw new Error('task entity must use entityType/entityId format.');
+    }
+    return entity;
+}
+function buildHandoffSummary(key, value) {
+    switch (key) {
+        case 'status': {
+            const state = typeof value === 'object' && value && 'state' in value ? String(value.state) : 'updated';
+            return `Shared task status is ${state}.`;
+        }
+        case 'current_owner': {
+            const agentId = typeof value === 'object' && value && 'agentId' in value ? String(value.agentId) : 'unassigned';
+            return `Current owner is ${agentId}.`;
+        }
+        case 'next_step': {
+            const instruction = typeof value === 'object' && value && 'instruction' in value ? String(value.instruction) : 'Next step updated.';
+            return truncateText(`Next step: ${instruction}`, 140);
+        }
+        case 'blockers': {
+            const count = typeof value === 'object' && value && 'items' in value && Array.isArray(value.items)
+                ? value.items.length
+                : 0;
+            return count === 0 ? 'No blockers recorded.' : `${count} blocker${count === 1 ? '' : 's'} recorded for the shared task.`;
+        }
+        case 'artifacts': {
+            const count = typeof value === 'object' && value && 'files' in value && Array.isArray(value.files)
+                ? value.files.length
+                : 0;
+            return count === 0 ? 'No artifacts recorded.' : `${count} artifact${count === 1 ? '' : 's'} recorded for the shared task.`;
+        }
+        case 'notes': {
+            const text = typeof value === 'object' && value && 'text' in value ? String(value.text) : 'Shared handoff notes updated.';
+            return truncateText(`Notes: ${text}`, 140);
+        }
+        case 'active_handoff_task': {
+            const taskEntity = typeof value === 'object' && value && 'taskEntity' in value ? String(value.taskEntity) : 'task';
+            return `Project now points to active handoff ${taskEntity}.`;
+        }
+        default:
+            return 'Shared handoff state updated.';
+    }
+}
+function printHandoffResult(target, taskEntity, writes) {
+    console.log(bold('Iranti handoff'));
+    console.log(`  agent         ${target.agentId}`);
+    console.log(`  env source    ${target.envSource}`);
+    if (target.envFile)
+        console.log(`  env file      ${target.envFile}`);
+    console.log(`  task entity   ${taskEntity}`);
+    console.log(`  writes        ${writes.length}`);
+    console.log('');
+    for (const write of writes) {
+        console.log(`- ${write.entity} :: ${write.key} | ${write.summary}`);
+    }
+}
 function printHandshakeResult(target, task, result) {
     console.log(bold('Iranti handshake'));
     console.log(`  agent         ${target.agentId}`);
@@ -1220,7 +1305,7 @@ function inspectDockerAvailability() {
         detail: `Docker CLI is installed, but the daemon is not reachable. ${reason}`,
     };
 }
-async function isPortAvailable(port, host = '127.0.0.1') {
+async function isPortAvailable(port, host = '0.0.0.0') {
     return await new Promise((resolve) => {
         const server = net_1.default.createServer();
         server.unref();
@@ -1230,18 +1315,33 @@ async function isPortAvailable(port, host = '127.0.0.1') {
         });
     });
 }
-async function findNextAvailablePort(start, host = '127.0.0.1', maxSteps = 50) {
+function listPublishedDockerHostPorts() {
+    const docker = inspectDockerAvailability();
+    if (!docker.daemonReachable)
+        return new Set();
+    const inspect = runCommandCapture('docker', ['ps', '--format', '{{.Ports}}']);
+    if (inspect.status !== 0)
+        return new Set();
+    return (0, dockerCliParsing_1.parsePublishedDockerHostPorts)(inspect.stdout ?? '');
+}
+async function isPortUsable(port, host = '0.0.0.0', dockerPublishedPorts = new Set()) {
+    if (dockerPublishedPorts.has(port))
+        return false;
+    return isPortAvailable(port, host);
+}
+async function findNextAvailablePort(start, host = '0.0.0.0', maxSteps = 50, dockerPublishedPorts = new Set()) {
     for (let port = start; port < start + maxSteps; port += 1) {
-        if (await isPortAvailable(port, host)) {
+        if (await isPortUsable(port, host, dockerPublishedPorts)) {
             return port;
         }
     }
     throw new Error(`No available port found in range ${start}-${start + maxSteps - 1}.`);
 }
 async function chooseAvailablePort(session, promptText, preferredPort, allowOccupiedCurrent = false) {
+    const dockerPublishedPorts = listPublishedDockerHostPorts();
     let suggested = preferredPort;
-    if (!allowOccupiedCurrent && !(await isPortAvailable(preferredPort))) {
-        suggested = await findNextAvailablePort(preferredPort + 1);
+    if (!allowOccupiedCurrent && !(await isPortUsable(preferredPort, '0.0.0.0', dockerPublishedPorts))) {
+        suggested = await findNextAvailablePort(preferredPort + 1, '0.0.0.0', 50, dockerPublishedPorts);
         console.log(`${warnLabel()} Port ${preferredPort} is already in use. A good next option is ${suggested}.`);
     }
     while (true) {
@@ -1254,10 +1354,10 @@ async function chooseAvailablePort(session, promptText, preferredPort, allowOccu
         if (allowOccupiedCurrent && parsed === preferredPort) {
             return parsed;
         }
-        if (await isPortAvailable(parsed)) {
+        if (await isPortUsable(parsed, '0.0.0.0', dockerPublishedPorts)) {
             return parsed;
         }
-        const next = await findNextAvailablePort(parsed + 1);
+        const next = await findNextAvailablePort(parsed + 1, '0.0.0.0', 50, dockerPublishedPorts);
         console.log(`${warnLabel()} Port ${parsed} is already in use. Try ${next} instead.`);
         suggested = next;
     }
@@ -1290,16 +1390,14 @@ async function runDockerPostgresContainer(options) {
     if (!docker.daemonReachable) {
         throw new Error(`Docker daemon is not reachable. Start Docker Desktop or Docker Engine, then retry. ${docker.detail}`);
     }
-    const inspect = process.platform === 'win32'
-        ? (0, child_process_1.spawnSync)(process.env.ComSpec ?? 'cmd.exe', ['/d', '/c', `docker ps -a --format "{{.Names}}"`], { encoding: 'utf8' })
-        : (0, child_process_1.spawnSync)('docker', ['ps', '-a', '--format', '{{.Names}}'], { encoding: 'utf8' });
+    const inspect = runCommandCapture('docker', ['ps', '-a', '--format', '{{.Names}}']);
     if (inspect.status !== 0) {
         throw new Error(`Failed to inspect Docker containers. ${(inspect.stderr ?? inspect.stdout ?? '').trim() || 'docker ps returned a non-zero exit code.'}`);
     }
-    const names = (inspect.stdout ?? '').split(/\r?\n/).map((value) => value.trim()).filter(Boolean);
+    const names = (0, dockerCliParsing_1.parseDockerContainerNames)(inspect.stdout ?? '');
     if (names.includes(options.containerName)) {
         const start = process.platform === 'win32'
-            ? (0, child_process_1.spawnSync)(process.env.ComSpec ?? 'cmd.exe', ['/d', '/c', `docker start ${options.containerName}`], { stdio: 'inherit' })
+            ? (0, child_process_1.spawnSync)(process.env.ComSpec ?? 'cmd.exe', ['/d', '/c', ['docker', 'start', options.containerName].map(quoteForCmd).join(' ')], { stdio: 'inherit' })
             : (0, child_process_1.spawnSync)('docker', ['start', options.containerName], { stdio: 'inherit' });
         if (start.status !== 0) {
             throw new Error(`Failed to start existing Docker container '${options.containerName}'.`);
@@ -3364,7 +3462,7 @@ async function setupCommand(args) {
                 }
                 const dbHostPort = await chooseAvailablePort(prompt, 'Docker PostgreSQL host port', 5432, false);
                 const dbName = sanitizeIdentifier(await promptNonEmpty(prompt, 'Docker PostgreSQL database name', `iranti_${instanceName}`), `iranti_${instanceName}`);
-                const dbPassword = await promptRequiredSecret(prompt, 'Docker PostgreSQL password');
+                const dbPassword = await promptSecretWithDefault(prompt, 'Docker PostgreSQL password', 'postgres');
                 const containerName = sanitizeIdentifier(await promptNonEmpty(prompt, 'Docker container name', `iranti_${instanceName}_db`), `iranti_${instanceName}_db`);
                 dockerContainerName = containerName;
                 dbUrl = `postgresql://postgres:${dbPassword}@localhost:${dbHostPort}/${dbName}`;
@@ -4638,6 +4736,113 @@ async function attendCommand(args) {
     console.log('');
     console.log(`${infoLabel()} This is a manual Attendant inspection tool. Claude Code should still use hooks + MCP in normal operation.`);
 }
+async function handoffCommand(args) {
+    const json = hasFlag(args, 'json');
+    const target = await resolveAttendantCliTarget(args);
+    const taskEntity = resolveTaskEntity(args);
+    const projectEntity = getFlag(args, 'project-entity')?.trim();
+    if (projectEntity && !projectEntity.includes('/')) {
+        throw new Error('project-entity must use entityType/entityId format.');
+    }
+    const nextStep = getFlag(args, 'next-step')?.trim();
+    if (!nextStep) {
+        throw new Error('Missing --next-step. A standardized handoff must record the receiver action.');
+    }
+    const status = getFlag(args, 'status')?.trim() || 'ready_for_handoff';
+    const owner = getFlag(args, 'owner')?.trim();
+    const blockers = parseDelimitedList(getFlag(args, 'blockers'));
+    const artifacts = parseDelimitedList(getFlag(args, 'artifacts'));
+    const notes = getFlag(args, 'notes')?.trim();
+    const source = getFlag(args, 'source')?.trim() || 'CLIHandoff';
+    const confidence = parsePositiveInteger(getFlag(args, 'confidence'), 'confidence') ?? 95;
+    if (confidence > 100) {
+        throw new Error('confidence must be <= 100.');
+    }
+    const writes = [];
+    writes.push({
+        entity: taskEntity,
+        key: 'status',
+        value: { state: status },
+        summary: buildHandoffSummary('status', { state: status }),
+    });
+    writes.push({
+        entity: taskEntity,
+        key: 'next_step',
+        value: { instruction: nextStep },
+        summary: buildHandoffSummary('next_step', { instruction: nextStep }),
+    });
+    if (owner) {
+        writes.push({
+            entity: taskEntity,
+            key: 'current_owner',
+            value: { agentId: owner },
+            summary: buildHandoffSummary('current_owner', { agentId: owner }),
+        });
+    }
+    if (blockers.length > 0) {
+        writes.push({
+            entity: taskEntity,
+            key: 'blockers',
+            value: { items: blockers },
+            summary: buildHandoffSummary('blockers', { items: blockers }),
+        });
+    }
+    if (artifacts.length > 0) {
+        writes.push({
+            entity: taskEntity,
+            key: 'artifacts',
+            value: { files: artifacts },
+            summary: buildHandoffSummary('artifacts', { files: artifacts }),
+        });
+    }
+    if (notes) {
+        writes.push({
+            entity: taskEntity,
+            key: 'notes',
+            value: { text: notes },
+            summary: buildHandoffSummary('notes', { text: notes }),
+        });
+    }
+    if (projectEntity) {
+        writes.push({
+            entity: projectEntity,
+            key: 'active_handoff_task',
+            value: {
+                taskEntity,
+                owner: owner ?? null,
+                status,
+                updatedBy: target.agentId,
+            },
+            summary: buildHandoffSummary('active_handoff_task', { taskEntity }),
+        });
+    }
+    for (const write of writes) {
+        await target.iranti.write({
+            entity: write.entity,
+            key: write.key,
+            value: write.value,
+            summary: write.summary,
+            confidence,
+            source,
+            agent: target.agentId,
+        });
+    }
+    if (json) {
+        console.log(JSON.stringify({
+            agent: target.agentId,
+            envSource: target.envSource,
+            envFile: target.envFile,
+            source,
+            confidence,
+            writes,
+        }, null, 2));
+        process.exit(0);
+    }
+    printHandoffResult(target, taskEntity, writes);
+    console.log('');
+    console.log(`${infoLabel()} Handoffs are shared-memory facts. Pair this with checkpoint() if the sender also needs agent-local recovery.`);
+    process.exit(0);
+}
 function printClaudeSetupHelp() {
     console.log([
         'Scaffold Claude Code MCP and hook files for the current project.',
@@ -4936,6 +5141,7 @@ function printHelp() {
         ['iranti uninstall [--dry-run] [--yes] [--all] [--keep-data] [--keep-project-bindings] [--scan-root <dir[,dir2]>] [--json]', 'Remove Iranti packages and, with --all, runtime data and project integrations.'],
         ['iranti handshake [--instance <name> | --project-env <file>] [--agent <id>] [--task <text>] [--recent <msg1||msg2>] [--recent-file <path>] [--json]', 'Manually inspect Attendant handshake output.'],
         ['iranti attend [message] [--instance <name> | --project-env <file>] [--agent <id>] [--context <text> | --context-file <path>] [--entity-hint <entity>] [--force] [--max-facts <n>] [--json]', 'Manually inspect turn-level memory injection decisions.'],
+        ['iranti handoff task/<task_id> [--instance <name> | --project-env <file>] [--agent <id>] --next-step <text> [--status <state>] [--owner <agent-id>] [--blockers <a||b>] [--artifacts <path1||path2>] [--project-entity <entity>] [--notes <text>] [--source <label>] [--confidence <n>] [--json]', 'Write a standardized shared-memory handoff for Claude/Codex collaboration.'],
         ['iranti chat [--agent <agent-id>] [--provider <provider>] [--model <model>]', 'Open the local interactive chat shell.'],
         ['iranti resolve [--dir <escalation-dir>]', 'Walk through pending escalation files.'],
     ]);
@@ -5162,6 +5368,10 @@ async function main() {
         await attendCommand(args);
         return;
     }
+    if (args.command === 'handoff') {
+        await handoffCommand(args);
+        return;
+    }
     if (args.command === 'chat') {
         await chatCommand(args);
         return;

package/dist/scripts/iranti-mcp.js

@@ -144,7 +144,7 @@ async function main() {
     await ensureDefaultAgent(iranti);
     const server = new mcp_js_1.McpServer({
         name: 'iranti-mcp',
-        version: '0.2.21',
+        version: '0.2.22',
     });
     server.registerTool('iranti_handshake', {
         description: `Initialize or refresh an agent's working-memory brief for the current task.

package/dist/src/api/server.js

@@ -39,7 +39,7 @@ const INSTANCE_DIR = process.env.IRANTI_INSTANCE_DIR?.trim()
 const INSTANCE_RUNTIME_FILE = process.env.IRANTI_INSTANCE_RUNTIME_FILE?.trim()
     || (INSTANCE_DIR ? (0, runtimeLifecycle_1.runtimeFileForInstance)(INSTANCE_DIR) : null);
 const INSTANCE_NAME = process.env.IRANTI_INSTANCE_NAME?.trim() || (INSTANCE_DIR ? path_1.default.basename(INSTANCE_DIR) : 'adhoc');
-const VERSION = '0.2.21';
+const VERSION = '0.2.22';
 try {
     fs_1.default.mkdirSync(path_1.default.dirname(REQUEST_LOG_FILE), { recursive: true });
 }

package/dist/src/lib/dockerCliParsing.d.ts

@@ -0,0 +1,3 @@
+export declare function parsePublishedDockerHostPorts(output: string): Set<number>;
+export declare function parseDockerContainerNames(output: string): string[];
+//# sourceMappingURL=dockerCliParsing.d.ts.map

package/dist/src/lib/dockerCliParsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dockerCliParsing.d.ts","sourceRoot":"","sources":["../../../src/lib/dockerCliParsing.ts"],"names":[],"mappings":"AAAA,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAWzE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlE"}

package/dist/src/lib/dockerCliParsing.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePublishedDockerHostPorts = parsePublishedDockerHostPorts;
+exports.parseDockerContainerNames = parseDockerContainerNames;
+function parsePublishedDockerHostPorts(output) {
+    const ports = new Set();
+    for (const line of output.split(/\r?\n/)) {
+        for (const match of line.matchAll(/(?:^|,\s*)(?:0\.0\.0\.0|127\.0\.0\.1|\[::\]|localhost):(\d+)->/g)) {
+            const parsed = Number.parseInt(match[1] ?? '', 10);
+            if (Number.isFinite(parsed) && parsed > 0) {
+                ports.add(parsed);
+            }
+        }
+    }
+    return ports;
+}
+function parseDockerContainerNames(output) {
+    return output
+        .split(/\r?\n/)
+        .map((value) => value.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=dockerCliParsing.js.map

package/dist/src/lib/dockerCliParsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dockerCliParsing.js","sourceRoot":"","sources":["../../../src/lib/dockerCliParsing.ts"],"names":[],"mappings":";;AAAA,sEAWC;AAED,8DAKC;AAlBD,SAAgB,6BAA6B,CAAC,MAAc;IACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,iEAAiE,CAAC,EAAE,CAAC;YACnG,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAgB,yBAAyB,CAAC,MAAc;IACpD,OAAO,MAAM;SACR,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC"}

package/dist/src/lib/runtimeEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeEnv.d.ts","sourceRoot":"","sources":["../../../src/lib/runtimeEnv.ts"],"names":[],"mappings":"AAIA,KAAK,iBAAiB,GAAG;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAuDF,wBAAgB,cAAc,CAAC,OAAO,GAAE,iBAAsB,GAAG,oBAAoB,CAsCpF"}
+{"version":3,"file":"runtimeEnv.d.ts","sourceRoot":"","sources":["../../../src/lib/runtimeEnv.ts"],"names":[],"mappings":"AAIA,KAAK,iBAAiB,GAAG;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AA4DF,wBAAgB,cAAc,CAAC,OAAO,GAAE,iBAAsB,GAAG,oBAAoB,CAuCpF"}

package/dist/src/lib/runtimeEnv.js

@@ -11,9 +11,10 @@ function parseEnvFile(filePath) {
     const raw = fs_1.default.readFileSync(filePath, 'utf-8');
     return dotenv_1.default.parse(raw);
 }
-function applyEnvVars(vars, initialEnvKeys) {
+function applyEnvVars(vars, initialEnvKeys, options = {}) {
+    const { overrideExisting = false } = options;
     for (const [key, value] of Object.entries(vars)) {
-        if (initialEnvKeys.has(key))
+        if (!overrideExisting && initialEnvKeys.has(key))
             continue;
         process.env[key] = value;
     }
@@ -61,7 +62,8 @@ function loadRuntimeEnv(options = {}) {
     const initialEnvKeys = new Set(Object.keys(process.env));
     const fallbackEnvFile = findFallbackEnvFile(options);
     if (fallbackEnvFile) {
-        applyEnvVars(parseEnvFile(fallbackEnvFile), initialEnvKeys);
+        const explicitFallback = Boolean(options.explicitEnvFile?.trim() || process.env.IRANTI_ENV_FILE?.trim());
+        applyEnvVars(parseEnvFile(fallbackEnvFile), initialEnvKeys, { overrideExisting: explicitFallback });
         loadedFiles.push(fallbackEnvFile);
     }
     const projectEnvFile = findProjectEnvFile(options);
@@ -75,11 +77,11 @@ function loadRuntimeEnv(options = {}) {
         ? path_1.default.resolve(instanceEnvFile)
         : undefined;
     if (resolvedInstanceEnvFile) {
-        applyEnvVars(parseEnvFile(resolvedInstanceEnvFile), initialEnvKeys);
+        applyEnvVars(parseEnvFile(resolvedInstanceEnvFile), initialEnvKeys, { overrideExisting: true });
         loadedFiles.push(resolvedInstanceEnvFile);
     }
     if (projectEnvFile && projectEnv) {
-        applyEnvVars(projectEnv, initialEnvKeys);
+        applyEnvVars(projectEnv, initialEnvKeys, { overrideExisting: true });
         loadedFiles.push(projectEnvFile);
     }
     return {

package/dist/src/lib/runtimeEnv.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeEnv.js","sourceRoot":"","sources":["../../../src/lib/runtimeEnv.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtimeEnv.js","sourceRoot":"","sources":["../../../src/lib/runtimeEnv.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iranti",
-  "version": "0.2.21",
+  "version": "0.2.22",
   "description": "Memory infrastructure for multi-agent AI systems",
   "main": "dist/src/sdk/index.js",
   "files": [
@@ -71,6 +71,7 @@
     "test:vector-backends": "ts-node tests/vector-backends/run_vector_backend_tests.ts",
     "test:ts-client-smoke": "ts-node --project tests/typescript_client/tsconfig.json tests/typescript_client/smoke_test.ts",
     "test:consistency": "ts-node tests/consistency/run_consistency_tests.ts",
+    "test:cross-tool-handoff": "ts-node tests/cross-tool/run_cross_tool_handoff_tests.ts",
     "release:check": "ts-node scripts/check-release-version.ts",
     "release:bump": "ts-node scripts/bump-version.ts",
     "seed:policy": "ts-node scripts/seed_policy.ts",