@gmickel/gno 2.5.1 → 2.7.0

package/spec/output-schemas/sessions-status.schema.json

@@ -0,0 +1,432 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/sessions-status@1.0",
+  "title": "GNO Session Archive Status",
+  "description": "Shared status of a session archive on every surface (CLI `gno sessions status --json`, MCP gno_sessions_status, REST GET /api/sessions/status, SDK client.sessionsStatus()). Derived from SessionsStatus in src/sessions/types.ts. Includes opt-in automation state. Contains no host paths and no session content.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "configured",
+    "index",
+    "collections",
+    "sources",
+    "automation",
+    "warnings"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "1"
+    },
+    "configured": {
+      "const": true
+    },
+    "index": {
+      "type": "string",
+      "minLength": 1
+    },
+    "collections": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "threads"],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "threads": {
+            "type": "integer",
+            "minimum": 0
+          }
+        }
+      }
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "harness",
+          "collection",
+          "available",
+          "units",
+          "archivedThreads",
+          "staleParser",
+          "sourceUnavailable",
+          "lastImportAt"
+        ],
+        "properties": {
+          "id": { "type": "string" },
+          "harness": { "enum": ["codex", "claude-code", "openclaw", "hermes"] },
+          "collection": { "type": "string" },
+          "available": {
+            "type": "boolean",
+            "description": "False when the source root is missing or cannot be listed."
+          },
+          "units": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "total",
+              "complete",
+              "incomplete",
+              "failed",
+              "pending"
+            ],
+            "properties": {
+              "total": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "complete": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "incomplete": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "failed": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "pending": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          },
+          "archivedThreads": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "staleParser": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Archived units produced by an older parser whose source is no longer available to reparse."
+          },
+          "sourceUnavailable": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Archived units whose source no longer exists; their archive is retained until an explicit prune."
+          },
+          "lastImportAt": {
+            "type": ["string", "null"],
+            "format": "date-time"
+          }
+        }
+      }
+    },
+    "automation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["daemon", "timezone", "profiles"],
+      "properties": {
+        "daemon": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state", "heartbeatAt"],
+          "properties": {
+            "state": {
+              "enum": ["running", "not_running", "stale"],
+              "description": "running only with a fresh heartbeat from a live daemon on this archive; serve never counts."
+            },
+            "heartbeatAt": {
+              "type": ["string", "null"],
+              "format": "date-time"
+            }
+          }
+        },
+        "timezone": {
+          "type": "string",
+          "description": "IANA timezone for human-readable times; stored instants are UTC."
+        },
+        "profiles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "sources",
+              "collections",
+              "state",
+              "hook",
+              "schedule",
+              "limit",
+              "retries",
+              "pending",
+              "running",
+              "lastTrigger",
+              "lastRun",
+              "lastSuccessAt",
+              "retryAt",
+              "recovery"
+            ],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "sources": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "collections": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "state": {
+                "enum": [
+                  "off",
+                  "idle",
+                  "pending",
+                  "running",
+                  "retrying",
+                  "partial",
+                  "failed"
+                ],
+                "description": "off: no trigger enabled and nothing pending. partial/failed describe the last run."
+              },
+              "hook": {
+                "oneOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["harness", "enabled", "installed"],
+                    "properties": {
+                      "harness": {
+                        "enum": ["claude-code"]
+                      },
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "installed": {
+                        "type": ["boolean", "null"],
+                        "description": "Owned entry present in the host settings file; null when the file cannot be read."
+                      }
+                    }
+                  }
+                ]
+              },
+              "schedule": {
+                "oneOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["enabled", "cadence", "nextDueAt"],
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "cadence": {
+                        "type": "string"
+                      },
+                      "nextDueAt": {
+                        "type": ["string", "null"],
+                        "format": "date-time",
+                        "description": "Null unless enabled and a daemon is running on this archive."
+                      }
+                    }
+                  }
+                ]
+              },
+              "limit": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "retries": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "pending": {
+                "oneOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["since", "triggers"],
+                    "properties": {
+                      "since": {
+                        "type": "string",
+                        "format": "date-time"
+                      },
+                      "triggers": {
+                        "type": "array",
+                        "items": {
+                          "enum": ["hook", "schedule", "manual"]
+                        }
+                      }
+                    }
+                  }
+                ]
+              },
+              "running": {
+                "oneOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["startedAt", "triggers"],
+                    "properties": {
+                      "startedAt": {
+                        "type": "string",
+                        "format": "date-time"
+                      },
+                      "triggers": {
+                        "type": "array",
+                        "items": {
+                          "enum": ["hook", "schedule", "manual"]
+                        }
+                      }
+                    }
+                  }
+                ]
+              },
+              "lastTrigger": {
+                "oneOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["kind", "at"],
+                    "properties": {
+                      "kind": {
+                        "enum": ["hook", "schedule", "manual"]
+                      },
+                      "at": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    }
+                  }
+                ]
+              },
+              "lastRun": {
+                "oneOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "$ref": "#/definitions/runRecord"
+                  }
+                ]
+              },
+              "lastSuccessAt": {
+                "type": ["string", "null"],
+                "format": "date-time"
+              },
+              "retryAt": {
+                "type": ["string", "null"],
+                "format": "date-time"
+              },
+              "recovery": {
+                "type": ["string", "null"]
+              }
+            }
+          }
+        }
+      }
+    },
+    "warnings": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "definitions": {
+    "runRecord": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "triggers",
+        "startedAt",
+        "finishedAt",
+        "outcome",
+        "reason",
+        "threads",
+        "units"
+      ],
+      "properties": {
+        "triggers": {
+          "type": "array",
+          "items": {
+            "enum": ["hook", "schedule", "manual"]
+          }
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "finishedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "outcome": {
+          "enum": ["complete", "up_to_date", "partial", "failed"]
+        },
+        "reason": {
+          "type": ["string", "null"],
+          "description": "Stable reason code for partial or failed runs, e.g. busy, runtime_error, source_revoked, source_unavailable, invalid_configuration, import_failed, interrupted, deferred, incomplete_units, index_sync_failed, unit_failures."
+        },
+        "threads": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["imported", "updated", "unchanged"],
+          "properties": {
+            "imported": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "updated": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "unchanged": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "units": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["incomplete", "failed", "deferred"],
+          "properties": {
+            "incomplete": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "failed": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "deferred": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/spec/output-schemas/status.schema.json

@@ -150,6 +150,104 @@
       "description": "Chunks awaiting embedding",
       "minimum": 0
     },
+    "vectorPartitions": {
+      "type": "array",
+      "description": "Vector partitions of the embedding model; omitted when none exist",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "model",
+          "dimensions",
+          "state",
+          "legacy",
+          "retrieval",
+          "droppable",
+          "owners",
+          "provenance",
+          "compatibleRuntimes",
+          "incompatibleRuntimes"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Partition id (drop with `gno vec drop <id-prefix>`)"
+          },
+          "model": {
+            "type": "string",
+            "description": "Embedding model URI"
+          },
+          "dimensions": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "state": {
+            "type": "string",
+            "enum": ["active", "shadow"],
+            "description": "active = activated for retrieval; shadow = incomplete or abandoned"
+          },
+          "legacy": {
+            "type": "boolean",
+            "description": "Pre-runtime-independent key, awaiting measured re-keying"
+          },
+          "retrieval": {
+            "type": "boolean",
+            "description": "Status counts use this partition: the activated runtime-independent partition every compatible runtime reads"
+          },
+          "droppable": {
+            "type": "boolean",
+            "description": "`gno vec drop` accepts it; never the partition this runtime's retrieval uses"
+          },
+          "owners": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Current chunks bound to this partition"
+          },
+          "provenance": {
+            "type": "string",
+            "description": "Runtime that built the partition, e.g. \"CUDA, Bun 1.4.2\""
+          },
+          "compatibleRuntimes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Runtimes measured (or recorded as the builder) to read this partition"
+          },
+          "incompatibleRuntimes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Runtimes measured incompatible; they read another partition or use lexical retrieval only"
+          }
+        }
+      }
+    },
+    "vectorRuntime": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "state", "partition"],
+      "description": "This process's runtime, resolved by the same selection rule its queries use",
+      "properties": {
+        "label": {
+          "type": ["string", "null"],
+          "description": "Runtime recorded by this caller's last query or embed"
+        },
+        "state": {
+          "type": "string",
+          "enum": ["vectors", "unavailable", "unresolved"],
+          "description": "vectors: queries read `partition`; unavailable: lexical retrieval only; unresolved: no query or embed has resolved this caller yet"
+        },
+        "partition": {
+          "type": ["string", "null"]
+        },
+        "reason": {
+          "type": "string"
+        }
+      }
+    },
     "recentErrors": {
       "type": "integer",
       "description": "Recent ingest errors in the last 24 hours",

package/src/cli/commands/ask.ts

@@ -15,6 +15,7 @@ import type {
 } from "../../llm/types";
 import type { AskOptions, AskResult, Citation } from "../../pipeline/types";
 
+import { decorateUriForIndex } from "../../app/constants";
 import { buildVerifiedAsk } from "../../app/verified-ask";
 import { resolveCliProjectAffinity } from "../../core/project-affinity-surface";
 import {
@@ -96,7 +97,7 @@ export async function ask(
   const globals = getGlobals();
 
   const initResult = await initStore({
-    configPath: options.configPath,
+    configPath: options.configPath ?? globals.config,
     indexName: globals.index,
     collection: options.collection,
     syncConfig: false,
@@ -434,9 +435,20 @@ export async function ask(
         return { success: false, error: finalized.error.message };
       }
     }
+    // URIs carry `?index=` like search and Capsule results on a named index.
     return {
       success: true,
-      data: askResult,
+      data: {
+        ...askResult,
+        results: askResult.results.map((result) => ({
+          ...result,
+          uri: decorateUriForIndex(result.uri, globals.index),
+        })),
+        citations: askResult.citations?.map((citation) => ({
+          ...citation,
+          uri: decorateUriForIndex(citation.uri, globals.index),
+        })),
+      },
       metadata: traceSession?.metadata(),
     };
   } catch (cause) {