@aotter/mantle 0.1.3 → 0.1.4

package/skills/install/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: install
+name: mantle
 description: Author a new Mantle application directly from version-matched SDK docs, or continue an existing project. Use when asked to install Mantle, build a Mantle application, or open a Mantle repository.
 metadata:
   source: "@aotter/mantle"
@@ -9,18 +9,19 @@ metadata:
   projectionReason: Creates a new project; nothing to project into an existing one.
 ---
 
-# Mantle Install
+# Mantle
 
 Mantle is an embeddable manifest engine. The application owns its source and
 provider configuration. There is no Starter/type picker or `mantle create`.
 Do not use the SDK checkout as the application, copy an old Starter tree, or
 turn `generate` into implicit scaffolding.
+A same-version `mantle-starters` tag is not required; do not wait for one.
 
 ## Locate the version-matched instructions
 
-`npx skills add aotter/mantle --skill install` installs this brief, not the SDK,
+`npx skills add aotter/mantle` installs this brief, not the SDK,
 a project, or the handbook. Read the path printed by the installer (Codex's
-project-local path is `.agents/skills/install/SKILL.md`); `metadata.sourcePath`
+project-local path is `.agents/skills/mantle/SKILL.md`); `metadata.sourcePath`
 is repository provenance, not a consumer path. A repository install follows
 the selected Git ref and does not pin an npm release.
 
@@ -29,6 +30,13 @@ with the selected optional packages. All `docs/...` paths below then mean
 `node_modules/@aotter/mantle/docs/...`; package skills are under
 `node_modules/@aotter/mantle/skills/`. Read that package's
 `skills/install/SKILL.md` before authoring: it supersedes this bootstrap copy.
+Use the new application's installation, never another project's `node_modules`
+or an SDK checkout packing harness, to resolve these paths.
+Before reading a handbook page, verify the version in that application's
+`node_modules/@aotter/mantle/package.json` against its lockfile and confirm
+the page exists under the same package directory. If the package is missing or
+the versions differ, fix the installation first; do not substitute a nearby
+checkout's docs or another project's `node_modules`.
 If the user requested a prerelease, resolve that channel explicitly; `latest`
 need not contain prerelease features. Never mix versioned npm code with branch
 docs. No local CLI exists until the package is installed.
@@ -40,7 +48,7 @@ docs. No local CLI exists until the package is installed.
    Do not assume Cloudflare, public HTML or Admin is required. Check Node 22+
    and pnpm 9+ for these SDK examples. A ChatGPT Site is not a conventional
    Cloudflare Worker deployment; use the installed
-   `docs/handbook/sites/index.md` integration guide and
+   `docs/handbook/chatgpt-sites/index.md` integration guide and
    `docs/examples/host-chatgpt-sites/` runnable reference when selected.
 2. Choose the requested exact SDK version, or resolve the intended release
    channel once. Pin all selected `@aotter/mantle*` dependencies to that same
@@ -60,7 +68,8 @@ docs. No local CLI exists until the package is installed.
      `createAuth` email-otp + `ConsoleEmailSender`. Do not Vite-build Admin.
    - ChatGPT Sites with Admin/D1/R2 — follow
      `docs/examples/host-chatgpt-sites/`, not the email-OTP Worker example.
-     Copy it outside the SDK checkout, then `npm ci`,
+     Copy it outside the SDK checkout, pin its `@aotter/mantle*` dependencies
+     to the selected exact version, then `npm install`,
      `npx mantle validate --phase deploy`, `npm run generate`, `npm run check`,
      `npx wrangler d1 migrations apply DB --local`,
      `npm run dev -- --port 4174`, and `npm test` in a second terminal.
@@ -69,12 +78,15 @@ docs. No local CLI exists until the package is installed.
      and the local/production smoke gates. Sites provisions and deploys; never
      `wrangler deploy` a Site. Request both D1 and R2 when uploads are in scope.
      Browser Admin WebMCP and Sites-session `/api/mcp/staff` do not enable remote staff OAuth MCP.
+     At handoff, show the owner where Admin WebMCP and the public/staff MCP
+     endpoints appear, and state which are usable from the browser versus a
+     remote connector.
    - ChatGPT Sites with custom business rules or an external callback — the
      runnable reference covers builtin content only. For application-owned
      operational state, `handler: { kind: ref }` Procedures, staff-only SQL
      Views, staff MCP Triggers with `requires.auth`, and outbound webhooks
      called from handler code, follow
-     `docs/handbook/sites/equipment-checkout.md`. It is an implementation
+     `docs/handbook/chatgpt-sites/equipment-checkout.md`. It is an implementation
      guide, not a shipped app: keep Mantle-owned Schema tables and
      application-owned tables separate, and give every application table a
      reviewed migration.

package/skills/media-gc/SKILL.md

@@ -3,9 +3,9 @@ name: media-gc
 description: Audit and safely remove stale, uncommitted public media uploads from a Mantle Cloudflare R2 bucket. Use when a Mantle operator asks to inspect or clean orphan media objects left after create_media_upload without commit_media_upload.
 metadata:
   source: "@aotter/mantle"
-  sourcePath: skills/media-gc/SKILL.md
+  sourcePath: docs/skills/media-gc/SKILL.md
   applies_to: mantle grammar v0.1
-  projection: plugin
+  projection: package
   projectionReason: Destructive remote object deletion and Cloudflare-specific; opt-in only.
 ---
 

package/skills/plugin/SKILL.md

@@ -3,9 +3,9 @@ name: plugin
 description: Discover, plan, apply, and verify Mantle marketplace plugins through the Core SDK contract. Use when the user wants to add an installable capability without hand-planning provisioning steps.
 metadata:
   source: "@aotter/mantle"
-  sourcePath: skills/plugin/SKILL.md
+  sourcePath: docs/skills/plugin/SKILL.md
   applies_to: mantle grammar v0.1
-  projection: project, plugin
+  projection: project
 ---
 
 # Mantle Plugin

package/skills/provision/SKILL.md

@@ -3,9 +3,9 @@ name: provision
 description: Ship a Mantle project through its selected host, routing ChatGPT Sites to its integration guide and conventional Cloudflare Workers to production auth and provisioning.
 metadata:
   source: "@aotter/mantle"
-  sourcePath: skills/provision/SKILL.md
+  sourcePath: docs/skills/provision/SKILL.md
   applies_to: mantle grammar v0.1
-  projection: plugin
+  projection: package
   projectionReason: Platform-specific deploy that handles production secrets; opt-in only.
 ---
 
@@ -16,7 +16,7 @@ user asks to create remote resources or ship production. This flow is for
 consumer-owned Cloudflare Workers. New direct-authored apps do not need Landing
 artifacts (`.mantle/launch-state.json`, `.mantle/handoff.md`, or a hosted-auth
 allocation). Treat any Landing handoff as **legacy/optional**. For a ChatGPT
-Site, use the installed `docs/handbook/sites/index.md` integration guide and
+Site, use the installed `docs/handbook/chatgpt-sites/index.md` integration guide and
 the "Publish with Sites" steps in `docs/examples/host-chatgpt-sites/README.md`:
 request D1 and R2 on the Site, set `PUBLIC_ORIGIN` and `OWNER_EMAIL` in Sites
 settings, review the migration, then save and deploy a Sites version. Do not

package/skills/theme/SKILL.md

@@ -3,9 +3,9 @@ name: theme
 description: Apply brand and visual direction in a Mantle application using its repo-owned theme and UI contracts.
 metadata:
   source: "@aotter/mantle"
-  sourcePath: skills/theme/SKILL.md
+  sourcePath: docs/skills/theme/SKILL.md
   applies_to: mantle grammar v0.1
-  projection: project, plugin
+  projection: project
 ---
 
 # Mantle Theme

package/skills/update/SKILL.md

@@ -3,9 +3,9 @@ name: update
 description: Review and upgrade Mantle SDK dependencies and project-local skills while preserving application source, provider identities and plugin lockfiles.
 metadata:
   source: "@aotter/mantle"
-  sourcePath: skills/update/SKILL.md
+  sourcePath: docs/skills/update/SKILL.md
   applies_to: mantle grammar v0.1
-  projection: project, plugin
+  projection: project
 ---
 
 # Mantle Update