pi-shit 0.1.0 → 0.1.1

package/extensions/AGENTS.md

@@ -0,0 +1,50 @@
+# AGENTS.md - AI Assistant Context
+
+Custom pi-coding-agent extensions.
+
+## Development
+
+```bash
+just              # List all commands
+just compile      # Type-check with tsc
+just fmt          # Format with Biome
+just lint         # Lint with Biome
+just check        # Format + lint + compile (full check)
+
+just setup-hooks  # Install pre-commit hook
+just remove-hooks # Remove pre-commit hook
+```
+
+Pre-commit hook runs `just check` before each commit.
+
+## Structure
+
+Each extension is a folder with an `index.ts` entry point:
+
+```
+extension-name/
+├── index.ts      # Main extension code
+└── README.md     # Usage docs
+```
+
+Current extensions:
+
+- `deep-review`
+- `pi-notify`
+- `plan-mode`
+
+## Type Checking
+
+Extensions import from pi's packages. The `tsconfig.json` maps these:
+
+- `@mariozechner/pi-coding-agent` - Extension API
+- `@mariozechner/pi-agent-core` - Message types
+- `@mariozechner/pi-ai` - Content types
+- `@mariozechner/pi-tui` - TUI utilities
+- `@sinclair/typebox` - Schema types
+
+## Style
+
+- Biome handles formatting and linting
+- Spaces for indentation (4-space)
+- 120 char line width

package/extensions/TODO.md

@@ -0,0 +1,47 @@
+# TODO
+
+## Plan mode improvements
+
+- Improve plan mode to better infer steps as todos
+  - Step 1:, Step 2:, etc.
+  - ### 8., ### 9., etc.
+- Allow referencing of files in plan refinement editor
+- Allow find tool use in plan mode
+- Questionnaire options can mark a choice as `(recommended)`
+- Questionnaire question text gets truncated; render multiline/compact so full prompt is readable
+- Questionnaire prompt: model misreads "Type something" and suggests "Other (describe)"; prompt should steer to typed answer handling / accept variants
+- Plan-mode todo widget lines are truncated; render multiline/compact so full items are readable
+
+## Explore: Replace built-in todos with file-based tracking
+
+**Context:** Amp removed their todolist feature. Mario says todos confuse models. Same vibes here.
+
+https://x.com/thorstenball/status/2010757205084312026
+
+### Problems with built-in todos
+
+- Models get confused about when/how to update them
+- Extra cognitive overhead in system prompt
+- State management complexity
+- Often out of sync with actual progress
+
+### Alternative: Simple file-based approach
+
+- `todo.md` or `## TODO` section in README
+- Model reads/writes it like any other file
+- No special tools or state to manage
+- Transparent and version-controlled
+- Works with existing edit/write tools
+
+### Questions to explore
+
+- [ ] Is the `[DONE:n]` tag approach in plan-mode sufficient?
+- [ ] Should we strip out todolist tool entirely?
+- [ ] Does a simple markdown checklist work better in practice?
+- [ ] How does ralph-wiggum handle task tracking? (uses taskContent markdown)
+
+### Next steps
+
+- Try using just markdown checklists for a while
+- Compare with current `[DONE:n]` progress tracking
+- Decide whether to simplify or remove todo-related features

package/extensions/biome.json

@@ -0,0 +1,26 @@
+{
+    "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+    "formatter": {
+        "enabled": true,
+        "indentStyle": "space",
+        "indentWidth": 4,
+        "lineWidth": 120
+    },
+    "linter": {
+        "enabled": true,
+        "rules": {
+            "recommended": true,
+            "suspicious": {
+                "noExplicitAny": "off"
+            },
+            "style": {
+                "noNonNullAssertion": "off",
+                "useTemplate": "off"
+            }
+        }
+    },
+    "files": {
+        "includes": ["**/*.ts"],
+        "ignoreUnknown": true
+    }
+}

package/extensions/dprint.json

@@ -0,0 +1,7 @@
+{
+    "plugins": ["https://plugins.dprint.dev/markdown-0.18.0.wasm"],
+    "includes": ["**/*.md"],
+    "markdown": {
+        "lineWidth": 120
+    }
+}

package/extensions/justfile

@@ -0,0 +1,33 @@
+default:
+    @just --list
+
+check: fmt md-fmt lint compile test
+
+compile:
+    tsc --noEmit
+
+fmt:
+    npx @biomejs/biome format --write .
+
+lint:
+    npx @biomejs/biome lint .
+
+md-fmt:
+    dprint fmt --staged --allow-no-files
+
+remove-hooks:
+    rm -f .git/hooks/pre-commit
+    echo "✓ Pre-commit hook removed"
+
+setup: && setup-hooks
+    npm install
+
+setup-hooks:
+    #!/usr/bin/env sh
+    echo '#!/bin/sh' > .git/hooks/pre-commit
+    echo 'just check || exit 1' >> .git/hooks/pre-commit
+    chmod +x .git/hooks/pre-commit
+    echo "✓ Pre-commit hook installed"
+
+test:
+    npm test