human-hindsight 1.8.2 → 1.8.3

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 (3) hide show
  1. package/README.md +23 -16
  2. package/dist/cli.js +233 -151
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -165,8 +165,11 @@ Switch between **Prompts** and **Preferences** to search, filter by domain,
165
165
  sort, and copy items with one click. Preferences are deduplicated across tasks
166
166
  and can be sorted by frequency, recency, or text. Search also matches their
167
167
  evidence and source prompt titles.
168
- Domain filters start with broad categories and reveal optional subdomains,
169
- up to five levels deep. Selecting a parent includes all its descendants.
168
+ One expandable domain tree lets you browse from broad categories down to
169
+ five levels. Select a parent to include its descendants, or expand its arrow
170
+ to choose a child. Prompt details show shared ancestry once; open **+N** to
171
+ see the full grouped hierarchy. Domain labels from the same evidence are
172
+ deduplicated regardless of casing.
170
173
  Existing flat labels are grouped locally without changing the library or
171
174
  making a model call; newly distilled sessions use hierarchical domain paths.
172
175
  **Preview** renders Markdown headings, lists, tables, links, blockquotes, task
@@ -175,20 +178,23 @@ uses that original Markdown, including when the preview is selected.
175
178
 
176
179
  Each prompt links to its preference candidates. Newly distilled candidates
177
180
  show exact human quotations, message references, and global/project/task scope;
178
- older observations are labeled for review. Candidates can come from failed or
179
- unfinished sessions too. You can bookmark either view and use your browser's
180
- Back and Forward buttons. **View all candidates** shows observations;
181
- **Accepted instructions** provides the reviewed block for `CLAUDE.md` or
182
- `AGENTS.md`. Changed source evidence returns a candidate to review.
181
+ older observations are labeled for review. Open the collapsed **Source evidence**
182
+ section to see quotations. Use the check, pencil, and dismiss icons to review
183
+ a candidate; each control has an accessible label and hover description.
184
+ Candidates can come from failed or unfinished sessions too. You can bookmark
185
+ either view and use your browser's Back and Forward buttons. **All** shows
186
+ observations; **Accepted** provides the reviewed instruction block for `CLAUDE.md`
187
+ or `AGENTS.md`. Changed source evidence returns a candidate to review.
183
188
 
184
189
  The terminal `preferences` command also exports accepted rules by default.
185
190
  Use `--include-unreviewed` explicitly to inspect draft observations in scripts.
186
191
  This flag does not accept them or change their review status.
187
192
 
188
- The tips bar starts with an open-source and privacy reminder, then rotates
189
- through quick tips with copyable `npx human-hindsight@latest` commands.
190
- Pause it, hide it, or restore it with **Show tips**. Hidden tips stay hidden
191
- when you reload the same local address.
193
+ A compact tip card sits in the header and flips through quick suggestions.
194
+ Open it to read the explanation, copy a `npx human-hindsight@latest` command,
195
+ or pause or hide tips. The lightbulb restores hidden tips. Rotation pauses
196
+ while you interact, and reduced-motion settings disable the flip animation.
197
+ Hidden tips stay hidden when you reload the same local address.
192
198
 
193
199
  Export and distill show an open-source/privacy reminder near the start.
194
200
  Interactive terminals get a colorful elapsed-time progress indicator during
@@ -198,8 +204,8 @@ Consolidation is optional: `npx human-hindsight@latest preferences --consolidate
198
204
  uses your accepted rules in a call through your own coding harness and its configured provider,
199
205
  with consent and the subscription/credit cost explained first. Successful
200
206
  results are saved, with their Markdown and input metadata, in
201
- `<home>/library/preferences.consolidated.json`. Refresh the GUI to open
202
- **Saved consolidation**. Every output rule links to its input preferences.
207
+ `<home>/library/preferences.consolidated.json`. Reload the browser and select
208
+ **Saved** to open the consolidation. Every output rule links to its input preferences.
203
209
  Coverage, scope, explicit conditions, and direct contradictions are checked;
204
210
  invalid output gets one semantic correction attempt. Failed, empty, incomplete,
205
211
  or declined results leave the last saved result intact. Saved results are
@@ -208,9 +214,10 @@ results remain readable and need regeneration before copying as reviewed
208
214
  instructions.
209
215
 
210
216
  The viewer uses a minimal black-and-white palette and system monospace fonts.
211
- Light and dark appearance follow your system setting. Local edits, ratings,
212
- and session counts remain visible. Use **Refresh** after changing files and
213
- press `/` to focus search.
217
+ Light and dark appearance follow your system setting. Rows emphasize titles;
218
+ session counts remain visible, and the information icon reveals dates,
219
+ confidence, local edits, and ratings. Reload the browser after changing files
220
+ and press `/` to focus search.
214
221
 
215
222
  The GUI uses Node's built-in HTTP server and bundled HTML/CSS/JavaScript:
216
223
  no frontend framework, database, font download, or external assets.