@miakapp/cli 4.0.0-alpha.3 → 4.0.0-alpha.5

package/dist/internal/yaml.js

@@ -0,0 +1,184 @@
+import { projectError } from '../errors.js';
+const KEY = /^[A-Za-z_][A-Za-z0-9_-]*$/;
+const NUMBER = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/;
+const FORBIDDEN_KEYS = new Set(['__proto__', 'prototype', 'constructor']);
+const MAXIMUM_LINES = 2_048;
+const MAXIMUM_DEPTH = 8;
+function fail(line, message) {
+    throw projectError(`miakapp.yaml line ${line}: ${message}`);
+}
+function stripComment(raw, number) {
+    let quote;
+    for (let index = 0; index < raw.length; index += 1) {
+        const character = raw[index];
+        if (quote !== undefined) {
+            if (character === '\\' && quote === '"')
+                index += 1;
+            else if (character === quote)
+                quote = undefined;
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            quote = character;
+            continue;
+        }
+        if (character === '#' && (index === 0 || /\s/.test(raw[index - 1]))) {
+            return raw.slice(0, index).trimEnd();
+        }
+    }
+    if (quote !== undefined)
+        fail(number, 'unterminated quoted scalar');
+    return raw.trimEnd();
+}
+function readLines(source) {
+    const lines = [];
+    const raw = source.split('\n');
+    if (raw.length > MAXIMUM_LINES) {
+        throw projectError(`miakapp.yaml exceeds ${MAXIMUM_LINES} lines`);
+    }
+    raw.forEach((text, offset) => {
+        const number = offset + 1;
+        if (text.includes('\t'))
+            fail(number, 'tabs are not permitted');
+        if (text.includes('\r'))
+            fail(number, 'carriage returns are not permitted');
+        const content = stripComment(text, number);
+        if (content.trim() === '')
+            return;
+        if (content.trimStart() === '---' || content.trimStart() === '...') {
+            fail(number, 'document markers are not permitted');
+        }
+        const indent = content.length - content.trimStart().length;
+        if (indent % 2 !== 0)
+            fail(number, 'indentation must be a multiple of two spaces');
+        lines.push({ number, indent, content: content.trimStart() });
+    });
+    return lines;
+}
+function parseScalar(text, number) {
+    if (text === '')
+        return '';
+    const first = text[0];
+    if (first === '"' || first === "'") {
+        if (text.length < 2 || !text.endsWith(first))
+            fail(number, 'unterminated quoted scalar');
+        const inner = text.slice(1, -1);
+        if (first === "'") {
+            if (inner.includes("'"))
+                fail(number, "single-quoted escapes are not supported");
+            return inner;
+        }
+        try {
+            const decoded = JSON.parse(text);
+            if (typeof decoded !== 'string')
+                fail(number, 'invalid double-quoted scalar');
+            return decoded;
+        }
+        catch {
+            return fail(number, 'invalid double-quoted scalar');
+        }
+    }
+    if (text === '[]')
+        return [];
+    if ('&*!|>%@`'.includes(first) || first === '[' || first === '{') {
+        fail(number, `the ${first} scalar form is not supported`);
+    }
+    if (text === 'true')
+        return true;
+    if (text === 'false')
+        return false;
+    if (text === 'null' || text === '~')
+        return null;
+    if (NUMBER.test(text)) {
+        const number_ = Number(text);
+        if (!Number.isFinite(number_))
+            fail(number, 'number is not finite');
+        return number_;
+    }
+    if (text.includes(': ') || text.endsWith(':')) {
+        fail(number, 'a plain scalar cannot contain a mapping separator');
+    }
+    return text;
+}
+function parseBlock(lines, from, indent, depth) {
+    if (depth > MAXIMUM_DEPTH) {
+        fail(lines[from].number, `nesting exceeds ${MAXIMUM_DEPTH} levels`);
+    }
+    const first = lines[from];
+    if (first === undefined)
+        fail(0, 'unexpected end of file');
+    if (first.content.startsWith('- ') || first.content === '-') {
+        const items = [];
+        let index = from;
+        while (index < lines.length) {
+            const line = lines[index];
+            if (line.indent < indent)
+                break;
+            if (line.indent > indent)
+                fail(line.number, 'unexpected indentation inside a sequence');
+            if (!line.content.startsWith('- ') && line.content !== '-') {
+                fail(line.number, 'a sequence cannot be mixed with mapping keys');
+            }
+            if (line.content === '-')
+                fail(line.number, 'a sequence item must be a scalar');
+            items.push(parseScalar(line.content.slice(2).trim(), line.number));
+            index += 1;
+        }
+        return { value: items, next: index };
+    }
+    const mapping = Object.create(null);
+    const seen = new Set();
+    let index = from;
+    while (index < lines.length) {
+        const line = lines[index];
+        if (line.indent < indent)
+            break;
+        if (line.indent > indent)
+            fail(line.number, 'unexpected indentation');
+        const separator = line.content.indexOf(':');
+        if (separator === -1)
+            fail(line.number, 'expected a "key: value" mapping entry');
+        const key = line.content.slice(0, separator);
+        if (!KEY.test(key))
+            fail(line.number, `invalid key ${JSON.stringify(key)}`);
+        if (FORBIDDEN_KEYS.has(key))
+            fail(line.number, `the key ${key} is forbidden`);
+        if (seen.has(key))
+            fail(line.number, `duplicate key ${key}`);
+        seen.add(key);
+        const rest = line.content.slice(separator + 1).trim();
+        if (rest !== '') {
+            mapping[key] = parseScalar(rest, line.number);
+            index += 1;
+            continue;
+        }
+        const child = lines[index + 1];
+        if (child === undefined || child.indent <= indent) {
+            mapping[key] = null;
+            index += 1;
+            continue;
+        }
+        if (child.indent !== indent + 2)
+            fail(child.number, 'a nested block indents by two spaces');
+        const block = parseBlock(lines, index + 1, child.indent, depth + 1);
+        mapping[key] = block.value;
+        index = block.next;
+    }
+    return { value: mapping, next: index };
+}
+export function parseYaml(source) {
+    const lines = readLines(source);
+    if (lines.length === 0)
+        throw projectError('miakapp.yaml is empty');
+    const first = lines[0];
+    if (first.indent !== 0)
+        fail(first.number, 'the document must start at column one');
+    const { value, next } = parseBlock(lines, 0, 0, 1);
+    if (next !== lines.length)
+        fail(lines[next].number, 'unexpected trailing content');
+    if (Array.isArray(value) || value === null || typeof value !== 'object') {
+        throw projectError('miakapp.yaml must be a mapping');
+    }
+    return value;
+}
+//# sourceMappingURL=yaml.js.map

package/dist/internal/yaml.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,88 @@
+import { CLI_VERSION } from './version.js';
+import type { FetchLike } from './internal/http.js';
+export { CLI_VERSION };
+/**
+ * The Home Key is read from the environment only. A secret passed as an
+ * argument would land in shell history, in a process listing and in most CI
+ * logs, so no command accepts one.
+ */
+export declare const HOME_KEY_VARIABLE = "MIAKAPP_HOME_KEY";
+export interface FileSystem {
+    read(path: string): Promise<Uint8Array>;
+    /** Creates. Fails if the path exists: no command may clobber by accident. */
+    write(path: string, bytes: Uint8Array): Promise<void>;
+    /**
+     * Creates or overwrites.
+     *
+     * Separate from {@link FileSystem.write} so overwriting is never the default
+     * a command falls into. Only `agent-pack` calls it, and only after merging
+     * the existing bytes, so what it replaces is a file it generated.
+     */
+    replace(path: string, bytes: Uint8Array): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    /** Creates the directory and its parents. Succeeds if it already exists. */
+    makeDirectory(path: string): Promise<void>;
+}
+export interface CliHost {
+    write(text: string): void;
+    writeError(text: string): void;
+    cwd(): string;
+    env(name: string): string | undefined;
+    /** Injected by tests; defaults to `node:fs/promises`. */
+    files?: FileSystem;
+    /** Injected by tests; defaults to the platform `fetch`. */
+    fetch?: FetchLike;
+    /** Read only by `mcp`, which serves a request stream instead of one command. */
+    input?: AsyncIterable<Uint8Array>;
+}
+type Field = readonly [key: string, value: string | number | readonly string[]];
+export interface CommandResult {
+    readonly summary: string;
+    readonly fields: readonly Field[];
+    readonly json: Record<string, unknown>;
+    /** Complete human-facing document for commands such as `docs start`. */
+    readonly text?: string;
+}
+export interface Invocation {
+    readonly command: string;
+    readonly options: ReadonlyMap<string, string>;
+    readonly flags: ReadonlySet<string>;
+    readonly positional: readonly string[];
+}
+/** Exported so the MCP surface can be proved to expose every option, and no other. */
+export declare const COMMAND_OPTIONS: Record<string, readonly string[]>;
+/**
+ * Parses `--name value`, `--name=value` and bare flags.
+ *
+ * Options are a closed set per command: an unrecognized one is a usage error
+ * rather than a silently ignored argument, so a mistyped flag can never turn a
+ * publication into a different publication.
+ */
+export declare function parseArguments(argv: readonly string[]): Invocation;
+/**
+ * Absolute path of the guide shipped with this package.
+ *
+ * Resolved from this module rather than from the working directory: the pack is
+ * installed into someone else's repository, and the guide has to come from the
+ * installed CLI wherever that repository happens to be.
+ *
+ * Exported so a test reads the same path the command does. A test that seeded a
+ * fixture at a path the command never opens would prove nothing.
+ */
+export declare function guideAssetPath(): Promise<string>;
+/**
+ * Runs one parsed invocation.
+ *
+ * Exported for `mcp`, which reaches the same commands without a process: a
+ * tool call and a command line must not be able to diverge.
+ */
+export declare function dispatch(host: CliHost, invocation: Invocation): Promise<CommandResult>;
+/**
+ * Runs one invocation and returns its exit code.
+ *
+ * Nothing throws out of this function: an unexpected error becomes
+ * `unknown_outcome`, because a CLI that crashed mid-publication cannot claim
+ * the control plane was left untouched.
+ */
+export declare function run(argv: readonly string[], host: CliHost): Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAY3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAYpD,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,6EAA6E;IAC7E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,4EAA4E;IAC5E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,IAAI,MAAM,CAAC;IACd,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,yDAAyD;IACzD,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,gFAAgF;IAChF,KAAK,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACnC;AAED,KAAK,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAkED,sFAAsF;AACtF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAc7D,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAsDlE;AAqMD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAGtD;AAyRD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAwB5F;AAyBD;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDjF"}