Skip to content

Commit c0b14df

Browse files
xxg1413xxg1413
committed
docs: refresh project status
1 parent 39a3e79 commit c0b14df

7 files changed

Lines changed: 52 additions & 8 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,29 @@ This file records notable catalog-contract and maintenance changes.
44

55
## [Unreleased]
66

7+
### Changed — 2026-09-16 learner verifier v2
8+
9+
- All 12 public course verifiers now expose `check --json` and require
10+
explicit `--attest ID` confirmation before self-reported checkpoints emit
11+
learner-submittable codes.
12+
- The default learner command tests `starter/`, reports `[open]`, `[passed]`,
13+
`[pending]`, and `[attested]`, and exits successfully only after every gate
14+
is passed or explicitly attested.
15+
- `progress --json` remains available only for the v1 signed-receipt contract;
16+
its legacy self-reported rows must not be submitted as learner claims.
17+
- `tools/verify_courses.py`, both READMEs, paired course guidance, and
18+
`content-manifest.json` were updated together. Production consumer pin:
19+
`39a3e79be939f491ac3c779494bf5c655c5588a0`.
20+
721
0.1.0 — companion-repository half of the public launch (website
822
`docs/product-and-growth-plan-0.1.0.md`; see the website `CHANGELOG.md`
923
for the platform half).
1024

1125
Release mapping (FP-1012): this repository ships **v0.1.1** on this
1226
release train — the earlier `v0.1.0` tag stays immutably on `e420fca`.
13-
Compatibility: website `v0.1.0` ↔ repository `v0.1.1`.
27+
Compatibility: website `v0.1.0` ↔ repository `v0.1.1`. The immutable tag is
28+
`db85cdd…`; current `master` and the production website pin have advanced to
29+
post-tag verifier commit `39a3e79…`.
1430

1531
### Changed
1632

