Skip to main content

khive_gate/
operation.rs

1//! Reviewed caller-requested effects for the built-in write restriction.
2//!
3//! Read permits existing incidental audit/cache/maintenance effects; it is not
4//! a storage-level read-only right. See `docs/api/operation-access.md`.
5
6/// Revision of the reviewed classification contract, included in policy identity.
7/// Bump whenever a classification or the allowed-read contract changes.
8pub const OPERATION_CLASSIFIER_VERSION: &str = "domain-effects-v26";
9
10/// Strongest caller-requested effect of a reviewed operation.
11#[derive(Clone, Copy, Debug, PartialEq, Eq)]
12pub enum OperationAccess {
13    /// Retrieval or calculation with existing incidental effects.
14    Read,
15    /// Domain mutation, control change, explicit maintenance, or external effect.
16    Write,
17}
18
19/// Exact reviewed names, including internal handlers and runtime pseudo-verbs.
20/// Sorted for lookup; unknown names must remain distinguishable from Write so
21/// the production registry census fails when a new handler needs review.
22pub const CLASSIFIED_OPERATIONS: &[(&str, OperationAccess)] = &[
23    ("agent.kill", OperationAccess::Write),
24    ("agent.observe", OperationAccess::Read),
25    ("agent.resume", OperationAccess::Write),
26    ("agent.spawn", OperationAccess::Write),
27    ("agent.suspend", OperationAccess::Write),
28    ("apply_changeset", OperationAccess::Write),
29    ("attach", OperationAccess::Write),
30    ("authorize", OperationAccess::Write),
31    ("authorize.visible", OperationAccess::Read),
32    ("blob.abort", OperationAccess::Write),
33    ("blob.begin", OperationAccess::Write),
34    ("blob.commit", OperationAccess::Write),
35    ("blob.export", OperationAccess::Write),
36    ("blob.get", OperationAccess::Read),
37    ("blob.import", OperationAccess::Write),
38    ("blob.put", OperationAccess::Write),
39    ("blob.put_part", OperationAccess::Write),
40    ("blob.stat", OperationAccess::Read),
41    ("brain.activate", OperationAccess::Write),
42    ("brain.archive", OperationAccess::Write),
43    ("brain.auto_feedback", OperationAccess::Write),
44    ("brain.bind", OperationAccess::Write),
45    ("brain.bindings", OperationAccess::Read),
46    ("brain.config", OperationAccess::Read),
47    ("brain.create_profile", OperationAccess::Write),
48    ("brain.deactivate", OperationAccess::Write),
49    ("brain.emit", OperationAccess::Write),
50    ("brain.event_counts", OperationAccess::Read),
51    ("brain.event_page", OperationAccess::Read),
52    ("brain.events", OperationAccess::Read),
53    ("brain.feedback", OperationAccess::Write),
54    ("brain.mark_turn", OperationAccess::Write),
55    ("brain.profile", OperationAccess::Read),
56    ("brain.profiles", OperationAccess::Read),
57    ("brain.record_serve", OperationAccess::Write),
58    ("brain.register_adapter", OperationAccess::Write),
59    ("brain.reset", OperationAccess::Write),
60    ("brain.resolve", OperationAccess::Read),
61    ("brain.state", OperationAccess::Read),
62    ("brain.unbind", OperationAccess::Write),
63    ("charter.cancel", OperationAccess::Write),
64    ("charter.claim", OperationAccess::Write),
65    ("charter.compile", OperationAccess::Read),
66    ("charter.get", OperationAccess::Read),
67    ("charter.list", OperationAccess::Read),
68    ("charter.observe", OperationAccess::Write),
69    ("charter.publish", OperationAccess::Write),
70    ("charter.runs", OperationAccess::Read),
71    ("charter.sample", OperationAccess::Write),
72    ("charter.start", OperationAccess::Write),
73    ("charter.vocabulary", OperationAccess::Write),
74    ("charter.waiting", OperationAccess::Read),
75    ("code.deps", OperationAccess::Read),
76    ("code.ingest", OperationAccess::Write),
77    ("code.list", OperationAccess::Read),
78    ("code.search", OperationAccess::Read),
79    ("comm.cleanup_expired_quarantine", OperationAccess::Write),
80    ("comm.cursor_commit", OperationAccess::Write),
81    ("comm.cursor_get", OperationAccess::Read),
82    ("comm.delivered", OperationAccess::Read),
83    ("comm.health", OperationAccess::Read),
84    ("comm.heartbeat", OperationAccess::Write),
85    ("comm.inbox", OperationAccess::Read),
86    ("comm.ingest", OperationAccess::Write),
87    ("comm.mark_read", OperationAccess::Write),
88    ("comm.probe", OperationAccess::Read),
89    ("comm.read", OperationAccess::Write),
90    ("comm.reply", OperationAccess::Write),
91    ("comm.send", OperationAccess::Write),
92    ("comm.suppression_add", OperationAccess::Write),
93    ("comm.suppression_list", OperationAccess::Read),
94    ("comm.suppression_remove", OperationAccess::Write),
95    ("comm.thread", OperationAccess::Read),
96    ("comm.transport_status", OperationAccess::Read),
97    ("comm.unread", OperationAccess::Read),
98    ("comm.withheld_body", OperationAccess::Write),
99    ("context", OperationAccess::Read),
100    ("count", OperationAccess::Read),
101    ("create", OperationAccess::Write),
102    ("db_diagnostics", OperationAccess::Read),
103    ("delete", OperationAccess::Write),
104    ("exec.events", OperationAccess::Read),
105    ("exec.identity", OperationAccess::Read),
106    ("exec.receipt", OperationAccess::Read),
107    ("exec.run", OperationAccess::Write),
108    ("exec.runs", OperationAccess::Read),
109    ("exec.tree", OperationAccess::Write),
110    ("exec.tree_diff", OperationAccess::Read),
111    ("exec.tree_get", OperationAccess::Read),
112    ("exec.tree_put", OperationAccess::Write),
113    ("get", OperationAccess::Read),
114    ("git.branch", OperationAccess::Write),
115    ("git.checkout", OperationAccess::Write),
116    ("git.commit", OperationAccess::Write),
117    ("git.diff", OperationAccess::Write),
118    ("git.digest", OperationAccess::Write),
119    ("git.gates", OperationAccess::Read),
120    ("git.ingest_cursor", OperationAccess::Read),
121    ("git.init", OperationAccess::Write),
122    ("git.log", OperationAccess::Read),
123    ("git.pr_merge", OperationAccess::Write),
124    ("git.pr_open", OperationAccess::Write),
125    ("git.pr_review", OperationAccess::Write),
126    ("git.push", OperationAccess::Write),
127    ("git.receipts", OperationAccess::Read),
128    ("git.reconcile", OperationAccess::Write),
129    ("git.status", OperationAccess::Read),
130    ("git.update_ref", OperationAccess::Write),
131    ("gtd.assign", OperationAccess::Write),
132    ("gtd.census", OperationAccess::Read),
133    ("gtd.complete", OperationAccess::Write),
134    ("gtd.counts", OperationAccess::Read),
135    ("gtd.next", OperationAccess::Read),
136    ("gtd.repair", OperationAccess::Write),
137    ("gtd.tasks", OperationAccess::Read),
138    ("gtd.transition", OperationAccess::Write),
139    ("kg.proposal_cleanup", OperationAccess::Write),
140    ("knowledge.adjudicate", OperationAccess::Write),
141    ("knowledge.challenge", OperationAccess::Write),
142    ("knowledge.cite", OperationAccess::Write),
143    ("knowledge.compose", OperationAccess::Read),
144    ("knowledge.delete_atoms", OperationAccess::Write),
145    ("knowledge.edit", OperationAccess::Write),
146    ("knowledge.eval_retrieval", OperationAccess::Write),
147    ("knowledge.export", OperationAccess::Read),
148    ("knowledge.feedback", OperationAccess::Write),
149    ("knowledge.fold", OperationAccess::Read),
150    ("knowledge.get", OperationAccess::Read),
151    ("knowledge.import", OperationAccess::Write),
152    ("knowledge.index", OperationAccess::Write),
153    ("knowledge.learn", OperationAccess::Write),
154    ("knowledge.lint", OperationAccess::Write),
155    ("knowledge.list", OperationAccess::Read),
156    ("knowledge.search", OperationAccess::Read),
157    ("knowledge.stats", OperationAccess::Read),
158    ("knowledge.suggest", OperationAccess::Read),
159    ("knowledge.topic", OperationAccess::Read),
160    ("knowledge.upsert_atoms", OperationAccess::Write),
161    ("knowledge.upsert_domains", OperationAccess::Write),
162    ("link", OperationAccess::Write),
163    ("list", OperationAccess::Read),
164    ("memory.apply_batch", OperationAccess::Write),
165    ("memory.feedback", OperationAccess::Write),
166    ("memory.prune", OperationAccess::Write),
167    ("memory.recall", OperationAccess::Read),
168    ("memory.recall_candidates", OperationAccess::Read),
169    ("memory.recall_embed", OperationAccess::Read),
170    ("memory.recall_fuse", OperationAccess::Read),
171    ("memory.recall_rerank", OperationAccess::Read),
172    ("memory.recall_score", OperationAccess::Read),
173    ("memory.remember", OperationAccess::Write),
174    ("memory.vacuum", OperationAccess::Write),
175    ("merge", OperationAccess::Write),
176    ("moodboard.ingest", OperationAccess::Write),
177    ("moodboard.judge", OperationAccess::Write),
178    ("moodboard.model", OperationAccess::Read),
179    ("moodboard.preference", OperationAccess::Read),
180    ("moodboard.search", OperationAccess::Read),
181    ("moodboard.serve", OperationAccess::Write),
182    ("moodboard.train_preference", OperationAccess::Write),
183    ("neighbors", OperationAccess::Read),
184    ("propose", OperationAccess::Write),
185    ("query", OperationAccess::Read),
186    ("resolve", OperationAccess::Read),
187    ("restore", OperationAccess::Write),
188    ("review", OperationAccess::Write),
189    ("scan", OperationAccess::Read),
190    ("schedule.agenda", OperationAccess::Read),
191    ("schedule.cancel", OperationAccess::Write),
192    ("schedule.remind", OperationAccess::Write),
193    ("schedule.schedule", OperationAccess::Write),
194    ("schema", OperationAccess::Read),
195    ("search", OperationAccess::Read),
196    ("session.export", OperationAccess::Read),
197    ("session.list", OperationAccess::Read),
198    ("session.resume", OperationAccess::Read),
199    ("session.search", OperationAccess::Read),
200    ("session.stats", OperationAccess::Read),
201    ("session.store", OperationAccess::Write),
202    ("session.vacuum", OperationAccess::Write),
203    ("stats", OperationAccess::Read),
204    ("stream.append", OperationAccess::Write),
205    ("stream.batch", OperationAccess::Write),
206    ("stream.read", OperationAccess::Read),
207    ("stream.stat", OperationAccess::Read),
208    ("stream.truncate", OperationAccess::Write),
209    ("telemetry.channels", OperationAccess::Read),
210    ("telemetry.counts", OperationAccess::Read),
211    ("telemetry.emit", OperationAccess::Write),
212    ("telemetry.read", OperationAccess::Read),
213    ("tool.check", OperationAccess::Read),
214    ("tool.deny", OperationAccess::Write),
215    ("tool.describe", OperationAccess::Read),
216    ("tool.grant", OperationAccess::Write),
217    ("tool.ingest", OperationAccess::Write),
218    ("tool.list", OperationAccess::Read),
219    ("tool.policies", OperationAccess::Read),
220    ("tool.policy", OperationAccess::Write),
221    ("tool.policy_delete", OperationAccess::Write),
222    ("tool.register", OperationAccess::Write),
223    ("tool.request", OperationAccess::Write),
224    ("tool.requests", OperationAccess::Read),
225    ("tool.revoke", OperationAccess::Write),
226    ("tool.suggest", OperationAccess::Read),
227    ("tool.unregister", OperationAccess::Write),
228    ("traverse", OperationAccess::Read),
229    ("update", OperationAccess::Write),
230    ("verbs", OperationAccess::Read),
231    ("web.extract", OperationAccess::Write),
232    ("web.fetch", OperationAccess::Write),
233    ("web.ingest", OperationAccess::Write),
234    ("web.refresh", OperationAccess::Write),
235    ("web.search", OperationAccess::Write),
236    ("whoami", OperationAccess::Read),
237    ("withdraw", OperationAccess::Write),
238];
239
240/// Classify an exact registered or pseudo-verb name. No prefix/category inference.
241/// A restricting gate must deny `None`, just as it denies explicit Write.
242pub fn classify_operation(verb: &str) -> Option<OperationAccess> {
243    CLASSIFIED_OPERATIONS
244        .binary_search_by_key(&verb, |(name, _)| *name)
245        .ok()
246        .map(|index| CLASSIFIED_OPERATIONS[index].1)
247}
248
249#[cfg(test)]
250#[path = "operation_lint_tests.rs"]
251mod lint_tests;