cngkit 1.1.18 → 1.1.19

package/README.md

@@ -42,16 +42,18 @@ cngkit coderoom join <room-code>
 cngkit scrub [path]
 cngkit transcripts list --limit 12
 cngkit knowledges search Cloudflare --limit 3
-cngkit knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80
+cngkit knowledges cat /libraries/lib-cloudflare/TOPIC.md
+cngkit hooks install
 printf '{"hook":"PreToolUse"}' | cngkit hookify ingest --event PreToolUse
 ```
 
-The CLI currently has five main jobs:
+The CLI currently has six main jobs:
 
 - **Coderoom**: start or join a live shared working-tree room.
 - **Scrub**: scan local files for secrets and optionally mask them inline.
 - **Transcripts**: inspect local Claude and Codex transcript files from the terminal.
-- **Knowledges**: search and read the hosted Harness knowledge catalog.
+- **Knowledges**: traverse, search, and read the hosted Harness knowledge catalog.
+- **Hooks**: install Hookify forwarding hooks into supported AI-assisted coding tools.
 - **Hookify**: forward local hook events to Curly.ng for server-side hook processing.
 
 ## Coderoom
@@ -93,6 +95,17 @@ Check catalog health:
 cngkit knowledges status
 ```
 
+Browse the catalog like a remote filesystem:
+
+```bash
+cngkit knowledges ls /
+cngkit knowledges ls /libraries/lib-cloudflare -l
+cngkit knowledges tree /libraries --depth 2
+cngkit knowledges ls /libraries/lib-cloudflare
+cngkit knowledges stat /libraries/lib-cloudflare/TOPIC.md
+cngkit knowledges realpath /libraries/lib-cloudflare
+```
+
 Find relevant knowledge:
 
 ```bash
@@ -102,7 +115,16 @@ cngkit knowledges search Cloudflare --limit 3
 Read a catalog file:
 
 ```bash
-cngkit knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80
+cngkit knowledges cat /libraries/lib-cloudflare/TOPIC.md
+cngkit knowledges head /libraries/lib-cloudflare/TOPIC.md -n 20
+cngkit knowledges tail /libraries/lib-cloudflare/TOPIC.md -n 20
+cngkit knowledges read /libraries/lib-cloudflare/TOPIC.md --limit 80
+```
+
+Find paths by shell-style filters:
+
+```bash
+cngkit knowledges find /libraries -name "*cloudflare*" -type f
 ```
 
 List matching files:
@@ -121,21 +143,37 @@ Return JSON for another tool:
 
 ```bash
 cngkit knowledges status --json
+cngkit --format json knowledges ls /
+cngkit --format json knowledges tree /libraries --depth 2
+cngkit --format json knowledges find /libraries -name "*cloudflare*" -type f
+cngkit --format json knowledges stat /libraries/lib-cloudflare/TOPIC.md
 cngkit --format json knowledges search "vector search" --limit 5
 ```
 
 Catalog path shortcuts are supported. For example:
 
 ```text
-/libraries/lib-cloudflare/SUBSKILL.md
+/libraries/lib-cloudflare/TOPIC.md
 ```
 
 maps to:
 
 ```text
-skills/knowledges/subskills/libraries/lib-cloudflare/SUBSKILL.md
+skills/knowledges/topics/libraries/lib-cloudflare/TOPIC.md
 ```
 
+The `knowledges` command set is stateless. It does not keep a working directory and does
+not provide interactive traversal commands; pass the path explicitly on each command.
+
+Text output is shell-friendly:
+
+- `ls` prints one entry name per line; directories end with `/`. Use `--long` or `-l`
+  for the older metadata-heavy tab-separated output.
+- `tree` prints a deterministic plain-text tree; directories end with `/`.
+- `cat`, `head`, and `tail` print raw file content only.
+- `find`, `glob`, and `grep --output-mode files_with_matches` print one path per line.
+- `read`, `glob`, and `realpath` remain useful agent/API-oriented helper commands.
+
 ## Secret Scrubbing
 
 `scrub` scans a file or directory with TruffleHog and prints a redacted report.
@@ -172,17 +210,38 @@ Safety notes:
 
 ## Hookify
 
+Use `hooks install` to configure supported local AI-assisted coding tools:
+
+```bash
+cngkit hooks install --dry-run
+cngkit hooks install
+cngkit hooks install --tool codex
+cngkit hooks uninstall --dry-run
+```
+
+The installer currently writes user-level hook configuration for Claude Code and Codex.
+It preserves existing non-cngkit hook handlers, replaces older cngkit Hookify handlers,
+and installs `cngkit hookify ingest --event <EventName>` for every supported hook event
+in each tool. Hook commands use the already-installed `cngkit` binary so hook execution
+does not resolve `cngkit@latest` through npm on every event.
+`hooks uninstall` removes current direct cngkit Hookify handlers and older npm/npx
+`cngkit@latest` handlers, then reports the exact files, handler counts, and event names
+it changed.
+
 `hookify` is the Curly.ng hook processing surface. The first command is intentionally
-small: it reads stdin and forwards the raw payload to the backend.
+small: it reads stdin and forwards the raw payload to the backend. The backend can return
+the hook result immediately or return a request id for workflow-backed processing; the CLI
+polls until the final stdout, stderr, and exit code are ready.
 
 ```bash
 cngkit hookify ingest --event PreToolUse < hook-payload.json
 cngkit hookify ingest --event Stop --async < hook-payload.json
 ```
 
-The backend response controls stdout and the process exit code. If the backend request
-fails, the command falls back to exit code `0` so local hooks do not block work because
-the remote service is unavailable.
+The backend response controls stdout and the process exit code. `--async` means the server
+may defer the result behind a request id; it does not mean the local hook returns before the
+final result is known. If the backend request or polling fails, the command falls back to
+exit code `0` so local hooks do not block work because the remote service is unavailable.
 
 ## Local Agent Transcripts
 
@@ -232,7 +291,7 @@ source text:
 ```bash
 cngkit --format text --help
 cngkit --format json knowledges status
-cngkit --format markdown knowledges read /libraries/lib-cloudflare/SUBSKILL.md
+cngkit --format markdown knowledges read /libraries/lib-cloudflare/TOPIC.md
 cngkit --no-color knowledges status
 ```
 
@@ -251,6 +310,9 @@ cngkit help knowledges
 cngkit coderoom --help
 cngkit knowledges read --help
 cngkit transcripts --help
+cngkit hooks --help
+cngkit hooks install --help
+cngkit hooks uninstall --help
 cngkit hookify --help
 cngkit hookify ingest --help
 ```
@@ -280,9 +342,22 @@ src/commands/
     share.tsx        cngkit coderoom share
     join.tsx         cngkit coderoom join
   knowledges/
+    ls.tsx           cngkit knowledges ls
+    tree.tsx         cngkit knowledges tree
+    cat.tsx          cngkit knowledges cat
+    head.tsx         cngkit knowledges head
+    tail.tsx         cngkit knowledges tail
+    find.tsx         cngkit knowledges find
+    stat.tsx         cngkit knowledges stat
+    realpath.tsx     cngkit knowledges realpath
     read.tsx         cngkit knowledges read
     grep.tsx         cngkit knowledges grep
     glob.tsx         cngkit knowledges glob
+  hooks/
+    install.tsx      cngkit hooks install
+    uninstall.tsx    cngkit hooks uninstall
+  hookify/
+    ingest.tsx       cngkit hookify ingest
 ```
 
 The CLI does not hand-roll ANSI escape codes. Status styles go through Ink's built-in