@mr.dj2u/knowledge 0.1.3 → 0.1.5

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.
@@ -42,17 +42,19 @@ mds mcp install --dry-run # preview merge before writing
42
42
  Restart the host (or run `claude mcp reload`) and the MDS prompts are
43
43
  available from any workspace.
44
44
 
45
- Two prompts and several callable MDS MCP tools ship with the server:
46
-
45
+ Two prompts and several callable MDS MCP tools ship with the server:
46
+
47
47
  - `create_expo_super_stack` — invoke from a **parent folder** (e.g.
48
48
  `F:\ReactNativeApps`) when the app folder does not exist yet. This is
49
- now a thin orchestration prompt: the real guided intake happens
50
- through `create_expo_super_stack_intake_step`, generation happens
51
- through `create_expo_super_stack_generate`, and diagnostics come from
52
- `mds_runtime_versions`.
53
- - `onboard_new_expo_app` invoke from **inside an existing Expo app
54
- folder** (a freshly generated one or a year-old project). Runs the
55
- intake normalize plan scaffold flow.
49
+ now a thin orchestration prompt: `mds_runtime_versions` checks for
50
+ stale installs, `create_expo_super_stack_resolve_info` resolves
51
+ project memory in one call when `info.md` is available,
52
+ `create_expo_super_stack_intake_step` is only the manual fallback for
53
+ missing or ambiguous answers, and generation happens through
54
+ `create_expo_super_stack_generate`.
55
+ - `onboard_new_expo_app` invoke from **inside an existing Expo app
56
+ folder** (a freshly generated one or a year-old project). Runs the
57
+ intake → normalize → plan → scaffold flow.
56
58
 
57
59
  After generation, the user-dev should open the generated app folder
58
60
  directly in a new agent session and run `mds continue`. That fresh
@@ -69,33 +71,39 @@ delete the marker line.
69
71
  error so the same blocker stops CI and editor surfaces until the user
70
72
  fills the section or deletes the marker line.
71
73
 
72
- ### What's new in the agentic prompts and tools
73
-
74
- - **PHASE 0 file intake.** The agent offers to digest an existing
75
- `project/info.md` and `project/style.md` if the user has them already.
76
- Questions whose answers are unambiguous in the file are skipped; the
77
- agent asks for clarification only when the file is silent or unclear.
78
- A reference template URL is mentioned in the prompt; the agent can
79
- also inline the template on request.
74
+ ### What's new in the agentic prompts and tools
75
+
76
+ - **PHASE 0 file intake.** The agent offers to digest an existing
77
+ `project/info.md` and `project/style.md` if the user has them already.
78
+ Questions whose answers are unambiguous in the file are skipped; the
79
+ agent asks for clarification only when the file is silent or unclear.
80
+ A reference template URL is mentioned in the prompt; the agent can
81
+ also inline the template on request.
82
+ - **Shared resolver-first intake.** `create_expo_super_stack_resolve_info`
83
+ parses existing project memory up front, derives app naming details,
84
+ merges explicit overrides, returns missing or ambiguous fields, and
85
+ produces a ready-to-pass generate payload so the user is not forced
86
+ through redundant question-by-question discovery.
80
87
  - **Android TV alongside Apple TV.** The platform multi-select now
81
88
  includes Android TV. Android TV builds from the same Android target
82
89
  with leanback config in `app.json`; Apple TV is a separate tvOS build
83
90
  target via `react-native-tvos`. Selecting either records the intent
84
91
  in project memory.
