@viccydev/pi-fpa 0.9.3 → 0.9.4

package/README.md

@@ -159,12 +159,12 @@ pi list
 团队分发建议使用固定 Git tag：
 
 ```bash
-pi install git:github.com/linyqh/pi-fpa@v0.9.3
+pi install git:github.com/linyqh/pi-fpa@v0.9.4
 ```
 
 ## 发布到 npm
 
-发布动作由 GitHub Release 触发。Release 标签必须严格使用 `v<package.json version>`，例如版本 `0.9.3` 对应 `v0.9.3`。工作流会检出该标签，执行 `npm ci`、`npm test` 和包内容预检，全部通过后发布公开包 `@viccydev/pi-fpa`。普通 Release 发布到 `latest`，Prerelease 发布到 `next`。
+发布动作由 GitHub Release 触发。Release 标签必须严格使用 `v<package.json version>`，例如版本 `0.9.4` 对应 `v0.9.4`。工作流会检出该标签，执行 `npm ci`、`npm test` 和包内容预检，全部通过后发布公开包 `@viccydev/pi-fpa`。普通 Release 发布到 `latest`，Prerelease 发布到 `next`。
 
 发布认证使用 npm Trusted Publishing / OIDC，不使用长期 npm Token。npm 包后台的 Trusted Publisher 配置为：
 

package/bin/fpa-dashboard-worker.mjs

@@ -76,12 +76,34 @@ if (args.includes("--once")) {
     if (!abortController.signal.aborted) throw error;
   }
 } else {
+  // A failure that persists — a missing ledger, an artifact a subscription
+  // still references — repeats on every tick. Reprinting its stack every
+  // interval buries everything else in the log without adding information, so
+  // an unchanged failure is reported once in full and then only counted.
+  let lastFailure = null;
+  let repeatCount = 0;
   while (!stopping) {
     try {
 	  await runOnce();
+	  if (lastFailure) {
+		process.stderr.write(`${new Date().toISOString()} recovered after ${repeatCount + 1} consecutive failure(s)\n`);
+		lastFailure = null;
+		repeatCount = 0;
+	  }
     } catch (error) {
 	  if (abortController.signal.aborted) break;
-	  process.stderr.write(`${new Date().toISOString()} ${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+	  const message = error instanceof Error ? error.message : String(error);
+	  if (message === lastFailure) {
+		repeatCount += 1;
+		// Back off the log, not the work: still retried every interval.
+		if (repeatCount === 1 || repeatCount % 20 === 0) {
+		  process.stderr.write(`${new Date().toISOString()} still failing (${repeatCount + 1}x): ${message}\n`);
+		}
+	  } else {
+		lastFailure = message;
+		repeatCount = 0;
+		process.stderr.write(`${new Date().toISOString()} ${error instanceof Error ? error.stack ?? message : message}\n`);
+	  }
     }
     if (!stopping) await new Promise((resolveWait) => {
 	  const timer = setTimeout(() => {

package/extensions/fpa-artifacts/store.ts

@@ -144,7 +144,21 @@ async function existingLedgerDirectories(projectRoot: string): Promise<{ root: s
 	const objects = join(root, "objects");
 	const entries = join(root, "entries");
 	for (const [path, label] of [[root, ".ledger"], [objects, ".ledger/objects"], [entries, ".ledger/entries"]] as const) {
-		const stat = await lstat(path);
+		let stat;
+		try {
+			stat = await lstat(path);
+		} catch (error) {
+			// A project with no ledger is a state a caller can act on — the
+			// artifacts were never committed through it, or the directory was
+			// removed out from under a subscription that still holds refs.
+			// Letting a raw ENOENT escape turns that into an unreadable stack
+			// trace in the coordinator's last_error, which the operator then
+			// has to reverse-engineer.
+			if ((error as NodeJS.ErrnoException).code === "ENOENT") {
+				throw new Error(`This project has no artifact ledger (${label} is missing), so artifacts cannot be resolved by ref. Commit an artifact through the ledger before referencing one.`);
+			}
+			throw error;
+		}
 		if (stat.isSymbolicLink() || !stat.isDirectory()) throw new Error(`${label} must be a regular directory, not a symlink.`);
 	}
 	return { root, objects, entries };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viccydev/pi-fpa",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "type": "module",
   "description": "Full-cycle FP&A planning, strategy, forecast, and review prompts, skills, and data tools for Pi",
   "license": "UNLICENSED",