@crouton-kit/crouter 0.3.3 → 0.3.11

package/README.md

@@ -19,8 +19,8 @@ crtr --help
 Browse and install plugins from it:
 
 ```bash
-crtr marketplace browse crouter-official-marketplace
-crtr marketplace install crouter-official-marketplace:<plugin>
+crtr pkg market inspect browse --marketplace crouter-official-marketplace
+crtr pkg market manage install --marketplace crouter-official-marketplace --plugin <plugin>
 ```
 
 To opt out of the bootstrap (e.g. in CI), set `CRTR_NO_BOOTSTRAP=1`.

package/dist/builtin-skills/skills/crouter-development/marketplaces/SKILL.md

@@ -107,7 +107,7 @@ mkdir -p plugins/my-new-plugin/.crouter-plugin plugins/my-new-plugin/skills
 $EDITOR plugins/my-new-plugin/.crouter-plugin/plugin.json
 
 # Add at least one skill
-crtr skill author scaffold my-new-plugin:first-skill --type playbook --description "Use when …"
+crtr skill author scaffold my-new-plugin/first-skill --type playbook --description "Use when …"
 
 # Add the plugin to the marketplace index
 $EDITOR .crouter-marketplace/marketplace.json

package/dist/builtin-skills/skills/crouter-development/plugins/SKILL.md

@@ -96,7 +96,7 @@ Three ways a plugin lands in a scope:
 mkdir -p my-plugin/.crouter-plugin my-plugin/skills
 $EDITOR my-plugin/.crouter-plugin/plugin.json      # write the manifest
 cd my-plugin
-crtr skill author scaffold my-plugin:my-first-skill --type playbook --description "Use when …"
+crtr skill author scaffold my-plugin/my-first-skill --type playbook --description "Use when …"
 
 # Symlink for fast iteration — no clone, edits land immediately
 ln -s $(pwd) ~/.crouter/plugins/my-plugin
@@ -124,9 +124,9 @@ Standard semver:
 
 ## Enable/disable
 
-`crtr pkg plugin manage disable <name>` flips the per-scope config without removing files. Disabled plugins are hidden from `crtr skill find list` and don't resolve via `crtr skill read show <name>`. Re-enable with `crtr pkg plugin manage enable <name>`.
+`crtr pkg plugin manage disable <name>` flips the per-scope config without removing files. Disabled plugins are hidden from `crtr skill find list` and don't resolve via `crtr skill read <name>`. Re-enable with `crtr pkg plugin manage enable <name>`.
 
-Individual skills inside an enabled plugin can also be disabled: `crtr skill state disable <plugin>:<skill>`.
+Individual skills inside an enabled plugin can also be disabled: `crtr skill state disable <plugin>/<skill>`.
 
 ## What goes in a plugin
 

package/dist/cli.js

@@ -1,38 +1,27 @@
 #!/usr/bin/env node
 import { defineRoot, runCli } from './core/command.js';
-import { registerFlow } from './commands/flow.js';
+import { registerAgent } from './commands/agent.js';
+import { registerMode } from './commands/mode.js';
 import { registerSkill } from './commands/skill.js';
-import { registerPkg } from './commands/pkg.js';
 import { registerJob } from './commands/job.js';
+import { registerPkg } from './commands/pkg.js';
 import { registerHuman } from './commands/human.js';
 import { registerSys } from './commands/sys.js';
 import { maybeAutoUpdate } from './core/auto-update.js';
