What is the recommended way to manage **local** configuration?

[srid]

My project has a top-level apm.yml with external dependencies, but also referring to local rules and such.

Concretely: juspay/AI#48

Presently, I'm forced to:

a) Move these local rules (.apm) to a sub-directory, like ./agent)
b) Stub out a ./agent/apm.yml

But is this the idiomatic way of using apm like this? Or am I missing something else?

[edenfunf]

Hey, I dug into this and it's a real bug -- not something you're doing wrong.

The root cause is in _install_apm_dependencies(): there are two early-return guards that fire before the integration pipeline even starts. Both check whether the resolved dep list is empty, which means your project root's own .apm/ never gets a chance to run through the integrator. The pipeline only ever processes paths inside apm_modules/.

The ./agent/apm.yml workaround works because it forces your rules through the normal dependency path (copy to apm_modules/_local/, then integrate). It should not be necessary.

Opened #714 to track this and submitted a fix in #715 -- after the dep loop, the install step now treats the project root itself as an implicit package and runs it through the same integration pipeline. So root-level .apm/ alongside external deps should just work without any stub.