cngkit 1.1.5 → 1.1.7

package/dist/commands/transcripts.js

@@ -1,20 +1,391 @@
 import {
-  runTranscriptCommand
-} from "../chunk-UXMP5Z5P.js";
-import "../chunk-TZRXQ6GR.js";
+  coerceLimit,
+  formatJson,
+  optionalJoinedArgument,
+  singleLine
+} from "../chunk-QZEB4VMX.js";
+import {
+  formatCngkitHelp
+} from "../chunk-VI5XQH3U.js";
 import {
   GlobalOptionsSchema,
   TranscriptArgsSchema
-} from "../chunk-YY2VGJ5N.js";
+} from "../chunk-MLKBG5YJ.js";
 import {
   CommandRunner
-} from "../chunk-SNTLRTQ2.js";
-import "../chunk-SSRUN6G5.js";
+} from "../chunk-Z4DDLEWR.js";
+import "../chunk-XDXRVTPK.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/commands/transcripts.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/transcripts/reader.ts
+import { promises as fs } from "fs";
+import os from "os";
+import path from "path";
+var TranscriptSourceNames = ["codex", "claude"];
+async function listTranscriptRecords(options2) {
+  const files = await discoverTranscriptFiles(options2.source);
+  const records = await Promise.all(files.slice(0, options2.limit).map(readTranscriptRecord));
+  return records;
+}
+async function readTranscriptEntries(options2) {
+  const file = await resolveTranscriptFile(options2.source, options2.target);
+  const entries = await readEntriesFromFile(file, options2.includeInternal);
+  return entries.slice(Math.max(0, entries.length - options2.limit));
+}
+async function grepTranscriptEntries(options2) {
+  const files = await discoverTranscriptFiles(options2.source);
+  const normalizedQuery = options2.query.toLowerCase();
+  const matches = [];
+  for (const file of files.slice(0, options2.fileLimit)) {
+    const entries = await readEntriesFromFile(file, options2.includeInternal);
+    for (const entry of entries) {
+      if (entry.text.toLowerCase().includes(normalizedQuery)) {
+        matches.push(entry);
+      }
+      if (matches.length >= options2.limit) {
+        return matches;
+      }
+    }
+  }
+  return matches;
+}
+async function discoverTranscriptFiles(source) {
+  const sources = source === "all" ? TranscriptSourceNames : [source];
+  const records = await Promise.all(sources.flatMap((sourceName) => sourceRoots(sourceName)));
+  return records.flat().sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+}
+function sourceRoots(source) {
+  if (source === "codex") {
+    return [
+      discoverJsonlFiles("codex", expandHome("~/.codex/sessions")),
+      discoverJsonlFiles("codex", expandHome("~/.codex/archived_sessions"))
+    ];
+  }
+  return [
+    discoverJsonlFiles("claude", expandHome("~/.claude/projects")),
+    discoverJsonlFiles("claude", expandHome("~/.claude/history.jsonl"))
+  ];
+}
+async function discoverJsonlFiles(source, rootPath) {
+  const stat = await statIfExists(rootPath);
+  if (!stat) {
+    return [];
+  }
+  if (stat.isFile()) {
+    return [await recordFromPath(source, rootPath, stat.mtime)];
+  }
+  const records = [];
+  const entries = await fs.readdir(rootPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const entryPath = path.join(rootPath, entry.name);
+    if (entry.isDirectory()) {
+      records.push(...await discoverJsonlFiles(source, entryPath));
+      continue;
+    }
+    if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+      const entryStat = await fs.stat(entryPath);
+      records.push(await recordFromPath(source, entryPath, entryStat.mtime));
+    }
+  }
+  return records;
+}
+async function recordFromPath(source, filePath, mtime) {
+  return {
+    source,
+    filePath,
+    updatedAt: mtime.toISOString()
+  };
+}
+async function readTranscriptRecord(record) {
+  const metadata = await readMetadataFromFile(record.source, record.filePath);
+  return {
+    ...record,
+    ...metadata
+  };
+}
+async function readMetadataFromFile(source, filePath) {
+  const lines = await readJsonlLines(filePath, 80);
+  for (const line of lines) {
+    const parsed = parseJsonObject(line);
+    if (!parsed) {
+      continue;
+    }
+    if (source === "codex") {
+      const payload = asObject(parsed.payload);
+      if (parsed.type === "session_meta" && payload) {
+        return {
+          cwd: readString(payload.cwd),
+          sessionId: readString(payload.session_id) ?? readString(payload.id),
+          title: readString(payload.cwd)
+        };
+      }
+    }
+    if (source === "claude") {
+      const message = asObject(parsed.message);
+      const role = readString(message?.role) ?? readString(parsed.type);
+      const content = message ? extractContentText(message.content) : readString(parsed.content);
+      if (content && (role === "user" || role === "assistant")) {
+        return {
+          cwd: readString(parsed.cwd) ?? readString(parsed.project),
+          sessionId: readString(parsed.sessionId),
+          title: truncateSingleLine(content, 120)
+        };
+      }
+    }
+  }
+  return {
+    sessionId: path.basename(filePath, ".jsonl")
+  };
+}
+async function resolveTranscriptFile(source, target) {
+  const expandedTarget = expandHome(target);
+  const directStat = await statIfExists(expandedTarget);
+  if (directStat?.isFile()) {
+    return recordFromPath(detectSourceFromPath(expandedTarget), expandedTarget, directStat.mtime);
+  }
+  const files = await discoverTranscriptFiles(source);
+  const normalizedTarget = target.toLowerCase();
+  const match = files.find((file) => {
+    return file.filePath.toLowerCase().includes(normalizedTarget) || file.sessionId?.toLowerCase().includes(normalizedTarget);
+  });
+  if (!match) {
+    throw new Error(`No transcript matched "${target}". Run cngkit transcripts list first.`);
+  }
+  return match;
+}
+async function readEntriesFromFile(record, includeInternal) {
+  const content = await fs.readFile(record.filePath, "utf8");
+  const entries = [];
+  for (const line of content.split("\n")) {
+    if (!line.trim()) {
+      continue;
+    }
+    const parsed = parseJsonObject(line);
+    if (!parsed) {
+      continue;
+    }
+    const entry = record.source === "codex" ? parseCodexEntry(record, parsed, includeInternal) : parseClaudeEntry(record, parsed, includeInternal);
+    if (entry) {
+      entries.push(entry);
+    }
+  }
+  return entries;
+}
+function parseCodexEntry(record, parsed, includeInternal) {
+  const payload = asObject(parsed.payload);
+  if (!payload || parsed.type !== "response_item") {
+    return void 0;
+  }
+  const role = readString(payload.role);
+  if (!role || !includeInternal && role !== "user" && role !== "assistant") {
+    return void 0;
+  }
+  const text = extractContentText(payload.content);
+  if (!text) {
+    return void 0;
+  }
+  return {
+    source: record.source,
+    filePath: record.filePath,
+    timestamp: readString(parsed.timestamp),
+    role,
+    text
+  };
+}
+function parseClaudeEntry(record, parsed, includeInternal) {
+  const message = asObject(parsed.message);
+  const role = readString(message?.role) ?? readString(parsed.type);
+  if (!role || !includeInternal && role !== "user" && role !== "assistant") {
+    return void 0;
+  }
+  const text = message ? extractContentText(message.content) : readString(parsed.content);
+  if (!text) {
+    return void 0;
+  }
+  return {
+    source: record.source,
+    filePath: record.filePath,
+    timestamp: readString(parsed.timestamp),
+    role,
+    text
+  };
+}
+function extractContentText(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const parts = value.flatMap((item) => {
+    if (typeof item === "string") {
+      return [item];
+    }
+    const objectItem = asObject(item);
+    if (!objectItem) {
+      return [];
+    }
+    return [readString(objectItem.text), readString(objectItem.content)].filter(
+      (part) => Boolean(part)
+    );
+  });
+  return parts.length > 0 ? parts.join("\n") : void 0;
+}
+async function readJsonlLines(filePath, limit) {
+  const content = await fs.readFile(filePath, "utf8");
+  return content.split("\n").filter(Boolean).slice(0, limit);
+}
+async function statIfExists(filePath) {
+  try {
+    return await fs.stat(filePath);
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  }
+}
+function parseJsonObject(line) {
+  try {
+    const parsed = JSON.parse(line);
+    return asObject(parsed);
+  } catch {
+    return void 0;
+  }
+}
+function asObject(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return void 0;
+}
+function readString(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function isNodeError(error) {
+  return error instanceof Error && "code" in error;
+}
+function expandHome(value) {
+  if (value === "~") {
+    return os.homedir();
+  }
+  if (value.startsWith("~/")) {
+    return path.join(os.homedir(), value.slice(2));
+  }
+  return value;
+}
+function detectSourceFromPath(filePath) {
+  return filePath.includes(`${path.sep}.claude${path.sep}`) ? "claude" : "codex";
+}
+function truncateSingleLine(value, maxLength) {
+  const line = value.replace(/\s+/g, " ").trim();
+  return line.length > maxLength ? `${line.slice(0, maxLength - 1)}...` : line;
+}
+
+// src/features/transcripts/run-transcript-command.ts
+async function runTranscriptCommand(args2, options2, output) {
+  const [action = "list", ...actionArgs] = args2 ?? [];
+  const source = normalizeTranscriptSource(options2.source);
+  const limit = coerceLimit(options2.limit, action === "list" ? 12 : 80, 500);
+  const includeInternal = options2.includeInternal === true;
+  switch (action) {
+    case "help":
+      output.info(formatCngkitHelp("transcripts"));
+      return;
+    case "list": {
+      const records = await listTranscriptRecords({ source, limit });
+      if (options2.json) {
+        output.info(formatJson({ records }));
+        return;
+      }
+      output.info(formatTranscriptRecords(records));
+      return;
+    }
+    case "read": {
+      const target = actionArgs[0];
+      if (!target) {
+        throw new Error("Missing transcript target. Usage: cngkit transcripts read <path-or-id>");
+      }
+      const entries = await readTranscriptEntries({
+        source,
+        target,
+        limit,
+        includeInternal
+      });
+      if (options2.json) {
+        output.info(formatJson({ entries }));
+        return;
+      }
+      output.info(formatTranscriptEntries(entries));
+      return;
+    }
+    case "grep": {
+      const query = optionalJoinedArgument(actionArgs);
+      if (!query) {
+        throw new Error("Missing query. Usage: cngkit transcripts grep <query>");
+      }
+      const entries = await grepTranscriptEntries({
+        source,
+        query,
+        limit,
+        fileLimit: coerceLimit(options2.fileLimit, 60, 5e3),
+        includeInternal
+      });
+      if (options2.json) {
+        output.info(formatJson({ entries }));
+        return;
+      }
+      output.info(formatTranscriptEntries(entries));
+      return;
+    }
+    default:
+      throw new Error("Unknown transcripts command. Usage: cngkit transcripts <list|read|grep>");
+  }
+}
+function formatTranscriptRecords(records) {
+  if (records.length === 0) {
+    return "No transcript files found.";
+  }
+  return records.map((record, index) => {
+    const title = record.title ? `
+  ${singleLine(record.title)}` : "";
+    const cwd = record.cwd ? `
+  cwd ${record.cwd}` : "";
+    const session = record.sessionId ? `
+  session ${record.sessionId}` : "";
+    return `${index + 1}. ${record.source} ${record.updatedAt}
+  ${record.filePath}${session}${cwd}${title}`;
+  }).join("\n");
+}
+function formatTranscriptEntries(entries) {
+  if (entries.length === 0) {
+    return "No transcript entries found.";
+  }
+  return entries.map((entry) => {
+    const when = entry.timestamp ? ` ${entry.timestamp}` : "";
+    return `[${entry.source}] ${entry.role}${when}
+${entry.text.trim()}`;
+  }).join("\n\n");
+}
+function normalizeTranscriptSource(value) {
+  if (value === void 0) {
+    return "all";
+  }
+  switch (value) {
+    case "all":
+    case "codex":
+    case "claude":
+      return value;
+    default:
+      throw new Error("Unknown transcript source. Use one of: all, codex, claude.");
+  }
+}
+
+// src/commands/transcripts.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "List, read, and grep local Claude/Codex transcript JSONL files";
 var args = TranscriptArgsSchema;

package/dist/commands/transcripts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/commands/transcripts.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { GlobalOptionsSchema, TranscriptArgsSchema } from \"../cli-options.js\";\nimport { runTranscriptCommand, type TranscriptCommandOptions } from \"../command-actions.js\";\nimport { CommandRunner } from \"../ink/command-runner.js\";\n\nexport const description = \"List, read, and grep local Claude/Codex transcript JSONL files\";\nexport const args = TranscriptArgsSchema;\nexport const options = GlobalOptionsSchema.extend({\n  source: z\n    .enum([\"all\", \"codex\", \"claude\"])\n    .optional()\n    .describe(\n      option({\n        description: \"Transcript source. Default: all\",\n        valueDescription: \"all|codex|claude\",\n      })\n    ),\n  limit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum records or entries\",\n        valueDescription: \"n\",\n      })\n    ),\n  fileLimit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum recent files to scan for grep\",\n        valueDescription: \"n\",\n      })\n    ),\n  includeInternal: z\n    .boolean()\n    .optional()\n    .describe(\n      option({\n        description: \"Include developer/system/internal transcript entries\",\n      })\n    ),\n  json: z\n    .boolean()\n    .optional()\n    .describe(\n      option({\n        description: \"Print raw JSON\",\n      })\n    ),\n});\n\ntype TranscriptsCommandProps = {\n  readonly args: string[];\n  readonly options: TranscriptCommandOptions;\n};\n\nexport default function TranscriptsCommand({ args, options }: TranscriptsCommandProps) {\n  return <CommandRunner run={(output) => runTranscriptCommand(args, options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;AA4DT;AAtDF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,oBAAoB,OAAO;AAAA,EAChD,QAAQ,EACL,KAAK,CAAC,OAAO,SAAS,QAAQ,CAAC,EAC/B,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,OAAO,EACJ,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,WAAW,EACR,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,iBAAiB,EACd,QAAQ,EACR,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AAAA,EACF,MAAM,EACH,QAAQ,EACR,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AACJ,CAAC;AAOc,SAAR,mBAAoC,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAA4B;AACrF,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,qBAAqBD,OAAMC,UAAS,MAAM,GAAG;AACtF;","names":["args","options"]}
+{"version":3,"sources":["../../src/commands/transcripts.tsx","../../src/features/transcripts/reader.ts","../../src/features/transcripts/run-transcript-command.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { GlobalOptionsSchema, TranscriptArgsSchema } from \"../cli/options.js\";\nimport { runTranscriptCommand, type TranscriptCommandOptions } from \"../features/transcripts/run-transcript-command.js\";\nimport { CommandRunner } from \"../cli/command-runner.js\";\n\nexport const description = \"List, read, and grep local Claude/Codex transcript JSONL files\";\nexport const args = TranscriptArgsSchema;\nexport const options = GlobalOptionsSchema.extend({\n  source: z\n    .enum([\"all\", \"codex\", \"claude\"])\n    .optional()\n    .describe(\n      option({\n        description: \"Transcript source. Default: all\",\n        valueDescription: \"all|codex|claude\",\n      })\n    ),\n  limit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum records or entries\",\n        valueDescription: \"n\",\n      })\n    ),\n  fileLimit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum recent files to scan for grep\",\n        valueDescription: \"n\",\n      })\n    ),\n  includeInternal: z\n    .boolean()\n    .optional()\n    .describe(\n      option({\n        description: \"Include developer/system/internal transcript entries\",\n      })\n    ),\n  json: z\n    .boolean()\n    .optional()\n    .describe(\n      option({\n        description: \"Print raw JSON\",\n      })\n    ),\n});\n\ntype TranscriptsCommandProps = {\n  readonly args: string[];\n  readonly options: TranscriptCommandOptions;\n};\n\nexport default function TranscriptsCommand({ args, options }: TranscriptsCommandProps) {\n  return <CommandRunner run={(output) => runTranscriptCommand(args, options, output)} />;\n}\n","import { promises as fs } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nexport const TranscriptSourceNames = [\"codex\", \"claude\"] as const;\n\nexport type TranscriptSourceName = (typeof TranscriptSourceNames)[number];\nexport type TranscriptScopeName = TranscriptSourceName | \"all\";\n\nexport type TranscriptRecord = {\n  readonly source: TranscriptSourceName;\n  readonly filePath: string;\n  readonly updatedAt: string;\n  readonly sessionId?: string;\n  readonly cwd?: string;\n  readonly title?: string;\n};\n\nexport type TranscriptEntry = {\n  readonly source: TranscriptSourceName;\n  readonly filePath: string;\n  readonly timestamp?: string;\n  readonly role: string;\n  readonly text: string;\n};\n\nexport type TranscriptListOptions = {\n  readonly source: TranscriptScopeName;\n  readonly limit: number;\n};\n\nexport type TranscriptReadOptions = {\n  readonly source: TranscriptScopeName;\n  readonly target: string;\n  readonly limit: number;\n  readonly includeInternal: boolean;\n};\n\nexport type TranscriptGrepOptions = {\n  readonly source: TranscriptScopeName;\n  readonly query: string;\n  readonly limit: number;\n  readonly fileLimit: number;\n  readonly includeInternal: boolean;\n};\n\ntype JsonObject = Record<string, unknown>;\n\nexport async function listTranscriptRecords(\n  options: TranscriptListOptions\n): Promise<TranscriptRecord[]> {\n  const files = await discoverTranscriptFiles(options.source);\n  const records = await Promise.all(files.slice(0, options.limit).map(readTranscriptRecord));\n  return records;\n}\n\nexport async function readTranscriptEntries(\n  options: TranscriptReadOptions\n): Promise<TranscriptEntry[]> {\n  const file = await resolveTranscriptFile(options.source, options.target);\n  const entries = await readEntriesFromFile(file, options.includeInternal);\n  return entries.slice(Math.max(0, entries.length - options.limit));\n}\n\nexport async function grepTranscriptEntries(\n  options: TranscriptGrepOptions\n): Promise<TranscriptEntry[]> {\n  const files = await discoverTranscriptFiles(options.source);\n  const normalizedQuery = options.query.toLowerCase();\n  const matches: TranscriptEntry[] = [];\n\n  for (const file of files.slice(0, options.fileLimit)) {\n    const entries = await readEntriesFromFile(file, options.includeInternal);\n\n    for (const entry of entries) {\n      if (entry.text.toLowerCase().includes(normalizedQuery)) {\n        matches.push(entry);\n      }\n\n      if (matches.length >= options.limit) {\n        return matches;\n      }\n    }\n  }\n\n  return matches;\n}\n\nasync function discoverTranscriptFiles(source: TranscriptScopeName): Promise<TranscriptRecord[]> {\n  const sources = source === \"all\" ? TranscriptSourceNames : [source];\n  const records = await Promise.all(sources.flatMap((sourceName) => sourceRoots(sourceName)));\n  return records\n    .flat()\n    .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));\n}\n\nfunction sourceRoots(source: TranscriptSourceName): Promise<TranscriptRecord[]>[] {\n  if (source === \"codex\") {\n    return [\n      discoverJsonlFiles(\"codex\", expandHome(\"~/.codex/sessions\")),\n      discoverJsonlFiles(\"codex\", expandHome(\"~/.codex/archived_sessions\")),\n    ];\n  }\n\n  return [\n    discoverJsonlFiles(\"claude\", expandHome(\"~/.claude/projects\")),\n    discoverJsonlFiles(\"claude\", expandHome(\"~/.claude/history.jsonl\")),\n  ];\n}\n\nasync function discoverJsonlFiles(\n  source: TranscriptSourceName,\n  rootPath: string\n): Promise<TranscriptRecord[]> {\n  const stat = await statIfExists(rootPath);\n  if (!stat) {\n    return [];\n  }\n\n  if (stat.isFile()) {\n    return [await recordFromPath(source, rootPath, stat.mtime)];\n  }\n\n  const records: TranscriptRecord[] = [];\n  const entries = await fs.readdir(rootPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(rootPath, entry.name);\n    if (entry.isDirectory()) {\n      records.push(...(await discoverJsonlFiles(source, entryPath)));\n      continue;\n    }\n\n    if (entry.isFile() && entry.name.endsWith(\".jsonl\")) {\n      const entryStat = await fs.stat(entryPath);\n      records.push(await recordFromPath(source, entryPath, entryStat.mtime));\n    }\n  }\n\n  return records;\n}\n\nasync function recordFromPath(\n  source: TranscriptSourceName,\n  filePath: string,\n  mtime: Date\n): Promise<TranscriptRecord> {\n  return {\n    source,\n    filePath,\n    updatedAt: mtime.toISOString(),\n  };\n}\n\nasync function readTranscriptRecord(record: TranscriptRecord): Promise<TranscriptRecord> {\n  const metadata = await readMetadataFromFile(record.source, record.filePath);\n  return {\n    ...record,\n    ...metadata,\n  };\n}\n\nasync function readMetadataFromFile(\n  source: TranscriptSourceName,\n  filePath: string\n): Promise<Pick<TranscriptRecord, \"cwd\" | \"sessionId\" | \"title\">> {\n  const lines = await readJsonlLines(filePath, 80);\n\n  for (const line of lines) {\n    const parsed = parseJsonObject(line);\n    if (!parsed) {\n      continue;\n    }\n\n    if (source === \"codex\") {\n      const payload = asObject(parsed.payload);\n      if (parsed.type === \"session_meta\" && payload) {\n        return {\n          cwd: readString(payload.cwd),\n          sessionId: readString(payload.session_id) ?? readString(payload.id),\n          title: readString(payload.cwd),\n        };\n      }\n    }\n\n    if (source === \"claude\") {\n      const message = asObject(parsed.message);\n      const role = readString(message?.role) ?? readString(parsed.type);\n      const content = message ? extractContentText(message.content) : readString(parsed.content);\n      if (content && (role === \"user\" || role === \"assistant\")) {\n        return {\n          cwd: readString(parsed.cwd) ?? readString(parsed.project),\n          sessionId: readString(parsed.sessionId),\n          title: truncateSingleLine(content, 120),\n        };\n      }\n    }\n  }\n\n  return {\n    sessionId: path.basename(filePath, \".jsonl\"),\n  };\n}\n\nasync function resolveTranscriptFile(\n  source: TranscriptScopeName,\n  target: string\n): Promise<TranscriptRecord> {\n  const expandedTarget = expandHome(target);\n  const directStat = await statIfExists(expandedTarget);\n  if (directStat?.isFile()) {\n    return recordFromPath(detectSourceFromPath(expandedTarget), expandedTarget, directStat.mtime);\n  }\n\n  const files = await discoverTranscriptFiles(source);\n  const normalizedTarget = target.toLowerCase();\n  const match = files.find((file) => {\n    return (\n      file.filePath.toLowerCase().includes(normalizedTarget) ||\n      file.sessionId?.toLowerCase().includes(normalizedTarget)\n    );\n  });\n\n  if (!match) {\n    throw new Error(`No transcript matched \"${target}\". Run cngkit transcripts list first.`);\n  }\n\n  return match;\n}\n\nasync function readEntriesFromFile(\n  record: TranscriptRecord,\n  includeInternal: boolean\n): Promise<TranscriptEntry[]> {\n  const content = await fs.readFile(record.filePath, \"utf8\");\n  const entries: TranscriptEntry[] = [];\n\n  for (const line of content.split(\"\\n\")) {\n    if (!line.trim()) {\n      continue;\n    }\n\n    const parsed = parseJsonObject(line);\n    if (!parsed) {\n      continue;\n    }\n\n    const entry =\n      record.source === \"codex\"\n        ? parseCodexEntry(record, parsed, includeInternal)\n        : parseClaudeEntry(record, parsed, includeInternal);\n\n    if (entry) {\n      entries.push(entry);\n    }\n  }\n\n  return entries;\n}\n\nfunction parseCodexEntry(\n  record: TranscriptRecord,\n  parsed: JsonObject,\n  includeInternal: boolean\n): TranscriptEntry | undefined {\n  const payload = asObject(parsed.payload);\n  if (!payload || parsed.type !== \"response_item\") {\n    return undefined;\n  }\n\n  const role = readString(payload.role);\n  if (!role || (!includeInternal && role !== \"user\" && role !== \"assistant\")) {\n    return undefined;\n  }\n\n  const text = extractContentText(payload.content);\n  if (!text) {\n    return undefined;\n  }\n\n  return {\n    source: record.source,\n    filePath: record.filePath,\n    timestamp: readString(parsed.timestamp),\n    role,\n    text,\n  };\n}\n\nfunction parseClaudeEntry(\n  record: TranscriptRecord,\n  parsed: JsonObject,\n  includeInternal: boolean\n): TranscriptEntry | undefined {\n  const message = asObject(parsed.message);\n  const role = readString(message?.role) ?? readString(parsed.type);\n\n  if (!role || (!includeInternal && role !== \"user\" && role !== \"assistant\")) {\n    return undefined;\n  }\n\n  const text = message ? extractContentText(message.content) : readString(parsed.content);\n  if (!text) {\n    return undefined;\n  }\n\n  return {\n    source: record.source,\n    filePath: record.filePath,\n    timestamp: readString(parsed.timestamp),\n    role,\n    text,\n  };\n}\n\nfunction extractContentText(value: unknown): string | undefined {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (!Array.isArray(value)) {\n    return undefined;\n  }\n\n  const parts = value.flatMap((item) => {\n    if (typeof item === \"string\") {\n      return [item];\n    }\n\n    const objectItem = asObject(item);\n    if (!objectItem) {\n      return [];\n    }\n\n    return [readString(objectItem.text), readString(objectItem.content)].filter(\n      (part): part is string => Boolean(part)\n    );\n  });\n\n  return parts.length > 0 ? parts.join(\"\\n\") : undefined;\n}\n\nasync function readJsonlLines(filePath: string, limit: number): Promise<string[]> {\n  const content = await fs.readFile(filePath, \"utf8\");\n  return content.split(\"\\n\").filter(Boolean).slice(0, limit);\n}\n\nasync function statIfExists(filePath: string) {\n  try {\n    return await fs.stat(filePath);\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return undefined;\n    }\n    throw error;\n  }\n}\n\nfunction parseJsonObject(line: string): JsonObject | undefined {\n  try {\n    const parsed: unknown = JSON.parse(line);\n    return asObject(parsed);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction asObject(value: unknown): JsonObject | undefined {\n  if (value && typeof value === \"object\" && !Array.isArray(value)) {\n    return value as JsonObject;\n  }\n  return undefined;\n}\n\nfunction readString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value : undefined;\n}\n\nfunction isNodeError(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error && \"code\" in error;\n}\n\nfunction expandHome(value: string): string {\n  if (value === \"~\") {\n    return os.homedir();\n  }\n  if (value.startsWith(\"~/\")) {\n    return path.join(os.homedir(), value.slice(2));\n  }\n  return value;\n}\n\nfunction detectSourceFromPath(filePath: string): TranscriptSourceName {\n  return filePath.includes(`${path.sep}.claude${path.sep}`) ? \"claude\" : \"codex\";\n}\n\nfunction truncateSingleLine(value: string, maxLength: number): string {\n  const line = value.replace(/\\s+/g, \" \").trim();\n  return line.length > maxLength ? `${line.slice(0, maxLength - 1)}...` : line;\n}\n","import { formatCngkitHelp } from \"../../cli/help-specs.js\";\nimport {\n  coerceLimit,\n  formatJson,\n  optionalJoinedArgument,\n  singleLine,\n  type JsonOutputOptions,\n  type NumberOption,\n} from \"../../shared/command-utils.js\";\nimport type { GlobalCommandOptions } from \"../../shared/config.js\";\nimport type { CommandOutput } from \"../../shared/output.js\";\nimport {\n  grepTranscriptEntries,\n  listTranscriptRecords,\n  readTranscriptEntries,\n  type TranscriptEntry,\n  type TranscriptRecord,\n  type TranscriptScopeName,\n} from \"./reader.js\";\n\nexport type TranscriptCommandOptions = GlobalCommandOptions &\n  JsonOutputOptions & {\n    source?: string;\n    limit?: NumberOption;\n    fileLimit?: NumberOption;\n    includeInternal?: boolean;\n  };\n\nexport async function runTranscriptCommand(\n  args: string[] | undefined,\n  options: TranscriptCommandOptions,\n  output: CommandOutput\n): Promise<void> {\n  const [action = \"list\", ...actionArgs] = args ?? [];\n  const source = normalizeTranscriptSource(options.source);\n  const limit = coerceLimit(options.limit, action === \"list\" ? 12 : 80, 500);\n  const includeInternal = options.includeInternal === true;\n\n  switch (action) {\n    case \"help\":\n      output.info(formatCngkitHelp(\"transcripts\"));\n      return;\n    case \"list\": {\n      const records = await listTranscriptRecords({ source, limit });\n      if (options.json) {\n        output.info(formatJson({ records }));\n        return;\n      }\n\n      output.info(formatTranscriptRecords(records));\n      return;\n    }\n    case \"read\": {\n      const target = actionArgs[0];\n      if (!target) {\n        throw new Error(\"Missing transcript target. Usage: cngkit transcripts read <path-or-id>\");\n      }\n\n      const entries = await readTranscriptEntries({\n        source,\n        target,\n        limit,\n        includeInternal,\n      });\n\n      if (options.json) {\n        output.info(formatJson({ entries }));\n        return;\n      }\n\n      output.info(formatTranscriptEntries(entries));\n      return;\n    }\n    case \"grep\": {\n      const query = optionalJoinedArgument(actionArgs);\n      if (!query) {\n        throw new Error(\"Missing query. Usage: cngkit transcripts grep <query>\");\n      }\n\n      const entries = await grepTranscriptEntries({\n        source,\n        query,\n        limit,\n        fileLimit: coerceLimit(options.fileLimit, 60, 5000),\n        includeInternal,\n      });\n\n      if (options.json) {\n        output.info(formatJson({ entries }));\n        return;\n      }\n\n      output.info(formatTranscriptEntries(entries));\n      return;\n    }\n    default:\n      throw new Error(\"Unknown transcripts command. Usage: cngkit transcripts <list|read|grep>\");\n  }\n}\n\nfunction formatTranscriptRecords(records: TranscriptRecord[]): string {\n  if (records.length === 0) {\n    return \"No transcript files found.\";\n  }\n\n  return records\n    .map((record, index) => {\n      const title = record.title ? `\\n  ${singleLine(record.title)}` : \"\";\n      const cwd = record.cwd ? `\\n  cwd ${record.cwd}` : \"\";\n      const session = record.sessionId ? `\\n  session ${record.sessionId}` : \"\";\n      return `${index + 1}. ${record.source} ${record.updatedAt}\\n  ${record.filePath}${session}${cwd}${title}`;\n    })\n    .join(\"\\n\");\n}\n\nfunction formatTranscriptEntries(entries: TranscriptEntry[]): string {\n  if (entries.length === 0) {\n    return \"No transcript entries found.\";\n  }\n\n  return entries\n    .map((entry) => {\n      const when = entry.timestamp ? ` ${entry.timestamp}` : \"\";\n      return `[${entry.source}] ${entry.role}${when}\\n${entry.text.trim()}`;\n    })\n    .join(\"\\n\\n\");\n}\n\nfunction normalizeTranscriptSource(value: string | undefined): TranscriptScopeName {\n  if (value === undefined) {\n    return \"all\";\n  }\n\n  switch (value) {\n    case \"all\":\n    case \"codex\":\n    case \"claude\":\n      return value;\n    default:\n      throw new Error(\"Unknown transcript source. Use one of: all, codex, claude.\");\n  }\n}\n"],"mappings":"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","names":["options","args","options","args","options"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cngkit",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "Opinionated Curly.ng CLI kit for Coderoom collaboration and website tooling.",
   "type": "module",
   "bin": {
@@ -16,6 +16,17 @@
     "type": "custom",
     "url": "https://curly.ng/support"
   },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts && chmod +x dist/cli.js",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "dev": "tsx src/cli.ts",
+    "format": "prettier --write README.md src tsconfig.json tsup.config.ts package.json",
+    "lint": "eslint src",
+    "prepublishOnly": "pnpm run build && pnpm run smoke",
+    "smoke": "node dist/cli.js --help && node dist/cli.js --version && node dist/cli.js help && node dist/cli.js help knowledges && node dist/cli.js help coderoom && node dist/cli.js help transcripts && node dist/cli.js login --help && node dist/cli.js coderoom --help && node dist/cli.js coderoom share --help && node dist/cli.js coderoom join --help && node dist/cli.js scrub --help && node dist/cli.js transcripts --help && node dist/cli.js knowledges --help && node dist/cli.js knowledges audiences --help && node dist/cli.js knowledges search --help && node dist/cli.js knowledges read --help && node dist/cli.js knowledges grep --help && node dist/cli.js knowledges glob --help && node dist/cli.js knowledges list --help && node dist/cli.js knowledges files --help && node dist/cli.js knowledges status --help",
+    "smoke:docker": "bash scripts/smoke-docker.sh",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -33,6 +44,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@cng/client": "workspace:*",
     "@types/node": "^20",
     "@types/react": "^19.2.17",
     "@types/ws": "^8.18.1",
@@ -40,17 +52,6 @@
     "prettier": "^3.8.1",
     "tsup": "^8.5.0",
     "tsx": "^4.21.0",
-    "typescript": "5.9.3",
-    "@cng/client": "0.1.0"
-  },
-  "scripts": {
-    "build": "tsup --config tsup.config.ts && chmod +x dist/cli.js",
-    "clean": "rm -rf dist *.tsbuildinfo",
-    "dev": "tsx src/cli.ts",
-    "format": "prettier --write README.md src tsconfig.json tsup.config.ts package.json",
-    "lint": "eslint src",
-    "smoke": "node dist/cli.js --help && node dist/cli.js --version && node dist/cli.js help && node dist/cli.js help knowledges && node dist/cli.js help coderoom && node dist/cli.js help transcripts && node dist/cli.js login --help && node dist/cli.js coderoom --help && node dist/cli.js coderoom share --help && node dist/cli.js coderoom join --help && node dist/cli.js scrub --help && node dist/cli.js transcripts --help && node dist/cli.js knowledges --help && node dist/cli.js knowledges audiences --help && node dist/cli.js knowledges search --help && node dist/cli.js knowledges read --help && node dist/cli.js knowledges grep --help && node dist/cli.js knowledges glob --help && node dist/cli.js knowledges list --help && node dist/cli.js knowledges files --help && node dist/cli.js knowledges status --help",
-    "smoke:docker": "bash scripts/smoke-docker.sh",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typescript": "5.9.3"
   }
-}
+}

