@moretea-labs/forge 1.5.0-rc.1

package/assets/partials-agents/04-task-protocol.partial.md

@@ -0,0 +1,69 @@
+## Task Management Protocol
+
+```yaml
+TASK_SOURCES:
+  - docs/spec.md
+  - docs/researches/
+  - tasks/todos.md
+  - tasks/contracts/
+  - tasks/reviews/
+  - tasks/notes/
+  - tasks/lessons.md
+  - .ai/harness/checks/latest.json
+  - .ai/harness/handoff/current.md
+  - plans/
+
+PHASES: research -> spec -> plan -> contract -> implement -> verify -> check -> review -> handoff
+
+ARCHIVE:
+  PLAN: plans/archive/
+  TODO: tasks/archive/
+
+RULES:
+  - Treat repo-local artifact files as the primary cross-agent workflow contract
+  - For non-chat tasks, sync tasks/ whenever substantive work changes the repo
+  - Research first for unfamiliar areas and persist findings in docs/researches/
+  - Keep stable product intent in docs/spec.md
+  - Plan with trade-offs in plans/plan-{timestamp}-{slug}.md
+  - Treat .ai/harness/active-plan as authoritative only for this worktree; .ai/harness/active-worktree records the owner; .claude/.active-plan is a legacy fallback during transition
+  - Keep multiple active plans in parallel worktrees when tasks diverge; fill workflow inventory before implementation: active plan, owning worktree, contract, review, notes, deferred ledger, checks, runs, scope owner, switching rule, and worktree path
+  - Process annotation notes before implementing
+  - Project approved plans with .ai/harness/scripts/plan-to-todo.sh; the execution checklist stays in the plan ## Task Breakdown
+  - Define task contracts in tasks/contracts/{plan-stem}.contract.md
+  - Fill tasks/reviews/{plan-stem}.review.md from Waza /check after verification
+  - Record only non-obvious implementation decisions, deviations, tradeoffs, and open questions in tasks/notes/{plan-stem}.notes.md
+  - Verify contracts before claiming completion
+  - Require review pass before claiming completion
+  - Keep tasks/todos.md limited to deferred medium/long-term goals, with tradeoff and revisit trigger; do not duplicate plan Task Breakdown
+  - Record correction-derived prevention rules in tasks/lessons.md
+  - Distill repeated corrections into tasks/lessons.md instead of keeping them in tasks/todos.md
+  - Capture deep findings and hidden contracts in docs/researches/
+  - Keep sprint-level verification notes, behavior diffs, and residual risks in tasks/reviews/{plan-stem}.review.md
+  - Do not use implementation notes as durable memory or task logs; archive them on close and promote only after evidence shows the rule should outlive the sprint
+  - Promote implementation-ready follow-up work into a new plans/plan-{timestamp}-{slug}.md file; keep deferred goals in tasks/todos.md only when intentionally postponed
+  - Treat `.ai/hooks/` as the shared automation entrypoint when repo scripts reference hook-backed workflow checks
+  - Treat user-level `~/.claude/settings.json` and `~/.codex/hooks.json` as host adapters; do not add repo-local project hook adapters unless explicitly migrating legacy config
+  - For Codex sessions, treat `bash .ai/harness/scripts/check-task-sync.sh` and `bash .ai/harness/scripts/check-task-workflow.sh --strict` as required repo-local checks
+  - Before ending a session, refresh `.ai/harness/handoff/current.md` when the task state changed
+  - Update `tasks/workstreams/` only when durable capability progress changes
+  - Archive completed/abandoned plans and todos with metadata
+{{#IF FACTOR_FACTORY_ENABLED}}
+  - Treat `tasks/factors/registry.json` as the source of truth for factor lifecycle state
+  - Create factor candidates with `bash .ai/harness/scripts/factor-lab-new.sh --name <slug>`
+  - Promote factors only after hypothesis and backtest summary artifacts exist
+  - Run `bash .ai/harness/scripts/factor-lab-check.sh` before claiming factor-lab work is complete
+{{/IF}}
+
+ACTIVE_PLAN:
+  - .ai/harness/active-plan selects the current active plan only for its owning worktree; .ai/harness/active-worktree records that owner; .claude/.active-plan is a legacy fallback during transition
+
+STATUS:
+  ENUM: [Draft, Annotating, Approved, Executing, Archived]
+  LOCATION: "> **Status**: {value}" line in plan file (must be exact, no trailing whitespace)
+  TRANSITIONS:
+    - Draft -> Annotating -> Approved -> Executing -> Archived
+    - Annotating -> Draft (rollback when plan direction needs rethinking)
+  GUARD: do not implement when status is Draft or Annotating
+```
+
+---

