4 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
tao.chenandClaude	6e6c79f43a	docs: add v0.0.1 changelog entry ... Records the initial development release covering all features shipped in commits cd1aba6 / bc1828b / 3476517: manual snapshot commit flow, sidebar timeline, cell diff, restore, skip-on-duplicate, Local + S3 storage adapters, S3ConnectionError diagnostics, envelope- embedded snapshot files, traitlets config, and the DEVELOPER.md manual. Co-Authored-By: Claude <noreply@anthropic.com>	2026-07-21 18:28:22 +08:00
tao.chenandClaude	3476517479	docs: add DEVELOPER.md (architecture, build, debug, packaging) ... Developer-facing manual covering: 1. Architecture overview with the four-layer data flow diagram 2. Repository layout (src/, snapshot/, storage/, etc.) 3. Dev environment setup (one-time + daily) and the 'what to restart after what type of change' table 4. Common commands quick reference 5. Debugging: backend (server logs, curl), frontend (browser DevTools, console.log diagnostic points, React/Lumino inspection), and end-to-end symptom -> cause table 6. Packaging and release (PyPI wheel via hatch + jupyter-builder, version sourced from package.json, git tag flow, CI) 7. Known pitfalls: jest+pnpm linker incompatibility, S3 strong consistency variance, conda/npm gotchas 8. 5-minute quickstart for new contributors User-facing concerns (install/config/troubleshoot) stay in README.md; design goals stay in design.md; AI coding rules stay in AGENTS.md. DEVELOPER.md slots in for engineer handoff / onboarding. Co-Authored-By: Claude <noreply@anthropic.com>	2026-07-21 18:26:11 +08:00
tao.chenandClaude	bc1828bde6	fix: surface hash-duplicate warning and add manual refresh ... Three issues fixed: 1. **Skipped-commit warning not visible** — When the user commits unchanged content (hash matches most recent version), the backend correctly returns {skipped: true, reason: "unchanged", message: ...} but the frontend Notification.warning was easy to miss (default 4-5s autoClose, small toast at top-right). Now uses {autoClose: false} so the warning stays until manually dismissed, plus a console.log of the raw commit response for debugging. Added a fallback branch that warns clearly if the response shape is unexpected. 2. **No manual refresh on the panel** — In S3 setups the list call can occasionally lag the just-committed entry (manifest strong consistency is a per-implementation property). Added a "刷新" button at the top of the sidebar that calls model.refresh(), letting the user force a re-fetch when the auto-refresh misses. 3. **S3 addressing_style** — user-side config addition: S3Storage now uses path-style addressing (endpoint/bucket/key) which is the format required by MinIO and several other S3-compatible services. Co-Authored-By: Claude <noreply@anthropic.com>	2026-07-21 18:23:34 +08:00
tao.chenandClaude	cd1aba6698	dev: initial implementation of notebook-snapshot extension ... Manual-commit notebook snapshot extension (JupyterLab 4): Backend - Storage adapter layer (Local + S3 via boto3, pip extra) - Dumb put/get/list/delete contract; key validation - S3Storage: lazy boto3 import, S3ConnectionError with friendly messages + connectivity check at startup - SnapshotStore - Strip code outputs/execution_count, MD5 on cleaned JSON - Gzipped envelope (id/timestamp/name/description/hash/size/notebook) - Append-only manifest.json (rebuildable from version files) - SnapshotUnchangedError when new hash matches most recent version - REST API (commit / list / content) under /snapshot/ namespace - traitlets config (storage_type, local_root, s3_* + S3_* env fallback) Frontend - snapshot:commit command (toolbar button + command palette) - Dialog for name + description - SnapshotPanel (left sidebar timeline) + DiffWidget (main area) - Cell diff: id-match first, LCS fallback; jsdiff for line diff - Restore via model.fromJSON() + context.save() (no refresh) - All AGENTS.md hard conventions enforced Tests: 33 backend pytest passing (storage + store + routes) Docs: AGENTS.md, design.md, README.md synced with implementation. Co-Authored-By: Claude <noreply@anthropic.com>	2026-07-21 17:33:55 +08:00