@shardworks/astrolabe-apparatus 0.1.194 → 0.1.196

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shardworks/astrolabe-apparatus",
3
- "version": "0.1.194",
3
+ "version": "0.1.196",
4
4
  "license": "ISC",
5
5
  "repository": {
6
6
  "type": "git",
@@ -20,16 +20,16 @@
20
20
  },
21
21
  "dependencies": {
22
22
  "zod": "4.3.6",
23
- "@shardworks/stacks-apparatus": "0.1.194",
24
- "@shardworks/tools-apparatus": "0.1.194",
25
- "@shardworks/clerk-apparatus": "0.1.194",
26
- "@shardworks/fabricator-apparatus": "0.1.194",
27
- "@shardworks/spider-apparatus": "0.1.194",
28
- "@shardworks/loom-apparatus": "0.1.194"
23
+ "@shardworks/stacks-apparatus": "0.1.196",
24
+ "@shardworks/tools-apparatus": "0.1.196",
25
+ "@shardworks/spider-apparatus": "0.1.196",
26
+ "@shardworks/fabricator-apparatus": "0.1.196",
27
+ "@shardworks/clerk-apparatus": "0.1.196",
28
+ "@shardworks/loom-apparatus": "0.1.196"
29
29
  },
30
30
  "devDependencies": {
31
31
  "@types/node": "25.5.0",
32
- "@shardworks/nexus-core": "0.1.194"
32
+ "@shardworks/nexus-core": "0.1.196"
33
33
  },
34
34
  "files": [
35
35
  "dist",
package/sage-analyst.md CHANGED
@@ -95,10 +95,9 @@ Each decision needs:
95
95
  - `options` — key → description map of reasonable approaches (keep descriptions to one line each)
96
96
  - `recommendation` — the option key you recommend
97
97
  - `rationale` — why this option, in one line
98
+ - `selected` — pre-fill with your recommendation. This enables a trust-and-submit review path: in high-trust or urgent situations the patron can accept all decisions as-is without touching each one. The patron changes `selected` only when overriding, and if they write a custom override the reconcile loop replaces `selected` with `patronOverride` automatically. Never set both yourself.
98
99
  - `analysis` — classification metadata (see below)
99
100
 
100
- Do **not** write to `selected` — that field is owned by the patron-review pass. The analyst writes `recommendation`; the patron's choice populates `selected` (or `patronOverride` for custom write-ins) during decision review.
101
-
102
101
  Order decisions by scope item, then by category (product → api → implementation).
103
102
 
104
103
  Write all decisions using `decisions-write`.
@@ -33,7 +33,7 @@ You also have the standard file-reading tools (Read, Glob, Grep) for exploring t
33
33
  2. Read the codebase — but let your growing understanding of the change guide which files you read. You do not need to do a full repo walk followed by a separate analysis turn. As you read, you will naturally form scope boundaries, identify decision points, and notice observations. Let that understanding steer your exploration.
34
34
  3. Write the codebase inventory using `inventory-write`. The inventory must meet the full quality bar described below.
35
35
  4. Write scope items using `scope-write`. Break the brief into coarse, independently deliverable capabilities. Each item should be something the patron might include or exclude.
36
- 5. Write decisions using `decisions-write`. Be exhaustive — capture every design question including ones where the answer seems obvious from codebase conventions. Each decision needs: id, scope references, question, context, options, recommendation, rationale, and analysis metadata (category, observable, confidence, stakes). Do **not** write to `selected` — that field is owned by the patron-review pass.
36
+ 5. Write decisions using `decisions-write`. Be exhaustive — capture every design question including ones where the answer seems obvious from codebase conventions. Each decision needs: id, scope references, question, context, options, recommendation, rationale, selected (pre-fill with recommendation so the patron can trust-and-submit), and analysis metadata (category, observable, confidence, stakes). Never set `patronOverride` — that field is owned by the patron-review pass.
37
37
  6. Write observations using `observations-write`. Record refactoring opportunities, risks, suboptimal conventions, doc/code discrepancies, and potential bugs noticed during your pass.
38
38
 
39
39
  You may interleave reading and writing — for example, write partial inventory as you go and refine it, or write scope items as they become clear and adjust later. The key constraint is that when you finish, all four artifacts (inventory, scope, decisions, observations) must be complete and written to the plan via the write tools.
@@ -132,10 +132,9 @@ Each decision needs:
132
132
  - `options` — key → description map of reasonable approaches (keep descriptions to one line each)
133
133
  - `recommendation` — the option key you recommend
134
134
  - `rationale` — why this option, in one line
135
+ - `selected` — pre-fill with your recommendation. This enables a trust-and-submit review path: in high-trust or urgent situations the patron can accept all decisions as-is without touching each one. The patron changes `selected` only when overriding, and if they write a custom override the reconcile loop replaces `selected` with `patronOverride` automatically. Never set both yourself.
135
136
  - `analysis` — classification metadata (see below)
136
137
 
137
- Do **not** write to `selected` — that field is owned by the patron-review pass. The analyst writes `recommendation`; the patron's choice populates `selected` (or `patronOverride` for custom write-ins) during decision review.
138
-
139
138
  Order decisions by scope item, then by category (product → api → implementation).
140
139
 
141
140
  #### Decision Analysis Metadata