cngkit 1.1.9 → 1.1.11

package/README.md

@@ -234,7 +234,8 @@ 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.
+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.
 
 ## Terminal UI Stack
 

package/dist/{chunk-OTQRKCFP.js → chunk-7Z74PS5X.js}

@@ -4,9 +4,11 @@ import { Marked } from "marked";
 import { markedTerminal } from "marked-terminal";
 import { createElement } from "react";
 import { renderToString, Text } from "ink";
+import stripAnsi2 from "strip-ansi";
 
 // src/shared/theme.ts
 import { Chalk } from "chalk";
+import stripAnsi from "strip-ansi";
 var statusStylePropsByOutputStyle = {
   info: {
     color: "cyan"
@@ -29,21 +31,22 @@ var statusStylePropsByOutputStyle = {
 };
 function createMarkdownTheme(useColor) {
   const chalk = new Chalk({ level: useColor ? 1 : 0 });
+  const identity = (value) => value;
   return {
-    code: chalk.yellow,
-    blockquote: chalk.gray.italic,
+    code: chalk.green,
+    blockquote: chalk.dim.italic,
     html: chalk.gray,
-    heading: chalk.cyan.bold,
-    firstHeading: chalk.green.bold,
-    hr: chalk.dim,
-    listitem: chalk.reset,
-    table: chalk.reset,
-    paragraph: chalk.reset,
+    heading: chalk.blueBright.bold,
+    firstHeading: chalk.magentaBright.bold,
+    hr: chalk.gray,
+    listitem: identity,
+    table: identity,
+    paragraph: identity,
     strong: chalk.bold,
     em: chalk.italic,
-    codespan: chalk.yellow,
+    codespan: chalk.cyanBright,
     del: chalk.dim.strikethrough,
-    link: chalk.cyan,
+    link: chalk.blueBright,
     href: chalk.blue.underline,
     text: chalk.reset,
     showSectionPrefix: true,
@@ -53,6 +56,24 @@ function createMarkdownTheme(useColor) {
     tab: 2
   };
 }
+function decorateMarkdownOutput(output) {
+  const chalk = new Chalk({ level: 1 });
+  const decoratedLines = output.split("\n").map((line) => {
+    const plainLine = stripAnsi(line);
+    if (plainLine.startsWith("# ")) {
+      return chalk.magentaBright.bold(plainLine);
+    }
+    if (plainLine.startsWith("## ")) {
+      return chalk.blueBright.bold(plainLine);
+    }
+    return line;
+  }).join("\n");
+  return decoratedLines.replace(/`([^`\n]+)`/g, (_match, value) => chalk.cyanBright(value)).replace(/(^|\s)(--[a-z][a-z0-9-]*)/g, (_match, prefix, flag) => {
+    return `${prefix}${chalk.yellow(flag)}`;
+  }).replace(/(https?:\/\/[^\s)]+)/g, (url) => chalk.blueBright.underline(url)).replace(/^(\s*)\*\s+/gm, (_match, prefix) => {
+    return `${prefix}${chalk.magentaBright("-")} `;
+  });
+}
 
 // src/shared/output.ts
 var consoleOutput = createCommandOutput(process.stdout, process.stderr);
@@ -112,17 +133,29 @@ function formatMarkdownMessage(stream, markdown) {
   if (stream.isTTY !== true) {
     return markdown;
   }
+  const useColor = shouldRenderColor(stream);
   const parser = new Marked();
   parser.use(
     markedTerminal({
-      ...createMarkdownTheme(shouldRenderColor(stream)),
+      ...createMarkdownTheme(useColor),
       width: clampMarkdownWidth(stream.columns)
     })
   );
-  return String(parser.parse(markdown)).trimEnd();
+  const renderedMarkdown = String(parser.parse(markdown)).trimEnd();
+  return useColor ? decorateMarkdownOutput(renderedMarkdown) : stripAnsi2(renderedMarkdown);
 }
 function shouldRenderColor(stream) {
-  return stream.isTTY === true && process.env.NO_COLOR === void 0;
+  const colorMode = process.env.CNGKIT_COLOR?.toLowerCase();
+  if (colorMode === "never" || colorMode === "0" || colorMode === "false") {
+    return false;
+  }
+  if (colorMode === "always" || colorMode === "1" || colorMode === "true") {
+    return true;
+  }
+  if (process.env.FORCE_COLOR !== void 0 && process.env.FORCE_COLOR !== "0") {
+    return true;
+  }
+  return stream.isTTY === true;
 }
 function clampMarkdownWidth(columns) {
   if (columns === void 0) {
@@ -136,4 +169,4 @@ export {
   createCommandOutput,
   formatError
 };
-//# sourceMappingURL=chunk-OTQRKCFP.js.map
+//# sourceMappingURL=chunk-7Z74PS5X.js.map

package/dist/chunk-7Z74PS5X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/output.ts","../src/shared/theme.ts"],"sourcesContent":["import process from \"node:process\";\nimport { Marked, type MarkedExtension } from \"marked\";\nimport { markedTerminal } from \"marked-terminal\";\nimport { createElement } from \"react\";\nimport { renderToString, Text } from \"ink\";\nimport stripAnsi from \"strip-ansi\";\nimport {\n  createMarkdownTheme,\n  decorateMarkdownOutput,\n  statusStylePropsByOutputStyle,\n  type OutputStyle,\n} from \"./theme.js\";\n\ntype OutputStream = NodeJS.WriteStream & {\n  isTTY?: boolean;\n  columns?: number;\n};\n\nexport type CommandOutput = {\n  info(message: string): void;\n  success(message: string): void;\n  warning(message: string): void;\n  muted(message: string): void;\n  markdown(message: string): void;\n  raw(message: string): void;\n  error(message: string): void;\n};\n\nexport const consoleOutput = createCommandOutput(process.stdout, process.stderr);\n\nexport function createCommandOutput(stdout: OutputStream, stderr: OutputStream): CommandOutput {\n  return {\n    info(message) {\n      writeStyledMessage(stdout, \"info\", message);\n    },\n    success(message) {\n      writeStyledMessage(stdout, \"success\", message);\n    },\n    warning(message) {\n      writeStyledMessage(stdout, \"warning\", message);\n    },\n    muted(message) {\n      writeStyledMessage(stdout, \"muted\", message);\n    },\n    markdown(message) {\n      stdout.write(`${formatMarkdownMessage(stdout, message)}\\n`);\n    },\n    raw(message) {\n      stdout.write(`${message}\\n`);\n    },\n    error(message) {\n      writeStyledMessage(stderr, \"error\", message);\n    },\n  };\n}\n\nexport function formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction writeStyledMessage(stream: OutputStream, style: OutputStyle, message: string): void {\n  stream.write(`${formatStyledMessage(stream, style, message)}\\n`);\n}\n\nfunction formatStyledMessage(stream: OutputStream, style: OutputStyle, message: string): string {\n  if (!shouldRenderColor(stream)) {\n    return message;\n  }\n\n  return renderToString(\n    createElement(\n      Text,\n      {\n        ...statusStylePropsByOutputStyle[style],\n        wrap: \"wrap\",\n      },\n      message\n    ),\n    {\n      columns: 10_000,\n    }\n  );\n}\n\nfunction formatMarkdownMessage(stream: OutputStream, markdown: string): string {\n  if (stream.isTTY !== true) {\n    return markdown;\n  }\n\n  const useColor = shouldRenderColor(stream);\n  const parser = new Marked();\n  parser.use(\n    markedTerminal({\n      ...createMarkdownTheme(useColor),\n      width: clampMarkdownWidth(stream.columns),\n    }) as unknown as MarkedExtension\n  );\n\n  const renderedMarkdown = String(parser.parse(markdown)).trimEnd();\n  return useColor ? decorateMarkdownOutput(renderedMarkdown) : stripAnsi(renderedMarkdown);\n}\n\nfunction shouldRenderColor(stream: OutputStream): boolean {\n  const colorMode = process.env.CNGKIT_COLOR?.toLowerCase();\n\n  if (colorMode === \"never\" || colorMode === \"0\" || colorMode === \"false\") {\n    return false;\n  }\n\n  if (colorMode === \"always\" || colorMode === \"1\" || colorMode === \"true\") {\n    return true;\n  }\n\n  if (process.env.FORCE_COLOR !== undefined && process.env.FORCE_COLOR !== \"0\") {\n    return true;\n  }\n\n  return stream.isTTY === true;\n}\n\nfunction clampMarkdownWidth(columns: number | undefined): number {\n  if (columns === undefined) {\n    return 100;\n  }\n\n  return Math.max(72, Math.min(columns, 120));\n}\n","import { Chalk } from \"chalk\";\nimport type { TextProps } from \"ink\";\nimport stripAnsi from \"strip-ansi\";\n\nexport type OutputStyle = \"info\" | \"success\" | \"warning\" | \"muted\" | \"error\";\n\nexport const statusStylePropsByOutputStyle = {\n  info: {\n    color: \"cyan\",\n  },\n  success: {\n    color: \"green\",\n    bold: true,\n  },\n  warning: {\n    color: \"yellow\",\n    bold: true,\n  },\n  muted: {\n    dimColor: true,\n  },\n  error: {\n    color: \"red\",\n    bold: true,\n  },\n} satisfies Record<OutputStyle, TextProps>;\n\nexport function createMarkdownTheme(useColor: boolean) {\n  const chalk = new Chalk({ level: useColor ? 1 : 0 });\n  const identity = (value: string) => value;\n\n  return {\n    code: chalk.green,\n    blockquote: chalk.dim.italic,\n    html: chalk.gray,\n    heading: chalk.blueBright.bold,\n    firstHeading: chalk.magentaBright.bold,\n    hr: chalk.gray,\n    listitem: identity,\n    table: identity,\n    paragraph: identity,\n    strong: chalk.bold,\n    em: chalk.italic,\n    codespan: chalk.cyanBright,\n    del: chalk.dim.strikethrough,\n    link: chalk.blueBright,\n    href: chalk.blue.underline,\n    text: chalk.reset,\n    showSectionPrefix: true,\n    reflowText: true,\n    unescape: true,\n    emoji: false,\n    tab: 2,\n  };\n}\n\nexport function decorateMarkdownOutput(output: string): string {\n  const chalk = new Chalk({ level: 1 });\n\n  const decoratedLines = output\n    .split(\"\\n\")\n    .map((line) => {\n      const plainLine = stripAnsi(line);\n\n      if (plainLine.startsWith(\"# \")) {\n        return chalk.magentaBright.bold(plainLine);\n      }\n\n      if (plainLine.startsWith(\"## \")) {\n        return chalk.blueBright.bold(plainLine);\n      }\n\n      return line;\n    })\n    .join(\"\\n\");\n\n  return decoratedLines\n    .replace(/`([^`\\n]+)`/g, (_match, value: string) => chalk.cyanBright(value))\n    .replace(/(^|\\s)(--[a-z][a-z0-9-]*)/g, (_match, prefix: string, flag: string) => {\n      return `${prefix}${chalk.yellow(flag)}`;\n    })\n    .replace(/(https?:\\/\\/[^\\s)]+)/g, (url: string) => chalk.blueBright.underline(url))\n    .replace(/^(\\s*)\\*\\s+/gm, (_match, prefix: string) => {\n      return `${prefix}${chalk.magentaBright(\"-\")} `;\n    });\n}\n"],"mappings":"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","names":["stripAnsi","stripAnsi"]}

package/dist/{chunk-CHSTTMTO.js → chunk-CYT46QDQ.js}

@@ -1,6 +1,6 @@
 import {
   resolveApiBaseUrl
-} from "./chunk-575IBOIA.js";
+} from "./chunk-MKVQWJHQ.js";
 import {
   __export
 } from "./chunk-PZ5AY32C.js";
@@ -3231,4 +3231,4 @@ export {
   createCngApiClient,
   readBackendHealth
 };
-//# sourceMappingURL=chunk-CHSTTMTO.js.map
+//# sourceMappingURL=chunk-CYT46QDQ.js.map

package/dist/{chunk-OKKJBRUU.js → chunk-GEJEYWUR.js}

@@ -1,11 +1,11 @@
 import {
   readBackendHealth
-} from "./chunk-CHSTTMTO.js";
+} from "./chunk-CYT46QDQ.js";
 import {
   createPeerId,
   createRoomCode,
   resolveApiBaseUrl
-} from "./chunk-575IBOIA.js";
+} from "./chunk-MKVQWJHQ.js";
 
 // src/features/coderoom/run-coderoom-command.ts
 import process2 from "process";
