agent-code-guard 0.1.0__py3-none-any.whl

agent_code_guard-0.1.0.dist-info/METADATA

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: agent-code-guard
+Version: 0.1.0
+Summary: Deterministic cross-language guardrails for agent-assisted development
+License-Expression: MIT
+Project-URL: Source, https://github.com/stef-k/agent-code-guard
+Project-URL: Issues, https://github.com/stef-k/agent-code-guard/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tree-sitter==0.26.0
+Requires-Dist: tree-sitter-language-pack==1.14.3
+Dynamic: license-file
+
+# Agent Code Guard
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/stef-k/agent-code-guard/main/assets/agent-code-guard-mark.svg" width="180" alt="Agent Code Guard project mark">
+</p>
+
+Deterministic guardrails for agent-assisted software development.
+
+[![Production Analysis](https://github.com/stef-k/agent-code-guard/actions/workflows/analysis.yml/badge.svg)](https://github.com/stef-k/agent-code-guard/actions/workflows/analysis.yml)
+[![Python 3.10–3.14](https://img.shields.io/badge/Python-3.10%E2%80%933.14-3776AB?logo=python&logoColor=white)](https://github.com/stef-k/agent-code-guard/blob/main/docs/platform-support.md)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/stef-k/agent-code-guard/blob/main/LICENSE)
+
+Code Guard gives coding agents objective measurements and **PASS / REVIEW /
+FAIL** signals while leaving design decisions to agent and user judgment.
+
+```text
+deterministic measurement
+        ↓
+PASS / REVIEW / FAIL
+        ↓
+agent judgment
+```
+
+## Installation
+
+[pipx](https://pipx.pypa.io/) keeps the command isolated from project
+environments:
+
+```bash
+pipx install agent-code-guard
+```
+
+See the [usage guide](https://github.com/stef-k/agent-code-guard/blob/main/docs/usage.md)
+for a virtual-environment alternative and developer installation.
+
+## Quick start
+
+Run all enabled, applicable guards over your current Git work:
+
+```bash
+code-guard . --changed-only
+```
+
+Git determines the edited-file candidates, Code Guard applies every enabled
+and applicable guard, and project or user exclusions remain authoritative. No
+configuration file is required.
+
+## Result model
+
+- **PASS** — no special action.
+- **REVIEW** — inspect the finding and decide whether meaningful improvement is
+  warranted. REVIEW is not automatic refactoring.
+- **FAIL** — blocks normal completion until fixed or an explicitly authorized
+  exception applies.
+
+**Never game the metric.** Preserve clarity and useful structure; do not create
+artificial helpers, files, abstractions, formatting, or exclusions merely to
+lower a measurement.
+
+## Default guards
+
+| Guard | Default |
+| --- | --- |
+| File LOC | REVIEW >400, FAIL >600 |
+| Callable size | REVIEW >80 physical LOC |
+| Structural nesting | REVIEW >4 |
+| Cyclomatic complexity | REVIEW >15 |
+| Markdown document size | REVIEW >800 physical lines |
+| Markdown direct-section size | REVIEW >200 physical lines |
+
+Comparisons are strictly greater-than, so equality passes. All guards except
+file LOC are REVIEW-only; only file LOC can FAIL.
+
+Agent Code Guard intentionally remains small. A new guard must provide distinct,
+deterministic agent-guardrail value rather than merely duplicate mature
+conventional tooling. See [Guard admission](https://github.com/stef-k/agent-code-guard/blob/main/docs/guard-admission.md).
+
+## Common workflows
+
+Normal Git work:
+
+```bash
+code-guard . --changed-only
+```
+
+Explicit agent-owned scope without Git:
+
+```bash
+code-guard src/Foo.py src/Bar.ts docs/guide.md
+```
+
+Pull request or branch comparison:
+
+```bash
+code-guard . --base-ref origin/main --ci
+```
+
+The actual base ref must exist or be fetched correctly in the chosen CI
+environment.
+
+Deliberate full audit:
+
+```bash
+code-guard .
+```
+
+Changed work is not a full audit. Use Git selection during normal development;
+do not repeatedly scan unrelated repository history after every edit.
+
+## Supported languages and formats
+
+Syntax guards support Python, Go, Kotlin, C#, Java, JavaScript, TypeScript, JSX,
+TSX, Vue JavaScript/TypeScript script regions, C++, Rust, PHP, Swift, and Dart.
+Markdown guards apply to `.md` files.
+
+Important boundaries:
+
+- Generic `.h` files are not syntax-dispatched because their language context
+  is ambiguous.
+- `.markdown` is not currently enabled for Markdown guards.
+- Vue template and style regions are not executable syntax input.
+- Unsupported artifacts are simply inapplicable.
+- Malformed applicable syntax or a required provider failure is a fail-closed
+  tool error, never heuristic partial analysis.
+
+See [Language support](https://github.com/stef-k/agent-code-guard/blob/main/docs/language-support.md)
+for extension and mixed-content details.
+
+## Agent integration
+
+CLI-only use requires no skill export. Each installed distribution also carries
+a version-matched Code Guard skill payload for agent workflows:
+
+```bash
+code-guard --skill-path
+code-guard --export-skill <target-directory>
+```
+
+See [Skill distribution](https://github.com/stef-k/agent-code-guard/blob/main/docs/skill-distribution.md)
+for discovery, export, and integration guarantees. The checkout compatibility
+runner is for repository and skill compatibility, not primary end-user
+installation.
+
+## Configuration
+
+Built-in defaults require no config. A minimal project configuration is:
+
+```json
+{
+  "version": 1
+}
+```
+
+Use configuration only when a project has a concrete policy reason to change a
+guard or scope. See the [Configuration guide](https://github.com/stef-k/agent-code-guard/blob/main/docs/configuration.md).
+
+## Documentation
+
+- [Documentation index](https://github.com/stef-k/agent-code-guard/blob/main/docs/README.md)
+- [Usage](https://github.com/stef-k/agent-code-guard/blob/main/docs/usage.md)
+- [Configuration](https://github.com/stef-k/agent-code-guard/blob/main/docs/configuration.md)
+- [Language support](https://github.com/stef-k/agent-code-guard/blob/main/docs/language-support.md)
+- [Platform support](https://github.com/stef-k/agent-code-guard/blob/main/docs/platform-support.md)
+- [Skill distribution](https://github.com/stef-k/agent-code-guard/blob/main/docs/skill-distribution.md)
+
+## Platform support
+
+The maintained interpreter range is **CPython 3.10–3.14**. The normal binary
+installation envelope is:
+
+- Windows x86-64 and ARM64;
+- macOS x86-64 and ARM64;
+- Linux glibc 2.34 or newer on x86-64 and ARM64.
+
+Source builds outside that binary envelope are best effort and are not
+release-supported. See [Platform support](https://github.com/stef-k/agent-code-guard/blob/main/docs/platform-support.md)
+for exact wheel and deployment boundaries.
+
+## Feedback and security
+
+Report normal defects through the [bug report form](https://github.com/stef-k/agent-code-guard/issues/new?template=bug-report.md)
+and propose new measurements through the [Candidate guard form](https://github.com/stef-k/agent-code-guard/issues/new?template=candidate-guard.md).
+For vulnerability reporting, follow the repository [Security policy](https://github.com/stef-k/agent-code-guard/blob/main/SECURITY.md).
+
+## Background and license
+
+Agent Code Guard grew from the Agent LOC Guard prototype and is now the
+canonical implementation. It remains focused on deterministic measurements
+that complement—not replace—tests, compilers, formatters, linters, security
+tools, or design judgment.
+
+Licensed under the [MIT License](https://github.com/stef-k/agent-code-guard/blob/main/LICENSE).

agent_code_guard-0.1.0.dist-info/RECORD

@@ -0,0 +1,40 @@
+agent_code_guard/__init__.py,sha256=9l0D2gP5QVcrPSEifzWEOhCTMvrT9SDYkHWr9Y9F4kk,43
+agent_code_guard/code_guard.py,sha256=KL7942CHWta2nwUQVq04uuu-tuYNv_D43dmEmFfenqs,10664
+agent_code_guard/config_validation.py,sha256=_NOc147aZfoXjP7qPP-jqjxaXPz_4Vh6n4KTFnp6y_E,2891
+agent_code_guard/file_selection.py,sha256=oZ0Umn3LGQ5zpO46qeS-XW26qi_XRIA4OXVHh8ZKWOc,9283
+agent_code_guard/path_matching.py,sha256=xqX_JsWH-7N5k5_df3OHm9OOY7sxaVVtlzjFSVY7yBs,890
+agent_code_guard/reporting.py,sha256=SpYBXS9QlCuPO4f3dsnc-0dcOh0lq--1Af0YQDWa96g,295
+agent_code_guard/result_model.py,sha256=jYnp9XkBGuSmWmbAqlXgmtl-3ZsiHrbB0lU-DGHOvV8,3486
+agent_code_guard/skill_distribution.py,sha256=WKACCBrm4SW3ygy8JF8W4cDYyCiK6pdVuD7qIbClmnk,3417
+agent_code_guard/analysis/__init__.py,sha256=kd47xQlTvcPM0V896tGn9QBQhb0IYi0wPzItV4jWfng,697
+agent_code_guard/analysis/adapters.py,sha256=ADGO6K8IJu87aY-dOzD6plGhqkKR9xMyI8AOY9mDPvQ,29271
+agent_code_guard/analysis/errors.py,sha256=V6whxtgYL9j3oEmxZsI-mo6ePwopfwB-J_gcchy93AM,428
+agent_code_guard/analysis/facts.py,sha256=Hl2NWsqc8RgSQdWGvDMOsW6Rncu7Y7sh8glM4o88n2Q,2413
+agent_code_guard/analysis/language_specs.py,sha256=mJRY5S-OjiR1UdbuJqPzgUKzpAYlDM6ZU2Sv4kEoBxA,7402
+agent_code_guard/analysis/pipeline.py,sha256=_is6JXzqq1174jTVKAPiMjs42h_m2GhWnDZjReybJZo,1595
+agent_code_guard/analysis/provider.py,sha256=Oc704YdOgu1nHkOwSB9OuYn6S6Y0ImLA-keAJ2r1gM0,1632
+agent_code_guard/analysis/regions.py,sha256=PveqPCWZ1WBnWNgUcGEaSkDbC4YzHljeei5xRUlH6io,4421
+agent_code_guard/guards/__init__.py,sha256=_hECdxBB2F-FcoQtxz_18zWcJ_Ws8u2yEFvZdLEhbl8,59
+agent_code_guard/guards/callable_size.py,sha256=yGj7iQrbkD3rJLyD9aTXiOMeH1yB0Phejx7HKAqdPUY,2985
+agent_code_guard/guards/complexity.py,sha256=VKZu4XN2WHnOgKaYCo6bFhqJRe2Go44H1hYcASrxoqI,3707
+agent_code_guard/guards/loc.py,sha256=KNONau4usW5gG66drogLg_-5JYfLm94SKpnWak3lfVQ,10316
+agent_code_guard/guards/markdown_document_size.py,sha256=NcHzIxKoBZm-Nhc2X7ci87_a3KADzlCHU7HIu4XETiQ,2457
+agent_code_guard/guards/markdown_section_size.py,sha256=95oiJF21JzHPHS8S5D8Gd3lZGYudgnM2pQjH297GQF0,2648
+agent_code_guard/guards/nesting.py,sha256=98rJ25Rv7f4Z1GNekbs2iPs6MUMEyzy9-flG7WpdJaI,4194
+agent_code_guard/markdown/__init__.py,sha256=-xqZCo2iS8OHStkug_l_BqgxQX1rJC7iJbgszjQA0ps,308
+agent_code_guard/markdown/facts.py,sha256=INv_4JnYSraILdoP89PrbuuYqvnIb8XV3bev-y979PU,534
+agent_code_guard/markdown/scanner.py,sha256=XgP1hVEGCNPSlbzVfyE3p4sEjmbUxqrn9hd557LySrM,3514
+agent_code_guard-0.1.0.data/data/share/agent-code-guard/skill/LICENSE.txt,sha256=qfi3ybIq-hBcRO1D2PjtcvI1AJNhUxtKYxqPhmECJ5A,1072
+agent_code_guard-0.1.0.data/data/share/agent-code-guard/skill/SKILL.md,sha256=rb-1sxzAEgPqUvrP5vF35SI1n1iTQDMegNfkxeaqcPQ,7778
+agent_code_guard-0.1.0.data/data/share/agent-code-guard/skill/agents/openai.yaml,sha256=YDfA-KXAIO6uAPt_DALnq6WPN08u0zsFGJQ_QXr_Z74,328
+agent_code_guard-0.1.0.data/data/share/agent-code-guard/skill/references/callable-size-policy.md,sha256=mBvUFpEIS6dvLBmCDtpPEJizarh_NasbYCAb9pAqBdw,1953
+agent_code_guard-0.1.0.data/data/share/agent-code-guard/skill/references/complexity-policy.md,sha256=ogGo3FCBcHM5rizPs1ISNoJg9_vO4OvOSjV-am4J1V0,1876
+agent_code_guard-0.1.0.data/data/share/agent-code-guard/skill/references/loc-policy.md,sha256=czcK7IOPdJzPcFEZMhQ22GEjcXdDNoYHbp3rJIHlxqc,2918
+agent_code_guard-0.1.0.data/data/share/agent-code-guard/skill/references/markdown-size-policy.md,sha256=Q_5DDUm8QgI_xS7aZxZwRszvSVMgvYop0TIq14aU8L8,836
+agent_code_guard-0.1.0.data/data/share/agent-code-guard/skill/references/nesting-policy.md,sha256=gxoQy5wUjH44to0R9Q5Ur0O2x0go0Lajc9yZTedwNkw,1729
+agent_code_guard-0.1.0.dist-info/licenses/LICENSE,sha256=qfi3ybIq-hBcRO1D2PjtcvI1AJNhUxtKYxqPhmECJ5A,1072
+agent_code_guard-0.1.0.dist-info/METADATA,sha256=qTUl8EoER2BiMlUIFdREAuiDndOVL-TlqPvSSqUfFJc,7407
+agent_code_guard-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+agent_code_guard-0.1.0.dist-info/entry_points.txt,sha256=AlQT1EJar6o7zmVRCQ4h4vT9HEawcosfUp2aWdg7IuE,64
+agent_code_guard-0.1.0.dist-info/top_level.txt,sha256=VAvxYk-u5udTTDswvepW4c6M-wdH4nsOmUZVCOaAcdw,17
+agent_code_guard-0.1.0.dist-info/RECORD,,

agent_code_guard-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agent_code_guard-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+code-guard = agent_code_guard.code_guard:main

agent_code_guard-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stef Karyotidis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_code_guard-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+agent_code_guard