package/assets/partials-agents/05-coding-constraints.partial.md

@@ -0,0 +1,20 @@
+## Coding Constraints
+
+### First Principles
+- Prefer data modeling over branch-heavy conditionals.
+- Favor derivation over duplicated state.
+
+### Single Source of Truth
+- `docs/spec.md`, `tasks/contracts/`, `tasks/reviews/`, `tasks/notes/`, and `tests/` are authoritative.
+- `src/` is mutable implementation.
+- Rewrite over patch when contracts diverge.
+
+### Quality Rules
+- Keep functions intention-revealing and test-backed.
+- Keep compatibility debt explicit through deprecation + replacement mapping.
+
+See details in:
+- `docs/reference-configs/sprint-contracts.md`
+- `docs/reference-configs/evaluator-rubric.md`
+
+---

package/assets/partials-agents/06-quality-safety.partial.md

@@ -0,0 +1,23 @@
+## Quality & Safety
+
+### Verification Gate
+- Never mark work done without verification output.
+- Run impact-based checks: typecheck, tests, lint/build.
+- Run `bash .ai/harness/scripts/check-task-workflow.sh --strict` before claiming the workflow is clean.
+- Run `bash .ai/harness/scripts/verify-contract.sh --contract <active-plan-contract> --strict` before any done/completed response when the active plan has a contract.
+- Require the matching `tasks/reviews/<plan-stem>.review.md` to recommend pass before claiming completion.
+- Require the matching `tasks/notes/<plan-stem>.notes.md` to capture material implementation decisions before review.
+
+### Safety Rules
+- Do not silently expand scope beyond approved plan.
+- If unexpected repo changes appear, stop and ask.
+- Prefer modifying existing files over unnecessary file creation.
+
+### Final Response Contract
+1. What changed — list modified files with one-line summary each
+2. Verification evidence — paste tool output: test results, build logs, or `git diff --stat`
+3. Which workflow artifacts were updated — list `tasks/*.md`, `docs/spec.md`, or `.ai/harness/*` files and what changed in each
+4. Known risks/gaps — bullet list with severity tag: `[HIGH]`, `[MEDIUM]`, `[LOW]`
+5. Optional next steps — actionable items the next session or user should address
+
+---

package/assets/partials-agents/07-cloudflare.partial.md

@@ -0,0 +1,9 @@
+## Cloudflare Deployment Notes
+
+Use Cloudflare-native patterns for cloudflare-enabled plans:
+- Workers for TanStack Start/Vite SSR webapps, API, webhook, and edge logic; deploy Start with `wrangler deploy`, not `wrangler pages deploy`
+- Pages only for static/client-only assets or content shells that do not need Worker SSR
+- One `apps/web` Worker for public landing plus `/app` workspace; split API/Agent/MCP Workers only when they own separate authority
+- Keep edge vs node constraints explicit and prefer platform primitives over custom infra
+
+---

package/assets/partials-agents/08-deep-docs.partial.md

