Refactoring - #50

Merged

lawrenceching merged 214 commits into

mainfrom

Aug 30, 2026

Commits on Aug 15, 2026

docs: add anonymous telemetry consent dialog design

lawrenceching
and
cursoragent
committed
870a610
docs: add anonymous telemetry consent implementation plan

lawrenceching
and
cursoragent
committed
36447c9
feat(core): add anonymousTelemetryConsent to UserConfig

lawrenceching
and
cursoragent
committed
ddf6699
feat(ui): add consent helper and i18n for anonymous telemetry

lawrenceching
and
cursoragent
committed
4d3e6d5
feat(ui): add AnonymousTelemetryConsentDialog

lawrenceching
and
cursoragent
committed
2bf70d0
feat(ui): show anonymous telemetry consent on first launch

lawrenceching
and
cursoragent
committed
b9c5f3c
feat(ui): add anonymous telemetry toggle in General Settings

lawrenceching
and
cursoragent
committed
92e2689
docs: mark anonymous telemetry consent design as implemented

lawrenceching
and
cursoragent
committed
12f3d5c

Commits on Aug 16, 2026

docs: add apps/core importFolder design spec

lawrenceching
and
claude
committed
836ab18
feat(core-app): scaffold apps/core (package.json, tsconfig, vitest)
lawrenceching
committed
e345b00
feat(core-app): add Ports interfaces and network/logger adapters
lawrenceching
committed
2306798
feat(core-app): add NodejsFsAdapter and path helpers

lawrenceching
and
claude
committed
15f54c4
feat(core-app): add NetworkFsAdapter mapping FsPort to internal HTTP fs endpoints
lawrenceching
committed
9c43157
feat(core-app): add userConfig and metadata cache path resolution

lawrenceching
and
claude
committed
e715812

Commits on Aug 17, 2026

feat(core-app): add ImportJob model and in-memory JobStore

lawrenceching
and
claude
committed
b2b9ec5
feat(core-app): add runtime-agnostic NFO parser
lawrenceching
committed
b5c3485
feat(core-app): add TmdbClient on NetworkPort
lawrenceching
committed
750a046
test(core-app): cover TmdbClient Authorization header and guard seasons

lawrenceching
and
claude
committed
7108971
feat(core-app): add TvdbClient wrapping @smm/tvdb4 on NetworkPort

lawrenceching
and
claude
committed
054f2c2
feat(core-app): port episode filename pattern matching to core
lawrenceching
committed
22d6adb
test(core-app): cover recognizeEpisodes fallthrough ordering

lawrenceching
and
claude
committed
1833af1
feat(core-app): add media folder recognition orchestrator (NFO → id → search)

lawrenceching
and
claude
committed
51b2cc7
fix(core-app): swallow id-fetch errors so recognition falls through phases

lawrenceching
and
claude
committed
6b56ce6
feat(core-app): add importFolder pipeline orchestration (config→persist)

lawrenceching
and
claude
committed
5f0ea6d
feat(core-app): add Core class with importFolder API and job lifecycle

lawrenceching
and
claude
committed
4a2a554
feat(core-app): export public API and register apps/core scripts at repo root

lawrenceching
and
claude
committed
0f92c92
fix(core-app): apply final review findings (TVDB search lang, per-item catch, structural deps, invalid-path jobs, integration test)

lawrenceching
and
claude
committed
1f6cb3d
docs: mark apps/core importFolder implementation plan as implemented

lawrenceching
and
claude
committed
202bb08
docs: add apps/core read/query and unimport API design spec

lawrenceching
and
claude
committed
51eb44c
feat(core-app): add deleteFile to FsPort and both fs adapters

lawrenceching
and
claude
committed
146c088
feat(core-app): add getAppConfig/getUserConfig/getFolders/getMediaMetadata/unimportFolder to Core

lawrenceching
and
claude
committed
13cf7c5
docs: mark apps/core read/query and unimport API design as implemented

lawrenceching
and
claude
committed
1b9f165
docs: add display-folders V3 design (get-folders + useFoldersQuery)

lawrenceching
and
cursoragent
committed
bc3200c
docs: add display-folders V3 implementation plan

lawrenceching
and
cursoragent
committed
1ff84f3
feat(cli): wire core-app and lazy Core singleton for getFolders

lawrenceching
and
cursoragent
committed
0ea4f5e
feat(cli): add POST /api/get-folders via Core.getFolders

lawrenceching
and
cursoragent
committed
be9d6eb
feat(ui): add useFoldersQuery gated by smm.v3.enabled

