sdd-agent-platform 0.3.0 → 0.4.0

package/packages/core/dist/router/profile-resolution.js

@@ -0,0 +1,127 @@
+import { BUILT_IN_AGENT_PROFILES } from './runtime-registry.js';
+import { hasExternalUnknownRisk, hasSecurityRisk } from './risk-policy.js';
+export function deriveAllowedProfiles(task, registry, matchedRules) {
+    const profiles = new Set();
+    const resolvedAliases = [];
+    for (const value of [...task.allowedAgents, ...task.agentFit]) {
+        for (const token of value.split(/[\s,\/]+/).filter(Boolean)) {
+            const resolution = resolveAgentProfileToken(token, registry);
+            if (resolution.profile) {
+                profiles.add(resolution.profile);
+            }
+            appendAliasResolution(resolvedAliases, resolution.alias);
+        }
+    }
+    for (const rule of matchedRules) {
+        const resolution = resolveAgentProfileToken(rule.preferProfile, registry);
+        if (resolution.profile) {
+            profiles.add(resolution.profile);
+        }
+        appendAliasResolution(resolvedAliases, resolution.alias);
+    }
+    if (profiles.size === 0) {
+        for (const profile of fallbackProfilesForTask(task)) {
+            addRegisteredProfile(profiles, profile, registry);
+        }
+    }
+    return { profiles: [...profiles], resolvedAliases };
+}
+export function toAgentProfileId(value, registry) {
+    return resolveAgentProfileToken(value, registry).profile;
+}
+export function resolveAgentProfileToken(value, registry) {
+    const directProfile = registry ? findRegisteredProfile(value, registry) : findBuiltInProfile(value);
+    if (directProfile) {
+        return { profile: directProfile.id, alias: null };
+    }
+    const builtInAlias = builtInProfileAliasTarget(value);
+    const builtInProfile = builtInAlias ? registry ? findRegisteredProfile(builtInAlias, registry) : findBuiltInProfile(builtInAlias) : null;
+    if (builtInProfile) {
+        return { profile: builtInProfile.id, alias: { input: value, resolved: builtInProfile.id, source: 'built_in' } };
+    }
+    if (registry) {
+        for (const [alias, target] of Object.entries(registry.aliases)) {
+            if (normalizeAgentToken(alias) !== normalizeAgentToken(value)) {
+                continue;
+            }
+            const aliasTarget = findRegisteredProfile(target, registry) ?? (builtInProfileAliasTarget(target) ? findRegisteredProfile(builtInProfileAliasTarget(target), registry) : null);
+            if (aliasTarget) {
+                return { profile: aliasTarget.id, alias: { input: value, resolved: aliasTarget.id, source: 'project_config' } };
+            }
+        }
+    }
+    return { profile: null, alias: null };
+}
+export function findRegisteredProfile(value, registry) {
+    const normalized = normalizeAgentToken(value);
+    return registry.profiles.find((profile) => normalizeAgentToken(profile.id) === normalized) ?? null;
+}
+export function findBuiltInProfile(value) {
+    const normalized = normalizeAgentToken(value);
+    return BUILT_IN_AGENT_PROFILES.find((profile) => normalizeAgentToken(profile.id) === normalized) ?? null;
+}
+export function chooseRecommendedProfile(task, allowedProfiles, registry, matchedRules) {
+    if (hasSecurityRisk(task.risk)) {
+        return allowedProfiles.includes('security') ? 'security' : allowedProfiles[0] ?? 'security';
+    }
+    if (hasExternalUnknownRisk(task.risk)) {
+        return allowedProfiles.includes('researcher') ? 'researcher' : allowedProfiles[0] ?? 'researcher';
+    }
+    if (task.status === 'completed') {
+        return allowedProfiles.includes('validator') ? 'validator' : allowedProfiles[0] ?? 'validator';
+    }
+    const preferredByRule = matchedRules.map((rule) => resolveAgentProfileToken(rule.preferProfile, registry).profile).find((profile) => Boolean(profile));
+    if (preferredByRule && allowedProfiles.includes(preferredByRule)) {
+        return preferredByRule;
+    }
+    if (allowedProfiles.includes('implementer')) {
+        return 'implementer';
+    }
+    return allowedProfiles[0] ?? 'implementer';
+}
+function appendAliasResolution(resolvedAliases, alias) {
+    if (!alias) {
+        return;
+    }
+    if (!resolvedAliases.some((candidate) => candidate.input === alias.input && candidate.resolved === alias.resolved && candidate.source === alias.source)) {
+        resolvedAliases.push(alias);
+    }
+}
+function builtInProfileAliasTarget(value) {
+    const normalized = normalizeAgentToken(value);
+    if (normalized === 'scout') {
+        return 'researcher';
+    }
+    if (normalized === 'debugger') {
+        return 'implementer';
+    }
+    if (normalized === 'spec_reviewer') {
+        return 'reviewer';
+    }
+    if (normalized === 'domain') {
+        return 'domain_expert';
+    }
+    return null;
+}
+function addRegisteredProfile(profiles, profileId, registry) {
+    const profile = findRegisteredProfile(profileId, registry);
+    if (profile) {
+        profiles.add(profile.id);
+    }
+}
+function fallbackProfilesForTask(task) {
+    if (hasSecurityRisk(task.risk)) {
+        return ['security', 'reviewer'];
+    }
+    if (hasExternalUnknownRisk(task.risk)) {
+        return ['researcher', 'architect'];
+    }
+    if (task.status === 'completed') {
+        return ['validator', 'reviewer'];
+    }
+    return ['implementer', 'reviewer', 'validator'];
+}
+function normalizeAgentToken(value) {
+    return value.trim().toLowerCase().replace(/-/g, '_');
+}
+//# sourceMappingURL=profile-resolution.js.map

