@awebai/oats 0.29.4 → 0.30.1

package/capabilities/oats-okf/oats.json

@@ -1,148 +0,0 @@
-{
-  "capability": "oats.okf",
-  "command": "okf",
-  "version": "4.0.1",
-  "compatibility": {
-    "oats": ">=0.29.0"
-  },
-  "layer": "knowledge",
-  "description": "The OKF knowledge slot for working souls: consult the soul's accepted OKF bases remotely (no per-instance copy), keep instance knowledge with judgment, and \u2014 when the deployment switches harvest on \u2014 hand each instance's notes and session to the knowledge harvester through durable custody.",
-  "requires": [],
-  "settings": {
-    "harvest": {
-      "default": "off",
-      "values": [
-        "on",
-        "off"
-      ],
-      "description": "Whether this deployment harvests: on or off (default off). A host fact, set in oats-local.yaml settings.oats.okf.harvest (`oats okf setup --harvest on|off`). A soul may only opt out, with knowledge: { harvest: off }, and that opt-out is absolute. Off means no source registration, no capture and no custody; the harvest-review trigger is independent of it."
-    },
-    "harvest-runtime": {
-      "default": "pi",
-      "values": [
-        "pi",
-        "claude",
-        "codex"
-      ],
-      "description": "Harness for the knowledge harvester (the oats.okf/knowledge-harvester package soul), independent of the source instance's harness."
-    },
-    "harvest-model": {
-      "description": "Optional model pin for the selected harvest runtime, for example to use a cheaper model: a Pi provider/model or a native Claude/Codex model. When omitted, each harness uses its configured default."
-    },
-    "bindings-file": {
-      "description": "Absolute host-owned path identifying the version:1 bindings document. Portable binding preparation captures the selected document payload and never rereads this path."
-    },
-    "state-dir": {
-      "description": "Absolute host-owned durable state directory for portable bindings. It is never derived from an instance home."
-    },
-    "git-timeout": {
-      "description": "Seconds allowed for each Git operation that talks to a remote (clone, fetch, push, ls-remote); default 600. Local object reads keep a short fixed limit. Raise it for large repositories behind slow links."
-    },
-    "consult-max-age": {
-      "description": "Seconds a Git base's host-cached accepted commit may age before an `oats okf` consult read refetches the accepted branch; default 300, 0 fetches on every read. `--fresh` always refetches."
-    }
-  },
-  "skills": [
-    "skills"
-  ],
-  "commands": {
-    "harvest": "bin/oats-okf.mjs harvest",
-    "inspect": "bin/oats-okf.mjs inspect",
-    "setup": "bin/oats-okf.mjs setup",
-    "run-source": "bin/oats-okf.mjs run-source",
-    "complete": "bin/oats-okf.mjs complete",
-    "retry": "bin/oats-okf.mjs retry",
-    "bases": "bin/oats-okf.mjs bases",
-    "index": "bin/oats-okf.mjs index",
-    "cat": "bin/oats-okf.mjs cat",
-    "ls": "bin/oats-okf.mjs ls",
-    "links": "bin/oats-okf.mjs links",
-    "search": "bin/oats-okf.mjs search",
-    "read": "bin/oats-okf.mjs read",
-    "refresh": "bin/oats-okf.mjs refresh",
-    "init": "bin/oats-okf.mjs init",
-    "migrate": "bin/oats-okf.mjs migrate",
-    "unlock": "bin/oats-okf.mjs unlock",
-    "binding-normalize": "bin/oats-okf-binding.mjs normalize",
-    "binding-bind": "bin/oats-okf-binding.mjs bind",
-    "binding-check": "bin/oats-okf-binding.mjs check",
-    "harvest-status": "bin/oats-okf.mjs harvest-status"
-  },
-  "binding": {
-    "version": 1,
-    "normalize": "binding-normalize",
-    "bind": "binding-bind",
-    "check": "binding-check",
-    "reasons": [
-      "setting bindings-file is required (absolute host path)",
-      "setting bindings-file must be a normalized absolute host path",
-      "setting state-dir is required (absolute host path)",
-      "setting state-dir must be a normalized absolute host path",
-      "setting harvest-runtime is required (pi, claude or codex)",
-      "setting harvest-runtime must be pi, claude or codex",
-      "setting harvest-model must be null or a non-empty string",
-      "check action is not an admitted knowledge operation",
-      "bound runtime bindings file is missing or invalid",
-      "more than 64 git knowledge bases declared",
-      "declared knowledge base could not be staged from its git source",
-      "declared knowledge base is not a validated knowledge tree",
-      "knowledge base owner or remote custody requirement not met",
-      "staged git source does not match the declared knowledge base",
-      "harvest runtime command is not installed on this host",
-      "harvest runtime could not be qualified against the accepted bases"
-    ]
-  },
-  "inject": "injects/okf.md",
-  "helperInjection": {
-    "version": 1,
-    "mode": "omit"
-  },
-  "hooks": {
-    "soul-scaffold": "bin/oats-okf.mjs soul-scaffold",
-    "spawn": {
-      "command": "bin/oats-okf.mjs spawn",
-      "required": true,
-      "inputs": {
-        "sourceReceipt": {
-          "version": 1
-        }
-      }
-    },
-    "retire": {
-      "command": "bin/oats-okf.mjs retire",
-      "inputs": {
-        "sourceReceipt": {
-          "version": 1
-        }
-      }
-    }
-  },
-  "operations": {
-    "inspect": {
-      "kind": "view",
-      "command": "inspect",
-      "context": "home",
-      "description": "Inspect matching live working-memory documents, durable receipts, bindings, the accepted resolution, any legacy local view and scheduler health."
-    },
-    "harvest": {
-      "kind": "action",
-      "command": "harvest",
-      "context": "home",
-      "description": "Capture this source into durable custody and request an independent worker.",
-      "args": [
-        {
-          "name": "native-request",
-          "flag": "--native-request",
-          "required": false,
-          "description": "Captured operations require an explicit absolute backend-only native request JSON; provider owns the worker task."
-        },
-        {
-          "name": "worker-mode",
-          "flag": "--worker-mode",
-          "required": false,
-          "description": "Captured worker mode: prepare or launch (default launch); legacy behavior is unchanged when absent."
-        }
-      ]
-    }
-  }
-}

