@micacms/runtime 0.2.0

package/dist/services/staging-local.js

@@ -0,0 +1,391 @@
+/**
+ * Working-tree staging: local mode's half of the staging service.
+ *
+ * The checked-out working tree *is* the draft workspace. Autosave has already
+ * written the files — that is what lets the Astro dev server hot-reload them,
+ * which is the whole value of local mode — so this service's job is reading
+ * what Git thinks of the tree and, on Publish, turning exactly the reviewed
+ * paths into one commit and one push.
+ *
+ * Three rules keep it safe in a repository that belongs to a developer:
+ *
+ *   - Only Mica-managed paths. Every Git operation is limited to an explicit
+ *     path set derived from the change list — never `git add -A` over the
+ *     repository, so unrelated work in the same checkout is never swept in.
+ *   - HEAD is verified against the base the editor reviewed. A repository
+ *     that moved refuses, like a provider branch that moved.
+ *   - A commit and a push are two operations. When the push fails the commit
+ *     is retained and reported as `committed-pending-push`; a retry pushes
+ *     again and never creates a second commit.
+ */
+import { realpath, rm } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { MANIFEST_PATH, memorySource, } from "@micacms/core";
+import { within } from "@micacms/core/node";
+import { ApiError, badRequest } from "../lib/errors.js";
+import { firstLine, gitRunner, GitError } from "../lib/git.js";
+import { analyseChanges, compareSources, describeProblems, flattenProblems, } from "./staging.js";
+export function createWorkingTreeStagingService(deps) {
+    const { model, connector, contentRoot, logger } = deps;
+    // One Git mutation at a time. Editing is untouched — autosave writes files,
+    // not Git — this only refuses to interleave two commits or pushes.
+    let running = false;
+    /**
+     * Finds the repository the content root sits in, freshly each time: a
+     * `git init` after startup should start working, not require a restart.
+     */
+    const locate = async () => {
+        const probe = gitRunner(contentRoot);
+        try {
+            const repoRoot = await probe.run(["rev-parse", "--show-toplevel"]);
+            // Git reports the toplevel with symlinks resolved (`/private/var` where
+            // the caller said `/var`, on macOS). Resolve our side the same way, or
+            // the relative prefix walks out of the repository.
+            const resolved = await realpath(contentRoot);
+            return { git: gitRunner(repoRoot), prefix: toPosix(relative(repoRoot, resolved)) };
+        }
+        catch (error) {
+            return {
+                reason: error instanceof GitError && error.exitCode === null
+                    ? error.message
+                    : "The content directory is not inside a Git repository.",
+            };
+        }
+    };
+    const listChanges = async (workspace) => {
+        // `-uall` because Git collapses a fully-untracked directory to one line,
+        // and a brand-new entry is exactly that. The change list must name files.
+        const raw = await workspace.git.run([
+            "status",
+            "--porcelain=v1",
+            "-z",
+            "-uall",
+            "--",
+            workspace.prefix === "" ? "." : workspace.prefix,
+        ]);
+        return parseStatus(raw, workspace.prefix);
+    };
+    const analyse = async (treeChanges) => {
+        const { changes, validation } = await analyseChanges(model, connector, treeChanges);
+        // A merge conflict is a validity problem the field validator cannot see:
+        // the file on disk is Git's conflict format, not content.
+        for (const change of treeChanges) {
+            if (!change.conflicted)
+                continue;
+            validation.problems.push({
+                path: change.path,
+                label: change.path,
+                issues: [
+                    { path: "", message: "This file has a Git merge conflict. Resolve it with your Git tools." },
+                ],
+            });
+        }
+        validation.ok = validation.problems.length === 0;
+        return { changes, validation };
+    };
+    const guardPublishable = async () => {
+        if (!deps.publishEnabled) {
+            throw badRequest("Publishing from local mode is disabled (MICA_LOCAL_PUBLISH=false).");
+        }
+        const located = await locate();
+        if ("reason" in located)
+            throw badRequest(located.reason);
+        return located;
+    };
+    /** Runs `fn` holding the one-mutation-at-a-time flag. */
+    const exclusive = async (fn) => {
+        if (running) {
+            throw new ApiError("conflict", "A publication is already running. Wait for it to finish.");
+        }
+        running = true;
+        try {
+            return await fn();
+        }
+        finally {
+            running = false;
+        }
+    };
+    const pushOutcome = async (git, revision) => {
+        try {
+            await git.run(["push"]);
+            return { state: "published", revision };
+        }
+        catch (error) {
+            // The commit is real and retained; only the second half failed. This is
+            // a state, not an exception — the editor shows it and offers a retry.
+            const pushError = error instanceof GitError ? error.message : String(error);
+            logger.warn("Publish committed but the push failed", { revision, pushError });
+            return { state: "committed-pending-push", revision, pushError };
+        }
+    };
+    return {
+        async status() {
+            const located = await locate();
+            if ("reason" in located) {
+                return {
+                    workspace: "working-tree",
+                    publish: { enabled: false, reason: located.reason },
+                    baseRevision: null,
+                    branch: null,
+                    ahead: null,
+                    changes: [],
+                    validation: emptyValidation(),
+                    updatedAt: null,
+                };
+            }
+            const treeChanges = await listChanges(located);
+            const { changes, validation } = await analyse(treeChanges);
+            return {
+                workspace: "working-tree",
+                publish: deps.publishEnabled
+                    ? { enabled: true }
+                    : { enabled: false, reason: "Disabled with MICA_LOCAL_PUBLISH=false." },
+                baseRevision: await located.git.tryRun(["rev-parse", "HEAD"]),
+                branch: await located.git.tryRun(["rev-parse", "--abbrev-ref", "HEAD"]),
+                ahead: await aheadOfUpstream(located.git),
+                changes,
+                validation,
+                updatedAt: null,
+            };
+        },
+        async publish(input) {
+            const message = input.message.trim();
+            if (!message)
+                throw badRequest("A publication needs a commit message.");
+            const workspace = await guardPublishable();
+            return exclusive(async () => {
+                const treeChanges = await listChanges(workspace);
+                if (treeChanges.length === 0)
+                    throw badRequest("There is nothing to publish.");
+                /**
+                 * The reviewed base. The working tree has no per-path gate the way a
+                 * provider commit does — the tree is already the truth — so the gate
+                 * is HEAD: if the repository moved since the editor reviewed the
+                 * change list, what a commit would be based on is not what they saw.
+                 */
+                const head = await workspace.git.tryRun(["rev-parse", "HEAD"]);
+                if (input.expectedBase !== head) {
+                    throw new ApiError("conflict", "The repository moved while these changes were being reviewed. Refresh the " +
+                        "change list and publish again.");
+                }
+                // The model drift gate — same rule as the draft store: the staged set
+                // was validated against the model this process started with.
+                if ((await connector.revision(MANIFEST_PATH)) !== deps.schemaRevision) {
+                    throw new ApiError("conflict", "The content model changed after this server started. Restart Mica to load " +
+                        "the new model, then review the pending changes and publish again.");
+                }
+                const { validation } = await analyse(treeChanges);
+                if (!validation.ok) {
+                    throw new ApiError("validation_failed", describeProblems(validation.problems), {
+                        issues: flattenProblems(validation.problems),
+                    });
+                }
+                const paths = treeChanges.map((change) => inRepo(workspace.prefix, change.path));
+                try {
+                    // Stage and commit exactly the reviewed set. The pathspec limits
+                    // both operations, so anything else in the developer's index or
+                    // tree — staged or not — stays theirs.
+                    for (const batch of chunked(paths, 500)) {
+                        await workspace.git.run(["add", "-A", "--", ...batch]);
+                    }
+                    await workspace.git.run(["commit", "-m", message, "--", ...paths]);
+                }
+                catch (error) {
+                    if (error instanceof GitError) {
+                        // Git's own verdict is the actionable part: no identity
+                        // configured, a hook that refused, an unborn branch mid-rebase.
+                        throw new ApiError("conflict", `Git refused the commit: ${error.message}`);
+                    }
+                    throw error;
+                }
+                const revision = await workspace.git.run(["rev-parse", "HEAD"]);
+                logger.info("Published from the working tree", { revision, files: paths.length });
+                return pushOutcome(workspace.git, revision);
+            });
+        },
+        async push() {
+            const workspace = await guardPublishable();
+            return exclusive(async () => {
+                const revision = await workspace.git.tryRun(["rev-parse", "HEAD"]);
+                if (revision === null)
+                    throw badRequest("There is no commit to push yet.");
+                return pushOutcome(workspace.git, revision);
+            });
+        },
+        async discard(requested) {
+            const located = await locate();
+            if ("reason" in located)
+                throw badRequest(located.reason);
+            return exclusive(async () => {
+                // Only paths the change list actually names. Discard is the one
+                // destructive operation here, and it must not be able to reach
+                // anything the editor was not shown.
+                const current = new Map((await listChanges(located)).map((change) => [change.path, change]));
+                const discarded = [];
+                for (const path of requested) {
+                    const change = current.get(path);
+                    if (!change)
+                        continue;
+                    if (change.kind === "create") {
+                        // Nothing to restore: before this change there was no file. A
+                        // creation the developer had already staged is unstaged first,
+                        // so the index does not keep pointing at a file that is gone.
+                        if (!change.untracked) {
+                            await located.git.tryRun([
+                                "rm",
+                                "--cached",
+                                "--force",
+                                "--",
+                                inRepo(located.prefix, path),
+                            ]);
+                        }
+                        await rm(within(contentRoot, path), { force: true });
+                    }
+                    else {
+                        await located.git.run([
+                            "restore",
+                            "--source=HEAD",
+                            "--staged",
+                            "--worktree",
+                            "--",
+                            inRepo(located.prefix, path),
+                        ]);
+                    }
+                    discarded.push(path);
+                }
+                return { discarded };
+            });
+        },
+        async compare(target) {
+            const located = await locate();
+            // Without a repository (or before the first commit) nothing has ever
+            // been published, so the honest "before" is a source with no files.
+            const published = "reason" in located ? memorySource({}, "unpublished") : headSource(located);
+            return compareSources(model, published, connector, target);
+        },
+    };
+}
+/**
+ * The content root as HEAD has it — the published side of a comparison.
+ *
+ * Reading `HEAD:` rather than the tree is the point: the working tree *is*
+ * the draft workspace here, so the repository's own version of a document
+ * only exists in Git's object store.
+ */
+function headSource(workspace) {
+    const at = (path) => `HEAD:${path === "" ? workspace.prefix : inRepo(workspace.prefix, path)}`;
+    return {
+        origin: "HEAD",
+        async read(path) {
+            // tryRun, because "not in HEAD" and "no commits yet" both simply mean
+            // there is no published version. Stdout arrives trimmed, which the
+            // entry parsers already tolerate.
+            return workspace.git.tryRun(["show", at(path)]);
+        },
+        async list(path) {
+            const raw = await workspace.git.tryRun(["ls-tree", "-z", at(path)]);
+            if (raw === null)
+                return [];
+            const entries = [];
+            for (const field of raw.split("\0")) {
+                const tab = field.indexOf("\t");
+                if (tab === -1)
+                    continue;
+                const type = field.slice(0, tab).split(" ")[1];
+                entries.push({ name: field.slice(tab + 1), type: type === "tree" ? "directory" : "file" });
+            }
+            return entries;
+        },
+    };
+}
+/* ------------------------------------------------------------------ */
+function emptyValidation() {
+    return { ok: true, problems: [] };
+}
+function toPosix(path) {
+    return sep === "/" ? path : path.split(sep).join("/");
+}
+/** A content-root-relative path as Git sees it, from the repository root. */
+function inRepo(prefix, path) {
+    return prefix === "" ? path : join(prefix, path).split(sep).join("/");
+}
+function chunked(items, size) {
+    const batches = [];
+    for (let at = 0; at < items.length; at += size)
+        batches.push(items.slice(at, at + size));
+    return batches;
+}
+/** Commits waiting to be pushed, or null when there is no upstream to say. */
+async function aheadOfUpstream(git) {
+    const counted = await git.tryRun(["rev-list", "--count", "@{upstream}..HEAD"]);
+    if (counted === null)
+        return null;
+    const ahead = Number(counted);
+    return Number.isFinite(ahead) ? ahead : null;
+}
+/**
+ * Parses `git status --porcelain=v1 -z` into content-root-relative changes.
+ *
+ * The `-z` format is the one that never munges a path: entries are
+ * NUL-terminated, and a rename is two fields — the new path, then the one it
+ * came from. A rename becomes a create and a delete, which is how the rest of
+ * Mica already thinks about moves.
+ *
+ * `.mica/` is excluded. The manifest there is build output a developer
+ * commits with their own tools; the editor neither shows nor publishes it,
+ * and model changes are guarded separately, by the drift check.
+ */
+export function parseStatus(raw, prefix) {
+    const fields = raw.split("\0").filter((field) => field !== "");
+    const changes = [];
+    const push = (repoPath, kind, flags = {}) => {
+        const path = relativeToContent(repoPath, prefix);
+        if (path === null || path === ".mica" || path.startsWith(".mica/"))
+            return;
+        changes.push({
+            path,
+            kind,
+            untracked: flags.untracked ?? false,
+            conflicted: flags.conflicted ?? false,
+        });
+    };
+    for (let at = 0; at < fields.length; at += 1) {
+        const field = fields[at];
+        const x = field[0] ?? " ";
+        const y = field[1] ?? " ";
+        const repoPath = field.slice(3);
+        if (x === "?" && y === "?") {
+            push(repoPath, "create", { untracked: true });
+            continue;
+        }
+        // Both sides touched it in a merge, or one side deleted while the other
+        // edited: the file is in Git's conflict state, whatever the tree holds.
+        if (x === "U" || y === "U" || (x === "A" && y === "A") || (x === "D" && y === "D")) {
+            push(repoPath, "update", { conflicted: true });
+            continue;
+        }
+        if (x === "R" || x === "C") {
+            // The next field is the source path. A copy keeps its source; a rename
+            // loses it, which the status letters already said (C keeps both files).
+            const from = fields[++at];
+            push(repoPath, "create");
+            if (x === "R")
+                push(from, "delete");
+            continue;
+        }
+        if (x === "D" || y === "D") {
+            push(repoPath, "delete");
+            continue;
+        }
+        push(repoPath, x === "A" ? "create" : "update");
+    }
+    return changes;
+}
+function relativeToContent(repoPath, prefix) {
+    if (prefix === "")
+        return repoPath;
+    if (repoPath === prefix)
+        return null;
+    return repoPath.startsWith(`${prefix}/`) ? repoPath.slice(prefix.length + 1) : null;
+}
+//# sourceMappingURL=staging-local.js.map

package/dist/services/staging-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging-local.js","sourceRoot":"","sources":["../../src/services/staging-local.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,EACL,aAAa,EACb,YAAY,GAMb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAkB,MAAM,eAAe,CAAC;AAE/E,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,GAOhB,MAAM,cAAc,CAAC;AA6BtB,MAAM,UAAU,+BAA+B,CAC7C,IAA4B;IAE5B,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEvD,4EAA4E;IAC5E,mEAAmE;IACnE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB;;;OAGG;IACH,MAAM,MAAM,GAAG,KAAK,IAA6C,EAAE;QACjE,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;YACnE,wEAAwE;YACxE,uEAAuE;YACvE,mDAAmD;YACnD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC7C,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EACJ,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;oBAClD,CAAC,CAAC,KAAK,CAAC,OAAO;oBACf,CAAC,CAAC,uDAAuD;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,SAAoB,EAAyB,EAAE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAClC,QAAQ;YACR,gBAAgB;YAChB,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,SAAS,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM;SACjD,CAAC,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,EAAE,WAAyB,EAAE,EAAE;QAClD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAEpF,yEAAyE;QACzE,0DAA0D;QAC1D,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,UAAU;gBAAE,SAAS;YACjC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,IAAI;gBAClB,MAAM,EAAE;oBACN,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,qEAAqE,EAAE;iBAC7F;aACF,CAAC,CAAC;QACL,CAAC;QACD,UAAU,CAAC,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;QAEjD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,KAAK,IAAwB,EAAE;QACtD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,UAAU,CAAC,oEAAoE,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,MAAM,EAAE,CAAC;QAC/B,IAAI,QAAQ,IAAI,OAAO;YAAE,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,yDAAyD;IACzD,MAAM,SAAS,GAAG,KAAK,EAAK,EAAoB,EAAc,EAAE;QAC9D,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,0DAA0D,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,GAAc,EAAE,QAAgB,EAA0B,EAAE;QACrF,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wEAAwE;YACxE,sEAAsE;YACtE,MAAM,SAAS,GAAG,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9E,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QAClE,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,MAAM;YACV,MAAM,OAAO,GAAG,MAAM,MAAM,EAAE,CAAC;YAE/B,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;gBACxB,OAAO;oBACL,SAAS,EAAE,cAAc;oBACzB,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;oBACnD,YAAY,EAAE,IAAI;oBAClB,MAAM,EAAE,IAAI;oBACZ,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,EAAE;oBACX,UAAU,EAAE,eAAe,EAAE;oBAC7B,SAAS,EAAE,IAAI;iBAChB,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;YAE3D,OAAO;gBACL,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,IAAI,CAAC,cAAc;oBAC1B,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;oBACnB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,yCAAyC,EAAE;gBACzE,YAAY,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBAC7D,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;gBACvE,KAAK,EAAE,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC;gBACzC,OAAO;gBACP,UAAU;gBACV,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,KAAmB;YAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO;gBAAE,MAAM,UAAU,CAAC,uCAAuC,CAAC,CAAC;YAExE,MAAM,SAAS,GAAG,MAAM,gBAAgB,EAAE,CAAC;YAE3C,OAAO,SAAS,CAAC,KAAK,IAAI,EAAE;gBAC1B,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;gBACjD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,UAAU,CAAC,8BAA8B,CAAC,CAAC;gBAE/E;;;;;mBAKG;gBACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC/D,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;oBAChC,MAAM,IAAI,QAAQ,CAChB,UAAU,EACV,4EAA4E;wBAC1E,gCAAgC,CACnC,CAAC;gBACJ,CAAC;gBAED,sEAAsE;gBACtE,6DAA6D;gBAC7D,IAAI,CAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;oBACtE,MAAM,IAAI,QAAQ,CAChB,UAAU,EACV,4EAA4E;wBAC1E,mEAAmE,CACtE,CAAC;gBACJ,CAAC;gBAED,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;gBAClD,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;oBACnB,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;wBAC7E,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC;qBAC7C,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAEjF,IAAI,CAAC;oBACH,iEAAiE;oBACjE,gEAAgE;oBAChE,uCAAuC;oBACvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;wBACxC,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;oBACzD,CAAC;oBACD,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;gBACrE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;wBAC9B,wDAAwD;wBACxD,gEAAgE;wBAChE,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC7E,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;gBAChE,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAElF,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,IAAI;YACR,MAAM,SAAS,GAAG,MAAM,gBAAgB,EAAE,CAAC;YAE3C,OAAO,SAAS,CAAC,KAAK,IAAI,EAAE;gBAC1B,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;gBACnE,IAAI,QAAQ,KAAK,IAAI;oBAAE,MAAM,UAAU,CAAC,iCAAiC,CAAC,CAAC;gBAC3E,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,SAAmB;YAC/B,MAAM,OAAO,GAAG,MAAM,MAAM,EAAE,CAAC;YAC/B,IAAI,QAAQ,IAAI,OAAO;gBAAE,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE1D,OAAO,SAAS,CAAC,KAAK,IAAI,EAAE;gBAC1B,gEAAgE;gBAChE,+DAA+D;gBAC/D,qCAAqC;gBACrC,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CACpE,CAAC;gBAEF,MAAM,SAAS,GAAa,EAAE,CAAC;gBAC/B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;oBAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACjC,IAAI,CAAC,MAAM;wBAAE,SAAS;oBAEtB,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC7B,8DAA8D;wBAC9D,+DAA+D;wBAC/D,8DAA8D;wBAC9D,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;4BACtB,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gCACvB,IAAI;gCACJ,UAAU;gCACV,SAAS;gCACT,IAAI;gCACJ,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;6BAC7B,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;oBACvD,CAAC;yBAAM,CAAC;wBACN,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;4BACpB,SAAS;4BACT,eAAe;4BACf,UAAU;4BACV,YAAY;4BACZ,IAAI;4BACJ,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;yBAC7B,CAAC,CAAC;oBACL,CAAC;oBACD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;gBAED,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,MAAqB;YACjC,MAAM,OAAO,GAAG,MAAM,MAAM,EAAE,CAAC;YAC/B,qEAAqE;YACrE,oEAAoE;YACpE,MAAM,SAAS,GAAG,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC9F,OAAO,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,SAAoB;IACtC,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;IAEvG,OAAO;QACL,MAAM,EAAE,MAAM;QAEd,KAAK,CAAC,IAAI,CAAC,IAAI;YACb,sEAAsE;YACtE,mEAAmE;YACnE,kCAAkC;YAClC,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI;YACb,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpE,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YAE5B,MAAM,OAAO,GAAqB,EAAE,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChC,IAAI,GAAG,KAAK,CAAC,CAAC;oBAAE,SAAS;gBACzB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7F,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wEAAwE;AAExE,SAAS,eAAe;IACtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,6EAA6E;AAC7E,SAAS,MAAM,CAAC,MAAc,EAAE,IAAY;IAC1C,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,OAAO,CAAI,KAAU,EAAE,IAAY;IAC1C,MAAM,OAAO,GAAU,EAAE,CAAC;IAC1B,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACzF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,KAAK,UAAU,eAAe,CAAC,GAAc;IAC3C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC/E,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAAc;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAE,IAAwB,EAAE,QAAuD,EAAE,EAAE,EAAE;QACrH,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO;QAC3E,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,IAAI;YACJ,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;YACnC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,KAAK;SACtC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEhC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,SAAS;QACX,CAAC;QAED,wEAAwE;QACxE,wEAAwE;QACxE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACnF,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,uEAAuE;YACvE,wEAAwE;YACxE,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,EAAE,CAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG;gBAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,MAAc;IACzD,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACnC,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtF,CAAC"}