lawrenceching
and
cursoragent
committed
66f1eac
feat(ui): Sidebar uses useFoldersQuery paths when smm.v3.enabled

lawrenceching
and
cursoragent
committed
1bf7aa6
feat(ui): invalidate folders query when UserConfig.folders changes (v3)

lawrenceching
and
cursoragent
committed
6d28212
docs: mark display-folders V3 design/plan as implemented

lawrenceching
and
cursoragent
committed
77b910b
fix(ui): invalidate folders query on single-folder import (v3)

lawrenceching
and
cursoragent
committed
6e8fe15

Commits on Aug 18, 2026

feat: route folder delete through Core.unimportFolder when v3 is enabled

lawrenceching
and
cursoragent
committed
ae9c119
fix(ui): register anonymousTelemetryConsent keys in i18next types

lawrenceching
and
cursoragent
committed
2414fe0
docs: add design for smm list CLI command

lawrenceching
and
cursoragent
committed
a1ec21c
feat(cli): add smm list to print imported folder paths

lawrenceching
and
cursoragent
committed
772fde5
fix(core): serialize smm.json reads and writes with a UserConfig mutex

lawrenceching
and
cursoragent
committed
fb2644f
feat(cli): add smm add to import a folder and wait for init

lawrenceching
and
cursoragent
committed
70a3237
feat(cli): add smm show and smm metadata for folder inspection

lawrenceching
and
cursoragent
committed
7523e50
feat(cli): add smm rm to unimport a media folder

lawrenceching
and
cursoragent
committed
efe902c
feat(core): failover TMDB/TVDB hosts and print honest smm add recognition progress

lawrenceching
and
cursoragent
committed
37bc4fd
feat(cli): add --skip-init and CLI e2e for folder commands

lawrenceching
and
cursoragent
committed
8feb5e0
feat(cli): add HTTP APIs matching smm folder commands

lawrenceching
and
cursoragent
committed
203146d
feat(cli): add smm config list/get/set with Core key validation

lawrenceching
and
cursoragent
committed
fae8892
docs: add Core.renameFolder design for Sidebar rename migration

lawrenceching
and
cursoragent
committed
cfc5b6a
docs: add Core.renameFolder implementation plan

lawrenceching
and
cursoragent
committed
b81661a
feat(core): add FsPort.rename for NodejsFsAdapter

lawrenceching
and
cursoragent
committed
845b28e
feat(core): stub NetworkFsAdapter.rename as Not Implemented

lawrenceching
and
cursoragent
committed
ea26d98
feat(core): add Core.renameFolder happy path

lawrenceching
and
cursoragent
committed
1651c4b
test(core): cover renameFolder unmanaged and missing metadata

lawrenceching
and
cursoragent
committed
09c371c

Commits on Aug 19, 2026

docs: add UI v3 rename-folder design

lawrenceching
and
cursoragent
committed
22042d6
feat: wire v3 folder rename through Core.renameFolder

lawrenceching
and
cursoragent
committed
7d53aca
docs: add Core tryToRecognizeFolder / applyPlan design

lawrenceching
and
cursoragent
committed
c45e78d
docs: add Core tryToRecognizeFolder implementation plan

lawrenceching
and
cursoragent
committed
443b20b
feat(core): add updateMediaFileMetadatas for recognize apply

lawrenceching
and
cursoragent
committed
de0fb74
feat(core): add plan file storage helpers

lawrenceching
and
cursoragent
committed
71a309f
feat(core): add Core.tryToRecognizeFolder

lawrenceching
and
cursoragent
committed
352f735
feat(core): add Core.getPlan and applyPlan for recognize

lawrenceching
and
cursoragent
committed
d6427b2
feat(cli): add smm try-to-recognize and apply

lawrenceching
and
cursoragent
committed
310a59f
fix(cli): register try-to-recognize and apply in index dispatcher

lawrenceching
and
cursoragent
committed
a925adb
docs: add Core tryToRenameFolder / applyPlan rename-files design

lawrenceching
and
cursoragent
committed
43bfa26
docs: add Core tryToRenameFolder implementation plan

lawrenceching
and
cursoragent
committed
3388cb7
feat(core): add plex/emby TV renameRules

lawrenceching
and
cursoragent
committed
0d65937
feat(core): build TV rename plan file entries

lawrenceching
and
cursoragent
committed
d44bcb5
feat(core): expand rename plan with associated files

lawrenceching
and
cursoragent
committed
aa3c710
feat(core): add FsPort.mkdir for rename parents

lawrenceching
and
cursoragent
committed
b23bb34
feat(core): add Core.tryToRenameFolder

