Skip to content

T5.2: kt_sync_to_github hardened idempotent track-to-Issue sync (plus T5.1 verified) #23

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pjpoulose merged 14 commits into from
Sep 19, 2026
Merged

T5.2: kt_sync_to_github hardened idempotent track-to-Issue sync (plus T5.1 verified) #23

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
cb4ab0c
docs(roadmap): mark T5.1 credential-encryption verified done; unblock T5
pjpoulose Sep 19, 2026
91e4d8d
feat(t5.2): implement kt_sync_to_github (track->Issue, hardened idemp…
pjpoulose Sep 19, 2026
b3ef499
test(t5.2): unit + integration matrix for kt_sync_to_github
pjpoulose Sep 19, 2026
fabd779
docs(t5.2): reconcile ROADMAP/PRD/TRD/README/TEST_CASES to the shippe…
pjpoulose Sep 19, 2026
d662025
style(t5.2): apply prettier to github-client + sync-to-github
pjpoulose Sep 19, 2026
5e5c034
fix(t5.2): wrap migration 009 in BEGIN/COMMIT; guard down-migration
pjpoulose Sep 19, 2026
6ae89ec
test(t5.2): use a decryptable credential in the repo-changed test
pjpoulose Sep 19, 2026
90bb621
fix: address PR #23 review comments (round 1)
pjpoulose Sep 19, 2026
1708c9b
fix: never auto-recreate on a recovery marker-miss (round 2)
pjpoulose Sep 19, 2026
1d772f5
fix: address PR #23 Codex round-2 (malformed-JSON ambiguity, watermar…
pjpoulose Sep 19, 2026
414ad24
fix: guard 009 down-migration row-check when table already absent
pjpoulose Sep 19, 2026
6a5eca1
fix: harden issue-payload rendering (marker injection, truncation not…
pjpoulose Sep 19, 2026
938b2e2
fix: method-aware malformed-JSON ambiguity; document update-concurren…
pjpoulose Sep 19, 2026
0de87b8
fix: enforce title cap after escaping; finish PRD github-stub cleanup
pjpoulose Sep 19, 2026
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
51 changes: 27 additions & 24 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,18 @@ harness — not just one vendor's tool.

## Status

Pre-release, v0.1.0. 11 of the 14 planned tools are fully implemented and
dogfooded (KnoTrack tracks its own build using itself — see
Pre-release, v0.1.0. 12 of the 14 planned tools are fully implemented; 11 of
those are dogfooded (KnoTrack tracks its own build using itself — see
[`scripts/seed-self.ts`](scripts/seed-self.ts) and `docs/ROADMAP.md`'s T1).
The remaining 3 ship as stub slices (2026-09-18, T2.11/T2.13/T2.14) — not
yet usable end to end: `kt_check_drift` returns a well-formed empty scan
(real drift heuristics land in T6), and the two sync tools validate their
inputs and the adapter precondition, returning a clear `CONFLICT`
("adapter not configured") or — once an adapter is configured — a "sync is
not available in this build" error; full GitHub/Linear sync ships in T5.
`kt_sync_to_github` is implemented as of T5.2 (2026-09-19) — idempotent
one-way sync of a track to a GitHub Issue — and **offline-verified**, but not
yet dogfooded: a real-repo dogfood run is its one remaining gate. The
remaining 2 ship as stub
slices: `kt_check_drift` returns a well-formed empty scan (real drift
heuristics land in T6), and `kt_sync_to_linear` validates its inputs and
the adapter precondition, returning a clear `CONFLICT` ("adapter not
configured") or — once an adapter is configured — a "sync is not available
in this build" error; Linear sync ships in T5.3.

Every change lands through a mandatory adversarial-review gate before it's
considered reviewed: deterministic checks (build, lint, typecheck, unit,
Expand All @@ -40,22 +43,22 @@ include full diffs and raw model output.

## Tools

| Tool | Status | Purpose |
| --------------------------- | ----------- | --------------------------------------------------------------------------------------- |
| `kt_register_project` | implemented | Register (or upsert) a project by its source (`github`, `local`, etc.) |
| `kt_get_project_status` | implemented | Current status summary: tracks, items, drift flags |
| `kt_create_track` | implemented | Create a track (a sequenced line of work) under a project |
| `kt_create_item` | implemented | Create an item within a track, auto- or explicitly-sequenced |
| `kt_record_session_summary` | implemented | Record a session's summary and re-check for drift |
| `kt_list_tracks` | implemented | List a project's tracks, optionally filtered by status |
| `kt_get_track` | implemented | Track detail: items plus dependency graph |
| `kt_get_next_steps` | implemented | Suggested next items given current status and dependencies |
| `kt_record_decision` | implemented | Record a decision and the context behind it |
| `kt_update_item_status` | implemented | Move an item's status forward (or flag it blocked) |
| `kt_check_drift` | stub | On-demand drift scan (T2.11 stub: empty scan until heuristics ship in T6) |
| `kt_render_roadmap` | implemented | Render a roadmap view from tracked items |
| `kt_sync_to_github` | stub | One-way sync to GitHub Issues (T2.13 stub: adapter precondition only; sync ships in T5) |
| `kt_sync_to_linear` | stub | One-way sync to Linear (T2.14 stub: adapter precondition only; sync ships in T5) |
| Tool | Status | Purpose |
| --------------------------- | ----------- | ------------------------------------------------------------------------------------------- |
| `kt_register_project` | implemented | Register (or upsert) a project by its source (`github`, `local`, etc.) |
| `kt_get_project_status` | implemented | Current status summary: tracks, items, drift flags |
| `kt_create_track` | implemented | Create a track (a sequenced line of work) under a project |
| `kt_create_item` | implemented | Create an item within a track, auto- or explicitly-sequenced |
| `kt_record_session_summary` | implemented | Record a session's summary and re-check for drift |
| `kt_list_tracks` | implemented | List a project's tracks, optionally filtered by status |
| `kt_get_track` | implemented | Track detail: items plus dependency graph |
| `kt_get_next_steps` | implemented | Suggested next items given current status and dependencies |
| `kt_record_decision` | implemented | Record a decision and the context behind it |
| `kt_update_item_status` | implemented | Move an item's status forward (or flag it blocked) |
| `kt_check_drift` | stub | On-demand drift scan (T2.11 stub: empty scan until heuristics ship in T6) |
| `kt_render_roadmap` | implemented | Render a roadmap view from tracked items |
| `kt_sync_to_github` | implemented | One-way idempotent sync of a track to a GitHub Issue (T5.2; real-repo dogfood gate pending) |
| `kt_sync_to_linear` | stub | One-way sync to Linear (T2.14 stub: adapter precondition only; sync ships in T5.3) |

Full request/response contracts for every tool, implemented or planned,
are in [`docs/TRD.md`](docs/TRD.md).
Expand Down
Loading
Loading