@squads-sh/validator 0.1.0

package/dist/categories/structure.js

@@ -0,0 +1,76 @@
+const CAT = "structure";
+/**
+ * Category 2: Structure validation
+ * Weight: 15%
+ *
+ * Validates:
+ * - agents/ directory exists with at least 1 .md file
+ * - tasks/ directory exists (warning if missing)
+ * - workflows/ directory exists (warning if missing)
+ * - config/ directory exists (warning if missing)
+ * - Each file listed in components.* exists in the FileTree
+ */
+export function validateStructure(fileTree, manifest) {
+    const findings = [];
+    const dirs = new Set();
+    for (const path of fileTree.keys()) {
+        const firstSegment = path.split("/")[0];
+        if (firstSegment)
+            dirs.add(firstSegment);
+    }
+    // Check agents/ directory
+    const agentFiles = [...fileTree.keys()].filter((p) => p.startsWith("agents/") && p.endsWith(".md"));
+    if (agentFiles.length === 0) {
+        findings.push({
+            severity: "error",
+            category: CAT,
+            message: "agents/ directory must contain at least one .md file",
+        });
+    }
+    // Optional directories (warnings)
+    for (const dir of ["tasks", "workflows", "config"]) {
+        const hasFiles = [...fileTree.keys()].some((p) => p.startsWith(`${dir}/`));
+        if (!hasFiles) {
+            findings.push({
+                severity: "warning",
+                category: CAT,
+                message: `Optional directory ${dir}/ not found`,
+            });
+        }
+    }
+    // Validate components.* entries exist in FileTree
+    if (manifest?.components) {
+        const componentSections = [
+            ["agents", "agents/"],
+            ["tasks", "tasks/"],
+            ["workflows", "workflows/"],
+        ];
+        for (const [key, prefix] of componentSections) {
+            const list = manifest.components[key];
+            if (Array.isArray(list)) {
+                for (const item of list) {
+                    if (typeof item !== "string")
+                        continue;
+                    // Try with and without extension
+                    const candidates = [
+                        `${prefix}${item}`,
+                        `${prefix}${item}.md`,
+                        `${prefix}${item}.yaml`,
+                        `${prefix}${item}.yml`,
+                    ];
+                    const found = candidates.some((c) => fileTree.has(c));
+                    if (!found) {
+                        findings.push({
+                            severity: "error",
+                            category: CAT,
+                            message: `Component '${key}.${item}' listed in squad.yaml but file not found in ${prefix}`,
+                            file: "squad.yaml",
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=structure.js.map

package/dist/categories/structure.js.map

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

package/dist/categories/tasks.d.ts

@@ -0,0 +1,20 @@
+import type { FileTree, ValidationFinding, ParsedTask } from "../types.js";
+/**
+ * Category 4: Tasks validation
+ * Weight: 15%
+ *
+ * Validates:
+ * - YAML frontmatter exists
+ * - task (camelCase with parentheses)
+ * - responsavel (non-empty)
+ * - responsavel_type in {Agente, Worker, Humano, Clone}
+ * - atomic_layer in {Atom, Molecule, Organism, Template, Page}
+ * - Entrada (array with at least 1 item, each with 4 fields)
+ * - Saida (array with at least 1 item, each with 4 fields)
+ * - Checklist (non-empty)
+ */
+export declare function validateTasks(fileTree: FileTree): {
+    findings: ValidationFinding[];
+    tasks: ParsedTask[];
+};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/categories/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/categories/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO3E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,GACjB;IAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAuIxD"}

package/dist/categories/tasks.js

@@ -0,0 +1,195 @@
+import { extractFrontmatter, hasFrontmatter } from "../parser.js";
+import { CAMEL_CASE_PAREN } from "../utils/patterns.js";
+import { ATOMIC_LAYERS, RESPONSAVEL_TYPES } from "../utils/enums.js";
+const CAT = "tasks";
+/**
+ * Category 4: Tasks validation
+ * Weight: 15%
+ *
+ * Validates:
+ * - YAML frontmatter exists
+ * - task (camelCase with parentheses)
+ * - responsavel (non-empty)
+ * - responsavel_type in {Agente, Worker, Humano, Clone}
+ * - atomic_layer in {Atom, Molecule, Organism, Template, Page}
+ * - Entrada (array with at least 1 item, each with 4 fields)
+ * - Saida (array with at least 1 item, each with 4 fields)
+ * - Checklist (non-empty)
+ */
+export function validateTasks(fileTree) {
+    const findings = [];
+    const tasks = [];
+    const taskFiles = [...fileTree.keys()].filter((p) => p.startsWith("tasks/") && p.endsWith(".md"));
+    if (taskFiles.length === 0) {
+        return { findings, tasks };
+    }
+    for (const file of taskFiles) {
+        const content = fileTree.get(file);
+        if (!hasFrontmatter(content)) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Task file missing YAML frontmatter block (--- ... ---)",
+                file,
+            });
+            tasks.push({ file });
+            continue;
+        }
+        const fm = extractFrontmatter(content);
+        if (!fm) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Task file has invalid YAML in frontmatter",
+                file,
+            });
+            tasks.push({ file });
+            continue;
+        }
+        const parsed = {
+            file,
+            task: fm["task"],
+            responsavel: fm["responsavel"],
+            responsavel_type: fm["responsavel_type"],
+            atomic_layer: fm["atomic_layer"],
+            Entrada: fm["Entrada"],
+            Saida: fm["Saida"],
+            Checklist: fm["Checklist"],
+        };
+        tasks.push(parsed);
+        // task identifier
+        if (!parsed.task) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Missing 'task' field",
+                file,
+            });
+        }
+        else if (typeof parsed.task === "string" && !CAMEL_CASE_PAREN.test(parsed.task)) {
+            findings.push({
+                severity: "warning",
+                category: CAT,
+                message: `'task' should be camelCase with parentheses (e.g. myTask()), got: "${parsed.task}"`,
+                file,
+            });
+        }
+        // responsavel
+        if (!parsed.responsavel) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Missing 'responsavel' field",
+                file,
+            });
+        }
+        // responsavel_type
+        if (!parsed.responsavel_type) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Missing 'responsavel_type' field",
+                file,
+            });
+        }
+        else if (typeof parsed.responsavel_type === "string" &&
+            !RESPONSAVEL_TYPES.has(parsed.responsavel_type)) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: `'responsavel_type' must be one of {${[...RESPONSAVEL_TYPES].join(", ")}}, got: "${parsed.responsavel_type}"`,
+                file,
+            });
+        }
+        // atomic_layer
+        if (!parsed.atomic_layer) {
+            findings.push({
+                severity: "warning",
+                category: CAT,
+                message: "Missing 'atomic_layer' field",
+                file,
+            });
+        }
+        else if (typeof parsed.atomic_layer === "string" &&
+            !ATOMIC_LAYERS.has(parsed.atomic_layer)) {
+            findings.push({
+                severity: "warning",
+                category: CAT,
+                message: `'atomic_layer' should be one of {${[...ATOMIC_LAYERS].join(", ")}}, got: "${parsed.atomic_layer}"`,
+                file,
+            });
+        }
+        // Entrada
+        validateContractArray(parsed.Entrada, "Entrada", file, findings);
+        // Saida
+        validateContractArray(parsed.Saida, "Saida", file, findings);
+        // Checklist
+        if (!parsed.Checklist) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Missing 'Checklist' field",
+                file,
+            });
+        }
+    }
+    return { findings, tasks };
+}
+function validateContractArray(arr, name, file, findings) {
+    if (!arr || !Array.isArray(arr)) {
+        findings.push({
+            severity: "error",
+            category: CAT,
+            message: `Missing '${name}' field (must be an array)`,
+            file,
+        });
+        return;
+    }
+    if (arr.length === 0) {
+        findings.push({
+            severity: "error",
+            category: CAT,
+            message: `'${name}' must have at least 1 item`,
+            file,
+        });
+        return;
+    }
+    // Required fields with accepted aliases
+    const fieldChecks = [
+        { canonical: "nome", aliases: ["nome", "campo"] },
+        { canonical: "tipo", aliases: ["tipo"] },
+        { canonical: "obrigatorio", aliases: ["obrigatorio", "persistido"] },
+    ];
+    // "descricao" is recommended but optional — aliases: origen, destino
+    const optionalWithAliases = [
+        { canonical: "descricao", aliases: ["descricao", "origen", "destino"] },
+    ];
+    for (let i = 0; i < arr.length; i++) {
+        const item = arr[i];
+        if (!item || typeof item !== "object") {
+            findings.push({
+                severity: "warning",
+                category: CAT,
+                message: `'${name}[${i}]' is not a valid object`,
+                file,
+            });
+            continue;
+        }
+        const keys = Object.keys(item);
+        // Check required fields (with alias support)
+        const missing = fieldChecks
+            .filter((check) => !check.aliases.some((alias) => keys.includes(alias)))
+            .map((check) => check.canonical);
+        if (missing.length > 0) {
+            findings.push({
+                severity: "warning",
+                category: CAT,
+                message: `'${name}[${i}]' missing fields: ${missing.join(", ")}`,
+                file,
+            });
+        }
+        // Check optional fields (just a hint, no finding)
+        // "descricao" or its aliases (origen/destino) are recommended but not required
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/categories/tasks.js.map

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

package/dist/categories/workflows.d.ts

@@ -0,0 +1,17 @@
+import type { FileTree, ValidationFinding, ParsedWorkflow } from "../types.js";
+/**
+ * Category 5: Workflows validation
+ * Weight: 10%
+ *
+ * Validates:
+ * - Valid YAML
+ * - workflow_name (snake_case)
+ * - description (non-empty)
+ * - agent_sequence (array with at least 1 entry)
+ * - success_indicators (array with at least 1 entry)
+ */
+export declare function validateWorkflows(fileTree: FileTree): {
+    findings: ValidationFinding[];
+    workflows: ParsedWorkflow[];
+};
+//# sourceMappingURL=workflows.d.ts.map

package/dist/categories/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/categories/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAM/E;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,GACjB;IAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,cAAc,EAAE,CAAA;CAAE,CAuHhE"}

package/dist/categories/workflows.js

@@ -0,0 +1,125 @@
+import { parseYaml } from "../parser.js";
+import { SNAKE_CASE } from "../utils/patterns.js";
+const CAT = "workflows";
+/**
+ * Category 5: Workflows validation
+ * Weight: 10%
+ *
+ * Validates:
+ * - Valid YAML
+ * - workflow_name (snake_case)
+ * - description (non-empty)
+ * - agent_sequence (array with at least 1 entry)
+ * - success_indicators (array with at least 1 entry)
+ */
+export function validateWorkflows(fileTree) {
+    const findings = [];
+    const workflows = [];
+    const workflowFiles = [...fileTree.keys()].filter((p) => p.startsWith("workflows/") &&
+        (p.endsWith(".yaml") || p.endsWith(".yml")));
+    if (workflowFiles.length === 0) {
+        return { findings, workflows };
+    }
+    for (const file of workflowFiles) {
+        const content = fileTree.get(file);
+        const parsed = parseYaml(content);
+        if (!parsed) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Workflow file contains invalid YAML",
+                file,
+            });
+            workflows.push({ file });
+            continue;
+        }
+        const wf = {
+            file,
+            workflow_name: parsed["workflow_name"],
+            description: parsed["description"],
+            agent_sequence: parsed["agent_sequence"],
+            success_indicators: parsed["success_indicators"],
+            transitions: parsed["transitions"],
+        };
+        workflows.push(wf);
+        // workflow_name
+        if (!wf.workflow_name) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Missing 'workflow_name' field",
+                file,
+            });
+        }
+        else if (typeof wf.workflow_name === "string" &&
+            !SNAKE_CASE.test(wf.workflow_name)) {
+            findings.push({
+                severity: "warning",
+                category: CAT,
+                message: `'workflow_name' should be snake_case, got: "${wf.workflow_name}"`,
+                file,
+            });
+        }
+        // description
+        if (!wf.description) {
+            findings.push({
+                severity: "warning",
+                category: CAT,
+                message: "Missing 'description' field",
+                file,
+            });
+        }
+        // agent_sequence
+        if (!wf.agent_sequence) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Missing 'agent_sequence' field",
+                file,
+            });
+        }
+        else if (!Array.isArray(wf.agent_sequence)) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "'agent_sequence' must be an array",
+                file,
+            });
+        }
+        else if (wf.agent_sequence.length === 0) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "'agent_sequence' must have at least 1 entry",
+                file,
+            });
+        }
+        // success_indicators
+        if (!wf.success_indicators) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "Missing 'success_indicators' field",
+                file,
+            });
+        }
+        else if (!Array.isArray(wf.success_indicators)) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "'success_indicators' must be an array",
+                file,
+            });
+        }
+        else if (wf.success_indicators.length === 0) {
+            findings.push({
+                severity: "error",
+                category: CAT,
+                message: "'success_indicators' must have at least 1 entry",
+                file,
+            });
+        }
+    }
+    return { findings, workflows };
+}
+//# sourceMappingURL=workflows.js.map

