@anvil-works/anvil-cli 0.7.0-canary.9 → 0.7.0

package/dist/cli.js

@@ -8946,7 +8946,7 @@ var __webpack_exports__ = {};
             commands,
             format: "utf-8",
             onError: esm_onError,
-            parser
+            parser: esm_parser
         };
     }
     function checkIsRepoRootTask() {
@@ -8972,13 +8972,13 @@ var __webpack_exports__ = {};
             commands,
             format: "utf-8",
             onError: esm_onError,
-            parser
+            parser: esm_parser
         };
     }
     function isNotRepoMessage(error) {
         return /(Not a git repository|Kein Git-Repository)/i.test(String(error));
     }
-    var CheckRepoActions, esm_onError, parser;
+    var CheckRepoActions, esm_onError, esm_parser;
     var init_check_is_repo = __esm({
         "src/lib/tasks/check-is-repo.ts" () {
             "use strict";
@@ -8993,7 +8993,7 @@ var __webpack_exports__ = {};
                 if (128 === exitCode && isNotRepoMessage(error)) return done(Buffer.from("false"));
                 fail(error);
             };
-            parser = (text)=>"true" === text.trim();
+            esm_parser = (text)=>"true" === text.trim();
         }
     });
     function cleanSummaryParser(dryRun, text) {
@@ -13718,7 +13718,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
     }
     function getCredentialHelperModulePath(options) {
         const currentModulePath = options?.currentModulePath ?? __filename;
-        if (isAnvilCliPackageFile(currentModulePath)) return currentModulePath;
+        if (isAnvilCliPackageFile(currentModulePath) && "cli.js" !== external_path_default().basename(currentModulePath)) return currentModulePath;
         return (options?.resolvePackageEntry ?? (()=>requireFromHere.resolve("@anvil-works/anvil-cli")))();
     }
     async function getRepositoryGitDir(repoPath, git = esm_default(repoPath)) {
@@ -13895,6 +13895,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
     function setRepoContext(repoPath) {
         repoContext = repoPath;
     }
+    const inFlightRefreshes = new Map();
     async function verifyAuth(authToken, anvilUrl = getDefaultAnvilUrl()) {
         try {
             const resp = await fetch(`${anvilUrl}/ide/api/_/user`, {
@@ -13948,53 +13949,91 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
     }
     async function auth_getValidAuthToken(anvilUrl = getDefaultAnvilUrl(), username) {
         const normalized = normalizeAnvilUrl(anvilUrl);
-        let tokens;
-        let repoAuth;
-        if (inMemoryAuth && authMatches(inMemoryAuth, normalized, username)) tokens = inMemoryAuth.tokens;
-        else {
-            repoAuth = repoContext ? await readAuthFromRepo(repoContext) : void 0;
-            tokens = repoAuth && authMatches(repoAuth, normalized, username) ? repoAuth.tokens : getTokensAutoSelect(normalized, username);
-        }
+        const source = await resolveTokenSource(normalized, username);
+        const tokens = getSourceTokens(source);
         if (!tokens.authToken && !tokens.refreshToken) throw errors_createAuthError.required("Not logged in. Please log in first.");
         const isExpired = null !== tokens.authTokenExpiresAt && tokens.authTokenExpiresAt <= Math.floor(Date.now() / 1000) + 60;
-        if (tokens.refreshToken && isExpired) try {
+        if (tokens.refreshToken && isExpired) {
+            const refreshKey = getRefreshKey(normalized, username, source, tokens.refreshToken);
+            const existingRefresh = inFlightRefreshes.get(refreshKey);
+            if (existingRefresh) return existingRefresh;
+            const refreshPromise = refreshAndStoreAccessToken(normalized, username, source, tokens.refreshToken).finally(()=>{
+                inFlightRefreshes.delete(refreshKey);
+            });
+            inFlightRefreshes.set(refreshKey, refreshPromise);
+            return refreshPromise;
+        }
+        if (tokens.authToken) return tokens.authToken;
+        throw errors_createAuthError.required("No valid token available");
+    }
+    async function resolveTokenSource(normalizedUrl, username) {
+        if (inMemoryAuth && authMatches(inMemoryAuth, normalizedUrl, username)) return {
+            type: "memory",
+            auth: inMemoryAuth
+        };
+        const repoAuth = repoContext ? await readAuthFromRepo(repoContext) : void 0;
+        if (repoAuth && authMatches(repoAuth, normalizedUrl, username)) return {
+            type: "repo",
+            auth: repoAuth,
+            repoPath: repoContext
+        };
+        const tokens = getTokensAutoSelect(normalizedUrl, username);
+        return {
+            type: "store",
+            tokens,
+            accountUsername: getStoreAccountUsername(normalizedUrl, username, tokens.refreshToken ?? void 0)
+        };
+    }
+    function getSourceTokens(source) {
+        return "store" === source.type ? source.tokens : source.auth.tokens;
+    }
+    function getStoreAccountUsername(normalizedUrl, username, refreshToken) {
+        if (username) return username;
+        const urlTokens = getUrlTokens(normalizedUrl);
+        if (!urlTokens) return;
+        const accounts = Object.keys(urlTokens);
+        if (1 === accounts.length) return accounts[0];
+        return refreshToken ? findAccountByRefreshToken(normalizedUrl, refreshToken) : void 0;
+    }
+    function getRefreshKey(normalizedUrl, username, source, refreshToken) {
+        switch(source.type){
+            case "memory":
+                return `memory:${normalizedUrl}:${source.auth.username}`;
+            case "repo":
+                return `repo:${source.repoPath}:${normalizedUrl}:${source.auth.username}`;
+            case "store":
+                return `store:${normalizedUrl}:${source.accountUsername ?? username ?? refreshToken}`;
+        }
+    }
+    async function refreshAndStoreAccessToken(normalizedUrl, username, source, refreshToken) {
+        try {
+            const tokens = getSourceTokens(source);
             const clientId = tokens.clientId ?? ANVIL_SYNC_CLIENT_ID;
-            const tokenData = await refreshAccessToken(tokens.refreshToken, normalized, clientId);
-            const newExpiresAt = Math.floor(Date.now() / 1000) + tokenData.expires_in;
+            const tokenData = await refreshAccessToken(refreshToken, normalizedUrl, clientId);
             const newTokens = {
                 authToken: tokenData.access_token,
                 refreshToken: tokenData.refresh_token,
-                authTokenExpiresAt: newExpiresAt,
+                authTokenExpiresAt: Math.floor(Date.now() / 1000) + tokenData.expires_in,
                 clientId
             };
-            if (inMemoryAuth) inMemoryAuth.tokens = newTokens;
-            else if (repoAuth) {
+            if ("memory" === source.type) source.auth.tokens = newTokens;
+            else if ("repo" === source.type) {
                 const encryptionKey = process.env["ANVIL_AUTH_FILE_ENCRYPTION_KEY"];
                 if (!encryptionKey) throw errors_createAuthError.required("Cannot refresh repo auth without ANVIL_AUTH_FILE_ENCRYPTION_KEY.");
-                repoAuth.tokens = newTokens;
-                await writeAuthToFile(repoContext, repoAuth, encryptionKey);
+                source.auth.tokens = newTokens;
+                await writeAuthToFile(source.repoPath, source.auth, encryptionKey);
             } else {
-                let accountUsername = username;
-                if (!accountUsername) {
-                    const urlTokens = getUrlTokens(normalized);
-                    if (urlTokens) {
-                        const accounts = Object.keys(urlTokens);
-                        accountUsername = 1 === accounts.length ? accounts[0] : findAccountByRefreshToken(normalized, tokens.refreshToken);
-                    }
-                }
-                if (!accountUsername) {
-                    await clearTokensForAccount(normalized, username, tokens.refreshToken);
+                if (!source.accountUsername) {
+                    await clearTokensForAccount(normalizedUrl, username, refreshToken);
                     throw errors_createAuthError.required("Cannot determine which account to refresh. Please log in again.");
                 }
-                setAccountTokens(normalized, accountUsername, newTokens);
+                setAccountTokens(normalizedUrl, source.accountUsername, newTokens);
             }
             return tokenData.access_token;
         } catch (e) {
-            await clearTokensForAccount(normalized, username, tokens.refreshToken);
+            await clearTokensForAccount(normalizedUrl, username, refreshToken);
             throw e;
         }
-        if (tokens.authToken) return tokens.authToken;
-        throw errors_createAuthError.required("No valid token available");
     }
     async function clearTokensForAccount(url, username, refreshToken) {
         if (inMemoryAuth || repoContext && await readAuthFromRepo(repoContext)) return;
@@ -14275,6 +14314,334 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         } catch (_e) {}
         return out;
     }
+    const promises_namespaceObject = require("fs/promises");
+    var promises_default = /*#__PURE__*/ __webpack_require__.n(promises_namespaceObject);
+    function normalizeLineEndings(content) {
+        return content.replace(/\r\n/g, "\n");
+    }
+    function pythonifyName(name) {
+        return name.replace(/[^A-z0-9]/g, "_").replace(/^[0-9]/, "_$&");
+    }
+    function extractPythonName(relativePath, skipParts = 1) {
+        const parts = relativePath.slice(0, -3).split("/");
+        const isPackage = relativePath.endsWith("__init__.py");
+        const relevantParts = isPackage ? parts.slice(skipParts, -1) : parts.slice(skipParts);
+        return relevantParts.map(pythonifyName).join(".");
+    }
+    function deepEqual(a, b) {
+        if (a === b) return true;
+        if (null == a || null == b) return false;
+        if (typeof a !== typeof b) return false;
+        if ("object" != typeof a) return a === b;
+        if (Array.isArray(a) !== Array.isArray(b)) return false;
+        if (Array.isArray(a)) {
+            if (a.length !== b.length) return false;
+            return a.every((item, index)=>deepEqual(item, b[index]));
+        }
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length) return false;
+        return keysA.every((key)=>deepEqual(a[key], b[key]));
+    }
+    function parseHtmlWithFrontmatter(htmlContent) {
+        const frontmatterPattern = /^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/;
+        const match = htmlContent.match(frontmatterPattern);
+        if (match) {
+            const yamlStr = match[1];
+            const html = match[2];
+            const frontmatter = yamlStr ? external_js_yaml_default().load(yamlStr) ?? {} : {};
+            return {
+                frontmatter,
+                html
+            };
+        }
+        return {
+            frontmatter: {},
+            html: htmlContent
+        };
+    }
+    const ANVIL_GITIGNORE_ENTRY = "/.anvil/";
+    async function ensureProjectGitignoreIgnoresAnvilDir(projectRoot) {
+        const rootGitignorePath = external_path_default().join(projectRoot, ".gitignore");
+        try {
+            const existing = await external_fs_.promises.readFile(rootGitignorePath, "utf8");
+            if (existing.includes(ANVIL_GITIGNORE_ENTRY)) return false;
+            const prefix = existing.endsWith("\n") || 0 === existing.length ? "" : "\n";
+            await external_fs_.promises.writeFile(rootGitignorePath, `${existing}${prefix}${ANVIL_GITIGNORE_ENTRY}\n`, "utf8");
+            return true;
+        } catch (error) {
+            if ("ENOENT" !== error.code) throw error;
+            await external_fs_.promises.writeFile(rootGitignorePath, `${ANVIL_GITIGNORE_ENTRY}\n`, "utf8");
+            return true;
+        }
+    }
+    const ANVIL_DEPS_DIR = ".anvil/deps";
+    const ANVIL_DEPS_MANIFEST = "manifest.json";
+    const DEPS_MANIFEST_VERSION = 1;
+    function formatFetchError(prefix, status, errorBody) {
+        if (!errorBody) return `${prefix}: ${status}`;
+        try {
+            const parsed = JSON.parse(errorBody);
+            if ("string" == typeof parsed.error && parsed.error.trim()) return `${prefix}: ${parsed.error} (${status})`;
+        } catch  {}
+        return `${prefix}: ${status} ${errorBody}`;
+    }
+    async function fetchAllDependencies(appId, anvilUrl = resolveAnvilUrl(), options = {}) {
+        const { commit, includeDocs = true, knownDependencies = [] } = options;
+        const token = await auth_getValidAuthToken(anvilUrl);
+        const body = {
+            include_docs: includeDocs,
+            known_dependencies: knownDependencies
+        };
+        if (commit) body.commit = commit;
+        const resp = await fetch(`${anvilUrl}/ide/api/_/apps/${appId}/resolved-dependencies`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json"
+            },
+            body: JSON.stringify(body)
+        });
+        if (!resp.ok) {
+            const errorBody = await resp.text();
+            throw new Error(formatFetchError("Failed to fetch dependencies", resp.status, errorBody));
+        }
+        return await resp.json();
+    }
+    async function refreshDependencyCache(projectRoot, appId, anvilUrl = resolveAnvilUrl(), options = {}) {
+        const includeDocs = options.includeDocs ?? true;
+        const knownDependencies = await getKnownDependenciesForCache(projectRoot, includeDocs);
+        const response = await fetchAllDependencies(appId, anvilUrl, {
+            commit: options.commit,
+            includeDocs,
+            knownDependencies
+        });
+        if (!response.resolved_dependencies.length) {
+            await clearDepsCache(projectRoot);
+            return {
+                response,
+                addedGitignoreEntry: false
+            };
+        }
+        const addedGitignoreEntry = await ensureProjectGitignoreIgnoresAnvilDir(projectRoot);
+        await writeAllDepsToCache(projectRoot, response, {
+            includeDocs
+        });
+        return {
+            response,
+            addedGitignoreEntry
+        };
+    }
+    function depsDir(projectRoot) {
+        return external_path_default().join(projectRoot, ANVIL_DEPS_DIR);
+    }
+    function depsManifestPath(projectRoot) {
+        return external_path_default().join(depsDir(projectRoot), ANVIL_DEPS_MANIFEST);
+    }
+    function isResolvedDependencyManifestEntry(value) {
+        if (!value || "object" != typeof value) return false;
+        const entry = value;
+        return "string" == typeof entry.app_id && entry.app_id.length > 0 && "string" == typeof entry.commit_id && entry.commit_id.length > 0 && (void 0 === entry.branch || "string" == typeof entry.branch);
+    }
+    function isCachedDependencyManifestEntry(value) {
+        if (!isResolvedDependencyManifestEntry(value)) return false;
+        const entry = value;
+        return "string" == typeof entry.package_name && entry.package_name.length > 0;
+    }
+    function isDepsCacheManifest(value) {
+        if (!value || "object" != typeof value) return false;
+        const manifest = value;
+        return manifest.version === DEPS_MANIFEST_VERSION && "boolean" == typeof manifest.includeDocs && Array.isArray(manifest.resolved_dependencies) && manifest.resolved_dependencies.every(isResolvedDependencyManifestEntry) && Array.isArray(manifest.cached_dependencies) && manifest.cached_dependencies.every(isCachedDependencyManifestEntry);
+    }
+    async function readDepsCacheManifest(projectRoot) {
+        try {
+            const raw = await promises_default().readFile(depsManifestPath(projectRoot), "utf-8");
+            const parsed = JSON.parse(raw);
+            return isDepsCacheManifest(parsed) ? parsed : void 0;
+        } catch  {
+            return;
+        }
+    }
+    async function getKnownDependenciesForCache(projectRoot, includeDocs) {
+        const manifest = await readDepsCacheManifest(projectRoot);
+        if (!manifest || manifest.includeDocs !== includeDocs) return [];
+        return manifest.resolved_dependencies.map(({ app_id, commit_id })=>({
+                app_id,
+                commit_id
+            }));
+    }
+    function getDependencyWatchSubscriptionsFromManifest(manifest) {
+        if (!manifest) return [];
+        const cachedByAppId = new Map(manifest.cached_dependencies.map((dep)=>[
+                dep.app_id,
+                dep
+            ]));
+        return manifest.resolved_dependencies.flatMap((dep)=>{
+            if (!dep.branch) return [];
+            return [
+                {
+                    appId: dep.app_id,
+                    branch: dep.branch,
+                    packageName: cachedByAppId.get(dep.app_id)?.package_name
+                }
+            ];
+        });
+    }
+    function normalizeAnvilYamlDependenciesFromContent(content) {
+        const parsed = external_js_yaml_default().load(content);
+        if (!parsed || "object" != typeof parsed || !Array.isArray(parsed.dependencies)) return [];
+        return normalizeAnvilYamlDependenciesValue(parsed.dependencies);
+    }
+    function normalizeAnvilYamlDependenciesValue(value) {
+        if (!Array.isArray(value)) return [];
+        return normalizeForComparison(value);
+    }
+    async function readAnvilYamlDependencies(projectRoot) {
+        try {
+            const content = await promises_default().readFile(external_path_default().join(projectRoot, "anvil.yaml"), "utf-8");
+            return normalizeAnvilYamlDependenciesFromContent(content);
+        } catch  {
+            return [];
+        }
+    }
+    function anvilYamlDependenciesEqual(left, right) {
+        return deepEqual(left, right);
+    }
+    function normalizeForComparison(value) {
+        if (Array.isArray(value)) return value.map(normalizeForComparison);
+        if (value && "object" == typeof value) return Object.fromEntries(Object.entries(value).sort(([left], [right])=>left.localeCompare(right)).map(([key, entryValue])=>[
+                key,
+                normalizeForComparison(entryValue)
+            ]));
+        return value;
+    }
+    function cachedManifestEntry(dep, packageName) {
+        return {
+            app_id: dep.app_id,
+            commit_id: dep.commit_id,
+            ...dep.branch ? {
+                branch: dep.branch
+            } : {},
+            package_name: packageName
+        };
+    }
+    function safeDependencyPath(filePath, kind) {
+        const normalizedPath = external_path_default().normalize(filePath);
+        if (external_path_default().isAbsolute(normalizedPath) || normalizedPath.startsWith("..")) throw new Error(`Invalid dependency ${kind} path: ${filePath}`);
+        return normalizedPath;
+    }
+    async function writeDepToCache(projectRoot, dep) {
+        const depDir = external_path_default().join(projectRoot, ANVIL_DEPS_DIR, dep.package_name);
+        await promises_default().rm(depDir, {
+            recursive: true,
+            force: true
+        });
+        await promises_default().mkdir(external_path_default().join(depDir, "client_code"), {
+            recursive: true
+        });
+        await promises_default().mkdir(external_path_default().join(depDir, "server_code"), {
+            recursive: true
+        });
+        await promises_default().writeFile(external_path_default().join(depDir, "anvil.yaml"), external_js_yaml_default().dump({
+            package_name: dep.package_name
+        }));
+        for (const mod of dep.modules ?? [])if (mod.is_package) {
+            const modDir = external_path_default().join(depDir, "client_code", mod.name);
+            await promises_default().mkdir(modDir, {
+                recursive: true
+            });
+            await promises_default().writeFile(external_path_default().join(modDir, "__init__.py"), mod.code);
+        } else await promises_default().writeFile(external_path_default().join(depDir, "client_code", `${mod.name}.py`), mod.code);
+        for (const form of dep.forms ?? []){
+            const { code, class_name, is_package, ...formTemplate } = form;
+            if (is_package) {
+                const formDir = external_path_default().join(depDir, "client_code", class_name);
+                await promises_default().mkdir(formDir, {
+                    recursive: true
+                });
+                await promises_default().writeFile(external_path_default().join(formDir, "__init__.py"), code);
+                await promises_default().writeFile(external_path_default().join(formDir, "form_template.yaml"), external_js_yaml_default().dump(formTemplate));
+            } else {
+                await promises_default().writeFile(external_path_default().join(depDir, "client_code", `${class_name}.py`), code);
+                await promises_default().writeFile(external_path_default().join(depDir, "client_code", `${class_name}.yaml`), external_js_yaml_default().dump(formTemplate));
+            }
+        }
+        for (const mod of dep.server_modules ?? [])if (mod.is_package) {
+            const modDir = external_path_default().join(depDir, "server_code", mod.name);
+            await promises_default().mkdir(modDir, {
+                recursive: true
+            });
+            await promises_default().writeFile(external_path_default().join(modDir, "__init__.py"), mod.code);
+        } else await promises_default().writeFile(external_path_default().join(depDir, "server_code", `${mod.name}.py`), mod.code);
+        for (const asset of dep.assets ?? []){
+            const targetPath = external_path_default().join(depDir, "theme", "assets", safeDependencyPath(asset.name, "asset"));
+            await promises_default().mkdir(external_path_default().dirname(targetPath), {
+                recursive: true
+            });
+            await promises_default().writeFile(targetPath, Buffer.from(asset.content, "base64"));
+        }
+        for (const doc of dep.docs ?? []){
+            const targetPath = external_path_default().join(depDir, safeDependencyPath(doc.path, "doc"));
+            await promises_default().mkdir(external_path_default().dirname(targetPath), {
+                recursive: true
+            });
+            await promises_default().writeFile(targetPath, doc.content);
+        }
+    }
+    async function writeAllDepsToCache(projectRoot, response, options = {}) {
+        const includeDocs = options.includeDocs ?? true;
+        const manifest = await readDepsCacheManifest(projectRoot);
+        const canReuseExistingCache = manifest?.includeDocs === includeDocs;
+        if (!canReuseExistingCache) await clearDepsCache(projectRoot);
+        const previousCached = canReuseExistingCache ? manifest.cached_dependencies : [];
+        const resolvedAppIds = new Set(response.resolved_dependencies.map((dep)=>dep.app_id));
+        for (const dep of previousCached)if (!resolvedAppIds.has(dep.app_id)) await promises_default().rm(external_path_default().join(projectRoot, ANVIL_DEPS_DIR, dep.package_name), {
+            recursive: true,
+            force: true
+        });
+        for (const dep of response.dependencies)await writeDepToCache(projectRoot, dep);
+        const returnedByAppId = new Map(response.dependencies.map((dep)=>[
+                dep.app_id,
+                dep
+            ]));
+        const previousByAppId = new Map(previousCached.map((dep)=>[
+                dep.app_id,
+                dep
+            ]));
+        const cachedDependencies = response.resolved_dependencies.map((dep)=>{
+            const returned = returnedByAppId.get(dep.app_id);
+            if (returned) return cachedManifestEntry(returned, returned.package_name);
+            const previous = previousByAppId.get(dep.app_id);
+            if (!previous) return;
+            return cachedManifestEntry(dep, previous.package_name);
+        }).filter((dep)=>void 0 !== dep);
+        const newManifest = {
+            version: DEPS_MANIFEST_VERSION,
+            includeDocs,
+            resolved_dependencies: response.resolved_dependencies,
+            cached_dependencies: cachedDependencies
+        };
+        await promises_default().mkdir(depsDir(projectRoot), {
+            recursive: true
+        });
+        await promises_default().writeFile(depsManifestPath(projectRoot), `${JSON.stringify(newManifest, null, 2)}\n`);
+    }
+    async function clearDepsCache(projectRoot) {
+        await promises_default().rm(depsDir(projectRoot), {
+            recursive: true,
+            force: true
+        });
+    }
+    async function getCachedPackages(projectRoot) {
+        try {
+            const entries = await promises_default().readdir(depsDir(projectRoot), {
+                withFileTypes: true
+            });
+            return entries.filter((entry)=>entry.isDirectory()).map((entry)=>entry.name);
+        } catch  {
+            return [];
+        }
+    }
     class GitService {
         git;
         repoPath;
@@ -14361,6 +14728,77 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 throw errors_createGitError.commandFailed("status", e.message);
             }
         }
+        async discardModeOnlyChanges(paths) {
+            const discarded = [];
+            for (const relativePath of paths)try {
+                const headMode = await this.getHeadFileMode(relativePath);
+                if ("100644" !== headMode && "100755" !== headMode) continue;
+                const contentUnchanged = await this.hasSameContentAsHead(relativePath);
+                if (!contentUnchanged) continue;
+                await this.restoreExecutableBit(relativePath, "100755" === headMode);
+                discarded.push(relativePath);
+            } catch (e) {
+                throw errors_createGitError.commandFailed("discard mode-only changes", e.message);
+            }
+            return discarded;
+        }
+        async discardStagedModeOnlyChanges(paths) {
+            const discarded = [];
+            for (const relativePath of paths)try {
+                const headMode = await this.getHeadFileMode(relativePath);
+                if ("100644" !== headMode && "100755" !== headMode) continue;
+                const indexContentUnchanged = await this.hasSameIndexContentAsHead(relativePath);
+                if (!indexContentUnchanged) continue;
+                await this.git.raw([
+                    "reset",
+                    "-q",
+                    "HEAD",
+                    "--",
+                    relativePath
+                ]);
+                await this.restoreExecutableBit(relativePath, "100755" === headMode);
+                discarded.push(relativePath);
+            } catch (e) {
+                throw errors_createGitError.commandFailed("discard staged mode-only changes", e.message);
+            }
+            return discarded;
+        }
+        async getHeadFileMode(relativePath) {
+            const output = await this.git.raw([
+                "ls-tree",
+                "HEAD",
+                "--",
+                relativePath
+            ]);
+            const match = output.match(/^(\d{6})\s/);
+            return match?.[1] ?? null;
+        }
+        async hasSameContentAsHead(relativePath) {
+            const headHash = (await this.git.revparse([
+                `HEAD:${relativePath}`
+            ])).trim();
+            const worktreeHash = (await this.git.raw([
+                "hash-object",
+                "--",
+                relativePath
+            ])).trim();
+            return headHash === worktreeHash;
+        }
+        async hasSameIndexContentAsHead(relativePath) {
+            const headHash = (await this.git.revparse([
+                `HEAD:${relativePath}`
+            ])).trim();
+            const indexHash = (await this.git.revparse([
+                `:${relativePath}`
+            ])).trim();
+            return headHash === indexHash;
+        }
+        async restoreExecutableBit(relativePath, executable) {
+            const filePath = external_path_default().join(this.repoPath, relativePath);
+            const stat = await external_fs_.promises.stat(filePath);
+            const mode = executable ? 73 | stat.mode : -74 & stat.mode;
+            if ((511 & stat.mode) !== (511 & mode)) await external_fs_.promises.chmod(filePath, mode);
+        }
         async hasUncommittedChanges() {
             const status = await this.getStatus();
             return !status.isClean;
@@ -14500,6 +14938,32 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 throw errors_createGitError.commandFailed("rebase --abort", e.message);
             }
         }
+        async isAncestor(ancestorRef, descendantRef) {
+            try {
+                const mergeBase = (await this.git.raw([
+                    "merge-base",
+                    ancestorRef,
+                    descendantRef
+                ])).trim();
+                const ancestorCommit = (await this.git.revparse([
+                    ancestorRef
+                ])).trim();
+                return mergeBase === ancestorCommit;
+            } catch  {
+                return false;
+            }
+        }
+        async mergeFastForward(ref) {
+            try {
+                await this.git.raw([
+                    "merge",
+                    "--ff-only",
+                    ref
+                ]);
+            } catch (e) {
+                throw errors_createGitError.commandFailed("merge --ff-only", e.message);
+            }
+        }
         async deleteRef(ref) {
             try {
                 await this.git.raw([
@@ -14544,11 +15008,12 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             } catch (error) {}
         }
     }
-    async function getStagedFileChanges(git) {
+    async function getStagedFileChanges(git, gitService) {
         try {
             const status = await git.status();
             const renames = status.renamed || [];
             const stagedFiles = status.files.filter((f)=>" " !== f.index && "?" !== f.index);
+            const stagedModeOnlyPaths = new Set(gitService ? await gitService.discardStagedModeOnlyChanges(stagedFiles.filter((f)=>"R" !== f.index && "D" !== f.index).map((f)=>f.path)) : []);
             const stagedRenames = [];
             for (const f of stagedFiles)if ("R" === f.index) {
                 const rename = renames.find((r)=>r.to === f.path);
@@ -14561,19 +15026,23 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             const stagedRenamedFromPaths = new Set(stagedRenames.map((r)=>r.from));
             const stagedRenamedToPaths = new Set(stagedRenames.map((r)=>r.path));
             const changes = [];
-            for (const f of stagedFiles)if ("R" !== f.index) {
-                if (!(stagedRenamedFromPaths.has(f.path) || stagedRenamedToPaths.has(f.path))) if ("D" === f.index) changes.push({
-                    path: f.path,
-                    type: "unlink"
-                });
-                else if ("A" === f.index || "?" === f.index) changes.push({
-                    path: f.path,
-                    type: "add"
-                });
-                else changes.push({
-                    path: f.path,
-                    type: "change"
-                });
+            for (const f of stagedFiles){
+                if ("R" !== f.index) {
+                    if (!stagedModeOnlyPaths.has(f.path)) {
+                        if (!(stagedRenamedFromPaths.has(f.path) || stagedRenamedToPaths.has(f.path))) if ("D" === f.index) changes.push({
+                            path: f.path,
+                            type: "unlink"
+                        });
+                        else if ("A" === f.index || "?" === f.index) changes.push({
+                            path: f.path,
+                            type: "add"
+                        });
+                        else changes.push({
+                            path: f.path,
+                            type: "change"
+                        });
+                    }
+                }
             }
             changes.push(...stagedRenames);
             return changes;
@@ -14581,50 +15050,6 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             throw errors_createGitError.commandFailed("status", e.message);
         }
     }
-    function normalizeLineEndings(content) {
-        return content.replace(/\r\n/g, "\n");
-    }
-    function pythonifyName(name) {
-        return name.replace(/[^A-z0-9]/g, "_").replace(/^[0-9]/, "_$&");
-    }
-    function extractPythonName(relativePath, skipParts = 1) {
-        const parts = relativePath.slice(0, -3).split("/");
-        const isPackage = relativePath.endsWith("__init__.py");
-        const relevantParts = isPackage ? parts.slice(skipParts, -1) : parts.slice(skipParts);
-        return relevantParts.map(pythonifyName).join(".");
-    }
-    function deepEqual(a, b) {
-        if (a === b) return true;
-        if (null == a || null == b) return false;
-        if (typeof a !== typeof b) return false;
-        if ("object" != typeof a) return a === b;
-        if (Array.isArray(a) !== Array.isArray(b)) return false;
-        if (Array.isArray(a)) {
-            if (a.length !== b.length) return false;
-            return a.every((item, index)=>deepEqual(item, b[index]));
-        }
-        const keysA = Object.keys(a);
-        const keysB = Object.keys(b);
-        if (keysA.length !== keysB.length) return false;
-        return keysA.every((key)=>deepEqual(a[key], b[key]));
-    }
-    function parseHtmlWithFrontmatter(htmlContent) {
-        const frontmatterPattern = /^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/;
-        const match = htmlContent.match(frontmatterPattern);
-        if (match) {
-            const yamlStr = match[1];
-            const html = match[2];
-            const frontmatter = yamlStr ? external_js_yaml_default().load(yamlStr) ?? {} : {};
-            return {
-                frontmatter,
-                html
-            };
-        }
-        return {
-            frontmatter: {},
-            html: htmlContent
-        };
-    }
     const external_chokidar_namespaceObject = require("chokidar");
     var external_chokidar_default = /*#__PURE__*/ __webpack_require__.n(external_chokidar_namespaceObject);
     class FileWatcher extends Emitter {
@@ -14774,6 +15199,12 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         editSession;
         username;
         environment;
+        dependencyWatchEnabled;
+        dependencySubscriptions;
+        activeDependencySubscriptions = new Map();
+        watchedPrimaryBranch = null;
+        nextSubscriptionId = 1;
+        pendingDependencySubscriptionById = new Map();
         reconnectAttempts = 0;
         connectAttempts = 0;
         reconnectTimer = null;
@@ -14796,6 +15227,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             this.editSession = options.editSession;
             this.username = options.username;
             this.environment = options.environment;
+            this.dependencyWatchEnabled = options.dependencyWatch ?? true;
+            this.dependencySubscriptions = dedupeDependencySubscriptions(options.dependencySubscriptions ?? []);
             this.sessionId = Math.random().toString(36).substring(2, 10);
             this.reconnectDelayMs = this.RECONNECT_DELAY_BASE_MS;
         }
@@ -14821,6 +15254,9 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 const subscribeMsg = this.buildSubscribeMessage(this.currentBranch);
                 logger_logger.debug(`[WebSocket ${this.sessionId}]`, `Subscribing: ${JSON.stringify(subscribeMsg)}`);
                 this.ws?.send(JSON.stringify(subscribeMsg));
+                this.watchedPrimaryBranch = this.currentBranch;
+                this.activeDependencySubscriptions.clear();
+                this.subscribeToDependencies();
                 this.emit("connected", void 0);
             });
             this.ws.on("unexpected-response", (request, response)=>{
@@ -14843,6 +15279,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 try {
                     const msg = JSON.parse(data.toString());
                     logger_logger.debug(`[WebSocket ${this.sessionId}]`, `Message: ${JSON.stringify(msg)}`);
+                    this.handleDependencySubscriptionReply(msg);
                     this.handleMessage(msg);
                 } catch (error) {
                     logger_logger.error(external_chalk_default().red(`Failed to parse WebSocket message: ${error.message}`));
@@ -14893,7 +15330,9 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 if (!ref_update) return void logger_logger.debug("Ignoring REPO_UPDATE with no ref_update");
                 const { ref } = ref_update;
                 const commitHash = "string" == typeof commit ? commit : commit?.v;
+                const appId = this.getMessageAppId(msg);
                 this.emit("repo-update", {
+                    appId,
                     ref,
                     commitHash: commitHash || "unknown",
                     saveSeq: ref_update?.["save-seq"]
@@ -14908,11 +15347,26 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         }
         updateBranch(branch) {
             this.currentBranch = branch;
-            if (this.ws?.readyState === external_ws_default().OPEN) this.ws.send(JSON.stringify(this.buildSubscribeMessage(branch)));
+            if (this.ws?.readyState === external_ws_default().OPEN) {
+                this.ws.send(JSON.stringify(this.buildSubscribeMessage(branch)));
+                this.watchedPrimaryBranch = branch;
+                this.subscribeToDependencies();
+            }
         }
         updateEnvironment(environment) {
             this.environment = environment;
         }
+        updateDependencySubscriptions(subscriptions) {
+            const previousSubscriptions = this.dependencySubscriptions;
+            this.dependencySubscriptions = dedupeDependencySubscriptions(subscriptions);
+            if (this.ws?.readyState === external_ws_default().OPEN) {
+                this.unsubscribeStaleDependencies(previousSubscriptions, this.dependencySubscriptions);
+                this.subscribeToDependencies();
+            }
+        }
+        getDependencySubscriptions() {
+            return this.dependencySubscriptions;
+        }
         getEditSession() {
             return this.editSession;
         }
@@ -14923,7 +15377,22 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 clearTimeout(this.reconnectTimer);
                 this.reconnectTimer = null;
             }
+            if (this.ws?.readyState === external_ws_default().OPEN) {
+                this.ws.send(JSON.stringify(this.buildUnsubscribeMessage(this.appId)));
+                this.unwatchDependencySubscriptions([
+                    ...this.activeDependencySubscriptions.values()
+                ]);
+            }
+            this.teardownSocket();
+        }
+        reconnect() {
+            if (this.isClosing) return;
             this.teardownSocket();
+            this.connect().catch((error)=>{
+                this.emit("error", {
+                    error: error instanceof Error ? error : new Error(String(error))
+                });
+            });
         }
         isConnected() {
             return this.ws?.readyState === external_ws_default().OPEN;
@@ -14956,7 +15425,73 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 } : {}
             };
         }
-        getConnectionContext() {
+        buildUnsubscribeMessage(appId) {
+            return {
+                cmd: "UNWATCH_APP",
+                app: appId
+            };
+        }
+        subscribeToDependencies() {
+            if (!this.dependencyWatchEnabled || this.ws?.readyState !== external_ws_default().OPEN) return;
+            for (const subscription of this.dependencySubscriptions){
+                const key = this.dependencySubscriptionKey(subscription);
+                if (this.activeDependencySubscriptions.has(key)) continue;
+                const id = this.nextSubscriptionId++;
+                this.pendingDependencySubscriptionById.set(id, subscription);
+                this.activeDependencySubscriptions.set(key, subscription);
+                const subscribeMsg = {
+                    id,
+                    cmd: "WATCH_APP",
+                    app: subscription.appId,
+                    only_branch: subscription.branch
+                };
+                logger_logger.debug(`[WebSocket ${this.sessionId}]`, `Subscribing dependency: ${JSON.stringify(subscribeMsg)}`);
+                logger_logger.verbose(external_chalk_default().gray(`Watching dependency ${subscription.packageName ?? subscription.appId} (${subscription.appId}, branch ${subscription.branch})`));
+                this.ws.send(JSON.stringify(subscribeMsg));
+            }
+        }
+        handleDependencySubscriptionReply(msg) {
+            if ("number" != typeof msg.id) return;
+            const subscription = this.pendingDependencySubscriptionById.get(msg.id);
+            if (!subscription) return;
+            this.pendingDependencySubscriptionById.delete(msg.id);
+            if (!msg.error) return;
+            this.activeDependencySubscriptions.delete(this.dependencySubscriptionKey(subscription));
+            logger_logger.warn(external_chalk_default().yellow(`Could not watch dependency ${subscription.packageName ?? subscription.appId} (${subscription.appId}, branch ${subscription.branch}): ${this.formatDependencySubscriptionError(msg.error)}`));
+        }
+        formatDependencySubscriptionError(error) {
+            if ("string" == typeof error) return error;
+            if (error && "object" == typeof error && "string" == typeof error.message) return error.message;
+            return JSON.stringify(error);
+        }
+        getMessageAppId(msg) {
+            if ("string" == typeof msg.app) return msg.app;
+            if ("string" == typeof msg.app_id) return msg.app_id;
+            if ("string" == typeof msg.ref_update?.app) return msg.ref_update.app;
+            if ("string" == typeof msg.ref_update?.app_id) return msg.ref_update.app_id;
+            return this.appId;
+        }
+        unsubscribeStaleDependencies(previousSubscriptions, nextSubscriptions) {
+            const nextAppIds = new Set(nextSubscriptions.map((subscription)=>subscription.appId));
+            const staleSubscriptions = previousSubscriptions.filter((subscription)=>!nextAppIds.has(subscription.appId));
+            this.unwatchDependencySubscriptions(staleSubscriptions);
+            const nextKeys = new Set(nextSubscriptions.map((subscription)=>this.dependencySubscriptionKey(subscription)));
+            for (const subscription of previousSubscriptions){
+                const key = this.dependencySubscriptionKey(subscription);
+                if (!nextKeys.has(key)) this.activeDependencySubscriptions.delete(key);
+            }
+        }
+        unwatchDependencySubscriptions(subscriptions) {
+            if (!this.dependencyWatchEnabled || this.ws?.readyState !== external_ws_default().OPEN) return;
+            const unwatchedAppIds = new Set();
+            for (const subscription of subscriptions)if (!unwatchedAppIds.has(subscription.appId)) {
+                unwatchedAppIds.add(subscription.appId);
+                logger_logger.verbose(external_chalk_default().gray(`Stopped watching dependency ${subscription.packageName ?? subscription.appId} (${subscription.appId})`));
+                this.ws.send(JSON.stringify(this.buildUnsubscribeMessage(subscription.appId)));
+            }
+            for (const subscription of subscriptions)this.activeDependencySubscriptions.delete(this.dependencySubscriptionKey(subscription));
+        }
+        getConnectionContext() {
             return `app ${this.appId}, branch ${this.currentBranch}, session ${this.sessionId}`;
         }
         getConnectionTarget(wsUrl) {
@@ -15027,6 +15562,9 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         }
         teardownSocket() {
             this.stopHeartbeat();
+            this.pendingDependencySubscriptionById.clear();
+            this.activeDependencySubscriptions.clear();
+            this.watchedPrimaryBranch = null;
             const socket = this.ws;
             this.ws = null;
             if (!socket) return;
@@ -15042,6 +15580,9 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 logger_logger.debug(`[WebSocket ${this.sessionId}]`, "Error closing WebSocket (ignoring):", e);
             }
         }
+        dependencySubscriptionKey(subscription) {
+            return `${subscription.appId}\0${subscription.branch}`;
+        }
     }
     function normalizeEnvironmentBinding(msg) {
         return {
@@ -15050,6 +15591,18 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             tableMappingId: msg.tableMappingId ?? msg.table_mapping_id ?? null
         };
     }
+    function dedupeDependencySubscriptions(subscriptions) {
+        const seen = new Set();
+        const deduped = [];
+        for (const subscription of subscriptions){
+            const key = `${subscription.appId}\0${subscription.branch}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                deduped.push(subscription);
+            }
+        }
+        return deduped;
+    }
     async function detectRemoteChanges(gitService, oldCommitId, newCommitId) {
         try {
             const files = await gitService.diffNames(oldCommitId, newCommitId);
@@ -15100,7 +15653,11 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             ...status.modified,
             ...status.notAdded,
             ...status.created,
-            ...status.deleted
+            ...status.deleted,
+            ...(status.renamed ?? []).flatMap((r)=>[
+                    r.from,
+                    r.to
+                ])
         ]);
     }
     function extractChangesFromStatus(status) {
@@ -15142,12 +15699,22 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             result.localOnlyChanges.forEach((c)=>logger_logger.verbose(external_chalk_default().gray(`     ${c.path}`)));
         }
     }
-    async function deleteFilesRemovedOnAnvil(gitService, unstagedFiles, remotelyChangedFiles) {
+    async function deleteFilesRemovedOnAnvil(gitService, unstagedFiles, remotelyChangedFiles, options = {}) {
         const filesToRemove = [];
-        for (const file of unstagedFiles)if (remotelyChangedFiles.has(file)) try {
-            await gitService.show(`HEAD:${file}`);
-        } catch (e) {
-            filesToRemove.push(file);
+        const localChangesToPreserve = options.localChangesToPreserve ?? new Set();
+        for (const file of unstagedFiles)if (!localChangesToPreserve.has(file)) {
+            try {
+                await gitService.show(`HEAD:${file}`);
+                continue;
+            } catch (e) {}
+            if (options.oldCommitId) {
+                try {
+                    await gitService.show(`${options.oldCommitId}:${file}`);
+                    filesToRemove.push(file);
+                } catch (e) {}
+                continue;
+            }
+            if (remotelyChangedFiles.has(file)) filesToRemove.push(file);
         }
         if (filesToRemove.length > 0) try {
             await gitService.clean(filesToRemove);
@@ -15159,6 +15726,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         return filesToRemove;
     }
     const external_crypto_namespaceObject = require("crypto");
+    const form_template_parser_namespaceObject = require("@anvil-works/form-template-parser");
     const BUILTIN_COMPONENT_TYPES = new Set([
         "Label",
         "RichText",
@@ -15189,59 +15757,156 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         "CustomComponent",
         "LayoutSlot",
         "FlowPanel",
-        "HtmlTemplate"
-    ]);
-    const KNOWN_RUNTIME_SERVICE_SOURCES = new Set([
-        "/runtime/services/tables.yml",
-        "/runtime/services/google.yml",
-        "/runtime/services/uplink.yml",
-        "/runtime/services/stripe.yml",
-        "/runtime/services/segment.yml",
-        "/runtime/services/facebook.yml",
-        "/runtime/services/anvil/users.yml",
-        "/runtime/services/anvil/secrets.yml",
-        "/runtime/services/anvil/saml.yml",
-        "/runtime/services/anvil/microsoft.yml",
-        "/runtime/services/anvil/email.yml",
-        "/runtime/services/anvil/files.yml"
+        "HtmlTemplate",
+        "HtmlComponent"
     ]);
     const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
-    const DEP_ID_RE = /^dep_[A-Za-z0-9]+$/;
-    const DB_ACCESS_LEVELS = new Set([
-        "none",
-        "search",
-        "full"
-    ]);
-    const DB_BASIC_COLUMN_TYPES = new Set([
-        "string",
-        "number",
-        "bool",
-        "date",
-        "datetime",
-        "media",
-        "simpleObject"
-    ]);
-    const DB_LINK_COLUMN_TYPES = new Set([
-        "link_single",
-        "link_multiple"
-    ]);
-    const DB_TABLE_INDEX_TYPES = new Set([
-        "b_tree",
-        "trigram",
-        "full_text"
-    ]);
-    const SCHEDULE_EVERY_VALUES = new Set([
-        "minute",
-        "hour",
-        "day",
-        "week",
-        "month"
+    const PYTHON_KEYWORDS = new Set([
+        "False",
+        "None",
+        "True",
+        "and",
+        "as",
+        "assert",
+        "async",
+        "await",
+        "break",
+        "class",
+        "continue",
+        "def",
+        "del",
+        "elif",
+        "else",
+        "except",
+        "finally",
+        "for",
+        "from",
+        "global",
+        "if",
+        "import",
+        "in",
+        "is",
+        "lambda",
+        "nonlocal",
+        "not",
+        "or",
+        "pass",
+        "raise",
+        "return",
+        "try",
+        "while",
+        "with",
+        "yield",
+        "match",
+        "case"
     ]);
-    const CLIENT_VERSIONS = new Set([
-        "2",
-        "3"
+    function isValidPythonIdentifier(value) {
+        return IDENTIFIER_RE.test(value) && !PYTHON_KEYWORDS.has(value);
+    }
+    function isParserGeneratedComponentName(name) {
+        if (!name.startsWith("$")) return false;
+        const suffix = name.slice(1);
+        return suffix.length > 0 && isValidPythonIdentifier(suffix);
+    }
+    function pushIssue(issues, path, message) {
+        issues.push({
+            path,
+            message
+        });
+    }
+    function validateComponentName(value, path, issues) {
+        if (void 0 === value || "string" != typeof value || 0 === value.length) return void pushIssue(issues, path, "must be a non-empty string");
+        if (isParserGeneratedComponentName(value)) return;
+        if (!IDENTIFIER_RE.test(value)) return void pushIssue(issues, path, "must be a valid identifier");
+        if (PYTHON_KEYWORDS.has(value)) pushIssue(issues, path, "must be a valid Python identifier (not a keyword)");
+    }
+    const componentTypeSpec_IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+    const DEP_ID_RE = /^dep_[A-Za-z0-9]+$/;
+    const componentTypeSpec_PYTHON_KEYWORDS = new Set([
+        "False",
+        "None",
+        "True",
+        "and",
+        "as",
+        "assert",
+        "async",
+        "await",
+        "break",
+        "class",
+        "continue",
+        "def",
+        "del",
+        "elif",
+        "else",
+        "except",
+        "finally",
+        "for",
+        "from",
+        "global",
+        "if",
+        "import",
+        "in",
+        "is",
+        "lambda",
+        "nonlocal",
+        "not",
+        "or",
+        "pass",
+        "raise",
+        "return",
+        "try",
+        "while",
+        "with",
+        "yield",
+        "match",
+        "case"
     ]);
-    const PYTHON_KEYWORDS = new Set([
+    const LEGACY_FORM_TYPE_REFERENCE_MESSAGE = "must be a valid form: reference (form:Module.Form, form:dep_xxx:Package.Form)";
+    const COMPONENT_TYPE_REFERENCE_MESSAGE = "must be a known Anvil component type (see componentIcons.ts), a form: reference, or a package-qualified form reference (Package.Form)";
+    function isValidIdentifierSegment(value) {
+        return value.length > 0 && componentTypeSpec_IDENTIFIER_RE.test(value) && !componentTypeSpec_PYTHON_KEYWORDS.has(value);
+    }
+    function isValidLegacyFormTypeReference(typeName) {
+        if (!typeName.startsWith("form:")) return false;
+        const rest = typeName.slice(5);
+        if (0 === rest.length) return false;
+        let classPath = rest;
+        if (rest.startsWith("dep_")) {
+            const splitIndex = rest.indexOf(":");
+            if (splitIndex <= 0) return false;
+            const depId = rest.slice(0, splitIndex);
+            if (!DEP_ID_RE.test(depId)) return false;
+            classPath = rest.slice(splitIndex + 1);
+        }
+        if (0 === classPath.length) return false;
+        return classPath.split(".").every((part)=>isValidIdentifierSegment(part));
+    }
+    function isValidPackageQualifiedComponentType(typeName) {
+        if (typeName.startsWith("anvil.")) return false;
+        if (!typeName.includes(".")) return false;
+        const parts = typeName.split(".");
+        if (parts.length < 2) return false;
+        return parts.every((part)=>isValidIdentifierSegment(part));
+    }
+    function componentTypeSpec_pushIssue(issues, path, message) {
+        issues.push({
+            path,
+            message
+        });
+    }
+    function validateComponentTypeSpec(value, path, issues, allowedSingleSegmentTypes) {
+        if ("string" != typeof value || 0 === value.length) return void componentTypeSpec_pushIssue(issues, path, "must be a non-empty string");
+        const typeName = value;
+        if (typeName.startsWith("form:")) {
+            if (!isValidLegacyFormTypeReference(typeName)) componentTypeSpec_pushIssue(issues, path, LEGACY_FORM_TYPE_REFERENCE_MESSAGE);
+            return;
+        }
+        if (isValidPackageQualifiedComponentType(typeName)) return;
+        if (!isValidIdentifierSegment(typeName)) return void componentTypeSpec_pushIssue(issues, path, "must be a valid identifier");
+        if (!allowedSingleSegmentTypes.has(typeName)) componentTypeSpec_pushIssue(issues, path, COMPONENT_TYPE_REFERENCE_MESSAGE);
+    }
+    const formTemplateValidation_IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+    const formTemplateValidation_PYTHON_KEYWORDS = new Set([
         "False",
         "None",
         "True",
@@ -15295,58 +15960,29 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         "padding",
         "spacing"
     ]);
-    function isValidFormReference(typeName) {
-        if (!typeName.startsWith("form:")) return false;
-        const rest = typeName.slice(5);
-        if (0 === rest.length) return false;
-        let classPath = rest;
-        if (rest.startsWith("dep_")) {
-            const splitIndex = rest.indexOf(":");
-            if (splitIndex <= 0) return false;
-            const depId = rest.slice(0, splitIndex);
-            if (!DEP_ID_RE.test(depId)) return false;
-            classPath = rest.slice(splitIndex + 1);
-        }
-        if (0 === classPath.length) return false;
-        return classPath.split(".").every((part)=>IDENTIFIER_RE.test(part));
-    }
-    function isBuiltinComponentType(typeName) {
-        return BUILTIN_COMPONENT_TYPES.has(typeName);
-    }
     function isPlainObject(value) {
         return "object" == typeof value && null !== value && !Array.isArray(value);
     }
-    function pushIssue(issues, path, message) {
+    function formTemplateValidation_pushIssue(issues, path, message) {
         issues.push({
             path,
             message
         });
     }
-    function formatValidationPath(path) {
-        return path || "root";
-    }
     function validateIdentifier(value, path, issues) {
-        if ("string" != typeof value || 0 === value.length) return void pushIssue(issues, path, "must be a non-empty string");
-        if (!IDENTIFIER_RE.test(value)) return void pushIssue(issues, path, "must be a valid identifier");
-        if (PYTHON_KEYWORDS.has(value)) pushIssue(issues, path, "must be a valid Python identifier (not a keyword)");
+        if ("string" != typeof value || 0 === value.length) return void formTemplateValidation_pushIssue(issues, path, "must be a non-empty string");
+        if (!formTemplateValidation_IDENTIFIER_RE.test(value)) return void formTemplateValidation_pushIssue(issues, path, "must be a valid identifier");
+        if (formTemplateValidation_PYTHON_KEYWORDS.has(value)) formTemplateValidation_pushIssue(issues, path, "must be a valid Python identifier (not a keyword)");
     }
     function validateComponentType(value, path, issues) {
-        if ("string" != typeof value || 0 === value.length) return void pushIssue(issues, path, "must be a non-empty string");
-        const typeName = value;
-        if (typeName.startsWith("form:")) {
-            if (!isValidFormReference(typeName)) pushIssue(issues, path, "must be a valid form: reference (form:Module.Form, form:dep_xxx:Package.Form)");
-            return;
-        }
-        if (!IDENTIFIER_RE.test(typeName)) return void pushIssue(issues, path, "must be a valid identifier");
-        if (PYTHON_KEYWORDS.has(typeName)) return void pushIssue(issues, path, "must be a valid Python identifier (not a keyword)");
-        if (!isBuiltinComponentType(typeName)) pushIssue(issues, path, "must be a known Anvil component type (see componentIcons.ts) or a form: reference");
+        validateComponentTypeSpec(value, path, issues, BUILTIN_COMPONENT_TYPES);
     }
     function validatePropertiesObject(value, path, issues) {
-        if (void 0 !== value && !isPlainObject(value)) pushIssue(issues, path, "must be an object");
+        if (void 0 !== value && !isPlainObject(value)) formTemplateValidation_pushIssue(issues, path, "must be an object");
     }
     function validateEventBindingsObject(value, path, issues) {
         if (void 0 === value) return;
-        if (!isPlainObject(value)) return void pushIssue(issues, path, "must be an object");
+        if (!isPlainObject(value)) return void formTemplateValidation_pushIssue(issues, path, "must be an object");
         for (const [eventName, handlerName] of Object.entries(value)){
             validateIdentifier(eventName, `${path}.${eventName}.name`, issues);
             validateIdentifier(handlerName, `${path}.${eventName}`, issues);
@@ -15354,13 +15990,13 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
     }
     function validateDataBindings(value, path, issues) {
         if (void 0 === value) return;
-        if (!Array.isArray(value)) return void pushIssue(issues, path, "must be an array");
+        if (!Array.isArray(value)) return void formTemplateValidation_pushIssue(issues, path, "must be an array");
         value.forEach((binding, index)=>{
             const bindingPath = `${path}[${index}]`;
-            if (!isPlainObject(binding)) return void pushIssue(issues, bindingPath, "must be an object");
-            if ("string" != typeof binding.property || 0 === binding.property.length) pushIssue(issues, `${bindingPath}.property`, "must be a non-empty string");
-            if ("string" != typeof binding.code || 0 === binding.code.length) pushIssue(issues, `${bindingPath}.code`, "must be a non-empty string");
-            if (void 0 !== binding.writeback && "boolean" != typeof binding.writeback) pushIssue(issues, `${bindingPath}.writeback`, "must be a boolean");
+            if (!isPlainObject(binding)) return void formTemplateValidation_pushIssue(issues, bindingPath, "must be an object");
+            if ("string" != typeof binding.property || 0 === binding.property.length) formTemplateValidation_pushIssue(issues, `${bindingPath}.property`, "must be a non-empty string");
+            if ("string" != typeof binding.code || 0 === binding.code.length) formTemplateValidation_pushIssue(issues, `${bindingPath}.code`, "must be a non-empty string");
+            if (void 0 !== binding.writeback && "boolean" != typeof binding.writeback) formTemplateValidation_pushIssue(issues, `${bindingPath}.writeback`, "must be a boolean");
         });
     }
     function validateComponentArray(components, pathPrefix, issues, seenNames) {
@@ -15368,146 +16004,563 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             const childPath = `${pathPrefix}[${index}]`;
             validateComponentNode(component, childPath, issues, seenNames);
             if (isPlainObject(component) && "string" == typeof component.name && component.name.length > 0) {
-                if (seenNames.has(component.name)) pushIssue(issues, `${childPath}.name`, "must be unique across form components");
+                if (seenNames.has(component.name)) formTemplateValidation_pushIssue(issues, `${childPath}.name`, "must be unique across form components");
                 seenNames.add(component.name);
             }
         });
     }
     function validateComponentNode(value, path, issues, seenNames) {
-        if (!isPlainObject(value)) return void pushIssue(issues, path, "must be an object");
+        if (!isPlainObject(value)) return void formTemplateValidation_pushIssue(issues, path, "must be an object");
         validateComponentType(value.type, `${path}.type`, issues);
-        if (void 0 === value.name || "string" != typeof value.name || 0 === value.name.length) pushIssue(issues, `${path}.name`, "must be a non-empty string");
-        else validateIdentifier(value.name, `${path}.name`, issues);
+        validateComponentName(value.name, `${path}.name`, issues);
         validatePropertiesObject(value.properties, `${path}.properties`, issues);
         validatePropertiesObject(value.layout_properties, `${path}.layout_properties`, issues);
         validateEventBindingsObject(value.event_bindings, `${path}.event_bindings`, issues);
         validateDataBindings(value.data_bindings, `${path}.data_bindings`, issues);
         if (void 0 !== value.components) if (Array.isArray(value.components)) validateComponentArray(value.components, `${path}.components`, issues, seenNames);
-        else pushIssue(issues, `${path}.components`, "must be an array");
+        else formTemplateValidation_pushIssue(issues, `${path}.components`, "must be an array");
     }
     function validatePropertyDefinition(value, path, issues) {
-        if (!isPlainObject(value)) return void pushIssue(issues, path, "must be an object");
+        if (!isPlainObject(value)) return void formTemplateValidation_pushIssue(issues, path, "must be an object");
         validateIdentifier(value.name, `${path}.name`, issues);
-        if ("string" != typeof value.type || !PROPERTY_TYPES.has(value.type)) pushIssue(issues, `${path}.type`, "must be a supported property type");
-        if (void 0 !== value.description && "string" != typeof value.description) pushIssue(issues, `${path}.description`, "must be a string");
-        if (void 0 !== value.default_binding_prop && "boolean" != typeof value.default_binding_prop) pushIssue(issues, `${path}.default_binding_prop`, "must be a boolean");
-        if (void 0 !== value.allow_binding_writeback && "boolean" != typeof value.allow_binding_writeback) pushIssue(issues, `${path}.allow_binding_writeback`, "must be a boolean");
+        if ("string" != typeof value.type || !PROPERTY_TYPES.has(value.type)) formTemplateValidation_pushIssue(issues, `${path}.type`, "must be a supported property type");
+        if (void 0 !== value.description && "string" != typeof value.description) formTemplateValidation_pushIssue(issues, `${path}.description`, "must be a string");
+        if (void 0 !== value.default_binding_prop && "boolean" != typeof value.default_binding_prop) formTemplateValidation_pushIssue(issues, `${path}.default_binding_prop`, "must be a boolean");
+        if (void 0 !== value.allow_binding_writeback && "boolean" != typeof value.allow_binding_writeback) formTemplateValidation_pushIssue(issues, `${path}.allow_binding_writeback`, "must be a boolean");
         if (void 0 !== value.binding_writeback_events) if (Array.isArray(value.binding_writeback_events)) value.binding_writeback_events.forEach((eventName, index)=>{
-            if ("string" != typeof eventName || 0 === eventName.length) pushIssue(issues, `${path}.binding_writeback_events[${index}]`, "must be a non-empty string");
+            if ("string" != typeof eventName || 0 === eventName.length) formTemplateValidation_pushIssue(issues, `${path}.binding_writeback_events[${index}]`, "must be a non-empty string");
         });
-        else pushIssue(issues, `${path}.binding_writeback_events`, "must be an array");
+        else formTemplateValidation_pushIssue(issues, `${path}.binding_writeback_events`, "must be an array");
         if ("enum" === value.type) {
-            if (!Array.isArray(value.options) || value.options.some((option)=>"string" != typeof option)) pushIssue(issues, `${path}.options`, "must be an array of strings for enum properties");
+            if (!Array.isArray(value.options) || value.options.some((option)=>"string" != typeof option)) formTemplateValidation_pushIssue(issues, `${path}.options`, "must be an array of strings for enum properties");
         }
     }
     function validateEventDefinition(value, path, issues) {
-        if (!isPlainObject(value)) return void pushIssue(issues, path, "must be an object");
+        if (!isPlainObject(value)) return void formTemplateValidation_pushIssue(issues, path, "must be an object");
         validateIdentifier(value.name, `${path}.name`, issues);
-        if (void 0 !== value.description && "string" != typeof value.description) pushIssue(issues, `${path}.description`, "must be a string");
-        if (void 0 !== value.default_event && "boolean" != typeof value.default_event) pushIssue(issues, `${path}.default_event`, "must be a boolean");
+        if (void 0 !== value.description && "string" != typeof value.description) formTemplateValidation_pushIssue(issues, `${path}.description`, "must be a string");
+        if (void 0 !== value.default_event && "boolean" != typeof value.default_event) formTemplateValidation_pushIssue(issues, `${path}.default_event`, "must be a boolean");
         if (void 0 !== value.parameters) if (Array.isArray(value.parameters)) value.parameters.forEach((parameter, index)=>{
-            if (!isPlainObject(parameter)) return void pushIssue(issues, `${path}.parameters[${index}]`, "must be an object");
+            if (!isPlainObject(parameter)) return void formTemplateValidation_pushIssue(issues, `${path}.parameters[${index}]`, "must be an object");
             validateIdentifier(parameter.name, `${path}.parameters[${index}].name`, issues);
-            if (void 0 !== parameter.description && "string" != typeof parameter.description) pushIssue(issues, `${path}.parameters[${index}].description`, "must be a string");
+            if (void 0 !== parameter.description && "string" != typeof parameter.description) formTemplateValidation_pushIssue(issues, `${path}.parameters[${index}].description`, "must be a string");
         });
-        else pushIssue(issues, `${path}.parameters`, "must be an array");
+        else formTemplateValidation_pushIssue(issues, `${path}.parameters`, "must be an array");
     }
     function validateSlotDefinition(value, path, issues, seenNames) {
-        if (!isPlainObject(value)) return void pushIssue(issues, path, "must be an object");
-        if ("number" != typeof value.index || !Number.isInteger(value.index) || value.index < 0) pushIssue(issues, `${path}.index`, "must be a non-negative integer");
+        if (!isPlainObject(value)) return void formTemplateValidation_pushIssue(issues, path, "must be an object");
+        if ("number" != typeof value.index || !Number.isInteger(value.index) || value.index < 0) formTemplateValidation_pushIssue(issues, `${path}.index`, "must be a non-negative integer");
         validatePropertiesObject(value.set_layout_properties, `${path}.set_layout_properties`, issues);
         if (isPlainObject(value.target)) {
-            if ("container" !== value.target.type && "slot" !== value.target.type) pushIssue(issues, `${path}.target.type`, "must be 'container' or 'slot'");
-            validateIdentifier(value.target.name, `${path}.target.name`, issues);
-        } else pushIssue(issues, `${path}.target`, "must be an object");
+            if ("container" !== value.target.type && "slot" !== value.target.type) formTemplateValidation_pushIssue(issues, `${path}.target.type`, "must be 'container' or 'slot'");
+            if ("container" !== value.target.type || "" !== value.target.name) validateIdentifier(value.target.name, `${path}.target.name`, issues);
+        } else formTemplateValidation_pushIssue(issues, `${path}.target`, "must be an object");
         if (void 0 !== value.template) validateComponentNode(value.template, `${path}.template`, issues, seenNames);
     }
+    function prefixedPath(pathPrefix, path) {
+        return pathPrefix.length > 0 ? `${pathPrefix}.${path}` : path;
+    }
+    function validateFormTemplateMetadata(value, options = {}) {
+        const issues = [];
+        if (!isPlainObject(value)) {
+            formTemplateValidation_pushIssue(issues, options.pathPrefix ?? "", "must be a YAML object");
+            return issues;
+        }
+        const pathPrefix = options.pathPrefix ?? "";
+        const path = (suffix)=>prefixedPath(pathPrefix, suffix);
+        if (void 0 !== value.custom_component && "boolean" != typeof value.custom_component) formTemplateValidation_pushIssue(issues, path("custom_component"), "must be a boolean");
+        if (void 0 !== value.custom_component_container && "boolean" != typeof value.custom_component_container) formTemplateValidation_pushIssue(issues, path("custom_component_container"), "must be a boolean");
+        if (true === value.custom_component_container && true !== value.custom_component) formTemplateValidation_pushIssue(issues, path("custom_component_container"), "requires custom_component: true");
+        const properties = value.properties;
+        if (void 0 !== properties) if (Array.isArray(properties)) {
+            const seenNames = new Set();
+            let defaultBindingPropCount = 0;
+            properties.forEach((property, index)=>{
+                validatePropertyDefinition(property, path(`properties[${index}]`), issues);
+                if (!isPlainObject(property) || "string" != typeof property.name) return;
+                if (seenNames.has(property.name)) formTemplateValidation_pushIssue(issues, path(`properties[${index}].name`), "must be unique");
+                seenNames.add(property.name);
+                if (property.default_binding_prop) defaultBindingPropCount++;
+            });
+            if (defaultBindingPropCount > 1) formTemplateValidation_pushIssue(issues, path("properties"), "can only define one default_binding_prop");
+        } else formTemplateValidation_pushIssue(issues, path("properties"), "must be an array");
+        const events = value.events;
+        const eventNames = new Set();
+        if (void 0 !== events) if (Array.isArray(events)) {
+            let defaultEventCount = 0;
+            events.forEach((event, index)=>{
+                validateEventDefinition(event, path(`events[${index}]`), issues);
+                if (!isPlainObject(event) || "string" != typeof event.name) return;
+                if (eventNames.has(event.name)) formTemplateValidation_pushIssue(issues, path(`events[${index}].name`), "must be unique");
+                eventNames.add(event.name);
+                if (event.default_event) defaultEventCount++;
+            });
+            if (defaultEventCount > 1) formTemplateValidation_pushIssue(issues, path("events"), "can only define one default_event");
+        } else formTemplateValidation_pushIssue(issues, path("events"), "must be an array");
+        if (Array.isArray(properties)) properties.forEach((property, index)=>{
+            if (!isPlainObject(property) || !Array.isArray(property.binding_writeback_events)) return;
+            property.binding_writeback_events.forEach((eventName, eventIndex)=>{
+                if ("string" == typeof eventName && !eventNames.has(eventName)) formTemplateValidation_pushIssue(issues, path(`properties[${index}].binding_writeback_events[${eventIndex}]`), "must reference a defined event");
+            });
+        });
+        if (void 0 !== value.slots) {
+            const slotsPath = path("slots");
+            if (isPlainObject(value.slots)) if ("empty-marker" === options.slotsPolicy) {
+                if (Object.keys(value.slots).length > 0) formTemplateValidation_pushIssue(issues, slotsPath, "must be empty when defined in frontmatter");
+            } else {
+                const componentNames = options.componentNames ?? new Set();
+                for (const [slotName, slotDef] of Object.entries(value.slots)){
+                    validateIdentifier(slotName, path(`slots.${slotName}.name`), issues);
+                    validateSlotDefinition(slotDef, path(`slots.${slotName}`), issues, componentNames);
+                }
+            }
+            else formTemplateValidation_pushIssue(issues, slotsPath, "must be an object");
+        }
+        if (void 0 !== value.toolbox_item && !isPlainObject(value.toolbox_item)) formTemplateValidation_pushIssue(issues, path("toolbox_item"), "must be an object");
+        if (void 0 !== value.layout_metadata && !isPlainObject(value.layout_metadata)) formTemplateValidation_pushIssue(issues, path("layout_metadata"), "must be an object");
+        if (void 0 !== value.item_type) if (isPlainObject(value.item_type)) {
+            if ("number" != typeof value.item_type.table_id) formTemplateValidation_pushIssue(issues, path("item_type.table_id"), "must be a number");
+        } else formTemplateValidation_pushIssue(issues, path("item_type"), "must be an object");
+        return issues;
+    }
     function validateFormTemplateData(value) {
         const issues = [];
         const componentNames = new Set();
         if (!isPlainObject(value)) {
-            pushIssue(issues, "", "must be a YAML object");
+            formTemplateValidation_pushIssue(issues, "", "must be a YAML object");
             return issues;
         }
         const hasContainer = void 0 !== value.container;
         const hasLayout = void 0 !== value.layout;
         const hasComponents = void 0 !== value.components;
         const hasComponentsBySlot = void 0 !== value.components_by_slot;
-        if (hasContainer && hasLayout) pushIssue(issues, "", "cannot define both container and layout");
-        if (!hasContainer && !hasLayout) pushIssue(issues, "", "must define either container or layout");
-        if (void 0 !== value.is_package && "boolean" != typeof value.is_package) pushIssue(issues, "is_package", "must be a boolean");
+        if (hasContainer && hasLayout) formTemplateValidation_pushIssue(issues, "", "cannot define both container and layout");
+        if (!hasContainer && !hasLayout) formTemplateValidation_pushIssue(issues, "", "must define either container or layout");
+        if (void 0 !== value.is_package && "boolean" != typeof value.is_package) formTemplateValidation_pushIssue(issues, "is_package", "must be a boolean");
         if (hasContainer) if (isPlainObject(value.container)) {
             validateComponentType(value.container.type, "container.type", issues);
             validatePropertiesObject(value.container.properties, "container.properties", issues);
             validatePropertiesObject(value.container.layout_properties, "container.layout_properties", issues);
             validateEventBindingsObject(value.container.event_bindings, "container.event_bindings", issues);
             validateDataBindings(value.container.data_bindings, "container.data_bindings", issues);
-        } else pushIssue(issues, "container", "must be an object");
+        } else formTemplateValidation_pushIssue(issues, "container", "must be an object");
         if (hasLayout) if (isPlainObject(value.layout)) {
             validateComponentType(value.layout.type, "layout.type", issues);
             validatePropertiesObject(value.layout.properties, "layout.properties", issues);
             validateEventBindingsObject(value.layout.event_bindings, "layout.event_bindings", issues);
             validateEventBindingsObject(value.layout.form_event_bindings, "layout.form_event_bindings", issues);
             validateDataBindings(value.layout.data_bindings, "layout.data_bindings", issues);
-        } else pushIssue(issues, "layout", "must be an object");
-        if (hasComponents && hasLayout) pushIssue(issues, "components", "can only be used with container-based forms");
-        else if (hasComponents && !hasContainer) pushIssue(issues, "components", "can only be used with container-based forms");
+        } else formTemplateValidation_pushIssue(issues, "layout", "must be an object");
+        if (hasComponents && hasLayout) formTemplateValidation_pushIssue(issues, "components", "can only be used with container-based forms");
+        else if (hasComponents && !hasContainer) formTemplateValidation_pushIssue(issues, "components", "can only be used with container-based forms");
         else if (hasComponents) if (Array.isArray(value.components)) validateComponentArray(value.components, "components", issues, componentNames);
-        else pushIssue(issues, "components", "must be an array");
-        if (hasComponentsBySlot && hasContainer) pushIssue(issues, "components_by_slot", "can only be used with layout-based forms");
-        else if (hasComponentsBySlot && !hasLayout) pushIssue(issues, "components_by_slot", "can only be used with layout-based forms");
+        else formTemplateValidation_pushIssue(issues, "components", "must be an array");
+        if (hasComponentsBySlot && hasContainer) formTemplateValidation_pushIssue(issues, "components_by_slot", "can only be used with layout-based forms");
+        else if (hasComponentsBySlot && !hasLayout) formTemplateValidation_pushIssue(issues, "components_by_slot", "can only be used with layout-based forms");
         else if (hasComponentsBySlot) if (isPlainObject(value.components_by_slot)) for (const [slotName, slotComponents] of Object.entries(value.components_by_slot)){
             if (!Array.isArray(slotComponents)) {
-                pushIssue(issues, `components_by_slot.${slotName}`, "must be an array");
+                formTemplateValidation_pushIssue(issues, `components_by_slot.${slotName}`, "must be an array");
                 continue;
             }
             validateComponentArray(slotComponents, `components_by_slot.${slotName}`, issues, componentNames);
         }
-        else pushIssue(issues, "components_by_slot", "must be an object");
-        if (void 0 !== value.custom_component && "boolean" != typeof value.custom_component) pushIssue(issues, "custom_component", "must be a boolean");
-        if (void 0 !== value.custom_component_container && "boolean" != typeof value.custom_component_container) pushIssue(issues, "custom_component_container", "must be a boolean");
-        if (true === value.custom_component_container && true !== value.custom_component) pushIssue(issues, "custom_component_container", "requires custom_component: true");
-        const properties = value.properties;
-        if (void 0 !== properties) if (Array.isArray(properties)) {
-            const seenNames = new Set();
-            let defaultBindingPropCount = 0;
-            properties.forEach((property, index)=>{
-                validatePropertyDefinition(property, `properties[${index}]`, issues);
-                if (!isPlainObject(property) || "string" != typeof property.name) return;
-                if (seenNames.has(property.name)) pushIssue(issues, `properties[${index}].name`, "must be unique");
-                seenNames.add(property.name);
-                if (property.default_binding_prop) defaultBindingPropCount++;
-            });
-            if (defaultBindingPropCount > 1) pushIssue(issues, "properties", "can only define one default_binding_prop");
-        } else pushIssue(issues, "properties", "must be an array");
-        const events = value.events;
-        const eventNames = new Set();
-        if (void 0 !== events) if (Array.isArray(events)) {
-            let defaultEventCount = 0;
-            events.forEach((event, index)=>{
-                validateEventDefinition(event, `events[${index}]`, issues);
-                if (!isPlainObject(event) || "string" != typeof event.name) return;
-                if (eventNames.has(event.name)) pushIssue(issues, `events[${index}].name`, "must be unique");
-                eventNames.add(event.name);
-                if (event.default_event) defaultEventCount++;
-            });
-            if (defaultEventCount > 1) pushIssue(issues, "events", "can only define one default_event");
-        } else pushIssue(issues, "events", "must be an array");
-        if (Array.isArray(properties)) properties.forEach((property, index)=>{
-            if (!isPlainObject(property) || !Array.isArray(property.binding_writeback_events)) return;
-            property.binding_writeback_events.forEach((eventName, eventIndex)=>{
-                if ("string" == typeof eventName && !eventNames.has(eventName)) pushIssue(issues, `properties[${index}].binding_writeback_events[${eventIndex}]`, "must reference a defined event");
+        else formTemplateValidation_pushIssue(issues, "components_by_slot", "must be an object");
+        issues.push(...validateFormTemplateMetadata(value, {
+            componentNames
+        }));
+        return issues;
+    }
+    const KNOWN_RUNTIME_SERVICE_SOURCES = new Set([
+        "/runtime/services/tables.yml",
+        "/runtime/services/google.yml",
+        "/runtime/services/uplink.yml",
+        "/runtime/services/stripe.yml",
+        "/runtime/services/segment.yml",
+        "/runtime/services/facebook.yml",
+        "/runtime/services/anvil/users.yml",
+        "/runtime/services/anvil/secrets.yml",
+        "/runtime/services/anvil/saml.yml",
+        "/runtime/services/anvil/microsoft.yml",
+        "/runtime/services/anvil/email.yml",
+        "/runtime/services/anvil/files.yml"
+    ]);
+    const FRONTMATTER_ALLOWED_KEYS = new Set([
+        "custom_component",
+        "custom_component_container",
+        "properties",
+        "events",
+        "toolbox_item",
+        "layout_metadata",
+        "item_type",
+        "slots"
+    ]);
+    const FRONTMATTER_DISALLOWED_KEYS = new Set([
+        "container",
+        "components",
+        "layout",
+        "components_by_slot",
+        "code",
+        "class_name",
+        "is_package",
+        "save_as_html",
+        "serialized_html"
+    ]);
+    function validateFormTemplateHtml_isPlainObject(value) {
+        return "object" == typeof value && null !== value && !Array.isArray(value);
+    }
+    function validateFormTemplateHtml_pushIssue(issues, issuePath, message) {
+        issues.push({
+            path: issuePath,
+            message
+        });
+    }
+    function splitHtmlFormTemplateFrontmatter(htmlContent) {
+        const match = htmlContent.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+        if (!match) return {
+            frontmatter: null,
+            body: htmlContent
+        };
+        return {
+            frontmatter: match[1],
+            body: htmlContent.slice(match[0].length)
+        };
+    }
+    function validateHtmlFrontmatter(frontmatterYaml) {
+        const issues = [];
+        if (0 === frontmatterYaml.trim().length) {
+            validateFormTemplateHtml_pushIssue(issues, "frontmatter", "must not be empty; omit frontmatter entirely when unused");
+            return issues;
+        }
+        let data;
+        try {
+            data = external_js_yaml_namespaceObject.load(frontmatterYaml);
+        } catch (error) {
+            validateFormTemplateHtml_pushIssue(issues, "frontmatter", error instanceof Error ? error.message : String(error));
+            return issues;
+        }
+        if (!validateFormTemplateHtml_isPlainObject(data)) {
+            validateFormTemplateHtml_pushIssue(issues, "frontmatter", "must be a YAML object");
+            return issues;
+        }
+        for (const key of Object.keys(data))if (FRONTMATTER_DISALLOWED_KEYS.has(key)) validateFormTemplateHtml_pushIssue(issues, `frontmatter.${key}`, "belongs in the HTML body, not frontmatter");
+        else if (!FRONTMATTER_ALLOWED_KEYS.has(key)) validateFormTemplateHtml_pushIssue(issues, `frontmatter.${key}`, "is not an allowed frontmatter field");
+        issues.push(...validateFormTemplateMetadata(data, {
+            pathPrefix: "frontmatter",
+            slotsPolicy: "empty-marker"
+        }));
+        return issues;
+    }
+    function validateParsedHtmlTemplate(parsed) {
+        return validateFormTemplateData(parsed);
+    }
+    function validateFormTemplateHtml(htmlContent) {
+        const { frontmatter, body } = splitHtmlFormTemplateFrontmatter(htmlContent);
+        if (null !== frontmatter) {
+            const frontmatterIssues = validateHtmlFrontmatter(frontmatter);
+            if (frontmatterIssues.length > 0) return {
+                ok: false,
+                message: "form_template.html is invalid for Anvil",
+                issues: frontmatterIssues
+            };
+        }
+        let parsed;
+        try {
+            parsed = (0, form_template_parser_namespaceObject.parseSerializedHtml)(body);
+        } catch (error) {
+            return {
+                ok: false,
+                message: "form_template.html could not be parsed",
+                issues: [
+                    {
+                        path: "",
+                        message: error instanceof Error ? error.message : String(error)
+                    }
+                ]
+            };
+        }
+        const issues = validateParsedHtmlTemplate(parsed);
+        if (issues.length > 0) return {
+            ok: false,
+            message: "form_template.html is invalid for Anvil",
+            issues
+        };
+        return {
+            ok: true
+        };
+    }
+    const PYTHON_VALIDATOR_SCRIPT = String.raw`
+import ast
+import json
+import sys
+
+
+def issue_path(error):
+    if getattr(error, "lineno", None) is None:
+        return "root"
+    if getattr(error, "offset", None) is None:
+        return f"line {error.lineno}"
+    return f"line {error.lineno}, column {error.offset}"
+
+
+def base_name(node):
+    if isinstance(node, ast.Name):
+        return node.id
+    if isinstance(node, ast.Attribute):
+        return node.attr
+    return None
+
+
+def imports_template_from_anvil_designer(node, template_name):
+    if node.level < 1:
+        return False
+    if node.module not in ("_anvil_designer", None):
+        return False
+    return any(alias.name == template_name for alias in node.names)
+
+
+file_path = sys.argv[1]
+class_name = sys.argv[2]
+template_name = f"{class_name}Template" if class_name else ""
+source = sys.stdin.read()
+issues = []
+
+try:
+    compile(source, file_path, "exec")
+except SyntaxError as error:
+    issues.append({"path": issue_path(error), "message": error.msg})
+    print(json.dumps({"issues": issues}))
+    sys.exit(0)
+
+if class_name:
+    tree = ast.parse(source, filename=file_path)
+    has_template_import = False
+    has_form_class = False
+
+    for node in ast.walk(tree):
+        if isinstance(node, ast.ImportFrom) and imports_template_from_anvil_designer(node, template_name):
+            has_template_import = True
+        elif isinstance(node, ast.ClassDef) and node.name == class_name:
+            if any(base_name(base) == template_name for base in node.bases):
+                has_form_class = True
+
+    if not has_template_import:
+        issues.append({
+            "path": "root",
+            "message": f"missing {chr(96)}from ._anvil_designer import {template_name}{chr(96)}",
+        })
+    if not has_form_class:
+        issues.append({
+            "path": "root",
+            "message": f"missing class {chr(96)}{class_name}{chr(96)} inheriting from {chr(96)}{template_name}{chr(96)}",
+        })
+
+print(json.dumps({"issues": issues}))
+`;
+    function findPythonInterpreter(env = process.env, probe = external_child_process_namespaceObject.spawnSync) {
+        const candidates = [
+            ..."string" == typeof env.ANVIL_PYTHON && env.ANVIL_PYTHON.length > 0 ? [
+                {
+                    command: env.ANVIL_PYTHON,
+                    args: []
+                }
+            ] : [],
+            {
+                command: "uv",
+                args: [
+                    "run",
+                    "--isolated",
+                    "--no-python-downloads",
+                    "python"
+                ]
+            },
+            {
+                command: "python3",
+                args: []
+            },
+            {
+                command: "python",
+                args: []
+            }
+        ];
+        for (const candidate of candidates){
+            const result = probe(candidate.command, [
+                ...candidate.args,
+                "--version"
+            ], {
+                encoding: "utf8"
             });
+            if (!result.error && 0 === result.status) return candidate;
+        }
+        return null;
+    }
+    function isClientFormPython(filePath) {
+        if ("__init__.py" === external_path_default().basename(filePath)) {
+            const formDir = external_path_default().dirname(filePath);
+            return external_fs_.existsSync(external_path_default().join(formDir, "form_template.html")) || external_fs_.existsSync(external_path_default().join(formDir, "form_template.yaml"));
+        }
+        const parsed = external_path_default().parse(filePath);
+        return external_fs_.existsSync(external_path_default().join(parsed.dir, `${parsed.name}.html`)) || external_fs_.existsSync(external_path_default().join(parsed.dir, `${parsed.name}.yaml`));
+    }
+    function expectedFormClassName(filePath) {
+        if (!isClientFormPython(filePath)) return null;
+        if ("__init__.py" === external_path_default().basename(filePath)) return external_path_default().basename(external_path_default().dirname(filePath));
+        return external_path_default().basename(filePath, ".py");
+    }
+    function isUnderDirectory(filePath, directoryPath) {
+        const relativePath = external_path_default().relative(directoryPath, filePath);
+        return relativePath.length > 0 && !relativePath.startsWith("..") && !external_path_default().isAbsolute(relativePath);
+    }
+    function validatePython(filePath, fileContent, appRoot) {
+        const interpreter = findPythonInterpreter();
+        if (!interpreter) return {
+            ok: false,
+            message: "Python file could not be validated",
+            issues: [
+                {
+                    path: "root",
+                    message: "Python validation requires uv, python3, or python on PATH, or ANVIL_PYTHON to be set"
+                }
+            ]
+        };
+        const absolutePath = external_path_default().resolve(filePath);
+        const clientCodeRoot = appRoot ? external_path_default().join(appRoot, "client_code") : null;
+        const formClassName = clientCodeRoot && isUnderDirectory(absolutePath, clientCodeRoot) ? expectedFormClassName(absolutePath) : null;
+        const result = (0, external_child_process_namespaceObject.spawnSync)(interpreter.command, [
+            ...interpreter.args,
+            "-c",
+            PYTHON_VALIDATOR_SCRIPT,
+            filePath,
+            formClassName ?? ""
+        ], {
+            encoding: "utf8",
+            input: fileContent,
+            maxBuffer: 1048576
+        });
+        if (result.error || 0 !== result.status) return {
+            ok: false,
+            message: "Python file could not be validated",
+            issues: [
+                {
+                    path: "root",
+                    message: result.error?.message ?? (result.stderr.trim() || "Python validator failed")
+                }
+            ]
+        };
+        let parsed;
+        try {
+            parsed = JSON.parse(result.stdout);
+        } catch (error) {
+            return {
+                ok: false,
+                message: "Python file could not be validated",
+                issues: [
+                    {
+                        path: "root",
+                        message: error instanceof Error ? error.message : String(error)
+                    }
+                ]
+            };
+        }
+        const issues = parsed.issues ?? [];
+        if (issues.length > 0) return {
+            ok: false,
+            message: "Python file is invalid for Anvil",
+            issues
+        };
+        return {
+            ok: true
+        };
+    }
+    const validators_IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+    const DB_ACCESS_LEVELS = new Set([
+        "none",
+        "search",
+        "full"
+    ]);
+    const DB_BASIC_COLUMN_TYPES = new Set([
+        "string",
+        "number",
+        "bool",
+        "date",
+        "datetime",
+        "media",
+        "simpleObject"
+    ]);
+    const DB_LINK_COLUMN_TYPES = new Set([
+        "link_single",
+        "link_multiple"
+    ]);
+    const DB_TABLE_INDEX_TYPES = new Set([
+        "b_tree",
+        "trigram",
+        "full_text"
+    ]);
+    const SCHEDULE_EVERY_VALUES = new Set([
+        "minute",
+        "hour",
+        "day",
+        "week",
+        "month"
+    ]);
+    const CLIENT_VERSIONS = new Set([
+        "2",
+        "3"
+    ]);
+    const validators_PYTHON_KEYWORDS = new Set([
+        "False",
+        "None",
+        "True",
+        "and",
+        "as",
+        "assert",
+        "async",
+        "await",
+        "break",
+        "class",
+        "continue",
+        "def",
+        "del",
+        "elif",
+        "else",
+        "except",
+        "finally",
+        "for",
+        "from",
+        "global",
+        "if",
+        "import",
+        "in",
+        "is",
+        "lambda",
+        "nonlocal",
+        "not",
+        "or",
+        "pass",
+        "raise",
+        "return",
+        "try",
+        "while",
+        "with",
+        "yield",
+        "match",
+        "case"
+    ]);
+    function validators_isPlainObject(value) {
+        return "object" == typeof value && null !== value && !Array.isArray(value);
+    }
+    function validators_pushIssue(issues, path, message) {
+        issues.push({
+            path,
+            message
         });
-        if (void 0 !== value.slots) if (isPlainObject(value.slots)) for (const [slotName, slotDef] of Object.entries(value.slots)){
-            validateIdentifier(slotName, `slots.${slotName}.name`, issues);
-            validateSlotDefinition(slotDef, `slots.${slotName}`, issues, componentNames);
-        }
-        else pushIssue(issues, "slots", "must be an object");
-        if (void 0 !== value.item_type) if (isPlainObject(value.item_type)) {
-            if ("number" != typeof value.item_type.table_id) pushIssue(issues, "item_type.table_id", "must be a number");
-        } else pushIssue(issues, "item_type", "must be an object");
-        return issues;
+    }
+    function formatValidationPath(path) {
+        return path || "root";
+    }
+    function validators_validateIdentifier(value, path, issues) {
+        if ("string" != typeof value || 0 === value.length) return void validators_pushIssue(issues, path, "must be a non-empty string");
+        if (!validators_IDENTIFIER_RE.test(value)) return void validators_pushIssue(issues, path, "must be a valid identifier");
+        if (validators_PYTHON_KEYWORDS.has(value)) validators_pushIssue(issues, path, "must be a valid Python identifier (not a keyword)");
     }
     function validateFormTemplate(yamlContent) {
         try {
@@ -15534,7 +16587,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             };
         }
     }
-    const serviceConfigObject = external_valibot_namespaceObject.custom((input)=>isPlainObject(input), "must be an object");
+    const serviceConfigObject = external_valibot_namespaceObject.custom((input)=>validators_isPlainObject(input), "must be an object");
     const AnvilServiceEntrySchema = external_valibot_namespaceObject.looseObject({
         source: external_valibot_namespaceObject.pipe(external_valibot_namespaceObject.string(), external_valibot_namespaceObject.nonEmpty()),
         client_config: external_valibot_namespaceObject.optional(serviceConfigObject),
@@ -15562,14 +16615,14 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
     function validateRuntimeOptions(value, path) {
         const issues = [];
         if (void 0 === value) return issues;
-        if (!isPlainObject(value)) return issues;
+        if (!validators_isPlainObject(value)) return issues;
         if (void 0 !== value.client_version) {
-            if ("string" != typeof value.client_version || !CLIENT_VERSIONS.has(value.client_version)) pushIssue(issues, `${path}.client_version`, 'must be "2" or "3"');
+            if ("string" != typeof value.client_version || !CLIENT_VERSIONS.has(value.client_version)) validators_pushIssue(issues, `${path}.client_version`, 'must be "2" or "3"');
         }
         if (void 0 !== value.server_spec && null !== value.server_spec) {
-            if (!isPlainObject(value.server_spec)) return issues;
-            if ("requirements" in value.server_spec) pushIssue(issues, `${path}.server_spec.requirements`, "is not a valid anvil.yaml field; requirements come from server_code/requirements.txt");
-            if (void 0 !== value.server_spec.base && "string" != typeof value.server_spec.base) pushIssue(issues, `${path}.server_spec.base`, "must be a string");
+            if (!validators_isPlainObject(value.server_spec)) return issues;
+            if ("requirements" in value.server_spec) validators_pushIssue(issues, `${path}.server_spec.requirements`, "is not a valid anvil.yaml field; requirements come from server_code/requirements.txt");
+            if (void 0 !== value.server_spec.base && "string" != typeof value.server_spec.base) validators_pushIssue(issues, `${path}.server_spec.base`, "must be a string");
         }
         return issues;
     }
@@ -15577,27 +16630,27 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         const issues = [];
         if (void 0 === value) return issues;
         if (null === value) {
-            pushIssue(issues, path, "must be an object, an empty array, or omitted");
+            validators_pushIssue(issues, path, "must be an object, an empty array, or omitted");
             return issues;
         }
         if (Array.isArray(value)) {
             if (0 === value.length) return issues;
-            pushIssue(issues, path, "must be an object mapping table names to schemas, or an empty array");
+            validators_pushIssue(issues, path, "must be an object mapping table names to schemas, or an empty array");
             return issues;
         }
-        if (!isPlainObject(value)) {
-            pushIssue(issues, path, "must be an object mapping table names to schemas");
+        if (!validators_isPlainObject(value)) {
+            validators_pushIssue(issues, path, "must be an object mapping table names to schemas");
             return issues;
         }
         for (const tableName of Object.keys(value)){
             const tablePath = `${path}.${tableName}`;
-            if (!IDENTIFIER_RE.test(tableName)) {
-                pushIssue(issues, tablePath, "must be a valid Python identifier");
+            if (!validators_IDENTIFIER_RE.test(tableName)) {
+                validators_pushIssue(issues, tablePath, "must be a valid Python identifier");
                 continue;
             }
             const table = value[tableName];
-            if (!isPlainObject(table)) {
-                pushIssue(issues, tablePath, "must be an object");
+            if (!validators_isPlainObject(table)) {
+                validators_pushIssue(issues, tablePath, "must be an object");
                 continue;
             }
             for (const req of [
@@ -15605,61 +16658,61 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 "server",
                 "title",
                 "columns"
-            ])if (void 0 === table[req]) pushIssue(issues, `${tablePath}.${req}`, "is required");
+            ])if (void 0 === table[req]) validators_pushIssue(issues, `${tablePath}.${req}`, "is required");
             if (void 0 !== table.client) {
-                if ("string" != typeof table.client || !DB_ACCESS_LEVELS.has(table.client)) pushIssue(issues, `${tablePath}.client`, 'must be "none", "search", or "full"');
+                if ("string" != typeof table.client || !DB_ACCESS_LEVELS.has(table.client)) validators_pushIssue(issues, `${tablePath}.client`, 'must be "none", "search", or "full"');
             }
             if (void 0 !== table.server) {
-                if ("string" != typeof table.server || !DB_ACCESS_LEVELS.has(table.server)) pushIssue(issues, `${tablePath}.server`, 'must be "none", "search", or "full"');
+                if ("string" != typeof table.server || !DB_ACCESS_LEVELS.has(table.server)) validators_pushIssue(issues, `${tablePath}.server`, 'must be "none", "search", or "full"');
             }
             if (void 0 !== table.title) {
-                if ("string" != typeof table.title || 0 === table.title.length) pushIssue(issues, `${tablePath}.title`, "must be a non-empty string");
+                if ("string" != typeof table.title || 0 === table.title.length) validators_pushIssue(issues, `${tablePath}.title`, "must be a non-empty string");
             }
             if (void 0 !== table.columns) if (Array.isArray(table.columns)) table.columns.forEach((column, index)=>{
                 validateDbSchemaColumn(column, `${tablePath}.columns[${index}]`, issues);
             });
-            else pushIssue(issues, `${tablePath}.columns`, "must be an array");
+            else validators_pushIssue(issues, `${tablePath}.columns`, "must be an array");
             if (void 0 !== table.indexes) if (Array.isArray(table.indexes)) table.indexes.forEach((indexEntry, index)=>{
                 validateDbTableIndex(indexEntry, `${tablePath}.indexes[${index}]`, issues);
             });
-            else pushIssue(issues, `${tablePath}.indexes`, "must be an array");
+            else validators_pushIssue(issues, `${tablePath}.indexes`, "must be an array");
         }
         return issues;
     }
     function validateDbTableIndex(value, path, issues) {
-        if (!isPlainObject(value)) return void pushIssue(issues, path, "must be an object");
-        if (!Array.isArray(value.columns) || value.columns.some((c)=>"string" != typeof c)) pushIssue(issues, `${path}.columns`, "must be an array of strings");
-        if (void 0 === value.type) pushIssue(issues, `${path}.type`, "is required");
-        else if ("string" != typeof value.type || !DB_TABLE_INDEX_TYPES.has(value.type)) pushIssue(issues, `${path}.type`, 'must be "b_tree", "trigram", or "full_text"');
+        if (!validators_isPlainObject(value)) return void validators_pushIssue(issues, path, "must be an object");
+        if (!Array.isArray(value.columns) || value.columns.some((c)=>"string" != typeof c)) validators_pushIssue(issues, `${path}.columns`, "must be an array of strings");
+        if (void 0 === value.type) validators_pushIssue(issues, `${path}.type`, "is required");
+        else if ("string" != typeof value.type || !DB_TABLE_INDEX_TYPES.has(value.type)) validators_pushIssue(issues, `${path}.type`, 'must be "b_tree", "trigram", or "full_text"');
     }
     function validateDbSchemaColumn(value, path, issues) {
-        if (!isPlainObject(value)) return void pushIssue(issues, path, "must be an object");
-        if (void 0 === value.name || "string" != typeof value.name || 0 === value.name.length) pushIssue(issues, `${path}.name`, "must be a non-empty string");
-        else if (!IDENTIFIER_RE.test(value.name)) pushIssue(issues, `${path}.name`, "must be a valid Python identifier");
-        if (void 0 === value.type) return void pushIssue(issues, `${path}.type`, "is required");
-        if ("string" != typeof value.type) return void pushIssue(issues, `${path}.type`, "must be a string");
+        if (!validators_isPlainObject(value)) return void validators_pushIssue(issues, path, "must be an object");
+        if (void 0 === value.name || "string" != typeof value.name || 0 === value.name.length) validators_pushIssue(issues, `${path}.name`, "must be a non-empty string");
+        else if (!validators_IDENTIFIER_RE.test(value.name)) validators_pushIssue(issues, `${path}.name`, "must be a valid Python identifier");
+        if (void 0 === value.type) return void validators_pushIssue(issues, `${path}.type`, "is required");
+        if ("string" != typeof value.type) return void validators_pushIssue(issues, `${path}.type`, "must be a string");
         const colType = value.type;
         if (DB_LINK_COLUMN_TYPES.has(colType)) {
-            if (void 0 === value.target || "string" != typeof value.target || 0 === value.target.length) pushIssue(issues, `${path}.target`, "must be a non-empty string (target table python name)");
-            else if (!IDENTIFIER_RE.test(value.target)) pushIssue(issues, `${path}.target`, "must be a valid Python identifier");
-        } else if (!DB_BASIC_COLUMN_TYPES.has(colType)) pushIssue(issues, `${path}.type`, `must be a basic column type (${[
+            if (void 0 === value.target || "string" != typeof value.target || 0 === value.target.length) validators_pushIssue(issues, `${path}.target`, "must be a non-empty string (target table python name)");
+            else if (!validators_IDENTIFIER_RE.test(value.target)) validators_pushIssue(issues, `${path}.target`, "must be a valid Python identifier");
+        } else if (!DB_BASIC_COLUMN_TYPES.has(colType)) validators_pushIssue(issues, `${path}.type`, `must be a basic column type (${[
             ...DB_BASIC_COLUMN_TYPES
         ].join(", ")}) or ${[
             ...DB_LINK_COLUMN_TYPES
         ].join(", ")}`);
-        if (void 0 !== value.client_hidden && "boolean" != typeof value.client_hidden) pushIssue(issues, `${path}.client_hidden`, "must be a boolean");
-        if (void 0 !== value.admin_ui && null !== value.admin_ui) if (isPlainObject(value.admin_ui)) {
+        if (void 0 !== value.client_hidden && "boolean" != typeof value.client_hidden) validators_pushIssue(issues, `${path}.client_hidden`, "must be a boolean");
+        if (void 0 !== value.admin_ui && null !== value.admin_ui) if (validators_isPlainObject(value.admin_ui)) {
             const ui = value.admin_ui;
-            if (void 0 !== ui.width && "number" != typeof ui.width) pushIssue(issues, `${path}.admin_ui.width`, "must be a number");
-            if (void 0 !== ui.order && "number" != typeof ui.order) pushIssue(issues, `${path}.admin_ui.order`, "must be a number");
-        } else pushIssue(issues, `${path}.admin_ui`, "must be an object or null");
+            if (void 0 !== ui.width && "number" != typeof ui.width) validators_pushIssue(issues, `${path}.admin_ui.width`, "must be a number");
+            if (void 0 !== ui.order && "number" != typeof ui.order) validators_pushIssue(issues, `${path}.admin_ui.order`, "must be a number");
+        } else validators_pushIssue(issues, `${path}.admin_ui`, "must be an object or null");
         if (void 0 !== value.indexes) {
-            if (!Array.isArray(value.indexes)) return void pushIssue(issues, `${path}.indexes`, "must be an array");
+            if (!Array.isArray(value.indexes)) return void validators_pushIssue(issues, `${path}.indexes`, "must be an array");
             value.indexes.forEach((entry, i)=>{
                 const idxPath = `${path}.indexes[${i}]`;
-                if (!isPlainObject(entry)) return void pushIssue(issues, idxPath, "must be an object");
-                if (void 0 === entry.type) pushIssue(issues, `${idxPath}.type`, "is required");
-                else if ("string" != typeof entry.type || !DB_TABLE_INDEX_TYPES.has(entry.type)) pushIssue(issues, `${idxPath}.type`, 'must be "b_tree", "trigram", or "full_text"');
+                if (!validators_isPlainObject(entry)) return void validators_pushIssue(issues, idxPath, "must be an object");
+                if (void 0 === entry.type) validators_pushIssue(issues, `${idxPath}.type`, "is required");
+                else if ("string" != typeof entry.type || !DB_TABLE_INDEX_TYPES.has(entry.type)) validators_pushIssue(issues, `${idxPath}.type`, 'must be "b_tree", "trigram", or "full_text"');
             });
         }
     }
@@ -15668,8 +16721,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         if (void 0 === services) return issues;
         if (!Array.isArray(services)) return issues;
         services.forEach((service, index)=>{
-            if (!isPlainObject(service) || "string" != typeof service.source) return;
-            if (!KNOWN_RUNTIME_SERVICE_SOURCES.has(service.source)) pushIssue(issues, `${path}[${index}].source`, "must be a known runtime service source path");
+            if (!validators_isPlainObject(service) || "string" != typeof service.source) return;
+            if (!KNOWN_RUNTIME_SERVICE_SOURCES.has(service.source)) validators_pushIssue(issues, `${path}[${index}].source`, "must be a known runtime service source path");
         });
         return issues;
     }
@@ -15677,9 +16730,9 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         const issues = [];
         if (void 0 === services || !Array.isArray(services)) return issues;
         services.forEach((service, index)=>{
-            if (!isPlainObject(service) || "/runtime/services/anvil/users.yml" !== service.source) return;
-            if (!isPlainObject(service.client_config)) return;
-            if (true === service.client_config.allow_remember_me && void 0 === service.client_config.remember_me_days) pushIssue(issues, `${path}[${index}].client_config.remember_me_days`, "must be set if allow_remember_me is true");
+            if (!validators_isPlainObject(service) || "/runtime/services/anvil/users.yml" !== service.source) return;
+            if (!validators_isPlainObject(service.client_config)) return;
+            if (true === service.client_config.allow_remember_me && void 0 === service.client_config.remember_me_days) validators_pushIssue(issues, `${path}[${index}].client_config.remember_me_days`, "must be set if allow_remember_me is true");
         });
         return issues;
     }
@@ -15687,25 +16740,25 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         const issues = [];
         if (void 0 === value) return issues;
         if (!Array.isArray(value)) {
-            pushIssue(issues, path, "must be an array");
+            validators_pushIssue(issues, path, "must be an array");
             return issues;
         }
         value.forEach((task, index)=>{
             const taskPath = `${path}[${index}]`;
-            if (!isPlainObject(task)) return void pushIssue(issues, taskPath, "must be an object");
-            if ("string" != typeof task.job_id || 0 === task.job_id.length) pushIssue(issues, `${taskPath}.job_id`, "must be a non-empty string");
-            validateIdentifier(task.task_name, `${taskPath}.task_name`, issues);
-            if (!isPlainObject(task.time_spec)) return void pushIssue(issues, `${taskPath}.time_spec`, "must be an object");
+            if (!validators_isPlainObject(task)) return void validators_pushIssue(issues, taskPath, "must be an object");
+            if ("string" != typeof task.job_id || 0 === task.job_id.length) validators_pushIssue(issues, `${taskPath}.job_id`, "must be a non-empty string");
+            validators_validateIdentifier(task.task_name, `${taskPath}.task_name`, issues);
+            if (!validators_isPlainObject(task.time_spec)) return void validators_pushIssue(issues, `${taskPath}.time_spec`, "must be an object");
             const timeSpec = task.time_spec;
-            if ("string" != typeof timeSpec.every || !SCHEDULE_EVERY_VALUES.has(timeSpec.every)) pushIssue(issues, `${taskPath}.time_spec.every`, 'must be one of "minute", "hour", "day", "week", or "month"');
+            if ("string" != typeof timeSpec.every || !SCHEDULE_EVERY_VALUES.has(timeSpec.every)) validators_pushIssue(issues, `${taskPath}.time_spec.every`, 'must be one of "minute", "hour", "day", "week", or "month"');
             const interval = timeSpec.n;
-            if (void 0 !== interval && ("number" != typeof interval || !Number.isInteger(interval) || interval <= 0)) pushIssue(issues, `${taskPath}.time_spec.n`, "must be a positive integer");
-            if (void 0 !== timeSpec.at) if (isPlainObject(timeSpec.at)) {
+            if (void 0 !== interval && ("number" != typeof interval || !Number.isInteger(interval) || interval <= 0)) validators_pushIssue(issues, `${taskPath}.time_spec.n`, "must be a positive integer");
+            if (void 0 !== timeSpec.at) if (validators_isPlainObject(timeSpec.at)) {
                 const at = timeSpec.at;
-                if (void 0 !== at.minute && !Number.isInteger(at.minute)) pushIssue(issues, `${taskPath}.time_spec.at.minute`, "must be an integer");
-                if (void 0 !== at.hour && !Number.isInteger(at.hour)) pushIssue(issues, `${taskPath}.time_spec.at.hour`, "must be an integer");
-                if (void 0 !== at.day && !Number.isInteger(at.day)) pushIssue(issues, `${taskPath}.time_spec.at.day`, "must be an integer");
-            } else pushIssue(issues, `${taskPath}.time_spec.at`, "must be an object");
+                if (void 0 !== at.minute && !Number.isInteger(at.minute)) validators_pushIssue(issues, `${taskPath}.time_spec.at.minute`, "must be an integer");
+                if (void 0 !== at.hour && !Number.isInteger(at.hour)) validators_pushIssue(issues, `${taskPath}.time_spec.at.hour`, "must be an integer");
+                if (void 0 !== at.day && !Number.isInteger(at.day)) validators_pushIssue(issues, `${taskPath}.time_spec.at.day`, "must be an integer");
+            } else validators_pushIssue(issues, `${taskPath}.time_spec.at`, "must be an object");
         });
         return issues;
     }
@@ -15717,13 +16770,13 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         dependencies: external_valibot_namespaceObject.optional(external_valibot_namespaceObject.array(external_valibot_namespaceObject.any())),
         runtime_options: RuntimeOptionsSchema,
         services: external_valibot_namespaceObject.optional(external_valibot_namespaceObject.array(AnvilServiceEntrySchema)),
-        startup: external_valibot_namespaceObject.optional(external_valibot_namespaceObject.looseObject({
+        startup: external_valibot_namespaceObject.optional(external_valibot_namespaceObject.nullable(external_valibot_namespaceObject.looseObject({
             type: external_valibot_namespaceObject.picklist([
                 "module",
                 "form"
             ]),
             module: external_valibot_namespaceObject.optional(external_valibot_namespaceObject.string())
-        })),
+        }))),
         startup_form: external_valibot_namespaceObject.optional(external_valibot_namespaceObject.nullable(external_valibot_namespaceObject.string())),
         db_schema: external_valibot_namespaceObject.optional(external_valibot_namespaceObject.any()),
         scheduled_tasks: external_valibot_namespaceObject.optional(external_valibot_namespaceObject.any()),
@@ -15814,6 +16867,14 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             const startIndex = normalizedPath.lastIndexOf(clientCodePrefix);
             const relativeToClientCode = normalizedPath.slice(startIndex + clientCodePrefix.length);
             if (relativeToClientCode.endsWith(".yaml")) return "form_template.yaml";
+            if (relativeToClientCode.endsWith(".html")) return "form_template.html";
+            if (relativeToClientCode.endsWith(".py")) return "python";
+        }
+        const serverCodePrefix = "server_code/";
+        if (normalizedPath.startsWith(serverCodePrefix) || normalizedPath.includes(`/${serverCodePrefix}`)) {
+            const startIndex = normalizedPath.lastIndexOf(serverCodePrefix);
+            const relativeToServerCode = normalizedPath.slice(startIndex + serverCodePrefix.length);
+            if (relativeToServerCode.endsWith(".py")) return "python";
         }
         return null;
     }
