@alphazede/bearing-lite 0.1.0 → 0.1.1

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,41 +1,40 @@
1
1
  ---
2
2
  name: validator
3
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.
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.
10
8
  ---
11
9
 
12
10
  # Validator
13
11
 
14
- ## Trigger
12
+ Independent assurance responsibility, outside the mutation-authority ladder.
15
13
 
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.
14
+ ## Inputs and match
18
15
 
19
- ## Inputs
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
21
+ needs author self-check, or another assurance responsibility applies.
20
22
 
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.
23
+ ## Algorithm
22
24
 
23
- ## Responsibility
25
+ 1. Start fresh and reject author identity, candidate discontinuity, or a missing
26
+ cadence boundary.
27
+ 2. Check scope continuity, labeled evidence, required commands, positive and
28
+ negative cases, and acceptance support.
29
+ 3. Apply `references/grading-rubric.md` only when explicit scoring is requested.
30
+ 4. Return the smallest missing proof or exact failing criterion. Never mutate the
31
+ candidate or manufacture evidence.
24
32
 
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).
33
+ ## Return and recovery
28
34
 
29
- ## Return
35
+ Return `PASS`, `NEEDS_MORE_EVIDENCE`, or `FAIL` with candidate ref, criteria,
36
+ evidence, findings, blocker, next action, and receiver. Re-evaluate only a new
37
+ candidate or materially new evidence, at most three rounds.
30
38
 
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.
39
+ Never implement, repeat unchanged review, replace Park Ranger/Surveyor, or
40
+ grant owner-only approval.
@@ -1,168 +0,0 @@
1
- # Existing-run migration and distribution checkpoints
2
-
3
- How to retire a deep Bearing run without importing hidden runtime state, hand
4
- work off in a project-local readable record, and resume with Bearing Lite.
5
- Repository rename and npm deprecation remain separate owner-authorized release
6
- checkpoints; this guide documents them only and does not perform remote actions.
7
-
8
- Bearing Lite does **not** import `.bearing` data, Focus session state, MCP
9
- runtime state, or CLI journey ledgers. Resume uses a verified human-readable
10
- handoff, the existing approved plan, Bearing Lite, and native agent tools.
11
-
12
- ## Existing-run migration
13
-
14
- For each project that still has deep Bearing run data, complete these steps in
15
- order:
16
-
17
- 1. **Retire the old run read-only.** Leave historical `.bearing/`,
18
- `bearing-<plan>/`, Focus, MCP, and CLI runtime data in place. Do not mutate,
19
- import, or rewrite it as Lite input.
20
- 2. **Write a project-local human-readable handoff** in the affected repository
21
- (for example under that project's planning docs). Fill every field in the
22
- checklist below from visible plan text, Git history, and recorded evidence —
23
- not from hidden runtime stores.
24
- 3. **Verify the handoff** against the project tree and the current candidate
25
- revision: every field is present, paths exist or are intentionally listed as
26
- deleted, blockers and dependencies match the plan, and the next action is
27
- actionable without deep runtime state.
28
- 4. **Resume through Bearing Lite** using the existing approved plan plus native
29
- agent tools. Do not require `.bearing` import, Focus resume, MCP session
30
- restore, or CLI ledger continuity to continue work.
31
- 5. **Keep legacy runtime data read-only** until the handoff is verified. Archive
32
- or remove retired run data only as a later, separate owner-authorized action.
33
-
34
- Stop if migration would require importing hidden runtime state as Lite resume
35
- input. That is out of scope for Bearing Lite; produce a fuller handoff from
36
- visible sources instead.
37
-
38
- ## Project-local handoff checklist
39
-
40
- Use one handoff record per existing run (or per coherent plan-bound workspace).
41
- Every field is required for a complete handoff:
42
-
43
- | Field | What to record |
44
- |---|---|
45
- | **Approved plan** | Path and identity of the owner-approved plan the run was executing (title, date, or plan directory). |
46
- | **Completed work** | Slices, waves, or deliverables already finished and accepted, with enough detail that a new agent does not re-implement them. |
47
- | **Changed paths** | Exact repository paths modified by completed work (added, edited, or intentionally removed). |
48
- | **Commands / evidence** | Commands run, test or validation results, review verdicts, and other durable proof that completed work actually landed. |
49
- | **Blockers** | Open blockers, refusals, or owner decisions still required; write `none` only when none remain. |
50
- | **Dependencies** | Incomplete prerequisites, external packages, environment needs, or cross-slice dependencies that still gate progress. |
51
- | **Next action** | The single concrete next step for the receiving agent or owner, scoped so Lite can resume without deep runtime state. |
52
-
53
- ### Representative handoff template
54
-
55
- Copy into the affected project and fill every section:
56
-
57
- ```markdown
58
- # Migration handoff — <project or plan name>
59
-
60
- ## Approved plan
61
- - Plan path:
62
- - Plan identity / date:
63
-
64
- ## Completed work
65
- - [ ] <slice or deliverable>: summary
66
-
67
- ## Changed paths
68
- - `path/to/file` — added | edited | removed
69
-
70
- ## Commands / evidence
71
- - Command or review: result / artifact path
72
-
73
- ## Blockers
74
- - none | <blocker and owner>
75
-
76
- ## Dependencies
77
- - none | <dependency and why it still gates work>
78
-
79
- ## Next action
80
- - <one concrete next step for Bearing Lite + native tools>
81
- ```
82
-
83
- ### Handoff review (PROC-MIGRATION-01)
84
-
85
- Before treating the handoff as verified, confirm:
86
-
87
- - [ ] Approved plan is named and locatable in the project.
88
- - [ ] Completed work is enumerated without relying on `.bearing` or other hidden state.
89
- - [ ] Changed paths are explicit and match the tree or intentional removals.
90
- - [ ] Commands and evidence are durable and inspectable.
91
- - [ ] Blockers are stated (or explicitly `none`).
92
- - [ ] Dependencies are stated (or explicitly `none`).
93
- - [ ] Next action is sufficient to resume with Bearing Lite and native tools only.
94
- - [ ] No step requires importing `.bearing`, Focus, MCP, or CLI runtime state.
95
-
96
- A handoff that omits blockers, dependencies, or next action is incomplete. A
97
- migration that imports hidden runtime state as Lite input is rejected.
98
-
99
- ## Read-only legacy retirement
100
-
101
- Until the handoff is verified:
102
-
103
- - Treat `.bearing/`, plan-bound `bearing-<plan>/` workspaces, Focus contexts,
104
- MCP session artifacts, and CLI journey ledgers as **read-only historical
105
- evidence**.
106
- - Do not delete, rewrite, or “upgrade” those stores into Lite state.
107
- - Do not point Bearing Lite at them as an import or resume source.
108
-
109
- After the handoff is verified, archive or remove retired run data only under
110
- explicit repository-owner authorization as a separate action. Permanent deletion
111
- is never implied by writing the handoff.
112
-
113
- ## Distribution checkpoints (documentation only)
114
-
115
- These steps are **owner-authorized release checkpoints**. Document them here so
116
- operators know the approved sequence. This guide does **not** rename a
117
- repository, publish or deprecate an npm package, mutate remotes, or perform any
118
- other registry or network publish action.
119
-
120
- Approved sequence (PROC-DISTRIBUTION-01 — verify before any remote action):
121
-
122
- 1. **Repository rename (in place).** Rename the existing public repository from
123
- `alphazede/bearing` to `alphazede/bearing-lite` so public Git history remains
124
- intact. Do not create a replacement repository that discards history.
125
- 2. **Package identity.** Publish future Lite releases only as
126
- `@alphazede/bearing-lite`, and only after exact package and native-client
127
- validation plus explicit owner approval.
128
- 3. **Deprecate the old package.** Deprecate `@alphazede/bearing` with a message
129
- that directs users to Bearing Lite. Do not republish Lite under the old
130
- identity.
131
- 4. **Link and evidence hygiene.** Update public repository, issue, security,
132
- marketplace, package, and documentation links to the Lite identity. Keep
133
- historical public evidence clearly historical rather than rewriting it as
134
- current Lite behavior.
135
- 5. **Protected settings and authorization.** Confirm protected branch or
136
- repository settings, registry credentials, and owner authorization before any
137
- remote mutation. Remote action without that checkpoint is blocked.
138
-
139
- ### Pre-remote owner checklist
140
-
141
- Before any rename, publish, or deprecation command:
142
-
143
- - [ ] Owner has explicitly approved the repository rename
144
- `alphazede/bearing` → `alphazede/bearing-lite`.
145
- - [ ] Owner has explicitly approved publishing `@alphazede/bearing-lite` (not the
146
- old package name).
147
- - [ ] Owner has explicitly approved deprecating `@alphazede/bearing` with a
148
- migration message pointing at Lite.
149
- - [ ] Package identity on the candidate is `@alphazede/bearing-lite`.
150
- - [ ] Protected settings and release authority are confirmed.
151
- - [ ] No remote or registry action is performed from documentation-only work.
152
-
153
- Repository rename, npm deprecation, and publication remain separate protected
154
- owner actions. Completing this migration guide does not authorize them.
155
-
156
- ## What Bearing Lite does not do
157
-
158
- - Import or migrate `.bearing` / Focus / MCP / CLI runtime state as resume input.
159
- - Automatically rewrite deep run data into Lite task records.
160
- - Perform repository rename, npm publish, npm deprecation, or other remote
161
- release actions from ordinary product use.
162
- - Depend on another Bearing product's runtime, state store, or release gate to
163
- resume work.
164
-
165
- Resume authority is the verified project-local handoff, the approved plan, and
166
- native tools under Bearing Lite.
167
-
168
- [Back to the README](../README.md)
@@ -1,38 +0,0 @@
1
- ---
2
- name: delegate-authority
3
- description: >
4
- Maintain owner-approved multi-phase intent and appoint phase Navigators when
5
- the owner explicitly delegates across sessions or Navigator replacement. Use
6
- for delegate authority, multi-phase journey, or long-running delegation. Do
7
- not use for single-wave work, implementation, assurance, contract changes, or
8
- publication.
9
- ---
10
-
11
- # Delegate Authority
12
-
13
- ## Trigger
14
-
15
- - **Match:** owner explicitly delegates a bounded multi-phase journey, especially across sessions or Navigator replacement.
16
- - **Non-match:** ordinary direct, Explorer, or single-phase Expedition work without owner delegation.
17
-
18
- ## Inputs
19
-
20
- Plan path, approved intent, phase boundaries, authority envelope, `required_assurance`, expected handoff.
21
-
22
- ## Responsibility
23
-
24
- Preserve approved intent, appoint phase Navigators, and route phase handoffs. Never implement, assure, amend the contract, or publish.
25
-
26
- ## Return
27
-
28
- Handoff fields: `plan_ref`, `role`, `subject`, `depends_on`, `scope`, `authority`, `outcome`, `evidence`, `blocker`, `next_action`, `receiving_role`.
29
-
30
- Outcomes: `READY`, `REROUTED`, `WAITING_ON`, `OWNER_DECISION_REQUIRED`. Receiver: Navigator or Owner Authority.
31
-
32
- ## Independence
33
-
34
- Dormant until owner delegation is evidenced. Does not self-certify phases.
35
-
36
- ## Correction
37
-
38
- In-authority phase appointment repair only. Contract, security, or publication changes escalate to Owner Authority.