@pennyfarthing/core 11.4.0 → 12.0.0

package/pennyfarthing-dist/scripts/core/pf.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-# Wrapper: run `pf` CLI via uv run — no global pf install needed.
-# Usage: "$CLAUDE_PROJECT_DIR"/.pennyfarthing/scripts/core/pf.sh <command> [args...]
-source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
-exec_pf "$@"

package/pennyfarthing-dist/scripts/lib/background-tasks.sh

@@ -1,177 +0,0 @@
-#!/usr/bin/env bash
-# Background task tracking utilities for session files
-#
-# Usage:
-#   source $CLAUDE_PROJECT_DIR/scripts/lib/background-tasks.sh
-#
-# Functions:
-#   bg_task_add <session_file> <task_id> <subagent_type> <description>
-#   bg_task_update <session_file> <task_id> <status>
-#   bg_task_cleanup <session_file>
-#   bg_task_list <session_file>
-#   bg_task_check <session_file>
-#
-# Example:
-#   # After spawning background task
-#   bg_task_add "$SESSION_FILE" "abc123" "testing-runner" "Background test run"
-#
-#   # After TaskOutput returns
-#   bg_task_update "$SESSION_FILE" "abc123" "completed"
-#   bg_task_cleanup "$SESSION_FILE"
-
-set -euo pipefail
-
-# Helper: count pattern matches in file (returns 0 if no matches)
-# grep -c outputs "0" AND exits 1 when no matches, so we capture and fallback separately
-_count_matches() {
-    local count
-    count=$(grep -c "$1" "$2" 2>/dev/null) || count=0
-    echo "$count"
-}
-
-# Add a background task to session file
-# Creates the Background Tasks section if it doesn't exist
-bg_task_add() {
-    local session_file="$1"
-    local task_id="$2"
-    local subagent_type="$3"
-    local description="${4:-}"
-    local timestamp
-    timestamp=$(date +"%H:%M")
-
-    if [[ ! -f "$session_file" ]]; then
-        echo "ERROR: Session file not found: $session_file" >&2
-        return 1
-    fi
-
-    # Check if Background Tasks section exists
-    if ! grep -q "^## Background Tasks" "$session_file" 2>/dev/null; then
-        # Add section before Workflow Tracking if present, otherwise at end
-        if grep -q "^## Workflow Tracking" "$session_file"; then
-            # Insert before Workflow Tracking using awk
-            awk '/^## Workflow Tracking/ {
-                print "## Background Tasks\n"
-                print "| Task ID | Type | Started | Status | Description |"
-                print "|---------|------|---------|--------|-------------|"
-                print ""
-            } {print}' "$session_file" > "${session_file}.tmp" && mv "${session_file}.tmp" "$session_file"
-        else
-            # Append to end
-            cat >> "$session_file" << EOF
-
-## Background Tasks
-
-| Task ID | Type | Started | Status | Description |
-|---------|------|---------|--------|-------------|
-EOF
-        fi
-    fi
-
-    # Add task row after the table header
-    awk -v tid="$task_id" -v stype="$subagent_type" -v ts="$timestamp" -v desc="$description" '
-        /^\|[-]+\|/ && in_section {
-            print
-            print "| " tid " | " stype " | " ts " | running | " desc " |"
-            next
-        }
-        /^## Background Tasks/ { in_section=1 }
-        /^## / && !/^## Background Tasks/ { in_section=0 }
-        { print }
-    ' "$session_file" > "${session_file}.tmp" && mv "${session_file}.tmp" "$session_file"
-
-    echo "Added background task: $task_id ($subagent_type)"
-}
-
-# Update background task status
-# Status: running, completed, error
-bg_task_update() {
-    local session_file="$1"
-    local task_id="$2"
-    local new_status="$3"
-
-    if [[ ! -f "$session_file" ]]; then
-        echo "ERROR: Session file not found: $session_file" >&2
-        return 1
-    fi
-
-    if ! grep -q "| $task_id |" "$session_file" 2>/dev/null; then
-        echo "WARNING: Task $task_id not found in session file" >&2
-        return 0
-    fi
-
-    # Update the status column for this task
-    sed -i '' "s/| $task_id |\\([^|]*\\)|\\([^|]*\\)| running |/| $task_id |\\1|\\2| $new_status |/" "$session_file"
-    echo "Updated task $task_id: $new_status"
-}
-
-# Remove completed and error tasks from session file
-bg_task_cleanup() {
-    local session_file="$1"
-
-    if [[ ! -f "$session_file" ]]; then
-        echo "ERROR: Session file not found: $session_file" >&2
-        return 1
-    fi
-
-    # Count tasks to remove
-    local completed_count
-    completed_count=$(_count_matches "| completed |" "$session_file")
-    local error_count
-    error_count=$(_count_matches "| error |" "$session_file")
-
-    if [[ "$completed_count" -gt 0 ]] || [[ "$error_count" -gt 0 ]]; then
-        sed -i '' '/| completed |/d' "$session_file"
-        sed -i '' '/| error |/d' "$session_file"
-        echo "Cleaned up $completed_count completed, $error_count errored tasks"
-    fi
-}
-
-# List active (running) background tasks
-bg_task_list() {
-    local session_file="$1"
-
-    if [[ ! -f "$session_file" ]]; then
-        echo "No session file"
-        return 0
-    fi
-
-    local running_tasks
-    running_tasks=$(grep "| running |" "$session_file" 2>/dev/null || true)
-
-    if [[ -n "$running_tasks" ]]; then
-        echo "$running_tasks"
-    else
-        echo "No active background tasks"
-    fi
-}
-
-# Check for active background tasks (returns 0 if tasks exist, 1 if none)
-# Useful for conditional logic in scripts
-bg_task_check() {
-    local session_file="$1"
-
-    if [[ ! -f "$session_file" ]]; then
-        return 1
-    fi
-
-    grep -q "| running |" "$session_file" 2>/dev/null
-}
-
-# Print summary of all background tasks
-bg_task_summary() {
-    local session_file="$1"
-
-    if [[ ! -f "$session_file" ]]; then
-        echo "No session file"
-        return 0
-    fi
-
-    local running
-    running=$(_count_matches "| running |" "$session_file")
-    local completed
-    completed=$(_count_matches "| completed |" "$session_file")
-    local errored
-    errored=$(_count_matches "| error |" "$session_file")
-
-    echo "Background tasks: $running running, $completed completed, $errored errored"
-}

package/pennyfarthing-dist/scripts/lib/run-pf.sh

@@ -1,44 +0,0 @@
-#!/usr/bin/env bash
-# Shared utility: Run the `pf` CLI via uv run — no global install needed.
-#
-# Resolution order for pyproject.toml:
-# 1. Dogfooding: $PROJECT_ROOT/pennyfarthing/pennyfarthing-dist/pyproject.toml (inlined repo)
-# 2. Consumer:   $PROJECT_ROOT/.pennyfarthing/pyproject.toml (symlinked from dist)
-# 3. Fallback:   $PROJECT_ROOT/pyproject.toml (project declares dependency)
-#
-# Usage from hook shims:
-#   source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
-#   exec_pf hooks session-start
-
-# Resolve PROJECT_ROOT if not already set
-_lib_dir="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd -P)"
-source "$_lib_dir/find-root.sh"
-
-# Find the pyproject.toml that provides pennyfarthing-scripts
-_pf_project=""
-if [[ -f "$PROJECT_ROOT/pennyfarthing/pennyfarthing-dist/pyproject.toml" ]]; then
-    # Dogfooding: inlined framework repo
-    _pf_project="$PROJECT_ROOT/pennyfarthing/pennyfarthing-dist"
-elif [[ -f "$PROJECT_ROOT/.pennyfarthing/pyproject.toml" ]]; then
-    # Consumer: auto-generated by pennyfarthing init (symlinked from dist)
-    _pf_project="$PROJECT_ROOT/.pennyfarthing"
-elif [[ -f "$PROJECT_ROOT/pyproject.toml" ]]; then
-    # Consumer: project-level pyproject.toml with pennyfarthing-scripts dep
-    _pf_project="$PROJECT_ROOT"
-fi
-
-if [[ -z "$_pf_project" ]]; then
-    echo "Error: No pyproject.toml found for pennyfarthing-scripts" >&2
-    echo "Expected: $PROJECT_ROOT/pennyfarthing/pennyfarthing-dist/pyproject.toml (dogfooding)" >&2
-    echo "      or: $PROJECT_ROOT/.pennyfarthing/pyproject.toml (consumer)" >&2
-    echo "      or: $PROJECT_ROOT/pyproject.toml (fallback)" >&2
-    exit 1
-fi
-
-run_pf() {
-    uv run --project "$_pf_project" pf "$@"
-}
-
-exec_pf() {
-    exec uv run --project "$_pf_project" pf "$@"
-}

package/pennyfarthing-dist/skills/pf-permissions/skill.md

