actdim-along 4.9.0__py3-none-any.whl

actdim_along-4.9.0.dist-info/METADATA

@@ -0,0 +1,289 @@
+Metadata-Version: 2.5
+Name: actdim-along
+Version: 4.9.0
+Summary: Provider-agnostic agent-context protocol and skills suite: in-repo memory, entity lifecycle, and LLM-Wiki knowledge base for Claude Code, Codex, OpenCode, and Antigravity.
+Project-URL: Homepage, https://github.com/actdim/along
+Project-URL: Repository, https://github.com/actdim/along
+Author: actdim
+License: MIT License
+        
+        Copyright (c) 2026 actdim
+        
+        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.
+License-File: LICENSE
+Keywords: agents,ai-agent,along,llms,protocol,rules
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.10
+Requires-Dist: ruamel-yaml>=0.18
+Provides-Extra: all
+Requires-Dist: fastapi>=0.110.0; extra == 'all'
+Requires-Dist: pydantic>=2.0.0; extra == 'all'
+Requires-Dist: rich>=13.0.0; extra == 'all'
+Requires-Dist: uvicorn>=0.28.0; extra == 'all'
+Provides-Extra: dash
+Requires-Dist: fastapi>=0.110.0; extra == 'dash'
+Requires-Dist: pydantic>=2.0.0; extra == 'dash'
+Requires-Dist: rich>=13.0.0; extra == 'dash'
+Requires-Dist: uvicorn>=0.28.0; extra == 'dash'
+Description-Content-Type: text/markdown
+
+# ActDim Along (v4.9.0)
+
+[![Tests](https://github.com/actdim/along/actions/workflows/tests.yml/badge.svg)](https://github.com/actdim/along/actions/workflows/tests.yml) - Python 3.10-3.13 on Linux and Windows.
+
+ActDim Along is a provider-agnostic context and memory protocol for AI coding agents (`ALONG-PROTOCOL v4.9.0`) that provides persistent in-repo task tracking, an evergreen architecture wiki, and mechanical quality gates across Claude Code, Google Antigravity, OpenAI Codex, and OpenCode.
+
+---
+
+## Quickstart & Installation
+
+Install Along across all supported AI providers with a single command:
+
+### Windows (PowerShell)
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/actdim/along/main/install.ps1 | iex"
+```
+
+### Linux / macOS (Bash)
+```bash
+curl -fsSL https://raw.githubusercontent.com/actdim/along/main/install.sh | bash
+```
+
+The installer bootstraps the repository into `~/.cache/actdim-along/repo` (via shallow `git clone` or archive fallback) and configures skills across Claude Code, OpenAI Codex, Google Antigravity, and OpenCode.
+
+### Python Package Installation (Core vs. Extras)
+
+Along is distributed on PyPI as `actdim-along`. Install Along Core with minimal dependencies or include modular extras:
+
+```bash
+# Core only: minimal runtime dependency (ruamel.yaml>=0.18; telemetry is built-in stdlib)
+pip install actdim-along
+
+# Web Dashboard: FastAPI, Uvicorn, Pydantic, and Rich
+pip install actdim-along[dash]
+
+# Full suite: install all optional extras
+pip install actdim-along[all]
+```
+
+#### Manual / Local Checkout Installation
+If you prefer to clone the repository manually or are developing Along:
+```powershell
+git clone https://github.com/actdim/along.git
+cd along
+powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1 -Target all # Windows
+bash install.sh --target=all                                               # Linux / macOS
+```
+
+An install records what it wrote in `~/.along/install-manifest.json`: it never deletes a
+directory it does not own, so rules you wrote yourself survive every re-install, and
+`install.ps1 -Uninstall` / `./install.sh --uninstall` removes exactly that record and
+nothing else. See [Setup, Installation & Workflows](./docs/topic--setup-and-workflow.md).
+
+---
+
+## Why Along?
+
+AI coding agents encounter several recurring failure modes across extended sessions:
+- **Context Loss**: Agents forget past architectural choices, re-invent rejected patterns, and drop active tasks across sessions.
+- **Context Bloat**: Ingesting entire files or directories into prompts consumes large token budgets per turn.
+- **Multi-Branch Concurrency**: Parallel agents modify shared documentation, status boards, or lock files, causing git merge conflicts.
+- **Unanchored Modifications**: Without explicit issue anchoring and pre-commit checks, agents can make unintended modifications that bypass test suites.
+- **Toolchain Inconsistencies**: Differing build tools, test frameworks, and command flags can produce verbose context logs or invalid invocations.
+- **Workspace Pollution**: Running parallel or autonomous agents directly in developer working directories can conflict with uncommitted working tree edits.
+- **Prompt Instruction Decay**: Natural language guidelines in static prompts can lose effectiveness as context length grows.
+
+Along addresses these challenges through a dual-tier structure: an evergreen architecture wiki (`docs/`) for system design consensus, and a machine-readable governance layer (`.along/`) for task tracking, decision records, and session history. Agents track issues in a dependency graph, search project knowledge via bounded snippet retrieval, and verify changes through declarative quality gates.
+
+---
+
+## Core Value Proposition
+
+| Pillar | How Along Delivers It |
+| :--- | :--- |
+| **Zero-Vector In-Repo Intelligence** | Fast TF-IDF multi-scope retrieval engine (`along-kb-search`) unifying docs, ADR constraints, active issues, and session logs into word-boundary aligned snippets (<= 150 words), avoiding full-file context ingestion and significantly reducing exploration prompt tokens without external vector DBs or daemon processes (see [benchmarks](scripts/bench_kb_search.py)). |
+| **Dual-Tier Memory Architecture** | Clean architectural separation: Evergreen LLM-Wiki (`docs/`) with AST code symbol grounding and SHA-256 drift detection vs. Living Transactional Governance (`.along/`) with DAG issues, immutable session history, and atomic projections. |
+| **Persistent In-Repo Memory** | Durable, git-tracked memory (`.along/`): DAG issues (spikes and `risk`-tagged blockers included), append-only ADR logs, milestones, and session records that travel with the codebase. |
+| **Autonomous Multi-Agent Teams** | Sequential living-plan state machine (`along-team`): Supervisor -> Scout -> Architect -> Implementer -> Reviewer with session blackboards, retry limits, and single-agent degradation. |
+| **Runtime Worktree Workspace Isolation** | Ephemeral Git worktree isolation (`along worktree`, `/along-team --worktree`) satisfying the 3-part Environment Readiness Contract: NTFS junctions / symlinks for dependencies (`node_modules`, `.venv`), `.env` configuration copying, real-time session blackboard sharing, and Windows file lock resilient teardown. |
+| **Runtime Mechanical Prose Enforcement** | Active agent lifecycle interception (`PreToolUse`, `Stop`) turning markdown guidelines into hard runtime errors across Claude Code, Antigravity, and Codex, with machine-checked bi-directional traceability (`along hook verify`). |
+| **Token-Efficient LLM-Wiki (`docs/`)** | Modular knowledge base with in-place source provenance, SHA-256 drift detection, deterministic `llms.txt` compilation, and targeted snippet search (`along-kb-search`) avoiding full-file context ingestion. |
+| **Stack-Agnostic Lifecycle & Polyglot Hooks** | Unified agent execution contract (`/along-build`, `/along-test`, `/along-dev`, `/along-version-bump`, `/along-dep-scan`) with zero-config stack auto-detection and polyglot repository hooks (`.along/scripts/` in Python, Bash, PowerShell, Batch). |
+| **Zero-Conflict Git Concurrency** | Single Source of Truth (SSOT) atomic files vs compiled projections (`ISSUES.md`, `INDEX.md`), union merges (`merge=union`), and decentralized date-slug ADRs that avoid collisions in parallel branches. |
+| **Engineering Provenance & Dual-Track UI** | Living plans, fix loops, and verification gates are permanently recorded in session logs while projecting interactive visual review cards in IDEs (Antigravity). |
+| **Strict Data Safety & Verification Gates** | Hermetic engines (`alongkit`) with transactional byte-exact rollbacks, strict front-matter preservation (`ruamel.yaml`), and zero-unintended-deletions invariant. |
+| **Declarative Runtime Gates & Traceability** | Mechanical agent lifecycle interception (`PreToolUse`, `Stop`) enforcing declarative runtime gates in `default_gates.yaml` (32 protocol invariants enforced across runtime hooks, git hooks, and CI), backed by machine-checked bi-directional traceability (`along hook verify`). In runtimes with Along hooks installed, violations trigger immediate tool-level interception; git and CI gates provide universal baseline enforcement everywhere. |
+| **Nearest Context Boundary** | Monorepos, microservices, and Git submodules maintain isolated localized memory, preventing root workspace pollution. |
+
+---
+
+### Dual-Tier Memory Architecture: Evergreen Wiki vs. Living Governance
+
+Along divides repository intelligence into two specialized, complementary tiers to keep agent context scalable and predictable:
+
+```mermaid
+flowchart TD
+    subgraph Tier1["Tier 1: Evergreen Architecture Wiki (docs/)"]
+        WIKI["Curated Knowledge Base (docs/topic--*.md)"]
+        AST["AST Code Symbol Grounding (zero ghost symbols)"]
+        PROV["Source Provenance (SHA-256 drift gate)"]
+        LLMS["Deterministic llms.txt & llms-full.txt"]
+    end
+
+    subgraph Tier2["Tier 2: Living Governance Memory (.along/)"]
+        ISSUES["Machine-Parseable DAG Issues (open -> done)"]
+        ADRS["Decentralized ADRs & CONSTRAINTS.md"]
+        SESSIONS["Immutable Session Logs & Engineering Provenance"]
+        PROJ["Auto-Compiled Projections (ISSUES.md)"]
+    end
+
+    subgraph Retrieval["Zero-Vector In-Repo Retrieval Engine (along kb-search)"]
+        SEARCH["Fast TF-IDF Multi-Scope Search"]
+        SNIPPETS["Targeted Bounded Snippets (<= 150 Words)"]
+        SAVINGS["Bounded Snippets (<= 150 Words) vs Full-File Ingestion"]
+    end
+
+    WIKI --- SEARCH
+    ISSUES --- SEARCH
+    ADRS --- SEARCH
+    SESSIONS --- SEARCH
+    SEARCH --> SNIPPETS --> SAVINGS
+```
+
+- **Tier 1: Evergreen Architecture Wiki (`docs/`)**:
+  - **Purpose**: Curated, cumulative knowledge base representing the current factual state of system design.
+  - **Mechanisms**: In-place source provenance (`sources: [{path, hash}]`), AST code symbol verification to prevent hallucinated interfaces, and deterministic compilation into `docs/INDEX.md` and `llms.txt`.
+  - **Lifecycle**: Evolves with the codebase. Never transactional; updated only when public contracts, workflows, or architecture change.
+- **Tier 2: Living Governance Memory (`.along/`)**:
+  - **Purpose**: Transactional project memory, active task execution state, and historical audit trails.
+  - **Mechanisms**: Machine-parseable DAG issues with lifecycle states, modular ADRs (`ADR-YYYY-MM-DD--<slug>.md`), compiled constraints projection (`CONSTRAINTS.md`), and append-only session history.
+  - **Lifecycle**: Transactional and stateful. Closed issues and session logs are permanent and immutable.
+- **Unified Retrieval Engine (`along kb-search`)**:
+  - Unifies both tiers in a single fast local query without vector embeddings, cloud dependencies, or background daemon processes.
+  - Returns word-boundary aligned snippets (< 150 tokens) directly to agent prompts, avoiding full-file context ingestion (measured in [scripts/bench_kb_search.py](scripts/bench_kb_search.py)).
+
+### Along Core vs. Modular Extras Architecture
+
+Along enforces a strict minimal-core architecture:
+- **Along Core (`actdim-along`)**: In-repo memory (`.along/`), entity lifecycle (`ISSUES/`, `DECISIONS/`, `MILESTONES/`), projections (`ISSUES.md`, `CONSTRAINTS.md`, `docs/INDEX.md`), bounded snippet retrieval (`along kb-search`), standard lifecycle contracts (`build`, `test`, `dev`, `commit`, `wrap`), mechanical safety gates, and stdlib telemetry (tracer, redactor, spool, OTLP/HTTP JSON exporter). Core runtime dependencies remain strictly minimal (`ruamel.yaml>=0.18`).
+- **Modular Extras**:
+  - `actdim-along[dash]`: Web dashboard UI, Cytoscape DAG visualization, and OpenAPI analytics server.
+  - `actdim-along[all]`: Stable alias for optional extras (`[dash]`).
+  - Optional protocol modules (`along-team`, git worktree sandboxing, `code-review-graph` AST tools, `along-dep-scan`) operate on-demand with zero extra package dependencies.
+- **Protocol Versioning**: Protocol specification version (`ALONG-PROTOCOL vX.Y.Z`) changes strictly on format or schema updates. Tooling enhancements release as minors; breaking format changes are batched into rare majors with migration automation (`along migrate`).
+
+---
+
+## Using Along in Your Projects? (Drop-In Blurb)
+
+Add this badge and blurb to the `README.md` of any repository powered by Along:
+
+````markdown
+### AI Development: Powered by [ActDim Along](https://github.com/actdim/along)
+
+This repository follows the **ActDim Along Protocol** for AI agent context, persistent memory, and autonomous workflows:
+- **Dual-Tier Memory**: Evergreen LLM-Wiki in `docs/` and living governance memory in `.along/` survive across all AI sessions.
+- **Zero-Vector Unified Retrieval**: Fast local snippet search across architecture, decisions, and issues returning bounded snippets (< 150 tokens) without full-file ingestion or external database dependencies.
+- **Runtime Worktree Isolation**: Autonomous agent tasks execute in isolated Git worktrees with automatic dependency linking, preserving clean developer checkouts.
+- **Mechanical Quality Gates**: Protocol rules, clean typography, and issue bindings are mechanically enforced before tools execute in runtimes that load Along's hooks (Claude Code, Antigravity, Codex); elsewhere they are advisory. The portable baseline for every committer is the CI job `along gates check --ci` plus opt-in git hooks (`along hooks install --git`).
+- **Standardized Lifecycle Contract**: Unified commands for build, test, dev, release, and dependency discovery via pluggable `.along/scripts/` hooks.
+- **Provider-Agnostic**: Compatible out of the box with **Claude Code**, **Google Antigravity**, **OpenAI Codex**, and **OpenCode**.
+````
+
+---
+
+## Knowledge Base & Architecture Index
+
+The repository's complete technical specification is maintained as a living LLM-Wiki in [`docs/`](./docs/INDEX.md):
+
+| Topic | Description | Link |
+| :--- | :--- | :--- |
+| **System Architecture** | Provider flow, context boundaries, code intelligence, and bridge layers. | [System Architecture & Flow](./docs/topic--architecture.md) |
+| **CLI Command Reference** | Unified console command dictionary, subcommands, flags, and exit codes. | [Along CLI Command Reference](./docs/topic--cli-reference.md) |
+| **Domain Model & Entities** | Machine-parseable schemas for Issues, ADRs, Milestones, and Sessions. | [Domain Model & Entity Ecosystem](./docs/topic--domain-model.md) |
+| **Setup & Workflows** | Installation matrix, repository onboarding, and session lifecycle. | [Setup, Installation & Workflows](./docs/topic--setup-and-workflow.md) |
+| **LLM-Wiki Architecture** | Andrej Karpathy paradigm, source isolation, and token efficiency. | [LLM-Wiki Architecture & Paradigm](./docs/topic--llm-wiki-architecture.md) |
+| **Runtime Hooks & Gates** | Agent lifecycle interception harness across Antigravity, Claude, and Codex, plus the runtime capability matrix: where gates are mechanical and where (Claude Cowork, Cursor, OpenCode) they are advisory. | [Runtime Lifecycle Hooks & Mechanical Gates](./docs/topic--runtime-hooks-and-gates.md) |
+| **Declarative Gates & Traceability** | Extensible YAML gate engine and bi-directional machine-checked matrix. | [Declarative Gate Engine & Traceability Matrix](./docs/topic--declarative-gates-and-traceability.md) |
+
+## Automation Skills Reference (Grouped by Workflow Phase)
+
+Along provides **21 singular automation skills** structured across 6 core lifecycle phases:
+
+### 1. Bootstrap & Repository Protocol Management
+| Skill / Command | Purpose |
+| :--- | :--- |
+| **`along-init`** (`/along-init`) | Scaffold/refresh `AGENTS.md` + `CLAUDE.md` + `.along/` in a folder via the deterministic `along init` engine; a root `VISION.md` moves into `.along/`. |
+| **`along-update`** (`/along-update`) | One-liner update of repository context, protocol, and global skills from GitHub. |
+| **`along-version-bump`** (`/along-version-bump`) | Multi-stack version bump and release orchestrator (Node, Python, Rust, .NET). |
+
+### 2. Orchestration, Planning & Multi-Agent Teams
+| Skill / Command | Purpose |
+| :--- | :--- |
+| **`along-team`** (`/along-team`) | Sequential multi-agent autonomous development engine and living plan. |
+| **`along start`** | Atomically claim issue, initialize session blackboard, and provision worktree. |
+| **`along issue`** | Create, update (fuzzy milestones, priority), show, and close issues. |
+| **`along milestone`** | Synchronize bidirectional target issues, calculate progress %, and show status. |
+| **`along-issue-sync`** (`/along-issue-sync`) | Reconcile active issue board projection (`ISSUES.md`) with atomic issue files. |
+| **`along-decision-sync`** (`/along-decision-sync`) | Record ADRs into append-only `.along/DECISIONS.md` and compile active `.along/CONSTRAINTS.md`. |
+
+### 3. Development & Lifecycle Execution Runners
+| Skill / Command | Purpose |
+| :--- | :--- |
+| **`along-build`** (`/along-build`) | Project build lifecycle hook via `.along/scripts/build.py` or auto-detected runner. |
+| **`along-test`** (`/along-test`) | Automated test suite with quiet flags via `.along/scripts/test.py` or runner. |
+| **`along-dev`** (`/along-dev`) | Local development/debugging server via `.along/scripts/dev.py` or runner. |
+
+### 4. Quality Gates, Code Graph & Commit Integrity
+| Skill / Command | Purpose |
+| :--- | :--- |
+| **`along-commit`** (`/along-commit`) | Smart ASCII-clean Conventional Committer linked to active `.along/` issue. |
+| **`along hook verify`** (`along hook`) | Verify bi-directional traceability between prose badges and YAML gates, and print which layer (runtime, git, ci) enforces each gate. |
+| **`along gates check`** | Commit-time gates outside agent runtimes: `--hook pre-commit` / `--hook commit-msg` (opt-in via `along hooks install --git`) or `--ci` over a commit range. |
+| **`along git setup`** | Register merge drivers for projections and entity front-matter (`along git sync` after a merge). |
+| **`along-graph-check`** (`/along-graph-check`) | Preflight health check and verification for `code-review-graph` AST engine. |
+| **`along-graph-sync`** (`/along-graph-sync`) | Build or incrementally update `code-review-graph` AST code intelligence database. |
+| **`along-graph-impact`** (`/along-graph-impact`) | Determine blast radius, affected flows, and candidate tests for changed symbols or files. |
+| **`along-graph-arch`** (`/along-graph-arch`) | Architectural overview, community structure, coupling hotspots, and bridge nodes. |
+| **`along-dep-scan`** (`/along-dep-scan`) | Scan declared dependencies for AI instructions into `docs/topic--dependencies.md`. |
+| **`along context-budget`** (`along budget`) | Context budget measurement and regression gate (`--check`, `--json`). |
+
+### 5. Knowledge Base & LLM-Wiki Intelligence
+| Skill / Command | Purpose |
+| :--- | :--- |
+| **`along-kb-sync`** (`/along-kb-sync`) | Idempotent LLM-Wiki Knowledge Base compiler, AST symbol grounding, and link integrity gate in `docs/`. |
+| **`along-kb-search`** (`/along-kb-search`) | Zero-vector local multi-scope snippet search across `docs/`, ADRs, issues, and session logs (< 150 tokens/match). |
+
+### 6. Visual Analytics, History & Diagnostics
+| Skill / Command | Purpose |
+| :--- | :--- |
+| **`along-dash`** (`/along-dash`) | Launch executive dashboard (Web UI, CLI, Cytoscape DAG, HTML export). |
+| **`along-history-sync`** (`/along-history-sync`) | Reconstruct `.along/` milestones, issues, and sessions from Git commits. |
+| **`along-feedback`** (`/along-feedback`) | System self-diagnostics, incident logging, and feedback dispatch. |
+| **`along-wrap`** (`/along-wrap`) | Unified end-of-stage wrap: verification checklist, session log, issues, history. |
+
+---
+
+## License
+
+MIT License. See [LICENSE](./LICENSE) for details.

actdim_along-4.9.0.dist-info/RECORD

@@ -0,0 +1,152 @@
+alongkit/__init__.py,sha256=eEMY9PN4JdEc2fP0DaBDAxsmrqc3T2a-2ODwtQQOfys,3422
+alongkit/__main__.py,sha256=C2WZzpkIdCmN_RqxEkxbTE-N5IKpArjzWcwor6lRxxo,318
+alongkit/attribution.py,sha256=facfYsz6ccFM0vPCDtp4ihG4JZ8td-xBScfTsiK8Vx4,5023
+alongkit/bootstrap.py,sha256=aqhfqvJEov8G1xgW9edJG2pYHkZpJSm_cWIF-cBeEzA,12423
+alongkit/budget.py,sha256=AyviJdUEa6IyT2nEcyjgL_tm7xL7lKeVi5-6DDtyHJM,21324
+alongkit/bypass.py,sha256=a9_5lhVpQJL1icO9c2iZ7VfiGRRETZXFP5XD8oA-pDA,6423
+alongkit/cli.py,sha256=pA6_9kAoNoaWUt4Tl5LPfXZ5brYHGMoUK1bRUON9YX0,2903
+alongkit/cliargs.py,sha256=jfK7FshO_f_50d4Sk2HBMvAOZKndEBx8PJ4cLE5iVVs,1830
+alongkit/closeout.py,sha256=m3oFht6sZTZi5KWWzW08mBF9YLewKdH38FDZT4NF7Kg,42460
+alongkit/conflict_check.py,sha256=FMTKLq4czbj48W4H-rQr8_cbFfaQ4-9Yz7pRAjmkmqw,8410
+alongkit/daemon.py,sha256=GX5kb7hJEzNqCIgeYjOW3sAW-onKZw3rOhg7LbOqNL4,48034
+alongkit/devenv.py,sha256=9QWrKFXpGaA_eqPcjpRpnZwbjQdF_HE8XfohV2HT-p4,4187
+alongkit/diagnostics.py,sha256=1CYuzz4aLs0V4jv9k9qvrXnJiYAG_tB9xF4zV8udwQY,16111
+alongkit/distill.py,sha256=jlpFF6mlsHKuPAPz2hjBSU9zAvXFSkz9CpY8Eb06dC8,9185
+alongkit/drafts.py,sha256=Aw_sFyrsBC8EDGOFeorO_ENMhw9z_ajFO3vawje-qR0,4157
+alongkit/environment.py,sha256=kp0Tvua-onxC5pV8CYYnA_Dthv5DCnIWzKcSQkb6zck,22433
+alongkit/exceptions.py,sha256=ce3Rhu6EMySjZtf9EWtYgR6f32dL_pE8dYdg8jjqDkg,1295
+alongkit/feedback_github.py,sha256=5KQPXmvdcZmXuauRbQdEnvGrMH5SSYKykY0b752SVnc,17261
+alongkit/frontmatter.py,sha256=ceRz2WN7mpAnscv8UId8tJvWRRTQzhKTTqsRl4aBqlM,15209
+alongkit/gates.py,sha256=TM9HA2_XF6CRq9oDW3KHs0u729U3ezaVAV9Of1xSWCs,32091
+alongkit/gatestats.py,sha256=2Qxuuhgy0kYnapv73BcmI8S78ZSCi7fclLibeR0nrgE,5884
+alongkit/gitgates.py,sha256=-YNjv9M2wd1XCmtgRq4obmucTP_hyZz8v7NCfUPFFBU,44708
+alongkit/handoff.py,sha256=_jhJTDcdTGfJYgZJEn5RMD2yZCef9viVzHf2HIxCWqA,35498
+alongkit/hookpreflight.py,sha256=Gq2jy0bhgAWpPn79sYi3Q0VSe3PR6adlqU3mj9Gvqo0,5044
+alongkit/install.py,sha256=2dRSDXqweiICiQ0n5stFTFCz7NXqauzVipZByyxp9vY,32032
+alongkit/kb.py,sha256=0oaOkIT9rFvNvr9ZZrLURmfz2-ixMqy0EO88YNEmlC0,29300
+alongkit/lifecycle.py,sha256=jIr-zTFEgHx5YibIYmaQTs6dzSdX9uPq3SgasoZHsrY,69499
+alongkit/markdown.py,sha256=dbtRoAcHpBSZDUo9wSCaoNRFFIQbGNngwEllOf5hpXQ,13033
+alongkit/merge.py,sha256=wxKsAlksSJHPh_-JRQvlACX85klLlrXgnRzrdkB4Nn4,29441
+alongkit/migration.py,sha256=Cb9T3lNldHG1uyLAEm-Tb5W5uhQqawyivRxMGk2K3aA,20978
+alongkit/orchestration_profiles.py,sha256=Dzf9wrD5VUHQs9WAd2NlJ3O9VeQ7U9aXhsRRYDDL0dM,12552
+alongkit/orchestrator.py,sha256=-m__O_-OoRs5EIb5Hh24QwQGZg64WBZJzkvUiDxatYE,36604
+alongkit/patcher.py,sha256=ytFQzsudNGWgeWGrUlqp96ZjACGbZxXD8uaIryA90ZQ,7238
+alongkit/planscope.py,sha256=oQfSn9N6UMKhAVHHHi-oQtYCzRI9wJ-4VZxtDah0j9k,3372
+alongkit/proc.py,sha256=AjyeeXdJhw2yCb_YJRQR-pn2UUPSVVfLo1oUeSuNFOE,13487
+alongkit/profiles.py,sha256=FzAIhmcCQUJcr0TFxbFNEiFN0WuJuBuExThWEGbC8JU,6475
+alongkit/repo.py,sha256=qV03s3glLqPb2INmvzJ4iWLZO2MOEL7O_DGQdX_wUMk,32153
+alongkit/repochecks.py,sha256=H-nG2EiLB0-se_Qqf0wIkBHJseGsKG1F66-218Bud1U,20262
+alongkit/resolve.py,sha256=Lts1RPX9SYi1-OO8q_mfcNu_igQ5u_-FQ8dirS08H9Q,23216
+alongkit/resolve_code.py,sha256=7ZvuWu0NYhAkISBrCGg4J4uDRWhxnWTIejrWvDB8YNM,16942
+alongkit/rules.py,sha256=3BNXSVGpLNnhIAy1Y3YVEKV1pfi4Bv12AYv_CpuyL0k,18918
+alongkit/runtime.py,sha256=RtWUkadjUxDu4gGoaKWaah8waqCC6x5RRaB3Tk7UbjU,15294
+alongkit/sanitizer.py,sha256=NafMaWH0IqiOLztMOYBvd7GZOQLR0F8QZWOXeVoM0i4,14614
+alongkit/scaffold.py,sha256=olEULjHsl0ExTrmWe8f88wgifuM2GD5JZ1ZjUWPLzj0,21352
+alongkit/semver.py,sha256=j8_CXRmrg4OXyYtXO5eiiPTBuTZgRPDXFjwRjBYsTyY,2816
+alongkit/session.py,sha256=k2-aOYSevGRkUbk-UoPl_z4fEVF-V4s23ZCCZZYzKtA,94833
+alongkit/telegram.py,sha256=FBd9Lif0BvPcRngWmf6So3eIT4rpj44CTI5qA3yTEEA,10497
+alongkit/testruns.py,sha256=duCDXEEg9H5wvfNqlsJcwcugxGejedl-9gOMWZJ9SuM,8138
+alongkit/textio.py,sha256=stRkhjwbodexndTV-d2KM4cRm0T-XPnYdTrFPqWz698,5813
+alongkit/transaction.py,sha256=8kYusFzIJzc6O3TCCRCPYcNPCRyeY49k_1N5ScfVcyU,6518
+alongkit/typography.py,sha256=qBYsa3bp_llp1HjGc0IWx6W-P04Dv9Y7EvRNQf9R4XA,5652
+alongkit/verify.py,sha256=XN-tGZD72o_AEy-7eC0f-4wYwt3Bpi4pnldUcE1OWYY,19270
+alongkit/version.py,sha256=gQ4-20nsHQKE_1fWAXPvO_mZYum5STTNFdmet8gW3FM,1430
+alongkit/worktree.py,sha256=5eGQS79Exyzvq2q_LNqZx8iUMDqibrXpMeC3jd5VrUA,27752
+alongkit/commands/__init__.py,sha256=nV1UAxBE-zA_-t-qTEhXyszhEW8NHk9nDt7xs-sBOMU,2061
+alongkit/commands/brief.py,sha256=T79vJ9VeFQ3iaFIxdlJ100VvpSUKVHWhSSLTAXSSeuI,2846
+alongkit/commands/common.py,sha256=H8h5YlwwyBUPmFXDykqq6hCqX5apo3pccjIGM5HNnvc,1238
+alongkit/commands/daemon.py,sha256=ecj7ahMyufIvh01UGU9YX8fCV9EIXjRLRVebUFU7ti0,5218
+alongkit/commands/decision.py,sha256=TkRZFGNr7qn8YPDI-o2l414A4EM6EMytee6tpbaZDhw,6633
+alongkit/commands/doctor.py,sha256=6samlFWSpOhytzRitG7Ew1rwUkkYAoVxX4v963WvbBE,33960
+alongkit/commands/env.py,sha256=2NPbkR-LAns8GGygDvxbeRURjATtU9ogGFCFHNW8BKo,9753
+alongkit/commands/gates.py,sha256=ZtYU1PBiH7MhoVH0Xch07ewtTFnCQcqgzMkqWOJHaPU,17539
+alongkit/commands/issue.py,sha256=RHdAlrHFKZRMOQcJtDkn5qA4K_5F8wELMjFWhLZ_pKU,42136
+alongkit/commands/lifecycle.py,sha256=l_7BIutI3BNet1pVgrTFiOiltK-OMIvXVyrs2sT0zss,38594
+alongkit/commands/milestone.py,sha256=GhUMRPbqRVed9ae4OcqX5zZOvv85H7DsyRNi4kemuJA,9390
+alongkit/commands/ops.py,sha256=iMjznK_6FSRFeKUkoOS9yaAjrumuHqZMr_GvIS7EYtU,15913
+alongkit/commands/orchestrator.py,sha256=PNdZ9cMzuBHsayapLAZlRTblqApfw4cMLUH1tG76vxo,7118
+alongkit/commands/scratch.py,sha256=_rmT_2WnJQDRZs0kILjVcCet_KWZDJKs2jqH-KjoREo,16496
+alongkit/commands/session.py,sha256=_V9lrvCokj2Fnuyh8LpTidGhaE2OT35tyJaWSXZrqyc,17073
+alongkit/commands/telemetry.py,sha256=yoWyKbgMW9kifFnozI9Y5fewVoVSRYCMZuEps9aOvDQ,7174
+alongkit/commands/worktree.py,sha256=Az85DzWJHrDxa9nBJyh5x15ANgLeoiSfQlzz5mq-9w8,8911
+alongkit/entities/__init__.py,sha256=znrj05whxx9mW_etVefG-hi8RRRC33nXg33Rqz5Fqk8,5130
+alongkit/entities/decisions.py,sha256=gQ5-PJPR5hW_KrIoYmgCq0oDuuvOtuVg9snPf3-Tv-A,20478
+alongkit/entities/mutation.py,sha256=YokoH-JZ19dHlANDDGct6ykywPwWQN7fVPrtF8fKP04,18442
+alongkit/entities/projections.py,sha256=naEN4_CLryKAJe0F2211QyKL5vImMdwlh8cmlKWSKOo,8998
+alongkit/entities/query.py,sha256=b2J3a9x0UceO9uM_eFvyDVYnGWz8YF9ZfQNEeiDIHFY,21766
+alongkit/entities/stubs.py,sha256=GUOoq9_31fKwYMh8bueIwVxOS4yD2xJ9MIPGNg8Dx4U,8500
+alongkit/entities/validation.py,sha256=FjYAAO3Zfvi9W6NUztTPWivJp2610aHIe1y6PKPebv0,19215
+alongkit/entities/vocabulary.py,sha256=EuLFcXylXWqLjdlrRP6MLzxpFN4GLR6IhrgWnnUhVdE,8439
+alongkit/hooks/__init__.py,sha256=SatC_wc9MY550vdJMQTSiQnK2WWvyOq0TDKvHDgXLpU,1293
+alongkit/hooks/config.py,sha256=ig72zb_mdSn5fMXjhcODY5L3hCcG_xiCiN8-aIhHc4Y,43593
+alongkit/hooks/containment.py,sha256=pl7GjfpqDGjXJSbBOTXv24qt8K1YodbvwOhJNEHElVk,13274
+alongkit/hooks/declarative.py,sha256=bpAgXcdyyntuYWcby_s5PrxsK5tz0TPJRTvLJHszKn8,15423
+alongkit/hooks/default_gates.yaml,sha256=m5O-hVaROH_fugWY3FGAN93GQ_a6f3LWznIcyLHzhlI,22055
+alongkit/hooks/deletion.py,sha256=R10Y-Z4G94lSTJSzZpyDSPKM5k1C_Ra-qpNGi6fRf2M,9561
+alongkit/hooks/engine.py,sha256=P2IGYpn3WkcI7Vt44GO5wT9SbHwrnTBR9aNwTQF8gk0,6891
+alongkit/hooks/escalation.py,sha256=vyMhjvl5kHyuucc574GfA6_UMKAT6UcOhH6MowTqP_c,14311
+alongkit/hooks/gates.py,sha256=BCi7JY_t1rmsUlQPPpSBlKJXuJK5B-Y8usdu2wQE748,6886
+alongkit/hooks/models.py,sha256=bxED7gdF5jgJwwfF0WUJ0ijJGSCNGPSWNktwFeTqm5w,2362
+alongkit/hooks/opencode_plugin.js,sha256=yVRgCDd_ecnNnO2FZwWnQDR7bMawDkfiIlYoIoly8Vo,10412
+alongkit/hooks/predicates.py,sha256=g7SZ875zAWIICSd7yly3yERY6W9n0S63orLIi8N4mYQ,123585
+alongkit/hooks/shellparse.py,sha256=aoknglha8_KwX-5LwBGupB9LIWSa9AbQLHbQodAFYpY,5120
+alongkit/hooks/shellwrite.py,sha256=fc9INx5nmngQMSbsgnN3L9OBtjzNI2otLpYtOxLdFr0,9540
+alongkit/hooks/traceability.py,sha256=4PksVADZ3slPNwzNxC6g-vwsAuiVQ751VFMjeNbfs4w,8649
+alongkit/hooks/turnstate.py,sha256=zaAn37UbF5w7LR-qbwUGosGEHABawjSm8aWzy2mnWoQ,2471
+alongkit/hooks/adapters/__init__.py,sha256=LqHLDJ_z6-_0ohDYfqUtmkty-8rPX05lSQQk1LaRXmQ,1219
+alongkit/hooks/adapters/antigravity.py,sha256=WFP8UoFZEKThk7ZOXx1tAVb1naIXJ7slUgm3qBrNP98,5361
+alongkit/hooks/adapters/base.py,sha256=GlVkz3q7mbVJNUhXQc4k5mM2wmMjdoOMwwtN3WOqRuA,791
+alongkit/hooks/adapters/claude.py,sha256=iN4V2YW9lFK-Vd90w7pUkbnBx6036F-evVjCPaQcNaY,8385
+alongkit/hooks/adapters/codex.py,sha256=MmSVEdjVY-u0nNi891MW1dtMOOXpmR_B06a2NxaaNok,7243
+alongkit/hooks/adapters/generic.py,sha256=phxTxFIHdhys2GiMJ22VCJl_ACOjCF2Ho9WEI125S9I,9758
+alongkit/hooks/adapters/normalize.py,sha256=Tgx3XTOx1vPfiJAb_0e9Pz-0YH4C_hsjnR_2x4TiWY0,3633
+alongkit/hooks/adapters/opencode.py,sha256=p4eVZXhs6hiHhM3I3JLxkOWwf-3z2dnFIJBjUSuRxUw,516
+alongkit/runner/__init__.py,sha256=yTB7xbxvDoXjngkdPi7lRwr4hLSH0WZ1nMmIc1tj6FQ,1508
+alongkit/runner/antigravity.py,sha256=4xVP8giyJPtUDaBZvsj31moiJ3gyt8aV-66MkLKvhSQ,6927
+alongkit/runner/base.py,sha256=5xOaS567IVE6HtospLFNH0oVKIDqw7OW5gkw9Sd8bFg,17949
+alongkit/runner/claude.py,sha256=ZtQRe1dMxo6maHcwd6G69lYEgvRvLKnzW5PiqaWJJmU,4504
+alongkit/runner/codex.py,sha256=xiVuRhFZSA-yCC9kXTOKVAr7CqejaAGzdTKKKqSJ3fI,5212
+alongkit/runner/generic.py,sha256=AFReTEogWJTfHUWk3jTZJ57POYDXDb9zCwy43cHsnNE,3119
+alongkit/runner/opencode.py,sha256=fF-0-HkiNXdvFQvOePX8T8KKMDvwpz7c43Idre-ZTw4,6738
+alongkit/runner/stream.py,sha256=SrbmZBHOGzgDWYpkdXmtyoJwjT38ca3egltdseXy0zc,7529
+alongkit/telemetry/__init__.py,sha256=UtdoDoru1M3ZI3-vXFer04UZ_5m7o-e8n2xlIUUhDIw,865
+alongkit/telemetry/conventions.py,sha256=kKHg4LuqGJQ_ELqRCBIBVQH-2n9SMjNvkujlSTLA68o,3995
+alongkit/telemetry/models.py,sha256=mpp7oe1P4TVnOlreip3ICjyu1K0aYuxYVn1zlJ1FLjA,4795
+alongkit/telemetry/offloader.py,sha256=0xCf85u3Uw91lBCuDvAnrKn9TJDc7N2zFaSho-QpDq8,3791
+alongkit/telemetry/otlp.py,sha256=J70PbcmCBG11WnxvxOQc0i7pphoKv2D83GR7nPek8NU,16748
+alongkit/telemetry/redactor.py,sha256=Eb_BCr_vtFKck8INMFL1WVqKxgvOR2IgFZ5OKFx4VYk,6767
+alongkit/telemetry/spool.py,sha256=jrL8yLCRvWtc7i_PAkFojHL9dltos1GTw69Hoj11ooE,2545
+alongkit/telemetry/tracer.py,sha256=1pSMmtVUOjZdT4QjTO5_XQLhc_zwwVH-epmnmsej4Vc,15757
+alongkit/engines/along_brief.py,sha256=1U4guElWnLGaVGfSyGRxpOnStPeCjtle0p4ym4dO-I0,864
+alongkit/engines/along_commit.py,sha256=jNFN6tZXrwKq68xofoHxsspZ5M434dBbz6xPG-v9M4I,15189
+alongkit/engines/along_conflict_check.py,sha256=bUUmh40sOHraQ7aY-Y2DvyjLVj_n1p6ytMw1NFoeJz8,1607
+alongkit/engines/along_daemon.py,sha256=rlu3-KCWd9dfREnTU4Wkgi_xA4jy-0dn1SDBkJbDIvA,710
+alongkit/engines/along_dash.py,sha256=U21HWWcqQS4XvIv0g41mI58xErNzVJoDRFSsn04Lels,2124
+alongkit/engines/along_dep_scan.py,sha256=TwKwpQDLaOGsnKw8gKpA_piA4thy0ZZB9Eio9Cq2DXk,59785
+alongkit/engines/along_env.py,sha256=E5_isVbRsHFzmcRIK2bQB_l3xwWu7jqsNHAOLWLYPmA,831
+alongkit/engines/along_exec.py,sha256=PL-gyaPhuABAS9o4NDKJF1HUD6obPPmIvxrGRTccflw,21525
+alongkit/engines/along_feedback.py,sha256=gGX4AsJkASy9iX7aURuYkGlbKMYRnOw7E9NtJ9U6H_E,15901
+alongkit/engines/along_graph_arch.py,sha256=LDCncgd8b0MD0MSaeNsAkIVtDTfQRZlrgF_f8n-e7E0,13823
+alongkit/engines/along_graph_check.py,sha256=58WkyHRWMuWck2mQK9TsNTKyKJmeglpXZwJwN6VeZcg,7565
+alongkit/engines/along_graph_impact.py,sha256=sb1olguB0ByEh-uVyV28M1_s4h5FK1VDBGMKGZ3xWWY,16320
+alongkit/engines/along_graph_sync.py,sha256=HH-tsG6mpefJRQdzA3SCxZjXy48izZIMz9zc8nDbPI0,12675
+alongkit/engines/along_history_sync.py,sha256=EfDcvP8eonRhe_VCEHyQBd9glGpeztlOQ03HPapVaTA,12041
+alongkit/engines/along_hook.py,sha256=eOw2dFfob3a0AIK7Vvk1EuHPOPK_jHtEv68YTKC9t6g,20059
+alongkit/engines/along_init.py,sha256=6VfoUlBA_GVj4qByelO1TuF0bGu-M039KjiNwDPj9bk,17078
+alongkit/engines/along_kb_search.py,sha256=P--1yOu4uenUdbC5UcbhMDFDqaaHF86IeGl6PU2CF3Y,36529
+alongkit/engines/along_kb_sync.py,sha256=HHP2Sadr-WZcnnRpjvQJ3xdVsOubYaEEasOASbj3AL8,81383
+alongkit/engines/along_merge_driver.py,sha256=vmSdXa-BuXYke7LK5qm2PDmxrjCpxV1aP04lavU5ONs,1275
+alongkit/engines/along_resolve.py,sha256=6VZRT9KiCDNU5XoZbIKS3c8Q9UnssGiGgEMdRZmVovc,5807
+alongkit/engines/along_update.py,sha256=-C2x9XwWC96eI-GUYNytqlx18iY40wmPl2Yb2tbN70o,38703
+alongkit/engines/along_version_bump.py,sha256=BoFHaZpcofzsJ1psWh2RvrKHRwHXqtWoR8JudSP1MJc,41129
+alongkit/engines/along_wrap.py,sha256=BGHcJdeESKku-23DrYzKQmvRl3SuOYsdZPr9UtxrAVA,4745
+alongkit/engines/bench_kb_search.py,sha256=7C8YNIZYsGojKnUEj52drB3RSEj-AEUPIWFMYn09kUk,16545
+alongkit/engines/configure_mcp.py,sha256=29nw30gXzeXGISzJPTmQ9xFaqXLu-GUzIEMoiElx20U,4588
+alongkit/engines/install_manifest.py,sha256=enQ9PMd5CCOK_CBwUtqwh6Ne2c6OylKtbdvvNfzBJJE,7314
+alongkit/engines/migrate_protocol.py,sha256=r53q86U606K53_lv3X5I1YVJX_BHPAPDXNZLlwWjVZg,78087
+alongkit/engines/sanitize_typography.py,sha256=KnOMSJA0qsfVOGlbtN1yg7DHdm4iEz9FhE_HGIoC8Q4,4615
+actdim_along-4.9.0.dist-info/METADATA,sha256=IPDJVbMElFRuV5Ozh5R_jlhUUU1aqYsX8WjUceBtPKc,21261
+actdim_along-4.9.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+actdim_along-4.9.0.dist-info/entry_points.txt,sha256=TL64swhvug4W4NH9A5u79V6oeXRvlGMXMFxuIteo3zU,44
+actdim_along-4.9.0.dist-info/licenses/LICENSE,sha256=uGxXsvaUr6xqDNdoMfFYJfk0DD18Tu_pTBo6fC64mC0,1063
+actdim_along-4.9.0.dist-info/RECORD,,

actdim_along-4.9.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

actdim_along-4.9.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+along = alongkit.cli:main

actdim_along-4.9.0.dist-info/licenses/LICENSE

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

alongkit/__init__.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+"""
+alongkit - Shared implementation behind the Along engines.
+
+The engines in `scripts/` used to be twelve standalone programs with no shared module.
+`find_repo_root` existed in five divergent copies, front-matter parsing in four, and
+`subprocess.run` was called 25+ times with no shared convention, which is how a single
+encoding defect reached every one of them. This package holds one implementation of
+each shared concern:
+
+- `repo`        repository root, state directory, engine resolution, directory walking
+- `frontmatter` the YAML front-matter reader and writer (ruamel.yaml, round-trip)
+- `entities`    entity vocabulary, canonical keys, ADR records
+- `proc`        subprocess execution with fixed UTF-8 conventions
+- `textio`      strict reads, line-ending preservation, atomic writes
+- `markdown`    links, fenced-code tracking, heading anchors
+- `typography`  the forbidden-character table
+- `sanitizer`   which files that table governs, and the report a caller consumes
+- `transaction` snapshot and byte-exact rollback around a multi-file mutation
+- `migration`   collision policy, backup, and dry-run plan for the migration engine
+- `version`     the protocol version constant
+- `bootstrap`   dependency resolution for a directly invoked engine
+
+Import style inside the engines is `from alongkit import repo, proc`, which works
+unmodified both in the source repository and in the flat `~/.along/bin/` install,
+because Python places the running script's directory on `sys.path` and the package is
+always copied next to the engines.
+"""
+
+from __future__ import annotations
+
+from . import (bootstrap, budget, diagnostics, entities, exceptions, gates, handoff, lifecycle, markdown, migration, patcher, proc, profiles, repo, resolve, sanitizer,
+               session, telemetry, textio, transaction, typography, version, worktree)
+from .exceptions import AlongError, CommandError, ValidationError
+from .proc import Result, run_capture, run_passthrough, run_python
+from .repo import (canonical_path, canonical_relpath, find_agent_contexts, find_manifest_projects, find_repo_root,
+                   find_state_dir, resolve_llm_targets, resolve_tool_script,
+                   safe_relpath, state_dir)
+from .textio import read_text, write_text
+from .version import CURRENT_PROTOCOL_VERSION
+
+__all__ = [
+    "bootstrap",
+    "budget",
+    "diagnostics",
+    "entities",
+    "exceptions",
+    "gates",
+    "handoff",
+    "lifecycle",
+    "markdown",
+    "migration",
+    "patcher",
+    "proc",
+    "profiles",
+    "repo",
+    "resolve",
+    "sanitizer",
+    "session",
+    "telemetry",
+    "textio",
+    "transaction",
+    "typography",
+    "version",
+    "worktree",
+    "AlongError",
+    "CommandError",
+    "ValidationError",
+    "CURRENT_PROTOCOL_VERSION",
+    "Result",
+    "canonical_path",
+    "canonical_relpath",
+    "find_agent_contexts",
+    "find_manifest_projects",
+    "find_repo_root",
+    "find_state_dir",
+    "read_text",
+    "resolve_llm_targets",
+    "resolve_tool_script",
+    "run_capture",
+    "run_passthrough",
+    "run_python",
+    "safe_relpath",
+    "state_dir",
+    "write_text",
+]
+
+# `frontmatter` is deliberately absent from the eager imports above: it requires
+# ruamel.yaml, and an engine that only needs `repo` or `proc` must not be forced to
+# resolve a third-party dependency. Import it explicitly where it is used:
+#     from alongkit import frontmatter

alongkit/__main__.py

@@ -0,0 +1,12 @@
+import os
+import sys
+
+if __name__ == '__main__':
+    if not __package__:
+        parent = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+        if parent not in sys.path:
+            sys.path.insert(0, parent)
+        from alongkit import cli
+    else:
+        from . import cli
+    sys.exit(cli.main())