obsidian-plugin/lllin000_PaperForge
1
0
Fork 0
mirror of https://github.com/lllin000/PaperForge.git synced 2026-07-22 17:00:23 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
lllin000_PaperForge/project/current/ocr-v2-active-queue.md

7.3 KiB
Raw Blame History

OCR-v2 Active Queue

Status: OCR-v2 is stable; #75 canonical setup/config migration and #76 Installation/Help capability tracer are implemented; #77 Managed Runtime lifecycle is the next unblocked control-center slice. Last updated: 2026-07-15

Current checkpoint

  • Retrieval recovery is merged to master; the real Literature-hub vault has a healthy 2560-dimensional vec0 index and working M / @ search paths.

  • OCR rebuild: streaming progress + maintenance UI redesign is implemented and reviewed.

  • Multi-key ocr rebuild and full ocr redo emit separate, flushed progress streams and accept a cross-platform cooperative stop request between papers.

  • The maintenance tab now exposes all papers plus the canonical _needs_derived_rebuild() recommendation set, selected batch actions, an above-table progress state, and full refresh on completion.

  • Per-row maintenance actions now route through maintenanceActionForRow() — rebuild/redo follow the canonical backend display_action rather than raw booleans.

  • Destructive redo requires user confirmation via maintenanceActionRequiresConfirmation().

  • Cache refresh preserves the backend manifest (was overwriting it with empty on each refresh).

  • Source Corpus data remains authoritative and was not modified during verification. Only the deployed plugin bundle and disposable maintenance cache were refreshed.

  • Current-contract audit identified the migration boundary: preserve durable OCR/SQLite truth and recovery actions; replace global setup state, duplicate runtime/config resolution, and freshness-free snapshots.

  • Obsidian-native research preserves the six-module IA, progressive setup, capability-gated commands, and minimal transient status chrome.

  • Desktop runtime/recovery research establishes module-scoped repair, compatibility-gated updates, local redacted diagnostics, and user-reviewed issue drafts.

  • #69 resolved at issuecomment-4971161072: orthogonal availability/activity/attention axes, 6-state capability ordinal, 12 canonical verbs, backend-owned severity and primary actions, maintenance projection.

  • #70 resolved at issuecomment-4971239398: plugin-managed immutable runtime slots, system-Python bootstrap with validated-triplet fallback, single active-runtime.json pointer, ManagedRuntime class with current()/status()/ensure(), fail-closed command resolution.

  • #71 resolved: six-module control-center HTML prototype with 5 scenarios, plain-button switcher, primary attention zone, responsive layout (768px breakpoint), and capability-gated actions. Independent Critical/Important PASS review. Design decisions recorded in docs/prototypes/2026-07-14-six-module-control-center.{html,md}.

  • #72 resolved: actionable-only maintenance inbox prototype with single-action rows, inline issue-draft review, local redacted export, and confirmation-first report flow. Independent Critical/Important PASS review. Design decisions recorded in docs/prototypes/2026-07-14-maintenance-issue-reporting.{html,md}.

  • #73 resolved: locked migration, security, platform, accessibility, and release-gate acceptance contract after five-domain audit and independent review.

  • #74 published: split into eight agent-ready issues (#75–#82) with native dependencies.

  • #75 implemented and reviewed: bare/headless/modular setup share SetupPlan; schema-v2 vault_config wins; v1 path keys are warned read fallback; all configured directories are forwarded; required failures return non-zero.

  • #76 implemented: schema-v1 Installation/Help probes flow through the six-module Overview; persisted malformed/stale envelopes fail closed; backend set_config/update actions route to setup; unimplemented modules remain explicit placeholders.

  • Wayfinder navigation refinement approved: preserve Overview and stage 概览 / 模块详情 / 维护 / 帮助 across #77/#78/#80. Installation owns Agent platform/Skills under Agent 集成; no empty placeholder detail pages.

Verification status

  • Focused Python OCR paths: 99 passed, 1 Windows SIGINT test skipped, 1 unrelated empty-result regression deselected.
  • Plugin: 93 passed; TypeScript check and production build passed.
  • Maintenance regression tests: 19/19 passed (canonical action routing, confirmation gate, cache manifest preservation).
  • Live Obsidian verification: PaperForge 1.5.15 loaded without captured errors; maintenance rendered 734 All rows and 700 Recommended rows from the canonical backend flag.
  • Live progress-state harness showed the floating progress bar, current key, Stop control, and disabled row actions.
  • Prototype #71 (control center): Critical PASS (5/5), Important PASS (11/11) — independent reviewer dimensions confirmed.
  • Prototype #72 (maintenance inbox): Critical PASS (4/4), Important PASS (6/6) — independent reviewer dimensions confirmed.
  • Both prototypes browser-verified at 768px viewport with scenario-switching, action-button interactions, expand/collapse diagnostics, and issue-draft flow.
  • Issue #75 verification: 61/61 focused tests passed; independent review returned Spec PASS / Quality APPROVED.
  • Issue #76 verification: 21/21 backend probe tests and 169/169 plugin tests passed; TypeScript check and production build passed; live Obsidian stale-cache/action-label smoke test and independent review passed.
  • No production plugin code was modified during prototype work.
  • The repository-wide Python suite remains blocked during collection by the pre-existing test_pr9a_resume_rebuild.py import of removed _assert_collections_healthy.

Frontier

  • Prototype the six-module control center (#71).
  • Design the actionable-only maintenance inbox (#72).
  • Lock migration/acceptance contract (#73), publish PRD #74, and create dependency-linked issues #75–#82.
  • Canonicalize setup and configuration migration (#75).
  • Implement #76: Installation/Help capability envelope through the existing settings surface.
  • Start #77 in a fresh Matt /implement session: Managed Runtime lifecycle plus the approved Installation-detail navigation shell.

Deferred

  • Vector rebuild UX (PRD Slice 1): deferred.
  • Memory/global maintenance cleanup (PRD Slice 3): deferred.
  • OCR ETA and real-time per-row mutation: out of scope for the completed OCR slice.
  • Release N+1/N+2 owner cutover and shim deletion remain blocked by their native issue dependencies (#81/#82).