skillpack-one 0.1.0-alpha.10

package/dist/src/train/knowledge.d.ts

@@ -0,0 +1,11 @@
+import type { EvolutionPattern, EvolutionPatternMatch } from "./types.js";
+export interface EvolutionPatternDocument {
+    file: string;
+    pattern: EvolutionPattern;
+}
+export declare function loadEvolutionPatternDocuments(root: string): Promise<EvolutionPatternDocument[]>;
+export declare function loadEvolutionPatterns(root: string): Promise<EvolutionPattern[]>;
+export declare function validateEvolutionKnowledgeGraph(documents: EvolutionPatternDocument[], knownSkills: ReadonlySet<string>, knownPacks: ReadonlySet<string>): string[];
+export declare function searchEvolutionPatterns(query: string, patterns: EvolutionPattern[]): EvolutionPatternMatch[];
+export declare function renderEvolutionKnowledgeIndex(patterns: EvolutionPattern[]): string;
+export declare function writeEvolutionKnowledgeIndex(root: string, patterns: EvolutionPattern[]): Promise<string>;

package/dist/src/train/knowledge.js

@@ -0,0 +1,128 @@
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "yaml";
+function knowledgeRoot(root) {
+    return path.join(root, ".skill-system", "knowledge");
+}
+export async function loadEvolutionPatternDocuments(root) {
+    const patternsRoot = path.join(knowledgeRoot(root), "patterns");
+    let files;
+    try {
+        files = (await readdir(patternsRoot)).filter((file) => file.endsWith(".yaml")).sort();
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    return Promise.all(files.map(async (file) => ({
+        file: path.posix.join(".skill-system", "knowledge", "patterns", file),
+        pattern: parse(await readFile(path.join(patternsRoot, file), "utf8"))
+    })));
+}
+export async function loadEvolutionPatterns(root) {
+    return (await loadEvolutionPatternDocuments(root)).map((document) => document.pattern);
+}
+export function validateEvolutionKnowledgeGraph(documents, knownSkills, knownPacks) {
+    const errors = [];
+    const byId = new Map();
+    for (const { file, pattern } of documents) {
+        const expectedFile = `${pattern.id}.yaml`;
+        if (path.posix.basename(file) !== expectedFile)
+            errors.push(`${file}: filename must be ${expectedFile}`);
+        if (byId.has(pattern.id))
+            errors.push(`duplicate evolution pattern id: ${pattern.id}`);
+        else
+            byId.set(pattern.id, pattern);
+        if (pattern.updatedAt < pattern.createdAt)
+            errors.push(`${pattern.id}: updatedAt precedes createdAt`);
+        if (pattern.supersedes.includes(pattern.id))
+            errors.push(`${pattern.id}: pattern cannot supersede itself`);
+        for (const skill of pattern.scope.skills) {
+            if (!knownSkills.has(skill))
+                errors.push(`${pattern.id}: unknown scoped Skill ${skill}`);
+        }
+        for (const pack of pattern.scope.packs) {
+            if (!knownPacks.has(pack))
+                errors.push(`${pattern.id}: unknown scoped capability pack ${pack}`);
+        }
+    }
+    for (const pattern of byId.values()) {
+        for (const superseded of pattern.supersedes) {
+            if (!byId.has(superseded))
+                errors.push(`${pattern.id}: supersedes unknown pattern ${superseded}`);
+        }
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (id, stack) => {
+        if (visiting.has(id)) {
+            const start = stack.indexOf(id);
+            errors.push(`evolution pattern supersession cycle: ${[...stack.slice(Math.max(0, start)), id].join(" -> ")}`);
+            return;
+        }
+        if (visited.has(id))
+            return;
+        visiting.add(id);
+        for (const target of byId.get(id)?.supersedes ?? [])
+            visit(target, [...stack, id]);
+        visiting.delete(id);
+        visited.add(id);
+    };
+    for (const id of byId.keys())
+        visit(id, []);
+    return [...new Set(errors)].sort();
+}
+function tokens(value) {
+    return [...new Set(value.normalize("NFKC").toLocaleLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [])]
+        .filter((token) => token.length > 1);
+}
+export function searchEvolutionPatterns(query, patterns) {
+    const queryTokens = tokens(query);
+    if (queryTokens.length === 0)
+        return [];
+    return patterns
+        .filter((pattern) => pattern.status === "active")
+        .map((pattern) => {
+        const idTokens = new Set(tokens(pattern.id));
+        const bodyTokens = new Set(tokens([
+            pattern.summary,
+            pattern.problem,
+            pattern.rootCause,
+            pattern.response,
+            ...pattern.scope.skills,
+            ...pattern.scope.packs,
+            ...pattern.scope.harnesses
+        ].join(" ")));
+        const matched = queryTokens.filter((token) => idTokens.has(token) || bodyTokens.has(token));
+        if (matched.length === 0)
+            return undefined;
+        const score = matched.reduce((sum, token) => sum + (idTokens.has(token) ? 2 : 1), 0) / queryTokens.length;
+        return { id: pattern.id, score: Number(score.toFixed(4)), matched, summary: pattern.summary, confidence: pattern.confidence };
+    })
+        .filter((match) => Boolean(match))
+        .sort((left, right) => right.score - left.score || left.id.localeCompare(right.id));
+}
+export function renderEvolutionKnowledgeIndex(patterns) {
+    const lines = [
+        "# Evolution Knowledge",
+        "",
+        "Generated from versioned pattern records. This index is governance context, not task-execution instruction.",
+        ""
+    ];
+    for (const pattern of [...patterns].sort((left, right) => left.id.localeCompare(right.id))) {
+        const scope = [...pattern.scope.skills, ...pattern.scope.packs, ...pattern.scope.harnesses];
+        lines.push(`- \`${pattern.id}\` — ${pattern.summary}`);
+        lines.push(`  - Status: \`${pattern.status}\`; confidence: \`${pattern.confidence}\`; scope: ${scope.length ? scope.map((value) => `\`${value}\``).join(", ") : "global"}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+export async function writeEvolutionKnowledgeIndex(root, patterns) {
+    const directory = knowledgeRoot(root);
+    const output = path.join(directory, "index.md");
+    await mkdir(directory, { recursive: true });
+    await writeFile(output, renderEvolutionKnowledgeIndex(patterns), "utf8");
+    return output;
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/src/train/knowledge.js.map

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

package/dist/src/train/propose.d.ts

@@ -0,0 +1,19 @@
+import type { PermissionEnvelope } from "../types.js";
+import type { EvolutionAuthorship, EvolutionProposal } from "./types.js";
+export interface ProposalDraftInput {
+    id: string;
+    createdAt: string;
+    targetSkill: string;
+    observation: string;
+    authorship?: EvolutionAuthorship;
+    knowledgePatterns?: string[];
+    baseRevision: string;
+    candidateRevision: string;
+    changedFiles: string[];
+    generationDatasets?: string[];
+    evaluationDatasets?: string[];
+    permissionBefore?: PermissionEnvelope;
+    permissionAfter?: PermissionEnvelope;
+}
+export declare function buildProposalDraft(input: ProposalDraftInput): EvolutionProposal;
+export declare function writeProposalDraft(root: string, proposal: EvolutionProposal): Promise<string>;

package/dist/src/train/propose.js

@@ -0,0 +1,43 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { stringify } from "yaml";
+const LEAST_AUTHORITY = {
+    network: "none",
+    filesystem: "read",
+    shell: "none",
+    secrets: "none",
+    externalCommunication: "none"
+};
+export function buildProposalDraft(input) {
+    const changedFiles = [...new Set(input.changedFiles.map((file) => file.replaceAll("\\", "/")))].sort();
+    const before = input.permissionBefore ?? LEAST_AUTHORITY;
+    return {
+        schemaVersion: 1,
+        id: input.id,
+        createdAt: input.createdAt,
+        targetSkill: input.targetSkill,
+        baseRevision: input.baseRevision,
+        candidateRevision: input.candidateRevision,
+        rollbackRevision: input.baseRevision,
+        observation: input.observation,
+        ...(input.authorship ? { authorship: input.authorship } : {}),
+        ...(input.knowledgePatterns?.length ? { knowledgePatterns: [...new Set(input.knowledgePatterns)].sort() } : {}),
+        allowedFiles: changedFiles,
+        changedFiles,
+        generationDatasets: input.generationDatasets ?? ["routing-bootstrap"],
+        evaluationDatasets: input.evaluationDatasets ?? ["routing-en-test", "routing-zh-cn-test", "routing-adversarial"],
+        permissionBefore: { ...before },
+        permissionAfter: { ...(input.permissionAfter ?? before) },
+        approvals: []
+    };
+}
+export async function writeProposalDraft(root, proposal) {
+    const proposalsRoot = path.resolve(root, ".skill-system", "proposals");
+    const output = path.resolve(proposalsRoot, `${proposal.id}.yaml`);
+    if (path.dirname(output) !== proposalsRoot)
+        throw new Error("Proposal output escaped the proposals directory");
+    await mkdir(proposalsRoot, { recursive: true });
+    await writeFile(output, stringify(proposal), { encoding: "utf8", flag: "wx" });
+    return output;
+}
+//# sourceMappingURL=propose.js.map

package/dist/src/train/propose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.js","sourceRoot":"","sources":["../../../src/train/propose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAIjC,MAAM,eAAe,GAAuB;IAC1C,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,MAAM;IAClB,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,qBAAqB,EAAE,MAAM;CAC9B,CAAC;AAkBF,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvG,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,IAAI,eAAe,CAAC;IACzD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,gBAAgB,EAAE,KAAK,CAAC,YAAY;QACpC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/G,YAAY,EAAE,YAAY;QAC1B,YAAY;QACZ,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,CAAC,mBAAmB,CAAC;QACrE,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,CAAC;QAChH,gBAAgB,EAAE,EAAE,GAAG,MAAM,EAAE;QAC/B,eAAe,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,eAAe,IAAI,MAAM,CAAC,EAAE;QACzD,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,QAA2B;IAChF,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC/G,MAAM,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/train/revisions.d.ts

@@ -0,0 +1,7 @@
+import type { EvolutionProposal } from "./types.js";
+export declare function canonicalRevisionDiffFailures(declaredFiles: string[], gitDiffFiles: string[]): string[];
+export declare function currentRevision(root: string): Promise<string>;
+export declare function resolveRevision(root: string, revision: string): Promise<string>;
+export declare function parentRevision(root: string, revision: string): Promise<string>;
+export declare function revisionChangedFiles(root: string, baseRevision: string, candidateRevision: string): Promise<string[]>;
+export declare function validateProposalRevisionEvidence(root: string, proposal: EvolutionProposal, proposalPath?: string): Promise<string[]>;

package/dist/src/train/revisions.js

@@ -0,0 +1,103 @@
+import { execFile } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+function normalized(file) {
+    return file.replaceAll("\\", "/").replace(/^\.\//u, "");
+}
+function isGeneratedProjection(file) {
+    const value = normalized(file);
+    return value.startsWith("skills/") || value.startsWith(".agents/skills/");
+}
+async function git(root, args) {
+    const result = await execFileAsync("git", args, { cwd: root, encoding: "utf8" });
+    return result.stdout.trim();
+}
+export function canonicalRevisionDiffFailures(declaredFiles, gitDiffFiles) {
+    const declared = new Set(declaredFiles.map(normalized));
+    const actual = new Set(gitDiffFiles.map(normalized).filter((file) => file && !isGeneratedProjection(file)));
+    const failures = [];
+    for (const file of actual) {
+        if (!declared.has(file))
+            failures.push(`candidate Git diff is missing from changedFiles: ${file}`);
+    }
+    for (const file of declared) {
+        if (!actual.has(file))
+            failures.push(`changedFiles is not present in candidate Git diff: ${file}`);
+    }
+    return failures.sort();
+}
+export async function currentRevision(root) {
+    return resolveRevision(root, "HEAD");
+}
+export async function resolveRevision(root, revision) {
+    return git(root, ["rev-parse", `${revision}^{commit}`]);
+}
+export async function parentRevision(root, revision) {
+    return git(root, ["rev-parse", `${revision}^`]);
+}
+export async function revisionChangedFiles(root, baseRevision, candidateRevision) {
+    const output = await git(root, ["diff", "--name-only", "--diff-filter=ACDMRTUXB", baseRevision, candidateRevision]);
+    return output.split(/\r?\n/u).map(normalized).filter((file) => file && !isGeneratedProjection(file)).sort();
+}
+export async function validateProposalRevisionEvidence(root, proposal, proposalPath) {
+    const failures = [];
+    let base = "";
+    let candidate = "";
+    try {
+        [base, candidate] = await Promise.all([
+            git(root, ["rev-parse", `${proposal.baseRevision}^{commit}`]),
+            git(root, ["rev-parse", `${proposal.candidateRevision}^{commit}`])
+        ]);
+    }
+    catch {
+        return ["base or candidate revision does not resolve to a Git commit"];
+    }
+    if (base !== proposal.baseRevision)
+        failures.push("baseRevision is not the exact resolved commit");
+    if (candidate !== proposal.candidateRevision)
+        failures.push("candidateRevision is not the exact resolved commit");
+    try {
+        await git(root, ["merge-base", "--is-ancestor", base, candidate]);
+    }
+    catch {
+        failures.push("candidateRevision is not a descendant of baseRevision");
+    }
+    try {
+        failures.push(...canonicalRevisionDiffFailures(proposal.changedFiles, await revisionChangedFiles(root, base, candidate)));
+    }
+    catch {
+        failures.push("candidate Git diff could not be read");
+    }
+    try {
+        if ((await currentRevision(root)) !== candidate)
+            failures.push("working tree HEAD does not equal candidateRevision");
+        await git(root, ["diff", "--quiet"]);
+        await git(root, ["diff", "--cached", "--quiet"]);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!message.includes("diff --quiet") && !message.includes("diff --cached --quiet")) {
+            failures.push("tracked working tree state could not be verified");
+        }
+        else {
+            failures.push("tracked working tree differs from candidateRevision");
+        }
+    }
+    try {
+        const untracked = (await git(root, ["ls-files", "--others", "--exclude-standard", "-z"]))
+            .split("\0")
+            .map(normalized)
+            .filter(Boolean);
+        const allowedProposal = proposalPath ? normalized(path.relative(root, proposalPath)) : `.skill-system/proposals/${proposal.id}.yaml`;
+        for (const file of untracked) {
+            if (file !== allowedProposal)
+                failures.push(`untracked file could affect candidate evaluation: ${file}`);
+        }
+    }
+    catch {
+        failures.push("untracked working tree state could not be verified");
+    }
+    return [...new Set(failures)].sort();
+}
+//# sourceMappingURL=revisions.js.map

package/dist/src/train/revisions.js.map

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

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

@@ -0,0 +1,97 @@
+import type { PermissionEnvelope } from "../types.js";
+export interface EvolutionApproval {
+    type: "permission-expansion" | "promotion" | "destructive-maintenance";
+    approvedBy: string;
+    approvedAt: string;
+    reason: string;
+}
+export interface EvolutionAuthorship {
+    mode: "human" | "model-assisted" | "model-generated";
+    author: string;
+    generator?: string;
+}
+export type EvolutionEvidenceKind = "task-run" | "proposal" | "decision" | "paper" | "user-feedback";
+export interface EvolutionEvidenceReference {
+    kind: EvolutionEvidenceKind;
+    ref: string;
+    locator?: string;
+    digest?: string;
+    note: string;
+}
+export interface EvolutionPattern {
+    schemaVersion: 1;
+    id: string;
+    status: "active" | "superseded" | "archived";
+    summary: string;
+    problem: string;
+    rootCause: string;
+    response: string;
+    confidence: "hypothesis" | "observed" | "replicated";
+    scope: {
+        skills: string[];
+        packs: string[];
+        harnesses: string[];
+    };
+    evidence: EvolutionEvidenceReference[];
+    supersedes: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EvolutionPatternMatch {
+    id: string;
+    score: number;
+    matched: string[];
+    summary: string;
+    confidence: EvolutionPattern["confidence"];
+}
+export interface EvolutionProposal {
+    schemaVersion: 1;
+    id: string;
+    createdAt: string;
+    targetSkill: string;
+    baseRevision: string;
+    candidateRevision: string;
+    rollbackRevision: string;
+    observation: string;
+    authorship?: EvolutionAuthorship;
+    knowledgePatterns?: string[];
+    allowedFiles: string[];
+    changedFiles: string[];
+    generationDatasets: string[];
+    evaluationDatasets: string[];
+    permissionBefore: PermissionEnvelope;
+    permissionAfter: PermissionEnvelope;
+    approvals: EvolutionApproval[];
+}
+export interface EvolutionEvaluation {
+    passed: boolean;
+    failures: string[];
+}
+export interface EvolutionEdit {
+    operation: "add" | "delete" | "replace";
+    path: string;
+    before?: string;
+    after?: string;
+    rationale: string;
+}
+export interface EvolutionAttempt {
+    schemaVersion: 1;
+    id: string;
+    proposal: string;
+    createdAt: string;
+    baseRevision: string;
+    candidateRevision: string;
+    editBudget: number;
+    edits: EvolutionEdit[];
+    acceptanceRule: "strict-improvement";
+    selection: {
+        dataset: string;
+        before: number;
+        after: number;
+    };
+    protectedRegressions: string[];
+    decision: {
+        status: "accepted" | "rejected";
+        reasons: string[];
+    };
+}

package/dist/src/train/types.js

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

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

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