@lebronj/pi-suite 0.1.0

package/skills/leetcode-array/problems/best_time_to_buy_and_sell_stock.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+
+def max_profit(prices: list[int]) -> int:
+    min_price = float("inf")
+    best = 0
+
+    for price in prices:
+        if price < min_price:
+            min_price = price
+            continue
+        best = max(best, price - min_price)
+
+    return best
+
+
+if __name__ == "__main__":
+    sample_prices = [7, 1, 5, 3, 6, 4]
+    print(max_profit(sample_prices))

package/skills/leetcode-array/problems/product_of_array_except_self.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+
+def product_except_self(nums: list[int]) -> list[int]:
+    result = [1] * len(nums)
+
+    prefix = 1
+    for index, value in enumerate(nums):
+        result[index] = prefix
+        prefix *= value
+
+    suffix = 1
+    for index in range(len(nums) - 1, -1, -1):
+        result[index] *= suffix
+        suffix *= nums[index]
+
+    return result
+
+
+if __name__ == "__main__":
+    sample_nums = [1, 2, 3, 4]
+    print(product_except_self(sample_nums))

package/skills/leetcode-array/problems/two_sum.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+
+def two_sum(nums: list[int], target: int) -> list[int]:
+    seen: dict[int, int] = {}
+
+    for index, value in enumerate(nums):
+        complement = target - value
+        if complement in seen:
+            return [seen[complement], index]
+        seen[value] = index
+
+    return []
+
+
+if __name__ == "__main__":
+    sample_nums = [2, 7, 11, 15]
+    sample_target = 9
+    print(two_sum(sample_nums, sample_target))

