Skip to content

fix: make Agent Spec placement path-independent - #93

Merged
myobie merged 2 commits into
mainfrom
agent/issue-88-path-independent-identity
Jul 30, 2026
Merged

fix: make Agent Spec placement path-independent#93
myobie merged 2 commits into
mainfrom
agent/issue-88-path-independent-identity

Conversation

@myobie

@myobie myobie commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Summary

  • make an explicit Agent Spec identity + host pair authoritative independent of declaration path while preserving path defaults and mismatch diagnostics when either field is omitted
  • discover declarations recursively through ordinary organizational and dot-prefixed folders, with exclusions scoped to .git/.st2 control directories, the catalog-root PTY registry, and state directories owned by an actual declaration
  • share the catalog-space predicate with the supervisor watcher and record the boundary in the root VRS

Contract

  • moving a fully explicit declaration does not change its resolved identity or host
  • the declaration parent remains the state/resource and edit anchor
  • .managed, .retired, and nested project folders named archive, resources, or inbox carry no implicit lifecycle/control meaning
  • .git and .st2 are excluded at every hierarchy depth so nested repositories/control state cannot expose declarations
  • pty is excluded only at the catalog root; resources, archive, and inbox are excluded only as children of an actual declaration parent
  • partial declarations retain the existing path-derived defaults and mismatch warnings
  • duplicate resolved bus IDs remain validation errors

Verification at 0872e53a6aa3c4d1b356981faf91279a57821cf8

Review correction

  • excludes nested .git and .st2 paths in both discovery and watcher classification
  • keeps pty root-only, declaration state directories contextual, and all other dot folders ordinary
  • rebased onto live main ce2c1069f2a59fd50a0ca1d56346e103db666ed2, preserving PR feat(agent-spec): add typed Resource bindings #86 resource bindings

No live catalog, supervisor, service, or PTY state was mutated.

Closes #88
Closes #90

@myobie
myobie force-pushed the agent/issue-88-path-independent-identity branch from d7c2866 to 0872e53 Compare July 30, 2026 14:09
@myobie
myobie marked this pull request as ready for review July 30, 2026 14:17
@myobie
myobie merged commit f96f925 into main Jul 30, 2026
1 check passed
@schickling schickling added area:agent-spec Agent Spec format, parsing, and the agent-spec crate · Set: manual area:catalog Catalog structure, declarations, transactions, and admission · Set: manual type:bug Something broken or a regression · Set: manual labels Aug 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:agent-spec Agent Spec format, parsing, and the agent-spec crate · Set: manual area:catalog Catalog structure, declarations, transactions, and admission · Set: manual type:bug Something broken or a regression · Set: manual

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Support dot-prefixed catalog folders Decouple explicit Agent Spec identity and host from catalog directory layout

2 participants