Design organization dry-run plans and downstream profiles

david commented

2026-06-11 09:13:11 -07:00

Owner

Start M3 by designing and implementing organization dry-run planning from persisted scanner candidates.

Scope:

Generate non-destructive organization plans from candidates/assets.
Define Audiobookshelf-friendly output profile rules for author/series/title/narrator/disc folders and sidecars.
Keep Grimmory compatibility as a research dependency until canonical docs are confirmed.
Persist organization plan summaries and review actions before any apply/move/copy behavior.
Keep all file operations dry-run only until explicit apply safeguards are designed.

Start M3 by designing and implementing organization dry-run planning from persisted scanner candidates. Scope: - Generate non-destructive organization plans from candidates/assets. - Define Audiobookshelf-friendly output profile rules for author/series/title/narrator/disc folders and sidecars. - Keep Grimmory compatibility as a research dependency until canonical docs are confirmed. - Persist organization plan summaries and review actions before any apply/move/copy behavior. - Keep all file operations dry-run only until explicit apply safeguards are designed.

david added this to the M3 Organization and Downstream Profiles milestone

2026-06-11 09:13:11 -07:00

david commented

2026-06-11 13:35:12 -07:00

Author

Owner

First M3 organization checkpoint implemented.

Implemented:

internal/organization Audiobookshelf dry-run planner.
Non-destructive copy-shaped planned operations.
Narrator folder suffixes for audiobooks when evidence exists.
Disc N destination folders for multi-disc audiobooks.
Duplicate candidates routed to review.
Weak metadata routed to review.
Partial, unsupported, and sidecar-only candidates routed to hold.
organization_plans and organization_plan_actions persistence.
make check-organization fixture smoke command.

Verification:

make test passed.
make check-organization passed and produced 17 actions: 4 organize, 7 review, 6 hold.

Leaving #6 open for the next M3 step: expand organization planning from persisted scanner candidates and continue Grimmory compatibility research.

First M3 organization checkpoint implemented. Implemented: - `internal/organization` Audiobookshelf dry-run planner. - Non-destructive copy-shaped planned operations. - Narrator folder suffixes for audiobooks when evidence exists. - `Disc N` destination folders for multi-disc audiobooks. - Duplicate candidates routed to review. - Weak metadata routed to review. - Partial, unsupported, and sidecar-only candidates routed to hold. - `organization_plans` and `organization_plan_actions` persistence. - `make check-organization` fixture smoke command. Verification: - `make test` passed. - `make check-organization` passed and produced 17 actions: 4 organize, 7 review, 6 hold. Leaving #6 open for the next M3 step: expand organization planning from persisted scanner candidates and continue Grimmory compatibility research.

david commented

2026-06-11 15:35:16 -07:00

Author

Owner

Progress update: the organization dry-run foundation is now connected to a local Go-hosted prototype. The browser can run the fixture scan, persist scanner/import records, persist the Audiobookshelf organization plan, and review the latest plan. This keeps all operations dry-run/non-destructive. Remaining M3 work: expand planning from persisted candidates beyond the fixture endpoint, define review/apply safeguards, and continue Grimmory compatibility research.

david commented

2026-06-12 09:33:19 -07:00

Author

Owner

M3 foundation delivered in ffcbab7.

Included:

Persisted organization action review state.
Bulk approval for ready organization actions.
Copy-only apply service for approved copy/copy-normalized operations.
Collision blocking: existing destinations are not overwritten.
Audit rows for each apply attempt with status, paths, errors, retry count, timestamps, and destructive flag.
Prototype UI/API controls for approve-ready and apply-approved.
Tests for store state, API flow, copy success, and collision blocking.
Docs and wiki updated.

Verified: make test, make check-organization, make check-large-scan, make check-persistence, HTTP smoke for health/scan/approve/apply, and 9 copied fixture outputs in the temp managed output root.

M3 foundation delivered in ffcbab7. Included: - Persisted organization action review state. - Bulk approval for ready organization actions. - Copy-only apply service for approved copy/copy-normalized operations. - Collision blocking: existing destinations are not overwritten. - Audit rows for each apply attempt with status, paths, errors, retry count, timestamps, and destructive flag. - Prototype UI/API controls for approve-ready and apply-approved. - Tests for store state, API flow, copy success, and collision blocking. - Docs and wiki updated. Verified: make test, make check-organization, make check-large-scan, make check-persistence, HTTP smoke for health/scan/approve/apply, and 9 copied fixture outputs in the temp managed output root.

david closed this issue

2026-06-12 09:33:19 -07:00

Rows
Columns

Design organization dry-run plans and downstream profiles #6