package/skills/pi-skill/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: pi-skill
+description: Reference for this pi agent's installed capabilities, tools, memory system, skills, subagents, web/code search, MCP, and code-intelligence workflows. Use when asked what pi can do, how to use current capabilities, or when changing pi features so this skill stays updated.
+---
+
+# Pi Skill
+
+This skill is the local capability index for this pi setup. Use it to answer "what can you do?", choose the right tool/workflow, and keep user-facing capability docs synchronized when features change.
+
+## Maintenance Rule
+
+When adding, removing, renaming, or materially changing any pi capability in this workspace, update this skill in the same change. This includes tools, packages, extensions, memory behavior, skills, subagents, MCP servers, web/search integrations, and code-intelligence workflows.
+
+## Core Coding Tools
+
+- `read`: read text files and images; use this instead of `cat` for file inspection.
+- `bash`: run shell commands; prefer `rg`/`rg --files` for search.
+- `edit`: precise exact-text replacements in one file.
+- `write`: create or overwrite files.
+- `lsp_diagnostics` / `lsp_navigation`: primary code-intelligence path for diagnostics, definitions, references, hover, symbols, call hierarchy, rename, and workspace diagnostics.
+- `ast_grep_search` / `ast_grep_replace` / `ast_dump`: semantic AST-aware code search and replacement; prefer over raw text search for code patterns.
+- `lens_diagnostics`: inspect pi-lens warnings/errors for files touched this session.
+
+## Memory
+
+Installed memory package: `@jhp/pi-memory` from `.pi/packages/pi-memory`.
+
+Memory files live under `~/.pi/agent/memory/`:
+
+- `MEMORY.md`: durable facts, decisions, and preferences.
+- `USER.md`: structured user profile and stable preferences.
+- `STATE.md`: current dated state, events, temporary facts, and quotas.
+- `REVIEW.md`: review queue for stale or merge-candidate memories.
+- `SCRATCHPAD.md`: checklist for open items.
+- `daily/YYYY-MM-DD.md`: daily append-only logs.
+- `.curator-state.json`: last curator run state.
+- `audit/curator.jsonl`: curator audit trail.
+
+Memory tools:
+
+- `memory_write`: write long-term, daily, user, state, or review memory. Use `target="state"` with metadata for time-sensitive entries.
+- `memory_read`: read long-term, scratchpad, daily, list, user, state, review, or all memory.
+- `memory_edit`: read/add/replace/remove/replace_all/compact structured entries in `MEMORY.md`, `USER.md`, `STATE.md`, and `REVIEW.md`.
+- `scratchpad`: add/done/undo/clear/list checklist items.
+- `memory_search`: qmd-backed keyword, semantic, or deep search across memory files.
+- `memory_curate`: manually run curator lifecycle rules.
+- `memory_curator_enable`: enable external daily curator service using systemd user timer or cron fallback.
+- `memory_curator_disable`: disable and uninstall the external daily curator service.
+- `memory_curator_status`: show service backend, schedule, and state.
+
+Structured metadata example:
+
+```md
+[type:event status:planned date:2026-06-10]
+User plans to watch the NBA Finals.
+```
+
+Curator behavior:
+
+- Exact dedupe.
+- Event status transitions: `planned -> today -> past`.
+- Expired temporary memories go to `REVIEW.md`, not automatic deletion.
+- Quotas reset when month/reset rolls over.
+- Mutations are audited to `audit/curator.jsonl`.
+- External service control lives in `@jhp/pi-memory`: `jhp-pi-memory-curator enable|disable|status|run-once`.
+- The external curator service is independent of the pi process. It uses a systemd user timer when available, with cron fallback, so scheduled curation can run even when pi is closed.
+- Users can ask pi to enable, disable, or inspect the service via `memory_curator_enable`, `memory_curator_disable`, and `memory_curator_status`.
+- Before uninstalling `@jhp/pi-memory`, run `memory_curator_disable` or `jhp-pi-memory-curator disable` so any systemd timer or cron entry is removed.
+- `.pi/extensions/memory-curator.ts` is deprecated and only warns users to use `@jhp/pi-memory` service tools.
+
+## Web And Research
+
+- `web_search`: broad web research. Prefer `queries` with 2-4 varied angles for comprehensive research.
+- `fetch_content`: fetch readable content from URLs, GitHub repos, YouTube transcripts/video frames, and local videos. For video questions, pass the user's exact question as `prompt`.
+- `get_search_content`: retrieve full content saved by `web_search` or `fetch_content`.
+- `code_search`: search programming examples, docs, APIs, GitHub, and Stack Overflow; use for library/API/debugging questions before implementation.
+- `librarian` skill: use for evidence-backed open-source library internals with exact GitHub source citations.
+
+## Subagents
+
+Use the `pi-subagents` skill and `subagent` tool for delegation.
+
+Typical uses:
+
+- Advisory review of plans or diffs.
+- Parallel investigation across multiple files or hypotheses.
+- Implementation handoff with structured acceptance criteria.
+- Goal-style loops with verification evidence.
+
+Rules:
+
+- Call `subagent` with `action: "list"` before executing agents.
+- Use acceptance contracts for broad implementation handoffs.
+- Keep one parent agent in control; subagents contribute context, review, or isolated execution.
+
+## MCP
+
+Use `mcp` to discover and call Model Context Protocol servers/tools.
+
+Common flow:
+
+```text
+mcp({})                         # status
+mcp({ server: "name" })         # list tools
+mcp({ search: "query" })        # find tools
+mcp({ describe: "tool_name" })  # inspect schema
+mcp({ tool: "tool_name", args: "{}" })
+```
+
+Do not route built-in pi tools through MCP; call them directly.
+
+## Existing Skills
+
+Local project skills currently include:
+
+- `add-llm-provider`: checklist for adding providers to `packages/ai`.
+- `image-to-editable-ppt-slide`: rebuild reference images as editable PowerPoint slides.
+- `leetcode-array`: array problem patterns and Python references.
+- `weather`: current weather and forecasts using no-key services.
+- `pi-skill`: this capability index.
+
+Package-provided skills currently include:
+
+- `librarian`: library internals research with source citations.
+- `pi-subagents`: subagent delegation workflows.
+- `ast-grep`: AST-aware code search/replace guidance.
+- `lsp-navigation`: LSP diagnostics and navigation guidance.
+- `write-ast-grep-rule`: author pi-lens ast-grep rules.
+- `write-tree-sitter-rule`: author pi-lens tree-sitter rules.
+
+## Pi Package And Extension Notes
+
+Project package configuration is in `.pi/settings.json` and `.pi/npm/package.json`.
+
+Current project packages:
+
+- `@jhp/pi-memory`
+- `pi-web-access`
+- `pi-mcp-adapter`
+- `pi-subagents`
+- `pi-lens`
+
+Project extensions are in `.pi/extensions/`. Important current extension:
+
+- `memory-curator.ts`: deprecated compatibility notice only. The external curator service is managed by `@jhp/pi-memory`.
+
+## Recommended Workflows
+
+- For code changes: inspect files, edit, run targeted tests if tests changed, then run `npm run check` for repo code changes.
+- For memory changes: use `memory_write` for new facts and `memory_edit` for updates/removals.
+- For time-sensitive memory: write structured `STATE.md` entries with `type`, `status`, and date/reset metadata.
+- For web facts or current events: use `web_search`; for page/video details, use `fetch_content`.
+- For library internals: use `librarian` or `code_search` with source-backed evidence.
+- For broad or risky tasks: use subagents for investigation/review, then integrate deliberately.

