@captain_z/zsk 1.8.4 → 1.8.5

package/dist/core/provider-readiness.d.ts

@@ -0,0 +1,39 @@
+import { type ProviderCapability, type ProviderPolicy } from "./provider-policy.js";
+import type { McpRegistryRegistration } from "./mcp-registry-discovery.js";
+import type { BuiltInSourceAdapterId } from "./source-adapter-normalization.js";
+export type ProviderReadinessSummary = "provider-detected" | "provider-not-detected" | "provider-policy-known" | "provider-ambiguous";
+export type ProviderReadinessEvidence = {
+    providerName: string;
+    adapter?: BuiltInSourceAdapterId;
+    summary: ProviderReadinessSummary;
+    policy: {
+        status: "known" | "missing";
+        source?: "project" | "builtin";
+        path?: string;
+    };
+    registry: {
+        status: "detected" | "not-detected" | "ambiguous";
+        registrations: Array<{
+            host: string;
+            scope: string;
+            configPath: string;
+            transport?: string;
+            commandLabel?: string;
+            url?: string;
+            envKeys?: string[];
+            staticTools?: string[];
+        }>;
+    };
+    connection: {
+        status: "not-attempted";
+        reason: "static-cli-mode" | "no-host-mcp-session";
+    };
+    capabilities: {
+        required: ProviderCapability[];
+        matched: ProviderCapability[];
+        missing: ProviderCapability[];
+        evaluation: "matched-static-tools" | "not-evaluable" | "mapping-missing";
+    };
+    warnings: string[];
+};
+export declare function buildProviderReadinessEvidence(target: string, providerName: string, adapter: BuiltInSourceAdapterId | undefined, policy: ProviderPolicy, registrations: McpRegistryRegistration[]): ProviderReadinessEvidence;

package/dist/core/provider-readiness.js

@@ -0,0 +1,78 @@
+import { adapterCapabilityContract, providerPolicyPathRelative, } from "./provider-policy.js";
+export function buildProviderReadinessEvidence(target, providerName, adapter, policy, registrations) {
+    const mapping = policy.mappings.get(providerName);
+    const effectiveAdapter = adapter ?? mapping?.adapter;
+    const required = effectiveAdapter ? adapterCapabilityContract(effectiveAdapter).readinessCapabilities : [];
+    const matchingRegistrations = registrations.filter((registration) => registration.name === providerName);
+    const registryStatus = matchingRegistrations.length === 0
+        ? "not-detected"
+        : hasAmbiguousRegistrations(matchingRegistrations)
+            ? "ambiguous"
+            : "detected";
+    const capabilityResult = evaluateCapabilities(required, mapping, matchingRegistrations);
+    const summary = registryStatus === "ambiguous"
+        ? "provider-ambiguous"
+        : registryStatus === "detected"
+            ? "provider-detected"
+            : mapping
+                ? "provider-policy-known"
+                : "provider-not-detected";
+    return {
+        providerName,
+        adapter: effectiveAdapter,
+        summary,
+        policy: {
+            status: mapping ? "known" : "missing",
+            source: mapping?.mappingSource,
+            path: mapping?.mappingSource === "project" ? providerPolicyPathRelative(target, policy.path) : undefined,
+        },
+        registry: {
+            status: registryStatus,
+            registrations: matchingRegistrations.map((registration) => ({
+                host: registration.host,
+                scope: registration.scope,
+                configPath: registration.configPath,
+                transport: registration.transport,
+                commandLabel: registration.commandLabel,
+                url: registration.url,
+                envKeys: registration.envKeys.length > 0 ? registration.envKeys : undefined,
+                staticTools: registration.staticTools,
+            })),
+        },
+        connection: {
+            status: "not-attempted",
+            reason: "static-cli-mode",
+        },
+        capabilities: capabilityResult,
+        warnings: [
+            ...policy.warnings,
+            ...(!mapping ? [`provider mapping missing for ${providerName}`] : []),
+            ...(registryStatus === "not-detected" ? [`MCP registry did not detect provider ${providerName}`] : []),
+            ...(registryStatus === "ambiguous" ? [`MCP registry detected multiple same-priority registrations for ${providerName}`] : []),
+        ],
+    };
+}
+function evaluateCapabilities(required, mapping, registrations) {
+    if (!mapping) {
+        return { required, matched: [], missing: required, evaluation: "mapping-missing" };
+    }
+    const staticTools = new Set(registrations.flatMap((registration) => registration.staticTools ?? []));
+    if (staticTools.size === 0) {
+        return { required, matched: [], missing: required, evaluation: "not-evaluable" };
+    }
+    const matched = required.filter((capability) => (mapping.tools[capability] ?? []).some((tool) => staticTools.has(tool)));
+    return {
+        required,
+        matched,
+        missing: required.filter((capability) => !matched.includes(capability)),
+        evaluation: "matched-static-tools",
+    };
+}
+function hasAmbiguousRegistrations(registrations) {
+    const minPriority = Math.min(...registrations.map(registrationPriority));
+    return registrations.filter((registration) => registrationPriority(registration) === minPriority).length > 1;
+}
+function registrationPriority(registration) {
+    return registration.scope === "workspace" ? 0 : 1;
+}
+//# sourceMappingURL=provider-readiness.js.map

