@@ -183,9 +183,15 @@ const layer = Layer.effect(
183183
184184 const evaluateInput = Effect . fnUntraced ( function * ( input : AssertInput ) {
185185 const rules = yield * configured ( input . sessionID , input . agent )
186- if ( denied ( input , rules ) ) return { effect : "deny" as const , rules }
187186 const all = [ ...rules , ...( yield * savedRules ( ) ) ]
188- const effects = input . resources . map ( ( resource ) => evaluate ( input . action , resource , all ) . effect )
187+ // Capture the exact matched rule for each resource during evaluation.
188+ // This provides structured rule attribution without altering enforcement logic.
189+ const matchedRules = input . resources . map ( ( resource ) => {
190+ const matched = evaluate ( input . action , resource , all )
191+ return { resource, rule : matched }
192+ } )
193+ if ( denied ( input , rules ) ) return { effect : "deny" as const , rules : all , matchedRules : input . resources . map ( ( resource ) => ( { resource, rule : evaluate ( input . action , resource , all ) } ) ) }
194+ const effects = matchedRules . map ( ( m ) => m . rule . effect )
189195 const effect : Permission . Effect = effects . includes ( "ask" ) ? "ask" : "allow"
190196 const event = yield * hooks . trigger ( "permission" , "evaluate" , {
191197 sessionID : input . sessionID ,
@@ -195,17 +201,21 @@ const layer = Layer.effect(
195201 metadata : input . metadata ,
196202 source : input . source ,
197203 effect,
204+ // Structured rule attribution: the winning rule matched per resource.
205+ // Omitted when diagnostics are disabled to maintain zero performance overhead.
206+ matchedRules,
198207 } )
199208 const unattended = yield * Unattended
200209 if ( event . effect !== "ask" || unattended === undefined )
201- return { effect : event . effect , message : event . message , rules : all }
210+ return { effect : event . effect , message : event . message , rules : all , matchedRules }
202211 const settled = [ ...all , ...unattended ]
203212 const allowed = input . resources . every ( ( resource ) => evaluate ( input . action , resource , settled ) . effect === "allow" )
204- if ( allowed ) return { effect : "allow" as const , rules : all }
213+ if ( allowed ) return { effect : "allow" as const , rules : all , matchedRules }
205214 return {
206215 effect : "deny" as const ,
207216 message : `Permission ${ input . action } needs approval, and nobody is present to give it` ,
208217 rules : all ,
218+ matchedRules,
209219 }
210220 } )
211221
@@ -246,11 +256,11 @@ const layer = Layer.effect(
246256 )
247257
248258 const ask = Effect . fn ( "Permission.ask" ) ( function * ( input : AssertInput ) {
249- if ( closed ) return { id : input . id ?? ID . create ( ) , effect : "deny" as const }
259+ if ( closed ) return { id : input . id ?? ID . create ( ) , effect : "deny" as const , matchedRules : [ ] }
250260 const result = yield * evaluateInput ( input )
251261 const value = request ( input , result . message )
252262 if ( result . effect === "ask" ) yield * create ( value , input . agent )
253- return { id : value . id , effect : result . effect }
263+ return { id : value . id , effect : result . effect , matchedRules : result . matchedRules ?? [ ] }
254264 } )
255265
256266 const assert = Effect . fn ( "Permission.assert" ) ( ( input : AssertInput ) =>
0 commit comments