@gmickel/gno 2.5.1 → 2.7.0

package/src/cli/commands/shared.ts

@@ -9,7 +9,11 @@ import type { Collection, Config } from "../../config/types";
 import type { SyncResult } from "../../ingestion";
 import type { SearchResults } from "../../pipeline/types";
 
-import { decorateUriForIndex, getIndexDbPath } from "../../app/constants";
+import {
+  DEFAULT_INDEX_NAME,
+  decorateUriForIndex,
+  getIndexDbPath,
+} from "../../app/constants";
 import {
   getConfigPaths,
   isInitialized,
@@ -17,6 +21,7 @@ import {
   writeConfigWarningsToStderr,
 } from "../../config";
 import { SqliteAdapter } from "../../store/sqlite/adapter";
+import { assertCliSessionBinding } from "../session-binding";
 
 /**
  * Result of CLI store initialization.
@@ -90,6 +95,14 @@ export async function initStore(
     };
   }
 
+  // Every index a command opens (including one named by a `?index=` URI)
+  // honours the session-archive config/index binding.
+  await assertCliSessionBinding(
+    options.configPath,
+    options.indexName ?? DEFAULT_INDEX_NAME,
+    config
+  );
+
   // Ensure data directory exists (may have been deleted by reset)
   const { ensureDirectories } = await import("../../config");
   await ensureDirectories();

package/src/cli/commands/status.ts

@@ -8,6 +8,7 @@
 import type { ContentTypeBoostStatus } from "../../config/content-types";
 import type { ActivationStatus } from "../../core/activation-status";
 import type { MemoryStatus } from "../../core/memory-diagnostics";
+import type { BackgroundIssue } from "../../serve/status-model";
 import type { IndexStatus } from "../../store/types";
 
 import { getIndexDbPath, getModelsCachePath } from "../../app/constants";
@@ -24,11 +25,18 @@ import {
   buildMemoryStatus,
   formatMemoryStatusLines,
 } from "../../core/memory-diagnostics";
+import { formatVectorPartitionLines } from "../../core/vector-partition-status";
 import { ModelCache } from "../../llm/cache";
 import { getActivePreset, resolveModelUri } from "../../llm/registry";
 import { getConnectorVerificationTargets } from "../../serve/connectors";
 import { createStandaloneResidentStatus } from "../../serve/resident-status";
 import { SqliteAdapter } from "../../store/sqlite/adapter";
+import {
+  formatBackgroundIssue,
+  residentIssues,
+  resolveProcessPaths,
+  statusProcess,
+} from "../detach";
 
 /**
  * Options for status command.
@@ -54,9 +62,35 @@ export type StatusResult =
       activation: ActivationStatus;
       contentTypeBoost: ContentTypeBoostStatus;
       memory: MemoryStatus;
+      backgroundIssues: ResidentBackgroundIssue[];
     }
   | { success: false; error: string };
 
+/** A background issue reported by (or about) a running detached resident. */
+export type ResidentBackgroundIssue = BackgroundIssue & {
+  process: "serve" | "daemon";
+  pid: number;
+};
+
+/**
+ * Ask each detached resident for its background issues. Each request is
+ * bounded (500ms), so a hung resident is reported, never waited on.
+ */
+async function collectResidentIssues(): Promise<ResidentBackgroundIssue[]> {
+  const statuses = await Promise.all(
+    (["serve", "daemon"] as const).map((kind) =>
+      statusProcess({ kind, ...resolveProcessPaths(kind) })
+    )
+  );
+  return statuses.flatMap((processStatus) =>
+    residentIssues(processStatus).map((issue) => ({
+      process: processStatus.cmd,
+      pid: processStatus.pid ?? 0,
+      ...issue,
+    }))
+  );
+}
+
 function connectorProjectionLine(activation: ActivationStatus): string | null {
   const { projected, total, truncated } = activation.connectorProjection;
   if (!truncated) {
@@ -117,6 +151,12 @@ function formatTerminal(
   if (indexStatus.embeddingBacklog > 0) {
     lines.push(`Embedding backlog: ${indexStatus.embeddingBacklog} chunks`);
   }
+  lines.push(
+    ...formatVectorPartitionLines(
+      indexStatus.vectorPartitions,
+      indexStatus.vectorRuntime
+    )
+  );
 
   const chunking = formatChunkingStatus(indexStatus.chunking);
   if (chunking) lines.push(chunking);
@@ -205,6 +245,11 @@ function formatMarkdown(
   lines.push(`- **Documents**: ${indexStatus.activeDocuments}`);
   lines.push(`- **Chunks**: ${indexStatus.totalChunks}`);
   lines.push(`- **Embedding backlog**: ${indexStatus.embeddingBacklog}`);
+  for (const line of formatVectorPartitionLines(
+    indexStatus.vectorPartitions,
+    indexStatus.vectorRuntime
+  ))
+    lines.push(`- ${line.trim()}`);
   if (indexStatus.typedMetadata)
     lines.push(
       `- **Typed metadata**: ${indexStatus.typedMetadata.pending} pending sync, ${indexStatus.typedMetadata.invalid} invalid`
@@ -318,6 +363,7 @@ export async function status(
       activation,
       contentTypeBoost: buildContentTypeBoostStatus(config.contentTypes ?? []),
       memory: await buildMemoryStatus(store, config.collections),
+      backgroundIssues: await collectResidentIssues(),
     };
   } finally {
     await store.close();
@@ -356,6 +402,8 @@ export function formatStatus(
         totalDocuments: s.activeDocuments,
         totalChunks: s.totalChunks,
         embeddingBacklog: s.embeddingBacklog,
+        vectorPartitions: s.vectorPartitions,
+        vectorRuntime: s.vectorRuntime,
         typedMetadata: s.typedMetadata,
         chunking: s.chunking,
         lastUpdated: s.lastUpdatedAt,
@@ -363,6 +411,9 @@ export function formatStatus(
         contentTypeBoost: result.contentTypeBoost,
         activation: result.activation,
         memory: result.memory,
+        ...(result.backgroundIssues.length
+          ? { backgroundIssues: result.backgroundIssues }
+          : {}),
       },
       null,
       2
@@ -378,10 +429,17 @@ export function formatStatus(
     );
   }
 
-  return formatTerminal(
-    result.status,
-    result.activation,
-    result.contentTypeBoost,
-    result.memory
+  const issueLines = result.backgroundIssues.map(
+    (issue) =>
+      `  ${issue.process} (pid ${issue.pid}): ${formatBackgroundIssue(issue)}`
   );
+  return [
+    formatTerminal(
+      result.status,
+      result.activation,
+      result.contentTypeBoost,
+      result.memory
+    ),
+    ...(issueLines.length ? ["", "Background issues:", ...issueLines] : []),
+  ].join("\n");
 }

package/src/cli/commands/vec.ts

@@ -13,6 +13,10 @@ import {
   createVectorIndexPort,
   createVectorStatsPort,
 } from "../../store/vector";
+import {
+  dropVectorPartition,
+  type VectorPartitionStatus,
+} from "../../store/vector/status";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
@@ -294,3 +298,53 @@ export function formatVecRebuild(
 
   return `Vec index rebuilt: ${result.count.toLocaleString()} vectors`;
 }
+
+export type VecDropResult =
+  | { success: true; partition: VectorPartitionStatus }
+  | { success: false; error: string };
+
+/**
+ * Drop an abandoned vector partition (shadow or legacy). Active partitions
+ * that retrieval uses are refused.
+ */
+export async function vecDrop(
+  partition: string,
+  options: VecOptions = {}
+): Promise<VecDropResult> {
+  if (!(await isInitialized(options.configPath)))
+    return { success: false, error: "GNO not initialized. Run: gno init" };
+  const configResult = await loadConfig(options.configPath);
+  if (!configResult.ok)
+    return { success: false, error: configResult.error.message };
+  const store = new SqliteAdapter();
+  const openResult = await store.open(
+    getIndexDbPath(options.indexName),
+    configResult.value.ftsTokenizer,
+    configResult.value.busyTimeoutMs
+  );
+  if (!openResult.ok)
+    return { success: false, error: openResult.error.message };
+  try {
+    const dropped = await dropVectorPartition(store.getRawDb(), partition);
+    return dropped.ok
+      ? { success: true, partition: dropped.partition }
+      : { success: false, error: dropped.error };
+  } finally {
+    await store.close();
+  }
+}
+
+export function formatVecDrop(
+  result: VecDropResult,
+  options: { json?: boolean }
+): string {
+  if (!result.success) {
+    return options.json
+      ? JSON.stringify({ error: { code: "RUNTIME", message: result.error } })
+      : `Error: ${result.error}`;
+  }
+  const { partition } = result;
+  return options.json
+    ? JSON.stringify({ dropped: partition }, null, 2)
+    : `Dropped ${partition.state} partition ${partition.id.slice(0, 12)} (${partition.provenance}, ${partition.owners} chunks)`;
+}

package/src/cli/detach.ts

@@ -20,7 +20,7 @@ import { mkdir, stat, unlink } from "node:fs/promises";
 // node:path — no Bun path utils.
 import { dirname, join } from "node:path";
 
-import type { ResidentStatus } from "../serve/status-model";
+import type { BackgroundIssue, ResidentStatus } from "../serve/status-model";
 
 import { VERSION, resolveDirs } from "../app/constants";
 import { toAbsolutePath } from "../config/paths";
@@ -840,6 +840,34 @@ export async function statusProcess(
   };
 }
 
+/** Issues a running detached resident reports, or that it failed to answer at all. */
+export function residentIssues(status: ProcessStatus): BackgroundIssue[] {
+  if (!status.running) return [];
+  if (!status.resident)
+    return [
+      {
+        job: "resident",
+        state: "unresponsive",
+        consecutiveFailures: 0,
+        runningSeconds: null,
+      },
+    ];
+  return status.resident.backgroundIssues ?? [];
+}
+
+export function formatBackgroundIssue(issue: BackgroundIssue): string {
+  switch (issue.state) {
+    case "unresponsive":
+      return "resident did not answer its status request within 500ms (busy or hung)";
+    case "failing":
+      return `background embed failing (${issue.consecutiveFailures} failed passes in a row; details in the log)`;
+    case "parked":
+      return `background embed parked after ${issue.consecutiveFailures} failed passes; pending chunks wait for new changes or \`gno embed\``;
+    case "overrunning":
+      return `background embed pass running for ${issue.runningSeconds ?? 0}s`;
+  }
+}
+
 /**
  * Inspect the pid-file for a "live-foreign" signal — a live pid whose
  * recorded gno version disagrees with the currently running binary. Returns

package/src/cli/errors.ts

@@ -9,15 +9,19 @@
 // Error Types
 // ─────────────────────────────────────────────────────────────────────────────
 
-export type CliErrorCode =
-  | "VALIDATION"
-  | "RUNTIME"
-  | "NOT_RUNNING"
-  | "BUSY"
-  | "AUDIT_FINDINGS"
-  | "AUDIT_PARTIAL"
-  | "CONTEXT_STALE"
-  | "CONTEXT_CONFLICT";
+/** Every code the CLI error model can emit; `error.schema.json` must list each. */
+export const CLI_ERROR_CODES = [
+  "VALIDATION",
+  "RUNTIME",
+  "NOT_RUNNING",
+  "BUSY",
+  "AUDIT_FINDINGS",
+  "AUDIT_PARTIAL",
+  "CONTEXT_STALE",
+  "CONTEXT_CONFLICT",
+] as const;
+
+export type CliErrorCode = (typeof CLI_ERROR_CODES)[number];
 
 export interface CliErrorOptions {
   details?: Record<string, unknown>;