@@ -15833,7 +16894,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             currentDir = parentDir;
         }
     }
-    function validatePath(filePath, yamlContent) {
+    function validatePath(filePath, fileContent) {
         const target = inferValidationTarget(filePath);
         const existingPath = resolveExistingPath(filePath);
         const appRoot = findAnvilAppRoot(filePath);
@@ -15860,7 +16921,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                     }
                 ]
             };
-            const result = validateAnvilYaml(yamlContent);
+            const result = validateAnvilYaml(fileContent);
             return result.ok ? {
                 ok: true,
                 target
@@ -15886,7 +16947,62 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                     ]
                 };
             }
-            const result = validateFormTemplate(yamlContent);
+            const result = validateFormTemplate(fileContent);
+            return result.ok ? {
+                ok: true,
+                target
+            } : {
+                ...result,
+                target
+            };
+        }
+        if ("form_template.html" === target) {
+            if (existingPath && appRoot) {
+                const clientCodeRoot = external_path_default().join(appRoot, "client_code");
+                const relativeToClientCode = external_path_default().relative(clientCodeRoot, existingPath);
+                const isInsideClientCode = relativeToClientCode.length > 0 && !relativeToClientCode.startsWith("..") && !external_path_default().isAbsolute(relativeToClientCode);
+                if (!isInsideClientCode || !existingPath.endsWith(".html")) return {
+                    ok: false,
+                    target,
+                    message: "File is not a client_code HTML form",
+                    issues: [
+                        {
+                            path: "",
+                            message: `expected a .html file under ${clientCodeRoot}`
+                        }
+                    ]
+                };
+            }
+            const result = validateFormTemplateHtml(fileContent);
+            return result.ok ? {
+                ok: true,
+                target
+            } : {
+                ...result,
+                target
+            };
+        }
+        if ("python" === target) {
+            if (existingPath && appRoot) {
+                const clientCodeRoot = external_path_default().join(appRoot, "client_code");
+                const serverCodeRoot = external_path_default().join(appRoot, "server_code");
+                const relativeToClientCode = external_path_default().relative(clientCodeRoot, existingPath);
+                const relativeToServerCode = external_path_default().relative(serverCodeRoot, existingPath);
+                const isInsideClientCode = relativeToClientCode.length > 0 && !relativeToClientCode.startsWith("..") && !external_path_default().isAbsolute(relativeToClientCode);
+                const isInsideServerCode = relativeToServerCode.length > 0 && !relativeToServerCode.startsWith("..") && !external_path_default().isAbsolute(relativeToServerCode);
+                if (!isInsideClientCode && !isInsideServerCode || !existingPath.endsWith(".py")) return {
+                    ok: false,
+                    target,
+                    message: "File is not an Anvil app Python file",
+                    issues: [
+                        {
+                            path: "",
+                            message: `expected a .py file under ${clientCodeRoot} or ${serverCodeRoot}`
+                        }
+                    ]
+                };
+            }
+            const result = validatePython(filePath, fileContent, appRoot);
             return result.ok ? {
                 ok: true,
                 target
@@ -15902,7 +17018,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             issues: [
                 {
                     path: "",
-                    message: "supported paths are anvil.yaml, client_code/**/form_template.yaml, and client_code/**/*.yaml"
+                    message: "supported paths are anvil.yaml, client_code/**/form_template.yaml, client_code/**/*.yaml, client_code/**/*.html, client_code/**/*.py, and server_code/**/*.py"
                 }
             ]
         };
@@ -15941,9 +17057,13 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         };
         return null;
     }
+    function formatValidationFailure(fileName, validationResult) {
+        const issueSummary = validationResult.issues.map((issue)=>`  - ${formatValidationPath(issue.path)}: ${issue.message}`).join("\n");
+        return issueSummary ? `${fileName} validation failed: ${validationResult.message}\n${issueSummary}` : `${fileName} validation failed: ${validationResult.message}`;
+    }
     async function loadFormTemplateData(relativePath, templateInfo, context) {
         const { repoPath, stagedOnly = false } = context;
-        const { kind, format } = templateInfo;
+        const { format } = templateInfo;
         try {
             const content = await readFileContent(repoPath, relativePath, stagedOnly);
             if ("yaml" === format) {
@@ -15956,26 +17076,12 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                         reason: issueSummary ? `${validationResult.message}. ${issueSummary}` : validationResult.message
                     };
                 }
-                const parsed = external_js_yaml_default().load(content);
-                const template = {
-                    ...parsed,
-                    is_package: "package" === kind
-                };
-                return {
-                    ok: true,
-                    data: {
-                        template
-                    }
-                };
             }
-            const { frontmatter, html } = parseHtmlWithFrontmatter(content);
-            const template = frontmatter ?? {};
             return {
                 ok: true,
-                data: {
-                    template,
-                    html
-                }
+                source: (0, form_template_parser_namespaceObject.parseFormTemplateSource)(content, {
+                    format
+                })
             };
         } catch (error) {
             return {
@@ -16682,20 +17788,6 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             ]
         });
     }
