Consume @ai-plugin-marketplace toolkit (Phase B cutover)

.github/workflows/ci.yml

@@ -7,45 +7,35 @@ on:
     branches: [main]
 
 jobs:
-  ci:
+  CI:
     runs-on: ubuntu-latest
+    env:
+      CI: "true"
     steps:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
+        # version is read from package.json#packageManager — do not duplicate here
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 24
           cache: pnpm
 
-      - run: pnpm install --frozen-lockfile
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
 
-      - name: Typecheck
-        run: pnpm run typecheck
+      - name: Build plugins
+        run: pnpm exec aipm build
 
-      - name: Lint TypeScript
-        run: pnpm run lint
-
-      - name: Lint markdown
-        run: pnpm run lint:md
-
-      - name: Test
-        run: pnpm run test
-
-      - name: Build hooks
-        run: pnpm run build:hooks
-
-      - name: Validate plugins
-        run: pnpm run validate
-
-      - name: Build standalone exports
-        run: pnpm run build:standalone
-
-      - name: Verify dist/ is up to date
+      - name: Verify the tree is clean after build (freshness)
         run: |
-          if [ -n "$(git status --porcelain -- dist/)" ]; then
-            echo "::error::dist/ is out of date. Run 'pnpm run build' and commit the changes."
-            git status -- dist/
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "::error::Working tree is dirty after 'aipm build'. Run 'aipm build' locally and commit the regenerated artifacts."
+            git status --porcelain
+            git --no-pager diff
             exit 1
           fi
+
+      - name: Validate plugins
+        run: pnpm exec aipm validate

.gitignore

@@ -146,9 +146,10 @@ vite.config.ts.timestamp-*
 .claude/**/*.local.*
 *.local.*
 
-# Build output (dist/ is committed for consumer install — see .gitattributes)
+# Build output. Toolkit-generated artifacts (dist/ bundles and per-plugin
+# hooks/*.json) are committed for consumer install and the freshness check —
+# see .gitattributes and the @ai-plugin-marketplace build contract.
 dist-ts/
-plugins/*/hooks/*.json
 
 # Scratch & manual-test artifacts
 scratch/

CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing
+
+## Prerequisites
+
+This repository consumes the `@ai-plugin-marketplace/*` toolkit from npm. After
+cloning, run:
+
+```bash
+pnpm install
+```
+
+This requires `@ai-plugin-marketplace/cli` and `@ai-plugin-marketplace/core` to
+be **published to npm**. A fresh `pnpm install` regenerates `pnpm-lock.yaml`
+against the published versions.
+
+## Workflow
+
+1. Add or edit a plugin under `plugins/<name>/`. Use `aipm scaffold <name>` to
+   create a new one or `aipm add-target <plugin> <target>` to expand an
+   existing plugin's support envelope.
+2. Run `aipm build` to regenerate toolkit-owned artifacts (hook JSON and the
+   `dist/` bundles). Commit both your authored sources and the regenerated
+   output — CI enforces that the tree is clean after a build (freshness).
+3. Run `aipm validate` and resolve any hard findings.
+
+## Upgrading the toolkit
+
+```bash
+pnpm up @ai-plugin-marketplace/cli @ai-plugin-marketplace/core
+aipm build
+```
+
+Commit the result. Minor and patch upgrades never require manifest changes;
+major upgrades may ask you to run `aipm migrate`.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mike North
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.