dot-agents 0.2.0 → 0.3.1

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"}

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

@@ -0,0 +1,10 @@
+import { ValidationResult } from "./types.js";
+/**
+ * Validate a workflow file
+ */
+export declare function validateWorkflow(workflowPath: string): Promise<ValidationResult>;
+/**
+ * Get the persona referenced by a workflow (for cross-validation)
+ */
+export declare function getWorkflowPersonaRef(workflowPath: string): Promise<string | null>;
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/workflow.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAgMpB;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAyM3B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB"}

package/dist/lib/validation/workflow.js

@@ -0,0 +1,242 @@
+import { readFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { createError, createWarning, } from "./types.js";
+import { validateCron, suggestCronFromHint } from "./cron.js";
+const WORKFLOW_FILENAME = "WORKFLOW.md";
+/**
+ * Known workflow frontmatter fields
+ */
+const KNOWN_FIELDS = new Set([
+    "name",
+    "description",
+    "persona",
+    "on",
+    "inputs",
+    "outputs",
+    "env",
+    "timeout",
+    "retry",
+    "working_dir",
+]);
+/**
+ * Common legacy/misnamed fields and their correct names
+ */
+const FIELD_SUGGESTIONS = {
+    goal: "description",
+    skills_used: "persona (skills belong in the persona definition)",
+    skills: "persona (skills belong in the persona definition)",
+    schedule: "on.schedule",
+    trigger: "on",
+    triggers: "on",
+    command: "persona (command belongs in the persona definition)",
+    cmd: "persona (command belongs in the persona definition)",
+};
+/**
+ * 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 the 'on' trigger configuration
+ */
+function validateTriggers(on, issues) {
+    if (on === undefined || on === null) {
+        return; // 'on' is optional
+    }
+    if (typeof on !== "object" || Array.isArray(on)) {
+        issues.push(createError("invalid_type", "on", "'on' must be an object with trigger configurations", "Example: on: { manual: true, schedule: [{cron: '0 9 * * *'}] }"));
+        return;
+    }
+    const triggers = on;
+    // Validate schedule
+    if (triggers.schedule !== undefined) {
+        if (typeof triggers.schedule === "string") {
+            // Common mistake: using a string instead of array
+            const hint = suggestCronFromHint(triggers.schedule);
+            issues.push(createError("invalid_type", "on.schedule", "'schedule' must be an array of {cron: string} objects, got string", hint
+                ? `Use: schedule: [{ cron: "${hint}" }]`
+                : "Use: schedule: [{ cron: \"0 9 * * *\" }]"));
+        }
+        else if (!Array.isArray(triggers.schedule)) {
+            issues.push(createError("invalid_type", "on.schedule", "'schedule' must be an array", "Use: schedule: [{ cron: \"0 9 * * *\" }]"));
+        }
+        else {
+            // Validate each schedule entry
+            triggers.schedule.forEach((entry, index) => {
+                if (typeof entry !== "object" || entry === null) {
+                    issues.push(createError("invalid_type", `on.schedule[${index}]`, "Schedule entry must be an object with 'cron' field", "Use: { cron: \"0 9 * * *\" }"));
+                    return;
+                }
+                const scheduleEntry = entry;
+                if (typeof scheduleEntry.cron !== "string") {
+                    issues.push(createError("missing_field", `on.schedule[${index}].cron`, "Schedule entry missing required 'cron' field", "Add: cron: \"0 9 * * *\""));
+                    return;
+                }
+                // Validate cron expression
+                const cronResult = validateCron(scheduleEntry.cron);
+                if (!cronResult.valid) {
+                    issues.push(createError("invalid_value", `on.schedule[${index}].cron`, `Invalid cron expression: ${cronResult.error}`, "Format: minute hour day-of-month month day-of-week (e.g., \"30 9 * * 1-5\")"));
+                }
+            });
+        }
+    }
+    // Validate manual trigger
+    if (triggers.manual !== undefined) {
+        if (typeof triggers.manual !== "boolean" &&
+            typeof triggers.manual !== "object") {
+            issues.push(createError("invalid_type", "on.manual", "'manual' must be true/false or an object with input overrides", "Use: manual: true"));
+        }
+    }
+    // Check for unknown trigger types
+    const knownTriggers = new Set([
+        "schedule",
+        "manual",
+        "file_change",
+        "webhook",
+        "workflow_complete",
+        "git",
+        "github",
+    ]);
+    for (const key of Object.keys(triggers)) {
+        if (!knownTriggers.has(key)) {
+            issues.push(createWarning("unknown_field", `on.${key}`, `Unknown trigger type '${key}'`, `Known triggers: ${Array.from(knownTriggers).join(", ")}`));
+        }
+    }
+}
+/**
+ * Validate a workflow file
+ */
+export async function validateWorkflow(workflowPath) {
+    const filePath = workflowPath.endsWith(WORKFLOW_FILENAME)
+        ? workflowPath
+        : join(workflowPath, WORKFLOW_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, body } = parsed;
+        name = frontmatter.name;
+        // Check required fields
+        if (!frontmatter.name) {
+            issues.push(createError("missing_field", "name", "Missing required 'name' field", "Add: name: my-workflow"));
+        }
+        else if (typeof frontmatter.name !== "string") {
+            issues.push(createError("invalid_type", "name", "'name' must be a string"));
+        }
+        if (!frontmatter.description) {
+            // Check if they used 'goal' instead
+            if (frontmatter.goal) {
+                issues.push(createError("missing_field", "description", "Missing required 'description' field", "Rename 'goal' to 'description'"));
+            }
+            else {
+                issues.push(createError("missing_field", "description", "Missing required 'description' field", "Add: description: What this workflow does"));
+            }
+        }
+        else if (typeof frontmatter.description !== "string") {
+            issues.push(createError("invalid_type", "description", "'description' must be a string"));
+        }
+        if (!frontmatter.persona) {
+            issues.push(createError("missing_field", "persona", "Missing required 'persona' field", "Add: persona: claude"));
+        }
+        else if (typeof frontmatter.persona !== "string") {
+            issues.push(createError("invalid_type", "persona", "'persona' must be a string"));
+        }
+        // Check for task body
+        if (!body) {
+            issues.push(createError("missing_field", "body", "Missing task body after frontmatter", "Add the task/prompt content after the --- delimiter"));
+        }
+        // Validate triggers
+        validateTriggers(frontmatter.on, issues);
+        // 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}'`));
+                }
+            }
+        }
+        // Validate inputs if present
+        if (frontmatter.inputs !== undefined) {
+            if (!Array.isArray(frontmatter.inputs)) {
+                issues.push(createError("invalid_type", "inputs", "'inputs' must be an array", "Use: inputs: [{ name: 'myInput', type: 'string' }]"));
+            }
+            else {
+                frontmatter.inputs.forEach((input, index) => {
+                    if (typeof input !== "object" || input === null) {
+                        issues.push(createError("invalid_type", `inputs[${index}]`, "Input definition must be an object"));
+                        return;
+                    }
+                    const inputDef = input;
+                    if (!inputDef.name || typeof inputDef.name !== "string") {
+                        issues.push(createError("missing_field", `inputs[${index}].name`, "Input definition missing required 'name' field"));
+                    }
+                });
+            }
+        }
+        // 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: { KEY: 'value' }"));
+            }
+        }
+    }
+    catch (error) {
+        issues.push(createError("invalid_value", "file", `Failed to read workflow: ${error.message}`));
+    }
+    const hasErrors = issues.some((i) => i.severity === "error");
+    return {
+        path: dirname(filePath),
+        name,
+        valid: !hasErrors,
+        issues,
+    };
+}
+/**
+ * Get the persona referenced by a workflow (for cross-validation)
+ */
+export async function getWorkflowPersonaRef(workflowPath) {
+    const filePath = workflowPath.endsWith(WORKFLOW_FILENAME)
+        ? workflowPath
+        : join(workflowPath, WORKFLOW_FILENAME);
+    try {
+        const content = await readFile(filePath, "utf-8");
+        const parsed = parseFrontmatter(content);
+        if (parsed && typeof parsed.frontmatter.persona === "string") {
+            return parsed.frontmatter.persona;
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return null;
+}
+//# sourceMappingURL=workflow.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dot-agents",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "A framework for building agentic workflows with personas and scheduled execution",
   "type": "module",
   "main": "./dist/lib/index.js",