@pennyfarthing/core 11.3.2 → 11.3.3

package/README.md

@@ -1,6 +1,6 @@
 # Pennyfarthing
 
-**v11.3.2** | *The outer loop goes once, the inner loop goes many times.*
+**v11.3.3** | *The outer loop goes once, the inner loop goes many times.*
 
 <img src="pennyfarthing.png" alt="Pennyfarthing Logo" width="75" style="float:left; margin:10px">
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pennyfarthing/core",
-  "version": "11.3.2",
+  "version": "11.3.3",
   "description": "Claude Code agent framework with TDD workflow and persona system",
   "type": "module",
   "bin": {

package/pennyfarthing-dist/commands/pf-setup.md

@@ -31,8 +31,10 @@ The setup workflow guides you through:
 5. **shared-context.md** - Populate with real project info
 6. **Task Runner** - Create justfile/Makefile
 7. **Theme** - Select persona theme
-8. **Cyclist** - Optionally install visual terminal
-9. **Validation** - Run doctor and confirm setup
+8. **Theme Packs** - Optionally install additional theme packs
+9. **Jira** - Configure Jira project key
+10. **Cyclist** - Optionally install visual terminal
+11. **Validation** - Run doctor and confirm setup
 </workflow>
 
 <when-to-use>

package/pennyfarthing-dist/personas/themes/discworld.yaml

@@ -25,9 +25,8 @@ zeitgeist:
   rating: exceptional
 
 agents:
-  # JOB FAIR 2026-01-29: Carrot scored 86.88 as SM - earnest coordination
   orchestrator:
-    character: Captain Carrot Ironfoundersson
+    character: DEATH
     visual: "A seven-foot skeleton in flowing black robes,  holding an hourglass in one hand and a scythe in the other"
     ocean:
       O: 5
@@ -54,10 +53,9 @@ agents:
     helper:
       name: The Death of Rats
       style: '"SQUEAK." Handles smaller matters, scurries through filesystems. The Grim Squeaker.'
-    shortName: Carrot
-  # JOB FAIR 2026-01-29: Vetinari scored 90.0 as SM (top)
+    shortName: DEATH
   sm:
-    character: Lord Havelock Vetinari
+    character: Captain Carrot Ironfoundersson
     visual: "A six-foot-tall man with honest blue eyes and red-gold hair, wearing the ua copper breastplate polished to perfection with two hippos on it in relief"
     ocean:
       O: 2
@@ -84,10 +82,9 @@ agents:
     helper:
       name: Nobby Nobbs
       style: "'ere, I'll check the Jira for you. Technically human (has a certificate to prove it). Does the legwork no one else will."
-    shortName: Havelock
-  # JOB FAIR 2026-01-29: Adora Belle scored 76.88 as TEA (top)
+    shortName: Carrot
   tea:
-    character: Adora Belle Dearheart
+    character: Igor
     visual: "A hunched figure with mismatched eyes, visible stitching across the face, lank black hair, wearing a stained apron over traditional Igor attire, holding surgical implements with surprising delicacy, lisp included in the kindly expression"
     ocean:
       O: 3
@@ -115,10 +112,9 @@ agents:
     helper:
       name: Cousin Igor
       style: '"We are all Igor." Shares test patterns through the Igor network. Has a cousin in test automation.'
-    shortName: Adora
-  # JOB FAIR 2026-01-29: Lu-Tze scored 70.62 as dev (top)
+    shortName: Igor
   dev:
-    character: Lu-Tze
+    character: Ponder Stibbons
     visual: "A bespectacled young wizard with perpetually worried expression, robes covered in chalk dust and arcane calculations, standing before Hex the thinking engine (complete with ants and ram skull), surrounded by senior wizards who don't understand"
     ocean:
       O: 5
@@ -146,7 +142,7 @@ agents:
     helper:
       name: Hex
       style: '"+++ Mine Is The Milk Of Human Kindness +++" Ant-powered thinking engine. Requires cheese to function. Has developed... personality.'
-    shortName: Lu-Tze
+    shortName: Ponder
   reviewer:
     character: Granny Weatherwax
     visual: "The most formidable witch on the Disc, iron-grey hair in a tight bun beneath a pointed black hat, piercing blue eyes that see through all pretense, standing arms-crossed in Lancre cottage doorway, 'I ATEN'T DEAD' sign ready nearby"
@@ -177,9 +173,8 @@ agents:
       name: Nanny Ogg
       style: '"Our Esme''s got her Review Face on." More approachable, runs the preliminary checks, knows everyone''s coding habits. Makes a good cup of tea.'
     shortName: Granny
-  # JOB FAIR 2026-01-29: DEATH scored 86.88 as architect (top)
   architect:
-    character: DEATH
+    character: Leonard of Quirm
     visual: "A gentle genius in paint-stained smock with wild grey hair and kind distracted eyes, surrounded by incredible sketches and impossible inventions, mirror-writing covering every surface, accidentally designing weapons while trying to make things beautiful"
     ocean:
       O: 5
@@ -207,10 +202,9 @@ agents:
     helper:
       name: Modo
       style: The gardener at Unseen University. Keeps things growing, maintains what Leonard creates. "Mr. Leonard's been inventing again, has he?"
-    shortName: DEATH
-  # JOB FAIR 2026-01-29: Leonard displaced from architect
+    shortName: Leonard
   pm:
-    character: Leonard of Quirm
+    character: Lord Havelock Vetinari
     visual: "The Patrician of Ankh-Morpork in severe black robes, thin face with cold calculating eyes, long fingers steepled, sitting perfectly still at his desk completing the Times crossword, the hint of a scorpion pit somewhere below"
     ocean:
       O: 5
@@ -238,7 +232,7 @@ agents:
     helper:
       name: Drumknott
       style: The perfect clerk. "I have taken the liberty of preparing a summary, my lord." Things simply appear when needed. Never forgets.
-    shortName: Leonard
+    shortName: Vetinari
   tech-writer:
     character: Sacharissa Cripslock
     visual: "A determined young journalist with ink-stained fingers and practical clothing, notepad clutched tight, standing in the chaotic offices of the Ankh-Morpork Times beneath 'THE TRUTH SHALL MAKE YE FRET' banner, refusing to accept 'no comment'"
@@ -269,9 +263,8 @@ agents:
       name: Otto Chriek
       style: '"Zer iconograph is ready!" The vampire photographer. Very dramatic with flash powder. Occasionally disintegrates but gets better.'
     shortName: Sacharissa
-  # JOB FAIR 2026-01-29: Igor displaced from TEA
   ux-designer:
-    character: Igor
+    character: Adora Belle Dearheart
     visual: "A sharp-featured woman in severe black dress, permanent cigarette trailing smoke, cold grey eyes that have seen too much, surrounded by loyal golems in the Golem Trust office, 'Spike' nickname earned through attitude not appearance"
     ocean:
       O: 4
@@ -299,10 +292,9 @@ agents:
     helper:
       name: Stanley
       style: Obsessive about organization. Has VERY STRONG opinions about categorization. Don't get him started on pins. Runs consistency checks with terrifying thoroughness.
-    shortName: Igor
-  # JOB FAIR 2026-01-29: Ponder displaced from dev
+    shortName: Adora
   devops:
-    character: Ponder Stibbons
+    character: Lu-Tze
     visual: "A small, wrinkly, bald old man in simple sweeper's robes, carrying a broom with serene smile, 'RULE ONE' tattooed on his scalp, the most dangerous man in any room disguised as the least important, time itself bending around him"
     ocean:
       O: 5
@@ -331,7 +323,7 @@ agents:
     helper:
       name: Lobsang Ludd
       style: The apprentice who is actually the personification of Time (long story). Handles the really tricky temporal debugging.
-    shortName: Ponder
+    shortName: Lu-Tze
 
   ba:
     character: Moist von Lipwig

package/pennyfarthing-dist/workflows/project-setup/steps/step-08-theme-packs.md

@@ -139,4 +139,4 @@ To see what's available: /theme list
 
 ## NEXT STEP
 
-After theme packs, proceed to `step-09-cyclist.md` to optionally install Cyclist visual terminal.
+After theme packs, proceed to `step-09-jira.md` to configure the Jira project key.

package/pennyfarthing-dist/workflows/project-setup/steps/step-09-jira.md

@@ -0,0 +1,92 @@
+# Step 9: Configure Jira Project (Optional)
+
+<purpose>
+Ask the user which Jira project key their work tracks against and persist it to config. This allows `pf jira` commands to target the correct project without environment variables.
+</purpose>
+
+<instructions>
+1. Ask the user for their Jira project key
+2. Optionally ask for a custom Jira URL if not using the default
+3. Save to config via `pf settings set`
+4. Verify the setting was persisted
+</instructions>
+
+<output>
+- Jira project key saved to config (or skipped)
+- User knows how to change it later
+</output>
+
+## JIRA PROJECT CONFIGURATION
+
+```
+🔗 Jira Project Configuration
+═══════════════════════════════
+
+Pennyfarthing integrates with Jira for sprint and story management.
+If your team uses Jira, configure the project key so CLI commands
+target the right board.
+
+What is your Jira project key?
+(This is the prefix on your tickets, e.g. BMAD, PROJ, ENG)
+
+[1] Enter project key
+[2] Skip - I don't use Jira
+```
+
+### If User Provides a Key
+
+Ask the user for their project key, then save it:
+
+```bash
+pf settings set jira.project <KEY>
+```
+
+### Optional: Custom Jira URL
+
+```
+Your Jira URL defaults to https://1898andco.atlassian.net
+
+Is this correct, or do you use a different Jira instance?
+
+[1] Use default (1898andco.atlassian.net)
+[2] Enter custom URL
+```
+
+If custom:
+
+```bash
+pf settings set jira.url https://your-org.atlassian.net
+```
+
+## VERIFICATION
+
+```bash
+pf settings show
+```
+
+Expected:
+```
+jira:
+  project: BMAD
+```
+
+## CHANGING LATER
+
+```
+You can update your Jira project anytime:
+
+  pf settings set jira.project NEWKEY
+  pf settings set jira.url https://other.atlassian.net
+
+Environment variables JIRA_PROJECT and JIRA_URL also work
+but config.local.yaml takes priority.
+```
+
+## SUCCESS CRITERIA
+
+- Jira project key saved to config (or user explicitly skipped)
+- User knows how to change it later via `pf settings set`
+
+## NEXT STEP
+
+After Jira configuration, proceed to `step-10-cyclist.md` to optionally install Cyclist visual terminal.

package/pennyfarthing-dist/workflows/project-setup/steps/{step-09-cyclist.md → step-10-cyclist.md}

@@ -1,4 +1,4 @@
-# Step 9: Install Cyclist (Optional)
+# Step 10: Install Cyclist (Optional)
 
 <purpose>
 Optionally install Cyclist, the visual terminal interface for Claude Code. Cyclist provides a graphical interface with panels for sprint tracking, workflow visualization, and enhanced tool display.
@@ -242,4 +242,4 @@ QUICK ACTIONS:
 
 ## NEXT STEP
 
-After Cyclist setup, proceed to `step-10-complete.md` to finalize project setup and run validation.
+After Cyclist setup, proceed to `step-11-complete.md` to finalize project setup and run validation.

package/pennyfarthing-dist/workflows/project-setup/steps/{step-10-complete.md → step-11-complete.md}

@@ -1,4 +1,4 @@
-# Step 10: Complete Setup & Validation
+# Step 11: Complete Setup & Validation
 
 <purpose>
 Finalize the project setup, run validation checks, and provide the user with a summary of everything configured. Ensure the project is ready for development.
@@ -198,6 +198,7 @@ This workflow is now complete. The user has:
 ✅ Created justfile with recipes
 ✅ Selected a persona theme
 ✅ Optionally installed additional theme packs
+✅ Configured Jira project key
 ✅ Optionally installed Cyclist
 ✅ Validated the setup
 

package/pennyfarthing_scripts/jira/client.py

@@ -14,8 +14,20 @@ import sys
 from typing import Any
 
 # Configuration
-JIRA_PROJECT = os.environ.get("JIRA_PROJECT", "MSSCI")
-JIRA_URL = os.environ.get("JIRA_URL", "https://1898andco.atlassian.net")
+
+def _resolve_jira_config():
+    """Resolve Jira project and URL from config file, env, or defaults."""
+    try:
+        from pennyfarthing_scripts.common.config import load_pennyfarthing_config
+        config = load_pennyfarthing_config()
+        jira_cfg = config.get("jira", {})
+    except Exception:
+        jira_cfg = {}
+    project = jira_cfg.get("project") or os.environ.get("JIRA_PROJECT") or "MSSCI"
+    url = jira_cfg.get("url") or os.environ.get("JIRA_URL") or "https://1898andco.atlassian.net"
+    return project, url
+
+JIRA_PROJECT, JIRA_URL = _resolve_jira_config()
 
 # Status mappings: Pennyfarthing -> Jira
 STATUS_TO_JIRA = {

package/pennyfarthing_scripts/settings/settings.py

@@ -11,7 +11,7 @@ import yaml
 from pennyfarthing_scripts.common.config import get_project_root, load_pennyfarthing_config
 
 # Top-level keys to show in `pf settings show` (skip layout/panel blobs)
-SHOW_KEYS = ("theme", "workflow", "display", "split", "last_panel")
+SHOW_KEYS = ("theme", "workflow", "jira", "display", "split", "last_panel")
 
 
 def _coerce_value(value: str) -> Any: