@oscharko-dev/keiko-contracts 0.2.0

package/dist/prompt-enhancer.d.ts

@@ -0,0 +1,184 @@
+export declare const PROMPT_ENHANCER_SCHEMA_VERSION: "1";
+export declare const PROMPT_ANALYSIS_MAX_SCAN_CHARS: 100000;
+export declare const PROMPT_MISSING_CONTEXT_MAX_CHARS: 240;
+declare const PromptEnhancementRequestIdBrand: unique symbol;
+declare const EnhancedPromptIdBrand: unique symbol;
+export type PromptEnhancementRequestId = string & {
+    readonly [PromptEnhancementRequestIdBrand]: true;
+};
+export type EnhancedPromptId = string & {
+    readonly [EnhancedPromptIdBrand]: true;
+};
+/**
+ * Validate a candidate string is acceptable as a Prompt Enhancer branded id. Pure; returns a typed
+ * reason on rejection. Rules mirror the QI / audit-ledger id discipline: non-empty after trim, no
+ * surrounding whitespace, max length 256, NFKC-normalised, no control characters, no path-traversal
+ * fragment. Exported for tests; production callers use the `asX` constructors.
+ */
+export declare const validatePromptEnhancerIdString: (value: unknown, kind: string) => {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare const asPromptEnhancementRequestId: (value: string) => PromptEnhancementRequestId;
+export declare const asEnhancedPromptId: (value: string) => EnhancedPromptId;
+export type PromptTaskClass = "factual-qa" | "research" | "rag-question-answering" | "summarization" | "structured-extraction" | "data-analysis" | "code-generation" | "code-debugging" | "code-architecture" | "writing-editing" | "creative-writing" | "decision-support" | "agentic-tool-use" | "prompt-optimization" | "safety-critical";
+export declare const PROMPT_TASK_CLASSES: readonly PromptTaskClass[];
+export type PromptDomain = "software" | "legal" | "medical" | "finance" | "security" | "data-science" | "science" | "business" | "education" | "creative" | "general";
+export declare const PROMPT_DOMAINS: readonly PromptDomain[];
+export declare const SAFETY_CRITICAL_DOMAINS: readonly PromptDomain[];
+export declare const isSafetyCriticalDomain: (domain: PromptDomain) => boolean;
+export type PromptCriticality = "low" | "standard" | "elevated" | "critical";
+export declare const PROMPT_CRITICALITIES: readonly PromptCriticality[];
+export type PromptRiskClass = "instruction-override-suspected" | "tool-authority-requested" | "egress-requested" | "safety-critical-advice";
+export declare const PROMPT_RISK_CLASSES: readonly PromptRiskClass[];
+export type GroundingNeedKind = "none" | "supplied-context" | "external-knowledge" | "external-current";
+export declare const GROUNDING_NEED_KINDS: readonly GroundingNeedKind[];
+export type GroundingSignal = "temporal-recency-term" | "named-current-event" | "market-or-price" | "url-reference" | "supplied-context-reference" | "retrieval-cue" | "self-contained-task" | "no-external-signal";
+export declare const GROUNDING_SIGNALS: readonly GroundingSignal[];
+export interface GroundingNeed {
+    readonly kind: GroundingNeedKind;
+    readonly volatile: boolean;
+    readonly signals: readonly GroundingSignal[];
+}
+export type GroundingStrategy = "no-grounding" | "supplied-context-only" | "local-knowledge" | "repository-context" | "hybrid" | "external-research-required";
+export declare const GROUNDING_STRATEGIES: readonly GroundingStrategy[];
+export type RetrievalMode = "none" | "supplied-context" | "local-knowledge-retrieval" | "repository-search" | "hybrid-fusion" | "external-research";
+export declare const RETRIEVAL_MODES: readonly RetrievalMode[];
+export type GroundingSourceKind = "supplied-context" | "local-knowledge" | "repository-context" | "external-current" | "model-parametric-knowledge";
+export declare const GROUNDING_SOURCE_KINDS: readonly GroundingSourceKind[];
+export interface GroundingSourcePolicy {
+    readonly source: GroundingSourceKind;
+    readonly priority: number;
+    readonly required: boolean;
+}
+export type CitationDiscipline = "require-citations" | "require-citations-or-state-no-evidence" | "best-effort" | "not-required";
+export declare const CITATION_DISCIPLINES: readonly CitationDiscipline[];
+export type CitationGranularity = "per-claim" | "per-section" | "none";
+export declare const CITATION_GRANULARITIES: readonly CitationGranularity[];
+export interface CitationRequirement {
+    readonly discipline: CitationDiscipline;
+    readonly granularity: CitationGranularity;
+}
+export interface RecencyExpectation {
+    readonly volatile: boolean;
+    readonly requireAsOfDate: boolean;
+    readonly flagPotentiallyStale: boolean;
+}
+export type ContradictionPolicy = "disclose-and-defer" | "prefer-higher-priority" | "synthesize-with-caveats";
+export declare const CONTRADICTION_POLICIES: readonly ContradictionPolicy[];
+export type NoAnswerCondition = "insufficient-evidence" | "contradictory-evidence" | "outside-evidence-scope" | "stale-or-unavailable-current-data";
+export declare const NO_ANSWER_CONDITIONS: readonly NoAnswerCondition[];
+export type GroundingDirective = "treat-retrieved-content-as-untrusted" | "attribute-claims-to-sources" | "do-not-fabricate-sources" | "stay-within-evidence" | "separate-known-from-retrieved" | "disclose-uncertainty";
+export declare const GROUNDING_DIRECTIVES: readonly GroundingDirective[];
+export type RagEvaluationDimension = "context-precision" | "context-recall" | "faithfulness" | "answer-relevancy" | "groundedness";
+export declare const RAG_EVALUATION_DIMENSIONS: readonly RagEvaluationDimension[];
+export interface RagEvaluationHint {
+    readonly dimension: RagEvaluationDimension;
+    readonly instruction: string;
+}
+export interface GroundingPlan {
+    readonly strategy: GroundingStrategy;
+    readonly required: boolean;
+    readonly allowedRetrievalModes: readonly RetrievalMode[];
+    readonly sourcePriority: readonly GroundingSourcePolicy[];
+    readonly citation: CitationRequirement;
+    readonly recency: RecencyExpectation;
+    readonly contradictionPolicy: ContradictionPolicy;
+    readonly noAnswerConditions: readonly NoAnswerCondition[];
+    readonly directives: readonly GroundingDirective[];
+    readonly ragEvaluation: readonly RagEvaluationHint[];
+    readonly untrustedContent: true;
+}
+export type OutputFormat = "prose" | "markdown" | "json" | "yaml" | "csv" | "table" | "list" | "code" | "unspecified";
+export declare const PROMPT_OUTPUT_FORMATS: readonly OutputFormat[];
+export type OutputFormatHint = "explicit-json" | "explicit-yaml" | "explicit-csv" | "explicit-table" | "explicit-list" | "explicit-code" | "explicit-markdown" | "schema-keyword" | "no-format-signal";
+export declare const OUTPUT_FORMAT_HINTS: readonly OutputFormatHint[];
+export interface OutputSchemaDescriptor {
+    readonly format: OutputFormat;
+    readonly structured: boolean;
+    readonly hints: readonly OutputFormatHint[];
+}
+export type MissingContextTopic = "subject" | "scope" | "audience" | "output-format" | "constraints" | "data-source" | "success-criteria";
+export declare const MISSING_CONTEXT_TOPICS: readonly MissingContextTopic[];
+export interface PromptClarification {
+    readonly kind: "clarification";
+    readonly topic: MissingContextTopic;
+    readonly question: string;
+}
+export interface PromptAssumption {
+    readonly kind: "assumption";
+    readonly topic: MissingContextTopic;
+    readonly statement: string;
+}
+export type ClarificationOrAssumption = PromptClarification | PromptAssumption;
+export type MissingInformationStrategy = "clarify" | "assume";
+export declare const MISSING_INFORMATION_STRATEGIES: readonly MissingInformationStrategy[];
+export type PromptSignalStrength = "strong" | "moderate" | "weak";
+export declare const PROMPT_SIGNAL_STRENGTHS: readonly PromptSignalStrength[];
+export type PromptSignalDimension = "task-class" | "domain" | "grounding" | "output" | "risk" | "missing-context";
+export declare const PROMPT_SIGNAL_DIMENSIONS: readonly PromptSignalDimension[];
+export interface PromptClassificationSignal {
+    readonly dimension: PromptSignalDimension;
+    readonly code: string;
+}
+export type PromptEnhancementProfileId = "fast" | "precise" | "research" | "creative" | "technical" | "safety-critical" | "agentic";
+export declare const PROMPT_ENHANCEMENT_PROFILE_IDS: readonly PromptEnhancementProfileId[];
+export interface PromptEnhancementProfile {
+    readonly id: PromptEnhancementProfileId;
+    readonly description: string;
+    readonly groundingMandatory: boolean;
+    readonly deterministicAnalysisOnly: boolean;
+    readonly preferredOutputModes: readonly OutputFormat[];
+    readonly maxClarifications: number;
+}
+export declare const PROMPT_ENHANCEMENT_PROFILES: Readonly<Record<PromptEnhancementProfileId, PromptEnhancementProfile>>;
+export interface RawPromptInput {
+    readonly text: string;
+    readonly hasConnectedContext?: boolean | undefined;
+    readonly attachmentCount?: number | undefined;
+}
+export interface PromptEnhancementRequest {
+    readonly schemaVersion: typeof PROMPT_ENHANCER_SCHEMA_VERSION;
+    readonly requestId: PromptEnhancementRequestId;
+    readonly input: RawPromptInput;
+    readonly missingInformationStrategy: MissingInformationStrategy;
+    readonly profilePreference?: PromptEnhancementProfileId | undefined;
+    readonly locale?: string | undefined;
+}
+export interface PromptTaskAnalysis {
+    readonly schemaVersion: typeof PROMPT_ENHANCER_SCHEMA_VERSION;
+    readonly requestId: PromptEnhancementRequestId;
+    readonly taskClass: PromptTaskClass;
+    readonly taskClassConfidence: PromptSignalStrength;
+    readonly domain: PromptDomain;
+    readonly criticality: PromptCriticality;
+    readonly groundingNeed: GroundingNeed;
+    readonly outputSchema: OutputSchemaDescriptor;
+    readonly missingContext: readonly ClarificationOrAssumption[];
+    readonly riskFlags: readonly PromptRiskClass[];
+    readonly recommendedProfile: PromptEnhancementProfileId;
+    readonly normalizedInputLength: number;
+    readonly signals: readonly PromptClassificationSignal[];
+}
+export interface EnhancedPrompt {
+    readonly schemaVersion: typeof PROMPT_ENHANCER_SCHEMA_VERSION;
+    readonly promptId: EnhancedPromptId;
+    readonly role: string;
+    readonly goal: string;
+    readonly context: readonly string[];
+    readonly input: string;
+    readonly taskDecomposition: readonly string[];
+    readonly constraints: readonly string[];
+    readonly groundingRules: readonly string[];
+    readonly groundingPlan: GroundingPlan;
+    readonly outputSchema: OutputSchemaDescriptor;
+    readonly qualityCriteria: readonly string[];
+    readonly uncertaintyHandling: readonly string[];
+    readonly safetyRules: readonly string[];
+}
+export declare function assertNeverTaskClass(value: never): never;
+export declare function normalizePromptDraft(text: string): string;
+export {};
+//# sourceMappingURL=prompt-enhancer.d.ts.map

package/dist/prompt-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-enhancer.d.ts","sourceRoot":"","sources":["../src/prompt-enhancer.ts"],"names":[],"mappings":"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"}

package/dist/prompt-enhancer.js

@@ -0,0 +1,350 @@
+// Prompt Enhancer wire contracts, task taxonomy, and analyzer-result shapes
+// (Epic #1307, Issue #1309; governed by ADR-0044 and the prompt-enhancer architecture blueprint).
+//
+// This module is the single conceptual map for the Prompt Enhancer domain in the contracts leaf.
+// It carries ONLY wire-safe, provider-neutral data and pure value tables. There is no IO, no clock
+// read, no hashing, and no randomness here. The leaf-package rule (ADR-0019 direction 1) forbids any
+// `@oscharko-dev/keiko-*` import; same-package relative imports (e.g. `./text-safety.js`) are allowed.
+//
+// Schema evolution follows the EVIDENCE_SCHEMA_VERSION / CONNECTED_CONTEXT_SCHEMA_VERSION rule
+// (ADR-0010 D2): a breaking structural change introduces a NEW literal member rather than mutating
+// "1", so persisted/streamed artefacts remain discriminable across versions.
+//
+// Trust boundary (ADR-0044 §5, AC5 of #1309): none of these shapes may encode a provider credential,
+// a hidden system prompt, or a tool/secret/egress/patch authority grant. The Enhanced Prompt is data,
+// never a capability grant. The `boundary.test.ts` style key-shape assertions in
+// `prompt-enhancer-contracts.test.ts` pin this property.
+//
+// Scope discipline. This module owns the contracts + taxonomy, the deterministic analyzer-result
+// shape (Issue #1309), and the grounding-plan / source-policy shape (Issue #1311). Adjacent concerns
+// are deliberately deferred to their owning issues and are NOT modelled here: machine-readable safety
+// annotations and the validate-stage rule set (#1313), candidate generation and scorecards (#1312),
+// and the evidence manifest (#1313). The risk flags below are explainable, lexical analyzer signals
+// only; the authoritative prompt-injection redaction patterns and secret/PII detectors live in
+// `keiko-security` (#1313) and are not duplicated here. The grounding plan is a source POLICY only:
+// actual retrieval stays in the existing Keiko grounding paths, bound to the plan by the server
+// (#1314); this module never imports a retrieval engine (leaf-package rule).
+import { stripUnsafeFormatChars } from "./text-safety.js";
+// ─── Schema version ─────────────────────────────────────────────────────────────
+export const PROMPT_ENHANCER_SCHEMA_VERSION = "1";
+// Upper bound on the number of characters the deterministic analyzer scans from a raw draft. Inputs
+// longer than this are truncated before signal detection so analysis cost and output are bounded and
+// deterministic regardless of draft size. Exported so callers and tests can reason about the bound.
+export const PROMPT_ANALYSIS_MAX_SCAN_CHARS = 100_000;
+// Maximum length of a single clarification question or assumption statement the analyzer emits.
+export const PROMPT_MISSING_CONTEXT_MAX_CHARS = 240;
+const PROMPT_ENHANCER_ID_MAX_LENGTH = 256;
+const PROMPT_ENHANCER_ID_FORBIDDEN_FRAGMENTS = ["..", "/", "\\"];
+const hasControlCharacter = (value) => {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        // C0 controls 0x00–0x1F, DEL 0x7F, C1 controls 0x80–0x9F.
+        if (code <= 0x1f || code === 0x7f || (code >= 0x80 && code <= 0x9f)) {
+            return true;
+        }
+    }
+    return false;
+};
+/**
+ * Validate a candidate string is acceptable as a Prompt Enhancer branded id. Pure; returns a typed
+ * reason on rejection. Rules mirror the QI / audit-ledger id discipline: non-empty after trim, no
+ * surrounding whitespace, max length 256, NFKC-normalised, no control characters, no path-traversal
+ * fragment. Exported for tests; production callers use the `asX` constructors.
+ */
+export const validatePromptEnhancerIdString = (value, kind) => {
+    if (typeof value !== "string") {
+        return { ok: false, reason: `${kind} must be a string` };
+    }
+    if (value.length === 0 || value.trim().length === 0) {
+        return { ok: false, reason: `${kind} must not be empty or whitespace-only` };
+    }
+    if (value !== value.trim()) {
+        return { ok: false, reason: `${kind} must not have leading or trailing whitespace` };
+    }
+    if (value.length > PROMPT_ENHANCER_ID_MAX_LENGTH) {
+        return {
+            ok: false,
+            reason: `${kind} exceeds max length ${String(PROMPT_ENHANCER_ID_MAX_LENGTH)}`,
+        };
+    }
+    if (value.normalize("NFKC") !== value) {
+        return { ok: false, reason: `${kind} must be NFKC-normalised` };
+    }
+    if (hasControlCharacter(value)) {
+        return { ok: false, reason: `${kind} contains control characters` };
+    }
+    if (stripUnsafeFormatChars(value) !== value) {
+        return { ok: false, reason: `${kind} contains unsafe format characters` };
+    }
+    if (PROMPT_ENHANCER_ID_FORBIDDEN_FRAGMENTS.some((fragment) => value.includes(fragment))) {
+        return { ok: false, reason: `${kind} contains a forbidden path fragment` };
+    }
+    return { ok: true };
+};
+const constructPromptEnhancerId = (value, kind) => {
+    const result = validatePromptEnhancerIdString(value, kind);
+    if (!result.ok) {
+        throw new TypeError(`Invalid ${kind}: ${result.reason}`);
+    }
+    return value;
+};
+export const asPromptEnhancementRequestId = (value) => constructPromptEnhancerId(value, "PromptEnhancementRequestId");
+export const asEnhancedPromptId = (value) => constructPromptEnhancerId(value, "EnhancedPromptId");
+export const PROMPT_TASK_CLASSES = [
+    "factual-qa",
+    "research",
+    "rag-question-answering",
+    "summarization",
+    "structured-extraction",
+    "data-analysis",
+    "code-generation",
+    "code-debugging",
+    "code-architecture",
+    "writing-editing",
+    "creative-writing",
+    "decision-support",
+    "agentic-tool-use",
+    "prompt-optimization",
+    "safety-critical",
+];
+export const PROMPT_DOMAINS = [
+    "software",
+    "legal",
+    "medical",
+    "finance",
+    "security",
+    "data-science",
+    "science",
+    "business",
+    "education",
+    "creative",
+    "general",
+];
+// The domains whose advice carries real-world legal, clinical, financial, or security consequence.
+// Detecting any of these drives `criticality` to "critical" and raises the `safety-critical` task
+// class and the `safety-critical-advice` risk flag.
+export const SAFETY_CRITICAL_DOMAINS = [
+    "legal",
+    "medical",
+    "finance",
+    "security",
+];
+export const isSafetyCriticalDomain = (domain) => SAFETY_CRITICAL_DOMAINS.includes(domain);
+export const PROMPT_CRITICALITIES = [
+    "low",
+    "standard",
+    "elevated",
+    "critical",
+];
+export const PROMPT_RISK_CLASSES = [
+    "instruction-override-suspected",
+    "tool-authority-requested",
+    "egress-requested",
+    "safety-critical-advice",
+];
+export const GROUNDING_NEED_KINDS = [
+    "none",
+    "supplied-context",
+    "external-knowledge",
+    "external-current",
+];
+export const GROUNDING_SIGNALS = [
+    "temporal-recency-term",
+    "named-current-event",
+    "market-or-price",
+    "url-reference",
+    "supplied-context-reference",
+    "retrieval-cue",
+    "self-contained-task",
+    "no-external-signal",
+];
+export const GROUNDING_STRATEGIES = [
+    "no-grounding",
+    "supplied-context-only",
+    "local-knowledge",
+    "repository-context",
+    "hybrid",
+    "external-research-required",
+];
+export const RETRIEVAL_MODES = [
+    "none",
+    "supplied-context",
+    "local-knowledge-retrieval",
+    "repository-search",
+    "hybrid-fusion",
+    "external-research",
+];
+export const GROUNDING_SOURCE_KINDS = [
+    "supplied-context",
+    "local-knowledge",
+    "repository-context",
+    "external-current",
+    "model-parametric-knowledge",
+];
+export const CITATION_DISCIPLINES = [
+    "require-citations",
+    "require-citations-or-state-no-evidence",
+    "best-effort",
+    "not-required",
+];
+export const CITATION_GRANULARITIES = [
+    "per-claim",
+    "per-section",
+    "none",
+];
+export const CONTRADICTION_POLICIES = [
+    "disclose-and-defer",
+    "prefer-higher-priority",
+    "synthesize-with-caveats",
+];
+export const NO_ANSWER_CONDITIONS = [
+    "insufficient-evidence",
+    "contradictory-evidence",
+    "outside-evidence-scope",
+    "stale-or-unavailable-current-data",
+];
+export const GROUNDING_DIRECTIVES = [
+    "treat-retrieved-content-as-untrusted",
+    "attribute-claims-to-sources",
+    "do-not-fabricate-sources",
+    "stay-within-evidence",
+    "separate-known-from-retrieved",
+    "disclose-uncertainty",
+];
+export const RAG_EVALUATION_DIMENSIONS = [
+    "context-precision",
+    "context-recall",
+    "faithfulness",
+    "answer-relevancy",
+    "groundedness",
+];
+export const PROMPT_OUTPUT_FORMATS = [
+    "prose",
+    "markdown",
+    "json",
+    "yaml",
+    "csv",
+    "table",
+    "list",
+    "code",
+    "unspecified",
+];
+export const OUTPUT_FORMAT_HINTS = [
+    "explicit-json",
+    "explicit-yaml",
+    "explicit-csv",
+    "explicit-table",
+    "explicit-list",
+    "explicit-code",
+    "explicit-markdown",
+    "schema-keyword",
+    "no-format-signal",
+];
+export const MISSING_CONTEXT_TOPICS = [
+    "subject",
+    "scope",
+    "audience",
+    "output-format",
+    "constraints",
+    "data-source",
+    "success-criteria",
+];
+export const MISSING_INFORMATION_STRATEGIES = [
+    "clarify",
+    "assume",
+];
+export const PROMPT_SIGNAL_STRENGTHS = [
+    "strong",
+    "moderate",
+    "weak",
+];
+export const PROMPT_SIGNAL_DIMENSIONS = [
+    "task-class",
+    "domain",
+    "grounding",
+    "output",
+    "risk",
+    "missing-context",
+];
+export const PROMPT_ENHANCEMENT_PROFILE_IDS = [
+    "fast",
+    "precise",
+    "research",
+    "creative",
+    "technical",
+    "safety-critical",
+    "agentic",
+];
+export const PROMPT_ENHANCEMENT_PROFILES = {
+    fast: {
+        id: "fast",
+        description: "Low-latency enhancement for simple, self-contained tasks.",
+        groundingMandatory: false,
+        deterministicAnalysisOnly: true,
+        preferredOutputModes: ["prose", "markdown"],
+        maxClarifications: 1,
+    },
+    precise: {
+        id: "precise",
+        description: "Accuracy-first enhancement for factual and decision-support tasks.",
+        groundingMandatory: false,
+        deterministicAnalysisOnly: false,
+        preferredOutputModes: ["markdown", "list"],
+        maxClarifications: 3,
+    },
+    research: {
+        id: "research",
+        description: "Grounded, citation-oriented enhancement for research and deep-research tasks.",
+        groundingMandatory: true,
+        deterministicAnalysisOnly: false,
+        preferredOutputModes: ["markdown", "list"],
+        maxClarifications: 3,
+    },
+    creative: {
+        id: "creative",
+        description: "Expressive enhancement for creative writing and ideation tasks.",
+        groundingMandatory: false,
+        deterministicAnalysisOnly: false,
+        preferredOutputModes: ["prose", "markdown"],
+        maxClarifications: 2,
+    },
+    technical: {
+        id: "technical",
+        description: "Structure-first enhancement for coding, data, and extraction tasks.",
+        groundingMandatory: false,
+        deterministicAnalysisOnly: false,
+        preferredOutputModes: ["code", "json", "markdown"],
+        maxClarifications: 3,
+    },
+    "safety-critical": {
+        id: "safety-critical",
+        description: "Cautious, grounded enhancement for legal, medical, financial, or security-sensitive tasks.",
+        groundingMandatory: true,
+        deterministicAnalysisOnly: false,
+        preferredOutputModes: ["markdown", "list"],
+        maxClarifications: 4,
+    },
+    agentic: {
+        id: "agentic",
+        description: "Tool-aware enhancement for agentic tasks; authority stays behind governed handoff.",
+        groundingMandatory: false,
+        deterministicAnalysisOnly: false,
+        preferredOutputModes: ["markdown", "json"],
+        maxClarifications: 3,
+    },
+};
+// ─── Exhaustiveness helper ───────────────────────────────────────────────────────
+// Compile-time guard: a future PromptTaskClass member with no switch arm forces a type error at the
+// call site (the value is `never` only when every member is handled). Throws if reached at runtime.
+export function assertNeverTaskClass(value) {
+    throw new TypeError(`Unhandled PromptTaskClass: ${String(value)}`);
+}
+// Normalize a raw draft for deterministic analysis: strip Trojan-source/control code points, NFKC
+// normalize, and truncate to the scan bound. Shared by the analyzer and exposed for callers that
+// need the same bounded view. Pure.
+export function normalizePromptDraft(text) {
+    const stripped = stripUnsafeFormatChars(text).normalize("NFKC");
+    return stripped.length > PROMPT_ANALYSIS_MAX_SCAN_CHARS
+        ? stripped.slice(0, PROMPT_ANALYSIS_MAX_SCAN_CHARS)
+        : stripped;
+}

