@pellux/goodvibes-contracts 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,10 +1,10 @@
1
1
  /**
2
- * core-verbs.ts — the canonical operator-method verb vocabulary (E8, W6-C3).
2
+ * core-verbs.ts — the canonical operator-method verb vocabulary (see CHANGELOG 1.0.0).
3
3
  *
4
4
  * WHY THIS EXISTS: OPERATOR_METHOD_IDS (generated/operator-method-ids.ts) is a
5
5
  * flat list of dotted ids (`<namespace...>.<verb>`). Before this file, nothing
6
6
  * enumerated or constrained the verb vocabulary — every method-catalog author
7
- * picked whatever word felt right, which is how the wave-6 audit found three
7
+ * picked whatever word felt right, which is how an audit found three
8
8
  * worst-class collisions on the word "schedule", a redundant lifecycle pair
9
9
  * (`enable`/`disable` duplicated by `pause`/`resume`), and an update-verb split
10
10
  * (`patch` vs `update`). This module is the forcing function that keeps that
@@ -44,20 +44,21 @@
44
44
  export declare const CORE_VERBS: readonly ["list", "get", "search", "snapshot", "status", "create", "update", "delete", "upsert", "set", "enable", "disable", "close", "reopen", "cancel", "run", "retry", "invoke", "stream", "register"];
45
45
  export type CoreVerb = typeof CORE_VERBS[number];
46
46
  /**
47
- * Verbs that were retired by a Wave-6 core-verb ruling and must never
48
- * reappear as a method id's final dotted segment. A verb lands here (instead
49
- * of just being deleted from history) so the conformance test keeps banning
50
- * it even if someone re-adds it later without knowing why it was removed.
47
+ * Verbs that were retired by the core-verb ruling (see CHANGELOG 1.0.0) and
48
+ * must never reappear as a method id's final dotted segment. A verb lands
49
+ * here (instead of just being deleted from history) so the conformance test
50
+ * keeps banning it even if someone re-adds it later without knowing why it
51
+ * was removed.
51
52
  *
52
53
  * - `patch` — retired in favor of `update` (automation.jobs.patch ->
53
54
  * automation.jobs.update, routes.bindings.patch -> routes.bindings.update,
54
- * watchers.patch -> watchers.update, all W6-C3). `update` is the one
55
+ * watchers.patch -> watchers.update). `update` is the one
55
56
  * canonical partial-mutation verb; `patch` mirrored the HTTP-verb name
56
57
  * (PATCH) instead of the operator-method vocabulary in these three places —
57
58
  * the HTTP method on the descriptor is unaffected, only the id's verb tail
58
59
  * changed.
59
60
  * - `pause` / `resume` — retired as a byte-identical redundant lifecycle pair
60
- * with `enable`/`disable` (automation.jobs.pause/resume -> deleted, W6-C3;
61
+ * with `enable`/`disable` (automation.jobs.pause/resume -> deleted;
61
62
  * same `{id, enabled}` output shape, same semantics). A caller-facing
62
63
  * "pause"/"resume" user verb should map onto `disable`/`enable` at the wire.
63
64
  */