package/capabilities/oats-okf/schemas/okf-base.schema.json

@@ -1,46 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://oats.dev/schemas/okf-base.schema.json",
-  "type": "object",
-  "required": [
-    "version",
-    "id",
-    "nodes"
-  ],
-  "properties": {
-    "version": {
-      "const": 1
-    },
-    "id": {
-      "type": "string",
-      "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-    },
-    "nodes": {
-      "type": "object",
-      "minProperties": 1,
-      "propertyNames": {
-        "type": "string",
-        "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-      },
-      "additionalProperties": {
-        "type": "object",
-        "required": [
-          "path",
-          "owner"
-        ],
-        "properties": {
-          "path": {
-            "type": "string",
-            "minLength": 1
-          },
-          "owner": {
-            "type": "string",
-            "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-          }
-        },
-        "additionalProperties": false
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/capabilities/oats-okf/schemas/okf-bindings.schema.json

@@ -1,112 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://oats.dev/schemas/okf-bindings.schema.json",
-  "type": "object",
-  "required": [
-    "version",
-    "stateDir",
-    "bases"
-  ],
-  "properties": {
-    "version": {
-      "const": 1
-    },
-    "stateDir": {
-      "type": "string",
-      "minLength": 1
-    },
-    "cron": {
-      "type": "string",
-      "default": "*/15 * * * *",
-      "minLength": 1,
-      "pattern": "\\S"
-    },
-    "tz": {
-      "type": "string",
-      "default": "UTC",
-      "minLength": 1,
-      "pattern": "\\S"
-    },
-    "bases": {
-      "type": "object",
-      "minProperties": 1,
-      "propertyNames": {
-        "type": "string",
-        "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-      },
-      "additionalProperties": {
-        "oneOf": [
-          {
-            "type": "object",
-            "required": [
-              "id",
-              "kind",
-              "path"
-            ],
-            "properties": {
-              "id": {
-                "type": "string",
-                "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-              },
-              "kind": {
-                "const": "directory"
-              },
-              "path": {
-                "type": "string",
-                "minLength": 1
-              }
-            },
-            "additionalProperties": false
-          },
-          {
-            "type": "object",
-            "required": [
-              "id",
-              "kind",
-              "repository",
-              "root",
-              "acceptedBranch",
-              "pr"
-            ],
-            "properties": {
-              "id": {
-                "type": "string",
-                "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-              },
-              "kind": {
-                "const": "git"
-              },
-              "repository": {
-                "type": "string",
-                "minLength": 1
-              },
-              "root": {
-                "type": "string",
-                "minLength": 1
-              },
-              "acceptedBranch": {
-                "type": "string",
-                "minLength": 1
-              },
-              "pr": {
-                "type": "object",
-                "required": [
-                  "repository"
-                ],
-                "properties": {
-                  "repository": {
-                    "type": "string",
-                    "pattern": "^[\\w.-]+/[\\w.-]+$"
-                  }
-                },
-                "additionalProperties": false
-              }
-            },
-            "additionalProperties": false
-          }
-        ]
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/capabilities/oats-okf/schemas/okf-portable-declaration.schema.json

@@ -1,87 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://oats.dev/schemas/okf-portable-declaration.schema.json",
-  "title": "OATS OKF portable knowledge declaration",
-  "$defs": {
-    "identifier": {
-      "type": "string",
-      "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-    },
-    "directory": {
-      "type": "object",
-      "required": ["id", "kind", "path"],
-      "properties": {
-        "id": {"$ref": "#/$defs/identifier"},
-        "kind": {"const": "directory"},
-        "path": {"type": "string", "pattern": "^path:/"}
-      },
-      "additionalProperties": false
-    },
-    "git": {
-      "type": "object",
-      "required": ["id", "kind", "repository", "root", "acceptedBranch", "pr"],
-      "properties": {
-        "id": {"$ref": "#/$defs/identifier"},
-        "kind": {"const": "git"},
-        "repository": {"type": "string", "pattern": "^(?!(?:https://[^/]*@|ssh://[^/@]*:[^/@]*@))(?:(?:https|ssh)://|git@)[^\\s?#]+$"},
-        "root": {"type": "string", "minLength": 1},
-        "acceptedBranch": {"type": "string", "minLength": 1},
-        "pr": {
-          "type": "object",
-          "required": ["repository"],
-          "properties": {"repository": {"type": "string", "pattern": "^[\\w.-]+/[\\w.-]+$"}},
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "locator": {"oneOf": [{"$ref": "#/$defs/directory"}, {"$ref": "#/$defs/git"}]},
-    "store": {
-      "oneOf": [
-        {"type": "object", "required": ["fixed"], "properties": {"fixed": {"$ref": "#/$defs/locator"}}, "additionalProperties": false},
-        {"type": "object", "required": ["default"], "properties": {"default": {"$ref": "#/$defs/locator"}}, "additionalProperties": false},
-        {"type": "object", "required": ["inherit"], "properties": {"inherit": {"type": "string", "minLength": 1}}, "additionalProperties": false}
-      ]
-    }
-  },
-  "type": "object",
-  "required": ["contract", "version", "payload"],
-  "properties": {
-    "contract": {"const": "oats.okf.locations"},
-    "version": {"const": 1},
-    "payload": {
-      "type": "object",
-      "required": ["owner", "stores", "reads", "owns"],
-      "properties": {
-        "owner": {"$ref": "#/$defs/identifier"},
-        "stores": {
-          "type": "object",
-          "propertyNames": {"$ref": "#/$defs/identifier"},
-          "additionalProperties": {"$ref": "#/$defs/store"}
-        },
-        "reads": {
-          "type": "array",
-          "uniqueItems": true,
-          "items": {
-            "type": "object",
-            "required": ["store", "node"],
-            "properties": {"store": {"$ref": "#/$defs/identifier"}, "node": {"$ref": "#/$defs/identifier"}},
-            "additionalProperties": false
-          }
-        },
-        "owns": {
-          "type": "array",
-          "uniqueItems": true,
-          "items": {
-            "type": "object",
-            "required": ["node"],
-            "properties": {"node": {"$ref": "#/$defs/identifier"}, "destination": {"$ref": "#/$defs/identifier"}},
-            "additionalProperties": false
-          }
-        }
-      },
-      "additionalProperties": false
-    }
-  },
-  "additionalProperties": false
-}

package/capabilities/oats-okf/schemas/okf-portable-payload.schema.json

@@ -1,113 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://oats.dev/schemas/okf-portable-payload.schema.json",
-  "title": "OATS OKF effective portable binding payload",
-  "$defs": {
-    "identifier": {
-      "type": "string",
-      "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-    },
-    "directory": {
-      "type": "object",
-      "required": ["id", "kind", "path"],
-      "properties": {
-        "id": {"$ref": "#/$defs/identifier"},
-        "kind": {"const": "directory"},
-        "path": {"type": "string", "pattern": "^/"}
-      },
-      "additionalProperties": false
-    },
-    "git": {
-      "type": "object",
-      "required": ["id", "kind", "repository", "root", "acceptedBranch", "pr"],
-      "properties": {
-        "id": {"$ref": "#/$defs/identifier"},
-        "kind": {"const": "git"},
-        "repository": {"type": "string", "pattern": "^(?!(?:https://[^/]*@|ssh://[^/@]*:[^/@]*@))(?:(?:https|ssh)://|git@)[^\\s?#]+$"},
-        "root": {"type": "string", "minLength": 1},
-        "acceptedBranch": {"type": "string", "minLength": 1},
-        "pr": {
-          "type": "object",
-          "required": ["repository"],
-          "properties": {"repository": {"type": "string", "pattern": "^[\\w.-]+/[\\w.-]+$"}},
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "store": {"oneOf": [{"$ref": "#/$defs/directory"}, {"$ref": "#/$defs/git"}]},
-    "read": {
-      "type": "object",
-      "required": ["store", "node"],
-      "properties": {"store": {"$ref": "#/$defs/identifier"}, "node": {"$ref": "#/$defs/identifier"}},
-      "additionalProperties": false
-    },
-    "own": {
-      "type": "object",
-      "required": ["store", "node", "steward"],
-      "properties": {"store": {"$ref": "#/$defs/identifier"}, "node": {"$ref": "#/$defs/identifier"}, "steward": {"$ref": "#/$defs/identifier"}},
-      "additionalProperties": false
-    },
-    "reference": {
-      "type": "string",
-      "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)/)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}/(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-    }
-  },
-  "type": "object",
-  "required": ["owner", "stores", "reads", "owns", "runtime", "execution"],
-  "properties": {
-    "owner": {"$ref": "#/$defs/identifier"},
-    "stores": {
-      "type": "object",
-      "minProperties": 1,
-      "propertyNames": {"$ref": "#/$defs/identifier"},
-      "additionalProperties": {"$ref": "#/$defs/store"}
-    },
-    "reads": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/read"}},
-    "owns": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/own"}},
-    "runtime": {
-      "type": "object",
-      "required": ["descriptorFile", "bindings", "declaration"],
-      "properties": {
-        "descriptorFile": {"type": "string", "pattern": "^/"},
-        "bindings": {
-          "type": "object",
-          "required": ["version", "stateDir", "bases"],
-          "properties": {
-            "version": {"const": 1},
-            "stateDir": {"type": "string", "pattern": "^/"},
-            "bases": {
-              "type": "object",
-              "minProperties": 1,
-              "propertyNames": {"$ref": "#/$defs/identifier"},
-              "additionalProperties": {"$ref": "#/$defs/store"}
-            }
-          },
-          "additionalProperties": false
-        },
-        "declaration": {
-          "type": "object",
-          "required": ["version", "owner", "reads", "owns"],
-          "properties": {
-            "version": {"const": 1},
-            "owner": {"$ref": "#/$defs/identifier"},
-            "reads": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/reference"}},
-            "owns": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/reference"}}
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "execution": {
-      "type": "object",
-      "required": ["runtime", "model"],
-      "properties": {
-        "runtime": {"oneOf": [{"const": "pi"}, {"const": "claude"}, {"const": "codex"}]},
-        "model": {"oneOf": [{"type": "null"}, {"type": "string", "minLength": 1}]}
-      },
-      "additionalProperties": false
-    }
-  },
-  "additionalProperties": false
-}

package/capabilities/oats-okf/schemas/okf-soul.schema.json

@@ -1,37 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://oats.dev/schemas/okf-soul.schema.json",
-  "type": "object",
-  "required": [
-    "version",
-    "owner",
-    "owns",
-    "reads"
-  ],
-  "properties": {
-    "version": {
-      "const": 1
-    },
-    "owner": {
-      "type": "string",
-      "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-    },
-    "owns": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)/)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}/(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-      },
-      "uniqueItems": true
-    },
-    "reads": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "pattern": "^(?!(?:constructor|__proto__|prototype|toString|valueOf)/)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}/(?!(?:constructor|__proto__|prototype|toString|valueOf)$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$"
-      },
-      "uniqueItems": true
-    }
-  },
-  "additionalProperties": false
-}