sdd-agent-platform 0.3.0 → 0.4.1

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,14 @@
+import type { AgentCapabilityCatalog } from '../registries/agent-capability-catalog.js';
+import type { LifecycleAutonomyCeiling } from '../lifecycle/decision-gate.js';
+import type { SddTask, SddTaskGap } from '../sdd-docs/task-parser.js';
+import type { AgentCapabilityRouteDecision, 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 buildAgentCapabilityRouteDecision(task: SddTask | null, category: AgentRouterCategory, autonomyCeiling: LifecycleAutonomyCeiling, registry: AgentSkillRuntimeRegistry, catalog: AgentCapabilityCatalog): AgentCapabilityRouteDecision;
+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,318 @@
+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 buildAgentCapabilityRouteDecision(task, category, autonomyCeiling, registry, catalog) {
+    if (!task) {
+        return {
+            authority: 'advisory_only',
+            selectedDomains: [],
+            selectedPacks: [],
+            rejectedExternalSources: rejectedCapabilitySources(registry.capabilitySources),
+            consideredExternalSources: consideredCapabilitySources(registry.capabilitySources),
+            evidenceRequirements: ['task metadata must exist before capability routing can select evidence requirements'],
+            permissionCeiling: autonomyCeiling
+        };
+    }
+    const stage = routeCapabilityStage(task, category);
+    const text = taskSignalText(task);
+    const selectedCapabilities = catalog.capabilities.filter((capability) => capability.domainGroup === 'professional' && capabilityStageFits(capability, stage, task, text) && capabilityMatchesTask(capability, task, text));
+    const effectiveCapabilities = selectedCapabilities.length > 0 ? selectedCapabilities : fallbackCapabilitiesForTask(catalog.capabilities, task, stage);
+    const packById = new Map(catalog.materialPacks.map((pack) => [pack.id, pack]));
+    const selectedPackIds = new Set();
+    for (const capability of effectiveCapabilities) {
+        for (const packId of capability.routing.materialPackIds) {
+            const pack = packById.get(packId);
+            if (pack && pack.loadPolicy !== 'never_inline' && packFitsRoute(pack, stage, text)) {
+                selectedPackIds.add(packId);
+            }
+        }
+    }
+    return {
+        authority: 'advisory_only',
+        selectedDomains: effectiveCapabilities.map((capability) => ({
+            domain: capability.domain,
+            capabilityId: capability.id,
+            authority: capability.authority,
+            reason: capabilityReason(capability, task)
+        })),
+        selectedPacks: [...selectedPackIds].map((packId) => packById.get(packId)).filter((pack) => Boolean(pack)).map((pack) => ({
+            id: pack.id,
+            domains: [...pack.domains],
+            loadPolicy: pack.loadPolicy,
+            contextBudget: pack.contextBudget,
+            sourceKind: pack.sourceKind,
+            expectedOutputs: [...pack.expectedOutputs],
+            reason: packReason(pack, stage)
+        })),
+        rejectedExternalSources: rejectedCapabilitySources(registry.capabilitySources),
+        consideredExternalSources: consideredCapabilitySources(registry.capabilitySources),
+        evidenceRequirements: evidenceRequirementsForCapabilities(effectiveCapabilities),
+        permissionCeiling: autonomyCeiling
+    };
+}
+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.' }));
+}
+function routeCapabilityStage(task, category) {
+    if (category === 'planning') {
+        return 'plan';
+    }
+    if (category === 'validation' || task.status === 'completed') {
+        return 'test';
+    }
+    return 'do';
+}
+function taskSignalText(task) {
+    return [
+        task.id,
+        task.title ?? '',
+        task.boundary ?? '',
+        task.implementationNotes ?? '',
+        ...task.risk,
+        ...task.affectedFiles,
+        ...task.validation,
+        ...task.acceptance,
+        ...task.allowedAgents,
+        ...task.agentFit
+    ].join('\n').toLowerCase();
+}
+function capabilityMatchesTask(capability, task, text) {
+    return capability.routing.riskTags.some((tag) => text.includes(tag.toLowerCase())) || capability.routing.projectStackTags.some((tag) => projectStackMatches(tag, task, text)) || capability.routing.materialPackIds.some((packId) => text.includes(packId.replace(/^baseline-/, '').replace(/-/g, ' '))) || domainFileSignal(capability.domain, task.affectedFiles);
+}
+function fallbackCapabilitiesForTask(capabilities, task, stage) {
+    const codeFile = task.affectedFiles.some((file) => /\.(ts|js|java|go|py|rs|cs|php|rb)$/i.test(file));
+    const fallbackDomain = codeFile ? 'backend-engineering' : 'solution-design';
+    const fallback = capabilities.find((capability) => capability.domain === fallbackDomain && capabilityStageFits(capability, stage, task, taskSignalText(task)));
+    return fallback ? [fallback] : [];
+}
+function packFitsRoute(pack, stage, text) {
+    const keywordTriggered = pack.triggerKeywords.some((keyword) => text.includes(keyword.toLowerCase()));
+    if (pack.sourceKind === 'sdd_native_baseline') {
+        return pack.triggerStages.includes(stage) || keywordTriggered;
+    }
+    return pack.triggerStages.includes(stage) && keywordTriggered;
+}
+function domainFileSignal(domain, affectedFiles) {
+    const files = affectedFiles.map((file) => file.toLowerCase());
+    if (domain === 'frontend-engineering') {
+        return files.some((file) => /\.(tsx|jsx|vue|svelte|css|scss|less)$/.test(file) || file.includes('/components/') || file.includes('/pages/'));
+    }
+    if (domain === 'db-data-engineering') {
+        return files.some((file) => /\.(sql|prisma)$/.test(file) || file.includes('migration') || file.includes('schema') || file.includes('database'));
+    }
+    if (domain === 'backend-engineering') {
+        return files.some((file) => /\.(ts|js|java|go|py|rs|cs|php|rb)$/.test(file)) && !domainFileSignal('frontend-engineering', affectedFiles);
+    }
+    return false;
+}
+function capabilityStageFits(capability, stage, task, text) {
+    if (capability.stages.includes(stage)) {
+        return true;
+    }
+    if (capability.domain === 'testing-quality-engineering' && stage === 'do') {
+        return testingQualityTaskSignal(task);
+    }
+    return capability.domain === 'release-engineering' && /release|ship|deploy|rollback|ci|发布/.test(text);
+}
+function testingQualityTaskSignal(task) {
+    const taskText = [task.id, task.title ?? '', task.boundary ?? '', task.implementationNotes ?? '', ...task.risk, ...task.affectedFiles, ...task.acceptance].join('\n').toLowerCase();
+    return /quality|coverage|acceptance|验证|测试/.test(taskText) || task.affectedFiles.some((file) => /\.(test|spec)\.[tj]sx?$/i.test(file));
+}
+function capabilityReason(capability, task) {
+    const fileSignal = domainFileSignal(capability.domain, task.affectedFiles) ? 'affected file evidence' : 'task risk, validation, or text evidence';
+    return `${capability.domain} selected from ${fileSignal}; authority remains ${capability.authority}.`;
+}
+function packReason(pack, stage) {
+    return `${pack.id} is route_when_triggered for ${stage} and stays ${pack.contextBudget} context.`;
+}
+function evidenceRequirementsForCapabilities(capabilities) {
+    const requirements = new Set();
+    for (const capability of capabilities) {
+        for (const output of capability.outputs) {
+            requirements.add(`${capability.domain}: ${output}`);
+        }
+    }
+    return [...requirements];
+}
+function consideredCapabilitySources(sources) {
+    return sources
+        .filter((source) => source.kind !== 'native_host')
+        .map((source) => ({
+        sourceId: source.id,
+        kind: source.kind,
+        quarantineStatus: source.quarantineStatus,
+        reuseDecision: source.reuseDecision,
+        allowedEvidenceTypes: [...source.allowedEvidenceTypes],
+        consideredUse: source.allowedUse,
+        reason: rejectedSourceReason(source)
+    }));
+}
+function rejectedCapabilitySources(sources) {
+    return sources
+        .filter((source) => source.kind !== 'native_host' && (source.quarantineRequired || source.reuseDecision !== 'reuse_direct' || source.kind === 'future_adapter'))
+        .map((source) => ({
+        sourceId: source.id,
+        quarantineStatus: source.quarantineStatus,
+        reuseDecision: source.reuseDecision,
+        allowedEvidenceTypes: [...source.allowedEvidenceTypes],
+        reason: rejectedSourceReason(source)
+    }));
+}
+function projectStackMatches(tag, task, text) {
+    if (tag === 'generic') {
+        return false;
+    }
+    if (text.includes(tag.toLowerCase())) {
+        return true;
+    }
+    const files = task.affectedFiles.map((file) => file.toLowerCase());
+    if (tag === 'typescript') {
+        return files.some((file) => /\.(ts|tsx)$/.test(file));
+    }
+    if (tag === 'javascript') {
+        return files.some((file) => /\.(js|jsx)$/.test(file));
+    }
+    if (tag === 'java') {
+        return files.some((file) => file.endsWith('.java'));
+    }
+    if (tag === 'sql') {
+        return files.some((file) => /\.(sql|prisma)$/.test(file));
+    }
+    return files.some((file) => file.includes(tag.toLowerCase()));
+}
+function rejectedSourceReason(source) {
+    if (source.quarantineStatus === 'denied') {
+        return 'Source is denied or unsupported and cannot participate in routing.';
+    }
+    if (source.kind === 'future_adapter') {
+        return 'Future adapter is recorded as metadata only until host behavior is validated.';
+    }
+    if (source.quarantineStatus === 'quarantined' || source.quarantineStatus === 'required') {
+        return 'Source requires quarantine/provenance review and is not invoked by capability routing.';
+    }
+    if (source.reuseDecision === 'avoid') {
+        return 'Reuse policy avoids this source.';
+    }
+    return 'External source is considered but not loaded during progressive disclosure.';
+}
+//# sourceMappingURL=route-projection.js.map