‎README.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,16 @@ wrote code” to “a user outcome is verified.” The repository owns the revie
2525
source content and data; [flypython.com](https://flypython.com/) turns pinned
2626
versions into a browsable learning experience.
2727

28+
## Current status
29+
30+
As of 2026-09-19, `master` is `39a3e79be939f491ac3c779494bf5c655c5588a0`
31+
and the package version is `0.1.1`. This commit follows the immutable `v0.1.1`
32+
tag and adds learner verifier v2: tests must pass and reflection checkpoints
33+
must be explicitly confirmed with `--attest`. FlyPython.com pins this exact
34+
commit and serves it in production. That proves release delivery, not learner
35+
outcomes or paid demand; the website's payment and email operations still have
36+
separate acceptance gates.
37+
2838
## Start in three minutes
2939

3040
You need a coding agent that can run commands and reach the network

‎README_cn.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,14 @@ FlyPython 是一个面向实践的双语仓库，帮助你写好 Python，并把
2222
维护经过审核的源内容与数据，[flypython.com](https://flypython.com/) 把固定版本呈现为更适合
2323
阅读和发现的学习体验。
2424

25+
## 当前状态
26+
27+
截至 2026-09-19，`master` 为 `39a3e79be939f491ac3c779494bf5c655c5588a0`，
28+
包版本为 `0.1.1`。该提交位于不可变标签 `v0.1.1` 之后，加入 learner verifier v2：
29+
测试关卡必须通过，自报关卡必须用 `--attest` 显式确认。FlyPython.com 固定并在生产环境
30+
交付此提交。这只能证明发布与交付，不证明学习效果或付费需求；网站的真实付款和邮件运营
31+
仍有独立验收关卡。
32+
2533
## 3 分钟开始
2634

2735
你需要一个能执行命令并联网的编码 Agent（Claude Code、Codex 应用、

‎docs/REPO_TO_WEBSITE.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,10 @@ Avoid generic banners, repeated marketing copy, and links to placeholder pages.
2929

3030
## Attribution and acceptance
3131

32-
Until a dedicated GitHub landing route exists in production, link to the live
33-
site root. When the website ships a route such as `/from-github`, verify it on
34-
the custom domain before changing repository links. Then measure, at minimum:
32+
The dedicated `/from-github` landing route is now in production. Repository
33+
calls to action may link to that route when attribution matters, while generic
34+
“continue learning” links may still use the site root. Re-verify the custom
35+
domain after each website release. Measure, at minimum:
3536

3637
- repository link clicks by source document;
3738
- landing-page engagement with a learning path;

‎docs/repo-plan-0.0.3.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# FlyPython 仓库 0.0.3 更新计划
22

3+
> 历史版本记录：本文件保留当时的范围与假设。2026-09-19 当前 `master` 已是
4+
> `39a3e79…`，生产网站也固定到该提交；不要把下文旧 pin 或未勾选 TODO 当成当前状态。
5+
36
版本：0.0.3（规划稿）
47
更新：2026-09-11
58

‎docs/repo-plan-0.0.4.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# FlyPython 仓库 0.0.4 更新计划
22

3+
> 历史版本记录：本文件保留当时的挑战模型和发布证据。2026-09-19 当前 `master`
4+
> 已是 `39a3e79…`，learner verifier v2 已上线；下文旧 pin 只表示当时快照。
5+
36
版本：0.0.4（规划草稿，第 3 版）
47
更新日期：2026-09-12（第 3 版——挑战模型定稿 + A/B 阶段拆分）
58
关联：flypython.com `docs/product-and-growth-plan-0.0.4.md`

‎docs/repo-plan-0.1.x.md‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
# FlyPython 仓库 0.1.x 规划：社区贡献课程
22

33
版本：0.1.x（规划，第 3 稿；2026-09-14 从 `repo-plan-0.1.0.md` 改名，避免与已发布标签混淆）
4-
更新日期：2026-09-14
5-
状态：**规划，网站 0.1.0 实际发布之后再立项；当前目标日为 2026-09-19，若发布闸门导致
6-
顺延，本计划同样顺延，发布前不实施。**
4+
更新日期：2026-09-19
5+
状态：**规划，尚未立项。网站 0.1.0 已发布，前置条件已满足；但仍没有所有者批准的
6+
范围、负责人或实施提交，不能把本文件当成已开放社区课程贡献。后续是否立项由真实激活、
7+
维护容量和收费验收数据决定。**
78
关联：网站仓库 `docs/product-and-growth-plan-0.0.9.md`（附录 B 记录了移出决定）·
89
网站仓库 `docs/courses/README.md`（课程标准）· 本仓库 `CONTRIBUTING.md`、
910
`docs/CURATION_POLICY.md`、`LICENSE`
@@ -16,7 +17,7 @@
1617
- 官方示范（视频、终端回放、文字稿）是 Pro 专属；社区课是否配官方示范、如何开放，
1718
届时按网站当时的 Pro 规则另行决定。本规划不承诺社区课有示范。
1819

19-
## 现状（2026-09-13 核对）
20+
## 现状（2026-09-19 核对）
2021

2122
- `LICENSE` 已是双许可：代码（starter、solution、`verify.py`、工具）MIT；课文等书面
2223
内容 CC BY 4.0，署名「FlyPython (flypython.com)」。
@@ -27,6 +28,8 @@
2728
0.0.8 起课程文件夹单独取出也能运行 `python verify.py`。
2829
- 网站的课程数据与认领契约目前是手工镜像本仓库，每加一门课都要改网站代码——
2930
社区课一多就成为瓶颈（见第 6 项）。
31+
- 当前 `master` 为 `39a3e79…`，12 门公开课程已使用 learner verifier v2；社区课程
32+
proposal、脚手架、CODEOWNERS、安全审查和自动接入仍全部未实现。
3033

3134
## 待办（0.1.x 立项时细化）
3235

0 commit comments

Comments
 (0)