skillpack-one 0.1.0-alpha.10

package/dist/src/harness/pi.d.ts

@@ -0,0 +1,21 @@
+import type { RouteTrace, RoutingExample } from "../types.js";
+import type { HarnessAdapter, HarnessCapabilities, ExecutionOptions, HarnessResult, HealthReport, TaskExample, TaskTrace } from "./types.js";
+interface PiOptions {
+    provider?: string;
+    model?: string;
+}
+export declare class PiHarnessAdapter implements HarnessAdapter {
+    private readonly root;
+    private readonly options;
+    private readonly cliPath;
+    private readonly packagePath;
+    constructor(root: string, options?: PiOptions);
+    private version;
+    discover(): Promise<HarnessCapabilities>;
+    healthcheck(): Promise<HealthReport>;
+    private modelArguments;
+    private invoke;
+    route(example: RoutingExample): Promise<HarnessResult<RouteTrace>>;
+    execute(task: TaskExample, options?: ExecutionOptions): Promise<HarnessResult<TaskTrace>>;
+}
+export {};

package/dist/src/harness/pi.js

@@ -0,0 +1,120 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { runProcess } from "./process.js";
+export class PiHarnessAdapter {
+    root;
+    options;
+    cliPath;
+    packagePath;
+    constructor(root, options = {}) {
+        this.root = root;
+        this.options = options;
+        this.packagePath = path.join(root, "node_modules", "@earendil-works", "pi-coding-agent", "package.json");
+        this.cliPath = path.join(root, "node_modules", "@earendil-works", "pi-coding-agent", "dist", "bundle", "cli.js");
+    }
+    async version() {
+        try {
+            const manifest = JSON.parse(await readFile(this.packagePath, "utf8"));
+            return manifest.version;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async discover() {
+        const version = await this.version();
+        const { loadSkillsFromDir } = await import("@earendil-works/pi-coding-agent");
+        const loaded = loadSkillsFromDir({ dir: path.join(this.root, "skills"), source: "skillpack-one" });
+        if (loaded.diagnostics.some((diagnostic) => diagnostic.type === "error")) {
+            throw new Error(`Pi Skill discovery failed: ${JSON.stringify(loaded.diagnostics)}`);
+        }
+        return {
+            name: "pi",
+            version: version ?? "unavailable",
+            structuredOutput: true,
+            taskExecution: true,
+            discoveredSkills: loaded.skills.length
+        };
+    }
+    async healthcheck() {
+        const version = await this.version();
+        if (!version) {
+            return { name: "pi", installed: false, ready: false, blockers: ["Pinned Pi package is not installed"] };
+        }
+        const provider = this.options.provider ?? "openai-codex";
+        const auth = await runProcess(process.execPath, [this.cliPath, "auth", "check", "--provider", provider, "--json", "--no-refresh"], this.root);
+        let ready = false;
+        try {
+            ready = JSON.parse(auth.stdout).status === "ready";
+        }
+        catch {
+            ready = false;
+        }
+        return {
+            name: "pi",
+            installed: true,
+            ready,
+            version,
+            blockers: ready ? [] : ["Pi provider credentials are not configured"]
+        };
+    }
+    modelArguments() {
+        const args = [];
+        if (this.options.provider)
+            args.push("--provider", this.options.provider);
+        if (this.options.model)
+            args.push("--model", this.options.model);
+        return args;
+    }
+    async invoke(prompt, options = { skills: "enabled" }) {
+        const started = performance.now();
+        const health = await this.healthcheck();
+        if (!health.ready) {
+            return { status: "blocked", reason: health.blockers.join("; "), durationMs: performance.now() - started };
+        }
+        const result = await runProcess(process.execPath, [
+            this.cliPath,
+            ...this.modelArguments(),
+            "--print",
+            "--mode",
+            "text",
+            "--no-session",
+            "--no-tools",
+            "--approve",
+            ...(options.skills === "enabled"
+                ? ["--skill", path.join(this.root, "skills")]
+                : ["--no-skills"]),
+            prompt
+        ], this.root);
+        const durationMs = performance.now() - started;
+        if (result.exitCode !== 0) {
+            return { status: "failed", reason: result.stderr.trim() || `Pi exited with ${result.exitCode}`, durationMs };
+        }
+        return { status: "ok", value: result.stdout.trim(), durationMs };
+    }
+    async route(example) {
+        const result = await this.invoke(`Route this request using the loaded Skills. Return only JSON matching RouteTrace with categories, atoms, special, locale, prompt, and ambiguous. Request: ${JSON.stringify(example.prompt)}`);
+        if (result.status !== "ok")
+            return result;
+        try {
+            return { status: "ok", value: JSON.parse(result.value), durationMs: result.durationMs };
+        }
+        catch {
+            return { status: "failed", reason: "Pi did not return valid RouteTrace JSON", durationMs: result.durationMs };
+        }
+    }
+    async execute(task, options = { skills: "enabled" }) {
+        const result = await this.invoke(`${options.skills === "enabled" ? "Use the smallest loaded Skill set" : "Do not use any Agent Skill"} to complete this task. Task: ${task.task}\nRubric:\n- ${task.rubric.join("\n- ")}`, options);
+        if (result.status !== "ok")
+            return result;
+        return {
+            status: "ok",
+            value: {
+                output: result.value,
+                rubric: task.rubric.map((criterion) => ({ criterion, passed: false, evidence: "External grading required" }))
+            },
+            durationMs: result.durationMs
+        };
+    }
+}
+//# sourceMappingURL=pi.js.map

package/dist/src/harness/pi.js.map

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

package/dist/src/harness/process.d.ts

@@ -0,0 +1,7 @@
+export interface ProcessResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    error?: NodeJS.ErrnoException;
+}
+export declare function runProcess(command: string, args: string[], cwd?: string): Promise<ProcessResult>;

package/dist/src/harness/process.js

@@ -0,0 +1,18 @@
+import { spawn } from "node:child_process";
+export function runProcess(command, args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, {
+            ...(cwd ? { cwd } : {}),
+            env: process.env,
+            windowsHide: true,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => { stdout += chunk.toString("utf8"); });
+        child.stderr.on("data", (chunk) => { stderr += chunk.toString("utf8"); });
+        child.on("error", (error) => resolve({ exitCode: null, stdout, stderr, error }));
+        child.on("close", (exitCode) => resolve({ exitCode, stdout, stderr }));
+    });
+}
+//# sourceMappingURL=process.js.map

