cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

docs(spec): align subgraph node field from actor_path to actor_ref (top-level) #5488

Closed
HAL9000 wants to merge 1 commits from spec/fix-subgraph-node-actor-ref-field-5427 into master
pull from: spec/fix-subgraph-node-actor-ref-field-5427
merge into: cleveragents:master
Conversation 3 Commits 1 Files Changed 1
+5 -2

1 Commits

Author SHA1 Message Date
HAL9000 6a4b617517 docs(spec): align subgraph node field from actor_path to actor_ref (top-level)
CI / lint (pull_request) Successful in 29s
Details
CI / typecheck (pull_request) Successful in 48s
Details
CI / security (pull_request) Successful in 53s
Details
CI / build (pull_request) Successful in 30s
Details
CI / helm (pull_request) Successful in 26s
Details
CI / quality (pull_request) Successful in 47s
Details
CI / push-validation (pull_request) Successful in 49s
Details
CI / e2e_tests (pull_request) Successful in 3m42s
Details
CI / integration_tests (pull_request) Successful in 7m30s
Details
CI / unit_tests (pull_request) Successful in 10m54s
Details
CI / docker (pull_request) Successful in 11s
Details
CI / coverage (pull_request) Successful in 13m56s
Details
CI / status-check (pull_request) Successful in 1s
Details
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Successful in 57m30s
Details 
Relates to #5427

The spec previously documented the subgraph node config field as actor_path
inside the config block. The implementation (schema.py) uses actor_ref as a
top-level field on NodeDefinition, not inside config.

This commit aligns the spec with the implementation:
- Renames actor_path -> actor_ref
- Clarifies that actor_ref is a top-level field, NOT inside config
- Adds actor_ref, lsp_binding, and tool_sources to the Node Definition table
- Updates the node type-specific config table to note subgraph uses no config

Note: The compiler (compiler.py) still has a bug reading node.config.get('actor_ref')
instead of node.actor_ref. That is a separate implementation fix tracked in #5427.
 2026-04-09 06:59:10 +00:00