create-windy 0.8.0 → 0.8.1

package/dist/cli.js

@@ -33,7 +33,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = import.meta.require;
 
-// ../../node_modules/.bun/cli-width@4.1.0/node_modules/cli-width/index.js
+// ../../node_modules/cli-width/index.js
 var require_cli_width = __commonJS((exports, module2) => {
   module2.exports = cliWidth;
   function normalizeOpts(options) {
@@ -73,7 +73,7 @@ var require_cli_width = __commonJS((exports, module2) => {
   }
 });
 
-// ../../node_modules/.bun/mute-stream@3.0.0/node_modules/mute-stream/lib/index.js
+// ../../node_modules/mute-stream/lib/index.js
 var require_lib = __commonJS((exports, module2) => {
   var Stream = __require("stream");
 
@@ -2022,7 +2022,14 @@ var nativeSymbols = {
 };
 var directoryFlags = constants2.O_RDONLY | constants2.O_DIRECTORY | constants2.O_NOFOLLOW;
 var removeDirectoryFlag = process.platform === "darwin" ? 128 : 512;
-var getLibc = createLazyLibcLoader((candidate) => dlopen2(candidate, nativeSymbols), "\u5F53\u524D\u5E73\u53F0\u65E0\u6CD5\u52A0\u8F7D\u5B89\u5168\u76EE\u5F55\u53E5\u67C4 API");
+var getLibc = createLazyLibcLoader((candidate) => {
+  const libc = dlopen2(candidate, nativeSymbols);
+  const errnoSymbol = process.platform === "darwin" ? libc.symbols.__error : libc.symbols.__errno_location;
+  const errnoPointer = errnoSymbol();
+  if (!errnoPointer)
+    throw new Error("\u65E0\u6CD5\u8BFB\u53D6\u539F\u751F\u9519\u8BEF\u7801\uFF0C\u4E8B\u52A1\u5B89\u5168\u5173\u95ED");
+  return { symbols: libc.symbols, errnoPointer };
+}, "\u5F53\u524D\u5E73\u53F0\u65E0\u6CD5\u52A0\u8F7D\u5B89\u5168\u76EE\u5F55\u53E5\u67C4 API");
 function resolveSafeTarget(root, path) {
   if (!path || isAbsolute(path) || path.includes("\x00") || path.split(/[\\/]/).includes("..")) {
     throw new Error(`\u66F4\u65B0\u8BA1\u5212\u5305\u542B\u4E0D\u5B89\u5168\u8DEF\u5F84\uFF1A${path}`);
@@ -2196,12 +2203,7 @@ function nativeUnlinkAt(directoryFd, name, flags) {
 }
 function nativeError(syscall, path) {
   const libc = getLibc();
-  const errnoSymbol = process.platform === "darwin" ? libc.symbols.__error : libc.symbols.__errno_location;
-  const errnoPointer = errnoSymbol();
-  if (!errnoPointer) {
-    throw new Error(`\u65E0\u6CD5\u8BFB\u53D6 ${syscall} \u7684\u539F\u751F\u9519\u8BEF\u7801\uFF0C\u4E8B\u52A1\u5B89\u5168\u5173\u95ED`);
-  }
-  const errno = read.i32(errnoPointer, 0);
+  const errno = read.i32(libc.errnoPointer, 0);
   return Object.assign(new Error(`${syscall} ${path} \u5931\u8D25`), {
     code: errnoCode(errno),
     errno: -errno,
@@ -4107,6 +4109,8 @@ var templateDocumentationFiles = [
   "docs/architecture/mcp-business-capabilities.md",
   "docs/architecture/migration-bundle.md",
   "docs/architecture/module-host.md",
+  "docs/architecture/log-governance-plan.md",
+  "docs/architecture/log-governance-implementation.md",
   "docs/architecture/module-manifest-composition.md",
   "docs/architecture/module-secret-resolution.md",
   "docs/architecture/object-storage.md",
@@ -4673,7 +4677,7 @@ function isMissing6(error) {
 import { createInterface as createInterface2 } from "readline/promises";
 import { stdin, stdout } from "process";
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/key.js
+// ../../node_modules/@inquirer/core/dist/lib/key.js
 var keybindings = ["emacs", "vim"];
 var keybindingLookup = new Set(keybindings);
 function isKeybinding(value) {
@@ -4690,7 +4694,7 @@ var isDownKey = (key, keybindings2 = []) => key.name === "down" || keybindings2.
 var isSpaceKey = (key) => key.name === "space";
 var isNumberKey = (key) => "1234567890".includes(key.name);
 var isEnterKey = (key) => key.name === "enter" || key.name === "return";
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/errors.js
+// ../../node_modules/@inquirer/core/dist/lib/errors.js
 class AbortPromptError extends Error {
   name = "AbortPromptError";
   message = "Prompt was aborted";
@@ -4716,10 +4720,10 @@ class HookError extends Error {
 class ValidationError extends Error {
   name = "ValidationError";
 }
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-state.js
+// ../../node_modules/@inquirer/core/dist/lib/use-state.js
 import { AsyncResource as AsyncResource2 } from "async_hooks";
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/hook-engine.js
+// ../../node_modules/@inquirer/core/dist/lib/hook-engine.js
 import { AsyncLocalStorage, AsyncResource } from "async_hooks";
 var hookStorage = new AsyncLocalStorage;
 function createStore(rl) {
@@ -4824,7 +4828,7 @@ var effectScheduler = {
   }
 };
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-state.js
+// ../../node_modules/@inquirer/core/dist/lib/use-state.js
 function isFactory(value) {
   return typeof value === "function";
 }
@@ -4845,7 +4849,7 @@ function useState(defaultValue) {
   });
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-effect.js
+// ../../node_modules/@inquirer/core/dist/lib/use-effect.js
 function useEffect(cb, depArray) {
   withPointer((pointer) => {
     const oldDeps = pointer.get();
@@ -4857,10 +4861,10 @@ function useEffect(cb, depArray) {
   });
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/theme.js
+// ../../node_modules/@inquirer/core/dist/lib/theme.js
 import { styleText } from "util";
 
-// ../../node_modules/.bun/@inquirer+figures@2.0.7/node_modules/@inquirer/figures/dist/index.js
+// ../../node_modules/@inquirer/figures/dist/index.js
 import process2 from "process";
 function isUnicodeSupported() {
   if (!process2.platform.startsWith("win")) {
@@ -5149,7 +5153,7 @@ var figures = shouldUseMain ? mainSymbols : fallbackSymbols;
 var dist_default = figures;
 var replacements = Object.entries(specialMainSymbols);
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/theme.js
+// ../../node_modules/@inquirer/core/dist/lib/theme.js
 var defaultTheme = {
   prefix: {
     idle: styleText("blue", "?"),
@@ -5177,7 +5181,7 @@ function getDefaultTheme() {
   };
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/make-theme.js
+// ../../node_modules/@inquirer/core/dist/lib/make-theme.js
 function isPlainObject(value) {
   if (typeof value !== "object" || value === null)
     return false;
@@ -5205,7 +5209,7 @@ function makeTheme(...themes) {
   return deepMerge(...themesToMerge);
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-prefix.js
+// ../../node_modules/@inquirer/core/dist/lib/use-prefix.js
 function usePrefix({ status = "idle", theme }) {
   const [showLoader, setShowLoader] = useState(false);
   const [tick, setTick] = useState(0);
@@ -5235,7 +5239,7 @@ function usePrefix({ status = "idle", theme }) {
   const iconName = status === "loading" ? "idle" : status;
   return typeof prefix === "string" ? prefix : prefix[iconName] ?? prefix["idle"];
 }
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-memo.js
+// ../../node_modules/@inquirer/core/dist/lib/use-memo.js
 function useMemo(fn, dependencies) {
   return withPointer((pointer) => {
     const prev = pointer.get();
@@ -5247,12 +5251,12 @@ function useMemo(fn, dependencies) {
     return prev.value;
   });
 }
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-ref.js
+// ../../node_modules/@inquirer/core/dist/lib/use-ref.js
 function useRef(val) {
   return useState({ current: val })[0];
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-keypress.js
+// ../../node_modules/@inquirer/core/dist/lib/use-keypress.js
 function useKeypress(userHandler) {
   const signal = useRef(userHandler);
   signal.current = userHandler;
@@ -5270,10 +5274,10 @@ function useKeypress(userHandler) {
     };
   }, []);
 }
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/utils.js
+// ../../node_modules/@inquirer/core/dist/lib/utils.js
 var import_cli_width = __toESM(require_cli_width(), 1);
 
-// ../../node_modules/.bun/fast-string-truncated-width@3.0.3/node_modules/fast-string-truncated-width/dist/utils.js
+// ../../node_modules/fast-string-truncated-width/dist/utils.js
 var getCodePointsLength = (() => {
   const SURROGATE_PAIR_RE = /[\uD800-\uDBFF][\uDC00-\uDFFF]/g;
   return (input) => {
@@ -5292,7 +5296,7 @@ var isWideNotCJKTNotEmoji = (x) => {
   return x === 8987 || x === 9001 || x >= 12272 && x <= 12287 || x >= 12289 && x <= 12350 || x >= 12441 && x <= 12543 || x >= 12549 && x <= 12591 || x >= 12593 && x <= 12686 || x >= 12688 && x <= 12771 || x >= 12783 && x <= 12830 || x >= 12832 && x <= 12871 || x >= 12880 && x <= 19903 || x >= 65040 && x <= 65049 || x >= 65072 && x <= 65106 || x >= 65108 && x <= 65126 || x >= 65128 && x <= 65131 || x >= 127488 && x <= 127490 || x >= 127504 && x <= 127547 || x >= 127552 && x <= 127560 || x >= 131072 && x <= 196605 || x >= 196608 && x <= 262141;
 };
 
-// ../../node_modules/.bun/fast-string-truncated-width@3.0.3/node_modules/fast-string-truncated-width/dist/index.js
+// ../../node_modules/fast-string-truncated-width/dist/index.js
 var ANSI_RE = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y;
 var CONTROL_RE = /[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y;
 var CJKT_WIDE_RE = /(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu;
@@ -5391,7 +5395,7 @@ var getStringTruncatedWidth = (input, truncationOptions = {}, widthOptions = {})
 };
 var dist_default2 = getStringTruncatedWidth;
 
-// ../../node_modules/.bun/fast-string-width@3.0.2/node_modules/fast-string-width/dist/index.js
+// ../../node_modules/fast-string-width/dist/index.js
 var NO_TRUNCATION2 = {
   limit: Infinity,
   ellipsis: "",
@@ -5402,7 +5406,7 @@ var fastStringWidth = (input, options = {}) => {
 };
 var dist_default3 = fastStringWidth;
 
-// ../../node_modules/.bun/fast-wrap-ansi@0.2.2/node_modules/fast-wrap-ansi/lib/main.js
+// ../../node_modules/fast-wrap-ansi/lib/main.js
 var ESC = "\x1B";
 var CSI = "\x9B";
 var END_CODE = 39;
@@ -5614,7 +5618,7 @@ function wrapAnsi(string, columns, options) {
 `);
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/utils.js
+// ../../node_modules/@inquirer/core/dist/lib/utils.js
 function breakLines(content, width) {
   return content.split(`
 `).flatMap((line) => wrapAnsi(line, width, { trim: false, wordWrap: false }).split(`
@@ -5625,7 +5629,7 @@ function readlineWidth() {
   return import_cli_width.default({ defaultWidth: 80, output: readline().output });
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/pagination/use-pagination.js
+// ../../node_modules/@inquirer/core/dist/lib/pagination/use-pagination.js
 function usePointerPosition({ active, renderedItems, pageSize, loop }) {
   const state = useRef({
     lastPointer: active,
@@ -5691,12 +5695,12 @@ function usePagination({ items, active, renderItem, pageSize, loop = true }) {
   return pageBuffer.filter((line) => typeof line === "string").join(`
 `);
 }
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/create-prompt.js
+// ../../node_modules/@inquirer/core/dist/lib/create-prompt.js
 var import_mute_stream = __toESM(require_lib(), 1);
 import * as readline2 from "readline";
 import { AsyncResource as AsyncResource3 } from "async_hooks";
 
-// ../../node_modules/.bun/signal-exit@4.1.0/node_modules/signal-exit/dist/mjs/signals.js
+// ../../node_modules/signal-exit/dist/mjs/signals.js
 var signals = [];
 signals.push("SIGHUP", "SIGINT", "SIGTERM");
 if (process.platform !== "win32") {
@@ -5706,7 +5710,7 @@ if (process.platform === "linux") {
   signals.push("SIGIO", "SIGPOLL", "SIGPWR", "SIGSTKFLT");
 }
 
-// ../../node_modules/.bun/signal-exit@4.1.0/node_modules/signal-exit/dist/mjs/index.js
+// ../../node_modules/signal-exit/dist/mjs/index.js
 var processOk = (process3) => !!process3 && typeof process3 === "object" && typeof process3.removeListener === "function" && typeof process3.emit === "function" && typeof process3.reallyExit === "function" && typeof process3.listeners === "function" && typeof process3.kill === "function" && typeof process3.pid === "number" && typeof process3.on === "function";
 var kExitEmitter = Symbol.for("signal-exit emitter");
 var global = globalThis;
@@ -5904,10 +5908,10 @@ var {
   unload
 } = signalExitWrap(processOk(process3) ? new SignalExit(process3) : new SignalExitFallback);
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/screen-manager.js
+// ../../node_modules/@inquirer/core/dist/lib/screen-manager.js
 import { stripVTControlCharacters } from "util";
 
-// ../../node_modules/.bun/@inquirer+ansi@2.0.7/node_modules/@inquirer/ansi/dist/index.js
+// ../../node_modules/@inquirer/ansi/dist/index.js
 var ESC2 = "\x1B[";
 var cursorLeft = ESC2 + "G";
 var cursorHide = ESC2 + "?25l";
@@ -5923,7 +5927,7 @@ var cursorTo = (x, y) => {
 var eraseLine = ESC2 + "2K";
 var eraseLines = (lines) => lines > 0 ? (eraseLine + cursorUp(1)).repeat(lines - 1) + eraseLine + cursorLeft : "";
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/screen-manager.js
+// ../../node_modules/@inquirer/core/dist/lib/screen-manager.js
 var height = (content) => content.split(`
 `).length;
 var lastLine = (content) => content.split(`
@@ -5989,7 +5993,7 @@ class ScreenManager {
   }
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/promise-polyfill.js
+// ../../node_modules/@inquirer/core/dist/lib/promise-polyfill.js
 class PromisePolyfill extends Promise {
   static withResolver() {
     let resolve6;
@@ -6002,7 +6006,7 @@ class PromisePolyfill extends Promise {
   }
 }
 
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/create-prompt.js
+// ../../node_modules/@inquirer/core/dist/lib/create-prompt.js
 import path from "path";
 var nativeSetImmediate = globalThis.setImmediate;
 function getCallSites() {
@@ -6113,7 +6117,7 @@ function createPrompt(view) {
   };
   return prompt;
 }
-// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/Separator.js
+// ../../node_modules/@inquirer/core/dist/lib/Separator.js
 import { styleText as styleText2 } from "util";
 class Separator {
   separator = styleText2("dim", Array.from({ length: 15 }).join(dist_default.line));
@@ -6127,7 +6131,7 @@ class Separator {
     return Boolean(choice && typeof choice === "object" && "type" in choice && choice.type === "separator");
   }
 }
-// ../../node_modules/.bun/@inquirer+checkbox@5.2.1+7cb241fc07b679d9/node_modules/@inquirer/checkbox/dist/index.js
+// ../../node_modules/@inquirer/checkbox/dist/index.js
 import { styleText as styleText3 } from "util";
 var checkboxTheme = {
   icon: {
@@ -8524,7 +8528,8 @@ var recipes = [
     id: "starter-0.7.0-to-0.8.0",
     from: "0.7.0",
     to: "0.8.0"
-  }
+  },
+  { id: "starter-0.8.0-to-0.8.1", from: "0.8.0", to: "0.8.1" }
 ];
 function resolveRecipeChain(sourceVersion, targetVersion) {
   if (compareVersions2(sourceVersion, minimumSupportedUpdateVersion) < 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-windy",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "创建单组织、单租户、私有部署优先的 Windy 企业 Dashboard Starter",
   "type": "module",
   "bin": {

package/template/.windy-template.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "templateCommit": "20ddeda7267de315fb8fe115d64ad6b8c892ccb8",
-  "generatorVersion": "0.8.0",
+  "templateCommit": "066d8018c0ec0c82fbf01d26013b3b303aaa9c22",
+  "generatorVersion": "0.8.1",
   "modules": [
     {
       "name": "system",

package/template/apps/agent-server/Dockerfile

@@ -24,4 +24,4 @@ RUN mkdir -p /app/data/agent \
 USER windy
 HEALTHCHECK --interval=15s --timeout=5s --start-period=10s --retries=4 \
   CMD ["python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=3)"]
-CMD ["uvicorn", "southwind_agent_server.app:app", "--host", "0.0.0.0", "--port", "8080"]
+CMD ["uvicorn", "southwind_agent_server.asgi:app", "--host", "0.0.0.0", "--port", "8080"]

package/template/apps/agent-server/README.md

@@ -43,7 +43,7 @@ export AI_PROVIDER_INPUT_MODALITIES='text'
 export AGENT_RUN_STORE_PATH='.data/agent-runs.sqlite3'
 export AI_PROVIDER_AUDIT_STORE_PATH='.data/provider-audit.sqlite3'
 export AI_PROVIDER_AUDIT_RETENTION_DAYS='90'
-uv run uvicorn southwind_agent_server.app:app
+uv run uvicorn southwind_agent_server.asgi:app
 ```
 
 公网 URL 必须使用 HTTPS 且 Host 精确命中 allowlist；本机、容器服务名和内网地址允许

package/template/apps/agent-server/src/southwind_agent_server/asgi.py

@@ -0,0 +1,8 @@
+"""Production ASGI entrypoint with operational logging installed."""
+
+from .app import app
+from .structured_logging import configure_agent_logging
+
+configure_agent_logging()
+
+__all__ = ["app"]

package/template/apps/agent-server/src/southwind_agent_server/runtime_logging.py

@@ -0,0 +1,57 @@
+"""Safe attempt diagnostics, separate from the canonical Run store and audit."""
+
+from __future__ import annotations
+
+import logging
+import time
+
+from .store import RunRecord
+
+logger = logging.getLogger(__name__)
+
+
+class AgentOperationalAttempt:
+    def __init__(self, record: RunRecord) -> None:
+        self._run_id = record.run_id
+        self._trace_id = record.trace_id
+        self._started_at: float | None = None
+        self._finished = False
+
+    def start(self) -> None:
+        if self._started_at is not None:
+            return
+        self._started_at = time.monotonic()
+        self._emit("agent.run.attempt.started")
+
+    def finish(self, status: str) -> None:
+        if self._started_at is None or self._finished:
+            return
+        self._finished = True
+        self._emit(
+            "agent.run.attempt.completed",
+            operational_status=status,
+            operational_duration_ms=round(
+                (time.monotonic() - self._started_at) * 1_000, 3
+            ),
+        )
+
+    def _emit(self, event: str, **fields: str | float) -> None:
+        try:
+            emit = (
+                logger.warning
+                if event == "agent.run.attempt.completed"
+                and fields.get("operational_status") != "completed"
+                else logger.info
+            )
+            emit(
+                "Agent 执行阶段",
+                extra={
+                    "operational_event": event,
+                    "run_id": self._run_id,
+                    "trace_id": self._trace_id,
+                    **fields,
+                },
+            )
+        except Exception:
+            # 日志出口失败不能改变 Run 或租约的业务结果。
+            return

package/template/apps/agent-server/src/southwind_agent_server/structured_logging.py

@@ -0,0 +1,134 @@
+"""Agent runtime adapter for the Windy operational log contract."""
+
+from __future__ import annotations
+
+import json
+import logging
+import math
+import re
+import sys
+from datetime import UTC, datetime
+from typing import TextIO
+
+MAX_LOG_BYTES = 2048
+_CORRELATION = re.compile(r"^[A-Za-z0-9._-]{1,128}$")
+_STABLE = re.compile(r"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$")
+_EVENTS = {
+    "Agent Run 恢复轮询失败，将继续重试": (
+        "agent.run.recovery.failed",
+        "AGENT_RUN_RECOVERY_FAILED",
+    ),
+    "Agent Runtime 报表写入失败": (
+        "agent.report.write.failed",
+        "AGENT_REPORT_WRITE_FAILED",
+    ),
+}
+_ATTEMPT_EVENTS = frozenset(
+    {
+        "agent.run.attempt.started",
+        "agent.run.attempt.completed",
+    }
+)
+_ATTEMPT_ERRORS = {
+    "failed": "AGENT_RUN_FAILED",
+    "cancelled": "AGENT_RUN_CANCELLED",
+    "interrupted": "AGENT_RUN_INTERRUPTED",
+}
+
+
+def agent_log_record(record: logging.LogRecord) -> dict[str, str | bool | float]:
+    """Map known runtime failures without serializing messages, errors or extras."""
+    event, error_code = _EVENTS.get(
+        record.msg if isinstance(record.msg, str) else "",
+        ("agent.runtime.failed", "AGENT_RUNTIME_FAILED"),
+    )
+    attempt_event = getattr(record, "operational_event", None)
+    is_attempt = isinstance(attempt_event, str) and attempt_event in _ATTEMPT_EVENTS
+    result: dict[str, str | bool | float] = {
+        "timestamp": datetime.now(UTC)
+        .isoformat(timespec="milliseconds")
+        .replace("+00:00", "Z"),
+        "level": "error"
+        if record.levelno >= logging.ERROR
+        else ("warn" if record.levelno >= logging.WARNING else "info"),
+        "component": "agent-server",
+        "event": attempt_event
+        if isinstance(attempt_event, str) and is_attempt
+        else event,
+        "retentionClass": "operational",
+    }
+    if not is_attempt:
+        result.update(outcome="failure", errorCode=error_code)
+    elif attempt_event == "agent.run.attempt.completed":
+        status = getattr(record, "operational_status", "interrupted")
+        if status not in {"completed", "failed", "cancelled"}:
+            status = "interrupted"
+        result["stageKey"] = status
+        result["outcome"] = "success" if status == "completed" else "failure"
+        if status != "completed":
+            result["errorCode"] = _ATTEMPT_ERRORS[status]
+        duration = getattr(record, "operational_duration_ms", None)
+        if (
+            isinstance(duration, (int, float))
+            and not isinstance(duration, bool)
+            and math.isfinite(duration)
+            and 0 <= duration <= 3_600_000
+        ):
+            result["durationMs"] = duration
+    for source, target in (
+        ("request_id", "requestId"),
+        ("run_id", "runId"),
+        ("job_id", "jobId"),
+        ("trace_id", "traceId"),
+    ):
+        value = getattr(record, source, None)
+        if isinstance(value, str) and _CORRELATION.fullmatch(value):
+            result[target] = value
+    stage = getattr(record, "report_stage", None)
+    if isinstance(stage, str) and len(stage) <= 64 and _STABLE.fullmatch(stage):
+        result["stageKey"] = stage
+    for key in ("stageKey", "traceId", "jobId", "runId", "requestId"):
+        if len(json.dumps(result, ensure_ascii=False).encode("utf-8")) <= MAX_LOG_BYTES:
+            break
+        result.pop(key, None)
+        result["truncated"] = True
+    return result
+
+
+class AgentStructuredLogHandler(logging.Handler):
+    def __init__(self, stream: TextIO | None = None) -> None:
+        super().__init__(level=logging.INFO)
+        self.stream = stream or sys.stdout
+
+    def emit(self, record: logging.LogRecord) -> None:
+        try:
+            if (
+                record.levelno < logging.WARNING
+                and getattr(record, "operational_event", None) not in _ATTEMPT_EVENTS
+            ):
+                return
+            line = json.dumps(
+                agent_log_record(record), ensure_ascii=False, separators=(",", ":")
+            )
+            self.stream.write(f"{line}\n")
+            self.flush()
+        except Exception:
+            # 运行日志旁路失败时不能改变 Run 与报表写入的业务结果。
+            return
+
+    def flush(self) -> None:
+        try:
+            self.stream.flush()
+        except Exception:
+            return
+
+
+def configure_agent_logging() -> None:
+    """Attach once to package loggers; keep Uvicorn's own access logs separate."""
+    logger = logging.getLogger("southwind_agent_server")
+    if not any(
+        isinstance(handler, AgentStructuredLogHandler) for handler in logger.handlers
+    ):
+        logger.addHandler(AgentStructuredLogHandler())
+    logger.setLevel(logging.INFO)
+    logger.propagate = False

package/template/apps/agent-server/src/southwind_agent_server/telemetry.py

@@ -17,6 +17,7 @@ from opentelemetry.trace import (
     TraceFlags,
 )
 
+from .runtime_logging import AgentOperationalAttempt
 from .store import RunRecord
 
 _configured = False
@@ -50,11 +51,14 @@ class AgentRunTrace:
             },
         )
         self._token: Token[Context] | None = None
+        self._operational = AgentOperationalAttempt(record)
 
     def start(self) -> None:
         self._token = context.attach(trace.set_span_in_context(self._span))
+        self._operational.start()
 
     def finish(self, status: str) -> None:
+        self._operational.finish(status)
         self._span.set_attribute("agent.run.status", status)
         if self._token is not None:
             context.detach(self._token)