@@ -412,4 +412,4 @@ export {
   runShareCommand,
   runJoinCommand
 };
-//# sourceMappingURL=chunk-OKKJBRUU.js.map
+//# sourceMappingURL=chunk-GEJEYWUR.js.map

package/dist/{chunk-575IBOIA.js → chunk-MKVQWJHQ.js}

@@ -1,7 +1,7 @@
 // src/shared/config.ts
 import { randomBytes, randomUUID } from "crypto";
 import process from "process";
-var packageVersion = "1.1.9";
+var packageVersion = "1.1.11";
 var defaultApiBaseUrl = "https://curly.ng";
 function resolveApiBaseUrl(options) {
   return options.apiBaseUrl ?? process.env.CNGKIT_API_BASE_URL ?? defaultApiBaseUrl;
@@ -19,4 +19,4 @@ export {
   createRoomCode,
   createPeerId
 };
-//# sourceMappingURL=chunk-575IBOIA.js.map
+//# sourceMappingURL=chunk-MKVQWJHQ.js.map

package/dist/chunk-MKVQWJHQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/config.ts"],"sourcesContent":["import { randomBytes, randomUUID } from \"node:crypto\";\nimport process from \"node:process\";\n\nexport const packageVersion = \"1.1.11\";\nexport const defaultApiBaseUrl = \"https://curly.ng\";\n\nexport type GlobalCommandOptions = {\n  apiBaseUrl?: string;\n};\n\nexport function resolveApiBaseUrl(options: GlobalCommandOptions): string {\n  return options.apiBaseUrl ?? process.env.CNGKIT_API_BASE_URL ?? defaultApiBaseUrl;\n}\n\nexport function createRoomCode(): string {\n  return randomBytes(4).toString(\"hex\").toUpperCase();\n}\n\nexport function createPeerId(): string {\n  return randomUUID();\n}\n"],"mappings":";AAAA,SAAS,aAAa,kBAAkB;AACxC,OAAO,aAAa;AAEb,IAAM,iBAAiB;AACvB,IAAM,oBAAoB;AAM1B,SAAS,kBAAkB,SAAuC;AACvE,SAAO,QAAQ,cAAc,QAAQ,IAAI,uBAAuB;AAClE;AAEO,SAAS,iBAAyB;AACvC,SAAO,YAAY,CAAC,EAAE,SAAS,KAAK,EAAE,YAAY;AACpD;AAEO,SAAS,eAAuB;AACrC,SAAO,WAAW;AACpB;","names":[]}