package/dist/categories/workflows.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import type { FileTree, ValidationReport } from "./types.js";
+/**
+ * Validate an AIOS Squad from a FileTree.
+ *
+ * The FileTree is a Map<string, string> of relative paths to file contents.
+ * The validator is isomorphic — it works in Node.js, Deno, browsers, etc.
+ *
+ * @param fileTree Map of relative file paths to their contents
+ * @returns ValidationReport with score, status, and per-category results
+ */
+export declare function validateSquad(fileTree: FileTree): ValidationReport;
+export type { FileTree, ValidationReport, ValidationStatus, ValidationFinding, CategoryResult, CategoryName, Severity, ParsedManifest, ParsedAgent, ParsedTask, ParsedWorkflow, } from "./types.js";
+export { CATEGORY_WEIGHTS, CATEGORY_LABELS } from "./types.js";
+//# 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":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CA0DlE;AAGD,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,WAAW,EACX,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,62 @@
+import { validateManifest } from "./categories/manifest.js";
+import { validateStructure } from "./categories/structure.js";
+import { validateAgents } from "./categories/agents.js";
+import { validateTasks } from "./categories/tasks.js";
+import { validateWorkflows } from "./categories/workflows.js";
+import { validateCrossReferences } from "./categories/cross-refs.js";
+import { buildCategoryResult, computeWeightedScore, computeStatus, } from "./scoring.js";
+/**
+ * Validate an AIOS Squad from a FileTree.
+ *
+ * The FileTree is a Map<string, string> of relative paths to file contents.
+ * The validator is isomorphic — it works in Node.js, Deno, browsers, etc.
+ *
+ * @param fileTree Map of relative file paths to their contents
+ * @returns ValidationReport with score, status, and per-category results
+ */
+export function validateSquad(fileTree) {
+    const allFindings = [];
+    // Category 1: Manifest
+    const { findings: manifestFindings, parsed: manifest } = validateManifest(fileTree);
+    allFindings.push(...manifestFindings);
+    // Category 2: Structure
+    const structureFindings = validateStructure(fileTree, manifest);
+    allFindings.push(...structureFindings);
+    // Category 3: Agents
+    const { findings: agentFindings, agents } = validateAgents(fileTree);
+    allFindings.push(...agentFindings);
+    // Category 4: Tasks
+    const { findings: taskFindings, tasks } = validateTasks(fileTree);
+    allFindings.push(...taskFindings);
+    // Category 5: Workflows
+    const { findings: workflowFindings, workflows } = validateWorkflows(fileTree);
+    allFindings.push(...workflowFindings);
+    // Category 6: Cross-references
+    const crossRefFindings = validateCrossReferences(agents, tasks, workflows);
+    allFindings.push(...crossRefFindings);
+    // Build category results
+    const categoryNames = [
+        "manifest",
+        "structure",
+        "agents",
+        "tasks",
+        "workflows",
+        "cross-refs",
+    ];
+    const categories = categoryNames.map((name) => buildCategoryResult(name, allFindings));
+    const totalErrors = allFindings.filter((f) => f.severity === "error").length;
+    const totalWarnings = allFindings.filter((f) => f.severity === "warning").length;
+    return {
+        score: computeWeightedScore(categories),
+        status: computeStatus(totalErrors, totalWarnings),
+        categories,
+        findings: allFindings,
+        summary: {
+            totalErrors,
+            totalWarnings,
+            fileCount: fileTree.size,
+        },
+    };
+}
+export { CATEGORY_WEIGHTS, CATEGORY_LABELS } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB;IAC9C,MAAM,WAAW,GAAwB,EAAE,CAAC;IAE5C,uBAAuB;IACvB,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,GACpD,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7B,WAAW,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAEtC,wBAAwB;IACxB,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChE,WAAW,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAEvC,qBAAqB;IACrB,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACrE,WAAW,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IAEnC,oBAAoB;IACpB,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClE,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;IAElC,wBAAwB;IACxB,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC9E,WAAW,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAEtC,+BAA+B;IAC/B,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3E,WAAW,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAEtC,yBAAyB;IACzB,MAAM,aAAa,GAAmB;QACpC,UAAU;QACV,WAAW;QACX,QAAQ;QACR,OAAO;QACP,WAAW;QACX,YAAY;KACb,CAAC;IAEF,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CACvC,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAChC,CAAC,MAAM,CAAC;IAET,OAAO;QACL,KAAK,EAAE,oBAAoB,CAAC,UAAU,CAAC;QACvC,MAAM,EAAE,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC;QACjD,UAAU;QACV,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE;YACP,WAAW;YACX,aAAa;YACb,SAAS,EAAE,QAAQ,CAAC,IAAI;SACzB;KACF,CAAC;AACJ,CAAC;AAiBD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Extract YAML frontmatter from a Markdown file.
+ * Returns the parsed object or null if no frontmatter found.
+ */
+export declare function extractFrontmatter(content: string): Record<string, unknown> | null;
+/**
+ * Parse a YAML string into an object.
+ * Returns null on parse failure.
+ */
+export declare function parseYaml(content: string): Record<string, unknown> | null;
+/**
+ * Deep get a nested value by dot-separated path.
+ * e.g. getNestedValue(obj, "aios.minVersion")
+ */
+export declare function getNestedValue(obj: Record<string, unknown>, path: string): unknown;
+/**
+ * Check if content has YAML frontmatter block.
+ */
+export declare function hasFrontmatter(content: string): boolean;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAalF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQlF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/parser.js

