vskill 1.0.12 → 1.0.14

package/dist/core/skill-generator.d.ts

@@ -1,7 +1,29 @@
-import { type GenerateSkillRequest, type GenerateSkillResult } from "../eval-server/skill-create-routes.js";
-export type { GenerateSkillRequest, GenerateSkillResult };
+import { type GenerateSkillRequest as BaseGenerateSkillRequest, type GenerateSkillResult as BaseGenerateSkillResult } from "../eval-server/skill-create-routes.js";
+export interface GenerateSkillRequest extends BaseGenerateSkillRequest {
+    multiFile?: boolean;
+}
+export interface GenerateSkillResult extends BaseGenerateSkillResult {
+    /** Auxiliary files produced by the multi-file pipeline (relative path → contents). */
+    files?: Record<string, string>;
+    /** Env-var names declared by the test-agent. */
+    secrets?: string[];
+    /** Runtime requirements declared by the script-agent. */
+    runtime?: {
+        python?: string;
+        pip?: string[];
+        node?: string;
+    };
+    /** Integration-test contract declared by the test-agent. */
+    integrationTests?: {
+        runner: "vitest" | "pytest" | "none";
+        file?: string;
+        requires?: string[];
+    };
+    /** Per-agent error messages from the parallel fan-out (informational). */
+    multiFileWarnings?: string[];
+}
 export interface GenerateSkillProgressEvent {
-    phase: "preparing" | "generating-body" | "generating-evals" | "parsing" | "done";
+    phase: "preparing" | "generating-body" | "generating-evals" | "generating-scripts" | "generating-graders" | "generating-tests" | "generating-references" | "parsing" | "done";
     message: string;
 }
 export interface GenerateSkillOptions {

package/dist/core/skill-generator.js

@@ -25,6 +25,7 @@
 // eslint-disable-next-line no-restricted-imports -- see module header TODO
 import { BODY_SYSTEM_PROMPT, EVAL_SYSTEM_PROMPT, buildAgentAwareSystemPrompt, detectProjectLayout, mergeGenerateResults, parseBodyResponse, parseEvalsResponse, } from "../eval-server/skill-create-routes.js";
 import { createLlmClient } from "../eval/llm.js";
+import { SCRIPT_SYSTEM_PROMPT, GRADER_SYSTEM_PROMPT, TEST_SYSTEM_PROMPT, REFERENCE_SYSTEM_PROMPT, parseScriptResponse, parseGraderResponse, parseTestResponse, parseReferenceResponse, } from "./agent-prompts.js";
 /**
  * Resolve provider + model defaults consistent with the pre-extraction
  * handler behavior: when both are absent we use { claude-cli, sonnet }.
@@ -76,6 +77,18 @@ export async function generateSkill(request, options) {
     const evalPrompt = `Generate eval test cases for this skill:\n\n${trimmedPrompt}\n\nReturn only the JSON object with an "evals" array.`;
     // Agent-aware prompt augmentation: append constraints for non-Claude agents
     const effectiveSystemPrompt = buildAgentAwareSystemPrompt(BODY_SYSTEM_PROMPT, request.targetAgents);
+    if (request.multiFile === true) {
+        return await generateMultiFileSkill({
+            trimmedPrompt,
+            effectiveSystemPrompt,
+            provider,
+            model,
+            evalModel,
+            pluginContext,
+            abortSignal,
+            emit,
+        });
+    }
     emit({ phase: "generating-body", message: "Generating skill body..." });
     emit({ phase: "generating-evals", message: "Generating evals..." });
     const bodyCall = bodyClient
@@ -97,4 +110,122 @@ export async function generateSkill(request, options) {
     emit({ phase: "done", message: "Generation complete" });
     return merged;
 }
+async function generateMultiFileSkill(ctx) {
+    const { trimmedPrompt, effectiveSystemPrompt, provider, model, evalModel, pluginContext, abortSignal, emit, } = ctx;
+    // Capable model for code-producing agents; cheap model for reference + eval.
+    const capableClient = createLlmClient({ provider, model });
+    const cheapClient = createLlmClient({ provider, model: evalModel });
+    // Each agent gets the same skill description; the system prompt does the
+    // role-shaping. buildAgentAwareSystemPrompt() is intentionally NOT applied
+    // here — the per-role prompts are concrete enough that target-agent
+    // constraints are encoded by the body-agent's SKILL.md output, not the
+    // auxiliary code files.
+    const userPrompt = `Generate the role-specific output for this skill:\n\n${trimmedPrompt}`;
+    emit({ phase: "generating-scripts", message: "Generating helper scripts..." });
+    emit({ phase: "generating-graders", message: "Generating grader..." });
+    emit({ phase: "generating-tests", message: "Generating integration test..." });
+    emit({ phase: "generating-references", message: "Generating references..." });
+    emit({ phase: "generating-evals", message: "Generating evals..." });
+    const scriptCall = capableClient
+        .generate(SCRIPT_SYSTEM_PROMPT, userPrompt)
+        .then((r) => parseScriptResponse(r.text));
+    const graderCall = capableClient
+        .generate(GRADER_SYSTEM_PROMPT, userPrompt)
+        .then((r) => parseGraderResponse(r.text));
+    const testCall = capableClient
+        .generate(TEST_SYSTEM_PROMPT, userPrompt)
+        .then((r) => parseTestResponse(r.text));
+    const referenceCall = cheapClient
+        .generate(REFERENCE_SYSTEM_PROMPT, userPrompt)
+        .then((r) => parseReferenceResponse(r.text));
+    const evalCall = cheapClient
+        .generate(EVAL_SYSTEM_PROMPT, `Generate eval test cases for this skill:\n\n${trimmedPrompt}\n\nReturn only the JSON object with an "evals" array.`)
+        .then((r) => parseEvalsResponse(r.text));
+    const settled = await Promise.allSettled([
+        scriptCall,
+        graderCall,
+        testCall,
+        referenceCall,
+        evalCall,
+    ]);
+    if (abortSignal?.aborted) {
+        const reason = abortSignal.reason ??
+            new Error("Skill generation aborted");
+        throw reason instanceof Error ? reason : new Error(String(reason));
+    }
+    // Collect produced files + warnings.
+    const files = {};
+    const warnings = [];
+    let secrets;
+    let runtime;
+    let integrationTests;
+    const [scriptR, graderR, testR, referenceR, evalsR] = settled;
+    if (scriptR.status === "fulfilled") {
+        for (const f of scriptR.value.files)
+            files[f.path] = f.content;
+        if (scriptR.value.runtime)
+            runtime = scriptR.value.runtime;
+    }
+    else {
+        warnings.push(`script-agent failed: ${stringifyReason(scriptR.reason)}`);
+    }
+    if (graderR.status === "fulfilled") {
+        for (const f of graderR.value.files)
+            files[f.path] = f.content;
+    }
+    else {
+        warnings.push(`grader-agent failed: ${stringifyReason(graderR.reason)}`);
+    }
+    if (testR.status === "fulfilled") {
+        for (const f of testR.value.files)
+            files[f.path] = f.content;
+        if (testR.value.secrets)
+            secrets = testR.value.secrets;
+        if (testR.value.integrationTests)
+            integrationTests = testR.value.integrationTests;
+    }
+    else {
+        warnings.push(`test-agent failed: ${stringifyReason(testR.reason)}`);
+    }
+    if (referenceR.status === "fulfilled") {
+        for (const f of referenceR.value.files)
+            files[f.path] = f.content;
+    }
+    else {
+        warnings.push(`reference-agent failed: ${stringifyReason(referenceR.reason)}`);
+    }
+    emit({ phase: "generating-body", message: "Generating SKILL.md..." });
+    // Body-agent runs LAST with the produced filename list so SKILL.md can
+    // reference the actual files. Missing files become generic prose in the
+    // SKILL.md body — never broken links.
+    const filenameList = Object.keys(files).sort().join("\n  - ");
+    const bodyPrompt = `Generate a skill definition (body and metadata only, NO evals) for:\n\n${trimmedPrompt}\n\nThe skill is multi-file. The following auxiliary files have been produced and live in the skill directory:\n  - ${filenameList || "(no auxiliary files produced)"}\n\nReference them in the SKILL.md body using relative paths (e.g. \`scripts/audit.py\`). If a referenced category is missing from the list above, omit references rather than inventing filenames.\n\nApply Skill Studio best practices. Return the JSON object followed by ---REASONING--- and your explanation.${pluginContext}`;
+    const bodyClient = createLlmClient({ provider, model });
+    const bodySettled = await Promise.allSettled([
+        bodyClient.generate(effectiveSystemPrompt, bodyPrompt).then((r) => parseBodyResponse(r.text)),
+    ]);
+    emit({ phase: "parsing", message: "Merging multi-file results..." });
+    const merged = mergeGenerateResults(bodySettled[0], evalsR);
+    emit({ phase: "done", message: "Multi-file generation complete" });
+    return {
+        ...merged,
+        files,
+        ...(secrets ? { secrets } : {}),
+        ...(runtime ? { runtime } : {}),
+        ...(integrationTests ? { integrationTests } : {}),
+        ...(warnings.length > 0 ? { multiFileWarnings: warnings } : {}),
+    };
+}
+function stringifyReason(reason) {
+    if (reason instanceof Error)
+        return reason.message;
+    if (typeof reason === "string")
+        return reason;
+    try {
+        return JSON.stringify(reason);
+    }
+    catch {
+        return String(reason);
+    }
+}
 //# sourceMappingURL=skill-generator.js.map

package/dist/core/skill-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/core/skill-generator.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,mCAAmC;AACnC,EAAE;AACF,iCAAiC;AACjC,sEAAsE;AACtE,0BAA0B;AAC1B,2EAA2E;AAC3E,oCAAoC;AACpC,wEAAwE;AACxE,uEAAuE;AACvE,uCAAuC;AACvC,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,yEAAyE;AACzE,yEAAyE;AACzE,uEAAuE;AACvE,wEAAwE;AACxE,iEAAiE;AACjE,uEAAuE;AACvE,kCAAkC;AAClC,8EAA8E;AAE9E,2EAA2E;AAC3E,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA4BjD;;;;;;;;GAQG;AACH,SAAS,oBAAoB,CAAC,OAA6B;IAIzD,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAiB,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;IACxC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAA6B,EAC7B,OAA6B;IAE7B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAElD,MAAM,IAAI,GAAG,CAAC,KAAiC,EAAQ,EAAE;QACvD,IAAI,UAAU,IAAI,CAAC,WAAW,EAAE,OAAO;YAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC,CAAC;IAEF,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAE5D,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE1D,6DAA6D;IAC7D,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAExD,6EAA6E;IAC7E,yEAAyE;IACzE,+CAA+C;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,OAAO,CAAC;IAC/D,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAEnE,2EAA2E;IAC3E,2DAA2D;IAC3D,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,eAAe,GAAG;QACtB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;KACrE,CAAC;IACF,MAAM,aAAa,GACjB,eAAe,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,yCAAyC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,oJAAoJ;QAC9N,CAAC,CAAC,8HAA8H,CAAC;IAErI,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,0EAA0E,aAAa,kHAAkH,aAAa,EAAE,CAAC;IAC5O,MAAM,UAAU,GAAG,+CAA+C,aAAa,wDAAwD,CAAC;IAExI,4EAA4E;IAC5E,MAAM,qBAAqB,GAAG,2BAA2B,CACvD,kBAAkB,EAClB,OAAO,CAAC,YAAY,CACrB,CAAC;IAEF,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAEpE,MAAM,QAAQ,GAAG,UAAU;SACxB,QAAQ,CAAC,qBAAqB,EAAE,UAAU,CAAC;SAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,UAAU;SACxB,QAAQ,CAAC,kBAAkB,EAAE,UAAU,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3C,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnF,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;QACzB,mEAAmE;QACnE,gDAAgD;QAChD,MAAM,MAAM,GACT,WAAkD,CAAC,MAAM;YAC1D,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACxC,MAAM,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAE/D,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAExD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/core/skill-generator.ts"],"names":[],"mappings":"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"}

package/dist/eval-server/api-routes.d.ts

@@ -107,6 +107,20 @@ export interface SkillMetadataFields {
      *  "skills/foo/SKILL.md"). Defaults to "SKILL.md" for flat-layout
      *  installs derived from a legacy `github:` source string. */
     skillPath: string | null;
+    /** Env-var names this skill expects (purposes/hints live in `.env.example` comments). */
+    secrets: string[] | null;
+    /** Language runtime declaration (Python and/or Node.js). */
+    runtime: {
+        python: string | null;
+        pip: string[] | null;
+        node: string | null;
+    } | null;
+    /** Integration-test contract verified by `vskill check`. */
+    integrationTests: {
+        runner: "vitest" | "pytest" | "none";
+        file: string | null;
+        requires: string[] | null;
+    } | null;
 }
 /**
  * Minimal YAML frontmatter parser — handles scalars and arrays (inline [a, b]
@@ -130,40 +144,8 @@ export declare function parseSkillFrontmatter(content: string): Record<string, s
  * for `origin="source"` or if no registry entry matches.
  */
 export declare function deriveSourceAgent(skillDir: string, root: string, origin: "source" | "installed"): string | null;
