@mr.dj2u/knowledge 0.1.2 → 0.1.4

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
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
50
+ through `create_expo_super_stack_extract_info` first when project
51
+ memory is available, then `create_expo_super_stack_intake_step` only
52
+ for missing or ambiguous answers, generation happens through
53
+ `create_expo_super_stack_generate`, and diagnostics come from
52
54
  `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.
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,38 @@ 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 extraction-first intake.** `create_expo_super_stack_extract_info`
83
+ parses existing project memory up front, derives app naming details,
84
+ preserves unmatched notes, and seeds the intake tool so the user is
85
+ not forced through redundant question-by-question discovery.
80
86
  - **Android TV alongside Apple TV.** The platform multi-select now
81
87
  includes Android TV. Android TV builds from the same Android target
82
88
  with leanback config in `app.json`; Apple TV is a separate tvOS build
83
89
  target via `react-native-tvos`. Selecting either records the intent
84
90
  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.
91
+ - **Shared CLI-backed intake contract.** The agentic CESS flow now uses
92
+ callable MCP tools backed by the shared `@mr.dj2u/cli` intake
93
+ contract. That keeps the questionnaire, defaults, dependency rules,
94
+ and flag mapping aligned with the published CLI behavior.
95
+ - **No silent defaults.** Guided intake must explicitly collect answers
96
+ or explicitly present visible defaults. If the CESS intake tools are
97
+ unavailable, the agent should stop and tell the user to refresh the
98
+ plugin or MCP install instead of inventing `--mds-yes` defaults.
93
99
  - **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.
100
+ active MCP server version, CLI version, concrete installed
101
+ `create-expo-super-stack` version, and the published generation path
102
+ in use.
103
+ - **Credits while waiting.** When generation kicks off, the agent
104
+ prints a recognition note for the upstream teams and individuals
105
+ whose work fills the MDS knowledge base.
99
106
  - **Success message surfaced.** After a successful run, the agent
100
107
  quotes the generator's `MDS onboarding complete` tail block back
101
108
  verbatim so the Mr. DJ personal thank-you text appears in chat the same way
@@ -144,12 +151,12 @@ Copy-Item -Path .\plugins\vscode-copilot\.vscode\* -Destination .\.vscode -Recur
144
151
  ## Install Path & What This MD Is For
145
152
 
146
153
  - 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.
154
+ - 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:
155
+ - Install the MCP prompts via `mds mcp install --client <client>` (user or project scope), or
156
+ - 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.
157
+ - If a host keeps using stale prompt or plugin behavior after republish,
158
+ refresh the local plugin cache, reinstall the MDS MCP server, and run
159
+ `mds_runtime_versions` from the host surface to confirm which version
160
+ is actually active.
154
161
 
155
162
  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,31 +1,34 @@
1
- # /create-expo-super-stack
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.
4
-
5
- ## Arguments
6
-
7
- - `parentDir`: folder where the new app directory should be created.
8
- - `appName`: app folder name.
9
-
10
- ## Required MDS MCP Tool Flow
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`.
20
-
21
- ## Failure Behavior
22
-
23
- 1. If the guided intake or generate tools are unavailable, stop.
24
- 2. Call `mds_runtime_versions` to diagnose stale plugin or MCP installs.
25
- 3. Tell the user to refresh or reinstall the MDS plugin/MCP server.
26
- 4. Do not fall back to `--mds-yes` or direct CLI shortcuts unless the user explicitly asked for a fast non-interactive run.
27
-
28
- ## Verification And Output
29
-
30
- - Confirm generated app has `project/info.md`, `project/todo.md`, `project/style.md`, and `project/guidelines.md`.
31
- - Output: generated app path, onboarding status, and the handoff to open a fresh agent session inside the new app folder and run `mds continue`.
1
+ # /create-expo-super-stack
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.
4
+
5
+ ## Arguments
6
+
7
+ - `parentDir`: folder where the new app directory should be created.
8
+ - `appName`: app folder name.
9
+
10
+ ## Required MDS MCP Tool Flow
11
+
12
+ 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
+ 2. If the user pasted or attached `info.md` / project memory, call `create_expo_super_stack_extract_info` first.
14
+ 3. Seed the returned answers into `create_expo_super_stack_intake_step` and use intake only for missing or ambiguous questions.
15
+ 4. Ask exactly one question per turn.
16
+ 5. Always show the returned default and options.
17
+ 6. Never invent or silently accept defaults on the user's behalf.
18
+ 7. If extraction found the app name, do not ask a second display-name question.
19
+ 8. When the intake tool returns `confirm`, summarize the returned `summaryLines` and ask the user to confirm.
20
+ 9. After explicit confirmation, set `answers.confirmed=true`, call the intake tool again, and proceed only when it returns `ready`.
21
+ 10. Then call `create_expo_super_stack_generate` with `confirmed: true`.
22
+
23
+ ## Failure Behavior
24
+
25
+ 1. If the guided intake or generate tools are unavailable, stop.
26
+ 2. Call `mds_runtime_versions` to diagnose stale plugin or MCP installs.
27
+ 3. Tell the user to refresh or reinstall the MDS plugin/MCP server.
28
+ 4. Do not fall back to `--mds-yes` or direct CLI shortcuts unless the user explicitly asked for a fast non-interactive run.
29
+
30
+ ## Verification And Output
31
+
32
+ - Confirm generated app has `project/info.md`, `project/todo.md`, `project/style.md`, and `project/guidelines.md`.
33
+ - Confirm `project/todo.md` includes the auto-derived roadmap generated from normalized `project/info.md`.
34
+ - Output: generated app path, onboarding status, and the handoff to open a fresh agent session inside the new app folder and run `mds continue`.
@@ -19,7 +19,7 @@ Run generator + onboarding as one guided flow, keep agent-facing wording sourced
19
19
 
20
20
  - Keep startup conversation in plain language and summarize choices before execution.
21
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`.
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
23
  - Prefer shared knowledge content over duplicating long onboarding prose in plugin or MCP wrappers.
24
24
 
25
25
  ## Example fix
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mr.dj2u/knowledge",
3
- "version": "0.1.2",
3
+ "version": "0.1.4",
4
4
  "description": "Skills, patterns, guides, and rules for Expo development (MCP resources)",
5
5
  "type": "module",
6
6
  "files": [