NoteConnection v1.8.0

NoteConnection v1.8.0

English

Release Scope

• Compare baseline: v1.7.0..v1.8.0
• Release date: 2026-07-07
• Scope summary:
  • 343 implementation commits since the previous formal release, plus release metadata.
  • Major focus: Knowledge Workspace / Agent Workspace reliability, RSE document-augmented graph RAG, richer one-message answers, runtime observability, desktop sidecar hardening, CI governance, and bilingual documentation.

Breaking Changes

• No intentional breaking API change is introduced in this release.
• The Knowledge Workspace response model remains additive and forward-compatible: new RAG, trace, claim-citation, sufficiency, source-decision, and export fields are optional.
• Runtime caches, graph caches, and probe fixtures may be regenerated after upgrade; this is expected and does not require a manual data migration.

Highlights

• Upgraded Knowledge Workspace answers from narrow scoped summaries to a bounded RSE + document-augmented graph RAG pipeline.
• Added full-document-aware source augmentation for selected scoped documents while keeping model-visible context bounded by RagContextPack.
• Added graph-conditioned evidence assembly so predecessor/successor nodes contribute source-backed content, relation metadata, and intent-ranked graph context rather than title-only hints.
• Preserved the one public chat message contract while moving orchestration, scoring, recovery, source decisions, evidence roles, and claim-citation mapping into backend trace/status/export surfaces.
• Added profile-aware public answer behavior for definitions, comparisons, how-to answers, causal explanations, and generic queries.
• Hardened release review so public answers are checked against citation-backed RAG fragments, profile completeness signals, graph intent, structured contradictions, temporal qualifiers, and diagnostic leakage rules.
• Expanded runtime and CI probes to cover full-document scans, cross-document conflicts, condition-scoped evidence, graph-neighbor source loss, provider judge failure, and answer profile budgets.

Knowledge Workspace RAG and Answer Quality

• Introduced typed RAG evidence contracts:
  • RagEvidenceFragment
  • RagContextPack
  • RagContextBudget
  • RagSufficiencyReview
  • source decisions and failure-stage classifications
• Added source-window and document augmentation assembly:
  • starts from precise evidence spans;
  • reads complete selected source documents when provenance allows;
  • emits direct support, parent context, adjacent context, graph-neighbor support, conflict, background, and degraded source-window states;
  • deduplicates repeated/overlapping windows and preserves line/offset provenance.
• Added budgeted context packing:
  • role-prioritized fragment selection;
  • per-fragment and total-character caps;
  • traceable include/truncate/drop decisions;
  • head/tail-preserving truncation for oversized evidence.
• Added deterministic and optional provider-backed sufficiency judging:
  • deterministic gates run first;
  • optional LLM judge reuses the existing NoteMD provider boundary;
  • malformed JSON, timeout, and provider failure fall back deterministically;
  • recovery is bounded to one assembly/review pass.
• Added richer public answer composition:
  • direct/document/graph evidence budgets are selected by answer profile;
  • public output strips source-authored scaffolding labels such as Prerequisite:, Mechanism:, and Failure mode: while preserving meaningful step labels;
  • compare answers rank evidence by operands and graph intent, and do not promote procedure-like evidence unless the query is about procedures;
  • how-to answers preserve steps, prerequisites, downstream checks, and failure handling;
  • causal answers preserve mechanism, consequence, and boundary evidence.
• Added release-review completeness improvements:
  • rag_answer_completeness now checks required RAG roles and profile-specific signals;
  • drafts missing pack-backed prerequisites, failure handling, mechanisms, consequences, or boundaries are revised from the RAG pack;
  • rag_claim_citation_support contracts unsupported or weakly supported public claims.

Conflict, Qualifier, and Graph Guardrails

• Expanded controlled conflict detection across:
  • measurements and tolerances;
  • dates and release dates;
  • state/status values;
  • quantity and retry limits;
  • location facts;
  • ownership identity facts;
  • endpoint, dependency, format, protocol, semantic-version, service-port, and response-status-code facts.
• Added false-positive guards for scoped qualifiers:
  • temporal current-vs-historical facts;
  • environment-scoped facts;
  • version-scoped facts;
  • platform-scoped facts;
  • cross-document condition-scoped facts.
• Added graph-intent ranking and filtering:
  • comparison queries prefer analogy/contrast neighbors over procedural sequence edges;
  • graph neighbors outside the resolved conversation scope are filtered before evidence assembly;
  • in-scope graph-neighbor source-window failures degrade explicitly instead of silently becoming complete graph support.
• Added runtime probe fixtures under Knowledge_Base/ for:
  • full-document remote-scan hard negatives;
  • cross-document conflicts;
  • temporal/environment/version/platform qualifiers;
  • graph intent;
  • context overflow;
  • repeated snippet anchoring;
  • causal answer profile budgets.

Agent Workspace and Frontend UX

• Added and hardened Agent Workspace frontend runtime surfaces:
  • agent_workspace.js
  • agent_workspace_runtime.js
  • workspace_panes.js
  • localized en / zh status strings
  • modular runtime bridge files and state modules
• Improved Knowledge Workspace visibility for API/RAG state:
  • compact evidence status;
  • provider/runtime readiness indicators;
  • RAG sufficiency and degradation summaries;
  • trace-friendly answer/evidence panes without adding extra chat messages.
• Preserved knowledge-point-oriented evidence display:
  • same knowledge point hits are grouped instead of duplicated;
  • public answers stay natural while trace/export surfaces retain raw evidence details.
• Added frontend contract and runtime behavior tests covering Agent Workspace API parity, runtime behavior, localization, and UI contract surfaces.

Learning Platform, Storage, and Export

• Expanded the learning platform into typed domain boundaries:
  • KnowledgeIngestor
  • KnowledgeQuerier
  • ConversationManager
  • MasteryEngine
  • QualityEvaluator
  • TutorRouter
  • MemoryPolicyManager
• Added or strengthened:
  • knowledge store and persistence tests;
  • query backend tests and external HTTP integration coverage;
  • vector acceleration adapter contracts;
  • runtime capability detection;
  • memory governance;
  • workflow artifact store;
  • resource and workspace registries;
  • indexing lifecycle and segment/unit builders.
• Added answer grounding export support:
  • final public answer claims map to citation ids, RAG fragment ids, source paths, and support status;
  • workspace export bundles deep-clone trace mappings so replay/export consumers can audit grounding without mutable runtime references.

NoteMD, Markdown, and Reader Runtime

• Expanded NoteMD operation surfaces:
  • CLI parser/dispatcher/commands;
  • operation registry and capability manifest;
  • config profile commands;
  • provider diagnostics, provider templates, and provider profiles;
  • Tavily and DuckDuckGo search provider adapters.
• Added diagram-generation planning and response parsing for NoteMD workflows.
• Hardened Mermaid and Markdown handling:
  • Mermaid fence guardrails;
  • browser Mermaid runtime embedding;
  • Resvg runtime embedding;
  • reader renderer coverage;
  • reader and Markdown runtime frontend updates.
• Added regression and contract tests for NoteMD API, CLI, workflow, batch, diagram, app-config, provider templates, and server integration behavior.

Desktop, Tauri, Godot, Path Mode, and Multi-Platform Runtime

• Hardened Tauri sidecar handling:
  • sidecar cleanup;
  • sidecar supply readiness;
  • sidecar validation;
  • sidecar relaunch contracts;
  • sidecar signatures and replacement boundaries;
  • Godot sidecar bootstrap and mirror checks.
• Added Agent Workspace Tauri verification scripts:
  • browser runtime verification;
  • Tauri runtime verification;
  • Tauri window evidence capture;
  • Tauri Rust strict checks;
  • evidence index, manifest, summary, and release-fragment rendering.
• Strengthened PathBridge and runtime transport boundaries:
  • strict schema verification;
  • handshake contracts;
  • runtime port fallback contracts;
  • runtime heap/spool/transport policies;
  • request trace middleware and modular route registration.
• Updated Godot / Path Mode surfaces:
  • reader render client;
  • path renderer;
  • settings panel;
  • WebSocket client;
  • path mode UI and shader updates.
• Expanded Android / Capacitor / mobile governance:
  • Android path mode contracts and smoke checks;
  • Detox pipeline verification;
  • privacy manifest verification;
  • Capacitor runtime, device, bridge, storage, and evidence contracts.

WASM, Performance, and Foundation Runtime

• Added or strengthened WASM parity runtime gates:
  • artifact provisioning;
  • runtime functional checks;
  • output equivalence;
  • benchmark contracts;
  • benchmark guard contracts;
  • history gates.
• Added foundation runtime verification:
  • SQLite runtime contracts and matrix/soak scripts;
  • ANN runtime contracts and release evidence scripts;
  • release evidence verification and multi-host readiness checks.
• Added platform utilities:
  • platform capability detection;
  • render materializer;
    -...

smoke-lfs-mirror-first-20260408-003325

Automated desktop multi-OS release assets.

smoke-lfs-mirror-first-20260408-002012

Automated desktop multi-OS release assets.

godot-mirror-v4.3-stable

Project-controlled mirror for Godot desktop bootstrap archives.

smoke-lfs-mirror-only-20260408-064620

Automated desktop multi-OS release assets.

smoke-lfs-mirror-first-20260408-061731

Automated desktop multi-OS release assets.

smoke-lfs-mirror-first-20260408-002917

Automated desktop multi-OS release assets.

NoteConnection v1.7.0

NoteConnection v1.7.0

English

Release Scope

• Compare baseline: v1.6.8..v1.7.0
• Commits: 16
• Files changed: 36
• Churn: +6,539 / -67

Highlights

• Finalized startup acceleration rollout with Phase 2/3/4 runtime improvements:
  • startup delta tick transport (full|delta) with low-alpha adaptive policies
  • frame-coalesced startup tick application on main thread to reduce redundant paints
  • staged edge rendering and startup overlay stabilization flow
• Hardened warm-start reliability with strict snapshot validation:
  • fingerprint and topology consistency checks
  • snapshot age guard
  • position coverage threshold checks before restore
• Extended startup validation automation for release readiness:
  • baseline vs pilot compare report
  • platform matrix report + strict watch mode
  • no-hardware engineering signoff pipeline (Windows real logs + simulated cohorts)

Subsystem Notes

• Frontend Runtime (app.js / simulationWorker.js):
  • Added low-alpha epsilon/full-sync controls and delta payload optimization.
  • Added startup tickSummary telemetry attached to T5 stable_layout checkpoint.
• Startup Perf Toolchain (scripts/):
  • Added compare/matrix/watch/simulate/cohort/signoff workflow integration and guardrails.
• Docs and Contracts (Diataxis EN/ZH):
  • Synced runtime contract docs for new startup profile fields and telemetry semantics.
  • Added bilingual roadmap docs for knowledge-mastery evolution and linked them into docs nav/map.
• Version Metadata:
  • Aligned package.json, package-lock.json, and src-tauri/tauri.conf.json to 1.7.0.

Operational Boundary

• Engineering signoff can proceed with no-hardware flow.
• Release signoff for cross-platform quality still requires real macOS/Android/iOS cohort evidence.

---

中文

发布范围

• 对比基线：v1.6.8..v1.7.0
• 提交数：16
• 变更文件数：36
• 代码/文档变更量：+6,539 / -67

版本亮点

• 启动提速 Phase 2/3/4 能力完成收口：
  • 启动期 full|delta Tick 传输与低 alpha 自适应策略
  • 主线程启动 Tick 帧级合并应用，减少冗余重绘
  • 分阶段边渲染与启动遮罩稳定化链路
• Warm Start 恢复可靠性加固：
  • 指纹与拓扑一致性校验
  • 快照时效保护
  • 应用前位置覆盖率阈值校验
• 启动性能验证自动化链路扩展：
  • baseline/pilot 对比报表
  • 多平台矩阵报表与严格 watch 门禁
  • 无多端硬件场景的工程签收流水线（Windows 真实日志 + 模拟 cohorts）

子系统说明

• 前端运行时（app.js / simulationWorker.js）：
  • 新增低 alpha 阶段 epsilon/full-sync 自适应调参与 delta 载荷优化。
  • 在 T5 stable_layout 增加 tickSummary 启动观测输出。
• 启动性能工具链（scripts/）：
  • 完成 compare/matrix/watch/simulate/cohort/signoff 全链路脚本化与门禁衔接。
• 文档与契约（Diataxis 中英双语）：
  • 同步新增启动 profile 字段与观测契约语义。
  • 新增“知识彻底掌握演进”双语路线文档并接入导航与映射。
• 版本元数据：
  • package.json、package-lock.json、src-tauri/tauri.conf.json 统一到 1.7.0。

运维边界

• 工程签收可使用 no-hardware 流程。
• 跨平台发布签收仍需真实 macOS/Android/iOS cohort 证据。

v1.6.8

NoteConnection v1.6.8

English

Release Scope

• Compare baseline: v1.6.7..v1.6.8
• Commits: 1
• Files changed: 7
• Churn: +157 / -31

Highlights

• Fixed the tauri.sidecar.cleanup contract expectation so release CI recognizes the new markdown-worker sidecar and no longer blocks npm publish on a stale assertion.
• Added explicit release-note quality discipline in AGENTS.md, including bilingual section requirements and subsystem-oriented release narrative standards.
• Backfilled and strengthened v1.6.7 release notes so the published release body stays aligned with the real shipped delta across runtime, packaging, CI, and docs surfaces.

Release Pipeline Reliability

• Updated src/tauri.sidecar.cleanup.contract.test.ts to match the runtime sidecar list (server, godot, markdown-worker), removing the false-negative test failure that previously stopped the npm release stage.
• Kept the release path aligned with existing automation triggers (tag push and GitHub Release publication) so the npm workflow remains idempotent and reproducible.

Documentation and Governance

• Extended AGENTS.md with a dedicated "Release Notes Discipline" section to enforce:
  • bilingual ## English and ## 中文 split,
  • compare baseline declaration,
  • subsystem-grouped concrete highlights,
  • direct publish-ready release body quality.
• Refined docs/release_notes_v1.6.7.md content structure and detail depth to match repository release quality expectations.

Version Metadata

• Bumped release metadata to 1.6.8 in:
  • package.json
  • package-lock.json
  • src-tauri/tauri.conf.json

Release Notes

• This patch release focuses on release reliability and documentation quality control: it unblocks the npm pipeline regression, standardizes release-note governance, and keeps bilingual release communication consistent.

---

中文

发布范围

• 对比基线：v1.6.7..v1.6.8
• 提交数：1
• 变更文件数：7
• 代码/文档变更量：+157 / -31

版本亮点

• 修复 tauri.sidecar.cleanup 契约测试中的旧断言，使发布 CI 能正确识别新增的 markdown-worker sidecar，避免 npm 发布被误拦截。
• 在 AGENTS.md 新增发布说明质量约束，明确双语分段与按子系统组织的发布叙事标准。
• 回填并增强 v1.6.7 发布说明细节，确保已发布版本正文与实际交付变更（运行时、打包、CI、文档）一致。

发布链路可靠性

• 更新 src/tauri.sidecar.cleanup.contract.test.ts，将运行时 sidecar 列表对齐为 server、godot、markdown-worker，消除此前阻断 npm 发布阶段的误报测试失败。
• 保持发布流程与既有自动化触发机制（tag push + GitHub Release 发布）一致，确保 npm 工作流具备幂等与可复现性。

文档与治理

• 在 AGENTS.md 增补 "Release Notes Discipline" 章节，强制要求：
  • ## English 与 ## 中文 双语分段，
  • 明确 compare baseline，
  • 按子系统组织具体亮点，
  • 发布文案可直接用于 GitHub Release 正文。
• 细化 docs/release_notes_v1.6.7.md 的结构与信息密度，使其达到仓库既定发布质量基线。

版本元数据

• 将以下文件版本统一提升到 1.6.8：
  • package.json
  • package-lock.json
  • src-tauri/tauri.conf.json

发布说明

• 本次补丁版本聚焦发布可靠性与文档质量治理：既修复 npm 发布链路回归点，也统一双语发布说明标准，保障后续发版稳定执行。

v1.6.7

NoteConnection v1.6.7

English

Release Scope

• Compare baseline: v1.6.6..v1.6.7
• Commits: 5
• Files changed: 56
• Churn: +6,021 / -862

Highlights

• Added a packaged markdown-worker sidecar across desktop targets and wired the new runtime through the frontend reader, NoteMD bridge, Tauri packaging, and validation scripts.
• Extended the embedded reader/path-mode experience with richer panel refresh, settings synchronization, and markdown rendering flow updates spanning frontend, server, and Godot integration code.
• Replaced legacy external docs-publish runbooks with project-owned bilingual GitHub Pages release/rollback guidance and aligned Diataxis/governance references to the new canonical docs.

Markdown Worker and Reader Runtime

• Added tools/markdown_worker Rust binary and platform packaging paths for Windows, Linux, and macOS.
• Introduced src/markdown/MarkdownGateway.ts plus contract/integration coverage for markdown worker runtime selection and server integration.
• Updated sidecar build, validation, cleanup, and readiness scripts so the markdown worker is treated as a first-class Tauri sidecar during dev/build/test flows.
• Expanded frontend reader and NoteMD integration surfaces:
  • src/frontend/reader.js
  • src/frontend/notemd.js
  • src/frontend/settings.js
  • src/server.ts

Docs Publishing and Release Operations

• Switched docs publishing away from the removed external EdgeOne runbook to repo-owned GitHub Pages runbooks:
  • docs/en/docs_release_and_rollback.md
  • docs/zh/docs_release_and_rollback.md
• Added GitHub Pages preflight/auto-enable logic in .github/workflows/docs-github-pages-publish.yml so docs deployments can self-heal common Pages configuration drift.
• Hardened npm-publish.yml with version-existence guarding to keep npm publish idempotent when both tag-push and release events fire for the same version.
• Aligned release metadata for 1.6.7 in package/Tauri manifests and refreshed README + Diataxis references to match the new operator workflow.

Stability and Verification

• Added regression coverage for markdown gateway runtime routing, app-config persistence, server integration, and embed refresh behavior.
• Kept Tauri preflight cleanup/ensure scripts in the verification path so stale copied sidecars are removed before dev/build/test flows start.
• Preserved bilingual release-note structure so GitHub Release text can be published directly from this document without post-hoc rewriting.

Release Notes

• This release is not just a docs-only cut: it delivers the new markdown worker runtime, expands embedded reader integration, and hardens GitHub Pages plus npm release operations around that rollout.
• The compare window remains tightly scoped to v1.6.6..v1.6.7, so the notes above are intended to map directly to the actual shipped delta.

---

中文

发布范围

• 对比基线：v1.6.6..v1.6.7
• 提交数：5
• 变更文件数：56
• 代码/文档变更量：+6,021 / -862

版本亮点

• 为桌面端新增可打包的 markdown-worker sidecar，并把该运行时完整接入前端阅读器、NoteMD 桥接、Tauri 打包与校验脚本。
• 扩展嵌入式阅读器 / Path Mode 体验，补齐面板刷新、设置同步与 Markdown 渲染链路，覆盖前端、服务端与 Godot 集成代码。
• 用项目自有的双语 GitHub Pages 发布 / 回滚手册替换历史外部文档发布手册，并同步收敛 Diataxis / 治理文档的权威引用入口。

Markdown Worker 与阅读器运行时

• 新增 tools/markdown_worker Rust 二进制，并补齐 Windows、Linux、macOS 的打包路径。
• 引入 src/markdown/MarkdownGateway.ts，并补充 markdown worker 运行时选择与服务端集成的契约 / 集成测试。
• 更新 sidecar 的构建、校验、清理、就绪脚本，使 markdown worker 在 Tauri 的开发 / 构建 / 测试流程中成为一等 sidecar。
• 扩展前端阅读器与 NoteMD 集成面：
  • src/frontend/reader.js
  • src/frontend/notemd.js
  • src/frontend/settings.js
  • src/server.ts

文档发布与版本运维

• 将文档发布流程从已移除的外部 EdgeOne 手册切换到仓库自有 GitHub Pages 手册：
  • docs/en/docs_release_and_rollback.md
  • docs/zh/docs_release_and_rollback.md
• 在 .github/workflows/docs-github-pages-publish.yml 中增加 GitHub Pages 预检 / 自动启用逻辑，用于自恢复常见 Pages 配置漂移。
• 在 npm-publish.yml 中增加版本存在性保护，使同一版本同时被 tag push 与 release 事件触发时仍保持 npm publish 幂等。
• 对齐 1.6.7 的 package / Tauri manifest 版本元数据，并同步刷新 README 与 Diataxis 引用，保证运维入口一致。

稳定性与验证

• 增补 markdown gateway 运行时路由、app-config 持久化、服务端集成、嵌入式刷新行为的回归覆盖。
• 将 Tauri 预检清理 / ensure 脚本持续纳入验证链路，确保开发 / 构建 / 测试启动前不会遗留陈旧的复制 sidecar。
• 保持双语发布说明结构稳定，使 GitHub Release 文案可以直接从本文件发布，而不是事后再临时改写。

发布说明

• 本版本并非单纯文档整理，而是围绕新的 markdown worker 运行时上线，同步完成嵌入式阅读器集成与 GitHub Pages / npm 发布链路加固。
• 本说明严格对应 v1.6.6..v1.6.7 的实际变更窗口，便于后续直接作为 GitHub Release 正文使用。