calendit 1.0.2 → 2026.4.26

package/dist/core/logger.js

@@ -25,6 +25,11 @@ function writeToDebugDump(line) {
         return;
     debugStream.write(`${line}\n`);
 }
+/** ログプレフィックスなしの標準出力（表形式のユーザー向け表示用） */
+export function writeStdoutLine(line) {
+    writeToDebugDump(line);
+    process.stdout.write(`${line}\n`);
+}
 function stringifyArgs(args) {
     return args
         .map((arg) => {

package/dist/core/macosBridgeApp.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Directory of the installed `calendit` npm package (where package.json with name "calendit" lives), or null.
+ * Used to locate `native/eventkit-bridge` in a full clone; absent from the published npm tarball.
+ */
+export declare function resolveCalenditPackageRootFromModule(): string | null;
+/** `native/eventkit-bridge` with `Package.swift` (source tree), or null. */
+export declare function resolveEventkitBridgeRepoPath(): string | null;
+/**
+ * Resolve the CalenditEventKitBridge .app path for `calendit macos bridge start`.
+ * Order: CALENDIT_EVENTKIT_BRIDGE_APP, ~/Applications, /Applications, repo .build (dev).
+ */
+export declare function resolveEventkitBridgeAppBundlePath(): string | null;

package/dist/core/macosBridgeApp.js

@@ -0,0 +1,83 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { fileURLToPath } from "url";
+import { defaultCalenditDataDir } from "./eventkitHelper.js";
+function isAppBundle(p) {
+    return p.endsWith(".app") && fs.existsSync(path.join(p, "Contents/Info.plist"));
+}
+/**
+ * Directory of the installed `calendit` npm package (where package.json with name "calendit" lives), or null.
+ * Used to locate `native/eventkit-bridge` in a full clone; absent from the published npm tarball.
+ */
+export function resolveCalenditPackageRootFromModule() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 20; i++) {
+        const pkg = path.join(dir, "package.json");
+        if (fs.existsSync(pkg)) {
+            try {
+                const raw = fs.readFileSync(pkg, "utf8");
+                const j = JSON.parse(raw);
+                if (j.name === "calendit") {
+                    return dir;
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
+    return null;
+}
+/** `native/eventkit-bridge` with `Package.swift` (source tree), or null. */
+export function resolveEventkitBridgeRepoPath() {
+    const override = process.env.CALENDIT_EVENTKIT_BRIDGE_ROOT?.trim();
+    if (override) {
+        const p = path.resolve(override);
+        if (fs.existsSync(path.join(p, "Package.swift"))) {
+            return p;
+        }
+        return null;
+    }
+    const root = resolveCalenditPackageRootFromModule();
+    if (!root) {
+        return null;
+    }
+    const br = path.join(root, "native/eventkit-bridge");
+    if (fs.existsSync(path.join(br, "Package.swift"))) {
+        return br;
+    }
+    const fetched = path.join(defaultCalenditDataDir(), "fetched-eventkit-bridge");
+    if (fs.existsSync(path.join(fetched, "Package.swift"))) {
+        return fetched;
+    }
+    return null;
+}
+/**
+ * Resolve the CalenditEventKitBridge .app path for `calendit macos bridge start`.
+ * Order: CALENDIT_EVENTKIT_BRIDGE_APP, ~/Applications, /Applications, repo .build (dev).
+ */
+export function resolveEventkitBridgeAppBundlePath() {
+    const fromEnv = process.env.CALENDIT_EVENTKIT_BRIDGE_APP?.trim();
+    if (fromEnv && isAppBundle(fromEnv)) {
+        return fromEnv;
+    }
+    const homeApps = path.join(os.homedir(), "Applications/CalenditEventKitBridge.app");
+    if (isAppBundle(homeApps)) {
+        return homeApps;
+    }
+    const global = "/Applications/CalenditEventKitBridge.app";
+    if (isAppBundle(global)) {
+        return global;
+    }
+    const dev = path.join(process.cwd(), "native/eventkit-bridge/.build/CalenditEventKitBridge.app");
+    if (isAppBundle(dev)) {
+        return dev;
+    }
+    return null;
+}

package/dist/core/macosTerminalRelay.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build a shell one-liner: optional exports, cd cwd, then `calendit macos …` or `node …/index.js macos …`.
+ */
+export declare function buildMacosExternalShellLine(cwd: string, macosArgv: string[]): string;
+/** Tell Terminal.app to run `shellLine` (Calendar TCC applies to Terminal, not IDE host). */
+export declare function buildMacosTerminalSessionLine(cwd: string): string;
+/**
+ * Run `shellLine` in Terminal.app. If a window already exists, reuse **window 1**
+ * (`do script … in window 1`) so each `external` call does not spawn a separate window.
+ * (Terminal may still open a **new tab** per call, depending on user preferences.)
+ */
+export declare function openTerminalAndRunShellLine(shellLine: string): void;

package/dist/core/macosTerminalRelay.js

@@ -0,0 +1,62 @@
+import { execFileSync } from "child_process";
+import * as path from "path";
+import * as process from "process";
+/** POSIX single-quoted string for sh -c / do script. */
+function shSingleQuote(s) {
+    return `'${String(s).replace(/'/g, `'"'"'`)}'`;
+}
+/**
+ * Build a shell one-liner: optional exports, cd cwd, then `calendit macos …` or `node …/index.js macos …`.
+ */
+export function buildMacosExternalShellLine(cwd, macosArgv) {
+    const argv1 = process.argv[1];
+    let inv;
+    if (argv1?.endsWith(".js")) {
+        inv = `node ${shSingleQuote(path.resolve(argv1))}`;
+    }
+    else {
+        inv = "calendit";
+    }
+    const exports = [];
+    if (process.env.CALENDIT_CONFIG_DIR) {
+        exports.push(`export CALENDIT_CONFIG_DIR=${shSingleQuote(process.env.CALENDIT_CONFIG_DIR)}`);
+    }
+    if (process.env.CALENDIT_EVENTKIT_HELPER) {
+        exports.push(`export CALENDIT_EVENTKIT_HELPER=${shSingleQuote(process.env.CALENDIT_EVENTKIT_HELPER)}`);
+    }
+    const macosRest = macosArgv.join(" ");
+    const exportPrefix = exports.length ? `${exports.join(" && ")} && ` : "";
+    return `${exportPrefix}cd ${shSingleQuote(cwd)} && ${inv} macos ${macosRest}`;
+}
+/** Tell Terminal.app to run `shellLine` (Calendar TCC applies to Terminal, not IDE host). */
+export function buildMacosTerminalSessionLine(cwd) {
+    const exports = [];
+    if (process.env.CALENDIT_CONFIG_DIR) {
+        exports.push(`export CALENDIT_CONFIG_DIR=${shSingleQuote(process.env.CALENDIT_CONFIG_DIR)}`);
+    }
+    if (process.env.CALENDIT_EVENTKIT_HELPER) {
+        exports.push(`export CALENDIT_EVENTKIT_HELPER=${shSingleQuote(process.env.CALENDIT_EVENTKIT_HELPER)}`);
+    }
+    const shell = process.env.SHELL || "/bin/zsh";
+    const exportPrefix = exports.length ? `${exports.join(" && ")} && ` : "";
+    return `${exportPrefix}cd ${shSingleQuote(cwd)} && exec ${shSingleQuote(shell)} -l`;
+}
+/**
+ * Run `shellLine` in Terminal.app. If a window already exists, reuse **window 1**
+ * (`do script … in window 1`) so each `external` call does not spawn a separate window.
+ * (Terminal may still open a **new tab** per call, depending on user preferences.)
+ */
+export function openTerminalAndRunShellLine(shellLine) {
+    const line = JSON.stringify(shellLine);
+    const script = [
+        `tell application "Terminal"`,
+        `  activate`,
+        `  if (count of windows) is 0 then`,
+        `    do script ${line}`,
+        `  else`,
+        `    do script ${line} in window 1`,
+        `  end if`,
+        `end tell`,
+    ].join("\n");
+    execFileSync("osascript", ["-e", script], { stdio: "inherit" });
+}

package/dist/generated/locale-keys.d.ts

@@ -0,0 +1,3 @@
+/** Generated by scripts/gen-locale-keys.mjs — do not edit by hand */
+export type LocaleKey = "common.hint" | "config.check.contexts" | "config.check.contextsNone" | "config.check.fileLine" | "config.check.googleNotSet" | "config.check.googleOk" | "config.check.header" | "config.check.outlookNotSet" | "config.check.outlookOk" | "config.check.uiLocale" | "config.cmd.contextDeleted" | "config.cmd.contextSaved" | "config.cmd.googleSaved" | "config.cmd.localeSet" | "config.cmd.macosTransportSet" | "config.cmd.outlookSaved" | "errors.api.prefix" | "errors.apiWithStatus" | "errors.auth.googleLoginHint" | "errors.auth.prefix" | "errors.config.fileNotFound" | "errors.config.fileNotFoundHint" | "errors.config.invalidFormat" | "errors.config.invalidFormatDetails" | "errors.config.prefix" | "errors.config.readFailed" | "errors.config.readFailedHint" | "errors.context.loadFailed" | "errors.context.loadFailedHint" | "errors.context.missing" | "errors.context.missingHint" | "errors.datetime.invalidFormat" | "errors.datetime.invalidParse" | "errors.datetime.invalidParseHint" | "errors.service.googleCredsNotSet" | "errors.service.googleCredsNotSetHint" | "errors.service.outlookCredsNotSet" | "errors.service.outlookCredsNotSetHint" | "errors.unknown" | "errors.validation.prefix" | "eventkit.bridge.bridgeError" | "eventkit.bridge.closedWithoutResponse" | "eventkit.bridge.connectFailed" | "eventkit.bridge.hintStartBridge" | "eventkit.bridge.invalidJson" | "eventkit.bridge.timeout" | "eventkit.bridge.tokenMissing" | "eventkit.helper.exitCode" | "eventkit.helper.hintBuild" | "eventkit.helper.missing" | "eventkit.helper.timeout" | "locale.bootstrap.choiceEn" | "locale.bootstrap.choiceJa" | "locale.bootstrap.prompt" | "macos.bridge.buildFailed" | "macos.bridge.buildNoSource" | "macos.bridge.buildOk" | "macos.bridge.fetchBuildPrompt" | "macos.bridge.fetchCancel" | "macos.bridge.fetchConfirm" | "macos.bridge.fetchFailed" | "macos.bridge.fetchIntro" | "macos.bridge.fetchNoTty" | "macos.bridge.fetchOk" | "macos.bridge.fetchPlan" | "macos.bridge.fetchSizeKnown" | "macos.bridge.fetchSizeUnknown" | "macos.bridge.fetchSkipsExisting" | "macos.bridge.notFound" | "macos.bridge.openFailed" | "macos.bridge.opened" | "macos.external.badSub" | "macos.external.badSubHint" | "macos.external.jsonOnlyForList" | "macos.external.onlyDarwin" | "macos.external.opened" | "macos.external.osascriptFailed" | "macos.external.suggestionWhenDenied" | "macos.setup.canceled" | "macos.setup.contextName" | "macos.setup.contextNameRequired" | "macos.setup.noCalendars" | "macos.setup.noTransport" | "macos.setup.notDarwin" | "macos.setup.pickCalendar" | "macos.setup.saved" | "macos.setup.startBridgePrompt" | "macos.setup.tcc";
+export declare const LOCALE_KEYS: readonly LocaleKey[];

package/dist/generated/locale-keys.js

@@ -0,0 +1,90 @@
+export const LOCALE_KEYS = [
+    "common.hint",
+    "config.check.contexts",
+    "config.check.contextsNone",
+    "config.check.fileLine",
+    "config.check.googleNotSet",
+    "config.check.googleOk",
+    "config.check.header",
+    "config.check.outlookNotSet",
+    "config.check.outlookOk",
+    "config.check.uiLocale",
+    "config.cmd.contextDeleted",
+    "config.cmd.contextSaved",
+    "config.cmd.googleSaved",
+    "config.cmd.localeSet",
+    "config.cmd.macosTransportSet",
+    "config.cmd.outlookSaved",
+    "errors.api.prefix",
+    "errors.apiWithStatus",
+    "errors.auth.googleLoginHint",
+    "errors.auth.prefix",
+    "errors.config.fileNotFound",
+    "errors.config.fileNotFoundHint",
+    "errors.config.invalidFormat",
+    "errors.config.invalidFormatDetails",
+    "errors.config.prefix",
+    "errors.config.readFailed",
+    "errors.config.readFailedHint",
+    "errors.context.loadFailed",
+    "errors.context.loadFailedHint",
+    "errors.context.missing",
+    "errors.context.missingHint",
+    "errors.datetime.invalidFormat",
+    "errors.datetime.invalidParse",
+    "errors.datetime.invalidParseHint",
+    "errors.service.googleCredsNotSet",
+    "errors.service.googleCredsNotSetHint",
+    "errors.service.outlookCredsNotSet",
+    "errors.service.outlookCredsNotSetHint",
+    "errors.unknown",
+    "errors.validation.prefix",
+    "eventkit.bridge.bridgeError",
+    "eventkit.bridge.closedWithoutResponse",
+    "eventkit.bridge.connectFailed",
+    "eventkit.bridge.hintStartBridge",
+    "eventkit.bridge.invalidJson",
+    "eventkit.bridge.timeout",
+    "eventkit.bridge.tokenMissing",
+    "eventkit.helper.exitCode",
+    "eventkit.helper.hintBuild",
+    "eventkit.helper.missing",
+    "eventkit.helper.timeout",
+    "locale.bootstrap.choiceEn",
+    "locale.bootstrap.choiceJa",
+    "locale.bootstrap.prompt",
+    "macos.bridge.buildFailed",
+    "macos.bridge.buildNoSource",
+    "macos.bridge.buildOk",
+    "macos.bridge.fetchBuildPrompt",
+    "macos.bridge.fetchCancel",
+    "macos.bridge.fetchConfirm",
+    "macos.bridge.fetchFailed",
+    "macos.bridge.fetchIntro",
+    "macos.bridge.fetchNoTty",
+    "macos.bridge.fetchOk",
+    "macos.bridge.fetchPlan",
+    "macos.bridge.fetchSizeKnown",
+    "macos.bridge.fetchSizeUnknown",
+    "macos.bridge.fetchSkipsExisting",
+    "macos.bridge.notFound",
+    "macos.bridge.openFailed",
+    "macos.bridge.opened",
+    "macos.external.badSub",
+    "macos.external.badSubHint",
+    "macos.external.jsonOnlyForList",
+    "macos.external.onlyDarwin",
+    "macos.external.opened",
+    "macos.external.osascriptFailed",
+    "macos.external.suggestionWhenDenied",
+    "macos.setup.canceled",
+    "macos.setup.contextName",
+    "macos.setup.contextNameRequired",
+    "macos.setup.noCalendars",
+    "macos.setup.noTransport",
+    "macos.setup.notDarwin",
+    "macos.setup.pickCalendar",
+    "macos.setup.saved",
+    "macos.setup.startBridgePrompt",
+    "macos.setup.tcc",
+];

package/dist/index.js

@@ -1,14 +1,23 @@
 import { Command } from "commander";
+import { createRequire } from "module";
 import { AuthManager } from "./core/auth.js";
 import { ConfigManager } from "./core/config.js";
+import { applyEventkitConfigToEnvAfterLoad } from "./core/eventkitEnvFromConfig.js";
 import { ApiError, AuthError, CalendarError, ConfigError, ValidationError } from "./core/errors.js";
 import { logger, setDebugDump, setLogLevel } from "./core/logger.js";
+import { t } from "./core/i18n.js";
+import { applyResolvedLocale, ensureLocalePreference, shouldSkipLocaleBootstrap } from "./core/localeBootstrap.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
 import { registerAuthCommands } from "./commands/auth.js";
 import { registerConfigCommands } from "./commands/config.js";
 import { registerQueryCommand } from "./commands/query.js";
 import { registerApplyCommand } from "./commands/apply.js";
 import { registerAddCommand } from "./commands/add.js";
 import { registerCalCommands } from "./commands/cal.js";
+import { registerAccountsCommands } from "./commands/accounts.js";
+import { registerMacosCommands } from "./commands/macos.js";
+import { registerOnboardCommand } from "./commands/onboard.js";
 const program = new Command();
 const deps = {
     config: new ConfigManager(),
@@ -17,10 +26,17 @@ const deps = {
 program
     .name("calendit")
     .description("Terminal-based Calendar Management Tool")
-    .version("2026-0416-01.02")
+    .version(version)
     .option("--verbose", "Enable verbose debug logs", false)
-    .option("--debug-dump <file>", "Write all logs to a file");
-program.hook("preAction", (thisCommand) => {
+    .option("--debug-dump <file>", "Write all logs to a file")
+    .option("--locale <code>", "UI language: en or ja (overrides config for this run)");
+program.hook("preAction", async (thisCommand) => {
+    await ensureLocalePreference(program, deps.config);
+    if (!shouldSkipLocaleBootstrap()) {
+        await deps.config.loadOptional();
+        applyEventkitConfigToEnvAfterLoad(deps.config);
+    }
+    applyResolvedLocale(program, deps.config);
     const opts = thisCommand.optsWithGlobals();
     if (opts.debugDump) {
         setDebugDump(opts.debugDump);
@@ -32,44 +48,98 @@ program.hook("preAction", (thisCommand) => {
         logger.debug("Logger", "Verbose mode enabled.");
     }
 });
+registerOnboardCommand(program);
 registerAuthCommands(program, deps);
+registerAccountsCommands(program, deps);
+registerMacosCommands(program, deps);
 registerConfigCommands(program, deps);
 registerQueryCommand(program, deps);
 registerApplyCommand(program, deps);
 registerAddCommand(program, deps);
 registerCalCommands(program, deps);
+const ERROR_META_MAX_DETAILS = 800;
+function summarizeForErrorMeta(details) {
+    if (details === null || details === undefined)
+        return undefined;
+    try {
+        const s = JSON.stringify(details);
+        if (s.length <= ERROR_META_MAX_DETAILS)
+            return details;
+        return { _truncated: true, preview: s.slice(0, ERROR_META_MAX_DETAILS) };
+    }
+    catch {
+        return { _nonSerializable: true, string: String(details) };
+    }
+}
+/** Single-line JSON for `DEBUG=calendit` diagnostics (not a user-facing i18n key). */
+function logErrorMeta(payload) {
+    try {
+        logger.debug("ErrorMeta", JSON.stringify(payload));
+    }
+    catch {
+        logger.debug("ErrorMeta", JSON.stringify({ kind: String(payload.kind ?? "Error") }));
+    }
+}
 function handleError(error) {
     const isVerbose = process.argv.includes("--verbose") || process.env.DEBUG === "calendit";
     if (error instanceof ValidationError) {
-        logger.error(`入力エラー: ${error.message}`);
+        logger.error(`${t("errors.validation.prefix")} ${error.message}`);
         if (error.hint)
-            logger.info(`ヒント: ${error.hint}`);
+            logger.info(`${t("common.hint")} ${error.hint}`);
+        logErrorMeta({
+            kind: "ValidationError",
+            name: error.name,
+            message: error.message,
+            hint: error.hint,
+        });
         if (isVerbose && error.stack)
             logger.debug("STACK", error.stack);
         process.exit(1);
     }
     if (error instanceof ConfigError) {
-        logger.error(`設定エラー: ${error.message}`);
+        logger.error(`${t("errors.config.prefix")} ${error.message}`);
         if (error.hint)
-            logger.info(`ヒント: ${error.hint}`);
+            logger.info(`${t("common.hint")} ${error.hint}`);
+        logErrorMeta({
+            kind: "ConfigError",
+            name: error.name,
+            message: error.message,
+            hint: error.hint,
+            causeCode: error.causeCode ?? null,
+        });
         if (isVerbose && error.stack)
             logger.debug("STACK", error.stack);
         process.exit(1);
     }
     if (error instanceof AuthError) {
-        logger.error(`認証エラー: ${error.message}`);
+        logger.error(`${t("errors.auth.prefix")} ${error.message}`);
         if (error.hint)
-            logger.info(`ヒント: ${error.hint}`);
+            logger.info(`${t("common.hint")} ${error.hint}`);
+        logErrorMeta({
+            kind: "AuthError",
+            name: error.name,
+            message: error.message,
+            hint: error.hint,
+        });
         if (isVerbose && error.stack)
             logger.debug("STACK", error.stack);
         process.exit(1);
     }
     if (error instanceof ApiError) {
-        const statusPart = error.statusCode ? ` (${error.statusCode})` : "";
-        logger.error(`API エラー${statusPart}: ${error.message}`);
+        const statusPart = error.statusCode ? String(error.statusCode) : "";
+        const prefix = statusPart ? t("errors.apiWithStatus", { status: statusPart }) : `${t("errors.api.prefix")}:`;
+        logger.error(`${prefix} ${error.message}`);
         if (error.hint)
-            logger.info(`ヒント: ${error.hint}`);
-        logger.debug("ApiError", "API error details", error.details);
+            logger.info(`${t("common.hint")} ${error.hint}`);
+        logErrorMeta({
+            kind: "ApiError",
+            name: error.name,
+            message: error.message,
+            hint: error.hint,
+            statusCode: error.statusCode ?? null,
+            provider: error.provider ?? null,
+            details: summarizeForErrorMeta(error.details),
+        });
         if (isVerbose && error.stack)
             logger.debug("STACK", error.stack);
         process.exit(1);
@@ -77,18 +147,33 @@ function handleError(error) {
     if (error instanceof CalendarError) {
         logger.error(error.message);
         if (error.hint)
-            logger.info(`ヒント: ${error.hint}`);
+            logger.info(`${t("common.hint")} ${error.hint}`);
+        logErrorMeta({
+            kind: "CalendarError",
+            name: error.name,
+            message: error.message,
+            hint: error.hint,
+        });
         if (isVerbose && error.stack)
             logger.debug("STACK", error.stack);
         process.exit(1);
     }
     const unknown = error;
-    logger.error(`予期しないエラー: ${unknown?.message || String(error)}`);
-    if (isVerbose && error instanceof Error && error.stack) {
-        logger.debug("STACK", error.stack);
+    logger.error(`${t("errors.unknown")} ${unknown?.message || String(error)}`);
+    if (error instanceof Error) {
+        logErrorMeta({
+            kind: "UnknownError",
+            name: error.name,
+            message: error.message,
+        });
+        if (isVerbose && error.stack)
+            logger.debug("STACK", error.stack);
     }
     else {
-        logger.debug("UnknownError", error);
+        logErrorMeta({
+            kind: "UnknownError",
+            message: String(error),
+        });
     }
     process.exit(1);
 }

package/dist/locales/en.json

@@ -0,0 +1,128 @@
+{
+  "errors": {
+    "validation": { "prefix": "Validation error:" },
+    "config": {
+      "prefix": "Configuration error:",
+      "fileNotFound": "Config file not found.",
+      "fileNotFoundHint": "Run `calendit config set-google --id <id> --secret <secret>` (or see docs) to create your configuration.",
+      "invalidFormat": "Invalid config file format.",
+      "invalidFormatDetails": "Check config.json. Details: {details}",
+      "readFailed": "Failed to read configuration.",
+      "readFailedHint": "Verify config.json JSON syntax."
+    },
+    "auth": {
+      "prefix": "Authentication error:",
+      "googleLoginHint": "See docs/setup_google.md or run `calendit config set-google --file <path>`."
+    },
+    "api": { "prefix": "API error" },
+    "apiWithStatus": "API error ({status}):",
+    "unknown": "Unexpected error:",
+    "datetime": {
+      "invalidFormat": "Invalid date/time format: \"{input}\"",
+      "invalidParse": "Could not parse as date/time: \"{input}\"",
+      "invalidParseHint": "Check the value. Use HH:mm for times (e.g. today 10:00)."
+    },
+    "service": {
+      "googleCredsNotSet": "Google credentials are not set.",
+      "googleCredsNotSetHint": "Run `calendit config set-google --id <id> --secret <secret>`.",
+      "outlookCredsNotSet": "Outlook credentials are not set.",
+      "outlookCredsNotSetHint": "Run `calendit config set-outlook --id <id>`."
+    },
+    "context": {
+      "missing": "Context '{name}' was not found.",
+      "missingHint": "Run `calendit config set-context {name} --service google --calendar primary` to create it.",
+      "loadFailed": "Failed to load configuration. Run 'calendit --help' for setup instructions.",
+      "loadFailedHint": "Run `calendit config set-google` (etc.) to set up."
+    }
+  },
+  "common": {
+    "hint": "Hint:"
+  },
+  "config": {
+    "cmd": {
+      "googleSaved": "Google credentials saved to config.",
+      "outlookSaved": "Outlook credentials saved to config.",
+      "contextSaved": "Context '{name}' saved.",
+      "contextDeleted": "Context '{name}' deleted.",
+      "localeSet": "UI locale set to '{locale}'.",
+      "macosTransportSet": "EventKit default transport is now '{value}' (applies when CALENDIT_EVENTKIT_BRIDGE is not set in the environment)."
+    },
+    "check": {
+      "header": "[CONFIG CHECK]",
+      "googleOk": "Google credentials : OK (id: {mask})",
+      "googleNotSet": "Google credentials : NOT SET (run: calendit config set-google --id <id> --secret <secret>)",
+      "outlookOk": "Outlook credentials: OK (id: {mask})",
+      "outlookNotSet": "Outlook credentials: NOT SET (run: calendit config set-outlook --id <id>)",
+      "contexts": "Contexts           : {list}",
+      "contextsNone": "Contexts           : none",
+      "fileLine": "Config file        : ~/.config/calendit/config.json (or CALENDIT_CONFIG_DIR override)",
+      "uiLocale": "UI locale          : {locale}"
+    }
+  },
+  "locale": {
+    "bootstrap": {
+      "prompt": "Choose your language for calendit messages:",
+      "choiceEn": "English",
+      "choiceJa": "Japanese (日本語)"
+    }
+  },
+  "eventkit": {
+    "bridge": {
+      "tokenMissing": "EventKit bridge token not found at {path}.",
+      "hintStartBridge": "Start the bridge: calendit macos bridge start, or open CalenditEventKitBridge.app (e.g. in /Applications).",
+      "connectFailed": "Could not connect to the EventKit bridge at {path}: {message}.",
+      "timeout": "EventKit bridge did not respond within {ms} ms.",
+      "invalidJson": "Invalid JSON from the EventKit bridge: {line}",
+      "closedWithoutResponse": "The EventKit bridge closed before sending a response.",
+      "bridgeError": "EventKit bridge error"
+    },
+    "helper": {
+      "missing": "EventKit helper binary not found.",
+      "hintBuild": "Set CALENDIT_EVENTKIT_HELPER, or run: (cd native/eventkit-helper && swift build -c release).",
+      "timeout": "EventKit helper did not complete within {ms} ms.",
+      "exitCode": "EventKit helper exited with code {code}."
+    }
+  },
+  "macos": {
+    "bridge": {
+      "openFailed": "Could not open the bridge app: {message}.",
+      "opened": "Launched {path}. Wait a few seconds, then run: calendit macos doctor",
+      "notFound": "CalenditEventKitBridge.app not found. Install a release, use Homebrew when available, or in a full clone run: calendit macos bridge build — then: calendit macos bridge start",
+      "buildNoSource": "EventKit bridge sources are not available next to this install. Use a full git clone, or set CALENDIT_EVENTKIT_BRIDGE_ROOT to your native/eventkit-bridge directory.",
+      "buildOk": "Build finished. App bundle: {path}",
+      "buildFailed": "EventKit bridge build failed: {message}",
+      "fetchIntro": "Download the calendit repository snapshot from GitHub, extract only native/eventkit-bridge, and place it under your calendit data directory (next to the bridge token when using the default location). A Swift build (see next step) will compile CalenditEventKitBridge.app.",
+      "fetchPlan": "• Source archive: {url}\n• Approx. download size: {sizeLine}\n• Extract to: {dest}\n• Then (optional) run the Swift build to create the .app under .build/ in that folder.",
+      "fetchSizeKnown": "about {mb} MiB (Content-Length from server)",
+      "fetchSizeUnknown": "unknown (HEAD did not return Content-Length; may be a few MB)",
+      "fetchConfirm": "Proceed with download and extract?",
+      "fetchCancel": "Canceled. No files were downloaded.",
+      "fetchBuildPrompt": "Run the Swift build now to create CalenditEventKitBridge.app? (requires Xcode Command Line Tools: swift, codesign)",
+      "fetchOk": "Fetched EventKit bridge sources to {path}. You can run: calendit macos bridge start (after build) or calendit macos setup.",
+      "fetchSkipsExisting": "Bridge sources already exist at {path}. Use --force to re-download, or run: calendit macos bridge build",
+      "fetchFailed": "Download or extract failed: {message}",
+      "fetchNoTty": "Non-interactive: use --yes to confirm the download, or use an interactive terminal."
+    },
+    "setup": {
+      "notDarwin": "macOS only.",
+      "noTransport": "EventKit is not available: no helper binary and no ready local bridge. Build the helper, start the EventKit bridge, or see docs.",
+      "tcc": "Allow Calendar access for CalenditEventKitBridge: System Settings → Privacy & Security → Calendars. When done, press Enter here to re-check.",
+      "pickCalendar": "Which calendar should this context use?",
+      "contextName": "Name for this context (e.g. my-mac):",
+      "contextNameRequired": "Context name is required.",
+      "saved": "Saved context '{name}' (macos, calendar {calendarId}).",
+      "noCalendars": "No calendars were returned (or access was denied).",
+      "startBridgePrompt": "The bridge does not seem to be running. Open CalenditEventKitBridge.app now?",
+      "canceled": "Setup canceled."
+    },
+    "external": {
+      "onlyDarwin": "macOS only.",
+      "badSub": "Subcommand must be `doctor`, `list-calendars`, or `shell`.",
+      "badSubHint": "Examples: calendit macos external doctor  |  calendit macos external list-calendars --json  |  calendit macos external shell",
+      "jsonOnlyForList": "`--json` applies only to `list-calendars`.",
+      "opened": "Opened Terminal.app — check the new window. Command: {cmd}",
+      "osascriptFailed": "Could not open Terminal.app via AppleScript: {message}",
+      "suggestionWhenDenied": "Calendar access is denied from this terminal. Run: calendit macos external doctor (permission prompt in Terminal), or calendit macos external shell (open Terminal here for all macos / query commands)."
+    }
+  }
+}