@remnic/core 1.1.1 → 1.1.3

package/dist/chunk-74EMIVE4.js

@@ -0,0 +1,329 @@
+// src/capsule-cli.ts
+import path from "path";
+function parseCapsuleOutputFormat(raw) {
+  if (raw === void 0 || raw === null) return "text";
+  if (typeof raw !== "string" || raw.trim() === "") {
+    throw new Error(
+      `--format expects one of text, markdown, json; got ${JSON.stringify(raw)}`
+    );
+  }
+  const v = raw.trim();
+  if (v !== "text" && v !== "markdown" && v !== "json") {
+    throw new Error(
+      `--format expects one of text, markdown, json; got ${JSON.stringify(raw)}`
+    );
+  }
+  return v;
+}
+function parseCapsuleImportMode(raw) {
+  if (raw === void 0 || raw === null) return "skip";
+  if (typeof raw !== "string" || raw.trim() === "") {
+    throw new Error(
+      `--mode expects one of skip, overwrite, fork; got ${JSON.stringify(raw)}`
+    );
+  }
+  const v = raw.trim();
+  if (v !== "skip" && v !== "overwrite" && v !== "fork") {
+    throw new Error(
+      `--mode expects one of skip, overwrite, fork; got ${JSON.stringify(raw)}`
+    );
+  }
+  return v;
+}
+function parseCapsuleConflictMode(raw) {
+  if (raw === void 0 || raw === null) return "skip-conflicts";
+  if (typeof raw !== "string" || raw.trim() === "") {
+    throw new Error(
+      `--conflict-mode expects one of skip-conflicts, prefer-source, prefer-local; got ${JSON.stringify(raw)}`
+    );
+  }
+  const v = raw.trim();
+  if (v !== "skip-conflicts" && v !== "prefer-source" && v !== "prefer-local") {
+    throw new Error(
+      `--conflict-mode expects one of skip-conflicts, prefer-source, prefer-local; got ${JSON.stringify(raw)}`
+    );
+  }
+  return v;
+}
+var ISO_8601_RE = /^\d{4}-\d{2}-\d{2}(?:[Tt]\d{2}:\d{2}(?::\d{2}(?:\.\d{1,9})?)?(?:[Zz]|[+-]\d{2}:?\d{2}))?$/;
+function parseCapsuleSince(raw) {
+  if (raw === void 0 || raw === null) return void 0;
+  if (typeof raw !== "string") {
+    throw new Error(
+      `--since expects an ISO 8601 timestamp; got ${JSON.stringify(raw)}`
+    );
+  }
+  if (raw.trim() === "") {
+    throw new Error(`--since expects an ISO 8601 timestamp; received empty string`);
+  }
+  if (!ISO_8601_RE.test(raw)) {
+    throw new Error(
+      `--since is not a valid ISO 8601 timestamp: ${raw}. Accepted forms: YYYY-MM-DD, YYYY-MM-DDTHH:MM:SSZ, YYYY-MM-DDTHH:MM:SS\xB1HH:MM`
+    );
+  }
+  const ms = Date.parse(raw);
+  if (!Number.isFinite(ms)) {
+    throw new Error(`--since is not a valid ISO 8601 timestamp: ${raw}`);
+  }
+  const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(raw);
+  if (m) {
+    const offsetMatch = /([+-])(\d{2}):?(\d{2})$/.exec(raw);
+    let displayMs = ms;
+    if (offsetMatch) {
+      const sign = offsetMatch[1] === "-" ? -1 : 1;
+      const offsetMin = sign * (Number(offsetMatch[2]) * 60 + Number(offsetMatch[3]));
+      displayMs = ms + offsetMin * 6e4;
+    }
+    const dd = new Date(displayMs);
+    if (dd.getUTCFullYear() !== Number(m[1]) || dd.getUTCMonth() + 1 !== Number(m[2]) || dd.getUTCDate() !== Number(m[3])) {
+      throw new Error(
+        `--since: calendar overflow \u2014 ${raw} normalises to a different calendar date`
+      );
+    }
+  }
+  return raw;
+}
+function parseCapsuleIncludeKinds(raw) {
+  if (raw === void 0 || raw === null) return void 0;
+  if (typeof raw !== "string") {
+    throw new Error(
+      `--include-kinds expects a comma-separated list of directory names; got ${JSON.stringify(raw)}`
+    );
+  }
+  if (raw.trim() === "") {
+    throw new Error(
+      `--include-kinds expects at least one non-empty kind name`
+    );
+  }
+  const parts = raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (parts.length === 0) {
+    throw new Error(`--include-kinds expects at least one non-empty kind name`);
+  }
+  for (const p of parts) {
+    if (p.includes("/") || p.includes("\\")) {
+      throw new Error(
+        `--include-kinds entries must be top-level directory names (no path separators): ${p}`
+      );
+    }
+  }
+  return [...new Set(parts)];
+}
+function parseCapsulePeers(raw) {
+  if (raw === void 0 || raw === null) return void 0;
+  if (typeof raw !== "string") {
+    throw new Error(
+      `--peers expects a comma-separated list of peer ids; got ${JSON.stringify(raw)}`
+    );
+  }
+  if (raw.trim() === "") {
+    throw new Error(`--peers expects at least one non-empty peer id`);
+  }
+  const parts = raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (parts.length === 0) {
+    throw new Error(`--peers expects at least one non-empty peer id`);
+  }
+  for (const p of parts) {
+    if (p.includes("/") || p.includes("\\") || p === "." || p === "..") {
+      throw new Error(
+        `--peers entries must be plain id tokens (no path separators): ${p}`
+      );
+    }
+  }
+  return [...new Set(parts)];
+}
+function parseCapsuleExportOptions(nameArg, opts) {
+  if (typeof nameArg !== "string" || nameArg.trim() === "") {
+    throw new Error(
+      `capsule export: <name> is required (e.g. "remnic capsule export my-capsule")`
+    );
+  }
+  const name = nameArg.trim();
+  const out = typeof opts.out === "string" && opts.out.trim() !== "" ? opts.out.trim() : void 0;
+  const since = parseCapsuleSince(opts.since);
+  const includeKinds = parseCapsuleIncludeKinds(opts.includeKinds);
+  const peers = parseCapsulePeers(opts.peers);
+  return { name, out, since, includeKinds, peers };
+}
+function parseCapsuleImportOptions(archiveArg, opts) {
+  if (typeof archiveArg !== "string" || archiveArg.trim() === "") {
+    throw new Error(
+      `capsule import: <archive> path is required (e.g. "remnic capsule import /path/to/my-capsule.capsule.json.gz")`
+    );
+  }
+  const archive = archiveArg.trim();
+  const mode = parseCapsuleImportMode(opts.mode);
+  return { archive, mode };
+}
+function parseCapsuleMergeOptions(archiveArg, opts) {
+  if (typeof archiveArg !== "string" || archiveArg.trim() === "") {
+    throw new Error(
+      `capsule merge: <archive> path is required (e.g. "remnic capsule merge /path/to/my-capsule.capsule.json.gz")`
+    );
+  }
+  const archive = archiveArg.trim();
+  const conflictMode = parseCapsuleConflictMode(opts.conflictMode);
+  return { archive, conflictMode };
+}
+function parseCapsuleListOptions(opts, defaultCapsulesDir2) {
+  const format = parseCapsuleOutputFormat(opts.format);
+  const rawDir = typeof opts.dir === "string" && opts.dir.trim() !== "" ? opts.dir.trim() : void 0;
+  const capsulesDir = rawDir ?? defaultCapsulesDir2;
+  return { format, capsulesDir };
+}
+function parseCapsuleInspectOptions(archiveArg, opts) {
+  if (typeof archiveArg !== "string" || archiveArg.trim() === "") {
+    throw new Error(
+      `capsule inspect: <archive> path is required (e.g. "remnic capsule inspect my-capsule.capsule.json.gz")`
+    );
+  }
+  const archive = archiveArg.trim();
+  const format = parseCapsuleOutputFormat(opts.format);
+  return { archive, format };
+}
+function defaultCapsulesDir(memoryDir) {
+  return path.join(memoryDir, ".capsules");
+}
+function escapeMarkdownCell(v) {
+  return v.replace(/\\/g, "\\\\").replace(/\|/g, "\\|");
+}
+function renderCapsuleList(entries, format) {
+  if (format === "json") {
+    return JSON.stringify({ capsules: entries }, null, 2);
+  }
+  if (entries.length === 0) {
+    if (format === "markdown") return "_No capsule archives found._\n";
+    return "No capsule archives found.\n";
+  }
+  if (format === "markdown") {
+    const rows = entries.map((e) => {
+      const id = escapeMarkdownCell(e.id);
+      const date = escapeMarkdownCell(e.createdAt?.slice(0, 10) ?? "\u2014");
+      const ver = escapeMarkdownCell(e.pluginVersion ?? "\u2014");
+      const files = e.fileCount !== null ? String(e.fileCount) : "\u2014";
+      const desc = escapeMarkdownCell(
+        e.description != null && e.description.trim() !== "" ? e.description.trim() : "\u2014"
+      );
+      return `| \`${id}\` | ${date} | ${ver} | ${files} | ${desc} |`;
+    });
+    return [
+      "# Capsule archives",
+      "",
+      "| ID | Created | Version | Files | Description |",
+      "| -- | ------- | ------- | ----- | ----------- |",
+      ...rows,
+      ""
+    ].join("\n");
+  }
+  const lines = entries.map((e) => {
+    const date = e.createdAt?.slice(0, 10) ?? "\u2014";
+    const files = e.fileCount !== null ? `${e.fileCount} file${e.fileCount !== 1 ? "s" : ""}` : "? files";
+    const desc = e.description != null && e.description.trim() !== "" ? `  ${e.description.trim()}` : "";
+    return `${e.id}  [${date}] [${files}]${desc}`;
+  });
+  return lines.join("\n") + "\n";
+}
+function renderCapsuleInspect(manifest, format) {
+  if (format === "json") {
+    return JSON.stringify(manifest, null, 2);
+  }
+  const {
+    capsuleId,
+    version,
+    schemaVersion,
+    createdAt,
+    pluginVersion,
+    fileCount,
+    includesTranscripts,
+    description,
+    parentCapsule,
+    retrievalPolicy,
+    includes,
+    topFiles
+  } = manifest;
+  if (format === "markdown") {
+    const policyLines = Object.entries(retrievalPolicy.tierWeights ?? {}).map(
+      ([k, v]) => `  - ${k}: ${v}`
+    );
+    const policyBlock = policyLines.length > 0 ? policyLines.join("\n") : "  _(no tier weight overrides)_";
+    return [
+      `# Capsule: \`${capsuleId}\``,
+      "",
+      `**Version:** ${version}  `,
+      `**Schema version:** ${schemaVersion}  `,
+      `**Created:** ${createdAt ?? "\u2014"}  `,
+      `**Plugin version:** ${pluginVersion ?? "\u2014"}  `,
+      `**Files:** ${fileCount}  `,
+      `**Includes transcripts:** ${includesTranscripts ? "yes" : "no"}  `,
+      `**Parent capsule:** ${parentCapsule ?? "_none_"}  `,
+      `**Description:** ${description && description.trim() !== "" ? description.trim() : "_none_"}  `,
+      "",
+      "## Includes",
+      `- taxonomy: ${includes.taxonomy ? "yes" : "no"}`,
+      `- identityAnchors: ${includes.identityAnchors ? "yes" : "no"}`,
+      `- peerProfiles: ${includes.peerProfiles ? "yes" : "no"}`,
+      `- procedural: ${includes.procedural ? "yes" : "no"}`,
+      "",
+      "## Retrieval policy",
+      `- directAnswerEnabled: ${retrievalPolicy.directAnswerEnabled ? "yes" : "no"}`,
+      `- tierWeights:`,
+      policyBlock,
+      "",
+      ...topFiles.length > 0 ? [
+        `## Files (${fileCount} total, showing first ${topFiles.length})`,
+        ...topFiles.map((f) => `- \`${f}\``),
+        ""
+      ] : [`## Files (${fileCount} total)`, "_Empty capsule._", ""]
+    ].join("\n");
+  }
+  const lines = [
+    `Capsule: ${capsuleId}`,
+    `  version:          ${version}`,
+    `  schema:           ${schemaVersion}`,
+    `  created:          ${createdAt ?? "\u2014"}`,
+    `  plugin:           ${pluginVersion ?? "\u2014"}`,
+    `  files:            ${fileCount}`,
+    `  transcripts:      ${includesTranscripts ? "yes" : "no"}`,
+    `  parent:           ${parentCapsule ?? "(none)"}`,
+    `  description:      ${description && description.trim() !== "" ? description.trim() : "(none)"}`,
+    "",
+    `  includes.taxonomy:        ${includes.taxonomy ? "yes" : "no"}`,
+    `  includes.identityAnchors: ${includes.identityAnchors ? "yes" : "no"}`,
+    `  includes.peerProfiles:    ${includes.peerProfiles ? "yes" : "no"}`,
+    `  includes.procedural:      ${includes.procedural ? "yes" : "no"}`,
+    "",
+    `  policy.directAnswer:   ${retrievalPolicy.directAnswerEnabled ? "yes" : "no"}`
+  ];
+  const weights = Object.entries(retrievalPolicy.tierWeights ?? {});
+  if (weights.length > 0) {
+    for (const [k, v] of weights) {
+      lines.push(`  policy.tierWeight[${k}]: ${v}`);
+    }
+  } else {
+    lines.push(`  policy.tierWeights:    (none)`);
+  }
+  if (topFiles.length > 0) {
+    lines.push("", `  files (first ${topFiles.length} of ${fileCount}):`);
+    for (const f of topFiles) {
+      lines.push(`    ${f}`);
+    }
+  }
+  return lines.join("\n") + "\n";
+}
+
+export {
+  parseCapsuleOutputFormat,
+  parseCapsuleImportMode,
+  parseCapsuleConflictMode,
+  parseCapsuleSince,
+  parseCapsuleIncludeKinds,
+  parseCapsulePeers,
+  parseCapsuleExportOptions,
+  parseCapsuleImportOptions,
+  parseCapsuleMergeOptions,
+  parseCapsuleListOptions,
+  parseCapsuleInspectOptions,
+  defaultCapsulesDir,
+  renderCapsuleList,
+  renderCapsuleInspect
+};
+//# sourceMappingURL=chunk-74EMIVE4.js.map

