ai-kit-python 1.4.2__py3-none-any.whl

aikit/CHANGELOG.md

@@ -0,0 +1,85 @@
+# AI-KIT changelog
+
+## v1.4.2 (2026-10-16)
+
+- Verified kit/archive/offline installation, 351 Linux tests (two skips), 23 Windows CLI/archive tests and Docker smoke. [Evidence](docs/V1_4_2.md).
+- Prepared `ai-kit-python` 1.4.2; PyPI publisher/GitHub pypi environment verified. Preserve v1.4.1 Git/Docker. [Status](docs/V1_4_2.md).
+- Fixed quoted Twine wildcards for Windows CI.
+- Added PyPI metadata, a portable [description](docs/PYPI_DESCRIPTION.md), README guidance and a [release procedure](docs/PYPI.md). Wheel/sdist checks cover metadata, licenses, resources, private files, offline installation and publication identity. Manual Trusted Publishing defaults to validation, requires exact version/tag/repository, and gives OIDC only to upload jobs consuming tested artifacts. Required CI names stay unchanged.
+- Isolated builds inject synthetic private probes; archives exclude private drafts and credential filenames. Added tested `aikit --version`; published Docker 1.4.1 examples use its existing `--help`. Added a README Docker Hub badge.
+
+- Saved the complete [Docker Hub Overview](docs/DOCKER_HUB_OVERVIEW.md) for v1.4.1 and linked it from README/Docker docs. The [release checklist](CONTRIBUTING.md#docker-hub-releases) and continuity skill require updating it for every image release, with verified publication identity recorded after push. Exempted only this user-facing document from the size quota alongside README; instruction budgets remain unchanged, with regression coverage.
+
+## v1.4.1 (2026-10-15)
+
+- Added [image freshness](docs/DOCKER.md#change-impact-and-image-refresh): maintainer and installed AGENTS assess Docker impact, rebuild/test affected images and preserve publication authorization.
+- Keep root maintainer AGENTS/PROJECT_CONTEXT/WIKI local and untracked; retain template counterparts. Exclude local copies from Git, wheel and Docker; validate distributions without them.
+
+- Prepared matching VERSION, wheel and Docker version 1.4.1; [release checks and publication record](docs/V1_4_1.md). Added package/context regression coverage and retained full v1.2.0 history in its archive.
+
+- Published `tigusigalpa/ai-kit:1.4.1`; push, remote digest/configuration and anonymous tag visibility matched the tested image. Post-label: nine Windows CLI tests, 339 Linux tests (337 passed/two skips), Docker smoke, offline wheel/source privacy checks and private/team 1.4.0 upgrades passed. [Evidence](docs/V1_4_1.md#verification).
+
+## v1.4.0 (2026-10-15)
+
+- Published `tigusigalpa/ai-kit:1.4.0` to Docker Hub at the owner's request. Remote digest, linux/amd64 platform, version label and non-root entrypoint were read back and matched the prepared image; [publication record](docs/V1_4_0.md#docker-hub-publication). No `latest` tag was assigned.
+- Prepared v1.4.0 for the Docker CLI and local dialogue memory. VERSION, CLI/wheel metadata, image label and release pointers use the same version; [release checks and Docker Hub handoff](docs/V1_4_0.md). Registry publication and Git tagging remain separate.
+- Added offline `aikit memory import|merge|export`: three dialogue formats, selected ChatGPT branches, source-bound human review, explicit contradictions and ChatGPT/OpenRouter reference exports. Preserves immutable artifacts, refuses unreviewed normal exports and protects private memory across upgrades/builds. Added tests and detailed [workflow](README.md#shared-context-from-two-dialogues)/[contract](docs/DIALOGUE_MEMORY.md). Automatic sync and API execution remain separate. Archived v1.1.0 history without dropping its text.
+- Before release labeling, dialogue-memory verification passed: 336 Windows tests (329 passed/seven environment skips), 336 packaged Linux tests (334 passed/two skips), clean kit validation, offline wheel and private-package exclusion, README conflict-resolution flow and Docker smoke. [Coverage and limits](docs/DIALOGUE_MEMORY.md#verification).
+- Added standalone non-root Docker CLI, pinned build inputs, offline wheel resources, application mounts, Kubernetes preview Job, smoke tests, CI and [usage/results](docs/DOCKER.md). Earlier Docker-only Windows and packaged Linux runs passed 309 tests (307 passed/two skips each); actual image, preservation, signals, context exclusions, wheel and schema checks passed.
+- After labeling: nine CLI tests, 336 packaged Linux tests (334 passed/two Windows-only skips), clean kit validation, isolated Windows wheel/fresh-venv smoke and private-memory exclusion passed. The actual linux/amd64 image passed Docker smoke. Tracked 1.3.0 upgrades in private/team modes preserved data and pin identities, with explicit review of a local skill conflict; reruns stayed stable. [Release evidence](docs/V1_4_0.md#verification).
+
+## v1.3.0 (2026-10-13)
+
+- Prepared v1.3.0 for optional Web Design and the expanded README guide. The 304-test behavioral discovery below preceded release labeling; publication/tagging remain separate. [Release checks](docs/WEB_DESIGN.md#release-labeling).
+- After labeling: eight CLI tests, version/wheel metadata 1.3.0, clean kit checks and offline fresh-venv wheel smoke passed. The pre-label 1.2.0 upgrade preserved facts, settings, local design/skill edits, MCP configuration and both security pins; rerun stayed stable.
+- Added optional Web Design: --with-web-design installs four short skills, conditional Blade/library/tool/review guides and created-once project design documents. Added scoped context workflows, source/Claude lifecycle and preservation tests; installation remains offline. [Guide](README.md#web-design), [integration record](docs/WEB_DESIGN.md).
+- Removed the root README size quota and added extensive reference-to-site instructions for Laravel, Tailwind, Bootstrap, Alpine/Livewire, daisyUI, Flowbite, Flux, TypeUI and SkillUI. Existing instruction budgets remain scoped; external setup and real application checks stay separate.
+- Verified on Windows/Python 3.12.14: 304 tests (300 passed/four runtime skips), clean kit/skill checks, all-client private/team visibility, preserved tracked 1.2.0 upgrade and fresh-venv wheel smoke. Live tools/sites remain unverified. Archived v0.6.4 history without losing its text; [details](docs/WEB_DESIGN.md#verification).
+
+## v1.2.0 (2026-10-12)
+
+[Archived release entry](docs/history/v1.2.0-changelog.md#v120-2026-10-12).
+
+## v1.1.0 (2026-10-12)
+
+[Archived release entry](docs/history/v1.1.0-changelog.md#v110-2026-10-12).
+
+## v0.13.0 (2026-10-11)
+
+- Added Rust, .NET, Java (Maven/Gradle), and Terraform/Helm stack profiles with evidence-based per-module detection: Cargo.toml (rust-version, cargo test/build/clippy), *.csproj/*.fsproj/*.vbproj and global.json (TargetFramework, dotnet test/build), pom.xml/mvnw/build.gradle(.kts)/gradlew (language level, wrapper-aware commands), and .tf files or Chart.yaml (fmt/validate, helm lint). Drafts remain suggestions until bootstrap confirms them.
+- Added rust-work, dotnet-work, java-work, and infra-work skills to the registry; Claude native copies install with the claude agent selection.
+- Benchmark packs accept the new stack names; README, SKILL.md, and WIKI profile lists updated.
+- Verified locally (Windows/Python 3.14.6): 254 tests ran, all passed, 1 runtime skip; kit validation returned zero errors and zero warnings; Python 3.10 grammar verified; end-to-end smoke detected RUST/INFRA with drafted context and installed source/native skills. Real applications of the new stacks remain untrialed.
+
+## v0.12.0 (2026-10-11)
+
+- Benchmark packs accept optional `kit_agents`/`kit_preset` (default codex/minimal), so kit arms install the client's real adapter set and preset instead of a hard-coded arm; both are validated against the installer registry.
+- Benchmark task paths are now probed against the benchmark project instead of the process working directory.
+- Interrupted benchmark runs are resumable: re-running `benchmark run` with the identical pack skips completed units and continues missing ones, and a changed pack is refused against the existing run. Per-unit infrastructure failures are recorded as explicit failed units, so one bad unit neither aborts the run nor hides as an executed attempt; failed units still block savings and cannot be reviewed as correct.
+- The unified `aikit` dispatcher now prefers installed `aikit.scripts.*` package modules over bare script-path imports, avoiding duplicate module objects inside the wheel.
+- The checker document budgets are named constants; the root README budget rises to 22000 bytes (human onboarding that never enters project context), other documents keep 12000.
+- Verified locally (Windows/Python 3.14.6): 252 tests ran, all passed, 1 runtime skip; kit validation returned zero errors and zero warnings; Python 3.10 grammar was verified for the changed sources. Live workers, native client activation and hosted CI remain unverified.
+
+## v0.11.0 (2026-10-11)
+
+- Fixed provider/model overrides carrying inherited effort; synchronized Gemini routing policy with the reviewed registry. Existing selection/settings defaults stay readable and unchanged.
+- Fixed the untested v0.10 adapter audit failing before it could report file-blocked native paths. Read-only state validation now allows obstructions after strict link/boundary checks; installation writes retain their refusal guards.
+- Forwarded subcommand help to the actual command parser, so `aikit benchmark --help` and install flags are discoverable.
+- Added preview-first `aikit benchmark run|review|report|export`: immutable Git blobs, separate A/B/C workspaces/repeats, equal fixed A/B controls, a configured worker protocol, actual-telemetry coverage, checks plus explicit semantic review, private JSON/Markdown reports and idempotent journal export. No live vendor adapter or application savings is claimed.
+- Added metric schema 3 for revision/case/repetition/stack/class/level/capability/review strata, keeping schemas 1/2 readable. Comparisons require matched reviewed tasks and actual single-currency costs, include all failures/retries and refuse lower-quality/unknown/estimated spend claims. Added per-stack analysis.
+- Added optional manual/fixed/recommended/adaptive modes, task/project pins and economy/balanced/quality profiles. Learned recommendations require comparable distinct-case samples and quality floors; unsupported controls or insufficient evidence retain the capability recommendation. Immutable proposals preserve prior selection and support explicit backed-up restore without automatic policy writes.
+- Added read-only module context selection, duplicate detection and byte-budget reporting while preserving critical requirements and architectural decisions. Added staged acceptance plan and orchestration research in ADR 0012.
+- Expanded wheel resources and smoke checks outside the source checkout, including installed validation, new command imports and context selection. Windows/Python 3.12.14 full discovery ran 248 tests (244 passed, four runtime skips); post-review checks and offline wheel installation passed; kit validation returned zero errors/warnings. [Results and limits](docs/IMPLEMENTATION.md#measurement-led-development-verification).
+
+## v0.6.4 (2026-10-10)
+
+[Archived release entry](docs/history/v0.6.4-changelog.md#v064-2026-10-10).
+
+## v0.5.0 (2026-10-10)
+
+[Archived release entry](docs/history/v0.5-changelog.md#v050-2026-10-10).
+
+## Earlier kit
+
+Release history is preserved: [v0.5.0](docs/history/v0.5-changelog.md), [v0.10.0](docs/history/v0.10-changelog.md), [v0.6.5-v0.9](docs/history/v0.6.5-v0.9-changelog.md), [v0.4.5-v0.4.7](docs/history/v0.4-changelog.md), [v0.3.3-v0.3.8](docs/history/v0.3-changelog.md), [v0.2-v0.2.2 and Windows fixtures](docs/history/v0.2-changelog.md), and [v0.1](docs/history/v0.1-changelog.txt). Old paths and language/router agreements are historical data.
+[Prior routing decision](docs/adr/0001-adaptive-model-routing.md) records the accepted routing baseline; this changelog is not copied into projects.

aikit/CLAUDE.md

@@ -0,0 +1,3 @@
+# AI-KIT maintainer entry
+
+@AGENTS.md

aikit/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# Contributing
+
+Read [Core](template/ai-kit/CORE.md) and [policy ownership](docs/IMPLEMENTATION.md#policy-ownership).
+Make a coherent local change, add behavioral checks for installer or validator risks, and run the documented checks.
+Keep project templates free of maintainer facts/history. Preserve local-file ownership and authorization boundaries.
+Update the root changelog; record significant design decisions in docs/adr/.
+Discuss version/provider changes using current primary documentation and actual runtime evidence. Commit/push authorization follows Core.
+
+## Local maintainer files
+
+Root `AGENTS.md`, `PROJECT_CONTEXT.md` and `WIKI.md` are optional local maintainer files. Keep them on disk, ignored and untracked; do not copy their contents into public documents or build artifacts. Read them when present and preserve local agreements. Otherwise establish current facts from VERSION, pyproject, source and the public guides. Their `template/` counterparts are distribution sources and remain tracked for application installation.
+
+Ignore rules do not untrack existing files. Use `git rm --cached -- AGENTS.md PROJECT_CONTEXT.md WIKI.md` to stop tracking only the root copies while keeping them on disk. This stages removal for a later authorized commit; it does not erase earlier history. Do not force-add local copies. Public documents and checks must work without them; wheel and Docker builds exclude them even when present.
+
+## Maintainer workflow
+
+Follow plan -> implement -> test -> review -> document. Run `python scripts/check_kit.py` and `python -m unittest discover -s tests -v` for affected installer/checker behavior. When packaging changes, build from an isolated source copy and smoke-install the wheel. Review preservation, conflicts, links, visibility and upgrades; report unavailable checks.
+
+Assess [Docker impact](docs/DOCKER.md#change-impact-and-image-refresh) on every task and rebuild/test affected final sources locally. Publication needs authorization. Update the root changelog, any local context/map and the continuity skill when procedures change. Keep templates free of kit history; do not bootstrap this distribution as an application.
+
+## Docker Hub releases
+
+Update [DOCKER_HUB_OVERVIEW.md](docs/DOCKER_HUB_OVERVIEW.md) for every AI-KIT Docker image release, including patch releases and authorized replacements of an existing tag. Keep the complete publication copy in that file; README and the [Docker guide](docs/DOCKER.md) link to it.
+
+Before building, synchronize its version/tag, feature summary, release changes, optional modules, CLI examples and runtime/platform contract with VERSION, README and actual sources. Record only checks that ran. After an authorized push, read back the remote digest and configuration, then update publication status and the immutable pull example from that evidence. Never invent a digest or claim local preparation is publication. Keep descriptive publication receipts separate from the prepared image snapshot; do not rebuild/replace an image just to include its own digest.
+
+The root README and Docker Hub Overview are user documentation without a size quota. Other document and instruction budgets remain scoped. Preparing this file does not itself publish a Docker Hub description, image or Git release; the relevant authorization still applies.
+
+## Python package releases
+
+Follow [PyPI preparation and release](docs/PYPI.md) for every package release. Synchronize VERSION, pyproject metadata, [description](docs/PYPI_DESCRIPTION.md) and README; verify license/resource inclusion and local-file exclusions in both sdist and wheel, build the wheel from sdist, run strict Twine checks and offline fresh-venv smoke. Preserve existing CI matrix/job names. Refresh the image when packaging changes affect it.
+
+Trusted Publishing remains manual and build-only by default. Registry uploads require the matching version/tag, canonical repository and the separately configured registry environment/publisher. Build tests have no OIDC permission; upload jobs consume only validated same-run artifacts. Record local, hosted and registry results separately. No upload, publisher/account setup or Git operation is authorized by preparation alone.
+
+## Repository maintenance
+
+Before changing remote protection or required CI checks, verify live configuration and emitted names. Local jobs establish neither hosted success nor updated protection. Remote changes, commits, pushes and publication need the relevant user authorization. Private context snapshots require verification before use.
+
+## Updating a reference repository
+
+Archive overlays leave old files behind. Compatibility pointers retain known v0.1 rule paths.
+Overlay the bundle at the reference root, preserve customizations, and run the checker.
+
+The obsolete .gitignore_real is historical material: its useful rules live in the templates/ policies, scoped by the installer where a global rule would hide project source (Composer vendor, Moodle config.php, Node and Python output). Use templates/ policies for applications.
+Keep the root [SKILL.md](SKILL.md) current when commands, options, or features change.
+Retire old pointers after reviewing inbound links and local changes.

aikit/Dockerfile

@@ -0,0 +1,44 @@
+# CLI runtime. Build with --build-arg AIKIT_VERSION=<VERSION file value>.
+FROM scratch AS context-audit
+COPY . /
+
+FROM python:3.13.16-slim-bookworm@sha256:a1165e272e578941b84abc79e4ab38a0305cd12803a5c4247979ac7655f4d641 AS wheel-builder
+ENV PIP_DISABLE_PIP_VERSION_CHECK=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PYTHONDONTWRITEBYTECODE=1
+WORKDIR /build/source
+ARG AIKIT_VERSION
+COPY VERSION ./VERSION
+COPY docker/check_version.py /build/check_version.py
+RUN python /build/check_version.py
+COPY docker/build-requirements.txt /build/build-requirements.txt
+RUN python -m pip install --require-hashes -r /build/build-requirements.txt
+COPY . .
+RUN python -m pip wheel . --no-index --no-deps --no-build-isolation --wheel-dir /build/wheels
+
+FROM python:3.13.16-slim-bookworm@sha256:a1165e272e578941b84abc79e4ab38a0305cd12803a5c4247979ac7655f4d641 AS runtime
+ARG AIKIT_VERSION
+LABEL org.opencontainers.image.title="AI-KIT CLI" \
+      org.opencontainers.image.description="Offline AI-KIT instructions, installer and project helpers" \
+      org.opencontainers.image.source="https://github.com/tigusigalpa/ai-kit" \
+      org.opencontainers.image.licenses="MIT" \
+      org.opencontainers.image.version="${AIKIT_VERSION}"
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PYTHONNOUSERSITE=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+RUN apt-get update \
+    && apt-get install --yes --no-install-recommends git \
+    && rm -rf /var/lib/apt/lists/* \
+    && groupadd --gid 10001 aikit \
+    && useradd --uid 10001 --gid 10001 --create-home --shell /usr/sbin/nologin aikit \
+    && mkdir -p /workspace \
+    && chown 10001:10001 /workspace
+COPY --from=wheel-builder /build/wheels /wheels
+RUN python -m pip install --no-index --no-deps /wheels/*.whl \
+    && rm -rf /wheels
+USER 10001:10001
+WORKDIR /workspace
+STOPSIGNAL SIGTERM
+ENTRYPOINT ["aikit"]
+CMD ["--help"]

aikit/KIMI.md

@@ -0,0 +1,3 @@
+# Kimi project entry
+
+Read `AGENTS.md` and the current `PROJECT_CONTEXT.md` before making changes. Open relevant rules through `WIKI.md`; maintain context and skills according to `ai-kit/SKILLS.md`. Supply this file explicitly if the environment does not read it automatically.

aikit/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Igor Sazonov and AI-KIT 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.

aikit/MANIFEST.in

@@ -0,0 +1,22 @@
+include VERSION LICENSE README.md CHANGELOG.md SECURITY.md SKILL.md BOOTSTRAP_PROMPT.md CONTRIBUTING.md
+exclude AGENTS.md PROJECT_CONTEXT.md WIKI.md
+include .gitignore .gitattributes
+include Dockerfile .dockerignore
+include pyproject.toml Makefile MANIFEST.in
+recursive-include ai-kit *.md
+prune ai-kit/.metrics
+prune ai-kit/.memory
+prune ai-kit/.upstream-cache
+prune ai-kit/.design
+recursive-include .agents *
+recursive-include tests *.py *.json *.ps1
+recursive-include docs *
+recursive-include integrations *
+recursive-include template *
+recursive-include template/.agents *
+recursive-include templates *
+recursive-include .github *
+recursive-include docker *.py *.txt
+recursive-include deploy *.yaml
+prune docs/.private
+global-exclude .env .env.* auth.json .netrc .pypirc *.pem *.p12 *.pfx id_rsa* id_ed25519*

aikit/MANUS.md

@@ -0,0 +1,3 @@
+# Manus project entry
+
+Read `AGENTS.md` and the current `PROJECT_CONTEXT.md` before making changes. Open relevant rules through `WIKI.md`; maintain context and skills according to `ai-kit/SKILLS.md`. Supply this file explicitly if the environment does not read it automatically.

aikit/Makefile

@@ -0,0 +1,70 @@
+# AI-KIT front-door. Requires GNU Make; each target maps to the canonical Python command.
+TARGET ?=
+TASK ?=
+TITLE ?=
+MSG ?=
+RECORD ?=
+AGENT ?=
+TASKS ?=
+OUTPUT ?=
+EXPERIMENT ?=
+
+.PHONY: check test wheel install apply doctor context adapters retire route configure providers measure metrics analyze scaffold evaluate adr changelog
+
+check:
+	python scripts/check_kit.py
+
+test:
+	python -m unittest discover -s tests -v
+
+wheel:
+	python -m pip wheel . --no-deps --wheel-dir dist
+	python tests/wheel_smoke.py dist
+
+install:
+	python scripts/install.py $(TARGET)
+
+apply:
+	python scripts/install.py $(TARGET) --apply
+
+doctor:
+	python scripts/doctor.py $(TARGET)
+
+context:
+	python scripts/context.py snapshot $(TARGET)
+
+adapters:
+	python scripts/adapters.py report --project $(TARGET)
+
+retire:
+	python scripts/adapters.py retire $(TARGET) --agent $(AGENT)
+
+route:
+	python scripts/router.py route "$(TASK)"
+
+configure:
+	python scripts/router.py configure $(TARGET) --apply
+
+providers:
+	python scripts/router.py providers
+
+measure:
+	python scripts/metrics.py record $(TARGET) --from-json $(RECORD)
+
+metrics:
+	python scripts/metrics.py summary $(TARGET)
+
+analyze:
+	python scripts/metrics.py analyze $(TARGET)
+
+scaffold:
+	python scripts/evaluate.py scaffold --output $(OUTPUT) --experiment $(EXPERIMENT) --task $(TASK)
+
+evaluate:
+	python scripts/evaluate.py coverage $(TARGET) --tasks $(TASKS)
+
+adr:
+	python scripts/adr.py new "$(TITLE)"
+
+changelog:
+	python scripts/changelog.py add "$(MSG)"