rhachet-roles-ehmpathy 1.0.0 → 1.2.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 (435) hide show
  1. package/dist/.test/getContextOpenAI.js +2 -1
  2. package/dist/.test/getContextOpenAI.js.map +1 -1
  3. package/dist/_topublish/domain-glossary-brief/src/domain/objects/Catalog.d.ts +0 -0
  4. package/dist/_topublish/domain-glossary-brief/src/domain/objects/Catalog.js +2 -0
  5. package/dist/_topublish/domain-glossary-brief/src/domain/objects/Catalog.js.map +1 -0
  6. package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.d.ts +18 -0
  7. package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.js +3 -0
  8. package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.js.map +1 -0
  9. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.d.ts +34 -0
  10. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.js +9 -0
  11. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.js.map +1 -0
  12. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/PonderCatalog.d.ts +9 -0
  13. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/PonderCatalog.js +3 -0
  14. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/PonderCatalog.js.map +1 -0
  15. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.d.ts +1 -0
  16. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.js +3 -0
  17. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.js.map +1 -0
  18. package/dist/contract/commands/codegenBriefOptions.js +1 -0
  19. package/dist/contract/commands/codegenBriefOptions.js.map +1 -1
  20. package/dist/contract/sdk/index.d.ts +1 -0
  21. package/dist/contract/sdk/index.js +6 -0
  22. package/dist/contract/sdk/index.js.map +1 -0
  23. package/dist/data/sdk/sdkOpenAi.js +5 -1
  24. package/dist/data/sdk/sdkOpenAi.js.map +1 -1
  25. package/dist/index.d.ts +1 -0
  26. package/dist/index.js +16 -0
  27. package/dist/index.js.map +1 -1
  28. package/dist/logic/artifact/asDotRhachetFile.d.ts +5 -0
  29. package/dist/logic/artifact/asDotRhachetFile.js +16 -0
  30. package/dist/logic/artifact/asDotRhachetFile.js.map +1 -0
  31. package/dist/logic/artifact/genLoopFeedback.d.ts +18 -0
  32. package/dist/logic/artifact/genLoopFeedback.js +40 -0
  33. package/dist/logic/artifact/genLoopFeedback.js.map +1 -0
  34. package/dist/logic/artifact/genStepArtSet.d.ts +2 -1
  35. package/dist/logic/artifact/genStepArtSet.js +24 -4
  36. package/dist/logic/artifact/genStepArtSet.js.map +1 -1
  37. package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.js +7 -0
  38. package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.js.map +1 -1
  39. package/dist/logic/artifact/genStepResetFeedback.d.ts +12 -0
  40. package/dist/logic/artifact/genStepResetFeedback.js +27 -0
  41. package/dist/logic/artifact/genStepResetFeedback.js.map +1 -0
  42. package/dist/logic/artifact/genStepSwapArtifact.d.ts +57 -0
  43. package/dist/logic/artifact/genStepSwapArtifact.js +58 -0
  44. package/dist/logic/artifact/genStepSwapArtifact.js.map +1 -0
  45. package/dist/logic/artifact/genStepSwapArtifact.test.js +131 -0
  46. package/dist/logic/artifact/genStepSwapArtifact.test.js.map +1 -0
  47. package/dist/logic/roles/architect/.briefs/ubiqlang.ambiguous-from-overload.md +1 -0
  48. package/dist/logic/roles/bhrain/.briefs/cognition/cog000.overview.and.premise.md +115 -0
  49. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.coordinates.spherical.md +69 -0
  50. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.cauliflorous.md +44 -0
  51. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.structs.catalog.md +51 -0
  52. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.structs.treestruct.md +85 -0
  53. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.structs.vector.md +112 -0
  54. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.definition.md +115 -0
  55. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct._.md +112 -0
  56. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.coords.1.spherical.md +80 -0
  57. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.coords.2.abstractive.md +59 -0
  58. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.coords.3.descriptive.md +64 -0
  59. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.persp.1.perspectives.md +88 -0
  60. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.persp.2.universal.md +82 -0
  61. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.persp.3.relative.md +106 -0
  62. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.persp.4.fractal.md +83 -0
  63. package/dist/logic/roles/bhrain/.briefs/cognition/cog151.concept.treestruct.gravity.md +89 -0
  64. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p1.definition.md +231 -0
  65. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p1.examples.cont.md +82 -0
  66. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p2.acuity.md +134 -0
  67. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p2.breadth.md +151 -0
  68. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p2.depth.md +147 -0
  69. package/dist/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.fabric.md +96 -0
  70. package/dist/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.mode.md +68 -0
  71. package/dist/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.rythm.md +56 -0
  72. package/dist/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.usecases.md +76 -0
  73. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives._.md +155 -0
  74. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives.acuity.md +94 -0
  75. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives.breadth.md +114 -0
  76. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives.breadth.vary.md +105 -0
  77. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives.depth.md +132 -0
  78. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.2.motion.composites._.md +106 -0
  79. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.2.motion.composites.grammar.md +105 -0
  80. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.._.md +209 -0
  81. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.1.persp.as.berries.md +168 -0
  82. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.1.persp.as.vectors.md +74 -0
  83. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.1.persp.has.precision.tunable.md +80 -0
  84. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.1.primitives.rough._.md +99 -0
  85. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.1.primitives.rough.interrogative.md +108 -0
  86. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.1.primitives.rough.why.[article].md +55 -0
  87. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.2.composite.smooth._.md +83 -0
  88. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.2.composite.smooth.examples.md +101 -0
  89. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives._.md +134 -0
  90. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives.recall.md +149 -0
  91. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives.steer.md +146 -0
  92. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives.think.md +141 -0
  93. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.2.composites.zoom.md +127 -0
  94. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.3.catalogs.md +107 -0
  95. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.3.grammar.md +124 -0
  96. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang_.md +0 -0
  97. package/dist/logic/roles/bhrain/.briefs/cognition/inflight/concept.vs.idea.md +70 -0
  98. package/dist/logic/roles/bhrain/.briefs/cognition/inflight/core.concept.adjectives.md +8 -0
  99. package/dist/logic/roles/bhrain/.briefs/distilisys.grammar.compressed.md +19 -0
  100. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.1.ontology.[article].frame.docs_as_materializations.md +63 -0
  101. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.1.ontology.[article].frame.docs_as_references.md +45 -0
  102. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.2.rel.many_to_many.[article].md +37 -0
  103. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.3.instances.[article].md +39 -0
  104. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.4.documents.[article].md +37 -0
  105. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.5.concepts.[article].md +39 -0
  106. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents._.[article].md +48 -0
  107. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents._.[catalog].md +52 -0
  108. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents.articles.[article].md +40 -0
  109. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents.catalogs.[article].md +41 -0
  110. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents.demos.[article].md +42 -0
  111. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents.lessons.[article].md +42 -0
  112. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression.1.refs._.[article].md +41 -0
  113. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression.2.kernels._.[article].i1.md +50 -0
  114. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression.3.briefs._.[article].md +40 -0
  115. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression._.[article].md +90 -0
  116. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression._.[catalog].persp.garden.md +64 -0
  117. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[article].md +45 -0
  118. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].algorithm.md +54 -0
  119. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].color.md +56 -0
  120. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].empathy.md +54 -0
  121. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].entropy.md +54 -0
  122. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].gravity.md +54 -0
  123. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].joke.md +56 -0
  124. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].value.md +54 -0
  125. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2._.[catalog].md +43 -0
  126. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.articulate.[article].md +27 -0
  127. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.articulate.[lesson].md +49 -0
  128. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.catalogize.[article].md +27 -0
  129. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.catalogize.[lesson].md +54 -0
  130. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.demonstrate.[article].md +26 -0
  131. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.demonstrate.[lesson].md +49 -0
  132. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.lessonize.[article].md +26 -0
  133. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.lessonize.[lesson].md +54 -0
  134. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.kernelize._.[article].md +58 -0
  135. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.kernelize._.[lesson].md +88 -0
  136. package/dist/logic/roles/bhrain/.briefs/knowledge/kno351.docs.are_instances.[article].md +34 -0
  137. package/dist/logic/roles/bhrain/.briefs/knowledge/kno351.docs.recursion.[catalog].md +44 -0
  138. package/dist/logic/roles/bhrain/.briefs/knowledge/kno401.actors.1.role.author.[article].md +36 -0
  139. package/dist/logic/roles/bhrain/.briefs/knowledge/kno401.actors.1.role.librarian.[article].md +40 -0
  140. package/dist/logic/roles/bhrain/.briefs/knowledge/kno401.actors.2.interdependence.[article].md +52 -0
  141. package/dist/logic/roles/bhrain/.briefs/knowledge/kno501.doc.enbrief.catalog.structure1.[article].md +53 -0
  142. package/dist/logic/roles/bhrain/.briefs/knowledge/kno501.doc.enbrief.catalog.structure1.[lesson].template.md +101 -0
  143. package/dist/logic/roles/bhrain/.briefs/librarian.context/article.variant.vision.[article].md +60 -0
  144. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.expectation.vs_assumption._.md +60 -0
  145. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.frame.vs_perspective.[article].md +96 -0
  146. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.invariant.[article].md +29 -0
  147. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.lesson._vs_article.[article].md +36 -0
  148. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.ref._vs_brief.md +90 -0
  149. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.referent.[article].md +43 -0
  150. package/dist/logic/roles/bhrain/.briefs/librarian.context/usage.lesson_vs_article.[lesson].md +31 -0
  151. package/dist/logic/roles/bhrain/.briefs/librarian.context/usage.lesson_vs_article_vs_demo.[lesson].md +37 -0
  152. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/.readme.md +12 -0
  153. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.TriageCatalog.[gallery][example].structure.md +18 -0
  154. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>._.[article].frame.cognitive.md +33 -0
  155. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>._.[article].frame.tactical.md +45 -0
  156. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.[catalog].md +83 -0
  157. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.concept_dimension.examples.[article][seed].md +4 -0
  158. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.concept_dimension.invariants.[article].md +36 -0
  159. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.from.examples.md +44 -0
  160. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.from.seed.md +48 -0
  161. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.with.templates.[article].md +57 -0
  162. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.with.templates.[gallery][review].effective.md +1 -0
  163. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tone.bluecollar.[article][seed].md +5 -0
  164. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<catalogize>._.[article][seed].md +3 -0
  165. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<catalogize>.observation.via_clusterage_over_via_imagination.[seed].md +6 -0
  166. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<catalogize>.vs_diverge.[article].persp.save_compute.md +46 -0
  167. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>._.[article].frame.colloquial.i2.by_grok.md +64 -0
  168. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.[catalog].md +106 -0
  169. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.contrast.[demo].usecase.vs_userjourney.by_chatgpt.md +45 -0
  170. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.counter.[demo].usecase.flyer.by_chargpt.md +38 -0
  171. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.counter.[demo].walkability.phoenix.by_chargpt.md +41 -0
  172. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].shear_force.scissors.by_grok.md +52 -0
  173. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].tea.darjeeling.by_grok.md +50 -0
  174. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].usecase.book_flight.by_grok.md +54 -0
  175. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].usecase.order_food.by_chatgpt.md +40 -0
  176. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_chatgpt.i3.md +42 -0
  177. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_grok.i2.md +49 -0
  178. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[lesson].howto.md +28 -0
  179. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.structure.[article].i2.md +73 -0
  180. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.narrative.[demo].usecase.order_online.by_chatgpt.md +34 -0
  181. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.walkthrough.[demo].usecase.book_online.by_chatgpt.md +47 -0
  182. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/[brief].verbiage.outline.over.narrative.md +55 -0
  183. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.acuity.md +77 -0
  184. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.breadth.md +74 -0
  185. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.depth.md +77 -0
  186. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.distance.md +92 -0
  187. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.tradeoffs.md +107 -0
  188. package/dist/logic/roles/bhrain/.briefs/terms.motive.intent.goal.md +46 -0
  189. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<cluster>._.[article].frame.tactical._.md +85 -0
  190. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<cluster>.vs_<diverge>.duality.[article].md +43 -0
  191. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<diverge>._.[article].frame.cognitive.[seed].md +4 -0
  192. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<diverge>._.[article].frame.tactical.md +89 -0
  193. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<elaborate>_vs_<elucidate>.[seed].md +1 -0
  194. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<enquestion>._.[article].md +113 -0
  195. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<enquestion>._.[gallery].plumber.diagnose.md +130 -0
  196. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<enquestion>._.[gallery].thinker.enquestion.md +125 -0
  197. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<enquestion>.tactic.perspectives.[article].md +36 -0
  198. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<triage>._.[article].frame.tactical.md +85 -0
  199. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<triage>.persp.grades_from_context.[article].md +48 -0
  200. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<triage>.persp.implicit_question.[article].md +65 -0
  201. package/dist/logic/roles/bhrain/.briefs/trait.ocd.md +5 -0
  202. package/dist/logic/roles/bhrain/.briefs/worders/core.matmuls_vecmuls_elemuls.md +93 -0
  203. package/dist/logic/roles/bhrain/.briefs/worders/core.transformers.as_origin.md +62 -0
  204. package/dist/logic/roles/bhrain/.briefs/worders/core.transformers.self_attention.[article].md +93 -0
  205. package/dist/logic/roles/bhrain/.briefs/worders/core.transformers.self_attention.[demo].ambig.bank.md +80 -0
  206. package/dist/logic/roles/bhrain/.briefs/worders/core.transformers.self_attention.[demo].cat_sat.md +67 -0
  207. package/dist/logic/roles/bhrain/.briefs/worders/force.repeat_input_structures.md +48 -0
  208. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.interdependence.[article].md +37 -0
  209. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.interdependence.[demo].domain.physics.md +30 -0
  210. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internal_vs_external.[article].artist_vs_librarian.md +44 -0
  211. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internal_vs_external.[demo].artist_vs_librarian.md +37 -0
  212. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internal_vs_external.[demo].domain.physics.md +39 -0
  213. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internalized.[article].md +35 -0
  214. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internalized.[demo].artist.md +36 -0
  215. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internalized.[demo].neural.md +37 -0
  216. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internalized.[demo].pianist.md +34 -0
  217. package/dist/logic/roles/bhrain/.briefs/worders/limits.rhyme.md +46 -0
  218. package/dist/logic/roles/bhrain/.briefs/worders/limits.spell.md +49 -0
  219. package/dist/logic/roles/bhrain/.briefs/worders/teach.via.library.examples.md +28 -0
  220. package/dist/logic/roles/bhrain/.briefs/worders/teach.via.library.explanations_vs_examples.md +40 -0
  221. package/dist/logic/roles/bhrain/.briefs/worders/trend.prefer_reuse.[seed].md +10 -0
  222. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.d.ts +61 -0
  223. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.integration.test.js +96 -0
  224. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.integration.test.js.map +1 -0
  225. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.js +94 -0
  226. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.js.map +1 -0
  227. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.skill.d.ts +31 -0
  228. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.skill.js +137 -0
  229. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.skill.js.map +1 -0
  230. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.template.md +129 -0
  231. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.d.ts +55 -0
  232. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.integration.test.js +118 -0
  233. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.integration.test.js.map +1 -0
  234. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.js +72 -0
  235. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.js.map +1 -0
  236. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.skill.d.ts +28 -0
  237. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.skill.js +119 -0
  238. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.skill.js.map +1 -0
  239. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.d.ts +59 -0
  240. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.integration.test.d.ts +1 -0
  241. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.integration.test.js +119 -0
  242. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.integration.test.js.map +1 -0
  243. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.js +103 -0
  244. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.js.map +1 -0
  245. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.skill.d.ts +30 -0
  246. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.skill.js +138 -0
  247. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.skill.js.map +1 -0
  248. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.template.md +135 -0
  249. package/dist/logic/roles/bhrain/getBhrainBrief.Options.codegen.d.ts +10 -0
  250. package/dist/logic/roles/bhrain/getBhrainBrief.Options.codegen.js +181 -0
  251. package/dist/logic/roles/bhrain/getBhrainBrief.Options.codegen.js.map +1 -0
  252. package/dist/logic/roles/bhrain/getBhrainBrief.d.ts +13 -0
  253. package/dist/logic/roles/bhrain/getBhrainBrief.js +21 -0
  254. package/dist/logic/roles/bhrain/getBhrainBrief.js.map +1 -0
  255. package/dist/logic/roles/bhrain/getBhrainRole.d.ts +2 -0
  256. package/dist/logic/roles/bhrain/getBhrainRole.js +41 -0
  257. package/dist/logic/roles/bhrain/getBhrainRole.js.map +1 -0
  258. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.d.ts +57 -0
  259. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.integration.test.d.ts +1 -0
  260. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.integration.test.js +140 -0
  261. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.integration.test.js.map +1 -0
  262. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.js +91 -0
  263. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.js.map +1 -0
  264. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.skill.d.ts +29 -0
  265. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.skill.js +127 -0
  266. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.skill.js.map +1 -0
  267. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.template.md +134 -0
  268. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.d.ts +57 -0
  269. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.d.ts +1 -0
  270. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.js +115 -0
  271. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.js.map +1 -0
  272. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.js +92 -0
  273. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.js.map +1 -0
  274. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.skill.d.ts +29 -0
  275. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.skill.js +112 -0
  276. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.skill.js.map +1 -0
  277. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.template.md +110 -0
  278. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.d.ts +55 -0
  279. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.integration.test.d.ts +1 -0
  280. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.integration.test.js +119 -0
  281. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.integration.test.js.map +1 -0
  282. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.js +75 -0
  283. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.js.map +1 -0
  284. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.skill.d.ts +28 -0
  285. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.skill.js +119 -0
  286. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.skill.js.map +1 -0
  287. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.template.md +73 -0
  288. package/dist/logic/roles/bhrain/khue.triage/stepTriage.d.ts +57 -0
  289. package/dist/logic/roles/bhrain/khue.triage/stepTriage.integration.test.d.ts +1 -0
  290. package/dist/logic/roles/bhrain/khue.triage/stepTriage.integration.test.js +143 -0
  291. package/dist/logic/roles/bhrain/khue.triage/stepTriage.integration.test.js.map +1 -0
  292. package/dist/logic/roles/bhrain/khue.triage/stepTriage.js +93 -0
  293. package/dist/logic/roles/bhrain/khue.triage/stepTriage.js.map +1 -0
  294. package/dist/logic/roles/bhrain/khue.triage/stepTriage.skill.d.ts +29 -0
  295. package/dist/logic/roles/bhrain/khue.triage/stepTriage.skill.js +127 -0
  296. package/dist/logic/roles/bhrain/khue.triage/stepTriage.skill.js.map +1 -0
  297. package/dist/logic/roles/bhrain/khue.triage/stepTriage.template.md +128 -0
  298. package/dist/logic/roles/designer/.briefs/declarative-over-imperative.md +79 -0
  299. package/dist/logic/roles/designer/.briefs/declarative-over-imperative.stub.md +14 -0
  300. package/dist/logic/roles/designer/.briefs/pit-of-success.md +70 -0
  301. package/dist/logic/roles/designer/.briefs/pit-of-success.stub.md +3 -0
  302. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.js +4 -2
  303. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.js.map +1 -1
  304. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.template.md +173 -0
  305. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.js +1 -1
  306. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.js.map +1 -1
  307. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.template.md +88 -0
  308. package/dist/logic/roles/designer/outlineVision/stepOutlineVision.template.md +47 -0
  309. package/dist/logic/roles/ecologist/.briefs/.readme.md +17 -0
  310. package/dist/logic/roles/ecologist/.briefs/distilisys/sys101.distilisys.grammar.md +221 -0
  311. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive._.summary.md +82 -0
  312. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p1.reversibility.entropy.md +39 -0
  313. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p2.option.chance.choice.md +140 -0
  314. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p3.chance.motive.polarity.threat.md +72 -0
  315. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p4.motive.horizon.md +101 -0
  316. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p5.motive.grammar.md +131 -0
  317. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources._.primitives.summary.md +108 -0
  318. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt1.primitive.time.md +56 -0
  319. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt2.primitive.energy.md +69 -0
  320. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt3.primitive.space.md +85 -0
  321. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt4.primitive.claim.md +113 -0
  322. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt5.composites.md +146 -0
  323. package/dist/logic/roles/ecologist/.briefs/distilisys/sys231.actor.claims.p1.primitive.exchange.md +130 -0
  324. package/dist/logic/roles/ecologist/.briefs/ecology/.eco001.origin.prompt.md +11 -0
  325. package/dist/logic/roles/ecologist/.briefs/ecology/eco001.overview.md +44 -0
  326. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.core-system-understanding.md +70 -0
  327. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p1.ecosystem-structure.md +62 -0
  328. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p2.trophic-dynamics.md +59 -0
  329. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p3.population-ecology.md +71 -0
  330. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p4.community-interactions.md +78 -0
  331. package/dist/logic/roles/ecologist/.briefs/ecology/eco505.systems-thinking.md +62 -0
  332. package/dist/logic/roles/ecologist/.briefs/economy/econ001.overview.md +65 -0
  333. package/dist/logic/roles/ecologist/.briefs/economy/econ101.core-mechanics.md +65 -0
  334. package/dist/logic/roles/ecologist/.briefs/economy/econ101.p1.supply-and-demand.md +76 -0
  335. package/dist/logic/roles/ecologist/.briefs/economy/econ101.p2.opportunity-cost.md +106 -0
  336. package/dist/logic/roles/ecologist/.briefs/economy/econ101.p3.marginal-analysis.md +79 -0
  337. package/dist/logic/roles/ecologist/.briefs/economy/econ101.p4.rational-choice.md +81 -0
  338. package/dist/logic/roles/ecologist/.briefs/economy/econ201.market-structures-and-failures.md +81 -0
  339. package/dist/logic/roles/ecologist/.briefs/economy/econ301.production-and-growth.md +71 -0
  340. package/dist/logic/roles/ecologist/.briefs/economy/econ401.macro-systems.md +92 -0
  341. package/dist/logic/roles/ecologist/.briefs/economy/econ501.global-and-institutional.md +85 -0
  342. package/dist/logic/roles/ecologist/.briefs/economy/econ501.p1.game-theory.md +142 -0
  343. package/dist/logic/roles/ecologist/.briefs/economy/econ501.p4.behavioral-economics.md +146 -0
  344. package/dist/logic/roles/ecologist/.briefs/product/user.journey._.[article].i1.md +68 -0
  345. package/dist/logic/roles/ecologist/.briefs/product/user.journey._.[article].md +0 -0
  346. package/dist/logic/roles/ecologist/.briefs/product/user.journey.purpose.[article].i1.md +52 -0
  347. package/dist/logic/roles/ecologist/.briefs/product/user.journey.purpose.[article].md +52 -0
  348. package/dist/logic/roles/ecologist/.briefs/term.distillation.md +93 -0
  349. package/dist/logic/roles/ecologist/getEcologistBrief.Options.codegen.d.ts +1 -1
  350. package/dist/logic/roles/ecologist/getEcologistBrief.Options.codegen.js +38 -27
  351. package/dist/logic/roles/ecologist/getEcologistBrief.Options.codegen.js.map +1 -1
  352. package/dist/logic/roles/ecologist/getEcologistRole.d.ts +2 -0
  353. package/dist/logic/roles/ecologist/getEcologistRole.js +29 -0
  354. package/dist/logic/roles/ecologist/getEcologistRole.js.map +1 -0
  355. package/dist/logic/roles/getRoleRegistry.js +7 -1
  356. package/dist/logic/roles/getRoleRegistry.js.map +1 -1
  357. package/dist/logic/roles/mechanic/.briefs/architecture/bounded-contexts.md +61 -0
  358. package/dist/logic/roles/mechanic/.briefs/architecture/directional-dependencies.md +73 -0
  359. package/dist/logic/roles/mechanic/.briefs/architecture/domain-driven-design.md +61 -0
  360. package/dist/logic/roles/mechanic/.briefs/architecture/ubiqlang.md +37 -0
  361. package/dist/logic/roles/mechanic/.briefs/codestyle/_mech.compressed.md +57 -0
  362. package/dist/logic/roles/mechanic/.briefs/codestyle/_mech.compressed.prompt.md +5 -0
  363. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.failfast.md +37 -0
  364. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.idempotency.md +63 -0
  365. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.immutability.md +48 -0
  366. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.narratives.md +74 -0
  367. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.single-responsibility.md +67 -0
  368. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.args.input-context.md +61 -0
  369. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.args.input-inline.md +63 -0
  370. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.arrowonly.md +47 -0
  371. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.clear-contracts.md +53 -0
  372. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.tests.given-when-then.md +62 -0
  373. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.what-why.md +88 -0
  374. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.what-why.v2.md +98 -0
  375. package/dist/logic/roles/mechanic/.briefs/codestyle/pit-of-success.via.minimize-surface-area.md +58 -0
  376. package/dist/logic/roles/mechanic/.briefs/engineer/dependency-injection.md +118 -0
  377. package/dist/logic/roles/mechanic/.briefs/engineer/dependency-injection.stub.md +11 -0
  378. package/dist/logic/roles/mechanic/.briefs/style.compressed.md +29 -0
  379. package/dist/logic/roles/mechanic/.briefs/style.compressed.prompt.md +5 -0
  380. package/dist/logic/roles/mechanic/.briefs/style.names.treestruct.md +48 -0
  381. package/dist/logic/roles/mechanic/.briefs/style.names.ubiqlang.md +37 -0
  382. package/dist/logic/roles/mechanic/.briefs/style.words.lowercase.md +36 -0
  383. package/dist/logic/roles/mechanic/codediff/routeArtistCodeDiff.template.md +46 -0
  384. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewArchitecture.template.md +78 -0
  385. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewCodestyle.template.md +75 -0
  386. package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.template.md +67 -0
  387. package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.d.ts +1 -1
  388. package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.js +3 -1
  389. package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.js.map +1 -1
  390. package/dist/logic/roles/mechanic/getMechanicRole.js +3 -137
  391. package/dist/logic/roles/mechanic/getMechanicRole.js.map +1 -1
  392. package/dist/logic/roles/mechanic/skills/getSkillCodePropose.d.ts +2 -0
  393. package/dist/logic/roles/mechanic/skills/getSkillCodePropose.js +140 -0
  394. package/dist/logic/roles/mechanic/skills/getSkillCodePropose.js.map +1 -0
  395. package/dist/logic/roles/mechanic/study/routeStudyAsk.template.md +73 -0
  396. package/dist/logic/roles/mechanic/write/.test/prior.template.md +21 -0
  397. package/dist/logic/roles/mechanic/write/loopWrite.d.ts +25 -0
  398. package/dist/logic/roles/mechanic/write/loopWrite.integration.test.d.ts +1 -0
  399. package/dist/logic/roles/mechanic/write/loopWrite.integration.test.js +57 -0
  400. package/dist/logic/roles/mechanic/write/loopWrite.integration.test.js.map +1 -0
  401. package/dist/logic/roles/mechanic/write/loopWrite.js +11 -0
  402. package/dist/logic/roles/mechanic/write/loopWrite.js.map +1 -0
  403. package/dist/logic/roles/mechanic/write/loopWrite.skill.d.ts +25 -0
  404. package/dist/logic/roles/mechanic/write/loopWrite.skill.js +100 -0
  405. package/dist/logic/roles/mechanic/write/loopWrite.skill.js.map +1 -0
  406. package/dist/logic/roles/{ecologist/distill/distillDomain.ActionsAndActors.d.ts → mechanic/write/stepWrite.d.ts} +9 -3
  407. package/dist/logic/roles/mechanic/write/stepWrite.integration.test.d.ts +1 -0
  408. package/dist/logic/roles/mechanic/write/stepWrite.integration.test.js +189 -0
  409. package/dist/logic/roles/mechanic/write/stepWrite.integration.test.js.map +1 -0
  410. package/dist/logic/roles/mechanic/write/stepWrite.js +51 -0
  411. package/dist/logic/roles/mechanic/write/stepWrite.js.map +1 -0
  412. package/dist/logic/roles/mechanic/write/stepWrite.template.md +38 -0
  413. package/package.json +10 -6
  414. package/readme.[seed].md +2 -0
  415. package/readme.md +1 -1
  416. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.expand.ResourcesAndMechanisms.d.ts +0 -17
  417. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.expand.ResourcesAndMechanisms.integration.test.js +0 -107
  418. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.expand.ResourcesAndMechanisms.integration.test.js.map +0 -1
  419. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.expand.ResourcesAndMechanisms.js +0 -76
  420. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.expand.ResourcesAndMechanisms.js.map +0 -1
  421. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.imagine.ResourcesAndMechanisms.d.ts +0 -17
  422. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.imagine.ResourcesAndMechanisms.js +0 -73
  423. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.imagine.ResourcesAndMechanisms.js.map +0 -1
  424. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.refine.ResourcesAndMechanisms.d.ts +0 -18
  425. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.refine.ResourcesAndMechanisms.integration.test.js +0 -73
  426. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.refine.ResourcesAndMechanisms.integration.test.js.map +0 -1
  427. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.refine.ResourcesAndMechanisms.js +0 -62
  428. package/dist/logic/roles/ecologist/distill/.deprecate/distillDomain.refine.ResourcesAndMechanisms.js.map +0 -1
  429. package/dist/logic/roles/ecologist/distill/distillDomain.ActionsAndActors.integration.test.js +0 -120
  430. package/dist/logic/roles/ecologist/distill/distillDomain.ActionsAndActors.integration.test.js.map +0 -1
  431. package/dist/logic/roles/ecologist/distill/distillDomain.ActionsAndActors.js +0 -69
  432. package/dist/logic/roles/ecologist/distill/distillDomain.ActionsAndActors.js.map +0 -1
  433. /package/dist/logic/{roles/ecologist/distill/.deprecate/distillDomain.expand.ResourcesAndMechanisms.integration.test.d.ts → artifact/genStepSwapArtifact.test.d.ts} +0 -0
  434. /package/dist/logic/roles/{ecologist/distill/.deprecate/distillDomain.refine.ResourcesAndMechanisms.integration.test.d.ts → bhrain/brief.articulate/stepArticulate.integration.test.d.ts} +0 -0
  435. /package/dist/logic/roles/{ecologist/distill/distillDomain.ActionsAndActors.integration.test.d.ts → bhrain/brief.catalogize/stepCatalogize.integration.test.d.ts} +0 -0
