paneltir 0.11.0 → 0.12.1

package/CLAUDE_MD_SNIPPET.md

@@ -30,7 +30,10 @@ library shared with other projects. Rules:
 - The dashboard palette lives in <!-- path to this project's theme file, e.g.
   src/dashboard-theme.ts -->. Colour changes go there, never in the kit. The
   dashboard's **shape** is a `DashboardThemeForm` passed to the same provider
-  (`panel` or `ledger`); it too is this project's choice, not the kit's.
+  (`panel`, `ledger` or `warRoom`); it too is this project's choice, not the
+  kit's. `warRoom` is the console one — square, tight, priority as a bar down
+  the left edge of each row — and the only one that fits more rows on a screen
+  rather than fewer.
 - **This project's theme goes to `PanelApp` as `extraThemes`, never as
   `themes`.** `extraThemes` offers it alongside the four the kit ships;
   `themes` means "exactly these and nothing else", so passing one theme there
@@ -52,6 +55,28 @@ library shared with other projects. Rules:
   moved underneath you, or both. The second is the one no `git diff` can find,
   because there is nothing in this project's history to diff against, and it is
   how a fix released upstream stayed out of a project for two releases.
+- **A card finished more than a week ago leaves the board.** Nothing is
+  deleted and nothing is written: the panel derives it from `completedAt` on
+  every render, stops drawing that card in its column, and lists it in the
+  record view with the date it was finished. A done column that looks short has
+  not lost anything — read the board file, not the screen, when counting what
+  is finished. A card in a done column with no `completedAt` is never archived,
+  because its age is not known, which is one more reason to stamp the date when
+  a card is moved to done.
+- **The top of the board says what is waiting on you and whether the system is
+  working.** Cards in the owner's column, questions nobody has answered, and
+  orders waiting on Claude, each as a count that filters the board or opens the
+  question when tapped — beside the health pills the project supplies. Nothing
+  to do there draws one sentence instead of a row of noughts.
+- **A second problem found mid-card is fixed or filed, never a reason to
+  stop.** Small, reversible and inside what was already being touched: fixed in
+  the same pass. Anything larger becomes a card in `ideas` and the original work
+  carries on. And a detail a card does not specify is Claude's to choose — that
+  is the normal state of a card rather than a gap in it. Only `askme`, `explain`
+  and `hold` mean stop, and an undecided question holds back only the part of
+  the work that depends on it. A question that needs the owner is asked on the
+  board as a choice with `value: null`, where it outlives the conversation,
+  never as a session that stalls waiting for a reply.
 - **The panel explains itself once.** New readers get a short guided tour the
   first time they open the board; each note is dismissed and stays dismissed.
   **Help** in the header reports what the panel needs — the password, the

package/INSTALL.md

@@ -19,7 +19,7 @@ identity** — never another project's.
    npm install paneltir
 
    # or, without npm access, straight from the repository:
-   # npm install github:daifukus/paneltir#v0.11.0
+   # npm install github:daifukus/paneltir#v0.12.1
    ```
 
    (Use the tag you were given; never install without pinning a version.)
@@ -237,7 +237,7 @@ identity** — never another project's.
 
    ```bash
    npx paneltir version          # version, fingerprint, where it came from
-   npx paneltir check 0.11.0      # exits non-zero if that is not what is installed
+   npx paneltir check 0.12.1      # exits non-zero if that is not what is installed
    npx paneltir board            # read the board and say what is wrong with it
    ```
 

package/README.md

@@ -54,7 +54,7 @@ tag rather than a branch, so an unfinished push cannot reach a project:
 npm install paneltir
 
 # or, without npm access, straight from the repository:
-# npm install github:daifukus/paneltir#v0.11.0
+# npm install github:daifukus/paneltir#v0.12.1
 ```
 
 Installing from Git runs the `prepare` script, which builds `dist/`, so the

package/bin/paneltir.mjs

