@arcfold/dsh-method-ui 0.0.0-stage → 0.4.0

package/src/understanding-locales.mjs

@@ -0,0 +1,38 @@
+export const understandingZh = {
+  understandingTitle: '理解与依据', understandingOpen: '查看理解', understandingHide: '收起理解',
+  understandingEmpty: '还没有可查看的理解。', understandingLoading: '正在读取理解…',
+  understandingBoundary: '这里保留原话、AI 的推断和后续纠正。可采用表示依据仍有效，不代表已经证实，也不授予执行权限。',
+  understandingAvailable: '可采用', understandingUnavailable: '已停止采用或依据不可用',
+  understandingInference: 'AI 推断', understandingLiteral: '你的明确陈述', understandingQuestion: '待确认的问题',
+  understandingStop: '停止采用这条理解', understandingWithdraw: '停止采用这条来源',
+  understandingWithdrawalHelp: '停止来源会影响依赖它的理解、方法和目标依据；原聊天记录仍保留，已发出的工作不会撤销，目标的追踪状态不会改变。',
+  understandingCorrect: '纠正这条理解', understandingReplacement: '完整替换为',
+  understandingCorrectionHelp: '请写出这条理解应当完整替换成的内容。原话会进入当前对话，在下一次尚未发出的步骤中核对并采用；旧版本仍可查看。',
+  understandingSubmit: '发送纠正原话', understandingCancel: '取消编辑',
+  understandingSaved: '操作已记录。', understandingPending: '已送入对话，尚未确认采用。请刷新查看实际结果。',
+  understandingUnknown: '发送结果未确认，未自动重发。请刷新查看记录。',
+  understandingApplied: '已采用', understandingFailed: '未采用', understandingAwaiting: '等待实际采用',
+  understandingAdmission: '对话接收', understandingAccepted: '已接收', understandingAdmissionFailed: '未送入',
+  understandingAdmissionUnknown: '未确认', understandingVersion: '内容版本', understandingHistory: '保留的版本', understandingCommands: '操作记录',
+  understandingSuccessors: '后续版本', understandingEffects: '受影响的记录', understandingGoalEffects: '目标依据变化',
+  understandingSource: '原始来源', understandingProvenance: '查看来源信息', understandingMissing: '来源缺失',
+};
+export const understandingEn = {
+  understandingTitle: 'Understanding and evidence', understandingOpen: 'View understanding', understandingHide: 'Hide understanding',
+  understandingEmpty: 'No understanding is available yet.', understandingLoading: 'Loading understanding…',
+  understandingBoundary: 'Original statements, AI inferences and corrections are retained. Eligible evidence is neither verified truth nor permission to act.',
+  understandingAvailable: 'Eligible', understandingUnavailable: 'Stopped or evidence unavailable',
+  understandingInference: 'AI inference', understandingLiteral: 'Your explicit statement', understandingQuestion: 'Open question',
+  understandingStop: 'Stop using this understanding', understandingWithdraw: 'Stop using this source',
+  understandingWithdrawalHelp: 'This affects dependent understanding, methods and goal evidence. Native history remains; sent work is not undone and goal tracking is unchanged.',
+  understandingCorrect: 'Correct this understanding', understandingReplacement: 'Full replacement text',
+  understandingCorrectionHelp: 'Write the complete replacement. Your exact words enter this conversation and are checked before the next unsent step. Earlier versions remain available.',
+  understandingSubmit: 'Send correction', understandingCancel: 'Cancel editing',
+  understandingSaved: 'Operation recorded.', understandingPending: 'Admitted to the conversation; application is not confirmed. Refresh to see the actual result.',
+  understandingUnknown: 'Admission is unconfirmed. Nothing was resent automatically. Refresh the record.',
+  understandingApplied: 'Applied', understandingFailed: 'Not applied', understandingAwaiting: 'Awaiting application',
+  understandingAdmission: 'Conversation admission', understandingAccepted: 'Accepted', understandingAdmissionFailed: 'Not sent',
+  understandingAdmissionUnknown: 'Unknown', understandingVersion: 'Content version', understandingHistory: 'Retained versions', understandingCommands: 'Operations',
+  understandingSuccessors: 'Later versions', understandingEffects: 'Affected records', understandingGoalEffects: 'Goal evidence changes',
+  understandingSource: 'Original source', understandingProvenance: 'View provenance', understandingMissing: 'Source missing',
+};

package/src/understanding-source.mjs

@@ -0,0 +1,64 @@
+import { requireViewScope, viewScopeFields } from './browse-source.mjs';
+// Refresh and reconnect only read. Every write has an explicit UI caller.
+export function createUnderstandingSource({ rpc, sessionId, viewScope, subscribeReset, intervalMs = 5000 }) {
+  viewScopeFields(viewScope);
+  let snapshot = { loading: true, error: null, items: [], total: 0, offset: 0, nextOffset: null, readEpoch: 0 };
+  let generation = 0, controller, timer, reset, disposed = false;
+  const listeners = new Set(), reads = new Set();
+  const stopped = () => Object.assign(new Error('这次读取已经结束，请重新打开。'), { code: 'understanding_read_cancelled' });
+  const call = async (endpoint, payload, signal) => {
+    if (disposed) throw stopped();
+    const scope = ['list', 'details'].includes(endpoint) ? viewScopeFields(viewScope) : {};
+    const result = await rpc.call('/api', `arcfoldUnderstandings/${endpoint}`, { args: { request: { ...payload, sessionId, ...scope } } }, signal);
+    if (result?.ok !== true) throw Object.assign(new Error(result?.error?.message || '理解请求未完成。'),
+      { code: result?.error?.code || 'understanding_request_failed', remote: true });
+    return result.value;
+  };
+  const publish = value => { snapshot = { ...snapshot, ...value }; for (const listener of listeners) listener(); };
+  function invalidateReads() {
+    controller?.abort(); generation++;
+    for (const read of reads) read.abort();
+    publish({ loading: true, error: null, items: [], total: 0, offset: 0, nextOffset: null, readEpoch: snapshot.readEpoch + 1 });
+  }
+  async function refresh(offset = snapshot.offset) {
+    if (disposed) return;
+    controller?.abort(); controller = new AbortController();
+    const current = ++generation, signal = controller.signal;
+    try {
+      const result = await call('list', { offset, limit: 20 }, signal);
+      if (current === generation && !disposed && !signal.aborted) publish({ ...result, offset, loading: false, error: null });
+    } catch (error) {
+      if (current === generation && !disposed && !signal.aborted) publish({ loading: false, error: error.message });
+    }
+  }
+  async function details(understandingId) {
+    if (disposed) throw stopped();
+    const read = new AbortController(), epoch = snapshot.readEpoch; reads.add(read);
+    try {
+      const result = await call('details', { understandingId }, read.signal);
+      if (disposed || read.signal.aborted || epoch !== snapshot.readEpoch) throw stopped();
+      return result;
+    } finally { reads.delete(read); }
+  }
+  function stop() { clearInterval(timer); timer = undefined; reset?.(); reset = undefined; invalidateReads(); }
+  return {
+    getSnapshot: () => snapshot,
+    subscribe(listener) {
+      if (disposed) return () => {};
+      listeners.add(listener);
+      if (listeners.size === 1) { void refresh(); timer = setInterval(() => { void refresh(); }, intervalMs);
+        reset = subscribeReset(() => { invalidateReads(); void refresh(0); }); }
+      return () => { listeners.delete(listener); if (!listeners.size) stop(); };
+    },
+    refresh, details,
+    setViewScope(value) {
+      requireViewScope(value);
+      if (disposed || viewScope === value) return;
+      viewScope = value; invalidateReads();
+      if (listeners.size) void refresh(0);
+    },
+    decide: request => call('decide', request),
+    correct: request => call('correct', request),
+    dispose() { disposed = true; stop(); listeners.clear(); },
+  };
+}