@oscharko-dev/keiko-contracts 0.2.0

package/dist/qualityIntelligence/handoffEnvelope.d.ts

@@ -0,0 +1,23 @@
+import type { QualityIntelligenceRunId, QualityIntelligenceSourceEnvelopeId } from "./ids.js";
+export type QualityIntelligenceHandoffPromptedAction = "design-tests" | "validate-tests" | "review-coverage" | "request-export";
+export declare const QUALITY_INTELLIGENCE_HANDOFF_PROMPTED_ACTIONS: readonly QualityIntelligenceHandoffPromptedAction[];
+/**
+ * Opaque ref to the originating Conversation Center chat message. Branded only as
+ * a string here to keep this contract surface decoupled from `bff-wire.ts` (which
+ * declares the chat-side branded types). The QI runtime resolves the ref against
+ * the chat store at handoff time.
+ */
+export type QualityIntelligenceHandoffChatMessageRef = string;
+export interface QualityIntelligenceConversationCenterHandoff {
+    /** Stable id minted by the Conversation Center at the moment of the handoff. */
+    readonly id: string;
+    readonly requestedByChatMessageId: QualityIntelligenceHandoffChatMessageRef;
+    /** Present once a QI run has been allocated for this handoff. */
+    readonly runId?: QualityIntelligenceRunId;
+    readonly promptedAction: QualityIntelligenceHandoffPromptedAction;
+    /** Envelope ids only — no chat content, no body, no excerpts. */
+    readonly payloadRef: {
+        readonly sourceEnvelopeIds: readonly QualityIntelligenceSourceEnvelopeId[];
+    };
+}
+//# sourceMappingURL=handoffEnvelope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handoffEnvelope.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/handoffEnvelope.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mCAAmC,EAAE,MAAM,UAAU,CAAC;AAE9F,MAAM,MAAM,wCAAwC,GAChD,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,eAAO,MAAM,6CAA6C,EAAE,SAAS,wCAAwC,EAC3B,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,MAAM,wCAAwC,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,4CAA4C;IAC3D,gFAAgF;IAChF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,wBAAwB,EAAE,wCAAwC,CAAC;IAC5E,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,wCAAwC,CAAC;IAClE,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,mCAAmC,EAAE,CAAC;KAC5E,CAAC;CACH"}

package/dist/qualityIntelligence/handoffEnvelope.js

@@ -0,0 +1,8 @@
+// Quality Intelligence Conversation Center handoff envelope (Epic #270, Issue #277).
+//
+// The handoff envelope is the typed message a Conversation Center chat sends to the
+// QI workflow runtime to request a QI action. THE ENVELOPE CARRIES ONLY REFERENCES
+// (chat message id, run id, envelope id refs) — NEVER chat content. The QI runtime
+// (#281 integration) is responsible for resolving the refs against the
+// Conversation Center store under the workflow handoff contract (#186).
+export const QUALITY_INTELLIGENCE_HANDOFF_PROMPTED_ACTIONS = ["design-tests", "validate-tests", "review-coverage", "request-export"];

package/dist/qualityIntelligence/ids.d.ts

