@lore-co/cli 0.2.27 → 0.2.29

package/dist/cli.js

@@ -2,7 +2,7 @@
 import { parseDirectoryRules, checkDirectory, checkDirectoryRules, checkLoreAccess, checkWorkspaceRepository, capturePauseMessage, LORE_DISABLED_MESSAGE, loreDisabled } from "./directory-policy.js";
 import { reportCommand, runTelemetryCommand, telemetryEnabled, trackedCommand, TELEMETRY_HELP } from "./telemetry.js";
 import { secureWindowsDirectory, windowsPermissionsArePrivate } from "./windows-permissions.js";
-import { COMMAND_GUIDES, ROOT_HELP, helpTopic } from "./command-help.js";
+import { ALL_HELP, COMMAND_GUIDES, ROOT_HELP, helpTopic } from "./command-help.js";
 import { runShareCommand } from "./share.js";
 import { resolveConnectProject, validateConnectProjectOptions } from "./connect-project.js";
 import { captureDirectories } from "./capture-scope.js";
@@ -30,7 +30,9 @@ import { runChatCommand } from "./chat.js";
 import { runLearningsCommand } from "./learnings.js";
 import { runReviewCommand } from "./review.js";
 import { runEmbeddingsCommand } from "./embeddings.js";
+import { CAPTURE_REPAIR_HELP, runCaptureRepairCommand } from "./capture-repair.js";
 import { runRememberCommand } from "./remember.js";
+import { runDraftsCommand } from "./drafts.js";
 import { installLoreSkill, loreSkillFiles, recapSkillFiles, removeLoreSkill } from "./skills.js";
 import { GENERIC_AGENT, genericInstructions, genericMcpServers, parseGenericAgentId, readGenericAgents, recordGenericAgent, removeGenericAgents } from "./generic-mcp.js";
 import { installLoreAgent, loreAgentFiles, removeLoreAgent } from "./lore-agent.js";
@@ -145,7 +147,7 @@ Options:
   --write               With --agent generic: let the agent save through MCP (saves stay proposals)
   --timeout-ms <ms>     Hook request timeout, 250-10000 (default: 2500)
   --fallback <agent>   claude, codex, opencode, devin, cursor, copilot-cli, polytoken
-  --no-recovery        Disable automatic handoff setup (otherwise enabled with two installed clients)
+  --no-recovery        Disable automatic handoff setup (otherwise set up between the agents you connect)
   --verbose             Also list the files written and the connection details
   --json                Print machine-readable output
   --help                Show this command's help
@@ -166,14 +168,18 @@ Examples:
   lore connect --token "$LORE_WORKSPACE_TOKEN" --agent cursor
 `;
 const STATUS_HELP = `lore status
-Show exact installation, declared capabilities, and last invocation health.
+Show whether Lore is connected, whether it records in this folder, and which agents have used it.
 
 Usage:
-  lore status [--json]
+  lore status [--verbose] [--json]
+
+Options:
+  --verbose  Also show installation, capture queue, cache, and Guard details
+  --json     Print every detail as JSON
 
 Examples:
   lore status
-  lore status --json
+  lore status --verbose
 `;
 const DOCTOR_HELP = `lore doctor
 Check local security, exact wiring, invocation health, binaries, and Lore health.
@@ -193,6 +199,7 @@ Usage:
   lore capture off [--json]
   lore capture on [--json]
   lore capture reminder off|on [--json]
+  lore capture repair [--json]
 
 With capture off, Lore installs no Stop or SessionEnd hooks and never sends a
 prompt or response as a turn. Context injection, Guard, lore ask, lore remember,
@@ -202,11 +209,15 @@ decide where Lore runs at all.
 While nothing is recorded, Lore asks your agent to suggest /recap once in a
 session where you confirm a decision. lore capture reminder off stops that.
 
+lore capture repair retries captures the server dead-lettered while its
+extraction provider was down. See lore help capture repair.
+
 Examples:
   lore capture off
   lore capture status
   lore capture reminder off
   lore capture on
+  lore capture repair
 `;
 const DISCONNECT_HELP = `lore disconnect
 Remove Lore-owned hooks/plugin, credentials, runtime, and transient state.
