cngkit 1.1.15 → 1.1.17

package/README.md

@@ -41,7 +41,7 @@ cngkit coderoom share
 cngkit coderoom join <room-code>
 cngkit scrub [path]
 cngkit transcripts list --limit 12
-cngkit knowledges search "cloudflare backend" --limit 3
+cngkit knowledges search Cloudflare --limit 3
 cngkit knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80
 ```
 
@@ -94,7 +94,7 @@ cngkit knowledges status
 Find relevant knowledge:
 
 ```bash
-cngkit knowledges search "cloudflare backend" --limit 3
+cngkit knowledges search Cloudflare --limit 3
 ```
 
 Read a catalog file:
@@ -119,7 +119,7 @@ Return JSON for another tool:
 
 ```bash
 cngkit knowledges status --json
-cngkit knowledges search "vector search" --limit 5 --json
+cngkit --format json knowledges search "vector search" --limit 5
 ```
 
 Catalog path shortcuts are supported. For example:
@@ -199,29 +199,34 @@ Transcript commands are local-only. They do not upload transcript content to Cur
 By default, they print user and assistant text and skip internal prompt, hook, and tool noise.
 Use `--include-internal` when debugging transcript plumbing.
 
-## Backend Selection
+## Backend
 
-By default, `cngkit` talks to:
+`cngkit` always talks to:
 
 ```text
 https://curly.ng
 ```
 
-Override the backend for one command:
+## Output Format
 
-```bash
-cngkit --api-base-url https://curly.ng knowledges status
-```
-
-Or with an environment variable:
+Human-facing output renders as structured terminal text by default, including help
+screens and Markdown catalog reads. Use explicit formats when a script needs data or
+source text:
 
 ```bash
-CNGKIT_API_BASE_URL=https://curly.ng cngkit knowledges status
+cngkit --format text --help
+cngkit --format json knowledges status
+cngkit --format markdown knowledges read /libraries/lib-cloudflare/SUBSKILL.md
+cngkit --no-color knowledges status
 ```
 
+`--json` remains available on read-only data commands as a short alias for JSON output.
+`--format markdown` is intentionally source-oriented; default terminal output should not
+show raw Markdown syntax.
+
 ## Help
 
-Help is baked into the CLI as Markdown:
+Help is baked into the CLI and rendered for terminal reading:
 
 ```bash
 cngkit --help
