Skip to content

CHANGELOG.md

Latest commit

 

History

History
187 lines (162 loc) · 10.3 KB

CHANGELOG.md

File metadata and controls

187 lines (162 loc) · 10.3 KB

Changelog

All notable changes to the agent-bootstrap system are recorded here.

Formal versioning begins with this release (Milestone 13). Earlier milestones (1–12) are recorded below as pre-release development history for context.

The format follows Keep a Changelog. This project uses Semantic Versioning.

[0.15.0] — 2026-03-14

Added (Milestone 18)

  • tests/test_bootstrap_doctor.py — 77 bounded contract tests covering all key target-repo diagnosis semantics in bootstrap_doctor.py: all six health state classifications, version comparison helpers (_semver_tuple, _is_materially_behind), marker status, required-files status, placeholder status, profile alignment classification, recommended next-action guidance for every health state, era classification alignment between doctor and bootstrap_core, and audit() integration tests using real temporary directories.

Changed (Milestone 18)

  • scripts/validate_bootstrap.py: added tests/test_bootstrap_doctor.py to BOOTSTRAP_REPO_REQUIRED_FILES (42 required files, 47 total checks).
  • bootstrap-manifest.yaml: added tests/test_bootstrap_doctor.py to bootstrap_repo_required_files.
  • AGENTS.md: expanded "Bootstrap doctor — advisory-only rules" section with anti-drift rules: diagnostic semantics are contract-tested and must not drift casually; changes to doctor/status/suggest shared meaning require test updates.
  • README.md: updated repository layout tree; expanded "Contract tests" section to document test_bootstrap_doctor.py coverage and the conservative-behavior guarantees that the tests prove.

[0.14.0] — 2026-03-14

Added (Milestone 17)

  • scripts/bootstrap_core.py — small shared internal module centralising the bootstrap semantics reused across multiple scripts: PLACEHOLDER_RE, SEMVER_RE, read_version(), load_manifest(), get_supported_profiles(), resolve_profile(), get_bootstrap_marker_path(), parse_bootstrap_marker(), classify_marker_era(), is_placeholder(), has_placeholders(), find_placeholders(), resolve_template_mappings(), and the canonical PROFILES dict.
  • tests/test_bootstrap_core.py — 39 bounded contract tests covering all public helpers in bootstrap_core.py: regex constants, version parsing, manifest loading, profile enumeration/validation, template mapping resolution, marker parsing, era classification, and placeholder helpers.

Changed (Milestone 17)

  • scripts/apply_bootstrap.py: imports PROFILES, DEFAULT_PROFILE, read_version, resolve_template_mappings, get_supported_profiles from bootstrap_core; removed duplicated definitions.
  • scripts/refresh_bootstrap.py: imports PLACEHOLDER_RE, PROFILES, DEFAULT_PROFILE, read_version, resolve_template_mappings, get_bootstrap_marker_path, parse_bootstrap_marker, has_placeholders from bootstrap_core; removed duplicated definitions; classify_file() uses has_placeholders().
  • scripts/bootstrap_status.py: imports SEMVER_RE, read_version, parse_bootstrap_marker, is_placeholder, classify_marker_era from bootstrap_core; removed duplicated parse_marker()/is_placeholder(); report_target_status() uses classify_marker_era() for era logic.
  • scripts/bootstrap_doctor.py: imports PLACEHOLDER_RE, SEMVER_RE, parse_bootstrap_marker, is_placeholder, classify_marker_era, find_placeholders from bootstrap_core; removed duplicated definitions; classify_era() delegates to classify_marker_era().
  • scripts/validate_bootstrap.py: imports PLACEHOLDER_RE from bootstrap_core.
  • scripts/run_fixture_selftest.py: imports PLACEHOLDER_RE from bootstrap_core.
  • scripts/validate_bootstrap.py: added scripts/bootstrap_core.py and tests/test_bootstrap_core.py to BOOTSTRAP_REPO_REQUIRED_FILES (41 required files, 46 total checks).
  • bootstrap-manifest.yaml: added scripts/bootstrap_core.py and tests/test_bootstrap_core.py to bootstrap_repo_required_files.
  • .github/workflows/ci.yml: added scripts/bootstrap_core.py to py_compile check; added python -m unittest discover -s tests -p 'test_*.py' -v step before fixture self-tests.
  • README.md: added ## Shared bootstrap core section; updated repo layout; updated CI table; updated local-validation command block.
  • AGENTS.md: added ## Shared bootstrap core and contract tests section with anti-drift rules; updated CI commands; updated profile-expansion rule to reference bootstrap_core.py as the authoritative PROFILES source; updated forbidden actions to reference bootstrap_core.py.

Added (Milestone 15)

  • scripts/suggest_profile.py — read-only profile suggestion tool. Inspects a target repository and suggests the most likely bootstrap profile using explicit file-system signals. Reports confidence (high/medium/low), matched signals, alternative candidates, and the recommended apply_bootstrap.py command. Supports --verbose (shows all profile scores and alternative signal detail) and --json (machine-readable output). Exits 0 on successful suggestion; exits 1 only on true errors (missing target dir, unreadable path).

