@sayknow-cli/coding-agent 0.3.6 → 0.3.8

package/src/hooks/skill-state.ts

@@ -12,8 +12,7 @@ import {
 	writeGuardedJsonAtomic,
 	writeGuardedWorkflowEnvelopeAtomic,
 } from "../skc-runtime/state-writer";
-import { isUltragoalBypassPrompt, readUltragoalVerificationState } from "../skc-runtime/ultragoal-guard";
-import { getUltragoalRunCompletionState, readUltragoalPlan } from "../skc-runtime/ultragoal-runtime";
+import { isUltragoalBypassPrompt, verifyUltragoalDurableCompletionState } from "../skc-runtime/ultragoal-guard";
 import {
 	readVisibleSkillActiveState as readCanonicalVisibleSkillActiveState,
 	type SkillActiveEntry,
@@ -565,6 +564,10 @@ function modeStateReleasesStop(state: ModeState | null, handoffRequired: boolean
 	return false;
 }
 
+function ultragoalDurableCompletionReleasesStop(state: string): boolean {
+	return state === "inactive" || state === "active_verified_complete";
+}
+
 /**
  * Cross-file coherence guard for a mode-state that claims it releases the Stop
  * block. `modeStateReleasesStop` trusts a single mode-state file; if any writer
@@ -577,18 +580,15 @@ function modeStateReleasesStop(state: ModeState | null, handoffRequired: boolean
  * cheap and read-only — ultragoal reads the durable plan; skills without an
  * independent durable source release as before.
  */
-async function detectStaleModeStateRelease(skill: SkcWorkflowSkill, cwd: string): Promise<string | null> {
-	if (skill === "ultragoal") {
-		const plan = await readUltragoalPlan(cwd);
-		if (!plan) return null;
-		const runState = getUltragoalRunCompletionState(plan);
-		if (runState.incompleteGoals.length > 0) {
-			return `the durable Ultragoal plan still has incomplete required goals (${runState.incompleteGoals
-				.map(goal => goal.id)
-				.join(", ")}); run \`skc ultragoal complete-goals\` to continue`;
-		}
-	}
-	return null;
+async function detectStaleModeStateRelease(
+	skill: SkcWorkflowSkill,
+	cwd: string,
+	sessionId?: string | null,
+): Promise<string | null> {
+	if (skill !== "ultragoal") return null;
+	const diagnostic = await verifyUltragoalDurableCompletionState({ cwd, sessionId });
+	if (ultragoalDurableCompletionReleasesStop(diagnostic.state)) return null;
+	return `${diagnostic.message} Run \`skc ultragoal complete-goals\` to continue, or checkpoint a finished story with \`skc ultragoal checkpoint --status complete --quality-gate-json <file>\`, before stopping`;
 }
 
 /**
@@ -663,19 +663,6 @@ function stateMatchesContext(state: ModeState, sessionId?: string, threadId?: st
 	return true;
 }
 
-async function readCurrentGoalObjectiveFromSessionFile(sessionFile: string | undefined): Promise<string | null> {
-	const trimmed = sessionFile?.trim();
-	if (!trimmed) return null;
-	const entries = (await loadEntriesFromFile(trimmed)).filter(
-		(entry): entry is SessionEntry => entry.type !== "session",
-	);
-	const context = buildSessionContext(entries);
-	const goal = context.modeData?.goal;
-	if (typeof goal !== "object" || goal === null) return null;
-	const objective = (goal as { objective?: unknown }).objective;
-	return typeof objective === "string" && objective.trim().length > 0 ? objective.trim() : null;
-}
-
 async function readLatestAssistantTextFromSessionFile(sessionFile: string | undefined): Promise<string | null> {
 	const trimmed = sessionFile?.trim();
 	if (!trimmed) return null;
@@ -730,34 +717,18 @@ export async function buildActiveUltragoalPromptContext(input: UserPromptSubmitS
 	if (!stateMatchesContext(visibleModeState.state, resolvedSessionId, input.threadId)) return null;
 
 	const phase = String(visibleModeState.state.current_phase ?? "active");
-	const stateObjective =
-		typeof visibleModeState.state.objective === "string"
-			? visibleModeState.state.objective
-			: typeof visibleModeState.state.skcObjective === "string"
-				? visibleModeState.state.skcObjective
-				: "";
-	const sessionObjective = await readCurrentGoalObjectiveFromSessionFile(input.sessionFile);
 	const normalizedPrompt = input.prompt?.replace(/\\?"/g, '"');
 	const isBypassPrompt = Boolean(
 		(normalizedPrompt && isUltragoalBypassPrompt(normalizedPrompt)) ||
 			(input.prompt && /goal[\s\S]{0,80}complete/i.test(input.prompt)),
 	);
 	if (isBypassPrompt) {
-		const objectives = [sessionObjective, stateObjective].filter(
-			(value): value is string => typeof value === "string" && value.trim().length > 0,
-		);
-		if (objectives.length === 0) {
-			return "BLOCK_ULTRAGOAL_COMPLETION: Active Ultragoal completion is blocked until a current SKC goal objective can be verified. Use durable blocker work or run strict `skc ultragoal checkpoint --status complete --quality-gate-json <file> --skc-goal-json <file>` before completion.";
-		}
-		for (const objective of objectives) {
-			const diagnostic = await readUltragoalVerificationState({
-				cwd: input.cwd,
-				currentGoal: { objective },
-			});
-			if (diagnostic.state === "unrelated_goal") continue;
-			if (!["inactive", "active_verified_complete"].includes(diagnostic.state)) {
-				return `BLOCK_ULTRAGOAL_COMPLETION: ${diagnostic.message} Use durable blocker work or run strict \`skc ultragoal checkpoint --status complete --quality-gate-json <file> --skc-goal-json <file>\` before completion.`;
-			}
+		const diagnostic = await verifyUltragoalDurableCompletionState({
+			cwd: input.cwd,
+			sessionId: resolvedSessionId,
+		});
+		if (!ultragoalDurableCompletionReleasesStop(diagnostic.state)) {
+			return `BLOCK_ULTRAGOAL_COMPLETION: ${diagnostic.message} Use durable blocker work or run strict \`skc ultragoal checkpoint --status complete --quality-gate-json <file>\` before completion.`;
 		}
 	}
 	return `Ultragoal is active (phase: ${phase}; state: ${visibleModeState.statePath}). If the user prompt is a steering request, use \`skc ultragoal steer\` to add or steer subgoals. Normal prose should not mutate Ultragoal state.`;
@@ -818,7 +789,7 @@ export async function buildSkillStopOutput(input: StopHookInput): Promise<Record
 			// authoritative durable state. If a stale/incoherent mode-state would
 			// release while the plan/ledger still shows pending work, block instead
 			// of trusting the single file (see #659).
-			const staleRelease = await detectStaleModeStateRelease(entry.skill, input.cwd);
+			const staleRelease = await detectStaleModeStateRelease(entry.skill, input.cwd, resolvedSessionId);
 			if (staleRelease) {
 				const coherenceMessage = `SKC skill "${entry.skill}" mode-state reports it released the Stop block (${modeStatePath(input.cwd, entry.skill, resolvedSessionId)}), but ${staleRelease}. The mode-state is incoherent with authoritative durable state; finish or explicitly clear the pending work before stopping.`;
 				return {
@@ -847,29 +818,18 @@ export async function buildSkillStopOutput(input: StopHookInput): Promise<Record
 		const phase = String(modeState?.current_phase ?? entry.phase ?? skillState.phase ?? "active");
 		const statePath = modeStatePath(input.cwd, entry.skill, resolvedSessionId);
 		if (entry.skill === "ultragoal") {
-			const objective =
-				(await readCurrentGoalObjectiveFromSessionFile(input.sessionFile)) ??
-				(typeof modeState?.objective === "string"
-					? modeState.objective
-					: typeof modeState?.skcObjective === "string"
-						? modeState.skcObjective
-						: "");
-			if (objective) {
-				const diagnostic = await readUltragoalVerificationState({
-					cwd: input.cwd,
-					currentGoal: { objective },
-				});
-				if (diagnostic.state === "active_verified_complete") continue;
-				if (!["inactive", "unrelated_goal"].includes(diagnostic.state)) {
-					const ultragoalMessage = `SKC ultragoal verification is blocking stop: ${diagnostic.message} Run strict checkpoint verification or record review blockers before stopping.`;
-					return {
-						decision: "block",
-						reason: ultragoalMessage,
-						stopReason: `skc_ultragoal_verification_${diagnostic.state}`,
-						systemMessage: ultragoalMessage,
-					};
-				}
-			}
+			const diagnostic = await verifyUltragoalDurableCompletionState({
+				cwd: input.cwd,
+				sessionId: resolvedSessionId,
+			});
+			if (ultragoalDurableCompletionReleasesStop(diagnostic.state)) continue;
+			const ultragoalMessage = `SKC ultragoal verification is blocking stop: ${diagnostic.message} Run \`skc ultragoal checkpoint --status complete --quality-gate-json <file>\` or record review blockers before stopping.`;
+			return {
+				decision: "block",
+				reason: ultragoalMessage,
+				stopReason: `skc_ultragoal_verification_${diagnostic.state}`,
+				systemMessage: ultragoalMessage,
+			};
 		}
 		const systemMessage = handoffRequired
 			? buildHandoffForceAskMessage(entry.skill, phase, statePath)

package/src/i18n/messages/de.ts

@@ -36,6 +36,7 @@ export const de: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "Werkzeuge",
 	"settings.tab.tasks": "Aufgaben",
 	"settings.tab.providers": "Anbieter",
+	"settings.tab.integrations": "Integrationen",
 	"settings.language.label": "Sprache",
 	"settings.language.desc": "Sprache der Oberfläche. Automatisch folgt der Systemsprache.",
 	"help.usage": "VERWENDUNG",

package/src/i18n/messages/en.ts

@@ -43,6 +43,7 @@ export const en = {
 	"settings.tab.tools": "Tools",
 	"settings.tab.tasks": "Tasks",
 	"settings.tab.providers": "Providers",
+	"settings.tab.integrations": "Integrations",
 
 	// ── Language setting ──
 	"settings.language.label": "Language",

package/src/i18n/messages/es.ts

@@ -36,6 +36,7 @@ export const es: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "Herramientas",
 	"settings.tab.tasks": "Tareas",
 	"settings.tab.providers": "Proveedores",
+	"settings.tab.integrations": "Integraciones",
 	"settings.language.label": "Idioma",
 	"settings.language.desc": "Idioma de la interfaz. Automático sigue la configuración regional del sistema.",
 	"help.usage": "USO",

package/src/i18n/messages/fr.ts

@@ -36,6 +36,7 @@ export const fr: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "Outils",
 	"settings.tab.tasks": "Tâches",
 	"settings.tab.providers": "Fournisseurs",
+	"settings.tab.integrations": "Intégrations",
 	"settings.language.label": "Langue",
 	"settings.language.desc": "Langue de l'interface. Auto suit les paramètres régionaux du système.",
 	"help.usage": "UTILISATION",

package/src/i18n/messages/ja.settings.ts

@@ -806,4 +806,32 @@ export const jaSettings: Record<string, string> = {
 	"cmd:move:d": "セッションを別の作業ディレクトリに移動",
 	"cmd:exit:d": "アプリケーションを終了",
 	"set:edit.fuzzyThreshold:d": "あいまい一致の類似度しきい値",
+	"set:telegram.enabled:l": "Telegramリモート",
+	"set:telegram.enabled:d": "skcセッションを双方向Telegramボットで制御",
+	"set:telegram.botToken:l": "ボットトークン",
+	"set:telegram.botToken:d": "@BotFatherから取得したTelegramボットトークン（有効化時に必須）",
+	"set:telegram.allowedUserIds:l": "許可されたユーザーID",
+	"set:telegram.allowedUserIds:d": "コマンドを送信できるTelegramユーザーID（カンマ区切り）",
+	"set:telegram.allowedChatIds:l": "許可されたチャットID",
+	"set:telegram.allowedChatIds:d": "コマンドを送信できるTelegramチャットID（カンマ区切り）",
+	"set:telegram.backend:l": "バックエンド",
+	"set:telegram.backend:d": "コーディネーター（マルチセッション）またはRPC（単一永続セッション）",
+	"set:telegram.backend:o:coordinator:l": "コーディネーター",
+	"set:telegram.backend:o:coordinator:d": "マルチセッションライフサイクル + 監視",
+	"set:telegram.backend:o:rpc:l": "RPC",
+	"set:telegram.backend:o:rpc:d": "単一永続セッションソケットにアタッチ/デタッチ",
+	"set:telegram.enableStop:l": "/stopを有効化",
+	"set:telegram.enableStop:d": "停止リクエストを許可（reportsミューテーションクラスを追加）",
+	"set:telegram.enableRich:l": "リッチメッセージ",
+	"set:telegram.enableRich:d": "HTMLフォーマット + インラインキーボード",
+	"set:telegram.enablePush:l": "プッシュ通知",
+	"set:telegram.enablePush:d": "コーディネーターイベント監視によるフォロー/ミュート購読",
+	"set:telegram.registerCommands:l": "ボットメニュー登録",
+	"set:telegram.registerCommands:d": "起動時にボットコマンドメニューを登録",
+	"set:telegram.presets:l": "セッションプリセット",
+	"set:telegram.presets:d": "{id, workdir, sessionCommand, taskTemplate?, taskMaxLen?} JSON配列",
+	"set:telegram.rpcSocket:l": "RPCソケット",
+	"set:telegram.rpcSocket:d": "skc launch --output rpc UNIXソケットパス（RPCバックエンド専用）",
+	"set:telegram.stateDir:l": "状態ディレクトリ",
+	"set:telegram.stateDir:d": "再接続/再同期用ゲートウェイ状態ディレクトリ（RPCバックエンド必須）",
 };

package/src/i18n/messages/ja.ts

@@ -34,6 +34,7 @@ export const ja: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "ツール",
 	"settings.tab.tasks": "タスク",
 	"settings.tab.providers": "プロバイダー",
+	"settings.tab.integrations": "統合",
 
 	"settings.language.label": "言語",
 	"settings.language.desc": "インターフェース言語。自動はシステムのロケールに従います。",

package/src/i18n/messages/ko.settings.ts

@@ -795,4 +795,32 @@ export const koSettings: Record<string, string> = {
 	"cmd:move:d": "세션을 다른 작업 디렉터리로 이동",
 	"cmd:exit:d": "애플리케이션 종료",
 	"set:edit.fuzzyThreshold:d": "퍼지 매칭의 유사도 임계값",
+	"set:telegram.enabled:l": "텔레그램 리모트",
+	"set:telegram.enabled:d": "skc 세션을 양방향 텔레그램 봇으로 제어",
+	"set:telegram.botToken:l": "봇 토큰",
+	"set:telegram.botToken:d": "@BotFather에서 받은 텔레그램 봇 토큰 (활성화 시 필수)",
+	"set:telegram.allowedUserIds:l": "허용된 사용자 ID",
+	"set:telegram.allowedUserIds:d": "명령을 보낼 수 있는 텔레그램 사용자 ID (쉼표 구분)",
+	"set:telegram.allowedChatIds:l": "허용된 채팅 ID",
+	"set:telegram.allowedChatIds:d": "명령을 보낼 수 있는 텔레그램 채팅 ID (쉼표 구분)",
+	"set:telegram.backend:l": "백엔드",
+	"set:telegram.backend:d": "코디네이터 (다중 세션 수명주기) 또는 RPC (단일 영구 세션)",
+	"set:telegram.backend:o:coordinator:l": "코디네이터",
+	"set:telegram.backend:o:coordinator:d": "다중 세션 수명주기 + 관찰",
+	"set:telegram.backend:o:rpc:l": "RPC",
+	"set:telegram.backend:o:rpc:d": "단일 영구 세션 소켓에 연결/분리",
+	"set:telegram.enableStop:l": "/stop 활성화",
+	"set:telegram.enableStop:d": "정지 요청 허용 (reports 변경 클래스 추가)",
+	"set:telegram.enableRich:l": "리치 메시지",
+	"set:telegram.enableRich:d": "HTML 포맷팅 + 인라인 키보드",
+	"set:telegram.enablePush:l": "푸시 알림",
+	"set:telegram.enablePush:d": "코디네이터 이벤트 감시를 통한 팔로우/뮤트 구독",
+	"set:telegram.registerCommands:l": "봇 메뉴 등록",
+	"set:telegram.registerCommands:d": "시작 시 봇 명령 메뉴 등록",
+	"set:telegram.presets:l": "세션 프리셋",
+	"set:telegram.presets:d": "{id, workdir, sessionCommand, taskTemplate?, taskMaxLen?} JSON 배열",
+	"set:telegram.rpcSocket:l": "RPC 소켓",
+	"set:telegram.rpcSocket:d": "skc launch --output rpc UNIX 소켓 경로 (RPC 백엔드 전용)",
+	"set:telegram.stateDir:l": "상태 디렉터리",
+	"set:telegram.stateDir:d": "재연결/동기화용 게이트웨이 상태 디렉터리 (RPC 백엔드 필수)",
 };

package/src/i18n/messages/ko.ts

@@ -34,6 +34,7 @@ export const ko: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "도구",
 	"settings.tab.tasks": "작업",
 	"settings.tab.providers": "공급자",
+	"settings.tab.integrations": "연동",
 
 	"settings.language.label": "언어",
 	"settings.language.desc": "인터페이스 언어. 자동은 시스템 로케일을 따릅니다.",

package/src/i18n/messages/zh.settings.ts

@@ -776,4 +776,32 @@ export const zhSettings: Record<string, string> = {
 	"cmd:move:d": "将会话移动到其他工作目录",
 	"cmd:exit:d": "退出应用程序",
 	"set:edit.fuzzyThreshold:d": "模糊匹配的相似度阈值",
+	"set:telegram.enabled:l": "Telegram远程",
+	"set:telegram.enabled:d": "通过双向Telegram机器人控制skc会话",
+	"set:telegram.botToken:l": "机器人令牌",
+	"set:telegram.botToken:d": "从@BotFather获取的Telegram机器人令牌（启用时必填）",
+	"set:telegram.allowedUserIds:l": "允许的用户ID",
+	"set:telegram.allowedUserIds:d": "可发送命令的Telegram用户ID（逗号分隔）",
+	"set:telegram.allowedChatIds:l": "允许的聊天ID",
+	"set:telegram.allowedChatIds:d": "可发送命令的Telegram聊天ID（逗号分隔）",
+	"set:telegram.backend:l": "后端",
+	"set:telegram.backend:d": "协调器（多会话生命周期）或RPC（单个持久会话）",
+	"set:telegram.backend:o:coordinator:l": "协调器",
+	"set:telegram.backend:o:coordinator:d": "多会话生命周期 + 观察",
+	"set:telegram.backend:o:rpc:l": "RPC",
+	"set:telegram.backend:o:rpc:d": "连接/断开单个持久会话套接字",
+	"set:telegram.enableStop:l": "启用/stop",
+	"set:telegram.enableStop:d": "允许停止请求（添加reports变更类）",
+	"set:telegram.enableRich:l": "富文本消息",
+	"set:telegram.enableRich:d": "HTML格式 + 内联键盘",
+	"set:telegram.enablePush:l": "推送通知",
+	"set:telegram.enablePush:d": "通过协调器事件监视的关注/静音订阅",
+	"set:telegram.registerCommands:l": "注册机器人菜单",
+	"set:telegram.registerCommands:d": "启动时注册机器人命令菜单",
+	"set:telegram.presets:l": "会话预设",
+	"set:telegram.presets:d": "{id, workdir, sessionCommand, taskTemplate?, taskMaxLen?} JSON数组",
+	"set:telegram.rpcSocket:l": "RPC套接字",
+	"set:telegram.rpcSocket:d": "skc launch --output rpc UNIX套接字路径（仅RPC后端）",
+	"set:telegram.stateDir:l": "状态目录",
+	"set:telegram.stateDir:d": "用于重连/重同步的网关状态目录（RPC后端必填）",
 };

package/src/i18n/messages/zh.ts

@@ -34,6 +34,7 @@ export const zh: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "工具",
 	"settings.tab.tasks": "任务",
 	"settings.tab.providers": "提供商",
+	"settings.tab.integrations": "集成",
 
 	"settings.language.label": "语言",
 	"settings.language.desc": "界面语言。自动模式跟随系统区域设置。",