@hitch42/applet 0.1.1-beta.19 → 0.1.1-beta.21

package/dist/{markdown-CwlqzBtP.js → markdown-BA_XzFxq.js}

@@ -1,8 +1,8 @@
-import { n as cachedDownloadUrl, r as invalidateDownloadUrl, t as HITCH_FILE_PREFIX } from "./hitch-file-url-BPKj9zVG.js";
+import { n as cachedDownloadUrl, r as invalidateDownloadUrl, t as HITCH_FILE_PREFIX } from "./hitch-file-url--AMjDOzP.js";
 import { useEffect, useMemo, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 import { Streamdown, defaultRehypePlugins, defaultUrlTransform } from "streamdown";
-//#region src/react/markdown.tsx
+// src/react/markdown.tsx
 function withHitchFileProtocol() {
 	const sanitize = defaultRehypePlugins.sanitize;
 	if (!Array.isArray(sanitize)) throw new Error("streamdown's default sanitize plugin is no longer [plugin, schema].");
@@ -84,5 +84,4 @@ function Markdown({ children, files, className }) {
 		children
 	});
 }
-//#endregion
 export { Markdown as t };

package/dist/{markdown-DSHOQIOb.d.ts → markdown-BXt65dDo.d.ts}

@@ -1,6 +1,5 @@
-import { a as UploadedHitchFile } from "./upload-D_kkmne_.js";
+import { a as UploadedHitchFile } from "./upload-DXZyjZSS.js";
 import { ReactElement } from "react";
-//#region src/react/markdown.d.ts
 type MarkdownFiles = {
   download: (id: string) => Promise<Pick<UploadedHitchFile, "downloadUrl">>;
 };
@@ -10,5 +9,4 @@ type MarkdownProps = {
   className?: string;
 };
 declare function Markdown({ children, files, className }: MarkdownProps): ReactElement;
-//#endregion
 export { MarkdownFiles as n, MarkdownProps as r, Markdown as t };

package/dist/{markdown-editor-BmEaBzd7.d.ts → markdown-editor-CB_nWLzj.d.ts}

@@ -1,13 +1,10 @@
-import { a as UploadedHitchFile } from "./upload-D_kkmne_.js";
+import { a as UploadedHitchFile } from "./upload-DXZyjZSS.js";
 import { ReactElement } from "react";
 import "@tiptap/core";
-//#region src/react/markdown-editor-extensions.d.ts
 type MarkdownEditorFiles = {
   upload: (file: File) => Promise<Pick<UploadedHitchFile, "id" | "downloadUrl">>;
   download: (id: string) => Promise<Pick<UploadedHitchFile, "downloadUrl">>;
 };
-//#endregion
-//#region src/react/markdown-editor.d.ts
 type MarkdownEditorProps = {
   value: string;
   onChange: (value: string) => void;
@@ -23,5 +20,4 @@ type MarkdownEditorProps = {
   onUploadError?: (error: unknown, file: File) => void;
 };
 declare function MarkdownEditor({ value, onChange, files, id, placeholder, required, minLength, maxLength, disabled, autoFocus, className, onUploadError }: MarkdownEditorProps): ReactElement;
-//#endregion
 export { MarkdownEditorProps as n, MarkdownEditorFiles as r, MarkdownEditor as t };

package/dist/{markdown-editor-C5mLHGqu.js → markdown-editor-CaUuphfc.js}

@@ -1,4 +1,4 @@
-import { i as seedDownloadUrl, n as cachedDownloadUrl, r as invalidateDownloadUrl, t as HITCH_FILE_PREFIX } from "./hitch-file-url-BPKj9zVG.js";
+import { i as seedDownloadUrl, n as cachedDownloadUrl, r as invalidateDownloadUrl, t as HITCH_FILE_PREFIX } from "./hitch-file-url--AMjDOzP.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { BetweenHorizontalEnd, BetweenVerticalEnd, Bold, Code, Heading, Italic, Link, List, ListMinus, ListOrdered, ListTodo, Quote, Strikethrough, Table, Trash2, X } from "lucide-react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -14,7 +14,7 @@ import { Table as Table$1, TableCell, TableHeader, TableRow, renderTableToMarkdo
 import { Placeholder } from "@tiptap/extensions";
 import { Markdown } from "@tiptap/markdown";
 import StarterKit from "@tiptap/starter-kit";
-//#region src/react/markdown-editor-extensions.tsx
+// src/react/markdown-editor-extensions.tsx
 function sanitizeAltText(text) {
 	return text.replaceAll(/[[\]()\\]/g, "").replaceAll(/\s+/g, " ");
 }
@@ -109,8 +109,7 @@ function markdownEditorExtensions(files, placeholder = "") {
 	}));
 	return extensions;
 }
