Skip to content

Commit 03cb781

Browse files
committed
docs: release v1.1.0
Convert the Unreleased changelog material into a final v1.1.0 entry: installer replacement, docs/ai lifecycle rework, and behavioral-eval hardening, grouped with the incremental skill-wording improvements that were also pending release. Records the eval validation status honestly: the CODEX_HOME isolation and auth-seeding fix is confirmed against a real codex exec run, but a full live pass/fail verdict for the two named two-pass cases remains unavailable because the Codex session reported itself read-only despite requesting workspace-write - a Codex CLI environment limitation, not an Orient defect. Unlike v1.0.0, this release does not carry an independent human-through-agent validation pass; that tradeoff is stated here rather than left implicit.
1 parent 2380179 commit 03cb781

1 file changed

Lines changed: 42 additions & 17 deletions

File tree

CHANGELOG.md

Lines changed: 42 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,15 @@
22

33
## Unreleased
44

5-
**Orient v1.1 implementation:**
5+
No changes yet.
6+
7+
## 1.1.0 - 2026-07-05
8+
9+
First release after `v1.0.0`. Installer replacement, `docs/ai/` lifecycle
10+
rework, and behavioral-eval hardening, plus incremental skill wording
11+
improvements carried over from post-v1 maintenance.
12+
13+
**Installer replacement:**
614

715
- Add one canonical, static package inventory for reusable Claude, reusable
816
Codex, and Claude bootstrap installation, with LF-normalized SHA-256 content
@@ -11,18 +19,8 @@
1119
staged clean reinstall (`--clean` / `-Clean`) behavior across Bash and
1220
PowerShell installers. Conflicting flags and managed path type conflicts
1321
fail; overlay preserves and reports extra files.
14-
- Establish the fixed `docs/ai/` package with `ORIENTATION_STATE.json`,
15-
manifest-backed freshness and provenance, full and scoped reconciliation,
16-
exact-current reuse, legacy adoption approval, dirty-tree handling, and
17-
no-Git behavior.
18-
- Retire automatic generation and mutation of project-local
19-
`.claude/skills/codebase-orient/SKILL.md` without adding an overlay or
20-
migration subsystem.
21-
- Extend the existing behavioral-evaluation runner with the authored
22-
no-date-only-churn and source-drift two-pass cases, an optional model
23-
override, and stronger tested-skill isolation evidence.
2422
- Add installer behavior tests covering both managed packages, including a
25-
new Bash test suite (`scripts/test-installers.sh`) mirroring the existing
23+
Bash test suite (`scripts/test-installers.sh`) mirroring the existing
2624
PowerShell coverage.
2725
- Fix a Bash installer defect where a successful normal install or `--clean`
2826
reinstall printed a success message but exited with status 1, because the
@@ -37,6 +35,22 @@
3735
correctly. Fixed by using explicit `if`/`fi` instead of `&&` for both the
3836
trap cleanup and the post-replace backup removal. Caught by the new Bash
3937
test suite.
38+
39+
**`docs/ai/` lifecycle rework:**
40+
41+
- Establish the fixed `docs/ai/` package with `ORIENTATION_STATE.json`,
42+
manifest-backed freshness and provenance, full and scoped reconciliation,
43+
exact-current reuse, legacy adoption approval, dirty-tree handling, and
44+
no-Git behavior.
45+
- Retire automatic generation and mutation of project-local
46+
`.claude/skills/codebase-orient/SKILL.md` without adding an overlay or
47+
migration subsystem.
48+
49+
**Behavioral-eval hardening:**
50+
51+
- Extend the existing behavioral-evaluation runner with the authored
52+
no-date-only-churn and source-drift two-pass cases and an optional model
53+
override.
4054
- Fix the behavioral-evaluation runner's Codex sandbox isolation: `CODEX_HOME`
4155
was left pointing at the real user's `.codex` directory even though `HOME`
4256
and `USERPROFILE` were overridden to a disposable sandbox, and the
@@ -47,9 +61,19 @@
4761
authenticate, so the runner now seeds it with a copy of the real
4862
`auth.json` only - no other real Codex state (skills, session history,
4963
config) is copied in.
50-
51-
These changes remain unreleased. They do not select a release version, create a
52-
tag, or imply publication.
64+
- Validation status for the two named two-pass cases: the isolation and
65+
authentication fix above was confirmed against a real `codex exec` run
66+
(the observed failure moved from a missing-directory error, to `401
67+
Unauthorized`, to a real account usage-limit response, then to a real
68+
completed run once the account quota reset). A full live pass/fail verdict
69+
for either case is still not available: in the completed run, the Codex
70+
session reported itself as read-only despite the case requesting
71+
`workspace-write`, so pass 1 correctly proposed the package instead of
72+
writing it, per the skill's own dry-run fallback rule, rather than
73+
exercising the intended write-then-rerun-unchanged check. This is recorded
74+
as a known Codex CLI environment limitation, not an Orient skill defect;
75+
unlike `v1.0.0`, this release does not carry an independent
76+
human-through-agent validation pass.
5377

5478
**Orientation skill improvements (canonical + bootstrap):**
5579

@@ -60,15 +84,16 @@ tag, or imply publication.
6084
- Clarify that docs/ai files should be committed in target repos: the output files section now states explicitly that these files are authored narrative that improves across sessions and should not be gitignored in target repos.
6185
- Flag release validation records and gate scripts as a hidden-risk surface: the hidden-risk-reporting-rule now includes release validation records and gate scripts in its checklist, and instructs orient to note in CHANGE_SURFACES that file changes after a validated candidate require a re-check before tagging.
6286

63-
The earlier entries below were post-v1 maintenance hardening only and made no
64-
installer behavior change at the time.
87+
**Post-v1 maintenance hardening (no installer behavior change at the time):**
6588

6689
- Add a deterministic shared-rule drift guard for canonical `skills/codebase-orient/SKILL.md` vs the bootstrap embedded shared-rule snapshot in `skills/install-codebase-orient/SKILL.md`, including explicit shared-block markers, a validation script, and a GitHub Actions check that now guards those shared blocks against future accidental drift.
6790
- Align the bootstrap embedded shared-rule snapshot to canonical wording so future bootstrap-generated project-local skills receive the synchronized shared-rule content.
6891
- Freeze the former `docs/V1_RELEASE_PLAN.md` contents as `docs/releases/v1.0-validation-record.md` and keep `docs/V1_RELEASE_PLAN.md` as a short compatibility pointer now that `v1.0.0` has shipped.
6992
- Add an initial local/manual Codex behavioral eval scaffold: an inspectable prompt corpus plus a PowerShell wrapper over a Node runner that uses isolated disposable fixtures, stores traces outside the repo by default, and currently emits evidence summaries for one validated single-case vertical slice with proxy-only invocation evidence from local `codex exec --json` traces.
7093
- Clarify that the reusable canonical skill currently has an explicit tuned framework-probe section for SvelteKit, while other frameworks still rely on the generic discovery order unless later live-fire or eval evidence justifies dedicated tuned probes.
7194

95+
---
96+
7297
## 1.0.0 - 2026-05-24
7398

7499
First stable public release of `codebase-orient`.

0 commit comments

Comments
 (0)