@kubbisec/ai-linux-x64 0.1.25 → 0.1.28

package/bundled/skills/at-path-mentions.ts

@@ -0,0 +1,209 @@
+import { readdirSync, statSync } from "node:fs";
+import { basename, dirname, join, relative } from "node:path";
+import type { AutocompleteItem } from "@earendil-works/pi-tui";
+import {
+  extractAtPrefix,
+  parsePlanMentionPrefix,
+  parseSkillMentionPrefix,
+} from "./chat-mentions.js";
+
+function toDisplayPath(value: string): string {
+  return value.replace(/\\/g, "/");
+}
+
+function parsePathPrefix(prefix: string): {
+  rawPrefix: string;
+  isAtPrefix: boolean;
+  isQuotedPrefix: boolean;
+} {
+  if (prefix.startsWith('@"')) {
+    return { rawPrefix: prefix.slice(2), isAtPrefix: true, isQuotedPrefix: true };
+  }
+  if (prefix.startsWith('"')) {
+    return { rawPrefix: prefix.slice(1), isAtPrefix: false, isQuotedPrefix: true };
+  }
+  if (prefix.startsWith("@")) {
+    return { rawPrefix: prefix.slice(1), isAtPrefix: true, isQuotedPrefix: false };
+  }
+  return { rawPrefix: prefix, isAtPrefix: false, isQuotedPrefix: false };
+}
+
+function buildCompletionValue(
+  path: string,
+  options: { isAtPrefix: boolean; isQuotedPrefix: boolean },
+): string {
+  const needsQuotes = options.isQuotedPrefix || path.includes(" ");
+  const prefix = options.isAtPrefix ? "@" : "";
+  if (!needsQuotes) {
+    return `${prefix}${path}`;
+  }
+  const openQuote = `${prefix}"`;
+  return `${openQuote}${path}"`;
+}
+
+const DEPRIORITIZED_AT_PATH_NAMES = new Set([
+  "node_modules",
+  "dist",
+  "dist-bin",
+  ".turbo",
+  ".git",
+  "coverage",
+  "build",
+  ".next",
+  ".cache",
+  "tmp",
+  ".venv",
+  "target",
+]);
+
+const PRIORITY_AT_PATH_DIRS = [
+  "src",
+  "lib",
+  "apps",
+  "packages",
+  "scripts",
+  "test",
+  "tests",
+  "docs",
+  "spec",
+] as const;
+
+const PRIORITY_AT_PATH_FILES = [
+  "package.json",
+  "README.md",
+  "readme.md",
+  "tsconfig.json",
+  "vitest.config.ts",
+  "Cargo.toml",
+  "go.mod",
+  "pyproject.toml",
+  "Makefile",
+] as const;
+
+function atPathSuggestionRank(label: string): number {
+  const name = label.replace(/\/$/, "");
+  if (
+    PRIORITY_AT_PATH_DIRS.includes(name as (typeof PRIORITY_AT_PATH_DIRS)[number]) ||
+    PRIORITY_AT_PATH_FILES.includes(name as (typeof PRIORITY_AT_PATH_FILES)[number])
+  ) {
+    return 0;
+  }
+  if (DEPRIORITIZED_AT_PATH_NAMES.has(name)) {
+    return 3;
+  }
+  if (label.endsWith("/")) {
+    return 1;
+  }
+  return 2;
+}
+
+function sortAtPathSuggestions(items: AutocompleteItem[], rawPrefix: string): AutocompleteItem[] {
+  if (rawPrefix !== "") {
+    return items.sort((a, b) => {
+      const aIsDir = a.label.endsWith("/");
+      const bIsDir = b.label.endsWith("/");
+      if (aIsDir && !bIsDir) return -1;
+      if (!aIsDir && bIsDir) return 1;
+      return a.label.localeCompare(b.label);
+    });
+  }
+
+  return items.sort((a, b) => {
+    const rankDiff = atPathSuggestionRank(a.label) - atPathSuggestionRank(b.label);
+    if (rankDiff !== 0) return rankDiff;
+    return a.label.localeCompare(b.label);
+  });
+}
+
+/** `@` file attachment (not `@skill` / `@plan`). */
+export function isAtFileAttachmentPrefix(atPrefix: string | null): boolean {
+  if (!atPrefix) return false;
+  if (parseSkillMentionPrefix(atPrefix)) return false;
+  if (parsePlanMentionPrefix(atPrefix)) return false;
+  return atPrefix.startsWith("@");
+}
+
+/** List cwd-scoped entries for `@` / `@path` (Pi getFileSuggestions semantics). */
+export function getAtPathFileSuggestions(cwd: string, atPrefix: string): AutocompleteItem[] {
+  try {
+    const { rawPrefix, isAtPrefix, isQuotedPrefix } = parsePathPrefix(atPrefix);
+    if (!isAtPrefix) return [];
+
+    let searchDir: string;
+    let searchPrefix: string;
+    const expandedPrefix = rawPrefix;
+
+    const isRootPrefix =
+      rawPrefix === "" ||
+      rawPrefix === "./" ||
+      rawPrefix === "../" ||
+      rawPrefix === "/" ||
+      (isAtPrefix && rawPrefix === "");
+
+    if (isRootPrefix) {
+      searchDir = join(cwd, expandedPrefix);
+      searchPrefix = "";
+    } else if (rawPrefix.endsWith("/")) {
+      searchDir = join(cwd, expandedPrefix);
+      searchPrefix = "";
+    } else {
+      searchDir = join(cwd, dirname(expandedPrefix));
+      searchPrefix = basename(expandedPrefix);
+    }
+
+    const entries = readdirSync(searchDir, { withFileTypes: true });
+    const suggestions: AutocompleteItem[] = [];
+    const cwdLabel = toDisplayPath(relative(cwd, searchDir) || ".");
+
+    for (const entry of entries) {
+      if (!entry.name.toLowerCase().startsWith(searchPrefix.toLowerCase())) {
+        continue;
+      }
+
+      let isDirectory = entry.isDirectory();
+      if (!isDirectory && entry.isSymbolicLink()) {
+        try {
+          isDirectory = statSync(join(searchDir, entry.name)).isDirectory();
+        } catch {
+          // broken symlink — treat as file
+        }
+      }
+
+      let relativePath: string;
+      const displayPrefix = rawPrefix;
+      const name = entry.name;
+
+      if (displayPrefix.endsWith("/")) {
+        relativePath = displayPrefix + name;
+      } else if (displayPrefix.includes("/")) {
+        relativePath = join(dirname(displayPrefix), name);
+        if (displayPrefix.startsWith("./") && !relativePath.startsWith("./")) {
+          relativePath = `./${relativePath}`;
+        }
+      } else {
+        relativePath = name;
+      }
+
+      relativePath = toDisplayPath(relativePath);
+      const pathValue = isDirectory ? `${relativePath}/` : relativePath;
+      const value = buildCompletionValue(pathValue, { isAtPrefix, isQuotedPrefix });
+      const entryRelative = toDisplayPath(relative(cwd, join(searchDir, entry.name)));
+
+      suggestions.push({
+        value,
+        label: name + (isDirectory ? "/" : ""),
+        description:
+          searchDir === cwd && rawPrefix === "" ? entryRelative : `${cwdLabel}/${entryRelative}`,
+      });
+    }
+
+    return sortAtPathSuggestions(suggestions, rawPrefix);
+  } catch {
+    return [];
+  }
+}
+
+export function extractAtFilePrefix(textBeforeCursor: string): string | null {
+  const atPrefix = extractAtPrefix(textBeforeCursor);
+  return isAtFileAttachmentPrefix(atPrefix) ? atPrefix : null;
+}

