akari-video 1.5.2-beta.1 → 1.5.2-beta.2

package/README.md

@@ -58,7 +58,12 @@ zip を使う。`src/store-command.mjs`）/
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・
 sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-command.mjs`）/
 `akari clean [project-dir] [--dry-run] [--yes] [--json]`（使い捨ての中間ファイル、保持する
-正本、判断が必要なものを容量付きで一覧する。既定は一覧のみで、削除可能なものだけを承認後に削除）。
+正本、判断が必要なものを容量付きで一覧する。既定は一覧のみで、削除可能なものだけを承認後に削除）/
+`akari geo terrain --bbox <西,南,東,北> --out <dir> [--zoom 1-14] [--max-tiles 64]`（国土地理院の
+標高・写真タイルから 3D 地形の `heightmap.png`・`texture.png`・`terrain.json` を作る）/
+`akari geo point --terrain <terrain.json> --lonlat <経度,緯度>[,高さm]`（terrain.json の
+declaration と同じ縮尺で経緯度を 3D 座標 `[x, y, z]` に直す。出典「国土地理院（地理院タイル）」の
+表示が利用条件）。
 
 ## 拡張キット
 

package/bin/akari.mjs

@@ -17,6 +17,7 @@ import { runDoctorCommand } from '../src/doctor-command.mjs';
 import { runGenerateCommand } from '../src/generate-command.mjs';
 import { runStoryboardCommand } from '../src/storyboard-command.mjs';
 import { runWorldCommand } from '../src/world-command.mjs';
+import { runGeoCommand } from '../src/geo-command.mjs';
 import { runLintCommand } from '../src/lint-command.mjs';
 import { runPreviewCommand } from '../src/preview-command.mjs';
 import { runSkillsCommand, refreshEntrySkillOnLaunch } from '../src/skills-command.mjs';
@@ -79,6 +80,7 @@ const commands = {
   generate: runGenerateCommand,
   storyboard: runStoryboardCommand,
   world: runWorldCommand,
+  geo: runGeoCommand,
   lint: runLintCommand,
   preview: runPreviewCommand,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.5.2-beta.1",
+  "version": "1.5.2-beta.2",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

package/src/geo-command.mjs

@@ -0,0 +1,18 @@
+import { existsSync } from 'node:fs';
+import { cliText } from './i18n.mjs';
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+
+import { GEO_CLI_RELATIVE, resolveLauncherAssets } from './repo-assets.mjs';
+
+export async function runGeoCommand(args, options = {}) {
+  const logError = options.logError ?? ((line) => console.error(line));
+  const assets = options.assets ?? resolveLauncherAssets();
+  const script = assets.repoRoot ? path.join(assets.repoRoot, GEO_CLI_RELATIVE) : null;
+  if (!script || !existsSync(script)) {
+    logError(cliText('cli.internal.error.scriptMissing', { command: 'geo' }));
+    return { exitCode: 1 };
+  }
+  const result = (options.spawn ?? spawnSync)(process.execPath, [script, ...args], { stdio: 'inherit' });
+  return { exitCode: typeof result?.status === 'number' ? result.status : 1 };
+}

package/src/messages.mjs

@@ -335,7 +335,7 @@ export function describeCliHelp() {
     cliText('cli.help.header.usage'),
     '',
     cliText('cli.help.commands.heading'),
-    ...['launch', 'preview', 'store', 'sounds', 'doctor', 'speakers', 'toolsVoice', 'update', 'status', 'migrate', 'migrateLook', 'generate', 'storyboard', 'project', 'playbook', 'recipe', 'lint', 'clean'].map((name) => cliText(`cli.help.commands.${name}`)),
+    ...['launch', 'preview', 'store', 'sounds', 'doctor', 'speakers', 'toolsVoice', 'update', 'status', 'migrate', 'migrateLook', 'generate', 'storyboard', 'project', 'playbook', 'recipe', 'geo', 'lint', 'clean'].map((name) => cliText(`cli.help.commands.${name}`)),
     '',
     cliText('cli.help.developer.heading'),
     ...['opencode', 'claude', 'yes', 'version', 'new', 'init', 'other', 'help'].map((name) => cliText(`cli.help.developer.${name}`)),

package/src/project-state.mjs

@@ -4,7 +4,7 @@ import path from 'node:path';
 /**
  * カレントプロジェクトが AKARI Video プロジェクトとしてセットアップ済みかを判定する。
  * `.akari/connections.json` の有無を「セットアップ済み」の判定基準にする
- * （`create-project` / `project-scaffold` が必ずこのファイルを雛形から生成するため）。
+ * （`setup-project` / `project-scaffold` が必ずこのファイルを雛形から生成するため）。
  *
  * 例外: `.akari/root.json`（作業場マニフェスト）を持つディレクトリは作業場ルートであって
  * プロジェクトではない。作業場層 `.akari/connections.json`（`packages/creator-root` の

package/src/repo-assets.mjs

@@ -47,6 +47,7 @@ export const WORD_BOOK_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'b
 export const GENERATE_CLI_RELATIVE = path.join('packages', 'generate', 'src', 'cli', 'index.mjs');
 export const STORYBOARD_CLI_RELATIVE = path.join('packages', 'decision-cards', 'render-storyboard-print.mjs');
 export const WORLD_CLI_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'world.mjs');
+export const GEO_CLI_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'geo.mjs');
 export const WORLD_VALIDATOR_RELATIVE = path.join('packages', 'schemas', 'bin', 'validate-world-map.mjs');
 // ブラウザプレビューの実体。`akari preview` はこれを子プロセスで起動するだけで、
 // サーバーを再実装しない（アプリでは extraResources、モノレポでは checkout から解決）。
@@ -77,6 +78,7 @@ export const LAUNCHER_SUBCOMMAND_EXECUTABLES = [
   { command: 'akari generate', relative: GENERATE_CLI_RELATIVE, resolution: 'launcher-assets' },
   { command: 'akari storyboard', relative: STORYBOARD_CLI_RELATIVE, resolution: 'launcher-assets' },
   { command: 'akari world', relative: WORLD_CLI_RELATIVE, resolution: 'resources' },
+  { command: 'akari geo', relative: GEO_CLI_RELATIVE, resolution: 'launcher-assets' },
   { command: 'akari world check', relative: WORLD_VALIDATOR_RELATIVE, resolution: 'resources' },
   { command: 'akari preview', relative: PREVIEW_SERVER_SCRIPT_RELATIVE, resolution: 'resources' }
 ];

package/src/status-core/status.mjs

@@ -418,12 +418,12 @@ function sha256Text(value) {
 function routeForStage(stage, review, materials) {
   const routes = {
     state_inconclusive: [null, null],
-    not_scaffolded: [{ kind: "human", action: "create-project", reason: "project is not scaffolded" }, "create-project"],
+    not_scaffolded: [{ kind: "human", action: "setup-project", reason: "project is not scaffolded" }, "setup-project"],
     intake_pending: [{ kind: "human", action: "complete-intake", reason: "project intake is not submitted" }, null],
     analysis_pending: [{ kind: "agent", action: "analyze-footage", reason: `analysis coverage ${materials.covered.size}/${materials.sources.length}` }, "analyze-footage"],
     interpretation_pending: [{ kind: "agent", action: "analyze-project", reason: "multiple materials require project interpretation" }, "analyze-project"],
-    planning_pending: [{ kind: "agent", action: "edit-plan", reason: materials.sources.length === 0 ? "zero-material planning has not started" : "plan.json is absent" }, "edit-plan"],
-    edit_pending: [{ kind: "agent", action: "edit-plan", reason: "edit.json is absent" }, "edit-plan"],
+    planning_pending: [{ kind: "agent", action: "plan-edit", reason: materials.sources.length === 0 ? "zero-material planning has not started" : "plan.json is absent" }, "plan-edit"],
+    edit_pending: [{ kind: "agent", action: "plan-edit", reason: "edit.json is absent" }, "plan-edit"],
     review_pending: [{ kind: "agent", action: "edit-from-review", reason: `open review tickets: ${review.open}` }, "edit-from-review"],
     human_review_pending: [{ kind: "human", action: "resolve-review", reason: `addressed review tickets: ${review.addressed}` }, null],
     lint_pending: [{ kind: "agent", action: "verify-edit", reason: "current edit/review has no fresh PASS lint" }, "verify-edit"],

package/src/status-core/workspace.mjs

@@ -113,7 +113,7 @@ function resolveNextAction(projects, inboxNewCount) {
     };
   }
   if (projects.length === 0) {
-    return { kind: "human", action: "create-project", reason: "workspace has no projects yet" };
+    return { kind: "human", action: "setup-project", reason: "workspace has no projects yet" };
   }
   return null;
 }

package/src/vendor-sources.mjs

@@ -84,6 +84,10 @@ export const VENDOR_SOURCES = [
   'packages/akari-tools/src/media/whisper-model-candidates.mjs',
   'packages/akari-tools/src/i18n.mjs',
   'packages/akari-tools/package.json',
+  // `akari geo terrain` は launcher-assets（npm 配布の vendor）から解決する。
+  // 実行に必要な CLI と src/geo だけを追加し、test/ は配布しない。
+  'packages/akari-tools/bin/geo.mjs',
+  'packages/akari-tools/src/geo',
   'packages/akari-voice/src',
   'packages/akari-voice/package.json',
   // テストは実行時に不要で、分析レポートのテスト専用モジュールを参照するため除外する。

package/vendor/.akari-capability-sources.json

@@ -169,6 +169,10 @@
     "skills/analyze-footage/SKILL.md",
     "skills/analyze-footage/vision-tracks.md",
     "skills/analyze-footage/workflow.md",
+    "skills/analyze-music/after-save.md",
+    "skills/analyze-music/launch.md",
+    "skills/analyze-music/SKILL.md",
+    "skills/analyze-music/what-to-declare.md",
     "skills/analyze-project/collect.md",
     "skills/analyze-project/decision-record.md",
     "skills/analyze-project/interpretation.md",
@@ -177,34 +181,25 @@
     "skills/analyze-project/references/open-questions-examples.md",
     "skills/analyze-project/SKILL.md",
     "skills/analyze-project/validate-and-render.md",
+    "skills/author-overlay/3d.md",
+    "skills/author-overlay/glass.md",
+    "skills/author-overlay/lang/en.md",
+    "skills/author-overlay/lang/ja.md",
+    "skills/author-overlay/motion.md",
+    "skills/author-overlay/SKILL.md",
+    "skills/author-overlay/table.md",
+    "skills/author-overlay/telop.md",
+    "skills/author-overlay/text-behind-person.md",
+    "skills/author-overlay/thumbnail.md",
+    "skills/author-overlay/world.md",
     "skills/author-scene3d/bake.md",
     "skills/author-scene3d/device-materials.md",
     "skills/author-scene3d/live.md",
     "skills/author-scene3d/SKILL.md",
-    "skills/create-project/SKILL.md",
-    "skills/declare-audio/after-save.md",
-    "skills/declare-audio/launch.md",
-    "skills/declare-audio/SKILL.md",
-    "skills/declare-audio/what-to-declare.md",
-    "skills/design-world/guide.md",
-    "skills/design-world/SKILL.md",
-    "skills/design-world/world.md",
+    "skills/author-world/guide.md",
+    "skills/author-world/SKILL.md",
+    "skills/author-world/world.md",
     "skills/edit-from-review/SKILL.md",
-    "skills/edit-plan/approvals-and-generation.md",
-    "skills/edit-plan/autonomy.md",
-    "skills/edit-plan/avatar-resolution.md",
-    "skills/edit-plan/beat-sync.md",
-    "skills/edit-plan/beats.md",
-    "skills/edit-plan/emphasis-detection.md",
-    "skills/edit-plan/execution.md",
-    "skills/edit-plan/expression-selection.md",
-    "skills/edit-plan/lang/en.md",
-    "skills/edit-plan/lang/ja.md",
-    "skills/edit-plan/plan-json.md",
-    "skills/edit-plan/recipe.md",
-    "skills/edit-plan/report-guide.md",
-    "skills/edit-plan/SKILL.md",
-    "skills/edit-plan/workflow.md",
     "skills/edit-to-beat/generator.md",
     "skills/edit-to-beat/pitfalls.md",
     "skills/edit-to-beat/SKILL.md",
@@ -226,27 +221,31 @@
     "skills/generate-video/still.md",
     "skills/generate-video/video.md",
     "skills/harvest-asset/SKILL.md",
-    "skills/overlay-authoring/3d.md",
-    "skills/overlay-authoring/glass.md",
-    "skills/overlay-authoring/lang/en.md",
-    "skills/overlay-authoring/lang/ja.md",
-    "skills/overlay-authoring/motion.md",
-    "skills/overlay-authoring/SKILL.md",
-    "skills/overlay-authoring/table.md",
-    "skills/overlay-authoring/telop.md",
-    "skills/overlay-authoring/text-behind-person.md",
-    "skills/overlay-authoring/thumbnail.md",
-    "skills/overlay-authoring/world.md",
-    "skills/record-playbook/SKILL.md",
+    "skills/harvest-playbook/SKILL.md",
+    "skills/plan-edit/approvals-and-generation.md",
+    "skills/plan-edit/autonomy.md",
+    "skills/plan-edit/avatar-resolution.md",
+    "skills/plan-edit/beat-sync.md",
+    "skills/plan-edit/beats.md",
+    "skills/plan-edit/emphasis-detection.md",
+    "skills/plan-edit/execution.md",
+    "skills/plan-edit/expression-selection.md",
+    "skills/plan-edit/lang/en.md",
+    "skills/plan-edit/lang/ja.md",
+    "skills/plan-edit/plan-json.md",
+    "skills/plan-edit/recipe.md",
+    "skills/plan-edit/report-guide.md",
+    "skills/plan-edit/SKILL.md",
+    "skills/plan-edit/workflow.md",
+    "skills/plan-video/competitor.md",
+    "skills/plan-video/ideate.md",
+    "skills/plan-video/lang/en.md",
+    "skills/plan-video/lang/ja.md",
+    "skills/plan-video/shotlist.md",
+    "skills/plan-video/SKILL.md",
+    "skills/plan-video/storyboard.md",
+    "skills/plan-video/trends.md",
     "skills/render-cut/SKILL.md",
-    "skills/research-plan/competitor.md",
-    "skills/research-plan/ideate.md",
-    "skills/research-plan/lang/en.md",
-    "skills/research-plan/lang/ja.md",
-    "skills/research-plan/shotlist.md",
-    "skills/research-plan/SKILL.md",
-    "skills/research-plan/storyboard.md",
-    "skills/research-plan/trends.md",
     "skills/review-cut/SKILL.md",
     "skills/review-cut/workflow.md",
     "skills/review-from-recording/compilation-rules.md",
@@ -269,6 +268,7 @@
     "skills/setup-library/SKILL.md",
     "skills/setup-library/starter-pack.md",
     "skills/setup-library/tools-check.md",
+    "skills/setup-project/SKILL.md",
     "skills/setup-remote/doctor-and-install.md",
     "skills/setup-remote/serve-preview.md",
     "skills/setup-remote/SKILL.md",

package/vendor/packages/akari-launcher/README.md

@@ -58,7 +58,12 @@ zip を使う。`src/store-command.mjs`）/
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・
 sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-command.mjs`）/
 `akari clean [project-dir] [--dry-run] [--yes] [--json]`（使い捨ての中間ファイル、保持する
