@reviewsensei/cli-linux-x64-gnu 0.8.13 → 0.8.14

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.
package/README.md CHANGED
@@ -8,7 +8,7 @@ Install the public launcher, which selects the matching native package:
8
8
 
9
9
  <!-- release-installation:package-npm-1:start -->
10
10
  ```console
11
- npm install --save-dev @reviewsensei/cli@0.8.13
11
+ npm install --save-dev @reviewsensei/cli@0.8.14
12
12
  npx review-sensei --help
13
13
  ```
14
14
  <!-- release-installation:package-npm-1:end -->
Binary file
@@ -0,0 +1,560 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://reviewsensei.dev/schemas/v1/api-run-accounting.schema.json",
4
+ "title": "Current caller API request accounting values",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "identity",
9
+ "configuration",
10
+ "owner",
11
+ "startup",
12
+ "startup_used",
13
+ "prior_nonstartup_liability",
14
+ "blocks",
15
+ "completed",
16
+ "version"
17
+ ],
18
+ "properties": {
19
+ "identity": {
20
+ "type": "object",
21
+ "additionalProperties": false,
22
+ "required": [
23
+ "repository_id",
24
+ "run_id"
25
+ ],
26
+ "properties": {
27
+ "repository_id": {
28
+ "type": "integer",
29
+ "minimum": 1
30
+ },
31
+ "run_id": {
32
+ "type": "integer",
33
+ "minimum": 1
34
+ }
35
+ }
36
+ },
37
+ "configuration": {
38
+ "type": "object",
39
+ "additionalProperties": false,
40
+ "required": [
41
+ "commit",
42
+ "digest",
43
+ "limit"
44
+ ],
45
+ "properties": {
46
+ "commit": {
47
+ "type": "string",
48
+ "pattern": "^[a-f0-9]{40}$"
49
+ },
50
+ "digest": {
51
+ "type": "string",
52
+ "pattern": "^[a-f0-9]{64}$"
53
+ },
54
+ "limit": {
55
+ "type": "integer",
56
+ "minimum": 1,
57
+ "maximum": 9007199254740991
58
+ }
59
+ }
60
+ },
61
+ "owner": {
62
+ "$ref": "#/$defs/owner"
63
+ },
64
+ "startup": {
65
+ "type": "object",
66
+ "additionalProperties": false,
67
+ "required": [
68
+ "slots"
69
+ ],
70
+ "properties": {
71
+ "slots": {
72
+ "type": "array",
73
+ "items": {
74
+ "type": "object",
75
+ "additionalProperties": false,
76
+ "required": [
77
+ "job",
78
+ "attempt",
79
+ "requests"
80
+ ],
81
+ "properties": {
82
+ "job": {
83
+ "type": "string",
84
+ "pattern": "^[A-Za-z0-9_.:-]{1,128}$"
85
+ },
86
+ "attempt": {
87
+ "type": "integer",
88
+ "enum": [
89
+ 1,
90
+ 2
91
+ ]
92
+ },
93
+ "requests": {
94
+ "type": "array",
95
+ "items": {
96
+ "type": "string",
97
+ "pattern": "^[A-Za-z0-9_.:-]{1,128}$"
98
+ },
99
+ "minItems": 1
100
+ }
101
+ }
102
+ },
103
+ "minItems": 1
104
+ }
105
+ }
106
+ },
107
+ "startup_used": {
108
+ "type": "array",
109
+ "items": {
110
+ "type": "array",
111
+ "prefixItems": [
112
+ {
113
+ "type": "string",
114
+ "pattern": "^[A-Za-z0-9_.:-]{1,128}$"
115
+ },
116
+ {
117
+ "type": "integer",
118
+ "enum": [
119
+ 1,
120
+ 2
121
+ ]
122
+ }
123
+ ],
124
+ "items": false,
125
+ "minItems": 2,
126
+ "maxItems": 2
127
+ }
128
+ },
129
+ "prior_nonstartup_liability": {
130
+ "type": "integer",
131
+ "minimum": 0
132
+ },
133
+ "blocks": {
134
+ "type": "array",
135
+ "items": {
136
+ "type": "object",
137
+ "additionalProperties": false,
138
+ "required": [
139
+ "block_id",
140
+ "issued_by",
141
+ "undispatched",
142
+ "pending"
143
+ ],
144
+ "properties": {
145
+ "block_id": {
146
+ "type": "string",
147
+ "pattern": "^[A-Za-z0-9_.:-]{1,128}$"
148
+ },
149
+ "issued_by": {
150
+ "$ref": "#/$defs/owner"
151
+ },
152
+ "undispatched": {
153
+ "type": "integer",
154
+ "minimum": 0
155
+ },
156
+ "pending": {
157
+ "type": "array",
158
+ "items": {
159
+ "$ref": "#/$defs/request"
160
+ }
161
+ }
162
+ }
163
+ }
164
+ },
165
+ "completed": {
166
+ "type": "array",
167
+ "items": {
168
+ "$ref": "#/$defs/request"
169
+ }
170
+ },
171
+ "version": {
172
+ "const": "caller-requests-v1"
173
+ },
174
+ "previous_record": {
175
+ "oneOf": [
176
+ {
177
+ "type": "null"
178
+ },
179
+ {
180
+ "type": "object",
181
+ "additionalProperties": false,
182
+ "required": [
183
+ "run_id",
184
+ "root_sha256",
185
+ "manifest"
186
+ ],
187
+ "properties": {
188
+ "run_id": {
189
+ "type": "integer",
190
+ "minimum": 1
191
+ },
192
+ "root_sha256": {
193
+ "type": "string",
194
+ "pattern": "^[a-f0-9]{64}$"
195
+ },
196
+ "manifest": {
197
+ "$ref": "evidence-manifest.schema.json"
198
+ }
199
+ }
200
+ }
201
+ ]
202
+ },
203
+ "terminal_transaction": {
204
+ "oneOf": [
205
+ {
206
+ "type": "null"
207
+ },
208
+ {
209
+ "type": "string",
210
+ "pattern": "^[a-f0-9]{64}$"
211
+ }
212
+ ]
213
+ },
214
+ "analysis_abort": {
215
+ "oneOf": [
216
+ {
217
+ "type": "null"
218
+ },
219
+ {
220
+ "type": "object",
221
+ "additionalProperties": false,
222
+ "required": [
223
+ "source_root",
224
+ "cleanup_root",
225
+ "transaction",
226
+ "entry_state",
227
+ "run_id",
228
+ "owner"
229
+ ],
230
+ "properties": {
231
+ "source_root": {
232
+ "type": "string",
233
+ "pattern": "^[a-f0-9]{64}$"
234
+ },
235
+ "cleanup_root": {
236
+ "type": "string",
237
+ "pattern": "^[a-f0-9]{64}$"
238
+ },
239
+ "transaction": {
240
+ "$ref": "review-transaction.schema.json"
241
+ },
242
+ "entry_state": {
243
+ "const": "not_started"
244
+ },
245
+ "run_id": {
246
+ "type": "integer",
247
+ "minimum": 1
248
+ },
249
+ "owner": {
250
+ "$ref": "#/$defs/owner"
251
+ }
252
+ }
253
+ }
254
+ ]
255
+ },
256
+ "action": {
257
+ "oneOf": [
258
+ {
259
+ "type": "null"
260
+ },
261
+ {
262
+ "type": "object",
263
+ "additionalProperties": false,
264
+ "required": [
265
+ "intent",
266
+ "phase",
267
+ "execution_started",
268
+ "result",
269
+ "outcome"
270
+ ],
271
+ "properties": {
272
+ "intent": {
273
+ "type": "object",
274
+ "additionalProperties": false,
275
+ "required": [
276
+ "purpose",
277
+ "source",
278
+ "run_id",
279
+ "owner",
280
+ "head_sha",
281
+ "configuration_digest",
282
+ "operation_key",
283
+ "source_root"
284
+ ],
285
+ "properties": {
286
+ "purpose": {
287
+ "enum": [
288
+ "command",
289
+ "reply"
290
+ ]
291
+ },
292
+ "source": {
293
+ "type": "object",
294
+ "additionalProperties": false,
295
+ "required": [
296
+ "kind",
297
+ "id",
298
+ "updated_at",
299
+ "body_sha256"
300
+ ],
301
+ "properties": {
302
+ "kind": {
303
+ "enum": [
304
+ "issue_comment",
305
+ "review_comment"
306
+ ]
307
+ },
308
+ "id": {
309
+ "type": "integer",
310
+ "minimum": 1
311
+ },
312
+ "updated_at": {
313
+ "type": "string",
314
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{1,6})?Z$"
315
+ },
316
+ "body_sha256": {
317
+ "type": "string",
318
+ "pattern": "^[a-f0-9]{64}$"
319
+ }
320
+ }
321
+ },
322
+ "run_id": {
323
+ "type": "integer",
324
+ "minimum": 1
325
+ },
326
+ "owner": {
327
+ "$ref": "#/$defs/owner"
328
+ },
329
+ "head_sha": {
330
+ "type": "string",
331
+ "pattern": "^[a-f0-9]{40}$"
332
+ },
333
+ "configuration_digest": {
334
+ "type": "string",
335
+ "pattern": "^[a-f0-9]{64}$"
336
+ },
337
+ "operation_key": {
338
+ "type": "string",
339
+ "pattern": "^[a-f0-9]{64}$"
340
+ },
341
+ "source_root": {
342
+ "type": "string",
343
+ "pattern": "^[a-f0-9]{64}$"
344
+ }
345
+ }
346
+ },
347
+ "phase": {
348
+ "enum": [
349
+ "pending",
350
+ "terminal"
351
+ ]
352
+ },
353
+ "execution_started": {
354
+ "type": "boolean"
355
+ },
356
+ "result": {
357
+ "oneOf": [
358
+ {
359
+ "type": "null"
360
+ },
361
+ {
362
+ "type": "object",
363
+ "additionalProperties": false,
364
+ "required": [
365
+ "encoding",
366
+ "binding",
367
+ "item_count",
368
+ "sha256",
369
+ "document"
370
+ ],
371
+ "properties": {
372
+ "encoding": {
373
+ "const": "inline-json-v1"
374
+ },
375
+ "binding": {
376
+ "type": "object",
377
+ "additionalProperties": false,
378
+ "required": [
379
+ "repository",
380
+ "repository_id",
381
+ "pull_request",
382
+ "base_sha",
383
+ "head_sha",
384
+ "policy_digest",
385
+ "configuration_digest",
386
+ "generation",
387
+ "producer",
388
+ "purpose",
389
+ "schema_version"
390
+ ],
391
+ "properties": {
392
+ "repository": {
393
+ "type": "string",
394
+ "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$",
395
+ "maxLength": 256
396
+ },
397
+ "repository_id": {
398
+ "type": [
399
+ "integer",
400
+ "null"
401
+ ],
402
+ "minimum": 1,
403
+ "maximum": 2147483647
404
+ },
405
+ "pull_request": {
406
+ "type": "integer",
407
+ "minimum": 1,
408
+ "maximum": 2147483647
409
+ },
410
+ "base_sha": {
411
+ "type": "string",
412
+ "pattern": "^[a-f0-9]{40}$"
413
+ },
414
+ "head_sha": {
415
+ "type": "string",
416
+ "pattern": "^[a-f0-9]{40}$"
417
+ },
418
+ "policy_digest": {
419
+ "type": "string",
420
+ "pattern": "^[a-f0-9]{64}$"
421
+ },
422
+ "configuration_digest": {
423
+ "type": "string",
424
+ "pattern": "^[a-f0-9]{64}$"
425
+ },
426
+ "generation": {
427
+ "type": "integer",
428
+ "minimum": 0,
429
+ "maximum": 2147483647
430
+ },
431
+ "producer": {
432
+ "type": "string",
433
+ "pattern": "^(local-ledger|github-bot:[1-9][0-9]{0,18})$"
434
+ },
435
+ "purpose": {
436
+ "enum": [
437
+ "baseline",
438
+ "human-inventory",
439
+ "feedback",
440
+ "evidence",
441
+ "queue",
442
+ "dispositions"
443
+ ]
444
+ },
445
+ "schema_version": {
446
+ "const": "1.0"
447
+ }
448
+ }
449
+ },
450
+ "item_count": {
451
+ "type": "integer",
452
+ "const": 1
453
+ },
454
+ "sha256": {
455
+ "type": "string",
456
+ "pattern": "^[a-f0-9]{64}$"
457
+ },
458
+ "document": {
459
+ "type": "object"
460
+ }
461
+ }
462
+ }
463
+ ]
464
+ },
465
+ "outcome": {
466
+ "oneOf": [
467
+ {
468
+ "type": "null"
469
+ },
470
+ {
471
+ "type": "object",
472
+ "additionalProperties": false,
473
+ "required": [
474
+ "kind",
475
+ "reason"
476
+ ],
477
+ "properties": {
478
+ "kind": {
479
+ "enum": [
480
+ "applied",
481
+ "already_applied",
482
+ "explicit_noop"
483
+ ]
484
+ },
485
+ "reason": {
486
+ "oneOf": [
487
+ {
488
+ "type": "null"
489
+ },
490
+ {
491
+ "enum": [
492
+ "status",
493
+ "already_handled",
494
+ "policy_disabled",
495
+ "not_a_command",
496
+ "unauthorized",
497
+ "writes_disabled",
498
+ "not_mentioned",
499
+ "source_already_handled",
500
+ "no_change"
501
+ ]
502
+ }
503
+ ]
504
+ }
505
+ }
506
+ }
507
+ ]
508
+ }
509
+ }
510
+ }
511
+ ]
512
+ }
513
+ },
514
+ "$defs": {
515
+ "owner": {
516
+ "type": "object",
517
+ "additionalProperties": false,
518
+ "required": [
519
+ "run_attempt",
520
+ "job",
521
+ "generation"
522
+ ],
523
+ "properties": {
524
+ "run_attempt": {
525
+ "type": "integer",
526
+ "enum": [
527
+ 1,
528
+ 2
529
+ ]
530
+ },
531
+ "job": {
532
+ "type": "string",
533
+ "pattern": "^[A-Za-z0-9_.:-]{1,128}$"
534
+ },
535
+ "generation": {
536
+ "type": "integer",
537
+ "minimum": 0
538
+ }
539
+ }
540
+ },
541
+ "request": {
542
+ "type": "object",
543
+ "additionalProperties": false,
544
+ "required": [
545
+ "request_id",
546
+ "deadline_unix_ms"
547
+ ],
548
+ "properties": {
549
+ "request_id": {
550
+ "type": "string",
551
+ "pattern": "^[A-Za-z0-9_.:-]{1,128}$"
552
+ },
553
+ "deadline_unix_ms": {
554
+ "type": "integer",
555
+ "minimum": 1
556
+ }
557
+ }
558
+ }
559
+ }
560
+ }
@@ -22,6 +22,9 @@
22
22
  "record_sha256"
23
23
  ],
24
24
  "properties": {
25
+ "api_run_accounting": {
26
+ "$ref": "https://reviewsensei.dev/schemas/v1/api-run-accounting.schema.json"
27
+ },
25
28
  "disposition_snapshot": {
26
29
  "type": "object",
27
30
  "additionalProperties": false,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: review-sensei
3
- Version: 0.8.13
3
+ Version: 0.8.14
4
4
  Summary: Provider-neutral AI code review engine with an Ollama adapter.
5
5
  Author: Mohamad Alsabbagh
6
6
  License-Expression: MIT
@@ -37,8 +37,9 @@ providers later.
37
37
  > primary usage path is running ReviewSensei in your own GitHub Actions
38
38
  > workflow. Setup-v4 callers follow the operator-managed public `v5` tag; the
39
39
  > Worker validates that tag before creating the setup PR and the broker resolves
40
- > it again when issuing a capability. The broker still accepts `v4` during
41
- > migration. The example workflow installs exact versioned packages; its
40
+ > it again when issuing a capability. Current callers and Worker use the same
41
+ > purpose-bound authority format; obsolete authority is refused. The example
42
+ > workflow installs exact versioned packages; its
42
43
  > [version-specific installation contract](docs/installation.md#github-workflow-example)
43
44
  > defines registry requirements and source fallback. Supported paths prove the intended
44
45
  > release identity against a compatibility manifest; live canary and `v5`
@@ -94,10 +95,28 @@ and a repository without that file uses the packaged defaults:
94
95
  ```yaml
95
96
  schema: 1
96
97
 
98
+ api_request_limit: 512
99
+
97
100
  inference:
98
101
  backend: local-ollama
99
102
  ```
100
103
 
104
+ `api_request_limit` bounds ReviewSensei caller HTTP attempts for one authenticated
105
+ Actions run, across startup, review or conversation work, publication and cleanup.
106
+ OIDC, GitHub reads and writes, and each Worker POST count; a Worker POST counts
107
+ once regardless of its internal fanout. Inference keeps its separate resource
108
+ limits. Checkout, package installation and artifact upload are infrastructure
109
+ outside this allowance.
110
+
111
+ The default is 512. Positive integers through 9,007,199,254,740,991 are accepted;
112
+ admission requires at least 238 for review/reply or 240 for commands under the
113
+ current finite reservation policy. These minimums do not promise completion.
114
+ Independent pagination, retained-state, output and deadline limits still apply.
115
+ Failed, uncertain and abandoned allocations stay charged. A supported successor
116
+ attempt shares the original run's allowance and must prove predecessor cessation.
117
+ See [the accounting decision](docs/adr/0111-caller-api-work-allowance.md) for the
118
+ recovery and deployment contract.
119
+
101
120
  Select a backend on the command line when one run needs a different one:
102
121
 
103
122
  ```bash
@@ -139,8 +158,8 @@ provider-neutral `@reviewsensei/cli` launcher:
139
158
 
140
159
  <!-- release-installation:package-npm-1:start -->
141
160
  ```bash
142
- npx --yes @reviewsensei/cli@0.8.13 --version
143
- npx --yes @reviewsensei/cli@0.8.13 --help
161
+ npx --yes @reviewsensei/cli@0.8.14 --version
162
+ npx --yes @reviewsensei/cli@0.8.14 --help
144
163
  ```
145
164
  <!-- release-installation:package-npm-1:end -->
146
165
 
@@ -146,6 +146,8 @@ docs/adr/0107-bounded-remaining-coverage.md
146
146
  docs/adr/0108-finalization-operational-failures.md
147
147
  docs/adr/0109-registry-bound-core-installation.md
148
148
  docs/adr/0110-repository-bound-thread-cleanup.md
149
+ docs/adr/0111-caller-api-work-allowance.md
150
+ docs/adr/0112-retained-published-rescan-inventory.md
149
151
  docs/adr/README.md
150
152
  docs/architecture/index.md
151
153
  docs/architecture/mandatory-rules.md
@@ -255,6 +257,7 @@ examples/stages/02-comments.json
255
257
  examples/stages/03-learning-proposals.json
256
258
  src/review_sensei/__init__.py
257
259
  src/review_sensei/__main__.py
260
+ src/review_sensei/api_work.py
258
261
  src/review_sensei/assessment_history_index.py
259
262
  src/review_sensei/assessment_queue.py
260
263
  src/review_sensei/baseline.py
@@ -332,6 +335,7 @@ src/review_sensei/providers/profiles.py
332
335
  src/review_sensei/providers/registry.py
333
336
  src/review_sensei/providers/routing.py
334
337
  src/review_sensei/providers/transport.py
338
+ src/review_sensei/schemas/api-run-accounting.schema.json
335
339
  src/review_sensei/schemas/assessment-queue-root.schema.json
336
340
  src/review_sensei/schemas/baseline-evidence.schema.json
337
341
  src/review_sensei/schemas/blocker-admission.schema.json
@@ -389,15 +393,31 @@ tests/packaging_guard.py
389
393
  tests/provider_common_flow_contract.py
390
394
  tests/provider_deadline_contract.py
391
395
  tests/session_fixture_clock.py
396
+ tests/test_action_completion.py
397
+ tests/test_action_reply.py
398
+ tests/test_action_reply_entry.py
399
+ tests/test_action_result_codec.py
400
+ tests/test_action_run.py
392
401
  tests/test_activation_tail.py
402
+ tests/test_api_work.py
403
+ tests/test_api_work_actions.py
404
+ tests/test_api_work_lifecycle.py
405
+ tests/test_api_work_operations.py
406
+ tests/test_api_work_persistence.py
407
+ tests/test_api_work_public_review.py
408
+ tests/test_api_work_rescan.py
409
+ tests/test_api_work_root_bounds.py
393
410
  tests/test_approval_progress.py
394
411
  tests/test_assessment_queue.py
395
412
  tests/test_assessment_queue_storage.py
396
413
  tests/test_authenticated_partitions.py
397
414
  tests/test_bounded_v1_publication.py
415
+ tests/test_broker_admission_hold.py
398
416
  tests/test_broker_dispatch_control.py
417
+ tests/test_caller_operation_diagnostics.py
399
418
  tests/test_checkpoint_publication_acceptance.py
400
419
  tests/test_command_capacity_recovery.py
420
+ tests/test_current_command_inventory.py
401
421
  tests/test_default_human_consumers.py
402
422
  tests/test_default_human_inventory.py
403
423
  tests/test_default_human_inventory_cli.py
@@ -433,18 +453,25 @@ tests/test_publication_pagination_budget.py
433
453
  tests/test_publication_recovery.py
434
454
  tests/test_publication_recovery_phase.py
435
455
  tests/test_remaining_progress.py
456
+ tests/test_retained_full_rescan.py
457
+ tests/test_retired_hosted_authority.py
458
+ tests/test_review_run.py
459
+ tests/test_review_run_rescan.py
436
460
  tests/test_review_transaction.py
437
461
  tests/test_review_work.py
438
462
  tests/test_rich250_late_feedback.py
439
463
  tests/test_rich250_public_writer.py
464
+ tests/test_run_authority.py
440
465
  tests/test_schema5_public_contract.py
441
466
  tests/test_trusted_publication_recovery.py
467
+ tests/test_work_continuation.py
442
468
  tests/dist_safe/test_approval_lifecycle_contract.py
443
469
  tests/dist_safe/test_baseline_recovery_contract.py
444
470
  tests/dist_safe/test_broker_dispatch_control_contract.py
445
471
  tests/dist_safe/test_command_capacity_contract.py
446
472
  tests/dist_safe/test_comment_command_contract.py
447
473
  tests/dist_safe/test_conversation_deadline_contract.py
474
+ tests/dist_safe/test_current_run_contract.py
448
475
  tests/dist_safe/test_default_human_inventory_contract.py
449
476
  tests/dist_safe/test_default_publication_recovery_contract.py
450
477
  tests/dist_safe/test_diff_records_contract.py
package/bin/review-sensei CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@reviewsensei/cli-linux-x64-gnu",
3
- "version": "0.8.13",
3
+ "version": "0.8.14",
4
4
  "description": "ReviewSensei AI code review engine for Linux x64 with glibc 2.36+; native payload used by @reviewsensei/cli",
5
5
  "license": "MIT",
6
6
  "repository": {