ai-docs-toolkit 0.4.1__tar.gz → 0.4.2__tar.gz

ai_docs_toolkit-0.4.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Docs Toolkit contributors
+
+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.

{ai_docs_toolkit-0.4.1/src/ai_docs_toolkit.egg-info → ai_docs_toolkit-0.4.2}/PKG-INFO

@@ -1,9 +1,11 @@
 Metadata-Version: 2.4
 Name: ai-docs-toolkit
-Version: 0.4.1
+Version: 0.4.2
 Summary: AI-oriented documentation toolkit.
+License-Expression: MIT
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: jsonschema>=4.26
 Requires-Dist: PyYAML>=6.0
 Provides-Extra: dev
@@ -11,6 +13,7 @@ Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: pytest>=8.0; extra == "dev"
 Provides-Extra: mcp
 Requires-Dist: mcp<3,>=2; extra == "mcp"
+Dynamic: license-file
 
 # AI Docs Toolkit
 
@@ -30,7 +33,7 @@ The core idea is that documentation should not be a secondary artifact created a
 
 ## Current Status
 
-Version 0.4.1 includes:
+Version 0.4.2 includes:
 
 - schema and structure validation for Markdown documents with YAML front matter;
 - document graph output;
@@ -45,29 +48,43 @@ Version 0.4.1 includes:
 
 ## Installation
 
-Install this version with Python 3.14 or newer once it is available on PyPI:
+Install version 0.4.2 with Python 3.14 or newer:
 
 ```bash
-python -m pip install ai-docs-toolkit==0.4.1
+python -m pip install ai-docs-toolkit==0.4.2
 ai-docs --version
 ```
 
 For ephemeral execution with `uvx`:
 
 ```bash
-uvx --python 3.14 --from ai-docs-toolkit==0.4.1 ai-docs --version
+uvx --python 3.14 --from ai-docs-toolkit==0.4.2 ai-docs --version
 ```
 
 For the optional local MCP runtime:
 
 ```bash
-python -m pip install "ai-docs-toolkit[mcp]==0.4.1"
+python -m pip install "ai-docs-toolkit[mcp]==0.4.2"
 ai-docs-mcp --project-root .
 ```
 
 For the latest stable release, use `python -m pip install --upgrade ai-docs-toolkit`
 without an exact version pin.
 
+## Release 0.4.2
+
+The package now declares the MIT license in its metadata and includes the full
+license text in source and wheel distributions. Repository and package guidance
+reflects the current release and planning state. CLI behavior, schemas,
+templates, configuration and MCP surfaces are unchanged from 0.4.1.
+Source builds without build isolation require setuptools 77 or newer for SPDX
+license metadata; normal isolated builds install the declared requirement.
+
+No consumer data or managed-file migration is required. After upgrading, verify
+the version, run `ai-docs validate --json`, and retain independent project checks.
+The packaged `ai_docs_toolkit/docs/agent-installation.md` contains the complete
+0.4.1 to 0.4.2 upgrade instructions.
+
 ## Release 0.4.1
 
 Impact now includes test cases explicitly linked to a module, including modules
@@ -407,4 +424,5 @@ ai-docs validate --json
 
 ## License
 
-License is not selected yet.
+AI Docs Toolkit is licensed under the MIT License. The full license text is
+included in the package distributions.

{ai_docs_toolkit-0.4.1 → ai_docs_toolkit-0.4.2}/README.md

@@ -2,7 +2,7 @@
 
 AI Docs Toolkit is a documentation toolkit for AI-assisted software development.
 
-It treats documentation as an engineering interface between humans, AI agents, code, tests and change management. The source tree prepares 0.4.1, extending impact to module-linked test cases, alongside optional code-link checks, test-evidence review, rollback guidance and changed-path coverage. Python 3.14 or newer is required.
+It treats documentation as an engineering interface between humans, AI agents, code, tests and change management. The 0.4.2 source declares the MIT license and retains the 0.4.1 impact, review and code-link improvements. Python 3.14 or newer is required.
 
 ## Purpose
 