85
- - **Shared CLI-backed intake contract.** The agentic CESS flow now uses
86
- callable MCP tools backed by the shared `@mr.dj2u/cli` intake
87
- contract. That keeps the questionnaire, defaults, dependency rules,
88
- and flag mapping aligned with the published CLI behavior.
89
- - **No silent defaults.** Guided intake must explicitly collect answers
90
- or explicitly present visible defaults. If the CESS intake tools are
91
- unavailable, the agent should stop and tell the user to refresh the
92
- plugin or MCP install instead of inventing `--mds-yes` defaults.
92
+ - **Shared CLI-backed intake contract.** The agentic CESS flow now uses
93
+ callable MCP tools backed by the shared `@mr.dj2u/cli` intake
94
+ contract. That keeps the questionnaire, defaults, dependency rules,
95
+ and flag mapping aligned with the published CLI behavior.
96
+ - **No silent defaults.** Guided intake must explicitly collect answers
97
+ or explicitly present visible defaults. If the CESS intake tools are
98
+ unavailable, the agent should stop and tell the user to refresh the
99
+ plugin or MCP install instead of inventing `--mds-yes` defaults.
93
100
  - **Runtime version diagnostics.** `mds_runtime_versions` reports the
94
- active MCP server version, CLI version, and the published
95
- `create-expo-super-stack@latest` generation path in use.
96
- - **Credits while waiting.** When generation kicks off, the agent
97
- prints a recognition note for the upstream teams and individuals
98
- whose work fills the MDS knowledge base.
101
+ active MCP server version, CLI version, concrete installed
102
+ `create-expo-super-stack` version, and the published generation path
103
+ in use.
104
+ - **Credits while waiting.** When generation kicks off, the agent
105
+ prints a recognition note for the upstream teams and individuals
106
+ whose work fills the MDS knowledge base.
99
107
  - **Success message surfaced.** After a successful run, the agent
100
108
  quotes the generator's `MDS onboarding complete` tail block back
101
109
  verbatim so the Mr. DJ personal thank-you text appears in chat the same way
@@ -144,12 +152,12 @@ Copy-Item -Path .\plugins\vscode-copilot\.vscode\* -Destination .\.vscode -Recur
144
152
  ## Install Path & What This MD Is For
145
153
 
146
154
  - This markdown is a human- and agent-facing guide. It documents the onboarding flow and explains what the agent prompts do. It is used as input to the `packages/knowledge` build which generates plugin/agent bundles for Codex, Claude Code, and VS Code Copilot.
147
- - The agent itself is not this file — it is a runtime that loads generated prompts/skills from the plugin bundles or the MCP server. To activate the agent surfaces you must either:
148
- - Install the MCP prompts via `mds mcp install --client <client>` (user or project scope), or
149
- - Copy the generated plugin files from `plugins/vscode-copilot` / `plugins/codex` / `plugins/claude-code` into the target workspace or user profile and restart the corresponding client.
150
- - If a host keeps using stale prompt or plugin behavior after republish,
151
- refresh the local plugin cache, reinstall the MDS MCP server, and run
152
- `mds_runtime_versions` from the host surface to confirm which version
153
- is actually active.
155
+ - The agent itself is not this file — it is a runtime that loads generated prompts/skills from the plugin bundles or the MCP server. To activate the agent surfaces you must either:
156
+ - Install the MCP prompts via `mds mcp install --client <client>` (user or project scope), or
157
+ - Copy the generated plugin files from `plugins/vscode-copilot` / `plugins/codex` / `plugins/claude-code` into the target workspace or user profile and restart the corresponding client.
158
+ - If a host keeps using stale prompt or plugin behavior after republish,
159
+ refresh the local plugin cache, reinstall the MDS MCP server, and run
160
+ `mds_runtime_versions` from the host surface to confirm which version
161
+ is actually active.
154
162
 
155
163
  If you want, I can: regenerate the VS Code bundle now, copy the assets into the current workspace, and verify Copilot sees the prompts. Say "Do it" and I'll run the build and copy steps for you.
@@ -51,8 +51,8 @@ Configuration patterns establish consistent strategies for managing app configur
51
51
 
52
52
  "platforms": ["ios", "android", "web"],
53
53
 
54
- "sdkVersion": "56.0.0",
55
- "runtimeVersion": "56.0.0",
54
+ "sdkVersion": "56.0.0",
55
+ "runtimeVersion": "56.0.0",
56
56
 