package/bundled/skills/chat-mention-render.d.ts

@@ -0,0 +1,7 @@
+export type MentionChipTheme = {
+    fg: (role: string, text: string) => string;
+};
+export declare function renderLineWithMentionChips(line: string, theme: MentionChipTheme): string;
+export declare function logicalToVisibleCol(line: string, logicalCol: number): number;
+export declare function visibleToLogicalCol(line: string, visibleCol: number): number;
+//# sourceMappingURL=chat-mention-render.d.ts.map

package/bundled/skills/chat-mention-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-mention-render.d.ts","sourceRoot":"","sources":["../../src/skills/chat-mention-render.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAwIF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAIxF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAqB5E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAqB5E"}

package/bundled/skills/chat-mention-render.js

@@ -0,0 +1,160 @@
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { PLAN_MENTION_ALIASES } from "./chat-mentions.js";
+const SKILL_SLASH_RE = /\/skill:([a-z0-9_-]+)/gi;
+const AT_SKILL_RE = /@skill\s+([^\s@/]+)/gi;
+const PLAN_TOKEN_RE = /\/mode:plan\b/gi;
+const AT_PLAN_PATTERN = PLAN_MENTION_ALIASES.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
+    .sort((a, b) => b.length - a.length)
+    .join("|");
+const AT_PLAN_RE = new RegExp(`(?:^|[\\s"'=])(${AT_PLAN_PATTERN})(?=\\s|$)`, "gi");
+const PLAN_VISIBLE_LABEL = "@plan";
+function findNextMentionMatch(line, cursor) {
+    const candidates = [];
+    SKILL_SLASH_RE.lastIndex = cursor;
+    const slashMatch = SKILL_SLASH_RE.exec(line);
+    if (slashMatch?.index !== undefined) {
+        candidates.push({
+            index: slashMatch.index,
+            length: slashMatch[0].length,
+            span: { kind: "skill", name: slashMatch[1] ?? "", source: "slash" },
+        });
+    }
+    AT_SKILL_RE.lastIndex = cursor;
+    const atMatch = AT_SKILL_RE.exec(line);
+    if (atMatch?.index !== undefined) {
+        candidates.push({
+            index: atMatch.index,
+            length: atMatch[0].length,
+            span: { kind: "skill", name: atMatch[1] ?? "", source: "at" },
+        });
+    }
+    PLAN_TOKEN_RE.lastIndex = cursor;
+    const planMatch = PLAN_TOKEN_RE.exec(line);
+    if (planMatch?.index !== undefined) {
+        candidates.push({
+            index: planMatch.index,
+            length: planMatch[0].length,
+            span: { kind: "plan", logicalToken: planMatch[0] },
+        });
+    }
+    AT_PLAN_RE.lastIndex = cursor;
+    const atPlanMatch = AT_PLAN_RE.exec(line);
+    if (atPlanMatch?.index !== undefined) {
+        const token = atPlanMatch[1] ?? "@plan";
+        const leading = atPlanMatch[0].length - token.length;
+        const index = atPlanMatch.index + leading;
+        candidates.push({
+            index,
+            length: token.length,
+            span: { kind: "plan", logicalToken: token },
+        });
+    }
+    if (candidates.length === 0)
+        return null;
+    return candidates.reduce((earliest, candidate) => candidate.index < earliest.index ? candidate : earliest);
+}
+function parseMentionSpans(line) {
+    const spans = [];
+    let cursor = 0;
+    while (cursor < line.length) {
+        const nextMatch = findNextMentionMatch(line, cursor);
+        if (!nextMatch) {
+            spans.push({ kind: "text", value: line.slice(cursor) });
+            break;
+        }
+        if (nextMatch.index > cursor) {
+            spans.push({ kind: "text", value: line.slice(cursor, nextMatch.index) });
+        }
+        spans.push(nextMatch.span);
+        cursor = nextMatch.index + nextMatch.length;
+    }
+    if (spans.length === 0) {
+        spans.push({ kind: "text", value: line });
+    }
+    return spans;
+}
+function skillVisibleText(span) {
+    return span.source === "at" ? `@${span.name}` : span.name;
+}
+function skillLogicalText(span) {
+    return span.source === "at" ? `@skill ${span.name}` : `/skill:${span.name}`;
+}
+function renderSpan(span, theme) {
+    if (span.kind === "text")
+        return span.value;
+    if (span.kind === "skill") {
+        const text = skillVisibleText(span);
+        try {
+            return theme.fg("accent", text);
+        }
+        catch {
+            return theme.fg("text", text);
+        }
+    }
+    try {
+        return theme.fg("planAccent", PLAN_VISIBLE_LABEL);
+    }
+    catch {
+        return theme.fg("text", PLAN_VISIBLE_LABEL);
+    }
+}
+function spanLogicalWidth(span) {
+    if (span.kind === "text")
+        return span.value.length;
+    if (span.kind === "skill")
+        return skillLogicalText(span).length;
+    return span.logicalToken.length;
+}
+function spanVisibleText(span) {
+    if (span.kind === "text")
+        return span.value;
+    if (span.kind === "skill")
+        return skillVisibleText(span);
+    return PLAN_VISIBLE_LABEL;
+}
+export function renderLineWithMentionChips(line, theme) {
+    return parseMentionSpans(line)
+        .map((span) => renderSpan(span, theme))
+        .join("");
+}
+export function logicalToVisibleCol(line, logicalCol) {
+    const clamped = Math.max(0, Math.min(logicalCol, line.length));
+    let logical = 0;
+    let visible = 0;
+    for (const span of parseMentionSpans(line)) {
+        const logicalLen = spanLogicalWidth(span);
+        const visibleLen = visibleWidth(spanVisibleText(span));
+        if (logical + logicalLen >= clamped) {
+            const offset = clamped - logical;
+            if (span.kind === "text") {
+                return visible + offset;
+            }
+            const ratio = logicalLen > 0 ? offset / logicalLen : 0;
+            return visible + Math.round(visibleLen * ratio);
+        }
+        logical += logicalLen;
+        visible += visibleLen;
+    }
+    return visible;
+}
+export function visibleToLogicalCol(line, visibleCol) {
+    const clamped = Math.max(0, visibleCol);
+    let logical = 0;
+    let visible = 0;
+    for (const span of parseMentionSpans(line)) {
+        const logicalLen = spanLogicalWidth(span);
+        const visibleLen = visibleWidth(spanVisibleText(span));
+        if (visible + visibleLen >= clamped) {
+            const offset = clamped - visible;
+            if (span.kind === "text") {
+                return logical + offset;
+            }
+            const ratio = visibleLen > 0 ? offset / visibleLen : 0;
+            return logical + Math.round(logicalLen * ratio);
+        }
+        logical += logicalLen;
+        visible += visibleLen;
+    }
+    return line.length;
+}
+//# sourceMappingURL=chat-mention-render.js.map

