@kruntime/komputer 0.1.0

package/dist/shell/runtime.d.ts

@@ -0,0 +1,44 @@
+import type { ShellCommandSegment, ShellWordToken } from '../vbash.js';
+export interface ShellRedirects {
+    script: string;
+    stdin?: string;
+    stdinText?: string;
+    ops: ShellRedirectOp[];
+}
+export type RuntimeShellSegment = ShellCommandSegment & {
+    env?: Record<string, string>;
+    assignmentOnly?: boolean;
+};
+export interface ShellOptions {
+    errexit: boolean;
+    nounset: boolean;
+    pipefail: boolean;
+}
+export type ShellRedirectOp = {
+    fd: 'stdout';
+    path: string;
+    append: boolean;
+} | {
+    fd: 'stderr';
+    path: string;
+    append: boolean;
+} | {
+    fd: 'stderr';
+    to: 'stdout';
+};
+export declare function shellArgsToInput(args: string[]): Record<string, unknown>;
+export declare function commandResultToShellResult(value: unknown): {
+    stdout: string;
+    stderr: string;
+    code: number;
+};
+export declare function parseShellRedirects(script: string): ShellRedirects | undefined;
+export declare function quoteShellWord(value: string): string;
+export declare function isShellIdentifier(value: string): boolean;
+export declare function isShellAssignmentToken(token: ShellWordToken): boolean;
+export declare function shellWordToken(value: string): ShellWordToken;
+export declare function shellExitCode(result: Record<string, unknown>): number;
+export declare function recordStringMap(value: unknown): Record<string, string>;
+export declare function commandHelpText(name: string, command: {
+    help?: unknown;
+}): string;

package/dist/shell/runtime.js

