@lacodda/rigger 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +122 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,122 @@
1
+ <p align="center"><img src="https://github.com/lacodda/rigger/raw/main/assets/banner.svg" alt="rigger - one seat for every project and task" width="720"></p>
2
+
3
+ > One seat for all your projects and tasks: a local record of what is done, what is next and when it ships - read by you and your coding assistant.
4
+
5
+ <p align="center">
6
+ <a href="https://crates.io/crates/rigger"><img src="https://img.shields.io/crates/v/rigger?style=flat-square" alt="crates.io"></a>
7
+ <a href="https://www.npmjs.com/package/@lacodda/rigger"><img src="https://img.shields.io/npm/v/@lacodda/rigger?style=flat-square" alt="npm"></a>
8
+ <a href="https://github.com/lacodda/rigger/actions"><img src="https://img.shields.io/github/actions/workflow/status/lacodda/rigger/ci.yml?style=flat-square" alt="CI"></a>
9
+ <a href="https://github.com/lacodda/rigger/blob/main/LICENSE"><img src="https://img.shields.io/github/license/lacodda/rigger?style=flat-square" alt="License"></a>
10
+ </p>
11
+
12
+ ## Why
13
+
14
+ Run more than a handful of projects and the record of them scatters: a plan in one file, a changelog in another, a session log the assistant writes for itself, a release calendar kept by hand. Three symptoms follow. You stop reading the record, because it is prose and prose cannot be filtered or summed up across projects. The assistant reads it every session at full price, and the biggest project no longer fits in a context window at all. And the facts about what actually shipped live in git, where nobody looks.
15
+
16
+ rigger keeps the record as data, in a local SQLite file, and derives everything else from it: the five-line digest you read, the context packet the assistant starts from, the calendar of what ships when, and the queue of decisions waiting for you.
17
+
18
+ ## A first look
19
+
20
+ ```console
21
+ $ rigger init
22
+ Created C:\Users\you\AppData\Local\lacodda\rigger\data\rigger.db (schema version 1)
23
+ Next: rigger project add <path>
24
+
25
+ $ rigger project add C:\dev\sample
26
+ Recorded 'sample' at C:\dev\sample
27
+ remote: https://github.com/acme/sample.git
28
+
29
+ $ rigger import sample --hub C:\dev\sample\hub
30
+ sample:
31
+ versions 3 added, 0 updated
32
+ tasks 2 added, 0 updated
33
+ decisions 1 added
34
+ questions 1 added
35
+
36
+ $ rigger doctor
37
+ database: C:\Users\you\AppData\Local\lacodda\rigger\data\rigger.db
38
+ schema: version 1
39
+ projects: 1
40
+ versions: 3
41
+ tasks: 2
42
+ sessions: 0
43
+ events: 2
44
+ ```
45
+
46
+ Years of notes arrive in one command, and running it again is quiet. Then a session starts from the packet rather than from the notes:
47
+
48
+ ```console
49
+ $ rigger context sample
50
+ # sample
51
+
52
+ C:\dev\sample
53
+ https://github.com/acme/sample.git
54
+ Last shipped: v0.2.0 on 2026-09-03
55
+ 1 versions planned, 2 tasks open
56
+
57
+ ## Current stage: v0.3.0 · Search
58
+ - full-text index
59
+ - a query language
60
+
61
+ ## Waiting for the owner
62
+ - [2] Pick the release day.
63
+
64
+ ## Recent
65
+ - 2026-09-03 · decision · The record is the database — Prose cannot be filtered.
66
+
67
+ ## Next step
68
+ Ship the importer next.
69
+ ```
70
+
71
+ That packet costs 96 tokens here and holds a 3000-token budget on a project with years of history - against tens of thousands for reading the notes it came from, which past a certain size no longer fit at all.
72
+
73
+ A project is named after its directory - the name you call it by, not the one its manifest publishes under - and `--name` overrides. Every command that shows facts also prints them with `--json`.
74
+
75
+ ## What it will do
76
+
77
+ - **Projects, versions, tasks, sessions.** A project has a map of versions; a version is a stage that ends in a tag; a task is a unit of work inside a version (at home) or a ticket across several projects and branches (at work). One model, two profiles.
78
+ - **Facts from git.** A pushed tag means the version shipped, on that date. Commits since the last tag are activity. The plan cannot claim more than git confirms.
79
+ - **A context packet instead of a hub.** `rigger context <project>` prints what the assistant needs to start - state, current stage, open questions, last events, next step - within a fixed token budget.
80
+ - **An MCP server as the assistant's only pen.** Decisions, findings, pitfalls, changes and the next step are recorded as events through tools, not by editing markdown.
81
+ - **The owner's inbox.** Every question waiting for your answer, across all projects, in one list.
82
+ - **A release calendar** with tiers and rhythm, derived from the same data.
83
+ - **Hubs as an export.** The markdown files you keep in Obsidian are generated from the database, not written by hand.
84
+
85
+ ## Status
86
+
87
+ v0.3.0 gives the assistant its door: the database, projects, `import`, `backup`, `context` and `note`. The road to 1.0 is twenty-two small releases in seven blocks:
88
+
89
+ | Block | Versions | What it delivers |
90
+ | --- | --- | --- |
91
+ | Record | 0.1 - 0.5 | database and projects, hub import, the context packet, a Claude Code session from it, the MCP server |
92
+ | Facts | 0.6 - 0.8 | tags and commits as truth, changes read from commits, search and "why" |
93
+ | Owner | 0.9 - 0.12 | inbox and digest, the release calendar, the Monday brief, retro |
94
+ | Sessions | 0.13 - 0.14 | sessions with an end-of-session journal, hubs exported from the database |
95
+ | Line | 0.15 - 0.16 | thin project skills, every project of a line recorded at once |
96
+ | Tasks | 0.17 - 0.21 | the ticket profile, task cards, activity from branches, incoming material, snooze and handoff |
97
+ | Stabilisation | 0.22 | `--json` everywhere, docs, a signed binary where needed |
98
+
99
+ **1.0 "Truth in the database":** a full week where every session on every project runs through rigger and no hub is edited by hand. A desktop window (Tauri) and code knowledge follow in 1.x.
100
+
101
+ ## Install
102
+
103
+ ```powershell
104
+ irm https://raw.githubusercontent.com/lacodda/rigger/main/tools/install.ps1 | iex
105
+ ```
106
+
107
+ ```bash
108
+ curl -fsSL https://raw.githubusercontent.com/lacodda/rigger/main/tools/install.sh | sh
109
+ ```
110
+
111
+ ```bash
112
+ npm i -g @lacodda/rigger
113
+ cargo install rigger
114
+ ```
115
+
116
+ ## Documentation
117
+
118
+ https://lacodda.github.io/rigger/ - getting started, concepts, and a reference page per command. Architecture decisions live in https://github.com/lacodda/rigger/tree/main/docs/adr.
119
+
120
+ ## License
121
+
122
+ MIT - see https://github.com/lacodda/rigger/blob/main/LICENSE.
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@lacodda/rigger",
3
- "version": "0.1.0",
3
+ "version": "0.3.0",
4
4
  "rigger": {
5
- "binary": "v0.1.0"
5
+ "binary": "v0.3.0"
6
6
  },
7
7
  "description": "One seat for all your projects and tasks: a local record of what is done, what is next and when it ships - read by you and your coding assistant",
8
8
  "license": "MIT",