package/bundled/skills/chat-mention-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-mention-render.js","sourceRoot":"","sources":["../../src/skills/chat-mention-render.ts"],"names":[],"mappings":"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"}

package/bundled/skills/chat-mention-render.test.ts

@@ -0,0 +1,70 @@
+import { describe, expect, it, vi } from "vitest";
+import {
+  logicalToVisibleCol,
+  renderLineWithMentionChips,
+  visibleToLogicalCol,
+} from "./chat-mention-render.js";
+
+function mockTheme() {
+  return {
+    fg: vi.fn((role: string, text: string) => `[${role}]${text}[/]`),
+  };
+}
+
+describe("chat-mention-render", () => {
+  it("renders skill names with accent token", () => {
+    const theme = mockTheme();
+    renderLineWithMentionChips("/skill:naus-pipelines validate", theme);
+    expect(theme.fg).toHaveBeenCalledWith("accent", "naus-pipelines");
+  });
+
+  it("renders plan chip with planAccent token", () => {
+    const theme = mockTheme();
+    renderLineWithMentionChips("/mode:plan scope", theme);
+    expect(theme.fg).toHaveBeenCalledWith("planAccent", "@plan");
+  });
+
+  it("renders @plan and @planejar as @plan chip", () => {
+    const theme = mockTheme();
+    renderLineWithMentionChips("@plan scope", theme);
+    expect(theme.fg).toHaveBeenCalledWith("planAccent", "@plan");
+    theme.fg.mockClear();
+    renderLineWithMentionChips("@planejar scope", theme);
+    expect(theme.fg).toHaveBeenCalledWith("planAccent", "@plan");
+  });
+
+  it("leaves lines without tokens unchanged", () => {
+    const theme = mockTheme();
+    expect(renderLineWithMentionChips("hello world", theme)).toBe("hello world");
+    expect(theme.fg).not.toHaveBeenCalled();
+  });
+
+  it("maps logical cursor columns through chip width delta", () => {
+    const line = "/skill:remediation apply fix";
+    const afterSkill = logicalToVisibleCol(line, "/skill:remediation".length);
+    expect(afterSkill).toBe("remediation".length);
+    const roundTrip = visibleToLogicalCol(line, afterSkill);
+    expect(roundTrip).toBe("/skill:remediation".length);
+  });
+
+  it("handles multiple skill chips", () => {
+    const theme = mockTheme();
+    renderLineWithMentionChips("/skill:a then /skill:b", theme);
+    expect(theme.fg).toHaveBeenCalledWith("accent", "a");
+    expect(theme.fg).toHaveBeenCalledWith("accent", "b");
+  });
+
+  it("renders @skill name as @name accent chip in the editor", () => {
+    const theme = mockTheme();
+    renderLineWithMentionChips("@skill aspm-platform validate", theme);
+    expect(theme.fg).toHaveBeenCalledWith("accent", "@aspm-platform");
+  });
+
+  it("maps logical cursor columns for @skill mentions", () => {
+    const line = "@skill aspm-platform apply fix";
+    const afterMention = logicalToVisibleCol(line, "@skill aspm-platform".length);
+    expect(afterMention).toBe("@aspm-platform".length);
+    const roundTrip = visibleToLogicalCol(line, afterMention);
+    expect(roundTrip).toBe("@skill aspm-platform".length);
+  });
+});

