runspec-node 0.3.0

package/dist/finder.js

@@ -0,0 +1,91 @@
+"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.findConfig = findConfig;
+exports.findScriptName = findScriptName;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const smol_toml_1 = require("smol-toml");
+function findConfig(start) {
+    let dir = path.resolve(start ?? process.cwd());
+    while (true) {
+        const pyproject = path.join(dir, 'pyproject.toml');
+        if (fs.existsSync(pyproject) && hasRunspecSection(pyproject)) {
+            return { configPath: pyproject, format: 'pyproject' };
+        }
+        const runspecToml = path.join(dir, 'runspec.toml');
+        if (fs.existsSync(runspecToml)) {
+            return { configPath: runspecToml, format: 'runspec' };
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error("No runspec configuration found.\nExpected one of:\n  - pyproject.toml with [tool.runspec] section\n  - runspec.toml\n\nRun 'runspec check' to validate your project setup.");
+}
+function findScriptName(configPath, format) {
+    if (format !== 'pyproject')
+        return undefined;
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const data = (0, smol_toml_1.parse)(content);
+        const argv1 = process.argv[1] ?? '';
+        const caller = path.basename(argv1, path.extname(argv1));
+        if (!caller)
+            return undefined;
+        const projectScripts = data?.project?.scripts ?? {};
+        if (caller in projectScripts)
+            return caller;
+        const poetryScripts = data?.tool?.poetry?.scripts ?? {};
+        if (caller in poetryScripts)
+            return caller;
+        return caller;
+    }
+    catch {
+        return undefined;
+    }
+}
+function hasRunspecSection(pyprojectPath) {
+    try {
+        const content = fs.readFileSync(pyprojectPath, 'utf-8');
+        const data = (0, smol_toml_1.parse)(content);
+        return 'runspec' in (data?.tool ?? {});
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=finder.js.map

package/dist/finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.js","sourceRoot":"","sources":["../src/finder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,gCAsBC;AAED,wCAoBC;AAhDD,uCAAyB;AACzB,2CAA6B;AAC7B,yCAA+C;AAE/C,SAAgB,UAAU,CAAC,KAAc;IACvC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE/C,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACnD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACxD,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACnD,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACxD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,MAAM,IAAI,KAAK,CACb,4KAA4K,CAC7K,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAAC,UAAkB,EAAE,MAA+B;IAChF,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAA,iBAAS,EAAC,OAAO,CAA4B,CAAC;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAE9B,MAAM,cAAc,GAAI,IAAY,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QAC7D,IAAI,MAAM,IAAI,cAAc;YAAE,OAAO,MAAM,CAAC;QAE5C,MAAM,aAAa,GAAI,IAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;QACjE,IAAI,MAAM,IAAI,aAAa;YAAE,OAAO,MAAM,CAAC;QAE3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,aAAqB;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,IAAA,iBAAS,EAAC,OAAO,CAA4B,CAAC;QAC3D,OAAO,SAAS,IAAI,CAAE,IAAY,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { parse, loadSpec } from './parser';
+export { registerType, listTypes } from './types';
+export { RunSpecError, MissingRequiredArg, InvalidChoice, OutOfRange, UnknownArg, GroupViolation, AutonomyViolation } from './errors';
+export { findConfig } from './finder';
+export { loadRaw } from './loader';
+export type { ParsedArgs, ScriptSpec, ArgSpec, GroupSpec, RawSpec, RawConfig } from './models';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACtI,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadRaw = exports.findConfig = exports.AutonomyViolation = exports.GroupViolation = exports.UnknownArg = exports.OutOfRange = exports.InvalidChoice = exports.MissingRequiredArg = exports.RunSpecError = exports.listTypes = exports.registerType = exports.loadSpec = exports.parse = void 0;
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parse", { enumerable: true, get: function () { return parser_1.parse; } });
+Object.defineProperty(exports, "loadSpec", { enumerable: true, get: function () { return parser_1.loadSpec; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "registerType", { enumerable: true, get: function () { return types_1.registerType; } });
+Object.defineProperty(exports, "listTypes", { enumerable: true, get: function () { return types_1.listTypes; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "RunSpecError", { enumerable: true, get: function () { return errors_1.RunSpecError; } });
+Object.defineProperty(exports, "MissingRequiredArg", { enumerable: true, get: function () { return errors_1.MissingRequiredArg; } });
+Object.defineProperty(exports, "InvalidChoice", { enumerable: true, get: function () { return errors_1.InvalidChoice; } });
+Object.defineProperty(exports, "OutOfRange", { enumerable: true, get: function () { return errors_1.OutOfRange; } });
+Object.defineProperty(exports, "UnknownArg", { enumerable: true, get: function () { return errors_1.UnknownArg; } });
+Object.defineProperty(exports, "GroupViolation", { enumerable: true, get: function () { return errors_1.GroupViolation; } });
+Object.defineProperty(exports, "AutonomyViolation", { enumerable: true, get: function () { return errors_1.AutonomyViolation; } });
+var finder_1 = require("./finder");
+Object.defineProperty(exports, "findConfig", { enumerable: true, get: function () { return finder_1.findConfig; } });
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "loadRaw", { enumerable: true, get: function () { return loader_1.loadRaw; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAA2C;AAAlC,+FAAA,KAAK,OAAA;AAAE,kGAAA,QAAQ,OAAA;AACxB,iCAAkD;AAAzC,qGAAA,YAAY,OAAA;AAAE,kGAAA,SAAS,OAAA;AAChC,mCAAsI;AAA7H,sGAAA,YAAY,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AACnH,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,mCAAmC;AAA1B,iGAAA,OAAO,OAAA"}

package/dist/inference.d.ts

@@ -0,0 +1,10 @@
+import type { ArgSpec, ScriptSpec } from './models';
+export declare const AUTONOMY_LEVELS: readonly ["autonomous", "confirm", "supervised", "manual"];
+export declare const AUTONOMY_RANK: {
+    [k: string]: number;
+};
+export declare function inferArg(raw: ArgSpec): ArgSpec;
+export declare function inferScript(raw: ScriptSpec, configAutonomy: string): ScriptSpec;
+export declare function effectiveAutonomy(scriptAutonomy: string, providedArgs: Record<string, unknown>, argSpecs: Record<string, ArgSpec>): string;
+export declare function isMoreRestrictive(candidate: string, current: string): boolean;
+//# sourceMappingURL=inference.d.ts.map

package/dist/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../src/inference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGpD,eAAO,MAAM,eAAe,4DAA6D,CAAC;AAC1F,eAAO,MAAM,aAAa;;CAA4D,CAAC;AAEvF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA+B9C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,GAAG,UAAU,CAc/E;AAED,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAaR;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7E"}

package/dist/inference.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTONOMY_RANK = exports.AUTONOMY_LEVELS = void 0;
+exports.inferArg = inferArg;
+exports.inferScript = inferScript;
+exports.effectiveAutonomy = effectiveAutonomy;
+exports.isMoreRestrictive = isMoreRestrictive;
+const errors_1 = require("./errors");
+exports.AUTONOMY_LEVELS = ['autonomous', 'confirm', 'supervised', 'manual'];
+exports.AUTONOMY_RANK = Object.fromEntries(exports.AUTONOMY_LEVELS.map((l, i) => [l, i]));
+function inferArg(raw) {
+    const result = { ...raw };
+    const def = result.default;
+    const options = result.options;
+    if (!result.type) {
+        if (options !== undefined) {
+            result.type = 'choice';
+        }
+        else if (typeof def === 'boolean') {
+            result.type = 'flag';
+        }
+        else if (typeof def === 'number' && Number.isInteger(def)) {
+            result.type = 'int';
+        }
+        else if (typeof def === 'number') {
+            result.type = 'float';
+        }
+        else if (typeof def === 'string') {
+            result.type = 'str';
+        }
+        else {
+            result.type = 'str';
+        }
+    }
+    if (result.required === undefined) {
+        const hasNoDefault = def === undefined || def === null;
+        result.required = hasNoDefault && result.type !== 'flag';
+    }
+    if (result.type === 'choice' && (!options || options.length === 0)) {
+        throw new errors_1.RunSpecError(`Argument '${raw.name}' has type 'choice' but no 'options' list was provided.`);
+    }
+    return result;
+}
+function inferScript(raw, configAutonomy) {
+    const result = { ...raw };
+    if (!result.autonomy) {
+        result.autonomy = configAutonomy;
+    }
+    result.args = Object.fromEntries(Object.entries(result.args ?? {}).map(([name, arg]) => [name, inferArg(arg)]));
+    result.commands = Object.fromEntries(Object.entries(result.commands ?? {}).map(([name, cmd]) => [name, inferScript(cmd, configAutonomy)]));
+    return result;
+}
+function effectiveAutonomy(scriptAutonomy, providedArgs, argSpecs) {
+    let effective = scriptAutonomy;
+    for (const [argName, value] of Object.entries(providedArgs)) {
+        if (value === null || value === undefined)
+            continue;
+        const spec = argSpecs[argName];
+        const argAutonomy = spec?.autonomy;
+        if (argAutonomy && isMoreRestrictive(argAutonomy, effective)) {
+            effective = argAutonomy;
+        }
+    }
+    return effective;
+}
+function isMoreRestrictive(candidate, current) {
+    return (exports.AUTONOMY_RANK[candidate] ?? 0) > (exports.AUTONOMY_RANK[current] ?? 0);
+}
+//# sourceMappingURL=inference.js.map

package/dist/inference.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,3 @@
+import type { RawSpec } from './models';
+export declare function loadRaw(configPath: string, format: 'pyproject' | 'runspec'): RawSpec;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAa,OAAO,EAAkC,MAAM,UAAU,CAAC;AAEnF,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CA0BpF"}

package/dist/loader.js

@@ -0,0 +1,142 @@
+"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.loadRaw = loadRaw;
+const fs = __importStar(require("fs"));
+const smol_toml_1 = require("smol-toml");
+function loadRaw(configPath, format) {
+    const content = fs.readFileSync(configPath, 'utf-8');
+    const data = (0, smol_toml_1.parse)(content);
+    let raw;
+    let entryPoints = {};
+    if (format === 'pyproject') {
+        raw = (data?.tool?.runspec ?? {});
+        entryPoints = readEntryPoints(data);
+    }
+    else {
+        raw = data;
+    }
+    const runnablesRaw = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (key !== 'config' && typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            runnablesRaw[key] = value;
+        }
+    }
+    return {
+        config: normaliseConfig((raw['config'] ?? {})),
+        runnables: normaliseRunnables(runnablesRaw),
+        entryPoints,
+    };
+}
+function normaliseConfig(raw) {
+    return {
+        autonomyDefault: raw['autonomy-default'] ?? 'confirm',
+        lang: raw['lang'],
+        version: String(raw['version'] ?? '1'),
+    };
+}
+function normaliseRunnables(raw) {
+    return Object.fromEntries(Object.entries(raw).map(([name, data]) => [name, normaliseScript(name, data)]));
+}
+function normaliseScript(name, raw) {
+    return {
+        name,
+        description: raw['description'],
+        autonomy: raw['autonomy'],
+        autonomyReason: raw['autonomy-reason'],
+        output: raw['output'],
+        args: normaliseArgs((raw['args'] ?? {})),
+        groups: normaliseGroups((raw['groups'] ?? {})),
+        commands: normaliseCommands((raw['commands'] ?? {})),
+    };
+}
+function normaliseArgs(raw) {
+    return Object.fromEntries(Object.entries(raw).map(([name, value]) => {
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            return [name, normaliseArg(name, value)];
+        }
+        return [name, normaliseArg(name, { default: value })];
+    }));
+}
+function normaliseArg(name, raw) {
+    return {
+        name,
+        type: raw['type'] ?? undefined,
+        required: raw['required'],
+        default: raw['default'],
+        description: raw['description'],
+        options: raw['options'],
+        range: raw['range'],
+        multiple: raw['multiple'] ?? false,
+        delimiter: raw['delimiter'],
+        short: raw['short'],
+        env: raw['env'],
+        deprecated: raw['deprecated'],
+        autonomy: raw['autonomy'],
+        ui: raw['ui'],
+        meta: raw['meta'],
+    };
+}
+function normaliseGroups(raw) {
+    return Object.fromEntries(Object.entries(raw).map(([name, data]) => {
+        const g = data;
+        return [
+            name,
+            {
+                name,
+                args: g['args'] ?? [],
+                exclusive: g['exclusive'] ?? false,
+                inclusive: g['inclusive'] ?? false,
+                atLeastOne: g['at-least-one'] ?? false,
+                exactlyOne: g['exactly-one'] ?? false,
+                condition: g['if'],
+                requires: g['requires'] ?? [],
+            },
+        ];
+    }));
+}
+function normaliseCommands(raw) {
+    return Object.fromEntries(Object.entries(raw).map(([name, data]) => [name, normaliseScript(name, data)]));
+}
+function readEntryPoints(data) {
+    const projectScripts = data?.project?.scripts;
+    if (projectScripts && typeof projectScripts === 'object')
+        return projectScripts;
+    const poetryScripts = data?.tool?.poetry?.scripts;
+    if (poetryScripts && typeof poetryScripts === 'object')
+        return poetryScripts;
+    return {};
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,57 @@
+export interface RawConfig {
+    autonomyDefault: string;
+    lang?: string;
+    version: string;
+}
+export interface ArgSpec {
+    name: string;
+    type?: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    options?: string[];
+    range?: [number, number];
+    multiple?: boolean;
+    delimiter?: string;
+    short?: string;
+    env?: string;
+    deprecated?: string;
+    autonomy?: string;
+    ui?: string;
+    meta?: Record<string, unknown>;
+}
+export interface GroupSpec {
+    name: string;
+    args: string[];
+    exclusive?: boolean;
+    inclusive?: boolean;
+    atLeastOne?: boolean;
+    exactlyOne?: boolean;
+    condition?: string;
+    requires?: string[];
+}
+export interface ScriptSpec {
+    name: string;
+    description?: string;
+    autonomy?: string;
+    autonomyReason?: string;
+    output?: string;
+    args: Record<string, ArgSpec>;
+    groups: Record<string, GroupSpec>;
+    commands: Record<string, ScriptSpec>;
+}
+export interface RawSpec {
+    config: RawConfig;
+    runnables: Record<string, ScriptSpec>;
+    entryPoints: Record<string, string>;
+}
+export interface ParsedArgs {
+    [key: string]: unknown;
+    readonly __agent__: boolean;
+    readonly __script__: string;
+    readonly __command__: string | undefined;
+    readonly __autonomy__: string;
+    readonly __source__: string;
+    readonly __spec__: ScriptSpec;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;CAC/B"}

package/dist/models.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":""}

package/dist/parser.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedArgs, ScriptSpec } from './models';
+export interface ParseOptions {
+    scriptName?: string;
+    argv?: string[];
+    cwd?: string;
+}
+export declare function parse(opts?: ParseOptions): ParsedArgs;
+export declare function loadSpec(opts?: ParseOptions): ParsedArgs;
+export declare function printHelp(name: string, script: ScriptSpec, command?: string): void;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAW,MAAM,UAAU,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,KAAK,CAAC,IAAI,GAAE,YAAiB,GAAG,UAAU,CA4DzD;AAED,wBAAgB,QAAQ,CAAC,IAAI,GAAE,YAAiB,GAAG,UAAU,CAE5D;AAsHD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAyClF"}