@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.
- package/README.md +43 -25
- package/hooks/closeout.cjs +64 -15
- package/hooks/com.anthropic.claude-code/host.cjs +8 -11
- package/hooks/com.anthropic.claude-code/mapping.md +16 -2
- package/hooks/planning-review.cjs +99 -0
- package/hooks/transition-order.cjs +13 -0
- package/package.json +6 -3
- package/plugin.json +1 -1
- package/skills/bearing-lite/SKILL.md +39 -46
- package/skills/bearing-lite/agents/openai.yaml +1 -1
- package/skills/bearing-lite/references/peer-synthesis.md +1 -1
- package/skills/bearing-lite/references/review-policy.md +37 -0
- package/skills/bearing-lite/references/role-routing.mmd +9 -9
- package/skills/bearing-lite/references/task-state.md +2 -2
- package/skills/bearing-lite/templates/default-role-lineup.md +4 -2
- package/skills/bearing-lite/templates/task.md +64 -16
- package/skills/crewmate/SKILL.md +23 -17
- package/skills/explorer/SKILL.md +34 -34
- package/skills/gather-supplies/SKILL.md +2 -1
- package/skills/map-the-route/SKILL.md +47 -36
- package/skills/map-the-route/references/artifact-grammar.md +52 -11
- package/skills/navigator/SKILL.md +18 -41
- package/skills/park-ranger/SKILL.md +14 -11
- package/skills/surveyor/SKILL.md +14 -13
- package/skills/validator/SKILL.md +14 -12
|
@@ -1,59 +1,36 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: navigator
|
|
3
3
|
description: >
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
-
|
|
12
|
+
Compatibility only. Router now owns cross-wave sequencing and conflict
|
|
13
|
+
resolution.
|
|
13
14
|
|
|
14
15
|
## Inputs and match
|
|
15
16
|
|
|
16
|
-
- **Inputs:**
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
- **
|
|
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.
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
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 `
|
|
54
|
-
|
|
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
|
|
6
|
-
|
|
7
|
-
|
|
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,
|
|
18
|
-
- **Match:** Park Ranger is declared and the
|
|
19
|
-
|
|
20
|
-
- **Non-match:**
|
|
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,
|
|
26
|
-
|
|
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
|
-
|
|
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
|
package/skills/surveyor/SKILL.md
CHANGED
|
@@ -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
|
|
6
|
-
|
|
7
|
-
|
|
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,
|
|
18
|
-
assurance, and return schema.
|
|
19
|
-
- **Match:** Surveyor is declared and
|
|
20
|
-
|
|
21
|
-
- **Non-match:** unfinished packet,
|
|
22
|
-
Park Ranger defect review, or owner-only release
|
|
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,
|
|
27
|
-
assurance, and the
|
|
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
|
|
37
|
-
|
|
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
|
|
6
|
-
|
|
7
|
-
|
|
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,
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
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
|
|
26
|
-
|
|
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
|
|
36
|
-
|
|
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.
|