overlord-cli 0.2611091052.0 → 0.2611131332.0

package/README.md

@@ -250,7 +250,7 @@ resolved project directory. The queue state remains in the backend.
 ### Contract Components
 
 This module is the developer-facing home for three components defined in
-[`CONTRACT.md`](https://github.com/cooperativ-labs/OpenOverlord/blob/main/CONTRACT.md):
+[`contract/CONTRACT.md`](https://github.com/cooperativ-labs/OpenOverlord/blob/main/contract/CONTRACT.md):
 
 | Component      | Stable id  | What it owns                                                                                                                                                                        |
 | -------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -345,5 +345,5 @@ would run untested working-tree code against your real mission data.
 
 Per the contract, the CLI/protocol/runner surfaces reach persistence only
 through the configured **REST/backend API** — never direct table writes.
-See the Interaction Surfaces section of [`CONTRACT.md`](https://github.com/cooperativ-labs/OpenOverlord/blob/main/CONTRACT.md) before
+See the Interaction Surfaces section of [`contract/architecture.md`](https://github.com/cooperativ-labs/OpenOverlord/blob/main/contract/architecture.md) before
 making any cross-module change.

package/dist/connectors/AGENTS.md

@@ -1,6 +1,6 @@
 # Connectors Module — Agent Extension Guide
 
-This file tells agents how to extend the Connectors module to add new agent harness connectors for users. Read [`CONTRACT.md`](../CONTRACT.md) and the [component-contract skill](../.claude/skills/component-contract/SKILL.md) before making any cross-module change.
+This file tells agents how to extend the Connectors module to add new agent harness connectors for users. Read [`contract/CONTRACT.md`](../contract/CONTRACT.md) and the [component-contract skill](../.claude/skills/component-contract/SKILL.md) before making any cross-module change.
 
 ---
 
@@ -21,7 +21,7 @@ Each type has a different procedure below.
 
 ## Before You Start
 
-1. Read `CONTRACT.md` — Connector Layer section (stable id: `connector`).
+1. Read `contract/architecture.md` — Connector Layer section (stable id: `connector`).
 2. Read [`connectors/docs/05-connectors-and-agent-plugins.md`](docs/05-connectors-and-agent-plugins.md) for the four-layer model: connector core, plugins, adapters, and prompt wrappers.
 3. Read [`connectors/docs/agent-harness-configuration-architecture.md`](docs/agent-harness-configuration-architecture.md) for ownership boundaries.
 4. Check the `agentSession` vocabularies in `contract/extension-points.yaml` and the descriptor schema before adding a normalized capability, integration shape, or fixture kind.
@@ -266,7 +266,7 @@ wrong and that is worth raising rather than working around.
 6. **Create `connectors/adapters/<agent-name>/conformance-manifest.yaml`** declaring:
 
    ```yaml
-   contractVersion: '116'
+   contractVersion: '168.0.0'
    componentType: connector
    componentKey: <agent-name>
    label: <human-readable label>
@@ -350,7 +350,7 @@ The Claude and Codex adapters are the reference implementations; Cursor, Pi, Ant
 
 ## Cross-Module Checklist
 
-- [ ] Read `CONTRACT.md` Connector Layer section
+- [ ] Read `contract/architecture.md` Connector Layer section
 - [ ] New capability id, integration shape, or fixture kind → update the contract vocabulary and descriptor schema first
 - [ ] Hook scripts → use `ovld protocol` commands only, no direct DB writes
 - [ ] Conformance manifest created and validated for every new connector

package/dist/connectors/README.md

@@ -59,14 +59,14 @@ migrate existing installations.
 
 A custom agent connector is a sanctioned extension point: a new adapter plus a
 `conformance-manifest.yaml` validated by `ovld contract check`. See the
-[Conformance Requirements](../CONTRACT.md) and the example manifest at
+[Conformance Requirements](../contract/conformance.md) and the example manifest at
 [`../contract/examples/connector-claude-conformance-manifest.yaml`](../contract/examples/connector-claude-conformance-manifest.yaml).
 
 ## For Developers
 
 ### Contract Component
 
-Maps to the **Connector Layer** (`connector`) in [`CONTRACT.md`](../CONTRACT.md), which owns:
+Maps to the **Connector Layer** (`connector`) in [`contract/architecture.md`](../contract/architecture.md), which owns:
 
 - Connector core workflow instructions
 - Per-agent plugin/adapter files and their managed-file manifests

package/dist/connectors/adapters/antigravity/conformance-manifest.yaml

@@ -1,4 +1,4 @@
-contractVersion: "168"
+contractVersion: "169.2.1"
 componentType: connector
 componentKey: antigravity
 label: "Antigravity Connector"

package/dist/connectors/adapters/claude/conformance-manifest.yaml

@@ -1,4 +1,4 @@
-contractVersion: "168"
+contractVersion: "169.2.1"
 componentType: connector
 componentKey: claude
 label: "Claude Code Connector"

package/dist/connectors/adapters/codex/conformance-manifest.yaml

@@ -1,4 +1,4 @@
-contractVersion: "168"
+contractVersion: "169.2.1"
 componentType: connector
 componentKey: codex
 label: "Codex Connector"

package/dist/connectors/adapters/cursor/conformance-manifest.yaml

@@ -1,4 +1,4 @@
-contractVersion: "168"
+contractVersion: "169.2.1"
 componentType: connector
 componentKey: cursor
 label: "Cursor Connector"

package/dist/connectors/adapters/opencode/conformance-manifest.yaml

@@ -1,4 +1,4 @@
-contractVersion: "168"
+contractVersion: "169.2.1"
 componentType: connector
 componentKey: opencode
 label: "OpenCode Connector"

package/dist/connectors/adapters/pi/conformance-manifest.yaml

@@ -1,4 +1,4 @@
-contractVersion: "168"
+contractVersion: "169.2.1"
 componentType: connector
 componentKey: pi
 label: "PI Connector"

package/dist/contract/conformance-manifest.schema.yaml

@@ -28,9 +28,15 @@ properties:
 
   contractVersion:
     type: string
-    description: "The Overlord contract version this component was validated against (e.g. '0')"
+    # Strict MAJOR.MINOR.PATCH (contract/VERSION). A bare integer N is the former
+    # integer form, read as N.0.0, and stays valid for manifests outside this
+    # repository until they are restamped; `yarn check:conformance-versions`
+    # requires the strict form, the same major as contract/VERSION and a version
+    # not newer than it (contract/decisions/0009-manifests-pin-major-version.md).
+    pattern: "^(0|[1-9][0-9]*)([.](0|[1-9][0-9]*)[.](0|[1-9][0-9]*))?$"
+    description: "The Overlord contract version this component was validated against, as strict Semantic Versioning (e.g. '168.0.0')"
     examples:
-      - "0"
+      - "168.0.0"
 
   componentType:
     type: string
@@ -177,7 +183,7 @@ properties:
           - postgres
       schemaContractVersion:
         type: string
-        description: "Database schema contract version this adapter implements (from 09-database-schema-contract.md)"
+        description: "Database schema contract version this adapter implements (from contract/data/README.md)"
       conformanceTestStatus:
         type: string
         enum:

package/dist/index.js

@@ -634,11 +634,22 @@ var init_base_url = __esm({
   }
 });
 
+// ../packages/contract/dist/vocabulary.js
+function vocabulary() {
+  return (values) => values;
+}
+var init_vocabulary = __esm({
+  "../packages/contract/dist/vocabulary.js"() {
+    "use strict";
+  }
+});
+
 // ../packages/contract/dist/chat.js
-var CHAT_DEFAULT_LIMITS, REPOSITORY_READ_DEFAULT_BOUNDS;
+var CHAT_DEFAULT_LIMITS, ACCOUNT_CONNECTION_PROVIDERS, ACCOUNT_CONNECTION_SCOPES, ACCOUNT_CONNECTION_CREDENTIAL_KINDS, ACCOUNT_CONNECTION_STATES, ACCOUNT_CONNECTION_ASSISTANT_WRITE_SCOPES, ACCOUNT_CONNECTION_UNAVAILABLE_REASONS, REPOSITORY_READ_OPERATIONS, REPOSITORY_READ_DEFAULT_BOUNDS;
 var init_chat = __esm({
   "../packages/contract/dist/chat.js"() {
     "use strict";
+    init_vocabulary();
     CHAT_DEFAULT_LIMITS = {
       /** Fixed invariant, not configurable. */
       unfinishedRunsPerThread: 1,
@@ -660,6 +671,41 @@ var init_chat = __esm({
       titleMaxChars: 80,
       messageMaxChars: 16e3
     };
+    ACCOUNT_CONNECTION_PROVIDERS = vocabulary()([
+      "knowledgebase",
+      "everhour",
+      "github"
+    ]);
+    ACCOUNT_CONNECTION_SCOPES = vocabulary()([
+      "organization",
+      "profile"
+    ]);
+    ACCOUNT_CONNECTION_CREDENTIAL_KINDS = vocabulary()([
+      "oauth",
+      "api_key"
+    ]);
+    ACCOUNT_CONNECTION_STATES = vocabulary()([
+      "pending",
+      "connected",
+      "reauthorization_required",
+      "disconnected"
+    ]);
+    ACCOUNT_CONNECTION_ASSISTANT_WRITE_SCOPES = vocabulary()(["per_request", "all_workspaces"]);
+    ACCOUNT_CONNECTION_UNAVAILABLE_REASONS = vocabulary()([
+      "not_offered_on_edition",
+      "not_configured",
+      "encryption_not_configured"
+    ]);
+    REPOSITORY_READ_OPERATIONS = vocabulary()([
+      "observe",
+      "tree",
+      "branches",
+      "worktrees",
+      "git_status",
+      "diff",
+      "read_file",
+      "search_text"
+    ]);
     REPOSITORY_READ_DEFAULT_BOUNDS = {
       readFileBytes: 64 * 1024,
       diffBytes: 128 * 1024,
@@ -793,16 +839,39 @@ var init_mission_reference = __esm({
 });
 
 // ../packages/contract/dist/mission-search.js
+var MISSION_SEARCH_DATE_FIELDS;
 var init_mission_search = __esm({
   "../packages/contract/dist/mission-search.js"() {
     "use strict";
+    init_vocabulary();
+    MISSION_SEARCH_DATE_FIELDS = vocabulary()([
+      "createdAt",
+      "updatedAt",
+      "dueDatetime"
+    ]);
   }
 });
 
 // ../packages/contract/dist/notifications.js
+var NOTIFICATION_TYPES, NOTIFICATION_MODES, NOTIFICATION_TRANSPORTS;
 var init_notifications = __esm({
   "../packages/contract/dist/notifications.js"() {
     "use strict";
+    init_vocabulary();
+    NOTIFICATION_TYPES = vocabulary()([
+      "mission_awaiting_review",
+      "agent_question",
+      "mission_complete",
+      "mission_failed",
+      "agent_started",
+      "returned_to_execute"
+    ]);
+    NOTIFICATION_MODES = vocabulary()(["alert", "silent", "off"]);
+    NOTIFICATION_TRANSPORTS = vocabulary()([
+      "apns",
+      "realtime",
+      "in_app"
+    ]);
   }
 });
 
@@ -919,6 +988,7 @@ var init_dist = __esm({
     init_objective_ref();
     init_resource_paths();
     init_search();
+    init_vocabulary();
     DEFERRED_WORK_LIMITS = {
       maxTitleLength: 80,
       maxChangeLength: 400,
@@ -2959,8 +3029,10 @@ var init_connector_core_render = __esm({
 // src/connectors.ts
 var connectors_exports = {};
 __export(connectors_exports, {
+  contractMajorVersion: () => contractMajorVersion,
   expandInstallPath: () => expandInstallPath,
   inspectConnector: () => inspectConnector,
+  isStaleContractVersion: () => isStaleContractVersion,
   listAvailableConnectors: () => listAvailableConnectors,
   mergeCodexConfig: () => mergeCodexConfig,
   parseConnectorManifestYaml: () => parseConnectorManifestYaml,
@@ -3655,6 +3727,19 @@ function readInstallState(agentKey, home) {
     return null;
   }
 }
+function contractMajorVersion(version2) {
+  const match = /^(0|[1-9]\d*)(?:\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*))?$/.exec(version2.trim());
+  return match ? match[1] : void 0;
+}
+function isStaleContractVersion({
+  installed,
+  declared
+}) {
+  const installedMajor = contractMajorVersion(installed);
+  const declaredMajor = contractMajorVersion(declared);
+  if (installedMajor === void 0 || declaredMajor === void 0) return installed !== declared;
+  return installedMajor !== declaredMajor;
+}
 function inspectConnector({
   agentKey,
   home
@@ -3677,7 +3762,10 @@ function inspectConnector({
     };
   }
   const problems = [];
-  const staleContractVersion = state.contractVersion !== manifest.contractVersion;
+  const staleContractVersion = isStaleContractVersion({
+    installed: state.contractVersion,
+    declared: manifest.contractVersion
+  });
   if (staleContractVersion) {
     problems.push(
       `Installed against contract ${state.contractVersion}; connector now declares ${manifest.contractVersion}. Re-run \`ovld agent-setup ${agentKey}\`.`
@@ -42334,12 +42422,21 @@ var init_delivery_report = __esm({
 });
 
 // ../packages/core/dist/service/webhook-events.js
+var WEBHOOK_EVENT_TYPES;
 var init_webhook_events = __esm({
   "../packages/core/dist/service/webhook-events.js"() {
     "use strict";
+    init_dist();
     init_dist2();
     init_delivery_report();
     init_util2();
+    WEBHOOK_EVENT_TYPES = vocabulary()([
+      "mission.delivered",
+      "mission.status_changed",
+      "objective.completed",
+      "mission.blocked",
+      "mission.unblocked"
+    ]);
   }
 });
 
@@ -42362,10 +42459,11 @@ var init_credential = __esm({
 });
 
 // ../packages/core/dist/service/agent-session/requests.js
-var REMOTE_WINDOW_AWAY_SECONDS;
+var REMOTE_WINDOW_AWAY_SECONDS, AGENT_REQUEST_KINDS;
 var init_requests = __esm({
   "../packages/core/dist/service/agent-session/requests.js"() {
     "use strict";
+    init_dist();
     init_change_feed();
     init_errors2();
     init_live_activity_jobs();
@@ -42375,6 +42473,12 @@ var init_requests = __esm({
     init_window();
     init_credential();
     REMOTE_WINDOW_AWAY_SECONDS = 30 * 60;
+    AGENT_REQUEST_KINDS = vocabulary()([
+      "question",
+      "permission",
+      "choice",
+      "retry"
+    ]);
   }
 });