continuum-toolkit 1.0.0__py3-none-any.whl

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 (72) hide show
  1. cli/__init__.py +12 -0
  2. cli/main.py +415 -0
  3. confidence/__init__.py +13 -0
  4. confidence/calculator.py +308 -0
  5. confidence/models.py +40 -0
  6. context/__init__.py +17 -0
  7. context/models.py +108 -0
  8. context/pruner.py +228 -0
  9. context/selector.py +193 -0
  10. continuum_toolkit-1.0.0.dist-info/METADATA +511 -0
  11. continuum_toolkit-1.0.0.dist-info/RECORD +72 -0
  12. continuum_toolkit-1.0.0.dist-info/WHEEL +5 -0
  13. continuum_toolkit-1.0.0.dist-info/entry_points.txt +2 -0
  14. continuum_toolkit-1.0.0.dist-info/licenses/LICENSE +21 -0
  15. continuum_toolkit-1.0.0.dist-info/top_level.txt +13 -0
  16. contradictions/__init__.py +19 -0
  17. contradictions/detector.py +442 -0
  18. contradictions/models.py +75 -0
  19. core/__init__.py +97 -0
  20. core/enums.py +130 -0
  21. core/evidence.py +117 -0
  22. core/interfaces.py +209 -0
  23. core/schema.py +391 -0
  24. core/serializer.py +84 -0
  25. core/state_models.py +530 -0
  26. daemon/__init__.py +12 -0
  27. daemon/service.py +170 -0
  28. extractors/__init__.py +51 -0
  29. extractors/base.py +117 -0
  30. extractors/config/parsers.py +288 -0
  31. extractors/config/secret_sanitizer.py +91 -0
  32. extractors/config_extractor.py +172 -0
  33. extractors/conversation/analyzers.py +193 -0
  34. extractors/conversation/models.py +148 -0
  35. extractors/conversation_extractor.py +166 -0
  36. extractors/git_extractor.py +305 -0
  37. extractors/parsers/base.py +91 -0
  38. extractors/parsers/comment_parser.py +51 -0
  39. extractors/parsers/js_ts_parser.py +171 -0
  40. extractors/parsers/python_parser.py +180 -0
  41. extractors/verification/runners.py +278 -0
  42. extractors/verification_extractor.py +263 -0
  43. extractors/workspace_extractor.py +221 -0
  44. graph/__init__.py +24 -0
  45. graph/diff.py +109 -0
  46. graph/manager.py +473 -0
  47. graph/models.py +62 -0
  48. graph/propagator.py +194 -0
  49. graph/query.py +86 -0
  50. graph/snapshot.py +85 -0
  51. handoff/__init__.py +28 -0
  52. handoff/adapters/__init__.py +45 -0
  53. handoff/adapters/base.py +90 -0
  54. handoff/adapters/claude_adapter.py +176 -0
  55. handoff/adapters/codex_gpt_adapter.py +151 -0
  56. handoff/adapters/gemini_adapter.py +151 -0
  57. handoff/adapters/local_model_adapter.py +130 -0
  58. handoff/models.py +88 -0
  59. handoff/packager.py +288 -0
  60. pipeline/__init__.py +9 -0
  61. pipeline/orchestrator.py +260 -0
  62. resolution/__init__.py +15 -0
  63. resolution/resolver.py +311 -0
  64. storage/__init__.py +18 -0
  65. storage/hooks.py +125 -0
  66. storage/manager.py +127 -0
  67. storage/models.py +39 -0
  68. storage/recovery.py +98 -0
  69. watcher/__init__.py +17 -0
  70. watcher/detector.py +136 -0
  71. watcher/models.py +62 -0
  72. watcher/updater.py +163 -0
