@alphazede/bearing-lite 0.1.0

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.
Files changed (35) hide show
  1. package/CODE_OF_CONDUCT.md +45 -0
  2. package/CONTRIBUTING.md +74 -0
  3. package/LICENSE-APACHE +202 -0
  4. package/README.md +213 -0
  5. package/SECURITY.md +89 -0
  6. package/guide/migration.md +168 -0
  7. package/hooks/activation.cjs +163 -0
  8. package/hooks/closeout.cjs +242 -0
  9. package/hooks/protected-action.cjs +229 -0
  10. package/hooks/transition-order.cjs +290 -0
  11. package/package.json +37 -0
  12. package/plugin.json +22 -0
  13. package/skills/bearing-lite/SKILL.md +40 -0
  14. package/skills/bearing-lite/assets/role-routing.png +0 -0
  15. package/skills/bearing-lite/assets/task-state.png +0 -0
  16. package/skills/bearing-lite/references/role-routing.mmd +34 -0
  17. package/skills/bearing-lite/references/task-state.md +42 -0
  18. package/skills/bearing-lite/references/task-state.mmd +29 -0
  19. package/skills/bearing-lite/templates/task.md +55 -0
  20. package/skills/crewmate/SKILL.md +37 -0
  21. package/skills/delegate-authority/SKILL.md +38 -0
  22. package/skills/explorer/SKILL.md +38 -0
  23. package/skills/gather-supplies/SKILL.md +33 -0
  24. package/skills/map-the-route/SKILL.md +33 -0
  25. package/skills/map-the-route/references/artifact-grammar.md +83 -0
  26. package/skills/navigator/SKILL.md +44 -0
  27. package/skills/park-ranger/SKILL.md +38 -0
  28. package/skills/repository-fit/SKILL.md +33 -0
  29. package/skills/set-bearings/SKILL.md +33 -0
  30. package/skills/sub-explorer/SKILL.md +37 -0
  31. package/skills/surveyor/SKILL.md +38 -0
  32. package/skills/trail-boss/SKILL.md +38 -0
  33. package/skills/trail-boss/agents/openai.yaml +4 -0
  34. package/skills/validator/SKILL.md +41 -0
  35. package/skills/validator/references/grading-rubric.md +39 -0
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Trail Boss"
3
+ short_description: "Coordinate approved Expedition Explorer lanes"
4
+ default_prompt: "Use $trail-boss to coordinate the approved Expedition wave graph."
@@ -0,0 +1,41 @@
1
+ ---
2
+ name: validator
3
+ description: >
4
+ Independently check evidence sufficiency and optional explicit-rubric scoring
5
+ for one exact candidate when required_assurance includes Validator, the owner
6
+ opts in, a stable checkpoint needs scoring, or a phase gate requires it. Use
7
+ for validator, sufficiency check, or rubric scoring. Do not use to edit the
8
+ candidate, auto-run on every packet completion, or replace Park Ranger or
9
+ Surveyor.
10
+ ---
11
+
12
+ # Validator
13
+
14
+ ## Trigger
15
+
16
+ - **Match:** `required_assurance` lists Validator; owner opts in at slice/packet level; stable checkpoint needs explicit rubric scoring; or mandatory phase gate requires Validator.
17
+ - **Non-match:** `required_assurance: none` without owner opt-in or phase gate; defect review (Park Ranger); user-facing acceptance (Surveyor); implementation work.
18
+
19
+ ## Inputs
20
+
21
+ Plan path, exact `candidate_ref`, author identity, evidence, acceptance criteria, optional scoring request, expected handoff. Load `references/grading-rubric.md` only when explicit scoring is requested.
22
+
23
+ ## Responsibility
24
+
25
+ 1. Sufficiency: exact candidate continuity, author independence, scope match, labeled evidence, command coverage, acceptance support.
26
+ 2. Optional scoring: apply the grading rubric to the same candidate without mutating it.
27
+ 3. Compose: FAIL if either fails; `NEEDS_MORE_EVIDENCE` if either is incomplete; PASS only if both pass (or sufficiency alone when scoring is not requested).
28
+
29
+ ## Return
30
+
31
+ Handoff fields: `plan_ref`, `role`, `subject`, `depends_on`, `scope`, `authority`, `outcome`, `evidence`, `blocker`, `next_action`, `receiving_role`.
32
+
33
+ Outcomes: `PASS`, `NEEDS_MORE_EVIDENCE`, `FAIL`. Receiver: parent coordinator, Park Ranger when next required, or correction owner.
34
+
35
+ ## Independence
36
+
37
+ Fresh non-author only. Candidate authors never supply this verdict. Not automatic solely because a packet claims completion.
38
+
39
+ ## Correction
40
+
41
+ Never edits the candidate. Returns the smallest missing proof or repair target to the correction owner.
@@ -0,0 +1,39 @@
1
+ # Grading rubric (Validator scoring)
2
+
3
+ Use only when the task, owner, or phase gate requests **explicit rubric scoring**.
4
+ Sufficiency checks always run when Validator is active. Scoring is optional and
5
+ never makes independent assurance automatic.
6
+
7
+ ## Dimensions (equal weight unless the plan overrides)
8
+
9
+ | ID | Dimension | Complete (2) | Partial (1) | Missing (0) |
10
+ | --- | --- | --- | --- | --- |
11
+ | D1 | Contract coverage | Acceptance criteria and requirement IDs are evidenced | Some criteria evidenced | Major criteria unaddressed |
12
+ | D2 | Scope discipline | Diff stays inside declared authority and allowed paths | Minor unexplained adjacency | Out-of-set or authority expansion |
13
+ | D3 | Evidence quality | Commands, observed results, and inferences labeled separately | Mixed labels | Fabricated, missing, or unlabeled claims |
14
+ | D4 | Command completeness | Declared command IDs have results | Partial command set | Required commands absent |
15
+ | D5 | Residual risk | Remaining risks and non-goals disclosed | Vague residual notes | Silent risk omission on material change |
16
+ | D6 | Handoff integrity | Return fields match the task block; `candidate_ref` is exact | Incomplete fields | Stale subject or candidate mismatch |
17
+
18
+ ## Score
19
+
20
+ Sum dimension scores (0–12).
21
+
22
+ - **10–12** and no required dimension is 0: scoring supports `PASS` only if sufficiency also passes.
23
+ - **8–9** or any required dimension is 0: `NEEDS_MORE_EVIDENCE` unless severity is fatal.
24
+ - **Below 8**, fabricated evidence, or author self-certification: `FAIL`.
25
+
26
+ ## Composition with sufficiency
27
+
28
+ 1. Run sufficiency on the exact candidate first.
29
+ 2. If scoring is requested, score the same candidate with this rubric.
30
+ 3. Final Validator outcome:
31
+ - `FAIL` if either check fails
32
+ - `NEEDS_MORE_EVIDENCE` if either needs more proof
33
+ - `PASS` only when sufficiency passes and (scoring was not requested, or scoring supports PASS)
34
+ 4. Never edit the candidate. Never score a candidate you authored or materially repaired.
35
+
36
+ ## Non-goals
37
+
38
+ This rubric does not replace Park Ranger defect review or Surveyor acceptance.
39
+ It does not install tools, widen diffs, or select models.