@medicine-wheel/app 0.6.1 → 0.6.3

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 (3) hide show
  1. package/ALPHA.md +13 -10
  2. package/README.md +43 -59
  3. package/package.json +24 -24
package/ALPHA.md CHANGED
@@ -3,25 +3,28 @@
3
3
  **Read this before depending on anything here.**
4
4
 
5
5
  The Medicine Wheel Developer Suite is under active development and is published
6
- in the open so the work can be examined, discussed, and improved. It is not
7
- finished software. Publishing early is deliberate — but so is telling you what
8
- you are installing.
6
+ in the open so the work can be examined, discussed, and improved. It now
7
+ includes a usable app, CLI, MCP server, and a growing set of composable
8
+ libraries, but its public contracts are not yet stable. Publishing early is
9
+ deliberate — and so is telling you what you are installing.
9
10
 
10
11
  ## What that means concretely
11
12
 
12
- - **APIs change between patch versions.** All packages move in lockstep, so a
13
- bump you would normally read as "nothing changed for me" may still change
14
- what you depend on. Pin exact versions.
15
- - **Packages appear, and their boundaries move.** Three packages were added in
16
- `0.5.3`. Where a responsibility lives is still being decided.
13
+ - **APIs can change between patch versions.** Most packages move together while
14
+ the MCP package keeps its own major version, so a bump you would normally read
15
+ as "nothing changed for me" may still change what you depend on. Pin exact
16
+ versions.
17
+ - **Packages appear, and their boundaries move.** The suite has grown beyond
18
+ its first library packages, and where a responsibility lives is still being
19
+ refined.
17
20
  - **Some packages are intentionally small first cuts.** They express an
18
21
  intention with a working minimum rather than a finished surface. Their
19
22
  READMEs say so where it applies.
20
23
  - **Storage shapes are still settling.** Records written by one version may
21
24
  need repair by a later one. Do not treat any store here as an archive of
22
25
  record yet.
23
- - **Test coverage is real but uneven.** 210 tests pass at `0.5.3`; that is a
24
- floor, not a claim of completeness.
26
+ - **Automated tests and release checks are in place, but coverage is uneven.**
27
+ Passing checks are a floor, not a claim of completeness.
25
28
 
26
29
  ## What it does *not* mean
27
30
 
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Medicine Wheel
2
2
 
3
- > A first experimental TypeScript framework for relational healing, ceremonial inquiry, and Indigenous-aligned software development — grounded in the Four Directions, Wilson's three R's (Respect, Reciprocity, Responsibility), and OCAP® data sovereignty principles.
3
+ > An experimental TypeScript framework for relational healing, ceremonial inquiry, and Indigenous-aligned software development — grounded in the Four Directions, Wilson's three R's (Respect, Reciprocity, Responsibility), and OCAP® data sovereignty principles.
4
4
 
5
5
  > [!WARNING]
6
6
  > **Experimental alpha.** APIs change between patch versions, packages appear and
@@ -8,29 +8,30 @@
8
8
  > open so the work can be examined and improved — pin exact versions, and read
9
9
  > [ALPHA.md](./ALPHA.md) before depending on any of it.
10
10
 
11
- ## NEWS
11
+ ## News
12
12
 
13
- * Full postgres (neon) data provider !
13
+ The suite now includes an interactive app, CLI, MCP server, and PostgreSQL/Neon
14
+ storage alongside its composable libraries.
14
15
 
15
16
 
16
17
  ## Architecture
17
18
 
