Skip to content

specode 6.1.1: contract-lockstep CI gate + knowledge-flow mental model#77

Merged
qxbyte merged 3 commits into
mainfrom
feat/specode-6.1.1-contract-tests
Jul 5, 2026
Merged

specode 6.1.1: contract-lockstep CI gate + knowledge-flow mental model#77
qxbyte merged 3 commits into
mainfrom
feat/specode-6.1.1-contract-tests

Conversation

@qxbyte

@qxbyte qxbyte commented Jul 5, 2026

Copy link
Copy Markdown
Owner

Summary

P1 契约测试 + P2 知识流文档(评估文档优先级表里的两项),零 breaking。

  • 契约锁步 CI 门禁 tests/test_contract_lockstep.py:把 CLAUDE.md 的「变更纪律」变成可执行测试。读 knowledge.py 真实产出的 MEMORY 表头(跑 memory-rebuild,非源码内省),断言它与 references/retrieval.mdskills/distill/references/doc-template.md 文档化的列一致,并断言 doc-template 的 frontmatter 键 == knowledge.py 读的键。提取器经负控验证能抓 reorder/drop——门禁可真失败,不是白过。三处任一漂移 → 测试红。(+5 测,共 90。)
  • 一页纸知识流心智模型 references/knowledge-flow.md:ASCII 产出→索引→消费全图(distill 写 / knowledge.py 索引 / intake+design 读、tasks+执行零注入)+「定位用非事实用」不变量 + 各部件权威文档指针。挂进 SKILL/intake References + 两 README 架构树。
  • 顺手修 6.0.0 引入的 stale specode 徽章(停在 5.2.0)。

Test plan

  • .venv/bin/python -m pytest plugins/specode/tests/ -q — 90 passed(含 5 个新契约测试)
  • 负控验证:提取器对 reorder / drop 均返回 != EXPECTED(门禁能真失败)
  • python3 scripts/check_marketplace_versions.py — 4 插件同步于 6.1.1

🤖 Generated with Claude Code

xqio and others added 3 commits July 5, 2026 17:11
…er contract

Turns the CLAUDE.md 变更纪律 prose into a CI gate. Reads knowledge.py's
ACTUAL emitted MEMORY header (behavioral, via memory-rebuild on a fixture)
and asserts it matches the columns documented in retrieval.md and distill's
doc-template.md, plus that doc-template's frontmatter keys match what
knowledge.py reads. The order-preserving extractor is negative-controlled
to fail on a reordered or dropped column, so the gate can actually catch
drift instead of passing trivially.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Qiang Xue <qxbyte@users.noreply.github.com>
…fixups

New references/knowledge-flow.md — an ASCII producer→index→consumer map
of the KB loop (distill writes / knowledge.py indexes / intake+design read;
tasks+execution zero) with the 定位用非事实用 invariant and the pointers to
each part's authoritative doc. Linked from SKILL + intake References and both
README architecture trees (also surfacing autonomous-mode.md there).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Qiang Xue <qxbyte@users.noreply.github.com>
…tal model

Bump both manifests to 6.1.1, date both CHANGELOGs, refresh README version
rows, and fix the stale specode version badge (drifted at 5.2.0 since 6.0.0).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Qiang Xue <qxbyte@users.noreply.github.com>
@qxbyte qxbyte merged commit 05c046f into main Jul 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants