@mr.dj2u/knowledge 0.1.7 → 0.1.9

package/dist/content/prompts/continue-development.md

@@ -1,35 +1,41 @@
-# /continue-development
-
-Resume work on an onboarded project by following MDS phase order from `project/todo.md`.
-
-## Arguments
-
-- `projectPath`: onboarded app path (default: current directory).
-
-## MCP-First Workflow
-
-1. Confirm the `mr-djs-dev-suite` MCP server is available.
-2. Call `continue_project` first to get the active-phase brief.
-3. Pull `get_skill` for `continue-development` to enforce phase-first sequencing.
-4. If blockers appear, use `doctor_scan_project` and `doctor_explain_result` for targeted remediation before feature work.
-
-## MDS Routing Guardrails
-
-- Treat a request to continue development with MDS as a request for the MDS MCP tool and phase rules first.
-- Do not jump directly into app edits until `continue_project` or the CLI fallback has identified the active phase and blockers.
-- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
-
-## CLI / Manual Fallback
-
-1. If MCP is not configured, install it manually:
-   - `mds mcp install --client <client> --scope project`
-2. Direct CLI flow:
-   - `mds continue <projectPath>`
-   - `mds doctor <projectPath>` when blockers are unclear.
-3. If `mds` is not on PATH, invoke the published CLI by binary name:
-   - `npx -y -p @mr.dj2u/cli@latest mds continue <projectPath>`
-
-## Verification And Output
-
-- Confirm the chosen task belongs to the active phase or has an explicit deferral note.
-- Output: selected next task, blockers, and validation commands to run after implementation.
+# /continue-development
+
+Resume work on an onboarded project by using the phase roadmap and explicit
+dependencies in `project/todo.md`.
+
+## Arguments
+
+- `projectPath`: onboarded app path (default: current directory).
+
+## MCP-First Workflow
+
+1. Confirm the `mr-djs-dev-suite` MCP server is available.
+2. Call `continue_project` first to get the active-phase brief.
+3. Pull `get_skill` for `continue-development` to select a dependency-ready
+   task without treating phases as a global gate.
+4. If `continue_project` returns `recommendation.priority: expo-sdk-upgrade`, load the official Expo skill `upgrading-expo`. Do not call MDS `get_skill` for an upgrade skill. Do not implement the next todo or run `generate_project_roadmap` for feature work until the user declines or the upgrade is done.
+5. If blockers appear, use `doctor_scan_project` and `doctor_explain_result` for targeted remediation before feature work.
+
+## MDS Routing Guardrails
+
+- Treat a request to continue development with MDS as a request for the MDS MCP tool and phase rules first.
+- Do not jump directly into app edits until `continue_project` or the CLI
+  fallback has identified the relevant phase, explicit dependencies, and
+  blockers.
+- When continue reports Expo SDK attention from project state, follow official `upgrading-expo` instead of the next unchecked todo.
+- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
+
+## CLI / Manual Fallback
+
+1. If MCP is not configured, install it manually:
+   - `mds mcp install --client <client> --scope project`
+2. Direct CLI flow:
+   - `mds continue <projectPath>`
+   - `mds doctor <projectPath>` when blockers are unclear.
+3. If `mds` is not on PATH, invoke the published CLI by binary name:
+   - `npx -y -p @mr.dj2u/cli@latest mds continue <projectPath>`
+
+## Verification And Output
+
+- Confirm the chosen task belongs to the active phase or has an explicit deferral note.
+- Output: selected next task, blockers, and validation commands to run after implementation.

package/dist/content/prompts/create-expo-super-stack.md

@@ -54,6 +54,9 @@ Do not describe the normal published install path as a fallback, and do not ment
 ## Verification And Output
 
 - Confirm generated app has `project/info.md`, `project/todo.md`, `project/style.md`, and `project/guidelines.md`.
-- Confirm `project/todo.md` includes the auto-derived roadmap generated from normalized `project/info.md`.
+- Confirm a new project's `project/todo.md` includes its Phase 0+ roadmap
+  and `## Bug Fixes & Regressions` queue; preserve existing TODO items and
+  use `mds roadmap --append --phase N` only for approved additions to that
+  phase.
 - 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.
 - Output: generated app path, onboarding status, and the handoff to open a fresh agent session inside the new app folder and run `mds continue`.

package/dist/content/prompts/fix-seo.md