package/dist/src/harness/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../src/harness/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAS3C,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAc,EAAE,GAAY;IACtE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACxG,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/harness/types.d.ts

@@ -0,0 +1,50 @@
+import type { RouteTrace, RoutingExample } from "../types.js";
+export interface HarnessCapabilities {
+    name: string;
+    version: string;
+    structuredOutput: boolean;
+    taskExecution: boolean;
+    discoveredSkills: number;
+}
+export interface HealthReport {
+    name: string;
+    installed: boolean;
+    ready: boolean;
+    version?: string;
+    blockers: string[];
+}
+export type HarnessResult<T> = {
+    status: "ok";
+    value: T;
+    durationMs: number;
+} | {
+    status: "blocked";
+    reason: string;
+    durationMs: number;
+} | {
+    status: "failed";
+    reason: string;
+    durationMs: number;
+};
+export interface TaskExample extends RoutingExample {
+    task: string;
+    rubric: string[];
+}
+export interface TaskTrace {
+    output: string;
+    rubric: Array<{
+        criterion: string;
+        passed: boolean;
+        evidence: string;
+    }>;
+    costUsd?: number;
+}
+export interface ExecutionOptions {
+    skills: "enabled" | "disabled";
+}
+export interface HarnessAdapter {
+    discover(): Promise<HarnessCapabilities>;
+    healthcheck(): Promise<HealthReport>;
+    route(example: RoutingExample): Promise<HarnessResult<RouteTrace>>;
+    execute(task: TaskExample, options?: ExecutionOptions): Promise<HarnessResult<TaskTrace>>;
+}

package/dist/src/harness/types.js

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

package/dist/src/harness/types.js.map

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

package/dist/src/packs.d.ts

