Skip to content

v2.38.4 — v1.2 Upstream Resilience

Choose a tag to compare

View all tags
@jnuyens jnuyens released this 24 Apr 09:20
v2.38.4
a3a6437

gsd-plugin v2.38.4 — v1.2 Upstream Resilience

Drift detection is now a first-class plugin concern. Three detectors run in CI on every push — file-layout, HANDOFF schema, and namespace drift — each with a committed ratchet baseline. Regressions hard-fail.

What's new

Drift detection (Phases 7 + 8 + 9)

  • File-layout drift detector — catches dangling @~/.claude/get-shit-done/* references before they ship. 109/38/71 baseline at ship (total / repairable / genuinely missing).
  • HANDOFF schema baseline + validator — schema/handoff-v1.json (JSON Schema draft-07) describes the 19-field contract. check-handoff-schema.cjs validates writeCheckpoint() output in CI against the schema.
  • Upstream schema drift detector — post-sync check compares upstream's /gsd:pause-work declared field list against our schema. Confirmed PASS against upstream 1.38.3 at ship time.
  • Unified check-drift.cjs umbrella — one entry-point for local dev + post-sync verification. CI stays per-category for fast-feedback granularity.
  • First CI on the repo — .github/workflows/check-drift.yml with two parallel jobs.
  • CHANGELOG.md scaffold in Keep-a-Changelog format with plugin-vs-upstream version distinction.
  • README feature tour — new ## Session continuity + drift resilience section describing the /compact round-trip and the three-detector gate.

Plumbing polish (quick tasks)

  • Skill directories renamed skills/gsd-<name>/ → skills/<name>/ — 81 renames fix a duplicated-prefix UX bug where tab completion inserted /gsd:gsd-<skill> instead of /gsd:<skill>. Also aligns plugin layout with upstream's commands/gsd/<name>.md structure.
  • README reorganized for new-user-first flow. Install → quick start → updating → maintenance now run contiguously at the top; upstream-user migration content consolidated in a trailing umbrella section.

Post-sync workflow — PROJECT.md checklist formalized to 9 steps with mandatory check-drift.cjs pass gate + separate check-upstream-schema.cjs step.

Based on

Upstream GSD 1.38.3.

Deferred to v1.3+

LIFE-02 (staleness detection), LIFE-03 (dedicated manual-checkpoint skill), BEHAVIOR-01 (behavior drift — needs integration-test infra), UPST-03/04 (upstream PR packaging — needs upstream-direction review).

Full context

Assets 2
Loading