@joshuafolkken/kit 1.1471.0 → 1.1784.0

package/dist/commands/{document-section-cli.js → document-section-main.js}

@@ -1,13 +1,113 @@
 #!/usr/bin/env tsx
 
+// scripts/document/document-section-main.ts
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+
 // scripts/document/document-section-cli.ts
-import { existsSync as existsSync2 } from "node:fs";
-import path6 from "node:path";
+import { existsSync as existsSync3 } from "node:fs";
+import path8 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
+// scripts/josh/package-directory.ts
+import { existsSync } from "node:fs";
+
+// scripts/lib/ancestor-directories.ts
+import path from "node:path";
+var MAX_DEPTH = 64;
+function list(start_directory) {
+  const directories = [];
+  let current = path.resolve(start_directory);
+  while (directories.length < MAX_DEPTH && !directories.includes(current)) {
+    directories.push(current);
+    current = path.dirname(current);
+  }
+  return directories;
+}
+function nearest(start_directory, is_match2) {
+  return list(start_directory).find((directory) => is_match2(directory));
+}
+var ancestor_directories = { list, nearest };
+
+// scripts/lib/package-manifest.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import path2 from "node:path";
+
+// scripts/lib/json-value.ts
+function parse_or_undefined(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function parse_with(text, schema) {
+  const value = parse_or_undefined(text);
+  if (value === void 0) return void 0;
+  const parsed = schema.safeParse(value);
+  return parsed.success ? parsed.data : void 0;
+}
+function parse_array(text) {
+  const value = parse_or_undefined(text);
+  return Array.isArray(value) ? value : void 0;
+}
+function is_record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var json_value = { parse_or_undefined, parse_with, parse_array, is_record };
+
+// 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(path9) {
+  try {
+    return readFileSync(path9, "utf8");
+  } catch (error) {
+    if (is_absent(error)) return void 0;
+    throw error;
+  }
+}
+function read_file_or_empty(path9) {
+  return read_optional(path9) ?? "";
+}
+function read_if_readable(path9) {
+  try {
+    return readFileSync(path9, "utf8");
+  } catch {
+    return void 0;
+  }
+}
+var file_reader = { is_absent, read_optional, read_file_or_empty, read_if_readable };
+
+// scripts/lib/package-manifest.ts
+var PACKAGE_JSON = "package.json";
+function manifest_path(directory) {
+  return path2.join(directory, PACKAGE_JSON);
+}
+function read_manifest(directory, schema) {
+  const text = readFileSync2(manifest_path(directory), "utf8");
+  return schema.parse(JSON.parse(text));
+}
+function read_manifest_if_valid(directory, schema) {
+  const text = file_reader.read_if_readable(manifest_path(directory));
+  if (text === void 0) return void 0;
+  return json_value.parse_with(text, schema);
+}
+var package_manifest = { manifest_path, read_manifest, read_manifest_if_valid };
+
+// scripts/josh/package-directory.ts
+function find_package_directory(start_directory) {
+  return ancestor_directories.nearest(
+    start_directory,
+    (directory) => existsSync(package_manifest.manifest_path(directory))
+  ) ?? start_directory;
+}
+
 // scripts/document/capped-print.ts
 import { mkdtempSync, writeFileSync } from "node:fs";
-import path3 from "node:path";
+import path5 from "node:path";
 
 // scripts/josh/platform-temporary.ts
 import { accessSync, constants } from "node:fs";
