@claude-flow/cli 3.32.29 → 3.32.32

package/node_modules/@claude-flow/security/dist/application/index.js

@@ -0,0 +1,7 @@
+/**
+ * Security Application Layer - Public Exports
+ *
+ * @module v3/security/application
+ */
+export { SecurityApplicationService, } from './services/security-application-service.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@claude-flow/security/dist/application/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,0BAA0B,GAE3B,MAAM,4CAA4C,CAAC"}

package/node_modules/@claude-flow/security/dist/application/services/security-application-service.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Security Application Service - Application Layer
+ *
+ * Orchestrates security operations and provides simplified interface.
+ *
+ * @module v3/security/application/services
+ */
+import { SecurityContext } from '../../domain/entities/security-context.js';
+import { ValidationResult, ThreatDetectionResult } from '../../domain/services/security-domain-service.js';
+/**
+ * Security audit result
+ */
+export interface SecurityAuditResult {
+    passed: boolean;
+    score: number;
+    checks: Array<{
+        name: string;
+        passed: boolean;
+        severity: 'low' | 'medium' | 'high' | 'critical';
+        message: string;
+    }>;
+    recommendations: string[];
+}
+/**
+ * Security Application Service
+ */
+export declare class SecurityApplicationService {
+    private readonly domainService;
+    private readonly contexts;
+    constructor();
+    /**
+     * Create and register security context for agent
+     */
+    createAgentContext(agentId: string, role: string): SecurityContext;
+    /**
+     * Get security context
+     */
+    getContext(principalId: string): SecurityContext | undefined;
+    /**
+     * Remove security context
+     */
+    removeContext(principalId: string): boolean;
+    /**
+     * Validate path access
+     */
+    validatePath(path: string, principalId: string): ValidationResult;
+    /**
+     * Validate command execution
+     */
+    validateCommand(command: string, principalId: string): ValidationResult;
+    /**
+     * Validate user input
+     */
+    validateInput(input: string): ValidationResult;
+    /**
+     * Detect threats in content
+     */
+    detectThreats(content: string): ThreatDetectionResult;
+    /**
+     * Run security audit on codebase
+     */
+    auditCodebase(files: Array<{
+        path: string;
+        content: string;
+    }>): Promise<SecurityAuditResult>;
+    /**
+     * Check if operation is allowed
+     */
+    isOperationAllowed(principalId: string, operation: 'path' | 'command', target: string): boolean;
+}
+//# sourceMappingURL=security-application-service.d.ts.map

package/node_modules/@claude-flow/security/dist/application/services/security-application-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-application-service.d.ts","sourceRoot":"","sources":["../../../src/application/services/security-application-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAmB,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EAAyB,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AAElI;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QACjD,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;;IAUpE;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe;IAMlE;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5D;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAQ3C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAajE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAavE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAI9C;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB;IAQrD;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsDlG;;OAEG;IACH,kBAAkB,CAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO;CAUX"}

package/node_modules/@claude-flow/security/dist/application/services/security-application-service.js

