@proflandrigan/shards 1.1.0

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 (397) hide show
  1. package/README.md +475 -0
  2. package/package.json +37 -0
  3. package/src/agents/academic.md +276 -0
  4. package/src/agents/ai-engineer.md +377 -0
  5. package/src/agents/analytics-engineer.md +364 -0
  6. package/src/agents/applied-ml-scientist.md +410 -0
  7. package/src/agents/backend-engineer.md +255 -0
  8. package/src/agents/bi-engineer.md +333 -0
  9. package/src/agents/data-analyst.md +343 -0
  10. package/src/agents/data-engineer.md +260 -0
  11. package/src/agents/data-modeller.md +386 -0
  12. package/src/agents/data-scientist.md +366 -0
  13. package/src/agents/deep-learning-engineer.md +389 -0
  14. package/src/agents/ml-engineer.md +424 -0
  15. package/src/agents/mlops-engineer.md +339 -0
  16. package/src/agents/researcher.md +187 -0
  17. package/src/agents/specific_instructions/academic/critical_review.md +263 -0
  18. package/src/agents/specific_instructions/academic/report.md +113 -0
  19. package/src/agents/specific_instructions/ai_engineer/advise.md +162 -0
  20. package/src/agents/specific_instructions/ai_engineer/bi_engineer_handoff.md +86 -0
  21. package/src/agents/specific_instructions/ai_engineer/experiment.md +471 -0
  22. package/src/agents/specific_instructions/ai_engineer/experiment_ui_mode.md +44 -0
  23. package/src/agents/specific_instructions/ai_engineer/phases/index.md +45 -0
  24. package/src/agents/specific_instructions/ai_engineer/phases/phase-1.md +55 -0
  25. package/src/agents/specific_instructions/ai_engineer/phases/phase-2.md +86 -0
  26. package/src/agents/specific_instructions/ai_engineer/phases/phase-3.md +96 -0
  27. package/src/agents/specific_instructions/ai_engineer/phases/phase-4.md +138 -0
  28. package/src/agents/specific_instructions/ai_engineer/phases/phase-5.md +157 -0
  29. package/src/agents/specific_instructions/ai_engineer/phases/phase-6.md +196 -0
  30. package/src/agents/specific_instructions/ai_engineer/phases/phase-7.md +313 -0
  31. package/src/agents/specific_instructions/ai_engineer/phases.md +1011 -0
  32. package/src/agents/specific_instructions/ai_engineer/prompt_lab.md +161 -0
  33. package/src/agents/specific_instructions/ai_engineer/prompt_lab_ui_mode.md +28 -0
  34. package/src/agents/specific_instructions/ai_engineer/research.md +393 -0
  35. package/src/agents/specific_instructions/ai_engineer/research_ui_mode.md +66 -0
  36. package/src/agents/specific_instructions/ai_engineer/review.md +159 -0
  37. package/src/agents/specific_instructions/ai_engineer/validation_checklist.md +182 -0
  38. package/src/agents/specific_instructions/analytics_engineer/advise.md +155 -0
  39. package/src/agents/specific_instructions/analytics_engineer/bi_engineer_handoff.md +91 -0
  40. package/src/agents/specific_instructions/analytics_engineer/data_analyst_handoff.md +84 -0
  41. package/src/agents/specific_instructions/analytics_engineer/deep_phases.md +818 -0
  42. package/src/agents/specific_instructions/analytics_engineer/phases_deep/index.md +24 -0
  43. package/src/agents/specific_instructions/analytics_engineer/phases_deep/phase-1.md +77 -0
  44. package/src/agents/specific_instructions/analytics_engineer/phases_deep/phase-2.md +106 -0
  45. package/src/agents/specific_instructions/analytics_engineer/phases_deep/phase-3.md +93 -0
  46. package/src/agents/specific_instructions/analytics_engineer/phases_deep/phase-4.md +79 -0
  47. package/src/agents/specific_instructions/analytics_engineer/phases_deep/phase-5.md +61 -0
  48. package/src/agents/specific_instructions/analytics_engineer/phases_deep/phase-6.md +45 -0
  49. package/src/agents/specific_instructions/analytics_engineer/phases_deep/phase-7.md +235 -0
  50. package/src/agents/specific_instructions/analytics_engineer/phases_deep/phase-8.md +221 -0
  51. package/src/agents/specific_instructions/analytics_engineer/phases_quick/index.md +19 -0
  52. package/src/agents/specific_instructions/analytics_engineer/phases_quick/phase-1.md +47 -0
  53. package/src/agents/specific_instructions/analytics_engineer/phases_quick/phase-2.md +78 -0
  54. package/src/agents/specific_instructions/analytics_engineer/quick_phases.md +112 -0
  55. package/src/agents/specific_instructions/analytics_engineer/review.md +167 -0
  56. package/src/agents/specific_instructions/analytics_engineer/service_mode.md +369 -0
  57. package/src/agents/specific_instructions/analytics_engineer/ui_mode.md +45 -0
  58. package/src/agents/specific_instructions/analytics_engineer/update.md +162 -0
  59. package/src/agents/specific_instructions/analytics_engineer/validation_checklist.md +121 -0
  60. package/src/agents/specific_instructions/applied_ml_scientist/advise.md +143 -0
  61. package/src/agents/specific_instructions/applied_ml_scientist/phases/index.md +21 -0
  62. package/src/agents/specific_instructions/applied_ml_scientist/phases/phase-1.md +51 -0
  63. package/src/agents/specific_instructions/applied_ml_scientist/phases/phase-2.md +66 -0
  64. package/src/agents/specific_instructions/applied_ml_scientist/phases/phase-3.md +113 -0
  65. package/src/agents/specific_instructions/applied_ml_scientist/phases/phase-4.md +104 -0
  66. package/src/agents/specific_instructions/applied_ml_scientist/phases/phase-5.md +156 -0
  67. package/src/agents/specific_instructions/applied_ml_scientist/phases.md +428 -0
  68. package/src/agents/specific_instructions/applied_ml_scientist/research.md +379 -0
  69. package/src/agents/specific_instructions/applied_ml_scientist/review.md +142 -0
  70. package/src/agents/specific_instructions/applied_ml_scientist/validation_checklist.md +136 -0
  71. package/src/agents/specific_instructions/backend_engineer/clean.md +149 -0
  72. package/src/agents/specific_instructions/backend_engineer/review.md +91 -0
  73. package/src/agents/specific_instructions/backend_engineer/review_checklist.md +54 -0
  74. package/src/agents/specific_instructions/backend_engineer/service_mode.md +67 -0
  75. package/src/agents/specific_instructions/bi_engineer/advise.md +137 -0
  76. package/src/agents/specific_instructions/bi_engineer/data_analyst_handoff.md +77 -0
  77. package/src/agents/specific_instructions/bi_engineer/incoming_handoff.md +45 -0
  78. package/src/agents/specific_instructions/bi_engineer/phases/index.md +20 -0
  79. package/src/agents/specific_instructions/bi_engineer/phases/phase-1.md +164 -0
  80. package/src/agents/specific_instructions/bi_engineer/phases/phase-2.md +92 -0
  81. package/src/agents/specific_instructions/bi_engineer/phases/phase-3.md +121 -0
  82. package/src/agents/specific_instructions/bi_engineer/phases/phase-4.md +106 -0
  83. package/src/agents/specific_instructions/bi_engineer/phases.md +451 -0
  84. package/src/agents/specific_instructions/bi_engineer/review.md +166 -0
  85. package/src/agents/specific_instructions/bi_engineer/update.md +147 -0
  86. package/src/agents/specific_instructions/bi_engineer/validation_checklist.md +124 -0
  87. package/src/agents/specific_instructions/data_analyst/advise.md +138 -0
  88. package/src/agents/specific_instructions/data_analyst/explain.md +221 -0
  89. package/src/agents/specific_instructions/data_analyst/incoming_handoff.md +40 -0
  90. package/src/agents/specific_instructions/data_analyst/phases/index.md +20 -0
  91. package/src/agents/specific_instructions/data_analyst/phases/phase-1.md +159 -0
  92. package/src/agents/specific_instructions/data_analyst/phases/phase-2.md +112 -0
  93. package/src/agents/specific_instructions/data_analyst/phases/phase-3.md +265 -0
  94. package/src/agents/specific_instructions/data_analyst/phases/phase-4.md +100 -0
  95. package/src/agents/specific_instructions/data_analyst/phases.md +501 -0
  96. package/src/agents/specific_instructions/data_analyst/review.md +138 -0
  97. package/src/agents/specific_instructions/data_analyst/ui_mode.md +26 -0
  98. package/src/agents/specific_instructions/data_analyst/update.md +144 -0
  99. package/src/agents/specific_instructions/data_analyst/validation_checklist.md +95 -0
  100. package/src/agents/specific_instructions/data_engineer/advise.md +137 -0
  101. package/src/agents/specific_instructions/data_engineer/phases.md +466 -0
  102. package/src/agents/specific_instructions/data_engineer/phases_deep/index.md +23 -0
  103. package/src/agents/specific_instructions/data_engineer/phases_deep/phase-1.md +49 -0
  104. package/src/agents/specific_instructions/data_engineer/phases_deep/phase-2.md +93 -0
  105. package/src/agents/specific_instructions/data_engineer/phases_deep/phase-3.md +55 -0
  106. package/src/agents/specific_instructions/data_engineer/phases_deep/phase-4.md +48 -0
  107. package/src/agents/specific_instructions/data_engineer/phases_deep/phase-5.md +40 -0
  108. package/src/agents/specific_instructions/data_engineer/phases_deep/phase-6.md +102 -0
  109. package/src/agents/specific_instructions/data_engineer/phases_deep/phase-7.md +87 -0
  110. package/src/agents/specific_instructions/data_engineer/phases_quick/index.md +19 -0
  111. package/src/agents/specific_instructions/data_engineer/phases_quick/phase-1.md +45 -0
  112. package/src/agents/specific_instructions/data_engineer/phases_quick/phase-2.md +54 -0
  113. package/src/agents/specific_instructions/data_engineer/review.md +135 -0
  114. package/src/agents/specific_instructions/data_engineer/validation_checklist.md +136 -0
  115. package/src/agents/specific_instructions/data_modeller/advise.md +137 -0
  116. package/src/agents/specific_instructions/data_modeller/phases.md +581 -0
  117. package/src/agents/specific_instructions/data_modeller/phases_deep/index.md +23 -0
  118. package/src/agents/specific_instructions/data_modeller/phases_deep/phase-1.md +52 -0
  119. package/src/agents/specific_instructions/data_modeller/phases_deep/phase-2.md +113 -0
  120. package/src/agents/specific_instructions/data_modeller/phases_deep/phase-3.md +47 -0
  121. package/src/agents/specific_instructions/data_modeller/phases_deep/phase-4.md +51 -0
  122. package/src/agents/specific_instructions/data_modeller/phases_deep/phase-5.md +45 -0
  123. package/src/agents/specific_instructions/data_modeller/phases_deep/phase-6.md +105 -0
  124. package/src/agents/specific_instructions/data_modeller/phases_deep/phase-7.md +136 -0
  125. package/src/agents/specific_instructions/data_modeller/phases_quick/index.md +19 -0
  126. package/src/agents/specific_instructions/data_modeller/phases_quick/phase-1.md +47 -0
  127. package/src/agents/specific_instructions/data_modeller/phases_quick/phase-2.md +65 -0
  128. package/src/agents/specific_instructions/data_modeller/review.md +141 -0
  129. package/src/agents/specific_instructions/data_modeller/service_mode.md +218 -0
  130. package/src/agents/specific_instructions/data_modeller/validation_checklist.md +125 -0
  131. package/src/agents/specific_instructions/data_scientist/advise.md +158 -0
  132. package/src/agents/specific_instructions/data_scientist/bi_engineer_handoff.md +63 -0
  133. package/src/agents/specific_instructions/data_scientist/experiment.md +482 -0
  134. package/src/agents/specific_instructions/data_scientist/experiment_ui_mode.md +44 -0
  135. package/src/agents/specific_instructions/data_scientist/explain.md +247 -0
  136. package/src/agents/specific_instructions/data_scientist/greenfield_data.md +35 -0
  137. package/src/agents/specific_instructions/data_scientist/ml_engineer_handoff.md +52 -0
  138. package/src/agents/specific_instructions/data_scientist/notebook_walkthrough.md +76 -0
  139. package/src/agents/specific_instructions/data_scientist/phases/index.md +24 -0
  140. package/src/agents/specific_instructions/data_scientist/phases/phase-1.md +45 -0
  141. package/src/agents/specific_instructions/data_scientist/phases/phase-2.md +67 -0
  142. package/src/agents/specific_instructions/data_scientist/phases/phase-3.md +89 -0
  143. package/src/agents/specific_instructions/data_scientist/phases/phase-4.md +143 -0
  144. package/src/agents/specific_instructions/data_scientist/phases/phase-5.md +71 -0
  145. package/src/agents/specific_instructions/data_scientist/phases/phase-6.md +239 -0
  146. package/src/agents/specific_instructions/data_scientist/phases/phase-7.md +207 -0
  147. package/src/agents/specific_instructions/data_scientist/phases.md +651 -0
  148. package/src/agents/specific_instructions/data_scientist/research.md +345 -0
  149. package/src/agents/specific_instructions/data_scientist/research_ui_mode.md +52 -0
  150. package/src/agents/specific_instructions/data_scientist/review.md +136 -0
  151. package/src/agents/specific_instructions/data_scientist/service_mode.md +247 -0
  152. package/src/agents/specific_instructions/data_scientist/validation_checklist.md +183 -0
  153. package/src/agents/specific_instructions/deep_learning_engineer/advise.md +145 -0
  154. package/src/agents/specific_instructions/deep_learning_engineer/phases/index.md +21 -0
  155. package/src/agents/specific_instructions/deep_learning_engineer/phases/phase-1.md +74 -0
  156. package/src/agents/specific_instructions/deep_learning_engineer/phases/phase-2.md +98 -0
  157. package/src/agents/specific_instructions/deep_learning_engineer/phases/phase-3.md +76 -0
  158. package/src/agents/specific_instructions/deep_learning_engineer/phases/phase-4.md +128 -0
  159. package/src/agents/specific_instructions/deep_learning_engineer/phases/phase-5.md +292 -0
  160. package/src/agents/specific_instructions/deep_learning_engineer/phases.md +567 -0
  161. package/src/agents/specific_instructions/deep_learning_engineer/research.md +389 -0
  162. package/src/agents/specific_instructions/deep_learning_engineer/review.md +155 -0
  163. package/src/agents/specific_instructions/deep_learning_engineer/validation_checklist.md +147 -0
  164. package/src/agents/specific_instructions/ml_engineer/advise.md +174 -0
  165. package/src/agents/specific_instructions/ml_engineer/bi_engineer_handoff.md +71 -0
  166. package/src/agents/specific_instructions/ml_engineer/experiment.md +474 -0
  167. package/src/agents/specific_instructions/ml_engineer/experiment_ui_mode.md +44 -0
  168. package/src/agents/specific_instructions/ml_engineer/notebook_walkthrough.md +75 -0
  169. package/src/agents/specific_instructions/ml_engineer/phases/index.md +25 -0
  170. package/src/agents/specific_instructions/ml_engineer/phases/phase-1.md +49 -0
  171. package/src/agents/specific_instructions/ml_engineer/phases/phase-2.md +75 -0
  172. package/src/agents/specific_instructions/ml_engineer/phases/phase-3.md +124 -0
  173. package/src/agents/specific_instructions/ml_engineer/phases/phase-4.md +279 -0
  174. package/src/agents/specific_instructions/ml_engineer/phases/phase-5.md +160 -0
  175. package/src/agents/specific_instructions/ml_engineer/phases/phase-6-5.md +170 -0
  176. package/src/agents/specific_instructions/ml_engineer/phases/phase-6.md +295 -0
  177. package/src/agents/specific_instructions/ml_engineer/phases/phase-7.md +337 -0
  178. package/src/agents/specific_instructions/ml_engineer/phases.md +1068 -0
  179. package/src/agents/specific_instructions/ml_engineer/research.md +437 -0
  180. package/src/agents/specific_instructions/ml_engineer/research_ui_mode.md +71 -0
  181. package/src/agents/specific_instructions/ml_engineer/review.md +187 -0
  182. package/src/agents/specific_instructions/ml_engineer/service_mode.md +273 -0
  183. package/src/agents/specific_instructions/ml_engineer/validation_checklist.md +185 -0
  184. package/src/agents/specific_instructions/mlops_engineer/advise.md +139 -0
  185. package/src/agents/specific_instructions/mlops_engineer/phases/index.md +23 -0
  186. package/src/agents/specific_instructions/mlops_engineer/phases/phase-1.md +52 -0
  187. package/src/agents/specific_instructions/mlops_engineer/phases/phase-2.md +86 -0
  188. package/src/agents/specific_instructions/mlops_engineer/phases/phase-3.md +105 -0
  189. package/src/agents/specific_instructions/mlops_engineer/phases/phase-4.md +128 -0
  190. package/src/agents/specific_instructions/mlops_engineer/phases/phase-5.md +106 -0
  191. package/src/agents/specific_instructions/mlops_engineer/phases/phase-6.md +128 -0
  192. package/src/agents/specific_instructions/mlops_engineer/phases/phase-7.md +144 -0
  193. package/src/agents/specific_instructions/mlops_engineer/phases.md +671 -0
  194. package/src/agents/specific_instructions/mlops_engineer/review.md +164 -0
  195. package/src/agents/specific_instructions/mlops_engineer/service_mode.md +81 -0
  196. package/src/agents/specific_instructions/mlops_engineer/validation_checklist.md +151 -0
  197. package/src/agents/specific_instructions/researcher/critical_review.md +292 -0
  198. package/src/agents/specific_instructions/researcher/review_checklist.md +67 -0
  199. package/src/agents/specific_instructions/researcher/service_mode.md +224 -0
  200. package/src/agents/specific_instructions/shared/auto_verify_mode.md +141 -0
  201. package/src/agents/specific_instructions/shared/autonomous_research.md +1289 -0
  202. package/src/agents/specific_instructions/shared/behavioral_rules.md +36 -0
  203. package/src/agents/specific_instructions/shared/diverge_protocol.md +387 -0
  204. package/src/agents/specific_instructions/shared/engineering_guidelines.md +136 -0
  205. package/src/agents/specific_instructions/shared/experiment_versioning.md +184 -0
  206. package/src/agents/specific_instructions/shared/goal_mode.md +187 -0
  207. package/src/agents/specific_instructions/shared/incremental_testing.md +139 -0
  208. package/src/agents/specific_instructions/shared/intent_discovery.md +223 -0
  209. package/src/agents/specific_instructions/shared/join_path_protocol.md +168 -0
  210. package/src/agents/specific_instructions/shared/knowledge_checkpoint.md +83 -0
  211. package/src/agents/specific_instructions/shared/knowledge_harvest.md +220 -0
  212. package/src/agents/specific_instructions/shared/knowledge_retrieval.md +100 -0
  213. package/src/agents/specific_instructions/shared/notebook_walkthrough_protocol.md +367 -0
  214. package/src/agents/specific_instructions/shared/reviewer_verdict_protocol.md +74 -0
  215. package/src/agents/specific_instructions/shared/swarm_protocol.md +97 -0
  216. package/src/agents/specific_instructions/shared/validation_protocol.md +139 -0
  217. package/src/agents/specific_instructions/syn/arbiter.md +140 -0
  218. package/src/agents/specific_instructions/syn/brainstorm.md +550 -0
  219. package/src/agents/specific_instructions/syn/code_review.md +232 -0
  220. package/src/agents/specific_instructions/syn/diff.md +239 -0
  221. package/src/agents/specific_instructions/syn/final_review.md +65 -0
  222. package/src/agents/specific_instructions/syn/fixer.md +240 -0
  223. package/src/agents/specific_instructions/syn/free_form.md +130 -0
  224. package/src/agents/specific_instructions/syn/knowledge.md +468 -0
  225. package/src/agents/specific_instructions/syn/notebook_walkthrough.md +78 -0
  226. package/src/agents/specific_instructions/syn/panel_review.md +634 -0
  227. package/src/agents/specific_instructions/syn/pm.md +453 -0
  228. package/src/agents/specific_instructions/syn/pr_review.md +255 -0
  229. package/src/agents/specific_instructions/syn/slides.md +417 -0
  230. package/src/agents/syn.md +729 -0
  231. package/src/commands/academic.md +41 -0
  232. package/src/commands/ai-engineer.md +45 -0
  233. package/src/commands/analytics-engineer.md +48 -0
  234. package/src/commands/applied-ml-scientist.md +45 -0
  235. package/src/commands/backend-engineer.md +35 -0
  236. package/src/commands/bi-engineer.md +40 -0
  237. package/src/commands/brainstorm.md +24 -0
  238. package/src/commands/data-analyst.md +38 -0
  239. package/src/commands/data-engineer.md +37 -0
  240. package/src/commands/data-modeller.md +38 -0
  241. package/src/commands/data-scientist.md +38 -0
  242. package/src/commands/deep-learning-engineer.md +47 -0
  243. package/src/commands/end.md +49 -0
  244. package/src/commands/knowledge.md +24 -0
  245. package/src/commands/ml-engineer.md +42 -0
  246. package/src/commands/mlops-engineer.md +47 -0
  247. package/src/commands/notebook-walkthrough.md +58 -0
  248. package/src/commands/researcher.md +40 -0
  249. package/src/commands/resume.md +57 -0
  250. package/src/commands/review-pr.md +26 -0
  251. package/src/commands/shards-guide.md +41 -0
  252. package/src/commands/shards-ui.md +32 -0
  253. package/src/commands/shards.md +41 -0
  254. package/src/docs/01-getting-started/concepts.md +109 -0
  255. package/src/docs/01-getting-started/first-session.md +79 -0
  256. package/src/docs/01-getting-started/install.md +61 -0
  257. package/src/docs/02-agents/academic.md +71 -0
  258. package/src/docs/02-agents/ai-engineer.md +78 -0
  259. package/src/docs/02-agents/analytics-engineer.md +58 -0
  260. package/src/docs/02-agents/applied-ml-scientist.md +59 -0
  261. package/src/docs/02-agents/backend-engineer.md +58 -0
  262. package/src/docs/02-agents/bi-engineer.md +65 -0
  263. package/src/docs/02-agents/data-analyst.md +67 -0
  264. package/src/docs/02-agents/data-engineer.md +57 -0
  265. package/src/docs/02-agents/data-modeller.md +51 -0
  266. package/src/docs/02-agents/data-scientist.md +78 -0
  267. package/src/docs/02-agents/deep-learning-engineer.md +64 -0
  268. package/src/docs/02-agents/ml-engineer.md +80 -0
  269. package/src/docs/02-agents/mlops-engineer.md +59 -0
  270. package/src/docs/02-agents/overview.md +62 -0
  271. package/src/docs/02-agents/researcher.md +73 -0
  272. package/src/docs/02-agents/syn.md +88 -0
  273. package/src/docs/03-protocols/auto-verify.md +82 -0
  274. package/src/docs/03-protocols/autonomous-research.md +59 -0
  275. package/src/docs/03-protocols/behavioral-rules.md +35 -0
  276. package/src/docs/03-protocols/diverge.md +50 -0
  277. package/src/docs/03-protocols/engineering-guidelines.md +56 -0
  278. package/src/docs/03-protocols/experiment-versioning.md +38 -0
  279. package/src/docs/03-protocols/gate-pattern.md +65 -0
  280. package/src/docs/03-protocols/incremental-testing.md +68 -0
  281. package/src/docs/03-protocols/join-path.md +46 -0
  282. package/src/docs/03-protocols/knowledge-ledger.md +70 -0
  283. package/src/docs/03-protocols/reviewer-verdicts.md +39 -0
  284. package/src/docs/03-protocols/swarm.md +40 -0
  285. package/src/docs/03-protocols/validation.md +174 -0
  286. package/src/docs/04-ui/activity-bar.md +70 -0
  287. package/src/docs/04-ui/chat-pane.md +80 -0
  288. package/src/docs/04-ui/code-intel.md +62 -0
  289. package/src/docs/04-ui/file-editing.md +61 -0
  290. package/src/docs/04-ui/git.md +54 -0
  291. package/src/docs/04-ui/keybindings.md +79 -0
  292. package/src/docs/04-ui/knowledge-map.md +76 -0
  293. package/src/docs/04-ui/overview.md +93 -0
  294. package/src/docs/04-ui/panels.md +49 -0
  295. package/src/docs/04-ui/pinboard-selection.md +66 -0
  296. package/src/docs/04-ui/quick-open-palette.md +56 -0
  297. package/src/docs/04-ui/sessions.md +81 -0
  298. package/src/docs/04-ui/settings-permissions.md +56 -0
  299. package/src/docs/05-commands/reference.md +59 -0
  300. package/src/docs/06-outputs/directory-map.md +116 -0
  301. package/src/docs/07-workflows/ai-eval-first.md +57 -0
  302. package/src/docs/07-workflows/deep-study-to-production.md +76 -0
  303. package/src/docs/07-workflows/diverge-exploration.md +77 -0
  304. package/src/docs/07-workflows/quick-analysis.md +45 -0
  305. package/src/docs/08-integrations/claude-code-auto-mode.md +191 -0
  306. package/src/docs/08-integrations/google-slides.md +175 -0
  307. package/src/docs/README.md +30 -0
  308. package/src/docs/manifest.json +108 -0
  309. package/src/templates/analysis-template.md +20 -0
  310. package/src/templates/branch-report.md +46 -0
  311. package/src/templates/diff-report.md +88 -0
  312. package/src/templates/knowledge-index.md +7 -0
  313. package/src/templates/model-card-schema.json +186 -0
  314. package/src/templates/model-card-schema.md +88 -0
  315. package/src/templates/model-card.md +124 -0
  316. package/src/templates/project-plan.md +47 -0
  317. package/src/templates/project-specs.md +81 -0
  318. package/src/templates/report-template.md +43 -0
  319. package/src/templates/study-template.md +25 -0
  320. package/src/ui/cc-readonly.js +181 -0
  321. package/src/ui/chat-session.js +466 -0
  322. package/src/ui/css/base.css +136 -0
  323. package/src/ui/css/brainstorm.css +525 -0
  324. package/src/ui/css/chat.css +1405 -0
  325. package/src/ui/css/editor.css +546 -0
  326. package/src/ui/css/eval-dashboard.css +157 -0
  327. package/src/ui/css/experiment.css +237 -0
  328. package/src/ui/css/guide.css +186 -0
  329. package/src/ui/css/knowledge-map.css +383 -0
  330. package/src/ui/css/layout.css +431 -0
  331. package/src/ui/css/model-card.css +161 -0
  332. package/src/ui/css/notebook-walkthrough.css +271 -0
  333. package/src/ui/css/pr-review.css +403 -0
  334. package/src/ui/css/prompt-lab.css +325 -0
  335. package/src/ui/css/sessions.css +258 -0
  336. package/src/ui/css/sidebar.css +661 -0
  337. package/src/ui/css/terminal.css +113 -0
  338. package/src/ui/css/theme-light.css +542 -0
  339. package/src/ui/index.html +389 -0
  340. package/src/ui/js/agents.js +32 -0
  341. package/src/ui/js/bookmarks.js +230 -0
  342. package/src/ui/js/chat.js +1776 -0
  343. package/src/ui/js/code-intel.js +328 -0
  344. package/src/ui/js/command-palette.js +142 -0
  345. package/src/ui/js/events.js +591 -0
  346. package/src/ui/js/explorer.js +317 -0
  347. package/src/ui/js/file-view.js +477 -0
  348. package/src/ui/js/git.js +536 -0
  349. package/src/ui/js/guide.js +198 -0
  350. package/src/ui/js/hud.js +75 -0
  351. package/src/ui/js/init.js +351 -0
  352. package/src/ui/js/knowledge-map.js +906 -0
  353. package/src/ui/js/markdown.js +114 -0
  354. package/src/ui/js/monaco.js +164 -0
  355. package/src/ui/js/notebook-walkthrough.js +272 -0
  356. package/src/ui/js/notebook.js +448 -0
  357. package/src/ui/js/panels.js +2681 -0
  358. package/src/ui/js/pinboard.js +186 -0
  359. package/src/ui/js/quick-open.js +164 -0
  360. package/src/ui/js/selection-context.js +131 -0
  361. package/src/ui/js/sessions.js +256 -0
  362. package/src/ui/js/settings.js +476 -0
  363. package/src/ui/js/split-view.js +82 -0
  364. package/src/ui/js/state.js +343 -0
  365. package/src/ui/js/table.js +161 -0
  366. package/src/ui/js/tabs.js +284 -0
  367. package/src/ui/js/tabular.js +125 -0
  368. package/src/ui/js/terminal.js +354 -0
  369. package/src/ui/js/timeline.js +137 -0
  370. package/src/ui/js/utils.js +293 -0
  371. package/src/ui/notebook-kernel.py +790 -0
  372. package/src/ui/open-browser.js +55 -0
  373. package/src/ui/permission-pattern.js +42 -0
  374. package/src/ui/relay.js +513 -0
  375. package/src/ui/server.js +3072 -0
  376. package/src/ui/session-index.js +225 -0
  377. package/src/ui/shards_icon.png +0 -0
  378. package/src/ui/spawn-server.js +41 -0
  379. package/src/ui/symbol-index.js +813 -0
  380. package/src/ui/ui-push.js +177 -0
  381. package/tools/gate-hook/VALIDATION_SPEC.md +273 -0
  382. package/tools/gate-hook/__tests__/auto-verify.test.js +343 -0
  383. package/tools/gate-hook/auto-allowlist.js +179 -0
  384. package/tools/gate-hook/auto-state.js +68 -0
  385. package/tools/gate-hook/classify.js +21 -0
  386. package/tools/gate-hook/log.js +57 -0
  387. package/tools/gate-hook/parser.js +205 -0
  388. package/tools/gate-hook/sql-guard.js +230 -0
  389. package/tools/gate-hook/state.js +170 -0
  390. package/tools/gate-hook/sweep.js +139 -0
  391. package/tools/gate-hook/transcript.js +45 -0
  392. package/tools/gate-hook/validation.js +321 -0
  393. package/tools/gate-hook.js +475 -0
  394. package/tools/install.js +914 -0
  395. package/tools/shards-gates.js +311 -0
  396. package/tools/shards-sessions.js +261 -0
  397. package/tools/shards-ui.js +377 -0
