Skip to content

Add SDLC pointer manager and guarded-run wrapper (closes #19)#20

Merged
jmjava merged 1 commit into
mainfrom
cursor/sdlc-pointer-guarded-run-1978
Jun 27, 2026
Merged

Add SDLC pointer manager and guarded-run wrapper (closes #19)#20
jmjava merged 1 commit into
mainfrom
cursor/sdlc-pointer-guarded-run-1978

Conversation

@jmjava

@jmjava jmjava commented Jun 27, 2026

Copy link
Copy Markdown
Owner

Summary

Implements #19: a persistent SDLC chore/task pointer with guarded execution wrappers so agents refuse to run commands against the wrong Work ID.

Added

  • agent-context/sdlc-pointer.sh — pointer get/set/reset, run_against_pointer, and CLI aliases (set, get, reset, init, run, plus /sdlc-set-pointer style names)
  • Pointer state stored in .sdlc/pointer (gitignored as local agent state)
  • flock-backed reads/writes with atomic temp-file fallback when flock is unavailable
  • Safer quoting than the issue draft (pointer values passed via bash -c args instead of interpolated into flock command strings)

Wired into framework

  • init-project.sh / upgrade-project.sh — ship the script to target projects
  • start-agent-session.sh — sets the pointer when --work-id is provided
  • verify-project-install.sh — checks for executable agent-context/sdlc-pointer.sh
  • agent-context/README.md — usage snippet and examples

Tests

  • tests/test-sdlc-pointer.sh — CLI round-trip, guarded run, sdlc_init override, session integration, init install
  • .github/workflows/test-sdlc-pointer.yml — CI regression gate

REASONS Canvas

  • Work ID: n/a (framework infrastructure)
  • Canvas path: n/a

Checklist

  • Canvas updated or synced — n/a
  • One operation per coding session respected
  • Tests added or updated
  • Review completed
  • Safeguards respected
  • CI gates pass (validate-command-adapters, test-adapter-install, validate-canvas, validate-diagrams, test-sdlc-pointer)
  • If command/prompt adapter files changed, ran adapter parity validation — n/a

Manual Smoke (Required for high-risk changes)

  • Manual chat smoke executed — not required; shell-only infrastructure change
  • verify-agent-command-effects.sh — n/a
  • Milestone/session-notes sync — n/a

Test Plan

  • ./tests/test-sdlc-pointer.sh (7 assertions, all passing locally)
  • bash -n on modified shell scripts
Open in Web Open in Cursor 

Implements issue #19: persistent chore/task pointer stored in .sdlc/pointer
with flock-backed reads/writes, run_against_pointer guard, and CLI aliases
(/sdlc-set-pointer, /sdlc-get-pointer, etc.).

- Add agent-context/sdlc-pointer.sh with safer quoting than the draft
- Document usage in agent-context/README.md
- Wire into init/upgrade, start-agent-session (--work-id), and install verify
- Ignore .sdlc/ as local agent state
- Add regression tests and CI workflow

Co-authored-by: John Menke <jmjava@gmail.com>
@jmjava jmjava marked this pull request as ready for review June 27, 2026 12:22
@jmjava jmjava merged commit 1d3bb63 into main Jun 27, 2026
7 checks passed
jmjava added a commit that referenced this pull request Jun 27, 2026
Add SDLC workflow + team registry on top of #20 (closes #19)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants