@joshuafolkken/kit 1.1005.0 → 1.1035.0

package/dist/josh.js

@@ -1,9 +1,35 @@
 #!/usr/bin/env node
 
 // scripts/doctor/doctor-consumer.ts
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import path from "node:path";
 
+// scripts/lib/read-file.ts
+import { readFileSync } from "node:fs";
+var ABSENT_CODE = "ENOENT";
+function is_absent(error) {
+  return error instanceof Error && "code" in error && error.code === ABSENT_CODE;
+}
+function read_optional(path5) {
+  try {
+    return readFileSync(path5, "utf8");
+  } catch (error) {
+    if (is_absent(error)) return void 0;
+    throw error;
+  }
+}
+function read_file_or_empty(path5) {
+  return read_optional(path5) ?? "";
+}
+function read_if_readable(path5) {
+  try {
+    return readFileSync(path5, "utf8");
+  } catch {
+    return void 0;
+  }
+}
+var file_reader = { read_optional, read_file_or_empty, read_if_readable };
+
 // scripts/lib/spawn-exit.ts
 var SPAWN_ERROR_EXIT_CODE = 2;
 var SIGNAL_KILL_EXIT_CODE = 1;
@@ -50,15 +76,8 @@ var settings_schema = z.object({
 var STATE_OK = "ok";
 var STATE_TARGET_MISSING = "target-missing";
 var STATE_MISSING = "missing";
-function read_optional(file_path) {
-  try {
-    return existsSync(file_path) ? readFileSync(file_path, "utf8") : void 0;
-  } catch {
-    return void 0;
-  }
-}
 function parse_manifest(root) {
-  const content = read_optional(path.join(root, "package.json"));
+  const content = file_reader.read_if_readable(path.join(root, "package.json"));
   if (content === void 0) return void 0;
   const parsed = manifest_schema.safeParse(safe_json_parse(content));
   return parsed.success ? parsed.data : void 0;
@@ -73,7 +92,7 @@ function is_kit_consumer(root) {
   return lists_kit_dependency(manifest) || existsSync(path.join(root, NODE_MODULES, KIT_PACKAGE_NAME));
 }
 function is_plugin_declared(root) {
-  const content = read_optional(path.join(root, SETTINGS_PATH));
+  const content = file_reader.read_if_readable(path.join(root, SETTINGS_PATH));
   if (content === void 0) return false;
   const parsed = settings_schema.safeParse(safe_json_parse(content));
   return parsed.success && parsed.data.enabledPlugins?.[PLUGIN_ID] === true;
@@ -87,7 +106,7 @@ function configured_hooks_path(root) {
   return value === "" ? void 0 : value;
 }
 function claude_md_state(root) {
-  const content = read_optional(path.join(root, CLAUDE_MD));
+  const content = file_reader.read_if_readable(path.join(root, CLAUDE_MD));
   if (content === void 0) return STATE_MISSING;
   if (!content.includes(CLAUDE_MD_POINTER)) return STATE_OK;
   return existsSync(path.join(root, NODE_MODULES, KIT_PACKAGE_NAME, "dist", CLAUDE_MD)) ? STATE_OK : STATE_TARGET_MISSING;
@@ -313,7 +332,7 @@ var BACKLOG_COMMANDS = {
     script: "scripts/backlog/backlog-offer-cli.ts",
     description: "Collapse a backlogrun loop-head event into one call: read backlog:next, ask backlog:budget, return the verdict and any issues to start",
     category: "AI tools",
-    reference: ["[options]", "automation", ["network"]]
+    reference: ["[options]", "automation", ["files", "network", "processes"]]
   },
   "backlog:drive": {
     script: "scripts/backlog/backlog-drive-cli.ts",
@@ -550,7 +569,7 @@ var AI_COMMANDS = {
     reference: ["<message>", "automation", ["git"]]
   },
   epic: {
-    script: "scripts-ai/epic.ts",
+    script: "scripts/epic/epic.ts",
     description: "Create an epic issue from its child issue numbers",
     category: "AI tools",
     reference: ["<title> <issue...> [--ordered]", "automation", ["network"]]
@@ -574,7 +593,7 @@ var AI_COMMANDS = {
     reference: ["<epic>", "automation", ["network"]]
   },
   "epic:check": {
-    script: "scripts-ai/epic-check.ts",
+    script: "scripts/epic/epic-check.ts",
     description: "Check an epic issue against the tracking requirements",
     category: "AI tools",
     reference: ["<epic>", "automation", ["network"]]
@@ -901,7 +920,7 @@ var DEV_COMMANDS = {
     script: "scripts/rules/rule-value-cli.ts",
     description: "Print each delivered rule's unaided compliance \u2014 runs reached, kept rate, refusals",
     category: "AI tools",
-    reference: ["", "developer", ["none"]]
+    reference: ["[--refresh]", "developer", ["files"]]
   },
   format: {
     script: "scripts/lint/format.ts",
@@ -1294,7 +1313,7 @@ var VERSIONING_COMMANDS = {
 };
 
 // scripts/josh/josh-commands-workflow.ts
-var GIT_WORKFLOW_SCRIPT = "scripts-ai/git-workflow.ts";
+var GIT_WORKFLOW_SCRIPT = "scripts/git/git-workflow.ts";
 var GIT_MESSAGE_ARGUMENTS = "[-y] <message>";
 var WORKFLOW_COMMANDS = {
   git: {
@@ -1319,7 +1338,7 @@ var WORKFLOW_COMMANDS = {
   // session, and `followup` with them the merge step of every `fullrun` there. `doctor` was moved to
   // this form for the same reason in joshuafolkken/kit#869.
   //
-  // Nothing is lost by relaxing it: both scripts already call `load_optional_environment()`
+  // Nothing is lost by relaxing it: both scripts already load `.env` through `josh_environment_file`
   // themselves, so the file is read either way and node's precedence — an existing environment
   // variable wins over the file — is node's own in both spellings.
   //
@@ -1327,7 +1346,7 @@ var WORKFLOW_COMMANDS = {
   // than dropped: `telegram_notify.send` now throws on missing credentials and on a failed send, so
   // `josh notify` exits non-zero instead of warning and answering 0.
   followup: {
-    script: "scripts-ai/git-followup-workflow.ts",
+    script: "scripts/git/git-followup-workflow.ts",
     description: "Follow-up git workflow",
     category: "Workflow",
     reference: [
@@ -1338,7 +1357,7 @@ var WORKFLOW_COMMANDS = {
     tsx_arguments: OPTIONAL_ENV_FILE_FLAGS
   },
   notify: {
-    script: "scripts-ai/telegram-test.ts",
+    script: "scripts/git/telegram-test.ts",
     description: "Send Telegram notification",
     category: "Workflow",
     reference: ["--task-type <type> --body <text>", "automation", ["notifications"]],

package/dist/version/index.js

@@ -151,7 +151,7 @@ function resolve_effective_upstream_version(base_url, package_name, options = {}
 }
 
 // scripts/version/version-commands.ts
-import { execaSync as execaSync4 } from "execa";
+import { execaSync as execaSync3 } from "execa";
 
 // scripts/version/release-age.ts
 import { readFileSync as readFileSync2 } from "node:fs";
@@ -557,6 +557,12 @@ var agent_session_environment = {
   removed_proxy_environment
 };
 
+// scripts/lib/error-message.ts
+function message_of(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+var error_text = { message_of };
+
 // scripts/git/git-gh-exec.ts
 import { execa as execa2, execaSync } from "execa";
 
@@ -664,8 +670,12 @@ function direct_environment() {
   const removed = agent_session_environment.removed_proxy_environment();
   return Object.keys(removed).length > 0 ? { env: removed } : {};
 }
-function to_spawn_options(timeout_ms) {
-  return { ...to_timeout_option(timeout_ms), ...direct_environment() };
+function to_spawn_options(timeout_ms, cwd) {
+  return {
+    ...to_timeout_option(timeout_ms),
+    ...direct_environment(),
+    ...cwd !== void 0 && { cwd }
+  };
 }
 var GH_REQUEST_TIMEOUT_MESSAGE = "gh request timed out";
 function has_stderr_field(error) {
@@ -677,13 +687,10 @@ function has_stdout_field(error) {
 function to_timeout_prefix(error) {
   return has_timed_out(error) ? `${GH_REQUEST_TIMEOUT_MESSAGE}: ` : "";
 }
-function to_error_message(error) {
-  return error instanceof Error ? error.message : String(error);
-}
 function to_gh_error(error) {
   const stderr = has_stderr_field(error) ? error.stderr.trim() : "";
   const stdout = has_stdout_field(error) ? error.stdout.trim() : "";
-  const summary = stderr.length > 0 ? stderr : to_error_message(error);
+  const summary = stderr.length > 0 ? stderr : error_text.message_of(error);
   const detail = stdout.length > 0 ? `${summary}
 ${stdout}` : summary;
   return gh_failure.attach(
@@ -691,10 +698,11 @@ ${stdout}` : summary;
     gh_failure.classify_stdout(stdout)
   );
 }
-async function exec_gh_command(arguments_, timeout_ms) {
+async function exec_gh_command(arguments_, timeout_ms, cwd) {
   await check_gh_installed();
+  const options = to_spawn_options(timeout_ms, cwd);
   try {
-    const { stdout } = await execa2("gh", arguments_, to_spawn_options(timeout_ms));
+    const { stdout } = await execa2("gh", arguments_, options);
     return stdout.trimEnd();
   } catch (error) {
     throw to_gh_error(error);
@@ -702,7 +710,7 @@ async function exec_gh_command(arguments_, timeout_ms) {
 }
 async function exec_gh_command_with_stdin(input) {
   await check_gh_installed();
-  const options = { input: input.stdin_body, ...to_spawn_options(input.timeout_ms) };
+  const options = { input: input.stdin_body, ...to_spawn_options(input.timeout_ms, input.cwd) };
   try {
     const { stdout } = await execa2("gh", input.args, options);
     return stdout.trimEnd();
@@ -715,6 +723,9 @@ function parse_status_line(output) {
   const { status } = STATUS_LINE_PATTERN.exec(output)?.groups ?? {};
   return status === void 0 ? void 0 : Number(status);
 }
+function status_of_failure(error) {
+  return has_stdout_field(error) ? parse_status_line(error.stdout) : void 0;
+}
 async function exec_gh_api_status(path5, timeout_ms) {
   const options = to_spawn_options(timeout_ms);
   try {
@@ -722,7 +733,16 @@ async function exec_gh_api_status(path5, timeout_ms) {
     const { stdout } = await execa2("gh", ["api", "--include", "--silent", path5], options);
     return parse_status_line(stdout);
   } catch (error) {
-    return has_stdout_field(error) ? parse_status_line(error.stdout) : void 0;
+    return status_of_failure(error);
+  }
+}
+function exec_gh_api_status_sync(path5, timeout_ms) {
+  const options = to_spawn_options(timeout_ms);
+  try {
+    const { stdout } = execaSync("gh", ["api", "--include", "--silent", path5], options);
+    return parse_status_line(stdout);
+  } catch (error) {
+    return status_of_failure(error);
   }
 }
 var METHOD_FLAG = "--method";
@@ -749,16 +769,19 @@ function to_gh_api_args(request) {
 }
 async function exec_gh_api(request) {
   const args = to_gh_api_args(request);
-  if (request.body === void 0) return await exec_gh_command(args, request.timeout_ms);
+  if (request.body === void 0) {
+    return await exec_gh_command(args, request.timeout_ms, request.cwd);
+  }
   return await exec_gh_command_with_stdin({
     args,
     stdin_body: request.body,
-    timeout_ms: request.timeout_ms
+    timeout_ms: request.timeout_ms,
+    cwd: request.cwd
   });
 }
 function exec_gh_api_sync(request) {
   const body_option = request.body === void 0 ? {} : { input: request.body };
-  const options = { ...body_option, ...to_spawn_options(request.timeout_ms) };
+  const options = { ...body_option, ...to_spawn_options(request.timeout_ms, request.cwd) };
   try {
     const { stdout } = execaSync("gh", to_gh_api_args(request), options);
     return stdout.trimEnd();
@@ -766,19 +789,26 @@ function exec_gh_api_sync(request) {
     throw to_gh_error(error);
   }
 }
+function read_gh_api_sync(request) {
+  try {
+    return exec_gh_api_sync(request);
+  } catch {
+    return void 0;
+  }
+}
 var git_gh_exec = {
   direct_environment,
   exec_gh_command,
   exec_gh_command_with_stdin,
   exec_gh_api,
   exec_gh_api_sync,
+  read_gh_api_sync,
   exec_gh_api_status,
+  exec_gh_api_status_sync,
   parse_status_line
 };
 
 // scripts/version/version-remote.ts
-import { execaSync as execaSync2 } from "execa";
-var GH_FAILURE_FALLBACK = "gh api failed";
 var TIMES_PAGE_SIZE = 100;
 var TIMES_JQ = "[.[] | {(.name): .created_at}] | add";
 function require_endpoint(versions_endpoint, package_name) {
@@ -787,21 +817,19 @@ function require_endpoint(versions_endpoint, package_name) {
     `Could not derive a versions endpoint for ${package_name}; check its version-command config.`
   );
 }
-function describe_failure(result) {
-  const stderr = result.stderr.trim();
-  if (stderr !== "") return stderr;
-  return result.shortMessage ?? GH_FAILURE_FALLBACK;
-}
 function fetch_latest_version(versions_endpoint, package_name) {
   const endpoint = require_endpoint(versions_endpoint, package_name);
-  const result = execaSync2("gh", ["api", endpoint, "--jq", ".[0].name"], {
-    ...git_gh_exec.direct_environment(),
-    reject: false
-  });
-  if (result.exitCode === 0) return result.stdout.trim();
-  throw new Error(
-    `Failed to fetch latest version for ${package_name} via ${endpoint}: ${describe_failure(result)}`
-  );
+  try {
+    return git_gh_exec.exec_gh_api_sync({ path: endpoint, jq_filter: ".[0].name" }).trim();
+  } catch (error) {
+    const detail = error_text.message_of(error);
+    throw new Error(
+      `Failed to fetch latest version for ${package_name} via ${endpoint}: ${detail}`,
+      {
+        cause: error
+      }
+    );
+  }
 }
 function with_page_size(endpoint, page_size) {
   const separator = endpoint.indexOf("?");
@@ -813,19 +841,43 @@ function with_page_size(endpoint, page_size) {
 function fetch_release_times(versions_endpoint) {
   if (versions_endpoint === void 0 || versions_endpoint.trim() === "") return void 0;
   const endpoint = with_page_size(versions_endpoint, TIMES_PAGE_SIZE);
-  const result = execaSync2("gh", ["api", endpoint, "--jq", TIMES_JQ], {
-    ...git_gh_exec.direct_environment(),
-    reject: false
-  });
-  if (result.exitCode !== 0) return void 0;
-  const parsed = release_age.release_times_schema.safeParse(safe_json_parse(result.stdout));
+  const stdout = git_gh_exec.read_gh_api_sync({ path: endpoint, jq_filter: TIMES_JQ });
+  if (stdout === void 0) return void 0;
+  const parsed = release_age.release_times_schema.safeParse(safe_json_parse(stdout));
   return parsed.success ? parsed.data : void 0;
 }
 
 // scripts/version/version-targets.ts
-import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";
 import path4 from "node:path";
-import { execaSync as execaSync3 } from "execa";
+
+// scripts/lib/read-file.ts
+import { readFileSync as readFileSync4 } from "node:fs";
+var ABSENT_CODE = "ENOENT";
+function is_absent(error) {
+  return error instanceof Error && "code" in error && error.code === ABSENT_CODE;
+}
+function read_optional(path5) {
+  try {
+    return readFileSync4(path5, "utf8");
+  } catch (error) {
+    if (is_absent(error)) return void 0;
+    throw error;
+  }
+}
+function read_file_or_empty(path5) {
+  return read_optional(path5) ?? "";
+}
+function read_if_readable(path5) {
+  try {
+    return readFileSync4(path5, "utf8");
+  } catch {
+    return void 0;
+  }
+}
+var file_reader = { read_optional, read_file_or_empty, read_if_readable };
+
+// scripts/version/version-targets.ts
+import { execaSync as execaSync2 } from "execa";
 var NODE_MODULES2 = "node_modules";
 var PACKAGE_JSON3 = "package.json";
 function build_pnpm_ls_arguments(package_name) {
@@ -842,7 +894,7 @@ function parse_project_version(raw) {
   return parsed.success ? parsed.data.version : void 0;
 }
 function read_global_version(package_name) {
-  const result = execaSync3("pnpm", build_pnpm_ls_arguments(package_name), { reject: false });
+  const result = execaSync2("pnpm", build_pnpm_ls_arguments(package_name), { reject: false });
   return parse_global_version(result.stdout, package_name);
 }
 function project_package_path(cwd, package_name) {
@@ -850,12 +902,12 @@ function project_package_path(cwd, package_name) {
 }
 function read_project_version(cwd, package_name) {
   const package_path = project_package_path(cwd, package_name);
-  const raw = existsSync3(package_path) ? readFileSync4(package_path, "utf8") : void 0;
+  const raw = file_reader.read_optional(package_path);
   return parse_project_version(raw);
 }
 function read_workspace_version(cwd) {
   const package_path = path4.join(cwd, PACKAGE_JSON3);
-  const raw = existsSync3(package_path) ? readFileSync4(package_path, "utf8") : void 0;
+  const raw = file_reader.read_optional(package_path);
   return parse_project_version(raw);
 }
 var version_targets = {
@@ -960,7 +1012,7 @@ function run_check(config) {
   );
 }
 function run_upgrade_command(command) {
-  const result = execaSync4("sh", ["-c", command], { stdio: "inherit", reject: false });
+  const result = execaSync3("sh", ["-c", command], { stdio: "inherit", reject: false });
   return result.exitCode ?? FAILURE_EXIT_CODE;
 }
 function run_all_upgrade_commands(commands) {

package/eslint/base.js

@@ -29,13 +29,10 @@ import {
 import { typescript_rules } from './rules/typescript.js'
 import { unicorn_rules } from './rules/unicorn.js'
 
-const SCRIPTS_AI_PATTERNS = ['scripts-ai/**/*.ts', 'scripts-ai/**/*.js']
-
 const FILE_PATTERNS = {
 	d_ts: ['**/*.d.ts'],
 	typescript: ['**/*.ts', '**/*.tsx'],
-	scripts_ai: SCRIPTS_AI_PATTERNS,
-	scripts: ['scripts/**/*.ts', 'scripts/**/*.js', ...SCRIPTS_AI_PATTERNS],
+	scripts: ['scripts/**/*.ts', 'scripts/**/*.js'],
 	// joshuafolkken/kit#1414: `**/*.spec.ts` is deliberately absent. The same config bans that name
 	// outright, so handing it the test relaxation (`max-lines-per-function` 35 and the rest) is the
 	// config contradicting itself, and it is what makes `*.spec.ts` read as supported. A banned file
@@ -160,7 +157,7 @@ export function create_base_config({ gitignore_path, tsconfig_root_dir }) {
 			files: FILE_PATTERNS.scripts,
 			rules: {
 				'unicorn/no-process-exit': 'off',
-				// scripts under scripts/ and scripts-ai/ are dual-purpose: shebang-executable
+				// scripts under scripts/ are dual-purpose: shebang-executable
 				// (run via tsx) AND importable namespace modules (consumed via #scripts/* and
 				// in tests). unicorn/no-exports-in-scripts flags exports in any shebang file,
 				// which conflicts with the kit export { module } convention, so disable it here.
@@ -173,12 +170,6 @@ export function create_base_config({ gitignore_path, tsconfig_root_dir }) {
 				'@typescript-eslint/unbound-method': 'off',
 			},
 		},
-		{
-			files: FILE_PATTERNS.scripts_ai,
-			rules: {
-				'@typescript-eslint/no-restricted-imports': 'off',
-			},
-		},
 		{
 			files: FILE_PATTERNS.tests,
 			rules: {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1005.0",
+  "version": "1.1035.0",
   "name": "@joshuafolkken/kit",
   "description": "Development toolkit for AI-assisted projects: formatting, AI assistant rules and a Git/GitHub Issue workflow for any repository, plus lint, type check, tests and hooks for Node projects",
   "keywords": [
@@ -30,9 +30,7 @@
   "files": [
     "dist",
     "scripts",
-    "scripts-ai",
     "prompts",
-    "evals",
     "templates",
     "env",
     "eslint",
@@ -65,10 +63,38 @@
     "!**/*.test.ts",
     "!scripts/gh/gh-subcommand-guard.ts",
     "!**/*.spec.ts",
-    "!**/*-fixture.ts",
+    "!**/*-fixture*.ts",
+    "!**/__snapshots__",
+    "!**/*.golden.txt",
     "!scripts/eval",
     "!scripts/time",
-    "!scripts/cost"
+    "!scripts/cost",
+    "!scripts/retrospective",
+    "!scripts/test/classify-isolation.ts",
+    "!scripts/test/http-fault-injection.ts",
+    "!scripts/test/josh-harness*.ts",
+    "!scripts/test/pure-files.ts",
+    "!scripts/test/test-network-guard.ts",
+    "!scripts/test/test-repository-guard.ts",
+    "!scripts/test/test-state-guard.ts",
+    "!scripts/test/test-stdout-guard.ts",
+    "!scripts/test/test-telegram-guard.ts",
+    "!scripts/test/unit-guard-environment.ts",
+    "!scripts/test/unit-projects.ts",
+    "!scripts/test/vitest-include-globs.ts",
+    "!scripts/build/shim-shell.ts",
+    "!scripts/claude/skill-meta.ts",
+    "!scripts/document/document-scan.ts",
+    "!scripts/document/generate-catalog.ts",
+    "!scripts/document/retired-phrases.ts",
+    "!scripts/document/review-agent-type.ts",
+    "!scripts/document/single-source.ts",
+    "!scripts/hooks/prompt-hooks.ts",
+    "!scripts/init/hook-command-bootstrap.ts",
+    "!scripts/josh/josh-script-reader.ts",
+    "!scripts/package/production-dependency-graph.ts",
+    "!scripts/rules/delivered-rules-harness.ts",
+    "!scripts/rules/top-level-scripts-guard.ts"
   ],
   "imports": {
     "#eslint/*": "./eslint/*",
@@ -208,7 +234,7 @@
     "eslint-plugin-unicorn": "^76.0.0",
     "eslint_d": "^15.0.3",
     "globals": "^17.12.0",
-    "lefthook": "^2.1.14",
+    "lefthook": "^2.1.15",
     "prettier": "^3.9.9",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.1",