feat: integrate framework files into monorepo under packages/mosaic/framework/

Moves all Mosaic framework runtime files from the separate bootstrap repo
into the monorepo as canonical source. The @mosaic/mosaic npm package now
ships the complete framework — bin scripts, runtime configs, tools, and
templates — enabling standalone installation via npm install.

Structure:
  packages/mosaic/framework/
  ├── bin/          28 CLI scripts (mosaic, mosaic-doctor, mosaic-sync-skills, etc.)
  ├── runtime/      Runtime adapters (claude, codex, opencode, pi, mcp)
  ├── tools/        Shell tooling (git, prdy, orchestrator, quality, etc.)
  ├── templates/    Agent and repo templates
  ├── defaults/     Default identity files (AGENTS.md, STANDARDS.md, SOUL.md, etc.)
  ├── install.sh    Legacy bash installer
  └── remote-install.sh  One-liner remote installer

Key files with Pi support and recent fixes:
- bin/mosaic: launch_pi() with skills-local loop
- bin/mosaic-doctor: --fix auto-wiring for all 4 harnesses
- bin/mosaic-sync-skills: Pi as 4th link target, symlink-aware find
- bin/mosaic-link-runtime-assets: Pi settings.json patching
- bin/mosaic-migrate-local-skills: Pi skill roots, symlink find
- runtime/pi/RUNTIME.md + mosaic-extension.ts

Package ships 251 framework files in the npm tarball (278KB compressed).

packages/mosaic/framework/templates/docs/DOCUMENTATION-CHECKLIST.md

@@ -0,0 +1,49 @@
+# Documentation Completion Checklist
+
+Use this checklist for every task that changes code, API contracts, auth, or operations.
+
+## Required Artifacts
+
+- [ ] `docs/PRD.md` or `docs/PRD.json` exists and is current
+- [ ] `docs/USER-GUIDE/` updated as needed
+- [ ] `docs/ADMIN-GUIDE/` updated as needed
+- [ ] `docs/DEVELOPER-GUIDE/` updated as needed
+- [ ] `docs/API/OPENAPI.yaml` (or `.json`) updated for API changes
+- [ ] `docs/API/ENDPOINTS.md` updated for API changes
+- [ ] `docs/SITEMAP.md` updated for navigation changes
+
+## API Coverage
+
+- [ ] All public endpoints are documented
+- [ ] All private/internal endpoints are documented
+- [ ] All API input schemas are documented
+- [ ] All API output schemas are documented
+- [ ] All endpoint auth/permission requirements are documented
+- [ ] Error codes and failure behavior are documented
+
+## Structural Standards (Book/Chapter/Page)
+
+- [ ] `docs/USER-GUIDE/README.md` indexes user chapters/pages
+- [ ] `docs/ADMIN-GUIDE/README.md` indexes admin chapters/pages
+- [ ] `docs/DEVELOPER-GUIDE/README.md` indexes developer chapters/pages
+
+## Docs Root Hygiene
+
+- [ ] `docs/` root is clean and only contains canonical root docs (PRD, TASKS when active, SITEMAP, optional README) plus category directories
+- [ ] Reports are under `docs/reports/<category>/` (not `docs/` root)
+- [ ] Deferred findings are under `docs/reports/deferred/`
+- [ ] Orchestrator learnings are under `docs/tasks/orchestrator-learnings.json`
+- [ ] Release notes are under `docs/releases/`
+- [ ] Archived task snapshots are under `docs/tasks/`
+- [ ] Scratchpads are under `docs/scratchpads/`
+
+## Review Gate
+
+- [ ] Documentation changes are in the same logical change set as code/API changes
+- [ ] Code review verified documentation completeness
+- [ ] Missing docs were treated as blocker findings
+
+## Publishing
+
+- [ ] Publishing target was confirmed with user if unspecified
+- [ ] Canonical source remains in-repo unless user explicitly declares otherwise

packages/mosaic/framework/templates/docs/MISSION-MANIFEST.md.template

@@ -0,0 +1,53 @@
+# Mission Manifest — ${MISSION_NAME}
+
+> Persistent document tracking full mission scope, status, and session history.
+> Updated by the orchestrator at each phase transition and milestone completion.
+
+## Mission
+
+**ID:** ${MISSION_ID}
+**Statement:** ${MISSION_STATEMENT}
+**Phase:** Intake
+**Current Milestone:** —
+**Progress:** 0 / ${MILESTONE_COUNT} milestones
+**Status:** not-started
+**Last Updated:** ${CREATED_AT}
+
+## Success Criteria
+
+${SUCCESS_CRITERIA}
+
+## Milestones
+
+| # | ID | Name | Status | Branch | Issue | Started | Completed |
+|---|-----|------|--------|--------|-------|---------|-----------|
+${MILESTONES_TABLE}
+
+## Deployment
+
+| Target | URL | Method |
+|--------|-----|--------|
+${DEPLOYMENT_TABLE}
+
+## Coordination
+
+- **Primary Agent:** ${PRIMARY_RUNTIME}
+- **Sibling Agents:** ${SIBLING_AGENTS}
+- **Shared Contracts:** ${SHARED_CONTRACTS}
+
+## Token Budget
+
+| Metric | Value |
+|--------|-------|
+| Budget | ${TOKEN_BUDGET} |
+| Used | 0 |
+| Mode | normal |
+
+## Session History
+
+| Session | Runtime | Started | Duration | Ended Reason | Last Task |
+|---------|---------|---------|----------|--------------|-----------|
+
+## Scratchpad
+
+Path: `docs/scratchpads/${MISSION_ID}.md`