@@ -0,0 +1,5 @@
+import type { CapabilityPack, CapabilityPackPlan, PackRecommendation, RouteTrace, SkillContract } from "./types.js";
+export declare function loadPacks(root: string): Promise<CapabilityPack[]>;
+export declare function validatePack(pack: CapabilityPack, contracts: SkillContract[]): string[];
+export declare function compilePackPlan(pack: CapabilityPack, contracts: SkillContract[]): CapabilityPackPlan;
+export declare function recommendPacks(trace: RouteTrace, packs: CapabilityPack[], contracts: SkillContract[], minimumSkillScore?: number): PackRecommendation[];

package/dist/src/packs.js

@@ -0,0 +1,129 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { readYaml } from "./registry.js";
+export async function loadPacks(root) {
+    const packRoot = path.join(root, "packs");
+    const files = (await readdir(packRoot)).filter((file) => file.endsWith(".yaml")).sort();
+    return Promise.all(files.map((file) => readYaml(path.join(packRoot, file))));
+}
+export function validatePack(pack, contracts) {
+    const errors = [];
+    const byId = new Map(contracts.map((contract) => [contract.id, contract]));
+    const members = new Set([...pack.atoms, ...(pack.specialSkills ?? [])]);
+    for (const id of pack.atoms) {
+        const contract = byId.get(id);
+        if (!contract)
+            errors.push(`unknown atom: ${id}`);
+        else if (contract.kind !== "atom")
+            errors.push(`pack atom ${id} has kind ${contract.kind}`);
+    }
+    for (const id of pack.specialSkills ?? []) {
+        const contract = byId.get(id);
+        if (!contract)
+            errors.push(`unknown special Skill: ${id}`);
+        else if (contract.kind === "atom")
+            errors.push(`special Skill ${id} must not be an atom`);
+    }
+    const outgoing = new Map();
+    for (const edge of pack.ordering ?? []) {
+        if (!members.has(edge.before))
+            errors.push(`ordering references non-member: ${edge.before}`);
+        if (!members.has(edge.after))
+            errors.push(`ordering references non-member: ${edge.after}`);
+        const targets = outgoing.get(edge.before) ?? [];
+        targets.push(edge.after);
+        outgoing.set(edge.before, targets);
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (id, stack) => {
+        if (visiting.has(id)) {
+            const start = stack.indexOf(id);
+            errors.push(`ordering cycle: ${[...stack.slice(Math.max(0, start)), id].join(" -> ")}`);
+            return;
+        }
+        if (visited.has(id))
+            return;
+        visiting.add(id);
+        for (const target of outgoing.get(id) ?? [])
+            visit(target, [...stack, id]);
+        visiting.delete(id);
+        visited.add(id);
+    };
+    for (const id of members)
+        visit(id, []);
+    if (pack.runtimeState) {
+        for (const [field, value] of [
+            ["stateSchema", pack.runtimeState.stateSchema],
+            ["initialState", pack.runtimeState.initialState]
+        ]) {
+            const normalized = path.posix.normalize(value.replaceAll("\\", "/"));
+            if (path.posix.isAbsolute(normalized) ||
+                normalized === ".." ||
+                normalized.startsWith("../") ||
+                !normalized.startsWith("runtime/"))
+                errors.push(`runtimeState.${field} must be a repository-relative path under runtime/`);
+        }
+    }
+    return [...new Set(errors)].sort();
+}
+function packMembers(pack) {
+    return [...pack.atoms, ...(pack.specialSkills ?? [])];
+}
+export function compilePackPlan(pack, contracts) {
+    const errors = validatePack(pack, contracts);
+    if (errors.length > 0)
+        throw new Error(`Invalid capability pack ${pack.id}: ${errors.join("; ")}`);
+    const members = packMembers(pack);
+    const remaining = new Set(members);
+    const indegree = new Map(members.map((id) => [id, 0]));
+    const outgoing = new Map();
+    for (const edge of pack.ordering ?? []) {
+        outgoing.set(edge.before, [...(outgoing.get(edge.before) ?? []), edge.after]);
+        indegree.set(edge.after, (indegree.get(edge.after) ?? 0) + 1);
+    }
+    const stages = [];
+    while (remaining.size > 0) {
+        const ready = members.filter((id) => remaining.has(id) && (indegree.get(id) ?? 0) === 0);
+        if (ready.length === 0)
+            throw new Error(`Capability pack ${pack.id} contains an ordering cycle`);
+        stages.push(ready);
+        for (const id of ready) {
+            remaining.delete(id);
+            for (const target of outgoing.get(id) ?? [])
+                indegree.set(target, (indegree.get(target) ?? 0) - 1);
+        }
+    }
+    return {
+        pack: pack.id,
+        name: pack.name,
+        skills: members,
+        stages,
+        acceptanceTests: pack.acceptanceTests,
+        ...(pack.runtimeState ? { runtimeState: pack.runtimeState } : {})
+    };
+}
+export function recommendPacks(trace, packs, contracts, minimumSkillScore = 1) {
+    const candidateScores = new Map([...trace.atoms, ...trace.special].map((candidate) => [candidate.id, candidate.score]));
+    return packs
+        .map((pack) => {
+        const members = packMembers(pack);
+        const matchedSkills = members.filter((id) => (candidateScores.get(id) ?? 0) >= minimumSkillScore);
+        const minimumMatches = Math.min(2, members.length);
+        if (matchedSkills.length < minimumMatches)
+            return undefined;
+        const missingSkills = members.filter((id) => !matchedSkills.includes(id));
+        const relevance = matchedSkills.reduce((sum, id) => sum + (candidateScores.get(id) ?? 0), 0) / members.length;
+        const coverage = matchedSkills.length / members.length;
+        return {
+            pack: pack.id,
+            score: Number((relevance + coverage * 2).toFixed(4)),
+            matchedSkills,
+            missingSkills,
+            plan: compilePackPlan(pack, contracts)
+        };
+    })
+        .filter((candidate) => Boolean(candidate))
+        .sort((left, right) => right.score - left.score || left.pack.localeCompare(right.pack));
+}
+//# sourceMappingURL=packs.js.map

package/dist/src/packs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packs.js","sourceRoot":"","sources":["../../src/packs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AASzC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxF,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAiB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAoB,EAAE,SAA0B;IAC3E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAExE,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;aAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;aACtD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,KAAe,EAAQ,EAAE;QAClD,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxF,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,KAAK,MAAM,EAAE,IAAI,OAAO;QAAE,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAExC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI;YAC3B,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC;YAC9C,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;SACxC,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACrE,IACE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;gBACjC,UAAU,KAAK,IAAI;gBACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;gBAC5B,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,oDAAoD,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,IAAoB;IACvC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAoB,EAAE,SAA0B;IAC9E,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEnG,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9E,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,OAAO,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACzF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,EAAE,6BAA6B,CAAC,CAAC;QACjG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrB,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,OAAO;QACf,MAAM;QACN,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAiB,EACjB,KAAuB,EACvB,SAA0B,EAC1B,iBAAiB,GAAG,CAAC;IAErB,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CACvF,CAAC;IAEF,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAkC,EAAE;QAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC;QAClG,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,aAAa,CAAC,MAAM,GAAG,cAAc;YAAE,OAAO,SAAS,CAAC;QAC5D,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1E,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9G,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACvD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,KAAK,EAAE,MAAM,CAAC,CAAC,SAAS,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpD,aAAa;YACb,aAAa;YACb,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC;SACvC,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,SAAS,EAAmC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;SAC1E,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5F,CAAC"}

package/dist/src/registry.d.ts

@@ -0,0 +1,4 @@
+import type { SkillContract, Taxonomy } from "./types.js";
+export declare function readYaml<T>(filePath: string): Promise<T>;
+export declare function loadTaxonomy(root: string): Promise<Taxonomy>;
+export declare function loadContracts(root: string): Promise<SkillContract[]>;

package/dist/src/registry.js

@@ -0,0 +1,33 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "yaml";
+export async function readYaml(filePath) {
+    return parse(await readFile(filePath, "utf8"));
+}
+export async function loadTaxonomy(root) {
+    return readYaml(path.join(root, "taxonomy", "taxonomy.yaml"));
+}
+export async function loadContracts(root) {
+    const sourceRoot = path.join(root, "skill-src");
+    let entries;
+    try {
+        entries = await readdir(sourceRoot, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const contracts = [];
+    for (const entry of entries.filter((candidate) => candidate.isDirectory())) {
+        try {
+            contracts.push(await readYaml(path.join(sourceRoot, entry.name, "skill.contract.yaml")));
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+    }
+    return contracts.sort((left, right) => left.id.localeCompare(right.id));
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,QAAgB;IAChD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAM,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,OAAO,QAAQ,CAAW,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAoB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CACZ,MAAM,QAAQ,CAAgB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CACxF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/src/relations.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityPack, SkillContract, SkillRelationGraph } from "./types.js";
+export declare function buildSkillRelationGraph(contracts: SkillContract[], packs: CapabilityPack[]): SkillRelationGraph;
+export declare function validateSkillRelationGraph(graph: SkillRelationGraph): string[];

package/dist/src/relations.js

@@ -0,0 +1,92 @@
+function edgeKey(from, to, type) {
+    return `${type}\u0000${from}\u0000${to}`;
+}
+export function buildSkillRelationGraph(contracts, packs) {
+    const nodes = [
+        ...contracts.map((contract) => ({ id: contract.id, kind: contract.kind })),
+        ...packs.map((pack) => ({ id: pack.id, kind: "pack" }))
+    ].sort((left, right) => left.id.localeCompare(right.id));
+    const edgeMap = new Map();
+    const addEdge = (from, to, type, evidence) => {
+        const key = edgeKey(from, to, type);
+        const existing = edgeMap.get(key);
+        if (existing)
+            existing.evidence = [...new Set([...existing.evidence, evidence])].sort();
+        else
+            edgeMap.set(key, { from, to, type, evidence: [evidence] });
+    };
+    for (const contract of contracts) {
+        for (const target of contract.routing.confusableWith) {
+            addEdge(contract.id, target, "confusable-with", `contract:${contract.id}`);
+        }
+    }
+    for (const pack of packs) {
+        const members = [...new Set([...pack.atoms, ...(pack.specialSkills ?? [])])].sort();
+        for (const member of members)
+            addEdge(member, pack.id, "packaged-in", `pack:${pack.id}`);
+        for (let left = 0; left < members.length; left += 1) {
+            for (let right = left + 1; right < members.length; right += 1) {
+                addEdge(members[left], members[right], "compose-with", `pack:${pack.id}`);
+            }
+        }
+        for (const order of pack.ordering ?? []) {
+            addEdge(order.after, order.before, "depends-on", `pack:${pack.id}`);
+        }
+    }
+    return {
+        schemaVersion: 1,
+        nodes,
+        edges: [...edgeMap.values()].sort((left, right) => left.type.localeCompare(right.type) || left.from.localeCompare(right.from) || left.to.localeCompare(right.to))
+    };
+}
+export function validateSkillRelationGraph(graph) {
+    const failures = [];
+    const nodeIds = new Set();
+    for (const node of graph.nodes) {
+        if (nodeIds.has(node.id))
+            failures.push(`duplicate relation node: ${node.id}`);
+        nodeIds.add(node.id);
+    }
+    const edgeIds = new Set();
+    for (const edge of graph.edges) {
+        const key = edgeKey(edge.from, edge.to, edge.type);
+        if (edgeIds.has(key))
+            failures.push(`duplicate relation: ${edge.from} ${edge.type} ${edge.to}`);
+        edgeIds.add(key);
+        if (!nodeIds.has(edge.from)) {
+            failures.push(`relation ${edge.from} ${edge.type} ${edge.to} references unknown endpoint ${edge.from}`);
+        }
+        if (!nodeIds.has(edge.to)) {
+            failures.push(`relation ${edge.from} ${edge.type} ${edge.to} references unknown endpoint ${edge.to}`);
+        }
+        if (edge.from === edge.to)
+            failures.push(`self relation is not allowed: ${edge.from} ${edge.type}`);
+        if (edge.evidence.length === 0)
+            failures.push(`relation lacks evidence: ${edge.from} ${edge.type} ${edge.to}`);
+    }
+    const dependencies = new Map();
+    for (const edge of graph.edges.filter((candidate) => candidate.type === "depends-on")) {
+        dependencies.set(edge.from, [...(dependencies.get(edge.from) ?? []), edge.to].sort());
+    }
+    const complete = new Set();
+    const visit = (id, path, active) => {
+        if (complete.has(id))
+            return;
+        if (active.has(id)) {
+            const start = path.indexOf(id);
+            failures.push(`depends-on cycle: ${[...path.slice(start), id].join(" -> ")}`);
+            return;
+        }
+        active.add(id);
+        path.push(id);
+        for (const dependency of dependencies.get(id) ?? [])
+            visit(dependency, path, active);
+        path.pop();
+        active.delete(id);
+        complete.add(id);
+    };
+    for (const id of [...nodeIds].sort())
+        visit(id, [], new Set());
+    return [...new Set(failures)].sort();
+}
+//# sourceMappingURL=relations.js.map

package/dist/src/relations.js.map

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

package/dist/src/release.d.ts

@@ -0,0 +1,15 @@
+export interface NpmReleaseInput {
+    packageName: string;
+    version: string;
+    repositoryUrl: string;
+    githubRepository: string;
+    releaseTag: string;
+    githubPrerelease: boolean;
+}
+export interface NpmReleasePlan {
+    packageName: string;
+    version: string;
+    releaseTag: string;
+    npmTag: "next" | "latest";
+}
+export declare function planNpmRelease(input: NpmReleaseInput): NpmReleasePlan;

package/dist/src/release.js

@@ -0,0 +1,27 @@
+const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/u;
+export function planNpmRelease(input) {
+    if (!input.packageName.trim())
+        throw new Error("package name must not be empty");
+    const semver = SEMVER.exec(input.version);
+    if (!semver)
+        throw new Error(`package version ${input.version} is not valid SemVer`);
+    const expectedTag = `v${input.version}`;
+    if (input.releaseTag !== expectedTag) {
+        throw new Error(`release tag ${input.releaseTag} must exactly equal ${expectedTag}`);
+    }
+    const isPrerelease = semver[4] !== undefined;
+    if (input.githubPrerelease !== isPrerelease) {
+        throw new Error(`GitHub prerelease flag ${input.githubPrerelease} disagrees with package version ${input.version}`);
+    }
+    const expectedRepositoryUrl = `git+https://github.com/${input.githubRepository}.git`;
+    if (input.repositoryUrl !== expectedRepositoryUrl) {
+        throw new Error(`repository.url must exactly equal ${expectedRepositoryUrl}`);
+    }
+    return {
+        packageName: input.packageName,
+        version: input.version,
+        releaseTag: input.releaseTag,
+        npmTag: isPrerelease ? "next" : "latest"
+    };
+}
+//# sourceMappingURL=release.js.map

package/dist/src/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../src/release.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,8HAA8H,CAAC;AAkB9I,MAAM,UAAU,cAAc,CAAC,KAAsB;IACnD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAErF,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;IACxC,IAAI,KAAK,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,UAAU,uBAAuB,WAAW,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IAC7C,IAAI,KAAK,CAAC,gBAAgB,KAAK,YAAY,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,CAAC,gBAAgB,mCAAmC,KAAK,CAAC,OAAO,EAAE,CACnG,CAAC;IACJ,CAAC;IAED,MAAM,qBAAqB,GAAG,0BAA0B,KAAK,CAAC,gBAAgB,MAAM,CAAC;IACrF,IAAI,KAAK,CAAC,aAAa,KAAK,qBAAqB,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,qCAAqC,qBAAqB,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;KACzC,CAAC;AACJ,CAAC"}

package/dist/src/router.d.ts

@@ -0,0 +1,9 @@
+import type { RouteTrace, SkillContract, Taxonomy } from "./types.js";
+export interface RouteOptions {
+    locale?: string;
+    categoryLimit?: number;
+    atomLimit?: number;
+    ambiguityDelta?: number;
+}
+export declare function detectLocale(prompt: string): string;
+export declare function routeRequest(rawPrompt: string, taxonomy: Taxonomy, contracts: SkillContract[], options?: RouteOptions): RouteTrace;