package/dist/{chunk-WPBMAXXM.js → chunk-S6LINZSY.js}

@@ -1,24 +1,24 @@
 // src/cli/help-specs.ts
 var commandList = [
-  "`cngkit login` - open Curly.ng login.",
-  "`cngkit coderoom ...` - unite developers in a live shared code room.",
-  "`cngkit scrub [path]` - scan for secrets and optionally mask them inline.",
-  "`cngkit transcripts ...` - list, read, and grep local Claude/Codex transcripts.",
-  "`cngkit knowledges ...` - read the hosted Harness catalog."
+  "- `cngkit login` - open Curly.ng login.",
+  "- `cngkit coderoom ...` - unite developers in a live shared code room.",
+  "- `cngkit scrub [path]` - scan for secrets and optionally mask them inline.",
+  "- `cngkit transcripts ...` - list, read, and grep local Claude/Codex transcripts.",
+  "- `cngkit knowledges ...` - read the hosted Harness 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."
+  "- `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>` - semantic search over Cloudflare Vectorize-backed 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."
+  "- `status` - print remote catalog state.",
+  "- `audiences` - list valid audience filters.",
+  "- `search <query>` - semantic search over Cloudflare Vectorize-backed 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 = [
   {
@@ -506,4 +506,4 @@ export {
   formatCngkitHelp,
   formatKnowledgesHelp
 };
-//# sourceMappingURL=chunk-WPBMAXXM.js.map
+//# sourceMappingURL=chunk-S6LINZSY.js.map

package/dist/chunk-S6LINZSY.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.\",\n  \"- `cngkit coderoom ...` - unite developers in a live shared code room.\",\n  \"- `cngkit scrub [path]` - scan for secrets and optionally mask them inline.\",\n  \"- `cngkit transcripts ...` - list, read, and grep local Claude/Codex transcripts.\",\n  \"- `cngkit knowledges ...` - read the hosted Harness 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>` - semantic search over Cloudflare Vectorize-backed 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 backend-connected repo sync, secret scrubbing, and Harness knowledges access.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit <command> [options]\n\\`\\`\\`\n\n## Commands\n\n${commandList}\n\n## Progressive Help\n\n\\`\\`\\`bash\ncngkit <command> --help\ncngkit coderoom --help\ncngkit coderoom <subcommand> --help\ncngkit transcripts --help\ncngkit knowledges --help\ncngkit knowledges <subcommand> --help\n\\`\\`\\`\n\nThe CLI intentionally prints plain Markdown or line-oriented text with no color-only state, tables that require terminal width, or hidden interactive prompts. Add \\`--json\\` to read-only knowledges commands when another agent or tool needs structured backend data.\n\n## Backend\n\nDefault API: \\`https://curly.ng\\`\n\nOverride with:\n\n\\`\\`\\`bash\ncngkit --api-base-url <url> ...\nCNGKIT_API_BASE_URL=<url> cngkit ...\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"login\",\n    aliases: [\"login\"],\n    body: `# cngkit login\n\nOpen Curly.ng login in a browser. In headless environments, print the URL so an agent can surface it to the operator.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit login\n\\`\\`\\`\n\n## Output Contract\n\n- First line names the login URL being opened.\n- If no local 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 agent transcript JSONL files from \\`~/.codex/sessions\\`, \\`~/.codex/archived_sessions\\`, \\`~/.claude/projects\\`, and \\`~/.claude/history.jsonl\\`.\n\nThis is local operator tooling. It does not call the Curly backend and it does not upload transcript content.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit transcripts list [--source all|codex|claude] [--limit <n>] [--json]\ncngkit transcripts read <path-or-session-id> [--source all|codex|claude] [--limit <n>] [--include-internal] [--json]\ncngkit transcripts grep <query> [--source all|codex|claude] [--limit <n>] [--file-limit <n>] [--include-internal] [--json]\n\\`\\`\\`\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 Contract\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\nCoderoom is the fast way to unite developers around one working tree. It gives a pair or team a temporary shared room over the Curly backend so one developer can share local file changes and another can join from their own machine.\n\nIt is intentionally closer to a Drive-like project room than a raw socket command: the room code is the shared folder link, each connected machine is a collaborator, and the file stream is the activity feed. The browser experience at \\`/coderoom\\` provides the helper surface for copying commands and explaining the room model.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom <subcommand> [options]\n\\`\\`\\`\n\n## Subcommands\n\n${coderoomCommandList}\n\n## Common Flow\n\n\\`\\`\\`bash\ncngkit coderoom share\ncngkit coderoom join <room-code>\n\\`\\`\\`\n\n## Backend Contract\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. The Drive-like frontend is the collaboration shell around that live primitive.\n`,\n  },\n  {\n    title: \"coderoom share\",\n    aliases: [\"coderoom-share\"],\n    body: `# cngkit coderoom share\n\nStart a real-time repository sync room from the current directory.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom share [room-code]\n\\`\\`\\`\n\n## Backend Contract\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 Contract\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 real-time repository sync room in the current directory.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom join <room-code>\n\\`\\`\\`\n\n## Backend Contract\n\nSame transport and filesystem contract as \\`cngkit coderoom share\\`. The supplied room code selects the Durable Object room.\n\n## Output Contract\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. Inline masking requires \\`--yes\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit scrub [path]\ncngkit scrub [path] --yes\n\\`\\`\\`\n\n## Requirements\n\n- \\`trufflehog\\` must be available on \\`PATH\\`.\n\n## Safety Contract\n\n- Default mode does not rewrite files.\n- \\`--yes\\` rewrites detected secret values inline with \\`[CNGKIT_SECRET:<detector>:<verified|unverified>]\\` placeholders.\n- \\`--mask\\` is accepted as a compatibility alias, but still requires \\`--yes\\`.\n- Raw and redacted secret values are never printed in the report.\n`,\n  },\n  {\n    title: \"knowledges\",\n    aliases: [\"knowledges\", \"knowledge\"],\n    body: `# cngkit knowledges\n\nRead the hosted Harness knowledges catalog from the Curly backend. These commands are read-only and use the generated \\`@cng/client\\` SDK against public backend routes.\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 knowledges <subcommand> --help\ncngkit knowledges read --help\ncngkit knowledges grep --help\ncngkit knowledges glob --help\n\\`\\`\\`\n\n## Common Examples\n\n\\`\\`\\`bash\ncngkit knowledges search \"cloudflare backend\" --limit 3\ncngkit knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80\ncngkit knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches\ncngkit knowledges glob \"**/*.md\" --path /libraries/lib-cloudflare\n\\`\\`\\`\n\n## AI-Friendly Output\n\n- Default output is line-oriented and intended to be directly usable by agents.\n- \\`read\\` prints file content with no wrapper before any truncation note.\n- \\`grep --output-mode content\\` prints \\`path:line\\` blocks.\n- \\`grep --output-mode files_with_matches\\` and \\`glob\\` print one path per line.\n- \\`--json\\` prints the typed backend data payload 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 from \\`GET /api/harness/knowledges/catalog\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges status [--json]\n\\`\\`\\`\n\n## Output Contract\n\n- Text mode prints catalog name, file count, blob count, Vectorize binding, and latest run when present.\n- \\`--json\\` prints 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 from \\`GET /api/harness/knowledges/audiences\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges audiences [--json]\n\\`\\`\\`\n\nUse 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\nRun semantic search against the Cloudflare Vectorize-backed Harness index.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges search <query> [--limit <n>] [--json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`5\\`\n\n## Example\n\n\\`\\`\\`bash\ncngkit knowledges search \"cloudflare backend\" --limit 3\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges list\",\n    aliases: [\"knowledges-list\", \"list\"],\n    body: `# cngkit knowledges list\n\nList known subskills from \\`GET /api/harness/knowledges/subskills\\`, optionally filtered locally by query.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges list [query] [--limit <n>] [--json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`25\\`\n`,\n  },\n  {\n    title: \"knowledges files\",\n    aliases: [\"knowledges-files\", \"files\"],\n    body: `# cngkit knowledges files\n\nList uploaded catalog files from \\`GET /api/harness/knowledges/files\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges files [query] [--audience <id>] [--limit <n>] [--json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`25\\`\n- \\`--audience\\`: omitted\n\nRun \\`cngkit knowledges audiences\\` to discover supported audience ids.\n`,\n  },\n  {\n    title: \"knowledges read\",\n    aliases: [\"knowledges-read\", \"read\"],\n    body: `# cngkit knowledges read\n\nClaude-style read tool for hosted Harness catalog files. Backed by \\`GET /api/harness/filesystem/read\\` and \\`HarnessReadQuerySchema\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges read <file-path> [--offset <n>] [--limit <n>] [--json]\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 Contract\n\n- Text mode prints only the returned file content first.\n- If truncated, a final bracketed truncation note is printed after the content.\n- \\`--json\\` prints \\`{ file_path, content, total_lines, offset, limit, truncated }\\`.\n\n## Example\n\n\\`\\`\\`bash\ncngkit 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\nClaude-style grep tool for hosted Harness catalog files. Backed by \\`GET /api/harness/filesystem/grep\\` and \\`HarnessGrepQuerySchema\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges grep <pattern> [--path <path>] [--include <glob>] [--output-mode <mode>] [--context <n>] [--case-insensitive] [--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 Contract\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- \\`--json\\` prints the typed backend response union.\n\n## Examples\n\n\\`\\`\\`bash\ncngkit knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches\ncngkit knowledges grep \"Vectorize|D1\" --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\nClaude-style glob tool for hosted Harness catalog files. Backed by \\`GET /api/harness/filesystem/glob\\` and \\`HarnessGlobQuerySchema\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges glob [pattern] [--path <path>] [--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 Contract\n\n- Text mode prints one file path per line.\n- If truncated, a final bracketed truncation note is printed.\n- \\`--json\\` prints \\`{ files, total_files, truncated }\\`.\n\n## Example\n\n\\`\\`\\`bash\ncngkit knowledges glob \"**/*.md\" --path /libraries/lib-cloudflare\n\\`\\`\\`\n`,\n  },\n];\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  return (helpTopicByAlias.get(normalizedTopicName) ?? helpTopicByAlias.get(\"\"))?.body.trim() ?? \"\";\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"],"mappings":"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","names":[]}