package/packages/core/dist/router/profile-resolution.js.map

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

package/packages/core/dist/router/risk-policy.d.ts

@@ -0,0 +1,6 @@
+import type { LifecycleAutonomyCeiling } from '../lifecycle/decision-gate.js';
+import type { SddTask } from '../sdd-docs/task-parser.js';
+export declare function taskAutonomyCeiling(task: SddTask): LifecycleAutonomyCeiling;
+export declare function hasSecurityRisk(risk: string[]): boolean;
+export declare function hasExternalUnknownRisk(risk: string[]): boolean;
+export declare function isHighRiskValues(risk: string[]): boolean;

package/packages/core/dist/router/risk-policy.js

@@ -0,0 +1,28 @@
+import { buildTaskRiskProfile } from '../task-risk-profile.js';
+export function taskAutonomyCeiling(task) {
+    const declared = task.autonomy?.trim();
+    if (declared === 'direct_execution_allowed' || declared === 'compact_boundary_only' || declared === 'full_sdd_with_checkpoint' || declared === 'research_before_implementation') {
+        return declared;
+    }
+    const profile = buildTaskRiskProfile(task);
+    if (profile.externalUnknown) {
+        return 'research_before_implementation';
+    }
+    if (profile.riskLevel === 'high') {
+        return 'full_sdd_with_checkpoint';
+    }
+    if (profile.riskLevel === 'medium') {
+        return 'compact_boundary_only';
+    }
+    return 'direct_execution_allowed';
+}
+export function hasSecurityRisk(risk) {
+    return buildTaskRiskProfile({ id: null, risk, affectedFiles: [], validation: [], requiredArtifacts: [] }).securitySensitive;
+}
+export function hasExternalUnknownRisk(risk) {
+    return buildTaskRiskProfile({ id: null, risk, affectedFiles: [], validation: [], requiredArtifacts: [] }).externalUnknown;
+}
+export function isHighRiskValues(risk) {
+    return buildTaskRiskProfile({ id: null, risk, affectedFiles: [], validation: [], requiredArtifacts: [] }).riskLevel === 'high';
+}
+//# sourceMappingURL=risk-policy.js.map

package/packages/core/dist/router/risk-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-policy.js","sourceRoot":"","sources":["../../src/router/risk-policy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,QAAQ,KAAK,0BAA0B,IAAI,QAAQ,KAAK,uBAAuB,IAAI,QAAQ,KAAK,0BAA0B,IAAI,QAAQ,KAAK,gCAAgC,EAAE,CAAC;QAChL,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,0BAA0B,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,OAAO,oBAAoB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC;AAC9H,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAc;IACnD,OAAO,oBAAoB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC;AAC5H,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,OAAO,oBAAoB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC;AACjI,CAAC"}

