Skip to content

Self-Evolution v2.0.0-rc.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@D1ChangGeng D1ChangGeng released this 18 Aug 01:26
· 16 commits to main since this release
v2.0.0-rc.1
51fcea8

Self-Evolution v2.0.0-rc.1

Pre-release status: deterministic artifact and safety checks pass, but nine model/outcome gates remain pending. The recorded state is release_ready: false. This release is not proof that v2 outperforms v1 on real-world coding tasks.

Self-Evolution v2 replaces the v1 lifecycle-heavy project-memory system with a smaller, evidence-oriented project context layer. It keeps durable knowledge only when it can change a later decision or action, retrieves the smallest relevant set, and treats current code, tests, configuration, runtime behavior, and human decisions as the final truth boundary.

Highlights

  • Smaller initialization contract: v1 created 7 files; v2 creates 3 (AGENTS.md, .agents/settings.yaml, and .agents/knowledge/index.yaml) — a 57.1% reduction.
  • Four clear knowledge destinations: Guides, Decisions, Observations, and Archive.
  • Minimal retrieval: a thin AGENTS.md router plus Guide scope and use_when metadata select the smallest relevant context.
  • Evidence before authority: stored prose routes work, but material or changed claims must be checked against current project reality.
  • Deterministic Node.js 22+ CLI: initialization, indexing, checks, audit support, adapter lifecycle, and migration are implemented in the bundled kb CLI.
  • Reviewable v1 → v2 migration: prepare, inspect, apply, and rollback stages are byte-accounted and reversible.
  • Opt-in integrations: adapters are off by default, project-scoped, and isolated from durable project knowledge.
  • Failure-driven maintenance and evaluation: proposals and gates are tied to replayable failure evidence instead of feature accumulation.
  • Frozen v1 baseline: the complete 1.x implementation is retained under legacy/v1/ for migration and evaluation provenance.

Installation

npx skills add D1ChangGeng/self-evolution --skill self-evolution -g -y

This repository is the source/Skill distribution. It is not an npm package release; package.json remains private: true.

Validation

The release tag points to commit 51fcea8ac14fbe7b960c0ef6271e3998eec606a8.

  • Product Vitest suite: 43/43 passed
  • Maintainer evaluation contract/evidence tests: 27/27 passed
  • Executable evaluation fixtures: 13/13 materialized and verified
  • External campaign harness tests: 127/127 passed
  • CLI bundle/source byte parity: passed
  • Git-free clean snapshot: npm ci and npm run ci passed with Node.js 22.13.1 / npm 10.9.2
  • GitHub Actions on main: Ubuntu and Windows passed — run 32087884462
  • GitHub Actions on this tag: Ubuntu and Windows passed — run 32088089387

Recorded integrated gate state:

  • 8 pass
  • 0 fail
  • 9 pending
  • 0 blocked
  • release_ready: false

See maintainer/evals/RESULTS.md for the exact gate-by-gate boundary.

Real-task comparison status

The three frozen upstream defect tasks passed their environment/oracle preflight. The formal v1/v2 campaign then failed closed at the workspace-edit gateway smoke check before any model session began.

  • Completed A/B trial units: 0/18
  • Completed blind reviews: 0/9
  • Real-task winner: not measured / no conclusion

The public external harness and task contracts are evaluation infrastructure; “hidden” tests are hidden from the execution agent during a run, not claimed as permanently private benchmarks.

Artifact hashes

Skill SHA-256:
2f3c045501508441f3eb89431b4feea2126a9ea04b9006951605aee849b7f8e2

CLI bundle SHA-256:
6eccbda3da357dc9c4024f0bf338601c206f08bf021cc0d151390a40bc9e15ad

Evaluation contract SHA-256:
94233d2dfc6c4549f98671e97fd4d7556a2265e32e56e5abe6d8b1b15b8f0e19

Licensing

Self-Evolution is distributed under Business Source License 1.1 with the repository's Additional Use Grant and derivative-work requirements. It is not an unconditional permissive open-source grant. On 2030-04-27, the licensed work changes to Apache License 2.0. Review LICENSE for the complete terms.

Upgrade notes

  • Use the staged migration flow for existing v1 projects; kb init intentionally refuses to overwrite a detected v1 knowledge base.
  • Review generated migration proposals before applying them.
  • Adapters remain disabled unless explicitly installed.
  • Treat this RC as suitable for evaluation and controlled adoption while model/outcome gates remain pending.

Full changelog: 3b28dd2...v2.0.0-rc.1

Assets 2
Loading