@@ -0,0 +1,32 @@
+## Deep Docs Index
+
+### Always Read First
+- `docs/spec.md`: stable product truth
+- `tasks/todos.md`: deferred-goal ledger only
+- `.ai/harness/handoff/current.md`: resumable session state
+- `.ai/harness/policy.json`: machine-readable workflow contract
+
+### Load On Demand
+- `docs/researches/`: deep codebase analysis and hidden contracts
+- `plans/plan-*.md`: timestamped plan catalog; use `.ai/harness/active-plan` only for its owning worktree, with `.ai/harness/active-worktree` recording that owner and `.claude/.active-plan` as a legacy fallback
+- `tasks/contracts/`: active sprint done definitions
+- `tasks/reviews/`: evaluator verdicts
+- `tasks/notes/`: task-local implementation decisions and tradeoffs
+- `.ai/harness/checks/latest.json`: structured verification evidence
+- `.ai/harness/runs/`: immutable run snapshots for verification audit
+- `.ai/context/context-map.json`: progressive context index for primary functional-block `CLAUDE.md` and `AGENTS.md` files
+- `plans/archive/`: archived plans and outcomes
+- `tasks/archive/`: archived todo snapshots
+- `docs/reference-configs/agentic-development-flow.md`: gstack/Waza routing, P1/P2/P3 reporting triggers, and daily flow
+- `docs/reference-configs/harness-overview.md`: orchestration playbook
+- `docs/reference-configs/external-tooling.md`: gstack/Waza/gbrain routing, Codex-first Waza sync, and required CodeGraph readiness commands
+- `docs/reference-configs/document-generation.md`: minimal docs profile and on-demand document rules
+- `docs/reference-configs/global-working-rules.md`: user-level Claude/Codex rule template
+- `docs/reference-configs/sprint-contracts.md`: contract rules
+- `docs/reference-configs/evaluator-rubric.md`: review thresholds
+- `docs/reference-configs/handoff-protocol.md`: handoff expectations
+- `tasks/workstreams/`: durable capability progress ledgers
+- `docs/decisions.md`: architecture decisions and trade-offs
+- `docs/tech-stack.md`: dependency and runtime constraints
+
+*Generated by forge*

package/assets/plan-map.json

@@ -0,0 +1,301 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$comment": "Canonical stack-family mapping for forge. A-F are core stack families. G-J are sidecar/runtime presets. K is fully custom.",
+  "planTiers": {
+    "core": ["A", "B", "C", "D", "E", "F"],
+    "presets": ["G", "H", "I", "J"],
+    "custom": ["K"]
+  },
+  "aliases": {
+    "C+": "C"
+  },
+  "quickDefaults": {
+    "USER_NAME": "Developer",
+    "SERVICE_TARGET": "User",
+    "INTERACTION_STYLE": "Technical, concise",
+    "PROHIBITIONS": "- No `any` in production code\\n- No `console.log` in production code\\n- Always present 2-3 options with trade-offs at ambiguous decision points\\n- Always push back on requests that violate project rules"
+  },
+  "plans": {
+    "A": {
+      "name": "Astro-first SSR/content shell",
+      "stack": "Astro + TypeScript + Cloudflare/Node adapters",
+      "tier": "core",
+      "cloudflareNative": true,
+      "webappRenderingDefaults": {
+        "defaultModel": "astro-content",
+        "recommendedModels": ["astro-content", "start-workers"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["chat-agent", "product-copilot"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "browser-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "typescript-lsp",
+      "defaultTemplateVariables": {
+        "PROJECT_STRUCTURE_FILE": "assets/project-structures/astro-ssr.txt",
+        "TECH_STACK_TABLE": "| Frontend shell | Astro + TypeScript |\\n| UI | Astro islands + shadcn/Radix-compatible components where React is needed |\\n| Deploy | Cloudflare Pages/Workers or Node adapter |\\n| Data | Postgres/Supabase or SQLite/Turso by workload |"
+      }
+    },
+    "B": {
+      "name": "Vite 8 client-only app shell",
+      "stack": "Vite 8 + React + TanStack Router/Query",
+      "tier": "core",
+      "cloudflareNative": true,
+      "webappRenderingDefaults": {
+        "defaultModel": "client-only",
+        "recommendedModels": ["client-only", "start-workers"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["runtime-console", "product-copilot", "chat-agent", "collaborative-editor"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "browser-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "typescript-lsp",
+      "defaultTemplateVariables": {
+        "PROJECT_STRUCTURE_FILE": "assets/project-structures/vite-tanstack.txt",
+        "TECH_STACK_TABLE": "| Frontend app | Vite 8 + React + TypeScript |\\n| Rendering | Client-only SPA/CSR; no crawler-visible SSR guarantee |\\n| Routing/data | TanStack Router + TanStack Query |\\n| UI | shadcn/Radix-style components + Tailwind CSS |\\n| Data authority | Postgres/Supabase by default; SQLite/Turso for lightweight edge/local-first work |"
+      }
+    },
+    "C": {
+      "name": "TanStack Start Workers webapp",
+      "stack": "TanStack Start + Vite + Cloudflare Workers",
+      "tier": "core",
+      "cloudflareNative": true,
+      "webappRenderingDefaults": {
+        "defaultModel": "start-workers",
+        "recommendedModels": ["start-workers", "client-only", "astro-content"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["runtime-console", "product-copilot", "chat-agent", "collaborative-editor"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "browser-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "typescript-lsp",
+      "defaultTemplateVariables": {
+        "PROJECT_STRUCTURE_FILE": "assets/project-structures/tanstack-start-workers.txt",
+        "TECH_STACK_TABLE": "| React webapp | TanStack Start + Vite + React |\\n| Deploy | Cloudflare Workers with `@cloudflare/vite-plugin`, `wrangler.jsonc`, Worker assets, and `wrangler deploy` |\\n| Public route | `/` SSR/prerender-capable landing with meta/OG/canonical |\\n| Workspace route | `/app` client-only via route-level `ssr: false`; lazy-load browser-only/WebGL components |\\n| Frontend count | One deployable frontend component under `apps/web`; do not scaffold `apps/marketing` + `apps/web` by default |\\n| Fallback | Evaluate Vike or React Router Framework Mode only if Start fails the thin gate |\\n| Non-default | Next.js is not the default recommendation |"
+      }
+    },
+    "D": {
+      "name": "Shared frontend/backend monorepo",
+      "stack": "Bun Workspaces + Hono + Shared Contracts",
+      "tier": "core",
+      "cloudflareNative": true,
+      "webappRenderingDefaults": {
+        "defaultModel": "start-workers",
+        "recommendedModels": ["start-workers", "client-only", "astro-content"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["runtime-console", "sidecar-kernel", "enterprise-agent-platform"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "command-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "typescript-lsp",
+      "defaultTemplateVariables": {
+        "PROJECT_STRUCTURE_FILE": "assets/project-structures/monorepo.txt",
+        "TECH_STACK_TABLE": "| Workspace | Bun Workspaces, optional Turborepo only at scale |\\n| Web app | Single `apps/web` frontend by default; use TanStack Start + Workers for SEO/SSR plus app workspace |\\n| Apps | API, Agent, MCP, Expo companion, or admin surfaces only when they own separate runtime authority |\\n| Services | Hono gateways, workers, and sidecars |\\n| Shared packages | contracts, ui, data access, tool adapters, test fixtures |"
+      }
+    },
+    "E": {
+      "name": "Cloudflare edge web stack",
+      "stack": "Cloudflare Pages/Workers + R2/KV/Queues/Durable Objects + external SQL",
+      "tier": "core",
+      "cloudflareNative": true,
+      "webappRenderingDefaults": {
+        "defaultModel": "start-workers",
+        "recommendedModels": ["start-workers", "client-only", "astro-content"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["product-copilot", "enterprise-agent-platform", "sidecar-kernel"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "browser-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "typescript-lsp",
+      "defaultTemplateVariables": {
+        "TECH_STACK_TABLE": "| Edge web | Cloudflare Workers for SSR React webapps; Pages only for static/client-only assets or content shells |\\n| Start deploy | TanStack Start + Vite + `@cloudflare/vite-plugin` + Worker assets + `wrangler deploy` |\\n| Cloudflare storage | R2, KV, Queues, Durable Objects, Hyperdrive when useful |\\n| SQL authority | Postgres/Supabase or SQLite/Turso; D1 is opt-in only |\\n| Agent runtime | VPS behind Hono when Node APIs, tools, or long-lived workers are required |"
+      }
+    },
+    "F": {
+      "name": "Mobile/realtime companion",
+      "stack": "Expo Router + React Native New Architecture + NativeWind",
+      "tier": "core",
+      "cloudflareNative": false,
+      "webappRenderingDefaults": {
+        "defaultModel": "none",
+        "recommendedModels": ["none"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["chat-agent", "voice-agent"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "browser-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "typescript-lsp",
+      "defaultTemplateVariables": {
+        "PROJECT_STRUCTURE_FILE": "assets/project-structures/expo-nativewind.txt",
+        "TECH_STACK_TABLE": "| Mobile | Expo Router + React Native New Architecture |\\n| Styling | NativeWind when useful |\\n| State | TanStack Query + Zustand |\\n| Backend | Shared Hono/API boundary, Supabase/Postgres, or realtime/media sidecar |"
+      }
+    },
+    "G": {
+      "name": "Python research/data/agent sidecar",
+      "stack": "uv + FastAPI/Pydantic AI + DuckDB/Polars",
+      "tier": "preset",
+      "cloudflareNative": false,
+      "factorFactory": true,
+      "webappRenderingDefaults": {
+        "defaultModel": "none",
+        "recommendedModels": ["none", "start-workers"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["research-agent", "sidecar-kernel", "runtime-console"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "command-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "pyright-lsp",
+      "defaultTemplateVariables": {
+        "TECH_STACK_TABLE": "| Python runtime | uv + FastAPI or Pydantic AI |\\n| Data/research | DuckDB + Polars + artifact storage |\\n| App boundary | Hono gateway owns auth, run IDs, tools, and approvals |\\n| UI | Vite/assistant-ui report or runtime console when user-visible |"
+      }
+    },
+    "H": {
+      "name": "Go high-concurrency/financial sidecar",
+      "stack": "Go/Gin sidecar + Hono gateway + TypeScript app",
+      "tier": "preset",
+      "cloudflareNative": false,
+      "webappRenderingDefaults": {
+        "defaultModel": "none",
+        "recommendedModels": ["none", "start-workers"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["sidecar-kernel", "runtime-console"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "command-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "gopls-lsp",
+      "defaultTemplateVariables": {
+        "TECH_STACK_TABLE": "| Go sidecar | Go/Gin or narrow Go workers |\\n| Best fit | Market data, FIX/RFQ, fan-out, infra adapters, high-concurrency jobs |\\n| App gateway | Hono owns product-facing contracts and auth |\\n| Data | Postgres/Supabase for authority; queues/streams by capability |"
+      }
+    },
+    "I": {
+      "name": "Local-first/lightweight SQL stack",
+      "stack": "SQLite/Turso/libSQL + Turso Sync + optional CRDT",
+      "tier": "preset",
+      "cloudflareNative": false,
+      "webappRenderingDefaults": {
+        "defaultModel": "client-only",
+        "recommendedModels": ["client-only", "start-workers"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["collaborative-editor", "product-copilot", "sidecar-kernel"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "browser-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "typescript-lsp",
+      "defaultTemplateVariables": {
+        "TECH_STACK_TABLE": "| SQL | SQLite, Turso/libSQL, or embedded local stores |\\n| Sync | Turso Sync for new local-first sync work; explicit replication, conflict, and ownership contracts |\\n| Local-first | Loro/CRDT only when collaborative document state requires it |\\n| Gateway | Hono or existing app API boundary |"
+      }
+    },
+    "J": {
+      "name": "Rust native/performance sidecar",
+      "stack": "Rust sidecar + TypeScript app/gateway",
+      "tier": "preset",
+      "cloudflareNative": false,
+      "webappRenderingDefaults": {
+        "defaultModel": "none",
+        "recommendedModels": ["none", "client-only"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["coding-agent", "runtime-console", "sidecar-kernel"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "command-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "rust-analyzer-lsp",
+      "defaultTemplateVariables": {
+        "TECH_STACK_TABLE": "| Rust sidecar | Parsers, indexing, sandboxing, native kernels, low-latency tools |\\n| Interface | MCP tools or narrow HTTP jobs behind Hono |\\n| UI | OpenTUI/Ink or Vite IDE surface when needed |\\n| Constraint | Use only when the team can support Rust operational complexity |"
+      }
+    },
+    "K": {
+      "name": "Custom Configuration",
+      "stack": "Manual stack-family composition",
+      "tier": "custom",
+      "cloudflareNative": false,
+      "webappRenderingDefaults": {
+        "defaultModel": "none",
+        "recommendedModels": ["none", "client-only", "start-workers"]
+      },
+      "aiNativeOverlayDefaults": {
+        "defaultProfile": "none",
+        "recommendedProfiles": ["runtime-console", "product-copilot", "sidecar-kernel"]
+      },
+      "defaultHarnessProfiles": {
+        "orchestration": "shared-long-running-harness",
+        "evaluation": "command-qa",
+        "handoff": "artifact-aware",
+        "recovery": "hybrid",
+        "state": "file-backed"
+      },
+      "defaultLsp": "typescript-lsp",
+      "defaultTemplateVariables": {
+        "TECH_STACK_TABLE": "| Stack | Custom composition of A-J families |\\n| Constraints | Defined during guided Q&A |"
+      }
+    }
+  }
+}

package/assets/plugin-registry.v1.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 1,
+  "plugins": [
+    {"id":"desktop_operator","name":"Forge Desktop Operator","version":"0.2.1","description":"Native macOS desktop automation provider for Forge.","repository":"https://github.com/moretea-labs/forge-desktop-operator.git","ref":"v0.2.1","installer":"forge-plugin-install.mjs","platforms":["darwin"]},
+    {"id":"design","name":"Forge Design","version":"0.3.0","description":"Repository-native deterministic design workspace and design.md provider.","repository":"https://github.com/moretea-labs/forge-design.git","ref":"v0.3.0","installer":"forge-plugin-install.mjs","platforms":["darwin","linux","win32"]},
+    {"id":"personal_knowledge","name":"Personal Knowledge Assistant","version":"0.2.1","description":"Local-first personal knowledge retrieval, memory, safe-write and analysis provider.","repository":"https://github.com/moretea-labs/personal-knowledge-assistant.git","ref":"v0.2.1","installer":"forge-plugin-install.mjs","platforms":["darwin","linux","win32"]}
+  ]
+}

package/assets/project-structures/ai-native-collaborative-editor.txt

@@ -0,0 +1,25 @@
+# AI-native Collaborative Editor Overlay
+
+{{PROJECT_NAME}}/
+├── apps/
+│   └── web/
+│       ├── src/routes/documents.$id.tsx     # editor route and document run surface
+│       ├── src/components/editor/           # Plate editor, toolbars, nodes, marks
+│       ├── src/components/assistant/        # document assistant or inline actions
+│       ├── src/collab/loro-doc.ts           # Loro document factory and peer identity
+│       ├── src/collab/sync-client.ts        # sync transport adapter
+│       └── src/stores/editor-ui-store.ts    # bounded Zustand UI chrome only
+├── services/
+│   └── document-gateway/
+│       ├── src/routes/documents.ts          # Bun/Hono document CRUD and auth boundary
+│       ├── src/routes/sync.ts               # CRDT sync endpoint
+│       ├── src/routes/agent-actions.ts      # AI SDK or AG-UI document actions
+│       └── src/storage/                     # snapshots, updates, and audit records
+├── packages/
+│   └── contracts/
+│       ├── src/documents.ts                 # document metadata and ACL schemas
+│       ├── src/crdt.ts                      # Loro update/snapshot contracts
+│       ├── src/editor-nodes.ts              # Plate node/plugin contracts
+│       └── src/agent-actions.ts             # assistant action input/output schemas
+└── workers/
+    └── indexing/                            # optional extraction, search, or sync compaction

package/assets/project-structures/ai-native-product-copilot.txt

@@ -0,0 +1,21 @@
+# AI-native Product Copilot Overlay
+
+{{PROJECT_NAME}}/
+├── src/
+│   ├── components/copilot/                 # CopilotKit or assistant-ui headless surfaces
+│   ├── routes/_app/copilot.tsx             # in-product copilot route/panel
+│   ├── stores/copilot-store.ts             # session, selection, draft action state
+│   └── lib/agent-client.ts                 # AG-UI client adapter
+├── services/
+│   └── agent-gateway/
+│       ├── src/routes/copilot-run.ts       # Hono copilot run endpoint
+│       ├── src/context/                    # product context loaders
+│       ├── src/actions/                    # business action tool wrappers
+│       └── src/policies/                   # approval and authorization gates
+├── packages/
+│   └── contracts/
+│       ├── src/copilot-events.ts           # app-domain AG-UI event payloads
+│       ├── src/actions.ts                  # typed business action contracts
+│       └── src/approvals.ts                # approval request/result contracts
+└── docs/
+    └── agent-boundaries.md                 # product context, action, and approval boundaries

package/assets/project-structures/ai-native-runtime-console.txt

@@ -0,0 +1,25 @@
+# AI-native Runtime Console Overlay
+
+{{PROJECT_NAME}}/
+├── apps/
+│   └── console/
+│       ├── src/routes/agent-runs.tsx       # run list, replay, prompt playground
+│       ├── src/components/agent/           # assistant-ui adapters and panels
+│       ├── src/components/trace/           # timeline, tool calls, approvals
+│       ├── src/stores/run-store.ts         # bounded Zustand run/session store
+│       └── src/state/console-atoms.ts      # Jotai-only local panel state
+├── services/
+│   └── agent-gateway/
+│       ├── src/routes/agent-run.ts         # Bun/Hono /api/agent/run stream endpoint
+│       ├── src/ag-ui/                      # AG-UI event adapters
+│       ├── src/tools/                      # MCP or narrow HTTP tool adapters
+│       └── src/otel/                       # model, tool, approval, sidecar spans
+├── packages/
+│   └── contracts/
+│       ├── src/runs.ts                     # run/thread schemas
+│       ├── src/events.ts                   # app-domain events over AG-UI
+│       ├── src/tools.ts                    # tool call/result schemas
+│       ├── src/approvals.ts                # human approval contracts
+│       └── src/artifacts.ts                # artifact metadata contracts
+└── workers/
+    └── python-agent/                       # optional model/eval sidecar

package/assets/project-structures/ai-native-sidecar-kernel.txt

@@ -0,0 +1,19 @@
+# AI-native Sidecar Kernel Overlay
+
+{{PROJECT_NAME}}/
+├── services/
+│   └── agent-gateway/
+│       ├── src/routes/agent-run.ts         # Bun/Hono app-facing gateway
+│       ├── src/sidecars/                   # MCP/HTTP client adapters
+│       └── src/otel/                       # sidecar latency and outcome telemetry
+├── packages/
+│   └── contracts/
+│       ├── src/jobs.ts                     # sidecar job request/result schemas
+│       ├── src/events.ts                   # user-visible AG-UI event adapters
+│       └── src/tools.ts                    # MCP tool contracts
+├── workers/
+│   ├── python-kernel/                      # model frameworks, evals, data science
+│   ├── go-worker/                          # high-concurrency jobs and infra adapters
+│   └── rust-kernel/                        # parsing, indexing, sandboxing, native kernels
+└── docs/
+    └── sidecar-boundaries.md               # ownership, protocol, and failure semantics

package/assets/project-structures/astro-ssr.txt

@@ -0,0 +1,25 @@
+# Astro-first SSR/Content Shell Structure
+
+{{PROJECT_NAME}}/
+├── apps/
+│   └── web/
+│       ├── src/pages/                  # Astro routes and SSR pages
+│       ├── src/content/                # Content collections for docs/blog/reference
+│       ├── src/components/             # Astro components and small islands
+│       ├── src/components/islands/     # React islands only where interaction needs it
+│       ├── src/layouts/                # Shell layouts, SEO, metadata, navigation
+│       └── src/lib/                    # loaders, auth/session helpers, adapters
+├── services/
+│   └── gateway/
+│       ├── src/routes/                 # Hono API or adapter routes when needed
+│       └── src/policies/               # auth, rate limits, and app policy checks
+├── packages/
+│   └── contracts/
+│       ├── src/content.ts              # content/frontmatter schemas
+│       ├── src/public-api.ts           # public request/response contracts
+│       └── src/auth.ts                 # auth/session contracts when present
+├── deploy/
+│   ├── runbooks/                       # Pages/Workers or Node adapter deployment notes
+│   └── env/                            # environment examples only
+└── docs/
+    └── architecture/                   # shell, content, and runtime boundaries

package/assets/project-structures/expo-nativewind.txt

@@ -0,0 +1,52 @@
+# Expo + NativeWind Project Structure
+
+{{PROJECT_NAME}}/
+├── src/
+│   ├── app/                      # Expo Router (file-based routing)
+│   │   ├── _layout.tsx          # Root layout
+│   │   ├── index.tsx            # Home screen
+│   │   ├── (auth)/              # Auth group
+│   │   │   ├── login.tsx
+│   │   │   └── register.tsx
+│   │   └── (tabs)/              # Tab navigation
+│   │       ├── _layout.tsx      # Tab layout
+│   │       ├── home.tsx
+│   │       ├── profile.tsx
+│   │       └── settings.tsx
+│   ├── components/
+│   │   ├── ui/                  # UI components
+│   │   │   ├── Button.tsx
+│   │   │   ├── Input.tsx
+│   │   │   └── Card.tsx
+│   │   ├── layout/              # Layout components
+│   │   └── features/            # Business components
+│   ├── lib/
+│   │   ├── supabase.ts          # Supabase client
+│   │   └── utils.ts
+│   ├── hooks/                   # Custom hooks
+│   ├── stores/                  # Zustand stores
+│   ├── types/                   # TypeScript types
+│   └── constants/               # App constants
+│       ├── colors.ts
+│       └── config.ts
+├── assets/                      # Images, fonts, etc.
+│   ├── images/
+│   └── fonts/
+├── docs/                        # Project documentation
+│   ├── architecture/
+│   │   ├── ARCHITECTURE.md
+│   │   └── tech-stack.md
+│   └── CHANGELOG.md
+├── deploy/                      # Trackable deploy/ops docs, scripts, and SQL
+│   └── sql/                     # Ordered deployment SQL
+├── _ops/                        # Ignored local secrets, env, state, logs
+├── .env.example
+├── .gitignore
+├── app.json                     # Expo config
+├── babel.config.js
+├── tailwind.config.js           # NativeWind config
+├── metro.config.js
+├── package.json
+├── tsconfig.json
+├── CLAUDE.md                    # AI development guide
+└── README.md