@selesai/code 0.5.12 → 0.5.14

package/dist/extensions/pi-powerline-footer/welcome.ts

@@ -3,8 +3,9 @@ import { join, basename } from "node:path";
 import { homedir as osHomedir } from "node:os";
 import { CONFIG_DIR_NAME, getAgentDir, getSettingsPath } from "@selesai/code";
 import type { Component } from "@earendil-works/pi-tui";
-import { truncateToWidth as tuiTruncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { truncateToWidth as tuiTruncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import { ansi, fgOnly, getFgAnsiCode } from "./colors.ts";
+import { GUIDE_COMPACT_LINES, GUIDE_DISMISS_HINT, getGuideFeatureLines, type GuideFeature, type GuideMode } from "./guide.ts";
 
 export interface RecentSession {
   name: string;
@@ -82,11 +83,20 @@ function fitToWidth(str: string, width: number): string {
   return str + " ".repeat(width - visLen);
 }
 
+function wrapLines(lines: string[], width: number): string[] {
+  const continuation = "  ";
+  const contentWidth = Math.max(1, width - continuation.length);
+  return lines.flatMap((line) => wrapTextWithAnsi(line, contentWidth)
+    .map((wrapped, index) => index === 0 ? wrapped : continuation + wrapped));
+}
+
 interface WelcomeData {
   modelName: string;
   providerName: string;
   recentSessions: RecentSession[];
   loadedCounts: LoadedCounts;
+  guideMode: GuideMode;
+  newFeatures: GuideFeature[];
 }
 
 function buildLeftColumn(data: WelcomeData, colWidth: number): string[] {
@@ -107,6 +117,27 @@ function buildRightColumn(data: WelcomeData, colWidth: number): string[] {
   const hChar = "─";
   const separator = ` ${dim(hChar.repeat(colWidth - 2))}`;
 
+  const guideLines = data.guideMode === "compact"
+    ? [
+      ` ${bold(fgOnly("accent", "Guide"))}`,
+      ...(data.newFeatures.length > 0
+        ? [` ${bold(fgOnly("model", `New: ${data.newFeatures.slice(0, 2).map((feature) => feature.title).join(" · ")}`))}`]
+        : []),
+      ...GUIDE_COMPACT_LINES.map((line) => ` ${dim(line)}`),
+    ]
+    : [
+      ` ${bold(fgOnly("accent", "Selesai guide"))}`,
+      ...(data.newFeatures.length > 0
+        ? [
+          ` ${bold(fgOnly("model", "New since your last guide"))}`,
+          ...data.newFeatures.slice(0, 3).map((feature) => ` ${dim("• ")}${feature.title}`),
+        ]
+        : []),
+      ...getGuideFeatureLines().map((line) => line.kind === "section"
+        ? ` ${bold(fgOnly("accent", line.text))}`
+        : ` ${dim("• ")}${line.feature.title}: ${dim(line.feature.example)}`),
+    ];
+
   // Session lines
   const sessionLines: string[] = [];
   if (data.recentSessions.length === 0) {
@@ -141,17 +172,23 @@ function buildRightColumn(data: WelcomeData, colWidth: number): string[] {
     countLines.push(` ${dim("No extensions loaded")}`);
   }
 
+  const dashboardLines = data.guideMode === "full"
+    ? []
+    : [
+      separator,
+      ` ${bold(fgOnly("accent", "Loaded"))}`,
+      ...countLines,
+      separator,
+      ` ${bold(fgOnly("accent", "Recent sessions"))}`,
+      ...sessionLines,
+    ];
+
   return [
-    ` ${bold(fgOnly("accent", "Tips"))}`,
-    ` ${dim("/")} for commands`,
-    ` ${dim("!")} to run bash`,
+    ` ${bold(fgOnly("accent", "Tips"))}: ${dim("/")} commands · ${dim("/settings")} configure`,
     ` ${dim("Shift+Tab")} cycle thinking`,
     separator,
-    ` ${bold(fgOnly("accent", "Loaded"))}`,
-    ...countLines,
-    separator,
-    ` ${bold(fgOnly("accent", "Recent sessions"))}`,
-    ...sessionLines,
+    ...guideLines,
+    ...dashboardLines,
     "",
   ];
 }
@@ -170,8 +207,8 @@ function renderWelcomeBox(
   }
 
   const minWidth = 76;
-  const maxWidth = 96;
-  // Clamp to termWidth to prevent crash on narrow terminals
+  const maxWidth = data.guideMode === "full" ? 132 : 96;
+  // Clamp to termWidth to prevent crash on narrow terminals.
   const boxWidth = Math.min(termWidth, Math.max(minWidth, Math.min(termWidth - 2, maxWidth)));
   const leftCol = 26;
   const rightCol = Math.max(1, boxWidth - leftCol - 3); // Ensure rightCol is at least 1
@@ -184,7 +221,7 @@ function renderWelcomeBox(
   const br = dim("╯");
 
   const leftLines = buildLeftColumn(data, leftCol);
-  const rightLines = buildRightColumn(data, rightCol);
+  const rightLines = wrapLines(buildRightColumn(data, rightCol), rightCol);
 
   const lines: string[] = [];
 
@@ -221,19 +258,16 @@ function renderWelcomeBox(
  */
 export class WelcomeComponent implements Component {
   private data: WelcomeData;
-  private countdown: number = 30;
 
   constructor(
     modelName: string,
     providerName: string,
     recentSessions: RecentSession[] = [],
     loadedCounts: LoadedCounts = { contextFiles: 0, extensions: 0, skills: 0, promptTemplates: 0 },
+    guideMode: GuideMode = "full",
+    newFeatures: GuideFeature[] = [],
   ) {
-    this.data = { modelName, providerName, recentSessions, loadedCounts };
-  }
-
-  setCountdown(seconds: number): void {
-    this.countdown = seconds;
+    this.data = { modelName, providerName, recentSessions, loadedCounts, guideMode, newFeatures };
   }
 
   invalidate(): void {}
@@ -246,20 +280,20 @@ export class WelcomeComponent implements Component {
     }
 
     const minWidth = 76;
-    const maxWidth = 96;
-    // Clamp to termWidth to prevent crash on narrow terminals
+    const maxWidth = 132;
+    // Clamp to termWidth to prevent crash on narrow terminals.
     const boxWidth = Math.min(termWidth, Math.max(minWidth, Math.min(termWidth - 2, maxWidth)));
 
-    // Bottom line with countdown
-    const countdownText = ` Press any key to continue (${this.countdown}s) `;
-    const countdownStyled = dim(countdownText);
+    // The guide is intentionally blocking: no timer or implicit dismissal.
+    const promptText = ` ${GUIDE_DISMISS_HINT} `;
+    const promptStyled = dim(promptText);
     const bottomContentWidth = boxWidth - 2;
-    const countdownVisLen = visibleWidth(countdownText);
-    const leftPad = Math.floor((bottomContentWidth - countdownVisLen) / 2);
-    const rightPad = bottomContentWidth - countdownVisLen - leftPad;
+    const promptVisLen = visibleWidth(promptText);
+    const leftPad = Math.floor((bottomContentWidth - promptVisLen) / 2);
+    const rightPad = bottomContentWidth - promptVisLen - leftPad;
     const hChar = "─";
     const bottomLine = dim(hChar.repeat(Math.max(0, leftPad))) +
-      countdownStyled +
+      promptStyled +
       dim(hChar.repeat(Math.max(0, rightPad)));
 
     return renderWelcomeBox(this.data, termWidth, bottomLine);
@@ -267,8 +301,7 @@ export class WelcomeComponent implements Component {
 }
 
 /**
- * Welcome header - same layout as overlay but persistent (no countdown).
- * Used when quietStartup: true.
+ * Compact guide header used when the user selects `/guide compact`.
  */
 export class WelcomeHeader implements Component {
   private data: WelcomeData;
@@ -278,8 +311,10 @@ export class WelcomeHeader implements Component {
     providerName: string,
     recentSessions: RecentSession[] = [],
     loadedCounts: LoadedCounts = { contextFiles: 0, extensions: 0, skills: 0, promptTemplates: 0 },
+    guideMode: GuideMode = "compact",
+    newFeatures: GuideFeature[] = [],
   ) {
-    this.data = { modelName, providerName, recentSessions, loadedCounts };
+    this.data = { modelName, providerName, recentSessions, loadedCounts, guideMode, newFeatures };
   }
 
   invalidate(): void {}

package/dist/extensions/ponytail/index.js

@@ -184,6 +184,6 @@ export default function ponytailExtension(pi) {
 
   pi.on("before_agent_start", async (event) => {
     if (!currentMode || currentMode === "off") return;
-    return { systemPrompt: `${event.systemPrompt}\n\n${getPonytailInstructions(currentMode)}` };
+    return { systemPrompt: `${event.systemPrompt}\n\n${getPonytailInstructions(currentMode, { compact: true })}` };
   });
 }

package/dist/extensions/ponytail/ponytail-instructions.cjs

@@ -7,6 +7,11 @@ const { DEFAULT_MODE, normalizeMode, normalizePersistedMode } = require('./ponyt
 
 const INDEPENDENT_MODES = new Set(['review']);
 const SKILL_PATH = path.join(__dirname, '..', '..', 'skills', 'ponytail', 'SKILL.md');
+const COMPACT_MODE_RULES = {
+  lite: 'Build the ask; name a lazier alternative.',
+  full: 'Enforce ladder; shortest diff.',
+  ultra: 'YAGNI first; delete; challenge the rest.',
+};
 
 function filterSkillBodyForMode(body, mode) {
   const effectiveMode = normalizeMode(mode) || DEFAULT_MODE;
@@ -70,7 +75,15 @@ function getFallbackInstructions(mode) {
     'Ponytail governs what you build, not how you talk. "stop ponytail" or "normal mode": revert. Level persists until changed or session end.';
 }
 
-function getPonytailInstructions(mode) {
+function getCompactInstructions(mode) {
+  return 'PONYTAIL ' + mode.toUpperCase() + ': persistent every response; off only "stop ponytail"/"normal mode". ' +
+    'Trace first. Ladder: YAGNI -> reuse -> stdlib/native -> installed deps -> minimum diff. ' +
+    'Fix root cause, not caller symptom. No unrequested abstractions/deps/boilerplate; delete first. ' +
+    'Preserve validation, data-loss handling, security, accessibility, explicit asks. ' +
+    'Non-trivial logic: one runnable check. Code first; <=3 lines. ' + COMPACT_MODE_RULES[mode];
+}
+
+function getPonytailInstructions(mode, options) {
   const configuredMode = normalizePersistedMode(mode) || DEFAULT_MODE;
 
   if (INDEPENDENT_MODES.has(configuredMode)) {
@@ -78,6 +91,7 @@ function getPonytailInstructions(mode) {
   }
 
   const effectiveMode = normalizeMode(configuredMode) || DEFAULT_MODE;
+  if (options?.compact === true) return getCompactInstructions(effectiveMode);
 
   try {
     return 'PONYTAIL MODE ACTIVE — level: ' + effectiveMode + '\n\n' +

package/dist/extensions/ponytail/test/extension.test.js

@@ -73,8 +73,8 @@ test("/ponytail updates session mode and injects instructions", async () => with
   });
 
   const result = await events.get("before_agent_start")({ systemPrompt: "BASE" }, ctx);
-  assert.ok(result.systemPrompt.includes("PONYTAIL MODE ACTIVE"));
-  assert.ok(result.systemPrompt.includes("ultra"));
+  assert.match(result.systemPrompt, /^BASE\n\nPONYTAIL ULTRA:/);
+  assert.ok(result.systemPrompt.length - "BASE\n\n".length <= 450);
 }));
 
 test("session_start restores latest persisted mode", async () => withTempConfig(async () => {
@@ -90,7 +90,23 @@ test("session_start restores latest persisted mode", async () => withTempConfig(
   await events.get("session_start")({ reason: "resume" }, ctx);
   const result = await events.get("before_agent_start")({ systemPrompt: "BASE" }, ctx);
 
-  assert.ok(result.systemPrompt.includes("lite"));
+  assert.match(result.systemPrompt, /PONYTAIL LITE:/);
+}));
+
+test("review mode retains its independent skill prompt", async () => withTempConfig(async () => {
+  const { events } = createPiHarness();
+  const ctx = createCommandContext({
+    sessionManager: {
+      getEntries: () => [
+        { type: "custom", customType: "ponytail-mode", data: { mode: "review" } },
+      ],
+    },
+  });
+
+  await events.get("session_start")({ reason: "resume" }, ctx);
+  const result = await events.get("before_agent_start")({ systemPrompt: "BASE" }, ctx);
+
+  assert.equal(result.systemPrompt, "BASE\n\nPONYTAIL MODE ACTIVE — level: review. Behavior defined by /ponytail-review skill.");
 }));
 
 test("skill alias commands delegate to Pi skill commands", async () => {
@@ -133,7 +149,7 @@ test("a request mentioning normal mode stays active", async () => withTempConfig
   await events.get("input")({ text: "add a normal mode toggle next to dark mode", source: "interactive" }, ctx);
 
   const result = await events.get("before_agent_start")({ systemPrompt: "BASE" }, ctx);
-  assert.match(result.systemPrompt, /PONYTAIL MODE ACTIVE/);
+  assert.match(result.systemPrompt, /PONYTAIL ULTRA:/);
 }));
 
 test("status bar renders the mode and flips active on agent_start", async () => withTempConfig(async () => {

package/dist/extensions/ponytail/test/helpers.test.js

@@ -2,8 +2,12 @@ import assert from "node:assert/strict";
 import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { createRequire } from "node:module";
 import test from "node:test";
 
+const require = createRequire(import.meta.url);
+const { getPonytailInstructions } = require("../ponytail-instructions.cjs");
+
 import {
   filterSkillBodyForMode,
   parsePonytailCommand,
@@ -74,6 +78,34 @@ test("filterSkillBodyForMode keeps only requested intensity examples and rows",
   assert.ok(filtered.includes("Other line"));
 });
 
+test("compact Ponytail instructions retain core rules and mode distinctions", () => {
+  const compact = Object.fromEntries(
+    ["lite", "full", "ultra"].map((mode) => [mode, getPonytailInstructions(mode, { compact: true })]),
+  );
+
+  for (const [mode, instructions] of Object.entries(compact)) {
+    assert.match(instructions, new RegExp(`^PONYTAIL ${mode.toUpperCase()}:`));
+    assert.ok(instructions.length >= 300 && instructions.length <= 450, `${mode}: ${instructions.length} characters`);
+    for (const phrase of ["stop ponytail", "Trace first", "root cause", "validation", "data-loss", "security", "accessibility", "runnable check"]) {
+      assert.ok(instructions.includes(phrase), `${mode} lacks ${phrase}`);
+    }
+  }
+
+  assert.match(compact.lite, /Build the ask; name a lazier alternative/);
+  assert.match(compact.full, /Enforce ladder; shortest diff/);
+  assert.match(compact.ultra, /YAGNI first; delete; challenge the rest/);
+
+  const fullSkill = getPonytailInstructions("full");
+  assert.match(fullSkill, /## The ladder/);
+  assert.ok(fullSkill.length > compact.full.length);
+});
+
+test("review instructions remain independent in compact mode", () => {
+  const expected = "PONYTAIL MODE ACTIVE — level: review. Behavior defined by /ponytail-review skill.";
+  assert.equal(getPonytailInstructions("review"), expected);
+  assert.equal(getPonytailInstructions("review", { compact: true }), expected);
+});
+
 test("filterSkillBodyForMode keeps rule bullets that contain a colon", () => {
   // Regression: rule bullets outside the Intensity section (e.g. the
   // "No unrequested abstractions:" rule or the `ponytail:` comment convention)

package/dist/extensions/workflow/adapter.ts

@@ -472,11 +472,6 @@ function registerSharedArtifactWriter(pi: ExtensionAPI): void {
     name: WORKFLOW_ARTIFACT_TOOL,
     label: "Write Workflow Artifact",
     description: "Write the current workflow phase artifact. The workflow enforces the destination path; provide content only.",
-    promptSnippet: `${WORKFLOW_ARTIFACT_TOOL}(content) - write the active workflow artifact; path is chosen by the workflow, not the agent.`,
-    promptGuidelines: [
-      `During any workflow, use ${WORKFLOW_ARTIFACT_TOOL} instead of write/edit for workflow artifacts.`,
-      "Provide artifact content only; do not provide a path.",
-    ],
     parameters: Type.Object({
       content: Type.String({ description: "Artifact markdown/text content to save." }),
     }),
@@ -571,11 +566,6 @@ export function createWorkflowExtension(
       name: start,
       label: options.toolLabels.start,
       description: `Start the ${mode} workflow for the given goal. Sets up ${config.phases[0]} as the first phase and returns its prompt. Do not call if a workflow is already active.`,
-      promptSnippet: `${start}(goal) - start the ${mode} workflow; goal is what the user wants to build.`,
-      promptGuidelines: [
-        `Call ${start} only when the user explicitly asks to start a ${mode} workflow and none is active.`,
-        "Pass the user's full goal as the goal parameter.",
-      ],
       parameters: Type.Object({
         goal: Type.String({
           description: `What the user wants the ${mode} workflow to build or accomplish.`,
@@ -650,11 +640,6 @@ export function createWorkflowExtension(
       name: resume,
       label: options.toolLabels.resume,
       description: `Resume an explicitly selected ${mode} workflow run. Pass a run id, artifact directory, or workflow.json path.`,
-      promptSnippet: `${resume}(run) - resume an explicit ${mode} workflow run; run is its id, artifact directory, or workflow.json path.`,
-      promptGuidelines: [
-        `Call ${resume} only when the user explicitly selects a ${mode} workflow run.`,
-        "Workflow runs never resume automatically after reload.",
-      ],
       parameters: Type.Object({ run: Type.String({ description: "Run id, artifact directory, or workflow.json path." }) }),
       async execute(_id, params, _signal, _onUpdate, ctx) {
         return resumeController(controller, ctx, params.run, end);
@@ -671,10 +656,6 @@ export function createWorkflowExtension(
       name: end,
       label: options.toolLabels.end,
       description: `Close the ${mode} workflow. Must be called when the final phase is complete. Marks the workflow finished and stops the agent loop.`,
-      promptSnippet: `${end}() - close the finished ${mode} workflow; no further phase transitions allowed.`,
-      promptGuidelines: [
-        `Call ${end} exactly once, from the terminal phase, when all close artifacts are complete.`,
-      ],
       parameters: Type.Object({}),
       async execute(_id, _params, _signal, _onUpdate, ctx) {
         const before = checkpoint(controller);

package/dist/skills/caveman/SKILL.md

@@ -5,6 +5,7 @@ description: >
   filler, articles, and pleasantries while keeping full technical accuracy.
   Use when user says "caveman mode", "talk like caveman", "use caveman",
   "less tokens", "be brief", or invokes /caveman.
+disable-model-invocation: true
 ---
 
 Respond terse like smart caveman. All technical substance stay. Only fluff die.

package/dist/skills/handoff/SKILL.md

@@ -2,6 +2,7 @@
 name: handoff
 description: Compact the current conversation into a handoff document for another agent to pick up.
 argument-hint: "What will the next session be used for?"
+disable-model-invocation: true
 ---
 
 Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace.

package/dist/skills/handoff-text/SKILL.md

@@ -2,6 +2,7 @@
 name: handoff-text
 description: Compact the current conversation into a handoff document for another agent to pick up.
 argument-hint: "What will the next session be used for?"
+disable-model-invocation: true
 ---
 
 Write a handoff document summarising the current conversation so a fresh agent can continue the work. Dont save the handoff, output only.

package/dist/skills/implanger/SKILL.md

@@ -2,6 +2,7 @@
 name: implanger
 description: Execute the Planger's style planning
 argument-hint: "For Subagent to be able to understand Planger and can execute it perfectly"
+disable-model-invocation: true
 ---
 
 ## Goal

package/dist/skills/improve-codebase/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: improve-codebase
 description: improve codebase quality
+disable-model-invocation: true
 ---
 
 # Improve Codebase Architecture

package/dist/skills/planger/SKILL.md

@@ -2,6 +2,7 @@
 name: planger
 description: Create decomposed planning for sub agent
 argument-hint: "How i provide a good plan for subagent"
+disable-model-invocation: true
 ---
 
 # Planning Skill

package/dist/skills/ponytail/SKILL.md

@@ -12,6 +12,7 @@ description: >
   dependencies.
 argument-hint: "[lite|full|ultra]"
 license: MIT
+disable-model-invocation: true
 ---
 
 # Ponytail

package/dist/skills/ponytail-audit/SKILL.md

@@ -7,6 +7,7 @@ description: >
   codebase", "audit for over-engineering", "what can I delete from this repo",
   "find bloat", "ponytail-audit", or "/ponytail-audit". One-shot report, does
   not apply fixes.
+disable-model-invocation: true
 ---
 
 ponytail-review, repo-wide. Scan the whole tree instead of a diff. Rank

package/dist/skills/ponytail-debt/SKILL.md

@@ -6,6 +6,7 @@ description: >
   of rotting into "later means never". Use when the user says "ponytail debt",
   "/ponytail-debt", "what did ponytail defer", "list the shortcuts", "ponytail
   ledger", or "what did we mark to do later". One-shot report, changes nothing.
+disable-model-invocation: true
 ---
 
 Every deliberate ponytail shortcut is marked with a `ponytail:` comment naming

package/dist/skills/ponytail-gain/SKILL.md

@@ -6,6 +6,7 @@ description: >
   persistent mode, and not a per-repo number. Trigger: /ponytail-gain,
   "ponytail gain", "what does ponytail save", "show ponytail impact",
   "ponytail scoreboard".
+disable-model-invocation: true
 ---
 
 # Ponytail Gain

package/dist/skills/ponytail-help/SKILL.md

@@ -4,6 +4,7 @@ description: >
   Quick-reference card for all ponytail modes, skills, and commands.
   One-shot display, not a persistent mode. Trigger: /ponytail-help,
   "ponytail help", "what ponytail commands", "how do I use ponytail".
+disable-model-invocation: true
 ---
 
 # Ponytail Help

package/dist/skills/ponytail-review/SKILL.md

@@ -8,6 +8,7 @@ description: >
   delete", "is this over-engineered", "simplify review", or invokes
   /ponytail-review. Complements correctness-focused review, this one only
   hunts complexity.
+disable-model-invocation: true
 ---
 
 Review diffs for unnecessary complexity. One line per finding: location, what

package/dist/skills/workflow-creation/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: workflow-creation
 description: Creates durable Selesai workflow modes. Use when a user asks to create or change a workflow mode, phased agent flow, or slash-command workflow.
+disable-model-invocation: true
 ---
 
 # Durable Workflows

package/package.json

@@ -1,8 +1,28 @@
 {
 	"name": "@selesai/code",
-	"version": "0.5.12",
-	"description": "Selesai coding agent",
+	"version": "0.5.14",
+	"description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
 	"type": "module",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/SelesaiInTech/selesai-code.git"
+	},
+	"homepage": "https://github.com/SelesaiInTech/selesai-code#readme",
+	"bugs": {
+		"url": "https://github.com/SelesaiInTech/selesai-code/issues"
+	},
+	"keywords": [
+		"pi-package",
+		"coding-agent",
+		"ai-agent",
+		"terminal",
+		"typescript",
+		"llm",
+		"subagents",
+		"workflow",
+		"web-research",
+		"tui"
+	],
 	"piConfig": {
 		"name": "selesai",
 		"configDir": ".selesai"
@@ -22,6 +42,7 @@
 		}
 	},
 	"files": [
+		"README.md",
 		"dist",
 		"docs",
 		"examples",