@tacuchi/agent-workflow-cli 25.6.0 → 25.7.0

package/dist/application/hook-sql-mutation-guard.js

@@ -1,20 +1,26 @@
+// Patterns and display name are read from the runtime config (Phase 3 agnostic CLI).
+import { scanSql } from "../domain/sql-lexer.js";
 import { parseHookPayload } from "./hook-common.js";
-const MUTATION_KEYWORDS = [
-    "INSERT",
-    "UPDATE",
-    "DELETE",
-    "TRUNCATE",
-    "MERGE",
-    "CREATE",
-    "ALTER",
-    "DROP",
-    "GRANT",
-    "REVOKE",
-    "COPY",
-];
-const MUTATION_PATTERN = new RegExp(`\\b(${MUTATION_KEYWORDS.join("|")})\\b`, "i");
-const COMMENT_LINE_RE = /--[^\n]*/g;
-const COMMENT_BLOCK_RE = /\/\*[\s\S]*?\*\//g;
+// The spec's closed list of reads (S051/AC-12): anything else is blocked, even
+// without a mutation keyword, because a mutation list lets through what it omits.
+const READ_STATEMENTS = new Set(["SELECT", "VALUES", "TABLE", "SHOW"]);
+const EXPLAIN_LEGACY_OPTIONS = new Set(["ANALYZE", "ANALYSE", "VERBOSE"]);
+const STATEMENT_DISPLAY_CHARS = 120;
+const REASONS = {
+    undelimited: "el SQL no se puede delimitar: hay un literal, un identificador o un comentario sin cerrar",
+    into: "lleva INTO: SELECT … INTO crea una tabla, no la lee",
+    noRead: "no empieza con una lectura",
+    withShape: "el WITH no tiene la forma nombre AS (…)",
+    explainShape: "las opciones de EXPLAIN no cierran su paréntesis",
+};
+// PostgreSQL reads these differently than MySQL; an execute_sql tool may talk
+// to either, and the other reading could hide a second statement.
+const MARK_REASONS = {
+    hash: "tiene un # fuera de un literal, que otro motor lee como comentario",
+    backtick: "tiene un backtick fuera de un literal, que otro motor lee como identificador",
+    "backslash-quote": "tiene una \\ antes de una comilla, que otro motor lee como escape y cierra el literal en otro lugar",
+    "executable-comment": "tiene un comentario /*! … */, que MySQL ejecuta como SQL",
+};
 export function runSqlMutationGuard(input) {
     const patterns = input.runtime.mcpGuards?.sqlMutation;
     if (!patterns) {
@@ -41,11 +47,11 @@ export function runSqlMutationGuard(input) {
     const sql = extractSql(payload.tool_input);
     if (!sql)
         return { exitCode: 0 };
-    const keyword = findMutation(sql);
-    if (keyword === null)
+    const blocked = findNonRead(sql);
+    if (blocked === null)
         return { exitCode: 0 };
     const display = input.runtime.displayName ?? "agent-workflow";
-    const msg = formatBlockMessage(toolName, serverFull, keyword, display);
+    const msg = formatBlockMessage(toolName, serverFull, blocked, display);
     return { exitCode: 2, stderr: msg };
 }
 function compilePatterns(patterns) {
@@ -78,21 +84,143 @@ function extractSql(toolInput) {
     }
     return "";
 }
-function findMutation(sql) {
-    const cleaned = stripComments(sql);
-    const m = cleaned.match(MUTATION_PATTERN);
-    return m?.[1] ? m[1].toUpperCase() : null;
+function findNonRead(sql) {
+    const scan = scanSql(sql);
+    if (!scan.ok) {
+        return {
+            statement: `entrada completa · ${displayStatement(sql)}`,
+            reason: REASONS.undelimited,
+        };
+    }
+    // An empty or comment-only statement runs nothing; it is neither counted nor classified.
+    const statements = scan.statements.filter((s) => s.tokens.length > 0 || s.marks.length > 0);
+    for (const [position, statement] of statements.entries()) {
+        const reason = classifyStatement(statement);
+        if (reason === null)
+            continue;
+        const text = displayStatement(sql.slice(statement.start, statement.end));
+        return { statement: `${position + 1} de ${statements.length} · ${text}`, reason };
+    }
+    return null;
+}
+/** Returns why the statement is not a read, or null when it reads. */
+function classifyStatement(statement) {
+    const mark = statement.marks[0];
+    if (mark !== undefined)
+        return MARK_REASONS[mark];
+    const { tokens } = statement;
+    const shape = classifyRange(tokens, 0, tokens.length);
+    if (shape !== null)
+        return shape;
+    return tokens.includes("INTO") ? REASONS.into : null;
+}
+function classifyRange(tokens, start, end) {
+    let index = start;
+    while (index < end && tokens[index] === "(")
+        index += 1;
+    const first = index < end ? tokens[index] : undefined;
+    if (first === undefined || first === ")" || first === ",")
+        return REASONS.noRead;
+    if (READ_STATEMENTS.has(first))
+        return null;
+    if (first === "WITH")
+        return classifyWith(tokens, index + 1, end);
+    if (first === "EXPLAIN")
+        return classifyExplain(tokens, index + 1, end);
+    return `${first} no es una lectura`;
+}
+/**
+ * Only a top-level WITH may hold data-modifying parts, so each part's body and
+ * the main statement are classified; nested WITHs recurse through classifyRange.
+ */
+function classifyWith(tokens, start, end) {
+    let index = tokens[start] === "RECURSIVE" ? start + 1 : start;
+    for (;;) {
+        const part = classifyWithPart(tokens, index, end);
+        if (typeof part === "string")
+            return part;
+        index = part.next;
+        if (tokens[index] !== ",")
+            break;
+        index += 1;
+    }
+    const main = classifyRange(tokens, index, end);
+    return main === null ? null : `la sentencia principal del WITH: ${main}`;
+}
+/** Reads `name [(columns)] AS [NOT] [MATERIALIZED] (body)`; returns why it fails or where it ends. */
+function classifyWithPart(tokens, start, end) {
+    const as = indexAtDepth(tokens, "AS", start, end);
+    if (as < 0)
+        return REASONS.withShape;
+    let open = as + 1;
+    if (tokens[open] === "NOT")
+        open += 1;
+    if (tokens[open] === "MATERIALIZED")
+        open += 1;
+    const close = tokens[open] === "(" ? matchingParen(tokens, open, end) : -1;
+    if (close < 0)
+        return REASONS.withShape;
+    const body = classifyRange(tokens, open + 1, close);
+    return body === null ? { next: close + 1 } : `una parte del WITH: ${body}`;
+}
+/** EXPLAIN is classified by what it explains, with or without ANALYZE. */
+function classifyExplain(tokens, start, end) {
+    let index = start;
+    if (tokens[index] === "(") {
+        const close = matchingParen(tokens, index, end);
+        if (close < 0)
+            return REASONS.explainShape;
+        index = close + 1;
+    }
+    else {
+        while (EXPLAIN_LEGACY_OPTIONS.has(tokens[index] ?? ""))
+            index += 1;
+    }
+    const target = classifyRange(tokens, index, end);
+    return target === null ? null : `EXPLAIN de otra sentencia: ${target}`;
+}
+function indexAtDepth(tokens, word, start, end) {
+    let depth = 0;
+    for (let index = start; index < end; index += 1) {
+        const token = tokens[index];
+        if (token === "(")
+            depth += 1;
+        else if (token === ")")
+            depth -= 1;
+        else if (depth === 0 && token === word)
+            return index;
+        if (depth < 0)
+            return -1;
+    }
+    return -1;
+}
+function matchingParen(tokens, open, end) {
+    let depth = 0;
+    for (let index = open; index < end; index += 1) {
+        if (tokens[index] === "(")
+            depth += 1;
+        else if (tokens[index] === ")")
+            depth -= 1;
+        if (depth === 0)
+            return index;
+    }
+    return -1;
 }
-function stripComments(sql) {
-    return sql.replace(COMMENT_BLOCK_RE, " ").replace(COMMENT_LINE_RE, " ");
+function displayStatement(text) {
+    const compact = text.replace(/\s+/g, " ").trim();
+    return compact.length > STATEMENT_DISPLAY_CHARS
+        ? `${compact.slice(0, STATEMENT_DISPLAY_CHARS)}…`
+        : compact;
 }
-function formatBlockMessage(toolName, server, keyword, display) {
+function formatBlockMessage(toolName, server, blocked, display) {
     return `${[
         `[${display} sql-mutation-guard] Bloqueado por shared-contract §30 (política BD universal).`,
         `  Tool      : ${toolName}`,
         `  Servidor  : ${server}`,
-        `  Keyword   : ${keyword}`,
+        `  Sentencia : ${blocked.statement}`,
+        `  Motivo    : ${blocked.reason}`,
         "",
+        "Sólo pasan lecturas: SELECT sin INTO, WITH de lecturas, EXPLAIN de una lectura, SHOW, VALUES y TABLE.",
         "Las mutaciones a BD (DML/DDL) NO se ejecutan desde una sesión.",
         "Materializá el cambio como script SQL en docs/scripts/ del workspace",
         "de la fuente y pedile al usuario que lo aplique manualmente.",

package/dist/application/hook-sql-mutation-guard.js.map

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

package/dist/application/host-memory/claude-code.js

@@ -0,0 +1,65 @@
+import { join } from "node:path";
+import { parseSkillFrontmatter } from "../../domain/skill-frontmatter.js";
+import { isoDay, sortedEntries } from "./reader.js";
+/** The index Claude Code loads each session; it points at the notes and is not one. */
+const INDEX_FILE = "MEMORY.md";
+/**
+ * Claude Code keeps one note per fact in `~/.claude/projects/<key>/memory/`, with
+ * a frontmatter `description` (the brief form) and, on newer notes, a
+ * `metadata.modified` date. Every project folder is read: a learning about
+ * Workline can live in any of them.
+ */
+export async function readClaudeCodeMemory(fs, home) {
+    const projects = join(home, ".claude", "projects");
+    if (!(await fs.exists(projects)))
+        return { state: "absent", reason: `no existe ${projects}` };
+    const items = [];
+    const skipped = [];
+    let memoryDirs = 0;
+    for (const project of await sortedEntries(fs, projects)) {
+        const memory = join(project.path, "memory");
+        if (project.type !== "dir" || !(await fs.exists(memory)))
+            continue;
+        memoryDirs++;
+        await readMemoryDir(fs, memory, project.name, items, skipped);
+    }
+    if (memoryDirs === 0) {
+        return { state: "absent", reason: `ninguna carpeta memory/ bajo ${projects}` };
+    }
+    return { state: "read", items, skipped };
+}
+async function readMemoryDir(fs, memory, project, items, skipped) {
+    for (const file of await sortedEntries(fs, memory)) {
+        if (file.type !== "file" || !file.name.endsWith(".md") || file.name === INDEX_FILE)
+            continue;
+        const note = await readNote(fs, file.path, `${project}/${file.name}`);
+        if ("reason" in note)
+            skipped.push(note);
+        else
+            items.push(note);
+    }
+}
+async function readNote(fs, path, key) {
+    let content;
+    try {
+        content = await fs.readText(path);
+    }
+    catch (err) {
+        return { path, reason: `no se pudo leer: ${err.message}` };
+    }
+    const frontmatter = parseSkillFrontmatter(content);
+    if (frontmatter === null)
+        return { path, reason: "sin frontmatter" };
+    const description = frontmatter.fields.description?.trim();
+    if (!description)
+        return { path, reason: "el frontmatter no trae description" };
+    return {
+        key,
+        date: isoDay(frontmatter.metadata.modified),
+        text: description,
+        topic: content,
+        body: content,
+        source: { path, section: null },
+    };
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/application/host-memory/claude-code.js.map

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

package/dist/application/host-memory/codex.js

@@ -0,0 +1,225 @@
+import { join } from "node:path";
+import { parse as parseToml } from "smol-toml";
+import { sortedEntries } from "./reader.js";
+const GROUP_HEADING = /^# Task Group:\s*(.+)$/;
+const GROUP_HEADER_LINE = /^(scope|applies_to):/;
+/** The two sections of a group that hold what was learned; the rest is its record. */
+const LEARNING_SECTIONS = new Set([
+    "Reusable knowledge",
+    "Failures and how to do differently",
+]);
+const ROLLOUT_DATE = /rollout_summaries\/(\d{4}-\d{2}-\d{2})T/;
+/**
+ * Consolidation labels what it derived from an ad-hoc note. Those notes are read
+ * directly, so the derived bullet would be the same learning twice.
+ */
+const AD_HOC_TAG = "[ad-hoc note]";
+const AD_HOC_NOTE_NAME = /^(\d{4}-\d{2}-\d{2})T\d{2}-\d{2}-\d{2}-.+\.md$/;
+/**
+ * Codex keeps a global memory in `~/.codex/memories/`: a consolidated
+ * `MEMORY.md` of `# Task Group` blocks, plus append-only ad-hoc notes. It is only
+ * live with `[features] memories = true`.
+ */
+/** The ad-hoc note name Codex's own consolidation reads. */
+export const CODEX_AD_HOC_NAME_FORMAT = "YYYY-MM-DDTHH-MM-SS-<slug>.md";
+export function codexMemoryPaths(home) {
+    const root = join(home, ".codex");
+    const memories = join(root, "memories");
+    return {
+        root,
+        config: join(root, "config.toml"),
+        memories,
+        index: join(memories, "MEMORY.md"),
+        notesDir: join(memories, "extensions", "ad_hoc", "notes"),
+    };
+}
+export async function readCodexMemory(fs, home) {
+    const { root, config, index, notesDir } = codexMemoryPaths(home);
+    if (!(await fs.exists(root)))
+        return { state: "absent", reason: `no existe ${root}` };
+    const memoriesSwitch = await readCodexMemoriesSwitch(fs, config);
+    if (memoriesSwitch !== null)
+        return memoriesSwitch;
+    const [hasIndex, hasNotes] = await Promise.all([fs.exists(index), fs.exists(notesDir)]);
+    if (!hasIndex && !hasNotes) {
+        return { state: "absent", reason: `ni ${index} ni ${notesDir} existen` };
+    }
+    // Index and notes are independent sources: one that cannot be read never hides the other.
+    const fromIndex = hasIndex ? await readIndexItems(fs, index) : [];
+    const fromNotes = hasNotes ? await readAdHocNotes(fs, notesDir) : { items: [], skipped: [] };
+    const indexItems = Array.isArray(fromIndex) ? fromIndex : [];
+    const skipped = Array.isArray(fromIndex) ? fromNotes.skipped : [fromIndex, ...fromNotes.skipped];
+    const items = [...indexItems, ...fromNotes.items];
+    if (items.length === 0 && skipped.length > 0) {
+        return { state: "unreadable", reason: skipped.map((s) => `${s.path}: ${s.reason}`).join("; ") };
+    }
+    return { state: "read", items, skipped };
+}
+/** The index's learnings, or why the index could not be read as one. */
+async function readIndexItems(fs, index) {
+    let text;
+    try {
+        text = await fs.readText(index);
+    }
+    catch (err) {
+        return { path: index, reason: `no se pudo leer: ${err.message}` };
+    }
+    const groups = parseIndex(text);
+    if (groups.length === 0)
+        return { path: index, reason: "no trae ningún bloque '# Task Group'" };
+    return groupItems(groups, index);
+}
+async function readAdHocNotes(fs, notesDir) {
+    const items = [];
+    const skipped = [];
+    for (const file of await sortedEntries(fs, notesDir)) {
+        if (file.type !== "file" || !file.name.endsWith(".md"))
+            continue;
+        const note = await readAdHocNote(fs, file.path, file.name);
+        if ("reason" in note)
+            skipped.push(note);
+        else
+            items.push(note);
+    }
+    return { items, skipped };
+}
+/** Null when memory is on; otherwise the state and reason that say why it is off. */
+export async function readCodexMemoriesSwitch(fs, configPath) {
+    if (!(await fs.exists(configPath))) {
+        return { state: "disabled", reason: `sin ${configPath}: [features] memories no está activado` };
+    }
+    let config;
+    try {
+        config = parseToml(await fs.readText(configPath));
+    }
+    catch (err) {
+        return {
+            state: "unreadable",
+            reason: `${configPath} no es TOML válido: ${err.message}`,
+        };
+    }
+    const features = config.features;
+    if (features?.memories === true)
+        return null;
+    return { state: "disabled", reason: `[features] memories no es true en ${configPath}` };
+}
+function parseIndex(text) {
+    const parser = new IndexParser();
+    for (const line of text.split(/\r?\n/))
+        parser.read(line);
+    return parser.groups;
+}
+/** One pass over `MEMORY.md`, tracking which group, section and bullet a line belongs to. */
+class IndexParser {
+    groups = [];
+    group = null;
+    section = null;
+    subsection = null;
+    bullet = null;
+    read(line) {
+        const heading = GROUP_HEADING.exec(line)?.[1];
+        if (heading !== undefined) {
+            this.startGroup(heading);
+            return;
+        }
+        const group = this.group;
+        if (group === null)
+            return;
+        if (line.startsWith("## ")) {
+            this.enterSection(line.slice(3).trim(), null);
+        }
+        else if (line.startsWith("### ")) {
+            this.enterSection(this.section, line.slice(4).trim());
+        }
+        else {
+            this.readRecord(group, line);
+            this.readLearning(group, line);
+        }
+    }
+    startGroup(title) {
+        this.group = { title: title.trim(), header: [title], date: null, bullets: [] };
+        this.groups.push(this.group);
+        this.enterSection(null, null);
+    }
+    enterSection(section, subsection) {
+        this.section = section;
+        this.subsection = subsection;
+        this.bullet = null;
+    }
+    /** The lines that say what the group is about and when it was last consolidated. */
+    readRecord(group, line) {
+        if (GROUP_HEADER_LINE.test(line))
+            group.header.push(line);
+        if (this.subsection === "keywords" && line.startsWith("- "))
+            group.header.push(line);
+        const rollout = ROLLOUT_DATE.exec(line)?.[1];
+        if (rollout !== undefined && (group.date === null || rollout > group.date)) {
+            group.date = rollout;
+        }
+    }
+    /** A learning bullet, including the indented lines that continue it. */
+    readLearning(group, line) {
+        const section = this.section;
+        if (section === null || this.subsection !== null || !LEARNING_SECTIONS.has(section))
+            return;
+        if (line.startsWith("- ")) {
+            this.bullet = { section, text: line.slice(2).trim() };
+            group.bullets.push(this.bullet);
+        }
+        else if (this.bullet !== null && /^\s+\S/.test(line)) {
+            this.bullet.text += ` ${line.trim()}`;
+        }
+        else {
+            this.bullet = null;
+        }
+    }
+}
+function groupItems(groups, index) {
+    return groups.flatMap((group) => group.bullets
+        .filter((bullet) => !bullet.text.includes(AD_HOC_TAG))
+        .map((bullet) => ({
+        // MEMORY.md is rewritten by every consolidation, so no key inside it is
+        // stable: a position shifts as much as a wording. The durable source is the
+        // append-only ad-hoc note, which is why those are read directly.
+        key: `MEMORY.md#${group.title}#${bullet.text}`,
+        date: group.date,
+        text: bullet.text,
+        topic: group.header.join("\n"),
+        body: bullet.text,
+        source: { path: index, section: `${group.title} › ${bullet.section}` },
+    })));
+}
+async function readAdHocNote(fs, path, name) {
+    const date = AD_HOC_NOTE_NAME.exec(name)?.[1];
+    if (date === undefined) {
+        return { path, reason: "el nombre no sigue YYYY-MM-DDTHH-MM-SS-<slug>.md" };
+    }
+    let content;
+    try {
+        content = await fs.readText(path);
+    }
+    catch (err) {
+        return { path, reason: `no se pudo leer: ${err.message}` };
+    }
+    const text = firstLine(content);
+    if (text === null)
+        return { path, reason: "la nota está vacía" };
+    return {
+        key: `ad_hoc/${name}`,
+        date,
+        text,
+        topic: content,
+        body: content,
+        source: { path, section: null },
+    };
+}
+/** The first line with content, without its Markdown heading or bullet mark. */
+function firstLine(content) {
+    for (const line of content.split(/\r?\n/)) {
+        const text = line.replace(/^\s*(#+|[-*])\s*/, "").trim();
+        if (text !== "")
+            return text;
+    }
+    return null;
+}
+//# sourceMappingURL=codex.js.map

package/dist/application/host-memory/codex.js.map

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

package/dist/application/host-memory/destination.js

@@ -0,0 +1,52 @@
+import { join, resolve } from "node:path";
+import { harnessById } from "../../domain/harnesses.js";
+import { CODEX_AD_HOC_NAME_FORMAT, codexMemoryPaths, readCodexMemoriesSwitch } from "./codex.js";
+/**
+ * Where the current host would save a learning. The CLI never saves: it names
+ * the place, and the host's agent writes there through its own channel.
+ */
+export async function resolveDestination(host, ctx) {
+    const home = ctx.env.homeDir();
+    if (host === "claude-code") {
+        const root = await gitRootOf(ctx, ctx.env.cwd());
+        const path = join(home, ".claude", "projects", claudeProjectKey(root), "memory");
+        const destination = { path, channel: "claude-code-memory-note", name_format: null };
+        return { destination, reason: null, presenceRoot: path };
+    }
+    if (host === "codex") {
+        const paths = codexMemoryPaths(home);
+        const off = await readCodexMemoriesSwitch(ctx.fs, paths.config);
+        if (off !== null)
+            return nowhere(`la memoria de Codex no está activa: ${off.reason}`);
+        const destination = {
+            path: paths.notesDir,
+            channel: "codex-ad-hoc-note",
+            name_format: CODEX_AD_HOC_NAME_FORMAT,
+        };
+        // Codex's memory is global, and consolidation may carry a note's mark into MEMORY.md.
+        return { destination, reason: null, presenceRoot: paths.memories };
+    }
+    if (host === "unknown") {
+        return nowhere("host no reconocido: sin --host ni marcador de entorno no hay memoria propia");
+    }
+    const label = harnessById(host)?.label ?? host;
+    return nowhere(`${label} no guarda memoria curada propia: no tiene dónde guardar`);
+}
+function nowhere(reason) {
+    return { destination: null, reason, presenceRoot: null };
+}
+/** Claude Code files a project's memory under its git root, every non-alphanumeric turned into `-`. */
+function claudeProjectKey(root) {
+    return root.replace(/[^A-Za-z0-9]/g, "-");
+}
+async function gitRootOf(ctx, dir) {
+    // git counts the prefix over the physical path; climbing it from a symlinked
+    // spelling of the same directory would land in a folder Claude Code never reads.
+    const physical = await ctx.fs.realPath(dir);
+    const prefix = await ctx.git.repoPrefix(physical);
+    if (prefix === null)
+        return physical;
+    const depth = prefix.split("/").filter(Boolean).length;
+    return resolve(physical, ...Array(depth).fill(".."));
+}
+//# sourceMappingURL=destination.js.map

package/dist/application/host-memory/destination.js.map

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

package/dist/application/host-memory/reader.js

@@ -0,0 +1,9 @@
+const ISO_DAY = /^\d{4}-\d{2}-\d{2}/;
+/** The `YYYY-MM-DD` a memory recorded, or null when what it recorded is not a date. */
+export function isoDay(value) {
+    return value?.match(ISO_DAY)?.[0] ?? null;
+}
+export async function sortedEntries(fs, dir) {
+    return (await fs.list(dir)).sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=reader.js.map

package/dist/application/host-memory/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/application/host-memory/reader.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,GAAG,oBAAoB,CAAC;AAErC,uFAAuF;AACvF,MAAM,UAAU,MAAM,CAAC,KAAyB;IAC9C,OAAO,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAkB,EAAE,GAAW;IACjE,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3E,CAAC"}