@@ -0,0 +1,276 @@
+import { parseShellTokens, stripShellCommandSubstitutions } from "../vbash.js";
+export function shellArgsToInput(args) {
+    const input = { argv: args };
+    for (const arg of args) {
+        const index = arg.indexOf('=');
+        if (index > 0)
+            input[arg.slice(0, index)] = arg.slice(index + 1);
+    }
+    return input;
+}
+export function commandResultToShellResult(value) {
+    if (typeof value === 'string')
+        return { stdout: value, stderr: '', code: 0 };
+    if (value && typeof value === 'object') {
+        const record = value;
+        const code = typeof record.code === 'number'
+            ? record.code
+            : record.status === 'failed'
+                ? 1
+                : 0;
+        if (record.type === 'stdout' && typeof record.text === 'string')
+            return { stdout: record.text, stderr: '', code };
+        if (record.type === 'stderr' && typeof record.text === 'string')
+            return { stdout: '', stderr: record.text, code: code || 1 };
+        if (record.type === 'json')
+            return { stdout: `${JSON.stringify(record.value)}\n`, stderr: '', code };
+        if (typeof record.text === 'string')
+            return { stdout: record.text, stderr: '', code };
+        if (typeof record.stdout === 'string' || typeof record.stderr === 'string') {
+            return {
+                stdout: typeof record.stdout === 'string' ? record.stdout : '',
+                stderr: typeof record.stderr === 'string' ? record.stderr : '',
+                code,
+            };
+        }
+    }
+    return { stdout: `${JSON.stringify(value, null, 2)}\n`, stderr: '', code: 0 };
+}
+export function parseShellRedirects(script) {
+    const heredoc = extractShellHeredoc(script);
+    const inputScript = heredoc?.script ?? script;
+    if (/[;&|]/.test(stripShellCommandSubstitutions(stripQuotedShell(inputScript)).replaceAll('2>&1', '')))
+        return undefined;
+    const tokens = parseShellTokens(inputScript);
+    const command = [];
+    const redirect = { script: '', stdinText: heredoc?.stdinText, ops: [] };
+    let sawRedirect = Boolean(heredoc);
+    for (let index = 0; index < tokens.length; index += 1) {
+        const token = tokens[index];
+        const word = token.text;
+        if (!token.quoted && (word === '<<' || word === '<<-')) {
+            index += 1;
+            sawRedirect = true;
+            continue;
+        }
+        if (!token.quoted && (word.startsWith('<<') || word.startsWith('<<-'))) {
+            sawRedirect = true;
+            continue;
+        }
+        if (!token.quoted && word === '<') {
+            const path = tokens[++index]?.text;
+            if (!path)
+                return undefined;
+            redirect.stdin = path;
+            sawRedirect = true;
+            continue;
+        }
+        if (!token.quoted && word === '2>&1') {
+            redirect.ops.push({ fd: 'stderr', to: 'stdout' });
+            sawRedirect = true;
+            continue;
+        }
+        if (!token.quoted && (word === '>' || word === '1>' || word === '>>' || word === '1>>')) {
+            const path = tokens[++index]?.text;
+            if (!path)
+                return undefined;
+            redirect.ops.push({ fd: 'stdout', path, append: word.endsWith('>>') });
+            sawRedirect = true;
+            continue;
+        }
+        const attached = !token.quoted ? attachedRedirect(word) : undefined;
+        if (attached?.kind === 'stdin') {
+            redirect.stdin = attached.path;
+            sawRedirect = true;
+            continue;
+        }
+        if (attached?.kind === 'stdout') {
+            redirect.ops.push({ fd: 'stdout', path: attached.path, append: attached.append });
+            sawRedirect = true;
+            continue;
+        }
+        if (attached?.kind === 'stderr') {
+            redirect.ops.push({ fd: 'stderr', path: attached.path, append: attached.append });
+            sawRedirect = true;
+            continue;
+        }
+        if (!token.quoted && (word === '2>' || word === '2>>')) {
+            const path = tokens[++index]?.text;
+            if (!path)
+                return undefined;
+            redirect.ops.push({ fd: 'stderr', path, append: word === '2>>' });
+            sawRedirect = true;
+            continue;
+        }
+        command.push(token);
+    }
+    if (!sawRedirect || !command.length)
+        return undefined;
+    return {
+        ...redirect,
+        script: command.map(commandTokenScript).join(' '),
+    };
+}
+export function quoteShellWord(value) {
+    if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(value))
+        return value;
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+export function isShellIdentifier(value) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(value);
+}
+export function isShellAssignmentToken(token) {
+    if (!isShellAssignment(token.text))
+        return false;
+    const equals = token.text.indexOf('=');
+    let offset = 0;
+    for (const part of token.parts) {
+        const end = offset + part.text.length;
+        if (offset < equals && part.quote)
+            return false;
+        offset = end;
+    }
+    return true;
+}
+export function shellWordToken(value) {
+    return {
+        text: value,
+        parts: [{ text: value }],
+        quoted: false,
+        globbable: true,
+    };
+}
+export function shellExitCode(result) {
+    if (typeof result.code === 'number')
+        return result.code;
+    if (result.background === true && result.status === 'uncertain')
+        return 0;
+    if (result.status === 'committed' || result.status === 'completed')
+        return 0;
+    return 1;
+}
+export function recordStringMap(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    const output = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (isShellIdentifier(key) && typeof entry === 'string')
+            output[key] = entry;
+    }
+    return output;
+}
+export function commandHelpText(name, command) {
+    const text = typeof command.help === 'string' && command.help.trim()
+        ? command.help.trim()
+        : `Usage: ${name} [ARG...]\n\nK image command.`;
+    return text.startsWith('Usage:') ? text : `Usage: ${name} [ARG...]\n\n${text}`;
+}
+function attachedRedirect(word) {
+    if (word.startsWith('<<'))
+        return undefined;
+    const match = word.match(/^(?:(1|2)?(>>?)|<)(.+)$/);
+    if (!match)
+        return undefined;
+    const fd = match[1];
+    const op = match[2];
+    const path = match[3];
+    if (!path)
+        return undefined;
+    if (!op)
+        return { kind: 'stdin', path };
+    return {
+        kind: fd === '2' ? 'stderr' : 'stdout',
+        path,
+        append: op === '>>',
+    };
+}
+function commandTokenScript(word) {
+    if (!word.quoted && word.text.includes('$('))
+        return word.text;
+    if (word.parts.some((part) => part.quote === '"'))
+        return doubleQuoteShellWord(word.text);
+    return quoteShellWord(word.text);
+}
+function doubleQuoteShellWord(value) {
+    return `"${value.replace(/(["\\`])/g, '\\$1')}"`;
+}
+function isShellAssignment(value) {
+    const index = value.indexOf('=');
+    return index > 0 && isShellIdentifier(value.slice(0, index));
+}
+function stripQuotedShell(script) {
+    let output = '';
+    let quote;
+    let escaping = false;
+    for (const char of script) {
+        if (escaping) {
+            escaping = false;
+            continue;
+        }
+        if (char === '\\' && quote !== "'") {
+            escaping = true;
+            continue;
+        }
+        if (quote) {
+            if (char === quote)
+                quote = undefined;
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+            continue;
+        }
+        output += char;
+    }
+    return output;
+}
+function extractShellHeredoc(script) {
+    const firstNewline = script.indexOf('\n');
+    if (firstNewline < 0)
+        return undefined;
+    const commandLine = script.slice(0, firstNewline);
+    const tokens = parseShellTokens(commandLine);
+    const command = [];
+    let delimiter;
+    let stripLeadingTabs = false;
+    for (let index = 0; index < tokens.length; index += 1) {
+        const token = tokens[index];
+        const word = token.text;
+        if (!token.quoted && (word === '<<' || word === '<<-')) {
+            delimiter = tokens[++index]?.text;
+            stripLeadingTabs = word === '<<-';
+            continue;
+        }
+        if (word.startsWith('<<-') && word.length > 3) {
+            delimiter = word.slice(3);
+            stripLeadingTabs = true;
+            continue;
+        }
+        if (word.startsWith('<<') && word.length > 2) {
+            delimiter = word.slice(2);
+            stripLeadingTabs = false;
+            continue;
+        }
+        command.push(token);
+    }
+    if (!delimiter)
+        return undefined;
+    const bodyLines = script.slice(firstNewline + 1).split('\n');
+    const endIndex = bodyLines.findIndex((line) => line === delimiter || (stripLeadingTabs && line.replace(/^\t+/, '') === delimiter));
+    if (endIndex < 0)
+        return undefined;
+    const trailing = bodyLines.slice(endIndex + 1).join('\n');
+    if (trailing.trim())
+        return undefined;
+    const lines = bodyLines.slice(0, endIndex).map((line) => stripLeadingTabs ? line.replace(/^\t+/, '') : line);
+    return {
+        script: command.map(heredocCommandTokenScript).join(' '),
+        stdinText: `${lines.join('\n')}\n`,
+    };
+}
+function heredocCommandTokenScript(word) {
+    if (!word.quoted && /^(?:<|>|1>|2>|>>|1>>|2>>|2>&1)$/.test(word.text))
+        return word.text;
+    return commandTokenScript(word);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/shell/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../../../packages/komputer/src/shell/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAA;AA0B9E,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,KAAK,GAA4B,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACrD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,KAAK,GAAG,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IAC5E,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAC1C,CAAC,CAAC,MAAM,CAAC,IAAI;YACb,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ;gBAC1B,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,CAAC,CAAA;QACP,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACjH,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAA;QAC5H,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACpG,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACrF,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC3E,OAAO;gBACL,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBAC9D,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBAC9D,IAAI;aACL,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAA;IAC7C,IAAI,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACxH,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC5C,MAAM,OAAO,GAAqB,EAAE,CAAA;IACpC,MAAM,QAAQ,GAAmB,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE,CAAA;IACvF,IAAI,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvD,KAAK,IAAI,CAAC,CAAA;YACV,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACvE,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,CAAA;YAClC,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAA;YAC3B,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAA;YACrB,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACrC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;YACjD,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,CAAA;YAClC,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAA;YAC3B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACtE,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACnE,IAAI,QAAQ,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YAC/B,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAA;YAC9B,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,QAAQ,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;YACjF,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,QAAQ,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;YACjF,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,CAAA;YAClC,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAA;YAC3B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,KAAK,KAAK,EAAE,CAAC,CAAA;YACjE,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;IACD,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IACrD,OAAO;QACL,GAAG,QAAQ;QACX,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;KAClD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACxD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAqB;IAC1D,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACtC,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAA;QACrC,IAAI,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QAC/C,MAAM,GAAG,GAAG,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO;QACL,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,IAAI;KAChB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAA;IACvD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,CAAC,CAAA;IACzE,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,CAAC,CAAA;IAC5E,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC1E,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC9E,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAA2B;IACvE,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;QAClE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;QACrB,CAAC,CAAC,UAAU,IAAI,+BAA+B,CAAA;IACjD,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,gBAAgB,IAAI,EAAE,CAAA;AAChF,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAA;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACnB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACnB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACrB,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3B,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACvC,OAAO;QACL,IAAI,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QACtC,IAAI;QACJ,MAAM,EAAE,EAAE,KAAK,IAAI;KACpB,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAoB;IAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAA;IAC9D,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzF,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAA;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,OAAO,KAAK,GAAG,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,KAA4B,CAAA;IAChC,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,GAAG,KAAK,CAAA;YAChB,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACnC,QAAQ,GAAG,IAAI,CAAA;YACf,SAAQ;QACV,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,IAAI,KAAK,KAAK;gBAAE,KAAK,GAAG,SAAS,CAAA;YACrC,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,KAAK,GAAG,IAAI,CAAA;YACZ,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,IAAI,CAAA;IAChB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,IAAI,YAAY,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACtC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC5C,MAAM,OAAO,GAAqB,EAAE,CAAA;IACpC,IAAI,SAA6B,CAAA;IACjC,IAAI,gBAAgB,GAAG,KAAK,CAAA;IAC5B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvD,SAAS,GAAG,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,CAAA;YACjC,gBAAgB,GAAG,IAAI,KAAK,KAAK,CAAA;YACjC,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACzB,gBAAgB,GAAG,IAAI,CAAA;YACvB,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACzB,gBAAgB,GAAG,KAAK,CAAA;YACxB,SAAQ;QACV,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAA;IAChC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC5D,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,CAAA;IAClI,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IAClC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzD,IAAI,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,SAAS,CAAA;IACrC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAC5G,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACxD,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;KACnC,CAAA;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAoB;IACrD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAA;IACvF,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC"}

package/dist/shell/time.d.ts

@@ -0,0 +1 @@
+export declare function parseUnixDate(value: string, command?: string): Date;

package/dist/shell/time.js

@@ -0,0 +1,68 @@
+export function parseUnixDate(value, command = 'date') {
+    const normalized = value.trim();
+    if (!normalized)
+        throw new Error(`${command}: invalid date: ${value}`);
+    if (normalized === 'now')
+        return new Date();
+    if (normalized === 'today')
+        return startOfUtcDay(new Date());
+    if (normalized === 'yesterday')
+        return addUtcDays(startOfUtcDay(new Date()), -1);
+    if (normalized === 'tomorrow')
+        return addUtcDays(startOfUtcDay(new Date()), 1);
+    if (normalized.startsWith('@')) {
+        const seconds = Number(normalized.slice(1));
+        if (!Number.isFinite(seconds))
+            throw new Error(`${command}: invalid date: ${value}`);
+        return new Date(seconds * 1000);
+    }
+    const relative = parseRelativeDate(normalized);
+    if (relative)
+        return relative;
+    const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2})(?::(\d{2}))?)?(?:Z)?$/);
+    if (match) {
+        const [, year, month, day, hour = '0', minute = '0', second = '0'] = match;
+        return checkedUtcDate(value, Number(year), Number(month), Number(day), Number(hour), Number(minute), Number(second), command);
+    }
+    const parsed = new Date(normalized);
+    if (!Number.isFinite(parsed.getTime()))
+        throw new Error(`${command}: invalid date: ${value}`);
+    return parsed;
+}
+function parseRelativeDate(value) {
+    const match = value.match(/^(\d+)\s+(second|minute|hour|day|week)s?\s+ago$/i);
+    if (!match)
+        return undefined;
+    const amount = Number(match[1]);
+    const unit = match[2].toLowerCase();
+    const millisecondsByUnit = {
+        second: 1000,
+        minute: 60_000,
+        hour: 3_600_000,
+        day: 86_400_000,
+        week: 604_800_000,
+    };
+    const milliseconds = millisecondsByUnit[unit];
+    if (milliseconds === undefined)
+        return undefined;
+    return new Date(Date.now() - amount * milliseconds);
+}
+function checkedUtcDate(value, year, month, day, hour, minute, second, command) {
+    const parsed = new Date(Date.UTC(year, month - 1, day, hour, minute, second));
+    if (parsed.getUTCFullYear() !== year ||
+        parsed.getUTCMonth() !== month - 1 ||
+        parsed.getUTCDate() !== day ||
+        parsed.getUTCHours() !== hour ||
+        parsed.getUTCMinutes() !== minute ||
+        parsed.getUTCSeconds() !== second) {
+        throw new Error(`${command}: invalid date: ${value}`);
+    }
+    return parsed;
+}
+function startOfUtcDay(date) {
+    return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+}
+function addUtcDays(date, days) {
+    return new Date(date.getTime() + days * 86_400_000);
+}
+//# sourceMappingURL=time.js.map

