@gfgghgftgffg/rpiv-todo-lean

Lean Pi todo extension: the full @juicesharp/rpiv-todo runtime with a compact flat schema and per-session RPC overlay handling preserved.

Packages

Package details

extension

Install @gfgghgftgffg/rpiv-todo-lean from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@gfgghgftgffg/rpiv-todo-lean
Package
@gfgghgftgffg/rpiv-todo-lean
Version
0.1.8
Published
Oct 22, 2026
Downloads
612/mo · 612/wk
Author
gfgghgftgffg
License
MIT
Types
extension
Size
37.7 KB
Dependencies
2 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@gfgghgftgffg/rpiv-todo-lean

Part of the amox-pi-extensions-lean monorepo. A lightweight Pi facade for @juicesharp/rpiv-todo: the complete task-management engine with a compact flat schema, preserved RPC/session/overlay behavior, and per-session isolated overlays.

Original lean facade by kunkun9527; upstream extension by juicesharp. Both are MIT-licensed; the original LICENSE is preserved in this package.

Core features

  • Full task lifecycle: create, update, list, get, delete, clear, status transitions, blockedBy dependencies, metadata, /todos command, and branch replay.
  • Compact provider-facing schema: the native flat schema is kept; verbose field descriptions are stripped and the prompt guidelines are compressed to a single line.
  • Upstream persistence preserved: every state-changing call still appends upstream's rpiv-todo-state custom entry so replay survives codemode-style calls.
  • RPC/session behavior preserved: per-session state slots, per-session overlays, stale-context handling, and the shortcut/command wrappers from the original lean facade are retained.

Installation

This is a public npm package. Install without a version pin:

pi install npm:@gfgghgftgffg/rpiv-todo-lean
pi update --extensions

For a Git fallback, run from the repository checkout:

node scripts/install-extension.mjs rpiv-todo-lean

Update a local Git installation by pulling the checkout and rerunning its installer; pi update does not update local contents. Keep one installation source. To migrate, back up settings, remove only the exact old source shown by pi list, then install the npm source. Do not load another rpiv-todo wrapper alongside it.

Usage

The model sees one tool, todo, with actions create, update, list, get, delete, clear. action is normally required; when it is omitted the facade infers create from subject or update from id plus a mutable field, and otherwise lets upstream report the error.

New tasks default to pending. Listing excludes deleted tasks unless includeDeleted: true; clearing resets task IDs to 1. State persists through rpiv-todo-state entries, with legacy tool-result replay retained. RPC responses are not expanded with an additional full-plan snapshot.

Context footprint (character proxy)

Package Version Registered character proxy
@gfgghgftgffg/rpiv-todo-lean 0.1.8 247
@juicesharp/rpiv-todo 2.13.9 882

Fixed ceil(characters / 4), not provider billing tokens.

Versions

  • Wrapper: 0.1.8
  • Upstream runtime: pinned to @juicesharp/rpiv-todo@2.13.9 and @juicesharp/rpiv-i18n@2.13.9 (exact)
  • Development test baseline: Pi 1.1.0, Node 22.22.1.

Development

Run from the repository root: npm ci, npm run check, npm run contracts:check.

Maintenance

Adaptation points, pinned upstream metadata, upgrade history, source-review decisions, and limitations live in MAINTENANCE.md. This README describes current usage, not individual releases.

License

MIT. This package wraps the MIT-licensed @juicesharp/rpiv-todo; upstream code is consumed as a pinned npm dependency and is never copied into this repository.