@@ -232,10 +237,11 @@ cngkit knowledges read --help
 cngkit transcripts --help
 ```
 
-Help uses terminal Markdown rendering in interactive terminals. Status, warnings, and errors
-use Ink color when the terminal supports it, but `--json`, file reads, glob results, grep
-results, and piped output stay clean. Set `CNGKIT_COLOR=never` to disable CLI color, or
-`CNGKIT_COLOR=always` to force it in a wrapper that does not report itself as a TTY.
+Help uses terminal Markdown rendering in interactive terminals and pipes. Status, warnings,
+and errors use Ink color when the terminal supports it, while `--format json`, glob results,
+grep results, and other parse-oriented output stay clean. Use `--no-color` or
+`CNGKIT_COLOR=never` to disable CLI color, or `CNGKIT_COLOR=always` to force it in a wrapper
+that does not report itself as a TTY.
 
 ## Terminal UI Stack
 
@@ -243,7 +249,7 @@ results, and piped output stay clean. Set `CNGKIT_COLOR=never` to disable CLI co
 
 - **Pastel** owns command and subcommand routing through files under `src/commands/`.
 - **Ink** owns terminal rendering through built-in components such as `<Text>`.
-- **marked-terminal** owns terminal Markdown rendering for help screens.
+- **@inkkit/ink-markdown** owns terminal Markdown rendering for help screens and Markdown catalog reads.
 - **Chalk** owns the cngkit color theme passed into the Markdown renderer.
 - **Zod** owns option and argument schemas for each route.
 
@@ -263,8 +269,8 @@ src/commands/
 
 The CLI does not hand-roll ANSI escape codes. Status styles go through Ink's built-in
 `<Text color="..." bold dimColor>` support, and help screens render through
-`marked-terminal` with a shared Chalk-backed theme. Commands that return content for agents
-or shell pipelines write raw lines instead.
+`@inkkit/ink-markdown` with a shared Chalk-backed theme. Commands that return parse-oriented
+content for agents or shell pipelines write clean lines instead.
 
 ## For Contributors
 
@@ -283,8 +289,8 @@ The route files under `src/commands/` should stay thin. Put behavior in
 For output, use the shared `CommandOutput` methods:
 
 - `success`, `warning`, `info`, `muted`, and `error` for human-facing terminal status.
-- `markdown` for help screens and terminal-only Markdown display.
-- `raw` for JSON, file content, file paths, grep results, and anything another tool may parse.
+- `markdown` for help screens and Markdown content that should render by default.
+- `raw` for JSON, explicit source output, file paths, grep results, and anything another tool may parse.
 
 Useful local checks:
 

package/dist/{chunk-55BKHXBM.js → chunk-5ZNV3FDG.js}

@@ -1,11 +1,11 @@
 import {
   readBackendHealth
-} from "./chunk-CSP6OWQH.js";
+} from "./chunk-HRFI2IEP.js";
 import {
   createPeerId,
   createRoomCode,
   resolveApiBaseUrl
-} from "./chunk-U6XERHCZ.js";
+} from "./chunk-WYJTGGMN.js";
 
 // src/features/coderoom/run-coderoom-command.ts
 import process2 from "process";
@@ -412,4 +412,4 @@ export {
   runShareCommand,
   runJoinCommand
 };
-//# sourceMappingURL=chunk-55BKHXBM.js.map
+//# sourceMappingURL=chunk-5ZNV3FDG.js.map

package/dist/{chunk-IG7DJU7W.js → chunk-BL3XMLIH.js}

@@ -13,7 +13,7 @@ var coderoomCommandList = [
 var knowledgesCommandList = [
   "- `status` - print remote catalog state.",
   "- `audiences` - list valid audience filters.",
-  "- `search <query>` - semantic search over Cloudflare Vectorize-backed records.",
+  "- `search <query>` - search over Postgres-backed knowledges records.",
   "- `list [query]` - list known subskills.",
   "- `files [query]` - list uploaded catalog files.",
   "- `read <file-path>` - Claude-style file read.",
@@ -32,7 +32,7 @@ Curly.ng operator CLI for shared code rooms, safe local cleanup, local agent tra
 
 \`\`\`bash
 npx --yes cngkit@latest --help
-npx --yes cngkit@latest knowledges search "cloudflare backend" --limit 3
+npx --yes cngkit@latest knowledges search Cloudflare --limit 3
 \`\`\`
 
 ## Installed Usage
@@ -41,6 +41,13 @@ npx --yes cngkit@latest knowledges search "cloudflare backend" --limit 3
 cngkit <command> [options]
 \`\`\`
 
+## Global Options
+
+\`\`\`bash
+cngkit --format text|json|markdown ...
+cngkit --no-color ...
+\`\`\`
+
 ## Commands
 
 ${commandList}
@@ -59,22 +66,15 @@ cngkit knowledges <subcommand> --help
 
 ## AI And Scripts
 
-- Help is Markdown in pipes and colorized Markdown in interactive terminals.
-- Text output is line-oriented; commands do not rely on color-only state.
-- Use \`--json\` on read-only knowledges commands for typed backend payloads.
-- Use \`CNGKIT_COLOR=never\` for logs, screenshots, and strict plain text.
+- Help renders as structured terminal text by default, even in pipes.
+- Use \`--format json\` or \`--json\` on read-only data commands for typed payloads.
+- Use \`--format markdown\` only when raw Markdown source is intentional.
+- Use \`--no-color\` or \`CNGKIT_COLOR=never\` for logs, screenshots, and strict plain text.
 - Use \`npm_config_progress=false npx --yes cngkit@latest ...\` for clean one-shot npx captures.
 
 ## Backend
 
-Default API: \`https://curly.ng\`
-
-Override with:
-
-\`\`\`bash
-cngkit --api-base-url <url> ...
-CNGKIT_API_BASE_URL=<url> cngkit ...
-\`\`\`
+API: \`https://curly.ng\`
 `
   },
   {
@@ -110,9 +110,9 @@ This is local-only operator tooling. It does not call Curly.ng and it does not u
 ## Usage
 
 \`\`\`bash
-cngkit transcripts list [--source all|codex|claude] [--limit <n>] [--json]
-cngkit transcripts read <path-or-session-id> [--source all|codex|claude] [--limit <n>] [--include-internal] [--json]
-cngkit transcripts grep <query> [--source all|codex|claude] [--limit <n>] [--file-limit <n>] [--include-internal] [--json]
+cngkit transcripts list [--source all|codex|claude] [--limit <n>] [--json|--format json]
+cngkit transcripts read <path-or-session-id> [--source all|codex|claude] [--limit <n>] [--include-internal] [--json|--format json]
+cngkit transcripts grep <query> [--source all|codex|claude] [--limit <n>] [--file-limit <n>] [--include-internal] [--json|--format json]
 \`\`\`
 
 ## Sources
@@ -285,7 +285,7 @@ cngkit knowledges glob --help
 ## Common Examples
 
 \`\`\`bash
-npx --yes cngkit@latest knowledges search "cloudflare backend" --limit 3
+npx --yes cngkit@latest knowledges search Cloudflare --limit 3
 npx --yes cngkit@latest knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80
 npx --yes cngkit@latest knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches
 npx --yes cngkit@latest knowledges glob "**/*.md" --path /libraries/lib-cloudflare
@@ -293,11 +293,11 @@ npx --yes cngkit@latest knowledges glob "**/*.md" --path /libraries/lib-cloudfla
 
 ## AI-Friendly Output
 
-- Default output is line-oriented and intended to be directly usable by agents.
-- \`read\` prints file content with no wrapper before any truncation note.
+- Default output is structured text intended to be directly usable by people and agents.
+- \`read\` renders Markdown files by default and prints exact source with \`--format markdown\`.
 - \`grep --output-mode content\` prints \`path:line\` blocks.
 - \`grep --output-mode files_with_matches\` and \`glob\` print one path per line.
-- \`--json\` prints the typed backend data payload for machine consumption.
+- \`--format json\` and \`--json\` print typed backend payloads for machine consumption.
 `
   },
   {
@@ -310,13 +310,13 @@ Print remote Harness catalog state.
 ## Usage
 
 \`\`\`bash
-cngkit knowledges status [--json]
+cngkit knowledges status [--json|--format json]
 \`\`\`
 
 ## Output
 
-- Text mode prints catalog name, file count, blob count, Vectorize binding, and latest run when present.
-- \`--json\` prints the backend data payload.
+- Text mode prints catalog name, file count, blob count, database binding, and latest run when present.
+- \`--format json\` and \`--json\` print the backend data payload.
 `
   },
   {
@@ -329,7 +329,7 @@ List valid audience filters for catalog browsing.
 ## Usage
 
 \`\`\`bash
-cngkit knowledges audiences [--json]
+cngkit knowledges audiences [--json|--format json]
 \`\`\`
 
 ## Use When
@@ -347,7 +347,7 @@ Search the hosted Harness index for relevant skills and subskills.
 ## Usage
 
 \`\`\`bash
-cngkit knowledges search <query> [--limit <n>] [--json]
+cngkit knowledges search <query> [--limit <n>] [--json|--format json]
 \`\`\`
 
 ## Defaults
@@ -357,7 +357,7 @@ cngkit knowledges search <query> [--limit <n>] [--json]
 ## Example
 
 \`\`\`bash
-npx --yes cngkit@latest knowledges search "cloudflare backend" --limit 3
+npx --yes cngkit@latest knowledges search Cloudflare --limit 3
 \`\`\`
 `
   },
