@devflow-tools/sdk 0.17.3 → 0.17.5

package/dist/embedding-provider-contract.d.ts

@@ -0,0 +1,15 @@
+export declare const EMBEDDING_MODEL_ID = "Xenova/all-MiniLM-L6-v2";
+export declare const EMBEDDING_MODEL_REVISION = "751bff37182d3f1213fa05d7196b954e230abad9";
+export interface EmbeddingWarmupOptions {
+    timeoutMs?: number;
+    errorLogPath?: string;
+}
+export interface EmbeddingProviderContract {
+    getStatus(): 'idle' | 'warming' | 'ready' | 'failed';
+    warmup(options?: EmbeddingWarmupOptions): Promise<boolean>;
+    embed(text: string): Promise<Float32Array>;
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+    getLastError(): string | null;
+    getLastFailure(): Error | null;
+}
+//# sourceMappingURL=embedding-provider-contract.d.ts.map

package/dist/embedding-provider-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider-contract.d.ts","sourceRoot":"","sources":["../src/embedding-provider-contract.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,eAAO,MAAM,wBAAwB,6CAA6C,CAAC;AAEnF,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,IAAI,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,MAAM,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrD,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,IAAI,KAAK,GAAG,IAAI,CAAC;CAChC"}

package/dist/embedding-provider-contract.js

@@ -0,0 +1,3 @@
+export const EMBEDDING_MODEL_ID = 'Xenova/all-MiniLM-L6-v2';
+export const EMBEDDING_MODEL_REVISION = '751bff37182d3f1213fa05d7196b954e230abad9';
+//# sourceMappingURL=embedding-provider-contract.js.map

package/dist/embedding-provider-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider-contract.js","sourceRoot":"","sources":["../src/embedding-provider-contract.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAC5D,MAAM,CAAC,MAAM,wBAAwB,GAAG,0CAA0C,CAAC"}

package/dist/embedding-provider-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedding-provider-contract.test.d.ts.map

package/dist/embedding-provider-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider-contract.test.d.ts","sourceRoot":"","sources":["../src/embedding-provider-contract.test.ts"],"names":[],"mappings":""}

package/dist/embedding-provider-contract.test.js

@@ -0,0 +1,11 @@
+import { describe, expect, expectTypeOf, it } from 'vitest';
+import { EMBEDDING_MODEL_ID, EMBEDDING_MODEL_REVISION, } from './embedding-provider-contract.js';
+describe('embedding provider contract', () => {
+    it('publishes the pinned model identity and structural provider surface', () => {
+        expect(EMBEDDING_MODEL_ID).toBe('Xenova/all-MiniLM-L6-v2');
+        expect(EMBEDDING_MODEL_REVISION).toBe('751bff37182d3f1213fa05d7196b954e230abad9');
+        expectTypeOf()
+            .returns.toEqualTypeOf();
+    });
+});
+//# sourceMappingURL=embedding-provider-contract.test.js.map

package/dist/embedding-provider-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider-contract.test.js","sourceRoot":"","sources":["../src/embedding-provider-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,kCAAkC,CAAC;AAE1C,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC3D,MAAM,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAClF,YAAY,EAA2C;aACpD,OAAO,CAAC,aAAa,EAA2B,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -29,8 +29,10 @@ export * from "./capability-rollout.js";
 export * from "./project-capability-profile.js";
 export * from "./model-recommendation.js";
 export * from "./canonical-action-binding.js";
+export * from "./embedding-provider-contract.js";
 export * from "./task-runtime.js";
 export * from "./task-runtime-reducer.js";
 export * from "./task-runtime-store.js";
 export * from "./action-lease.js";
+export * from "./semantic-resolution.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -29,8 +29,10 @@ export * from "./capability-rollout.js";
 export * from "./project-capability-profile.js";
 export * from "./model-recommendation.js";
 export * from "./canonical-action-binding.js";
+export * from "./embedding-provider-contract.js";
 export * from "./task-runtime.js";
 export * from "./task-runtime-reducer.js";
 export * from "./task-runtime-store.js";
 export * from "./action-lease.js";
+export * from "./semantic-resolution.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC"}

package/dist/semantic-resolution.d.ts

