iranti 0.3.0 → 0.3.2

package/bin/iranti.js

@@ -21,4 +21,4 @@ try {
   console.error('Iranti CLI is not built. Run "npm run build" first.');
   console.error(message);
   process.exit(1);
-}
+}

package/dist/scripts/claude-code-memory-hook.js

@@ -11,6 +11,8 @@ const runtimeEnv_1 = require("../src/lib/runtimeEnv");
 const staffEventRegistry_1 = require("../src/lib/staffEventRegistry");
 const client_1 = require("../src/library/client");
 const autoRemember_1 = require("../src/lib/autoRemember");
+const assistantCheckpoint_1 = require("../src/lib/assistantCheckpoint");
+const hostMemoryFormatting_1 = require("../src/lib/hostMemoryFormatting");
 const MEMORY_NEED_POSITIVE_PATTERNS = [
     /\bwhat(?:'s| is| was)?\s+my\b/i,
     /\bdo you remember\b/i,
@@ -41,7 +43,7 @@ function printHelp() {
         '',
         'Reads Claude Code hook JSON from stdin and returns hookSpecificOutput.additionalContext on stdout.',
         'This helper retrieves working memory; durable KB writes still require explicit iranti_write/ingest calls.',
-        'Set IRANTI_AUTO_REMEMBER=true to auto-save narrow personal facts to IRANTI_PERSONAL_MEMORY_ENTITY/user/main, project summaries to IRANTI_MEMORY_ENTITY, and shared checkpoint breadcrumbs for resumable work.',
+        'Set IRANTI_AUTO_REMEMBER=true to auto-save prompt-side personal/project facts. Assistant-response continuity facts and shared checkpoints are captured on Stop regardless.',
     ].join('\n'));
 }
 function parseArgs(argv) {
@@ -229,19 +231,28 @@ function getMaxFacts() {
     return Math.min(12, Math.trunc(raw));
 }
 function formatSessionContext(facts, cwd) {
-    const limited = facts.slice(0, getMaxFacts());
+    const limited = (0, hostMemoryFormatting_1.assignStructuredFactIds)(facts.slice(0, getMaxFacts()).map((fact) => ({
+        ...fact,
+        entityKey: `${fact.entity}/${fact.key}`,
+    })));
     const lines = [
         '[Iranti Session Memory]',
         `Project: ${path_1.default.basename(cwd)}`,
         'REQUIRED: Call mcp__iranti__iranti_handshake before responding to the first user message.',
-        'REQUIRED: Call mcp__iranti__iranti_attend before every subsequent turn.',
+        'REQUIRED: Call mcp__iranti__iranti_attend(phase=\'pre-response\') before every reply and before factual discovery.',
+        'REQUIRED: After every response, call mcp__iranti__iranti_attend(phase=\'post-response\').',
+        'REQUIRED: Prefer injected Iranti facts before re-inferring project state.',
     ];
-    if (limited.length > 0) {
-        lines.push('Relevant memory:');
-        for (const fact of limited) {
-            lines.push(`- ${fact.entity}/${fact.key}: ${fact.summary}`);
-        }
-    }
+    const block = (0, hostMemoryFormatting_1.formatStructuredFactBlock)(limited, {
+        title: 'Iranti Session Facts',
+        introLines: [
+            'Use these loaded facts as the starting working-memory frame for this session.',
+            'Prefer them before re-inferring project state.',
+            'Fact IDs are stable only within this block.',
+        ],
+    });
+    if (block)
+        lines.push(block);
     return lines.join('\n');
 }
 function formatPreCompactContext() {
@@ -270,154 +281,22 @@ function extractSelfMemoryQueryKey(prompt) {
 function formatPromptContext(facts, prompt) {
     if (facts.length === 0)
         return '';
-    const lines = ['[Iranti Retrieved Memory]'];
+    const structuredFacts = (0, hostMemoryFormatting_1.assignStructuredFactIds)(facts.map((fact) => ({
+        ...fact,
+        entityKey: `${fact.entity}/${fact.key}`,
+    })));
+    const lines = [];
     const targetKey = prompt ? extractSelfMemoryQueryKey(prompt) : null;
     if (targetKey) {
-        const answerCandidate = facts.find((fact) => (0, autoRemember_1.canonicalizeMemoryKey)(fact.key) === targetKey);
+        const answerCandidate = structuredFacts.find((fact) => (0, autoRemember_1.canonicalizeMemoryKey)(fact.entityKey.split('/').slice(2).join('/')) === targetKey);
         if (answerCandidate) {
-            lines.push(`Direct answer: ${answerCandidate.summary}.`);
-            lines.push('Use the direct answer above when it fully answers the user question.');
+            lines.push(`[Iranti Direct Answer]`);
+            lines.push(`Use ${answerCandidate.factId} directly if it fully answers the user question: ${answerCandidate.summary}.`);
         }
     }
-    for (const fact of facts) {
-        lines.push(`- ${fact.entity}/${fact.key}: ${fact.summary}`);
-    }
+    lines.push((0, hostMemoryFormatting_1.formatStructuredFactBlock)(structuredFacts, { title: 'Iranti Retrieved Memory' }));
     return lines.join('\n');
 }
-function readTextField(value, preferredKey) {
-    if (typeof value !== 'object' || value === null)
-        return undefined;
-    const record = value;
-    const raw = record[preferredKey];
-    return typeof raw === 'string' && raw.trim() ? raw.trim() : undefined;
-}
-function readItems(value) {
-    if (typeof value !== 'object' || value === null)
-        return [];
-    const record = value;
-    const items = Array.isArray(record.items) ? record.items : [];
-    return items.map((item) => String(item ?? '').trim()).filter(Boolean);
-}
-function readFileChangeOutputs(value) {
-    if (typeof value !== 'object' || value === null)
-        return [];
-    const record = value;
-    const items = Array.isArray(record.items) ? record.items : [];
-    return items.map((item) => {
-        if (typeof item !== 'object' || item === null)
-            return '';
-        const change = item;
-        const action = String(change.action ?? 'updated').trim();
-        const targetPath = String(change.path ?? '').trim();
-        const toPath = String(change.toPath ?? '').trim();
-        if (!targetPath)
-            return '';
-        return toPath ? `${action} ${targetPath} -> ${toPath}` : `${action} ${targetPath}`;
-    }).filter(Boolean);
-}
-function readCheckpointActions(value) {
-    if (typeof value !== 'object' || value === null)
-        return [];
-    const record = value;
-    const items = Array.isArray(record.items) ? record.items : [];
-    return items
-        .map((item) => {
-        if (typeof item !== 'object' || item === null)
-            return null;
-        const action = item;
-        const summary = String(action.summary ?? '').trim();
-        if (!summary)
-            return null;
-        const kind = String(action.kind ?? 'action').trim() || 'action';
-        return {
-            kind,
-            summary,
-            ...(typeof action.status === 'string' && action.status.trim() ? { status: action.status.trim() } : {}),
-            ...(typeof action.target === 'string' && action.target.trim() ? { target: action.target.trim() } : {}),
-            ...(typeof action.detail === 'string' && action.detail.trim() ? { detail: action.detail.trim() } : {}),
-        };
-    })
-        .filter((item) => Boolean(item));
-}
-function readActionOutputs(value) {
-    if (typeof value !== 'object' || value === null)
-        return [];
-    const record = value;
-    const items = Array.isArray(record.items) ? record.items : [];
-    return items.map((item) => {
-        if (typeof item !== 'object' || item === null)
-            return '';
-        const action = item;
-        const kind = String(action.kind ?? 'action').trim() || 'action';
-        const summary = String(action.summary ?? '').trim();
-        const status = String(action.status ?? '').trim();
-        if (!summary)
-            return '';
-        return status ? `[${status}] ${kind}: ${summary}` : `${kind}: ${summary}`;
-    }).filter(Boolean);
-}
-function extractHookCheckpointPayload(response) {
-    const facts = (0, autoRemember_1.extractExplicitAssistantMemory)(response).filter((fact) => fact.scope === 'project');
-    if (facts.length === 0) {
-        return null;
-    }
-    const checkpoint = {};
-    const outputs = [];
-    for (const fact of facts) {
-        if (fact.key === 'current_step') {
-            checkpoint.currentStep = readTextField(fact.value, 'text');
-            continue;
-        }
-        if (fact.key === 'next_step') {
-            checkpoint.nextStep = readTextField(fact.value, 'instruction') ?? readTextField(fact.value, 'text');
-            continue;
-        }
-        if (fact.key === 'open_risks') {
-            checkpoint.openRisks = readItems(fact.value);
-            continue;
-        }
-        if (fact.key === 'important_artifacts') {
-            outputs.push(...readItems(fact.value));
-            continue;
-        }
-        if (fact.key === 'recent_file_changes') {
-            const fileChanges = typeof fact.value === 'object' && fact.value !== null && Array.isArray(fact.value.items)
-                ? fact.value.items
-                    .filter((item) => item && typeof item === 'object')
-                    .map((item) => ({
-                    action: String(item.action ?? 'updated').trim() || 'updated',
-                    path: String(item.path ?? '').trim(),
-                    ...(typeof item.toPath === 'string' && item.toPath.trim() ? { toPath: String(item.toPath).trim() } : {}),
-                    ...(typeof item.purpose === 'string' && item.purpose.trim() ? { purpose: String(item.purpose).trim() } : {}),
-                }))
-                    .filter((item) => item.path)
-                : [];
-            if (fileChanges.length > 0) {
-                checkpoint.fileChanges = [...(checkpoint.fileChanges ?? []), ...fileChanges];
-            }
-            outputs.push(...readFileChangeOutputs(fact.value));
-            continue;
-        }
-        if (fact.key === 'recent_actions') {
-            const actions = readCheckpointActions(fact.value);
-            if (actions.length > 0) {
-                checkpoint.actions = [...(checkpoint.actions ?? []), ...actions];
-            }
-            outputs.push(...readActionOutputs(fact.value));
-        }
-    }
-    if (outputs.length > 0) {
-        checkpoint.recentOutputs = outputs;
-    }
-    return checkpoint.currentStep
-        || checkpoint.nextStep
-        || (checkpoint.openRisks && checkpoint.openRisks.length > 0)
-        || (checkpoint.recentOutputs && checkpoint.recentOutputs.length > 0)
-        || (checkpoint.actions && checkpoint.actions.length > 0)
-        || (checkpoint.fileChanges && checkpoint.fileChanges.length > 0)
-        ? checkpoint
-        : null;
-}
 function emitHookContext(event, additionalContext) {
     const payload = {
         hookSpecificOutput: {
@@ -523,8 +402,8 @@ async function buildHookAdditionalContext(options) {
     }
     if (event === 'Stop') {
         const response = getLastAssistantMessage(payload);
-        if (response && (0, autoRemember_1.isAutoRememberEnabled)()) {
-            await (0, autoRemember_1.autoRememberAssistantFacts)({
+        if (response) {
+            await (0, autoRemember_1.rememberAssistantResponseFacts)({
                 iranti,
                 response,
                 agent,
@@ -534,7 +413,7 @@ async function buildHookAdditionalContext(options) {
                     host: 'claude_code',
                 },
             });
-            const checkpoint = extractHookCheckpointPayload(response);
+            const checkpoint = (0, assistantCheckpoint_1.extractAssistantCheckpointPayload)(response);
             const projectEntity = (0, autoRemember_1.getProjectMemoryEntity)();
             if (checkpoint && projectEntity && typeof iranti.checkpoint === 'function') {
                 await iranti.checkpoint({
@@ -547,6 +426,14 @@ async function buildHookAdditionalContext(options) {
                     },
                 });
             }
+            await iranti.attend({
+                agent,
+                latestMessage: response,
+                currentContext: response,
+                entityHints,
+                maxFacts: getMaxFacts(),
+                phase: 'post-response',
+            });
         }
         return '';
     }
@@ -575,6 +462,7 @@ async function buildHookAdditionalContext(options) {
         currentContext: buildCurrentContext(payload, prompt),
         entityHints,
         maxFacts: getMaxFacts(),
+        phase: 'pre-response',
     });
     const facts = attend.facts.map((fact) => ({
         entity: fact.entityKey.split('/').slice(0, 2).join('/'),

package/dist/scripts/iranti-cli.js

@@ -34,6 +34,7 @@ const autoRemember_1 = require("../src/lib/autoRemember");
 const semanticFactTags_1 = require("../src/lib/semanticFactTags");
 const staffEventRegistry_1 = require("../src/lib/staffEventRegistry");
 const scaffoldCloseout_1 = require("../src/lib/scaffoldCloseout");
+const projectLearning_1 = require("../src/lib/projectLearning");
 class CliError extends Error {
     constructor(code, message, hints = [], details) {
         super(message);
@@ -1104,10 +1105,14 @@ async function writeProjectBinding(projectPath, updates) {
     const previousBinding = fs_1.default.existsSync(outFile)
         ? await readEnvFile(outFile).catch(() => ({}))
         : {};
+    const normalizedUpdates = {
+        ...updates,
+        IRANTI_CODEBASE_ENTITY: updates.IRANTI_CODEBASE_ENTITY ?? previousBinding.IRANTI_CODEBASE_ENTITY ?? (0, projectLearning_1.deriveProjectCodebaseEntity)(projectPath),
+    };
     if (!fs_1.default.existsSync(outFile)) {
         await writeText(outFile, '# Iranti project binding\n');
     }
-    await upsertEnvFile(outFile, updates);
+    await upsertEnvFile(outFile, normalizedUpdates);
     await ensureProjectGitignore(projectPath);
     const writtenBinding = await readEnvFile(outFile).catch(() => ({}));
     await syncProjectBindingRegistry(projectPath, writtenBinding, previousBinding);
@@ -2132,6 +2137,11 @@ function printAttendResult(target, latestMessage, result) {
     console.log(`  confidence    ${result.decision.confidence}`);
     console.log(`  explanation   ${result.decision.explanation}`);
     console.log(`  facts         ${result.facts.length}`);
+    if ((result.memoryAttributions?.length ?? 0) > 0) {
+        const firstAttribution = result.memoryAttributions[0];
+        console.log(`  injection id  ${firstAttribution.injectionId}`);
+        console.log(`  attribution   ${firstAttribution.status} surfaced=${firstAttribution.surfaced} used=${firstAttribution.used} helpful=${firstAttribution.helpful}`);
+    }
     if (result.facts.length === 0) {
         console.log('');
         console.log('No facts selected for injection.');
@@ -2506,6 +2516,10 @@ async function isPortAvailable(port, host = '0.0.0.0') {
     });
 }
 function listPublishedDockerHostPorts() {
+    const injected = process.env.IRANTI_FAKE_DOCKER_PORTS?.trim();
+    if (injected) {
+        return (0, dockerCliParsing_1.parsePublishedDockerHostPorts)(injected);
+    }
     const docker = inspectDockerAvailability();
     if (!docker.daemonReachable)
         return new Set();
@@ -2756,12 +2770,21 @@ async function executeSetupPlan(plan) {
             IRANTI_INSTANCE: plan.instanceName,
             IRANTI_INSTANCE_ENV: configured.envFile,
         });
+        const bindingEnv = await readEnvFile(written);
+        const learningStatus = await (0, projectLearning_1.writeProjectLearningSnapshot)({
+            projectPath,
+            projectEnvFile: written,
+            binding: bindingEnv,
+            agentId: project.agentId,
+        });
         bindings.push({
             projectPath,
             envFile: written,
             agentId: project.agentId,
             projectMode: project.projectMode,
             autoRemember: project.autoRemember,
+            codebaseEntity: bindingEnv.IRANTI_CODEBASE_ENTITY ?? (0, projectLearning_1.deriveProjectCodebaseEntity)(projectPath),
+            learningStatus,
         });
         if (project.claudeCode) {
             await writeClaudeCodeProjectFiles(projectPath);
@@ -2790,7 +2813,7 @@ async function executeSetupPlan(plan) {
         bindings,
     };
 }
-function parseSetupConfig(filePath) {
+async function parseSetupConfig(filePath) {
     const resolved = path_1.default.resolve(filePath);
     if (!fs_1.default.existsSync(resolved)) {
         throw new Error(`Setup config file not found: ${resolved}`);
@@ -2812,7 +2835,7 @@ function parseSetupConfig(filePath) {
             : databaseModeRaw === 'existing' || databaseModeRaw === 'local' || databaseModeRaw.length === 0
                 ? 'local'
                 : (() => { throw new Error(`Unsupported databaseMode in setup config: ${databaseModeRaw}`); })();
-    const databaseUrl = deriveDatabaseUrlForMode(databaseMode, instanceName, String(raw?.databaseUrl ?? raw?.dbUrl ?? '').trim());
+    const databaseUrl = await resolveSetupDatabaseUrl(databaseMode, instanceName, String(raw?.databaseUrl ?? raw?.dbUrl ?? '').trim());
     const databaseIntentStrategy = parseDatabaseIntentStrategyFlag(String(raw?.databaseIntent ?? raw?.dbIntent ?? '').trim(), 'databaseIntent');
     const provider = normalizeProvider(String(raw?.provider ?? 'mock')) ?? 'mock';
     if (!isSupportedProvider(provider)) {
@@ -2874,7 +2897,7 @@ function parseSetupConfig(filePath) {
         }),
     };
 }
-function defaultsSetupPlan(args) {
+async function defaultsSetupPlan(args) {
     const scope = normalizeScope(getFlag(args, 'scope'));
     const root = path_1.default.resolve(getFlag(args, 'root') ?? resolveInstallRoot(args, scope));
     const mode = getFlag(args, 'mode') === 'shared' ? 'shared' : 'isolated';
@@ -2901,7 +2924,7 @@ function defaultsSetupPlan(args) {
     const explicitDatabaseUrl = (getFlag(args, 'db-url')
         ?? (databaseMode === 'managed' ? process.env.DATABASE_URL : '')
         ?? '').trim();
-    const databaseUrl = deriveDatabaseUrlForMode(databaseMode, instanceName, explicitDatabaseUrl);
+    const databaseUrl = await resolveSetupDatabaseUrl(databaseMode, instanceName, explicitDatabaseUrl);
     const databaseIntentStrategy = parseDatabaseIntentStrategyFlag(getFlag(args, 'db-intent'), '--db-intent');
     const provider = normalizeProvider(getFlag(args, 'provider') ?? process.env.LLM_PROVIDER ?? 'mock') ?? 'mock';
     if (!isSupportedProvider(provider)) {
@@ -3491,6 +3514,23 @@ function deriveDatabaseUrlForMode(mode, instanceName, explicitDatabaseUrl) {
     }
     return `postgresql://${user}:${password}@${localDatabaseHost}:5432/iranti_${instanceName}`;
 }
+async function resolveSetupDatabaseUrl(mode, instanceName, explicitDatabaseUrl) {
+    if (mode !== 'docker') {
+        return deriveDatabaseUrlForMode(mode, instanceName, explicitDatabaseUrl);
+    }
+    const explicit = explicitDatabaseUrl?.trim() ?? '';
+    if (explicit && !detectPlaceholder(explicit)) {
+        return explicit;
+    }
+    const preferredPort = 5432;
+    const dockerPublishedPorts = listPublishedDockerHostPorts();
+    const selectedPort = await isPortUsable(preferredPort, '0.0.0.0', dockerPublishedPorts)
+        ? preferredPort
+        : await findNextAvailablePort(preferredPort + 1, '0.0.0.0', 50, dockerPublishedPorts);
+    const user = encodeURIComponent((process.env.POSTGRES_USER ?? 'postgres').trim() || 'postgres');
+    const password = encodeURIComponent((process.env.POSTGRES_PASSWORD ?? 'postgres').trim() || 'postgres');
+    return `postgresql://${user}:${password}@${preferredLocalDatabaseHost()}:${selectedPort}/iranti_${instanceName}`;
+}
 function preferredLocalDatabaseHost() {
     return process.platform === 'win32' ? '127.0.0.1' : 'localhost';
 }
@@ -5002,7 +5042,7 @@ async function setupCommand(args) {
         const dependencyChecks = await collectDependencyChecks();
         printDependencyChecks(dependencyChecks);
         console.log('');
-        const plan = configPath ? parseSetupConfig(configPath) : defaultsSetupPlan(args);
+        const plan = configPath ? await parseSetupConfig(configPath) : await defaultsSetupPlan(args);
         const result = await executeSetupPlan(plan);
         console.log(sectionTitle('Setup Complete'));
         console.log(`  runtime root   ${result.root}`);
@@ -5019,7 +5059,10 @@ async function setupCommand(args) {
         else {
             console.log('  projects');
             for (const binding of result.bindings) {
-                console.log(`    - ${binding.projectPath} (${binding.agentId}, ${binding.projectMode})`);
+                const learningSuffix = binding.learningStatus.status === 'written'
+                    ? `, learned=${binding.codebaseEntity}`
+                    : `, project-learning=${binding.learningStatus.status}`;
+                console.log(`    - ${binding.projectPath} (${binding.agentId}, ${binding.projectMode}${learningSuffix})`);
             }
         }
         printNextSteps([
@@ -5382,7 +5425,10 @@ async function setupCommand(args) {
     else {
         console.log('  projects');
         for (const binding of finalResult.bindings) {
-            console.log(`    - ${binding.projectPath} (${binding.agentId}, ${binding.projectMode}, auto-remember=${binding.autoRemember ? 'true' : 'false'})`);
+            const learningSuffix = binding.learningStatus.status === 'written'
+                ? `, codebase=${binding.codebaseEntity}`
+                : `, project-learning=${binding.learningStatus.status}`;
+            console.log(`    - ${binding.projectPath} (${binding.agentId}, ${binding.projectMode}, auto-remember=${binding.autoRemember ? 'true' : 'false'}${learningSuffix})`);
         }
     }
     const nextSteps = [
@@ -6557,10 +6603,21 @@ async function projectInitCommand(args) {
         IRANTI_INSTANCE: instanceName,
         IRANTI_INSTANCE_ENV: envFile,
     });
+    const writtenBinding = await readEnvFile(outFile);
+    const learningStatus = await (0, projectLearning_1.writeProjectLearningSnapshot)({
+        projectPath,
+        projectEnvFile: outFile,
+        binding: writtenBinding,
+        agentId,
+    });
     console.log(sectionTitle('Project Initialized'));
     console.log(`  status ${okLabel()}`);
     console.log(`  wrote ${outFile}`);
     console.log(`  mode  ${projectMode}`);
+    console.log(`  codebase ${writtenBinding.IRANTI_CODEBASE_ENTITY ?? (0, projectLearning_1.deriveProjectCodebaseEntity)(projectPath)}`);
+    if (learningStatus.status !== 'written') {
+        console.log(`  learn ${paint(learningStatus.status, learningStatus.status === 'failed' ? 'red' : 'yellow')} (${learningStatus.detail})`);
+    }
     printNextSteps([
         `iranti doctor --instance ${instanceName}`,
         'iranti chat',
@@ -6859,6 +6916,13 @@ async function configureProjectCommand(args) {
         throw new Error('Unable to determine IRANTI_API_KEY. Provide --api-key <token> or configure the instance first.');
     }
     const written = await writeProjectBinding(projectPath, updates);
+    const writtenBinding = await readEnvFile(written);
+    const learningStatus = await (0, projectLearning_1.writeProjectLearningSnapshot)({
+        projectPath,
+        projectEnvFile: written,
+        binding: writtenBinding,
+        agentId: updates.IRANTI_AGENT_ID,
+    });
     const json = hasFlag(args, 'json');
     const result = {
         projectPath,
@@ -6868,6 +6932,8 @@ async function configureProjectCommand(args) {
         autoRemember: updates.IRANTI_AUTO_REMEMBER === 'true',
         projectMode: updates.IRANTI_PROJECT_MODE,
         instance: updates.IRANTI_INSTANCE ?? null,
+        codebaseEntity: writtenBinding.IRANTI_CODEBASE_ENTITY ?? (0, projectLearning_1.deriveProjectCodebaseEntity)(projectPath),
+        projectLearning: learningStatus,
     };
     if (json) {
         console.log(JSON.stringify(result, null, 2));
@@ -6881,9 +6947,13 @@ async function configureProjectCommand(args) {
     console.log(`  agent    ${updates.IRANTI_AGENT_ID}`);
     console.log(`  remember ${updates.IRANTI_AUTO_REMEMBER}`);
     console.log(`  mode     ${updates.IRANTI_PROJECT_MODE}`);
+    console.log(`  codebase ${writtenBinding.IRANTI_CODEBASE_ENTITY ?? (0, projectLearning_1.deriveProjectCodebaseEntity)(projectPath)}`);
     if (updates.IRANTI_INSTANCE) {
         console.log(`  instance ${updates.IRANTI_INSTANCE}`);
     }
+    if (learningStatus.status !== 'written') {
+        console.log(`  learn    ${paint(learningStatus.status, learningStatus.status === 'failed' ? 'red' : 'yellow')} (${learningStatus.detail})`);
+    }
     printNextSteps([
         `iranti doctor${updates.IRANTI_INSTANCE ? ` --instance ${updates.IRANTI_INSTANCE}` : ''}`,
     ]);
@@ -6922,7 +6992,7 @@ async function authCreateKeyCommand(args) {
         const resolvedProjectPath = path_1.default.resolve(projectPath);
         const existingBindingFile = path_1.default.join(resolvedProjectPath, '.env.iranti');
         const existingBinding = fs_1.default.existsSync(existingBindingFile) ? await readEnvFile(existingBindingFile) : {};
-        await writeProjectBinding(resolvedProjectPath, {
+        const written = await writeProjectBinding(resolvedProjectPath, {
             IRANTI_URL: `http://localhost:${env.IRANTI_PORT ?? '3001'}`,
             IRANTI_API_KEY: created.token,
             IRANTI_AGENT_ID: agentId ?? existingBinding.IRANTI_AGENT_ID ?? 'my_agent',
@@ -6932,6 +7002,13 @@ async function authCreateKeyCommand(args) {
             IRANTI_INSTANCE: instanceName,
             IRANTI_INSTANCE_ENV: envFile,
         });
+        const binding = await readEnvFile(written);
+        await (0, projectLearning_1.writeProjectLearningSnapshot)({
+            projectPath: resolvedProjectPath,
+            projectEnvFile: written,
+            binding,
+            agentId: agentId ?? binding.IRANTI_AGENT_ID ?? 'my_agent',
+        });
     }
     if (hasFlag(args, 'json')) {
         console.log(JSON.stringify({