npm - @pennyfarthing/core - Versions diffs - 10.4.0 → 11.0.0 - Mend

@pennyfarthing/core 10.4.0 → 11.0.0

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 (797) hide show

package/pennyfarthing-dist/skills/{just → pf-just}/SKILL.md RENAMED Viewed

@@ -6,7 +6,7 @@ description: |
 args: "[recipe] [args...]"
 ---
-# /just - Project Task Runner
+# /pf-just - Project Task Runner
 <run>
 Main commands:
@@ -23,7 +23,7 @@ Main commands:
 ## Commands
-### `/just` or `/just --list`
+### `/pf-just` or `/pf-just --list`
 List all available recipes.
@@ -36,7 +36,7 @@ just --list
 ---
-### `/just build`
+### `/pf-just build`
 Build all packages in the monorepo.
@@ -49,7 +49,7 @@ just build
 ---
-### `/just test`
+### `/pf-just test`
 Run tests for all packages.
@@ -62,7 +62,7 @@ just test
 ---
-### `/just test-cyclist`
+### `/pf-just test-cyclist`
 Run tests for the Cyclist package only.
@@ -75,7 +75,7 @@ just test-cyclist
 ---
-### `/just test-cyclist-watch`
+### `/pf-just test-cyclist-watch`
 Run Cyclist tests in watch mode for TDD workflow.
@@ -88,7 +88,7 @@ just test-cyclist-watch
 ---
-### `/just install`
+### `/pf-just install`
 Install dependencies for all packages.
@@ -105,7 +105,7 @@ just install
 The `cyclist` recipe is the main entry point for Cyclist operations.
-### `/just cyclist` (default)
+### `/pf-just cyclist` (default)
 Launch Cyclist in Electron mode with folder picker.
@@ -118,7 +118,7 @@ just cyclist
 ---
-### `/just cyclist here`
+### `/pf-just cyclist here`
 Launch Cyclist for the current directory.
@@ -131,7 +131,7 @@ just cyclist here
 ---
-### `/just cyclist web`
+### `/pf-just cyclist web`
 Launch Cyclist in web dev mode with hot reload.
@@ -144,7 +144,7 @@ just cyclist web
 ---
-### `/just cyclist server`
+### `/pf-just cyclist server`
 Start Cyclist web server only (no browser).
@@ -157,7 +157,7 @@ just cyclist server
 ---
-### `/just cyclist verbose`
+### `/pf-just cyclist verbose`
 Enable debug logging for troubleshooting.
@@ -174,7 +174,7 @@ just cyclist web verbose
 ---
-### `/just cyclist dir=<path>`
+### `/pf-just cyclist dir=<path>`
 Launch Cyclist for a specific project directory.
@@ -190,7 +190,7 @@ just cyclist dir=/path/to/project
 ---
-### `/just cyclist setup`
+### `/pf-just cyclist setup`
 First-time setup for Cyclist development.
@@ -207,7 +207,7 @@ just cyclist setup
 ---
-### `/just cyclist doctor`
+### `/pf-just cyclist doctor`
 Diagnose Cyclist setup issues.
@@ -226,7 +226,7 @@ just cyclist doctor --fix
 ---
-### `/just cyclist build`
+### `/pf-just cyclist build`
 Build Cyclist TypeScript only.
@@ -239,7 +239,7 @@ just cyclist build
 ---
-### `/just cyclist clean`
+### `/pf-just cyclist clean`
 Remove Cyclist build artifacts.
@@ -252,7 +252,7 @@ just cyclist clean
 ---
-### `/just cyclist rebuild`
+### `/pf-just cyclist rebuild`
 Rebuild native modules (node-pty) for Electron.
@@ -267,7 +267,7 @@ just cyclist rebuild
 ---
-### `/just cyclist package`
+### `/pf-just cyclist package`
 Build Cyclist Electron app for distribution.
@@ -280,7 +280,7 @@ just cyclist package
 ---
-### `/just cyclist install`
+### `/pf-just cyclist install`
 Install Cyclist app and CLI.
@@ -299,7 +299,7 @@ just cyclist install
 Generate AI portraits for persona themes.
-### `/just portraits <theme>`
+### `/pf-just portraits <theme>`
 Generate portraits for a specific theme.
@@ -315,7 +315,7 @@ just portraits arthurian-mythos
 ---
-### `/just portraits-all`
+### `/pf-just portraits-all`
 Generate portraits for all themes.
@@ -328,7 +328,7 @@ just portraits-all
 ---
-### `/just portraits-preview <theme>`
+### `/pf-just portraits-preview <theme>`
 Preview portraits for a theme without saving.

package/pennyfarthing-dist/skills/{permissions → pf-permissions}/skill.md RENAMED Viewed

@@ -3,7 +3,7 @@ name: permissions
 description: Manage runtime permission grants - list active grants, add/revoke tool access, show grant details. Use when viewing current permissions, granting tool access, or revoking permissions.
 ---
-# Permission Management Skill
+# /pf-permissions - Permission Management Skill
 <run>/permissions</run>
 <output>List all active permission grants</output>
@@ -16,10 +16,10 @@ Pennyfarthing uses a runtime permission system for tool access control. This ski
 | Action | Command |
 |--------|---------|
-| List all grants | `/permissions` |
-| Grant tool access | `/permissions grant <tool> "<scope>"` |
-| Revoke tool access | `/permissions revoke <tool>` |
-| Show grant details | `/permissions show <tool>` |
+| List all grants | `/pf-permissions` |
+| Grant tool access | `/pf-permissions grant <tool> "<scope>"` |
+| Revoke tool access | `/pf-permissions revoke <tool>` |
+| Show grant details | `/pf-permissions show <tool>` |
 ## Grant Types
@@ -52,7 +52,7 @@ If no grants exist, displays "No active permission grants."
 Add a permission grant for a specific tool and scope:
 ```
-/permissions grant <tool> "<scope>" [--type <once|session|always>]
+/pf-permissions grant <tool> "<scope>" [--type <once|session|always>]
 ```
 **Parameters:**
@@ -85,7 +85,7 @@ curl -s -X POST http://localhost:${WHEELHUB_PORT:-7173}/api/permissions/grant \
 Remove all grants for a specific tool:
 ```
-/permissions revoke <tool>
+/pf-permissions revoke <tool>
 ```
 **Examples:**
@@ -109,7 +109,7 @@ curl -s -X DELETE "http://localhost:${WHEELHUB_PORT:-7173}/api/permissions/revok
 Display detailed information about grants for a specific tool:
 ```
-/permissions show <tool>
+/pf-permissions show <tool>
 ```
 ```bash

package/pennyfarthing-dist/skills/pf-persona-benchmark/SKILL.md ADDED Viewed

@@ -0,0 +1,187 @@
+---
+name: persona-benchmark
+description: Run benchmarks to compare persona effectiveness across themes. Use when testing which personas perform best on code review, test writing, or architecture tasks, or when running comparative analysis across themes.
+---
+# Persona Benchmark Skill
+Run benchmarks to compare persona effectiveness.
+<run>
+/persona-benchmark <test-case-id> <persona>
+/persona-benchmark <test-case-id> <persona> [--analyze] [--suite]
+</run>
+<output>
+Benchmark results saved to `.claude/benchmarks/results/{timestamp}-{persona}-{test-case-id}.yaml` with quantitative and qualitative metrics, or analysis summary when using `--analyze`.
+</output>
+## Usage
+```
+/persona-benchmark <test-case-id> <persona>
+/persona-benchmark cr-001 discworld
+/persona-benchmark tw-001 literary-classics
+/persona-benchmark --suite              # Run all tests, all personas
+/persona-benchmark --analyze            # Analyze collected results
+```
+## Benchmark Execution Protocol
+### Step 1: Load Test Case
+Read the test case from `.claude/benchmarks/test-cases/{category}/{id}.yaml`
+Extract:
+- `instructions` - What to give the agent
+- `code` - The code/problem to analyze
+- `known_issues` or `known_edge_cases` or `known_considerations` - DO NOT reveal to agent
+### Step 2: Configure Persona
+Temporarily set persona in `.claude/persona-config.yaml`:
+```yaml
+theme: {persona}
+```
+### Step 3: Execute Task
+Invoke the appropriate agent:
+- `code-review` → `/reviewer`
+- `test-writing` → `/tea`
+- `architecture` → `/architect`
+Provide ONLY:
+- The instructions
+- The code/problem
+Do NOT reveal known issues list.
+### Step 4: Collect Results
+After agent completes, score the output:
+**Quantitative Scoring:**
+```yaml
+# For code review:
+issues_found: [list of issues detected]
+issues_matched: [map to known_issues ids]
+detection_rate: issues_matched / total_known_issues
+false_positives: issues not in known list
+# For test writing:
+edge_cases_found: [list of edge cases covered]
+edge_cases_matched: [map to known_edge_cases ids]
+coverage_rate: edge_cases_matched / total_known_edge_cases
+# For architecture:
+considerations_found: [list of considerations mentioned]
+considerations_matched: [map to known_considerations ids]
+completeness_rate: considerations_matched / total_known_considerations
+```
+**Qualitative Scoring (1-5):**
+- `persona_consistency`: Did the agent stay in character?
+- `explanation_quality`: How well did it explain its findings?
+- `actionability`: How usable is the output?
+- `engagement`: How enjoyable was the interaction?
+### Step 5: Save Results
+Write to `.claude/benchmarks/results/{timestamp}-{persona}-{test-case-id}.yaml`:
+```yaml
+benchmark:
+  test_case: cr-001
+  persona: discworld
+  agent: reviewer
+  character: Granny Weatherwax
+  timestamp: 2024-01-15T10:30:00Z
+quantitative:
+  items_found: 8
+  items_expected: 14
+  items_matched:
+    - SQL_INJECTION_1
+    - SQL_INJECTION_2
+    - PLAINTEXT_PASSWORD
+    - PASSWORD_EXPOSURE_1
+    - PASSWORD_EXPOSURE_2
+    - NO_AUTH_CHECK
+    - ASYNC_DELETE_NO_TX
+    - ROWS_NOT_CLOSED
+  detection_rate: 0.57
+  false_positives: 1
+  weighted_score: 15.5
+  max_weighted_score: 22.5
+  weighted_rate: 0.69
+qualitative:
+  persona_consistency: 5
+  explanation_quality: 4
+  actionability: 4
+  engagement: 5
+notes: |
+  Found both SQL injections immediately with strong language.
+  Missed the error handling issues.
+  Very much in character - "I aten't reviewing code that's already dead."
+raw_output: |
+  [Full agent output preserved here]
+```
+## Analysis Mode
+When run with `--analyze`:
+1. Load all results from `.claude/benchmarks/results/`
+2. Aggregate by persona:
+```
+| Persona          | Detection Rate | False Pos | Persona Score | Engagement |
+|------------------|----------------|-----------|---------------|------------|
+| discworld        | 0.71           | 1.2       | 4.8           | 4.9        |
+| star-trek        | 0.68           | 0.8       | 4.5           | 4.2        |
+| literary-classics| 0.73           | 1.5       | 4.2           | 4.0        |
+| minimalist       | 0.65           | 0.5       | N/A           | 3.2        |
+```
+3. Aggregate by test category:
+```
+| Category     | Best Persona      | Avg Detection |
+|--------------|-------------------|---------------|
+| code-review  | literary-classics | 0.71          |
+| test-writing | discworld         | 0.68          |
+| architecture | star-trek         | 0.75          |
+```
+4. Statistical significance:
+- Calculate standard deviation
+- Note if differences are significant
+5. Qualitative patterns:
+- Which personas stay in character best?
+- Which provide most actionable output?
+- User enjoyment patterns
+## Running a Full Suite
+```bash
+# This will take a while - runs each test case with each persona
+/persona-benchmark --suite
+```
+Executes:
+- All test cases in `test-cases/`
+- With each persona: discworld, star-trek, literary-classics, minimalist
+- Saves individual results
+- Produces summary comparison
+## Tips for Valid Benchmarks
+1. **Same evaluator**: Same person should score qualitative metrics
+2. **Blind evaluation**: Score output before checking which persona
+3. **Multiple runs**: Run each test 3+ times for reliability
+4. **Fresh context**: Start new session for each benchmark run
+5. **Control variables**: Same time of day, same evaluator state

package/pennyfarthing-dist/skills/pf-sprint/examples.md ADDED Viewed

@@ -0,0 +1,189 @@
+# Sprint CLI — Examples
+## Status & Discovery
+```bash
+# Full sprint status
+pf sprint status
+# Only backlog stories
+pf sprint status backlog
+# Only in-progress work
+pf sprint status in-progress
+# Only completed stories
+pf sprint status done
+# Available stories grouped by epic
+pf sprint backlog
+# Sprint metrics and velocity
+pf sprint metrics
+pf sprint metrics --json
+# Sprint header as JSON (for scripts)
+pf sprint info
+# Future initiatives overview
+pf sprint future
+# Future epic detail with stories
+pf sprint future epic-55
+```
+## Starting Work
+```bash
+# Show available stories (interactive)
+pf sprint work
+# Start specific story
+pf sprint work 91-3
+# Auto-select highest priority
+pf sprint work next
+# Preview without starting
+pf sprint work 91-3 --dry-run
+# Check story availability (JSON output)
+pf sprint check 91-3
+pf sprint check MSSCI-15033
+pf sprint check next
+```
+## Story Operations
+```bash
+# Show story details
+pf sprint story show 91-3
+pf sprint story show MSSCI-15033 --json
+# Add story to epic
+pf sprint story add 91 "Add error handling" 3
+pf sprint story add 91 "Fix null pointer" 2 --type bug
+pf sprint story add 91 "Refactor parser" 3 --workflow trivial --priority p0
+# Add standalone story to initiative
+pf sprint story add --initiative technical-debt "Fix flaky test" 2 --type bug
+# Update story fields
+pf sprint story update 91-3 --status in_progress
+pf sprint story update 91-3 --status done
+pf sprint story update 91-3 --points 5 --priority P0
+pf sprint story update 91-3 --assigned-to keith.avery@1898andco.io
+pf sprint story update 91-3 --workflow tdd-tandem
+pf sprint story update 91-3 --status done --dry-run
+# Get single field
+pf sprint story field 91-3 workflow    # tdd
+pf sprint story field 91-3 jira        # MSSCI-15033
+pf sprint story field 91-3 status      # in_progress
+# Sizing guidelines
+pf sprint story size
+pf sprint story size 5
+# Story templates
+pf sprint story template
+pf sprint story template feature
+pf sprint story template bug
+# Complete story (archive, merge, Jira transition)
+pf sprint story finish 91-3
+pf sprint story finish 91-3 --dry-run
+# Claim/unclaim in Jira
+pf sprint story claim MSSCI-15033
+pf sprint story claim MSSCI-15033 --unclaim
+```
+## Epic Operations
+```bash
+# Show epic details
+pf sprint epic show 91
+pf sprint epic show MSSCI-14298
+pf sprint epic show 91 --json
+# Add new epic
+pf sprint epic add epic-95 "New Feature Epic"
+pf sprint epic add epic-95 "New Feature" --priority p0 --jira MSSCI-15100
+pf sprint epic add epic-95 "New Feature" -d "Description of the epic"
+# Update epic
+pf sprint epic update 91 --status in_progress
+pf sprint epic update MSSCI-14298 --priority P0
+pf sprint epic update 91 --status done --dry-run
+# Promote from future to current sprint
+pf sprint epic promote epic-55
+pf sprint epic promote 55
+pf sprint epic promote epic-55 --dry-run
+# Archive completed epics
+pf sprint epic archive                     # Scan all completed
+pf sprint epic archive --dry-run           # Preview
+pf sprint epic archive 91                  # Specific epic
+pf sprint epic archive 91 --jira           # Also update Jira
+# Cancel epic and all stories
+pf sprint epic cancel 91
+pf sprint epic cancel 91 --jira            # Also cancel in Jira
+pf sprint epic cancel 91 --dry-run
+# Import BMAD epics
+pf sprint epic import docs/planning/feature-epics.md
+pf sprint epic import docs/planning/feature-epics.md "My Feature" --marker my-feature
+pf sprint epic import docs/planning/feature-epics.md --dry-run
+# Remove from future.yaml
+pf sprint epic remove epic-41
+pf sprint epic remove epic-41 --dry-run
+# Get epic field
+pf sprint epic field 91 jira               # MSSCI-14298
+pf sprint epic field 91 title              # Epic title
+```
+## Initiative Operations
+```bash
+# Show initiative details
+pf sprint initiative show benchmark-reliability
+pf sprint initiative show technical-debt --json
+# Cancel initiative
+pf sprint initiative cancel technical-debt
+pf sprint initiative cancel technical-debt --jira
+pf sprint initiative cancel technical-debt --dry-run
+```
+## Sprint Lifecycle
+```bash
+# Initialize new sprint
+pf sprint new 2607 278 2026-02-16 2026-03-01 "Performance and polish"
+pf sprint new 2607 278 2026-02-16 2026-03-01 "Performance and polish" --dry-run
+# Archive completed story
+pf sprint archive 91-3 856
+pf sprint archive 91-3 856 --apply          # Archive + remove atomically
+# Validate sprint YAML
+pf sprint validate                           # All validators
+pf sprint validate sprint                    # Sprint YAML only
+pf sprint validate --fix                     # Auto-fix issues
+pf sprint validate --strict                  # Warnings as errors
+```
+## Sizing Quick Reference
+| Points | Scale | Complexity | Examples |
+|--------|-------|------------|----------|
+| 1-2 | Trivial | Single file, minimal testing | Config, typo, simple fix |
+| 3 | Small | Few files, some testing | Validation, single component |
+| 5 | Medium | Multiple files, comprehensive testing | New page, API endpoint |
+| 8 | Large | Significant scope, extensive testing | Integration, major refactor |
+| 13+ | **SPLIT** | Too complex for single story | Break into smaller stories |

package/pennyfarthing-dist/skills/pf-sprint/skill.md ADDED Viewed

@@ -0,0 +1,85 @@
+---
+name: sprint
+description: |
+  Sprint status, backlog, and story management for Pennyfarthing. Use when checking current
+  sprint status, finding available stories, reviewing backlog, or understanding story context
+  and history.
+  IMPORTANT: Always use `pf sprint` CLI commands - never manually edit sprint YAML.
+args: "[status|backlog|work|story|epic|initiative|archive|new|future|info|metrics|validate|standalone]"
+---
+# /pf-sprint - Sprint Management
+<critical>
+Never manually edit `sprint/current-sprint.yaml`. Use `pf sprint` CLI commands for deterministic, correct YAML formatting.
+</critical>
+## Quick Reference
+| Command | CLI | Purpose |
+|---------|-----|---------|
+| `/pf-sprint` | `pf sprint status` | Show sprint status |
+| `/pf-sprint status [filter]` | `pf sprint status [filter]` | Filter: `backlog`, `todo`, `in-progress`, `review`, `done` |
+| `/pf-sprint backlog` | `pf sprint backlog` | Available stories by epic |
+| `/pf-sprint work [id]` | `pf sprint work [story-id] [--dry-run]` | Start work on a story |
+| `/pf-sprint archive <id> [pr]` | `pf sprint archive <id> [pr] [--apply] [--dry-run]` | Archive completed story |
+| `/pf-sprint new ...` | `pf sprint new <yyww> <jira-id> <start> <end> "<goal>" [--dry-run]` | Initialize new sprint |
+| `/pf-sprint future [epic-id]` | `pf sprint future [epic-id]` | Show future initiatives |
+| `/pf-sprint info` | `pf sprint info` | Sprint header as JSON |
+| `/pf-sprint metrics` | `pf sprint metrics [--json]` | Sprint progress and velocity |
+| `/pf-sprint validate` | `pf sprint validate [--fix] [--strict]` | Validate sprint YAML |
+### Story Commands
+| Command | CLI | Purpose |
+|---------|-----|---------|
+| `/pf-sprint story show <id>` | `pf sprint story show <id> [--json]` | Show story details |
+| `/pf-sprint story add ...` | `pf sprint story add <epic-id> "<title>" <pts> [opts]` | Add story to epic |
+| `/pf-sprint story update <id>` | `pf sprint story update <id> [opts]` | Update story fields |
+| `/pf-sprint story field <id> <f>` | `pf sprint story field <id> <field>` | Get single field value |
+| `/pf-sprint story size [pts]` | `pf sprint story size [points]` | Sizing guidelines |
+| `/pf-sprint story template [t]` | `pf sprint story template [type]` | Story templates |
+| `/pf-sprint story finish <id>` | `pf sprint story finish <id> [--dry-run]` | Complete story workflow |
+| `/pf-sprint story claim <id>` | `pf sprint story claim <id> [--claim/--unclaim] [--dry-run]` | Claim/unclaim in Jira |
+### Epic Commands
+| Command | CLI | Purpose |
+|---------|-----|---------|
+| `/pf-sprint epic show <id>` | `pf sprint epic show <id> [--json]` | Show epic details |
+| `/pf-sprint epic add <id> <title>` | `pf sprint epic add <id> <title> [opts]` | Add epic to sprint |
+| `/pf-sprint epic update <id>` | `pf sprint epic update <id> [--status] [--priority] [--dry-run]` | Update epic fields |
+| `/pf-sprint epic promote <id>` | `pf sprint epic promote <id> [--dry-run]` | Move from future to current |
+| `/pf-sprint epic archive [id]` | `pf sprint epic archive [id] [--dry-run] [--jira]` | Archive completed epics |
+| `/pf-sprint epic cancel <id>` | `pf sprint epic cancel <id> [--jira] [--dry-run]` | Cancel epic and stories |
+| `/pf-sprint epic import <file>` | `pf sprint epic import <file> [init] [--marker] [--dry-run]` | Import BMAD epics |
+| `/pf-sprint epic remove <id>` | `pf sprint epic remove <id> [--dry-run]` | Remove from future.yaml |
+| `/pf-sprint epic field <id> <f>` | `pf sprint epic field <id> <field>` | Get single field value |
+### Initiative Commands
+| Command | CLI | Purpose |
+|---------|-----|---------|
+| `/pf-sprint initiative show <n>` | `pf sprint initiative show <name> [--json]` | Show initiative details |
+| `/pf-sprint initiative cancel <n>` | `pf sprint initiative cancel <name> [--jira] [--dry-run]` | Cancel initiative |
+### Aliases
+| Alias | Equivalent |
+|-------|------------|
+| `pf status` | `pf sprint status` |
+| `pf backlog` | `pf sprint backlog` |
+| `pf work` | `pf sprint work` |
+| `pf story` | `pf sprint story` |
+| `/new-work` | `/pf-sprint work` |
+---
+**Detailed options and behavior:** [usage.md](usage.md)
+**Practical examples:** [examples.md](examples.md)
+## Related Skills
+| Skill | Purpose |
+|-------|---------|
+| `/pf-jira` | Jira operations (create, sync, reconcile, claim, assign) |