@4fu/arbor-tools 0.1.0 → 2026.1106.1

package/modules/modules.js

@@ -12,6 +12,10 @@ import { isAbsolute, join, normalize, resolve } from "node:path";
 import { formatTime, textOf } from "@4fu/arbor-prompt";
 import { moduleSpec, refused } from "../host.js";
 import { envCommand } from "../env-stage.js";
+/** How many returned items carry a 相关 line of their own. */
+const RELATED_ITEMS = 3;
+/** How many neighbours one 相关 line names before it says there are more. */
+const RELATED_LIMIT = 3;
 /** `journal`: search, show, around, trace, links. */
 export class JournalModuleGroup {
     id = "modules.journal";
@@ -41,12 +45,12 @@ export class JournalModuleGroup {
                 const page = await journal.search(stringArg(args, "query"), {
                     ...(numberArg(args, "limit") === undefined ? {} : { limit: numberArg(args, "limit") }),
                 });
-                return this.answer(request, page.items.map((hit) => `${hit.ref} ${hit.kind} ${hit.summary}`), page);
+                return this.answer(request, page.items.map((hit) => ({ ref: hit.ref, line: `${hit.ref} ${hit.kind} ${hit.summary}` })), page);
             }
             case "journal.show": {
                 const refs = eventRefsArg(args, "ref");
                 const events = await journal.getMany(refs);
-                return this.answer(request, events.map((event) => `${event.ref} ${event.kind} ${bodyOf(event)}`), {
+                return this.answer(request, events.map((event) => ({ ref: event.ref, line: `${event.ref} ${event.kind} ${bodyOf(event)}` })), {
                     items: events,
                     total: events.length,
                     limit: events.length,
@@ -58,7 +62,7 @@ export class JournalModuleGroup {
                     ...(numberArg(args, "before") === undefined ? {} : { before: numberArg(args, "before") }),
                     ...(numberArg(args, "after") === undefined ? {} : { after: numberArg(args, "after") }),
                 });
-                return this.answer(request, events.map((event) => `${event.ref} ${event.kind} ${bodyOf(event)}`), {
+                return this.answer(request, events.map((event) => ({ ref: event.ref, line: `${event.ref} ${event.kind} ${bodyOf(event)}` })), {
                     items: events,
                     total: events.length,
                     limit: events.length,
@@ -67,7 +71,7 @@ export class JournalModuleGroup {
             }
             case "journal.trace": {
                 const node = await journal.trace(refArg(args, "ref"));
-                return this.answer(request, [traceText(node, 0)], {
+                return this.answer(request, [{ ref: node.ref, line: traceText(node, 0) }], {
                     items: [node.ref],
                     total: 1,
                     limit: 1,
@@ -78,21 +82,52 @@ export class JournalModuleGroup {
                 const page = await journal.links(refArg(args, "ref"), {
                     ...(numberArg(args, "offset") === undefined ? {} : { offset: numberArg(args, "offset") }),
                 });
-                return this.answer(request, page.items.map((item) => `${item.ref} ${item.kind} ${item.summary}`), page);
+                // The items are the neighbours already, so this one answer adds no
+                // related line of its own.
+                return this.answer(request, page.items.map((item) => ({ ref: item.ref, line: `${item.ref} ${item.kind} ${item.summary}` })), page, false);
             }
             default:
                 return this.notOwned(request);
         }
     }
-    answer(request, lines, page) {
+    /**
+     * One answer: the items, then one 相关 line per returned item for the first
+     * three of them, then the total and the call that pages the rest
+     * (docs/prompting.md#information-density).
+     */
+    async answer(request, items, page, related = true) {
         const table = this.services.table;
+        const lines = items.map((item) => item.line);
         const body = lines.length === 0 ? textOf(table, "result.search.empty") : lines.join("\n");
         return {
             callId: request.callId,
             ok: true,
-            content: `${body}\n${textOf(table, "result.search.total", { total: page.total })}\n${page.nextCall}`,
+            content: [
+                body,
+                ...(related ? await this.related(items) : []),
+                textOf(table, "result.search.total", { total: page.total }),
+                page.nextCall,
+            ].join("\n"),
         };
     }
+    /** One 相关 line per item, for the first three: no line without neighbours. */
+    async related(items) {
+        const table = this.services.table;
+        const lines = [];
+        for (const item of items.slice(0, RELATED_ITEMS)) {
+            const page = await this.services.journal.links(item.ref, { limit: RELATED_LIMIT });
+            if (page.items.length === 0)
+                continue;
+            const more = page.total > page.items.length
+                ? textOf(table, "result.journal.related.more", { total: page.total, offset: page.items.length })
+                : "";
+            lines.push(textOf(table, "result.journal.related", {
+                refs: page.items.map((one) => one.ref).join("、"),
+                more,
+            }));
+        }
+        return lines;
+    }
     notOwned(request) {
         return {
             callId: request.callId,
@@ -696,14 +731,24 @@ export class ScheduleModuleGroup {
             content: textOf(table, "result.schedule.updated", { ref }),
         };
     }
-    /** One repeat rule as one line: only once, a period, or a daily clock time. */
+    /** One repeat rule as one line: only once, a period, a daily or a weekly time. */
     repeatText(repeat) {
         const table = this.services.table;
         if (repeat === undefined)
             return textOf(table, "result.schedule.once");
-        return "everyMs" in repeat
+        const base = "everyMs" in repeat
             ? textOf(table, "result.schedule.every_ms", { ms: repeat.everyMs })
-            : textOf(table, "result.schedule.daily", { time: repeat.dailyAt });
+            : "weekdays" in repeat
+                ? textOf(table, "result.schedule.weekly", {
+                    weekdays: [...repeat.weekdays].sort().join("、"),
+                    time: repeat.at,
+                })
+                : textOf(table, "result.schedule.daily", { time: repeat.dailyAt });
+        const bounds = [
+            ...(repeat.times === undefined ? [] : [textOf(table, "result.schedule.times", { count: repeat.times })]),
+            ...(repeat.until === undefined ? [] : [textOf(table, "result.schedule.until", { time: formatTime(repeat.until) })]),
+        ];
+        return `${base}${bounds.join("")}`;
     }
     /** One argument the script did not name in a shape this module can read. */
     badInput(field) {
@@ -974,7 +1019,9 @@ function taskRefArg(args, name) {
 }
 /**
  * One repeat rule, `invalid` when the argument is not one this module can read:
- * a period in milliseconds, or a clock time a firing repeats at daily.
+ * a period in milliseconds, a clock time a firing repeats at daily, or days of
+ * the week with the clock time it fires at on them. `times` and `until` bound
+ * any of the three.
  */
 function repeatArg(args) {
     const value = args.repeat;
@@ -983,11 +1030,20 @@ function repeatArg(args) {
     if (typeof value !== "object" || value === null)
         return "invalid";
     const repeat = value;
+    const times = typeof repeat.times === "number" && Number.isFinite(repeat.times) && repeat.times >= 0 ? Math.floor(repeat.times) : undefined;
+    const until = typeof repeat.until === "number" && Number.isFinite(repeat.until) ? Math.floor(repeat.until) : undefined;
+    const bounds = { ...(times === undefined ? {} : { times }), ...(until === undefined ? {} : { until }) };
     if (typeof repeat.everyMs === "number" && Number.isFinite(repeat.everyMs) && repeat.everyMs > 0) {
-        return { everyMs: repeat.everyMs };
+        return { everyMs: repeat.everyMs, ...bounds };
     }
     if (typeof repeat.dailyAt === "string" && /^\d{1,2}:\d{2}$/u.test(repeat.dailyAt.trim())) {
-        return { dailyAt: repeat.dailyAt.trim() };
+        return { dailyAt: repeat.dailyAt.trim(), ...bounds };
+    }
+    if (Array.isArray(repeat.weekdays) && typeof repeat.at === "string" && /^\d{1,2}:\d{2}$/u.test(repeat.at.trim())) {
+        const weekdays = repeat.weekdays.filter((day) => typeof day === "number" && Number.isInteger(day) && day >= 0 && day <= 6);
+        if (weekdays.length === 0)
+            return "invalid";
+        return { weekdays, at: repeat.at.trim(), ...bounds };
     }
     return "invalid";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4fu/arbor-tools",
-  "version": "0.1.0",
+  "version": "2026.1106.1",
   "type": "module",
   "description": "The entry points: direct tools, code mode modules and the one tool catalog that routes both through the service layer.",
   "exports": {
@@ -16,6 +16,8 @@
     "bound.js",
     "catalog.d.ts",
     "catalog.js",
+    "child-env.d.ts",
+    "child-env.js",
     "code-exec.d.ts",
     "code-exec.js",
     "env-stage.d.ts",
@@ -24,6 +26,8 @@
     "groups/core.js",
     "groups/env.d.ts",
     "groups/env.js",
+    "groups/external.d.ts",
+    "groups/external.js",
     "groups/files.d.ts",
     "groups/files.js",
     "groups/notes.d.ts",
@@ -50,8 +54,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@4fu/arbor-errors": "0.1.0",
-    "@4fu/arbor-interfaces": "0.1.0",
-    "@4fu/arbor-prompt": "0.1.0"
+    "@4fu/arbor-errors": "2026.1106.1",
+    "@4fu/arbor-interfaces": "2026.1106.1",
+    "@4fu/arbor-prompt": "2026.1106.1"
   }
 }