@gmickel/gno 1.25.1 → 1.26.0

package/spec/output-schemas/project-profile-command.schema.json

@@ -0,0 +1,160 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/project-profile-command@1.0",
+  "title": "GNO Project Profile Read Command",
+  "description": "Deterministic, path-redacted result shared by profile check, show, and diff.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "command",
+    "status",
+    "valid",
+    "discovery",
+    "profile",
+    "diff",
+    "diagnostics"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "command": { "enum": ["check", "show", "diff"] },
+    "status": { "enum": ["valid", "invalid", "not_found", "disabled"] },
+    "valid": { "type": "boolean" },
+    "discovery": { "$ref": "#/definitions/discovery" },
+    "profile": {
+      "oneOf": [{ "$ref": "#/definitions/profile" }, { "type": "null" }]
+    },
+    "diff": {
+      "oneOf": [{ "$ref": "#/definitions/diff" }, { "type": "null" }]
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/diagnostic" }
+    }
+  },
+  "definitions": {
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "path", "message", "remediation"],
+      "properties": {
+        "code": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" },
+        "severity": { "enum": ["error", "warning"] },
+        "path": { "type": "string" },
+        "message": { "type": "string", "minLength": 1 },
+        "remediation": { "type": "string", "minLength": 1 }
+      }
+    },
+    "discovery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "source",
+        "boundary",
+        "profile",
+        "ambiguous",
+        "shadowedProfiles"
+      ],
+      "properties": {
+        "status": { "enum": ["found", "not_found", "disabled", "error"] },
+        "source": { "enum": ["cwd", "override", "remote"] },
+        "boundary": {
+          "enum": ["repository", "filesystem", "explicit", "remote"]
+        },
+        "profile": {
+          "type": ["string", "null"],
+          "enum": [".gno/index.yml", null]
+        },
+        "ambiguous": { "type": "boolean" },
+        "shadowedProfiles": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fingerprint", "desiredState"],
+      "properties": {
+        "fingerprint": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "desiredState": {
+          "oneOf": [{ "type": "object" }, { "type": "null" }]
+        }
+      }
+    },
+    "change": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "field", "destructive", "summary"],
+      "properties": {
+        "action": { "enum": ["add", "update", "repair", "review"] },
+        "field": { "type": "string", "minLength": 1 },
+        "destructive": { "type": "boolean" },
+        "summary": { "type": "string", "minLength": 1 }
+      }
+    },
+    "staleMapping": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["collection", "reason", "choices"],
+      "properties": {
+        "collection": { "type": "string", "minLength": 1 },
+        "reason": { "enum": ["name_changed", "root_changed"] },
+        "choices": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 2,
+          "items": { "enum": ["repair", "remove_explicitly"] }
+        }
+      }
+    },
+    "diff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "changes", "staleMappings"],
+      "properties": {
+        "status": { "enum": ["in_sync", "changes_required"] },
+        "changes": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/change" }
+        },
+        "staleMappings": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/staleMapping" }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "valid": { "const": true } },
+        "required": ["valid"]
+      },
+      "then": {
+        "properties": {
+          "status": { "const": "valid" },
+          "profile": { "$ref": "#/definitions/profile" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "command": { "const": "diff" } },
+        "required": ["command"]
+      },
+      "then": {
+        "properties": {
+          "diff": {
+            "oneOf": [{ "$ref": "#/definitions/diff" }, { "type": "null" }]
+          }
+        }
+      },
+      "else": {
+        "properties": { "diff": { "type": "null" } }
+      }
+    }
+  ]
+}

package/spec/output-schemas/query-diagnose.schema.json

@@ -149,7 +149,13 @@
         },
         "source": {
           "type": ["string", "null"],
-          "enum": ["cli_cwd", "cli_explicit", "cli_worktree", null]
+          "enum": [
+            "cli_cwd",
+            "cli_explicit",
+            "cli_worktree",
+            "project_profile",
+            null
+          ]
         }
       },
       "additionalProperties": false

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