@@ -39,11 +39,11 @@ The stable package provides:
 At this stage the repository contains:
 - concept documents that explain the methodology;
 - architecture and reference documents for repository structure, schemas, CLI, graph, impact, context, CI and distribution;
-- planning documents that define active post-MVP hardening work;
+- a task backlog and a planned external-work-tracker collaboration plan, with completed plans retained in the archive;
 - a workflow for implementing plan stages as documented change units;
-- YAML schemas for MVP front matter and document types;
+- YAML schemas for supported front matter and document types;
 - Markdown document templates and a minimal project example;
-- Python package baseline and an executable `ai-docs` CLI.
+- a published Python package with an executable `ai-docs` CLI and optional MCP runtime.
 
 ## Installation
 
@@ -83,9 +83,13 @@ pipx install ai-docs-toolkit
 uvx --from ai-docs-toolkit ai-docs validate
 ```
 
-Version 0.4.1 is prepared in source and has not been published yet. After publication,
-follow the [0.4.0 → 0.4.1 migration guide](src/ai_docs_toolkit/docs/agent-installation.md#migration-040-to-041).
-This patch requires no schema, configuration or managed-template content migration;
+[Version 0.4.1 is available on Public PyPI](https://pypi.org/project/ai-docs-toolkit/0.4.1/).
+Version 0.4.2 is prepared for publication with MIT license metadata and updated
+product guidance. It changes no CLI, schema, template or runtime behavior.
+See the [0.4.1 → 0.4.2 upgrade note](src/ai_docs_toolkit/docs/agent-installation.md#migration-041-to-042).
+If upgrading from 0.4.0, also follow the
+[0.4.0 → 0.4.1 migration guide](src/ai_docs_toolkit/docs/agent-installation.md#migration-040-to-041).
+That patch required no schema, configuration or managed-template content migration;
 repeat impact discovery and review any newly included module-linked test cases.
 Consumers on 0.3.3 must also apply the
 [0.4.0 migration](src/ai_docs_toolkit/docs/agent-installation.md#migration-033-to-040).
@@ -214,8 +218,9 @@ Architecture:
 - [CLI Architecture](ai-docs/architecture/cli-architecture.md)
 
 Planning:
-- [MVP Plan](ai-docs/planning/archive/plans/2026-05-13-mvp/plan.md)
 - [Backlog](ai-docs/planning/backlog.md)
+- [External Work Tracker Collaboration Plan](ai-docs/planning/2026-05-28-external-work-tracker-collaboration/plan.md)
+- [Completed MVP Plan](ai-docs/planning/archive/plans/2026-05-13-mvp/plan.md)
 
 Workflows:
 - [Plan Stage Workflow](.ai-docs/workflows/plan-stage-workflow.md)
@@ -232,11 +237,12 @@ Reference:
 
 ## Development Model
 
-The toolkit is developed using its own documentation methodology.
+The toolkit is developed using its own documentation methodology. Small bounded
+changes may use sufficient session context; staged work uses planning records.
 
-Changes should be handled as documented change units:
-- identify the active plan stage;
-- read [Plan Stage Workflow](.ai-docs/workflows/plan-stage-workflow.md) before executing planning tasks;
+For planned tasks:
+- review the selected plan, stage and task, and resolve readiness questions before implementation;
+- follow [Plan Stage Workflow](.ai-docs/workflows/plan-stage-workflow.md);
 - read the source documents for the task;
 - update affected documentation before or together with implementation;
 - keep planning documents aligned with the actual repository state;
@@ -246,10 +252,13 @@ For the current execution workflow, see [Plan Stage Workflow](.ai-docs/workflows
 
 ## Planning Direction
 
-The MVP plan is closed and retained as work history.
-Current work is tracked in the post-MVP hardening plan.
+The MVP and post-MVP hardening plans are complete and retained as work history.
+Current unscheduled work is in the backlog. The external-work-tracker
+collaboration plan is planned; none of its stages is active.
 
 Details:
+- [Backlog](ai-docs/planning/backlog.md)
+- [External Work Tracker Collaboration Plan](ai-docs/planning/2026-05-28-external-work-tracker-collaboration/plan.md)
 - [Post-MVP Hardening Plan](ai-docs/planning/archive/plans/2026-05-15-post-mvp-hardening/plan.md)
 - [MVP Plan](ai-docs/planning/archive/plans/2026-05-13-mvp/plan.md)
 
@@ -265,4 +274,4 @@ The MVP does not aim to provide:
 
 ## License
 
-License is not selected yet. This is tracked as a product documentation gap in [BLG-017 Product Core Documentation Gaps](ai-docs/planning/backlog/task-000009-product-core-documentation-gaps.md).
+AI Docs Toolkit is licensed under the [MIT License](LICENSE).

ai_docs_toolkit-0.4.1/PKG-INFO → ai_docs_toolkit-0.4.2/packaging/pypi/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.4
-Name: ai-docs-toolkit
-Version: 0.4.1
-Summary: AI-oriented documentation toolkit.
-Requires-Python: >=3.14
-Description-Content-Type: text/markdown
-Requires-Dist: jsonschema>=4.26
-Requires-Dist: PyYAML>=6.0
-Provides-Extra: dev
-Requires-Dist: build>=1.2; extra == "dev"
-Requires-Dist: pytest>=8.0; extra == "dev"
-Provides-Extra: mcp
-Requires-Dist: mcp<3,>=2; extra == "mcp"
-
 # AI Docs Toolkit
 
 AI Docs Toolkit is a documentation toolkit for AI-assisted software development.
@@ -30,7 +16,7 @@ The core idea is that documentation should not be a secondary artifact created a
 
 ## Current Status
 
-Version 0.4.1 includes:
+Version 0.4.2 includes:
 
 - schema and structure validation for Markdown documents with YAML front matter;
 - document graph output;
@@ -45,29 +31,43 @@ Version 0.4.1 includes:
 
 ## Installation
 
-Install this version with Python 3.14 or newer once it is available on PyPI:
+Install version 0.4.2 with Python 3.14 or newer:
 
 ```bash