@@ -0,0 +1,37 @@
1
+ # 🧩 .brief: `externalized knowledge requires internalized scaffolding`
2
+
3
+ ---
4
+
5
+ ## 🧠 what this concept means
6
+ - **externalized knowledge** (facts in a book, formulas on a sheet, data in a database) is inert on its own.
7
+ - for it to become usable, the system — human or llm — must have **internalized scaffolding**: conceptual frameworks, interpretive skills, and procedural fluency that make sense of the raw reference.
8
+ - without scaffolding, externalized knowledge is like symbols without meaning.
9
+
10
+ ---
11
+
12
+ ## 🎨 examples across domains
13
+ - **physics**: a formula table is only useful if the student has internalized what variables represent and when equations apply.
14
+ - **chemistry**: a reaction handbook is only actionable if the chemist has internalized fundamentals like valence, polarity, and stability.
15
+ - **language**: a dictionary provides definitions, but only someone with internalized grammar and semantics can apply them in real communication.
16
+ - **llms**: retrieved passages (RAG) are useful only because the model has internalized language patterns that allow it to interpret, paraphrase, and apply them.
17
+
18
+ ---
19
+
20
+ ## ⚙️ mechanics of the relationship
21
+ - **internalized scaffolding**: generalizable, embodied patterns (styles, rules, frameworks).
22
+ - **externalized reference**: precise, factual, bounded records.
23
+ - **interaction**: scaffolding enables comprehension and application; reference extends range and accuracy.
24
+
25
+ ---
26
+
27
+ ## 🔑 takeaways
28
+ - externalized knowledge alone = static, inert.
29
+ - internalized knowledge alone = fluent, adaptive, but fallible.
30
+ - **operability emerges only from their combination**: scaffolding activates references, references ground scaffolding.
31
+
32
+ ---
33
+
34
+ ## 📌 intuition anchor
35
+ a formula sheet without understanding is **dead weight**.
36
+ understanding without a sheet risks **slips and gaps**.
37
+ together, they form a **living system of knowledge** — internalized scaffolding breathing life into externalized records.
@@ -0,0 +1,30 @@
1
+ # 🧩 .brief.reflect: `interdependence of internalized and externalized knowledge`
2
+
3
+ ---
4
+
5
+ ## ⚛️ physics domain insight
6
+ - a **formula table** provides equations (externalized knowledge), but:
7
+ - without knowing what “\(F\)” or “\(a\)” represent, the student cannot meaningfully use \(F=ma\).
8
+ - they must already have **internalized fundamentals**: what force, mass, and acceleration *mean*, how they relate, and when the equation applies.
9
+ - only with that internalized base does the externalized table become **operable knowledge**.
10
+
11
+ ---
12
+
13
+ ## 🧠 mapping back to llms
14
+ - **retrieval (externalized)**: gives the llm a fact, equation, or passage.
15
+ - **weights (internalized)**: provide the interpretive machinery — language parsing, reasoning steps, contextual application.
16
+ - **together**: the llm can both **understand** what the retrieved info means and **apply** it productively in conversation.
17
+
18
+ ---
19
+
20
+ ## 🔑 reflection takeaways
21
+ - **internalized is prerequisite**: externalized knowledge is inert without an internalized framework to activate it.
22
+ - **externalized augments**: once the fundamentals are in place, external sources extend the system’s reach into precision and breadth.
23
+ - **true power lies in combination**: fluent intuition (internalized) guided by explicit reference (externalized).
24
+
25
+ ---
26
+
27
+ ## 📌 intuition anchor
28
+ a student with only a **formula sheet** but no understanding is stuck.
29
+ a student with only **intuition** risks errors.
30
+ but a student with **both** can solve a wide range of problems with accuracy and adaptability.
@@ -0,0 +1,44 @@
1
+ # 🧩 .brief: `internalized vs externalized knowledge`
2
+
3
+ ---
4
+
5
+ ## 🧠 what the contrast shows
6
+ knowledge can be understood in two fundamentally different forms:
7
+ - **internalized knowledge**: absorbed into the structure of a system (weights, habits, style)
8
+ - **externalized knowledge**: stored outside the system in explicit, retrievable records (databases, documents, libraries)
9
+
10
+ this contrast explains both the strengths and weaknesses of llms when relying solely on their weights versus when augmented with retrieval.
11
+
12
+ ---
13
+
14
+ ## 🎨 illustration frame
15
+ - **artist (internalized)**: paints in impressionist style without recalling a specific work. their training flows into expressive creation.
16
+ - **librarian (externalized)**: fetches the exact book that contains the answer. precision is guaranteed, but no new creation occurs.
17
+
18
+ ---
19
+
20
+ ## ⚙️ mapping to llms
21
+ - **internalized knowledge in weights**
22
+ - emerges through gradient descent across massive training corpora
23
+ - encoded as *distributed statistical patterns*, not explicit entries
24
+ - enables **generalization** and **creative recombination** of concepts
25
+ - limited by **fuzziness** and potential for **hallucination**
26
+
27
+ - **externalized knowledge in retrieval (rag, databases, tools)**
28
+ - stored explicitly, outside the model
29
+ - enables **accuracy** and **verifiability**
30
+ - limited by what is recorded and retrievable, no inherent *style* or *fluency*
31
+
32
+ ---
33
+
34
+ ## 🔑 contrast takeaways
35
+ - **internalized = embodied fluency**: adaptive, generative, pattern-driven
36
+ - **externalized = explicit record**: exact, grounded, reference-driven
37
+ - **hybrid strength**: combining both yields systems that can *express fluidly* while also *grounding in fact*.
38
+
39
+ ---
40
+
41
+ ## 📌 intuition anchor
42
+ an llm alone is like a **painter**: it embodies and expresses style.
43
+ with retrieval, it gains a **librarian**: grounding its creativity in precise references.
44
+ together, they demonstrate the full spectrum of knowledge handling.
@@ -0,0 +1,37 @@
1
+ # 🧩 .brief.demo: `contrasting internalized vs externalized knowledge`
2
+
3
+ ---
4
+
5
+ ## 🎨 illustration: artist vs photo album
6
+ - **internalized**: an artist paints a landscape in impressionist style. the scene is new, never painted before, but the *style* flows naturally from their training.
7
+ - **externalized**: another person, instead of painting, flips open a photo album to show a picture of a real landscape. it is precise, factual, but limited to what’s in the album.
8
+
9
+ ---
10
+
11
+ ## 🧠 llm parallel
12
+ - **internalized knowledge (in weights)**
13
+ - llms generate from *patterns encoded in their parameters*.
14
+ - they “know” paris is the capital of france not because a fact is stored explicitly, but because the statistical patterns linking “capital of france” → “paris” are internalized during training.
15
+ - *strengths*: generalization, stylistic fluency, application to unseen contexts.
16
+ - *limits*: fuzziness, hallucination, imprecision.
17
+
18
+ - **externalized knowledge (retrieval / database / rag)**
19
+ - systems query a source (wikipedia, sql table, search engine) to fetch the answer directly.
20
+ - paris is recalled exactly as written.
21
+ - *strengths*: precision, factual grounding, verifiability.
22
+ - *limits*: no fluency, no adaptation — must rely on what’s stored.
23
+
24
+ ---
25
+
26
+ ## ⚖️ contrast takeaways
27
+ - **internalized = style** → adaptive, expressive, compressed into structure.
28
+ - **externalized = record** → exact, reliable, stored outside the system.
29
+ - llms by default operate on **internalized knowledge**, but can be paired with external retrieval to combine *fluency* with *accuracy*.
30
+
31
+ ---
32
+
33
+ ## 🔑 intuition anchor
34
+ an llm is like a painter, not a librarian.
35
+ - the **painter** expresses patterns they’ve internalized into their craft.
36
+ - the **librarian** retrieves precise facts from shelves.
37
+ both approaches are useful, but they represent fundamentally different forms of knowledge.
@@ -0,0 +1,39 @@
1
+ # 🧩 .brief.demo: `contrasting knowledge via physics`
2
+
3
+ ---
4
+
5
+ ## ⚛️ illustration: physicist vs formula table
6
+ - **internalized (physicist’s intuition)**
7
+ - an experienced physicist can look at a problem — say, a ball rolling down an incline — and **intuitively anticipate** its acceleration or trajectory.
8
+ - they don’t consciously recall each derivation; years of practice have **internalized the principles** of mechanics.
9
+ - this allows them to solve novel problems, even ones never covered in class, by applying generalized patterns of motion, force, and energy.
10
+
11
+ - **externalized (formula reference table)**
12
+ - another student consults a table of equations: \(F=ma\), kinematic formulas, conservation laws.
13
+ - the reference ensures **exact correctness** when applied carefully, but it covers only the documented cases.
14
+ - without creativity, it cannot extend to unusual or unlisted scenarios.
15
+
16
+ ---
17
+
18
+ ## 🧠 llm parallel
19
+ - **internalized knowledge in weights**
20
+ - like the physicist, llms have absorbed statistical regularities across their training data.
21
+ - they can extend learned structures to **new prompts**, reasoning flexibly about unseen questions.
22
+ - limitation: they may make systematic errors when the internalized “intuition” misfires.
23
+
24
+ - **externalized knowledge in retrieval**
25
+ - like the formula table, retrieval provides **precise, explicit answers** or derivations.
26
+ - it guarantees correctness for known facts but cannot innovate beyond stored entries.
27
+
28
+ ---
29
+
30
+ ## 🔑 contrast takeaways
31
+ - **internalized = physicist’s intuition** → adaptive, generalizing, creative but fallible.
32
+ - **externalized = formula table** → precise, bounded, authoritative but rigid.
33
+ - llms alone resemble physicists reasoning from intuition; with retrieval, they combine intuition with the reliability of exact formulas.
34
+
35
+ ---
36
+
37
+ ## 📌 intuition anchor
38
+ an llm without retrieval is like a **physicist solving problems from intuition** — quick, adaptive, but prone to slips.
39
+ with retrieval, it becomes a physicist **plus a formula table** — intuition reinforced by exact references.
@@ -0,0 +1,35 @@
1
+ # 🧩 .brief: `internalized knowledge in llm weights`
2
+
3
+ ---
4
+
5
+ ## 🧠 how knowledge lives in llm weights
6
+
7
+ - **statistical associations**
8
+ during training, the model adjusts billions of parameters (weights) so that certain patterns of tokens predict others. what emerges are high-dimensional representations that capture regularities across text: facts, grammar, reasoning patterns, world structures.
9
+
10
+ - **distributed representation**
11
+ no single weight corresponds to a single fact (like “paris is the capital of france”). instead, many weights collectively encode the probability structure of phrases and contexts. knowledge is *smeared* across the parameter space.
12
+
13
+ - **emergent concepts**
14
+ neurons and attention heads sometimes specialize in representing particular structures (e.g. gendered pronouns, syntax boundaries, factual relationships). but these are still part of a network of overlapping functions, not isolated “fact cells.”
15
+
16
+ ---
17
+
18
+ ## 📊 what this implies
19
+
20
+ - **implicit knowledge**
21
+ the model *has* facts (e.g., it can usually complete “the capital of france is ___”), but it doesn’t “store” them in a database-like table. retrieval is probabilistic and context-dependent.
22
+
23
+ - **fuzziness & errors**
24
+ because knowledge is embedded as distributed patterns, recall isn’t guaranteed. the model may confuse similar facts or “hallucinate” when patterns overlap.
25
+
26
+ - **generalization**
27
+ knowledge in weights isn’t just memorized; it’s also compressed into *general rules*. that’s why llms can apply concepts to novel contexts they weren’t explicitly trained on.
28
+
29
+ ---
30
+
31
+ ## ⚖️ analogy
32
+
33
+ think of llm weights like the structure of a muscle trained through repetition:
34
+ - they don’t “remember” every exact movement, but they *embody* the regularities of movement.
35
+ - similarly, llm weights embody statistical regularities of language and facts.
@@ -0,0 +1,36 @@
1
+ # 🧩 .brief.demo: `style transfer for internalized knowledge`
2
+
3
+ ---
4
+
5
+ ## 🎨 essence of the frame
6
+ style transfer highlights how exposure to repeated patterns (in art, language, or reasoning) becomes **internalized capacity** rather than **explicit recall**.
7
+ - the artist does not carry a mental library of every impressionist canvas.
8
+ - instead, they have **absorbed the structure of impressionism**: how to layer colors, how to break light into strokes, how to balance softness with vibrancy.
9
+ - this “knowledge” manifests not as stored facts but as *fluid capability* to reproduce and adapt style in new contexts.
10
+
11
+ ---
12
+
13
+ ## 🧠 mapping to llms
14
+ - **training as exposure**
15
+ llms are exposed to vast corpora just as the artist is immersed in impressionist works. through gradient descent, the weights adapt to reflect these patterns.
16
+
17
+ - **weights as embodiment**
18
+ the learned style of language — grammar, facts, idioms, reasoning steps — becomes embedded in the weight matrix. no individual weight is “the fact,” but the whole structure embodies it.
19
+
20
+ - **generation as expression**
21
+ when prompted, the llm doesn’t “remember” training text. it **expresses** the internalized style of text it has absorbed, much like an artist expressing impressionism in a novel painting.
22
+
23
+ ---
24
+
25
+ ## 🔑 insights revealed
26
+ - **knowledge ≈ style**: both are *latent patterns* embodied in a system’s structure.
27
+ - **generalization over memorization**: an llm, like the artist, can apply its internalized patterns to situations it has never encountered before.
28
+ - **creative reconstruction**: outputs are not reproductions of training data but reconstructions consistent with internalized distributions.
29
+ - **hallucinations as byproduct**: just as an artist might invent an impressionist scene that never existed, llms may produce plausible but fabricated content.
30
+
31
+ ---
32
+
33
+ ## 📌 practical intuition
34
+ - **teaching style**: explaining llm knowledge as *“style internalized in weights”* makes it clear that the model isn’t storing a database, but embodying a way of *expressing patterns*.
35
+ - **limits of fidelity**: just as an artist cannot perfectly replicate a particular monet without copying, llms cannot guarantee perfect recall of a training fact.
36
+ - **adaptability**: both can transfer their internalized style onto new subjects (artist painting a modern skyline; llm generating in a new domain).
@@ -0,0 +1,37 @@
1
+ # 🧩 .brief.demo: `internalized knowledge in llm weights — neural memory frame`
2
+
3
+ ---
4
+
5
+ ## 🧠 demonstration
6
+
7
+ imagine recalling the fact: **“paris is the capital of france.”**
8
+ in a human brain, there is no single neuron labeled “capital of france.” instead:
9
+
10
+ - thousands of neurons encode fragments — sounds, associations, map images, cultural cues.
11
+ - when prompted, these neurons fire in **coordinated patterns** that reconstruct the memory.
12
+ - the *pattern of activation* is the knowledge, not any one unit.
13
+
14
+ ---
15
+
16
+ ## 🔗 llm parallel
17
+
18
+ - llm weights work the same way:
19
+ - no parameter contains “paris = france’s capital.”
20
+ - instead, billions of weights together create a high-dimensional pattern that *activates* when the model sees a related cue.
21
+ - output emerges from **distributed representations** aligning to the prompt.
22
+
23
+ ---
24
+
25
+ ## 📊 implications
26
+
27
+ - **not a database** — knowledge isn’t stored as discrete rows or entries.
28
+ - **probabilistic recall** — outputs can vary depending on context, like humans remembering fuzzily.
29
+ - **generalization** — internalized patterns allow extrapolation beyond explicit memorization.
30
+
31
+ ---
32
+
33
+ ## ⚖️ takeaway
34
+
35
+ just as human memory is **patterned activation** rather than a single storage cell,
36
+ llm knowledge is **internalized in distributed weight patterns**,
37
+ reconstructed dynamically when queried.
@@ -0,0 +1,34 @@
1
+ # 🧩 .brief.demo: `internalized knowledge in llm weights — muscle memory frame`
2
+
3
+ ---
4
+
5
+ ## 🏋️‍♂️ demonstration
6
+
7
+ imagine a pianist sitting at the keyboard:
8
+ - their fingers glide through a complex sonata without consciously recalling each individual note.
9
+ - the *knowledge of the music* isn’t stored as a verbal list of notes in their mind — it is internalized in the coordination of muscles and neural circuits.
10
+ - when prompted with the opening bars, the full sequence flows out through trained patterns.
11
+
12
+ ---
13
+
14
+ ## 🔑 intuition
15
+
16
+ - **distributed**: no single muscle or neuron “contains” the sonata — it is spread across the system.
17
+ - **implicit**: the pianist cannot always verbalize *how* they play; the knowledge is enacted, not explicitly recalled.
18
+ - **emergent**: repeated practice shapes a network of pathways that allow fluent performance.
19
+
20
+ ---
21
+
22
+ ## 📊 mapping to llms
23
+
24
+ - llm weights = the pianist’s trained muscles and neural pathways
25
+ - prompts = the opening bars that trigger the sequence
26
+ - completions = the flowing music generated from internalized patterns
27
+ - internalized knowledge = the capacity to recall and generalize without explicit storage of “facts”
28
+
29
+ ---
30
+
31
+ ## ⚖️ takeaway
32
+
33
+ just as a pianist embodies a song in trained muscle memory, llms embody world knowledge in their parameters.
34
+ - both systems *don’t remember every detail explicitly* — instead, they perform by drawing on **internalized, distributed patterns** of practice.
@@ -0,0 +1,46 @@
1
+ # 🧩 .brief: `llm ability to understand rhyme`
2
+
3
+ ## 🔑 what it implies
4
+
5
+ since each token starts as a static embedding but then diverges into contextual hidden states, rhyme is not encoded in the hidden state by default — it has to be learned through patterns across embeddings and contexts.
6
+
7
+ rhyme is about **phonological similarity** (shared suffix sounds). llms don’t hear sounds; they see tokens. so:
8
+
9
+ - if the tokenizer splits words like “cat” and “hat” into full tokens, then their embeddings might end up closer in vector space because they co-occur in similar phonetic/poetic training data.
10
+ - if the tokenizer breaks words into subwords, e.g. “##at”, rhyme similarity is captured more directly (both “cat” and “hat” share the suffix embedding).
11
+ - during self-attention, heads could learn to connect tokens with similar endings, especially in rhyme-heavy text (poetry, song lyrics). this would look a lot like the “bank” demo: two different tokens forming stronger similarity in some heads because of shared suffix representations.
12
+
13
+ ---
14
+
15
+ ## 🎯 implications for rhyme recognition
16
+
17
+ - **subword overlap**
18
+ - if the tokenizer preserves suffix chunks (`-at`, `-ight`), rhyme is easier.
19
+ - embeddings for those suffixes can become strong cues.
20
+
21
+ - **attention heads**
22
+ - some heads may specialize in form-based similarity (orthographic/phonetic).
23
+ - others focus on semantics or syntax.
24
+ - multi-head attention enables parallel “views”: one could be capturing rhymes while another tracks meaning.
25
+
26
+ - **disambiguation vs rhyme**
27
+ - in the “bank” case, heads attend differently to disambiguate meaning.
28
+ - in rhyme, heads might attend similarly across different words, reinforcing their phonetic link regardless of semantics.
29
+
30
+ ---
31
+
32
+ ## 🧩 example
33
+
34
+ > “the **cat** wore a funny **hat**.”
35
+
36
+ - **embeddings:** “cat” ≠ “hat,” but both contain suffix “-at.”
37
+ - **hidden states:** self-attention might increase similarity because the q of “cat” matches the k of “hat” in a rhyme-sensitive head.
38
+ - **value vectors:** both updated to reflect “these words rhyme.”
39
+
40
+ ---
41
+
42
+ ## 📊 insight
43
+
44
+ - llms don’t have an innate sense of sound, but **subword embeddings + attention** let them approximate rhyme by picking up on visual/orthographic patterns.
45
+ - rhyme perception is therefore **statistical, not phonological** — it depends on the tokenizer and training data distribution.
46
+ - but the mechanism is parallel to disambiguating “bank”: attention binds tokens through **learned similarity in q/k space.**
@@ -0,0 +1,49 @@
1
+ # 🧩 .brief: `llm ability to spell`
2
+
3
+ ## 🔑 what it implies
4
+
5
+ since each token starts as a **static embedding** and spelling is distributed across subwords, an llm’s ability to spell is **not innate** but emerges from:
6
+
7
+ - the **tokenizer**: if words are whole tokens, the model never “sees” individual letters, so it can only memorize spelling patterns for known words.
8
+ - if the tokenizer breaks words into **character-like subwords**, the model can generalize spelling more flexibly (assemble words from parts).
9
+ - **contextual hidden states**: spelling consistency isn’t reinforced the same way semantics or rhyme are. most training data emphasizes meaning, not orthographic correctness.
10
+ - **self-attention**: heads may capture common letter/suffix chunks, but nothing forces them to maintain letter-by-letter accuracy unless trained specifically (e.g., code models, spelling correction).
11
+
12
+ ---
13
+
14
+ ## 🎯 implications for spelling ability
15
+
16
+ - **memorization over generation**
17
+ - llms can reproduce spellings they’ve seen often.
18
+ - rare or novel words are harder because embeddings don’t break down fully into letters.
19
+
20
+ - **tokenizer bias**
21
+ - byte-pair encodings (bpe) bias toward common subwords, not individual letters.
22
+ - spelling errors occur when tokenization splits a word into unusual or unseen chunks.
23
+
24
+ - **generalization**
25
+ - some subword overlap allows limited spelling generalization (e.g., “##tion,” “##ing”).
26
+ - but full orthographic rules are weak unless trained at character level.
27
+
28
+ - **multi-head dynamics**
29
+ - some heads may track morpheme or suffix consistency.
30
+ - others prioritize syntax or semantics, so spelling accuracy is not their focus.
31
+
32
+ ---
33
+
34
+ ## 🧩 example
35
+
36
+ > generating “pharaoh”
37
+
38
+ - **embedding level:** tokenization may split as `[“ph”, “ara”, “oh”]` or something arbitrary.
39
+ - **hidden state evolution:** model predicts plausible continuation from context but may choose an alternate form (“pharoah”) if that variant appears in data.
40
+ - **output:** correct spelling depends on frequency balance in training data, not explicit rules.
41
+
42
+ ---
43
+
44
+ ## 📊 insight
45
+
46
+ - llms **do not inherently know spelling rules** — they approximate them statistically from text distributions.
47
+ - good spelling emerges in proportion to **training data quality and tokenizer granularity**.
48
+ - unlike rhyme (which can be reinforced by subword overlaps), spelling requires **fine-grained character awareness**, which many tokenizers blur.
49
+ - in short: **llms spell by memory and pattern frequency, not by rule.**
@@ -0,0 +1,28 @@
1
+ # 📊 effectiveness of teaching llms via example libraries
2
+
3
+ ## ✅ strengths
4
+ - **highly effective for style & format control**
5
+ - the model will reliably mimic demonstrated structures (e.g. JSON schema, markdown brief, SQL pattern).
6
+ - **task-specific alignment**
7
+ - if the examples cover the distribution of tasks, the model adapts very well in-session.
8
+ - **fast & flexible**
9
+ - no retraining, just update the example set.
10
+
11
+ ---
12
+
13
+ ## ⚠️ limits
14
+ - **shallow generalization**
15
+ - effectiveness drops if the input strays outside what the examples illustrate.
16
+ - **rigid mimicry**
17
+ - the model tends to overfit: it copies examples rather than abstracting.
18
+ - **context overhead**
19
+ - effectiveness shrinks as the example library grows beyond the model’s active attention window.
20
+ - **no persistence**
21
+ - nothing is learned across sessions — you must re-teach every time.
22
+
23
+ ---
24
+
25
+ ## 🎯 bottom line
26
+ - **short tasks, narrow domains:** very effective.
27
+ - **broad reasoning, novel domains:** much less effective.
28
+ - think of it as *teaching the llm to “act trained”* for one prompt — not actual durable learning.
@@ -0,0 +1,40 @@
1
+ # 🎛️ in-context tuning: explanations vs examples
2
+
3
+ ## 🧩 examples
4
+ - **what they do:** show *how* to perform the task by demonstration.
5
+ - **strengths:**
6
+ - precise control over output **format** and **style**
7
+ - model can “copy the pattern” with little ambiguity
8
+ - fast to apply, low cognitive overhead for the model
9
+ - **weaknesses:**
10
+ - brittle if task deviates from the pattern
11
+ - encourages mimicry rather than reasoning
12
+
13
+ ---
14
+
15
+ ## 🧩 explanations
16
+ - **what they do:** tell *why* and *how* the task should be done via rules, instructions, or reasoning steps.
17
+ - **strengths:**
18
+ - supports **generalization** beyond shown cases
19
+ - encourages **reasoning chains** instead of rote mimicry
20
+ - more compact than many examples (token-wise)
21
+ - **weaknesses:**
22
+ - less consistent for rigid formats (the model may improvise)
23
+ - requires the model to “translate” abstract rules into concrete actions, which can be noisy
24
+
25
+ ---
26
+
27
+ ## ⚖️ effectiveness comparison
28
+ - **examples win** when:
29
+ - the task is about *output form* (e.g. json schemas, sql syntax, markdown briefs)
30
+ - consistency is more important than novelty
31
+ - **explanations win** when:
32
+ - the task is about *reasoning* or handling unseen variations
33
+ - flexibility and abstraction matter more than surface mimicry
34
+
35
+ ---
36
+
37
+ ## 🎯 hybrid strategy
38
+ - the strongest “in-context tunage” usually comes from **explanations + 1–2 examples**.
39
+ - explanation gives the **reasoning scaffold**
40
+ - examples ground it with **concrete reference points**
@@ -0,0 +1,10 @@
1
+ llms prefer reuse input tokens
2
+
3
+ why?
4
+ - why do they do that (rationale)
5
+ - why do we care? (causal)
6
+ - how we can use it
7
+
8
+ ---
9
+
10
+ i.e., most of the time, safe to expect it'll only change the bare minimum
@@ -0,0 +1,61 @@
1
+ import { GStitcher, Threads, RoleContext } from 'rhachet';
2
+ import { Artifact } from 'rhachet-artifact';
3
+ import { GitFile } from 'rhachet-artifact-git';
4
+ import { Focus } from '../../../../_topublish/rhachet-roles-bhrain/src/domain/objects/Focus';
5
+ import { ContextOpenAI } from '../../../../data/sdk/sdkOpenAi';
6
+ export declare const BRIEFS_FOR_ARTICULATE: Artifact<typeof GitFile, string>[];
7
+ type StitcherDesired = GStitcher<Threads<{
8
+ caller: RoleContext<'caller', {
9
+ ask: string;
10
+ art: {
11
+ feedback: Artifact<typeof GitFile>;
12
+ 'foci.goal.concept': Focus['concept'];
13
+ 'foci.goal.context': Focus['context'];
14
+ templates: Artifact<typeof GitFile>[];
15
+ };
16
+ refs: Artifact<typeof GitFile>[];
17
+ }>;
18
+ thinker: RoleContext<'thinker', {
19
+ art: {
20
+ 'focus.concept': Focus['concept'];
21
+ 'focus.context': Focus['context'];
22
+ 'foci.ponder.ans.concept': Focus['concept'];
23
+ };
24
+ briefs: Artifact<typeof GitFile>[];
25
+ }>;
26
+ }>, ContextOpenAI & GStitcher['context'], {
27
+ content: string;
28
+ }>;
29
+ export declare const stepArticulate: import("rhachet").Stitcher<StitcherDesired>;
30
+ export declare const loopArticulate: import("rhachet").Stitcher<GStitcher<Threads<{
31
+ caller: RoleContext<"caller", {
32
+ ask: string;
33
+ art: {
34
+ feedback: Artifact<typeof GitFile>;
35
+ 'foci.goal.concept': Focus['concept'];
36
+ 'foci.goal.context': Focus['context'];
37
+ templates: Artifact<typeof GitFile>[];
38
+ };
39
+ refs: Artifact<typeof GitFile>[];
40
+ } & {
41
+ ask: string;
42
+ art: {
43
+ feedback: Artifact<typeof GitFile, string>;
44
+ };
45
+ }>;
46
+ thinker: RoleContext<"thinker", {
47
+ art: {
48
+ 'focus.concept': Focus['concept'];
49
+ 'focus.context': Focus['context'];
50
+ 'foci.ponder.ans.concept': Focus['concept'];
51
+ };
52
+ briefs: Artifact<typeof GitFile>[];
53
+ } & {
54
+ art: {
55
+ "focus.concept": Artifact<typeof GitFile, string>;
56
+ };
57
+ }>;
58
+ }>, ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
59
+ feedback: GitFile | null;
60
+ }>>;
61
+ export {};