package/dist/{chunk-LWZPSJVC.js → chunk-UVBB3UAV.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-QZEB4VMX.js";
 import {
   createCngApiClient
-} from "./chunk-CHSTTMTO.js";
+} from "./chunk-CYT46QDQ.js";
 
 // src/features/knowledges/knowledges-api.ts
 function createKnowledgesApi(options) {
@@ -316,4 +316,4 @@ export {
   runKnowGrepCommand,
   runKnowGlobCommand
 };
-//# sourceMappingURL=chunk-LWZPSJVC.js.map
+//# sourceMappingURL=chunk-UVBB3UAV.js.map

package/dist/{chunk-NTF45QBC.js → chunk-VCURAGDZ.js}

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

package/dist/cli.js

@@ -2,14 +2,14 @@
 import {
   formatCngkitHelp,
   formatKnowledgesHelp
-} from "./chunk-WPBMAXXM.js";
+} from "./chunk-S6LINZSY.js";
 import {
   packageVersion
-} from "./chunk-575IBOIA.js";
+} from "./chunk-MKVQWJHQ.js";
 import {
   consoleOutput,
   formatError
-} from "./chunk-OTQRKCFP.js";
+} from "./chunk-7Z74PS5X.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/cli.ts

package/dist/commands/coderoom/index.js

