@llblab/pi-kit 0.5.2 → 0.6.0

package/node_modules/@llblab/pi-telegram/lib/queue.ts

@@ -1498,6 +1498,10 @@ export interface TelegramAgentEndRuntimeDeps<
   updateStatus: () => void;
   dispatchNextQueuedTelegramTurn: () => void;
   scheduleActiveTurnDelivery?: (task: () => Promise<void>) => void;
+  preparePreviewDelivery?: (isDeliveryActive: () => boolean) => Pick<
+    TelegramAgentEndRuntimeDeps<TTurn, TReplyMarkup>,
+    "clearPreview" | "setPreviewPendingText" | "finalizeMarkdownPreview"
+  > | undefined;
   preparePreviewClear?: (
     chatId: number,
     options?: { target?: TelegramQueueTarget; isDeliveryActive?: () => boolean },
@@ -1595,6 +1599,7 @@ export interface TelegramAgentEndHookRuntimeDeps<
     schedule: (task: () => Promise<void>) => void;
     cancel: () => void;
   };
+  preparePreviewDelivery?: TelegramAgentEndRuntimeDeps<TTurn, TReplyMarkup>["preparePreviewDelivery"];
   preparePreviewClear?: TelegramAgentEndRuntimeDeps<TTurn, TReplyMarkup>["preparePreviewClear"];
   clearPreview: TelegramAgentEndRuntimeDeps<
     TTurn,
@@ -1746,6 +1751,7 @@ export function createTelegramAgentEndHook<
                 await task();
               })
           : undefined,
+        preparePreviewDelivery: deps.preparePreviewDelivery,
         preparePreviewClear: deps.preparePreviewClear,
         clearPreview: deps.clearPreview,
         setPreviewPendingText: deps.setPreviewPendingText,
@@ -1807,9 +1813,13 @@ export async function handleTelegramAgentEndRuntime<
   const isDeliveryActive = (): boolean =>
     deps.isSessionActive?.() !== false &&
     (!turn || deps.isTurnTransportActive?.(turn) !== false);
+  const preview = turn && !turn.guestQueryId ? deps.preparePreviewDelivery?.(isDeliveryActive) : undefined;
+  const setPreviewPendingText = preview?.setPreviewPendingText ?? deps.setPreviewPendingText;
+  const finalizeMarkdownPreview = preview?.finalizeMarkdownPreview ?? deps.finalizeMarkdownPreview;
   const clearPreview = turn