@@ -2161,9 +2172,13 @@ async function connectWithCredentialLocked(options, identity) {
     const recoveryEnv = options.home === undefined ? process.env : { ...process.env, ZDOTDIR: paths.home };
     let recoveryWarning;
     const externalRecoveryHost = options.agents.some(agent => ["t3code", "cowork", "copilot-vscode"].includes(agent));
+    // Named agents limit recovery to themselves; auto-detection already installs every detected agent.
+    const namedRecoveryAgents = options.agents.length === 0 ? undefined
+        : options.agents.map(agent => agent === "copilot" ? "copilot-cli" : agent);
+    const namedSources = namedRecoveryAgents?.filter((agent) => isRecoverySource(agent) && agent !== options.fallback);
     const installRecovery = options.fallback === undefined ? options.recovery === true ?
-        await prepareAutomaticRecovery(paths, recoveryEnv).catch((error) => { recoveryWarning = `Automatic recovery setup: ${error.message}`; return undefined; }) : undefined :
-        await prepareRecoveryInstallation(paths, options.fallback, recoveryEnv).catch((error) => {
+        await prepareAutomaticRecovery(paths, recoveryEnv, namedRecoveryAgents).catch((error) => { recoveryWarning = `Automatic recovery setup: ${error.message}`; return undefined; }) : undefined :
+        await prepareRecoveryInstallation(paths, options.fallback, recoveryEnv, namedSources?.length ? namedSources : undefined).catch((error) => {
             // A desktop host can be the source even when only its destination is on PATH.
             if (externalRecoveryHost && error.message.startsWith("No supported source client is installed."))
                 return undefined;
@@ -3151,20 +3166,59 @@ async function connectedServerVersion(config) {
         return null;
     }
 }
+/** The default `lore status`: what someone needs to know, and the one next step. */
+export function statusSummary(data, healthLines, workspaceName) {
+    if (!data.connected)
+        return "Lore isn't connected on this machine.\nNext: lore connect --login\n";
+    const lines = [...healthLines, workspaceName ? `Connected to ${workspaceName}.` : "Connected."];
+    lines.push(!data.folderAccess.allowed
+        ? `This folder: Lore is off (${data.folderAccess.reason}).`
+        : data.capture === "off" ? "This folder: context and Guard on; recording off."
+            : data.captureSwitches.pausedBy !== null ? `This folder: context and Guard on; ${capturePauseMessage(data.captureSwitches.pausedBy).toLowerCase()}.`
+                : "This folder: recording on.");
+    const agents = data.agents.filter((agent) => agent.configured);
+    const day = (value) => value === null ? "" : new Date(value).toISOString().slice(0, 10);
+    let next = null;
+    if (agents.length > 0) {
+        const width = Math.max(...agents.map((agent) => agentDisplayName(agent.agent).length));
+        lines.push("Agents:");
+        for (const agent of agents) {
+            const broken = agent.installation.state !== "complete" || agent.invocationError !== null
+                || agent.invocation.state === "failed" || agent.invocation.state === "incomplete";
+            if (broken)
+                next ??= "lore doctor";
+            const state = agent.installation.state !== "complete" ? "setup incomplete"
+                : agent.invocationError !== null || agent.invocation.state === "failed" || agent.invocation.state === "incomplete" ? "last run failed"
+                    : agent.invocation.state === "successful" ? `last used ${day(agent.invocation.lastSuccessfulAt)}`
+                        : "not used yet";
+            lines.push(`  ${agentDisplayName(agent.agent).padEnd(width)}  ${state}`);
+        }
+    }
+    if (next !== null)
+        lines.push(`Next: ${next}`);
+    lines.push("Details: lore status --verbose");
+    return `${lines.join("\n")}\n`;
+}
 async function statusCommand(args) {
-    const parsed = parseOutputArguments(args, STATUS_HELP, "status");
+    const verbose = args.includes("--verbose");
+    const parsed = parseOutputArguments(args.filter((argument) => argument !== "--verbose"), STATUS_HELP, "status");
     if (parsed === null) {
         return;
     }
     const paths = getLorePaths();
+    const config = await diagnosticConfig(paths, process.cwd());
     const [statusResult, serverVersion] = await Promise.all([
         statusData(paths, process.cwd()),
-        diagnosticConfig(paths, process.cwd()).then((config) => config === null ? null : connectedServerVersion(config)),
+        config === null ? null : connectedServerVersion(config),
     ]);
     const health = statusHealth(statusResult, serverVersion);
     const data = { ...statusResult, health };
     if (!parsed.json && loreDisabled(process.env))
         process.stdout.write(`${LORE_DISABLED_MESSAGE}\n`);
+    if (!parsed.json && !verbose) {
+        process.stdout.write(statusSummary(data, health.lines, config?.workspaceName));
+        return;
+    }
     if (!parsed.json && data.connection)
         process.stdout.write(`connection: ${data.connection}\n`);
     const agentLines = data.agents
@@ -3320,17 +3374,18 @@ export function captureModeCheck(capture, switches = CAPTURE_SWITCHES_UNCHECKED)
     };
 }
 /**
- * Server-side queue health. Dead embedding jobs name the operator fix: once the
- * provider is repaired, `lore embeddings repair` retries them without waiting
- * for the reconciler's backoff.
+ * Server-side queue health. Dead jobs name the operator fix: once the provider
+ * is repaired, `lore capture repair` and `lore embeddings repair` retry them
+ * without waiting for a new capture or the reconciler's backoff.
  */
 export function operationalMetricsCheck(metrics) {
     const captureBacklog = metrics.captureReplay.captureExtraction.pending +
         metrics.captureReplay.captureExtraction.running;
     const embeddingBacklog = metrics.captureReplay.memoryEmbedding.pending +
         metrics.captureReplay.memoryEmbedding.running;
+    const captureDeadLetters = metrics.captureReplay.captureExtraction.dead;
     const embeddingDeadLetters = metrics.captureReplay.memoryEmbedding.dead;
-    const deadLetters = metrics.captureReplay.captureExtraction.dead + embeddingDeadLetters;
+    const deadLetters = captureDeadLetters + embeddingDeadLetters;
     const detectedFailures = metrics.silentFailures.count +
         metrics.guard.failures +
         deadLetters;
@@ -3344,6 +3399,9 @@ export function operationalMetricsCheck(metrics) {
                 ? "warning"
                 : "ok",
         detail: `${detectedFailures} detected failure(s), ${captureBacklog} capture and ${embeddingBacklog} embedding job(s) in backlog; ${metrics.guard.latency.samples} Guard latency sample(s)` +
+            (captureDeadLetters > 0
+                ? `; ${captureDeadLetters} dead capture job(s): once the extraction provider is back, run lore capture repair`
+                : "") +
             (embeddingDeadLetters > 0
                 ? `; ${embeddingDeadLetters} dead embedding job(s): fix the embedding provider, then run lore embeddings repair`
                 : ""),
@@ -3550,6 +3608,10 @@ export async function setRecapReminder(reminder, paths = getLorePaths()) {
     return { recapReminder: reminder, changed: true };
 }
 async function captureCommand(args) {
+    if (args[0] === "repair") {
+        await runCaptureRepairCommand(args.slice(1), await readConnectorConfig(getLorePaths(), process.cwd()));
+        return;
+    }
     if (args[0] === "reminder") {
         const json = args.includes("--json");
         const [reminder, ...extra] = args.slice(1).filter((argument) => argument !== "--json");
@@ -3576,7 +3638,7 @@ async function captureCommand(args) {
             mode = argument;
             continue;
         }
-        throw new Error("Usage: lore capture [status|on|off|reminder off|reminder on] [--json]");
+        throw new Error("Usage: lore capture [status|on|off|reminder off|reminder on|repair] [--json]");
     }
     const paths = getLorePaths();
     if (mode === undefined || mode === "status") {
@@ -3655,13 +3717,18 @@ async function doctorCommand(args) {
     checks.push({
         name: "config",
         status: config === null ? "error" : "ok",
-        detail: config === null ? `missing or invalid: ${paths.config}` : paths.config,
-    });
-    checks.push({
-        name: "config-permissions",
-        status: ["600", "private-acl"].includes(status.configMode ?? "") ? "ok" : "error",
-        detail: status.configMode ?? "missing",
+        detail: config === null ? `not connected (${paths.config} is missing or invalid). Run lore connect --login` : paths.config,
     });
+    // Without a config there is nothing to protect yet; the check above says what to do.
+    if (config !== null)
+        checks.push({
+            name: "config-permissions",
+            status: ["600", "private-acl"].includes(status.configMode ?? "") ? "ok" : "error",
+            detail: status.configMode ?? "missing",
+        });
+    // A fresh connection has not been used yet; that is expected for a day, not a problem.
+    const connectedAt = config === null ? Number.NaN : Date.parse(config.connectedAt);
+    const recentlyConnected = Number.isFinite(connectedAt) && Date.now() - connectedAt < 24 * 60 * 60 * 1000;
     if (status.runtimeRequired) {
         checks.push({
             name: "runtime",
@@ -3689,7 +3756,9 @@ async function doctorCommand(args) {
                     : agent.invocation.state === "failed" ||
                         agent.invocation.state === "incomplete"
                         ? "error"
-                        : "warning",
+                        : agent.invocation.state === "never_observed" && recentlyConnected
+                            ? "ok"
+                            : "warning",
             detail: agent.invocationError !== null
                 ? agent.invocationError === "runtime_version_mismatch"
                     ? `observed Lore ${agent.invocation.runtimeVersion}; expected ${LORE_VERSION}`
@@ -3701,7 +3770,9 @@ async function doctorCommand(args) {
                         : agent.invocation.state === "incomplete"
                             ? `last invocation did not complete (${agent.invocation.lastAttemptedAt})`
                             : agent.invocation.state === "never_observed"
-                                ? "installed, but no invocation has been observed yet"
+                                ? recentlyConnected
+                                    ? "installed, not used yet"
+                                    : `installed, but not used since connecting. Start a session in ${agentDisplayName(agent.agent)}, then run lore doctor again`
                                 : "invocation health is unavailable",
         });
         if (agent.agent === "codex" && agent.executable) {
@@ -3725,23 +3796,28 @@ async function doctorCommand(args) {
             detail: "surface-specific repository configuration; local installation is not claimed",
         });
     }
-    checks.push({
-        name: "reliability-store",
-        status: status.reliabilityError !== null
-            ? "error"
-            : status.reliability === null
-                ? "warning"
-                : "ok",
-        detail: status.reliabilityError ??
-            status.reliability?.directory ??
-            "not initialized",
-    });
+    if (config !== null)
+        checks.push({
+            name: "reliability-store",
+            status: status.reliabilityError !== null
+                ? "error"
+                : status.reliability === null
+                    ? "warning"
+                    : "ok",
+            detail: status.reliabilityError ??
+                status.reliability?.directory ??
+                "not initialized",
+        });
     if (status.reliability !== null) {
         checks.push(durableOutboxCheck(status.reliability.outbox, prunedDeadLetters));
+        // Keys are pinned on the first delivery, so an unused connection has none yet.
+        const unused = status.agents.every((agent) => !agent.configured || agent.invocation.state === "never_observed");
         checks.push({
             name: "verified-snapshot-cache",
-            status: status.reliability.trustKeys > 0 ? "ok" : "warning",
-            detail: `${status.reliability.cache.context} context, ${status.reliability.cache.policy} policy, ${status.reliability.trustKeys} pinned key(s)`,
+            status: status.reliability.trustKeys > 0 || unused ? "ok" : "warning",
+            detail: status.reliability.trustKeys === 0 && unused
+                ? "empty until the first prompt"
+                : `${status.reliability.cache.context} context, ${status.reliability.cache.policy} policy, ${status.reliability.trustKeys} pinned key(s)`,
         });
         const operational = status.reliability.operational;
         const detectedFailures = operational.guard.failures + operational.retrieval.failed;
@@ -3806,7 +3882,7 @@ async function printCommandHelp(path) {
             process.stdout.write(DOCTOR_HELP);
             return;
         case "capture":
-            process.stdout.write(CAPTURE_HELP);
+            process.stdout.write(topic.subcommand === "repair" ? CAPTURE_REPAIR_HELP : CAPTURE_HELP);
             return;
         case "embeddings":
             await runEmbeddingsCommand(args, null);
@@ -3835,6 +3911,9 @@ async function printCommandHelp(path) {
         case "remember":
             await runRememberCommand(args, null);
             return;
+        case "drafts":
+            await runDraftsCommand(args, null);
+            return;
         case "approach":
             await runApproachCommand(args, null);
             return;
@@ -3908,6 +3987,8 @@ async function executeCli(args = process.argv.slice(2)) {
         const path = args.slice(1);
         if (!path.length || (path.length === 1 && ["--help", "-h"].includes(path[0])))
             process.stdout.write(ROOT_HELP);
+        else if (path.length === 1 && path[0] === "--all")
+            process.stdout.write(ALL_HELP);
         else
             await printCommandHelp(path);
         return;
@@ -3929,7 +4010,7 @@ async function executeCli(args = process.argv.slice(2)) {
         return;
     }
     const commandArgs = args.slice(1);
-    if (["ask", "chat", "learnings", "review", "remember", "share", "resume", "continue", "approach", "skill"].includes(command) && !(command === "skill" && commandArgs[0] === "discover")) {
+    if (["ask", "chat", "learnings", "review", "remember", "drafts", "share", "resume", "continue", "approach", "skill"].includes(command) && !(command === "skill" && commandArgs[0] === "discover")) {
         const decision = await checkDirectory(process.cwd(), getLorePaths(["approach", "skill"].includes(command) ? process.env.LORE_HOME : undefined).home);
         if (!decision.allowed)
             throw new Error(`Lore is off in this folder. ${decision.reason}`);
@@ -3984,6 +4065,9 @@ async function executeCli(args = process.argv.slice(2)) {
         case "remember":
             await runRememberCommand(commandArgs, await readConnectorConfig(getLorePaths(), process.cwd()));
             return;
+        case "drafts":
+            await runDraftsCommand(commandArgs, await readConnectorConfig(getLorePaths(), process.cwd()));
+            return;
         case "approach":
             await runApproachCommand(commandArgs, await readConnectorConfig(getLorePaths(process.env.LORE_HOME), process.cwd()));
             return;