@litfamily/litgrok 1.0.26 → 1.0.28

package/.grok/hooks/session-rows.mjs

@@ -0,0 +1,57 @@
+// The other sessions of this workspace, for the status line's extra rows. Each comes from that
+// session's liveness record and, when it has one, its workflow snapshot; this session's own files are
+// skipped. A session that is working reads `running`, one waiting at a turn end `idle`, and a finished
+// start-work (its work stage closed with every plan task checked, or the done stage) `done` for one
+// minute, then it leaves. An ended or stale session is not shown. Nothing here writes.
+
+import { createHash } from 'node:crypto';
+import { readdirSync, realpathSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { readLiveness } from './session-liveness.mjs';
+import { readWorkflowState } from './workflow-stage.mjs';
+
+export const DONE_SHOWN_MS = 60 * 1000;
+const MAX_ROWS = 4;
+const STATE_ORDER = { running: 0, idle: 1, done: 2 };
+const RECORD_NAME = /^[0-9a-f]{32}\.json$/u;
+
+const keyOf = (sessionId) => createHash('sha256').update(sessionId).digest('hex').slice(0, 32);
+
+function finished(workflow) {
+  return workflow.stage === 'done'
+    || (workflow.ended && workflow.stage === 'work' && workflow.plan?.total > 0 && workflow.plan.done === workflow.plan.total);
+}
+
+/** Up to four `{ label, pane, state }` rows, running first, then idle, then done; newest first within each. */
+export function readOtherSessions(dirs, selfSessionId, now = Date.now()) {
+  const selfName = typeof selfSessionId === 'string' && selfSessionId !== '' ? `${keyOf(selfSessionId)}.json` : null;
+  for (const directory of dirs) {
+    if (typeof directory !== 'string' || !isAbsolute(directory)) continue;
+    let root;
+    let names;
+    try {
+      root = realpathSync(directory);
+      names = readdirSync(join(root, '.grok', 'litgrok', 'liveness'));
+    } catch {
+      continue;
+    }
+    const rows = [];
+    for (const name of names) {
+      if (!RECORD_NAME.test(name) || name === selfName) continue;
+      const live = readLiveness(join(root, '.grok', 'litgrok', 'liveness', name), now);
+      if (!live || `${keyOf(live.sessionId)}.json` !== name) continue;
+      const workflow = readWorkflowState(join(root, '.grok', 'litgrok', 'session-ledger', name.replace(/\.json$/u, '.workflow.json')), live.sessionId);
+      let state;
+      if (workflow && finished(workflow)) {
+        if (now - Date.parse(workflow.updatedAt) > DONE_SHOWN_MS) continue;
+        state = 'done';
+      } else if (live.state === 'alive') state = 'running';
+      else if (live.state === 'idle') state = 'idle';
+      else continue;
+      rows.push({ label: workflow?.active ?? workflow?.stage ?? 'session', pane: live.pane, state, at: Date.parse(live.at) });
+    }
+    rows.sort((left, right) => STATE_ORDER[left.state] - STATE_ORDER[right.state] || right.at - left.at);
+    return rows.slice(0, MAX_ROWS).map(({ at: _at, ...row }) => row);
+  }
+  return [];
+}

package/.grok/hooks/session-start.mjs

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
 
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 import { renderMark } from './lit-mark.mjs';
 import { claimSessionIgnition } from './record-passive-event.mjs';
+import { adhdSuggestion } from '../skills/lit-adhd/scripts/lib/suggest.mjs';
 
 // Decode once: a multi-byte character can straddle two pipe chunks.
 const chunks = [];
@@ -16,6 +19,20 @@ try {
   if (bytes > 1024 * 1024) throw new Error('EVENT_TOO_LARGE');
   event = JSON.parse(Buffer.concat(chunks).toString('utf8'));
   if (claimSessionIgnition(event)) process.stdout.write(`${renderMark({ args: process.argv.slice(2) }).join('\n')}\n`);
+  // One nudge toward the catch-up brief per day, only when this project has other recent sessions.
+  // Best effort: a broken suggestion never breaks session start.
+  try {
+    const home = process.env.HOME || homedir();
+    const line = adhdSuggestion({
+      storeDir: join(home, '.grok', 'sessions'),
+      projectRoot: event.realWorkspaceRoot ?? event.workspaceRoot ?? event.cwd ?? process.cwd(),
+      sessionId: event.sessionId ?? process.env.GROK_SESSION_ID,
+      stateRoot: event.realWorkspaceRoot ?? event.workspaceRoot ?? event.cwd ?? process.cwd(),
+    });
+    if (line) process.stdout.write(`${line}\n`);
+  } catch {
+    // No suggestion; session start continues.
+  }
 } catch (error) {
   process.stderr.write(`LitGrok session-start: ${error.code || 'EVENT_INVALID'}\n`);
   process.exitCode = 1;

package/.grok/hooks/workflow-stage.mjs

@@ -60,21 +60,24 @@ const SPACED_PLAN_PATTERN = /^\s*\/?lit\s+plan(?=$|[^\w-])/iu;
 const SPACED_REVIEW_PATTERN = /^\s*\/?lit\s+review(?=$|[^\w-])/iu;
 // Open brainstorming is no workflow stage: it names its own discipline and leaves the row where it was.
 const BRAINSTORM_PATTERN = /^\s*\/?(?:lit-brainstorm|lit\s+(?:brainstorm|brainstorming|ideation|ideate|idea|ideas))(?=$|[^\w-])/iu;
+// Catch-up is no workflow stage either: it names its own discipline and leaves the row where it was.
+const ADHD_PATTERN = /^\s*\/?(?:lit-adhd|lit-rewind|lit\s+(?:adhd|rewind))(?=$|[^\w-])/iu;
 
 /**
  * The stage a prompt names and how it enters it: 'switch' for a named skill (`discipline` is 'lit-plan' for the
  * spaced `lit plan`, null for the spaced `lit review`), 'continue' or 'restart' for lit. A brainstorm prompt
- * carries the discipline 'lit-brainstorm' and no stage.
+ * carries the discipline 'lit-brainstorm' and no stage; a catch-up prompt carries 'lit-adhd' and no stage.
  */
 export function entryFromPrompt(visibleText) {
   if (typeof visibleText !== 'string') return null;
   if (BRAINSTORM_PATTERN.test(visibleText)) return { stage: null, entry: 'switch', discipline: 'lit-brainstorm' };
+  if (ADHD_PATTERN.test(visibleText)) return { stage: null, entry: 'switch', discipline: 'lit-adhd' };
   const match = STAGE_PATTERN.exec(visibleText);
   if (!match) return null;
   const token = match[1].toLowerCase();
   if (token !== 'lit') return { stage: STAGE_OF[token], entry: 'switch' };
   if (SPACED_PLAN_PATTERN.test(visibleText)) return { stage: STAGE_OF['lit-plan'], entry: 'switch', discipline: 'lit-plan' };
-  if (SPACED_REVIEW_PATTERN.test(visibleText)) return { stage: STAGE_OF['review-work'], entry: 'switch', discipline: null };
+  if (SPACED_REVIEW_PATTERN.test(visibleText)) return { stage: STAGE_OF['review-work'], entry: 'switch', discipline: 'review-work' };
   return { stage: STAGE_OF.lit, entry: RESTART_PATTERN.test(visibleText) ? 'restart' : 'continue' };
 }
 

package/.grok/rules/00-litgrok.md

@@ -102,6 +102,7 @@ Judge by this session's own state (earlier banner, plan file, workflow row), nev
 - A named discipline (`lit plan`, `lit-plan`, `start-work`, `review-work`, `lit review plan|work`) switches: ignite it once, in full.
 - `lit brainstorm|brainstorming|ideation|ideate|idea|ideas …` opens `lit-brainstorm` (options only, no edits), never deep-interview, lit-plan or the Office and film routes.
 - An approved plan or an active start-work plus a bare `lit` resumes that work; write no second plan.
+- A bare `go` within 30 minutes (plan mtime) of saving a plan here loads start-work on it.
 - `lit new …` and `lit restart …` start fresh with the full activation.
 - A bare `lit` with nothing active asks one question to confirm; `lit fix X` never does.
 
@@ -122,11 +123,24 @@ Exclusions are checked before the trigger and route away even when a video noun
 - (iii) an Office deliverable other than a bare 발표 — 발표자료, 슬라이드, PPT, 덱, 보고서, 문서, slides, deck, pptx, report, document — with 넣, 삽입, embed or insert: that Office skill;
 - (iv) a text or image about a video — 스크립트, 대본, 썸네일, 요약, 기획안, script, transcript, thumbnail, summary, storyboard: its own task;
 - (v) motion on an interface with no video noun — 버튼, 호버, button, hover, motion tokens, reduced motion: `frontend-ui-ux`.
+- (vi) a drawing of real equipment, even as an HTML page or a loop: `lit-schematic`.
 
 Film context: this is a film request. Load `lit-typographic-motion` from `.grok/skills/lit-typographic-motion/` (project) or `~/.grok/skills/lit-typographic-motion/` (user) and write `treatment.json` in the run's output directory first. Path rule: the type path when the words themselves are the film; the stage path for every other film, including anything with shapes, drawn objects, diagrams or imagery; a 9:16 film always takes the stage path. Every frame and track passes through the skill's renderer; hand-encoded films are not the deliverable. Never claim a hook routed the prompt.
 
 Film commands, run from the skill root: `node scripts/motion.mjs` with `make`, `stage`, `sound`, `look`, `gate`, `verify` (each takes `--out <dir>`); a README cover loop uses `cover` and `cover-gate` (references/cover.md); pre-warm outside the session with `npm exec --yes --package @litfamily/litgrok@<installed version> -- litgrok motion-runtime install`.
 
+## Equipment drawings
+
+For an authorized bare `lit` request to draw real process or lab equipment, or `/lit-schematic`, load `lit-schematic` from `.grok/skills/lit-schematic/` (project) or `~/.grok/skills/lit-schematic/` (user). Triggers: P&ID, PFD, BFD, 공정도, 계장도, 장치도, 모식도, 배치도, 계통도, 단면도, apparatus, isometric cutaway, equipment layout. Measured-data plots go to `lit-scientific-visualization`, software or business diagrams to `lit-diagram-drawer`, a report or deck about a drawing to its Office skill, an interface that shows one to `frontend-ui-ux`.
+
+## Brief over sessions
+
+For an authorized bare `lit` request to catch up on every recent session of the repository, or `/lit-adhd` or `/lit-rewind`, load `lit-adhd` from `.grok/skills/lit-adhd/` (project) or `~/.grok/skills/lit-adhd/` (user). Triggers: adhd, rewind, where was I, catch up, 어디까지, 브리핑. It runs read-only and prints the drawn brief; it never edits plans or files. One session's own state is `lit-recap`; many sessions' state is this skill.
+
+## Mechanism ports
+
+For an authorized bare `lit` request to port someone else's published technique into a skill or system, or `/lit-hijack`, load `lit-hijack` from `.grok/skills/lit-hijack/` (project) or `~/.grok/skills/lit-hijack/` (user). Triggers: hijack, hijacking, 하이재킹, 하이잭. The route words directly after `lit` win over trigger or owner words later in the prompt. Finding sources first goes to `litresearch`, planning the port to `lit-plan`, executing it to `start-work`, and reviewing the diff to `review-work`. A request that only draws equipment goes to `lit-schematic` even when it names a port; a topic with no sources goes to `litresearch` first.
+
 ## Office output selection
 
 For an authorized bare `lit` request, choose `lit-docx` for a report, doc, docx, Word, 보고서, 리포트, 기획서, 제안서, 문서, or 워드, and `lit-pptx` for slides, deck, presentation, PPT, pptx, 발표자료, 발표, 슬라이드, 덱, or 피피티. If both groups occur, use both skills. A file asked for as Markdown or plain text (`report.md`, `.txt`) is no Office file: write plain Markdown for its reader, without front matter or `:::` blocks, and load neither skill. Put figures with units or periods in a table and asked-for decisions in a numbered list. Judge the task's intent, not stray quoted words or file contents.

package/.grok/skills/frontend-ui-ux/ATTRIBUTION.md

@@ -0,0 +1,23 @@
+# ATTRIBUTION / NOTICE: frontend-ui-ux craft floor, slop register and interface probe
+
+The craft-floor and slop-register rules (`references/craft-floor.md`,
+`references/slop-register.md`), the interface probe (`scripts/interface-probe.mjs` and its
+modules) and the build, polish, audit and harden modes were written for LitGrok after studying
+public projects, credited below. **No source file, prose, fixture or golden file from any studied
+project is vendored, copied or redistributed here.** A guard test fails if any packed file is
+byte-identical to a listed reference skill file.
+
+The UI/UX Pro Max design data keeps its own notice in `THIRD-PARTY-NOTICE.txt`, which is pinned
+to that dataset's provenance; these credits live here so the two records stay independent.
+
+---
+
+- **jakubkrehel/skills** (https://github.com/jakubkrehel/skills),
+  Copyright (c) 2026 Jakub Krehel, MIT License, consulted at upstream commit `267330e`. Its
+  mode, review-format and routing-governance mechanisms were re-expressed.
+- **ui-skills.com playbook** (https://www.ui-skills.com/playbook), sourced from
+  **ibelick/ui-skills** (https://github.com/ibelick/ui-skills),
+  Copyright (c) 2026 Julien Thibeaut, MIT License. Its anti-slop entries and responsive and
+  polish values were cross-checked and re-expressed.
+
+This file ships as long as those references and the probe ship; remove it only with them.

package/.grok/skills/frontend-ui-ux/SKILL.md

@@ -10,12 +10,13 @@ argument-hint: "<surface and intended outcome>"
 Use Grok Build's selected skill and authorized repository tools. A clear build request proceeds to implementation and rendered inspection; a contract alone is not delivery. Review-only and plan-only requests authorize no edits. Incidental mentions are not requests; infer a bare target only when one frontend is unambiguous.
 
 Read references/production.md when deciding whether to clarify or build.
+Ask a numbered choice of house style first (recommended first); skip only when the prompt names it or says you choose.
 Read references/complete-contract.md for the v1beta2 contract and validation limits.
 Read references/probe-loop.md for the required rendered check and fix cycle.
 
 Record direction and inventory, then implement. Evolve and validate the `litfamily.design-contract/v1beta2` contract as decisions settle; retain its evidence requirements. Respect explicit art direction and existing tokens, or use the authored editorial/pixel profile in the production reference.
 
-Resolve resources from the exact selected SKILL.md parent; bind its absolute path as FRONTEND_SKILL_ROOT and quote it, including spaces. Run scripts/verify-canonical-corpus.mjs before corpus use. Run scripts/validate-design-contract.mjs to validate the task contract. Run scripts/query-design-intelligence.mjs when retrieval helps. Run scripts/import-design-intelligence.mjs before trusting its dataset. See the complete contract for rooted commands.
+Resolve resources from the exact selected SKILL.md parent; bind its absolute path as FRONTEND_SKILL_ROOT and quote it, including spaces. Run scripts/verify-canonical-corpus.mjs before corpus use. Run scripts/validate-design-contract.mjs to validate the task contract. Run scripts/query-design-intelligence.mjs when retrieval helps. Run scripts/import-design-intelligence.mjs before trusting its dataset. Run scripts/design-lock.mjs init --family <landing|workspace|settings> when the lock is missing. Run scripts/pixel-art.mjs init <style-id> to see the pixels first. Run scripts/interface-probe.mjs <built-page-or-directory> --out <task-evidence-directory> when the page stands. See the complete contract for rooted commands.
 
 ## Reference routes
 
@@ -27,6 +28,7 @@ Load references/craft-floor.md when checking numeric craft or responsive rules.
 Load references/composition.md when reading order, columns, or density is undecided.
 Load references/creative-directions.md when comparing visual directions.
 Load references/evidence-review.md when preparing observations or an independent verdict.
+Load references/house-styles.md when naming the style, then lock it with design-lock.
 Load references/implementation-platforms.md when rendering or styling changes.
 Load references/inclusive-interface.md when keyboard, semantics, CJK, IME, or preferences matter.
 Load references/interaction-motion.md when states, feedback, focus, or motion need specification.
@@ -34,6 +36,7 @@ Load references/motion-guide.md when planning animation timing, scroll choreogra
 Load references/operating-lanes.md when selecting or recording the lane.
 Load references/performance-delivery.md when budgets or critical-path evidence matter.
 Load references/product-direction.md when the user, completion condition, or non-goal is unclear.
+Load references/production-interview.md before the production round.
 Load references/redesign-playbook.md when changing an existing visual language.
 Load references/system-foundations.md when token layers or primitives need grounding.
 Load references/slop-register.md when reviewing generic patterns and functional tells.

package/.grok/skills/frontend-ui-ux/examples/phase-3-readme-ab/README.md

@@ -0,0 +1,9 @@
+# Phase 3 README A/B example slot
+
+Add one directory per completed run under this path. Each case directory contains:
+
+- `before.md` and `after.md`: the README copy before and after the design pass.
+- `before.png` and `after.png`: matching screenshots from the same viewport and state.
+
+Record the prompt, viewport, and run date in the case notes. Add a case only after both
+versions have been rendered and reviewed.