goga 0.0.0__tar.gz

goga-0.0.0/.github/workflows/docs.yml

@@ -0,0 +1,26 @@
+name: Release docs
+on:
+  push:
+    branches:
+      - '[0-9]+.[0-9]+.x'
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[docs]"
+
+      - name: Build and Deploy
+        run: mkdocs gh-deploy --force

goga-0.0.0/.github/workflows/lint.yml

@@ -0,0 +1,19 @@
+name: Lint
+on:
+  push:
+    branches:
+      - '[0-9]+.[0-9]+.x'
+  pull_request:
+    branches:
+      - '[0-9]+.[0-9]+.x'
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/ruff-action@v3
+        with:
+          args: check goga/ tests/
+      - uses: astral-sh/ruff-action@v3
+        with:
+          args: format --check goga/ tests/

goga-0.0.0/.github/workflows/publish.yml

@@ -0,0 +1,17 @@
+name: Publish Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    uses: qarium/ci/.github/workflows/library-publish.yml@0.0.x
+    with:
+      src-package: 'goga'
+    secrets:
+      PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+      ZAI_TOKEN: ${{ secrets.ZAI_TOKEN }}

goga-0.0.0/.github/workflows/strictacode.yml

@@ -0,0 +1,43 @@
+name: Strictacode
+
+on:
+  push:
+    branches:
+      - '[0-9]+.[0-9]+.x'
+  pull_request:
+    branches:
+      - '[0-9]+.[0-9]+.x'
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - uses: qarium/strictacode/.github/actions/analyze@0.0.x
+        with:
+          install-cmd: pip install strictacode
+          working-directory: goga
+        env:
+          STRICTACODE_SCORE: 40
+          STRICTACODE_RP: 40
+          STRICTACODE_SCORE_DIFF: 3
+          STRICTACODE_RP_DIFF: 5
+          STRICTACODE_OP: 40
+          STRICTACODE_IMB: 35
+          STRICTACODE_DENSITY: 30
+          STRICTACODE_OP_DIFF: 5
+          STRICTACODE_DENSITY_DIFF: 3

goga-0.0.0/.github/workflows/tests.yml

@@ -0,0 +1,14 @@
+name: Tests
+on:
+  push:
+    branches:
+      - '[0-9]+.[0-9]+.x'
+  pull_request:
+    branches:
+      - '[0-9]+.[0-9]+.x'
+
+jobs:
+  test:
+    uses: qarium/ci/.github/workflows/library-tests.yml@0.0.x
+    with:
+      python-versions: '["3.10", "3.11", "3.12", "3.13", "3.14"]'

goga-0.0.0/.gitignore