-python -m pip install ai-docs-toolkit==0.4.1
+python -m pip install ai-docs-toolkit==0.4.2
 ai-docs --version
 ```
 
 For ephemeral execution with `uvx`:
 
 ```bash
-uvx --python 3.14 --from ai-docs-toolkit==0.4.1 ai-docs --version
+uvx --python 3.14 --from ai-docs-toolkit==0.4.2 ai-docs --version
 ```
 
 For the optional local MCP runtime:
 
 ```bash
-python -m pip install "ai-docs-toolkit[mcp]==0.4.1"
+python -m pip install "ai-docs-toolkit[mcp]==0.4.2"
 ai-docs-mcp --project-root .
 ```
 
 For the latest stable release, use `python -m pip install --upgrade ai-docs-toolkit`
 without an exact version pin.
 
+## Release 0.4.2
+
+The package now declares the MIT license in its metadata and includes the full
+license text in source and wheel distributions. Repository and package guidance
+reflects the current release and planning state. CLI behavior, schemas,
+templates, configuration and MCP surfaces are unchanged from 0.4.1.
+Source builds without build isolation require setuptools 77 or newer for SPDX
+license metadata; normal isolated builds install the declared requirement.
+
+No consumer data or managed-file migration is required. After upgrading, verify
+the version, run `ai-docs validate --json`, and retain independent project checks.
+The packaged `ai_docs_toolkit/docs/agent-installation.md` contains the complete
+0.4.1 to 0.4.2 upgrade instructions.
+
 ## Release 0.4.1
 
 Impact now includes test cases explicitly linked to a module, including modules
@@ -407,4 +407,5 @@ ai-docs validate --json
 
 ## License
 
-License is not selected yet.
+AI Docs Toolkit is licensed under the MIT License. The full license text is
+included in the package distributions.

{ai_docs_toolkit-0.4.1 → ai_docs_toolkit-0.4.2}/pyproject.toml

@@ -1,13 +1,15 @@
 [build-system]
-requires = ["setuptools>=69"]
+requires = ["setuptools>=77"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-docs-toolkit"
-version = "0.4.1"
+version = "0.4.2"
 description = "AI-oriented documentation toolkit."
 readme = "packaging/pypi/README.md"
 requires-python = ">=3.14"
+license = "MIT"
+license-files = ["LICENSE"]
 dependencies = [
   "jsonschema>=4.26",
   "PyYAML>=6.0",

{ai_docs_toolkit-0.4.1 → ai_docs_toolkit-0.4.2}/src/ai_docs_toolkit/__init__.py

@@ -1,3 +1,3 @@
 """AI Docs Toolkit package baseline."""
 
-__version__ = "0.4.1"
+__version__ = "0.4.2"

{ai_docs_toolkit-0.4.1 → ai_docs_toolkit-0.4.2}/src/ai_docs_toolkit/docs/agent-installation.md

@@ -47,7 +47,7 @@ ai-docs --version
 Pinned install:
 
 ```bash