@@ -0,0 +1,153 @@
+/**
+ * Security Application Service - Application Layer
+ *
+ * Orchestrates security operations and provides simplified interface.
+ *
+ * @module v3/security/application/services
+ */
+import { SecurityDomainService } from '../../domain/services/security-domain-service.js';
+/**
+ * Security Application Service
+ */
+export class SecurityApplicationService {
+    domainService;
+    contexts = new Map();
+    constructor() {
+        this.domainService = new SecurityDomainService();
+    }
+    // ============================================================================
+    // Context Management
+    // ============================================================================
+    /**
+     * Create and register security context for agent
+     */
+    createAgentContext(agentId, role) {
+        const context = this.domainService.createAgentContext(agentId, role);
+        this.contexts.set(agentId, context);
+        return context;
+    }
+    /**
+     * Get security context
+     */
+    getContext(principalId) {
+        return this.contexts.get(principalId);
+    }
+    /**
+     * Remove security context
+     */
+    removeContext(principalId) {
+        return this.contexts.delete(principalId);
+    }
+    // ============================================================================
+    // Validation
+    // ============================================================================
+    /**
+     * Validate path access
+     */
+    validatePath(path, principalId) {
+        const context = this.contexts.get(principalId);
+        if (!context) {
+            return {
+                valid: false,
+                errors: ['Security context not found'],
+                warnings: [],
+            };
+        }
+        return this.domainService.validatePath(path, context);
+    }
+    /**
+     * Validate command execution
+     */
+    validateCommand(command, principalId) {
+        const context = this.contexts.get(principalId);
+        if (!context) {
+            return {
+                valid: false,
+                errors: ['Security context not found'],
+                warnings: [],
+            };
+        }
+        return this.domainService.validateCommand(command, context);
+    }
+    /**
+     * Validate user input
+     */
+    validateInput(input) {
+        return this.domainService.validateInput(input);
+    }
+    /**
+     * Detect threats in content
+     */
+    detectThreats(content) {
+        return this.domainService.detectThreats(content);
+    }
+    // ============================================================================
+    // Audit
+    // ============================================================================
+    /**
+     * Run security audit on codebase
+     */
+    async auditCodebase(files) {
+        const checks = [];
+        const recommendations = [];
+        let criticalCount = 0;
+        let highCount = 0;
+        for (const file of files) {
+            const threats = this.domainService.detectThreats(file.content);
+            for (const threat of threats.threats) {
+                checks.push({
+                    name: `${threat.type} in ${file.path}`,
+                    passed: false,
+                    severity: threat.severity,
+                    message: threat.description,
+                });
+                if (threat.severity === 'critical')
+                    criticalCount++;
+                if (threat.severity === 'high')
+                    highCount++;
+            }
+            if (threats.safe) {
+                checks.push({
+                    name: `Security check: ${file.path}`,
+                    passed: true,
+                    severity: 'low',
+                    message: 'No threats detected',
+                });
+            }
+        }
+        // Generate recommendations
+        if (criticalCount > 0) {
+            recommendations.push('Address critical security issues immediately');
+        }
+        if (highCount > 0) {
+            recommendations.push('Review and fix high-severity findings');
+        }
+        recommendations.push('Run regular security scans');
+        recommendations.push('Keep dependencies updated');
+        // Calculate score
+        const totalChecks = checks.length;
+        const passedChecks = checks.filter((c) => c.passed).length;
+        const score = totalChecks > 0 ? Math.round((passedChecks / totalChecks) * 100) : 100;
+        return {
+            passed: criticalCount === 0 && highCount === 0,
+            score,
+            checks,
+            recommendations,
+        };
+    }
+    /**
+     * Check if operation is allowed
+     */
+    isOperationAllowed(principalId, operation, target) {
+        const context = this.contexts.get(principalId);
+        if (!context || context.isExpired())
+            return false;
+        if (operation === 'path') {
+            return context.canAccessPath(target);
+        }
+        else {
+            return context.canExecuteCommand(target);
+        }
+    }
+}
+//# sourceMappingURL=security-application-service.js.map

package/node_modules/@claude-flow/security/dist/application/services/security-application-service.js.map

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

package/node_modules/@claude-flow/security/dist/authorization/propagator.d.ts

