FreeOS self-growth loop works end to end

[XYAIStudio]

Summary

The FreeOS ↔ openXYOS self-growth loop is now a runnable product path, not a scaffold.

FreeOS produces AI employees, skills, plugins, and MCPs. Those assets apply onto openXYOS-shaped surfaces. Control-plane blueprints, catalog, and policies import back and register real FreeOS chat agents. High-risk tools are blocked on the host tool path.

One command proves it:

uv run freeos org loop run

Or bash scripts/org-loop.sh. With OPENXYOS_BASE_URL set, outbound packs POST/PUT to the live control plane. When the sidecar is down, bundled fixtures + {FREEOS_HOME}/openxyos-mirror/ still complete the loop.

Target branch

• Base is main

Type of change

• New feature

What landed

• freeos org loop run — compile demo blueprints → draft→active → spawn agents → publish pack → apply → import back → prove governance execute=false
• freeos org assets apply — real HTTP client for /api/employees, /api/talent, /api/plugins, /api/module-settings plus a durable local mirror
• Inbound spawn — import / shadow|active writes org-<slug> into the host agents table, skill packages, and tenant routing.json
• Host governance — OrgGovernanceMiddleware is first in the harness middleware chain; pending/deny returns an error ToolMessage and does not run the tool
• Chat + org memory hooks — resolve_user_agent resolves colleague slugs/names; MEMORY/knowledge sync into org-knowledge/live/<slug>/
• Demo fixtures — tests/fixtures/org-loop/ and packaged src/octop/modules/org_os/loop/data/
• README describes the finished loop as the product

Test plan

uv run pytest tests/e2e/test_org_growth_loop.py tests/unit/test_org_loop.py tests/unit/test_openxyos_apply.py tests/unit/test_colleague_spawn.py tests/unit/test_host_governance.py tests/unit/test_lifecycle.py tests/unit/test_asset_loop.py tests/unit/test_governance_mcp.py

• Added/updated tests (e2e + apply harness + spawn + host gate)
• CHANGELOG.md / README / docs/asset-loop.md updated
• Full make all (CI on this PR)

Checklist

• Updated CHANGELOG.md
• README / docs updated