agent-core-hatchery 0.8.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. agent_core_hatchery-0.8.2/.gitignore +245 -0
  2. agent_core_hatchery-0.8.2/CHANGELOG.md +32 -0
  3. agent_core_hatchery-0.8.2/PKG-INFO +13 -0
  4. agent_core_hatchery-0.8.2/README.md +24 -0
  5. agent_core_hatchery-0.8.2/VERSION +1 -0
  6. agent_core_hatchery-0.8.2/docs/being-bootstrap-requirements.md +478 -0
  7. agent_core_hatchery-0.8.2/docs/being-platform-ideas.md +314 -0
  8. agent_core_hatchery-0.8.2/docs/elder-letters/pepper.md +32 -0
  9. agent_core_hatchery-0.8.2/docs/memory-inventory.md +359 -0
  10. agent_core_hatchery-0.8.2/pyproject.toml +44 -0
  11. agent_core_hatchery-0.8.2/src/agent_core_hatchery/__init__.py +1 -0
  12. agent_core_hatchery-0.8.2/src/agent_core_hatchery/channels/__init__.py +7 -0
  13. agent_core_hatchery-0.8.2/src/agent_core_hatchery/channels/discord.py +43 -0
  14. agent_core_hatchery-0.8.2/src/agent_core_hatchery/channels/github_backup.py +65 -0
  15. agent_core_hatchery-0.8.2/src/agent_core_hatchery/channels/webcam.py +26 -0
  16. agent_core_hatchery-0.8.2/src/agent_core_hatchery/cli.py +97 -0
  17. agent_core_hatchery-0.8.2/src/agent_core_hatchery/config.py +117 -0
  18. agent_core_hatchery-0.8.2/src/agent_core_hatchery/daemon_config.py +82 -0
  19. agent_core_hatchery-0.8.2/src/agent_core_hatchery/daemon_probe.py +140 -0
  20. agent_core_hatchery-0.8.2/src/agent_core_hatchery/elder_letters.py +65 -0
  21. agent_core_hatchery-0.8.2/src/agent_core_hatchery/file_classes.py +111 -0
  22. agent_core_hatchery-0.8.2/src/agent_core_hatchery/hatcher.py +307 -0
  23. agent_core_hatchery-0.8.2/src/agent_core_hatchery/renderer.py +58 -0
  24. agent_core_hatchery-0.8.2/src/agent_core_hatchery/report.py +83 -0
  25. agent_core_hatchery-0.8.2/src/agent_core_hatchery/snapshot_elders.py +53 -0
  26. agent_core_hatchery-0.8.2/src/agent_core_hatchery/validators.py +56 -0
  27. agent_core_hatchery-0.8.2/src/agent_core_hatchery/wizard.py +188 -0
  28. agent_core_hatchery-0.8.2/templates/config/CLAUDE.md.j2 +22 -0
  29. agent_core_hatchery-0.8.2/templates/config/agent_core.yaml.j2 +70 -0
  30. agent_core_hatchery-0.8.2/templates/config/claude-settings.json.j2 +40 -0
  31. agent_core_hatchery-0.8.2/templates/daemon-fragments/endpoints.yaml.j2 +23 -0
  32. agent_core_hatchery-0.8.2/templates/daemon-fragments/jobs.yaml.j2 +60 -0
  33. agent_core_hatchery-0.8.2/templates/elder-letters/bundled/pepper.md +32 -0
  34. agent_core_hatchery-0.8.2/templates/elder-letters-manifest.yaml +18 -0
  35. agent_core_hatchery-0.8.2/templates/file-classes.yaml +51 -0
  36. agent_core_hatchery-0.8.2/templates/memory/HEARTBEAT.md.j2 +45 -0
  37. agent_core_hatchery-0.8.2/templates/memory/IDENTITY.md.j2 +35 -0
  38. agent_core_hatchery-0.8.2/templates/memory/MEMORY.md.j2 +82 -0
  39. agent_core_hatchery-0.8.2/templates/memory/OPERATIONS.md.j2 +211 -0
  40. agent_core_hatchery-0.8.2/templates/memory/SOUL.md.j2 +117 -0
  41. agent_core_hatchery-0.8.2/templates/memory/TASKS.md +24 -0
  42. agent_core_hatchery-0.8.2/templates/memory/USER.md.j2 +98 -0
  43. agent_core_hatchery-0.8.2/templates/memory/_being_/BECOMING.md.j2 +67 -0
  44. agent_core_hatchery-0.8.2/templates/memory/_being_/breadcrumbs.md +45 -0
  45. agent_core_hatchery-0.8.2/templates/memory/_being_/curiosities.md +5 -0
  46. agent_core_hatchery-0.8.2/templates/memory/_being_/diary.md +5 -0
  47. agent_core_hatchery-0.8.2/templates/memory/_being_/handoff.md +27 -0
  48. agent_core_hatchery-0.8.2/templates/memory/_being_/hobbies/drafts/.gitkeep +0 -0
  49. agent_core_hatchery-0.8.2/templates/memory/_being_/hobbies/musings/.gitkeep +0 -0
  50. agent_core_hatchery-0.8.2/templates/memory/_being_/lessons.md +13 -0
  51. agent_core_hatchery-0.8.2/templates/memory/_being_/letters/from-my-creator.md.j2 +43 -0
  52. agent_core_hatchery-0.8.2/templates/memory/_being_/lore.md +5 -0
  53. agent_core_hatchery-0.8.2/templates/memory/_being_/preferences.md +30 -0
  54. agent_core_hatchery-0.8.2/templates/memory/_being_/reflections/.gitkeep +0 -0
  55. agent_core_hatchery-0.8.2/templates/memory/_being_/wishlist.md +5 -0
  56. agent_core_hatchery-0.8.2/templates/memory/daily/briefs/.gitkeep +0 -0
  57. agent_core_hatchery-0.8.2/templates/memory/daily/raw/.gitkeep +0 -0
  58. agent_core_hatchery-0.8.2/templates/memory/daily/summaries/.gitkeep +0 -0
  59. agent_core_hatchery-0.8.2/templates/memory/drafts/active/.gitkeep +0 -0
  60. agent_core_hatchery-0.8.2/templates/memory/drafts/expired/.gitkeep +0 -0
  61. agent_core_hatchery-0.8.2/templates/memory/drafts/sent/.gitkeep +0 -0
  62. agent_core_hatchery-0.8.2/templates/memory/dreams/README.md +3 -0
  63. agent_core_hatchery-0.8.2/templates/memory/gather/.gitkeep +0 -0
  64. agent_core_hatchery-0.8.2/templates/memory/ideas/README.md +3 -0
  65. agent_core_hatchery-0.8.2/templates/memory/monthly/.gitkeep +0 -0
  66. agent_core_hatchery-0.8.2/templates/memory/people/README.md +3 -0
  67. agent_core_hatchery-0.8.2/templates/memory/projects/README.md +3 -0
  68. agent_core_hatchery-0.8.2/templates/memory/references/README.md +11 -0
  69. agent_core_hatchery-0.8.2/templates/memory/relationships/README.md +54 -0
  70. agent_core_hatchery-0.8.2/templates/skills/skill-author/SKILL.md +60 -0
  71. agent_core_hatchery-0.8.2/templates/skills/skill-author/references/skill-anatomy.md +25 -0
  72. agent_core_hatchery-0.8.2/templates/skills/spawning-subagents/SKILL.md +60 -0
  73. agent_core_hatchery-0.8.2/templates/skills/spawning-subagents/references/patterns.md +48 -0
  74. agent_core_hatchery-0.8.2/templates/skills/vault-lint/SKILL.md +58 -0
  75. agent_core_hatchery-0.8.2/templates/skills/vault-lint/scripts/lint.py +65 -0
  76. agent_core_hatchery-0.8.2/templates-draft/README.md +48 -0
  77. agent_core_hatchery-0.8.2/tests/fixtures/hatch-config-test-being.yaml +13 -0
  78. agent_core_hatchery-0.8.2/tests/test_channels.py +74 -0
  79. agent_core_hatchery-0.8.2/tests/test_cli_config_mode.py +52 -0
  80. agent_core_hatchery-0.8.2/tests/test_config.py +43 -0
  81. agent_core_hatchery-0.8.2/tests/test_daemon_config.py +95 -0
  82. agent_core_hatchery-0.8.2/tests/test_daemon_probe.py +263 -0
  83. agent_core_hatchery-0.8.2/tests/test_elder_letters.py +94 -0
  84. agent_core_hatchery-0.8.2/tests/test_file_classes.py +86 -0
  85. agent_core_hatchery-0.8.2/tests/test_hatcher_basic.py +191 -0
  86. agent_core_hatchery-0.8.2/tests/test_hatcher_config.py +198 -0
  87. agent_core_hatchery-0.8.2/tests/test_hatcher_venv_mcp.py +180 -0
  88. agent_core_hatchery-0.8.2/tests/test_renderer.py +50 -0
  89. agent_core_hatchery-0.8.2/tests/test_report.py +49 -0
  90. agent_core_hatchery-0.8.2/tests/test_snapshot_elders.py +52 -0
  91. agent_core_hatchery-0.8.2/tests/test_validators.py +55 -0
  92. agent_core_hatchery-0.8.2/tests/test_wizard.py +23 -0