@@ -0,0 +1,511 @@
1
+ Metadata-Version: 2.4
2
+ Name: continuum-toolkit
3
+ Version: 1.0.0
4
+ Summary: AI Work Continuity & Cross-Model Agent Handoff System
5
+ Author: Project Continuum Team
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/Ashish6298/CONTINUUM
8
+ Project-URL: Documentation, https://github.com/Ashish6298/CONTINUUM#readme
9
+ Project-URL: Repository, https://github.com/Ashish6298/CONTINUUM.git
10
+ Keywords: ai,agent-handoff,work-continuity,llm-context,dag,state-graph,developer-tools
11
+ Classifier: Development Status :: 5 - Production/Stable
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.10
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Topic :: Software Development :: Build Tools
19
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
20
+ Requires-Python: >=3.10
21
+ Description-Content-Type: text/markdown
22
+ License-File: LICENSE
23
+ Provides-Extra: dev
24
+ Requires-Dist: pytest>=7.0.0; extra == "dev"
25
+ Dynamic: license-file
26
+
27
+ <a id="top"></a>
28
+ <div align="center">
29
+
30
+ ```text
31
+ █▀▀ █▀█ █▄ █ ▀█▀ █ █▄ █ █ █ █ █ █▀▄▀█
32
+ █▄▄ █▄█ █ ▀█ █ █ █ ▀█ █▄█ █▄█ █ ▀ █
33
+ ```
34
+ ### *AI Work Continuity & Cross-Model Agent Handoff System*
35
+
36
+ <p align="center">
37
+ <b>An open-source engineering engine that captures, verifies, and packages your project state for seamless continuity across AI coding assistants and models such as Claude, GPT, Gemini, Cursor, Antigravity, Local LLMs, etc.</b>
38
+ </p>
39
+
40
+ ```text
41
+ [01] Extract Physical State ──► [02] Arbitrate Ground Truth ──► [03] Build State DAG ──► [04] Package Handoff
42
+ ```
43
+
44
+ <br/>
45
+
46
+ <table>
47
+ <tr>
48
+ <td align="center"><a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?style=plastic&logo=python&logoColor=white" alt="Python 3.10+"/></a></td>
49
+ <td align="center"><a href="https://pypi.org/project/continuum-toolkit/"><img src="https://img.shields.io/badge/PyPI-v1.0.0-007EC6?style=plastic&logo=pypi&logoColor=white" alt="PyPI Package"/></a></td>
50
+ <td align="center"><a href="tests/"><img src="https://img.shields.io/badge/Tests-126%2F126_Passed-00C853?style=plastic&logo=checkmarx&logoColor=white" alt="Tests Passed"/></a></td>
51
+ <td align="center"><a href="docs/ARCHITECTURE.md"><img src="https://img.shields.io/badge/Architecture-3--State_Engine-7F77DD?style=plastic&logo=diagramsdotnet&logoColor=white" alt="3-State Architecture"/></a></td>
52
+ </tr>
53
+ <tr>
54
+ <td align="center"><a href="https://json-schema.org/"><img src="https://img.shields.io/badge/Schema-Draft_7-2962FF?style=plastic&logo=json&logoColor=white" alt="JSON Schema"/></a></td>
55
+ <td align="center"><a href="docs/CLI_REFERENCE.md"><img src="https://img.shields.io/badge/CLI-Smart_1--Command-FF6B6B?style=plastic&logo=gnometerminal&logoColor=white" alt="Smart 1-Command CLI"/></a></td>
56
+ <td align="center"><a href="#testing--verification"><img src="https://img.shields.io/badge/Privacy-Zero_Telemetry-17A2B8?style=plastic&logo=openaccess&logoColor=white" alt="Zero Telemetry"/></a></td>
57
+ <td align="center"><a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-F5A623?style=plastic&logo=open-source-initiative&logoColor=white" alt="MIT License"/></a></td>
58
+ </tr>
59
+ </table>
60
+
61
+ <br>
62
+
63
+ </div>
64
+
65
+ ## 🧭 Navigation
66
+
67
+ <pre>
68
+ # SYSTEM NAVIGATION MAP
69
+ ├── <b>[01] FOUNDATION & BENCHMARK</b>
70
+ │ ├── ❯ <a href="#what-is-continuum"><b>Overview & Core Problem</b></a>
71
+ │ ├── ❯ <a href="#why-continuum-over-chat-summaries"><b>Benchmark: Continuum vs Chat Summaries</b></a>
72
+ │ └── ❯ <a href="#quick-start-guide"><b>1-Command Quickstart Guide</b></a>
73
+ │
74
+ ├── <b>[02] ARCHITECTURE & GROUND TRUTH</b>
75
+ │ ├── ❯ <a href="#three-state-separation-architecture"><b>3-State Separation Engine</b></a>
76
+ │ ├── ❯ <a href="#5-tier-evidence-hierarchy-matrix"><b>5-Tier Evidence Arbitration Matrix</b></a>
77
+ │ └── ❯ <a href="#canonical-state-graph-dag"><b>Canonical Dependency Graph (DAG)</b></a>
78
+ │
79
+ └── <b>[03] TOOLING & GOVERNANCE</b>
80
+ ├── ❯ <a href="#smart-omni-model-handoff-adapters"><b>Omni-Model Handoff Adapters</b></a>
81
+ ├── ❯ <a href="#complete-cli-reference"><b>Complete CLI Command Reference</b></a>
82
+ ├── ❯ <a href="#verified-roadmap-all-24-phases"><b>Roadmap to v1.0.0 (All 24 Phases)</b></a>
83
+ ├── ❯ <a href="#testing--verification"><b>Testing & Verification</b></a>
84
+ ├── ❯ <a href="#contributing"><b>Contributing Guide</b></a>
85
+ ├── ❯ <a href="#code-of-conduct"><b>Code of Conduct</b></a>
86
+ ├── ❯ <a href="#security"><b>Security & Privacy</b></a>
87
+ └── ❯ <a href="#license"><b>License</b></a>
88
+ </pre>
89
+
90
+ <br>
91
+
92
+ <a id="what-is-continuum"></a>
93
+ ## 💡 What is Continuum?
94
+
95
+ > **Continuum** is an open-source work continuity platform for multi-agent software engineering. It automatically extracts, arbitrates, and packages verified workspace state — enabling seamless, zero-drift handoffs across Claude, GPT-4o, Gemini, Cursor, and local LLMs.
96
+
97
+ <br/>
98
+
99
+ <table>
100
+ <tr>
101
+ <th width="28%" align="left"><b>Feature Pillar</b></th>
102
+ <th width="72%" align="left"><b>Architecture & Capabilities</b></th>
103
+ </tr>
104
+ <tr>
105
+ <td><b>🏛️ 3-State Engine</b></td>
106
+ <td>Strict ontological separation between <b>Project State</b> (AST symbols, files, tests), <b>Conversational State</b> (requirements, chat claims), and <b>Agent Execution State</b> (in-flight edits).</td>
107
+ </tr>
108
+ <tr>
109
+ <td><b>⚖️ 5-Tier Truth Matrix</b></td>
110
+ <td>Proof-grounded arbitration engine. When conversational claims conflict with codebase reality, physical evidence strictly takes precedence with automated contradiction logging.</td>
111
+ </tr>
112
+ <tr>
113
+ <td><b>🕸️ State Graph (DAG)</b></td>
114
+ <td>Topological Directed Acyclic Graph connecting milestones to code symbols. Automatically propagates <code>STALE</code> invalidations downstream when files change.</td>
115
+ </tr>
116
+ <tr>
117
+ <td><b>🤖 Omni-Model Handoff</b></td>
118
+ <td>Single-command generation of model-native context packages tailored for <b>Claude</b> (XML tagged), <b>GPT/Codex</b>, <b>Gemini</b>, and <b>Local LLMs</b>.</td>
119
+ </tr>
120
+ <tr>
121
+ <td><b>🛡️ Autonomous Governance</b></td>
122
+ <td>Background observer daemon paired with non-blocking Git commit hooks, SHA-256 state provenance, corruption self-healing, and 100% local zero telemetry.</td>
123
+ </tr>
124
+ </table>
125
+
126
+ <br>
127
+
128
+ <a id="why-continuum-over-chat-summaries"></a>
129
+ ## ⚔️ Why Continuum over Chat Summaries?
130
+
131
+ > Conversational summaries degrade across sessions because they record what agents *say*, not what exists on disk. Continuum replaces subjective chat memory with verified codebase state.
132
+
133
+ ```text
134
+ [WITHOUT CONTINUUM]
135
+ Chat Logs ──► LLM Compression ──► Context Drift ──► Broken Agent Handoff ❌
136
+
137
+ [WITH CONTINUUM]
138
+ Workspace ──► AST & Test Proof ──► 5-Tier Truth ──► Seamless Omni-Handoff ✅
139
+ ```
140
+
141
+ ### 📊 Capability Benchmark Matrix
142
+
143
+ ```text
144
+ 🔬 AST & Symbol Grounding
145
+ • Chat Summaries ░░░░░░░░░░ [0/10] (Zero Code Awareness)
146
+ • Custom Scripts ████░░░░░░ [4/10] (Regex / Naive Parsing)
147
+ • ⬢ CONTINUUM ██████████ [10/10] (Polyglot AST & Full Symbol Resolution)
148
+
149
+ ⚖️ Contradiction Detection
150
+ • Chat Summaries ░░░░░░░░░░ [0/10] (Propagates Hallucinations)
151
+ • Custom Scripts ░░░░░░░░░░ [0/10] (No Conflict Ledger)
152
+ • ⬢ CONTINUUM ██████████ [10/10] (5-Tier Proof Arbitration)
153
+
154
+ 🕸️ Dependency Graph (DAG)
155
+ • Chat Summaries ░░░░░░░░░░ [0/10] (Flat Text Memory)
156
+ • Custom Scripts █░░░░░░░░░ [1/10] (Ad-hoc File Lists)
157
+ • ⬢ CONTINUUM ██████████ [10/10] (Topological DAG & Stale Propagation)
158
+
159
+ 📦 Omni-Model Handoffs
160
+ • Chat Summaries ██░░░░░░░░ [2/10] (Copy-Paste Prompts)
161
+ • Custom Scripts ████░░░░░░ [4/10] (Single-Model Output)
162
+ • ⬢ CONTINUUM ██████████ [10/10] (Claude, GPT-4o, Gemini, Local LLMs)
163
+
164
+ 🛡️ State Self-Healing
165
+ • Chat Summaries ░░░░░░░░░░ [0/10] (Zero Recovery)
166
+ • Custom Scripts ░░░░░░░░░░ [0/10] (No Snapshots)
167
+ • ⬢ CONTINUUM ██████████ [10/10] (Snapshot History & Auto-Recovery)
168
+
169
+ ⚡ 1-Command Workflow
170
+ • Chat Summaries █░░░░░░░░░ [1/10] (Manual Copy-Paste)
171
+ • Custom Scripts █████░░░░░ [5/10] (Custom Flags Required)
172
+ • ⬢ CONTINUUM ██████████ [10/10] (Smart Auto-Init & Auto-Scan)
173
+ ```
174
+
175
+ <br>
176
+
177
+ <a id="quick-start-guide"></a>
178
+ ## ⚡ Quick Start Guide (1-Command)
179
+
180
+ ### 1. Installation
181
+
182
+ ```bash
183
+ # Clone the repository
184
+ git clone https://github.com/Ashish6298/CONTINUUM.git
185
+ cd CONTINUUM
186
+
187
+ # Install globally in editable mode
188
+ pip install -e .
189
+ ```
190
+
191
+ ### 2. Generate an Instant AI Handoff (The 1-Command Workflow)
192
+
193
+ Run inside any project directory — Continuum automatically scans your codebase, extracts AST symbols, builds the dependency graph, and creates your ready-to-resume AI handoff package:
194
+
195
+ ```bash
196
+ continuum handoff
197
+ ```
198
+
199
+ ### 3. Terminal Output
200
+
201
+ ```text
202
+ █▀▀ █▀█ █▄ █ ▀█▀ █ █▄ █ █ █ █ █ █▀▄▀█
203
+ █▄▄ █▄█ █ ▀█ █ █ █ ▀█ █▄█ █▄█ █ ▀ █
204
+
205
+ AI Work Continuity & Cross-Model Agent Handoff System
206
+ ─────────────────────────────────────────────────────────────────────────────
207
+
208
+ The one-Command Workflow: $ continuum handoff
209
+
210
+ Automatically captures your project state, extracts AST symbols,
211
+ and generates a ready-to-use 'ai_handoff/' package for your next
212
+ AI Agent (Claude, GPT, Gemini, Cursor, Antigravity, etc.)
213
+
214
+ ─────────────────────────────────────────────────────────────────────────────
215
+ v1.0.0 python 3.11.4 mit license
216
+
217
+ ◈ [HANDOFF READY] Generated Omni-Model Continuity Package:
218
+
219
+ Location: D:\myproject\ai_handoff
220
+
221
+ ✦ Universal Handoff → D:\myproject\ai_handoff\handoff.md (Works for ANY model)
222
+
223
+ ✦ Claude Optimized → D:\myproject\ai_handoff\claude_handoff.md
224
+
225
+ ✦ GPT / Codex Plan → D:\myproject\ai_handoff\gpt_handoff.md
226
+
227
+ ✦ Gemini Hierarchy → D:\myproject\ai_handoff\gemini_handoff.md
228
+
229
+ ✦ Machine State → D:\myproject\ai_handoff\project-state.json
230
+
231
+ ➤ [NEXT ACTION] Paste this prompt into your next AI Agent chat:
232
+
233
+ "Read ai_handoff/handoff.md and continue the project."
234
+ ```
235
+
236
+ <br>
237
+
238
+ <a id="three-state-separation-architecture"></a>
239
+ ## 🏛️ Three-State Separation Architecture
240
+
241
+ Continuum enforces strict separation between physical code truth and conversational assertions:
242
+
243
+ ```text
244
+ ┌──────────────────────────────┐ ┌──────────────────────────────┐ ┌──────────────────────────────┐
245
+ │ 01. PHYSICAL PROJECT STATE │ │ 02. CONVERSATIONAL STATE │ │ 03. AGENT EXECUTION STATE │
246
+ ├──────────────────────────────┤ ├──────────────────────────────┤ ├──────────────────────────────┤
247
+ │ • Physical Source Code │ │ • User Intent & Goals │ │ • Active Tactical Task │
248
+ │ • Polyglot AST Symbol Tree │ │ • Architectural Decisions │ │ • In-Flight File Changes │
249
+ │ • Git Working Tree & Diffs │ │ • Agent Assertions & Claims │ │ • Transient Subprocess Logs │
250
+ │ • Test Suite Pass/Fail Logs │ │ • Unresolved Open Questions │ │ • Deterministic Next Action │
251
+ └──────────────┬───────────────┘ └──────────────┬───────────────┘ └──────────────┬───────────────┘
252
+ │ │ │
253
+ ▼ ▼ ▼
254
+ ┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
255
+ │ ⬢ CANONICAL STATE ENGINE (Topological DAG Graph) │
256
+ └──────────────────────────────────────────────────────────────────────────────────────────────────┘
257
+ ```
258
+
259
+ <br>
260
+
261
+ <a id="5-tier-evidence-hierarchy-matrix"></a>
262
+ ## ⚖️ 5-Tier Evidence Hierarchy Matrix
263
+
264
+ When evidence sources conflict, Continuum arbitrates ground truth according to strict mathematical seniority:
265
+
266
+ ```text
267
+ ┌─ [L1] RUNTIME EXECUTION ────────────────────────────────────────────────────────┐
268
+ │ Artifacts: TEST_RUN, BUILD_LOG, RUNTIME_LOG Weight: 100% │
269
+ │ Rule : Absolute ground truth. Real execution exit codes govern status. │
270
+ └─────────────────────────────────────────────────────────────────────────────────┘
271
+ ┌─ [L2] AST SYNTAX & FILES ───────────────────────────────────────────────────────┐
272
+ │ Artifacts: SOURCE_CODE, AST_SYMBOL, MANIFEST Weight: 90% │
273
+ │ Rule : Physical code exports override git commit messages and chat claims. │
274
+ └─────────────────────────────────────────────────────────────────────────────────┘
275
+ ┌─ [L3] VERSION CONTROL DELTAS ───────────────────────────────────────────────────┐
276
+ │ Artifacts: GIT_COMMIT, GIT_DIFF, GIT_STATUS Weight: 75% │
277
+ │ Rule : Historical changes override unverified comments and documentation. │
278
+ └─────────────────────────────────────────────────────────────────────────────────┘
279
+ ┌─ [L4] ARCHITECTURE DOCUMENTATION ───────────────────────────────────────────────┐
280
+ │ Artifacts: DOCUMENTATION, CODE_COMMENT Weight: 50% │
281
+ │ Rule : Informational context. Marked STALE when AST symbols change. │
282
+ └─────────────────────────────────────────────────────────────────────────────────┘
283
+ ┌─ [L5] CONVERSATIONAL AGENT CLAIMS ──────────────────────────────────────────────┐
284
+ │ Artifacts: CONVERSATION_ASSERTION, USER_REQUIREMENT Weight: 25% │
285
+ │ Rule : Unverified hypothesis until proven on disk by Levels 1-3. │
286
+ └─────────────────────────────────────────────────────────────────────────────────┘
287
+ ```
288
+
289
+ <br>
290
+
291
+ <a id="canonical-state-graph-dag"></a>
292
+ ## 🕸️ Canonical State Graph (DAG)
293
+
294
+ Continuum models all milestones, phases, AST symbols, requirements, and test suites as a topologically ordered Directed Acyclic Graph:
295
+
296
+ ```text
297
+ [MILESTONE] Core Architecture ──► [PHASE 0] Canonical Schema
298
+ │
299
+ ┌──────────────────────┴──────────────────────┐
300
+ ▼ ▼
301
+ [SERVICE] StorageManager [SERVICE] AstExtractor
302
+ │ │
303
+ ▼ ▼
304
+ [TEST] test_serialization.py [TEST] test_workspace_extractor.py
305
+ (Status: ✅ PASS) (Status: ✅ PASS)
306
+ ```
307
+
308
+ ```text
309
+ ┌─ GRAPH ENGINE CAPABILITIES ─────────────────────────────────────────────────────────────┐
310
+ │ • Topological Invalidation : Modifying a service automatically marks downstream tests │
311
+ │ and modules as STALE. │
312
+ │ • Cycle Detection & Guard : Circular dependency insertions (A -> B -> A) are blocked │
313
+ │ at graph construction time. │
314
+ │ • Subgraph Extraction : AI context selectors extract minimal task-relevant slices │
315
+ │ to stay within LLM token budgets. │
316
+ └─────────────────────────────────────────────────────────────────────────────────────────┘
317
+ ```
318
+
319
+ <br>
320
+
321
+ <a id="smart-omni-model-handoff-adapters"></a>
322
+ ## 🤖 Smart Omni-Model Handoff Adapters
323
+
324
+ Running `continuum handoff` compiles verified project state into 5 specialized model formats:
325
+
326
+ ```text
327
+ $ continuum handoff
328
+ │
329
+ ├── 🌐 [UNIVERSAL] ──► handoff.md (Works for ANY model out of the box)
330
+ ├── 🟣 [CLAUDE] ──► claude_handoff.md (Strict Anthropic XML tag hierarchy)
331
+ ├── 🟢 [GPT/CODEX] ──► gpt_handoff.md (OpenAI plan-first step checklists)
332
+ ├── 🔵 [GEMINI] ──► gemini_handoff.md (DeepMind hierarchical ontology)
333
+ └── ⚙️ [MACHINE] ──► project-state.json (Machine-parseable Schema 1.0.0 AST)
334
+ ```
335
+
336
+ <br>
337
+
338
+ <a id="complete-cli-reference"></a>
339
+ ## 💻 Complete CLI Command Reference
340
+
341
+ ```bash
342
+ # ── 1. INITIALIZATION & WORKSPACE ───────────────────────────────────────────
343
+ $ continuum init [--path .] # Initialize .continuum storage & Git hooks
344
+ $ continuum scan [--path .] # Full workspace AST extraction & DAG rebuild
345
+
346
+ # ── 2. STATE INSPECTION & GRAPH ─────────────────────────────────────────────
347
+ $ continuum status [--path .] [--json] # Print verified project state & next action
348
+ $ continuum graph [--mermaid] [--stats] # Inspect DAG structure or export Mermaid
349
+
350
+ # ── 3. AI HANDOFF GENERATION ────────────────────────────────────────────────
351
+ $ continuum handoff # Auto-scan & generate Omni-Model handoffs
352
+ $ continuum handoff --model claude # Tailor specifically for Anthropic Claude
353
+ $ continuum handoff --model gpt # Tailor for OpenAI GPT-4o / Codex
354
+ $ continuum handoff --model gemini # Tailor for Google Gemini Pro
355
+
356
+ # ── 4. BACKGROUND OBSERVER DAEMON ───────────────────────────────────────────
357
+ $ continuum daemon start # Start background filesystem observer
358
+ $ continuum daemon status # Check background daemon health & cycles
359
+ $ continuum daemon run-once # Trigger a single incremental scan pass
360
+ $ continuum daemon stop # Gracefully stop the background daemon
361
+ ```
362
+
363
+ <br>
364
+
365
+ <a id="verified-roadmap-all-24-phases"></a>
366
+ ## 🗺️ Architecture Milestones & Verification
367
+
368
+ Project Continuum v1.0.0 is fully certified with **126 / 126 automated tests passing (100%)** across all 24 roadmap phases (Milestones 1 through 8). Detailed engineering reports and verification logs are available in [docs/reports/](docs/reports/).
369
+
370
+ <br>
371
+
372
+ <a id="testing--verification"></a>
373
+ ## 🧪 Testing & Enterprise Security
374
+
375
+ ```bash
376
+ $ py tests/run_all_tests.py # 126/126 Passed (100% Test Coverage across 24 Phases)
377
+ ```
378
+
379
+ ```text
380
+ ┌─ SECURITY & PRIVACY CONTROLS ────────────────────────────────────────────────────────────┐
381
+ │ • Zero Telemetry : 100% offline local processing with no external telemetry. │
382
+ │ • Secret Sanitization : Automatically detects and strips API keys and credentials. │
383
+ │ • Workspace Boundary : Strict path-traversal prevention locking access to workspace. │
384
+ │ • Atomic Swaps : Crash-safe state serialization preventing corrupted files. │
385
+ └──────────────────────────────────────────────────────────────────────────────────────────┘
386
+ ```
387
+
388
+ <br>
389
+
390
+ <a id="contributing"></a>
391
+ ## 🤝 Contributing
392
+
393
+ We welcome contributions from developers and researchers building the future of cross-model AI work continuity and agent handoffs.
394
+
395
+ **1. Clone Repository**
396
+ ```bash
397
+ git clone https://github.com/Ashish6298/CONTINUUM.git
398
+ ```
399
+
400
+ ```bash
401
+ cd CONTINUUM
402
+ ```
403
+
404
+ **2. Create a Feature Branch**
405
+ ```bash
406
+ git checkout -b feature/ast-symbol-extractor
407
+ ```
408
+
409
+ **3. Setup Virtual Environment**
410
+ ```bash
411
+ python -m venv .venv
412
+ ```
413
+
414
+ ```bash
415
+ # On Windows:
416
+ .venv\Scripts\activate
417
+
418
+ # On macOS / Linux:
419
+ source .venv/bin/activate
420
+ ```
421
+
422
+ **4. Install Development Dependencies**
423
+ ```bash
424
+ pip install -e ".[dev]"
425
+ ```
426
+
427
+ **5. Run Automated 24-Phase Test Suite**
428
+ ```bash
429
+ py tests/run_all_tests.py
430
+ ```
431
+
432
+ **6. Verify Architectural Invariants**
433
+ ```text
434
+ ┌─ ARCHITECTURAL INVARIANTS ───────────────────────────────────────────────────────────────┐
435
+ │ • 3-State Separation : Physical workspace state is never mutated by chat claims. │
436
+ │ • Zero Telemetry : 100% offline local processing with no external network calls. │
437
+ │ • Atomic Persistence : All state writes use crash-safe atomic swaps (.tmp -> replace). │
438
+ └───────────────────────────────────────────────────────────────────────────────────────────┘
439
+ ```
440
+
441
+ **7. Commit & Open a Pull Request**
442
+ ```bash
443
+ git commit -m "feat(extractors): add support for rust AST parser"
444
+ ```
445
+
446
+ For complete architectural specifications, commit rules, and PR checklists, read **[CONTRIBUTING.md](CONTRIBUTING.md)**.
447
+
448
+ <br>
449
+
450
+ <a id="code-of-conduct"></a>
451
+ ## 📜 Code of Conduct
452
+
453
+ Project Continuum strictly enforces the **Contributor Covenant v2.1** across all issues, pull requests, and community discussions.
454
+
455
+ ```text
456
+ COMMUNITY GOVERNANCE STANDARDS
457
+ ├── 🌟 CORE PLEDGE ──► Harassment-free experience regardless of background
458
+ ├── 🤝 COLLABORATION ──► Constructive feedback & focus on what is best for the project
459
+ └── ⚖️ ENFORCEMENT LADDER ──► Correction ──► Warning ──► Temporary Ban ──► Permanent Ban
460
+ ```
461
+
462
+ Detailed enforcement guidelines and reporting steps are available in **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)**.
463
+
464
+ <br>
465
+
466
+ <a id="security"></a>
467
+ ## 🛡️ Security & Privacy
468
+
469
+ Continuum is built around verifiable, non-negotiable security invariants:
470
+
471
+ ```text
472
+ STATUS INVARIANT ENFORCEMENT GUARANTEE
473
+ ────────── ─────────────────────── ─────────────────────────────────────────────────────
474
+ [ENFORCED] Zero External Telemetry 100% offline execution; no network calls or telemetry
475
+ [ENFORCED] Secret Sanitization Automatic regex & entropy masking for sensitive keys
476
+ [ENFORCED] Workspace Containment Rejection of symlinks and paths escaping root
477
+ [ENFORCED] Atomic State Swaps Zero partial writes; crash-safe file serialization
478
+ ```
479
+
480
+ Read our complete policy and disclosure process in **[SECURITY.md](SECURITY.md)**.
481
+
482
+ <br>
483
+
484
+ <a id="license"></a>
485
+ ## ⚖️ License
486
+
487
+ Project Continuum is open-source software licensed under the **[MIT License](LICENSE)**.
488
+
489
+ ---
490
+
491
+ <div align="center">
492
+
493
+ ```text
494
+ ┌─ SUPPORT & COMMUNITY ────────────────────────────────────────────────────────────────────┐
495
+ │ ⭐ Star the Repo : Support open-source AI continuity on GitHub │
496
+ │ 🐛 File an Issue : Report bugs, feature requests, or AST extractor ideas │
497
+ │ 💬 Discussions : Share your multi-agent handoff setups & workflows │
498
+ │ ▲ Return to Top : Jump back to system navigation & command reference │
499
+ └──────────────────────────────────────────────────────────────────────────────────────────┘
500
+ ```
501
+
502
+ <p align="center">
503
+ <a href="#top"><b>[ ▲ BACK TO TOP ]</b></a> &nbsp;&nbsp;&nbsp;
504
+ <a href="https://github.com/Ashish6298/CONTINUUM"><b>[ ⭐ STAR REPOSITORY ]</b></a> &nbsp;&nbsp;&nbsp;
505
+ <a href="https://github.com/Ashish6298/CONTINUUM/issues"><b>[ 🐛 REPORT ISSUE ]</b></a>
506
+ </p>
507
+
508
+ <sub>Project Continuum • Open-Source AI Work Continuity & Cross-Model Agent Handoff System</sub>
509
+
510
+ </div>
511
+
@@ -0,0 +1,72 @@
1
+ cli/__init__.py,sha256=qjtnEulxwBs3RmNt8IPC9Ez4uYcdNR778ww9Ubinxms,236
2
+ cli/main.py,sha256=4lTMn6FW5o81i0PeIx8pNU5yEmifNe6bZzok3cOrJkw,16369
3
+ confidence/__init__.py,sha256=MV9K_TEmqqkD5mdJH7AOD0xfJRqDluGS6CR8cNhdlmU,318
4
+ confidence/calculator.py,sha256=k2zhzIGR8I2wA9qvw-shVM7gq-NiP2ElNZNqA5zvCx0,13087
5
+ confidence/models.py,sha256=OaHmKiv_2_O9p-5uNeviMrYOCluTmrQAd9MUjCVz6dI,1557
6
+ context/__init__.py,sha256=-tMI7vcYm6fH2EDDAAJe5KNO4KeI_v0bsiE3bb2qydg,476
7
+ context/models.py,sha256=TaWE07PcAl-bJCJzD2WMEfeiRRjKcr4IDIjgJRBmoCo,4787
8
+ context/pruner.py,sha256=Jq_vzHrTq0PdPjAOfvmYF4kpa8V_jC3MwfnSYn_1Z_c,10015
9
+ context/selector.py,sha256=90XYiS-EuRzHqInVO4MV8_iRFkm4rFSsMtRuMHt_rB4,7826
10
+ continuum_toolkit-1.0.0.dist-info/licenses/LICENSE,sha256=OFU50svHJdxl4ZghxlvP0A-y7lrZU8M366mhf7n-xB0,1103
11
+ contradictions/__init__.py,sha256=oBbQ0aK7MxQfKxKYCYwEiZ2sT3eHpyKLrx39e3ALtsM,447
12
+ contradictions/detector.py,sha256=eX3kafD1QjrnRoMg2561Wz52RX4znekVUxxTgfLTXF8,19602
13
+ contradictions/models.py,sha256=fdwYfxqBsCwlCmgyBM3hkas9vF7fUigW21Td9TsqnyI,3124
14
+ core/__init__.py,sha256=-xCMuF00Vs4ckxATJVjWolUsbElbHzO7wD433NXMnCg,2110
15
+ core/enums.py,sha256=IygSvrClAwEmLyKwGQHU1W_T_ZCgWUr9lFKLs5DvUCE,4318
16
+ core/evidence.py,sha256=TY7If0Boe2n7poOvf5L7OK-Zp5LXk6q_3wuTve2M_MI,4639
17
+ core/interfaces.py,sha256=3AEElj-rNpMB1sS7usLz8G1l3nUHHlfTjgH94QBaUzE,6717
18
+ core/schema.py,sha256=6GH4ArFkKB-4uCIMRPUWOI8MQV97ajvaBlqhV7BOLm8,19454
19
+ core/serializer.py,sha256=8p2t5_y6r76xMuMa-s7h3N0A_0n9bu0fRuUIj97lhDk,3541
20
+ core/state_models.py,sha256=MTbemKBe0vP4T64NqrEZI-dwG2LP8DbPzpV0fnmWV3k,19868
21
+ daemon/__init__.py,sha256=ZOq3WD29HSfVU61y-yRo5EkTgp2HvAL3lixGmYlCtO4,270
22
+ daemon/service.py,sha256=ORB9D_ERyQlEx4jAKBaYECfCmNlpyCVWj7dOtglg2L4,6031
23
+ extractors/__init__.py,sha256=F8rHyAm0FwbCLclAHpfnWRs0DGvuCeVVEDaEfIi7JOg,2077
24
+ extractors/base.py,sha256=3oOhsqJbkvs4fQF2pPLaWsdLlnSxyV9Xlawmp2YSct0,3025
25
+ extractors/config_extractor.py,sha256=_KpFb69vrN-g4MfxLRf_2hl6T85XUe9Kak9x_ccOpVQ,6987
26
+ extractors/conversation_extractor.py,sha256=4rqHCusyebmICOYFJORZRwN9YieAP1Fvc9sCgvoGJVg,7589
27
+ extractors/git_extractor.py,sha256=_s8Vr5iH3EBsGhiPpuO3NP61CG6HoD-5nM6T3-rcBeU,12034
28
+ extractors/verification_extractor.py,sha256=gKav1bNSturNQ4KvrMAVw-ARg8Va1rJeoxHrg0hYMqs,10669
29
+ extractors/workspace_extractor.py,sha256=brrzR4SpUgtjoJ1HvOt2MZuA25JXqkEkpszkcw6g4lU,9038
30
+ extractors/config/parsers.py,sha256=g44RUZkKnYiuJvgO3hArfdEdoYflOwEtOza7-vCwVCo,11526
31
+ extractors/config/secret_sanitizer.py,sha256=zsoXnlndT2CnUFE-SgSjujB1Z61cYBZsRll4FOForAw,3441
32
+ extractors/conversation/analyzers.py,sha256=Du645nUTEMc07h6dOLXpmVpNo4mOS_LSTNmYAHG6VOY,9121
33
+ extractors/conversation/models.py,sha256=DJC68mN__sxlP9KnEE8z0ZG_qI0aa5Zoqtj4nxWU8Yw,5835
34
+ extractors/parsers/base.py,sha256=44zH7xLS7RGhU46QgXLo0tDUPSpCYQQAMCcJ_H3b4LA,2599
35
+ extractors/parsers/comment_parser.py,sha256=hWU_JcYD_Lp1iLw3WWM_VLI-r2BPoAjOaD9oJGesb8Q,1727
36
+ extractors/parsers/js_ts_parser.py,sha256=bgESeE_x-roFsnJ1JUGiEnSEKTiZdyhiEOWe228RTZQ,6354
37
+ extractors/parsers/python_parser.py,sha256=Y0C3QgqObe4emTCf0ifKJ0pumLCKnggTMLprpsgd0KQ,6550
38
+ extractors/verification/runners.py,sha256=2Q58er9WatIqSoESUpHAiyGfv5Dhd92USBhTB8sY7s4,10658
39
+ graph/__init__.py,sha256=YCl1QQpXQr_jnsqqDOiS3NS0yVOcVVQNlkIuM0zWazw,683
40
+ graph/diff.py,sha256=MqdXlj5f90zMUs7HS6JuZcT-AhEiJ1to_fDSQsk54jw,4340
41
+ graph/manager.py,sha256=CxWK18i07Ht-5d2qpE3dQn5ReKJ1DJK9x6__tmVYSW8,19670
42
+ graph/models.py,sha256=nAI8ZHMLK0aJWNFMaErx7XzjOCtVmr_mwAtdNvTZPzg,2187
43
+ graph/propagator.py,sha256=CRNAPiiPRMsHmnmPINwGPFKrlTcq1-VWc-9XwYmw0qQ,8104
44
+ graph/query.py,sha256=QfXvEt_ftq94wzdi_cJA_DI2A8dEyaaWqcA02LMtYk8,3589
45
+ graph/snapshot.py,sha256=gxfVHXcUwzEBX3g1FfFDssH1yo5kPVYk1Jc-amjNepU,3197
46
+ handoff/__init__.py,sha256=TNYWXWjmhUCrC4E17CTJrRVw-5auErjki1y_iygqTpM,732
47
+ handoff/models.py,sha256=mAU-ZxWLW3ORs5YJBmi1wrG0MzsyfqCs520s_l3nw54,3492
48
+ handoff/packager.py,sha256=4pTHWiDEoal94yhywO6xZ12Uj0EqHHFJrKahGKbyoFE,12715
49
+ handoff/adapters/__init__.py,sha256=KWUEimNe9z9ypDeGkHr3xoXwg1GCMu9DD_k6PudGm1U,1435
50
+ handoff/adapters/base.py,sha256=8PBCYzhmDnUxK4grYQqAX4fOr6R8pFp5laTITxtFTsc,3186
51
+ handoff/adapters/claude_adapter.py,sha256=XW7gnvZmLwgZ6sAKB_B78ETay3zn7BzUbYLG_Z5UhxQ,7185
52
+ handoff/adapters/codex_gpt_adapter.py,sha256=hTlLEh1_4OJc5czajSd67rzQyUj061JTRJXCDpPz0bE,5854
53
+ handoff/adapters/gemini_adapter.py,sha256=rk6vEbcj89bNd5IJeG-w8HsqxDk_ZRNPKpRtKSFVhFE,6128
54
+ handoff/adapters/local_model_adapter.py,sha256=vca3TNBMYWpg-2U7woACf34OAg8lxxgmA9gmrIkuCr0,4455
55
+ pipeline/__init__.py,sha256=53eAPqEQGulefIxspMaJpLnnar3CwCgjfWGaalH0DGs,313
56
+ pipeline/orchestrator.py,sha256=_U1avgoyjoJAjDCbcMCSR3R4JBakb3Ep9q_Q17tqJYo,12575
57
+ resolution/__init__.py,sha256=PW8YKo-FkuFfMyFsyBThb92kv_Zbq9yXwmDXbhkORqA,288
58
+ resolution/resolver.py,sha256=X5EaxSQvTMUc6H42p0l-zmJHO_FVdvBZEFoCiiFRp0A,13755
59
+ storage/__init__.py,sha256=JYPje2GL6kP4p-txacXVonQcxrWYFW1cQ1tpQagbj8E,527
60
+ storage/hooks.py,sha256=Obqz4LDiGNCfOwT9LZPDQNODmPNVH5dRp8r_zMobxyM,4948
61
+ storage/manager.py,sha256=Y-pbPo7kFh9ss6M7dv05DmGUc948Kj-mxwehKWLhwic,5327
62
+ storage/models.py,sha256=4B71uFBAZxdEiqq1wDfCS-B8IAbjtD0xJrKK5e_Dz_0,1283
63
+ storage/recovery.py,sha256=GkuRW9_0OX7j0HXbEVxBP_Y9Ybt3yU7mROklHiHytPQ,4134
64
+ watcher/__init__.py,sha256=UaEy6GH94JDkWy5bHzi57uongJYjp6QSNQsZ3oYtQ9g,524
65
+ watcher/detector.py,sha256=ss4SlGnHXDfKdD9lNFZ717xGdMOEfuPqv_9azTl84Us,5319
66
+ watcher/models.py,sha256=N-U7XVM4mXDVuWT0JilKPquAYkVuXgFS4Vp59ISSgns,2340
67
+ watcher/updater.py,sha256=tedt54_QWQcACf47CDdb1607evDN9cuZxNo3zUq9xCY,6871
68
+ continuum_toolkit-1.0.0.dist-info/METADATA,sha256=QrmK42Do7AlFer_P5sLTUlvGVJ8e_k6aE8SvzEPFZHA,28643
69
+ continuum_toolkit-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
70
+ continuum_toolkit-1.0.0.dist-info/entry_points.txt,sha256=8A-_cf9Kz-7BxHGvwr5hOkGSdVpeP6Fe1mt84UtWXvY,44
71
+ continuum_toolkit-1.0.0.dist-info/top_level.txt,sha256=MYE88gA3keGCqC8J9D2yT-lPBdooENoytydiGYAVuQA,111
72
+ continuum_toolkit-1.0.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (84.0.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ continuum = cli.main:main
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Project Continuum Authors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,13 @@
1
+ cli
2
+ confidence
3
+ context
4
+ contradictions
5
+ core
6
+ daemon
7
+ extractors
8
+ graph
9
+ handoff
10
+ pipeline
11
+ resolution
12
+ storage
13
+ watcher
@@ -0,0 +1,19 @@
1
+ """
2
+ Project Continuum - Contradiction Subsystem Package
3
+ ===================================================
4
+ Milestone 3 - Phase 7.
5
+ """
6
+
7
+ from contradictions.models import (
8
+ ContradictionSeverity,
9
+ ContradictionType,
10
+ DiscrepancyLedger,
11
+ )
12
+ from contradictions.detector import ContradictionDetector
13
+
14
+ __all__ = [
15
+ "ContradictionSeverity",
16
+ "ContradictionType",
17
+ "DiscrepancyLedger",
18
+ "ContradictionDetector",
19
+ ]