cannwork-rehearsal 0.1.0 → 0.2.1

package/README.md

@@ -9,21 +9,27 @@ A terminal launcher for AI coding agents (starting with [opencode](https://openc
 
 ## Install
 
+Trial-period name (currently available — the official scoped name is not published yet):
+
 ```bash
-npm install -g @zhoufangchaojs/cannwork
+npm install -g cannwork-rehearsal
 # or run without installing
-npx @zhoufangchaojs/cannwork
+npx cannwork-rehearsal
 ```
 
+Official name (to be published later): `@zhoufangchaojs/cannwork`, same usage once available.
+
 The npm package ships standalone executables per platform. Supported platforms:
 
-| Platform | Package |
+| Platform | Suffix |
 | --- | --- |
-| Windows x64 | `@zhoufangchaojs/cannwork-win32-x64` |
-| Linux x64 (glibc) | `@zhoufangchaojs/cannwork-linux-x64` |
-| Linux arm64 (glibc) | `@zhoufangchaojs/cannwork-linux-arm64` |
-| macOS x64 | `@zhoufangchaojs/cannwork-darwin-x64` |
-| macOS arm64 | `@zhoufangchaojs/cannwork-darwin-arm64` |
+| Windows x64 | `win32-x64` |
+| Linux x64 (glibc) | `linux-x64` |
+| Linux arm64 (glibc) | `linux-arm64` |
+| macOS x64 | `darwin-x64` |
+| macOS arm64 | `darwin-arm64` |
+
+The installed platform package is `<package-name>-<suffix>` (currently `cannwork-rehearsal-<suffix>`, later `@zhoufangchaojs/cannwork-<suffix>`).
 
 Notes:
 
@@ -31,9 +37,9 @@ Notes:
 - Linux binaries link glibc; Alpine/musl is not covered yet — `OPENTUI_LIBC`/musl builds are not published.
 - The macOS binaries are not codesigned/notarized. If Gatekeeper blocks the binary, clear the quarantine flag:
   ```bash
-  xattr -d com.apple.quarantine "$(npm root -g)/@zhoufangchaojs/cannwork-darwin-arm64/bin/cannwork"
+  xattr -d com.apple.quarantine "$(npm root -g)/cannwork-rehearsal-darwin-arm64/bin/cannwork"
   ```
-- `cannwork-rehearsal` is a **temporary rehearsal name** used to dry-run the publish flow. It is not a production package and must not be installed.
+- `cannwork-rehearsal` is the **trial-period release name**: it is published and installable on purpose so real users can try it while the official `@zhoufangchaojs/cannwork` name is not released yet. It will be retired (unpublished/deprecated) once the official name is published.
 
 ## Getting Started (from source)
 
@@ -67,23 +73,25 @@ Build artifacts are written to `dist/`.
 
 ## Maintainer release runbook
 
-Releases are published manually to <https://registry.npmjs.org/> in two phases: rehearse with a temporary unscoped name, then publish the real scoped name.
+Releases are published manually to <https://registry.npmjs.org/> in two phases: an unscoped **trial release** that is kept live for real users, then (later) the official scoped release, after which the trial name is retired.
 
-### Phase 1 — rehearsal with the temporary name
+### Phase 1 — unscoped trial release (kept live)
 
-1. Set `name` to `cannwork-rehearsal` and `version` to `0.1.0` in the root `package.json` (single source of truth).
+1. Set `name` to `cannwork-rehearsal` and `version` to `0.2.0` in the root `package.json` (single source of truth).
 2. `npm login` (any account with publish rights).
 3. `bun run release` — runs typecheck + tests, cross-compiles, then publishes the 5 platform packages followed by the main package. Add `--dry-run` to pack and verify without uploading.
-4. Smoke-test in a clean directory: `npx cannwork-rehearsal`. On success the script writes `dist/.rehearsal-ok`, which unlocks phase 2.
-5. Clean up the rehearsal packages: `npm unpublish` all 6 (`cannwork-rehearsal` and `cannwork-rehearsal-*`) within the 72-hour window; afterwards use `npm deprecate` to mark them as test packages.
+4. Check each package on the registry (`npm view <pkg> version`). A `0.0.0-stage` value means npm staged the version for review; wait for it to go live (or approve it on npmjs.com) before smoke-testing.
+5. Smoke-test in a clean directory: `npx cannwork-rehearsal`. On success the script writes `dist/.rehearsal-ok`, which unlocks phase 2.
+6. **Keep it live**: do not unpublish. During the trial, ship updates by repeating steps 3–5 with a bumped version.
 
-### Phase 2 — publish the official scoped name
+### Phase 2 — official scoped release (deferred), then retire the trial name
 
-6. Set `name` to `@zhoufangchaojs/cannwork` (keep `version`), then `bun run release`. The script refuses to publish a scoped name until a rehearsal marker exists.
-7. Verify: `npm view @zhoufangchaojs/cannwork version`, smoke-test `npx @zhoufangchaojs/cannwork`, then tag the release:
+7. Set `name` to `@zhoufangchaojs/cannwork`, then `bun run release`. The script refuses to publish a scoped name until the trial-release marker exists.
+8. Verify: `npm view @zhoufangchaojs/cannwork version`, smoke-test `npx @zhoufangchaojs/cannwork`, then tag the release:
    ```bash
-   git tag v0.1.0
+   git tag <version>
    ```
+9. Retire the trial packages: `npm unpublish` all 6 (`cannwork-rehearsal` and `cannwork-rehearsal-*`) within the 72-hour window, otherwise `npm deprecate` them as trial packages. If the active credential is a `Granular access token` that bypasses 2FA, unpublish is rejected with 403 — delete the packages on npmjs.com instead, or run `npm login --auth-type=web` first.
 
 Rollback: `npm unpublish` the affected version within the allowed window; afterwards `npm deprecate` and publish a fixed version.
 

package/bin/cannwork.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
-import { accessSync, chmodSync, constants } from "node:fs";
+import { accessSync, chmodSync, constants, realpathSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -86,13 +86,19 @@ export async function run(argv = process.argv.slice(2)) {
   const { platform: os, arch } = process;
 
   const requireFromHere = createRequire(import.meta.url);
-  let mainName;
+  let manifest;
   try {
-    mainName = requireFromHere("../package.json").name;
+    manifest = requireFromHere("../package.json");
   } catch {
     process.stderr.write("cannwork: 无法读取自身包清单，安装可能已损坏。\n");
     return 1;
   }
+  const mainName = manifest.name;
+
+  if (argv.includes("-v") || argv.includes("--version")) {
+    process.stdout.write(`${manifest.version}\n`);
+    return 0;
+  }
 
   const binaryPath = resolveBinaryPath(mainName, os, arch, requireFromHere);
   if (binaryPath === null) {
@@ -104,17 +110,29 @@ export async function run(argv = process.argv.slice(2)) {
   return await spawnBinary(binaryPath, argv);
 }
 
-export function isEntrypoint(metaUrl, argv1) {
-  if (typeof argv1 !== "string" || argv1.length === 0) return false;
+export const ENTRYPOINT_UNDETERMINED_MESSAGE =
+  "cannwork: 无法确认启动器入口，已跳过执行。\n";
+
+export function entrypointStatus(metaUrl, argv1) {
+  if (typeof argv1 !== "string" || argv1.length === 0) return "not-entrypoint";
   try {
-    return fileURLToPath(metaUrl) === resolve(argv1);
+    const selfPath = realpathSync(fileURLToPath(metaUrl));
+    const argvPath = realpathSync(resolve(argv1));
+    return selfPath === argvPath ? "entrypoint" : "not-entrypoint";
   } catch {
-    return false;
+    return "undetermined";
   }
 }
 
-if (isEntrypoint(import.meta.url, process.argv[1])) {
+export function isEntrypoint(metaUrl, argv1) {
+  return entrypointStatus(metaUrl, argv1) === "entrypoint";
+}
+
+const entryStatus = entrypointStatus(import.meta.url, process.argv[1]);
+if (entryStatus === "entrypoint") {
   run().then((code) => {
     process.exit(code);
   });
+} else if (entryStatus === "undetermined") {
+  process.stderr.write(ENTRYPOINT_UNDETERMINED_MESSAGE);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cannwork-rehearsal",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "type": "module",
   "bin": {
     "cannwork": "bin/cannwork.js"
@@ -10,11 +10,11 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "cannwork-rehearsal-win32-x64": "0.1.0",
-    "cannwork-rehearsal-linux-x64": "0.1.0",
-    "cannwork-rehearsal-linux-arm64": "0.1.0",
-    "cannwork-rehearsal-darwin-x64": "0.1.0",
-    "cannwork-rehearsal-darwin-arm64": "0.1.0"
+    "cannwork-rehearsal-win32-x64": "0.2.1",
+    "cannwork-rehearsal-linux-x64": "0.2.1",
+    "cannwork-rehearsal-linux-arm64": "0.2.1",
+    "cannwork-rehearsal-darwin-x64": "0.2.1",
+    "cannwork-rehearsal-darwin-arm64": "0.2.1"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",