directus-deploy-cli 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# directus-deploy-cli
+
+Per-entity, non-atomic Directus deployment tool. Reconciles code + config from a git repository to any Directus environment. Handles collections, fields, relations, roles, policies, permissions, flows, operations, raw-SQL migrations, register manifests, and seed data.
+
+## Why not the built-in schema apply?
+
+Directus's `/schema/apply` is atomic — one edge case ("field already exists", "relationship already associated", dangling `meta.group` ref, adopted-but-unregistered raw-SQL column) blocks every other change. In a repo with many contributors, multiple environments, and raw-SQL adopted tables, that atomic model becomes a firefight generator.
+
+`directus-deploy` iterates each entity independently: `GET → POST | PATCH | SKIP`. If one entity fails, the other 900 still apply. Per-entity report tells you exactly what changed and why the skips/failures happened.
+
+## Install
+
+```
+npm install -g directus-deploy-cli
+```
+
+## Use
+
+```
+DIRECTUS_URL=https://your-directus DIRECTUS_TOKEN=... \
+  directus-deploy verify \
+    --snapshot-dir=./directus_config/snapshot \
+    --config-dir=./directus_config/collections \
+    --seed-dir=./directus_config/seed \
+    --migrations-dir=./migrations \
+    --register-dir=./migrations/register
+```
+
+Commands: `plan` (dry-run report), `apply` (reconcile), `verify` (drift check; exits non-zero if apply would change anything).
+
+## MCP server
+
+Ships an MCP server exposing `directus_plan` / `directus_apply` / `directus_verify` as structured tools. Register in your Claude client's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "directus-deploy": {
+      "command": "node",
+      "args": ["<abs-path>/node_modules/directus-deploy-cli/dist/mcp-server.js"],
+      "env": { "DIRECTUS_URL": "...", "DIRECTUS_TOKEN": "..." }
+    }
+  }
+}
+```
+
+## On-disk layout
+
+Compatible with the `directus-sync`-style tree:
+
+```
+directus_config/
+  snapshot/{collections,fields,relations}/*.json
+  collections/{roles,policies,permissions,flows,operations}.json
+  seed/*.json
+migrations/*.sql
+migrations/register/*.json
+```
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { run } from "./runner.js";
+import { formatHuman, formatJson } from "./report.js";
+import { createDirectusClient } from "./http.js";
+const KNOWN_ENTITIES = [
+    "collections",
+    "fields",
+    "relations",
+    "roles",
+    "policies",
+    "permissions",
+    "flows",
+    "operations",
+    "migrations",
+    "seeds",
+];
+function parseEntities(csv) {
+    const parts = csv
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    const set = new Set();
+    for (const p of parts) {
+        if (!KNOWN_ENTITIES.includes(p)) {
+            throw new Error(`unknown entity kind '${p}' (expected: ${KNOWN_ENTITIES.join(", ")})`);
+        }
+        set.add(p);
+    }
+    return set;
+}
+function readCommon(flags) {
+    const url = flags.url ?? process.env.DIRECTUS_URL;
+    const token = flags.token ?? process.env.DIRECTUS_TOKEN;
+    if (!url)
+        throw new Error("--url or DIRECTUS_URL required");
+    if (!token)
+        throw new Error("--token or DIRECTUS_TOKEN required");
+    const target = flags.target ?? new URL(url).hostname;
+    const entities = parseEntities(flags.entities);
+    const onlyCollections = flags.onlyCollections
+        ? new Set(flags.onlyCollections.split(",").map((s) => s.trim()).filter(Boolean))
+        : undefined;
+    return {
+        url,
+        token,
+        target,
+        entities,
+        onlyCollections,
+        snapshotDir: flags.snapshotDir,
+        configDir: flags.configDir,
+        registerDir: flags.registerDir,
+        migrationsDir: flags.migrationsDir,
+        seedDir: flags.seedDir,
+        json: Boolean(flags.json),
+    };
+}
+async function execute(mode, flags) {
+    const common = readCommon(flags);
+    const client = createDirectusClient({ baseUrl: common.url, token: common.token });
+    const opts = { dryRun: mode.dryRun, onlyCollections: common.onlyCollections };
+    const report = await run({
+        target: common.target,
+        paths: {
+            snapshotDir: common.snapshotDir,
+            configDir: common.configDir,
+            registerDir: common.registerDir,
+        },
+        migrationsDir: common.migrationsDir,
+        seedDir: common.seedDir,
+        client,
+        opts,
+        entities: common.entities,
+    });
+    if (common.json) {
+        process.stdout.write(formatJson(report) + "\n");
+    }
+    else {
+        process.stdout.write(formatHuman(report) + "\n");
+    }
+    if (report.counts.failed > 0)
+        return 1;
+    if (mode.strict) {
+        // Verify: any drift (created/updated) means the target didn't match git.
+        // `skipped` is intentional (adopted-but-unregistered raw-SQL columns,
+        // register-manifest collections) — never treated as drift.
+        if (report.counts.created > 0 || report.counts.updated > 0) {
+            process.stderr.write(`verify: drift detected (${report.counts.created} would-create, ${report.counts.updated} would-update)\n`);
+            return 1;
+        }
+    }
+    return 0;
+}
+const program = new Command();
+program
+    .name("directus-deploy")
+    .description("Reconcile a Directus environment to the state described in directus_config/snapshot/. Per-entity, non-atomic.")
+    .version("0.1.0");
+function attachCommon(cmd) {
+    return cmd
+        .option("--url <url>", "Directus base URL (env: DIRECTUS_URL)")
+        .option("--token <token>", "Directus admin token (env: DIRECTUS_TOKEN)")
+        .option("--target <label>", "friendly label for logs (default: URL hostname)")
+        .option("--entities <csv>", `comma-separated subset of ${KNOWN_ENTITIES.join(",")}`, KNOWN_ENTITIES.join(","))
+        .option("--only-collections <csv>", "restrict run to these collection names")
+        .option("--snapshot-dir <path>", "path to directus_config/snapshot", "./directus_config/snapshot")
+        .option("--config-dir <path>", "path to directus_config/collections (holds policies.json, permissions.json, roles.json, …)", "./directus_config/collections")
+        .option("--register-dir <path>", "path to migrations/register", "./migrations/register")
+        .option("--seed-dir <path>", "path to directus_config/seed (Tractr-style {collection, meta, data} files)", "./directus_config/seed")
+        .option("--migrations-dir <path>", "path to migrations/*.sql (raw SQL, tracked in lola_deploy_migrations)", "./migrations")
+        .option("--json", "emit JSON report instead of human-readable");
+}
+attachCommon(program.command("plan"))
+    .description("Dry-run: report what would change without writing.")
+    .action(async (_, cmd) => {
+    process.exit(await execute({ dryRun: true }, cmd.optsWithGlobals()));
+});
+attachCommon(program.command("apply"))
+    .description("Apply the desired state to the target env.")
+    .action(async (_, cmd) => {
+    process.exit(await execute({ dryRun: false }, cmd.optsWithGlobals()));
+});
+attachCommon(program.command("verify"))
+    .description("Post-apply drift check. Runs plan-mode and exits non-zero if any entity would be created or updated (idempotency guard for CI).")
+    .action(async (_, cmd) => {
+    process.exit(await execute({ dryRun: true, strict: true }, cmd.optsWithGlobals()));
+});
+program.parseAsync(process.argv).catch((e) => {
+    process.stderr.write(`directus-deploy: ${e.message}\n`);
+    process.exit(2);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/diff.js

@@ -0,0 +1,31 @@
+// diff_subset — true iff desired has any key/value that differs from (or is
+// missing in) actual. The live Directus row usually carries server-only keys
+// we don't manage (id, timestamps); we ignore those by asymmetric compare.
+export function diffSubset(desired, actual) {
+    if (desired === null || desired === undefined) {
+        // A null/undefined desired doesn't force a diff — the caller should
+        // only pass in the block they intend to reconcile.
+        return false;
+    }
+    if (typeof desired !== "object") {
+        return desired !== actual;
+    }
+    if (Array.isArray(desired)) {
+        if (!Array.isArray(actual))
+            return true;
+        if (desired.length !== actual.length)
+            return true;
+        return desired.some((v, i) => diffSubset(v, actual[i]));
+    }
+    if (actual === null || actual === undefined || typeof actual !== "object" || Array.isArray(actual)) {
+        return true;
+    }
+    const dObj = desired;
+    const aObj = actual;
+    for (const [k, v] of Object.entries(dObj)) {
+        if (diffSubset(v, aObj[k]))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAE3E,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,MAAe;IAC1D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9C,oEAAoE;QACpE,mDAAmD;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,KAAK,MAAM,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAClD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnG,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,OAAkC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAiC,CAAC;IAC/C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/http.js

@@ -0,0 +1,114 @@
+function toErr(url, status, body) {
+    const e = new Error(`${status} ${url} :: ${body}`);
+    e.status = status;
+    e.body = body;
+    return e;
+}
+// Small VMs (test.lola.market) 503 with `Service "api" is unavailable. Under
+// pressure.` during bulk apply. Retry with exponential backoff — the caller
+// has no way to distinguish this from a real outage.
+const RETRY_STATUSES = new Set([503, 502, 504]);
+const MAX_RETRIES = 6;
+function backoffMs(attempt) {
+    // 500, 1000, 2000, 4000, 8000, 16000 ms — cumulative ~31s
+    return 500 * Math.pow(2, attempt);
+}
+async function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+export function createDirectusClient(cfg) {
+    const base = cfg.baseUrl.replace(/\/+$/, "");
+    const fetchImpl = cfg.fetch ?? globalThis.fetch;
+    const headers = {
+        Authorization: `Bearer ${cfg.token}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+    };
+    async function readJson(r) {
+        if (r.status === 204)
+            return {};
+        const text = await r.text();
+        if (!text)
+            return {};
+        try {
+            const j = JSON.parse(text);
+            return (j && typeof j === "object" ? j : {}) ?? {};
+        }
+        catch {
+            throw toErr(r.url, r.status, text);
+        }
+    }
+    async function fetchWithRetry(url, init) {
+        let lastErr = undefined;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                const r = await fetchImpl(url, init);
+                if (!RETRY_STATUSES.has(r.status))
+                    return r;
+                if (attempt === MAX_RETRIES)
+                    return r;
+                // Drain body so the connection is reusable.
+                try {
+                    await r.text();
+                }
+                catch { /* ignore */ }
+            }
+            catch (e) {
+                // Network error (ECONNRESET/EAI_AGAIN) — retry the same window.
+                lastErr = e;
+                if (attempt === MAX_RETRIES)
+                    throw e;
+            }
+            await sleep(backoffMs(attempt));
+        }
+        // Unreachable — the loop returns or throws.
+        throw lastErr instanceof Error ? lastErr : new Error("fetch retry exhausted");
+    }
+    return {
+        async get(path) {
+            const r = await fetchWithRetry(base + path, { headers });
+            if (r.status === 404 || r.status === 403)
+                return null;
+            if (!r.ok)
+                throw toErr(r.url, r.status, await r.text());
+            const j = await readJson(r);
+            const data = j.data;
+            if (Array.isArray(data))
+                return data;
+            return data && typeof data === "object" ? data : null;
+        },
+        async post(path, body) {
+            const r = await fetchWithRetry(base + path, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body ?? {}),
+            });
+            if (!r.ok)
+                throw toErr(r.url, r.status, await r.text());
+            const j = await readJson(r);
+            return j.data ?? {};
+        },
+        async patch(path, body) {
+            const r = await fetchWithRetry(base + path, {
+                method: "PATCH",
+                headers,
+                body: JSON.stringify(body ?? {}),
+            });
+            if (!r.ok)
+                throw toErr(r.url, r.status, await r.text());
+            const j = await readJson(r);
+            return j.data ?? {};
+        },
+        async postRaw(path, body) {
+            const r = await fetchWithRetry(base + path, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body ?? {}),
+            });
+            if (!r.ok)
+                throw toErr(r.url, r.status, await r.text());
+            return await readJson(r);
+        },
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/identity.js

