Correct stale Code2Logic API examples and canonical links

.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

.gitignore

@@ -190,3 +190,5 @@ webops/
 .pyqual/
 .ruff_cache/
 .taskill/
+
+/.worktrees/

.governance/docs.json

@@ -0,0 +1,7 @@
+{
+  "schema": "wellmanifest.docs/adoption/v1",
+  "repository": "semcod/code2logic",
+  "standard": "wellmanifest/docs",
+  "source_revision": "ebe7501063ef4f3e63ded610c2d3183010ca636e",
+  "policy_sha256": "f6ba9c011ea1d9260e7fac3a1638a767d5ebc9f7d9b32ed51cc3aea22fe95d8c"
+}

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)

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)

docs/13-architecture.md → 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
+
+<!-- docs:section purpose -->
+## Purpose
+
+Describe the current Python API and extension points.
+
+<!-- docs:section scope -->
+## Scope
+
+This reference describes the repository revision above. Optional LLM clients require their configured provider dependencies.
+
+<!-- docs:section evidence -->
+## 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.
+
+<!-- docs:section content -->
 # 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)
+
+
+<!-- docs:section limitations -->
+## 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.
+
+<!-- docs:section next_actions -->
+## Maintenance
+
+Update this reference and its declared version when the public API changes.

docs/10-benchmark.md → 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)
+<!-- docs:section purpose -->
+## Purpose
+
+Preserve this reference while migrating links to the maintained canonical API documentation.
+
+<!-- docs:section scope -->
+## 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.
+
+<!-- docs:section evidence -->
+## Evidence
+
+The immutable original document is linked in metadata. Current API corrections are documented in the project documentation index.
+
+<!-- docs:section content -->
+# Code2Logic Benchmark Guide
+
+[← README](../../README.md) | [Docs Index](index.md)
 
 ## Overview
 
@@ -274,3 +314,14 @@ Benchmark results are saved to:
 
 
 
+
+
+<!-- docs:section limitations -->
+## Limits
+
+Unchanged historical examples remain subject to their original assumptions. Placement conformance does not establish semantic correctness or deployment.
+
+<!-- docs:section next_actions -->
+## Maintenance
+
+Update this declared version when changing its substantive findings.