@crouton-kit/crouter 0.3.1 → 0.3.3

package/dist/commands/__tests__/skill.test.js

@@ -33,6 +33,7 @@ describe('skill find list params', () => {
         includeDisabledFlag,
         { kind: 'flag', name: 'limit', type: 'int', required: false, default: 50, constraint: '' },
         { kind: 'flag', name: 'cursor', type: 'string', required: false, constraint: '' },
+        { kind: 'flag', name: 'full', type: 'bool', required: false, constraint: '' },
     ];
     test('no args: defaults applied', async () => {
         const r = await parseArgv(params, []);
@@ -71,6 +72,12 @@ describe('skill find list params', () => {
         const r = await parseArgv(params, ['--plugin', 'my-plugin']);
         assert.equal(r['plugin'], 'my-plugin');
     });
+    test('--full presence = true, absence = false', async () => {
+        const present = await parseArgv(params, ['--full']);
+        assert.equal(present['full'], true);
+        const absent = await parseArgv(params, []);
+        assert.equal(absent['full'], false);
+    });
 });
 // ---------------------------------------------------------------------------
 // skill find search

package/dist/commands/human.js

@@ -21,7 +21,7 @@ import { readConfig } from '../core/config.js';
 import { mkdirSync, existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { randomBytes } from 'node:crypto';
-import { ask, launchReview, display, inbox, scanInbox, validateDeck, parseDeck, deckPath, atomicWriteJson, readJson, } from '@crouton-kit/humanloop';
+import { ask, launchReview, display, inbox, scanInbox, validateDeck, approveDeck, notifyDeck, parseDeck, deckPath, atomicWriteJson, readJson, } from '@crouton-kit/humanloop';
 const DECK_SCHEMA_HINT = 'Deck must match the humanloop deck schema: {title?, ' +
     'source?:{sessionName?,askedBy?,blockedSince?}, ' +
     'interactions:[{id,title,subtitle?,(body?|bodyPath?),options:[{id,label,' +
@@ -146,20 +146,10 @@ const humanApprove = defineLeaf({
         const title = input['title'];
         const subtitle = input['subtitle'];
         const body = input['body'];
-        const interaction = {
-            id: 'approve',
-            title,
-            kind: 'validation',
-            options: [
-                { id: 'yes', label: 'Yes' },
-                { id: 'no', label: 'No' },
-            ],
-        };
-        if (subtitle !== undefined)
-            interaction['subtitle'] = subtitle;
-        if (body !== undefined)
-            interaction['body'] = body;
-        const deck = validateDeck({ interactions: [interaction] });
+        const deck = approveDeck(title, {
+            ...(subtitle !== undefined ? { subtitle } : {}),
+            ...(body !== undefined ? { body } : {}),
+        });
         const cwd = process.cwd();
         const { jobId } = createJob('human', { cwd });
         const idir = interactionDir(jobId, cwd);
@@ -250,15 +240,7 @@ const humanNotify = defineLeaf({
     run: async (input) => {
         const title = input['title'];
         const body = input['body'];
-        const interaction = {
-            id: 'notify',
-            title,
-            kind: 'notify',
-            options: [{ id: 'ack', label: 'OK' }],
-        };
-        if (body !== undefined)
-            interaction['body'] = body;
-        const deck = validateDeck({ interactions: [interaction] });
+        const deck = notifyDeck(title, body !== undefined ? { body } : {});
         const cwd = process.cwd();
         const id = `nfy-${randomBytes(4).toString('hex')}`;
         const idir = interactionDir(id, cwd);

package/dist/commands/skill.js

@@ -86,11 +86,13 @@ const findList = defineLeaf({
             { kind: 'flag', name: 'include-disabled', type: 'bool', required: false, constraint: 'When present, includes disabled skills.' },
             { kind: 'flag', name: 'limit', type: 'int', required: false, default: 50, constraint: 'Max 200.' },
             { kind: 'flag', name: 'cursor', type: 'string', required: false, constraint: 'Opaque token from next_cursor. Omit on first call.' },
+            { kind: 'flag', name: 'full', type: 'bool', required: false, constraint: 'When present, includes each skill\'s description in items. Off by default to keep enumerations cheap; pair with --plugin or --limit to bound cost.' },
         ],
         output: [
-            { name: 'items', type: 'object[]', required: true, constraint: 'Each: {name, plugin, scope, path, description?, enabled, disabled_in?}. Sorted by scope then plugin then name ascending.' },
+            { name: 'items', type: 'object[]', required: true, constraint: 'Each: {name, plugin, scope, enabled, disabled_in?}. With --full, each item also includes description. Sorted by scope then plugin then name ascending.' },
             { name: 'next_cursor', type: 'string | null', required: true, constraint: 'null means no more items.' },
             { name: 'total', type: 'integer | null', required: true, constraint: 'Exact when cheap; null otherwise.' },
+            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands for drilling into an item or refining the list.' },
         ],
         outputKind: 'object',
         effects: ['None. Read-only.'],
@@ -102,6 +104,7 @@ const findList = defineLeaf({
         const limitRaw = input['limit'];
         const limit = Math.min(Math.max(1, limitRaw), 200);
         const cursor = input['cursor'];
+        const full = input['full'];
         const scopes = listScopes(scopeStr);
         const skills = scopes
             .flatMap((s) => listAllSkills(s))
@@ -137,17 +140,22 @@ const findList = defineLeaf({
             total: 'count',
         });
         return {
-            items: result.items.map((sk) => ({
-                name: sk.name,
-                plugin: sk.plugin,
-                scope: sk.scope,
-                path: sk.path,
-                description: sk.frontmatter.description !== undefined ? sk.frontmatter.description : null,
-                enabled: sk.enabled,
-                disabled_in: sk.disabledIn !== undefined ? sk.disabledIn : null,
-            })),
+            items: result.items.map((sk) => {
+                const base = {
+                    name: sk.name,
+                    plugin: sk.plugin,
+                    scope: sk.scope,
+                    enabled: sk.enabled,
+                    disabled_in: sk.disabledIn !== undefined ? sk.disabledIn : null,
+                };
+                if (full) {
+                    base['description'] = sk.frontmatter.description !== undefined ? sk.frontmatter.description : null;
+                }
+                return base;
+            }),
             next_cursor: result.next_cursor,
             total: result.total,
+            follow_up: 'Use `crtr skill read show <name>` for the full SKILL.md body. Run `crtr skill find list -h` for filters and verbosity.',
         };
     },
 });
@@ -165,7 +173,8 @@ const findSearch = defineLeaf({
         ],
         output: [
             { name: 'query', type: 'string', required: true, constraint: 'Echo of the input query.' },
-            { name: 'hits', type: 'object[]', required: true, constraint: 'Each: {name, plugin, scope, path, description?, keywords?, enabled, score, matched}. Sorted by score descending.' },
+            { name: 'hits', type: 'object[]', required: true, constraint: 'Each: {name, plugin, scope, score, description}. Sorted by score descending. description is the frontmatter line — the discriminator for picking which hit to read in full.' },
+            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands for drilling into a hit or refining the search.' },
         ],
         outputKind: 'object',
         effects: ['None. Read-only.'],
@@ -228,13 +237,10 @@ const findSearch = defineLeaf({
                 name: h.skill.name,
                 plugin: h.skill.plugin,
                 scope: h.skill.scope,
-                path: h.skill.path,
-                description: h.skill.frontmatter.description !== undefined ? h.skill.frontmatter.description : null,
-                keywords: h.skill.frontmatter.keywords !== undefined ? h.skill.frontmatter.keywords : null,
-                enabled: h.skill.enabled,
                 score: h.score,
-                matched: h.matched,
+                description: h.skill.frontmatter.description !== undefined ? h.skill.frontmatter.description : null,
             })),
+            follow_up: 'Use `crtr skill read show <name>` for the full SKILL.md body. Run `crtr skill find search -h` for filters.',
         };
     },
 });
@@ -675,7 +681,7 @@ export function registerSkill() {
         help: {
             name: 'skill',
             summary: 'discover, read, author, and manage skill state',
-            model: 'To consume: `find search <topic>` discovers candidates; `read show <name>` loads each relevant SKILL.md body (multiple may apply — load them all). To create: `author guide` picks a template, then re-run with `--type <t>` for the skeleton, then `author scaffold <plugin>:<name>` materializes the file. `state enable|disable` toggles visibility without deleting.',
+            model: '`find` when you do not yet know which skill applies — it locates candidates by topic, keyword, or body text. `read` when you have a name and need the SKILL.md content or its on-disk location. `author` when you are writing a new skill — it carries the template workflow and the scaffolder. `state` when a skill should be hidden from discovery without being removed. Append `-h` at any branch or leaf for its full schema.',
             dynamicState: buildSkillCatalog,
             children: [
                 { name: 'find', desc: 'list, search, or grep skills', useWhen: 'discovering what skills are available' },

package/dist/commands/sys.js

@@ -605,7 +605,7 @@ const sysUpdateLeaf = defineLeaf({
                 const r = selfCheck();
                 if (r !== null) {
                     updates.push({
-                        name: '@crouton-kit/crtr',
+                        name: '@crouton-kit/crouter',
                         kind: 'self',
                         current: r.current,
                         latest: r.latest,
@@ -615,7 +615,7 @@ const sysUpdateLeaf = defineLeaf({
                 }
                 else {
                     updates.push({
-                        name: '@crouton-kit/crtr',
+                        name: '@crouton-kit/crouter',
                         kind: 'self',
                         current: null,
                         latest: null,
@@ -647,7 +647,7 @@ const sysUpdateLeaf = defineLeaf({
         void (async () => {
             try {
                 if (resolvedTarget === 'self' || resolvedTarget === 'all') {
-                    appendEvent(jobId, { level: 'info', event: 'self-update:start', message: 'running npm install -g @crouton-kit/crtr@latest' });
+                    appendEvent(jobId, { level: 'info', event: 'self-update:start', message: 'running npm install -g @crouton-kit/crouter@latest' });
                     selfUpdate();
                     const scopes = ['user'];
                     if (projectScopeRoot())

package/dist/core/auto-update.js

@@ -27,7 +27,7 @@ function withinInterval(lastIso, intervalHours) {
     return Date.now() - last < intervalHours * HOUR_MS;
 }
 function spawnDetachedSelfUpdate() {
-    const child = spawn('npm', ['i', '-g', '@crouton-kit/crtr@latest'], {
+    const child = spawn('npm', ['i', '-g', '@crouton-kit/crouter@latest'], {
         detached: true,
         stdio: 'ignore',
     });
@@ -73,11 +73,10 @@ export function maybeAutoUpdate(argv) {
             spawnDetachedSelfUpdate();
         }
         if (content === 'notify') {
-            const entries = contentCheck();
-            for (const e of entries) {
-                if (!e.up_to_date && !e.unreachable) {
-                    process.stderr.write(`crtr: ${e.kind} ${e.name} has updates available — run \`crtr sys update\`\n`);
-                }
+            const stale = contentCheck().filter((e) => !e.up_to_date && !e.unreachable);
+            if (stale.length > 0) {
+                const list = stale.map((e) => `${e.kind} ${e.name}`).join(', ');
+                process.stderr.write(`crtr: updates available for ${list} — run \`crtr sys update\`\n`);
             }
         }
         else if (content === 'apply') {

package/dist/core/self-update.js

@@ -21,7 +21,7 @@ export function currentVersion() {
     return parsed.version;
 }
 export function selfUpdate() {
-    const res = spawnSync('npm', ['i', '-g', '@crouton-kit/crtr@latest'], { stdio: 'inherit' });
+    const res = spawnSync('npm', ['i', '-g', '@crouton-kit/crouter@latest'], { stdio: 'inherit' });
     if (res.status !== 0) {
         throw general('npm install failed');
     }
@@ -29,7 +29,7 @@ export function selfUpdate() {
 /** Check whether a newer crtr version is available on npm.
  *  Warns to stderr if network unavailable; returns {current, latest} or null if unreachable. */
 export function selfCheck() {
-    const res = spawnSync('npm', ['view', '@crouton-kit/crtr', 'version'], { encoding: 'utf8' });
+    const res = spawnSync('npm', ['view', '@crouton-kit/crouter', 'version'], { encoding: 'utf8' });
     if (res.status !== 0) {
         return null;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/crouter",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "crtr — fast access to skills, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -35,7 +35,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@crouton-kit/humanloop": "^0.3.6",
+    "@crouton-kit/humanloop": "^0.3.8",
     "commander": "^13.0.0"
   },
   "devDependencies": {