@logicseek/hello-cc 0.1.7 → 0.1.9

package/lib/shell-path.mjs

@@ -2,26 +2,28 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 
-export function pathEntryLine(shellType) {
-  if (shellType === 'fish') return 'set -gx PATH $HOME/.hcc-shims $PATH  # hello-cc shims';
-  return '_hcc_shims="$HOME/.hcc-shims"; PATH="${PATH//:${_hcc_shims}:/:}"; PATH="${PATH#${_hcc_shims}:}"; PATH="${PATH%:${_hcc_shims}}"; export PATH="${_hcc_shims}:$PATH"; unset _hcc_shims  # hello-cc shims';
+export function pathEntryLine(shellType, position = 'final') {
+  const suffix = position === 'early' ? 'early' : 'final';
+  if (shellType === 'fish') return `set -gx PATH $HOME/.hcc-shims $PATH  # hello-cc shims (${suffix})`;
+  return `_hcc_shims="$HOME/.hcc-shims"; PATH="\${PATH//:\${_hcc_shims}:/:}"; PATH="\${PATH#\${_hcc_shims}:}"; PATH="\${PATH%:\${_hcc_shims}}"; export PATH="\${_hcc_shims}:$PATH"; unset _hcc_shims  # hello-cc shims (${suffix})`;
 }
 
 export function removePathEntryLines(content) {
   return String(content || '')
     .split('\n')
-    .filter(line => !line.includes('.hcc-shims'))
+    .filter(line => !isHelloCcShimPathLine(line))
     .join('\n')
     .replace(/\n{3,}/g, '\n\n')
     .replace(/\s+$/, '');
 }
 
 export function insertPathEntry(content, shellType) {
-  const line = pathEntryLine(shellType);
   const cleaned = removePathEntryLines(content);
-  if (shellType === 'fish') return `${cleaned}${cleaned ? '\n' : ''}${line}\n`;
+  const finalLine = pathEntryLine(shellType, 'final');
+  if (shellType === 'fish' || shellType === 'zsh') return `${cleaned}${cleaned ? '\n' : ''}${finalLine}\n`;
 
   const lines = cleaned ? cleaned.split('\n') : [];
+  const earlyLine = pathEntryLine(shellType, 'early');
   let insertAt = 0;
   if (lines[0]?.startsWith('#!')) insertAt = 1;
   for (let i = insertAt; i < lines.length; i += 1) {
@@ -30,9 +32,9 @@ export function insertPathEntry(content, shellType) {
     insertAt = i;
     break;
   }
-  lines.splice(insertAt, 0, line);
+  lines.splice(insertAt, 0, earlyLine);
   const withEarlyEntry = lines.join('\n').replace(/\s+$/, '');
-  return `${withEarlyEntry}${withEarlyEntry ? '\n' : ''}${line}\n`;
+  return `${withEarlyEntry}${withEarlyEntry ? '\n' : ''}${finalLine}\n`;
 }
 
 export function detectShellRc() {
@@ -49,21 +51,34 @@ export function installPathEntry() {
 
   const next = insertPathEntry(content, shellType);
   const alreadyPresent = next === (content.endsWith('\n') ? content : `${content}\n`);
-  if (!alreadyPresent) fs.writeFileSync(rcFile, next);
+  if (!alreadyPresent) {
+    fs.mkdirSync(path.dirname(rcFile), { recursive: true });
+    fs.writeFileSync(rcFile, next);
+  }
   return { rcFile, shellType, alreadyPresent };
 }
 
 export function uninstallPathEntry() {
   const { path: rcFile } = detectShellRc();
+  let content = '';
+  try {
+    content = fs.readFileSync(rcFile, 'utf8');
+  } catch (err) {
+    if (err?.code === 'ENOENT') return { rcFile, removed: false, missing: true };
+    return { rcFile, removed: false, error: 'could not read shell rc' };
+  }
+  const filtered = removePathEntryLines(content);
+  if (filtered === content.replace(/\s+$/, '')) {
+    return { rcFile, removed: false };
+  }
   try {
-    const content = fs.readFileSync(rcFile, 'utf8');
-    const filtered = content
-      .split('\n')
-      .filter(line => !line.includes('.hcc-shims'))
-      .join('\n');
     fs.writeFileSync(rcFile, filtered);
-    return { rcFile };
+    return { rcFile, removed: true };
   } catch {
-    return { rcFile, error: 'could not modify shell rc' };
+    return { rcFile, removed: false, error: 'could not modify shell rc' };
   }
 }
+
+function isHelloCcShimPathLine(line) {
+  return String(line || '').includes('# hello-cc shims');
+}

package/lib/ui/help.mjs

@@ -60,6 +60,8 @@ Environment:
 
 Usage:
   ${cliName} task create --title TEXT [--body TEXT] [--from ID] [--to ID] [--priority N]
+  ${cliName} task dispatch --to ID --title TEXT [--body TEXT] [--from ID] [--message TEXT] [--no-inject] [--force]
+  ${cliName} task dispatch --to ID --id N [--from ID] [--message TEXT] [--no-inject] [--force]
   ${cliName} task create --title TEXT --parent N [--team-role ROLE]
   ${cliName} task list [--status pending|claimed|running|review|blocked|done|abandoned] [--peer ID] [--all]
   ${cliName} task claim [--peer ID] --id N[,N] [--id N] [--ids N,N] [--force]
@@ -74,6 +76,11 @@ Messages use per-peer unread ack state; tasks do not.
 task next returns your existing claimed/running/review/blocked task before
 claiming another pending task. Use --force when intentionally taking additional
 pending tasks; combine it with --count N for explicit batch claims.
+task dispatch explicitly assigns a new or existing task to one peer, sends a
+durable task message, and injects the startup prompt only when the peer has a
+running managed Claude/Codex terminal. Use --no-inject for message-only
+dispatch; use --force only when intentionally injecting while the target already
+owns another active task.
 Use task takeover when explicitly taking over a non-complete task from another
 owner; it records the previous owner, requires a reason, and notifies them.
 Use --policy blocked, stale, or blocked-or-stale to require an auditable
@@ -380,7 +387,7 @@ Usage:
   ${cliName} uninstall [--purge --yes]
 
 Stops the current project runtime and removes user-level hello-cc integrations:
-Claude/Codex hooks and claude/codex shims.
+Claude/Codex hooks, claude/codex shims, and the shell PATH entry for shims.
 
 With --purge --yes, also removes current project data:
   .hello-cc/
@@ -388,6 +395,34 @@ With --purge --yes, also removes current project data:
 `);
     },
 
+    helpInstallHooks() {
+      console.log(`${cliName} install-hooks
+
+Usage:
+  ${cliName} install-hooks
+  ${cliName} install-hooks --status
+  ${cliName} install-hooks --uninstall
+
+Installs, checks, or removes Claude Code and Codex hook entries used by
+hello-cc. This is a maintenance command; hcc up, hcc web, and hcc setup install
+hooks automatically when needed.
+`);
+    },
+
+    helpShim() {
+      console.log(`${cliName} shim
+
+Usage:
+  ${cliName} shim install
+  ${cliName} shim status
+  ${cliName} shim uninstall
+
+Installs, checks, or removes claude/codex shims in ~/.hcc-shims and manages the
+shell PATH entry for that directory. hcc web and hcc setup install shims
+automatically when provider CLIs are available on PATH.
+`);
+    },
+
     helpWeb() {
       console.log(`${cliName} web
 

package/lib/web/http.mjs

@@ -19,7 +19,14 @@ function readRequestBody(req, limit = 1024 * 1024) {
 export async function readJsonRequest(req) {
   const body = await readRequestBody(req);
   if (!body.trim()) return {};
-  return JSON.parse(body);
+  try {
+    return JSON.parse(body);
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      throw new CliError('BAD_REQUEST', 'Invalid JSON request body');
+    }
+    throw err;
+  }
 }
 
 export function sendHttp(res, status, contentType, body) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logicseek/hello-cc",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Local control plane for coordinating Claude Code, Codex, and other coding CLI sessions.",
   "type": "module",
   "bin": {