@x-otto/cli 0.0.1-alpha.49 → 0.0.1-alpha.50

package/dist/bundled-extensions/plugin-feedback/src/resolved-sink.ts

@@ -0,0 +1,163 @@
+/**
+ * resolved-sink.ts — RFC-430 §2.4：「本地标记已解决」JSONL 落地层。
+ *
+ * 复刻 pulse-survey-sink.ts 的既有纪律（appendFileSync + 5MB 截断保留最后 50% +
+ * fail-soft 全局吞错 + RFC-345 shadow 模式零写盘）——两处独立各自实现一份而非
+ * 抽取共享 helper（同 pulse-survey-sink 头注释的既有判断：各自的 fail-soft 边界
+ * 不完全相同，重复优于错误的抽象）。
+ *
+ * 落盘位置：`~/.otto/feedback/resolved.jsonl`（pulse-surveys.jsonl 平级的独立子目录，
+ * 为 M2+ 反馈面板其他本地态预留目录位）。
+ *
+ * **仅本地标记**——真实关闭请在平台侧操作（面板 UI 明示同一文案，RFC-430 §3）。
+ */
+import { existsSync, mkdirSync, appendFileSync, statSync, readFileSync, writeFileSync, renameSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { randomUUID } from 'node:crypto'
+
+import { OTTO_HOME, isShadowModeEnabled } from '@x-otto/env'
+
+import type { FeedbackResolvedMark, FeedbackSource } from '@x-otto/plugin'
+import type { FeedbackLoggerPort } from './pulse-survey-sink'
+
+const noopLogger: FeedbackLoggerPort = { warn: () => {} }
+
+/** 单文件大小上限（5MB，同 pulse-survey-sink/plugin-log-writer 既有惯例）。 */
+const MAX_LOG_FILE_BYTES = 5 * 1024 * 1024
+
+/** 标记文件路径（`resolve` 而非 `join`，对齐 pulse-survey-sink 的既有惯例）。 */
+export function resolvedMarksPath(): string {
+  return resolve(OTTO_HOME, 'feedback', 'resolved.jsonl')
+}
+
+/** 单文件超限时截断保留最后 50%（有损策略，同 pulse-survey-sink truncateIfOversized）。 */
+function truncateIfOversized(path: string, logger: FeedbackLoggerPort): void {
+  let size: number
+  try {
+    size = statSync(path).size
+  } catch {
+    return // 文件不存在，无需截断
+  }
+  if (size <= MAX_LOG_FILE_BYTES) return
+
+  try {
+    const content = readFileSync(path, 'utf8')
+    const keepFrom = Math.floor(content.length / 2)
+    // 从字符中点找下一个换行符，避免截断到半行 JSON。
+    const nl = content.indexOf('\n', keepFrom)
+    const truncated = nl >= 0 ? content.slice(nl + 1) : content.slice(keepFrom)
+    writeFileSync(path, truncated)
+  } catch (error) {
+    // fail-soft：截断失败不影响后续写入尝试（append 会继续追加到超限文件，下次再试截断）。
+    logger.warn(`resolved marks truncation failed (fail-soft): path=${path} err=${String(error)}`)
+  }
+}
+
+/**
+ * 读全部行（容错：坏行跳过；文件不存在/读取失败 → 空数组）。
+ *
+ * `_logger` 有意未使用：本函数的三条失败路径（文件不存在/读取失败、单行 JSON 解析
+ * 失败、形状不符的脏条目）按设计**全部静默跳过**——读路径的坏数据不该刷屏（写路径才
+ * 记 warn，见 appendResolvedMark/truncate）。参数保留是为与同模块写函数签名一致，
+ * 且三个调用点已传 `this.logger`，删参会破坏调用方。
+ */
+export function readResolvedMarks(_logger: FeedbackLoggerPort = noopLogger): FeedbackResolvedMark[] {
+  // RFC-345：影子态零读取语义对齐零写盘——面板在影子态下视为「无本地标记」。
+  if (isShadowModeEnabled()) return []
+  const path = resolvedMarksPath()
+  let content: string
+  try {
+    content = readFileSync(path, 'utf8')
+  } catch {
+    return []
+  }
+  const marks: FeedbackResolvedMark[] = []
+  for (const line of content.split('\n')) {
+    if (!line.trim()) continue
+    try {
+      const raw = JSON.parse(line) as Partial<FeedbackResolvedMark>
+      if (
+        typeof raw.ts === 'number' &&
+        (raw.source === 'github' || raw.source === 'coding') &&
+        typeof raw.platformIssueId === 'string' &&
+        typeof raw.url === 'string' &&
+        typeof raw.title === 'string'
+      ) {
+        marks.push({
+          ts: raw.ts,
+          source: raw.source,
+          platformIssueId: raw.platformIssueId,
+          url: raw.url,
+          title: raw.title,
+        })
+      }
+      // 形状不符的坏行静默跳过（容错解析，同 github-lister 的脏条目纪律）。
+    } catch {
+      // 单行 JSON 解析失败静默跳过。
+    }
+  }
+  return marks
+}
+
+/**
+ * 本地标记 sink（RFC-430 §2.4 数据面）。
+ * fail-soft：所有写路径异常内部吞掉仅 warn；影子态 mark/unmark 返回 false 零写盘。
+ */
+export class LocalJsonlResolvedMarksSink {
+  constructor(private readonly logger: FeedbackLoggerPort = noopLogger) {}
+
+  /** 追加一条标记；重复标记（同 source+platformIssueId）幂等返回 true（不重写）。 */
+  mark(mark: Omit<FeedbackResolvedMark, 'ts'>): boolean {
+    if (isShadowModeEnabled()) return false
+    try {
+      // 幂等去重：面板可能重复触发标记动作。
+      const existing = readResolvedMarks(this.logger)
+      if (existing.some((m) => m.source === mark.source && m.platformIssueId === mark.platformIssueId)) {
+        return true
+      }
+      const path = resolvedMarksPath()
+      const dir = resolve(OTTO_HOME, 'feedback')
+      if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true })
+      }
+      truncateIfOversized(path, this.logger)
+      const entry: FeedbackResolvedMark = { ts: Date.now(), ...mark }
+      appendFileSync(path, `${JSON.stringify(entry)}\n`)
+      return true
+    } catch (error) {
+      this.logger.warn(`resolved mark append failed (fail-soft): ${String(error)}`)
+      return false
+    }
+  }
+
+  /**
+   * 剔除匹配行（原子重写：写临时文件 + rename 覆盖，避免半写状态）；
+   * 无匹配行/影子态/写失败返回 false。
+   */
+  unmark(source: FeedbackSource, platformIssueId: string): boolean {
+    if (isShadowModeEnabled()) return false
+    try {
+      const path = resolvedMarksPath()
+      const existing = readResolvedMarks(this.logger)
+      const kept = existing.filter((m) => !(m.source === source && m.platformIssueId === platformIssueId))
+      if (kept.length === existing.length) return false // 无匹配行
+      const tmpPath = `${path}.${randomUUID()}.tmp`
+      writeFileSync(tmpPath, kept.map((m) => `${JSON.stringify(m)}\n`).join(''))
+      renameSync(tmpPath, path) // POSIX rename 原子替换
+      return true
+    } catch (error) {
+      this.logger.warn(`resolved mark unmark failed (fail-soft): ${String(error)}`)
+      return false
+    }
+  }
+
+  /** 读取全部标记（fail-soft：任何失败返回空数组）。 */
+  list(): FeedbackResolvedMark[] {
+    try {
+      return readResolvedMarks(this.logger)
+    } catch (error) {
+      this.logger.warn(`resolved marks list failed (fail-soft): ${String(error)}`)
+      return []
+    }
+  }
+}

package/dist/bundled-extensions/plugin-otto-wire-protocols/plugin-dist/meta.json

@@ -1 +1 @@
-{"apiVersion":1,"compilerVersion":"0.1.0-alpha.6","sourceHash":"28b4f7c10707642654e4b86f54be95e11a6544869c1be666c36bf9beb7b40133"}
+{"apiVersion":1,"compilerVersion":"0.1.0-alpha.6","sourceHash":"ac6abc4d8fbfb920396f454bdbca52424de691d8787743bf4ef84c3c4fac0cfc"}