@@ -614,8 +614,25 @@ async function run(args) {
   // rendered at the bottom of the revisions log and fell outside the bell's
   // newest-first window — a record of work that read as the first thing ever
   // done here.
+  /*
+   * An id the board does not already have. The id used to be `run-<date>-<n>`
+   * with `n` the list's length, which is unique only while the list only ever
+   * grows: once it reaches the cap below and is trimmed, the length stops
+   * moving and every pass on the same day gets the same id. Two runs sharing
+   * an id is two React keys colliding in the revisions log, and one bell entry
+   * standing for both — mark the first seen and the second is silenced too,
+   * which is the fault `PanelNotification.id` warns about by name.
+   */
+  const used = new Set(board.runs.map((run) => run?.id))
+  let serial = board.runs.length + 1
+  let id = `run-${date}-${String(serial).padStart(3, '0')}`
+  while (used.has(id)) {
+    serial += 1
+    id = `run-${date}-${String(serial).padStart(3, '0')}`
+  }
+
   board.runs.push({
-    id: `run-${date}-${String(board.runs.length + 1).padStart(3, '0')}`,
+    id,
     date,
     by,
     summary,

package/dist/index.d.ts

@@ -104,8 +104,13 @@ interface DashboardThemeForm {
      *   carrying a coloured bar. The default.
      * - `ledger` — cards are ruled rows in a column with no fill, separated by
      *   hairlines and marked in the gutter. Reads as a book rather than a HUD.
+     * - `warRoom` — an operations console. Square, hairline-ruled, tight, with
+     *   priority carried as a full-height bar at the left edge of every row and
+     *   counts set in the monospace face so columns of numbers line up. It is
+     *   the shape for a board somebody is watching rather than browsing: state
+     *   before ornament, and as many rows on the screen as will fit.
      */
-    shape?: 'panel' | 'ledger';
+    shape?: 'panel' | 'ledger' | 'warRoom';
     /** Radius of columns, tiles and sheets. */
     radiusPanel?: string;
     /** Radius of cards. */
@@ -195,10 +200,25 @@ declare const ledgerForm: DashboardThemeForm;
  * free, so the shape does the separating instead.
  */
 declare const paperForm: DashboardThemeForm;
+/**
+ * An operations console: square, tight, ruled, state before ornament.
+ *
+ * `panel` is a board you browse and `ledger` is a book you read; this is one
+ * somebody is watching. So the spacing scale comes down rather than up — it is
+ * the only form below 1 — the radii go flat, the labels are tracked out the way
+ * a console tracks them, and the face for anything countable is the monospace
+ * one, because a column of numbers that does not line up cannot be scanned.
+ *
+ * It changes the drawing and not the palette: a war room in Old Money's greens
+ * is still Old Money. That is the whole point of a form being separate from
+ * its colour.
+ */
+declare const warRoomForm: DashboardThemeForm;
 declare const THEME_FORMS: {
     readonly panel: DashboardThemeForm;
     readonly ledger: DashboardThemeForm;
     readonly paper: DashboardThemeForm;
+    readonly warRoom: DashboardThemeForm;
 };
 type ThemeFormName = keyof typeof THEME_FORMS;
 declare const THEME_PRESETS: {
@@ -257,6 +277,63 @@ declare function HealthPillRow({ children }: {
     children: React.ReactNode;
 }): React.JSX.Element;
 
+/**
+ * How loudly an item asks to be looked at.
+ *
+ * Deliberately three rather than the four a health pill carries: this row
+ * answers "is anything waiting on me", and "unknown" is not an answer to that
+ * question — a number is either zero or it is not.
+ */
+type SituationTone = 'clear' | 'attention' | 'alarm';
+interface SituationItem {
+    id: string;
+    /** What is waiting. Short: this is read at a glance, not studied. */
+    label: string;
+    count: number;
+    /** Who it is waiting on, or what it means. One line, under the label. */
+    hint?: string;
+    tone?: SituationTone;
+    /** Where looking at it leads. Without this the number is not a control. */
+    onClick?: () => void;
+}
+interface SituationRowProps {
+    /** The heading over the left half. */
+    blockingLabel: string;
+    /**
+     * What is outstanding. An item with a count of zero is still drawn — a
+     * counter that disappears when it reaches zero cannot be read as "nothing is
+     * waiting", only as "the panel is not telling me", which is the reading this
+     * row exists to prevent.
+     */
+    blocking: SituationItem[];
+    /** Said when every count is zero, in place of a row of noughts. */
+    clearLabel: string;
+    /** The heading over the right half. */
+    statusLabel: string;
+    /** The system's own state — health pills, a build, a version. */
+    status?: React.ReactNode;
+}
+/**
+ * The two things a board is opened to find out: whether anything is waiting on
+ * the reader, and whether the machinery under it is working.
+ *
+ * Both were already on the screen and neither was prominent. The counts sat in
+ * a grid of six identical tiles, where "three cards are yours" reads exactly as
+ * loudly as "forty-one are done"; the health pills sat under them as a line of
+ * small grey text. A board is looked at to decide what to do next, and a panel
+ * that makes that answer the same size as everything else has made the reader
+ * do the finding.
+ *
+ * So the outstanding counts are drawn large and are controls rather than
+ * labels, the whole left half goes quiet when there is nothing outstanding, and
+ * the system's state gets its own half with a heading instead of being a footer
+ * under the numbers.
+ *
+ * It draws no colour of its own: tone becomes a class and the palette arrives
+ * through `--pt-color-*`, like everything else here.
+ */
+declare function SituationRow({ blockingLabel, blocking, clearLabel, statusLabel, status, }: SituationRowProps): React.JSX.Element;
+
 interface FilterChipProps {
     label: string;
     count?: number;
@@ -285,11 +362,15 @@ interface BoardColumnData<TCard extends BoardCardData = BoardCardData> {
     hint?: string;
     cards: TCard[];
     /**
-     * Drawn under the cards, inside the column's own scroll.
+     * Drawn under the cards, inside the column's own scroll, so it takes no
+     * height from them.
      *
-     * It exists for what a column has to say about cards it is *not* showing —
-     * a done column hiding what was finished last month still owes the reader a
-     * line saying so, or the cards have not been hidden, they have been lost.
+     * It was added for a done column to account for what it was no longer
+     * drawing, and the panel no longer uses it that way: a count in the middle of
+     * the board is a control for putting the cards back in the way, and the
+     * archive is now a place you go to instead. The slot stays because it is the
+     * honest shape for anything a column has to say about itself — a caller with
+     * such a line has somewhere to put it.
      */
     footer?: React.ReactNode;
 }
@@ -297,6 +378,12 @@ interface BoardMoveResult {
     cardId: string;
     fromColumnId: string;
     toColumnId: string;
+    /**
+     * Where to insert the card in the destination column *once it has been
+     * taken out of wherever it was*. So a reducer removes the card and then
+     * inserts at exactly this index, with no arithmetic of its own — the
+     * adjustment for a card moving down its own column is already made.
+     */
     toIndex: number;
 }
 
@@ -342,6 +429,28 @@ declare function Card$1({ cardId, columnId, index, title, priorityColor, tags, p
  */
 declare function moveCardInColumns<TCard extends BoardCardData>(columns: BoardColumnData<TCard>[], move: BoardMoveResult): BoardColumnData<TCard>[];
 
+interface DropTarget {
+    columnId: string;
+    index: number;
+}
+/**
+ * What `onMove` is told, given where the drag began and where it ended.
+ *
+ * Both are rendered positions: the source card stays in its slot at reduced
+ * opacity while it is dragged, so `data-pt-card-index` counts it, and the
+ * placeholder is drawn *before* the card at `target.index`. `toIndex` is a
+ * different thing — the position to insert at once the card is taken out —
+ * and the two differ by exactly one whenever a card moves down its own
+ * column. Neither reducer allowed for that, so a card dropped before the
+ * fourth card landed after it: one slot lower than the placeholder had
+ * promised, every time, in both copies of the arithmetic. Adjusted here, once,
+ * where the numbers are still known to be rendered ones.
+ *
+ * `null` means the drop is where the card already was — its own slot, or the
+ * slot immediately after it, which is the same place once it is removed.
+ */
+declare function dropIndex(source: DropTarget, target: DropTarget): number | null;
+
 interface DetailSheetProps {
     open: boolean;
     onClose: () => void;
@@ -1095,6 +1204,23 @@ declare function isArchived(card: Card, doneColumns: ReadonlySet<string>, now?:
  * finished, and one dragged back out of done is not finished any more.
  */
 declare function stampForColumn(card: Card, columns: ColumnDef[]): Card;
+/**
+ * Where a card the panel writes on the reader's behalf goes.
+ *
+ * The update card and the four "ask for this again" cards used to be born in
+ * a column literally called `next`. The default board has one; a board whose
+ * owner renamed it does not, and a card in a column that does not exist is
+ * the exact fault `validateBoard` names — drawn nowhere, and refused by the
+ * write path, so one tap on a button turned a saveable board into one that
+ * could not be saved and said so about a column the reader had never heard of.
+ *
+ * `next` when there is one, because that is what the button means. Otherwise
+ * the first column that is neither in flight nor finished nor the owner's:
+ * queued work goes where queued work already sits. And the first column of
+ * all when nothing else fits, since a board with no columns cannot pass the
+ * validator either way.
+ */
+declare function queueColumn(columns: ColumnDef[]): string;
 /** A card claiming to be finished that was never picked up. */
 declare function claimedWithoutStarting(card: Card): boolean;
 interface Counts {
@@ -1384,12 +1510,19 @@ interface UiStrings {
     filterForClaude: string;
     filterYours: string;
     filterHighRisk: string;
+    situationBlocking: string;
+    situationClear: string;
+    situationStatus: string;
+    situationYoursHint: string;
+    situationDecisionsHint: string;
+    situationOrdersHint: string;
     statOpen: string;
     statOrders: string;
     statYours: string;
     statDecisions: string;
     statHighRisk: string;
     statDone: string;
+    statArchived: string;
     theme: string;
     themeSubtitle: string;
     themeNote: string;
@@ -1420,9 +1553,10 @@ interface UiStrings {
     needTokenEnables: string;
     needRepo: string;
     needRepoEnables: string;
-    archivedOne: string;
-    archivedMany: string;
-    archivedHide: string;
+    archiveTitle: string;
+    archiveHeading: string;
+    archiveIntro: string;
+    archiveFinished: (date: string) => string;
     needGate: string;
     needGateEnables: string;
     fixGate: string;
@@ -1884,4 +2018,4 @@ interface CardSheetProps {
 }
 declare function CardSheet({ card, state, lang, ui, onChange, onDelete, onClose }: CardSheetProps): React.JSX.Element | null;
 
-export { ANALYSIS_SECTIONS, ARCHIVE_AFTER_DAYS, AlertBanner, type AlertBannerProps, type Analysis, type AnalysisSection, AnalysisView, BOARD_VERSION, Board, type BoardCardData, type BoardCheck, type BoardColumnData, type BoardFacts, type BoardMoveResult, type BoardProblem, type BoardProps, type BoardTag, CAPABILITIES, type Capability, Card$1 as Card, type CardProps, CardSheet, type Check, type Choice, type ChoiceOption, type ColumnDef, type Competitor, type Constraint, CopyBlock, type CopyBlockLabels, type CopyBlockProps, type Counts, DashboardHeader, type DashboardHeaderProps, type DashboardThemeForm, DashboardThemeProvider, type DashboardThemeTokens, DetailSection, type DetailSectionProps, DetailSheet, type DetailSheetProps, FilterChip, type FilterChipProps, FilterChipRow, type GateReading, type GateStamp, type GateVerdict, type Goal, GuideNote, type GuideNoteProps, GuideTour, type GuideTourProps, type HealthFact, HealthPill, type HealthPillProps, HealthPillRow, type HealthStatus, INTENTS, INTENT_COPY, type ImportedTheme, type InstallState, type Intent, type IntentCopy, LANGS, LANG_LABELS, LEVELS, type Lang, type Level, MARKETPLACE_NAME, MARKETPLACE_URL, type Market, type MarketplaceReport, type MarketplaceTool, MarketplaceView, type Metric, type Note, NotificationBell, type NotificationBellProps, type NotificationLabels, type NotificationTone, OWNERS, type Owner, PANELTIR_FILE_COUNT, PANELTIR_FINGERPRINT, PANELTIR_TEMPLATE_HASH, PANELTIR_VERSION, PRESET_PANEL_THEMES, PanelApp, type PanelAppProps, type Card as PanelCard, type PanelNotification, type PanelState, type PanelTheme, type PanelThemes, type Preferences, type Reading, type Run, SetupGuide, type SetupGuideProps, type SetupRequirement, type SetupStatus, SetupWizard, type SetupWizardLabels, type SetupWizardProps, type Severity, StatTile, StatTileGrid, type StatTileProps, type Strategy, type Suggestion, type SuggestionStatus, THEME_FORMS, THEME_PRESETS, type Text, type ThemeFormName, type ThemePresetName, type Trend, UI, type UiStrings, type Weight, type WizardStep, applyMove, boardFacts, checkProgress, claimedWithoutStarting, claudeTheme, commandSnippet, countCards, cyberpunkTheme, decided, emptyCard, explainBoard, gateStatus, isArchived, isCard, isFirstRun, ledgerForm, midnightTheme, moveCardInColumns, newId, offeredThemes, oldMoneyTheme, panelForm, paneltirBuild, paperForm, readBoard, readStoredLang, repositorySnippet, resetGuide, sparkPoints, stampForColumn, storeLang, text, today, trendOf, undecided, untranslated, useDashboardForm, useDashboardTheme, useDelegatedClick, useGuideNote, useMediaQuery, validateBoard, wizardStep, writeText };
+export { ANALYSIS_SECTIONS, ARCHIVE_AFTER_DAYS, AlertBanner, type AlertBannerProps, type Analysis, type AnalysisSection, AnalysisView, BOARD_VERSION, Board, type BoardCardData, type BoardCheck, type BoardColumnData, type BoardFacts, type BoardMoveResult, type BoardProblem, type BoardProps, type BoardTag, CAPABILITIES, type Capability, Card$1 as Card, type CardProps, CardSheet, type Check, type Choice, type ChoiceOption, type ColumnDef, type Competitor, type Constraint, CopyBlock, type CopyBlockLabels, type CopyBlockProps, type Counts, DashboardHeader, type DashboardHeaderProps, type DashboardThemeForm, DashboardThemeProvider, type DashboardThemeTokens, DetailSection, type DetailSectionProps, DetailSheet, type DetailSheetProps, FilterChip, type FilterChipProps, FilterChipRow, type GateReading, type GateStamp, type GateVerdict, type Goal, GuideNote, type GuideNoteProps, GuideTour, type GuideTourProps, type HealthFact, HealthPill, type HealthPillProps, HealthPillRow, type HealthStatus, INTENTS, INTENT_COPY, type ImportedTheme, type InstallState, type Intent, type IntentCopy, LANGS, LANG_LABELS, LEVELS, type Lang, type Level, MARKETPLACE_NAME, MARKETPLACE_URL, type Market, type MarketplaceReport, type MarketplaceTool, MarketplaceView, type Metric, type Note, NotificationBell, type NotificationBellProps, type NotificationLabels, type NotificationTone, OWNERS, type Owner, PANELTIR_FILE_COUNT, PANELTIR_FINGERPRINT, PANELTIR_TEMPLATE_HASH, PANELTIR_VERSION, PRESET_PANEL_THEMES, PanelApp, type PanelAppProps, type Card as PanelCard, type PanelNotification, type PanelState, type PanelTheme, type PanelThemes, type Preferences, type Reading, type Run, SetupGuide, type SetupGuideProps, type SetupRequirement, type SetupStatus, SetupWizard, type SetupWizardLabels, type SetupWizardProps, type Severity, type SituationItem, SituationRow, type SituationRowProps, type SituationTone, StatTile, StatTileGrid, type StatTileProps, type Strategy, type Suggestion, type SuggestionStatus, THEME_FORMS, THEME_PRESETS, type Text, type ThemeFormName, type ThemePresetName, type Trend, UI, type UiStrings, type Weight, type WizardStep, applyMove, boardFacts, checkProgress, claimedWithoutStarting, claudeTheme, commandSnippet, countCards, cyberpunkTheme, decided, dropIndex, emptyCard, explainBoard, gateStatus, isArchived, isCard, isFirstRun, ledgerForm, midnightTheme, moveCardInColumns, newId, offeredThemes, oldMoneyTheme, panelForm, paneltirBuild, paperForm, queueColumn, readBoard, readStoredLang, repositorySnippet, resetGuide, sparkPoints, stampForColumn, storeLang, text, today, trendOf, undecided, untranslated, useDashboardForm, useDashboardTheme, useDelegatedClick, useGuideNote, useMediaQuery, validateBoard, warRoomForm, wizardStep, writeText };