paneltir 0.10.1 → 0.12.0

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,19 @@ 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.
 - **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.10.1
+   # npm install github:daifukus/paneltir#v0.12.0
    ```
 
    (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.10.1      # exits non-zero if that is not what is installed
+   npx paneltir check 0.12.0      # 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.10.1
+# npm install github:daifukus/paneltir#v0.12.0
 ```
 
 Installing from Git runs the `prepare` script, which builds `dist/`, so the

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;
@@ -284,6 +361,18 @@ interface BoardColumnData<TCard extends BoardCardData = BoardCardData> {
      */
     hint?: string;
     cards: TCard[];
+    /**
+     * Drawn under the cards, inside the column's own scroll, so it takes no
+     * height from them.
+     *
+     * 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;
 }
 interface BoardMoveResult {
     cardId: string;
@@ -1055,6 +1144,32 @@ declare function newId(): string;
 declare function today(): string;
 /** A card is created empty and named second — the same as tapping "+" on paper. */
 declare function emptyCard(column: string, area: string): Card;
+/**
+ * How long a finished card stays on the board before it becomes history.
+ *
+ * A done column only grows. It is the one column nothing ever removes from,
+ * so a board that is being worked turns into a wall of things already
+ * finished, and the three columns that need reading get a third of the screen
+ * between them. A week is the window in which "what did we ship" is still a
+ * live question; after that it is a record, and a record does not need to be
+ * in the way.
+ */
+declare const ARCHIVE_AFTER_DAYS = 7;
+/**
+ * Whether a finished card has been finished long enough to stop being drawn.
+ *
+ * Derived on every render and never written, which is the arrangement
+ * `boardFacts()` already uses: a flag stored on the card would be wrong the
+ * day after it was set, and setting it would mark the panel dirty for the
+ * passage of time. Here the answer simply becomes true on its own.
+ *
+ * **A card with no `completedAt` is never archived**, whatever column it sits
+ * in. It reached done without being stamped — a board edited by hand, or one
+ * from before the stamp existed — so its age is not known, and hiding a card
+ * whose age nobody knows is the same mistake as reporting a token missing
+ * because the check could not run. `unknown` is not `old`.
+ */
+declare function isArchived(card: Card, doneColumns: ReadonlySet<string>, now?: string, afterDays?: number): boolean;
 /**
  * Applies the column's own meaning to a card that just moved into it: a card
  * entering the working column is started, one reaching a done column is
@@ -1350,12 +1465,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;
@@ -1386,6 +1508,10 @@ interface UiStrings {
     needTokenEnables: string;
     needRepo: string;
     needRepoEnables: string;
+    archiveTitle: string;
+    archiveHeading: string;
+    archiveIntro: string;
+    archiveFinished: (date: string) => string;
     needGate: string;
     needGateEnables: string;
     fixGate: string;
@@ -1847,4 +1973,4 @@ interface CardSheetProps {
 }
 declare function CardSheet({ card, state, lang, ui, onChange, onDelete, onClose }: CardSheetProps): React.JSX.Element | null;
 
-export { ANALYSIS_SECTIONS, 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, 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, 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, warRoomForm, wizardStep, writeText };