@@ -0,0 +1,104 @@
+import type { KnowledgeNeed } from './types/knowledge.js';
+import type { RetrievalTaskAction } from './types/memory.js';
+import type { CanonicalTaskIntent } from './types/task-context-envelope.js';
+export declare const TASK_SEMANTIC_FRAME_SCHEMA: "task-semantic-frame.v2";
+export declare const SEMANTIC_ROUTE_CATALOG_SCHEMA: "semantic-route-catalog.v1";
+export declare const SEMANTIC_THRESHOLD_SCHEMA: "semantic-thresholds.v1";
+export type SemanticResolutionState = 'provisional' | 'resolved' | 'abstained' | 'unavailable';
+export type SemanticResolutionMode = 'off' | 'shadow' | 'retrieval' | 'project';
+export type MutationPermission = 'explicitly_authorized' | 'explicitly_forbidden' | 'not_requested' | 'conditional' | 'ambiguous';
+export type SemanticEvidenceField = 'intent' | 'action' | 'entity' | 'target' | 'constraint' | 'negation' | 'condition' | 'memory' | 'knowledge';
+export type SemanticEvidenceSource = 'structural' | 'lexical_feature' | 'embedding_route' | 'host_sampling' | 'authority_merge';
+export interface SemanticEvidenceSpanV1 {
+    field: SemanticEvidenceField;
+    source: SemanticEvidenceSource;
+    value: string;
+    start: number;
+    end: number;
+    textHash: string;
+    confidence: number;
+}
+export interface SemanticStepV1 {
+    order: number;
+    action: RetrievalTaskAction;
+    condition?: string;
+    mutationPermission: MutationPermission;
+    evidenceIds: string[];
+}
+export interface TaskSemanticFrameV2 {
+    schemaVersion: typeof TASK_SEMANTIC_FRAME_SCHEMA;
+    sourceHash: string;
+    state: SemanticResolutionState;
+    primaryIntent: CanonicalTaskIntent;
+    primaryAction: RetrievalTaskAction;
+    mutationPermission: MutationPermission;
+    intents: CanonicalTaskIntent[];
+    entities: string[];
+    targetAnchors: string[];
+    constraints: string[];
+    negations: string[];
+    steps: SemanticStepV1[];
+    memoryDirective: 'save' | 'forget' | 'recall' | 'none' | 'ambiguous';
+    knowledgeNeeds: KnowledgeNeed[];
+    outOfScope: boolean;
+    confidence: {
+        overall: number;
+        perField: Partial<Record<SemanticEvidenceField, number>>;
+    };
+    evidence: SemanticEvidenceSpanV1[];
+    resolver: {
+        generatedBy: 'deterministic' | 'embedding_router' | 'host_semantic' | 'hybrid';
+        modelId?: string;
+        modelRevision?: string;
+        routeCatalogVersion: string;
+        thresholdVersion: string;
+    };
+    frameHash: string;
+    createdAt: number;
+}
+export interface SemanticRouteScore {
+    route: string;
+    score: number;
+    prototypeIds: string[];
+}
+export interface SemanticRouteDecision {
+    status: 'accepted' | 'escalation_required' | 'out_of_scope' | 'unavailable';
+    candidates: SemanticRouteScore[];
+    margin?: number;
+    thresholdVersion: string;
+    modelId?: string;
+    modelRevision?: string;
+    latencyMs: number;
+    reason: string;
+}
+export interface SemanticResolutionResult {
+    frame: TaskSemanticFrameV2;
+    route: SemanticRouteDecision;
+    sampling: {
+        attempted: boolean;
+        status: 'not_needed' | 'resolved' | 'unsupported' | 'timeout' | 'invalid';
+        model?: string;
+        latencyMs?: number;
+        responseHash?: string;
+    };
+    conflicts: Array<{
+        field: string;
+        leftSource: string;
+        rightSource: string;
+        resolution: 'structural_wins' | 'prohibition_wins' | 'abstain';
+    }>;
+}
+export type TaskSemanticFrameV2Input = Omit<TaskSemanticFrameV2, 'frameHash'>;
+export declare function semanticTextHash(value: string): string;
+export declare function resolveSemanticResolutionMode(projectRoot: string, env?: NodeJS.ProcessEnv): SemanticResolutionMode;
+export declare function semanticResolutionProjectHash(projectRoot: string): string;
+export declare function semanticEvidenceId(span: SemanticEvidenceSpanV1): string;
+export declare function validateSemanticEvidenceSpan(normalizedPrompt: string, span: SemanticEvidenceSpanV1): void;
+export declare function createTaskSemanticFrameV2(input: TaskSemanticFrameV2Input, normalizedPrompt: string): TaskSemanticFrameV2;
+export declare function assertTaskSemanticFrameV2(value: unknown, normalizedPrompt: string): asserts value is TaskSemanticFrameV2;
+export declare function projectSemanticFrameToLegacyIntent(frame: TaskSemanticFrameV2): {
+    intent: CanonicalTaskIntent;
+    action: RetrievalTaskAction;
+    mutating: boolean;
+};
+//# sourceMappingURL=semantic-resolution.d.ts.map