package/dist/services/staging.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Content staging: the orchestration between "saved" and "published".
+ *
+ * Two implementations of one service, because the two deployment shapes have
+ * genuinely different draft workspaces:
+ *
+ *   - working tree  (`staging-local.ts`): the checkout is the draft. Autosave
+ *     writes files the Astro dev server can hot-reload, which is the whole
+ *     value of local mode; Recent changes is `git status`, and Publish is a
+ *     real commit and push through the developer's own Git.
+ *   - draft store   (this file): the repository is remote and writing through
+ *     its API would already be a commit, so saves accumulate in SQLite and
+ *     Publish turns the whole set into one provider-side commit.
+ *
+ * The editor sees one API either way. What differs is only what Saved means —
+ * and the two must stay visibly different words in the UI, because in neither
+ * mode does Saved imply that a change is in Git.
+ */
+import type { Author, RepositoryConnector } from "@micacms/connectors";
+import { type ContentChange, type ContentSource, type DraftStore, type FieldIssue, type PublishResult, type Site } from "@micacms/core";
+/** Where the change happened, in words an editor recognises. */
+export type ChangeOwner = {
+    kind: "entry";
+    collection: string;
+    slug: string;
+    label: string;
+} | {
+    kind: "singleton";
+    name: string;
+    label: string;
+} | {
+    kind: "order";
+    collection: string;
+    label: string;
+} | {
+    kind: "media";
+    label: string;
+} | {
+    kind: "other";
+    label: string;
+};
+export interface AnnotatedChange extends ContentChange {
+    owner: ChangeOwner;
+}
+/** One thing that would make the staged result unpublishable. */
+export interface StagingProblem {
+    /** The file the problem is about, relative to the content root. */
+    path: string;
+    label: string;
+    issues: FieldIssue[];
+}
+export interface StagingValidation {
+    ok: boolean;
+    problems: StagingProblem[];
+}
+export interface StagingStatus {
+    /** How this deployment stages. The UI words differ with it. */
+    workspace: "working-tree" | "draft-store";
+    publish: {
+        enabled: boolean;
+        reason?: string;
+    };
+    /**
+     * What the pending changes are based on: HEAD for a working tree, the
+     * branch head for a draft store. Sent back with Publish as `expectedBase`.
+     */
+    baseRevision: string | null;
+    /** The branch a publication lands on, where the workspace knows it. */
+    branch: string | null;
+    /** Commits created and not yet pushed. Working tree only. */
+    ahead: number | null;
+    changes: AnnotatedChange[];
+    validation: StagingValidation;
+    /** When the pending set last moved. Null when nothing is pending. */
+    updatedAt: string | null;
+}
+export interface PublishInput {
+    /** Subject line of the commit. Written by the editor, for `git log`. */
+    message: string;
+    /** The base the editor reviewed. A repository that moved past it refuses. */
+    expectedBase: string | null;
+    author?: Author;
+}
+export interface ContentStagingService {
+    status(): Promise<StagingStatus>;
+    publish(input: PublishInput): Promise<PublishResult>;
+    discard(paths: string[]): Promise<{
+        discarded: string[];
+    }>;
+    /** Retries the push after `committed-pending-push`. Working tree only. */
+    push(): Promise<PublishResult>;
+    /** The document a pending change touches, before and after that change. */
+    compare(target: CompareTarget): Promise<Comparison>;
+}
+/** One thing an editor recognises on the Publish page, named for comparison. */
+export type CompareTarget = {
+    kind: "entry";
+    collection: string;
+    slug: string;
+} | {
+    kind: "singleton";
+    name: string;
+} | {
+    kind: "order";
+    collection: string;
+};
+/**
+ * A document on both sides of the pending change set.
+ *
+ * Raw field data, deliberately: the editor holds the model and can name,
+ * order and render every field, so the friendly comparison is its job. What
+ * only the server can do is read the same document from two places.
+ */
+export interface Comparison {
+    /** As the repository has it — null when the change creates the document. */
+    before: Record<string, unknown> | null;
+    /** As staged for publication — null when the change deletes it. */
+    after: Record<string, unknown> | null;
+}
+/**
+ * Reads one document from the repository (`published`) and from the pending
+ * workspace (`staged`) — the whole of a before/after comparison, shared by
+ * both staging implementations since a `ContentSource` is all it needs.
+ *
+ * An order target compares the collection's ordering rather than a document:
+ * each side becomes `{ order: [{ slug, title }] }`, in position order.
+ */
+export declare function compareSources(model: Site, published: ContentSource, staged: ContentSource, target: CompareTarget): Promise<Comparison>;
+/**
+ * Annotates a change set with owners and validates the entries it touches.
+ *
+ * One pass on purpose: naming a change and validating it both need the same
+ * read of the same entries, and content trees are small enough to read the
+ * affected collections whole.
+ *
+ * Validation is scoped to *changed* documents. Content that was already in
+ * the repository is not this publication's problem — refusing
+ * to publish a fixed typo because somebody once hand-committed a broken entry
+ * elsewhere would make the editor hostage to history it cannot touch.
+ */
+export declare function analyseChanges(model: Site, source: ContentSource, changes: ContentChange[]): Promise<{
+    changes: AnnotatedChange[];
+    validation: StagingValidation;
+}>;
+/**
+ * Which piece of content a file belongs to.
+ *
+ * The path layout is the model's own (`layout.ts`), so this is a reading of
+ * it, not a second convention: `collection/slug/…` or `collection/slug.json`,
+ * `singleton.json` or `singleton/…`, and the shared `media/` directory.
+ */
+export declare function classifyPath(model: Site, path: string): ChangeOwner;
+export interface DraftStagingDeps {
+    model: Site;
+    drafts: DraftStore;
+    /** The real repository. The one thing here that writes to it. */
+    repository: RepositoryConnector;
+    /** The staged overlay the rest of the application reads through. */
+    overlay: RepositoryConnector;
+    /** Revision of `.mica/schema.json` when the model was loaded. */
+    schemaRevision: string | null;
+}
+export declare function createDraftStagingService(deps: DraftStagingDeps): ContentStagingService;
+export declare function describeProblems(problems: StagingProblem[]): string;
+/** Field issues with the file path folded in, for the flat API envelope. */
+export declare function flattenProblems(problems: StagingProblem[]): FieldIssue[];
+//# sourceMappingURL=staging.d.ts.map

package/dist/services/staging.d.ts.map

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