Changed (Milestone 15)

  • scripts/run_fixture_selftest.py: added State E (profile suggestion proof); both fixtures now prove their expected profile suggestion. Summary now shows E label. Mode line updated to reflect State E.
  • scripts/validate_bootstrap.py: added scripts/suggest_profile.py to BOOTSTRAP_REPO_REQUIRED_FILES (38 required files, 43 total checks).
  • scripts/bootstrap_status.py: added scripts/suggest_profile.py to CORE_SCRIPTS.
  • bootstrap-manifest.yaml: added scripts/suggest_profile.py to bootstrap_repo_required_files.
  • README.md: added ## Profile suggestion — choosing the right profile section.
  • AGENTS.md: added ## Profile suggestion — advisory-only rules section.

Added (Milestone 14)

  • scripts/bootstrap_status.py — status/report tool for the bootstrap source repo and bootstrapped target repos. Reports version, revision, CHANGELOG state, core docs/scripts, supported profiles, and version/changelog coherence.
  • docs/BOOTSTRAP_RELEASE_WORKFLOW.md — concise repeatable release checklist covering patch/minor/major decisions, required local checks, CI expectations, changelog conventions, and post-merge verification.
  • Changelog coherence check (check_changelog_coherence()) in scripts/validate_bootstrap.py: verifies that CHANGELOG.md represents the current version as a release heading or has an [Unreleased] section.

Changed (Milestone 14)

  • scripts/validate_bootstrap.py: check_version_file() now returns the version string so the coherence check can use it; changelog coherence added as Check 4 in source repo validation (42 total checks); new required files added to BOOTSTRAP_REPO_REQUIRED_FILES.
  • bootstrap-manifest.yaml: added docs/BOOTSTRAP_RELEASE_WORKFLOW.md and scripts/bootstrap_status.py to bootstrap_repo_required_files.
  • .github/workflows/ci.yml: added scripts/bootstrap_status.py to the py_compile syntax-check step.
  • README.md: added ## Bootstrap status and release workflow section.
  • AGENTS.md: added ## Release discipline section with release contract rules.

[0.13.0] — 2026-03-14

First formalized bootstrap release. Establishes the versioning and upgrade policy for the bootstrap system.

Added

  • VERSION file as the single source of truth for the bootstrap version.
  • CHANGELOG.md (this file) for recording changes across releases.
  • docs/BOOTSTRAP_VERSIONING.md with the compatibility and upgrade policy: semver semantics, patch/minor/major definitions, refresh-safety expectations, and guidance for pre-version markers.
  • Bootstrap source revision row in templates/bootstrap/BOOTSTRAP_SOURCE.md.template to record the git commit SHA separately from the semver version.
  • BOOTSTRAP_SOURCE_REVISION auto-filled placeholder in apply and refresh scripts.
  • Version comparison output in refresh_bootstrap.py (current vs prior version).
  • Major-version drift warning in refresh_bootstrap.py when the target's recorded version has a different major than the current bootstrap version.
  • Version readability check in validate_bootstrap.py for the VERSION file.

Changed

  • BOOTSTRAP_SOURCE_VERSION in the bootstrap marker now records the semver version from the VERSION file rather than a raw git SHA. The git SHA is now recorded separately as BOOTSTRAP_SOURCE_REVISION.
  • apply_bootstrap.py and refresh_bootstrap.py read VERSION for the primary version and use git SHA only as supplemental revision metadata.
  • validate_bootstrap.py requires VERSION, CHANGELOG.md, and docs/BOOTSTRAP_VERSIONING.md as part of the bootstrap source repo.
  • bootstrap-manifest.yaml updated to reference new required files and BOOTSTRAP_SOURCE_REVISION as an auto-filled placeholder.

Policy

  • See docs/BOOTSTRAP_VERSIONING.md for the full upgrade and compatibility policy.

Pre-release development history (Milestones 1–12)

The following milestones were completed before formal versioning was established. No release tags correspond to these entries; they are recorded for context only.

  • Milestone 12 — Manifest-driven bootstrap profiles (generic, python-service, infra-repo, vscode-extension, kubernetes-platform).
  • Milestone 11 — Safe refresh / upgrade lifecycle path (refresh_bootstrap.py).
  • Milestone 10 — GitHub Actions CI regression gate.
  • Milestone 9 — End-to-end fixture self-test harness.
  • Milestone 8 — Target-repo scaffold apply path (apply_bootstrap.py).
  • Milestone 7 — Target-repo validation mode in validate_bootstrap.py.
  • Milestone 6 — Schemas for repo_discovery.json and implementation_tracker.
  • Milestone 5 — Prompts: new-repo-bootstrap, existing-repo-discovery, resume-work, bounded-implementation, closeout-and-handoff.
  • Milestone 4 — Templates: AGENTS.md, IMPLEMENTATION_TRACKER.md, REPO_MAP.md, SOURCE_REFRESH.md, AI_AGENT_VENDOR_KNOWLEDGE_BASE.md, BOOTSTRAP_SOURCE.md, repo_discovery.json.
  • Milestone 3 — bootstrap-manifest.yaml control plane established.
  • Milestones 1–2 — Initial repo structure, AGENTS.md, IMPLEMENTATION_TRACKER.md, validate_bootstrap.py.