package/dist/chunk-SNTLRTQ2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ink/command-runner.tsx"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useApp } from \"ink\";\n\nimport { formatError, type CommandOutput } from \"../output.js\";\n\ntype CommandRunnerProps = {\n  readonly run: (output: CommandOutput) => Promise<void>;\n};\n\nexport function CommandRunner({ run }: CommandRunnerProps) {\n  const { exit } = useApp();\n\n  useEffect(() => {\n    const output: CommandOutput = {\n      info(message) {\n        process.stdout.write(`${message}\\n`);\n      },\n      error(message) {\n        process.stderr.write(`${message}\\n`);\n      },\n    };\n\n    void run(output)\n      .catch((error: unknown) => {\n        process.exitCode = 1;\n        output.error(formatError(error));\n      })\n      .finally(() => {\n        exit();\n      });\n  }, [exit, run]);\n\n  return null;\n}\n"],"mappings":";;;;;AAAA,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AAQhB,SAAS,cAAc,EAAE,IAAI,GAAuB;AACzD,QAAM,EAAE,KAAK,IAAI,OAAO;AAExB,YAAU,MAAM;AACd,UAAM,SAAwB;AAAA,MAC5B,KAAK,SAAS;AACZ,gBAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AAAA,MACrC;AAAA,MACA,MAAM,SAAS;AACb,gBAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AAAA,MACrC;AAAA,IACF;AAEA,SAAK,IAAI,MAAM,EACZ,MAAM,CAAC,UAAmB;AACzB,cAAQ,WAAW;AACnB,aAAO,MAAM,YAAY,KAAK,CAAC;AAAA,IACjC,CAAC,EACA,QAAQ,MAAM;AACb,WAAK;AAAA,IACP,CAAC;AAAA,EACL,GAAG,CAAC,MAAM,GAAG,CAAC;AAEd,SAAO;AACT;","names":[]}

package/dist/chunk-SSRUN6G5.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/help-specs.ts","../src/output.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: \\`/\\`.\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: \\`/\\`.\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","export type CommandOutput = {\n  info(message: string): void;\n  error(message: string): void;\n};\n\nexport const consoleOutput: CommandOutput = {\n  info(message) {\n    console.log(message);\n  },\n  error(message) {\n    console.error(message);\n  },\n};\n\nexport function formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-TZRXQ6GR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import { randomBytes, randomUUID } from \"node:crypto\";\nimport process from \"node:process\";\n\nexport const packageVersion = \"1.1.5\";\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":[]}