@clarify-labs/cli 0.11.2 → 0.11.4

package/output/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_engine = require("./engine--5unu78V.cjs");
+const require_engine = require("./engine-Cgc71w13.cjs");
 exports.ClarifyEngine = require_engine.ClarifyEngine;
 exports.createClarifyEngine = require_engine.createClarifyEngine;
 exports.createViteAdapter = require_engine.createViteAdapter;

package/output/index.js

@@ -1,2 +1,2 @@
-import { l as createViteAdapter, n as createClarifyEngine, t as ClarifyEngine, u as defineConfig } from "./engine-DI8Nd3v0.js";
+import { l as createViteAdapter, n as createClarifyEngine, t as ClarifyEngine, u as defineConfig } from "./engine-CJmXVTo5.js";
 export { ClarifyEngine, createClarifyEngine, createViteAdapter, defineConfig };

package/output/parsers/markdown/markdown.d.ts

@@ -0,0 +1,34 @@
+import { ContentDiagnostic } from '../../types.js';
+type CompileMarkdownContentOptions = {
+    filePath?: string;
+    projectRoot?: string;
+};
+/**
+ * Validate Markdown content for diagnostics WITHOUT running the build-time
+ * rehype pipeline (Shiki highlighting, slug injection, code-block parsing).
+ *
+ * `rehypePlugins` includes `rehypeShiki`, which loads grammar/WASM assets and
+ * is expensive. The real highlighting happens at Vite build time via the
+ * `@mdx-js/rollup` plugin (see `createContentCompilerPlugin` in
+ * `core/adapters.ts`), which runs the full remark + rehype pipeline.
+ * Re-running it here, during route discovery (Phase 3), would compile every
+ * `.md` file twice and invoke Shiki once per file per `engine.refresh()` -
+ * see ARCHITECTURE.md §2.2 which states "不应在 core 中执行代码高亮".
+ *
+ * `format: 'md'` mirrors the adapter's markdown compiler semantics (no JSX,
+ * raw HTML allowed via `remarkRehypeOptions`), so the same class of syntax
+ * errors that would break the Vite build is surfaced as a diagnostic here
+ * instead of leaking out as an opaque
+ * `Failed to fetch dynamically imported module` at runtime.
+ *
+ * MDX files are handled by `compileMdxContent` in `mdx.ts`. Keep the two
+ * compilers separate so each format can evolve its own diagnostic rules
+ * without contaminating the other.
+ */
+export declare function compileMarkdownContent(content: string, options?: CompileMarkdownContentOptions): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    diagnostic: ContentDiagnostic;
+}>;
+export {};

package/output/parsers/markdown/mdx.d.ts

@@ -18,25 +18,33 @@ type ContentCompileDiagnosticOptions = {
     projectRoot?: string;
 };
 export declare function createContentCompileDiagnostic(options: ContentCompileDiagnosticOptions): ContentDiagnostic;
+type CompileContentOptions = {
+    filePath?: string;
+    projectRoot?: string;
+};
 /**
  * Validate MDX content for diagnostics WITHOUT running the build-time rehype
  * pipeline (Shiki highlighting, slug injection, code-block parsing).
  *
  * `rehypePlugins` includes `rehypeShiki`, which loads grammar/WASM assets and
  * is expensive. The real highlighting happens at Vite build time via the
- * `@mdx-js/rollup` plugins (see `createMarkdownPlugin` and `createMdxPlugin`
- * in `core/adapters.ts`), which
- * runs the full remark + rehype pipeline. Re-running it here, during route
- * discovery (Phase 3), would compile every `.mdx` file twice and invoke Shiki
- * once per file per `engine.refresh()` — see ARCHITECTURE.md §2.2 which states
- * "不应在 core 中执行代码高亮".
+ * `@mdx-js/rollup` plugin (see `createContentCompilerPlugin` in
+ * `core/adapters.ts`), which runs the full remark + rehype pipeline.
+ * Re-running it here, during route discovery (Phase 3), would compile every
+ * `.mdx` file twice and invoke Shiki once per file per `engine.refresh()` -
+ * see ARCHITECTURE.md §2.2 which states "不应在 core 中执行代码高亮".
  *
  * The remark pipeline still runs (shared with the Vite plugin via
- * `remarkPlugins`), so MDX/JSX syntax errors — the only class of error this
- * diagnostic is meant to surface ahead of the Vite build — are caught. The
+ * `remarkPlugins`), so MDX/JSX syntax errors - the only class of error this
+ * diagnostic is meant to surface ahead of the Vite build - are caught. The
  * output is discarded; only the thrown error is used.
+ *
+ * `.md` files are handled by `compileMarkdownContent` in `markdown.ts`, which
+ * mirrors the adapter's markdown compiler semantics (`format: 'md'`, raw HTML
+ * allowed). Keep the two compilers separate so each format can evolve its own
+ * diagnostic rules without contaminating the other.
  */
-export declare function compileMdxContent(content: string, filePath?: string, projectRoot?: string): Promise<{
+export declare function compileMdxContent(content: string, options?: CompileContentOptions): Promise<{
     ok: true;
 } | {
     ok: false;

package/output/plugins/mcp-search/orama-index.d.ts

@@ -127,15 +127,16 @@ export type McpSearchResult = {
  */
 export declare function searchMcpIndex(db: McpSearchDb, params: McpSearchParams): McpSearchResult;
 /**
- * Serialize an Orama index to a msgpack binary buffer.
+ * Serialize an Orama index to a versioned, Brotli-compressed binary buffer.
  *
- * Uses `save()` to extract the raw index data, then msgpack-encodes it for a
- * compact binary representation. The same schema + tokenizer must be supplied
- * when loading so query-time tokenization matches indexing-time tokenization.
+ * Uses `save()` to extract the raw index data, MessagePack-encodes it, then
+ * compresses the payload so source documents are not embedded as contiguous
+ * plaintext. The leading magic bytes identify the container and its version.
  */
 export declare function serializeSearchIndex(db: McpSearchDb): Uint8Array;
 /**
- * Deserialize a msgpack binary buffer into a ready-to-search Orama index.
+ * Deserialize a current compressed container or legacy MessagePack buffer
+ * into a ready-to-search Orama index.
  *
  * The caller must supply the same `defaultLocale` used when the index was
  * built, so the tokenizer matches. A mismatch would not corrupt data but
@@ -144,10 +145,10 @@ export declare function serializeSearchIndex(db: McpSearchDb): Uint8Array;
  */
 export declare function deserializeSearchIndex(buffer: Uint8Array, defaultLocale?: string): McpSearchDb;
 /**
- * Write an Orama index to a `.msp` (msgpack) file on disk.
+ * Write an Orama index to a versioned `.msp` file on disk.
  */
 export declare function writeSearchIndex(db: McpSearchDb, filePath: string): void;
 /**
- * Read an Orama index from a `.msp` (msgpack) file on disk.
+ * Read a current or legacy Orama `.msp` index from disk.
  */
 export declare function readSearchIndex(filePath: string, defaultLocale?: string): McpSearchDb;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clarify-labs/cli",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "license": "AGPL-3.0-only",
   "type": "module",
   "repository": {
@@ -39,8 +39,8 @@
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
-    "@clarify-labs/renderer": "0.11.2",
-    "@clarify-labs/templates": "0.11.2",
+    "@clarify-labs/renderer": "0.11.4",
+    "@clarify-labs/templates": "0.11.4",
     "@mdx-js/mdx": "^3.1.1",
     "@mdx-js/rollup": "^3.1.1",
     "@modelcontextprotocol/sdk": "^1.29.0",