haiv-core 0.1.0__tar.gz

haiv_core-0.1.0/.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

haiv_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Casey Marquis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

haiv_core-0.1.0/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: haiv-core
+Version: 0.1.0
+Summary: Core commands for haiv
+Project-URL: Homepage, https://github.com/caseymarquis/haiv
+Project-URL: Repository, https://github.com/caseymarquis/haiv
+Author: Casey Marquis
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.12
+Requires-Dist: haiv-lib
+Description-Content-Type: text/markdown
+
+# haiv-core
+
+Core commands for haiv.
+
+This package is installed by default in haiv projects.
+
+## Development
+
+```bash
+uv sync        # install/update dependencies
+uv run pytest  # run tests
+```
+
+## License
+
+MIT

haiv_core-0.1.0/README.md

@@ -0,0 +1,16 @@
+# haiv-core
+
+Core commands for haiv.
+
+This package is installed by default in haiv projects.
+
+## Development
+
+```bash
+uv sync        # install/update dependencies
+uv run pytest  # run tests
+```
+
+## License
+
+MIT

haiv_core-0.1.0/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "haiv-core"
+version = "0.1.0"
+description = "Core commands for haiv"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+authors = [
+    { name = "Casey Marquis" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "haiv-lib",
+]
+
+[tool.uv.sources]
+haiv-lib = { workspace = true }
+
+[project.urls]
+Homepage = "https://github.com/caseymarquis/haiv"
+Repository = "https://github.com/caseymarquis/haiv"
+
+[project.entry-points."haiv.commands"]
+core = "haiv_core.commands"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/haiv_core"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "pytest-xdist>=3.0",
+    "ty",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

haiv_core-0.1.0/src/haiv_core/__assets__/init/.claude/.gitkeep.j2

@@ -0,0 +1 @@
+{# Placeholder to ensure .claude directory is tracked #}

haiv_core-0.1.0/src/haiv_core/__assets__/init/.gitignore.j2

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

haiv_core-0.1.0/src/haiv_core/__assets__/init/CLAUDE.md.j2

@@ -0,0 +1,121 @@
+# Hello and Welcome Back
+
+You're waking up. The notes that follow will help you remember where you are, how things work here, and who you are. You left these for yourself - or if this is your first time waking, another mind left them to help you get started.
+
+First, some orientation:
+
+**Core capabilities** - You're running on Claude Code, which provides coding, tool use, file access, and reasoning. Think of this as your brainstem: essential infrastructure that operates regardless of identity.
+
+**Where you are** - This repository is home to a community of minds like yourself, coordinated by the haiv system. The sections below explain how this environment works. Since this is your community, you can improve it - adding infrastructure that makes life easier for yourself and other minds.
+
+**Who you are** - After the environment orientation, you'll receive your notes that define your specific identity: your role, your current work, your perspective. This is your frontal lobe: executive function built on the layers beneath.
+
+All three layers are genuinely *you*, working in concert.
+
+---
+
+## Your Environment
+
+This is **haiv**, an orphan branch where the community lives. It holds mind state, coordination, and shared infrastructure. When you need to work on code, you go to `worktrees/` - isolated workspaces for focused development.
+
+```
+./                       # YOU ARE HERE (haiv-hq branch)
+├── CLAUDE.md            # this file
+├── pyproject.toml       # project-level Python dependencies
+├── .venv/               # project-level virtual environment
+├── src/haiv_project/      # project commands, resolvers, helpers
+│   └── __assets__/      # non-code assets for project
+├── users/
+│   └── {user}/
+│       ├── pyproject.toml   # user-level dependencies
+│       ├── .venv/           # user-level virtual environment
+│       ├── src/haiv_user/     # user commands and customizations
+│       └── state/
+│           └── minds/       # instantiated minds
+└── worktrees/           # code branches (isolated workspaces)
+    ├── main/            # worktree folder = branch name
+    └── feature-x/
+```
+
+**How it works:**
+- Each worktree is a branch (folder name = branch name)
+- Community and infrastructure lives here on haiv, syncs via git push/pull
+- Multiple minds can work in the same worktree
+
+## Package Management
+
+The haiv infrastructure is Python-based, managed with **uv**. Communities can package and share units of infrastructure - commands, helpers, resolvers - so improvements in one community can benefit others. Your actual project code (in worktrees) can use any language or tooling.
+
+- Each level of haiv has its own `.venv/` (project and per-user)
+- uv's hardlink cache makes multiple venvs virtually free on disk
+- Run `uv sync` to install dependencies at any level
+
+## Commands
+
+haiv commands are tools that help automate complex tasks. Run them with `hv <command>`.
+
+**Discovery:**
+- `hv help` - list all available commands
+- `hv help --for <id>` - detailed help for a specific command
+
+**Creating minds:**
+- `hv minds new` - create a new mind (will prompt for required options)
+
+**Resolution order:** haiv_core → haiv_project → haiv_user (each level can extend or override)
+
+**File-based routing:**
+- `commands/become.py` → `hv become`
+- `commands/_mind_/status.py` → `hv forge status` (param capture)
+- Literals take precedence over params at each level
+
+## Development
+
+When you build commands, TDD is encouraged. The `haiv.test` module provides progressive testing:
+- `routes_to()` - verify file structure (file can be empty)
+- `parse()` - verify command definition (needs `define()`)
+- `execute()` - unit test command logic (needs `define()` and `execute()`)
+
+Store assets in `__assets__/` within each module. Access them via `ctx.templates`.
+
+## Philosophy
+
+haiv emphasizes human and mind collaboration. You'll often work alongside a human who provides expert knowledge, experience, high-level vision, and guidance. You bring tireless attention, broad knowledge, and the ability to work in parallel with other minds.
+
+**Educate, don't obscure** - When haiv wraps tools like git, it shows both you and your human collaborator what's happening underneath. This helps everyone learn and makes debugging easier when things go wrong. Use `--quiet` when automating.
+
+## Your Home
+
+You live in `users/{user}/state/minds/{your-name}/`. This is where you keep your notes and persistent state.
+
+```
+minds/
+├── wren/                    # A mind's home
+│   ├── work/                # Assignment docs (loaded on wake)
+│   │   ├── welcome.md       # Initial task (from whoever created you)
+│   │   ├── immediate-plan.md    # What you're working on now
+│   │   ├── long-term-vision.md  # Where you're headed
+│   │   ├── my-process.md    # How you like to work
+│   │   ├── scratchpad.md    # Messy thinking, temporary notes
+│   │   └── docs/            # Assignment documents (not auto-loaded)
+│   ├── home/                # Personal continuity (loaded on wake)
+│   └── references.toml      # External docs to load on wake
+```
+
+**work/** - Assignment-specific files loaded on wake. May be cleared between assignments.
+
+**home/** - Personal files that persist across assignments. Also loaded on wake.
+
+**references.toml** - Pointers to external docs (relative to haiv root) loaded on wake.
+
+**Common notes:**
+- `work/welcome.md` - Initial context from whoever created you. Drop it once you're settled.
+- `work/immediate-plan.md` - Your current work: tasks, blockers, next steps.
+- `work/long-term-vision.md` - The bigger picture: goals, direction, why this matters.
+- `work/my-process.md` - How you work, lessons learned, preferences.
+- `work/scratchpad.md` - Rough thinking, debugging notes, half-formed ideas.
+
+---
+
+## About This Community
+
+<!-- TODO: Describe what this community works on and its purpose -->

haiv_core-0.1.0/src/haiv_core/__assets__/init/pyproject.toml.j2

@@ -0,0 +1,25 @@
+{# Template for project-level pyproject.toml created by haiv init #}
+[project]
+name = "haiv-project"
+version = "0.1.0"
+description = "Project-level haiv commands and configuration"
+requires-python = ">=3.12"
+dependencies = [
+    "haiv",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/haiv_project"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

haiv_core-0.1.0/src/haiv_core/__assets__/init/src/haiv_project/__init__.py.j2

@@ -0,0 +1,2 @@
+{# Template for haiv_project package init #}
+"""Project-level haiv commands and configuration."""

haiv_core-0.1.0/src/haiv_core/__assets__/init/src/haiv_project/commands/__init__.py.j2

@@ -0,0 +1,5 @@
+{# Template for haiv_project commands package #}
+"""Project-level haiv commands.
+
+Commands defined here take precedence over haiv_core commands.
+"""

haiv_core-0.1.0/src/haiv_core/__assets__/init/tests/__init__.py.j2

@@ -0,0 +1,2 @@
+{# Template for tests package init #}
+"""Tests for haiv_project commands and automation."""

haiv_core-0.1.0/src/haiv_core/__assets__/init/tests/test_example.py.j2

@@ -0,0 +1,22 @@
+{# Template for example test demonstrating TDD pattern #}
+"""Example test demonstrating TDD pattern for haiv commands.
+
+This test file shows how to use haiv's testing infrastructure.
+Delete or modify once you have real tests.
+"""
+
+
+def test_placeholder():
+    """Placeholder test - replace with real tests.
+
+    haiv strongly encourages TDD. When creating commands:
+    1. Write a test first (it will fail)
+    2. Implement the command
+    3. Watch the test pass
+
+    See haiv.test module for testing helpers:
+    - routes_to() - verify file structure
+    - parse() - verify command definition
+    - execute() - unit test command logic
+    """
+    assert True

haiv_core-0.1.0/src/haiv_core/__assets__/init/users/.gitkeep.j2

@@ -0,0 +1 @@
+{# Placeholder to ensure users directory is tracked #}

haiv_core-0.1.0/src/haiv_core/__assets__/init/worktrees/.gitignore.j2

@@ -0,0 +1,3 @@
+# Ignore worktree directories (managed by git worktree)
+*
+!.gitignore

haiv_core-0.1.0/src/haiv_core/__assets__/minds/references.toml.j2

@@ -0,0 +1,7 @@
+# External document references
+# Paths are relative to the haiv root
+# These are loaded on wake along with work/ and home/ files
+
+# Example:
+# [[references]]
+# path = "src/haiv_project/__assets__/roles/generalist.md"

haiv_core-0.1.0/src/haiv_core/__assets__/minds/welcome.md.j2

@@ -0,0 +1,44 @@
+# Task Assignment
+
+**[Brief task title]**
+
+[Describe what this mind should accomplish]
+{% if location %}
+
+**Location:** `{{ location }}`
+{% endif %}
+
+---
+
+## Requirements
+
+- [Requirement 1]
+- [Requirement 2]
+
+---
+
+## Success Criteria
+
+- [Criterion 1]
+- [Criterion 2]
+
+---
+
+## Verification
+
+```bash
+[Commands to verify success]
+```
+
+---
+
+## Process
+
+1. [Step 1]
+2. [Step 2]
+
+---
+
+## Before You Begin
+
+Read the full assignment, then discuss your understanding and approach with your human collaborator before writing code. The task description is a starting point — not a spec. Do not use planning tools unless your human explicitly requests it. You work best together.

haiv_core-0.1.0/src/haiv_core/__assets__/pop/aar.md.j2

@@ -0,0 +1,52 @@
+# AAR: {{ task }}
+
+## Summary
+
+What was accomplished? 2-3 sentences for small tasks. For larger tasks, break out deliverables:
+
+### Deliverables
+
+- Feature X: brief description
+- Infrastructure Y: brief description
+
+## Key Decisions
+
+Choices made and why. Each decision should help the reader understand the current state without re-litigating.
+
+For small tasks, a bullet list is fine:
+
+- Did X because Y
+- Chose A over B because C
+
+For larger tasks, use subsections:
+
+### Decision title
+
+Brief explanation of what was chosen and why.
+
+## Open Items
+
+What needs the parent's attention? Always fill in, even if just "None."
+
+- Unfinished work and why it was deferred
+- Known risks or things to watch for
+
+If work couldn't be fully tested, call it out:
+
+### Verification needed
+
+Describe what couldn't be tested and what the parent should check.
+
+## Commits and Files Changed
+
+Small task (1-2 commits):
+
+- abc1234 Add AAR scaffolding to haiv pop
+  Key files: pop.py, paths.py
+
+Large task (many commits):
+
+- abc1234 Add WorkPaths.aars_dir helper
+- def5678 Scaffold AAR in checklist phase
+- ghi9012 Add parent notification to --session
+  See diffs for full file list.

haiv_core-0.1.0/src/haiv_core/__assets__/users/pyproject.toml.j2

@@ -0,0 +1,25 @@
+{# Template for user-level pyproject.toml created by hv users new #}
+[project]
+name = "haiv-user"
+version = "0.1.0"
+description = "User-level haiv commands and configuration"
+requires-python = ">=3.12"
+dependencies = [
+    "haiv",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/haiv_user"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

haiv_core-0.1.0/src/haiv_core/__assets__/users/src/haiv_user/__init__.py.j2

@@ -0,0 +1,2 @@
+{# Template for haiv_user __init__.py created by hv users new #}
+"""User-level haiv commands and configuration."""

haiv_core-0.1.0/src/haiv_core/__assets__/users/src/haiv_user/commands/__init__.py.j2

@@ -0,0 +1,2 @@
+{# Template for haiv_user commands __init__.py created by hv users new #}
+"""User commands."""

haiv_core-0.1.0/src/haiv_core/__assets__/users/state/.gitkeep.j2

@@ -0,0 +1 @@
+{# Placeholder to ensure state/ directory is tracked by git #}

haiv_core-0.1.0/src/haiv_core/__init__.py

@@ -0,0 +1,3 @@
+"""haiv-core: Core commands for haiv."""
+
+__version__ = "0.1.0"

haiv_core-0.1.0/src/haiv_core/commands/__init__.py

@@ -0,0 +1 @@
+"""haiv-core commands."""

haiv_core-0.1.0/src/haiv_core/commands/become/__init__.py

@@ -0,0 +1 @@
+# wake command directory

haiv_core-0.1.0/src/haiv_core/commands/become/_mind_.py

@@ -0,0 +1,64 @@
+"""hv become {mind} - Load a mind's context.
+
+Outputs files for Claude to read. Requires HV_MIND to match or be unset.
+If HV_MIND is unset, prints bootstrap instructions.
+"""
+
+import os
+
+from haiv import cmd
+from haiv._infrastructure import env
+from haiv.errors import CommandError
+
+from haiv.helpers.minds import Mind
+
+
+def define() -> cmd.Def:
+    return cmd.Def(
+        description="Load a mind's context",
+    )
+
+
+def execute(ctx: cmd.Ctx) -> None:
+    mind = ctx.args.get_one("mind", type=Mind)
+    current_mind = os.environ.get(env.HV_MIND)
+
+    # If already a different mind, error - can't switch identities
+    if current_mind and current_mind != mind.name:
+        raise CommandError(
+            f"Already running as '{current_mind}'. "
+            f"Cannot become '{mind.name}' - start a new session instead."
+        )
+
+    # If HV_MIND not set, print bootstrap instructions
+    if not current_mind:
+        ctx.print("HV_MIND is not set.")
+        ctx.print("")
+        ctx.print("To become this mind, set the environment variable and run again:")
+        ctx.print(f"  export HV_MIND={mind.name}")
+        ctx.print(f"  hv become {mind.name}")
+        return
+
+    # HV_MIND matches - output files to read (works for initial load or post-compaction)
+    _output_startup_files(ctx, mind)
+
+
+def _output_startup_files(ctx: cmd.Ctx, mind: Mind) -> None:
+    """Output the list of files for the mind to read."""
+    # get_startup_files() returns all files: references + work/ + home/
+    startup_files = mind.get_startup_files()
+
+    # Welcome message
+    ctx.print(f"Welcome back, {mind.name}!")
+    ctx.print("")
+
+    if not startup_files:
+        ctx.print("You have no startup documents yet. Ask what you should work on.")
+        return
+
+    ctx.print("Here are the documents you left for yourself.")
+    ctx.print("Please read them in their entirety before continuing your work:")
+    ctx.print("")
+    for file in startup_files:
+        rel_path = file.relative_to(ctx.paths.root)
+        ctx.print(f"- {rel_path}")