@kilnai/cli 1.0.7 → 2.0.0

package/dist/config/native-projection-state.js

@@ -0,0 +1,199 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const INSTALL_STATE_FILE = "install-state.json";
+export function emptyNativeProjectionInstallState() {
+    return {
+        version: 1,
+        targets: {},
+    };
+}
+export function readNativeProjectionInstallState(kilnDir) {
+    const path = join(kilnDir, INSTALL_STATE_FILE);
+    if (!existsSync(path)) {
+        return emptyNativeProjectionInstallState();
+    }
+    const raw = readFileSync(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== 1 || typeof parsed.targets !== "object" || parsed.targets === null) {
+        throw new Error(`Invalid native projection install state at ${path}`);
+    }
+    return parsed;
+}
+export function writeNativeProjectionInstallState(kilnDir, state) {
+    const path = join(kilnDir, INSTALL_STATE_FILE);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+}
+export function createNativeProjectionSnapshot(input) {
+    const managedFieldHashes = {};
+    for (const fieldPath of input.managedFields) {
+        managedFieldHashes[fieldPath] = hashStableValue(getPathValue(input.document, fieldPath));
+    }
+    return {
+        targetId: requireText(input.targetId, "targetId"),
+        filePath: requireText(input.filePath, "filePath"),
+        contentHash: hashStableValue(input.document),
+        managedFields: [...input.managedFields],
+        managedFieldHashes,
+        updatedAt: input.updatedAt ?? new Date().toISOString(),
+    };
+}
+export function createNativeProjectionFileSnapshot(input) {
+    const contentHash = hashStableValue(input.content);
+    return {
+        targetId: requireText(input.targetId, "targetId"),
+        filePath: requireText(input.filePath, "filePath"),
+        projectionKind: "file",
+        contentHash,
+        managedFields: ["$file"],
+        managedFieldHashes: {
+            "$file": contentHash,
+        },
+        updatedAt: input.updatedAt ?? new Date().toISOString(),
+    };
+}
+export function upsertNativeProjectionTargetState(state, target) {
+    return {
+        version: 1,
+        targets: {
+            ...state.targets,
+            [target.targetId]: target,
+        },
+    };
+}
+export function removeNativeProjectionTargetState(state, targetId) {
+    const targets = { ...state.targets };
+    delete targets[targetId];
+    return {
+        version: 1,
+        targets,
+    };
+}
+export function detectNativeProjectionDrift(input) {
+    const target = input.state.targets[input.targetId];
+    if (!target) {
+        return undefined;
+    }
+    const driftedFields = target.managedFields.filter((fieldPath) => {
+        const currentHash = hashStableValue(getPathValue(input.currentDocument, fieldPath));
+        return currentHash !== target.managedFieldHashes[fieldPath];
+    });
+    return driftedFields.length > 0
+        ? { targetId: input.targetId, driftedFields }
+        : undefined;
+}
+export function detectNativeProjectionFileDrift(input) {
+    const target = input.state.targets[input.targetId];
+    if (!target) {
+        return undefined;
+    }
+    const currentHash = hashStableValue(input.currentContent);
+    return currentHash !== target.managedFieldHashes["$file"]
+        ? { targetId: input.targetId, driftedFields: ["$file"] }
+        : undefined;
+}
+export function mergeManagedFields(input) {
+    const merged = cloneRecord(input.currentDocument);
+    for (const fieldPath of input.managedFields) {
+        setPathValue(merged, fieldPath, cloneValue(getPathValue(input.managedPatch, fieldPath)));
+    }
+    return merged;
+}
+export function stripManagedFields(input) {
+    const stripped = cloneRecord(input.currentDocument);
+    for (const fieldPath of input.managedFields) {
+        deletePathValue(stripped, fieldPath);
+    }
+    return stripped;
+}
+function getPathValue(source, fieldPath) {
+    const segments = parseFieldPath(fieldPath);
+    let cursor = source;
+    for (const segment of segments) {
+        if (!isRecord(cursor)) {
+            return undefined;
+        }
+        cursor = cursor[segment];
+    }
+    return cursor;
+}
+function setPathValue(target, fieldPath, value) {
+    const segments = parseFieldPath(fieldPath);
+    let cursor = target;
+    for (let index = 0; index < segments.length - 1; index += 1) {
+        const segment = segments[index];
+        const next = cursor[segment];
+        if (!isRecord(next)) {
+            cursor[segment] = {};
+        }
+        cursor = cursor[segment];
+    }
+    cursor[segments[segments.length - 1]] = value;
+}
+function deletePathValue(target, fieldPath) {
+    const segments = parseFieldPath(fieldPath);
+    return deletePathSegments(target, segments, 0);
+}
+function deletePathSegments(target, segments, index) {
+    const segment = segments[index];
+    if (index === segments.length - 1) {
+        delete target[segment];
+    }
+    else {
+        const next = target[segment];
+        if (isRecord(next) && deletePathSegments(next, segments, index + 1)) {
+            delete target[segment];
+        }
+    }
+    return Object.keys(target).length === 0;
+}
+function parseFieldPath(fieldPath) {
+    const segments = fieldPath.split(".").map((segment) => segment.trim()).filter(Boolean);
+    if (segments.length === 0) {
+        throw new Error("Managed field path must not be empty");
+    }
+    return segments;
+}
+function hashStableValue(value) {
+    return createHash("sha256").update(stableStringify(value)).digest("hex");
+}
+function stableStringify(value) {
+    if (value === undefined) {
+        return "undefined";
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(",")}]`;
+    }
+    if (isRecord(value)) {
+        return `{${Object.keys(value).filter((key) => value[key] !== undefined).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`).join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+function cloneRecord(value) {
+    return cloneValue(value);
+}
+function cloneValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(cloneValue);
+    }
+    if (isRecord(value)) {
+        const clone = {};
+        for (const [key, nested] of Object.entries(value)) {
+            clone[key] = cloneValue(nested);
+        }
+        return clone;
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireText(value, field) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`${field} is required`);
+    }
+    return trimmed;
+}
+//# sourceMappingURL=native-projection-state.js.map

package/dist/config/native-projection-state.js.map

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

package/dist/config/native-skill-projection.d.ts

@@ -0,0 +1,24 @@
+import { type NativeProjectionSyncOptions } from "./native-projection-policy.js";
+import type { KilnYamlSkillsConfig } from "../kiln-yaml-types.js";
+export interface NativeSkillProjectionResult {
+    claude: boolean;
+    codex: boolean;
+    opencode: boolean;
+    synced: number;
+    errors: string[];
+}
+export interface NativeSkillProjectionOptions extends NativeProjectionSyncOptions {
+    readonly skillConfig?: KilnYamlSkillsConfig | null;
+}
+export declare function discoverSkillDirs(projectPath: string): Map<string, string>;
+interface SkillProjectionSource {
+    readonly sourceDir?: string;
+    readonly files?: readonly {
+        readonly fileName: string;
+        readonly content: string;
+    }[];
+}
+export declare function discoverSkillProjectionSources(projectPath: string, skillConfig?: KilnYamlSkillsConfig | null): Map<string, SkillProjectionSource>;
+export declare function syncNativeSkillProjections(projectPath: string, options?: NativeSkillProjectionOptions): Promise<NativeSkillProjectionResult>;
+export {};
+//# sourceMappingURL=native-skill-projection.d.ts.map

package/dist/config/native-skill-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-skill-projection.d.ts","sourceRoot":"","sources":["../../src/config/native-skill-projection.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,4BAA6B,SAAQ,2BAA2B;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACpD;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA0B1E;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,EAAE,CAAC;CACL;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACxC,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAapC;AAcD,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CAuFtC"}

package/dist/config/native-skill-projection.js

@@ -0,0 +1,170 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import { join } from "node:path";
+import { renderSkillMarkdown, resolveKilnCoreBuiltinSkills } from "@kilnai/core";
+import { createNativeProjectionFileSnapshot, detectNativeProjectionFileDrift, readNativeProjectionInstallState, upsertNativeProjectionTargetState, writeNativeProjectionInstallState, } from "./native-projection-state.js";
+import { backupNativeProjectionFile } from "./native-projection-backup.js";
+import { isNativeProjectionHarnessDisabled, } from "./native-projection-policy.js";
+export function discoverSkillDirs(projectPath) {
+    const discovered = new Map();
+    const globalSkillsDir = join(os.homedir(), ".kiln", "skills");
+    const projectSkillsDir = join(projectPath, ".kiln", "skills");
+    try {
+        for (const entry of readdirSync(globalSkillsDir, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                discovered.set(entry.name, join(globalSkillsDir, entry.name));
+            }
+        }
+    }
+    catch {
+        // Fail-open when the global skills directory is missing or unreadable.
+    }
+    try {
+        for (const entry of readdirSync(projectSkillsDir, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                discovered.set(entry.name, join(projectSkillsDir, entry.name));
+            }
+        }
+    }
+    catch {
+        // Fail-open when the project skills directory is missing or unreadable.
+    }
+    return discovered;
+}
+export function discoverSkillProjectionSources(projectPath, skillConfig) {
+    const discovered = new Map();
+    for (const [skillName, sourceDir] of discoverSkillDirs(projectPath)) {
+        discovered.set(skillName, { sourceDir });
+    }
+    for (const skill of resolveKilnCoreBuiltinSkills(skillConfig?.builtin)) {
+        if (!discovered.has(skill.name)) {
+            discovered.set(skill.name, {
+                files: [{ fileName: "SKILL.md", content: renderSkillMarkdown(skill) }],
+            });
+        }
+    }
+    return discovered;
+}
+export async function syncNativeSkillProjections(projectPath, options = {}) {
+    const errors = [];
+    let synced = 0;
+    const kilnDir = join(projectPath, ".kiln");
+    let installState = readNativeProjectionInstallState(kilnDir);
+    const skillSources = discoverSkillProjectionSources(projectPath, options.skillConfig);
+    if (skillSources.size === 0) {
+        return { claude: true, codex: true, opencode: true, synced: 0, errors: [] };
+    }
+    const targets = [
+        { key: "claude", name: "Claude Code", dir: join(os.homedir(), ".claude", "skills") },
+        { key: "codex", name: "Codex", dir: join(os.homedir(), ".codex", "skills") },
+        { key: "opencode", name: "OpenCode", dir: join(os.homedir(), ".config", "opencode", "skills") },
+    ];
+    let claude = true;
+    let codex = true;
+    let opencode = true;
+    const setTargetFailed = (targetKey) => {
+        if (targetKey === "claude") {
+            claude = false;
+            return;
+        }
+        if (targetKey === "codex") {
+            codex = false;
+            return;
+        }
+        opencode = false;
+    };
+    for (const target of targets.filter((target) => !isNativeProjectionHarnessDisabled(options, target.key))) {
+        try {
+            mkdirSync(target.dir, { recursive: true });
+        }
+        catch (error) {
+            setTargetFailed(target.key);
+            errors.push(`${target.name} skills mkdir failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        for (const [skillName, source] of skillSources) {
+            const targetSkillDir = join(target.dir, skillName);
+            try {
+                mkdirSync(targetSkillDir, { recursive: true });
+                const sourceFiles = source.files ?? readSkillSourceFiles(source.sourceDir);
+                let skillFailed = false;
+                for (const sourceFile of sourceFiles) {
+                    const targetFile = join(targetSkillDir, sourceFile.fileName);
+                    const fileResult = syncSkillFile({
+                        target,
+                        skillName,
+                        fileName: sourceFile.fileName,
+                        content: sourceFile.content,
+                        targetFile,
+                        kilnDir,
+                        installState,
+                        options,
+                    });
+                    if (!fileResult.ok) {
+                        skillFailed = true;
+                        setTargetFailed(target.key);
+                        errors.push(`${target.name} skill "${skillName}" file "${sourceFile.fileName}" failed: ${fileResult.error ?? "unknown error"}`);
+                        continue;
+                    }
+                    if (fileResult.snapshot) {
+                        installState = upsertNativeProjectionTargetState(installState, fileResult.snapshot);
+                    }
+                }
+                if (!skillFailed) {
+                    synced += 1;
+                }
+            }
+            catch (error) {
+                setTargetFailed(target.key);
+                errors.push(`${target.name} skill "${skillName}" failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    writeNativeProjectionInstallState(kilnDir, installState);
+    return { claude, codex, opencode, synced, errors };
+}
+function readSkillSourceFiles(sourceDir) {
+    if (!sourceDir) {
+        return [];
+    }
+    return readdirSync(sourceDir, { withFileTypes: true })
+        .filter((entry) => entry.isFile())
+        .map((entry) => ({
+        fileName: entry.name,
+        content: readFileSync(join(sourceDir, entry.name), "utf-8"),
+    }));
+}
+function syncSkillFile(input) {
+    const targetId = `${input.target.key}-skill:${input.skillName}/${input.fileName}`;
+    try {
+        if (existsSync(input.targetFile)) {
+            const drift = detectNativeProjectionFileDrift({
+                targetId,
+                state: input.installState,
+                currentContent: readFileSync(input.targetFile, "utf-8"),
+            });
+            if (drift && !input.options.force) {
+                return {
+                    ok: false,
+                    error: `managed file drift detected: ${drift.driftedFields.join(", ")}`,
+                };
+            }
+        }
+        backupNativeProjectionFile({ kilnDir: input.kilnDir, targetId, filePath: input.targetFile });
+        writeFileSync(input.targetFile, input.content, "utf-8");
+        return {
+            ok: true,
+            snapshot: createNativeProjectionFileSnapshot({
+                targetId,
+                filePath: input.targetFile,
+                content: input.content,
+            }),
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=native-skill-projection.js.map

package/dist/config/native-skill-projection.js.map

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

package/dist/config/operator-identity-context.d.ts

@@ -0,0 +1,7 @@
+import { type KilnAppConfig } from "../config.js";
+import type { KilnGlobalConfig, KilnGlobalIdentity } from "./global-config.js";
+import type { ContextCandidate } from "@kilnai/core";
+export declare function buildOperatorIdentityContext(identity: KilnGlobalIdentity | undefined): string | undefined;
+export declare function buildOperatorIdentityContextCandidate(identity: KilnGlobalIdentity | undefined): ContextCandidate | undefined;
+export declare function withGlobalIdentityContext(appConfig: KilnAppConfig, globalConfig: KilnGlobalConfig | null | undefined): KilnAppConfig;
+//# sourceMappingURL=operator-identity-context.d.ts.map

package/dist/config/operator-identity-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-identity-context.d.ts","sourceRoot":"","sources":["../../src/config/operator-identity-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAczG;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,gBAAgB,GAAG,SAAS,CAY9B;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAChD,aAAa,CAcf"}

package/dist/config/operator-identity-context.js

@@ -0,0 +1,46 @@
+import { defaultBuildSystemPrompt } from "../config.js";
+export function buildOperatorIdentityContext(identity) {
+    const name = normalizeIdentityValue(identity?.name);
+    const timezone = normalizeIdentityValue(identity?.timezone);
+    if (!name && !timezone) {
+        return undefined;
+    }
+    return [
+        "## Operator Identity",
+        "Source: ~/.kiln/config.yaml identity.",
+        name ? `- Operator name: ${name}` : undefined,
+        timezone ? `- Timezone: ${timezone}` : undefined,
+    ].filter((line) => Boolean(line)).join("\n");
+}
+export function buildOperatorIdentityContextCandidate(identity) {
+    const content = buildOperatorIdentityContext(identity);
+    if (!content) {
+        return undefined;
+    }
+    return {
+        kind: "instruction",
+        source: "operator-identity:~/.kiln/config.yaml#identity",
+        content,
+        required: true,
+        score: 1,
+    };
+}
+export function withGlobalIdentityContext(appConfig, globalConfig) {
+    const identityCandidate = buildOperatorIdentityContextCandidate(globalConfig?.identity);
+    if (!identityCandidate) {
+        return appConfig;
+    }
+    return {
+        ...appConfig,
+        buildSystemPrompt: appConfig.buildSystemPrompt ?? defaultBuildSystemPrompt,
+        contextCandidates: [
+            ...(appConfig.contextCandidates ?? []),
+            identityCandidate,
+        ],
+    };
+}
+function normalizeIdentityValue(value) {
+    const normalized = value?.replace(/\s+/g, " ").trim();
+    return normalized && normalized.length > 0 ? normalized : undefined;
+}
+//# sourceMappingURL=operator-identity-context.js.map

package/dist/config/operator-identity-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-identity-context.js","sourceRoot":"","sources":["../../src/config/operator-identity-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAsB,MAAM,cAAc,CAAC;AAI5E,MAAM,UAAU,4BAA4B,CAAC,QAAwC;IACnF,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE5D,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,sBAAsB;QACtB,uCAAuC;QACvC,IAAI,CAAC,CAAC,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QAC7C,QAAQ,CAAC,CAAC,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;KACjD,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,QAAwC;IAExC,MAAM,OAAO,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,gDAAgD;QACxD,OAAO;QACP,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,SAAwB,EACxB,YAAiD;IAEjD,MAAM,iBAAiB,GAAG,qCAAqC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACxF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,GAAG,SAAS;QACZ,iBAAiB,EAAE,SAAS,CAAC,iBAAiB,IAAI,wBAAwB;QAC1E,iBAAiB,EAAE;YACjB,GAAG,CAAC,SAAS,CAAC,iBAAiB,IAAI,EAAE,CAAC;YACtC,iBAAiB;SAClB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAyB;IACvD,MAAM,UAAU,GAAG,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC"}

package/dist/config/operator-identity-context.test.d.ts

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

package/dist/config/operator-identity-context.test.d.ts.map

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

package/dist/config/operator-identity-context.test.js

@@ -0,0 +1,61 @@
+import { describe, expect, it, vi } from "vitest";
+import { buildOperatorIdentityContext, buildOperatorIdentityContextCandidate, withGlobalIdentityContext, } from "./operator-identity-context.js";
+describe("operator identity context", () => {
+    it("returns no context when global identity is missing or blank", () => {
+        expect(buildOperatorIdentityContext(undefined)).toBeUndefined();
+        expect(buildOperatorIdentityContext({ name: "  ", timezone: "\n" })).toBeUndefined();
+    });
+    it("formats admitted operator identity with provenance", () => {
+        expect(buildOperatorIdentityContext({
+            name: " Alex\nRivera ",
+            timezone: " America/Tijuana ",
+        })).toBe([
+            "## Operator Identity",
+            "Source: ~/.kiln/config.yaml identity.",
+            "- Operator name: Alex Rivera",
+            "- Timezone: America/Tijuana",
+        ].join("\n"));
+    });
+    it("adds identity as required governed context instead of passive prompt text", () => {
+        const buildSystemPrompt = vi.fn().mockReturnValue("base prompt");
+        const appConfig = {
+            createRegistry: vi.fn(),
+            buildSystemPrompt,
+        };
+        const wrapped = withGlobalIdentityContext(appConfig, {
+            version: "1",
+            identity: {
+                name: "Alex",
+            },
+        });
+        expect(wrapped.contextCandidates).toEqual([
+            buildOperatorIdentityContextCandidate({ name: "Alex" }),
+        ]);
+        expect(wrapped.buildSystemPrompt?.({
+            task: "test",
+            domain: {
+                name: "default",
+                displayName: "Default",
+                toolTags: new Set(),
+                qualityGates: [],
+                detectPatterns: [],
+                multishotExamples: "",
+                phaseExamples: "",
+            },
+            projectedContext: {
+                blocks: [],
+                estimatedTokens: 0,
+            },
+            projectPath: "C:/repo",
+        })).toBe("base prompt");
+        expect(buildSystemPrompt).toHaveBeenCalledOnce();
+    });
+    it("returns the original app config when there is no identity context", () => {
+        const appConfig = { createRegistry: vi.fn() };
+        expect(withGlobalIdentityContext(appConfig, {
+            version: "1",
+            identity: {},
+        })).toBe(appConfig);
+    });
+});
+//# sourceMappingURL=operator-identity-context.test.js.map

package/dist/config/operator-identity-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-identity-context.test.js","sourceRoot":"","sources":["../../src/config/operator-identity-context.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EACL,4BAA4B,EAC5B,qCAAqC,EACrC,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AAExC,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,4BAA4B,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAChE,MAAM,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,4BAA4B,CAAC;YAClC,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,mBAAmB;SAC9B,CAAC,CAAC,CAAC,IAAI,CAAC;YACP,sBAAsB;YACtB,uCAAuC;YACvC,8BAA8B;YAC9B,6BAA6B;SAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QACjE,MAAM,SAAS,GAAkB;YAC/B,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;YACvB,iBAAiB;SAClB,CAAC;QAEF,MAAM,OAAO,GAAG,yBAAyB,CAAC,SAAS,EAAE;YACnD,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE;gBACR,IAAI,EAAE,MAAM;aACb;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC;YACxC,qCAAqC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACxD,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACjC,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,SAAS;gBACtB,QAAQ,EAAE,IAAI,GAAG,EAAU;gBAC3B,YAAY,EAAE,EAAE;gBAChB,cAAc,EAAE,EAAE;gBAClB,iBAAiB,EAAE,EAAE;gBACrB,aAAa,EAAE,EAAE;aAClB;YACD,gBAAgB,EAAE;gBAChB,MAAM,EAAE,EAAE;gBACV,eAAe,EAAE,CAAC;aACnB;YACD,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACxB,MAAM,CAAC,iBAAiB,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,SAAS,GAAkB,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QAE7D,MAAM,CAAC,yBAAyB,CAAC,SAAS,EAAE;YAC1C,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/config/operator-voice.d.ts

@@ -0,0 +1,10 @@
+import type { SttAdapter, TtsAdapter, VoiceConfig } from "@kilnai/core";
+import type { KilnGlobalConfig } from "./global-config.js";
+export interface OperatorVoiceRuntime {
+    readonly voiceConfig?: VoiceConfig;
+    readonly sttAdapter?: SttAdapter;
+    readonly ttsAdapter?: TtsAdapter;
+    readonly warnings: readonly string[];
+}
+export declare function resolveOperatorVoiceRuntime(globalConfig: KilnGlobalConfig | null | undefined): Promise<OperatorVoiceRuntime>;
+//# sourceMappingURL=operator-voice.d.ts.map

package/dist/config/operator-voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-voice.d.ts","sourceRoot":"","sources":["../../src/config/operator-voice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAAC,oBAAoB,CAAC,CA6B/B"}

package/dist/config/operator-voice.js

@@ -0,0 +1,29 @@
+export async function resolveOperatorVoiceRuntime(globalConfig) {
+    const voiceConfig = globalConfig?.operatorVoice;
+    if (!voiceConfig) {
+        return { warnings: [] };
+    }
+    const warnings = [];
+    const { createSttAdapter, createTtsAdapter } = await import("@kilnai/runtime");
+    let sttAdapter;
+    let ttsAdapter;
+    try {
+        sttAdapter = createSttAdapter(voiceConfig.stt);
+    }
+    catch (error) {
+        warnings.push(`Operator STT adapter was not initialized: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        ttsAdapter = createTtsAdapter(voiceConfig.tts);
+    }
+    catch (error) {
+        warnings.push(`Operator TTS adapter was not initialized: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return {
+        voiceConfig,
+        ...(sttAdapter ? { sttAdapter } : {}),
+        ...(ttsAdapter ? { ttsAdapter } : {}),
+        warnings,
+    };
+}
+//# sourceMappingURL=operator-voice.js.map

package/dist/config/operator-voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-voice.js","sourceRoot":"","sources":["../../src/config/operator-voice.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAiD;IAEjD,MAAM,WAAW,GAAG,YAAY,EAAE,aAAa,CAAC;IAChD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC/E,IAAI,UAAkC,CAAC;IACvC,IAAI,UAAkC,CAAC;IAEvC,IAAI,CAAC;QACH,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,6CAA6C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvH,CAAC;IAED,IAAI,CAAC;QACH,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,6CAA6C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvH,CAAC;IAED,OAAO;QACL,WAAW;QACX,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,QAAQ;KACT,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { KilnGlobalConfig } from "./global-config.js";
+import type { ProviderId } from "../wrapper/session-registry.js";
+import type { ModelTaskSuitabilityTask } from "@kilnai/core";
+export interface ProviderRouteCandidate {
+    readonly provider: ProviderId;
+    readonly model?: string;
+}
+export interface ResolveProviderRouteCandidatesInput {
+    readonly globalConfig?: KilnGlobalConfig | null;
+    readonly flagProvider?: string;
+    readonly flagModel?: string;
+    readonly taskText?: string;
+    readonly agentTaskAffinity?: readonly ModelTaskSuitabilityTask[];
+}
+export declare function resolveProviderRouteCandidates(input: ResolveProviderRouteCandidatesInput): readonly ProviderRouteCandidate[];
+export declare function inferRouteTask(input: {
+    readonly text?: string;
+    readonly agentTaskAffinity?: readonly ModelTaskSuitabilityTask[];
+}): ModelTaskSuitabilityTask | undefined;
+//# sourceMappingURL=provider-route-candidates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-route-candidates.d.ts","sourceRoot":"","sources":["../../src/config/provider-route-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAA6B,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAGxF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAClE;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mCAAmC,GACzC,SAAS,sBAAsB,EAAE,CAoDnC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAClE,GAAG,wBAAwB,GAAG,SAAS,CAuFvC"}