@oscharko-dev/keiko-workflows 0.2.0

package/dist/qualityIntelligence/index.d.ts

@@ -0,0 +1,11 @@
+export { QI_ARTIFACT_REFINEMENT_WORKFLOW_DESCRIPTOR, QI_COVERAGE_REVIEW_WORKFLOW_DESCRIPTOR, QI_TEST_DESIGN_WORKFLOW_DESCRIPTOR, QI_VALIDATION_WORKFLOW_DESCRIPTOR, QUALITY_INTELLIGENCE_DEFAULT_WORKFLOW_LIMITS, QUALITY_INTELLIGENCE_WORKFLOW_DESCRIPTORS, findQualityIntelligenceWorkflowDescriptor, } from "./descriptors.js";
+export type { QualityIntelligenceWorkflowDescriptor, QualityIntelligenceWorkflowId, QualityIntelligenceWorkflowLimits, } from "./descriptors.js";
+export { composeStageCancellation, isCancelled } from "./cancellation.js";
+export type { QualityIntelligenceStageCancellationHandle } from "./cancellation.js";
+export { runQualityIntelligenceArtifactRefinement, runQualityIntelligenceCoverageReview, runQualityIntelligenceTestDesign, runQualityIntelligenceValidation, } from "./runEntries.js";
+export type { QualityIntelligenceArtifactRefinementInput, QualityIntelligenceClock, QualityIntelligenceCoverageReviewInput, QualityIntelligenceDispatchPort, QualityIntelligenceModelRoutedDeps, QualityIntelligenceProvenanceRefs, QualityIntelligenceRunEntryDeps, QualityIntelligenceRunEventSink, QualityIntelligenceRunStatus, QualityIntelligenceRunSummary, QualityIntelligenceTestDesignInput, QualityIntelligenceValidationInput, } from "./runEntries.js";
+export { excerptsByAtomId, runQualityIntelligenceModelRoutedTestDesign, } from "./modelRoutedTestDesign.js";
+export { runScopedRegeneration } from "./scopedRegeneration.js";
+export type { ScopedRegenerationInput, ScopedRegenerationResult } from "./scopedRegeneration.js";
+export type { QualityIntelligenceCandidatesSink, QualityIntelligenceGenerationPort, QualityIntelligenceGenerationPortArgs, QualityIntelligenceGenerationPortResult, QualityIntelligenceIngestedAtom, QualityIntelligenceModelRoutedTestDesignDeps, QualityIntelligenceModelRoutedTestDesignInput, } from "./modelRoutedTestDesign.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":"AAKA,OAAO,EACL,0CAA0C,EAC1C,sCAAsC,EACtC,kCAAkC,EAClC,iCAAiC,EACjC,4CAA4C,EAC5C,yCAAyC,EACzC,yCAAyC,GAC1C,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,qCAAqC,EACrC,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,0CAA0C,EAAE,MAAM,mBAAmB,CAAC;AAEpF,OAAO,EACL,wCAAwC,EACxC,oCAAoC,EACpC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,0CAA0C,EAC1C,wBAAwB,EACxB,sCAAsC,EACtC,+BAA+B,EAC/B,kCAAkC,EAClC,iCAAiC,EACjC,+BAA+B,EAC/B,+BAA+B,EAC/B,4BAA4B,EAC5B,6BAA6B,EAC7B,kCAAkC,EAClC,kCAAkC,GACnC,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,gBAAgB,EAChB,2CAA2C,GAC5C,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACjG,YAAY,EACV,iCAAiC,EACjC,iCAAiC,EACjC,qCAAqC,EACrC,uCAAuC,EACvC,+BAA+B,EAC/B,4CAA4C,EAC5C,6CAA6C,GAC9C,MAAM,4BAA4B,CAAC"}

package/dist/qualityIntelligence/index.js

@@ -0,0 +1,11 @@
+// Public barrel for the Quality Intelligence workflow execution surface (Epic #270, Issue #273,
+// ADR-0023 D6). Re-exports the descriptors, the typed run entries, the cancellation adapter,
+// and the helper types callers need to construct inputs. The package barrel re-exports this
+// directory under the `QualityIntelligence` namespace.
+export { QI_ARTIFACT_REFINEMENT_WORKFLOW_DESCRIPTOR, QI_COVERAGE_REVIEW_WORKFLOW_DESCRIPTOR, QI_TEST_DESIGN_WORKFLOW_DESCRIPTOR, QI_VALIDATION_WORKFLOW_DESCRIPTOR, QUALITY_INTELLIGENCE_DEFAULT_WORKFLOW_LIMITS, QUALITY_INTELLIGENCE_WORKFLOW_DESCRIPTORS, findQualityIntelligenceWorkflowDescriptor, } from "./descriptors.js";
+export { composeStageCancellation, isCancelled } from "./cancellation.js";
+export { runQualityIntelligenceArtifactRefinement, runQualityIntelligenceCoverageReview, runQualityIntelligenceTestDesign, runQualityIntelligenceValidation, } from "./runEntries.js";
+// Model-routed (live LLM) test-design entry (Issue #272/#273/#279).
+export { excerptsByAtomId, runQualityIntelligenceModelRoutedTestDesign, } from "./modelRoutedTestDesign.js";
+// Scoped regeneration entry (Epic #735, Issue #743).
+export { runScopedRegeneration } from "./scopedRegeneration.js";

package/dist/qualityIntelligence/modelRoutedTestDesign.d.ts

