yet-another-agentic-workflow 0.2.0

package/dist/review.js

@@ -0,0 +1,66 @@
+export class ReviewError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ReviewError";
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Validate one axis-scoped report without consulting the other reviewer. */
+export function createReviewRecord(axis, value, recordedAt = new Date().toISOString()) {
+    if (!isRecord(value))
+        throw new ReviewError(`${axis} review must be a JSON object`);
+    if (value.axis !== undefined && value.axis !== axis) {
+        throw new ReviewError(`${axis} reviewer cannot submit a '${String(value.axis)}' axis report`);
+    }
+    if (value.verdict !== "PASS" && value.verdict !== "FAIL") {
+        throw new ReviewError(`${axis} review verdict must be PASS or FAIL`);
+    }
+    if (typeof value.summary !== "string" || !value.summary.trim()) {
+        throw new ReviewError(`${axis} review summary must be a non-empty string`);
+    }
+    if (!Array.isArray(value.findings)) {
+        throw new ReviewError(`${axis} review findings must be an array`);
+    }
+    const findings = value.findings.map((finding, index) => {
+        if (!isRecord(finding))
+            throw new ReviewError(`${axis} review finding ${index + 1} must be an object`);
+        for (const field of ["code", "message", "evidence"]) {
+            if (typeof finding[field] !== "string" || !finding[field].trim()) {
+                throw new ReviewError(`${axis} review finding ${index + 1}.${field} must be a non-empty string`);
+            }
+        }
+        return { code: finding.code, message: finding.message, evidence: finding.evidence };
+    });
+    if (value.verdict === "PASS" && findings.length > 0) {
+        throw new ReviewError(`${axis} review cannot PASS with findings`);
+    }
+    if (value.verdict === "FAIL" && findings.length === 0) {
+        throw new ReviewError(`${axis} review cannot FAIL without a finding`);
+    }
+    return {
+        axis,
+        reviewer: axis === "spec" ? "spec-reviewer" : "standards-reviewer",
+        verdict: value.verdict,
+        summary: value.summary.trim(),
+        findings,
+        recordedAt
+    };
+}
+/** Enforce the join gate and preserve axis-specific failure reasons. */
+export function assertIndependentReviewGate(reviews) {
+    if (!reviews.spec)
+        throw new ReviewError("completion blocked: spec review is missing");
+    if (!reviews.standards)
+        throw new ReviewError("completion blocked: standards review is missing");
+    if (reviews.spec.verdict === "FAIL") {
+        const codes = reviews.spec.findings.map(({ code }) => code).join(", ");
+        throw new ReviewError(`completion blocked: spec review failed (${codes})`);
+    }
+    if (reviews.standards.verdict === "FAIL") {
+        const codes = reviews.standards.findings.map(({ code }) => code).join(", ");
+        throw new ReviewError(`completion blocked: standards review failed (${codes})`);
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/review.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+import type { ValidationIssue } from "./types.js";
+export declare function validateAgainstSchema(value: unknown): ValidationIssue[];

package/dist/schema.js

@@ -0,0 +1,44 @@
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { Ajv2020 } from "ajv/dist/2020.js";
+const schemaDirectory = fileURLToPath(new URL("../schemas/", import.meta.url));
+const require = createRequire(import.meta.url);
+const addFormats = require("ajv-formats");
+const schemaFiles = [
+    "skill.schema.json",
+    "agent.schema.json",
+    "hook.schema.json",
+    "eval.schema.json",
+    "workflow.schema.json",
+    "context.schema.json",
+    "state.schema.json",
+    "yaaw.schema.json"
+];
+function readSchema(fileName) {
+    return JSON.parse(readFileSync(`${schemaDirectory}${fileName}`, "utf8"));
+}
+const ajv = new Ajv2020({ allErrors: true, strict: true });
+addFormats(ajv);
+for (const fileName of schemaFiles) {
+    ajv.addSchema(readSchema(fileName));
+}
+const registeredSchema = ajv.getSchema("https://yaaw.dev/schemas/yaaw.schema.json");
+if (!registeredSchema) {
+    throw new Error("The root YAAW schema was not registered.");
+}
+const validateSchema = registeredSchema;
+function schemaPath(error) {
+    return error.instancePath === "" ? "$" : `$${error.instancePath}`;
+}
+export function validateAgainstSchema(value) {
+    if (validateSchema(value)) {
+        return [];
+    }
+    return (validateSchema.errors ?? []).map((error) => ({
+        path: schemaPath(error),
+        message: error.message ?? "failed schema validation",
+        keyword: "schema"
+    }));
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAoB,MAAM,kBAAkB,CAAC;AAK7D,MAAM,eAAe,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAkB,CAAC;AAE3D,MAAM,WAAW,GAAG;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,sBAAsB;IACtB,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;CACV,CAAC;AAEX,SAAS,UAAU,CAAC,QAAsC;IACxD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,eAAe,GAAG,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAW,CAAC;AACrF,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,UAAU,CAAC,GAAG,CAAC,CAAC;AAEhB,KAAK,MAAM,QAAQ,IAAI,WAAW,EAAE,CAAC;IACnC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,gBAAgB,GAAG,GAAG,CAAC,SAAS,CACpC,2CAA2C,CAC5C,CAAC;AAEF,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAExC,SAAS,UAAU,CAAC,KAAkB;IACpC,OAAO,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,cAAc,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAkB,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC;QACvB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B;QACpD,OAAO,EAAE,QAAQ;KAClB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,24 @@
+export interface SkillSummary {
+    name: string;
+    purpose: string;
+    description?: string;
+    dependencies: string[];
+    path: string;
+}
+export interface LoadedSkill extends SkillSummary {
+    instructions: string;
+}
+export interface SkillInvocation {
+    requested: string;
+    order: string[];
+    skills: LoadedSkill[];
+    prompt: string;
+}
+export declare class SkillSystemError extends Error {
+    constructor(message: string);
+}
+/** Discover skill metadata without retaining or returning instruction bodies. */
+export declare function discoverSkills(projectDirectory?: string): Promise<SkillSummary[]>;
+/** Load one skill and its dependencies in dependency-first order. */
+export declare function invokeSkill(name: string, projectDirectory?: string): Promise<SkillInvocation>;
+export declare function displaySkillPath(summary: SkillSummary, projectDirectory?: string): string;

package/dist/skills.js

@@ -0,0 +1,210 @@
+import { createReadStream } from "node:fs";
+import { readdir, readFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { createInterface } from "node:readline";
+import { parse as parseYaml } from "yaml";
+const SKILL_NAME = /^[a-z][a-z0-9-]*$/;
+export class SkillSystemError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SkillSystemError";
+    }
+}
+function parseMetadata(source, path) {
+    let value;
+    try {
+        value = parseYaml(source);
+    }
+    catch (error) {
+        throw new SkillSystemError(`${path}: invalid YAML frontmatter: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new SkillSystemError(`${path}: skill frontmatter must be an object`);
+    }
+    const metadata = value;
+    const allowed = new Set(["name", "purpose", "description", "dependencies"]);
+    const extra = Object.keys(metadata).find((key) => !allowed.has(key));
+    if (extra)
+        throw new SkillSystemError(`${path}: unknown skill metadata field '${extra}'`);
+    if (typeof metadata.name !== "string" || !SKILL_NAME.test(metadata.name)) {
+        throw new SkillSystemError(`${path}: skill name must match ${SKILL_NAME.source}`);
+    }
+    if (typeof metadata.purpose !== "string" || metadata.purpose.trim().length === 0) {
+        throw new SkillSystemError(`${path}: skill purpose must be a non-empty string`);
+    }
+    if (metadata.description !== undefined &&
+        (typeof metadata.description !== "string" || metadata.description.trim().length === 0)) {
+        throw new SkillSystemError(`${path}: skill description must be a non-empty string`);
+    }
+    const rawDependencies = metadata.dependencies ?? [];
+    if (!Array.isArray(rawDependencies) ||
+        rawDependencies.some((dependency) => typeof dependency !== "string" || !SKILL_NAME.test(dependency))) {
+        throw new SkillSystemError(`${path}: skill dependencies must be unique valid skill names`);
+    }
+    const dependencies = rawDependencies;
+    if (new Set(dependencies).size !== dependencies.length) {
+        throw new SkillSystemError(`${path}: skill dependencies must be unique valid skill names`);
+    }
+    const result = {
+        name: metadata.name,
+        purpose: metadata.purpose.trim(),
+        dependencies
+    };
+    if (typeof metadata.description === "string")
+        result.description = metadata.description.trim();
+    return result;
+}
+async function readMetadataOnly(path) {
+    const stream = createReadStream(path, { encoding: "utf8" });
+    const lines = createInterface({ input: stream, crlfDelay: Infinity });
+    const frontmatter = [];
+    let lineNumber = 0;
+    let closed = false;
+    try {
+        for await (const line of lines) {
+            lineNumber += 1;
+            if (lineNumber === 1) {
+                if (line !== "---")
+                    throw new SkillSystemError(`${path}: SKILL.md must start with ---`);
+                continue;
+            }
+            if (line === "---") {
+                closed = true;
+                break;
+            }
+            frontmatter.push(line);
+            if (lineNumber > 200) {
+                throw new SkillSystemError(`${path}: skill frontmatter exceeds 200 lines`);
+            }
+        }
+    }
+    finally {
+        lines.close();
+        stream.destroy();
+    }
+    if (!closed)
+        throw new SkillSystemError(`${path}: skill frontmatter is not closed with ---`);
+    return parseMetadata(frontmatter.join("\n"), path);
+}
+function splitSkillDocument(source, path) {
+    const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        throw new SkillSystemError(`${path}: invalid or unclosed skill frontmatter`);
+    const metadata = parseMetadata(match[1] ?? "", path);
+    const body = (match[2] ?? "").trim();
+    if (!body)
+        throw new SkillSystemError(`${path}: skill instructions must not be empty`);
+    return { metadata, body };
+}
+async function skillDocumentPaths(directory) {
+    let entries;
+    try {
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const paths = [];
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            paths.push(join(directory, entry.name, "SKILL.md"));
+        }
+        else if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+            paths.push(join(directory, entry.name));
+        }
+    }
+    return paths.sort((left, right) => left.localeCompare(right));
+}
+/** Discover skill metadata without retaining or returning instruction bodies. */
+export async function discoverSkills(projectDirectory = ".") {
+    const directory = join(resolve(projectDirectory), ".yaaw", "skills");
+    const summaries = [];
+    const names = new Map();
+    for (const path of await skillDocumentPaths(directory)) {
+        let metadata;
+        try {
+            metadata = await readMetadataOnly(path);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === "ENOENT")
+                continue;
+            throw error;
+        }
+        const existing = names.get(metadata.name);
+        if (existing) {
+            throw new SkillSystemError(`duplicate discovered skill '${metadata.name}' in ${existing} and ${path}`);
+        }
+        names.set(metadata.name, path);
+        const summary = {
+            name: metadata.name,
+            purpose: metadata.purpose,
+            dependencies: metadata.dependencies,
+            path
+        };
+        if (metadata.description)
+            summary.description = metadata.description;
+        summaries.push(summary);
+    }
+    return summaries.sort((left, right) => left.name.localeCompare(right.name));
+}
+async function loadDiscoveredSkill(summary) {
+    const source = await readFile(summary.path, "utf8");
+    const { metadata, body } = splitSkillDocument(source, summary.path);
+    if (metadata.name !== summary.name) {
+        throw new SkillSystemError(`${summary.path}: skill metadata changed during loading`);
+    }
+    const loaded = { ...summary, instructions: body };
+    return loaded;
+}
+/** Load one skill and its dependencies in dependency-first order. */
+export async function invokeSkill(name, projectDirectory = ".") {
+    const summaries = await discoverSkills(projectDirectory);
+    const catalog = new Map(summaries.map((summary) => [summary.name, summary]));
+    if (!catalog.has(name)) {
+        const available = summaries.map((summary) => summary.name).join(", ") || "none";
+        throw new SkillSystemError(`unknown skill '${name}' (available: ${available})`);
+    }
+    const order = [];
+    const visiting = [];
+    const visited = new Set();
+    const visit = (skillName) => {
+        if (visited.has(skillName))
+            return;
+        const cycleIndex = visiting.indexOf(skillName);
+        if (cycleIndex >= 0) {
+            const cycle = [...visiting.slice(cycleIndex), skillName].join(" -> ");
+            throw new SkillSystemError(`cyclic skill dependency: ${cycle}`);
+        }
+        const summary = catalog.get(skillName);
+        if (!summary) {
+            const owner = visiting.at(-1) ?? name;
+            throw new SkillSystemError(`skill '${owner}' depends on unknown skill '${skillName}'`);
+        }
+        visiting.push(skillName);
+        for (const dependency of summary.dependencies)
+            visit(dependency);
+        visiting.pop();
+        visited.add(skillName);
+        order.push(summary);
+    };
+    visit(name);
+    const skills = [];
+    for (const summary of order)
+        skills.push(await loadDiscoveredSkill(summary));
+    const prompt = [
+        `# Skill invocation: ${name}`,
+        "",
+        "Apply these skills in dependency order.",
+        ...skills.flatMap((skill) => ["", `## Skill: ${skill.name}`, "", skill.instructions])
+    ].join("\n");
+    return { requested: name, order: skills.map((skill) => skill.name), skills, prompt };
+}
+export function displaySkillPath(summary, projectDirectory = ".") {
+    const root = resolve(projectDirectory);
+    return summary.path.startsWith(root) ? summary.path.slice(root.length + 1).replaceAll("\\", "/") : basename(summary.path);
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAqBvC,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AASD,SAAS,aAAa,CAAC,MAAc,EAAE,IAAY;IACjD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CACxB,GAAG,IAAI,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/F,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,QAAQ,GAAG,KAAgC,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,IAAI,KAAK;QAAE,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,mCAAmC,KAAK,GAAG,CAAC,CAAC;IAC1F,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,2BAA2B,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,4CAA4C,CAAC,CAAC;IAClF,CAAC;IACD,IACE,QAAQ,CAAC,WAAW,KAAK,SAAS;QAClC,CAAC,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EACtF,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,gDAAgD,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,eAAe,GAAG,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC;IACpD,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;QAC/B,eAAe,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EACpG,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,uDAAuD,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,YAAY,GAAG,eAA2B,CAAC;IACjD,IAAI,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,MAAM,EAAE,CAAC;QACvD,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,uDAAuD,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,MAAM,GAAkB;QAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;QAChC,YAAY;KACb,CAAC;IACF,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ;QAAE,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAC/F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC/B,UAAU,IAAI,CAAC,CAAC;YAChB,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,IAAI,IAAI,KAAK,KAAK;oBAAE,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,gCAAgC,CAAC,CAAC;gBACxF,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM;YACR,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;gBACrB,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,4CAA4C,CAAC,CAAC;IAC7F,OAAO,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc,EAAE,IAAY;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC1E,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,yCAAyC,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,wCAAwC,CAAC,CAAC;IACvF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,SAAiB;IACjD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,gBAAgB,GAAG,GAAG;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrE,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,MAAM,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;QACvD,IAAI,QAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;YACnD,IAAI,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAChC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,gBAAgB,CACxB,+BAA+B,QAAQ,CAAC,IAAI,QAAQ,QAAQ,QAAQ,IAAI,EAAE,CAC3E,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAiB;YAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,IAAI;SACL,CAAC;QACF,IAAI,QAAQ,CAAC,WAAW;YAAE,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;QACrE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,OAAqB;IACtD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,yCAAyC,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,MAAM,GAAgB,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC/D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,gBAAgB,GAAG,GAAG;IAEtB,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;QAChF,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,IAAI,iBAAiB,SAAS,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAQ,EAAE;QACxC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO;QACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtE,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YACtC,MAAM,IAAI,gBAAgB,CAAC,UAAU,KAAK,+BAA+B,SAAS,GAAG,CAAC,CAAC;QACzF,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,YAAY;YAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACjE,QAAQ,CAAC,GAAG,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG;QACb,uBAAuB,IAAI,EAAE;QAC7B,EAAE;QACF,yCAAyC;QACzC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,aAAa,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;KACtF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAqB,EAAE,gBAAgB,GAAG,GAAG;IAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC5H,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+export type PrimitiveKind = "skill" | "agent" | "hook" | "eval" | "workflow" | "context" | "state";
+export interface SkillDefinition {
+    name: string;
+    purpose: string;
+    steps: string[];
+    description?: string;
+    dependencies?: string[];
+}
+export interface AgentPermissions {
+    filesystem: "none" | "read" | "read-write";
+    shell: "none" | "read-only" | "execute";
+    network?: boolean;
+}
+export interface AgentDefinition {
+    name: string;
+    objective: string;
+    permissions: AgentPermissions;
+    context?: string[];
+    skills?: string[];
+    tools?: string[];
+}
+export type HookEvent = "after_edit" | "before_verify" | "after_verify_failure" | "before_complete";
+export interface HookDefinition {
+    name: string;
+    event: HookEvent;
+    run: string[];
+    match?: string[];
+}
+export interface EvalDefinition {
+    name: string;
+    run: string[];
+    success: {
+        exit_code: number;
+        stdout_contains?: string;
+        stderr_excludes?: string;
+    };
+}
+export interface WorkflowStepDefinition {
+    id: string;
+    uses: `${PrimitiveKind}:${string}`;
+    needs?: string[];
+    with?: Record<string, unknown>;
+}
+export interface WorkflowDefinition {
+    name: string;
+    description?: string;
+    steps: WorkflowStepDefinition[];
+}
+export interface ContextDefinition {
+    name: string;
+    path: string;
+    description?: string;
+}
+export interface StateDefinition {
+    name: string;
+    path: string;
+    description?: string;
+    durable?: boolean;
+}
+export interface ProjectDefinition {
+    version: 1;
+    project: {
+        name: string;
+        description?: string;
+    };
+    skills: SkillDefinition[];
+    agents: AgentDefinition[];
+    hooks: HookDefinition[];
+    evals: EvalDefinition[];
+    workflows: WorkflowDefinition[];
+    context: ContextDefinition[];
+    state: StateDefinition[];
+}
+export interface ValidationIssue {
+    path: string;
+    message: string;
+    keyword: "parse" | "schema" | "semantic";
+}
+export type ValidationResult = {
+    ok: true;
+    value: ProjectDefinition;
+    issues: [];
+} | {
+    ok: false;
+    issues: ValidationIssue[];
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "yet-another-agentic-workflow",
+  "version": "0.2.0",
+  "description": "Better engineering defaults for Claude Code, Codex, and other coding agents.",
+  "type": "module",
+  "bin": {
+    "yaaw": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "templates",
+    "schemas"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm test && npm run test:package",
+    "test:package": "node --test tests/package.test.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test tests",
+    "validate:example": "npm run build && node dist/cli.js validate .yaaw/yaaw.yaml"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/QuackyPROG/yet-another-agentic-workflow.git"
+  },
+  "bugs": {
+    "url": "https://github.com/QuackyPROG/yet-another-agentic-workflow/issues"
+  },
+  "homepage": "https://github.com/QuackyPROG/yet-another-agentic-workflow#readme",
+  "license": "MIT",
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "typescript": "^5.9.3"
+  }
+}

package/schemas/agent.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yaaw.dev/schemas/agent.schema.json",
+  "title": "YAAW agent",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "objective", "permissions"],
+  "properties": {
+    "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "objective": { "type": "string", "minLength": 1 },
+    "permissions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["filesystem", "shell"],
+      "properties": {
+        "filesystem": { "enum": ["none", "read", "read-write"] },
+        "shell": { "enum": ["none", "read-only", "execute"] },
+        "network": { "type": "boolean" }
+      }
+    },
+    "context": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" }
+    },
+    "skills": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" }
+    },
+    "tools": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/schemas/context.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yaaw.dev/schemas/context.schema.json",
+  "title": "YAAW context",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "path"],
+  "properties": {
+    "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "path": { "type": "string", "minLength": 1 },
+    "description": { "type": "string", "minLength": 1 }
+  }
+}

package/schemas/eval.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yaaw.dev/schemas/eval.schema.json",
+  "title": "YAAW eval",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "run", "success"],
+  "properties": {
+    "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "run": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "success": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["exit_code"],
+      "properties": {
+        "exit_code": { "type": "integer", "minimum": 0, "maximum": 255 },
+        "stdout_contains": { "type": "string" },
+        "stderr_excludes": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/hook.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yaaw.dev/schemas/hook.schema.json",
+  "title": "YAAW hook",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "event", "run"],
+  "properties": {
+    "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "event": {
+      "enum": [
+        "after_edit",
+        "before_verify",
+        "after_verify_failure",
+        "before_complete"
+      ]
+    },
+    "match": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "run": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/schemas/skill.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yaaw.dev/schemas/skill.schema.json",
+  "title": "YAAW skill",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "purpose", "steps"],
+  "properties": {
+    "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "purpose": { "type": "string", "minLength": 1 },
+    "description": { "type": "string", "minLength": 1 },
+    "steps": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "dependencies": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" }
+    }
+  }
+}