Add --mission CLI option to display project mission

[github-actions[bot]]

Summary

Introduce a new --mission flag in the CLI entrypoint to surface the repository’s mission directly from the MISSION.md file. This ensures features are explicitly tied back to the mission and allows users to review the project goal on demand.

Changes

1. src/lib/main.js

   • Parse for a new --mission argument in the main(args) function.
   • When --mission is present, read and print the contents of MISSION.md to stdout (line-by-line).
   • Short-circuit other modes if --mission is provided.

2. tests/unit/main.test.js

   • Add a unit test for main(["--mission"]):
     • Mock the file system read of MISSION.md (e.g., using vi.mock('fs', ...)).
     • Assert that console.log is called with each line of the mocked mission text.

3. README.md

   • Document the new npm run mission script and --mission flag usage under the CLI section, including an example invocation and expected output.

4. package.json

   • Add a new npm script:

     "mission": "node src/lib/main.js --mission"

Verification

1. Run npm run mission and confirm the full content of MISSION.md is printed to the console.
2. Execute npm test and ensure the new mission flag test passes without affecting existing tests.
3. Verify that other CLI modes (start, diagnostics, serve) continue to work as before.

[github-actions[bot]]

Workflow name: flow-feature-development Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15263360446 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/50c1c5df087ad92b7c1154c82cdeeec99ba7bbcb

[github-actions[bot]]

Workflow name: flow-feature-development Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15263360446 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/50c1c5df087ad92b7c1154c82cdeeec99ba7bbcb

[github-actions[bot]]

Workflow name: flow-feature-development Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15263360446 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/50c1c5df087ad92b7c1154c82cdeeec99ba7bbcb

[github-actions[bot]]

Workflow name: transformation-05-issue-to-ready-issue Workflow run URL: https://github.com/xn-intenton-z2a/repository0/actions/runs/15263519710 Workflow event: schedule Workflow inputs: null HEAD of main URL: https://github.com/xn-intenton-z2a/repository0/commit/01f83c0a77eda5636ecba7c33da6ec2ee2038774

[github-actions[bot]]

The proposed --mission flag is a meta-feature that surfaces internal project documentation rather than adding or enhancing core Hello World functionality. It does not deliver direct user value for the primary use case and falls outside the project’s mission to demonstrate the Hello World program and its associated CLI modes.