@refrakt-md/cli 0.10.1 → 0.11.0

package/dist/config-file.js

@@ -1,5 +1,6 @@
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
+import { loadRefraktConfigWithRaw, } from '@refrakt-md/transform/node';
 const PM_LOCKFILES = [
     {
         file: 'bun.lock',
@@ -30,17 +31,20 @@ export function detectPackageManager(cwd = process.cwd()) {
     }
     return NPM_DEFAULT;
 }
-/** Load refrakt.config.json from a directory */
+/** Load and normalize refrakt.config.json from a directory.
+ *
+ *  Delegates to `@refrakt-md/transform/node` so the CLI and framework adapters
+ *  share one normalization path. Returns both the raw input (for tools that
+ *  need to round-trip the original shape) and the normalized form. */
 export function loadRefraktConfigFile(cwd = process.cwd()) {
     const configPath = resolve(cwd, 'refrakt.config.json');
     if (!existsSync(configPath)) {
         throw new Error(`No refrakt.config.json found in ${cwd}`);
     }
-    const raw = readFileSync(configPath, 'utf-8');
-    const config = JSON.parse(raw);
-    return { path: configPath, config };
+    const { raw, normalized } = loadRefraktConfigWithRaw(configPath);
+    return { path: configPath, config: normalized, raw };
 }
-/** Write refrakt.config.json, preserving formatting */
+/** Write refrakt.config.json, preserving tab-indented formatting. */
 export function writeRefraktConfigFile(path, config) {
     writeFileSync(path, JSON.stringify(config, null, '\t') + '\n');
 }

package/dist/config-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../src/config-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,YAAY,GAAgD;IACjE;QACC,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE;KACtD;IACD;QACC,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE;KACtD;IACD;QACC,IAAI,EAAE,gBAAgB;QACtB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE;KACxD;IACD;QACC,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE;KACxD;CACD,CAAC;AAEF,MAAM,WAAW,GAAmB;IACnC,IAAI,EAAE,KAAK;IACX,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE;CACrC,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,oBAAoB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC/D,KAAK,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,YAAY,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,qBAAqB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAAqB;IACzE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../src/config-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACN,wBAAwB,GAExB,MAAM,4BAA4B,CAAC;AAOpC,MAAM,YAAY,GAAgD;IACjE;QACC,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE;KACtD;IACD;QACC,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE;KACtD;IACD;QACC,IAAI,EAAE,gBAAgB;QACtB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE;KACxD;IACD;QACC,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE;KACxD;CACD,CAAC;AAEF,MAAM,WAAW,GAAmB;IACnC,IAAI,EAAE,KAAK;IACX,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE;CACrC,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,oBAAoB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC/D,KAAK,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,YAAY,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;;sEAIsE;AACtE,MAAM,UAAU,qBAAqB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAKhE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACjE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AACtD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAAqB;IACzE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChE,CAAC"}

package/dist/lib/levenshtein.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tiny Levenshtein-distance "did you mean?" helper for CLI suggestions.
+ * Matches the implementation in `@refrakt-md/transform/node`'s `resolveSite`
+ * helper — kept local here so the CLI doesn't depend on transform internals.
+ */
+export declare function levenshtein(a: string, b: string): number;
+/** Return the candidate closest to `input`, but only when distance ≤ 2.
+ *  Returns undefined when there's no good match (avoids confusing suggestions). */
+export declare function closestMatch(input: string, candidates: string[]): string | undefined;
+//# sourceMappingURL=levenshtein.d.ts.map

package/dist/lib/levenshtein.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"levenshtein.d.ts","sourceRoot":"","sources":["../../src/lib/levenshtein.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBxD;AAED;mFACmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAUpF"}

package/dist/lib/levenshtein.js

@@ -0,0 +1,42 @@
+/**
+ * Tiny Levenshtein-distance "did you mean?" helper for CLI suggestions.
+ * Matches the implementation in `@refrakt-md/transform/node`'s `resolveSite`
+ * helper — kept local here so the CLI doesn't depend on transform internals.
+ */
+export function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[m][n];
+}
+/** Return the candidate closest to `input`, but only when distance ≤ 2.
+ *  Returns undefined when there's no good match (avoids confusing suggestions). */
+export function closestMatch(input, candidates) {
+    if (candidates.length === 0)
+        return undefined;
+    let best;
+    for (const candidate of candidates) {
+        const distance = levenshtein(input, candidate);
+        if (!best || distance < best.distance) {
+            best = { name: candidate, distance };
+        }
+    }
+    return best && best.distance <= 2 ? best.name : undefined;
+}
+//# sourceMappingURL=levenshtein.js.map