18
19
  ```
19
- medicine-wheel-ontology-core ← Foundation (types, schemas, RDF vocabulary)
20
- ├── medicine-wheel-ceremony-protocol ← Ceremony state & governance
21
- ├── medicine-wheel-fire-keeper ← Ceremony coordination agent
22
- ├── medicine-wheel-community-review ← Elder review & consensus
23
- ├── medicine-wheel-consent-lifecycle ← Relational consent lifecycle
24
- ├── medicine-wheel-narrative-engine ← Beat sequencing & arc validation
25
- ├── medicine-wheel-importance-unit ← Relational unit of knowledge
26
- ├── medicine-wheel-relational-index ← Four-source epistemic indexing
27
- ├── medicine-wheel-transformation-tracker ← Wilson validity tracking
28
- ├── medicine-wheel-graph-viz ← Circular layout & visualization
29
- ├── medicine-wheel-relational-query ← Query, traversal & audit
30
- ├── medicine-wheel-prompt-decomposition ← Intent extraction & PDE
31
- ├── medicine-wheel-ui-components ← React components
32
- ├── medicine-wheel-data-store ← Shared Redis data access
33
- └── medicine-wheel-session-reader ← Session event data reader
20
+ @medicine-wheel/ontology-core ← Foundation (types, schemas, RDF vocabulary)
21
+ ├── @medicine-wheel/ceremony-protocol ← Ceremony state & governance
22
+ ├── @medicine-wheel/fire-keeper ← Ceremony coordination agent
23
+ ├── @medicine-wheel/community-review ← Elder review & consensus
24
+ ├── @medicine-wheel/consent-lifecycle ← Relational consent lifecycle
25
+ ├── @medicine-wheel/narrative-engine ← Beat sequencing & arc validation
26
+ ├── @medicine-wheel/importance-unit ← Relational unit of knowledge
27
+ ├── @medicine-wheel/relational-index ← Four-source epistemic indexing
28
+ ├── @medicine-wheel/transformation-tracker ← Wilson validity tracking
29
+ ├── @medicine-wheel/graph-viz ← Circular layout & visualization
30
+ ├── @medicine-wheel/relational-query ← Query, traversal & audit
31
+ ├── @medicine-wheel/prompt-decomposition ← Intent extraction & PDE
32
+ ├── @medicine-wheel/ui-components ← React components
33
+ ├── @medicine-wheel/data-store ← Shared data access
34
+ └── @medicine-wheel/session-reader ← Session event data reader
34
35
 
35
36
  @medicine-wheel/creative-orientation ← The question asked before the work
36
37
  ├── @medicine-wheel/creative-problem-solving ← Signpost — re-exports the above
@@ -42,7 +43,7 @@ medicine-wheel-ontology-core ← Foundation (types, schemas, RDF vocabu
42
43
  > gap analysis is the right instrument. Named none — you are creating, and
43
44
  > structural tension is. `mw orient "<outcome>"` asks it from the command line.
44
45
 
45
- ## Methodology: RISE Framework
46
+ ## Methodology: [RISE Framework](https://llms.jgwill.com/docs/rise-framework.html)
46
47
 
47
48
  This project utilizes the **RISE** methodology:
48
49
  - **Reverse Engineering**: Deconstructing existing patterns to find relational roots.
@@ -52,125 +53,110 @@ This project utilizes the **RISE** methodology:
52
53
 
53
54
  ## Packages
54
55
 
56
+ The sections below introduce the core building blocks. The root
57
+ [`package.json`](package.json) workspace list is the current inventory of the
58
+ full suite.
59
+
55
60
  ### [@medicine-wheel/ontology-core](src/ontology-core)
56
61
  Core ontology layer — 50+ TypeScript types, Zod validation schemas, RDF vocabulary (6 custom namespaces), canonical constants (Ojibwe names, seasons, direction colors), and semantic query helpers (Wilson alignment, OCAP® compliance, relational traversal).
57
62
 
58
- - **Version:** 0.2.0
59
- - **Dependencies:** `zod` ^3.23.0
63
+ - **Dependencies:** `zod`
60
64
 
61
65
  ### [@medicine-wheel/ceremony-protocol](src/ceremony-protocol)
62
66
  Ceremony lifecycle protocol — manages ceremony state, four-phase transitions (opening → council → integration → closure), governance enforcement for protected paths, and ceremony-required change detection.
63
67
 
64
- - **Version:** 0.2.0
65
- - **Dependencies:** `medicine-wheel-ontology-core`
68
+ - **Dependencies:** `@medicine-wheel/ontology-core`
66
69
 
67
70
  ### [@medicine-wheel/fire-keeper](src/fire-keeper)
68
71
  Fire Keeper coordination agent — tends the ceremony fire, ensures relational integrity through gating conditions, permission tier escalation, and maintains Wilson alignment as an active agent that evaluates, gates, routes, and escalates.
69
72
 
70
- - **Version:** 0.2.0
71
- - **Dependencies:** `medicine-wheel-ontology-core`, `medicine-wheel-ceremony-protocol`
73
+ - **Dependencies:** `@medicine-wheel/ontology-core`, `@medicine-wheel/ceremony-protocol`
72
74
 
73
75
  ### [@medicine-wheel/community-review](src/community-review)
74
76
  Community-based ceremonial review protocol — implements Wilson's validation through Elder review circles, consensus-seeking, talking circle protocol, and relational accountability assessment.
75
77
 
76
- - **Version:** 0.2.0
77
- - **Dependencies:** `medicine-wheel-ontology-core`, `medicine-wheel-ceremony-protocol`, `zod`
78
+ - **Dependencies:** `@medicine-wheel/ontology-core`, `@medicine-wheel/ceremony-protocol`, `zod`
78
79
 
79
80
  ### [@medicine-wheel/consent-lifecycle](src/consent-lifecycle)
80
81
  Ongoing relational consent lifecycle — consent as a living relational obligation with lifecycle tracking, renewal, renegotiation, withdrawal cascades, and community-level consent protocols.
81
82
 
82
- - **Version:** 0.2.0
83
- - **Dependencies:** `medicine-wheel-ontology-core`, `medicine-wheel-ceremony-protocol`, `zod`
83
+ - **Dependencies:** `@medicine-wheel/ontology-core`, `@medicine-wheel/ceremony-protocol`, `zod`
84
84
 
85
85
  ### [@medicine-wheel/narrative-engine](src/narrative-engine)
86
86
  Beat sequencing, cadence validation, arc completeness scoring, timeline building, cycle orchestration, and RSIS narrative generators. Tracks four-directional balance and ceremony coverage.
87
87
 
88
- - **Version:** 0.2.0
89
- - **Dependencies:** `medicine-wheel-ontology-core`
88
+ - **Dependencies:** `@medicine-wheel/ontology-core`
90
89
 
91
90
  ### [@medicine-wheel/importance-unit](src/importance-unit)
92
91
  ImportanceUnit — the relational unit of knowledge in Wilson's epistemology. Carries epistemic weight, source dimensions (Land/Dream/Code/Vision), circle depth tracking, and accountability links. Dream-state knowledge starts at 0.85+ weight; rational-filtered inputs start lower.
93
92
 
94
- - **Version:** 0.2.0
95
- - **Dependencies:** `medicine-wheel-ontology-core`, `zod`
93
+ - **Dependencies:** `@medicine-wheel/ontology-core`, `zod`
96
94
 
97
95
  ### [@medicine-wheel/relational-index](src/relational-index)
98
96
  Four-source epistemic dimensional indexing — Land, Dream, Code, Vision traversal with cross-dimensional mapping, convergence/tension detection, and spiral depth metrics.
99
97
 
100
- - **Version:** 0.2.0
101
- - **Dependencies:** `medicine-wheel-ontology-core`
98
+ - **Dependencies:** `@medicine-wheel/ontology-core`
102
99
 
103
100
  ### [@medicine-wheel/transformation-tracker](src/transformation-tracker)
104
101
  Research transformation tracking — Wilson validity criterion: "If research doesn't change you, you haven't done it right." Tracks researcher growth, community impact, relational shifts, reciprocity balance, and seven-generation sustainability.
105
102
 
106
- - **Version:** 0.2.0
107
- - **Dependencies:** `medicine-wheel-ontology-core`, `medicine-wheel-ceremony-protocol`, `zod`
103
+ - **Dependencies:** `@medicine-wheel/ontology-core`, `@medicine-wheel/ceremony-protocol`, `zod`
108
104
 
109
105
  ### [@medicine-wheel/graph-viz](src/graph-viz)
110
106
  Medicine Wheel circular graph visualization — four-direction node positioning, ceremony-aware edges, OCAP® indicators, SVG path generation, data converters, and RSIS visualization utilities (kinship graphs, reciprocity flows, Mermaid export).
111
107
 
112
- - **Version:** 0.2.0
113
- - **Dependencies:** `medicine-wheel-ontology-core`
114
- - **Peer:** `react` >=18.0.0
108
+ - **Dependencies:** `@medicine-wheel/ontology-core`
109
+ - **Peer:** `react`
115
110
 
116
111
  ### [@medicine-wheel/relational-query](src/relational-query)
117
112
  Query builder for relational webs — node/edge filtering, ceremony-bounded BFS traversal, OCAP®-compliant path walking, accountability auditing, shortest path, neighborhood discovery, and KuzuDB Cypher query builders.
118
113
 
119
- - **Version:** 0.2.0
120
- - **Dependencies:** `medicine-wheel-ontology-core`
114
+ - **Dependencies:** `@medicine-wheel/ontology-core`
121
115
 
122
116
  ### [@medicine-wheel/prompt-decomposition](src/prompt-decomposition)
123
117
  Ontology-enriched prompt decomposition — Four Directions classification, implicit intent extraction from hedging language, dependency mapping, ceremony guidance, action stacking, and narrative beat generation.
124
118
 
125
- - **Version:** 0.2.0
126
- - **Dependencies:** `medicine-wheel-ontology-core`
119
+ - **Dependencies:** `@medicine-wheel/ontology-core`
127
120
 
128
121
  ### [@medicine-wheel/ui-components](src/ui-components)
129
122
  React UI component library — `DirectionCard`, `BeatTimeline`, `NodeInspector`, `OcapBadge`, `WilsonMeter`. All components use ontology-core types for type-safe, culturally grounded interfaces.
130
123
 
131
- - **Version:** 0.2.0
132
- - **Dependencies:** `medicine-wheel-ontology-core`
133
- - **Peer:** `react` ^18.0.0 || ^19.0.0
124
+ - **Dependencies:** `@medicine-wheel/ontology-core`
125
+ - **Peer:** `react`
134
126
 
135
127
  ### [@medicine-wheel/data-store](src/data-store)
136
128
  Shared Redis data-access layer — connection management (Upstash, Vercel KV, local), Node/Edge/Ceremony/Accountability CRUD, session-ceremony linking, and generic Redis helpers.
137
129
 
138
- - **Version:** 0.2.0
139
- - **Dependencies:** `medicine-wheel-ontology-core`, `redis`
130
+ - **Dependencies:** `@medicine-wheel/ontology-core`, `redis`
140
131
 
141
132
  ### [@medicine-wheel/session-reader](src/session-reader)
142
133
  Session event reader — JSONL parsing, session summaries, analytics extraction, and search across agent session data. Zero external dependencies.
143
134
 
144
- - **Version:** 0.2.0
145
135
  - **Dependencies:** None (Node.js built-ins only)
146
136
 
147
137
  ### [@medicine-wheel/creative-orientation](src/creative-orientation)
148
138
  The orientation question, asked before the work: *is there a prior state you are restoring?* Yes — this is a fire, route to gap analysis. No — you are creating, route to structural tension. Reads the claim the caller supplies; advises where phrasing and situation disagree, and never refuses.
149
139
 
150
- - **Version:** 0.5.3
151
140
  - **Dependencies:** None (Node.js built-ins only)
152
141
 
153
142
  ### [@medicine-wheel/creative-problem-solving](src/creative-problem-solving)
154
143
  Signpost package — re-exports `@medicine-wheel/creative-orientation` and adds `THE_QUESTION`. Holds no logic of its own. It exists because "creative problem solving" is the name people look for, and a signpost carrying the traveller's name is how they find the door.
155
144
 
156
- - **Version:** 0.5.3
157
145
  - **Dependencies:** `@medicine-wheel/creative-orientation`
158
146
 
159
147
  ### [@medicine-wheel/gap-analysis](src/gap-analysis)
160
148
  Problem-solving built properly for when something worked and stopped — evidenced baseline, observation, difference, verifiable elimination steps. Root cause, incidents, regressions, troubleshooting. The baseline requirement is what separates a fire from a creating act.
161
149
 
162
- - **Version:** 0.5.3
163
150
  - **Dependencies:** `@medicine-wheel/creative-orientation`
164
151
 
165
152
  ### [@medicine-wheel/brainstorming](src/brainstorming)
166
153
  Idea into committed design through approval gates a human holds — `explore → clarify → approaches → design → spec → review → plan`. Every outcome it emits, including its own multiple-choice questions, passes the orientation question before it is spoken.
167
154
 
168
- - **Version:** 0.5.3
169
155
  - **Dependencies:** `@medicine-wheel/creative-orientation`
170
156
 
171
157
  ## Specifications
172
158
 
173
- RISE framework specifications for all 15 packages are in [`rispecs/`](rispecs/). Start with [`medicine-wheel.spec.md`](rispecs/medicine-wheel.spec.md) for the system overview.
159
+ RISE framework specifications are in [`rispecs/`](rispecs/). Start with [`medicine-wheel.spec.md`](rispecs/medicine-wheel.spec.md) for the system overview.
174
160
 
175
161
  | Package | Spec |
176
162
  |---------|------|
@@ -233,11 +219,9 @@ mw directions
233
219
  mw node list
234
220
  ```
