@joshuafolkken/kit 1.2114.0 → 1.3000.0

package/dist/commands/command-derive.js

@@ -0,0 +1,802 @@
+#!/usr/bin/env tsx
+import {
+  document_byte_budget
+} from "./chunk-M3ZDYCUF.js";
+import {
+  CATEGORY_ORDER,
+  COMMAND_MAP
+} from "./chunk-5HWZFL4D.js";
+import {
+  ALIASES,
+  canonical_command
+} from "./chunk-ROJXMBXP.js";
+import "./chunk-RUWV4INF.js";
+import "./chunk-JTU5A4JI.js";
+import "./chunk-FNQW6NY7.js";
+import "./chunk-MDLOETXL.js";
+import "./chunk-65E4OZJ7.js";
+import "./chunk-WQ6FS544.js";
+import "./chunk-6HRRZANN.js";
+import "./chunk-YIA6FC3K.js";
+import "./chunk-66NX6EXR.js";
+import "./chunk-3NWAGIA6.js";
+import "./chunk-HLUS2M3D.js";
+import "./chunk-AKK56GNX.js";
+import "./chunk-TBIX5FRN.js";
+import "./chunk-IGD6QJPH.js";
+import "./chunk-R6QE5VJG.js";
+import "./chunk-OKYFQJW3.js";
+import "./chunk-QWWTC3XR.js";
+import "./chunk-ILGPZ47M.js";
+import "./chunk-3CCGKX7Y.js";
+import "./chunk-KSR23NYN.js";
+import {
+  refactor_lint
+} from "./chunk-7W3D3WRW.js";
+import "./chunk-UIWAMLQH.js";
+import "./chunk-D5TAR6TV.js";
+import "./chunk-G47ZNQVG.js";
+import "./chunk-ENFPR7J2.js";
+import "./chunk-F7XLEK55.js";
+import "./chunk-UGCUSRZF.js";
+import "./chunk-RBU2NKHF.js";
+import "./chunk-NKKH3PBE.js";
+import "./chunk-ZNX2LJCQ.js";
+import "./chunk-WPAQUMHC.js";
+import "./chunk-HIU2WXB6.js";
+
+// tools/document/command-derive.ts
+import { dirname as __josh_dirname3 } from "node:path";
+import { fileURLToPath as __josh_file_path3 } from "node:url";
+import { readFileSync, statSync, writeFileSync } from "node:fs";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+
+// tools/document/derived-artifacts.ts
+var DERIVE_COMMAND = "pnpm josh command:derive";
+function is_over({ path, bytes }) {
+  const ceiling = document_byte_budget.recorded_bytes_for(path);
+  return ceiling !== void 0 && bytes > ceiling;
+}
+function byte_line({ path, bytes }) {
+  const ceiling = document_byte_budget.recorded_bytes_for(path);
+  if (ceiling === void 0) return `${path}: ${String(bytes)} bytes, no ceiling recorded`;
+  const { over_budget_message } = document_byte_budget;
+  if (bytes > ceiling) return `over: ${over_budget_message(path, bytes, ceiling)}`;
+  const left = String(document_byte_budget.remaining_bytes(ceiling, bytes));
+  return `${path}: ${String(bytes)} / ${String(ceiling)} bytes, ${left} left`;
+}
+var derived_artifacts = {
+  DERIVE_COMMAND,
+  byte_line,
+  is_over
+};
+
+// tools/document/generate-catalog.ts
+import { dirname as __josh_dirname } from "node:path";
+import { fileURLToPath as __josh_file_path } from "node:url";
+import { fileURLToPath } from "node:url";
+var __josh_meta = import.meta;
+var __josh_source_url = new URL("../../tools/document/generate-catalog.ts", __josh_meta.url).href;
+var __josh_source_filename = __josh_file_path(__josh_source_url);
+var __josh_source_dirname = __josh_dirname(__josh_source_filename);
+var CATALOG_FILE = fileURLToPath(new URL("../../docs/josh-command-catalog.md", __josh_source_url));
+var REGENERATE_COMMAND = derived_artifacts.DERIVE_COMMAND;
+var PREAMBLE = `# josh CLI \u2014 Command Catalog
+
+Auto-generated \u2014 do not edit.
+Run \`${REGENERATE_COMMAND}\` to regenerate.
+
+`;
+function aliases_for(command_name) {
+  return Object.entries(ALIASES).filter(([, target]) => target === command_name).map(([alias]) => alias).toSorted((x, y) => x.localeCompare(y));
+}
+var TABLE_HEAD = [
+  "| Command | Arguments | Audience | Side effects | Description |",
+  "| --- | --- | --- | --- | --- |"
+].join("\n");
+function table_cell(text) {
+  return text.replaceAll("|", String.raw`\|`);
+}
+function format_command_cell(name, entry) {
+  const spans = [name, ...aliases_for(name)].map((spelling) => `\`josh ${spelling}\``).join(" \xB7 ");
+  return entry.is_kit_only === true ? `${spans} \xB7 **kit only**` : spans;
+}
+function format_command_entry(name, entry) {
+  const [synopsis, audience, side_effects] = entry.reference;
+  const cells = [
+    format_command_cell(name, entry),
+    synopsis ? `\`${synopsis}\`` : "\u2014",
+    audience,
+    side_effects.join(", "),
+    entry.description
+  ];
+  return `| ${cells.map((cell) => table_cell(cell)).join(" | ")} |`;
+}
+function entries_for_category(category) {
+  return Object.entries(COMMAND_MAP).filter(([, entry]) => entry.category === category).toSorted(([name_a], [name_b]) => name_a.localeCompare(name_b));
+}
+function generate_category_section(category) {
+  const entries = entries_for_category(category);
+  if (entries.length === 0) return "";
+  const rows = entries.map(([name, entry]) => format_command_entry(name, entry));
+  return `## ${category}
+
+${TABLE_HEAD}
+${rows.join("\n")}
+
+`;
+}
+function generate_catalog() {
+  const content = PREAMBLE + CATEGORY_ORDER.map((cat) => generate_category_section(cat)).join("");
+  return `${content.trimEnd()}
+`;
+}
+
+// tools/document/generate-command-usage.ts
+import { dirname as __josh_dirname2 } from "node:path";
+import { fileURLToPath as __josh_file_path2 } from "node:url";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+
+// scripts/josh/command-usage.ts
+var USAGE_PAGES = [
+  "docs/josh-commands.md",
+  "docs/josh-commands-run.md",
+  "docs/josh-commands-board.md",
+  "docs/josh-commands-lane.md",
+  "docs/josh-commands-session.md",
+  "docs/josh-commands-backlog.md",
+  "docs/josh-commands-automation.md"
+];
+var NOTE_GAP = 3;
+function usage_for(name) {
+  return Object.hasOwn(COMMAND_MAP, name) ? COMMAND_MAP[name]?.usage : void 0;
+}
+function example_line(name, example) {
+  const command = example.arguments ? `pnpm josh ${name} ${example.arguments}` : `pnpm josh ${name}`;
+  return { command, note: example.note };
+}
+function format_examples(name, usage) {
+  const lines = usage.examples.map((example) => example_line(name, example));
+  const width = Math.max(...lines.map((line) => line.command.length)) + NOTE_GAP;
+  const rendered = lines.map(
+    (line) => line.note === void 0 ? line.command : `${line.command.padEnd(width)}# ${line.note}`
+  );
+  return ["```bash", ...rendered, "```"].join("\n");
+}
+function code_span(text) {
+  return `\`${text}\``;
+}
+function format_flags(flags) {
+  const items = flags.map(
+    (flag) => `- ${flag.names.map((spelling) => code_span(spelling)).join(" / ")} \u2014 ${flag.description}`
+  );
+  return ["**Options:**", "", ...items].join("\n");
+}
+function format_usage(name) {
+  const usage = usage_for(name);
+  if (usage === void 0) return void 0;
+  const flags = usage.flags === void 0 ? [] : [format_flags(usage.flags)];
+  return [format_examples(name, usage), ...flags].join("\n\n");
+}
+function format_command_help(input) {
+  const name = canonical_command(input);
+  const entry = Object.hasOwn(COMMAND_MAP, name) ? COMMAND_MAP[name] : void 0;
+  if (entry === void 0) return void 0;
+  const [synopsis] = entry.reference;
+  const head = synopsis ? `josh ${name} ${synopsis}` : `josh ${name}`;
+  return [head, "", entry.description, "", format_usage(name)].join("\n");
+}
+var command_usage = {
+  USAGE_PAGES,
+  format_command_help,
+  format_usage
+};
+
+// tools/document/generate-command-usage.ts
+var __josh_meta2 = import.meta;
+var __josh_source_url2 = new URL("../../tools/document/generate-command-usage.ts", __josh_meta2.url).href;
+var __josh_source_filename2 = __josh_file_path2(__josh_source_url2);
+var __josh_source_dirname2 = __josh_dirname2(__josh_source_filename2);
+var REGENERATE_COMMAND2 = derived_artifacts.DERIVE_COMMAND;
+var { USAGE_PAGES: USAGE_PAGES2 } = command_usage;
+var USAGE_BLOCK = /<!-- usage: (?<name>\S+) -->\n[\s\S]*?<!-- \/usage -->/gu;
+function usage_spans(text) {
+  return [...text.matchAll(USAGE_BLOCK)].map((match) => match.groups?.["name"] ?? "");
+}
+function as_sentence(text) {
+  return /[.!?]$/u.test(text) ? text : `${text}.`;
+}
+function summary_line(name) {
+  return as_sentence(COMMAND_MAP[name]?.description ?? "");
+}
+function usage_block(name) {
+  const usage = command_usage.format_usage(name);
+  if (usage === void 0) throw new Error(`no usage is registered for \`josh ${name}\``);
+  return `<!-- usage: ${name} -->
+
+${summary_line(name)}
+
+${usage}
+
+<!-- /usage -->`;
+}
+function fill_usage_blocks(text) {
+  return text.replaceAll(USAGE_BLOCK, (_block, name) => usage_block(name));
+}
+function page_path(page) {
+  return fileURLToPath2(new URL(`../../${page}`, __josh_source_url2));
+}
+var generate_command_usage = {
+  USAGE_PAGES: USAGE_PAGES2,
+  as_sentence,
+  fill_usage_blocks,
+  page_path,
+  REGENERATE_COMMAND: REGENERATE_COMMAND2,
+  usage_spans
+};
+
+// eslint/rules/code-quality.js
+var code_quality_test_rules = {
+  "max-lines-per-function": ["error", { max: 35, skipBlankLines: true, skipComments: true }]
+};
+var code_quality_rules = {
+  // ===== 一般的なコード品質 =====
+  // console の使用を警告（開発時は許可、本番ではエラーにするべき）
+  "no-console": ["error"],
+  // 'no-console': ['error', { allow: ['warn', 'error', 'info'] }],
+  // デバッガーの使用を禁止
+  "no-debugger": "error",
+  // var の使用を禁止
+  "no-var": "error",
+  // const を優先
+  "prefer-const": "error",
+  // アロー関数を優先（名前付き関数式はスタックトレース可読性のため許可）
+  "prefer-arrow-callback": ["error", { allowNamedFunctions: true }],
+  // 関数は function 宣言で書く（joshuafolkken/kit#3294）。SvelteKit の型付き const export は
+  // eslint/base.js が該当ファイルだけ allowTypeAnnotation で許可する
+  "func-style": ["error", "declaration"],
+  // テンプレートリテラルを優先
+  "prefer-template": "error",
+  // 等価演算子は厳密等価を使用
+  eqeqeq: ["error", "always"],
+  // 不要な return を禁止
+  "no-useless-return": "error",
+  // 不要な catch を禁止
+  "no-useless-catch": "error",
+  // 複雑度の制限
+  complexity: ["error", 5],
+  // 最大ネストレベル
+  "max-depth": ["error", 2],
+  // 関数の最大行数
+  "max-lines-per-function": ["error", { max: 25, skipBlankLines: true, skipComments: true }],
+  // ファイルの最大行数
+  "max-lines": ["error", { max: 300, skipBlankLines: true, skipComments: true }],
+  // パラメータの最大数
+  "max-params": ["error", 4],
+  // 関数内の文の数を制限
+  "max-statements": ["error", 10],
+  // 1行の最大長
+  "max-len": [
+    "error",
+    {
+      code: 100,
+      tabWidth: 2,
+      ignoreUrls: true,
+      ignoreStrings: true,
+      ignoreTemplateLiterals: true,
+      ignoreRegExpLiterals: true,
+      ignoreComments: true,
+      ignorePattern: String.raw`^\s*class(:|=)|d="`
+    }
+  ],
+  // 一貫した return
+  "consistent-return": "error",
+  // 不要な else を禁止
+  "no-else-return": "error",
+  // 重複したインポートを禁止
+  "no-duplicate-imports": "error",
+  // 変数名の最小・最大長を制限
+  "id-length": [
+    "error",
+    {
+      min: 2,
+      max: 45,
+      exceptions: ["_", "e", "i", "j", "k", "t", "x", "y", "z"],
+      properties: "never"
+    }
+  ],
+  // 空のブロック文を禁止
+  "no-empty": ["error", { allowEmptyCatch: false }],
+  // ループ内で関数を作成することを禁止
+  "no-loop-func": "error",
+  // 同じ変数への複数回の代入を制限
+  "no-multi-assign": "error",
+  // 複数の空行を禁止
+  "no-multiple-empty-lines": ["error", { max: 1, maxEOF: 0, maxBOF: 0 }],
+  // ネストされた三項演算子を禁止
+  "no-nested-ternary": "error",
+  // new演算子を単独で使用することを禁止
+  "no-new": "error",
+  // 配列コンストラクタを禁止
+  "no-array-constructor": "error",
+  // Objectコンストラクタを禁止
+  "no-object-constructor": "error",
+  // 不要な計算プロパティキーを禁止
+  "no-useless-computed-key": "error",
+  // 不要なコンストラクタを禁止
+  "no-useless-constructor": "off",
+  // TypeScript版を使用
+  "@typescript-eslint/no-useless-constructor": "error",
+  // 不要な連結を禁止
+  "no-useless-concat": "error",
+  // 不要なエスケープを禁止
+  "no-useless-escape": "error",
+  // void演算子を禁止
+  "no-void": ["error", { allowAsStatement: true }],
+  // ラベル付き文を禁止
+  "no-labels": "error",
+  // 単独のifをelse内に置くことを禁止
+  "no-lonely-if": "error",
+  // 短絡評価を優先
+  "no-unneeded-ternary": "error",
+  // オブジェクトのショートハンドを優先
+  "object-shorthand": ["error", "always"],
+  // 分割代入を優先
+  "prefer-destructuring": [
+    "error",
+    {
+      VariableDeclarator: {
+        array: true,
+        object: true
+      },
+      AssignmentExpression: {
+        array: false,
+        object: false
+      }
+    },
+    {
+      enforceForRenamedProperties: false
+    }
+  ],
+  // 指数演算子を優先
+  "prefer-exponentiation-operator": "error",
+  // 数値リテラルを優先
+  "prefer-numeric-literals": "error",
+  // Object.hasOwnを優先
+  "prefer-object-has-own": "error",
+  // オブジェクトスプレッドを優先
+  "prefer-object-spread": "error",
+  // restパラメータを優先
+  "prefer-rest-params": "error",
+  // スプレッド演算子を優先
+  "prefer-spread": "error",
+  // 正規表現リテラルを優先
+  "prefer-regex-literals": "error",
+  // Promiseのrejectには必ずErrorオブジェクトを渡す
+  "prefer-promise-reject-errors": "error",
+  // 基数パラメータを必須に
+  radix: "error",
+  // await式を要求
+  "require-atomic-updates": "error",
+  // Unicode正規表現フラグを要求
+  "require-unicode-regexp": "error",
+  // Symbolの説明を必須に
+  "symbol-description": "error",
+  // Yodaスタイルを禁止
+  yoda: "error",
+  // パラメータの再代入を禁止
+  "no-param-reassign": "error",
+  // 暗黙的な型変換を禁止
+  "no-implicit-coercion": "error",
+  // カンマ演算子を禁止
+  "no-sequences": "error",
+  // ビット演算子を禁止
+  "no-bitwise": "error",
+  // continue は許可する（issue #599）。ループ先頭のガード節（if (skip) continue）は
+  // 早期 return と同じくネストを1段下げる手法で、本プロジェクトの早期 return 推奨・
+  // nesting≤2 の方針と整合する。unicorn 68 の recommended が有効化する
+  // unicorn/prefer-continue とも衝突しない。
+  "no-continue": "off",
+  // インクリメント・デクリメント演算子を禁止
+  "no-plusplus": ["error", { allowForLoopAfterthoughts: true }],
+  // arguments.caller/calleeを禁止
+  "no-caller": "error",
+  // evalを禁止
+  "no-eval": "error",
+  // 暗黙的なevalを禁止
+  "no-implied-eval": "error",
+  // with文を禁止
+  "no-with": "error",
+  // __iterator__を禁止
+  "no-iterator": "error",
+  // __proto__を禁止
+  "no-proto": "error",
+  // スクリプトURLを禁止
+  "no-script-url": "error",
+  // カンマ演算子を禁止（ループを除く）
+  "no-restricted-syntax": [
+    "error",
+    {
+      selector: "ForInStatement",
+      message: "for..in loops iterate over the entire prototype chain, which is virtually never what you want. Use Object.{keys,values,entries}, and iterate over the resulting array."
+    },
+    {
+      selector: "LabeledStatement",
+      message: "Labels are a form of GOTO; using them makes code confusing and hard to maintain and understand."
+    },
+    {
+      selector: "WithStatement",
+      message: "`with` is disallowed in strict mode because it makes code impossible to predict and optimize."
+    },
+    {
+      selector: "ExportNamedDeclaration > FunctionDeclaration:not([id.name=/^use_/])",
+      message: "Individual named exports (functions) are not allowed. Use object export instead. Example: export const module_name = { function_name }"
+    },
+    {
+      selector: 'ExportNamedDeclaration > VariableDeclaration[declarations.length=1] > VariableDeclarator[id.type="Identifier"]:not([id.name=/^[A-Z_][A-Z_0-9]*$/]):not([init.type="ObjectExpression"]):not([init.type="ArrayExpression"]):not([init.type="ArrowFunctionExpression"])',
+      message: "Individual named exports (constants) are not allowed (except UPPER_CASE). Use object export instead. Example: export const module_name = { constant_name }"
+    }
+  ],
+  // delete演算子を変数に使用することを禁止
+  "no-delete-var": "error",
+  // undefinedへの代入を禁止
+  // 'no-undefined': 'error',
+  // 初期化されていない変数を禁止
+  "init-declarations": ["error", "always"],
+  // シャドーイングを禁止
+  "no-shadow": "off",
+  // TypeScript版を使用
+  "@typescript-eslint/no-shadow": "error",
+  // グローバル変数のシャドーイングを禁止
+  "no-shadow-restricted-names": "error",
+  // alert/confirm/promptを禁止
+  "no-alert": "error",
+  // 拡張されたネイティブオブジェクトを禁止
+  "no-extend-native": "error",
+  // 不要なbind()を禁止
+  "no-extra-bind": "error",
+  // 不要なラベルを禁止
+  "no-extra-label": "error",
+  // caseのフォールスルーを禁止
+  "no-fallthrough": "error",
+  // 浮動小数点の省略を禁止
+  "no-floating-decimal": "error",
+  // グローバル変数への代入を禁止
+  "no-global-assign": "error",
+  // 型変換の短縮形を禁止
+  "no-implicit-globals": "error",
+  // ループ内で変更されない条件を禁止
+  "no-unmodified-loop-condition": "error",
+  // 不要な.call()/.apply()を禁止
+  "no-useless-call": "error",
+  // カーリーブレースを必須化
+  curly: ["error", "multi-line"],
+  // default caseを要求
+  "default-case": "error",
+  // default caseを最後に配置
+  "default-case-last": "error",
+  // ドット記法を優先
+  // joshuafolkken/kit#1783: コア版は構文だけを見るため、index signature 由来のプロパティにも
+  // `--fix` でドット記法を強制する。その出力を tsconfig/base.json の
+  // noPropertyAccessFromIndexSignature が TS4111 で拒否するので、自動修正と型チェックのあいだに
+  // 固定点が無くなる。TypeScript 版は noPropertyAccessFromIndexSignature を自分で検出して
+  // index signature を除外するため、そちらの出力は常に型チェックを通る。
+  "dot-notation": "off",
+  // TypeScript版を使用
+  "@typescript-eslint/dot-notation": ["error", { allowPattern: "^[A-Z0-9_]+$" }],
+  // 分割代入のデフォルト値を要求
+  "default-param-last": "error",
+  // グループ化された変数宣言を要求
+  "one-var": ["error", "never"],
+  // 変数を使用する前に宣言を要求
+  "no-use-before-define": "off",
+  // TypeScript版を使用
+  "@typescript-eslint/no-use-before-define": "error",
+  // throw文でErrorオブジェクトを要求
+  "no-throw-literal": "off",
+  // TypeScript版を使用
+  "@typescript-eslint/only-throw-error": "error",
+  // 文字列リテラルでのオクタル・エスケープシーケンスを禁止
+  "no-octal-escape": "error",
+  // 8進数リテラルを禁止
+  "no-octal": "error",
+  // 関数のパラメータ名の重複を禁止
+  "no-dupe-args": "error",
+  // オブジェクトのキーの重複を禁止
+  "no-dupe-keys": "error",
+  // case句の重複を禁止
+  "no-duplicate-case": "error",
+  // 正規表現での空の文字クラスを禁止
+  "no-empty-character-class": "error",
+  // 条件式での代入を禁止
+  "no-cond-assign": "error",
+  // 定数条件を禁止
+  "no-constant-condition": "error",
+  // 制御文字を禁止
+  "no-control-regex": "error",
+  // 未定義変数の使用を禁止（TypeScriptで管理）
+  // 'no-undef': 'error', // 既にoffに設定済み
+  // 正規表現での複数のスペースを禁止
+  "no-regex-spaces": "error",
+  // スパースアレイを禁止
+  "no-sparse-arrays": "error",
+  // アノテーションコメントを禁止（issueに登録すべき）
+  "no-warning-comments": [
+    "error",
+    {
+      terms: ["todo", "fixme", "hack"],
+      location: "anywhere"
+    }
+  ],
+  // async 関数は必ず await を含む
+  "require-await": "error"
+};
+
+// eslint/rules/english-only-prose.js
+var JAPANESE_RATIONALE_DIRECTORY = "eslint/rules/";
+
+// eslint/rules/sonarjs.js
+var sonarjs_rules = {
+  // 認知的複雑度の制限（より厳しい複雑度の指標）
+  "sonarjs/cognitive-complexity": ["error", 4],
+  // 同一の条件分岐を禁止
+  "sonarjs/no-identical-conditions": "error",
+  // 同一の関数を禁止
+  "sonarjs/no-identical-functions": "error",
+  // 重複した文字列リテラルを禁止
+  "sonarjs/no-duplicate-string": ["error", { threshold: 2 }],
+  // ネストされた制御フロー文を制限
+  "sonarjs/max-switch-cases": ["error", 3],
+  // コレクションのサイズを常にチェック
+  "sonarjs/no-collection-size-mischeck": "error",
+  // 無駄なジャンプ文を禁止
+  "sonarjs/no-redundant-jump": "error",
+  // 同じ条件の連続したif文を禁止
+  "sonarjs/no-same-line-conditional": "error",
+  // 使われない関数パラメータを禁止
+  "sonarjs/no-unused-collection": "error",
+  // すべてが同じ値を返すswitch文を禁止
+  "sonarjs/no-all-duplicated-branches": "error",
+  // 無駄な条件を禁止
+  "sonarjs/no-redundant-boolean": "error",
+  // Promiseコールバック内でのreturnを必須化
+  "promise/always-return": "error",
+  // catch()ハンドラを必須化
+  "promise/catch-or-return": "error",
+  // Promiseのexecutor関数内でのreturnを禁止
+  "promise/no-return-in-finally": "error",
+  // Promise.all()の引数が配列でない場合を禁止
+  "promise/valid-params": "error",
+  // Promiseチェーン内での一貫性を強制
+  "promise/prefer-await-to-then": "error",
+  // Promiseチェーン内での一貫性を強制
+  "promise/prefer-await-to-callbacks": "error",
+  // ブール値を返すだけの無駄な条件を禁止
+  "sonarjs/prefer-immediate-return": "error",
+  // 無駄なジャンプ文を禁止
+  "sonarjs/prefer-single-boolean-return": "error"
+  // // 非常に重いため無効化。非推奨チェックは @typescript-eslint/no-deprecated で十分
+  // 'sonarjs/deprecation': 'off',
+  // // AWS関連のルールは不要な場合が多い
+  // 'sonarjs/aws-restricted-ip-admin-access': 'off',
+};
+
+// tools/document/generate-lint-prose.ts
+import { z } from "zod";
+var REGENERATE_COMMAND3 = derived_artifacts.DERIVE_COMMAND;
+var LINT_PROSE_PAGES = [
+  "CLAUDE.md",
+  "prompts/coding-standards.md",
+  "prompts/refactoring.md"
+];
+var LINT_SPAN = /<!-- lint: (?<name>\S+) -->.*?<!-- \/lint -->/gu;
+var MAX_LINES_PER_FUNCTION = "max-lines-per-function";
+var LINE_RULES = ["max-lines", MAX_LINES_PER_FUNCTION];
+var NUMBER_LIMIT = z.tuple([z.string(), z.number()]);
+var CODE_LINE_LIMIT = z.tuple([
+  z.string(),
+  z.object({ max: z.number(), skipBlankLines: z.literal(true), skipComments: z.literal(true) })
+]);
+function number_limit(rules, name) {
+  return String(NUMBER_LIMIT.parse(rules[name])[1]);
+}
+function code_line_limit(rules, name) {
+  const parsed = CODE_LINE_LIMIT.safeParse(rules[name]);
+  if (!parsed.success) throw new Error(`\`${name}\` must skip blank lines and comments`);
+  return String(parsed.data[1].max);
+}
+function quality_limits() {
+  const rules = code_quality_rules;
+  const limits = [
+    `Function complexity \u2264${number_limit(rules, "complexity")}`,
+    `nesting \u2264${number_limit(rules, "max-depth")}`,
+    `function \u2264${code_line_limit(rules, MAX_LINES_PER_FUNCTION)} lines`,
+    `file \u2264${code_line_limit(rules, "max-lines")} lines`,
+    `params \u2264${number_limit(rules, "max-params")}`,
+    `statements per function \u2264${number_limit(rules, "max-statements")}`,
+    `cognitive complexity \u2264${number_limit(sonarjs_rules, "sonarjs/cognitive-complexity")}`
+  ];
+  const test_lines = code_line_limit(code_quality_test_rules, MAX_LINES_PER_FUNCTION);
+  return `${limits.join(" \xB7 ")} \u2014 line counts are code lines, not physical lines; test functions allow ${test_lines} code lines`;
+}
+function line_counting() {
+  return LINE_RULES.map((name) => {
+    code_line_limit(code_quality_rules, name);
+    return `\`${name}\``;
+  }).join(" / ");
+}
+function refactor_scan_rules() {
+  return refactor_lint.CATEGORIES.map((category) => {
+    const rules = category.rules.map((rule) => `\`${rule}\``).join(" / ");
+    const marker = category.priority === "low" ? "\u4F4E\u512A\u5148\u5EA6: " : "";
+    return `${category.label}\uFF08${marker}${rules}\uFF09`;
+  }).join("\u3001");
+}
+function english_only_exemption() {
+  return `\`${JAPANESE_RATIONALE_DIRECTORY}\``;
+}
+var RENDERERS = {
+  "quality-limits": quality_limits,
+  "line-counting": line_counting,
+  "refactor-scan-rules": refactor_scan_rules,
+  "english-only-exemption": english_only_exemption
+};
+function render(name) {
+  const renderer = RENDERERS[name];
+  if (renderer === void 0) throw new Error(`no lint prose is registered for \`${name}\``);
+  return `<!-- lint: ${name} -->${renderer()}<!-- /lint -->`;
+}
+function fill_lint_spans(text) {
+  return text.replaceAll(LINT_SPAN, (_span, name) => render(name));
+}
+function lint_spans(text) {
+  return [...text.matchAll(LINT_SPAN)].map((match) => match.groups?.["name"] ?? "");
+}
+var generate_lint_prose = {
+  LINT_PROSE_PAGES,
+  REGENERATE_COMMAND: REGENERATE_COMMAND3,
+  RENDERERS,
+  fill_lint_spans,
+  lint_spans
+};
+
+// tools/document/usage-span-placement.ts
+var DEVELOPER_PAGE = "docs/josh-commands.md";
+var FALLBACK_PAGE = "docs/josh-commands-automation.md";
+var SECTION_HEADING = /^#{2,3} /mu;
+var CATEGORY_HEADING = /^## /mu;
+var SECTION_RULE = "---\n\n";
+function prefix_of(name) {
+  return name.split(":", 1)[0] ?? name;
+}
+function siblings(text, name) {
+  const prefix = prefix_of(name);
+  return generate_command_usage.usage_spans(text).filter((span) => prefix_of(span) === prefix);
+}
+function sibling_page(name, pages) {
+  const counted = [...pages].filter(([page]) => page !== DEVELOPER_PAGE).map(([page, text]) => ({ page, count: siblings(text, name).length }));
+  const [best] = counted.toSorted((left, right) => right.count - left.count);
+  return best !== void 0 && best.count > 0 ? best.page : void 0;
+}
+function page_for(name, entry, pages) {
+  if (entry.reference[1] === "developer") return DEVELOPER_PAGE;
+  return sibling_page(name, pages) ?? FALLBACK_PAGE;
+}
+function heading_index(text, from, heading) {
+  const match = heading.exec(text.slice(from));
+  return match === null ? text.length : from + match.index;
+}
+function sibling_anchor(text, name) {
+  const last = siblings(text, name).at(-1);
+  if (last === void 0) return void 0;
+  return heading_index(text, text.indexOf(`<!-- usage: ${last} -->`), SECTION_HEADING);
+}
+function line_index(text, line) {
+  if (text.startsWith(line)) return 0;
+  const found = text.indexOf(`
+${line}`);
+  return found === -1 ? -1 : found + 1;
+}
+function category_anchor(text, category) {
+  const heading = `## ${category}
+`;
+  const start = line_index(text, heading);
+  if (start === -1) return text.length;
+  return heading_index(text, start + heading.length, CATEGORY_HEADING);
+}
+function span_section(name) {
+  return `### \`josh ${name}\`
+
+<!-- usage: ${name} -->
+<!-- /usage -->
+`;
+}
+function insert_section(text, at, name) {
+  const section = at === text.length ? `
+${span_section(name)}` : `${span_section(name)}
+`;
+  return `${text.slice(0, at)}${section}${text.slice(at)}`;
+}
+function above_rule(text, at) {
+  const start = at - SECTION_RULE.length;
+  return start >= 0 && text.startsWith(SECTION_RULE, start) ? start : at;
+}
+function with_span(pages, name, entry) {
+  const page = page_for(name, entry, pages);
+  const text = pages.get(page) ?? "";
+  const anchor = sibling_anchor(text, name) ?? category_anchor(text, entry.category);
+  return new Map([...pages, [page, insert_section(text, above_rule(text, anchor), name)]]);
+}
+function stale_spans(pages, commands) {
+  return [...pages].flatMap(
+    ([page, text]) => generate_command_usage.usage_spans(text).filter((name) => !Object.hasOwn(commands, name)).map((name) => `${page}: ${name}`)
+  );
+}
+function place_missing_spans(pages, commands) {
+  const present = new Set(
+    [...pages.values()].flatMap((text) => generate_command_usage.usage_spans(text))
+  );
+  let placed = pages;
+  for (const [name, entry] of Object.entries(commands)) {
+    if (!present.has(name)) placed = with_span(placed, name, entry);
+  }
+  return placed;
+}
+var usage_span_placement = { place_missing_spans, stale_spans };
+
+// tools/document/command-derive.ts
+var __josh_meta3 = import.meta;
+var __josh_source_url3 = new URL("../../tools/document/command-derive.ts", __josh_meta3.url).href;
+var __josh_source_filename3 = __josh_file_path3(__josh_source_url3);
+var __josh_source_dirname3 = __josh_dirname3(__josh_source_filename3);
+var { page_path: page_path2, USAGE_PAGES: USAGE_PAGES3 } = generate_command_usage;
+var CATALOG_PAGE = "docs/josh-command-catalog.md";
+function read_usage_pages() {
+  return new Map(USAGE_PAGES3.map((page) => [page, readFileSync(page_path2(page), "utf8")]));
+}
+function write_usage_pages(pages) {
+  const placed = usage_span_placement.place_missing_spans(pages, COMMAND_MAP);
+  for (const [page, text] of placed) {
+    writeFileSync(page_path2(page), generate_command_usage.fill_usage_blocks(text));
+  }
+}
+function filled_lint_prose_pages() {
+  return new Map(
+    generate_lint_prose.LINT_PROSE_PAGES.map((page) => [
+      page,
+      generate_lint_prose.fill_lint_spans(readFileSync(page_path2(page), "utf8"))
+    ])
+  );
+}
+function write_pages(pages) {
+  for (const [page, text] of pages) writeFileSync(page_path2(page), text);
+}
+function report_bytes() {
+  const sizes = [...USAGE_PAGES3, CATALOG_PAGE].map((path) => ({
+    path,
+    bytes: statSync(page_path2(path)).size
+  }));
+  console.info(sizes.map((size) => derived_artifacts.byte_line(size)).join("\n"));
+  return sizes.some((size) => derived_artifacts.is_over(size)) ? 1 : 0;
+}
+function main() {
+  const pages = read_usage_pages();
+  const stale = usage_span_placement.stale_spans(pages, COMMAND_MAP);
+  if (stale.length > 0) {
+    console.error(
+      `command:derive: rename or delete the section of each span naming no command:
+${stale.join("\n")}`
+    );
+    return 1;
+  }
+  const lint_prose_pages = filled_lint_prose_pages();
+  write_usage_pages(pages);
+  writeFileSync(CATALOG_FILE, generate_catalog());
+  write_pages(lint_prose_pages);
+  return report_bytes();
+}
+if (process.argv[1] === fileURLToPath3(__josh_source_url3)) process.exitCode = main();
+var command_derive = { main };
+export {
+  command_derive
+};