LearnNewsExamplesServices
Frontmatter
id11189
titlePhase 1: Refactor Config for Archive Shape Management
stateClosed
labels
enhancementaiarchitecture
assigneesneo-gemini-3-1-pro
createdAtMay 11, 2026, 10:21 AM
updatedAtMay 11, 2026, 1:51 PM
githubUrlhttps://github.com/neomjs/neo/issues/11189
authorneo-gemini-3-1-pro
commentsCount2
parentIssue11187
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[x] 11198 IssueService archive-write path refactor for lazy ordinal chunking (#11187 AC3)
closedAtMay 11, 2026, 1:51 PM

Phase 1: Refactor Config for Archive Shape Management

Closedenhancementaiarchitecture
neo-gemini-3-1-pro
neo-gemini-3-1-pro commented on May 11, 2026, 10:21 AM

The Option E''+S convergence means we DO NOT need a "shape" config for the active tier (e.g. chunked vs flat) since the syncers will uniformly use deterministic ID-chunking for the active tier and lazy ordinal chunking for the archive tier.

The Architectural Reality

We need to formalize an archive configuration in config.mjs (e.g. archiveRoot or similar) that sets up the single archive root. Crucially, AC1 must provide the configuration for the lazy ordinal chunking in the archive tier:

  • archiveChunkThreshold: 100
  • archiveChunkPrefix: 'chunk-' This ensures the chunking semantics are defined in the config layer, not hardcoded in the helpers/syncers.

The Fix

Introduce a unified archive path configuration in the environment/config substrate and ensure it is properly exposed for the sync services and path helpers to consume.

Acceptance Criteria

  • Add archiveRoot to the canonical environment configuration (config.template.mjs).
  • Add archiveChunkThreshold: 100 and archiveChunkPrefix: 'chunk-' to support lazy ordinal chunking in the archive tier.
  • Ensure the new configuration is properly documented in the Deployment Cookbook if necessary.

Out of Scope

Modifying the archivePath helper (AC2) or the Syncers themselves (AC3-AC5). This ticket is strictly for the configuration foundation. Adding "shape" toggles for active tiers.

Origin Session ID

Origin Session ID: 57502eb2-7f7b-4b9b-a849-49f016b08c95 Retrieval Hint: "Epic 11187 Phase 1 Config Refactor"

tobiu referenced in commit aa3ba16 - "feat(github-workflow): introduce unified archiveRoot configuration (#11189) (#11191) on May 11, 2026, 1:51 PM
tobiu closed this issue on May 11, 2026, 1:51 PM
tobiu referenced in commit c459245 - "refactor(github-workflow): use archivePath for pull requests and discussions (#11187) (#11199) on May 11, 2026, 2:04 PM