@@ -1,29 +1,29 @@
-# /fix-seo
-
-Apply SEO metadata fixes for Expo web routes with MCP guidance and post-fix verification.
-
-## Arguments
-
-- `projectPath`: Expo project path (default: current directory).
-- `routeOrFile`: optional route/file focus for targeted checks.
-
-## MCP-First Workflow
-
-1. Confirm the `mr-djs-dev-suite` MCP server is available.
-2. Pull `get_skill` for `seo-metadata`.
-3. Optionally run `doctor_scan_file` for focused route files, then `doctor_scan_project` for full checks.
-4. Use `knowledge_list_resources` (`kind: "rule"`) to ensure canonical/indexing strategy is complete.
-5. Implement metadata, canonical, robots, and sitemap corrections in route ownership boundaries.
-
-## CLI / Manual Fallback
-
-1. If MCP is not configured, install it manually:
-   - `mds mcp install --client <client> --scope project`
-2. Direct CLI checks:
-   - `mds doctor <projectPath> --ci`
-   - Run project-specific web build/preview commands to verify metadata output.
-
-## Verification And Output
-
-- Confirm canonical tags, social metadata, and sitemap/robots behavior on affected routes.
-- Output: changed files, resolved SEO gaps, and any remaining manual verification steps.
+# /fix-seo
+
+Apply SEO metadata fixes for Expo web routes with MCP guidance and post-fix verification.
+
+## Arguments
+
+- `projectPath`: Expo project path (default: current directory).
+- `routeOrFile`: optional route/file focus for targeted checks.
+
+## MCP-First Workflow
+
+1. Confirm the `mr-djs-dev-suite` MCP server is available.
+2. Pull `get_skill` for `seo-metadata`.
+3. Optionally run `doctor_scan_file` for focused route files, then `doctor_scan_project` for full checks.
+4. Use `knowledge_list_resources` (`kind: "rule"`) to ensure canonical/indexing strategy is complete.
+5. Implement metadata, canonical, robots, and sitemap corrections in route ownership boundaries.
+
+## CLI / Manual Fallback
+
+1. If MCP is not configured, install it manually:
+   - `mds mcp install --client <client> --scope project`
+2. Direct CLI checks:
+   - `mds doctor <projectPath> --ci`
+   - Run project-specific web build/preview commands to verify metadata output.
+
+## Verification And Output
+
+- Confirm canonical tags, social metadata, and sitemap/robots behavior on affected routes.
+- Output: changed files, resolved SEO gaps, and any remaining manual verification steps.

package/dist/content/prompts/onboard-new-expo-app.md

@@ -1,11 +1,11 @@
-# /onboard-new-expo-app
-
-Run onboarding intake for an existing Expo app folder.
-
-## Arguments
-
-- `projectPath`: existing Expo app path (default: current directory).
-
-## MCP Prompt Notes
-
-This canonical spec backs the `onboard_new_expo_app` MCP prompt metadata. The runtime onboarding prompt text is generated from the server-side onboarding template so it can include current context and path-dependent instructions.
+# /onboard-new-expo-app
+
+Run onboarding intake for an existing Expo app folder.
+
+## Arguments
+
+- `projectPath`: existing Expo app path (default: current directory).
+
+## MCP Prompt Notes
+
+This canonical spec backs the `onboard_new_expo_app` MCP prompt metadata. The runtime onboarding prompt text is generated from the server-side onboarding template so it can include current context and path-dependent instructions.

package/dist/content/prompts/prepare-deploy.md

