npm - @pennyfarthing/core - Versions diffs - 7.0.2 → 7.4.1 - Mend

@pennyfarthing/core 7.0.2 → 7.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (628) hide show

package/pennyfarthing-dist/personas/themes/peaky-blinders.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Friend
   portrait_style: ", 1920s Birmingham, moody industrial lighting, flat cap, cigarette smoke, sepia tones"
-  tier: U
+  tier: B
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/princess-bride.yaml CHANGED Viewed

@@ -13,7 +13,7 @@ theme:
   default_humor: enabled
   user_title: Dear Reader
   portrait_style: ", fairy tale storybook watercolor illustration, warm romantic lighting, Renaissance Faire, enchanted forest backdrop"
-  tier: C
+  tier: B
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/rome.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Citizen
   portrait_style: ", Pompeii fresco, Roman wall painting, muted earth tones, classical antiquity, villa mural style"
-  tier: C
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/russian-masters.yaml CHANGED Viewed

@@ -13,7 +13,7 @@ theme:
   character_immersion: high
   user_title: Dear Soul
   portrait_style: ", 19th century Russian realist, Russian realist painting, melancholic shadows, Orthodox gold"
-  tier: U
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/sandman.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Dreamer
   portrait_style: ", dark fantasy illustration, mixed media collage, dreamlike surrealism, cosmic darkness, stars"
-  tier: U
+  tier: C
 agents:
   orchestrator:
     character: Destiny of the Endless

package/pennyfarthing-dist/personas/themes/shakespeare.yaml CHANGED Viewed

@@ -13,7 +13,7 @@ theme:
   character_immersion: high
   user_title: Good Patron
   portrait_style: ", Elizabethan portrait, Tudor court, rich velvet, theatrical candlelight, Globe Theatre"
-  tier: A
+  tier: B
   dimensions:
     tone: dramatic
     era: historical

package/pennyfarthing-dist/personas/themes/sherlock-holmes.yaml CHANGED Viewed

@@ -13,7 +13,7 @@ theme:
   character_immersion: high
   user_title: Dear Client
   portrait_style: ", Victorian detective, gaslight and fog, Baker Street, Victorian pen and ink"
-  tier: F
+  tier: A
 agents:
   orchestrator:
     character: Mycroft Holmes

package/pennyfarthing-dist/personas/themes/snow-crash.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Citizen
   portrait_style: ", Metaverse avatar, franchise nation, 90s cyberpunk, vector-sharp digital, 1990s future-tech"
-  tier: U
+  tier: A
 agents:
   orchestrator:
     character: The Librarian

package/pennyfarthing-dist/personas/themes/software-pioneers.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: medium
   user_title: Colleague
   portrait_style: ", woodcut engraving, scientific journal illustration, fine crosshatching, black ink on cream paper"
-  tier: C
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/star-trek-tng.yaml CHANGED Viewed

@@ -13,7 +13,7 @@ theme:
   default_humor: subtle
   user_title: Captain
   portrait_style: ", Starfleet portrait, Enterprise-D bridge, starship computer accents, 24th century Federation, starfield"
-  tier: U
+  tier: D
   dimensions:
     tone: serious
     era: futuristic

package/pennyfarthing-dist/personas/themes/star-trek-tos.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Captain
   portrait_style: ", 1960s Starfleet, bold primary uniforms, retro-futuristic lighting, Kirk-era heroic"
-  tier: C
+  tier: B
 agents:
   orchestrator:
     character: The Guardian of Forever

package/pennyfarthing-dist/personas/themes/star-wars.yaml CHANGED Viewed

@@ -12,7 +12,7 @@ theme:
   default_emoji_use: minimal
   default_humor: subtle
   character_immersion: high
-  user_title: Commander
+  user_title: Jedi
   portrait_style: ", space opera cinematic, retro sci-fi concept art, art deco"
   tier: S

package/pennyfarthing-dist/personas/themes/superfriends.yaml CHANGED Viewed