-正本、判断が必要なものを容量付きで一覧する。既定は一覧のみで、削除可能なものだけを承認後に削除）。
+正本、判断が必要なものを容量付きで一覧する。既定は一覧のみで、削除可能なものだけを承認後に削除）/
+`akari geo terrain --bbox <西,南,東,北> --out <dir> [--zoom 1-14] [--max-tiles 64]`（国土地理院の
+標高・写真タイルから 3D 地形の `heightmap.png`・`texture.png`・`terrain.json` を作る）/
+`akari geo point --terrain <terrain.json> --lonlat <経度,緯度>[,高さm]`（terrain.json の
+declaration と同じ縮尺で経緯度を 3D 座標 `[x, y, z]` に直す。出典「国土地理院（地理院タイル）」の
+表示が利用条件）。
 
 ## 拡張キット
 

package/vendor/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.5.2-beta.1",
+  "version": "1.5.2-beta.2",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。 [akari-video npm vendor: bin/akari.mjs is reference-only. These CLI entrypoints are not included in the akari-video npm package. Use `akari doctor --json` and run the path reported in `render_cut.path`. Full installations provide it in a monorepo checkout, ~/.akari/app, /Applications/AKARI Video.app/Contents/Resources/packages, or %LOCALAPPDATA%\\Programs\\@akari-videoshell\\resources\\packages.]",
   "type": "module",
   "files": [

package/vendor/packages/akari-tools/README.md

@@ -10,6 +10,7 @@
 - `akari media transcribe-diff <target> [--engines a,b,c]` — 最新のエンジン別文字起こしを文字単位で比較し、`diff.json` と JSON 要約を返す。句読点だけの差は除外し、1 エンジンなら比較を省略する。
 - `akari media transcribe-cuts <target> [--basis b] [--silence-min 0.45] [--silence-break 3.0] [--silence-keep 0.15]` — フィラー・言い直し・無音・未認識を `cuts.json` に候補として保存し、JSON 要約を返す。既存の採否を引き継ぎ、手直しした字幕に重なる候補は既定 OFF にする。
 - `akari media audio-level <projectDir>` — `gain_db` 未指定の音声素材を測り、役割別の提案値を表にする。`--write` で `edit.json` へ数値を保存し、`--json` で JSON 配列を返す。
+- `akari geo terrain --bbox <西,南,東,北> --out <dir>` — 国土地理院の標高・写真タイルを結合し、`heightmap.png`・`texture.png`・`terrain.json` を作る。出典表示は [`docs/guides/geo-terrain.ja.md`](../../docs/guides/geo-terrain.ja.md) を参照。
 
 ## 音声素材の挿入レベル
 

package/vendor/packages/akari-tools/bin/geo.mjs

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+// `akari geo` — 国土地理院の公開タイルから 3D 地形の素材を作り、地点を 3D 座標へ直す。
+import path from "node:path";
+
+import { isMainModule } from "../src/common/main-module.mjs";
+
+const terrainUsage = [
+  "使い方: akari geo terrain --bbox <西,南,東,北> --out <dir> [--zoom 1-14] [--max-tiles 64] [--cache-dir <dir>] [--json]",
+  "",
+  "国土地理院の標高タイル（dem_png）と写真タイル（seamlessphoto）を結合し、",
+  "heightmap.png・texture.png・terrain.json を出力します。",
+  "",
+  "  --bbox        西,南,東,北（世界測地系の度）",
+  "  --out         出力先ディレクトリ（必須）",
+  "  --zoom        タイルのズーム（既定 14）",
+  "  --max-tiles   取得するタイル数の上限（既定 64）",
+  "  --cache-dir   タイルのキャッシュ先（既定 ~/.akari/cache/geo）",
+  "  --json        結果を JSON で出力",
+  "",
+  "terrain.json の declaration を 3D の terrain 宣言にそのまま貼れます。",
+].join("\n");
+
+const pointUsage = [
+  "使い方: akari geo point --terrain <terrain.json> --lonlat <経度,緯度>[,高さm] [--exaggeration <n>] [--json]",
+  "",
+  "地形の declaration（size・meters・baseline・exaggeration）に合わせて、",
+  "経緯度から 3D 座標 [x, y, z] を出力します。高さを省略すると高さマップから引きます。",
+  "",
+  "  --terrain       akari geo terrain が出力した terrain.json",
+  "  --lonlat        経度,緯度（,高さm は任意）",
+  "  --exaggeration  シーンの terrain.exaggeration を上書き（シーンで変えたら同じ値を渡す）",
+  "  --json          結果を JSON で出力（既定も JSON 配列）",
+  "",
+  "出力は lines[].points と data-akari-3d-anchor にそのまま使えます。",
+  "線は lines[].drape: true にすると y を気にせず地表に沿わせられます。",
+].join("\n");
+
+const usage = [terrainUsage, "", pointUsage, "",
+  "生成物を使うときは「出典: 国土地理院（地理院タイル）」を必ず表示してください。"].join("\n");
+
+function parseTerrainArgs(args) {
+  const parsed = { json: false };
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--json") parsed.json = true;
+    else if (arg === "--help" || arg === "-h") parsed.help = true;
+    else if (["--bbox", "--out", "--zoom", "--max-tiles", "--cache-dir"].includes(arg)) {
+      const value = args[index + 1];
+      if (value === undefined || value.startsWith("--")) return { ok: false, reason: `${arg} の値がありません` };
+      parsed[arg.slice(2)] = value;
+      index += 1;
+    } else if (arg.startsWith("--bbox=")) parsed.bbox = arg.slice(7);
+    else if (arg.startsWith("--out=")) parsed.out = arg.slice(6);
+    else if (arg.startsWith("--zoom=")) parsed.zoom = arg.slice(7);
+    else if (arg.startsWith("--max-tiles=")) parsed["max-tiles"] = arg.slice(12);
+    else if (arg.startsWith("--cache-dir=")) parsed["cache-dir"] = arg.slice(12);
+    else return { ok: false, reason: `不明な引数です: ${arg}` };
+  }
+  if (parsed.help) return { ok: true, parsed };
+  if (!parsed.bbox) return { ok: false, reason: "--bbox を指定してください" };
+  if (!parsed.out) return { ok: false, reason: "--out を指定してください" };
+  return { ok: true, parsed };
+}
+
+function parsePointArgs(args) {
+  const parsed = { json: false };
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--json") parsed.json = true;
+    else if (arg === "--help" || arg === "-h") parsed.help = true;
+    else if (["--terrain", "--lonlat", "--exaggeration"].includes(arg)) {
+      const value = args[index + 1];
+      if (value === undefined || value.startsWith("--")) return { ok: false, reason: `${arg} の値がありません` };
+      parsed[arg.slice(2)] = value;
+      index += 1;
+    } else if (arg.startsWith("--terrain=")) parsed.terrain = arg.slice(10);
+    else if (arg.startsWith("--lonlat=")) parsed.lonlat = arg.slice(9);
+    else return { ok: false, reason: `不明な引数です: ${arg}` };
+  }
+  if (parsed.help) return { ok: true, parsed };
+  if (!parsed.terrain) return { ok: false, reason: "--terrain を指定してください" };
+  if (!parsed.lonlat) return { ok: false, reason: "--lonlat を指定してください" };
+  return { ok: true, parsed };
+}
+
+async function runTerrain(args, options, log, logError) {
+  const parsed = parseTerrainArgs(args);
+  if (!parsed.ok) {
+    logError(parsed.reason);
+    logError(terrainUsage);
+    return { exitCode: 2 };
+  }
+  if (parsed.parsed.help) {
+    log(terrainUsage);
+    return { exitCode: 0 };
+  }
+  const build = options.buildTerrain ?? (await import("../src/geo/terrain.mjs")).buildTerrain;
+  try {
+    const result = await build({
+      bbox: parsed.parsed.bbox,
+      outDir: path.resolve(parsed.parsed.out),
+      zoom: parsed.parsed.zoom,
+      maxTiles: parsed.parsed["max-tiles"],
+      cacheDir: parsed.parsed["cache-dir"],
+      env: options.env,
+      log: parsed.parsed.json ? () => {} : log,
+    });
+    if (parsed.parsed.json) {
+      log(JSON.stringify({
+        out: result.outDir,
+        files: result.files,
+        terrain: result.terrain,
+        size: result.size,
+        tiles: result.tiles,
+        missing: result.missing,
+        filled: result.filled,
+      }));
+    } else {
+      log(`出力先: ${result.outDir}`);
+    }
+    return { exitCode: 0 };
+  } catch (error) {
+    logError(error instanceof Error ? error.message : String(error));
+    return { exitCode: 1 };
+  }
+}
+
+async function runPoint(args, options, log, logError) {
+  const parsed = parsePointArgs(args);
+  if (!parsed.ok) {
+    logError(parsed.reason);
+    logError(pointUsage);
+    return { exitCode: 2 };
+  }
+  if (parsed.parsed.help) {
+    log(pointUsage);
+    return { exitCode: 0 };
+  }
+  const module = await import("../src/geo/point.mjs");
+  const loadTerrainFiles = options.loadTerrainFiles ?? module.loadTerrainFiles;
+  const terrainPoint = options.terrainPoint ?? module.terrainPoint;
+  const roundPoint = options.roundPoint ?? module.roundPoint;
+  const parseLonLat = options.parseLonLat ?? module.parseLonLat;
+  try {
+    const { lon, lat, height } = parseLonLat(parsed.parsed.lonlat);
+    const { terrain, image } = await loadTerrainFiles(parsed.parsed.terrain);
+    const point = terrainPoint({
+      terrain, image, lon, lat, height, exaggeration: parsed.parsed.exaggeration,
+    });
+    log(JSON.stringify(roundPoint(point)));
+    return { exitCode: 0 };
+  } catch (error) {
+    logError(error instanceof Error ? error.message : String(error));
+    return { exitCode: 1 };
+  }
+}
+
+export async function runGeoCommand(args, options = {}) {
+  const log = options.log ?? console.log;
+  const logError = options.logError ?? console.error;
+  const subcommand = args[0];
+  if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+    log(usage);
+    return { exitCode: 0 };
+  }
+  if (subcommand === "terrain") return runTerrain(args.slice(1), options, log, logError);
+  if (subcommand === "point") return runPoint(args.slice(1), options, log, logError);
+  logError(`不明な geo サブコマンドです: ${subcommand}`);
+  logError(usage);
+  return { exitCode: 2 };
+}
+
+if (isMainModule(import.meta.url)) {
+  const result = await runGeoCommand(process.argv.slice(2));
+  process.exitCode = result.exitCode;
+}

