briefloop 0.28.3__tar.gz → 0.28.4__tar.gz

{briefloop-0.28.3 → briefloop-0.28.4}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 变更记录
 
+## 0.28.4 — 2026-10-02
+
+- 对话 Agent 可以通过正在运行的服务停止指定任务及子任务，保留已保存稿件，并返回实际停止状态。
+- 新工作区的联网完整报告默认启用独立事实核查；已有选择、单报告覆盖、离线和快速模式保持各自规则。
+- Native Scout 沿用已登记的轮次结果路径，在冻结上限内恢复可用并行容量，显示真实开始与结束时间。
+- 后续研究轮次声明任务时同步保存计划，避免上一轮任务残留导致无法结束研究。
+- 支持从已保存报告准备下一期：复用写作约定，重新确认本期日期和材料；不继承旧证据、评分或联网授权。
+- 点击“基于此报告开始下一期”直接准备表单，不再弹出确认框；页面保留说明与取消跨期关联入口，取消时保留已填内容。
+
 ## 0.28.3 — 2026-10-02
 
 - 内置 BriefLoop Agent 升级至 Pi 1.0.0，适配压缩指令的新 transcript 接口，保留角色工具隔离及失败后的会话恢复。

{briefloop-0.28.3 → briefloop-0.28.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: briefloop
-Version: 0.28.3
+Version: 0.28.4
 Summary: Local multi-runtime agent workbench for sourced briefings, independent review and skill learning
 Author: Stahl-G
 License-Expression: MIT

briefloop-0.28.4/VERSION

@@ -0,0 +1 @@
+0.28.4

{briefloop-0.28.3 → briefloop-0.28.4}/desktop/electron/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "briefloop-desktop",
-  "version": "0.28.3",
+  "version": "0.28.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "briefloop-desktop",
-      "version": "0.28.3",
+      "version": "0.28.4",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {

{briefloop-0.28.3 → briefloop-0.28.4}/desktop/electron/package.json

@@ -1,6 +1,6 @@
 {
   "name": "briefloop-desktop",
-  "version": "0.28.3",
+  "version": "0.28.4",
   "private": true,
   "description": "BriefLoop local desktop workspace",
   "author": "Stahl-G",

briefloop-0.28.4/docs/release-0.28.4.md

@@ -0,0 +1,9 @@
+# BriefLoop 0.28.4
+
+整合 #891、#892、#893 与 #870。修复对话停止任务、Native Scout 多轮路径、并行容量及计划同步；支持从已保存报告准备下一期，并按用户要求移除反复弹出的确认框。
+
+旧报告的正文、来源和评分保留；下一期只复用写作约定，需重新指定日期、材料和联网选择。修复复用时旧日期预览短暂残留的问题。完成实现与页面验收不代表连续多期返工率已改善，#865/#866/#858 的效果验收继续保持独立。
+
+#855 与 #857 的实验工具和评价候选不纳入本次发行；已有开发集结果不当作人工答案、留出集结果或稳定收益。
+
+从干净冻结提交构建一次共享 wheel，Mac、Windows、PyPI 复用同一字节。平台随包后端、合成 Word/Excel 导出、更新及实际安装结果记录在发行附件；缺少的 GUI 验证明确列出，不由 CI 代替。延续未签名桌面发行，不声称公证。发布后替换本机正式入口，不新增日常 App 安装副本。

{briefloop-0.28.3 → briefloop-0.28.4}/docs//346/267/261/345/272/246/347/240/224/347/251/266/344/270/216/344/272/213/345/256/236/346/240/270/346/237/245.md

@@ -18,7 +18,7 @@
 
 ## 生成后的独立事实核查
 
-在新建报告中勾选「生成后独立核查公开主张」。默认关闭；未允许联网时不能启用。任务保存实际开关，之后改工作区设置不会追溯改变旧任务。
+在新建报告中勾选「生成后独立核查公开主张」。新工作区的联网完整报告默认开启；已有工作区保留已保存的选择，单份报告可关闭。离线及快速模式默认不启用，未允许联网时不能显式开启。任务保存实际开关，之后改工作区设置不会追溯改变旧任务。
 
 执行顺序为：保存可编辑草稿 → 独立核查公开主张 → 独立审阅 → 按设置自动修订一次并复核。核查需要正文中已经登记并绑定的主张；没有可核查主张、研究阶段仍未收束或无法接纳预算时，会记录原因，不能显示为已完成核查。
 

{briefloop-0.28.3 → briefloop-0.28.4}/frontend/app.js

@@ -53,6 +53,7 @@ import {createFeedbackList} from './feedback-list.js';
 import {readersUI} from './readers.js';
 import {verificationBadge} from './skill-verification.js';
 import {previousReportUI} from './previous-report.js';
+import {nextReportUI} from './next-report.js';
 import {learningRetry} from './learning-retry.js';
 import {templatesUI,GENRE_META,ICONS,splitTemplateName} from './templates.js';
 import {createTemplateOutput} from './template-output.js';
@@ -187,6 +188,8 @@ function acceptCommand(){
 // Only editorial preferences lack a form control. Runtime/template snapshots are
 // deliberately rebuilt by the server and must never be copied from a prior run.
 let writingPreferencesOverride;
+const nextReport=nextReportUI({$,api,savedVersion,getTemplate:id=>{const t=state?.templates?.find(t=>t.id===id);return t?{...t,sections:parse(t.spec).sections||[]}:null},getCurrent:()=>current,applyRequirements,refreshTime:()=>previewReportTime(),notice,clearSources:()=>{selected.clear();referenceSelected.clear();document.querySelectorAll('[data-check],[data-reference-source]').forEach(input=>input.checked=false);renderReferenceSources()}});
+nextReport.bind();
 function preserveWritingPreferences(req,previous,override){
  if(!Object.prototype.hasOwnProperty.call(req,'writing_preferences'))req.writing_preferences=[...(Array.isArray(override)?override:Array.isArray(previous?.writing_preferences)?previous.writing_preferences:[])];
  return req;
@@ -562,10 +565,12 @@ let reportTimePreviewTicket=0;
 async function previewReportTime(){
  const ticket=++reportTimePreviewTicket;
  const form=$('requirements'),box=$('report-system-clock');
+ if(form.elements.previous_report_version_id?.value&&!['period','period_start','period_end'].some(key=>form.elements[key].value.trim())){box.textContent='请填写并确认本期时间范围；不会沿用上期日期。';return}
+ box.textContent='正在核对本期时间范围…';
  try{const requirements={title:form.elements.title.value||'预览',objective:form.elements.objective.value||'预览'};for(const key of ['period','period_start','period_end','report_timezone'])requirements[key]=form.elements[key].value;const t=await api('report-time-preview',{requirements});if(ticket!==reportTimePreviewTicket)return;reportFormDefaults.setWindow(t,requirements);box.textContent=`系统日期：${t.today} · ${t.timezone}；报告范围：${t.start} 至 ${t.end_exclusive}（不含结束时刻）。提交时冻结。`;}catch(e){if(ticket===reportTimePreviewTicket)box.textContent=e.message}
 }
 for(const key of ['period','period_start','period_end','report_timezone'])$('requirements').elements[key].addEventListener('change',previewReportTime);
-$('requirements').onsubmit=e=>{e.preventDefault();action(async()=>{const f=new FormData(e.target),req=Object.fromEntries(f.entries());if(!['fast','fast_web'].includes(req.completion_mode)&&req.writing_mode==='internal_report'&&state.settings.company_context_enabled==null){$('company-choice-dialog').showModal();return}req.allow_web=f.has('allow_web');req.fact_check=f.has('fact_check');req.target_words=Number(req.target_words);req.max_words=Number(req.max_words);Object.assign(req,lengthControls.read(),quickReport.read());req.research_budget=readResearchBudget();reportFormDefaults.prepare(req);reportMarket.prepare(req);req.search_policy=readSearchPolicy();Object.assign(req,readWorkflowChoice());req.reference_source_ids=[...referenceSelected];req.template_id=req.template_id||null;req.sections=readTemplateSections();req.key_questions=(req.key_questions_text||'').split('\n').map(x=>x.trim()).filter(Boolean);delete req.key_questions_text;req.manual_sections=(req.manual_sections_text||'').split('\n').map(x=>x.trim()).filter(Boolean);for(const title of req.manual_sections){const found=req.sections.find(s=>s.title===title);if(found){found.mode='manual';found.placeholder='待填充'}}delete req.manual_sections_text;preserveWritingPreferences(req,state.requirements,writingPreferencesOverride);if(!req.reader_id)delete req.reader_id;req.raw_input=req.objective;delete req.runtime_model;delete req.runtime_effort;await saveModel();if(current)await savedVersion();const connector_selection=reportMcpSelection.selection();const job=await api('generate',{...(connector_selection?{connector_selection}:{}),requirements:req,session_id:chat.id||undefined,source_ids:[...selected].filter(id=>!req.reference_source_ids.includes(id))});showPendingReport(parse(job.payload).run_id);page('report');notice('任务已排队，后台会生成简报')})};
+$('requirements').onsubmit=e=>{e.preventDefault();action(async()=>{const f=new FormData(e.target),req=Object.fromEntries(f.entries());if(!['fast','fast_web'].includes(req.completion_mode)&&req.writing_mode==='internal_report'&&state.settings.company_context_enabled==null){$('company-choice-dialog').showModal();return}req.allow_web=f.has('allow_web');req.fact_check=f.has('fact_check');req.target_words=Number(req.target_words);req.max_words=Number(req.max_words);Object.assign(req,lengthControls.read(),quickReport.read());req.research_budget=readResearchBudget();reportFormDefaults.prepare(req);reportMarket.prepare(req);req.search_policy=readSearchPolicy();Object.assign(req,readWorkflowChoice());req.reference_source_ids=[...referenceSelected];req.template_id=req.template_id||null;req.sections=readTemplateSections();req.key_questions=(req.key_questions_text||'').split('\n').map(x=>x.trim()).filter(Boolean);delete req.key_questions_text;req.manual_sections=(req.manual_sections_text||'').split('\n').map(x=>x.trim()).filter(Boolean);for(const title of req.manual_sections){const found=req.sections.find(s=>s.title===title);if(found){found.mode='manual';found.placeholder='待填充'}}delete req.manual_sections_text;preserveWritingPreferences(req,state.requirements,writingPreferencesOverride);if(!req.reader_id)delete req.reader_id;req.raw_input=req.objective;delete req.runtime_model;delete req.runtime_effort;await saveModel();if(current)await savedVersion();const connector_selection=reportMcpSelection.selection();const job=await api('generate',{...(connector_selection?{connector_selection}:{}),requirements:req,session_id:chat.id||undefined,source_ids:[...selected].filter(id=>!req.reference_source_ids.includes(id))});nextReport.clear();showPendingReport(parse(job.payload).run_id);page('report');notice('任务已排队，后台会生成简报')})};
 $('upload').onchange=e=>action(async()=>{preflightSources(e.target.files,getUploadLimits());for(const f of e.target.files){const s=await uploadSource(f);if(s.status==='ready')selected.add(s.id)}e.target.value=''},'来源已保存');
 $('add-url').onclick=()=>action(async()=>{const s=await api('source-url',{url:$('source-url').value});if(s.status==='ready')selected.add(s.id);$('source-url').value='';notice(s.status==='ready'?'网页已读取':'来源已保存，但读取失败：'+s.error,s.status!=='ready')});
 $('rescore').onclick=()=>action(async()=>{await savedVersion();await api('assess',{version_id:current.id,session_id:chat.id||undefined})},'已提交评分');
@@ -1820,7 +1825,8 @@ function readTemplateSections(){
  // Never submit a report whose chosen template is not ready; falling back to the
  // general layout would silently change the deliverable.
  if(template&&template.status&&template.status!=='ready')throw Error('所选模板尚未就绪：'+template.name+'；请改用通用模板，或等模板准备完成后再提交');
- const saved=templateId&&state.requirements?.template_id===templateId?state.requirements.sections||[]:[];
+ const reused=nextReport.requirementsForTemplate(templateId);
+ const saved=reused?.sections||(templateId&&state.requirements?.template_id===templateId?state.requirements.sections||[]:[]);
  return [...$('template-sections').querySelectorAll('[data-section-id]')].map(row=>{
   const base=original.find(s=>s.section_id===row.dataset.sectionId)||{},requirement=saved.find(s=>s.section_id===row.dataset.sectionId);
   return {section_id:row.dataset.sectionId,title:row.querySelector('[data-title]').value,purpose:row.querySelector('[data-purpose]')?.value??requirement?.purpose??base.purpose??'',mode:row.querySelector('select').value,placeholder:'待填充'};
@@ -1832,8 +1838,9 @@ function templateSections(){
 }
 function applyTemplateSectionEdits(){
  const templateId=$('template-select').value;
- if(!templateId||state?.requirements?.template_id!==templateId)return;
- for(const section of state.requirements.sections||[]){const row=[...$('template-sections').querySelectorAll('[data-section-id]')].find(r=>r.dataset.sectionId===section.section_id);if(row){row.querySelector('[data-title]').value=section.title;row.querySelector('select').value=section.mode||'required'}}
+ const reused=nextReport.requirementsForTemplate(templateId);
+ if(!templateId||(!reused&&state?.requirements?.template_id!==templateId))return;
+ for(const section of (reused||state.requirements).sections||[]){const row=[...$('template-sections').querySelectorAll('[data-section-id]')].find(r=>r.dataset.sectionId===section.section_id);if(row){row.querySelector('[data-title]').value=section.title;row.querySelector('select').value=section.mode||'required'}}
 }
 function unreadyTemplate(id){const template=(state?.templates||[]).find(t=>t.id===id);return template&&template.status&&template.status!=='ready'?template:null}
 function renderTemplates(first=false){

briefloop-0.28.4/frontend/next-report.js

@@ -0,0 +1,53 @@
+// Reuse the saved contract, not old facts, reviews or runtime authorizations.
+export function nextReportUI({$,api,savedVersion,getCurrent,applyRequirements,clearSources,notice,getTemplate,refreshTime=()=>{}}){
+ let pending=false,contract=null;
+ const form=()=>$('requirements');
+ function set(name,value){const field=form()?.elements?.[name];if(!field)return;
+  if(field.type==='checkbox')field.checked=!!value;else field.value=value??'';
+  field.dispatchEvent?.(new Event('change',{bubbles:true}));
+ }
+ function clear(){contract=null;set('previous_report_version_id','');set('previous_report_hash','');
+  if($('next-report-notice'))$('next-report-notice').hidden=true;
+ }
+ function requirementsForTemplate(id){return contract&&form()?.elements?.previous_report_version_id?.value&&contract.template_id===id?contract:null}
+ async function start(){
+  if(pending||!getCurrent())return;
+  pending=true;
+  try{
+   const version=await savedVersion();
+   const data=await api('next-report?version_id='+encodeURIComponent(version));
+   if(getCurrent()?.id!==version)throw Error('当前报告已切换，请重新选择要复用的版本');
+   const candidate=data.requirements;
+   if(candidate.template_id){
+    const template=getTemplate(candidate.template_id);
+    if(!template||template.status!=='ready')throw Error('往期模板已不可用或尚未就绪，请先恢复模板，或手动建立本期需求');
+    const sections=template.sections||[];
+    if((candidate.sections||[]).some(section=>!sections.some(item=>item.section_id===section.section_id)))
+     throw Error('往期模板章节已变化，请核对模板后再复用，避免遗漏人工保留的章节');
+   }
+   contract=candidate;
+   set('completion_mode','standard');
+   set('template_id',contract.template_id||'');
+   applyRequirements(JSON.stringify(contract));
+   for(const key of ['organization','industry','report_date','reader_id','previous_report_version_id','previous_report_hash'])set(key,contract[key]);
+   set('allow_web',false);set('fact_check',false);
+   clearSources();
+   const sections=contract.sections||[];
+   for(const row of $('template-sections')?.querySelectorAll('[data-section-id]')||[]){
+    const section=sections.find(item=>item.section_id===row.dataset.sectionId);
+    if(section){row.querySelector('[data-title]').value=section.title;row.querySelector('select').value=section.mode||'required'}
+   }
+   const box=$('next-report-notice');
+   if(box){box.hidden=false;$('next-report-summary').textContent=`基于《${data.previous.title}》的已保存版本开始下一期。${data.notice}`+
+     (data.reader?` 当前读者：${data.reader.name}；用途：${data.reader.decisions}；偏好：${data.reader.preferences}。请确认是否仍适用。`:'');}
+   refreshTime();
+   form()?.elements?.title?.focus?.();
+   notice('已复用约定；请填写本期标题、时间范围并选择材料');
+  }finally{pending=false}
+ }
+ function bind(){const button=$('next-report');if(button)button.onclick=()=>start().catch(error=>notice(error.message,true));
+  if($('next-report-cancel'))$('next-report-cancel').onclick=clear;
+  form()?.addEventListener?.('reset',clear);
+ }
+ return {bind,start,clear,requirementsForTemplate};
+}

{briefloop-0.28.3 → briefloop-0.28.4}/frontend/research-process.js

@@ -17,6 +17,7 @@ function stepState(value,active){
  return ['running','active'].includes(value)?(active?'active':'pending'):'pending';
 }
 function stepTime(step,now){
+ if(step.not_started)return '尚未开始';
  const duration=step.duration_ms??(step.duration_seconds==null?null:Number(step.duration_seconds)*1000);
  if(duration!==null&&Number.isFinite(Number(duration))&&Number(duration)>=0)return elapsedText('1970-01-01T00:00:00Z',Number(duration));
  if(step.started&&(step.ended||step.status==='active'))return elapsedText(step.started,step.ended?Date.parse(step.ended):now);

{briefloop-0.28.3 → briefloop-0.28.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "briefloop"
-version = "0.28.3"
+version = "0.28.4"
 description = "Local multi-runtime agent workbench for sourced briefings, independent review and skill learning"
 readme = "README.md"
 requires-python = ">=3.11"

briefloop-0.28.4/src/briefloop/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.28.4"

{briefloop-0.28.3 → briefloop-0.28.4}/src/briefloop/chat_tools.py

@@ -31,7 +31,7 @@ WORKSPACE_ACTIONS = (
     'profile_read','profile_update',
     'freeze_research_plan','research_status','begin_research_round','finish_research_round','set_scout_tasks',
     'reconciliation_candidates','reconciliation_save','reconciliation_read',
-    'export_word','inspect','generate','assess','comment','learn',
+    'export_word','inspect','stop_job','generate','assess','comment','learn',
 )
 
 
@@ -198,6 +198,13 @@ def workspace_action(store, request):
             'runtime':store.runtime_config(),
             'note':'简要工作区索引；需要原文时使用 read-source --id SOURCE_ID。任务状态和 error 是已记录事实，不代表根因诊断；没有对应日志证据不得声称服务重启、网络故障或权限拒绝。来源已保存不代表已核验其真实性或时效性，研究进度不代表报告已完成。',
         }
+    if action=='stop_job':
+        job_id=request.get('job_id')
+        if not isinstance(job_id,str) or not job_id.strip():raise ValueError('请提供要停止的明确 job_id')
+        # Use the live worker, including transport cancellation and child jobs.
+        # A CLI Store is a separate process and must never just flip DB status.
+        from .external_client import Client
+        return Client(store.root).stop_job(job_id)
     if action=='generate':
         requirements=Requirements.model_validate(request['requirements'])
         source_ids=request.get('source_ids',[])
@@ -338,7 +345,9 @@ def chat_instructions(store, runtime, *, internal=False, allow_web=False, backen
 - {{"action":"read_report","version_id":"稿件ID"}}：读取富文档 JSON、引用和已存正文的 length_stats；revise_document 回执也给出保存后的确定性计数。按 count/rule 核对原始要求、读者约定及当前反馈，不估算字数；over_limit 只比较结构化 max_words，不表示已满足全部篇幅要求。用户明确要求修改内容/章节/图表时，将修改后的 JSON 保存到工作区文件，再用 {{"action":"revise_document","base_version":"刚读取版本ID","document_file":"工作区内JSON绝对路径"}} 保存新版本，不覆盖用户并发编辑。可选 citations 完整替换引用列表（source_id/locator/excerpt，schema 见 capabilities），省略则保留；只修改引用也保存新版本，定位描述不表示已独立核验。
 - {{"action":"import_word_revision","base_version":"用户指定基础版本","source_id":"DOCX来源ID"}}：导入用户修改的 Word。返回 needs_alignment 时先核对原件和基础版本，向用户说明对齐问题；仅按用户明确选择提供 accept_unaligned=true。用户希望更新模板时另用 template_import 并提供 parent_id。
 - {{"action":"generate","requirements":{{"title":"标题","objective":"用户目的","audience":"读者","language":"zh|en","extent":"compact|balanced|detailed","research_tier":"quick|standard|deep","allow_web":{str(bool(allow_web)).lower()},"period":"时间范围"}},"source_ids":["真实来源ID"],"runtime":{runtime_json}}}：正式生成可在页面编辑的简报。language 是报告正文语言（默认 zh）；用户要英文报告时写 en，不传 target_words 时篇幅按英文词数默认。research_tier 是研究深度档位（默认 standard）：quick 单轮检索，deep 预排 4 轮迭代研究；按用户明确要求选，用户未提就不写该字段。scout_limit 是本报告最多可同时派发的 Scout 数（1–16），在提交前按信息量决定：一周左右约 4，月报约 8，跨多个行业或市场的大型报告可到 12–16；不写时系统按期间自动设定（月报 8，其余沿用工作区设置）。
+联网完整报告的 fact_check 沿用工作区默认（新工作区开启）；用户选择关闭时显式传 false，选择开启时传 true。离线或快速模式不自动开启，也不为核查偷偷开启联网。
 提交 generate 时，必须把本轮已经确认的 key_questions、writing_preferences、章节、期间和篇幅完整写进 requirements，不能只传标题摘要。用户给出的执行约束同样在提交前冻结：target_minutes 是软目标；hard_timeout_minutes=0 表示不设硬截止；research_budget 包含 search_requests、candidate_urls、source_pages；search_policy 沿用已授权设置。不得说“后台稍后配置”而遗漏已指定的额度。并行数要求写入 writing_preferences，供主 Agent 冻结研究计划时选择 structure.parallel；不改变共享预算。提交回执中的实际冻结值与用户要求不一致时明确说明，不宣称已应用。
+- {{"action":"stop_job","job_id":"真实任务ID"}}：用户要求停止任务时，先通过 inspect 确认具体任务，再停止该任务及其子任务，已保存稿件保留。用户要求“停掉旧任务再重新生成”时先取得停止回执，再提交新任务；停止失败时如实说明，不启动重复任务。目标不明确时先问，不猜 ID，不停止整个服务。以回执的实际 status 为准，已经完成的任务不会变成 cancelled。
 - {{"action":"assess","version_id":"真实简报版本ID"}}：为已有稿件安排评分。
 - {{"action":"comment","version_id":"真实简报版本ID","text":"用户反馈"}}：记录用户明确提出的反馈。页面自动学习开启时，保存反馈可能稍后自动触发学习，要如实告知。
 - {{"action":"learn"}}：仅当用户明确要求启动技能学习时调用，会消耗额外模型额度。调用前先告诉用户上限（每轮最多 3 个案例、每案例基线与候选各试写一次，另有整理、提案与比较回合；轮数按学习设置），得到明确同意后再调用；保存反馈本身不需要调用它。

{briefloop-0.28.3 → briefloop-0.28.4}/src/briefloop/external_client.py

@@ -56,6 +56,12 @@ class Client:
             raise ValueError(self.info.get('message', '工作区服务尚未就绪'))
 
     def request(self, body):
+        return self._post('/api/external/action', body)
+
+    def stop_job(self, job_id):
+        return self._post('/api/stop', {'job_id': job_id})
+
+    def _post(self, path, body):
         if not isinstance(body, dict):
             raise ValueError('请求必须是 JSON 对象')
         wid = body.get('workspace_id', self.info['workspace_id'])
@@ -65,7 +71,7 @@ class Client:
         endpoint = urlsplit(self.info['url'])
         connection = http.client.HTTPConnection(endpoint.hostname, endpoint.port, timeout=15)
         try:
-            connection.request('POST', '/api/external/action', body=json.dumps({**body, 'workspace_id': wid}, ensure_ascii=False).encode(),
+            connection.request('POST', path, body=json.dumps({**body, 'workspace_id': wid}, ensure_ascii=False).encode(),
                                headers={'Content-Type': 'application/json', 'X-BriefLoop-Token': token})
             response = connection.getresponse()
             data = response.read(32 * 1024 * 1024 + 1)

{briefloop-0.28.3 → briefloop-0.28.4}/src/briefloop/models.py

@@ -113,6 +113,8 @@ class Requirements(Model):
     # A saved reader profile (#858); create_run freezes it into reader_profile.
     reader_id: str | None = Field(default=None, max_length=80)
     reader_profile: dict | None = None
+    previous_report_version_id: str | None = Field(default=None, max_length=100)
+    previous_report_hash: str | None = Field(default=None, max_length=64)
     # Report body language. The interface, internal records and review notes
     # stay Chinese; only the report text and its length presets follow this.
     language: Literal["zh", "en"] = "zh"
@@ -362,7 +364,7 @@ class Settings(RoleModel):
     default_template_id: str | None = None
     company_context_enabled: bool | None = None
     # Workspace-wide default for the per-task fact_check switch; tasks may override.
-    fact_checker: bool = False
+    fact_checker: bool = True
     # Workspace-wide optional local file quality checks via officecli; the
     # switch has no effect while the binary is not installed.
     officecli_enabled: bool = False

{briefloop-0.28.3 → briefloop-0.28.4}/src/briefloop/native_orchestrator.py

@@ -9,7 +9,7 @@ import hashlib
 import json
 from pathlib import Path
 
-from .store import dump
+from .store import dump, now
 from .native_roles import ToolError, _atomic, _json_result
 from .revision_metadata import binding_schema, response_schema, validate_arrays, validate_bindings
 
@@ -19,7 +19,7 @@ READ_ACTIONS = {'inspect', 'capabilities', 'templates', 'workflows', 'profile_re
 RUN_ACTIONS = {'set_reader_contract', 'freeze_research_plan', 'begin_research_round',
                'finish_research_round', 'set_scout_tasks', 'reconciliation_save', 'evidence_span',
                'claim_create', 'claim_bind', 'company_update', 'company_review_complete'}
-CHAT_ACTIONS = READ_ACTIONS | {'generate', 'assess', 'comment', 'export_word', 'profile_update', 'company_config', 'company_resolve', 'revise_document', 'learn', 'template_import', 'template_rebuild', 'import_word_revision'}
+CHAT_ACTIONS = READ_ACTIONS | {'stop_job', 'generate', 'assess', 'comment', 'export_word', 'profile_update', 'company_config', 'company_resolve', 'revise_document', 'learn', 'template_import', 'template_rebuild', 'import_word_revision'}
 
 
 def _save(path, value):
@@ -102,7 +102,8 @@ def action(store, config, args):
                 frozen_req = json.loads(view.one('runs', result['run_id'])['requirements'])
                 result['accepted_requirements'] = {**result.get('accepted_requirements', {}),
                     'length_mode': frozen_req.get('length_mode', 'soft'),
-                    'length_requirement': frozen_req.get('length_requirement')}
+                    'length_requirement': frozen_req.get('length_requirement'),
+                    'fact_check': frozen_req.get('fact_check')}
             else:
                 from .models import Settings, Requirements, runtime_fields
                 settings = Settings.model_validate({**view.settings(), **request['runtime']})
@@ -118,13 +119,28 @@ def action(store, config, args):
                 result = {'job_id': job['id'], 'run_id': run['id'], 'status': 'queued',
                           'accepted_requirements': {key: value for key, value in json.loads(run['requirements']).items()
                               if key in ('title', 'target_minutes', 'hard_timeout_minutes', 'research_budget', 'key_questions',
-                                         'writing_preferences', 'target_words', 'max_words', 'length_mode', 'length_requirement', 'period', 'search_policy')}}
+                                         'writing_preferences', 'target_words', 'max_words', 'length_mode', 'length_requirement', 'period', 'search_policy', 'fact_check')}}
                 view.set_meta(key, {'fingerprint': fingerprint, 'result': result})
         store.wake_jobs()
         from .task_notify import notify
         notify(store, store.one('jobs', result['job_id']), 'queued')
         return _json_result(result)
     result = workspace_action(store, request)
+    if name == 'set_scout_tasks' and 'scout_tasks' in request and config.get('packet_root'):
+        # A successful declaration is the binding plan for this round. Keep the
+        # saved Native plan current; otherwise closeout compares round 2 with
+        # round 1 forever. Declaration still rejects dropped/rewritten work.
+        from .research_plan import frozen
+        research = frozen(store, run_id) or {}
+        round_id = request.get('round_id') or research.get('current_round_id') or 'legacy'
+        path = _folder(config) / 'plan.json'
+        if path.is_file():
+            plan = json.loads(path.read_text(encoding='utf-8-sig'))
+            plan['scout_tasks'] = [
+                {key: task[key] for key in ('slot_id', 'assignment', 'result_file')}
+                for task in result['scout_execution'] if task['round_id'] == round_id]
+            _save(path, plan)
+            _save(Path(config['packet_root']) / 'plan.json', plan)
     if name == 'reconciliation_save' and config.get('packet_root'):
         _save(_folder(config) / 'reconciliation.json', result)
     if name == 'finish_research_round' and config.get('packet_root'):
@@ -174,8 +190,10 @@ def _child(store, config, directory, callback):
         with harness._lock:
             path = _folder(config) / 'agents.json'
             records = json.loads(path.read_text(encoding='utf-8')) if path.exists() else {'agents': []}
+            previous = next((a for a in records['agents'] if a['agent_id'] == identity), {})
             records['agents'] = [a for a in records['agents'] if a['agent_id'] != identity]
-            records['agents'].append({'agent_id': identity, 'role': role, 'status': status})
+            timing = {'started': now()} if status == 'running' else {'started': previous.get('started'), 'ended': now()}
+            records['agents'].append({'agent_id': identity, 'role': role, 'status': status, **timing})
             _save(path, records)
     with harness.child_runtime(config['session_id'], runtime):
         _alive(store, config)
@@ -225,13 +243,29 @@ def run_scouts(store, config, args):
         committed = {task['slot_id']: task for task in view(store, config['run_id'])['scout_execution'] if task['round_id'] == identity}
     for task in tasks:
         expected = committed.get(task['slot_id'])
-        result_file = str((folder / ('round-' + round_id) / task['slot_id'] / 'result.json').resolve())
-        if not expected or expected['assignment'] != str(task.get('assignment') or '').strip() or expected['result_file'] != result_file:
-            raise ToolError('实际 Scout 任务必须匹配已保存 scout_tasks 的分工与结果路径；先补全本轮计划')
+        scoped = {folder / ('round-' + round_id) / task['slot_id'] / 'result.json',
+                  store.root / 'research' / config['run_id'] / 'rounds' / round_id / task['slot_id'] / 'result.json'}
+        if round_id == '1':
+            scoped.add(folder / task['slot_id'] / 'result.json')
+        if not expected or expected['assignment'] != str(task.get('assignment') or '').strip():
+            raise ToolError('实际 Scout 任务必须匹配已保存 scout_tasks 的分工；先读取 research_status')
+        result_file = Path(expected['result_file'])
+        if result_file not in scoped or result_file.resolve() != result_file:
+            raise ToolError('已登记 Scout 结果路径不属于本任务、本轮与槽位')
+        if task.get('result_file') and task['result_file'] != str(result_file):
+            raise ToolError('实际 Scout 结果路径须沿用已登记路径：' + str(result_file))
+    # A concurrent job may have occupied slots while the initial packet was
+    # prepared. Reclaim now-free capacity within the original frozen ceiling.
+    budget_for_job = getattr(store, '_scout_budget_for_job', None)
+    budget = budget_for_job(job) if budget_for_job else None
+    if budget:
+        ceiling = min(int((frozen_plan or {}).get('frozen_runtime', {}).get('max_parallel') or limit),
+                      int((frozen_plan or {}).get('structure', {}).get('parallel') or limit), len(tasks))
+        limit = max(1, min(ceiling, budget(ceiling)))
     update(store, config['run_id'], [{'slot_id': task['slot_id'], 'status': 'dispatched'} for task in tasks])
     results = []
     def execute(task):
-        path = folder / ('round-' + round_id) / task['slot_id']
+        path = Path(committed[task['slot_id']]['result_file']).parent
         path.mkdir(parents=True, exist_ok=True)
         assignment = path / 'assignment.json'
         if assignment.exists() and json.loads(assignment.read_text(encoding='utf-8')) != task:
@@ -251,14 +285,15 @@ def run_scouts(store, config, args):
     with ThreadPoolExecutor(max_workers=min(limit, len(tasks))) as pool:
         results = list(pool.map(execute, tasks))
     _alive(store, config)
-    paths = sorted(folder.glob('round-*/scout-*/result.json'))
+    paths = sorted({Path(task['result_file']) for task in view(store, config['run_id'])['scout_execution']
+                    if Path(task['result_file']).is_file()})
     # All rounds remain available; replayed slots are not duplicated.
     joined = join_scouts(store, paths, run_id=config['run_id']) if paths else {'sources': [], 'gaps': []}
     from .research_handoff import current_research
     joined = current_research(store, config['run_id'], joined, register=True)
     _save(folder / 'research.json', joined)
     _save(Path(config['packet_root']) / 'research.json', joined)
-    return _json_result({'tasks': results, 'research_file': 'research.json', 'sources': len(joined['sources']), 'gaps': joined['gaps'], 'gap_records': joined.get('gap_records', []), 'gap_history': joined.get('gap_history', []), 'execution_gaps': joined.get('execution_gaps', [])})
+    return _json_result({'parallel_limit': limit, 'tasks': results, 'research_file': 'research.json', 'sources': len(joined['sources']), 'gaps': joined['gaps'], 'gap_records': joined.get('gap_records', []), 'gap_history': joined.get('gap_history', []), 'execution_gaps': joined.get('execution_gaps', [])})
 
 
 def _refresh_research(store, config):

briefloop-0.28.4/src/briefloop/next_report.py

@@ -0,0 +1,49 @@
+"""Reuse an explicitly selected report's contract, never its current facts (#865)."""
+import json
+
+
+CONTRACT_FIELDS = (
+    'objective', 'audience', 'organization', 'industry', 'language', 'extent',
+    'writing_mode', 'report_profile', 'workflow_id', 'workflow_variant',
+    'template_id', 'sections', 'manual_sections', 'key_questions',
+    'writing_preferences', 'target_words', 'max_words', 'length_mode',
+    'length_requirement', 'report_timezone',
+)
+
+
+def prepare(store, version_id):
+    """Read-only preview; opening it creates no source, run, job or authorization."""
+    brief = store.one('briefs', version_id)
+    run = store.one('runs', brief['run_id'])
+    previous = json.loads(run['requirements'])
+    requirements = {key: previous[key] for key in CONTRACT_FIELDS if key in previous}
+    reader = None
+    if previous.get('reader_id'):
+        from .readers import profile
+        try:
+            reader = profile(store, previous['reader_id'])
+            requirements['reader_id'] = reader['id']
+        except ValueError:
+            pass  # Archived readers are not silently reactivated.
+    requirements.update(title='', period='', period_start='', period_end='', report_date='',
+                        allow_web=False, fact_check=False, reference_source_ids=[],
+                        previous_report_version_id=brief['id'], previous_report_hash=brief['hash'])
+    return {'requirements': requirements,
+            'previous': {'version_id': brief['id'], 'run_id': run['id'], 'hash': brief['hash'],
+                         'title': json.loads(brief['detail']).get('title', previous.get('title', ''))},
+            'source_ids': [], 'reader': reader,
+            'notice': '沿用已保存的要求与写作偏好；请填写本期标题和时间范围，核对要求中的历史条件，并重新选择本期材料。旧来源、评分、联网及费用授权不会自动沿用。'}
+
+
+def validate_origin(store, requirements):
+    version = requirements.previous_report_version_id
+    digest = requirements.previous_report_hash
+    if not version and not digest:
+        return
+    if not version or not digest:
+        raise ValueError('下一期需要明确的往期版本与内容哈希')
+    brief = store.one('briefs', version)
+    if brief['hash'] != digest:
+        raise ValueError('往期报告内容已变化，请重新选择复用版本')
+    if not (requirements.period.strip() or (requirements.period_start and requirements.period_end)):
+        raise ValueError('开始下一期前请确认本期时间范围')

{briefloop-0.28.3 → briefloop-0.28.4}/src/briefloop/progress.py

@@ -253,6 +253,8 @@ class ProgressTracker:
                     if row.get('status') not in ENDED:
                         row['status']=agent.get('status','running')
                     row['task']=str(agent.get('responsibility',''))[:240]
+                    for field in ('started','ended'):
+                        if agent.get(field):row[field]=agent[field]
             except (ValueError,OSError):pass
         workers=list(self.workers.values())
         active=[w for w in workers if w.get('status') not in ENDED | {'unknown'}]

{briefloop-0.28.3 → briefloop-0.28.4}/src/briefloop/runtime.py

@@ -513,6 +513,7 @@ class Worker:
         self.store=store;self._runtime=runtime;self.stopping=threading.Event();self.current=None
         self._queue_wakes=[threading.Event() for _ in range(4)]
         self.store._job_wakeup=self.wake
+        self.store._scout_budget_for_job=self._scout_budget
         self.schedule_thread=threading.Thread(target=self.schedule_loop,name='briefloop-schedules',daemon=True)
         self.thread=threading.Thread(target=self.loop,name='briefloop-worker',daemon=True)
         self.task_thread=None
@@ -584,6 +585,7 @@ class Worker:
         if self.file_thread.is_alive():self.file_thread.join(timeout=12)
         if self.extraction_thread.is_alive():self.extraction_thread.join(timeout=12)
         if self.store._job_wakeup==self.wake:self.store._job_wakeup=None
+        if getattr(self.store,'_scout_budget_for_job',None)==self._scout_budget:self.store._scout_budget_for_job=None
 
     def schedule_loop(self):
         from .schedules import tick

{briefloop-0.28.3 → briefloop-0.28.4}/src/briefloop/schedules.py

@@ -77,7 +77,7 @@ def validate(store, body):
     # Freeze the optional paid check when the schedule is saved. A later change
     # of workspace defaults must not silently enable it on recurring reports.
     if req['fact_check'] is None:
-        req['fact_check']=store.settings().get('fact_checker') is True
+        req['fact_check']=req['allow_web'] and req['completion_mode'] not in ('fast','fast_web') and store.settings().get('fact_checker') is True
     if req['fact_check'] and not req['allow_web']:
         raise ValueError('离线任务不能开启联网事实核查；请允许联网检索，或关闭该开关')
     if req['fact_check']:

{briefloop-0.28.3 → briefloop-0.28.4}/src/briefloop/server.py

@@ -243,6 +243,9 @@ def _make_server(workspace, port, *, paused, backend, lock):
                 elif u.path=='/api/report-context':
                     from .report_browsing import context
                     self.send(200,context(store,q['version_id'][0]))
+                elif u.path=='/api/next-report':
+                    from .next_report import prepare
+                    self.send(200,prepare(store,q['version_id'][0]))
                 elif u.path=='/api/report-search':
                     self.send(200,{'run_ids':store.search_briefs(q.get('q',[''])[0])})
                 elif u.path=='/api/source-search':
@@ -868,7 +871,12 @@ def _make_server(workspace, port, *, paused, backend, lock):
                     # The confirmation names the plan the user saw, so a settings
                     # change in another window cannot enlarge this batch (#727).
                     result=enqueue_feedback(store,confirmed_plan=body.get('confirm_plan'))
-                elif path=='/api/stop':worker.stop_job(body['job_id']);result={'ok':True}
+                elif path=='/api/stop':
+                    if body.get('workspace_id',store.meta('workspace_id'))!=store.meta('workspace_id'):
+                        raise ValueError('停止请求不属于当前工作区')
+                    worker.stop_job(body['job_id'])
+                    stopped=store.one('jobs',body['job_id'])
+                    result={'ok':True,'job_id':stopped['id'],'status':stopped['status']}
                 elif path=='/api/resume':result=worker.retry_with_current_model(body['job_id'],confirmed_plan=body.get('confirm_plan')) if body.get('use_current_model') is True else worker.resume(body['job_id'])
                 elif path=='/api/task-dismiss':
                     job=store.one('jobs',body['job_id'])