package/bundled/skills/chat-mention-render.ts

@@ -0,0 +1,192 @@
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { PLAN_MENTION_ALIASES } from "./chat-mentions.js";
+
+export type MentionChipTheme = {
+  fg: (role: string, text: string) => string;
+};
+
+type MentionSpan =
+  | { kind: "text"; value: string }
+  | { kind: "skill"; name: string; source: "slash" | "at" }
+  | { kind: "plan"; logicalToken: string };
+
+const SKILL_SLASH_RE = /\/skill:([a-z0-9_-]+)/gi;
+const AT_SKILL_RE = /@skill\s+([^\s@/]+)/gi;
+const PLAN_TOKEN_RE = /\/mode:plan\b/gi;
+
+const AT_PLAN_PATTERN = PLAN_MENTION_ALIASES.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
+  .sort((a, b) => b.length - a.length)
+  .join("|");
+const AT_PLAN_RE = new RegExp(`(?:^|[\\s"'=])(${AT_PLAN_PATTERN})(?=\\s|$)`, "gi");
+
+const PLAN_VISIBLE_LABEL = "@plan";
+
+function findNextMentionMatch(
+  line: string,
+  cursor: number,
+): { index: number; length: number; span: MentionSpan } | null {
+  const candidates: Array<{ index: number; length: number; span: MentionSpan }> = [];
+
+  SKILL_SLASH_RE.lastIndex = cursor;
+  const slashMatch = SKILL_SLASH_RE.exec(line);
+  if (slashMatch?.index !== undefined) {
+    candidates.push({
+      index: slashMatch.index,
+      length: slashMatch[0].length,
+      span: { kind: "skill", name: slashMatch[1] ?? "", source: "slash" },
+    });
+  }
+
+  AT_SKILL_RE.lastIndex = cursor;
+  const atMatch = AT_SKILL_RE.exec(line);
+  if (atMatch?.index !== undefined) {
+    candidates.push({
+      index: atMatch.index,
+      length: atMatch[0].length,
+      span: { kind: "skill", name: atMatch[1] ?? "", source: "at" },
+    });
+  }
+
+  PLAN_TOKEN_RE.lastIndex = cursor;
+  const planMatch = PLAN_TOKEN_RE.exec(line);
+  if (planMatch?.index !== undefined) {
+    candidates.push({
+      index: planMatch.index,
+      length: planMatch[0].length,
+      span: { kind: "plan", logicalToken: planMatch[0] },
+    });
+  }
+
+  AT_PLAN_RE.lastIndex = cursor;
+  const atPlanMatch = AT_PLAN_RE.exec(line);
+  if (atPlanMatch?.index !== undefined) {
+    const token = atPlanMatch[1] ?? "@plan";
+    const leading = atPlanMatch[0].length - token.length;
+    const index = atPlanMatch.index + leading;
+    candidates.push({
+      index,
+      length: token.length,
+      span: { kind: "plan", logicalToken: token },
+    });
+  }
+
+  if (candidates.length === 0) return null;
+  return candidates.reduce((earliest, candidate) =>
+    candidate.index < earliest.index ? candidate : earliest,
+  );
+}
+
+function parseMentionSpans(line: string): MentionSpan[] {
+  const spans: MentionSpan[] = [];
+  let cursor = 0;
+
+  while (cursor < line.length) {
+    const nextMatch = findNextMentionMatch(line, cursor);
+
+    if (!nextMatch) {
+      spans.push({ kind: "text", value: line.slice(cursor) });
+      break;
+    }
+
+    if (nextMatch.index > cursor) {
+      spans.push({ kind: "text", value: line.slice(cursor, nextMatch.index) });
+    }
+    spans.push(nextMatch.span);
+    cursor = nextMatch.index + nextMatch.length;
+  }
+
+  if (spans.length === 0) {
+    spans.push({ kind: "text", value: line });
+  }
+
+  return spans;
+}
+
+function skillVisibleText(span: Extract<MentionSpan, { kind: "skill" }>): string {
+  return span.source === "at" ? `@${span.name}` : span.name;
+}
+
+function skillLogicalText(span: Extract<MentionSpan, { kind: "skill" }>): string {
+  return span.source === "at" ? `@skill ${span.name}` : `/skill:${span.name}`;
+}
+
+function renderSpan(span: MentionSpan, theme: MentionChipTheme): string {
+  if (span.kind === "text") return span.value;
+  if (span.kind === "skill") {
+    const text = skillVisibleText(span);
+    try {
+      return theme.fg("accent", text);
+    } catch {
+      return theme.fg("text", text);
+    }
+  }
+  try {
+    return theme.fg("planAccent", PLAN_VISIBLE_LABEL);
+  } catch {
+    return theme.fg("text", PLAN_VISIBLE_LABEL);
+  }
+}
+
+function spanLogicalWidth(span: MentionSpan): number {
+  if (span.kind === "text") return span.value.length;
+  if (span.kind === "skill") return skillLogicalText(span).length;
+  return span.logicalToken.length;
+}
+
+function spanVisibleText(span: MentionSpan): string {
+  if (span.kind === "text") return span.value;
+  if (span.kind === "skill") return skillVisibleText(span);
+  return PLAN_VISIBLE_LABEL;
+}
+
+export function renderLineWithMentionChips(line: string, theme: MentionChipTheme): string {
+  return parseMentionSpans(line)
+    .map((span) => renderSpan(span, theme))
+    .join("");
+}
+
+export function logicalToVisibleCol(line: string, logicalCol: number): number {
+  const clamped = Math.max(0, Math.min(logicalCol, line.length));
+  let logical = 0;
+  let visible = 0;
+
+  for (const span of parseMentionSpans(line)) {
+    const logicalLen = spanLogicalWidth(span);
+    const visibleLen = visibleWidth(spanVisibleText(span));
+    if (logical + logicalLen >= clamped) {
+      const offset = clamped - logical;
+      if (span.kind === "text") {
+        return visible + offset;
+      }
+      const ratio = logicalLen > 0 ? offset / logicalLen : 0;
+      return visible + Math.round(visibleLen * ratio);
+    }
+    logical += logicalLen;
+    visible += visibleLen;
+  }
+
+  return visible;
+}
+
+export function visibleToLogicalCol(line: string, visibleCol: number): number {
+  const clamped = Math.max(0, visibleCol);
+  let logical = 0;
+  let visible = 0;
+
+  for (const span of parseMentionSpans(line)) {
+    const logicalLen = spanLogicalWidth(span);
+    const visibleLen = visibleWidth(spanVisibleText(span));
+    if (visible + visibleLen >= clamped) {
+      const offset = clamped - visible;
+      if (span.kind === "text") {
+        return logical + offset;
+      }
+      const ratio = visibleLen > 0 ? offset / visibleLen : 0;
+      return logical + Math.round(logicalLen * ratio);
+    }
+    logical += logicalLen;
+    visible += visibleLen;
+  }
+
+  return line.length;
+}

