@hasna/todos 0.11.45 → 0.11.46

package/README.md

@@ -17,6 +17,38 @@ bun install -g @hasna/todos
 todos --help
 ```
 
+Generate shell completions directly from the registered CLI command tree:
+
+```bash
+todos completions bash > ~/.local/share/bash-completion/completions/todos
+todos completions zsh > ~/.zsh/completions/_todos
+todos completions fish > ~/.config/fish/completions/todos.fish
+```
+
+Print the local CLI manual when you need install/update commands, examples,
+JSON output contracts, error behavior, and the command catalog:
+
+```bash
+todos manual
+todos manual --json
+```
+
+## Terminal Dashboard
+
+`todos dashboard` launches a local Ink TUI with keyboard tabs for overview,
+projects, tasks, plans, runs, dependencies, inbox, and search. It reads only the
+local SQLite database and can also print deterministic snapshots for scripts or
+tests:
+
+```bash
+todos dashboard
+todos dashboard --snapshot --view tasks --search "release" --json
+```
+
+Keyboard hints are shown in the interface: `h`/left and `l`/right move between
+tabs, `1`-`8` jumps to a tab, `/` opens local search, `r` refreshes, and `q`
+quits.
+
 ## Local Project Bootstrap
 
 Bootstrap discovers the current local workspace, registers a project identity,
@@ -138,11 +170,13 @@ and `todos://knowledge/decisions` resources for agent context refreshes.
 Extensions are installed from local manifests, directories with
 `todos.extension.json`, or offline JSON bundles. The registry validates the
 manifest shape, checks `@hasna/todos` compatibility ranges, records requested
-permissions, runs CLI/MCP compatibility checks, dry-runs declared commands
-through the local runner sandbox, verifies optional source checksums or detached
-signatures, and stores trust state in local config only:
+permissions, supports custom commands, MCP tool declarations, templates, hooks,
+and renderers, runs CLI/MCP compatibility checks, dry-runs declared commands and
+renderer commands through the local runner sandbox, verifies optional source
+checksums or detached signatures, and stores trust state in local config only:
 
 ```bash
+todos extensions discover . --json
 todos extensions inspect ./todos.extension.json --json
 todos extensions compat ./todos.extension.json --json
 todos extensions install ./todos.extension.json --checksum sha256:... --trust --json
@@ -494,6 +528,22 @@ MCP clients get the same summaries through `get_agent_reliability_scorecard`,
 `export_agent_reliability_scorecards`, and the `todos://agents/reliability`
 resource.
 
+## Local Agent Reports
+
+Agent reports compose the local planning surfaces into one report for standups,
+handoffs, and agent run planning: ready tasks, blocked tasks, overdue work,
+plan progress, run outcomes, verification evidence, and per-agent summaries.
+
+```bash
+todos reports local --agent codex --format markdown
+todos reports local --project <project-id> --json
+```
+
+MCP clients can list sections with `list_local_report_types` and build the
+same local-only `local_report` contract with `build_local_report`. The report
+uses the local SQLite store only and does not call hosted analytics or external
+services.
+
 ## Local Agent Locking
 
 Task claims and locks are local SQLite leases. Agents can claim the next ready
@@ -760,6 +810,37 @@ The report also includes changelog surfaces and rollback commands. MCP clients
 use `check_release_compatibility` for the same `release_compatibility_report`
 JSON contract.
 
+## Local Usage Ledger
+
+Usage reports summarize local tasks, projects, runs, commands, durations,
+agent-provided token and cost metadata, and run artifact storage. Quota flags
+are simulated locally so agents can check free/pro limits or project budgets
+without sending data anywhere:
+
+```bash
+todos usage report --agent codex --max-tasks 1000 --max-projects 10 --json
+todos usage report --project <project-id> --format markdown
+```
+
+The report is aggregate-only: raw command strings and artifact paths are not
+included. MCP clients use `get_usage_ledger` for the same
+`local_usage_ledger` JSON contract.
+
+## Local Scale Hardening
+
+Scale reports benchmark common local queries, count archive-ready terminal
+tasks, check expected SQLite indexes, run integrity diagnostics, and preview
+database compaction without network access:
+
+```bash
+todos scale report --older-than-days 30 --json
+todos scale report --format markdown
+todos scale compact --json
+```
+
+`todos scale compact --apply` runs `PRAGMA optimize` and `VACUUM` against the
+local SQLite database. The default is a dry run.
+
 ## Local Activity Timeline
 
 The timeline command gives agents one ordered, redacted view of local comments,
