paneltir 0.12.0 → 0.12.1

package/CLAUDE_MD_SNIPPET.md

@@ -68,6 +68,15 @@ library shared with other projects. Rules:
   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.12.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.12.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.12.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

@@ -378,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;
 }
 
@@ -423,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;
@@ -1176,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 {
@@ -1973,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, 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 };
+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 };

package/dist/index.js

@@ -1,8 +1,8 @@
 // src/version.ts
-var PANELTIR_VERSION = "0.12.0";
-var PANELTIR_FINGERPRINT = "sha256:ea981bdb1de721f4d2afd279244a7298b025773fb4a5abf8ffa33868c0d73f7d";
+var PANELTIR_VERSION = "0.12.1";
+var PANELTIR_FINGERPRINT = "sha256:3e958b3c4fa8a7c32fb49568d6189c9a0dea22e65263265177ba6d404ffa13ca";
 var PANELTIR_FILE_COUNT = 166;
-var PANELTIR_TEMPLATE_HASH = "sha256:c0c1a1678d860212ff82d55c7e7c0ee3eaf8be623621cadbb6ca5bf51b31e2ba";
+var PANELTIR_TEMPLATE_HASH = "sha256:9d9168001acb58c6ac0c7766515cb0fa95c4fc6d16e6fb17efd59d88e4a3c382";
 var paneltirBuild = {
   version: PANELTIR_VERSION,
   fingerprint: PANELTIR_FINGERPRINT,
@@ -348,11 +348,11 @@ function Column({ column, renderCard, onAddCard }) {
       column.cards.map((card, index) => {
         const showBefore = dnd.isDragging && dnd.dropTarget?.columnId === column.id && dnd.dropTarget.index === index;
         return /* @__PURE__ */ jsxs7(Fragment3, { children: [
-          showBefore && /* @__PURE__ */ jsx9("div", { className: "pt-card-placeholder" }),
+          showBefore && /* @__PURE__ */ jsx9("div", { className: "pt-card-placeholder", "data-pt-placeholder": true }),
           renderCard(card, index, column.id)
         ] }, card.id);
       }),
-      dnd.isDragging && dnd.dropTarget?.columnId === column.id && dnd.dropTarget.index === column.cards.length && /* @__PURE__ */ jsx9("div", { className: "pt-card-placeholder" }),
+      dnd.isDragging && dnd.dropTarget?.columnId === column.id && dnd.dropTarget.index === column.cards.length && /* @__PURE__ */ jsx9("div", { className: "pt-card-placeholder", "data-pt-placeholder": true }),
       column.footer ? /* @__PURE__ */ jsx9("div", { className: "pt-column__footer", children: column.footer }) : null
     ] })
   ] });
