cngkit 1.1.21 → 1.1.22

package/dist/commands/knowledges/find.js

@@ -1,22 +1,62 @@
 import {
-  runKnowFindCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  coerceOptionalFiniteNumber,
+  compareFilesystemEntries,
+  formatFilesystemEntryPath
+} from "../../chunk-YALWTRIP.js";
+import {
+  createKnowledgesApi
+} from "../../chunk-NLAANOBW.js";
+import {
+  formatCatalogPathForDisplay,
+  normalizeFilesystemCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import "../../chunk-N255PYL7.js";
+import {
+  coerceLimit,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
 import {
   JsonOutputOptionsSchema,
   OptionalPathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-TIY4RTXC.js";
+import "../../chunk-DCW4RKLC.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/find.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/knowledges/handlers/find.ts
+async function runKnowFindCommand(path, options2, output, dependencies) {
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.find({
+    path: normalizeFilesystemCatalogPath(path ?? "/"),
+    name: options2.name,
+    type: options2.type,
+    maxDepth: coerceOptionalFiniteNumber(options2.maxDepth),
+    limit: coerceLimit(options2.limit, 500, 2e3)
+  });
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  const entries = [...response.data.entries].sort(compareFilesystemEntries);
+  const lines = entries.map(formatFilesystemEntryPath);
+  if (lines.length > 0) {
+    output.raw(lines.join("\n"));
+  } else {
+    output.warning(`No entries found under ${formatCatalogPathForDisplay(response.data.path)}.`);
+  }
+  if (response.data.truncated) {
+    output.warning(`[truncated: ${response.data.total_entries} total entries]`);
+  }
+}
+
+// src/commands/knowledges/find.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Find remote catalog paths";
 var args = OptionalPathArgsSchema;

package/dist/commands/knowledges/find.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/find.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, OptionalPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowFindCommand, type KnowFindCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Find remote catalog paths\";\nexport const args = OptionalPathArgsSchema;\nexport const options = JsonOutputOptionsSchema.extend({\n  name: z\n    .string()\n    .optional()\n    .describe(\n      option({\n        description: \"Basename wildcard pattern\",\n        valueDescription: \"pattern\",\n      })\n    ),\n  type: z\n    .enum([\"file\", \"directory\", \"f\", \"d\"])\n    .transform((value) => {\n      if (value === \"f\") {\n        return \"file\";\n      }\n\n      if (value === \"d\") {\n        return \"directory\";\n      }\n\n      return value;\n    })\n    .optional()\n    .describe(\n      option({\n        description: \"Path type: file or directory\",\n        valueDescription: \"type\",\n      })\n    ),\n  maxDepth: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum descendant depth\",\n        valueDescription: \"n\",\n      })\n    ),\n  limit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum results\",\n        valueDescription: \"n\",\n      })\n    ),\n});\n\ntype FindCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowFindCommandOptions;\n};\n\nexport default function FindCommand({ args, options }: FindCommandProps) {\n  return <CommandRunner run={(output) => runKnowFindCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;AAgET;AA1DF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,wBAAwB,OAAO;AAAA,EACpD,MAAM,EACH,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,MAAM,EACH,KAAK,CAAC,QAAQ,aAAa,KAAK,GAAG,CAAC,EACpC,UAAU,CAAC,UAAU;AACpB,QAAI,UAAU,KAAK;AACjB,aAAO;AAAA,IACT;AAEA,QAAI,UAAU,KAAK;AACjB,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT,CAAC,EACA,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,UAAU,EACP,OAAO,EACP,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;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACvF;","names":["args","options"]}
+{"version":3,"sources":["../../../src/commands/knowledges/find.tsx","../../../src/features/knowledges/handlers/find.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, OptionalPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowFindCommand } from \"../../features/knowledges/handlers/find.js\";\nimport type { KnowFindCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Find remote catalog paths\";\nexport const args = OptionalPathArgsSchema;\nexport const options = JsonOutputOptionsSchema.extend({\n  name: z\n    .string()\n    .optional()\n    .describe(\n      option({\n        description: \"Basename wildcard pattern\",\n        valueDescription: \"pattern\",\n      })\n    ),\n  type: z\n    .enum([\"file\", \"directory\", \"f\", \"d\"])\n    .transform((value) => {\n      if (value === \"f\") {\n        return \"file\";\n      }\n\n      if (value === \"d\") {\n        return \"directory\";\n      }\n\n      return value;\n    })\n    .optional()\n    .describe(\n      option({\n        description: \"Path type: file or directory\",\n        valueDescription: \"type\",\n      })\n    ),\n  maxDepth: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum descendant depth\",\n        valueDescription: \"n\",\n      })\n    ),\n  limit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum results\",\n        valueDescription: \"n\",\n      })\n    ),\n});\n\ntype FindCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowFindCommandOptions;\n};\n\nexport default function FindCommand({ args, options }: FindCommandProps) {\n  return <CommandRunner run={(output) => runKnowFindCommand(args[0], options, output)} />;\n}\n","import { coerceLimit, formatJson, shouldPrintJson } from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport {\n  coerceOptionalFiniteNumber,\n  compareFilesystemEntries,\n  formatFilesystemEntryPath,\n} from \"../format/filesystem-format.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { formatCatalogPathForDisplay, normalizeFilesystemCatalogPath } from \"../knowledges-input.js\";\nimport type { KnowFindCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowFindCommand(\n  path: string | undefined,\n  options: KnowFindCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.find({\n    path: normalizeFilesystemCatalogPath(path ?? \"/\"),\n    name: options.name,\n    type: options.type,\n    maxDepth: coerceOptionalFiniteNumber(options.maxDepth),\n    limit: coerceLimit(options.limit, 500, 2000),\n  });\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson(response.data));\n    return;\n  }\n\n  const entries = [...response.data.entries].sort(compareFilesystemEntries);\n  const lines = entries.map(formatFilesystemEntryPath);\n\n  if (lines.length > 0) {\n    output.raw(lines.join(\"\\n\"));\n  } else {\n    output.warning(`No entries found under ${formatCatalogPathForDisplay(response.data.path)}.`);\n  }\n\n  if (response.data.truncated) {\n    output.warning(`[truncated: ${response.data.total_entries} total entries]`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;;;ACUlB,eAAsB,mBACpB,MACAA,UACA,QACA,cACe;AACf,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,WAAW,MAAM,IAAI,KAAK;AAAA,IAC9B,MAAM,+BAA+B,QAAQ,GAAG;AAAA,IAChD,MAAMA,SAAQ;AAAA,IACd,MAAMA,SAAQ;AAAA,IACd,UAAU,2BAA2BA,SAAQ,QAAQ;AAAA,IACrD,OAAO,YAAYA,SAAQ,OAAO,KAAK,GAAI;AAAA,EAC7C,CAAC;AAED,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,SAAS,IAAI,CAAC;AACpC;AAAA,EACF;AAEA,QAAM,UAAU,CAAC,GAAG,SAAS,KAAK,OAAO,EAAE,KAAK,wBAAwB;AACxE,QAAM,QAAQ,QAAQ,IAAI,yBAAyB;AAEnD,MAAI,MAAM,SAAS,GAAG;AACpB,WAAO,IAAI,MAAM,KAAK,IAAI,CAAC;AAAA,EAC7B,OAAO;AACL,WAAO,QAAQ,0BAA0B,4BAA4B,SAAS,KAAK,IAAI,CAAC,GAAG;AAAA,EAC7F;AAEA,MAAI,SAAS,KAAK,WAAW;AAC3B,WAAO,QAAQ,eAAe,SAAS,KAAK,aAAa,iBAAiB;AAAA,EAC5E;AACF;;;ADuBS;AA1DF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,wBAAwB,OAAO;AAAA,EACpD,MAAM,EACH,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,MAAM,EACH,KAAK,CAAC,QAAQ,aAAa,KAAK,GAAG,CAAC,EACpC,UAAU,CAAC,UAAU;AACpB,QAAI,UAAU,KAAK;AACjB,aAAO;AAAA,IACT;AAEA,QAAI,UAAU,KAAK;AACjB,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT,CAAC,EACA,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,UAAU,EACP,OAAO,EACP,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;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACvF;","names":["options","args","options"]}

package/dist/commands/knowledges/glob.js

@@ -1,22 +1,55 @@
 import {
-  runKnowGlobCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  createKnowledgesApi
+} from "../../chunk-NLAANOBW.js";
+import {
+  formatCatalogPathForDisplay,
+  normalizeCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import "../../chunk-N255PYL7.js";
+import {
+  coerceOptionalNumber,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
 import {
   LimitOptionsSchema,
   OptionalGlobPatternArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-TIY4RTXC.js";
+import "../../chunk-DCW4RKLC.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/glob.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/knowledges/handlers/glob.ts
+async function runKnowGlobCommand(pattern, options2, output, dependencies) {
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const limit = options2.limit !== void 0 ? coerceOptionalNumber(options2.limit) : void 0;
+  const response = await api.glob({
+    pattern: pattern ?? "**/*.md",
+    path: normalizeCatalogPath(options2.path ?? "/")
+  });
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  const files = limit ? response.data.files.slice(0, limit) : response.data.files;
+  const wasClientTruncated = limit ? response.data.files.length > limit : false;
+  if (files.length > 0) {
+    output.raw(files.map(formatCatalogPathForDisplay).join("\n"));
+  } else {
+    output.warning("No matching files.");
+  }
+  if (response.data.truncated || wasClientTruncated) {
+    output.warning(`[truncated: ${response.data.total_files} total files]`);
+  }
+}
+
+// src/commands/knowledges/glob.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Claude-style file discovery";
 var args = OptionalGlobPatternArgsSchema;

package/dist/commands/knowledges/glob.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/glob.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { LimitOptionsSchema, OptionalGlobPatternArgsSchema } from \"../../cli/options.js\";\nimport { runKnowGlobCommand, type KnowGlobCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Claude-style file discovery\";\nexport const args = OptionalGlobPatternArgsSchema;\nexport const options = LimitOptionsSchema.extend({\n  path: z\n    .string()\n    .optional()\n    .describe(\n      option({\n        description: \"Catalog path prefix\",\n        valueDescription: \"path\",\n      })\n    ),\n});\n\ntype GlobCommandProps = {\n  readonly args: string[];\n  readonly options: KnowGlobCommandOptions;\n};\n\nexport default function GlobCommand({ args, options }: GlobCommandProps) {\n  return <CommandRunner run={(output) => runKnowGlobCommand(args.join(\" \"), options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;AA0BT;AApBF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,mBAAmB,OAAO;AAAA,EAC/C,MAAM,EACH,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,KAAK,GAAG,GAAGC,UAAS,MAAM,GAAG;AAC9F;","names":["args","options"]}
+{"version":3,"sources":["../../../src/commands/knowledges/glob.tsx","../../../src/features/knowledges/handlers/glob.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { LimitOptionsSchema, OptionalGlobPatternArgsSchema } from \"../../cli/options.js\";\nimport { runKnowGlobCommand } from \"../../features/knowledges/handlers/glob.js\";\nimport type { KnowGlobCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Claude-style file discovery\";\nexport const args = OptionalGlobPatternArgsSchema;\nexport const options = LimitOptionsSchema.extend({\n  path: z\n    .string()\n    .optional()\n    .describe(\n      option({\n        description: \"Catalog path prefix\",\n        valueDescription: \"path\",\n      })\n    ),\n});\n\ntype GlobCommandProps = {\n  readonly args: string[];\n  readonly options: KnowGlobCommandOptions;\n};\n\nexport default function GlobCommand({ args, options }: GlobCommandProps) {\n  return <CommandRunner run={(output) => runKnowGlobCommand(args.join(\" \"), options, output)} />;\n}\n","import {\n  coerceOptionalNumber,\n  formatJson,\n  shouldPrintJson,\n} from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { formatCatalogPathForDisplay, normalizeCatalogPath } from \"../knowledges-input.js\";\nimport type { KnowGlobCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowGlobCommand(\n  pattern: string | undefined,\n  options: KnowGlobCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const limit = options.limit !== undefined ? coerceOptionalNumber(options.limit) : undefined;\n  const response = await api.glob({\n    pattern: pattern ?? \"**/*.md\",\n    path: normalizeCatalogPath(options.path ?? \"/\"),\n  });\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson(response.data));\n    return;\n  }\n\n  const files = limit ? response.data.files.slice(0, limit) : response.data.files;\n  const wasClientTruncated = limit ? response.data.files.length > limit : false;\n\n  if (files.length > 0) {\n    output.raw(files.map(formatCatalogPathForDisplay).join(\"\\n\"));\n  } else {\n    output.warning(\"No matching files.\");\n  }\n  if (response.data.truncated || wasClientTruncated) {\n    output.warning(`[truncated: ${response.data.total_files} total files]`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;;;ACSlB,eAAsB,mBACpB,SACAA,UACA,QACA,cACe;AACf,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,QAAQA,SAAQ,UAAU,SAAY,qBAAqBA,SAAQ,KAAK,IAAI;AAClF,QAAM,WAAW,MAAM,IAAI,KAAK;AAAA,IAC9B,SAAS,WAAW;AAAA,IACpB,MAAM,qBAAqBA,SAAQ,QAAQ,GAAG;AAAA,EAChD,CAAC;AAED,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,SAAS,IAAI,CAAC;AACpC;AAAA,EACF;AAEA,QAAM,QAAQ,QAAQ,SAAS,KAAK,MAAM,MAAM,GAAG,KAAK,IAAI,SAAS,KAAK;AAC1E,QAAM,qBAAqB,QAAQ,SAAS,KAAK,MAAM,SAAS,QAAQ;AAExE,MAAI,MAAM,SAAS,GAAG;AACpB,WAAO,IAAI,MAAM,IAAI,2BAA2B,EAAE,KAAK,IAAI,CAAC;AAAA,EAC9D,OAAO;AACL,WAAO,QAAQ,oBAAoB;AAAA,EACrC;AACA,MAAI,SAAS,KAAK,aAAa,oBAAoB;AACjD,WAAO,QAAQ,eAAe,SAAS,KAAK,WAAW,eAAe;AAAA,EACxE;AACF;;;ADXS;AApBF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,mBAAmB,OAAO;AAAA,EAC/C,MAAM,EACH,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,KAAK,GAAG,GAAGC,UAAS,MAAM,GAAG;AAC9F;","names":["options","args","options"]}

package/dist/commands/knowledges/grep.js

@@ -1,22 +1,87 @@
 import {
-  runKnowGrepCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  createKnowledgesApi
+} from "../../chunk-NLAANOBW.js";
+import {
+  formatCatalogPathForDisplay,
+  normalizeCatalogPath,
+  normalizeGrepMode
+} from "../../chunk-AS7FIJWP.js";
+import "../../chunk-N255PYL7.js";
+import {
+  coerceLimit,
+  coerceOptionalNumber,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
 import {
   LimitOptionsSchema,
   RequiredPatternArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-TIY4RTXC.js";
+import "../../chunk-DCW4RKLC.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/grep.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/knowledges/handlers/grep.ts
+async function runKnowGrepCommand(pattern, options2, output, dependencies) {
+  if (!pattern) {
+    throw new Error("Missing pattern. Usage: cngkit knowledges grep <pattern>");
+  }
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const limit = options2.limit !== void 0 ? coerceOptionalNumber(options2.limit) : void 0;
+  const response = await api.grep({
+    pattern,
+    path: normalizeCatalogPath(options2.path ?? "/"),
+    include: options2.include ?? "*",
+    mode: normalizeGrepMode(options2.outputMode),
+    context: coerceLimit(options2.context, 0, 20),
+    ignoreCase: options2.caseInsensitive === true
+  });
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  if (response.data.mode === "files_with_matches") {
+    const files = limit ? response.data.files.slice(0, limit) : response.data.files;
+    if (files.length > 0) {
+      output.raw(files.map(formatCatalogPathForDisplay).join("\n"));
+      return;
+    }
+    output.warning(`No files matched "${pattern}".`);
+    return;
+  }
+  if (response.data.mode === "count") {
+    const counts = limit ? response.data.counts.slice(0, limit) : response.data.counts;
+    const lines2 = counts.map(
+      (count) => `${formatCatalogPathForDisplay(count.file_path)}: ${count.match_count}`
+    );
+    if (lines2.length > 0) {
+      output.raw(lines2.join("\n"));
+      return;
+    }
+    output.warning(`No matches for "${pattern}".`);
+    return;
+  }
+  const matches = limit ? response.data.matches.slice(0, limit) : response.data.matches;
+  const lines = matches.flatMap((match) => [
+    `${formatCatalogPathForDisplay(match.file_path)}:${match.line_number}`,
+    ...match.context_before.map((line) => `  ${line}`),
+    `> ${match.line}`,
+    ...match.context_after.map((line) => `  ${line}`)
+  ]);
+  if (lines.length > 0) {
+    output.raw(lines.join("\n"));
+    return;
+  }
+  output.warning(`No matches for "${pattern}".`);
+}
+
+// src/commands/knowledges/grep.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Claude-style content search";
 var args = RequiredPatternArgsSchema;

package/dist/commands/knowledges/grep.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/grep.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { LimitOptionsSchema, RequiredPatternArgsSchema } from \"../../cli/options.js\";\nimport { runKnowGrepCommand, type KnowGrepCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Claude-style content search\";\nexport const args = RequiredPatternArgsSchema;\nexport const options = LimitOptionsSchema.extend({\n  path: z\n    .string()\n    .optional()\n    .describe(\n      option({\n        description: \"Catalog path prefix\",\n        valueDescription: \"path\",\n      })\n    ),\n  include: z\n    .string()\n    .optional()\n    .describe(\n      option({\n        description: \"Filename include filter\",\n        valueDescription: \"glob\",\n      })\n    ),\n  outputMode: z\n    .enum([\"content\", \"files_with_matches\", \"count\"])\n    .optional()\n    .describe(\n      option({\n        description: \"Output mode: content, files_with_matches, count\",\n        valueDescription: \"mode\",\n      })\n    ),\n  context: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Context lines around content matches\",\n        valueDescription: \"n\",\n      })\n    ),\n  caseInsensitive: z\n    .boolean()\n    .optional()\n    .describe(\n      option({\n        description: \"Case-insensitive search\",\n      })\n    ),\n});\n\ntype GrepCommandProps = {\n  readonly args: string[];\n  readonly options: KnowGrepCommandOptions;\n};\n\nexport default function GrepCommand({ args, options }: GrepCommandProps) {\n  return <CommandRunner run={(output) => runKnowGrepCommand(args.join(\" \"), options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;AA6DT;AAvDF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,mBAAmB,OAAO;AAAA,EAC/C,MAAM,EACH,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,SAAS,EACN,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,YAAY,EACT,KAAK,CAAC,WAAW,sBAAsB,OAAO,CAAC,EAC/C,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,SAAS,EACN,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;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,KAAK,GAAG,GAAGC,UAAS,MAAM,GAAG;AAC9F;","names":["args","options"]}
+{"version":3,"sources":["../../../src/commands/knowledges/grep.tsx","../../../src/features/knowledges/handlers/grep.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { LimitOptionsSchema, RequiredPatternArgsSchema } from \"../../cli/options.js\";\nimport { runKnowGrepCommand } from \"../../features/knowledges/handlers/grep.js\";\nimport type { KnowGrepCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Claude-style content search\";\nexport const args = RequiredPatternArgsSchema;\nexport const options = LimitOptionsSchema.extend({\n  path: z\n    .string()\n    .optional()\n    .describe(\n      option({\n        description: \"Catalog path prefix\",\n        valueDescription: \"path\",\n      })\n    ),\n  include: z\n    .string()\n    .optional()\n    .describe(\n      option({\n        description: \"Filename include filter\",\n        valueDescription: \"glob\",\n      })\n    ),\n  outputMode: z\n    .enum([\"content\", \"files_with_matches\", \"count\"])\n    .optional()\n    .describe(\n      option({\n        description: \"Output mode: content, files_with_matches, count\",\n        valueDescription: \"mode\",\n      })\n    ),\n  context: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Context lines around content matches\",\n        valueDescription: \"n\",\n      })\n    ),\n  caseInsensitive: z\n    .boolean()\n    .optional()\n    .describe(\n      option({\n        description: \"Case-insensitive search\",\n      })\n    ),\n});\n\ntype GrepCommandProps = {\n  readonly args: string[];\n  readonly options: KnowGrepCommandOptions;\n};\n\nexport default function GrepCommand({ args, options }: GrepCommandProps) {\n  return <CommandRunner run={(output) => runKnowGrepCommand(args.join(\" \"), options, output)} />;\n}\n","import {\n  coerceLimit,\n  coerceOptionalNumber,\n  formatJson,\n  shouldPrintJson,\n} from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { formatCatalogPathForDisplay, normalizeCatalogPath, normalizeGrepMode } from \"../knowledges-input.js\";\nimport type { KnowGrepCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowGrepCommand(\n  pattern: string | undefined,\n  options: KnowGrepCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  if (!pattern) {\n    throw new Error(\"Missing pattern. Usage: cngkit knowledges grep <pattern>\");\n  }\n\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const limit = options.limit !== undefined ? coerceOptionalNumber(options.limit) : undefined;\n  const response = await api.grep({\n    pattern,\n    path: normalizeCatalogPath(options.path ?? \"/\"),\n    include: options.include ?? \"*\",\n    mode: normalizeGrepMode(options.outputMode),\n    context: coerceLimit(options.context, 0, 20),\n    ignoreCase: options.caseInsensitive === true,\n  });\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson(response.data));\n    return;\n  }\n\n  if (response.data.mode === \"files_with_matches\") {\n    const files = limit ? response.data.files.slice(0, limit) : response.data.files;\n    if (files.length > 0) {\n      output.raw(files.map(formatCatalogPathForDisplay).join(\"\\n\"));\n      return;\n    }\n\n    output.warning(`No files matched \"${pattern}\".`);\n    return;\n  }\n\n  if (response.data.mode === \"count\") {\n    const counts = limit ? response.data.counts.slice(0, limit) : response.data.counts;\n    const lines = counts.map(\n      (count) => `${formatCatalogPathForDisplay(count.file_path)}: ${count.match_count}`\n    );\n    if (lines.length > 0) {\n      output.raw(lines.join(\"\\n\"));\n      return;\n    }\n\n    output.warning(`No matches for \"${pattern}\".`);\n    return;\n  }\n\n  const matches = limit ? response.data.matches.slice(0, limit) : response.data.matches;\n  const lines = matches.flatMap((match) => [\n    `${formatCatalogPathForDisplay(match.file_path)}:${match.line_number}`,\n    ...match.context_before.map((line) => `  ${line}`),\n    `> ${match.line}`,\n    ...match.context_after.map((line) => `  ${line}`),\n  ]);\n\n  if (lines.length > 0) {\n    output.raw(lines.join(\"\\n\"));\n    return;\n  }\n\n  output.warning(`No matches for \"${pattern}\".`);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;;;ACUlB,eAAsB,mBACpB,SACAA,UACA,QACA,cACe;AACf,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AAEA,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,QAAQA,SAAQ,UAAU,SAAY,qBAAqBA,SAAQ,KAAK,IAAI;AAClF,QAAM,WAAW,MAAM,IAAI,KAAK;AAAA,IAC9B;AAAA,IACA,MAAM,qBAAqBA,SAAQ,QAAQ,GAAG;AAAA,IAC9C,SAASA,SAAQ,WAAW;AAAA,IAC5B,MAAM,kBAAkBA,SAAQ,UAAU;AAAA,IAC1C,SAAS,YAAYA,SAAQ,SAAS,GAAG,EAAE;AAAA,IAC3C,YAAYA,SAAQ,oBAAoB;AAAA,EAC1C,CAAC;AAED,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,SAAS,IAAI,CAAC;AACpC;AAAA,EACF;AAEA,MAAI,SAAS,KAAK,SAAS,sBAAsB;AAC/C,UAAM,QAAQ,QAAQ,SAAS,KAAK,MAAM,MAAM,GAAG,KAAK,IAAI,SAAS,KAAK;AAC1E,QAAI,MAAM,SAAS,GAAG;AACpB,aAAO,IAAI,MAAM,IAAI,2BAA2B,EAAE,KAAK,IAAI,CAAC;AAC5D;AAAA,IACF;AAEA,WAAO,QAAQ,qBAAqB,OAAO,IAAI;AAC/C;AAAA,EACF;AAEA,MAAI,SAAS,KAAK,SAAS,SAAS;AAClC,UAAM,SAAS,QAAQ,SAAS,KAAK,OAAO,MAAM,GAAG,KAAK,IAAI,SAAS,KAAK;AAC5E,UAAMC,SAAQ,OAAO;AAAA,MACnB,CAAC,UAAU,GAAG,4BAA4B,MAAM,SAAS,CAAC,KAAK,MAAM,WAAW;AAAA,IAClF;AACA,QAAIA,OAAM,SAAS,GAAG;AACpB,aAAO,IAAIA,OAAM,KAAK,IAAI,CAAC;AAC3B;AAAA,IACF;AAEA,WAAO,QAAQ,mBAAmB,OAAO,IAAI;AAC7C;AAAA,EACF;AAEA,QAAM,UAAU,QAAQ,SAAS,KAAK,QAAQ,MAAM,GAAG,KAAK,IAAI,SAAS,KAAK;AAC9E,QAAM,QAAQ,QAAQ,QAAQ,CAAC,UAAU;AAAA,IACvC,GAAG,4BAA4B,MAAM,SAAS,CAAC,IAAI,MAAM,WAAW;AAAA,IACpE,GAAG,MAAM,eAAe,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE;AAAA,IACjD,KAAK,MAAM,IAAI;AAAA,IACf,GAAG,MAAM,cAAc,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE;AAAA,EAClD,CAAC;AAED,MAAI,MAAM,SAAS,GAAG;AACpB,WAAO,IAAI,MAAM,KAAK,IAAI,CAAC;AAC3B;AAAA,EACF;AAEA,SAAO,QAAQ,mBAAmB,OAAO,IAAI;AAC/C;;;ADbS;AAvDF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,mBAAmB,OAAO;AAAA,EAC/C,MAAM,EACH,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,SAAS,EACN,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,YAAY,EACT,KAAK,CAAC,WAAW,sBAAsB,OAAO,CAAC,EAC/C,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EACF,SAAS,EACN,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;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,KAAK,GAAG,GAAGC,UAAS,MAAM,GAAG;AAC9F;","names":["options","lines","args","options"]}

package/dist/commands/knowledges/head.js

@@ -1,22 +1,45 @@
 import {
-  runKnowHeadCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  outputRawContent
+} from "../../chunk-BRFWVQI4.js";
+import {
+  createKnowledgesApi
+} from "../../chunk-NLAANOBW.js";
+import {
+  normalizeCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import "../../chunk-N255PYL7.js";
+import {
+  coerceLimit
+} from "../../chunk-XQGLUQFM.js";
 import {
   JsonOutputOptionsSchema,
   RequiredFilePathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-TIY4RTXC.js";
+import "../../chunk-DCW4RKLC.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/head.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/knowledges/handlers/head.ts
+async function runKnowHeadCommand(filePath, options2, output, dependencies) {
+  if (!filePath) {
+    throw new Error("Missing file_path. Usage: cngkit knowledges head <file_path> -n 10");
+  }
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.read({
+    filePath: normalizeCatalogPath(filePath),
+    offset: 0,
+    limit: coerceLimit(options2.lines, 10, 2e3)
+  });
+  outputRawContent(response.data, options2, output);
+}
+
+// src/commands/knowledges/head.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Print the first lines of a remote catalog file";
 var args = RequiredFilePathArgsSchema;

package/dist/commands/knowledges/head.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/head.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, RequiredFilePathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowHeadCommand, type KnowHeadCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print the first lines of a remote catalog file\";\nexport const args = RequiredFilePathArgsSchema;\nexport const options = JsonOutputOptionsSchema.extend({\n  lines: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        alias: \"n\",\n        description: \"Number of lines\",\n        valueDescription: \"n\",\n      })\n    ),\n});\n\ntype HeadCommandProps = {\n  readonly args: [string];\n  readonly options: KnowHeadCommandOptions;\n};\n\nexport default function HeadCommand({ args, options }: HeadCommandProps) {\n  return <CommandRunner run={(output) => runKnowHeadCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;AA2BT;AArBF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,wBAAwB,OAAO;AAAA,EACpD,OAAO,EACJ,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,OAAO;AAAA,MACP,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACvF;","names":["args","options"]}
+{"version":3,"sources":["../../../src/commands/knowledges/head.tsx","../../../src/features/knowledges/handlers/head.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, RequiredFilePathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowHeadCommand } from \"../../features/knowledges/handlers/head.js\";\nimport type { KnowHeadCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print the first lines of a remote catalog file\";\nexport const args = RequiredFilePathArgsSchema;\nexport const options = JsonOutputOptionsSchema.extend({\n  lines: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        alias: \"n\",\n        description: \"Number of lines\",\n        valueDescription: \"n\",\n      })\n    ),\n});\n\ntype HeadCommandProps = {\n  readonly args: [string];\n  readonly options: KnowHeadCommandOptions;\n};\n\nexport default function HeadCommand({ args, options }: HeadCommandProps) {\n  return <CommandRunner run={(output) => runKnowHeadCommand(args[0], options, output)} />;\n}\n","import { coerceLimit } from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { normalizeCatalogPath } from \"../knowledges-input.js\";\nimport type { KnowHeadCommandOptions } from \"../knowledges-options.js\";\nimport { outputRawContent } from \"../format/content-format.js\";\n\nexport async function runKnowHeadCommand(\n  filePath: string | undefined,\n  options: KnowHeadCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  if (!filePath) {\n    throw new Error(\"Missing file_path. Usage: cngkit knowledges head <file_path> -n 10\");\n  }\n\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.read({\n    filePath: normalizeCatalogPath(filePath),\n    offset: 0,\n    limit: coerceLimit(options.lines, 10, 2000),\n  });\n\n  outputRawContent(response.data, options, output);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;;;ACMlB,eAAsB,mBACpB,UACAA,UACA,QACA,cACe;AACf,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,oEAAoE;AAAA,EACtF;AAEA,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,WAAW,MAAM,IAAI,KAAK;AAAA,IAC9B,UAAU,qBAAqB,QAAQ;AAAA,IACvC,QAAQ;AAAA,IACR,OAAO,YAAYA,SAAQ,OAAO,IAAI,GAAI;AAAA,EAC5C,CAAC;AAED,mBAAiB,SAAS,MAAMA,UAAS,MAAM;AACjD;;;ADIS;AArBF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,wBAAwB,OAAO;AAAA,EACpD,OAAO,EACJ,OAAO,EACP,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,OAAO;AAAA,MACP,aAAa;AAAA,MACb,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACvF;","names":["options","args","options"]}

package/dist/commands/knowledges/index.js

@@ -1,13 +1,13 @@
 import {
   renderKnowledgesHelp
-} from "../../chunk-SKK2XLRZ.js";
+} from "../../chunk-JNHW72SU.js";
 import {
   GlobalOptionsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-TIY4RTXC.js";
+import "../../chunk-DCW4RKLC.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/index.tsx

package/dist/commands/knowledges/list.js

@@ -1,19 +1,50 @@
 import {
-  runKnowListCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  KnowTopicList
+} from "../../chunk-VMTXY4KQ.js";
+import {
+  createKnowledgesApi
+} from "../../chunk-NLAANOBW.js";
+import "../../chunk-AS7FIJWP.js";
+import "../../chunk-N255PYL7.js";
+import {
+  coerceLimit,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
 import {
   LimitOptionsSchema,
   OptionalQueryArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-TIY4RTXC.js";
+import "../../chunk-DCW4RKLC.js";
 import "../../chunk-PZ5AY32C.js";
 
+// src/features/knowledges/handlers/list.ts
+import { createElement } from "react";
+async function runKnowListCommand(query, options2, output, dependencies) {
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.listTopics();
+  const limit = coerceLimit(options2.limit, 25);
+  const normalizedQuery = query?.toLowerCase();
+  const topics = response.data.topics.filter((topic) => {
+    if (!normalizedQuery) {
+      return true;
+    }
+    return [topic.name, topic.title, topic.description, topic.type].join(" ").toLowerCase().includes(normalizedQuery);
+  }).slice(0, limit);
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson({ topics, total: topics.length }));
+    return;
+  }
+  if (topics.length > 0) {
+    output.component(createElement(KnowTopicList, { topics }));
+    return;
+  }
+  output.warning("No matching topics.");
+}
+
 // src/commands/knowledges/list.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "List known topics";

package/dist/commands/knowledges/list.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/list.tsx"],"sourcesContent":["import { LimitOptionsSchema, OptionalQueryArgsSchema } from \"../../cli/options.js\";\nimport { runKnowListCommand, type KnowListCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"List known topics\";\nexport const args = OptionalQueryArgsSchema;\nexport const options = LimitOptionsSchema;\n\ntype ListCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowListCommandOptions;\n};\n\nexport default function ListCommand({ args, options }: ListCommandProps) {\n  return <CommandRunner run={(output) => runKnowListCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAcS;AAVF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU;AAOR,SAAR,YAA6B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACvF;","names":["args","options"]}
+{"version":3,"sources":["../../../src/features/knowledges/handlers/list.ts","../../../src/commands/knowledges/list.tsx"],"sourcesContent":["import { createElement } from \"react\";\n\nimport { coerceLimit, formatJson, shouldPrintJson } from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { KnowTopicList } from \"../knowledges-output.js\";\nimport type { KnowListCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowListCommand(\n  query: string | undefined,\n  options: KnowListCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.listTopics();\n  const limit = coerceLimit(options.limit, 25);\n  const normalizedQuery = query?.toLowerCase();\n  const topics = response.data.topics\n    .filter((topic) => {\n      if (!normalizedQuery) {\n        return true;\n      }\n      return [topic.name, topic.title, topic.description, topic.type]\n        .join(\" \")\n        .toLowerCase()\n        .includes(normalizedQuery);\n    })\n    .slice(0, limit);\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson({ topics, total: topics.length }));\n    return;\n  }\n\n  if (topics.length > 0) {\n    output.component(createElement(KnowTopicList, { topics }));\n    return;\n  }\n\n  output.warning(\"No matching topics.\");\n}\n","import { LimitOptionsSchema, OptionalQueryArgsSchema } from \"../../cli/options.js\";\nimport { runKnowListCommand } from \"../../features/knowledges/handlers/list.js\";\nimport type { KnowListCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"List known topics\";\nexport const args = OptionalQueryArgsSchema;\nexport const options = LimitOptionsSchema;\n\ntype ListCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowListCommandOptions;\n};\n\nexport default function ListCommand({ args, options }: ListCommandProps) {\n  return <CommandRunner run={(output) => runKnowListCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAQ9B,eAAsB,mBACpB,OACAA,UACA,QACA,cACe;AACf,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,WAAW,MAAM,IAAI,WAAW;AACtC,QAAM,QAAQ,YAAYA,SAAQ,OAAO,EAAE;AAC3C,QAAM,kBAAkB,OAAO,YAAY;AAC3C,QAAM,SAAS,SAAS,KAAK,OAC1B,OAAO,CAAC,UAAU;AACjB,QAAI,CAAC,iBAAiB;AACpB,aAAO;AAAA,IACT;AACA,WAAO,CAAC,MAAM,MAAM,MAAM,OAAO,MAAM,aAAa,MAAM,IAAI,EAC3D,KAAK,GAAG,EACR,YAAY,EACZ,SAAS,eAAe;AAAA,EAC7B,CAAC,EACA,MAAM,GAAG,KAAK;AAEjB,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,EAAE,QAAQ,OAAO,OAAO,OAAO,CAAC,CAAC;AACvD;AAAA,EACF;AAEA,MAAI,OAAO,SAAS,GAAG;AACrB,WAAO,UAAU,cAAc,eAAe,EAAE,OAAO,CAAC,CAAC;AACzD;AAAA,EACF;AAEA,SAAO,QAAQ,qBAAqB;AACtC;;;AC1BS;AAVF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU;AAOR,SAAR,YAA6B,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACvF;","names":["options","args","options"]}

package/dist/commands/knowledges/ls.js

@@ -1,22 +1,61 @@
 import {
-  runKnowLsCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  compareFilesystemEntries,
+  formatLongFilesystemEntryLine,
+  formatShellFilesystemEntryName
+} from "../../chunk-YALWTRIP.js";
+import {
+  createKnowledgesApi
+} from "../../chunk-NLAANOBW.js";
+import {
+  formatCatalogPathForDisplay,
+  normalizeFilesystemCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import "../../chunk-N255PYL7.js";
+import {
+  coerceLimit,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
 import {
   LimitOptionsSchema,
   OptionalPathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-TIY4RTXC.js";
+import "../../chunk-DCW4RKLC.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/ls.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/knowledges/handlers/ls.ts
+async function runKnowLsCommand(path, options2, output, dependencies) {
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.listDirectory({
+    path: normalizeFilesystemCatalogPath(path ?? "/"),
+    limit: coerceLimit(options2.limit, 100, 1e3)
+  });
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  const entries = [...response.data.entries].sort(compareFilesystemEntries);
+  const lines = entries.map(
+    (entry) => options2.long === true ? formatLongFilesystemEntryLine(entry) : formatShellFilesystemEntryName(entry)
+  );
+  if (lines.length > 0) {
+    output.raw(lines.join("\n"));
+  } else {
+    output.warning(`No entries under ${formatCatalogPathForDisplay(response.data.path)}.`);
+  }
+  if (response.data.truncated) {
+    output.warning(`[truncated: ${response.data.total_entries} total entries]`);
+  }
+}
+
+// src/commands/knowledges/ls.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "List remote catalog directory entries";
 var args = OptionalPathArgsSchema;

package/dist/commands/knowledges/ls.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/ls.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { LimitOptionsSchema, OptionalPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowLsCommand, type KnowLsCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"List remote catalog directory entries\";\nexport const args = OptionalPathArgsSchema;\nexport const options = LimitOptionsSchema.extend({\n  long: z\n    .boolean()\n    .optional()\n    .describe(\n      option({\n        alias: \"l\",\n        description: \"Print type, path, and metadata fields\",\n      })\n    ),\n});\n\ntype LsCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowLsCommandOptions;\n};\n\nexport default function LsCommand({ args, options }: LsCommandProps) {\n  return <CommandRunner run={(output) => runKnowLsCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;AA0BT;AApBF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,mBAAmB,OAAO;AAAA,EAC/C,MAAM,EACH,QAAQ,EACR,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,OAAO;AAAA,MACP,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AACJ,CAAC;AAOc,SAAR,UAA2B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAmB;AACnE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,iBAAiBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACrF;","names":["args","options"]}
+{"version":3,"sources":["../../../src/commands/knowledges/ls.tsx","../../../src/features/knowledges/handlers/ls.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { LimitOptionsSchema, OptionalPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowLsCommand } from \"../../features/knowledges/handlers/ls.js\";\nimport type { KnowLsCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"List remote catalog directory entries\";\nexport const args = OptionalPathArgsSchema;\nexport const options = LimitOptionsSchema.extend({\n  long: z\n    .boolean()\n    .optional()\n    .describe(\n      option({\n        alias: \"l\",\n        description: \"Print type, path, and metadata fields\",\n      })\n    ),\n});\n\ntype LsCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowLsCommandOptions;\n};\n\nexport default function LsCommand({ args, options }: LsCommandProps) {\n  return <CommandRunner run={(output) => runKnowLsCommand(args[0], options, output)} />;\n}\n","import { coerceLimit, formatJson, shouldPrintJson } from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport {\n  compareFilesystemEntries,\n  formatLongFilesystemEntryLine,\n  formatShellFilesystemEntryName,\n} from \"../format/filesystem-format.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { formatCatalogPathForDisplay, normalizeFilesystemCatalogPath } from \"../knowledges-input.js\";\nimport type { KnowLsCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowLsCommand(\n  path: string | undefined,\n  options: KnowLsCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.listDirectory({\n    path: normalizeFilesystemCatalogPath(path ?? \"/\"),\n    limit: coerceLimit(options.limit, 100, 1000),\n  });\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson(response.data));\n    return;\n  }\n\n  const entries = [...response.data.entries].sort(compareFilesystemEntries);\n  const lines = entries.map((entry) =>\n    options.long === true\n      ? formatLongFilesystemEntryLine(entry)\n      : formatShellFilesystemEntryName(entry)\n  );\n\n  if (lines.length > 0) {\n    output.raw(lines.join(\"\\n\"));\n  } else {\n    output.warning(`No entries under ${formatCatalogPathForDisplay(response.data.path)}.`);\n  }\n\n  if (response.data.truncated) {\n    output.warning(`[truncated: ${response.data.total_entries} total entries]`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;;;ACUlB,eAAsB,iBACpB,MACAA,UACA,QACA,cACe;AACf,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,WAAW,MAAM,IAAI,cAAc;AAAA,IACvC,MAAM,+BAA+B,QAAQ,GAAG;AAAA,IAChD,OAAO,YAAYA,SAAQ,OAAO,KAAK,GAAI;AAAA,EAC7C,CAAC;AAED,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,SAAS,IAAI,CAAC;AACpC;AAAA,EACF;AAEA,QAAM,UAAU,CAAC,GAAG,SAAS,KAAK,OAAO,EAAE,KAAK,wBAAwB;AACxE,QAAM,QAAQ,QAAQ;AAAA,IAAI,CAAC,UACzBA,SAAQ,SAAS,OACb,8BAA8B,KAAK,IACnC,+BAA+B,KAAK;AAAA,EAC1C;AAEA,MAAI,MAAM,SAAS,GAAG;AACpB,WAAO,IAAI,MAAM,KAAK,IAAI,CAAC;AAAA,EAC7B,OAAO;AACL,WAAO,QAAQ,oBAAoB,4BAA4B,SAAS,KAAK,IAAI,CAAC,GAAG;AAAA,EACvF;AAEA,MAAI,SAAS,KAAK,WAAW;AAC3B,WAAO,QAAQ,eAAe,SAAS,KAAK,aAAa,iBAAiB;AAAA,EAC5E;AACF;;;ADhBS;AApBF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,mBAAmB,OAAO;AAAA,EAC/C,MAAM,EACH,QAAQ,EACR,SAAS,EACT;AAAA,IACC,OAAO;AAAA,MACL,OAAO;AAAA,MACP,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AACJ,CAAC;AAOc,SAAR,UAA2B,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAmB;AACnE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,iBAAiBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACrF;","names":["options","args","options"]}

package/dist/commands/knowledges/read.js

@@ -1,22 +1,60 @@
 import {
-  runKnowReadCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  createKnowledgesApi
+} from "../../chunk-NLAANOBW.js";
+import {
+  normalizeCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import "../../chunk-N255PYL7.js";
+import {
+  coerceLimit,
+  coerceOptionalNumber,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
 import {
   JsonOutputOptionsSchema,
   RequiredFilePathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-TIY4RTXC.js";
+import {
+  resolveOutputFormat
+} from "../../chunk-DCW4RKLC.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/read.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/knowledges/handlers/read.ts
+async function runKnowReadCommand(filePath, options2, output, dependencies) {
+  if (!filePath) {
+    throw new Error("Missing file_path. Usage: cngkit knowledges read <file_path>");
+  }
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.read({
+    filePath: normalizeCatalogPath(filePath),
+    offset: coerceOptionalNumber(options2.offset),
+    limit: coerceLimit(options2.limit, 200, 2e3)
+  });
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  if (resolveOutputFormat() === "markdown" || !response.data.file_path.endsWith(".md")) {
+    output.raw(response.data.content);
+  } else {
+    output.markdown(response.data.content);
+  }
+  if (response.data.truncated) {
+    output.warning(
+      `[truncated: showing ${response.data.limit} lines from offset ${response.data.offset} of ${response.data.total_lines}]`
+    );
+  }
+}
+
+// src/commands/knowledges/read.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Claude-style file read";
 var args = RequiredFilePathArgsSchema;

package/dist/commands/knowledges/read.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/read.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, RequiredFilePathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowReadCommand, type KnowReadCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Claude-style file read\";\nexport const args = RequiredFilePathArgsSchema;\nexport const options = JsonOutputOptionsSchema.extend({\n  offset: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Starting line offset\",\n        valueDescription: \"n\",\n      })\n    ),\n  limit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum lines\",\n        valueDescription: \"n\",\n      })\n    ),\n});\n\ntype ReadCommandProps = {\n  readonly args: [string];\n  readonly options: KnowReadCommandOptions;\n};\n\nexport default function ReadCommand({ args, options }: ReadCommandProps) {\n  return <CommandRunner run={(output) => runKnowReadCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;AAmCT;AA7BF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,wBAAwB,OAAO;AAAA,EACpD,QAAQ,EACL,OAAO,EACP,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;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACvF;","names":["args","options"]}
+{"version":3,"sources":["../../../src/commands/knowledges/read.tsx","../../../src/features/knowledges/handlers/read.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, RequiredFilePathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowReadCommand } from \"../../features/knowledges/handlers/read.js\";\nimport type { KnowReadCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Claude-style file read\";\nexport const args = RequiredFilePathArgsSchema;\nexport const options = JsonOutputOptionsSchema.extend({\n  offset: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Starting line offset\",\n        valueDescription: \"n\",\n      })\n    ),\n  limit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum lines\",\n        valueDescription: \"n\",\n      })\n    ),\n});\n\ntype ReadCommandProps = {\n  readonly args: [string];\n  readonly options: KnowReadCommandOptions;\n};\n\nexport default function ReadCommand({ args, options }: ReadCommandProps) {\n  return <CommandRunner run={(output) => runKnowReadCommand(args[0], options, output)} />;\n}\n","import { coerceLimit, coerceOptionalNumber, formatJson, shouldPrintJson } from \"../../../shared/command-utils.js\";\nimport { resolveOutputFormat } from \"../../../shared/config.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { normalizeCatalogPath } from \"../knowledges-input.js\";\nimport type { KnowReadCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowReadCommand(\n  filePath: string | undefined,\n  options: KnowReadCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  if (!filePath) {\n    throw new Error(\"Missing file_path. Usage: cngkit knowledges read <file_path>\");\n  }\n\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.read({\n    filePath: normalizeCatalogPath(filePath),\n    offset: coerceOptionalNumber(options.offset),\n    limit: coerceLimit(options.limit, 200, 2000),\n  });\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson(response.data));\n    return;\n  }\n\n  if (resolveOutputFormat() === \"markdown\" || !response.data.file_path.endsWith(\".md\")) {\n    output.raw(response.data.content);\n  } else {\n    output.markdown(response.data.content);\n  }\n\n  if (response.data.truncated) {\n    output.warning(\n      `[truncated: showing ${response.data.limit} lines from offset ${response.data.offset} of ${response.data.total_lines}]`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS;;;ACMlB,eAAsB,mBACpB,UACAA,UACA,QACA,cACe;AACf,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,8DAA8D;AAAA,EAChF;AAEA,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,WAAW,MAAM,IAAI,KAAK;AAAA,IAC9B,UAAU,qBAAqB,QAAQ;AAAA,IACvC,QAAQ,qBAAqBA,SAAQ,MAAM;AAAA,IAC3C,OAAO,YAAYA,SAAQ,OAAO,KAAK,GAAI;AAAA,EAC7C,CAAC;AAED,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,SAAS,IAAI,CAAC;AACpC;AAAA,EACF;AAEA,MAAI,oBAAoB,MAAM,cAAc,CAAC,SAAS,KAAK,UAAU,SAAS,KAAK,GAAG;AACpF,WAAO,IAAI,SAAS,KAAK,OAAO;AAAA,EAClC,OAAO;AACL,WAAO,SAAS,SAAS,KAAK,OAAO;AAAA,EACvC;AAEA,MAAI,SAAS,KAAK,WAAW;AAC3B,WAAO;AAAA,MACL,uBAAuB,SAAS,KAAK,KAAK,sBAAsB,SAAS,KAAK,MAAM,OAAO,SAAS,KAAK,WAAW;AAAA,IACtH;AAAA,EACF;AACF;;;ADHS;AA7BF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,wBAAwB,OAAO;AAAA,EACpD,QAAQ,EACL,OAAO,EACP,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;AACJ,CAAC;AAOc,SAAR,YAA6B,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAqB;AACvE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,mBAAmBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACvF;","names":["options","args","options"]}