@@ -0,0 +1,148 @@
+/**
+ * AgentAuthorizationPropagator — action-layer security for agent delegation.
+ *
+ * Implements P1 of ADR-144 (ruvnet/ruflo#2248): scope-envelope on SendMessage
+ * + per-action authorization checks. P2-P5 wire this into the comms layer,
+ * MCP dispatcher, MCP auth validator, and provenance log respectively.
+ *
+ * Threat model
+ * ------------
+ * When agent A delegates a task to agent B via SendMessage, B can today
+ * escalate the granted scope by calling tools A was never authorized to
+ * invoke. RBAC/ABAC on agent roles do not solve this — roles don't compose
+ * under dynamic LLM delegation (arXiv:2605.05440, Grade A formal analysis).
+ *
+ * The fix is scope-based propagation: every SendMessage carries an
+ * `AuthScope` that is *monotonically reducing* — each hop can drop tools or
+ * servers from the granted set but never add them. This is the same shape
+ * as OAuth scope reduction; adding back a tool requires talking to the
+ * original principal out-of-band.
+ *
+ * Scope
+ * -----
+ * - P1 (this file): the component, the envelope, the type-level invariants.
+ *   No call sites yet — adding the wrapping/enforcement in P2-P4.
+ * - All operations synchronous, pure, allocation-light. Targets < 1 ms p99
+ *   for `wrapOutbound` + `checkToolCall` so it can sit on every SendMessage.
+ *
+ * Backwards compatibility
+ * -----------------------
+ * `scope` on the envelope is optional in v1. Agents without scope set
+ * operate in legacy permissive mode (all tools allowed, depth unlimited,
+ * server auth unchecked). `CLAUDE_FLOW_STRICT_AUTH=true` enables enforcement.
+ *
+ * Reference: ADR-144, arXiv:2605.05440 (Authorization Propagation),
+ * arXiv:2605.28914 (AIRGuard), arXiv:2605.22333 (MCP auth survey).
+ */
+/** Scope granted to an agent at a delegation hop. Monotonically reducing. */
+export interface AuthScope {
+    /** Stable identifier of the originating principal (agent or user). */
+    readonly principalId: string;
+    /** MCP tool IDs this scope is allowed to call. */
+    readonly grantedTools: ReadonlyArray<string>;
+    /** MCP server IDs whose tool responses this scope will accept. */
+    readonly grantedServers: ReadonlyArray<string>;
+    /** Max remaining delegation hops. Decrements on every `wrapOutbound`. */
+    readonly delegationDepth: number;
+    /** Unix ms after which this scope is no longer valid. */
+    readonly expiresAt: number;
+    /**
+     * Optional opaque ID for cross-referencing with ADR-144 P5 provenance log
+     * and ADR-146 telemetry events. Callers should treat as a correlation
+     * handle, not a security claim.
+     */
+    readonly scopeId?: string;
+}
+/** Envelope shape attached to every SendMessage when strict-auth is on. */
+export interface SendMessageEnvelope<T = unknown> {
+    /** Authorization scope governing what the receiver may do. */
+    readonly scope: AuthScope;
+    /** The original SendMessage payload, untouched. */
+    readonly payload: T;
+}
+/** Decision returned by `checkToolCall`. Never throws. */
+export interface ToolCallDecision {
+    readonly allowed: boolean;
+    /** Human-readable reason; stable enough to match in tests/telemetry. */
+    readonly reason?: 'tool-not-in-scope' | 'server-not-in-scope' | 'scope-expired' | 'delegation-depth-exhausted' | 'principal-mismatch';
+}
+/**
+ * Wrap-failure reasons surfaced to callers as a typed error. We use a
+ * discriminated union rather than throwing so the comms layer (P2) can
+ * decide whether to drop the SendMessage or surface to the user.
+ */
+export declare class AuthorizationPropagationError extends Error {
+    readonly code: 'scope-cannot-grow' | 'depth-underflow' | 'scope-expired' | 'principal-mismatch';
+    constructor(code: 'scope-cannot-grow' | 'depth-underflow' | 'scope-expired' | 'principal-mismatch', message: string);
+}
+/**
+ * Construct a default permissive scope. Used in legacy mode when no scope
+ * was attached upstream. Callers SHOULD migrate to explicit scopes; this is
+ * here so the propagator never has to special-case "no scope".
+ */
+export declare function makeLegacyPermissiveScope(principalId?: string): AuthScope;
+/**
+ * `AgentAuthorizationPropagator` — the load-bearing component for ADR-144.
+ *
+ * Construction is intentionally cheap (no I/O, no async). Callers can build
+ * a fresh instance per task without overhead, or share one — it holds no
+ * mutable state beyond the optional provenance buffer.
+ */
+export declare class AgentAuthorizationPropagator {
+    private readonly opts;
+    /**
+     * In-memory provenance buffer. P5 will flush this to the structured
+     * telemetry sink (ADR-146 GuardrailEvent shape). For P1 we just retain
+     * the last N events for inspection/tests.
+     */
+    private readonly provenance;
+    constructor(opts?: {
+        provenanceBufferMax?: number;
+    });
+    /**
+     * Attach a reduced scope to an outbound SendMessage.
+     *
+     * Invariants enforced (throws `AuthorizationPropagationError` on violation):
+     *   - newly granted tools MUST be a subset of `currentScope.grantedTools`
+     *   - newly granted servers MUST be a subset of `currentScope.grantedServers`
+     *   - delegationDepth MUST decrement by ≥ 1 (must remain ≥ 0)
+     *   - principalId is propagated unchanged
+     *   - expiresAt cannot be extended; copied from the holder
+     */
+    wrapOutbound<T>(payload: T, currentScope: AuthScope, requested?: {
+        tools?: ReadonlyArray<string>;
+        servers?: ReadonlyArray<string>;
+    }): SendMessageEnvelope<T>;
+    /**
+     * Validate a single tool call against a scope. Pure; never throws. Use the
+     * result's `allowed` to make the dispatch decision.
+     */
+    checkToolCall(toolId: string, scope: AuthScope, opts?: {
+        serverId?: string;
+        now?: number;
+    }): ToolCallDecision;
+    /**
+     * Verify an MCP server presented a valid credential before its response is
+     * consumed. P1 ships a permissive default (any non-empty credential is
+     * accepted) so the API is stable; P4 wires this to a real validator.
+     *
+     * Returns `false` on missing/empty credential; callers MUST treat `false`
+     * as a hard reject (same rule as ADR-131 reject findings).
+     */
+    verifyServerAuth(serverId: string, credential: unknown): boolean;
+    /**
+     * Record an action in the provenance buffer. P5 will route to telemetry;
+     * P1 keeps the last N events for test inspection and post-incident audit.
+     */
+    recordAction(agentId: string, toolId: string, scope: AuthScope, outcome: 'allowed' | 'denied', reason?: string): void;
+    /** Read-only view of recorded provenance for tests + audit CLI (P5). */
+    getProvenance(): ReadonlyArray<{
+        agentId: string;
+        toolId: string;
+        scope: AuthScope;
+        outcome: 'allowed' | 'denied';
+        reason?: string;
+        ts: number;
+    }>;
+}
+//# sourceMappingURL=propagator.d.ts.map