@@ -371,7 +371,7 @@ List hosted Harness subskills, optionally filtered by query.
 ## Usage
 
 \`\`\`bash
-cngkit knowledges list [query] [--limit <n>] [--json]
+cngkit knowledges list [query] [--limit <n>] [--json|--format json]
 \`\`\`
 
 ## Defaults
@@ -395,7 +395,7 @@ List uploaded Harness catalog files, optionally filtered by query or audience.
 ## Usage
 
 \`\`\`bash
-cngkit knowledges files [query] [--audience <id>] [--limit <n>] [--json]
+cngkit knowledges files [query] [--audience <id>] [--limit <n>] [--json|--format json]
 \`\`\`
 
 ## Defaults
@@ -421,7 +421,7 @@ Read a hosted Harness catalog file by path.
 ## Usage
 
 \`\`\`bash
-cngkit knowledges read <file-path> [--offset <n>] [--limit <n>] [--json]
+cngkit knowledges read <file-path> [--offset <n>] [--limit <n>] [--json|--format json|--format markdown]
 \`\`\`
 
 ## Inputs
@@ -432,9 +432,10 @@ cngkit knowledges read <file-path> [--offset <n>] [--limit <n>] [--json]
 
 ## Output
 
-- Text mode prints only the returned file content first.
+- Text mode renders Markdown files for terminal reading.
+- \`--format markdown\` prints the exact returned file content.
 - If truncated, a final bracketed truncation note is printed after the content.
-- \`--json\` prints \`{ file_path, content, total_lines, offset, limit, truncated }\`.
+- \`--format json\` and \`--json\` print \`{ file_path, content, total_lines, offset, limit, truncated }\`.
 
 ## Example
 
@@ -453,7 +454,7 @@ Search inside hosted Harness catalog files with a JavaScript regular expression.
 ## Usage
 
 \`\`\`bash
-cngkit knowledges grep <pattern> [--path <path>] [--include <glob>] [--output-mode <mode>] [--context <n>] [--case-insensitive] [--json]
+cngkit knowledges grep <pattern> [--path <path>] [--include <glob>] [--output-mode <mode>] [--context <n>] [--case-insensitive] [--json|--format json]
 \`\`\`
 
 ## Inputs
@@ -471,13 +472,13 @@ cngkit knowledges grep <pattern> [--path <path>] [--include <glob>] [--output-mo
 - \`content\`: prints blocks as \`file_path:line_number\`, optional context lines, then \`> matching line\`.
 - \`files_with_matches\`: prints one matching file path per line.
 - \`count\`: prints \`file_path: match_count\` lines.
-- \`--json\` prints the typed backend response union.
+- \`--format json\` and \`--json\` print the typed backend response union.
 
 ## Examples
 
 \`\`\`bash
 npx --yes cngkit@latest knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches
-npx --yes cngkit@latest knowledges grep "Vectorize|D1" --path /libraries/lib-cloudflare --context 2
+npx --yes cngkit@latest knowledges grep "Postgres|Hyperdrive" --path /libraries/lib-cloudflare --context 2
 \`\`\`
 `
   },
