@mr.dj2u/knowledge 0.1.7 → 0.1.9

package/dist/content/checklists/push-merge-loop.md

@@ -1,17 +1,17 @@
-# Push-Merge Loop Checklist
-
-Use this checklist when running the PR loop into `test`.
-
-1. Doctor CI pass: `mds doctor --ci`.
-2. Stage intentional files only.
-3. Create meaningful commit message.
-4. Push branch.
-5. Open/update PR to `test`.
-6. Wait ~2 minutes before polling checks/comments.
-7. Collect failed checks + review comments.
-8. Fix issues locally.
-9. Rerun Doctor CI.
-10. Push and poll again.
-11. Repeat up to 5 cycles.
-12. Merge only when checks are green and blockers are cleared.
-
+# Push-Merge Loop Checklist
+
+Use this checklist when running the PR loop into `test`.
+
+1. Doctor CI pass: `mds doctor --ci`.
+2. Stage intentional files only.
+3. Create meaningful commit message.
+4. Push branch.
+5. Open/update PR to `test`.
+6. Wait ~2 minutes before polling checks/comments.
+7. Collect failed checks + review comments.
+8. Fix issues locally.
+9. Rerun Doctor CI.
+10. Push and poll again.
+11. Repeat up to 5 cycles.
+12. Merge only when checks are green and blockers are cleared.
+

package/dist/content/checklists/unified-agent-bundle-validation.md

@@ -1,9 +1,9 @@
-# Unified Agent Bundle Validation Checklist
-
-Phase 9 validation artifact intent:
-
-1. Run Doctor (`--ci`) through the agent.
-2. Fetch one guide via MCP resource (`animation-performance`).
-3. Execute one CLI workflow (`mds continue` or `/push-merge-loop`).
-4. Confirm tools/resources are visible in the target client.
-
+# Unified Agent Bundle Validation Checklist
+
+Phase 9 validation artifact intent:
+
+1. Run Doctor (`--ci`) through the agent.
+2. Fetch one guide via MCP resource (`animation-performance`).
+3. Execute one CLI workflow (`mds continue` or `/push-merge-loop`).
+4. Confirm tools/resources are visible in the target client.
+

package/dist/content/examples/push-merge-loop.md

@@ -1,14 +1,14 @@
-# Push-Merge Loop Example
-
-Example iteration log for `/push-merge-loop`:
-
-- Iteration 1:
-  - Failed: `lint` and one requested review change.
-  - Fixes: remove dead import, update API guard clause.
-  - Result: `lint` green, one test still failing.
-- Iteration 2:
-  - Failed: `test` in `packages/cli`.
-  - Fixes: update stale skill ID expectation.
-  - Result: all checks green.
-- Merge: PR merged into `test`.
-
+# Push-Merge Loop Example
+
+Example iteration log for `/push-merge-loop`:
+
+- Iteration 1:
+  - Failed: `lint` and one requested review change.
+  - Fixes: remove dead import, update API guard clause.
+  - Result: `lint` green, one test still failing.
+- Iteration 2:
+  - Failed: `test` in `packages/cli`.
+  - Fixes: update stale skill ID expectation.
+  - Result: all checks green.
+- Merge: PR merged into `test`.
+

package/dist/content/examples/unified-agent-bundle-bootstrap.md

@@ -1,8 +1,8 @@
-# Unified Agent Bundle Bootstrap Example
-
-Phase 9 bootstrap artifact intent:
-
-1. Install MCP server config.
-2. Install generated skills/prompts package.
-3. Verify the agent can call Doctor + knowledge tools.
-4. Verify the agent can run one CLI workflow.
+# Unified Agent Bundle Bootstrap Example
+
+Phase 9 bootstrap artifact intent:
+
+1. Install MCP server config.
+2. Install generated skills/prompts package.
+3. Verify the agent can call Doctor + knowledge tools.
+4. Verify the agent can run one CLI workflow.

package/dist/content/guides/post-create-onboarding.md