package/dist/semantic-resolution.d.ts.map

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

package/dist/semantic-resolution.js

@@ -0,0 +1,178 @@
+import { createHash } from 'node:crypto';
+import { realpathSync } from 'node:fs';
+export const TASK_SEMANTIC_FRAME_SCHEMA = 'task-semantic-frame.v2';
+export const SEMANTIC_ROUTE_CATALOG_SCHEMA = 'semantic-route-catalog.v1';
+export const SEMANTIC_THRESHOLD_SCHEMA = 'semantic-thresholds.v1';
+const INTENTS = new Set([
+    'debug', 'feature', 'refactor', 'understand', 'review', 'performance', 'memory', 'knowledge', 'unknown',
+]);
+const ACTIONS = new Set([
+    'analyze', 'debug', 'create', 'modify', 'format', 'test', 'build', 'install', 'release', 'document', 'unknown',
+]);
+const STATES = new Set(['provisional', 'resolved', 'abstained', 'unavailable']);
+const PERMISSIONS = new Set([
+    'explicitly_authorized', 'explicitly_forbidden', 'not_requested', 'conditional', 'ambiguous',
+]);
+const MEMORY_DIRECTIVES = new Set(['save', 'forget', 'recall', 'none', 'ambiguous']);
+const EVIDENCE_FIELDS = new Set([
+    'intent', 'action', 'entity', 'target', 'constraint', 'negation', 'condition', 'memory', 'knowledge',
+]);
+const EVIDENCE_SOURCES = new Set([
+    'structural', 'lexical_feature', 'embedding_route', 'host_sampling', 'authority_merge',
+]);
+const MUTATING_ACTIONS = new Set([
+    'debug', 'create', 'modify', 'format', 'test', 'build', 'install', 'release', 'document',
+]);
+export function semanticTextHash(value) {
+    return createHash('sha256').update(value.normalize('NFKC')).digest('hex');
+}
+export function resolveSemanticResolutionMode(projectRoot, env = process.env) {
+    const requested = env.DEVFLOW_SEMANTIC_RESOLUTION_MODE;
+    if (requested !== 'shadow' && requested !== 'retrieval' && requested !== 'project')
+        return 'off';
+    if (requested !== 'project')
+        return requested;
+    const allowed = new Set((env.DEVFLOW_SEMANTIC_RESOLUTION_PROJECTS ?? '')
+        .split(',').map(value => value.trim()).filter(Boolean));
+    return allowed.has(semanticResolutionProjectHash(projectRoot)) ? 'project' : 'off';
+}
+export function semanticResolutionProjectHash(projectRoot) {
+    let canonical = projectRoot;
+    try {
+        canonical = realpathSync(projectRoot);
+    }
+    catch { }
+    return semanticTextHash(canonical);
+}
+export function semanticEvidenceId(span) {
+    return semanticTextHash(canonicalJson({
+        field: span.field,
+        source: span.source,
+        value: span.value,
+        start: span.start,
+        end: span.end,
+        textHash: span.textHash,
+    }));
+}
+export function validateSemanticEvidenceSpan(normalizedPrompt, span) {
+    if (!EVIDENCE_FIELDS.has(span.field) || !EVIDENCE_SOURCES.has(span.source)) {
+        throw new Error('SEMANTIC_EVIDENCE_ENUM_INVALID');
+    }
+    if (!Number.isSafeInteger(span.start) || !Number.isSafeInteger(span.end)
+        || span.start < 0 || span.end <= span.start || span.end > normalizedPrompt.length) {
+        throw new Error('SEMANTIC_EVIDENCE_SPAN_INVALID');
+    }
+    if (!isConfidence(span.confidence))
+        throw new Error('SEMANTIC_CONFIDENCE_INVALID');
+    const text = normalizedPrompt.slice(span.start, span.end);
+    if (semanticTextHash(text) !== span.textHash) {
+        throw new Error('SEMANTIC_EVIDENCE_HASH_MISMATCH');
+    }
+}
+export function createTaskSemanticFrameV2(input, normalizedPrompt) {
+    // Callers commonly derive a revision by spreading a prior frame. Strip a
+    // stale runtime hash at this trust boundary even though the input type omits
+    // it, otherwise the old hash becomes part of the new hash preimage.
+    const { frameHash: _staleFrameHash, ...unhashedInput } = input;
+    const body = { ...unhashedInput, schemaVersion: TASK_SEMANTIC_FRAME_SCHEMA };
+    const frame = {
+        ...body,
+        frameHash: semanticTextHash(canonicalJson(body)),
+    };
+    assertTaskSemanticFrameV2(frame, normalizedPrompt);
+    return frame;
+}
+export function assertTaskSemanticFrameV2(value, normalizedPrompt) {
+    if (!isRecord(value) || value.schemaVersion !== TASK_SEMANTIC_FRAME_SCHEMA) {
+        throw new Error('SEMANTIC_FRAME_SCHEMA_UNSUPPORTED');
+    }
+    const frame = value;
+    if (!STATES.has(frame.state)
+        || !INTENTS.has(frame.primaryIntent)
+        || !ACTIONS.has(frame.primaryAction)
+        || !PERMISSIONS.has(frame.mutationPermission)
+        || !MEMORY_DIRECTIVES.has(frame.memoryDirective)) {
+        throw new Error('SEMANTIC_FRAME_ENUM_INVALID');
+    }
+    if (!isHexHash(frame.sourceHash) || !isHexHash(frame.frameHash)) {
+        throw new Error('SEMANTIC_FRAME_HASH_INVALID');
+    }
+    if (!Array.isArray(frame.intents) || frame.intents.some(intent => !INTENTS.has(intent))
+        || !Array.isArray(frame.evidence) || !Array.isArray(frame.steps)
+        || !Array.isArray(frame.entities) || !Array.isArray(frame.targetAnchors)
+        || !Array.isArray(frame.constraints) || !Array.isArray(frame.negations)
+        || !Array.isArray(frame.knowledgeNeeds)) {
+        throw new Error('SEMANTIC_FRAME_SHAPE_INVALID');
+    }
+    if (!isConfidence(frame.confidence?.overall)
+        || Object.values(frame.confidence?.perField ?? {}).some(value => !isConfidence(value))) {
+        throw new Error('SEMANTIC_CONFIDENCE_INVALID');
+    }
+    if (!Number.isSafeInteger(frame.createdAt) || frame.createdAt < 0) {
+        throw new Error('SEMANTIC_CREATED_AT_INVALID');
+    }
+    for (const evidence of frame.evidence)
+        validateSemanticEvidenceSpan(normalizedPrompt, evidence);
+    const evidenceIds = frame.evidence.map(semanticEvidenceId);
+    if (new Set(evidenceIds).size !== evidenceIds.length)
+        throw new Error('SEMANTIC_EVIDENCE_DUPLICATE');
+    const knownEvidence = new Set(evidenceIds);
+    const orders = new Set();
+    for (const step of frame.steps) {
+        if (!Number.isSafeInteger(step.order) || step.order < 0 || orders.has(step.order)
+            || !ACTIONS.has(step.action) || !PERMISSIONS.has(step.mutationPermission)
+            || !Array.isArray(step.evidenceIds) || step.evidenceIds.some(id => !knownEvidence.has(id))) {
+            throw new Error('SEMANTIC_STEP_INVALID');
+        }
+        orders.add(step.order);
+        if (step.condition && !step.evidenceIds.some(id => {
+            const index = evidenceIds.indexOf(id);
+            return index >= 0 && frame.evidence[index]?.field === 'condition';
+        }))
+            throw new Error('SEMANTIC_CONDITION_EVIDENCE_REQUIRED');
+    }
+    if (frame.state === 'resolved'
+        && frame.mutationPermission === 'explicitly_authorized'
+        && MUTATING_ACTIONS.has(frame.primaryAction)
+        && !frame.evidence.some(item => item.field === 'action')) {
+        throw new Error('SEMANTIC_ACTION_EVIDENCE_REQUIRED');
+    }
+    if (frame.steps.some(step => step.mutationPermission === 'conditional')
+        && !frame.evidence.some(item => item.field === 'condition')) {
+        throw new Error('SEMANTIC_CONDITION_EVIDENCE_REQUIRED');
+    }
+    const { frameHash, ...body } = frame;
+    if (semanticTextHash(canonicalJson(body)) !== frameHash) {
+        throw new Error('SEMANTIC_FRAME_HASH_MISMATCH');
+    }
+}
+export function projectSemanticFrameToLegacyIntent(frame) {
+    const mutating = frame.state === 'resolved'
+        && frame.mutationPermission === 'explicitly_authorized'
+        && MUTATING_ACTIONS.has(frame.primaryAction);
+    return {
+        intent: frame.primaryIntent,
+        action: mutating ? frame.primaryAction : 'analyze',
+        mutating,
+    };
+}
+function canonicalJson(value) {
+    return JSON.stringify(sortCanonical(value));
+}
+function sortCanonical(value) {
+    if (Array.isArray(value))
+        return value.map(sortCanonical);
+    if (!isRecord(value))
+        return value;
+    return Object.fromEntries(Object.keys(value).sort().map(key => [key, sortCanonical(value[key])]));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isConfidence(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 1;
+}
+function isHexHash(value) {
+    return typeof value === 'string' && /^[a-f0-9]{64}$/u.test(value);
+}
+//# sourceMappingURL=semantic-resolution.js.map

package/dist/semantic-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-resolution.js","sourceRoot":"","sources":["../src/semantic-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAKvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAiC,CAAC;AAC5E,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAAoC,CAAC;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAiC,CAAC;AAkG3E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAsB;IAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS;CACxG,CAAC,CAAC;AACH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAsB;IAC3C,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS;CAC/G,CAAC,CAAC;AACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAA0B,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;AACzG,MAAM,WAAW,GAAG,IAAI,GAAG,CAAqB;IAC9C,uBAAuB,EAAE,sBAAsB,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW;CAC7F,CAAC,CAAC;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AACrF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAwB;IACrD,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW;CACrG,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAyB;IACvD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB;CACvF,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAsB;IACpD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU;CACzF,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,WAAmB,EACnB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,SAAS,GAAG,GAAG,CAAC,gCAAgC,CAAC;IACvD,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACjG,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,oCAAoC,IAAI,EAAE,CAAC;SACrE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,WAAmB;IAC/D,IAAI,SAAS,GAAG,WAAW,CAAC;IAC5B,IAAI,CAAC;QAAC,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACvD,OAAO,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA4B;IAC7D,OAAO,gBAAgB,CAAC,aAAa,CAAC;QACpC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,gBAAwB,EACxB,IAA4B;IAE5B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;WACnE,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAA+B,EAC/B,gBAAwB;IAExB,yEAAyE;IACzE,6EAA6E;IAC7E,oEAAoE;IACpE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,GAAG,KAExD,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,aAAa,EAAE,0BAA0B,EAAE,CAAC;IAC7E,MAAM,KAAK,GAAwB;QACjC,GAAG,IAAI;QACP,SAAS,EAAE,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;KACjD,CAAC;IACF,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,gBAAwB;IAExB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,aAAa,KAAK,0BAA0B,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,KAAK,GAAG,KAAuC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;WACvB,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC;WACjC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC;WACjC,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC;WAC1C,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;WAClF,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;WAC7D,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;WACrE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;WACpE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC;WACvC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,QAAQ;QAAE,4BAA4B,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAChG,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC3D,IAAI,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACrG,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;eAC5E,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC;eACtE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC7F,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAChD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtC,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,WAAW,CAAC;QACpE,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU;WACzB,KAAK,CAAC,kBAAkB,KAAK,uBAAuB;WACpD,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC;WACzC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,kBAAkB,KAAK,aAAa,CAAC;WAClE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACrC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAA0B;IAK3E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,KAAK,UAAU;WACtC,KAAK,CAAC,kBAAkB,KAAK,uBAAuB;WACpD,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC/C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,aAAa;QAC3B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QAClD,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC"}

package/dist/semantic-resolution.test.d.ts

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

package/dist/semantic-resolution.test.d.ts.map

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

package/dist/semantic-resolution.test.js

@@ -0,0 +1,106 @@
+import { describe, expect, it } from 'vitest';
+import { createTaskSemanticFrameV2, projectSemanticFrameToLegacyIntent, semanticEvidenceId, semanticTextHash, } from './semantic-resolution.js';
+describe('semantic resolution contracts', () => {
+    it('accepts a valid resolved analysis frame', () => {
+        const prompt = 'explain the cache design';
+        const frame = createTaskSemanticFrameV2(frameInput(prompt), prompt);
+        expect(frame.frameHash).toMatch(/^[a-f0-9]{64}$/u);
+        expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
+            intent: 'understand', action: 'analyze', mutating: false,
+        });
+    });
+    it('rejects a forged source span', () => {
+        const prompt = 'publish 0.18.0';
+        const evidence = span(prompt, 'publish', 'action', 'release');
+        evidence.textHash = semanticTextHash('forged');
+        expect(() => createTaskSemanticFrameV2(frameInput(prompt, {
+            primaryIntent: 'feature',
+            primaryAction: 'release',
+            mutationPermission: 'explicitly_authorized',
+            evidence: [evidence],
+        }), prompt)).toThrow('SEMANTIC_EVIDENCE_HASH_MISMATCH');
+    });
+    it('rejects model-only mutation with no action span', () => {
+        const prompt = 'ship it';
+        expect(() => createTaskSemanticFrameV2(frameInput(prompt, {
+            primaryIntent: 'feature',
+            primaryAction: 'release',
+            mutationPermission: 'explicitly_authorized',
+        }), prompt)).toThrow('SEMANTIC_ACTION_EVIDENCE_REQUIRED');
+    });
+    it('preserves conditional steps as non-authorized', () => {
+        const prompt = 'if tests pass, publish';
+        const condition = span(prompt, 'if tests pass', 'condition', 'tests_pass');
+        const action = span(prompt, 'publish', 'action', 'release');
+        const frame = createTaskSemanticFrameV2(frameInput(prompt, {
+            primaryIntent: 'feature',
+            primaryAction: 'release',
+            mutationPermission: 'conditional',
+            evidence: [condition, action],
+            steps: [{
+                    order: 0,
+                    action: 'release',
+                    condition: 'tests_pass',
+                    mutationPermission: 'conditional',
+                    evidenceIds: [semanticEvidenceId(condition), semanticEvidenceId(action)],
+                }],
+        }), prompt);
+        expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
+            intent: 'feature', action: 'analyze', mutating: false,
+        });
+    });
+    it('projects an abstained frame to non-mutating analyze', () => {
+        const prompt = 'do it';
+        const frame = createTaskSemanticFrameV2(frameInput(prompt, {
+            state: 'abstained',
+            primaryIntent: 'unknown',
+            primaryAction: 'modify',
+            mutationPermission: 'ambiguous',
+            outOfScope: true,
+        }), prompt);
+        expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
+            intent: 'unknown', action: 'analyze', mutating: false,
+        });
+    });
+});
+function frameInput(prompt, overrides = {}) {
+    return {
+        schemaVersion: 'task-semantic-frame.v2',
+        sourceHash: semanticTextHash(prompt),
+        state: 'resolved',
+        primaryIntent: 'understand',
+        primaryAction: 'analyze',
+        mutationPermission: 'not_requested',
+        intents: ['understand'],
+        entities: [],
+        targetAnchors: [],
+        constraints: [],
+        negations: [],
+        steps: [],
+        memoryDirective: 'none',
+        knowledgeNeeds: [],
+        outOfScope: false,
+        confidence: { overall: 0.9, perField: { intent: 0.9 } },
+        evidence: [],
+        resolver: {
+            generatedBy: 'deterministic',
+            routeCatalogVersion: 'test-catalog.v1',
+            thresholdVersion: 'test-threshold.v1',
+        },
+        createdAt: 1,
+        ...overrides,
+    };
+}
+function span(prompt, text, field, value) {
+    const start = prompt.indexOf(text);
+    return {
+        field,
+        source: 'lexical_feature',
+        value,
+        start,
+        end: start + text.length,
+        textHash: semanticTextHash(text),
+        confidence: 1,
+    };
+}
+//# sourceMappingURL=semantic-resolution.test.js.map