-python -m pip install "ai-docs-toolkit==0.4.1"
+python -m pip install "ai-docs-toolkit==0.4.2"
 ai-docs --version
 ```
 
@@ -89,6 +89,60 @@ bulk task deletion is required. Detailed migration and rollback guidance is in
 the installed `.ai-docs/reference/planning-document-model.md`, under
 “Consumer Migration: Proportionate Workflow”.
 
+## Migration 0.4.1 To 0.4.2
+
+From: `0.4.1`. To: `0.4.2`. Install the target after it appears on Public
+PyPI. Python 3.14+ remains required.
+
+This patch declares the MIT license, includes its text in the distributions
+and updates product and release descriptions. CLI behavior, schemas,
+configuration, init-managed files, document layout and MCP interfaces are
+unchanged. No consumer data or managed-file migration is required.
+Source builds without build isolation need setuptools 77 or newer; normal
+isolated builds resolve this declared build requirement automatically.
+
+Before upgrading, record the current version and project checks:
+
+```bash
+ai-docs --version
+ai-docs validate --json
+ai-docs doctor --format json
+ai-docs init --check
+```
+
+Install in the project's approved Python 3.14+ environment and update any
+version pin:
+
+```bash
+python -m pip install --upgrade "ai-docs-toolkit==0.4.2"
+# MCP users install the complete extra instead:
+python -m pip install --upgrade "ai-docs-toolkit[mcp]==0.4.2"
+# Isolated CLI alternatives:
+pipx install --force --python python3.14 "ai-docs-toolkit==0.4.2"
+uvx --python 3.14 --from ai-docs-toolkit==0.4.2 ai-docs --version
+```
+
+Reconnect long-lived MCP clients after reinstalling the MCP extra. Preserve
+project documents, IDs, aliases, AGENTS.md, local policy, task history and
+saved review evidence. Do not use `init --force` for this upgrade. A normal
+`init` is unnecessary because managed content is unchanged; if run, review
+provenance changes and preserve project overrides.
+
+After upgrading:
+
+```bash
+ai-docs --version
+ai-docs validate --json
+ai-docs doctor --format json
+ai-docs init --check
+```
+
+Expect version 0.4.2 and no new validation or doctor findings. Keep
+independent project checks. Stop if an unexpected project rewrite or validation
+failure appears; investigate before applying unrelated changes. For rollback,
+preserve evidence, restore the previous package pin and reinstall 0.4.1 in the
+same supported environment, then repeat project checks.
+
 ## Migration 0.4.0 To 0.4.1
 
 From: `0.4.0`. To: `0.4.1`. Install the target only after it is available on

ai_docs_toolkit-0.4.1/packaging/pypi/README.md → ai_docs_toolkit-0.4.2/src/ai_docs_toolkit.egg-info/PKG-INFO

@@ -1,3 +1,20 @@
+Metadata-Version: 2.4
+Name: ai-docs-toolkit
+Version: 0.4.2
+Summary: AI-oriented documentation toolkit.
+License-Expression: MIT
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jsonschema>=4.26
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2; extra == "mcp"
+Dynamic: license-file
+
 # AI Docs Toolkit
 
 AI Docs Toolkit is a documentation toolkit for AI-assisted software development.
@@ -16,7 +33,7 @@ The core idea is that documentation should not be a secondary artifact created a
 
 ## Current Status
 
-Version 0.4.1 includes:
+Version 0.4.2 includes:
 
 - schema and structure validation for Markdown documents with YAML front matter;
 - document graph output;
@@ -31,29 +48,43 @@ Version 0.4.1 includes:
 
 ## Installation
 
-Install this version with Python 3.14 or newer once it is available on PyPI:
+Install version 0.4.2 with Python 3.14 or newer:
 
 ```bash