-import { ensureBootSkill, ensureOfficialMarketplace, ensureProjectScope } from './core/bootstrap.js';
+import { ensureBootSkill, ensureOfficialMarketplace, ensureProjectScope, ensureSlashCommands } from './core/bootstrap.js';
+// Root owns only the tagline and globals. Every subtree's concept line,
+// selection rubric, and any dynamic block it contributes to root -h are
+// declared on the subtree itself (its rootEntry) and assembled here by
+// defineRoot. Add a subtree to this list and it appears at root; nothing about
+// it is restated here.
 const root = defineRoot({
-    help: {
-        tagline: 'crtr: agentic planning runtime.',
-        concepts: [
-            { name: 'flow', desc: 'spec → plan → debug: the development process' },
-            { name: 'skill', desc: 'loadable SKILL.md document an agent reads to adopt a workflow' },
-            { name: 'pkg', desc: 'plugins and marketplaces that supply skills' },
-            { name: 'job', desc: 'a running agent worker and its logs and result' },
-            { name: 'human', desc: 'human-in-the-loop decisions, document review, and live display' },
-            { name: 'sys', desc: 'crtr configuration, diagnostics, and self-management' },
-        ],
-        subtrees: [
-            { name: 'flow', desc: 'spec, plan, and debug workflows', useWhen: 'capturing requirements, planning work, or root-causing a bug' },
-            { name: 'skill', desc: 'discover, read, author, and manage skills', useWhen: 'working with SKILL.md documents' },
-            { name: 'pkg', desc: 'manage plugins and marketplaces', useWhen: 'installing or browsing skill collections' },
-            { name: 'job', desc: 'spawn, monitor, and collect from agent workers', useWhen: 'running or watching agent jobs' },
-            { name: 'human', desc: 'ask, approve, review, notify, show, inbox, list', useWhen: 'putting a decision or document in front of a person' },
-            { name: 'sys', desc: 'config, doctor, update, version', useWhen: 'managing the crtr installation' },
-        ],
-        globals: [
-            { name: '-h', desc: 'print help for any node — append to any subcommand path' },
-        ],
-    },
+    tagline: 'crtr: agentic planning runtime.',
+    globals: [
+        { name: '-h', desc: 'print help for any node — append to any subcommand path' },
+    ],
     subtrees: [
-        registerFlow(),
+        registerAgent(),
+        registerMode(),
         registerSkill(),
         registerPkg(),
         registerJob(),
@@ -42,6 +31,7 @@ const root = defineRoot({
 });
 ensureOfficialMarketplace(process.argv);
 ensureBootSkill(process.argv);
+ensureSlashCommands(root, process.argv);
 ensureProjectScope(process.argv);
 maybeAutoUpdate(process.argv);
 runCli(root, process.argv).catch((err) => {

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

@@ -139,14 +139,15 @@ describe('skill find grep params', () => {
     });
 });
 // ---------------------------------------------------------------------------
-// skill read show
+// skill read
 // ---------------------------------------------------------------------------
-describe('skill read show params', () => {
+describe('skill read params', () => {
     const params = [
         { kind: 'positional', name: 'name', required: true, constraint: '' },
         scopeWriteFlag,
         pluginFlag,
         { kind: 'flag', name: 'frontmatter', type: 'bool', required: false, constraint: '' },
+        { kind: 'flag', name: 'no-body', type: 'bool', required: false, constraint: '' },
     ];
     test('name positional required', async () => {
         await assert.rejects(() => parseArgv(params, []), (e) => { assert.match(e.message, /required parameter is missing/); return true; });
@@ -155,6 +156,10 @@ describe('skill read show params', () => {
         const r = await parseArgv(params, ['my-skill']);
         assert.equal(r['name'], 'my-skill');
     });
+    test('nested name parsed correctly', async () => {
+        const r = await parseArgv(params, ['some/nested/skill']);
+        assert.equal(r['name'], 'some/nested/skill');
+    });
     test('--frontmatter presence = true', async () => {
         const r = await parseArgv(params, ['my-skill', '--frontmatter']);
         assert.equal(r['frontmatter'], true);
@@ -163,6 +168,14 @@ describe('skill read show params', () => {
         const r = await parseArgv(params, ['my-skill']);
         assert.equal(r['frontmatter'], false);
     });
+    test('--no-body presence = true (kebab to camelCase key)', async () => {
+        const r = await parseArgv(params, ['my-skill', '--no-body']);
+        assert.equal(r['noBody'], true);
+    });
+    test('--no-body absent = false', async () => {
+        const r = await parseArgv(params, ['my-skill']);
+        assert.equal(r['noBody'], false);
+    });
     test('--scope rejects all', async () => {
         await assert.rejects(() => parseArgv(params, ['my-skill', '--scope', 'all']), (e) => { assert.match(e.message, /must be one of/); return true; });
     });
@@ -170,23 +183,6 @@ describe('skill read show params', () => {
         const r = await parseArgv(params, ['my-skill', '--scope', 'user']);
         assert.equal(r['scope'], 'user');
     });
-});
-// ---------------------------------------------------------------------------
-// skill read where
-// ---------------------------------------------------------------------------
-describe('skill read where params', () => {
-    const params = [
-        { kind: 'positional', name: 'name', required: true, constraint: '' },
-        scopeWriteFlag,
-        pluginFlag,
-    ];
-    test('name positional required', async () => {
-        await assert.rejects(() => parseArgv(params, []), (e) => { assert.match(e.message, /required parameter is missing/); return true; });
-    });
-    test('name parsed correctly', async () => {
-        const r = await parseArgv(params, ['some/nested/skill']);
-        assert.equal(r['name'], 'some/nested/skill');
-    });
     test('--scope project valid', async () => {
         const r = await parseArgv(params, ['skillname', '--scope', 'project']);
         assert.equal(r['scope'], 'project');
@@ -239,26 +235,26 @@ describe('skill author scaffold params', () => {
         await assert.rejects(() => parseArgv(params, []), (e) => { assert.match(e.message, /required parameter is missing/); return true; });
     });
     test('qualifier parsed correctly', async () => {
-        const r = await parseArgv(params, ['myplugin:myskill']);
-        assert.equal(r['qualifier'], 'myplugin:myskill');
+        const r = await parseArgv(params, ['myplugin/myskill']);
+        assert.equal(r['qualifier'], 'myplugin/myskill');
     });
     test('full invocation', async () => {
         const r = await parseArgv(params, [
-            'myplugin:myskill',
+            'myplugin/myskill',
             '--type', 'playbook',
             '--scope', 'project',
             '--description', 'Use when debugging',
         ]);
-        assert.equal(r['qualifier'], 'myplugin:myskill');
+        assert.equal(r['qualifier'], 'myplugin/myskill');
         assert.equal(r['type'], 'playbook');
         assert.equal(r['scope'], 'project');
         assert.equal(r['description'], 'Use when debugging');
     });
     test('--type invalid rejects', async () => {
-        await assert.rejects(() => parseArgv(params, ['q:s', '--type', 'invalid']), (e) => { assert.match(e.message, /must be one of/); return true; });
+        await assert.rejects(() => parseArgv(params, ['q/s', '--type', 'invalid']), (e) => { assert.match(e.message, /must be one of/); return true; });
     });
     test('--scope all rejects', async () => {
-        await assert.rejects(() => parseArgv(params, ['q:s', '--scope', 'all']), (e) => { assert.match(e.message, /must be one of/); return true; });
+        await assert.rejects(() => parseArgv(params, ['q/s', '--scope', 'all']), (e) => { assert.match(e.message, /must be one of/); return true; });
     });
 });
 // ---------------------------------------------------------------------------
@@ -287,8 +283,8 @@ describe('skill state enable/disable params', () => {
     test('--scope all rejects', async () => {
         await assert.rejects(() => parseArgv(params, ['my-skill', '--scope', 'all']), (e) => { assert.match(e.message, /must be one of/); return true; });
     });
-    test('plugin:skill qualifier as name', async () => {
-        const r = await parseArgv(params, ['myplugin:myskill']);
-        assert.equal(r['name'], 'myplugin:myskill');
+    test('plugin/skill qualifier as name', async () => {
+        const r = await parseArgv(params, ['myplugin/myskill']);
+        assert.equal(r['name'], 'myplugin/myskill');
     });
 });

package/dist/commands/agent.d.ts

@@ -0,0 +1,6 @@
+import type { BranchDef } from '../core/command.js';
+export declare const DEFAULT_KILL_SECS = 2;
+export declare function followUpResult(jobId: string): string;
+export declare function resolveMaxPanes(): number;
+export declare function assertTmux(): void;
+export declare function registerAgent(): BranchDef;