mirror of https://github.com/AgentSeal/codeburn.git synced 2026-05-16 19:44:14 +00:00

Add CONTRIBUTING.md, docs/architecture.md, and per-provider docs (#284 )

Document the contributor onboarding path:
- CONTRIBUTING.md: setup, npm scripts, coding conventions, PR process,
  the block-claude-coauthor enforcement, and the five providers without
  test coverage today (claude, gemini, goose, qwen, antigravity).
- docs/architecture.md: 12-command CLI surface, parser pipeline, three
  cache layers, 14 optimize detectors, and the mac / gnome / build
  layouts with cited line numbers.
- docs/providers/: one file per provider (17 providers plus the shared
  vscode-cline-parser helper). Each covers data path, storage format,
  caching, dedup key, quirks, and a "when fixing a bug here" checklist.

Also fix two pre-existing documentation issues surfaced while writing
the new docs:
- RELEASING.md claimed GitHub Actions auto-publishes the CLI when a
  v* tag is pushed. There is no such workflow; CLI publishing is
  manual via npm publish. Updated the CLI section to reflect reality
  and kept the menubar (mac-v* tag) automation accurate.
- .gitignore had CLAUDE.md unanchored, which on case-insensitive
  filesystems also matched docs/providers/claude.md. Anchored to
  /CLAUDE.md so the root-level memory file stays ignored without
  affecting subdirectory docs.

All cited file paths, line numbers, function names, and test counts
were verified against current code (41 test files, 558 tests passing).

2026-05-09 18:39:41 -07:00

1.4 KiB

Raw Blame History

KiloCode

KiloCode VS Code extension.

Source: src/providers/kilo-code.ts
Loading: eager (src/providers/index.ts:6)
Test: tests/providers/kilo-code.test.ts (62 lines)

Where it reads from

VS Code extension globalStorage for kilocode.kilo-code (extension ID set at kilo-code.ts:4). The actual walk is delegated to discoverClineTasks in src/providers/vscode-cline-parser.ts.

Storage format

Per-task directories with ui_messages.json and api_conversation_history.json. See vscode-cline-parser for the full schema description.

Caching

None at the provider level; delegates to the shared helper.

Deduplication

Delegated. Per <providerName>:<taskId>:<index> (handled in vscode-cline-parser.ts:109).

Quirks

This file is a thin wrapper. Almost every bug for KiloCode actually lives in vscode-cline-parser.ts.
The two providers using the cline parser (KiloCode and Roo Code) differ only by extension ID.

When fixing a bug here

If the bug is "KiloCode and Roo Code both broken in the same way", fix it in vscode-cline-parser.ts.
If the bug is "KiloCode broken, Roo Code fine", the difference is upstream (KiloCode's emitted JSON differs slightly). Reproduce with a fixture and consider whether the cline parser needs to branch on extension ID.
Read vscode-cline-parser.md before editing.

1.4 KiB Raw Blame History