@devflow-tools/semantic-engine 0.18.0

package/dist/semantic-claim-validator.js

@@ -0,0 +1,139 @@
+import { semanticEvidenceId, semanticTextHash, stableRuntimeHash, validateSemanticEvidenceSpan, } from '@devflow-tools/sdk';
+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 MEMORY_DIRECTIVES = new Set(['save', 'forget', 'recall', 'none', 'ambiguous']);
+const KNOWLEDGE_KINDS = new Set(['api', 'behavior', 'migration', 'error', 'overview']);
+export function validateSemanticClaimProposal(input) {
+    const proposal = input.proposal;
+    if (proposal.schemaVersion !== 'semantic-claim-proposal.v1') {
+        return invalid('claim_schema_unsupported');
+    }
+    const { proposalHash, ...proposalBody } = proposal;
+    if (stableRuntimeHash(proposalBody) !== proposalHash)
+        return invalid('claim_hash_mismatch');
+    if (proposal.sourceHash !== input.sourceHash
+        || semanticTextHash(input.normalizedPrompt) !== input.sourceHash) {
+        return invalid('claim_source_hash_mismatch');
+    }
+    const providerReceipt = input.providerReceipts.get(proposal.providerExecutionId);
+    if (!providerReceipt) {
+        return invalid('claim_provider_execution_unknown');
+    }
+    const { receiptHash, ...receiptBody } = providerReceipt;
+    if (stableRuntimeHash(receiptBody) !== receiptHash
+        || providerReceipt.executionId !== proposal.providerExecutionId
+        || !providerReceipt.receiptId) {
+        return invalid('claim_provider_receipt_hash_invalid');
+    }
+    if (providerReceipt.capability !== 'semantic_claims'
+        || providerReceipt.status !== 'ready'
+        || providerReceipt.requestHash !== input.sourceHash) {
+        return invalid('claim_provider_receipt_invalid');
+    }
+    if (!Number.isFinite(proposal.confidence) || proposal.confidence < 0 || proposal.confidence > 1) {
+        return invalid('claim_confidence_invalid');
+    }
+    if (!isPayloadValid(proposal.claim))
+        return invalid('claim_value_invalid');
+    if (!Array.isArray(proposal.evidence) || proposal.evidence.length === 0) {
+        return invalid('claim_evidence_missing');
+    }
+    const expectedField = evidenceField(proposal.claim.kind);
+    const expectedSource = evidenceSource(proposal.source);
+    try {
+        for (const evidence of proposal.evidence) {
+            if (evidence.field !== expectedField || evidence.source !== expectedSource) {
+                return invalid('claim_evidence_binding_invalid');
+            }
+            validateSemanticEvidenceSpan(input.normalizedPrompt, evidence);
+        }
+    }
+    catch (error) {
+        return invalid(reasonForEvidenceError(error));
+    }
+    const evidence = [...new Map(proposal.evidence
+            .map(item => [semanticEvidenceId(item), item])).entries()]
+        .sort(([left], [right]) => left.localeCompare(right));
+    if (evidence.length !== proposal.evidence.length)
+        return invalid('claim_evidence_duplicate');
+    const evidenceIds = evidence.map(([id]) => id);
+    const body = {
+        schemaVersion: 'validated-semantic-claim.v1',
+        claimId: `semantic-claim:${stableRuntimeHash({
+            proposalId: proposal.proposalId,
+            proposalHash,
+            evidenceIds,
+        }).slice(0, 32)}`,
+        proposalId: proposal.proposalId,
+        proposalHash,
+        providerExecutionId: proposal.providerExecutionId,
+        providerReceiptId: providerReceipt.receiptId,
+        sourceHash: proposal.sourceHash,
+        source: proposal.source,
+        claim: proposal.claim,
+        confidence: proposal.confidence,
+        evidence: evidence.map(([, item]) => item),
+        evidenceIds,
+    };
+    return {
+        valid: true,
+        claim: Object.freeze({ ...body, claimHash: stableRuntimeHash(body) }),
+    };
+}
+function isPayloadValid(payload) {
+    switch (payload.kind) {
+        case 'intent': return INTENTS.has(payload.value);
+        case 'action': return ACTIONS.has(payload.value);
+        case 'memory_directive': return MEMORY_DIRECTIVES.has(payload.value);
+        case 'knowledge_need':
+            return Boolean(payload.value)
+                && KNOWLEDGE_KINDS.has(payload.value.kind)
+                && optionalString(payload.value.entity)
+                && optionalString(payload.value.symbol)
+                && optionalString(payload.value.version)
+                && (payload.value.required === undefined || typeof payload.value.required === 'boolean');
+        case 'out_of_scope': return typeof payload.value === 'boolean';
+        case 'entity':
+        case 'target':
+        case 'constraint':
+        case 'negation':
+        case 'condition': return payload.value.trim().length > 0 && payload.value.length <= 2_000;
+    }
+}
+function evidenceField(kind) {
+    if (kind === 'memory_directive')
+        return 'memory';
+    if (kind === 'knowledge_need')
+        return 'knowledge';
+    if (kind === 'out_of_scope')
+        return 'intent';
+    return kind;
+}
+function evidenceSource(source) {
+    if (source === 'embedding_route')
+        return 'embedding_route';
+    if (source === 'host_sampling')
+        return 'host_sampling';
+    return 'structural';
+}
+function optionalString(value) {
+    return value === undefined || (typeof value === 'string' && value.trim().length > 0 && value.length <= 1_000);
+}
+function reasonForEvidenceError(error) {
+    const message = error instanceof Error ? error.message : '';
+    if (message === 'SEMANTIC_EVIDENCE_HASH_MISMATCH')
+        return 'claim_evidence_hash_mismatch';
+    if (message === 'SEMANTIC_EVIDENCE_SPAN_INVALID')
+        return 'claim_evidence_span_invalid';
+    return 'claim_evidence_invalid';
+}
+function invalid(reasonCode) {
+    return { valid: false, reasonCode };
+}
+//# sourceMappingURL=semantic-claim-validator.js.map

package/dist/semantic-claim-validator.js.map

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

package/dist/semantic-context-resolver.d.ts

@@ -0,0 +1,49 @@
+import { type CanonicalTaskIdentity, type ProviderExecutionReceiptV1, type ProviderExecutionStatus, type RetrievalQueryProposalV1, type RuntimeActivationSnapshotV1, type SemanticClaimProposalV1, type SemanticContextResolution, type SemanticRouteDecision, type TaskDefinitionV1 } from '@devflow-tools/sdk';
+import type { SemanticRouter } from './semantic-router.js';
+import { type StructuralSemanticEvidence } from './semantic-structural-evidence.js';
+import type { RetrievalQuerySamplingInput, RetrievalQuerySamplingOutput } from './retrieval-query-sampling-resolver.js';
+export interface HostSemanticSamplingPort {
+    sample(input: {
+        normalizedPrompt: string;
+        sourceHash: string;
+        structural: StructuralSemanticEvidence;
+        route: SemanticRouteDecision;
+        timeoutMs: number;
+    }): Promise<{
+        status: ProviderExecutionStatus;
+        proposals: SemanticClaimProposalV1[];
+        receipt: ProviderExecutionReceiptV1;
+        model?: string;
+        latencyMs?: number;
+        responseHash?: string;
+    }>;
+}
+export interface HostRetrievalQuerySamplingPort {
+    sample(input: RetrievalQuerySamplingInput): Promise<RetrievalQuerySamplingOutput>;
+}
+export interface SemanticResolutionPolicyV1 {
+    policyHash: string;
+    budgets: TaskDefinitionV1['budgets'];
+    artifactIdentityIds?: string[];
+    sourceEvidenceIds?: string[];
+    activeSkill?: string;
+}
+export declare function resolveTaskSemanticContext(input: {
+    normalizedPrompt: string;
+    sourceHash?: string;
+    identity: CanonicalTaskIdentity;
+    revision: number;
+    activation: RuntimeActivationSnapshotV1;
+    router?: Pick<SemanticRouter, 'route'>;
+    hostSampling?: HostSemanticSamplingPort;
+    retrievalQuerySampling?: HostRetrievalQuerySamplingPort;
+    queryProposals?: RetrievalQueryProposalV1[];
+    queryProposalReceipts?: ProviderExecutionReceiptV1[];
+    allowedEntityHandles?: ReadonlySet<string>;
+    allowedSourceIds?: ReadonlySet<string>;
+    command?: string;
+    targetAnchors?: string[];
+    policy: SemanticResolutionPolicyV1;
+    now?: number;
+}): Promise<SemanticContextResolution>;
+//# sourceMappingURL=semantic-context-resolver.d.ts.map

package/dist/semantic-context-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-context-resolver.d.ts","sourceRoot":"","sources":["../src/semantic-context-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,KAAK,EAAE;QACZ,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,0BAA0B,CAAC;QACvC,KAAK,EAAE,qBAAqB,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QACV,MAAM,EAAE,uBAAuB,CAAC;QAChC,SAAS,EAAE,uBAAuB,EAAE,CAAC;QACrC,OAAO,EAAE,0BAA0B,CAAC;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,2BAA2B,CAAC;IACxC,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,sBAAsB,CAAC,EAAE,8BAA8B,CAAC;IACxD,cAAc,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC5C,qBAAqB,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACrD,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,0BAA0B,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAoHrC"}

package/dist/semantic-context-resolver.js

@@ -0,0 +1,137 @@
+import { semanticTextHash, stableRuntimeHash, } from '@devflow-tools/sdk';
+import { compileSemanticAuthority } from './semantic-authority-merger.js';
+import { compileChannelQueryPlan } from './query-plan-compilers.js';
+import { extractStructuralSemanticEvidence, } from './semantic-structural-evidence.js';
+export async function resolveTaskSemanticContext(input) {
+    const now = input.now ?? Date.now();
+    const structural = extractStructuralSemanticEvidence({
+        prompt: input.normalizedPrompt,
+        command: input.command,
+        targetAnchors: input.targetAnchors,
+    });
+    const sourceHash = input.sourceHash ?? semanticTextHash(structural.normalizedPrompt);
+    if (sourceHash !== semanticTextHash(structural.normalizedPrompt)) {
+        throw new Error('SEMANTIC_CONTEXT_SOURCE_HASH_MISMATCH');
+    }
+    const route = input.activation.semantic === 'authoritative' && input.router
+        ? await input.router.route(structural.normalizedPrompt)
+        : {
+            status: 'unavailable',
+            candidates: [],
+            thresholdVersion: 'degraded-structural.v1',
+            latencyMs: 0,
+            reason: 'activation_degraded_structural',
+        };
+    const effectiveMode = input.activation.semantic === 'authoritative'
+        && input.router && route.status !== 'unavailable'
+        ? 'authoritative'
+        : 'degraded_structural';
+    const shouldSample = effectiveMode === 'authoritative'
+        && input.hostSampling
+        && (route.status === 'escalation_required' || hasCompositionalStructure(structural));
+    const sampled = shouldSample ? await input.hostSampling.sample({
+        normalizedPrompt: structural.normalizedPrompt,
+        sourceHash,
+        structural,
+        route,
+        timeoutMs: 3_000,
+    }) : undefined;
+    const resolution = await compileSemanticAuthority({
+        sourceHash,
+        structural,
+        route,
+        ...(sampled ? { sampled } : {}),
+        scopeKey: `${input.identity.projectId}:${input.identity.sessionId}:${input.identity.turnId}:${input.revision}`,
+        now,
+    });
+    const shouldSampleRetrievalQueries = input.activation.retrieval === 'authoritative'
+        && input.retrievalQuerySampling
+        && resolution.claims.length > 0
+        && resolution.dispositions.some(item => item.requirement !== 'prohibited');
+    const sampledQueries = shouldSampleRetrievalQueries
+        ? await input.retrievalQuerySampling.sample({
+            normalizedPrompt: structural.normalizedPrompt,
+            sourceHash,
+            structural,
+            route,
+            facts: resolution.facts,
+            claims: resolution.claims,
+            dispositions: resolution.dispositions,
+            timeoutMs: 30_000,
+        })
+        : undefined;
+    const finalResolution = sampledQueries
+        ? { ...resolution, providerReceipts: [...resolution.providerReceipts, sampledQueries.receipt] }
+        : resolution;
+    const plan = compileChannelQueryPlan({
+        identity: input.identity,
+        facts: resolution.facts,
+        dispositions: resolution.dispositions,
+        claims: resolution.claims,
+        query: structural.normalizedPrompt,
+        activeSkill: input.policy.activeSkill,
+        createdAt: now,
+        queryProposals: sampledQueries?.proposals ?? input.queryProposals,
+        queryProposalReceipts: sampledQueries ? [sampledQueries.receipt] : input.queryProposalReceipts,
+        allowedEntityHandles: input.allowedEntityHandles,
+        allowedSourceIds: input.allowedSourceIds,
+    });
+    const semanticContextBody = {
+        schemaVersion: 'semantic-execution-context',
+        identity: input.identity,
+        facts: resolution.facts,
+        dispositions: resolution.dispositions,
+        actionAuthority: resolution.actionAuthority,
+        plan,
+        activationSnapshotHash: input.activation.snapshotHash,
+        embeddingProfiles: input.activation.embeddingProfiles,
+        scopeBindings: {
+            project: { kind: 'project', id: input.identity.projectId },
+            session: { kind: 'session', id: input.identity.sessionId },
+            ...(input.policy.activeSkill
+                ? { skill: { kind: 'skill', id: input.policy.activeSkill } }
+                : {}),
+        },
+        mode: effectiveMode,
+        createdAt: now,
+    };
+    const semanticContextHash = stableRuntimeHash(semanticContextBody);
+    const definitionBody = {
+        schemaVersion: 'task-definition.v1',
+        identity: input.identity,
+        revision: input.revision,
+        semanticContextHash,
+        policyHash: input.policy.policyHash,
+        requirements: requirementsFor(resolution.dispositions, resolution.actionAuthority),
+        artifactIdentityIds: input.policy.artifactIdentityIds ?? [],
+        budgets: input.policy.budgets,
+        sourceEvidenceIds: input.policy.sourceEvidenceIds
+            ?? resolution.claims.flatMap(claim => claim.evidenceIds),
+    };
+    const definition = {
+        ...definitionBody,
+        definitionHash: stableRuntimeHash(definitionBody),
+    };
+    const context = {
+        ...semanticContextBody,
+        taskDefinitionHash: definition.definitionHash,
+        contextHash: semanticContextHash,
+    };
+    return { context, definition, resolution: finalResolution };
+}
+function requirementsFor(dispositions, authority) {
+    const byChannel = new Map(dispositions.map(item => [item.channel, item.requirement]));
+    const mutationRequired = authority.mutation === 'authorized' || authority.mutation === 'conditional';
+    return {
+        code: byChannel.get('code'),
+        memory: byChannel.get('memory'),
+        knowledge: byChannel.get('knowledge'),
+        action: mutationRequired ? 'required' : 'not_required',
+        verification: mutationRequired ? 'required' : 'not_required',
+    };
+}
+function hasCompositionalStructure(structural) {
+    return structural.conditions.length > 0 || structural.prohibitions.length > 0
+        || new Set(structural.positiveActionSpans.map(item => item.value)).size > 1;
+}
+//# sourceMappingURL=semantic-context-resolver.js.map

