contextual-engine 0.1.0__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (212) hide show
  1. contextual_engine-0.2.0/.github/workflows/release.yml +51 -0
  2. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/.gitignore +3 -1
  3. contextual_engine-0.2.0/AUDIT_LOG.md +1114 -0
  4. contextual_engine-0.2.0/FINAL_AUDIT.md +706 -0
  5. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/LICENSE +1 -1
  6. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/PKG-INFO +60 -102
  7. contextual_engine-0.2.0/README.md +74 -0
  8. contextual_engine-0.2.0/RECOVERY_AUDIT.md +348 -0
  9. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/__init__.py +2 -2
  10. contextual_engine-0.2.0/contextual/cli/__init__.py +144 -0
  11. contextual_engine-0.2.0/contextual/cli/commands/__init__.py +11 -0
  12. contextual_engine-0.2.0/contextual/cli/commands/account.py +18 -0
  13. contextual_engine-0.2.0/contextual/cli/commands/client.py +235 -0
  14. contextual_engine-0.2.0/contextual/cli/commands/fetch.py +99 -0
  15. contextual_engine-0.2.0/contextual/cli/commands/index.py +257 -0
  16. contextual_engine-0.2.0/contextual/cli/commands/serve.py +11 -0
  17. contextual_engine-0.2.0/contextual/cli/commands/stats.py +61 -0
  18. contextual_engine-0.2.0/contextual/cli/commands/temporal.py +15 -0
  19. contextual_engine-0.2.0/contextual/cli/core/__init__.py +20 -0
  20. contextual_engine-0.2.0/contextual/cli/core/context.py +80 -0
  21. contextual_engine-0.2.0/contextual/cli/core/decorators.py +104 -0
  22. contextual_engine-0.2.0/contextual/cli/core/output.py +807 -0
  23. contextual_engine-0.2.0/contextual/config/__init__.py +103 -0
  24. contextual_engine-0.2.0/contextual/config/indexing.py +170 -0
  25. contextual_engine-0.2.0/contextual/core/__init__.py +44 -0
  26. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/core/errors.py +59 -24
  27. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/core/models.py +47 -10
  28. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/git/__init__.py +0 -1
  29. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/git/blame.py +67 -66
  30. contextual_engine-0.2.0/contextual/indexing/__init__.py +139 -0
  31. contextual_engine-0.2.0/contextual/indexing/chunker.py +1148 -0
  32. contextual_engine-0.2.0/contextual/indexing/docs_pipeline.py +691 -0
  33. contextual_engine-0.2.0/contextual/indexing/file_watcher.py +365 -0
  34. contextual_engine-0.2.0/contextual/indexing/incremental.py +391 -0
  35. contextual_engine-0.2.0/contextual/indexing/index_writer.py +337 -0
  36. contextual_engine-0.2.0/contextual/indexing/merkle_tree.py +482 -0
  37. contextual_engine-0.2.0/contextual/indexing/pipeline.py +825 -0
  38. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/indexing/processor.py +148 -36
  39. contextual_engine-0.2.0/contextual/indexing/symbol_extractor.py +414 -0
  40. contextual_engine-0.2.0/contextual/integrations/git_integration.py +547 -0
  41. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/mcp/__main__.py +3 -2
  42. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/mcp/docs_tools.py +152 -113
  43. contextual_engine-0.2.0/contextual/mcp/server.py +159 -0
  44. contextual_engine-0.2.0/contextual/mcp/tools.py +589 -0
  45. contextual_engine-0.2.0/contextual/models/__init__.py +439 -0
  46. contextual_engine-0.2.0/contextual/models/base_embedder.py +140 -0
  47. contextual_engine-0.2.0/contextual/models/reranker_model.py +195 -0
  48. contextual_engine-0.2.0/contextual/models/unified_embedder.py +205 -0
  49. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/observability/logging.py +50 -21
  50. contextual_engine-0.2.0/contextual/retrieval/__init__.py +224 -0
  51. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/retrieval/context_assembler.py +10 -149
  52. contextual_engine-0.2.0/contextual/retrieval/mmr.py +269 -0
  53. contextual_engine-0.2.0/contextual/retrieval/pipeline.py +543 -0
  54. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/retrieval/ranker.py +34 -65
  55. contextual_engine-0.2.0/contextual/retrieval/search.py +636 -0
  56. contextual_engine-0.2.0/contextual/retrieval/tokenizer.py +107 -0
  57. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/security/paths.py +58 -47
  58. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/security/sanitize.py +61 -54
  59. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/security/workspace.py +39 -39
  60. contextual_engine-0.2.0/contextual/storage/__init__.py +134 -0
  61. contextual_engine-0.2.0/contextual/storage/cache.py +232 -0
  62. contextual_engine-0.2.0/contextual/storage/connection.py +453 -0
  63. contextual_engine-0.2.0/contextual/storage/lancedb_provider.py +1311 -0
  64. contextual_engine-0.2.0/contextual/storage/schema.py +510 -0
  65. contextual_engine-0.2.0/docs/ADRs/ADR-001-lancedb-over-vec0.md +272 -0
  66. contextual_engine-0.2.0/docs/ADRs/ADR-002-retry-exponential-backoff.md +49 -0
  67. contextual_engine-0.2.0/docs/ADRs/ADR-003-blake3-deduplication.md +43 -0
  68. contextual_engine-0.2.0/docs/ADRs/ADR-004-async-first-architecture.md +46 -0
  69. contextual_engine-0.2.0/docs/ADRs/ADR-005-model-lineup.md +49 -0
  70. contextual_engine-0.2.0/docs/ARCHITECTURE.md +1022 -0
  71. contextual_engine-0.2.0/docs/Architecture_Diagram.png +0 -0
  72. contextual_engine-0.2.0/docs/DEPLOYMENT.md +268 -0
  73. contextual_engine-0.2.0/docs/DISTRIBUTIONS.md +357 -0
  74. contextual_engine-0.2.0/docs/DRs/CHATGPT-DR-mcp-cli-security-testing-distribution.md +1259 -0
  75. contextual_engine-0.2.0/docs/DRs/CHATGPT-DR-web-ui-experience.md +231 -0
  76. contextual_engine-0.2.0/docs/DRs/CLAUDE-DR-ai-agents-teams.md +581 -0
  77. contextual_engine-0.2.0/docs/DRs/CLAUDE-DR-competitive-landscape-market-analysis.md +107 -0
  78. contextual_engine-0.2.0/docs/DRs/CLAUDE-DR-core-architecture.md +329 -0
  79. contextual_engine-0.2.0/docs/DRs/CLAUDE-DR-mvp-phase0-technical-plan.md +215 -0
  80. contextual_engine-0.2.0/docs/DRs/CLAUDE-DR-strategic-briefing.md +107 -0
  81. contextual_engine-0.2.0/docs/DRs/GEMINI-DR-hybrid-retrieval-local-optimization.md +846 -0
  82. contextual_engine-0.2.0/docs/DRs/GEMINI-DR-infrastructure-security.md +362 -0
  83. contextual_engine-0.2.0/docs/DRs/GEMINI-DR-lance-specs.md +647 -0
  84. contextual_engine-0.2.0/docs/DRs/GEMINI-DR-vec0-vs-lancedb.md +267 -0
  85. contextual_engine-0.2.0/docs/DRs/KIMI-DR-tech-stack-optimization.md +1427 -0
  86. contextual_engine-0.2.0/docs/DRs/PERPLEXITY-DR-indexing-optimisation.md +687 -0
  87. contextual_engine-0.2.0/docs/DRs/PERPLEXITY-DR-lancedb-implementation.md +654 -0
  88. contextual_engine-0.2.0/docs/DRs/PERPLEXITY-DR-local-data-infrastructure.md +1421 -0
  89. contextual_engine-0.2.0/docs/DRs/PERPLEXITY-DR-mcp-security-hardening.md +180 -0
  90. contextual_engine-0.2.0/docs/DRs/PERPLEXITY-DR-models-pipelines.md +335 -0
  91. contextual_engine-0.2.0/docs/DRs/PERPLEXITY-DR-python-async-ai-pipelines.md +435 -0
  92. contextual_engine-0.2.0/docs/DRs/PERPLEXITY-DR-semantic-indexing.md +679 -0
  93. contextual_engine-0.2.0/docs/INTEGRATIONS.md +530 -0
  94. contextual_engine-0.2.0/docs/MEMORY.md +947 -0
  95. contextual_engine-0.2.0/docs/TECHNICAL_SPEC.md +1585 -0
  96. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/pyproject.toml +29 -10
  97. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/pytest.ini +6 -14
  98. contextual_engine-0.2.0/test_incremental.py +165 -0
  99. contextual_engine-0.2.0/test_mcp.py +580 -0
  100. contextual_engine-0.2.0/tests/conftest.py +440 -0
  101. contextual_engine-0.2.0/tests/test_accuracy_speed_async_integrity.py +411 -0
  102. contextual_engine-0.2.0/tests/test_architecture_security_flow.py +523 -0
  103. contextual_engine-0.2.0/tests/test_architecture_wiring.py +730 -0
  104. contextual_engine-0.2.0/tests/test_cross_file_chunk_batching.py +142 -0
  105. contextual_engine-0.2.0/tests/test_deduplication.py +397 -0
  106. contextual_engine-0.2.0/tests/test_expected_behavior.py +890 -0
  107. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/tests/test_performance.py +3 -3
  108. contextual_engine-0.2.0/tests/test_purge_command.py +43 -0
  109. contextual_engine-0.2.0/tests/test_retry_logic.py +79 -0
  110. contextual_engine-0.2.0/tests/test_speed_accuracy.py +813 -0
  111. contextual_engine-0.1.0/.git-hooks/post-commit +0 -40
  112. contextual_engine-0.1.0/.git-hooks/post-rewrite +0 -54
  113. contextual_engine-0.1.0/.pre-commit-config.yaml +0 -20
  114. contextual_engine-0.1.0/.python-version +0 -1
  115. contextual_engine-0.1.0/.uv-cache/.gitignore +0 -1
  116. contextual_engine-0.1.0/.uv-cache/CACHEDIR.TAG +0 -1
  117. contextual_engine-0.1.0/.uv-cache/interpreter-v4/c2c2931c8a99aae1/7e3e9eef2ab92156.msgpack +0 -0
  118. contextual_engine-0.1.0/README.md +0 -132
  119. contextual_engine-0.1.0/contextual/__main__.py +0 -11
  120. contextual_engine-0.1.0/contextual/cli.py +0 -339
  121. contextual_engine-0.1.0/contextual/cli_docs.py +0 -685
  122. contextual_engine-0.1.0/contextual/config.py +0 -7
  123. contextual_engine-0.1.0/contextual/core/__init__.py +0 -11
  124. contextual_engine-0.1.0/contextual/docs/__init__.py +0 -66
  125. contextual_engine-0.1.0/contextual/docs/chunker.py +0 -550
  126. contextual_engine-0.1.0/contextual/docs/pipeline.py +0 -513
  127. contextual_engine-0.1.0/contextual/docs/retrieval.py +0 -654
  128. contextual_engine-0.1.0/contextual/docs/watcher.py +0 -265
  129. contextual_engine-0.1.0/contextual/embedding/__init__.py +0 -87
  130. contextual_engine-0.1.0/contextual/embedding/cache.py +0 -455
  131. contextual_engine-0.1.0/contextual/embedding/embedder.py +0 -414
  132. contextual_engine-0.1.0/contextual/embedding/helpers.py +0 -252
  133. contextual_engine-0.1.0/contextual/indexing/__init__.py +0 -20
  134. contextual_engine-0.1.0/contextual/indexing/bug_sweep.py +0 -119
  135. contextual_engine-0.1.0/contextual/indexing/chunker.py +0 -691
  136. contextual_engine-0.1.0/contextual/indexing/embedder.py +0 -271
  137. contextual_engine-0.1.0/contextual/indexing/file_watcher.py +0 -154
  138. contextual_engine-0.1.0/contextual/indexing/incremental.py +0 -260
  139. contextual_engine-0.1.0/contextual/indexing/index_writer.py +0 -442
  140. contextual_engine-0.1.0/contextual/indexing/pipeline.py +0 -438
  141. contextual_engine-0.1.0/contextual/indexing/queries/readme.md +0 -22
  142. contextual_engine-0.1.0/contextual/indexing/symbol_extractor.py +0 -426
  143. contextual_engine-0.1.0/contextual/indexing/tokenizer.py +0 -203
  144. contextual_engine-0.1.0/contextual/mcp/server.py +0 -118
  145. contextual_engine-0.1.0/contextual/mcp/tools.py +0 -443
  146. contextual_engine-0.1.0/contextual/retrieval/__init__.py +0 -24
  147. contextual_engine-0.1.0/contextual/retrieval/search.py +0 -548
  148. contextual_engine-0.1.0/contextual/storage/__init__.py +0 -36
  149. contextual_engine-0.1.0/contextual/storage/fts_manager.py +0 -273
  150. contextual_engine-0.1.0/contextual/storage/migration_v2.py +0 -289
  151. contextual_engine-0.1.0/contextual/storage/migrations.py +0 -316
  152. contextual_engine-0.1.0/contextual/storage/schema.py +0 -210
  153. contextual_engine-0.1.0/contextual/storage/sqlite_pool.py +0 -468
  154. contextual_engine-0.1.0/contextual/storage/vec0_manager.py +0 -421
  155. contextual_engine-0.1.0/docs/ARCHITECTURE.md +0 -216
  156. contextual_engine-0.1.0/docs/PHASE_1.md +0 -195
  157. contextual_engine-0.1.0/docs/TECHNICAL_SPEC.md +0 -396
  158. contextual_engine-0.1.0/docs/WEEK1_GAMEPLAN.md +0 -621
  159. contextual_engine-0.1.0/docs/adr/ADR-001-embedding-model.md +0 -36
  160. contextual_engine-0.1.0/docs/adr/ADR-002-storage-architecture.md +0 -30
  161. contextual_engine-0.1.0/docs/adr/ADR-003-bitemporal-model.md +0 -31
  162. contextual_engine-0.1.0/docs/adr/ADR-004-hybrid-retrieval.md +0 -34
  163. contextual_engine-0.1.0/docs/adr/ADR-005-mcp-first.md +0 -41
  164. contextual_engine-0.1.0/docs/adr/ADR-006-security.md +0 -30
  165. contextual_engine-0.1.0/docs/adr/ADR-007-licensing.md +0 -51
  166. contextual_engine-0.1.0/docs/adr/ADR-008-treesitter-chunking.md +0 -45
  167. contextual_engine-0.1.0/examples/index_repository.py +0 -145
  168. contextual_engine-0.1.0/examples/readme.md +0 -47
  169. contextual_engine-0.1.0/mypy.ini +0 -57
  170. contextual_engine-0.1.0/ruff.toml +0 -126
  171. contextual_engine-0.1.0/scripts/install-hooks.sh +0 -41
  172. contextual_engine-0.1.0/tests/conftest.py +0 -192
  173. contextual_engine-0.1.0/tests/test_docs_phase2.py +0 -790
  174. contextual_engine-0.1.0/tests/test_e2e_workflow.py +0 -289
  175. contextual_engine-0.1.0/tests/test_indexing.py +0 -364
  176. contextual_engine-0.1.0/tests/test_integration_phase1.py +0 -248
  177. contextual_engine-0.1.0/tests/test_logging.py +0 -28
  178. contextual_engine-0.1.0/tests/test_schema.py +0 -44
  179. contextual_engine-0.1.0/tests/test_search_integration.py +0 -258
  180. contextual_engine-0.1.0/tests/test_storage_integration.py +0 -111
  181. contextual_engine-0.1.0/tests/unit/test_chunker.py +0 -45
  182. contextual_engine-0.1.0/tests/unit/test_errors.py +0 -57
  183. contextual_engine-0.1.0/tests/unit/test_git_integration.py +0 -41
  184. contextual_engine-0.1.0/tests/unit/test_lance_store.py +0 -43
  185. contextual_engine-0.1.0/tests/unit/test_migrations.py +0 -41
  186. contextual_engine-0.1.0/tests/unit/test_models.py +0 -113
  187. contextual_engine-0.1.0/tests/unit/test_processor.py +0 -45
  188. contextual_engine-0.1.0/tests/unit/test_schema.py +0 -54
  189. contextual_engine-0.1.0/tests/unit/test_security.py +0 -73
  190. contextual_engine-0.1.0/tests/unit/test_sqlite_pool.py +0 -49
  191. contextual_engine-0.1.0/tests/unit/test_temporal.py +0 -42
  192. contextual_engine-0.1.0/uv.lock +0 -5149
  193. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/.contextualignore +0 -0
  194. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/.github/workflows/ci.yml +0 -0
  195. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/integrations/__init__.py +1 -1
  196. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/mcp/__init__.py +1 -1
  197. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/observability/__init__.py +1 -1
  198. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/contextual/security/__init__.py +14 -14
  199. /contextual_engine-0.1.0/.uv-cache/.lock → /contextual_engine-0.2.0/docs/CHANGELOG.md +0 -0
  200. /contextual_engine-0.1.0/.uv-cache/sdists-v9/.git → /contextual_engine-0.2.0/docs/FRONTEND.md +0 -0
  201. /contextual_engine-0.1.0/docs/GIT_README.md → /contextual_engine-0.2.0/docs/GITHUB.md +0 -0
  202. /contextual_engine-0.1.0/.uv-cache/sdists-v9/.gitignore → /contextual_engine-0.2.0/docs/MCP_TOOLS.md +0 -0
  203. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/docs/PROJECT_MANAGEMENT.md +0 -0
  204. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/docs/PROJECT_PHASES.md +0 -0
  205. /contextual_engine-0.1.0/contextual/py.typed → /contextual_engine-0.2.0/docs/RESOURCES.md +0 -0
  206. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/docs/ROADMAP.md +0 -0
  207. /contextual_engine-0.1.0/tests/benchmark/__init__.py → /contextual_engine-0.2.0/docs/SECURITY.md +0 -0
  208. /contextual_engine-0.1.0/docs/DELEGATION_PLAYBOOK.md → /contextual_engine-0.2.0/docs/TEAMS.md +0 -0
  209. /contextual_engine-0.1.0/tests/integration/__init__.py → /contextual_engine-0.2.0/docs/TESTING.md +0 -0
  210. /contextual_engine-0.1.0/tests/security/__init__.py → /contextual_engine-0.2.0/docs/VERSION.MD +0 -0
  211. {contextual_engine-0.1.0 → contextual_engine-0.2.0}/tests/__init__.py +0 -0
  212. /contextual_engine-0.1.0/tests/unit/__init__.py → /contextual_engine-0.2.0/tests/test_thread_safety.py +0 -0
@@ -0,0 +1,51 @@
1
+ name: Release
2
+
3
+ on:
4
+ push:
5
+ tags:
6
+ - 'v*'
7
+
8
+ permissions:
9
+ contents: write
10
+ id-token: write # For PyPI trusted publishing
11
+
12
+ jobs:
13
+ release:
14
+ runs-on: ubuntu-latest
15
+
16
+ steps:
17
+ - uses: actions/checkout@v4
18
+ with:
19
+ fetch-depth: 0
20
+
21
+ - name: Set up Python
22
+ uses: actions/setup-python@v5
23
+ with:
24
+ python-version: "3.12"
25
+
26
+ - name: Install build dependencies
27
+ run: |
28
+ pip install build twine
29
+
30
+ - name: Build package
31
+ run: python -m build
32
+
33
+ - name: Publish to PyPI
34
+ uses: pypa/gh-action-pypi-publish@release/v1
35
+ with:
36
+ password: ${{ secrets.PYPI_API_TOKEN }}
37
+
38
+ - name: Extract version from tag
39
+ id: version
40
+ run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
41
+
42
+ - name: Create GitHub Release
43
+ uses: softprops/action-gh-release@v2
44
+ with:
45
+ name: Release ${{ steps.version.outputs.VERSION }}
46
+ generate_release_notes: true
47
+ files: |
48
+ dist/*.whl
49
+ dist/*.tar.gz
50
+ env:
51
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -76,6 +76,7 @@ site/
76
76
  .env
77
77
  .env.local
78
78
  .envrc
79
+ uv.lock
79
80
 
80
81
  # macOS
81
82
  .DS_Store
@@ -102,4 +103,5 @@ CLAUDE.md
102
103
  repo_structure.md
103
104
  SCAFFOLD_README.md
104
105
  output.md
105
- audit_report.md
106
+ audit_report.mduv.lock
107
+ audit.md