diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 0def072..e4cf158 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -10,7 +10,7 @@ jobs: strategy: fail-fast: false matrix: - python-version: ["3.9", "3.10", "3.11", "3.12"] + python-version: ["3.11", "3.12", "3.13"] steps: - uses: actions/checkout@v4 @@ -25,7 +25,7 @@ jobs: run: python -m pip install --upgrade pip - name: Install package (with test deps) - run: python -m pip install -e ".[dev,full]" + run: python -m pip install -e ".[dev]" - name: Compile run: python -m compileall -q code2logic diff --git a/.gitignore b/.gitignore index 1355c81..dde36d8 100644 --- a/.gitignore +++ b/.gitignore @@ -190,3 +190,5 @@ webops/ .pyqual/ .ruff_cache/ .taskill/ + +/.worktrees/ diff --git a/.governance/docs.json b/.governance/docs.json new file mode 100644 index 0000000..dc75f49 --- /dev/null +++ b/.governance/docs.json @@ -0,0 +1,7 @@ +{ + "schema": "wellmanifest.docs/adoption/v1", + "repository": "semcod/code2logic", + "standard": "wellmanifest/docs", + "source_revision": "ebe7501063ef4f3e63ded610c2d3183010ca636e", + "policy_sha256": "f6ba9c011ea1d9260e7fac3a1638a767d5ebc9f7d9b32ed51cc3aea22fe95d8c" +} diff --git a/README.md b/README.md index b38143b..2ac9cbf 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ## AI Cost Tracking -![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-1.0.50-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green) +![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-1.0.50-blue) ![Python](https://img.shields.io/badge/python-3.11+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green) ![AI Cost](https://img.shields.io/badge/AI%20Cost-$13.04-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-65.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey) - πŸ€– **LLM usage:** $13.0434 (125 commits) diff --git a/docs/00-index.md b/docs/00-index.md deleted file mode 100644 index cc91754..0000000 --- a/docs/00-index.md +++ /dev/null @@ -1,96 +0,0 @@ -# Code2Logic Documentation - -Convert source code to logical representation for LLM analysis - -[← README](../README.md) - -## Quick Navigation - -| # | Document | Description | -| --- | -------- | ----------- | -| 01 | [Getting Started](01-getting-started.md) | Installation and first steps | -| 02 | [Configuration](02-configuration.md) | API keys, environment setup | -| 03 | [CLI Reference](03-cli-reference.md) | Command-line usage | -| 04 | [Python API](04-python-api.md) | Programmatic usage | -| 05 | [Output Formats](05-output-formats.md) | Format comparison and usage | -| 06 | [Format Specifications](06-format-specifications.md) | Detailed format specs | -| 07 | [TOON Format](07-toon.md) | Token-Oriented Object Notation | -| 08 | [LLM Integration](08-llm-integration.md) | OpenRouter, Ollama, LiteLLM | -| 09 | [LLM Comparison](09-llm-comparison-report.md) | Provider/model comparison | -| 10 | [Benchmarking](10-benchmark.md) | Benchmark methodology | -| 11 | [Repeatability](11-repeatability.md) | Repeatability testing | -| 12 | [Examples](12-examples.md) | Usage examples and workflows | -| 13 | [Architecture](13-architecture.md) | System design and components | -| 14 | [Format Analysis](14-format-analysis.md) | Deeper format evaluation | -| 15 | [Logic2Test](15-logic2test.md) | Test generation from logic files | -| 16 | [Logic2Code](16-logic2code.md) | Code generation from logic files | -| 17 | [LOLM](17-lolm.md) | LLM provider management | -| 18 | [Reproduction Testing](18-reproduction-testing.md) | Format validation and code regeneration | -| 19 | [Monorepo Workflow](19-monorepo-workflow.md) | Managing all packages from repo root | -| 20 | [LLM Benchmarks + Claude](20-llm-benchmarks-claude.md) | Run benchmarks with LLM enabled and force Claude (Anthropic) | - -## Repository Links - -- [README](../README.md) -- [Changelog](../CHANGELOG.md) -- [Refactoring Plan](../TODO.md) - -## Overview - -Code2Logic analyzes codebases and generates structured representations optimized for LLM consumption. It supports multiple output formats, each designed for specific use cases. - -### Key Features - -| Feature | Description | -| ------- | ----------- | -| Multi-format output | Markdown, JSON, YAML, TOON, LogicML, Gherkin, CSV | -| LLM-optimized | Token-efficient formats (TOON is 5.9x smaller than JSON) | -| TOON-Hybrid | Project structure + selective function details for hub modules | -| AST-based scoring | Accurate structural comparison using Python AST | -| Duplicate Detection | Find similar/duplicate functions | -| Dependency Analysis | PageRank, hub detection, clustering | -| Multiple Languages | Python, JavaScript, TypeScript, Go, Rust, Java | - -### Format Comparison (Feb 2026, 20 files) - -| Format | Score | ~Tokens | Efficiency (p/kT) | Best For | -| ------ | -----:| -------:| ---------:| -------- | -| **toon** | **63,8%** | 17 875 | **3,57** | Token efficiency (smallest) | -| json | 62,9% | 104 914 | 0,60 | RAG/embeddings | -| markdown | 62,5% | 36 851 | 1,70 | Documentation | -| yaml | 62,4% | 68 651 | 0,91 | Human + LLM | -| logicml | 60,4% | ~30 000 | ~2,01 | Compression + typed sigs | -| csv | 53,0% | 80 779 | 0,66 | Data analysis | -| function.toon | 49,3% | 29 271 | 1,68 | Function-level detail | -| gherkin | 38,6% | ~25 000 | ~1,54 | BDD scenarios | - -# Install -pip install code2logic - -# Analyze project -code2logic /path/to/project -f gherkin -o analysis.feature - -# With Python -from code2logic import analyze_project -project = analyze_project("/path/to/project") -print(f"Files: {project.total_files}") -``` - -# Set API keys for LLM features -export OPENROUTER_API_KEY="sk-or-v1-..." -export OLLAMA_HOST="http://localhost:11434" - -# Or use .env file -cp .env.example .env -# Edit .env with your keys -``` - -See [Configuration Guide](02-configuration.md) for details. - -## Links - -- [GitHub Repository](https://github.com/wronai/code2logic) -- [PyPI Package](https://pypi.org/project/code2logic) -- [Issue Tracker](https://github.com/wronai/code2logic/issues) - -Generated by Code2Logic diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..880ebbd --- /dev/null +++ b/docs/README.md @@ -0,0 +1,27 @@ +# Code2Logic documentation + +## Current API references + +- [Python API](information/python-api.md) +- [LLM integration](information/llm-integration.md) +- [Architecture and extension contracts](information/architecture.md) + +- [index](information/index.md) + +- [getting-started](information/getting-started.md) + +- [cli-reference](information/cli-reference.md) + +- [output-formats](information/output-formats.md) + +- [toon](information/toon.md) + +- [examples](information/examples.md) + +- [llm-benchmarks-claude](information/llm-benchmarks-claude.md) + +- [configuration](information/configuration.md) + +- [benchmark](information/benchmark.md) + +- [repeatability](information/repeatability.md) diff --git a/docs/13-architecture.md b/docs/information/architecture.md similarity index 81% rename from docs/13-architecture.md rename to docs/information/architecture.md index 3a432bb..5c365b2 100644 --- a/docs/13-architecture.md +++ b/docs/information/architecture.md @@ -1,8 +1,50 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "architecture", + "kind": "information", + "version": 1, + "title": "Architecture and extension contracts", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/code2logic/llm/__init__.py", + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/code2logic/base.py", + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/13-architecture.md" + ] +} +--- + +# Architecture and extension contracts + + +## Purpose + +Describe the current Python API and extension points. + + +## Scope + +This reference describes the repository revision above. Optional LLM clients require their configured provider dependencies. + + +## Evidence + +The exported client is `OllamaLocalClient`; the base classes are owned by `code2logic.base`. The previous reference remains auditable at the immutable source URL in metadata. The May formatting commit touched code and docs together; it does not establish semantic recency. A later August documentation edit changed unrelated MCP guidance, leaving the old client import unchanged. + + # Architecture > System design and component overview -[← README](../README.md) | [← Examples](12-examples.md) | [Index β†’](00-index.md) +[← README](../../README.md) | [← Examples](examples.md) | [Index β†’](index.md) ## System Overview @@ -212,7 +254,7 @@ code2logic/ ### Adding New Generator ```python -from code2logic.generators import BaseGenerator +from code2logic.base import BaseGenerator class CustomGenerator(BaseGenerator): def generate(self, project: ProjectInfo, **kwargs) -> str: @@ -223,7 +265,7 @@ class CustomGenerator(BaseGenerator): ### Adding New Parser ```python -from code2logic.parsers import BaseParser +from code2logic.base import BaseParser class CustomParser(BaseParser): def parse_file(self, path: str) -> ModuleInfo: @@ -251,10 +293,21 @@ class CustomClient(BaseLLMClient): ## See Also -- [Python API](04-python-api.md) - Detailed API reference -- [Configuration](02-configuration.md) - Setup guide -- [TODO.md](../TODO.md) - Refactoring roadmap +- [Python API](python-api.md) - Detailed API reference +- [Configuration](configuration.md) - Setup guide +- [TODO.md](../../TODO.md) - Refactoring roadmap --- -[← Examples](12-examples.md) | [Index β†’](00-index.md) +[← Examples](examples.md) | [Index β†’](index.md) + + + +## Validation limits + +The corrected imports were checked against source definitions and exports. Provider requests and tutorial workloads were not executed; their credentials and external services remain explicit prerequisites. + + +## Maintenance + +Update this reference and its declared version when the public API changes. diff --git a/docs/10-benchmark.md b/docs/information/benchmark.md similarity index 84% rename from docs/10-benchmark.md rename to docs/information/benchmark.md index 5d9bd48..3f8d41e 100644 --- a/docs/10-benchmark.md +++ b/docs/information/benchmark.md @@ -1,6 +1,46 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "benchmark", + "kind": "information", + "version": 1, + "title": "Code2Logic Benchmark Guide", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/10-benchmark.md" + ] +} +--- + # Code2Logic Benchmark Guide -[← README](../README.md) | [Docs Index](00-index.md) + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + +# Code2Logic Benchmark Guide + +[← README](../../README.md) | [Docs Index](index.md) ## Overview @@ -274,3 +314,14 @@ Benchmark results are saved to: + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/03-cli-reference.md b/docs/information/cli-reference.md similarity index 81% rename from docs/03-cli-reference.md rename to docs/information/cli-reference.md index f964624..30fde47 100644 --- a/docs/03-cli-reference.md +++ b/docs/information/cli-reference.md @@ -1,8 +1,48 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "cli-reference", + "kind": "information", + "version": 1, + "title": "CLI Reference", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/03-cli-reference.md" + ] +} +--- + +# CLI Reference + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + # CLI Reference > Command-line interface for Code2Logic -[← README](../README.md) | [← Configuration](02-configuration.md) | [Python API β†’](04-python-api.md) +[← README](../../README.md) | [← Configuration](configuration.md) | [Python API β†’](python-api.md) ## Basic Usage @@ -240,11 +280,22 @@ CODE2LOGIC_VERBOSE=true code2logic /path/to/project ## See Also -- [Output Formats](05-output-formats.md) - Detailed format comparison -- [Python API](04-python-api.md) - Programmatic usage -- [Examples](12-examples.md) - More usage examples -- [LLM Integration](08-llm-integration.md) - Provider setup and LLM workflows +- [Output Formats](output-formats.md) - Detailed format comparison +- [Python API](python-api.md) - Programmatic usage +- [Examples](examples.md) - More usage examples +- [LLM Integration](llm-integration.md) - Provider setup and LLM workflows --- -[← Configuration](02-configuration.md) | [Python API β†’](04-python-api.md) +[← Configuration](configuration.md) | [Python API β†’](python-api.md) + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/02-configuration.md b/docs/information/configuration.md similarity index 72% rename from docs/02-configuration.md rename to docs/information/configuration.md index 6669f62..7afe8f8 100644 --- a/docs/02-configuration.md +++ b/docs/information/configuration.md @@ -1,8 +1,48 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "configuration", + "kind": "information", + "version": 1, + "title": "Configuration Guide", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/02-configuration.md" + ] +} +--- + +# Configuration Guide + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + # Configuration Guide > Setting up API keys, environment variables, and LLM providers -[← README](../README.md) | [← Back to Index](00-index.md) | [CLI Reference β†’](03-cli-reference.md) +[← README](../../README.md) | [← Back to Index](index.md) | [CLI Reference β†’](cli-reference.md) ## Environment Variables @@ -206,4 +246,15 @@ Error: Model qwen2.5-coder:14b not found --- -[← Back to Index](00-index.md) | [CLI Reference β†’](03-cli-reference.md) +[← Back to Index](index.md) | [CLI Reference β†’](cli-reference.md) + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/12-examples.md b/docs/information/examples.md similarity index 54% rename from docs/12-examples.md rename to docs/information/examples.md index 5850d62..d40cb4c 100644 --- a/docs/12-examples.md +++ b/docs/information/examples.md @@ -1,35 +1,75 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "examples", + "kind": "information", + "version": 1, + "title": "Examples", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/12-examples.md" + ] +} +--- + +# Examples + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + # Examples > Usage examples and workflows for Code2Logic -[← README](../README.md) | [← LLM Integration](08-llm-integration.md) | [Architecture β†’](13-architecture.md) +[← README](../../README.md) | [← LLM Integration](llm-integration.md) | [Architecture β†’](architecture.md) ## Available Examples All examples are in the `examples/` folder: -- [examples/run_examples.sh](../examples/run_examples.sh) - Example runner script (multi-command workflows) -- [examples/code2logic/](../examples/code2logic/) - Minimal project + Docker example for code2logic -- [examples/logic2test/](../examples/logic2test/) - Minimal project + Docker example for logic2test -- [examples/logic2code/](../examples/logic2code/) - Minimal project + Docker example for logic2code +- [examples/run_examples.sh](../../examples/run_examples.sh) - Example runner script (multi-command workflows) +- [examples/code2logic/](../../examples/code2logic) - Minimal project + Docker example for code2logic +- [examples/logic2test/](../../examples/logic2test) - Minimal project + Docker example for logic2test +- [examples/logic2code/](../../examples/logic2code) - Minimal project + Docker example for logic2code | Example | Description | | --- | --- | -| [01_quick_start.py](../examples/01_quick_start.py) | Basic usage guide | -| [02_refactoring.py](../examples/02_refactoring.py) | Duplicate + quality analysis | -| [03_reproduction.py](../examples/03_reproduction.py) | Reproduce code from specs | -| [04_project.py](../examples/04_project.py) | Project-level reproduction | -| [05_llm_integration.py](../examples/05_llm_integration.py) | LLM integration demo | -| [06_metrics.py](../examples/06_metrics.py) | Detailed reproduction metrics | -| [08_format_benchmark.py](../examples/08_format_benchmark.py) | Benchmark formats across files | -| [09_async_benchmark.py](../examples/09_async_benchmark.py) | Parallel benchmark with multi-provider LLM | -| [10_function_reproduction.py](../examples/10_function_reproduction.py) | Function-level reproduction | -| [11_token_benchmark.py](../examples/11_token_benchmark.py) | Token-aware benchmark | -| [12_comprehensive_analysis.py](../examples/12_comprehensive_analysis.py) | Post-run analysis of generated outputs | -| [13_project_benchmark.py](../examples/13_project_benchmark.py) | Whole-project structure benchmark | -| [14_repeatability_test.py](../examples/14_repeatability_test.py) | Repeatability testing | -| [15_unified_benchmark.py](../examples/15_unified_benchmark.py) | Unified benchmark runner example | -| [16_terminal_demo.py](../examples/16_terminal_demo.py) | Terminal markdown rendering demo | +| [01_quick_start.py](../../examples/01_quick_start.py) | Basic usage guide | +| [02_refactoring.py](../../examples/02_refactoring.py) | Duplicate + quality analysis | +| [03_reproduction.py](../../examples/03_reproduction.py) | Reproduce code from specs | +| [04_project.py](../../examples/04_project.py) | Project-level reproduction | +| [05_llm_integration.py](../../examples/05_llm_integration.py) | LLM integration demo | +| [06_metrics.py](../../examples/06_metrics.py) | Detailed reproduction metrics | +| [08_format_benchmark.py](../../examples/08_format_benchmark.py) | Benchmark formats across files | +| [09_async_benchmark.py](../../examples/09_async_benchmark.py) | Parallel benchmark with multi-provider LLM | +| [10_function_reproduction.py](../../examples/10_function_reproduction.py) | Function-level reproduction | +| [11_token_benchmark.py](../../examples/11_token_benchmark.py) | Token-aware benchmark | +| [12_comprehensive_analysis.py](../../examples/12_comprehensive_analysis.py) | Post-run analysis of generated outputs | +| [13_project_benchmark.py](../../examples/13_project_benchmark.py) | Whole-project structure benchmark | +| [14_repeatability_test.py](../../examples/14_repeatability_test.py) | Repeatability testing | +| [15_unified_benchmark.py](../../examples/15_unified_benchmark.py) | Unified benchmark runner example | +| [16_terminal_demo.py](../../examples/16_terminal_demo.py) | Terminal markdown rendering demo | ## Quick Start @@ -219,10 +259,21 @@ python examples/16_terminal_demo.py --folder tests/samples/ ## See Also -- [CLI Reference](03-cli-reference.md) - Command-line options -- [Python API](04-python-api.md) - Programmatic interface -- [LLM Integration](08-llm-integration.md) - LLM provider setup +- [CLI Reference](cli-reference.md) - Command-line options +- [Python API](python-api.md) - Programmatic interface +- [LLM Integration](llm-integration.md) - LLM provider setup --- -[← LLM Integration](08-llm-integration.md) | [Architecture β†’](13-architecture.md) +[← LLM Integration](llm-integration.md) | [Architecture β†’](architecture.md) + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/01-getting-started.md b/docs/information/getting-started.md similarity index 60% rename from docs/01-getting-started.md rename to docs/information/getting-started.md index e9e42f3..396fbba 100644 --- a/docs/01-getting-started.md +++ b/docs/information/getting-started.md @@ -1,8 +1,48 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "getting-started", + "kind": "information", + "version": 2, + "title": "Getting Started", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/01-getting-started.md" + ] +} +--- + +# Getting Started + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + # Getting Started > Quick installation and first steps with Code2Logic -[← README](../README.md) | [← Index](00-index.md) | [Configuration β†’](02-configuration.md) +[← README](../../README.md) | [← Index](index.md) | [Configuration β†’](configuration.md) ### From PyPI @@ -10,6 +50,10 @@ pip install code2logic ``` +Code2Logic requires Python 3.11 or newer. This is set by the mandatory +`subactor-subllm` runtime dependency and is verified by the 3.11, 3.12 and 3.13 +CI matrix. + ### From Source ```bash @@ -120,7 +164,7 @@ make build-subpackages make publish-all ``` -See: [Monorepo Workflow](19-monorepo-workflow.md). +See: [Monorepo Workflow](../19-monorepo-workflow.md). ## Examples @@ -142,11 +186,22 @@ python examples/02_refactoring.py ./my_project ## Next Steps -1. [Configure API keys](02-configuration.md) for LLM features -2. Learn [CLI commands](03-cli-reference.md) -3. Explore [Python API](04-python-api.md) -4. Try [Examples](12-examples.md) +1. [Configure API keys](configuration.md) for LLM features +2. Learn [CLI commands](cli-reference.md) +3. Explore [Python API](python-api.md) +4. Try [Examples](examples.md) --- -[← Index](00-index.md) | [Configuration β†’](02-configuration.md) +[← Index](index.md) | [Configuration β†’](configuration.md) + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/information/index.md b/docs/information/index.md new file mode 100644 index 0000000..6d39006 --- /dev/null +++ b/docs/information/index.md @@ -0,0 +1,147 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "index", + "kind": "information", + "version": 1, + "title": "Code2Logic Documentation", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/00-index.md" + ] +} +--- + +# Code2Logic Documentation + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + +# Code2Logic Documentation + +Convert source code to logical representation for LLM analysis + +[← README](../../README.md) + +## Quick Navigation + +| # | Document | Description | +| --- | -------- | ----------- | +| 01 | [Getting Started](getting-started.md) | Installation and first steps | +| 02 | [Configuration](configuration.md) | API keys, environment setup | +| 03 | [CLI Reference](cli-reference.md) | Command-line usage | +| 04 | [Python API](python-api.md) | Programmatic usage | +| 05 | [Output Formats](output-formats.md) | Format comparison and usage | +| 06 | [Format Specifications](../06-format-specifications.md) | Detailed format specs | +| 07 | [TOON Format](toon.md) | Token-Oriented Object Notation | +| 08 | [LLM Integration](llm-integration.md) | OpenRouter, Ollama, LiteLLM | +| 09 | [LLM Comparison](../09-llm-comparison-report.md) | Provider/model comparison | +| 10 | [Benchmarking](benchmark.md) | Benchmark methodology | +| 11 | [Repeatability](repeatability.md) | Repeatability testing | +| 12 | [Examples](examples.md) | Usage examples and workflows | +| 13 | [Architecture](architecture.md) | System design and components | +| 14 | [Format Analysis](../14-format-analysis.md) | Deeper format evaluation | +| 15 | [Logic2Test](../15-logic2test.md) | Test generation from logic files | +| 16 | [Logic2Code](../16-logic2code.md) | Code generation from logic files | +| 17 | [LOLM](../17-lolm.md) | LLM provider management | +| 18 | [Reproduction Testing](../18-reproduction-testing.md) | Format validation and code regeneration | +| 19 | [Monorepo Workflow](../19-monorepo-workflow.md) | Managing all packages from repo root | +| 20 | [LLM Benchmarks + Claude](llm-benchmarks-claude.md) | Run benchmarks with LLM enabled and force Claude (Anthropic) | + +## Repository Links + +- [README](../../README.md) +- [Changelog](../../CHANGELOG.md) +- [Refactoring Plan](../../TODO.md) + +## Overview + +Code2Logic analyzes codebases and generates structured representations optimized for LLM consumption. It supports multiple output formats, each designed for specific use cases. + +### Key Features + +| Feature | Description | +| ------- | ----------- | +| Multi-format output | Markdown, JSON, YAML, TOON, LogicML, Gherkin, CSV | +| LLM-optimized | Token-efficient formats (TOON is 5.9x smaller than JSON) | +| TOON-Hybrid | Project structure + selective function details for hub modules | +| AST-based scoring | Accurate structural comparison using Python AST | +| Duplicate Detection | Find similar/duplicate functions | +| Dependency Analysis | PageRank, hub detection, clustering | +| Multiple Languages | Python, JavaScript, TypeScript, Go, Rust, Java | + +### Format Comparison (Feb 2026, 20 files) + +| Format | Score | ~Tokens | Efficiency (p/kT) | Best For | +| ------ | -----:| -------:| ---------:| -------- | +| **toon** | **63,8%** | 17 875 | **3,57** | Token efficiency (smallest) | +| json | 62,9% | 104 914 | 0,60 | RAG/embeddings | +| markdown | 62,5% | 36 851 | 1,70 | Documentation | +| yaml | 62,4% | 68 651 | 0,91 | Human + LLM | +| logicml | 60,4% | ~30 000 | ~2,01 | Compression + typed sigs | +| csv | 53,0% | 80 779 | 0,66 | Data analysis | +| function.toon | 49,3% | 29 271 | 1,68 | Function-level detail | +| gherkin | 38,6% | ~25 000 | ~1,54 | BDD scenarios | + +# Install +pip install code2logic + +# Analyze project +code2logic /path/to/project -f gherkin -o analysis.feature + +# With Python +from code2logic import analyze_project +project = analyze_project("/path/to/project") +print(f"Files: {project.total_files}") +``` + +# Set API keys for LLM features +export OPENROUTER_API_KEY="sk-or-v1-..." +export OLLAMA_HOST="http://localhost:11434" + +# Or use .env file +cp .env.example .env +# Edit .env with your keys +``` + +See [Configuration Guide](configuration.md) for details. + +## Links + +- [GitHub Repository](https://github.com/wronai/code2logic) +- [PyPI Package](https://pypi.org/project/code2logic) +- [Issue Tracker](https://github.com/wronai/code2logic/issues) + +Generated by Code2Logic + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/20-llm-benchmarks-claude.md b/docs/information/llm-benchmarks-claude.md similarity index 64% rename from docs/20-llm-benchmarks-claude.md rename to docs/information/llm-benchmarks-claude.md index 0e1bd10..8810f4e 100644 --- a/docs/20-llm-benchmarks-claude.md +++ b/docs/information/llm-benchmarks-claude.md @@ -1,6 +1,46 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "llm-benchmarks-claude", + "kind": "information", + "version": 1, + "title": "LLM Benchmarks + Claude (Anthropic)", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/20-llm-benchmarks-claude.md" + ] +} +--- + +# LLM Benchmarks + Claude (Anthropic) + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + # LLM Benchmarks + Claude (Anthropic) -[← Docs Index](00-index.md) | [← Benchmarking](10-benchmark.md) | [← LLM Integration](08-llm-integration.md) +[← Docs Index](index.md) | [← Benchmarking](benchmark.md) | [← LLM Integration](llm-integration.md) This document focuses on running Code2Logic benchmarks **with an LLM enabled**, including how to force **Claude (Anthropic)** via provider/model selection. @@ -106,3 +146,14 @@ Guidance: - **No provider available**: configure keys/models in `.env` or via `code2logic llm ...` (see `08-llm-integration.md`). - **Rate limited**: reduce `--workers`, consider cheaper/faster model (e.g. Haiku), or switch provider. - **Weird output (explanations instead of code)**: use stricter prompts or lower temperature on provider side; benchmark runner already tries to extract fenced code blocks. + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/08-llm-integration.md b/docs/information/llm-integration.md similarity index 79% rename from docs/08-llm-integration.md rename to docs/information/llm-integration.md index 0b95001..3530318 100644 --- a/docs/08-llm-integration.md +++ b/docs/information/llm-integration.md @@ -1,8 +1,50 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "llm-integration", + "kind": "information", + "version": 1, + "title": "LLM integration", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/code2logic/llm/__init__.py", + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/code2logic/base.py", + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/08-llm-integration.md" + ] +} +--- + +# LLM integration + + +## Purpose + +Describe the current Python API and extension points. + + +## Scope + +This reference describes the repository revision above. Optional LLM clients require their configured provider dependencies. + + +## Evidence + +The exported client is `OllamaLocalClient`; the base classes are owned by `code2logic.base`. The previous reference remains auditable at the immutable source URL in metadata. The May formatting commit touched code and docs together; it does not establish semantic recency. A later August documentation edit changed unrelated MCP guidance, leaving the old client import unchanged. + + # LLM Integration Guide > Using Code2Logic with Large Language Models -[← README](../README.md) | [← Output Formats](05-output-formats.md) | [Examples β†’](12-examples.md) +[← README](../../README.md) | [← Output Formats](output-formats.md) | [Examples β†’](examples.md) ## Overview @@ -153,13 +195,13 @@ code2logic llm priority set-mode mixed ```python from code2logic import analyze_project -from code2logic.llm import OllamaClient +from code2logic.llm import OllamaLocalClient # Analyze code project = analyze_project("./my_project") # Use Ollama -client = OllamaClient(model="qwen2.5-coder:14b") +client = OllamaLocalClient(model="qwen2.5-coder:14b") response = client.generate( prompt=f"Analyze this project:\n{project.total_files} files", system="You are a code reviewer." @@ -344,8 +386,19 @@ For Claude Desktop / Windsurf: } ``` -See [Examples](12-examples.md) for more integration patterns. +See [Examples](examples.md) for more integration patterns. --- -[← Output Formats](05-output-formats.md) | [Examples β†’](12-examples.md) +[← Output Formats](output-formats.md) | [Examples β†’](examples.md) + + + +## Validation limits + +The corrected imports were checked against source definitions and exports. Provider requests and tutorial workloads were not executed; their credentials and external services remain explicit prerequisites. + + +## Maintenance + +Update this reference and its declared version when the public API changes. diff --git a/docs/05-output-formats.md b/docs/information/output-formats.md similarity index 76% rename from docs/05-output-formats.md rename to docs/information/output-formats.md index b658843..f798f8d 100644 --- a/docs/05-output-formats.md +++ b/docs/information/output-formats.md @@ -1,8 +1,48 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "output-formats", + "kind": "information", + "version": 1, + "title": "Output Formats", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/05-output-formats.md" + ] +} +--- + +# Output Formats + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + # Output Formats > Comparison and usage guide for all output formats -[← README](../README.md) | [← Python API](04-python-api.md) | [LLM Integration β†’](08-llm-integration.md) +[← README](../../README.md) | [← Python API](python-api.md) | [LLM Integration β†’](llm-integration.md) ## Format Overview @@ -317,12 +357,23 @@ Need async code handling? β†’ LogicML ## See Also -- [TOON Format](07-toon.md) - Token-Oriented Object Notation -- [Format Specifications](06-format-specifications.md) - Detailed format specs -- [CLI Reference](03-cli-reference.md) - Command-line options -- [LLM Integration](08-llm-integration.md) - Using with LLMs -- [examples/11_token_benchmark.py](../examples/11_token_benchmark.py) - Token-aware benchmark +- [TOON Format](toon.md) - Token-Oriented Object Notation +- [Format Specifications](../06-format-specifications.md) - Detailed format specs +- [CLI Reference](cli-reference.md) - Command-line options +- [LLM Integration](llm-integration.md) - Using with LLMs +- [examples/11_token_benchmark.py](../../examples/11_token_benchmark.py) - Token-aware benchmark --- -[← Python API](04-python-api.md) | [LLM Integration β†’](08-llm-integration.md) +[← Python API](python-api.md) | [LLM Integration β†’](llm-integration.md) + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/04-python-api.md b/docs/information/python-api.md similarity index 80% rename from docs/04-python-api.md rename to docs/information/python-api.md index dca5354..3b8f5ac 100644 --- a/docs/04-python-api.md +++ b/docs/information/python-api.md @@ -1,8 +1,50 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "python-api", + "kind": "information", + "version": 1, + "title": "Python API", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/code2logic/llm/__init__.py", + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/code2logic/base.py", + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/04-python-api.md" + ] +} +--- + +# Python API + + +## Purpose + +Describe the current Python API and extension points. + + +## Scope + +This reference describes the repository revision above. Optional LLM clients require their configured provider dependencies. + + +## Evidence + +The exported client is `OllamaLocalClient`; the base classes are owned by `code2logic.base`. The previous reference remains auditable at the immutable source URL in metadata. The May formatting commit touched code and docs together; it does not establish semantic recency. A later August documentation edit changed unrelated MCP guidance, leaving the old client import unchanged. + + # Python API Reference > Programmatic usage of Code2Logic -[← README](../README.md) | [← CLI Reference](03-cli-reference.md) | [Output Formats β†’](05-output-formats.md) +[← README](../../README.md) | [← CLI Reference](cli-reference.md) | [Output Formats β†’](output-formats.md) ## Package Structure @@ -385,7 +427,7 @@ similar = detector.find_similar(func1, func2) from code2logic import analyze_project from code2logic.generators import CSVGenerator from code2logic.gherkin import GherkinGenerator -from code2logic.llm import OllamaClient +from code2logic.llm import OllamaLocalClient # 1. Analyze project project = analyze_project("./my_project") @@ -403,7 +445,7 @@ with open("analysis.feature", "w") as f: f.write(gherkin) # 4. Use with LLM -client = OllamaClient(model="qwen2.5-coder:7b") +client = OllamaLocalClient(model="qwen2.5-coder:7b") if client.is_available(): response = client.generate( prompt=f"Review this code structure:\n{gherkin[:2000]}", @@ -414,4 +456,15 @@ if client.is_available(): --- -[← CLI Reference](03-cli-reference.md) | [Output Formats β†’](05-output-formats.md) +[← CLI Reference](cli-reference.md) | [Output Formats β†’](output-formats.md) + + + +## Validation limits + +The corrected imports were checked against source definitions and exports. Provider requests and tutorial workloads were not executed; their credentials and external services remain explicit prerequisites. + + +## Maintenance + +Update this reference and its declared version when the public API changes. diff --git a/docs/11-repeatability.md b/docs/information/repeatability.md similarity index 55% rename from docs/11-repeatability.md rename to docs/information/repeatability.md index b0dd8a8..d401f00 100644 --- a/docs/11-repeatability.md +++ b/docs/information/repeatability.md @@ -1,5 +1,45 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "repeatability", + "kind": "information", + "version": 1, + "title": "Test powtarzalno\u015bci (3 runy)", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/11-repeatability.md" + ] +} +--- -[← README](../README.md) | [Docs Index](00-index.md) +# Test powtarzalnoΕ›ci (3 runy) + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + + +[← README](../../README.md) | [Docs Index](index.md) ### Wyniki Testu (3 uruchomienia) @@ -70,4 +110,14 @@ python examples/14_repeatability_test.py \ 2. **Docstringi** - rΓ³ΕΌne formatowanie 3. **Implementacja** - rΓ³ΕΌne podejΕ›cie do tej samej logiki 4. **Nazwy zmiennych** - czasem rΓ³ΕΌne nazwy pomocnicze -5. **Komentarze** - dodatkowe lub brakujΔ…ce \ No newline at end of file +5. **Komentarze** - dodatkowe lub brakujΔ…ce + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/docs/07-toon.md b/docs/information/toon.md similarity index 85% rename from docs/07-toon.md rename to docs/information/toon.md index d2ae2e9..5cf9bf4 100644 --- a/docs/07-toon.md +++ b/docs/information/toon.md @@ -1,8 +1,48 @@ +--- +{ + "schema": "wellmanifest.docs/document/v1", + "id": "toon", + "kind": "information", + "version": 1, + "title": "TOON Format", + "status": "proposed", + "owner": "semcod/code2logic", + "created": "2026-09-09", + "updated": "2026-09-09", + "review_after": "2026-10-09", + "source_revision": "670066ca7c2383de95c85ab13740a3c34b1d9acb", + "affected_repositories": [ + "semcod/code2logic" + ], + "evidence": [ + "https://github.com/semcod/code2logic/blob/670066ca7c2383de95c85ab13740a3c34b1d9acb/docs/07-toon.md" + ] +} +--- + +# TOON Format + + +## Purpose + +Preserve this reference while migrating links to the maintained canonical API documentation. + + +## Scope + +The original material below is retained from the source revision in metadata. This migration updates its placement and relative links; it is not a fresh validation of every historical example. + + +## Evidence + +The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index. + + # TOON Format > Token-Oriented Object Notation - Ultra-compact format for LLM consumption -[← README](../README.md) | [← Index](00-index.md) | [Format Specs β†’](06-format-specifications.md) +[← README](../../README.md) | [← Index](index.md) | [Format Specs β†’](../06-format-specifications.md) ## Overview @@ -433,11 +473,22 @@ python examples/12_comprehensive_analysis.py ## See Also -- [Output Formats](05-output-formats.md) - All format comparison -- [Format Specifications](06-format-specifications.md) - Detailed specs -- [Benchmarking](10-benchmark.md) - Benchmark results +- [Output Formats](output-formats.md) - All format comparison +- [Format Specifications](../06-format-specifications.md) - Detailed specs +- [Benchmarking](benchmark.md) - Benchmark results - [TOON GitHub](https://github.com/toon-format/toon) - Original spec --- -[← Format Specs](06-format-specifications.md) | [LLM Integration β†’](08-llm-integration.md) +[← Format Specs](../06-format-specifications.md) | [LLM Integration β†’](llm-integration.md) + + + +## Limits + +Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment. + + +## Maintenance + +Update this declared version when changing its substantive findings. diff --git a/project/ticket-003/README.md b/project/ticket-003/README.md new file mode 100644 index 0000000..db07ffd --- /dev/null +++ b/project/ticket-003/README.md @@ -0,0 +1,13 @@ +# ticket-003: Intent and code alignment + +- **Status**: IN_PROGRESS +- **Workflow state**: EDIT +- **Workstream**: documentation + +SESSION_EXECUTION_AUTHORIZATION: user requested detection and repair of intent/code drift using subactor/search. + +Allocation: https://github.com/semcod/code2logic/issues/3 + +AC-01: Bind discrepancies to current source and exact historical revisions. +AC-02: Repair confirmed stale behavior or documentation without changing unrelated work. +AC-03: Validate the change and distinguish local checks from protected publication. diff --git a/project/ticket-003/intent.json b/project/ticket-003/intent.json new file mode 100644 index 0000000..95f144f --- /dev/null +++ b/project/ticket-003/intent.json @@ -0,0 +1,29 @@ +{ + "schema": "new-project.intent/v3", + "ticket": "ticket-003", + "summary": "Reconcile the documented Python support floor and CI matrix with the required SubLLM runtime dependency", + "workstream": "runtime", + "classification": { + "kind": "SERVICE", + "priority": "P2", + "origin": "health" + }, + "allowedPaths": [ + "docs/**", + "README.md", + "pyproject.toml", + ".github/workflows/ci.yml", + ".gitignore", + "project/ticket-003/**", + ".governance/docs.json" + ], + "forbiddenPaths": [ + ".env", + "secrets/**", + "project/ticket-*/user-*.md" + ], + "stacks": [], + "dependsOn": [], + "conflictsWith": [], + "integrationTicket": null +} diff --git a/pyproject.toml b/pyproject.toml index ed0054a..0399995 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -7,7 +7,7 @@ name = "code2logic" version = "1.0.50" description = "High-performance Python code flow analysis with NLP query processing - CFG, DFG, call graphs, and intelligent code queries" readme = "README.md" -requires-python = ">=3.10" +requires-python = ">=3.11" license = "Apache-2.0" authors = [ {name = "Tom Sapletta", email = "tom@sapletta.com"}, @@ -26,7 +26,6 @@ classifiers = [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Programming Language :: Python :: 3", - "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12", "Programming Language :: Python :: 3.13", @@ -70,10 +69,10 @@ Issues = "https://github.com/wronai/code2logic/issues" [tool.black] line-length = 100 -target-version = ['py310'] +target-version = ['py311'] [tool.mypy] -python_version = "3.10" +python_version = "3.11" ignore_missing_imports = true [tool.pytest.ini_options]