@@ -0,0 +1,58 @@
+declare const QualityIntelligenceRunIdBrand: unique symbol;
+declare const QualityIntelligenceTestCaseIdBrand: unique symbol;
+declare const QualityIntelligenceCoverageMapIdBrand: unique symbol;
+declare const QualityIntelligenceValidationFindingIdBrand: unique symbol;
+declare const QualityIntelligenceReviewRecordIdBrand: unique symbol;
+declare const QualityIntelligenceExportBundleIdBrand: unique symbol;
+declare const QualityIntelligenceSourceEnvelopeIdBrand: unique symbol;
+declare const QualityIntelligenceEvidenceAtomIdBrand: unique symbol;
+declare const QualityIntelligenceAuditSummaryIdBrand: unique symbol;
+export type QualityIntelligenceRunId = string & {
+    readonly [QualityIntelligenceRunIdBrand]: true;
+};
+export type QualityIntelligenceTestCaseId = string & {
+    readonly [QualityIntelligenceTestCaseIdBrand]: true;
+};
+export type QualityIntelligenceCoverageMapId = string & {
+    readonly [QualityIntelligenceCoverageMapIdBrand]: true;
+};
+export type QualityIntelligenceValidationFindingId = string & {
+    readonly [QualityIntelligenceValidationFindingIdBrand]: true;
+};
+export type QualityIntelligenceReviewRecordId = string & {
+    readonly [QualityIntelligenceReviewRecordIdBrand]: true;
+};
+export type QualityIntelligenceExportBundleId = string & {
+    readonly [QualityIntelligenceExportBundleIdBrand]: true;
+};
+export type QualityIntelligenceSourceEnvelopeId = string & {
+    readonly [QualityIntelligenceSourceEnvelopeIdBrand]: true;
+};
+export type QualityIntelligenceEvidenceAtomId = string & {
+    readonly [QualityIntelligenceEvidenceAtomIdBrand]: true;
+};
+export type QualityIntelligenceAuditSummaryId = string & {
+    readonly [QualityIntelligenceAuditSummaryIdBrand]: true;
+};
+/**
+ * Validates a candidate string is acceptable as a QI branded id, returning a typed
+ * error message on rejection. Pure — no IO. Exported only for tests; production
+ * callers should use the `asX` constructors.
+ */
+export declare const validateQualityIntelligenceIdString: (value: unknown, kind: string) => {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare const asQualityIntelligenceRunId: (value: string) => QualityIntelligenceRunId;
+export declare const asQualityIntelligenceTestCaseId: (value: string) => QualityIntelligenceTestCaseId;
+export declare const asQualityIntelligenceCoverageMapId: (value: string) => QualityIntelligenceCoverageMapId;
+export declare const asQualityIntelligenceValidationFindingId: (value: string) => QualityIntelligenceValidationFindingId;
+export declare const asQualityIntelligenceReviewRecordId: (value: string) => QualityIntelligenceReviewRecordId;
+export declare const asQualityIntelligenceExportBundleId: (value: string) => QualityIntelligenceExportBundleId;
+export declare const asQualityIntelligenceSourceEnvelopeId: (value: string) => QualityIntelligenceSourceEnvelopeId;
+export declare const asQualityIntelligenceEvidenceAtomId: (value: string) => QualityIntelligenceEvidenceAtomId;
+export declare const asQualityIntelligenceAuditSummaryId: (value: string) => QualityIntelligenceAuditSummaryId;
+export {};
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/ids.ts"],"names":[],"mappings":"AAwBA,OAAO,CAAC,MAAM,6BAA6B,EAAE,OAAO,MAAM,CAAC;AAC3D,OAAO,CAAC,MAAM,kCAAkC,EAAE,OAAO,MAAM,CAAC;AAChE,OAAO,CAAC,MAAM,qCAAqC,EAAE,OAAO,MAAM,CAAC;AACnE,OAAO,CAAC,MAAM,2CAA2C,EAAE,OAAO,MAAM,CAAC;AACzE,OAAO,CAAC,MAAM,sCAAsC,EAAE,OAAO,MAAM,CAAC;AACpE,OAAO,CAAC,MAAM,sCAAsC,EAAE,OAAO,MAAM,CAAC;AACpE,OAAO,CAAC,MAAM,wCAAwC,EAAE,OAAO,MAAM,CAAC;AACtE,OAAO,CAAC,MAAM,sCAAsC,EAAE,OAAO,MAAM,CAAC;AACpE,OAAO,CAAC,MAAM,sCAAsC,EAAE,OAAO,MAAM,CAAC;AAGpE,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG;IAC9C,QAAQ,CAAC,CAAC,6BAA6B,CAAC,EAAE,IAAI,CAAC;CAChD,CAAC;AACF,MAAM,MAAM,6BAA6B,GAAG,MAAM,GAAG;IACnD,QAAQ,CAAC,CAAC,kCAAkC,CAAC,EAAE,IAAI,CAAC;CACrD,CAAC;AACF,MAAM,MAAM,gCAAgC,GAAG,MAAM,GAAG;IACtD,QAAQ,CAAC,CAAC,qCAAqC,CAAC,EAAE,IAAI,CAAC;CACxD,CAAC;AACF,MAAM,MAAM,sCAAsC,GAAG,MAAM,GAAG;IAC5D,QAAQ,CAAC,CAAC,2CAA2C,CAAC,EAAE,IAAI,CAAC;CAC9D,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG;IACvD,QAAQ,CAAC,CAAC,sCAAsC,CAAC,EAAE,IAAI,CAAC;CACzD,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG;IACvD,QAAQ,CAAC,CAAC,sCAAsC,CAAC,EAAE,IAAI,CAAC;CACzD,CAAC;AACF,MAAM,MAAM,mCAAmC,GAAG,MAAM,GAAG;IACzD,QAAQ,CAAC,CAAC,wCAAwC,CAAC,EAAE,IAAI,CAAC;CAC3D,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG;IACvD,QAAQ,CAAC,CAAC,sCAAsC,CAAC,EAAE,IAAI,CAAC;CACzD,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG;IACvD,QAAQ,CAAC,CAAC,sCAAsC,CAAC,EAAE,IAAI,CAAC;CACzD,CAAC;AAuBF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAC9C,OAAO,OAAO,EACd,MAAM,MAAM,KACX;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CA0B5C,CAAC;AAiBF,eAAO,MAAM,0BAA0B,GAAI,OAAO,MAAM,KAAG,wBACe,CAAC;AAE3E,eAAO,MAAM,+BAA+B,GAAI,OAAO,MAAM,KAAG,6BACoB,CAAC;AAErF,eAAO,MAAM,kCAAkC,GAC7C,OAAO,MAAM,KACZ,gCACuF,CAAC;AAE3F,eAAO,MAAM,wCAAwC,GACnD,OAAO,MAAM,KACZ,sCAI0C,CAAC;AAE9C,eAAO,MAAM,mCAAmC,GAC9C,OAAO,MAAM,KACZ,iCACyF,CAAC;AAE7F,eAAO,MAAM,mCAAmC,GAC9C,OAAO,MAAM,KACZ,iCACyF,CAAC;AAE7F,eAAO,MAAM,qCAAqC,GAChD,OAAO,MAAM,KACZ,mCAC6F,CAAC;AAEjG,eAAO,MAAM,mCAAmC,GAC9C,OAAO,MAAM,KACZ,iCACyF,CAAC;AAE7F,eAAO,MAAM,mCAAmC,GAC9C,OAAO,MAAM,KACZ,iCACyF,CAAC"}

package/dist/qualityIntelligence/ids.js

@@ -0,0 +1,93 @@
+// Branded ID types for the Quality Intelligence contract surface (Epic #270, Issue #277).
+//
+// Pure types and pure runtime validators only — no IO, no clock reads, no hashing, no
+// randomness. Leaf-package rule (ADR-0019 direction 1): no `@oscharko-dev/keiko-*` imports
+// may appear in this module.
+//
+// Branding follows the same `unique symbol` phantom-property style as
+// `local-knowledge.ts` (KnowledgeCapsuleId etc.): the brand carrier never lands at
+// runtime, so values survive JSON round-trips intact, but a bare `string` is not
+// assignable to a branded type without an explicit `asX(...)` construction step.
+//
+// Each constructor enforces:
+//   * non-empty after trim
+//   * NFKC normalisation (rejected if normalisation would change the input — callers
+//     must normalise themselves, so a brand never silently rewrites a value)
+//   * max length 256
+//   * no path-traversal segment ("..", "/", "\")
+//   * no NUL or other ASCII control characters
+//
+// These rules deliberately match the audit-ledger `assertValidRunId` shape (ADR-0010,
+// memory: keiko-issue10-audit-ledger) so an ID minted in QI can be safely composed
+// with that surface in #274 without re-validation.
+// ─── Validation primitive ──────────────────────────────────────────────────────
+const QI_ID_MAX_LENGTH = 256;
+// Path-traversal segments and structural separators. NUL plus C0/C1 control ranges
+// are caught by the control-character check below.
+const QI_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;
+};
+const hasForbiddenFragment = (value) => QI_ID_FORBIDDEN_FRAGMENTS.some((fragment) => value.includes(fragment));
+/**
+ * Validates a candidate string is acceptable as a QI branded id, returning a typed
+ * error message on rejection. Pure — no IO. Exported only for tests; production
+ * callers should use the `asX` constructors.
+ */
+export const validateQualityIntelligenceIdString = (value, kind) => {
+    if (typeof value !== "string") {
+        return { ok: false, reason: `${kind} must be a string` };
+    }
+    if (value.length === 0) {
+        return { ok: false, reason: `${kind} must not be empty` };
+    }
+    if (value.trim().length === 0) {
+        return { ok: false, reason: `${kind} must not be whitespace-only` };
+    }
+    if (value !== value.trim()) {
+        return { ok: false, reason: `${kind} must not have leading or trailing whitespace` };
+    }
+    if (value.length > QI_ID_MAX_LENGTH) {
+        return { ok: false, reason: `${kind} exceeds max length ${String(QI_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 (hasForbiddenFragment(value)) {
+        return { ok: false, reason: `${kind} contains forbidden path fragment` };
+    }
+    return { ok: true };
+};
+/**
+ * Validate `value` and return it unchanged. Throws `TypeError` on rejection. The
+ * caller casts the returned string to the appropriate branded type — keeping the
+ * cast at the constructor site rather than inside this helper avoids an
+ * unnecessary type parameter (lint: no-unnecessary-type-parameters).
+ */
+const construct = (value, kind) => {
+    const result = validateQualityIntelligenceIdString(value, kind);
+    if (!result.ok) {
+        throw new TypeError(`Invalid ${kind}: ${result.reason}`);
+    }
+    return value;
+};
+// ─── Constructors ──────────────────────────────────────────────────────────────
+export const asQualityIntelligenceRunId = (value) => construct(value, "QualityIntelligenceRunId");
+export const asQualityIntelligenceTestCaseId = (value) => construct(value, "QualityIntelligenceTestCaseId");
+export const asQualityIntelligenceCoverageMapId = (value) => construct(value, "QualityIntelligenceCoverageMapId");
+export const asQualityIntelligenceValidationFindingId = (value) => construct(value, "QualityIntelligenceValidationFindingId");
+export const asQualityIntelligenceReviewRecordId = (value) => construct(value, "QualityIntelligenceReviewRecordId");
+export const asQualityIntelligenceExportBundleId = (value) => construct(value, "QualityIntelligenceExportBundleId");
+export const asQualityIntelligenceSourceEnvelopeId = (value) => construct(value, "QualityIntelligenceSourceEnvelopeId");
+export const asQualityIntelligenceEvidenceAtomId = (value) => construct(value, "QualityIntelligenceEvidenceAtomId");
+export const asQualityIntelligenceAuditSummaryId = (value) => construct(value, "QualityIntelligenceAuditSummaryId");

package/dist/qualityIntelligence/index.d.ts

@@ -0,0 +1,29 @@
+export declare const QUALITY_INTELLIGENCE_SCHEMA_VERSION: "1";
+export type { QualityIntelligenceRunId, QualityIntelligenceTestCaseId, QualityIntelligenceCoverageMapId, QualityIntelligenceValidationFindingId, QualityIntelligenceReviewRecordId, QualityIntelligenceExportBundleId, QualityIntelligenceSourceEnvelopeId, QualityIntelligenceEvidenceAtomId, QualityIntelligenceAuditSummaryId, } from "./ids.js";
+export { asQualityIntelligenceRunId, asQualityIntelligenceTestCaseId, asQualityIntelligenceCoverageMapId, asQualityIntelligenceValidationFindingId, asQualityIntelligenceReviewRecordId, asQualityIntelligenceExportBundleId, asQualityIntelligenceSourceEnvelopeId, asQualityIntelligenceEvidenceAtomId, asQualityIntelligenceAuditSummaryId, validateQualityIntelligenceIdString, } from "./ids.js";
+export { assertQualityIntelligenceNever } from "./assertNever.js";
+export type { QualityIntelligenceSourceKind, QualityIntelligenceSourceProvenance, QualityIntelligenceRepositoryContextEnvelope, QualityIntelligenceLocalKnowledgeCapsuleEnvelope, QualityIntelligenceFigmaEvidenceEnvelope, QualityIntelligenceHumanContextEnvelope, QualityIntelligenceConnectorDocumentEnvelope, QualityIntelligenceSourceEnvelope, } from "./sourceEnvelope.js";
+export { QUALITY_INTELLIGENCE_SOURCE_KINDS, looksLikeBrowserSafeSourceEnvelope, } from "./sourceEnvelope.js";
+export type { QualityIntelligenceEvidenceAtomKind, QualityIntelligenceRedactionStatus, QualityIntelligenceLifecycleStatus, QualityIntelligenceRequirementAtom, QualityIntelligenceDesignFragmentAtom, QualityIntelligenceCodeFragmentAtom, QualityIntelligenceDocumentExcerptAtom, QualityIntelligenceHumanStatementAtom, QualityIntelligenceEvidenceAtom, } from "./evidenceAtom.js";
+export { QUALITY_INTELLIGENCE_EVIDENCE_ATOM_KINDS, QUALITY_INTELLIGENCE_REDACTION_STATUSES, QUALITY_INTELLIGENCE_LIFECYCLE_STATUSES, hasCanonicalSha256Hash, } from "./evidenceAtom.js";
+export type { QualityIntelligencePriority, QualityIntelligenceRiskClass, QualityIntelligenceTestCaseStatus, QualityIntelligenceTestCaseCandidate, } from "./testCaseCandidate.js";
+export { QUALITY_INTELLIGENCE_PRIORITIES, QUALITY_INTELLIGENCE_RISK_CLASSES, QUALITY_INTELLIGENCE_TEST_CASE_STATUSES, } from "./testCaseCandidate.js";
+export type { QualityIntelligenceCandidateEditProvenance, QualityIntelligenceCandidateEditableFields, QualityIntelligenceCandidateEditedRevision, } from "./editableRevision.js";
+export type { QualityIntelligenceCoverageKind, QualityIntelligenceCoverageMapping, QualityIntelligenceCoverageMap, } from "./coverageMap.js";
+export { QUALITY_INTELLIGENCE_COVERAGE_KINDS, assertCoverageMapInvariant } from "./coverageMap.js";
+export type { QualityIntelligenceValidationFindingKind, QualityIntelligenceSeverity, QualityIntelligenceLogicDefectFinding, QualityIntelligenceFaithfulnessDefectFinding, QualityIntelligenceSemanticDefectFinding, QualityIntelligenceMutationDefectFinding, QualityIntelligencePolicyViolationFinding, QualityIntelligenceManualRejectionFinding, QualityIntelligenceCoverageGapFinding, QualityIntelligenceTestQualityFinding, QualityIntelligenceValidationFinding, } from "./validationFinding.js";
+export { QUALITY_INTELLIGENCE_VALIDATION_FINDING_KINDS, QUALITY_INTELLIGENCE_SEVERITIES, QUALITY_INTELLIGENCE_SEVERITY_RANK, } from "./validationFinding.js";
+export type { QualityIntelligencePlannerKind, QualityIntelligenceRunStage, QualityIntelligenceRunPlan, QualityIntelligenceRunQueuedPayload, QualityIntelligenceRunStartedPayload, QualityIntelligenceStageStartedPayload, QualityIntelligenceStageCompletedPayload, QualityIntelligenceStageFailedPayload, QualityIntelligenceCandidateProposedPayload, QualityIntelligenceFindingRecordedPayload, QualityIntelligenceReviewRequestedPayload, QualityIntelligenceReviewCompletedPayload, QualityIntelligenceRunSucceededPayload, QualityIntelligenceRunFailedPayload, QualityIntelligenceRunCancelledPayload, QualityIntelligenceRunEventPayload, QualityIntelligenceRunEventKind, QualityIntelligenceRunEvent, } from "./runPlanAndEvents.js";
+export { QUALITY_INTELLIGENCE_EVENT_SCHEMA_VERSION, QUALITY_INTELLIGENCE_PLANNER_KINDS, QUALITY_INTELLIGENCE_RUN_EVENT_KINDS, assertRunEventSequenceMonotonic, } from "./runPlanAndEvents.js";
+export type { QualityIntelligenceReviewerKind, QualityIntelligenceReviewState, QualityIntelligenceReviewRecord, } from "./reviewRecord.js";
+export { QUALITY_INTELLIGENCE_REVIEWER_KINDS, QUALITY_INTELLIGENCE_REVIEW_STATES, } from "./reviewRecord.js";
+export type { QualityIntelligenceExportAdapter, QualityIntelligenceExportBundleEntry, QualityIntelligenceExportBundle, } from "./exportBundle.js";
+export { QUALITY_INTELLIGENCE_EXPORT_ADAPTERS, QUALITY_INTELLIGENCE_TMS_ADAPTERS, assertExportBundleInvariant, } from "./exportBundle.js";
+export type { QualityIntelligenceAuditTotals, QualityIntelligenceEvidenceRetentionSummary, QualityIntelligenceAuditSummary, } from "./auditSummary.js";
+export { QUALITY_INTELLIGENCE_AUDIT_MANIFEST_SCHEMA_VERSION } from "./auditSummary.js";
+export type { QualityIntelligenceHandoffPromptedAction, QualityIntelligenceHandoffChatMessageRef, QualityIntelligenceConversationCenterHandoff, } from "./handoffEnvelope.js";
+export { QUALITY_INTELLIGENCE_HANDOFF_PROMPTED_ACTIONS } from "./handoffEnvelope.js";
+export type { TestQualityDimensionName, TestQualityRubricDimension, TestQualityJudgeVerdict, } from "./testQualityRubric.js";
+export { TEST_QUALITY_RUBRIC_DIMENSIONS, TEST_QUALITY_JUDGE_RESPONSE_SCHEMA, } from "./testQualityRubric.js";
+export type { QualityIntelligenceUiRunTotals, QualityIntelligenceUiRunSummary, QualityIntelligenceUiRunListResponse, QualityIntelligenceUiFindingSummary, QualityIntelligenceUiEvidenceRef, QualityIntelligenceUiRunDetail, QualityIntelligenceUiAtomCoverage, QualityIntelligenceUiWeakTestFlag, QualityIntelligenceUiDriftMetadata, QualityIntelligenceUiCandidate, QualityIntelligenceInlineSourceKind, QualityIntelligenceRequirementsSource, QualityIntelligenceWorkspaceSource, QualityIntelligenceFileSource, QualityIntelligenceCapsuleSource, QualityIntelligenceCapsuleSetSource, QualityIntelligenceFigmaSnapshotSource, QualityIntelligenceImageSource, QualityIntelligenceInlineSource, QualityIntelligenceUiStalenessEntry, QualityIntelligenceUiStalenessReport, QualityIntelligenceUiRegenerateResult, QualityIntelligenceStartRunRequest, QualityIntelligenceSkippedSource, QualityIntelligenceRunStreamAccepted, QualityIntelligenceRunStreamEvent, QualityIntelligenceRunStreamDone, QualityIntelligenceRunStreamError, QualityIntelligenceRunStreamMessage, } from "./bffWire.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/qualityIntelligence/index.js

@@ -0,0 +1,20 @@
+// Public barrel for the Quality Intelligence contract surface (Epic #270, Issue #277).
+//
+// Pure leaf module. Re-exports every type, constant, and validator from this directory
+// for consumption via `@oscharko-dev/keiko-contracts` (which re-exports this barrel
+// under the `QualityIntelligence` namespace).
+export const QUALITY_INTELLIGENCE_SCHEMA_VERSION = "1";
+export { asQualityIntelligenceRunId, asQualityIntelligenceTestCaseId, asQualityIntelligenceCoverageMapId, asQualityIntelligenceValidationFindingId, asQualityIntelligenceReviewRecordId, asQualityIntelligenceExportBundleId, asQualityIntelligenceSourceEnvelopeId, asQualityIntelligenceEvidenceAtomId, asQualityIntelligenceAuditSummaryId, validateQualityIntelligenceIdString, } from "./ids.js";
+// ─── Exhaustiveness helper ─────────────────────────────────────────────────────
+export { assertQualityIntelligenceNever } from "./assertNever.js";
+export { QUALITY_INTELLIGENCE_SOURCE_KINDS, looksLikeBrowserSafeSourceEnvelope, } from "./sourceEnvelope.js";
+export { QUALITY_INTELLIGENCE_EVIDENCE_ATOM_KINDS, QUALITY_INTELLIGENCE_REDACTION_STATUSES, QUALITY_INTELLIGENCE_LIFECYCLE_STATUSES, hasCanonicalSha256Hash, } from "./evidenceAtom.js";
+export { QUALITY_INTELLIGENCE_PRIORITIES, QUALITY_INTELLIGENCE_RISK_CLASSES, QUALITY_INTELLIGENCE_TEST_CASE_STATUSES, } from "./testCaseCandidate.js";
+export { QUALITY_INTELLIGENCE_COVERAGE_KINDS, assertCoverageMapInvariant } from "./coverageMap.js";
+export { QUALITY_INTELLIGENCE_VALIDATION_FINDING_KINDS, QUALITY_INTELLIGENCE_SEVERITIES, QUALITY_INTELLIGENCE_SEVERITY_RANK, } from "./validationFinding.js";
+export { QUALITY_INTELLIGENCE_EVENT_SCHEMA_VERSION, QUALITY_INTELLIGENCE_PLANNER_KINDS, QUALITY_INTELLIGENCE_RUN_EVENT_KINDS, assertRunEventSequenceMonotonic, } from "./runPlanAndEvents.js";
+export { QUALITY_INTELLIGENCE_REVIEWER_KINDS, QUALITY_INTELLIGENCE_REVIEW_STATES, } from "./reviewRecord.js";
+export { QUALITY_INTELLIGENCE_EXPORT_ADAPTERS, QUALITY_INTELLIGENCE_TMS_ADAPTERS, assertExportBundleInvariant, } from "./exportBundle.js";
+export { QUALITY_INTELLIGENCE_AUDIT_MANIFEST_SCHEMA_VERSION } from "./auditSummary.js";
+export { QUALITY_INTELLIGENCE_HANDOFF_PROMPTED_ACTIONS } from "./handoffEnvelope.js";
+export { TEST_QUALITY_RUBRIC_DIMENSIONS, TEST_QUALITY_JUDGE_RESPONSE_SCHEMA, } from "./testQualityRubric.js";

package/dist/qualityIntelligence/reviewRecord.d.ts

@@ -0,0 +1,19 @@
+import type { QualityIntelligenceReviewRecordId, QualityIntelligenceRunId } from "./ids.js";
+export type QualityIntelligenceReviewerKind = "human-author" | "human-reviewer" | "judge";
+export declare const QUALITY_INTELLIGENCE_REVIEWER_KINDS: readonly QualityIntelligenceReviewerKind[];
+export type QualityIntelligenceReviewState = "open" | "approved" | "changes-requested" | "rejected" | "withdrawn";
+export declare const QUALITY_INTELLIGENCE_REVIEW_STATES: readonly QualityIntelligenceReviewState[];
+export interface QualityIntelligenceReviewRecord {
+    readonly id: QualityIntelligenceReviewRecordId;
+    readonly runId: QualityIntelligenceRunId;
+    readonly reviewerKind: QualityIntelligenceReviewerKind;
+    /** Display only; no PII guarantee. Callers must redact upstream. */
+    readonly reviewerLabel: string;
+    readonly state: QualityIntelligenceReviewState;
+    /** ISO 8601 timestamp. */
+    readonly createdAt: string;
+    /** ISO 8601 timestamp. */
+    readonly lastUpdatedAt: string;
+    readonly fourEyesPairedRecordId?: QualityIntelligenceReviewRecordId;
+}
+//# sourceMappingURL=reviewRecord.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reviewRecord.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/reviewRecord.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iCAAiC,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAE5F,MAAM,MAAM,+BAA+B,GAAG,cAAc,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAE1F,eAAO,MAAM,mCAAmC,EAAE,SAAS,+BAA+B,EAIhF,CAAC;AAEX,MAAM,MAAM,8BAA8B,GACtC,MAAM,GACN,UAAU,GACV,mBAAmB,GACnB,UAAU,GACV,WAAW,CAAC;AAEhB,eAAO,MAAM,kCAAkC,EAAE,SAAS,8BAA8B,EAM9E,CAAC;AAEX,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,EAAE,iCAAiC,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,+BAA+B,CAAC;IACvD,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAC;IAC/C,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,iCAAiC,CAAC;CACrE"}

package/dist/qualityIntelligence/reviewRecord.js

@@ -0,0 +1,20 @@
+// Quality Intelligence review record (Epic #270, Issue #277).
+//
+// A review record tracks the lifecycle of a single review (human author / human
+// reviewer / model judge) over a QI run. The `fourEyesPairedRecordId` field is
+// the optional reference linking two paired reviews when four-eyes governance
+// (#282) requires it. Identifier semantics:
+//   * `reviewerLabel` is a display string only; this contract makes NO PII guarantee.
+//   * `reviewerKind` is the structural role.
+export const QUALITY_INTELLIGENCE_REVIEWER_KINDS = [
+    "human-author",
+    "human-reviewer",
+    "judge",
+];
+export const QUALITY_INTELLIGENCE_REVIEW_STATES = [
+    "open",
+    "approved",
+    "changes-requested",
+    "rejected",
+    "withdrawn",
+];

package/dist/qualityIntelligence/runPlanAndEvents.d.ts

@@ -0,0 +1,84 @@
+import type { QualityIntelligenceEvidenceAtomId, QualityIntelligenceRunId, QualityIntelligenceTestCaseId, QualityIntelligenceValidationFindingId } from "./ids.js";
+export declare const QUALITY_INTELLIGENCE_EVENT_SCHEMA_VERSION: 1;
+export type QualityIntelligencePlannerKind = "scripted" | "model-routed";
+export declare const QUALITY_INTELLIGENCE_PLANNER_KINDS: readonly QualityIntelligencePlannerKind[];
+export interface QualityIntelligenceRunStage {
+    /** Stable stage name (e.g. "ingest", "design", "validate", "review"). */
+    readonly name: string;
+    /** Opaque descriptor identifier the runtime maps to a stage implementation. */
+    readonly descriptor: string;
+}
+export interface QualityIntelligenceRunPlan {
+    readonly id: QualityIntelligenceRunId;
+    /** ISO 8601 timestamp. */
+    readonly requestedAt: string;
+    readonly plannerKind: QualityIntelligencePlannerKind;
+    readonly stages: readonly QualityIntelligenceRunStage[];
+}
+export interface QualityIntelligenceRunQueuedPayload {
+    readonly kind: "run:queued";
+}
+export interface QualityIntelligenceRunStartedPayload {
+    readonly kind: "run:started";
+}
+export interface QualityIntelligenceStageStartedPayload {
+    readonly kind: "stage:started";
+    readonly stageName: string;
+}
+export interface QualityIntelligenceStageCompletedPayload {
+    readonly kind: "stage:completed";
+    readonly stageName: string;
+}
+export interface QualityIntelligenceStageFailedPayload {
+    readonly kind: "stage:failed";
+    readonly stageName: string;
+    /** Non-secret single-sentence failure reason; producer-redacted. */
+    readonly reasonSummary: string;
+}
+export interface QualityIntelligenceCandidateProposedPayload {
+    readonly kind: "candidate:proposed";
+    readonly candidateId: QualityIntelligenceTestCaseId;
+    readonly derivedFromAtomIds: readonly QualityIntelligenceEvidenceAtomId[];
+}
+export interface QualityIntelligenceFindingRecordedPayload {
+    readonly kind: "finding:recorded";
+    readonly findingId: QualityIntelligenceValidationFindingId;
+}
+export interface QualityIntelligenceReviewRequestedPayload {
+    readonly kind: "review:requested";
+    readonly candidateId: QualityIntelligenceTestCaseId;
+}
+export interface QualityIntelligenceReviewCompletedPayload {
+    readonly kind: "review:completed";
+    readonly candidateId: QualityIntelligenceTestCaseId;
+}
+export interface QualityIntelligenceRunSucceededPayload {
+    readonly kind: "run:succeeded";
+}
+export interface QualityIntelligenceRunFailedPayload {
+    readonly kind: "run:failed";
+    /** Non-secret single-sentence failure reason; producer-redacted. */
+    readonly reasonSummary: string;
+}
+export interface QualityIntelligenceRunCancelledPayload {
+    readonly kind: "run:cancelled";
+}
+export type QualityIntelligenceRunEventPayload = QualityIntelligenceRunQueuedPayload | QualityIntelligenceRunStartedPayload | QualityIntelligenceStageStartedPayload | QualityIntelligenceStageCompletedPayload | QualityIntelligenceStageFailedPayload | QualityIntelligenceCandidateProposedPayload | QualityIntelligenceFindingRecordedPayload | QualityIntelligenceReviewRequestedPayload | QualityIntelligenceReviewCompletedPayload | QualityIntelligenceRunSucceededPayload | QualityIntelligenceRunFailedPayload | QualityIntelligenceRunCancelledPayload;
+export type QualityIntelligenceRunEventKind = QualityIntelligenceRunEventPayload["kind"];
+export declare const QUALITY_INTELLIGENCE_RUN_EVENT_KINDS: readonly QualityIntelligenceRunEventKind[];
+export interface QualityIntelligenceRunEvent {
+    readonly eventSchemaVersion: typeof QUALITY_INTELLIGENCE_EVENT_SCHEMA_VERSION;
+    readonly runId: QualityIntelligenceRunId;
+    /** Monotonic per-run non-negative integer. */
+    readonly sequence: number;
+    /** ISO 8601 timestamp. */
+    readonly timestamp: string;
+    readonly payload: QualityIntelligenceRunEventPayload;
+}
+/**
+ * Assert sequence numbers in `events` are strictly increasing. Returns `void` on
+ * success; throws `RangeError` on the first violation (including non-integer or
+ * negative values).
+ */
+export declare const assertRunEventSequenceMonotonic: (events: readonly QualityIntelligenceRunEvent[]) => void;
+//# sourceMappingURL=runPlanAndEvents.d.ts.map

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

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

package/dist/qualityIntelligence/runPlanAndEvents.js

@@ -0,0 +1,51 @@
+// Quality Intelligence run plan + versioned run-event envelope (Epic #270, Issue #277).
+//
+// The run plan describes the deterministic stage sequence a QI run will execute. The
+// run-event envelope is the wire-stable record of what actually happened. Both are
+// versioned via the `eventSchemaVersion` literal so future evolutions land as new
+// literal members rather than mutating "1" (same rule as MEMORY_SCHEMA_VERSION /
+// CONNECTED_CONTEXT_SCHEMA_VERSION).
+//
+// Events carry a monotonic per-run `sequence` integer and an ISO 8601 `timestamp`.
+// The runtime (#273) is responsible for assigning sequences in the order events are
+// observed.
+export const QUALITY_INTELLIGENCE_EVENT_SCHEMA_VERSION = 1;
+export const QUALITY_INTELLIGENCE_PLANNER_KINDS = [
+    "scripted",
+    "model-routed",
+];
+export const QUALITY_INTELLIGENCE_RUN_EVENT_KINDS = [
+    "run:queued",
+    "run:started",
+    "stage:started",
+    "stage:completed",
+    "stage:failed",
+    "candidate:proposed",
+    "finding:recorded",
+    "review:requested",
+    "review:completed",
+    "run:succeeded",
+    "run:failed",
+    "run:cancelled",
+];
+/**
+ * Assert sequence numbers in `events` are strictly increasing. Returns `void` on
+ * success; throws `RangeError` on the first violation (including non-integer or
+ * negative values).
+ */
+export const assertRunEventSequenceMonotonic = (events) => {
+    let previous = -1;
+    for (let index = 0; index < events.length; index += 1) {
+        const event = events[index];
+        if (event === undefined) {
+            throw new RangeError(`Run event[${String(index)}] is missing`);
+        }
+        if (!Number.isInteger(event.sequence) || event.sequence < 0) {
+            throw new RangeError(`Run event[${String(index)}] has invalid sequence ${String(event.sequence)}`);
+        }
+        if (event.sequence <= previous) {
+            throw new RangeError(`Run event[${String(index)}] sequence ${String(event.sequence)} is not strictly greater than previous ${String(previous)}`);
+        }
+        previous = event.sequence;
+    }
+};

package/dist/qualityIntelligence/sourceEnvelope.d.ts

@@ -0,0 +1,77 @@
+import type { QualityIntelligenceSourceEnvelopeId } from "./ids.js";
+export type QualityIntelligenceSourceKind = "repository-context" | "local-knowledge-capsule" | "figma-evidence" | "human-context" | "connector-document";
+export declare const QUALITY_INTELLIGENCE_SOURCE_KINDS: readonly QualityIntelligenceSourceKind[];
+export interface QualityIntelligenceSourceProvenance {
+    /** Free-form origin label (e.g. "workspace", "capsule:foo"). Display only. */
+    readonly origin: string;
+    /** ISO 8601 timestamp (UTC) when the envelope was registered. */
+    readonly registeredAt: string;
+    /**
+     * Lowercase hex sha256 of the underlying content. The contract surface never
+     * carries the content itself; this hash exists so the audit ledger can detect
+     * drift between envelope registration and downstream reads.
+     */
+    readonly integrityHashSha256Hex: string;
+}
+interface QualityIntelligenceSourceEnvelopeCommon {
+    readonly id: QualityIntelligenceSourceEnvelopeId;
+    /** Non-secret display label. Must not contain credentials or URLs. */
+    readonly displayLabel: string;
+    readonly provenance: QualityIntelligenceSourceProvenance;
+}
+export interface QualityIntelligenceRepositoryContextEnvelope extends QualityIntelligenceSourceEnvelopeCommon {
+    readonly kind: "repository-context";
+    /** Opaque ref to a workspace scope or path (resolved by keiko-workspace). */
+    readonly localRef: string;
+}
+export interface QualityIntelligenceLocalKnowledgeCapsuleEnvelope extends QualityIntelligenceSourceEnvelopeCommon {
+    readonly kind: "local-knowledge-capsule";
+    /** Opaque ref to a KnowledgeCapsule (resolved by keiko-local-knowledge). */
+    readonly localRef: string;
+}
+export interface QualityIntelligenceFigmaEvidenceEnvelope extends QualityIntelligenceSourceEnvelopeCommon {
+    readonly kind: "figma-evidence";
+    /** Opaque ref to a local Figma evidence cache entry. NOT a Figma URL. */
+    readonly localRef: string;
+}
+export interface QualityIntelligenceHumanContextEnvelope extends QualityIntelligenceSourceEnvelopeCommon {
+    readonly kind: "human-context";
+    /** Opaque ref to a Conversation Center human-context note id. */
+    readonly localRef: string;
+}
+export interface QualityIntelligenceConnectorDocumentEnvelope extends QualityIntelligenceSourceEnvelopeCommon {
+    readonly kind: "connector-document";
+    /** Opaque ref to a connector-document id (resolved by an adapter). */
+    readonly localRef: string;
+    /**
+     * Stable identifier of the connector adapter that vended `localRef`. Display only;
+     * not authoritative for security decisions.
+     */
+    readonly adapterId: string;
+}
+export type QualityIntelligenceSourceEnvelope = QualityIntelligenceRepositoryContextEnvelope | QualityIntelligenceLocalKnowledgeCapsuleEnvelope | QualityIntelligenceFigmaEvidenceEnvelope | QualityIntelligenceHumanContextEnvelope | QualityIntelligenceConnectorDocumentEnvelope;
+/**
+ * Cheap structural guard: rejects envelopes that look like they may carry credentials,
+ * URLs, or oversized labels in their display surface. Pure, no IO.
+ *
+ * Scanned fields: `displayLabel`, `localRef`, `provenance.origin`, and (for
+ * `connector-document` envelopes) `adapterId`.
+ *
+ * Rejected when ANY scanned field contains:
+ *   - a URL with an authority (`scheme://` for any scheme)
+ *   - a well-known credential shape (AWS AKIA*, GitHub ghp_/gho_/github_pat_*,
+ *     Slack xox[baprs]-, OpenAI sk-*, Bearer token, PEM PRIVATE KEY header)
+ *   - an absolute filesystem path (POSIX `/`, Windows drive, or UNC `\\`)
+ *   - a bidi-override/isolate, zero-width, BOM, LRM/RLM, or Arabic-letter-mark code point
+ *
+ * Additionally rejects when:
+ *   - `displayLabel` is empty or exceeds 256 characters
+ *   - `displayLabel` looks base64-ish (≥40 chars of the base64 alphabet)
+ *   - `provenance.integrityHashSha256Hex` is not a 64-char lowercase hex string
+ *
+ * The runtime that builds envelopes is responsible for ALL redaction; this helper is
+ * a defence-in-depth check the audit ledger can use before persisting.
+ */
+export declare const looksLikeBrowserSafeSourceEnvelope: (envelope: QualityIntelligenceSourceEnvelope) => boolean;
+export {};
+//# sourceMappingURL=sourceEnvelope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceEnvelope.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/sourceEnvelope.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,UAAU,CAAC;AAEpE,MAAM,MAAM,6BAA6B,GACrC,oBAAoB,GACpB,yBAAyB,GACzB,gBAAgB,GAChB,eAAe,GACf,oBAAoB,CAAC;AAEzB,eAAO,MAAM,iCAAiC,EAAE,SAAS,6BAA6B,EAM5E,CAAC;AAEX,MAAM,WAAW,mCAAmC;IAClD,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,UAAU,uCAAuC;IAC/C,QAAQ,CAAC,EAAE,EAAE,mCAAmC,CAAC;IACjD,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,mCAAmC,CAAC;CAC1D;AAED,MAAM,WAAW,4CAA6C,SAAQ,uCAAuC;IAC3G,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gDAAiD,SAAQ,uCAAuC;IAC/G,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wCAAyC,SAAQ,uCAAuC;IACvG,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uCAAwC,SAAQ,uCAAuC;IACtG,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,4CAA6C,SAAQ,uCAAuC;IAC3G,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,iCAAiC,GACzC,4CAA4C,GAC5C,gDAAgD,GAChD,wCAAwC,GACxC,uCAAuC,GACvC,4CAA4C,CAAC;AAmDjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,kCAAkC,GAC7C,UAAU,iCAAiC,KAC1C,OAUF,CAAC"}