kintai-plus-mcp 0.1.0 → 0.1.2

package/README.md

@@ -8,7 +8,7 @@
 「出勤して」「今月の残業はどれくらい？」「昨日の工数を設計 2 時間・実装 5 時間で入れて」のように話しかけるだけで、打刻・勤務実績の確認・工数入力ができます。
 
 - 手元の PC で動くローカルの stdio サーバーです（トークンを第三者のサーバーに預けません）
-- トークンは OS のキーチェーンに保存し、有効期限が近づくと自動で再発行します
+- トークンは OS のキーチェーンに保存し、有効期限が近づくと自動で再発行します（環境変数で渡したトークンは、明示しない限り保存も再発行もしません）
 - 打刻の位置情報・IP アドレスは、既定では AI に渡しません
 
 公開 API の仕様（公式）: [マネーフォワード クラウド勤怠Plus 公開API 仕様](https://akashi.zendesk.com/hc/ja/articles/115000475854)
@@ -26,7 +26,7 @@
 | `get_working_records` | 勤務実績（労働区分・時刻・実働・休憩。31 日ごとに自動で分割） |
 | `summarize_working_hours` | 実働合計・出勤日数・休日出勤日数・法定時間外の目安（月ごとの内訳つき） |
 | `get_alerts` | アラート（打刻忘れ、遅刻、36協定 など） |
-| `check_attendance_issues` | 打刻漏れチェック（退勤・出勤・休憩戻の打刻忘れ、12 時間超の日、勤務間インターバル 11 時間未満、休日出勤） |
+| `check_attendance_issues` | 打刻漏れチェック（退勤・出勤・休憩戻の打刻忘れ、12 時間超の日、勤務間インターバル 11 時間未満、休日出勤）。勤務実績にその時刻がある日は打刻漏れにしない。休憩が不明な経過時間は、12 時間超を情報にとどめる |
 | `list_projects` / `list_tasks` / `get_my_projects` | プロジェクトとタスク |
 | `get_manhours` | 工数（プロジェクト名・タスク名つき） |
 | `save_manhours` 【書き込み】 / `delete_manhours` 【書き込み】 | 工数の登録・更新・削除 |
@@ -63,9 +63,9 @@
 
 **管理者が行うこと**（一度だけ）: 従業員設定 > 対象の従業員の「変更」 > 利用機能設定 で、「公開API利用可否」を「利用する」にします。
 
-**本人が行うこと**: マイページ > APIトークン で発行します。トークンの有効期限は 1 ヶ月と 1 日です（このツールが自動で再発行します）。
+**本人が行うこと**: マイページ > APIトークン で発行します。トークンの有効期限は 1 ヶ月と 1 日です。`login` で登録したトークンは、登録時と、期限が近づいたときに再発行します。
 
-> このツール専用のトークンを発行してください。初回の利用時と期限が近づいたときに再発行するため、同じトークンを他のツールで使っていると、そちらが使えなくなることがあります。
+> `login` で登録するトークンは、このツール専用にしてください。再発行すると、それまで使っていたトークンは使えなくなります。環境変数で渡すだけの場合は、既定では再発行しません（下の「環境変数でトークンを渡す」）。
 
 ### 2. ログイン
 
@@ -165,24 +165,29 @@ args = ["-y", "kintai-plus-mcp"]
 | 変数 | 既定 | 内容 |
 |---|---|---|
 | `KINTAI_PLUS_READ_ONLY` | `false` | `true` で書き込みツール（打刻・工数）を出さない |
-| `CONFIRM_WRITES` | `false` | `true` で書き込みの前に確認ダイアログを出す（Elicitation に対応したクライアントのみ。未対応のクライアントでは書き込みが失敗します） |
+| `KINTAI_PLUS_CONFIRM_WRITES` | `false` | `true` で書き込みの前に確認ダイアログを出す（Elicitation に対応したクライアントのみ。未対応のクライアントでは書き込みが失敗します）。旧名の `CONFIRM_WRITES` も当面は読みます |
 | `KINTAI_PLUS_INCLUDE_LOCATION` | `false` | `true` で打刻の位置情報・IP を返す |
 | `KINTAI_PLUS_REFRESH_DAYS` | `15` | 有効期限の残りがこの日数を切ったら再発行する（1〜30） |
 | `KINTAI_PLUS_AUTO_REFRESH` | `true` | `false` で自動の再発行を止める |
+| `KINTAI_PLUS_PERSIST_ENV_TOKEN` | `false` | `true` で、環境変数のトークンを保存し、期限が不明なら再発行する。環境変数の値は使えなくなることがある |
 | `KINTAI_PLUS_CREDENTIAL_STORE` | `auto` | 保存先: `auto`（キーチェーン → ファイル）/ `keychain` / `file` |
 | `KINTAI_PLUS_CREDENTIALS_FILE` | `~/.config/kintai-plus-mcp/credentials.json` | ファイル保存のパス（指定するとファイル保存になる） |
 | `KINTAI_PLUS_LOG_LEVEL` | `info` | `debug` / `info` / `warn` / `error` / `silent`（ログは stderr のみ） |
 | `KINTAI_PLUS_MIN_INTERVAL_MS` | `300` | API リクエストの最小間隔（ミリ秒） |
 
-### キーチェーンのない環境（サーバー上のボットなど）
+### 環境変数でトークンを渡す（ボットなど）
 
-キーチェーンが使えない環境では、本人だけが読み書きできるファイル（パーミッション 600）に保存します。`login` を対話で行えない場合は、環境変数で初回だけ取り込めます。
+`login` が使えないときは、環境変数だけで起動できます。**既定では保存せず、再発行 API も呼びません。**
 
 ```sh
 KINTAI_PLUS_TOKEN=... KINTAI_PLUS_COMPANY_ID=... KINTAI_PLUS_HOST=atnd.ak4.jp npx kintai-plus-mcp
 ```
 
-保存先が空のときだけ取り込み、以降は保存先の値（自動で再発行されたもの）を使います。
+再発行 API は、渡したトークンを無効にして新しいトークンを返します。環境変数の値を自動で再発行すると、その値を共有している他のプロセスが突然使えなくなります。このサーバーは、明示しない限りそれをしません。
+
+自動更新（期限が近づいたら再発行して保存）が必要なときは、このサーバー専用のトークンを `npx kintai-plus-mcp login` で登録してください。キーチェーンが使えない環境では、本人だけが読み書きできるファイル（パーミッション 600）に保存します。
+
+環境変数のトークンを保存して再発行する動作は、`KINTAI_PLUS_PERSIST_ENV_TOKEN=true` を付けたときだけです。有効にすると、環境変数に書いたトークンは使えなくなることがあります。保存先にすでに認証情報があるときは、環境変数より保存先を優先します。
 
 ## 制約
 
@@ -227,7 +232,7 @@ This project is not affiliated with, endorsed by, or sponsored by Money Forward,
 - Punch in/out, check today's status, view punch history, working records, alerts, and man-hours, and record man-hours
 - Admin tools (staff list, team punches, working statuses, project members) are shown only to admins
 - Runs locally over stdio: `npx kintai-plus-mcp`. Register your token first with `npx kintai-plus-mcp login`
-- The token is stored in the OS keychain (or a 600-permission file) and reissued automatically before it expires
+- The token is stored in the OS keychain (or a 600-permission file) and reissued automatically before it expires. A token passed only via `KINTAI_PLUS_TOKEN` is not stored or reissued unless `KINTAI_PLUS_PERSIST_ENV_TOKEN=true` (reissue invalidates the previous token)
 - Location and IP address of punches are not sent to the AI by default
 - Not supported: requests (申請) and schedules, because the public API does not provide them. Punches are recorded at the time the server receives them and cannot be edited via the API
 - Requires Node.js 22+ and an API token issued from your Kintai Plus "My Page" (an admin must enable "公開API利用可否" for you)

package/dist/cli.mjs

@@ -621,6 +621,7 @@ var TokenManager = class {
 		this.#o = {
 			refreshBeforeDays: 15,
 			autoRefresh: true,
+			reissueUnknownExpiry: true,
 			now: () => /* @__PURE__ */ new Date(),
 			warn: () => {},
 			cacheTtlMs: 6e4,
@@ -653,7 +654,7 @@ var TokenManager = class {
 		return credentials;
 	}
 	#needsRefresh(credentials) {
-		if (credentials.expiresAt === void 0) return true;
+		if (credentials.expiresAt === void 0) return this.#o.reissueUnknownExpiry;
 		return Date.parse(credentials.expiresAt) - this.#o.now().getTime() <= this.#o.refreshBeforeDays * DAY_MS$1;
 	}
 	#isExpired(credentials) {
@@ -752,7 +753,7 @@ const silentLogger = createLogger({
 // package.json
 var name = "kintai-plus-mcp";
 // src/version.ts
-const VERSION = "0.1.0";
+const VERSION = "0.1.2";
 const PACKAGE_NAME = name;
 // src/api/throttle.ts
 const systemClock = {
@@ -906,10 +907,11 @@ function loadConfig(env = process.env) {
 		refreshBeforeDays: int(env, "KINTAI_PLUS_REFRESH_DAYS", 15, 1, 30),
 		autoRefresh: bool(env, "KINTAI_PLUS_AUTO_REFRESH", true),
 		readOnly: bool(env, "KINTAI_PLUS_READ_ONLY", false),
-		confirmWrites: bool(env, "CONFIRM_WRITES", false),
+		confirmWrites: read(env, "KINTAI_PLUS_CONFIRM_WRITES") !== void 0 ? bool(env, "KINTAI_PLUS_CONFIRM_WRITES", false) : bool(env, "CONFIRM_WRITES", false),
 		includeLocation: bool(env, "KINTAI_PLUS_INCLUDE_LOCATION", false),
 		logLevel: oneOf(env, "KINTAI_PLUS_LOG_LEVEL", LOG_LEVELS, "info"),
-		minIntervalMs: int(env, "KINTAI_PLUS_MIN_INTERVAL_MS", 300, 100, 6e4)
+		minIntervalMs: int(env, "KINTAI_PLUS_MIN_INTERVAL_MS", 300, 100, 6e4),
+		persistEnvToken: bool(env, "KINTAI_PLUS_PERSIST_ENV_TOKEN", false)
 	};
 }
 function read(env, name) {
@@ -1167,10 +1169,11 @@ async function selectCredentialStore(options = {}) {
 	return fallback;
 }
 /**
-* 保存先が空のときだけ、環境変数から認証情報を取り込む。以降は保存先を正とする。
-* 戻り値は保存先にある（または取り込んだ）認証情報。どちらもなければ undefined。
+* 保存先が空のとき、環境変数から認証情報を読む。
+* 既定では保存しない。`persist: true` のときだけ保存し、以降は保存先を正とする。
+* 保存先に既にあれば、環境変数は無視して保存先を返す。
 */
-async function importFromEnv(store, env = process.env, now = /* @__PURE__ */ new Date()) {
+async function importFromEnv(store, env = process.env, now = /* @__PURE__ */ new Date(), options = {}) {
 	const existing = await store.load();
 	if (existing) return existing;
 	const token = env[TOKEN_ENV]?.trim();
@@ -1186,9 +1189,41 @@ async function importFromEnv(store, env = process.env, now = /* @__PURE__ */ new
 		token,
 		updatedAt: now.toISOString()
 	};
-	await store.save(credentials);
+	if (options.persist) await store.save(credentials);
 	return credentials;
 }
+/**
+* 保存先が空のあいだ、環境変数のトークンをメモリ上だけで返す。
+* 保存先に認証情報が入ったあと（login など）は保存先を読む。書き出しは保存先に既にあるときだけ。
+*/
+var EnvFallbackStore = class {
+	#inner;
+	#fallback;
+	constructor(inner, fallback) {
+		this.#inner = inner;
+		this.#fallback = fallback;
+	}
+	get kind() {
+		return this.#inner.kind;
+	}
+	get location() {
+		return this.#inner.location;
+	}
+	async load() {
+		return await this.#inner.load() ?? this.#fallback;
+	}
+	async save(credentials) {
+		if (await this.#inner.load()) {
+			await this.#inner.save(credentials);
+			return;
+		}
+		this.#fallback = credentials;
+	}
+	async clear() {
+		this.#fallback = void 0;
+		return this.#inner.clear();
+	}
+};
 // src/runtime.ts
 /** 設定・ログ・保存先・トークン管理・API クライアントを組み立てる。 */
 async function createRuntime(options = {}) {
@@ -1213,10 +1248,25 @@ async function createRuntime(options = {}) {
 		...options.onResponse ? { onResponse: options.onResponse } : {}
 	});
 	const lockPath = join(dirname(defaultCredentialsPath(env)), "refresh.lock");
+	let tokenStore = store;
+	let usingEnvToken = false;
+	try {
+		const before = await store.load();
+		const imported = await importFromEnv(store, env, options.now?.() ?? /* @__PURE__ */ new Date(), { persist: config.persistEnvToken });
+		if (imported) logger.addSecret(imported.token);
+		if (!before && imported && !config.persistEnvToken) {
+			usingEnvToken = true;
+			tokenStore = new EnvFallbackStore(store, imported);
+		}
+	} catch (error) {
+		if (!(error instanceof CredentialsFormatError)) throw error;
+		logger.warn(error.message);
+	}
 	const tokens = new TokenManager({
-		store,
+		store: tokenStore,
 		refreshBeforeDays: config.refreshBeforeDays,
 		autoRefresh: config.autoRefresh,
+		reissueUnknownExpiry: !usingEnvToken,
 		warn: (m) => logger.warn(m),
 		acquireLock: () => acquireFileLock(lockPath),
 		reissue: async (credentials) => {
@@ -1228,18 +1278,12 @@ async function createRuntime(options = {}) {
 		},
 		...options.now ? { now: options.now } : {}
 	});
-	try {
-		const imported = await importFromEnv(store, env, options.now?.() ?? /* @__PURE__ */ new Date());
-		if (imported) logger.addSecret(imported.token);
-	} catch (error) {
-		if (!(error instanceof CredentialsFormatError)) throw error;
-		logger.warn(error.message);
-	}
 	return {
 		config,
 		logger,
 		store,
 		tokens,
+		usingEnvToken,
 		createClient,
 		async getClient() {
 			const credentials = await tokens.getCredentials();
@@ -1389,20 +1433,28 @@ async function logout(deps) {
 	const removed = await runtime.store.clear();
 	io.stdout(removed ? `認証情報を削除しました: ${runtime.store.location}\nトークン自体はまだ有効です。不要ならマイページで無効化してください。
 ` : `保存された認証情報はありません: ${runtime.store.location}\n`);
-	if (deps.runtimeOptions?.env?.KINTAI_PLUS_TOKEN ?? process.env.KINTAI_PLUS_TOKEN) io.stderr("注意: KINTAI_PLUS_TOKEN が設定されているため、次回の起動時に再び取り込まれます。\n");
+	if ((deps.runtimeOptions?.env ?? process.env).KINTAI_PLUS_TOKEN) io.stderr(runtime.config.persistEnvToken ? "注意: KINTAI_PLUS_TOKEN が設定されているため、次回の起動時に再び保存されます。再発行すると、環境変数の値は使えなくなることがあります。\n" : "注意: KINTAI_PLUS_TOKEN が設定されています。保存した認証情報が無くても、次回の起動はこの環境変数のトークンを使います。保存しません。再発行もしません。\n");
 	return 0;
 }
 async function status(deps) {
 	const { io } = deps;
 	const runtime = await createRuntime(deps.runtimeOptions);
 	const now = deps.now?.() ?? /* @__PURE__ */ new Date();
-	const lines = [`保存先: ${runtime.store.location}`];
-	const credentials = await runtime.store.load();
+	const stored = await runtime.store.load();
+	const fromEnv = !stored && runtime.usingEnvToken;
+	const credentials = stored ?? (fromEnv ? await runtime.tokens.getCredentials() : void 0);
 	if (!credentials) {
-		io.stdout(`${lines.join("\n")}\n未ログインです。\`npx kintai-plus-mcp login\` で登録してください。\n`);
+		io.stdout(`保存先: ${runtime.store.location}\n未ログインです。\`npx kintai-plus-mcp login\` で登録してください。\n`);
 		return 1;
 	}
-	lines.push(`接続先: ${credentials.host}`, `ログイン企業ID: ${credentials.companyId}`, `従業員ID: ${credentials.staffId ?? "不明"}`, `有効期限: ${formatExpiry(credentials.expiresAt, now)}`, `自動更新: ${runtime.config.autoRefresh ? `有効（残り ${runtime.config.refreshBeforeDays} 日を切ったら再発行）` : "無効"}`);
+	const lines = [
+		fromEnv ? "保存先: なし（環境変数のトークンを、このプロセスの中だけで使います）" : `保存先: ${runtime.store.location}`,
+		`接続先: ${credentials.host}`,
+		`ログイン企業ID: ${credentials.companyId}`,
+		`従業員ID: ${credentials.staffId ?? "不明"}`,
+		`有効期限: ${fromEnv ? "不明（環境変数のトークンは自動では再発行しません）" : formatExpiry(credentials.expiresAt, now)}`,
+		`自動更新: ${fromEnv ? "無効（環境変数のトークンは再発行しません。自動更新が必要なら login で登録してください）" : runtime.config.autoRefresh ? `有効（残り ${runtime.config.refreshBeforeDays} 日を切ったら再発行）` : "無効"}`
+	];
 	let code = 0;
 	try {
 		const staff = await fetchMyStaff(await runtime.getClient(), { staffId: credentials.staffId });
@@ -2512,7 +2564,9 @@ function apiHint(error) {
 		case "unknown_company": return "The company ID (ログイン企業ID) was not found. Check the company ID and that the host matches the domain after login (atnd.ak4.jp or atnd-awj.ak4.jp), then run `npx kintai-plus-mcp login` again.";
 		case "forbidden": return "Kintai Plus denied this operation. The user may not have permission for it (admin rights may be required), or the public API (公開API利用可否) may be disabled for this user.";
 		case "not_found": return "The requested item was not found. Check the IDs (staff, project, task) and the date.";
-		case "invalid_request": return "Kintai Plus rejected the request. Check the parameters (dates, IDs, period length).";
+		case "invalid_request":
+			if (error.apiErrors.some((e) => e.message?.includes("従業員IDは必ず入力してください"))) return "Kintai Plus also returns 「従業員IDは必ず入力してください」 when a staff ID does not exist or is outside the staff you manage. It does not always mean staffIds was omitted. Check the IDs with list_staff.";
+			return "Kintai Plus rejected the request. Check the parameters (dates, IDs, period length).";
 		case "rate_limited": return "Too many requests. Wait a minute before trying again.";
 		case "server":
 		case "network":
@@ -2522,6 +2576,11 @@ function apiHint(error) {
 }
 // src/tools/common.ts
 const dateSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Use YYYY-MM-DD").describe("Date in YYYY-MM-DD (Japan time)");
+/** 月。01–12 以外（2026-13 など）は拒否する */
+const monthSchema = z.string().regex(/^\d{4}-(0[1-9]|1[0-2])$/, "Use YYYY-MM (month 01-12)");
+function assertMonth(month) {
+	if (!monthSchema.safeParse(month).success) throw new ToolInputError(`Invalid month: ${month} (use YYYY-MM, month 01-12)`);
+}
 /** ツール入力の期間を検証して DateRange にする */
 function resolveRange(input, now, defaults) {
 	const from = input.from ?? defaults.from ?? todayInTokyo(now);
@@ -2542,9 +2601,12 @@ function formatMinutes(minutes) {
 	return `${sign}${Math.floor(abs / 60)}:${String(abs % 60).padStart(2, "0")}`;
 }
 // src/tools/registry.ts
-/** 型推論のためのヘルパー */
+/** 型推論のためのヘルパー。未知の引数は捨てずに拒否する */
 function defineTool(tool) {
-	return tool;
+	return {
+		...tool,
+		inputSchema: tool.inputSchema.strict()
+	};
 }
 /** 権限・バックエンドの機能・読み取り専用モードに応じて、公開するツールを選ぶ（ADR 0004, 0005） */
 function selectTools(tools, options) {
@@ -2649,7 +2711,21 @@ async function staffIndex(ctx) {
 	}
 }
 async function resolveStaffIds(input, ctx) {
-	if (input) return [...new Set(input)];
+	if (input) {
+		const unique = [...new Set(input)];
+		try {
+			const listed = await ctx.backend.listStaff();
+			if (!listed.truncated) {
+				const known = new Set(listed.staff.map((s) => s.staffId));
+				const unknown = unique.filter((id) => !known.has(id));
+				if (unknown.length > 0) throw new ToolInputError(`Unknown staff ID(s): ${unknown.join(", ")}. They are not in the staff you manage. Use list_staff to get valid IDs. Kintai Plus reports an unknown ID as 「従業員IDは必ず入力してください」, which does not mean staffIds was omitted.`);
+			}
+		} catch (error) {
+			if (error instanceof ToolInputError) throw error;
+			ctx.logger.warn(`Could not check staff IDs (${error instanceof Error ? error.name : "error"})`);
+		}
+		return unique;
+	}
 	const ids = (await managedStaff(ctx)).map((s) => s.staffId);
 	if (ids.length > 500) throw new ToolInputError(`You manage ${ids.length} staff; pass staffIds (up to 500) to narrow down.`);
 	return ids;
@@ -2795,11 +2871,12 @@ const getAlertsTool = defineTool({
 	name: "get_alerts",
 	title: "Get my attendance alerts",
 	description: "Get your own attendance alerts (アラート) from Kintai Plus, such as missing punches (打刻忘れ), suspected absence (欠勤疑い), late arrival (遅刻), early leave (早退), overtime threshold (残業時間閾値超え), 36 agreement (36協定), and missing man-hours (工数未入力). Optionally filter by month.",
-	inputSchema: z.object({ month: z.string().regex(/^\d{4}-\d{2}$/, "Use YYYY-MM").optional().describe("Only alerts for this month (YYYY-MM).") }),
+	inputSchema: z.object({ month: monthSchema.optional().describe("Only alerts for this month (YYYY-MM).") }),
 	capability: "alerts.read",
 	audience: "everyone",
 	kind: "read",
 	handler: async (input, ctx) => {
+		if (input.month) assertMonth(input.month);
 		const all = await ctx.backend.getAlerts();
 		const alerts = input.month ? all.filter((a) => (a.month ?? a.date?.slice(0, 7)) === input.month) : all;
 		return {
@@ -2832,15 +2909,21 @@ const isOut = (s) => s.type === "clock_out" || s.type === "direct_out";
 * 日をまたぐ勤務（前日に出勤し、翌日の最初の打刻が退勤）は 1 つの勤務として扱い、打刻漏れにしない。
 * 範囲の初日の朝に終わる夜勤のため、stamps には範囲の前日の分も含めてよい。
 * 休暇・申請は API で見えないため、「労働日に打刻なし」は休暇の可能性を添えて warning にとどめる。
+* 勤務実績に開始・終了（または出勤・退勤の打刻時刻）がある日は、打刻修正などで打刻が欠けていても打刻漏れにしない。
+* 休憩が不明な経過時間は 12 時間超を info にし、1 時間引いても超えるときだけ warning にする。
 */
 function findAttendanceIssues(input) {
 	const issues = [];
-	const add = (date, type, message) => issues.push({
+	const add = (date, type, message, severity = SEVERITY[type]) => issues.push({
 		date,
 		type,
-		severity: SEVERITY[type],
+		severity,
 		message
 	});
+	const reportOpenPunch = (open) => {
+		if (recordHasClockOut(recordByDate.get(open.date))) return;
+		add(open.date, open.type, open.type === "missing_clock_out" ? "退勤の打刻がありません（打刻忘れの可能性）" : "休憩戻の打刻がありません（休憩中のまま）");
+	};
 	const stampsByDate = /* @__PURE__ */ new Map();
 	for (const stamp of [...input.stamps].sort((a, b) => a.stampedAt.getTime() - b.stampedAt.getTime())) {
 		const date = toLocalDate(stamp.stampedAt);
@@ -2858,9 +2941,9 @@ function findAttendanceIssues(input) {
 		const firstInOrOut = stamps.find((s) => isIn(s) || isOut(s));
 		const startsWithOut = firstInOrOut !== void 0 && isOut(firstInOrOut);
 		const overnight = pending?.type === "missing_clock_out" && pending.lastInAt !== void 0 && diffDays(pending.date, date) === 1 && startsWithOut && firstInOrOut.stampedAt.getTime() - pending.lastInAt.getTime() <= MAX_OVERNIGHT_SHIFT_MINUTES * 6e4;
-		if (pending && !overnight) add(pending.date, pending.type, pending.type === "missing_clock_out" ? "退勤の打刻がありません（打刻忘れの可能性）" : "休憩戻の打刻がありません（休憩中のまま）");
+		if (pending && !overnight) reportOpenPunch(pending);
 		pending = void 0;
-		if (startsWithOut && !overnight) add(date, "missing_clock_in", "出勤の打刻がないまま退勤しています");
+		if (startsWithOut && !overnight && !recordHasClockIn(record)) add(date, "missing_clock_in", "出勤の打刻がないまま退勤しています");
 		const status = computeDayStatus(stamps, endOfDay(date));
 		const lastIn = [...stamps].reverse().find(isIn);
 		if (status.state === "working") pending = {
@@ -2873,9 +2956,8 @@ function findAttendanceIssues(input) {
 			type: "missing_break_end"
 		};
 		const minutes = record?.actualWorkingMinutes ?? 0;
-		const worked = record?.workingMinutesAreGross ? "開始から終了までの経過（休憩は不明）" : "実働";
 		if (record?.dayCategory === "workday" && stamps.length === 0 && minutes === 0 && !overnight) add(date, "no_punches_on_workday", "労働日ですが打刻がありません（休暇などの場合は問題ありません）");
-		if (minutes > LONG_DAY_MINUTES) add(date, "long_working_day", `${worked}が ${formatHm(minutes)} で、12 時間を超えています`);
+		if (minutes > LONG_DAY_MINUTES) addLongDay(date, minutes, record?.workingMinutesAreGross === true, add);
 		const firstIn = stamps.find(isIn);
 		if (previousOut && firstIn && diffDays(previousOut.date, date) === 1) {
 			const gap = Math.round((firstIn.stampedAt.getTime() - previousOut.at.getTime()) / 6e4);
@@ -2889,9 +2971,27 @@ function findAttendanceIssues(input) {
 		if (minutes > 0 && record?.dayCategory === "legal_holiday") add(date, "holiday_work", holidayWorkMessage("法定休日", minutes, record.workingMinutesAreGross));
 		else if (minutes > 0 && record?.dayCategory === "scheduled_holiday") add(date, "holiday_work", holidayWorkMessage("所定休日", minutes, record.workingMinutesAreGross));
 	}
-	if (pending) add(pending.date, pending.type, pending.type === "missing_clock_out" ? "退勤の打刻がありません（打刻忘れの可能性）" : "休憩戻の打刻がありません（休憩中のまま）");
+	if (pending) reportOpenPunch(pending);
 	return issues.filter((issue) => issue.date >= input.range.from).sort((a, b) => a.date < b.date ? -1 : a.date > b.date ? 1 : 0);
 }
+function recordHasClockIn(record) {
+	return record?.startTime !== void 0 || record?.clockInAt !== void 0;
+}
+function recordHasClockOut(record) {
+	return record?.endTime !== void 0 || record?.clockOutAt !== void 0;
+}
+function addLongDay(date, minutes, gross, add) {
+	if (!gross) {
+		add(date, "long_working_day", `実働が ${formatHm(minutes)} で、12 時間を超えています`);
+		return;
+	}
+	const elapsed = `開始から終了までの経過が ${formatHm(minutes)}`;
+	if (minutes > 780) {
+		add(date, "long_working_day", `${elapsed} です。1 時間の休憩を差し引いても 12 時間を超えます（実際の休憩時間は不明）`);
+		return;
+	}
+	add(date, "long_working_day", `${elapsed} で 12 時間を超えています。休憩時間が不明なため、実働はこれより短い可能性があります`, "info");
+}
 function holidayWorkMessage(kind, minutes, gross) {
 	const base = `${kind}に ${formatHm(minutes)} 働いています`;
 	return gross ? `${base}（開始から終了までの経過。休憩は不明）` : base;
@@ -2904,7 +3004,7 @@ const MAX_DAYS = 93;
 const checkAttendanceIssuesTool = defineTool({
 	name: "check_attendance_issues",
 	title: "Check my attendance for issues",
-	description: `Check your own punches and working records for issues (打刻漏れチェック): missing clock out/in (退勤・出勤の打刻忘れ), break not ended (休憩戻なし), no punches on a workday, days over 12 hours, rest interval under 11 hours (勤務間インターバル), and holiday work. Defaults to the 1st of this month through yesterday (on the 1st, the previous month). Max ${MAX_DAYS} days. Overnight shifts are recognized. Leave and requests are not visible via the API, so "no punches" may simply be a day off.`,
+	description: `Check your own punches and working records for issues (打刻漏れチェック): missing clock out/in (退勤・出勤の打刻忘れ), break not ended (休憩戻なし), no punches on a workday, days over 12 hours, rest interval under 11 hours (勤務間インターバル), and holiday work. A missing punch is not reported when the working record already has that start or end time (for example after a correction in the web UI). When break time is unknown, elapsed time over 12 hours is info unless it still exceeds 12 hours after a 1-hour break. Defaults to the 1st of this month through yesterday (on the 1st, the previous month). Max ${MAX_DAYS} days. Overnight shifts are recognized. Leave and requests are not visible via the API, so "no punches" may simply be a day off.`,
 	inputSchema: z.object({
 		from: dateSchema.optional().describe("Start date (YYYY-MM-DD)."),
 		to: dateSchema.optional().describe("End date, inclusive (YYYY-MM-DD). Defaults to yesterday.")
@@ -2959,7 +3059,7 @@ const saveManhoursTool = defineTool({
 	description: "Create or update your own man-hours (工数) for one day: minutes per project task. Only the listed tasks are overwritten; other tasks on that day are kept. To remove an entry, use delete_manhours. Use list_projects / get_my_projects and list_tasks to find IDs. Days that are closed (締め) or fixed (確定) cannot be changed.",
 	inputSchema: z.object({
 		date: dateSchema.describe("Date (YYYY-MM-DD)."),
-		entries: z.array(z.object({
+		entries: z.array(z.strictObject({
 			projectId: z.number().int().positive(),
 			taskId: z.number().int().positive(),
 			minutes: z.number().int().min(1).max(DAY_MINUTES).describe("Minutes worked on this task (e.g. 90 = 1.5 hours).")
@@ -3156,7 +3256,7 @@ const findOvertimeRisksTool = defineTool({
 	title: "Find overtime risks in my team",
 	description: "Admin only. For staff you manage, estimate statutory overtime (法定時間外の目安) so far this month and project it to the month end (月末の着地予測), then list who is over or likely to exceed the threshold (default 45 hours, the standard monthly limit under a 36 agreement). Levels: over (already exceeded), likely (projected to exceed), watch (projected ≥ 80%). Always present results as estimates.",
 	inputSchema: z.object({
-		month: z.string().regex(/^\d{4}-\d{2}$/, "Use YYYY-MM").optional().describe("Month (YYYY-MM). Defaults to the current month."),
+		month: monthSchema.optional().describe("Month (YYYY-MM). Defaults to the current month."),
 		staffIds: z.array(z.number().int().positive()).min(1).max(500).optional().describe("Defaults to all staff you manage."),
 		thresholdHours: z.number().int().min(1).max(200).optional().describe("Monthly overtime threshold in hours. Default 45."),
 		includeAll: z.boolean().optional().describe("Include staff with no risk (level ok). Default false.")
@@ -3166,6 +3266,7 @@ const findOvertimeRisksTool = defineTool({
 	kind: "read",
 	handler: async (input, ctx) => {
 		const today = todayInTokyo(ctx.now());
+		if (input.month) assertMonth(input.month);
 		const month = input.month ?? today.slice(0, 7);
 		const monthStart = `${month}-01`;
 		if (monthStart > today) throw new ToolInputError(`${month} has not started yet.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kintai-plus-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Unofficial MCP server for マネーフォワード クラウド勤怠Plus (formerly AKASHI) public API",
   "mcpName": "io.github.atzzCokeK/kintai-plus-mcp",
   "keywords": [
@@ -19,7 +19,7 @@
   },
   "type": "module",
   "bin": {
-    "kintai-plus-mcp": "./dist/cli.mjs"
+    "kintai-plus-mcp": "dist/cli.mjs"
   },
   "files": [
     "dist"