@@ -0,0 +1,222 @@
+# goga: ralphex config managed by goga
+.goga/prompts/*.txt
+.goga/agents/*.txt
+.goga/config
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+/MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# IDE
+.idea/
+
+# AI
+.claude/
+.ralphex/
+docs/plans/
+docs/design/
+docs/superpowers/

goga-0.0.0/.qarium/ai/employees/devops.md

@@ -0,0 +1,27 @@
+# DevOps
+
+## Config
+
+| Key            | Value            | Description                                 |
+|----------------|------------------|---------------------------------------------|
+| ci_provider    | github-actions   | CI provider                                 |
+| trigger_branch | 0.0.x            | Default branch for triggers                 |
+| diff_range     | HEAD~5           | Git diff range for auto-analysis in feature |
+
+## Rules
+
+### Workflow Registry
+
+| Workflow    | File               | Trigger                    | Purpose                        |
+|-------------|--------------------|----------------------------|--------------------------------|
+| Lint        | lint.yml           | push/PR to 0.0.x           | Ruff lint + format check       |
+| Tests       | tests.yml          | push/PR to 0.0.x           | Pytest via reusable workflow   |
+| Docs        | docs.yml           | push to 0.0.x              | MkDocs deploy to GitHub Pages  |
+| Strictacode | strictacode.yml    | push/PR to 0.0.x           | Code quality analysis          |
+
+### Conventions
+
+## Lessons
+
+| Problem | Why | How to prevent |
+|---------|-----|----------------|

goga-0.0.0/.qarium/ai/employees/lead.md

@@ -0,0 +1,28 @@
+# Lead
+
+## Config
+
+| Key            | Value  | Description                                  |
+|----------------|--------|----------------------------------------------|
+| default_branch | 0.0.x  | Default branch for CI triggers and diff base |
+
+## Architecture & Decisions
+- **setuptools + setuptools-scm for versioning** — automatic version from git tags, no manual version management
+- **MIT license** — permissive license for broad adoption
+
+## Project Structure
+- **goga/ — package root** — source code package matching project name
+
+## Code Patterns
+<!-- empty — no source code to analyze yet -->
+
+## TODO
+<!-- empty -->
+
+## LLM Directives
+<!-- empty -->
+
+## Lessons
+
+| Problem | Why | How to prevent |
+|---------|-----|----------------|

goga-0.0.0/.qarium/ai/employees/qa.md

@@ -0,0 +1,46 @@
+## Config
+
+| Setting          | Value                              |
+|------------------|------------------------------------|
+| run_tests_cmd    | `pytest --tb=short`                |
+| lint_cmd         | `ruff check goga/ tests/`          |
+| lint_fix_cmd     | `ruff check --fix goga/ tests/`    |
+| format_cmd       | `ruff format --check goga/ tests/` |
+| format_fix_cmd   | `ruff format goga/ tests/`         |
+
+## Rules
+
+Project test configuration. Used by the `qarium:employees:qa:feature` skill.
+
+### Mapping
+
+| Source path pattern | Test directory     | Notes         |
+|---------------------|--------------------|---------------|
+| `goga/**/*.py`      | `tests/goga/`      | Mirror layout |
+
+### Mock Patterns
+
+| Pattern | Example |
+|---------|---------|
+| tmp_path for CODEMANIFEST fixtures | `tmp_path / "pkg" / "CODEMANIFEST"` write YAML, pass dir to Factory |
+
+### Helpers
+
+| Helper | Location | Purpose |
+|--------|----------|---------|
+| `_write_codemanifest(directory, content) -> str` | `tests/goga/ast/test_factory.py` | Writes a CODEMANIFEST YAML file into a directory and returns the dir path |
+| `_write_codemanifest(directory, content) -> str` | `tests/goga/ast/test_factory_node_props.py` | Same helper — writes a CODEMANIFEST YAML file into a directory |
+
+### Conventions
+
+- Naming: `test_<what>_<scenario>`
+- Never mock `builtins.open` — use `tmp_path` fixture
+- Use `pathlib.Path` instead of `os.path` — project enforces PTH rules via ruff
+- Integration tests use `pytest.mark.skipif` when external tools unavailable
+- Python 3.10 compatibility: use `from __future__ import annotations` in source files; use `Optional[X]` not `X | None` in dataclass fields (ruff UP045)
+- `DocumentRuleError` is the canonical name — import from `goga.ast.errors`
+
+## Lessons
+
+| Problem | Why | How to prevent |
+|---------|-----|----------------|

goga-0.0.0/.qarium/ai/employees/tech-writer.md

@@ -0,0 +1,25 @@
+# Tech Writer Config
+
+## Config
+
+| Key           | Value                      | Description                         |
+|---------------|----------------------------|-------------------------------------|
+| build_cmd     | `mkdocs build`             | Build validation command            |
+| deploy_cmd    | `mkdocs gh-deploy --force` | Deploy command                      |
+| examples_file | `docs/examples.md`         | File for usage examples             |
+| logo_url      | `https://avatars.githubusercontent.com/u/262344922?s=200&v=4` | Standard qarium logo |
+| base_branch   | `0.0.x`                    | Base branch for git diff comparison |
+
+## Rules
+
+### Mapping
+
+| Source path | Documentation files |
+|-------------|---------------------|
+
+### Conventions
+
+## Lessons
+
+| Problem | Why | How to prevent |
+|---------|-----|----------------|

goga-0.0.0/.strictacode.yml

@@ -0,0 +1,3 @@
+loader:
+  exclude:
+    - tests