package/node_modules/@claude-flow/security/dist/authorization/propagator.d.ts.map

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

package/node_modules/@claude-flow/security/dist/authorization/propagator.js

@@ -0,0 +1,182 @@
+/**
+ * AgentAuthorizationPropagator — action-layer security for agent delegation.
+ *
+ * Implements P1 of ADR-144 (ruvnet/ruflo#2248): scope-envelope on SendMessage
+ * + per-action authorization checks. P2-P5 wire this into the comms layer,
+ * MCP dispatcher, MCP auth validator, and provenance log respectively.
+ *
+ * Threat model
+ * ------------
+ * When agent A delegates a task to agent B via SendMessage, B can today
+ * escalate the granted scope by calling tools A was never authorized to
+ * invoke. RBAC/ABAC on agent roles do not solve this — roles don't compose
+ * under dynamic LLM delegation (arXiv:2605.05440, Grade A formal analysis).
+ *
+ * The fix is scope-based propagation: every SendMessage carries an
+ * `AuthScope` that is *monotonically reducing* — each hop can drop tools or
+ * servers from the granted set but never add them. This is the same shape
+ * as OAuth scope reduction; adding back a tool requires talking to the
+ * original principal out-of-band.
+ *
+ * Scope
+ * -----
+ * - P1 (this file): the component, the envelope, the type-level invariants.
+ *   No call sites yet — adding the wrapping/enforcement in P2-P4.
+ * - All operations synchronous, pure, allocation-light. Targets < 1 ms p99
+ *   for `wrapOutbound` + `checkToolCall` so it can sit on every SendMessage.
+ *
+ * Backwards compatibility
+ * -----------------------
+ * `scope` on the envelope is optional in v1. Agents without scope set
+ * operate in legacy permissive mode (all tools allowed, depth unlimited,
+ * server auth unchecked). `CLAUDE_FLOW_STRICT_AUTH=true` enables enforcement.
+ *
+ * Reference: ADR-144, arXiv:2605.05440 (Authorization Propagation),
+ * arXiv:2605.28914 (AIRGuard), arXiv:2605.22333 (MCP auth survey).
+ */
+/**
+ * Wrap-failure reasons surfaced to callers as a typed error. We use a
+ * discriminated union rather than throwing so the comms layer (P2) can
+ * decide whether to drop the SendMessage or surface to the user.
+ */
+export class AuthorizationPropagationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AuthorizationPropagationError';
+    }
+}
+/**
+ * Construct a default permissive scope. Used in legacy mode when no scope
+ * was attached upstream. Callers SHOULD migrate to explicit scopes; this is
+ * here so the propagator never has to special-case "no scope".
+ */
+export function makeLegacyPermissiveScope(principalId = 'legacy') {
+    return {
+        principalId,
+        grantedTools: ['*'], // sentinel — see `checkToolCall`
+        grantedServers: ['*'],
+        delegationDepth: Number.MAX_SAFE_INTEGER,
+        expiresAt: Number.MAX_SAFE_INTEGER,
+    };
+}
+/**
+ * `AgentAuthorizationPropagator` — the load-bearing component for ADR-144.
+ *
+ * Construction is intentionally cheap (no I/O, no async). Callers can build
+ * a fresh instance per task without overhead, or share one — it holds no
+ * mutable state beyond the optional provenance buffer.
+ */
+export class AgentAuthorizationPropagator {
+    opts;
+    /**
+     * In-memory provenance buffer. P5 will flush this to the structured
+     * telemetry sink (ADR-146 GuardrailEvent shape). For P1 we just retain
+     * the last N events for inspection/tests.
+     */
+    provenance = [];
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    /**
+     * Attach a reduced scope to an outbound SendMessage.
+     *
+     * Invariants enforced (throws `AuthorizationPropagationError` on violation):
+     *   - newly granted tools MUST be a subset of `currentScope.grantedTools`
+     *   - newly granted servers MUST be a subset of `currentScope.grantedServers`
+     *   - delegationDepth MUST decrement by ≥ 1 (must remain ≥ 0)
+     *   - principalId is propagated unchanged
+     *   - expiresAt cannot be extended; copied from the holder
+     */
+    wrapOutbound(payload, currentScope, requested = {}) {
+        if (currentScope.delegationDepth <= 0) {
+            throw new AuthorizationPropagationError('depth-underflow', `cannot delegate further — delegationDepth=${currentScope.delegationDepth}`);
+        }
+        const now = Date.now();
+        if (currentScope.expiresAt <= now) {
+            throw new AuthorizationPropagationError('scope-expired', `scope expired at ${new Date(currentScope.expiresAt).toISOString()}`);
+        }
+        const reducedTools = subsetOrThrow(currentScope.grantedTools, requested.tools ?? currentScope.grantedTools, 'tools');
+        const reducedServers = subsetOrThrow(currentScope.grantedServers, requested.servers ?? currentScope.grantedServers, 'servers');
+        const reducedScope = {
+            principalId: currentScope.principalId,
+            grantedTools: reducedTools,
+            grantedServers: reducedServers,
+            delegationDepth: currentScope.delegationDepth - 1,
+            expiresAt: currentScope.expiresAt,
+            scopeId: currentScope.scopeId,
+        };
+        return { scope: reducedScope, payload };
+    }
+    /**
+     * Validate a single tool call against a scope. Pure; never throws. Use the
+     * result's `allowed` to make the dispatch decision.
+     */
+    checkToolCall(toolId, scope, opts = {}) {
+        const now = opts.now ?? Date.now();
+        if (scope.expiresAt <= now)
+            return { allowed: false, reason: 'scope-expired' };
+        if (!matchesScopeList(scope.grantedTools, toolId)) {
+            return { allowed: false, reason: 'tool-not-in-scope' };
+        }
+        if (opts.serverId && !matchesScopeList(scope.grantedServers, opts.serverId)) {
+            return { allowed: false, reason: 'server-not-in-scope' };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Verify an MCP server presented a valid credential before its response is
+     * consumed. P1 ships a permissive default (any non-empty credential is
+     * accepted) so the API is stable; P4 wires this to a real validator.
+     *
+     * Returns `false` on missing/empty credential; callers MUST treat `false`
+     * as a hard reject (same rule as ADR-131 reject findings).
+     */
+    verifyServerAuth(serverId, credential) {
+        if (!serverId || typeof serverId !== 'string')
+            return false;
+        if (credential == null)
+            return false;
+        if (typeof credential === 'string' && credential.trim().length === 0)
+            return false;
+        return true;
+    }
+    /**
+     * Record an action in the provenance buffer. P5 will route to telemetry;
+     * P1 keeps the last N events for test inspection and post-incident audit.
+     */
+    recordAction(agentId, toolId, scope, outcome, reason) {
+        const max = this.opts.provenanceBufferMax ?? 1024;
+        this.provenance.push({ agentId, toolId, scope, outcome, reason, ts: Date.now() });
+        if (this.provenance.length > max)
+            this.provenance.splice(0, this.provenance.length - max);
+    }
+    /** Read-only view of recorded provenance for tests + audit CLI (P5). */
+    getProvenance() {
+        return this.provenance.slice();
+    }
+}
+// ─── helpers ────────────────────────────────────────────────────────────
+function subsetOrThrow(parent, requested, kind) {
+    if (parent.includes('*'))
+        return Array.from(new Set(requested));
+    for (const item of requested) {
+        if (!parent.includes(item) && item !== '*') {
+            throw new AuthorizationPropagationError('scope-cannot-grow', `cannot grant ${kind} '${item}' — not in parent scope`);
+        }
+    }
+    // De-duplicate; preserve requested order
+    const seen = new Set();
+    const out = [];
+    for (const r of requested)
+        if (!seen.has(r))
+            (seen.add(r), out.push(r));
+    return out;
+}
+function matchesScopeList(list, item) {
+    if (list.includes('*'))
+        return true;
+    return list.includes(item);
+}
+//# sourceMappingURL=propagator.js.map

package/node_modules/@claude-flow/security/dist/authorization/propagator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagator.js","sourceRoot":"","sources":["../../src/authorization/propagator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AA0CH;;;;GAIG;AACH,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAEpC;IADlB,YACkB,IAIQ,EACxB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAPC,SAAI,GAAJ,IAAI,CAII;QAIxB,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAW,GAAG,QAAQ;IAC9D,OAAO;QACL,WAAW;QACX,YAAY,EAAE,CAAC,GAAG,CAAC,EAAM,iCAAiC;QAC1D,cAAc,EAAE,CAAC,GAAG,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC,gBAAgB;QACxC,SAAS,EAAE,MAAM,CAAC,gBAAgB;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,4BAA4B;IAeV;IAd7B;;;;OAIG;IACc,UAAU,GAOtB,EAAE,CAAC;IAER,YAA6B,OAAyC,EAAE;QAA3C,SAAI,GAAJ,IAAI,CAAuC;IAAG,CAAC;IAE5E;;;;;;;;;OASG;IACH,YAAY,CACV,OAAU,EACV,YAAuB,EACvB,YAAgF,EAAE;QAElF,IAAI,YAAY,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,6BAA6B,CACrC,iBAAiB,EACjB,6CAA6C,YAAY,CAAC,eAAe,EAAE,CAC5E,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,YAAY,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;YAClC,MAAM,IAAI,6BAA6B,CACrC,eAAe,EACf,oBAAoB,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CACrE,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,aAAa,CAChC,YAAY,CAAC,YAAY,EACzB,SAAS,CAAC,KAAK,IAAI,YAAY,CAAC,YAAY,EAC5C,OAAO,CACR,CAAC;QACF,MAAM,cAAc,GAAG,aAAa,CAClC,YAAY,CAAC,cAAc,EAC3B,SAAS,CAAC,OAAO,IAAI,YAAY,CAAC,cAAc,EAChD,SAAS,CACV,CAAC;QAEF,MAAM,YAAY,GAAc;YAC9B,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,YAAY,EAAE,YAAY;YAC1B,cAAc,EAAE,cAAc;YAC9B,eAAe,EAAE,YAAY,CAAC,eAAe,GAAG,CAAC;YACjD,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,OAAO,EAAE,YAAY,CAAC,OAAO;SAC9B,CAAC;QAEF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,aAAa,CACX,MAAc,EACd,KAAgB,EAChB,OAA4C,EAAE;QAE9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QAE/E,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;QAC3D,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,QAAgB,EAAE,UAAmB;QACpD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5D,IAAI,UAAU,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QACrC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,YAAY,CACV,OAAe,EACf,MAAc,EACd,KAAgB,EAChB,OAA6B,EAC7B,MAAe;QAEf,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG;YAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC5F,CAAC;IAED,wEAAwE;IACxE,aAAa;QAQX,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;CACF;AAED,2EAA2E;AAE3E,SAAS,aAAa,CACpB,MAA6B,EAC7B,SAAgC,EAChC,IAAyB;IAEzB,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC3C,MAAM,IAAI,6BAA6B,CACrC,mBAAmB,EACnB,gBAAgB,IAAI,KAAK,IAAI,yBAAyB,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,yCAAyC;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA2B,EAAE,IAAY;IACjE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}