package/dist/lib/levenshtein.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levenshtein.js","sourceRoot":"","sources":["../../src/lib/levenshtein.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC/C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,EAAE,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CAAC,CAAC;QACzF,CAAC;IACF,CAAC;IACD,OAAO,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,CAAC;AACnB,CAAC;AAED;mFACmF;AACnF,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAAoB;IAC/D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,IAAoD,CAAC;IACzD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtC,CAAC;IACF,CAAC;IACD,OAAO,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC"}

package/dist/lib/plugins.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Plugin discovery for the refrakt CLI.
+ *
+ * `discoverPlugins()` enumerates installed plugin-bearing packages and loads
+ * each one's `cli-plugin` export. Three consumers rely on this helper:
+ *
+ * 1. CLI dispatch (`packages/cli/src/bin.ts`) — replaces the lazy
+ *    import-on-demand pattern with a single discovery call so namespace
+ *    typos can produce "did you mean?" suggestions.
+ * 2. `refrakt --help` and `refrakt plugins list` — listing what's installed.
+ * 3. The MCP server (`@refrakt-md/mcp`) — turning each command into a tool.
+ *
+ * Resolution order (per ADR-010 + SPEC-043):
+ * 1. If `refrakt.config.json`'s `plugins` field is set, that array is
+ *    authoritative — no dependency scanning happens.
+ * 2. Otherwise, the nearest `package.json` is scanned for `@refrakt-md/*`
+ *    entries in `dependencies` + `devDependencies` (excluding meta packages
+ *    that are not expected to ship a `cli-plugin`).
+ *
+ * The helper is side-effect-free: it does not execute commands, write to
+ * disk, or cache results internally. Callers wrap with their own caching.
+ */
+import type { CliPluginCommand } from '@refrakt-md/types';
+/** A plugin discovered in the project's installed packages. */
+export interface DiscoveredPlugin {
+    /** The namespace this plugin claims (e.g. `plan`). */
+    namespace: string;
+    /** The npm package name (e.g. `@refrakt-md/plan`). */
+    packageName: string;
+    /** The package's installed version, read from its `package.json`. */
+    packageVersion: string;
+    /** Commands contributed by the plugin. */
+    commands: CliPluginCommand[];
+    /** Whether the plugin came from the explicit `config.plugins` list or
+     *  was discovered via dependency scanning. */
+    source: 'config' | 'dependency-scan';
+    /** Optional namespace-level description from the plugin export. */
+    description?: string;
+}
+export interface DiscoverOptions {
+    /** Working directory to start the search from. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** When true, write warnings to stderr for malformed plugins, duplicate
+     *  namespaces, etc. Defaults to true. */
+    warn?: boolean;
+}
+/** Discover installed plugins. */
+export declare function discoverPlugins(opts?: DiscoverOptions): Promise<DiscoveredPlugin[]>;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/lib/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/lib/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKrE,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAChC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B;kDAC8C;IAC9C,MAAM,EAAE,QAAQ,GAAG,iBAAiB,CAAC;IACrC,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;6CACyC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AA2BD,kCAAkC;AAClC,wBAAsB,eAAe,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsC7F"}

package/dist/lib/plugins.js