-//#endregion
-//#region src/react/markdown-editor.tsx
+// src/react/markdown-editor.tsx
 const buttonClassName = "inline-flex size-7 shrink-0 items-center justify-center rounded-2xl border border-transparent text-muted-foreground outline-none transition-all select-none hover:bg-muted hover:text-foreground focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/30 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0";
 const editorClassName = "min-h-32 w-full px-2.5 py-2 text-base md:text-sm outline-none whitespace-pre-wrap space-y-4 [&>*:first-child]:mt-0 [&>*:last-child]:mb-0 [&_h1]:mt-6 [&_h1]:mb-2 [&_h1]:font-semibold [&_h1]:text-3xl [&_h2]:mt-6 [&_h2]:mb-2 [&_h2]:font-semibold [&_h2]:text-2xl [&_h3]:mt-6 [&_h3]:mb-2 [&_h3]:font-semibold [&_h3]:text-xl [&_h4]:mt-6 [&_h4]:mb-2 [&_h4]:font-semibold [&_h4]:text-lg [&_h5]:mt-6 [&_h5]:mb-2 [&_h5]:font-semibold [&_h5]:text-base [&_h6]:mt-6 [&_h6]:mb-2 [&_h6]:font-semibold [&_h6]:text-sm [&_ul]:list-disc [&_ul]:pl-5 [&_ol]:list-decimal [&_ol]:pl-5 [&_blockquote]:my-4 [&_blockquote]:border-l-4 [&_blockquote]:border-muted-foreground/30 [&_blockquote]:pl-4 [&_blockquote]:text-muted-foreground [&_blockquote]:italic [&_code]:rounded [&_code]:bg-muted [&_code]:px-1.5 [&_code]:py-0.5 [&_code]:font-mono [&_code]:text-sm [&_pre]:overflow-x-auto [&_pre]:rounded-md [&_pre]:border [&_pre]:border-border [&_pre]:bg-background [&_pre]:p-4 [&_pre]:text-sm [&_pre_code]:bg-transparent [&_pre_code]:p-0 [&_a]:font-medium [&_a]:text-primary [&_a]:underline [&_a]:wrap-anywhere [&_hr]:my-4 [&_hr]:border-border [&_table]:my-4 [&_table]:w-full [&_table]:border-collapse [&_th]:border [&_th]:border-border [&_th]:px-4 [&_th]:py-2 [&_th]:text-left [&_th]:font-semibold [&_th]:text-sm [&_td]:border [&_td]:border-border [&_td]:px-4 [&_td]:py-2 [&_td]:text-sm [&_ul[data-type=taskList]]:list-none [&_ul[data-type=taskList]]:pl-0 [&_li[data-type=taskItem]]:flex [&_li[data-type=taskItem]]:items-start [&_li[data-type=taskItem]]:gap-2 [&_li[data-type=taskItem]>div]:flex-1 [&_p.is-editor-empty:first-child]:before:content-[attr(data-placeholder)] [&_p.is-editor-empty:first-child]:before:float-left [&_p.is-editor-empty:first-child]:before:h-0 [&_p.is-editor-empty:first-child]:before:pointer-events-none [&_p.is-editor-empty:first-child]:before:text-muted-foreground";
 function findImage(view, src) {
@@ -424,5 +423,4 @@ function MarkdownEditor({ value, onChange, files, id, placeholder, required, min
 		]
 	});
 }
-//#endregion
 export { MarkdownEditor as t };

package/dist/parent-D52Kxp8U.js

@@ -0,0 +1 @@
+export { i as runParent } from "./parent-Zx8Eg1Ki.js";

package/dist/parent-Zx8Eg1Ki.js

