@gmickel/gno 1.23.0 → 1.25.1

package/spec/output-schemas/setup-command-result.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/setup-command-result@1.0",
+  "title": "GNO Setup Command Result",
+  "description": "Closed standalone setup result with separate lexical and semantic projections.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "lexical", "semantic"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "status": { "enum": ["completed", "failed"] },
+    "lexical": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["receipt", "error"],
+      "properties": {
+        "receipt": {
+          "oneOf": [
+            { "$ref": "gno://schemas/setup-receipt@1.0" },
+            { "type": "null" }
+          ]
+        },
+        "error": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "message", "remediation"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "message": { "type": "string", "minLength": 1 },
+                "remediation": { "type": "string", "minLength": 1 }
+              }
+            },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "semantic": {
+      "oneOf": [
+        { "$ref": "gno://schemas/setup-semantic@1.0" },
+        { "type": "null" }
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "status": { "const": "completed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "lexical": {
+            "type": "object",
+            "properties": {
+              "receipt": {
+                "allOf": [
+                  { "$ref": "gno://schemas/setup-receipt@1.0" },
+                  {
+                    "type": "object",
+                    "properties": { "status": { "const": "completed" } },
+                    "required": ["status"]
+                  }
+                ]
+              },
+              "error": { "type": "null" }
+            }
+          },
+          "semantic": { "$ref": "gno://schemas/setup-semantic@1.0" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "failed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "lexical": {
+            "type": "object",
+            "properties": {
+              "error": { "type": "object" }
+            }
+          },
+          "semantic": { "type": "null" }
+        }
+      }
+    }
+  ]
+}

package/spec/output-schemas/setup-receipt.schema.json

