Repository navigation
Docs: sweep for accuracy after 0.18 - #18
Merged
Merged
Conversation
Rewrite or correct every document against the code as it is now: time tracking lives in devlog-time (no Tracker in the app), storage format 4, blocks as a tree with pages, node types, extension API 1.7, the Timesheet and Summary as extension pages, destinations reached through the app, quiet paths for activity/ and extensions/. - docs/EXTENSIONS.md: restructured as a reference for the model as built. - docs/DESIGN.md: process model, storage layout, blocks, canvases and node types, time and the activity log, review, auto-update, editor, sync, and a short Extensions section. - docs/TIME-EXTENSION.md, TIMESHEETS.md, BLOCK-PAGES.md: status and details brought up to date. - README.md, packages/*/README.md, builtin-extensions/README.md: stale UI names, shortcuts, file layout and API tables fixed. - Code comments in manifest.ts and canvases.ts that still said format 3. - package.json: package* and screens now run `npm run build`, so the built-in extensions are bundled when packaging from a fresh clone. - Use a synthetic client name in the hour-targets example and test. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CAgWUf68JDhC5YPtWj1zT6
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A documentation sweep after 0.18.0. Every document was checked against the code and rewritten or corrected where it had drifted. Time tracking now lives in devlog-time (the app has no Tracker), storage is format 4, blocks form a tree that opens as pages, and canvases have node types. The docs also now cover extension API 1.7, the Timesheet and Summary as extension pages, and destinations reached through the app.
Rewritten
docs/EXTENSIONS.md: now a reference for the model as built. It covers the manifest, the lockfile, consent/grants/trust, settings and secrets, the sandbox limits, and what an extension can do by topic, with API version tags. It ends with a list of what is not built yet.docs/TIME-EXTENSION.md: describes the finished state. It has a table of what belongs to devlog-time versus the app, what each API version (1.5–1.7) added, the data layout, and hour targets.docs/DESIGN.md:devlog.lock.json,extensions/<id>/, andtodos.mdremoved.Corrected
docs/TIMESHEETS.md,docs/BLOCK-PAGES.md,README.md: UI names, shortcuts, the repository layout, the Summary as a page, and the release procedure.packages/core/README.md,packages/extension-api/README.md: the API table now covers everything up to 1.7 and the testing section lists the harness helpers.builtin-extensions/README.mdand the devlog-focus manifest description are also corrected.packages/core/src/node/manifest.tsandpackages/core/src/format/canvases.tsthat still said storage format 3.Not only docs
package.json:package,package:mac,package:win,package:linuxandscreensnow runnpm run buildinstead ofelectron-vite build. Before, packaging from a fresh clone skipped bundling the built-in extensions. CI already rannpm run buildand is unaffected.docs/TIME-EXTENSION.mdandtests/devlog-time.test.tsnow uses a made-up client name.Checks
npm run typecheckpasses.npx vitest run: all 231 tests pass.🤖 Generated with Claude Code
https://claude.ai/code/session_01CAgWUf68JDhC5YPtWj1zT6
Generated by Claude Code