packages/mosaic/framework/templates/docs/PRD.md.template

@@ -0,0 +1,75 @@
+# PRD: {PROJECT_OR_FEATURE_NAME}
+
+## Metadata
+
+- Owner: {owner}
+- Date: {yyyy-mm-dd}
+- Status: draft|approved|in-progress|completed
+- Best-Guess Mode: true|false
+
+## Problem Statement
+
+{what problem is being solved and why now}
+
+## Objectives
+
+1. {objective-1}
+2. {objective-2}
+
+## Scope
+
+### In Scope
+
+1. {in-scope-item}
+
+### Out of Scope
+
+1. {out-of-scope-item}
+
+## User/Stakeholder Requirements
+
+1. {requirement}
+
+## Functional Requirements
+
+1. {functional-requirement}
+
+## Non-Functional Requirements
+
+1. Security: {requirements}
+2. Performance: {requirements}
+3. Reliability: {requirements}
+4. Observability: {requirements}
+
+## Acceptance Criteria
+
+1. {ac-1}
+2. {ac-2}
+
+## Constraints and Dependencies
+
+1. {constraint-or-dependency}
+
+## Risks and Open Questions
+
+1. Risk: {risk}
+2. Open Question: {question}
+
+## Testing and Verification Expectations
+
+1. Baseline checks: {lint/type/unit/integration expectations}
+2. Situational testing: {required situational checks}
+3. Evidence format: {how verification will be reported}
+
+## Milestone / Delivery Intent
+
+1. Target milestone/version: {e.g., 0.0.2}
+2. Definition of done: {completion conditions}
+
+## Assumptions
+
+List only if Best-Guess Mode is true.
+Prefix each entry with `ASSUMPTION:`.
+
+1. ASSUMPTION: {guessed decision and rationale}
+

packages/mosaic/framework/templates/docs/TASKS.md.template

@@ -0,0 +1,17 @@
+# TASKS
+
+Canonical tracking for active work. Keep this file current.
+
+## Rules
+
+1. Update status as work progresses.
+2. Link every non-trivial task to a provider issue (`#123`) or internal ref (`TASKS:T1`) if no provider is available.
+3. Keep one row per active task.
+4. Do not set `status=done` for source-code work until PR is merged, CI/pipeline is terminal green, and linked issue/ref is closed.
+5. If merge/CI/issue closure fails, set `status=blocked` and record the exact failed wrapper command in `notes`.
+
+## Tasks
+
+| id | status | description | issue | repo | branch | depends_on | blocks | agent | started_at | completed_at | estimate | used | notes |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| T1 | not-started | Example task description | TASKS:T1 | app | feat/example | | | | | | | | |

packages/mosaic/framework/templates/docs/continuation-prompt.md.template

@@ -0,0 +1,36 @@
+## Continuation Mission
+
+Continue **${MISSION_NAME}** from existing state.
+
+## Setup
+
+- **Project:** ${PROJECT_PATH}
+- **State:** docs/TASKS.md (already populated — ${TASKS_DONE}/${TASKS_TOTAL} tasks complete)
+- **Manifest:** docs/MISSION-MANIFEST.md
+- **Scratchpad:** docs/scratchpads/${MISSION_ID}.md
+- **Protocol:** ~/.config/mosaic/guides/ORCHESTRATOR.md
+- **Quality gates:** ${QUALITY_GATES}
+
+## Resume Point
+
+- **Current milestone:** ${CURRENT_MILESTONE_NAME} (${CURRENT_MILESTONE_ID})
+- **Next task:** ${NEXT_TASK_ID}
+- **Progress:** ${TASKS_DONE}/${TASKS_TOTAL} tasks (${PROGRESS_PCT}%)
+- **Branch:** ${CURRENT_BRANCH}
+
+## Previous Session Context
+
+- **Session:** ${PREV_SESSION_ID} (${PREV_RUNTIME}, ${PREV_DURATION})
+- **Ended:** ${PREV_ENDED_REASON}
+- **Last completed task:** ${PREV_LAST_TASK}
+
+## Instructions
+
+1. Read `~/.config/mosaic/guides/ORCHESTRATOR.md` for full protocol
+2. Read `docs/MISSION-MANIFEST.md` for mission scope and status
+3. Read `docs/scratchpads/${MISSION_ID}.md` for session history and decisions
+4. Read `docs/TASKS.md` for current task state
+5. `git pull --rebase` to sync latest changes
+6. Continue execution from task **${NEXT_TASK_ID}**
+7. Follow Two-Phase Completion Protocol
+8. You are the SOLE writer of `docs/TASKS.md`

packages/mosaic/framework/templates/docs/mission-scratchpad.md.template

@@ -0,0 +1,27 @@
+# Mission Scratchpad — ${MISSION_NAME}
+
+> Append-only log. NEVER delete entries. NEVER overwrite sections.
+> This is the orchestrator's working memory across sessions.
+
+## Original Mission Prompt
+
+```
+${MISSION_PROMPT}
+```
+
+## Planning Decisions
+
+<!-- Record key decisions made during planning. Format: decision + rationale. -->
+
+## Session Log
+
+| Session | Date | Milestone | Tasks Done | Outcome |
+|---------|------|-----------|------------|---------|
+
+## Open Questions
+
+<!-- Unresolved items that need human input or cross-session investigation. -->
+
+## Corrections
+
+<!-- Record any corrections to earlier decisions or assumptions. -->