@keystrokehq/cli 0.1.22 → 0.1.25

package/dist/index.mjs

@@ -1,15 +1,14 @@
 #!/usr/bin/env node
-import { $ as HealthResponseSchema, $t as StartKeystrokeConnectionResultSchema, A as CreateCustomAppRequestSchema, An as WorkflowSummaryDetailResponseSchema, At as PresignChatAttachmentResponseSchema, B as CredentialConsumerListQuerySchema, Bn as detectProjectPackageManagerFromSnapshot, Bt as ProjectSettingsResponseSchema, C as ConnectAuthorizeUrlResponseSchema, Cn as UserAvatarPatchSchema, Ct as OpenApiDiscoverResponseSchema, D as CreateCredentialInstanceBodySchema, Dn as WorkflowRunDetailResponseSchema, Dt as PROJECT_REACHABILITY_REQUEST_TIMEOUT_MS, E as CreateApiKeyResponseSchema, En as UserPreferencesSchema, Et as PROJECT_PULL_STATE_RELATIVE_PATH, F as CreateProjectRequestSchema, Fn as WorkspaceTriggerOverviewSchema, Ft as PresignUserAvatarRequestSchema, G as DeclineOrganizationInvitationResponseSchema, Gn as parseAppSlug, Gt as QueuedAgentPromptResponseSchema, H as CredentialInstanceListResponseSchema, Hn as listenPortFromPublicUrl, Ht as PromptInputSchema, I as CreateProjectResponseSchema, In as WorkspaceTriggerRunListResponseSchema, It as PresignUserAvatarResponseSchema, J as ErrorResponseSchema, Jn as resolveConnectAppSlug, Jt as RecentResourceListResponseSchema, K as DownloadActiveProjectArtifactResponseSchema, Kn as parseErrorResponse, Kt as QueuedRunResponseSchema, L as CredentialAssignmentListQuerySchema, Ln as buildConnectDeeplink, Lt as ProjectPullStateSchema, M as CreateOrganizationRequestSchema, Mn as WorkspaceTriggerDetailSchema, Mt as PresignOrgLogoResponseSchema, N as CreateOrganizationResponseSchema, Nn as WorkspaceTriggerFileSchema, Nt as PresignProjectSourceRequestSchema, O as CreateCredentialsRequestSchema, On as WorkflowRunHooksResponseSchema, Ot as PollRunResponseSchema, P as CreateProjectArtifactResponseSchema, Pn as WorkspaceTriggerListResponseSchema, Pt as PresignProjectSourceResponseSchema, Q as GraphqlDiscoverResponseSchema, Qt as StartKeystrokeConnectionInputSchema, R as CredentialAssignmentListResponseSchema, Rt as ProjectReachabilityResponseSchema, S as CompleteProjectArtifactResponseSchema, Sn as UpsertGatewayAttachmentBodySchema, St as McpDiscoverResponseSchema, T as CreateApiKeyRequestSchema, Tn as UserPreferencesPatchSchema, Tt as OrganizationSidebarBrandingSchema, U as CredentialInstanceRecordSchema, Ut as PromptResponseSchema, V as CredentialConsumerListResponseSchema, Vn as isAcceptableInstallExit, Vt as ProjectSlugAvailabilityResponseSchema, X as GetCredentialResponseSchema, Xn as slugifyAppName, Xt as SkillSummaryListResponseSchema, Y as GatewayAttachmentRecordSchema, Yn as resolvePublicPlatformOrigin, Yt as SkillSummaryDetailResponseSchema, Z as GetCustomAppResponseSchema, Zt as SlugAvailabilityResponseSchema, _ as ChannelAccountListResponseSchema, _n as UpdateProjectMemberResponseSchema, _t as ListProjectDeploymentsResponseSchema, a as AgentSessionDetailResponseSchema, an as SubmitTeamRequestRequestSchema, at as InviteOrganizationMembersResponseSchema, b as ChannelDirectoryListResponseSchema, bn as UploadProjectSourceManifestRequestSchema, bt as ListProjectMetricsResponseSchema, c as AgentSummaryListResponseSchema, cn as TriggerRunDetailResponseSchema, d as AssignCredentialBodySchema, dn as UpdateCredentialInstanceBodySchema, dt as ListApiKeysResponseSchema, en as StartMcpOAuthConnectionInputSchema, et as HistoryRunCancelResponseSchema, f as BindChannelBodySchema, fn as UpdateCredentialRequestSchema, ft as ListAppsResponseSchema, g as CatalogAppsPageResponseSchema, gn as UpdateProjectMemberRequestSchema, gt as ListOrganizationsResponseSchema, h as CatalogAppDetailResponseSchema, hn as UpdateOrganizationRequestSchema, ht as ListOrganizationMembersResponseSchema, i as AgentSessionChatStateResponseSchema, in as SubmitMarketingContactRequestSchema, it as InviteOrganizationMembersRequestSchema, j as CreateCustomAppResponseSchema, jn as WorkflowSummaryListResponseSchema, jt as PresignOrgLogoRequestSchema, k as CreateCredentialsResponseSchema, kn as WorkflowRunListResponseSchema, kt as PresignChatAttachmentRequestSchema, l as AgentTriggerSummaryListResponseSchema, ln as TriggerRunListResponseSchema, lt as ListAgentMemoryFilesResponseSchema, m as CatalogActionsPageResponseSchema, mn as UpdateOrganizationMemberResponseSchema, mt as ListOrganizationInvitationsResponseSchema, n as AcceptOrganizationInvitationResponseSchema, nn as StartOAuthConnectionInputSchema, nt as HistoryRunListQuerySchema, o as AgentSessionListResponseSchema, on as TriggerDetailResponseSchema, ot as InviteProjectMembersRequestSchema, p as CatalogActionDetailResponseSchema, pn as UpdateOrganizationMemberRequestSchema, pt as ListCredentialsResponseSchema, q as DownloadActiveProjectSourceResponseSchema, r as ActiveOrganizationResponseSchema, rn as StartOAuthConnectionResultSchema, rt as HistoryRunListResponseSchema, s as AgentSummaryDetailResponseSchema, sn as TriggerListResponseSchema, st as InviteProjectMembersResponseSchema, t as ACTIVE_ORG_HEADER, tn as StartMcpOAuthConnectionResultSchema, tt as HistoryRunDetailResponseSchema, u as AppSlugAvailabilityResponseSchema, un as UpdateChannelBindingBodySchema, ut as ListAgentWorkspaceFilesResponseSchema, v as ChannelConnectionListResponseSchema, vn as UpdateProjectRequestSchema, vt as ListProjectFilesResponseSchema, w as ConnectProvidersResponseSchema, wn as UserAvatarSchema, wt as OrganizationSidebarBrandingPatchSchema, x as ChannelPlatformSchema, xn as UploadProjectSourceResponseSchema, xt as ListProjectsResponseSchema, y as ChannelConnectionSchema, yn as UpdateProjectSettingsRequestSchema, yt as ListProjectMembersResponseSchema, z as CredentialAssignmentRecordSchema, zn as deriveCustomAppDisplay, zt as ProjectResponseSchema } from "./dist-UdbUy9DM.mjs";
-import { a as installPlaygroundDependencies, c as createCliConfig, d as getEffectiveApiTarget, f as getPlatformUrl, g as resolvePlatformUrlForWebUrl, i as installDependencies$1, l as getCliConfigDir, m as DEFAULT_PLATFORM_URL, n as buildPlaygroundWorkspace, o as resolvePackageManager, p as getWebUrl, s as resolveCliRoot, t as readCliVersion, u as getConfigDir } from "./version-CUTRAMa8.mjs";
-import { n as mergeFilteredArtifact, r as packProjectArtifact, t as mapInParallelBatches } from "./dist-D8wvycYm.mjs";
+import { $ as GetCustomAppResponseSchema, $n as slugifyAppName, $t as SlugAvailabilityResponseSchema, A as CreateCustomAppRequestSchema, An as WorkflowRunHooksResponseSchema, At as PollRunResponseSchema, B as CredentialConsumerListQuerySchema, Bt as ProjectReachabilityResponseSchema, C as ConnectAuthorizeUrlResponseSchema, Cn as UploadProjectSourceResponseSchema, Ct as ListProjectsResponseSchema, D as CreateCredentialInstanceBodySchema, Dn as UserPreferencesPatchSchema, Dt as OrganizationSidebarBrandingSchema, E as CreateApiKeyResponseSchema, En as UserAvatarSchema, Et as OrganizationSidebarBrandingPatchSchema, F as CreateProjectRequestSchema, Fn as WorkspaceTriggerFileSchema, Ft as PresignProjectSourceRequestSchema, G as DOCS_QUERY_TOOL, Gt as PromptResponseSchema, H as CredentialInstanceListResponseSchema, Hn as detectProjectPackageManagerFromSnapshot, Ht as ProjectSettingsResponseSchema, I as CreateProjectResponseSchema, In as WorkspaceTriggerListResponseSchema, It as PresignProjectSourceResponseSchema, J as DownloadActiveProjectArtifactResponseSchema, Jn as parseErrorResponse, Jt as QueuedRunResponseSchema, K as DOCS_SEARCH_TOOL, L as CredentialAssignmentListQuerySchema, Ln as WorkspaceTriggerOverviewSchema, Lt as PresignUserAvatarRequestSchema, M as CreateOrganizationRequestSchema, Mn as WorkflowSummaryDetailResponseSchema, Mt as PresignChatAttachmentResponseSchema, N as CreateOrganizationResponseSchema, Nn as WorkflowSummaryListResponseSchema, Nt as PresignOrgLogoRequestSchema, O as CreateCredentialsRequestSchema, On as UserPreferencesSchema, Ot as PROJECT_PULL_STATE_RELATIVE_PATH, P as CreateProjectArtifactResponseSchema, Pn as WorkspaceTriggerDetailSchema, Pt as PresignOrgLogoResponseSchema, Q as GetCredentialResponseSchema, Qn as resolvePublicPlatformOrigin, Qt as SkillSummaryListResponseSchema, R as CredentialAssignmentListResponseSchema, Rn as WorkspaceTriggerRunListResponseSchema, Rt as PresignUserAvatarResponseSchema, S as CompleteProjectArtifactResponseSchema, Sn as UploadProjectSourceManifestRequestSchema, St as ListProjectMetricsResponseSchema, T as CreateApiKeyRequestSchema, Tn as UserAvatarPatchSchema, Tt as OpenApiDiscoverResponseSchema, U as CredentialInstanceRecordSchema, Un as isAcceptableInstallExit, Ut as ProjectSlugAvailabilityResponseSchema, V as CredentialConsumerListResponseSchema, Vn as deriveCustomAppDisplay, Vt as ProjectResponseSchema, Wn as listenPortFromPublicUrl, Wt as PromptInputSchema, X as ErrorResponseSchema, Xn as resolveConnectAppSlug, Xt as RecentResourceListResponseSchema, Y as DownloadActiveProjectSourceResponseSchema, Z as GatewayAttachmentRecordSchema, Zn as resolveDocsMcpUrl, Zt as SkillSummaryDetailResponseSchema, _ as ChannelAccountListResponseSchema, _n as UpdateOrganizationRequestSchema, _t as ListOrganizationMembersResponseSchema, a as AgentSessionDetailResponseSchema, an as StartOAuthConnectionResultSchema, at as HistoryRunListResponseSchema, b as ChannelDirectoryListResponseSchema, bn as UpdateProjectRequestSchema, bt as ListProjectFilesResponseSchema, c as AgentSummaryListResponseSchema, cn as TriggerDetailResponseSchema, ct as InviteProjectMembersRequestSchema, d as AssignCredentialBodySchema, dn as TriggerRunListResponseSchema, dt as ListAgentMemoryFilesResponseSchema, en as StartKeystrokeConnectionInputSchema, et as GraphqlDiscoverResponseSchema, f as BindChannelBodySchema, fn as UpdateChannelBindingBodySchema, ft as ListAgentWorkspaceFilesResponseSchema, g as CatalogAppsPageResponseSchema, gn as UpdateOrganizationMemberResponseSchema, gt as ListOrganizationInvitationsResponseSchema, h as CatalogAppDetailResponseSchema, hn as UpdateOrganizationMemberRequestSchema, ht as ListCredentialsResponseSchema, i as AgentSessionChatStateResponseSchema, in as StartOAuthConnectionInputSchema, it as HistoryRunListQuerySchema, j as CreateCustomAppResponseSchema, jn as WorkflowRunListResponseSchema, jt as PresignChatAttachmentRequestSchema, k as CreateCredentialsResponseSchema, kn as WorkflowRunDetailResponseSchema, kt as PROJECT_REACHABILITY_REQUEST_TIMEOUT_MS, l as AgentTriggerSummaryListResponseSchema, ln as TriggerListResponseSchema, lt as InviteProjectMembersResponseSchema, m as CatalogActionsPageResponseSchema, mn as UpdateCredentialRequestSchema, mt as ListAppsResponseSchema, n as AcceptOrganizationInvitationResponseSchema, nn as StartMcpOAuthConnectionInputSchema, nt as HistoryRunCancelResponseSchema, o as AgentSessionListResponseSchema, on as SubmitMarketingContactRequestSchema, ot as InviteOrganizationMembersRequestSchema, p as CatalogActionDetailResponseSchema, pn as UpdateCredentialInstanceBodySchema, pt as ListApiKeysResponseSchema, q as DeclineOrganizationInvitationResponseSchema, qn as parseAppSlug, qt as QueuedAgentPromptResponseSchema, r as ActiveOrganizationResponseSchema, rn as StartMcpOAuthConnectionResultSchema, rt as HistoryRunDetailResponseSchema, s as AgentSummaryDetailResponseSchema, sn as SubmitTeamRequestRequestSchema, st as InviteOrganizationMembersResponseSchema, t as ACTIVE_ORG_HEADER, tn as StartKeystrokeConnectionResultSchema, tt as HealthResponseSchema, u as AppSlugAvailabilityResponseSchema, un as TriggerRunDetailResponseSchema, v as ChannelConnectionListResponseSchema, vn as UpdateProjectMemberRequestSchema, vt as ListOrganizationsResponseSchema, w as ConnectProvidersResponseSchema, wn as UpsertGatewayAttachmentBodySchema, wt as McpDiscoverResponseSchema, x as ChannelPlatformSchema, xn as UpdateProjectSettingsRequestSchema, xt as ListProjectMembersResponseSchema, y as ChannelConnectionSchema, yn as UpdateProjectMemberResponseSchema, yt as ListProjectDeploymentsResponseSchema, z as CredentialAssignmentRecordSchema, zn as buildConnectDeeplink, zt as ProjectPullStateSchema } from "./dist-BOhrc_Nv.mjs";
+import { i as packProjectArtifact, n as withMcpReadClient, r as mergeFilteredArtifact, t as mapInParallelBatches } from "./dist-Re6HHSqz.mjs";
+import { a as installPlaygroundDependencies, c as createCliConfig, d as getEffectiveApiTarget, f as getPlatformUrl, g as resolvePlatformUrlForWebUrl, i as installDependencies$1, l as getCliConfigDir, m as DEFAULT_PLATFORM_URL, n as buildPlaygroundWorkspace, o as resolvePackageManager, p as getWebUrl, s as resolveCliRoot, t as readCliVersion, u as getConfigDir } from "./version-DcR3O1UD.mjs";
 import { createRequire } from "node:module";
 import { Command } from "commander";
-import { platform } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { Entry } from "@napi-rs/keyring";
 import { confirm, input, select } from "@inquirer/prompts";
 import { existsSync, lstatSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { access, copyFile, cp, lstat, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
+import { access, copyFile, lstat, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
 import { spawn, spawnSync } from "node:child_process";
 import { pathToFileURL } from "node:url";
 //#region ../../node_modules/.pnpm/ky@2.0.2/node_modules/ky/distribution/errors/KyError.js
@@ -5012,6 +5011,23 @@ function formatCliError(error, fallback, context) {
 }
 //#endregion
 //#region src/errors/run-command.ts
+/**
+* Run a command that needs no project/org target or auth (e.g. public docs).
+* Builds config and formats errors, but skips `resolveApiTarget` / `ensureActiveOrganization`,
+* so it works logged-out from any directory.
+*/
+async function runStandaloneCliCommand(fallback, fn, errorContext) {
+	const config = createCliConfig();
+	try {
+		await fn({ config });
+	} catch (error) {
+		process.stderr.write(`${formatCliError(error, fallback, {
+			...errorContext,
+			webUrl: getWebUrl(config)
+		})}\n`);
+		process.exitCode = 1;
+	}
+}
 async function runProjectCliCommand(fallback, fn, errorContext, targetOptions = {}) {
 	return runCliCommand(fallback, fn, errorContext, {
 		...projectScopedTarget,
@@ -6206,7 +6222,7 @@ function registerBuildCommand(program) {
 	program.command("build").description("Build the keystroke project for production").option("--dir <path>", "Project directory", process.cwd()).action(async (options) => {
 		try {
 			const root = resolveProjectRoot(options.dir);
-			const { buildApp } = await import("./dist-BdewSOMb.mjs");
+			const { buildApp } = await import("./dist-CUEVu120.mjs");
 			await buildApp({ root });
 			process.stdout.write(`Built ${root}\n`);
 		} catch (error) {
@@ -6260,7 +6276,7 @@ async function sleep(ms) {
 }
 async function buildDeployArchive(client, root, projectId, filter) {
 	if (filter?.length) {
-		const { buildFilteredApp } = await import("./dist-BdewSOMb.mjs");
+		const { buildFilteredApp } = await import("./dist-CUEVu120.mjs");
 		const filtered = await buildFilteredApp({
 			root,
 			filter,
@@ -6282,7 +6298,7 @@ async function buildDeployArchive(client, root, projectId, filter) {
 			sourceFiles: filtered.sourceFiles
 		};
 	}
-	const { buildApp } = await import("./dist-BdewSOMb.mjs");
+	const { buildApp } = await import("./dist-CUEVu120.mjs");
 	const { sourceFiles } = await buildApp({
 		root,
 		collectSources: true,
@@ -6401,7 +6417,7 @@ function runtimeChildEnv(parentEnv, overrides) {
 //#region src/project/bootstrap-run.ts
 /** Node args + env for `@keystrokehq/build` bootstrap (shared by start + dev). */
 async function resolveBootstrapRun(options) {
-	const { resolveRuntimeBuildArtifact } = await import("./dist-BdewSOMb.mjs");
+	const { resolveRuntimeBuildArtifact } = await import("./dist-CUEVu120.mjs");
 	const loader = pathToFileURL(resolveRuntimeBuildArtifact(options.runtimeNodeModules, "dist/runtime-loader.mjs")).href;
 	const bootstrap = resolveRuntimeBuildArtifact(options.runtimeNodeModules, "dist/standalone-bootstrap.mjs");
 	const args = [`--import=${loader}`];
@@ -6550,7 +6566,7 @@ async function runDev(options) {
 	process.on("SIGINT", shutdown);
 	process.on("SIGTERM", shutdown);
 	try {
-		const { watchApp } = await import("./dist-BdewSOMb.mjs");
+		const { watchApp } = await import("./dist-CUEVu120.mjs");
 		await watchApp({
 			root,
 			clean: false,
@@ -6578,6 +6594,63 @@ function registerDevCommand(program) {
 	});
 }
 //#endregion
+//#region src/commands/docs/run-docs.ts
+/**
+* Render an MCP tool result for the terminal. The docs tools return text/markdown
+* blocks (search hits, file contents, sandbox stdout/stderr), so we pass them through
+* verbatim and only fall back to JSON when a result carries no text.
+*/
+function renderToolResult(result) {
+	const blocks = result?.content;
+	if (Array.isArray(blocks)) {
+		const text = blocks.filter((block) => block?.type === "text" && typeof block.text === "string").map((block) => block.text).join("\n");
+		if (text.length > 0) return text;
+	}
+	return JSON.stringify(result, null, 2);
+}
+/** Call a docs MCP tool and render its result as text. */
+async function callDocsTool(client, name, args) {
+	return renderToolResult(await client.callTool({
+		name,
+		arguments: args
+	}));
+}
+//#endregion
+//#region src/commands/docs/docs-mcp-url.ts
+/**
+* Public Keystroke docs MCP endpoint (Mintlify-hosted, no auth).
+* Derived from the configured web URL; `KEYSTROKE_DOCS_MCP_URL` overrides for dev/testing.
+*/
+function getDocsMcpUrl(config) {
+	return resolveDocsMcpUrl({
+		webUrl: getWebUrl(config),
+		override: process.env.KEYSTROKE_DOCS_MCP_URL
+	});
+}
+//#endregion
+//#region src/commands/docs/query.ts
+function registerDocsQueryCommand(docs) {
+	docs.command("query").description("Read the Keystroke docs filesystem with a shell-style command (cat, rg, ls, tree)").argument("<command>", "Read-only command, e.g. \"cat /quickstart.mdx\" or \"rg -il auth /\"").action((command) => runStandaloneCliCommand("Docs query failed", async ({ config }) => {
+		const output = await withMcpReadClient(getDocsMcpUrl(config), (client) => callDocsTool(client, DOCS_QUERY_TOOL, { command }));
+		process.stdout.write(`${output}\n`);
+	}));
+}
+//#endregion
+//#region src/commands/docs/search.ts
+function registerDocsSearchCommand(docs) {
+	docs.command("search").description("Search the Keystroke documentation for relevant pages and examples").argument("<query>", "Search query").action((query) => runStandaloneCliCommand("Docs search failed", async ({ config }) => {
+		const output = await withMcpReadClient(getDocsMcpUrl(config), (client) => callDocsTool(client, DOCS_SEARCH_TOOL, { query }));
+		process.stdout.write(`${output}\n`);
+	}));
+}
+//#endregion
+//#region src/commands/docs/index.ts
+function registerDocsCommand(program) {
+	const docs = program.command("docs").description("Search and read the Keystroke documentation");
+	registerDocsSearchCommand(docs);
+	registerDocsQueryCommand(docs);
+}
+//#endregion
 //#region src/commands/history/run-history.ts
 async function runHistoryList(config, filters) {
 	if (filters?.admin) await requireAdminRole(config);
@@ -6700,7 +6773,7 @@ const INIT_CATALOG_VERSIONS = {
 	vitest: "^4.1.7",
 	"@types/node": "^25.9.1"
 };
-const INIT_KEYSTROKE_VERSION = "^0.1.19";
+const INIT_KEYSTROKE_VERSION = "^0.1.22";
 //#endregion
 //#region src/init/copy-template.ts
 function renderTemplate(content, variables) {
@@ -6790,6 +6863,26 @@ async function applyPlaygroundManifest(targetDir, projectName, monorepoRoot) {
 	await writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`);
 }
 //#endregion
+//#region src/skills/agents-guide-version.ts
+const BUNDLE_VERSION_FILENAME = ".bundle-version";
+const LEGACY_BUNDLE_VERSION_RELATIVE_PATH = join("skills", BUNDLE_VERSION_FILENAME);
+function agentsGuideDir(projectRoot) {
+	return join(projectRoot, ".agents");
+}
+function bundleVersionPath(projectRoot) {
+	return join(agentsGuideDir(projectRoot), BUNDLE_VERSION_FILENAME);
+}
+async function readBundleVersion(projectRoot) {
+	for (const path of [bundleVersionPath(projectRoot), join(agentsGuideDir(projectRoot), LEGACY_BUNDLE_VERSION_RELATIVE_PATH)]) try {
+		return (await readFile(path, "utf8")).trim();
+	} catch {}
+	return null;
+}
+async function writeBundleVersion(projectRoot) {
+	await mkdir(agentsGuideDir(projectRoot), { recursive: true });
+	await writeFile(bundleVersionPath(projectRoot), `${readCliVersion()}\n`);
+}
+//#endregion
 //#region src/skills/resolve-skills-bundle-dir.ts
 const SKILLS_BUNDLE = "skills-bundle";
 function resolveSkillsBundleDir(fromModuleUrl = import.meta.url) {
@@ -6801,53 +6894,26 @@ function resolveSkillsBundleDir(fromModuleUrl = import.meta.url) {
 		join(cliRoot, SKILLS_BUNDLE)
 	];
 	for (const candidate of candidates) if (existsSync(join(candidate, "_AGENTS.md"))) return candidate;
-	throw new Error("Bundled keystroke skills not found — run `pnpm --filter @keystrokehq/cli build`");
+	throw new Error("Bundled AGENTS guide not found — run `pnpm --filter @keystrokehq/cli build`");
 }
 //#endregion
-//#region src/skills/sync-bundled-skills.ts
-const BUNDLE_VERSION_FILENAME = ".bundle-version";
-function agentsSkillsDir(projectRoot) {
-	return join(projectRoot, ".agents", "skills");
-}
-function bundleVersionPath(projectRoot) {
-	return join(agentsSkillsDir(projectRoot), BUNDLE_VERSION_FILENAME);
-}
-async function readBundleVersion(projectRoot) {
-	try {
-		return (await readFile(bundleVersionPath(projectRoot), "utf8")).trim();
-	} catch {
-		return null;
-	}
-}
-async function ensureSymlink(target, linkPath, kind) {
+//#region src/skills/scaffold-agents-guide.ts
+async function ensureSymlink(target, linkPath) {
 	await mkdir(dirname(linkPath), { recursive: true });
 	await rm(linkPath, {
 		recursive: true,
 		force: true
 	});
-	await symlink(target, linkPath, platform() === "win32" && kind === "dir" ? "junction" : kind);
+	await symlink(target, linkPath, "file");
 }
-/** Overwrites `.agents/skills/`, AGENTS.md, and recreates `.claude` symlinks from the CLI bundle. */
-async function syncBundledSkills(projectRoot, fromModuleUrl = import.meta.url) {
+/** Writes AGENTS.md from the CLI bundle and recreates the CLAUDE.md symlink. */
+async function scaffoldAgentsGuide(projectRoot, fromModuleUrl = import.meta.url) {
 	const bundleDir = resolveSkillsBundleDir(fromModuleUrl);
-	const skillsDir = agentsSkillsDir(projectRoot);
 	const agentsMdPath = join(projectRoot, "AGENTS.md");
-	await mkdir(join(projectRoot, ".agents"), { recursive: true });
-	if ((await lstat(skillsDir).catch(() => null))?.isSymbolicLink()) {
-		await rm(skillsDir, { force: true });
-		await cp(join(bundleDir, "skills"), skillsDir, { recursive: true });
-	} else {
-		await mkdir(skillsDir, { recursive: true });
-		await cp(join(bundleDir, "skills"), skillsDir, {
-			recursive: true,
-			force: true
-		});
-	}
 	if ((await lstat(agentsMdPath).catch(() => null))?.isSymbolicLink()) await rm(agentsMdPath, { force: true });
 	await writeFile(agentsMdPath, await readFile(join(bundleDir, "_AGENTS.md"), "utf8"));
-	await ensureSymlink(relative(dirname(join(projectRoot, ".claude", "skills")), skillsDir), join(projectRoot, ".claude", "skills"), "dir");
-	await ensureSymlink(relative(dirname(join(projectRoot, "CLAUDE.md")), agentsMdPath), join(projectRoot, "CLAUDE.md"), "file");
-	await writeFile(bundleVersionPath(projectRoot), `${readCliVersion()}\n`);
+	await ensureSymlink(relative(dirname(join(projectRoot, "CLAUDE.md")), agentsMdPath), join(projectRoot, "CLAUDE.md"));
+	await writeBundleVersion(projectRoot);
 }
 //#endregion
 //#region src/init/scaffold-empty-src-dirs.ts
@@ -6948,7 +7014,7 @@ async function runInit(options) {
 	}
 	if (playgroundRoot) await applyPlaygroundManifest(targetDir, projectName, playgroundRoot);
 	else await scaffoldProjectDotfiles(targetDir);
-	await syncBundledSkills(targetDir);
+	await scaffoldAgentsGuide(targetDir);
 	await copyFile(join(targetDir, ".env.example"), join(targetDir, ".env"));
 	if (!options.skipInstall) if (playgroundRoot) {
 		installPlaygroundDependencies(targetDir);
@@ -7449,7 +7515,7 @@ async function runPull(options) {
 	}
 	await writeSourceTree(targetDir, source.files);
 	installDependencies(targetDir, detectProjectPackageManagerFromSnapshot(source.files));
-	await syncBundledSkills(targetDir);
+	await scaffoldAgentsGuide(targetDir);
 	await writePullState({
 		targetDir,
 		projectId: options.projectId,
@@ -7485,7 +7551,7 @@ async function runStart(options) {
 	const apiPort = Number(new URL(serverUrl).port || 80);
 	const runtimeNodeModules = resolveCliRuntimeNodeModules(resolveCliRoot(import.meta.url));
 	ensureNativeDeps(runtimeNodeModules);
-	const { buildApp } = await import("./dist-BdewSOMb.mjs");
+	const { buildApp } = await import("./dist-CUEVu120.mjs");
 	await buildApp({
 		root,
 		clean: false
@@ -7988,20 +8054,20 @@ function registerSkillCommand(program) {
 //#endregion
 //#region src/commands/skills.ts
 function registerSkillsCommand(program) {
-	program.command("skills").description("Manage bundled agent skills").command("sync").description("Overwrite bundled skills and AGENTS.md with the CLI version").option("--dir <path>", "Project directory", process.cwd()).action(async (options) => {
+	program.command("skills").description("Manage the scaffolded AGENTS guide").command("sync").description("Overwrite AGENTS.md with the CLI version").option("--dir <path>", "Project directory", process.cwd()).action(async (options) => {
 		try {
 			const root = resolveProjectRoot(options.dir);
-			await syncBundledSkills(root);
-			process.stdout.write(`Synced bundled skills at ${root}\n`);
+			await scaffoldAgentsGuide(root);
+			process.stdout.write(`Synced AGENTS.md at ${root}\n`);
 		} catch (error) {
-			const message = error instanceof Error ? error.message : "Skills sync failed";
+			const message = error instanceof Error ? error.message : "AGENTS guide sync failed";
 			process.stderr.write(`${message}\n`);
 			process.exitCode = 1;
 		}
 	});
 }
 //#endregion
-//#region src/skills/sync-skills.ts
+//#region src/skills/sync-agents-guide.ts
 function commandPath(command) {
 	const names = [];
 	for (let current = command; current; current = current.parent) {
@@ -8020,18 +8086,20 @@ function shouldSkipAutoSync(command) {
 function resolveAutoSyncRoot(command) {
 	return resolveKeystrokeConfigRoot(command.opts().dir ?? process.cwd());
 }
-/** Sync bundled skills when stale; no-op when not in a project or already up to date. */
-async function syncSkills(command) {
+/** Sync AGENTS.md when stale; no-op when not in a project or already up to date. */
+async function syncAgentsGuide(command) {
 	if (shouldSkipAutoSync(command)) return;
 	const projectRoot = resolveAutoSyncRoot(command);
 	if (!projectRoot) return;
-	const skillsDir = agentsSkillsDir(projectRoot);
-	if (!existsSync(skillsDir)) return;
-	if (lstatSync(skillsDir).isSymbolicLink()) return;
+	const agentsMdPath = join(projectRoot, "AGENTS.md");
+	if (!existsSync(agentsMdPath)) return;
+	if (lstatSync(agentsMdPath).isSymbolicLink()) return;
+	const legacySkillsDir = join(agentsGuideDir(projectRoot), "skills");
+	if (existsSync(legacySkillsDir) && lstatSync(legacySkillsDir).isSymbolicLink()) return;
 	const currentVersion = readCliVersion();
 	if (await readBundleVersion(projectRoot) === currentVersion) return;
-	await syncBundledSkills(projectRoot);
-	process.stderr.write(`Synced bundled skills to ${currentVersion}\n`);
+	await scaffoldAgentsGuide(projectRoot);
+	process.stderr.write(`Synced AGENTS.md to ${currentVersion}\n`);
 }
 //#endregion
 //#region src/program.ts
@@ -8042,7 +8110,7 @@ function createProgram() {
 			projectId: opts.project,
 			local: opts.local
 		});
-		await syncSkills(actionCommand);
+		await syncAgentsGuide(actionCommand);
 	});
 	registerAuthCommand(program);
 	registerConnectCommand(program);
@@ -8053,6 +8121,7 @@ function createProgram() {
 	registerHistoryCommand(program);
 	registerCredentialsCommand(program);
 	registerHealthCommand(program);
+	registerDocsCommand(program);
 	registerInitCommand(program);
 	registerSkillsCommand(program);
 	registerSkillCommand(program);
@@ -8069,7 +8138,7 @@ function createProgram() {
 	return program;
 }
 async function runCli(argv) {
-	const { maybeAutoUpdate } = await import("./maybe-auto-update-BK4A8nTA.mjs");
+	const { maybeAutoUpdate } = await import("./maybe-auto-update-q5MthdI8.mjs");
 	await maybeAutoUpdate(argv);
 	createProgram().parse(argv);
 }