-    ? deps.preparePreviewClear?.(turn.chatId, { target: turn.target, isDeliveryActive })
-      ?? (() => deps.clearPreview(turn.chatId, { target: turn.target }))
+    ? preview ? () => preview.clearPreview(turn.chatId, { target: turn.target })
+      : deps.preparePreviewClear?.(turn.chatId, { target: turn.target, isDeliveryActive })
+        ?? (() => deps.clearPreview(turn.chatId, { target: turn.target }))
     : undefined;
   const updateStatusIgnoringStaleContext = (): void => {
     try {
@@ -1914,7 +1924,7 @@ export async function handleTelegramAgentEndRuntime<
       if (endPlan.shouldDispatchNext) deps.dispatchNextQueuedTelegramTurn();
       return;
     }
-    if (finalText) deps.setPreviewPendingText(finalText);
+    if (finalText) setPreviewPendingText(finalText);
 
     if (!isDeliveryActive()) return;
     let richAttachmentDelivered = false;
@@ -1932,9 +1942,9 @@ export async function handleTelegramAgentEndRuntime<
         );
         if (!isDeliveryActive()) return;
         if (richAttachmentDelivered) {
-          await deps.clearPreview(turn.chatId, { target: turn.target });
+          await clearPreview?.();
           if (!isDeliveryActive()) return;
-          deps.setPreviewPendingText("");
+          setPreviewPendingText("");
         }
       } catch (error) {
         if (!isDeliveryActive()) return;
@@ -1949,7 +1959,7 @@ export async function handleTelegramAgentEndRuntime<
     if (!isDeliveryActive()) return;
     if (!richAttachmentDelivered && endPlan.kind === "text" && finalText) {
       try {
-        const finalized = await deps.finalizeMarkdownPreview(
+        const finalized = await finalizeMarkdownPreview(
           turn.chatId,
           finalText,
           turn.replyToMessageId,
@@ -1957,7 +1967,7 @@ export async function handleTelegramAgentEndRuntime<
         );
         if (!isDeliveryActive()) return;
         if (!finalized) {
-          await deps.clearPreview(turn.chatId, { target: turn.target });
+          await clearPreview?.();
           if (!isDeliveryActive()) return;
           await deps.sendMarkdownReply(
             turn.chatId,
@@ -1967,7 +1977,7 @@ export async function handleTelegramAgentEndRuntime<
           );
         }
         if (!isDeliveryActive()) return;
-        deps.setPreviewPendingText("");
+        setPreviewPendingText("");
       } catch (error) {
         deps.recordRuntimeEvent?.("delivery", error, {
           phase: "final-text",

package/node_modules/@llblab/pi-telegram/lib/replies.ts

@@ -9,6 +9,7 @@ import {
   getTelegramTargetThreadParams,
   type TelegramTarget,
 } from "./target.ts";
+import { isTelegramApiCommitUnknownError } from "./telegram-api.ts";
 import type {
   TelegramInputRichMessage,
   TelegramReplyParameters,
@@ -67,6 +68,7 @@ export function createReplyDedupRuntime(): ReplyDedupRuntime {
 // --- Transport-level dedup ---
 
 const lastRepliedToMessageIdByTarget = new Map<string, number>();
+let replyDedupGeneration = 0;
 
 function getReplyDedupTargetKey(
   chatId: number,
@@ -79,6 +81,7 @@ function getReplyDedupTargetKey(
 }
 
 export function resetTransportReplyDedup(): void {
+  replyDedupGeneration += 1;
   lastRepliedToMessageIdByTarget.clear();
 }
 
@@ -99,13 +102,29 @@ export function buildTelegramReplyParameters(
   };
 }
 
-export function buildTelegramMultipartReplyParameters(
+// Answer publications are caller-serialized. A rejected send releases its anchor;
+// an uncertain ACK retains it because Telegram may already have delivered it.
+export async function withTelegramReplyParameters<T>(
   chatId: number,
   messageId: number | undefined,
-  target?: TelegramTarget,
-): string | undefined {
+  target: TelegramTarget | undefined,
+  send: (parameters: TelegramReplyParameters | undefined) => Promise<T>,
+): Promise<T> {
+  const key = getReplyDedupTargetKey(chatId, target);
+  const generation = replyDedupGeneration;
+  const previous = lastRepliedToMessageIdByTarget.get(key);
   const parameters = buildTelegramReplyParameters(chatId, messageId, target);
-  return parameters ? JSON.stringify(parameters) : undefined;
+  try {
+    return await send(parameters);
+  } catch (error) {
+    if (parameters && !isTelegramApiCommitUnknownError(error)
+      && generation === replyDedupGeneration
+      && lastRepliedToMessageIdByTarget.get(key) === messageId) {
+      if (previous === undefined) lastRepliedToMessageIdByTarget.delete(key);
+      else lastRepliedToMessageIdByTarget.set(key, previous);
+    }
+    throw error;
+  }
 }
 
 function getAgentMessageField(message: unknown, field: string): unknown {
@@ -239,24 +258,18 @@ export async function sendTelegramRenderedChunks<TReplyMarkup>(
   assertTelegramInlineKeyboardCallbackData(options?.replyMarkup);
   let lastMessageId: number | undefined;
   for (const [index, chunk] of chunks.entries()) {
-    const replyParameters =
-      index === 0
-        ? buildTelegramReplyParameters(
-            chatId,
-            options?.replyToMessageId,
-            options?.target,
-          )
-        : undefined;
-    const body = {
-      chat_id: chatId,
-      text: chunk.text,
-      parse_mode: chunk.parseMode,
-      reply_markup:
-        index === chunks.length - 1 ? options?.replyMarkup : undefined,
-      ...(replyParameters ? { reply_parameters: replyParameters } : {}),
-      ...(options?.target ? getTelegramTargetThreadParams(options.target) : {}),
-    };
-    const sent = await deps.sendMessage(body);
+    const sent = await withTelegramReplyParameters(
+      chatId, index === 0 ? options?.replyToMessageId : undefined, options?.target,
+      (replyParameters) => deps.sendMessage({
+        chat_id: chatId,
+        text: chunk.text,
+        parse_mode: chunk.parseMode,
+        reply_markup:
+          index === chunks.length - 1 ? options?.replyMarkup : undefined,
+        ...(replyParameters ? { reply_parameters: replyParameters } : {}),
+        ...(options?.target ? getTelegramTargetThreadParams(options.target) : {}),
+      }),
+    );
     lastMessageId = sent.message_id;
     deps.recordOwnership?.({
       chatId,
@@ -655,22 +668,17 @@ export async function sendTelegramNativeMarkdownReply<TReplyMarkup = unknown>(
   let lastMessageId: number | undefined;
   const chunks = splitTelegramNativeMarkdown(markdown);
   for (const [index, chunk] of chunks.entries()) {
-    const replyParameters =
-      index === 0
-        ? buildTelegramReplyParameters(
-            chatId,
-            replyToMessageId,
-            options?.target,
-          )
-        : undefined;
-    const sent = await deps.sendRichMessage({
-      chat_id: chatId,
-      rich_message: { markdown: chunk, skip_entity_detection: true },
-      reply_markup:
-        index === chunks.length - 1 ? options?.replyMarkup : undefined,
-      ...(replyParameters ? { reply_parameters: replyParameters } : {}),
-      ...(options?.target ? getTelegramTargetThreadParams(options.target) : {}),
-    });
+    const sent = await withTelegramReplyParameters(
+      chatId, index === 0 ? replyToMessageId : undefined, options?.target,
+      (replyParameters) => deps.sendRichMessage({
+        chat_id: chatId,
+        rich_message: { markdown: chunk, skip_entity_detection: true },
+        reply_markup:
+          index === chunks.length - 1 ? options?.replyMarkup : undefined,
+        ...(replyParameters ? { reply_parameters: replyParameters } : {}),
+        ...(options?.target ? getTelegramTargetThreadParams(options.target) : {}),
+      }),
+    );
     lastMessageId = sent.message_id;
     deps.recordOwnership?.({
       chatId,

package/node_modules/@llblab/pi-telegram/lib/telegram-api.ts

@@ -1783,11 +1783,44 @@ export function createTelegramBridgeApiRuntime(
  */
 export function createTelegramApiClient(
   getBotToken: () => string | undefined,
-  options: TelegramAnswerCallbackQueryOptions = {},
+  options: TelegramAnswerCallbackQueryOptions & { now?: () => number } = {},
 ): TelegramApiClient {
+  const now = options.now ?? Date.now;
+  const draftRetryNotBeforeByTarget = new Map<string, number>();
   return {
-    call: async (method, body, options) => {
-      return callTelegram(getBotToken(), method, body, options);
+    call: async <TResponse>(
+      method: string,
+      body: Record<string, unknown>,
+      options?: TelegramApiCallOptions,
+    ): Promise<TResponse> => {
+      const token = getBotToken();
+      // Cooldown keys retain only the public bot-id prefix, not the credential.
+      const botId = token?.match(/^(\d+):/)?.[1];
+      const isDraft = method === "sendMessageDraft" || method === "sendRichMessageDraft";
+      const draftKey = isDraft && botId
+        ? `${botId}:${String(body.chat_id)}:${String(body.message_thread_id ?? "all")}`
+        : undefined;
+      if (draftKey) {
+        const nowMs = now();
+        for (const [key, deadline] of draftRetryNotBeforeByTarget) {
+          if (nowMs >= deadline) draftRetryNotBeforeByTarget.delete(key);
+        }
+        if (draftRetryNotBeforeByTarget.has(draftKey)) return false as TResponse;
+      }
+      try {
+        // A draft is a replaceable snapshot, not a body to replay after backoff.
+        return await callTelegram<TResponse>(
+          token, method, body, isDraft ? { ...options, maxAttempts: 1 } : options,
+        );
+      } catch (error) {
+        if (draftKey && isRetryableTelegramApiError(error)) {
+          draftRetryNotBeforeByTarget.set(draftKey, Math.max(
+            draftRetryNotBeforeByTarget.get(draftKey) ?? 0,
+            now() + getTelegramRetryDelayMs(error, 0, options?.retryBaseDelayMs ?? 500),
+          ));
+        }
+        throw error;
+      }
     },
     callMultipart: async (
       method,

package/node_modules/@llblab/pi-telegram/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.43.2",
+  "version": "0.44.0",
   "private": false,
   "publishConfig": {
     "access": "public"

package/node_modules/@llblab/skills/abcd-context/AGENTS.md

@@ -36,5 +36,6 @@
 - `Path Portability`: Resolve paths through Node rather than platform-specific shell utilities.
 - `Human Output`: Emit concise readable logs and a summary; `NO_COLOR=1` suppresses color.
 - `Bounded Scanning`: Skip link scanning above the configured byte threshold while validating the surrounding graph.
+- `Contiguous Lists`: Fail blank lines inside one Markdown list; list items are contiguous structural peers, not paragraphs. Ignore fenced examples and bounded-scan exclusions.
 - `Compact Tables`: Fail non-compact delimiter cells; require exactly three hyphens with one space inside each pipe, while table rows over 120 characters only warn.
 - `Core Shape Flexibility`: Accept both numbered mature-project sections and compact skill-style durable sections.

package/node_modules/@llblab/skills/abcd-context/CHANGELOG.md

@@ -1,8 +1,12 @@
 # Changelog
 
-## 1.5.3
+## 1.14.1
 
-- `Markdown Freedom`: LaTeX syntax is now allowed, while table checks always enforce compact three-hyphen delimiter cells and warn on rows over 120 characters without imposing a maximum. Indented backtick and tilde code fences remain excluded from table validation. Impact: context authors can use mathematical notation and fenced examples while receiving default, noise-focused table formatting guidance.
+- `Contiguous Markdown Lists`: The validator now rejects blank lines inside continuous lists, including multiline and nested item boundaries, while ignoring fenced examples and bounded large-reference scans. Impact: list items remain structural peers instead of being formatted as separate paragraphs.
+
+## 1.13.2
+
+- `Markdown Freedom`: LaTeX syntax is now allowed, while table checks always enforce compact three-hyphen delimiter cells and warn on rows over 120 characters without imposing a maximum. Indented backtick and tilde code fences remain excluded from table validation. Impact: context authors can use mathematical notation and fenced examples while receiving default, noise-focused table formatting guidance
 
 ## 1.5.2
 

package/node_modules/@llblab/skills/abcd-context/SKILL.md

@@ -102,7 +102,7 @@ Run the Node validator from the project root or pass an explicit root:
 node "${SKILL_DIR}/scripts/validate-context.mjs" /path/to/project
 ```
 
-Output is human-readable. Markdown table checks always require compact delimiter cells such as `| --- | ---: | :--- |`; non-compact delimiters fail validation, while rows longer than 120 characters only warn without imposing a maximum length.
+Output is human-readable. Markdown list items must remain contiguous: blank lines inside one list fail validation, including between multiline or nested items, while fenced examples are ignored. Markdown table checks always require compact delimiter cells such as `| --- | ---: | :--- |`; non-compact delimiters fail validation, while rows longer than 120 characters only warn without imposing a maximum length.
 
 Useful environment controls:
 

package/node_modules/@llblab/skills/abcd-context/docs/validation-design.md

@@ -28,10 +28,11 @@ A missing or non-directory root fails before validation.
 6. `README reachability — Warning`: Finds subtree README files with no inbound Markdown link.
 7. `Meta-protocol presence — Warning`: Checks the durable file for `Meta-Protocol Principles`.
 8. `Bloat signals — Warning`: Reports low information density or sparse structure in the durable file.
-9. `Markdown tables — Error/Warning`: Always fails non-compact delimiter rows and warns about table rows longer than 120 characters.
-10. `Freshness — Warning`: Reports durable files older than 30 days.
-11. `Docs directory — Warning`: Checks for `/docs`.
-12. `Docs index coverage — Warning`: Detects docs missing from `docs/README.md` and indexed files that do not exist.
+9. `Markdown lists — Error`: Fails blank lines within one continuous list, including multiline and nested items, while ignoring fenced examples and files above the bounded Markdown scan limit.
+10. `Markdown tables — Error/Warning`: Always fails non-compact delimiter rows and warns about table rows longer than 120 characters.
+11. `Freshness — Warning`: Reports durable files older than 30 days.
+12. `Docs directory — Warning`: Checks for `/docs`.
+13. `Docs index coverage — Warning`: Detects docs missing from `docs/README.md` and indexed files that do not exist.
 
 ## Severity Contract
 
@@ -70,6 +71,10 @@ The validator avoids a hard file-length limit. It checks independent signals:
 
 Signals suggest consolidation; they do not replace judgment.
 
+## Markdown Lists
+
+List checks apply to Markdown within the bounded scan size and outside fenced code blocks. A blank line fails when it separates sibling list items, a list item from its nested list, nested sibling items, or a multiline item's continuation from its next item. Paragraphs and independent blocks remain separated by blank lines normally.
+
 ## Markdown Tables
 
 Table checks always run and have no enabling option.
@@ -93,7 +98,8 @@ Validation prints each check and a summary by default. `NO_COLOR=1` disables ANS
 3. A missing path, which must fail clearly.
 4. The removed `--json` option, which must fail clearly.
 5. A temporary fixture with an out-of-range line reference, which must fail clearly.
-6. Temporary fixtures proving that LaTeX and compact table delimiters pass, non-compact delimiters fail, and rows over 120 characters warn.
+6. Temporary fixtures proving that contiguous multiline/nested lists and fenced examples pass while blank separators inside lists fail.
+7. Temporary fixtures proving that LaTeX and compact table delimiters pass, non-compact delimiters fail, and rows over 120 characters warn.
 
 The fixture remains linked from [its README](../fixtures/abcd-project/README.md).
 

package/node_modules/@llblab/skills/abcd-context/scripts/_self-test.mjs

@@ -23,6 +23,7 @@ const missingPathOutput = run([path.join(fixtureRoot, "missing")], {
 const jsonOptionOutput = run(["--json"]);
 const invalidLineRefRoot = createInvalidLineRefFixture();
 const tableRoot = createTableFixture();
+const listRoot = createListFixture();
 try {
   const invalidLineRefOutput = run([invalidLineRefRoot], {
     withoutRootEnv: true,
@@ -49,6 +50,12 @@ try {
       .replace("|------------|---:|", "| --- | ---: |"),
   );
   const wideTableOutput = run([tableRoot], { withoutRootEnv: true });
+  const tightListOutput = run([listRoot], { withoutRootEnv: true });
+  fs.appendFileSync(
+    path.join(listRoot, "docs/lists.md"),
+    "\n- First loose item.\n  Continued detail.\n\n- Second loose item.\n  - Nested item.\n\n  - Nested sibling.\n",
+  );
+  const looseListOutput = run([listRoot], { withoutRootEnv: true });
 
   checkSuccess("default fixture", defaultOutput);
   checkSuccess("fixture path arg", pathOutput);
@@ -59,9 +66,12 @@ try {
   checkCompactTableAndLatex(compactTableOutput);
   checkNonCompactTable(nonCompactTableOutput);
   checkWideTable(wideTableOutput);
+  checkTightLists(tightListOutput);
+  checkLooseLists(looseListOutput);
 } finally {
   fs.rmSync(invalidLineRefRoot, { recursive: true, force: true });
   fs.rmSync(tableRoot, { recursive: true, force: true });
+  fs.rmSync(listRoot, { recursive: true, force: true });
 }
 
 console.log("PASS: validate-context fixture + self-reference regression");
@@ -146,6 +156,57 @@ function checkWideTable(result) {
   );
 }
 
+function checkTightLists(result) {
+  assert(result.status === 0, "contiguous lists and fenced examples pass");
+  assert(
+    result.stdout.includes("Markdown list checks passed"),
+    "contiguous list check reports success",
+  );
+}
+
+function checkLooseLists(result) {
+  assert(result.status !== 0, "blank lines inside lists fail validation");
+  assert(
+    result.stdout.includes("Blank line inside Markdown list: docs/lists.md"),
+    "loose list failure identifies its file",
+  );
+}
+
+function createListFixture() {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), "abcd-context-list-"));
+  fs.mkdirSync(path.join(root, "docs"));
+  fs.writeFileSync(
+    path.join(root, "README.md"),
+    "# Probe\n\n[Context](./AGENTS.md) [Backlog](./BACKLOG.md) [History](./CHANGELOG.md) [Docs](./docs/README.md)\n",
+  );
+  fs.writeFileSync(
+    path.join(root, "AGENTS.md"),
+    "# Context\n\n## Meta-Protocol Principles\n\n- First rule.\n- Second rule.\n\n## Operating Principles\n\n- Rule.\n",
+  );
+  fs.writeFileSync(path.join(root, "BACKLOG.md"), "# Backlog\n\nNo open work.\n");
+  fs.writeFileSync(path.join(root, "CHANGELOG.md"), "# Changelog\n\nNo releases.\n");
+  fs.writeFileSync(path.join(root, "docs/README.md"), "# Docs\n\n- [Lists](./lists.md)\n");
+  fs.writeFileSync(
+    path.join(root, "docs/lists.md"),
+    [
+      "# Lists",
+      "",
+      "1. First item.",
+      "2. Second item.",
+      "   - Nested item.",
+      "   - Nested sibling.",
+      "",
+      "```markdown",
+      "- Fenced item.",
+      "",
+      "- Fenced loose item.",
+      "```",
+      "",
+    ].join("\n"),
+  );
+  return root;
+}
+
 function createTableFixture() {
   const root = fs.mkdtempSync(path.join(os.tmpdir(), "abcd-context-table-"));
   fs.mkdirSync(path.join(root, "docs"));

package/node_modules/@llblab/skills/abcd-context/scripts/validate-context.mjs

@@ -16,6 +16,7 @@ for (let index = 0; index < args.length; index += 1) {
         "Validates the current directory by default, VALIDATE_CONTEXT_ROOT when set,",
         "or the explicit project-root argument when provided.",
         "",
+        "Markdown list items must be contiguous; blank separators fail validation.",
         "Markdown table formatting is always checked. Rows over 120 characters warn.",
       ].join("\n"),
     );
@@ -167,6 +168,53 @@ function markdownLines(text) {
   });
 }
 
+function markdownIndent(line) {
+  const leading = line.match(/^[ \t]*/)?.[0] || "";
+  return [...leading].reduce((width, char) => width + (char === "\t" ? 4 : 1), 0);
+}
+
+function findLooseListBlankLines(text) {
+  const lines = markdownLines(text);
+  const listIndents = [];
+  let pendingBlankLine;
+  const violations = [];
+  for (let index = 0; index < lines.length; index += 1) {
+    const { line, outsideFence } = lines[index];
+    if (!outsideFence) {
+      listIndents.length = 0;
+      pendingBlankLine = undefined;
+      continue;
+    }
+    if (/^\s*$/.test(line)) {
+      if (listIndents.length > 0 && pendingBlankLine === undefined) {
+        pendingBlankLine = index + 1;
+      }
+      continue;
+    }
+    const item = line.match(/^([ \t]*)(?:[-+*]|\d+[.)])[ \t]+\S/);
+    if (item) {
+      const indent = markdownIndent(item[1]);
+      if (pendingBlankLine !== undefined) violations.push(pendingBlankLine);
+      while (listIndents.length > 0 && listIndents.at(-1) > indent) listIndents.pop();
+      if (listIndents.at(-1) !== indent) listIndents.push(indent);
+      pendingBlankLine = undefined;
+      continue;
+    }
+    if (pendingBlankLine !== undefined) {
+      if (markdownIndent(line) > (listIndents.at(-1) ?? 0)) {
+        violations.push(pendingBlankLine);
+        pendingBlankLine = undefined;
+        continue;
+      }
+      listIndents.length = 0;
+      pendingBlankLine = undefined;
+      continue;
+    }
+    if (/^ {0,3}(?:#{1,6}\s|>|\|)/.test(line)) listIndents.length = 0;
+  }
+  return violations;
+}
+
 function stripFences(text) {
   return markdownLines(text)
     .filter(({ outsideFence }) => outsideFence)
@@ -392,6 +440,25 @@ if (contextFile) {
 
 const docsDir = path.join(root, "docs");
 
+progress("Checking Markdown lists...");
+let listIssue = false;
+for (const file of mdFiles) {
+  const sourceSize = fs.statSync(file).size;
+  if (sourceSize > markdownLinkScanMaxBytes) {
+    info(
+      `Skipped list validation for large Markdown file: ${rel(file)} (${sourceSize} bytes > ${markdownLinkScanMaxBytes})`,
+    );
+    continue;
+  }
+  for (const line of findLooseListBlankLines(read(file))) {
+    fail(
+      `Blank line inside Markdown list: ${rel(file)}:${line} (keep adjacent list items contiguous)`,
+    );
+    listIssue = true;
+  }
+}
+if (!listIssue) pass("Markdown list checks passed");
+
 progress("Checking Markdown tables...");
 let tableIssue = false;
 for (const file of mdFiles) {

package/node_modules/@llblab/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/skills",
-  "version": "1.14.0",
+  "version": "1.14.1",
   "private": false,
   "description": "Dream Skills",
   "keywords": [

package/node_modules/@llblab/skills/release-flow/SKILL.md

@@ -210,7 +210,6 @@ After the hard gate passes:
 1.  Reconfirm immediately before push that local `dev` and `origin/dev` remain absent. Stop if either now exists or the remote check fails.
 2.  Push the release commit from local `main` to `origin/main` without creating a pull request.
 3.  Verify that `origin/main` resolves to the pushed local `main` commit.
-
 4.  Confirm the version on `main` matches the intended release version and that the current `main` commit is the released commit on `origin/main`.
 5.  Create and push exactly one release tag for the confirmed version on the current `main` commit:
 
@@ -268,9 +267,8 @@ npm view <package-name> version
 Treat an explicit npm not-found response as package absence. Authentication, authorization, network, registry-resolution, and other lookup failures are not absence; stop and report them. Automation-owned npm publication already performed this lookup before the hard gate and must not defer it until after tagging.
 
 15. Publish only when both conditions are true:
-
-- The package already exists on npm.
-- The `main` version matches the intended release version and is newer than the npm version established before publication.
+    - The package already exists on npm.
+    - The `main` version matches the intended release version and is newer than the npm version established before publication.
 
 When repository automation owns npm publication, never run `npm publish` manually. After all owning tag workflows succeed, require `npm view <package-name>@<version> version` to resolve to the intended version; stop if the package remains absent or mismatched.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-kit",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -43,10 +43,10 @@
     "@llblab/pi-actors": "0.52.1",
     "@llblab/pi-clean-room": "0.1.1",
     "@llblab/pi-codex-usage": "0.9.4",
-    "@llblab/pi-grow-loop": "0.7.4",
+    "@llblab/pi-grow-loop": "0.7.5",
     "@llblab/pi-state-flow": "0.3.0",
-    "@llblab/pi-telegram": "0.43.2",
-    "@llblab/skills": "1.14.0"
+    "@llblab/pi-telegram": "0.44.0",
+    "@llblab/skills": "1.14.1"
   },
   "bundledDependencies": [
     "@llblab/pi-actors",