@@ -1,13 +1,13 @@
 import {
   formatCngkitHelp
-} from "../../chunk-WPBMAXXM.js";
+} from "../../chunk-S6LINZSY.js";
 import {
   GlobalOptionsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/coderoom/index.tsx

package/dist/commands/coderoom/join.js

@@ -1,16 +1,16 @@
 import {
   runJoinCommand
-} from "../../chunk-OKKJBRUU.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+} from "../../chunk-GEJEYWUR.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   GlobalOptionsSchema,
   RequiredRoomCodeArgsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/coderoom/join.tsx

package/dist/commands/coderoom/share.js

@@ -1,16 +1,16 @@
 import {
   runShareCommand
-} from "../../chunk-OKKJBRUU.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+} from "../../chunk-GEJEYWUR.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   GlobalOptionsSchema,
   OptionalRoomCodeArgsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/coderoom/share.tsx

package/dist/commands/index.js

@@ -1,10 +1,10 @@
 import {
   formatCngkitHelp
-} from "../chunk-WPBMAXXM.js";
+} from "../chunk-S6LINZSY.js";
 import {
   CommandRunner
-} from "../chunk-NTF45QBC.js";
-import "../chunk-OTQRKCFP.js";
+} from "../chunk-VCURAGDZ.js";
+import "../chunk-7Z74PS5X.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/commands/index.tsx

package/dist/commands/knowledges/audiences.js

@@ -1,17 +1,17 @@
 import {
   runKnowAudiencesCommand
-} from "../../chunk-LWZPSJVC.js";
+} from "../../chunk-UVBB3UAV.js";
 import "../../chunk-QZEB4VMX.js";
-import "../../chunk-WPBMAXXM.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+import "../../chunk-S6LINZSY.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   JsonOutputOptionsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/audiences.tsx

package/dist/commands/knowledges/files.js

@@ -1,18 +1,18 @@
 import {
   runKnowFilesCommand
-} from "../../chunk-LWZPSJVC.js";
+} from "../../chunk-UVBB3UAV.js";
 import "../../chunk-QZEB4VMX.js";
-import "../../chunk-WPBMAXXM.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+import "../../chunk-S6LINZSY.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   JsonOutputOptionsSchema,
   OptionalQueryArgsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/files.tsx

package/dist/commands/knowledges/glob.js

@@ -1,18 +1,18 @@
 import {
   runKnowGlobCommand
-} from "../../chunk-LWZPSJVC.js";
+} from "../../chunk-UVBB3UAV.js";
 import "../../chunk-QZEB4VMX.js";
-import "../../chunk-WPBMAXXM.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+import "../../chunk-S6LINZSY.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   LimitOptionsSchema,
   OptionalGlobPatternArgsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/glob.tsx

package/dist/commands/knowledges/grep.js

@@ -1,18 +1,18 @@
 import {
   runKnowGrepCommand
-} from "../../chunk-LWZPSJVC.js";
+} from "../../chunk-UVBB3UAV.js";
 import "../../chunk-QZEB4VMX.js";
-import "../../chunk-WPBMAXXM.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+import "../../chunk-S6LINZSY.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   LimitOptionsSchema,
   RequiredPatternArgsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/grep.tsx

package/dist/commands/knowledges/index.js

@@ -1,13 +1,13 @@
 import {
   formatKnowledgesHelp
-} from "../../chunk-WPBMAXXM.js";
+} from "../../chunk-S6LINZSY.js";
 import {
   GlobalOptionsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/index.tsx

package/dist/commands/knowledges/list.js

@@ -1,18 +1,18 @@
 import {
   runKnowListCommand
-} from "../../chunk-LWZPSJVC.js";
+} from "../../chunk-UVBB3UAV.js";
 import "../../chunk-QZEB4VMX.js";
-import "../../chunk-WPBMAXXM.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+import "../../chunk-S6LINZSY.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   LimitOptionsSchema,
   OptionalQueryArgsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/list.tsx

package/dist/commands/knowledges/read.js

@@ -1,18 +1,18 @@
 import {
   runKnowReadCommand
-} from "../../chunk-LWZPSJVC.js";
+} from "../../chunk-UVBB3UAV.js";
 import "../../chunk-QZEB4VMX.js";
-import "../../chunk-WPBMAXXM.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+import "../../chunk-S6LINZSY.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   JsonOutputOptionsSchema,
   RequiredFilePathArgsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/read.tsx

package/dist/commands/knowledges/search.js

@@ -1,18 +1,18 @@
 import {
   runKnowSearchCommand
-} from "../../chunk-LWZPSJVC.js";
+} from "../../chunk-UVBB3UAV.js";
 import "../../chunk-QZEB4VMX.js";
-import "../../chunk-WPBMAXXM.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+import "../../chunk-S6LINZSY.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   LimitOptionsSchema,
   RequiredQueryArgsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/search.tsx

package/dist/commands/knowledges/status.js

@@ -1,17 +1,17 @@
 import {
   runKnowStatusCommand
-} from "../../chunk-LWZPSJVC.js";
+} from "../../chunk-UVBB3UAV.js";
 import "../../chunk-QZEB4VMX.js";
-import "../../chunk-WPBMAXXM.js";
-import "../../chunk-CHSTTMTO.js";
-import "../../chunk-575IBOIA.js";
+import "../../chunk-S6LINZSY.js";
+import "../../chunk-CYT46QDQ.js";
+import "../../chunk-MKVQWJHQ.js";
 import {
   JsonOutputOptionsSchema
 } from "../../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../../chunk-NTF45QBC.js";
-import "../../chunk-OTQRKCFP.js";
+} from "../../chunk-VCURAGDZ.js";
+import "../../chunk-7Z74PS5X.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/status.tsx

package/dist/commands/login.js

