codebase-intel 0.1.0__tar.gz → 0.3.0__tar.gz

codebase_intel-0.3.0/.codebase-intel/intent-journal/journal.jsonl

@@ -0,0 +1,6 @@
+{"actor": "cli", "entry_id": "c75235b94d883dc3", "op": "add_node", "payload": {"anchors": [{"content_hash": null, "file_path": "/home/phoenix/Documents/playground/codebase-intel/src/codebase_intel/intentgraph/journal.py", "line_range": null, "symbol_name": null}, {"content_hash": null, "file_path": "/home/phoenix/Documents/playground/codebase-intel/src/codebase_intel/intentgraph/store.py", "line_range": null, "symbol_name": null}], "author": "human", "confidence": 1.0, "created_at": "2026-07-17T17:57:17.836420Z", "decision_id": null, "level": 3, "metadata": {}, "node_id": "4dad4394663a3ee1", "session": null, "source": "capture", "status": "active", "supersede_reason": null, "superseded_by": null, "tags": ["architecture"], "title": "Journal-first intent storage", "trust": "confirmed", "updated_at": "2026-07-17T17:57:17.836424Z", "why": "SQLite index is derived and rebuildable; the JSONL journal committed to git is the source of truth — crash-safety, portability, merge-friendliness"}, "ts": "2026-07-17T17:57:17.836528Z"}
+{"actor": "cli", "entry_id": "c9bf75e21d4b0f5d", "op": "add_node", "payload": {"anchors": [{"content_hash": null, "file_path": "/home/phoenix/Documents/playground/codebase-intel/src/codebase_intel/intentgraph/gate.py", "line_range": null, "symbol_name": null}], "author": "human", "confidence": 1.0, "created_at": "2026-07-17T17:57:18.329111Z", "decision_id": null, "level": 3, "metadata": {}, "node_id": "6c89907cccd0d567", "session": null, "source": "capture", "status": "active", "supersede_reason": null, "superseded_by": null, "tags": ["capture"], "title": "Soft pre-commit gate by default", "trust": "confirmed", "updated_at": "2026-07-17T17:57:18.329116Z", "why": "A hard gate that blocks hotfixes gets uninstalled; soft mode warns and leaves a missing-why backlog node, hard mode is per-repo opt-in"}, "ts": "2026-07-17T17:57:18.329248Z"}
+{"actor": "cli", "entry_id": "19e25c83c221c1c2", "op": "add_node", "payload": {"anchors": [{"content_hash": null, "file_path": "/home/phoenix/Documents/playground/codebase-intel/src/codebase_intel/intentgraph/models.py", "line_range": null, "symbol_name": null}], "author": "human", "confidence": 1.0, "created_at": "2026-07-17T17:57:18.799017Z", "decision_id": null, "level": 3, "metadata": {}, "node_id": "bf8c7774b6ad86ef", "session": null, "source": "capture", "status": "active", "supersede_reason": null, "superseded_by": null, "tags": ["trust"], "title": "Trust tiers surfaced everywhere", "trust": "confirmed", "updated_at": "2026-07-17T17:57:18.799022Z", "why": "A hallucinated why is worse than none — mined/derived/asserted/confirmed tiers appear in every rendered answer so agents can weigh belief"}, "ts": "2026-07-17T17:57:18.799121Z"}
+{"actor": "honesty", "entry_id": "4345f164f5d49491", "op": "update_node", "payload": {"changes": {"anchors": [{"content_hash": "3c48a38271e70ea5", "file_path": "/home/phoenix/Documents/playground/codebase-intel/src/codebase_intel/intentgraph/journal.py", "line_range": null, "symbol_name": null}, {"content_hash": "4973465f9237c937", "file_path": "/home/phoenix/Documents/playground/codebase-intel/src/codebase_intel/intentgraph/store.py", "line_range": null, "symbol_name": null}]}, "node_id": "4dad4394663a3ee1"}, "ts": "2026-07-17T18:01:40.723012Z"}
+{"actor": "honesty", "entry_id": "7ed94ef9d40e7393", "op": "update_node", "payload": {"changes": {"anchors": [{"content_hash": "8358c0e41997c035", "file_path": "/home/phoenix/Documents/playground/codebase-intel/src/codebase_intel/intentgraph/gate.py", "line_range": null, "symbol_name": null}]}, "node_id": "6c89907cccd0d567"}, "ts": "2026-07-17T18:01:40.728759Z"}
+{"actor": "honesty", "entry_id": "92aad8529d3af2af", "op": "update_node", "payload": {"changes": {"anchors": [{"content_hash": "5b9e6e9b15bf8b83", "file_path": "/home/phoenix/Documents/playground/codebase-intel/src/codebase_intel/intentgraph/models.py", "line_range": null, "symbol_name": null}]}, "node_id": "bf8c7774b6ad86ef"}, "ts": "2026-07-17T18:01:40.732727Z"}

codebase_intel-0.3.0/.codebase-intel/intents/INT-001.yaml

@@ -0,0 +1,39 @@
+id: INT-001
+title: Live efficiency tracking must work end-to-end via MCP
+description: Every get_context MCP call must record analytics, and the dashboard must
+  show real data from actual MCP usage.
+status: verified
+priority: 1
+criteria:
+- description: Analytics tracker module exists
+  criterion_type: file_exists
+  check_value: src/codebase_intel/analytics/tracker.py
+  verified: true
+- description: MCP server initializes analytics tracker
+  criterion_type: file_contains
+  check_value: src/codebase_intel/mcp/server.py::AnalyticsTracker
+  verified: true
+- description: Assembler accepts analytics_tracker parameter
+  criterion_type: file_contains
+  check_value: src/codebase_intel/orchestrator/assembler.py::analytics_tracker
+  verified: true
+- description: MCP server passes analytics to assembler
+  criterion_type: file_contains
+  check_value: src/codebase_intel/mcp/server.py::analytics_tracker=state
+  verified: true
+- description: Dashboard CLI command exists
+  criterion_type: grep_match
+  check_value: def dashboard::src/codebase_intel/cli/main.py
+  verified: true
+- description: Benchmark CLI command exists
+  criterion_type: grep_match
+  check_value: def benchmark::src/codebase_intel/cli/main.py
+  verified: true
+created_at: '2026-04-08T12:51:28.427512Z'
+updated_at: '2026-04-08T12:51:28.432214Z'
+verified_at: '2026-04-08T12:51:28.432215Z'
+session_id: null
+tags:
+- core
+- analytics
+- mcp

codebase_intel-0.3.0/.codebase-intel/intents/INT-002.yaml

@@ -0,0 +1,35 @@
+id: INT-002
+title: Feedback loop must capture acceptance/rejection via MCP
+description: Agents must be able to report whether their output was accepted or rejected,
+  and the system must learn from this.
+status: verified
+priority: 1
+criteria:
+- description: Feedback tracker module exists
+  criterion_type: file_exists
+  check_value: src/codebase_intel/analytics/feedback.py
+  verified: true
+- description: MCP server has record_feedback tool
+  criterion_type: mcp_tool_exists
+  check_value: record_feedback
+  verified: true
+- description: MCP server has get_efficiency_report tool
+  criterion_type: mcp_tool_exists
+  check_value: get_efficiency_report
+  verified: true
+- description: MCP server initializes feedback tracker
+  criterion_type: file_contains
+  check_value: src/codebase_intel/mcp/server.py::FeedbackTracker
+  verified: true
+- description: Feedback handler maps rejection reasons to suggestions
+  criterion_type: file_contains
+  check_value: src/codebase_intel/analytics/feedback.py::_suggestion_for_reason
+  verified: true
+created_at: '2026-04-08T12:51:28.428541Z'
+updated_at: '2026-04-08T12:51:28.532925Z'
+verified_at: '2026-04-08T12:51:28.532935Z'
+session_id: null
+tags:
+- core
+- feedback
+- mcp

codebase_intel-0.3.0/.codebase-intel/intents/INT-003.yaml

@@ -0,0 +1,55 @@
+id: INT-003
+title: Intent tracking must prevent 'built but not wired' gaps
+description: The system must capture user goals, verify acceptance criteria against
+  actual code, and flag unmet criteria before marking done.
+status: verified
+priority: 1
+criteria:
+- description: Intent models exist
+  criterion_type: file_exists
+  check_value: src/codebase_intel/intent/models.py
+  verified: true
+- description: Intent verifier exists
+  criterion_type: file_exists
+  check_value: src/codebase_intel/intent/verifier.py
+  verified: true
+- description: Intent store exists
+  criterion_type: file_exists
+  check_value: src/codebase_intel/intent/store.py
+  verified: true
+- description: MCP server has set_intent tool
+  criterion_type: mcp_tool_exists
+  check_value: set_intent
+  verified: true
+- description: MCP server has check_intent tool
+  criterion_type: mcp_tool_exists
+  check_value: check_intent
+  verified: true
+- description: MCP server has list_intents tool
+  criterion_type: mcp_tool_exists
+  check_value: list_intents
+  verified: true
+- description: CLI intent command exists
+  criterion_type: grep_match
+  check_value: def intent::src/codebase_intel/cli/main.py
+  verified: true
+- description: Verifier can check file_exists criterion
+  criterion_type: function_exists
+  check_value: _check_file_exists
+  verified: true
+- description: Verifier can check file_contains criterion
+  criterion_type: function_exists
+  check_value: _check_file_contains
+  verified: true
+- description: Verifier can check wired criterion
+  criterion_type: function_exists
+  check_value: _check_wired
+  verified: true
+created_at: '2026-04-08T12:51:28.430099Z'
+updated_at: '2026-04-08T12:51:28.545922Z'
+verified_at: '2026-04-08T12:51:28.545924Z'
+session_id: null
+tags:
+- core
+- intent
+- verification

codebase_intel-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv venv
+      - run: uv pip install -e ".[dev]"
+      - run: uv run pytest tests/unit/ -x -q --no-header -p no:cacheprovider -o "addopts="
+        env:
+          PYTHONDONTWRITEBYTECODE: 1

codebase_intel-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+      - run: uv python install 3.12
+      - run: uv build
+      - name: Publish to PyPI
+        run: uv publish
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}

codebase_intel-0.3.0/.gitignore

@@ -0,0 +1,52 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project runtime data (generated by codebase-intel itself)
+.codebase-intel/graph.db
+.codebase-intel/graph.db-wal
+.codebase-intel/graph.db-shm
+# Intent graph: the SQLite index is derived and rebuildable — the journal (JSONL) IS committed
+.codebase-intel/intent-graph.db
+.codebase-intel/intent-graph.db-wal
+.codebase-intel/intent-graph.db-shm
+# Analytics/benchmark/eval history — local telemetry, not project state
+.codebase-intel/analytics.db
+.codebase-intel/analytics.db-wal
+.codebase-intel/analytics.db-shm
+.codebase-intel/feedback.db
+.codebase-intel/feedback.db-wal
+.codebase-intel/feedback.db-shm
+
+# Environment
+.env
+.env.*

codebase_intel-0.3.0/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses
+[Semantic Versioning](https://semver.org/).
+
+## [0.3.0] — 2026-10-23
+
+### Added
+
+- **Intent graph (v2).** A multi-level "why" layer. `.codebase-intel/intent-journal/*.jsonl` is the
+  committed source of truth, and `intent-graph.db` is a rebuildable, git-ignored index. Nodes
+  carry trust tiers (`mined` → `derived` → `asserted` → `confirmed`) and four abstraction levels.
+- MCP tools: `bootstrap`, `check_precedent`, `record_why`, `get_intent`. The server now exposes 16 tools.
+- CLI: `why`, `intent-gate`, `install-hooks`, `intent-check`, `intent-confirm`, `intent-render`,
+  `intent-migrate`, `intent-rebuild`, `intent-eval`.
+- Pre-commit intent gate that warns (or blocks, with `intentgraph.gate_hard`) on structural
+  changes with no recorded why.
+- Anchor repair and re-anchoring when code moves; divergence, conflict and coverage reporting.
+- Human projection of the intent graph as HTML or Mermaid.
+- Safe, re-runnable migration of v1 decision records into the intent graph.
+- Eval harness (`intent-eval`) measuring token cost and retrieval correctness against the v1
+  baseline. Self-hosted results and caveats are in `docs/EVAL-RESULTS.md`.
+- Agent skill at `skills/codebase-intel/SKILL.md` that tells agents when to call the intent tools.
+
+### Changed
+
+- The package version now comes from `codebase_intel.__version__`, and `get_status` reports
+  it. Before this, three version strings had drifted apart: `0.1.0`, `0.2.0` and `0.2.0`.
+- Project URLs in the package metadata now point to the actual GitHub repository.
+
+### Fixed
+
+- Removed all pre-existing ruff and mypy errors in the v1 modules.
+
+## [0.2.0] — 2026-04-09
+
+### Added
+
+- Global workspace manager: one MCP server for every registered project (`serve --auto`).
+- Intent tracking (`set_intent`, `check_intent`, `list_intents`) with machine-verifiable
+  acceptance criteria.
+- Cross-repo awareness across 14 web frameworks in 10 languages.
+- Feedback loop and efficiency reporting.
+
+## [0.1.0]
+
+- Initial release: code graph, decision journal, quality contracts, drift detection, MCP server, CLI.
+
+[0.3.0]: https://github.com/a-mutharasu/codebase-intel/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/a-mutharasu/codebase-intel/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/a-mutharasu/codebase-intel/releases/tag/v0.1.0

{codebase_intel-0.1.0 → codebase_intel-0.3.0}/CLAUDE.md

@@ -56,10 +56,20 @@ src/codebase_intel/
 ├── contracts/     # models.py, parser.py, evaluator.py, registry.py
 ├── orchestrator/  # assembler.py, budget.py, scorer.py, conflict.py
 ├── drift/         # detector.py, reporter.py
-├── mcp/           # server.py
+├── intentgraph/   # v2 core: models, journal (JSONL truth), store (SQLite index),
+│                  #   capture, classifier, gate, traversal, bootstrap, anchors,
+│                  #   render, migrate — the multi-level intent graph
+├── workspace/     # manager.py, registry.py — global multi-project workspace
+├── crossrepo/     # models.py, scanner.py, registry.py — cross-service deps
+├── analytics/     # tracker.py, benchmark.py, feedback.py
+├── intent/        # models.py, verifier.py, store.py
+├── mcp/           # server.py (supports --auto multi-project mode)
 └── cli/           # main.py
 ```
 
+Outside `src/`: `skills/codebase-intel/SKILL.md` is the agent skill (portable frontmatter only:
+name, description, license, compatibility). `CHANGELOG.md` records releases.
+
 ## Key Commands
 - `ruff check src/ tests/` — Lint
 - `ruff format src/ tests/` — Format
@@ -77,7 +87,23 @@ src/codebase_intel/
 - Content hashing via xxhash for change detection
 - ISO 8601 for all timestamps, UTC timezone
 
+## Intent Graph (v2)
+- Journal-first: `.codebase-intel/intent-journal/*.jsonl` is committed source of truth;
+  `intent-graph.db` is a derived, rebuildable index (git-ignored)
+- Trust tiers: mined → derived → asserted (agent) → confirmed (human) — surfaced in every render
+- MCP tools: record_why, check_precedent, bootstrap, get_intent
+- CLI: why, intent-gate, install-hooks, intent-check, intent-confirm, intent-render,
+  intent-migrate, intent-rebuild, intent-eval
+- Degradation ladder everywhere: intent graph → code graph → raw files, never hard-fail
+- Eval harness (T-006): `codebase-intel intent-eval <repo...>` — token AND correctness
+  A/B (accuracy@1/@3, naive-vs-citation token reduction) vs the v1 baseline. See
+  docs/EVAL-RESULTS.md for methodology and this repo's self-hosted numbers.
+- See docs/V2-PLAN.md (requirements/design) and docs/TASK-LEDGER.md (state)
+
 ## Current Focus
-- Initial architecture build-out with comprehensive edge case handling
-- Core module implementation
-- MCP server interface design
+- v0.3.0 release prep (intent graph + agent skill) on `chore/release-0.3.0`; version is
+  single-sourced from `codebase_intel.__version__` via `[tool.hatch.version]`
+  (release = GitHub Release → `publish.yml` → PyPI)
+- v2 intent graph: Phases 0–5 + eval harness shipped (see TASK-LEDGER)
+- Next: eval harness needs 2–3 external production repos for a broader A/B (T-006
+  remains open for that), team layer depth, pre-existing coverage debt (T-008)

{codebase_intel-0.1.0 → codebase_intel-0.3.0}/CONTRIBUTING.md

@@ -5,7 +5,7 @@ Thanks for wanting to help. Here's how to get started.
 ## Setup
 
 ```bash
-git clone https://github.com/MutharasuArchunan13/codebase-intel.git
+git clone https://github.com/a-mutharasu/codebase-intel.git
 cd codebase-intel
 uv sync --dev          # or: pip install -e ".[dev]"
 ```

codebase_intel-0.3.0/HANDOFF.md

@@ -0,0 +1,104 @@
+# Handoff — codebase-intel v2 (Intent Graph)
+
+Last updated: 2026-07-18 · Branch: `main` · For the next session (human or agent)
+## Read this first
+
+1. This file (5 min) — orientation and where things stand
+2. `docs/V2-PLAN.md` — the requirements analysis and phased plan this work follows
+3. `docs/TASK-LEDGER.md` — the authoritative, up-to-date task state (source of truth,
+   supersedes anything below if they disagree)
+
+## What this is
+
+`codebase-intel` v1 gives AI agents structured code-graph context, a decision journal,
+and quality contracts. v2 (this work) adds an **intent graph**: a multi-level "why" layer
+captured at decision time, so agents traverse recorded reasoning instead of re-reading
+files and re-deciding things that were already decided. See `docs/V2-PLAN.md` for the
+full functional/non-functional requirements and the resilience design.
+
+## State right now
+
+All of v2 Phases 0–5 are built, tested, and merged to `main`. Plus a chore pass that
+eliminated all pre-existing v1 ruff/mypy debt. Concretely:
+
+| Phase | What | Status |
+|---|---|---|
+| 0 | Intent graph foundation — journal-first store (JSONL truth + rebuildable SQLite index), trust tiers, v1→v2 migration | done |
+| 1 | Capture loop — `record_why`, `check_precedent`, pre-commit gate, significance classifier | done |
+| 2 | Traversal + session bootstrap with a mandatory degradation ladder | done |
+| 3 | Honesty machinery — anchor repair/re-anchoring, staleness, conflicts, coverage | done |
+| 5 | Human projection (Mermaid/HTML render) + review promotion (asserted→confirmed) | done |
+| 4 (T-006) | Eval harness — token AND correctness A/B | **blocked**, see below |
+| — (T-008) | v1 lint/type/coverage debt | ruff+mypy done; coverage gate still open |
+
+913 tests passing, `ruff check`/`ruff format --check`/`mypy src/` all clean on `main`.
+
+### What's genuinely unfinished
+
+- **T-006 (eval harness) is blocked, not done.** The harness itself
+  (`analytics/eval.py`, CLI `codebase-intel intent-eval`) is code-complete and verified
+  end-to-end — it ran against this repo and produced real numbers
+  (`docs/EVAL-RESULTS.md`: 100% accuracy@1/@3, 99% token reduction, n=3 cases, self-hosted
+  only). The task's actual bar ("real repos," plural, vs v1 baseline) needs 2+ external
+  production repos. The CLI already accepts multiple paths
+  (`codebase-intel intent-eval repo-a repo-b repo-c`) — no more code is needed, just repos
+  to point it at. **This is the most concrete unblock a human can hand over.**
+- **T-008 (v1 coverage debt) is in-progress.** `ruff` (222→0) and `mypy` (33→0) errors are
+  fully fixed. The `pytest` 90% coverage gate still fails (~45% project-wide) because large
+  v1 modules have zero dedicated unit tests: `mcp/server.py` (~5%), `graph/query.py` (0%),
+  `intent/*.py` (0%), `crossrepo/*.py` (0%), `decisions/miner.py` (0%). This is a
+  substantially larger effort (writing tests for existing untested v1 code) than the
+  lint/type fixes were — treat it as its own project, not a quick follow-on. Until it's
+  addressed, run tests with `pytest --no-cov` or expect the coverage gate to fail even
+  though every test passes.
+
+## How to verify the repo is healthy
+
+```bash
+uv sync --extra dev
+uv run ruff check src/ tests/          # should be clean
+uv run ruff format --check src/ tests/ # should be clean
+uv run mypy src/                        # should be clean
+uv run pytest --no-cov -q               # 913 passed
+```
+
+## How to explore what v2 built
+
+```bash
+codebase-intel why "<title>" "<reason>" -f <file>   # record a why
+codebase-intel intent-gate                          # pre-commit gate (also installable: install-hooks)
+codebase-intel intent-check                         # anchor validation/repair report
+codebase-intel intent-render -f html -o out.html     # human-readable graph
+codebase-intel intent-eval <repo...>                 # token+correctness eval (T-006)
+```
+
+Or via MCP tools: `record_why`, `check_precedent`, `bootstrap`, `get_intent`.
+
+This repo dogfoods its own intent graph — `.codebase-intel/intent-journal/journal.jsonl`
+is committed and has real entries from this session's own work (see git history on that
+path). `docs/intent-graph.html` is a static render of it.
+
+## Working conventions this session used (carry these forward)
+
+- One feature branch per phase (`feature/v2-phaseN-...`), squash of work, merge
+  `--ff-only` to `main` after full verification (ruff + mypy + full test suite).
+- `docs/TASK-LEDGER.md` is updated at claim-time (status → in-progress, owner, touched)
+  and at completion (status → done/blocked, a dated Decisions entry explaining what
+  passed/what didn't and why) — read it before trusting any status claim here, this file
+  is a snapshot and will go stale.
+- Commits in this session were made **without** a Co-Authored-By trailer, per explicit
+  user instruction — continue that unless told otherwise.
+- Don't mark a ledger task `done` if its literal Verify bar isn't met — T-006 is the
+  example: the harness works, but "done" would overclaim a multi-repo A/B that hasn't
+  happened yet. `blocked` was used instead, with what's built vs what's missing spelled
+  out.
+
+## Suggested next steps (not mandated — use judgment)
+
+1. If you have other repos handy: `codebase-intel init` in them, capture a few real
+   `why`s, then `codebase-intel intent-eval` across all of them for T-006's real bar.
+2. Otherwise: pick up T-008's coverage debt, module by module (mcp/server.py and
+   graph/query.py are the biggest zero-coverage gaps).
+3. Team-layer depth (multi-user review queues, ownership UI, access control) was
+   deliberately deferred in Phase 5 — `capture.promote()` + owner metadata is the seed if
+   that becomes a priority.

{codebase_intel-0.1.0 → codebase_intel-0.3.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Mutharasu
+Copyright (c) 2026 Mutharasu A
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal