@contextrail/assess 1.0.0-alpha.3 → 1.0.0-alpha.4

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.
@@ -15,7 +15,9 @@ Look up a specific setting here. For a first integration, use [GitHub Actions se
15
15
  | `provider`, `model` | Required `openai` or `openrouter` and explicit provider-native model. No fallback. |
16
16
  | `enforcement` | `advisory` (default), `required`, or `strict`. See the [outcome table](review-results.md#interpret-judgments-and-exit-codes); execution failures always return 2. |
17
17
  | `effort` | Optional CLI effort; empty delegates to provider default. |
18
+ | `speed` | `normal` (default), `fast` or `ultrafast` provider service tier. Unsupported tiers are logged and the run continues. |
18
19
  | `max-time-ms` | Required positive workflow model deadline, at most 2147483647 ms. Does not bound total job time. |
20
+ | `max-verify-calls` | Optional model calls per finding verification; empty uses the package default (12). See [extended capacity](../README.md#give-large-pull-requests-more-capacity). |
19
21
  | `feedback` | `send` (default) or `off`; CLI owns report submission and its status. |
20
22
  | `repository-attribution` | `true` or `false` (default); explicitly includes repository identity in CLI retrieval/reporting. |
21
23
  | `artifact-retention-days` | 1–90, default 7, within repository/organization retention policy. |
@@ -32,7 +32,17 @@ quickstart with:
32
32
 
33
33
  `--effort none|minimal|low|medium|high|xhigh` requests provider-specific reasoning
34
34
  effort only when that model supports it. A valid CLI setting does not ensure that
35
- a provider accepts it. Source excerpts and published guidance are sent to your
35
+ a provider accepts it.
36
+
37
+ `--speed normal|fast|ultrafast` (default `normal`) requests the provider's service
38
+ tier for every call: `fast` sends `service_tier: "priority"` and `ultrafast` sends
39
+ `service_tier: "ultrafast"`. Both OpenAI and OpenRouter read the field, but only some
40
+ models serve each tier, and faster tiers cost more per token. The tier is best effort:
41
+ if the provider rejects it, Assess logs `provider_speed_unavailable`, resends that
42
+ request without the tier and stops requesting it for that model; if a response reports
43
+ a different tier, Assess logs the same event once. Neither case fails the run.
44
+
45
+ Source excerpts and published guidance are sent to your
36
46
  selected model provider; use an account and data-handling arrangement appropriate
37
47
  for that material.
38
48
 
@@ -69,6 +79,7 @@ and reviewer ID have no environment aliases. See `--help` for the current option
69
79
  | `--max-output-tokens N` | Unset; per-call output allowance, including reasoning tokens where applicable. |
70
80
  | `--max-total-tokens N` | Unset; observed provider total-token cutoff between calls. Can overshoot by one call; missing usage prevents honest enforcement and stops the review. |
71
81
  | `--max-time-ms N` | Unset; model-session deadline in ms, excluding preparation. |
82
+ | `--max-verify-calls N` | 12; model calls per finding verification. Raise it for large changes. |
72
83
  | `--source-page-entries N` | 100 entries per list/change response. |
73
84
  | `--source-search-matches N` / `--source-search-files N` | 100 each, per search page. |
74
85
  | `--source-read-lines N` / `--source-read-bytes N` | 200 lines / 65536 bytes per source response; bytes >=4. |
@@ -97,6 +97,7 @@ confirms ingestion only. [Results and next actions](review-results.md) explains
97
97
  - **PR discussion/history:** add `pr-context: 'true'`. Read the [data implications](security.md) first.
98
98
  - **Merge policy:** set `enforcement: required` for supported binding violations, or `strict` to also block unresolved evidence. Configure branch protection to require the job if desired. Do not use `continue-on-error` to create advisory behavior; it would hide execution failures.
99
99
  - **Retention:** set `artifact-retention-days` to a permitted value from 1–90. The default is seven days.
100
+ - **Large pull requests:** add a second label that re-runs an incomplete assessment with a faster tier, a longer time limit and more verification calls. See [give large pull requests more capacity](../README.md#give-large-pull-requests-more-capacity).
100
101
  - **Models:** one model serves both roles by default. Add `effort` only if the model supports it; [phase overrides](configuration.md#models-by-phase-and-logging) let you select a different verifier later.
101
102
 
102
103
  Repository variable names belong to your caller workflow. In this example `ASSESS_MODEL` is passed
@@ -21,7 +21,7 @@ jobs:
21
21
  runs-on: ubuntu-latest
22
22
  timeout-minutes: 30
23
23
  env:
24
- ASSESS_PACKAGE_VERSION: '1.0.0-alpha.3'
24
+ ASSESS_PACKAGE_VERSION: '1.0.0-alpha.4'
25
25
  REVIEWER_ID: skill://your-domain/your-reviewer
26
26
  ASSESS_PROVIDER: openai
27
27
  ASSESS_MODEL: REPLACE_WITH_PROVIDER_MODEL_ID
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@contextrail/assess",
3
- "version": "1.0.0-alpha.3",
3
+ "version": "1.0.0-alpha.4",
4
4
  "description": "Assess proposed Git changes against published organizational standards, with per-standard outcomes and retained evidence.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",