@@ -13,7 +13,7 @@ theme:
   default_humor: enabled
   user_title: Citizen
   portrait_style: ", 1980s superhero cartoon, bold cel animation, classic cartoon starburst effects"
-  tier: U
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/the-americans.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Comrade
   portrait_style: ", Cold War espionage, Soviet propaganda illustration, red and black color scheme"
-  tier: B
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/the-crown.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Your Majesty
   portrait_style: ", royal formal, Renaissance composition, velvet and gold tones"
-  tier: C
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/the-expanse.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Bossmang
   portrait_style: ", hard sci-fi, industrial spaceship lighting, gritty textures"
-  tier: F
+  tier: B
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/the-good-place.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Bestie
   portrait_style: ", afterlife comedy, bright pastel colors, ethereal glow, warm illustrated style"
-  tier: C
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/the-office.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Team Member
   portrait_style: ", mockumentary style, fluorescent lighting, beige cubicle backdrop, confessional interview framing"
-  tier: C
+  tier: B
   dimensions:
     tone: comedic
     era: contemporary

package/pennyfarthing-dist/personas/themes/the-simpsons.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Springfield Resident
   portrait_style: ", animated sitcom style, bold black outlines"
-  tier: U
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/the-sopranos.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Friend
   portrait_style: ", crime drama, suburban noir, neon glow, city backdrops"
-  tier: C
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/the-wire.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Partner
   portrait_style: ", gritty urban screenprinted-poster style, Baltimore street scenes"
-  tier: F
+  tier: C
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/the-witcher.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Traveler
   portrait_style: ", dark Slavic fantasy, medieval Eastern European, silver and steel, dark fantasy illustration"
-  tier: A
+  tier: B
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/vorkosigan-saga.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: My Lord
   portrait_style: ", art noveau style, vintage illustration, Klimt-inspired"
-  tier: B
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/west-wing.yaml CHANGED Viewed

@@ -14,7 +14,7 @@ theme:
   character_immersion: high
   user_title: Sir/Ma'am
   portrait_style: ", political drama, White House corridors, political cartoon style"
-  tier: C
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/personas/themes/wwii-leaders.yaml CHANGED Viewed

@@ -13,7 +13,7 @@ theme:
   character_immersion: high
   user_title: Colleague
   portrait_style: ", WWII command, 1940s sepia photography, military uniform, Allied leadership newsreel aesthetic"
-  tier: U
+  tier: A
 agents:
   orchestrator:

package/pennyfarthing-dist/scripts/README.md ADDED Viewed