@@ -491,7 +492,7 @@ Find hosted Harness catalog files by glob pattern.
 ## Usage
 
 \`\`\`bash
-cngkit knowledges glob [pattern] [--path <path>] [--json]
+cngkit knowledges glob [pattern] [--path <path>] [--json|--format json]
 \`\`\`
 
 ## Inputs
@@ -512,7 +513,7 @@ cngkit knowledges glob [pattern] [--path <path>] [--json]
 
 - Text mode prints one file path per line.
 - If truncated, a final bracketed truncation note is printed.
-- \`--json\` prints \`{ files, total_files, truncated }\`.
+- \`--format json\` and \`--json\` print \`{ files, total_files, truncated }\`.
 
 ## Example
 
@@ -569,4 +570,4 @@ export {
   formatCngkitHelp,
   formatKnowledgesHelp
 };
-//# sourceMappingURL=chunk-IG7DJU7W.js.map
+//# sourceMappingURL=chunk-BL3XMLIH.js.map

package/dist/chunk-BL3XMLIH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/help-specs.ts"],"sourcesContent":["type HelpTopic = {\n  title: string;\n  aliases: string[];\n  body: string;\n};\n\nconst commandList = [\n  \"- `cngkit login` - open Curly.ng login, or print the URL in headless shells.\",\n  \"- `cngkit coderoom ...` - share or join a live developer room for a working tree.\",\n  \"- `cngkit scrub [path]` - scan for secrets; rewrite only when `--yes` is passed.\",\n  \"- `cngkit transcripts ...` - list, read, and grep local Claude/Codex transcripts.\",\n  \"- `cngkit knowledges ...` - search and read the hosted Harness knowledge catalog.\",\n].join(\"\\n\");\n\nconst coderoomCommandList = [\n  \"- `share [room-code]` - start a live room from the current directory.\",\n  \"- `join <room-code>` - join another developer's live room from the current directory.\",\n].join(\"\\n\");\n\nconst knowledgesCommandList = [\n  \"- `status` - print remote catalog state.\",\n  \"- `audiences` - list valid audience filters.\",\n  \"- `search <query>` - search over Postgres-backed knowledges records.\",\n  \"- `list [query]` - list known subskills.\",\n  \"- `files [query]` - list uploaded catalog files.\",\n  \"- `read <file-path>` - Claude-style file read.\",\n  \"- `grep <pattern>` - Claude-style content search.\",\n  \"- `glob [pattern]` - Claude-style file discovery.\",\n].join(\"\\n\");\n\nconst helpTopics: HelpTopic[] = [\n  {\n    title: \"cngkit\",\n    aliases: [\"\", \"overview\", \"help\"],\n    body: `# cngkit\n\nCurly.ng operator CLI for shared code rooms, safe local cleanup, local agent transcripts, and hosted Harness knowledges.\n\n## Run Now\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest --help\nnpx --yes cngkit@latest knowledges search Cloudflare --limit 3\n\\`\\`\\`\n\n## Installed Usage\n\n\\`\\`\\`bash\ncngkit <command> [options]\n\\`\\`\\`\n\n## Global Options\n\n\\`\\`\\`bash\ncngkit --format text|json|markdown ...\ncngkit --no-color ...\n\\`\\`\\`\n\n## Commands\n\n${commandList}\n\n## Help Map\n\n\\`\\`\\`bash\ncngkit help <topic>\ncngkit <command> --help\ncngkit coderoom --help\ncngkit coderoom <subcommand> --help\ncngkit transcripts --help\ncngkit knowledges --help\ncngkit knowledges <subcommand> --help\n\\`\\`\\`\n\n## AI And Scripts\n\n- Help renders as structured terminal text by default, even in pipes.\n- Use \\`--format json\\` or \\`--json\\` on read-only data commands for typed payloads.\n- Use \\`--format markdown\\` only when raw Markdown source is intentional.\n- Use \\`--no-color\\` or \\`CNGKIT_COLOR=never\\` for logs, screenshots, and strict plain text.\n- Use \\`npm_config_progress=false npx --yes cngkit@latest ...\\` for clean one-shot npx captures.\n\n## Backend\n\nAPI: \\`https://curly.ng\\`\n`,\n  },\n  {\n    title: \"login\",\n    aliases: [\"login\"],\n    body: `# cngkit login\n\nOpen Curly.ng login in a browser. In headless shells, print the URL so an agent can show it to the operator.\n\n## Usage\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest login\ncngkit login\n\\`\\`\\`\n\n## Output\n\n- First line names the login URL being opened.\n- If no browser opener exists, the CLI prints a direct URL.\n- No credentials are printed or persisted by this command.\n`,\n  },\n  {\n    title: \"transcripts\",\n    aliases: [\"transcripts\", \"transcript\"],\n    body: `# cngkit transcripts\n\nRead local Claude and Codex transcript JSONL files.\n\nThis is local-only operator tooling. It does not call Curly.ng and it does not upload transcript content.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit transcripts list [--source all|codex|claude] [--limit <n>] [--json|--format json]\ncngkit transcripts read <path-or-session-id> [--source all|codex|claude] [--limit <n>] [--include-internal] [--json|--format json]\ncngkit transcripts grep <query> [--source all|codex|claude] [--limit <n>] [--file-limit <n>] [--include-internal] [--json|--format json]\n\\`\\`\\`\n\n## Sources\n\n- \\`~/.codex/sessions\\`\n- \\`~/.codex/archived_sessions\\`\n- \\`~/.claude/projects\\`\n- \\`~/.claude/history.jsonl\\`\n\n## Defaults\n\n- \\`list\\`: newest 12 transcript files.\n- \\`read\\`: newest 80 user/assistant entries from the selected file.\n- \\`grep\\`: first 80 matching user/assistant entries from the newest 60 files.\n- \\`--source\\`: \\`all\\`.\n\n## Output\n\n- Text mode prints source, role, timestamp when available, and extracted message text.\n- Internal developer/system payloads and hook/tool noise are skipped unless \\`--include-internal\\` is passed.\n- Direct file paths, home-relative paths, and partial session ids are accepted by \\`read\\`.\n`,\n  },\n  {\n    title: \"coderoom\",\n    aliases: [\"coderoom\", \"code-room\", \"repo-sync\"],\n    body: `# cngkit coderoom\n\nCreate or join a temporary live room for sharing a working tree over the Curly backend.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom <subcommand> [options]\n\\`\\`\\`\n\n## Subcommands\n\n${coderoomCommandList}\n\n## Common Flow\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest coderoom share\nnpx --yes cngkit@latest coderoom join <room-code>\n\\`\\`\\`\n\n## Behavior\n\n- Connects to \\`/api/cng/sync/:roomCode\\` on the configured Curly backend.\n- Uses WebSocket transport backed by the \\`CngSyncRoom\\` Durable Object.\n- Sends an initial snapshot, then file and delete events.\n- Last received change wins.\n- Current rooms are live relays, not durable cloud storage.\n`,\n  },\n  {\n    title: \"coderoom share\",\n    aliases: [\"coderoom-share\"],\n    body: `# cngkit coderoom share\n\nStart a live repository sync room from the current directory.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom share [room-code]\n\\`\\`\\`\n\n## Behavior\n\n- Connects to \\`/api/cng/sync/:roomCode\\` on the configured Curly backend.\n- Uses WebSocket transport backed by the \\`CngSyncRoom\\` Durable Object.\n- Sends an initial snapshot, then file and delete events.\n- Last received change wins.\n\n## Filesystem Contract\n\n- Preserves \\`.git/\\`.\n- Preserves files ignored by the repo's \\`.gitignore\\`.\n- Sends regular files as base64 payloads in the sync protocol.\n\n## Output\n\n- Prints room code, repo root, peer id, backend health, and concise sync events.\n- Keeps running until the socket closes or the process receives a termination signal.\n`,\n  },\n  {\n    title: \"coderoom join\",\n    aliases: [\"coderoom-join\"],\n    body: `# cngkit coderoom join\n\nJoin an existing live repository sync room from the current directory.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom join <room-code>\n\\`\\`\\`\n\n## Behavior\n\nSame transport and filesystem contract as \\`cngkit coderoom share\\`. The supplied room code selects the Durable Object room.\n\n## Output\n\n- Prints backend health, room code, repo root, peer id, and concise sync events.\n- Missing room code exits with a usage error.\n`,\n  },\n  {\n    title: \"scrub\",\n    aliases: [\"scrub\"],\n    body: `# cngkit scrub\n\nScan a file or directory for secrets with TruffleHog. Report-only is the default.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit scrub [path]\ncngkit scrub [path] --yes\n\\`\\`\\`\n\n## Safety\n\n- Default mode does not rewrite files.\n- Inline masking rewrites files and requires \\`--yes\\`.\n- Raw and redacted secret values are never printed.\n\n## Requirements\n\n- \\`trufflehog\\` must be available on \\`PATH\\`.\n\n## Mask Format\n\n\\`\\`\\`text\n[CNGKIT_SECRET:<detector>:<verified|unverified>]\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges\",\n    aliases: [\"knowledges\", \"knowledge\"],\n    body: `# cngkit knowledges\n\nSearch and read the hosted Harness knowledges catalog from the Curly backend.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges <subcommand> [options]\n\\`\\`\\`\n\n## Subcommands\n\n${knowledgesCommandList}\n\n## Progressive Help\n\n\\`\\`\\`bash\ncngkit help knowledges <subcommand>\ncngkit knowledges <subcommand> --help\ncngkit knowledges read --help\ncngkit knowledges grep --help\ncngkit knowledges glob --help\n\\`\\`\\`\n\n## Common Examples\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges search Cloudflare --limit 3\nnpx --yes cngkit@latest knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80\nnpx --yes cngkit@latest knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches\nnpx --yes cngkit@latest knowledges glob \"**/*.md\" --path /libraries/lib-cloudflare\n\\`\\`\\`\n\n## AI-Friendly Output\n\n- Default output is structured text intended to be directly usable by people and agents.\n- \\`read\\` renders Markdown files by default and prints exact source with \\`--format markdown\\`.\n- \\`grep --output-mode content\\` prints \\`path:line\\` blocks.\n- \\`grep --output-mode files_with_matches\\` and \\`glob\\` print one path per line.\n- \\`--format json\\` and \\`--json\\` print typed backend payloads for machine consumption.\n`,\n  },\n  {\n    title: \"knowledges status\",\n    aliases: [\"knowledges-status\", \"status\"],\n    body: `# cngkit knowledges status\n\nPrint remote Harness catalog state.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges status [--json|--format json]\n\\`\\`\\`\n\n## Output\n\n- Text mode prints catalog name, file count, blob count, database binding, and latest run when present.\n- \\`--format json\\` and \\`--json\\` print the backend data payload.\n`,\n  },\n  {\n    title: \"knowledges audiences\",\n    aliases: [\"knowledges-audiences\", \"audiences\"],\n    body: `# cngkit knowledges audiences\n\nList valid audience filters for catalog browsing.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges audiences [--json|--format json]\n\\`\\`\\`\n\n## Use When\n\nRun this before \\`cngkit knowledges files --audience <id>\\`.\n`,\n  },\n  {\n    title: \"knowledges search\",\n    aliases: [\"knowledges-search\", \"search\"],\n    body: `# cngkit knowledges search\n\nSearch the hosted Harness index for relevant skills and subskills.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges search <query> [--limit <n>] [--json|--format json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`5\\`\n\n## Example\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges search Cloudflare --limit 3\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges list\",\n    aliases: [\"knowledges-list\", \"list\"],\n    body: `# cngkit knowledges list\n\nList hosted Harness subskills, optionally filtered by query.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges list [query] [--limit <n>] [--json|--format json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`25\\`\n\n## Example\n\n\\`\\`\\`bash\ncngkit knowledges list cloudflare --limit 10\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges files\",\n    aliases: [\"knowledges-files\", \"files\"],\n    body: `# cngkit knowledges files\n\nList uploaded Harness catalog files, optionally filtered by query or audience.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges files [query] [--audience <id>] [--limit <n>] [--json|--format json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`25\\`\n- \\`--audience\\`: omitted\n\n## Example\n\n\\`\\`\\`bash\ncngkit knowledges files cloudflare --limit 10\ncngkit knowledges files \"vector search\" --audience builders\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges read\",\n    aliases: [\"knowledges-read\", \"read\"],\n    body: `# cngkit knowledges read\n\nRead a hosted Harness catalog file by path.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges read <file-path> [--offset <n>] [--limit <n>] [--json|--format json|--format markdown]\n\\`\\`\\`\n\n## Inputs\n\n- \\`file-path\\`: normalized catalog path. Shorthand paths such as \\`/libraries/lib-cloudflare/SUBSKILL.md\\` are expanded to \\`skills/knowledges/subskills/libraries/lib-cloudflare/SUBSKILL.md\\`.\n- \\`--offset\\`: zero-based starting line. Default: \\`0\\`.\n- \\`--limit\\`: maximum lines. Default in CLI: \\`200\\`. Backend max: \\`2000\\`.\n\n## Output\n\n- Text mode renders Markdown files for terminal reading.\n- \\`--format markdown\\` prints the exact returned file content.\n- If truncated, a final bracketed truncation note is printed after the content.\n- \\`--format json\\` and \\`--json\\` print \\`{ file_path, content, total_lines, offset, limit, truncated }\\`.\n\n## Example\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges grep\",\n    aliases: [\"knowledges-grep\", \"grep\"],\n    body: `# cngkit knowledges grep\n\nSearch inside hosted Harness catalog files with a JavaScript regular expression.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges grep <pattern> [--path <path>] [--include <glob>] [--output-mode <mode>] [--context <n>] [--case-insensitive] [--json|--format json]\n\\`\\`\\`\n\n## Inputs\n\n- \\`pattern\\`: JavaScript regular expression source.\n- \\`--path\\`: catalog path prefix. Default: \\`skills\\`.\n- \\`--include\\`: filename include filter. Default: \\`*\\`.\n- Modes: content, files_with_matches, or count.\n- \\`--output-mode\\`: \\`content\\`, \\`files_with_matches\\`, or \\`count\\`. Default: \\`content\\`.\n- \\`--context\\`: context lines around content matches. Default: \\`0\\`. Backend max: \\`20\\`.\n- \\`--case-insensitive\\`: maps to backend \\`case_insensitive=true\\`.\n\n## Output\n\n- \\`content\\`: prints blocks as \\`file_path:line_number\\`, optional context lines, then \\`> matching line\\`.\n- \\`files_with_matches\\`: prints one matching file path per line.\n- \\`count\\`: prints \\`file_path: match_count\\` lines.\n- \\`--format json\\` and \\`--json\\` print the typed backend response union.\n\n## Examples\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches\nnpx --yes cngkit@latest knowledges grep \"Postgres|Hyperdrive\" --path /libraries/lib-cloudflare --context 2\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges glob\",\n    aliases: [\"knowledges-glob\", \"glob\"],\n    body: `# cngkit knowledges glob\n\nFind hosted Harness catalog files by glob pattern.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges glob [pattern] [--path <path>] [--json|--format json]\n\\`\\`\\`\n\n## Inputs\n\n- \\`pattern\\`: supported glob pattern. CLI default: \\`**/*.md\\`.\n- \\`--path\\`: catalog path prefix. Default: \\`skills\\`.\n\n## Supported Patterns\n\n- \\`**/*.md\\`\n- \\`**/*.SUBSKILL.md\\`\n- \\`**/SKILL.md\\`\n- \\`*.md\\`\n- \\`*.SUBSKILL.md\\`\n- \\`SKILL.md\\`\n\n## Output\n\n- Text mode prints one file path per line.\n- If truncated, a final bracketed truncation note is printed.\n- \\`--format json\\` and \\`--json\\` print \\`{ files, total_files, truncated }\\`.\n\n## Example\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges glob \"**/*.md\" --path /libraries/lib-cloudflare\n\\`\\`\\`\n`,\n  },\n];\n\nconst helpTopicNames = helpTopics\n  .filter((topic) => topic.title !== \"cngkit\")\n  .map((topic) => topic.title)\n  .sort();\n\nconst helpTopicByAlias = new Map<string, HelpTopic>();\n\nfor (const topic of helpTopics) {\n  for (const alias of topic.aliases) {\n    helpTopicByAlias.set(alias, topic);\n  }\n}\n\nexport function formatCngkitHelp(topicName?: string): string {\n  const normalizedTopicName = normalizeHelpTopicName(topicName);\n  const topic = helpTopicByAlias.get(normalizedTopicName);\n\n  if (topic) {\n    return topic.body.trim();\n  }\n\n  if (normalizedTopicName === \"\") {\n    return helpTopicByAlias.get(\"\")?.body.trim() ?? \"\";\n  }\n\n  return formatUnknownHelpTopic(normalizedTopicName);\n}\n\nexport function formatKnowledgesHelp(topicName?: string): string {\n  const normalizedTopicName = normalizeHelpTopicName(topicName);\n  const topicKey = normalizedTopicName ? `knowledges-${normalizedTopicName}` : \"knowledges\";\n  return formatCngkitHelp(topicKey);\n}\n\nfunction normalizeHelpTopicName(value: string | undefined): string {\n  return value?.trim().toLowerCase().replace(/\\s+/g, \"-\") ?? \"\";\n}\n\nfunction formatUnknownHelpTopic(topicName: string): string {\n  return `# cngkit help\n\nNo help topic named \\`${topicName}\\`.\n\n## Available Topics\n\n${helpTopicNames.map((name) => `- \\`${name}\\``).join(\"\\n\")}\n\n## Usage\n\n\\`\\`\\`bash\ncngkit help <topic>\ncngkit <command> --help\n\\`\\`\\``;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-JX33GP2L.js → chunk-GT2MTS6E.js}