package/dist/semantic-context-resolver.js.map

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

package/dist/semantic-resolver.d.ts

@@ -0,0 +1,10 @@
+import { type SemanticResolution } from '@devflow-tools/sdk';
+import { SemanticRouter } from './semantic-router.js';
+export declare function resolveLocalSemantics(input: {
+    prompt: string;
+    router: SemanticRouter;
+    command?: string;
+    targetAnchors?: string[];
+    now?: number;
+}): Promise<SemanticResolution>;
+//# sourceMappingURL=semantic-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-resolver.d.ts","sourceRoot":"","sources":["../src/semantic-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAW9B"}

package/dist/semantic-resolver.js

@@ -0,0 +1,16 @@
+import { semanticTextHash } from '@devflow-tools/sdk';
+import { compileSemanticAuthority } from './semantic-authority-merger.js';
+import { extractStructuralSemanticEvidence } from './semantic-structural-evidence.js';
+export async function resolveLocalSemantics(input) {
+    const structural = extractStructuralSemanticEvidence(input);
+    const sourceHash = semanticTextHash(structural.normalizedPrompt);
+    const route = await input.router.route(structural.normalizedPrompt);
+    return compileSemanticAuthority({
+        sourceHash,
+        structural,
+        route,
+        scopeKey: `local:${sourceHash}`,
+        now: input.now,
+    });
+}
+//# sourceMappingURL=semantic-resolver.js.map