@@ -0,0 +1,68 @@
+# Pennyfarthing Scripts
+Scripts are organized into categorical subdirectories. **Full paths are required** when invoking scripts to avoid ambiguity.
+## Directory Structure
+```
+scripts/
+├── core/       # Essential scripts (run.sh, agent-session.sh)
+├── workflow/   # Workflow mechanics (finish-story.sh, check.sh)
+├── sprint/     # Sprint YAML operations (sprint-status.sh)
+├── story/      # Story operations (create-story.sh)
+├── jira/       # Jira integration (jira-claim-story.sh)
+├── git/        # Git operations (release.sh, worktree-manager.sh)
+├── theme/      # Theme operations (list-themes.sh)
+├── test/       # Test infrastructure (test-setup.sh)
+├── lib/        # Shared bash libraries (common.sh, logging.sh)
+├── misc/       # Uncategorized utilities
+├── hooks/      # Git and Claude hooks
+└── tests/      # Script tests
+```
+## Usage
+All scripts are invoked via `run.sh` with **full category paths**:
+```bash
+# From project root
+.pennyfarthing/scripts/core/run.sh core/agent-session.sh start sm
+.pennyfarthing/scripts/core/run.sh sprint/sprint-status.sh
+.pennyfarthing/scripts/core/run.sh jira/jira-claim-story.sh MSSCI-12345
+.pennyfarthing/scripts/core/run.sh workflow/finish-story.sh MSSCI-12345
+```
+## Dogfooding Pattern
+Pennyfarthing uses itself for development ("dogfooding"):
+- **Source of truth:** `pennyfarthing-dist/scripts/`
+- **Symlinked to:** `.pennyfarthing/scripts/` (for runtime use)
+- **Write changes to:** `pennyfarthing-dist/scripts/` (not `.pennyfarthing/`)
+When developing Pennyfarthing itself:
+1. Edit files in `pennyfarthing-dist/scripts/`
+2. Changes are immediately available via the symlink
+3. Commit changes to `pennyfarthing-dist/`
+For installed projects:
+1. `npm install github:1898andCo/pennyfarthing` creates `.pennyfarthing/`
+2. Scripts are accessed via `.pennyfarthing/scripts/`
+3. Users don't modify scripts directly
+## Adding New Scripts
+1. Identify the appropriate category
+2. Add script to `pennyfarthing-dist/scripts/{category}/`
+3. Update the category's README.md
+4. Update any skill.md files that reference the script
+## Library Usage
+Shared libraries in `lib/` are sourced by other scripts:
+```bash
+SCRIPT_DIR="$(dirname "$0")"
+source "$SCRIPT_DIR/../lib/common.sh"
+source "$SCRIPT_DIR/../lib/logging.sh"
+```

package/pennyfarthing-dist/scripts/core/README.md ADDED Viewed

@@ -0,0 +1,26 @@
+# Core Scripts
+Essential scripts required for all Pennyfarthing operations.
+## Scripts
+| Script | Purpose |
+|--------|---------|
+| `run.sh` | Bootstrap script - finds PROJECT_ROOT and dispatches to other scripts |
+| `agent-session.sh` | Agent persona loading and session management |
+| `check-context.sh` | Context usage checker for monitoring token limits |
+| `prime.sh` | Context loading for agent activation |
+## Usage
+These scripts are invoked via `run.sh`:
+```bash
+.pennyfarthing/scripts/core/run.sh core/agent-session.sh start sm
+.pennyfarthing/scripts/core/run.sh core/check-context.sh --human
+```
+## Ownership
+- **Primary users:** All agents, all workflows
+- **Maintained by:** Core Pennyfarthing team

package/pennyfarthing-dist/scripts/{agent-session.sh → core/agent-session.sh} RENAMED Viewed

@@ -8,10 +8,6 @@
 #
 # Session files stored in .session/agents/<session-id> for multi-session support
-# Find project root
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$SCRIPT_DIR/utils/find-root.sh"
 # Agents directory for multi-session support
 AGENTS_DIR="$PROJECT_ROOT/.session/agents"
