saterminal 0.1.0 → 0.3.0

package/AGENTS.md

@@ -1,23 +1,37 @@
+# Environment
+
+I use Nix & `direnv`. Glance `flake.nix` initially at once.
+
 # Git
 
 - Commit regularly.
-- Commit messages should split "what" from "why/how":
-  - First line: conventional commit summary.
-  - Following lines: concise reasons and implementation notes.
-- Prefer backticks for paths, commands, package names, settings, and other literal identifiers that are easier to recognize that way.
+- Prefer subsystem-first commit subjects over Conventional Commits.
+  - Use `subsystem: concise change`.
+  - Do not default to `feat(...)`, `fix(...)`, `chore(...)`, etc.
+  - Pick the subsystem people would search for later: `cli`, `state`, `tui`, `api`, `docs`, `nix`, `test`, or a narrower module when useful.
+- Keep messages compact.
+  - A good small commit can be only a subject line.
+  - Add a body when the reason, tradeoff, or implementation detail matters.
+  - Body bullets should explain why/how, not repeat the subject.
+- Prefer backticks for paths, commands, package names, settings, and other literal identifiers when they improve scanability.
 
 ```text
-feat(darwin/packages): add `btop` and `macmon`
+cli: render activity as square heatmap
 
-- `btop` and `macmon` provide terminal-based system monitoring
-- install them through `environment.systemPackages` so they are available system-wide
-- both packages resolve from the pinned nixpkgs set, so no unstable package source is needed
+- use one colored square per day instead of intensity glyphs
+- keep empty days visible as gray cells
+- orient the grid by week columns and weekday rows
 ```
 
 ```text
-chore(repo): remove unused `documents/` directory
+state: record attempt events
+
+- keep `attempts.csv` as the latest per-question snapshot
+- append every answer to `events.csv` for streaks and activity
+```
 
-- no Nix modules, package config, or templates reference `documents/`
-- the directory only contained standalone agent/document notes
-- removing it keeps the repo focused on active configuration
+```text
+docs: tighten commit guidance
 ```
+
+- Do not force a three-bullet format. Use fewer bullets, more bullets, or none based on the commit.

package/README.md

@@ -1,4 +1,5 @@
 why?
 
 - i don't like how the official SAT question bank forces u to download PDFs
-- official SAT question bank + other third party question readers display the question difficulty and other metadata
+- official SAT question bank + other third party question readers display the question difficulty and other metadata (their UIs are also quite chopped)
+- used to use oneprep until i heard they started AI-generating questions, sooo...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saterminal",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "sat": "./src/main.ts"