@@ -1,29 +1,29 @@
-# /prepare-deploy
-
-Prepare an Expo project for release using deployment-focused skills plus Doctor parity checks.
-
-## Arguments
-
-- `projectPath`: release candidate project path (default: current directory).
-- `includeSeo`: whether to include web metadata/indexing checks (default: `true` when web is targeted).
-
-## MCP-First Workflow
-
-1. Confirm the `mr-djs-dev-suite` MCP server is available.
-2. Run `doctor_scan_project` in `ci` mode for release parity.
-3. Pull `get_skill` for `deployment`; if web is involved also pull `seo-metadata`.
-4. Use `knowledge_list_resources` (`kind: "rule"`) to confirm env hygiene, SSR safety, and metadata requirements.
-5. Produce a release checklist mapped to current failing checks.
-
-## CLI / Manual Fallback
-
-1. If MCP is not configured, install it manually:
-   - `mds mcp install --client <client> --scope project`
-2. Direct CLI path:
-   - `mds doctor <projectPath> --ci`
-   - Run project scripts: `lint`, `type-check`, `test`, and production build/profile scripts.
-
-## Verification And Output
-
-- Re-run `doctor_scan_project` (or CLI equivalent) until blockers are cleared.
-- Output: release readiness status, unresolved blockers, and rollback/readiness notes.
+# /prepare-deploy
+
+Prepare an Expo project for release using deployment-focused skills plus Doctor parity checks.
+
+## Arguments
+
+- `projectPath`: release candidate project path (default: current directory).
+- `includeSeo`: whether to include web metadata/indexing checks (default: `true` when web is targeted).
+
+## MCP-First Workflow
+
+1. Confirm the `mr-djs-dev-suite` MCP server is available.
+2. Run `doctor_scan_project` in `ci` mode for release parity.
+3. Pull `get_skill` for `deployment`; if web is involved also pull `seo-metadata`.
+4. Use `knowledge_list_resources` (`kind: "rule"`) to confirm env hygiene, SSR safety, and metadata requirements.
+5. Produce a release checklist mapped to current failing checks.
+
+## CLI / Manual Fallback
+
+1. If MCP is not configured, install it manually:
+   - `mds mcp install --client <client> --scope project`
+2. Direct CLI path:
+   - `mds doctor <projectPath> --ci`
+   - Run project scripts: `lint`, `type-check`, `test`, and production build/profile scripts.
+
+## Verification And Output
+
+- Re-run `doctor_scan_project` (or CLI equivalent) until blockers are cleared.
+- Output: release readiness status, unresolved blockers, and rollback/readiness notes.

package/dist/content/prompts/project-research-plan.md

@@ -1,29 +1,29 @@
-# /project-research-plan
-
-Turn rough product notes/research into actionable MDS project memory and next-phase plan.
-
-## Arguments
-
-- `projectPath`: target project path (default: current directory).
-- `inputs`: attached notes/docs to normalize into canonical memory files.
-
-## MCP-First Workflow
-
-1. Confirm the `mr-djs-dev-suite` MCP server is available.
-2. Pull `get_skill` for `research-plan-intake` (and `project-onboarding` when onboarding context is mixed in).
-3. Call `knowledge_list_resources` for `guide` and `reference` resources as needed for structure and validation.
-4. Normalize clear context directly; ask focused follow-up only where ambiguity changes implementation direction.
-5. Update project memory files and produce an implementation-ready next-phase plan.
-
-## CLI / Manual Fallback
-
-1. If MCP is not configured, install it manually:
-   - `mds mcp install --client <client> --scope project`
-2. Direct CLI fallback:
-   - Use `mds onboard <projectPath>` for structured intake when memory files are missing.
-   - Use `mds continue <projectPath>` after memory normalization to select the next task.
-
-## Verification And Output
-
-- Confirm `project/info.md`, `project/style.md`, and `project/todo.md` align with extracted research context.
-- Output: resolved unknowns, outstanding questions, and the recommended next implementation slice.
+# /project-research-plan
+
+Turn rough product notes/research into actionable MDS project memory and next-phase plan.
+
+## Arguments
+
+- `projectPath`: target project path (default: current directory).
+- `inputs`: attached notes/docs to normalize into canonical memory files.
+
+## MCP-First Workflow
+
+1. Confirm the `mr-djs-dev-suite` MCP server is available.
+2. Pull `get_skill` for `research-plan-intake` (and `project-onboarding` when onboarding context is mixed in).
+3. Call `knowledge_list_resources` for `guide` and `reference` resources as needed for structure and validation.
+4. Normalize clear context directly; ask focused follow-up only where ambiguity changes implementation direction.
+5. Update project memory files and produce an implementation-ready next-phase plan.
+
+## CLI / Manual Fallback
+
+1. If MCP is not configured, install it manually:
+   - `mds mcp install --client <client> --scope project`
+2. Direct CLI fallback:
+   - Use `mds onboard <projectPath>` for structured intake when memory files are missing.
+   - Use `mds continue <projectPath>` after memory normalization to select the next task.
+
+## Verification And Output
+
+- Confirm `project/info.md`, `project/style.md`, and `project/todo.md` align with extracted research context.
+- Output: resolved unknowns, outstanding questions, and the recommended next implementation slice.

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

