cngkit 1.1.17 → 1.1.19

package/dist/chunk-BL3XMLIH.js

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

package/dist/chunk-BL3XMLIH.js.map

@@ -1 +0,0 @@
-{"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":";AAMA,IAAM,cAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,IAAM,sBAAsB;AAAA,EAC1B;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,IAAM,aAA0B;AAAA,EAC9B;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,IAAI,YAAY,MAAM;AAAA,IAChC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BR,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BX;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,OAAO;AAAA,IACjB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,eAAe,YAAY;AAAA,IACrC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkCR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,YAAY,aAAa,WAAW;AAAA,IAC9C,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYR,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBnB;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,gBAAgB;AAAA,IAC1B,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,eAAe;AAAA,IACzB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,OAAO;AAAA,IACjB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,cAAc,WAAW;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYR,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BrB;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,qBAAqB,QAAQ;AAAA,IACvC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,wBAAwB,WAAW;AAAA,IAC7C,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,qBAAqB,QAAQ;AAAA,IACvC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,mBAAmB,MAAM;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,oBAAoB,OAAO;AAAA,IACrC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,mBAAmB,MAAM;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,mBAAmB,MAAM;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkCR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,mBAAmB,MAAM;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoCR;AACF;AAEA,IAAM,iBAAiB,WACpB,OAAO,CAAC,UAAU,MAAM,UAAU,QAAQ,EAC1C,IAAI,CAAC,UAAU,MAAM,KAAK,EAC1B,KAAK;AAER,IAAM,mBAAmB,oBAAI,IAAuB;AAEpD,WAAW,SAAS,YAAY;AAC9B,aAAW,SAAS,MAAM,SAAS;AACjC,qBAAiB,IAAI,OAAO,KAAK;AAAA,EACnC;AACF;AAEO,SAAS,iBAAiB,WAA4B;AAC3D,QAAM,sBAAsB,uBAAuB,SAAS;AAC5D,QAAM,QAAQ,iBAAiB,IAAI,mBAAmB;AAEtD,MAAI,OAAO;AACT,WAAO,MAAM,KAAK,KAAK;AAAA,EACzB;AAEA,MAAI,wBAAwB,IAAI;AAC9B,WAAO,iBAAiB,IAAI,EAAE,GAAG,KAAK,KAAK,KAAK;AAAA,EAClD;AAEA,SAAO,uBAAuB,mBAAmB;AACnD;AAEO,SAAS,qBAAqB,WAA4B;AAC/D,QAAM,sBAAsB,uBAAuB,SAAS;AAC5D,QAAM,WAAW,sBAAsB,cAAc,mBAAmB,KAAK;AAC7E,SAAO,iBAAiB,QAAQ;AAClC;AAEA,SAAS,uBAAuB,OAAmC;AACjE,SAAO,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,QAAQ,GAAG,KAAK;AAC7D;AAEA,SAAS,uBAAuB,WAA2B;AACzD,SAAO;AAAA;AAAA,wBAEe,SAAS;AAAA;AAAA;AAAA;AAAA,EAI/B,eAAe,IAAI,CAAC,SAAS,OAAO,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQ1D;","names":[]}