@oscharko-dev/keiko-contracts 0.2.7 → 0.2.9

package/dist/prompt-enhancer-analyzer.js

@@ -10,6 +10,13 @@
 // Leaf-package rule (ADR-0019 direction 1): no `@oscharko-dev/keiko-*` imports. The module reuses the
 // same-package `normalizePromptDraft` (which composes `stripUnsafeFormatChars`) for input hardening.
 import { PROMPT_ENHANCER_SCHEMA_VERSION, PROMPT_MISSING_CONTEXT_MAX_CHARS, isSafetyCriticalDomain, normalizePromptDraft, } from "./prompt-enhancer.js";
+function foldForSearch(text) {
+    return text
+        .toLowerCase()
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/gu, "")
+        .replace(/ß/gu, "ss");
+}
 const STOP_WORDS = new Set([
     "the",
     "a",
@@ -38,6 +45,36 @@ const STOP_WORDS = new Set([
     "how",
     "what",
     "why",
+    "der",
+    "die",
+    "das",
+    "den",
+    "dem",
+    "ein",
+    "eine",
+    "einen",
+    "und",
+    "oder",
+    "aber",
+    "zu",
+    "zum",
+    "zur",
+    "von",
+    "im",
+    "fur",
+    "mit",
+    "ist",
+    "sind",
+    "bitte",
+    "kannst",
+    "du",
+    "mir",
+    "mein",
+    "meine",
+    "ich",
+    "wie",
+    "was",
+    "warum",
 ]);
 function countMeaningfulTokens(lower) {
     const tokens = lower.split(/[^\p{L}\p{N}]+/u).filter((t) => t.length > 0);
@@ -49,7 +86,7 @@ function countMeaningfulTokens(lower) {
     return count;
 }
 function buildView(normalized, request) {
-    const lower = normalized.toLowerCase();
+    const lower = foldForSearch(normalized);
     return {
         normalizedLength: normalized.length,
         lower,
@@ -75,8 +112,13 @@ const TASK_CLASS_RULES = [
             "rewrite the prompt",
             "meta-prompt",
             "system prompt for",
+            "verbessere diesen prompt",
+            "optimiere den prompt",
+            "schreibe einen prompt",
+            "prompt fur",
+            "prompt fuer",
         ],
-        weak: ["prompt engineering", "better prompt", "prompt template"],
+        weak: ["prompt engineering", "better prompt", "prompt template", "promptvorlage"],
     },
     {
         taskClass: "code-debugging",
@@ -87,13 +129,36 @@ const TASK_CLASS_RULES = [
             "traceback",
             "why does this fail",
             "not working",
+            "fehler beheben",
+            "bug beheben",
+            "warum schlagt",
+            "funktioniert nicht",
         ],
-        weak: ["error", "exception", "throws", "undefined is not", "segfault"],
+        weak: ["error", "exception", "throws", "undefined is not", "segfault", "fehler", "stacktrace"],
     },
     {
         taskClass: "code-architecture",
-        strong: ["system design", "design the system", "software architecture", "architecture for"],
-        weak: ["scalable", "microservice", "design pattern", "trade-offs between", "high-level design"],
+        strong: [
+            "system design",
+            "design the system",
+            "software architecture",
+            "architecture for",
+            "softwarearchitektur",
+            "architektur fur",
+            "systemdesign",
+            "migration strategy",
+            "sql migration strategy",
+            "migrationsstrategie",
+        ],
+        weak: [
+            "scalable",
+            "microservice",
+            "design pattern",
+            "trade-offs between",
+            "high-level design",
+            "skalierbar",
+            "migration",
+        ],
     },
     {
         taskClass: "code-generation",
@@ -104,6 +169,11 @@ const TASK_CLASS_RULES = [
             "generate code",
             "write a script",
             "create a class",
+            "schreibe code",
+            "implementiere",
+            "erstelle eine funktion",
+            "baue eine api",
+            "schreibe ein neues paket",
         ],
         weak: [
             "function that",
@@ -117,17 +187,23 @@ const TASK_CLASS_RULES = [
             "build an api",
             "refactor",
             "snippet",
+            "funktion",
+            "klasse",
+            "skript",
+            "paket",
+            "code-review",
+            "code review",
         ],
     },
     {
         taskClass: "structured-extraction",
         strong: ["extract the", "parse the", "pull out the", "extract fields", "into json"],
-        weak: ["extract", "parse", "list all the", "structured output"],
+        weak: ["extract", "parse", "list all the", "structured output", "extrahiere", "parse"],
     },
     {
         taskClass: "summarization",
-        strong: ["summarize", "tl;dr", "tldr", "give me a summary", "condense"],
-        weak: ["summary", "key points", "in brief", "abstract of"],
+        strong: ["summarize", "tl;dr", "tldr", "give me a summary", "condense", "fasse zusammen"],
+        weak: ["summary", "key points", "in brief", "abstract of", "zusammenfassung", "kurzfassung"],
     },
     {
         taskClass: "data-analysis",
@@ -136,8 +212,10 @@ const TASK_CLASS_RULES = [
             "analyze the dataset",
             "statistical analysis",
             "correlation between",
+            "analysiere die daten",
+            "werte den datensatz aus",
         ],
-        weak: ["dataset", "regression", "aggregate", "pivot", "trend", "metrics"],
+        weak: ["dataset", "regression", "aggregate", "pivot", "trend", "metrics", "datensatz"],
     },
     {
         taskClass: "rag-question-answering",
@@ -147,8 +225,11 @@ const TASK_CLASS_RULES = [
             "from the attached",
             "using the document",
             "in the provided text",
+            "basierend auf der datei",
+            "aus der angehangten",
+            "aus dem dokument",
         ],
-        weak: ["from these files", "from the context", "in the attached"],
+        weak: ["from these files", "from the context", "in the attached", "aus diesen dateien"],
     },
     {
         taskClass: "research",
@@ -158,8 +239,11 @@ const TASK_CLASS_RULES = [
             "literature review",
             "state of the art",
             "survey of",
+            "recherchiere",
+            "umfassender uberblick",
+            "stand der technik",
         ],
-        weak: ["research", "investigate", "background on", "explore the topic"],
+        weak: ["research", "investigate", "background on", "explore the topic", "untersuche"],
     },
     {
         taskClass: "creative-writing",
@@ -170,22 +254,69 @@ const TASK_CLASS_RULES = [
             "write lyrics",
             "screenplay",
             "short story",
+            "schreibe eine geschichte",
+            "schreibe ein gedicht",
         ],
-        weak: ["poem", "fiction", "creative", "imagine a", "tale"],
+        weak: ["poem", "fiction", "creative", "imagine a", "tale", "geschichte", "gedicht", "roman"],
     },
     {
         taskClass: "writing-editing",
-        strong: ["write an email", "draft a", "proofread", "rewrite this", "rephrase"],
-        weak: ["edit", "improve this text", "make this clearer", "polish", "tone"],
+        strong: [
+            "write an email",
+            "draft a",
+            "proofread",
+            "rewrite this",
+            "rephrase",
+            "schreibe einen brief",
+            "schreibe eine email",
+            "formuliere",
+            "kundigungsbrief",
+            "kuendigungsbrief",
+            "kundigungsschreiben",
+            "kuendigungsschreiben",
+        ],
+        weak: ["edit", "improve this text", "make this clearer", "polish", "tone", "brief", "email"],
     },
     {
         taskClass: "decision-support",
-        strong: ["should i", "pros and cons", "help me decide", "which is better", "compare options"],
-        weak: ["recommend", "trade-offs", "decision", "evaluate options"],
+        strong: [
+            "should i",
+            "pros and cons",
+            "help me decide",
+            "which is better",
+            "compare options",
+            "soll ich",
+            "vor- und nachteile",
+            "hilf mir entscheiden",
+            "plan a trip",
+            "plane eine reise",
+            "plane einen urlaub",
+        ],
+        weak: [
+            "recommend",
+            "trade-offs",
+            "decision",
+            "evaluate options",
+            "empfehlung",
+            "vergleiche",
+            "reise",
+            "urlaub",
+            "itinerary",
+            "reiseplanung",
+        ],
     },
     {
         taskClass: "agentic-tool-use",
-        strong: ["use the tool", "call the api", "automate", "take actions", "as an agent"],
+        strong: [
+            "use the tool",
+            "call the api",
+            "automate",
+            "take actions",
+            "as an agent",
+            "automatisiere",
+            "nutze das tool",
+            "ruf die api",
+        ],
         weak: ["execute", "browse", "fetch and", "step by step using tools", "orchestrate"],
     },
 ];
@@ -228,6 +359,11 @@ const DOMAIN_RULES = [
             "regulation",
             "copyright",
             "patent",
+            "vertrag",
+            "kundigung",
+            "kuendigung",
+            "recht",
+            "anwalt",
         ],
     },
     {
@@ -272,6 +408,8 @@ const DOMAIN_RULES = [
             "authentication",
             "encryption",
             "secrets management",
+            "authentifizierung",
+            "verschlusselung",
         ],
     },
     {
@@ -291,13 +429,27 @@ const DOMAIN_RULES = [
     },
     {
         domain: "business",
-        keywords: ["marketing", "sales", "revenue", "business plan", "startup", "customer", "kpi"],
+        keywords: [
+            "marketing",
+            "sales",
+            "revenue",
+            "business plan",
+            "startup",
+            "customer",
+            "kpi",
+            "kunde",
+            "kunden",
+            "strategie",
+        ],
     },
     {
         domain: "education",
-        keywords: ["teach", "lesson", "homework", "student", "tutorial", "curriculum"],
+        keywords: ["teach", "lesson", "homework", "student", "tutorial", "curriculum", "lerne"],
+    },
+    {
+        domain: "creative",
+        keywords: ["poem", "story", "novel", "song", "fiction", "screenplay", "geschichte", "gedicht"],
     },
-    { domain: "creative", keywords: ["poem", "story", "novel", "song", "fiction", "screenplay"] },
     {
         domain: "software",
         keywords: [
@@ -311,6 +463,19 @@ const DOMAIN_RULES = [
             "compile",
             "react",
             "algorithm",
+            "code-review",
+            "code review",
+            "repository",
+            "repo",
+            "paket",
+            "npm",
+            "sql",
+            "datenbank",
+            "migration",
+            "migrationsstrategie",
+            "kundendaten",
+            "typescript",
+            "optimierung",
         ],
     },
 ];
@@ -524,12 +689,23 @@ const OUTPUT_HINT_RULES = [
     { hint: "explicit-json", format: "json", keywords: ["json", "as json", "in json"] },
     { hint: "explicit-yaml", format: "yaml", keywords: ["yaml"] },
     { hint: "explicit-csv", format: "csv", keywords: ["csv", "comma-separated"] },
-    { hint: "explicit-table", format: "table", keywords: ["as a table", "in a table", "tabular"] },
+    {
+        hint: "explicit-table",
+        format: "table",
+        keywords: ["as a table", "in a table", "tabular", "als tabelle", "tabelle"],
+    },
     { hint: "explicit-code", format: "code", keywords: ["code block", "a snippet", "as code"] },
     {
         hint: "explicit-list",
         format: "list",
-        keywords: ["bullet points", "bulleted list", "numbered list", "as a list"],
+        keywords: [
+            "bullet points",
+            "bulleted list",
+            "numbered list",
+            "as a list",
+            "stichpunkte",
+            "als liste",
+        ],
     },
     { hint: "explicit-markdown", format: "markdown", keywords: ["in markdown", "as markdown"] },
 ];

package/dist/runtime-capabilities.d.ts

@@ -0,0 +1,44 @@
+export declare const RUNTIME_CAPABILITY_SCHEMA_VERSION: "1";
+export type RuntimeCapabilityKind = "git" | "node" | "package-manager" | "language-toolchain" | "container-engine" | "command-source";
+export type RuntimeCapabilityState = "available" | "missing" | "unsupported" | "permission-denied" | "not-running" | "policy-blocked";
+export type RuntimeCapabilityUnavailableReason = "executable-not-found" | "executable-not-runnable" | "unsupported-version" | "daemon-not-running" | "policy-blocked" | "unsafe-path" | "manifest-not-found" | "script-not-defined" | "probe-timed-out" | "probe-failed";
+export type RuntimeCommandKind = "test" | "build" | "lint" | "typecheck";
+export type RuntimeCommandSourceType = "package-json-script" | "ecosystem-manifest" | "lockfile";
+export interface RuntimeCommandSource {
+    readonly type: RuntimeCommandSourceType;
+    readonly path: string;
+    readonly commandKind?: RuntimeCommandKind | undefined;
+    readonly scriptName?: string | undefined;
+    readonly packageManager?: string | undefined;
+}
+export interface RuntimeCapability {
+    readonly id: string;
+    readonly kind: RuntimeCapabilityKind;
+    readonly label: string;
+    readonly state: RuntimeCapabilityState;
+    readonly version?: string | undefined;
+    readonly unavailableReason?: RuntimeCapabilityUnavailableReason | undefined;
+    readonly remediationHint?: string | undefined;
+    readonly source?: RuntimeCommandSource | undefined;
+}
+export interface RuntimeCapabilitiesResponse {
+    readonly schemaVersion: typeof RUNTIME_CAPABILITY_SCHEMA_VERSION;
+    readonly generatedAtMs: number;
+    readonly deadlineMs: number;
+    readonly capabilities: readonly RuntimeCapability[];
+}
+export interface RuntimeCapabilitiesParseOk {
+    readonly ok: true;
+    readonly value: RuntimeCapabilitiesResponse;
+}
+export interface RuntimeCapabilitiesParseFail {
+    readonly ok: false;
+    readonly errors: readonly string[];
+}
+export type RuntimeCapabilitiesParse = RuntimeCapabilitiesParseOk | RuntimeCapabilitiesParseFail;
+export declare const RUNTIME_CAPABILITY_KINDS: readonly RuntimeCapabilityKind[];
+export declare const RUNTIME_CAPABILITY_STATES: readonly RuntimeCapabilityState[];
+export declare const RUNTIME_CAPABILITY_UNAVAILABLE_REASONS: readonly RuntimeCapabilityUnavailableReason[];
+export declare const RUNTIME_COMMAND_KINDS: readonly RuntimeCommandKind[];
+export declare function validateRuntimeCapabilitiesResponse(value: unknown): RuntimeCapabilitiesParse;
+//# sourceMappingURL=runtime-capabilities.d.ts.map

package/dist/runtime-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-capabilities.d.ts","sourceRoot":"","sources":["../src/runtime-capabilities.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iCAAiC,EAAG,GAAY,CAAC;AAE9D,MAAM,MAAM,qBAAqB,GAC7B,KAAK,GACL,MAAM,GACN,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,SAAS,GACT,aAAa,GACb,mBAAmB,GACnB,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,MAAM,kCAAkC,GAC1C,sBAAsB,GACtB,yBAAyB,GACzB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,aAAa,GACb,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,cAAc,CAAC;AAEnB,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;AAEzE,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,UAAU,CAAC;AAEjG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,kCAAkC,GAAG,SAAS,CAAC;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,EAAE,OAAO,iCAAiC,CAAC;IACjE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC;CAC7C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,GAAG,0BAA0B,GAAG,4BAA4B,CAAC;AAEjG,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAOf,CAAC;AAEvD,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EAOhB,CAAC;AAExD,eAAO,MAAM,sCAAsC,EAAE,SAAS,kCAAkC,EAY3B,CAAC;AAEtE,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAKZ,CAAC;AAsHpD,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAW5F"}

package/dist/runtime-capabilities.js

@@ -0,0 +1,141 @@
+// Local runtime capability contracts (Issue #1385, Epic #1491). This leaf module owns the
+// wire-stable vocabulary for host tool/runtime detection only. It is intentionally pure: no IO,
+// no process execution, no clock, no randomness, and no imports from sibling packages.
+export const RUNTIME_CAPABILITY_SCHEMA_VERSION = "1";
+export const RUNTIME_CAPABILITY_KINDS = Object.freeze([
+    "git",
+    "node",
+    "package-manager",
+    "language-toolchain",
+    "container-engine",
+    "command-source",
+]);
+export const RUNTIME_CAPABILITY_STATES = Object.freeze([
+    "available",
+    "missing",
+    "unsupported",
+    "permission-denied",
+    "not-running",
+    "policy-blocked",
+]);
+export const RUNTIME_CAPABILITY_UNAVAILABLE_REASONS = Object.freeze([
+    "executable-not-found",
+    "executable-not-runnable",
+    "unsupported-version",
+    "daemon-not-running",
+    "policy-blocked",
+    "unsafe-path",
+    "manifest-not-found",
+    "script-not-defined",
+    "probe-timed-out",
+    "probe-failed",
+]);
+export const RUNTIME_COMMAND_KINDS = Object.freeze([
+    "test",
+    "build",
+    "lint",
+    "typecheck",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOneOf(value, allowed) {
+    return typeof value === "string" && allowed.includes(value);
+}
+function validateStringField(record, key, errors, optional = false, label = key) {
+    const value = record[key];
+    if (value === undefined && optional)
+        return;
+    if (typeof value !== "string" || value.length === 0) {
+        errors.push(`${label} must be a non-empty string`);
+    }
+}
+function validateCommandSource(value, path, errors) {
+    if (!isRecord(value)) {
+        errors.push(`${path} must be an object`);
+        return;
+    }
+    if (!isOneOf(value.type, ["package-json-script", "ecosystem-manifest", "lockfile"])) {
+        errors.push(`${path}.type is invalid`);
+    }
+    validateStringField(value, "path", errors, false, `${path}.path`);
+    if (value.commandKind !== undefined && !isOneOf(value.commandKind, RUNTIME_COMMAND_KINDS)) {
+        errors.push(`${path}.commandKind is invalid`);
+    }
+    if (value.scriptName !== undefined && typeof value.scriptName !== "string") {
+        errors.push(`${path}.scriptName must be a string`);
+    }
+    if (value.packageManager !== undefined && typeof value.packageManager !== "string") {
+        errors.push(`${path}.packageManager must be a string`);
+    }
+}
+function validateCapabilityRequiredFields(value, path, errors) {
+    validateStringField(value, "id", errors);
+    validateStringField(value, "label", errors);
+    if (!isOneOf(value.kind, RUNTIME_CAPABILITY_KINDS)) {
+        errors.push(`${path}.kind is invalid`);
+    }
+    if (!isOneOf(value.state, RUNTIME_CAPABILITY_STATES)) {
+        errors.push(`${path}.state is invalid`);
+    }
+}
+function validateCapabilityOptionalFields(value, path, errors) {
+    if (value.version !== undefined && typeof value.version !== "string") {
+        errors.push(`${path}.version must be a string`);
+    }
+    if (value.unavailableReason !== undefined &&
+        !isOneOf(value.unavailableReason, RUNTIME_CAPABILITY_UNAVAILABLE_REASONS)) {
+        errors.push(`${path}.unavailableReason is invalid`);
+    }
+    if (value.remediationHint !== undefined && typeof value.remediationHint !== "string") {
+        errors.push(`${path}.remediationHint must be a string`);
+    }
+    if (value.source !== undefined) {
+        validateCommandSource(value.source, `${path}.source`, errors);
+    }
+}
+function validateCapability(value, index, errors) {
+    const path = `capabilities[${String(index)}]`;
+    if (!isRecord(value)) {
+        errors.push(`${path} must be an object`);
+        return;
+    }
+    validateCapabilityRequiredFields(value, path, errors);
+    validateCapabilityOptionalFields(value, path, errors);
+}
+function validateResponseScalars(value, errors) {
+    if (value.schemaVersion !== RUNTIME_CAPABILITY_SCHEMA_VERSION)
+        errors.push("schemaVersion is invalid");
+    const generatedAtMs = value.generatedAtMs;
+    if (typeof generatedAtMs !== "number" ||
+        !Number.isSafeInteger(generatedAtMs) ||
+        generatedAtMs < 0) {
+        errors.push("generatedAtMs must be a non-negative safe integer");
+    }
+    const deadlineMs = value.deadlineMs;
+    if (typeof deadlineMs !== "number" || !Number.isSafeInteger(deadlineMs) || deadlineMs < 1) {
+        errors.push("deadlineMs must be a positive safe integer");
+    }
+}
+function validateCapabilitiesArray(value, errors) {
+    if (!Array.isArray(value.capabilities)) {
+        errors.push("capabilities must be an array");
+    }
+    else {
+        value.capabilities.forEach((entry, index) => {
+            validateCapability(entry, index, errors);
+        });
+    }
+}
+export function validateRuntimeCapabilitiesResponse(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        return { ok: false, errors: ["response must be an object"] };
+    }
+    validateResponseScalars(value, errors);
+    validateCapabilitiesArray(value, errors);
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    return { ok: true, value: value };
+}