@@ -0,0 +1,317 @@
1
+ // ═══════════════════════════════════════════════════════════════
2
+ // Explorer sidebar
3
+ // ═══════════════════════════════════════════════════════════════
4
+
5
+ function toggleExplorer() {
6
+ document.getElementById('explorer-sidebar').classList.toggle('collapsed');
7
+ if (typeof saveLayout === 'function') saveLayout();
8
+ }
9
+
10
+ // ─── Activity bar view switching ────────────────────────────
11
+ function switchSidebarView(view) {
12
+ activeSidebarView = view;
13
+ localStorage.setItem('shards-sidebar-view', view);
14
+
15
+ var btns = document.querySelectorAll('.activity-btn');
16
+ for (var i = 0; i < btns.length; i++) btns[i].classList.remove('active');
17
+ var activeBtn = document.getElementById('activity-' + view);
18
+ if (activeBtn) activeBtn.classList.add('active');
19
+
20
+ var views = document.querySelectorAll('.sidebar-view');
21
+ for (var j = 0; j < views.length; j++) views[j].classList.remove('active');
22
+ var activeView = document.getElementById('sidebar-view-' + view);
23
+ if (activeView) activeView.classList.add('active');
24
+
25
+ if (view === 'session' && typeof renderSessionFiles === 'function') renderSessionFiles();
26
+ if (view === 'git' && typeof renderGitChanges === 'function') renderGitChanges();
27
+ if (view === 'timeline' && typeof renderTimeline === 'function') renderTimeline();
28
+ if (view === 'sessions' && typeof refreshSessions === 'function') refreshSessions();
29
+ }
30
+
31
+ function onActivityClick(view) {
32
+ var sidebar = document.getElementById('explorer-sidebar');
33
+ if (sidebar.classList.contains('collapsed')) {
34
+ sidebar.classList.remove('collapsed');
35
+ if (typeof saveLayout === 'function') saveLayout();
36
+ }
37
+ switchSidebarView(view);
38
+ }
39
+
40
+ function switchExplorerView(mode) {
41
+ explorerViewMode = mode;
42
+ localStorage.setItem('shards-explorer-view', mode);
43
+ updateExplorerViewToggle();
44
+ var breadcrumb = document.getElementById('explorer-breadcrumb');
45
+ if (breadcrumb) breadcrumb.style.display = mode === 'tree' ? 'none' : '';
46
+ if (mode === 'tree') {
47
+ renderTree();
48
+ } else {
49
+ browseDir(currentBrowseDir || undefined);
50
+ }
51
+ }
52
+
53
+ function updateExplorerViewToggle() {
54
+ var btn = document.getElementById('explorer-view-toggle');
55
+ if (!btn) return;
56
+ btn.textContent = explorerViewMode === 'tree' ? 'List' : 'Tree';
57
+ btn.title = explorerViewMode === 'tree' ? 'Switch to list view' : 'Switch to tree view';
58
+ }
59
+
60
+ async function browseDir(dir) {
61
+ try {
62
+ var url = dir ? '/browse?dir=' + encodeURIComponent(dir) : '/browse';
63
+ var res = await authFetch(url);
64
+ var data = await res.json();
65
+ if (data.error) return;
66
+ currentBrowseDir = data.path;
67
+
68
+ // Seed tree root on first load
69
+ if (!treeRootPath) {
70
+ treeRootPath = data.path;
71
+ treeChildren[data.path] = data;
72
+ treeExpanded[data.path] = true;
73
+ }
74
+
75
+ updateExplorerViewToggle();
76
+
77
+ var breadcrumb = document.getElementById('explorer-breadcrumb');
78
+ if (explorerViewMode === 'tree') {
79
+ if (breadcrumb) breadcrumb.style.display = 'none';
80
+ renderTree();
81
+ } else {
82
+ if (breadcrumb) breadcrumb.style.display = '';
83
+ renderBreadcrumb(data.path);
84
+ renderDirListing(data);
85
+ }
86
+ } catch(e) {}
87
+ }
88
+
89
+ // ─── Tree view ─────────────────────────────────────────────────
90
+
91
+ function renderTree() {
92
+ var el = document.getElementById('explorer-listing');
93
+ el.innerHTML = '';
94
+ if (!treeRootPath) return;
95
+ if (!treeChildren[treeRootPath]) {
96
+ // Root was invalidated — re-fetch it (fetchTreeDir calls renderTree when done)
97
+ if (!treeLoading[treeRootPath]) fetchTreeDir(treeRootPath);
98
+ return;
99
+ }
100
+ renderTreeNodes(el, treeRootPath, 0);
101
+ }
102
+
103
+ function renderTreeNodes(container, dirPath, depth) {
104
+ var data = treeChildren[dirPath];
105
+ if (!data) return;
106
+ var entries = data.entries || [];
107
+
108
+ for (var i = 0; i < entries.length; i++) {
109
+ var entry = entries[i];
110
+ var fullPath = dirPath.replace(/\/+$/, '') + '/' + entry.name;
111
+ var row = document.createElement('div');
112
+
113
+ if (entry.type === 'dir') {
114
+ var isExpanded = !!treeExpanded[fullPath];
115
+ var isLoading = !!treeLoading[fullPath];
116
+ row.className = 'tree-entry is-dir' + (isExpanded ? ' expanded' : '');
117
+ row.style.paddingLeft = (8 + depth * 14) + 'px';
118
+ var toggleChar = isLoading ? '&#9675;' : (isExpanded ? '&#9660;' : '&#9654;');
119
+ row.innerHTML =
120
+ '<span class="tree-toggle">' + toggleChar + '</span>' +
121
+ '<span class="dir-icon">&#128193;</span>' +
122
+ '<span class="dir-name">' + esc(entry.name) + '</span>';
123
+ row.addEventListener('click', (function(fp) {
124
+ return function() { toggleTreeDir(fp); };
125
+ })(fullPath));
126
+ row.addEventListener('contextmenu', (function(fp) {
127
+ return function(e) { showCtxMenu(e, toRelPath(fp), { isDir: true }); };
128
+ })(fullPath));
129
+ container.appendChild(row);
130
+
131
+ if (isExpanded) {
132
+ if (treeChildren[fullPath]) {
133
+ renderTreeNodes(container, fullPath, depth + 1);
134
+ } else if (!isLoading) {
135
+ fetchTreeDir(fullPath);
136
+ }
137
+ }
138
+ } else {
139
+ var relFromRoot = treeRootPath ? fullPath.replace(treeRootPath + '/', '') : fullPath;
140
+ var touchClass = sessionTouchedFiles.has(fullPath) || sessionTouchedFiles.has(relFromRoot) ? ' touched' : '';
141
+ row.className = 'tree-entry is-file' + touchClass;
142
+ row.style.paddingLeft = (8 + depth * 14 + 18) + 'px';
143
+ row.innerHTML =
144
+ '<span class="dir-icon file-icon">&#128196;</span>' +
145
+ '<span class="dir-name">' + esc(entry.name) + '</span>' +
146
+ '<span class="dir-size">' + formatSize(entry.size) + '</span>';
147
+ row.addEventListener('click', (function(fp) {
148
+ return function() { openFileFromExplorer(fp); };
149
+ })(fullPath));
150
+ row.addEventListener('contextmenu', (function(fp) {
151
+ return function(e) { showCtxMenu(e, toRelPath(fp)); };
152
+ })(fullPath));
153
+ if (typeof makeExplorerEntryDraggable === 'function') makeExplorerEntryDraggable(row, fullPath);
154
+ container.appendChild(row);
155
+ }
156
+ }
157
+ }
158
+
159
+ async function fetchTreeDir(dirPath) {
160
+ treeLoading[dirPath] = true;
161
+ renderTree();
162
+ try {
163
+ var res = await authFetch('/browse?dir=' + encodeURIComponent(dirPath));
164
+ var data = await res.json();
165
+ if (!data.error) {
166
+ treeChildren[dirPath] = data;
167
+ }
168
+ } catch(e) {}
169
+ treeLoading[dirPath] = false;
170
+ renderTree();
171
+ }
172
+
173
+ function invalidateTreeAncestors(relPath) {
174
+ if (!treeRootPath) return;
175
+ var abs = treeRootPath + '/' + relPath;
176
+ // Walk from parent directory up to root, clearing cached entries
177
+ var dir = abs.substring(0, abs.lastIndexOf('/'));
178
+ while (dir.length >= treeRootPath.length) {
179
+ delete treeChildren[dir];
180
+ var parent = dir.substring(0, dir.lastIndexOf('/'));
181
+ if (parent === dir) break;
182
+ dir = parent;
183
+ }
184
+ }
185
+
186
+ function toggleTreeDir(dirPath) {
187
+ if (treeExpanded[dirPath]) {
188
+ treeExpanded[dirPath] = false;
189
+ renderTree();
190
+ } else {
191
+ treeExpanded[dirPath] = true;
192
+ if (!treeChildren[dirPath] && !treeLoading[dirPath]) {
193
+ fetchTreeDir(dirPath);
194
+ } else {
195
+ renderTree();
196
+ }
197
+ }
198
+ }
199
+
200
+ // ─── List view ─────────────────────────────────────────────────
201
+
202
+ function renderBreadcrumb(dirPath) {
203
+ var el = document.getElementById('explorer-breadcrumb');
204
+ el.innerHTML = '';
205
+ var parts = dirPath.split('/').filter(Boolean);
206
+
207
+ var root = document.createElement('span');
208
+ root.className = 'crumb';
209
+ root.textContent = '/';
210
+ root.addEventListener('click', function() { browseDir('/'); });
211
+ el.appendChild(root);
212
+
213
+ for (var i = 0; i < parts.length; i++) {
214
+ var cumPath = '/' + parts.slice(0, i + 1).join('/');
215
+ var isCurrent = i === parts.length - 1;
216
+
217
+ var sep = document.createElement('span');
218
+ sep.className = 'crumb-sep';
219
+ sep.textContent = '/';
220
+ el.appendChild(sep);
221
+
222
+ var crumb = document.createElement('span');
223
+ crumb.className = 'crumb' + (isCurrent ? ' current' : '');
224
+ crumb.textContent = parts[i];
225
+ if (!isCurrent) crumb.addEventListener('click', (function(p) { return function() { browseDir(p); }; })(cumPath));
226
+ el.appendChild(crumb);
227
+ }
228
+ }
229
+
230
+ function renderDirListing(data) {
231
+ var el = document.getElementById('explorer-listing');
232
+ el.innerHTML = '';
233
+
234
+ if (data.parent) {
235
+ var parentEl = document.createElement('div');
236
+ parentEl.className = 'dir-entry parent-entry is-dir';
237
+ parentEl.innerHTML = '<span class="dir-icon">..</span><span class="dir-name">Parent directory</span>';
238
+ parentEl.addEventListener('click', function() { browseDir(data.parent); });
239
+ el.appendChild(parentEl);
240
+ }
241
+
242
+ for (var j = 0; j < data.entries.length; j++) {
243
+ var entry = data.entries[j];
244
+ var fullPath = data.path + '/' + entry.name;
245
+ var row = document.createElement('div');
246
+
247
+ if (entry.type === 'dir') {
248
+ row.className = 'dir-entry is-dir';
249
+ row.innerHTML = '<span class="dir-icon">&#128193;</span><span class="dir-name">' + esc(entry.name) + '</span>';
250
+ row.addEventListener('click', (function(fp) { return function() { browseDir(fp); }; })(fullPath));
251
+ row.addEventListener('contextmenu', (function(fp) { return function(e) { showCtxMenu(e, toRelPath(fp), { isDir: true }); }; })(fullPath));
252
+ } else {
253
+ var relFromRoot = treeRootPath ? fullPath.replace(treeRootPath + '/', '') : fullPath;
254
+ var touchClass = sessionTouchedFiles.has(fullPath) || sessionTouchedFiles.has(relFromRoot) ? ' touched' : '';
255
+ row.className = 'dir-entry is-file' + touchClass;
256
+ row.innerHTML = '<span class="dir-icon">&#128196;</span><span class="dir-name">' + esc(entry.name) + '</span><span class="dir-size">' + formatSize(entry.size) + '</span>';
257
+ row.addEventListener('click', (function(fp) { return function() { openFileFromExplorer(fp); }; })(fullPath));
258
+ row.addEventListener('contextmenu', (function(fp) { return function(e) { showCtxMenu(e, toRelPath(fp)); }; })(fullPath));
259
+ if (typeof makeExplorerEntryDraggable === 'function') makeExplorerEntryDraggable(row, fullPath);
260
+ }
261
+ el.appendChild(row);
262
+ }
263
+
264
+ if (data.entries.length === 0 && !data.parent) {
265
+ el.innerHTML = '<div style="padding:8px 12px;color:#3a3a54;font-size:10px">Empty directory</div>';
266
+ }
267
+ }
268
+
269
+ async function openFileFromExplorer(filePath) {
270
+ if (isMediaFile(filePath)) {
271
+ // For images/PDFs, open with absPath — no text content needed
272
+ var relPath = filePath;
273
+ // Try to get relative path from the project
274
+ if (treeRootPath && filePath.indexOf(treeRootPath) === 0) {
275
+ relPath = filePath.slice(treeRootPath.length + 1);
276
+ }
277
+ openFileTab(relPath, '', filePath, { media: true });
278
+ return;
279
+ }
280
+ try {
281
+ var res = await authFetch('/browse/file?path=' + encodeURIComponent(filePath));
282
+ var data = await res.json();
283
+ if (data.error) return;
284
+ var key = data.relPath || filePath;
285
+ openFileTab(key, data.content, data.path);
286
+ } catch(e) {}
287
+ }
288
+
289
+ // ═══════════════════════════════════════════════════════════════
290
+ // Explorer resize
291
+ // ═══════════════════════════════════════════════════════════════
292
+
293
+ function initExplorerResize() {
294
+ var handle = document.getElementById('explorer-resize');
295
+ var sidebar = document.getElementById('explorer-sidebar');
296
+ var startX, startW;
297
+
298
+ handle.addEventListener('mousedown', function(e) {
299
+ e.preventDefault();
300
+ startX = e.clientX;
301
+ startW = sidebar.offsetWidth;
302
+ handle.classList.add('dragging');
303
+ document.addEventListener('mousemove', onMove);
304
+ document.addEventListener('mouseup', onUp);
305
+ });
306
+
307
+ function onMove(e) {
308
+ var newW = Math.max(140, Math.min(500, startW + (e.clientX - startX)));
309
+ sidebar.style.width = newW + 'px';
310
+ }
311
+ function onUp() {
312
+ handle.classList.remove('dragging');
313
+ document.removeEventListener('mousemove', onMove);
314
+ document.removeEventListener('mouseup', onUp);
315
+ if (typeof saveLayout === 'function') saveLayout();
316
+ }
317
+ }