@gmickel/gno 1.24.0 → 1.26.0

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`);
 }

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

@@ -3,43 +3,43 @@
  */
 
 import { removeCollection } from "../../../collection";
-import { loadConfig, saveConfig } from "../../../config";
+import { applyConfigFileChange } from "../../../core/config-mutation";
 import { CliError } from "../../errors";
 
-export async function collectionRemove(name: string): Promise<void> {
-  // Load config
-  const configResult = await loadConfig();
-  if (!configResult.ok) {
-    throw new CliError(
-      "RUNTIME",
-      `Failed to load config: ${configResult.error.message}`
-    );
-  }
-
-  // Remove collection using shared module
-  const result = removeCollection(configResult.value, { name });
+export async function collectionRemove(
+  name: string,
+  options: { configPath?: string } = {}
+): Promise<void> {
+  const mutation = await applyConfigFileChange(
+    { configPath: options.configPath },
+    (config) => {
+      const result = removeCollection(config, { name });
+      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 === "NOT_FOUND" ||
-      result.code === "HAS_REFERENCES"
+      mutation.code === "VALIDATION" ||
+      mutation.code === "NOT_FOUND" ||
+      mutation.code === "HAS_REFERENCES"
         ? "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}" removed successfully\n`
+    `Collection "${mutation.value?.name}" removed successfully\n`
   );
 }

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

@@ -2,90 +2,72 @@
  * gno collection rename - Rename a collection
  */
 
-import {
-  CollectionSchema,
-  getCollectionFromScope,
-  loadConfig,
-  saveConfig,
-} from "../../../config";
+import { CollectionSchema, getCollectionFromScope } from "../../../config";
+import { applyConfigFileChange } from "../../../core/config-mutation";
 import { CliError } from "../../errors";
 
 export async function collectionRename(
   oldName: string,
-  newName: string
+  newName: string,
+  options: { configPath?: string } = {}
 ): Promise<void> {
   const oldCollectionName = oldName.toLowerCase();
   const newCollectionName = newName.toLowerCase();
 
-  // Load config
-  const result = await loadConfig();
-  if (!result.ok) {
-    throw new CliError(
-      "RUNTIME",
-      `Failed to load config: ${result.error.message}`
-    );
-  }
-
-  const config = result.value;
-
-  // Find old collection
-  const collection = config.collections.find(
-    (c) => c.name === oldCollectionName
-  );
-  if (!collection) {
-    throw new CliError(
-      "VALIDATION",
-      `Collection "${oldCollectionName}" not found`
-    );
-  }
-
-  // Check if new name already exists
-  const existingNew = config.collections.find(
-    (c) => c.name === newCollectionName
-  );
-  if (existingNew) {
-    throw new CliError(
-      "VALIDATION",
-      `Collection "${newCollectionName}" already exists`
-    );
-  }
-
-  // Validate new name
-  const testCollection = { ...collection, name: newCollectionName };
-  const validation = CollectionSchema.safeParse(testCollection);
-  if (!validation.success) {
-    throw new CliError(
-      "VALIDATION",
-      `Invalid collection name: ${validation.error.issues[0]?.message ?? "unknown error"}`
-    );
-  }
-
-  // Rename collection
-  collection.name = newCollectionName;
-
-  // Update contexts that reference this collection
-  for (const context of config.contexts) {
-    const collFromScope = getCollectionFromScope(context.scopeKey);
-    if (collFromScope === oldCollectionName) {
-      // Update scope key
-      if (context.scopeType === "collection") {
-        context.scopeKey = `${newCollectionName}:`;
-      } else if (context.scopeType === "prefix") {
-        // Replace collection name in URI
-        context.scopeKey = context.scopeKey.replace(
-          `gno://${oldCollectionName}/`,
-          `gno://${newCollectionName}/`
-        );
+  const mutation = await applyConfigFileChange(
+    { configPath: options.configPath },
+    (config) => {
+      const collection = config.collections.find(
+        (item) => item.name === oldCollectionName
+      );
+      if (!collection) {
+        return {
+          ok: false as const,
+          error: `Collection "${oldCollectionName}" not found`,
+          code: "NOT_FOUND",
+        };
       }
+      if (config.collections.some((item) => item.name === newCollectionName)) {
+        return {
+          ok: false as const,
+          error: `Collection "${newCollectionName}" already exists`,
+          code: "DUPLICATE",
+        };
+      }
+      const validation = CollectionSchema.safeParse({
+        ...collection,
+        name: newCollectionName,
+      });
+      if (!validation.success) {
+        return {
+          ok: false as const,
+          error: `Invalid collection name: ${validation.error.issues[0]?.message ?? "unknown error"}`,
+          code: "VALIDATION",
+        };
+      }
+      collection.name = newCollectionName;
+      for (const context of config.contexts) {
+        if (getCollectionFromScope(context.scopeKey) !== oldCollectionName) {
+          continue;
+        }
+        if (context.scopeType === "collection") {
+          context.scopeKey = `${newCollectionName}:`;
+        } else if (context.scopeType === "prefix") {
+          context.scopeKey = context.scopeKey.replace(
+            `gno://${oldCollectionName}/`,
+            `gno://${newCollectionName}/`
+          );
+        }
+      }
+      return { ok: true as const, config };
     }
-  }
-
-  // Save config
-  const saveResult = await saveConfig(config);
-  if (!saveResult.ok) {
+  );
+  if (!mutation.ok) {
     throw new CliError(
-      "RUNTIME",
-      `Failed to save config: ${saveResult.error.message}`
+      ["NOT_FOUND", "DUPLICATE", "VALIDATION"].includes(mutation.code)
+        ? "VALIDATION"
+        : "RUNTIME",
+      mutation.error
     );
   }