package/skills/weather.md

@@ -0,0 +1,49 @@
+---
+name: weather
+description: Get current weather and forecasts (no API key required).
+homepage: https://wttr.in/:help
+metadata: {"clawdbot":{"emoji":"🌤️","requires":{"bins":["curl"]}}}
+---
+
+# Weather
+
+Two free services, no API keys needed.
+
+## wttr.in (primary)
+
+Quick one-liner:
+```bash
+curl -s "wttr.in/London?format=3"
+# Output: London: ⛅️ +8°C
+```
+
+Compact format:
+```bash
+curl -s "wttr.in/London?format=%l:+%c+%t+%h+%w"
+# Output: London: ⛅️ +8°C 71% ↙5km/h
+```
+
+Full forecast:
+```bash
+curl -s "wttr.in/London?T"
+```
+
+Format codes: `%c` condition · `%t` temp · `%h` humidity · `%w` wind · `%l` location · `%m` moon
+
+Tips:
+- URL-encode spaces: `wttr.in/New+York`
+- Airport codes: `wttr.in/JFK`
+- Units: `?m` (metric) `?u` (USCS)
+- Today only: `?1` · Current only: `?0`
+- PNG: `curl -s "wttr.in/Berlin.png" -o /tmp/weather.png`
+
+## Open-Meteo (fallback, JSON)
+
+Free, no key, good for programmatic use:
+```bash
+curl -s "https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"
+```
+
+Find coordinates for a city, then query. Returns JSON with temp, windspeed, weathercode.
+
+Docs: https://open-meteo.com/en/docs

package/vendor/pi-memory/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jay Zeng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/pi-memory/README.md