@@ -1,49 +1,59 @@
-# Post-Create Expo Onboarding
-
-MDS onboarding runs after `rn-new`, `create-expo-app`, `create-expo-stack`, or
-another generator has created an Expo project. `create-expo-super-stack` wraps
-that same idea by running `create-expo-stack` first and then applying the MDS
-onboarding pass.
-
-## Flow
-
-1. Detect package manager, Expo SDK, Expo Router, app directory, aliases, and
-   styling stack.
-2. Explain project memory first, then ask what the app is for, who it serves,
-   primary flows, data needs, and release/deployment intent.
-3. Use friendly Clack prompts with visible defaults, helpful explanations, and
-   no blank required answers.
-4. Derive defaults from selected answers instead of asking for comma-separated
-   internal keywords.
-5. Offer rich boilerplate by default: project memory docs, exposition pages,
-   Uniwind repair for existing apps, Software Mansion core examples, Supabase or
-   local data guidance, MCP/Codex/Claude instructions, and CI/release safeguards.
-6. Scaffold only selected pieces.
-7. Add generated cleanup scripts such as `clear-expo-start` and `free-port`.
-8. Install added dependencies, run `expo install --fix`, install known missing
-   Expo peers such as `expo-font` for `@expo/vector-icons`, then run Doctor.
-
-## Agentic Onboarding (MCP)
-
-The terminal `mds onboard` command writes the project memory files. The
-agentic version is a conversation with Copilot, Claude Code, Codex, or Cursor that
-fills those files in collaboratively.
-
-Install **once, globally** (user scope, default) so every workspace gets
-the prompts:
-
-```bash
-mds mcp install --client claude   # merges into ~/.claude.json
-mds mcp install --client codex    # merges into ~/.codex/config.toml
-mds mcp install --client cursor   # merges into ~/.cursor/mcp.json
-mds mcp install --dry-run         # preview merge before writing
-```
-
-Restart the host (or run `claude mcp reload`) and the MDS prompts are
-available from any workspace.
-
-Two prompts and several callable MDS MCP tools ship with the server:
-
+# Post-Create Expo Onboarding
+
+MDS onboarding runs after `rn-new`, `create-expo-app`, `create-expo-stack`, or
+another generator has created an Expo project. `create-expo-super-stack` wraps
+that same idea by running `create-expo-stack` first and then applying the MDS
+onboarding pass.
+
+## Flow
+
+1. Detect package manager, Expo SDK, Expo Router, app directory, aliases, and
+   styling stack.
+2. Explain project memory first, then ask what the app is for, who it serves,
+   primary flows, data needs, and release/deployment intent.
+3. Use friendly Clack prompts with visible defaults, helpful explanations, and
+   no blank required answers.
+4. Derive defaults from selected answers instead of asking for comma-separated
+   internal keywords.
+5. Offer rich boilerplate by default: project memory docs, exposition pages,
+   Uniwind repair for existing apps, Software Mansion core examples, Supabase or
+   local data guidance, MCP/Codex/Claude instructions, and CI/release safeguards.
+6. Scaffold only selected pieces.
+7. Add generated cleanup scripts such as `clear-expo-start` and `free-port`.
+8. Add default-enabled React Doctor support: `react-doctor` in `devDependencies`,
+   `doctor.config.json`, README section, and `mds run react-doctor` /
+   `npm run react-doctor` scripts. React Doctor stays off the Expo/Metro startup
+   path for minimal overhead. Disable with `MDS_REACT_DOCTOR=0` or
+   `"mds": { "reactDoctor": false }` in `package.json`.
+9. Install added dependencies immediately with the project's package manager,
+   then validate that newly declared packages exist in `node_modules`. Standalone
+   `mds onboard` does this lockfile install unless `--no-install` is passed.
+   `create-expo-super-stack` then continues with create-time Expo repair:
+   `expo install --fix`, known missing Expo peers such as `expo-font` for
+   `@expo/vector-icons`, and Expo Doctor. Do not treat onboarding as complete if
+   install failed or was explicitly skipped.
+
+## Agentic Onboarding (MCP)
+
+The terminal `mds onboard` command writes the project memory files. The
+agentic version is a conversation with Copilot, Claude Code, Codex, or Cursor that
+fills those files in collaboratively.
+
+Install **once, globally** (user scope, default) so every workspace gets
+the prompts:
+
+```bash
+mds mcp install --client claude   # merges into ~/.claude.json
+mds mcp install --client codex    # merges into ~/.codex/config.toml
+mds mcp install --client cursor   # merges into ~/.cursor/mcp.json
+mds mcp install --dry-run         # preview merge before writing
+```
+
+Restart the host (or run `claude mcp reload`) and the MDS prompts are
+available from any workspace.
+
+Two prompts and several callable MDS MCP tools ship with the server:
+
 - `create_expo_super_stack` — invoke from a **parent folder** (e.g.
   `F:\ReactNativeApps`) when the app folder does not exist yet. This is
   now a thin orchestration prompt: `mds_runtime_versions` checks for
@@ -52,27 +62,27 @@ Two prompts and several callable MDS MCP tools ship with the server:
   `create_expo_super_stack_intake_step` is only the manual fallback for
   missing or ambiguous answers, and generation happens through
   `create_expo_super_stack_generate`.