@@ -0,0 +1,100 @@
+import { QualityIntelligence as QI } from "@oscharko-dev/keiko-contracts";
+import { type PolicyProfile } from "@oscharko-dev/keiko-quality-intelligence";
+import type { QualityIntelligenceLocalStore, QualityIntelligenceRecordOptions } from "@oscharko-dev/keiko-evidence";
+import { type QualityIntelligenceClock, type QualityIntelligenceProvenanceRefs, type QualityIntelligenceRunEventSink, type QualityIntelligenceRunSummary } from "./runtimeCommon.js";
+import type { QualityIntelligenceWorkflowLimits } from "./descriptors.js";
+type Candidate = QI.QualityIntelligenceTestCaseCandidate;
+type EvidenceAtom = QI.QualityIntelligenceEvidenceAtom;
+/** A content-bearing ingested atom: the wire-safe atom plus its server-side canonical text. */
+export interface QualityIntelligenceIngestedAtom {
+    readonly atom: EvidenceAtom;
+    readonly canonicalText: string;
+    /** Optional opaque metadata for mapping an edited source atom to its current replacement. */
+    readonly replacementGroupId?: string;
+    readonly replacementOrdinal?: number;
+}
+export interface QualityIntelligenceGenerationPortArgs {
+    readonly systemPrompt: string;
+    readonly instruction: string;
+    readonly evidence: readonly {
+        readonly index: number;
+        readonly kind: string;
+        readonly text: string;
+    }[];
+    readonly maxCandidates: number;
+    readonly signal?: AbortSignal | undefined;
+}
+export interface QualityIntelligenceGenerationPortResult {
+    readonly rawText: string;
+    readonly modelCallCount: number;
+    readonly modelId?: string | undefined;
+    /** Seed used for this generation, or null when the model does not support seeding (Epic #761). */
+    readonly seedUsed?: number | null;
+    /** Redaction-safe scalars describing request parameters (e.g. responseFormat, seed) (Epic #761). */
+    readonly modelParameters?: Record<string, unknown> | undefined;
+}
+/** Abstract model-generation seam. The server backs it with the real Keiko Model Gateway port. */
+export interface QualityIntelligenceGenerationPort {
+    readonly generate: (args: QualityIntelligenceGenerationPortArgs) => Promise<QualityIntelligenceGenerationPortResult>;
+}
+/** Persistence seam for the generated candidate bodies (companion artifact in #274). */
+export interface QualityIntelligenceCandidatesSink {
+    readonly record: (candidates: readonly Candidate[], generatedAt: string) => void;
+}
+export interface QualityIntelligenceJudgeSourceContext {
+    readonly atomId: string;
+    readonly text: string;
+}
+export interface QualityIntelligenceJudgeInput {
+    readonly candidateText: string;
+    readonly sourceContext: readonly QualityIntelligenceJudgeSourceContext[];
+}
+export interface QualityIntelligenceJudgeResult extends QI.TestQualityJudgeVerdict {
+    /**
+     * Number of actual Model Gateway dispatches made while producing this verdict.
+     * Older test doubles omit this field and are treated as one dispatch for compatibility.
+     */
+    readonly gatewayCallCount?: number;
+}
+/** Abstract model-judge seam (Epic #736, Issue #747). The server backs it with the gateway judge port. */
+export interface QualityIntelligenceJudgePort {
+    readonly judge: (input: QualityIntelligenceJudgeInput, signal?: AbortSignal) => Promise<QualityIntelligenceJudgeResult>;
+}
+export interface QualityIntelligenceModelRoutedTestDesignInput {
+    readonly plan: QI.QualityIntelligenceRunPlan;
+    readonly envelopes: readonly QI.QualityIntelligenceSourceEnvelope[];
+    readonly ingestedAtoms: readonly QualityIntelligenceIngestedAtom[];
+    readonly provenanceRefs: QualityIntelligenceProvenanceRefs;
+    readonly profile?: PolicyProfile | undefined;
+}
+export interface QualityIntelligenceModelRoutedTestDesignDeps {
+    readonly sink: QualityIntelligenceRunEventSink;
+    readonly evidenceStore: QualityIntelligenceLocalStore;
+    readonly candidatesSink: QualityIntelligenceCandidatesSink;
+    readonly generate: QualityIntelligenceGenerationPort;
+    /**
+     * Gateway calls made before this workflow context exists, such as capability-routed vision hints
+     * during server-side source ingestion. They are folded into summary + manifest evidence.
+     */
+    readonly initialModelGatewayCallCount?: number | undefined;
+    /** Optional model-judge for test-quality scoring (Epic #736). Absent → judge stage is skipped. */
+    readonly judge?: QualityIntelligenceJudgePort | undefined;
+    readonly clock?: QualityIntelligenceClock | undefined;
+    readonly signal?: AbortSignal | undefined;
+    readonly limits?: QualityIntelligenceWorkflowLimits | undefined;
+    readonly redaction?: QualityIntelligenceRecordOptions["redaction"] | undefined;
+}
+/**
+ * Map each ingested atom's id to a short, redacted excerpt of its canonical text (#790) so
+ * coverage rows and gap findings can name the requirement, not just its opaque id. Atoms whose
+ * text collapses to nothing are omitted (the optional field is simply absent downstream).
+ */
+export declare function excerptsByAtomId(ingestedAtoms: readonly QualityIntelligenceIngestedAtom[]): ReadonlyMap<string, string>;
+/**
+ * Execute a model-routed QI test-design run end to end. Emits the standard QI run-event envelope,
+ * fails the run with a safe reason when the model output is unusable (rather than silently emitting
+ * zero candidates), and persists both the run manifest and the generated candidate bodies.
+ */
+export declare function runQualityIntelligenceModelRoutedTestDesign(input: QualityIntelligenceModelRoutedTestDesignInput, deps: QualityIntelligenceModelRoutedTestDesignDeps): Promise<QualityIntelligenceRunSummary>;
+export {};
+//# sourceMappingURL=modelRoutedTestDesign.d.ts.map

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

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