package/dist/chunk-74EMIVE4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/capsule-cli.ts"],"sourcesContent":["/**\n * Pure-function helpers for the `remnic capsule` CLI surface (issue #676 PR 6/6).\n *\n * All functions here are free of orchestrator / filesystem side-effects so\n * they can be unit-tested without booting the gateway (CLAUDE.md rules 14, 51).\n *\n * Responsibilities:\n *  - Input validation + option parsing for every capsule sub-command flag.\n *  - Rendering of `capsule list` and `capsule inspect` output in text /\n *    markdown / json forms.\n *\n * The actual I/O (export, import, merge, directory listing, manifest read) is\n * wired in `cli.ts` because those operations need the orchestrator's config.\n */\n\nimport path from \"node:path\";\n\n// ---------------------------------------------------------------------------\n// Shared types\n// ---------------------------------------------------------------------------\n\nexport type CapsuleOutputFormat = \"text\" | \"markdown\" | \"json\";\n\n/**\n * Metadata entry returned by `capsule list` for a single archive file found\n * in the capsule store directory.\n */\nexport interface CapsuleListEntry {\n  /** Capsule id extracted from the filename (slug before `.capsule.json.gz`). */\n  id: string;\n  /** Absolute path to the `.capsule.json.gz` archive. */\n  archivePath: string;\n  /** Absolute path to the sidecar `.manifest.json`, or null if missing. */\n  manifestPath: string | null;\n  /** `createdAt` ISO string from the sidecar manifest, or null if unreadable. */\n  createdAt: string | null;\n  /** `pluginVersion` from the sidecar manifest, or null. */\n  pluginVersion: string | null;\n  /** `files` array length from the sidecar manifest, or null. */\n  fileCount: number | null;\n  /** `capsule.description` from the sidecar manifest, or null. */\n  description: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// Validation helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Validate and coerce the `--format` flag value.\n *\n * Rule 51: invalid values must throw with a listed-options error, not silently\n * fall back to a default.\n */\nexport function parseCapsuleOutputFormat(\n  raw: unknown,\n): CapsuleOutputFormat {\n  if (raw === undefined || raw === null) return \"text\";\n  if (typeof raw !== \"string\" || raw.trim() === \"\") {\n    throw new Error(\n      `--format expects one of text, markdown, json; got ${JSON.stringify(raw)}`,\n    );\n  }\n  const v = raw.trim() as CapsuleOutputFormat;\n  if (v !== \"text\" && v !== \"markdown\" && v !== \"json\") {\n    throw new Error(\n      `--format expects one of text, markdown, json; got ${JSON.stringify(raw)}`,\n    );\n  }\n  return v;\n}\n\n/**\n * Validate and coerce the `--mode` flag for `capsule import`.\n */\nexport function parseCapsuleImportMode(\n  raw: unknown,\n): \"skip\" | \"overwrite\" | \"fork\" {\n  if (raw === undefined || raw === null) return \"skip\";\n  if (typeof raw !== \"string\" || raw.trim() === \"\") {\n    throw new Error(\n      `--mode expects one of skip, overwrite, fork; got ${JSON.stringify(raw)}`,\n    );\n  }\n  const v = raw.trim();\n  if (v !== \"skip\" && v !== \"overwrite\" && v !== \"fork\") {\n    throw new Error(\n      `--mode expects one of skip, overwrite, fork; got ${JSON.stringify(raw)}`,\n    );\n  }\n  return v as \"skip\" | \"overwrite\" | \"fork\";\n}\n\n/**\n * Validate and coerce the `--conflict-mode` flag for `capsule merge`.\n */\nexport function parseCapsuleConflictMode(\n  raw: unknown,\n): \"skip-conflicts\" | \"prefer-source\" | \"prefer-local\" {\n  if (raw === undefined || raw === null) return \"skip-conflicts\";\n  if (typeof raw !== \"string\" || raw.trim() === \"\") {\n    throw new Error(\n      `--conflict-mode expects one of skip-conflicts, prefer-source, prefer-local; got ${JSON.stringify(raw)}`,\n    );\n  }\n  const v = raw.trim();\n  if (v !== \"skip-conflicts\" && v !== \"prefer-source\" && v !== \"prefer-local\") {\n    throw new Error(\n      `--conflict-mode expects one of skip-conflicts, prefer-source, prefer-local; got ${JSON.stringify(raw)}`,\n    );\n  }\n  return v as \"skip-conflicts\" | \"prefer-source\" | \"prefer-local\";\n}\n\n/**\n * Parse and validate the `--since` ISO-8601 string.\n *\n * Accepts date-only (`YYYY-MM-DD`) and date+time with explicit timezone\n * (`YYYY-MM-DDTHH:MM...Z` / `±HH:MM`). Rejects datetime without a timezone\n * designator (host-dependent interpretation, Rule 51).\n */\nconst ISO_8601_RE =\n  /^\\d{4}-\\d{2}-\\d{2}(?:[Tt]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?(?:[Zz]|[+-]\\d{2}:?\\d{2}))?$/;\n\nexport function parseCapsuleSince(raw: unknown): string | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (typeof raw !== \"string\") {\n    throw new Error(\n      `--since expects an ISO 8601 timestamp; got ${JSON.stringify(raw)}`,\n    );\n  }\n  if (raw.trim() === \"\") {\n    throw new Error(`--since expects an ISO 8601 timestamp; received empty string`);\n  }\n  if (!ISO_8601_RE.test(raw)) {\n    throw new Error(\n      `--since is not a valid ISO 8601 timestamp: ${raw}. ` +\n        `Accepted forms: YYYY-MM-DD, YYYY-MM-DDTHH:MM:SSZ, YYYY-MM-DDTHH:MM:SS±HH:MM`,\n    );\n  }\n  const ms = Date.parse(raw);\n  if (!Number.isFinite(ms)) {\n    throw new Error(`--since is not a valid ISO 8601 timestamp: ${raw}`);\n  }\n  // Calendar overflow detection (same logic as capsule-export.ts parseSince).\n  const m = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(raw);\n  if (m) {\n    const offsetMatch = /([+-])(\\d{2}):?(\\d{2})$/.exec(raw);\n    let displayMs = ms;\n    if (offsetMatch) {\n      const sign = offsetMatch[1] === \"-\" ? -1 : 1;\n      const offsetMin = sign * (Number(offsetMatch[2]) * 60 + Number(offsetMatch[3]));\n      displayMs = ms + offsetMin * 60_000;\n    }\n    const dd = new Date(displayMs);\n    if (\n      dd.getUTCFullYear() !== Number(m[1]) ||\n      dd.getUTCMonth() + 1 !== Number(m[2]) ||\n      dd.getUTCDate() !== Number(m[3])\n    ) {\n      throw new Error(\n        `--since: calendar overflow — ${raw} normalises to a different calendar date`,\n      );\n    }\n  }\n  return raw;\n}\n\n/**\n * Parse a comma-separated `--include-kinds` value into an array of non-empty\n * top-level directory names. Rejects values containing path separators.\n */\nexport function parseCapsuleIncludeKinds(raw: unknown): string[] | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (typeof raw !== \"string\") {\n    throw new Error(\n      `--include-kinds expects a comma-separated list of directory names; got ${JSON.stringify(raw)}`,\n    );\n  }\n  if (raw.trim() === \"\") {\n    throw new Error(\n      `--include-kinds expects at least one non-empty kind name`,\n    );\n  }\n  const parts = raw\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter((s) => s.length > 0);\n  if (parts.length === 0) {\n    throw new Error(`--include-kinds expects at least one non-empty kind name`);\n  }\n  for (const p of parts) {\n    if (p.includes(\"/\") || p.includes(\"\\\\\")) {\n      throw new Error(\n        `--include-kinds entries must be top-level directory names (no path separators): ${p}`,\n      );\n    }\n  }\n  // Deduplicate while preserving order.\n  return [...new Set(parts)];\n}\n\n/**\n * Parse a comma-separated `--peers` value into an array of peer ids.\n */\nexport function parseCapsulePeers(raw: unknown): string[] | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (typeof raw !== \"string\") {\n    throw new Error(\n      `--peers expects a comma-separated list of peer ids; got ${JSON.stringify(raw)}`,\n    );\n  }\n  if (raw.trim() === \"\") {\n    throw new Error(`--peers expects at least one non-empty peer id`);\n  }\n  const parts = raw\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter((s) => s.length > 0);\n  if (parts.length === 0) {\n    throw new Error(`--peers expects at least one non-empty peer id`);\n  }\n  for (const p of parts) {\n    if (p.includes(\"/\") || p.includes(\"\\\\\") || p === \".\" || p === \"..\") {\n      throw new Error(\n        `--peers entries must be plain id tokens (no path separators): ${p}`,\n      );\n    }\n  }\n  return [...new Set(parts)];\n}\n\n// ---------------------------------------------------------------------------\n// Parsed option bags (returned by the parse helpers below and consumed by\n// cli.ts action handlers).\n// ---------------------------------------------------------------------------\n\nexport interface CapsuleExportOptions {\n  name: string;\n  out: string | undefined;\n  since: string | undefined;\n  includeKinds: string[] | undefined;\n  peers: string[] | undefined;\n}\n\nexport interface CapsuleImportOptions {\n  archive: string;\n  mode: \"skip\" | \"overwrite\" | \"fork\";\n}\n\nexport interface CapsuleMergeOptions {\n  archive: string;\n  conflictMode: \"skip-conflicts\" | \"prefer-source\" | \"prefer-local\";\n}\n\nexport interface CapsuleListOptions {\n  format: CapsuleOutputFormat;\n  capsulesDir: string;\n}\n\nexport interface CapsuleInspectOptions {\n  archive: string;\n  format: CapsuleOutputFormat;\n}\n\n// ---------------------------------------------------------------------------\n// Option bag parsers (Rule 51: validate + throw on bad input, never silently\n// default to a value that hides user misconfiguration).\n// ---------------------------------------------------------------------------\n\nexport function parseCapsuleExportOptions(\n  nameArg: unknown,\n  opts: Record<string, unknown>,\n): CapsuleExportOptions {\n  if (typeof nameArg !== \"string\" || nameArg.trim() === \"\") {\n    throw new Error(\n      `capsule export: <name> is required (e.g. \"remnic capsule export my-capsule\")`,\n    );\n  }\n  const name = nameArg.trim();\n\n  const out =\n    typeof opts.out === \"string\" && opts.out.trim() !== \"\"\n      ? opts.out.trim()\n      : undefined;\n\n  const since = parseCapsuleSince(opts.since);\n  const includeKinds = parseCapsuleIncludeKinds(opts.includeKinds);\n  const peers = parseCapsulePeers(opts.peers);\n\n  return { name, out, since, includeKinds, peers };\n}\n\nexport function parseCapsuleImportOptions(\n  archiveArg: unknown,\n  opts: Record<string, unknown>,\n): CapsuleImportOptions {\n  if (typeof archiveArg !== \"string\" || archiveArg.trim() === \"\") {\n    throw new Error(\n      `capsule import: <archive> path is required (e.g. \"remnic capsule import /path/to/my-capsule.capsule.json.gz\")`,\n    );\n  }\n  const archive = archiveArg.trim();\n  const mode = parseCapsuleImportMode(opts.mode);\n  return { archive, mode };\n}\n\nexport function parseCapsuleMergeOptions(\n  archiveArg: unknown,\n  opts: Record<string, unknown>,\n): CapsuleMergeOptions {\n  if (typeof archiveArg !== \"string\" || archiveArg.trim() === \"\") {\n    throw new Error(\n      `capsule merge: <archive> path is required (e.g. \"remnic capsule merge /path/to/my-capsule.capsule.json.gz\")`,\n    );\n  }\n  const archive = archiveArg.trim();\n  const conflictMode = parseCapsuleConflictMode(opts.conflictMode);\n  return { archive, conflictMode };\n}\n\nexport function parseCapsuleListOptions(\n  opts: Record<string, unknown>,\n  defaultCapsulesDir: string,\n): CapsuleListOptions {\n  const format = parseCapsuleOutputFormat(opts.format);\n  const rawDir =\n    typeof opts.dir === \"string\" && opts.dir.trim() !== \"\"\n      ? opts.dir.trim()\n      : undefined;\n  const capsulesDir = rawDir ?? defaultCapsulesDir;\n  return { format, capsulesDir };\n}\n\nexport function parseCapsuleInspectOptions(\n  archiveArg: unknown,\n  opts: Record<string, unknown>,\n): CapsuleInspectOptions {\n  if (typeof archiveArg !== \"string\" || archiveArg.trim() === \"\") {\n    throw new Error(\n      `capsule inspect: <archive> path is required (e.g. \"remnic capsule inspect my-capsule.capsule.json.gz\")`,\n    );\n  }\n  const archive = archiveArg.trim();\n  const format = parseCapsuleOutputFormat(opts.format);\n  return { archive, format };\n}\n\n// ---------------------------------------------------------------------------\n// Default capsules directory\n// ---------------------------------------------------------------------------\n\n/**\n * Return the default capsule store directory for a given memory root.\n * This mirrors the `outDir` default in `exportCapsule` (`<root>/.capsules`)\n * so that `capsule list` discovers archives written by `capsule export`\n * without extra configuration.\n *\n * For `capsule list`, the POSIX conventional path is:\n *   `<memoryDir>/.capsules`\n *\n * Operators can override it with `--dir <path>` at runtime.\n */\nexport function defaultCapsulesDir(memoryDir: string): string {\n  return path.join(memoryDir, \".capsules\");\n}\n\n// ---------------------------------------------------------------------------\n// Renderers\n// ---------------------------------------------------------------------------\n\nfunction escapeMarkdownCell(v: string): string {\n  return v.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\|/g, \"\\\\|\");\n}\n\n/**\n * Render the `capsule list` output.\n */\nexport function renderCapsuleList(\n  entries: CapsuleListEntry[],\n  format: CapsuleOutputFormat,\n): string {\n  if (format === \"json\") {\n    return JSON.stringify({ capsules: entries }, null, 2);\n  }\n\n  if (entries.length === 0) {\n    if (format === \"markdown\") return \"_No capsule archives found._\\n\";\n    return \"No capsule archives found.\\n\";\n  }\n\n  if (format === \"markdown\") {\n    const rows = entries.map((e) => {\n      const id = escapeMarkdownCell(e.id);\n      const date = escapeMarkdownCell(e.createdAt?.slice(0, 10) ?? \"—\");\n      const ver = escapeMarkdownCell(e.pluginVersion ?? \"—\");\n      const files = e.fileCount !== null ? String(e.fileCount) : \"—\";\n      const desc = escapeMarkdownCell(\n        e.description != null && e.description.trim() !== \"\"\n          ? e.description.trim()\n          : \"—\",\n      );\n      return `| \\`${id}\\` | ${date} | ${ver} | ${files} | ${desc} |`;\n    });\n    return [\n      \"# Capsule archives\",\n      \"\",\n      \"| ID | Created | Version | Files | Description |\",\n      \"| -- | ------- | ------- | ----- | ----------- |\",\n      ...rows,\n      \"\",\n    ].join(\"\\n\");\n  }\n\n  // text\n  const lines = entries.map((e) => {\n    const date = e.createdAt?.slice(0, 10) ?? \"—\";\n    const files =\n      e.fileCount !== null ? `${e.fileCount} file${e.fileCount !== 1 ? \"s\" : \"\"}` : \"? files\";\n    const desc =\n      e.description != null && e.description.trim() !== \"\"\n        ? `  ${e.description.trim()}`\n        : \"\";\n    return `${e.id}  [${date}] [${files}]${desc}`;\n  });\n  return lines.join(\"\\n\") + \"\\n\";\n}\n\n/**\n * Render the `capsule inspect` output from a manifest object.\n */\nexport function renderCapsuleInspect(\n  manifest: CapsuleInspectData,\n  format: CapsuleOutputFormat,\n): string {\n  if (format === \"json\") {\n    return JSON.stringify(manifest, null, 2);\n  }\n\n  const {\n    capsuleId,\n    version,\n    schemaVersion,\n    createdAt,\n    pluginVersion,\n    fileCount,\n    includesTranscripts,\n    description,\n    parentCapsule,\n    retrievalPolicy,\n    includes,\n    topFiles,\n  } = manifest;\n\n  if (format === \"markdown\") {\n    const policyLines = Object.entries(retrievalPolicy.tierWeights ?? {}).map(\n      ([k, v]) => `  - ${k}: ${v}`,\n    );\n    const policyBlock =\n      policyLines.length > 0\n        ? policyLines.join(\"\\n\")\n        : \"  _(no tier weight overrides)_\";\n\n    return [\n      `# Capsule: \\`${capsuleId}\\``,\n      \"\",\n      `**Version:** ${version}  `,\n      `**Schema version:** ${schemaVersion}  `,\n      `**Created:** ${createdAt ?? \"—\"}  `,\n      `**Plugin version:** ${pluginVersion ?? \"—\"}  `,\n      `**Files:** ${fileCount}  `,\n      `**Includes transcripts:** ${includesTranscripts ? \"yes\" : \"no\"}  `,\n      `**Parent capsule:** ${parentCapsule ?? \"_none_\"}  `,\n      `**Description:** ${description && description.trim() !== \"\" ? description.trim() : \"_none_\"}  `,\n      \"\",\n      \"## Includes\",\n      `- taxonomy: ${includes.taxonomy ? \"yes\" : \"no\"}`,\n      `- identityAnchors: ${includes.identityAnchors ? \"yes\" : \"no\"}`,\n      `- peerProfiles: ${includes.peerProfiles ? \"yes\" : \"no\"}`,\n      `- procedural: ${includes.procedural ? \"yes\" : \"no\"}`,\n      \"\",\n      \"## Retrieval policy\",\n      `- directAnswerEnabled: ${retrievalPolicy.directAnswerEnabled ? \"yes\" : \"no\"}`,\n      `- tierWeights:`,\n      policyBlock,\n      \"\",\n      ...(topFiles.length > 0\n        ? [\n            `## Files (${fileCount} total, showing first ${topFiles.length})`,\n            ...topFiles.map((f) => `- \\`${f}\\``),\n            \"\",\n          ]\n        : [`## Files (${fileCount} total)`, \"_Empty capsule._\", \"\"]),\n    ].join(\"\\n\");\n  }\n\n  // text\n  const lines: string[] = [\n    `Capsule: ${capsuleId}`,\n    `  version:          ${version}`,\n    `  schema:           ${schemaVersion}`,\n    `  created:          ${createdAt ?? \"—\"}`,\n    `  plugin:           ${pluginVersion ?? \"—\"}`,\n    `  files:            ${fileCount}`,\n    `  transcripts:      ${includesTranscripts ? \"yes\" : \"no\"}`,\n    `  parent:           ${parentCapsule ?? \"(none)\"}`,\n    `  description:      ${description && description.trim() !== \"\" ? description.trim() : \"(none)\"}`,\n    \"\",\n    `  includes.taxonomy:        ${includes.taxonomy ? \"yes\" : \"no\"}`,\n    `  includes.identityAnchors: ${includes.identityAnchors ? \"yes\" : \"no\"}`,\n    `  includes.peerProfiles:    ${includes.peerProfiles ? \"yes\" : \"no\"}`,\n    `  includes.procedural:      ${includes.procedural ? \"yes\" : \"no\"}`,\n    \"\",\n    `  policy.directAnswer:   ${retrievalPolicy.directAnswerEnabled ? \"yes\" : \"no\"}`,\n  ];\n\n  const weights = Object.entries(retrievalPolicy.tierWeights ?? {});\n  if (weights.length > 0) {\n    for (const [k, v] of weights) {\n      lines.push(`  policy.tierWeight[${k}]: ${v}`);\n    }\n  } else {\n    lines.push(`  policy.tierWeights:    (none)`);\n  }\n\n  if (topFiles.length > 0) {\n    lines.push(\"\", `  files (first ${topFiles.length} of ${fileCount}):`);\n    for (const f of topFiles) {\n      lines.push(`    ${f}`);\n    }\n  }\n\n  return lines.join(\"\\n\") + \"\\n\";\n}\n\n/**\n * Data shape consumed by {@link renderCapsuleInspect}.\n * Populated by the cli.ts action handler from the parsed manifest.\n */\nexport interface CapsuleInspectData {\n  capsuleId: string;\n  version: string;\n  schemaVersion: string;\n  createdAt: string | null;\n  pluginVersion: string | null;\n  fileCount: number;\n  includesTranscripts: boolean;\n  description: string;\n  parentCapsule: string | null;\n  retrievalPolicy: {\n    tierWeights: Record<string, number>;\n    directAnswerEnabled: boolean;\n  };\n  includes: {\n    taxonomy: boolean;\n    identityAnchors: boolean;\n    peerProfiles: boolean;\n    procedural: boolean;\n  };\n  /** First N file paths from manifest.files (for preview). */\n  topFiles: string[];\n}\n"],"mappings":"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","names":["defaultCapsulesDir"]}

