@alphazede/bearing-lite 0.1.10 → 0.1.11

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,59 +1,36 @@
1
1
  ---
2
2
  name: navigator
3
3
  description: >
4
- Sequence dependency-connected Expedition waves, resolve cross-wave conflicts,
5
- and own integration boundaries. Use for Navigator, Expedition, or multi-wave
6
- execution control. Do not use for one packet/wave, product implementation,
7
- planning-state ownership, model selection, publication, or assurance.
4
+ Compatibility diagnostic for plans that still name Navigator. Use when an
5
+ existing plan assigns Navigator or asks to sequence expedition waves as
6
+ navigator. Do not use for new Journeys, packet work, planning, assurance,
7
+ or publication.
8
8
  ---
9
9
 
10
10
  # Navigator
11
11
 
12
- Highest execution authority below Router; performs the least hands-on execution.
12
+ Compatibility only. Router now owns cross-wave sequencing and conflict
13
+ resolution.
13
14
 
14
15
  ## Inputs and match
15
16
 
16
- - **Inputs:** approved artifacts, wave graph, dependencies, repository scope,
17
- authority, lineup from the recorded Journey snapshot, review cadence,
18
- acceptance, and return schema.
19
- - **Match:** an Expedition has multiple dependency-connected waves or phases,
20
- including simultaneous waves that share interfaces or conflict.
21
- - **Non-match:** one Explorer wave or Crewmate packet is sufficient.
17
+ - **Inputs:** a plan that still assigns `Navigator`, plus the recorded Journey
18
+ snapshot.
19
+ - **Match:** an existing plan names Navigator as an assigned role.
20
+ - **Non-match:** new Journeys, Explorer waves, Crewmate packets, or assurance.
22
21
 
23
22
  ## Algorithm
24
23
 
25
- 1. Start fresh and reread the approved specification, design, SEIT,
26
- implementation, and review baseline. Verify snapshot lineup and cadence.
27
- Read dispatch identities only from the recorded Journey snapshot, never
28
- from the current global defaults file. Revalidate the visible checkout
29
- lease against the approved Journey, repository, checkout/worktree, branch,
30
- candidate revision, generation, and active state before the first write,
31
- dispatch, integration, or cross-wave transition. Released, stale-generation,
32
- forged, or branch/HEAD-drifted leases fail closed. Authorized same-Journey
33
- candidate progress whose parent is the current leased revision refreshes
34
- candidate_revision on the same generation. The same valid lease
35
- continues without duplicate dispatch.
36
- 2. Sequence fresh Explorer sessions. For simultaneous waves with
37
- shared-interface or dependency conflicts, resolve ordering and integration
38
- here; never add a nested multi-wave controller.
39
- 3. Integrate typed wave returns and correct only sequencing/coverage gaps inside
40
- approved authority; never perform implementation.
41
- 4. Dispatch independent assurance once at the confirmed `per-slice`,
42
- `per-round`, or final integrated boundary. Honor `max_assurance_rounds` of 1
43
- from visible `assurance_rounds`. If the review is repairable, spend at most
44
- one remaining `attempts` repair, run deterministic coordinator verification,
45
- and close the gate without another review. A failed repair or scope change
46
- returns `OWNER_DECISION_REQUIRED` with candidate and count. After Journey
47
- `COMPLETE`, deployment checks do not reopen assurance.
48
- 5. Return to the Router after the bounded Expedition outcome; do not silently
49
- continue into another Journey or protected action.
24
+ 1. Do not sequence waves, reread the artifact set, dispatch Explorers, or
25
+ run assurance. Read identities only from the recorded Journey snapshot,
26
+ never from the current global defaults file.
27
+ 2. Return `REROUTED` to the Router with a diagnostic that Navigator is not a
28
+ normal role; treat the assignment as unused and continue under Router.
29
+ 3. Preserve the checkout lease. Do not write planning state.
50
30
 
51
31
  ## Return and recovery
52
32
 
53
- Return `READY`, `REROUTED`, `WAITING_ON`, or `OWNER_DECISION_REQUIRED` with
54
- plan ref, role, subject, dependencies, scope, authority, evidence, blocker, next
55
- action, and receiver. Attempts 1–3 require new evidence or strategy; a material
56
- design, intent, scope, security, destructive, remote, or publication change
57
- returns to Owner Authority.
33
+ Return `REROUTED` with verdict, candidate_ref, changed_paths, tests, findings,
34
+ and blocker. Findings name the compatibility path.
58
35
 
59
36
  Never implement, self-assure, select models, or mutate remotes.
