@cairn-tool/cairn 2.0.0

package/dist/completion/shells.js

@@ -0,0 +1,280 @@
+/**
+ * Shell script generators.
+ *
+ * Every script is *static*: it embeds the command tree rather than calling back
+ * into the CLI. A callback would spawn a Node process on every Tab press, and
+ * would need a hidden command — CLI surface that behaves like an API but is
+ * excluded from `describe` by construction. Nothing here is dynamic, so there
+ * is nothing to gain in exchange.
+ */
+/** Escapes for a single-quoted POSIX shell string. */
+function sq(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+/** Escapes for a double-quoted PowerShell string. */
+function ps(value) {
+    return `"${value.replace(/`/g, "``").replace(/"/g, '`"').replace(/\$/g, "`$")}"`;
+}
+/** Escapes a zsh `_describe`/`_arguments` description, which is `:`-delimited. */
+function zshDescription(value) {
+    return value.replace(/([:\\[\]])/g, "\\$1");
+}
+/** A single line, so a description can never break a generated line. */
+function oneLine(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function header(model, comment) {
+    return [
+        `${comment} ${model.binary} shell completion`,
+        `${comment} Generated by ${model.binary} ${model.version}. Regenerate after upgrading.`,
+        `${comment} Do not edit.`,
+    ].join("\n");
+}
+/** Flags a shell should offer for a command, longs and shorts, sorted. */
+function flags(command) {
+    return command.options
+        .flatMap((option) => (option.short ? [option.short, option.long] : [option.long]))
+        .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+}
+/** Words a shell should offer for a command's own position. */
+function words(command) {
+    const subcommands = command.subcommands.map((id) => id.split(" ").pop());
+    return [...subcommands, ...command.argument.choices, ...flags(command)];
+}
+/** Options that take a value, with what to offer after them. */
+function valueOptions(command) {
+    return command.options.filter((option) => option.takesValue);
+}
+function bash(model) {
+    // Derived rather than written out, because the two sites below are the only
+    // places in this file the binary name does not already reach through
+    // `model.binary` — the reason they still said CLAUDE_CLI long after the tool
+    // was named something else.
+    const pathsVariable = `_${model.binary.toUpperCase().replace(/[^A-Z0-9_]/g, "_")}_PATHS`;
+    const lines = [
+        header(model, "#"),
+        "",
+        `_${model.binary.replace(/-/g, "_")}_completions() {`,
+        "  local cur prev command_path index word",
+        '  cur="${COMP_WORDS[COMP_CWORD]}"',
+        '  prev="${COMP_WORDS[COMP_CWORD-1]}"',
+        "",
+        "  # Longest known command path formed by the leading non-flag words.",
+        '  command_path=""',
+        "  index=1",
+        '  while [ "$index" -lt "$COMP_CWORD" ]; do',
+        '    word="${COMP_WORDS[$index]}"',
+        '    case "$word" in -*) break ;; esac',
+        `    case " \${${pathsVariable}} " in`,
+        '      *" ${command_path:+$command_path }$word "*) command_path="${command_path:+$command_path }$word" ;;',
+        "      *) break ;;",
+        "    esac",
+        "    index=$((index + 1))",
+        "  done",
+        "",
+        "  # A value position: offer the option's own vocabulary, not the command's.",
+        '  case "$command_path|$prev" in',
+    ];
+    for (const command of model.commands)
+        for (const option of valueOptions(command)) {
+            const pattern = `${command.id}|${option.long}`;
+            const alias = option.short ? `${command.id}|${option.short}` : null;
+            const match = alias ? `${sq(pattern)} | ${sq(alias)}` : sq(pattern);
+            if (option.value === "choice")
+                lines.push(`    ${match}) COMPREPLY=($(compgen -W ${sq(option.choices.join(" "))} -- "$cur")); return ;;`);
+            // file, directory, and free all defer to `-o default`, which is bash's
+            // own path completion and beats anything embedded here.
+            else
+                lines.push(`    ${match}) COMPREPLY=(); return ;;`);
+        }
+    lines.push("  esac", "", '  case "$command_path" in', ...model.commands.map((command) => `    ${sq(command.id)}) COMPREPLY=($(compgen -W ${sq(words(command).join(" "))} -- "$cur")) ;;`), "  esac", "}", "", `${pathsVariable}=${sq(model.commands
+        .map((command) => command.id)
+        .filter(Boolean)
+        .join(" "))}`, 
+    // `-o default` gives path completion whenever COMPREPLY comes back empty,
+    // which is exactly the file/directory and free-text cases above.
+    `complete -o default -F _${model.binary.replace(/-/g, "_")}_completions ${model.binary}`, "");
+    return lines.join("\n");
+}
+function zsh(model) {
+    const fn = `_${model.binary.replace(/-/g, "_")}`;
+    const lines = [
+        `#compdef ${model.binary}`,
+        header(model, "#"),
+        "",
+        `${fn}() {`,
+        "  local command_path=''",
+        "  local index=2",
+        "  local word state",
+        "  while (( index < CURRENT )); do",
+        '    word="${words[index]}"',
+        '    [[ "$word" == -* ]] && break',
+        `    if (( \${+_${model.binary.replace(/-/g, "_")}_paths[\${command_path:+$command_path }$word]} )); then`,
+        '      command_path="${command_path:+$command_path }$word"',
+        "    else",
+        "      break",
+        "    fi",
+        "    (( index++ ))",
+        "  done",
+        "",
+        '  case "$command_path" in',
+    ];
+    for (const command of model.commands) {
+        const specs = [];
+        for (const option of command.options) {
+            const description = zshDescription(oneLine(option.description));
+            const names = option.short ? `{${option.short},${option.long}}` : option.long;
+            // A repeatable option keeps being offered; `*` is zsh's marker for that.
+            const prefix = option.repeatable ? "*" : "";
+            if (!option.takesValue) {
+                specs.push(sq(`${prefix}${names}[${description}]`));
+                continue;
+            }
+            const action = option.value === "choice"
+                ? `:value:(${option.choices.join(" ")})`
+                : option.value === "directory"
+                    ? ":dir:_files -/"
+                    : option.value === "file"
+                        ? ":file:_files"
+                        : ":value:";
+            specs.push(sq(`${prefix}${names}[${description}]${action}`));
+        }
+        if (command.subcommands.length) {
+            // `_describe` over a local array, rather than an inline `((a:b c:d))`
+            // value list: each entry is quoted on its own line, so a description
+            // containing a quote or a colon cannot break the enclosing spec.
+            lines.push(`    ${sq(command.id)})`, "      local -a _subcommands", "      _subcommands=(", ...command.subcommands.map((id) => {
+                const child = model.commands.find((item) => item.id === id);
+                return `        ${sq(`${id.split(" ").pop()}:${zshDescription(oneLine(child?.description ?? ""))}`)}`;
+            }), "      )", `      _arguments -C ${[...specs, "'1: :->cmd'", "'*::arg:->args'"].join(" ")}`, "      [[ $state == cmd ]] && _describe 'command' _subcommands", "      ;;");
+            continue;
+        }
+        if (command.argument.kind === "choice") {
+            specs.push(`'1:argument:(${command.argument.choices.join(" ")})'`, "'*:argument:'");
+        }
+        else if (command.argument.kind === "directory") {
+            specs.push("'*:path:_files -/'");
+        }
+        else if (command.argument.kind === "file") {
+            specs.push("'*:file:_files'");
+        }
+        else if (command.argument.kind === "free") {
+            specs.push("'*:argument:'");
+        }
+        lines.push(`    ${sq(command.id)})`, `      _arguments -C ${specs.join(" ")} ;;`);
+    }
+    lines.push("  esac", "}", "", `typeset -gA _${model.binary.replace(/-/g, "_")}_paths`, ...model.commands
+        .map((command) => command.id)
+        .filter(Boolean)
+        .map((id) => `_${model.binary.replace(/-/g, "_")}_paths[${sq(id)}]=1`), "", `${fn} "$@"`, "");
+    return lines.join("\n");
+}
+function fish(model) {
+    const binary = model.binary;
+    const guard = `__fish_${binary.replace(/-/g, "_")}_at`;
+    const lines = [
+        header(model, "#"),
+        "",
+        `function ${guard}`,
+        "  set -l parts (commandline -opc)",
+        "  set -e parts[1]",
+        "  set -l path ''",
+        "  for part in $parts",
+        "    if string match -qr '^-' -- $part",
+        "      break",
+        "    end",
+        "    set -l candidate (string trim " + '"$path $part")',
+        "    if contains -- $candidate $argv[2..-1]",
+        "      set path $candidate",
+        "    else",
+        "      break",
+        "    end",
+        "  end",
+        '  test "$path" = "$argv[1]"',
+        "end",
+        "",
+    ];
+    const allPaths = model.commands
+        .map((command) => command.id)
+        .filter(Boolean)
+        .map((id) => sq(id))
+        .join(" ");
+    const at = (id) => `${guard} ${sq(id)} ${allPaths}`;
+    for (const command of model.commands) {
+        const condition = `-n ${sq(at(command.id))}`;
+        for (const id of command.subcommands) {
+            const child = model.commands.find((item) => item.id === id);
+            lines.push(`complete -c ${binary} ${condition} -f -a ${sq(id.split(" ").pop())} -d ${sq(oneLine(child?.description ?? ""))}`);
+        }
+        if (command.argument.kind === "choice")
+            for (const choice of command.argument.choices)
+                lines.push(`complete -c ${binary} ${condition} -f -a ${sq(choice)}`);
+        for (const option of command.options) {
+            const parts = [`complete -c ${binary}`, condition];
+            if (option.short)
+                parts.push(`-s ${option.short.replace(/^-/, "")}`);
+            parts.push(`-l ${option.long.replace(/^--/, "")}`);
+            if (option.takesValue) {
+                parts.push("-r");
+                if (option.value === "choice")
+                    parts.push("-f", `-a ${sq(option.choices.join(" "))}`);
+                else if (option.value === "free")
+                    parts.push("-f");
+            }
+            else
+                parts.push("-f");
+            parts.push(`-d ${sq(oneLine(option.description))}`);
+            lines.push(parts.join(" "));
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function powershell(model) {
+    const lines = [
+        header(model, "#"),
+        "",
+        `Register-ArgumentCompleter -Native -CommandName ${model.binary} -ScriptBlock {`,
+        "  param($wordToComplete, $commandAst, $cursorPosition)",
+        "",
+        `  $known = @(${model.commands
+            .map((c) => c.id)
+            .filter(Boolean)
+            .map(ps)
+            .join(", ")})`,
+        "  $parts = $commandAst.CommandElements | Select-Object -Skip 1 | ForEach-Object { $_.ToString() }",
+        '  $path = ""',
+        "  foreach ($part in $parts) {",
+        "    if ($part.StartsWith('-')) { break }",
+        '    $candidate = if ($path) { "$path $part" } else { $part }',
+        "    if ($known -contains $candidate) { $path = $candidate } else { break }",
+        "  }",
+        "",
+        "  $completions = switch ($path) {",
+    ];
+    for (const command of model.commands) {
+        const entries = [];
+        for (const id of command.subcommands) {
+            const child = model.commands.find((item) => item.id === id);
+            const name = id.split(" ").pop();
+            entries.push(`[System.Management.Automation.CompletionResult]::new(${ps(name)}, ${ps(name)}, 'Command', ${ps(oneLine(child?.description ?? name))})`);
+        }
+        for (const choice of command.argument.choices)
+            entries.push(`[System.Management.Automation.CompletionResult]::new(${ps(choice)}, ${ps(choice)}, 'ParameterValue', ${ps(choice)})`);
+        for (const option of command.options)
+            entries.push(`[System.Management.Automation.CompletionResult]::new(${ps(option.long)}, ${ps(option.long)}, 'ParameterName', ${ps(oneLine(option.description) || option.long)})`);
+        lines.push(`    ${ps(command.id)} { @(${entries.join(", ")}) }`);
+    }
+    lines.push("    default { @() }", "  }", "", '  $completions | Where-Object { $_.CompletionText -like "$wordToComplete*" }', "}", "");
+    return lines.join("\n");
+}
+const GENERATORS = {
+    bash,
+    zsh,
+    fish,
+    powershell,
+};
+export function generateCompletion(model, shell) {
+    return GENERATORS[shell](model);
+}
+//# sourceMappingURL=shells.js.map

package/dist/completion/shells.js.map

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

package/dist/config-schema.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Validators shared by the configuration loader and the script registry parser.
+ *
+ * These live outside `src/config.ts` so `src/scripts/registry.ts` can reuse them
+ * without importing the loader — `config.ts` imports the registry parser to
+ * validate a `scripts:` block, and the reverse edge would be a cycle. Keeping
+ * `knownKeys` in one place also keeps its message text, which users see and
+ * script against, from drifting between the two callers.
+ */
+export declare function object(value: unknown, name: string): Record<string, unknown>;
+export declare function knownKeys(value: Record<string, unknown>, allowed: Set<string>, name: string): void;
+export declare function strings(value: unknown, name: string, fallback: string[]): string[];
+export declare function optionalString(value: unknown, name: string): string | undefined;
+/** True when `target` is `root` itself or lies beneath it. Both must be resolved. */
+export declare function isInside(root: string, target: string): boolean;

package/dist/config-schema.js

@@ -0,0 +1,44 @@
+import path from "node:path";
+/**
+ * Validators shared by the configuration loader and the script registry parser.
+ *
+ * These live outside `src/config.ts` so `src/scripts/registry.ts` can reuse them
+ * without importing the loader — `config.ts` imports the registry parser to
+ * validate a `scripts:` block, and the reverse edge would be a cycle. Keeping
+ * `knownKeys` in one place also keeps its message text, which users see and
+ * script against, from drifting between the two callers.
+ */
+export function object(value, name) {
+    if (value === undefined)
+        return {};
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${name} must be a mapping`);
+    }
+    return value;
+}
+export function knownKeys(value, allowed, name) {
+    const unknown = Object.keys(value).find((key) => !allowed.has(key));
+    if (unknown)
+        throw new Error(`Unknown ${name} key: ${unknown}`);
+}
+export function strings(value, name, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw new Error(`${name} must be a list of strings`);
+    }
+    return [...value];
+}
+export function optionalString(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string")
+        throw new Error(`${name} must be a string`);
+    return value;
+}
+/** True when `target` is `root` itself or lies beneath it. Both must be resolved. */
+export function isInside(root, target) {
+    const relative = path.relative(root, target);
+    return relative === "" || (!relative.startsWith(`..${path.sep}`) && relative !== "..");
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;GAQG;AAEH,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,IAAY;IACjD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,KAA8B,EAC9B,OAAoB,EACpB,IAAY;IAEZ,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,IAAI,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,SAAS,OAAO,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,IAAY,EAAE,QAAkB;IACtE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,4BAA4B,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAa,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,IAAY;IACzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAc;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC;AACzF,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,102 @@
+import type { OutputFormat } from "./types.js";
+export type PathStyle = "absolute" | "relative";
+export interface CheckConfig {
+    mermaid: boolean;
+    katex: boolean;
+    references: boolean;
+    markdownlint: boolean;
+    frontmatter: boolean;
+    graph: boolean;
+    toc: boolean;
+    external: boolean;
+    snippets: boolean;
+}
+export interface FrontmatterRulesConfig {
+    required: string[];
+    prohibited: string[];
+    types: Record<string, "string" | "number" | "integer" | "boolean" | "array" | "object" | "null">;
+    allowedValues: Record<string, unknown[]>;
+    formats: Record<string, string>;
+    patterns: Record<string, string>;
+    unique: string[];
+}
+export interface ResolvedConfig {
+    configPath?: string;
+    root: string;
+    files: {
+        include: string[];
+        exclude: string[];
+        entryPoints: string[];
+    };
+    assets: {
+        extensions: string[];
+    };
+    markdown: {
+        renderer: "github";
+    };
+    output: {
+        format: OutputFormat;
+        paths: PathStyle;
+    };
+    checks: CheckConfig;
+    frontmatter: {
+        schema?: string;
+        rules: FrontmatterRulesConfig;
+    };
+    toc: {
+        files: string[];
+    };
+    markdownlint: {
+        config?: string;
+    };
+    urls: {
+        ignore: string[];
+        ignoreDomains: string[];
+        allowedStatuses: number[];
+        cache: boolean;
+        cacheTtl: number;
+        headFallbackStatuses: number[];
+        reportRedirects: boolean;
+    };
+    commands: Record<string, Record<string, unknown>>;
+}
+export interface ConfigSelection {
+    explicitPath?: string;
+    disabled: boolean;
+}
+export declare function selectConfig(argv: readonly string[], cwd?: string): ConfigSelection;
+/**
+ * The directory a `serve` invocation asks to expose, resolved against `cwd`.
+ *
+ * Scanned out of argv before commander parses it, for the same reason
+ * `selectConfig` is: the configuration decides which checks and exclusions the
+ * server answers with, and it has to be discovered from the served directory
+ * rather than from wherever the host happened to spawn the process. Without
+ * this the server would silently answer from `process.cwd()` and disagree with
+ * the equivalent `md` command run in the same workspace.
+ *
+ * This is a confinement boundary, not a workspace root — `config.root` stays
+ * whatever the discovered configuration says.
+ */
+export declare function selectRoot(argv: readonly string[], cwd?: string): string;
+/** The configuration filename this tool writes and documents. */
+export declare const CONFIG_FILENAME = ".cairn.yml";
+/** The pre-rename filename, still read so existing workspaces keep working. */
+export declare const LEGACY_CONFIG_FILENAME = ".claude-cli.yml";
+/**
+ * Discovery order within one directory, shared with the `scripts` chain walk.
+ *
+ * First match wins, so a directory holding both files contributes exactly one
+ * registry. Walking the whole array per directory before ascending is what
+ * keeps a nested `.cairn.yml` from being shadowed by a legacy file higher up.
+ */
+export declare const CONFIG_FILENAMES: readonly [".cairn.yml", ".claude-cli.yml"];
+/** The configuration file in `directory`, preferring the current filename. */
+export declare function configIn(directory: string): string | undefined;
+export declare function findConfig(start?: string): string | undefined;
+export declare function loadConfig(selection?: ConfigSelection, cwd?: string): ResolvedConfig;
+export declare function resolveCommandOptions<T extends Record<string, unknown>>(config: ResolvedConfig, command: string, builtins: T, cli: Record<string, unknown>): T & {
+    format: OutputFormat;
+    paths: PathStyle;
+};
+export declare function defaultLintConcurrency(): number;