Merge pull request #21 from cloudengine-labs/copilot/add-versioning-and-changelog

Add project versioning and changelog for v0.1.0

Author: chefgs

CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.1.0] - 2025-03-08
+
+### Added
+
+#### CLI (`cli/`)
+- **`devopsos` unified CLI** – single entry-point (`python -m cli.devopsos`) built with [Typer](https://typer.tiangolo.com/).
+- **`devopsos init`** – interactive wizard that scaffolds a `.devcontainer/devcontainer.json` tailored to the languages, CI/CD tools, and DevOps utilities you select.
+- **`devopsos scaffold gha`** – generates a multi-stage GitHub Actions workflow (lint → build → test → deploy).
+- **`devopsos scaffold jenkins`** – generates a `Jenkinsfile` with declarative pipeline stages.
+- **`devopsos scaffold gitlab`** – generates a `.gitlab-ci.yml` with Docker, Kubernetes, and deploy stages.
+- **`devopsos scaffold argocd`** – generates ArgoCD `Application` and `AppProject` manifests for GitOps deployments.
+- **`devopsos scaffold sre`** – generates Prometheus alert rules, Grafana dashboard JSON, and SLO manifests.
+- **`devopsos scaffold devcontainer`** – standalone devcontainer scaffolder with full tool-version control.
+- **`devopsos scaffold cicd`** – meta-scaffolder that runs both GHA and Jenkins generation in one step.
+- **`devopsos process-first`** – prints Process-First DevOps principles (Systems Thinking sections: what, mapping, tips, best-practices).
+- **`--version` / `-V` flag** – prints the current `devopsos` version and exits.
+
+#### MCP Server (`mcp_server/`)
+- FastMCP-based server exposing every scaffold function as a native AI tool for Claude / ChatGPT plugins.
+- Tools: `generate_github_actions`, `generate_jenkins_pipeline`, `generate_gitlab_ci`, `generate_argocd_config`, `generate_sre_config`, `generate_devcontainer`, `generate_cicd_pipeline`.
+
+#### Documentation & Examples
+- `README.md` – full project overview with quick-start, use-case table, and architecture diagram.
+- `README-USECASE-EXAMPLES.md` – end-to-end worked examples for every scaffold command.
+- `README-INDEX.md` – top-level navigation index for all documentation.
+- `CONTRIBUTING.md` – contribution guide with coding conventions and PR checklist.
+- `docs/` – extended Hugo-compatible documentation site sources.
+- `feature-announcements/` – HTML/Markdown feature-announcement pages.
+- `skills/` – reusable prompt-skill definitions for AI assistants.
+- `go-project/` – example Go micro-service wired to the DevOps-OS scaffold outputs.
+- `kubernetes/` – sample Kubernetes manifests referenced by the ArgoCD scaffold.
+- `scripts/examples/` – shell-script quick-start examples.
+
+#### Development Environment
+- `.devcontainer/devcontainer.json` – ready-to-use GitHub Codespaces / VS Code dev-container with all Python, Docker, and Kubernetes tooling pre-installed.
+- `.github/workflows/ci.yml` – full CI pipeline (lint, unit tests, integration tests).
+- `.github/workflows/sanity.yml` – lightweight sanity-check workflow for PRs.
+- `.github/workflows/pages.yml` – GitHub Pages deployment workflow for the Hugo docs site.
+
+[0.1.0]: https://github.com/cloudengine-labs/devops_os/releases/tag/v0.1.0

cli/__init__.py

@@ -1 +1,2 @@
 # Package marker for cli
+__version__ = "0.1.0"

cli/devopsos.py

@@ -15,6 +15,7 @@
 import cli.scaffold_sre as scaffold_sre
 import cli.scaffold_devcontainer as scaffold_devcontainer
 import cli.process_first as process_first
+from cli import __version__
 
 class ProcessFirstSection(str, enum.Enum):
     """Valid sections for the process-first command."""
@@ -25,8 +26,26 @@ class ProcessFirstSection(str, enum.Enum):
     all = "all"
 
 
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"devopsos version {__version__}")
+        raise typer.Exit()
+
+
 app = typer.Typer(help="Unified DevOps-OS CLI tool")
 
+
+@app.callback()
+def main(
+    version: bool = typer.Option(
+        False, "--version", "-V",
+        callback=_version_callback,
+        is_eager=True,
+        help="Show the current version and exit.",
+    ),
+) -> None:
+    """DevOps-OS: automate your entire DevOps lifecycle."""
+
 @app.command()
 def init(
     directory: str = typer.Option(".", "--dir", help="Target directory in which the .devcontainer folder will be created (defaults to the current directory)"),

cli/test_cli.py

@@ -570,3 +570,26 @@ def test_process_first_specific_section_no_usage_footer():
             f"--section {section} should not show the usage footer"
         )
 
+
+
+# -- versioning ------------------------------------------------------------
+
+def test_version_flag_short():
+    """-V prints 'devopsos version X.Y.Z' and exits 0."""
+    result = _run(["-m", "cli.devopsos", "-V"])
+    assert result.returncode == 0
+    assert "devopsos version" in result.stdout
+
+
+def test_version_flag_long():
+    """--version prints 'devopsos version X.Y.Z' and exits 0."""
+    result = _run(["-m", "cli.devopsos", "--version"])
+    assert result.returncode == 0
+    assert "devopsos version" in result.stdout
+
+
+def test_version_matches_package():
+    """Version reported by --version matches cli.__version__."""
+    from cli import __version__
+    result = _run(["-m", "cli.devopsos", "--version"])
+    assert __version__ in result.stdout