runspec-node 0.3.0

package/bin/runspec.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';
+const { main } = require('../dist/cli');
+main();

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+import type { ScriptSpec } from './models';
+export declare function main(): void;
+export declare function buildSchema(name: string, script: ScriptSpec, fmt: string): Record<string, unknown>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAW,MAAM,UAAU,CAAC;AAIpD,wBAAgB,IAAI,IAAI,IAAI,CA0B3B;AAqJD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBlG"}

package/dist/cli.js

@@ -0,0 +1,384 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+exports.buildSchema = buildSchema;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const finder_1 = require("./finder");
+const loader_1 = require("./loader");
+const inference_1 = require("./inference");
+// ── Entry point ───────────────────────────────────────────────────────────────
+function main() {
+    const args = process.argv.slice(2);
+    if (!args.length || args[0] === '-h' || args[0] === '--help') {
+        printHelp();
+        return;
+    }
+    const command = args[0];
+    const rest = args.slice(1);
+    const commands = {
+        init: cmdInit,
+        discover: cmdDiscover,
+        check: cmdCheck,
+        emit: cmdEmit,
+        serve: cmdServe,
+    };
+    if (!(command in commands)) {
+        console.log(`✗  Unknown command: ${command}`);
+        console.log(`   Available commands: ${Object.keys(commands).join(', ')}`);
+        process.exit(1);
+    }
+    commands[command](rest);
+}
+// ── Commands ──────────────────────────────────────────────────────────────────
+function cmdInit(args) {
+    const nameFlag = getFlag(args, '--name');
+    const fileFlag = getFlag(args, '--file');
+    const cwd = process.cwd();
+    const runnableName = nameFlag ?? sanitizeName(path.basename(cwd));
+    const pyproject = path.join(cwd, 'pyproject.toml');
+    const runspecToml = path.join(cwd, 'runspec.toml');
+    if (fileFlag === 'runspec') {
+        initRunspecToml(runspecToml, runnableName);
+    }
+    else if (fileFlag === 'pyproject' || fs.existsSync(pyproject)) {
+        initPyproject(pyproject, runnableName);
+    }
+    else {
+        initRunspecToml(runspecToml, runnableName);
+    }
+}
+function cmdDiscover(args) {
+    const fmt = getFlag(args, '--format') ?? 'text';
+    const discovered = discoverLocal();
+    if (!discovered.length) {
+        console.log('No runspec-aware runnables found in this environment.');
+        console.log('Add a [tool.runspec.yourname] section to pyproject.toml or create runspec.toml');
+        return;
+    }
+    if (fmt === 'text') {
+        printDiscoverText(discovered);
+    }
+    else if (fmt === 'json') {
+        console.log(JSON.stringify(discovered, null, 2));
+    }
+    else if (['mcp', 'openai', 'anthropic'].includes(fmt)) {
+        console.log(JSON.stringify(emitAll(discovered, fmt), null, 2));
+    }
+    else {
+        console.log(`✗  Unknown format: ${fmt}`);
+        console.log('   Available formats: text, json, mcp, openai, anthropic');
+        process.exit(1);
+    }
+}
+function cmdCheck(args) {
+    let configPath;
+    let format;
+    try {
+        ({ configPath, format } = (0, finder_1.findConfig)(process.cwd()));
+    }
+    catch (e) {
+        console.log(e.message);
+        process.exit(1);
+    }
+    const raw = (0, loader_1.loadRaw)(configPath, format);
+    const errors = [];
+    const warnings = [];
+    const ok = [];
+    ok.push(`Config found: ${configPath}`);
+    if (format === 'pyproject') {
+        const eps = raw.entryPoints;
+        if (Object.keys(eps).length > 0) {
+            ok.push(`[project.scripts] found — ${Object.keys(eps).length} entry point(s)`);
+        }
+        else {
+            warnings.push('No [project.scripts] found — agents may not discover runnables automatically\n  Add entry points to pyproject.toml or use runspec.toml');
+        }
+    }
+    if ('config' in raw.runnables) {
+        errors.push("'config' is a reserved name — rename your runnable to something else");
+    }
+    for (const [name, runnable] of Object.entries(raw.runnables)) {
+        if (!runnable.description) {
+            warnings.push(`'${name}' has no description — agents won't know what it does`);
+        }
+        else {
+            ok.push(`'${name}' — description present`);
+        }
+        if (!runnable.autonomy) {
+            warnings.push(`'${name}' autonomy not declared — will default to '${raw.config.autonomyDefault}'`);
+        }
+        else {
+            ok.push(`'${name}' — autonomy: ${runnable.autonomy}`);
+        }
+        for (const [argName, arg] of Object.entries(runnable.args ?? {})) {
+            if (!arg.description && arg.required) {
+                warnings.push(`'${name}.${argName}' is required but has no description`);
+            }
+        }
+    }
+    for (const msg of ok)
+        console.log(`  ✓  ${msg}`);
+    for (const msg of warnings)
+        console.log(`  ℹ  ${msg}`);
+    for (const msg of errors)
+        console.log(`  ✗  ${msg}`);
+    if (errors.length)
+        process.exit(1);
+    else if (!warnings.length)
+        console.log('\n  All checks passed.');
+}
+function cmdEmit(args) {
+    const scriptName = getFlag(args, '--script');
+    const fmt = getFlag(args, '--format') ?? 'mcp';
+    let configPath;
+    let format;
+    try {
+        ({ configPath, format } = (0, finder_1.findConfig)(process.cwd()));
+    }
+    catch (e) {
+        console.log(e.message);
+        process.exit(1);
+    }
+    const raw = (0, loader_1.loadRaw)(configPath, format);
+    const config = raw.config;
+    let runnables = raw.runnables;
+    if (scriptName) {
+        if (!(scriptName in runnables)) {
+            console.log(`✗  Runnable '${scriptName}' not found`);
+            process.exit(1);
+        }
+        runnables = { [scriptName]: runnables[scriptName] };
+    }
+    const schema = {};
+    for (const [name, runnable] of Object.entries(runnables)) {
+        const inferred = (0, inference_1.inferScript)(runnable, config.autonomyDefault);
+        schema[name] = buildSchema(name, inferred, fmt);
+    }
+    const output = fmt === 'mcp' ? { tools: Object.values(schema) } : schema;
+    console.log(JSON.stringify(output, null, 2));
+}
+function cmdServe(_args) {
+    const { serve } = require('./serve');
+    serve();
+}
+// ── Schema builder ────────────────────────────────────────────────────────────
+function buildSchema(name, script, fmt) {
+    const properties = {};
+    const requiredArgs = [];
+    for (const [argName, arg] of Object.entries(script.args ?? {})) {
+        properties[argName] = argToJsonSchema(arg);
+        if (arg.required)
+            requiredArgs.push(argName);
+    }
+    const schema = {
+        name,
+        description: script.description ?? '',
+        'x-autonomy': script.autonomy ?? 'confirm',
+        'x-output': script.output ?? 'text',
+        inputSchema: { type: 'object', properties },
+    };
+    if (requiredArgs.length)
+        schema['inputSchema']['required'] = requiredArgs;
+    if (script.autonomyReason)
+        schema['x-autonomy-reason'] = script.autonomyReason;
+    return schema;
+}
+function argToJsonSchema(arg) {
+    const typeMap = {
+        str: 'string',
+        int: 'integer',
+        float: 'number',
+        bool: 'boolean',
+        flag: 'boolean',
+        path: 'string',
+        choice: 'string',
+    };
+    let prop = { type: typeMap[arg.type ?? 'str'] ?? 'string' };
+    if (arg.description)
+        prop['description'] = arg.description;
+    if (arg.default !== undefined && arg.default !== null)
+        prop['default'] = arg.default;
+    if (arg.options)
+        prop['enum'] = arg.options;
+    if (arg.range) {
+        prop['minimum'] = arg.range[0];
+        prop['maximum'] = arg.range[1];
+    }
+    if (arg.multiple)
+        prop = { type: 'array', items: prop };
+    return prop;
+}
+// ── Discovery ─────────────────────────────────────────────────────────────────
+function discoverLocal() {
+    try {
+        const { configPath, format } = (0, finder_1.findConfig)(process.cwd());
+        const raw = (0, loader_1.loadRaw)(configPath, format);
+        return Object.entries(raw.runnables).map(([name, spec]) => ({ source: configPath, runnable: name, spec }));
+    }
+    catch {
+        return [];
+    }
+}
+function emitAll(discovered, fmt) {
+    const tools = discovered.map((item) => buildSchema(item.runnable, item.spec, fmt));
+    if (fmt === 'mcp')
+        return { tools };
+    return Object.fromEntries(tools.map((t) => [t['name'], t]));
+}
+function printDiscoverText(discovered) {
+    const bySource = {};
+    for (const item of discovered) {
+        (bySource[item.source] ??= []).push(item.runnable);
+    }
+    console.log(`Found ${discovered.length} runspec-aware runnable(s):\n`);
+    for (const [source, runnables] of Object.entries(bySource)) {
+        console.log(`  ${source}`);
+        for (const r of runnables)
+            console.log(`    • ${r}`);
+    }
+    console.log();
+    console.log("Run 'runspec discover --format mcp' to emit MCP tool schemas.");
+}
+// ── Init helpers ──────────────────────────────────────────────────────────────
+function sanitizeName(raw) {
+    const s = raw.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+    return s || 'myscript';
+}
+function initPyproject(filePath, name) {
+    if (fs.existsSync(filePath)) {
+        const original = fs.readFileSync(filePath, 'utf-8');
+        let data;
+        try {
+            const { parse } = require('smol-toml');
+            data = parse(original);
+        }
+        catch (e) {
+            console.log(`✗  Could not read ${path.basename(filePath)}: ${e.message}`);
+            process.exit(1);
+        }
+        if ('runspec' in (data?.tool ?? {})) {
+            const existing = Object.keys(data.tool.runspec).filter((k) => k !== 'config' && typeof data.tool.runspec[k] === 'object');
+            console.log(`✗  ${path.basename(filePath)} already has [tool.runspec] — already initialized`);
+            if (existing.length)
+                console.log(`   Existing runnables: ${existing.join(', ')}`);
+            process.exit(1);
+        }
+        const content = original.trimEnd() + '\n\n' + pyprojectBlock(name);
+        writeAndVerify(filePath, content, original);
+        console.log(`  ✓  Updated ${path.basename(filePath)} with [${name}] runnable`);
+    }
+    else {
+        const content = pyprojectBlock(name);
+        writeAndVerify(filePath, content, null);
+        console.log(`  ✓  Created ${path.basename(filePath)} with [${name}] runnable`);
+    }
+    console.log("     Run 'runspec check' to validate.");
+}
+function initRunspecToml(filePath, name) {
+    if (fs.existsSync(filePath)) {
+        console.log(`✗  ${path.basename(filePath)} already exists — already initialized`);
+        console.log(`   Edit ${path.basename(filePath)} directly to add more runnables.`);
+        process.exit(1);
+    }
+    writeAndVerify(filePath, runspecTomlBlock(name), null);
+    console.log(`  ✓  Created ${path.basename(filePath)} with [${name}] runnable`);
+    console.log("     Run 'runspec check' to validate.");
+}
+function pyprojectBlock(name) {
+    return `[tool.runspec.${name}]\ndescription = "Describe what ${name} does"\nautonomy    = "confirm"\n\n[tool.runspec.${name}.args]\n# example = {type = "str", description = "An example argument"}\n`;
+}
+function runspecTomlBlock(name) {
+    return `[${name}]\ndescription = "Describe what ${name} does"\nautonomy    = "confirm"\n\n[${name}.args]\n# example = {type = "str", description = "An example argument"}\n`;
+}
+function writeAndVerify(filePath, content, original) {
+    fs.writeFileSync(filePath, content, 'utf-8');
+    try {
+        const { parse } = require('smol-toml');
+        parse(content);
+    }
+    catch (e) {
+        if (original !== null)
+            fs.writeFileSync(filePath, original, 'utf-8');
+        else
+            fs.unlinkSync(filePath);
+        console.log('✗  Generated invalid TOML — this is a bug, please report it');
+        console.log(`   ${e.message}`);
+        process.exit(1);
+    }
+}
+// ── Arg parser helper ─────────────────────────────────────────────────────────
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx !== -1 && idx + 1 < args.length)
+        return args[idx + 1];
+    return undefined;
+}
+// ── Help ──────────────────────────────────────────────────────────────────────
+function printHelp() {
+    console.log(`runspec — interface specification for anything runnable
+
+Usage:
+  runspec <command> [options]
+
+Commands:
+  init        Create or update pyproject.toml or runspec.toml with a scaffold
+  discover    Find all runspec-aware runnables in this environment
+  check       Validate this project's runspec setup
+  emit        Emit tool schemas for agent frameworks
+  serve       Start the MCP stdio server for this environment
+
+Options for init:
+  --name      Runnable name (default: current directory name)
+  --file      Target file: pyproject or runspec (auto-detected if omitted)
+
+Options for discover:
+  --format    Output format: text (default), json, mcp, openai, anthropic
+
+Options for emit:
+  --script    Runnable name to emit (all runnables if omitted)
+  --format    Output format: mcp (default), openai, anthropic
+
+Examples:
+  runspec init
+  runspec init --name myapp
+  runspec discover
+  runspec discover --format mcp
+  runspec check
+  runspec emit --script deploy --format mcp
+  runspec emit --format openai`);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+export declare class RunSpecError extends Error {
+    constructor(message: string);
+}
+export declare class MissingRequiredArg extends RunSpecError {
+}
+export declare class InvalidChoice extends RunSpecError {
+}
+export declare class OutOfRange extends RunSpecError {
+}
+export declare class UnknownArg extends RunSpecError {
+}
+export declare class GroupViolation extends RunSpecError {
+}
+export declare class AutonomyViolation extends RunSpecError {
+}
+export declare function formatMissingRequired(name: string, spec: Record<string, unknown>): string;
+export declare function formatInvalidChoice(value: string, options: string[], name: string): string;
+export declare function formatOutOfRange(value: number, range: [number, number], name: string): string;
+export declare function formatUnknownArg(name: string, knownArgs: string[]): string;
+export declare function formatGroupExclusive(groupName: string, provided: string[]): string;
+export declare function formatGroupInclusive(groupName: string, missing: string[]): string;
+export declare function formatGroupAtLeastOne(groupName: string, args: string[]): string;
+export declare function formatGroupExactlyOne(groupName: string, args: string[], provided: string[]): string;
+export declare function formatDeprecated(name: string, message: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,aAAc,SAAQ,YAAY;CAAG;AAClD,qBAAa,UAAW,SAAQ,YAAY;CAAG;AAC/C,qBAAa,UAAW,SAAQ,YAAY;CAAG;AAC/C,qBAAa,cAAe,SAAQ,YAAY;CAAG;AACnD,qBAAa,iBAAkB,SAAQ,YAAY;CAAG;AAEtD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQzF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAS1F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM7F;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ1E;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAMlF;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAMjF;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAK/E;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAYnG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/dist/errors.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutonomyViolation = exports.GroupViolation = exports.UnknownArg = exports.OutOfRange = exports.InvalidChoice = exports.MissingRequiredArg = exports.RunSpecError = void 0;
+exports.formatMissingRequired = formatMissingRequired;
+exports.formatInvalidChoice = formatInvalidChoice;
+exports.formatOutOfRange = formatOutOfRange;
+exports.formatUnknownArg = formatUnknownArg;
+exports.formatGroupExclusive = formatGroupExclusive;
+exports.formatGroupInclusive = formatGroupInclusive;
+exports.formatGroupAtLeastOne = formatGroupAtLeastOne;
+exports.formatGroupExactlyOne = formatGroupExactlyOne;
+exports.formatDeprecated = formatDeprecated;
+class RunSpecError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RunSpecError';
+    }
+}
+exports.RunSpecError = RunSpecError;
+class MissingRequiredArg extends RunSpecError {
+}
+exports.MissingRequiredArg = MissingRequiredArg;
+class InvalidChoice extends RunSpecError {
+}
+exports.InvalidChoice = InvalidChoice;
+class OutOfRange extends RunSpecError {
+}
+exports.OutOfRange = OutOfRange;
+class UnknownArg extends RunSpecError {
+}
+exports.UnknownArg = UnknownArg;
+class GroupViolation extends RunSpecError {
+}
+exports.GroupViolation = GroupViolation;
+class AutonomyViolation extends RunSpecError {
+}
+exports.AutonomyViolation = AutonomyViolation;
+function formatMissingRequired(name, spec) {
+    const lines = [
+        `✗  Missing required argument: --${name}`,
+        `   Type: ${spec['type'] ?? 'str'}`,
+    ];
+    if (spec['description'])
+        lines.push(`   Description: ${spec['description']}`);
+    if (spec['env'])
+        lines.push(`   Tip: set environment variable ${spec['env']} as an alternative`);
+    return lines.join('\n');
+}
+function formatInvalidChoice(value, options, name) {
+    const lines = [
+        `✗  Invalid value for --${name}: ${JSON.stringify(value)}`,
+        `   Expected one of: ${options.join(', ')}`,
+        `   Got: ${JSON.stringify(value)}`,
+    ];
+    const s = suggest(value, options);
+    if (s)
+        lines.push(`\n   Did you mean: ${s}?`);
+    return lines.join('\n');
+}
+function formatOutOfRange(value, range, name) {
+    return [
+        `✗  Value out of range for --${name}: ${value}`,
+        `   Expected: between ${range[0]} and ${range[1]}`,
+        `   Got: ${value}`,
+    ].join('\n');
+}
+function formatUnknownArg(name, knownArgs) {
+    const lines = [
+        `✗  Unknown argument: --${name}`,
+        `   Known arguments: ${[...knownArgs].sort().map((a) => `--${a}`).join(', ')}`,
+    ];
+    const s = suggest(name, knownArgs);
+    if (s)
+        lines.push(`\n   Did you mean: --${s}?`);
+    return lines.join('\n');
+}
+function formatGroupExclusive(groupName, provided) {
+    return [
+        `✗  Conflicting arguments in group '${groupName}'`,
+        `   --${provided[0]} and --${provided[1]} cannot be used together`,
+        `   Choose one or the other`,
+    ].join('\n');
+}
+function formatGroupInclusive(groupName, missing) {
+    return [
+        `✗  Incomplete argument group '${groupName}'`,
+        `   Providing one of these args requires all of them`,
+        `   Also provide: ${missing.map((m) => `--${m}`).join(' and ')}`,
+    ].join('\n');
+}
+function formatGroupAtLeastOne(groupName, args) {
+    return [
+        `✗  Group '${groupName}' requires at least one argument`,
+        `   Provide at least one of: ${args.map((a) => `--${a}`).join(', ')}`,
+    ].join('\n');
+}
+function formatGroupExactlyOne(groupName, args, provided) {
+    if (!provided.length) {
+        return [
+            `✗  Group '${groupName}' requires exactly one argument`,
+            `   Provide exactly one of: ${args.map((a) => `--${a}`).join(', ')}`,
+        ].join('\n');
+    }
+    return [
+        `✗  Group '${groupName}' requires exactly one argument`,
+        `   Got ${provided.length}: ${provided.map((a) => `--${a}`).join(', ')}`,
+        `   Provide exactly one of: ${args.map((a) => `--${a}`).join(', ')}`,
+    ].join('\n');
+}
+function formatDeprecated(name, message) {
+    return `⚠  --${name} is deprecated: ${message}`;
+}
+function suggest(value, candidates) {
+    let best;
+    let bestScore = 0;
+    for (const c of candidates) {
+        const score = diceSimilarity(value, c);
+        if (score > bestScore && score >= 0.6) {
+            bestScore = score;
+            best = c;
+        }
+    }
+    return best;
+}
+function diceSimilarity(a, b) {
+    if (a === b)
+        return 1;
+    if (a.length < 2 || b.length < 2)
+        return 0;
+    const bigrams = new Map();
+    for (let i = 0; i < a.length - 1; i++) {
+        const bg = a.slice(i, i + 2);
+        bigrams.set(bg, (bigrams.get(bg) ?? 0) + 1);
+    }
+    let intersect = 0;
+    for (let i = 0; i < b.length - 1; i++) {
+        const bg = b.slice(i, i + 2);
+        const count = bigrams.get(bg) ?? 0;
+        if (count > 0) {
+            bigrams.set(bg, count - 1);
+            intersect++;
+        }
+    }
+    return (2 * intersect) / (a.length + b.length - 2);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/finder.d.ts

@@ -0,0 +1,6 @@
+export declare function findConfig(start?: string): {
+    configPath: string;
+    format: 'pyproject' | 'runspec';
+};
+export declare function findScriptName(configPath: string, format: 'pyproject' | 'runspec'): string | undefined;
+//# sourceMappingURL=finder.d.ts.map

package/dist/finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.d.ts","sourceRoot":"","sources":["../src/finder.ts"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,CAsBlG;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAoBtG"}