@akira-tl/forgerelay 0.8.3 → 0.8.4

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable ForgeRelay changes are documented here.
 
 ## [Unreleased]
 
+## [0.8.4] - 2026-08-31
+
+### Added
+
+- Added `open_workspace(action="inspect", workspaceId=...)` for bounded read-only Workspace metadata, including safe Task summaries without opening, rebinding, or exposing bootstrap/remote-auth details.
+
+### Changed
+
+- `workspace.tasks` now discloses Task state progressively from List summaries to headers and one Task detail, with configurable forgotten-update reminders after meaningful Workspace work.
+
 ## [0.8.3] - 2026-08-31
 
 ### Added

package/capabilities/workspace-tasks/GUIDE.md

@@ -10,9 +10,19 @@
 - Task 状态只有 `pending`、`in_progress`、`completed`。`content` 保存继续工作真正需要的要求、阻塞点、结论或下一步，而不是日志或对话转录。
 - Task/List ID 创建后保持稳定。完成 Task 不会删除它；删除必须显式执行。
 
-## 操作
+## 渐进式读取
 
-先用 `operation="get"` 读取当前 Task state。
+Task 读取默认使用渐进式披露，不会一次返回所有 `content`：
+
+- `operation="get"` 或 `level="summary"`：返回 List identity、状态、revision、Task 数量和未完成数量，不返回 Task headers/body。
+- `operation="get", level="headers"`：返回 Task `id`、`status`、`subject`，不返回 `content`；可传 `listId` 只看一个 List。
+- `operation="get", level="detail", listId=..., taskId=...`：只返回指定 Task 的完整 `content`。
+
+先从 summary 定位 List，再按需读取 headers/detail；不要把所有 Task body 当作默认上下文。
+
+## 修改操作
+
+修改响应同样保持有界：List 修改返回 summary；Task 修改返回对应 List 的 headers，不会顺带回传所有 Task body。
 
 List 操作：
 
@@ -27,3 +37,14 @@ Task 操作：
 - `task.delete`：显式删除 Task。
 
 Task 修改使用独立的 revision/fingerprint 域；它不改变 Workspace bootstrap `contextFingerprint`。
+
+## 忘记更新提醒
+
+ForgeRelay 会按当前 Workspace 统计成功的语义工作调用。默认连续 30 次语义工作没有 Task mutation、且仍存在 active List 中的未完成 Task 时，在工作结果后追加一条简短提醒；提醒只提示检查 `workspace.tasks`，不会携带 Task `content`。
+
+- 任意 List/Task create/update/delete 都会重置计数。
+- `open_workspace` inventory/open/close、Activity/UI 查询、Capability describe、Task get，以及 `bash action="process"|"output"` / Codex `write_stdin` 等已有进程 follow-up 不单独计数。
+- `batch.execute` 作为一次顶层语义工作调用计数，而不是按 child operation 重复计数。
+- 只有 active List 中仍有 `pending` / `in_progress` Task 才会提醒；归档 List 或全部完成会 suppress 提醒。
+- 计数器只保存在当前 ForgeRelay 进程内，server restart 可以重置；Task durable state 本身不受影响。
+- `FORGERELAY_TASK_REMINDER_INTERVAL=0` 可禁用提醒；其他非负整数设置间隔。

package/dist/capability-registry.js

@@ -133,7 +133,21 @@ export function createCapabilityRegistry(dependencies) {
     const workspaceTaskStatus = z.enum(["pending", "in_progress", "completed"]);
     const workspaceTaskListState = z.enum(["active", "archived"]);
     const workspaceTasksInput = z.union([
-        z.object({ operation: z.literal("get") }).strict(),
+        z.object({
+            operation: z.literal("get"),
+            level: z.literal("summary").optional(),
+        }).strict(),
+        z.object({
+            operation: z.literal("get"),
+            level: z.literal("headers"),
+            listId: z.string().min(1).optional(),
+        }).strict(),
+        z.object({
+            operation: z.literal("get"),
+            level: z.literal("detail"),
+            listId: z.string().min(1),
+            taskId: z.string().min(1),
+        }).strict(),
         z.object({
             operation: z.literal("list.create"),
             name: z.string().trim().min(1),

package/dist/config.js

@@ -7,6 +7,7 @@ import { forgerelayAgentsDir, forgerelaySkillsDir, generateInstanceId, loadForge
 const DEFAULT_OAUTH_ACCESS_TOKEN_TTL_SECONDS = 60 * 60;
 const DEFAULT_OAUTH_REFRESH_TOKEN_TTL_SECONDS = 30 * 24 * 60 * 60;
 const DEFAULT_ARTIFACT_MAX_FILE_BYTES = 100 * 1024 * 1024;
+const DEFAULT_TASK_REMINDER_INTERVAL = 30;
 function parsePort(value) {
     if (value === undefined || value === "")
         return 7676;
@@ -109,6 +110,15 @@ function parsePositiveInteger(value, fallback, name, max = Number.MAX_SAFE_INTEG
     }
     return parsed;
 }
+function parseNonNegativeInteger(value, fallback, name) {
+    if (value === undefined || value === "")
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0 || parsed > Number.MAX_SAFE_INTEGER) {
+        throw new Error(`Invalid ${name}: ${value}`);
+    }
+    return parsed;
+}
 function parseLoggingConfig(env, trustProxyDefault) {
     const format = parseLogFormat(productEnv(env, "LOG_FORMAT"));
     const requests = productEnv(env, "LOG_REQUESTS");
@@ -247,6 +257,7 @@ export function loadConfig(env = process.env) {
             ? files.config.artifactsEnabled === true
             : parseBoolean(productEnv(env, "ARTIFACTS")),
         artifactMaxFileBytes: parsePositiveInteger(productEnv(env, "ARTIFACT_MAX_FILE_BYTES") ?? numberConfigValue(files.config.artifactMaxFileBytes), DEFAULT_ARTIFACT_MAX_FILE_BYTES, "FORGERELAY_ARTIFACT_MAX_FILE_BYTES"),
+        taskReminderInterval: parseNonNegativeInteger(productEnv(env, "TASK_REMINDER_INTERVAL") ?? numberConfigValue(files.config.taskReminderInterval), DEFAULT_TASK_REMINDER_INTERVAL, "FORGERELAY_TASK_REMINDER_INTERVAL"),
         skillsEnabled: productEnv(env, "SKILLS") === undefined ? true : parseBoolean(productEnv(env, "SKILLS")),
         skillPaths: parsePathList(productEnv(env, "SKILL_PATHS")),
         devspaceSkillsDir: forgerelaySkillsDir(env),

package/dist/remote-workspace-relay.js

@@ -27,6 +27,21 @@ export class RemoteWorkspaceRelay {
         this.loadRoutes();
         return this.routes.has(workspaceId);
     }
+    inspectWorkspace(gatewayWorkspaceId) {
+        const route = this.requireRoute(gatewayWorkspaceId);
+        const resolved = this.remoteByInstance(route.remoteInstanceId);
+        return {
+            workspaceId: route.gatewayWorkspaceId,
+            kind: "workspace",
+            location: "relay",
+            root: route.root,
+            routeState: "known",
+            mode: route.mode,
+            ...(route.sourceRoot ? { sourceRoot: route.sourceRoot } : {}),
+            relay: resolved.alias,
+            executionLocation: `remote:${resolved.alias}`,
+        };
+    }
     async openWorkspace(alias, input, conversationScopeId) {
         const resolved = this.remoteByAlias(alias);
         let result;