@@ -0,0 +1,87 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/setup-profile-result@1.0",
+  "title": "GNO Setup Profile Result",
+  "description": "Closed opt-in project-profile apply composition around verified setup and optional connectors.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "profile", "setup", "connectors"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "status": {
+      "enum": ["completed", "completed_with_actions", "failed"]
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["check", "apply"],
+      "properties": {
+        "check": {
+          "allOf": [
+            { "$ref": "gno://schemas/project-profile-command@1.0" },
+            {
+              "type": "object",
+              "properties": { "command": { "const": "check" } },
+              "required": ["command"]
+            }
+          ]
+        },
+        "apply": {
+          "oneOf": [
+            { "$ref": "gno://schemas/project-profile-apply@1.0" },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "setup": { "$ref": "gno://schemas/setup-command-result@1.0" },
+    "connectors": {
+      "$ref": "gno://schemas/setup-activation-result@1.0#/properties/connectors"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "status": { "const": "completed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "profile": {
+            "type": "object",
+            "properties": {
+              "check": {
+                "type": "object",
+                "properties": { "status": { "const": "valid" } }
+              },
+              "apply": {
+                "type": "object",
+                "properties": {
+                  "status": { "enum": ["applied", "unchanged"] }
+                }
+              }
+            }
+          },
+          "setup": {
+            "type": "object",
+            "properties": { "status": { "const": "completed" } }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "failed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "setup": {
+            "type": "object",
+            "properties": { "status": { "const": "failed" } }
+          }
+        }
+      }
+    }
+  ]
+}

package/spec/project-profile.schema.json

@@ -0,0 +1,301 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://gno.sh/schemas/project-profile-1.0.json",
+  "title": "GNO project retrieval profile",
+  "description": "Portable, declarative retrieval state for a single project collection.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "collection"],
+  "properties": {
+    "schemaVersion": {
+      "const": "1.0"
+    },
+    "collection": {
+      "$ref": "#/definitions/collection"
+    },
+    "contexts": {
+      "type": "array",
+      "maxItems": 64,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/definitions/context"
+      },
+      "default": []
+    },
+    "contentTypes": {
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": {
+        "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+      },
+      "additionalProperties": {
+        "$ref": "#/definitions/contentType"
+      },
+      "default": {}
+    },
+    "affinityDefaults": {
+      "$ref": "#/definitions/affinityDefaults"
+    },
+    "recommendedCapabilities": {
+      "type": "array",
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9._-]{0,63}$"
+      },
+      "default": []
+    }
+  },
+  "definitions": {
+    "portableRule": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "allOf": [
+        {
+          "not": {
+            "type": "string",
+            "pattern": "^(?:[/\\\\]|[A-Za-z]:|~)"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$)"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "[{}]"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "^!"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "[<>:\"|\\u0000-\\u001f]"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "(?:^|[\\\\/])(?:[cC][oO][nN]|[pP][rR][nN]|[aA][uU][xX]|[nN][uU][lL]|[cC][oO][mM][1-9]|[lL][pP][tT][1-9])(?:\\.[^\\\\/]*)?(?:[\\\\/]|$)"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "(?:^|[\\\\/])(?:[^.\\\\/][^\\\\/]*|\\.[^\\\\/]+)[. ](?:[\\\\/]|$)"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "(?:\\$\\{|\\$[A-Za-z_]|%[A-Za-z_][A-Za-z0-9_]*%)"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "\\u0000"
+          }
+        }
+      ]
+    },
+    "portablePath": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/portableRule"
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "[*?\\[\\]{}]"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "(?:^|[\\\\/])\\.[gG][nN][oO](?:[\\\\/]|$)"
+          }
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "\\.(?:[dD][bB]|[sS][qQ][lL][iI][tT][eE](?:3)?|[gG][gG][uU][fF]|[lL][oO][cC][kK])$"
+          }
+        }
+      ]
+    },
+    "portableInclude": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/portableRule"
+        },
+        {
+          "not": {
+            "type": "string",
+            "pattern": "(?:^|[\\\\/])\\.[gG][nN][oO](?:[\\\\/]|$)|\\.(?:[dD][bB]|[sS][qQ][lL][iI][tT][eE](?:3)?|[gG][gG][uU][fF]|[lL][oO][cC][kK])$"
+          }
+        }
+      ]
+    },
+    "collection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+        },
+        "root": {
+          "$ref": "#/definitions/portablePath",
+          "default": "."
+        },
+        "include": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/definitions/portableInclude"
+          },
+          "default": ["**/*"]
+        },
+        "exclude": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/definitions/portableRule"
+          },
+          "default": []
+        },
+        "languageHint": {
+          "type": "string",
+          "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z]{2}|-[A-Za-z]{4})?$"
+        },
+        "modelPreset": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+        }
+      }
+    },
+    "inlineContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["text"],
+      "properties": {
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 65536
+        }
+      }
+    },
+    "fileContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["file"],
+      "properties": {
+        "file": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/portablePath"
+            },
+            {
+              "not": {
+                "type": "string",
+                "pattern": "(?:^|[\\\\/])(?:\\.[eE][nN][vV](?:\\..*)?|[cC][rR][eE][dD][eE][nN][tT][iI][aA][lL][sS]?(?:\\..*)?|[iI][dD]_(?:[rR][sS][aA]|[dD][sS][aA]|[eE][cC][dD][sS][aA]|[eE][dD]25519)(?:\\..*)?|[sS][eE][cC][rR][eE][tT][sS]?(?:\\..*)?|[^\\\\/]+\\.(?:[kK][eE][yY]|[pP][eE][mM]|[pP]12|[pP][fF][xX]))$"
+              }
+            }
+          ]
+        }
+      }
+    },
+    "context": {
+      "oneOf": [
+        {
+          "$ref": "#/definitions/inlineContext"
+        },
+        {
+          "$ref": "#/definitions/fileContext"
+        }
+      ]
+    },
+    "contentType": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["prefixes", "preset"],
+      "properties": {
+        "prefixes": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/definitions/portablePath"
+          }
+        },
+        "preset": {
+          "enum": [
+            "blank",
+            "project-note",
+            "research-note",
+            "decision-note",
+            "prompt-pattern",
+            "source-summary",
+            "idea-original",
+            "person",
+            "company-project",
+            "meeting"
+          ]
+        },
+        "graphHints": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64
+          }
+        },
+        "searchBoost": {
+          "type": "number"
+        },
+        "temporal": {
+          "type": "boolean"
+        }
+      }
+    },
+    "affinityDefaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "contribution": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 0.03,
+          "default": 0.03
+        }
+      },
+      "default": {
+        "enabled": true,
+        "contribution": 0.03
+      }
+    }
+  }
+}