@@ -0,0 +1,258 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/setup-receipt@1.0",
+  "title": "GNO Verified Folder Setup Receipt",
+  "description": "Canonical local receipt for resumable lexical-first folder setup.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "generatedAt",
+    "input",
+    "fingerprints",
+    "collection",
+    "paths",
+    "stages",
+    "pending",
+    "failure",
+    "activation"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "status": {
+      "enum": ["in_progress", "failed", "completed"]
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "folder",
+        "folderFingerprint",
+        "indexName",
+        "requestedName",
+        "excludes",
+        "secretRiskAuthorized"
+      ],
+      "properties": {
+        "folder": { "type": "string", "minLength": 1 },
+        "folderFingerprint": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "indexName": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "requestedName": {
+          "type": ["string", "null"],
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "excludes": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "secretRiskAuthorized": { "type": "boolean" }
+      }
+    },
+    "fingerprints": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["input", "config", "index"],
+      "properties": {
+        "input": { "$ref": "#/definitions/fingerprint" },
+        "config": {
+          "oneOf": [{ "$ref": "#/definitions/fingerprint" }, { "type": "null" }]
+        },
+        "index": {
+          "oneOf": [{ "$ref": "#/definitions/fingerprint" }, { "type": "null" }]
+        }
+      }
+    },
+    "collection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "path", "disposition"],
+      "properties": {
+        "name": {
+          "type": ["string", "null"],
+          "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+        },
+        "path": { "type": "string", "minLength": 1 },
+        "disposition": {
+          "enum": ["pending", "created", "reused"]
+        }
+      }
+    },
+    "paths": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["config", "receipt"],
+      "properties": {
+        "config": { "type": "string", "minLength": 1 },
+        "receipt": { "type": "string", "minLength": 1 }
+      }
+    },
+    "stages": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "preflight",
+        "config_saved",
+        "store_synced",
+        "lexical_indexed",
+        "lexical_proved",
+        "completed"
+      ],
+      "properties": {
+        "preflight": { "$ref": "#/definitions/stage" },
+        "config_saved": { "$ref": "#/definitions/stage" },
+        "store_synced": { "$ref": "#/definitions/stage" },
+        "lexical_indexed": { "$ref": "#/definitions/stage" },
+        "lexical_proved": { "$ref": "#/definitions/stage" },
+        "completed": { "$ref": "#/definitions/stage" }
+      }
+    },
+    "pending": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "failure": {
+      "oneOf": [{ "$ref": "#/definitions/failure" }, { "type": "null" }]
+    },
+    "activation": {
+      "oneOf": [
+        { "$ref": "gno://schemas/activation-verification@1.0" },
+        { "type": "null" }
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "type": "object",
+        "properties": { "status": { "const": "completed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "failure": { "type": "null" },
+          "activation": {
+            "allOf": [
+              { "$ref": "gno://schemas/activation-verification@1.0" },
+              {
+                "type": "object",
+                "properties": { "ready": { "const": true } },
+                "required": ["ready"]
+              }
+            ]
+          },
+          "stages": {
+            "type": "object",
+            "properties": {
+              "preflight": {
+                "type": "object",
+                "properties": { "status": { "const": "passed" } }
+              },
+              "config_saved": {
+                "type": "object",
+                "properties": { "status": { "const": "passed" } }
+              },
+              "store_synced": {
+                "type": "object",
+                "properties": { "status": { "const": "passed" } }
+              },
+              "lexical_indexed": {
+                "type": "object",
+                "properties": { "status": { "const": "passed" } }
+              },
+              "lexical_proved": {
+                "type": "object",
+                "properties": { "status": { "const": "passed" } }
+              },
+              "completed": {
+                "type": "object",
+                "properties": { "status": { "const": "passed" } }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "type": "object",
+        "properties": { "status": { "const": "failed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "failure": { "$ref": "#/definitions/failure" }
+        }
+      }
+    }
+  ],
+  "definitions": {
+    "fingerprint": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "stage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "token",
+        "startedAt",
+        "completedAt",
+        "code",
+        "remediation"
+      ],
+      "properties": {
+        "status": {
+          "enum": ["pending", "in_progress", "passed", "failed"]
+        },
+        "token": {
+          "type": ["string", "null"],
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "startedAt": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "completedAt": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "code": { "type": ["string", "null"] },
+        "remediation": { "type": ["string", "null"] }
+      }
+    },
+    "failure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "code", "message", "remediation"],
+      "properties": {
+        "stage": {
+          "enum": [
+            "preflight",
+            "config_saved",
+            "store_synced",
+            "lexical_indexed",
+            "lexical_proved",
+            "completed"
+          ]
+        },
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 },
+        "remediation": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/spec/output-schemas/setup-semantic-receipt.schema.json

@@ -0,0 +1,195 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/setup-semantic@1.0",
+  "title": "GNO Setup Semantic Handoff Receipt",
+  "description": "Privacy-bounded state for one standalone collection-scoped semantic setup worker.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "generatedAt",
+    "startedAt",
+    "completedAt",
+    "jobId",
+    "collection",
+    "indexName",
+    "folderFingerprint",
+    "pid",
+    "offline",
+    "setupReceiptFingerprint",
+    "setupReceiptPath",
+    "receiptPath",
+    "logPath",
+    "resumeCommand",
+    "counts",
+    "error"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "status": {
+      "enum": [
+        "scheduled",
+        "running",
+        "completed",
+        "failed",
+        "pending",
+        "skipped"
+      ]
+    },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "startedAt": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "completedAt": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "jobId": { "$ref": "#/definitions/fingerprint" },
+    "collection": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+    },
+    "indexName": { "type": "string", "minLength": 1, "maxLength": 64 },
+    "folderFingerprint": { "$ref": "#/definitions/fingerprint" },
+    "pid": {
+      "type": ["integer", "null"],
+      "minimum": 1
+    },
+    "offline": { "type": "boolean" },
+    "setupReceiptFingerprint": { "$ref": "#/definitions/fingerprint" },
+    "setupReceiptPath": { "type": "string", "minLength": 1 },
+    "receiptPath": { "type": "string", "minLength": 1 },
+    "logPath": { "type": "string", "minLength": 1 },
+    "resumeCommand": {
+      "type": "string",
+      "pattern": "^gno .* embed "
+    },
+    "counts": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["embedded", "errors"],
+          "properties": {
+            "embedded": { "type": "integer", "minimum": 0 },
+            "errors": { "type": "integer", "minimum": 0 }
+          }
+        },
+        { "type": "null" }
+      ]
+    },
+    "error": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["message", "remediation"],
+          "properties": {
+            "message": { "type": "string", "minLength": 1, "maxLength": 500 },
+            "remediation": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 8192
+            }
+          }
+        },
+        { "type": "null" }
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "status": { "const": "scheduled" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "startedAt": { "type": "null" },
+          "completedAt": { "type": "null" },
+          "counts": { "type": "null" },
+          "error": { "type": "null" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "running" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "pid": { "type": "integer", "minimum": 1 },
+          "startedAt": { "type": "string", "format": "date-time" },
+          "completedAt": { "type": "null" },
+          "counts": { "type": "null" },
+          "error": { "type": "null" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "completed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "pid": { "type": "null" },
+          "counts": { "type": "object" },
+          "error": { "type": "null" },
+          "completedAt": { "type": "string", "format": "date-time" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "failed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "pid": { "type": "null" },
+          "error": { "type": "object" },
+          "completedAt": { "type": "string", "format": "date-time" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "pending" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "completedAt": { "type": "null" },
+          "counts": { "type": "null" },
+          "error": { "type": "object" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "skipped" } },
+        "required": ["status"]
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "counts": { "type": "null" },
+          "error": { "type": "null" },
+          "completedAt": { "type": "string", "format": "date-time" }
+        }
+      }
+    }
+  ],
+  "definitions": {
+    "fingerprint": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    }
+  }
+}

package/src/cli/commands/completion/scripts.ts

@@ -14,6 +14,7 @@ export const SUPPORTED_SHELLS: Shell[] = ["bash", "zsh", "fish"];
  */
 const COMMANDS = [
   "init",
+  "setup",
   "index",
   "update",
   "embed",
@@ -317,6 +318,7 @@ export function getCompletionScript(shell: Shell): string {
 function getCommandDescription(cmd: string): string {
   const descriptions: Record<string, string> = {
     init: "Initialize GNO configuration",
+    setup: "Add and verify a folder",
     index: "Index files from collections",
     update: "Sync files from disk",
     embed: "Generate embeddings",

package/src/cli/commands/embed.ts

@@ -68,6 +68,8 @@ export interface EmbedOptions {
   json?: boolean;
   /** Verbose error logging */
   verbose?: boolean;
+  /** Use cached models only (also used by the standalone setup worker). */
+  offline?: boolean;
 }
 
 export type EmbedResult =
@@ -469,9 +471,12 @@ export async function embed(options: EmbedOptions = {}): Promise<EmbedResult> {
     }
 
     // Create LLM adapter and embedding port with auto-download
-    const globals = getGlobals();
+    let offline = options.offline;
+    if (offline === undefined) {
+      offline = getGlobals().offline;
+    }
     const policy = resolveDownloadPolicy(process.env, {
-      offline: globals.offline,
+      offline,
     });
 
     // Create progress renderer for model download (throttled to avoid spam)