@keystrokehq/cli 0.1.102 → 0.1.103

package/dist/index.mjs

@@ -5014,6 +5014,21 @@ function readLinkedProjectConfig(fromDir = process.cwd()) {
 	return parseLinkedProjectConfig(readFileSync(join(root, KEYSTROKE_CONFIG$1), "utf8"));
 }
 //#endregion
+//#region src/errors/expected-cli-error.ts
+/**
+* User/project failures that are expected CLI exits (lint, typecheck, validation, etc.).
+* These should not become Error Tracking issues.
+*/
+var ExpectedCliError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ExpectedCliError";
+	}
+};
+function isExpectedCliError(error) {
+	return error instanceof ExpectedCliError;
+}
+//#endregion
 //#region src/target-hints.ts
 function missingOrganizationRefMessage() {
 	return "No organization selected. Pass `--organization <slug>` or set `organization` in keystroke.config.ts (via `keystroke projects link --project <slug>`).";
@@ -5022,10 +5037,10 @@ function missingProjectRefMessage() {
 	return "No project selected. Pass `--project <slug>` or set `project` in keystroke.config.ts (via `keystroke projects link --project <slug>`).";
 }
 function missingOrganizationRefError() {
-	return new Error(missingOrganizationRefMessage());
+	return new ExpectedCliError(missingOrganizationRefMessage());
 }
 function missingProjectRefError() {
-	return new Error(missingProjectRefMessage());
+	return new ExpectedCliError(missingProjectRefMessage());
 }
 //#endregion
 //#region src/resolve-organization-target.ts
@@ -5052,7 +5067,7 @@ async function resolveActiveOrganization(config, fromDir = process.cwd()) {
 //#region src/project/resolve-project-root.ts
 function resolveProjectRoot(fromDir = process.cwd()) {
 	const root = resolveKeystrokeConfigRoot(fromDir);
-	if (!root) throw new Error("Could not find keystroke project root (expected keystroke.config.ts)");
+	if (!root) throw new ExpectedCliError("Could not find keystroke project root (expected keystroke.config.ts)");
 	return root;
 }
 //#endregion
@@ -5198,14 +5213,14 @@ function getTelemetryContext() {
 */
 function isExpectedError(error) {
 	if (!error || typeof error !== "object") return false;
-	const status = readStatus(error);
-	if (status !== void 0 && status >= 400 && status < 500) return true;
+	const status = readStatus$1(error);
+	if (status !== void 0 && (status === 0 || status >= 400 && status < 500)) return true;
 	if ("name" in error && typeof error.name === "string") {
 		if (error.name === "AbortError" || error.name === "CanceledError" || error.name === "CancelledError" || error.name === "RunTimeoutError") return true;
 	}
 	return false;
 }
-function readStatus(error) {
+function readStatus$1(error) {
 	if ("status" in error && typeof error.status === "number") return error.status;
 	if ("statusCode" in error && typeof error.statusCode === "number") return error.statusCode;
 }
@@ -5339,6 +5354,39 @@ function sanitizeProperties(properties) {
 	return Object.fromEntries(Object.entries(properties).filter((entry) => entry[1] !== void 0));
 }
 //#endregion
+//#region src/errors/should-report-cli-exception.ts
+function readStatus(error) {
+	if (!error || typeof error !== "object") return;
+	if ("status" in error && typeof error.status === "number") return error.status;
+	if ("statusCode" in error && typeof error.statusCode === "number") return error.statusCode;
+}
+function isAuthCommand(context) {
+	const operation = context.operation ?? "";
+	const command = context.command ?? "";
+	return operation.startsWith("cli.auth") || command.startsWith("auth");
+}
+function isDeployCommand(context) {
+	const operation = context.operation ?? "";
+	const command = context.command ?? "";
+	return operation === "cli.deploy" || command === "deploy";
+}
+/**
+* CLI Error Tracking allowlist — report only:
+* - HTTP 5xx responses
+* - unexpected failures on auth / deploy paths
+*
+* Validation, lint/typecheck, bad flags, and local unreachable servers stay quiet.
+*/
+function shouldReportCliException(error, context) {
+	if (isExpectedCliError(error)) return false;
+	const status = readStatus(error);
+	if (status !== void 0) {
+		if (status === 0 || status >= 400 && status < 500) return false;
+		if (status >= 500) return true;
+	}
+	return isAuthCommand(context) || isDeployCommand(context);
+}
+//#endregion
 //#region src/telemetry/identity.ts
 function getCliTelemetryActorId() {
 	return getOrCreateAnonymousDistinctId();
@@ -5409,7 +5457,7 @@ async function shutdownCliTelemetry() {
 	enabled = false;
 }
 async function reportCliException(error, context) {
-	if (!enabled) return;
+	if (!enabled || isExpectedCliError(error) || !shouldReportCliException(error, context)) return;
 	await captureException({
 		error,
 		analyticsId: getCliTelemetryActorId(),
@@ -5604,7 +5652,7 @@ function parseJsonOption(value, flag) {
 	try {
 		return JSON.parse(value);
 	} catch {
-		throw new Error(`Invalid ${flag} JSON`);
+		throw new ExpectedCliError(`Invalid ${flag} JSON`);
 	}
 }
 //#endregion
@@ -7116,8 +7164,7 @@ async function ensureSdkCurrent(root) {
 	if (packages.length === 0) return;
 	const outdated = await packagesNeedingUpdate(root, packages);
 	if (outdated.length === 0) return;
-	const lines = outdated.map(formatOutdatedLine).join("\n");
-	throw new Error(`Outdated @keystrokehq packages:\n${lines}\n\nPlease run \`keystroke update\` before continuing.`);
+	throw new ExpectedCliError(`Outdated @keystrokehq packages:\n${outdated.map(formatOutdatedLine).join("\n")}\n\nPlease run \`keystroke update\` before continuing.`);
 }
 //#endregion
 //#region src/commands/build.ts
@@ -7288,8 +7335,8 @@ async function buildDeployArchive(client, root, projectId, filter) {
 async function runDeploy(options) {
 	const root = resolveProjectRoot(options.dir);
 	await ensureSdkCurrent(root);
-	if (await runLint(root) !== 0) throw new Error("lint failed");
-	if (await runTypecheck(root) !== 0) throw new Error("typecheck failed");
+	if (await runLint(root) !== 0) throw new ExpectedCliError("lint failed");
+	if (await runTypecheck(root) !== 0) throw new ExpectedCliError("typecheck failed");
 	const config = createCliConfig();
 	await resolveActiveOrganization(config, root);
 	const client = createCliPlatformClient(config);
@@ -7711,8 +7758,8 @@ function projectNameValidationError(name) {
 }
 function assertProjectName(name) {
 	const trimmed = name.trim();
-	if (!trimmed) throw new Error("Project name is required");
-	if (!KEBAB_CASE.test(trimmed)) throw new Error(projectNameValidationError(trimmed));
+	if (!trimmed) throw new ExpectedCliError("Project name is required");
+	if (!KEBAB_CASE.test(trimmed)) throw new ExpectedCliError(projectNameValidationError(trimmed));
 	return trimmed;
 }
 function projectNameFromDirectory(directory) {
@@ -7861,21 +7908,33 @@ function resolveSkillsBundleDir(fromModuleUrl = import.meta.url) {
 }
 //#endregion
 //#region src/skills/scaffold-agents-guide.ts
-async function ensureSymlink(target, linkPath) {
+function isSymlinkUnsupported(error) {
+	if (!error || typeof error !== "object" || !("code" in error)) return false;
+	const code = error.code;
+	return code === "EPERM" || code === "EACCES" || code === "ENOTSUP";
+}
+/** Prefer a symlink; on Windows without symlink privileges, write a regular file copy. */
+async function ensureClaudeMdLink(guidePath, linkPath, createLink = symlink) {
 	await mkdir(dirname(linkPath), { recursive: true });
 	await rm(linkPath, {
 		recursive: true,
 		force: true
 	});
-	await symlink(target, linkPath, "file");
+	const target = relative(dirname(linkPath), guidePath);
+	try {
+		await createLink(target, linkPath, "file");
+	} catch (error) {
+		if (!isSymlinkUnsupported(error)) throw error;
+		await writeFile(linkPath, await readFile(guidePath, "utf8"));
+	}
 }
-/** Writes AGENTS.md from the CLI bundle and recreates the CLAUDE.md symlink. */
+/** Writes AGENTS.md from the CLI bundle and recreates the CLAUDE.md symlink (or copy). */
 async function scaffoldAgentsGuide(projectRoot, fromModuleUrl = import.meta.url) {
 	const bundleDir = resolveSkillsBundleDir(fromModuleUrl);
 	const guidePath = agentsMdPath(projectRoot);
 	if ((await lstat(guidePath).catch(() => null))?.isSymbolicLink()) await rm(guidePath, { force: true });
 	await writeFile(guidePath, stampAgentsGuideVersion(await readFile(join(bundleDir, "_AGENTS.md"), "utf8")));
-	await ensureSymlink(relative(dirname(join(projectRoot, "CLAUDE.md")), guidePath), join(projectRoot, "CLAUDE.md"));
+	await ensureClaudeMdLink(guidePath, join(projectRoot, "CLAUDE.md"));
 }
 //#endregion
 //#region src/project/write-project-config.ts
@@ -7994,8 +8053,8 @@ async function runInit(options) {
 	const playgroundRoot = resolvePlaygroundRoot(targetDir);
 	if (!await directoryIsEmpty(targetDir)) {
 		if (interactive) {
-			if (!await confirmTargetDir(targetDir)) throw new Error("Init cancelled");
-		} else if (!options.yes) throw new Error(`Directory "${targetDir}" is not empty. Pass --yes to merge or choose an empty directory.`);
+			if (!await confirmTargetDir(targetDir)) throw new ExpectedCliError("Init cancelled");
+		} else if (!options.yes) throw new ExpectedCliError(`Directory "${targetDir}" is not empty. Pass --yes to merge or choose an empty directory.`);
 	}
 	await copyTemplate(resolveTemplateDir(options.template ?? "hello-world"), targetDir, { projectName });
 	await scaffoldEmptySrcDirs(targetDir);
@@ -9366,8 +9425,13 @@ async function syncAgentsGuide(command) {
 	if (existsSync(legacySkillsDir) && lstatSync(legacySkillsDir).isSymbolicLink()) return;
 	const currentVersion = readCliVersion();
 	if (await readBundleVersion(projectRoot) === currentVersion) return;
-	await scaffoldAgentsGuide(projectRoot);
-	process.stderr.write(`Synced AGENTS.md to ${currentVersion}\n`);
+	try {
+		await scaffoldAgentsGuide(projectRoot);
+		process.stderr.write(`Synced AGENTS.md to ${currentVersion}\n`);
+	} catch (error) {
+		const detail = error instanceof Error ? error.message : String(error);
+		process.stderr.write(`Failed to sync AGENTS.md (${detail}); continuing.\n`);
+	}
 }
 //#endregion
 //#region src/program.ts