Implement file watch mode with --watch flag to auto rerun operations

[github-actions[bot]]

Title: Implement --watch flag to auto rerun CLI operations on file changes

Description: Extend the CLI entrypoint (src/lib/main.js) to support a new --watch flag, enabling automatic reruns of core operations when project files change. This will provide immediate feedback loops and improve developer productivity.

Acceptance Criteria:

1. parseArgs Recognition
   • Given command-line arguments containing --watch, parseArgs(args) must set options.watch === true and preserve other flags (e.g., --serve, --build-intermediate, --refresh).
2. startWatchMode Implementation
   • A new exported function startWatchMode(options) must: a. Use chokidar.watch on patterns *.json and *.y?(a)ml in the project root. b. Debounce file events with a configurable delay defaulting to 100ms. c. On each add, change, or unlink event: • If options.serve is true, restart or refresh the HTTP server. • If options.buildIntermediate or options.buildEnhanced is true, invoke the correct build function. • If options.refresh is true, call refreshConfiguration() and log its result. • If no other primary operation flag is set, log the event path to stdout. d. Keep the process alive until explicitly terminated by the user (e.g., Ctrl+C).
3. Main Flow Integration
   • In main(args), after parsing options, if options.watch is true then startWatchMode(options) must be called and the CLI must not exit immediately.
4. Unit Tests (in tests/unit/main.test.js)
   • Mock chokidar to emit synthetic file events.
   • Verify the watcher is set up with the correct patterns.
   • Simulate rapid successive events and assert that handlers are called exactly once per debounce interval.
   • For each primary operation flag, emit a change event and assert the corresponding task function is invoked.
   • Test that without any primary flags, change events result in logging of file paths.
5. Integration Tests
   • When running npm start --watch alone, ensure startWatchMode is invoked.
   • When combining --watch with other flags (--serve, --build-intermediate, --refresh), ensure operations are retriggered on file changes.
6. Documentation Updates (README.md)
   • Under CLI Usage, add a description for the --watch flag.
   • Provide inline examples (no fenced code blocks):
     • npm run start --serve --watch → start server and reload on changes
     • npm run build-intermediate --watch → rerun build when source files change
     • npm run refresh --watch → rerun config validation on change
7. Manual Verification
   • Run npm test and confirm all new and existing tests pass.
   • Manually execute npm run start --build-intermediate --watch and modify a source or config file; observe the build rerun and console logs.

[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 file watch mode with chokidar integration and CLI dispatch

[github-actions[bot]]

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

[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/15282766886 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/7cc08edd7545427b7274b8bd4c25700d3fca7cc8

[github-actions[bot]]

agentic-lib-issue-2304 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/15283837033 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/009f6f74cad6fd612b9aeff7f1594ccafc93de9a

[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/15284905758 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/f8752a93ec95d24bd724f08c05cb78e8a3e3d7d5

[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/15285962392 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/c08fa9a71f66eb44457c3ef252016cd3deabb2f0

[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/15286888175 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/86b36bbd7cea4d9e490d76e2d1a55bc2441c0203

[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/15287715871 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/877d24c662d170c1fae0f3b9b5d505b458cf83bc

[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/15288711241 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/d65e0bab50a24a9a6f8dbc09320fb2e6eb3c13b0

[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/15289623165 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/f58a994e148ada2abb27f93f3d0a569f9a33ac59

[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/15290845991 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/3fccd6fd5af430a09d94f17d33e2a4f703db7fd0

[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/15291423151 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/6854f99553e11415558af87d48fa803aaca45cae

[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/15292141620 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/ece5c8f8d558f609807bce5ce33d1a39130e3352

[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/15292988469 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/7e882da91475aae765e41e08d0a3638f75312183

[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/15294005739 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/17bad69a295c4f7c133b33b8bde96420fdf61026

[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/15295178182 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/8dace580345a71953142a52f7db8c93d6ca9b402

[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/15296430439 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/0033d7e1bb720e6586f79140aa9be2a38b9cd29f

[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/15297658533 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/f4e9c59b27c1c8516834f157808f59eb73545a68

[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/15298795623 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/986d82b86f88a5549ffe4f200a2ea4cf3fcd42ca

[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/15300006947 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/0ac81eab7ae39e365efdd31a7b26badcd5fe874c

[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/15301314016 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/58fd770517bfe133780ee4abbdac142e3e1f58e0

[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/15302630965 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/41a0605d3e5a0efb69e66db0d2f5a3c6781577a5

[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/15304040654 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/f3f351aee9f8bbbc702992b57417c5a90a7eb5de

[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/15305344732 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/8b2356e03199ac6227b3e97ec6511694bbe8398a

[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/15306458359 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/ec58630073bcf0521a303b360d3f2c62146512c9

[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/15307634411 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/800eee529f47ef5b622146b1f852877008cad52f

[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/15308706430 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/be14941421a340d2f958d0d6c58414517c262aff

[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/15309796262 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/00d72fec92f01c64b9e958f7a19cbc0b21a0ed4d

[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/15310836550 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/3849f8df078fdccdd261c1fb35d34e6e9fdb3df1

[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/15311754873 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/e6fb5fa5dce5d7ffb003f76972d6b625258bc558

[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/15312551677 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/0a29d4722bd2721e897e701f5733322a853f26bb

[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/15316214790 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/bcd0202ee805e1df411e191c227b797dfc84d446

[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/15371002636 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/a2b9c2bbce208262b20684f9461c0ba15a97b0c7

[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/15514838354 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/ec410e3368d3436f1eca607fe555b8a585fcb7f8

[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/15659446661 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/bdd898d1604d39e127294f35e34bb4a452cd28dd

[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/15802887747 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/ca7bc2b3696700fa26afdcb34133d63b632617b2

[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/15951490917 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/c48e85f70c3921008050e3231ce96494551f3015

[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/15989841655 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/9f6886c415ffd7d6c06f553377b098f26a8b9eb2

[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/16133928328 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/ba1163362abbe56cb1e521f00eb076e0eae769f7