@kilnai/cli 1.0.7 → 2.0.0

package/dist/config/provider-route-candidates.js

@@ -0,0 +1,211 @@
+import { resolveGlobalDefaultModel, resolveGlobalDefaultProvider } from "./global-config.js";
+import { resolveEnvModel, resolveEnvProvider } from "./env-config.js";
+import { resolveConfiguredModelTaskSuitability } from "./model-task-suitability.js";
+export function resolveProviderRouteCandidates(input) {
+    const explicitProvider = normalizeProvider(input.flagProvider) ?? normalizeProvider(resolveEnvProvider());
+    const explicitModel = normalizeModel(input.flagModel) ?? normalizeModel(resolveEnvModel());
+    if (explicitProvider) {
+        const model = resolveCandidateModel(input.globalConfig, explicitProvider, explicitModel, {
+            useConfiguredRouteFallback: true,
+        });
+        return [{
+                provider: explicitProvider,
+                ...(model ? { model } : {}),
+            }];
+    }
+    const configuredRoutes = input.globalConfig?.routing?.routes
+        ?.map((route) => {
+        const provider = normalizeProvider(route.provider);
+        if (!provider)
+            return undefined;
+        const model = resolveCandidateModel(input.globalConfig, provider, route.model);
+        return {
+            provider,
+            ...(model ? { model } : {}),
+        };
+    })
+        .filter((candidate) => candidate !== undefined);
+    if (configuredRoutes && configuredRoutes.length > 0) {
+        return orderCandidatesForTask(dedupeCandidates(configuredRoutes), inferRouteTask({
+            text: input.taskText,
+            agentTaskAffinity: input.agentTaskAffinity,
+        }), input.globalConfig);
+    }
+    const defaultProvider = normalizeProvider(resolveGlobalDefaultProvider(input.globalConfig));
+    if (!defaultProvider) {
+        return [];
+    }
+    const candidates = [{
+            provider: defaultProvider,
+            ...(resolveGlobalDefaultModel(input.globalConfig) ? { model: resolveGlobalDefaultModel(input.globalConfig) } : {}),
+        }];
+    const fallback = normalizeProvider(input.globalConfig?.routing?.fallback);
+    if (fallback && fallback !== defaultProvider) {
+        const model = resolveCandidateModel(input.globalConfig, fallback);
+        candidates.push({
+            provider: fallback,
+            ...(model ? { model } : {}),
+        });
+    }
+    return candidates;
+}
+export function inferRouteTask(input) {
+    const agentTask = input.agentTaskAffinity?.find((task) => task.trim().length > 0);
+    if (agentTask) {
+        return agentTask;
+    }
+    const text = input.text?.toLowerCase() ?? "";
+    if (text.trim().length === 0) {
+        return undefined;
+    }
+    if (hasAny(text, [
+        "frontend",
+        "ui",
+        "ux",
+        "react",
+        "component",
+        "css",
+        "tailwind",
+        "layout",
+        "responsive",
+        "design",
+        "browser",
+    ])) {
+        return "frontend-design";
+    }
+    if (hasAny(text, [
+        "test",
+        "tests",
+        "tdd",
+        "vitest",
+        "junit",
+        "coverage",
+        "regression",
+    ])) {
+        return "test-writing";
+    }
+    if (hasAny(text, [
+        "research",
+        "latest",
+        "source",
+        "citation",
+        "benchmark",
+        "compare",
+        "analysis",
+    ])) {
+        return "research";
+    }
+    if (hasAny(text, [
+        "architecture",
+        "architectural",
+        "ddd",
+        "clean architecture",
+        "boundary",
+        "bounded context",
+        "adr",
+        "review",
+    ])) {
+        return "architecture-review";
+    }
+    if (hasAny(text, [
+        "rename",
+        "format",
+        "mechanical",
+        "boilerplate",
+        "projection",
+        "sync",
+        "bulk",
+    ])) {
+        return "mechanical-edit";
+    }
+    if (hasAny(text, [
+        "backend",
+        "api",
+        "database",
+        "postgres",
+        "spring",
+        "service",
+        "repository",
+        "endpoint",
+        "runtime",
+        "provider",
+    ])) {
+        return "backend-coding";
+    }
+    return undefined;
+}
+function orderCandidatesForTask(candidates, task, globalConfig) {
+    if (!task) {
+        return candidates;
+    }
+    return [...candidates]
+        .map((candidate, index) => ({
+        candidate,
+        index,
+        score: scoreCandidateForTask(candidate, task, globalConfig),
+    }))
+        .sort((left, right) => right.score - left.score || left.index - right.index)
+        .map((entry) => entry.candidate);
+}
+function scoreCandidateForTask(candidate, task, globalConfig) {
+    if (!candidate.model) {
+        return 10;
+    }
+    const suitability = resolveConfiguredModelTaskSuitability({
+        provider: candidate.provider,
+        model: candidate.model,
+        overrides: globalConfig?.modelTaskSuitability,
+    }).find((entry) => entry.task === task);
+    if (!suitability) {
+        return 10;
+    }
+    return taskSuitabilityScore(suitability.level) + taskSuitabilitySourceBonus(suitability.source);
+}
+function taskSuitabilityScore(level) {
+    switch (level) {
+        case "preferred":
+            return 30;
+        case "capable":
+            return 20;
+        case "limited":
+            return 0;
+    }
+}
+function taskSuitabilitySourceBonus(source) {
+    return source === "operator-override" ? 1 : 0;
+}
+function hasAny(text, needles) {
+    return needles.some((needle) => text.includes(needle));
+}
+function resolveCandidateModel(globalConfig, provider, explicitModel, options = {}) {
+    return normalizeModel(explicitModel)
+        ?? (options.useConfiguredRouteFallback ? normalizeModel(findConfiguredRouteModel(globalConfig, provider)) : undefined)
+        ?? normalizeModel(globalConfig?.models?.[provider])
+        ?? normalizeModel(globalConfig?.models?.default);
+}
+function findConfiguredRouteModel(globalConfig, provider) {
+    return globalConfig?.routing?.routes
+        ?.find((route) => normalizeProvider(route.provider) === provider)
+        ?.model;
+}
+function dedupeCandidates(candidates) {
+    const seen = new Set();
+    const deduped = [];
+    for (const candidate of candidates) {
+        const key = `${candidate.provider}\0${candidate.model ?? ""}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        deduped.push(candidate);
+    }
+    return deduped;
+}
+function normalizeProvider(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+}
+function normalizeModel(value) {
+    const normalized = value?.trim();
+    return normalized && normalized.length > 0 ? normalized : undefined;
+}
+//# sourceMappingURL=provider-route-candidates.js.map

package/dist/config/provider-route-candidates.js.map

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

package/dist/config/provider-route-candidates.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-route-candidates.test.d.ts.map

package/dist/config/provider-route-candidates.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-route-candidates.test.d.ts","sourceRoot":"","sources":["../../src/config/provider-route-candidates.test.ts"],"names":[],"mappings":""}

package/dist/config/provider-route-candidates.test.js

@@ -0,0 +1,150 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { inferRouteTask, resolveProviderRouteCandidates } from "./provider-route-candidates.js";
+describe("resolveProviderRouteCandidates", () => {
+    const originalProvider = process.env.KILN_PROVIDER;
+    const originalModel = process.env.KILN_MODEL;
+    afterEach(() => {
+        if (originalProvider === undefined) {
+            delete process.env.KILN_PROVIDER;
+        }
+        else {
+            process.env.KILN_PROVIDER = originalProvider;
+        }
+        if (originalModel === undefined) {
+            delete process.env.KILN_MODEL;
+        }
+        else {
+            process.env.KILN_MODEL = originalModel;
+        }
+    });
+    it("uses an explicit flag provider as a single authoritative route", () => {
+        const globalConfig = {
+            version: "1",
+            routing: {
+                routes: [
+                    { provider: "codex-oauth", model: "gpt-5.4-mini" },
+                    { provider: "openrouter", model: "openrouter/free" },
+                ],
+            },
+        };
+        expect(resolveProviderRouteCandidates({
+            globalConfig,
+            flagProvider: "openrouter",
+            flagModel: "qwen/qwen3-coder:free",
+        })).toEqual([
+            { provider: "openrouter", model: "qwen/qwen3-coder:free" },
+        ]);
+    });
+    it("projects ordered global provider routes with route-specific models", () => {
+        const globalConfig = {
+            version: "1",
+            routing: {
+                routes: [
+                    { provider: "codex-oauth", model: "gpt-5.4-mini" },
+                    { provider: "opencode-zen" },
+                    { provider: "opencode-zen", model: "kimi-k2.6" },
+                    { provider: "openrouter", model: "openrouter/free" },
+                    { provider: "codex" },
+                ],
+            },
+            models: {
+                "opencode-zen": "minimax-m2.7",
+                codex: "gpt-5.3-codex-spark",
+            },
+        };
+        expect(resolveProviderRouteCandidates({ globalConfig })).toEqual([
+            { provider: "codex-oauth", model: "gpt-5.4-mini" },
+            { provider: "opencode-zen", model: "minimax-m2.7" },
+            { provider: "opencode-zen", model: "kimi-k2.6" },
+            { provider: "openrouter", model: "openrouter/free" },
+            { provider: "codex", model: "gpt-5.3-codex-spark" },
+        ]);
+    });
+    it("keeps an explicit flag provider authoritative even when another route better matches the task", () => {
+        const globalConfig = {
+            version: "1",
+            routing: {
+                routes: [
+                    { provider: "codex-oauth", model: "gpt-5.5" },
+                    { provider: "opencode-zen", model: "kimi-k2.6" },
+                ],
+            },
+        };
+        expect(resolveProviderRouteCandidates({
+            globalConfig,
+            flagProvider: "codex-oauth",
+            taskText: "Build a polished React frontend layout",
+        })).toEqual([
+            { provider: "codex-oauth", model: "gpt-5.5" },
+        ]);
+    });
+    it("orders configured routes by inferred task suitability while preserving stable fallback order", () => {
+        const globalConfig = {
+            version: "1",
+            routing: {
+                routes: [
+                    { provider: "codex-oauth", model: "gpt-5.5" },
+                    { provider: "opencode-zen", model: "minimax-m2.7" },
+                    { provider: "opencode-zen", model: "kimi-k2.6" },
+                ],
+            },
+        };
+        expect(resolveProviderRouteCandidates({
+            globalConfig,
+            taskText: "Create a responsive React UI with polished visual design",
+        })).toEqual([
+            { provider: "opencode-zen", model: "kimi-k2.6" },
+            { provider: "codex-oauth", model: "gpt-5.5" },
+            { provider: "opencode-zen", model: "minimax-m2.7" },
+        ]);
+    });
+    it("uses operator task suitability overrides when ranking configured routes", () => {
+        const globalConfig = {
+            version: "1",
+            routing: {
+                routes: [
+                    { provider: "codex-oauth", model: "gpt-5.5" },
+                    { provider: "opencode-zen", model: "minimax-m2.7" },
+                ],
+            },
+            modelTaskSuitability: [{
+                    provider: "opencode-zen",
+                    model: "minimax-m2.7",
+                    task: "research",
+                    level: "preferred",
+                    reason: "Operator prefers MiniMax for broad synthesis.",
+                }],
+        };
+        expect(resolveProviderRouteCandidates({
+            globalConfig,
+            taskText: "Research and compare current model rankings",
+        })).toEqual([
+            { provider: "opencode-zen", model: "minimax-m2.7" },
+            { provider: "codex-oauth", model: "gpt-5.5" },
+        ]);
+    });
+    it("infers route task from agent affinity before prompt keywords", () => {
+        expect(inferRouteTask({
+            agentTaskAffinity: ["mechanical-edit"],
+            text: "Research the latest frontend benchmarks",
+        })).toBe("mechanical-edit");
+    });
+    it("uses defaultWorker and fallback when ordered routes are absent", () => {
+        const globalConfig = {
+            version: "1",
+            routing: {
+                defaultWorker: "codex-oauth",
+                fallback: "codex",
+            },
+            models: {
+                "codex-oauth": "gpt-5.4-mini",
+                codex: "gpt-5.3-codex-spark",
+            },
+        };
+        expect(resolveProviderRouteCandidates({ globalConfig })).toEqual([
+            { provider: "codex-oauth", model: "gpt-5.4-mini" },
+            { provider: "codex", model: "gpt-5.3-codex-spark" },
+        ]);
+    });
+});
+//# sourceMappingURL=provider-route-candidates.test.js.map

package/dist/config/provider-route-candidates.test.js.map

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

package/dist/config/skill-registry.d.ts

@@ -0,0 +1,9 @@
+import { SkillRegistry } from "@kilnai/core";
+import type { KilnYamlSkillsConfig } from "../kiln-yaml-types.js";
+export interface ConfiguredSkillRegistryOptions {
+    readonly projectPath: string;
+    readonly userHome?: string;
+    readonly skillConfig?: KilnYamlSkillsConfig | null;
+}
+export declare function createConfiguredSkillRegistry(options: ConfiguredSkillRegistryOptions): SkillRegistry;
+//# sourceMappingURL=skill-registry.d.ts.map

package/dist/config/skill-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../src/config/skill-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,aAAa,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACpD;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,aAAa,CASf"}

package/dist/config/skill-registry.js

@@ -0,0 +1,13 @@
+import { homedir } from "node:os";
+import { resolveKilnCoreBuiltinSkills, SkillRegistry, } from "@kilnai/core";
+export function createConfiguredSkillRegistry(options) {
+    const registry = new SkillRegistry();
+    registry.discoverAll(options.projectPath, options.userHome ?? homedir());
+    for (const skill of resolveKilnCoreBuiltinSkills(options.skillConfig?.builtin)) {
+        if (!registry.get(skill.name)) {
+            registry.registerFull(skill);
+        }
+    }
+    return registry;
+}
+//# sourceMappingURL=skill-registry.js.map

package/dist/config/skill-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.js","sourceRoot":"","sources":["../../src/config/skill-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,aAAa,GACd,MAAM,cAAc,CAAC;AAStB,MAAM,UAAU,6BAA6B,CAC3C,OAAuC;IAEvC,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC,CAAC;IACzE,KAAK,MAAM,KAAK,IAAI,4BAA4B,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC;QAC/E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/config/skill-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill-registry.test.d.ts.map

package/dist/config/skill-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.test.d.ts","sourceRoot":"","sources":["../../src/config/skill-registry.test.ts"],"names":[],"mappings":""}

package/dist/config/skill-registry.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from "vitest";
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { createConfiguredSkillRegistry } from "./skill-registry.js";
+function writeProjectSkill(root, name, description) {
+    const skillDir = join(root, ".kiln", "skills", name);
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(join(skillDir, "SKILL.md"), [
+        "---",
+        `name: ${name}`,
+        `description: ${description}`,
+        "---",
+        "",
+        "Project instructions.",
+        "",
+    ].join("\n"), "utf-8");
+}
+describe("createConfiguredSkillRegistry", () => {
+    it("adds Kiln core builtin skills after project and user discovery", () => {
+        const root = mkdtempSync(join(tmpdir(), "kiln-skill-registry-"));
+        try {
+            writeProjectSkill(root, "tdd-workflow", "project override");
+            const registry = createConfiguredSkillRegistry({
+                projectPath: root,
+                userHome: root,
+            });
+            expect(registry.get("code-review-findings")).toBeDefined();
+            expect(registry.get("tdd-workflow")?.description).toBe("project override");
+            expect(registry.load("tdd-workflow")?.instructions).toContain("Project instructions.");
+        }
+        finally {
+            rmSync(root, { recursive: true, force: true });
+        }
+    });
+    it("honors builtin include, exclude, and disabled policy", () => {
+        const root = mkdtempSync(join(tmpdir(), "kiln-skill-registry-policy-"));
+        try {
+            const registry = createConfiguredSkillRegistry({
+                projectPath: root,
+                userHome: root,
+                skillConfig: {
+                    builtin: {
+                        include: ["tdd-workflow", "code-review-findings"],
+                        exclude: ["code-review-findings"],
+                    },
+                },
+            });
+            expect(registry.get("tdd-workflow")).toBeDefined();
+            expect(registry.get("code-review-findings")).toBeUndefined();
+            expect(registry.get("repo-context-review")).toBeUndefined();
+            const disabled = createConfiguredSkillRegistry({
+                projectPath: root,
+                userHome: root,
+                skillConfig: { builtin: { enabled: false } },
+            });
+            expect(disabled.all()).toEqual([]);
+        }
+        finally {
+            rmSync(root, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=skill-registry.test.js.map

package/dist/config/skill-registry.test.js.map

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

package/dist/config/task-skill-selection.d.ts

@@ -0,0 +1,24 @@
+import { type ContextCandidate, type ModelTaskSuitability, type ModelTaskSuitabilityTask } from "@kilnai/core";
+import type { KilnModelTaskSuitabilityOverride, KilnYamlSkillSelectionConfig, KilnYamlSkillsConfig } from "../kiln-yaml-types.js";
+export interface TaskSkillSelectionInput {
+    readonly explicitSkills?: readonly string[];
+    readonly projectPath: string;
+    readonly userHome?: string;
+    readonly skillConfig?: KilnYamlSkillsConfig | null;
+    readonly selection?: KilnYamlSkillSelectionConfig | null;
+    readonly task?: ModelTaskSuitabilityTask;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly taskSuitability?: readonly ModelTaskSuitability[];
+    readonly modelTaskSuitability?: readonly KilnModelTaskSuitabilityOverride[];
+    readonly requesterLabel: string;
+}
+export interface TaskSkillSelectionResult {
+    readonly skillNames: readonly string[];
+    readonly explicitSkillNames: readonly string[];
+    readonly autoSkillNames: readonly string[];
+    readonly unavailableAutoSkillNames: readonly string[];
+    readonly contextCandidates: readonly ContextCandidate[];
+}
+export declare function resolveTaskSkillSelection(input: TaskSkillSelectionInput): TaskSkillSelectionResult;
+//# sourceMappingURL=task-skill-selection.d.ts.map

package/dist/config/task-skill-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-skill-selection.d.ts","sourceRoot":"","sources":["../../src/config/task-skill-selection.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,gCAAgC,EAChC,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACzD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,wBAAwB,CA8ClG"}

package/dist/config/task-skill-selection.js

@@ -0,0 +1,79 @@
+import { homedir } from "node:os";
+import { skillConfigToContextCandidate, } from "@kilnai/core";
+import { createConfiguredSkillRegistry } from "./skill-registry.js";
+import { resolveConfiguredModelTaskSuitability } from "./model-task-suitability.js";
+const SKILL_CONTEXT_SCORE = 0.95;
+export function resolveTaskSkillSelection(input) {
+    const explicitSkillNames = normalizeSkillNames(input.explicitSkills);
+    const autoRecommendedSkillNames = resolveAutoRecommendedSkills(input);
+    const registry = createConfiguredSkillRegistry({
+        projectPath: input.projectPath,
+        userHome: input.userHome ?? homedir(),
+        skillConfig: input.skillConfig,
+    });
+    const explicitResolved = registry.resolve(explicitSkillNames);
+    const explicitResolvedNames = new Set(explicitResolved.map((skill) => skill.name));
+    const missingExplicit = explicitSkillNames.filter((skill) => !explicitResolvedNames.has(skill));
+    if (missingExplicit.length > 0) {
+        throw new Error(`${input.requesterLabel} references unavailable skill(s): ${missingExplicit.join(", ")}`);
+    }
+    const autoResolved = registry.resolve(autoRecommendedSkillNames);
+    const autoResolvedNames = new Set(autoResolved.map((skill) => skill.name));
+    const unavailableAutoSkillNames = autoRecommendedSkillNames.filter((skill) => !autoResolvedNames.has(skill));
+    const skillNames = unique([
+        ...explicitResolved.map((skill) => skill.name),
+        ...autoResolved.map((skill) => skill.name),
+    ]);
+    const contextCandidates = skillNames.map((name) => {
+        const skill = registry.load(name);
+        if (!skill) {
+            throw new Error(`${input.requesterLabel} references skill "${name}", but the skill content could not be loaded.`);
+        }
+        return skillConfigToContextCandidate(skill, {
+            required: true,
+            score: SKILL_CONTEXT_SCORE,
+        });
+    });
+    return {
+        skillNames,
+        explicitSkillNames,
+        autoSkillNames: autoResolved.map((skill) => skill.name),
+        unavailableAutoSkillNames,
+        contextCandidates,
+    };
+}
+function resolveAutoRecommendedSkills(input) {
+    if (input.selection?.mode !== "auto" || !input.task) {
+        return [];
+    }
+    const taskSuitability = (input.taskSuitability ?? resolveConfiguredTaskSuitability(input))
+        .find((entry) => entry.task === input.task);
+    return normalizeSkillNames(taskSuitability?.recommendedSkills);
+}
+function resolveConfiguredTaskSuitability(input) {
+    if (!input.provider || !input.model) {
+        return [];
+    }
+    return resolveConfiguredModelTaskSuitability({
+        provider: input.provider,
+        model: input.model,
+        overrides: input.modelTaskSuitability,
+    });
+}
+function normalizeSkillNames(skills) {
+    if (!skills || skills.length === 0) {
+        return [];
+    }
+    return unique(skills);
+}
+function unique(values) {
+    const uniqueValues = new Set();
+    for (const value of values) {
+        const normalized = value.trim();
+        if (normalized.length > 0) {
+            uniqueValues.add(normalized);
+        }
+    }
+    return [...uniqueValues];
+}
+//# sourceMappingURL=task-skill-selection.js.map

package/dist/config/task-skill-selection.js.map

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

package/dist/config/translators/claude-translator.d.ts

@@ -0,0 +1,7 @@
+import type { KilnPermissionPolicy } from "../../wrapper/session.js";
+import { type PermissionProjection } from "./permission-projection.js";
+export declare function translateClaudePermissionProjection(input: {
+    readonly policy: KilnPermissionPolicy;
+    readonly existingDocument: Record<string, unknown>;
+}): PermissionProjection;
+//# sourceMappingURL=claude-translator.d.ts.map

package/dist/config/translators/claude-translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-translator.d.ts","sourceRoot":"","sources":["../../../src/config/translators/claude-translator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AAEpC,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpD,GAAG,oBAAoB,CA2BvB"}