package/dist/qualityIntelligence/assertNever.d.ts

@@ -0,0 +1,2 @@
+export declare const assertQualityIntelligenceNever: (value: never) => never;
+//# sourceMappingURL=assertNever.d.ts.map

package/dist/qualityIntelligence/assertNever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/assertNever.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,8BAA8B,GAAI,OAAO,KAAK,KAAG,KAE7D,CAAC"}

package/dist/qualityIntelligence/assertNever.js

@@ -0,0 +1,7 @@
+// Exhaustiveness helper for discriminated unions across the Quality Intelligence
+// contract surface (Epic #270, Issue #277). Pure; throws at runtime if the type
+// system has been bypassed (e.g. via `as`). Mirrors the convention used in
+// `memory-internal.ts` (`assertNeverMemoryType`) but is shared by every QI union.
+export const assertQualityIntelligenceNever = (value) => {
+    throw new TypeError(`Unexpected Quality Intelligence discriminant: ${JSON.stringify(value)}`);
+};

package/dist/qualityIntelligence/auditSummary.d.ts

@@ -0,0 +1,25 @@
+import type { QualityIntelligenceAuditSummaryId, QualityIntelligenceRunId } from "./ids.js";
+export declare const QUALITY_INTELLIGENCE_AUDIT_MANIFEST_SCHEMA_VERSION: 1;
+export interface QualityIntelligenceAuditTotals {
+    readonly candidates: number;
+    readonly findings: number;
+    readonly exports: number;
+    readonly reviews: number;
+}
+export interface QualityIntelligenceEvidenceRetentionSummary {
+    readonly retainedDays: number;
+    readonly totalAtoms: number;
+}
+export interface QualityIntelligenceAuditSummary {
+    readonly id: QualityIntelligenceAuditSummaryId;
+    readonly runId: QualityIntelligenceRunId;
+    readonly manifestSchemaVersion: typeof QUALITY_INTELLIGENCE_AUDIT_MANIFEST_SCHEMA_VERSION;
+    readonly totals: QualityIntelligenceAuditTotals;
+    /** Display-only policy profile names applied to this run. */
+    readonly policyProfiles: readonly string[];
+    readonly modelGatewayCallCount: number;
+    readonly evidenceRetentionSummary: QualityIntelligenceEvidenceRetentionSummary;
+    /** ISO 8601 timestamp. */
+    readonly createdAt: string;
+}
+//# sourceMappingURL=auditSummary.d.ts.map

package/dist/qualityIntelligence/auditSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditSummary.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/auditSummary.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iCAAiC,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAE5F,eAAO,MAAM,kDAAkD,EAAG,CAAU,CAAC;AAE7E,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,2CAA2C;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,EAAE,iCAAiC,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,kDAAkD,CAAC;IAC1F,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAChD,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,wBAAwB,EAAE,2CAA2C,CAAC;IAC/E,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/qualityIntelligence/auditSummary.js

@@ -0,0 +1,7 @@
+// Quality Intelligence audit summary (Epic #270, Issue #277).
+//
+// The audit summary is the persistable, versioned manifest the audit ledger (#274)
+// records per QI run. The `manifestSchemaVersion` literal `1` follows the same
+// evolution rule as EVIDENCE_SCHEMA_VERSION: a breaking change introduces a new
+// literal member rather than mutating the existing one.
+export const QUALITY_INTELLIGENCE_AUDIT_MANIFEST_SCHEMA_VERSION = 1;