@@ -1,7 +1,7 @@
 import {
   createCommandOutput,
   formatError
-} from "./chunk-Q3F7DVFP.js";
+} from "./chunk-WYJTGGMN.js";
 
 // src/cli/command-runner.tsx
 import { useEffect } from "react";
@@ -23,4 +23,4 @@ function CommandRunner({ run }) {
 export {
   CommandRunner
 };
-//# sourceMappingURL=chunk-JX33GP2L.js.map
+//# sourceMappingURL=chunk-GT2MTS6E.js.map

package/dist/{chunk-CSP6OWQH.js → chunk-HRFI2IEP.js}

@@ -1,6 +1,6 @@
 import {
   resolveApiBaseUrl
-} from "./chunk-U6XERHCZ.js";
+} from "./chunk-WYJTGGMN.js";
 import {
   __export
 } from "./chunk-PZ5AY32C.js";
@@ -279,25 +279,25 @@ var HarnessCatalogSummary;
   };
 })(HarnessCatalogSummary || (HarnessCatalogSummary = {}));
 
+// ../../packages/client/src/generated/api/types/HarnessDatabaseBinding.ts
+var HarnessDatabaseBinding;
+((HarnessDatabaseBinding2) => {
+  HarnessDatabaseBinding2.Engine = {
+    Postgres: "postgres"
+  };
+  HarnessDatabaseBinding2.Binding = {
+    Hyperdrive: "HYPERDRIVE"
+  };
+})(HarnessDatabaseBinding || (HarnessDatabaseBinding = {}));
+
 // ../../packages/client/src/generated/api/types/HarnessSemanticSearchResponse.ts
 var HarnessSemanticSearchResponse;
 ((HarnessSemanticSearchResponse2) => {
   HarnessSemanticSearchResponse2.Model = {
-    CfBaaiBgeBaseEnV15: "@cf/baai/bge-base-en-v1.5"
+    PostgresTextSearch: "postgres-text-search"
   };
 })(HarnessSemanticSearchResponse || (HarnessSemanticSearchResponse = {}));
 
