[AISOS-2311] Add an end-to-end Forge smoke-test command

[forgeSmith-bot]

Summary

This PR introduces a new forge smoke-test CLI command that verifies a Forge deployment's core runtime path end-to-end without requiring a Jira ticket or modifying remote resources. By executing a diagnostic graph, initializing a temporary workspace, and running a real container agent task, this smoke-test command ensures runtime readiness, service connectivity, and correct configuration.

Changes

Core & CLI Implementation

• Created src/forge/smoke_test.py: Implemented a three-stage smoke-test runner that performs diagnostic graph execution, checks container/rootless Podman connectivity, initializes a disposable workspace, and runs a containerized agent to produce and validate diagnostic outputs.
• Modified src/forge/cli.py: Registered the async smoke-test subcommand routing to run_smoke_test.

Testing & Documentation

• Created tests/unit/test_smoke_test.py: Added five high-coverage unit tests covering successful execution, Stage 1 graph failures, Stage 2 missing container/environment dependencies, Stage 3 execution failures, and cleanup.
• Modified docs/dev/testing.md: Added CLI usage examples and detailed descriptions of the three verification stages.

Implementation Notes

• Workspace Cleanup: The runner works inside a secure, temporary directory generated by tempfile.TemporaryDirectory. All resources are cleaned up inside a finally block to prevent disk bloat.
• Isolated Operations: The smoke test performs all actions within a disposable workspace and is configured not to trigger remote Git branches, commits, PRs, or Jira comments.
• Test Isolation: Unit tests utilize unittest.mock to safely mock environment configurations and ContainerRunner.run execution paths, verifying graceful handling of missing dependencies, stage failures, and cleanup without exposing external secrets or relying on a running container environment.

Testing

• Unit Testing: Verified five test cases in tests/unit/test_smoke_test.py covering successful path, stage failures, environment dependency issues, and cleanup behavior.
• CLI Verification: Verified CLI option registration, argument parsing, and command execution flow.

Related Tickets

• AISOS-2311

---

Generated by Forge SDLC Orchestrator