chore: configure set-up files (#1)

* Remove obsolete files and directories, including documentation, examples, and integration tests, while updating the .gitignore to exclude new generated files. This cleanup enhances project organization and reduces clutter.

* Refactor Natest framework to simplify testing for Dana files. Updated essential commands in CLAUDE.md, streamlined Makefile for dependency management using pip, and revised pyproject.toml to reflect minimal dependencies and Python version compatibility. Enhanced README.md to clarify usage and features, focusing on .na file testing. Removed unnecessary documentation files.

* feat: modernize project with uv support and fix package structure

- Add natest/__init__.py and natest/cli.py to fix package installation
- Update Makefile to prefer uv with pip fallback for faster dependency management
- Modernize pyproject.toml with hatchling build system and uv-style dependencies
- Add explicit version constraints and enhanced tool configurations
- Include uv-specific configurations and workspace support

* feat: implement test discovery and execution for Dana files

- Introduced Dana test discovery functionality to locate .na files based on specified patterns.
- Added execution capabilities for discovered test files using the existing Dana runtime.
- Implemented a command-line interface for running tests with options for verbosity and discovery-only mode.
- Created a reporting system to format and display test results, including pass/fail status and detailed output.
- Added unit tests for the discovery functionality to ensure correct behavior and pattern matching.
- Included example Dana test files for validation of the testing framework.

Author: ctn

.flake8

@@ -1,182 +1,79 @@
-# Byte-compiled / optimized / DLL files
+# .gitignore - Natest Git Ignore Rules
+# Copyright © 2025 Aitomatic, Inc. Licensed under the MIT License.
+
+# Python
 __pycache__/
 *.py[cod]
-*$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
-
-# 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
-
-# pdm
-#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
-#pdm.lock
-#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
-#   in version control.
-#   https://pdm.fming.dev/#use-with-ide
-.pdm.toml
-
-# 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 (we do want this, to add the library path during development)
-.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/
+.ruff_cache/
 
-# 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/
-
-.*.bkp
-.*.dtmp
+# Environment
+.tmp/
+tmp/
+.venv/
+venv/
+.env
+.env.*
+!.env.example
+dana-config.json
+!dana-config.json.example
 
-.vscode/
-poetry.lock
-.gcloudignore
+# Testing and coverage
+.coverage
+pytest.ini
+
+# Logs and data
+local.db
+.dana/
+.poet/
+logs/
+local_executor/
+memory-bank/
+configs/
+
+# Editors and tools
+.qodo/
+*.swp
+*.swo
+.aider*
+.claude/
+dana-*.vsix
+
+# macOS
+.DS_Store
+.DS_Store?
 
-node_modules
-package.json
-package-lock.json
 
-.DS_Store
-.*.swp
-.*.swap
-**/favicon/test
-.env
-.openssm
-__pycache__
-/debug.py
-/mkdocs.yml
-/requirements.txt
+# Build artifacts
+build/
+dist/
+*.egg
+site/
+
+# Development files
+notebooks/
+proposal/
+uv.lock
+node_modules/
+.refactoring_*/
+.cache/
+.ipynb_checkpoints/
+.cursor/
+
+.vscode/launch.json
+.vscode/settings.json
+.deprecated_opendxa
+docs/.ai-only/ai_output/
+
+# Data files
+local.db
+test.db
+uploads
+dana/api/server/static/
+dana/contrib/ui/public/static/
+generated/
+agents/
+docs/.ai-only/ai_output/

.gitignore

@@ -0,0 +1,100 @@
+# .markdownlint.yaml - Markdown Linting Configuration
+# Copyright © 2025 Aitomatic, Inc. Licensed under the MIT License.
+
+# MD004: Unordered list style (enforces consistent bullet style)
+MD004: false
+ul-style: false
+
+# MD005: Inconsistent indentation for list items at the same level (disallows inconsistent indentation for list items at the same level)
+MD005: false
+list-indent: false
+
+# MD007: Unordered list indentation (enforces consistent indentation for nested lists)
+MD007: false
+ul-indent: false
+
+# MD009: Trailing spaces (disallows lines ending with whitespace)
+MD009: false
+no-trailing-spaces: false
+
+# MD012: Multiple consecutive blank lines (disallows more than one blank line in a row)
+MD012: false
+no-multiple-blanks: false
+
+# MD013: Line length (enforces maximum line length)
+MD013: false
+line-length: false
+
+# MD022: Headings should be surrounded by blank lines
+MD022: false
+blanks-around-headings: false
+
+# MD024: Multiple headings with the same content (disallows duplicate headings)
+MD024: false
+no-duplicate-heading: false
+
+# MD025: Multiple top-level headings in the same document (enforces a single H1)
+MD025: true
+single-title: true
+
+# MD026: Trailing punctuation in heading (disallows punctuation at end of headings)
+MD026: false
+trailing-punctuation: false
+
+# MD028: Blank line inside blockquote (disallows blank lines within blockquotes)
+MD028: false
+no-blanks-blockquote: false
+
+# MD029: Ordered list item prefix (enforces consistent numbering style)
+MD029: false
+ol-prefix: false
+
+# MD030: Spaces after list markers (enforces correct spacing after list markers)
+MD030: false
+list-marker-space: false
+
+# MD031: Fenced code blocks should be surrounded by blank lines
+MD031: false
+blanks-around-fences: false
+
+# MD032: Lists should be surrounded by blank lines
+MD032: false
+blanks-around-lists: false
+
+# MD033: Inline HTML (disallows raw HTML in markdown)
+MD033: false
+no-inline-html: false
+
+# MD034: Bare URL used (disallows URLs not in angle brackets)
+MD034: false
+no-bare-urls: false
+
+# MD036: Emphasis used instead of a heading (disallows using bold/italic as section headers)
+MD036: false
+no-emphasis-as-heading: false
+
+# MD040: Fenced code blocks should have a language specified
+MD040: false
+fenced-code-language: false
+
+# MD041: First line in file should be a top-level heading
+MD041: false
+first-line-heading: false
+first-line-h1: false
+
+# MD047: Files should end with a single newline character
+MD047: false
+single-trailing-newline: false
+
+# MD051: Link fragment should be valid
+MD051: false
+link-title-style: false
+
+# MD055: Table pipe style (enforces consistent table pipe style)
+MD055: false
+table-pipe-style: false
+
+# MD058: Blank lines around tables (enforces blank lines before/after tables)
+MD058: false
+blanks-around-tables: false
+