paneltir 0.10.0 → 0.11.0

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.0
+   # npm install github:daifukus/paneltir#v0.11.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.0      # exits non-zero if that is not what is installed
+   npx paneltir check 0.11.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.0
+# npm install github:daifukus/paneltir#v0.11.0
 ```
 
 Installing from Git runs the `prepare` script, which builds `dist/`, so the

package/bin/paneltir.mjs

@@ -130,10 +130,35 @@ function writeStamp(target, templateFiles, written) {
   const files = { ...(previous?.files ?? {}) }
   for (const file of written) files[file] = sha256(join(target, file))
 
+  /*
+   * The headline only advances when this run actually rewrote the whole gate.
+   *
+   * It used to advance on every run, which quietly defeated the entire point.
+   * A project on v0.9.0, a template changed in v0.10.0, `npm update`, then a
+   * re-run of `init` — which writes nothing, because the files are already
+   * there — and the stamp said the gate came from v0.10.0 while the files on
+   * disk were still v0.9.0's. `doctor` then printed "The template has not
+   * changed since" directly above a row reading BEHIND, and the panel, which
+   * has only this hash to go on, said the gate was current. Reproduced before
+   * fixing.
+   *
+   * The board is excluded because it is never rewritten: requiring it would
+   * mean the headline never advanced at all after the first install.
+   *
+   * When the gate is mixed — some files written, some left — the previous
+   * answer stands. That can over-report staleness for a partly updated gate,
+   * and it is the safe direction: `doctor`'s per-file rows carry the truth,
+   * and over-reporting sends somebody to read a diff while under-reporting
+   * sends them nowhere at all.
+   */
+  const gateFiles = templateFiles.filter((file) => file !== BOARD_SEED)
+  const wholeGate = gateFiles.length > 0 && gateFiles.every((file) => written.includes(file))
+
   const stamp = {
-    version: pkg.version,
-    templateHash: fingerprint.templateHash ?? '',
-    copiedAt: new Date().toISOString(),
+    version: wholeGate ? pkg.version : (previous?.version ?? pkg.version),
+    templateHash: wholeGate ? (fingerprint.templateHash ?? '') : (previous?.templateHash ?? ''),
+    // When this gate was last written, not when this command last ran.
+    copiedAt: written.length ? new Date().toISOString() : (previous?.copiedAt ?? new Date().toISOString()),
     files,
   }
   try {
@@ -513,9 +538,33 @@ function doctor() {
  * behalf would be the second thing in this project writing to their
  * repository.
  */
+/**
+ * One flag, in either form, because the usage line prints the space one.
+ *
+ * It only read `--cards=a,b`, while its own error message printed
+ * `[--cards a,b]` — so the documented form took `a,b` as the board path and
+ * failed with "no board at a,b", and `--by you` was dropped silently, which is
+ * worse: the run was attributed to Claude when somebody said it was theirs.
+ */
+function flag(args, name) {
+  const joined = args.find((a) => a.startsWith(`--${name}=`))
+  if (joined) return joined.slice(name.length + 3)
+  const at = args.indexOf(`--${name}`)
+  if (at !== -1 && typeof args[at + 1] === 'string' && !args[at + 1].startsWith('--')) return args[at + 1]
+  return undefined
+}
+
 async function run(args) {
-  const flags = args.filter((a) => a.startsWith('--'))
-  const plain = args.filter((a) => !a.startsWith('--'))
+  // A flag's value is not a positional argument, whichever form it came in.
+  const taken = new Set()
+  for (const name of ['cards', 'by']) {
+    const at = args.indexOf(`--${name}`)
+    if (at !== -1) {
+      taken.add(at)
+      if (typeof args[at + 1] === 'string' && !args[at + 1].startsWith('--')) taken.add(at + 1)
+    }
+  }
+  const plain = args.filter((a, i) => !a.startsWith('--') && !taken.has(i))
   const summary = plain[0]
   const file = plain[1] ?? BOARD_SEED
 
@@ -543,7 +592,7 @@ async function run(args) {
   }
 
   const board = check.board
-  const cards = (flags.find((f) => f.startsWith('--cards='))?.slice(8) ?? '')
+  const cards = (flag(args, 'cards') ?? '')
     .split(',')
     .map((id) => id.trim())
     .filter(Boolean)
@@ -557,10 +606,15 @@ async function run(args) {
     process.exit(1)
   }
 
-  const by = flags.find((f) => f.startsWith('--by='))?.slice(5) === 'you' ? 'you' : 'claude'
+  const by = flag(args, 'by') === 'you' ? 'you' : 'claude'
   const date = new Date().toISOString().slice(0, 10)
   board.runs = Array.isArray(board.runs) ? board.runs : []
-  board.runs.unshift({
+  // Appended, not prepended: `runs` is stored oldest-first and every reader
+  // reverses it. `unshift` put a new pass at the *oldest* position, so it
+  // 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.
+  board.runs.push({
     id: `run-${date}-${String(board.runs.length + 1).padStart(3, '0')}`,
     date,
     by,
@@ -569,8 +623,27 @@ async function run(args) {
     fingerprint: shortHash,
   })
 
+  /*
+   * Bounded here, because here is where it grows.
+   *
+   * The validators used to refuse a board with more than 200 runs while
+   * nothing anywhere trimmed them, so the only reachable outcome was a Save
+   * that broke permanently on the two-hundredth pass and said "Too many runs".
+   * A bound belongs where the list is appended, not where it is read: trimming
+   * on the write path would commit a board shorter than the one the panel is
+   * holding, and the panel would read as saved while the repository disagreed.
+   *
+   * The oldest go, since `runs` is oldest-first. Three hundred is about a
+   * decade of daily passes, and the diff of a list that only grows grows with
+   * it.
+   */
+  const KEEP_RUNS = 300
+  const dropped = Math.max(0, board.runs.length - KEEP_RUNS)
+  if (dropped) board.runs = board.runs.slice(dropped)
+
   writeFileSync(path, JSON.stringify(board, null, 2) + '\n')
   console.log(`Appended to ${file}: ${summary}`)
+  if (dropped) console.log(`  dropped the ${dropped} oldest run(s), keeping the last ${KEEP_RUNS}`)
   console.log(`  ${cards.length ? `cards ${cards.join(', ')}` : 'no cards named'} · by ${by} · ${shortHash}`)
   console.log('\nThe file is changed and not committed. The panel commits it on Save,')
   console.log('or commit it yourself — this writes nothing to your repository.')

package/dist/index.d.ts

@@ -284,6 +284,14 @@ interface BoardColumnData<TCard extends BoardCardData = BoardCardData> {
      */
     hint?: string;
     cards: TCard[];
+    /**
+     * Drawn under the cards, inside the column's own scroll.
+     *
+     * 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.
+     */
+    footer?: React.ReactNode;
 }
 interface BoardMoveResult {
     cardId: string;
@@ -521,6 +529,18 @@ interface SetupRequirement {
     enables?: React.ReactNode;
     /** Exactly what to do, shown only when it is missing. */
     fix?: React.ReactNode;
+    /**
+     * Information rather than a gate: drawn in the list, never walked as a step.
+     *
+     * Every other requirement here is an environment variable, and the
+     * walkthrough's one action — re-read the environment from the server —
+     * is what clears it. A requirement that action cannot clear parks the
+     * walkthrough on it for ever, and because `unknown` is judged across the
+     * whole list, one advisory row that nobody wired made every step answer a
+     * successful check with "the panel could not ask its own server". That is
+     * what the copied gate did the day it was added.
+     */
+    advisory?: boolean;
 }
 interface SetupGuideProps {
     requirements: SetupRequirement[];
@@ -1043,6 +1063,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
@@ -1374,6 +1420,9 @@ interface UiStrings {
     needTokenEnables: string;
     needRepo: string;
     needRepoEnables: string;
+    archivedOne: string;
+    archivedMany: string;
+    archivedHide: string;
     needGate: string;
     needGateEnables: string;
     fixGate: string;
@@ -1835,4 +1884,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, 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 };

package/dist/index.js

@@ -1,8 +1,8 @@
 // src/version.ts
-var PANELTIR_VERSION = "0.10.0";
-var PANELTIR_FINGERPRINT = "sha256:4de7ef7076563e4c3118ac16b645737a44c4c0675115d9a9d7bbff562d5ecb74";
+var PANELTIR_VERSION = "0.11.0";
+var PANELTIR_FINGERPRINT = "sha256:2739462e763939de1d1aeb8ab97779149c2ddb0ec2d2fb45644c4c45ef9dc9fa";
 var PANELTIR_FILE_COUNT = 163;
-var PANELTIR_TEMPLATE_HASH = "sha256:7f9accd11920a0c189dd683bdb96635a606960afeca71e02c2a26a0257acefd8";
+var PANELTIR_TEMPLATE_HASH = "sha256:034ba27266408af4f2ba5793d9cefbe448b168570d6a0b87dfe698dfe639feb1";
 var paneltirBuild = {
   version: PANELTIR_VERSION,
   fingerprint: PANELTIR_FINGERPRINT,
@@ -306,7 +306,8 @@ function Column({ column, renderCard, onAddCard }) {
           renderCard(card, index, column.id)
         ] }, card.id);
       }),
-      dnd.isDragging && dnd.dropTarget?.columnId === column.id && dnd.dropTarget.index === column.cards.length && /* @__PURE__ */ jsx8("div", { className: "pt-card-placeholder" })
+      dnd.isDragging && dnd.dropTarget?.columnId === column.id && dnd.dropTarget.index === column.cards.length && /* @__PURE__ */ jsx8("div", { className: "pt-card-placeholder" }),
+      column.footer ? /* @__PURE__ */ jsx8("div", { className: "pt-column__footer", children: column.footer }) : null
     ] })
   ] });
 }
@@ -918,15 +919,16 @@ import { useState as useState5 } from "react";
 
 // src/components/Setup/wizard.ts
 function wizardStep(requirements) {
-  const total = requirements.length;
-  const done = requirements.filter((requirement) => requirement.status === "ok");
-  const unknown = requirements.some((requirement) => requirement.status === "unknown");
-  const at = requirements.findIndex((requirement) => requirement.status !== "ok");
+  const steps = requirements.filter((requirement) => !requirement.advisory);
+  const total = steps.length;
+  const done = steps.filter((requirement) => requirement.status === "ok");
+  const unknown = steps.some((requirement) => requirement.status === "unknown");
+  const at = steps.findIndex((requirement) => requirement.status !== "ok");
   if (at === -1) {
     return { current: null, index: 0, total, done, ready: total > 0, unknown: false };
   }
   return {
-    current: requirements[at],
+    current: steps[at],
     index: at + 1,
     total,
     done,
@@ -1147,6 +1149,18 @@ function emptyCard(column, area) {
     completedAt: null
   };
 }
+var ARCHIVE_AFTER_DAYS = 7;
+function daysBefore(from, days) {
+  const at = /* @__PURE__ */ new Date(`${from}T00:00:00Z`);
+  at.setUTCDate(at.getUTCDate() - days);
+  return at.toISOString().slice(0, 10);
+}
+function isArchived(card, doneColumns, now = today(), afterDays = ARCHIVE_AFTER_DAYS) {
+  if (!doneColumns.has(card.column)) return false;
+  const finished = card.completedAt;
+  if (typeof finished !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(finished)) return false;
+  return finished < daysBefore(now, afterDays);
+}
 function stampForColumn(card, columns) {
   const column = columns.find((candidate) => candidate.id === card.column);
   if (!column) return card;
@@ -1614,6 +1628,9 @@ var UI = {
     needTokenEnables: "Lets Save commit the board back to the repository. Without it everything else works and Save fails.",
     needRepo: "The repository to write to",
     needRepoEnables: "Which repository the board is committed to. There is no default on purpose: writing to the wrong one is worse than not writing.",
+    archivedOne: "archived \u2014 finished over a week ago",
+    archivedMany: "archived \u2014 finished over a week ago",
+    archivedHide: "Hide them again",
     needGate: "The gate this project copied",
     needGateEnables: "The sign-in, the session and the write-back are files this project owns, copied once and never updated with the library. When one of them is older than the package, the panel does not look misconfigured \u2014 it looks broken.",
     fixGate: "The gate is older than the installed kit. See what changed before replacing anything:",
@@ -1938,6 +1955,9 @@ var UI = {
     needTokenEnables: "Permite que Guardar confirme el tablero en el repositorio. Sin \xE9l todo lo dem\xE1s funciona y Guardar falla.",
     needRepo: "El repositorio donde escribir",
     needRepoEnables: "En qu\xE9 repositorio se confirma el tablero. No hay valor por defecto a prop\xF3sito: escribir en el equivocado es peor que no escribir.",
+    archivedOne: "archivada \u2014 terminada hace m\xE1s de una semana",
+    archivedMany: "archivadas \u2014 terminadas hace m\xE1s de una semana",
+    archivedHide: "Volver a esconderlas",
     needGate: "La puerta que copi\xF3 este proyecto",
     needGateEnables: "El acceso, la sesi\xF3n y la escritura de vuelta son archivos de este proyecto, copiados una vez y que no se actualizan con la librer\xEDa. Cuando uno se queda m\xE1s viejo que el paquete, el panel no parece mal configurado: parece roto.",
     fixGate: "La puerta es m\xE1s vieja que el kit instalado. Mira qu\xE9 cambi\xF3 antes de reemplazar nada:",
@@ -2939,7 +2959,7 @@ function applyMove(cards, move, visible) {
 function resolveTheme(saved, stored, themes, hasImported, fallback) {
   for (const name of [saved, stored]) {
     if (name === "imported" && hasImported) return "imported";
-    if (name && name in themes) return name;
+    if (name && Object.prototype.hasOwnProperty.call(themes, name)) return name;
   }
   return fallback ?? Object.keys(themes)[0];
 }
@@ -3031,6 +3051,7 @@ function PanelApp({
   );
   const [state, setState] = useState10(initialState);
   const [filter, setFilter] = useState10("all");
+  const [showArchived, setShowArchived] = useState10(() => /* @__PURE__ */ new Set());
   const [openCardId, setOpenCardId] = useState10(null);
   const [settingsOpen, setSettingsOpen] = useState10(false);
   const [update, setUpdate] = useState10(null);
@@ -3108,6 +3129,9 @@ function PanelApp({
       // `SetupWizard` already refuses to make.
       ...gate === void 0 ? [] : [{
         id: "gate",
+        // Information, not a gate: the walkthrough's only action re-reads the
+        // environment, and this is files on disk. See SetupRequirement.
+        advisory: true,
         label: ui.needGate,
         status: gateReading.verdict === "current" ? "ok" : gateReading.verdict === "behind" ? "missing" : "unknown",
         enables: ui.needGateEnables,
@@ -3151,13 +3175,31 @@ function PanelApp({
   );
   const visibleCards = useMemo5(() => state.cards.filter(matches), [state.cards, matches]);
   const boardColumns = useMemo5(
-    () => state.columns.map((column) => ({
-      id: column.id,
-      title: t(column.title),
-      hint: column.hint ? t(column.hint) : void 0,
-      cards: visibleCards.filter((card) => card.column === column.id)
-    })),
-    [state.columns, visibleCards, t]
+    () => state.columns.map((column) => {
+      const mine = visibleCards.filter((card) => card.column === column.id);
+      const archived = mine.filter((card) => isArchived(card, doneColumns));
+      const showing = showArchived.has(column.id) ? mine : mine.filter((card) => !archived.includes(card));
+      return {
+        id: column.id,
+        title: t(column.title),
+        hint: column.hint ? t(column.hint) : void 0,
+        cards: showing,
+        footer: archived.length ? /* @__PURE__ */ jsx20(
+          "button",
+          {
+            type: "button",
+            onClick: () => setShowArchived((current) => {
+              const next = new Set(current);
+              if (next.has(column.id)) next.delete(column.id);
+              else next.add(column.id);
+              return next;
+            }),
+            children: showArchived.has(column.id) ? ui.archivedHide : `${archived.length} ${archived.length === 1 ? ui.archivedOne : ui.archivedMany}`
+          }
+        ) : void 0
+      };
+    }),
+    [state.columns, visibleCards, doneColumns, showArchived, t, ui]
   );
   const notifications = useMemo5(() => {
     const items = [];
@@ -4259,6 +4301,7 @@ var CAPABILITIES = [
 ];
 export {
   ANALYSIS_SECTIONS,
+  ARCHIVE_AFTER_DAYS,
   AlertBanner,
   AnalysisView,
   BOARD_VERSION,
@@ -4312,6 +4355,7 @@ export {
   emptyCard,
   explainBoard,
   gateStatus,
+  isArchived,
   isCard,
   isFirstRun,
   ledgerForm,

package/dist/style.css

@@ -594,6 +594,28 @@
   background: var(--pt-color-panel);
   box-shadow: 0 10px 26px rgba(0, 0, 0, 0.45);
 }
+.pt-column__footer {
+  padding-top: var(--pt-space-sm);
+  border-top: var(--pt-border-width) solid var(--pt-color-line-faint);
+  font-size: 11.5px;
+  color: var(--pt-color-ink-faint);
+}
+.pt-column__footer button {
+  border: none;
+  background: none;
+  padding: 0;
+  font: inherit;
+  color: inherit;
+  cursor: pointer;
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+.pt-column__footer button:hover {
+  color: var(--pt-color-ink-dim);
+}
+.pt-column__list > * {
+  flex-shrink: 0;
+}
 
 /* src/components/DetailSheet/DetailSheet.css */
 .pt-sheet-backdrop {

package/fingerprint.json

@@ -1,8 +1,8 @@
 {
   "name": "paneltir",
-  "version": "0.10.0",
-  "hash": "sha256:4de7ef7076563e4c3118ac16b645737a44c4c0675115d9a9d7bbff562d5ecb74",
+  "version": "0.11.0",
+  "hash": "sha256:2739462e763939de1d1aeb8ab97779149c2ddb0ec2d2fb45644c4c45ef9dc9fa",
   "fileCount": 163,
-  "templateHash": "sha256:7f9accd11920a0c189dd683bdb96635a606960afeca71e02c2a26a0257acefd8",
-  "generatedAt": "2026-09-11T02:49:51.562Z"
+  "templateHash": "sha256:034ba27266408af4f2ba5793d9cefbe448b168570d6a0b87dfe698dfe639feb1",
+  "generatedAt": "2026-09-13T08:39:02.027Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paneltir",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "A React UI kit for admin panels: page frame, a board with touch-ready drag and drop, detail sheets, and a whole panel in one component. Structure and behaviour are fixed; colour and brand belong to each project.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "DFKlabs (https://DFKlabs.com)",
@@ -99,42 +99,28 @@
     "node": ">=20"
   },
   "paneltirRelease": {
-    "version": "0.10.0",
-    "date": "2026-09-11",
+    "version": "0.11.0",
+    "date": "2026-09-13",
     "entries": [
       {
         "kind": "feature",
         "text": {
-          "en": "`paneltir doctor` says whether the files this project copied are still the ones the installed kit ships — and separates \"you edited it\" from \"we changed it underneath you\", which a diff cannot.",
-          "es": "`paneltir doctor` dice si los archivos que copió este proyecto siguen siendo los del kit instalado — y separa «lo editaste tú» de «lo cambiamos nosotros debajo», que un diff no puede."
+          "en": "A card finished more than a week ago stops being drawn in its column. The column says how many it is holding and one tap shows them — nothing is hidden without being accounted for.",
+          "es": "Una tarjeta terminada hace más de una semana deja de dibujarse en su columna. La columna dice cuántas guarda y un toque las enseña — nada se esconde sin quedar contado."
         }
       },
       {
         "kind": "feature",
         "text": {
-          "en": "The setup list can carry a row for the copied gate. Import `.paneltir/gate.json` and pass it as `gate`; without it the panel says nothing about those files rather than guessing.",
-          "es": "La lista de configuración puede llevar una fila para la puerta copiada. Importa `.paneltir/gate.json` y pásalo como `gate`; sin él el panel no dice nada de esos archivos en vez de suponer."
-        }
-      },
-      {
-        "kind": "feature",
-        "text": {
-          "en": "`paneltir run \"what this pass did\"` appends to the board's revisions, so the record does not depend on anyone remembering at the end of a session.",
-          "es": "`paneltir run \"qué hizo esta pasada\"` añade una entrada a las revisiones del tablero, así el registro no depende de que alguien se acuerde al final de la sesión."
-        }
-      },
-      {
-        "kind": "fix",
-        "text": {
-          "en": "`paneltir init` and `paneltir doctor` no longer need React installed. They loaded the component bundle at startup, so they failed in a project that had not installed it yet — which is exactly when `init` is run.",
-          "es": "`paneltir init` y `paneltir doctor` ya no necesitan React instalado. Cargaban el bundle de componentes al arrancar, así que fallaban en un proyecto que aún no lo tenía — que es justo cuando se ejecuta `init`."
+          "en": "A board column can carry a footer, drawn inside its own scroll so it takes no height from the cards.",
+          "es": "Una columna del tablero puede llevar un pie, dibujado dentro de su propio scroll para que no le quite alto a las tarjetas."
         }
       },
       {
         "kind": "chore",
         "text": {
-          "en": "The rules a project needs are checked to actually reach it: the documents a project keeps must name `extraThemes` and `paneltir doctor`, or the build fails saying why.",
-          "es": "Se comprueba que las reglas que un proyecto necesita le lleguen de verdad: los documentos que el proyecto conserva tienen que nombrar `extraThemes` y `paneltir doctor`, o la build falla diciendo por qué."
+          "en": "A card in a scrolling column can never shrink below its own content, so a title can never be cut in half.",
+          "es": "Una tarjeta en una columna con scroll no puede encogerse por debajo de su contenido, así que un título no puede quedar cortado por la mitad."
         }
       }
     ]

