loadout-ai 0.4.0 → 0.5.0

package/dist/src/core/snapshot.js

@@ -10,6 +10,7 @@ export async function createSnapshot(paths, options = {}) {
             .digest("hex")
             .slice(0, 12)}`,
         createdAt: new Date().toISOString(),
+        ...(options.label ? { label: options.label } : {}),
         roots: normalizedRoots,
         files: [],
     };
@@ -154,6 +155,22 @@ export async function listSnapshotIds() {
         throw error;
     }
 }
+function changedEntryCount(before, after) {
+    if (!after)
+        return undefined;
+    const previous = new Map(before.map((file) => [file.path, file]));
+    const next = new Map(after.map((file) => [file.path, file]));
+    return [...new Set([...previous.keys(), ...next.keys()])].filter((path) => JSON.stringify(previous.get(path)) !== JSON.stringify(next.get(path))).length;
+}
+export function summarizeSnapshot(snapshot) {
+    return {
+        id: snapshot.id,
+        createdAt: snapshot.createdAt,
+        label: snapshot.label ?? "managed change",
+        roots: snapshot.roots.length,
+        changedEntries: changedEntryCount(snapshot.files, snapshot.postMutationFiles),
+    };
+}
 const SNAPSHOT_ID = /^\d{10,}-[a-f0-9]{12}$/;
 function isSnapshotId(value) {
     return SNAPSHOT_ID.test(value);
@@ -186,6 +203,9 @@ export function validateSnapshot(value) {
     if (typeof value.createdAt !== "string" ||
         !Number.isFinite(Date.parse(value.createdAt)))
         throw new Error("Snapshot creation time is invalid");
+    if (value.label !== undefined &&
+        (typeof value.label !== "string" || value.label.trim().length === 0))
+        throw new Error("Snapshot label is invalid");
     if (!Array.isArray(value.roots) ||
         value.roots.length === 0 ||
         !value.roots.every((root) => typeof root === "string" && root.length > 0))

package/dist/src/core/state.js

@@ -302,6 +302,15 @@ export async function recordInstallTransaction(entries, mcpEntries, snapshotId)
     await writeInstallState(state);
     return { installs, mcpInstalls };
 }
+/** Record one externally formatted but Loadout-managed MCP entry. */
+export async function recordMcpInstall(record) {
+    const state = await readInstallState();
+    state.mcpInstalls = [
+        ...(state.mcpInstalls ?? []).filter((entry) => entry.packageId !== record.packageId),
+        record,
+    ];
+    await writeInstallState(state);
+}
 export async function forgetInstall(packageId) {
     const state = await readInstallState();
     const installs = state.installs.filter((entry) => entry.packageId !== packageId);

package/dist/src/core/sync.js

@@ -343,6 +343,6 @@ export async function applySyncPlan(plan, lockPath = "loadout.lock", options = {
             await writeMcpConfigPlan(entry.plan);
         await recordInstallTransaction(freshPlan.packages, freshPlan.mcpPlans, snapshot.id);
         await writeLockfile(freshPlan.resolvedManifest ?? (await readManifest(freshPlan.manifest)), lockPath);
-    });
+    }, { label: "synchronize loadout manifest" });
     return { snapshotId: applied.snapshotId, lockfile: lockPath };
 }

package/dist/src/core/target-occupancy.js

@@ -0,0 +1,50 @@
+import { lstat, readdir } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Inspect a prospective skill target without following symlinks or executing
+ * any content. Missing paths and recursively empty directories are safe to
+ * replace; every uncertain state fails closed.
+ */
+export async function inspectTargetOccupancy(path, maximumEntries = 10_000) {
+    let root;
+    try {
+        root = await lstat(path);
+    }
+    catch (error) {
+        if (error &&
+            typeof error === "object" &&
+            "code" in error &&
+            error.code === "ENOENT")
+            return { occupied: false };
+        return { occupied: true, reason: "unreadable" };
+    }
+    if (root.isSymbolicLink())
+        return { occupied: true, reason: "symlink" };
+    if (!root.isDirectory())
+        return { occupied: true, reason: "unsupported" };
+    const queue = [path];
+    let inspected = 0;
+    while (queue.length) {
+        const directory = queue.pop();
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch {
+            return { occupied: true, reason: "unreadable" };
+        }
+        for (const entry of entries) {
+            inspected += 1;
+            if (inspected > maximumEntries)
+                return { occupied: true, reason: "inspection-limit" };
+            if (entry.isDirectory() && !entry.isSymbolicLink())
+                queue.push(join(directory, entry.name));
+            else
+                return {
+                    occupied: true,
+                    reason: entry.isSymbolicLink() ? "symlink" : "content",
+                };
+        }
+    }
+    return { occupied: false };
+}

package/dist/src/core/transaction.js

@@ -123,13 +123,14 @@ export async function withMutationLock(operation) {
  * global lock. Network/source preparation should happen before this boundary;
  * every state-dependent precondition belongs in `prepare`.
  */
-export async function runMutationTransaction(prepare, mutate) {
+export async function runMutationTransaction(prepare, mutate, options = {}) {
     const mutationLock = await acquireMutationLock();
     let transaction;
     try {
         const prepared = await prepare();
         const snapshot = await createSnapshot(prepared.targets, {
             persist: false,
+            label: options.label,
         });
         transaction = await beginTransaction(snapshot, prepared.targets, {
             mutationLock,

package/dist/src/shared/schemas.js

@@ -275,6 +275,7 @@ export const installRecordSchema = z
     files: z.array(fileHashSchema),
     snapshotId: text,
     installedAt: text,
+    configFormat: z.enum(["json", "codex-toml"]).optional(),
     staticAssessment: z
         .object({
         status: z.enum(["clear", "warning", "blocking"]),

package/docs/CATALOG.md

@@ -1,6 +1,6 @@
 # Catalog and upstream credits
 
-Loadout's bundled catalog indexes 50 public upstream repositories. This page gives every project a direct source link and exposes the exact reviewed revision used by Loadout.
+Loadout's bundled catalog indexes 51 public upstream repositories. This page gives every project a direct source link and exposes the exact reviewed revision used by Loadout.
 
 Thank you to every maintainer and contributor whose work appears here. Loadout does not own, endorse for its authors, or relicense these projects. Each project remains governed by its upstream license and current terms.
 
@@ -14,7 +14,7 @@ Thank you to every maintainer and contributor whose work appears here. Loadout d
 
 The machine-readable catalog remains the source of truth. Run `loadout catalog --coverage --json` to inspect coverage and `loadout capabilities` to inspect what each local agent adapter can actually manage.
 
-## All 50 credited repositories
+## All 51 credited repositories
 
 | Upstream source                                                                   | Loadout ID                       | Category                 | Reviewed components        | License status      | Reviewed revision                                                                                                       |
 | --------------------------------------------------------------------------------- | -------------------------------- | ------------------------ | -------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------- |
@@ -68,6 +68,7 @@ The machine-readable catalog remains the source of truth. Run `loadout catalog -
 | [MCP Toolbox for Databases](https://github.com/googleapis/mcp-toolbox)            | `mcp-toolbox-for-databases`      | database                 | `mcp`                      | `Apache-2.0`        | [`b574b071fc27`](https://github.com/googleapis/mcp-toolbox/tree/b574b071fc27f717e90b4362864b1086be0c8995)               |
 | [Browserbase MCP Server](https://github.com/browserbase/mcp-server-browserbase)   | `browserbase-mcp-server`         | browser-automation       | `mcp`                      | `Apache-2.0`        | [`1e196b3d3c4d`](https://github.com/browserbase/mcp-server-browserbase/tree/1e196b3d3c4dc70944e0d19038dd9eb3608b207a)   |
 | [Bright Data MCP](https://github.com/brightdata/brightdata-mcp)                   | `bright-data-mcp`                | web-research             | `mcp`                      | `MIT`               | [`adbfdd49b880`](https://github.com/brightdata/brightdata-mcp/tree/adbfdd49b8805136662a264490118c2688da3e29)            |
+| [Obsidian Skills](https://github.com/kepano/obsidian-skills)                      | `obsidian-skills`                | knowledge-management     | `skill`, `plugin`          | `MIT`               | [`a1dc48e68138`](https://github.com/kepano/obsidian-skills/tree/a1dc48e68138490d522c04cbf5822214c6eb1202)               |
 
 ## Catalog maintenance