57
57
  "web": {
58
58
  "output": "static",
@@ -178,7 +178,7 @@ export default ({ config }) => {
178
178
  "dependencies": {
179
179
  "react": "^19.0.0",
180
180
  "react-native": "^0.83.0",
181
- "expo": "^56.0.0",
181
+ "expo": "^56.0.0",
182
182
  "expo-router": "^3.0.0",
183
183
  "zustand": "^4.4.0",
184
184
  "drizzle-orm": "^0.30.0",
@@ -456,4 +456,4 @@ export function useConfig() {
456
456
  ---
457
457
 
458
458
  *Pattern extracted from production repositories: DJsPortfolio, time2pay, not-hot-dog*
459
- *Examples: app.json, app.config.js, metro.config.js, babel.config.js, tsconfig.json*
459
+ *Examples: app.json, app.config.js, metro.config.js, babel.config.js, tsconfig.json*
@@ -66,7 +66,7 @@ truth and should not make changes that conflict with those files.
66
66
  Personal portfolio and project showcase for David J Grimsley.
67
67
 
68
68
  ## Core Stack
69
- - **Framework**: Expo SDK 56 + React Native 0.85
69
+ - **Framework**: Expo SDK 56 + React Native 0.85
70
70
  - **Routing**: Expo Router (file-based)
71
71
  - **Styling**: Uniwind v1.2.6 + Tailwind v4
72
72
  - **State**: Zustand (atomic stores)
@@ -179,7 +179,7 @@ ignore:
179
179
 
180
180
  "react": "^19.0.0",
181
181
  "react-native": "^0.83.0",
182
- "expo": "^56.0.0",
182
+ "expo": "^56.0.0",
183
183
  "expo-router": "^3.0.0",
184
184
  "zustand": "^4.4.0"
185
185
  },
@@ -1,6 +1,6 @@
1
1
  # /create-expo-super-stack
2
2
 
3
- Create a new Expo app with the MDS Super Stack flow, using the published CESS CLI as the execution source of truth and callable MDS MCP tools as the guided intake surface.
3
+ Create a new Expo app with the MDS Super Stack flow, using callable MDS MCP tools as the guided intake surface and the Super Stack generator as the scaffold source of truth.
4
4
 
5
5
  ## Arguments
6
6
 
@@ -9,14 +9,37 @@ Create a new Expo app with the MDS Super Stack flow, using the published CESS CL
9
9
 
10
10
  ## Required MDS MCP Tool Flow
11
11
 
12
- 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
- 2. Drive intake with `create_expo_super_stack_intake_step`.
14
- 3. Ask exactly one question per turn.
15
- 4. Always show the returned default and options.
16
- 5. Never invent or silently accept defaults on the user's behalf.
17
- 6. When the intake tool returns `confirm`, summarize the returned `summaryLines` and ask the user to confirm.
18
- 7. After explicit confirmation, set `answers.confirmed=true`, call the intake tool again, and proceed only when it returns `ready`.
19
- 8. Then call `create_expo_super_stack_generate` with `confirmed: true`.
12
+ 1. Call `mds_runtime_versions` first to inspect the active runtime and invocation path.
13
+ 2. If the user pasted or attached `info.md` / project memory, call `create_expo_super_stack_resolve_info` once with `parentDir`, `appName`, `infoMarkdown`, optional `styleMarkdown`, and any explicit user overrides.
14
+ 3. Treat the resolver `answers` object as the canonical accumulated answers object.
15
+ 4. Ask exactly one question per turn only for `missingQuestionIds` or `ambiguousQuestionIds`.
16
+ 5. Do not restart intake with one answer at a time after a successful resolve call.
17
+ 6. If no `info.md` is available, fall back to `create_expo_super_stack_intake_step` and always pass the full accumulated `answers` object.
18
+ 7. When the resolver returns `confirm`, summarize `summaryLines` and ask the user for one final confirmation.
19
+ 8. After explicit confirmation, print the waiting message below, then call `create_expo_super_stack_generate` with the resolver `generateInput` and `confirmed: true`.
20
+
21
+ ## Waiting Message Before Generate
22
+
23
+ After the user confirms, print this block before running the generator so they have something useful to read while scaffolding runs:
24
+
25
+ Generating now. This typically takes 2-5 minutes. While we wait, let's shout out and recognize how this is working.
26
+
27
+ create-expo-super-stack by Mr. DJ (who also built this agentic flow) wraps create-expo-stack by Roni OSS with major contributions by Dan Stepanov (NativeWind). Big thanks to them and to several other teams and individuals whose work and educational materials fill Mr. DJ's Dev Suite knowledge base:
28
+
29
+ - Expo team (Evan Bacon for Expo Router, Brent Vatne, Charlie Cheever, and the broader Expo crew)
30
+ - React and React Native core teams
31
+ - Software Mansion (Reanimated, Gesture Handler, Screens, Worklets; Krzysztof Magiera and team)
32
+ - Supabase, Drizzle, and Zustand teams
33
+ - Adam Wathan and the Tailwind CSS team (the foundation Uniwind and NativeWind build on)
34
+ - Janic Duplessis for "The real cost of React Native animations: benchmarking every approach"
35
+ - Simon Grimm of Galaxies.dev
36
+ - Beto Adrian Maldonado of codewithbeto.dev
37
+ - Vadim of notJust.dev
38
+ - William Candillon for the React Native animation deep-dive content
39
+ - Catalin Miron for the React Native animation tutorials
40
+ - Infinite Red / Jamon Holmgren for Ignite and the broader RN community
41
+
42
+ Their contributions to the software development community are what fill the pages of Mr. DJ's Dev Suite knowledge base, alongside contributions and organization by Mr. DJ. Please enjoy the experience of the Mr. DJ's Dev Suite plugin as you continue your development.
20
43
 
21
44
  ## Failure Behavior
22
45
 
@@ -25,8 +48,12 @@ Create a new Expo app with the MDS Super Stack flow, using the published CESS CL
25
48
  3. Tell the user to refresh or reinstall the MDS plugin/MCP server.
26
49
  4. Do not fall back to `--mds-yes` or direct CLI shortcuts unless the user explicitly asked for a fast non-interactive run.
27
50
 
51
+ Warn only when `mds_runtime_versions.warnings` is non-empty or when the user expected different versions than the runtime reports.
52
+ Do not describe the normal published install path as a fallback, and do not mention `npm exec` or `npx` to the user unless there is an actual runtime problem they need to act on.
53
+
28
54
  ## Verification And Output
29
55
 
30
56
  - Confirm generated app has `project/info.md`, `project/todo.md`, `project/style.md`, and `project/guidelines.md`.
31
57
  - Confirm `project/todo.md` includes the auto-derived roadmap generated from normalized `project/info.md`.
58
+ - If those Super Stack artifacts are missing, treat generation as a failure or partial scaffold and say so clearly instead of presenting it as a normal success.
32
59
  - Output: generated app path, onboarding status, and the handoff to open a fresh agent session inside the new app folder and run `mds continue`.
@@ -17,10 +17,10 @@ Run generator + onboarding as one guided flow, keep agent-facing wording sourced
17
17
 
18
18
  ## Preferred structure
19
19
 
20
- - Keep startup conversation in plain language and summarize choices before execution.
21
- - Keep generation details in scripts/flags, but keep user-facing flow conversational.
22
- - Keep post-generation workflow phase-based using the generated `project/todo.md`, and derive that roadmap from normalized `project/info.md` before handoff.
23
- - Prefer shared knowledge content over duplicating long onboarding prose in plugin or MCP wrappers.
20
+ - Keep startup conversation in plain language and summarize choices before execution.
21
+ - Keep generation details in scripts/flags, but keep user-facing flow conversational.
22
+ - Keep post-generation workflow phase-based using the generated `project/todo.md`, and derive that roadmap from normalized `project/info.md` before handoff.
23
+ - Prefer shared knowledge content over duplicating long onboarding prose in plugin or MCP wrappers.
24
24
 
25
25
  ## Example fix
26
26
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mr.dj2u/knowledge",
3
- "version": "0.1.3",
3
+ "version": "0.1.5",
4
4
  "description": "Skills, patterns, guides, and rules for Expo development (MCP resources)",
5
5
  "type": "module",
6
6
  "files": [