package/template/api/panel-state.ts

@@ -121,8 +121,22 @@ function readCookie(header: string | null | undefined, name: string): string | u
  * Where the board lives in this repository. Set PANEL_FILE to override; the
  * default is only a guess at a sensible place, and a wrong path here fails
  * loudly on the first save rather than quietly writing somewhere else.
+ *
+ * A function, and not a constant, for the reason `env()` above is wrapped: a
+ * bare `process.env.X` is a ReferenceError wherever `process` is undefined,
+ * and at module scope it runs *before* the handler's `try` — so it cannot be
+ * caught and the platform answers `FUNCTION_INVOCATION_FAILED`, a code that
+ * names the shape of the fault and never the fault. That is the exact failure
+ * this file has already had twice, from an import and then from a throw ahead
+ * of the wrapper. This was the last module-scope read left in any gate file.
  */
-const FILE_PATH = process.env.PANEL_FILE || 'src/data/panel-state.json'
+function filePath(): string {
+  try {
+    return process.env.PANEL_FILE || 'src/data/panel-state.json'
+  } catch {
+    return 'src/data/panel-state.json'
+  }
+}
 const MAX_BODY_BYTES = 512 * 1024
 
 interface VercelRequest {
@@ -277,6 +291,12 @@ function invalidState(state: unknown): string | null {
   }
 
   if (!Array.isArray(state.runs)) say('runs', 'must be an array')
+  // Deliberately no cap. The shape is checked here; how long a log may get is
+  // not a shape, and refusing a board for having too much history is a panel
+  // that stops saving one day and never says why. This copy used to refuse
+  // over 200 runs while nothing anywhere trimmed them, so the only outcome was
+  // a Save that broke permanently on the two-hundredth pass. Bounded on write
+  // instead, where a bound can be applied rather than only enforced.
 
   return problems.length ? problems.join('; ') : null
 }
@@ -302,7 +322,7 @@ function configuration() {
     // is how a misconfigured target gets noticed before it is written to.
     repo: repo ?? null,
     branch: process.env.PANEL_BRANCH || 'main',
-    file: FILE_PATH,
+    file: filePath(),
   }
 }
 
@@ -373,7 +393,7 @@ async function handleRequest(request: VercelRequest, response: VercelResponse) {
       ? payload.message.trim().slice(0, 120)
       : 'chore(panel): update the board from the panel'
 
-  const api = `https://api.github.com/repos/${repo}/contents/${FILE_PATH}`
+  const api = `https://api.github.com/repos/${repo}/contents/${filePath()}`
   const githubHeaders = {
     authorization: `Bearer ${token}`,
     accept: 'application/vnd.github+json',