yet-another-agentic-workflow 0.2.0

package/dist/init.js

@@ -0,0 +1,255 @@
+import { access, mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import { stringify } from "yaml";
+import { createOfficialFeaturePrimitives } from "./feature.js";
+export class InitConflictError extends Error {
+    constructor(path) {
+        super(`${path} already exists; rerun with --force to replace generated files`);
+        this.name = "InitConflictError";
+    }
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function canonicalName(value) {
+    const normalized = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (!normalized)
+        return "project";
+    return /^[a-z]/.test(normalized) ? normalized : `project-${normalized}`;
+}
+async function readPackageJson(root) {
+    const packagePath = join(root, "package.json");
+    if (!(await exists(packagePath)))
+        return undefined;
+    try {
+        return JSON.parse(await readFile(packagePath, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function detectPackageManager(root, packageJson) {
+    if (typeof packageJson?.packageManager === "string") {
+        return packageJson.packageManager.split("@")[0];
+    }
+    const lockfiles = [
+        ["pnpm-lock.yaml", "pnpm"],
+        ["yarn.lock", "yarn"],
+        ["bun.lock", "bun"],
+        ["bun.lockb", "bun"],
+        ["package-lock.json", "npm"]
+    ];
+    for (const [file, manager] of lockfiles) {
+        if (await exists(join(root, file)))
+            return manager;
+    }
+    return packageJson ? "npm" : undefined;
+}
+function scriptCommand(manager, script) {
+    if (manager === "yarn")
+        return `yarn ${script}`;
+    if (manager === "pnpm")
+        return `pnpm ${script}`;
+    if (manager === "bun")
+        return `bun run ${script}`;
+    return script === "test" ? "npm test" : `npm run ${script}`;
+}
+function detectNodeCommands(packageJson, manager) {
+    if (!packageJson || !manager)
+        return {};
+    const rawScripts = packageJson.scripts;
+    if (!rawScripts || typeof rawScripts !== "object" || Array.isArray(rawScripts))
+        return {};
+    const scripts = rawScripts;
+    const candidates = {
+        test: ["test"],
+        lint: ["lint"],
+        typecheck: ["typecheck", "type-check"],
+        build: ["build"]
+    };
+    const commands = {};
+    for (const kind of Object.keys(candidates)) {
+        const script = candidates[kind].find((candidate) => typeof scripts[candidate] === "string");
+        if (script)
+            commands[kind] = scriptCommand(manager, script);
+    }
+    return commands;
+}
+async function detectLanguages(root) {
+    const markers = [
+        [["tsconfig.json"], "TypeScript"],
+        [["package.json"], "JavaScript"],
+        [["pyproject.toml", "requirements.txt", "setup.py"], "Python"],
+        [["Cargo.toml"], "Rust"],
+        [["go.mod"], "Go"],
+        [["pom.xml", "build.gradle", "build.gradle.kts"], "Java"],
+        [["Gemfile"], "Ruby"]
+    ];
+    const languages = [];
+    for (const [files, language] of markers) {
+        if ((await Promise.all(files.map((file) => exists(join(root, file))))).some(Boolean)) {
+            languages.push(language);
+        }
+    }
+    return languages;
+}
+async function detectConventionalCommands(root, languages) {
+    if (languages.includes("Rust")) {
+        return { test: "cargo test", lint: "cargo clippy --all-targets", build: "cargo build" };
+    }
+    if (languages.includes("Go")) {
+        return { test: "go test ./...", lint: "go vet ./...", build: "go build ./..." };
+    }
+    if (languages.includes("Python")) {
+        const commands = { test: "python -m pytest" };
+        if (await exists(join(root, "ruff.toml")))
+            commands.lint = "python -m ruff check .";
+        if (await exists(join(root, "mypy.ini")))
+            commands.typecheck = "python -m mypy .";
+        return commands;
+    }
+    return {};
+}
+async function detectAiInstructions(root) {
+    const candidates = [
+        "AGENTS.md",
+        "CLAUDE.md",
+        "GEMINI.md",
+        ".github/copilot-instructions.md",
+        ".cursor/rules"
+    ];
+    const found = [];
+    for (const candidate of candidates) {
+        const path = join(root, candidate);
+        if (!(await exists(path)))
+            continue;
+        const info = await stat(path);
+        if (info.isFile())
+            found.push(candidate.replaceAll("\\", "/"));
+    }
+    return found;
+}
+async function isInsideGitRepository(root) {
+    let current = root;
+    while (true) {
+        if (await exists(join(current, ".git")))
+            return true;
+        const parent = dirname(current);
+        if (parent === current)
+            return false;
+        current = parent;
+    }
+}
+export async function discoverRepository(directory = ".") {
+    const root = resolve(directory);
+    const info = await stat(root);
+    if (!info.isDirectory())
+        throw new Error(`${directory} is not a directory`);
+    const packageJson = await readPackageJson(root);
+    const packageManager = await detectPackageManager(root, packageJson);
+    const languages = await detectLanguages(root);
+    const nodeCommands = detectNodeCommands(packageJson, packageManager);
+    const conventionalCommands = await detectConventionalCommands(root, languages);
+    const packageName = typeof packageJson?.name === "string" ? packageJson.name : basename(root);
+    const discovery = {
+        root,
+        projectName: canonicalName(packageName),
+        languages,
+        commands: { ...conventionalCommands, ...nodeCommands },
+        git: await isInsideGitRepository(root),
+        aiInstructions: await detectAiInstructions(root)
+    };
+    if (packageManager)
+        discovery.packageManager = packageManager;
+    return discovery;
+}
+function uniqueContext(discovery) {
+    const used = new Set();
+    return discovery.aiInstructions.map((path) => {
+        const base = canonicalName(`ai-instructions-${path.replace(/\.[^.]+$/, "")}`);
+        let name = base;
+        let index = 2;
+        while (used.has(name))
+            name = `${base}-${index++}`;
+        used.add(name);
+        return { name, path, description: "Existing repository instructions for coding agents." };
+    });
+}
+function projectDefinition(discovery) {
+    const evals = Object.entries(discovery.commands).map(([name, command]) => ({
+        name,
+        run: [command],
+        success: { exit_code: 0 }
+    }));
+    const verificationCommands = Object.values(discovery.commands);
+    const context = uniqueContext(discovery);
+    const feature = createOfficialFeaturePrimitives(verificationCommands, context);
+    return {
+        version: 1,
+        project: {
+            name: discovery.projectName,
+            description: discovery.languages.length
+                ? `Initialized from a ${discovery.languages.join("/")} repository.`
+                : "Initialized from an existing repository."
+        },
+        skills: feature.skills,
+        agents: feature.agents,
+        hooks: [feature.hook],
+        evals: [...evals, feature.evaluation],
+        workflows: [feature.workflow],
+        context,
+        state: [
+            {
+                name: "workflow",
+                path: ".yaaw/state/workflow.json",
+                description: "Durable workflow progress and verification status.",
+                durable: true
+            }
+        ]
+    };
+}
+export async function initializeRepository(directory = ".", options = {}) {
+    const discovery = await discoverRepository(directory);
+    const yaawDirectory = join(discovery.root, ".yaaw");
+    const configPath = join(yaawDirectory, "yaaw.yaml");
+    const discoveryPath = join(yaawDirectory, "discovery.json");
+    const statePath = join(yaawDirectory, "state", "workflow.json");
+    const feature = createOfficialFeaturePrimitives(Object.values(discovery.commands), uniqueContext(discovery));
+    const skillPaths = Object.keys(feature.skillDocuments).map((name) => join(yaawDirectory, "skills", name, "SKILL.md"));
+    if (!options.force) {
+        for (const generatedPath of [configPath, discoveryPath]) {
+            if (await exists(generatedPath))
+                throw new InitConflictError(generatedPath);
+        }
+    }
+    await mkdir(join(yaawDirectory, "state"), { recursive: true });
+    await mkdir(join(yaawDirectory, "runs"), { recursive: true });
+    for (const skillPath of skillPaths)
+        await mkdir(dirname(skillPath), { recursive: true });
+    const writeOptions = options.force ? undefined : { flag: "wx" };
+    await writeFile(configPath, stringify(projectDefinition(discovery)), writeOptions);
+    await writeFile(discoveryPath, `${JSON.stringify({ ...discovery, root: "." }, null, 2)}\n`, "utf8");
+    if (!(await exists(statePath)) || options.force) {
+        await writeFile(statePath, `${JSON.stringify({ version: 1, status: "initialized", current: null }, null, 2)}\n`, "utf8");
+    }
+    for (const [name, source] of Object.entries(feature.skillDocuments)) {
+        const skillPath = join(yaawDirectory, "skills", name, "SKILL.md");
+        if (!(await exists(skillPath)) || options.force) {
+            await writeFile(skillPath, source, "utf8");
+        }
+    }
+    return { discovery, configPath, discoveryPath, statePath, skillPaths };
+}
+export function relativeInitPaths(result) {
+    return [result.configPath, result.discoveryPath, result.statePath, ...result.skillPaths].map((path) => relative(result.discovery.root, path).replaceAll("\\", "/"));
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/installer.d.ts

@@ -0,0 +1,64 @@
+import { type RepositoryDiscovery } from "./init.js";
+import { type ProviderDefinition, type ProviderId } from "./providers.js";
+export declare const MANIFEST_SCHEMA_VERSION = 1;
+export declare const MANAGED_BLOCK_START = "<!-- yaaw:start -->";
+export declare const MANAGED_BLOCK_END = "<!-- yaaw:end -->";
+export declare const MANAGED_INSTRUCTION_BLOCK = "<!-- yaaw:start -->\n\n## Yet Another Agentic Workflow\n\nThis repository uses YAAW engineering skills.\n\nUse the installed skills when their procedure matches the task.\n\nFor meaningful implementation work:\n\n- resolve consequential ambiguity before coding;\n- establish observable acceptance criteria;\n- prefer small independently verifiable slices;\n- use feedback loops rather than guessing;\n- verify before declaring work complete.\n\n<!-- yaaw:end -->";
+export interface ManagedFileRecord {
+    hash: string;
+}
+export interface InstallManifest {
+    schemaVersion: number;
+    installedVersion: string;
+    providers: ProviderId[];
+    installedAt: string;
+    updatedAt: string;
+    managedFiles: Record<string, ManagedFileRecord>;
+    managedInstructionBlocks: Record<string, ManagedFileRecord>;
+}
+export type PlanStatus = "added" | "updated" | "unchanged" | "removed" | "conflicted";
+export type PlanKind = "skill" | "instruction";
+export interface InstallOperation {
+    path: string;
+    kind: PlanKind;
+    status: PlanStatus;
+    content?: string;
+    previousHash?: string;
+    desiredHash?: string;
+}
+export interface InstallationPlan {
+    root: string;
+    providers: ProviderId[];
+    discovery: RepositoryDiscovery;
+    previousManifest?: InstallManifest;
+    operations: InstallOperation[];
+}
+export interface InstallOptions {
+    providers: ProviderId[];
+    overwriteModified?: boolean;
+    now?: Date;
+}
+export interface InstallResult {
+    plan: InstallationPlan;
+    manifest: InstallManifest;
+    manifestPath: string;
+}
+export interface DoctorCheck {
+    status: "ok" | "warning" | "error";
+    message: string;
+    path?: string;
+}
+export interface DoctorResult {
+    healthy: boolean;
+    root: string;
+    manifest?: InstallManifest;
+    checks: DoctorCheck[];
+}
+export declare function readInstallManifest(root?: string): Promise<InstallManifest | undefined>;
+export declare function detectLegacyProviders(root?: string): Promise<ProviderId[]>;
+export declare function planInstallation(root: string, options: InstallOptions): Promise<InstallationPlan>;
+export declare function applyInstallation(plan: InstallationPlan, now?: Date): Promise<InstallResult>;
+export declare function installRepository(root: string, options: InstallOptions): Promise<InstallResult>;
+export declare function doctorRepository(root?: string): Promise<DoctorResult>;
+export declare function providerNames(ids: ProviderId[]): string[];
+export declare function providerFromDefinition(definition: ProviderDefinition): ProviderId;