-// ../../packages/client/src/generated/api/types/HarnessVectorizeBinding.ts
-var HarnessVectorizeBinding;
-((HarnessVectorizeBinding2) => {
-  HarnessVectorizeBinding2.Index = {
-    CurlyNgAgents: "curly-ng-agents"
-  };
-  HarnessVectorizeBinding2.Binding = {
-    Vectorize: "VECTORIZE"
-  };
-})(HarnessVectorizeBinding || (HarnessVectorizeBinding = {}));
-
 // ../../packages/client/src/generated/core/headers.ts
 function mergeHeaders(...headersArray) {
   const result = {};
@@ -2389,7 +2389,7 @@ var HarnessInternalKnowledgesClient = class {
     );
   }
   /**
-   * @param {CngApi.HarnessUploadSubskillAssetsVectorizeRequest} request
+   * @param {CngApi.HarnessUploadSubskillAssetsIndexRequest} request
    * @param {HarnessInternalKnowledgesClient.RequestOptions} requestOptions - Request-specific configuration.
    *
    * @throws {@link CngApi.UnauthorizedError}
@@ -3231,4 +3231,4 @@ export {
   createCngApiClient,
   readBackendHealth
 };
-//# sourceMappingURL=chunk-CSP6OWQH.js.map
+//# sourceMappingURL=chunk-HRFI2IEP.js.map