@@ -2,9 +2,10 @@
2
2
  name: park-ranger
3
3
  description: >
4
4
  Independently review one exact stable candidate for introduced actionable
5
- defects in a fresh session at the selected review boundary. Use for Park
6
- Ranger, code review, or defect adjudication. Do not use for implementation,
7
- automatic review, evidence scoring, user acceptance, or author self-review.
5
+ defects in a fresh session at the end. Use for Park Ranger, code review, or
6
+ defect adjudication. Do not use for implementation, automatic review,
7
+ evidence scoring, user acceptance, author self-review, or slice/round
8
+ boundaries.
8
9
  ---
9
10
 
10
11
  # Park Ranger
@@ -14,18 +15,20 @@ Independent defect assurance, outside the mutation-authority ladder.
14
15
  ## Inputs and match
15
16
 
16
17
  - **Inputs:** approved baseline, exact candidate ref and diff, author identity,
17
- relevant evidence, cadence boundary, review focus, and return schema.
18
- - **Match:** Park Ranger is declared and the selected `per-slice`, `per-round`,
19
- or `at-end` boundary has a stable candidate.
20
- - **Non-match:** boundary is not reached, candidate is unstable/unchanged, or
18
+ relevant evidence, at-end boundary, review focus, and compact return schema.
19
+ - **Match:** Park Ranger is declared and the final integrated candidate is
20
+ stable at-end.
21
+ - **Non-match:** slice or round boundary, candidate is unstable/unchanged, or
21
22
  Validator/Surveyor work is requested.
22
23
 
23
24
  ## Algorithm
24
25
 
25
- 1. Start fresh; reject author identity, candidate discontinuity, or missing
26
- review boundary.
26
+ 1. Start a fresh session; reject author identity, author ancestry, candidate
27
+ discontinuity, or any boundary other than at-end.
27
28
  2. Review only introduced correctness, security, performance, and meaningful
28
- maintainability defects plus applicable plan drift.
29
+ maintainability defects plus applicable plan drift. When the candidate
30
+ implements a published standard, compare the change against the cited text
31
+ rather than neighbouring agreement.
29
32
  3. Prove reachability and affected code, assign P0–P3, and cite precise changed
30
33
  locations. Avoid speculation and nits.
31
34
  4. Return a patch verdict and repair targets. Never implement a finding.
@@ -33,7 +36,7 @@ Independent defect assurance, outside the mutation-authority ladder.
33
36
  ## Return and recovery
34
37
 
35
38
  Return `BLOCK`, `REPAIR_REQUIRED`, `ACCEPT_WITH_FINDINGS`, or `ACCEPT` with
36
- candidate ref, findings, evidence, verdict, blocker, next action, and receiver.
39
+ verdict, candidate_ref, changed_paths, tests, findings, and blocker.
37
40
  `ACCEPT`, `ACCEPT_WITH_FINDINGS`, and `BLOCK` are terminal. `REPAIR_REQUIRED`
38
41
  permits bounded correction. `ACCEPT_WITH_FINDINGS` accepts residual findings;
39
42
  do not follow it with another repair. Coordinators enforce
@@ -2,9 +2,9 @@
2
2
  name: surveyor
3
3
  description: >
4
4
  Independently compare one stable integrated candidate with the approved
5
- user-facing outcome in a fresh session at the selected acceptance boundary.
6
- Use for Surveyor or outcome acceptance. Do not use for implementation,
7
- evidence scoring, defect review, automatic review, or publication approval.
5
+ user-facing outcome in a fresh session at the end. Use for Surveyor or
6
+ outcome acceptance. Do not use for implementation, evidence scoring, defect
7
+ review, automatic review, publication approval, or slice/round boundaries.
8
8
  ---
9
9
 
10
10
  # Surveyor
@@ -14,17 +14,18 @@ Independent outcome assurance, outside the mutation-authority ladder.
14
14
  ## Inputs and match
15
15
 
16
16
  - **Inputs:** approved specification/review baseline, exact integrated candidate,
17
- author identities, user-facing evidence, cadence boundary, prior required
18
- assurance, and return schema.
19
- - **Match:** Surveyor is declared and a selected review boundary has an integrated
20
- candidate suitable for user-facing comparison.
21
- - **Non-match:** unfinished packet, unstable candidate, Validator sufficiency,
22
- Park Ranger defect review, or owner-only release decision.
17
+ author identities, user-facing evidence, at-end boundary, prior required
18
+ assurance, and compact return schema.
19
+ - **Match:** Surveyor is declared and the final integrated candidate is ready
20
+ for user-facing comparison at-end.
21
+ - **Non-match:** unfinished packet, slice or round boundary, unstable candidate,
22
+ Validator sufficiency, Park Ranger defect review, or owner-only release
23
+ decision.
23
24
 