package/bundled/skills/chat-mentions.d.ts

@@ -0,0 +1,28 @@
+import type { AutocompleteItem } from "@earendil-works/pi-tui";
+import type { KubbisecSkillEntry } from "./list-bundled-skills.js";
+export declare const SKILL_MENTION_TOKEN = "@skill";
+export declare const PLAN_MENTION_ALIASES: readonly ["@plan", "@planejar"];
+/** Same token rules as Pi CombinedAutocompleteProvider.extractAtPrefix. */
+export declare function extractAtPrefix(textBeforeCursor: string): string | null;
+/** KubbiSec: `@skill` may include a space and partial name (not only the last @ token). */
+export declare function extractSkillMentionPrefix(textBeforeCursor: string): string | null;
+export declare function parseSkillMentionPrefix(atPrefix: string | null): {
+    query: string;
+} | null;
+export declare function parsePlanMentionPrefix(atPrefix: string | null): {
+    query: string;
+} | null;
+export declare function filterSkillSuggestions(skills: KubbisecSkillEntry[], query: string): AutocompleteItem[];
+/** Pi expands `/skill:name` — map `@skill name` before submit. */
+export declare function transformAtSkillMentions(text: string): string;
+/** Legacy: map `@plan` / `@planejar` to `/mode:plan` (prefer session state + visible @plan). */
+export declare function transformAtPlanMentions(text: string): string;
+/** Apply @skill → /skill:name only. @plan stays visible; plan mode is set via session state. */
+export declare function transformChatMentions(text: string): string;
+export declare function messageActivatesPlanMode(text: string): boolean;
+export declare function applySkillMentionCompletion(lines: string[], cursorLine: number, cursorCol: number, item: AutocompleteItem, prefix: string): {
+    lines: string[];
+    cursorLine: number;
+    cursorCol: number;
+};
+//# sourceMappingURL=chat-mentions.d.ts.map

package/bundled/skills/chat-mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-mentions.d.ts","sourceRoot":"","sources":["../../src/skills/chat-mentions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,eAAO,MAAM,oBAAoB,iCAAkC,CAAC;AAiBpE,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvE;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKzF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxF;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAAE,EAC5B,KAAK,EAAE,MAAM,GACZ,gBAAgB,EAAE,CAcpB;AAED,kEAAkE;AAClE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,gGAAgG;AAChG,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK9D;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAe5D"}