package/dist/semantic-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-resolver.js","sourceRoot":"","sources":["../src/semantic-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA2B,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AAEtF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAM3C;IACC,MAAM,UAAU,GAAG,iCAAiC,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACpE,OAAO,wBAAwB,CAAC;QAC9B,UAAU;QACV,UAAU;QACV,KAAK;QACL,QAAQ,EAAE,SAAS,UAAU,EAAE;QAC/B,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/semantic-route-catalog.d.ts

@@ -0,0 +1,35 @@
+import { type CanonicalTaskIntent, type KnowledgeChunkKind, type RetrievalTaskAction } from '@devflow-tools/sdk';
+interface SemanticRouteDefinitionBase {
+    id: string;
+    positives: Array<{
+        id: string;
+        text: string;
+    }>;
+    contrasts: Array<{
+        id: string;
+        text: string;
+    }>;
+}
+export type SemanticRouteDefinition = SemanticRouteDefinitionBase & ({
+    field: 'intent';
+    value: CanonicalTaskIntent;
+} | {
+    field: 'action';
+    value: RetrievalTaskAction;
+} | {
+    field: 'memory';
+    value: 'save' | 'forget' | 'recall' | 'none' | 'ambiguous';
+} | {
+    field: 'knowledge';
+    value: KnowledgeChunkKind;
+});
+export declare const SEMANTIC_ROUTE_CATALOG_SCHEMA: "semantic-route-catalog.v1";
+export declare const SEMANTIC_ROUTE_DEFINITIONS: SemanticRouteDefinition[];
+export declare const SEMANTIC_ROUTE_CATALOG: {
+    readonly schemaVersion: "semantic-route-catalog.v1";
+    readonly version: "semantic-route-catalog.v1";
+    readonly routes: SemanticRouteDefinition[];
+    readonly hash: string;
+};
+export {};
+//# sourceMappingURL=semantic-route-catalog.d.ts.map

package/dist/semantic-route-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-route-catalog.d.ts","sourceRoot":"","sources":["../src/semantic-route-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAE5B,UAAU,2BAA2B;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,GAAG,CAChE;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAC/C;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAC/C;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;CAAE,GAC/E;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CACpD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAG,2BAAoC,CAAC;AAElF,eAAO,MAAM,0BAA0B,EAAE,uBAAuB,EAyBR,CAAC;AAEzD,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC"}

package/dist/semantic-route-catalog.js

@@ -0,0 +1,53 @@
+import { semanticTextHash, } from '@devflow-tools/sdk';
+export const SEMANTIC_ROUTE_CATALOG_SCHEMA = 'semantic-route-catalog.v1';
+export const SEMANTIC_ROUTE_DEFINITIONS = [
+    route('intent:debug', 'intent', 'debug', ['fix the crash', '修复登录崩溃', 'diagnose failing build'], ['explain the design', '没有 bug']),
+    route('intent:feature', 'intent', 'feature', ['create a component', '新增搜索功能', 'implement the feature'], ['review existing code']),
+    route('intent:review', 'intent', 'review', ['review naming', '审查代码', 'analyze architecture'], ['直接修复问题']),
+    route('intent:understand', 'intent', 'understand', ['explain why', '了解实现原理', 'how does it work'], ['implement it']),
+    route('intent:memory', 'intent', 'memory', ['remember this rule', '记住项目约定', 'recall our decision'], ['memory leak']),
+    route('intent:knowledge', 'intent', 'knowledge', ['query React API', '查询框架文档', 'migration guide'], ['local component code']),
+    route('intent:performance', 'intent', 'performance', ['profile latency', '分析渲染性能', 'memory leak diagnosis'], ['not a performance issue']),
+    route('intent:refactor', 'intent', 'refactor', ['refactor the module', '重构状态管理', 'extract service'], ['explain current structure']),
+    route('action:analyze', 'action', 'analyze', ['only analyze', '只分析日志', 'explain without changes'], ['apply the fix']),
+    route('action:debug', 'action', 'debug', ['fix the bug', '修复崩溃', 'resolve the failure'], ['explain the failure only']),
+    route('action:create', 'action', 'create', ['implement a component', '新增模块', 'scaffold a page'], ['review the component']),
+    route('action:modify', 'action', 'modify', ['edit the API', '修改接口', 'refactor this file'], ['inspect the API']),
+    route('action:release', 'action', 'release', ['publish version', '发布新版本', 'run npm publish'], ['analyze release failure']),
+    route('action:build', 'action', 'build', ['run the build', '执行构建', 'compile the project'], ['build is failing; explain why']),
+    route('action:test', 'action', 'test', ['run the tests', '执行测试', 'write a regression test'], ['review test design']),
+    route('action:install', 'action', 'install', ['install dependency', '安装依赖', 'pnpm add package'], ['explain dependency choice']),
+    route('memory:save', 'memory', 'save', ['remember this convention', '记住项目约定', 'store this for later'], ['do not remember this']),
+    route('memory:forget', 'memory', 'forget', ['forget old policy', '删除这条记忆', 'remove stored convention'], ['recall the policy']),
+    route('memory:recall', 'memory', 'recall', ['recall our decision', '回忆选择原因', 'what did we decide'], ['forget it']),
+    route('knowledge:api', 'knowledge', 'api', ['API signature', '查询调用参数', 'method reference'], ['architecture overview']),
+    route('knowledge:migration', 'knowledge', 'migration', ['migration guide', '升级破坏性变更', 'migrate React 18 to 19'], ['current API signature']),
+    route('knowledge:error', 'knowledge', 'error', ['error documentation', '失败原因文档', 'exception reference'], ['framework overview']),
+    route('knowledge:overview', 'knowledge', 'overview', ['framework overview', '解释基本原理', 'introduction'], ['exact API signature']),
+    route('knowledge:behavior', 'knowledge', 'behavior', ['runtime behavior', '实现机制', 'how it behaves'], ['migration breaking changes']),
+].sort((left, right) => left.id.localeCompare(right.id));
+export const SEMANTIC_ROUTE_CATALOG = {
+    schemaVersion: SEMANTIC_ROUTE_CATALOG_SCHEMA,
+    version: 'semantic-route-catalog.v1',
+    routes: SEMANTIC_ROUTE_DEFINITIONS,
+    hash: semanticTextHash(stableCatalogJson(SEMANTIC_ROUTE_DEFINITIONS)),
+};
+function route(id, field, value, positives, contrasts) {
+    return {
+        id,
+        field,
+        value,
+        positives: positives.map((text, index) => ({ id: `${id}:p${index + 1}`, text })),
+        contrasts: contrasts.map((text, index) => ({ id: `${id}:c${index + 1}`, text })),
+    };
+}
+function stableCatalogJson(routes) {
+    return JSON.stringify(routes.map(item => ({
+        id: item.id,
+        field: item.field,
+        value: item.value,
+        positives: [...item.positives].sort((a, b) => a.id.localeCompare(b.id)),
+        contrasts: [...item.contrasts].sort((a, b) => a.id.localeCompare(b.id)),
+    })));
+}
+//# sourceMappingURL=semantic-route-catalog.js.map