lawrenceching
and
cursoragent
committed
05221d7
feat(core): applyPlan supports rename-files

lawrenceching
and
cursoragent
committed
beda3c9
feat(cli): add smm try-to-rename and apply rename-files

lawrenceching
and
cursoragent
committed
3ededf4
test(cli): expand recognize and rename-files e2e coverage

lawrenceching
and
cursoragent
committed
83d1c58
feat(core): add FsPort.writeBinaryFile and tmdbImageUrl

lawrenceching
and
cursoragent
committed
3610150
feat(core): add checkScrapeCompletion for scrape skip

lawrenceching
and
cursoragent
committed
04155a6
feat(core): add downloadScrapeImage for scrape pipeline

lawrenceching
and
cursoragent
committed
9e9700e
feat(core): add TMDB TV NFO build and XML for scrape

lawrenceching
and
cursoragent
committed
f3a1537
feat(core): add TMDB TV scrape task runners

lawrenceching
and
cursoragent
committed
d9fae8d
feat(core): add Core.scrapeFolder

lawrenceching
and
cursoragent
committed
e56530e
feat(cli): add smm scrape for TV folders

lawrenceching
and
cursoragent
committed
7f6bd44
docs: add Core.scrapeFolder spec and implementation plan

lawrenceching
and
cursoragent
committed
2d60457
test(cli): expand scrape e2e coverage

lawrenceching
and
cursoragent
committed
d46aead
test(cli): adopt .e2e.ts suffix for CLI e2e tests

lawrenceching
and
cursoragent
committed
700eae1

Commits on Aug 20, 2026

feat(scrape): Core media/DB parity, HTTP job API, and UI v3 path

lawrenceching
and
cursoragent
committed
52ba6ee
feat(cli): print matched mediaFiles tree in smm show

lawrenceching
and
cursoragent
committed
9d0abf7
feat(core): add renameEpisodeFile with shared rename preflight

lawrenceching
and
cursoragent
committed
f0e0bda
feat: expose renameEpisodeFile via CLI, AI tool, and MCP

lawrenceching
and
cursoragent
committed
fe09ce7
feat(cli): support smm --help and unified rename dispatch

lawrenceching
and
cursoragent
committed
2b4b74d

Commits on Aug 21, 2026

feat(scrape): wire AI and MCP scrape/get-job tools with e2e

lawrenceching
and
cursoragent
committed
ff2e3a0

Commits on Aug 22, 2026

feat(core): add platform NetworkPort adapters with proxy and abort

lawrenceching
and
cursoragent
committed
8ff3599
feat(cli): add smm tmdb search with offline lang validation

lawrenceching
and
cursoragent
committed
bdd2417
feat(tmdb): add AI and MCP tools via Core v3 with e2e tests

lawrenceching
and
cursoragent
committed
808c3f1
feat(mcp): migrate MCP tool tests to MCP Inspector against smm mcp start
lawrenceching
committed
d1bef6b
docs(mcp): add README for test/mcp suite
lawrenceching
committed
42f69c7

Commits on Aug 23, 2026

ci: add e2e:mcp script to run mcp e2e tests
lawrenceching
committed
6daf12a
feat(mcp): move MCP lifecycle into Core and add CLI start/stop tests

lawrenceching
and
cursoragent
committed
62a2e78
feat(mcp): align Web UI with Core MCP APIs and honor local e2e ports

lawrenceching
and
cursoragent
committed
8d4b195
feat(mcp): add Core-style MCP RPC routes for HarmonyOS via core-routes

lawrenceching
and
cursoragent
committed
7f7edc6
docs(mcp): update status from draft to done in MCP server documentation
lawrenceching
committed
06e841e

Commits on Aug 24, 2026

Commits on Aug 25, 2026

docs: add design for smm tmdb tv/movie CLI commands

lawrenceching
and
cursoragent
committed
f39f768
feat(cli): add TMDB details tree formatter for tmdb tv/movie

lawrenceching
and
cursoragent
committed
de97e16
feat(cli): add smm tmdb tv and tmdb movie get-by-id commands

lawrenceching
and
cursoragent
committed
bee044c
test(e2e): cover smm tmdb tv/movie get and update TMDB docs

lawrenceching
and
cursoragent
committed
9fcce8f
docs: add design for smm tvdb tv/movie raw API CLI commands

lawrenceching
and
cursoragent
committed
70bb332
feat(core): add getTvdbSeriesById/getTvdbMovieById raw API helpers

lawrenceching
and
cursoragent
committed
1c6c820
feat(cli): add smm tvdb tv and tvdb movie raw get-by-id commands