package/vendor/packages/akari-tools/package.json

@@ -4,6 +4,7 @@
   "private": true,
   "type": "module",
   "bin": {
+    "akari-geo": "bin/geo.mjs",
     "akari-speakers": "bin/speakers.mjs"
   },
   "engines": {

package/vendor/packages/akari-tools/src/geo/png.mjs

@@ -0,0 +1,164 @@
+// 地理院タイルの PNG 読み書き。外部パッケージは使わず Node 標準の zlib だけで扱う。
+// 標高タイル（dem_png）は 8bit RGB、写真タイルは JPEG なので、ここでは PNG だけを担う。
+import { deflateSync, inflateSync } from "node:zlib";
+
+const SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
+const CHANNELS = new Map([
+  [0, 1], // grayscale
+  [2, 3], // RGB
+  [3, 1], // palette
+  [4, 2], // grayscale + alpha
+  [6, 4], // RGBA
+]);
+
+function crc32(buffer) {
+  let crc = 0xffffffff;
+  for (const byte of buffer) {
+    crc ^= byte;
+    for (let bit = 0; bit < 8; bit += 1) {
+      crc = (crc >>> 1) ^ ((crc & 1) ? 0xedb88320 : 0);
+    }
+  }
+  return (crc ^ 0xffffffff) >>> 0;
+}
+
+function chunk(type, data) {
+  const typeBuffer = Buffer.from(type, "ascii");
+  const out = Buffer.alloc(12 + data.length);
+  out.writeUInt32BE(data.length, 0);
+  typeBuffer.copy(out, 4);
+  data.copy(out, 8);
+  out.writeUInt32BE(crc32(Buffer.concat([typeBuffer, data])), 8 + data.length);
+  return out;
+}
+
+/** RGB のバイト列（幅 * 高さ * 3）を PNG にする。 */
+export function encodeRgbPng(rgb, width, height) {
+  if (!Buffer.isBuffer(rgb)) throw new TypeError("PNG の画素は Buffer で渡してください");
+  if (!Number.isInteger(width) || width <= 0 || !Number.isInteger(height) || height <= 0) {
+    throw new TypeError("PNG の幅・高さは正の整数で指定してください");
+  }
+  if (rgb.length !== width * height * 3) {
+    throw new RangeError(`PNG の画素数が足りません: ${rgb.length} バイト（期待 ${width * height * 3}）`);
+  }
+  const stride = width * 3;
+  const scanlines = Buffer.alloc((stride + 1) * height);
+  for (let row = 0; row < height; row += 1) {
+    rgb.copy(scanlines, row * (stride + 1) + 1, row * stride, (row + 1) * stride);
+  }
+  const header = Buffer.alloc(13);
+  header.writeUInt32BE(width, 0);
+  header.writeUInt32BE(height, 4);
+  header[8] = 8; // bit depth
+  header[9] = 2; // color type: RGB
+  header[10] = 0; // compression
+  header[11] = 0; // filter
+  header[12] = 0; // interlace
+  return Buffer.concat([
+    SIGNATURE,
+    chunk("IHDR", header),
+    chunk("IDAT", deflateSync(scanlines)),
+    chunk("IEND", Buffer.alloc(0)),
+  ]);
+}
+
+function readChunks(bytes) {
+  if (!bytes.subarray(0, 8).equals(SIGNATURE)) throw new Error("PNG の署名がありません");
+  const chunks = [];
+  let offset = 8;
+  while (offset + 12 <= bytes.length) {
+    const length = bytes.readUInt32BE(offset);
+    const type = bytes.toString("ascii", offset + 4, offset + 8);
+    const data = bytes.subarray(offset + 8, offset + 8 + length);
+    if (data.length !== length) throw new Error(`PNG の ${type} チャンクが途中で切れています`);
+    chunks.push({ type, data });
+    offset += 12 + length;
+    if (type === "IEND") break;
+  }
+  return chunks;
+}
+
+function paeth(left, up, upperLeft) {
+  const p = left + up - upperLeft;
+  const pa = Math.abs(p - left);
+  const pb = Math.abs(p - up);
+  const pc = Math.abs(p - upperLeft);
+  if (pa <= pb && pa <= pc) return left;
+  return pb <= pc ? up : upperLeft;
+}
+
+/** 8bit PNG を読み、RGB のバイト列（幅 * 高さ * 3）にする。 */
+export function decodeRgbPng(bytes) {
+  if (!Buffer.isBuffer(bytes)) bytes = Buffer.from(bytes);
+  const chunks = readChunks(bytes);
+  const ihdr = chunks.find((entry) => entry.type === "IHDR")?.data;
+  if (!ihdr || ihdr.length < 13) throw new Error("PNG の IHDR がありません");
+  const width = ihdr.readUInt32BE(0);
+  const height = ihdr.readUInt32BE(4);
+  const bitDepth = ihdr[8];
+  const colorType = ihdr[9];
+  const compression = ihdr[10];
+  const filter = ihdr[11];
+  const interlace = ihdr[12];
+  if (compression !== 0 || filter !== 0) throw new Error("PNG の圧縮・フィルタ方式が未対応です");
+  if (interlace !== 0) throw new Error("インターレース PNG は未対応です");
+  if (bitDepth !== 8) throw new Error(`PNG のビット深度 ${bitDepth} は未対応です（8bit のみ）`);
+  const channels = CHANNELS.get(colorType);
+  if (!channels) throw new Error(`PNG の色種別 ${colorType} は未対応です`);
+  const palette = chunks.find((entry) => entry.type === "PLTE")?.data;
+  if (colorType === 3 && !palette) throw new Error("パレット PNG に PLTE がありません");
+
+  const idat = Buffer.concat(chunks.filter((entry) => entry.type === "IDAT").map((entry) => entry.data));
+  if (!idat.length) throw new Error("PNG の IDAT がありません");
+  const raw = inflateSync(idat);
+  const stride = width * channels;
+  if (raw.length < (stride + 1) * height) throw new Error("PNG の画素データが足りません");
+
+  const scanlines = Buffer.alloc(stride * height);
+  let source = 0;
+  for (let row = 0; row < height; row += 1) {
+    const filterType = raw[source];
+    source += 1;
+    const target = row * stride;
+    const previous = target - stride;
+    for (let column = 0; column < stride; column += 1) {
+      const value = raw[source + column];
+      const left = column >= channels ? scanlines[target + column - channels] : 0;
+      const up = row > 0 ? scanlines[previous + column] : 0;
+      const upperLeft = row > 0 && column >= channels ? scanlines[previous + column - channels] : 0;
+      let restored;
+      if (filterType === 0) restored = value;
+      else if (filterType === 1) restored = value + left;
+      else if (filterType === 2) restored = value + up;
+      else if (filterType === 3) restored = value + Math.floor((left + up) / 2);
+      else if (filterType === 4) restored = value + paeth(left, up, upperLeft);
+      else throw new Error(`PNG のフィルタ種別 ${filterType} は未対応です`);
+      scanlines[target + column] = restored & 0xff;
+    }
+    source += stride;
+  }
+
+  const rgb = Buffer.alloc(width * height * 3);
+  for (let index = 0, target = 0; index < width * height; index += 1, target += 3) {
+    const base = index * channels;
+    if (colorType === 2) {
+      rgb[target] = scanlines[base];
+      rgb[target + 1] = scanlines[base + 1];
+      rgb[target + 2] = scanlines[base + 2];
+    } else if (colorType === 6) {
+      rgb[target] = scanlines[base];
+      rgb[target + 1] = scanlines[base + 1];
+      rgb[target + 2] = scanlines[base + 2];
+    } else if (colorType === 0 || colorType === 4) {
+      rgb[target] = scanlines[base];
+      rgb[target + 1] = scanlines[base];
+      rgb[target + 2] = scanlines[base];
+    } else {
+      const paletteIndex = scanlines[base] * 3;
+      rgb[target] = palette[paletteIndex];
+      rgb[target + 1] = palette[paletteIndex + 1];
+      rgb[target + 2] = palette[paletteIndex + 2];
+    }
+  }
+  return { width, height, rgb };
+}