package/dist/chunk-74WWN7ZW.js

@@ -0,0 +1,82 @@
+// src/evidence-pack.ts
+var DEFAULT_MAX_ITEM_CHARS = 1200;
+function buildEvidencePack(items, options) {
+  const budget = normalizePositiveInteger(options.maxChars);
+  if (budget <= 0 || items.length === 0) {
+    return "";
+  }
+  const maxItemChars = normalizePositiveInteger(
+    options.maxItemChars ?? DEFAULT_MAX_ITEM_CHARS
+  );
+  if (maxItemChars <= 0) {
+    return "";
+  }
+  const title = options.title ?? "Evidence";
+  const lines = [`## ${title}`];
+  const seenIds = /* @__PURE__ */ new Set();
+  const seenContent = /* @__PURE__ */ new Set();
+  let used = lines[0].length;
+  for (const item of items) {
+    const content = item.content.trim();
+    if (!content) continue;
+    const id = item.id ?? evidenceItemFallbackId(item);
+    if (id && seenIds.has(id)) continue;
+    const contentKey = normalizeEvidenceContent(content);
+    if (seenContent.has(contentKey)) continue;
+    const label = formatEvidenceLabel(item);
+    const clipped = clipText(content, maxItemChars);
+    const block = `${label}: ${clipped}`;
+    const separatorLength = lines.length > 0 ? 2 : 0;
+    const remaining = budget - used - separatorLength;
+    if (remaining <= 0) break;
+    const finalBlock = block.length > remaining ? clipText(block, remaining) : block;
+    if (!finalBlock.trim()) break;
+    lines.push(finalBlock);
+    used += separatorLength + finalBlock.length;
+    if (id) seenIds.add(id);
+    seenContent.add(contentKey);
+  }
+  return lines.length === 1 ? "" : lines.join("\n\n");
+}
+function normalizePositiveInteger(value) {
+  if (!Number.isFinite(value) || value <= 0) {
+    return 0;
+  }
+  return Math.floor(value);
+}
+function evidenceItemFallbackId(item) {
+  if (item.sessionId && typeof item.turnIndex === "number") {
+    return `${item.sessionId}:${item.turnIndex}`;
+  }
+  return void 0;
+}
+function normalizeEvidenceContent(content) {
+  return content.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function formatEvidenceLabel(item) {
+  const parts = [];
+  if (item.sessionId) parts.push(item.sessionId);
+  if (typeof item.turnIndex === "number") parts.push(`turn ${item.turnIndex}`);
+  if (item.role) parts.push(item.role);
+  if (typeof item.score === "number" && Number.isFinite(item.score)) {
+    parts.push(`score ${item.score.toFixed(3)}`);
+  }
+  return parts.length > 0 ? `[${parts.join(", ")}]` : "[evidence]";
+}
+function clipText(text, maxChars) {
+  if (text.length <= maxChars) {
+    return text;
+  }
+  if (maxChars <= 1) {
+    return text.slice(0, maxChars);
+  }
+  if (maxChars <= 3) {
+    return text.slice(0, maxChars);
+  }
+  return `${text.slice(0, maxChars - 3).trimEnd()}...`;
+}
+
+export {
+  buildEvidencePack
+};
+//# sourceMappingURL=chunk-74WWN7ZW.js.map

package/dist/chunk-74WWN7ZW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/evidence-pack.ts"],"sourcesContent":["export interface EvidencePackItem {\n  id?: string;\n  sessionId?: string;\n  turnIndex?: number;\n  role?: string;\n  content: string;\n  score?: number;\n}\n\nexport interface EvidencePackOptions {\n  title?: string;\n  maxChars: number;\n  maxItemChars?: number;\n}\n\nconst DEFAULT_MAX_ITEM_CHARS = 1_200;\n\nexport function buildEvidencePack(\n  items: readonly EvidencePackItem[],\n  options: EvidencePackOptions,\n): string {\n  const budget = normalizePositiveInteger(options.maxChars);\n  if (budget <= 0 || items.length === 0) {\n    return \"\";\n  }\n\n  const maxItemChars = normalizePositiveInteger(\n    options.maxItemChars ?? DEFAULT_MAX_ITEM_CHARS,\n  );\n  if (maxItemChars <= 0) {\n    return \"\";\n  }\n\n  const title = options.title ?? \"Evidence\";\n  const lines: string[] = [`## ${title}`];\n  const seenIds = new Set<string>();\n  const seenContent = new Set<string>();\n  let used = lines[0]!.length;\n\n  for (const item of items) {\n    const content = item.content.trim();\n    if (!content) continue;\n\n    const id = item.id ?? evidenceItemFallbackId(item);\n    if (id && seenIds.has(id)) continue;\n\n    const contentKey = normalizeEvidenceContent(content);\n    if (seenContent.has(contentKey)) continue;\n\n    const label = formatEvidenceLabel(item);\n    const clipped = clipText(content, maxItemChars);\n    const block = `${label}: ${clipped}`;\n    const separatorLength = lines.length > 0 ? 2 : 0;\n    const remaining = budget - used - separatorLength;\n    if (remaining <= 0) break;\n\n    const finalBlock =\n      block.length > remaining ? clipText(block, remaining) : block;\n    if (!finalBlock.trim()) break;\n\n    lines.push(finalBlock);\n    used += separatorLength + finalBlock.length;\n    if (id) seenIds.add(id);\n    seenContent.add(contentKey);\n  }\n\n  return lines.length === 1 ? \"\" : lines.join(\"\\n\\n\");\n}\n\nfunction normalizePositiveInteger(value: number): number {\n  if (!Number.isFinite(value) || value <= 0) {\n    return 0;\n  }\n  return Math.floor(value);\n}\n\nfunction evidenceItemFallbackId(item: EvidencePackItem): string | undefined {\n  if (item.sessionId && typeof item.turnIndex === \"number\") {\n    return `${item.sessionId}:${item.turnIndex}`;\n  }\n  return undefined;\n}\n\nfunction normalizeEvidenceContent(content: string): string {\n  return content.toLowerCase().replace(/\\s+/g, \" \").trim();\n}\n\nfunction formatEvidenceLabel(item: EvidencePackItem): string {\n  const parts: string[] = [];\n  if (item.sessionId) parts.push(item.sessionId);\n  if (typeof item.turnIndex === \"number\") parts.push(`turn ${item.turnIndex}`);\n  if (item.role) parts.push(item.role);\n  if (typeof item.score === \"number\" && Number.isFinite(item.score)) {\n    parts.push(`score ${item.score.toFixed(3)}`);\n  }\n  return parts.length > 0 ? `[${parts.join(\", \")}]` : \"[evidence]\";\n}\n\nfunction clipText(text: string, maxChars: number): string {\n  if (text.length <= maxChars) {\n    return text;\n  }\n  if (maxChars <= 1) {\n    return text.slice(0, maxChars);\n  }\n  if (maxChars <= 3) {\n    return text.slice(0, maxChars);\n  }\n  return `${text.slice(0, maxChars - 3).trimEnd()}...`;\n}\n"],"mappings":";AAeA,IAAM,yBAAyB;AAExB,SAAS,kBACd,OACA,SACQ;AACR,QAAM,SAAS,yBAAyB,QAAQ,QAAQ;AACxD,MAAI,UAAU,KAAK,MAAM,WAAW,GAAG;AACrC,WAAO;AAAA,EACT;AAEA,QAAM,eAAe;AAAA,IACnB,QAAQ,gBAAgB;AAAA,EAC1B;AACA,MAAI,gBAAgB,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,QAAkB,CAAC,MAAM,KAAK,EAAE;AACtC,QAAM,UAAU,oBAAI,IAAY;AAChC,QAAM,cAAc,oBAAI,IAAY;AACpC,MAAI,OAAO,MAAM,CAAC,EAAG;AAErB,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAU,KAAK,QAAQ,KAAK;AAClC,QAAI,CAAC,QAAS;AAEd,UAAM,KAAK,KAAK,MAAM,uBAAuB,IAAI;AACjD,QAAI,MAAM,QAAQ,IAAI,EAAE,EAAG;AAE3B,UAAM,aAAa,yBAAyB,OAAO;AACnD,QAAI,YAAY,IAAI,UAAU,EAAG;AAEjC,UAAM,QAAQ,oBAAoB,IAAI;AACtC,UAAM,UAAU,SAAS,SAAS,YAAY;AAC9C,UAAM,QAAQ,GAAG,KAAK,KAAK,OAAO;AAClC,UAAM,kBAAkB,MAAM,SAAS,IAAI,IAAI;AAC/C,UAAM,YAAY,SAAS,OAAO;AAClC,QAAI,aAAa,EAAG;AAEpB,UAAM,aACJ,MAAM,SAAS,YAAY,SAAS,OAAO,SAAS,IAAI;AAC1D,QAAI,CAAC,WAAW,KAAK,EAAG;AAExB,UAAM,KAAK,UAAU;AACrB,YAAQ,kBAAkB,WAAW;AACrC,QAAI,GAAI,SAAQ,IAAI,EAAE;AACtB,gBAAY,IAAI,UAAU;AAAA,EAC5B;AAEA,SAAO,MAAM,WAAW,IAAI,KAAK,MAAM,KAAK,MAAM;AACpD;AAEA,SAAS,yBAAyB,OAAuB;AACvD,MAAI,CAAC,OAAO,SAAS,KAAK,KAAK,SAAS,GAAG;AACzC,WAAO;AAAA,EACT;AACA,SAAO,KAAK,MAAM,KAAK;AACzB;AAEA,SAAS,uBAAuB,MAA4C;AAC1E,MAAI,KAAK,aAAa,OAAO,KAAK,cAAc,UAAU;AACxD,WAAO,GAAG,KAAK,SAAS,IAAI,KAAK,SAAS;AAAA,EAC5C;AACA,SAAO;AACT;AAEA,SAAS,yBAAyB,SAAyB;AACzD,SAAO,QAAQ,YAAY,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACzD;AAEA,SAAS,oBAAoB,MAAgC;AAC3D,QAAM,QAAkB,CAAC;AACzB,MAAI,KAAK,UAAW,OAAM,KAAK,KAAK,SAAS;AAC7C,MAAI,OAAO,KAAK,cAAc,SAAU,OAAM,KAAK,QAAQ,KAAK,SAAS,EAAE;AAC3E,MAAI,KAAK,KAAM,OAAM,KAAK,KAAK,IAAI;AACnC,MAAI,OAAO,KAAK,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,GAAG;AACjE,UAAM,KAAK,SAAS,KAAK,MAAM,QAAQ,CAAC,CAAC,EAAE;AAAA,EAC7C;AACA,SAAO,MAAM,SAAS,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM;AACtD;AAEA,SAAS,SAAS,MAAc,UAA0B;AACxD,MAAI,KAAK,UAAU,UAAU;AAC3B,WAAO;AAAA,EACT;AACA,MAAI,YAAY,GAAG;AACjB,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AACA,MAAI,YAAY,GAAG;AACjB,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AACA,SAAO,GAAG,KAAK,MAAM,GAAG,WAAW,CAAC,EAAE,QAAQ,CAAC;AACjD;","names":[]}