cngkit 1.1.21 → 1.1.23

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-U725ZHCI.js";
+import "../../chunk-AS7FIJWP.js";
+import {
+  coerceLimit,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
+import "../../chunk-GYRLVNJX.js";
 import {
   LimitOptionsSchema,
   OptionalQueryArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import "../../chunk-67FUBMNB.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-U725ZHCI.js";
+import {
+  formatCatalogPathForDisplay,
+  normalizeFilesystemCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import {
+  coerceLimit,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
+import "../../chunk-GYRLVNJX.js";
 import {
   LimitOptionsSchema,
   OptionalPathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import "../../chunk-67FUBMNB.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-U725ZHCI.js";
+import {
+  normalizeCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import {
+  coerceLimit,
+  coerceOptionalNumber,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
+import "../../chunk-GYRLVNJX.js";
 import {
   JsonOutputOptionsSchema,
   RequiredFilePathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import {
+  resolveOutputFormat
+} from "../../chunk-67FUBMNB.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"]}

package/dist/commands/knowledges/realpath.js

@@ -1,19 +1,34 @@
 import {
-  runKnowRealpathCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  formatCatalogPathForDisplay,
+  normalizeFilesystemCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import {
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
 import {
   JsonOutputOptionsSchema,
   RequiredCatalogPathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import "../../chunk-67FUBMNB.js";
 import "../../chunk-PZ5AY32C.js";
 
+// src/features/knowledges/handlers/realpath.ts
+async function runKnowRealpathCommand(path, options2, output) {
+  if (!path) {
+    throw new Error("Missing path. Usage: cngkit knowledges realpath <path>");
+  }
+  const resolvedPath = formatCatalogPathForDisplay(normalizeFilesystemCatalogPath(path));
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson({ path: resolvedPath }));
+    return;
+  }
+  output.raw(resolvedPath);
+}
+
 // src/commands/knowledges/realpath.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Normalize a topics-root catalog path";

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/realpath.tsx"],"sourcesContent":["import { JsonOutputOptionsSchema, RequiredCatalogPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowRealpathCommand, type KnowRealpathCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Normalize a topics-root catalog path\";\nexport const args = RequiredCatalogPathArgsSchema;\nexport const options = JsonOutputOptionsSchema;\n\ntype RealpathCommandProps = {\n  readonly args: [string];\n  readonly options: KnowRealpathCommandOptions;\n};\n\nexport default function RealpathCommand({ args, options }: RealpathCommandProps) {\n  return <CommandRunner run={(output) => runKnowRealpathCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAcS;AAVF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU;AAOR,SAAR,gBAAiC,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAyB;AAC/E,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,uBAAuBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AAC3F;","names":["args","options"]}
+{"version":3,"sources":["../../../src/features/knowledges/handlers/realpath.ts","../../../src/commands/knowledges/realpath.tsx"],"sourcesContent":["import { formatJson, shouldPrintJson } from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { formatCatalogPathForDisplay, normalizeFilesystemCatalogPath } from \"../knowledges-input.js\";\nimport type { KnowRealpathCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowRealpathCommand(\n  path: string | undefined,\n  options: KnowRealpathCommandOptions,\n  output: CommandOutput\n): Promise<void> {\n  if (!path) {\n    throw new Error(\"Missing path. Usage: cngkit knowledges realpath <path>\");\n  }\n\n  const resolvedPath = formatCatalogPathForDisplay(normalizeFilesystemCatalogPath(path));\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson({ path: resolvedPath }));\n    return;\n  }\n\n  output.raw(resolvedPath);\n}\n","import { JsonOutputOptionsSchema, RequiredCatalogPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowRealpathCommand } from \"../../features/knowledges/handlers/realpath.js\";\nimport type { KnowRealpathCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Normalize a topics-root catalog path\";\nexport const args = RequiredCatalogPathArgsSchema;\nexport const options = JsonOutputOptionsSchema;\n\ntype RealpathCommandProps = {\n  readonly args: [string];\n  readonly options: KnowRealpathCommandOptions;\n};\n\nexport default function RealpathCommand({ args, options }: RealpathCommandProps) {\n  return <CommandRunner run={(output) => runKnowRealpathCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAKA,eAAsB,uBACpB,MACAA,UACA,QACe;AACf,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AAEA,QAAM,eAAe,4BAA4B,+BAA+B,IAAI,CAAC;AACrF,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC,CAAC;AAC7C;AAAA,EACF;AAEA,SAAO,IAAI,YAAY;AACzB;;;ACNS;AAVF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU;AAOR,SAAR,gBAAiC,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAyB;AAC/E,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,uBAAuBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AAC3F;","names":["options","args","options"]}

package/dist/commands/knowledges/search.js

@@ -1,19 +1,45 @@
 import {
-  runKnowSearchCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  KnowSearchResults
+} from "../../chunk-VMTXY4KQ.js";
+import {
+  createKnowledgesApi
+} from "../../chunk-U725ZHCI.js";
+import "../../chunk-AS7FIJWP.js";
+import {
+  coerceLimit,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
+import "../../chunk-GYRLVNJX.js";
 import {
   LimitOptionsSchema,
   RequiredQueryArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import "../../chunk-67FUBMNB.js";
 import "../../chunk-PZ5AY32C.js";
 
+// src/features/knowledges/handlers/search.ts
+import { createElement } from "react";
+async function runKnowSearchCommand(query, options2, output, dependencies) {
+  if (!query) {
+    throw new Error("Missing search query. Usage: cngkit knowledges search <query>");
+  }
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.search(query, coerceLimit(options2.limit, 5));
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  if (response.data.results.length > 0) {
+    output.component(createElement(KnowSearchResults, { results: response.data.results }));
+    return;
+  }
+  output.warning(`No results for "${query}".`);
+}
+
 // src/commands/knowledges/search.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Search over Postgres-backed knowledges records";

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/search.tsx"],"sourcesContent":["import { RequiredQueryArgsSchema, LimitOptionsSchema } from \"../../cli/options.js\";\nimport { runKnowSearchCommand, type KnowSearchCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Search over Postgres-backed knowledges records\";\nexport const args = RequiredQueryArgsSchema;\nexport const options = LimitOptionsSchema;\n\ntype SearchCommandProps = {\n  readonly args: string[];\n  readonly options: KnowSearchCommandOptions;\n};\n\nexport default function SearchCommand({ args, options }: SearchCommandProps) {\n  return <CommandRunner run={(output) => runKnowSearchCommand(args.join(\" \"), options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAcS;AAVF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU;AAOR,SAAR,cAA+B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAuB;AAC3E,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,qBAAqBD,MAAK,KAAK,GAAG,GAAGC,UAAS,MAAM,GAAG;AAChG;","names":["args","options"]}
+{"version":3,"sources":["../../../src/features/knowledges/handlers/search.ts","../../../src/commands/knowledges/search.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 { KnowSearchResults } from \"../knowledges-output.js\";\nimport type { KnowSearchCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowSearchCommand(\n  query: string | undefined,\n  options: KnowSearchCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  if (!query) {\n    throw new Error(\"Missing search query. Usage: cngkit knowledges search <query>\");\n  }\n\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.search(query, coerceLimit(options.limit, 5));\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson(response.data));\n    return;\n  }\n\n  if (response.data.results.length > 0) {\n    output.component(createElement(KnowSearchResults, { results: response.data.results }));\n    return;\n  }\n\n  output.warning(`No results for \"${query}\".`);\n}\n","import { RequiredQueryArgsSchema, LimitOptionsSchema } from \"../../cli/options.js\";\nimport { runKnowSearchCommand } from \"../../features/knowledges/handlers/search.js\";\nimport type { KnowSearchCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Search over Postgres-backed knowledges records\";\nexport const args = RequiredQueryArgsSchema;\nexport const options = LimitOptionsSchema;\n\ntype SearchCommandProps = {\n  readonly args: string[];\n  readonly options: KnowSearchCommandOptions;\n};\n\nexport default function SearchCommand({ args, options }: SearchCommandProps) {\n  return <CommandRunner run={(output) => runKnowSearchCommand(args.join(\" \"), options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAQ9B,eAAsB,qBACpB,OACAA,UACA,QACA,cACe;AACf,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AAEA,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,WAAW,MAAM,IAAI,OAAO,OAAO,YAAYA,SAAQ,OAAO,CAAC,CAAC;AAEtE,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,SAAS,IAAI,CAAC;AACpC;AAAA,EACF;AAEA,MAAI,SAAS,KAAK,QAAQ,SAAS,GAAG;AACpC,WAAO,UAAU,cAAc,mBAAmB,EAAE,SAAS,SAAS,KAAK,QAAQ,CAAC,CAAC;AACrF;AAAA,EACF;AAEA,SAAO,QAAQ,mBAAmB,KAAK,IAAI;AAC7C;;;ACjBS;AAVF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU;AAOR,SAAR,cAA+B,EAAE,MAAAC,OAAM,SAAAC,SAAQ,GAAuB;AAC3E,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,qBAAqBD,MAAK,KAAK,GAAG,GAAGC,UAAS,MAAM,GAAG;AAChG;","names":["options","args","options"]}

package/dist/commands/knowledges/stat.js

@@ -1,19 +1,43 @@
 import {
-  runKnowStatCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  formatFilesystemStat
+} from "../../chunk-YALWTRIP.js";
+import {
+  createKnowledgesApi
+} from "../../chunk-U725ZHCI.js";
+import {
+  normalizeFilesystemCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import {
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
+import "../../chunk-GYRLVNJX.js";
 import {
   JsonOutputOptionsSchema,
   RequiredCatalogPathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import "../../chunk-67FUBMNB.js";
 import "../../chunk-PZ5AY32C.js";
 
+// src/features/knowledges/handlers/stat.ts
+async function runKnowStatCommand(path, options2, output, dependencies) {
+  if (!path) {
+    throw new Error("Missing path. Usage: cngkit knowledges stat <path>");
+  }
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.statPath({
+    path: normalizeFilesystemCatalogPath(path)
+  });
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  output.raw(formatFilesystemStat(response.data));
+}
+
 // src/commands/knowledges/stat.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Print remote catalog path metadata";

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/stat.tsx"],"sourcesContent":["import { JsonOutputOptionsSchema, RequiredCatalogPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowStatCommand, type KnowStatCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print remote catalog path metadata\";\nexport const args = RequiredCatalogPathArgsSchema;\nexport const options = JsonOutputOptionsSchema;\n\ntype StatCommandProps = {\n  readonly args: [string];\n  readonly options: KnowStatCommandOptions;\n};\n\nexport default function StatCommand({ args, options }: StatCommandProps) {\n  return <CommandRunner run={(output) => runKnowStatCommand(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/stat.ts","../../../src/commands/knowledges/stat.tsx"],"sourcesContent":["import { formatJson, shouldPrintJson } from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { formatFilesystemStat } from \"../format/filesystem-format.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { normalizeFilesystemCatalogPath } from \"../knowledges-input.js\";\nimport type { KnowStatCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowStatCommand(\n  path: string | undefined,\n  options: KnowStatCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  if (!path) {\n    throw new Error(\"Missing path. Usage: cngkit knowledges stat <path>\");\n  }\n\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.statPath({\n    path: normalizeFilesystemCatalogPath(path),\n  });\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson(response.data));\n    return;\n  }\n\n  output.raw(formatFilesystemStat(response.data));\n}\n","import { JsonOutputOptionsSchema, RequiredCatalogPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowStatCommand } from \"../../features/knowledges/handlers/stat.js\";\nimport type { KnowStatCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print remote catalog path metadata\";\nexport const args = RequiredCatalogPathArgsSchema;\nexport const options = JsonOutputOptionsSchema;\n\ntype StatCommandProps = {\n  readonly args: [string];\n  readonly options: KnowStatCommandOptions;\n};\n\nexport default function StatCommand({ args, options }: StatCommandProps) {\n  return <CommandRunner run={(output) => runKnowStatCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAOA,eAAsB,mBACpB,MACAA,UACA,QACA,cACe;AACf,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AAEA,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,WAAW,MAAM,IAAI,SAAS;AAAA,IAClC,MAAM,+BAA+B,IAAI;AAAA,EAC3C,CAAC;AAED,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,SAAS,IAAI,CAAC;AACpC;AAAA,EACF;AAEA,SAAO,IAAI,qBAAqB,SAAS,IAAI,CAAC;AAChD;;;ACbS;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/status.js

@@ -1,18 +1,36 @@
 import {
-  runKnowStatusCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  KnowCatalogSummary
+} from "../../chunk-VMTXY4KQ.js";
+import {
+  createKnowledgesApi
+} from "../../chunk-U725ZHCI.js";
+import "../../chunk-AS7FIJWP.js";
+import {
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
+import "../../chunk-GYRLVNJX.js";
 import {
   JsonOutputOptionsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import "../../chunk-67FUBMNB.js";
 import "../../chunk-PZ5AY32C.js";
 
+// src/features/knowledges/handlers/status.ts
+import { createElement } from "react";
+async function runKnowStatusCommand(options2, output, dependencies) {
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.getCatalog();
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  output.component(createElement(KnowCatalogSummary, { catalog: response.data }));
+}
+
 // src/commands/knowledges/status.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Print remote catalog state";

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/status.tsx"],"sourcesContent":["import { JsonOutputOptionsSchema } from \"../../cli/options.js\";\nimport { runKnowStatusCommand, type KnowStatusCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print remote catalog state\";\nexport const options = JsonOutputOptionsSchema;\n\ntype StatusCommandProps = {\n  readonly options: KnowStatusCommandOptions;\n};\n\nexport default function StatusCommand({ options }: StatusCommandProps) {\n  return <CommandRunner run={(output) => runKnowStatusCommand(options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAYS;AARF,IAAM,cAAc;AACpB,IAAM,UAAU;AAMR,SAAR,cAA+B,EAAE,SAAAA,SAAQ,GAAuB;AACrE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,qBAAqBA,UAAS,MAAM,GAAG;AAChF;","names":["options"]}
+{"version":3,"sources":["../../../src/features/knowledges/handlers/status.ts","../../../src/commands/knowledges/status.tsx"],"sourcesContent":["import { createElement } from \"react\";\n\nimport { formatJson, shouldPrintJson } from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { KnowCatalogSummary } from \"../knowledges-output.js\";\nimport type { KnowStatusCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowStatusCommand(\n  options: KnowStatusCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.getCatalog();\n\n  if (shouldPrintJson(options)) {\n    output.raw(formatJson(response.data));\n    return;\n  }\n\n  output.component(createElement(KnowCatalogSummary, { catalog: response.data }));\n}\n","import { JsonOutputOptionsSchema } from \"../../cli/options.js\";\nimport { runKnowStatusCommand } from \"../../features/knowledges/handlers/status.js\";\nimport type { KnowStatusCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print remote catalog state\";\nexport const options = JsonOutputOptionsSchema;\n\ntype StatusCommandProps = {\n  readonly options: KnowStatusCommandOptions;\n};\n\nexport default function StatusCommand({ options }: StatusCommandProps) {\n  return <CommandRunner run={(output) => runKnowStatusCommand(options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAQ9B,eAAsB,qBACpBA,UACA,QACA,cACe;AACf,QAAM,MAAM,cAAc,OAAO,oBAAoBA,QAAO;AAC5D,QAAM,WAAW,MAAM,IAAI,WAAW;AAEtC,MAAI,gBAAgBA,QAAO,GAAG;AAC5B,WAAO,IAAI,WAAW,SAAS,IAAI,CAAC;AACpC;AAAA,EACF;AAEA,SAAO,UAAU,cAAc,oBAAoB,EAAE,SAAS,SAAS,KAAK,CAAC,CAAC;AAChF;;;ACTS;AARF,IAAM,cAAc;AACpB,IAAM,UAAU;AAMR,SAAR,cAA+B,EAAE,SAAAC,SAAQ,GAAuB;AACrE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,qBAAqBA,UAAS,MAAM,GAAG;AAChF;","names":["options","options"]}

package/dist/commands/knowledges/tail.js

@@ -1,22 +1,44 @@
 import {
-  runKnowTailCommand
-} 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-U725ZHCI.js";
+import {
+  normalizeCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import {
+  coerceLimit
+} from "../../chunk-XQGLUQFM.js";
+import "../../chunk-GYRLVNJX.js";
 import {
   JsonOutputOptionsSchema,
   RequiredFilePathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import "../../chunk-67FUBMNB.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/tail.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/knowledges/handlers/tail.ts
+async function runKnowTailCommand(filePath, options2, output, dependencies) {
+  if (!filePath) {
+    throw new Error("Missing file_path. Usage: cngkit knowledges tail <file_path> -n 10");
+  }
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.tail({
+    filePath: normalizeCatalogPath(filePath),
+    lines: coerceLimit(options2.lines, 10, 2e3)
+  });
+  outputRawContent(response.data, options2, output);
+}
+
+// src/commands/knowledges/tail.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Print the last lines of a remote catalog file";
 var args = RequiredFilePathArgsSchema;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/tail.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, RequiredFilePathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowTailCommand, type KnowTailCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print the last 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 TailCommandProps = {\n  readonly args: [string];\n  readonly options: KnowTailCommandOptions;\n};\n\nexport default function TailCommand({ args, options }: TailCommandProps) {\n  return <CommandRunner run={(output) => runKnowTailCommand(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/tail.tsx","../../../src/features/knowledges/handlers/tail.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, RequiredFilePathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowTailCommand } from \"../../features/knowledges/handlers/tail.js\";\nimport type { KnowTailCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print the last 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 TailCommandProps = {\n  readonly args: [string];\n  readonly options: KnowTailCommandOptions;\n};\n\nexport default function TailCommand({ args, options }: TailCommandProps) {\n  return <CommandRunner run={(output) => runKnowTailCommand(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 { KnowTailCommandOptions } from \"../knowledges-options.js\";\nimport { outputRawContent } from \"../format/content-format.js\";\n\nexport async function runKnowTailCommand(\n  filePath: string | undefined,\n  options: KnowTailCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  if (!filePath) {\n    throw new Error(\"Missing file_path. Usage: cngkit knowledges tail <file_path> -n 10\");\n  }\n\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.tail({\n    filePath: normalizeCatalogPath(filePath),\n    lines: 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,OAAO,YAAYA,SAAQ,OAAO,IAAI,GAAI;AAAA,EAC5C,CAAC;AAED,mBAAiB,SAAS,MAAMA,UAAS,MAAM;AACjD;;;ADKS;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/tree.js

@@ -1,22 +1,52 @@
 import {
-  runKnowTreeCommand
-} from "../../chunk-5WTRGYAO.js";
-import "../../chunk-XQGLUQFM.js";
-import "../../chunk-SKK2XLRZ.js";
-import "../../chunk-YJXAH7D5.js";
+  formatFilesystemTree
+} from "../../chunk-YALWTRIP.js";
+import {
+  createKnowledgesApi
+} from "../../chunk-U725ZHCI.js";
+import {
+  normalizeFilesystemCatalogPath
+} from "../../chunk-AS7FIJWP.js";
+import {
+  coerceLimit,
+  formatJson,
+  shouldPrintJson
+} from "../../chunk-XQGLUQFM.js";
+import "../../chunk-GYRLVNJX.js";
 import {
   JsonOutputOptionsSchema,
   OptionalPathArgsSchema
-} from "../../chunk-NGEWD4BW.js";
+} from "../../chunk-25Q463MH.js";
 import {
   CommandRunner
-} from "../../chunk-52PGDSFU.js";
-import "../../chunk-DIJEVOVN.js";
+} from "../../chunk-WIEYHKQA.js";
+import "../../chunk-67FUBMNB.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/tree.tsx
 import { option } from "pastel";
 import { z } from "zod";
+
+// src/features/knowledges/handlers/tree.ts
+async function runKnowTreeCommand(path, options2, output, dependencies) {
+  const api = dependencies?.api ?? createKnowledgesApi(options2);
+  const response = await api.tree({
+    path: normalizeFilesystemCatalogPath(path ?? "/"),
+    depth: coerceLimit(options2.depth, 3, 8),
+    limit: coerceLimit(options2.limit, 500, 2e3)
+  });
+  if (shouldPrintJson(options2)) {
+    output.raw(formatJson(response.data));
+    return;
+  }
+  const lines = formatFilesystemTree(response.data.path, response.data.entries);
+  output.raw(lines.join("\n"));
+  if (response.data.truncated) {
+    output.warning(`[truncated: ${response.data.total_entries} total entries]`);
+  }
+}
+
+// src/commands/knowledges/tree.tsx
 import { jsx } from "react/jsx-runtime";
 var description = "Print a remote catalog directory tree";
 var args = OptionalPathArgsSchema;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/knowledges/tree.tsx"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, OptionalPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowTreeCommand, type KnowTreeCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print a remote catalog directory tree\";\nexport const args = OptionalPathArgsSchema;\nexport const options = JsonOutputOptionsSchema.extend({\n  depth: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum tree depth\",\n        valueDescription: \"n\",\n      })\n    ),\n  limit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum entries\",\n        valueDescription: \"n\",\n      })\n    ),\n});\n\ntype TreeCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowTreeCommandOptions;\n};\n\nexport default function TreeCommand({ args, options }: TreeCommandProps) {\n  return <CommandRunner run={(output) => runKnowTreeCommand(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,OAAO,EACJ,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/tree.tsx","../../../src/features/knowledges/handlers/tree.ts"],"sourcesContent":["import { option } from \"pastel\";\nimport { z } from \"zod\";\n\nimport { JsonOutputOptionsSchema, OptionalPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowTreeCommand } from \"../../features/knowledges/handlers/tree.js\";\nimport type { KnowTreeCommandOptions } from \"../../features/knowledges/knowledges-options.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"Print a remote catalog directory tree\";\nexport const args = OptionalPathArgsSchema;\nexport const options = JsonOutputOptionsSchema.extend({\n  depth: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum tree depth\",\n        valueDescription: \"n\",\n      })\n    ),\n  limit: z\n    .number()\n    .optional()\n    .describe(\n      option({\n        description: \"Maximum entries\",\n        valueDescription: \"n\",\n      })\n    ),\n});\n\ntype TreeCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowTreeCommandOptions;\n};\n\nexport default function TreeCommand({ args, options }: TreeCommandProps) {\n  return <CommandRunner run={(output) => runKnowTreeCommand(args[0], options, output)} />;\n}\n","import { coerceLimit, formatJson, shouldPrintJson } from \"../../../shared/command-utils.js\";\nimport type { CommandOutput } from \"../../../shared/output/types.js\";\nimport { formatFilesystemTree } from \"../format/filesystem-format.js\";\nimport { createKnowledgesApi, type KnowCommandDependencies } from \"../knowledges-api.js\";\nimport { normalizeFilesystemCatalogPath } from \"../knowledges-input.js\";\nimport type { KnowTreeCommandOptions } from \"../knowledges-options.js\";\n\nexport async function runKnowTreeCommand(\n  path: string | undefined,\n  options: KnowTreeCommandOptions,\n  output: CommandOutput,\n  dependencies?: KnowCommandDependencies\n): Promise<void> {\n  const api = dependencies?.api ?? createKnowledgesApi(options);\n  const response = await api.tree({\n    path: normalizeFilesystemCatalogPath(path ?? \"/\"),\n    depth: coerceLimit(options.depth, 3, 8),\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 lines = formatFilesystemTree(response.data.path, response.data.entries);\n  output.raw(lines.join(\"\\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;;;ACMlB,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,OAAO,YAAYA,SAAQ,OAAO,GAAG,CAAC;AAAA,IACtC,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,QAAQ,qBAAqB,SAAS,KAAK,MAAM,SAAS,KAAK,OAAO;AAC5E,SAAO,IAAI,MAAM,KAAK,IAAI,CAAC;AAE3B,MAAI,SAAS,KAAK,WAAW;AAC3B,WAAO,QAAQ,eAAe,SAAS,KAAK,aAAa,iBAAiB;AAAA,EAC5E;AACF;;;ADMS;AA7BF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU,wBAAwB,OAAO;AAAA,EACpD,OAAO,EACJ,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"]}