@@ -1,13 +1,13 @@
 import {
   resolveApiBaseUrl
-} from "../chunk-575IBOIA.js";
+} from "../chunk-MKVQWJHQ.js";
 import {
   GlobalOptionsSchema
 } from "../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../chunk-NTF45QBC.js";
-import "../chunk-OTQRKCFP.js";
+} from "../chunk-VCURAGDZ.js";
+import "../chunk-7Z74PS5X.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/shared/browser.ts

package/dist/commands/scrub.js

@@ -4,8 +4,8 @@ import {
 } from "../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../chunk-NTF45QBC.js";
-import "../chunk-OTQRKCFP.js";
+} from "../chunk-VCURAGDZ.js";
+import "../chunk-7Z74PS5X.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/commands/scrub.tsx

package/dist/commands/transcripts.js

@@ -6,15 +6,15 @@ import {
 } from "../chunk-QZEB4VMX.js";
 import {
   formatCngkitHelp
-} from "../chunk-WPBMAXXM.js";
+} from "../chunk-S6LINZSY.js";
 import {
   GlobalOptionsSchema,
   TranscriptArgsSchema
 } from "../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../chunk-NTF45QBC.js";
-import "../chunk-OTQRKCFP.js";
+} from "../chunk-VCURAGDZ.js";
+import "../chunk-7Z74PS5X.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/commands/transcripts.tsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cngkit",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "Opinionated Curly.ng CLI kit for Coderoom collaboration and website tooling.",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "dist",
+    "scripts/*.sh",
     "LICENSE",
     "README.md"
   ],
@@ -44,6 +45,7 @@
     "pastel": "^4.0.1",
     "react": "^19.2.7",
     "react-devtools-core": "^6.1.5",
+    "strip-ansi": "7.1.2",
     "ws": "^8.20.1",
     "zod": "^4.4.3"
   },

package/scripts/deploy.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "${BASH_SOURCE[0]}")/.."
+
+package_name="$(node -p "require('./package.json').name")"
+package_version="$(node -p "require('./package.json').version")"
+publish_log="$(mktemp)"
+
+cleanup() {
+  rm -f "$publish_log"
+}
+
+wait_for_latest_version() {
+  for attempt in {1..10}; do
+    latest_version="$(npm view "${package_name}" version --json | tr -d '"')"
+    if [ "$latest_version" = "$package_version" ]; then
+      return 0
+    fi
+
+    echo "npm latest is ${latest_version}, waiting for ${package_version} (${attempt}/10)"
+    sleep 3
+  done
+
+  echo "npm latest is ${latest_version}, expected ${package_version}" >&2
+  return 1
+}
+
+trap cleanup EXIT
+
+echo "Deploying ${package_name}@${package_version}"
+
+pnpm run typecheck
+pnpm run lint
+pnpm run build
+pnpm run smoke
+npm pack --json --dry-run >/dev/null
+
+if npm publish --access public 2>&1 | tee "$publish_log"; then
+  echo "Published ${package_name}@${package_version}"
+elif grep -q "previously published versions" "$publish_log"; then
+  registry_version="$(npm view "${package_name}@${package_version}" version --json 2>/dev/null | tr -d '"')"
+  if [ "$registry_version" != "$package_version" ]; then
+    echo "Publish failed and registry does not have ${package_name}@${package_version}" >&2
+    exit 1
+  fi
+  echo "${package_name}@${package_version} is already present on npm; continuing with install verification"
+else
+  echo "Publish failed" >&2
+  exit 1
+fi
+
+wait_for_latest_version
+
+npm install -g "${package_name}@latest"
+
+installed_version="$(cngkit --version)"
+if [ "$installed_version" != "$package_version" ]; then
+  echo "Global cngkit is ${installed_version}, expected ${package_version}" >&2
+  exit 1
+fi
+
+npx --yes "${package_name}@latest" --version
+
+echo "Deployed and installed ${package_name}@${package_version}"

package/scripts/smoke-docker.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+package_version="$(node -p 'require("./package.json").version')"
+package_file="cngkit-${package_version}.tgz"
+package_path="/tmp/${package_file}"
+
+pnpm run build
+npm pack --pack-destination /tmp
+
+cleanup() {
+  rm -f "${package_path}"
+}
+trap cleanup EXIT
+
+docker run --rm \
+  -v /tmp:/pkg \
+  node:22-alpine \
+  sh -lc "node --version && npm --version && npx --yes --package /pkg/${package_file} cngkit --version && npx --yes --package /pkg/${package_file} cngkit coderoom --api-base-url https://curly.ng --help"

package/dist/chunk-575IBOIA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/config.ts"],"sourcesContent":["import { randomBytes, randomUUID } from \"node:crypto\";\nimport process from \"node:process\";\n\nexport const packageVersion = \"1.1.9\";\nexport const defaultApiBaseUrl = \"https://curly.ng\";\n\nexport type GlobalCommandOptions = {\n  apiBaseUrl?: string;\n};\n\nexport function resolveApiBaseUrl(options: GlobalCommandOptions): string {\n  return options.apiBaseUrl ?? process.env.CNGKIT_API_BASE_URL ?? defaultApiBaseUrl;\n}\n\nexport function createRoomCode(): string {\n  return randomBytes(4).toString(\"hex\").toUpperCase();\n}\n\nexport function createPeerId(): string {\n  return randomUUID();\n}\n"],"mappings":";AAAA,SAAS,aAAa,kBAAkB;AACxC,OAAO,aAAa;AAEb,IAAM,iBAAiB;AACvB,IAAM,oBAAoB;AAM1B,SAAS,kBAAkB,SAAuC;AACvE,SAAO,QAAQ,cAAc,QAAQ,IAAI,uBAAuB;AAClE;AAEO,SAAS,iBAAyB;AACvC,SAAO,YAAY,CAAC,EAAE,SAAS,KAAK,EAAE,YAAY;AACpD;AAEO,SAAS,eAAuB;AACrC,SAAO,WAAW;AACpB;","names":[]}

