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.
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 -vThe 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.
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.