@thenavidm/slipway 0.1.15 → 0.1.16

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 What changed in Slipway, newest first.
 
+## 0.1.16, 2026-10-05: what Flodesk needed
+
+- **`which` says a title once.** Each answer line printed a tool's title and then the first sentence of its description, and many descriptions open with the title itself: 24 of Flodesk's 32 tools, 10 of Firefly's 14, and nearly every tool on Beehiiv, Calendly and Circle. Where the sentence opens with the title's words, the line now prints the sentence alone. Flodesk's answer to `which add a subscriber to a segment` goes from 52 tokens to 36 and Firefly's to `which image model 5` from 90 to 77, and an agent carries that answer through each step after it. A description that adds something new still follows its title.
+
 ## 0.1.15, 2026-10-05: what Adobe Firefly needed
 
 - **The general help counts the tuning settings instead of naming them.** An agent reads `--help` first and carries it through every later step, so its length is paid again on each one. Firefly's help named 14 settings on its last line, and with only 14 commands its whole command list was shorter; its Codex CLI task cost 370 more input tokens on Slipway than on its own 2.x CLI. The line now says how many more settings there are and that `agent-context` describes each, the `--http` settings join that count, and the safety switches and the settings an app marks as setup are still named. Every server's help is shorter by the names it had on that line.

package/dist/cli/help.d.ts

@@ -14,5 +14,5 @@ export declare function renderList(app: App, tools: readonly Tool[], bin: string
 export declare function exampleCommand(bin: string, tool: Tool, args: Record<string, unknown>): string;
 export declare function renderToolHelp(tool: Tool, bin: string, aliases?: Readonly<Record<string, string>>): string;
 export declare function renderGeneralHelp(app: App, bin: string): string;
-/** One line per tool, for search results and listings. */
+/** One line per tool, for search results: the title, then what the description adds to it. */
 export declare function toolLine(tool: Tool): string;

package/dist/cli/help.js

@@ -293,7 +293,15 @@ export function renderGeneralHelp(app, bin) {
         lines.push(app.definition.links.repository, ``);
     return lines.join("\n");
 }
-/** One line per tool, for search results and listings. */
+/** One line per tool, for search results: the title, then what the description adds to it. */
 export function toolLine(tool) {
-    return `${riskMark(tool)} ${tool.command}  ${tool.title}: ${firstSentence(tool.description, 80)}`;
+    const sentence = firstSentence(tool.description, 80);
+    // Many descriptions open by saying the title again, which an agent would read twice.
+    const what = !sentence ? tool.title : restates(sentence, tool.title) ? sentence : `${tool.title}: ${sentence}`;
+    return `${riskMark(tool)} ${tool.command}  ${what}`;
+}
+/** Whether a sentence opens with a title's words, whatever the case and punctuation. */
+function restates(sentence, title) {
+    const words = (text) => text.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
+    return words(sentence).startsWith(words(title));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thenavidm/slipway",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Slipway, the TypeScript framework for MCP servers and agent-native CLIs. One tool definition ships an MCP server and a CLI, with write safety, typed results and release checks built in.",
   "type": "module",
   "license": "Apache-2.0",