@devflow-tools/sdk 0.17.2 → 0.17.4

package/dist/capability-rollout.js

@@ -1,5 +1,6 @@
+import { createHash } from 'node:crypto';
 import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 export const DEFAULT_CAPABILITY_ROLLOUT = Object.freeze({
     truthfulWorkflow: 'off',
     truthfulHealth: 'shadow',
@@ -150,4 +151,180 @@ function isRecord(value) {
 function isRolloutMode(value) {
     return value === 'off' || value === 'shadow' || value === 'on';
 }
+const EVIDENCE_RUNTIME_ENVIRONMENT_VARIABLES = {
+    artifactIdentity: 'DEVFLOW_EVIDENCE_ARTIFACT_IDENTITY',
+    channelOutcomes: 'DEVFLOW_EVIDENCE_CHANNEL_OUTCOMES',
+    actionLease: 'DEVFLOW_EVIDENCE_ACTION_LEASE',
+    onlineTerminalProjection: 'DEVFLOW_EVIDENCE_ONLINE_TERMINAL_PROJECTION',
+    memoryAutoSkip: 'DEVFLOW_EVIDENCE_MEMORY_AUTO_SKIP',
+    knowledgePublish: 'DEVFLOW_EVIDENCE_KNOWLEDGE_PUBLISH',
+};
+const EVIDENCE_RUNTIME_KEYS = Object.keys(EVIDENCE_RUNTIME_ENVIRONMENT_VARIABLES);
+const EVIDENCE_RUNTIME_KEY_SET = new Set(EVIDENCE_RUNTIME_KEYS);
+export const DEFAULT_EVIDENCE_RUNTIME_ROLLOUT = deepFreezeEvidenceRollout({
+    artifactIdentity: { stage: 'off' },
+    channelOutcomes: { stage: 'off' },
+    actionLease: { stage: 'off' },
+    onlineTerminalProjection: { stage: 'off' },
+    memoryAutoSkip: { stage: 'off' },
+    knowledgePublish: { stage: 'off' },
+});
+/** Resolve the independently reversible evidence-runtime rollout controls. */
+export function resolveEvidenceRuntimeRollout(projectRoot, env = process.env) {
+    const config = cloneEvidenceRollout(DEFAULT_EVIDENCE_RUNTIME_ROLLOUT);
+    const diagnostics = [];
+    const projectId = evidenceRuntimeProjectId(projectRoot);
+    const project = readEvidenceRuntimeProjectRollout(projectRoot, diagnostics);
+    if (project) {
+        for (const unknownKey of Object.keys(project).filter(key => !EVIDENCE_RUNTIME_KEY_SET.has(key)).sort()) {
+            diagnostics.push({
+                code: 'unknown_evidence_rollout_key', source: 'project', value: project[unknownKey],
+                message: `Ignoring unknown evidence runtime rollout key ${unknownKey}.`,
+            });
+        }
+        for (const key of EVIDENCE_RUNTIME_KEYS) {
+            if (project[key] === undefined)
+                continue;
+            const parsed = parseEvidenceRuntimeSetting(project[key]);
+            if (parsed)
+                config[key] = parsed;
+            else
+                diagnostics.push({
+                    code: 'invalid_evidence_rollout', source: 'project', key, value: project[key],
+                    message: `Ignoring invalid evidence runtime rollout setting for ${key}.`,
+                });
+        }
+    }
+    for (const key of EVIDENCE_RUNTIME_KEYS) {
+        const environmentVariable = EVIDENCE_RUNTIME_ENVIRONMENT_VARIABLES[key];
+        const value = env[environmentVariable];
+        if (value === undefined)
+            continue;
+        const parsed = parseEvidenceRuntimeEnvironmentSetting(value);
+        if (parsed)
+            config[key] = parsed;
+        else {
+            config[key] = cloneEvidenceSetting(DEFAULT_EVIDENCE_RUNTIME_ROLLOUT[key]);
+            diagnostics.push({
+                code: 'invalid_evidence_rollout', source: 'environment', key, environmentVariable, value,
+                message: `Ignoring invalid evidence runtime rollout setting in ${environmentVariable}.`,
+            });
+        }
+    }
+    return { config, projectId, diagnostics };
+}
+export function decideEvidenceRuntimeRollout(input) {
+    const authoritative = input.setting.stage === 'project'
+        ? input.setting.projects.includes(input.projectId)
+        : input.setting.stage === 'percentage'
+            ? evidenceRuntimeBucket(input.bucketKey, input.setting.salt) < input.setting.percentage
+            : false;
+    const readCandidate = input.setting.stage === 'project' || input.setting.stage === 'percentage'
+        ? authoritative : false;
+    return {
+        stage: input.setting.stage,
+        writeEvents: input.setting.stage !== 'off',
+        shadowCompare: input.setting.stage === 'shadow'
+            || (input.setting.stage === 'project' || input.setting.stage === 'percentage') && !authoritative,
+        readCandidate,
+        projectTerminalOutcome: readCandidate,
+        preserveEvents: true,
+        rewriteOutcomes: false,
+    };
+}
+/**
+ * Rollback retains append-only evidence by returning every active capability to
+ * shadow, while disabling all candidate reads and terminal projections.
+ */
+export function rollbackEvidenceRuntimeRollout(config) {
+    return Object.fromEntries(EVIDENCE_RUNTIME_KEYS.map(key => [
+        key,
+        config[key].stage === 'off' ? { stage: 'off' } : { stage: 'shadow' },
+    ]));
+}
+export function evidenceRuntimeProjectId(projectRoot) {
+    return createHash('sha256').update(resolve(projectRoot)).digest('hex');
+}
+function readEvidenceRuntimeProjectRollout(projectRoot, diagnostics) {
+    try {
+        const parsed = JSON.parse(readFileSync(join(projectRoot, CONFIG_PATH), 'utf8'));
+        if (!isRecord(parsed) || parsed.evidenceRuntimeRollout === undefined)
+            return null;
+        if (isRecord(parsed.evidenceRuntimeRollout))
+            return parsed.evidenceRuntimeRollout;
+        diagnostics.push({
+            code: 'invalid_evidence_rollout', source: 'project', value: parsed.evidenceRuntimeRollout,
+            message: 'Ignoring invalid evidenceRuntimeRollout project configuration.',
+        });
+    }
+    catch (error) {
+        if (!hasErrorCode(error, 'ENOENT') && !(error instanceof SyntaxError)) {
+            diagnostics.push({
+                code: 'invalid_evidence_rollout', source: 'project',
+                message: 'Could not read evidenceRuntimeRollout project configuration.',
+            });
+        }
+    }
+    return null;
+}
+function parseEvidenceRuntimeSetting(value) {
+    if (value === 'off' || value === 'shadow')
+        return { stage: value };
+    if (!isRecord(value))
+        return null;
+    if (value.stage === 'off' || value.stage === 'shadow')
+        return { stage: value.stage };
+    if (value.stage === 'project' && Array.isArray(value.projects)
+        && value.projects.every(project => typeof project === 'string' && project.trim())) {
+        return { stage: 'project', projects: [...new Set(value.projects)].sort() };
+    }
+    if (value.stage === 'percentage' && validPercentage(value.percentage)) {
+        return {
+            stage: 'percentage', percentage: value.percentage,
+            salt: typeof value.salt === 'string' && value.salt ? value.salt : 'evidence-runtime.v1',
+        };
+    }
+    return null;
+}
+function parseEvidenceRuntimeEnvironmentSetting(value) {
+    if (value === 'off' || value === 'shadow')
+        return { stage: value };
+    if (value.startsWith('project:')) {
+        const projects = value.slice('project:'.length).split(',').map(item => item.trim()).filter(Boolean);
+        return projects.length > 0 ? { stage: 'project', projects: [...new Set(projects)].sort() } : null;
+    }
+    if (value.startsWith('percentage:')) {
+        const [, rawPercentage, salt = 'evidence-runtime.v1'] = value.split(':');
+        const percentage = Number(rawPercentage);
+        return validPercentage(percentage) && salt
+            ? { stage: 'percentage', percentage, salt }
+            : null;
+    }
+    return null;
+}
+function validPercentage(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 100;
+}
+function evidenceRuntimeBucket(bucketKey, salt) {
+    const prefix = createHash('sha256').update(`${salt}\0${bucketKey}`).digest('hex').slice(0, 8);
+    return Number.parseInt(prefix, 16) / 0xffffffff * 100;
+}
+function cloneEvidenceRollout(config) {
+    return Object.fromEntries(EVIDENCE_RUNTIME_KEYS.map(key => [key, cloneEvidenceSetting(config[key])]));
+}
+function cloneEvidenceSetting(setting) {
+    if (setting.stage === 'project')
+        return { stage: 'project', projects: [...setting.projects] };
+    if (setting.stage === 'percentage')
+        return { ...setting };
+    return { stage: setting.stage };
+}
+function deepFreezeEvidenceRollout(config) {
+    for (const setting of Object.values(config)) {
+        if (setting.stage === 'project')
+            Object.freeze(setting.projects);
+        Object.freeze(setting);
+    }
+    return Object.freeze(config);
+}
 //# sourceMappingURL=capability-rollout.js.map

package/dist/capability-rollout.js.map

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

package/dist/index.d.ts

@@ -29,4 +29,9 @@ export * from "./capability-rollout.js";
 export * from "./project-capability-profile.js";
 export * from "./model-recommendation.js";
 export * from "./canonical-action-binding.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"}
+{"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;AAClC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -29,4 +29,9 @@ export * from "./capability-rollout.js";
 export * from "./project-capability-profile.js";
 export * from "./model-recommendation.js";
 export * from "./canonical-action-binding.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"}
+{"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;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":"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"}

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":""}