package/dist/semantic-route-catalog.js.map

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

package/dist/semantic-router.d.ts

@@ -0,0 +1,39 @@
+import { type EmbeddingProviderContract, type SemanticRouteDecision } from '@devflow-tools/sdk';
+import { type SemanticRouteDefinition } from './semantic-route-catalog.js';
+export interface SemanticRouterEncoder {
+    readonly modelId: string;
+    readonly modelRevision: string;
+    warmup(): Promise<boolean>;
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+}
+export interface SemanticRouterThresholds {
+    schemaVersion: 'semantic-thresholds.v1';
+    version: string;
+    minimumScore: number;
+    minimumMargin: number;
+}
+export declare const SHADOW_SEMANTIC_THRESHOLDS: SemanticRouterThresholds;
+export declare class SemanticRouter {
+    private readonly encoder;
+    private readonly routes;
+    private readonly thresholds;
+    private embeddedRoutes;
+    private warmupPromise;
+    constructor(encoder: SemanticRouterEncoder, routes?: SemanticRouteDefinition[], thresholds?: SemanticRouterThresholds);
+    warmup(): Promise<boolean>;
+    route(prompt: string): Promise<SemanticRouteDecision>;
+    get modelId(): string;
+    get modelRevision(): string;
+    get thresholdVersion(): string;
+    private initialize;
+    private unavailable;
+}
+export declare class EmbeddingProviderSemanticEncoder implements SemanticRouterEncoder {
+    private readonly provider;
+    readonly modelId = "Xenova/all-MiniLM-L6-v2";
+    readonly modelRevision = "751bff37182d3f1213fa05d7196b954e230abad9";
+    constructor(provider: EmbeddingProviderContract);
+    warmup(): Promise<boolean>;
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+}
+//# sourceMappingURL=semantic-router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-router.d.ts","sourceRoot":"","sources":["../src/semantic-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAE3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAC;AAGrC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,wBAAwB,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,wBAKxC,CAAC;AAQF,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN7B,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,aAAa,CAAiC;gBAGnC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,GAAE,uBAAuB,EAAkC,EACjE,UAAU,GAAE,wBAAqD;IAGpF,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAOpB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiD3D,IAAI,OAAO,IAAI,MAAM,CAAiC;IACtD,IAAI,aAAa,IAAI,MAAM,CAAuC;IAClE,IAAI,gBAAgB,IAAI,MAAM,CAAoC;YAEpD,UAAU;IAuBxB,OAAO,CAAC,WAAW;CAGpB;AAED,qBAAa,gCAAiC,YAAW,qBAAqB;IAGhE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,QAAQ,CAAC,OAAO,6BAAsB;IACtC,QAAQ,CAAC,aAAa,8CAA4B;gBACrB,QAAQ,EAAE,yBAAyB;IAChE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAC1B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAOrD"}