package/dist/chunk-OTQRKCFP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/output.ts","../src/shared/theme.ts"],"sourcesContent":["import process from \"node:process\";\nimport { Marked, type MarkedExtension } from \"marked\";\nimport { markedTerminal } from \"marked-terminal\";\nimport { createElement } from \"react\";\nimport { renderToString, Text } from \"ink\";\nimport {\n  createMarkdownTheme,\n  statusStylePropsByOutputStyle,\n  type OutputStyle,\n} from \"./theme.js\";\n\ntype OutputStream = NodeJS.WriteStream & {\n  isTTY?: boolean;\n  columns?: number;\n};\n\nexport type CommandOutput = {\n  info(message: string): void;\n  success(message: string): void;\n  warning(message: string): void;\n  muted(message: string): void;\n  markdown(message: string): void;\n  raw(message: string): void;\n  error(message: string): void;\n};\n\nexport const consoleOutput = createCommandOutput(process.stdout, process.stderr);\n\nexport function createCommandOutput(stdout: OutputStream, stderr: OutputStream): CommandOutput {\n  return {\n    info(message) {\n      writeStyledMessage(stdout, \"info\", message);\n    },\n    success(message) {\n      writeStyledMessage(stdout, \"success\", message);\n    },\n    warning(message) {\n      writeStyledMessage(stdout, \"warning\", message);\n    },\n    muted(message) {\n      writeStyledMessage(stdout, \"muted\", message);\n    },\n    markdown(message) {\n      stdout.write(`${formatMarkdownMessage(stdout, message)}\\n`);\n    },\n    raw(message) {\n      stdout.write(`${message}\\n`);\n    },\n    error(message) {\n      writeStyledMessage(stderr, \"error\", message);\n    },\n  };\n}\n\nexport function formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction writeStyledMessage(stream: OutputStream, style: OutputStyle, message: string): void {\n  stream.write(`${formatStyledMessage(stream, style, message)}\\n`);\n}\n\nfunction formatStyledMessage(stream: OutputStream, style: OutputStyle, message: string): string {\n  if (!shouldRenderColor(stream)) {\n    return message;\n  }\n\n  return renderToString(\n    createElement(\n      Text,\n      {\n        ...statusStylePropsByOutputStyle[style],\n        wrap: \"wrap\",\n      },\n      message\n    ),\n    {\n      columns: 10_000,\n    }\n  );\n}\n\nfunction formatMarkdownMessage(stream: OutputStream, markdown: string): string {\n  if (stream.isTTY !== true) {\n    return markdown;\n  }\n\n  const parser = new Marked();\n  parser.use(\n    markedTerminal({\n      ...createMarkdownTheme(shouldRenderColor(stream)),\n      width: clampMarkdownWidth(stream.columns),\n    }) as unknown as MarkedExtension\n  );\n\n  return String(parser.parse(markdown)).trimEnd();\n}\n\nfunction shouldRenderColor(stream: OutputStream): boolean {\n  return stream.isTTY === true && process.env.NO_COLOR === undefined;\n}\n\nfunction clampMarkdownWidth(columns: number | undefined): number {\n  if (columns === undefined) {\n    return 100;\n  }\n\n  return Math.max(72, Math.min(columns, 120));\n}\n","import { Chalk } from \"chalk\";\nimport type { TextProps } from \"ink\";\n\nexport type OutputStyle = \"info\" | \"success\" | \"warning\" | \"muted\" | \"error\";\n\nexport const statusStylePropsByOutputStyle = {\n  info: {\n    color: \"cyan\",\n  },\n  success: {\n    color: \"green\",\n    bold: true,\n  },\n  warning: {\n    color: \"yellow\",\n    bold: true,\n  },\n  muted: {\n    dimColor: true,\n  },\n  error: {\n    color: \"red\",\n    bold: true,\n  },\n} satisfies Record<OutputStyle, TextProps>;\n\nexport function createMarkdownTheme(useColor: boolean) {\n  const chalk = new Chalk({ level: useColor ? 1 : 0 });\n\n  return {\n    code: chalk.yellow,\n    blockquote: chalk.gray.italic,\n    html: chalk.gray,\n    heading: chalk.cyan.bold,\n    firstHeading: chalk.green.bold,\n    hr: chalk.dim,\n    listitem: chalk.reset,\n    table: chalk.reset,\n    paragraph: chalk.reset,\n    strong: chalk.bold,\n    em: chalk.italic,\n    codespan: chalk.yellow,\n    del: chalk.dim.strikethrough,\n    link: chalk.cyan,\n    href: chalk.blue.underline,\n    text: chalk.reset,\n    showSectionPrefix: true,\n    reflowText: true,\n    unescape: true,\n    emoji: false,\n    tab: 2,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-WPBMAXXM.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.\",\n  \"`cngkit coderoom ...` - unite developers in a live shared code room.\",\n  \"`cngkit scrub [path]` - scan for secrets and optionally mask them inline.\",\n  \"`cngkit transcripts ...` - list, read, and grep local Claude/Codex transcripts.\",\n  \"`cngkit knowledges ...` - read the hosted Harness 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>` - semantic search over Cloudflare Vectorize-backed 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 backend-connected repo sync, secret scrubbing, and Harness knowledges access.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit <command> [options]\n\\`\\`\\`\n\n## Commands\n\n${commandList}\n\n## Progressive Help\n\n\\`\\`\\`bash\ncngkit <command> --help\ncngkit coderoom --help\ncngkit coderoom <subcommand> --help\ncngkit transcripts --help\ncngkit knowledges --help\ncngkit knowledges <subcommand> --help\n\\`\\`\\`\n\nThe CLI intentionally prints plain Markdown or line-oriented text with no color-only state, tables that require terminal width, or hidden interactive prompts. Add \\`--json\\` to read-only knowledges commands when another agent or tool needs structured backend data.\n\n## Backend\n\nDefault API: \\`https://curly.ng\\`\n\nOverride with:\n\n\\`\\`\\`bash\ncngkit --api-base-url <url> ...\nCNGKIT_API_BASE_URL=<url> cngkit ...\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"login\",\n    aliases: [\"login\"],\n    body: `# cngkit login\n\nOpen Curly.ng login in a browser. In headless environments, print the URL so an agent can surface it to the operator.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit login\n\\`\\`\\`\n\n## Output Contract\n\n- First line names the login URL being opened.\n- If no local 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 agent transcript JSONL files from \\`~/.codex/sessions\\`, \\`~/.codex/archived_sessions\\`, \\`~/.claude/projects\\`, and \\`~/.claude/history.jsonl\\`.\n\nThis is local operator tooling. It does not call the Curly backend and it does not upload transcript content.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit transcripts list [--source all|codex|claude] [--limit <n>] [--json]\ncngkit transcripts read <path-or-session-id> [--source all|codex|claude] [--limit <n>] [--include-internal] [--json]\ncngkit transcripts grep <query> [--source all|codex|claude] [--limit <n>] [--file-limit <n>] [--include-internal] [--json]\n\\`\\`\\`\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 Contract\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\nCoderoom is the fast way to unite developers around one working tree. It gives a pair or team a temporary shared room over the Curly backend so one developer can share local file changes and another can join from their own machine.\n\nIt is intentionally closer to a Drive-like project room than a raw socket command: the room code is the shared folder link, each connected machine is a collaborator, and the file stream is the activity feed. The browser experience at \\`/coderoom\\` provides the helper surface for copying commands and explaining the room model.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom <subcommand> [options]\n\\`\\`\\`\n\n## Subcommands\n\n${coderoomCommandList}\n\n## Common Flow\n\n\\`\\`\\`bash\ncngkit coderoom share\ncngkit coderoom join <room-code>\n\\`\\`\\`\n\n## Backend Contract\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. The Drive-like frontend is the collaboration shell around that live primitive.\n`,\n  },\n  {\n    title: \"coderoom share\",\n    aliases: [\"coderoom-share\"],\n    body: `# cngkit coderoom share\n\nStart a real-time repository sync room from the current directory.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom share [room-code]\n\\`\\`\\`\n\n## Backend Contract\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 Contract\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 real-time repository sync room in the current directory.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom join <room-code>\n\\`\\`\\`\n\n## Backend Contract\n\nSame transport and filesystem contract as \\`cngkit coderoom share\\`. The supplied room code selects the Durable Object room.\n\n## Output Contract\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. Inline masking requires \\`--yes\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit scrub [path]\ncngkit scrub [path] --yes\n\\`\\`\\`\n\n## Requirements\n\n- \\`trufflehog\\` must be available on \\`PATH\\`.\n\n## Safety Contract\n\n- Default mode does not rewrite files.\n- \\`--yes\\` rewrites detected secret values inline with \\`[CNGKIT_SECRET:<detector>:<verified|unverified>]\\` placeholders.\n- \\`--mask\\` is accepted as a compatibility alias, but still requires \\`--yes\\`.\n- Raw and redacted secret values are never printed in the report.\n`,\n  },\n  {\n    title: \"knowledges\",\n    aliases: [\"knowledges\", \"knowledge\"],\n    body: `# cngkit knowledges\n\nRead the hosted Harness knowledges catalog from the Curly backend. These commands are read-only and use the generated \\`@cng/client\\` SDK against public backend routes.\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 knowledges <subcommand> --help\ncngkit knowledges read --help\ncngkit knowledges grep --help\ncngkit knowledges glob --help\n\\`\\`\\`\n\n## Common Examples\n\n\\`\\`\\`bash\ncngkit knowledges search \"cloudflare backend\" --limit 3\ncngkit knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80\ncngkit knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches\ncngkit knowledges glob \"**/*.md\" --path /libraries/lib-cloudflare\n\\`\\`\\`\n\n## AI-Friendly Output\n\n- Default output is line-oriented and intended to be directly usable by agents.\n- \\`read\\` prints file content with no wrapper before any truncation note.\n- \\`grep --output-mode content\\` prints \\`path:line\\` blocks.\n- \\`grep --output-mode files_with_matches\\` and \\`glob\\` print one path per line.\n- \\`--json\\` prints the typed backend data payload 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 from \\`GET /api/harness/knowledges/catalog\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges status [--json]\n\\`\\`\\`\n\n## Output Contract\n\n- Text mode prints catalog name, file count, blob count, Vectorize binding, and latest run when present.\n- \\`--json\\` prints 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 from \\`GET /api/harness/knowledges/audiences\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges audiences [--json]\n\\`\\`\\`\n\nUse 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\nRun semantic search against the Cloudflare Vectorize-backed Harness index.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges search <query> [--limit <n>] [--json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`5\\`\n\n## Example\n\n\\`\\`\\`bash\ncngkit knowledges search \"cloudflare backend\" --limit 3\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges list\",\n    aliases: [\"knowledges-list\", \"list\"],\n    body: `# cngkit knowledges list\n\nList known subskills from \\`GET /api/harness/knowledges/subskills\\`, optionally filtered locally by query.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges list [query] [--limit <n>] [--json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`25\\`\n`,\n  },\n  {\n    title: \"knowledges files\",\n    aliases: [\"knowledges-files\", \"files\"],\n    body: `# cngkit knowledges files\n\nList uploaded catalog files from \\`GET /api/harness/knowledges/files\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges files [query] [--audience <id>] [--limit <n>] [--json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`25\\`\n- \\`--audience\\`: omitted\n\nRun \\`cngkit knowledges audiences\\` to discover supported audience ids.\n`,\n  },\n  {\n    title: \"knowledges read\",\n    aliases: [\"knowledges-read\", \"read\"],\n    body: `# cngkit knowledges read\n\nClaude-style read tool for hosted Harness catalog files. Backed by \\`GET /api/harness/filesystem/read\\` and \\`HarnessReadQuerySchema\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges read <file-path> [--offset <n>] [--limit <n>] [--json]\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 Contract\n\n- Text mode prints only the returned file content first.\n- If truncated, a final bracketed truncation note is printed after the content.\n- \\`--json\\` prints \\`{ file_path, content, total_lines, offset, limit, truncated }\\`.\n\n## Example\n\n\\`\\`\\`bash\ncngkit 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\nClaude-style grep tool for hosted Harness catalog files. Backed by \\`GET /api/harness/filesystem/grep\\` and \\`HarnessGrepQuerySchema\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges grep <pattern> [--path <path>] [--include <glob>] [--output-mode <mode>] [--context <n>] [--case-insensitive] [--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 Contract\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- \\`--json\\` prints the typed backend response union.\n\n## Examples\n\n\\`\\`\\`bash\ncngkit knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches\ncngkit knowledges grep \"Vectorize|D1\" --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\nClaude-style glob tool for hosted Harness catalog files. Backed by \\`GET /api/harness/filesystem/glob\\` and \\`HarnessGlobQuerySchema\\`.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges glob [pattern] [--path <path>] [--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 Contract\n\n- Text mode prints one file path per line.\n- If truncated, a final bracketed truncation note is printed.\n- \\`--json\\` prints \\`{ files, total_files, truncated }\\`.\n\n## Example\n\n\\`\\`\\`bash\ncngkit knowledges glob \"**/*.md\" --path /libraries/lib-cloudflare\n\\`\\`\\`\n`,\n  },\n];\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  return (helpTopicByAlias.get(normalizedTopicName) ?? helpTopicByAlias.get(\"\"))?.body.trim() ?? \"\";\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"],"mappings":"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","names":[]}