package/src/cli/commands/collection/add.ts

@@ -3,12 +3,8 @@
  */
 
 import { addCollection } from "../../../collection";
-import {
-  loadConfig,
-  pathExists,
-  saveConfig,
-  toAbsolutePath,
-} from "../../../config";
+import { pathExists, toAbsolutePath } from "../../../config";
+import { applyConfigFileChange } from "../../../core/config-mutation";
 import { CliError } from "../../errors";
 
 interface AddOptions {
@@ -18,6 +14,7 @@ interface AddOptions {
   include?: string;
   exclude?: string;
   update?: string;
+  configPath?: string;
 }
 
 export async function collectionAdd(
@@ -36,52 +33,49 @@ export async function collectionAdd(
     throw new CliError("VALIDATION", `Path does not exist: ${absolutePath}`);
   }
 
-  // Load config
-  const configResult = await loadConfig();
-  if (!configResult.ok) {
-    throw new CliError(
-      "RUNTIME",
-      `Failed to load config: ${configResult.error.message}`
-    );
-  }
-
-  // Add collection using shared module
-  const result = await addCollection(configResult.value, {
-    path,
-    name: options.name,
-    pattern: options.pattern,
-    include: options.include,
-    exclude: options.exclude,
-    models: options.embedModel
-      ? {
-          embed: options.embedModel,
-        }
-      : undefined,
-    updateCmd: options.update,
-  });
+  const mutation = await applyConfigFileChange(
+    { configPath: options.configPath },
+    async (config) => {
+      const result = await addCollection(config, {
+        path,
+        name: options.name!,
+        pattern: options.pattern,
+        include: options.include,
+        exclude: options.exclude,
+        models: options.embedModel
+          ? {
+              embed: options.embedModel,
+            }
+          : undefined,
+        updateCmd: options.update,
+      });
+      return result.ok
+        ? {
+            ok: true as const,
+            config: result.config,
+            value: result.collection,
+          }
+        : {
+            ok: false as const,
+            error: result.message,
+            code: result.code,
+          };
+    }
+  );
 
-  if (!result.ok) {
+  if (!mutation.ok) {
     // Map collection error codes to CLI error codes
     const cliCode =
-      result.code === "VALIDATION" ||
-      result.code === "PATH_NOT_FOUND" ||
-      result.code === "DUPLICATE"
+      mutation.code === "VALIDATION" ||
+      mutation.code === "PATH_NOT_FOUND" ||
+      mutation.code === "DUPLICATE"
         ? "VALIDATION"
         : "RUNTIME";
-    throw new CliError(cliCode, result.message);
-  }
-
-  // Save config
-  const saveResult = await saveConfig(result.config);
-  if (!saveResult.ok) {
-    throw new CliError(
-      "RUNTIME",
-      `Failed to save config: ${saveResult.error.message}`
-    );
+    throw new CliError(cliCode, mutation.error);
   }
 
   process.stdout.write(
-    `Collection "${result.collection.name}" added successfully\n`
+    `Collection "${mutation.value?.name}" added successfully\n`
   );
-  process.stdout.write(`Path: ${result.collection.path}\n`);
+  process.stdout.write(`Path: ${mutation.value?.path}\n`);
 }