synthadoc 1.3.2__tar.gz → 1.3.4__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 (1182) hide show
  1. synthadoc-1.3.4/PKG-INFO +1359 -0
  2. synthadoc-1.3.4/README-pypi.md +1295 -0
  3. synthadoc-1.3.4/README.md +1331 -0
  4. synthadoc-1.3.4/VERSION +1 -0
  5. synthadoc-1.3.4/docs/badges.json +11 -0
  6. synthadoc-1.3.4/docs/design.md +4423 -0
  7. synthadoc-1.3.4/docs/png/synthadoc-serve.png +0 -0
  8. synthadoc-1.3.4/docs/user-quick-start-guide.md +4384 -0
  9. synthadoc-1.3.4/obsidian-plugin/manifest.json +9 -0
  10. synthadoc-1.3.4/obsidian-plugin/package-lock.json +2113 -0
  11. synthadoc-1.3.4/obsidian-plugin/package.json +22 -0
  12. synthadoc-1.3.4/scripts/refresh_search_seeds.py +667 -0
  13. synthadoc-1.3.4/scripts/validate_seeds.py +478 -0
  14. synthadoc-1.3.4/synthadoc/agents/action_agent.py +1110 -0
  15. synthadoc-1.3.4/synthadoc/agents/hints.json +231 -0
  16. synthadoc-1.3.4/synthadoc/agents/ingest_agent.py +1420 -0
  17. synthadoc-1.3.4/synthadoc/agents/lint_agent.py +1365 -0
  18. synthadoc-1.3.4/synthadoc/agents/query_agent.py +1737 -0
  19. synthadoc-1.3.4/synthadoc/agents/rewrite_agent.py +52 -0
  20. synthadoc-1.3.4/synthadoc/agents/workflows/_base.py +265 -0
  21. synthadoc-1.3.4/synthadoc/agents/workflows/_loop.py +240 -0
  22. synthadoc-1.3.4/synthadoc/agents/workflows/_tools.py +1160 -0
  23. synthadoc-1.3.4/synthadoc/agents/workflows/broken_citation_resolver.py +409 -0
  24. synthadoc-1.3.4/synthadoc/agents/workflows/broken_wikilinks.py +420 -0
  25. synthadoc-1.3.4/synthadoc/agents/workflows/contradiction_resolver.py +586 -0
  26. synthadoc-1.3.4/synthadoc/agents/workflows/ingest_lint.py +352 -0
  27. synthadoc-1.3.4/synthadoc/agents/workflows/lint_report.py +255 -0
  28. synthadoc-1.3.4/synthadoc/agents/workflows/orphan_resolver.py +763 -0
  29. synthadoc-1.3.4/synthadoc/agents/workflows/scaffold.py +227 -0
  30. synthadoc-1.3.4/synthadoc/agents/workflows/tools/contradiction_resolver_tools.py +275 -0
  31. synthadoc-1.3.4/synthadoc/agents/workflows/tools/orphan_resolver_tools.py +258 -0
  32. synthadoc-1.3.4/synthadoc/cli/_http.py +169 -0
  33. synthadoc-1.3.4/synthadoc/cli/_init.py +463 -0
  34. synthadoc-1.3.4/synthadoc/cli/_utils.py +142 -0
  35. synthadoc-1.3.4/synthadoc/cli/audit.py +517 -0
  36. synthadoc-1.3.4/synthadoc/cli/backup.py +262 -0
  37. synthadoc-1.3.4/synthadoc/cli/cache.py +47 -0
  38. synthadoc-1.3.4/synthadoc/cli/candidates.py +191 -0
  39. synthadoc-1.3.4/synthadoc/cli/context.py +71 -0
  40. synthadoc-1.3.4/synthadoc/cli/demo.py +50 -0
  41. synthadoc-1.3.4/synthadoc/cli/ingest.py +121 -0
  42. synthadoc-1.3.4/synthadoc/cli/install.py +421 -0
  43. synthadoc-1.3.4/synthadoc/cli/lifecycle.py +156 -0
  44. synthadoc-1.3.4/synthadoc/cli/lint.py +264 -0
  45. synthadoc-1.3.4/synthadoc/cli/main.py +147 -0
  46. synthadoc-1.3.4/synthadoc/cli/plugin.py +340 -0
  47. synthadoc-1.3.4/synthadoc/cli/retract.py +322 -0
  48. synthadoc-1.3.4/synthadoc/cli/routing.py +110 -0
  49. synthadoc-1.3.4/synthadoc/cli/scaffold.py +83 -0
  50. synthadoc-1.3.4/synthadoc/cli/schedule.py +210 -0
  51. synthadoc-1.3.4/synthadoc/cli/serve.py +369 -0
  52. synthadoc-1.3.4/synthadoc/cli/status.py +56 -0
  53. synthadoc-1.3.4/synthadoc/cli/templates.py +347 -0
  54. synthadoc-1.3.4/synthadoc/config.py +632 -0
  55. synthadoc-1.3.4/synthadoc/core/export.py +486 -0
  56. synthadoc-1.3.4/synthadoc/core/orchestrator.py +840 -0
  57. synthadoc-1.3.4/synthadoc/core/template_engine.py +156 -0
  58. synthadoc-1.3.4/synthadoc/data/obsidian-plugin/manifest.json +9 -0
  59. synthadoc-1.3.4/synthadoc/data/web-ui/dist/assets/index-DRPWSKbB.js +41 -0
  60. synthadoc-1.3.4/synthadoc/data/web-ui/dist/index.html +14 -0
  61. synthadoc-1.3.4/synthadoc/errors.py +156 -0
  62. synthadoc-1.3.4/synthadoc/integration/http_server.py +2426 -0
  63. synthadoc-1.3.4/synthadoc/providers/coding_tool.py +594 -0
  64. synthadoc-1.3.4/synthadoc/providers/pricing.py +129 -0
  65. synthadoc-1.3.4/synthadoc/skills/web_search/scripts/main.py +138 -0
  66. synthadoc-1.3.4/synthadoc/storage/wiki.py +358 -0
  67. synthadoc-1.3.4/synthadoc/templates/README.md +394 -0
  68. synthadoc-1.3.4/synthadoc/templates/__init__.py +0 -0
  69. synthadoc-1.3.4/synthadoc/templates/business/__init__.py +0 -0
  70. synthadoc-1.3.4/synthadoc/templates/business/hr-people/__init__.py +0 -0
  71. synthadoc-1.3.4/synthadoc/templates/business/hr-people/description.txt +1 -0
  72. synthadoc-1.3.4/synthadoc/templates/business/hr-people/guidelines.md +8 -0
  73. synthadoc-1.3.4/synthadoc/templates/business/hr-people/raw_sources/handbooks/template-employee-handbook-section.md +133 -0
  74. synthadoc-1.3.4/synthadoc/templates/business/hr-people/raw_sources/job-descriptions/template-job-description.md +105 -0
  75. synthadoc-1.3.4/synthadoc/templates/business/hr-people/raw_sources/onboarding/template-onboarding-plan.md +113 -0
  76. synthadoc-1.3.4/synthadoc/templates/business/hr-people/raw_sources/performance/template-performance-review.md +80 -0
  77. synthadoc-1.3.4/synthadoc/templates/business/hr-people/routing.md +16 -0
  78. synthadoc-1.3.4/synthadoc/templates/business/hr-people/seeds.md +101 -0
  79. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/compensation.md +23 -0
  80. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/employee-handbook.md +23 -0
  81. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/hr-policies.md +24 -0
  82. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/index.md +29 -0
  83. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/job-frameworks.md +23 -0
  84. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/org-structure.md +23 -0
  85. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/performance-management.md +23 -0
  86. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/purpose.md +15 -0
  87. synthadoc-1.3.4/synthadoc/templates/business/hr-people/wiki/succession-planning.md +22 -0
  88. synthadoc-1.3.4/synthadoc/templates/business/marketing/__init__.py +0 -0
  89. synthadoc-1.3.4/synthadoc/templates/business/marketing/description.txt +1 -0
  90. synthadoc-1.3.4/synthadoc/templates/business/marketing/guidelines.md +8 -0
  91. synthadoc-1.3.4/synthadoc/templates/business/marketing/raw_sources/brand/template-brand-brief.md +113 -0
  92. synthadoc-1.3.4/synthadoc/templates/business/marketing/raw_sources/campaigns/template-campaign-brief.md +83 -0
  93. synthadoc-1.3.4/synthadoc/templates/business/marketing/raw_sources/content/template-content-calendar.md +80 -0
  94. synthadoc-1.3.4/synthadoc/templates/business/marketing/routing.md +17 -0
  95. synthadoc-1.3.4/synthadoc/templates/business/marketing/seeds.md +90 -0
  96. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/brand-guidelines.md +23 -0
  97. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/campaign-calendar.md +22 -0
  98. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/campaigns.md +23 -0
  99. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/channel-performance.md +23 -0
  100. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/content-assets.md +22 -0
  101. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/content-strategy.md +23 -0
  102. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/index.md +30 -0
  103. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/messaging.md +23 -0
  104. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/purpose.md +15 -0
  105. synthadoc-1.3.4/synthadoc/templates/business/marketing/wiki/seo.md +22 -0
  106. synthadoc-1.3.4/synthadoc/templates/business/product-management/__init__.py +0 -0
  107. synthadoc-1.3.4/synthadoc/templates/business/product-management/description.txt +1 -0
  108. synthadoc-1.3.4/synthadoc/templates/business/product-management/guidelines.md +8 -0
  109. synthadoc-1.3.4/synthadoc/templates/business/product-management/raw_sources/roadmaps/template-roadmap.md +104 -0
  110. synthadoc-1.3.4/synthadoc/templates/business/product-management/raw_sources/specs/template-prd.md +99 -0
  111. synthadoc-1.3.4/synthadoc/templates/business/product-management/raw_sources/user-research/template-user-research-plan.md +141 -0
  112. synthadoc-1.3.4/synthadoc/templates/business/product-management/routing.md +16 -0
  113. synthadoc-1.3.4/synthadoc/templates/business/product-management/seeds.md +93 -0
  114. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/customer-research.md +23 -0
  115. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/feature-specs.md +22 -0
  116. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/index.md +29 -0
  117. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/okrs.md +22 -0
  118. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/prds.md +24 -0
  119. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/product-metrics.md +23 -0
  120. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/purpose.md +15 -0
  121. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/roadmap.md +23 -0
  122. synthadoc-1.3.4/synthadoc/templates/business/product-management/wiki/user-feedback.md +23 -0
  123. synthadoc-1.3.4/synthadoc/templates/business/project-management/__init__.py +0 -0
  124. synthadoc-1.3.4/synthadoc/templates/business/project-management/description.txt +1 -0
  125. synthadoc-1.3.4/synthadoc/templates/business/project-management/guidelines.md +8 -0
  126. synthadoc-1.3.4/synthadoc/templates/business/project-management/raw_sources/charters/template-project-charter.md +129 -0
  127. synthadoc-1.3.4/synthadoc/templates/business/project-management/raw_sources/kickoff/template-project-kickoff.md +135 -0
  128. synthadoc-1.3.4/synthadoc/templates/business/project-management/raw_sources/raid/template-raid-log.md +78 -0
  129. synthadoc-1.3.4/synthadoc/templates/business/project-management/raw_sources/stakeholders/template-stakeholder-analysis.md +68 -0
  130. synthadoc-1.3.4/synthadoc/templates/business/project-management/routing.md +16 -0
  131. synthadoc-1.3.4/synthadoc/templates/business/project-management/seeds.md +95 -0
  132. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/index.md +29 -0
  133. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/project-charters.md +28 -0
  134. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/project-schedules.md +23 -0
  135. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/projects.md +23 -0
  136. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/purpose.md +15 -0
  137. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/raid-log.md +24 -0
  138. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/retrospectives.md +23 -0
  139. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/stakeholder-map.md +23 -0
  140. synthadoc-1.3.4/synthadoc/templates/business/project-management/wiki/status-reports.md +24 -0
  141. synthadoc-1.3.4/synthadoc/templates/education/__init__.py +0 -0
  142. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/__init__.py +0 -0
  143. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/description.txt +1 -0
  144. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/guidelines.md +8 -0
  145. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/raw_sources/assessments/template-learning-assessment.md +100 -0
  146. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/raw_sources/handbooks/template-employee-handbook-section.md +133 -0
  147. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/raw_sources/needs-analysis/template-training-needs-analysis.md +119 -0
  148. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/raw_sources/procedures/template-sop.md +146 -0
  149. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/raw_sources/training/template-training-course.md +74 -0
  150. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/routing.md +16 -0
  151. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/seeds.md +111 -0
  152. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/competency-frameworks.md +21 -0
  153. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/compliance-training.md +22 -0
  154. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/index.md +29 -0
  155. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/job-aids.md +20 -0
  156. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/new-hire-checklist.md +21 -0
  157. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/onboarding-program.md +20 -0
  158. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/purpose.md +15 -0
  159. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/sops.md +21 -0
  160. synthadoc-1.3.4/synthadoc/templates/education/corporate-training/wiki/training-catalog.md +23 -0
  161. synthadoc-1.3.4/synthadoc/templates/education/course-design/__init__.py +0 -0
  162. synthadoc-1.3.4/synthadoc/templates/education/course-design/description.txt +1 -0
  163. synthadoc-1.3.4/synthadoc/templates/education/course-design/guidelines.md +8 -0
  164. synthadoc-1.3.4/synthadoc/templates/education/course-design/raw_sources/assessments/template-assessment-rubric.md +83 -0
  165. synthadoc-1.3.4/synthadoc/templates/education/course-design/raw_sources/curriculum/template-curriculum-map.md +107 -0
  166. synthadoc-1.3.4/synthadoc/templates/education/course-design/raw_sources/modules/template-module-design.md +86 -0
  167. synthadoc-1.3.4/synthadoc/templates/education/course-design/routing.md +17 -0
  168. synthadoc-1.3.4/synthadoc/templates/education/course-design/seeds.md +87 -0
  169. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/assessments.md +21 -0
  170. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/course-evaluations.md +24 -0
  171. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/curriculum-map.md +21 -0
  172. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/facilitation-guides.md +22 -0
  173. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/index.md +30 -0
  174. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/learner-outcomes.md +21 -0
  175. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/learning-materials.md +21 -0
  176. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/modules.md +21 -0
  177. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/purpose.md +15 -0
  178. synthadoc-1.3.4/synthadoc/templates/education/course-design/wiki/technology-tools.md +21 -0
  179. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/__init__.py +0 -0
  180. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/description.txt +1 -0
  181. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/guidelines.md +8 -0
  182. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/raw_sources/books/template-book-notes.md +69 -0
  183. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/raw_sources/courses/template-course-notes.md +110 -0
  184. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/raw_sources/projects/template-learning-project.md +97 -0
  185. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/routing.md +16 -0
  186. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/seeds.md +87 -0
  187. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/book-summaries.md +21 -0
  188. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/books.md +22 -0
  189. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/concepts.md +22 -0
  190. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/courses-taken.md +22 -0
  191. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/index.md +29 -0
  192. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/learning-projects.md +22 -0
  193. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/mental-models.md +28 -0
  194. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/purpose.md +15 -0
  195. synthadoc-1.3.4/synthadoc/templates/education/personal-learning/wiki/thinkers.md +21 -0
  196. synthadoc-1.3.4/synthadoc/templates/finance/__init__.py +0 -0
  197. synthadoc-1.3.4/synthadoc/templates/finance/accounting/__init__.py +0 -0
  198. synthadoc-1.3.4/synthadoc/templates/finance/accounting/description.txt +1 -0
  199. synthadoc-1.3.4/synthadoc/templates/finance/accounting/guidelines.md +8 -0
  200. synthadoc-1.3.4/synthadoc/templates/finance/accounting/raw_sources/close/template-month-end-close.md +88 -0
  201. synthadoc-1.3.4/synthadoc/templates/finance/accounting/raw_sources/journal-entries/template-journal-entry.md +87 -0
  202. synthadoc-1.3.4/synthadoc/templates/finance/accounting/raw_sources/reconciliations/template-account-reconciliation.md +72 -0
  203. synthadoc-1.3.4/synthadoc/templates/finance/accounting/routing.md +15 -0
  204. synthadoc-1.3.4/synthadoc/templates/finance/accounting/seeds.md +87 -0
  205. synthadoc-1.3.4/synthadoc/templates/finance/accounting/wiki/audit-readiness.md +24 -0
  206. synthadoc-1.3.4/synthadoc/templates/finance/accounting/wiki/close-checklist.md +22 -0
  207. synthadoc-1.3.4/synthadoc/templates/finance/accounting/wiki/financial-statements.md +21 -0
  208. synthadoc-1.3.4/synthadoc/templates/finance/accounting/wiki/index.md +28 -0
  209. synthadoc-1.3.4/synthadoc/templates/finance/accounting/wiki/internal-controls.md +22 -0
  210. synthadoc-1.3.4/synthadoc/templates/finance/accounting/wiki/journal-entries.md +23 -0
  211. synthadoc-1.3.4/synthadoc/templates/finance/accounting/wiki/purpose.md +15 -0
  212. synthadoc-1.3.4/synthadoc/templates/finance/accounting/wiki/tax-compliance.md +24 -0
  213. synthadoc-1.3.4/synthadoc/templates/finance/banking/__init__.py +0 -0
  214. synthadoc-1.3.4/synthadoc/templates/finance/banking/description.txt +1 -0
  215. synthadoc-1.3.4/synthadoc/templates/finance/banking/guidelines.md +8 -0
  216. synthadoc-1.3.4/synthadoc/templates/finance/banking/raw_sources/compliance/template-bsa-aml-review.md +94 -0
  217. synthadoc-1.3.4/synthadoc/templates/finance/banking/raw_sources/credit-applications/template-credit-memo.md +138 -0
  218. synthadoc-1.3.4/synthadoc/templates/finance/banking/raw_sources/products/template-product-sheet.md +73 -0
  219. synthadoc-1.3.4/synthadoc/templates/finance/banking/routing.md +15 -0
  220. synthadoc-1.3.4/synthadoc/templates/finance/banking/seeds.md +85 -0
  221. synthadoc-1.3.4/synthadoc/templates/finance/banking/wiki/branch-operations.md +23 -0
  222. synthadoc-1.3.4/synthadoc/templates/finance/banking/wiki/bsa-aml.md +25 -0
  223. synthadoc-1.3.4/synthadoc/templates/finance/banking/wiki/credit-risk.md +23 -0
  224. synthadoc-1.3.4/synthadoc/templates/finance/banking/wiki/deposit-products.md +22 -0
  225. synthadoc-1.3.4/synthadoc/templates/finance/banking/wiki/index.md +26 -0
  226. synthadoc-1.3.4/synthadoc/templates/finance/banking/wiki/lending-products.md +22 -0
  227. synthadoc-1.3.4/synthadoc/templates/finance/banking/wiki/purpose.md +15 -0
  228. synthadoc-1.3.4/synthadoc/templates/finance/banking/wiki/regulatory-compliance.md +23 -0
  229. synthadoc-1.3.4/synthadoc/templates/finance/investment/__init__.py +0 -0
  230. synthadoc-1.3.4/synthadoc/templates/finance/investment/description.txt +1 -0
  231. synthadoc-1.3.4/synthadoc/templates/finance/investment/guidelines.md +8 -0
  232. synthadoc-1.3.4/synthadoc/templates/finance/investment/raw_sources/companies/template-company-profile.md +88 -0
  233. synthadoc-1.3.4/synthadoc/templates/finance/investment/raw_sources/deals/template-deal-memo.md +83 -0
  234. synthadoc-1.3.4/synthadoc/templates/finance/investment/raw_sources/due-diligence/template-due-diligence-checklist.md +127 -0
  235. synthadoc-1.3.4/synthadoc/templates/finance/investment/raw_sources/financial-models/template-financial-model.md +106 -0
  236. synthadoc-1.3.4/synthadoc/templates/finance/investment/routing.md +14 -0
  237. synthadoc-1.3.4/synthadoc/templates/finance/investment/seeds.md +95 -0
  238. synthadoc-1.3.4/synthadoc/templates/finance/investment/wiki/companies.md +24 -0
  239. synthadoc-1.3.4/synthadoc/templates/finance/investment/wiki/deals.md +24 -0
  240. synthadoc-1.3.4/synthadoc/templates/finance/investment/wiki/financial-models.md +24 -0
  241. synthadoc-1.3.4/synthadoc/templates/finance/investment/wiki/index.md +26 -0
  242. synthadoc-1.3.4/synthadoc/templates/finance/investment/wiki/purpose.md +15 -0
  243. synthadoc-1.3.4/synthadoc/templates/finance/investment/wiki/sectors.md +24 -0
  244. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/__init__.py +0 -0
  245. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/description.txt +1 -0
  246. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/guidelines.md +8 -0
  247. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/raw_sources/loan-products/template-loan-product.md +80 -0
  248. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/raw_sources/pipeline/template-loan-application-summary.md +75 -0
  249. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/raw_sources/underwriting/template-underwriting-checklist.md +133 -0
  250. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/routing.md +16 -0
  251. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/seeds.md +87 -0
  252. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/wiki/agency-guidelines.md +22 -0
  253. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/wiki/index.md +26 -0
  254. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/wiki/loan-pipeline.md +22 -0
  255. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/wiki/loan-products.md +22 -0
  256. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/wiki/purpose.md +15 -0
  257. synthadoc-1.3.4/synthadoc/templates/finance/mortgage/wiki/underwriting-guidelines.md +23 -0
  258. synthadoc-1.3.4/synthadoc/templates/healthcare/__init__.py +0 -0
  259. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/__init__.py +0 -0
  260. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/description.txt +1 -0
  261. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/guidelines.md +8 -0
  262. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/raw_sources/care-plans/template-care-plan.md +87 -0
  263. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/raw_sources/cases/template-case-note.md +80 -0
  264. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/raw_sources/protocols/template-clinical-protocol.md +124 -0
  265. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/routing.md +15 -0
  266. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/seeds.md +82 -0
  267. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/wiki/clinical-guidelines.md +21 -0
  268. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/wiki/clinical-procedures.md +22 -0
  269. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/wiki/conditions.md +22 -0
  270. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/wiki/diagnostic-criteria.md +21 -0
  271. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/wiki/index.md +28 -0
  272. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/wiki/medications.md +23 -0
  273. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/wiki/purpose.md +15 -0
  274. synthadoc-1.3.4/synthadoc/templates/healthcare/clinical/wiki/treatment-protocols.md +22 -0
  275. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/__init__.py +0 -0
  276. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/description.txt +1 -0
  277. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/guidelines.md +8 -0
  278. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/raw_sources/clinical-trials/template-clinical-trial-summary.md +95 -0
  279. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/raw_sources/compounds/template-compound-profile.md +73 -0
  280. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/raw_sources/regulatory/template-regulatory-submission.md +92 -0
  281. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/routing.md +16 -0
  282. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/seeds.md +87 -0
  283. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/clinical-trials.md +22 -0
  284. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/cmc.md +21 -0
  285. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/compounds.md +22 -0
  286. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/index.md +29 -0
  287. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/pipeline.md +24 -0
  288. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/protocols.md +23 -0
  289. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/purpose.md +15 -0
  290. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/regulatory-submissions.md +22 -0
  291. synthadoc-1.3.4/synthadoc/templates/healthcare/pharmaceutical/wiki/safety.md +22 -0
  292. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/__init__.py +0 -0
  293. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/description.txt +1 -0
  294. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/guidelines.md +8 -0
  295. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/raw_sources/interventions/template-intervention-design.md +111 -0
  296. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/raw_sources/programs/template-program-profile.md +73 -0
  297. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/raw_sources/surveillance/template-surveillance-protocol.md +114 -0
  298. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/routing.md +15 -0
  299. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/seeds.md +87 -0
  300. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/wiki/disease-burden.md +23 -0
  301. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/wiki/health-equity.md +21 -0
  302. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/wiki/health-programs.md +22 -0
  303. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/wiki/index.md +28 -0
  304. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/wiki/policy-analysis.md +23 -0
  305. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/wiki/public-health-interventions.md +22 -0
  306. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/wiki/purpose.md +15 -0
  307. synthadoc-1.3.4/synthadoc/templates/healthcare/public-health/wiki/surveillance.md +23 -0
  308. synthadoc-1.3.4/synthadoc/templates/legal/__init__.py +0 -0
  309. synthadoc-1.3.4/synthadoc/templates/legal/compliance/__init__.py +0 -0
  310. synthadoc-1.3.4/synthadoc/templates/legal/compliance/description.txt +1 -0
  311. synthadoc-1.3.4/synthadoc/templates/legal/compliance/guidelines.md +8 -0
  312. synthadoc-1.3.4/synthadoc/templates/legal/compliance/raw_sources/controls/template-control-assessment.md +63 -0
  313. synthadoc-1.3.4/synthadoc/templates/legal/compliance/raw_sources/policies/template-policy.md +118 -0
  314. synthadoc-1.3.4/synthadoc/templates/legal/compliance/raw_sources/risk-register/template-risk-register-entry.md +119 -0
  315. synthadoc-1.3.4/synthadoc/templates/legal/compliance/routing.md +16 -0
  316. synthadoc-1.3.4/synthadoc/templates/legal/compliance/seeds.md +87 -0
  317. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/applicable-regulations.md +21 -0
  318. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/audit-findings.md +23 -0
  319. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/compliance-monitoring.md +22 -0
  320. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/controls.md +22 -0
  321. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/index.md +29 -0
  322. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/policies.md +21 -0
  323. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/purpose.md +15 -0
  324. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/regulatory-requirements.md +22 -0
  325. synthadoc-1.3.4/synthadoc/templates/legal/compliance/wiki/risk-register.md +23 -0
  326. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/__init__.py +0 -0
  327. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/description.txt +1 -0
  328. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/guidelines.md +8 -0
  329. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/raw_sources/licensing/template-license-agreement-summary.md +117 -0
  330. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/raw_sources/patents/template-patent-record.md +80 -0
  331. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/raw_sources/trademarks/template-trademark-record.md +111 -0
  332. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/routing.md +15 -0
  333. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/seeds.md +87 -0
  334. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/wiki/freedom-to-operate.md +22 -0
  335. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/wiki/index.md +28 -0
  336. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/wiki/ip-strategy.md +21 -0
  337. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/wiki/licensing-agreements.md +23 -0
  338. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/wiki/patent-portfolio.md +21 -0
  339. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/wiki/patent-prosecution.md +22 -0
  340. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/wiki/purpose.md +15 -0
  341. synthadoc-1.3.4/synthadoc/templates/legal/ip-management/wiki/trademark-portfolio.md +22 -0
  342. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/__init__.py +0 -0
  343. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/description.txt +1 -0
  344. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/guidelines.md +8 -0
  345. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/raw_sources/contracts/template-contract-summary.md +135 -0
  346. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/raw_sources/matters/template-matter.md +85 -0
  347. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/raw_sources/outside-counsel/template-outside-counsel-brief.md +129 -0
  348. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/routing.md +16 -0
  349. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/seeds.md +87 -0
  350. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/case-law.md +22 -0
  351. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/contract-templates.md +21 -0
  352. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/contracts.md +22 -0
  353. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/index.md +29 -0
  354. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/litigation.md +24 -0
  355. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/matters.md +22 -0
  356. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/outside-counsel.md +22 -0
  357. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/purpose.md +15 -0
  358. synthadoc-1.3.4/synthadoc/templates/legal/legal-ops/wiki/regulatory-guidance.md +20 -0
  359. synthadoc-1.3.4/synthadoc/templates/operations/__init__.py +0 -0
  360. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/__init__.py +0 -0
  361. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/description.txt +1 -0
  362. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/guidelines.md +8 -0
  363. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/raw_sources/assets/template-asset-record.md +60 -0
  364. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/raw_sources/vendor-contracts/template-vendor-contract-summary.md +126 -0
  365. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/raw_sources/work-orders/template-work-order.md +126 -0
  366. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/routing.md +16 -0
  367. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/seeds.md +87 -0
  368. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/assets.md +21 -0
  369. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/emergency-procedures.md +22 -0
  370. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/equipment.md +22 -0
  371. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/index.md +29 -0
  372. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/preventive-maintenance.md +23 -0
  373. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/purpose.md +15 -0
  374. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/safety-inspections.md +23 -0
  375. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/vendor-contracts.md +22 -0
  376. synthadoc-1.3.4/synthadoc/templates/operations/facility-management/wiki/work-orders.md +22 -0
  377. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/__init__.py +0 -0
  378. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/description.txt +1 -0
  379. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/guidelines.md +8 -0
  380. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/raw_sources/control-plans/template-control-plan.md +67 -0
  381. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/raw_sources/inspections/template-inspection-checklist.md +86 -0
  382. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/raw_sources/nonconformances/template-ncr.md +71 -0
  383. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/routing.md +17 -0
  384. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/seeds.md +87 -0
  385. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/control-plans.md +22 -0
  386. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/customer-requirements.md +21 -0
  387. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/defect-tracker.md +27 -0
  388. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/gauges.md +21 -0
  389. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/index.md +30 -0
  390. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/inspection-procedures.md +22 -0
  391. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/nonconformances.md +20 -0
  392. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/process-specifications.md +22 -0
  393. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/purpose.md +15 -0
  394. synthadoc-1.3.4/synthadoc/templates/operations/manufacturing-qc/wiki/quality-standards.md +22 -0
  395. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/__init__.py +0 -0
  396. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/description.txt +1 -0
  397. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/guidelines.md +8 -0
  398. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/raw_sources/purchase-orders/template-purchase-order.md +108 -0
  399. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/raw_sources/suppliers/template-supplier-profile.md +73 -0
  400. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/raw_sources/vendor-scorecards/template-vendor-scorecard.md +136 -0
  401. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/routing.md +17 -0
  402. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/seeds.md +87 -0
  403. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/contracts.md +22 -0
  404. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/freight-contracts.md +21 -0
  405. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/index.md +30 -0
  406. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/inventory-management.md +21 -0
  407. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/logistics.md +22 -0
  408. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/materials.md +21 -0
  409. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/procurement-procedures.md +20 -0
  410. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/purpose.md +15 -0
  411. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/suppliers.md +22 -0
  412. synthadoc-1.3.4/synthadoc/templates/operations/supply-chain/wiki/vendor-scorecards.md +22 -0
  413. synthadoc-1.3.4/synthadoc/templates/real-estate/__init__.py +0 -0
  414. synthadoc-1.3.4/synthadoc/templates/real-estate/development/__init__.py +0 -0
  415. synthadoc-1.3.4/synthadoc/templates/real-estate/development/description.txt +1 -0
  416. synthadoc-1.3.4/synthadoc/templates/real-estate/development/guidelines.md +8 -0
  417. synthadoc-1.3.4/synthadoc/templates/real-estate/development/raw_sources/contracts/template-contractor-agreement-summary.md +139 -0
  418. synthadoc-1.3.4/synthadoc/templates/real-estate/development/raw_sources/permits/template-permit-log.md +103 -0
  419. synthadoc-1.3.4/synthadoc/templates/real-estate/development/raw_sources/projects/template-development-project.md +90 -0
  420. synthadoc-1.3.4/synthadoc/templates/real-estate/development/routing.md +17 -0
  421. synthadoc-1.3.4/synthadoc/templates/real-estate/development/seeds.md +90 -0
  422. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/change-orders.md +23 -0
  423. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/contractors.md +23 -0
  424. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/design-documents.md +22 -0
  425. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/index.md +30 -0
  426. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/inspections.md +22 -0
  427. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/permits.md +22 -0
  428. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/project-schedule.md +22 -0
  429. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/purpose.md +15 -0
  430. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/specifications.md +23 -0
  431. synthadoc-1.3.4/synthadoc/templates/real-estate/development/wiki/zoning-analysis.md +24 -0
  432. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/__init__.py +0 -0
  433. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/description.txt +1 -0
  434. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/guidelines.md +8 -0
  435. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/raw_sources/due-diligence/template-due-diligence-checklist.md +119 -0
  436. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/raw_sources/financial-models/template-financial-model.md +121 -0
  437. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/raw_sources/portfolio/template-portfolio-goals.md +72 -0
  438. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/raw_sources/properties/template-property-intake.md +112 -0
  439. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/routing.md +16 -0
  440. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/seeds.md +88 -0
  441. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/deal-memos.md +9 -0
  442. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/debt-financing.md +9 -0
  443. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/financial-models.md +23 -0
  444. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/index.md +29 -0
  445. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/market-analysis.md +29 -0
  446. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/portfolio.md +21 -0
  447. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/properties.md +11 -0
  448. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/purpose.md +15 -0
  449. synthadoc-1.3.4/synthadoc/templates/real-estate/investment/wiki/submarkets.md +17 -0
  450. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/__init__.py +0 -0
  451. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/description.txt +1 -0
  452. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/guidelines.md +8 -0
  453. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/raw_sources/inspections/template-inspection-report.md +152 -0
  454. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/raw_sources/leases/template-lease-abstract.md +95 -0
  455. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/raw_sources/maintenance/template-work-order.md +63 -0
  456. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/routing.md +16 -0
  457. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/seeds.md +90 -0
  458. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/index.md +29 -0
  459. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/leases.md +24 -0
  460. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/operating-expenses.md +22 -0
  461. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/property-compliance.md +24 -0
  462. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/purpose.md +15 -0
  463. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/rent-rolls.md +22 -0
  464. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/tenants.md +23 -0
  465. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/vendors.md +22 -0
  466. synthadoc-1.3.4/synthadoc/templates/real-estate/property-management/wiki/work-orders.md +21 -0
  467. synthadoc-1.3.4/synthadoc/templates/research/__init__.py +0 -0
  468. synthadoc-1.3.4/synthadoc/templates/research/academic/__init__.py +0 -0
  469. synthadoc-1.3.4/synthadoc/templates/research/academic/description.txt +1 -0
  470. synthadoc-1.3.4/synthadoc/templates/research/academic/guidelines.md +8 -0
  471. synthadoc-1.3.4/synthadoc/templates/research/academic/raw_sources/lit-review/template-literature-review-note.md +87 -0
  472. synthadoc-1.3.4/synthadoc/templates/research/academic/raw_sources/papers/template-paper-notes.md +69 -0
  473. synthadoc-1.3.4/synthadoc/templates/research/academic/raw_sources/protocols/template-research-protocol.md +134 -0
  474. synthadoc-1.3.4/synthadoc/templates/research/academic/routing.md +16 -0
  475. synthadoc-1.3.4/synthadoc/templates/research/academic/seeds.md +74 -0
  476. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/datasets.md +23 -0
  477. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/findings.md +23 -0
  478. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/hypotheses.md +23 -0
  479. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/index.md +29 -0
  480. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/literature-review.md +23 -0
  481. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/methodology.md +23 -0
  482. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/papers.md +22 -0
  483. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/purpose.md +15 -0
  484. synthadoc-1.3.4/synthadoc/templates/research/academic/wiki/researchers.md +21 -0
  485. synthadoc-1.3.4/synthadoc/templates/research/market-research/__init__.py +0 -0
  486. synthadoc-1.3.4/synthadoc/templates/research/market-research/description.txt +1 -0
  487. synthadoc-1.3.4/synthadoc/templates/research/market-research/guidelines.md +8 -0
  488. synthadoc-1.3.4/synthadoc/templates/research/market-research/raw_sources/competitors/template-competitor-profile.md +84 -0
  489. synthadoc-1.3.4/synthadoc/templates/research/market-research/raw_sources/reports/template-market-sizing.md +127 -0
  490. synthadoc-1.3.4/synthadoc/templates/research/market-research/raw_sources/surveys/template-survey-design.md +132 -0
  491. synthadoc-1.3.4/synthadoc/templates/research/market-research/routing.md +17 -0
  492. synthadoc-1.3.4/synthadoc/templates/research/market-research/seeds.md +74 -0
  493. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/competitive-landscape.md +28 -0
  494. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/competitor-profiles.md +23 -0
  495. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/consumer-segments.md +24 -0
  496. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/customer-insights.md +22 -0
  497. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/index.md +30 -0
  498. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/market-overview.md +23 -0
  499. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/market-sizing.md +23 -0
  500. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/purpose.md +15 -0
  501. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/research-reports.md +22 -0
  502. synthadoc-1.3.4/synthadoc/templates/research/market-research/wiki/surveys.md +22 -0
  503. synthadoc-1.3.4/synthadoc/templates/research/science-lab/__init__.py +0 -0
  504. synthadoc-1.3.4/synthadoc/templates/research/science-lab/description.txt +1 -0
  505. synthadoc-1.3.4/synthadoc/templates/research/science-lab/guidelines.md +8 -0
  506. synthadoc-1.3.4/synthadoc/templates/research/science-lab/raw_sources/experiments/template-lab-experiment.md +92 -0
  507. synthadoc-1.3.4/synthadoc/templates/research/science-lab/raw_sources/protocols/template-sop.md +145 -0
  508. synthadoc-1.3.4/synthadoc/templates/research/science-lab/raw_sources/reagents/template-reagent-record.md +104 -0
  509. synthadoc-1.3.4/synthadoc/templates/research/science-lab/routing.md +17 -0
  510. synthadoc-1.3.4/synthadoc/templates/research/science-lab/seeds.md +84 -0
  511. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/experiments.md +23 -0
  512. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/findings.md +23 -0
  513. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/index.md +30 -0
  514. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/instruments.md +22 -0
  515. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/protocols.md +24 -0
  516. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/publications.md +22 -0
  517. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/purpose.md +15 -0
  518. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/raw-data.md +23 -0
  519. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/reagents.md +22 -0
  520. synthadoc-1.3.4/synthadoc/templates/research/science-lab/wiki/standard-operating-procedures.md +25 -0
  521. synthadoc-1.3.4/synthadoc/templates/technology/__init__.py +0 -0
  522. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/__init__.py +0 -0
  523. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/description.txt +1 -0
  524. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/guidelines.md +8 -0
  525. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/raw_sources/datasets/template-dataset-card.md +123 -0
  526. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/raw_sources/experiments/template-experiment.md +85 -0
  527. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/raw_sources/models/template-model-card.md +126 -0
  528. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/routing.md +16 -0
  529. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/seeds.md +87 -0
  530. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/benchmarks.md +27 -0
  531. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/datasets.md +23 -0
  532. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/evaluation-methodology.md +22 -0
  533. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/experiments.md +22 -0
  534. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/index.md +29 -0
  535. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/model-registry.md +22 -0
  536. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/models.md +23 -0
  537. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/purpose.md +15 -0
  538. synthadoc-1.3.4/synthadoc/templates/technology/ai-ml/wiki/serving-infrastructure.md +23 -0
  539. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/__init__.py +0 -0
  540. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/description.txt +1 -0
  541. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/guidelines.md +8 -0
  542. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/raw_sources/datasets/template-dataset-spec.md +114 -0
  543. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/raw_sources/pipelines/template-pipeline.md +70 -0
  544. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/raw_sources/quality-checks/template-data-quality-check.md +89 -0
  545. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/routing.md +16 -0
  546. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/seeds.md +87 -0
  547. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/data-governance.md +23 -0
  548. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/data-quality.md +21 -0
  549. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/datasets.md +23 -0
  550. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/index.md +29 -0
  551. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/lineage.md +22 -0
  552. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/orchestration.md +23 -0
  553. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/pipelines.md +22 -0
  554. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/purpose.md +15 -0
  555. synthadoc-1.3.4/synthadoc/templates/technology/data-engineering/wiki/schema-registry.md +22 -0
  556. synthadoc-1.3.4/synthadoc/templates/technology/devops/__init__.py +0 -0
  557. synthadoc-1.3.4/synthadoc/templates/technology/devops/description.txt +1 -0
  558. synthadoc-1.3.4/synthadoc/templates/technology/devops/guidelines.md +8 -0
  559. synthadoc-1.3.4/synthadoc/templates/technology/devops/raw_sources/change-requests/template-change-request.md +134 -0
  560. synthadoc-1.3.4/synthadoc/templates/technology/devops/raw_sources/incidents/template-incident.md +80 -0
  561. synthadoc-1.3.4/synthadoc/templates/technology/devops/raw_sources/post-mortems/template-post-mortem.md +140 -0
  562. synthadoc-1.3.4/synthadoc/templates/technology/devops/raw_sources/runbooks/template-runbook.md +185 -0
  563. synthadoc-1.3.4/synthadoc/templates/technology/devops/routing.md +17 -0
  564. synthadoc-1.3.4/synthadoc/templates/technology/devops/seeds.md +104 -0
  565. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/alerts.md +22 -0
  566. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/cloud-resources.md +22 -0
  567. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/deployments.md +28 -0
  568. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/incidents.md +24 -0
  569. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/index.md +30 -0
  570. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/infrastructure.md +23 -0
  571. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/pipelines.md +22 -0
  572. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/post-mortems.md +25 -0
  573. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/purpose.md +15 -0
  574. synthadoc-1.3.4/synthadoc/templates/technology/devops/wiki/slos.md +24 -0
  575. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/__init__.py +0 -0
  576. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/description.txt +1 -0
  577. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/guidelines.md +8 -0
  578. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/raw_sources/decisions/template-adr.md +71 -0
  579. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/raw_sources/runbooks/template-runbook.md +185 -0
  580. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/raw_sources/specs/template-tech-spec.md +147 -0
  581. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/routing.md +17 -0
  582. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/seeds.md +92 -0
  583. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/adrs.md +22 -0
  584. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/apis.md +22 -0
  585. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/engineering-practices.md +23 -0
  586. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/incident-response.md +22 -0
  587. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/index.md +30 -0
  588. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/purpose.md +15 -0
  589. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/runbooks.md +22 -0
  590. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/services.md +24 -0
  591. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/system-design.md +24 -0
  592. synthadoc-1.3.4/synthadoc/templates/technology/software-dev/wiki/tech-debt.md +23 -0
  593. synthadoc-1.3.4/tests/agents/test_action_agent.py +2414 -0
  594. synthadoc-1.3.4/tests/agents/test_hint_engine_v12.py +197 -0
  595. synthadoc-1.3.4/tests/agents/test_lint_agent.py +1992 -0
  596. synthadoc-1.3.4/tests/agents/workflows/test_broken_wikilinks.py +197 -0
  597. synthadoc-1.3.4/tests/agents/workflows/test_ingest_lint.py +276 -0
  598. synthadoc-1.3.4/tests/agents/workflows/test_loop.py +570 -0
  599. synthadoc-1.3.4/tests/agents/workflows/test_orphan_resolver.py +882 -0
  600. synthadoc-1.3.4/tests/agents/workflows/test_tools.py +1485 -0
  601. synthadoc-1.3.4/tests/cli/test_demo.py +123 -0
  602. synthadoc-1.3.4/tests/cli/test_demo_sync.py +545 -0
  603. synthadoc-1.3.4/tests/cli/test_http_helpers.py +325 -0
  604. synthadoc-1.3.4/tests/cli/test_patch_toml.py +62 -0
  605. synthadoc-1.3.4/tests/integration/test_http_api.py +1361 -0
  606. synthadoc-1.3.4/tests/integration/test_http_server.py +574 -0
  607. synthadoc-1.3.4/tests/integration/test_sse_endpoint.py +217 -0
  608. synthadoc-1.3.4/tests/live/live_cli_test.py +1023 -0
  609. synthadoc-1.3.4/tests/live/live_plugin_test.py +1615 -0
  610. synthadoc-1.3.4/tests/live/live_template_install_test.py +785 -0
  611. synthadoc-1.3.4/tests/live/run_all.py +272 -0
  612. synthadoc-1.3.4/tests/live/test_adversarial_gate_live.py +379 -0
  613. synthadoc-1.3.4/tests/live/test_agentic_ingest_lint_live.py +1253 -0
  614. synthadoc-1.3.4/tests/live/test_broken_wikilinks_live.py +715 -0
  615. synthadoc-1.3.4/tests/live/test_contradiction_resolver_live.py +678 -0
  616. synthadoc-1.3.4/tests/live/test_orphan_resolver_live.py +429 -0
  617. synthadoc-1.3.4/tests/live/test_scaffold_workflow_live.py +385 -0
  618. synthadoc-1.3.4/tests/providers/test_coding_tool_providers.py +765 -0
  619. synthadoc-1.3.4/tests/providers/test_pricing.py +507 -0
  620. synthadoc-1.3.4/tests/providers/test_providers.py +1431 -0
  621. synthadoc-1.3.4/tests/test_config.py +477 -0
  622. synthadoc-1.3.4/tests/test_coverage_boost.py +2328 -0
  623. synthadoc-1.3.4/tests/test_demo_sync.py +107 -0
  624. synthadoc-1.3.4/tests/test_errors.py +17 -0
  625. synthadoc-1.3.4/tests/test_export.py +837 -0
  626. synthadoc-1.3.4/tests/test_http_lifecycle.py +261 -0
  627. synthadoc-1.3.4/tests/test_http_sessions.py +280 -0
  628. synthadoc-1.3.4/tests/test_pre_prompt_orphan.py +237 -0
  629. synthadoc-1.3.4/tests/test_query_agent.py +319 -0
  630. synthadoc-1.3.4/tests/test_template_completeness.py +120 -0
  631. synthadoc-1.3.4/tests/unit/__init__.py +0 -0
  632. synthadoc-1.3.4/tests/unit/cli/__init__.py +0 -0
  633. synthadoc-1.3.4/tests/unit/cli/test_ingest_batch.py +82 -0
  634. synthadoc-1.3.4/tests/unit/cli/test_install_template.py +224 -0
  635. synthadoc-1.3.4/tests/unit/cli/test_templates_list.py +107 -0
  636. synthadoc-1.3.4/tests/unit/cli/test_templates_sync.py +338 -0
  637. synthadoc-1.3.4/tests/unit/core/__init__.py +0 -0
  638. synthadoc-1.3.4/tests/unit/core/test_template_engine.py +307 -0
  639. synthadoc-1.3.4/web-ui/package-lock.json +5657 -0
  640. synthadoc-1.3.4/web-ui/package.json +43 -0
  641. synthadoc-1.3.4/web-ui/src/api.ts +235 -0
  642. synthadoc-1.3.4/web-ui/src/components/ChatWindow.tsx +233 -0
  643. synthadoc-1.3.4/web-ui/src/components/ConfirmCard.test.tsx +161 -0
  644. synthadoc-1.3.4/web-ui/src/components/ConfirmCard.tsx +148 -0
  645. synthadoc-1.3.2/PKG-INFO +0 -1381
  646. synthadoc-1.3.2/README-pypi.md +0 -1317
  647. synthadoc-1.3.2/README.md +0 -1354
  648. synthadoc-1.3.2/VERSION +0 -1
  649. synthadoc-1.3.2/docs/badges.json +0 -11
  650. synthadoc-1.3.2/docs/design.md +0 -4367
  651. synthadoc-1.3.2/docs/png/synthadoc-serve.png +0 -0
  652. synthadoc-1.3.2/docs/user-quick-start-guide.md +0 -4268
  653. synthadoc-1.3.2/obsidian-plugin/manifest.json +0 -9
  654. synthadoc-1.3.2/obsidian-plugin/package-lock.json +0 -2157
  655. synthadoc-1.3.2/obsidian-plugin/package.json +0 -22
  656. synthadoc-1.3.2/synthadoc/agents/action_agent.py +0 -1088
  657. synthadoc-1.3.2/synthadoc/agents/hints.json +0 -228
  658. synthadoc-1.3.2/synthadoc/agents/ingest_agent.py +0 -1410
  659. synthadoc-1.3.2/synthadoc/agents/lint_agent.py +0 -1351
  660. synthadoc-1.3.2/synthadoc/agents/query_agent.py +0 -1569
  661. synthadoc-1.3.2/synthadoc/agents/rewrite_agent.py +0 -50
  662. synthadoc-1.3.2/synthadoc/agents/workflows/_base.py +0 -251
  663. synthadoc-1.3.2/synthadoc/agents/workflows/_loop.py +0 -195
  664. synthadoc-1.3.2/synthadoc/agents/workflows/_tools.py +0 -1119
  665. synthadoc-1.3.2/synthadoc/agents/workflows/broken_citation_resolver.py +0 -391
  666. synthadoc-1.3.2/synthadoc/agents/workflows/broken_wikilinks.py +0 -373
  667. synthadoc-1.3.2/synthadoc/agents/workflows/contradiction_resolver.py +0 -587
  668. synthadoc-1.3.2/synthadoc/agents/workflows/ingest_lint.py +0 -315
  669. synthadoc-1.3.2/synthadoc/agents/workflows/lint_report.py +0 -249
  670. synthadoc-1.3.2/synthadoc/agents/workflows/orphan_resolver.py +0 -640
  671. synthadoc-1.3.2/synthadoc/agents/workflows/scaffold.py +0 -223
  672. synthadoc-1.3.2/synthadoc/agents/workflows/tools/contradiction_resolver_tools.py +0 -165
  673. synthadoc-1.3.2/synthadoc/agents/workflows/tools/orphan_resolver_tools.py +0 -258
  674. synthadoc-1.3.2/synthadoc/cli/_http.py +0 -141
  675. synthadoc-1.3.2/synthadoc/cli/_init.py +0 -458
  676. synthadoc-1.3.2/synthadoc/cli/_utils.py +0 -11
  677. synthadoc-1.3.2/synthadoc/cli/audit.py +0 -514
  678. synthadoc-1.3.2/synthadoc/cli/backup.py +0 -262
  679. synthadoc-1.3.2/synthadoc/cli/cache.py +0 -47
  680. synthadoc-1.3.2/synthadoc/cli/candidates.py +0 -258
  681. synthadoc-1.3.2/synthadoc/cli/context.py +0 -70
  682. synthadoc-1.3.2/synthadoc/cli/demo.py +0 -195
  683. synthadoc-1.3.2/synthadoc/cli/ingest.py +0 -116
  684. synthadoc-1.3.2/synthadoc/cli/install.py +0 -259
  685. synthadoc-1.3.2/synthadoc/cli/lifecycle.py +0 -156
  686. synthadoc-1.3.2/synthadoc/cli/lint.py +0 -264
  687. synthadoc-1.3.2/synthadoc/cli/main.py +0 -146
  688. synthadoc-1.3.2/synthadoc/cli/plugin.py +0 -340
  689. synthadoc-1.3.2/synthadoc/cli/retract.py +0 -318
  690. synthadoc-1.3.2/synthadoc/cli/routing.py +0 -110
  691. synthadoc-1.3.2/synthadoc/cli/scaffold.py +0 -83
  692. synthadoc-1.3.2/synthadoc/cli/schedule.py +0 -207
  693. synthadoc-1.3.2/synthadoc/cli/serve.py +0 -366
  694. synthadoc-1.3.2/synthadoc/cli/status.py +0 -56
  695. synthadoc-1.3.2/synthadoc/config.py +0 -618
  696. synthadoc-1.3.2/synthadoc/core/export.py +0 -480
  697. synthadoc-1.3.2/synthadoc/core/orchestrator.py +0 -815
  698. synthadoc-1.3.2/synthadoc/data/obsidian-plugin/manifest.json +0 -9
  699. synthadoc-1.3.2/synthadoc/data/web-ui/dist/assets/index-1yqIoH9e.js +0 -41
  700. synthadoc-1.3.2/synthadoc/data/web-ui/dist/index.html +0 -14
  701. synthadoc-1.3.2/synthadoc/errors.py +0 -125
  702. synthadoc-1.3.2/synthadoc/integration/http_server.py +0 -2345
  703. synthadoc-1.3.2/synthadoc/providers/coding_tool.py +0 -434
  704. synthadoc-1.3.2/synthadoc/providers/pricing.py +0 -108
  705. synthadoc-1.3.2/synthadoc/skills/web_search/scripts/main.py +0 -136
  706. synthadoc-1.3.2/synthadoc/storage/wiki.py +0 -336
  707. synthadoc-1.3.2/tests/agents/test_action_agent.py +0 -2218
  708. synthadoc-1.3.2/tests/agents/test_hint_engine_v12.py +0 -103
  709. synthadoc-1.3.2/tests/agents/test_lint_agent.py +0 -1920
  710. synthadoc-1.3.2/tests/agents/workflows/test_broken_wikilinks.py +0 -92
  711. synthadoc-1.3.2/tests/agents/workflows/test_ingest_lint.py +0 -153
  712. synthadoc-1.3.2/tests/agents/workflows/test_loop.py +0 -460
  713. synthadoc-1.3.2/tests/agents/workflows/test_orphan_resolver.py +0 -793
  714. synthadoc-1.3.2/tests/agents/workflows/test_tools.py +0 -1376
  715. synthadoc-1.3.2/tests/cli/test_demo.py +0 -123
  716. synthadoc-1.3.2/tests/cli/test_demo_sync.py +0 -545
  717. synthadoc-1.3.2/tests/cli/test_http_helpers.py +0 -228
  718. synthadoc-1.3.2/tests/integration/test_http_api.py +0 -1358
  719. synthadoc-1.3.2/tests/integration/test_http_server.py +0 -536
  720. synthadoc-1.3.2/tests/integration/test_sse_endpoint.py +0 -212
  721. synthadoc-1.3.2/tests/live/live_cli_test.py +0 -1006
  722. synthadoc-1.3.2/tests/live/live_plugin_test.py +0 -1612
  723. synthadoc-1.3.2/tests/live/run_all.py +0 -266
  724. synthadoc-1.3.2/tests/live/test_adversarial_gate_live.py +0 -379
  725. synthadoc-1.3.2/tests/live/test_agentic_ingest_lint_live.py +0 -1236
  726. synthadoc-1.3.2/tests/live/test_broken_wikilinks_live.py +0 -709
  727. synthadoc-1.3.2/tests/live/test_contradiction_resolver_live.py +0 -665
  728. synthadoc-1.3.2/tests/live/test_orphan_resolver_live.py +0 -333
  729. synthadoc-1.3.2/tests/live/test_scaffold_workflow_live.py +0 -385
  730. synthadoc-1.3.2/tests/providers/test_coding_tool_providers.py +0 -437
  731. synthadoc-1.3.2/tests/providers/test_pricing.py +0 -379
  732. synthadoc-1.3.2/tests/providers/test_providers.py +0 -1431
  733. synthadoc-1.3.2/tests/test_config.py +0 -451
  734. synthadoc-1.3.2/tests/test_coverage_boost.py +0 -2306
  735. synthadoc-1.3.2/tests/test_demo_sync.py +0 -107
  736. synthadoc-1.3.2/tests/test_errors.py +0 -7
  737. synthadoc-1.3.2/tests/test_export.py +0 -808
  738. synthadoc-1.3.2/tests/test_http_lifecycle.py +0 -162
  739. synthadoc-1.3.2/tests/test_http_sessions.py +0 -278
  740. synthadoc-1.3.2/tests/test_query_agent.py +0 -235
  741. synthadoc-1.3.2/web-ui/package-lock.json +0 -5657
  742. synthadoc-1.3.2/web-ui/package.json +0 -43
  743. synthadoc-1.3.2/web-ui/src/api.ts +0 -233
  744. synthadoc-1.3.2/web-ui/src/components/ChatWindow.tsx +0 -232
  745. synthadoc-1.3.2/web-ui/src/components/ConfirmCard.test.tsx +0 -118
  746. synthadoc-1.3.2/web-ui/src/components/ConfirmCard.tsx +0 -126
  747. {synthadoc-1.3.2 → synthadoc-1.3.4}/.gitattributes +0 -0
  748. {synthadoc-1.3.2 → synthadoc-1.3.4}/.github/workflows/ci.yml +0 -0
  749. {synthadoc-1.3.2 → synthadoc-1.3.4}/.github/workflows/publish.yml +0 -0
  750. {synthadoc-1.3.2 → synthadoc-1.3.4}/.gitignore +0 -0
  751. {synthadoc-1.3.2 → synthadoc-1.3.4}/CODE_OF_CONDUCT.md +0 -0
  752. {synthadoc-1.3.2 → synthadoc-1.3.4}/CONTRIBUTING.md +0 -0
  753. {synthadoc-1.3.2 → synthadoc-1.3.4}/LICENSE +0 -0
  754. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/README.md +0 -0
  755. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/evaluation/report/llm-query-benchmark.md +0 -0
  756. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/evaluation/scripts/eval_queries.py +0 -0
  757. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/png/benchmark-lines.png +0 -0
  758. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/png/benchmark-scatter.png +0 -0
  759. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/png/page-level-citation.png +0 -0
  760. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/png/query-cn1.png +0 -0
  761. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/png/query-en1.png +0 -0
  762. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/raw_sources/01_aquaflow_company_profile.md +0 -0
  763. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/raw_sources/02_water_infrastructure_market.md +0 -0
  764. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/raw_sources/03_lbo_model_mechanics.md +0 -0
  765. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/raw_sources/04_covenant_analysis_framework.md +0 -0
  766. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/raw_sources/05_quality_of_earnings_guide.md +0 -0
  767. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/raw_sources/06_esg_due_diligence_standards.md +0 -0
  768. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/raw_sources/07_legal_due_diligence_process.md +0 -0
  769. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/example/aquaflow/raw_sources/08_exit_valuation_benchmarks.md +0 -0
  770. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/media/README.md +0 -0
  771. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/media/medium.md +0 -0
  772. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/media/youtube.md +0 -0
  773. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/architecture.png +0 -0
  774. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/audit-citation.png +0 -0
  775. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/audit-queries.png +0 -0
  776. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/cache-perf/cache-read-latency.png +0 -0
  777. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/cache-perf/cache-vs-nocache-qps.png +0 -0
  778. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/cache-perf/concurrent-readers.png +0 -0
  779. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/cache-perf/hit-vs-miss-latency.png +0 -0
  780. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/claim-level-citation.png +0 -0
  781. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/cli-gap-detection.png +0 -0
  782. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/contradiction-resolver.png +0 -0
  783. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/job-list-terminal.png +0 -0
  784. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/lint-report-adversarial.png +0 -0
  785. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/page-provenance-line-range.png +0 -0
  786. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-audit-cost.png +0 -0
  787. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-audit-events.png +0 -0
  788. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-audit-history.png +0 -0
  789. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-batch-ingest-raw-sources.png +0 -0
  790. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-candidates.png +0 -0
  791. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-citation-faithfulness.png +0 -0
  792. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-export-kg.png +0 -0
  793. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-export-wiki.png +0 -0
  794. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-graph-after.png +0 -0
  795. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-graph-view.png +0 -0
  796. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-jobs-list.png +0 -0
  797. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-jobs-modal.png +0 -0
  798. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-knowledge-graph-with-broken-links.png +0 -0
  799. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-knowledge-graph.png +0 -0
  800. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-lifecycle-audit.png +0 -0
  801. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-lifecycle-mgmt.png +0 -0
  802. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-lifecycle-snapshot-diff.png +0 -0
  803. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-lifecycle-snapshots.png +0 -0
  804. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-lint-run.png +0 -0
  805. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-obsidian-kg.png +0 -0
  806. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-query-agent-web-UI.png +0 -0
  807. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-query-result.png +0 -0
  808. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-ribbon-icon.png +0 -0
  809. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-routing-init.png +0 -0
  810. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-routing.png +0 -0
  811. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-search-live-view.png +0 -0
  812. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-switch-provider.png +0 -0
  813. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-vault-demo.png +0 -0
  814. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-wiki-conflict.png +0 -0
  815. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/synthadoc-wiki-graph.png +0 -0
  816. {synthadoc-1.3.2 → synthadoc-1.3.4}/docs/png/ui-gap-detection.png +0 -0
  817. {synthadoc-1.3.2 → synthadoc-1.3.4}/hooks/README.md +0 -0
  818. {synthadoc-1.3.2 → synthadoc-1.3.4}/hooks/git-auto-commit.py +0 -0
  819. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/__mocks__/obsidian.ts +0 -0
  820. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/esbuild.config.mjs +0 -0
  821. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/src/api.integration.test.ts +0 -0
  822. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/src/api.test.ts +0 -0
  823. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/src/api.ts +0 -0
  824. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/src/graph-modal.test.ts +0 -0
  825. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/src/graph-modal.ts +0 -0
  826. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/src/main.test.ts +0 -0
  827. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/src/main.ts +0 -0
  828. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/src/sse.ts +0 -0
  829. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/tsconfig.json +0 -0
  830. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/vitest.config.ts +0 -0
  831. {synthadoc-1.3.2 → synthadoc-1.3.4}/obsidian-plugin/vitest.integration.config.ts +0 -0
  832. {synthadoc-1.3.2 → synthadoc-1.3.4}/pyproject.toml +0 -0
  833. {synthadoc-1.3.2 → synthadoc-1.3.4}/scripts/bump_version.py +0 -0
  834. {synthadoc-1.3.2 → synthadoc-1.3.4}/scripts/prepare_pypi_readme.py +0 -0
  835. {synthadoc-1.3.2 → synthadoc-1.3.4}/scripts/sync_plugin.py +0 -0
  836. {synthadoc-1.3.2 → synthadoc-1.3.4}/scripts/sync_web_ui.py +0 -0
  837. {synthadoc-1.3.2 → synthadoc-1.3.4}/scripts/update_badges.py +0 -0
  838. {synthadoc-1.3.2 → synthadoc-1.3.4}/skills-lock.json +0 -0
  839. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/__init__.py +0 -0
  840. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/__main__.py +0 -0
  841. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/__init__.py +0 -0
  842. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/_base.py +0 -0
  843. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/_routing.py +0 -0
  844. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/_utils.py +0 -0
  845. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/citation_faithfulness_agent.py +0 -0
  846. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/citations.py +0 -0
  847. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/context_agent.py +0 -0
  848. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/faithfulness_cache.py +0 -0
  849. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/hint_engine.py +0 -0
  850. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/scaffold_agent.py +0 -0
  851. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/search_decompose_agent.py +0 -0
  852. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/skill_agent.py +0 -0
  853. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/summarize_agent.py +0 -0
  854. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/workflows/__init__.py +0 -0
  855. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/workflows/_registry.py +0 -0
  856. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/workflows/tools/__init__.py +0 -0
  857. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/agents/workflows/tools/broken_citation_resolver_tools.py +0 -0
  858. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/__init__.py +0 -0
  859. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/_port.py +0 -0
  860. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/_wiki.py +0 -0
  861. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/export.py +0 -0
  862. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/jobs.py +0 -0
  863. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/logo.py +0 -0
  864. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/query.py +0 -0
  865. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/run.py +0 -0
  866. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/web.py +0 -0
  867. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/cli/workflow.py +0 -0
  868. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/__init__.py +0 -0
  869. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/backup_engine.py +0 -0
  870. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/cache.py +0 -0
  871. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/context_budget.py +0 -0
  872. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/cost_guard.py +0 -0
  873. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/hooks.py +0 -0
  874. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/logging_config.py +0 -0
  875. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/queue.py +0 -0
  876. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/retract.py +0 -0
  877. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/routing.py +0 -0
  878. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/sanitizer.py +0 -0
  879. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/core/scheduler.py +0 -0
  880. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/data/obsidian-plugin/main.js +0 -0
  881. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/data/web-ui/dist/assets/hero-bg-Dl_stsKe.png +0 -0
  882. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/data/web-ui/dist/assets/index-C4o_PeNx.css +0 -0
  883. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/data/web-ui/dist/assets/sidebar-bg-D7cOayr3.png +0 -0
  884. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/data/web-ui/dist/favicon.svg +0 -0
  885. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/data/web-ui/dist/icons.svg +0 -0
  886. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/__init__.py +0 -0
  887. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/AGENTS.md +0 -0
  888. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/CLAUDE.md +0 -0
  889. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/GEMINI.md +0 -0
  890. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/README.md +0 -0
  891. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/ROUTING.md +0 -0
  892. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/_generate_raw_sources.py +0 -0
  893. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/ai-fundamentals-overview.md +0 -0
  894. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/deep-learning-concepts.pptx +0 -0
  895. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/llm-benchmarks-q1-2026.pdf +0 -0
  896. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/model-capabilities-comparison.xlsx +0 -0
  897. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/neural-network-architecture.png +0 -0
  898. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/andrej-karpathy-biography.txt +0 -0
  899. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/attention-mechanisms.txt +0 -0
  900. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/geoffrey-hinton-biography.txt +0 -0
  901. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/large-language-models.txt +0 -0
  902. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/llm-benchmarks-overview.txt +0 -0
  903. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/reinforcement-learning-from-human-feedback.txt +0 -0
  904. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/scaling-laws.txt +0 -0
  905. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/training-techniques.txt +0 -0
  906. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/raw_sources/public-domain/transformer-architecture.txt +0 -0
  907. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/sources.txt +0 -0
  908. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/andrej-karpathy.md +0 -0
  909. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/attention-mechanisms.md +0 -0
  910. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/dashboard.md +0 -0
  911. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/early-neural-networks.md +0 -0
  912. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/geoffrey-hinton.md +0 -0
  913. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/index.md +0 -0
  914. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/large-language-models.md +0 -0
  915. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/llm-benchmarks.md +0 -0
  916. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/purpose.md +0 -0
  917. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/reinforcement-learning-from-human-feedback.md +0 -0
  918. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/scaling-laws.md +0 -0
  919. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/training-techniques.md +0 -0
  920. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/ai-research/wiki/transformer-architecture.md +0 -0
  921. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/.obsidian/app.json +0 -0
  922. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/AGENTS.md +0 -0
  923. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/CLAUDE.md +0 -0
  924. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/GEMINI.md +0 -0
  925. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/README.md +0 -0
  926. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/config.toml +0 -0
  927. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/computing-pioneers-timeline.xlsx +0 -0
  928. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/cs-milestones-overview.pptx +0 -0
  929. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/first-compiler-controversy.pdf +0 -0
  930. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/konrad-zuse-z3-computer.md +0 -0
  931. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/ceruzzi-history-modern-computing.txt +0 -0
  932. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/hopper-biography-usn.txt +0 -0
  933. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/leiner-brief-history-internet-2009.txt +0 -0
  934. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/mccorduck-machines-who-think.txt +0 -0
  935. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/raymond-cathedral-bazaar-1999.txt +0 -0
  936. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/riordan-hoddeson-crystal-fire.txt +0 -0
  937. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/ritchie-unix-history-1979.txt +0 -0
  938. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/turing-wikipedia-cc0.txt +0 -0
  939. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/vonneumann-firstdraft-1945.txt +0 -0
  940. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/public-domain/wexelblat-history-of-programming-languages-1981.txt +0 -0
  941. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/quantum-computing-primer.png +0 -0
  942. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/raw_sources/turing-enigma-decryption.pdf +0 -0
  943. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/sources.txt +0 -0
  944. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/alan-turing.md +0 -0
  945. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/artificial-intelligence-history.md +0 -0
  946. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/dashboard.md +0 -0
  947. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/grace-hopper.md +0 -0
  948. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/index.md +0 -0
  949. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/internet-origins.md +0 -0
  950. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/mechanical-computing.md +0 -0
  951. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/open-source-movement.md +0 -0
  952. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/personal-computer-revolution.md +0 -0
  953. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/programming-languages-overview.md +0 -0
  954. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/purpose.md +0 -0
  955. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/transistor-and-microchip.md +0 -0
  956. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/unix-history.md +0 -0
  957. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/demos/history-of-computing/wiki/von-neumann-architecture.md +0 -0
  958. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/integration/__init__.py +0 -0
  959. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/integration/mcp_server.py +0 -0
  960. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/knowledge/synthadoc-export-guide.md +0 -0
  961. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/knowledge/synthadoc-ingest-guide.md +0 -0
  962. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/knowledge/synthadoc-jobs-guide.md +0 -0
  963. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/knowledge/synthadoc-lifecycle.md +0 -0
  964. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/knowledge/synthadoc-lint-guide.md +0 -0
  965. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/knowledge/synthadoc-overview.md +0 -0
  966. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/knowledge/synthadoc-schedule-guide.md +0 -0
  967. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/observability/__init__.py +0 -0
  968. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/observability/telemetry.py +0 -0
  969. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/providers/__init__.py +0 -0
  970. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/providers/anthropic.py +0 -0
  971. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/providers/base.py +0 -0
  972. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/providers/ollama.py +0 -0
  973. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/providers/openai.py +0 -0
  974. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/py.typed +0 -0
  975. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/__init__.py +0 -0
  976. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/base.py +0 -0
  977. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/docx/SKILL.md +0 -0
  978. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/docx/requirements.txt +0 -0
  979. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/docx/scripts/__init__.py +0 -0
  980. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/docx/scripts/main.py +0 -0
  981. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/image/SKILL.md +0 -0
  982. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/image/scripts/__init__.py +0 -0
  983. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/image/scripts/main.py +0 -0
  984. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/markdown/SKILL.md +0 -0
  985. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/markdown/scripts/__init__.py +0 -0
  986. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/markdown/scripts/main.py +0 -0
  987. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pdf/SKILL.md +0 -0
  988. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pdf/references/cjk-notes.md +0 -0
  989. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pdf/requirements.txt +0 -0
  990. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pdf/scripts/__init__.py +0 -0
  991. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pdf/scripts/main.py +0 -0
  992. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pptx/SKILL.md +0 -0
  993. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pptx/requirements.txt +0 -0
  994. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pptx/scripts/__init__.py +0 -0
  995. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/pptx/scripts/main.py +0 -0
  996. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/registry.py +0 -0
  997. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/session/SKILL.md +0 -0
  998. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/session/__init__.py +0 -0
  999. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/session/scripts/__init__.py +0 -0
  1000. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/session/scripts/main.py +0 -0
  1001. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/url/SKILL.md +0 -0
  1002. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/url/requirements.txt +0 -0
  1003. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/url/scripts/__init__.py +0 -0
  1004. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/url/scripts/main.py +0 -0
  1005. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/web_search/SKILL.md +0 -0
  1006. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/web_search/assets/search-providers.json +0 -0
  1007. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/web_search/requirements.txt +0 -0
  1008. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/web_search/scripts/__init__.py +0 -0
  1009. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/web_search/scripts/fetcher.py +0 -0
  1010. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/xlsx/SKILL.md +0 -0
  1011. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/xlsx/requirements.txt +0 -0
  1012. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/xlsx/scripts/__init__.py +0 -0
  1013. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/xlsx/scripts/main.py +0 -0
  1014. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/youtube/SKILL.md +0 -0
  1015. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/youtube/requirements.txt +0 -0
  1016. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/youtube/scripts/__init__.py +0 -0
  1017. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/skills/youtube/scripts/main.py +0 -0
  1018. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/storage/__init__.py +0 -0
  1019. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/storage/log.py +0 -0
  1020. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/storage/search.py +0 -0
  1021. {synthadoc-1.3.2 → synthadoc-1.3.4}/synthadoc/utils.py +0 -0
  1022. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/__init__.py +0 -0
  1023. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/__init__.py +0 -0
  1024. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_agent_utils.py +0 -0
  1025. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_broken_citation_resolver.py +0 -0
  1026. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_context_agent.py +0 -0
  1027. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_hint_engine.py +0 -0
  1028. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_ingest_agent.py +0 -0
  1029. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_ingest_web_search_decomposition.py +0 -0
  1030. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_lint_report_feature.py +0 -0
  1031. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_query_agent.py +0 -0
  1032. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_query_stream.py +0 -0
  1033. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_rewrite_agent.py +0 -0
  1034. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_routing.py +0 -0
  1035. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_scaffold_agent.py +0 -0
  1036. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_search_decompose_agent.py +0 -0
  1037. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/test_summarize_agent.py +0 -0
  1038. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/workflows/__init__.py +0 -0
  1039. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/workflows/test_broken_citation_resolver.py +0 -0
  1040. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/agents/workflows/test_registry.py +0 -0
  1041. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/__init__.py +0 -0
  1042. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_audit_cli.py +0 -0
  1043. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_backup_cli.py +0 -0
  1044. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_candidates_cli.py +0 -0
  1045. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_cli.py +0 -0
  1046. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_cli_commands.py +0 -0
  1047. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_context_cli.py +0 -0
  1048. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_export_cli.py +0 -0
  1049. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_init.py +0 -0
  1050. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_install_port.py +0 -0
  1051. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_jobs_cli.py +0 -0
  1052. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_lint_cli.py +0 -0
  1053. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_logo.py +0 -0
  1054. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_plugin.py +0 -0
  1055. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_plugin_cli.py +0 -0
  1056. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_query_cli.py +0 -0
  1057. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_retract_cli.py +0 -0
  1058. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_routing_cli.py +0 -0
  1059. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_scaffold_cli.py +0 -0
  1060. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_schedule_cli.py +0 -0
  1061. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_serve.py +0 -0
  1062. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_web_cli.py +0 -0
  1063. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_wiki_resolution.py +0 -0
  1064. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/cli/test_workflow_cli.py +0 -0
  1065. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/conftest.py +0 -0
  1066. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/__init__.py +0 -0
  1067. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_backup_engine.py +0 -0
  1068. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_cache.py +0 -0
  1069. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_candidates.py +0 -0
  1070. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_cost_guard.py +0 -0
  1071. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_hooks.py +0 -0
  1072. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_logging_config.py +0 -0
  1073. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_orchestrator.py +0 -0
  1074. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_orchestrator_cost.py +0 -0
  1075. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_queue.py +0 -0
  1076. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_retract.py +0 -0
  1077. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_routing.py +0 -0
  1078. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/core/test_scheduler.py +0 -0
  1079. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/integration/__init__.py +0 -0
  1080. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/integration/okf_consumer_agent.py +0 -0
  1081. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/integration/test_broken_citation_integration.py +0 -0
  1082. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/integration/test_ingest_confirm_endpoints.py +0 -0
  1083. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/integration/test_lifecycle_snapshots.py +0 -0
  1084. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/integration/test_mcp_server.py +0 -0
  1085. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/integration/test_retract_server.py +0 -0
  1086. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/integration/test_routing_endpoints.py +0 -0
  1087. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/README.md +0 -0
  1088. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/__init__.py +0 -0
  1089. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/live_helpers.py +0 -0
  1090. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/live_mcp_test.py +0 -0
  1091. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/live_retract_test.py +0 -0
  1092. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/test_broken_citation_resolver_live.py +0 -0
  1093. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/test_citation_faithfulness_live.py +0 -0
  1094. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/test_lifecycle_snapshots_live.py +0 -0
  1095. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/live/test_lint_report_workflow_live.py +0 -0
  1096. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/performance/__init__.py +0 -0
  1097. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/performance/conftest.py +0 -0
  1098. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/performance/test_citation_perf.py +0 -0
  1099. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/performance/test_performance.py +0 -0
  1100. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/performance/test_query_cache_perf.py +0 -0
  1101. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/performance/test_routing_benchmark.py +0 -0
  1102. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/providers/__init__.py +0 -0
  1103. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/providers/test_coding_tool_integration.py +0 -0
  1104. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/providers/test_streaming.py +0 -0
  1105. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/security/__init__.py +0 -0
  1106. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/security/test_security.py +0 -0
  1107. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/__init__.py +0 -0
  1108. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_image_skill.py +0 -0
  1109. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_pdf_skill.py +0 -0
  1110. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_registry.py +0 -0
  1111. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_session_skill.py +0 -0
  1112. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_skill_agent.py +0 -0
  1113. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_skill_isolation.py +0 -0
  1114. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_skills.py +0 -0
  1115. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_web_search.py +0 -0
  1116. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/skills/test_youtube_skill.py +0 -0
  1117. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/storage/__init__.py +0 -0
  1118. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/storage/test_audit.py +0 -0
  1119. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/storage/test_db_schema_version.py +0 -0
  1120. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/storage/test_log.py +0 -0
  1121. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/storage/test_search.py +0 -0
  1122. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/storage/test_wiki.py +0 -0
  1123. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_audit_db.py +0 -0
  1124. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_audit_lifecycle.py +0 -0
  1125. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_base_agent.py +0 -0
  1126. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_citation_faithfulness_agent.py +0 -0
  1127. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_cli_run.py +0 -0
  1128. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_context_budget.py +0 -0
  1129. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_contradiction_resolver_tools.py +0 -0
  1130. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_contradiction_resolver_workflow.py +0 -0
  1131. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_faithfulness_cache.py +0 -0
  1132. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_http_export.py +0 -0
  1133. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_ingest_agent.py +0 -0
  1134. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_ingest_lifecycle.py +0 -0
  1135. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_lifecycle_cli.py +0 -0
  1136. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_lint_agent.py +0 -0
  1137. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_lint_agent_scoped.py +0 -0
  1138. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_lint_lifecycle.py +0 -0
  1139. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_lint_lifecycle_url.py +0 -0
  1140. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_pre_prompt_contradicted.py +0 -0
  1141. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_sanitizer.py +0 -0
  1142. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_schedule.py +0 -0
  1143. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_source_ref.py +0 -0
  1144. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_telemetry.py +0 -0
  1145. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_utils.py +0 -0
  1146. {synthadoc-1.3.2 → synthadoc-1.3.4}/tests/test_workflow_tools_ext.py +0 -0
  1147. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/.gitignore +0 -0
  1148. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/README.md +0 -0
  1149. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/eslint.config.js +0 -0
  1150. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/index.html +0 -0
  1151. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/public/favicon.svg +0 -0
  1152. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/public/icons.svg +0 -0
  1153. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/App.css +0 -0
  1154. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/App.tsx +0 -0
  1155. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/assets/hero-bg.png +0 -0
  1156. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/assets/hero.png +0 -0
  1157. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/assets/react.svg +0 -0
  1158. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/assets/sidebar-bg.png +0 -0
  1159. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/assets/vite.svg +0 -0
  1160. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/GraphSidebar.tsx +0 -0
  1161. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/GraphView.tsx +0 -0
  1162. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/Hero.tsx +0 -0
  1163. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/HintChips.tsx +0 -0
  1164. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/MessageBubble.test.ts +0 -0
  1165. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/MessageBubble.tsx +0 -0
  1166. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/PendingPrompt.test.tsx +0 -0
  1167. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/SettingsPopover.tsx +0 -0
  1168. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/Sidebar.tsx +0 -0
  1169. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/ToolProgressBlock.test.tsx +0 -0
  1170. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/components/ToolProgressBlock.tsx +0 -0
  1171. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/index.css +0 -0
  1172. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/jobStatus.ts +0 -0
  1173. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/main.tsx +0 -0
  1174. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/useQueryHistory.ts +0 -0
  1175. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/useQueryStream.ts +0 -0
  1176. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/useSession.ts +0 -0
  1177. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/src/useSessions.ts +0 -0
  1178. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/tsconfig.app.json +0 -0
  1179. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/tsconfig.json +0 -0
  1180. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/tsconfig.node.json +0 -0
  1181. {synthadoc-1.3.2 → synthadoc-1.3.4}/web-ui/vite.config.ts +0 -0
  1182. {synthadoc-1.3.2 → synthadoc-1.3.4}/wiki/log.md +0 -0
@@ -0,0 +1,1359 @@
1
+ Metadata-Version: 2.5
2
+ Name: synthadoc
3
+ Version: 1.3.4
4
+ Summary: Domain-agnostic LLM knowledge compilation engine
5
+ Project-URL: Homepage, https://github.com/axoviq-ai/synthadoc
6
+ Project-URL: Repository, https://github.com/axoviq-ai/synthadoc
7
+ Project-URL: Bug Tracker, https://github.com/axoviq-ai/synthadoc/issues
8
+ Project-URL: Changelog, https://github.com/axoviq-ai/synthadoc/releases
9
+ License-Expression: AGPL-3.0-or-later
10
+ License-File: LICENSE
11
+ Keywords: LLM,RAG,agentic AI,knowledge base,knowledge graph,knowledge management,obsidian,wiki
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Intended Audience :: End Users/Desktop
14
+ Classifier: Intended Audience :: Information Technology
15
+ Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
16
+ Classifier: Operating System :: OS Independent
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Topic :: Office/Business
21
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
22
+ Classifier: Topic :: Scientific/Engineering :: Information Analysis
23
+ Classifier: Topic :: Text Processing
24
+ Classifier: Topic :: Text Processing :: Indexing
25
+ Requires-Python: >=3.11
26
+ Requires-Dist: aiosqlite>=0.20
27
+ Requires-Dist: anthropic>=0.30
28
+ Requires-Dist: beautifulsoup4>=4.12
29
+ Requires-Dist: certifi>=2024.0
30
+ Requires-Dist: croniter>=2.0
31
+ Requires-Dist: fastapi>=0.111
32
+ Requires-Dist: filelock>=3.15
33
+ Requires-Dist: httpx>=0.27
34
+ Requires-Dist: mcp<2.0,>=1.0
35
+ Requires-Dist: networkx>=3.0
36
+ Requires-Dist: openai>=1.40
37
+ Requires-Dist: openpyxl>=3.1
38
+ Requires-Dist: opentelemetry-sdk>=1.25
39
+ Requires-Dist: pdfminer-six>=20221105
40
+ Requires-Dist: pydantic>=2.7
41
+ Requires-Dist: pypdf>=4.0
42
+ Requires-Dist: python-docx>=1.1
43
+ Requires-Dist: python-louvain>=0.16
44
+ Requires-Dist: python-pptx>=1.0
45
+ Requires-Dist: pyyaml>=6.0
46
+ Requires-Dist: rank-bm25>=0.2
47
+ Requires-Dist: rich>=13
48
+ Requires-Dist: tavily-python>=0.5
49
+ Requires-Dist: typer>=0.12
50
+ Requires-Dist: uvicorn>=0.30
51
+ Requires-Dist: youtube-transcript-api>=0.6
52
+ Provides-Extra: dev
53
+ Requires-Dist: matplotlib>=3.8; extra == 'dev'
54
+ Requires-Dist: mcp<2.0,>=1.0; extra == 'dev'
55
+ Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
56
+ Requires-Dist: pytest-benchmark>=4.0; extra == 'dev'
57
+ Requires-Dist: pytest-cov>=5; extra == 'dev'
58
+ Requires-Dist: pytest-timeout>=2.3; extra == 'dev'
59
+ Requires-Dist: pytest>=8; extra == 'dev'
60
+ Requires-Dist: respx>=0.21; extra == 'dev'
61
+ Provides-Extra: vectors
62
+ Requires-Dist: fastembed>=0.3; extra == 'vectors'
63
+ Description-Content-Type: text/markdown
64
+
65
+ # Synthadoc
66
+
67
+ ```
68
+ .-+###############+-.
69
+ .## ##.
70
+ ## .----. .----. ##
71
+ ## /######\ /######\ ##
72
+ ## |######| |######| ##
73
+ ## | [SD] | | wiki | ##
74
+ ## |######| |######| ##
75
+ ## \######/ \######/ ##
76
+ ## '----' '----' ##
77
+ '## ##'
78
+ '-+###############+-'
79
+
80
+ S Y N T H A D O C
81
+ Community Edition v1.3.4
82
+ ────────────────────────────────
83
+ Domain-agnostic LLM wiki engine
84
+ ```
85
+
86
+ <p>
87
+ <a href="https://github.com/axoviq-ai/synthadoc/actions/workflows/ci.yml"><img src="https://github.com/axoviq-ai/synthadoc/actions/workflows/ci.yml/badge.svg" alt="CI"/></a>
88
+ <a href="https://github.com/axoviq-ai/synthadoc/actions/workflows/ci.yml"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.coverage&label=Coverage&suffix=%25&color=brightgreen" alt="Coverage"/></a>
89
+ <a href="https://github.com/axoviq-ai/synthadoc/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg" alt="License"/></a>
90
+ <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.11%2B-yellow.svg" alt="Python"/></a>
91
+ <a href="https://github.com/axoviq-ai/synthadoc/tree/main/synthadoc/agents"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.agents&label=AI%20agents&color=crimson" alt="AI agents"/></a>
92
+ <a href="https://github.com/axoviq-ai/synthadoc/tree/main/synthadoc/skills"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.skills&label=Skills&color=purple" alt="Skills"/></a>
93
+ <a href="https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-i--connect-claude-via-mcp"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.mcp_tools&label=MCP%20tools&color=orange" alt="MCP tools"/></a>
94
+ <a href="https://github.com/axoviq-ai/synthadoc/tree/main/hooks"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.hooks&label=Hook%20events&color=teal" alt="Hook events"/></a>
95
+ <a href="https://github.com/axoviq-ai/synthadoc"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.cli_commands&label=CLI%20commands&color=darkblue" alt="CLI commands"/></a>
96
+ <a href="https://github.com/axoviq-ai/synthadoc/tree/main/obsidian-plugin"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.obsidian_commands&label=Obsidian%20commands&color=blueviolet" alt="Obsidian commands"/></a>
97
+ <a href="https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#agentic-workflows"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.maintenance_workflows&label=Maintenance%20workflows&color=green" alt="Maintenance workflows"/></a>
98
+ <a href="https://github.com/axoviq-ai/synthadoc"><img src="https://img.shields.io/badge/Community%20Edition-v1.3.4-brightgreen.svg" alt="Version"/></a>
99
+ </p>
100
+
101
+ **Document version: v1.3.4**
102
+
103
+ **Engineered for solo users and enterprises alike, providing a domain-specific knowledge base that scales seamlessly while maintaining accuracy through autonomous self-optimization.**
104
+
105
+ > Built for individuals, small teams, and large organizations who need a knowledge base that stays accurate as documents accumulate.
106
+
107
+ Synthadoc reads your raw source documents — PDFs, spreadsheets, PPTs, web pages, images, videos, Word files, TXTs, and AI session transcripts (.jsonl) — and uses an LLM to synthesize them into a persistent, structured wiki. Cross-references are built automatically, contradictions are detected and surfaced, orphan pages are flagged, and every answer cites its sources. Outputs are stored as local Markdown files, ensuring seamless integration and autonomous management within [Obsidian](https://obsidian.md) or any wiki-compliant ecosystem.
108
+
109
+ ---
110
+
111
+ <table>
112
+ <tr>
113
+ <td align="center" width="33%">
114
+ <a href="https://www.youtube.com/watch?v=rIGO6zi9XQE">
115
+ <img src="https://img.youtube.com/vi/rIGO6zi9XQE/mqdefault.jpg" width="260" alt="From Documents to Wiki — demo walkthrough"/>
116
+ </a>
117
+ <br/>
118
+ <a href="https://www.youtube.com/watch?v=rIGO6zi9XQE">▶ From Documents to Wiki</a>
119
+ </td>
120
+ <td align="center" width="33%">
121
+ <a href="https://youtu.be/ue_kHhG0iog">
122
+ <img src="https://img.youtube.com/vi/ue_kHhG0iog/mqdefault.jpg" width="260" alt="Four Interfaces: CLI, Obsidian, Web UI & MCP"/>
123
+ </a>
124
+ <br/>
125
+ <a href="https://youtu.be/ue_kHhG0iog">▶ Four Interfaces: CLI, Obsidian, Web UI & MCP</a>
126
+ </td>
127
+ <td align="center" width="33%">
128
+ <a href="https://www.youtube.com/watch?v=ojBtNlXVHQk">
129
+ <img src="https://img.youtube.com/vi/ojBtNlXVHQk/mqdefault.jpg" width="260" alt="Agentic Maintenance Workflow"/>
130
+ </a>
131
+ <br/>
132
+ <a href="https://www.youtube.com/watch?v=ojBtNlXVHQk">▶ Agentic Maintenance Workflow</a>
133
+ </td>
134
+ </tr>
135
+ </table>
136
+
137
+ ---
138
+
139
+ ## Table of Contents
140
+
141
+ - [Who Is It For?](#who-is-it-for)
142
+ - [Inspiration and Vision](#inspiration-and-vision)
143
+ - [Problems Addressed](#problems-addressed)
144
+ - [Why Synthadoc?](#why-synthadoc)
145
+ - [Architecture](#architecture)
146
+ - [What's Included](#whats-included)
147
+ - [Installation](#installation)
148
+ - [Quick-Start Guide](#quick-start-guide)
149
+ - [Creating Your Own Wiki](#creating-your-own-wiki)
150
+ - [Configuration](#configuration)
151
+ - [Command Reference by Use Case](#command-reference-by-use-case)
152
+ - [Administrative Reference](#administrative-reference)
153
+ - [Understanding Logs and the Audit Trail](#understanding-logs-and-the-audit-trail)
154
+ - [Customization](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#customization)
155
+ - [Links](#links)
156
+
157
+ ---
158
+
159
+ ## Who Is It For?
160
+
161
+ Synthadoc scales from a single researcher to a company-wide knowledge platform:
162
+
163
+ | Team size | Typical use case |
164
+ | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
165
+ | **Solo / 1–2 people** | Personal research wiki, freelance knowledge base, indie hacker documentation - run it free on Gemini Flash or a local Ollama model with zero ongoing cost |
166
+ | **Small team (3–20)** | Centralized internal knowledge base for startups and departments that aggregates diverse individual data sources into a unified, high-integrity wiki. The system automatically resolves contradictions and scales autonomously, ensuring organizational intelligence grows in tandem with your team |
167
+ | **Medium / enterprise** | Compliance-sensitive knowledge bases that must stay local; per-department wikis on separate ports; audit trail for every ingest and cost event; hook system for CI/CD integration; OpenTelemetry for ops dashboards |
168
+
169
+ No cloud account. No vendor lock-in. The wiki is plain Markdown — open it in any editor, back it up with git, sync it with any cloud drive.
170
+
171
+ ---
172
+
173
+ ## Inspiration and Vision
174
+
175
+ > *"The LLM should be able to maintain a wiki for you."*
176
+ > — Andrej Karpathy, [LLM Wiki gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
177
+
178
+ Most knowledge-management tools retrieve and summarize at query time. Synthadoc inverts this: it **compiles knowledge at ingest time**. Every new source enriches and cross-links the entire corpus, not just appends a new chunk. The wiki is the artifact — readable, editable, and browsable without any tool running.
179
+
180
+ **Long-term alignment:**
181
+
182
+ | Direction | How Synthadoc moves there |
183
+ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
184
+ | Agent orchestration | Orchestrator dispatches parallel ingest, query, and lint sub-agents with cost guards and retry backoff |
185
+ | Sub-agent skills/plugins | Featuring a 3-tier lazy-load capability system, the platform allows for the injection of custom skills and hooks via a plug-and-play interface, ensuring core stability is never compromised during extension |
186
+ | LLM wiki vs. RAG | Pre-compiled structured knowledge beats query-time synthesis for contradiction detection, graph traversal, and offline access |
187
+ | CLI / HTTP | A unified interface via CLI and RESTful endpoints, the system streamlines full-spectrum integration: from data ingestion and querying to automated linting, security auditing, and job orchestration |
188
+ | Local-first | All data stays on your machine; localhost-only network binding; no cloud dependency except the LLM API itself |
189
+ | Provider choice | LLM backends including free-tier Gemini and Groq, paid Anthropic/OpenAI/DeepSeek/MiniMax/Qwen (DashScope), local Ollama and Qwen, and coding-tool CLI providers (Claude Code, Opencode) — no API key required if you already have a subscription |
190
+
191
+ ---
192
+
193
+ ## Problems Addressed
194
+
195
+ RAG retrieves document chunks at query time. Synthadoc **compiles** knowledge at ingest — synthesising sources into a linked, audited wiki graph so contradictions are caught, claims are traced to sources, and the artifact survives outside the tool.
196
+
197
+ | Problem | Synthadoc approach |
198
+ | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
199
+ | **Contradictions blended silently** | Ingest-time conflict detection; page flagged`status: contradicted`; auto-resolve or queue for human review |
200
+ | **No links between related content** | `[[wikilinks]]` auto-built on every ingest pass; weighted graph (wikilink + co-source signals) with Louvain clustering in web UI |
201
+ | **Orphan pages never surfaced** | Lint reports unreferenced pages with ready-to-paste index entries |
202
+ | **LLM output can be overconfident** | Adversarial second-LLM pass flags overstated claims, unsupported superlatives, and contestable facts per page |
203
+ | **Claims lack source traceability** | `^[file:L-L]` citation on every claim; Source Viewer in Obsidian; PDF page resolution; broken-citation lint |
204
+ | **Knowledge lifecycle invisible** | 5-state machine (`draft → active → contradicted / stale → archived`); auto-transitions via lint; immutable event log |
205
+ | **Repeat ingest is expensive** | 3-layer cache (embedding, LLM, provider prompt) — repeat lint on unchanged pages costs near-zero tokens |
206
+ | **Knowledge locked in proprietary tools** | Plain Markdown + YAML frontmatter; OKF v0.1 compatible; fully offline-readable in any editor |
207
+ | **Wiki structure drifts with growth** | `scaffold` regenerates index, AGENTS.md, and purpose.md from current wiki state without touching linked pages |
208
+ | **Migration requires full re-ingestion** | Single-zip backup + restore with port/domain rewriting; no re-ingestion needed |
209
+ | **Cost and compliance exposure** | Localhost-only; per-job token+cost log; configurable soft-warn and hard-gate thresholds |
210
+
211
+ > **Citation quality:** Generated pages include inline citations linking every claim to its source lines. Pages without citations trigger a model-compatibility warning — use Gemini 2.5 Flash or higher for reliable citation annotation.
212
+ >
213
+ > **Active page protection:** Pages promoted to `active` status are protected — sources that contradict them are flagged for review rather than overwriting the human-reviewed content.
214
+
215
+ ---
216
+
217
+ ## Why Synthadoc?
218
+
219
+ Every **Yes** below is a built-in feature — no add-ons or upgrades required.
220
+
221
+ ### Knowledge Quality
222
+
223
+ | Capability | Synthadoc | Typical RAG | NotebookLM | Notion AI |
224
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | ---------- | --------- |
225
+ | **[Ingest-time synthesis](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#ingestagent)** — sources compiled into the wiki at ingest; not re-summarised at query time | **Yes** | No | Partial | No |
226
+ | **[Contradiction detection & resolution](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-9--resolve-a-contradiction)** — conflicting claims flagged `status: contradicted`; auto-resolve available; full conflict history | **Yes** | No | No | No |
227
+ | **[Adversarial claim review + gate](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-11--run-the-adversarial-review)** — concurrent second-LLM pass flags overstated claims, unsupported superlatives, and contestable facts per page; configurable gate auto-demotes pages that exceed the warning threshold to `contradicted` | **Yes** | No | No | No |
228
+ | **[Claim-level provenance](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-20--establish-claim-level-provenance)** — `^[file:L-L]` citation on every claim; Source Viewer in Obsidian; PDF page resolution; broken-citation lint | **Yes** | No | Partial | No |
229
+ | **[5-state lifecycle machine](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-8--manage-page-lifecycle)** — `draft → active → contradicted / stale → archived`; auto-transitions via lint; immutable event log; cascade link cleanup on archive; only `active` and `stale` pages enter the BM25 search index | **Yes** | No | No | No |
230
+ | **[Pre-LLM source sanitizer](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#29-pre-llm-source-sanitizer)** — strips zero-width chars, bidi overrides, hidden HTML, and instruction-override phrases before any LLM call | **Yes** | No | No | No |
231
+
232
+ ### Knowledge Structure
233
+
234
+ | Capability | Synthadoc | Typical RAG | NotebookLM | Notion AI |
235
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------- | ----------- | ---------- | --------- |
236
+ | **[Weighted knowledge graph + D3 visualisation](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-24--knowledge-graph)** — `[[wikilinks]]` auto-built at ingest; co-source edges connect pages compiled from the same document; edge thickness reflects combined weight; dashed edges for co-source-only relationships; Louvain cluster colouring; click node to query; Obsidian graph panel: same graph inside Obsidian via Canvas, type filter, click node to open page | **Yes** | No | Partial | No |
237
+ | **[Orphan page detection](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-10--fix-an-orphan-page)** — unreferenced pages surfaced by lint with ready-to-paste index entries | **Yes** | No | No | No |
238
+ | **[Query-scoped routing](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-17--set-up-routingmd--scoped-search)** — ROUTING.md maps wiki branches to page slugs; queries auto-select relevant branches; new pages auto-slotted | **Yes** | No | No | No |
239
+ | **[Candidates staging](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-18--configure-candidates-staging)** — ingest pages to a staging area first; review, promote, or discard before they enter the live wiki | **Yes** | No | No | No |
240
+ | **[Scaffold automation](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-14--enrich-the-wiki-with-scaffold)** — regenerates index categories, AGENTS.md/CLAUDE.md/GEMINI.md, and purpose.md from current wiki state; protected pages never overwritten | **Yes** | No | No | No |
241
+ | **[Domain templates](synthadoc/templates/README.md)** — 30 fully-authored templates (finance, technology, healthcare, legal, and more) so you start with the right agent guidelines, routing, and structure from day one | **Yes** | No | No | No |
242
+
243
+ ### Search & Query
244
+
245
+ | Capability | Synthadoc | Typical RAG | NotebookLM | Notion AI |
246
+ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----------- | ---------- | --------- |
247
+ | **[Query decomposition + gap detection](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#knowledge-gap-detection)** — compound questions split into parallel BM25 sub-queries; thin results trigger a knowledge-gap callout with suggested web searches | **Yes** | Partial | No | No |
248
+ | **[BM25 TF fallback + compound identifier search](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#queryagent)** — reliable results on small corpora (IDF collapse → TF fallback); underscore identifiers expanded at index and query time so `capex growth` matches `capex_growth` | **Yes** | No | No | No |
249
+ | **[Web search → wiki pages](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-12--web-search-ingestion)** — Tavily search fans out into parallel URL ingest jobs; gap callout in web UI suggests searches inline | **Yes** | No | No | No |
250
+ | **[Semantic re-ranking](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#semantic-re-ranking)** — optional vector re-ranking (`BAAI/bge-small-en-v1.5`) improves recall on conceptually related queries; BM25 stays as fallback | **Yes** (optional) | Varies | No | No |
251
+ | **[Streaming output + query cache](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-23--query-caching)** — token-by-token streaming; cache key = question + wiki version; auto-invalidates on ingest or lifecycle change | **Yes** | Partial | Partial | Partial |
252
+ | **[Proportional context budget](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#31-proportional-context-budget)** — sources allocated proportionally to model context window (60 % wiki / 20 % history / 15 % system / 5 % index); replaces fixed top-N cap | **Yes** | No | No | No |
253
+
254
+ ### Interfaces & Integration
255
+
256
+ | Capability | Synthadoc | Typical RAG | NotebookLM | Notion AI |
257
+ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | ---------- | --------- |
258
+ | **[Obsidian integration](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-3--open-the-vault-in-obsidian)** — native plugin: ingest modal, streaming query, lint report, lifecycle controls, context pack builder, provenance viewer, export modal, **knowledge graph panel** (Canvas force graph, type filter, hover tooltip, click-to-open page); **background vault monitoring** (auto-snapshot on every file save, 2 s debounce, dedup so unchanged saves are free); Reading View set as default on install so citation chips are visible immediately | **Yes** | No | No | No |
259
+ | **[Web chat UI](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-22--use-the-web-chat-ui)** — `synthadoc web`: streaming answers, session sidebar, multi-turn history, knowledge-gap callouts, knowledge graph tab | **Yes** | No | Yes | Yes |
260
+ | **[MCP server](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#27-mcp-server)** — 12 tools; Claude Desktop (stdio), Claude Code (SSE), n8n/LangGraph (HTTP/SSE); brain+memory architecture; no double-LLM cost for reads | **Yes** | No | No | No |
261
+ | **[Context packs](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-19--build-a-context-pack)** — goal → sub-questions → token-budget evidence pack; REST + MCP callable; paste into any LLM chat as grounded context | **Yes** | No | No | No |
262
+ | **[Export formats](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-21--export-your-wiki)** — `llms.txt`, `llms-full.txt`, GraphML, JSON (provenance + lifecycle), OKF v0.1 bundle; lifecycle-filtered; zero extra LLM calls | **Yes** | No | Partial | No |
263
+ | **[Multi-platform agent skill files](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#multi-platform-agent-skill-files)** — `AGENTS.md` (Codex/OpenCode), `CLAUDE.md` (Claude Code), `GEMINI.md` (Gemini CLI); all include full CLI quick-reference, domain guidelines, MCP tool table; regenerated by `scaffold` | **Yes** | No | No | No |
264
+
265
+ ### Content Sources
266
+
267
+ | Capability | Synthadoc | Typical RAG | NotebookLM | Notion AI |
268
+ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | ---------- | --------- |
269
+ | **[Multi-format ingest](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#built-in-skills)** — PDF, DOCX, PPTX, XLSX/CSV, Markdown, TXT, images (vision), web URLs, YouTube transcripts, AI session transcripts (.jsonl) | **Yes** | Varies | Partial | Partial |
270
+ | **[Web search decomposition](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-12--web-search-ingestion)** — broad topics decomposed into focused Tavily keyword searches; results merged and deduplicated | **Yes** | No | No | Partial |
271
+ | **[YouTube transcript ingest](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-13--ingest-a-youtube-video)** — timestamped transcript + executive summary; no API key; auto-generated captions supported | **Yes** | No | Yes | No |
272
+ | **[Multilingual / CJK queries](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#queryagent)** — Chinese, Japanese, Korean — no false knowledge gaps | **Yes** | Limited | No | No |
273
+ | **[Multiple LLM providers + coding tools](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-c--switching-llm-providers)** — Gemini, Groq, Qwen, MiniMax, DeepSeek, Anthropic, OpenAI, Ollama; Claude Code and Opencode (no API key needed) | **Yes** | No | No | No |
274
+
275
+ ### Operations & Trust
276
+
277
+ | Capability | Synthadoc | Typical RAG | NotebookLM | Notion AI |
278
+ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ------------------------ | ---------------------- | --------------------------------------------------------------------------------------------------- |
279
+ | **Local-first + offline artifact** — source documents never leave your machine; compiled wiki is plain Markdown, fully readable offline in any editor without the server | **Yes** | Varies | No | No |
280
+ | **[Portable backup / restore](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#28-backup--restore)** — single zip: wiki pages + audit/lifecycle DB + config; port and domain rewriting on restore; migrate machines without re-ingesting | **Yes** | No — re-ingest required | No — AI metadata lost | No |
281
+ | **[Lifecycle content snapshots + rollback](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#snapshots-and-content-recovery)** — page body captured at every lifecycle transition (manual CLI/Obsidian, lint-driven auto-transition, or Obsidian vault save); deduplicated so unchanged saves cost nothing; browse per-page version history with `lifecycle history` (newest-first, with reason); restore any prior version with `lifecycle rollback`; rollback saves the current body first so it is always undoable | **Yes** | No | No | Partial — Notion has time-based edit history (plan-gated, no lifecycle tie, no auditable rollback) |
282
+ | **[Cost guard + full audit trail](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-15--audit-features)** — per-job token + cost log; soft-warn and hard-gate thresholds; `audit citations` validates every claim citation; immutable event log | **Yes** | No | No | No |
283
+ | **[Citation faithfulness audit](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#checking-citation-faithfulness)** — on-demand LLM verification that each claim's text is actually supported by its cited source lines; per-page result cache with staleness detection; findings surfaced in the Obsidian source viewer | **Yes** | No | No | No |
284
+ | **[Resumable job queue + retry](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#14-job-queue)** — every ingest/lint job persisted with status and error; batch a hundred documents and resume after a crash | **Yes** | No | No | No |
285
+ | **[Custom skills + CI hooks](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#11-hook-system)** — subclass `BaseSkill` for new file formats; 2 hook events (`on_ingest_complete` + `on_lint_complete`); example git auto-commit hook included; blocking hooks can gate operations | **Yes** | Limited | No | No |
286
+ | **[Per-source truncation flag](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#30-per-source-truncation-flag)** — `--max-source-chars` caps any source (PDF, DOCX, web page, plain text) before the LLM call; truncated sources flagged with `truncated: true` in frontmatter and warned in lint output | **Yes** | No | No | No |
287
+ | **[Multi-wiki isolation](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#wiki-targeting)** — each wiki on its own port with independent config, audit trail, and job queue; switch with `synthadoc use` | **Yes** | No | Partial | No |
288
+ | **[Agentic maintenance workflows](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#agentic-workflows)** — seven conversational workflows (stale-page re-ingest, broken wikilinks fix, lint report, scaffold regeneration, **contradiction resolver**, **orphan resolver**, **[broken citation resolver](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#demo--broken-citation-resolver)**) via web UI or `synthadoc workflow` CLI; confirm-before-act gate on all writes; graph sidebar chips trigger workflows with one click | **Yes** | No | No | No |
289
+ | **[Sensitive Data Retract](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-27--scan-and-retract-sensitive-data)** — scan all wiki pages for API keys, emails, SSNs, credit cards, and custom patterns; apply `[REDACTED]` in place; background scan is incremental (only pages modified since the last cycle are checked); server auto-scans ingested pages immediately after each ingest job completes; `--changed-only` CLI flag for incremental manual runs; `synthadoc retract status` captures the full retraction audit trail (slug, pattern names, counts — never the sensitive values themselves) | **Yes** | No | No | No |
290
+
291
+ ### Business value
292
+
293
+ | Value | How |
294
+ | --------------------- | ------------------------------------------------------------------------------- |
295
+ | **Faster onboarding** | New team members query the wiki instead of digging through documents |
296
+ | **Audit trail** | Every ingest recorded in`audit.db` with source hash, token count, and timestamp |
297
+ | **Cost control** | Configurable thresholds; 3-layer cache reduces repeat spend |
298
+ | **Compliance** | Local-first — source documents and compiled knowledge never leave your machine |
299
+ | **Extensibility** | Hooks fire on every event; custom skills load without a server restart |
300
+
301
+ ---
302
+
303
+ ## Architecture
304
+
305
+ ![Synthadoc Architecture](https://raw.githubusercontent.com/axoviq-ai/synthadoc/main/docs/png/architecture.png)
306
+
307
+ For full architecture details, data models, API reference, and plugin development guide see **[docs/design.md](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md)**.
308
+
309
+ ---
310
+
311
+ ## What's Included
312
+
313
+ See [docs/design.md — Appendix A: Release Feature Index](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#appendix-a--release-feature-index) for a full feature list by version.
314
+
315
+ ---
316
+
317
+ ## Installation
318
+
319
+ ### Production
320
+
321
+ **Prerequisites:** Python 3.11+. No Node.js, no Git, no build steps.
322
+
323
+ ```bash
324
+ pip install synthadoc
325
+ synthadoc --version # confirm it works
326
+ ```
327
+
328
+ The Obsidian plugin is bundled inside the package. New wikis created with `synthadoc install` have it installed automatically. If you are upgrading an existing Synthadoc installation, run `synthadoc plugin upgrade` to push the updated plugin binary to all registered wikis.
329
+
330
+ ---
331
+
332
+ ### Development
333
+
334
+ For developers modifying the Python engine, running the test suite, or developing the Obsidian plugin TypeScript.
335
+
336
+ **Additional prerequisites:** Git (any). Node.js 18+ only if modifying the plugin TypeScript source.
337
+
338
+ #### Step 1 — Clone and install
339
+
340
+ ```bash
341
+ git clone https://github.com/axoviq-ai/synthadoc.git
342
+ cd synthadoc
343
+ pip install -e ".[dev]"
344
+ ```
345
+
346
+ `[dev]` adds `pytest`, `respx`, and the other test dependencies. Tests require a source checkout — they are not included in the pip wheel.
347
+
348
+ #### Step 2 — Run the test suite
349
+
350
+ ```bash
351
+ pytest --ignore=tests/performance/ -q
352
+ ```
353
+
354
+ Expected: all tests pass, 0 failures. Performance benchmarks (optional):
355
+
356
+ ```bash
357
+ pytest tests/performance/ -v --benchmark-disable
358
+ ```
359
+
360
+ #### Step 3 — Obsidian plugin development (optional)
361
+
362
+ The compiled plugin is bundled with the package and kept up to date by CI — no build step is needed to work on the Python side or run tests.
363
+
364
+ If you modify the TypeScript source under `obsidian-plugin/src/`, recompile and sync it into the Python package manually:
365
+
366
+ ```bash
367
+ cd obsidian-plugin
368
+ npm install # first time only, or after package.json changes
369
+ # edit src/main.ts or other source files
370
+ npm run build # compile TypeScript → main.js (also syncs to synthadoc/data/obsidian-plugin/)
371
+ npm test # run Vitest unit tests
372
+ cd ..
373
+ ```
374
+
375
+ ---
376
+
377
+ ### Set your API keys
378
+
379
+ **At least one LLM API key is required** — unless you use Claude Code or Opencode as your provider (no separate API key needed — see [Coding tool CLI providers](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#coding-tool-cli-providers--no-api-key-needed)).
380
+
381
+ Synthadoc defaults to **Gemini Flash** — free tier, no credit card, 1 million tokens per day. Get a key at **aistudio.google.com/app/apikey** (click "Create API key").
382
+
383
+ | Provider | Free tier | Vision | Get key |
384
+ | ---------------- | --------------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
385
+ | **Gemini Flash** | Yes — 15 RPM / 1M tokens/day, no credit card | Yes | [aistudio.google.com](https://aistudio.google.com/app/apikey) |
386
+ | Groq | Yes — rate-limited | No | [console.groq.com](https://console.groq.com/keys) |
387
+ | Ollama | Yes — runs locally, no key (**GPU required**) | Model-dependent | [ollama.com](https://ollama.com) |
388
+ | Qwen | Yes — 1M free tokens (90-day trial), then paid DashScope | Model-dependent | [bailian.console.aliyun.com](https://bailian.console.aliyun.com/) |
389
+ | MiniMax | No — pay-per-token | Yes | [platform.minimax.io](https://platform.minimax.io/) |
390
+ | DeepSeek | No — pay-per-token (very cheap text rates) | No | [platform.deepseek.com](https://platform.deepseek.com/api_keys) |
391
+ | Anthropic | No | Yes | [console.anthropic.com](https://console.anthropic.com/) |
392
+ | OpenAI | No | Yes | [platform.openai.com](https://platform.openai.com/api-keys) |
393
+ | **Claude Code** | Included with subscription — no API key | No | Set`provider = "claude-code"` in config.toml |
394
+ | **Opencode** | Free via Opencode Zen — no API key | No | Set`provider = "opencode", model = "opencode/big-pickle"` in config.toml; connect first: run `opencode` → `/connect` → select Zen |
395
+
396
+ ```bash
397
+ # macOS / Linux — add to ~/.bashrc or ~/.zshrc to persist
398
+ export GEMINI_API_KEY=AIza… # default — free tier, 1M tokens/day
399
+ export GROQ_API_KEY=gsk_… # alternative free tier — 100K tokens/day
400
+ export ANTHROPIC_API_KEY=sk-ant-… # paid — highest quality
401
+ export OPENAI_API_KEY=sk-… # paid
402
+ export MINIMAX_API_KEY=… # paid — text rates (image support)
403
+ export DEEPSEEK_API_KEY=… # paid — text rates (no image support)
404
+ export QWEN_API_KEY=… # DashScope cloud — 1M free tokens trial
405
+ export TAVILY_API_KEY=tvly-… # web search (optional)
406
+
407
+ # Windows cmd — current session only
408
+ set GEMINI_API_KEY=AIza…
409
+ set GROQ_API_KEY=gsk_…
410
+ set ANTHROPIC_API_KEY=sk-ant-…
411
+ set OPENAI_API_KEY=sk-…
412
+ set MINIMAX_API_KEY=…
413
+ set DEEPSEEK_API_KEY=…
414
+ set QWEN_API_KEY=…
415
+ set TAVILY_API_KEY=tvly-…
416
+
417
+ ```
418
+
419
+ Web search uses **Tavily** (`TAVILY_API_KEY`) — optional, only needed for `synthadoc ingest "search for: …"` jobs. Get a free key at [tavily.com](https://tavily.com).
420
+
421
+ ---
422
+
423
+ ### Install a wiki and start the engine
424
+
425
+ A **wiki** is a self-contained knowledge base — a folder of Markdown pages maintained and cross-referenced automatically by Synthadoc. The fastest way to get started is the **History of Computing** demo (13 pre-built pages, no LLM API key required to browse).
426
+
427
+ ```bash
428
+ # Linux / macOS
429
+ synthadoc install history-of-computing --target ~/wikis --demo
430
+
431
+ # Windows (cmd.exe)
432
+ synthadoc install history-of-computing --target %USERPROFILE%\wikis --demo
433
+ ```
434
+
435
+ Then start the engine:
436
+
437
+ ```bash
438
+ # Foreground — logs stream to the console
439
+ synthadoc serve -w history-of-computing
440
+
441
+ # Background — releases the terminal
442
+ synthadoc serve -w history-of-computing --background
443
+ ```
444
+
445
+ The server binds to `http://127.0.0.1:7070` (localhost-only). Leave it running while you work — the Obsidian plugin, CLI ingest commands, and query commands all talk to it.
446
+
447
+ To switch LLM provider, edit `[agents]` in `<wiki-root>/.synthadoc/config.toml` and restart `synthadoc serve`. See [Appendix — Switching LLM providers](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-c--switching-llm-providers) for step-by-step instructions.
448
+
449
+ To stop a background server:
450
+
451
+ ```bash
452
+ # Linux / macOS
453
+ kill <PID>
454
+
455
+ # Windows (cmd)
456
+ taskkill /PID <PID> /F
457
+ ```
458
+
459
+ The PID is printed on start and saved to `<wiki-root>/.synthadoc/server.pid`.
460
+
461
+ **Upgrading:** after updating synthadoc (via `pip install --upgrade synthadoc` or `git pull`), restart the server to pick up the new code, then run these to keep registered wikis in sync:
462
+
463
+ ```bash
464
+ synthadoc plugin upgrade # push updated Obsidian plugin binary to all registered wikis
465
+ synthadoc templates sync --force # demo and template wikis — refresh seeds, routing, agent files, and stubs
466
+ ```
467
+
468
+ Neither command requires the server to be running.
469
+
470
+ ---
471
+
472
+ ## Quick-Start Guide
473
+
474
+ The **History of Computing** demo includes 13 pre-built pages, raw source files covering clean-merge, contradiction, and orphan scenarios, and a full walkthrough of key Synthadoc feature.
475
+
476
+ **Full step-by-step walkthrough: [docs/user-quick-start-guide.md](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md)**
477
+
478
+ The guide covers:
479
+
480
+ 1. Verify the demo server started (banner, health check)
481
+ 2. Install the Synthadoc plugin (auto-installs Dataview) and open the vault
482
+ 3. Review wiki structure and key files (index, purpose, AGENTS.md, dashboard)
483
+ 4. Query the pre-built wiki — including knowledge gap detection
484
+ 5. Batch ingest all demo source files
485
+ 6. Run lint — auto-promote clean pages to active
486
+ 7. Manage page lifecycle — 5-state machine (draft → active → stale/contradicted/archived), manual transitions, immutable audit trail
487
+ 8. Resolve a contradiction
488
+ 9. Fix an orphan page
489
+ 10. Run the adversarial lint pass — flag overstated claims across all pages
490
+ 11. Web search ingestion with automatic decomposition
491
+ 12. Ingest a YouTube video
492
+ 13. Enrich the wiki with scaffold (regenerate/update index, purpose, AGENTS.md)
493
+ 14. Audit features (token cost, history, events)
494
+ 15. Schedule recurring operations
495
+ 16. Set up query-scoped routing with ROUTING.md
496
+ 17. Stage and review candidate pages before promoting them
497
+ 18. Build a context pack for grounded LLM prompts
498
+ 19. Verify claim provenance — source-line citations, broken citation audit, global provenance table
499
+ 20. Export your wiki — llms.txt, llms-full.txt, GraphML wikilink graph, agent-ready JSON with provenance and lifecycle history, OKF v0.1 bundle for zero-code agent consumption
500
+ 21. Use the web chat UI — streaming answers, session-aware hint chips, citations in-browser
501
+ 22. Query caching — understand how answers are cached and how to bypass with `--no-cache`
502
+ 23. Backup and restore — create a portable wiki zip, restore on a different machine
503
+ 24. Knowledge graph — weighted edges (wikilink + co-source signals), explore clusters in the web UI Graph tab, click a node to query it
504
+ 25. Ingest an AI session transcript — turn Claude Code, Codex, or chat conversations into structured wiki pages
505
+ 26. Agentic maintenance workflows — seven conversational workflows via web UI or CLI: re-ingest stale pages (bulk or by slug), scan and fix broken wikilinks, run lint and view the full report, run scaffold and regenerate wiki files, resolve contradicted pages interactively (diff shown before every write, human approval required), resolve orphaned pages by inserting natural wikilinks into related content, fix broken source citation markers — agent confirms before touching anything, streams inline progress
506
+ 27. Scan and retract sensitive data — dry-run to surface API keys, emails, SSNs, credit cards, and custom patterns; apply redactions with a single confirmation; incremental `--changed-only` mode for recurring runs; audit trail records pattern names only (never the values)
507
+
508
+ ---
509
+
510
+ ## Creating Your Own Wiki
511
+
512
+ > **New to building your own wiki?** Work through the [AquaFlow Capital Workshop Walkthrough](https://github.com/axoviq-ai/synthadoc/tree/main/docs/example/aquaflow) first — a complete end-to-end workshop using a real M&A due-diligence wiki with pre-built pages, evaluation queries, and benchmark results. Once you are comfortable with the flow, come back here to build your own wiki from scratch.
513
+
514
+ ### 1. Pick a template and install
515
+
516
+ Browse the 30 available templates across 9 categories and pick the one closest to your domain:
517
+
518
+ ```bash
519
+ synthadoc templates list
520
+ ```
521
+
522
+ Install with a template (example: consumer and competitive market research):
523
+
524
+ ```bash
525
+ synthadoc install my-market-wiki --target ~/wikis --template research/market-research
526
+ synthadoc use my-market-wiki # set as default — no -w needed from here on
527
+ ```
528
+
529
+ If none of the 30 templates fits, install without one and provide a `--domain` description instead:
530
+
531
+ ```bash
532
+ synthadoc install my-wiki --target ~/wikis --domain "Your domain description"
533
+ ```
534
+
535
+ → Full template catalog and per-category install commands: [synthadoc/templates/README.md](synthadoc/templates/README.md)
536
+
537
+ ### 2. Configure your LLM provider and start the server
538
+
539
+ Open `~/.wikis/my-market-wiki/.synthadoc/config.toml` and set your LLM provider, then start:
540
+
541
+ ```bash
542
+ synthadoc serve
543
+ synthadoc status # should show 0 pages and the scheduled jobs registered
544
+ ```
545
+
546
+ → Provider list and API key setup: [Quick-Start Guide — Appendix C](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-c--switching-llm-providers)
547
+
548
+ `synthadoc install` copies the Synthadoc and Dataview plugins into the vault and pre-enables them. Open the wiki folder in Obsidian — both plugins are active immediately. A local web UI is also available at `http://localhost:{port}/app` via `synthadoc web`.
549
+
550
+ ### 3. Add your sources and ingest
551
+
552
+ > **Start with `seeds.md`.** Your installed wiki includes a `seeds.md` file at the wiki root — open it before anything else. It contains the complete getting-started guide for your domain: pre-vetted copy-paste ingest commands for curated public URLs, a domain-specific first-steps checklist, and topic hints for finding additional sources.
553
+ >
554
+ > Open it in Obsidian (file pane → `seeds.md`) or in any editor:
555
+ > ```
556
+ > <your-wiki-folder>/seeds.md
557
+ > ```
558
+
559
+ Once you have worked through `seeds.md`, drop your own documents into the `raw_sources/` folder and ingest them. Subfolders are supported — organise by topic, date, or document type:
560
+
561
+ ```bash
562
+ synthadoc ingest raw_sources/ --batch # all local files at once
563
+ synthadoc ingest "https://example.com/report" # a web URL
564
+ synthadoc ingest "search for: Bank of Canada rate outlook 2025" # web search
565
+ synthadoc jobs list # watch progress
566
+ ```
567
+
568
+ → Supported formats, subfolder layout, and web search tips: [templates/README.md — Adding your own content](synthadoc/templates/README.md#adding-your-own-content)
569
+
570
+ ### 4. Review and promote candidates
571
+
572
+ Template installs stage every new page in `candidates/` for review before it enters the wiki. Promote what belongs, discard what doesn't:
573
+
574
+ ```bash
575
+ synthadoc candidates list
576
+ synthadoc candidates promote --all # or promote individually by slug
577
+ synthadoc candidates discard <slug>
578
+ ```
579
+
580
+ → CLI commands and Obsidian plugin walkthrough: [templates/README.md — Reviewing and promoting candidates](synthadoc/templates/README.md#reviewing-and-promoting-candidates)
581
+
582
+ ### 5. Query, lint, and scaffold
583
+
584
+ ```bash
585
+ synthadoc query "What are the current consumer confidence trends in Canada?"
586
+ synthadoc lint run # validates pages, promotes clean drafts to active
587
+ synthadoc lint report # view issues and citation violations
588
+ synthadoc scaffold # regenerates index.md with richer category links
589
+ ```
590
+
591
+ Lint and scaffold run automatically on a weekly schedule (Sunday 2 AM and 3 AM). Your own content above the `<!-- synthadoc:scaffold -->` marker in `index.md` and `purpose.md` is never overwritten.
592
+
593
+ → Schedule customisation and scaffold zone rules: [templates/README.md — Scheduled maintenance](synthadoc/templates/README.md#scheduled-maintenance)
594
+
595
+ ### 6. Context packs and MCP
596
+
597
+ Template installs include a pre-configured `ROUTING.md` that automatically scopes queries to the relevant topic branch — no setup needed. If you installed without a template, generate it once with `synthadoc routing init`.
598
+
599
+ Build a cited excerpt pack for use in an external agent prompt:
600
+
601
+ ```bash
602
+ synthadoc context build "Canadian consumer confidence trends" --tokens 4000
603
+ ```
604
+
605
+ Connect Claude Code directly to your wiki's MCP server:
606
+
607
+ ```bash
608
+ # Replace 7070 with the port shown when you ran synthadoc serve
609
+ claude mcp add --transport sse synthadoc-my-market-wiki http://127.0.0.1:7070/mcp/sse
610
+ ```
611
+
612
+ → Routing performance benchmarks: [Quick-Start Guide — Appendix H](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-h--bm25-routing-performance-benchmarks)
613
+ → Context packs and MCP integration: [docs/design.md — Context packs](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#context-packs)
614
+ → Knowledge gap workflow: [docs/design.md — Knowledge gap workflow](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#knowledge-gap-workflow)
615
+ → Semantic re-ranking (optional vector search): [docs/design.md — Semantic re-ranking](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#semantic-re-ranking)
616
+
617
+ ---
618
+
619
+ ## Configuration
620
+
621
+ You do not need to configure anything to run the demo. The demo wiki ships with its own settings and sensible built-in defaults cover everything else. Set your API key env var, run `synthadoc serve`, and go.
622
+
623
+ For the full configuration reference — layer precedence, global vs. per-project config, all keys and defaults — see [Appendix E — Configuration](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-e--configuration) in the Quick-Start Guide, or [docs/design.md — Configuration](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#configuration) for the complete technical reference.
624
+
625
+ ---
626
+
627
+ ## Command Reference by Use Case
628
+
629
+ > **Full CLI command tree** (all subcommands, flags, and groupings): [docs/design.md — Command tree](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#command-tree)
630
+
631
+ ### Setting up a wiki
632
+
633
+ ```bash
634
+ # Create a new wiki (LLM scaffold runs automatically; port is auto-assigned to avoid conflicts)
635
+ synthadoc install my-wiki --target ~/wikis --domain "Machine Learning"
636
+
637
+ # Pin a specific port manually
638
+ synthadoc install my-wiki --target ~/wikis --domain "Machine Learning" --port 7071
639
+
640
+ # Install the demo (includes pre-built pages and raw sources — no LLM call needed)
641
+ synthadoc install history-of-computing --target ~/wikis --demo
642
+
643
+ # List available demo templates
644
+ synthadoc demo list
645
+
646
+ # List all 30 domain templates (and demos) — browse before installing
647
+ synthadoc templates list
648
+
649
+ # Install with a domain template — pre-configured guidelines, routing, and starter pages
650
+ synthadoc install my-finance-wiki --target ~/wikis --template finance/investment
651
+
652
+ # Sync a demo or template wiki — refresh seeds, routing, agent files, and intake forms
653
+ synthadoc templates sync history-of-computing
654
+
655
+ # Also refresh stub pages that have never been ingested (sources: [])
656
+ synthadoc templates sync history-of-computing --force
657
+
658
+ # Reinstall the Obsidian plugin into a wiki's vault — normally done automatically by synthadoc install
659
+ synthadoc plugin install history-of-computing
660
+
661
+ # Push the updated plugin binary to every registered wiki after a Synthadoc upgrade
662
+ synthadoc plugin upgrade
663
+ ```
664
+
665
+ ### Switching the active wiki
666
+
667
+ ```bash
668
+ # Set a wiki as the default so -w is not required for any subsequent command
669
+ synthadoc use my-wiki
670
+
671
+ # Check which wiki is currently active
672
+ synthadoc use
673
+
674
+ # Clear the saved default (revert to requiring -w on every command)
675
+ synthadoc use --clear
676
+ ```
677
+
678
+ ### Refreshing wiki scaffold
679
+
680
+ After install, you can re-run the LLM scaffold at any time to regenerate domain-specific content (index categories, AGENTS.md guidelines, purpose.md scope). Pages already linked in `index.md` are protected and preserved.
681
+
682
+ ```bash
683
+ # Regenerate scaffold for an existing wiki
684
+ synthadoc scaffold -w my-wiki
685
+
686
+ # Schedule weekly refresh (runs every Sunday at 4 AM)
687
+ synthadoc schedule add --op "scaffold" --cron "0 4 * * 0" -w my-wiki
688
+ ```
689
+
690
+ `config.toml` and `dashboard.md` are never modified by `scaffold`.
691
+
692
+ ### Running the server
693
+
694
+ ```bash
695
+ # Start HTTP API + job worker (foreground — terminal stays attached)
696
+ synthadoc serve -w my-wiki
697
+
698
+ # Detach to background — banner shown, then shell is released
699
+ # All logs go to <wiki>/.synthadoc/logs/synthadoc.log
700
+ synthadoc serve -w my-wiki --background
701
+
702
+ # Custom port
703
+ synthadoc serve -w my-wiki --port 7071
704
+
705
+ # Verbose debug logging to console
706
+ synthadoc serve -w my-wiki --verbose
707
+ ```
708
+
709
+ ### Ingesting sources
710
+
711
+ ```bash
712
+ # Single file or URL
713
+ synthadoc ingest report.pdf -w my-wiki
714
+ synthadoc ingest https://example.com/article -w my-wiki
715
+
716
+ # Entire folder — enqueues each file; the worker processes jobs sequentially
717
+ synthadoc ingest --batch raw_sources/ -w my-wiki
718
+
719
+ # Manifest file — ingest a curated list of sources in one shot.
720
+ # sources.txt: one entry per line; each line is either an absolute file path
721
+ # (PDF, DOCX, PPTX, MD, …) or a URL. Blank lines and # comments are ignored.
722
+ # Each entry becomes a separate job in the queue, processed sequentially.
723
+ #
724
+ # Example sources.txt:
725
+ # /home/user/docs/research-paper.pdf
726
+ # /home/user/slides/keynote.pptx
727
+ # https://en.wikipedia.org/wiki/Alan_Turing
728
+ # # this line is ignored
729
+ synthadoc ingest --file sources.txt -w my-wiki
730
+
731
+ # Force re-ingest (bypass deduplication and cache)
732
+ synthadoc ingest --force report.pdf -w my-wiki
733
+
734
+ # Web search — triggers a Tavily search, then ingests each result URL as a child job.
735
+ # Prefix the query with any recognised intent: "search for:", "find on the web:",
736
+ # "look up:", or "web search:" (prefix is stripped before the search is sent)
737
+ # Requires TAVILY_API_KEY to be set.
738
+ #
739
+ # Note: web search content is NOT saved to raw_sources/. The flow is direct:
740
+ # query → Tavily → URLs → each URL fetched → wiki pages written
741
+ # raw_sources/ is for user-provided local files (PDF, DOCX, PPTX, etc.) only.
742
+ # The wiki pages themselves are the persistent output of a web search.
743
+ synthadoc ingest "search for: Bank of Canada interest rate decisions 2024" -w my-wiki
744
+ synthadoc ingest "find on the web: unemployment trends Ontario Q1 2025" -w my-wiki
745
+
746
+ # Limit how many URLs are enqueued (default 20, overrides [web_search] max_results)
747
+ synthadoc ingest "search for: quantum computing basics" --max-results 5 -w my-wiki
748
+
749
+ # Multiple web searches at once via a manifest file
750
+ # web-searches.txt:
751
+ # search for: Bank of Canada interest rate decisions 2024
752
+ # find on the web: unemployment trends Ontario Q1 2025
753
+ # look up: Toronto housing market affordability index
754
+ synthadoc ingest --file web-searches.txt -w my-wiki
755
+
756
+ # YouTube video — transcript extracted automatically, no API key needed.
757
+ # The video must have captions (auto-generated or manual).
758
+ # Check: open the video on YouTube → ... → Show transcript.
759
+ synthadoc ingest "https://www.youtube.com/watch?v=O5nskjZ_GoI" -w my-wiki
760
+ synthadoc ingest "https://youtu.be/O5nskjZ_GoI" -w my-wiki
761
+
762
+ # YouTube URLs returned by web search are also routed automatically:
763
+ # if Tavily returns a YouTube URL, the transcript is ingested instead of the page HTML.
764
+ synthadoc ingest "search for: history of computing lecture" -w my-wiki
765
+ ```
766
+
767
+ Each YouTube wiki page opens with an **executive summary** — what the video is about,
768
+ the main topics covered, and the key takeaway — followed by the full timestamped transcript
769
+ for precise citation.
770
+
771
+ ### Querying
772
+
773
+ ```bash
774
+ # Ask a question — answer streams token-by-token as the LLM generates it
775
+ synthadoc query "What is Moore's Law?" -w my-wiki
776
+
777
+ # Blocking mode (no streaming) — useful in scripts or pipes
778
+ synthadoc query "What is Moore's Law?" --no-stream -w my-wiki
779
+
780
+ # Skip the cache — always call the LLM even if the answer is cached
781
+ synthadoc query "What is Moore's Law?" --no-cache -w my-wiki
782
+
783
+ # Save the answer as a new wiki page
784
+ synthadoc query "What is Moore's Law?" --save -w my-wiki
785
+ ```
786
+
787
+ Query answers are **cached automatically** by question content and wiki version. Repeated identical questions return instantly from cache. The cache invalidates automatically when you ingest new content or change a page's lifecycle state.
788
+
789
+ ### Web Chat UI
790
+
791
+ ```bash
792
+ # Open the browser-based chat interface for a wiki
793
+ synthadoc web -w my-wiki
794
+ ```
795
+
796
+ → Full walkthrough (session modes, multi-turn conversation, session history sidebar): [Quick-Start Guide — Step 22](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-22--use-the-web-chat-ui)
797
+
798
+ ### Linting
799
+
800
+ ```bash
801
+ # Run a full lint pass (enqueues job)
802
+ synthadoc lint run -w my-wiki
803
+
804
+ # Only contradictions
805
+ synthadoc lint run --scope contradictions -w my-wiki
806
+
807
+ # Auto-apply high-confidence resolutions
808
+ synthadoc lint run --auto-resolve -w my-wiki
809
+
810
+ # Skip adversarial review (structural checks only; also clears existing warnings)
811
+ synthadoc lint run --no-adversarial -w my-wiki
812
+
813
+ # Skip lifecycle checks (structural and adversarial checks only)
814
+ synthadoc lint run --no-lifecycle -w my-wiki
815
+
816
+ # Instant report (reads wiki files directly, no server needed)
817
+ synthadoc lint report -w my-wiki
818
+ ```
819
+
820
+ ### Agentic workflows
821
+
822
+ Agentic workflows run as interactive tool-call loops — they stream progress inline, ask for approval before any destructive change, and exit cleanly if you decline.
823
+
824
+ ```bash
825
+ # List all available workflows (with descriptions and accepted parameters)
826
+ synthadoc workflow list
827
+
828
+ # Run a workflow by name
829
+ synthadoc workflow run --name lint-report -w my-wiki
830
+ synthadoc workflow run --name broken-wikilinks -w my-wiki
831
+ synthadoc workflow run --name scaffold -w my-wiki
832
+ synthadoc workflow run --name ingest-lint -w my-wiki
833
+
834
+ # Contradiction resolver — resolve all contradicted pages
835
+ synthadoc workflow run --name contradiction-resolver -w my-wiki
836
+
837
+ # Resolve only one page by slug
838
+ synthadoc workflow run --name contradiction-resolver --slug alan-turing -w my-wiki
839
+
840
+ # Scope to pages demoted by the adversarial gate
841
+ synthadoc workflow run --name contradiction-resolver --type adversarial -w my-wiki
842
+
843
+ # Scope to pages with source-level contradictions
844
+ synthadoc workflow run --name contradiction-resolver --type source-conflict -w my-wiki
845
+
846
+ # Custom timeout (default 3600 s)
847
+ synthadoc workflow run --name contradiction-resolver --timeout 7200 -w my-wiki
848
+
849
+ # Orphan resolver — find pages with no incoming wikilinks and insert natural links
850
+ synthadoc workflow run --name orphan-resolver -w my-wiki
851
+
852
+ # Resolve only one orphaned page by slug
853
+ synthadoc workflow run --name orphan-resolver --slug ada-lovelace -w my-wiki
854
+
855
+ # Broken citation resolver — fix broken ^[file:L-L] source markers (broken_ref / malformed / out_of_range)
856
+ synthadoc workflow run --name broken-citation-resolver -w my-wiki
857
+
858
+ # Fix citations on a single page only
859
+ synthadoc workflow run --name broken-citation-resolver --slug my-page -w my-wiki
860
+ ```
861
+
862
+ The contradiction resolver lists contradicted pages, estimates cost, then walks through each page: reads the content and conflicting sources, proposes a rewrite, shows the full unified diff, and waits for your approval. After an approved write it re-lints the page and promotes it to *active* on pass, or escalates after 3 failed attempts.
863
+
864
+ → Full walkthrough and web UI path: [Quick-Start Guide — Step 9](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-9--resolve-a-contradiction)
865
+
866
+ ### Sensitive data retraction
867
+
868
+ Scan wiki pages for API keys, emails, SSNs, credit card numbers, and custom patterns. Apply `[REDACTED]` in place after confirmation. The server also scans pages automatically after each ingest job.
869
+
870
+ ```bash
871
+ # Dry-run — show pattern matches without making changes
872
+ synthadoc retract scan -w my-wiki
873
+
874
+ # Dry-run for a single page
875
+ synthadoc retract scan --slug ada-lovelace -w my-wiki
876
+
877
+ # Only scan pages modified since the last scan cycle (incremental)
878
+ synthadoc retract scan --changed-only -w my-wiki
879
+
880
+ # Apply redactions across all pages (prompts for confirmation)
881
+ synthadoc retract scan --apply -w my-wiki
882
+
883
+ # Apply only to recently-modified pages, auto-confirm
884
+ synthadoc retract scan --apply --changed-only --yes -w my-wiki
885
+
886
+ # Apply without confirmation prompt
887
+ synthadoc retract scan --apply --yes -w my-wiki
888
+
889
+ # Show recent scan history from the audit log
890
+ synthadoc retract status -w my-wiki
891
+ synthadoc retract status --json -w my-wiki
892
+ ```
893
+
894
+ → Full walkthrough: [Quick-Start Guide — Step 27](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#step-27--scan-and-retract-sensitive-data)
895
+
896
+ ### Managing page lifecycle
897
+
898
+ ```bash
899
+ # Show page counts by lifecycle state
900
+ synthadoc status -w my-wiki
901
+
902
+ # Promote a draft page to active after manual review
903
+ synthadoc lifecycle activate <slug> -w my-wiki --reason "reviewed and verified"
904
+
905
+ # Archive a page whose source has been superseded
906
+ synthadoc lifecycle archive <slug> -w my-wiki --reason "replaced by updated source"
907
+ # After archiving, any [[slug]] references in other pages are cleaned up automatically.
908
+ # The output reports which pages were updated:
909
+ # Cascade: [[old-page]] removed from 2 page(s): cpu-design, transistor-history
910
+
911
+ # Restore an archived page back to draft for re-review
912
+ synthadoc lifecycle restore <slug> -w my-wiki --reason "source re-added"
913
+
914
+ # View full state history for a page (or all pages)
915
+ synthadoc lifecycle log <slug> -w my-wiki
916
+ synthadoc lifecycle log -w my-wiki
917
+
918
+ # Browse content snapshots captured at each lifecycle transition
919
+ synthadoc lifecycle history <slug> -w my-wiki
920
+ synthadoc lifecycle history <slug> --index 1 -w my-wiki # inspect newest snapshot
921
+ synthadoc lifecycle history <slug> --index 2 --show-content -w my-wiki # print full body
922
+
923
+ # Restore the page body to a prior snapshot (rollback is itself snapshotted, so it is undoable)
924
+ synthadoc lifecycle rollback <slug> --index 2 --reason "restoring original body" -w my-wiki
925
+
926
+ # Purge old lifecycle events to reclaim audit.db space
927
+ synthadoc audit lifecycle purge -w my-wiki --before 2026-01-01
928
+ synthadoc audit lifecycle purge -w my-wiki --keep-latest 100
929
+ ```
930
+
931
+ Synthadoc captures the page body in three situations: a manual lifecycle transition
932
+ (activate, archive, restore), a lint-driven auto-transition (stale detection, contradiction
933
+ auto-resolve, draft promotion), or a file save detected by the Obsidian plugin (2 s debounce,
934
+ deduplicated — unchanged saves cost nothing). Use `synthadoc lifecycle history <slug>` to
935
+ browse snapshots and `synthadoc lifecycle rollback <slug> --index N --reason "..."` to
936
+ restore any prior version — the rollback itself is recorded as an auditable event so it can be undone.
937
+
938
+ ### Monitoring jobs
939
+
940
+ ```bash
941
+ # List all jobs (oldest first by default)
942
+ synthadoc jobs list -w my-wiki
943
+
944
+ # Sort column — created_at (default) | status | operation
945
+ synthadoc jobs list --sort created_at -w my-wiki # oldest first (default)
946
+ synthadoc jobs list --sort status -w my-wiki # alphabetical by status
947
+ synthadoc jobs list --sort operation -w my-wiki # alphabetical by operation type
948
+
949
+ # Sort direction — asc (default) | desc
950
+ synthadoc jobs list --order desc -w my-wiki # newest first
951
+ synthadoc jobs list --sort status --order desc -w my-wiki # status Z→A
952
+
953
+ # Filter by status — pending | in_progress | completed | failed | skipped | dead | cancelled
954
+ synthadoc jobs list --status pending -w my-wiki
955
+ synthadoc jobs list --status failed -w my-wiki
956
+ synthadoc jobs list --status dead -w my-wiki
957
+
958
+ # Combine sort, order, and status freely
959
+ synthadoc jobs list --status failed --sort created_at --order desc -w my-wiki
960
+
961
+ # Single job detail
962
+ synthadoc jobs status <job-id> -w my-wiki
963
+
964
+ # Retry a dead job
965
+ synthadoc jobs retry <job-id> -w my-wiki
966
+
967
+ # Cancel all pending jobs at once (e.g. after a bad batch ingest)
968
+ synthadoc jobs cancel -w my-wiki # prompts for confirmation
969
+ synthadoc jobs cancel --yes -w my-wiki # skip confirmation
970
+
971
+ # Remove old records
972
+ synthadoc jobs purge --older-than 30 -w my-wiki
973
+ ```
974
+
975
+ ### Inspecting ingest results
976
+
977
+ ```bash
978
+ # Preview how a source will be analysed without writing pages
979
+ synthadoc ingest report.pdf --analyse-only -w my-wiki
980
+ # → {"entities": [...], "tags": [...], "summary": "..."}
981
+ ```
982
+
983
+ ### Audit trail
984
+
985
+ ```bash
986
+ # Ingest history: timestamp, source file, wiki page, tokens, cost
987
+ synthadoc audit history -w my-wiki # last 50 records (shows total)
988
+ synthadoc audit history -n 100 -w my-wiki # last 100 records
989
+ synthadoc audit history -n 50 --offset 50 -w my-wiki # page 2 (records 51-100)
990
+ synthadoc audit history --json -w my-wiki # raw JSON for scripting
991
+
992
+ # Query history: question, sub-questions, tokens, cost
993
+ synthadoc audit queries -w my-wiki # last 50 records (shows total)
994
+ synthadoc audit queries -n 100 -w my-wiki # last 100 records
995
+ synthadoc audit queries -n 50 --offset 50 -w my-wiki # page 2 (records 51-100)
996
+ synthadoc audit queries --json -w my-wiki # raw JSON for scripting
997
+
998
+ # Token usage: totals + daily breakdown
999
+ synthadoc audit cost -w my-wiki # last 30 days
1000
+ synthadoc audit cost --days 7 -w my-wiki # last 7 days
1001
+
1002
+ # Audit events: contradictions found, auto-resolutions, cost gate triggers
1003
+ synthadoc audit events -w my-wiki # last 100 events (shows total)
1004
+ synthadoc audit events -n 100 --offset 100 -w my-wiki # page 2 (events 101-200)
1005
+ synthadoc audit events --json -w my-wiki # raw JSON for scripting
1006
+
1007
+ # Claim citations: source-line provenance for every annotated claim
1008
+ synthadoc audit citations -w my-wiki # all citations (last 50)
1009
+ synthadoc audit citations --page alan-turing -w my-wiki # citations for one page
1010
+ synthadoc audit citations --source turing.pdf -w my-wiki # citations from one source
1011
+ synthadoc audit citations --broken -w my-wiki # validation failures only
1012
+ synthadoc audit citations --json -w my-wiki # raw JSON for scripting
1013
+ ```
1014
+
1015
+ **Audit citation faithfulness**
1016
+ ```bash
1017
+ synthadoc audit citations --faithfulness # all active pages
1018
+ synthadoc audit citations --faithfulness --page SLUG # single page
1019
+ synthadoc audit citations --faithfulness --force # re-run even if cache is fresh
1020
+ synthadoc audit citations --faithfulness --yes # skip cost prompt (e.g. in CI)
1021
+ synthadoc audit citations --faithfulness --json # machine-readable output
1022
+ # Results cached per-page; Obsidian tab shows cached results instantly on open
1023
+ ```
1024
+
1025
+ ### Scheduling recurring jobs
1026
+
1027
+ Relative paths in `--op` (e.g. `raw_sources/`) are resolved against the **wiki root directory**, not the working directory of the shell that runs the schedule. This means they work correctly even when the OS scheduler fires the task with a different working directory (e.g. `C:\Windows\System32` on Windows).
1028
+
1029
+ ```bash
1030
+ # Register a nightly ingest
1031
+ synthadoc schedule add --op "ingest --batch raw_sources/" --cron "0 2 * * *" -w my-wiki
1032
+
1033
+ # Weekly lint
1034
+ synthadoc schedule add --op "lint run" --cron "0 3 * * 0" -w my-wiki
1035
+
1036
+ # Bulk-register all jobs declared in [[schedule.jobs]] in config.toml (alternative to schedule add)
1037
+ # See docs/design.md § "schedule sub-commands" for the config.toml format
1038
+ synthadoc schedule apply -w my-wiki
1039
+
1040
+ # List scheduled jobs (shows schedule, next run, last run, last result)
1041
+ synthadoc schedule list -w my-wiki
1042
+
1043
+ # Remove a scheduled job
1044
+ synthadoc schedule remove <id> -w my-wiki
1045
+
1046
+ # Run a scheduled operation immediately and record the result in the audit trail
1047
+ synthadoc schedule run --op "lint run" -w my-wiki
1048
+
1049
+ # Show recent scheduled run history
1050
+ synthadoc schedule history -w my-wiki
1051
+ synthadoc schedule history --limit 50 -w my-wiki
1052
+ ```
1053
+
1054
+ **Cron expression format:** `minute hour day-of-month month day-of-week`
1055
+
1056
+ | Field | Range | Examples |
1057
+ | ------------ | ----- | -------------------------- |
1058
+ | minute | 0–59 | `0` = on the hour |
1059
+ | hour | 0–23 | `2` = 2 AM, `22` = 10 PM |
1060
+ | day of month | 1–31 | `*` = every day |
1061
+ | month | 1–12 | `*` = every month |
1062
+ | day of week | 0–6 | `0` = Sunday, `1` = Monday |
1063
+
1064
+ Common schedules:
1065
+
1066
+ | Expression | Meaning |
1067
+ | -------------- | -------------------- |
1068
+ | `0 2 * * *` | Every day at 2 AM |
1069
+ | `0 22 * * *` | Every night at 10 PM |
1070
+ | `0 3 * * 0` | Every Sunday at 3 AM |
1071
+ | `0 */6 * * *` | Every 6 hours |
1072
+ | `30 8 * * 1-5` | Weekdays at 8:30 AM |
1073
+
1074
+ ### Routing
1075
+
1076
+ ROUTING.md maps wiki branches to page slugs so queries and ingest jobs are scoped to the relevant section of the wiki. Create it once from your existing `index.md`, then let Synthadoc maintain it automatically as new pages are added.
1077
+
1078
+ ```bash
1079
+ # Bootstrap ROUTING.md from current index.md branch structure (run once)
1080
+ synthadoc routing init -w my-wiki
1081
+
1082
+ # Report dangling slugs (pages listed in ROUTING.md that no longer exist)
1083
+ synthadoc routing validate -w my-wiki
1084
+
1085
+ # Auto-remove dangling slugs from ROUTING.md
1086
+ synthadoc routing clean -w my-wiki
1087
+ ```
1088
+
1089
+ ### Candidates staging
1090
+
1091
+ When staging is enabled, ingest writes new pages to `wiki/candidates/` for human review instead of the main wiki. Useful when you want to approve AI-generated pages before they become canonical.
1092
+
1093
+ ```bash
1094
+ # Show current staging policy
1095
+ synthadoc staging policy -w my-wiki
1096
+
1097
+ # Route all new pages to staging (review everything)
1098
+ synthadoc staging policy all -w my-wiki
1099
+
1100
+ # Only stage pages below a confidence threshold (auto-promote high-confidence)
1101
+ synthadoc staging policy threshold --min-confidence high -w my-wiki
1102
+
1103
+ # Turn staging off (pages go directly to wiki/)
1104
+ synthadoc staging policy off -w my-wiki
1105
+
1106
+ # List candidate pages awaiting review
1107
+ synthadoc candidates list -w my-wiki
1108
+
1109
+ # Promote a specific page (moves it from candidates/ to wiki/)
1110
+ synthadoc candidates promote my-page-slug -w my-wiki
1111
+
1112
+ # Promote all candidates at once
1113
+ synthadoc candidates promote --all -w my-wiki
1114
+
1115
+ # Discard a specific candidate
1116
+ synthadoc candidates discard my-page-slug -w my-wiki
1117
+
1118
+ # Discard all candidates
1119
+ synthadoc candidates discard --all -w my-wiki
1120
+ ```
1121
+
1122
+ ### Context packs
1123
+
1124
+ A context pack decomposes a goal into sub-questions, runs parallel BM25 searches, and packs the highest-scoring excerpts into a single cited Markdown document within a token budget.
1125
+
1126
+ **Typical use cases:**
1127
+
1128
+ - Paste into an external LLM chat (Claude.ai, ChatGPT) as grounded context before asking a question
1129
+ - Save next to a document you are writing as a cited research brief
1130
+ - Pipe into another CLI tool that reads Markdown
1131
+
1132
+ ```bash
1133
+ # Print to terminal — inspect, copy, or pipe
1134
+ synthadoc context build "How did transistors change computing?" -w my-wiki
1135
+
1136
+ # Copy to clipboard and paste into an LLM chat (macOS)
1137
+ synthadoc context build "early computing pioneers" -w my-wiki | pbcopy
1138
+
1139
+ # Custom token budget (default 4000)
1140
+ synthadoc context build "Early programming languages" --tokens 8000 -w my-wiki
1141
+
1142
+ # Save next to a document you are writing
1143
+ synthadoc context build "Rise of microprocessors" --output ~/drafts/computing-brief.md -w my-wiki
1144
+ ```
1145
+
1146
+ ### Exporting
1147
+
1148
+ Export your wiki in machine-readable formats for RAG pipelines, LLM context windows, graph analysis tools, and OKF-compliant agents. All formats are assembled server-side with zero additional LLM calls. Requires `synthadoc serve` to be running.
1149
+
1150
+ ```bash
1151
+ # Active pages as LLM context (llms.txt spec)
1152
+ synthadoc export --format llms.txt --status active -w my-wiki
1153
+
1154
+ # Full content dump with provenance footnotes preserved
1155
+ synthadoc export --format llms-full.txt --output exports/wiki-full.txt -w my-wiki
1156
+
1157
+ # Export wikilink graph as GraphML — open in yEd, Gephi, or Cytoscape
1158
+ synthadoc export --format graphml --output exports/wiki.graphml -w my-wiki
1159
+
1160
+ # Agent-ready JSON with provenance, lifecycle history, and compilation cost
1161
+ synthadoc export --format json --output exports/wiki.json -w my-wiki
1162
+
1163
+ # OKF v0.1 bundle — consumable by any OKF-aware agent without code changes
1164
+ # Write outside the wiki folder to avoid Obsidian picking up bundle files as source
1165
+ synthadoc export --format okf --output ~/exports/my-wiki-okf/ -w my-wiki
1166
+ ```
1167
+
1168
+ **Flags:** `--format/-f` (required: `llms.txt`, `llms-full.txt`, `graphml`, `json`, `okf`), `--output/-o` (file path, or directory for `okf`; omit for stdout), `--status/-s` (`all`/`active`/`draft`/`stale`/`contradicted`/`archived`).
1169
+
1170
+ > **OKF export requires `--output`** — the bundle is a directory tree, not a single file.
1171
+
1172
+ > **OKF default pages:** `--format okf` with `--status all` (the default) includes only `active` and `contradicted` pages. Draft and stale are excluded — they carry unverified content. Contradicted pages appear with `status: contradicted` in their frontmatter and a `> **Contradiction:** …` blockquote in the body.
1173
+
1174
+ > **Tip:** Keep the OKF bundle **outside** your wiki folder. The output path can be any absolute or relative path — `--output ~/exports/my-wiki-okf/` or `--output ../okf-bundles/my-wiki/` both work. Placing it inside the wiki folder risks Obsidian or the ingestor picking up the bundle files as source documents.
1175
+
1176
+ In Obsidian: command palette → **Synthadoc: Export Wiki** — choose format and status filter, then click **Export**. For all formats except `okf`, the file is saved to the vault's `exports/` folder and opened automatically. For `okf`, the output path defaults to `~/exports/{vault-name}-okf-{date}/` outside the vault and is written via the filesystem. For GraphML, a **View Graph** button renders an inline preview.
1177
+
1178
+ ### Backup & Restore
1179
+
1180
+ ```bash
1181
+ # Backup to the current directory
1182
+ synthadoc backup -w my-wiki
1183
+
1184
+ # Backup to a specific directory, excluding raw source files to reduce size
1185
+ synthadoc backup -w my-wiki --output ~/backups --no-sources
1186
+
1187
+ # Restore to the same folder as the zip (default)
1188
+ synthadoc restore synthadoc-backup-my-wiki-20260624-103000.zip
1189
+
1190
+ # Restore under a different name to a specific location on a specific port
1191
+ synthadoc restore backup.zip --name my-wiki-staging --target ~/wikis --port 7071
1192
+ ```
1193
+
1194
+ → Flags, use-case table, what is and isn't backed up, and post-restore checklist: [Quick-Start Guide — Appendix J](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-j--backup--restore)
1195
+
1196
+ ### Removing a wiki
1197
+
1198
+ Stop the server for that wiki before uninstalling — the serve process must not be running
1199
+ when the directory is deleted.
1200
+
1201
+ ```bash
1202
+ # Stop the background server (PID is in <wiki-root>/.synthadoc/server.pid)
1203
+ kill $(cat ~/wikis/my-wiki/.synthadoc/server.pid) # Linux / macOS
1204
+ taskkill /PID <pid> /F # Windows
1205
+
1206
+ # Then uninstall — two-step confirmation required, no --yes escape
1207
+ synthadoc uninstall my-wiki
1208
+ ```
1209
+
1210
+ For Obsidian plugin commands see [Appendix A — Obsidian Plugin Command Reference](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-a--obsidian-plugin-commands) in the Quick-Start Guide.
1211
+
1212
+ ---
1213
+
1214
+ ## Administrative Reference
1215
+
1216
+ ### Health and status
1217
+
1218
+ ```bash
1219
+ # Wiki statistics: pages, queue depth, cache hit rate
1220
+ synthadoc status -w my-wiki
1221
+
1222
+ # Liveness probe (useful in scripts and monitoring)
1223
+ # Port is per-wiki — check [server] port in <wiki-root>/.synthadoc/config.toml
1224
+ # Default is 7070; each additional wiki uses its own port (7071, 7072, …)
1225
+ curl http://127.0.0.1:7070/health
1226
+ ```
1227
+
1228
+ Expected `status` output:
1229
+
1230
+ ```
1231
+ Wiki: /home/user/wikis/my-wiki
1232
+ Pages: 34
1233
+ active 34
1234
+ draft 0
1235
+ stale 0
1236
+ contradicted 0
1237
+ archived 0
1238
+ Jobs pending: 0
1239
+ Jobs total: 12
1240
+ ```
1241
+
1242
+ ### Logs
1243
+
1244
+ Synthadoc writes three log artefacts per wiki:
1245
+
1246
+ | File | Location | Format | Use |
1247
+ | --------------- | --------------------------------- | ----------------------- | ------------------------------------------------------------------- |
1248
+ | `log.md` | `<wiki-root>/log.md` | Human-readable Markdown | Read inside Obsidian; shows every ingest, contradiction, lint event |
1249
+ | `synthadoc.log` | `<wiki-root>/.synthadoc/logs/` | JSON lines (rotating) | Structured debug/ops log; grep or pipe to jq |
1250
+ | `audit.db` | `<wiki-root>/.synthadoc/audit.db` | SQLite (append-only) | Source hashes, cost records, job history |
1251
+
1252
+ **Tailing the JSON log:**
1253
+
1254
+ ```bash
1255
+ # Tail and pretty-print with jq
1256
+ tail -f .synthadoc/logs/synthadoc.log | jq .
1257
+
1258
+ # Filter to errors only
1259
+ tail -f .synthadoc/logs/synthadoc.log | jq 'select(.level == "ERROR")'
1260
+
1261
+ # Filter to a specific job
1262
+ # job_id is present only on records logged in job context (ingest/lint workers)
1263
+ tail -f .synthadoc/logs/synthadoc.log | jq 'select(.job_id == "abc123")'
1264
+ ```
1265
+
1266
+ **Log rotation:** When `synthadoc.log` reaches `max_file_mb`, it is renamed to `synthadoc.log.1`; the previous `.1` becomes `.2`; files beyond `backup_count` are deleted. Total disk ≈ `max_file_mb × (backup_count + 1)`.
1267
+
1268
+ **Changing log level at runtime:** Edit `[logs] level` in `.synthadoc/config.toml` and restart `synthadoc serve`. Or pass `--verbose` to get `DEBUG` for one session without editing config.
1269
+
1270
+ ### Audit trail
1271
+
1272
+ ```bash
1273
+ synthadoc audit history -w my-wiki # table: timestamp, source file, wiki page, tokens, cost
1274
+ synthadoc audit history -n 100 -w my-wiki # last 100 records (default 50)
1275
+ synthadoc audit history --json -w my-wiki # raw JSON for scripting
1276
+
1277
+ synthadoc audit cost -w my-wiki # total tokens + daily breakdown, last 30 days
1278
+ synthadoc audit cost --days 7 -w my-wiki # weekly view
1279
+ synthadoc audit cost --json -w my-wiki # {total_tokens, total_cost_usd, daily: [...]}
1280
+
1281
+ synthadoc audit events -w my-wiki # table: timestamp, job_id, event type, metadata
1282
+ synthadoc audit events --json -w my-wiki # raw JSON
1283
+
1284
+ synthadoc audit citations -w my-wiki # all claim citations (last 50)
1285
+ synthadoc audit citations --page alan-turing -w my-wiki # citations for one page
1286
+ synthadoc audit citations --source turing.pdf -w my-wiki # citations from one source file
1287
+ synthadoc audit citations --broken -w my-wiki # validation failures only
1288
+ synthadoc audit citations --json -w my-wiki # raw JSON for scripting
1289
+ ```
1290
+
1291
+ > **Note:** Per-model cost tracking is live from v0.2.0 — pricing tables cover all 7 API providers. Token counts and USD cost are recorded for every ingest and query operation in `audit.db`.
1292
+
1293
+ > **Lifecycle transitions** are also recorded in `audit.db` — every state change (slug, from/to state, triggered_by, reason, timestamp) is permanently stored as an immutable audit event. Query the log with `synthadoc lifecycle log` or `GET /lifecycle/events`.
1294
+
1295
+ ### Cache management
1296
+
1297
+ ```bash
1298
+ # Remove all cached LLM responses
1299
+ # Output: "Cache cleared: N entries removed."
1300
+ synthadoc cache clear -w my-wiki
1301
+ ```
1302
+
1303
+ Cache invalidation happens automatically when:
1304
+
1305
+ - A source file's SHA-256 hash changes (content changed)
1306
+ - The internal cache version is bumped (after prompt template edits)
1307
+ - `--force` is passed to ingest
1308
+
1309
+ ### OpenTelemetry integration
1310
+
1311
+ By default, traces and metrics are written to `<wiki-root>/.synthadoc/logs/traces.jsonl`. To send to any OTLP backend (Jaeger, Grafana Tempo, Honeycomb, Datadog):
1312
+
1313
+ ```toml
1314
+ # ~/.synthadoc/config.toml
1315
+ [observability]
1316
+ exporter = "otlp"
1317
+ otlp_endpoint = "http://localhost:4317"
1318
+ ```
1319
+
1320
+ ### Debugging
1321
+
1322
+ ```bash
1323
+ # Start server with DEBUG console logging
1324
+ synthadoc serve -w my-wiki --verbose
1325
+
1326
+ # Check for configuration problems
1327
+ synthadoc status -w my-wiki # prints pre-flight warnings
1328
+
1329
+ # View recent job failures
1330
+ synthadoc jobs list --status failed -w my-wiki
1331
+ synthadoc jobs status <job-id> -w my-wiki # shows error message + traceback
1332
+
1333
+ # Force a re-ingest to rule out cache issues
1334
+ synthadoc ingest --force problem.pdf -w my-wiki
1335
+ ```
1336
+
1337
+ ---
1338
+
1339
+ ## Understanding Logs and the Audit Trail
1340
+
1341
+ Synthadoc writes three log artefacts per wiki: `log.md` (human-readable Markdown, open in Obsidian), `synthadoc.log` (JSON lines, rotate-by-size, grep with `jq`), and `audit.db` (append-only SQLite — source hashes, cost records, job history).
1342
+
1343
+ For the full field reference, log levels, rotation config, OTel integration, and audit query examples see [docs/design.md — Logs and Audit Trail](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#logs-and-audit-trail).
1344
+
1345
+ ---
1346
+
1347
+ ## Customization
1348
+
1349
+ Custom skills, LLM providers, hooks, cache control, and per-wiki AGENTS.md are documented in [docs/design.md — Customization](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#customization).
1350
+
1351
+ ---
1352
+
1353
+ ## Links
1354
+
1355
+ - Design document: [docs/design.md](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md)
1356
+ - Customization: [docs/design.md — Customization](https://github.com/axoviq-ai/synthadoc/blob/main/docs/design.md#customization)
1357
+ - Quick-Start Guide: [docs/user-quick-start-guide.md](https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md)
1358
+
1359
+ - GitHub: [axoviq-ai/synthadoc](https://github.com/axoviq-ai/synthadoc)