KG-ARCHMAP 0.6.0b0__tar.gz

kg_archmap-0.6.0b0/.archmap.toml

@@ -0,0 +1,7 @@
+[architecture.rules]
+forbid = [
+  "core -> cli",
+  "parser -> cli",
+  "analyzer -> cli",
+  "graph -> cli",
+]

kg_archmap-0.6.0b0/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

kg_archmap-0.6.0b0/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

kg_archmap-0.6.0b0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Report something that is broken or behaving unexpectedly
+title: "[bug] "
+labels: bug
+assignees: ""
+---
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To reproduce
+
+Steps to reproduce the behavior:
+
+1. Run command: `archmap ...`
+2. With project at path: `...`
+3. See error
+
+## Expected behavior
+
+What you expected to happen.
+
+## Actual behavior
+
+What actually happened. Include the full error message / stack trace if available.
+
+## Environment
+
+- OS: <!-- e.g. Ubuntu 22.04, Windows 11, macOS 14 -->
+- Python version: <!-- e.g. 3.11.9 -->
+- ArchMAP version: <!-- `archmap version` output -->
+- Install method: <!-- pip install / pip install -e / .exe bundle -->
+
+## Additional context
+
+Any other context, screenshots, or sample project structure that helps reproduce the issue.

kg_archmap-0.6.0b0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an idea or improvement for ArchMAP
+title: "[feat] "
+labels: enhancement
+assignees: ""
+---
+
+## Problem / motivation
+
+What problem does this feature solve? Who is affected?
+
+## Proposed solution
+
+A clear description of what you want to happen.
+
+## Alternatives considered
+
+Other approaches you have thought about and why you ruled them out.
+
+## Additional context
+
+Any mockups, examples from other tools, or related issues.

kg_archmap-0.6.0b0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+## Summary
+
+Describe the purpose of this PR in 2-5 lines.
+
+## Branch Flow
+
+- Source branch: `feat/*` or `fix/*` or `docs/*`
+- Target branch: `dev` (default) or `release/*` (stabilization only)
+
+## Checklist
+
+- [ ] I ran `python -m ruff check .`
+- [ ] I ran `python -m pytest -q`
+- [ ] I ran smoke analysis:
+  - `python -m archmap.cli.main analyze . --format both --out .codeatlas/local-graph.json --out-mermaid .codeatlas/local-graph.mmd --include-cytoscape`
+- [ ] I updated docs/changelog when behavior changed
+- [ ] I did not commit local runtime logs or build artifacts
+- [ ] I preserved attribution files (`LICENSE`, `NOTICE.md`)
+
+## Impact
+
+- Breaking change: `yes` / `no`
+- New CLI flags/endpoints:
+- Risk to release:
+
+## Validation Notes
+
+Paste key command outputs or explain test coverage for this PR.