@@ -0,0 +1,223 @@
+# @jhp/pi-memory
+
+Structured, time-aware memory extension for pi. It stores memory as plain Markdown, exposes one set of memory tools to the agent, and includes curator rules for lifecycle maintenance.
+
+## Features
+
+- Plain Markdown storage under `~/.pi/agent/memory`.
+- Unified tools for memory write/read/edit/search and scratchpad management.
+- Structured `USER.md`, `STATE.md`, and `REVIEW.md` entries with metadata.
+- Optional qmd-powered keyword, semantic, and deep search.
+- KV cache-stable context injection by default.
+- Curator core for exact dedupe, event lifecycle updates, temporary review, quota reset, and audit logs.
+- Review-first learning candidates that can become memory promotions or disabled skill drafts after approval.
+- Optional external curator service via systemd user timer or cron so curation can run even when pi is closed.
+
+## Installation
+
+```bash
+pi install npm:@jhp/pi-memory
+```
+
+Local development:
+
+```bash
+pi install ./pi-memory
+```
+
+Optional search support requires qmd:
+
+```bash
+bun install -g https://github.com/tobi/qmd
+qmd collection add ~/.pi/agent/memory --name pi-memory
+qmd embed
+```
+
+The extension auto-creates the `pi-memory` qmd collection and path contexts on session start when qmd is available.
+
+## File Layout
+
+```text
+~/.pi/agent/memory/
+  MEMORY.md              # Durable facts, decisions, and preferences
+  USER.md                # Structured user profile and stable preferences
+  STATE.md               # Current dated state, events, temporary facts, quotas
+  REVIEW.md              # Review queue for stale or merge-candidate memories
+  SCRATCHPAD.md          # Checklist of open items
+  .curator-state.json    # Last curator run state
+  audit/curator.jsonl    # Curator audit trail
+  daily/YYYY-MM-DD.md    # Daily append-only logs
+~/.pi/agent/skill-drafts/
+  <slug>/SKILL.md        # Disabled skill drafts created after approval
+```
+
+Structured entries are separated by `§` and may start with metadata:
+
+```md
+[type:event status:planned date:2026-06-10]
+User plans to watch the NBA Finals.
+```
+
+Metadata keys currently supported by tools and curator rules:
+
+- `type`: `fact`, `preference`, `event`, `temporary`, `quota`, `review`
+- `status`: `planned`, `today`, `past`, `active`, `exhausted`, `archived`, etc.
+- `date`: event or temporary memory date, `YYYY-MM-DD`
+- `reset`: quota reset date/time
+- `month`: quota month, `YYYY-MM`
+- `provider`: quota provider
+- `used`, `limit`: quota counters
+- `ttlDays`: temporary memory TTL hint
+
+## Tools
+
+| Tool | Purpose |
+| --- | --- |
+| `memory_write` | Write `MEMORY.md`, daily logs, or structured `USER.md` / `STATE.md` / `REVIEW.md` entries |
+| `memory_read` | Read one memory target, all memory files, or daily log lists |
+| `memory_edit` | Read/add/replace/remove/replace_all/compact structured entries |
+| `scratchpad` | Manage checklist items in `SCRATCHPAD.md` |
+| `memory_search` | Search all memory files with qmd |
+| `memory_curate` | Run curator rules immediately |
+| `memory_learning_approve` | Approve one proposed memory or skill promotion by exact id |
+| `memory_learning_reject` | Reject or archive one review item by exact id |
+| `memory_skill_drafts` | List proposed skill drafts |
+| `memory_curator_enable` | Enable the external daily curator service |
+| `memory_curator_disable` | Disable the external daily curator service |
+| `memory_curator_status` | Show service backend, schedule, and state |
+
+### memory_write Targets
+
+- `long_term`: append/overwrite `MEMORY.md`
+- `daily`: append today's daily log
+- `user`: append structured `USER.md` entry
+- `state`: append structured `STATE.md` entry
+- `review`: append structured `REVIEW.md` entry
+
+For time-sensitive facts, prefer `target="state"` plus metadata:
+
+```json
+{
+  "target": "state",
+  "type": "event",
+  "date": "2026-06-10",
+  "content": "User plans to watch the NBA Finals."
+}
+```
+
+## Context Injection
+
+By default, pi-memory injects a stable snapshot into the system prompt. It includes:
+
+1. Open scratchpad items
+2. Today's daily log
+3. qmd search results, only in `PI_MEMORY_SNAPSHOT=per-turn` mode
+4. `USER.md`
+5. current `STATE.md` entries, excluding `status:past` and `status:archived`
+6. `MEMORY.md`
+7. Yesterday's daily log
+
+The stable snapshot refreshes on session start, compaction, long-term or structured writes, and day rollover. Use `memory_read` or `memory_search` for the latest authoritative state.
+
+## Curator
+
+The curator core is included in this package and can be run with `memory_curate` or by the external curator service. Current rules:
+
+- Exact duplicate entries are deduplicated.
+- `type:event` entries move from `planned`/`today` to `past` after their `date` passes.
+- `type:event status:planned` becomes `status:today` on the event date.
+- Expired `type:temporary` entries append a review item to `REVIEW.md` instead of being deleted.
+- `type:quota` entries reset to `active` with `used:0` when their month/reset rolls over.
+- Every applied patch is written to `audit/curator.jsonl`.
+
+The curator deliberately avoids semantic auto-delete or semantic auto-merge in this version. Those should first become review entries to avoid losing user memory.
+
+## Review-First Learning
+
+Session shutdown may extract conservative learning candidates from the recent conversation text. Candidates are written only to `REVIEW.md`; they are not injected as normal context, not written to long-term memory, and not enabled as skills.
+
+Candidate examples:
+
+```md
+[type:review status:candidate id:rev_abc kind:preference confidence:medium seen:2 first_seen:2026-06-10 last_seen:2026-06-12 target_hints:memory]
+Signature: User prefers concise direct answers.
+Summary: User prefers concise direct answers.
+```
+
+```md
+[type:review status:candidate id:rev_def kind:skill_candidate confidence:medium seen:3 first_seen:2026-06-10 last_seen:2026-06-12 target_hints:skill]
+Signature: fix non erasable TypeScript syntax in pi source
+Summary: Replace enum and parameter properties with erasable syntax.
+```
+
+When candidates repeat, pi-memory updates the existing candidate instead of appending duplicates. It increments `seen`, updates `last_seen`, preserves higher confidence, and appends compact new evidence.
+
+`memory_curate` can turn stable candidates into proposals:
+
+- `kind:memory_promotion status:proposed` for durable preferences, project facts, or concise lessons.
+- `kind:skill_promotion status:proposed` for repeated skill-worthy methods.
+
+Approval is explicit by default:
+
+- `memory_learning_approve` on a memory proposal writes `MEMORY.md`, `USER.md`, or `STATE.md` depending on the proposal target.
+- `memory_learning_approve` on a skill proposal writes `~/.pi/agent/skill-drafts/<slug>/SKILL.md` and marks the proposal approved.
+- Skill drafts are disabled. They are not moved into enabled skill directories automatically.
+- `memory_learning_reject` marks a candidate or proposal as `rejected` or `archived` without deleting it.
+
+Old candidates are lifecycle-managed without deletion. Low-confidence candidates can become `archived`; others become `needs_review` first. `REVIEW.md` remains the evidence and audit trail, so approved items are marked rather than removed.
+
+Current learning extraction is text-based: it reads user/assistant conversation messages and asks the active model for structured candidates. It does not yet inspect structured tool-call graphs directly. Curator patch audit remains in `audit/curator.jsonl`; learning approvals are tracked through `REVIEW.md` proposal metadata and status changes.
+
+## External Curator Service
+
+`@jhp/pi-memory` includes a CLI and pi tools for an external daily service. The service is independent of the pi process, so curation can still run when pi is closed.
+
+CLI:
+
+```bash
+jhp-pi-memory-curator enable --schedule 03:00
+jhp-pi-memory-curator status
+jhp-pi-memory-curator run-once
+jhp-pi-memory-curator disable
+```
+
+Pi tools and commands:
+
+- `memory_curator_enable` / `/memory-curator-enable [HH:MM]`
+- `memory_curator_disable` / `/memory-curator-disable`
+- `memory_curator_status` / `/memory-curator-status`
+
+The controller uses a systemd user timer when available and falls back to cron. State is written to `.curator-service.json` in the memory directory. Removing the package disables future pi tools; run disable before uninstalling if your package manager does not run uninstall lifecycle scripts.
+
+## Configuration
+
+| Variable | Values | Default | Description |
+| --- | --- | --- | --- |
+| `PI_MEMORY_DIR` | path | `~/.pi/agent/memory` | Override storage directory |
+| `PI_MEMORY_SNAPSHOT` | `stable`, `per-turn` | `stable` | Stable context injection or legacy per-turn rebuild |
+| `PI_MEMORY_QMD_UPDATE` | `background`, `manual`, `off` | `background` | Control qmd update after writes |
+| `PI_MEMORY_NO_SEARCH` | `1` | unset | Disable per-turn search injection |
+| `PI_MEMORY_SUMMARIZE_TRANSITIONS` | `1`, `true`, `yes`, `on` | unset | Also summarize lifecycle transitions |
+| `PI_MEMORY_LEARNING` | `off`, `review`, `auto-review` | `review` | Control session learning candidate extraction |
+| `PI_MEMORY_LEARNING_MIN_CONFIDENCE` | `low`, `medium`, `high` | `medium` | Minimum extractor confidence to keep |
+| `PI_MEMORY_SKILL_DRAFTS` | `off`, `review` | `review` | Allow curator to propose disabled skill drafts |
+| `PI_MEMORY_AUTO_APPROVE_MEMORY` | `1`, `true`, `yes`, `on` | unset | YOLO mode for approving newly created memory proposals |
+| `PI_MEMORY_AUTO_APPROVE_SKILL_DRAFTS` | `1`, `true`, `yes`, `on` | unset | YOLO mode for creating newly proposed disabled skill drafts |
+
+## Development
+
+```bash
+npm install --ignore-scripts
+npm test
+npm run pack:check
+```
+
+This package is a pi package. The pi manifest is in `package.json`:
+
+```json
+{
+  "pi": {
+    "extensions": ["./index.ts"]
+  }
+}
+```