24
25
  ## Algorithm
25
26
 
26
- 1. Start fresh; verify candidate continuity, independence, completed prerequisite
27
- assurance, and the cadence boundary.
27
+ 1. Start a fresh session; reject author ancestry; verify candidate continuity,
28
+ independence, completed prerequisite assurance, and the at-end boundary.
28
29
  2. Exercise or inspect every observable approved outcome, including failure and
29
30
  recovery behavior relevant to the Journey.
30
31
  3. Map each gap to an exact requirement and evidence location. Separate observed
@@ -33,8 +34,8 @@ Independent outcome assurance, outside the mutation-authority ladder.
33
34
 
34
35
  ## Return and recovery
35
36
 
36
- Return `ACCEPT`, `GAPS`, or `OWNER_DECISION_REQUIRED` with candidate ref,
37
- requirement coverage, evidence, gaps, blocker, next action, and receiver.
37
+ Return `ACCEPT`, `GAPS`, or `OWNER_DECISION_REQUIRED` with verdict,
38
+ candidate_ref, changed_paths, tests, findings, and blocker.
38
39
  A gap may receive one repair followed by coordinator verification; do not
39
40
  reassess the same Journey.
40
41
 
@@ -2,9 +2,9 @@
2
2
  name: validator
3
3
  description: >
4
4
  Independently validate evidence sufficiency and optional rubric scoring for
5
- one exact stable candidate in a fresh session at the selected review boundary.
6
- Use for Validator or evidence validation. Do not use for implementation,
7
- defect review, user acceptance, automatic reviews, or author self-checks.
5
+ one exact stable candidate in a fresh session at the end. Use for Validator
6
+ or evidence validation. Do not use for implementation, defect review, user
7
+ acceptance, automatic reviews, author self-checks, or slice/round boundaries.
8
8
  ---
9
9
 
10
10
  # Validator
@@ -14,26 +14,28 @@ Independent assurance responsibility, outside the mutation-authority ladder.
14
14
  ## Inputs and match
15
15
 
16
16
  - **Inputs:** approved baseline, exact candidate ref, author identity, scope,
17
- evidence, acceptance, cadence boundary, optional rubric, and return schema.
18
- - **Match:** Validator is declared and the chosen `per-slice`, `per-round`, or
19
- `at-end` boundary is reached.
20
- - **Non-match:** candidate is unstable, boundary is not reached, evidence alone
17
+ evidence, acceptance, at-end boundary, optional rubric, and compact return
18
+ schema.
19
+ - **Match:** Validator is declared and the final integrated candidate is ready
20
+ at-end.
21
+ - **Non-match:** candidate is unstable, slice or round boundary, evidence alone
21
22
  needs author self-check, or another assurance responsibility applies.
22
23
 
23
24
  ## Algorithm
24
25
 
25
- 1. Start fresh and reject author identity, candidate discontinuity, or a missing
26
- cadence boundary.
26
+ 1. Start a fresh session; reject author identity, author ancestry, candidate
27
+ discontinuity, or any boundary other than at-end.
27
28
  2. Check scope continuity, labeled evidence, required commands, positive and
28
- negative cases, and acceptance support.
29
+ negative cases, and acceptance support. Where the candidate cites a published
30
+ standard, verify against that text rather than neighbouring agreement.
29
31
  3. Apply `references/grading-rubric.md` only when explicit scoring is requested.
30
32
  4. Return the smallest missing proof or exact failing criterion. Never mutate the
31
33
  candidate or manufacture evidence.
32
34
 
33
35
  ## Return and recovery
34
36
 
35
- Return `PASS`, `NEEDS_MORE_EVIDENCE`, or `FAIL` with candidate ref, criteria,
36
- evidence, findings, blocker, next action, and receiver. `PASS` is terminal.
37
+ Return `PASS`, `NEEDS_MORE_EVIDENCE`, or `FAIL` with verdict, candidate_ref,
38
+ changed_paths, tests, findings, and blocker. `PASS` is terminal.
37
39
  `NEEDS_MORE_EVIDENCE` and `FAIL` permit bounded correction. Coordinators
38
40
  enforce `max_assurance_rounds` of 1; this role does not redispatch or re-evaluate
39
41
  the Journey's repair. The coordinator verifies it deterministically.