kg_archmap-0.6.0b0/.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - main
+      - dev
+      - feat/**
+      - release/**
+      - feature/**
+      - fix/**
+      - docs/**
+  pull_request:
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Lint
+        run: python -m ruff check .
+
+      - name: Run tests with coverage
+        run: python -m pytest
+
+      - name: Run smoke analysis
+        run: python -m archmap.cli.main analyze . --format both --out .codeatlas/ci-graph.json --out-mermaid .codeatlas/ci-graph.mmd --include-cytoscape
+        if: matrix.python-version == '3.13'
+
+      - name: Enforce architecture gate
+        if: matrix.python-version == '3.13'
+        run: python -m archmap.cli.main analyze . --format json --out .codeatlas/ci-gate.json --fail-on-cycles --fail-on-custom-rules --min-health 65
+
+      - name: Run architecture history smoke
+        if: matrix.python-version == '3.13'
+        run: python -m archmap.cli.main history --repo . --limit 8 --json > .codeatlas/ci-history.json

kg_archmap-0.6.0b0/.github/workflows/docs.yml

@@ -0,0 +1,65 @@
+name: docs
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "README.md"
+      - "CHANGELOG.md"
+      - "ROADMAP.md"
+      - "CONTRIBUTING.md"
+      - "CODE_OF_CONDUCT.md"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install MkDocs
+        run: |
+          pip install mkdocs-material
+
+      - name: Copy root docs into docs/ for MkDocs
+        run: |
+          cp CHANGELOG.md docs/changelog.md
+          cp ROADMAP.md docs/roadmap.md
+          cp CONTRIBUTING.md docs/contributing.md
+          cp CODE_OF_CONDUCT.md docs/code-of-conduct.md
+
+      - name: Build docs site
+        run: mkdocs build --strict
+
+      - name: Upload to GitHub Pages
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: site/
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

kg_archmap-0.6.0b0/.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Hatch
+        run: pip install hatch
+
+      - name: Build wheel and sdist
+        run: hatch build
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

kg_archmap-0.6.0b0/.github/workflows/release.yml

@@ -0,0 +1,220 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build-python:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Validate tag matches package version
+        shell: bash
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          VERSION="${TAG#v}"
+          PACKAGE_VERSION="$(python - <<'PY'
+          import sys
+          sys.path.insert(0, "src")
+          from archmap import __version__
+          print(__version__)
+          PY
+          )"
+          if [ "$VERSION" != "$PACKAGE_VERSION" ]; then
+            echo "::error::Tag version ($VERSION) does not match package version ($PACKAGE_VERSION)."
+            exit 1
+          fi
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+          python -m pip install -e ".[dev]"
+
+      - name: Run quality gates
+        run: |
+          python -m ruff check .
+          python -m pytest
+
+      - name: Build distribution
+        shell: bash
+        run: |
+          rm -rf build dist
+          python -m build --sdist --wheel
+
+      - name: Upload Python artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dist
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+          if-no-files-found: error
+
+  build-windows-exe:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Validate tag matches package version
+        shell: pwsh
+        run: |
+          $tag = $env:GITHUB_REF_NAME
+          $version = $tag.Substring(1)
+          $packageVersion = (python -c "import sys; sys.path.insert(0, 'src'); from archmap import __version__; print(__version__)").Trim()
+          if ($version -ne $packageVersion) {
+            Write-Error "Tag version ($version) does not match package version ($packageVersion)."
+            exit 1
+          }
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pyinstaller
+          python -m pip install -e ".[dev]"
+
+      - name: Build Windows executable
+        shell: pwsh
+        run: |
+          $version = (python -c "import sys; sys.path.insert(0, 'src'); from archmap import __version__; print(__version__)").Trim()
+          if ([string]::IsNullOrWhiteSpace($version)) {
+            throw "Failed to resolve package version."
+          }
+
+          python -m PyInstaller src/archmap/cli/main.py `
+            --onefile `
+            --name archmap `
+            --paths src `
+            --noconfirm `
+            --clean `
+            --icon resources/icon.png `
+            --exclude-module tkinter `
+            --exclude-module _tkinter `
+            --add-data "src/archmap/web-ui/static;web-ui/static"
+
+          $pyinstallerExit = $LASTEXITCODE
+          if ($pyinstallerExit -ne 0 -and -not (Test-Path "dist/archmap.exe")) {
+            throw "PyInstaller failed with exit code $pyinstallerExit and EXE was not generated."
+          }
+          if ($pyinstallerExit -ne 0) {
+            Write-Warning "PyInstaller exited with code $pyinstallerExit but EXE exists. Continuing release."
+          }
+
+          Copy-Item "dist/archmap.exe" "dist/archmap-$version.exe" -Force
+
+          $sha = (Get-FileHash "dist/archmap.exe" -Algorithm SHA256).Hash
+          $manifest = @{
+            version      = $version
+            builtAtUtc   = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
+            exePath      = "dist/archmap.exe"
+            versionedExe = "dist/archmap-$version.exe"
+            sha256       = $sha
+          } | ConvertTo-Json -Depth 4
+          Set-Content -Path "dist/archmap-build-info.json" -Value $manifest -Encoding UTF8
+
+      - name: Upload Windows artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: windows-exe
+          path: |
+            dist/archmap.exe
+            dist/archmap-*.exe
+            dist/archmap-build-info.json
+          if-no-files-found: error
+
+  release:
+    runs-on: ubuntu-latest
+    needs:
+      - build-python
+      - build-windows-exe
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download Python artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-dist
+          path: dist
+
+      - name: Download Windows artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: windows-exe
+          path: dist
+
+      - name: Extract changelog for this release
+        id: changelog
+        shell: bash
+        env:
+          VERSION: ${{ github.ref_name }}
+        run: |
+          VERSION="${VERSION#v}"
+          export VERSION
+          python - <<'PY'
+          import os
+          import pathlib
+          import re
+
+          version = os.environ["VERSION"]
+          changelog = pathlib.Path("CHANGELOG.md")
+          text = changelog.read_text(encoding="utf-8")
+
+          header = re.compile(rf"^## \[{re.escape(version)}\](?:\s+-\s+.*)?$", re.MULTILINE)
+          match = header.search(text)
+          if not match:
+            notes = "See CHANGELOG.md for details."
+          else:
+            start = match.end()
+            next_header = re.search(r"^## \[", text[start:], re.MULTILINE)
+            end = start + next_header.start() if next_header else len(text)
+            notes = text[start:end].strip() or "See CHANGELOG.md for details."
+
+          pathlib.Path("release_notes.txt").write_text(notes + "\n", encoding="utf-8")
+          with open(os.environ["GITHUB_OUTPUT"], "a", encoding="utf-8") as output:
+            output.write(f"version={version}\n")
+          PY
+
+      - name: Detect prerelease tag
+        id: release_meta
+        shell: bash
+        env:
+          VERSION: ${{ github.ref_name }}
+        run: |
+          VERSION="${VERSION#v}"
+          if [[ "$VERSION" =~ (a|b|rc|dev) ]]; then
+            echo "prerelease=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "prerelease=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ArchMAP ${{ github.ref_name }}
+          prerelease: ${{ steps.release_meta.outputs.prerelease }}
+          body_path: release_notes.txt
+          files: dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

kg_archmap-0.6.0b0/.gitignore

@@ -0,0 +1,27 @@
+node_modules/
+coverage/
+dist/
+build/
+site/
+*.log
+.codeatlas/
+.venv/
+venv/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+*.pyc
+htmlcov/
+.coverage
+.coverage.*
+logs/runtime/*
+!logs/runtime/.gitkeep
+server_log.txt
+test_out.txt
+test_output*.txt
+cov_report*.txt
+parser_cov*.txt
+coverage.json
+release_notes_api.txt
+web-ui/static/