@@ -406,6 +406,11 @@ function useAutoscroll({ active, pointerRef, scrollContainerRef, edgeSize = 56,
 }
 
 // src/components/Board/useBoardDnD.ts
+function dropIndex(source, target) {
+  if (source.columnId !== target.columnId) return target.index;
+  if (target.index === source.index || target.index === source.index + 1) return null;
+  return target.index > source.index ? target.index - 1 : target.index;
+}
 function useBoardDnD({ columns, onMove, scrollContainerRef }) {
   const [drag, setDrag] = useState(null);
   const [pointer, setPointer] = useState(null);
@@ -466,6 +471,7 @@ function useBoardDnD({ columns, onMove, scrollContainerRef }) {
       if (!listEl) return;
       const columnId = listEl.getAttribute("data-pt-column-list");
       const cardEl = el?.closest("[data-pt-card]");
+      if (el?.closest("[data-pt-placeholder]")) return;
       let index;
       if (cardEl && listEl.contains(cardEl)) {
         const cardRect = cardEl.getBoundingClientRect();
@@ -492,13 +498,13 @@ function useBoardDnD({ columns, onMove, scrollContainerRef }) {
       const finalTarget = dropTargetRef.current;
       const source = dragRef.current;
       if (finalTarget && source) {
-        const sameSpot = finalTarget.columnId === source.columnId && (finalTarget.index === source.index || finalTarget.index === source.index + 1);
-        if (!sameSpot) {
+        const toIndex = dropIndex(source, finalTarget);
+        if (toIndex !== null) {
           onMove({
             cardId: source.cardId,
             fromColumnId: source.columnId,
             toColumnId: finalTarget.columnId,
-            toIndex: finalTarget.index
+            toIndex
           });
         }
       }
@@ -608,9 +614,10 @@ function moveCardInColumns(columns, move) {
 }
 
 // src/components/DetailSheet/DetailSheet.tsx
-import { useEffect as useEffect3 } from "react";
+import { useEffect as useEffect3, useRef as useRef4 } from "react";
 import { jsx as jsx12, jsxs as jsxs10 } from "react/jsx-runtime";
 function DetailSheet({ open, onClose, children, ariaLabel }) {
+  const pressedBackdrop = useRef4(false);
   useEffect3(() => {
     if (!open) return;
     function handleKey(e) {
@@ -620,10 +627,24 @@ function DetailSheet({ open, onClose, children, ariaLabel }) {
     return () => window.removeEventListener("keydown", handleKey);
   }, [open, onClose]);
   if (!open) return null;
-  return /* @__PURE__ */ jsx12("div", { className: "pt-sheet-backdrop", onClick: onClose, children: /* @__PURE__ */ jsxs10("div", { className: "pt-sheet", role: "dialog", "aria-modal": "true", "aria-label": ariaLabel, onClick: (e) => e.stopPropagation(), children: [
-    /* @__PURE__ */ jsx12("div", { className: "pt-sheet__handle" }),
-    children
-  ] }) });
+  return /* @__PURE__ */ jsx12(
+    "div",
+    {
+      className: "pt-sheet-backdrop",
+      onPointerDown: (e) => {
+        pressedBackdrop.current = e.target === e.currentTarget;
+      },
+      onClick: (e) => {
+        const began = pressedBackdrop.current;
+        pressedBackdrop.current = false;
+        if (began && e.target === e.currentTarget) onClose();
+      },
+      children: /* @__PURE__ */ jsxs10("div", { className: "pt-sheet", role: "dialog", "aria-modal": "true", "aria-label": ariaLabel, onClick: (e) => e.stopPropagation(), children: [
+        /* @__PURE__ */ jsx12("div", { className: "pt-sheet__handle" }),
+        children
+      ] })
+    }
+  );
 }
 function DetailSection({ title, subtitle, children }) {
   return /* @__PURE__ */ jsxs10("section", { className: "pt-detail-section", children: [
@@ -739,7 +760,7 @@ function GuideTour({ notes, dismissed, onDismiss }) {
 }
 
 // src/components/Notifications/Notifications.tsx
-import { useCallback as useCallback3, useEffect as useEffect5, useMemo as useMemo2, useRef as useRef4, useState as useState3 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect5, useMemo as useMemo2, useRef as useRef5, useState as useState3 } from "react";
 import { jsx as jsx14, jsxs as jsxs12 } from "react/jsx-runtime";
 var STORE_KEY = "pt-seen";
 function readSeen() {
@@ -768,7 +789,7 @@ function NotificationBell({ notifications, labels, seen: given, onSeen }) {
   const controlled = given !== void 0;
   const [stored, setStored] = useState3(null);
   const [open, setOpen] = useState3(false);
-  const root = useRef4(null);
+  const root = useRef5(null);
   useEffect5(() => {
     setStored(readSeen());
   }, []);
@@ -873,7 +894,7 @@ function NotificationBell({ notifications, labels, seen: given, onSeen }) {
 }
 
 // src/components/CopyBlock/CopyBlock.tsx
-import { useCallback as useCallback4, useEffect as useEffect6, useRef as useRef5, useState as useState4 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect6, useRef as useRef6, useState as useState4 } from "react";
 import { jsx as jsx15, jsxs as jsxs13 } from "react/jsx-runtime";
 var DEFAULT_LABELS2 = {
   copy: "Copy",
@@ -883,8 +904,8 @@ var DEFAULT_LABELS2 = {
 function CopyBlock({ text: text2, label, note, labels }) {
   const words = { ...DEFAULT_LABELS2, ...labels };
   const [result, setResult] = useState4("idle");
-  const pre = useRef5(null);
-  const timer = useRef5(void 0);
+  const pre = useRef6(null);
+  const timer = useRef6(void 0);
   useEffect6(() => () => window.clearTimeout(timer.current), []);
   const announce = useCallback4((next) => {
     setResult(next);
@@ -1217,6 +1238,12 @@ function stampForColumn(card, columns) {
   if (column.active && !next.startedAt) next.startedAt = today();
   return next;
 }
+function queueColumn(columns) {
+  const next = columns.find((column) => column.id === "next");
+  if (next) return next.id;
+  const queued = columns.find((column) => !column.active && !column.done && column.id !== "yours");
+  return (queued ?? columns[0])?.id ?? "next";
+}
 function claimedWithoutStarting(card) {
   return Boolean(card.completedAt) && !card.startedAt;
 }
@@ -3350,18 +3377,18 @@ function PanelApp({
   }, []);
   const addCard = useCallback5(
     (columnId) => {
-      const card = emptyCard(columnId, state.areas[0]?.id ?? "general");
+      const card = stampForColumn(emptyCard(columnId, state.areas[0]?.id ?? "general"), state.columns);
       setState((current) => ({ ...current, updatedAt: today(), cards: [...current.cards, card] }));
       setOpenCardId(card.id);
     },
-    [state.areas]
+    [state.areas, state.columns]
   );
   const addUpdateCard = useCallback5(() => {
     if (!update?.behind) return;
     const id = updateCardId(update.latest);
     if (state.cards.some((card2) => card2.id === id)) return;
     const card = {
-      ...emptyCard("next", state.areas[0]?.id ?? "general"),
+      ...emptyCard(queueColumn(state.columns), state.areas[0]?.id ?? "general"),
       id,
       title: { en: UI.en.updateCardTitle(update.latest), es: UI.es.updateCardTitle(update.latest) },
       body: { en: UI.en.updateCardBody(update.latest), es: UI.es.updateCardBody(update.latest) },
@@ -3372,7 +3399,7 @@ function PanelApp({
     };
     setState((current) => ({ ...current, updatedAt: today(), cards: [...current.cards, card] }));
     setOpenCardId(id);
-  }, [update, state.cards, state.areas, state.preferences?.updateAsOrder]);
+  }, [update, state.cards, state.areas, state.columns, state.preferences?.updateAsOrder]);
   const requestReport = useCallback5(
     (section) => {
       const id = `report-${section}-${today()}`;
@@ -3381,7 +3408,7 @@ function PanelApp({
         return;
       }
       const card = {
-        ...emptyCard("next", state.areas[0]?.id ?? "general"),
+        ...emptyCard(queueColumn(state.columns), state.areas[0]?.id ?? "general"),
         id,
         title: { en: UI.en.analysisRedoTitle[section], es: UI.es.analysisRedoTitle[section] },
         body: { en: UI.en.analysisRedoBody[section], es: UI.es.analysisRedoBody[section] },
@@ -3394,12 +3421,14 @@ function PanelApp({
       setState((current) => ({ ...current, updatedAt: today(), cards: [...current.cards, card] }));
       setOpenCardId(id);
     },
-    [state.cards, state.areas]
+    [state.cards, state.areas, state.columns]
   );
   const moveCard = useCallback5(
     (move) => {
       setState((current) => {
-        const moved = applyMove(current.cards, move, current.cards.filter(matches));
+        const done = new Set(current.columns.filter((column) => column.done).map((column) => column.id));
+        const drawn = current.cards.filter((card) => matches(card) && !isArchived(card, done));
+        const moved = applyMove(current.cards, move, drawn);
         return {
           ...current,
           updatedAt: today(),
@@ -3587,7 +3616,7 @@ function PanelApp({
         throw Object.assign(new Error(saveError(response.status, data, body)), { conflict });
       }
       setSavedSnapshot(JSON.stringify(next));
-      setState(next);
+      setState((current) => current === state ? next : current);
       setSave({
         status: "saved",
         at: (/* @__PURE__ */ new Date()).toLocaleTimeString(lang === "es" ? "es-ES" : "en-GB", {
@@ -4459,6 +4488,7 @@ export {
   countCards,
   cyberpunkTheme,
   decided,
+  dropIndex,
   emptyCard,
   explainBoard,
   gateStatus,
@@ -4474,6 +4504,7 @@ export {
   panelForm,
   paneltirBuild,
   paperForm,
+  queueColumn,
   readBoard,
   readStoredLang,
   repositorySnippet,

package/fingerprint.json

@@ -1,8 +1,8 @@
 {
   "name": "paneltir",
-  "version": "0.12.0",
-  "hash": "sha256:ea981bdb1de721f4d2afd279244a7298b025773fb4a5abf8ffa33868c0d73f7d",
+  "version": "0.12.1",
+  "hash": "sha256:3e958b3c4fa8a7c32fb49568d6189c9a0dea22e65263265177ba6d404ffa13ca",
   "fileCount": 166,
-  "templateHash": "sha256:c0c1a1678d860212ff82d55c7e7c0ee3eaf8be623621cadbb6ca5bf51b31e2ba",
-  "generatedAt": "2026-09-14T04:42:15.291Z"
+  "templateHash": "sha256:9d9168001acb58c6ac0c7766515cb0fa95c4fc6d16e6fb17efd59d88e4a3c382",
+  "generatedAt": "2026-09-18T06:35:32.449Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paneltir",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "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,49 +99,63 @@
     "node": ">=20"
   },
   "paneltirRelease": {
-    "version": "0.12.0",
-    "date": "2026-09-14",
+    "version": "0.12.1",
+    "date": "2026-09-18",
     "entries": [
       {
-        "kind": "feature",
+        "kind": "fix",
         "text": {
-          "en": "Archived cards leave the board and get a place of their own. A card finished more than a week ago is no longer drawn in its column at all — it is listed in the record view, under what each pass did, with the date it was finished. The count in its column was still the board carrying it: one tap put fifteen finished cards back in the way.",
-          "es": "Las tarjetas archivadas salen del tablero y tienen su propio sitio. Una tarjeta terminada hace más de una semana ya no se dibuja en su columna: aparece en la vista de revisiones, debajo de lo que hizo cada pasada, con la fecha en que se terminó. El contador en la columna seguía siendo el tablero cargando con ellas: un toque devolvía quince tarjetas terminadas a en medio."
+          "en": "A card dragged down its own column landed one slot below the placeholder. The index the drag emitted counted the card being dragged, and neither reducer allowed for it once the card was taken out; it is adjusted once now, where the numbers are still rendered ones, and `toIndex` says what it means.",
+          "es": "Una tarjeta arrastrada hacia abajo en su propia columna caía un hueco por debajo del marcador. El índice que emitía el arrastre contaba la propia tarjeta arrastrada y ninguno de los dos reductores lo descontaba al sacarla; ahora se ajusta una sola vez, donde los números aún son los dibujados, y `toIndex` dice lo que significa."
         }
       },
       {
-        "kind": "feature",
+        "kind": "fix",
         "text": {
-          "en": "A new strip at the top of the board says what is waiting on you and whether the system is working. The two questions a board is opened to answer were on the screen and neither was prominent — three of six identical tiles, and a line of small grey pills under them. The counts are now large and are controls: tapping one filters the board or opens the question.",
-          "es": "Una franja nueva encima del tablero dice qué te está esperando y si el sistema funciona. Las dos preguntas por las que se abre un tablero estaban en pantalla y ninguna destacaba: tres de seis casillas iguales, y una línea de pastillas grises debajo. Ahora los números son grandes y son controles: tocar uno filtra el tablero o abre la pregunta."
+          "en": "Hovering the drop placeholder no longer sends the target to the bottom of the column. It appeared under the pointer the moment a slot was chosen and read as \"not a card, so the end\", which moved it, put the card back under the pointer, and chose again.",
+          "es": "Pasar por encima del marcador de soltado ya no manda el destino al final de la columna. Aparecía bajo el puntero en cuanto se elegía un hueco y se leía como «no es una tarjeta, así que el final», lo que lo movía, devolvía la tarjeta bajo el puntero y volvía a elegir."
         }
       },
       {
-        "kind": "feature",
+        "kind": "fix",
         "text": {
-          "en": "A third board shape, `warRoom`: square, hairline-ruled, tight, priority carried as a full-height bar down the left edge of every row and counts set in the monospace face. It is the only form that tightens rather than loosens the spacing — a board somebody is watching wants as many rows on the screen as will fit. Ask for it with `THEME_FORMS.warRoom` on a theme's `form`.",
-          "es": "Una tercera forma de tablero, `warRoom`: cuadrada, reglada a un pelo, apretada, con la prioridad como una barra de alto completo en el borde izquierdo de cada fila y los números en la tipografía monoespaciada. Es la única forma que aprieta el espaciado en vez de soltarlo: un tablero que se vigila quiere tantas filas en pantalla como quepan. Se pide con `THEME_FORMS.warRoom` en el `form` de un tema."
+          "en": "A drop in a done column that holds archived cards lands where it was dropped. The move was anchored against a list that still carried the archived cards, so the slot on screen and the slot in the file disagreed.",
+          "es": "Soltar en una columna Hecho con tarjetas archivadas cae donde se soltó. El movimiento se anclaba contra una lista que aún llevaba las archivadas, así que el hueco en pantalla y el hueco en el archivo no coincidían."
         }
       },
       {
-        "kind": "feature",
+        "kind": "fix",
         "text": {
-          "en": "`SituationRow` is exported, so a project building its own screen out of the components can draw the same strip.",
-          "es": "`SituationRow` se exporta, así que un proyecto que construye su propia pantalla con los componentes puede dibujar la misma franja."
+          "en": "A save in flight no longer discards what was typed while it ran. The board was put back to the moment Save was pressed when the commit came back; edited meanwhile, it now keeps the edits and reads as unsaved again, which is what they are.",
+          "es": "Un guardado en curso ya no descarta lo que se escribió mientras corría. El tablero volvía al momento de pulsar Guardar cuando regresaba el commit; si se editó entre medias, ahora conserva los cambios y vuelve a leerse como sin guardar, que es lo que son."
         }
       },
       {
         "kind": "fix",
         "text": {
-          "en": "The open decisions counter counts questions nobody has answered, not cards about deciding. Those are different numbers and the one that holds work up is the first.",
-          "es": "El contador de decisiones abiertas cuenta preguntas que nadie ha contestado, no tarjetas sobre decidir. Son números distintos y el que frena el trabajo es el primero."
+          "en": "The update card and the four \"ask for this again\" cards no longer assume a column called `next`. On a board whose owner renamed it they landed in a column that does not exist, which the write path refuses — one tap made the board unsaveable. `queueColumn` picks where queued work already sits.",
+          "es": "La tarjeta de actualización y las cuatro de «pídelo otra vez» ya no dan por hecho una columna llamada `next`. En un tablero cuyo dueño la renombró caían en una columna que no existe, cosa que la ruta de escritura rechaza: un toque dejaba el tablero sin poder guardarse. `queueColumn` elige donde ya está el trabajo en cola."
         }
       },
       {
-        "kind": "chore",
+        "kind": "fix",
+        "text": {
+          "en": "A card added with \"+\" straight into the working column is stamped as started, as a card moved there would be. It carried no `startedAt`, so the day it reached done the panel flagged it as never picked up.",
+          "es": "Una tarjeta añadida con «+» directamente en la columna de trabajo se sella como empezada, igual que si se hubiera movido ahí. No llevaba `startedAt`, así que el día que llegaba a Hecho el panel la marcaba como nunca recogida."
+        }
+      },
+      {
+        "kind": "fix",
+        "text": {
+          "en": "`paneltir run` never mints an id the board already has. At the cap the list stops growing and the length-based id repeated, so two runs shared a key in the revisions log and one bell entry stood for both.",
+          "es": "`paneltir run` nunca acuña un id que el tablero ya tiene. En el tope la lista deja de crecer y el id basado en la longitud se repetía, así que dos pasadas compartían clave en el registro y una entrada de la campana valía por las dos."
+        }
+      },
+      {
+        "kind": "fix",
         "text": {
-          "en": "A shape declared with no drawing now fails the checks. A form whose CSS is missing renders exactly as the default, which does not look like a missing stylesheet — it looks like the `form` prop being ignored.",
-          "es": "Una forma declarada sin dibujo ahora falla las comprobaciones. Una forma a la que le falta el CSS se dibuja igual que la de por defecto, y eso no parece una hoja de estilos que falta: parece que la prop `form` se está ignorando."
+          "en": "Selecting text inside a sheet and letting go over the backdrop no longer closes it. Only a press that begins and ends on the backdrop is somebody asking to leave.",
+          "es": "Seleccionar texto dentro de una hoja y soltar sobre el fondo ya no la cierra. Solo una pulsación que empieza y termina en el fondo es alguien pidiendo salir."
         }
       }
     ]

package/template/.claude/skills/panel/SKILL.md

@@ -59,6 +59,32 @@ lie in a file the owner reads on a phone.
 **`risk`** — what it costs if it goes wrong, not how soon it is wanted. A
 high-risk card gets the safer approach even when its intent says `fast`.
 
+## A second problem, and a detail nobody wrote down
+
+These two come up on almost every card, and neither is a reason to stop.
+
+**A second problem found while doing a card.** Fix it in the same pass when it
+is small, reversible, and inside what you were already touching. Anything
+larger becomes a card: write it in `ideas` with a title, what you saw and why
+it matters, then carry on with the card you were on and name the new card in
+your reply. It is never a reason to stop and wait, and never something to fix
+quietly inside an unrelated change — a queue stops being trusted when work
+arrives in it that nobody asked for, and a finding stops existing when it was
+only mentioned in a conversation that ended.
+
+**A detail the card does not specify.** Decide it. That is the normal state of
+a card rather than an omission: a card says what to build and rarely how, which
+is why `do` says outright that *every detail not written down is yours to
+choose* and an absent intent says to use judgement. Prefer the smaller, more
+reversible option and say in one line what you chose and why.
+
+Only `askme`, `explain` and `hold` mean stop, and `value: null` on a choice
+holds back only the part of the work that actually depends on that answer —
+never the whole card. Asking is for a question that outlives the conversation,
+and it is asked on the board as a choice with `value: null`, which the bell
+surfaces. Stopping to ask something you could have chosen costs the owner a
+session; choosing it and saying so costs them one line.
+
 ## Read the analysis before deciding anything
 
 `analysis.choices` holds the questions the owner has already answered, grouped