@cairn-tool/cairn 2.0.0

package/dist/option-utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Accumulator for repeatable options. `src/contract/describe.ts` detects
+ * repeatability by comparing an option's coercion against this function by
+ * identity, so it must not be wrapped at registration sites.
+ */
+export declare function collect(val: string, acc?: string[]): string[];
+/**
+ * Parses a non-negative integer option, with an optional inclusive maximum.
+ *
+ * Shared so that `--depth` means the same thing, and fails with the same
+ * message, wherever it appears.
+ */
+export declare function boundedInteger(value: string, name: string, max?: number): number;

package/dist/option-utils.js

@@ -0,0 +1,25 @@
+/**
+ * Accumulator for repeatable options. `src/contract/describe.ts` detects
+ * repeatability by comparing an option's coercion against this function by
+ * identity, so it must not be wrapped at registration sites.
+ */
+export function collect(val, acc = []) {
+    acc.push(val);
+    return acc;
+}
+/**
+ * Parses a non-negative integer option, with an optional inclusive maximum.
+ *
+ * Shared so that `--depth` means the same thing, and fails with the same
+ * message, wherever it appears.
+ */
+export function boundedInteger(value, name, max) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0 || (max !== undefined && parsed > max)) {
+        throw new Error(max === undefined
+            ? `--${name} must be a non-negative integer`
+            : `--${name} must be an integer from 0 to ${max}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=option-utils.js.map

package/dist/option-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-utils.js","sourceRoot":"","sources":["../src/option-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,MAAgB,EAAE;IACrD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAY,EAAE,GAAY;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,SAAS;YACf,CAAC,CAAC,KAAK,IAAI,iCAAiC;YAC5C,CAAC,CAAC,KAAK,IAAI,iCAAiC,GAAG,EAAE,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/outline.d.ts

@@ -0,0 +1,16 @@
+import type { MdHeading } from "./markdown-ast.js";
+export interface OutlineNode {
+    text: string;
+    slug: string;
+    depth: number;
+    line: number;
+    children: OutlineNode[];
+}
+/**
+ * Nests a flat heading list by depth.
+ *
+ * Depth gaps are not normalized: an h3 following an h1 becomes a child of that
+ * h1 rather than gaining a synthetic h2. That is `md outline`'s published shape,
+ * and `md lint` is what reports the skipped level.
+ */
+export declare function buildOutline(headings: readonly MdHeading[]): OutlineNode[];

package/dist/outline.js

@@ -0,0 +1,32 @@
+/**
+ * Nests a flat heading list by depth.
+ *
+ * Depth gaps are not normalized: an h3 following an h1 becomes a child of that
+ * h1 rather than gaining a synthetic h2. That is `md outline`'s published shape,
+ * and `md lint` is what reports the skipped level.
+ */
+export function buildOutline(headings) {
+    const root = [];
+    const stack = [];
+    for (const heading of headings) {
+        const node = {
+            text: heading.text,
+            slug: heading.slug,
+            depth: heading.depth,
+            line: heading.line,
+            children: [],
+        };
+        while (stack.length > 0 && stack[stack.length - 1].depth >= heading.depth) {
+            stack.pop();
+        }
+        if (stack.length === 0) {
+            root.push(node);
+        }
+        else {
+            stack[stack.length - 1].children.push(node);
+        }
+        stack.push(node);
+    }
+    return root;
+}
+//# sourceMappingURL=outline.js.map

package/dist/outline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.js","sourceRoot":"","sources":["../src/outline.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAA8B;IACzD,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAgB;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAC1E,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/query/entities.d.ts

@@ -0,0 +1,60 @@
+import { type MdCodeBlock, type MdHeading, type MdLink, type MdTask } from "../markdown-ast.js";
+import { extractText } from "../markdown-ast.js";
+import type { MarkdownDocument } from "../workspace.js";
+export declare const ENTITY_KINDS: readonly ["documents", "headings", "links", "tasks", "code-blocks", "frontmatter"];
+export type EntityKind = (typeof ENTITY_KINDS)[number];
+export type Scalar = string | number | boolean | null;
+export type FieldValue = Scalar | Scalar[] | undefined;
+export type FieldType = "string" | "number" | "boolean";
+/** One row of the `frontmatter` entity: a top-level key of a valid mapping. */
+export interface FrontmatterEntry {
+    key: string;
+    value: unknown;
+}
+export type EntityNode = null | MdHeading | MdLink | MdTask | MdCodeBlock | FrontmatterEntry;
+/** Per-document values computed once and shared by predicates and projection. */
+export interface DocumentDerived {
+    /** Headings outside the frontmatter block. */
+    headings: MdHeading[];
+    tasks: MdTask[];
+    codeBlocks: MdCodeBlock[];
+    frontmatterData: Record<string, unknown>;
+    words: number;
+}
+export interface RowSource {
+    /** Absolute path. */
+    file: string;
+    document: MarkdownDocument;
+    node: EntityNode;
+    derived: DocumentDerived;
+}
+export interface FieldSpec {
+    /** Exactly the token typed in --where, --select, or --group-by. */
+    name: string;
+    type: FieldType;
+    /** Emitted when no --select is given. */
+    default: boolean;
+    /** Rendered through the command layer's path display. */
+    path?: boolean;
+    read: (source: RowSource) => FieldValue;
+}
+export interface EntitySpec {
+    kind: EntityKind;
+    /** Rows for one document, in source order. */
+    rows: (document: MarkdownDocument, derived: DocumentDerived) => EntityNode[];
+    fields: readonly FieldSpec[];
+    /** Named predicates with an argument that this entity supports. */
+    functions: readonly string[];
+}
+export declare function deriveDocument(document: MarkdownDocument): DocumentDerived;
+/**
+ * The type label reported for a frontmatter value.
+ *
+ * Shared with `md query frontmatter-keys`, so the shortcut kind and the
+ * composable entity can never disagree about what a value is.
+ */
+export declare function frontmatterValueType(value: unknown): string;
+export declare const SPECS: Record<EntityKind, EntitySpec>;
+/** Field names an entity offers, for an error message. */
+export declare function fieldNames(kind: EntityKind): string[];
+export { extractText };

package/dist/query/entities.js

@@ -0,0 +1,219 @@
+import { extractCodeBlocks, extractTasks, } from "../markdown-ast.js";
+import { extractText } from "../markdown-ast.js";
+import { visit } from "unist-util-visit";
+import { frontmatterEndLine } from "../sections.js";
+export const ENTITY_KINDS = [
+    "documents",
+    "headings",
+    "links",
+    "tasks",
+    "code-blocks",
+    "frontmatter",
+];
+function countWords(document) {
+    let words = 0;
+    // Only text nodes, so fenced code never inflates a prose count.
+    visit(document.tree, "text", (node) => {
+        words += node.value.split(/\s+/).filter(Boolean).length;
+    });
+    return words;
+}
+export function deriveDocument(document) {
+    const end = frontmatterEndLine(document.content);
+    return {
+        // The underlying parser has no frontmatter extension, so a short block
+        // becomes a phantom setext heading. Structural queries drop it rather than
+        // report a `title: X` heading that is not in the document.
+        headings: document.headings.filter((item) => item.line > end),
+        tasks: extractTasks(document.tree),
+        codeBlocks: extractCodeBlocks(document.tree),
+        frontmatterData: document.frontmatter.status === "valid" ? document.frontmatter.data : {},
+        words: countWords(document),
+    };
+}
+const fileField = {
+    name: "file",
+    type: "string",
+    default: true,
+    path: true,
+    read: (source) => source.file,
+};
+function documentTitle(source) {
+    const title = source.derived.frontmatterData.title;
+    if (typeof title === "string")
+        return title;
+    return source.derived.headings.find((heading) => heading.depth === 1)?.text ?? null;
+}
+const heading = (source) => source.node;
+const link = (source) => source.node;
+const task = (source) => source.node;
+const block = (source) => source.node;
+const entry = (source) => source.node;
+/**
+ * The type label reported for a frontmatter value.
+ *
+ * Shared with `md query frontmatter-keys`, so the shortcut kind and the
+ * composable entity can never disagree about what a value is.
+ */
+export function frontmatterValueType(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+export const SPECS = {
+    documents: {
+        kind: "documents",
+        rows: () => [null],
+        functions: ["links-to"],
+        fields: [
+            fileField,
+            { name: "title", type: "string", default: true, read: documentTitle },
+            {
+                name: "h1",
+                type: "boolean",
+                default: false,
+                read: (source) => source.derived.headings.some((item) => item.depth === 1),
+            },
+            {
+                name: "headings",
+                type: "number",
+                default: false,
+                read: (source) => source.derived.headings.length,
+            },
+            {
+                name: "links",
+                type: "number",
+                default: false,
+                read: (source) => source.document.references.length,
+            },
+            { name: "tasks", type: "number", default: false, read: (s) => s.derived.tasks.length },
+            { name: "code", type: "number", default: false, read: (s) => s.derived.codeBlocks.length },
+            { name: "words", type: "number", default: false, read: (s) => s.derived.words },
+            {
+                name: "frontmatterStatus",
+                type: "string",
+                default: false,
+                read: (source) => source.document.frontmatter.status,
+            },
+        ],
+    },
+    headings: {
+        kind: "headings",
+        rows: (_document, derived) => derived.headings,
+        functions: [],
+        fields: [
+            fileField,
+            { name: "line", type: "number", default: true, read: (s) => heading(s).line },
+            { name: "depth", type: "number", default: true, read: (s) => heading(s).depth },
+            { name: "text", type: "string", default: true, read: (s) => heading(s).text },
+            { name: "slug", type: "string", default: true, read: (s) => heading(s).slug },
+        ],
+    },
+    links: {
+        kind: "links",
+        rows: (document) => document.references,
+        functions: ["links-to"],
+        fields: [
+            fileField,
+            { name: "line", type: "number", default: true, read: (s) => link(s).line },
+            { name: "linkText", type: "string", default: true, read: (s) => link(s).linkText },
+            { name: "target", type: "string", default: true, read: (s) => link(s).target },
+            { name: "isImage", type: "boolean", default: false, read: (s) => link(s).isImage },
+            { name: "isExternal", type: "boolean", default: false, read: (s) => link(s).isExternal },
+            {
+                name: "isAnchorOnly",
+                type: "boolean",
+                default: false,
+                read: (s) => link(s).isAnchorOnly,
+            },
+            {
+                name: "referenceType",
+                type: "string",
+                default: false,
+                read: (s) => link(s).referenceType,
+            },
+        ],
+    },
+    tasks: {
+        kind: "tasks",
+        rows: (_document, derived) => derived.tasks,
+        functions: [],
+        fields: [
+            fileField,
+            { name: "line", type: "number", default: true, read: (s) => task(s).line },
+            { name: "checked", type: "boolean", default: true, read: (s) => task(s).checked },
+            { name: "text", type: "string", default: true, read: (s) => task(s).text },
+            // Both spellings: `checked` matches the historical task row, `status`
+            // matches the vocabulary `md query tasks --status` already uses.
+            {
+                name: "status",
+                type: "string",
+                default: false,
+                read: (s) => (task(s).checked ? "done" : "pending"),
+            },
+        ],
+    },
+    "code-blocks": {
+        kind: "code-blocks",
+        rows: (_document, derived) => derived.codeBlocks,
+        functions: [],
+        fields: [
+            fileField,
+            { name: "line", type: "number", default: true, read: (s) => block(s).line },
+            { name: "endLine", type: "number", default: true, read: (s) => block(s).endLine },
+            { name: "language", type: "string", default: true, read: (s) => block(s).lang },
+            { name: "content", type: "string", default: false, read: (s) => block(s).value },
+            {
+                name: "lines",
+                type: "number",
+                default: false,
+                read: (s) => block(s).endLine - block(s).line + 1,
+            },
+        ],
+    },
+    frontmatter: {
+        kind: "frontmatter",
+        rows: (_document, derived) => Object.entries(derived.frontmatterData).map(([key, value]) => ({ key, value })),
+        functions: [],
+        fields: [
+            fileField,
+            { name: "key", type: "string", default: true, read: (s) => entry(s).key },
+            {
+                name: "value",
+                type: "string",
+                default: true,
+                read: (s) => {
+                    const value = entry(s).value;
+                    if (value === null)
+                        return null;
+                    if (Array.isArray(value))
+                        return value.map((item) => String(item));
+                    if (typeof value === "object")
+                        return JSON.stringify(value);
+                    return value;
+                },
+            },
+            {
+                name: "type",
+                type: "string",
+                default: true,
+                read: (s) => {
+                    const value = entry(s).value;
+                    if (value === null)
+                        return "null";
+                    if (Array.isArray(value))
+                        return "array";
+                    return typeof value;
+                },
+            },
+        ],
+    },
+};
+/** Field names an entity offers, for an error message. */
+export function fieldNames(kind) {
+    return SPECS[kind].fields.map((field) => field.name);
+}
+export { extractText };
+//# sourceMappingURL=entities.js.map

package/dist/query/entities.js.map

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

package/dist/query/execute.d.ts

@@ -0,0 +1,22 @@
+import type { Workspace } from "../workspace.js";
+import type { QueryPlan } from "./plan.js";
+export interface ExecuteContext {
+    workspace: Workspace;
+    /** Already selected and sorted. */
+    files: string[];
+    /** Renders an absolute path for output. */
+    displayPath: (file: string) => string;
+}
+export interface QueryGroup {
+    key: string | null;
+    count: number;
+    rows: Record<string, unknown>[];
+}
+export interface QueryResult {
+    /** The projection, in column order. */
+    fields: string[];
+    rows: Record<string, unknown>[];
+    groups?: QueryGroup[];
+    matched: number;
+}
+export declare function executePlan(plan: QueryPlan, context: ExecuteContext): QueryResult;

package/dist/query/execute.js.map

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

package/dist/query/plan.d.ts

@@ -0,0 +1,76 @@
+import { type EntityKind, type FieldSpec, type Scalar } from "./entities.js";
+/** Anything the user got wrong. Always exit 1, never a silently empty result. */
+export declare class QueryUsageError extends Error {
+}
+export type ComparisonOperator = "=" | "!=" | "~" | ">" | ">=" | "<" | "<=";
+export interface ComparisonPredicate {
+    type: "comparison";
+    /** A registered field name, or a `frontmatter.<dotted.path>` token. */
+    field: string;
+    operator: ComparisonOperator;
+    /** The operand as typed. */
+    value: string;
+    /** Pre-coerced operand for a statically typed field. */
+    operand?: Scalar;
+    /** Undefined for a dynamic frontmatter field. */
+    spec?: FieldSpec;
+    /** Dotted key path when the field is dynamic. */
+    keyPath?: string;
+    source: string;
+}
+export interface NamedPredicate {
+    type: "named";
+    name: "has" | "links-to";
+    argument: string;
+    negated: boolean;
+    /** `links-to` only: the argument resolved against the working directory. */
+    resolved?: {
+        path: string;
+        fragment?: string;
+    };
+    /** `has` only: the field the argument names. */
+    spec?: FieldSpec;
+    keyPath?: string;
+    source: string;
+}
+export type Predicate = ComparisonPredicate | NamedPredicate;
+export interface QueryPlan {
+    entity: EntityKind;
+    /** Conjunction. There is deliberately no disjunction. */
+    predicates: Predicate[];
+    /** Projection in user order; the entity's default fields when unset. */
+    select: string[];
+    selectExplicit: boolean;
+    groupBy?: string;
+}
+export interface ResolvedField {
+    token: string;
+    spec?: FieldSpec;
+    keyPath?: string;
+}
+export declare function isEntityKind(value: string): value is EntityKind;
+/**
+ * Resolves a field token against an entity.
+ *
+ * `frontmatter.<key>` is a virtual field on every entity, read from the
+ * containing document. That is what lets `md query tasks --group-by
+ * frontmatter.owner` work without a join.
+ */
+export declare function resolveField(entity: EntityKind, token: string): ResolvedField;
+/**
+ * Parses one `--where` term.
+ *
+ * A term is `NAME:ARG` only when the text before the first colon is a valid
+ * predicate name *and* that colon precedes any operator. So `links-to:x.md` is
+ * a named predicate while `target=https://example.com` is a comparison.
+ */
+export declare function parseWhere(entity: EntityKind, term: string): Predicate;
+/** Splits and validates a comma-separated, repeatable field list. */
+export declare function parseFieldList(entity: EntityKind, values: readonly string[]): string[];
+export interface PlanInput {
+    kind: string;
+    where: string[];
+    select: string[];
+    groupBy?: string;
+}
+export declare function buildPlan(input: PlanInput): QueryPlan;