@@ -0,0 +1,58 @@
+import yaml from "js-yaml";
+import { FRONTMATTER_BLOCK } from "./utils/patterns.js";
+/**
+ * Extract YAML frontmatter from a Markdown file.
+ * Returns the parsed object or null if no frontmatter found.
+ */
+export function extractFrontmatter(content) {
+    const match = content.match(FRONTMATTER_BLOCK);
+    if (!match || !match[1])
+        return null;
+    try {
+        const parsed = yaml.load(match[1]);
+        if (parsed && typeof parsed === "object") {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a YAML string into an object.
+ * Returns null on parse failure.
+ */
+export function parseYaml(content) {
+    try {
+        const parsed = yaml.load(content);
+        if (parsed && typeof parsed === "object") {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Deep get a nested value by dot-separated path.
+ * e.g. getNestedValue(obj, "aios.minVersion")
+ */
+export function getNestedValue(obj, path) {
+    const keys = path.split(".");
+    let current = obj;
+    for (const key of keys) {
+        if (current == null || typeof current !== "object")
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Check if content has YAML frontmatter block.
+ */
+export function hasFrontmatter(content) {
+    return FRONTMATTER_BLOCK.test(content);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,MAAiC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,MAAiC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAA4B,EAAE,IAAY;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACrE,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}