lawrenceching
and
cursoragent
committed
a45c530
test(e2e): cover smm tvdb tv/movie get and update TVDB docs

lawrenceching
and
cursoragent
committed
03a947d
chore(e2e): finish CLI testbed split and expand tmdb get coverage

lawrenceching
and
cursoragent
committed
ffae863
docs: add design for CLI manage-plan commands

lawrenceching
and
cursoragent
committed
cff57d1
feat: align rename-episodes with try/reject/apply plan APIs

lawrenceching
and
cursoragent
committed
d9f0956
docs: add docs recognize-folder.md
lawrenceching
committed
b01996e
docs: add design for CLI smm recognize (folder)

lawrenceching
and
cursoragent
committed
566be7a
docs: add implementation plan for smm recognize folder

lawrenceching
and
cursoragent
committed
6b4a98d
feat(core): add recognizeFolder pipelines

lawrenceching
and
cursoragent
committed
07ef593
feat(core): expose tryToRecognizeFolder and recognizeFolder

lawrenceching
and
cursoragent
committed
6704188
refactor(core): rename tryToRecognizeFolder episodes pipeline to tryToRecognizeEpisodes

lawrenceching
and
cursoragent
committed
a8a9bea
feat(cli): add smm recognize command

lawrenceching
and
cursoragent
committed
921f729
test(e2e): cover smm recognize folder

lawrenceching
and
cursoragent
committed
16209d7
fix(cli): register recognize in cliCommands dispatch set

lawrenceching
and
cursoragent
committed
7328cde
docs: document smm recognize --yes

lawrenceching
and
cursoragent
committed
d8ae856

Commits on Aug 26, 2026

docs: update docs
lawrenceching
committed
8968169
feat(ui): wire folder recognition to POST /api/recognize-folder

lawrenceching
and
cursoragent
committed
a93e625
feat(ui): route TVDB search through POST /api/search-in-tvdb

lawrenceching
and
cursoragent
committed
1de41f8

Commits on Aug 27, 2026

feat(core): add config/metadata helpers and import library flow

lawrenceching
and
cursoragent
committed
abcc163
feat(core): two-phase importLibrary with batch folder registration

lawrenceching
and
cursoragent
committed
a9c087d
feat: import-library per-folder tasks with live UI metadata refresh

lawrenceching
and
cursoragent
committed
4f2f03e
fix(e2e): wait for import-library job before metadata assertions

lawrenceching
and
cursoragent
committed
34f3d8a
feat(core): move TMDB asset scrape failover into core with unit tests

lawrenceching
and
cursoragent
committed
e01b642
feat(core): add TMDB/TVDB host speed tests, selection, and TCP-only failover

lawrenceching
and
cursoragent
committed
9351fc5
fix(e2e): deprecate removeDirInSidebar option in setup function
lawrenceching
committed
e75a8f0
fix(ui): map preferMediaLanguage to ISO 639-3 for TVDB v3 search

lawrenceching
and
cursoragent
committed
a00a3df

Commits on Aug 28, 2026

ci: add GitHub Actions job for CLI bun:test e2e

lawrenceching
and
cursoragent
committed
b146878
ci: extract CLI e2e into reusable workflow with standalone dispatch

lawrenceching
and
cursoragent
committed
f475609
fix(ui): resolve eslint react-hooks lint errors
lawrenceching
committed
3a0bd9f
fix: make pnpm run typecheck pass across all packages
lawrenceching
committed
57029ec
fix(docker): copy apps/core into cli build context
lawrenceching
committed
ce49e6c
fix(core): extend rename-episode-file to support movie folders

lawrenceching
and
cursoragent
committed
057706e
test: remove deprecated test
lawrenceching
committed
59962dc
fix(ci): restore CLI executable bit after artifact download

lawrenceching
and
cursoragent
committed
d1deff2
fix(test): create user config directory before reset on CI

lawrenceching
and
cursoragent
committed
21c50e7
fix(e2e): align CLI test metadata paths with Core userDataDir on Linux

lawrenceching
and
cursoragent
committed
c8a992a
test: clean up test cases
lawrenceching
committed
78ad8f0

Commits on Aug 29, 2026

docs: design create-rename-episode-plan Core API and single AI/MCP tool

lawrenceching
and
cursoragent
committed
f77b67e
docs: add create-rename-episode-plan implementation plan

lawrenceching
and
cursoragent
committed
46c0254
feat(core): add createRenameEpisodePlanPipeline

lawrenceching
and
cursoragent
committed
56717f8
feat(core): expose createRenameEpisodePlan; tryToRenameFolder reuses it