-- `onboard_new_expo_app` — invoke from **inside an existing Expo app
-  folder** (a freshly generated one or a year-old project). Runs the
-  intake → normalize → plan → scaffold flow.
-
-After generation, the user-dev should open the generated app folder
-directly in a new agent session and run `mds continue`. That fresh
-app-root session reduces token usage and saves money because future
-searches, reads, and plans are scoped to the app instead of the parent
-folder and old generator conversation.
-
-Both prompts enforce or surface a **TodoForContext blocker** before
-implementation work: they scan every `project/` file for the literal
-marker `# TodoForContext(optional):` and ask the user to fill it in or
-delete the marker line.
-
-`mds doctor` mirrors this rule with a `todo-for-context markers`
-error so the same blocker stops CI and editor surfaces until the user
-fills the section or deletes the marker line.
-
-### What's new in the agentic prompts and tools
-
+- `onboard_new_expo_app` — invoke from **inside an existing Expo app
+  folder** (a freshly generated one or a year-old project). Runs the
+  intake → normalize → plan → scaffold flow.
+
+After generation, the user-dev should open the generated app folder
+directly in a new agent session and run `mds continue`. That fresh
+app-root session reduces token usage and saves money because future
+searches, reads, and plans are scoped to the app instead of the parent
+folder and old generator conversation.
+
+Both prompts enforce or surface a **TodoForContext blocker** before
+implementation work: they scan every `project/` file for the literal
+marker `# TodoForContext(optional):` and ask the user to fill it in or
+delete the marker line.
+
+`mds doctor` mirrors this rule with a `todo-for-context markers`
+error so the same blocker stops CI and editor surfaces until the user
+fills the section or deletes the marker line.
+
+### What's new in the agentic prompts and tools
+
 - **PHASE 0 file intake.** The agent offers to digest an existing
   `project/info.md` and `project/style.md` if the user has them already.
   Questions whose answers are unambiguous in the file are skipped; the
@@ -84,80 +94,80 @@ fills the section or deletes the marker line.
   merges explicit overrides, returns missing or ambiguous fields, and
   produces a ready-to-pass generate payload so the user is not forced
   through redundant question-by-question discovery.
-- **Android TV alongside Apple TV.** The platform multi-select now
-  includes Android TV. Android TV builds from the same Android target
-  with leanback config in `app.json`; Apple TV is a separate tvOS build
-  target via `react-native-tvos`. Selecting either records the intent
-  in project memory.
-- **Shared CLI-backed intake contract.** The agentic CESS flow now uses
-  callable MCP tools backed by the shared `@mr.dj2u/cli` intake
-  contract. That keeps the questionnaire, defaults, dependency rules,
-  and flag mapping aligned with the published CLI behavior.
-- **No silent defaults.** Guided intake must explicitly collect answers
-  or explicitly present visible defaults. If the CESS intake tools are
-  unavailable, the agent should stop and tell the user to refresh the
-  plugin or MCP install instead of inventing `--mds-yes` defaults.
+- **Android TV alongside Apple TV.** The platform multi-select now
+  includes Android TV. Android TV builds from the same Android target
+  with leanback config in `app.json`; Apple TV is a separate tvOS build
+  target via `react-native-tvos`. Selecting either records the intent
+  in project memory.
+- **Shared CLI-backed intake contract.** The agentic CESS flow now uses
+  callable MCP tools backed by the shared `@mr.dj2u/cli` intake
+  contract. That keeps the questionnaire, defaults, dependency rules,
+  and flag mapping aligned with the published CLI behavior.
+- **No silent defaults.** Guided intake must explicitly collect answers
+  or explicitly present visible defaults. If the CESS intake tools are
+  unavailable, the agent should stop and tell the user to refresh the
+  plugin or MCP install instead of inventing `--mds-yes` defaults.
 - **Runtime version diagnostics.** `mds_runtime_versions` reports the
   active MCP server version, CLI version, concrete installed
   `create-expo-super-stack` version, and the published generation path
   in use.