-python -m pip install ai-docs-toolkit==0.4.1
+python -m pip install ai-docs-toolkit==0.4.2
 ai-docs --version
 ```
 
 For ephemeral execution with `uvx`:
 
 ```bash
-uvx --python 3.14 --from ai-docs-toolkit==0.4.1 ai-docs --version
+uvx --python 3.14 --from ai-docs-toolkit==0.4.2 ai-docs --version
 ```
 
 For the optional local MCP runtime:
 
 ```bash
-python -m pip install "ai-docs-toolkit[mcp]==0.4.1"
+python -m pip install "ai-docs-toolkit[mcp]==0.4.2"
 ai-docs-mcp --project-root .
 ```
 
 For the latest stable release, use `python -m pip install --upgrade ai-docs-toolkit`
 without an exact version pin.
 
+## Release 0.4.2
+
+The package now declares the MIT license in its metadata and includes the full
+license text in source and wheel distributions. Repository and package guidance
+reflects the current release and planning state. CLI behavior, schemas,
+templates, configuration and MCP surfaces are unchanged from 0.4.1.
+Source builds without build isolation require setuptools 77 or newer for SPDX
+license metadata; normal isolated builds install the declared requirement.
+
+No consumer data or managed-file migration is required. After upgrading, verify
+the version, run `ai-docs validate --json`, and retain independent project checks.
+The packaged `ai_docs_toolkit/docs/agent-installation.md` contains the complete
+0.4.1 to 0.4.2 upgrade instructions.
+
 ## Release 0.4.1
 
 Impact now includes test cases explicitly linked to a module, including modules
@@ -393,4 +424,5 @@ ai-docs validate --json
 
 ## License
 
-License is not selected yet.
+AI Docs Toolkit is licensed under the MIT License. The full license text is
+included in the package distributions.

{ai_docs_toolkit-0.4.1 → ai_docs_toolkit-0.4.2}/src/ai_docs_toolkit.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 packaging/pypi/README.md

{ai_docs_toolkit-0.4.1 → ai_docs_toolkit-0.4.2}/tests/test_cli_baseline.py

@@ -10,7 +10,7 @@ def test_cli_help(capsys):
     assert main(["--help"]) == 0
 
     output = capsys.readouterr()
-    assert "ai-docs 0.4.1" in output.out
+    assert "ai-docs 0.4.2" in output.out
     assert "ai-docs doctor" in output.out
     assert "ai-docs validate" in output.out
     assert "ai-docs validate --json" in output.out
@@ -24,7 +24,7 @@ def test_cli_version(capsys):
     assert main(["--version"]) == 0
 
     output = capsys.readouterr()
-    assert output.out.strip() == "0.4.1"
+    assert output.out.strip() == "0.4.2"
     assert output.err == ""