-/**
- * 0770 — Pure regex parser. Normalizes any github.com origin remote
- * (SSH, HTTPS, ssh://) to its canonical `https://github.com/owner/repo`
- * form (no `.git` suffix, no trailing path). Returns null for non-github
- * hosts, malformed input, empty/whitespace strings.
- */
-export declare function parseGithubRemote(remote: string | null | undefined): string | null;
-/**
- * 0770 — Walk parent directories from `startDir` looking for a `.git` entry
- * (directory OR file — git worktrees use a `.git` file). Bails at the
- * filesystem root or after `maxLevels` iterations. Returns the absolute
- * path of the discovered git root, or null.
- */
-export declare function walkUpForGitRoot(startDir: string, maxLevels?: number): string | null;
-/**
- * 0770 — Test-only helper to clear the module-level memoization cache so
- * tests can isolate detection runs across `beforeEach`.
- */
-export declare function resetAuthoredSourceLinkCache(): void;
-/**
- * 0770 — Detect source-repo provenance for a locally-authored skill (no
- * lockfile entry). Walks for `.git`, reads `origin` remote, normalizes via
- * `parseGithubRemote`, and computes `skillPath` from `git ls-files` (with a
- * filesystem fallback for untracked SKILL.md files). Memoized per absolute
- * skill dir for the eval-server process lifetime.
- *
- * All git invocations use `execFileSync` with explicit argv (no shell), a
- * 1500ms hard timeout, and silenced stderr. Any error converts to
- * `{null, null}` — `buildSkillMetadata` never throws because of git.
- */
-export declare function detectAuthoredSourceLink(skillDir: string): {
-    repoUrl: string | null;
-    skillPath: string | null;
-};
+import { parseGithubRemote, walkUpForGitRoot, detectAuthoredSourceLink, resolveSourceLink, readCopiedSkillSidecar, resetAuthoredSourceLinkCache, resetCopiedSkillSidecarCache } from "./source-link.js";
+export { parseGithubRemote, walkUpForGitRoot, detectAuthoredSourceLink, resolveSourceLink, readCopiedSkillSidecar, resetAuthoredSourceLinkCache, resetCopiedSkillSidecarCache, };
 /**
  * Build the T-025 metadata payload for a single skill. Reads SKILL.md from
  * disk if present; returns EMPTY_METADATA on any error so the /api/skills
@@ -233,4 +215,3 @@ export declare function detectAvailableProviders(): Promise<Array<{
     resolvedModel?: string | null;
 }>>;
 export declare function registerRoutes(router: Router, root: string, projectName?: string): void;
-export {};

package/dist/eval-server/api-routes.js

@@ -3,7 +3,7 @@
 // ---------------------------------------------------------------------------
 import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, statSync } from "node:fs";
 import { execSync, execFileSync } from "node:child_process";
-import { join, resolve, dirname, basename, relative } from "node:path";
+import { join, resolve, dirname } from "node:path";
 import { homedir } from "node:os";
 import { sendJson, readBody } from "./router.js";
 import { initSSE, sendSSE, sendSSEDone, withHeartbeat, startDynamicHeartbeat } from "./sse-helpers.js";
@@ -375,6 +375,9 @@ const EMPTY_METADATA = {
     sourceAgent: null,
     repoUrl: null,
     skillPath: null,
+    secrets: null,
+    runtime: null,
+    integrationTests: null,
 };
 /**
  * Allow-list of metadata children that may be surfaced at the top level
@@ -407,6 +410,20 @@ const SURFACED_METADATA_KEYS = new Set([
     // Path / file metadata
     "entryPoint",
     "entry-point",
+    // 0815: multi-file manifest fields (kebab-case canonical, camelCase tolerated).
+    "secrets",
+    "runtime-python",
+    "runtimePython",
+    "runtime-pip",
+    "runtimePip",
+    "runtime-node",
+    "runtimeNode",
+    "integration-runner",
+    "integrationRunner",
+    "integration-file",
+    "integrationFile",
+    "integration-requires",
+    "integrationRequires",
 ]);
 /**
  * Minimal YAML frontmatter parser — handles scalars and arrays (inline [a, b]
@@ -682,174 +699,12 @@ export function deriveSourceAgent(skillDir, root, origin) {
     }
     return null;
 }
-/**
- * 0770 — Pure regex parser. Normalizes any github.com origin remote
- * (SSH, HTTPS, ssh://) to its canonical `https://github.com/owner/repo`
- * form (no `.git` suffix, no trailing path). Returns null for non-github
- * hosts, malformed input, empty/whitespace strings.
- */
-export function parseGithubRemote(remote) {
-    const trimmed = (remote ?? "").trim();
-    if (!trimmed)
-        return null;
-    // SSH: git@github.com:owner/repo[.git]
-    let m = /^git@github\.com:([^/\s]+)\/([^/\s]+?)(?:\.git)?$/.exec(trimmed);
-    if (m)
-        return `https://github.com/${m[1]}/${m[2]}`;
-    // ssh://git@github.com/owner/repo[.git]
-    m = /^ssh:\/\/git@github\.com\/([^/\s]+)\/([^/\s]+?)(?:\.git)?$/.exec(trimmed);
-    if (m)
-        return `https://github.com/${m[1]}/${m[2]}`;
-    // http(s)://github.com/owner/repo[.git][/...]
-    m = /^https?:\/\/github\.com\/([^/\s]+)\/([^/\s?#]+?)(?:\.git)?(?:[/?#].*)?$/.exec(trimmed);
-    if (m)
-        return `https://github.com/${m[1]}/${m[2]}`;
-    return null;
-}
-/**
- * 0770 — Walk parent directories from `startDir` looking for a `.git` entry
- * (directory OR file — git worktrees use a `.git` file). Bails at the
- * filesystem root or after `maxLevels` iterations. Returns the absolute
- * path of the discovered git root, or null.
- */
-export function walkUpForGitRoot(startDir, maxLevels = 12) {
-    let current = resolve(startDir);
-    for (let i = 0; i < maxLevels; i++) {
-        if (existsSync(join(current, ".git")))
-            return current;
-        const parent = dirname(current);
-        if (parent === current)
-            return null;
-        current = parent;
-    }
-    return null;
-}
-const authoredSourceLinkCache = new Map();
-/**
- * 0770 — Test-only helper to clear the module-level memoization cache so
- * tests can isolate detection runs across `beforeEach`.
- */
-export function resetAuthoredSourceLinkCache() {
-    authoredSourceLinkCache.clear();
-}
-/**
- * 0770 — Detect source-repo provenance for a locally-authored skill (no
- * lockfile entry). Walks for `.git`, reads `origin` remote, normalizes via
- * `parseGithubRemote`, and computes `skillPath` from `git ls-files` (with a
- * filesystem fallback for untracked SKILL.md files). Memoized per absolute
- * skill dir for the eval-server process lifetime.
- *
- * All git invocations use `execFileSync` with explicit argv (no shell), a
- * 1500ms hard timeout, and silenced stderr. Any error converts to
- * `{null, null}` — `buildSkillMetadata` never throws because of git.
- */
-export function detectAuthoredSourceLink(skillDir) {
-    const absDir = resolve(skillDir);
-    const cached = authoredSourceLinkCache.get(absDir);
-    if (cached)
-        return cached;
-    const compute = () => {
-        const gitRoot = walkUpForGitRoot(absDir);
-        if (!gitRoot)
-            return { repoUrl: null, skillPath: null };
-        let remote = "";
-        try {
-            remote = execFileSync("git", ["config", "--get", "remote.origin.url"], {
-                cwd: gitRoot,
-                timeout: 1500,
-                stdio: ["ignore", "pipe", "ignore"],
-                encoding: "utf-8",
-            }).trim();
-        }
-        catch {
-            return { repoUrl: null, skillPath: null };
-        }
-        const repoUrl = parseGithubRemote(remote);
-        if (!repoUrl)
-            return { repoUrl: null, skillPath: null };
-        let skillPath = null;
-        try {
-            const tracked = execFileSync("git", ["ls-files", "--full-name", "SKILL.md"], {
-                cwd: absDir,
-                timeout: 1500,
-                stdio: ["ignore", "pipe", "ignore"],
-                encoding: "utf-8",
-            }).trim();
-            if (tracked)
-                skillPath = tracked;
-        }
-        catch {
-            // fall through to filesystem fallback
-        }
-        if (!skillPath) {
-            // Filesystem fallback for untracked SKILL.md — same path the file will
-            // have on github.com once committed and pushed.
-            skillPath = relative(gitRoot, join(absDir, "SKILL.md")).replace(/\\/g, "/");
-        }
-        return { repoUrl, skillPath };
-    };
-    const result = compute();
-    authoredSourceLinkCache.set(absDir, result);
-    return result;
-}
-/**
- * 0737 — Resolve the source-repo provenance (repoUrl + skillPath) for a
- * skill by looking up its lockfile entry. Two precedences:
- *   1. Explicit `sourceRepoUrl` / `sourceSkillPath` (set by `vskill install`
- *      after this change ships).
- *   2. Legacy `source: github:owner/repo` string (every existing install).
- *
- * Lockfile entries are keyed by plugin name; for nested-layout plugins the
- * skill dir basename and the lockfile key differ — fall back to the parent
- * directory's basename when no exact match exists.
- *
- * 0770 — When no lockfile entry resolves provenance, fall through to
- * `detectAuthoredSourceLink` which inspects the parent git repo's origin
- * remote. Lockfile-derived values still take precedence to preserve
- * install-time provenance when the workspace itself is a git repo.
- */
-function resolveSourceLink(skillDir, root) {
-    const lock = readLockfile(root);
-    if (!lock)
-        return detectAuthoredSourceLink(skillDir);
-    const skillName = basename(skillDir);
-    const parentName = basename(dirname(skillDir));
-    const entry = lock.skills[skillName] ?? lock.skills[parentName];
-    if (!entry)
-        return detectAuthoredSourceLink(skillDir);
-    if (entry.sourceRepoUrl) {
-        return {
-            repoUrl: entry.sourceRepoUrl,
-            skillPath: entry.sourceSkillPath ?? "SKILL.md",
-        };
-    }
-    // Legacy derivation from `source: github:owner/repo`.
-    // 0743: We DO NOT blindly default `skillPath` to "SKILL.md" here. Multi-skill
-    // repos (vskill, marketingskills, etc.) hold the SKILL.md under a nested
-    // path, and the legacy `source` string carries no path information.
-    // Guessing "SKILL.md" produced confidently-wrong 404 anchors for every
-    // install from a multi-skill repo.
-    //
-    // 0773 hotfix: when the matched lockfile entry KEY equals the source repo
-    // basename (i.e. `vskill install anton-abyzov/greet-anton` keys the entry
-    // as `greet-anton` AND the repo is `greet-anton`), the repo IS the skill —
-    // SKILL.md sits at the repo root. Defaulting skillPath to "SKILL.md" in
-    // that exact shape restores the working SourceFileLink anchor for
-    // single-skill repos without re-introducing 404s for multi-skill repos.
-    const m = /^github:([^/]+)\/([^/#]+)/.exec(entry.source ?? "");
-    // 0770: do NOT fall through here — an installed skill with a non-github
-    // `source` (e.g. `marketplace:...`) is still installed, not authored. Local
-    // git detection would leak the workspace remote (umbrella, etc.).
-    if (!m)
-        return { repoUrl: null, skillPath: null };
-    const repoBasename = m[2];
-    const lockKey = lock.skills[skillName] ? skillName : parentName;
-    const isSingleSkillRepo = repoBasename === lockKey;
-    return {
-        repoUrl: `https://github.com/${m[1]}/${m[2]}`,
-        skillPath: entry.sourceSkillPath ?? (isSingleSkillRepo ? "SKILL.md" : null),
-    };
-}
+// 0809: parseGithubRemote, walkUpForGitRoot, detectAuthoredSourceLink,
+// resolveSourceLink, and the authored-source-link cache live in
+// `./source-link.ts`. Imported + re-exported here for backwards compatibility
+// with existing consumers (`./skill-create-routes.ts`, the 0770 test file).
+import { parseGithubRemote, walkUpForGitRoot, detectAuthoredSourceLink, resolveSourceLink, readCopiedSkillSidecar, resetAuthoredSourceLinkCache, resetCopiedSkillSidecarCache, } from "./source-link.js";
+export { parseGithubRemote, walkUpForGitRoot, detectAuthoredSourceLink, resolveSourceLink, readCopiedSkillSidecar, resetAuthoredSourceLinkCache, resetCopiedSkillSidecarCache, };
 /**
  * Build the T-025 metadata payload for a single skill. Reads SKILL.md from
  * disk if present; returns EMPTY_METADATA on any error so the /api/skills
@@ -878,6 +733,24 @@ export function buildSkillMetadata(skillDir, origin, root) {
     const deps = toStringArrayOrNull(fm["skill-deps"] ?? fm.skillDeps ?? fm.deps);
     const mcpDeps = toStringArrayOrNull(fm["mcp-deps"] ?? fm.mcpDeps ?? fm.mcpDependencies);
     const tags = toStringArrayOrNull(fm.tags);
+    // 0815: assemble runtime + integrationTests from flat fields. Secrets stays
+    // a string[] (env-var names); purposes live in the skill's `.env.example`.
+    const secrets = toStringArrayOrNull(fm.secrets);
+    const runtimePython = toStringOrNull(fm["runtime-python"] ?? fm.runtimePython);
+    const runtimePip = toStringArrayOrNull(fm["runtime-pip"] ?? fm.runtimePip);
+    const runtimeNode = toStringOrNull(fm["runtime-node"] ?? fm.runtimeNode);
+    const runtime = runtimePython || runtimePip || runtimeNode
+        ? { python: runtimePython, pip: runtimePip, node: runtimeNode }
+        : null;
+    const rawRunner = toStringOrNull(fm["integration-runner"] ?? fm.integrationRunner);
+    const integrationRunner = rawRunner === "vitest" || rawRunner === "pytest" || rawRunner === "none"
+        ? rawRunner
+        : null;
+    const integrationFile = toStringOrNull(fm["integration-file"] ?? fm.integrationFile);
+    const integrationRequires = toStringArrayOrNull(fm["integration-requires"] ?? fm.integrationRequires);
+    const integrationTests = integrationRunner
+        ? { runner: integrationRunner, file: integrationFile, requires: integrationRequires }
+        : null;
     return {
         description: toStringOrNull(fm.description),
         version: toStringOrNull(fm.version),
@@ -894,6 +767,9 @@ export function buildSkillMetadata(skillDir, origin, root) {
         sourceAgent: deriveSourceAgent(skillDir, root, origin),
         repoUrl: sourceLink.repoUrl,
         skillPath: sourceLink.skillPath,
+        secrets,
+        runtime,
+        integrationTests,
     };
 }
 // ---------------------------------------------------------------------------