@@ -1,25 +1,25 @@
-# /push-merge-loop
-
-Execute the short PR iteration loop for the test branch with strict quality gates.
-
-## Goal
-
-Push intentional changes with a meaningful commit message, open/update a PR to `test`, poll for feedback and failed checks, fix issues, and merge to `test` once all checks are green.
-
-## Loop Rules
-
-1. Run `mds doctor --ci` before any git mutation.
-2. Stage only intentional files and create a meaningful commit message.
-3. Push branch and open or update a PR targeting `test`.
-4. Wait about 2 minutes, then poll PR comments, review threads, and failed checks.
-5. Fix issues locally, rerun Doctor, push updates, and poll again.
-6. Repeat polling/fix cycles up to 5 total iterations.
-7. Merge to `test` only when all required checks are green and no unresolved blocking feedback remains.
-
-## Guardrails
-
-- Do not merge when required checks are failing.
-- Do not skip Doctor between fix cycles.
-- Keep a concise changelog per iteration: what failed, what was changed, what passed.
-- If still failing after 5 cycles, stop and summarize remaining blockers with concrete next actions.
-
+# /push-merge-loop
+
+Execute the short PR iteration loop for the test branch with strict quality gates.
+
+## Goal
+
+Push intentional changes with a meaningful commit message, open/update a PR to `test`, poll for feedback and failed checks, fix issues, and merge to `test` once all checks are green.
+
+## Loop Rules
+
+1. Run `mds doctor --ci` before any git mutation.
+2. Stage only intentional files and create a meaningful commit message.
+3. Push branch and open or update a PR targeting `test`.
+4. Wait about 2 minutes, then poll PR comments, review threads, and failed checks.
+5. Fix issues locally, rerun Doctor, push updates, and poll again.
+6. Repeat polling/fix cycles up to 5 total iterations.
+7. Merge to `test` only when all required checks are green and no unresolved blocking feedback remains.
+
+## Guardrails
+
+- Do not merge when required checks are failing.
+- Do not skip Doctor between fix cycles.
+- Keep a concise changelog per iteration: what failed, what was changed, what passed.
+- If still failing after 5 cycles, stop and summarize remaining blockers with concrete next actions.
+

package/dist/content/prompts/retrospective-project-onboarding.md

@@ -0,0 +1,23 @@
+# /retrospective-project-onboarding
+
+Finish onboarding an existing migrated project after `mds workspace init` generated draft project memory.
+
+## Arguments
+
+- `projectPath`: initialized app checkout path, usually `<app>-i2Workspace/<app>-main`.
+
+## Workflow
+
+1. Read `temp/onboarding/retrospective-review.md` plus `project/info.md`, `project/style.md`, `project/guidelines.md`, and `project/todo.md` from the workspace control repository.
+2. Verify generated claims against the app checkout before treating them as project truth.
+3. Find every unresolved `# TodoForContext(optional):` marker and ask the UD focused questions, one at a time.
+4. Write confirmed answers into the relevant project memory section and remove the marker line.
+5. Do not invent mission, target audience, product goals, monetization, release intent, or component strategy from code alone.
+6. After all markers are gone, run `mds roadmap`, then `mds continue`, and propose the next implementation slice.
+
+## Guardrails
+
+- Project memory is authoritative only after UD confirmation.
+- The review packet is temporary local evidence; keep durable, confirmed information only in canonical `project/` memory.
+- Keep this workflow project-only unless the UD explicitly asks for app-source changes.
+- Do not run full `mds onboard` scaffolding from this workflow.

package/dist/content/prompts/review-expo-project.md

@@ -1,29 +1,29 @@
-# /review-expo-project
-
-Review an Expo project with MCP-first diagnostics and skill-guided remediation.
-
-## Arguments
-
-- `projectPath`: absolute or relative project path (default: current directory).
-- `mode`: Doctor mode (`fast`, `ci`, or `full`; default: `ci`).
-
-## MCP-First Workflow
-
-1. Confirm the `mr-djs-dev-suite` MCP server is available.
-2. Call `continue_project` to summarize current project state and blockers.
-3. Call `doctor_scan_project` with `projectPath` and `mode`.
-4. For each warning/error, call `doctor_explain_result`, then pull targeted guidance with `get_skill` (for example: `project-onboarding`, `debugging`, `deployment`).
-5. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
-
-## CLI / Manual Fallback
-
-1. If MCP is not configured, install it manually:
-   - `mds mcp install --client <client> --scope project`
-2. If MCP still cannot run, use direct CLI flows:
-   - `mds continue <projectPath>`
-   - `mds doctor <projectPath> --ci`
-
-## Verification And Output
-
-- Re-run `doctor_scan_project` (or `mds doctor --ci`) after fixes.
-- Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands.
+# /review-expo-project
+
+Review an Expo project with MCP-first diagnostics and skill-guided remediation.
+
+## Arguments
+
+- `projectPath`: absolute or relative project path (default: current directory).
+- `mode`: Doctor mode (`fast`, `ci`, or `full`; default: `ci`).
+
+## MCP-First Workflow
+
+1. Confirm the `mr-djs-dev-suite` MCP server is available.
+2. Call `continue_project` to summarize current project state and blockers.
+3. Call `doctor_scan_project` with `projectPath` and `mode`.
+4. For each warning/error, call `doctor_explain_result`, then pull targeted guidance with `get_skill` (for example: `project-onboarding`, `debugging`, `deployment`).
+5. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
+
+## CLI / Manual Fallback
+
+1. If MCP is not configured, install it manually:
+   - `mds mcp install --client <client> --scope project`
+2. If MCP still cannot run, use direct CLI flows:
+   - `mds continue <projectPath>`
+   - `mds doctor <projectPath> --ci`
+
+## Verification And Output
+
+- Re-run `doctor_scan_project` (or `mds doctor --ci`) after fixes.
+- Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands.

