Commit graph

80 commits

Author SHA1 Message Date
Research Assistant
97a2875d48 docs: reset documentation IA (readme entry pages, tutorial/troubleshooting split, AGENTS agent-only, pure command ref, maintainer guide)
Separate audiences: README as navigation entry, getting-started as canonical tutorial,
troubleshooting as failure recovery, AGENTS as agent-only operating contract,
COMMANDS as pure reference, maintainer-guide for release/versioning/architecture.
2026-05-16 22:47:00 +08:00
Research Assistant
d5956ec5b1 docs: v3 — snapshot mandate, degradation policy, first-launch migration, async refresh 2026-05-15 22:31:37 +08:00
Research Assistant
cfcc7fc471 docs: revise JS-first memory state — Python writes snapshots, JS reads files only 2026-05-15 22:24:26 +08:00
Research Assistant
e528a4eb7f docs: JS-native memory state — spec, plan, and UX audit 2026-05-15 22:11:45 +08:00
Research Assistant
075c9107bf docs: add memory runtime health spec and regression helpers 2026-05-15 01:29:54 +08:00
Research Assistant
28562811b1 chore: restore manifest version to match __init__ (1.5.6rc3) 2026-05-15 00:39:12 +08:00
Research Assistant
80db051d8c fix: add --resume CLI arg and get_collection import for embed build 2026-05-15 00:16:06 +08:00
Research Assistant
fb02280a7d spec: remove copy icon — clean click-to-copy with dashed underline only 2026-05-14 01:31:43 +08:00
Research Assistant
1e1acb2e82 spec: dashboard copy interaction + per-paper metadata enhancement 2026-05-14 01:21:52 +08:00
Research Assistant
8351319bcb docs(spec): 10-point memory layer performance optimization 2026-05-13 16:52:10 +08:00
Research Assistant
aa4c4991fd docs(spec): log format validation, reading-log import/lookup, methodology skill, dashboard SQLite 2026-05-13 16:02:50 +08:00
Research Assistant
8d3e4432c3 chore: add pre-commit JS syntax hook + stage missing vector CLI files 2026-05-12 23:34:24 +08:00
Research Assistant
9a48784b90 docs(spec): add Phase 7 vector retrieval — ChromaDB + local/API embedding + chunking 2026-05-12 21:43:34 +08:00
Research Assistant
55b5191d86 fix(spec): add DEFAULT_SETTINGS whitelist note, source: paperforge requirement, CLI toggle read 2026-05-12 21:19:21 +08:00
Research Assistant
85e35b0cfa docs(spec): plugin settings redesign — tabbed UI, skill manager, feature toggles, vector DB panel 2026-05-12 21:11:15 +08:00
Research Assistant
a886c9111d docs(spec): add Phase 6 — paper_events, reading/working logs, vector retrieval 2026-05-12 20:48:09 +08:00
Research Assistant
9dbdeaad46 test(memory): verify agent-context on test vault — 150 papers, 26 collections, 4 rules 2026-05-12 20:00:16 +08:00
Research Assistant
ad6812626e docs(plan): add agent-context implementation plan 2026-05-12 19:54:19 +08:00
Research Assistant
50f71a82ee docs(spec): add Memory Layer Phase 2-5 design (agent-context, dashboard, refresh, retrieve) 2026-05-12 19:44:38 +08:00
Research Assistant
8335bce992 bump: 1.5.5 -> 1.5.6rc1 (Memory Layer RC1) 2026-05-12 18:11:37 +08:00
Research Assistant
f244f72056 feat: restructure literature-qa v2 — SKILL.md as central hub with decision tree, add multi-reading, simplify refs 2026-05-11 23:58:46 +08:00
Research Assistant
fd0c25d608 fix(literature-qa): prohibit hardcoded path construction in skill references 2026-05-11 23:17:05 +08:00
Research Assistant
3a25c02836 docs: replace git+https install URLs with pip install paperforge (PyPI) 2026-05-11 19:25:38 +08:00
Research Assistant
2e0657479a feat: PyPI publish support — install paperforge from PyPI with git fallback 2026-05-11 18:04:17 +08:00
Research Assistant
566697fc31 chore: remove CI workflows pending rewrite 2026-05-11 17:00:23 +08:00
Research Assistant
30f9613482 merge: integrate dashboard-refine (deep-finalize + slug-freeze) into skill-refine
Resolved conflicts:
- styles.css: take dashboard-refine (more refined CSS)
- SKILL.md, deep-reading.md, paper-resolution.md: take skill-refine (modular skill redesign)
2026-05-10 23:28:13 +08:00
Research Assistant
9b88c441b0 refactor(skills): modular literature-qa skill with router-first architecture
- Replace 6 scattered pf-*.md files with single SKILL.md router + 4 reference files
- Add paper_resolver.py: deterministic key/DOI/field search (4 subcommands)
- Remove pf-sync/ocr/status (CLI-only commands, no skill wrapper needed)
- Move chart-reading/ into references/ for flat structure
- Make ld_deep.py --vault optional (auto-detect from cwd)
- Add 26 unit tests for paper_resolver
- All paths dynamically resolved from paperforge.json, zero hardcoding
2026-05-10 20:56:28 +08:00
Research Assistant
61822c8a94 docs: add dashboard ui refinement specs and plans 2026-05-10 20:52:21 +08:00
Research Assistant
d8a0d4d83e docs: align dashboard ux contract with refined ui 2026-05-10 20:52:21 +08:00
Research Assistant
d00977ccbb docs: update UX contract for redesigned dashboard with 3-mode views
- Replace W4-S3 (old lifecycle stepper) with new paper mode specs: status strip, overview card, discussion card, workflow toggles, files row, technical details
- Add W4-S4: workspace path detection keeps paper mode for fulltext.md
- Add W4-S5: global mode as system homepage
- Add W4-S6: workflow toggle checkboxes sync to Base via processFrontMatter (no extra sync needed)
2026-05-10 14:07:53 +08:00
Research Assistant
36a8ba8400 refactor(dashboard): Phase 1 cleanup - remove Copy Context, deep-reading dead code, static Quick Actions grid
- Delete Copy Context and Copy Collection Context from ACTIONS array
- Remove all _renderDeep* dead methods (StatusCard, Pass1Card, QACard)
- Remove _getPassCompletion and _extractPass1Content helpers
- Remove deep-reading mode case from _renderModeHeader
- Remove Copy Context handlers from _runAction
- Remove copy-context command palette registrations
- Delete static Quick Actions section from _buildPanel
- Delete _renderActions method
- Replace ready-state Copy Context fallback in _renderNextStepCard
- Add implementation plan at docs/superpowers/plans/
2026-05-10 13:44:50 +08:00
Research Assistant
0c888ced0d docs: remove control_dir from all user-facing documentation; add v1.4.17 changelog 2026-05-10 01:55:35 +08:00
Research Assistant
bbd39a90d3 v1.4.17rc4
Milestone v2.1: Contract-Driven Architecture & Engineering Hardening

