[Feature] Add folder-level connector sync orchestration #16

Closed
opened 2026-07-08 08:36:07 +02:00 by zemion · 2 comments
Owner

Move beyond single-file manual sync and support explicit folder-level sync from linked connector spaces.

Acceptance criteria:

  • Add folder-level manual sync endpoint for a linked connector space.
  • Detect created/updated/unchanged/skipped files.
  • Return conflict and policy failures in a reviewable result.
  • Emit audit events with source provenance and sync action summary.
  • Leave background scheduling as a separate follow-up unless this issue remains small.

Wiki: Connector Spaces

Move beyond single-file manual sync and support explicit folder-level sync from linked connector spaces. Acceptance criteria: - Add folder-level manual sync endpoint for a linked connector space. - Detect created/updated/unchanged/skipped files. - Return conflict and policy failures in a reviewable result. - Emit audit events with source provenance and sync action summary. - Leave background scheduling as a separate follow-up unless this issue remains small. Wiki: Connector Spaces
zemion added the area/apicodex/readymodule/files
priority
p2
status
ready
type
feature
labels 2026-07-29 14:15:12 +02:00
Author
Owner

Starting the next autonomous implementation slice. The existing linked connector-space browse and single-file sync paths provide the transport and provenance foundations, so this issue can be completed without live provider credentials or a product-policy decision. The slice will add a bounded manual folder-sync endpoint, per-item created/updated/unchanged/skipped/conflict/policy-failure results, summary audit evidence, a reviewable Files UI action, German help/documentation, and focused plus full workspace verification.

Starting the next autonomous implementation slice. The existing linked connector-space browse and single-file sync paths provide the transport and provenance foundations, so this issue can be completed without live provider credentials or a product-policy decision. The slice will add a bounded manual folder-sync endpoint, per-item created/updated/unchanged/skipped/conflict/policy-failure results, summary audit evidence, a reviewable Files UI action, German help/documentation, and focused plus full workspace verification.
zemion added
status
in-progress
and removed
status
ready
labels 2026-08-21 22:31:23 +02:00
Author
Owner

Implemented and published.

Delivered:

  • bounded deterministic folder traversal with provider pagination, recursive/depth/file limits, duplicate suppression, and linked-root containment;
  • POST /api/v1/files/connector-spaces/{space_id}/sync with files:file:upload authorization, manual-mode enforcement, inherited root and per-file policy checks, and preserved relative managed paths;
  • per-file savepoints and typed created/updated/unchanged/skipped/conflict/policy_denied/failed outcomes, with skip as the safe default for unrelated target collisions;
  • source-identity matching and existing Files version/provenance behavior reused for created, unchanged, and version-appending updates;
  • per-file connector sync audit plus bounded files.connector.folder_synced summary evidence without content or credentials;
  • localized English/German Files dialog, explicit result review, contextual help, and updated module/handbook documentation;
  • backend, router, manifest, traversal, UI structure, localization, layout, full-product, browser, and cross-module conformance coverage.

Published releases:

  • Files 378f4d6, tag v0.1.20
  • Core 5de46e9, tag v0.1.23
  • workspace a20e022

Verification:

  • Files: 167 tests and 34 subtests passed; Ruff and all Files WebUI contracts passed.
  • Workspace: focused gate passed for 68 manifests, architecture/dependency checks, 59 WebUI permutations, full-product bundle budgets, and 8 Playwright conformance tests.

No manual configuration, credentials, migration, or product decision is required. Background scheduling intentionally remains a separate slice.

Implemented and published. Delivered: - bounded deterministic folder traversal with provider pagination, recursive/depth/file limits, duplicate suppression, and linked-root containment; - POST /api/v1/files/connector-spaces/{space_id}/sync with files:file:upload authorization, manual-mode enforcement, inherited root and per-file policy checks, and preserved relative managed paths; - per-file savepoints and typed created/updated/unchanged/skipped/conflict/policy_denied/failed outcomes, with skip as the safe default for unrelated target collisions; - source-identity matching and existing Files version/provenance behavior reused for created, unchanged, and version-appending updates; - per-file connector sync audit plus bounded files.connector.folder_synced summary evidence without content or credentials; - localized English/German Files dialog, explicit result review, contextual help, and updated module/handbook documentation; - backend, router, manifest, traversal, UI structure, localization, layout, full-product, browser, and cross-module conformance coverage. Published releases: - Files 378f4d6, tag v0.1.20 - Core 5de46e9, tag v0.1.23 - workspace a20e022 Verification: - Files: 167 tests and 34 subtests passed; Ruff and all Files WebUI contracts passed. - Workspace: focused gate passed for 68 manifests, architecture/dependency checks, 59 WebUI permutations, full-product bundle budgets, and 8 Playwright conformance tests. No manual configuration, credentials, migration, or product decision is required. Background scheduling intentionally remains a separate slice.
zemion removed the
status
in-progress
codex/ready
labels 2026-08-21 23:16:46 +02:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: GovOPlaN/govoplan-files#16