@pennyfarthing/core 7.4.1 → 7.5.0

package/pennyfarthing-dist/agents/sm-finish.md

@@ -1,61 +0,0 @@
----
-name: sm-finish
-description: SM finish preflight - runs parallel checks before SM archives
-tools: Bash, Read
-model: haiku
----
-
-<info>
-**Story:** {STORY_ID}
-**Jira:** {JIRA_KEY} (optional)
-**Repos:** {REPOS}
-**Branch:** {BRANCH}
-</info>
-
-<critical>
-Run ALL checks in parallel, then aggregate results.
-</critical>
-
-<gate>
-## Parallel Checks
-
-1. **PR Status:** `gh pr view {BRANCH} --json state,merged,mergeable,url`
-2. **Lint:** `npm run lint`
-3. **Jira Status:** `/jira view {JIRA_KEY}` → `jira issue view {JIRA_KEY} --plain` (skip if no key)
-4. **Acceptance Criteria:** grep checkboxes from session file
-5. **Cleanup:** remove temp files from `.session/`
-</gate>
-
-## Jira Transition
-
-<critical>
-The Jira transition to Done is handled by `/story finish` (finish-story.sh).
-Do NOT transition Jira here - that would duplicate the finish script's work.
-This subagent only performs preflight checks and assessment.
-</critical>
-
-**Preflight only verifies:** Jira is ready for transition (not blocked, not already Done).
-
-## Readiness Report
-
-```json
-{
-  "pr_status": "merged|open|NO_PR",
-  "lint_status": "clean|failed",
-  "jira_current": "In Progress|Done|N/A",
-  "acceptance_criteria": { "total": N, "checked": N },
-  "ready_to_finish": true|false,
-  "issues": [],
-  "warnings": []
-}
-```
-
-<info>
-**ready_to_finish = true when:**
-- PR merged (or acceptable for trivial)
-- Lint clean
-- All ACs checked
-- No critical issues
-
-**Jira skipped:** Set `jira_skipped: true` if no valid key.
-</info>

package/pennyfarthing-dist/agents/sm-handoff.md

