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
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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;
Expand Down
6 changes: 6 additions & 0 deletions docs/project-context.md
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down
11 changes: 11 additions & 0 deletions site/test_build.py
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
8 changes: 7 additions & 1 deletion skills/context-docs/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion skills/context-docs/VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.2.7
0.2.8
10 changes: 6 additions & 4 deletions skills/context-docs/references/event-journal.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading