evidence-wiki 0.1.0__tar.gz

evidence_wiki-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+__pycache__/
+*.py[cod]
+*$py.class
+
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.research-cache/
+.coverage
+htmlcov/
+
+build/
+dist/
+*.egg-info/
+
+.venv/
+venv/
+env/
+.env
+.research-handoff-secret
+
+.DS_Store
+
+/temp_workspace/
+/temp_codebase_project/
+/*-smoke-test*/
+/*-init-test*/
+/pilot-workspaces/
+/reports/
+temp/
+RELEASING.md
+!workspace-template/AGENTS.md
+!examples/urban-heat-resilience-workspace/AGENTS.md
+!tests/fixtures/madrid-autonomo-workspace/AGENTS.md

evidence_wiki-0.1.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.0 - 2026-07-13
+
+Initial standalone release of EvidenceWiki.
+
+- Verifiable, provenance-backed research workspaces with deterministic question,
+  source, citation, and publication-readiness workflows.
+- The `evidence-wiki` CLI for workspace creation, upgrades, health checks,
+  question intake, answer export, domain-pack validation, fleet status, and MCP
+  serving.
+- Reusable workspace template, domain packs, orchestrator guidance, and a
+  synthetic worked example.
+- Python 3.10+ support on Windows, macOS, and Ubuntu under the MIT License.

evidence_wiki-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,147 @@
+# Contributing
+
+Thank you for helping improve EvidenceWiki. The project is intended to stay
+reusable across research domains, so changes should be focused, tested, and
+documented from the perspective of workspace users.
+
+## Forks and contributions
+
+You are welcome to fork EvidenceWiki, experiment with it, and adapt it to your
+own research workflows. At this time, the maintainers are not actively seeking
+additional contributors or organizing an active contributor program. If you
+choose to propose a change, please use a fork and follow the guidance below;
+contributions may be reviewed as maintainer time permits.
+
+## Local setup
+
+EvidenceWiki supports Python 3.10 and newer. Create a virtual environment and
+install the development dependencies.
+
+POSIX shells:
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install -e '.[dev]'
+```
+
+Windows PowerShell:
+
+```powershell
+py -3 -m venv .venv
+.venv\Scripts\python.exe -m pip install -e ".[dev]"
+```
+
+The commands below use the POSIX path. On Windows, replace
+`.venv/bin/python` with `.venv\Scripts\python.exe`.
+
+## Repository boundaries
+
+- Keep reusable starter behavior in `workspace-template/`.
+- `workspace-template/scripts/` is the source of truth for workspace tooling.
+  Worked examples vendor the scripts so that they behave like real workspaces.
+  After changing a starter script, synchronize those copies:
+
+  ```bash
+  .venv/bin/python tools/sync_vendored_scripts.py
+  .venv/bin/python tools/sync_vendored_scripts.py --check
+  ```
+
+- Keep domain-specific reusable guidance in `domain-packs/`.
+- Keep test-only workspaces and source examples in `tests/fixtures/`.
+- Register every fixture path in `tests/fixtures/fixture-provenance.yml`.
+  Prefer synthetic or reserved-domain content; third-party material needs
+  explicit redistribution evidence and attribution.
+- Do not copy project-specific wiki content into the reusable starter.
+- Do not mutate raw source fixtures unless a test explicitly needs new evidence.
+
+## Development rules
+
+- Treat `research.yml` as the public workspace contract. Scripts should read
+  configured paths, page types, statuses, and integration settings rather than
+  hardcoding them.
+- Keep generated codebase-analysis output under `sources/`, not maintained
+  `wiki/` pages.
+- Do not add hooks, automatic commits, background synchronization, or network
+  fetching as defaults.
+- Preserve compatibility with Python 3.10+ on Windows, macOS, and Ubuntu.
+- Avoid broad refactors while implementing a focused change.
+
+## Verification
+
+Run the full suite before opening a pull request:
+
+```bash
+.venv/bin/python -m pytest -q
+.venv/bin/python -m ruff check .
+.venv/bin/python tools/sync_vendored_scripts.py --check
+git diff --check
+```
+
+Useful focused checks include:
+
+```bash
+.venv/bin/python -m pytest -q tests/test_package_cli.py
+.venv/bin/python -m pytest -q tests/test_init_research_workspace.py tests/test_smoke_validate_workspace.py
+.venv/bin/python -m pytest -q tests/test_inventory_normalization.py
+.venv/bin/python -m pytest -q tests/test_end_to_end_init_fixture.py
+.venv/bin/python -m pytest -q tests/test_pdf_success_path.py
+```
+
+Optional scale checks remain outside the default suite:
+
+```bash
+EVIDENCE_WIKI_RUN_SCALE=1 .venv/bin/python -m pytest -q tests/test_scale_smoke.py
+```
+
+Agent-quality evaluation is a manual check for comparing prompts or agent-runner
+behavior against the deterministic fixture in
+`tests/fixtures/agent-quality-eval/`:
+
+```bash
+.venv/bin/python tools/score_eval_workspace.py \
+  --export /path/to/export.json \
+  --expected tests/fixtures/agent-quality-eval/expected-answers.yml \
+  --format json
+```
+
+The setup flow and scoring rubric are documented in
+`workspace-template/docs/agent-quality-evaluation.md`.
+
+## Packaging
+
+Before proposing a release, build and inspect both distribution formats:
+
+```bash
+.venv/bin/python -m build --sdist --wheel --no-isolation --outdir /tmp/evidence-wiki-dist
+.venv/bin/python -m twine check /tmp/evidence-wiki-dist/*
+```
+
+The wheel must contain the starter workspace, domain packs, and orchestrator
+guide. The source distribution additionally carries tests and development
+tools. Neither artifact should contain reports, caches, virtual environments,
+scratch workspaces, or build output. See `RELEASING.md` for the maintainer
+checklist. PyPI uploads are intentionally unavailable from pull requests, tag
+pushes, and manual workflow dispatches; only a published GitHub Release can
+start the verified publishing workflow.
+
+## Documentation
+
+Update documentation whenever public behavior changes. Common destinations are:
+
+- User setup: `workspace-template/docs/new-project-guide.md`
+- Initialization profiles: `workspace-template/docs/workspace-initialization.md`
+- Configuration: `workspace-template/docs/research-yml.md`
+- Source records: `workspace-template/docs/source-manifest.md`
+- Normalized records: `workspace-template/docs/normalized-source-format.md`
+- Agent playbooks: `workspace-template/skills/`
+
+Prefer explicit command examples over vague descriptions. A user should be able
+to tell whether each command is read-only, a dry run, or writes files.
+
+## Pull request checklist
+
+- The change has focused tests, or a clear reason tests are unnecessary.
+- The full test and lint suite passes.
+- `git diff --check` passes.
+- New files are intentional and no scratch directories are present.
+- Public behavior changes are documented.

evidence_wiki-0.1.0/Containerfile

@@ -0,0 +1,36 @@
+FROM python:3.12-slim-bookworm@sha256:8a7e7cc04fd3e2bd787f7f24e22d5d119aa590d429b50c95dfe12b3abe52f48b AS builder
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+RUN python -m venv /opt/evidence-wiki-venv
+
+WORKDIR /build
+COPY . .
+
+RUN /opt/evidence-wiki-venv/bin/python -m pip install --no-cache-dir . \
+    && /opt/evidence-wiki-venv/bin/evidence-wiki --version \
+    && find /opt/evidence-wiki-venv -type d -name __pycache__ -prune -exec rm -rf '{}' + \
+    && find /opt/evidence-wiki-venv -type f \( -name '*.pyc' -o -name '*.pyo' \) -delete
+
+FROM python:3.12-slim-bookworm@sha256:8a7e7cc04fd3e2bd787f7f24e22d5d119aa590d429b50c95dfe12b3abe52f48b
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    HOME=/workspace \
+    PATH=/opt/evidence-wiki-venv/bin:$PATH
+
+LABEL org.opencontainers.image.title="EvidenceWiki" \
+      org.opencontainers.image.description="Evidence-gated research workspaces with auditable sources" \
+      org.opencontainers.image.licenses="MIT"
+
+RUN install -d -o 10001 -g 10001 /workspace
+
+COPY --from=builder /opt/evidence-wiki-venv /opt/evidence-wiki-venv
+
+USER 10001:10001
+WORKDIR /workspace
+
+ENTRYPOINT ["/opt/evidence-wiki-venv/bin/evidence-wiki"]
+CMD ["--help"]

evidence_wiki-0.1.0/LICENSE

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