@ps-neko/nekowork 0.2.0-alpha.2 → 0.2.0-alpha.4

package/README.md

@@ -10,23 +10,24 @@ pushes, or deploys on its own.
 
 ## Status
 
-**Published alpha** (`@ps-neko/nekowork`, alpha dist-tag). This package is the
-published slim verification gate. Install with:
+**Published alpha** (`@ps-neko/nekowork`, `@alpha` dist-tag). This package is the
+published slim verification gate. Always install with the **`@alpha`** tag —
+`latest` is pinned to an old `0.2.0-alpha.0` and is not the alpha line:
 
 ```bash
-npm i -g @ps-neko/nekowork
+npm i -g @ps-neko/nekowork@alpha
 ```
 
 The fuller legacy and power-user surface lives in the internal
 `@ps-neko/nekowork-harness` package (not separately published). See
-[HANDOFF-PACKAGE-SPLIT.md](./HANDOFF-PACKAGE-SPLIT.md) for the split history.
+[HANDOFF-PACKAGE-SPLIT.md](https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork/HANDOFF-PACKAGE-SPLIT.md) for the split history.
 
 ## Quickstart
 
 ```bash
 # right after your AI tool changes some files:
-npx -y @ps-neko/nekowork check        # 30-sec environment check
-npx -y @ps-neko/nekowork verify-pr    # scan the diff → get a verdict
+npx -y @ps-neko/nekowork@alpha check        # 30-sec environment check
+npx -y @ps-neko/nekowork@alpha verify-pr    # scan the diff → get a verdict
 ```
 
 `verify-pr` reads the diff, writes a plain-English `REPORT.md`, and tells you
@@ -39,7 +40,7 @@ whether the change is safe to merge.
 | `check` | Probe environment readiness (Node version, git repo, etc.) |
 | `verify-pr` | Scan working-tree diff. Produce REPORT.md + .nekowork/decision.json |
 | `report` | Render an existing decision.json to a human-readable REPORT.md |
