agent-smith-cli 0.3.1__tar.gz → 0.4.0__tar.gz

{agent_smith_cli-0.3.1 → agent_smith_cli-0.4.0}/PKG-INFO

@@ -1,20 +1,18 @@
 Metadata-Version: 2.4
 Name: agent-smith-cli
-Version: 0.3.1
+Version: 0.4.0
 Summary: Build agent instructions from your project's sources.
 License-Expression: MIT
 License-File: LICENSE
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Environment :: Console
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: markdown-it-py>=4,<5
-Requires-Dist: tomli>=2 ; python_full_version < '3.11'
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Project-URL: Repository, https://github.com/Mehdi-H/agent-smith
 Project-URL: Issues, https://github.com/Mehdi-H/agent-smith/issues
 Description-Content-Type: text/markdown
@@ -22,7 +20,9 @@ Description-Content-Type: text/markdown
 # Agent Smith 🕶️
 
 [![CI](https://github.com/Mehdi-H/agent-smith/actions/workflows/release.yml/badge.svg?branch=main)](https://github.com/Mehdi-H/agent-smith/actions/workflows/release.yml?query=branch%3Amain)
-[![Python 3.10–3.14](https://img.shields.io/badge/python-3.10%E2%80%933.14-blue?logo=python&logoColor=white)](pyproject.toml)
+[![Python 3.11–3.14](https://img.shields.io/badge/python-3.11%E2%80%933.14-blue?logo=python&logoColor=white)](pyproject.toml)
+[![Codecov](https://codecov.io/github/Mehdi-H/agent-smith/branch/main/graph/badge.svg?token=9RYPPL8VLH)](https://codecov.io/github/Mehdi-H/agent-smith)
+[![PyPI](https://img.shields.io/pypi/v/agent-smith-cli)](https://pypi.org/project/agent-smith-cli/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
 *Smith* your AGENTS.md file 🕶️
@@ -41,9 +41,13 @@ Forget `/init` skill, the output is _deterministic_, repeatable Markdown, you st
 ## Demo
 
 > [!NOTE]
-> The CLI is a development preview. Built-in overview, tech-stack, command and ADR
-> sections are available; no package release has been published yet.
+> Agent Smith is available on [PyPI](https://pypi.org/project/agent-smith-cli/).
+> It is under active development; versions remain below 1.0.
 
+> [!TIP]
+> **See the real output: [our generated AGENTS.md](AGENTS.md).**
+> We eat our own dog food: Agent Smith generates this repository's agent
+> instructions from its own project sources.
 
 ![agent-smith creating AGENTS.md on the left, with a live Glow preview on the right](docs/demo/agent-smith.gif)
 
@@ -52,12 +56,10 @@ Forget `/init` skill, the output is _deterministic_, repeatable Markdown, you st
 The PyPI distribution is named **`agent-smith-cli`**; the executable remains
 `agent-smith`. The name `agent-smith` was already taken on PyPI.
 
-Agent Smith supports Python 3.10–3.14. No release is available on PyPI yet:
-start from a checkout of this version of the repository and install the CLI
-from its root directory with uv:
+Agent Smith supports Python 3.11–3.14. Install the published CLI from PyPI with uv:
 
 ```sh
-uv tool install .
+uv tool install agent-smith-cli
 ```
 
 This installs the command in an isolated environment.
@@ -69,7 +71,7 @@ This installs the command in an isolated environment.
 Alternatively, install with pip in an activated Python virtual environment:
 
 ```sh
-python -m pip install .
+python -m pip install agent-smith-cli
 ```
 
 ## Run and verify
@@ -127,7 +129,7 @@ Put a `mise.toml` at your project root with a nonempty `[tools]` table:
 
 ```toml
 [tools]
-python = ["3.14", "3.10"]
+python = ["3.14", "3.11"]
 uv = "latest"
 node = { version = "lts", postinstall = "corepack enable" }
 ```
@@ -137,7 +139,7 @@ Agent Smith automatically adds:
 ```markdown
 ## Main tech stack
 
-- `python` — `3.14`, `3.10`
+- `python` — `3.14`, `3.11`
 - `uv` — `latest`
 - `node` — `lts`
 ```
@@ -269,6 +271,58 @@ to disable command discovery, or change its `command` to another source of
 standard just list output, such as `just --list`. Explicit `enabled = true`
 requires the command to work even if no root justfile was detected.
 
+### Add multiple custom sections
+
+In TOML, double brackets such as `[[sections]]` add an item to an **array of
+tables**: here, a list of custom sections. Repeat that exact header for each
+section, followed by its own `title` and `command`. You do not need to number
+the headers or give them different names.
+
+For example, use these three blocks in `agent-smith.toml`:
+
+```toml
+[[sections]]
+title = "Tracked files"
+command = "git ls-files"
+
+[[sections]]
+title = "Development guidelines"
+command = "cat docs/development.md"
+
+[[sections]]
+title = "Project context"
+command = "bash scripts/project-context.sh"
+```
+
+Supply the referenced files and scripts, then run `agent-smith`. It appends
+these three sections after the built-ins, in the order shown. Each command's
+stdout becomes the Markdown body under its section's H2 heading, with a footer
+recording the command. Any executable can provide the content; Python is not
+required.
+
+### Control section order
+
+The generated document follows this order, omitting disabled or undetected
+built-ins:
+
+1. Overview
+2. Main tech stack
+3. Available commands
+4. Architecture decisions
+5. Custom sections, in the order of their `[[sections]]` blocks
+
+To reorder custom sections, move their entire `[[sections]]` blocks in
+`agent-smith.toml`. For example, moving the "Project context" block above
+"Tracked files" makes it appear first among the custom sections.
+
+> [!NOTE]
+> Built-in order is currently fixed. Moving `[overview]`, `[tech_stack]`,
+> `[available_commands]` or `[architecture_decisions]` in the TOML file does not
+> change their output order. Custom sections cannot currently be inserted before
+> or between built-ins, and there is no `order` or `position` setting.
+
+### Replace a built-in section
+
 To replace the overview with your own extractor:
 
 ```toml

{agent_smith_cli-0.3.1 → agent_smith_cli-0.4.0}/README.md

@@ -1,7 +1,9 @@
 # Agent Smith 🕶️
 
 [![CI](https://github.com/Mehdi-H/agent-smith/actions/workflows/release.yml/badge.svg?branch=main)](https://github.com/Mehdi-H/agent-smith/actions/workflows/release.yml?query=branch%3Amain)
-[![Python 3.10–3.14](https://img.shields.io/badge/python-3.10%E2%80%933.14-blue?logo=python&logoColor=white)](pyproject.toml)
+[![Python 3.11–3.14](https://img.shields.io/badge/python-3.11%E2%80%933.14-blue?logo=python&logoColor=white)](pyproject.toml)
+[![Codecov](https://codecov.io/github/Mehdi-H/agent-smith/branch/main/graph/badge.svg?token=9RYPPL8VLH)](https://codecov.io/github/Mehdi-H/agent-smith)
+[![PyPI](https://img.shields.io/pypi/v/agent-smith-cli)](https://pypi.org/project/agent-smith-cli/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
 *Smith* your AGENTS.md file 🕶️
@@ -20,9 +22,13 @@ Forget `/init` skill, the output is _deterministic_, repeatable Markdown, you st
 ## Demo
 
 > [!NOTE]
-> The CLI is a development preview. Built-in overview, tech-stack, command and ADR
-> sections are available; no package release has been published yet.
+> Agent Smith is available on [PyPI](https://pypi.org/project/agent-smith-cli/).
+> It is under active development; versions remain below 1.0.
 
+> [!TIP]
+> **See the real output: [our generated AGENTS.md](AGENTS.md).**
+> We eat our own dog food: Agent Smith generates this repository's agent
+> instructions from its own project sources.
 
 ![agent-smith creating AGENTS.md on the left, with a live Glow preview on the right](docs/demo/agent-smith.gif)
 
@@ -31,12 +37,10 @@ Forget `/init` skill, the output is _deterministic_, repeatable Markdown, you st
 The PyPI distribution is named **`agent-smith-cli`**; the executable remains
 `agent-smith`. The name `agent-smith` was already taken on PyPI.
 
-Agent Smith supports Python 3.10–3.14. No release is available on PyPI yet:
-start from a checkout of this version of the repository and install the CLI
-from its root directory with uv:
+Agent Smith supports Python 3.11–3.14. Install the published CLI from PyPI with uv:
 
 ```sh
-uv tool install .
+uv tool install agent-smith-cli
 ```
 
 This installs the command in an isolated environment.
@@ -48,7 +52,7 @@ This installs the command in an isolated environment.
 Alternatively, install with pip in an activated Python virtual environment:
 
 ```sh
-python -m pip install .
+python -m pip install agent-smith-cli
 ```
 
 ## Run and verify
@@ -106,7 +110,7 @@ Put a `mise.toml` at your project root with a nonempty `[tools]` table:
 
 ```toml
 [tools]
-python = ["3.14", "3.10"]
+python = ["3.14", "3.11"]
 uv = "latest"
 node = { version = "lts", postinstall = "corepack enable" }
 ```
@@ -116,7 +120,7 @@ Agent Smith automatically adds:
 ```markdown
 ## Main tech stack
 
-- `python` — `3.14`, `3.10`
+- `python` — `3.14`, `3.11`
 - `uv` — `latest`
 - `node` — `lts`
 ```
@@ -248,6 +252,58 @@ to disable command discovery, or change its `command` to another source of
 standard just list output, such as `just --list`. Explicit `enabled = true`
 requires the command to work even if no root justfile was detected.
 
+### Add multiple custom sections
+
+In TOML, double brackets such as `[[sections]]` add an item to an **array of
+tables**: here, a list of custom sections. Repeat that exact header for each
+section, followed by its own `title` and `command`. You do not need to number
+the headers or give them different names.
+
+For example, use these three blocks in `agent-smith.toml`:
+
+```toml
+[[sections]]
+title = "Tracked files"
+command = "git ls-files"
+
+[[sections]]
+title = "Development guidelines"
+command = "cat docs/development.md"
+
+[[sections]]
+title = "Project context"
+command = "bash scripts/project-context.sh"
+```
+
+Supply the referenced files and scripts, then run `agent-smith`. It appends
+these three sections after the built-ins, in the order shown. Each command's
+stdout becomes the Markdown body under its section's H2 heading, with a footer
+recording the command. Any executable can provide the content; Python is not
+required.
+
+### Control section order
+
+The generated document follows this order, omitting disabled or undetected
+built-ins:
+
+1. Overview
+2. Main tech stack
+3. Available commands
+4. Architecture decisions
+5. Custom sections, in the order of their `[[sections]]` blocks
+
+To reorder custom sections, move their entire `[[sections]]` blocks in
+`agent-smith.toml`. For example, moving the "Project context" block above
+"Tracked files" makes it appear first among the custom sections.
+
+> [!NOTE]
+> Built-in order is currently fixed. Moving `[overview]`, `[tech_stack]`,
+> `[available_commands]` or `[architecture_decisions]` in the TOML file does not
+> change their output order. Custom sections cannot currently be inserted before
+> or between built-ins, and there is no `order` or `position` setting.
+
+### Replace a built-in section
+
 To replace the overview with your own extractor:
 
 ```toml

{agent_smith_cli-0.3.1 → agent_smith_cli-0.4.0}/pyproject.toml

@@ -1,20 +1,16 @@
 [project]
 name = "agent-smith-cli"
-version = "0.3.1"
+version = "0.4.0"
 description = "Build agent instructions from your project's sources."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = "MIT"
 license-files = ["LICENSE"]
-dependencies = [
-    "markdown-it-py>=4,<5",
-    "tomli>=2 ; python_full_version < '3.11'",
-]
+dependencies = ["markdown-it-py>=4,<5"]
 classifiers = [
     "Development Status :: 2 - Pre-Alpha",
     "Environment :: Console",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -46,7 +42,7 @@ dev = [
 release = ["python-semantic-release==10.6.2"]
 
 [tool.ruff]
-target-version = "py310"
+target-version = "py311"
 line-length = 100
 
 [tool.ruff.lint]
@@ -63,7 +59,7 @@ select = [
 ]
 
 [tool.ty.environment]
-python-version = "3.10"
+python-version = "3.11"
 
 [tool.ty.terminal]
 error-on-warning = true
@@ -71,9 +67,6 @@ error-on-warning = true
 [tool.deptry]
 github_warning_errors = []
 
-[tool.deptry.per_rule_ignores]
-DEP001 = ["tomllib"]
-
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 addopts = "--strict-config --strict-markers --cov=agent_smith --cov-branch --cov-report=term-missing"

{agent_smith_cli-0.3.1 → agent_smith_cli-0.4.0}/pyproject.toml.orig

@@ -1,20 +1,18 @@
 [project]
 name = "agent-smith-cli"
-version = "0.3.1"
+version = "0.4.0"
 description = "Build agent instructions from your project's sources."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = "MIT"
 license-files = ["LICENSE"]
 dependencies = [
     "markdown-it-py>=4,<5",
-    "tomli>=2 ; python_full_version < '3.11'",
 ]
 classifiers = [
     "Development Status :: 2 - Pre-Alpha",
     "Environment :: Console",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -51,14 +49,14 @@ release = [
 module-name = "agent_smith"
 
 [tool.ruff]
-target-version = "py310"
+target-version = "py311"
 line-length = 100
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "UP", "B", "SIM", "ANN", "RUF"]
 
 [tool.ty.environment]
-python-version = "3.10"
+python-version = "3.11"
 
 [tool.ty.terminal]
 error-on-warning = true
@@ -66,11 +64,6 @@ error-on-warning = true
 [tool.deptry]
 github_warning_errors = []
 
-[tool.deptry.per_rule_ignores]
-# tomllib is stdlib on 3.11+ and only imported behind a version guard.
-# On 3.10, deptry scans that inactive branch; the runtime uses declared tomli.
-DEP001 = ["tomllib"]
-
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 addopts = "--strict-config --strict-markers --cov=agent_smith --cov-branch --cov-report=term-missing"

{agent_smith_cli-0.3.1 → agent_smith_cli-0.4.0}/src/agent_smith/adapters/configuration.py

@@ -1,14 +1,9 @@
 """Load optional TOML configuration and apply explicit CLI overrides."""
 
-import sys
+import tomllib
 from pathlib import Path
 from typing import cast
 
-if sys.version_info >= (3, 11):
-    import tomllib
-else:
-    import tomli as tomllib
-
 from agent_smith.application.ports import (
     ArchitectureDecisionsSection,
     AvailableCommandsSection,

{agent_smith_cli-0.3.1 → agent_smith_cli-0.4.0}/src/agent_smith/adapters/mise.py

@@ -1,11 +1,6 @@
 """Render the declared mise tools without running mise or resolving versions."""
 
-import sys
-
-if sys.version_info >= (3, 11):
-    import tomllib
-else:
-    import tomli as tomllib
+import tomllib
 
 from agent_smith.application.generation import inline_code
 from agent_smith.application.ports import GenerationError