package/dist/core/provider-readiness.js.map

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

package/dist/core/source-adapter-normalization.d.ts

@@ -0,0 +1,31 @@
+import type { SourceConfig } from "./config.js";
+export declare const BUILT_IN_SOURCE_ADAPTERS: readonly ["confluence", "jira", "gitlab", "figma"];
+export type BuiltInSourceAdapterId = typeof BUILT_IN_SOURCE_ADAPTERS[number];
+export type SourceSnapshotAdapterId = BuiltInSourceAdapterId | "design-source";
+export type SourceAdapterNormalization = {
+    sourceType?: string;
+    adapterId?: BuiltInSourceAdapterId;
+    legacyAdapter?: "design-source";
+    mcpProviderName?: string;
+    fallbackTools: SourceFallbackToolId[];
+    warnings: string[];
+    errors: string[];
+    ambiguous: boolean;
+};
+export type EffectiveSourceInterpretation = SourceAdapterNormalization & {
+    snapshotAdapter?: SourceSnapshotAdapterId;
+    hasBrowserFallback: boolean;
+};
+export type SourceFallbackToolId = "playwright-cli" | "playwright-mcp" | "playwright" | "computer-use" | "browser-use" | "manual" | "export";
+export declare function normalizeSourceAdapter(source: SourceConfig): SourceAdapterNormalization;
+export declare function isBuiltInSourceAdapter(value: string | undefined): value is BuiltInSourceAdapterId;
+export declare function interpretSourceAdapter(source: SourceConfig, origin?: {
+    provider?: string;
+    kind?: string;
+}): EffectiveSourceInterpretation;
+export declare function selectSourceSnapshotAdapter(source: SourceConfig, origin: {
+    provider?: string;
+    kind?: string;
+}): SourceSnapshotAdapterId | undefined;
+export declare function normalizeAdapterKey(value: string | undefined): string;
+export declare function sourceFallbackTools(source: SourceConfig): SourceFallbackToolId[];

package/dist/core/source-adapter-normalization.js

@@ -0,0 +1,235 @@
+export const BUILT_IN_SOURCE_ADAPTERS = ["confluence", "jira", "gitlab", "figma"];
+const BUILT_IN_ADAPTER_SET = new Set(BUILT_IN_SOURCE_ADAPTERS);
+const SOURCE_FALLBACK_TOOL_ALIASES = new Map([
+    ["playwright-cli", "playwright-cli"],
+    ["playwright", "playwright"],
+    ["playwright-mcp", "playwright-mcp"],
+    ["computer-use", "computer-use"],
+    ["browser-use", "browser-use"],
+    ["manual", "manual"],
+    ["export", "export"],
+]);
+const DESIGN_SOURCE_TYPES = new Set(["design", "design-source", "design-asset", "design-assets", "prototype"]);
+const GENERIC_SOURCE_TYPES = new Set(["url", "remote", "online", "web", "link", "local", "manual"]);
+export function normalizeSourceAdapter(source) {
+    const warnings = [];
+    const errors = [];
+    const sourceType = normalizedString(source.type);
+    const explicitAdapter = normalizedString(stringField(source, "adapter"));
+    const sourceProvider = normalizedString(stringField(source, "provider"));
+    const originAdapter = normalizedString(stringField(source.origin, "adapter"));
+    const originProvider = normalizedString(stringField(source.origin, "provider"));
+    const originKind = normalizedString(source.origin?.kind);
+    const sourceKind = normalizedString(source.kind);
+    const adapterFallbackTool = fallbackToolCandidate(explicitAdapter);
+    warnings.push(...fallbackToolWarningsFromValue(source.fallback, "source.fallback"), ...fallbackToolWarningsFromValue(source.fallbackTools, "source.fallbackTools"), ...fallbackToolWarningsFromValue(source.metadata?.fallback, "source.metadata.fallback"), ...fallbackToolWarningsFromValue(source.metadata?.fallbackTools, "source.metadata.fallbackTools"));
+    const fallbackTools = unique([
+        ...sourceFallbackTools(source),
+        ...(adapterFallbackTool ? [adapterFallbackTool] : []),
+    ]);
+    if (originAdapter)
+        warnings.push("origin.adapter is deprecated; prefer source adapter at the source root");
+    if (adapterFallbackTool) {
+        warnings.push(`source.adapter "${explicitAdapter}" is a runtime fallback tool, not a source adapter; prefer source.fallback instead`);
+    }
+    const adapterCandidates = [
+        adapterFallbackTool ? undefined : adapterCandidate(explicitAdapter),
+        adapterCandidate(originAdapter),
+        adapterCandidate(sourceProvider),
+        adapterCandidate(originProvider),
+        adapterCandidate(sourceKind),
+        adapterCandidate(originKind),
+        adapterCandidate(sourceType),
+        adapterFromLocator(source),
+    ].filter((value) => Boolean(value));
+    const uniqueAdapters = unique(adapterCandidates);
+    if (explicitAdapter &&
+        !adapterFallbackTool &&
+        !BUILT_IN_ADAPTER_SET.has(explicitAdapter) &&
+        explicitAdapter !== "design-source") {
+        errors.push(`unknown source adapter "${explicitAdapter}"`);
+    }
+    if (sourceProvider && !BUILT_IN_ADAPTER_SET.has(sourceProvider) && looksLikeMcpProvider(sourceProvider)) {
+        warnings.push("source.provider is deprecated for MCP provider binding; prefer source mcpProvider");
+    }
+    if (originProvider && BUILT_IN_ADAPTER_SET.has(originProvider)) {
+        warnings.push("origin.provider is deprecated for adapter selection; prefer source adapter");
+    }
+    if (originProvider && !BUILT_IN_ADAPTER_SET.has(originProvider) && looksLikeMcpProvider(originProvider)) {
+        warnings.push("origin.provider is deprecated for MCP provider binding; prefer source mcpProvider");
+    }
+    if (sourceType && BUILT_IN_ADAPTER_SET.has(sourceType)) {
+        warnings.push(`source.type "${sourceType}" is deprecated for adapter selection; prefer type: design-source with adapter: ${sourceType}`);
+    }
+    if (uniqueAdapters.length > 1) {
+        errors.push(`conflicting source adapters: ${uniqueAdapters.join(", ")}`);
+    }
+    const adapterId = uniqueAdapters[0];
+    const legacyAdapter = isDesignSource(source) && !adapterId ? "design-source" : undefined;
+    const mcpProviderName = firstNormalized(stringField(source, "mcpProvider"), stringField(source, "mcpServer"), looksLikeMcpProvider(sourceProvider) ? sourceProvider : undefined, looksLikeMcpProvider(originProvider) ? originProvider : undefined, stringField(source.origin, "mcpProvider"), stringField(source.origin, "mcpServer"));
+    if (stringField(source.origin, "mcpProvider") || stringField(source.origin, "mcpServer")) {
+        warnings.push("origin.mcpProvider/origin.mcpServer is deprecated; prefer source mcpProvider");
+    }
+    return {
+        sourceType,
+        adapterId,
+        legacyAdapter,
+        mcpProviderName,
+        fallbackTools,
+        warnings: unique(warnings),
+        errors: unique(errors),
+        ambiguous: Boolean(legacyAdapter && !adapterId),
+    };
+}
+export function isBuiltInSourceAdapter(value) {
+    return Boolean(value && BUILT_IN_ADAPTER_SET.has(value));
+}
+export function interpretSourceAdapter(source, origin = {}) {
+    const normalized = normalizeSourceAdapter(source);
+    return {
+        ...normalized,
+        snapshotAdapter: selectSourceSnapshotAdapterFromNormalized(source, origin, normalized),
+        hasBrowserFallback: normalized.fallbackTools.includes("playwright-cli") ||
+            normalized.fallbackTools.includes("playwright"),
+    };
+}
+export function selectSourceSnapshotAdapter(source, origin) {
+    return selectSourceSnapshotAdapterFromNormalized(source, origin, normalizeSourceAdapter(source));
+}
+function selectSourceSnapshotAdapterFromNormalized(source, origin, normalized) {
+    if (normalized.adapterId)
+        return normalized.adapterId;
+    if (normalized.legacyAdapter)
+        return normalized.legacyAdapter;
+    const keys = [
+        origin.provider,
+        origin.kind,
+        source.origin?.provider,
+        source.origin?.kind,
+        source.kind,
+        source.type,
+    ].map((value) => normalizeAdapterKey(typeof value === "string" ? value : undefined));
+    if (keys.some((value) => value.includes("confluence")))
+        return "confluence";
+    if (keys.some((value) => value.includes("jira")))
+        return "jira";
+    if (keys.some((value) => value.includes("gitlab")))
+        return "gitlab";
+    if (keys.some((value) => value.includes("figma") ||
+        ["design", "design-asset", "design-source"].includes(value))) {
+        return keys.some((value) => value.includes("figma")) ? "figma" : "design-source";
+    }
+    return undefined;
+}
+export function normalizeAdapterKey(value) {
+    return value?.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") ?? "";
+}
+export function sourceFallbackTools(source) {
+    const adapterFallbackTool = fallbackToolCandidate(normalizedString(stringField(source, "adapter")));
+    return unique([
+        ...(adapterFallbackTool ? [adapterFallbackTool] : []),
+        ...fallbackToolsFromValue(source.fallback),
+        ...fallbackToolsFromValue(source.fallbackTools),
+        ...fallbackToolsFromValue(source.metadata?.fallback),
+        ...fallbackToolsFromValue(source.metadata?.fallbackTools),
+    ]);
+}
+function adapterCandidate(value) {
+    if (!value)
+        return undefined;
+    if (isBuiltInSourceAdapter(value))
+        return value;
+    return undefined;
+}
+function fallbackToolCandidate(value) {
+    if (!value)
+        return undefined;
+    return SOURCE_FALLBACK_TOOL_ALIASES.get(value);
+}
+function fallbackToolsFromValue(value) {
+    if (typeof value === "string") {
+        const candidate = fallbackToolCandidate(normalizedString(value));
+        return candidate ? [candidate] : [];
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => fallbackToolsFromValue(item));
+    }
+    if (!value || typeof value !== "object")
+        return [];
+    const record = value;
+    return [
+        ...fallbackToolsFromValue(record.acquisition),
+        ...fallbackToolsFromValue(record.observation),
+        ...fallbackToolsFromValue(record.tools),
+    ];
+}
+function fallbackToolWarningsFromValue(value, path) {
+    if (typeof value === "string") {
+        return fallbackToolCandidate(normalizedString(value))
+            ? []
+            : [`unknown source fallback tool "${value}" at ${path}`];
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item, index) => fallbackToolWarningsFromValue(item, `${path}/${index}`));
+    }
+    if (!value || typeof value !== "object")
+        return [];
+    const record = value;
+    return [
+        ...fallbackToolWarningsFromValue(record.acquisition, `${path}/acquisition`),
+        ...fallbackToolWarningsFromValue(record.observation, `${path}/observation`),
+        ...fallbackToolWarningsFromValue(record.tools, `${path}/tools`),
+    ];
+}
+function adapterFromLocator(source) {
+    const values = [
+        stringField(source.origin, "url"),
+        stringField(source.origin, "apiUrl"),
+        stringField(source.origin, "exportUrl"),
+        stringField(source.origin, "fileKey"),
+        stringField(source.origin, "nodeId"),
+    ].filter((value) => Boolean(value));
+    const joined = values.join("\n").toLowerCase();
+    if (joined.includes("figma.com") || Boolean(stringField(source.origin, "fileKey")))
+        return "figma";
+    return undefined;
+}
+function isDesignSource(source) {
+    const values = [
+        source.type,
+        source.kind,
+        source.origin?.kind,
+        stringField(source, "adapter"),
+        stringField(source.origin, "adapter"),
+    ].map(normalizedString).filter((value) => Boolean(value));
+    if (values.some((value) => DESIGN_SOURCE_TYPES.has(value)))
+        return true;
+    if (values.some((value) => GENERIC_SOURCE_TYPES.has(value)))
+        return false;
+    return Boolean(adapterFromLocator(source));
+}
+function looksLikeMcpProvider(value) {
+    return Boolean(value && /\bmcp\b|mcp-|_mcp|-server$/.test(value));
+}
+function firstNormalized(...values) {
+    for (const value of values) {
+        const normalized = normalizedString(value);
+        if (normalized)
+            return normalized;
+    }
+    return undefined;
+}
+function normalizedString(value) {
+    const normalized = normalizeAdapterKey(value);
+    return normalized || undefined;
+}
+function stringField(value, key) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const item = value[key];
+    return typeof item === "string" && item.trim().length > 0 ? item : undefined;
+}
+function unique(values) {
+    return Array.from(new Set(values));
+}
+//# sourceMappingURL=source-adapter-normalization.js.map