-| `apply` | Session-based compatibility apply. Requires a completed work cycle (SHIP_READY marker + cleared Human Gate). NOT driven by verify-pr's decision.json. See [ADVANCED.md](../nekowork-cli/docs/ADVANCED.md). |
+| `apply` | Session-based compatibility apply. Requires a completed work cycle (SHIP_READY marker + cleared Human Gate). NOT driven by verify-pr's decision.json. See [ADVANCED.md](https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/ADVANCED.md). |
 
 Anything else (`ask`, `plan`, `team`, `work`, `ship`, `build`, `auto`,
 `pr-prep`, `review`, ...) belongs to `@ps-neko/nekowork-harness` (legacy and
@@ -63,10 +64,10 @@ step — it is not triggered by `decision.json`.
 
 ## Docs
 
-- [Quickstart](../nekowork-cli/docs/QUICKSTART.md)
-- [How verification works](../nekowork-cli/docs/SCOPE-1.0.md)
-- [Benchmark](../nekowork-cli/docs/BENCHMARK.md) — 73/74 (99%) recall, 0/47 FP, 38 real OSS positives
-- [Integration](../nekowork-cli/docs/INTEGRATION.md)
+- [Quickstart](https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/QUICKSTART.md)
+- [How verification works](https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/SCOPE-1.0.md)
+- [Benchmark](https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/BENCHMARK.md) — 85/86 (99%) recall, 0/47 FP, 30 real OSS positives (secret-fallback)
+- [Integration](https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/INTEGRATION.md)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ps-neko/nekowork",
-  "version": "0.2.0-alpha.2",
+  "version": "0.2.0-alpha.4",
   "description": "Local verification gate for AI-written code diffs. Deterministic rules decide the verdict, never the LLM. No auto-commit, push, or deploy — you decide at the Human Gate.",
   "keywords": [
     "ai-code-review",

package/scripts/cli.js

@@ -4,7 +4,7 @@
 // All 4 public verbs run LOCALLY in this package. No delegation to any other package.
 //
 // Public verbs: check, verify-pr, report, apply
-// Anything else → error with hint to install @ps-neko/nekowork-harness.
+// Anything else → error: harness verbs live in the internal (unpublished) @ps-neko/nekowork-harness; use a source checkout.
 
 import fs from 'node:fs';
 import path from 'node:path';
@@ -25,14 +25,7 @@ const META_FLAGS = new Set(['--version', '-v', '--help', '-h']);
 const args = process.argv.slice(2);
 const verb = args[0];
 
-if (args.length === 0 || META_FLAGS.has(verb)) {
-  if (verb === '--version' || verb === '-v') {
-    const pkgPath = path.resolve(__dirname, '..', 'package.json');
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-    console.log(pkg.version);
-    process.exit(0);
-  }
-  console.log(`@ps-neko/nekowork — local verification gate for AI-written code
+const USAGE = `@ps-neko/nekowork — local verification gate for AI-written code
 
 Usage:
   nekowork check                  Probe environment readiness
@@ -52,13 +45,23 @@ verify-pr options:
   --no-write                don't write REPORT.md / decision.json
 
 Need legacy / harness commands (ask / plan / team / work / ship / build / auto / ...)?
-  npm i -g @ps-neko/nekowork-harness
-  nekowork-harness <verb>
+  They live in the internal @ps-neko/nekowork-harness runtime, which is NOT
+  published to npm. Run them from a source checkout:
+  https://github.com/Ps-Neko/NEKOWORK
 
 Docs:
   https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/QUICKSTART.md
   https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/SCOPE-1.0.md
-  https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/BENCHMARK.md`);
+  https://github.com/Ps-Neko/NEKOWORK/blob/main/packages/nekowork-cli/docs/BENCHMARK.md`;
+
+if (args.length === 0 || META_FLAGS.has(verb)) {
+  if (verb === '--version' || verb === '-v') {
+    const pkgPath = path.resolve(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    console.log(pkg.version);
+    process.exit(0);
+  }
+  console.log(USAGE);
   process.exit(0);
 }
 
@@ -70,13 +73,18 @@ if (VERBS_INTERNAL.has(verb)) {
 The slim @ps-neko/nekowork supports:
   check, verify-pr, report, apply
 
-For \`${verb}\` (a harness command), install @ps-neko/nekowork-harness:
-  npm i -g @ps-neko/nekowork-harness
-  nekowork-harness ${verb} ${args.slice(1).join(' ')}`);
+\`${verb}\` is a harness command. The harness runtime (@ps-neko/nekowork-harness)
+is internal and NOT published to npm — run harness verbs from a source checkout:
+  https://github.com/Ps-Neko/NEKOWORK`);
   process.exit(1);
 }
 
 async function runInternal(verb, rest) {
+  if (rest.includes('--help') || rest.includes('-h')) {
+    console.log(USAGE);
+    process.exit(0);
+  }
+
   if (verb === 'check') {
     const { spawnSync } = await import('node:child_process');
     const r = spawnSync(process.execPath, [path.resolve(__dirname, 'check.js'), ...rest], { stdio: 'inherit' });

package/scripts/orchestrators/verify-pr.js

@@ -441,7 +441,7 @@ export function parseVerifyPrArgs(rest = []) {
     else if (a === '--no-write') opts.write = false;
     else if (a === '--comment-file') { opts.commentFile = nextArg(rest, ++i, '--comment-file'); }
     else if (a === '--ci-exit-soft') opts.ciExitSoft = true;
-    else if (a === '--run-checks') process.stderr.write('warning: --run-checks is not supported in the slim @ps-neko/nekowork gate; install @ps-neko/nekowork-harness for this feature\n');
+    else if (a === '--run-checks') process.stderr.write('warning: --run-checks is not supported in the slim @ps-neko/nekowork gate; use the @ps-neko/nekowork-harness runtime from a source checkout for this feature\n');
     else if (a === '--include') { (opts.includePaths = opts.includePaths || []).push(nextArg(rest, ++i, '--include')); }
   }
   return opts;