@@ -818,6 +899,26 @@ for existing filters, and the metadata is included in local bridge exports.
 MCP clients use `get_task_fields`, `set_task_fields`, and
 `query_tasks_by_fields` for the same local-only workflow.
 
+## Local Workflow States
+
+Projects can define local workflow states such as review, blocked, verifying,
+failed, or released while keeping storage compatible with the canonical task
+statuses:
+
+```bash
+todos workflow states --json
+todos workflow set <task-id> review --json
+todos workflow tasks review --json
+todos workflow migrate --apply --json
+```
+
+Workflow states live in local config under `workflow_states.states`. Each state
+maps to a canonical `canonical_status`, can declare aliases, and can restrict
+allowed transitions. The selected local state is stored in task metadata and is
+included in local bridge exports. MCP clients use `list_workflow_states`,
+`set_task_workflow_state`, `query_tasks_by_workflow_state`, and
+`migrate_workflow_states`.
+
 ## Local Calendar And ICS
 
 Calendar events are derived from local tasks, SLA thresholds, run ledgers, and
@@ -1049,6 +1150,27 @@ unresolved divergent fields in `metadata.sync_conflicts` for manual review.
 Local non-empty title, status, priority, and metadata values win when both sides
 changed.
 
+## Local Backups and Integrity
+
+Create a checksum-protected local backup wrapper around the bridge bundle when
+you need a restorable snapshot with manifest counts and SQLite integrity
+metadata:
+
+```bash
+todos backup create --output todos-backup.json
+todos backup verify todos-backup.json --json
+todos backup restore todos-backup.json --json
+todos backup restore todos-backup.json --apply --resolve-conflicts
+todos backup integrity --json
+```
+
+Backups include the same local projects, task lists, plans, tasks, comments,
+runs, commands, files, commits, refs, verification records, saved views, boards,
+calendar items, and stored artifact contents as bridge exports. The backup
+manifest adds SHA-256 checksums for the full payload, embedded bridge bundle,
+and each bridge section. Restore defaults to dry-run mode and refuses corrupted
+or schema-incompatible bundles before importing.
+
 ## todos.md Markdown Import/Export
 
 `todos.md` files are readable Markdown checklists with an embedded local bridge

package/dist/cli/commands/config-serve-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-serve-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config-serve-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,QAwxC3D"}
+{"version":3,"file":"config-serve-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config-serve-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,QAq0C3D"}

package/dist/cli/commands/help-commands.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerHelpCommands(program: Command): void;
+//# sourceMappingURL=help-commands.d.ts.map

package/dist/cli/commands/help-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/help-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAkCpD"}

package/dist/cli/commands/local-backup-commands.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerLocalBackupCommands(program: Command): void;
+//# sourceMappingURL=local-backup-commands.d.ts.map

package/dist/cli/commands/local-backup-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-backup-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/local-backup-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,QAoH3D"}

package/dist/cli/commands/mcp-hooks-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-hooks-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp-hooks-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwMzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,QA0gCxD"}
+{"version":3,"file":"mcp-hooks-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp-hooks-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwMzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,QAghCxD"}

package/dist/cli/commands/query-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0MzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAw9ErD"}
+{"version":3,"file":"query-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkNzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QA6lFrD"}

package/dist/cli/commands/scale-hardening-commands.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerScaleHardeningCommands(program: Command): void;
+//# sourceMappingURL=scale-hardening-commands.d.ts.map

package/dist/cli/commands/scale-hardening-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale-hardening-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/scale-hardening-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,QAwD9D"}

package/dist/cli/commands/usage-ledger-commands.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerUsageLedgerCommands(program: Command): void;
+//# sourceMappingURL=usage-ledger-commands.d.ts.map

package/dist/cli/commands/usage-ledger-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-ledger-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/usage-ledger-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BzC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,QAiE3D"}

package/dist/cli/components/Dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dashboard.d.ts","sourceRoot":"","sources":["../../../src/cli/components/Dashboard.tsx"],"names":[],"mappings":"AAOA,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,SAAgB,EAAE,EAAE,cAAc,2CAwGxE"}
+{"version":3,"file":"Dashboard.d.ts","sourceRoot":"","sources":["../../../src/cli/components/Dashboard.tsx"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,SAAgB,EAAE,EAAE,cAAc,2CAqHxE"}