@pennyfarthing/core 11.1.0 → 11.1.1

package/pennyfarthing_scripts/bikerack/cli.py

@@ -64,12 +64,12 @@ def start(project_dir, dry_run):
 
     running, pid, port = is_already_running(project_dir)
     if running:
-        click.echo(
-            f"Error: BikeRack is already running (PID {pid}, port {port})",
-            err=True,
-        )
-        click.echo("Use 'pf bikerack stop' to stop it.", err=True)
-        sys.exit(2)
+        # Idempotent: WheelHub already up, just exec Claude with OTEL env
+        click.echo(f"BikeRack already running (PID {pid}, port {port})")
+        otel_env = build_otel_env(port)
+        click.echo(f"Dashboard: http://localhost:{port}/bikerack")
+        click.echo("Starting Claude CLI...")
+        exec_claude(otel_env, project_dir)
 
     click.echo("Starting BikeRack mode...")
     try:
@@ -116,11 +116,10 @@ def stop(project_dir, dry_run):
 
     result = stop_bikerack(project_dir)
 
-    if result["success"]:
-        click.echo(result["message"])
-    else:
-        click.echo(result["message"], err=True)
-        sys.exit(1)
+    click.echo(result["message"])
+    if not result["success"]:
+        # "Not running" is not an error for stop — idempotent
+        sys.exit(0)
 
 
 @bikerack.command()

package/pennyfarthing_scripts/sprint/story_finish.py

@@ -126,8 +126,16 @@ def finish_story(
     steps: list[dict[str, Any]] = []
     archive_name = f"{jira_key}-session.md" if jira_key else f"{story_id}-session.md"
 
+    # Check for dialogue file
+    dialogue_path = project_root / ".session" / f"{story_id}-dialogue.md"
+    dialogue_archive_name = (
+        f"{jira_key}-dialogue.md" if jira_key else f"{story_id}-dialogue.md"
+    )
+
     if dry_run:
         steps.append({"step": 1, "action": f"Archive session → {archive_dir / archive_name}"})
+        if dialogue_path.exists():
+            steps.append({"step": "1b", "action": f"Archive dialogue → {archive_dir / dialogue_archive_name}"})
         if pr_number:
             steps.append({"step": 2, "action": f"Merge PR #{pr_number} (squash, delete branch)"})
         else:
@@ -147,6 +155,12 @@ def finish_story(
     shutil.copy2(session_path, archive_dest)
     steps.append({"step": 1, "action": "archive_session", "dest": str(archive_dest)})
 
+    # --- Step 1b: Archive dialogue (if exists) ---
+    if dialogue_path.exists():
+        dialogue_dest = archive_dir / dialogue_archive_name
+        shutil.copy2(dialogue_path, dialogue_dest)
+        steps.append({"step": "1b", "action": "archive_dialogue", "dest": str(dialogue_dest)})
+
     # --- Step 2: Merge PR ---
     if pr_number:
         result = _run(["gh", "pr", "merge", pr_number, "--squash", "--delete-branch"])

package/scripts/README.md

@@ -0,0 +1,41 @@
+# Meta Scripts
+
+**These scripts are NOT distributed to users.** They are for Pennyfarthing framework development only.
+
+## Contents
+
+| Script | Purpose |
+|--------|---------|
+| `deploy.sh` | Release Pennyfarthing (version bump, tag, push, GitHub release) |
+| `cyclist-debug.mjs` | Debug Cyclist connection |
+| `handoff-cli.{sh,js}` | Test handoff flow |
+| `verify-visual-mapping.js` | Verify theme visual mappings |
+| `migrate-assets-to-slug.sh` | One-time migration script |
+| `resize-portraits.sh` | Resize portrait images |
+| `resolve-portrait.mjs` | Portrait resolution logic |
+| `validate-refs.js` | Validate internal references |
+
+> Benchmark scripts have been moved to `packages/benchmark/`.
+
+## Usage
+
+Run from pennyfarthing repo root:
+
+```bash
+# Release a new version
+./scripts/deploy.sh --dry-run patch
+./scripts/deploy.sh patch
+```
+
+## Where Should My Script Go?
+
+**Put it here if:**
+- It's for framework development/CI only
+- Users should NOT have access to it
+- It uses GPU/heavy dependencies (keep in meta, not distributed)
+
+**Put it in `pennyfarthing-dist/scripts/` if:**
+- Users need it for their workflows
+- It's part of the sprint/story/jira tooling
+
+See `CLAUDE.md` for the full decision tree.