package/dist/content/prompts/run-doctor.md

@@ -1,38 +1,38 @@
-# /run-doctor
-
-Run MDS Doctor as the primary health check for an Expo project.
-
-## Arguments
-
-- `projectPath`: project root path (default: current directory).
-- `mode`: `fast`, `ci`, or `full` (default: `ci`).
-- `runScripts`: whether Doctor should execute project scripts (default: `true` for `ci` mode).
-
-## MCP-First Workflow
-
-1. Confirm the `mr-djs-dev-suite` MCP server is available.
-2. Call `doctor_scan_project` with selected arguments.
-3. For each non-pass result, call `doctor_explain_result`.
-4. Pull targeted implementation guidance with `get_skill` (typically `deployment`, `debugging`, or `dev-server-management`).
-
-## MDS Routing Guardrails
-
-- Treat a request to run MDS Doctor as a request for the MDS MCP tool, not as a request to run app-local npm scripts.
-- Do not run `npm run mds:doctor`, `npm run doctor`, or other project package scripts as the MDS Doctor path unless the user explicitly asks for app scripts.
-- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
-
-## CLI / Manual Fallback
-
-1. If MCP is not configured, install it manually:
-   - `mds mcp install --client <client> --scope project`
-2. Direct CLI alternatives:
-   - `mds doctor <projectPath>`
-   - `mds doctor <projectPath> --ci`
-   - `mds doctor <projectPath> --json`
-3. If `mds` is not on PATH, invoke the published CLI by binary name:
-   - `npx -y -p @mr.dj2u/cli@latest mds doctor <projectPath> --ci`
-
-## Verification And Output
-
-- Re-run Doctor after each fix batch.
-- Output: check summary, blocking errors first, and the exact command used for re-check.
+# /run-doctor
+
+Run MDS Doctor as the primary health check for an Expo project.
+
+## Arguments
+
+- `projectPath`: project root path (default: current directory).
+- `mode`: `fast`, `ci`, or `full` (default: `ci`).
+- `runScripts`: whether Doctor should execute project scripts (default: `true` for `ci` mode).
+
+## MCP-First Workflow
+
+1. Confirm the `mr-djs-dev-suite` MCP server is available.
+2. Call `doctor_scan_project` with selected arguments.
+3. For each non-pass result, call `doctor_explain_result`.
+4. Pull targeted implementation guidance with `get_skill` (typically `deployment`, `debugging`, or `dev-server-management`).
+
+## MDS Routing Guardrails
+
+- Treat a request to run MDS Doctor as a request for the MDS MCP tool, not as a request to run app-local npm scripts.
+- Do not run `npm run mds:doctor`, `npm run doctor`, or other project package scripts as the MDS Doctor path unless the user explicitly asks for app scripts.
+- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
+
+## CLI / Manual Fallback
+
+1. If MCP is not configured, install it manually:
+   - `mds mcp install --client <client> --scope project`
+2. Direct CLI alternatives:
+   - `mds doctor <projectPath>`
+   - `mds doctor <projectPath> --ci`
+   - `mds doctor <projectPath> --json`
+3. If `mds` is not on PATH, invoke the published CLI by binary name:
+   - `npx -y -p @mr.dj2u/cli@latest mds doctor <projectPath> --ci`
+
+## Verification And Output
+
+- Re-run Doctor after each fix batch.
+- Output: check summary, blocking errors first, and the exact command used for re-check.