@@ -0,0 +1,124 @@
+// Resolve Tractr's `_syncId` foreign keys inside a payload to the real
+// server-side ids/UUIDs, using name-based lookup on server state.
+//
+// The backend's directus_config/ has cross-references like:
+//   permission.policy = "_sync_default_public_policy"   // policy _syncId
+//   policy.roles      = [{ role: "_sync_default_admin_role", … }]  // role _syncId
+//
+// The map from `_syncId` → `name` is defined by the local JSON files. From
+// there we look up the server id by name. That's how we stay compatible with
+// existing snapshots without depending on Tractr's directus_sync_id_map table.
+function collectNames(local) {
+    const map = new Map();
+    for (const row of local) {
+        const syncId = String(row._syncId ?? "");
+        const name = String(row.name ?? "");
+        if (syncId && name)
+            map.set(syncId, name);
+    }
+    return map;
+}
+async function listAll(client, path) {
+    // Directus REST returns paginated {data: [...]} at the collection root.
+    // For our small system-collection sizes (policies ≤ ~50, roles ≤ ~20), one
+    // GET with limit=-1 is fine.
+    const raw = await client.get(`${path}?limit=-1&fields=id,name`);
+    if (raw === null)
+        return [];
+    // client.get returns .data already unwrapped. But when the endpoint returns
+    // an array-of-records that arrives as a plain array cast to
+    // Record<string, unknown> by our current typing; the runtime shape is
+    // actually unknown[]. Handle both.
+    if (Array.isArray(raw))
+        return raw;
+    const data = raw.data;
+    return Array.isArray(data) ? data : [];
+}
+function indexByName(rows) {
+    const map = new Map();
+    for (const r of rows) {
+        const name = String(r.name ?? "");
+        const id = String(r.id ?? "");
+        if (name && id)
+            map.set(name, id);
+    }
+    return map;
+}
+function collectOpSyncIdIndex(localOps) {
+    const map = new Map();
+    for (const op of localOps) {
+        const sync = String(op._syncId ?? "");
+        const flow = String(op.flow ?? "");
+        const key = String(op.key ?? "");
+        if (sync && flow && key)
+            map.set(sync, { flowSyncId: flow, key });
+    }
+    return map;
+}
+function indexServerOps(serverOps) {
+    const map = new Map();
+    for (const op of serverOps) {
+        const id = String(op.id ?? "");
+        const flow = String(op.flow ?? "");
+        const key = String(op.key ?? "");
+        if (id && flow && key)
+            map.set(`${flow}::${key}`, id);
+    }
+    return map;
+}
+export async function buildIdentity(client, localPolicies, localRoles, localFlows = [], localOps = []) {
+    const [serverPolicies, serverRoles, serverFlows, serverOps] = await Promise.all([
+        listAll(client, "/policies"),
+        listAll(client, "/roles"),
+        localFlows.length
+            ? client
+                .get("/flows?limit=-1&fields=id,name")
+                .then((r) => (Array.isArray(r) ? r : []))
+            : Promise.resolve([]),
+        localOps.length
+            ? client
+                .get("/operations?limit=-1&fields=id,flow,key")
+                .then((r) => (Array.isArray(r) ? r : []))
+            : Promise.resolve([]),
+    ]);
+    return {
+        policySyncIdToName: collectNames(localPolicies),
+        roleSyncIdToName: collectNames(localRoles),
+        serverPolicyIdByName: indexByName(serverPolicies),
+        serverRoleIdByName: indexByName(serverRoles),
+        flowSyncIdToName: collectNames(localFlows),
+        serverFlowIdByName: indexByName(serverFlows),
+        opSyncIdToFlowAndKey: collectOpSyncIdIndex(localOps),
+        serverOpIdByFlowIdAndKey: indexServerOps(serverOps),
+    };
+}
+export function resolvePolicySyncIdToServerId(syncId, idx) {
+    const name = idx.policySyncIdToName.get(syncId);
+    if (!name)
+        return null;
+    return idx.serverPolicyIdByName.get(name) ?? null;
+}
+export function resolveRoleSyncIdToServerId(syncId, idx) {
+    const name = idx.roleSyncIdToName.get(syncId);
+    if (!name)
+        return null;
+    return idx.serverRoleIdByName.get(name) ?? null;
+}
+export function resolveFlowSyncIdToServerId(syncId, idx) {
+    const name = idx.flowSyncIdToName.get(syncId);
+    if (!name)
+        return null;
+    return idx.serverFlowIdByName.get(name) ?? null;
+}
+// Operation identity: local _syncId → (flow_syncId, key) → we resolve
+// flow_syncId → server flow id → look up server op by (flow_id, key).
+export function resolveOpSyncIdToServerId(syncId, idx) {
+    const local = idx.opSyncIdToFlowAndKey.get(syncId);
+    if (!local)
+        return null;
+    const serverFlowId = resolveFlowSyncIdToServerId(local.flowSyncId, idx);
+    if (!serverFlowId)
+        return null;
+    return idx.serverOpIdByFlowIdAndKey.get(`${serverFlowId}::${local.key}`) ?? null;
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/manifest.js

@@ -0,0 +1,84 @@
+// Load the snapshot files that describe the desired state. Reads the same
+// on-disk shape directus-sync-style repo uses under directus_config/, so we
+// can drop this tool into the existing repo without a migration.
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+async function readJsonDir(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const files = entries.filter((f) => f.endsWith(".json")).sort();
+    const out = [];
+    for (const f of files) {
+        const text = await readFile(join(dir, f), "utf8");
+        out.push(JSON.parse(text));
+    }
+    return out;
+}
+async function readCollectionSubdirs(dir) {
+    const map = new Map();
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: false });
+    }
+    catch {
+        return map;
+    }
+    for (const name of entries.sort()) {
+        const rows = await readJsonDir(join(dir, name));
+        if (rows.length)
+            map.set(name, rows);
+    }
+    return map;
+}
+async function readJsonArray(path) {
+    try {
+        const text = await readFile(path, "utf8");
+        const parsed = JSON.parse(text);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function readRegisterManifests(dir) {
+    const set = new Set();
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return set;
+    }
+    for (const f of entries) {
+        if (!f.endsWith(".json"))
+            continue;
+        try {
+            const j = JSON.parse(await readFile(join(dir, f), "utf8"));
+            if (j.table)
+                set.add(j.table);
+        }
+        catch {
+            // Ignore malformed manifests here — the caller reports them separately.
+        }
+    }
+    return set;
+}
+export async function loadSnapshot(paths) {
+    return {
+        collections: await readJsonDir(join(paths.snapshotDir, "collections")),
+        fieldsByCollection: await readCollectionSubdirs(join(paths.snapshotDir, "fields")),
+        relationsByCollection: await readCollectionSubdirs(join(paths.snapshotDir, "relations")),
+        policies: await readJsonArray(join(paths.configDir, "policies.json")),
+        roles: await readJsonArray(join(paths.configDir, "roles.json")),
+        permissions: await readJsonArray(join(paths.configDir, "permissions.json")),
+        flows: await readJsonArray(join(paths.configDir, "flows.json")),
+        operations: await readJsonArray(join(paths.configDir, "operations.json")),
+        registerManifests: await readRegisterManifests(paths.registerDir),
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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