@evalops/maestro 0.10.51 → 0.10.53

package/dist/skills/runtime-activation.js

@@ -1,227 +0,0 @@
-import { constants, accessSync, existsSync, readFileSync, readdirSync, statSync, } from "node:fs";
-import { join } from "node:path";
-import { isRecord } from "../utils/json.js";
-import { isWindowsRunnableToolboxEntry } from "./linter.js";
-const MAX_MCP_JSON_BYTES = 1024 * 1024;
-function isDirectory(path) {
-    if (!path || !existsSync(path)) {
-        return false;
-    }
-    try {
-        return statSync(path).isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-function isFile(path) {
-    if (!path || !existsSync(path)) {
-        return false;
-    }
-    try {
-        return statSync(path).isFile();
-    }
-    catch {
-        return false;
-    }
-}
-function nonEmptyString(value) {
-    return typeof value === "string" && value.trim().length > 0
-        ? value.trim()
-        : undefined;
-}
-function nonEmptyStringList(value) {
-    if (!Array.isArray(value)) {
-        return { status: "missing", values: [] };
-    }
-    const values = [];
-    for (const entry of value) {
-        const normalized = nonEmptyString(entry);
-        if (!normalized) {
-            return { status: "invalid", values: [] };
-        }
-        values.push(normalized);
-    }
-    return { status: "valid", values };
-}
-function isRunnableFile(path, platform = process.platform) {
-    if (!isFile(path)) {
-        return false;
-    }
-    if (platform === "win32") {
-        return isWindowsRunnableToolboxEntry(path);
-    }
-    try {
-        accessSync(path, constants.X_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function buildResourceDirectories(skill) {
-    return {
-        ...(skill.resourceDirs.scriptsDir
-            ? { scripts: skill.resourceDirs.scriptsDir }
-            : {}),
-        ...(skill.resourceDirs.referenceDir
-            ? { reference: skill.resourceDirs.referenceDir }
-            : {}),
-        ...(skill.resourceDirs.referencesDir
-            ? { references: skill.resourceDirs.referencesDir }
-            : {}),
-        ...(skill.resourceDirs.assetsDir
-            ? { assets: skill.resourceDirs.assetsDir }
-            : {}),
-        ...(skill.resourceDirs.toolboxDir
-            ? { toolbox: skill.resourceDirs.toolboxDir }
-            : {}),
-    };
-}
-function buildToolboxActivation(toolboxDir, options = {}) {
-    if (!isDirectory(toolboxDir)) {
-        return undefined;
-    }
-    let directoryEntries;
-    try {
-        directoryEntries = readdirSync(toolboxDir);
-    }
-    catch (error) {
-        return {
-            directory: toolboxDir,
-            entries: [],
-            warnings: [`toolbox directory could not be read: ${errorMessage(error)}`],
-        };
-    }
-    const entries = directoryEntries
-        .filter((entry) => !entry.startsWith(".") && entry.toLowerCase() !== "readme.md")
-        .map((entry) => ({ name: entry, path: join(toolboxDir, entry) }))
-        .filter((entry) => isRunnableFile(entry.path, options.platform ?? process.platform))
-        .sort((left, right) => left.name.localeCompare(right.name));
-    return {
-        directory: toolboxDir,
-        entries,
-    };
-}
-function buildMcpActivation(mcpJsonPath) {
-    if (!isFile(mcpJsonPath)) {
-        return undefined;
-    }
-    const warnings = [];
-    let stats;
-    try {
-        stats = statSync(mcpJsonPath);
-    }
-    catch (error) {
-        warnings.push(`mcp.json could not be inspected: ${errorMessage(error)}`);
-        return { configPath: mcpJsonPath, servers: [], warnings };
-    }
-    if (stats.size > MAX_MCP_JSON_BYTES) {
-        warnings.push(`mcp.json is too large to load: ${stats.size} bytes exceeds ${MAX_MCP_JSON_BYTES} byte limit.`);
-        return { configPath: mcpJsonPath, servers: [], warnings };
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(readFileSync(mcpJsonPath, "utf8"));
-    }
-    catch (error) {
-        warnings.push(`mcp.json could not be parsed: ${errorMessage(error)}`);
-        return { configPath: mcpJsonPath, servers: [], warnings };
-    }
-    if (!isRecord(parsed)) {
-        return {
-            configPath: mcpJsonPath,
-            servers: [],
-            warnings: ["mcp.json must be an object keyed by server name."],
-        };
-    }
-    const servers = [];
-    for (const [name, server] of Object.entries(parsed).sort(([left], [right]) => left.localeCompare(right))) {
-        if (!isRecord(server)) {
-            warnings.push(`MCP server '${name}' must be an object.`);
-            continue;
-        }
-        const command = nonEmptyString(server.command);
-        if (!command) {
-            warnings.push(`MCP server '${name}' requires a non-empty command.`);
-            continue;
-        }
-        const includeTools = nonEmptyStringList(server.includeTools);
-        if (includeTools.status === "invalid") {
-            warnings.push(`MCP server '${name}' includeTools entries must be non-empty strings.`);
-            continue;
-        }
-        if (includeTools.status === "missing" || includeTools.values.length === 0) {
-            warnings.push(`MCP server '${name}' does not declare bounded includeTools.`);
-            continue;
-        }
-        if (server.args !== undefined &&
-            (!Array.isArray(server.args) ||
-                server.args.some((arg) => typeof arg !== "string"))) {
-            warnings.push(`MCP server '${name}' args entries must be strings.`);
-            continue;
-        }
-        if (server.env !== undefined &&
-            (!isRecord(server.env) ||
-                Object.values(server.env).some((value) => typeof value !== "string"))) {
-            warnings.push(`MCP server '${name}' env values must be strings.`);
-            continue;
-        }
-        servers.push({
-            name,
-            command,
-            includeTools: includeTools.values,
-        });
-    }
-    return {
-        configPath: mcpJsonPath,
-        servers,
-        ...(warnings.length > 0 ? { warnings } : {}),
-    };
-}
-/**
- * Build the runtime-facing activation contract for a loaded skill.
- *
- * This intentionally exposes only scoped resource paths and MCP tool bounds. The
- * raw MCP config remains on disk so runtimes can activate it without copying env
- * values or credentials into agent-visible telemetry.
- */
-export function buildSkillRuntimeActivation(skill, options = {}) {
-    const toolbox = buildToolboxActivation(skill.resourceDirs.toolboxDir, options);
-    const mcp = buildMcpActivation(skill.resourceDirs.mcpJsonPath);
-    return {
-        name: skill.name,
-        contentSha: skill.contentSha,
-        source: skill.sourceType,
-        ...(skill.sourcePath ? { sourcePath: skill.sourcePath } : {}),
-        profile: {
-            ...(skill.argumentHint ? { argumentHint: skill.argumentHint } : {}),
-            ...(skill.compatibility ? { compatibility: skill.compatibility } : {}),
-            ...(skill.isolatedContext !== undefined
-                ? { isolatedContext: skill.isolatedContext }
-                : {}),
-            ...(skill.mode ? { mode: skill.mode } : {}),
-            ...(skill.model ? { model: skill.model } : {}),
-        },
-        tools: {
-            allowed: [...(skill.allowedTools ?? [])],
-            builtin: [...(skill.builtinTools ?? [])],
-        },
-        resources: {
-            files: skill.resources.map((resource) => ({
-                name: resource.name,
-                path: resource.path,
-                type: resource.type,
-            })),
-            directories: buildResourceDirectories(skill),
-        },
-        toolPackage: {
-            ...(toolbox ? { toolbox } : {}),
-            ...(mcp ? { mcp } : {}),
-        },
-    };
-}
-//# sourceMappingURL=runtime-activation.js.map

package/dist/skills/runtime-activation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-activation.js","sourceRoot":"","sources":["../../src/skills/runtime-activation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tconstants,\n\taccessSync,\n\texistsSync,\n\treadFileSync,\n\treaddirSync,\n\tstatSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\nimport { isRecord } from \"../utils/json.js\";\nimport { isWindowsRunnableToolboxEntry } from \"./linter.js\";\nimport type { LoadedSkill, SkillResource } from \"./loader.js\";\n\nconst MAX_MCP_JSON_BYTES = 1024 * 1024;\n\nexport interface SkillRuntimeActivation {\n\tname: string;\n\tcontentSha: string;\n\tsource: LoadedSkill[\"sourceType\"];\n\tsourcePath?: string;\n\tprofile: {\n\t\targumentHint?: string;\n\t\tcompatibility?: string;\n\t\tisolatedContext?: boolean;\n\t\tmode?: string;\n\t\tmodel?: string;\n\t};\n\ttools: {\n\t\tallowed: string[];\n\t\tbuiltin: string[];\n\t};\n\tresources: {\n\t\tfiles: SkillRuntimeResource[];\n\t\tdirectories: SkillRuntimeResourceDirectories;\n\t};\n\ttoolPackage: {\n\t\ttoolbox?: SkillRuntimeToolboxActivation;\n\t\tmcp?: SkillRuntimeMcpActivation;\n\t};\n}\n\nexport interface SkillRuntimeResource {\n\tname: string;\n\tpath: string;\n\ttype: SkillResource[\"type\"];\n}\n\nexport interface SkillRuntimeResourceDirectories {\n\tscripts?: string;\n\treference?: string;\n\treferences?: string;\n\tassets?: string;\n\ttoolbox?: string;\n}\n\nexport interface SkillRuntimeToolboxActivation {\n\tdirectory: string;\n\tentries: SkillRuntimeToolboxEntry[];\n\twarnings?: string[];\n}\n\nexport interface SkillRuntimeToolboxEntry {\n\tname: string;\n\tpath: string;\n}\n\nexport interface SkillRuntimeMcpActivation {\n\tconfigPath: string;\n\tservers: SkillRuntimeMcpServer[];\n\twarnings?: string[];\n}\n\nexport interface SkillRuntimeMcpServer {\n\tname: string;\n\tcommand: string;\n\tincludeTools: string[];\n}\n\nexport interface SkillRuntimeActivationOptions {\n\tplatform?: NodeJS.Platform;\n}\n\nfunction isDirectory(path: string | undefined): path is string {\n\tif (!path || !existsSync(path)) {\n\t\treturn false;\n\t}\n\ttry {\n\t\treturn statSync(path).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isFile(path: string | undefined): path is string {\n\tif (!path || !existsSync(path)) {\n\t\treturn false;\n\t}\n\ttry {\n\t\treturn statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n\treturn typeof value === \"string\" && value.trim().length > 0\n\t\t? value.trim()\n\t\t: undefined;\n}\n\ntype StringListParseResult =\n\t| { status: \"valid\"; values: string[] }\n\t| { status: \"missing\"; values: [] }\n\t| { status: \"invalid\"; values: [] };\n\nfunction nonEmptyStringList(value: unknown): StringListParseResult {\n\tif (!Array.isArray(value)) {\n\t\treturn { status: \"missing\", values: [] };\n\t}\n\tconst values: string[] = [];\n\tfor (const entry of value) {\n\t\tconst normalized = nonEmptyString(entry);\n\t\tif (!normalized) {\n\t\t\treturn { status: \"invalid\", values: [] };\n\t\t}\n\t\tvalues.push(normalized);\n\t}\n\treturn { status: \"valid\", values };\n}\n\nfunction isRunnableFile(\n\tpath: string | undefined,\n\tplatform: NodeJS.Platform = process.platform,\n): path is string {\n\tif (!isFile(path)) {\n\t\treturn false;\n\t}\n\tif (platform === \"win32\") {\n\t\treturn isWindowsRunnableToolboxEntry(path);\n\t}\n\ttry {\n\t\taccessSync(path, constants.X_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction errorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n\nfunction buildResourceDirectories(\n\tskill: LoadedSkill,\n): SkillRuntimeResourceDirectories {\n\treturn {\n\t\t...(skill.resourceDirs.scriptsDir\n\t\t\t? { scripts: skill.resourceDirs.scriptsDir }\n\t\t\t: {}),\n\t\t...(skill.resourceDirs.referenceDir\n\t\t\t? { reference: skill.resourceDirs.referenceDir }\n\t\t\t: {}),\n\t\t...(skill.resourceDirs.referencesDir\n\t\t\t? { references: skill.resourceDirs.referencesDir }\n\t\t\t: {}),\n\t\t...(skill.resourceDirs.assetsDir\n\t\t\t? { assets: skill.resourceDirs.assetsDir }\n\t\t\t: {}),\n\t\t...(skill.resourceDirs.toolboxDir\n\t\t\t? { toolbox: skill.resourceDirs.toolboxDir }\n\t\t\t: {}),\n\t};\n}\n\nfunction buildToolboxActivation(\n\ttoolboxDir: string | undefined,\n\toptions: SkillRuntimeActivationOptions = {},\n): SkillRuntimeToolboxActivation | undefined {\n\tif (!isDirectory(toolboxDir)) {\n\t\treturn undefined;\n\t}\n\tlet directoryEntries: string[];\n\ttry {\n\t\tdirectoryEntries = readdirSync(toolboxDir);\n\t} catch (error) {\n\t\treturn {\n\t\t\tdirectory: toolboxDir,\n\t\t\tentries: [],\n\t\t\twarnings: [`toolbox directory could not be read: ${errorMessage(error)}`],\n\t\t};\n\t}\n\tconst entries = directoryEntries\n\t\t.filter(\n\t\t\t(entry) => !entry.startsWith(\".\") && entry.toLowerCase() !== \"readme.md\",\n\t\t)\n\t\t.map((entry) => ({ name: entry, path: join(toolboxDir, entry) }))\n\t\t.filter((entry) =>\n\t\t\tisRunnableFile(entry.path, options.platform ?? process.platform),\n\t\t)\n\t\t.sort((left, right) => left.name.localeCompare(right.name));\n\n\treturn {\n\t\tdirectory: toolboxDir,\n\t\tentries,\n\t};\n}\n\nfunction buildMcpActivation(\n\tmcpJsonPath: string | undefined,\n): SkillRuntimeMcpActivation | undefined {\n\tif (!isFile(mcpJsonPath)) {\n\t\treturn undefined;\n\t}\n\n\tconst warnings: string[] = [];\n\tlet stats: ReturnType<typeof statSync>;\n\ttry {\n\t\tstats = statSync(mcpJsonPath);\n\t} catch (error) {\n\t\twarnings.push(`mcp.json could not be inspected: ${errorMessage(error)}`);\n\t\treturn { configPath: mcpJsonPath, servers: [], warnings };\n\t}\n\tif (stats.size > MAX_MCP_JSON_BYTES) {\n\t\twarnings.push(\n\t\t\t`mcp.json is too large to load: ${stats.size} bytes exceeds ${MAX_MCP_JSON_BYTES} byte limit.`,\n\t\t);\n\t\treturn { configPath: mcpJsonPath, servers: [], warnings };\n\t}\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(readFileSync(mcpJsonPath, \"utf8\"));\n\t} catch (error) {\n\t\twarnings.push(`mcp.json could not be parsed: ${errorMessage(error)}`);\n\t\treturn { configPath: mcpJsonPath, servers: [], warnings };\n\t}\n\n\tif (!isRecord(parsed)) {\n\t\treturn {\n\t\t\tconfigPath: mcpJsonPath,\n\t\t\tservers: [],\n\t\t\twarnings: [\"mcp.json must be an object keyed by server name.\"],\n\t\t};\n\t}\n\n\tconst servers: SkillRuntimeMcpServer[] = [];\n\tfor (const [name, server] of Object.entries(parsed).sort(([left], [right]) =>\n\t\tleft.localeCompare(right),\n\t)) {\n\t\tif (!isRecord(server)) {\n\t\t\twarnings.push(`MCP server '${name}' must be an object.`);\n\t\t\tcontinue;\n\t\t}\n\t\tconst command = nonEmptyString(server.command);\n\t\tif (!command) {\n\t\t\twarnings.push(`MCP server '${name}' requires a non-empty command.`);\n\t\t\tcontinue;\n\t\t}\n\t\tconst includeTools = nonEmptyStringList(server.includeTools);\n\t\tif (includeTools.status === \"invalid\") {\n\t\t\twarnings.push(\n\t\t\t\t`MCP server '${name}' includeTools entries must be non-empty strings.`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (includeTools.status === \"missing\" || includeTools.values.length === 0) {\n\t\t\twarnings.push(\n\t\t\t\t`MCP server '${name}' does not declare bounded includeTools.`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\tserver.args !== undefined &&\n\t\t\t(!Array.isArray(server.args) ||\n\t\t\t\tserver.args.some((arg) => typeof arg !== \"string\"))\n\t\t) {\n\t\t\twarnings.push(`MCP server '${name}' args entries must be strings.`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\tserver.env !== undefined &&\n\t\t\t(!isRecord(server.env) ||\n\t\t\t\tObject.values(server.env).some((value) => typeof value !== \"string\"))\n\t\t) {\n\t\t\twarnings.push(`MCP server '${name}' env values must be strings.`);\n\t\t\tcontinue;\n\t\t}\n\t\tservers.push({\n\t\t\tname,\n\t\t\tcommand,\n\t\t\tincludeTools: includeTools.values,\n\t\t});\n\t}\n\n\treturn {\n\t\tconfigPath: mcpJsonPath,\n\t\tservers,\n\t\t...(warnings.length > 0 ? { warnings } : {}),\n\t};\n}\n\n/**\n * Build the runtime-facing activation contract for a loaded skill.\n *\n * This intentionally exposes only scoped resource paths and MCP tool bounds. The\n * raw MCP config remains on disk so runtimes can activate it without copying env\n * values or credentials into agent-visible telemetry.\n */\nexport function buildSkillRuntimeActivation(\n\tskill: LoadedSkill,\n\toptions: SkillRuntimeActivationOptions = {},\n): SkillRuntimeActivation {\n\tconst toolbox = buildToolboxActivation(\n\t\tskill.resourceDirs.toolboxDir,\n\t\toptions,\n\t);\n\tconst mcp = buildMcpActivation(skill.resourceDirs.mcpJsonPath);\n\n\treturn {\n\t\tname: skill.name,\n\t\tcontentSha: skill.contentSha,\n\t\tsource: skill.sourceType,\n\t\t...(skill.sourcePath ? { sourcePath: skill.sourcePath } : {}),\n\t\tprofile: {\n\t\t\t...(skill.argumentHint ? { argumentHint: skill.argumentHint } : {}),\n\t\t\t...(skill.compatibility ? { compatibility: skill.compatibility } : {}),\n\t\t\t...(skill.isolatedContext !== undefined\n\t\t\t\t? { isolatedContext: skill.isolatedContext }\n\t\t\t\t: {}),\n\t\t\t...(skill.mode ? { mode: skill.mode } : {}),\n\t\t\t...(skill.model ? { model: skill.model } : {}),\n\t\t},\n\t\ttools: {\n\t\t\tallowed: [...(skill.allowedTools ?? [])],\n\t\t\tbuiltin: [...(skill.builtinTools ?? [])],\n\t\t},\n\t\tresources: {\n\t\t\tfiles: skill.resources.map((resource) => ({\n\t\t\t\tname: resource.name,\n\t\t\t\tpath: resource.path,\n\t\t\t\ttype: resource.type,\n\t\t\t})),\n\t\t\tdirectories: buildResourceDirectories(skill),\n\t\t},\n\t\ttoolPackage: {\n\t\t\t...(toolbox ? { toolbox } : {}),\n\t\t\t...(mcp ? { mcp } : {}),\n\t\t},\n\t};\n}\n"]}

package/dist/skills/scaffold-from-template.d.ts

@@ -1,58 +0,0 @@
-/**
- * Skill template → scaffolder converter
- *
- * Builds on the scaffolder primitive (part 1 of #2665, merged as
- * #2674) and the skill template registry (part 2, merged as #2700).
- * Pure helper that adapts a `SkillTemplate` to the
- * `ScaffoldSkillOptions` shape `scaffoldSkillWithBody` consumes — so
- * callers (e.g. the `/setup-*` slash commands, repo-init scripts)
- * don't duplicate the field-mapping logic.
- *
- * No I/O. The actual disk write still lives in
- * `scaffoldSkillWithBody`; this module just builds the input.
- */
-import type { ScaffoldSkillOptions } from "./scaffolder.js";
-import { type SkillTemplate } from "./skill-templates.js";
-/** Options that an `/setup-*` command can override at call time. */
-export interface ScaffoldFromTemplateOverrides {
-    /** Overrides the template's `body`. Useful when the user pre-supplied content. */
-    body?: string;
-    /** Overrides the template's `description`. */
-    description?: string;
-    /** Replace the template's `allowedTools` whitelist. */
-    allowedTools?: string[];
-    /** Replace the template's `builtinTools` list. */
-    builtinTools?: string[];
-    /**
-     * Extra metadata. Merged onto the template's metadata (overrides
-     * win on key collisions). Merge instead of replace so a template
-     * can ship a default metadata block + the caller can splice extras
-     * without restating the defaults.
-     */
-    metadata?: Record<string, string>;
-    /** Overwrite an existing skill directory. Defaults to false. */
-    force?: boolean;
-}
-/** Resulting shape: name + scaffolder options ready to hand to the writer. */
-export interface ScaffoldFromTemplateResult {
-    name: string;
-    options: ScaffoldSkillOptions;
-}
-/**
- * Convert a `SkillTemplate` (plus optional overrides) into the
- * argument shape `scaffoldSkillWithBody` consumes. Pure.
- *
- * The template's `tags` field is preserved on the helper's input but
- * doesn't make it into `ScaffoldSkillOptions` (the scaffolder doesn't
- * model tags). Callers that want to record tags should add them to
- * `metadata` via the overrides.
- */
-export declare function scaffoldOptionsFromTemplate(template: SkillTemplate, overrides?: ScaffoldFromTemplateOverrides): ScaffoldFromTemplateResult;
-/**
- * Convenience: look up a template by name and convert it in one step.
- * Throws when no template matches — `/setup-foo` commands generally
- * shouldn't reach this path with an unknown name, but we surface a
- * clear error so misconfiguration is loud.
- */
-export declare function scaffoldOptionsForTemplateName(name: string, overrides?: ScaffoldFromTemplateOverrides): ScaffoldFromTemplateResult;
-//# sourceMappingURL=scaffold-from-template.d.ts.map

package/dist/skills/scaffold-from-template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scaffold-from-template.d.ts","sourceRoot":"","sources":["../../src/skills/scaffold-from-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,sBAAsB,CAAC;AAE7E,oEAAoE;AACpE,MAAM,WAAW,6BAA6B;IAC7C,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,0BAA0B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,aAAa,EACvB,SAAS,GAAE,6BAAkC,GAC3C,0BAA0B,CAiC5B;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC7C,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,6BAAkC,GAC3C,0BAA0B,CAQ5B"}

package/dist/skills/scaffold-from-template.js

@@ -1,72 +0,0 @@
-/**
- * Skill template → scaffolder converter
- *
- * Builds on the scaffolder primitive (part 1 of #2665, merged as
- * #2674) and the skill template registry (part 2, merged as #2700).
- * Pure helper that adapts a `SkillTemplate` to the
- * `ScaffoldSkillOptions` shape `scaffoldSkillWithBody` consumes — so
- * callers (e.g. the `/setup-*` slash commands, repo-init scripts)
- * don't duplicate the field-mapping logic.
- *
- * No I/O. The actual disk write still lives in
- * `scaffoldSkillWithBody`; this module just builds the input.
- */
-import { findSkillTemplate } from "./skill-templates.js";
-/**
- * Convert a `SkillTemplate` (plus optional overrides) into the
- * argument shape `scaffoldSkillWithBody` consumes. Pure.
- *
- * The template's `tags` field is preserved on the helper's input but
- * doesn't make it into `ScaffoldSkillOptions` (the scaffolder doesn't
- * model tags). Callers that want to record tags should add them to
- * `metadata` via the overrides.
- */
-export function scaffoldOptionsFromTemplate(template, overrides = {}) {
-    const description = overrides.description ?? template.description;
-    if (!description.trim()) {
-        throw new Error("scaffoldOptionsFromTemplate: description is required (template or override must supply one)");
-    }
-    const body = overrides.body ?? template.body;
-    if (!body.trim()) {
-        throw new Error("scaffoldOptionsFromTemplate: body is required (template or override must supply one)");
-    }
-    const options = {
-        description,
-        body,
-    };
-    const allowedTools = overrides.allowedTools ?? template.allowedTools;
-    if (allowedTools !== undefined) {
-        options.allowedTools = allowedTools;
-    }
-    const builtinTools = overrides.builtinTools ?? template.builtinTools;
-    if (builtinTools !== undefined) {
-        options.builtinTools = builtinTools;
-    }
-    const metadata = mergeMetadata(template.metadata, overrides.metadata);
-    if (metadata !== undefined) {
-        options.metadata = metadata;
-    }
-    if (overrides.force !== undefined) {
-        options.force = overrides.force;
-    }
-    return { name: template.name, options };
-}
-/**
- * Convenience: look up a template by name and convert it in one step.
- * Throws when no template matches — `/setup-foo` commands generally
- * shouldn't reach this path with an unknown name, but we surface a
- * clear error so misconfiguration is loud.
- */
-export function scaffoldOptionsForTemplateName(name, overrides = {}) {
-    const template = findSkillTemplate(name);
-    if (!template) {
-        throw new Error(`scaffoldOptionsForTemplateName: no template named "${name}" in the canonical registry`);
-    }
-    return scaffoldOptionsFromTemplate(template, overrides);
-}
-function mergeMetadata(base, overrides) {
-    if (!base && !overrides)
-        return undefined;
-    return { ...(base ?? {}), ...(overrides ?? {}) };
-}
-//# sourceMappingURL=scaffold-from-template.js.map

package/dist/skills/scaffold-from-template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scaffold-from-template.js","sourceRoot":"","sources":["../../src/skills/scaffold-from-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAsB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA6B7E;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CAC1C,QAAuB,EACvB,YAA2C,EAAE;IAE7C,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC;IAClE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACd,6FAA6F,CAC7F,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC;IAC7C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACd,sFAAsF,CACtF,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAyB;QACrC,WAAW;QACX,IAAI;KACJ,CAAC;IACF,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC;IACrE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;IACD,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC;IACrE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;IACD,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAC7C,IAAY,EACZ,YAA2C,EAAE;IAE7C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,sDAAsD,IAAI,6BAA6B,CACvF,CAAC;IACH,CAAC;IACD,OAAO,2BAA2B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,aAAa,CACrB,IAAwC,EACxC,SAA6C;IAE7C,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;AAClD,CAAC","sourcesContent":["/**\n * Skill template → scaffolder converter\n *\n * Builds on the scaffolder primitive (part 1 of #2665, merged as\n * #2674) and the skill template registry (part 2, merged as #2700).\n * Pure helper that adapts a `SkillTemplate` to the\n * `ScaffoldSkillOptions` shape `scaffoldSkillWithBody` consumes — so\n * callers (e.g. the `/setup-*` slash commands, repo-init scripts)\n * don't duplicate the field-mapping logic.\n *\n * No I/O. The actual disk write still lives in\n * `scaffoldSkillWithBody`; this module just builds the input.\n */\n\nimport type { ScaffoldSkillOptions } from \"./scaffolder.js\";\nimport { type SkillTemplate, findSkillTemplate } from \"./skill-templates.js\";\n\n/** Options that an `/setup-*` command can override at call time. */\nexport interface ScaffoldFromTemplateOverrides {\n\t/** Overrides the template's `body`. Useful when the user pre-supplied content. */\n\tbody?: string;\n\t/** Overrides the template's `description`. */\n\tdescription?: string;\n\t/** Replace the template's `allowedTools` whitelist. */\n\tallowedTools?: string[];\n\t/** Replace the template's `builtinTools` list. */\n\tbuiltinTools?: string[];\n\t/**\n\t * Extra metadata. Merged onto the template's metadata (overrides\n\t * win on key collisions). Merge instead of replace so a template\n\t * can ship a default metadata block + the caller can splice extras\n\t * without restating the defaults.\n\t */\n\tmetadata?: Record<string, string>;\n\t/** Overwrite an existing skill directory. Defaults to false. */\n\tforce?: boolean;\n}\n\n/** Resulting shape: name + scaffolder options ready to hand to the writer. */\nexport interface ScaffoldFromTemplateResult {\n\tname: string;\n\toptions: ScaffoldSkillOptions;\n}\n\n/**\n * Convert a `SkillTemplate` (plus optional overrides) into the\n * argument shape `scaffoldSkillWithBody` consumes. Pure.\n *\n * The template's `tags` field is preserved on the helper's input but\n * doesn't make it into `ScaffoldSkillOptions` (the scaffolder doesn't\n * model tags). Callers that want to record tags should add them to\n * `metadata` via the overrides.\n */\nexport function scaffoldOptionsFromTemplate(\n\ttemplate: SkillTemplate,\n\toverrides: ScaffoldFromTemplateOverrides = {},\n): ScaffoldFromTemplateResult {\n\tconst description = overrides.description ?? template.description;\n\tif (!description.trim()) {\n\t\tthrow new Error(\n\t\t\t\"scaffoldOptionsFromTemplate: description is required (template or override must supply one)\",\n\t\t);\n\t}\n\tconst body = overrides.body ?? template.body;\n\tif (!body.trim()) {\n\t\tthrow new Error(\n\t\t\t\"scaffoldOptionsFromTemplate: body is required (template or override must supply one)\",\n\t\t);\n\t}\n\tconst options: ScaffoldSkillOptions = {\n\t\tdescription,\n\t\tbody,\n\t};\n\tconst allowedTools = overrides.allowedTools ?? template.allowedTools;\n\tif (allowedTools !== undefined) {\n\t\toptions.allowedTools = allowedTools;\n\t}\n\tconst builtinTools = overrides.builtinTools ?? template.builtinTools;\n\tif (builtinTools !== undefined) {\n\t\toptions.builtinTools = builtinTools;\n\t}\n\tconst metadata = mergeMetadata(template.metadata, overrides.metadata);\n\tif (metadata !== undefined) {\n\t\toptions.metadata = metadata;\n\t}\n\tif (overrides.force !== undefined) {\n\t\toptions.force = overrides.force;\n\t}\n\treturn { name: template.name, options };\n}\n\n/**\n * Convenience: look up a template by name and convert it in one step.\n * Throws when no template matches — `/setup-foo` commands generally\n * shouldn't reach this path with an unknown name, but we surface a\n * clear error so misconfiguration is loud.\n */\nexport function scaffoldOptionsForTemplateName(\n\tname: string,\n\toverrides: ScaffoldFromTemplateOverrides = {},\n): ScaffoldFromTemplateResult {\n\tconst template = findSkillTemplate(name);\n\tif (!template) {\n\t\tthrow new Error(\n\t\t\t`scaffoldOptionsForTemplateName: no template named \"${name}\" in the canonical registry`,\n\t\t);\n\t}\n\treturn scaffoldOptionsFromTemplate(template, overrides);\n}\n\nfunction mergeMetadata(\n\tbase: Record<string, string> | undefined,\n\toverrides: Record<string, string> | undefined,\n): Record<string, string> | undefined {\n\tif (!base && !overrides) return undefined;\n\treturn { ...(base ?? {}), ...(overrides ?? {}) };\n}\n"]}

package/dist/skills/scaffolder.d.ts

@@ -1,65 +0,0 @@
-/**
- * Scaffold-a-skill primitive: persist a fully-formed skill into the repo.
- *
- * The existing `scaffoldSkill` helper (in `./linter.ts`) creates an empty
- * skeleton suitable for `maestro skill new <name>`. This module solves a
- * different problem: an interactive `/setup-*` command has already
- * collected the user's answers and wants to bake them into a skill file
- * the agent will auto-load in future sessions.
- *
- * The first consumer is `/setup-incident-response` — the user names
- * their runbook location, paging policy, and severity definitions; we
- * write an `incident-guidelines` skill so the next incident-response
- * session loads those answers without re-asking.
- *
- * ## What this module is
- *
- * One primitive — `scaffoldSkillWithBody` — that:
- * - Validates the skill name against the project's skill-name pattern.
- * - Refuses to escape `baseDir` even when called with `..` or symlinks.
- * - Emits valid YAML frontmatter with the supplied description, optional
- *   tool whitelists, and free-form metadata.
- * - Writes the supplied body as the SKILL.md content.
- * - Reports back the directory, files written, and final SKILL.md path.
- *
- * ## What this module isn't
- *
- * - No interactive UI; that lives in the `/setup-*` slash commands.
- * - No round-trip parse; the rendered YAML is one-way.
- */
-export interface ScaffoldSkillOptions {
-    /** One-line description used in YAML frontmatter + skill listings. */
-    description: string;
-    /** Full markdown body (without frontmatter delimiters). */
-    body: string;
-    /** Optional `allowed-tools` whitelist serialized as a YAML list. */
-    allowedTools?: string[];
-    /** Optional `builtin-tools` list (Maestro-provided tools). */
-    builtinTools?: string[];
-    /**
-     * Additional simple key/value metadata nested under the `metadata`
-     * frontmatter field. Values are emitted as quoted YAML strings so
-     * user input can't break the frontmatter parser.
-     */
-    metadata?: Record<string, string>;
-    /** Overwrite an existing skill directory. Defaults to false. */
-    force?: boolean;
-}
-export interface ScaffoldSkillResult {
-    /** The skill name (matches the directory). */
-    name: string;
-    /** Absolute path to the skill directory. */
-    directory: string;
-    /** Absolute path to the SKILL.md inside the directory. */
-    skillMdPath: string;
-    /** Files written, relative to the skill directory. */
-    files: string[];
-}
-/**
- * Write a `SKILL.md` (with frontmatter built from `options`) into
- * `<baseDir>/<name>/SKILL.md`. Throws on name violations, path escapes,
- * or pre-existing skills when `force` is false. Caller is responsible
- * for ensuring `baseDir` is the configured skills directory.
- */
-export declare function scaffoldSkillWithBody(baseDir: string, name: string, options: ScaffoldSkillOptions): ScaffoldSkillResult;
-//# sourceMappingURL=scaffolder.d.ts.map

package/dist/skills/scaffolder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scaffolder.d.ts","sourceRoot":"","sources":["../../src/skills/scaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAkBH,MAAM,WAAW,oBAAoB;IACpC,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IACnC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC3B,mBAAmB,CA2DrB"}

package/dist/skills/scaffolder.js

@@ -1,167 +0,0 @@
-/**
- * Scaffold-a-skill primitive: persist a fully-formed skill into the repo.
- *
- * The existing `scaffoldSkill` helper (in `./linter.ts`) creates an empty
- * skeleton suitable for `maestro skill new <name>`. This module solves a
- * different problem: an interactive `/setup-*` command has already
- * collected the user's answers and wants to bake them into a skill file
- * the agent will auto-load in future sessions.
- *
- * The first consumer is `/setup-incident-response` — the user names
- * their runbook location, paging policy, and severity definitions; we
- * write an `incident-guidelines` skill so the next incident-response
- * session loads those answers without re-asking.
- *
- * ## What this module is
- *
- * One primitive — `scaffoldSkillWithBody` — that:
- * - Validates the skill name against the project's skill-name pattern.
- * - Refuses to escape `baseDir` even when called with `..` or symlinks.
- * - Emits valid YAML frontmatter with the supplied description, optional
- *   tool whitelists, and free-form metadata.
- * - Writes the supplied body as the SKILL.md content.
- * - Reports back the directory, files written, and final SKILL.md path.
- *
- * ## What this module isn't
- *
- * - No interactive UI; that lives in the `/setup-*` slash commands.
- * - No round-trip parse; the rendered YAML is one-way.
- */
-import { existsSync, mkdirSync } from "node:fs";
-import { join, resolve, sep } from "node:path";
-import { writeTextFileAtomic } from "../utils/fs.js";
-import { createLogger } from "../utils/logger.js";
-const logger = createLogger("skills:scaffolder");
-/**
- * Same pattern as the existing skill linter: lowercase, digits, single
- * hyphens between words. Kept in sync rather than imported so callers
- * who pull just this module don't drag the linter in.
- */
-const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-const SKILL_NAME_MAX_LENGTH = 64;
-const SKILL_DESCRIPTION_MAX_LENGTH = 1024;
-/**
- * Write a `SKILL.md` (with frontmatter built from `options`) into
- * `<baseDir>/<name>/SKILL.md`. Throws on name violations, path escapes,
- * or pre-existing skills when `force` is false. Caller is responsible
- * for ensuring `baseDir` is the configured skills directory.
- */
-export function scaffoldSkillWithBody(baseDir, name, options) {
-    if (!SKILL_NAME_PATTERN.test(name)) {
-        throw new Error(`Skill name "${name}" must use lowercase letters, numbers, and single hyphens between words`);
-    }
-    if (name.length > SKILL_NAME_MAX_LENGTH) {
-        throw new Error(`Skill name "${name}" exceeds the ${SKILL_NAME_MAX_LENGTH}-character limit`);
-    }
-    const description = options.description.trim();
-    if (!description) {
-        throw new Error("Skill description is required");
-    }
-    // Match the skill loader's frontmatter cap. Scaffolding a longer
-    // description would persist a SKILL.md the loader rejects with
-    // invalid-description even though the scaffold succeeded.
-    if (description.length > SKILL_DESCRIPTION_MAX_LENGTH) {
-        throw new Error(`Skill description exceeds the ${SKILL_DESCRIPTION_MAX_LENGTH}-character limit (got ${description.length})`);
-    }
-    const body = options.body;
-    if (!body || !body.trim()) {
-        throw new Error("Skill body is required");
-    }
-    const directory = resolve(baseDir, name);
-    if (!isPathWithinDirectory(directory, baseDir)) {
-        // Defensive: SKILL_NAME_PATTERN already rejects "..", "/", "\", but
-        // keep the explicit check so caller-supplied baseDir can't accidentally
-        // resolve outside itself via symlinks or other path tricks.
-        throw new Error(`Refusing to scaffold skill "${name}" outside the configured skills directory`);
-    }
-    if (existsSync(directory) && !options.force) {
-        throw new Error(`Skill "${name}" already exists at ${directory}; pass force: true to overwrite`);
-    }
-    const skillMdPath = join(directory, "SKILL.md");
-    const content = renderSkillMarkdown(name, description, body, options);
-    mkdirSync(directory, { recursive: true });
-    writeTextFileAtomic(skillMdPath, content);
-    logger.info("Scaffolded skill", {
-        name,
-        directory,
-        bodyLength: body.length,
-    });
-    return {
-        name,
-        directory,
-        skillMdPath,
-        files: ["SKILL.md"],
-    };
-}
-function renderSkillMarkdown(name, description, body, options) {
-    // Quote name even though SKILL_NAME_PATTERN restricts the character set:
-    // YAML 1.1 still interprets unquoted "true", "false", "null", "yes", "no",
-    // "off", and numeric-shaped strings as booleans/null/numbers, so the
-    // loader would reject scaffolds named e.g. "true".
-    const lines = ["---", `name: ${quoteYamlString(name)}`];
-    lines.push(`description: ${quoteYamlString(description)}`);
-    if (options.allowedTools && options.allowedTools.length > 0) {
-        assertNonEmptyToolEntries("allowed-tools", options.allowedTools);
-        lines.push("allowed-tools:");
-        for (const tool of options.allowedTools) {
-            lines.push(`  - ${quoteYamlString(tool)}`);
-        }
-    }
-    if (options.builtinTools && options.builtinTools.length > 0) {
-        assertNonEmptyToolEntries("builtin-tools", options.builtinTools);
-        lines.push("builtin-tools:");
-        for (const tool of options.builtinTools) {
-            lines.push(`  - ${quoteYamlString(tool)}`);
-        }
-    }
-    const metadataEntries = options.metadata
-        ? Object.entries(options.metadata)
-        : [];
-    if (metadataEntries.length > 0) {
-        lines.push("metadata:");
-        for (const [key, value] of metadataEntries) {
-            if (!isValidFrontmatterKey(key)) {
-                throw new Error(`Skill frontmatter key "${key}" must start with a lowercase letter and then use letters, numbers, hyphens, or underscores`);
-            }
-            lines.push(`  ${quoteYamlString(key)}: ${quoteYamlString(value)}`);
-        }
-    }
-    lines.push("---", "", body.trimEnd(), "");
-    return lines.join("\n");
-}
-/**
- * Emit a YAML scalar safely as a double-quoted string. We always quote
- * to dodge YAML's edge cases (booleans, numbers, leading whitespace,
- * special characters); escaping is minimal (backslashes + double quotes
- * + newlines).
- */
-function quoteYamlString(value) {
-    const escaped = value
-        .replace(/\\/g, "\\\\")
-        .replace(/"/g, '\\"')
-        .replace(/\n/g, "\\n");
-    return `"${escaped}"`;
-}
-/**
- * The skill loader rejects allowed-tools / builtin-tools entries that
- * are empty or whitespace-only via `validateStringArrayField`. Mirror
- * that contract at scaffold time so we never produce a SKILL.md the
- * loader will refuse.
- */
-function assertNonEmptyToolEntries(field, entries) {
-    for (let i = 0; i < entries.length; i += 1) {
-        const entry = entries[i];
-        if (typeof entry !== "string" || entry.trim() === "") {
-            throw new Error(`Skill ${field}[${i}] must be a non-empty string`);
-        }
-    }
-}
-function isValidFrontmatterKey(key) {
-    return /^[a-z][A-Za-z0-9_-]*$/.test(key);
-}
-function isPathWithinDirectory(candidatePath, directoryPath) {
-    const normalizedDir = `${resolve(directoryPath)}${sep}`;
-    const normalizedCandidate = resolve(candidatePath);
-    return normalizedCandidate.startsWith(normalizedDir);
-}
-//# sourceMappingURL=scaffolder.js.map