package/dist/core/source-adapter-normalization.js.map

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

package/dist/core/source-snapshot-adapters.d.ts

@@ -1,5 +1,6 @@
 import { type ProjectConfig, type SourceConfig, type SourceEntry } from "./config.js";
 import { type OriginInference } from "./origin-detection.js";
+import { type SourceSnapshotAdapterId } from "./source-adapter-normalization.js";
 export type PrepareSyncOptions = {
     source?: string;
     all?: boolean;
@@ -10,7 +11,7 @@ export type PrepareSyncOptions = {
     dryRun?: boolean;
     runId?: string;
 };
-export type PrepareSyncStatus = "materialized" | "metadata-only" | "blocked-auth" | "source-gap" | "skipped" | "failed";
+export type PrepareSyncStatus = "materialized" | "materialized-partial" | "metadata-only" | "blocked-auth" | "source-gap" | "skipped" | "failed";
 export type PrepareSyncResult = {
     envelopeVersion?: 1;
     sourceKey: string;
@@ -32,7 +33,7 @@ export type PrepareSyncResult = {
     validation: Record<string, "pass" | "fail" | "skipped">;
 };
 export type PrepareSyncBase = Omit<PrepareSyncResult, "strategy" | "status" | "changed" | "reason" | "validation">;
-export type SourceSnapshotProviderAdapter = "confluence" | "jira" | "gitlab" | "design-source";
+export type SourceSnapshotProviderAdapter = SourceSnapshotAdapterId;
 export type SourceSnapshotContext = {
     target: string;
     config: ProjectConfig;
@@ -55,5 +56,4 @@ export type SourceSnapshotAdapterHandlers = {
 };
 export declare function createSourceSnapshotContext(target: string, config: ProjectConfig, entry: SourceEntry, opts: PrepareSyncOptions, previousSnapshotHashFor: (snapshotPath: string) => Promise<string | undefined>): Promise<SourceSnapshotContext>;
 export declare function acquireSourceSnapshot(context: SourceSnapshotContext, handlers: SourceSnapshotAdapterHandlers): Promise<PrepareSyncResult>;
-export declare function selectSourceSnapshotProviderAdapter(source: SourceConfig, origin: OriginInference): SourceSnapshotProviderAdapter | undefined;
 export declare function chooseSourceSnapshotStrategy(method: string): string;

package/dist/core/source-snapshot-adapters.js

@@ -1,6 +1,7 @@
 import { resolve } from "node:path";
 import { resolveSourceSnapshot, } from "./config.js";
 import { inferSourceOrigin } from "./origin-detection.js";
+import { selectSourceSnapshotAdapter, } from "./source-adapter-normalization.js";
 export async function createSourceSnapshotContext(target, config, entry, opts, previousSnapshotHashFor) {
     const source = entry.source;
     const origin = inferSourceOrigin(source);
@@ -35,7 +36,7 @@ export async function acquireSourceSnapshot(context, handlers) {
         return handlers.dryRun(context);
     if (context.origin.method === "local")
         return handlers.local(context);
-    const providerAdapter = selectSourceSnapshotProviderAdapter(context.source, context.origin);
+    const providerAdapter = selectSourceSnapshotAdapter(context.source, context.origin);
     if (providerAdapter) {
         const result = await handlers.provider(context, providerAdapter);
         if (result)
@@ -47,26 +48,6 @@ export async function acquireSourceSnapshot(context, handlers) {
         return handlers.url(context);
     return handlers.providerManaged(context);
 }
-export function selectSourceSnapshotProviderAdapter(source, origin) {
-    const keys = [
-        origin.provider,
-        origin.kind,
-        source.origin?.provider,
-        source.origin?.kind,
-        source.kind,
-        source.type,
-    ].map((value) => normalizeAdapterKey(typeof value === "string" ? value : undefined));
-    if (keys.some((value) => value.includes("confluence")))
-        return "confluence";
-    if (keys.some((value) => value.includes("jira")))
-        return "jira";
-    if (keys.some((value) => value.includes("gitlab")))
-        return "gitlab";
-    if (keys.some((value) => ["figma", "modao", "mastergo", "design", "design-asset", "design-source"].includes(value))) {
-        return "design-source";
-    }
-    return undefined;
-}
 export function chooseSourceSnapshotStrategy(method) {
     if (method === "local")
         return "local-copy-structured-markdown";
@@ -76,7 +57,4 @@ export function chooseSourceSnapshotStrategy(method) {
         return "playwright-auth-or-direct-fetch";
     return "confirm-acquisition-method";
 }
-function normalizeAdapterKey(value) {
-    return value?.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") ?? "";
-}
 //# sourceMappingURL=source-snapshot-adapters.js.map

package/dist/core/source-snapshot-adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-snapshot-adapters.js","sourceRoot":"","sources":["../../src/core/source-snapshot-adapters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source-snapshot-adapters.js","sourceRoot":"","sources":["../../src/core/source-snapshot-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,qBAAqB,GAItB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAwB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACL,2BAA2B,GAE5B,MAAM,mCAAmC,CAAC;AAwE3C,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAc,EACd,MAAqB,EACrB,KAAkB,EAClB,IAAwB,EACxB,uBAA8E;IAE9E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,oBAAoB,GAAG,MAAM,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,IAAI,GAAoB;QAC5B,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,KAAK,CAAC,EAAE;QACnB,UAAU,EAAE,KAAK,CAAC,IAAI;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,GAAG;QAClB,QAAQ;QACR,oBAAoB;KACrB,CAAC;IACF,OAAO;QACL,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,IAAI;QACJ,QAAQ;QACR,YAAY;QACZ,oBAAoB;QACpB,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA8B,EAC9B,QAAuC;IAEvC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtE,MAAM,eAAe,GAAG,2BAA2B,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpF,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACjE,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,gCAAgC,CAAC;IAChE,IAAI,MAAM,KAAK,YAAY;QAAE,OAAO,0BAA0B,CAAC;IAC/D,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,iCAAiC,CAAC;IAC/D,OAAO,4BAA4B,CAAC;AACtC,CAAC"}

package/dist/core/staffing-plan.d.ts

@@ -188,6 +188,7 @@ type RoleContract = {
 };
 type RolePoolRole = {
     role: string;
+    baseRole?: string;
     subagentType?: string;
     reason?: string;
     stages: string[];

package/dist/core/staffing-plan.js

@@ -385,7 +385,7 @@ async function readStaffingRolePool(target, config) {
     if (config.staffing?.roles) {
         pools.push(parseRolePool({ roles: config.staffing.roles }));
     }
-    return mergeRolePools(...pools);
+    return resolveRoleInheritance(mergeRolePools(...pools));
 }
 function parseRolePool(value) {
     const rolesValue = isRecord(value) ? value.roles : undefined;
@@ -396,16 +396,24 @@ function parseRolePool(value) {
         if (!isRecord(config))
             continue;
         entries.push(rolePoolEntry(role, {
+            baseRole: stringValue(config.extends),
             subagentType: stringValue(config.subagentType),
             reason: stringValue(config.reason),
             stages: stringList(config.stages),
             skills: stringList(config.skills),
-            lanes: stringList(config.lanes),
+            lanes: unique([
+                ...stringList(config.lanes),
+                ...stringList(config.resources),
+                ...stringList(config.artifacts),
+            ]),
             required: booleanValue(config.required),
             remoteSources: booleanValue(config.remoteSources),
             activation: stringValue(config.activation),
             extraInputs: stringList(config.inputs),
-            writeScope: stringList(config.writeScope),
+            writeScope: unique([
+                ...stringList(config.writeScope),
+                ...stringList(config.writeScopes),
+            ]),
             outputs: stringList(config.outputs),
             evidenceRequired: stringList(config.evidenceRequired),
             contract: {
@@ -431,6 +439,7 @@ function mergeRolePools(...pools) {
 function mergeRolePoolRole(base, override) {
     return {
         role: base.role,
+        baseRole: override.baseRole ?? base.baseRole,
         subagentType: override.subagentType ?? base.subagentType,
         reason: override.reason ?? base.reason,
         stages: unique([...base.stages, ...override.stages]),
@@ -449,6 +458,7 @@ function mergeRolePoolRole(base, override) {
 function rolePoolEntry(role, config) {
     return [role, {
             role,
+            baseRole: config.baseRole,
             subagentType: config.subagentType,
             reason: config.reason,
             stages: normalizeList(config.stages ?? []),
@@ -464,6 +474,54 @@ function rolePoolEntry(role, config) {
             contract: config.contract,
         }];
 }
+function resolveRoleInheritance(pool) {
+    const resolving = new Set();
+    const resolved = new Map();
+    const resolveRole = (name) => {
+        const cached = resolved.get(name);
+        if (cached)
+            return cached;
+        const role = pool.roles[name];
+        if (!role)
+            return undefined;
+        if (!role.baseRole) {
+            resolved.set(name, role);
+            return role;
+        }
+        if (resolving.has(name)) {
+            resolved.set(name, role);
+            return role;
+        }
+        resolving.add(name);
+        const base = resolveRole(role.baseRole);
+        resolving.delete(name);
+        const merged = base ? inheritRole(base, role) : role;
+        resolved.set(name, merged);
+        return merged;
+    };
+    for (const name of Object.keys(pool.roles))
+        resolveRole(name);
+    return { roles: Object.fromEntries(resolved) };
+}
+function inheritRole(base, role) {
+    return {
+        role: role.role,
+        baseRole: role.baseRole,
+        subagentType: role.subagentType ?? base.subagentType,
+        reason: role.reason ?? base.reason,
+        stages: unique([...base.stages, ...role.stages]),
+        skills: unique([...base.skills, ...role.skills]),
+        lanes: unique([...base.lanes, ...role.lanes]),
+        required: role.required,
+        remoteSources: base.remoteSources || role.remoteSources,
+        activation: role.activation ?? base.activation,
+        extraInputs: unique([...base.extraInputs, ...role.extraInputs]),
+        writeScope: unique([...base.writeScope, ...role.writeScope]),
+        outputs: unique([...base.outputs, ...role.outputs]),
+        evidenceRequired: unique([...base.evidenceRequired, ...role.evidenceRequired]),
+        contract: mergeContractOverrides(base.contract, role.contract),
+    };
+}
 function seedFromRolePool(role, entries, overrides = {}) {
     return {
         role: role.role,