package/dist/shell/time.js.map

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

package/dist/state-backend.d.ts

@@ -0,0 +1,61 @@
+import type { FileEntry, FileStat } from './drive.js';
+export interface KStateBackend {
+    /**
+     * KStateBackend is the durability boundary for sessions, logs, leases, VFS
+     * metadata, and recovery records. Implementations must make individual
+     * writeText/appendText/rename/remove calls atomic from K's point of view.
+     *
+     * JSONL append paths are recovery truth: appendText must append complete
+     * records in order, and readTextRange must never expose a torn partial UTF-8
+     * codepoint. If a backend can expose a partial trailing JSONL line after an
+     * external crash, it must either hide that line from range reads or keep it
+     * stable so K's JSONL reader can ignore it until a later complete append.
+     *
+     * Lease implementations must fence stale owners. A renewed or released lease
+     * must only affect the exact token returned by acquireLease; expired leases
+     * may be stolen by a new owner, and the old lease's renew must fail.
+     */
+    kind: string;
+    name?: string;
+    acquireLease?(path: string, options: KStateLeaseOptions): Promise<KStateLease>;
+    close?(): Promise<void> | void;
+    ensureDir(path: string): Promise<void>;
+    readText(path: string): Promise<string>;
+    readTextRange?(path: string, options: {
+        offset?: number;
+        length?: number;
+    }): Promise<KStateTextRange>;
+    writeText(path: string, text: string): Promise<void>;
+    appendText(path: string, text: string): Promise<void>;
+    remove(path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    rename(from: string, to: string): Promise<void>;
+    chmod?(path: string, mode: number): Promise<void>;
+    utime?(path: string, mtime: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    readdir(path: string): Promise<FileEntry[]>;
+    stat(path: string): Promise<FileStat>;
+    realPath?(path: string): string | undefined;
+}
+export interface KStateTextRange {
+    text: string;
+    offset: number;
+    nextOffset: number;
+    size: number;
+}
+export interface KStateLeaseOptions {
+    owner: string;
+    ttlMs: number;
+}
+export interface KStateLease {
+    path: string;
+    owner: string;
+    token: string;
+    expiresAt: string;
+    assertActive?(): Promise<void>;
+    renew(ttlMs?: number): Promise<void>;
+    release(): Promise<void>;
+}
+export declare function memoryDisk(name?: string): KStateBackend;