renma 0.1.0

package/dist/commands/scan.js

@@ -0,0 +1,12 @@
+import { formatJson, formatText } from "../report.js";
+import { scan } from "../scanner.js";
+import { severityMeets } from "../rules.js";
+/** Execute the scan command, write its report to stdout, and return an exit code. */
+export async function runScanCommand(target, overrides) {
+    const result = await scan(target, overrides);
+    process.stdout.write(result.format === "json" ? formatJson(result) : formatText(result));
+    return result.findings.some((finding) => severityMeets(finding.severity, result.exitThreshold))
+        ? 1
+        : 0;
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,SAA0B;IAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CACnE,CAAC;IAEF,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CACtC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,aAAa,CAAC,CACtD;QACC,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/commands/suggest-semantic-split.d.ts

@@ -0,0 +1,8 @@
+export type SuggestSemanticSplitFormat = "prompt" | "json";
+export interface SuggestSemanticSplitOptions {
+    format?: SuggestSemanticSplitFormat;
+    maxContextBytes?: number;
+    maxSourceBytes?: number;
+}
+export declare function runSuggestSemanticSplitCommand(target: string, options?: SuggestSemanticSplitOptions): Promise<number>;
+//# sourceMappingURL=suggest-semantic-split.d.ts.map

package/dist/commands/suggest-semantic-split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-semantic-split.d.ts","sourceRoot":"","sources":["../../src/commands/suggest-semantic-split.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAsCD,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/commands/suggest-semantic-split.js

@@ -0,0 +1,215 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { buildInspectOutline } from "./inspect.js";
+const DEFAULT_MAX_CONTEXT_BYTES = 32 * 1024;
+const CONTEXT_DIRS = new Set(["references", "profiles", "examples", "r"]);
+export async function runSuggestSemanticSplitCommand(target, options = {}) {
+    const semanticSplitReviewBundle = await buildSemanticSplitReviewBundle(target, options);
+    const format = options.format ?? "prompt";
+    process.stdout.write(format === "json"
+        ? `${JSON.stringify(semanticSplitReviewBundle, null, 2)}\n`
+        : renderCodexPrompt(semanticSplitReviewBundle));
+    return 0;
+}
+async function buildSemanticSplitReviewBundle(target, options) {
+    const sourcePath = path.resolve(target);
+    const sourceOutline = await buildInspectOutline(sourcePath);
+    const skillDir = await findSkillDir(path.dirname(sourcePath));
+    const skillPath = skillDir ? path.join(skillDir, "SKILL.md") : null;
+    const skill = skillPath
+        ? await readLimitedText(skillPath, options.maxContextBytes ?? DEFAULT_MAX_CONTEXT_BYTES)
+        : null;
+    const skillContext = skill && skillPath
+        ? {
+            bytesRead: skill.bytesRead,
+            path: skillPath,
+            text: skill.text,
+            truncated: skill.truncated,
+        }
+        : null;
+    const siblingContext = skillDir
+        ? await collectSiblingContext(skillDir, sourcePath, options.maxContextBytes ?? DEFAULT_MAX_CONTEXT_BYTES)
+        : [];
+    return {
+        context: {
+            siblingFiles: siblingContext,
+            skill: skillContext,
+            skillDir,
+        },
+        helperCommands: {
+            outline: `renma inspect ${shellQuote(sourcePath)} --format json`,
+            sliceExample: `renma inspect ${shellQuote(sourcePath)} --lines L10-L42 --format text`,
+        },
+        mode: "codex-semantic-split-prompt",
+        mutatesFiles: false,
+        source: {
+            outline: sourceOutline,
+            path: sourcePath,
+        },
+    };
+}
+function renderCodexPrompt(semanticSplitReviewBundle) {
+    const { source } = semanticSplitReviewBundle;
+    const { context } = semanticSplitReviewBundle;
+    const siblingSummary = context.siblingFiles.length > 0
+        ? context.siblingFiles
+            .map((file) => `### ${file.path}\nBytes read: ${file.bytesRead}${file.truncated ? " (truncated)" : ""}\n${fence(file.preview)}`)
+            .join("\n\n")
+        : "(none found)";
+    return `${[
+        "# Codex Task: Suggest Semantic Reference Split",
+        "",
+        "You are improving an AI-agent skill repository.",
+        "",
+        "Read the compact source outline and nearby context. Suggest a semantic split plan for the source file based on meaning, not byte size and not predefined categories.",
+        "",
+        "Infer the best split direction as a human maintainer would. For example, choose platform-specific files only if the content itself separates macOS/Linux, Windows, etc. If the better boundary is setup phase, troubleshooting area, tool, workflow mode, audience, prerequisite, verification, or something else, choose that instead.",
+        "",
+        "Use deterministic inspection helpers when the outline is not enough. Prefer these helpers over ad hoc cat/sed calls so token usage stays low:",
+        `- Outline: \`${semanticSplitReviewBundle.helperCommands.outline}\``,
+        `- Exact slice: \`${semanticSplitReviewBundle.helperCommands.sliceExample}\``,
+        "",
+        "Do not rewrite files. Return only a proposal.",
+        "",
+        "Return strict JSON with this shape:",
+        "",
+        fence(`{
+  "source": "${source.path}",
+  "shouldSplit": true,
+  "splitDirection": "one sentence describing the semantic boundary",
+  "suggestedFiles": [
+      {
+        "path": "suggested repo-relative or source-neighbor path",
+        "category": "human-readable category",
+        "why": "why this category belongs together",
+        "sourceRanges": ["L10-L42", "L80-L120"],
+        "usageHint": "when SKILL.md should reference this file"
+      }
+    ],
+    "sharedContent": [
+      {
+        "sourceRanges": ["L1-L9"],
+        "recommendation": "keep in a common file, duplicate intentionally, or reference from SKILL.md"
+      }
+    ],
+    "skillGuidanceUpdate": "brief SKILL.md usage and reference guidance",
+    "risks": ["coverage or validation concerns"],
+    "confidence": 0.0
+  }`),
+        "",
+        "Rules:",
+        "- Use source line ranges from the outline and exact line slices.",
+        "- Do not split inside fenced code blocks.",
+        "- Do not drop warnings, prerequisites, rollback, or verification steps.",
+        "- Name files by meaning, not by part number.",
+        "- If the source should remain one file, set shouldSplit to false and suggestedFiles to [].",
+        "- Return JSON only. Do not include Markdown outside the JSON.",
+        "",
+        "## Source Outline",
+        "",
+        fence(JSON.stringify(source.outline, null, 2)),
+        "",
+        "## Nearby SKILL.md",
+        "",
+        context.skill
+            ? `Path: ${context.skill.path}\nBytes read: ${context.skill.bytesRead}${context.skill.truncated ? " (truncated)" : ""}\n\n${fence(context.skill.text)}`
+            : "(not found)",
+        "",
+        "## Sibling Context Files",
+        "",
+        siblingSummary,
+        "",
+    ].join("\n")}\n`;
+}
+async function findSkillDir(startDir) {
+    let current = startDir;
+    while (true) {
+        try {
+            const skill = path.join(current, "SKILL.md");
+            if ((await stat(skill)).isFile()) {
+                return current;
+            }
+        }
+        catch {
+            // Keep walking upward.
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+async function collectSiblingContext(skillDir, sourcePath, maxBytes) {
+    const files = await walk(skillDir);
+    const contextFiles = [];
+    for (const filePath of files.sort()) {
+        if (filePath === sourcePath || path.basename(filePath) === "SKILL.md") {
+            continue;
+        }
+        const relative = path.relative(skillDir, filePath);
+        const [topLevel] = relative.split(path.sep);
+        if (!topLevel || !CONTEXT_DIRS.has(topLevel) || !filePath.endsWith(".md")) {
+            continue;
+        }
+        const text = await readLimitedText(filePath, Math.min(maxBytes, 4 * 1024));
+        contextFiles.push({
+            bytesRead: text.bytesRead,
+            path: filePath,
+            preview: previewMarkdown(text.text),
+            truncated: text.truncated,
+        });
+        if (contextFiles.length >= 80) {
+            break;
+        }
+    }
+    return contextFiles;
+}
+async function walk(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (entry.name === "node_modules" || entry.name === ".git") {
+            continue;
+        }
+        const entryPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await walk(entryPath)));
+        }
+        else if (entry.isFile()) {
+            files.push(entryPath);
+        }
+    }
+    return files;
+}
+async function readLimitedText(filePath, maxBytes) {
+    const buffer = await readFile(filePath);
+    const slice = buffer.subarray(0, maxBytes);
+    return {
+        bytesRead: slice.byteLength,
+        text: slice.toString("utf8"),
+        truncated: buffer.byteLength > maxBytes,
+    };
+}
+function previewMarkdown(text) {
+    const lines = text.split(/\n/);
+    const preview = [];
+    for (const line of lines) {
+        if (/^#{1,6}\s+/.test(line) ||
+            /^description:\s*/i.test(line) ||
+            /^name:\s*/i.test(line)) {
+            preview.push(line);
+        }
+        if (preview.length >= 8) {
+            break;
+        }
+    }
+    return preview.length > 0 ? preview.join("\n") : lines.slice(0, 8).join("\n");
+}
+function fence(text) {
+    return `\`\`\`text\n${text}\n\`\`\``;
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+//# sourceMappingURL=suggest-semantic-split.js.map