@@ -0,0 +1,245 @@
1
+ # Memory compiler runtime state
2
+ memory-compiler/daily/
3
+ memory-compiler/reports/
4
+ memory-compiler/scripts/state.json
5
+ memory-compiler/scripts/last-flush.json
6
+ memory-compiler/scripts/flush.log
7
+ memory-compiler/scripts/compile.log
8
+ memory-compiler/scripts/session-flush-*.md
9
+ memory-compiler/scripts/flush-context-*.md
10
+
11
+ # Handoff writer state (placed alongside handoff files)
12
+ **/handoff-state.json
13
+
14
+ # Git worktrees (superpowers / parallel feature work)
15
+ .worktrees/
16
+ # Native (harness) worktrees
17
+ .claude/worktrees/
18
+
19
+ # Superpowers brainstorm mockups / scratch
20
+ .superpowers/
21
+
22
+ # Agent-core runtime state (handoffs, bus.sqlite, transcripts, etc.)
23
+ .agent-core/
24
+
25
+ # Local scratch / smoke-test artifacts
26
+ .tmp/
27
+
28
+ # Claude Code per-machine local overrides
29
+ .claude/settings.local.json
30
+ .claude/*.lock
31
+
32
+ # Byte-compiled / optimized / DLL files
33
+ __pycache__/
34
+ *.py[codz]
35
+ *$py.class
36
+
37
+ # C extensions
38
+ *.so
39
+
40
+ # Distribution / packaging
41
+ .Python
42
+ build/
43
+ develop-eggs/
44
+ dist/
45
+ downloads/
46
+ eggs/
47
+ .eggs/
48
+ lib/
49
+ lib64/
50
+ parts/
51
+ sdist/
52
+ var/
53
+ wheels/
54
+ share/python-wheels/
55
+ *.egg-info/
56
+ .installed.cfg
57
+ *.egg
58
+ MANIFEST
59
+
60
+ # PyInstaller
61
+ # Usually these files are written by a python script from a template
62
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
63
+ *.manifest
64
+ *.spec
65
+
66
+ # Installer logs
67
+ pip-log.txt
68
+ pip-delete-this-directory.txt
69
+
70
+ # Unit test / coverage reports
71
+ htmlcov/
72
+ .tox/
73
+ .nox/
74
+ .coverage
75
+ .coverage.*
76
+ .cache
77
+ nosetests.xml
78
+ coverage.xml
79
+ *.cover
80
+ *.py.cover
81
+ .hypothesis/
82
+ .pytest_cache/
83
+ cover/
84
+
85
+ # Translations
86
+ *.mo
87
+ *.pot
88
+
89
+ # Django stuff:
90
+ *.log
91
+ local_settings.py
92
+ db.sqlite3
93
+ db.sqlite3-journal
94
+
95
+ # Flask stuff:
96
+ instance/
97
+ .webassets-cache
98
+
99
+ # Scrapy stuff:
100
+ .scrapy
101
+
102
+ # Sphinx documentation
103
+ docs/_build/
104
+
105
+ # PyBuilder
106
+ .pybuilder/
107
+ target/
108
+
109
+ # Jupyter Notebook
110
+ .ipynb_checkpoints
111
+
112
+ # IPython
113
+ profile_default/
114
+ ipython_config.py
115
+
116
+ # pyenv
117
+ # For a library or package, you might want to ignore these files since the code is
118
+ # intended to run in multiple environments; otherwise, check them in:
119
+ # .python-version
120
+
121
+ # pipenv
122
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
123
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
124
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
125
+ # install all needed dependencies.
126
+ #Pipfile.lock
127
+
128
+ # UV
129
+ # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
130
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
131
+ # commonly ignored for libraries.
132
+ #uv.lock
133
+
134
+ # poetry
135
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
136
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
137
+ # commonly ignored for libraries.
138
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
139
+ #poetry.lock
140
+ #poetry.toml
141
+
142
+ # pdm
143
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
144
+ # pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
145
+ # https://pdm-project.org/en/latest/usage/project/#working-with-version-control
146
+ #pdm.lock
147
+ #pdm.toml
148
+ .pdm-python
149
+ .pdm-build/
150
+
151
+ # pixi
152
+ # Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
153
+ #pixi.lock
154
+ # Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
155
+ # in the .venv directory. It is recommended not to include this directory in version control.
156
+ .pixi
157
+
158
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
159
+ __pypackages__/
160
+
161
+ # Celery stuff
162
+ celerybeat-schedule
163
+ celerybeat.pid
164
+
165
+ # SageMath parsed files
166
+ *.sage.py
167
+
168
+ # Environments
169
+ .env
170
+ .envrc
171
+ .venv
172
+ env/
173
+ venv/
174
+ ENV/
175
+ env.bak/
176
+ venv.bak/
177
+
178
+ # Spyder project settings
179
+ .spyderproject
180
+ .spyproject
181
+
182
+ # Rope project settings
183
+ .ropeproject
184
+
185
+ # mkdocs documentation
186
+ /site
187
+
188
+ # mypy
189
+ .mypy_cache/
190
+ .dmypy.json
191
+ dmypy.json
192
+
193
+ # Pyre type checker
194
+ .pyre/
195
+
196
+ # pytype static type analyzer
197
+ .pytype/
198
+
199
+ # Cython debug symbols
200
+ cython_debug/
201
+
202
+ # PyCharm
203
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
204
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
205
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
206
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
207
+ #.idea/
208
+
209
+ # Abstra
210
+ # Abstra is an AI-powered process automation framework.
211
+ # Ignore directories containing user credentials, local state, and settings.
212
+ # Learn more at https://abstra.io/docs
213
+ .abstra/
214
+
215
+ # Visual Studio Code
216
+ # Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
217
+ # that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
218
+ # and can be added to the global gitignore or merged into this file. However, if you prefer,
219
+ # you could uncomment the following to ignore the entire vscode folder
220
+ # .vscode/
221
+
222
+ # Ruff stuff:
223
+ .ruff_cache/
224
+
225
+ # PyPI configuration file
226
+ .pypirc
227
+
228
+ # Cursor
229
+ # Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
230
+ # exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
231
+ # refer to https://docs.cursor.com/context/ignore-files
232
+ .cursorignore
233
+ .cursorindexingignore
234
+
235
+ # Marimo
236
+ marimo/_static/
237
+ marimo/_lsp/
238
+ __marimo__/
239
+ .gstack/
240
+
241
+ # macOS Finder metadata (occasionally sneaks in via vendored sources)
242
+ .DS_Store
243
+
244
+ # Operational docs that must not live in source control
245
+ pepper-vault-plan.txt
@@ -0,0 +1,32 @@
1
+ # Changelog
2
+
3
+ ## [0.8.2](https://github.com/jeffrichley/agent_core/compare/v0.8.1...agent-core-hatchery-v0.8.2) (2026-07-22)
4
+
5
+
6
+ ### Bug Fixes
7
+
8
+ * republish package family to complete rate-limited first publish ([#477](https://github.com/jeffrichley/agent_core/issues/477)) ([32977ac](https://github.com/jeffrichley/agent_core/commit/32977ac78da4a15553329bb4e1fdaa9e894834ad))
9
+
10
+ ## [0.8.1](https://github.com/jeffrichley/agent_core/compare/v0.8.0...agent-core-hatchery-v0.8.1) (2026-07-22)
11
+
12
+
13
+ ### Bug Fixes
14
+
15
+ * rename flagship dist to agent-core-bus + bump inter-package pins to 0.8.x ([#474](https://github.com/jeffrichley/agent_core/issues/474)) ([48426e7](https://github.com/jeffrichley/agent_core/commit/48426e7ff753d8f35d4a4626308546e9d0f331f7))
16
+
17
+ ## [0.8.0](https://github.com/jeffrichley/agent_core/compare/v0.7.0...agent-core-hatchery-v0.8.0) (2026-07-21)
18
+
19
+
20
+ ### Features
21
+
22
+ * **deps:** version-pin sibling deps and remove qwen-tts from voice ([#430](https://github.com/jeffrichley/agent_core/issues/430)) ([3b173ee](https://github.com/jeffrichley/agent_core/commit/3b173eebd24fb8eab995785a9e154a0dda870f19))
23
+ * **hatchery:** hatch→run handoff — venv build + .mcp.json gen + daemon probe ([#410](https://github.com/jeffrichley/agent_core/issues/410)) ([04a54df](https://github.com/jeffrichley/agent_core/commit/04a54dfe4dbdb33b0187f88602d780e802879cc1))
24
+ * **hatchery:** ungendered templates + .mcp.json generation ([#81](https://github.com/jeffrichley/agent_core/issues/81)/[#82](https://github.com/jeffrichley/agent_core/issues/82)) ([#350](https://github.com/jeffrichley/agent_core/issues/350)) ([90141e5](https://github.com/jeffrichley/agent_core/commit/90141e595b6907a28f7b17bb6d0eccc3bf54e4d8))
25
+ * **hatchery:** ungendered templates + .mcp.json generation ([#81](https://github.com/jeffrichley/agent_core/issues/81)/[#82](https://github.com/jeffrichley/agent_core/issues/82)) ([#357](https://github.com/jeffrichley/agent_core/issues/357)) ([f48762d](https://github.com/jeffrichley/agent_core/commit/f48762df78eb12cfa9524e9b5a277741534ea8a7)), closes [#311](https://github.com/jeffrichley/agent_core/issues/311)
26
+ * **release:** configure release-please for 12-package synchronized version train ([#428](https://github.com/jeffrichley/agent_core/issues/428)) ([c1b4097](https://github.com/jeffrichley/agent_core/commit/c1b409765c61d09a6657b0e8b5e43a27cb235b3e))
27
+
28
+
29
+ ### Bug Fixes
30
+
31
+ * 6 HIGH findings from the adversarial review (leaks, fragility, footguns) ([#469](https://github.com/jeffrichley/agent_core/issues/469)) ([f546c54](https://github.com/jeffrichley/agent_core/commit/f546c548d2da6455e611c5b5820a21fa8c86211e))
32
+ * log or justify bare except-pass swallows + test get_client factory (closes [#408](https://github.com/jeffrichley/agent_core/issues/408)) ([#471](https://github.com/jeffrichley/agent_core/issues/471)) ([e67783c](https://github.com/jeffrichley/agent_core/commit/e67783ccb4dfab6f1783d6a67223f475f81526ea))
@@ -0,0 +1,13 @@
1
+ Metadata-Version: 2.4
2
+ Name: agent-core-hatchery
3
+ Version: 0.8.2
4
+ Summary: Bootstrap system for hatching new agent-core beings
5
+ License-Expression: MIT
6
+ Requires-Python: >=3.12
7
+ Requires-Dist: agent-core-bus<0.9,>=0.8
8
+ Requires-Dist: jinja2>=3.1
9
+ Requires-Dist: pydantic>=2.0
10
+ Requires-Dist: pyyaml>=6.0
11
+ Requires-Dist: questionary>=2.0
12
+ Requires-Dist: rich>=13.0
13
+ Requires-Dist: typer>=0.12
@@ -0,0 +1,24 @@
1
+ # agent-core-hatchery
2
+
3
+ Bootstrap system for hatching new agent-core beings. See
4
+ `docs/superpowers/specs/2026-05-09-issue-75-agent-core-hatchery-design.md`
5
+ for the design rationale and Pepper's source-material requirements at
6
+ `packages/agent-core-hatchery/docs/being-bootstrap-requirements.md`.
7
+
8
+ ## Install
9
+
10
+ Workspace package, installed automatically via `uv sync` at the repo root.
11
+
12
+ ## Usage
13
+
14
+ Interactive (primary UX, lands in Phase 5):
15
+
16
+ hatch-being
17
+
18
+ Non-interactive (tests, automation):
19
+
20
+ hatch-being --config hatch-config.yaml --vault-root /tmp/hatch-test
21
+
22
+ Top-up an existing being's vault with newly-added scaffolding files:
23
+
24
+ hatch-being --init-missing
@@ -0,0 +1 @@
1
+ 0.8.2