-- **Credits while waiting.** When generation kicks off, the agent
-  prints a recognition note for the upstream teams and individuals
-  whose work fills the MDS knowledge base.
-- **Success message surfaced.** After a successful run, the agent
-  quotes the generator's `MDS onboarding complete` tail block back
-  verbatim so the Mr. DJ personal thank-you text appears in chat the same way
-  it does in a terminal CLI run.
-- **MDS Continue handoff.** The agent runs `mds continue` from the
-  generated app folder, then tells the user-dev to open that app folder
-  in a fresh agent session to lower token usage and cost.
-
-## Defaults
-
-- Prefer Uniwind and Tailwind v4 for new projects.
-- Keep route files thin and move business logic into features, services, hooks,
-  and utilities.
-- Always add `project/info.md`, `project/todo.md`, `project/style.md`, and
-  `project/guidelines.md` when project memory is selected.
-- Normalize existing `project/info.md` and `project/style.md` into canonical
-  sections while preserving unknown content under Imported Notes.
-- Add `project/intake-agent.md` when context is thin or imported notes need a
-  follow-up agent conversation.
-- Keep `project/style.md` visual-only; put technical and agent rules in
-  `project/guidelines.md`.
-- Treat monorepo-aware scaffolding as a future step after the single-app MVP is
-  stable.
-
-## VS Code & GitHub Copilot Integration
-
-This guide is authored as canonical knowledge consumed by agent bundles; it is not the agent itself. To enable the generated Copilot/VS Code surface and the custom MDS agent in a workspace, regenerate the VS Code bundle and install the generated prompts/settings into the target repository or your user profile.
-
-- Regenerate VS Code assets (from repository root):
-
-```powershell
-pnpm --filter @mr.dj2u/knowledge build:vscode
-```
-
-- Copy the generated workspace assets into your project (PowerShell):
-
-```powershell
-Copy-Item -Path .\plugins\vscode-copilot\.github\* -Destination . -Recurse -Force
-Copy-Item -Path .\plugins\vscode-copilot\.vscode\* -Destination .\.vscode -Recurse -Force
-```
-
-- Then restart VS Code. Ensure the `GitHub Copilot Chat` extension is installed and enabled. The generated `.vscode/settings.json` enables agent skill locations and prompt file lookup under `.github/prompts`.
-
-- If you prefer user-scope installs, copy the `user/.copilot` content into your user profile per the extension docs, or run `mds agent install --client codex --scope user` (if available) to automate the merge.
-
-## Install Path & What This MD Is For
-
-- 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.
-- 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:
-  - Install the MCP prompts via `mds mcp install --client <client>` (user or project scope), or
-  - 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.
-- If a host keeps using stale prompt or plugin behavior after republish,
-  refresh the local plugin cache, reinstall the MDS MCP server, and run
-  `mds_runtime_versions` from the host surface to confirm which version
-  is actually active.
-
-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.
+- **Credits while waiting.** When generation kicks off, the agent
+  prints a recognition note for the upstream teams and individuals
+  whose work fills the MDS knowledge base.
+- **Success message surfaced.** After a successful run, the agent
+  quotes the generator's `MDS onboarding complete` tail block back
+  verbatim so the Mr. DJ personal thank-you text appears in chat the same way
+  it does in a terminal CLI run.
+- **MDS Continue handoff.** The agent runs `mds continue` from the
+  generated app folder, then tells the user-dev to open that app folder
+  in a fresh agent session to lower token usage and cost.
+
+## Defaults
+
+- Prefer Uniwind and Tailwind v4 for new projects.
+- Keep route files thin and move business logic into features, services, hooks,
+  and utilities.
+- Always add `project/info.md`, `project/todo.md`, `project/style.md`, and
+  `project/guidelines.md` when project memory is selected.
+- Normalize existing `project/info.md` and `project/style.md` into canonical
+  sections while preserving unknown content under Imported Notes.
+- Add a temporary `temp/onboarding/project-memory-review.md` packet when
+  context is thin or imported notes need a follow-up agent conversation.
+- Keep `project/style.md` visual-only; put technical and agent rules in
+  `project/guidelines.md`.
+- Treat monorepo-aware scaffolding as a future step after the single-app MVP is
+  stable.
+
+## VS Code & GitHub Copilot Integration
+
+This guide is authored as canonical knowledge consumed by agent bundles; it is not the agent itself. To enable the generated Copilot/VS Code surface and the custom MDS agent in a workspace, regenerate the VS Code bundle and install the generated prompts/settings into the target repository or your user profile.
+
+- Regenerate VS Code assets (from repository root):
+
+```powershell
+pnpm --filter @mr.dj2u/knowledge build:vscode
+```
+
+- Copy the generated workspace assets into your project (PowerShell):
+
+```powershell
+Copy-Item -Path .\plugins\vscode-copilot\.github\* -Destination . -Recurse -Force
+Copy-Item -Path .\plugins\vscode-copilot\.vscode\* -Destination .\.vscode -Recurse -Force
+```
+
+- Then restart VS Code. Ensure the `GitHub Copilot Chat` extension is installed and enabled. The generated `.vscode/settings.json` enables agent skill locations and prompt file lookup under `.github/prompts`.
+
+- If you prefer user-scope installs, copy the `user/.copilot` content into your user profile per the extension docs, or run `mds agent install --client codex --scope user` (if available) to automate the merge.
+
+## Install Path & What This MD Is For
+
+- 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.
+- 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:
+  - Install the MCP prompts via `mds mcp install --client <client>` (user or project scope), or
+  - 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.
+- If a host keeps using stale prompt or plugin behavior after republish,
+  refresh the local plugin cache, reinstall the MDS MCP server, and run
+  `mds_runtime_versions` from the host surface to confirm which version
+  is actually active.
+
+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.