@@ -1 +1 @@
1
- {"version":3,"file":"core-verbs.d.ts","sourceRoot":"","sources":["../src/core-verbs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,UAAU,2MAyBb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,uCAAwC,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAoErE,CAAC;AAEX,kFAAkF;AAClF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAE5C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAcjE"}
1
+ {"version":3,"file":"core-verbs.d.ts","sourceRoot":"","sources":["../src/core-verbs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,UAAU,2MAyBb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,uCAAwC,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAsFrE,CAAC;AAEX,kFAAkF;AAClF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAE5C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAcjE"}
@@ -1,10 +1,10 @@
1
1
  /**
2
- * core-verbs.ts — the canonical operator-method verb vocabulary (E8, W6-C3).
2
+ * core-verbs.ts — the canonical operator-method verb vocabulary (see CHANGELOG 1.0.0).
3
3
  *
4
4
  * WHY THIS EXISTS: OPERATOR_METHOD_IDS (generated/operator-method-ids.ts) is a
5
5
  * flat list of dotted ids (`<namespace...>.<verb>`). Before this file, nothing
6
6
  * enumerated or constrained the verb vocabulary — every method-catalog author
7
- * picked whatever word felt right, which is how the wave-6 audit found three
7
+ * picked whatever word felt right, which is how an audit found three
8
8
  * worst-class collisions on the word "schedule", a redundant lifecycle pair
9
9
  * (`enable`/`disable` duplicated by `pause`/`resume`), and an update-verb split
10
10
  * (`patch` vs `update`). This module is the forcing function that keeps that
@@ -68,20 +68,21 @@ export const CORE_VERBS = [
68
68
  'register',
69
69
  ];
70
70
  /**
71
- * Verbs that were retired by a Wave-6 core-verb ruling and must never
72
- * reappear as a method id's final dotted segment. A verb lands here (instead
73
- * of just being deleted from history) so the conformance test keeps banning
74
- * it even if someone re-adds it later without knowing why it was removed.
71
+ * Verbs that were retired by the core-verb ruling (see CHANGELOG 1.0.0) and
72
+ * must never reappear as a method id's final dotted segment. A verb lands
73
+ * here (instead of just being deleted from history) so the conformance test
74
+ * keeps banning it even if someone re-adds it later without knowing why it
75
+ * was removed.
75
76
  *
76
77
  * - `patch` — retired in favor of `update` (automation.jobs.patch ->
77
78
  * automation.jobs.update, routes.bindings.patch -> routes.bindings.update,
78
- * watchers.patch -> watchers.update, all W6-C3). `update` is the one
79
+ * watchers.patch -> watchers.update). `update` is the one
79
80
  * canonical partial-mutation verb; `patch` mirrored the HTTP-verb name
80
81
  * (PATCH) instead of the operator-method vocabulary in these three places —
81
82
  * the HTTP method on the descriptor is unaffected, only the id's verb tail
82
83
  * changed.
83
84
  * - `pause` / `resume` — retired as a byte-identical redundant lifecycle pair
84
- * with `enable`/`disable` (automation.jobs.pause/resume -> deleted, W6-C3;
85
+ * with `enable`/`disable` (automation.jobs.pause/resume -> deleted;
85
86
  * same `{id, enabled}` output shape, same semantics). A caller-facing
86
87
  * "pause"/"resume" user verb should map onto `disable`/`enable` at the wire.
87
88
  */
@@ -149,6 +150,24 @@ export const EXEMPT_VERB_CATEGORIES = {
149
150
  // report, not a generic "get"/"list".
150
151
  'doctor', 'stats', 'capacity', 'settings', 'catalog', 'reject', 'review-queue',
151
152
  ],
153
+ 'memory-record-store': [
154
+ // The daemon-owned canonical memory store mirrors the MemoryStore engine's
155
+ // own long-standing API verbs rather than the generic CRUD words. `add`
156
+ // (MemoryStore.add stamps a new record at the recall-confidence floor — the
157
+ // recall-honesty contract is written in terms of `add`, not `create`) and
158
+ // `update-review` (mutates ONLY a record's review signal —
159
+ // reviewState/confidence/reviewer/staleReason — a narrower, honesty-load-
160
+ // bearing operation than a generic `update` that would also touch content).
161
+ 'add', 'update-review',
162
+ ],
163
+ 'push-delivery': [
164
+ // Browser-push delivery action: `verify` sends a live test notification to
165
+ // a stored subscription and returns an honest delivery receipt (proving the
166
+ // encryption + endpoint round trip). It is a single-purpose delivery probe,
167
+ // not a generic read/lifecycle word — the subscription lifecycle itself uses
168
+ // core verbs (push.subscriptions.create/list/delete, push.vapid.get).
169
+ 'verify',
170
+ ],
152
171
  'process-control': [
153
172
  // OS/service process lifecycle verbs (distinct domain from
154
173
  // enable/disable, which toggle a *record's* activation state) plus
@@ -157,13 +176,13 @@ export const EXEMPT_VERB_CATEGORIES = {
157
176
  'install', 'restart', 'start', 'stop', 'uninstall', 'open', 'reload',
158
177
  ],
159
178
  'legacy-verb-aliases': [
160
- // KNOWN, OUT-OF-SCOPE minor inconsistency (not one of Wave-6's ranked
179
+ // KNOWN, OUT-OF-SCOPE minor inconsistency (not one of the ranked
161
180
  // worst-class collisions): mcp.servers.remove means exactly what `delete`
162
181
  // means everywhere else in the catalog. Flagged here rather than fixed,
163
- // per the Wave-6 scope discipline of fixing only the ranked worst-class
182
+ // per the scope discipline of fixing only the ranked worst-class
164
183
  // items (schedule/memory/tasks/session-orphan/sessions-visibility) —
165
184
  // renaming every already-consistent-but-differently-worded single
166
- // outlier is explicitly out of scope for this wave (W6-C3 risk #6). A
185
+ // outlier was explicitly out of scope for this pass. A
167
186
  // future pass can fold this into `delete`.
168
187
  'remove',
169
188
  ],
@@ -1,7 +1,7 @@
1
1
  export declare const FOUNDATION_METADATA: {
2
2
  readonly productId: "goodvibes";
3
- readonly productVersion: "1.0.0";
4
- readonly operatorMethodCount: 308;
3
+ readonly productVersion: "1.1.0";
4
+ readonly operatorMethodCount: 320;
5
5
  readonly operatorEventCount: 31;
6
6
  readonly peerEndpointCount: 6;
7
7
  };
@@ -1,7 +1,7 @@
1
1
  export const FOUNDATION_METADATA = {
2
2
  "productId": "goodvibes",
3
- "productVersion": "1.0.0",
4
- "operatorMethodCount": 308,
3
+ "productVersion": "1.1.0",
4
+ "operatorMethodCount": 320,
5
5
  "operatorEventCount": 31,
6
6
  "peerEndpointCount": 6
7
7
  };
@@ -1 +1 @@
1
- {"version":3,"file":"operator-contract.d.ts","sourceRoot":"","sources":["../../src/generated/operator-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,eAAO,MAAM,iBAAiB,EAAE,wBA+55EtB,CAAC"}
1
+ {"version":3,"file":"operator-contract.d.ts","sourceRoot":"","sources":["../../src/generated/operator-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,eAAO,MAAM,iBAAiB,EAAE,wBA6r8EtB,CAAC"}