@luanpdd/kit-mcp 1.14.0 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luanpdd/kit-mcp",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Generic infrastructure to ship YOUR personal kit of agents/commands/skills as an MCP server, with cross-IDE sync (Claude Code, Cursor, Codex, Gemini, Windsurf, Antigravity, Copilot, Trae).",
   "type": "module",
   "bin": {
@@ -44,7 +44,7 @@
     "test": "node test/run.mjs test/unit",
     "test:integration": "node test/run.mjs test/integration",
     "test:all": "node test/run.mjs test",
-    "prepublishOnly": "node test/run.mjs test/unit && node test/run.mjs test/integration"
+    "prepublishOnly": "node scripts/regen-manifest.js && node scripts/update-readme-counts.js && node test/run.mjs test/unit && node test/run.mjs test/integration"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.4.2",

package/src/cli/index.js

@@ -154,20 +154,36 @@ function slim(x) {
   return { kind: x.kind, name: x.name, description: summarize(x.description) };
 }
 
+// PERF-15-01: terse variant — paridade com mcp-server slimTerse. CLI flag --terse
+// controla seleção. Mantém o mesmo shape {kind, name} para programmatic consumers
+// que parseiam --json output (consistência cross-surface).
+function slimTerse(x) {
+  return { kind: x.kind, name: x.name };
+}
+
 // --- kit ---
 const kit = program.command('kit').description('Browse the canonical kit.');
-kit.command('list-agents').action(async () => {
-  const k = await withSpinner('Loading kit...', () => listKit());
-  out(k.agents.map(slim), v => render.renderKitList(v, 'agent'));
-});
-kit.command('list-commands').action(async () => {
-  const k = await withSpinner('Loading kit...', () => listKit());
-  out(k.commands.map(slim), v => render.renderKitList(v, 'command'));
-});
-kit.command('list-skills').action(async () => {
-  const k = await withSpinner('Loading kit...', () => listKit());
-  out([...k.skills, ...k.skillsExtras].map(slim), v => render.renderKitList(v, 'skill'));
-});
+kit.command('list-agents')
+  .option('--terse', 'Omit description; return only {kind, name} (PERF-15-01)')
+  .action(async (opts) => {
+    const k = await withSpinner('Loading kit...', () => listKit());
+    const variant = opts.terse ? slimTerse : slim;
+    out(k.agents.map(variant), v => render.renderKitList(v, 'agent'));
+  });
+kit.command('list-commands')
+  .option('--terse', 'Omit description; return only {kind, name} (PERF-15-01)')
+  .action(async (opts) => {
+    const k = await withSpinner('Loading kit...', () => listKit());
+    const variant = opts.terse ? slimTerse : slim;
+    out(k.commands.map(variant), v => render.renderKitList(v, 'command'));
+  });
+kit.command('list-skills')
+  .option('--terse', 'Omit description; return only {kind, name} (PERF-15-01)')
+  .action(async (opts) => {
+    const k = await withSpinner('Loading kit...', () => listKit());
+    const variant = opts.terse ? slimTerse : slim;
+    out([...k.skills, ...k.skillsExtras].map(variant), v => render.renderKitList(v, 'skill'));
+  });
 kit.command('get <kind> <name>').action(async (kind, name) => {
   const k = await listKit();
   const item = findItem(k, kind, name);

package/src/core/manifest-verify.js

@@ -59,7 +59,11 @@ export async function verifyManifest(kitRoot) {
       missing.push(rel);
       continue;
     }
-    const actual = crypto.createHash('sha256').update(buf).digest('hex');
+    // Normalize CRLF→LF before hashing so manifest is platform-stable.
+    // git checkout converts EOL on Windows but Linux CI checks out LF —
+    // hashing raw bytes would diverge across platforms.
+    const normalized = Buffer.from(buf.toString('binary').replace(/\r\n/g, '\n'), 'binary');
+    const actual = crypto.createHash('sha256').update(normalized).digest('hex');
     if (actual !== expected) {
       mismatches.push({ path: rel, expected: expected.slice(0, 16), actual: actual.slice(0, 16) });
     }

package/src/mcp-server/index.js

@@ -42,6 +42,7 @@ const TOOLS = [
         kind:   { type: 'string', enum: ['agent', 'command', 'skill'], description: 'For action=get' },
         name:   { type: 'string', description: 'For action=get' },
         query:  { type: 'string', description: 'For action=search' },
+        terse:  { type: 'boolean', description: 'For action=list-*: omit description, return only {kind, name}. Default false (PERF-15-01).' },
       },
       required: ['action'],
     },
@@ -152,10 +153,13 @@ export const PKG_VERSION = readPkgVersion();
 
 async function handleKit(args) {
   const kit = await listKit();
+  // PERF-15-01: terse mode skips description payload entirely. Backward-compat:
+  // args.terse undefined/false preserves slim()+summarize() cap-80 behavior.
+  const variant = args.terse === true ? slimTerse : slim;
   switch (args.action) {
-    case 'list-agents':   return kit.agents.map(slim);
-    case 'list-commands': return kit.commands.map(slim);
-    case 'list-skills':   return [...kit.skills, ...kit.skillsExtras].map(slim);
+    case 'list-agents':   return kit.agents.map(variant);
+    case 'list-commands': return kit.commands.map(variant);
+    case 'list-skills':   return [...kit.skills, ...kit.skillsExtras].map(variant);
     case 'get': {
       const item = findItem(kit, args.kind, args.name);
       if (!item) return { error: `Not found: ${args.kind}/${args.name}` };
@@ -305,6 +309,13 @@ function slim(x) {
   return { kind: x.kind, name: x.name, description: summarize(x.description) };
 }
 
+// PERF-15-01: terse variant — omits description entirely. Used when MCP client
+// only needs name discovery (e.g. populating UI lists, validating slug references).
+// Default action=list-* still returns description capped via slim()/summarize().
+function slimTerse(x) {
+  return { kind: x.kind, name: x.name };
+}
+
 // --- server bootstrap ---
 
 export async function createServer() {