235
221
 
236
- The published app package installs and runs without `@medicine-wheel/mcp`. The `mw`
237
- CLI uses HTTP against the running server by default; MCP fallback is optional via a
238
- local `MW_MCP_PATH`.
222
+ The `mw` CLI uses HTTP against the running server by default; MCP fallback is
223
+ available via a local `MW_MCP_PATH`.
239
224
 
240
225
  ## License
241
226
 
242
227
  MIT see [LICENSE](LICENSE)
243
-
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@medicine-wheel/app",
3
- "version": "0.6.1",
3
+ "version": "0.6.3",
4
4
  "description": "Medicine Wheel — Interactive visual layer for Indigenous relational research with Four Directions, ceremonies, and narrative arcs",
5
5
  "bin": {
6
6
  "mw": "dist/cli/mw.js",
@@ -85,29 +85,29 @@
85
85
  "release:major": "npm run version:major && npm run publish:all && npm run release:commit"
86
86
  },
87
87
  "dependencies": {
88
- "@medicine-wheel/ceremonial-diary": "^0.6.1",
89
- "@medicine-wheel/ceremony-protocol": "^0.6.1",
90
- "@medicine-wheel/community-review": "^0.6.1",
91
- "@medicine-wheel/consent-lifecycle": "^0.6.1",
92
- "@medicine-wheel/creative-orientation": "^0.6.1",
93
- "@medicine-wheel/data-store": "^0.6.1",
94
- "@medicine-wheel/data-store-postgres": "^0.6.1",
95
- "@medicine-wheel/fire-keeper": "^0.6.1",
96
- "@medicine-wheel/github-ceremony": "^0.6.1",
97
- "@medicine-wheel/graph-viz": "^0.6.1",
98
- "@medicine-wheel/importance-unit": "^0.6.1",
99
- "@medicine-wheel/mcp": "^4.6.1",
100
- "@medicine-wheel/narrative-cluster": "^0.6.1",
101
- "@medicine-wheel/narrative-engine": "^0.6.1",
102
- "@medicine-wheel/ontology-core": "^0.6.1",
103
- "@medicine-wheel/perception-layer": "^0.6.1",
104
- "@medicine-wheel/prompt-decomposition": "^0.6.1",
105
- "@medicine-wheel/relational-index": "^0.6.1",
106
- "@medicine-wheel/relational-query": "^0.6.1",
107
- "@medicine-wheel/session-reader": "^0.6.1",
108
- "@medicine-wheel/storage-provider": "^0.6.1",
109
- "@medicine-wheel/transformation-tracker": "^0.6.1",
110
- "@medicine-wheel/ui-components": "^0.6.1",
88
+ "@medicine-wheel/ceremonial-diary": "^0.6.3",
89
+ "@medicine-wheel/ceremony-protocol": "^0.6.3",
90
+ "@medicine-wheel/community-review": "^0.6.3",
91
+ "@medicine-wheel/consent-lifecycle": "^0.6.3",
92
+ "@medicine-wheel/creative-orientation": "^0.6.3",
93
+ "@medicine-wheel/data-store": "^0.6.3",
94
+ "@medicine-wheel/data-store-postgres": "^0.6.3",
95
+ "@medicine-wheel/fire-keeper": "^0.6.3",
96
+ "@medicine-wheel/github-ceremony": "^0.6.3",
97
+ "@medicine-wheel/graph-viz": "^0.6.3",
98
+ "@medicine-wheel/importance-unit": "^0.6.3",
99
+ "@medicine-wheel/mcp": "^4.6.3",
100
+ "@medicine-wheel/narrative-cluster": "^0.6.3",
101
+ "@medicine-wheel/narrative-engine": "^0.6.3",
102
+ "@medicine-wheel/ontology-core": "^0.6.3",
103
+ "@medicine-wheel/perception-layer": "^0.6.3",
104
+ "@medicine-wheel/prompt-decomposition": "^0.6.3",
105
+ "@medicine-wheel/relational-index": "^0.6.3",
106
+ "@medicine-wheel/relational-query": "^0.6.3",
107
+ "@medicine-wheel/session-reader": "^0.6.3",
108
+ "@medicine-wheel/storage-provider": "^0.6.3",
109
+ "@medicine-wheel/transformation-tracker": "^0.6.3",
110
+ "@medicine-wheel/ui-components": "^0.6.3",
111
111
  "@neondatabase/serverless": "^0.10.0",
112
112
  "@xyflow/react": "^12.3.0",
113
113
  "clsx": "^2.1.1",