@@ -82,33 +182,7 @@ function reading_block(parts, cap) {
 var review_diff_parts = { body_of, part_texts, reading_block, split_text };
 
 // scripts/document/bash-output-cap.ts
-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(path7) {
-  try {
-    return readFileSync(path7, "utf8");
-  } catch (error) {
-    if (is_absent(error)) return void 0;
-    throw error;
-  }
-}
-function read_file_or_empty(path7) {
-  return read_optional(path7) ?? "";
-}
-function read_if_readable(path7) {
-  try {
-    return readFileSync(path7, "utf8");
-  } catch {
-    return void 0;
-  }
-}
-var file_reader = { read_optional, read_file_or_empty, read_if_readable };
+import path3 from "node:path";
 
 // scripts/document/document-scan.ts
 var COMMAND_PATTERN = /`(?:pnpm )?josh ([a-z][a-z0-9:-]+)/gu;
@@ -131,8 +205,8 @@ function is_real_label(token) {
 function label_references(text) {
   return matches(text, LABEL_PATTERN).map((match) => match[1] ?? "").filter((token) => is_real_label(token));
 }
-function base_name(path7) {
-  return path7.split("/").at(-1) ?? path7;
+function base_name(path9) {
+  return path9.split("/").at(-1) ?? path9;
 }
 function is_placeholder_file(name) {
   return name.includes("<") || PLACEHOLDER_FILES.has(base_name(name).toLowerCase());
@@ -313,7 +387,7 @@ var document_section = {
 };
 
 // scripts/document/bash-output-cap.ts
-var SETTINGS_FILE = path.join(".claude", "settings.json");
+var SETTINGS_FILE = path3.join(".claude", "settings.json");
 var HARNESS_DEFAULT_CAP_CHARS = 3e4;
 var ENV_KEY = "env";
 var CAP_KEY = "BASH_MAX_OUTPUT_LENGTH";
@@ -330,14 +404,14 @@ function declared_cap(text) {
   }
 }
 function bash_output_cap(root) {
-  const text = document_section.read_optional(path.join(root, SETTINGS_FILE)) ?? "";
+  const text = document_section.read_optional(path3.join(root, SETTINGS_FILE)) ?? "";
   const chars = Number(declared_cap(text));
   return Number.isSafeInteger(chars) && chars > NONE ? chars : HARNESS_DEFAULT_CAP_CHARS;
 }
 var bash_output_cap_reader = { HARNESS_DEFAULT_CAP_CHARS, bash_output_cap };
 
 // scripts/document/capped-print-part.ts
-import path2 from "node:path";
+import path4 from "node:path";
 var DIRECTORY_PREFIX = "josh-capped-print-";
 var PART_PREFIX = "part-";
 var PART_SUFFIX = ".md";
@@ -346,8 +420,8 @@ function part_name(index) {
   return `${PART_PREFIX}${String(index + 1)}${PART_SUFFIX}`;
 }
 function is_part_file(absolute) {
-  const parent = path2.basename(path2.dirname(absolute));
-  return parent.startsWith(DIRECTORY_PREFIX) && PART_PATTERN.test(path2.basename(absolute));
+  const parent = path4.basename(path4.dirname(absolute));
+  return parent.startsWith(DIRECTORY_PREFIX) && PART_PATTERN.test(path4.basename(absolute));
 }
 var capped_print_part = { DIRECTORY_PREFIX, part_name, is_part_file };
 
@@ -356,9 +430,9 @@ var FILE_MODE = 384;
 var LINE_BREAK2 = "\n";
 var HEADROOM_CHARS = 512;
 function write_parts(label, text, cap) {
-  const directory = mkdtempSync(path3.join(PLATFORM_TEMP_ROOT, capped_print_part.DIRECTORY_PREFIX));
+  const directory = mkdtempSync(path5.join(PLATFORM_TEMP_ROOT, capped_print_part.DIRECTORY_PREFIX));
   return review_diff_parts.part_texts(label, text, cap).map((part, index) => {
-    const file = path3.join(directory, capped_print_part.part_name(index));
+    const file = path5.join(directory, capped_print_part.part_name(index));
     writeFileSync(file, part, { flag: "wx", mode: FILE_MODE });
     return file;
   });
@@ -385,13 +459,13 @@ function capped_print(text, label, root = process.cwd()) {
 var capped_output = { HEADROOM_CHARS, capped_print };
 
 // scripts/document/entry-read-set.ts
-import { existsSync } from "node:fs";
-import path5 from "node:path";
+import { existsSync as existsSync2 } from "node:fs";
+import path7 from "node:path";
 
 // scripts/init/init-paths.ts
-import path4 from "node:path";
+import path6 from "node:path";
 import { fileURLToPath } from "node:url";
-var PACKAGE_DIR = path4.join(path4.dirname(fileURLToPath(import.meta.url)), "..", "..");
+var PACKAGE_DIR = path6.join(path6.dirname(fileURLToPath(import.meta.url)), "..", "..");
 var PROJECT_ROOT = process.cwd();
 
 // scripts/cost-runtime/cost-tokens.ts
@@ -517,7 +591,7 @@ var read_set_point_of_use = {
 // scripts/document/entry-read-set.ts
 var { POINT_OF_USE_FILES: POINT_OF_USE_FILES2, POINT_OF_USE_BY_ENTRY: POINT_OF_USE_BY_ENTRY2, is_point_of_use: is_point_of_use2, point_of_use_files: point_of_use_files2 } = read_set_point_of_use;
 var { cost_of: cost_of2, scoped_file_cost: scoped_file_cost2, total: total2 } = read_set_cost;
-var SKILL_DIRECTORY = path5.join(".claude", "skills", "workflow-commands");
+var SKILL_DIRECTORY = path7.join(".claude", "skills", "workflow-commands");
 var SKILL_FILE = "SKILL.md";
 var TABLE_SECTION = "1. Which file to read";
 var NOTHING2 = 0;
@@ -529,11 +603,11 @@ var ENTRY_KEYWORD = /`(?<keyword>[a-z]+)/u;
 var SECTION_REFERENCE = /`(?<file>[\w.-]+\.md)` *→ *"(?<heading>[^"]+)"/gu;
 var WHITESPACE_RUN = /\s+/gu;
 function document_path(root, name) {
-  const in_project = path5.join(root, SKILL_DIRECTORY, name);
-  const in_package = path5.join(PACKAGE_DIR, SKILL_DIRECTORY, name);
-  const project_manifest = path5.join(root, "package.json");
-  if (root !== "" && existsSync(project_manifest) && existsSync(in_package)) return in_package;
-  return existsSync(in_project) ? in_project : in_package;
+  const in_project = path7.join(root, SKILL_DIRECTORY, name);
+  const in_package = path7.join(PACKAGE_DIR, SKILL_DIRECTORY, name);
+  const project_manifest = path7.join(root, "package.json");
+  if (root !== "" && existsSync2(project_manifest) && existsSync2(in_package)) return in_package;
+  return existsSync2(in_project) ? in_project : in_package;
 }
 function read_document(root, name) {
   return document_section.read_optional(document_path(root, name)) ?? "";
@@ -715,17 +789,19 @@ var entry_read_set = {
 };
 
 // scripts/document/document-section-cli.ts
-var ARGV_OFFSET = 2;
 var FAILURE_EXIT_CODE = 1;
 var FILE_ARGUMENT = 0;
 var HEADING_ARGUMENT = 1;
 var NO_CANDIDATE = 0;
 var USAGE = 'Usage: josh doc:section <file.md> "<heading>"';
-function resolve_document(name, root = process.cwd()) {
-  const named = path6.resolve(root, name);
-  if (existsSync2(named)) return named;
-  const in_skill = entry_read_set.document_path(root, name);
-  return existsSync2(in_skill) ? in_skill : named;
+var PACKAGE_DIRECTORY = find_package_directory(path8.dirname(fileURLToPath2(import.meta.url)));
+function candidates_under(directory, name) {
+  return [path8.resolve(directory, name), entry_read_set.document_path(directory, name)];
+}
+function resolve_document(name, root = process.cwd(), package_directory = PACKAGE_DIRECTORY) {
+  const named = path8.resolve(root, name);
+  const candidates2 = [...candidates_under(root, name), ...candidates_under(package_directory, name)];
+  return candidates2.find((candidate) => existsSync3(candidate)) ?? named;
 }
 function report_missing(markdown, heading) {
   const near = document_section.candidates(markdown, heading);
@@ -756,11 +832,10 @@ function run(argv, root = process.cwd()) {
   const markdown = read_named(name, root);
   return markdown === void 0 ? FAILURE_EXIT_CODE : print_section(markdown, heading, root);
 }
-function main(argv) {
-  process.exitCode = run(argv);
-}
 var document_section_cli = { FAILURE_EXIT_CODE, USAGE, resolve_document, run };
-if (process.argv[1] === fileURLToPath2(import.meta.url)) main(process.argv.slice(ARGV_OFFSET));
-export {
-  document_section_cli
-};
+
+// scripts/document/document-section-main.ts
+if (process.argv[1] === fileURLToPath3(import.meta.url)) {
+  const ARGV_OFFSET = 2;
+  process.exitCode = document_section_cli.run(process.argv.slice(ARGV_OFFSET));
+}