@@ -1,157 +0,0 @@
----
-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.
----
-
-# /pf-permissions - Permission Management Skill
-
-<run>/permissions</run>
-<output>List all active permission grants</output>
-
-## Overview
-
-Pennyfarthing uses a runtime permission system for tool access control. This skill provides commands to view and manage permission grants via the WheelHub Permissions API.
-
-## Quick Reference
-
-| Action | Command |
-|--------|---------|
-| 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
-
-Permissions support three duration types:
-
-| Type | Duration | Storage |
-|------|----------|---------|
-| `once` | Single use | Memory only |
-| `session` | Until session ends | Memory only |
-| `always` | Persists forever | `~/.cyclist/grants.json` |
-
-## List Active Grants
-
-To see all currently active permission grants:
-
-```bash
-curl -s http://localhost:${WHEELHUB_PORT:-7173}/api/permissions | jq '.grants'
-```
-
-Output shows:
-- Tool name
-- Scope pattern
-- Grant type
-- When granted
-
-If no grants exist, displays "No active permission grants."
-
-## Grant Tool Access
-
-Add a permission grant for a specific tool and scope:
-
-```
-/pf-permissions grant <tool> "<scope>" [--type <once|session|always>]
-```
-
-**Parameters:**
-- `<tool>` - Tool name (e.g., `WebFetch`, `Bash`, `Read`)
-- `"<scope>"` - Scope pattern in quotes (e.g., `"*.github.com"`, `"git *"`)
-- `--type` - Grant duration (default: `session`)
-
-**Examples:**
-
-```bash
-# Grant WebFetch access to GitHub
-curl -s -X POST http://localhost:${WHEELHUB_PORT:-7173}/api/permissions/grant \
-  -H 'Content-Type: application/json' \
-  -d '{"tool":"WebFetch","scope":"*.github.com","grant_type":"session"}'
-
-# Grant Bash git commands (always)
-curl -s -X POST http://localhost:${WHEELHUB_PORT:-7173}/api/permissions/grant \
-  -H 'Content-Type: application/json' \
-  -d '{"tool":"Bash","scope":"git *","grant_type":"always"}'
-```
-
-**What happens:**
-1. Validates the tool name and scope
-2. Creates a `PermissionGrant` object with timestamp
-3. Stores via settings-store (always-grants persisted to `~/.cyclist/grants.json`)
-4. Reports success with grant details
-
-## Revoke Tool Access
-
-Remove all grants for a specific tool:
-
-```
-/pf-permissions revoke <tool>
-```
-
-**Examples:**
-
-```bash
-# Revoke all WebFetch grants
-curl -s -X DELETE http://localhost:${WHEELHUB_PORT:-7173}/api/permissions/revoke/WebFetch
-
-# Revoke a specific Bash scope
-curl -s -X DELETE "http://localhost:${WHEELHUB_PORT:-7173}/api/permissions/revoke/Bash?scope=git%20*"
-```
-
-**What happens:**
-1. Finds all grants matching the tool (and optional scope)
-2. Removes each grant from settings-store
-3. Always-grants removal triggers file persistence
-4. Reports how many grants were removed
-
-## Show Grant Details
-
-Display detailed information about grants for a specific tool:
-
-```
-/pf-permissions show <tool>
-```
-
-```bash
-curl -s http://localhost:${WHEELHUB_PORT:-7173}/api/permissions/show/Bash | jq '.grants'
-```
-
-**Output includes:**
-- All grants for the specified tool
-- Scope patterns
-- Grant types
-- Timestamps
-
-## Storage
-
-Grants are managed by Cyclist's settings-store:
-- `once` and `session` grants live in memory only
-- `always` grants are persisted to `~/.cyclist/grants.json`
-- The WheelHub Permissions API at `/api/permissions` provides CRUD access
-
-## Permission Schema
-
-```typescript
-interface PermissionGrant {
-  tool: string;           // Tool name
-  scope: string;          // Scope pattern
-  grant_type: GrantType;  // 'once' | 'session' | 'always'
-  granted_at: string;     // ISO timestamp
-}
-```
-
-## Error Handling
-
-| Error | Cause | Solution |
-|-------|-------|----------|
-| "Missing required field: tool" | Tool not provided | Include tool in request body |
-| "Missing required field: scope" | Scope not provided | Include scope in request body |
-| "Invalid grant_type" | Unknown type | Use once, session, or always |
-| Connection refused | WheelHub not running | Start Cyclist first |
-
-## Related
-
-- **Story 33-1:** Permission Request Protocol (schema definitions)
-- **Story 33-3:** Cyclist Permission UI (visual management)
-- **Story 33-4:** Spot Permission Grants (inline approval)
-- **Story 78-7:** Connect /permissions skill to grant store (this story)

package/pennyfarthing-dist/templates/persona-config.yaml.template

@@ -1,22 +0,0 @@
-# Persona Configuration
-# Controls agent personalities in Pennyfarthing
-#
-# Available themes: discworld, star-trek-tos, literary-classics, minimalist
-# See .pennyfarthing/personas/themes/ for full list
-
-# Base theme
-theme: discworld
-
-# Personality attributes (modify agent behavior independent of theme)
-attributes:
-  verbosity: medium      # low | medium | high
-  formality: casual      # formal | casual | playful
-  humor: enabled         # enabled | disabled | subtle
-  emoji_use: minimal     # none | minimal | frequent
-
-# Per-agent overrides (optional)
-overrides: {}
-  # Example: Use a different character for reviewer
-  # reviewer:
-  #   theme: star-trek-tos
-  #   character: spock

package/scripts/postinstall.cjs

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-// Fix execute permissions on shell scripts after npm install.
-// npm may strip +x bits depending on platform/version.
-
-const { readdirSync, chmodSync, statSync } = require('fs');
-const { join } = require('path');
-
-const scriptsDir = join(__dirname, '..', 'pennyfarthing-dist', 'scripts');
-
-function fixPermissions(dir) {
-  let entries;
-  try {
-    entries = readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    const full = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      fixPermissions(full);
-    } else if (entry.name.endsWith('.sh') && entry.name !== 'find-root.sh') {
-      try {
-        const stat = statSync(full);
-        if ((stat.mode & 0o111) === 0) {
-          chmodSync(full, 0o755);
-        }
-      } catch {
-        // Skip files we can't chmod
-      }
-    }
-  }
-}
-
-fixPermissions(scriptsDir);