lawrenceching
and
cursoragent
committed
030103a
fix(cli): use Core userDataDir for plan HTTP routes on Linux

lawrenceching
and
cursoragent
committed
fa063cc
fix(cli): align remaining plan hosts with userDataDir

lawrenceching
and
cursoragent
committed
c3e98a2
feat(core): replace rename begin/add/end tool types with create-rename-episode-plan

lawrenceching
and
cursoragent
committed
371eb95
feat(cli): HTTP/debug create-rename-episode-plan via Core; remove V2 rename tools

lawrenceching
and
cursoragent
committed
035d438
fix(cli): avoid double Error Reason prefix on create-rename-episode-plan

lawrenceching
and
cursoragent
committed
17f4577
feat(core-routes): single create-rename-episode-plan MCP tool

lawrenceching
and
cursoragent
committed
27e5ff4
fix(core-routes): always broadcast RenameFilesPlanReady from create-rename-episode-plan

lawrenceching
and
cursoragent
committed
743ad14
feat(ui): single CreateRenameEpisodePlan AI tool

lawrenceching
and
cursoragent
committed
f20a24d
test(e2e): AiTool-RenameTool uses create-rename-episode-plan

lawrenceching
and
cursoragent
committed
74d1be9
docs: document create-rename-episode-plan; remove begin/add/end rename docs

lawrenceching
and
cursoragent
committed
14b9806
docs: show populated files in createRenameEpisodePlan debug example

lawrenceching
and
cursoragent
committed
2ede545
fix(e2e): migrate MCP rename specs to create-rename-episode-plan

lawrenceching
and
cursoragent
committed
6a2cff5
test: fix test failure
lawrenceching
committed
133afd6
fix(cli): resolve core-app subpath imports in vitest

lawrenceching
and
cursoragent
committed
27d6dc1
fix(core-routes): narrow createRenameEpisodePlan test result for tsc

lawrenceching
and
cursoragent
committed
7525116
fix(cli): type response.json() in create-rename-episode-plan tests

lawrenceching
and
cursoragent
committed
e321aa1
docs: add Core media metadata CRUD design

lawrenceching
and
cursoragent
committed
3486fdb
docs: add Core media metadata CRUD implementation plan

lawrenceching
and
cursoragent
committed
5bca562
refactor(core): drop MediaMetadata.files and add metadata RPC types

lawrenceching
and
cursoragent
committed
0955236
feat(core): add metadata patch whitelist helper and typed errors

lawrenceching
and
cursoragent
committed
e92334e
feat(core): metadata CRUD API and separate config/data dirs

lawrenceching
and
cursoragent
committed
048af3f
fix(core): use metadata root for scrape/recognize pipelines

lawrenceching
and
cursoragent
committed
d1bb0cc
feat(cli): add get/create/set/delete-metadata RPC bridges

lawrenceching
and
cursoragent
committed
a69a2db
fix(cli): map metadata RPC validation failures to 400

lawrenceching
and
cursoragent
committed
1cd3551
fix(cli): validate metadata RPC field types

lawrenceching
and
cursoragent
committed
90e72cf
feat(ui): read/write media metadata via Core HTTP RPCs

lawrenceching
and
cursoragent
committed
e851c71
refactor(ui): stop persisting metadata via writeFile cache paths

lawrenceching
and
cursoragent
committed
80ef8c5
test(e2e): add browser helpers for metadata HTTP CRUD

lawrenceching
and
cursoragent
committed
c95bb10
chore(cli): remove legacy read/write MediaMetadata file routes

lawrenceching
and
cursoragent
committed
9bf4064
fix(e2e): stabilize movie rename context menu on Windows

lawrenceching
and
cursoragent
committed
6f37b44
fix(core): strip legacy files on metadata read; strict create schema

lawrenceching
and
cursoragent
committed
5678e3a

Commits on Aug 30, 2026

ci: fix ci failure
lawrenceching
committed
fa25b0e
docs: update AGENTS.md
lawrenceching
committed
b6a07ce
ci: fix ci failure
lawrenceching
committed
0d08c7b
fix(ci): resolve create-metadata strict schema and plan path mismatches

lawrenceching
and
cursoragent
committed
3863646
fix(docker): copy apps/core into UI build image

lawrenceching
and
cursoragent
committed
df2e72b
fix(cli): point MCP, chat, and plan routes at appDataDir

lawrenceching
and
cursoragent
committed
b8a314b
fix(ui): keep live folder files after metadata persist

lawrenceching
and
cursoragent
committed
97c5f49
fix(ci): drop stale httpproxy specs and files assert

lawrenceching
and
cursoragent
committed
b70792c