diff --git a/CHANGELOG.md b/CHANGELOG.md index fd12884..ea20546 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -24,6 +24,16 @@ Earlier [v0.1.6 release notes](docs/releases/v0.1.6.md) are retained. Earlier contents and validation are summarized in the [v0.1.5 release notes](docs/releases/v0.1.5.md), with earlier [v0.1.4](docs/releases/v0.1.4.md) and [v0.1.3](docs/releases/v0.1.3.md) notes retained. +## context-docs 0.2.8 — 2026-11-21 (unreleased) + +- Specify how Codex and Claude Code hand off edits to a shared context file + through the task channel or the user. Keep private context and journal + payloads out of the handoff. +- Show standard input first for optional event capture. Use an authorized + private scratch path for a file-backed payload. +- Checked with the repository static checks and packaged journal tests on + Python 3.9 and 3.14. These are source and helper checks. + ## Experimental Antigravity support label — 2026-11-17 (no package release) - Clarify current docs and website wording: experimental Antigravity support, diff --git a/README.md b/README.md index 2b8ee9e..82ddd58 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,8 @@ next session to read them. [Website](https://context-docs.com/) · [Get started](#get-started) · [See an example](#what-you-get) · [User guide](docs/getting-started.md) · [Evidence](docs/evaluation-results.md) · [Contribute](CONTRIBUTING.md) -**Status: experimental, core skill v0.2.7 and adoption skill v0.1.16.** +**Status: experimental, core skill v0.2.8 (unreleased) and adoption skill v0.1.16.** +The published bundle remains v0.2.7. The [v0.2.7 release notes](docs/releases/v0.2.7.md) cover a narrow instruction simplification and qualified checks. Everyday installation selects this bundle. The Codex candidate report's automatic-loading confirmation remains unverified; diff --git a/docs/project-context.md b/docs/project-context.md index 5ca5906..c05f048 100644 --- a/docs/project-context.md +++ b/docs/project-context.md @@ -19,6 +19,12 @@ and evidence IDs when those records explain a project issue. ## Current focus +The unreleased core 0.2.8 source clarifies +[shared-context writer handoff](../skills/context-docs/SKILL.md#make-the-smallest-useful-update) +and [private journal payload delivery](../skills/context-docs/references/event-journal.md#capture-during-maintenance). +The event helper and adoption skill keep their existing behavior. Published +installation commands still select v0.2.7. + **Experimental Antigravity support, validated through CLI; App and IDE not separately tested** is published from **`4093383`** after the owner's commit, push and deployment authorization. Fresh independent source review, diff --git a/site/test_build.py b/site/test_build.py index fce4263..5eb8161 100644 --- a/site/test_build.py +++ b/site/test_build.py @@ -686,6 +686,17 @@ def status_source(path, *args, **kwargs): self.assertIn('Experimental · ' + ('Released' if released else 'Unreleased'), landing.render(landing.ROOT, page)) + def test_core_source_version_different_from_installed_version_is_unreleased(self): + readme = (landing.ROOT / 'README.md').read_text(encoding='utf-8') + install = landing.fenced_section(readme, '### Install in Codex', 'text') + published = re.search(r'^context-docs (\d+\.\d+\.\d+)\b', install, re.M) + self.assertIsNotNone(published, 'Missing published core version in the install instructions') + source = (landing.ROOT / 'skills/context-docs/VERSION').read_text(encoding='utf-8').strip() + if source != published[1]: + for template in ('index.html', 'getting-started.html'): + with self.subTest(template=template): + self.assertIn('Experimental · Unreleased', landing.render(landing.ROOT, template)) + def test_missing_package_status_does_not_claim_a_release(self): original_read = Path.read_text diff --git a/skills/context-docs/SKILL.md b/skills/context-docs/SKILL.md index ba2cf1b..bf10a58 100644 --- a/skills/context-docs/SKILL.md +++ b/skills/context-docs/SKILL.md @@ -57,7 +57,13 @@ uncertainty, rationale or evidence. Preserve existing layouts and unrelated owne When agents or sessions work concurrently on the same context file, coordinate one writer at a time for that file; others pass their findings to the writer. Agree on the writer before concurrent edits begin, including across Codex and -Claude sessions in a shared checkout. Change writers through an explicit handoff. +Claude Code sessions in a shared checkout. Use the existing authorized task +channel or ask the user to relay the handoff. Identify the shared checkout, +relative paths, current writer and whether edits are active, held for review or +released. The outgoing session finishes its edits and releases the paths. The +incoming writer acknowledges the handoff and rereads the files before editing. +If ownership or release is unclear, pause overlapping edits and continue +read-only work. Keep private context and journal payloads out of the handoff. Prefer narrow edits. After an edit conflict or stale-text failure, reread the current file and reconcile contributors' changes before retrying. Do not overwrite newer work from a stale snapshot. This is a coordination rule; file access remains diff --git a/skills/context-docs/VERSION b/skills/context-docs/VERSION index b003284..a45be46 100644 --- a/skills/context-docs/VERSION +++ b/skills/context-docs/VERSION @@ -1 +1 @@ -0.2.7 +0.2.8 diff --git a/skills/context-docs/references/event-journal.md b/skills/context-docs/references/event-journal.md index 4c020ac..e9d93f8 100644 --- a/skills/context-docs/references/event-journal.md +++ b/skills/context-docs/references/event-journal.md @@ -142,15 +142,17 @@ Use the [packaged helper](../scripts/event_journal.py) from this installed skill not a path to the development repository. Python 3.9+ and its standard library are needed only for this optional command. Resolve the skill directory from the loaded skill's location. From the project root, use its script with the configured -journal directory, a unique session ID, and one JSON payload: +journal directory, a unique session ID, and one JSON payload on standard input: ```sh python3 /path/to/installed/context-docs/scripts/event_journal.py \ - --directory .context/events append --session session-unique-id --input event-input.json + --directory .context/events append --session session-unique-id ``` -Omit `--input` to supply JSON on stdin. Keep temporary payloads outside the journal; -reuse/remove them only when safe. Only JSONL history belongs in the journal directory. +Supply the payload through the host command tool's stdin or a private pipe. If a +file is needed, use `--input` with its absolute path in an authorized private +scratch directory outside the checkout and journal. Only JSONL history belongs +in the journal directory. Use a unique session ID per working session (1–80 ASCII letters, digits, `_` or `-`, starting with a letter/digit). Reuse it for that session's distinct events. The helper generates event IDs and recording timestamps; include an earlier event's