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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ps-neko/nekowork",
-  "version": "0.2.0-alpha.2",
+  "version": "0.2.0-alpha.3",
   "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;