-    function buildFormDataFromTemplate(template, html, options) {
-        const { class_name: _templateClassName, code: _templateCode, is_package: _templateIsPackage, ...templateRest } = template && "object" == typeof template ? template : {};
-        const formData = {
-            ...templateRest,
-            class_name: options.className,
-            code: options.code,
-            is_package: options.isPackage
-        };
-        if (void 0 !== html) {
-            formData.save_as_html = true;
-            formData.serialized_html = html;
-        }
-        return formData;
-    }
     async function buildFormTemplateData(relativePath, templateInfo, context) {
         const { repoPath, stagedOnly = false } = context;
         const { kind } = templateInfo;
@@ -16719,10 +17811,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 reason: "package" === kind ? "Form __init__.py file not found - cannot save template without code" : "Form .py file not found - cannot save template without code"
             }
         };
-        const templateData = loadResult.data.template ?? {};
-        const html = loadResult.data.html;
-        const templateObject = templateData && "object" == typeof templateData && !Array.isArray(templateData) ? templateData : {};
-        const formData = buildFormDataFromTemplate(templateObject, html, {
+        const formData = (0, form_template_parser_namespaceObject.buildFormTemplateSavePayload)(loadResult.source, {
             className,
             code: codeContent,
             isPackage: "package" === kind
@@ -16907,7 +17996,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             }
         };
         const validationResult = validateAnvilYaml(yamlContent);
-        if (!validationResult.ok) throw new Error("anvil.yaml validation failed - see errors above");
+        if (!validationResult.ok) throw new Error(formatValidationFailure("anvil.yaml", validationResult));
         const changes = [];
         for (const [key, value] of Object.entries(parsedYaml))if (!previousYaml || !deepEqual(previousYaml[key], value)) changes.push({
             key,
@@ -17014,6 +18103,12 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         }
     }
     function authDiagnostic(error) {
+        if ("token_refresh_failed" === error.type && error.message?.includes("invalid_grant")) return {
+            code: error.type,
+            recoverability: "requires_user_action",
+            requiresUserAction: true,
+            suggestedAction: "Your Anvil session auth has expired or was invalidated. Run anvil login or restart the agent/watch session, then retry."
+        };
         return {
             code: error.type,
             recoverability: "requires_user_action",
@@ -17076,6 +18171,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
     class SaveProcessor extends Emitter {
         hasPendingChanges = false;
         debounceTimer = null;
+        saveLoopPromise = null;
         saveSequence = 0;
         SAVE_DEBOUNCE_MS = 1000;
         MAX_RETRIES = 3;
@@ -17099,6 +18195,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             if (this.debounceTimer) clearTimeout(this.debounceTimer);
             if (isFirstChange) logger_logger.progress("sync", "Change detected");
             this.debounceTimer = setTimeout(()=>{
+                this.debounceTimer = null;
                 this.processSaveBatchWithEvents().catch((error)=>{
                     logger_logger.error(`Save failed: ${errors_getErrorMessage(error)}`);
                 });
@@ -17123,6 +18220,18 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             }
         }
         async processSaveBatchWithEvents() {
+            if (this.saveLoopPromise) return this.saveLoopPromise;
+            this.saveLoopPromise = this.drainSaveQueue();
+            try {
+                await this.saveLoopPromise;
+            } finally{
+                this.saveLoopPromise = null;
+            }
+        }
+        async drainSaveQueue() {
+            while(this.hasPendingChanges && !this.config.isCleanedUp() && !this.config.isPaused())await this.processOneSaveBatchWithEvents();
+        }
+        async processOneSaveBatchWithEvents() {
             if (this.config.isCleanedUp()) return;
             logger_logger.progressUpdate("sync", "Processing");
             if (!this.hasPendingChanges) return void logger_logger.progressEnd("sync");
@@ -17140,6 +18249,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                     newCommitId: this.config.getCommitId(),
                     fileCount
                 });
+                if (result.anvilYamlDependenciesChanged) this.emit("anvil-yaml-dependencies-changed", void 0);
                 this.emit("save-complete", {
                     newCommitId: this.config.getCommitId(),
                     fileCount
@@ -17230,13 +18340,14 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         }
         async getStagedChanges() {
             try {
-                return await getStagedFileChanges(this.config.gitService.getGit());
+                return await getStagedFileChanges(this.config.gitService.getGit(), this.config.gitService);
             } catch (e) {
                 logger_logger.error(external_chalk_default().red(`Error getting staged changes: ${errors_getErrorMessage(e)}`));
                 return [];
             }
         }
         async getUnstagedChanges(status) {
+            const modeOnlyChanges = new Set(await this.config.gitService.discardModeOnlyChanges(status.modified));
             const renames = status.renamed;
             const stagedRenamedFromPaths = new Set(renames.map((r)=>r.from));
             const stagedRenamedToPaths = new Set(renames.map((r)=>r.to));
@@ -17256,7 +18367,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             const allRenamedFromPaths = new Set(allRenames.map((r)=>r.from));
             const allRenamedToPaths = new Set(allRenames.map((r)=>r.to));
             return [
-                ...status.modified.map((f)=>({
+                ...status.modified.filter((f)=>!modeOnlyChanges.has(f)).map((f)=>({
                         path: f,
                         type: "change"
                     })),
@@ -17327,11 +18438,15 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         async processBatchedChanges(changes) {
             const saveArray = [];
             const originalFilePaths = [];
+            let anvilYamlDependenciesChanged = false;
             const deduplicatedChanges = deduplicateFormChanges(changes);
             for (const change of deduplicatedChanges){
                 if ("anvil.yaml" === change.path) {
                     const previousAnvilYaml = await this.getHeadAnvilYaml();
                     const anvilChanges = await getAnvilYamlChanges(this.config.repoPath, previousAnvilYaml);
+                    const previousDependencies = normalizeAnvilYamlDependenciesValue(previousAnvilYaml?.dependencies);
+                    const currentDependencies = await readAnvilYamlDependencies(this.config.repoPath);
+                    if (!anvilYamlDependenciesEqual(previousDependencies, currentDependencies)) anvilYamlDependenciesChanged = true;
                     if (0 === anvilChanges.length) {
                         logger_logger.verbose(external_chalk_default().gray("  Ignoring anvil.yaml: No changes detected"));
                         continue;
@@ -17383,7 +18498,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             }
             await this.sendSavesToAnvil(saveArray, originalFilePaths);
             return {
-                skipped: false
+                skipped: false,
+                anvilYamlDependenciesChanged
             };
         }
         logSaveResult(change, savePath, content) {
@@ -17459,7 +18575,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 await this.handleConflict(json_resp, originalFilePaths, retryCount);
                 return;
             }
-            if (200 === resp.status) return void await this.handleSuccess(json_resp);
+            if (200 === resp.status) return void await this.handleSuccess(json_resp, originalFilePaths);
             logger_logger.error(`Unexpected response status: ${resp.status}`);
             throw {
                 type: "server_error",
@@ -17562,13 +18678,20 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 reason: "Unknown conflict"
             };
         }
-        async handleSuccess(json_resp) {
+        async handleSuccess(json_resp, originalFilePaths) {
             const version = json_resp.version;
-            this.config.setCommitId(version);
+            const oldCommitId = json_resp.previous_commit ?? null;
+            const commitIdBeforePostSaveSync = this.config.getCommitId();
+            this.emit("saved", {
+                oldCommitId,
+                newCommitId: version,
+                branch: this.config.getCurrentBranch()
+            });
             if (this.postSaveCallback) {
                 logger_logger.progressUpdate("sync", "Syncing back");
-                await this.postSaveCallback();
+                await this.postSaveCallback(new Set(originalFilePaths));
             }
+            if (this.config.getCommitId() === commitIdBeforePostSaveSync) this.config.setCommitId(version);
         }
         async rerouteChanges(changes) {
             logger_logger.verbose(external_chalk_default().blue(`Re-routing ${changes.length} local change(s)...`));
@@ -17622,76 +18745,114 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
     }
     class SyncManager extends Emitter {
         config;
-        syncInProgress = false;
+        syncQueue = Promise.resolve();
         constructor(config){
             super();
             this.config = config;
         }
         async syncRemoteChanges(knownLocalChanges) {
-            if (this.syncInProgress) {
-                logger_logger.debug("Sync already in progress, skipping");
+            const runSync = ()=>this.performSyncRemoteChanges(knownLocalChanges);
+            const queuedSync = this.syncQueue.then(runSync, runSync);
+            this.syncQueue = queuedSync.catch(()=>{});
+            return queuedSync;
+        }
+        async performSyncRemoteChanges(knownLocalChanges) {
+            const oldCommitId = this.config.getCommitId();
+            let locallyChangedFiles;
+            let initialStatus;
+            if (knownLocalChanges) locallyChangedFiles = knownLocalChanges;
+            else {
+                initialStatus = await this.config.gitService.getStatus();
+                locallyChangedFiles = buildLocalChangesSet(initialStatus);
+            }
+            let syncMode;
+            if (!knownLocalChanges && initialStatus && this.isCleanForFastForward(initialStatus)) syncMode = await this.fetchAndMoveCleanTreeToAnvilHead(oldCommitId, locallyChangedFiles);
+            else {
+                await this.fetchAndResetFromAnvil(locallyChangedFiles);
+                syncMode = "preservation";
+            }
+            if ("clean-move" === syncMode) return {
+                localOnlyChanges: [],
+                conflicts: []
+            };
+            const newCommitId = await this.config.gitService.getCommitId();
+            this.config.setCommitId(newCommitId);
+            const remoteChangedFiles = await detectRemoteChanges(this.config.gitService, oldCommitId, newCommitId);
+            const statusAfter = await this.config.gitService.getStatus();
+            const newChanges = extractChangesFromStatus(statusAfter);
+            if (0 === newChanges.length) {
+                logger_logger.verbose(external_chalk_default().gray("   No local changes - working directory is clean"));
                 return {
                     localOnlyChanges: [],
                     conflicts: []
                 };
             }
-            this.syncInProgress = true;
-            try {
-                const oldCommitId = this.config.getCommitId();
-                let locallyChangedFiles;
-                if (knownLocalChanges) locallyChangedFiles = knownLocalChanges;
+            const result = categorizeChanges(newChanges, locallyChangedFiles, remoteChangedFiles);
+            await acceptRemoteChanges(this.config.gitService, result.remoteOnlyChanges);
+            logConflictResolution(result);
+            return {
+                localOnlyChanges: result.localOnlyChanges,
+                conflicts: result.conflicts
+            };
+        }
+        async fetchAndResetFromAnvil(localChangesToPreserve = new Set()) {
+            const oldCommitId = this.config.getCommitId();
+            await this.withFetchedAnvilRef((tempRef)=>this.resetToFetchedAnvilRef(tempRef, oldCommitId, localChangesToPreserve));
+        }
+        async fetchAndMoveCleanTreeToAnvilHead(oldCommitId, locallyChangedFiles) {
+            return this.withFetchedAnvilRef(async (tempRef)=>{
+                const localHead = await this.config.gitService.getCommitId();
+                if (await this.config.gitService.isAncestor(localHead, tempRef)) await this.config.gitService.mergeFastForward(tempRef);
                 else {
-                    const status = await this.config.gitService.getStatus();
-                    locallyChangedFiles = buildLocalChangesSet(status);
+                    const statusBeforeHardReset = await this.config.gitService.getStatus();
+                    if (!this.isCleanForFastForward(statusBeforeHardReset)) {
+                        for (const filePath of buildLocalChangesSet(statusBeforeHardReset))locallyChangedFiles.add(filePath);
+                        await this.resetToFetchedAnvilRef(tempRef, oldCommitId, locallyChangedFiles);
+                        return "preservation";
+                    }
+                    await this.config.gitService.reset(tempRef, "hard");
                 }
-                await this.fetchAndResetFromAnvil();
                 const newCommitId = await this.config.gitService.getCommitId();
                 this.config.setCommitId(newCommitId);
-                const remoteChangedFiles = await detectRemoteChanges(this.config.gitService, oldCommitId, newCommitId);
-                const statusAfter = await this.config.gitService.getStatus();
-                const newChanges = extractChangesFromStatus(statusAfter);
-                if (0 === newChanges.length) {
-                    logger_logger.verbose(external_chalk_default().gray("   No local changes - working directory is clean"));
-                    return {
-                        localOnlyChanges: [],
-                        conflicts: []
-                    };
-                }
-                const result = categorizeChanges(newChanges, locallyChangedFiles, remoteChangedFiles);
-                await acceptRemoteChanges(this.config.gitService, result.remoteOnlyChanges);
-                logConflictResolution(result);
-                return {
-                    localOnlyChanges: result.localOnlyChanges,
-                    conflicts: result.conflicts
-                };
-            } finally{
-                this.syncInProgress = false;
-            }
+                await this.config.editorYaml.reload();
+                return "clean-move";
+            });
         }
-        async fetchAndResetFromAnvil() {
+        async withFetchedAnvilRef(callback) {
             const validToken = await auth_getValidAuthToken(this.config.anvilUrl, this.config.username);
             this.config.setAuthToken(validToken);
             const httpUrl = getGitFetchUrl(this.config.appId, this.config.getAuthToken(), this.config.anvilUrl);
             const currentBranch = this.config.getCurrentBranch();
             const tempRef = `anvil-sync-temp-${Date.now()}`;
-            const oldCommitId = this.config.getCommitId();
-            await this.config.gitService.fetch(httpUrl, `+${currentBranch}:${tempRef}`);
+            try {
+                await this.config.gitService.fetch(httpUrl, `+${currentBranch}:${tempRef}`);
+                return await callback(tempRef);
+            } finally{
+                await this.config.gitService.deleteRef(`refs/heads/${tempRef}`);
+            }
+        }
+        async resetToFetchedAnvilRef(tempRef, oldCommitId, localChangesToPreserve) {
             await this.config.gitService.reset(tempRef, "mixed");
-            await this.config.gitService.deleteRef(`refs/heads/${tempRef}`);
             const newCommitId = await this.config.gitService.getCommitId();
             await this.config.gitService.checkout([
                 ".anvil_editor.yaml",
                 "anvil.yaml"
             ]);
             await this.config.editorYaml.reload();
-            await this.deleteFilesRemovedOnAnvilLocally(oldCommitId, newCommitId);
+            await this.deleteFilesRemovedOnAnvilLocally(oldCommitId, newCommitId, localChangesToPreserve);
             await this.discardFormattingOnlyYamlChanges();
         }
-        async deleteFilesRemovedOnAnvilLocally(oldCommitId, newCommitId) {
+        isCleanForFastForward(status) {
+            return status.isClean && 0 === status.modified.length && 0 === status.notAdded.length && 0 === status.created.length && 0 === status.deleted.length && 0 === status.staged.length && 0 === status.renamed.length;
+        }
+        async deleteFilesRemovedOnAnvilLocally(oldCommitId, newCommitId, localChangesToPreserve) {
             try {
                 const status = await this.config.gitService.getStatus();
                 const remotelyChangedFiles = await detectRemoteChanges(this.config.gitService, oldCommitId, newCommitId);
-                await deleteFilesRemovedOnAnvil(this.config.gitService, status.notAdded, remotelyChangedFiles);
+                await deleteFilesRemovedOnAnvil(this.config.gitService, status.notAdded, remotelyChangedFiles, {
+                    oldCommitId,
+                    localChangesToPreserve
+                });
             } catch (e) {
                 logger_logger.verbose(external_chalk_default().gray(`  Failed to check git status: ${errors_getErrorMessage(e)}`));
             }
@@ -17804,6 +18965,10 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         environment;
         envBranchChangeMode;
         isSwitchingForEnvironment = false;
+        environmentSwitchTargetBranch = null;
+        dependencyWatchEnabled;
+        isRefreshingDependencies = false;
+        hasPendingDependencyRefresh = false;
         pendingEnvironmentBranchSwitch = null;
         BRANCH_CHANGE_SETTLE_MS = 2000;
         LOCAL_CHANGE_POLL_MS = 2000;
@@ -17821,6 +18986,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             this.stagedOnly = options.stagedOnly ?? false;
             this.environment = options.environment;
             this.envBranchChangeMode = options.envBranchChangeMode ?? "manual";
+            this.dependencyWatchEnabled = options.dependencyWatch ?? true;
             this.editSession = "anvil-sync-" + Math.random().toString(36).substring(2, 15);
             this.gitService = new GitService(this.repoPath);
             this.editorYaml = new EditorYamlManager(this.repoPath);
@@ -17840,6 +19006,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         async initialize() {
             await this.editorYaml.load();
             this.initializeProcessors();
+            if (this.dependencyWatchEnabled) await this.refreshDependencies("startup");
             try {
                 await this.connectWebSocket();
             } catch (error) {
@@ -17859,7 +19026,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 getAuthToken: ()=>this.authToken,
                 setAuthToken: (token)=>{
                     this.authToken = token;
-                    this.wsClient?.updateAuthToken(token);
+                    this.wsClient?.updateAuthToken?.(token);
                 },
                 getCurrentBranch: ()=>this.currentBranch,
                 getCommitId: ()=>this.commitId,
@@ -17879,7 +19046,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 getAuthToken: ()=>this.authToken,
                 setAuthToken: (token)=>{
                     this.authToken = token;
-                    this.wsClient?.updateAuthToken(token);
+                    this.wsClient?.updateAuthToken?.(token);
                 },
                 getCurrentBranch: ()=>this.currentBranch,
                 getCommitId: ()=>this.commitId,
@@ -17892,15 +19059,25 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 isPaused: ()=>this.isPausedForUserInput
             });
             this.saveProcessor.setSyncCallback((filePaths)=>this.syncManager.syncRemoteChanges(filePaths));
-            this.saveProcessor.setPostSaveCallback(()=>this.syncManager.fetchAndResetFromAnvil());
+            this.saveProcessor.setPostSaveCallback((filePaths)=>this.syncAfterSave(filePaths));
             this.saveProcessor.on("save-started", (data)=>this.emit("save-started", data));
             this.saveProcessor.on("save-succeeded", (data)=>this.emit("save-succeeded", data));
             this.saveProcessor.on("save-failed", (data)=>this.emit("save-failed", data));
             this.saveProcessor.on("save-complete", (data)=>this.emit("save-complete", data));
+            this.saveProcessor.on("saved", (data)=>this.emit("saved", data));
+            this.saveProcessor.on("anvil-yaml-dependencies-changed", ()=>{
+                this.queueDependencyRefresh("anvil.yaml dependencies changed");
+            });
             this.saveProcessor.on("validation-failed", (data)=>this.emit("validation-failed", data));
             this.saveProcessor.on("sync-conflict", (data)=>this.emit("sync-conflict", data));
             this.saveProcessor.on("max-retries-exceeded", (data)=>this.emit("max-retries-exceeded", data));
         }
+        async syncAfterSave(savedFilePaths) {
+            const status = await this.gitService.getStatus();
+            const locallyChangedFiles = buildLocalChangesSet(status);
+            if (!this.stagedOnly) for (const filePath of savedFilePaths)locallyChangedFiles.add(filePath);
+            return this.syncManager.syncRemoteChanges(locallyChangedFiles);
+        }
         async connectWebSocket() {
             this.wsClient = new WebSocketClient({
                 appId: this.appId,
@@ -17909,7 +19086,9 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 currentBranch: this.currentBranch,
                 editSession: this.editSession,
                 username: this.username,
-                environment: this.environment
+                environment: this.environment,
+                dependencyWatch: this.dependencyWatchEnabled,
+                dependencySubscriptions: this.dependencyWatchEnabled ? await this.getDependencyWatchSubscriptions() : []
             });
             this.wsClient.on("env-state", ({ envs })=>{
                 for (const env of envs)this.handleEnvironmentBinding(env, "snapshot");
@@ -17917,7 +19096,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             this.wsClient.on("env-update", (env)=>{
                 this.handleEnvironmentBinding(env, "update");
             });
-            this.wsClient.on("repo-update", async ({ ref, commitHash, saveSeq })=>{
+            this.wsClient.on("repo-update", async ({ appId, ref, commitHash, saveSeq })=>{
+                if (appId !== this.appId) return void await this.handleDependencyRepoUpdate(appId, ref, commitHash);
                 if (saveSeq?.session === this.editSession) return void logger_logger.debug("Ignoring update from our own session");
                 const branchName = ref.replace(/^refs\/heads\//, "");
                 if (branchName !== this.currentBranch) return void logger_logger.debug(`Ignoring update to different branch: ${branchName} (current: ${this.currentBranch})`);
@@ -17939,6 +19119,55 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             });
             await this.wsClient.connect();
         }
+        async handleDependencyRepoUpdate(appId, ref, commitHash) {
+            if (!this.dependencyWatchEnabled) return;
+            const branchName = ref.replace(/^refs\/heads\//, "");
+            const subscription = this.wsClient?.getDependencySubscriptions().find((candidate)=>candidate.appId === appId && candidate.branch === branchName);
+            if (!subscription) return void logger_logger.debug(`Ignoring update for unwatched dependency app ${appId} on ${branchName}`);
+            logger_logger.verbose(external_chalk_default().cyan("Dependency update detected: ") + external_chalk_default().bold(subscription.packageName ?? appId) + external_chalk_default().gray(` (${branchName}, ${commitHash.substring(0, 8)})`));
+            await this.queueDependencyRefresh(`dependency ${appId} updated`);
+        }
+        async queueDependencyRefresh(reason) {
+            if (!this.dependencyWatchEnabled || this.isCleanedUp) return;
+            if (this.isRefreshingDependencies) {
+                this.hasPendingDependencyRefresh = true;
+                return;
+            }
+            this.isRefreshingDependencies = true;
+            try {
+                do {
+                    this.hasPendingDependencyRefresh = false;
+                    await this.refreshDependencies(reason);
+                }while (this.hasPendingDependencyRefresh && !this.isCleanedUp);
+            } finally{
+                this.isRefreshingDependencies = false;
+            }
+        }
+        async refreshDependencies(reason) {
+            if (!this.dependencyWatchEnabled || this.isCleanedUp) return;
+            logger_logger.progress("dependency-refresh", "startup" === reason ? "Fetching dependencies" : "Refreshing dependencies");
+            try {
+                const previousSubscriptions = this.wsClient?.getDependencySubscriptions() ?? [];
+                const { response, addedGitignoreEntry } = await refreshDependencyCache(this.repoPath, this.appId, this.anvilUrl, {
+                    includeDocs: true
+                });
+                if (addedGitignoreEntry) logger_logger.info("Added /.anvil/ to .gitignore");
+                const nextSubscriptions = await this.getDependencyWatchSubscriptions();
+                this.reconcileDependencySubscriptions(previousSubscriptions, nextSubscriptions);
+                logger_logger.progressEnd("dependency-refresh", response.dependencies.length ? `Fetched ${response.dependencies.length} dependencies` : "Dependencies already up to date");
+            } catch (error) {
+                logger_logger.progressEnd("dependency-refresh", "Failed");
+                logger_logger.warn(external_chalk_default().yellow(`Failed to refresh dependencies: ${errors_getErrorMessage(error)}`));
+            }
+        }
+        async getDependencyWatchSubscriptions() {
+            return getDependencyWatchSubscriptionsFromManifest(await readDepsCacheManifest(this.repoPath));
+        }
+        reconcileDependencySubscriptions(previousSubscriptions, nextSubscriptions) {
+            if (dependencySubscriptionsEqual(previousSubscriptions, nextSubscriptions)) return;
+            this.wsClient?.updateDependencySubscriptions(nextSubscriptions);
+            if (this.wsClient?.isConnected() && previousSubscriptions.length > 0) this.wsClient.reconnect();
+        }
         async handleEnvironmentBinding(env, source) {
             if (!this.environment?.envPid || env.envPid !== this.environment.envPid) return;
             this.environment = {
@@ -17961,6 +19190,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         async switchToEnvironmentBranch(targetBranch, source) {
             if (this.isCleanedUp) return;
             this.isSwitchingForEnvironment = true;
+            this.environmentSwitchTargetBranch = targetBranch;
             const oldPausedState = this.isPausedForUserInput;
             try {
                 const status = await this.gitService.getStatus();
@@ -17985,6 +19215,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                     ]);
                 }
                 logger_logger.verbose(external_chalk_default().cyan(`Environment branch ${"snapshot" === source ? "snapshot" : "update"}: `) + external_chalk_default().bold(`${this.currentBranch} -> ${targetBranch}`));
+                this.authToken = await auth_getValidAuthToken(this.anvilUrl, this.username);
+                this.wsClient?.updateAuthToken?.(this.authToken);
                 const fetchUrl = getGitFetchUrl(this.appId, this.authToken, this.anvilUrl);
                 const envRemoteRef = environmentRemoteRefForBranch(targetBranch);
                 await this.gitService.fetch(fetchUrl, environmentFetchRefSpecForBranch(targetBranch));
@@ -18000,6 +19232,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 this.lastBranchChangeTime = Date.now();
                 this.fileWatcher?.setCurrentBranch(targetBranch);
                 this.wsClient?.updateBranch(targetBranch);
+                this.queueDependencyRefresh("branch changed");
                 await this.initializeLocalChangeFingerprint();
                 this.emit("branch-changed", {
                     oldBranch,
@@ -18019,6 +19252,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             } finally{
                 this.isPausedForUserInput = oldPausedState;
                 this.isSwitchingForEnvironment = false;
+                this.environmentSwitchTargetBranch = null;
             }
             const pendingSwitch = this.pendingEnvironmentBranchSwitch;
             this.pendingEnvironmentBranchSwitch = null;
@@ -18070,7 +19304,13 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             });
         }
         async syncRemoteChanges(knownLocalChanges) {
-            return this.syncManager.syncRemoteChanges(knownLocalChanges);
+            const previousDependencies = this.dependencyWatchEnabled ? await readAnvilYamlDependencies(this.repoPath) : void 0;
+            const result = await this.syncManager.syncRemoteChanges(knownLocalChanges);
+            if (this.dependencyWatchEnabled && void 0 !== previousDependencies) {
+                const currentDependencies = await readAnvilYamlDependencies(this.repoPath);
+                if (!anvilYamlDependenciesEqual(previousDependencies, currentDependencies)) await this.queueDependencyRefresh("anvil.yaml dependencies changed");
+            }
+            return result;
         }
         cleanup() {
             this.isCleanedUp = true;
@@ -18100,15 +19340,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 getCurrentBranch: async ()=>this.gitService.getCurrentBranch()
             });
             this.fileWatcher.on("branch-change", ({ newBranch })=>{
-                const oldBranch = this.currentBranch;
-                logger_logger.verbose(external_chalk_default().gray("   Pausing sync for 2 seconds to allow branch to settle..."));
-                this.currentBranch = newBranch;
-                this.lastBranchChangeTime = Date.now();
-                this.wsClient?.updateBranch(newBranch);
-                this.emit("branch-changed", {
-                    oldBranch,
-                    newBranch
-                });
+                this.handleFileWatcherBranchChange(newBranch);
             });
             this.fileWatcher.on("index-change", ()=>{
                 this.saveProcessor?.queueSave();
@@ -18125,6 +19357,23 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             this.startLocalChangeFallbackPolling();
             await new Promise(()=>{});
         }
+        handleFileWatcherBranchChange(newBranch) {
+            if (this.isSwitchingForEnvironment && newBranch === this.environmentSwitchTargetBranch) return void logger_logger.debug(`Ignoring FileWatcher branch-change during environment switch: ${newBranch}`);
+            const oldBranch = this.currentBranch;
+            logger_logger.verbose(external_chalk_default().gray("   Pausing sync for 2 seconds to allow branch to settle..."));
+            this.currentBranch = newBranch;
+            this.lastBranchChangeTime = Date.now();
+            this.wsClient?.updateBranch(newBranch);
+            this.queueDependencyRefresh("branch changed");
+            this.emit("external-branch-changed", {
+                oldBranch,
+                newBranch
+            });
+            this.emit("branch-changed", {
+                oldBranch,
+                newBranch
+            });
+        }
         startWatchingInBackground(onError) {
             this.startWatching().catch((error)=>{
                 this.cleanup();
@@ -18250,6 +19499,12 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             return false;
         }
     }
+    function dependencySubscriptionsEqual(left, right) {
+        return subscriptionKeys(left).join("\n") === subscriptionKeys(right).join("\n");
+    }
+    function subscriptionKeys(subscriptions) {
+        return subscriptions.map((subscription)=>`${subscription.appId}\0${subscription.branch}`).sort();
+    }
     async function validateAnvilApp(repoPath) {
         const anvilYamlPath = external_path_default().join(repoPath, "anvil.yaml");
         if (!external_fs_.existsSync(anvilYamlPath)) throw createValidationError.missingYaml(repoPath);
@@ -19628,38 +20883,419 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             await checkout_openPathInEditorOrDefault(result.destinationPath, preferredEditorCommand);
             logger_logger.info(external_chalk_default().gray(`Opened ${result.destinationDisplay}`));
         }
-        if (preferredEditorCommand && !options.open) if (isCommandAvailable(preferredEditorCommand)) logger_logger.info(external_chalk_default().cyan(`Next: ${preferredEditorCommand} ${result.destinationDisplay}`));
-        else logger_logger.warn(`Preferred editor command '${preferredEditorCommand}' was not found in PATH. Run 'anvil configure' to choose an installed editor.`);
+        if (preferredEditorCommand && !options.open) if (isCommandAvailable(preferredEditorCommand)) logger_logger.info(external_chalk_default().cyan(`Next: ${preferredEditorCommand} ${result.destinationDisplay}`));
+        else logger_logger.warn(`Preferred editor command '${preferredEditorCommand}' was not found in PATH. Run 'anvil configure' to choose an installed editor.`);
+    }
+    async function checkout_openPathInEditorOrDefault(destinationPath, preferredEditorCommand, deps) {
+        await openPathInEditorOrDefault(destinationPath, preferredEditorCommand, deps);
+    }
+    function registerCheckoutCommand(program) {
+        const checkoutCommand = program.command("checkout [input] [directory]").description("Check out an Anvil app locally from editor URL, git URL, app ID, or interactive selection").alias("co").option("-O, --open", "Open destination after checkout").option("-b, --branch <BRANCH>", "Checkout a specific branch").option("--depth <N>", "Create a shallow clone with history truncated to N commits", (value)=>parseInt(value, 10)).option("--single-branch", "Clone only one branch").option("--origin <NAME>", "Use a custom remote name instead of origin").option("--quiet", "Suppress git clone progress output").option("--verbose", "Enable verbose git clone output").option("-u, --url <ANVIL_URL>", "Specify Anvil server URL").option("-U, --user <USERNAME>", "Specify which user account to use").option("-f, --force", "Override safety checks for destination path").option("-Q, --query <QUERY>", "Initial search query for interactive checkout picker").action(async (input, directory, options, command)=>{
+            try {
+                const globalOptions = command?.optsWithGlobals() || options || {};
+                if ("number" == typeof options?.depth && (!Number.isFinite(options.depth) || options.depth <= 0)) throw new Error("--depth must be a positive integer");
+                await executeCheckoutInteractive({
+                    input,
+                    directory,
+                    open: options?.open,
+                    branch: options?.branch,
+                    depth: options?.depth,
+                    singleBranch: options?.singleBranch,
+                    origin: options?.origin,
+                    quiet: options?.quiet,
+                    verbose: globalOptions.verbose,
+                    url: options?.url,
+                    user: options?.user,
+                    force: options?.force,
+                    query: options?.query
+                }, defaultCheckoutDeps);
+            } catch (e) {
+                logger_logger.error("Error: " + errors_getErrorMessage(e));
+                process.exit(1);
+            }
+        });
+        checkoutCommand.addHelpText("after", "\n" + external_chalk_default().bold("Examples:") + '\n  anvil checkout http://localhost:3000/build/apps/APPID/code/assets/theme.css\n  anvil checkout https://anvil.works/git/APPID.git\n  anvil checkout APPID --url anvil.works\n  anvil checkout APPID --branch master --depth 1 --single-branch\n  anvil checkout APPID -O  # open editor/file browser after checkout\n  anvil checkout APPID my-local-folder --force\n  anvil checkout  # interactive search/select app list\n  anvil checkout -Q "dashboard"  # preseed picker search\n');
+    }
+    const defaultGitAuthDoctorDeps = {
+        getAppAuthBinding: getAppAuthBinding,
+        getAccountsForUrl: auth_getAccountsForUrl,
+        hasTokensForUrl: hasTokensForUrl,
+        runCredentialFill: runGitCredentialFill
+    };
+    function getHighestStatus(statuses) {
+        if (statuses.includes("error")) return "error";
+        if (statuses.includes("warning")) return "warning";
+        return "ok";
+    }
+    function finding(status, code, message) {
+        return {
+            status,
+            code,
+            message
+        };
+    }
+    function redactSecrets(value) {
+        return value.replace(/^password=.*$/gim, "password=<redacted>").replace(/(https?:\/\/git:)[^@\s]+@/g, "$1<redacted>@").replace(/(access[_-]?token=)[^&\s]+/gi, "$1<redacted>").replace(/(refresh[_-]?token=)[^&\s]+/gi, "$1<redacted>");
+    }
+    function splitShellCommand(command) {
+        const tokens = [];
+        let current = "";
+        let state = "normal";
+        for(let i = 0; i < command.length; i++){
+            const ch = command[i];
+            if ("single" === state) {
+                if ("'" === ch) state = "normal";
+                else current += ch;
+                continue;
+            }
+            if ("double" === state) {
+                if ("\"" === ch) state = "normal";
+                else if ("\\" === ch && i + 1 < command.length && [
+                    "$",
+                    "`",
+                    "\"",
+                    "\\",
+                    "\n"
+                ].includes(command[i + 1])) current += command[++i];
+                else current += ch;
+                continue;
+            }
+            if (/\s/.test(ch)) {
+                if (current) {
+                    tokens.push(current);
+                    current = "";
+                }
+            } else if ("'" === ch) state = "single";
+            else if ("\"" === ch) state = "double";
+            else if ("\\" === ch && i + 1 < command.length) current += command[++i];
+            else current += ch;
+        }
+        if ("normal" !== state) throw new Error("Unterminated quote in helper command");
+        if (current) tokens.push(current);
+        return tokens;
+    }
+    function parseCredentialHelperCommand(command) {
+        const trimmed = command.trim();
+        if (!trimmed || !trimmed.startsWith("!")) return {};
+        const tokens = splitShellCommand(trimmed.slice(1).trim());
+        return {
+            execPath: tokens[0],
+            helperPath: tokens[1]
+        };
+    }
+    function readHelperModulePath(helperPath) {
+        try {
+            const helperSource = external_fs_default().readFileSync(helperPath, "utf8");
+            const match = helperSource.match(/executeGitCredentialOperation\s*}\s*=\s*require\((["'])(.*?)\1\)/);
+            return match?.[2];
+        } catch  {
+            return;
+        }
+    }
+    function inspectCredentialHelperCommand(raw) {
+        const details = {
+            raw
+        };
+        try {
+            const parsed = parseCredentialHelperCommand(raw);
+            details.execPath = parsed.execPath;
+            details.helperPath = parsed.helperPath;
+        } catch (e) {
+            details.parseError = e.message;
+            return details;
+        }
+        if (details.execPath) details.execExists = external_fs_default().existsSync(details.execPath);
+        if (details.helperPath) {
+            details.helperExists = external_fs_default().existsSync(details.helperPath);
+            if (details.helperExists) {
+                try {
+                    const stat = external_fs_default().statSync(details.helperPath);
+                    details.helperExecutable = (73 & stat.mode) !== 0;
+                } catch  {
+                    details.helperExecutable = false;
+                }
+                details.modulePath = readHelperModulePath(details.helperPath);
+                if (details.modulePath) details.moduleExists = external_fs_default().existsSync(details.modulePath);
+            }
+        }
+        return details;
+    }
+    function detectAnvilRemote(remote) {
+        const fetchUrl = remote.refs.fetch;
+        const out = {
+            name: remote.name,
+            fetchUrl
+        };
+        if (!fetchUrl) return out;
+        const httpMatch = fetchUrl.match(/^(https?):\/\/(?:[^@/?#]+@)?([^/?#]+)\/git\/([A-Z0-9]+)\.git(?:[?#].*)?$/);
+        if (httpMatch) {
+            const [, protocol, host, appId] = httpMatch;
+            return {
+                ...out,
+                appId,
+                anvilUrl: normalizeAnvilUrl(`${protocol}://${host}`),
+                transport: "https"
+            };
+        }
+        const sshMatch = fetchUrl.match(/^ssh:\/\/(?:([^@]+)@)?([^:\/]+)(?::\d+)?\/(?:git\/)?([A-Z0-9]+)\.git(?:[?#].*)?$/);
+        if (sshMatch) {
+            const [, , host, appId] = sshMatch;
+            return {
+                ...out,
+                appId,
+                anvilUrl: normalizeAnvilUrl(host),
+                transport: "ssh"
+            };
+        }
+        return out;
+    }
+    async function getLocalConfigValues(repoPath, key) {
+        try {
+            const output = await esm_default(repoPath).raw([
+                "config",
+                "--local",
+                "--get-all",
+                key
+            ]);
+            const values = output.split(/\r?\n/);
+            if ("" === values[values.length - 1]) values.pop();
+            return values;
+        } catch  {
+            return [];
+        }
     }
-    async function checkout_openPathInEditorOrDefault(destinationPath, preferredEditorCommand, deps) {
-        await openPathInEditorOrDefault(destinationPath, preferredEditorCommand, deps);
+    function buildCredentialInput(anvilUrl, appId) {
+        const url = new URL(anvilUrl);
+        return `protocol=${url.protocol.replace(/:$/, "")}\nhost=${url.host}\npath=git/${appId}.git\n\n`;
+    }
+    async function runGitCredentialFill(repoPath, input) {
+        return new Promise((resolve)=>{
+            const child = (0, external_child_process_namespaceObject.spawn)("git", [
+                "credential",
+                "fill"
+            ], {
+                cwd: repoPath,
+                env: {
+                    ...process.env,
+                    GIT_TERMINAL_PROMPT: "0"
+                },
+                stdio: [
+                    "pipe",
+                    "pipe",
+                    "pipe"
+                ]
+            });
+            let stdout = "";
+            let stderr = "";
+            child.stdout.setEncoding("utf8");
+            child.stderr.setEncoding("utf8");
+            child.stdout.on("data", (chunk)=>{
+                stdout += chunk;
+            });
+            child.stderr.on("data", (chunk)=>{
+                stderr += chunk;
+            });
+            child.on("error", (error)=>{
+                resolve({
+                    exitCode: null,
+                    stdout: redactSecrets(stdout),
+                    stderr: redactSecrets(stderr),
+                    error: redactSecrets(error.message)
+                });
+            });
+            child.on("close", (code)=>{
+                resolve({
+                    exitCode: code,
+                    stdout: redactSecrets(stdout),
+                    stderr: redactSecrets(stderr)
+                });
+            });
+            child.stdin.end(input);
+        });
     }
-    function registerCheckoutCommand(program) {
-        const checkoutCommand = program.command("checkout [input] [directory]").description("Check out an Anvil app locally from editor URL, git URL, app ID, or interactive selection").alias("co").option("-O, --open", "Open destination after checkout").option("-b, --branch <BRANCH>", "Checkout a specific branch").option("--depth <N>", "Create a shallow clone with history truncated to N commits", (value)=>parseInt(value, 10)).option("--single-branch", "Clone only one branch").option("--origin <NAME>", "Use a custom remote name instead of origin").option("--quiet", "Suppress git clone progress output").option("--verbose", "Enable verbose git clone output").option("-u, --url <ANVIL_URL>", "Specify Anvil server URL").option("-U, --user <USERNAME>", "Specify which user account to use").option("-f, --force", "Override safety checks for destination path").option("-Q, --query <QUERY>", "Initial search query for interactive checkout picker").action(async (input, directory, options, command)=>{
+    async function buildAppReport(repoPath, remote, deps) {
+        const appId = remote.appId;
+        const anvilUrl = remote.anvilUrl;
+        const url = new URL(anvilUrl);
+        const credentialScope = `${url.protocol}//${url.host}`;
+        const helperConfigKey = `credential.${credentialScope}.helper`;
+        const helperValues = await getLocalConfigValues(repoPath, helperConfigKey);
+        const nonEmptyHelperValues = helperValues.filter((value)=>"" !== value.trim());
+        const helperDetails = nonEmptyHelperValues.map(inspectCredentialHelperCommand);
+        const findings = [];
+        if (0 === helperValues.length) findings.push(finding("error", "missing_helper_config", `No local ${helperConfigKey} entries found.`));
+        else if (0 === nonEmptyHelperValues.length) findings.push(finding("error", "missing_helper_command", `${helperConfigKey} only resets helpers; no Anvil helper command is configured.`));
+        for (const helper of helperDetails){
+            if (helper.parseError) findings.push(finding("error", "helper_parse_failed", `Could not parse helper command: ${helper.parseError}`));
+            if (helper.execPath && false === helper.execExists) findings.push(finding("error", "helper_exec_missing", `Credential helper Node executable does not exist: ${helper.execPath}`));
+            if (helper.helperPath) {
+                if (false === helper.helperExists) findings.push(finding("error", "helper_file_missing", `Credential helper script does not exist: ${helper.helperPath}`));
+                else if (false === helper.helperExecutable) findings.push(finding("warning", "helper_not_executable", `Credential helper script is not executable: ${helper.helperPath}`));
+            } else findings.push(finding("error", "helper_path_missing", "Credential helper command does not include a helper script path."));
+            if (helper.modulePath && false === helper.moduleExists) findings.push(finding("error", "helper_module_missing", `Generated helper points at a missing module: ${helper.modulePath}`));
+            if (helper.modulePath && "cli.js" === external_path_default().basename(helper.modulePath)) findings.push(finding("error", "helper_module_cli_entry", `Generated helper points at the CLI entry instead of the API entry: ${helper.modulePath}`));
+        }
+        const binding = await deps.getAppAuthBinding(repoPath, appId);
+        if (!binding.url) findings.push(finding("warning", "missing_app_binding_url", `No anvil.auth.${appId}.url binding is configured.`));
+        if (!binding.username) findings.push(finding("warning", "missing_app_binding_username", `No anvil.auth.${appId}.username binding is configured.`));
+        const authUrl = binding.url ? normalizeAnvilUrl(binding.url) : anvilUrl;
+        let accounts = [];
+        let authUsername = binding.username;
+        let hasUsableAuth = false;
+        try {
+            accounts = await deps.getAccountsForUrl(authUrl);
+            if (authUsername || 1 !== accounts.length) {
+                if (!authUsername && accounts.length > 1) findings.push(finding("error", "multiple_accounts_without_binding", `Multiple accounts are logged in for ${authUrl}; bind one with anvil checkout --user.`));
+            } else authUsername = accounts[0];
+            hasUsableAuth = authUsername ? await deps.hasTokensForUrl(authUrl, authUsername) : accounts.length <= 1 && await deps.hasTokensForUrl(authUrl);
+            if (!hasUsableAuth) findings.push(finding("error", "missing_usable_auth", authUsername ? `No usable auth tokens found for ${authUrl} as ${authUsername}.` : `No usable auth tokens found for ${authUrl}.`));
+        } catch (e) {
+            findings.push(finding("error", "auth_lookup_failed", `Auth lookup failed: ${redactSecrets(e.message)}`));
+        }
+        const fillResult = await deps.runCredentialFill(repoPath, buildCredentialInput(anvilUrl, appId));
+        const credentialSimulation = {
+            status: 0 === fillResult.exitCode && /^password=/im.test(fillResult.stdout) ? "ok" : "error",
+            exitCode: fillResult.exitCode,
+            stdout: redactSecrets(fillResult.stdout),
+            stderr: redactSecrets(fillResult.stderr),
+            error: fillResult.error ? redactSecrets(fillResult.error) : void 0
+        };
+        if ("ok" !== credentialSimulation.status) findings.push(finding("error", "credential_fill_failed", credentialSimulation.error || credentialSimulation.stderr.trim() || "git credential fill did not return a password."));
+        const report = {
+            appId,
+            anvilUrl,
+            remoteName: remote.name,
+            remoteUrl: remote.fetchUrl,
+            credentialScope,
+            helperConfigKey,
+            helperValues,
+            helperDetails,
+            binding: {
+                url: binding.url,
+                username: binding.username,
+                hasUrl: !!binding.url,
+                hasUsername: !!binding.username
+            },
+            auth: {
+                url: authUrl,
+                username: authUsername,
+                accounts,
+                hasUsableAuth
+            },
+            credentialSimulation,
+            findings
+        };
+        return report;
+    }
+    async function buildGitAuthDoctorReport(repoPathInput = process.cwd(), options = {}) {
+        const deps = options.deps ?? defaultGitAuthDoctorDeps;
+        const inputPath = external_path_default().resolve(repoPathInput);
+        const git = esm_default(inputPath);
+        const repoPath = (await git.raw([
+            "rev-parse",
+            "--show-toplevel"
+        ])).trim();
+        const rawGitDir = (await git.raw([
+            "rev-parse",
+            "--git-dir"
+        ])).trim();
+        const gitDir = external_path_default().isAbsolute(rawGitDir) ? rawGitDir : external_path_default().resolve(inputPath, rawGitDir);
+        setRepoContext(repoPath);
+        const remotes = (await git.getRemotes(true)).map(detectAnvilRemote);
+        const anvilRemotes = remotes.filter((remote)=>remote.appId && remote.anvilUrl && "https" === remote.transport);
+        const findings = [];
+        if (0 === anvilRemotes.length) findings.push(finding("error", "missing_anvil_https_remote", "No HTTPS Anvil git remotes were detected."));
+        const apps = await Promise.all(anvilRemotes.map((remote)=>buildAppReport(repoPath, remote, deps)));
+        const status = getHighestStatus([
+            ...findings.map((item)=>item.status),
+            ...apps.flatMap((app)=>app.findings.map((item)=>item.status))
+        ]);
+        return {
+            repoPath,
+            gitDir,
+            remotes,
+            apps,
+            findings,
+            status
+        };
+    }
+    function formatStatus(status) {
+        if ("ok" === status) return external_chalk_default().green("[ok]");
+        if ("warning" === status) return external_chalk_default().yellow("[warn]");
+        return external_chalk_default().red("[error]");
+    }
+    function formatGitAuthDoctorReport(report) {
+        const lines = [];
+        lines.push(external_chalk_default().bold("Git auth doctor"));
+        lines.push(`Repository: ${report.repoPath}`);
+        lines.push(`Git dir: ${report.gitDir}`);
+        lines.push(`Overall: ${formatStatus(report.status)}`);
+        lines.push("");
+        lines.push(external_chalk_default().bold("Detected remotes:"));
+        if (0 === report.remotes.length) lines.push("  (none)");
+        else for (const remote of report.remotes){
+            const appText = remote.appId && remote.anvilUrl ? ` -> ${remote.appId} on ${remote.anvilUrl}` : "";
+            lines.push(`  - ${remote.name}: ${remote.fetchUrl || "(no fetch URL)"}${appText}`);
+        }
+        for (const app of report.apps){
+            lines.push("");
+            lines.push(external_chalk_default().bold(`App ${app.appId} (${app.remoteName})`));
+            lines.push(`  URL: ${app.anvilUrl}`);
+            lines.push(`  Credential scope: ${app.credentialScope}`);
+            lines.push(`  Helper config: ${app.helperConfigKey}`);
+            if (0 === app.helperValues.length) lines.push("    (none)");
+            else for (const value of app.helperValues)lines.push(`    - ${value || "(reset helper list)"}`);
+            for (const helper of app.helperDetails){
+                lines.push(`  Helper command: ${helper.raw}`);
+                lines.push(`    Node: ${helper.execPath || "(missing)"} ${false === helper.execExists ? "[missing]" : ""}`.trimEnd());
+                lines.push(`    Script: ${helper.helperPath || "(missing)"} ${false === helper.helperExists ? "[missing]" : ""}`.trimEnd());
+                if (helper.modulePath) lines.push(`    Module: ${helper.modulePath} ${false === helper.moduleExists ? "[missing]" : ""}`.trimEnd());
+            }
+            lines.push(`  Binding URL: ${app.binding.url || "(missing)"}`);
+            lines.push(`  Binding user: ${app.binding.username || "(missing)"}`);
+            lines.push(`  Auth tokens: ${app.auth.hasUsableAuth ? "available" : "not available"}${app.auth.username ? ` for ${app.auth.username}` : ""}`);
+            if (app.credentialSimulation) {
+                lines.push(`  Credential fill: ${formatStatus(app.credentialSimulation.status)} exit=${app.credentialSimulation.exitCode}`);
+                if (app.credentialSimulation.stdout.trim()) {
+                    lines.push("    stdout:");
+                    for (const line of app.credentialSimulation.stdout.trim().split(/\r?\n/))lines.push(`      ${line}`);
+                }
+                if (app.credentialSimulation.stderr.trim()) {
+                    lines.push("    stderr:");
+                    for (const line of app.credentialSimulation.stderr.trim().split(/\r?\n/))lines.push(`      ${line}`);
+                }
+            }
+            if (app.findings.length > 0) {
+                lines.push("  Findings:");
+                for (const item of app.findings)lines.push(`    ${formatStatus(item.status)} ${item.code}: ${item.message}`);
+            }
+        }
+        if (report.findings.length > 0) {
+            lines.push("");
+            lines.push(external_chalk_default().bold("Repository findings:"));
+            for (const item of report.findings)lines.push(`  ${formatStatus(item.status)} ${item.code}: ${item.message}`);
+        }
+        return lines.join("\n");
+    }
+    function registerGitAuthCommand(program) {
+        const gitAuthCommand = program.command("git-auth").description("Diagnose Anvil Git authentication");
+        gitAuthCommand.command("doctor").description("Diagnose why plain Git commands cannot authenticate to Anvil").option("--repo <PATH>", "Repository path to diagnose", process.cwd()).action(async (options)=>{
             try {
-                const globalOptions = command?.optsWithGlobals() || options || {};
-                if ("number" == typeof options?.depth && (!Number.isFinite(options.depth) || options.depth <= 0)) throw new Error("--depth must be a positive integer");
-                await executeCheckoutInteractive({
-                    input,
-                    directory,
-                    open: options?.open,
-                    branch: options?.branch,
-                    depth: options?.depth,
-                    singleBranch: options?.singleBranch,
-                    origin: options?.origin,
-                    quiet: options?.quiet,
-                    verbose: globalOptions.verbose,
-                    url: options?.url,
-                    user: options?.user,
-                    force: options?.force,
-                    query: options?.query
-                }, defaultCheckoutDeps);
+                const report = await buildGitAuthDoctorReport(options.repo || process.cwd());
+                if (getGlobalOutputConfig().jsonMode) logJsonResult("error" !== report.status, {
+                    data: report
+                });
+                else logger_logger.info(formatGitAuthDoctorReport(report));
+                if ("error" === report.status) process.exitCode = 1;
             } catch (e) {
-                logger_logger.error("Error: " + errors_getErrorMessage(e));
-                process.exit(1);
+                const message = redactSecrets(e.message);
+                if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
+                    error: message
+                });
+                else logger_logger.error(`Git auth doctor failed: ${message}`);
+                process.exitCode = 1;
             }
         });
-        checkoutCommand.addHelpText("after", "\n" + external_chalk_default().bold("Examples:") + '\n  anvil checkout http://localhost:3000/build/apps/APPID/code/assets/theme.css\n  anvil checkout https://anvil.works/git/APPID.git\n  anvil checkout APPID --url anvil.works\n  anvil checkout APPID --branch master --depth 1 --single-branch\n  anvil checkout APPID -O  # open editor/file browser after checkout\n  anvil checkout APPID my-local-folder --force\n  anvil checkout  # interactive search/select app list\n  anvil checkout -Q "dashboard"  # preseed picker search\n');
     }
     const gitCredential_defaultDeps = {
         getValidAuthToken: auth_getValidAuthToken,
@@ -19667,6 +21303,9 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         getAppAuthBinding: getAppAuthBinding,
         cwd: ()=>process.cwd()
     };
+    function sanitizeCredentialError(message) {
+        return message.replace(/^password=.*$/gim, "password=<redacted>").replace(/(https?:\/\/git:)[^@\s]+@/g, "$1<redacted>@").replace(/(access[_-]?token=)[^&\s]+/gi, "$1<redacted>").replace(/(refresh[_-]?token=)[^&\s]+/gi, "$1<redacted>");
+    }
     function parseGitCredentialRequest(rawInput) {
         const out = {};
         const lines = rawInput.split(/\r?\n/);
@@ -19727,7 +21366,11 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         }).description("Internal helper command for Git HTTPS authentication").action(async (operation)=>{
             try {
                 await executeGitCredentialOperation(operation);
-            } catch  {
+            } catch (e) {
+                if ("1" === process.env["ANVIL_GIT_CREDENTIAL_DEBUG"]) {
+                    const message = e instanceof Error ? e.message : String(e);
+                    process.stderr.write(`anvil git-credential failed: ${sanitizeCredentialError(message)}\n`);
+                }
                 process.exit(1);
             }
         });
@@ -19745,7 +21388,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 authToken,
                 currentBranch,
                 commitId,
-                username
+                username,
+                dependencyWatch: false
             });
             await session.initialize();
             await session.syncRemoteChanges();
@@ -19842,7 +21486,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             stagedOnly,
             username,
             environment,
-            envBranchChangeMode: options.envBranchChangeMode ?? "manual"
+            envBranchChangeMode: options.envBranchChangeMode ?? "manual",
+            dependencyWatch: options.dependencyWatch ?? true
         });
         session.on("branch-changed", (data)=>{
             logger_logger.debug("Event: branch-changed", data);
@@ -20181,7 +21826,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 anvilUrl: options.anvilUrl,
                 stagedOnly: options.stagedOnly,
                 username: options.username,
-                envBranchChangeMode: options.autoMode ? "auto-clean-switch" : "manual"
+                envBranchChangeMode: options.autoMode ? "auto-clean-switch" : "manual",
+                dependencyWatch: options.dependencyWatch ?? true
             });
             logger_logger.progressEnd("verify");
             const currentCategory = getSyncStateCategory(freshSession.syncStatus);
@@ -20205,7 +21851,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 anvilUrl: options.anvilUrl,
                 stagedOnly: options.stagedOnly,
                 username: options.username,
-                envBranchChangeMode: options.autoMode ? "auto-clean-switch" : "manual"
+                envBranchChangeMode: options.autoMode ? "auto-clean-switch" : "manual",
+                dependencyWatch: options.dependencyWatch ?? true
             });
             logger_logger.progressEnd("init");
             return await checkSyncStatusAndStart(newSession, options);
@@ -20455,7 +22102,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                         anvilUrl,
                         stagedOnly,
                         username: options.username,
-                        envBranchChangeMode: autoMode ? "auto-clean-switch" : "manual"
+                        envBranchChangeMode: autoMode ? "auto-clean-switch" : "manual",
+                        dependencyWatch: options.dependencyWatch ?? true
                     });
                     logger_logger.progressEnd("init");
                     const started = await checkSyncStatusAndStart(newSession, options);
@@ -20542,7 +22190,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             logger_logger.error("'sync' has been renamed to 'watch'. Please use 'anvil watch' instead.");
             process.exit(1);
         }
-        const { path: repoPath = process.cwd(), appid: explicitAppId, useFirst = false, stagedOnly = false, autoMode = false, url: explicitUrl, user: explicitUsername, open: openAfterValidation = false } = options;
+        const { path: repoPath = process.cwd(), appid: explicitAppId, useFirst = false, stagedOnly = false, dependencyWatch = true, autoMode = false, url: explicitUrl, user: explicitUsername, open: openAfterValidation = false } = options;
         setRepoContext(repoPath);
         try {
             const validationResult = await validateAnvilApp(repoPath);
@@ -20698,7 +22346,8 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 anvilUrl,
                 stagedOnly,
                 username,
-                envBranchChangeMode: autoMode ? "auto-clean-switch" : "manual"
+                envBranchChangeMode: autoMode ? "auto-clean-switch" : "manual",
+                dependencyWatch
             });
             logger_logger.progressEnd("init");
             if (openAfterValidation) await openWatchPath(resolveWatchOpenPath(repoPath));
@@ -20709,6 +22358,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 appId: finalAppId,
                 anvilUrl,
                 stagedOnly,
+                dependencyWatch,
                 username
             });
             if (!started) process.exit(1);
@@ -20718,7 +22368,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         }
     }
     function registerWatchCommand(program) {
-        const watchCommand = program.command("watch [path]").description("Watch for file changes and sync to Anvil").alias("sync").alias("w").option("-A, --appid <APP_ID>", "Specify app ID directly").option("-f, --first", "Auto-select first detected app ID without confirmation").option("-s, --staged-only", "Only sync staged changes (use git add to stage files)").option("-a, --auto", "Auto mode: restart on branch changes and sync when behind").option("-O, --open", "Open watched path in preferred editor (or default app)").option("-u, --url <ANVIL_URL>", "Specify Anvil server URL (e.g., anvil.works, localhost)").option("-U, --user <USERNAME>", "Specify which user account to use").action(async (path, options, command)=>{
+        const watchCommand = program.command("watch [path]").description("Watch for file changes and sync to Anvil").alias("sync").alias("w").option("-A, --appid <APP_ID>", "Specify app ID directly").option("-f, --first", "Auto-select first detected app ID without confirmation").option("-s, --staged-only", "Only sync staged changes (use git add to stage files)").option("--no-dependency-watch", "Do not watch and refresh .anvil/deps dependencies").option("-a, --auto", "Auto mode: restart on branch changes and sync when behind").option("-O, --open", "Open watched path in preferred editor (or default app)").option("-u, --url <ANVIL_URL>", "Specify Anvil server URL (e.g., anvil.works, localhost)").option("-U, --user <USERNAME>", "Specify which user account to use").action(async (path, options, command)=>{
             const globalOptions = command.optsWithGlobals();
             if (void 0 !== globalOptions.verbose && logger_logger instanceof CLILogger) logger_logger.setVerbose(globalOptions.verbose);
             await handleWatchCommand({
@@ -20726,6 +22376,7 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
                 appid: options.appid,
                 useFirst: options.first,
                 stagedOnly: options.stagedOnly,
+                dependencyWatch: options.dependencyWatch,
                 autoMode: options.auto,
                 verbose: globalOptions.verbose,
                 open: options.open,
@@ -20977,6 +22628,178 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             }
         });
     }
+    function formSpecContext_isPlainObject(value) {
+        return "object" == typeof value && null !== value && !Array.isArray(value);
+    }
+    function collectFormSpecReferences(value, references) {
+        if ("string" == typeof value) {
+            if (value.startsWith("form:") || /^[^:]+:[^:]+$/.test(value)) references.add(value);
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value)collectFormSpecReferences(item, references);
+            return;
+        }
+        if (!formSpecContext_isPlainObject(value)) return;
+        for (const [key, nested] of Object.entries(value)){
+            if ("type" === key && "string" == typeof nested && nested.startsWith("form:")) references.add(nested);
+            if ("item_template" === key && "string" == typeof nested) references.add(nested);
+            collectFormSpecReferences(nested, references);
+        }
+    }
+    function formYamlHasFormSpecReferences(form) {
+        const references = new Set();
+        collectFormSpecReferences(form, references);
+        return references.size > 0;
+    }
+    async function readAnvilYamlConfig(appRoot) {
+        try {
+            const content = await external_fs_.promises.readFile(external_path_default().join(appRoot, "anvil.yaml"), "utf8");
+            const parsed = external_js_yaml_default().load(content);
+            return formSpecContext_isPlainObject(parsed) ? parsed : void 0;
+        } catch  {
+            return;
+        }
+    }
+    function resolveDependencyPackageName(dependency, dependencyIds, cachedPackageNamesByAppId) {
+        const packageName = dependency.resolution_hints?.package_name;
+        if (packageName) return packageName;
+        const depId = dependency.dep_id;
+        if (!depId) return;
+        const appId = dependency.resolution_hints?.app_id ?? dependencyIds?.[depId];
+        if (!appId) return;
+        return cachedPackageNamesByAppId.get(appId);
+    }
+    async function buildFormSpecPackageContext(sourcePath) {
+        const appRoot = findAnvilAppRoot(sourcePath);
+        if (!appRoot) return;
+        const config = await readAnvilYamlConfig(appRoot);
+        if (!config) return;
+        const manifest = await readDepsCacheManifest(appRoot);
+        const cachedPackageNamesByAppId = new Map((manifest?.cached_dependencies ?? []).map((entry)=>[
+                entry.app_id,
+                entry.package_name
+            ]));
+        const dependencyPackageNamesByLogicalDepId = {};
+        const knownPackageNames = new Set();
+        for (const dependency of config.dependencies ?? []){
+            const depId = dependency.dep_id;
+            if (!depId) continue;
+            const packageName = resolveDependencyPackageName(dependency, config.dependency_ids, cachedPackageNamesByAppId);
+            dependencyPackageNamesByLogicalDepId[depId] = packageName;
+            if (packageName) knownPackageNames.add(packageName);
+        }
+        return {
+            appPackageName: config.package_name,
+            knownPackageNames: [
+                ...knownPackageNames
+            ],
+            dependencyPackageNamesByLogicalDepId
+        };
+    }
+    class ConvertTemplateValidationError extends Error {
+        issues;
+        constructor(message, issues){
+            super(message), this.issues = issues;
+            this.name = "ConvertTemplateValidationError";
+        }
+    }
+    function hasYamlExtension(filePath) {
+        return /\.ya?ml$/i.test(filePath);
+    }
+    function getDefaultConvertedTemplatePath(inputPath) {
+        return inputPath.replace(/\.ya?ml$/i, ".html");
+    }
+    function resolveConvertTemplatePaths(inputPath, options = {}) {
+        const cwd = options.cwd ?? process.cwd();
+        if (!hasYamlExtension(inputPath)) throw new Error("Input template must be a .yaml or .yml file");
+        const sourcePath = external_path_default().resolve(cwd, inputPath);
+        const outputPath = external_path_default().resolve(cwd, options.output ?? getDefaultConvertedTemplatePath(inputPath));
+        if (sourcePath === outputPath) throw new Error("Output path must be different from the input path");
+        return {
+            sourcePath,
+            outputPath
+        };
+    }
+    async function pathExists(filePath) {
+        try {
+            await external_fs_.promises.access(filePath);
+            return true;
+        } catch  {
+            return false;
+        }
+    }
+    async function writeFileAtomically(filePath, content) {
+        const directory = external_path_default().dirname(filePath);
+        await external_fs_.promises.mkdir(directory, {
+            recursive: true
+        });
+        const tempPath = external_path_default().join(directory, `.${external_path_default().basename(filePath)}.${process.pid}.${Date.now()}.tmp`);
+        await external_fs_.promises.writeFile(tempPath, content, "utf8");
+        await external_fs_.promises.rename(tempPath, filePath);
+    }
+    async function loadParser() {
+        return import("@anvil-works/form-template-parser");
+    }
+    async function convertTemplateFile(inputPath, options = {}) {
+        const { sourcePath, outputPath } = resolveConvertTemplatePaths(inputPath, options);
+        if (!options.force && await pathExists(outputPath)) throw new Error(`Output file already exists: ${outputPath}. Use --force to overwrite it.`);
+        const yamlContent = await external_fs_.promises.readFile(sourcePath, "utf8");
+        const validationResult = validateFormTemplate(yamlContent);
+        if (!validationResult.ok) throw new ConvertTemplateValidationError(validationResult.message, validationResult.issues);
+        let template = external_js_yaml_default().load(yamlContent);
+        const parser = await loadParser();
+        const context = await buildFormSpecPackageContext(sourcePath);
+        if (context) template = parser.copyFormYamlWithCanonicalizedFormSpecs(template, context).form;
+        else if (formYamlHasFormSpecReferences(template)) logger_logger.warn("Skipping form-spec canonicalization: no anvil.yaml found for this template");
+        const html = parser.serializeFormTemplateHtml(template, {
+            allowReparse: true
+        });
+        await writeFileAtomically(outputPath, html.endsWith("\n") ? html : `${html}\n`);
+        let removedSource = false;
+        if (!options.keepSource) try {
+            await external_fs_.promises.unlink(sourcePath);
+            removedSource = true;
+        } catch (error) {
+            throw new Error(`Converted template written to ${outputPath}, but failed to remove source ${sourcePath}: ${error.message}`);
+        }
+        return {
+            source: sourcePath,
+            output: outputPath,
+            removedSource
+        };
+    }
+    function registerConvertTemplateCommand(program) {
+        program.command("convert-template <file>").description("Convert an Anvil form template YAML file to HTML template format").option("-o, --output <path>", "Output HTML path").option("-f, --force", "Overwrite the output file if it already exists").option("--keep-source", "Keep the source YAML file after conversion").action(async (file, options)=>{
+            try {
+                const result = await convertTemplateFile(file, options);
+                if (getGlobalOutputConfig().jsonMode) logJsonResult(true, {
+                    data: result
+                });
+                else {
+                    logger_logger.success(`Converted ${result.source} to ${result.output}`);
+                    if (result.removedSource) logger_logger.info(`Removed source ${result.source}`);
+                }
+            } catch (error) {
+                if (error instanceof ConvertTemplateValidationError) if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
+                    error: error.message,
+                    data: {
+                        file,
+                        issues: error.issues
+                    }
+                });
+                else {
+                    logger_logger.error(`${file} failed validation: ${error.message}`);
+                    for (const issue of error.issues)logger_logger.error(`  - ${formatValidationPath(issue.path)}: ${issue.message}`);
+                }
+                else if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
+                    error: error.message
+                });
+                else logger_logger.error(error.message);
+                process.exitCode = 1;
+            }
+        });
+    }
     function getVersionInfo(version) {
         return {
             version,
@@ -21157,6 +22980,160 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             }
         });
     }
+    async function resolvePrimaryAppId(projectRoot, anvilUrl) {
+        const remoteCandidates = await detectAppIdsFromAllRemotes(projectRoot);
+        if (remoteCandidates.length > 0) return remoteCandidates[0].appId;
+        const lookupCandidates = await detectAppIdsByCommitLookup(projectRoot, {
+            anvilUrl,
+            includeRemotes: false
+        });
+        return lookupCandidates[0]?.appId ?? null;
+    }
+    function registerDepsCommand(program) {
+        const deps = program.command("deps").description("Manage app dependencies");
+        deps.command("fetch").description("Fetch dependencies into .anvil/deps/").option("--commit <commit>", "Fetch deps at specific commit").option("--exclude-docs", "Exclude dependency docs from .anvil/deps/").action(async (options)=>{
+            try {
+                const projectRoot = process.cwd();
+                const anvilUrl = resolveAnvilUrl();
+                const mainAppId = await resolvePrimaryAppId(projectRoot, anvilUrl);
+                if (!mainAppId) {
+                    logger_logger.error("No Anvil app found in current directory");
+                    logger_logger.info("Make sure you're in a directory with an Anvil app git remote.");
+                    process.exit(1);
+                }
+                logger_logger.info(`Fetching dependencies for app ${mainAppId}...`);
+                const { response, addedGitignoreEntry } = await refreshDependencyCache(projectRoot, mainAppId, anvilUrl, {
+                    commit: options.commit,
+                    includeDocs: !options.excludeDocs
+                });
+                if (!response.resolved_dependencies.length) return void logger_logger.info("No dependencies to fetch");
+                if (addedGitignoreEntry) logger_logger.info("Added /.anvil/ to .gitignore");
+                if (!response.dependencies.length) return void logger_logger.success(`Dependencies already up to date (${response.resolved_dependencies.length} cached)`);
+                logger_logger.success(`Fetched ${response.dependencies.length} dependencies:`);
+                for (const dep of response.dependencies)logger_logger.info(`  - ${dep.package_name}`);
+            } catch (e) {
+                logger_logger.error(e.message);
+                process.exit(1);
+            }
+        });
+        deps.command("status").description("Show cached dependencies").action(async ()=>{
+            try {
+                const cached = await getCachedPackages(process.cwd());
+                if (!cached.length) return void logger_logger.info("No cached dependencies (run 'anvil deps fetch')");
+                logger_logger.info("Cached dependencies:");
+                for (const pkg of cached)logger_logger.info(`  - ${pkg}`);
+            } catch (e) {
+                logger_logger.error(e.message);
+                process.exit(1);
+            }
+        });
+        deps.command("clear").description("Clear cached dependencies").action(async ()=>{
+            try {
+                await clearDepsCache(process.cwd());
+                logger_logger.success("Cleared .anvil/deps/");
+            } catch (e) {
+                logger_logger.error(e.message);
+                process.exit(1);
+            }
+        });
+    }
+    const TABLE_MAPPINGS_PATH = ".anvil/table-mappings.json";
+    function tables_formatFetchError(prefix, status, errorBody) {
+        if (!errorBody) return `${prefix}: ${status}`;
+        try {
+            const parsed = JSON.parse(errorBody);
+            if ("string" == typeof parsed.error && parsed.error.trim()) return `${prefix}: ${parsed.error} (${status})`;
+        } catch  {}
+        return `${prefix}: ${status} ${errorBody}`;
+    }
+    async function fetchTableMappings(appId, anvilUrl = resolveAnvilUrl()) {
+        const token = await auth_getValidAuthToken(anvilUrl);
+        const resp = await fetch(`${anvilUrl}/ide/api/_/apps/${appId}/db`, {
+            headers: {
+                Authorization: `Bearer ${token}`
+            }
+        });
+        if (!resp.ok) {
+            const errorBody = await resp.text();
+            throw new Error(tables_formatFetchError("Failed to fetch table mappings", resp.status, errorBody));
+        }
+        const databases = await resp.json();
+        const allTables = [];
+        for (const db of databases)for (const table of db.tables || [])allTables.push({
+            table_id: table.id,
+            python_name: table.python_name,
+            name: table.name
+        });
+        return {
+            tables: allTables
+        };
+    }
+    async function writeTableMappings(projectRoot, mappings) {
+        const filePath = external_path_default().join(projectRoot, TABLE_MAPPINGS_PATH);
+        await promises_default().mkdir(external_path_default().dirname(filePath), {
+            recursive: true
+        });
+        await promises_default().writeFile(filePath, JSON.stringify(mappings, null, 2));
+    }
+    async function readTableMappings(projectRoot) {
+        const filePath = external_path_default().join(projectRoot, TABLE_MAPPINGS_PATH);
+        try {
+            const content = await promises_default().readFile(filePath, "utf-8");
+            return JSON.parse(content);
+        } catch  {
+            return null;
+        }
+    }
+    async function clearTableMappings(projectRoot) {
+        const filePath = external_path_default().join(projectRoot, TABLE_MAPPINGS_PATH);
+        await promises_default().rm(filePath, {
+            force: true
+        });
+    }
+    function registerTablesCommand(program) {
+        const tables = program.command("tables").description("Manage table mappings");
+        tables.command("fetch").description("Fetch table mappings into .anvil/table-mappings.json").action(async ()=>{
+            try {
+                const projectRoot = process.cwd();
+                const anvilUrl = resolveAnvilUrl();
+                const mainAppId = await resolvePrimaryAppId(projectRoot, anvilUrl);
+                if (!mainAppId) {
+                    logger_logger.error("No Anvil app found in current directory");
+                    logger_logger.info("Make sure you're in a directory with an Anvil app git remote.");
+                    process.exit(1);
+                }
+                logger_logger.info("Fetching table mappings...");
+                const response = await fetchTableMappings(mainAppId, anvilUrl);
+                if (!response.tables.length) return void logger_logger.info("No tables found");
+                if (await ensureProjectGitignoreIgnoresAnvilDir(projectRoot)) logger_logger.info("Added /.anvil/ to .gitignore");
+                await writeTableMappings(projectRoot, response);
+                logger_logger.success(`Fetched ${response.tables.length} table mappings`);
+            } catch (e) {
+                logger_logger.error(e.message);
+                process.exit(1);
+            }
+        });
+        tables.command("status").description("Show cached table mappings").action(async ()=>{
+            try {
+                const mappings = await readTableMappings(process.cwd());
+                if (!mappings || !mappings.tables.length) return void logger_logger.info("No cached table mappings (run 'anvil tables fetch')");
+                logger_logger.info("Cached table mappings:");
+                for (const t of mappings.tables)logger_logger.info(`  ${t.python_name} (${t.name}) - ID: ${t.table_id}`);
+            } catch (e) {
+                logger_logger.error(e.message);
+                process.exit(1);
+            }
+        });
+        tables.command("clear").description("Clear cached table mappings").action(async ()=>{
+            try {
+                await clearTableMappings(process.cwd());
+                logger_logger.success("Cleared .anvil/table-mappings.json");
+            } catch (e) {
+                logger_logger.error(e.message);
+                process.exit(1);
+            }
+        });
+    }
     const program_packageJson = JSON.parse((0, external_fs_.readFileSync)((0, external_path_namespaceObject.join)(__dirname, "../package.json"), "utf-8"));
     const VERSION = program_packageJson.version;
     setLogger(new CLILogger({
@@ -21174,6 +23151,123 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
             }
         }).catch(()=>{});
     }
+    function collectValidationFiles(dir) {
+        const files = [];
+        const ignoredDirectories = new Set([
+            ".anvil",
+            ".git",
+            "node_modules",
+            "__pycache__"
+        ]);
+        function walk(currentDir) {
+            for (const entry of (0, external_fs_.readdirSync)(currentDir, {
+                withFileTypes: true
+            })){
+                const entryPath = (0, external_path_namespaceObject.join)(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    if (!ignoredDirectories.has(entry.name)) walk(entryPath);
+                    continue;
+                }
+                if (entry.isFile() && inferValidationTarget(entryPath)) files.push(entryPath);
+            }
+        }
+        walk(dir);
+        return files.sort();
+    }
+    function validateSingleFile(file) {
+        let fileContent;
+        try {
+            fileContent = (0, external_fs_.readFileSync)(file, "utf8");
+        } catch (error) {
+            return {
+                file,
+                type: "unknown",
+                valid: false,
+                error: `Failed to read ${file}: ${error.message}`,
+                issues: [
+                    {
+                        path: "",
+                        message: error.message
+                    }
+                ]
+            };
+        }
+        const result = validatePath(file, fileContent);
+        if (result.ok) return {
+            file,
+            type: result.target,
+            valid: true
+        };
+        return {
+            file,
+            type: result.target,
+            valid: false,
+            error: result.message,
+            issues: result.issues
+        };
+    }
+    function logValidationFailure(fileResult) {
+        logger_logger.error(`${fileResult.file} failed validation: ${fileResult.error ?? "Validation failed"}`);
+        for (const issue of fileResult.issues ?? []){
+            const issuePath = issue.path.length > 0 ? issue.path : "root";
+            logger_logger.error(`  - ${issuePath}: ${issue.message}`);
+        }
+    }
+    function handleValidateFile(file) {
+        const fileResult = validateSingleFile(file);
+        if (fileResult.valid) {
+            if (getGlobalOutputConfig().jsonMode) logJsonResult(true, {
+                data: {
+                    file: fileResult.file,
+                    type: fileResult.type,
+                    valid: true
+                }
+            });
+            else logger_logger.success(`${fileResult.file} is valid (${fileResult.type})`);
+            return;
+        }
+        if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
+            error: fileResult.error,
+            data: {
+                file: fileResult.file,
+                type: fileResult.type,
+                issues: fileResult.issues ?? []
+            }
+        });
+        else logValidationFailure(fileResult);
+        process.exitCode = 1;
+    }
+    function handleValidateDirectory(dir) {
+        const files = collectValidationFiles(dir);
+        if (0 === files.length) {
+            const error = `No supported files found under ${dir}`;
+            if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
+                error,
+                data: {
+                    file: dir,
+                    valid: false,
+                    files: []
+                }
+            });
+            else logger_logger.error(error);
+            process.exitCode = 1;
+            return;
+        }
+        const fileResults = files.map(validateSingleFile);
+        const failedResults = fileResults.filter((result)=>!result.valid);
+        if (getGlobalOutputConfig().jsonMode) logJsonResult(0 === failedResults.length, {
+            error: failedResults.length > 0 ? "Validation failed" : void 0,
+            data: {
+                file: dir,
+                valid: 0 === failedResults.length,
+                count: fileResults.length,
+                files: fileResults
+            }
+        });
+        else for (const fileResult of fileResults)if (fileResult.valid) logger_logger.success(`${fileResult.file} is valid (${fileResult.type})`);
+        else logValidationFailure(fileResult);
+        if (failedResults.length > 0) process.exitCode = 1;
+    }
     function getUpdateInstructions(platform) {
         if ("win32" === platform) return [
             "try { irm https://anvil.works/install-cli.ps1 | iex } catch { npm install -g @anvil-works/anvil-cli@latest }",
@@ -21274,52 +23368,30 @@ Promise.resolve(executeGitCredentialOperation(process.argv[2] || "get", {
         });
         const watchCommand = registerWatchCommand(program);
         registerCheckoutCommand(program);
+        registerGitAuthCommand(program);
         registerGitCredentialCommand(program);
         registerLoginCommand(program);
         registerLogoutCommand(program);
         registerConfigCommand(program);
+        registerConvertTemplateCommand(program);
         registerVersionCommand(program, VERSION);
         registerConfigureCommand(program, VERSION);
+        registerDepsCommand(program);
+        registerTablesCommand(program);
         program.command("update").description("Update anvil to the latest version").alias("u").action(async ()=>{
             await handleUpdateCommand();
         });
-        program.command("validate").description("Validate YAML based on path (anvil.yaml or client_code/**/*.yaml)").argument("<file>", "Path to YAML file").action((file)=>{
-            let yamlContent;
+        program.command("validate").description("Validate Anvil app files by path or directory (anvil.yaml, client_code/**/*.yaml, client_code/**/*.html, client_code/**/*.py, or server_code/**/*.py)").argument("<path>", "Path to file or directory").action((file)=>{
+            let pathStat;
             try {
-                yamlContent = (0, external_fs_.readFileSync)(file, "utf8");
+                pathStat = (0, external_fs_.statSync)(file);
             } catch (error) {
-                logger_logger.error(`Failed to read ${file}: ${error.message}`);
+                logger_logger.error(`Failed to access ${file}: ${error.message}`);
                 process.exitCode = 1;
                 return;
             }
-            const result = validatePath(file, yamlContent);
-            if (result.ok) {
-                if (getGlobalOutputConfig().jsonMode) logJsonResult(true, {
-                    data: {
-                        file,
-                        type: result.target,
-                        valid: true
-                    }
-                });
-                else logger_logger.success(`${file} is valid (${result.target})`);
-                return;
-            }
-            if (getGlobalOutputConfig().jsonMode) logJsonResult(false, {
-                error: result.message,
-                data: {
-                    file,
-                    type: result.target,
-                    issues: result.issues
-                }
-            });
-            else {
-                logger_logger.error(`${file} failed validation: ${result.message}`);
-                for (const issue of result.issues){
-                    const issuePath = issue.path.length > 0 ? issue.path : "root";
-                    logger_logger.error(`  - ${issuePath}: ${issue.message}`);
-                }
-            }
-            process.exitCode = 1;
+            if (pathStat.isDirectory()) return void handleValidateDirectory(file);
+            handleValidateFile(file);
         });
         if (watchCommand) {
             const watchOptions = watchCommand.options.map((opt)=>{