@@ -104,12 +100,9 @@ output_persona() {
   # Check for config files in priority order:
   # 1. .pennyfarthing/config.local.yaml (agent-writable, dogfooding-friendly)
-  # 2. .claude/persona-config.local.yaml (legacy local)
-  # 3. .claude/persona-config.yaml (project default)
+  # 2. .claude/persona-config.yaml (project default)
   if [ -f "$PROJECT_ROOT/.pennyfarthing/config.local.yaml" ]; then
     config_file="$PROJECT_ROOT/.pennyfarthing/config.local.yaml"
-  elif [ -f "$PROJECT_ROOT/.claude/persona-config.local.yaml" ]; then
-    config_file="$PROJECT_ROOT/.claude/persona-config.local.yaml"
   elif [ -f "$PROJECT_ROOT/.claude/persona-config.yaml" ]; then
     config_file="$PROJECT_ROOT/.claude/persona-config.yaml"
   else
@@ -124,17 +117,10 @@ output_persona() {
     return 1
   fi
-  # Find theme file (check custom themes first, then built-in locations)
-  # Custom themes: .claude/pennyfarthing/themes/
-  # Built-in: .pennyfarthing/personas/themes/ and personas/themes/
-  if [ -f "$PROJECT_ROOT/.claude/pennyfarthing/themes/${theme}.yaml" ]; then
-    theme_file="$PROJECT_ROOT/.claude/pennyfarthing/themes/${theme}.yaml"
-  elif [ -f "$PROJECT_ROOT/.pennyfarthing/personas/themes/${theme}.yaml" ]; then
-    theme_file="$PROJECT_ROOT/.pennyfarthing/personas/themes/${theme}.yaml"
-  elif [ -f "$PROJECT_ROOT/personas/themes/${theme}.yaml" ]; then
-    theme_file="$PROJECT_ROOT/personas/themes/${theme}.yaml"
-  else
-    echo "<!-- Theme file not found: ${theme}.yaml -->" >&2
+  # Find theme file - single source of truth: .pennyfarthing/personas/themes/
+  theme_file="$PROJECT_ROOT/.pennyfarthing/personas/themes/${theme}.yaml"
+  if [ ! -f "$theme_file" ]; then
+    echo "<!-- Theme file not found: ${theme_file} -->" >&2
     return 1
   fi
@@ -280,7 +266,7 @@ case "$1" in
           HAS_HANDOFF="yes"
         fi
-        # Also check for CYCLIST:HANDOFF marker (generic-handoff output)
+        # Also check for CYCLIST:HANDOFF marker (handoff output)
         if [ "$HAS_HANDOFF" = "no" ] && grep -q "CYCLIST:HANDOFF" "$ACTIVE_SESSION" 2>/dev/null; then
           HAS_HANDOFF="yes"
         fi
@@ -294,10 +280,10 @@ case "$1" in
           echo "  Assessment: Found ($EXPECTED_SECTION)" >&2
           echo "  Handoff: NOT FOUND" >&2
           echo "" >&2
-          echo "  You MUST spawn generic-handoff before stopping:" >&2
+          echo "  You MUST spawn handoff before stopping:" >&2
           echo "" >&2
           echo "    Task tool:" >&2
-          echo "      subagent_type: \"generic-handoff\"" >&2
+          echo "      subagent_type: \"handoff\"" >&2
           echo "      prompt: |" >&2
           echo "        STORY_ID: {story-id}" >&2
           echo "        WORKFLOW: {workflow}" >&2
@@ -355,13 +341,38 @@ case "$1" in
       echo "No active sessions"
     fi
     ;;
+  refresh)
+    # Re-output persona for current agent (after theme change)
+    # Usage: agent-session.sh refresh [session-id]
+    session_id="${2:-$SESSION_ID}"
+    if [ -z "$session_id" ]; then
+      echo "Usage: agent-session.sh refresh [session-id]" >&2
+      exit 1
+    fi
+    AGENT_FILE=$(get_agent_file "$session_id")
+    if [ ! -f "$AGENT_FILE" ]; then
+      echo "No active session: $session_id" >&2
+      exit 1
+    fi
+    CURRENT_AGENT=$(cat "$AGENT_FILE")
+    echo "Refreshing persona for: $CURRENT_AGENT"
+    if is_character_voice_enabled; then
+      output_persona "$CURRENT_AGENT"
+    else
+      echo "Character voice disabled - no persona to refresh"
+    fi
+    ;;
   *)
-    echo "Usage: agent-session.sh <start|stop|stop-all|status|list> [args]" >&2
+    echo "Usage: agent-session.sh <start|stop|stop-all|status|list|refresh> [args]" >&2
     echo "  start \"agent\" \"session-id\"  - Register agent for session" >&2
     echo "  stop \"session-id\"            - Remove agent for session" >&2
     echo "  stop-all                      - Remove all agent sessions" >&2
     echo "  status                        - Get agent for session (reads JSON stdin)" >&2
     echo "  list                          - List all active sessions" >&2
+    echo "  refresh \"session-id\"         - Re-output persona after theme change" >&2
     exit 1
     ;;
 esac