fastctx 0.2.1 → 0.2.2

package/README.md

@@ -4,12 +4,26 @@
 
 FastCtx gives coding agents structured repository tools — `read`, `grep`,
 `glob`, `replace`, and an optional bash terminal — served by one local Rust
-binary over MCP.
+binary over MCP. `read` can pack 1–32 known text files into one request-ordered
+call with exact per-file continuation parameters, while images, PDFs, and hex
+view remain single-file reads.
 
 The optional terminal publishes `run`, `run_background`, `job_output`,
 `job_kill`, and `job_list`. Background jobs have no automatic timeout and
-survive MCP server and Codex restarts; their rolling output and exit status
-remain addressable by job id under `~/.fastctx/jobs/`.
+survive MCP server and Codex restarts. Current-format jobs keep their complete
+output log and exit status addressable by job id under `~/.fastctx/jobs/`.
+`job_output` is a query with a caller-chosen delay: it returns when the job
+ends or when `wait_ms` (0–240000 ms, default 30000) elapses, showing the newest
+output not yet seen, and names the log path and exact line numbers for anything
+it leaves out. Intermediate output does not end the wait. `Complete` appears
+only after a job ends; servers and watchers may never reach it. Records from
+the preceding segmented format remain readable but do not claim direct log
+coordinates or recover output their original rolling window evicted.
+While one server tracks jobs it started or queried, each successful text result
+also carries a one-line background readout of their current state and elapsed
+time. It refreshes only on tool calls; it is not a push notification, and
+nothing arrives if the caller stops. Finished entries remain until that server
+handles them with `job_output` or `job_kill`.
 
 On Windows, all FastCtx-owned non-interactive children run without allocating
 a console window; no caller flag is required. Commands that explicitly launch
@@ -22,7 +36,7 @@ for that user (default 128). `job_list` shows running jobs by default; explicit
 `status="finished"` exposes retained history, while `fastshell.job_list_limit`
 sets the default page size (20, valid range 1–100). All three settings take
 effect immediately when saved.
-Job commands, working directories, rolling output, and exit status stay in the
+Job commands, working directories, output logs, and exit status stay in the
 current user's private local directory and are never uploaded by FastCtx.
 
 grep/glob keeps its existing automatic CPU parallelism by default. The TUI can
@@ -54,11 +68,14 @@ npm install --global fastctx --registry=https://registry.npmjs.org/
 This package is the launcher: it selects the matching scoped platform package
 (`@fastctx/win32-x64`, `@fastctx/linux-x64`, or the corresponding macOS
 package) locally and starts the complete binary. There is no postinstall script
-and no telemetry. The interactive TUI opens immediately while FastCtx checks
-this exact npm package in the background; successful results are cached for 24
-hours in machine-private storage. Transient failures stay quiet and remain
-available under Status. If GitHub is newer while npm is still propagating, the
-UI says so and offers retry. Updates require confirmation, install an exact
+and no telemetry. The interactive TUI checks this exact
+npm package for updates before the main menu opens; the wait is strictly
+bounded, and a failed or timed-out check enters silently. When a newer version
+is installable, the update screen opens directly and asks whether to update or
+continue. Successful results are cached for 24 hours in machine-private
+storage. Transient failures stay quiet and remain available under Status. If
+GitHub is newer while npm is still propagating, the Update screen says so and
+offers retry. Updates require confirmation, install an exact
 version with lifecycle scripts disabled, and restart through a copied helper.
 A failed update restores and reopens the previous version with a warning.
 `fastctx serve` and MCP tool calls do not perform update traffic; commands run

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastctx",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "FastCtx — fast, context-efficient repository tools for AI agents.",
   "author": "yc-duan <dy2958830371@gmail.com>",
   "license": "MIT OR Apache-2.0",
@@ -22,10 +22,10 @@
     "licenses/**"
   ],
   "optionalDependencies": {
-    "@fastctx/win32-x64": "0.2.1",
-    "@fastctx/linux-x64": "0.2.1",
-    "@fastctx/darwin-x64": "0.2.1",
-    "@fastctx/darwin-arm64": "0.2.1"
+    "@fastctx/win32-x64": "0.2.2",
+    "@fastctx/linux-x64": "0.2.2",
+    "@fastctx/darwin-x64": "0.2.2",
+    "@fastctx/darwin-arm64": "0.2.2"
   },
   "publishConfig": {
     "access": "public"