@crouton-kit/crouter 0.1.2 → 0.1.4

package/README.md

@@ -9,5 +9,18 @@ npm install -g @crouton-kit/crouter
 ## Usage
 
 ```bash
-crouter --help
+crtr --help
 ```
+
+## Official marketplace
+
+`crtr` ships with the [crouter official marketplace](https://github.com/crouton-labs/crouter-official-marketplace) pre-installed. On first run it is cloned into your user scope and registered automatically — no plugins are enabled by default.
+
+Browse and install plugins from it:
+
+```bash
+crtr marketplace browse crouter-official-marketplace
+crtr marketplace install crouter-official-marketplace:<plugin>
+```
+
+To opt out of the bootstrap (e.g. in CI), set `CRTR_NO_BOOTSTRAP=1`.

package/dist/cli.js

@@ -11,6 +11,8 @@ import { registerUpdateCommand } from './commands/update.js';
 import { registerDoctorCommand } from './commands/doctor.js';
 import { registerPlanCommand } from './commands/plan.js';
 import { registerSpecCommand } from './commands/spec.js';
+import { maybeAutoUpdate } from './core/auto-update.js';
+import { ensureOfficialMarketplace } from './core/bootstrap.js';
 function readPackageVersion() {
     const here = dirname(fileURLToPath(import.meta.url));
     const pkgPath = join(here, '..', 'package.json');
@@ -32,6 +34,8 @@ registerUpdateCommand(program);
 registerDoctorCommand(program);
 registerPlanCommand(program);
 registerSpecCommand(program);
+ensureOfficialMarketplace(process.argv);
+maybeAutoUpdate(process.argv);
 program.parseAsync().catch((err) => {
     process.stderr.write(`crtr: ${err instanceof Error ? err.message : String(err)}\n`);
     process.exit(1);

package/dist/commands/config.js

@@ -35,6 +35,14 @@ function setNestedValue(cfg, key, value) {
         cfg.auto_update.content = value;
         return;
     }
+    if (key === 'auto_update.crtr') {
+        const coerced = value === true ? 'notify' : value;
+        if (coerced !== 'notify' && coerced !== 'apply' && coerced !== false) {
+            throw usage(`auto_update.crtr must be 'notify', 'apply', or false`);
+        }
+        cfg.auto_update.crtr = coerced;
+        return;
+    }
     if (parts.length === 1) {
         cfg[topKey] = value;
         return;

package/dist/commands/skill.js

@@ -9,6 +9,7 @@ import { resolveSkill, listAllSkills, listInstalledPlugins, findPluginByName, pa
 import { updateConfig, ensureScopeInitialized } from '../core/config.js';
 import { parseFrontmatter, serializeFrontmatter } from '../core/frontmatter.js';
 import { ensureDir, pathExists, readText, walkFiles } from '../core/fs-utils.js';
+import { skillPrompt } from '../prompts/skill.js';
 const KNOWN_VERBS = new Set([
     'list',
     'show',
@@ -35,7 +36,7 @@ export function registerSkillCommands(program) {
         .option('--frontmatter', 'include YAML frontmatter in the printed body')
         .action(async (nameOrVerb, _rest, opts) => {
         if (nameOrVerb === undefined) {
-            skill.help();
+            out(skillPrompt());
             return;
         }
         if (!KNOWN_VERBS.has(nameOrVerb)) {

package/dist/commands/update.d.ts

@@ -1,2 +1,4 @@
 import { Command } from 'commander';
+export declare function selfCheck(): void;
+export declare function contentCheck(): void;
 export declare function registerUpdateCommand(program: Command): void;

package/dist/commands/update.js

@@ -24,7 +24,7 @@ function selfUpdate() {
         throw general('npm install failed');
     }
 }
-function selfCheck() {
+export function selfCheck() {
     const res = spawnSync('npm', ['view', '@crouton-kit/crtr', 'version'], { encoding: 'utf8' });
     if (res.status !== 0) {
         warn('could not check for crtr updates (network unavailable)');
@@ -66,7 +66,7 @@ function contentUpdate() {
         });
     }
 }
-function contentCheck() {
+export function contentCheck() {
     const marketplaces = listAllMarketplaces();
     for (const mkt of marketplaces) {
         const fetchRes = fetch(mkt.root, mkt.ref);

package/dist/core/auto-update.d.ts

@@ -0,0 +1 @@
+export declare function maybeAutoUpdate(argv: string[]): void;

package/dist/core/auto-update.js

@@ -0,0 +1,86 @@
+import { spawn } from 'node:child_process';
+import { readConfig, readState, updateState } from './config.js';
+import { nowIso } from './fs-utils.js';
+import { info } from './output.js';
+import { selfCheck, contentCheck } from '../commands/update.js';
+const HOUR_MS = 60 * 60 * 1000;
+const SKIP_SUBCOMMANDS = new Set([
+    'update',
+    'help',
+    '--help',
+    '-h',
+    '--version',
+    '-v',
+]);
+function shouldSkipForArgv(argv) {
+    const sub = argv[2];
+    if (sub === undefined)
+        return true;
+    return SKIP_SUBCOMMANDS.has(sub);
+}
+function withinInterval(lastIso, intervalHours) {
+    if (!lastIso)
+        return false;
+    const last = Date.parse(lastIso);
+    if (!Number.isFinite(last))
+        return false;
+    return Date.now() - last < intervalHours * HOUR_MS;
+}
+function spawnDetachedSelfUpdate() {
+    const child = spawn('npm', ['i', '-g', '@crouton-kit/crtr@latest'], {
+        detached: true,
+        stdio: 'ignore',
+    });
+    child.unref();
+}
+function spawnDetachedContentUpdate() {
+    const child = spawn('crtr', ['update', '--content'], {
+        detached: true,
+        stdio: 'ignore',
+    });
+    child.unref();
+}
+export function maybeAutoUpdate(argv) {
+    try {
+        if (process.env.CRTR_NO_AUTO_UPDATE === '1')
+            return;
+        if (shouldSkipForArgv(argv))
+            return;
+        const cfg = readConfig('user');
+        const { crtr, content, interval_hours } = cfg.auto_update;
+        if (crtr === false && content === false)
+            return;
+        const state = readState('user');
+        if (state.last_self_check === undefined) {
+            updateState('user', (s) => {
+                s.last_self_check = nowIso();
+            });
+            return;
+        }
+        if (withinInterval(state.last_self_check, interval_hours))
+            return;
+        updateState('user', (s) => {
+            s.last_self_check = nowIso();
+        });
+        if (crtr === 'notify') {
+            selfCheck();
+        }
+        else if (crtr === 'apply') {
+            info('applying self-update in background');
+            spawnDetachedSelfUpdate();
+        }
+        if (content === 'notify') {
+            contentCheck();
+        }
+        else if (content === 'apply') {
+            info('applying content updates in background');
+            spawnDetachedContentUpdate();
+        }
+    }
+    catch (e) {
+        if (process.env.CRTR_DEBUG === '1') {
+            const msg = e instanceof Error ? e.message : String(e);
+            process.stderr.write(`crtr: auto-update hook error: ${msg}\n`);
+        }
+    }
+}

package/dist/core/bootstrap.d.ts

@@ -0,0 +1,4 @@
+export declare const OFFICIAL_MARKETPLACE_NAME = "crouter-official-marketplace";
+export declare const OFFICIAL_MARKETPLACE_URL = "https://github.com/crouton-labs/crouter-official-marketplace.git";
+export declare const OFFICIAL_MARKETPLACE_REF = "main";
+export declare function ensureOfficialMarketplace(argv: string[]): void;

package/dist/core/bootstrap.js

@@ -0,0 +1,70 @@
+import { join } from 'node:path';
+import { userScopeRoot } from './scope.js';
+import { ensureDir, pathExists, removePath, nowIso } from './fs-utils.js';
+import { readConfig, readState, updateConfig, updateState, ensureScopeInitialized } from './config.js';
+import { clone } from './git.js';
+import { readMarketplaceManifest } from './manifest.js';
+export const OFFICIAL_MARKETPLACE_NAME = 'crouter-official-marketplace';
+export const OFFICIAL_MARKETPLACE_URL = 'https://github.com/crouton-labs/crouter-official-marketplace.git';
+export const OFFICIAL_MARKETPLACE_REF = 'main';
+const SKIP_SUBCOMMANDS = new Set([
+    'help',
+    '--help',
+    '-h',
+    '--version',
+    '-v',
+]);
+function shouldSkipForArgv(argv) {
+    const sub = argv[2];
+    if (sub === undefined)
+        return true;
+    return SKIP_SUBCOMMANDS.has(sub);
+}
+export function ensureOfficialMarketplace(argv) {
+    try {
+        if (process.env.CRTR_NO_BOOTSTRAP === '1')
+            return;
+        if (shouldSkipForArgv(argv))
+            return;
+        const state = readState('user');
+        if (state.bootstrap_done === true)
+            return;
+        const cfg = readConfig('user');
+        if (cfg.marketplaces[OFFICIAL_MARKETPLACE_NAME] !== undefined) {
+            updateState('user', (s) => {
+                s.bootstrap_done = true;
+            });
+            return;
+        }
+        const root = userScopeRoot();
+        ensureScopeInitialized('user', root);
+        const mktsDir = join(root, 'marketplaces');
+        ensureDir(mktsDir);
+        const dest = join(mktsDir, OFFICIAL_MARKETPLACE_NAME);
+        if (pathExists(dest)) {
+            removePath(dest);
+        }
+        clone(OFFICIAL_MARKETPLACE_URL, dest, { depth: 1, ref: OFFICIAL_MARKETPLACE_REF });
+        const manifest = readMarketplaceManifest(dest);
+        if (manifest === null) {
+            removePath(dest);
+            return;
+        }
+        updateConfig('user', (c) => {
+            c.marketplaces[OFFICIAL_MARKETPLACE_NAME] = {
+                url: OFFICIAL_MARKETPLACE_URL,
+                ref: OFFICIAL_MARKETPLACE_REF,
+                installed_at: nowIso(),
+            };
+        });
+        updateState('user', (s) => {
+            s.bootstrap_done = true;
+        });
+    }
+    catch (e) {
+        if (process.env.CRTR_DEBUG === '1') {
+            const msg = e instanceof Error ? e.message : String(e);
+            process.stderr.write(`crtr: bootstrap error: ${msg}\n`);
+        }
+    }
+}

package/dist/core/config.js

@@ -36,6 +36,7 @@ export function readState(scope) {
         marketplaces: existing.marketplaces ?? {},
         plugins: existing.plugins ?? {},
         last_self_check: existing.last_self_check,
+        bootstrap_done: existing.bootstrap_done,
     };
 }
 export function writeConfig(scope, config) {
@@ -55,6 +56,15 @@ export function ensureScopeInitialized(scope, root) {
         writeJson(cfgPath, defaultScopeConfig());
     }
 }
+function normalizeMode(value, fallback) {
+    if (value === true)
+        return 'notify';
+    if (value === false)
+        return false;
+    if (value === 'notify' || value === 'apply')
+        return value;
+    return fallback;
+}
 function mergeConfig(partial) {
     const defaults = defaultScopeConfig();
     const schema_version = partial.schema_version === undefined ? defaults.schema_version : partial.schema_version;
@@ -62,10 +72,14 @@ function mergeConfig(partial) {
     const plugins = partial.plugins === undefined ? {} : partial.plugins;
     const skills = partial.skills === undefined ? {} : partial.skills;
     const au = partial.auto_update;
+    const rawInterval = au && typeof au.interval_hours === 'number' ? au.interval_hours : undefined;
+    const interval_hours = rawInterval !== undefined && Number.isFinite(rawInterval) && rawInterval >= 0
+        ? rawInterval
+        : defaults.auto_update.interval_hours;
     const auto_update = {
-        crtr: au && au.crtr !== undefined ? au.crtr : defaults.auto_update.crtr,
-        content: au && au.content !== undefined ? au.content : defaults.auto_update.content,
-        interval_hours: au && au.interval_hours !== undefined ? au.interval_hours : defaults.auto_update.interval_hours,
+        crtr: normalizeMode(au?.crtr, defaults.auto_update.crtr),
+        content: normalizeMode(au?.content, defaults.auto_update.content),
+        interval_hours,
     };
     return { schema_version, marketplaces, plugins, skills, auto_update };
 }

package/dist/core/frontmatter.js

@@ -11,29 +11,103 @@ export function parseFrontmatter(source) {
 function parseSimpleYaml(yaml) {
     const lines = yaml.split(/\r?\n/);
     const out = {};
-    let currentKey = null;
-    let listBuffer = null;
-    for (const raw of lines) {
-        if (!raw.trim())
-            continue;
-        if (raw.startsWith('  - ') || raw.startsWith('- ')) {
-            const value = raw.replace(/^\s*-\s+/, '').trim();
-            if (currentKey && listBuffer)
-                listBuffer.push(stripQuotes(value));
+    let i = 0;
+    while (i < lines.length) {
+        const raw = lines[i];
+        if (!raw.trim()) {
+            i++;
             continue;
         }
         const idx = raw.indexOf(':');
-        if (idx === -1)
+        if (idx === -1) {
+            i++;
             continue;
-        if (currentKey && listBuffer) {
-            out[currentKey] = listBuffer;
-            listBuffer = null;
         }
         const key = raw.slice(0, idx).trim();
         const rest = raw.slice(idx + 1).trim();
-        currentKey = key;
+        // Block scalar: `key: |` or `key: >` with optional chomp indicator (-/+)
+        const blockMatch = rest.match(/^([|>])([-+]?)\s*$/);
+        if (blockMatch) {
+            const style = blockMatch[1];
+            const chomp = blockMatch[2];
+            const collected = [];
+            let blockIndent = null;
+            let j = i + 1;
+            while (j < lines.length) {
+                const r = lines[j];
+                if (r.trim() === '') {
+                    collected.push('');
+                    j++;
+                    continue;
+                }
+                const ind = r.match(/^(\s*)/)?.[1].length ?? 0;
+                if (blockIndent === null) {
+                    if (ind === 0)
+                        break;
+                    blockIndent = ind;
+                }
+                if (ind < blockIndent)
+                    break;
+                collected.push(r.slice(blockIndent));
+                j++;
+            }
+            while (collected.length > 0 && collected[collected.length - 1] === '')
+                collected.pop();
+            let value;
+            if (style === '|') {
+                value = collected.join('\n');
+            }
+            else {
+                const parts = [];
+                let para = [];
+                for (const ln of collected) {
+                    if (ln === '') {
+                        if (para.length > 0) {
+                            parts.push(para.join(' '));
+                            para = [];
+                        }
+                        parts.push('');
+                    }
+                    else {
+                        para.push(ln);
+                    }
+                }
+                if (para.length > 0)
+                    parts.push(para.join(' '));
+                const folded = [];
+                for (let k = 0; k < parts.length; k++) {
+                    if (parts[k] === '' && (k === 0 || parts[k - 1] === ''))
+                        continue;
+                    folded.push(parts[k]);
+                }
+                value = folded.join('\n').replace(/\n+$/, '');
+            }
+            if (chomp !== '+')
+                value = value.replace(/\n+$/, '');
+            out[key] = value;
+            i = j;
+            continue;
+        }
+        // Empty value: could be a list on subsequent lines
         if (rest === '') {
-            listBuffer = [];
+            const buf = [];
+            let j = i + 1;
+            while (j < lines.length) {
+                const r = lines[j];
+                if (r.trim() === '') {
+                    j++;
+                    continue;
+                }
+                if (/^\s*-\s+/.test(r)) {
+                    buf.push(stripQuotes(r.replace(/^\s*-\s+/, '').trim()));
+                    j++;
+                    continue;
+                }
+                break;
+            }
+            if (buf.length > 0)
+                out[key] = buf;
+            i = j;
             continue;
         }
         if (rest.startsWith('[') && rest.endsWith(']')) {
@@ -42,14 +116,12 @@ function parseSimpleYaml(yaml) {
                 .split(',')
                 .map((s) => stripQuotes(s.trim()))
                 .filter(Boolean);
-            currentKey = null;
+            i++;
             continue;
         }
         out[key] = stripQuotes(rest);
-        currentKey = null;
+        i++;
     }
-    if (currentKey && listBuffer)
-        out[currentKey] = listBuffer;
     const fm = {
         name: typeof out.name === 'string' ? out.name : '',
         description: typeof out.description === 'string' ? out.description : undefined,

package/dist/prompts/plan.js

@@ -95,5 +95,12 @@ EOF
 
 Your turn ends after the save command succeeds. No need to summarize the plan
 in chat — the user can read the file.
+
+## See also
+
+- \`crtr plan list\` — list saved plans for the current directory
+- \`crtr plan show <name>\` — print the body of a saved plan
+- \`crtr plan edit <name>\` — open a saved plan in \$EDITOR
+- \`crtr plan path [name]\` — absolute path of a plan or the plans directory
 `;
 }

package/dist/prompts/skill.d.ts

@@ -0,0 +1 @@
+export declare function skillPrompt(): string;

package/dist/prompts/skill.js

@@ -0,0 +1,49 @@
+export function skillPrompt() {
+    return `# Skill workflow
+
+\`crtr\` ships skills — markdown reference with frontmatter that you pull on
+demand. When the user's task matches a skill's description, run
+\`crtr skill show <name>\` and apply the guidance. Ambiguous names exit \`4\` —
+disambiguate with \`<plugin>:<name>\`.
+
+## Discover
+
+\`\`\`
+crtr skill list                    # one per line: <scope>:<plugin>/<name>  — <description>
+crtr skill search <query>          # rank by name, description, keywords
+crtr skill grep <pattern>          # regex search across SKILL.md bodies
+\`\`\`
+
+## Load
+
+\`\`\`
+crtr skill show <name>             # print SKILL.md body to stdout
+crtr skill show <plugin>:<name>    # disambiguate when names collide
+crtr skill path <name>             # absolute path to SKILL.md
+crtr skill where <name>            # {scope, plugin, path} as JSON
+\`\`\`
+
+\`show\` is the default verb: \`crtr skill <name>\` (with no verb) also prints
+the body.
+
+## Author
+
+\`\`\`
+crtr skill new <plugin>:<name> --description "..."   # scaffold a new skill
+crtr skill show authoring-skills                     # the SKILL.md authoring guide
+\`\`\`
+
+## Toggle
+
+\`\`\`
+crtr skill enable <name>           # clear any disable in the chosen scope
+crtr skill disable <name>          # hide from list and agent discovery
+\`\`\`
+
+## Exit codes
+
+- \`0\` — success
+- \`3\` — skill not found
+- \`4\` — ambiguous name; use \`<plugin>:<name>\`
+`;
+}

package/dist/prompts/spec.js

@@ -102,5 +102,12 @@ EOF
 
 Your turn ends after the save command succeeds. No need to summarize the spec
 in chat — the user can read the file.
+
+## See also
+
+- \`crtr spec list\` — list saved specs for the current directory
+- \`crtr spec show <name>\` — print the body of a saved spec
+- \`crtr spec edit <name>\` — open a saved spec in \$EDITOR
+- \`crtr spec path [name]\` — absolute path of a spec or the specs directory
 `;
 }

package/dist/types.d.ts

@@ -47,9 +47,10 @@ export interface ConfigPluginEntry {
 export interface ConfigSkillEntry {
     enabled: boolean;
 }
+export type AutoUpdateMode = 'notify' | 'apply' | false;
 export interface AutoUpdateConfig {
-    crtr: boolean;
-    content: 'notify' | 'apply' | false;
+    crtr: AutoUpdateMode;
+    content: AutoUpdateMode;
     interval_hours: number;
 }
 export interface ScopeConfig {
@@ -67,6 +68,7 @@ export interface ScopeState {
         last_updated?: string;
     }>;
     last_self_check?: string;
+    bootstrap_done?: boolean;
 }
 export interface SkillFrontmatter {
     name: string;

package/dist/types.js

@@ -22,7 +22,7 @@ export function defaultScopeConfig() {
         marketplaces: {},
         plugins: {},
         skills: {},
-        auto_update: { crtr: true, content: 'notify', interval_hours: 24 },
+        auto_update: { crtr: 'notify', content: 'notify', interval_hours: 24 },
     };
 }
 export function skillConfigKey(plugin, name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/crouter",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "crtr — fast access to skills, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",