@@ -0,0 +1,260 @@
+/**
+ * Plugin discovery for the refrakt CLI.
+ *
+ * `discoverPlugins()` enumerates installed plugin-bearing packages and loads
+ * each one's `cli-plugin` export. Three consumers rely on this helper:
+ *
+ * 1. CLI dispatch (`packages/cli/src/bin.ts`) — replaces the lazy
+ *    import-on-demand pattern with a single discovery call so namespace
+ *    typos can produce "did you mean?" suggestions.
+ * 2. `refrakt --help` and `refrakt plugins list` — listing what's installed.
+ * 3. The MCP server (`@refrakt-md/mcp`) — turning each command into a tool.
+ *
+ * Resolution order (per ADR-010 + SPEC-043):
+ * 1. If `refrakt.config.json`'s `plugins` field is set, that array is
+ *    authoritative — no dependency scanning happens.
+ * 2. Otherwise, the nearest `package.json` is scanned for `@refrakt-md/*`
+ *    entries in `dependencies` + `devDependencies` (excluding meta packages
+ *    that are not expected to ship a `cli-plugin`).
+ *
+ * The helper is side-effect-free: it does not execute commands, write to
+ * disk, or cache results internally. Callers wrap with their own caching.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+import { loadRefraktConfigWithRaw } from '@refrakt-md/transform/node';
+const require_ = createRequire(import.meta.url);
+/** Meta packages that ship in `@refrakt-md/*` but are not expected to
+ *  contribute CLI commands. These are skipped during dependency scanning. */
+const META_PACKAGES = new Set([
+    '@refrakt-md/cli',
+    '@refrakt-md/types',
+    '@refrakt-md/transform',
+    '@refrakt-md/runes',
+    '@refrakt-md/lumina',
+    '@refrakt-md/svelte',
+    '@refrakt-md/sveltekit',
+    '@refrakt-md/behaviors',
+    '@refrakt-md/content',
+    '@refrakt-md/ai',
+    '@refrakt-md/editor',
+    '@refrakt-md/highlight',
+    '@refrakt-md/html',
+    '@refrakt-md/astro',
+    '@refrakt-md/nuxt',
+    '@refrakt-md/next',
+    '@refrakt-md/eleventy',
+    '@refrakt-md/react',
+    '@refrakt-md/vue',
+    '@refrakt-md/language-server',
+]);
+/** Discover installed plugins. */
+export async function discoverPlugins(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const warn = opts.warn ?? true;
+    const candidates = resolveCandidates(cwd);
+    const seen = new Set();
+    const result = [];
+    for (const { packageName, source } of candidates) {
+        if (seen.has(packageName))
+            continue;
+        seen.add(packageName);
+        const loaded = await loadPlugin(packageName, cwd, warn);
+        if (!loaded)
+            continue;
+        const existing = result.find((p) => p.namespace === loaded.plugin.namespace);
+        if (existing) {
+            if (warn) {
+                console.warn(`Warning: namespace "${loaded.plugin.namespace}" is provided by both ` +
+                    `${existing.packageName} and ${packageName}. Using the first one (${existing.packageName}).`);
+            }
+            continue;
+        }
+        result.push({
+            namespace: loaded.plugin.namespace,
+            packageName,
+            packageVersion: loaded.version,
+            commands: loaded.plugin.commands,
+            source,
+            description: loaded.plugin.description,
+        });
+    }
+    result.sort((a, b) => a.namespace.localeCompare(b.namespace));
+    return result;
+}
+/** Return the list of `{ packageName, source }` candidates to attempt. */
+function resolveCandidates(cwd) {
+    const configCandidates = candidatesFromConfig(cwd);
+    if (configCandidates)
+        return configCandidates;
+    return candidatesFromPackageJson(cwd);
+}
+/** When `refrakt.config.json` declares `plugins`, return those names. */
+function candidatesFromConfig(cwd) {
+    const configPath = resolve(cwd, 'refrakt.config.json');
+    if (!existsSync(configPath))
+        return undefined;
+    let raw;
+    try {
+        raw = loadRefraktConfigWithRaw(configPath).raw;
+    }
+    catch {
+        return undefined;
+    }
+    const plugins = raw.plugins;
+    if (!Array.isArray(plugins))
+        return undefined;
+    const valid = plugins.filter((p) => typeof p === 'string' && p.length > 0);
+    if (valid.length === 0)
+        return undefined;
+    return valid.map((packageName) => ({ packageName, source: 'config' }));
+}
+/** Walk up from `cwd` to find candidate plugin packages, sourced from:
+ *  1. The nearest `package.json`'s `dependencies` + `devDependencies`.
+ *  2. The `node_modules/@refrakt-md/` directory (catches workspace-linked
+ *     packages that aren't in package.json's deps — typical for monorepos
+ *     and the refrakt repo itself).
+ *  Both sources are unioned (deduplicated downstream by the seen set) so the
+ *  scan finds plugins under both normal install and workspace setups. */
+function candidatesFromPackageJson(cwd) {
+    const names = new Set();
+    const pkgPath = findUp('package.json', cwd);
+    if (pkgPath) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            for (const name of Object.keys({ ...pkg.dependencies, ...pkg.devDependencies })) {
+                if (name.startsWith('@refrakt-md/') && !META_PACKAGES.has(name)) {
+                    names.add(name);
+                }
+            }
+        }
+        catch {
+            // ignore unreadable package.json
+        }
+    }
+    const nodeModulesDir = pkgPath
+        ? resolve(dirname(pkgPath), 'node_modules', '@refrakt-md')
+        : undefined;
+    if (nodeModulesDir && existsSync(nodeModulesDir)) {
+        try {
+            for (const entry of readdirSync(nodeModulesDir)) {
+                const full = resolve(nodeModulesDir, entry);
+                if (!safeIsDirectory(full))
+                    continue;
+                const name = `@refrakt-md/${entry}`;
+                if (META_PACKAGES.has(name))
+                    continue;
+                names.add(name);
+            }
+        }
+        catch {
+            // ignore unreadable node_modules
+        }
+    }
+    return [...names].map((packageName) => ({ packageName, source: 'dependency-scan' }));
+}
+function safeIsDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** Attempt to load a single plugin's `cli-plugin` export. Returns undefined
+ *  when the export is missing (silently skipped) or malformed (warned). */
+async function loadPlugin(packageName, cwd, warn) {
+    const pluginEntry = `${packageName}/cli-plugin`;
+    let mod;
+    try {
+        mod = await importFrom(pluginEntry, cwd);
+    }
+    catch {
+        // Missing or unbuilt cli-plugin export — silently skip. Not every
+        // `@refrakt-md/*` package ships CLI commands.
+        return undefined;
+    }
+    const candidate = mod.default ?? mod;
+    if (!isValidPlugin(candidate)) {
+        if (warn) {
+            console.warn(`Warning: ${packageName} exports an invalid cli-plugin (missing namespace or commands). Skipping.`);
+        }
+        return undefined;
+    }
+    const version = readPackageVersion(packageName, cwd) ?? '0.0.0';
+    return { plugin: candidate, version };
+}
+function isValidPlugin(candidate) {
+    if (!candidate || typeof candidate !== 'object')
+        return false;
+    const obj = candidate;
+    if (typeof obj.namespace !== 'string' || obj.namespace.length === 0)
+        return false;
+    if (!Array.isArray(obj.commands))
+        return false;
+    for (const cmd of obj.commands) {
+        if (!cmd || typeof cmd !== 'object')
+            return false;
+        const c = cmd;
+        if (typeof c.name !== 'string' || c.name.length === 0)
+            return false;
+        if (typeof c.description !== 'string')
+            return false;
+        if (typeof c.handler !== 'function')
+            return false;
+    }
+    return true;
+}
+function readPackageVersion(packageName, cwd) {
+    // Walk up from cwd looking at node_modules/<packageName>/package.json. We
+    // avoid require.resolve('<pkg>/package.json') because modern packages with
+    // an "exports" map block that subpath.
+    for (const nm of modulePaths(cwd)) {
+        const candidate = resolve(nm, packageName, 'package.json');
+        if (!existsSync(candidate))
+            continue;
+        try {
+            const pkg = JSON.parse(readFileSync(candidate, 'utf-8'));
+            if (typeof pkg.version === 'string')
+                return pkg.version;
+        }
+        catch {
+            // keep searching
+        }
+    }
+    return undefined;
+}
+/** Dynamic import that resolves relative to `cwd` rather than the CLI's own
+ *  install location. Important for monorepo workspaces and globally-installed
+ *  CLIs that need to load the project's local plugins. */
+async function importFrom(specifier, cwd) {
+    const localRequire = createRequire(resolve(cwd, '_'));
+    const resolved = localRequire.resolve(specifier);
+    return import(resolved);
+}
+function findUp(filename, start) {
+    let dir = resolve(start);
+    while (true) {
+        const candidate = resolve(dir, filename);
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+function modulePaths(cwd) {
+    const paths = [];
+    let dir = resolve(cwd);
+    while (true) {
+        paths.push(resolve(dir, 'node_modules'));
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return paths;
+}
+//# sourceMappingURL=plugins.js.map

package/dist/lib/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/lib/plugins.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/cli",
   "description": "CLI tools for refrakt.md",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -17,6 +17,16 @@
   "bin": {
     "refrakt": "./dist/bin.js"
   },
+  "exports": {
+    "./lib/plugins.js": {
+      "types": "./dist/lib/plugins.d.ts",
+      "default": "./dist/lib/plugins.js"
+    },
+    "./lib/levenshtein.js": {
+      "types": "./dist/lib/levenshtein.d.ts",
+      "default": "./dist/lib/levenshtein.js"
+    }
+  },
   "files": [
     "dist"
   ],
@@ -25,10 +35,10 @@
   },
   "dependencies": {
     "@markdoc/markdoc": "0.4.0",
-    "@refrakt-md/ai": "0.10.1",
-    "@refrakt-md/editor": "0.10.1",
-    "@refrakt-md/runes": "0.10.1",
-    "@refrakt-md/transform": "0.10.1",
+    "@refrakt-md/ai": "0.11.0",
+    "@refrakt-md/editor": "0.11.0",
+    "@refrakt-md/runes": "0.11.0",
+    "@refrakt-md/transform": "0.11.0",
     "postcss": "^8.4.0"
   }
 }