@jim80net/memex-core 0.4.0 → 0.6.0

package/dist/origin.js

@@ -0,0 +1,490 @@
+/**
+ * Shared origin root resolution, symlink projection, and materialize writes.
+ *
+ * Design: design/shared-origin-sync-profile.md (XO-gated 2026-07-10).
+ * Locked: ~/.memex default + resolver; absolute symlinks v1; partial apply
+ * + report conflicts; one-release memex-claude → ~/.memex compat symlink.
+ */
+import { lstat, mkdir, readdir, readFile, readlink, realpath, rename, rm, symlink, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { withFileLock } from "./file-lock.js";
+import { git, isGitRepo } from "./git-helpers.js";
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+const ENV_ORIGIN = "MEMEX_ORIGIN";
+/**
+ * Expand `~/…` against homeDir; leave other paths for resolve().
+ */
+export function expandUserPath(path, homeDir) {
+    if (path === "~")
+        return homeDir;
+    if (path.startsWith(`~/`) || path.startsWith(`~${sep}`)) {
+        return join(homeDir, path.slice(2));
+    }
+    return path;
+}
+/**
+ * Resolve to an absolute path. Rejects empty input.
+ */
+export function toAbsolutePath(path, homeDir) {
+    const expanded = expandUserPath(path.trim(), homeDir);
+    if (!expanded) {
+        throw new Error("path must be non-empty");
+    }
+    return resolve(expanded);
+}
+/**
+ * True when `candidate` is exactly `root` or a path under `root`
+ * (after resolve). Does not follow symlinks on the inputs.
+ */
+export function isPathInsideRoot(root, candidate) {
+    const r = resolve(root);
+    const c = resolve(candidate);
+    if (c === r)
+        return true;
+    const prefix = r.endsWith(sep) ? r : r + sep;
+    return c.startsWith(prefix);
+}
+/**
+ * Join origin root + relative path with traversal rejection.
+ * `relPath` must not be absolute and must stay under root.
+ */
+export function resolveUnderOrigin(originRoot, relPath) {
+    const root = resolve(originRoot);
+    const cleaned = relPath.replace(/\\/g, "/").replace(/^\/+/, "");
+    if (!cleaned || cleaned === ".") {
+        throw new Error(`origin-relative path must be non-empty: ${JSON.stringify(relPath)}`);
+    }
+    if (isAbsolute(relPath) || isAbsolute(cleaned)) {
+        throw new Error(`origin-relative path must not be absolute: ${JSON.stringify(relPath)}`);
+    }
+    const abs = resolve(root, cleaned);
+    if (!isPathInsideRoot(root, abs)) {
+        throw new Error(`path escapes origin root: ${JSON.stringify(relPath)}`);
+    }
+    return abs;
+}
+async function pathExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// resolveOriginRoot
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the shared origin root.
+ *
+ * Precedence (XO-locked):
+ * 1. explicit `opts.root`
+ * 2. env `MEMEX_ORIGIN`
+ * 3. existing `~/.memex`
+ * 4. existing `~/.local/share/memex` (XDG / historical grok default)
+ * 5. existing `~/.local/share/memex-claude` (legacy live corpus)
+ * 6. product default `~/.memex` (may not exist yet)
+ */
+export async function resolveOriginRoot(opts = {}) {
+    const home = opts.homeDir ?? homedir();
+    const env = opts.env ?? process.env;
+    const preferDefault = opts.preferDefaultWhenMissing !== false;
+    const defaultRoot = join(home, ".memex");
+    const xdgRoot = join(home, ".local", "share", "memex");
+    const legacyClaude = join(home, ".local", "share", "memex-claude");
+    if (opts.root !== undefined && opts.root.trim() !== "") {
+        const root = toAbsolutePath(opts.root, home);
+        return { root, source: "explicit", exists: await pathExists(root) };
+    }
+    const envVal = env[ENV_ORIGIN];
+    if (typeof envVal === "string" && envVal.trim() !== "") {
+        const root = toAbsolutePath(envVal, home);
+        return { root, source: "env", exists: await pathExists(root) };
+    }
+    if (await pathExists(defaultRoot)) {
+        return { root: resolve(defaultRoot), source: "default", exists: true };
+    }
+    if (await pathExists(xdgRoot)) {
+        return { root: resolve(xdgRoot), source: "xdg", exists: true };
+    }
+    if (await pathExists(legacyClaude)) {
+        return { root: resolve(legacyClaude), source: "legacy-claude", exists: true };
+    }
+    if (preferDefault) {
+        return { root: resolve(defaultRoot), source: "default", exists: false };
+    }
+    return { root: resolve(defaultRoot), source: "default", exists: false };
+}
+/** Product-default origin path for a given home (does not touch the filesystem). */
+export function defaultOriginRoot(homeDir = homedir()) {
+    return resolve(join(homeDir, ".memex"));
+}
+/** Legacy claude corpus path (compat / migrate source). */
+export function legacyClaudeOriginRoot(homeDir = homedir()) {
+    return resolve(join(homeDir, ".local", "share", "memex-claude"));
+}
+function patternToSuffix(pattern) {
+    // v1: only support "*.ext" style → suffix match
+    const p = pattern ?? "*.md";
+    if (p.startsWith("*"))
+        return p.slice(1);
+    return p;
+}
+async function listFileEntries(originDir, suffix) {
+    let names;
+    try {
+        names = await readdir(originDir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of names) {
+        if (!name.endsWith(suffix))
+            continue;
+        const absPath = join(originDir, name);
+        try {
+            const st = await lstat(absPath);
+            // Follow only for type check of the origin entry itself if it's a link? Origin
+            // entries should be real files. Accept regular files; skip dirs/symlinks-to-dirs.
+            if (st.isFile() || (st.isSymbolicLink() && (await isSymlinkToFile(absPath)))) {
+                out.push({ name, absPath: resolve(absPath) });
+            }
+        }
+        catch {
+            // skip
+        }
+    }
+    return out;
+}
+async function isSymlinkToFile(path) {
+    try {
+        const st = await lstat(await realpath(path));
+        return st.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function listSkillDirEntries(originDir) {
+    let names;
+    try {
+        names = await readdir(originDir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of names) {
+        const skillDir = join(originDir, name);
+        const skillMd = join(skillDir, "SKILL.md");
+        try {
+            const dirStat = await lstat(skillDir);
+            if (!dirStat.isDirectory() && !dirStat.isSymbolicLink())
+                continue;
+            const mdStat = await lstat(skillMd);
+            if (!mdStat.isFile() && !mdStat.isSymbolicLink())
+                continue;
+            out.push({ name, absPath: resolve(skillDir) });
+        }
+        catch {
+            // skip
+        }
+    }
+    return out;
+}
+/**
+ * Classify existing target path for projection planning.
+ * Uses lstat (does not follow the final target symlink for type).
+ */
+async function classifyTarget(targetPath, originPath, originRoot, relinkManaged) {
+    let st;
+    try {
+        st = await lstat(targetPath);
+    }
+    catch {
+        return "create";
+    }
+    if (st.isSymbolicLink()) {
+        let linkTarget;
+        try {
+            linkTarget = await readlink(targetPath);
+        }
+        catch {
+            return "broken-unmanaged";
+        }
+        // Normalize link target to absolute for comparison (v1 uses absolute links).
+        const absLink = isAbsolute(linkTarget)
+            ? resolve(linkTarget)
+            : resolve(dirname(targetPath), linkTarget);
+        const originAbs = resolve(originPath);
+        // Same destination (string or realpath when both exist)
+        if (absLink === originAbs)
+            return "noop";
+        try {
+            const [a, b] = await Promise.all([realpath(targetPath), realpath(originPath)]);
+            if (a === b)
+                return "noop";
+        }
+        catch {
+            // broken or missing origin — fall through
+        }
+        if (isPathInsideRoot(originRoot, absLink)) {
+            return relinkManaged ? "relink" : "foreign-symlink";
+        }
+        // Broken symlink: only relink if the *link text* was under origin
+        try {
+            await realpath(targetPath);
+            // resolved outside origin
+            return "foreign-symlink";
+        }
+        catch {
+            if (relinkManaged && isPathInsideRoot(originRoot, absLink)) {
+                return "relink";
+            }
+            return "broken-unmanaged";
+        }
+    }
+    if (st.isDirectory())
+        return "real-dir";
+    if (st.isFile())
+        return "real-file";
+    return "type-mismatch";
+}
+/**
+ * Build a projection plan: which dirs to ensure, which links to create/relink/noop,
+ * and which paths conflict (fail-closed — never clobber real files).
+ */
+export async function planProjection(originRoot, targets, opts = {}) {
+    const root = resolve(originRoot);
+    const relinkManaged = opts.relinkManaged !== false;
+    const ensureDirs = new Set();
+    const links = [];
+    const conflicts = [];
+    for (const target of targets) {
+        const targetDir = resolve(target.targetDir);
+        const originDir = resolveUnderOrigin(root, target.originRelDir);
+        const initDir = target.initTargetDir !== false;
+        if (initDir)
+            ensureDirs.add(targetDir);
+        const entries = target.entryKind === "skill-dirs"
+            ? await listSkillDirEntries(originDir)
+            : await listFileEntries(originDir, patternToSuffix(target.pattern));
+        for (const entry of entries) {
+            const targetPath = join(targetDir, entry.name);
+            const originPath = entry.absPath;
+            if (!isPathInsideRoot(root, originPath)) {
+                conflicts.push({
+                    targetPath,
+                    originPath,
+                    reason: "type-mismatch",
+                });
+                continue;
+            }
+            const decision = await classifyTarget(targetPath, originPath, root, relinkManaged);
+            if (decision === "create" || decision === "relink" || decision === "noop") {
+                links.push({ targetPath, originPath, action: decision });
+            }
+            else {
+                conflicts.push({ targetPath, originPath, reason: decision });
+            }
+        }
+    }
+    return {
+        ensureDirs: [...ensureDirs].sort(),
+        links,
+        conflicts,
+    };
+}
+/**
+ * Apply a projection plan with **partial success**: non-conflicting links are
+ * applied; conflicts are reported and never applied (XO-locked).
+ *
+ * Symlinks are **absolute** (v1).
+ */
+export async function applyProjection(plan, _opts = {}) {
+    for (const dir of plan.ensureDirs) {
+        await mkdir(dir, { recursive: true });
+    }
+    let linked = 0;
+    let skipped = 0;
+    for (const link of plan.links) {
+        if (link.action === "noop") {
+            skipped++;
+            continue;
+        }
+        // Parent of target (may be deeper than ensureDirs for safety)
+        await mkdir(dirname(link.targetPath), { recursive: true });
+        if (link.action === "relink") {
+            await rm(link.targetPath, { force: true });
+        }
+        // Absolute symlink (v1)
+        const originAbs = resolve(link.originPath);
+        await symlink(originAbs, link.targetPath);
+        linked++;
+    }
+    return {
+        linked,
+        skipped,
+        conflicts: [...plan.conflicts],
+    };
+}
+// ---------------------------------------------------------------------------
+// materializeEntry
+// ---------------------------------------------------------------------------
+/**
+ * Write one corpus entry under origin.root with per-file lock.
+ * Does not commit. Rejects path traversal outside origin.
+ */
+export async function materializeEntry(originRoot, input) {
+    const absPath = resolveUnderOrigin(originRoot, input.originRelPath);
+    // Parent dirs must exist before acquireLock (lock is `${absPath}.lock` via mkdir).
+    await mkdir(dirname(absPath), { recursive: true });
+    return withFileLock(absPath, async () => {
+        let existing = null;
+        try {
+            const st = await lstat(absPath);
+            if (st.isSymbolicLink()) {
+                return {
+                    status: "conflict",
+                    absPath,
+                    reason: "destination is a symlink; refuse to materialize through unmanaged link",
+                };
+            }
+            if (st.isDirectory()) {
+                return {
+                    status: "conflict",
+                    absPath,
+                    reason: "destination is a directory",
+                };
+            }
+            existing = await readFile(absPath, "utf-8");
+        }
+        catch {
+            existing = null;
+        }
+        if (existing !== null) {
+            if (existing === input.content) {
+                return { status: "unchanged", absPath };
+            }
+            if (input.failIfChanged) {
+                return {
+                    status: "conflict",
+                    absPath,
+                    reason: "destination exists with different content (failIfChanged)",
+                };
+            }
+            await writeFile(absPath, input.content, "utf-8");
+            return { status: "updated", absPath };
+        }
+        await writeFile(absPath, input.content, "utf-8");
+        return { status: "created", absPath };
+    });
+}
+/**
+ * Stage and commit specific origin-relative paths when origin is a git repo.
+ * Does not push.
+ */
+export async function commitOriginPaths(originRoot, relPaths, message) {
+    const root = resolve(originRoot);
+    if (!(await isGitRepo(root)))
+        return "not-a-repo";
+    try {
+        const absPaths = [];
+        for (const rel of relPaths) {
+            absPaths.push(resolveUnderOrigin(root, rel));
+        }
+        // git add prefers paths relative to repo root
+        for (const abs of absPaths) {
+            const rel = relative(root, abs);
+            await git(["add", "--", rel], root);
+        }
+        const { stdout } = await git(["status", "--porcelain"], root);
+        if (!stdout.trim())
+            return "no-changes";
+        await git(["commit", "-m", message], root);
+        return "committed";
+    }
+    catch (err) {
+        return `failed: ${err instanceof Error ? err.message : String(err)}`;
+    }
+}
+/**
+ * Install one-release backward-compat symlink:
+ * `~/.local/share/memex-claude` → `~/.memex` (or custom paths).
+ *
+ * Fail-closed if legacy path is a real file/dir (non-link).
+ */
+export async function installLegacyOriginCompatSymlink(defaultRoot, opts = {}) {
+    const home = opts.homeDir ?? homedir();
+    const legacy = resolve(opts.legacyPath ?? legacyClaudeOriginRoot(home));
+    const dest = resolve(defaultRoot);
+    if (!(await pathExists(dest))) {
+        return "skipped-missing-default";
+    }
+    try {
+        const st = await lstat(legacy);
+        if (st.isSymbolicLink()) {
+            const cur = await readlink(legacy);
+            const absCur = isAbsolute(cur) ? resolve(cur) : resolve(dirname(legacy), cur);
+            if (absCur === dest)
+                return "already";
+            try {
+                if ((await realpath(legacy)) === (await realpath(dest)))
+                    return "already";
+            }
+            catch {
+                // fall through to conflict if we cannot safely replace
+            }
+            return "conflict";
+        }
+        return "conflict";
+    }
+    catch {
+        // missing — create
+    }
+    await mkdir(dirname(legacy), { recursive: true });
+    await symlink(dest, legacy);
+    return "created";
+}
+/**
+ * Move an existing origin tree to the product default (`~/.memex`) and
+ * optionally install the one-release legacy compat symlink.
+ */
+export async function migrateOriginToDefault(opts = {}) {
+    const home = opts.homeDir ?? homedir();
+    const to = defaultOriginRoot(home);
+    const from = resolve(opts.from ?? legacyClaudeOriginRoot(home));
+    if (from === to) {
+        return { status: "already-at-default", root: to };
+    }
+    if (!(await pathExists(from))) {
+        return { status: "source-missing", from };
+    }
+    if (await pathExists(to)) {
+        return { status: "destination-exists", to };
+    }
+    try {
+        await mkdir(dirname(to), { recursive: true });
+        await rename(from, to);
+    }
+    catch (err) {
+        return {
+            status: "failed",
+            reason: err instanceof Error ? err.message : String(err),
+        };
+    }
+    let compat = "skipped-missing-default";
+    if (opts.installCompatSymlink !== false) {
+        compat = await installLegacyOriginCompatSymlink(to, {
+            legacyPath: from,
+            homeDir: home,
+        });
+    }
+    return { status: "migrated", from, to, compat };
+}
+//# sourceMappingURL=origin.js.map

package/dist/origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.js","sourceRoot":"","sources":["../src/origin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,EAAE,EACF,OAAO,EACP,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAUlD,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,UAAU,GAAG,cAAc,CAAC;AAyBlC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,OAAO,CAAC;IACjC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IAC9D,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAC7C,OAAO,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,OAAe;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC,EAAE;IAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,aAAa,GAAG,IAAI,CAAC,wBAAwB,KAAK,KAAK,CAAC;IAE9D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAEnE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChF,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC1E,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAAC,UAAkB,OAAO,EAAE;IAC3D,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,sBAAsB,CAAC,UAAkB,OAAO,EAAE;IAChE,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;AACnE,CAAC;AAWD,SAAS,eAAe,CAAC,OAA2B;IAClD,gDAAgD;IAChD,MAAM,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC;IAC5B,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,SAAiB,EACjB,MAAc;IAEd,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAwC,EAAE,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,+EAA+E;YAC/E,kFAAkF;YAClF,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,SAAiB;IAEjB,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAwC,EAAE,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;gBAAE,SAAS;YAClE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;gBAAE,SAAS;YAC3D,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAC3B,UAAkB,EAClB,UAAkB,EAClB,UAAkB,EAClB,aAAsB;IAEtB,IAAI,EAAqC,CAAC;IAC1C,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC;QACxB,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,6EAA6E;QAC7E,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC;YACpC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;YACrB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;QAE7C,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAEtC,wDAAwD;QACxD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/E,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,MAAM,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;QAED,IAAI,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;YAC1C,OAAO,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC;QACtD,CAAC;QAED,kEAAkE;QAClE,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC3B,0BAA0B;YAC1B,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,aAAa,IAAI,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC3D,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,OAAO,kBAAkB,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,WAAW,EAAE;QAAE,OAAO,UAAU,CAAC;IACxC,IAAI,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,WAAW,CAAC;IACpC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB,EAClB,OAA2B,EAC3B,OAA8B,EAAE;IAEhC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,MAAM,SAAS,GAAsB,EAAE,CAAC;IAExC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,KAAK,KAAK,CAAC;QAC/C,IAAI,OAAO;YAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEvC,MAAM,OAAO,GACX,MAAM,CAAC,SAAS,KAAK,YAAY;YAC/B,CAAC,CAAC,MAAM,mBAAmB,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,MAAM,eAAe,CAAC,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAExE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC;YACjC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;gBACxC,SAAS,CAAC,IAAI,CAAC;oBACb,UAAU;oBACV,UAAU;oBACV,MAAM,EAAE,eAAe;iBACxB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;YACnF,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAC1E,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE;QAClC,KAAK;QACL,SAAS;KACV,CAAC;AACJ,CAAC;AAaD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAiB,EACjB,QAAgC,EAAE;IAElC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,8DAA8D;QAC9D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3D,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,wBAAwB;QACxB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,EAAE,CAAC;IACX,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,KAAuB;IAEvB,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAEpE,mFAAmF;IACnF,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnD,OAAO,YAAY,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QACtC,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC;gBACxB,OAAO;oBACL,MAAM,EAAE,UAAU;oBAClB,OAAO;oBACP,MAAM,EAAE,wEAAwE;iBACjF,CAAC;YACJ,CAAC;YACD,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,OAAO;oBACL,MAAM,EAAE,UAAU;oBAClB,OAAO;oBACP,MAAM,EAAE,4BAA4B;iBACrC,CAAC;YACJ,CAAC;YACD,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC/B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;YAC1C,CAAC;YACD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACxB,OAAO;oBACL,MAAM,EAAE,UAAU;oBAClB,OAAO;oBACP,MAAM,EAAE,2DAA2D;iBACpE,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAQD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,QAAkB,EAClB,OAAe;IAEf,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,YAAY,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,8CAA8C;QAC9C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAChC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO,YAAY,CAAC;QACxC,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3C,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvE,CAAC;AACH,CAAC;AAYD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,WAAmB,EACnB,OAAkD,EAAE;IAEpD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAElC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9B,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;YAC9E,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,SAAS,CAAC;YACtC,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;oBAAE,OAAO,SAAS,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,uDAAuD;YACzD,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,SAAS,CAAC;AACnB,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA4E,EAAE;IAE9E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhE,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAA8B,yBAAyB,CAAC;IAClE,IAAI,IAAI,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;QACxC,MAAM,GAAG,MAAM,gCAAgC,CAAC,EAAE,EAAE;YAClD,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AAClD,CAAC"}

package/dist/portable-location.d.ts

@@ -0,0 +1,84 @@
+import type { ScanDirs } from "./skill-index.js";
+/** A scan root with a stable, host-free label for portable handles. */
+export type ScanRoot = {
+    key: string;
+    rootPath: string;
+};
+export type ScanRootRegistry = ScanRoot[];
+export type ScanRootSpec = ScanDirs;
+export type HarnessKind = "grok" | "claude" | "codex" | "hermes";
+export type ScanRootContext = {
+    cwd: string;
+    syncRepoDir?: string;
+    syncEnabled?: boolean;
+    globalSkillsDirs: string[];
+    globalRulesDirs: string[];
+    projectSkillsDir: string;
+    projectRulesDir: string;
+    harness: HarnessKind;
+};
+export declare const HANDLE_PREFIX = "memex://";
+export type PortableLocationWarn = (message: string) => void;
+/** Filesystem path + optional memory section name (fragment decoded once). */
+export type ResolvedPortableLocation = {
+    filePath: string;
+    sectionName?: string;
+};
+/**
+ * Portable handles are opaque location tokens — not general URIs.
+ * Form: memex://{rootKey}/{posix-rel}[#{fragment}]
+ */
+/** Injective escape for rel segments and fragments (% first, then #). */
+export declare function escapePortableText(text: string): string;
+/** Reverse of escapePortableText (# last on decode, then %). */
+export declare function unescapePortableText(text: string): string;
+/** @alias escapePortableText */
+export declare const encodeFragment: typeof escapePortableText;
+/** @alias unescapePortableText */
+export declare const decodeFragment: typeof unescapePortableText;
+/**
+ * Split at the last literal '#' — escaped #s are %23 and do not split.
+ * Fragment is unescaped exactly once.
+ */
+export declare function splitPortableHandle(handle: string): {
+    body: string;
+    fragment?: string;
+};
+/** Stable fallback rootKey from normalized absolute dir path (§4.4 path-hash option). */
+export declare function stableUnclassifiedKey(kind: "skill" | "rule" | "memory", dir: string): string;
+/**
+ * Build labeled scan roots from harness context and scan directory spec.
+ * Same semantic root MUST use the same rootKey on every host (normative catalog).
+ */
+export declare function buildScanRoots(ctx: ScanRootContext, spec: ScanRootSpec): ScanRootRegistry;
+/**
+ * Absolute path (+ optional #fragment) → portable handle.
+ * Fail-open: returns null when mapping is impossible (caller should skip-with-warning).
+ */
+export declare function encodePortableLocation(registry: ScanRootRegistry, absolute: string, warn?: PortableLocationWarn, fragment?: string): string | null;
+/**
+ * Portable handle → absolute file path + optional section name.
+ * Fragment is split and %23-unescaped exactly once — never rejoin with '#'.
+ * Fail-closed on traversal escape.
+ */
+export declare function decodePortableLocationResolved(registry: ScanRootRegistry, handle: string): ResolvedPortableLocation;
+/**
+ * Portable handle → absolute path string (legacy join form).
+ * Prefer decodePortableLocationResolved when a fragment may be present.
+ */
+export declare function decodePortableLocation(registry: ScanRootRegistry, handle: string): string;
+/**
+ * Resolve portable handle or legacy absolute path for filesystem I/O.
+ * Phase 2: agent-facing read tools MUST pass `allowAbsolute: false` so untrusted
+ * absolute paths cannot bypass containment (memex-grok#19 closes only then).
+ */
+export declare function resolvePortableLocationResolved(registry: ScanRootRegistry, input: string, options?: {
+    warn?: PortableLocationWarn;
+    allowAbsolute?: boolean;
+}): ResolvedPortableLocation;
+/** @deprecated Prefer resolvePortableLocationResolved to avoid fragment double-decode. */
+export declare function resolvePortableLocation(registry: ScanRootRegistry, input: string, options?: {
+    warn?: PortableLocationWarn;
+    allowAbsolute?: boolean;
+}): string;
+//# sourceMappingURL=portable-location.d.ts.map

package/dist/portable-location.d.ts.map

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