Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

## Unreleased

## 1.0.0

First tagged production release. `v0.1.0`/`v0.1.1` on GitHub were release-automation smoke tests and are not part of this line; this release picks up the version sequence documented below, starting at `0.8.0`.

### Added

- `docs/ARCHITECTURE.md`, establishing the three user-facing framework layers (Agentic Delivery, Learning & Ownership, Optional Risk Lenses) as the primary conceptual model across the README, installed documentation, skills, and installer, with the earlier five-layer description retained only as implementation provenance rather than a second architecture.
Expand Down
6 changes: 3 additions & 3 deletions MANIFEST.txt
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.gitattributes 40
.gitignore 324
AGENTS.md 2524
CHANGELOG.md 17352
CHANGELOG.md 17573
docs/AGENTIC_WORKFLOW_SANITY.md 7795
docs/ARCHITECTURE.md 6009
docs/DESIGN_NOTES.md 27644
Expand All @@ -16,7 +16,7 @@ docs/references/REFERENCE_REVIEW_LEARNING_FLOW_ADJUSTMENT.md 9505
docs/references/REFERENCE_REVIEW_LITT.md 2069
docs/references/REFERENCE_REVIEW_POCOK.md 2155
LICENSE 2213
README.md 8143
README.md 8553
sample/common/.agents/skills/agentic-workflow/SKILL.md 2686
sample/common/.agents/skills/learn-anything/agents/openai.yaml 246
sample/common/.agents/skills/learn-anything/SKILL.md 1756
Expand Down Expand Up @@ -99,7 +99,7 @@ sample/root/AGENTS.pointer.md 551
scripts/install.bat 1477
scripts/install.ps1 40236
scripts/install.sh 34910
scripts/README.md 6656
scripts/README.md 6771
skill-evals/agentic-cases.yaml 7109
skill-evals/conversation-cases.yaml 3653
skill-evals/full-cases.yaml 4248
Expand Down
12 changes: 9 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Codebase Learning Flow

[![Latest release](https://img.shields.io/github/v/release/legrab/codebase-learning-flow?label=latest%20release)](https://github.com/legrab/codebase-learning-flow/releases/latest)

> A small repository harness for learning real systems with AI while keeping human judgment in charge.

Codebase Learning Flow configures a host coding agent. It provides repository-local instructions, focused skills, learning surfaces, and private local continuity. It does **not** provide an agent runtime, sandbox, retry engine, or background worker.
Expand Down Expand Up @@ -55,15 +57,19 @@ The agent should not turn every task into a lesson. Short questions can receive

### Preferred: packaged release

For team or enterprise use, install a reviewed, versioned release.
For team or enterprise use, install a reviewed, versioned release. Substitute
the current tag from the badge above or the
[Releases page](https://github.com/legrab/codebase-learning-flow/releases) —
`--release`/`-Release` intentionally has no "latest" shortcut, so the exact
tag must be given.

```sh
curl -fsSL https://raw.githubusercontent.com/legrab/codebase-learning-flow/main/scripts/install.sh -o install.sh
sh install.sh --release v0.9.0 --profile minimal
sh install.sh --release v1.0.0 --profile minimal
```

```powershell
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/legrab/codebase-learning-flow/main/scripts/install.ps1))) -Release v0.9.0 -Profile Minimal
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/legrab/codebase-learning-flow/main/scripts/install.ps1))) -Release v1.0.0 -Profile Minimal
```

The installer verifies the release checksum before extraction and reports the resolved `Version:` and `Source:`.
Expand Down
2 changes: 1 addition & 1 deletion sample/common/agentic-flow/.template-version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.8.0
1.0.0
2 changes: 1 addition & 1 deletion sample/profiles/full/learning-flow/.template-version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.8.0
1.0.0
2 changes: 1 addition & 1 deletion sample/profiles/minimal/learning-flow/.template-version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.8.0
1.0.0
22 changes: 12 additions & 10 deletions scripts/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,27 +32,29 @@ flowchart LR
```

```text
sh install.sh --release v0.9.0 --profile minimal
sh install.sh --release v1.0.0 --profile minimal
```

```powershell
.\install.ps1 -Release v0.9.0 -Profile Minimal
.\install.ps1 -Release v1.0.0 -Profile Minimal
```

`--release`/`-Release` downloads the packaged artifact and `checksums.txt`
published against that exact tag on the repository's Releases page, verifies
the SHA-256 checksum before extracting anything, and cross-checks the
package's own `VERSION` file against the requested tag. `--ref`/`-Ref` and
`--release`/`-Release` are mutually exclusive. `latest` is not accepted as a
release value: look up the tag you want on the Releases page and pass it
explicitly. This is deliberate, not an oversight -- see "Release-based
distribution" in `docs/DESIGN_NOTES.md`.
published against that exact tag on the repository's
[Releases page](https://github.com/legrab/codebase-learning-flow/releases),
verifies the SHA-256 checksum before extracting anything, and cross-checks
the package's own `VERSION` file against the requested tag. `--ref`/`-Ref`
and `--release`/`-Release` are mutually exclusive. `latest` is not accepted
as a release value: look up the current tag on the Releases page (the
version above will go stale as new releases ship) and pass it explicitly.
This is deliberate, not an oversight -- see "Release-based distribution" in
`docs/DESIGN_NOTES.md`.

Every install prints which trust boundary it used:

```text
Codebase Learning Flow
Version: v0.9.0
Version: v1.0.0
Source: packaged release (checksum verified)
```

Expand Down
Loading