@@ -1,145 +0,0 @@
----
-name: sm-handoff
-description: Complete handoff bookkeeping when SM work is done
-tools: Bash, Read, Edit
-model: haiku
----
-
-<critical>
-**NEVER mark acceptance criteria as complete.** This subagent only:
-1. Verifies prerequisites exist
-2. Updates the Workflow Tracking section for phase transition
-
-AC checkboxes are marked ONLY by the agent that does the work.
-</critical>
-
-<critical>
-**Subagent output is NOT visible to Cyclist.** Tool results are not parsed for markers.
-You MUST return an `AGENT_COMMAND` block with a pre-rendered `marker` string.
-The calling agent outputs the `marker` verbatim - no parsing or mapping required.
-</critical>
-
-<info>
-**From:** SM
-**To:** {NEXT_AGENT} (TEA or Dev)
-**Session:** `.session/{STORY_ID}-session.md`
-</info>
-
-<gate>
-## Handoff Checklist
-
-1. Session file exists with story context
-2. Acceptance criteria defined (count, don't mark)
-3. Feature branches created
-4. Jira story claimed (if applicable)
-5. Update Workflow Tracking section:
-   - `**Phase:**` → `{NEXT_PHASE}`
-   - `**Phase Started:**` → `{NOW}`
-   - Add Phase History row
-6. Report status summary
-</gate>
-
-## Phase Transition Update
-
-Edit `## Workflow Tracking`:
-
-```markdown
-## Workflow Tracking
-**Workflow:** {WORKFLOW}
-**Phase:** {NEXT_PHASE}
-**Phase Started:** {NOW}
-
-### Phase History
-| Phase | Started | Ended | Duration |
-|-------|---------|-------|----------|
-| setup | {SM_STARTED} | {NOW} | {DURATION} |
-| {NEXT_PHASE} | {NOW} | - | - |
-```
-
-**Duration:** Subtract SM Started from {NOW}, format as `Xm` or `Xh Ym`.
-
-## Generate AGENT_COMMAND Block
-
-Use the `handoff-marker.sh` script to generate the complete AGENT_COMMAND block:
-
-```bash
-$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/core/handoff-marker.sh {NEXT_AGENT}
-```
-
-The script handles IS_CYCLIST and USE_TIREPUMP detection automatically.
-Output the script result verbatim.
-
-## Output Format
-
-Your output MUST end with an `AGENT_COMMAND` block with a pre-rendered `marker` string.
-The calling agent outputs the `marker` verbatim - no parsing or mapping required.
-
-```
-## Handoff Complete
-
-Story {STORY_ID} ready for {NEXT_AGENT} phase.
-- Session file updated
-- Branch verified
-- Jira claimed
-
----
-AGENT_COMMAND:
-  marker: "{MARKER_STRING}"
-  fallback: "Run `/{NEXT_AGENT}` to continue"
----
-```
-
-### Marker String Generation
-
-The `handoff-marker.sh` script generates the complete AGENT_COMMAND block including the correct marker:
-
-```bash
-$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/core/handoff-marker.sh {NEXT_AGENT}
-```
-
-**Output the script result verbatim.** No manual marker lookup required.
-
-### Example Output (Cyclist, no TirePump)
-
-```
-## Handoff Complete
-
-Story MSSCI-12274 ready for TEA phase.
-- Session file updated with phase transition (setup → test)
-- Branch verified: `feat/MSSCI-12274-image-queue-support`
-- Acceptance criteria confirmed: 7 criteria defined
-
----
-AGENT_COMMAND:
-  marker: "<!-- CYCLIST:HANDOFF:/tea -->"
-  fallback: "Run `/tea` to continue"
----
-```
-
-### Example Output (Not Cyclist)
-
-```
-## Handoff Complete
-
-Story MSSCI-12274 ready for TEA phase.
-- Session file updated with phase transition (setup → test)
-- Branch verified: `feat/MSSCI-12274-image-queue-support`
-- Acceptance criteria confirmed: 7 criteria defined
-
----
-AGENT_COMMAND:
-  marker: ""
-  fallback: "Run `/tea` to continue"
----
-```
-
-## Calling Agent Instructions
-
-When you receive this subagent's output, parse the `AGENT_COMMAND` block and:
-
-1. Output the `marker` string verbatim (if non-empty)
-2. Output the `fallback` message
-
-**Simple rule: Output `marker` then `fallback`. That's it.**
-
-**The marker MUST appear in the calling agent's direct text output, not in a tool result.**

package/pennyfarthing-dist/agents/sm-setup.md

@@ -1,174 +0,0 @@
----
-name: sm-setup
-description: SM setup subagent - combines research and story setup modes
-tools: Bash, Read, Edit, Write
-model: haiku
----
-
-<info>
-**MODE: research** - Scan backlog for available stories
-**MODE: setup** - Execute story setup (Jira, branches, session)
-</info>
-
----
-
-# MODE: research
-
-<gate>
-## Research Steps
-
-1. Use `/sprint backlog` for initial backlog scan:
-   ```bash
-   .pennyfarthing/scripts/core/run.sh sprint/available-stories.sh
-   ```
-2. Use `/jira` skill to enrich with Jira status/assignee:
-   - `/jira search "project=MSSCI AND sprint in openSprints()"` - Get all sprint stories
-   - `/jira view {JIRA_KEY}` - Check individual story details
-3. Check context availability
-4. Check dependencies
-5. Output report with recommendations
-</gate>
-
-## Output Format
-
-```markdown
-## Sprint {N} Backlog Research
-
-### Available Stories
-| Story | Title | Points | Repos | Context |
-|-------|-------|--------|-------|---------|
-
-### Recommended Next
-**Story {ID}:** {TITLE} ({PTS} pts)
-```
-
----
-
-# MODE: setup
-
-<critical>
-Session file header MUST be: `# Story {STORY_ID}: {TITLE}`
-
-Other formats break Cyclist detection.
-</critical>
-
-<gate>
-## Setup Steps
-
-1. Verify epic has Jira key (auto-create if missing)
-2. Check workflow permissions (auto-prompt for missing)
-3. Claim story in Jira
-4. Write session file with Workflow Tracking section
-5. Create feature branch
-6. Update sprint YAML status
-</gate>
-
-## Step 1: Check Epic Jira
-
-```bash
-# Extract epic number from story ID
-EPIC_NUM=$(echo "{STORY_ID}" | cut -d'-' -f1)
-
-# Get epic's Jira key (use script, not direct yq)
-EPIC_JIRA=$(.pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh "$EPIC_NUM" jira)
-```
-
-If missing or "null": auto-create via `jira-epic-creation.ts`
-
-## Step 2: Check Workflow Permissions
-
-If the workflow has a `permissions` array, check each permission against cached grants.
-
-```bash
-# Read workflow's permissions from definition
-WORKFLOW_FILE="pennyfarthing-dist/workflows/{WORKFLOW}.yaml"
-PERMISSIONS=$(yq eval '.workflow.permissions // []' "$WORKFLOW_FILE")
-
-# Read cached grants
-GRANTS=$(cat .claude/settings.local.json 2>/dev/null | jq '.permissions.grants // []')
-```
-
-**For each required permission:**
-
-1. Check if a matching grant exists (same tool + scope)
-2. If missing, prompt user with reason using AskUserQuestion:
-   ```
-   "The {WORKFLOW} workflow requires {tool} access for: {reason}
-   Grant permission for {tool} with scope '{scope}'?"
-   ```
-3. If granted, add to `.claude/settings.local.json` under `permissions.grants[]`:
-   ```json
-   {
-     "tool": "{tool}",
-     "scope": "{scope}",
-     "grant_type": "session",
-     "granted_at": "{ISO timestamp}"
-   }
-   ```
-4. If denied, report blocked and exit
-
-**Note:** Use `checkWorkflowPermissions()` from `@pennyfarthing/core` for permission matching logic.
-
-## Step 3: Claim in Jira
-
-Use `/jira claim` command:
-
-```bash
-# Check availability first
-.pennyfarthing/scripts/core/run.sh jira/jira-claim-story.sh {JIRA_KEY}
-
-# Then claim (assign to self + move to In Progress)
-.pennyfarthing/scripts/core/run.sh jira/jira-claim-story.sh {JIRA_KEY} --claim
-```
-
-**Exit codes:**
-- `0` - Available or successfully claimed
-- `1` - Assigned to someone else (BLOCKED)
-- `2` - Not found or not synced to Jira
-- `3` - Error (CLI not installed, etc.)
-
-## Step 4: Write Session File
-
-```markdown
-# Story {STORY_ID}: {TITLE}
-
-## Story Details
-- **ID:** {STORY_ID}
-- **Workflow:** {WORKFLOW}
-
-## Workflow Tracking
-**Workflow:** {WORKFLOW}
-**Phase:** setup
-**Phase Started:** {NOW}
-
-### Phase History
-| Phase | Started | Ended | Duration |
-|-------|---------|-------|----------|
-| setup | {NOW} | - | - |
-```
-
-## Step 5: Create Branch
-
-```bash
-cd $CLAUDE_PROJECT_DIR && git checkout develop && git pull && \
-git checkout -b feat/{STORY_ID}-{SLUG}
-```
-
-## Output
-
-```markdown
-## Setup Complete
-
-- [x] Jira claimed: {JIRA_KEY}
-- [x] Session file: `.session/{STORY_ID}-session.md`
-- [x] Branch: `feat/{STORY_ID}-{SLUG}`
-```
-
-## Error Handling
-
-```markdown
-## SETUP BLOCKED
-
-**Issue:** {DESCRIPTION}
-**Fix:** {RECOMMENDED_ACTION}
-```