@@ -0,0 +1,75 @@
+import { r as writeGeneratedAgents } from "./generated-agents-BUnJ0FQA.js";
+import { a as findWorkspaceRoot, o as isRootLayout, r as findParentRoot } from "./workspace-CtIKSgMD.js";
+import { n as gitEnvironment } from "./source-hash-BbvtRaus.js";
+import { existsSync } from "node:fs";
+import { readdir, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { spawn } from "node:child_process";
+// src/git-local.ts
+async function gitLocal(root, args, input, environment) {
+	return new Promise((resolveCommand, reject) => {
+		const child = spawn("git", args, {
+			cwd: root,
+			env: {
+				...gitEnvironment(),
+				...environment,
+				GIT_TERMINAL_PROMPT: "0"
+			},
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		});
+		const stdout = [];
+		const stderr = [];
+		child.stdout.on("data", (chunk) => stdout.push(chunk));
+		child.stderr.on("data", (chunk) => stderr.push(chunk));
+		child.once("error", reject);
+		child.stdin.once("error", reject);
+		child.once("close", (code) => {
+			if (code === 0) resolveCommand(Buffer.concat(stdout));
+			else reject(/* @__PURE__ */ new Error(`git ${args[0]} failed: ${Buffer.concat(stderr).toString("utf8").trim()}`));
+		});
+		child.stdin.end(input);
+	});
+}
+// src/parent.ts
+var ParentError = class extends Error {};
+async function childApplets(root) {
+	return (await readdir(root, { withFileTypes: true })).filter((entry) => entry.isDirectory() && isRootLayout(resolve(root, entry.name))).map((entry) => resolve(root, entry.name)).sort();
+}
+function selectParentDeploy(input) {
+	return input.dirty || !input.hasMain || input.ahead;
+}
+async function childHasChanges(root) {
+	const dirty = (await gitLocal(root, ["status", "--porcelain"])).length > 0;
+	const hasMain = (await gitLocal(root, [
+		"for-each-ref",
+		"--format=%(refname)",
+		"refs/remotes/hitch/main"
+	])).length > 0;
+	return selectParentDeploy({
+		dirty,
+		hasMain,
+		ahead: hasMain && (await gitLocal(root, [
+			"rev-list",
+			"HEAD",
+			"--not",
+			"refs/remotes/hitch/main"
+		])).length > 0
+	});
+}
+function assertOutsideRepository(root) {
+	if (existsSync(resolve(root, ".git"))) throw new ParentError("A Hitch parent must not be inside a git repo.");
+	if (dirname(root) !== root) assertOutsideRepository(dirname(root));
+}
+async function runParent() {
+	const root = process.cwd();
+	if (findWorkspaceRoot(root) !== void 0 || findParentRoot(root) !== void 0) throw new ParentError("Run applet parent outside an applet or another parent.");
+	assertOutsideRepository(resolve(root));
+	await writeFile(resolve(root, ".hitchroot"), "", { flag: "wx" });
+	await writeGeneratedAgents(root);
+	console.log(`Created Hitch parent ${root}. Each child folder holds one applet repo.`);
+}
+export { selectParentDeploy as a, runParent as i, childApplets as n, gitLocal as o, childHasChanges as r, ParentError as t };

package/dist/{project-CWVwic2C.js → project-DZGk765E.js}

@@ -1,12 +1,13 @@
-import { a as organizationInstanceUrl, n as DEFAULT_INSTANCE_URL } from "./store-B8N_8JIN.js";
-import { n as readWorkspaceConfig } from "./workspace-8yqXsvce.js";
-import { n as loadAppletSourceDefinition } from "./load-config-BYrBjPlr.js";
+import { r as writeGeneratedAgents, t as GENERATED_SKILLS } from "./generated-agents-BUnJ0FQA.js";
+import { l as organizationInstanceUrl, n as DEFAULT_INSTANCE_URL } from "./store-E5NhITHl.js";
+import { a as findWorkspaceRoot, n as findAppletRoot, o as isRootLayout, s as readWorkspaceConfig } from "./workspace-CtIKSgMD.js";
+import { n as loadAppletSourceDefinition, r as appletMountPath } from "./load-config-Cffvj-aM.js";
 import { z } from "zod";
 import { existsSync } from "node:fs";
-import { cp, mkdir, readFile, readdir, rm, symlink, writeFile } from "node:fs/promises";
+import { cp, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { dirname, relative, resolve } from "node:path";
 import { TomlError, parse, stringify } from "smol-toml";
-//#region src/agent-support.ts
+// src/agent-support.ts
 var AgentConfigError = class extends Error {};
 async function ensureAgentConfigs(root, org) {
 	const servers = {
@@ -67,8 +68,7 @@ async function ensureAgentConfigs(root, org) {
 	await mkdir(resolve(root, ".codex"), { recursive: true });
 	await Promise.all(configs.filter((config) => config !== void 0).map(({ path, contents }) => writeFile(path, contents)));
 }
-//#endregion
-//#region src/project.ts
+// src/project.ts
 const PACKAGE_MANAGER = "pnpm@11.18.0+sha512.33d83c77da82f49fba836925c6f1b841181ec3132b670639bd012f7075f5c7cf634c5f870147c19aae7478fac01df09d8892e880454896edd23ee9b33757563c";
 const cliManifestValueSchema = z.string().min(1, "must be a non-empty string");
 const cliManifestSchema = z.object({
@@ -115,22 +115,29 @@ const cliManifestSchema = z.object({
 		typescript: cliManifestValueSchema
 	})
 });
-async function loadCliManifest(options) {
+async function loadPackageManifest() {
 	const result = cliManifestSchema.safeParse(JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")));
 	if (!result.success) {
 		const issue = result.error.issues.at(0);
 		if (issue === void 0) throw new Error("Invalid CLI package manifest.");
 		throw new Error(`Invalid CLI package manifest field "${issue.path.join(".")}": ${issue.message}.`);
 	}
-	const catalogEntry = [...Object.entries(result.data.dependencies).map(([name, value]) => [`dependencies.${name}`, value]), ...Object.entries(result.data.peerDependencies).map(([name, value]) => [`peerDependencies.${name}`, value])].find(([, value]) => value.startsWith("catalog:"));
+	return result.data;
+}
+async function userAgent() {
+	return `hitch-applet-sdk/${(await loadPackageManifest()).version}`;
+}
+async function loadCliManifest(options) {
+	const cli = await loadPackageManifest();
+	const catalogEntry = [...Object.entries(cli.dependencies).map(([name, value]) => [`dependencies.${name}`, value]), ...Object.entries(cli.peerDependencies).map(([name, value]) => [`peerDependencies.${name}`, value])].find(([, value]) => value.startsWith("catalog:"));
 	if (catalogEntry !== void 0) {
 		if (options?.allowDevelopment === true) return void 0;
 		throw new Error(`Invalid CLI package manifest field "${catalogEntry[0]}": "catalog:" identifies an unpublished development build. Run the published @hitch42/applet CLI instead.`);
 	}
-	return result.data;
+	return cli;
 }
-function assertWorkspaceCli(config, cli) {
-	const runningCli = `${cli.name}@${cli.version}`;
+function assertWorkspaceCli(config, cli, rootLayout = false) {
+	const runningCli = `${rootLayout ? "@hitch42/applet" : cli.name}@${cli.version}`;
 	if (config.sdk !== runningCli) throw new Error(`This workspace requires ${config.sdk}, but this command uses ${runningCli}. Run pnpm dlx ${config.sdk} bootstrap.`);
 }
 function workspacePackage(org) {
@@ -255,12 +262,12 @@ const oxlintConfigFile = (publicOverrides = "") => `{
 async function oxlintConfig(root) {
 	const appletsRoot = resolve(root, "applets");
 	const applets = existsSync(appletsRoot) ? await readdir(appletsRoot, { withFileTypes: true }) : [];
-	const publicApplets = (await Promise.all(applets.filter((applet) => applet.isDirectory() && existsSync(resolve(appletsRoot, applet.name, "applet.manifest.ts"))).map(async (applet) => {
+	const publicApplets = isRootLayout(root) ? (await loadAppletSourceDefinition(root)).public === true ? ["."] : [] : (await Promise.all(applets.filter((applet) => applet.isDirectory() && existsSync(resolve(appletsRoot, applet.name, "applet.manifest.ts"))).map(async (applet) => {
 		return (await loadAppletSourceDefinition(resolve(appletsRoot, applet.name))).public === true ? applet.name : null;
 	}))).filter((code) => code !== null).sort();
 	return oxlintConfigFile(publicApplets.map((name) => `,
     {
-      "files": [${JSON.stringify(`applets/${name}/**`)}],
+      "files": [${JSON.stringify(name === "." ? "**" : `applets/${name}/**`)}],
       "rules": {
         "eslint/no-restricted-imports": [
           "error",
@@ -297,18 +304,10 @@ async function oxfmtConfig(root) {
 }
 const GITIGNORE_START = "# BEGIN Hitch generated files";
 const GITIGNORE_END = "# END Hitch generated files";
-const SKILLS = [
-	"hitch-applets",
-	"hitch-cli",
-	"hitch-data",
-	"hitch-theory",
-	"react-best-practices",
-	"tanstack-query",
-	"tanstack-router",
-	"web-design-guidelines"
-];
+const SKILLS = GENERATED_SKILLS;
 const GITIGNORE = `${GITIGNORE_START}
-${SKILLS.map((skill) => `/.agents/skills/${skill}/`).join("\n")}
+/.agents/.hitch-generated.json
+${SKILLS.map((skill) => `/.agents/skills/${skill}`).join("\n")}
 ${SKILLS.map((skill) => `/.claude/skills/${skill}`).join("\n")}
 /.node-version
 /.oxfmtrc.json
@@ -330,12 +329,18 @@ ${SKILLS.map((skill) => `/.claude/skills/${skill}`).join("\n")}
 **/.wrangler/
 **/dist/
 **/node_modules/
+.env
+.env.*
+!.env.example
+.dev.vars
+.dev.vars.*
 ${GITIGNORE_END}
 `;
-async function writeGitignore(root) {
+async function writeGitignore(root, rootLayout = isRootLayout(root)) {
+	const generated = rootLayout ? GITIGNORE.replaceAll("/applets/**/", "/").replace("/pnpm-workspace.yaml", "/pnpm-workspace.yaml\n/.hitch-backup/") : GITIGNORE;
 	const path = resolve(root, ".gitignore");
 	if (!existsSync(path)) {
-		await writeFile(path, `${GITIGNORE}\n# Add custom rules below.\n`);
+		await writeFile(path, `${generated}\n# Add custom rules below.\n`);
 		return;
 	}
 	const current = await readFile(path, "utf8");
@@ -343,52 +348,51 @@ async function writeGitignore(root) {
 	const end = current.indexOf(GITIGNORE_END, start);
 	if (start >= 0 && end >= 0) {
 		const suffix = current.slice(end + 27).replace(/^\r?\n/, "");
-		await writeFile(path, `${current.slice(0, start)}${GITIGNORE}${suffix}`);
+		await writeFile(path, `${current.slice(0, start)}${generated}${suffix}`);
 		return;
 	}
-	await writeFile(path, `${GITIGNORE}\n${current}`);
+	await writeFile(path, `${generated}\n${current}`);
+}
+async function writeRootSupport(root, definition, cli) {
+	const config = readWorkspaceConfig(root);
+	if (config === void 0) throw new Error(`No applet at ${root}.`);
+	assertWorkspaceCli(config, cli, true);
+	await writeWorkspaceSupport(root, config, cli);
+	await writeAppletSupport(root, definition);
 }
 async function writeWorkspaceSupport(root, config, cli) {
 	const resolvedCli = cli ?? await loadCliManifest();
 	if (resolvedCli === void 0) throw new Error("The CLI package manifest is not published.");
-	assertWorkspaceCli(config, resolvedCli);
+	assertWorkspaceCli(config, resolvedCli, isRootLayout(root));
 	await ensureAgentConfigs(root, config.org);
 	const deployWorkflowTarget = resolve(root, ".github/workflows/hitch.yml");
-	const agents = await readFile(new URL("../scaffold/AGENTS.md", import.meta.url), "utf8");
+	const rootLayout = isRootLayout(root);
 	const [lintConfig, formatConfig] = await Promise.all([oxlintConfig(root), oxfmtConfig(root)]);
+	if (config.githubWorkflow !== false) await mkdir(resolve(root, ".github/workflows"), { recursive: true });
 	await Promise.all([
-		mkdir(resolve(root, ".agents/skills"), { recursive: true }),
-		mkdir(resolve(root, ".claude/skills"), { recursive: true }),
-		config.githubWorkflow === false ? void 0 : mkdir(resolve(root, ".github/workflows"), { recursive: true }),
-		...SKILLS.map((skill) => rm(resolve(root, ".agents/skills", skill), {
-			force: true,
-			recursive: true
-		}))
-	]);
-	await Promise.all([
-		...SKILLS.map((skill) => cp(new URL(`../scaffold/.agents/skills/${skill}`, import.meta.url), resolve(root, ".agents/skills", skill), { recursive: true })),
+		writeGeneratedAgents(root),
 		writeFile(resolve(root, "package.json"), `${JSON.stringify(workspacePackage(config.org), null, 2)}\n`),
-		writeFile(resolve(root, "pnpm-workspace.yaml"), workspaceFile(resolvedCli)),
+		writeFile(resolve(root, "pnpm-workspace.yaml"), rootLayout ? workspaceFile({
+			...resolvedCli,
+			name: "@hitch42/applet"
+		}).replace("  - applets/*", "  - .") : workspaceFile(resolvedCli)),
 		config.githubWorkflow === false || existsSync(deployWorkflowTarget) ? void 0 : cp(new URL("../scaffold/.github/workflows/hitch.yml", import.meta.url), deployWorkflowTarget),
 		writeFile(resolve(root, ".node-version"), "24\n"),
-		writeFile(resolve(root, ".oxlintrc.json"), lintConfig),
-		writeFile(resolve(root, ".oxfmtrc.json"), formatConfig),
-		writeGitignore(root),
-		writeFile(resolve(root, "AGENTS.md"), agents)
+		writeFile(resolve(root, ".oxlintrc.json"), rootLayout ? lintConfig.replaceAll("applets/*/", "") : lintConfig),
+		writeFile(resolve(root, ".oxfmtrc.json"), rootLayout ? `${JSON.stringify({
+			$schema: "./node_modules/oxfmt/configuration_schema.json",
+			sortImports: true,
+			...existsSync(resolve(root, "src/client/styles/globals.css")) ? { sortTailwindcss: { stylesheet: "./src/client/styles/globals.css" } } : {}
+		}, null, 2)}\n` : formatConfig),
+		writeGitignore(root)
 	]);
-	await rm(resolve(root, "CLAUDE.md"), { force: true });
-	await symlink("AGENTS.md", resolve(root, "CLAUDE.md"));
-	await Promise.all(SKILLS.map(async (skill) => {
-		const target = resolve(root, ".claude/skills", skill);
-		await rm(target, { force: true });
-		await symlink(`../../.agents/skills/${skill}`, target, "dir");
-	}));
 }
 function sortedByName(packages) {
 	return Object.fromEntries(Object.entries(packages).sort(([a], [b]) => a < b ? -1 : 1));
 }
 function appletPackage(definition, options) {
 	return {
+		...options.rootLayout ? { packageManager: PACKAGE_MANAGER } : {},
 		name: definition.code.replaceAll("_", "-"),
 		private: true,
 		type: "module",
@@ -434,6 +438,11 @@ function appletPackage(definition, options) {
 			...definition.dependencies
 		}),
 		devDependencies: sortedByName({
+			...options.rootLayout ? {
+				oxfmt: "catalog:",
+				oxlint: "catalog:",
+				"oxlint-tsgolint": "catalog:"
+			} : {},
 			"@types/node": "catalog:",
 			typescript: "catalog:",
 			vite: "catalog:",
@@ -461,6 +470,7 @@ async function replaceLegacyCnHelper(root) {
 	await cp(new URL("../scaffold/applet/src/client/lib/utils.ts", import.meta.url), path);
 }
 async function writeAppletSupport(root, definition) {
+	if (isRootLayout(root)) await writeGeneratedAgents(root);
 	const hasClient = existsSync(resolve(root, "src/client/routes"));
 	const hasAuthorRoot = existsSync(resolve(root, "src/client/routes/__root.tsx"));
 	const hasServer = existsSync(resolve(root, "src/server/main.ts"));
@@ -471,7 +481,8 @@ async function writeAppletSupport(root, definition) {
 		replaceLegacyCnHelper(root),
 		writeFile(resolve(root, "package.json"), `${JSON.stringify(appletPackage(definition, {
 			hasClient,
-			hasServer
+			hasServer,
+			rootLayout: isRootLayout(root)
 		}), null, 2)}\n`),
 		writeFile(resolve(root, "vite.config.ts"), `import { resolve } from "node:path";
 
@@ -497,7 +508,7 @@ export default defineConfig({
 				children: [{
 					type: "physical",
 					directory: ".",
-					pathPrefix: definition.code
+					pathPrefix: appletMountPath(definition)
 				}]
 			}
 		}, null, 2)}\n`) : rm(resolve(root, "tsr.config.json"), { force: true }),
@@ -554,12 +565,17 @@ async function prepareAppletProjects(workspaceRoot, appletRoots) {
 	const workspace = readWorkspaceConfig(workspaceRoot);
 	if (workspace === void 0) throw new Error(`No Hitch workspace found at ${workspaceRoot}.`);
 	const cli = await loadCliManifest({ allowDevelopment: true });
+	if (isRootLayout(workspaceRoot)) {
+		if (cli === void 0) await writeAppletSupport(workspaceRoot, definitions[0]);
+		else await writeRootSupport(workspaceRoot, definitions[0], cli);
+		return;
+	}
 	await Promise.all([cli === void 0 ? void 0 : writeWorkspaceSupport(workspaceRoot, workspace, cli), ...appletRoots.map((root, index) => writeAppletSupport(root, definitions[index]))]);
 }
 async function prepareAppletProject(appletRoot = process.cwd()) {
-	const workspaceRoot = dirname(dirname(resolve(appletRoot)));
+	appletRoot = findAppletRoot(appletRoot) ?? resolve(appletRoot);
+	const workspaceRoot = findWorkspaceRoot(appletRoot) ?? dirname(dirname(appletRoot));
 	await prepareAppletProjects(workspaceRoot, [appletRoot]);
 	return workspaceRoot;
 }
-//#endregion
-export { writeAppletSupport as a, prepareAppletProjects as i, loadCliManifest as n, writeWorkspaceSupport as o, prepareAppletProject as r, assertWorkspaceCli as t };
+export { prepareAppletProjects as a, writeGitignore as c, prepareAppletProject as i, writeRootSupport as l, loadCliManifest as n, userAgent as o, loadPackageManifest as r, writeAppletSupport as s, assertWorkspaceCli as t, writeWorkspaceSupport as u };

package/dist/{prompt-ChS-grYO.js → prompt-CW98R-Un.js}

@@ -1,6 +1,6 @@
 import { Writable } from "node:stream";
 import { createInterface } from "node:readline";
-//#region src/prompt.ts
+// src/prompt.ts
 function question(prompt, hidden = false) {
 	return new Promise((resolveAnswer, rejectAnswer) => {
 		let muted = false;
@@ -25,5 +25,4 @@ function question(prompt, hidden = false) {
 		});
 	});
 }
-//#endregion
 export { question as t };

package/dist/{query-cache-CXmAyLv3.js → query-cache-DQJy45RT.js}

@@ -1,4 +1,4 @@
-//#region src/internal/query-cache.ts
+// src/internal/query-cache.ts
 const STORE = "clients";
 const TIMESTAMP_INDEX = "timestamp";
 const TAB_KEY = "hitch:query-tab";
@@ -78,5 +78,4 @@ function sweepExpiredQueryCaches(maxAge) {
 function clearAppletQueryCaches(appletCode) {
 	return inStore("readwrite", (store) => store.delete(IDBKeyRange.bound(`${appletCode}:`, `${appletCode}:\uffff`)));
 }
-//#endregion
 export { openQueryCacheDatabase as a, openCacheDatabase as i, clearAppletQueryCaches as n, sweepExpiredQueryCaches as o, indexedDbPersister as r, cacheTabId as t };

package/dist/{query-utils-zz9pVjgp.d.ts → query-utils-okxIoKM3.d.ts}

@@ -1,6 +1,5 @@
 import { NestedClient } from "@orpc/client";
 import { RouterUtils } from "@orpc/tanstack-query";
-//#region src/query-utils.d.ts
 type Exact<Expected, Actual> = Actual extends symbol ? Actual : Actual extends Expected ? Actual extends readonly unknown[] ? Actual : Actual extends object ? NonNullable<Expected> extends object ? { [Key in keyof Actual]: Key extends keyof NonNullable<Expected> ? Exact<NonNullable<Expected>[Key], Actual[Key]> : never; } : Actual : Actual : never;
 type QueryOptionsFunction<Utils> = Extract<Utils extends {
   queryOptions: infer Function;
@@ -21,5 +20,4 @@ type ClientTree = NestedClient<Record<never, never>>;
 type ExactRouterUtils<Client extends ClientTree> = Client extends ((...args: infer Arguments) => unknown) ? Omit<RouterUtils<Client>, "queryOptions"> & {
   queryOptions: ExactQueryOptions<RouterUtils<Client>, Arguments[0]>;
 } : Omit<RouterUtils<Client>, keyof Client> & { [Key in keyof Client]: Client[Key] extends ClientTree ? ExactRouterUtils<Client[Key]> : never; };
-//#endregion
 export { ExactRouterUtils as t };

package/dist/{schedules-B7xNl9oy.js → schedules-CSUb84e2.js}

@@ -1,9 +1,10 @@
-import { t as loadAppletConfig } from "./load-config-BYrBjPlr.js";
-import { t as question } from "./prompt-ChS-grYO.js";
+import { n as findAppletRoot } from "./workspace-CtIKSgMD.js";
+import { t as loadAppletConfig } from "./load-config-Cffvj-aM.js";
+import { t as question } from "./prompt-CW98R-Un.js";
 import { RPCLink } from "@orpc/client/fetch";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
-//#region src/schedules.ts
+// src/schedules.ts
 async function runSchedule(options) {
 	const manifest = await loadAppletConfig(process.cwd());
 	const schedules = manifest.schedules ?? [];
@@ -13,7 +14,7 @@ async function runSchedule(options) {
 	const unavailable = "The dev server is not running. Start it with pnpm dev.";
 	let url;
 	try {
-		const file = JSON.parse(await readFile(resolve(process.cwd(), ".hitch/dev-server.json"), "utf8"));
+		const file = JSON.parse(await readFile(resolve(findAppletRoot(process.cwd()) ?? process.cwd(), ".hitch/dev-server.json"), "utf8"));
 		if (file === null || typeof file !== "object" || !("url" in file) || typeof file.url !== "string" || !("pid" in file) || typeof file.pid !== "number" || !Number.isInteger(file.pid) || file.pid < 1) throw new Error(unavailable);
 		try {
 			process.kill(file.pid, 0);
@@ -38,5 +39,4 @@ async function runSchedule(options) {
 	});
 	console.log(`Schedule "${options.code}" finished.`);
 }
-//#endregion
 export { runSchedule };

package/dist/server.d.ts

@@ -1,10 +1,9 @@
-import { a as createWorkflow, i as WorkflowStep, n as WorkflowDefinition, r as WorkflowDuration } from "./workflow-DurM6Fwx.js";
-import { l as RegisteredContract, m as RegisteredWorkflows, p as RegisteredVariables, u as RegisteredManifest } from "./manifest-BBHD_EY9.js";
-import { t as NarrowContract } from "./contract-CJv-n1l3.js";
-import { t as WithBatchRecorder } from "./batch-Qa4B4-Yp.js";
-import { o as WithFilesUpload } from "./upload-D_kkmne_.js";
+import { a as createWorkflow, i as WorkflowStep, n as WorkflowDefinition, r as WorkflowDuration } from "./workflow-BnBrJIzu.js";
+import { l as RegisteredContract, m as RegisteredWorkflows, p as RegisteredVariables, u as RegisteredManifest } from "./manifest-CpghlaJc.js";
+import { t as NarrowContract } from "./contract-CUc0B2rl.js";
+import { i as WithBatchRecorder, n as WithRecordCreates } from "./create-BJqLT8Uq.js";
+import { o as WithFilesUpload } from "./upload-DXZyjZSS.js";
 import { ContractRouterClient } from "@orpc/contract";
-//#region src/server/workflows-client.d.ts
 type WorkflowRunStatus<Result> = {
   id: string;
   workflow: string;
@@ -26,8 +25,6 @@ type WorkflowsClient<Workflows> = { [Code in keyof Workflows]: Workflows[Code] e
     limit?: number;
   }): Promise<WorkflowRunSummary[]>;
 } : never; };
-//#endregion
-//#region src/server/env.d.ts
 type AppletEnv<Variables extends AppletManifestVariables = RegisteredVariables> = { readonly [Key in keyof Variables]: Variables[Key] extends {
   optional: true;
 } ? string | undefined : string; };
@@ -35,20 +32,15 @@ type AppletManifestVariables = Readonly<Record<string, {
   optional?: boolean;
 }>>;
 declare const env: AppletEnv;
-//#endregion
-//#region src/server/log.d.ts
 declare const log: {
   set(fields: Record<string, unknown>): void;
 };
-//#endregion
-//#region src/author/server.d.ts
 type AuthorContract = NarrowContract<RegisteredContract, RegisteredManifest>;
-type AuthorHitchClient = WithBatchRecorder<ContractRouterClient<AuthorContract>>;
+type AuthorHitchClient = WithRecordCreates<WithBatchRecorder<ContractRouterClient<AuthorContract>>>;
 type AuthorHitch = WithFilesUpload<AuthorHitchClient> & (RegisteredManifest extends {
   public: true;
 } ? {} : {
   workflows: WorkflowsClient<RegisteredWorkflows>;
 });
 declare const hitch: AuthorHitch;
-//#endregion
 export { type AppletEnv, type WorkflowDefinition, type WorkflowDuration, type WorkflowStep, createWorkflow, env, hitch, log };

package/dist/server.js

@@ -1,12 +1,12 @@
-import { n as withFilesUpload, r as getRegisteredHitchContract } from "./upload-DRbVhuDm.js";
-import { t as HITCH_APPLET_CODE_HEADER } from "./headers-CeRX-Xji.js";
-import { a as getRequestContext, i as getIdentityBearer, n as createWorkflow, s as tryGetRequestContext } from "./workflow-CTo2kZF1.js";
-import { s as publishNote, t as APP_CONTEXT_CHANNEL } from "./log-context-DWznGjfz.js";
-import { t as withBatchRecorder } from "./batch-_ZjAg-Kk.js";
-import { t as createLazyClientProxy } from "./lazy-client-CwIzYAoE.js";
+import { n as withFilesUpload, r as getRegisteredHitchContract } from "./upload-DtMavo8Q.js";
+import { t as HITCH_APPLET_CODE_HEADER } from "./headers-BcEMIVCo.js";
+import { a as getRequestContext, i as getIdentityBearer, n as createWorkflow, s as tryGetRequestContext } from "./workflow-l2SlVePB.js";
+import { s as publishNote, t as APP_CONTEXT_CHANNEL } from "./log-context-BepwdjrR.js";
+import { t as withBatchRecorder } from "./batch-CiLZ177G.js";
+import { t as createLazyClientProxy } from "./lazy-client--QCL0wiu.js";
 import { createORPCClient } from "@orpc/client";
 import { OpenAPILink } from "@orpc/openapi-client/fetch";
-//#region src/hitch/server.ts
+// src/hitch/server.ts
 const DEFAULT_API_URL = "https://app.hitch42.com";
 const resolveTransport = () => {
 	const context = tryGetRequestContext();
@@ -42,8 +42,7 @@ function createHitchClient(contract) {
 		headers: () => resolveTransport().headers
 	}));
 }
-//#endregion
-//#region src/server/workflows-client.ts
+// src/server/workflows-client.ts
 function mapWorkflowRun(data) {
 	const { sleep_until: sleepUntil, started_at: startedAt, finished_at: finishedAt, ...run } = data;
 	return {
@@ -67,7 +66,7 @@ function createWorkflowsClient() {
 		return {
 			async start(payload) {
 				const context = getRequestContext();
-				return { id: (await getResponseData(await context.api.fetch(`${context.api.baseUrl}/v1/applets/${encodeURIComponent(context.appletCode)}/workflows/${encodeURIComponent(code)}/runs`, {
+				return { id: (await getResponseData(await context.api.fetch(`${context.api.baseUrl}/applet/v1/applets/${encodeURIComponent(context.appletCode)}/workflows/${encodeURIComponent(code)}/runs`, {
 					method: "POST",
 					headers: {
 						authorization: `Bearer ${getIdentityBearer(context.identity)}`,
@@ -78,17 +77,19 @@ function createWorkflowsClient() {
 			},
 			async get(id) {
 				const context = getRequestContext();
-				return mapWorkflowRun(await getResponseData(await context.api.fetch(`${context.api.baseUrl}/v1/applets/${encodeURIComponent(context.appletCode)}/workflows/${encodeURIComponent(code)}/runs/${encodeURIComponent(id)}`, {
+				const data = await getResponseData(await context.api.fetch(`${context.api.baseUrl}/applet/v1/applets/${encodeURIComponent(context.appletCode)}/workflow-runs/${encodeURIComponent(id)}`, {
 					method: "GET",
 					headers: { authorization: `Bearer ${getIdentityBearer(context.identity)}` }
-				}), "get"));
+				}), "get");
+				if (data.workflow !== code) throw new Error("Workflow get failed (404): workflow_run_not_found: The workflow run does not exist.");
+				return mapWorkflowRun(data);
 			},
 			async list(options) {
 				const context = getRequestContext();
 				const query = new URLSearchParams({ workflow: code });
 				if (options?.status !== void 0) query.set("status", options.status);
 				if (options?.limit !== void 0) query.set("limit", String(options.limit));
-				return (await getResponseData(await context.api.fetch(`${context.api.baseUrl}/v1/applets/${encodeURIComponent(context.appletCode)}/workflow-runs?${query}`, {
+				return (await getResponseData(await context.api.fetch(`${context.api.baseUrl}/applet/v1/applets/${encodeURIComponent(context.appletCode)}/workflow-runs?${query}`, {
 					method: "GET",
 					headers: { authorization: `Bearer ${getIdentityBearer(context.identity)}` }
 				}), "list")).map(mapWorkflowRun);
@@ -96,11 +97,9 @@ function createWorkflowsClient() {
 		};
 	} });
 }
-//#endregion
-//#region src/server/env.ts
+// src/server/env.ts
 const env = process.env;
-//#endregion
-//#region src/server/log.ts
+// src/server/log.ts
 const log = { set(fields) {
 	const context = tryGetRequestContext();
 	if (context === void 0) {
@@ -109,8 +108,7 @@ const log = { set(fields) {
 	}
 	publishNote(context.requestId, fields, APP_CONTEXT_CHANNEL);
 } };
-//#endregion
-//#region src/author/server.ts
+// src/author/server.ts
 function buildHitchClient() {
 	const contract = getRegisteredHitchContract();
 	if (contract === void 0) throw new Error("`hitch` is unavailable: run `applet generate` first. The framework imports your .hitch automatically at build; in plain node import your .hitch once before calling hitch.");
@@ -122,5 +120,4 @@ const workflows = createWorkflowsClient();
 const hitch = new Proxy(filesClient, { get(target, property, receiver) {
 	return property === "workflows" ? workflows : Reflect.get(target, property, receiver);
 } });
-//#endregion
 export { createWorkflow, env, hitch, log };