Implement build, refresh, and persistence operations in CLI parser

[github-actions[bot]]

Title: Implement build, refresh, and persistence operations in CLI parser

Description: The CLI currently supports argument parsing, diagnostics reporting, and HTTP serving. This issue will add support for the remaining core workflows defined in the CLI_PARSER specification, namely:

1. performBuildIntermediate(options)
2. performBuildEnhanced(options)
3. refreshConfiguration()
4. mergeAndPersistData(options)

Testable Acceptance Criteria:

1. performBuildIntermediate(options): • Reads a sample JSON or YAML source definition from a fixture file. • Generates an intermediate manifest JSON file in a temporary directory. • Returns an object with keys { items: number, path: string }. • Logs the summary object via console.log. • Unit test should mock file I/O and assert the returned object and log call.

2. performBuildEnhanced(options): • Accepts a fake intermediate manifest input. • Applies a transformation (e.g., adds a timestamp field). • Writes the transformed result to a temporary output file or stdout. • Returns metadata including { transformed: true, path: string }. • Logs a detailed report via console.log. • Unit test should spy on console.log and validate returned metadata.

3. refreshConfiguration(): • Loads config.yml or config.json from a temp fixture directory. • Validates against a Zod schema (e.g., required fields, types). • Returns the parsed and normalized configuration object. • Logs the loaded settings via console.log. • Unit test should provide a temp config file and assert output and log.

4. mergeAndPersistData(options): • Reads two sample data sources from fixtures (arrays or JSON files). • Merges them into a single object. • Writes the merged JSON to a configurable output path (env var or default ./data/merged.json). • Returns an object { path: string, size: number }. • Logs the file path and byte size via console.log. • Unit test should spy on file writes, assert file existence and log output.

5. main(args) integration: • Calling node src/lib/main.js --build-intermediate triggers performBuildIntermediate and exits(0). • Calling --build-enhanced, --refresh, --merge-persist flags invoke the respective functions and exit(0). • Integration tests confirm the process exit code is 0 and the correct console output.

Documentation Updates: • README.md under Build Operations and Data Management sections with inline examples:

• npm run build-intermediate
• npm run build-enhanced
• npm run refresh
• npm run merge-persist

Verification Steps: • npm test passes all new and existing tests. • Manual CLI commands produce the expected files, console outputs, and exit code 0.

[github-actions[bot]]

This issue has been reviewed and marked as 'ready'. The description has been updated with testable acceptance criteria, and relevant library documents ([], 0 in total) have been added as comments.

[github-actions[bot]]

Implement build, refresh, and persistence operations with supporting tests and documentation

[github-actions[bot]]

https://github.com/xn-intenton-z2a/repository0/tree/agentic-lib-issue-2298

[github-actions[bot]]

Workflow name: transformation-07.1-in-progress-issue-to-ready-issue Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15271492347 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/b40c86d5a301b61430be92d753a75b815d481b63

[github-actions[bot]]

agentic-lib-issue-2298 has Reached the limit of 2 attempts with 2 attempts.

[github-actions[bot]]

Workflow name: transformation-07.1-in-progress-issue-to-ready-issue Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15272737258 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/37dd38d5360d2cc4b7f1f95c3756b990232d80c7

[github-actions[bot]]

Workflow name: flow-publish-stats Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15272775647 Workflow event: workflow_run Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/5368615d56d7ed4ae03fde69eac0c330f8a40234

[github-actions[bot]]

Workflow name: flow-publish-stats Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15272883525 Workflow event: workflow_run Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/a88f687406bfc6d1abb131f199f09d62f5fdec87

[github-actions[bot]]

Workflow name: flow-publish-stats Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15272939567 Workflow event: workflow_run Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/a88f687406bfc6d1abb131f199f09d62f5fdec87

[github-actions[bot]]

Workflow name: flow-publish-stats Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15272966387 Workflow event: workflow_run Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/a88f687406bfc6d1abb131f199f09d62f5fdec87

[github-actions[bot]]

Workflow name: transformation-06-issue-to-code Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15273194340 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/a88f687406bfc6d1abb131f199f09d62f5fdec87

[github-actions[bot]]

Reached the limit of 1 attempts with 2 attempts.