@akira-tl/forgerelay 0.1.0 → 0.2.0

package/docs/versioning.md

@@ -94,24 +94,30 @@ npm run release:tag-check -- v0.1.0
 A release tag must exactly equal `v` followed by the package version, and
 `Unreleased` must be empty.
 
-## Tag-triggered publishing
+## CI and tag-triggered publishing
 
-`.github/workflows/release.yml` runs for tags matching `v*.*.*` in the
-`Akira-TL/forgerelay` repository. The release helper performs the strict SemVer
-validation; tags that only match the broad GitHub glob but not the package
-version are rejected.
+`.github/workflows/ci.yml` is a reusable workflow with only a `workflow_call`
+entry point. It does not run on ordinary branch pushes, pull-request updates, or
+manual dispatches. Day-to-day development therefore does not consume cloud CI.
+
+`.github/workflows/release.yml` is the single GitHub Actions entry point. It runs
+only for stable SemVer tags matching `v[0-9]+.[0-9]+.[0-9]+` in the
+`Akira-TL/forgerelay` repository. The release helper then requires the tag to
+exactly equal `v` plus the package version. Ordinary branch pushes never enter
+cloud CI or publication.
 
 For a valid tag, the workflow:
 
-1. checks out the tagged commit with full Git history;
-2. verifies the tagged commit is contained in `origin/main`;
-3. installs dependencies;
-4. checks the tag against `package.json` and `CHANGELOG.md`;
-5. runs `npm run release:verify`;
-6. runs `npm pack --dry-run`;
-7. checks whether the exact npm version is already published;
-8. publishes `@akira-tl/forgerelay` when necessary;
-9. creates the matching GitHub Release after npm publication succeeds.
+1. invokes `.github/workflows/ci.yml` for the cloud multi-platform verification;
+2. waits for every CI matrix job to pass;
+3. checks out the tagged commit with full Git history;
+4. verifies the tagged commit is contained in `origin/main`;
+5. installs dependencies and checks the tag against `package.json` and `CHANGELOG.md`;
+6. rebuilds the publish artifact on the publication runner;
+7. runs `npm pack --dry-run`;
+8. checks whether the exact npm version is already published;
+9. publishes `@akira-tl/forgerelay` when necessary;
+10. creates the matching GitHub Release after npm publication succeeds.
 
 The npm existence check makes the workflow safely restartable when npm
 publication succeeds but GitHub Release creation fails afterward.
@@ -152,7 +158,8 @@ npm publishing token.
 3. Run the appropriate `release:patch`, `release:minor`, or `release:major`
    command.
 4. Review the generated version and changelog diff.
-5. Run `npm run release:verify`.
+5. Run `npm run release:verify` locally. This full local gate is a release-time
+   operation; ordinary development pushes do not need to run the full release gate.
 6. Commit the release-ready code and metadata and push `main`.
 7. Create the exact version tag, for example:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akira-tl/forgerelay",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Local development control plane for MCP coding agents.",
   "type": "module",
   "homepage": "https://github.com/Akira-TL/forgerelay#readme",
@@ -36,10 +36,12 @@
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "build": "npm run clean && npm run build:app && tsc -p tsconfig.build.json",
     "build:app": "vite build",
-    "dev": "node scripts/dev-server.mjs",
+    "dev": "node scripts/debug/serve.mjs",
+    "debug:serve": "node scripts/debug/serve.mjs",
+    "debug:accept": "node scripts/debug/accept.mjs",
     "postinstall": "node scripts/fix-node-pty-permissions.mjs",
     "start": "node dist/cli.js serve",
-    "test": "tsx src/config.test.ts && tsx src/mcp/server-instructions.test.ts && tsx src/request-meta.test.ts && tsx src/incoming-artifacts.test.ts && tsx src/artifact-download.test.ts && tsx src/ui/card-types.test.ts && tsx src/ui/patch-display.test.ts && tsx src/ui/tool-display.test.ts && tsx src/apply-patch.test.ts && tsx src/process-platform.test.ts && tsx src/process-sessions.test.ts && tsx src/mcp-sessions.test.ts && tsx src/server-shutdown.test.ts && tsx src/local-agent-runtime.test.ts && tsx src/local-agent-adapters.test.ts && tsx src/local-agent-availability.test.ts && tsx src/local-agent-profiles.test.ts && tsx src/local-agent-targets.test.ts && tsx src/local-agent-store.test.ts && tsx src/roots.test.ts && tsx src/skills.test.ts && tsx src/workspaces.test.ts && tsx src/workspace-conversation.test.ts && tsx src/review-checkpoints.test.ts && tsx src/server.test.ts && tsx src/oauth-store.test.ts && tsx src/cli.test.ts",
+    "test": "tsx src/config.test.ts && tsx src/hooks.test.ts && tsx src/mcp/server-instructions.test.ts && tsx src/request-meta.test.ts && tsx src/incoming-artifacts.test.ts && tsx src/artifact-download.test.ts && tsx src/ui/card-types.test.ts && tsx src/ui/patch-display.test.ts && tsx src/ui/tool-display.test.ts && tsx src/apply-patch.test.ts && tsx src/process-platform.test.ts && tsx src/process-sessions.test.ts && tsx src/mcp-sessions.test.ts && tsx src/server-shutdown.test.ts && tsx src/local-agent-runtime.test.ts && tsx src/local-agent-adapters.test.ts && tsx src/local-agent-availability.test.ts && tsx src/local-agent-profiles.test.ts && tsx src/local-agent-targets.test.ts && tsx src/local-agent-store.test.ts && tsx src/roots.test.ts && tsx src/skills.test.ts && tsx src/workspaces.test.ts && tsx src/workspace-conversation.test.ts && tsx src/review-checkpoints.test.ts && tsx src/server.test.ts && tsx src/oauth-store.test.ts && tsx src/cli.test.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "release:check": "node scripts/release-version.mjs check",
     "release:tag-check": "node scripts/release-version.mjs tag",