package/dist/commands/suggest-semantic-split.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+import type { LoadedConfig, ScanConfig, Severity } from "./types.js";
+/** Default scan configuration used when no config file or CLI overrides apply. */
+export declare const DEFAULT_CONFIG: ScanConfig;
+/** Error raised for invalid Renma configuration or CLI configuration input. */
+export declare class ConfigError extends Error {
+}
+/** CLI-level overrides merged on top of discovered configuration. */
+export interface ConfigOverrides {
+    configPath?: string;
+    failOn?: Severity;
+    format?: "text" | "json";
+}
+/** Load, validate, and merge scan configuration for a repository root. */
+export declare function loadConfig(root: string, overrides: ConfigOverrides): Promise<LoadedConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKrE,kFAAkF;AAClF,eAAO,MAAM,cAAc,EAAE,UAuB5B,CAAC;AAEF,+EAA+E;AAC/E,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAEzC,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,0EAA0E;AAC1E,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,YAAY,CAAC,CAiBvB"}

package/dist/config.js

@@ -0,0 +1,184 @@
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+const SEVERITIES = ["low", "medium", "high", "critical"];
+const FORMATS = ["text", "json"];
+/** Default scan configuration used when no config file or CLI overrides apply. */
+export const DEFAULT_CONFIG = {
+    failOn: "high",
+    format: "text",
+    globs: [
+        "skills/**/SKILL.md",
+        ".agents/**/*.md",
+        "AGENTS.md",
+        "README.md",
+        "context/**/*.md",
+        "contexts/**/*.md",
+        "skills/**/profiles/**/*.md",
+        "skills/**/references/**/*.md",
+        "skills/**/examples/**/*.md",
+        "skills/**/scripts/**/*",
+        "tools/**/*",
+    ],
+    exclude: ["node_modules", "dist", ".git"],
+    maxFileSizeBytes: 512 * 1024,
+    maxDepth: 16,
+    concurrency: 16,
+    layout: {
+        workflowAliases: {},
+    },
+};
+/** Error raised for invalid Renma configuration or CLI configuration input. */
+export class ConfigError extends Error {
+}
+/** Load, validate, and merge scan configuration for a repository root. */
+export async function loadConfig(root, overrides) {
+    const discoveredPath = overrides.configPath ?? (await findDefaultConfig(root));
+    const fileConfig = discoveredPath ? await readConfigFile(discoveredPath) : {};
+    const config = normalizeConfig(fileConfig, discoveredPath);
+    return {
+        config: {
+            ...DEFAULT_CONFIG,
+            ...config,
+            failOn: overrides.failOn ?? config.failOn ?? DEFAULT_CONFIG.failOn,
+            format: overrides.format ?? config.format ?? DEFAULT_CONFIG.format,
+        },
+        ...(discoveredPath
+            ? { configPath: toPosix(path.relative(root, discoveredPath)) }
+            : {}),
+    };
+}
+async function findDefaultConfig(root) {
+    for (const name of ["renma.config.json", ".renma.json"]) {
+        const candidate = path.join(root, name);
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            // Try the next conventional name.
+        }
+    }
+    return undefined;
+}
+async function readConfigFile(configPath) {
+    let raw;
+    try {
+        raw = await readFile(configPath, "utf8");
+    }
+    catch (error) {
+        throw new ConfigError(`Could not read config file ${configPath}: ${errorMessage(error)}`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new ConfigError(`Config file ${configPath} is not valid JSON: ${errorMessage(error)}`);
+    }
+}
+function normalizeConfig(value, configPath) {
+    if (value === undefined || value === null)
+        return {};
+    if (!isRecord(value)) {
+        throw new ConfigError(`Config${label(configPath)} must be a JSON object.`);
+    }
+    const allowed = new Set([
+        "fail_on",
+        "format",
+        "globs",
+        "exclude",
+        "max_file_size_bytes",
+        "max_depth",
+        "concurrency",
+        "layout",
+    ]);
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key)) {
+            throw new ConfigError(`Unknown config field "${key}"${label(configPath)}.`);
+        }
+    }
+    const config = {};
+    if (value.fail_on !== undefined)
+        config.failOn = enumValue("fail_on", value.fail_on, SEVERITIES);
+    if (value.format !== undefined)
+        config.format = enumValue("format", value.format, FORMATS);
+    if (value.globs !== undefined)
+        config.globs = stringArray("globs", value.globs);
+    if (value.exclude !== undefined)
+        config.exclude = stringArray("exclude", value.exclude);
+    if (value.max_file_size_bytes !== undefined) {
+        config.maxFileSizeBytes = positiveInteger("max_file_size_bytes", value.max_file_size_bytes);
+    }
+    if (value.max_depth !== undefined)
+        config.maxDepth = positiveInteger("max_depth", value.max_depth);
+    if (value.concurrency !== undefined)
+        config.concurrency = positiveInteger("concurrency", value.concurrency);
+    if (value.layout !== undefined)
+        config.layout = layoutPolicy(value.layout);
+    return config;
+}
+function enumValue(field, value, allowed) {
+    if (typeof value === "string" && allowed.includes(value))
+        return value;
+    throw new ConfigError(`${field} must be one of: ${allowed.join(", ")}.`);
+}
+function stringArray(field, value) {
+    if (Array.isArray(value) && value.every((item) => typeof item === "string"))
+        return value;
+    throw new ConfigError(`${field} must be an array of strings.`);
+}
+function positiveInteger(field, value) {
+    if (Number.isInteger(value) && typeof value === "number" && value > 0)
+        return value;
+    throw new ConfigError(`${field} must be a positive integer.`);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function label(configPath) {
+    return configPath ? ` in ${configPath}` : "";
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function toPosix(value) {
+    return value.split(path.sep).join(path.posix.sep);
+}
+function layoutPolicy(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new ConfigError("layout must be an object.");
+    const layout = value;
+    const allowed = new Set(["tool_namespace", "workflow_aliases"]);
+    for (const key of Object.keys(layout)) {
+        if (!allowed.has(key))
+            throw new ConfigError(`Unknown layout config key "${key}". Allowed keys: ${[...allowed].join(", ")}.`);
+    }
+    const toolNamespace = layout.tool_namespace === undefined
+        ? undefined
+        : stringValue("layout.tool_namespace", layout.tool_namespace);
+    const workflowAliases = layout.workflow_aliases === undefined
+        ? DEFAULT_CONFIG.layout.workflowAliases
+        : stringRecord("layout.workflow_aliases", layout.workflow_aliases);
+    return {
+        ...(toolNamespace === undefined ? {} : { toolNamespace }),
+        workflowAliases: {
+            ...DEFAULT_CONFIG.layout.workflowAliases,
+            ...workflowAliases,
+        },
+    };
+}
+function stringRecord(name, value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new ConfigError(`${name} must be an object of string values.`);
+    const record = value;
+    for (const [key, item] of Object.entries(record)) {
+        if (typeof item !== "string")
+            throw new ConfigError(`${name}.${key} must be a string.`);
+    }
+    return record;
+}
+function stringValue(name, value) {
+    if (typeof value !== "string" || value.trim() === "")
+        throw new ConfigError(`${name} must be a non-empty string.`);
+    return value;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/discovery.d.ts

@@ -0,0 +1,7 @@
+import type { Artifact, Diagnostic, ScanConfig } from "./types.js";
+/** Discover and read scan artifacts according to the provided scan configuration. */
+export declare function discoverArtifacts(root: string, config: ScanConfig): Promise<{
+    artifacts: Artifact[];
+    diagnostics: Diagnostic[];
+}>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EAER,UAAU,EACV,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CA2E/D"}

package/dist/discovery.js

@@ -0,0 +1,122 @@
+import { glob, lstat, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+/** Discover and read scan artifacts according to the provided scan configuration. */
+export async function discoverArtifacts(root, config) {
+    const diagnostics = [];
+    const paths = new Set();
+    for (const pattern of config.globs) {
+        try {
+            for await (const match of glob(pattern, {
+                cwd: root,
+                withFileTypes: false,
+            })) {
+                if (typeof match === "string")
+                    paths.add(toPosix(match));
+            }
+        }
+        catch (error) {
+            diagnostics.push({
+                severity: "error",
+                message: `Could not evaluate glob "${pattern}": ${errorMessage(error)}`,
+            });
+        }
+    }
+    const candidates = [...paths]
+        .filter((relativePath) => !isExcluded(relativePath, config.exclude))
+        .filter((relativePath) => depth(relativePath) <= config.maxDepth)
+        .sort((a, b) => a.localeCompare(b));
+    const artifacts = await mapLimit(candidates, config.concurrency, async (relativePath) => {
+        const absolutePath = path.join(root, relativePath);
+        try {
+            const linkInfo = await lstat(absolutePath);
+            if (linkInfo.isSymbolicLink()) {
+                diagnostics.push({
+                    severity: "warning",
+                    path: relativePath,
+                    message: "Skipping symbolic link.",
+                });
+                return undefined;
+            }
+            const info = await stat(absolutePath);
+            if (!info.isFile())
+                return undefined;
+            if (info.size > config.maxFileSizeBytes) {
+                diagnostics.push({
+                    severity: "warning",
+                    path: relativePath,
+                    message: `Skipping file larger than max_file_size_bytes (${config.maxFileSizeBytes}).`,
+                });
+                return undefined;
+            }
+            const content = await readFile(absolutePath, "utf8");
+            return {
+                path: relativePath,
+                absolutePath,
+                kind: classify(relativePath),
+                sizeBytes: info.size,
+                content,
+            };
+        }
+        catch (error) {
+            diagnostics.push({
+                severity: "error",
+                path: relativePath,
+                message: `Could not read file: ${errorMessage(error)}`,
+            });
+            return undefined;
+        }
+    });
+    return {
+        artifacts: artifacts.filter((artifact) => artifact !== undefined),
+        diagnostics,
+    };
+}
+function classify(relativePath) {
+    if (relativePath.endsWith("/SKILL.md"))
+        return "skill";
+    if (relativePath === "AGENTS.md" || relativePath.startsWith(".agents/"))
+        return "agent";
+    if (relativePath.startsWith("context/") ||
+        relativePath.startsWith("contexts/"))
+        return "context";
+    if (relativePath.includes("/profiles/"))
+        return "profile";
+    if (relativePath.includes("/references/"))
+        return "reference";
+    if (relativePath.includes("/examples/"))
+        return "example";
+    if (relativePath.endsWith("renma.config.json") ||
+        relativePath.endsWith(".renma.json")) {
+        return "config";
+    }
+    return "unknown";
+}
+async function mapLimit(items, limit, mapper) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        while (cursor < items.length) {
+            const index = cursor;
+            cursor += 1;
+            results[index] = await mapper(items[index]);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+function isExcluded(relativePath, excludes) {
+    const segments = relativePath.split("/");
+    return excludes.some((exclude) => segments.includes(exclude) ||
+        relativePath === exclude ||
+        relativePath.startsWith(`${exclude}/`));
+}
+function depth(relativePath) {
+    return relativePath.split("/").filter(Boolean).length;
+}
+function toPosix(value) {
+    return value.split(path.sep).join(path.posix.sep);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "./cli.js";
+process.exitCode = await main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,4 @@
+import type { Artifact, ParsedDocument } from "./types.js";
+/** Parse a markdown artifact into headings, links, code fences, and frontmatter metadata. */
+export declare function parseDocument(artifact: Artifact): ParsedDocument;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAIR,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAiEhE"}