Skip to content

About

Neutral Git-sourced guidance preparation tooling

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

agent-guides-cli

Neutral Python tooling for preparing owner-selected, self-contained Markdown guidance from multiple Git repositories. Development prepare and prepared-only restore retain exact local bytes without native integration; verify compares against retained expectations without repair. task-pin and task-join share independently retained host evidence between roles. See the preparation contract for inputs, bounds and examples. Development install, update, connected restore, status, remove and recover now provide a journaled project-local candidate. Read the lifecycle contract and remaining acceptance before use; Managed hosts use an explicitly approved read-only configuration; the package never changes the host or existing JSONC. T04 acceptance records tested versions, root-started behavior and limits; this is not a stable release.

An opt-in refresh command refreshes explicitly selected mirrors and updates an already connected direct-work project before opening a client. It installs no hooks or launchers; an intact offline copy is reported with a warning.

This repository is the tool only. Common authored guidance lives in agent-guides (ADR 0003).

Start with the canonical task handoff, agreed scope and technical reference. The executable has no dependency on the legacy Flutter runtime or its payload.

Development and local trial

Prerequisites: Python 3.11+, Git, and Python build tooling for source builds. macOS and Linux are targets; consult T01 evidence for platforms actually tested. Windows support is deferred. The scaffold itself does not invoke Git.

From the checkout, in a dedicated environment:

python3 -m venv .venv
.venv/bin/python -m pip install build
.venv/bin/python -m pip install -e .
.venv/bin/python -m unittest discover -s tests -p 'test_*.py' -v
.venv/bin/python tests/check_distribution.py -v

The distribution check builds an sdist, builds a wheel from that sdist, inspects inventories and notices, installs the wheel without dependencies in a fresh temporary tools environment, and exercises CLI and tests outside checkout. Build dependencies may require network access. Tests use synthetic Git/CLI fixtures; they do not execute consumer commands or alter global configuration.

For a retained local trial, build and inspect the wheel with the same procedure, retain its bytes and SHA-256, then install that exact wheel into an owner-selected environment with python -m pip install --no-deps /path/to/exact-wheel.whl. Do not infer a stable published release from this development version.

Boundaries and attribution

Content versions will be independent of executable releases. Native loading must be demonstrated in installed clients before it is claimed; host integrity checks do not establish model compliance. Preparation alone does not register native guidance; connection requires an explicit lifecycle operation.

Licensed under Apache-2.0; see NOTICE. The handoff and packaging approach originate in flutter-agent-guidelines. Small audited Apache-2.0 identity/path/snapshot/Git primitives are adapted with provenance in NOTICE; the old runtime is not a dependency. Third-party tutorials, configurations and lint sources are not imported.

About

Neutral Git-sourced guidance preparation tooling

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages