Skip to content

CHANGELOG.md

Latest commit

 

History

History
90 lines (76 loc) · 4.48 KB

CHANGELOG.md

File metadata and controls

90 lines (76 loc) · 4.48 KB
Raw

Changelog

This file records notable catalog-contract and maintenance changes.

[0.1.0] - 2026-09-12

First versioned release: agent-taught courses, the Project Radar system, and the 0.0.3 contract updates.

Added

  • A courses/ content type: agent-taught folders with COURSE.md teaching contracts, bilingual lesson pairs, scenario skins, task contracts, runnable starter/solution pairs, and objective verify.py completion evidence.
  • The five-course 0.0.3 batch: "Hands-on Python with Claude Code" (flagship), "Hands-on with OpenAI Codex CLI" (reuses the C1 core), "One source of truth for agent rules" (rule-drift checker core), "From 'it runs' to 'it ships'" (release-evidence builder core), and "Give your agent tools with MCP" (reuses the reviewed mcp-server contract) — each EN+ZH with scenario skins and REVIEW.md run-through records.
  • tools/verify_courses.py enforcing the course folder contract, wired into the Makefile and the validation workflow.
  • Project Radar per-project YAML records (catalog/projects/*.yml) with lifecycle status, maintenance evidence, and ai_familiarity grading.
  • Deterministic radar.json export with schema/radar-v1.schema.json and --check support in tools/export_catalog.py (--target both).
  • Bilingual generated Radar tables in catalog/projects/README.md and README_cn.md.
  • tools/radar_scan.py: read-only, rate-limited discovery of Radar review candidates from GitHub Search, the PyPI feed, and Hacker News — candidates only, never descriptions or status.
  • A course-feedback issue template for teaching drift and verify mismatches.
  • content-manifest.json and its schema now carry course documents.
  • Courses and Radar sections in llms.txt.

Changed

  • README/README_cn gained a course banner, a courses row, and contextual flypython.com footers on every guide, playbook, and example (first-party continuation links per docs/REPO_TO_WEBSITE.md).
  • The validation workflow now verifies the radar export and every course folder in addition to the existing gates.
  • Bilingual guide-URL tests now allow first-party flypython.com footer links alongside reviewed catalog URLs.

Added (0.0.2 and earlier)

  • A complete bilingual Python AI-coding workflow covering task contracts, repository inspection, reproducible environments, bounded changes, tests, runtime verification, side-effect review, and evidence-based delivery.
  • Browsable English and Chinese README indexes containing every reviewed resource, its rationale, level, access requirements, risk, and review date.
  • Deterministic README generation and drift checks backed by canonical catalog data.
  • One source file per reviewed resource under catalog/resources/.
  • A deterministic, versioned catalog.json export for pinned website consumers.
  • A JSON Schema describing the public catalog v1 contract.
  • A pinned-revision and checksum contract for website consumers.
  • Export drift checks in tests and pull-request validation.
  • Positive, unique, consecutive ordering within each learning path.
  • Catalog validation and a safe external-link auditor with retry, report, and SSRF/DNS-rebinding protection.
  • Contribution, conduct, security, issue, and resource-curation policies.
  • A product-quality guide and five bilingual task playbooks for bug fixes, API work, external integrations, dependency upgrades, and releases.
  • A standard-library-only example with a deliberately failing starter, verified solution, and task contract.
  • Reusable task, plan, review, verification, agent-instruction, and pyproject templates.
  • A versioned content-manifest.json with bilingual paths, summaries, review state, and source checksums for pinned website consumers.
  • A human-review contribution queue for current Python Project Radar entries.

Changed (0.0.2 and earlier)

  • Defined this repository as the canonical Python product-engineering content, catalog-data, and review layer behind flypython.com, rather than a second public website.
  • Split catalog metadata, paths, and resources into independently reviewable files while preserving the 21 existing human-reviewed resource records.
  • Required website consumers to pin a full repository commit and verify the exported catalog checksum instead of following a moving branch.
  • Reduced the required local toolchain to Python 3.12 and locked Python dependencies.

Removed (0.0.2 and earlier)

  • Removed Jekyll, Ruby, page templates, styles, scripts, social assets, CNAME, robots configuration, and site-rendering tests.