dot-agents 0.2.0 → 0.3.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAG5B,cAAc,uBAAuB,CAAC"}

package/dist/lib/index.js

@@ -6,4 +6,6 @@ export * from "./persona.js";
 export * from "./workflow.js";
 export * from "./variables.js";
 export * from "./config.js";
+// Validation
+export * from "./validation/index.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,oBAAoB;AACpB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,oBAAoB;AACpB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAE5B,aAAa;AACb,cAAc,uBAAuB,CAAC"}

package/dist/lib/validation/cron.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Validate cron expression syntax
+ *
+ * Supports standard 5-field cron format:
+ * minute hour day-of-month month day-of-week
+ *
+ * Each field can be:
+ * - asterisk (any value)
+ * - number (specific value)
+ * - range (1-5)
+ * - step (star/15 or 1-5/2)
+ * - list (1,3,5)
+ * - combinations of above
+ */
+interface CronValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validate a cron expression
+ */
+export declare function validateCron(expression: string): CronValidationResult;
+/**
+ * Parse a human-readable schedule hint into a cron suggestion
+ * This is best-effort for common patterns
+ */
+export declare function suggestCronFromHint(hint: string): string | null;
+export {};
+//# sourceMappingURL=cron.d.ts.map

package/dist/lib/validation/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/cron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,UAAU,oBAAoB;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuFD;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CA0BrE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2C/D"}

package/dist/lib/validation/cron.js

@@ -0,0 +1,159 @@
+/**
+ * Validate cron expression syntax
+ *
+ * Supports standard 5-field cron format:
+ * minute hour day-of-month month day-of-week
+ *
+ * Each field can be:
+ * - asterisk (any value)
+ * - number (specific value)
+ * - range (1-5)
+ * - step (star/15 or 1-5/2)
+ * - list (1,3,5)
+ * - combinations of above
+ */
+const FIELD_RANGES = {
+    minute: [0, 59],
+    hour: [0, 23],
+    dayOfMonth: [1, 31],
+    month: [1, 12],
+    dayOfWeek: [0, 7], // 0 and 7 both represent Sunday
+};
+const FIELD_NAMES = ["minute", "hour", "dayOfMonth", "month", "dayOfWeek"];
+/**
+ * Validate a single cron field value
+ */
+function validateField(value, fieldName) {
+    const [min, max] = FIELD_RANGES[fieldName];
+    // Handle wildcard
+    if (value === "*") {
+        return { valid: true };
+    }
+    // Handle step values (*/n or range/n)
+    if (value.includes("/")) {
+        const [base, step] = value.split("/");
+        if (!step || isNaN(Number(step)) || Number(step) < 1) {
+            return { valid: false, error: `Invalid step value: ${step}` };
+        }
+        // Validate the base part
+        if (base !== "*") {
+            const baseResult = validateField(base, fieldName);
+            if (!baseResult.valid) {
+                return baseResult;
+            }
+        }
+        return { valid: true };
+    }
+    // Handle lists (1,2,3)
+    if (value.includes(",")) {
+        const parts = value.split(",");
+        for (const part of parts) {
+            const result = validateField(part.trim(), fieldName);
+            if (!result.valid) {
+                return result;
+            }
+        }
+        return { valid: true };
+    }
+    // Handle ranges (1-5)
+    if (value.includes("-")) {
+        const [start, end] = value.split("-").map(Number);
+        if (isNaN(start) || isNaN(end)) {
+            return { valid: false, error: `Invalid range: ${value}` };
+        }
+        if (start < min || start > max || end < min || end > max) {
+            return {
+                valid: false,
+                error: `Range ${value} out of bounds (${min}-${max})`,
+            };
+        }
+        if (start > end) {
+            return { valid: false, error: `Invalid range: start > end in ${value}` };
+        }
+        return { valid: true };
+    }
+    // Handle single number
+    const num = Number(value);
+    if (isNaN(num)) {
+        return { valid: false, error: `Invalid value: ${value}` };
+    }
+    if (num < min || num > max) {
+        return {
+            valid: false,
+            error: `Value ${num} out of bounds (${min}-${max})`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate a cron expression
+ */
+export function validateCron(expression) {
+    if (!expression || typeof expression !== "string") {
+        return { valid: false, error: "Cron expression must be a non-empty string" };
+    }
+    const trimmed = expression.trim();
+    const fields = trimmed.split(/\s+/);
+    if (fields.length !== 5) {
+        return {
+            valid: false,
+            error: `Expected 5 fields (minute hour day month weekday), got ${fields.length}`,
+        };
+    }
+    for (let i = 0; i < fields.length; i++) {
+        const result = validateField(fields[i], FIELD_NAMES[i]);
+        if (!result.valid) {
+            return {
+                valid: false,
+                error: `Invalid ${FIELD_NAMES[i]}: ${result.error}`,
+            };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Parse a human-readable schedule hint into a cron suggestion
+ * This is best-effort for common patterns
+ */
+export function suggestCronFromHint(hint) {
+    const lower = hint.toLowerCase();
+    // Common patterns
+    if (lower.includes("hourly")) {
+        return "0 * * * *";
+    }
+    if (lower.includes("daily")) {
+        // Try to extract time
+        const timeMatch = lower.match(/(\d{1,2}):?(\d{2})?\s*(am|pm)?/i);
+        if (timeMatch) {
+            let hour = parseInt(timeMatch[1], 10);
+            const minute = timeMatch[2] ? parseInt(timeMatch[2], 10) : 0;
+            const meridiem = timeMatch[3]?.toLowerCase();
+            if (meridiem === "pm" && hour < 12)
+                hour += 12;
+            if (meridiem === "am" && hour === 12)
+                hour = 0;
+            return `${minute} ${hour} * * *`;
+        }
+        return "0 9 * * *"; // Default to 9 AM
+    }
+    if (lower.includes("weekly")) {
+        return "0 9 * * 1"; // Monday 9 AM
+    }
+    if (lower.includes("monthly")) {
+        return "0 9 1 * *"; // 1st of month 9 AM
+    }
+    // Try to extract "every N hours/minutes"
+    const everyMatch = lower.match(/every\s+(\d+)\s+(hour|minute|min)/i);
+    if (everyMatch) {
+        const n = parseInt(everyMatch[1], 10);
+        const unit = everyMatch[2].toLowerCase();
+        if (unit.startsWith("hour")) {
+            return `0 */${n} * * *`;
+        }
+        if (unit.startsWith("min")) {
+            return `*/${n} * * * *`;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=cron.js.map

package/dist/lib/validation/cron.js.map

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

package/dist/lib/validation/index.d.ts

@@ -0,0 +1,18 @@
+import { ValidationResult, ValidationSummary } from "./types.js";
+export * from "./types.js";
+export { validateWorkflow } from "./workflow.js";
+export { validatePersona } from "./persona.js";
+export { validateCron } from "./cron.js";
+/**
+ * Validate all workflows in a directory
+ */
+export declare function validateAllWorkflows(workflowsDir: string, personasDir?: string): Promise<ValidationResult[]>;
+/**
+ * Validate all personas in a directory
+ */
+export declare function validateAllPersonas(personasDir: string): Promise<ValidationResult[]>;
+/**
+ * Validate entire .agents directory
+ */
+export declare function validateAll(agentsDir: string): Promise<ValidationSummary>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAIpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAuFzC;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA8B7B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAc7B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAyB5B"}

package/dist/lib/validation/index.js

@@ -0,0 +1,135 @@
+import { readdir, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { createError, } from "./types.js";
+import { validateWorkflow, getWorkflowPersonaRef } from "./workflow.js";
+import { validatePersona } from "./persona.js";
+export * from "./types.js";
+export { validateWorkflow } from "./workflow.js";
+export { validatePersona } from "./persona.js";
+export { validateCron } from "./cron.js";
+const PERSONA_FILENAME = "PERSONA.md";
+const WORKFLOW_FILENAME = "WORKFLOW.md";
+/**
+ * Check if a directory contains a specific file
+ */
+async function hasFile(dirPath, filename) {
+    try {
+        const filePath = join(dirPath, filename);
+        const stats = await stat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Recursively find all directories containing a specific file
+ */
+async function findDirectoriesWithFile(root, filename) {
+    const results = [];
+    async function scanDir(dir) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const subDir = join(dir, entry.name);
+                    if (await hasFile(subDir, filename)) {
+                        results.push(subDir);
+                    }
+                    await scanDir(subDir);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+        }
+    }
+    await scanDir(root);
+    return results;
+}
+/**
+ * Check if a persona path exists
+ */
+async function personaExists(personaRef, personasDir) {
+    const personaPath = join(personasDir, personaRef);
+    return hasFile(personaPath, PERSONA_FILENAME);
+}
+/**
+ * Determine if a persona is a root persona (no parent with PERSONA.md)
+ */
+async function isRootPersona(personaPath, personasRoot) {
+    const relativePath = relative(personasRoot, personaPath);
+    const parts = relativePath.split("/").filter(Boolean);
+    // If it's directly under personasRoot, it's a root persona
+    if (parts.length <= 1) {
+        return true;
+    }
+    // Check if any parent directory has a PERSONA.md
+    let currentPath = personasRoot;
+    for (let i = 0; i < parts.length - 1; i++) {
+        currentPath = join(currentPath, parts[i]);
+        if (await hasFile(currentPath, PERSONA_FILENAME)) {
+            return false; // Has a parent persona
+        }
+    }
+    return true;
+}
+/**
+ * Validate all workflows in a directory
+ */
+export async function validateAllWorkflows(workflowsDir, personasDir) {
+    const workflowPaths = await findDirectoriesWithFile(workflowsDir, WORKFLOW_FILENAME);
+    const results = [];
+    for (const workflowPath of workflowPaths) {
+        const result = await validateWorkflow(workflowPath);
+        // Cross-validate persona reference if personasDir provided
+        if (personasDir && result.valid) {
+            const personaRef = await getWorkflowPersonaRef(workflowPath);
+            if (personaRef && !(await personaExists(personaRef, personasDir))) {
+                result.issues.push(createError("reference_not_found", "persona", `Persona '${personaRef}' not found`, `Create persona at: ${join(personasDir, personaRef, PERSONA_FILENAME)}`));
+                result.valid = false;
+            }
+        }
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Validate all personas in a directory
+ */
+export async function validateAllPersonas(personasDir) {
+    const personaPaths = await findDirectoriesWithFile(personasDir, PERSONA_FILENAME);
+    const results = [];
+    for (const personaPath of personaPaths) {
+        const isRoot = await isRootPersona(personaPath, personasDir);
+        const result = await validatePersona(personaPath, isRoot);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Validate entire .agents directory
+ */
+export async function validateAll(agentsDir) {
+    const personasDir = join(agentsDir, "personas");
+    const workflowsDir = join(agentsDir, "workflows");
+    const personaResults = await validateAllPersonas(personasDir);
+    const workflowResults = await validateAllWorkflows(workflowsDir, personasDir);
+    const validPersonas = personaResults.filter((r) => r.valid).length;
+    const validWorkflows = workflowResults.filter((r) => r.valid).length;
+    return {
+        personas: {
+            total: personaResults.length,
+            valid: validPersonas,
+            results: personaResults,
+        },
+        workflows: {
+            total: workflowResults.length,
+            valid: validWorkflows,
+            results: workflowResults,
+        },
+        valid: validPersonas === personaResults.length &&
+            validWorkflows === workflowResults.length,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/validation/index.js.map

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

package/dist/lib/validation/persona.d.ts

@@ -0,0 +1,9 @@
+import { ValidationResult } from "./types.js";
+/**
+ * Validate a persona file
+ *
+ * @param personaPath Path to the persona directory or PERSONA.md file
+ * @param isRootPersona Whether this is a root persona (requires cmd)
+ */
+export declare function validatePersona(personaPath: string, isRootPersona?: boolean): Promise<ValidationResult>;
+//# sourceMappingURL=persona.d.ts.map

package/dist/lib/validation/persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/persona.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AA4CpB;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,GAAE,OAAc,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAyL3B"}

package/dist/lib/validation/persona.js

@@ -0,0 +1,143 @@
+import { readFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { createError, createWarning, } from "./types.js";
+const PERSONA_FILENAME = "PERSONA.md";
+/**
+ * Known persona frontmatter fields
+ */
+const KNOWN_FIELDS = new Set(["name", "description", "cmd", "env", "skills"]);
+/**
+ * Common legacy/misnamed fields and their correct names
+ */
+const FIELD_SUGGESTIONS = {
+    command: "cmd",
+    commands: "cmd",
+    skill: "skills",
+    environment: "env",
+    variables: "env",
+    model: "env.CLAUDE_MODEL or similar",
+};
+/**
+ * Parse frontmatter from markdown content without full validation
+ */
+function parseFrontmatter(content) {
+    const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+    const match = content.match(frontmatterRegex);
+    if (!match) {
+        return null;
+    }
+    const [, yamlContent, body] = match;
+    try {
+        const frontmatter = parseYaml(yamlContent);
+        return { frontmatter, body: body.trim() };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Validate a persona file
+ *
+ * @param personaPath Path to the persona directory or PERSONA.md file
+ * @param isRootPersona Whether this is a root persona (requires cmd)
+ */
+export async function validatePersona(personaPath, isRootPersona = true) {
+    const filePath = personaPath.endsWith(PERSONA_FILENAME)
+        ? personaPath
+        : join(personaPath, PERSONA_FILENAME);
+    const issues = [];
+    let name;
+    try {
+        const content = await readFile(filePath, "utf-8");
+        const parsed = parseFrontmatter(content);
+        if (!parsed) {
+            issues.push(createError("invalid_value", "frontmatter", "No valid YAML frontmatter found", "File must start with --- followed by YAML and another ---"));
+            return {
+                path: filePath,
+                valid: false,
+                issues,
+            };
+        }
+        const { frontmatter } = parsed;
+        name = frontmatter.name;
+        // Check required fields
+        if (!frontmatter.name) {
+            issues.push(createError("missing_field", "name", "Missing required 'name' field", "Add: name: my-persona"));
+        }
+        else if (typeof frontmatter.name !== "string") {
+            issues.push(createError("invalid_type", "name", "'name' must be a string"));
+        }
+        // cmd is required for root personas, optional for child personas (inherited)
+        if (isRootPersona && !frontmatter.cmd) {
+            issues.push(createError("missing_field", "cmd", "Missing required 'cmd' field for root persona", "Add: cmd: \"claude --print\" or cmd: [\"claude --print\", \"claude -p\"]"));
+        }
+        // Validate cmd type if present
+        if (frontmatter.cmd !== undefined) {
+            if (typeof frontmatter.cmd !== "string" &&
+                !Array.isArray(frontmatter.cmd)) {
+                issues.push(createError("invalid_type", "cmd", "'cmd' must be a string or array of strings", "Use: cmd: \"claude --print\" or cmd: [\"claude --print\"]"));
+            }
+            else if (Array.isArray(frontmatter.cmd)) {
+                frontmatter.cmd.forEach((c, index) => {
+                    if (typeof c !== "string") {
+                        issues.push(createError("invalid_type", `cmd[${index}]`, "Command must be a string"));
+                    }
+                });
+            }
+        }
+        // Validate env if present
+        if (frontmatter.env !== undefined) {
+            if (typeof frontmatter.env !== "object" ||
+                Array.isArray(frontmatter.env) ||
+                frontmatter.env === null) {
+                issues.push(createError("invalid_type", "env", "'env' must be an object", "Use: env: { CLAUDE_MODEL: 'sonnet' }"));
+            }
+            else {
+                // Check that all env values are strings
+                const env = frontmatter.env;
+                for (const [key, value] of Object.entries(env)) {
+                    if (typeof value !== "string") {
+                        issues.push(createWarning("unknown_field", `env.${key}`, `Environment variable '${key}' should be a string, got ${typeof value}`, "Convert to string or use ${VAR} expansion"));
+                    }
+                }
+            }
+        }
+        // Validate skills if present
+        if (frontmatter.skills !== undefined) {
+            if (!Array.isArray(frontmatter.skills)) {
+                issues.push(createError("invalid_type", "skills", "'skills' must be an array of glob patterns", "Use: skills: [\"productivity/**\", \"!experimental/*\"]"));
+            }
+            else {
+                frontmatter.skills.forEach((skill, index) => {
+                    if (typeof skill !== "string") {
+                        issues.push(createError("invalid_type", `skills[${index}]`, "Skill pattern must be a string"));
+                    }
+                });
+            }
+        }
+        // Check for unknown/legacy fields
+        for (const key of Object.keys(frontmatter)) {
+            if (!KNOWN_FIELDS.has(key)) {
+                const suggestion = FIELD_SUGGESTIONS[key];
+                if (suggestion) {
+                    issues.push(createWarning("unknown_field", key, `Unknown field '${key}'`, `Did you mean '${suggestion}'?`));
+                }
+                else {
+                    issues.push(createWarning("unknown_field", key, `Unknown field '${key}'`));
+                }
+            }
+        }
+    }
+    catch (error) {
+        issues.push(createError("invalid_value", "file", `Failed to read persona: ${error.message}`));
+    }
+    const hasErrors = issues.some((i) => i.severity === "error");
+    return {
+        path: dirname(filePath),
+        name,
+        valid: !hasErrors,
+        issues,
+    };
+}
+//# sourceMappingURL=persona.js.map

package/dist/lib/validation/persona.js.map

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

package/dist/lib/validation/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Severity levels for validation issues
+ */
+export type ValidationSeverity = "error" | "warning";
+/**
+ * Types of validation errors
+ */
+export type ValidationErrorType = "missing_field" | "invalid_type" | "invalid_value" | "reference_not_found";
+/**
+ * Types of validation warnings
+ */
+export type ValidationWarningType = "unknown_field" | "deprecated_field";
+/**
+ * A validation issue (error or warning)
+ */
+export interface ValidationIssue {
+    severity: ValidationSeverity;
+    type: ValidationErrorType | ValidationWarningType;
+    /** Path to the problematic field (e.g., "on.schedule[0].cron") */
+    path: string;
+    /** Human-readable error message */
+    message: string;
+    /** Suggestion for how to fix the issue */
+    suggestion?: string;
+}
+/**
+ * Result of validating a single resource
+ */
+export interface ValidationResult {
+    /** Path to the resource */
+    path: string;
+    /** Resource name (if available) */
+    name?: string;
+    /** Whether the resource is valid (no errors, warnings are ok) */
+    valid: boolean;
+    /** All issues found */
+    issues: ValidationIssue[];
+}
+/**
+ * Summary of validation across multiple resources
+ */
+export interface ValidationSummary {
+    workflows: {
+        total: number;
+        valid: number;
+        results: ValidationResult[];
+    };
+    personas: {
+        total: number;
+        valid: number;
+        results: ValidationResult[];
+    };
+    /** Overall validity (all resources valid) */
+    valid: boolean;
+}
+/**
+ * Helper to create an error issue
+ */
+export declare function createError(type: ValidationErrorType, path: string, message: string, suggestion?: string): ValidationIssue;
+/**
+ * Helper to create a warning issue
+ */
+export declare function createWarning(type: ValidationWarningType, path: string, message: string, suggestion?: string): ValidationIssue;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/validation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,cAAc,GACd,eAAe,GACf,qBAAqB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,mBAAmB,GAAG,qBAAqB,CAAC;IAClD,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,KAAK,EAAE,OAAO,CAAC;IACf,uBAAuB;IACvB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;KAC7B,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;KAC7B,CAAC;IACF,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CAQjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CAQjB"}

package/dist/lib/validation/types.js

@@ -0,0 +1,25 @@
+/**
+ * Helper to create an error issue
+ */
+export function createError(type, path, message, suggestion) {
+    return {
+        severity: "error",
+        type,
+        path,
+        message,
+        suggestion,
+    };
+}
+/**
+ * Helper to create a warning issue
+ */
+export function createWarning(type, path, message, suggestion) {
+    return {
+        severity: "warning",
+        type,
+        path,
+        message,
+        suggestion,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/lib/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/validation/types.ts"],"names":[],"mappings":"AAiEA;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,IAAyB,EACzB,IAAY,EACZ,OAAe,EACf,UAAmB;IAEnB,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,IAAI;QACJ,IAAI;QACJ,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA2B,EAC3B,IAAY,EACZ,OAAe,EACf,UAAmB;IAEnB,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,IAAI;QACJ,IAAI;QACJ,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC"}