package/packages/core/dist/router/route-cache.d.ts

@@ -0,0 +1,39 @@
+import { AGENT_ROUTER_CONTRACT_VERSION, ROUTE_CACHE_CONTRACT_VERSION, RUNTIME_PROFILE_CONTRACT_VERSION } from '../contracts.js';
+export type TeamModeActivation = 'auto' | 'force' | 'off';
+export interface RouteCacheMetadata {
+    contract: typeof ROUTE_CACHE_CONTRACT_VERSION;
+    key: string;
+    status: 'hit' | 'miss' | 'stored';
+    source: 'content_addressed_derived_route';
+    authoritative: false;
+}
+export interface RuntimeProfileSpan {
+    contract: typeof RUNTIME_PROFILE_CONTRACT_VERSION;
+    name: string;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+}
+export interface RouteCacheDocuments {
+    specHash?: string | null;
+    planHash?: string | null;
+    tasksHash?: string | null;
+    planBasedOnSpecHash?: string | null;
+    tasksBasedOnPlanHash?: string | null;
+}
+export interface CacheableRouteDecision {
+    version: typeof AGENT_ROUTER_CONTRACT_VERSION;
+    cache?: RouteCacheMetadata;
+    profile?: RuntimeProfileSpan[];
+}
+export declare function runtimeProfileSpan(name: string, startedAtMs: number, startedAt?: string): RuntimeProfileSpan;
+export declare function routeCacheKey(input: {
+    taskId: string;
+    branch: string;
+    agent: string | null;
+    teamModeActivation: TeamModeActivation;
+    approved?: boolean;
+    documents: RouteCacheDocuments;
+}): string;
+export declare function readRouteCache<TDecision extends CacheableRouteDecision>(projectRoot: string, key: string): Promise<TDecision | null>;
+export declare function writeRouteCache<TDecision extends CacheableRouteDecision>(projectRoot: string, key: string, decision: TDecision): Promise<void>;

package/packages/core/dist/router/route-cache.js

@@ -0,0 +1,59 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { ACCEPTANCE_POLICY_RULESET_VERSION, AGENT_ROUTER_CONTRACT_VERSION, AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, ROUTE_CACHE_CONTRACT_VERSION, RUNTIME_PROFILE_CONTRACT_VERSION, TEAM_MODE_POLICY_VERSION } from '../contracts.js';
+import { getRouteCachePath } from '../runtime-paths.js';
+import { exists } from '../storage/json-io.js';
+import { TOOL_CAPABILITY_REGISTRY_VERSION } from '../registries/tool-capabilities.js';
+import { TOOL_PLUGIN_CONTRACT_REGISTRY_VERSION } from '../registries/tool-plugins.js';
+import { WORKER_ADAPTER_CONTRACT_REGISTRY_VERSION } from '../registries/worker-adapters.js';
+export function runtimeProfileSpan(name, startedAtMs, startedAt = new Date(startedAtMs).toISOString()) {
+    const endedAtMs = Date.now();
+    return {
+        contract: RUNTIME_PROFILE_CONTRACT_VERSION,
+        name,
+        startedAt,
+        endedAt: new Date(endedAtMs).toISOString(),
+        durationMs: Math.max(0, endedAtMs - startedAtMs)
+    };
+}
+export function routeCacheKey(input) {
+    return createHash('sha256')
+        .update(JSON.stringify({
+        contract: ROUTE_CACHE_CONTRACT_VERSION,
+        router: AGENT_ROUTER_CONTRACT_VERSION,
+        teamMode: TEAM_MODE_POLICY_VERSION,
+        policy: ACCEPTANCE_POLICY_RULESET_VERSION,
+        runtime: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION,
+        capabilities: TOOL_CAPABILITY_REGISTRY_VERSION,
+        plugins: TOOL_PLUGIN_CONTRACT_REGISTRY_VERSION,
+        workers: WORKER_ADAPTER_CONTRACT_REGISTRY_VERSION,
+        taskId: input.taskId,
+        branch: input.branch,
+        agent: input.agent,
+        teamModeActivation: input.teamModeActivation,
+        approved: input.approved === true,
+        specHash: input.documents.specHash ?? null,
+        planHash: input.documents.planHash ?? null,
+        tasksHash: input.documents.tasksHash ?? null,
+        planBasedOnSpecHash: input.documents.planBasedOnSpecHash ?? null,
+        tasksBasedOnPlanHash: input.documents.tasksBasedOnPlanHash ?? null
+    }))
+        .digest('hex')
+        .slice(0, 32);
+}
+export async function readRouteCache(projectRoot, key) {
+    const cachePath = getRouteCachePath(projectRoot, key);
+    if (!await exists(cachePath)) {
+        return null;
+    }
+    const parsed = JSON.parse(await readFile(cachePath, 'utf8'));
+    return parsed.version === AGENT_ROUTER_CONTRACT_VERSION ? parsed : null;
+}
+export async function writeRouteCache(projectRoot, key, decision) {
+    const cachePath = getRouteCachePath(projectRoot, key);
+    await mkdir(path.dirname(cachePath), { recursive: true });
+    const { cache: _cache, profile: _profile, ...cacheable } = decision;
+    await writeFile(cachePath, `${JSON.stringify(cacheable, null, 2)}\n`, 'utf8');
+}
+//# sourceMappingURL=route-cache.js.map

package/packages/core/dist/router/route-cache.js.map

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

package/packages/core/dist/router/route-projection.d.ts

@@ -0,0 +1,12 @@
+import type { LifecycleAutonomyCeiling } from '../lifecycle/decision-gate.js';
+import type { SddTask, SddTaskGap } from '../sdd-docs/task-parser.js';
+import type { AgentProfileId, AgentRouterCategory, AgentRouterRejectedProfile, AgentRuntimeAdapterMapping, AgentRuntimeRoutingRule, ModelPolicyContract, RuntimeRegistryEntrySource, ToolPermissionSpec } from './agent-runtime.js';
+import { type AgentSkillRuntimeRegistry } from './runtime-registry.js';
+export declare function routeCategory(task: SddTask, blockingGap: SddTaskGap | undefined, allowedProfiles?: AgentProfileId[], matchedRules?: AgentRuntimeRoutingRule[]): AgentRouterCategory;
+export declare function selectRequiredSkillCapabilities(task: SddTask, profile: AgentProfileId, registry: AgentSkillRuntimeRegistry, matchedRules: AgentRuntimeRoutingRule[]): string[];
+export declare function routeRegistrySources(registry: AgentSkillRuntimeRegistry, profile: AgentProfileId | null, capabilityIds: string[]): RuntimeRegistryEntrySource[];
+export declare function quarantineWarningsForSources(sources: RuntimeRegistryEntrySource[]): string[];
+export declare function adapterMappingForProfile(registry: AgentSkillRuntimeRegistry, profile: AgentProfileId): AgentRuntimeAdapterMapping | null;
+export declare function buildToolPermissionSpec(task: SddTask, profile: AgentProfileId, autonomyCeiling: LifecycleAutonomyCeiling, registry?: AgentSkillRuntimeRegistry): ToolPermissionSpec;
+export declare function modelPolicyForProfile(profile: AgentProfileId | null, registry?: AgentSkillRuntimeRegistry): ModelPolicyContract;
+export declare function buildRejectedProfiles(allowedProfiles: AgentProfileId[], blockedReason: string | null, registry: AgentSkillRuntimeRegistry): AgentRouterRejectedProfile[];

package/packages/core/dist/router/route-projection.js

@@ -0,0 +1,127 @@
+import { TOOL_PERMISSION_SPEC_VERSION } from '../contracts.js';
+import { BUILT_IN_MODEL_POLICIES, registrySourceFor } from './runtime-registry.js';
+import { findBuiltInProfile, findRegisteredProfile, resolveAgentProfileToken } from './profile-resolution.js';
+import { hasExternalUnknownRisk, hasSecurityRisk, isHighRiskValues } from './risk-policy.js';
+export function routeCategory(task, blockingGap, allowedProfiles = [], matchedRules = []) {
+    if (blockingGap) {
+        return 'blocked';
+    }
+    if (hasSecurityRisk(task.risk)) {
+        return 'security_research';
+    }
+    if (hasExternalUnknownRisk(task.risk)) {
+        return 'external_research';
+    }
+    if (task.status === 'completed') {
+        return 'validation';
+    }
+    const ruleCategory = matchedRules.find((rule) => rule.category)?.category;
+    if (ruleCategory) {
+        return ruleCategory;
+    }
+    if (allowedProfiles.every((profile) => profile === 'planner' || profile === 'architect' || profile === 'researcher')) {
+        return 'planning';
+    }
+    if (allowedProfiles.includes('reviewer') && !allowedProfiles.includes('implementer')) {
+        return 'implementation_review';
+    }
+    return 'implementation';
+}
+export function selectRequiredSkillCapabilities(task, profile, registry, matchedRules) {
+    const capabilities = new Set(['host.search.grep_glob']);
+    const profileContract = findRegisteredProfile(profile, registry);
+    for (const capabilityId of profileContract?.hostCapabilityRequirements ?? []) {
+        capabilities.add(capabilityId);
+    }
+    for (const rule of matchedRules) {
+        for (const capabilityId of rule.requireCapabilities) {
+            capabilities.add(capabilityId);
+        }
+    }
+    if (profile === 'researcher' || profile === 'planner' || profile === 'architect' || hasExternalUnknownRisk(task.risk)) {
+        capabilities.add('claude.subagent.researcher');
+        capabilities.add('context7.docs');
+    }
+    if (profile === 'implementer') {
+        capabilities.add('claude.subagent.implementer');
+        capabilities.add('host.edit.hashline');
+        capabilities.add('host.cli.shell');
+    }
+    if (profile === 'reviewer') {
+        capabilities.add('host.cli.shell');
+    }
+    if (profile === 'validator') {
+        capabilities.add('host.cli.shell');
+        if (task.validation.some((item) => /browser|ui|frontend|playwright|页面|前端/i.test(item))) {
+            capabilities.add('playwright.browser_validation');
+        }
+    }
+    if (profile === 'security' || hasSecurityRisk(task.risk)) {
+        capabilities.add('pattern.ohmy.security_research');
+    }
+    if (profile === 'domain_expert') {
+        capabilities.add('external.agency_agents.material');
+    }
+    return [...capabilities];
+}
+export function routeRegistrySources(registry, profile, capabilityIds) {
+    const selected = [];
+    const seen = new Set();
+    const pushSource = (source) => {
+        if (!source) {
+            return;
+        }
+        const key = `${source.kind}:${source.id}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            selected.push(source);
+        }
+    };
+    if (profile) {
+        pushSource(registrySourceFor(registry, 'profile', profile));
+    }
+    for (const capabilityId of capabilityIds) {
+        const capabilitySource = registrySourceFor(registry, 'skill_capability', capabilityId);
+        pushSource(capabilitySource);
+        if (capabilitySource?.sourceId) {
+            pushSource(registrySourceFor(registry, 'capability_source', capabilitySource.sourceId));
+        }
+    }
+    return selected;
+}
+export function quarantineWarningsForSources(sources) {
+    return sources.filter((source) => source.quarantineRequired).map((source) => `${source.kind}:${source.id} originates from quarantined material and remains declarative metadata only.`);
+}
+export function adapterMappingForProfile(registry, profile) {
+    return registry.adapterMappings.find((mapping) => resolveAgentProfileToken(mapping.profile, registry).profile === profile) ?? null;
+}
+export function buildToolPermissionSpec(task, profile, autonomyCeiling, registry) {
+    const highRisk = isHighRiskValues(task.risk);
+    const readonlyProfiles = ['planner', 'architect', 'researcher', 'reviewer', 'security', 'domain_expert'];
+    const profileContract = registry ? findRegisteredProfile(profile, registry) : null;
+    const toolGroups = profileContract && !findBuiltInProfile(profile) ? [...profileContract.toolScope] : readonlyProfiles.includes(profile) ? ['read', 'search', 'docs'] : profile === 'validator' ? ['read', 'test', 'browser'] : ['read', 'edit', 'test'];
+    return {
+        version: TOOL_PERMISSION_SPEC_VERSION,
+        profile,
+        risk: [...task.risk],
+        toolGroups,
+        fileScope: task.affectedFiles.length > 0 ? [...task.affectedFiles] : ['declared task boundary', 'artifacts/<task>.md'],
+        policy: highRisk || autonomyCeiling === 'full_sdd_with_checkpoint' || autonomyCeiling === 'research_before_implementation' ? 'ask' : 'allow',
+        approvalPolicy: highRisk ? 'human checkpoint required before write or external side effect' : 'host approval policy applies',
+        runtimeValidationRequired: highRisk || profile === 'implementer' || profile === 'validator',
+        deniedTools: profile === 'security' ? ['destructive_exploit', 'dos', 'credential_exfiltration', 'detection_evasion'] : ['destructive_git', 'unscoped_external_write'],
+        hostPermissionProjection: `profile=${profile}; autonomy=${autonomyCeiling}; policy=${highRisk ? 'ask' : 'host-default'}`
+    };
+}
+export function modelPolicyForProfile(profile, registry) {
+    const profileContract = profile && registry ? findRegisteredProfile(profile, registry) : null;
+    const policyId = profileContract?.modelPolicyId ?? (profile === 'security' ? 'security_review' : profile === 'planner' || profile === 'architect' || profile === 'reviewer' || profile === 'researcher' || profile === 'orchestrator' ? 'reasoning' : 'balanced');
+    return BUILT_IN_MODEL_POLICIES.find((policy) => policy.id === policyId) ?? BUILT_IN_MODEL_POLICIES[0];
+}
+export function buildRejectedProfiles(allowedProfiles, blockedReason, registry) {
+    const allowed = new Set(allowedProfiles);
+    return registry.profiles
+        .filter((profile) => !allowed.has(profile.id))
+        .map((profile) => ({ profile: profile.id, reason: blockedReason ?? 'Profile is outside task metadata allowed_agents/agent_fit, routing rules, or router risk category.' }));
+}
+//# sourceMappingURL=route-projection.js.map

package/packages/core/dist/router/route-projection.js.map

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

package/packages/core/dist/router/route-sdd-task.d.ts

@@ -0,0 +1,3 @@
+export * from './runtime-inspection.js';
+export * from './runtime-validation.js';
+export * from './routing.js';

package/packages/core/dist/router/route-sdd-task.js

@@ -0,0 +1,4 @@
+export * from './runtime-inspection.js';
+export * from './runtime-validation.js';
+export * from './routing.js';
+//# sourceMappingURL=route-sdd-task.js.map

package/packages/core/dist/router/route-sdd-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-sdd-task.js","sourceRoot":"","sources":["../../src/router/route-sdd-task.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC"}

package/packages/core/dist/router/routing-rules.d.ts

@@ -0,0 +1,4 @@
+import type { SddTask } from '../sdd-docs/task-parser.js';
+import type { AgentRuntimeRoutingRule } from './agent-runtime.js';
+import type { AgentSkillRuntimeRegistry } from './runtime-registry.js';
+export declare function matchRoutingRules(task: SddTask, registry: AgentSkillRuntimeRegistry): AgentRuntimeRoutingRule[];

package/packages/core/dist/router/routing-rules.js

@@ -0,0 +1,68 @@
+export function matchRoutingRules(task, registry) {
+    return registry.routingRules.filter((rule) => taskMatchesRoutingRule(task, rule));
+}
+function taskMatchesRoutingRule(task, rule) {
+    const text = taskSearchText(task);
+    const keywordMatched = rule.when.keywords.some((keyword) => text.includes(keyword.toLowerCase()));
+    const fileMatched = rule.when.affectedFileGlobs.some((glob) => task.affectedFiles.some((filePath) => globMatchesPath(glob, filePath)));
+    return keywordMatched || fileMatched;
+}
+function taskSearchText(task) {
+    const metadataValues = [];
+    for (const value of Object.values(task.rawMetadata)) {
+        if (Array.isArray(value)) {
+            metadataValues.push(...value);
+        }
+        else {
+            metadataValues.push(value);
+        }
+    }
+    return [
+        task.id,
+        task.title ?? '',
+        task.boundary ?? '',
+        task.implementationNotes ?? '',
+        ...task.risk,
+        ...task.validation,
+        ...task.acceptance,
+        ...task.acceptanceRefs,
+        ...task.planRefs,
+        ...task.fileOwnership,
+        ...task.agentFit,
+        ...task.allowedAgents,
+        ...task.requiredArtifacts,
+        ...metadataValues
+    ].join('\n').toLowerCase();
+}
+function globMatchesPath(glob, filePath) {
+    return new RegExp(globToRegExpPattern(glob.replace(/\\/g, '/'))).test(filePath.replace(/\\/g, '/'));
+}
+function globToRegExpPattern(glob) {
+    let pattern = '^';
+    for (let index = 0; index < glob.length; index += 1) {
+        const char = glob[index];
+        const next = glob[index + 1];
+        if (char === '*' && next === '*') {
+            if (glob[index + 2] === '/') {
+                pattern += '(?:.*/)?';
+                index += 2;
+            }
+            else {
+                pattern += '.*';
+                index += 1;
+            }
+            continue;
+        }
+        if (char === '*') {
+            pattern += '[^/]*';
+            continue;
+        }
+        if (char === '?') {
+            pattern += '[^/]';
+            continue;
+        }
+        pattern += /[.+^${}()|[\]\\]/.test(char) ? `\\${char}` : char;
+    }
+    return `${pattern}$`;
+}
+//# sourceMappingURL=routing-rules.js.map

package/packages/core/dist/router/routing-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-rules.js","sourceRoot":"","sources":["../../src/router/routing-rules.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,iBAAiB,CAAC,IAAa,EAAE,QAAmC;IAClF,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAa,EAAE,IAA6B;IAC1E,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAClG,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvI,OAAO,cAAc,IAAI,WAAW,CAAC;AACvC,CAAC;AAED,SAAS,cAAc,CAAC,IAAa;IACnC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,cAAc,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI,CAAC,EAAE;QACP,IAAI,CAAC,KAAK,IAAI,EAAE;QAChB,IAAI,CAAC,QAAQ,IAAI,EAAE;QACnB,IAAI,CAAC,mBAAmB,IAAI,EAAE;QAC9B,GAAG,IAAI,CAAC,IAAI;QACZ,GAAG,IAAI,CAAC,UAAU;QAClB,GAAG,IAAI,CAAC,UAAU;QAClB,GAAG,IAAI,CAAC,cAAc;QACtB,GAAG,IAAI,CAAC,QAAQ;QAChB,GAAG,IAAI,CAAC,aAAa;QACrB,GAAG,IAAI,CAAC,QAAQ;QAChB,GAAG,IAAI,CAAC,aAAa;QACrB,GAAG,IAAI,CAAC,iBAAiB;QACzB,GAAG,cAAc;KAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,QAAgB;IACrD,OAAO,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,IAAI,UAAU,CAAC;gBACtB,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,IAAI,CAAC;gBAChB,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,OAAO,IAAI,OAAO,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,OAAO,IAAI,MAAM,CAAC;YAClB,SAAS;QACX,CAAC;QACD,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,OAAO,GAAG,CAAC;AACvB,CAAC"}

package/packages/core/dist/router/routing.d.ts

@@ -0,0 +1,18 @@
+import type { TeamModeActivation } from './route-cache.js';
+import type { AgentRouterDecision, TeamModePolicy } from './agent-runtime.js';
+export declare function inspectTeamModePolicy(projectRoot: string, options?: {
+    taskId?: string;
+    branch?: string;
+    enabled?: boolean;
+    teamModeActivation?: TeamModeActivation;
+}): Promise<TeamModePolicy>;
+export declare function routeSddTask(projectRoot: string, options?: {
+    taskId: string;
+    branch?: string;
+    agent?: string;
+    teamModeEnabled?: boolean;
+    teamModeActivation?: TeamModeActivation;
+    profile?: boolean;
+    cache?: boolean;
+    approved?: boolean;
+}): Promise<AgentRouterDecision>;