Skip to content

armgit / cogit

Public Imported from GitHub
0

Git for the intent behind agent-written code. Records what your coding agent decided and why, and links every commit to it.

docs: a file's history joins the gallery

Erenb2498fdcb8e1
diff --git a/CHANGELOG.md b/CHANGELOG.md
index fecbf71..20994bd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
+### Added
+- A changed file in a message's card opens its history: the Files view opens on that file and lists every message that touched it, each with the reason it happened or the option it rejected — the map's side of `cogit why <path>`.
+
+### Changed
+- The README gallery gains a fourth still, the file history above.
## [0.29.0] - 2026-11-01
### Changed
diff --git a/README.md b/README.md
index 65b1855..1b52ebb 100644
--- a/README.md
+++ b/README.md
@@ -26,6 +26,11 @@ what the change does, and the diff.*
*Tasks — what your sessions left undone, drafted when a session closes. You accept, dismiss or
close each one.*
+<img src="docs/images/files.png" alt="The Files view: a changed file opened, listing the messages that touched it with each message's reason and the option it rejected">
+
+*A changed file opens its history: every message that touched it, and the reason behind each —
+including the option that was rejected.*
+
## What it does
- **Every message becomes a thought commit**: the question, the outcome, the decisions with
diff --git a/docs/images/files.png b/docs/images/files.png
new file mode 100644
index 0000000..d1f31cf
Binary files /dev/null and b/docs/images/files.png differ
diff --git a/packages/cli/test/plugin-manifest.test.ts b/packages/cli/test/plugin-manifest.test.ts
index 0aafa1e..034f29c 100644
--- a/packages/cli/test/plugin-manifest.test.ts
+++ b/packages/cli/test/plugin-manifest.test.ts
@@ -60,14 +60,14 @@ describe("plugin packaging", () => {
it("keeps a README that shows the map and points at the guide and licence", async () => {
const readme = await readFile(new URL("../../../README.md", import.meta.url), "utf8");
- // The feature gallery: the map, a message's Shape and the Tasks panel.
- for (const shot of ["map.png", "shape.png", "tasks.png"]) {
+ // The feature gallery: the map, a message's Shape, the Tasks panel and a file's history.
+ for (const shot of ["map.png", "shape.png", "tasks.png", "files.png"]) {
expect(readme).toContain(`src="docs/images/${shot}"`);
}
expect(readme).toContain("(docs/guide/getting-started.md)");
expect(readme).toContain("(LICENSE)");
// A relative image only renders when the file it names is in the repository.
- for (const image of ["map.png", "shape.png", "tasks.png"]) {
+ for (const image of ["map.png", "shape.png", "tasks.png", "files.png"]) {
await expect(
access(new URL(`../../../docs/images/${image}`, import.meta.url)),
).resolves.toBeUndefined();