ait-vcs 0.1.1__tar.gz

ait_vcs-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sin-chengchen
+
+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.

ait_vcs-0.1.1/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: ait-vcs
+Version: 0.1.1
+Summary: AI-agent-native VCS MVP
+Author: sin-chengchen
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/m24927605/ait
+Project-URL: Repository, https://github.com/m24927605/ait
+Project-URL: Issues, https://github.com/m24927605/ait/issues
+Project-URL: Changelog, https://github.com/m24927605/ait/blob/main/CHANGELOG.md
+Keywords: ai,agents,git,vcs,provenance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ait
+
+`ait` is an AI-agent-native version control layer on top of Git.
+
+The MVP tracks:
+
+- structured intents
+- isolated attempts in Git worktrees
+- daemon-ingested tool events from agent harnesses
+- queryable evidence, file access, and commit linkage
+- verification, promote, discard, and rebase flows
+
+## Status
+
+This repository is at `0.1.0` release-candidate quality for local
+dogfood use. It is local-only: metadata lives in `.ait/` inside one Git
+repository and is intentionally not synchronized across machines.
+
+## Requirements
+
+- Python 3.14+
+- Git
+- SQLite from the Python standard library
+
+## Install For Development
+
+From the repository root:
+
+```bash
+python3.14 -m venv .venv
+.venv/bin/pip install -e .
+.venv/bin/pip install pytest
+```
+
+Verify:
+
+```bash
+.venv/bin/pytest -q
+.venv/bin/ait --help
+```
+
+## Install From GitHub
+
+After `v0.1.0` is published, install the tagged release with `pipx`:
+
+```bash
+pipx install "git+https://github.com/m24927605/ait.git@v0.1.0"
+```
+
+Or install into a virtual environment:
+
+```bash
+python3.14 -m venv .venv
+.venv/bin/pip install "git+https://github.com/m24927605/ait.git@v0.1.0"
+.venv/bin/ait --help
+```
+
+## Install From PyPI
+
+The PyPI distribution name is `ait-vcs` because the shorter `ait` name
+is already owned by another project. The installed command is still
+`ait`.
+
+```bash
+pip install ait-vcs
+ait --help
+```
+
+Or inside a virtual environment:
+
+```bash
+python3.14 -m venv .venv
+.venv/bin/pip install ait-vcs
+.venv/bin/ait --help
+```
+
+## Quickstart
+
+Initialize ait metadata in a Git repository:
+
+```bash
+ait init
+```
+
+Create an intent and attempt:
+
+```bash
+ait intent new "Fix auth expiry" --kind bugfix
+ait attempt new <intent-id> --agent-id cli:human
+```
+
+The attempt command prints:
+
+- `attempt_id`
+- `workspace_ref`
+- `base_ref_oid`
+- `ownership_token`
+
+Make changes in the attempt worktree, then commit through ait:
+
+```bash
+cd <workspace_ref>
+# edit files
+git add <files>
+cd <repo-root>
+ait attempt commit <attempt-id> -m "fix auth expiry"
+```
+
+Promote the attempt:
+
+```bash
+ait attempt promote <attempt-id> --to main
+```
+
+If `main` advanced while the attempt was running:
+
+```bash
+ait attempt rebase <attempt-id> --onto main
+ait attempt promote <attempt-id> --to main
+```
+
+Inspect state:
+
+```bash
+ait attempt show <attempt-id>
+ait intent show <intent-id>
+ait attempt list --verified-status succeeded
+ait query --on attempt 'observed.tool_calls>0'
+ait blame path/to/file.py
+```
+
+## Daemon And Harness
+
+Start the daemon:
+
+```bash
+ait daemon start
+ait daemon status
+```
+
+The harness API streams lifecycle and tool events to the daemon:
+
+```bash
+python examples/harness_demo.py <attempt-id> <ownership-token> .ait/daemon.sock
+```
+
+After the demo:
+
+```bash
+ait attempt show <attempt-id>
+```
+
+Expected counters include tool calls, reads, writes, commands, and file
+evidence under `files.read` and `files.touched`.
+
+## Claude Code Hook Example
+
+`examples/claude_code_hook.py` is a conservative Claude Code hook bridge.
+It creates one ait intent and attempt per Claude session, streams
+`PostToolUse` / `PostToolUseFailure` events through `AitHarness`, sends
+a heartbeat on `Stop`, and finishes the attempt on `SessionEnd`.
+
+Example settings are in:
+
+```text
+examples/claude-code-settings.json
+```
+
+To try it, copy the relevant hook entries into your Claude Code
+`settings.json` for this project. The hook expects `ait` to be importable
+by the Python interpreter used in the command, so run it from an
+installed development environment.
+
+Current limitation: the hook records provenance, but it does not force
+Claude Code to edit inside the ait attempt worktree. The SessionStart
+hook returns the attempt workspace path as additional context. A deeper
+integration can use Claude Code's worktree hook path or a wrapper command
+to make the ait worktree the actual execution directory.
+
+## Release Checks
+
+Before cutting a release:
+
+```bash
+git status --short
+.venv/bin/pytest -q
+```
+
+Clean clone smoke test:
+
+```bash
+tmpdir="$(mktemp -d)"
+git clone https://github.com/m24927605/ait.git "$tmpdir/ait"
+cd "$tmpdir/ait"
+git checkout v0.1.0
+python3.14 -m venv .venv
+.venv/bin/pip install -e . pytest
+.venv/bin/pytest -q
+.venv/bin/ait --help
+```
+
+The release candidate for `0.1.0` should have:
+
+- clean working tree
+- passing tests
+- dogfood notes updated
+- changelog updated
+- version in `pyproject.toml` matching the tag

ait_vcs-0.1.1/README.md

@@ -0,0 +1,208 @@
+# ait
+
+`ait` is an AI-agent-native version control layer on top of Git.
+
+The MVP tracks:
+
+- structured intents
+- isolated attempts in Git worktrees
+- daemon-ingested tool events from agent harnesses
+- queryable evidence, file access, and commit linkage
+- verification, promote, discard, and rebase flows
+
+## Status
+
+This repository is at `0.1.0` release-candidate quality for local
+dogfood use. It is local-only: metadata lives in `.ait/` inside one Git
+repository and is intentionally not synchronized across machines.
+
+## Requirements
+
+- Python 3.14+
+- Git
+- SQLite from the Python standard library
+
+## Install For Development
+
+From the repository root:
+
+```bash
+python3.14 -m venv .venv
+.venv/bin/pip install -e .
+.venv/bin/pip install pytest
+```
+
+Verify:
+
+```bash
+.venv/bin/pytest -q
+.venv/bin/ait --help
+```
+
+## Install From GitHub
+
+After `v0.1.0` is published, install the tagged release with `pipx`:
+
+```bash
+pipx install "git+https://github.com/m24927605/ait.git@v0.1.0"
+```
+
+Or install into a virtual environment:
+
+```bash
+python3.14 -m venv .venv
+.venv/bin/pip install "git+https://github.com/m24927605/ait.git@v0.1.0"
+.venv/bin/ait --help
+```
+
+## Install From PyPI
+
+The PyPI distribution name is `ait-vcs` because the shorter `ait` name
+is already owned by another project. The installed command is still
+`ait`.
+
+```bash
+pip install ait-vcs
+ait --help
+```
+
+Or inside a virtual environment:
+
+```bash
+python3.14 -m venv .venv
+.venv/bin/pip install ait-vcs
+.venv/bin/ait --help
+```
+
+## Quickstart
+
+Initialize ait metadata in a Git repository:
+
+```bash
+ait init
+```
+
+Create an intent and attempt:
+
+```bash
+ait intent new "Fix auth expiry" --kind bugfix
+ait attempt new <intent-id> --agent-id cli:human
+```
+
+The attempt command prints:
+
+- `attempt_id`
+- `workspace_ref`
+- `base_ref_oid`
+- `ownership_token`
+
+Make changes in the attempt worktree, then commit through ait:
+
+```bash
+cd <workspace_ref>
+# edit files
+git add <files>
+cd <repo-root>
+ait attempt commit <attempt-id> -m "fix auth expiry"
+```
+
+Promote the attempt:
+
+```bash
+ait attempt promote <attempt-id> --to main
+```
+
+If `main` advanced while the attempt was running:
+
+```bash
+ait attempt rebase <attempt-id> --onto main
+ait attempt promote <attempt-id> --to main
+```
+
+Inspect state:
+
+```bash
+ait attempt show <attempt-id>
+ait intent show <intent-id>
+ait attempt list --verified-status succeeded
+ait query --on attempt 'observed.tool_calls>0'
+ait blame path/to/file.py
+```
+
+## Daemon And Harness
+
+Start the daemon:
+
+```bash
+ait daemon start
+ait daemon status
+```
+
+The harness API streams lifecycle and tool events to the daemon:
+
+```bash
+python examples/harness_demo.py <attempt-id> <ownership-token> .ait/daemon.sock
+```
+
+After the demo:
+
+```bash
+ait attempt show <attempt-id>
+```
+
+Expected counters include tool calls, reads, writes, commands, and file
+evidence under `files.read` and `files.touched`.
+
+## Claude Code Hook Example
+
+`examples/claude_code_hook.py` is a conservative Claude Code hook bridge.
+It creates one ait intent and attempt per Claude session, streams
+`PostToolUse` / `PostToolUseFailure` events through `AitHarness`, sends
+a heartbeat on `Stop`, and finishes the attempt on `SessionEnd`.
+
+Example settings are in:
+
+```text
+examples/claude-code-settings.json
+```
+
+To try it, copy the relevant hook entries into your Claude Code
+`settings.json` for this project. The hook expects `ait` to be importable
+by the Python interpreter used in the command, so run it from an
+installed development environment.
+
+Current limitation: the hook records provenance, but it does not force
+Claude Code to edit inside the ait attempt worktree. The SessionStart
+hook returns the attempt workspace path as additional context. A deeper
+integration can use Claude Code's worktree hook path or a wrapper command
+to make the ait worktree the actual execution directory.
+
+## Release Checks
+
+Before cutting a release:
+
+```bash
+git status --short
+.venv/bin/pytest -q
+```
+
+Clean clone smoke test:
+
+```bash
+tmpdir="$(mktemp -d)"
+git clone https://github.com/m24927605/ait.git "$tmpdir/ait"
+cd "$tmpdir/ait"
+git checkout v0.1.0
+python3.14 -m venv .venv
+.venv/bin/pip install -e . pytest
+.venv/bin/pytest -q
+.venv/bin/ait --help
+```
+
+The release candidate for `0.1.0` should have:
+
+- clean working tree
+- passing tests
+- dogfood notes updated
+- changelog updated
+- version in `pyproject.toml` matching the tag

ait_vcs-0.1.1/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ait-vcs"
+version = "0.1.1"
+description = "AI-agent-native VCS MVP"
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+authors = [
+  {name = "sin-chengchen"}
+]
+keywords = ["ai", "agents", "git", "vcs", "provenance"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Version Control :: Git",
+]
+
+[project.urls]
+Homepage = "https://github.com/m24927605/ait"
+Repository = "https://github.com/m24927605/ait"
+Issues = "https://github.com/m24927605/ait/issues"
+Changelog = "https://github.com/m24927605/ait/blob/main/CHANGELOG.md"
+
+[project.scripts]
+ait = "ait.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

ait_vcs-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ait_vcs-0.1.1/src/ait/__init__.py

@@ -0,0 +1 @@
+"""AI-agent-native VCS MVP."""