kenaz 0.3.1 → 0.3.2

package/core/.formation/bifrost/codex-doctor.js

@@ -29,6 +29,7 @@ function skillText(core) {
   return '---\nname: "kenaz"\ndescription: "Kenaz mode (off|assist|full|status|init) or Yggdrasil (ygg join|status|leave). Use only when the user invokes $kenaz."\n---\n\n'
     + 'Run exactly this shell command from the current project directory, appending the words the user wrote after $kenaz (none = print the current mode), and report its output, nothing else:\n\n'
     + '`node "' + script + '" <words after $kenaz>`\n\n'
+    + '`init` and `ygg ...` talk to kenaz-server on http://127.0.0.1:18080. The sandbox blocks network, so run the command with network access (request escalated permissions); otherwise it reports the server as unreachable even when it is running.\n\n'
     + 'Modes: full = everything; assist = silent bookkeeping only; off = every Kenaz hook exits immediately.\n';
 }
 

package/core/.formation/bifrost/setup-codex.js

@@ -258,17 +258,26 @@ const HOOK_EVENTS = ['PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'SessionSt
 
 function probeNativeHooksSupported() {
   if (!isCodexInstalled()) return false;
+  const list = () => execSync('codex features list', { stdio: 'pipe', timeout: 8000, windowsHide: true }).toString();
   try {
-    const out = execSync('codex features list', { stdio: 'pipe', timeout: 8000, windowsHide: true }).toString();
-    return /^\s*(?:codex_hooks|hooks)\b.*\btrue\s*$/im.test(out);
+    const out = list();
+    if (/^\s*(?:codex_hooks|hooks)\b.*\btrue\s*$/im.test(out)) return true;
+    // codex 0.160 ships `hooks` as a stable feature that is off by default (field report 2026-10-10):
+    // turn it on with codex's own command (writes [features] hooks = true), then re-check.
+    const off = out.match(/^\s*(codex_hooks|hooks)\b.*\bfalse\s*$/im);
+    if (!off) return false;
+    execSync(`codex features enable ${off[1]}`, { stdio: 'pipe', timeout: 8000, windowsHide: true });
+    return /^\s*(?:codex_hooks|hooks)\b.*\btrue\s*$/im.test(list());
   } catch {
     return false;
   }
 }
 
-function getHookShimPath(projectRoot) {
-  const root = projectRoot || process.env.CLAUDE_PROJECT_DIR || process.cwd();
-  return path.resolve(root, HOOK_SHIM_REL);
+// The shim ships next to this file in whatever core runs setup (repo checkout or ~/.kenaz/core from
+// npm). Resolving from the cwd pointed npm installs at <project>/.formation/... which does not exist.
+// projectRoot is kept in the signature for callers; it no longer changes the result.
+function getHookShimPath(_projectRoot) {
+  return path.resolve(__dirname, '..', '..', HOOK_SHIM_REL);
 }
 
 function areHooksAlreadyRegistered(projectRoot) {

package/core/.formation/bifrost/setup-codex.test.js

@@ -15,6 +15,9 @@ const FAKE = `
 const fs=require('fs'),path=require('path');const a=process.argv.slice(2);
 const cfg=path.join(process.env.CODEX_HOME,'config.toml');
 if(a[0]==='--version'){console.log('codex-cli 0.0.0');process.exit(0);}
+const hf=path.join(process.env.CODEX_HOME,'hooks_on');
+if(a[0]==='features'&&a[1]==='list'){console.log('hooks   stable   '+(fs.existsSync(hf)?'true':'false'));process.exit(0);}
+if(a[0]==='features'&&a[1]==='enable'&&a[2]==='hooks'){if(process.env.FAKE_NO_ENABLE)process.exit(2);fs.writeFileSync(hf,'');process.exit(0);}
 if(a[0]==='mcp'&&a[1]==='remove'){const t=fs.readFileSync(cfg,'utf8').split(/\\r?\\n/);let skip=false;const o=[];
  for(const l of t){if(/^\\s*\\[/.test(l))skip=l.trim().startsWith('[mcp_servers.'+a[2]);if(!skip)o.push(l);}
  fs.writeFileSync(cfg,o.join('\\n'));process.exit(0);}
@@ -80,3 +83,20 @@ test('setup with the MCP entry already present still repairs the rest (skill ins
   assert.strictEqual(s.status, 0, s.stderr);
   assert.ok(fs.existsSync(path.join(f.codexHome, 'skills', 'kenaz', 'SKILL.md')), 'early return on already_registered skipped the $kenaz skill');
 });
+
+test('hook shim path comes from the core that runs setup, not the cwd (npm installs run from a project dir)', () => {
+  const s = require('./setup-codex');
+  const p = s.getHookShimPath(path.join(os.tmpdir(), 'some-project'));
+  assert.ok(fs.existsSync(p), p);
+  assert.strictEqual(path.dirname(p), path.join(__dirname, 'openai'));
+});
+
+test('codex with the stable hooks feature switched off (0.160 default): setup enables it and registers the hooks', () => {
+  const f = fixture();
+  fs.writeFileSync(f.cfg, '');
+  const s = f.run('setup');
+  assert.strictEqual(s.status, 0, s.stderr);
+  assert.ok(fs.existsSync(path.join(f.codexHome, 'hooks_on')), 'codex features enable hooks was not run');
+  const cfg = fs.readFileSync(f.cfg, 'utf8');
+  for (const ev of ['PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'SessionStart', 'Stop']) assert.ok(cfg.includes('[[hooks.' + ev + ']]'), ev);
+});

package/core/KENAZ_CORE_VERSION

@@ -1 +1 @@
-0.3.1
+0.3.2

package/core/plugins/kenaz/commands/kenaz.md

@@ -9,4 +9,4 @@ Run exactly this and report its output (one line for modes; the full block for `
 
 Modes: full = guidance + all hooks; assist = silent telemetry/bookkeeping hooks only (no context injection); off = every Kenaz hook exits immediately. init creates .kenaz/project.yaml so hooks act in a fresh project.
 
-`ygg join <key> [--project|--global]` stores the Yggdrasil connection key (default: this project's own slot) and activates collaboration here; `ygg status` shows room, node, relay, peers and mail (key masked); `ygg leave` removes this project's key. Needs the Kenaz backend (Dashboard) running.
+`ygg join <key> [--project|--global]` stores the Yggdrasil connection key (default: this project's own slot) and activates collaboration here; `ygg status` shows room, node, relay, peers and mail (key masked); `ygg leave` removes this project's key. Needs kenaz-server running (installed by `npx kenaz install`).

package/core/plugins/kenaz/scripts/kenaz-mode.js

@@ -29,10 +29,16 @@ if (MODES.includes(arg)) {
   fetch('http://127.0.0.1:' + port + '/api/health', { signal: AbortSignal.timeout(2000) })
     .then((r) => r.ok, () => false)
     .then((up) => {
-      console.log('Kenaz backend: ' + (up ? 'running on port ' + port : 'NOT reachable on port ' + port + ' (run: node dashboard/scripts/install-kenaz-cli.js install, or start the Dashboard)'));
-      console.log('Optional: /kenaz ygg join <key>   multi-device collaboration (Yggdrasil)');
-      console.log('Optional: k-cli alaya register     cross-project memory (Alaya, device-code login)');
-      console.log('Next step: /Ansuz');
+      // Codex runs shell commands in a sandbox without network (it sets CODEX_SANDBOX_NETWORK_DISABLED=1),
+      // so 127.0.0.1 is unreachable from here even when kenaz-server is fine (field report, macOS Codex).
+      const codex = !!(process.env.CODEX_SANDBOX_NETWORK_DISABLED || process.env.CODEX_THREAD_ID || process.env.CODEX_SANDBOX);
+      const cmd = codex ? '$kenaz' : '/kenaz:kenaz';
+      const down = codex && process.env.CODEX_SANDBOX_NETWORK_DISABLED
+        ? 'not reachable from the Codex sandbox (no network). Check from a normal terminal: npx kenaz doctor'
+        : 'NOT reachable on port ' + port + ' (check: npx kenaz doctor; reinstall: npx kenaz@latest install)';
+      console.log('kenaz-server: ' + (up ? 'running on port ' + port : down));
+      console.log('Optional: ' + cmd + ' ygg join <key>   multi-device collaboration (Yggdrasil)');
+      console.log('Next step: ' + (codex ? 'ask Codex to start Ansuz for this project' : '/kenaz:Ansuz'));
     });
 } else {
   const env = process.env.KENAZ_MODE ? ' (env KENAZ_MODE overrides files)' : '';

package/lib/cli.js

@@ -14,7 +14,7 @@ const dash = require('./dashboard');
 const PKG_ROOT = path.resolve(__dirname, '..');
 const PKG = require('../package.json');
 const MIN_NODE = 18;
-const USAGE = 'usage: kenaz <install|uninstall|status|doctor> [--dry-run] [--home <dir>] [--no-service] [--no-claude] [--no-codex] [--keep-dashboard] [--server-bin <path>]';
+const USAGE = 'usage: kenaz <install|uninstall|status|doctor|init|ygg join <key>|ygg status|ygg leave> [--dry-run] [--home <dir>] [--no-service] [--no-claude] [--no-codex] [--keep-dashboard] [--server-bin <path>]';
 
 function parseArgs(argv) {
   const o = { cmd: argv[0], flags: {} };
@@ -226,7 +226,20 @@ async function doctor(p, flags, out, deps = {}) {
   return rows.some((r) => r[1] === 'FAIL') ? 1 : 0;
 }
 
+// `kenaz ygg join|status|leave ...` and `kenaz init`: short forms of the same core scripts the
+// /kenaz (Claude) and $kenaz (Codex) commands run, from a normal terminal in the project folder.
+function passthrough(argv, deps) {
+  const p = paths(os.homedir());
+  const core = fs.existsSync(path.join(p.core, 'plugins', 'kenaz')) ? p.core : path.join(PKG_ROOT, 'core');
+  const script = argv[0] === 'ygg' ? 'ygg.js' : 'kenaz-mode.js';
+  const args = argv[0] === 'ygg' ? argv.slice(1) : argv;
+  const spawn = deps.spawnSync || require('child_process').spawnSync;
+  const r = spawn(process.execPath, [path.join(core, 'plugins', 'kenaz', 'scripts', script), ...args], { stdio: 'inherit', cwd: process.cwd() });
+  return r.status === null ? 1 : r.status;
+}
+
 function run(argv, out = console.log, deps = {}) {
+  if (argv[0] === 'ygg' || argv[0] === 'init') return passthrough(argv, deps);
   const { cmd, flags } = parseArgs(argv);
   const fn = { install, uninstall, status, doctor }[cmd];
   if (!fn) { out(USAGE); return 2; }

package/lib/cli.test.js

@@ -46,3 +46,14 @@ test('setup-codex uninstall strips only kenaz shim hook blocks and keeps user ho
     fs.rmSync(codexHome, { recursive: true, force: true });
   }
 });
+
+test('kenaz ygg / init pass through to the core scripts with the remaining args', () => {
+  const calls = [];
+  const spawnSync = (exe, args) => { calls.push(args); return { status: 0 }; };
+  assert.strictEqual(run(['ygg', 'join', 'KEY', '--global'], () => {}, { spawnSync }), 0);
+  assert.strictEqual(run(['init'], () => {}, { spawnSync }), 0);
+  assert.match(calls[0][0].split(path.sep).join('/'), /plugins\/kenaz\/scripts\/ygg\.js$/);
+  assert.deepStrictEqual(calls[0].slice(1), ['join', 'KEY', '--global']);
+  assert.match(calls[1][0].split(path.sep).join('/'), /plugins\/kenaz\/scripts\/kenaz-mode\.js$/);
+  assert.deepStrictEqual(calls[1].slice(1), ['init']);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Install Kenaz (plugin, hooks, kenaz-server) for Claude Code and Codex: npx kenaz install",
   "bin": {
     "kenaz": "bin/kenaz.js"
@@ -20,11 +20,11 @@
     "test": "node --test lib/cli.test.js"
   },
   "optionalDependencies": {
-    "@kenazai/server-darwin-arm64": "0.3.1",
-    "@kenazai/server-darwin-x64": "0.3.1",
-    "@kenazai/server-linux-arm64": "0.3.1",
-    "@kenazai/server-linux-x64": "0.3.1",
-    "@kenazai/server-win32-x64": "0.3.1"
+    "@kenazai/server-darwin-arm64": "0.3.2",
+    "@kenazai/server-darwin-x64": "0.3.2",
+    "@kenazai/server-linux-arm64": "0.3.2",
+    "@kenazai/server-linux-x64": "0.3.2",
+    "@kenazai/server-win32-x64": "0.3.2"
   },
   "license": "UNLICENSED"
 }