- Stop the Bleeding: version sync checker, PyYAML hardening, install docs unification
- Contract Layer: PFResult/PFError dataclasses, ErrorCode enum, --json wrapping
- Service Extraction: sync.py decomposed into 3 adapters + SyncService
- State Machine: PdfStatus/OcrStatus/Lifecycle enums, transitions, field registry
- Setup Modularization: setup_wizard.py decomposed into 6 classes

173 tests passing, 0 regressions.
2026-05-09 17:05:07 +08:00
Research Assistant
341941ab09 feat(54-001): add UX contract and user journey tests
- docs/ux-contract.md: verifiable step sequences for install, sync, OCR, dashboard
- tests/journey/conftest.py: journey_fresh_vault, journey_established_vault, journey_cli_invoker fixtures with isolation guards
- tests/journey/test_onboarding.py: JNY-02 new user onboarding (sync -> OCR -> analyze -> deep-read)
- tests/journey/test_daily_workflow.py: JNY-03 existing user adds paper workflow
2026-05-09 00:52:55 +08:00
Research Assistant
f6d4b54032 docs(54-002): delete pip-first docs, update README.md and AGENTS.md references
- Delete docs/INSTALLATION.md (pip-first installation guide)
- Delete docs/setup-guide.md (detailed installation guide)
- Update README.md docs table: remove deleted file references
- Update AGENTS.md: replace deleted doc links with plugin-first install guidance
2026-05-08 17:47:39 +08:00
Research Assistant
76df98a63d docs(merge-gate): update planning state, roadmap, and agent documentation for milestone completion 2026-05-07 21:52:31 +08:00
Research Assistant
8447867f88 docs(48-textual-tui-removal): update docs for headless-only setup
- Replace all bare 'paperforge setup' with 'paperforge setup --headless'
- Rewrite Section 3 of setup-guide.md to describe headless-only workflow
- Update command reference table at Section 7.1 to use --headless
- Update INSTALLATION.md setup command and Better BibTeX section
2026-05-07 19:42:45 +08:00
Research Assistant
29edb2d811 fix: overhaul install flow clarity and non-destructive incremental setup
- Move Better BibTeX auto-export to post-install step (exports dir created by setup)
- Clarify wizard overview: show resources_dir/literature_dir/control_dir hierarchy
- Fix post-install flow order: BBT export → enable plugin → dashboard → sync
- Split do_ocr and analyze marks into separate steps (OCR before deep-reading)
- Mark all literature flags via Base views, not manual file editing
- Make installer incremental: preserve existing files, only create missing ones
- Remove destructive junction/link deletion in TUI wizard
- Merge .env instead of overwriting; skip overwrite for AGENTS.md, docs, plugin
- Update TUI, headless, and plugin completion output to match corrected flow
- Add regression test for non-destructive setup behavior
2026-05-06 22:47:07 +08:00
Research Assistant
da5b8f0c07 docs: update dashboard screenshot 2026-05-02 14:56:14 +08:00
Research Assistant
681f7a4ce4 docs: redesign README with banner and dashboard preview 2026-05-02 14:52:59 +08:00
Research Assistant
6b567d004f fix: update pip installs from GitHub source instead of package index 2026-04-29 00:16:13 +08:00
Research Assistant
4b7648efb0 docs(plan): multi-agent platform implementation plan 2026-04-28 16:00:58 +08:00
Research Assistant
fb934b7d40 docs(spec): add multi-agent platform design spec 2026-04-28 15:51:03 +08:00
Research Assistant
e5573a9c8c docs: split AI setup guide into EN and ZH versions 2026-04-28 15:01:31 +08:00
Research Assistant
506b6ef6d7 docs: bilingual AI setup guide — detect language, use matching prompts 2026-04-28 14:50:18 +08:00
Research Assistant
3ff375675a docs: bilingual AI install prompts, add cd-to-vault step 2026-04-28 14:44:44 +08:00
Research Assistant
91434f93df docs: Zotero data dir — auto-detect first, always let user override 2026-04-28 14:33:35 +08:00
Research Assistant
53ab3f1d07 docs: rewrite AI setup guide — ask ALL params, explain dirs, promote BBT JSON export 2026-04-28 14:33:35 +08:00
Research Assistant
859fa5ff97 feat: headless setup mode, Obsidian plugin, AI agent install guide (v1.4.2) 2026-04-28 14:33:35 +08:00
Research Assistant
ebc4fdeb00 chore: rename PaperForge Lite -> PaperForge across 27 files 2026-04-28 01:25:51 +08:00