package/dist/semantic-resolution.test.js.map

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

package/dist/types/task-semantic-control.d.ts

@@ -9,7 +9,7 @@ export interface CanonicalTaskIdentity {
     requestId: string;
     executionId?: string;
 }
-export type IntentEvidenceSource = 'slash_command' | 'explicit_action' | 'target_anchor' | 'active_skill' | 'host_semantic' | 'deterministic_parser';
+export type IntentEvidenceSource = 'slash_command' | 'explicit_action' | 'target_anchor' | 'active_skill' | 'host_semantic' | 'embedding_route' | 'authority_merge' | 'abstention' | 'deterministic_parser';
 export interface IntentEvidence {
     source: IntentEvidenceSource;
     field: 'intent' | 'action' | 'entity' | 'target' | 'constraint';
@@ -93,7 +93,7 @@ export interface CanonicalTerminalTransition {
     payload: Record<string, unknown>;
     createdAt: number;
 }
-export type SemanticControlLogEventName = 'host.prompt.normalized' | 'intent.artifact.created' | 'intent.artifact.failed' | 'intent.artifact.persisted' | 'query.plan.created' | 'artifact.inventory.completed' | 'canonical.tool.resolved' | 'canonical.action.validated' | 'mcp.action.started' | 'mcp.action.completed' | 'mcp.action.degraded' | 'mcp.action.failed' | 'retrieval.channel.completed' | 'retrieval.attribution.transitioned' | 'codegraph.edge.rejected' | 'context.build.degraded' | 'codegraph.index.completed' | 'codegraph.index.degraded' | 'codegraph.selection.completed' | 'memory.engine.transitioned' | 'memory.search.completed' | 'memory.candidates.gated' | 'memory.write.completed' | 'memory.write.degraded' | 'memory.semantic.refined' | 'memory.maintenance.completed' | 'knowledge.abstained' | 'knowledge.query.executed' | 'knowledge.source.rejected' | 'knowledge.maintenance.completed' | 'knowledge.ingest.queued' | 'knowledge.ingest.transitioned' | 'knowledge.search.completed' | 'knowledge.search.degraded' | 'memory.semantic.decided' | 'terminal.state.transitioned' | 'task.runtime.shadow_mismatch' | 'terminal.transition.persisted' | 'host.tool.result.reconciled' | 'verification.completed' | 'hook.stop.completed' | 'hook.stop.degraded' | 'hook.runtime.completed' | 'hook.runtime.degraded' | 'hook.session_end.completed' | 'hook.session_end.degraded' | 'session.reconciled' | 'durable.work.transitioned';
+export type SemanticControlLogEventName = 'host.prompt.normalized' | 'intent.artifact.created' | 'intent.artifact.failed' | 'intent.artifact.persisted' | 'query.plan.created' | 'artifact.inventory.completed' | 'canonical.tool.resolved' | 'canonical.action.validated' | 'mcp.action.started' | 'mcp.action.completed' | 'mcp.action.degraded' | 'mcp.action.failed' | 'retrieval.channel.completed' | 'retrieval.attribution.transitioned' | 'codegraph.edge.rejected' | 'context.build.degraded' | 'codegraph.index.completed' | 'codegraph.index.degraded' | 'codegraph.selection.completed' | 'memory.engine.transitioned' | 'memory.search.completed' | 'memory.candidates.gated' | 'memory.write.completed' | 'memory.write.degraded' | 'memory.semantic.refined' | 'memory.maintenance.completed' | 'knowledge.abstained' | 'knowledge.query.executed' | 'knowledge.source.rejected' | 'knowledge.maintenance.completed' | 'knowledge.ingest.queued' | 'knowledge.ingest.transitioned' | 'knowledge.search.completed' | 'knowledge.search.degraded' | 'knowledge.embedding.degraded' | 'memory.semantic.decided' | 'terminal.state.transitioned' | 'task.runtime.shadow_mismatch' | 'terminal.transition.persisted' | 'host.tool.result.reconciled' | 'verification.completed' | 'hook.stop.completed' | 'hook.stop.degraded' | 'hook.runtime.completed' | 'hook.runtime.degraded' | 'hook.session_end.completed' | 'hook.session_end.degraded' | 'session.reconciled' | 'durable.work.transitioned' | 'semantic.route.scored' | 'semantic.resolution.escalated' | 'semantic.resolution.completed' | 'semantic.resolution.abstained' | 'semantic.authority.conflicted' | 'semantic.regex.shadow_mismatch' | 'semantic.model.profile_evaluated';
 export interface SemanticControlLogEvent {
     event: SemanticControlLogEventName;
     identity: Partial<CanonicalTaskIdentity> & Pick<CanonicalTaskIdentity, 'projectRoot'> & {

package/dist/types/task-semantic-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-semantic-control.d.ts","sourceRoot":"","sources":["../../src/types/task-semantic-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,eAAe,GACf,sBAAsB,CAAC;AAE3B,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,sBAAsB,EAAE,cAAc,EAAE,CAAC;IACzC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,KAAK,CAAC,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IACzF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,MAAM,oBAAoB,GAC5B,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB,GACxB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,oBAAoB,CAAC;IAClC,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,2BAA2B,GACnC,6BAA6B,GAC7B,yBAAyB,GACzB,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,GAC1B,wBAAwB,GACxB,0BAA0B,GAC1B,2BAA2B,GAC3B,iBAAiB,GACjB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,2BAA2B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,WAAW,EAAE,eAAe,GAAG,eAAe,GAAG,QAAQ,CAAC;IAC1D,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,sBAAsB,GAC9B,gBAAgB,GAChB,gBAAgB,GAChB,sBAAsB,GACtB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,MAAM,MAAM,wBAAwB,GAChC,KAAK,GACL,WAAW,GACX,WAAW,GACX,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,cAAc,GACd,eAAe,GACf,kBAAkB,GAClB,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,QAAQ,GACR,yBAAyB,GACzB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,2BAA2B,GACnC,wBAAwB,GACxB,yBAAyB,GACzB,wBAAwB,GACxB,2BAA2B,GAC3B,oBAAoB,GACpB,8BAA8B,GAC9B,yBAAyB,GACzB,4BAA4B,GAC5B,oBAAoB,GACpB,sBAAsB,GACtB,qBAAqB,GACrB,mBAAmB,GACnB,6BAA6B,GAC7B,oCAAoC,GACpC,yBAAyB,GACzB,wBAAwB,GACxB,2BAA2B,GAC3B,0BAA0B,GAC1B,+BAA+B,GAC/B,4BAA4B,GAC5B,yBAAyB,GACzB,yBAAyB,GACzB,wBAAwB,GACxB,uBAAuB,GACvB,yBAAyB,GACzB,8BAA8B,GAC9B,qBAAqB,GACrB,0BAA0B,GAC1B,2BAA2B,GAC3B,iCAAiC,GACjC,yBAAyB,GACzB,+BAA+B,GAC/B,4BAA4B,GAC5B,2BAA2B,GAC3B,yBAAyB,GACzB,6BAA6B,GAC7B,8BAA8B,GAC9B,+BAA+B,GAC/B,6BAA6B,GAC7B,wBAAwB,GACxB,qBAAqB,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,uBAAuB,GACvB,4BAA4B,GAC5B,2BAA2B,GAC3B,oBAAoB,GACpB,2BAA2B,CAAC;AAEhC,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,2BAA2B,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC,qBAAqB,EAAE,aAAa,CAAC,GAAG;QACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yFAAyF;AACzF,MAAM,MAAM,eAAe,GAAG,OAAO,oBAAoB,EAAE,UAAU,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,OAAO,oBAAoB,EAAE,kBAAkB,CAAC;AAC/E,MAAM,MAAM,mBAAmB,GAAG,OAAO,oBAAoB,EAAE,qBAAqB,CAAC"}
+{"version":3,"file":"task-semantic-control.d.ts","sourceRoot":"","sources":["../../src/types/task-semantic-control.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/sdk",
-  "version": "0.17.3",
+  "version": "0.17.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -37,7 +37,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@devflow-tools/database": "0.17.3",
+    "@devflow-tools/database": "0.17.4",
     "tiktoken": "^1.0.0"
   },
   "devDependencies": {
@@ -47,5 +47,5 @@
   "files": [
     "dist"
   ],
-  "gitHead": "964af33767bf232606e63d973b3a29d7d53c8119"
+  "gitHead": "817b0286c249eed9c2bd27d3974ee3b3d6ded4bb"
 }