@haaaiawd/loom 1.3.1 → 2.0.1

package/docs/loom-eval-loop.drawio

@@ -0,0 +1,21 @@
+<mxfile host="app.diagrams.net" modified="2026-08-09T22:30:00.000Z" agent="Codex" version="24.7.17">
+  <diagram id="loom-eval" name="LOOM Evil Eval">
+    <mxGraphModel dx="1600" dy="860" grid="1" gridSize="10" guides="1" page="1" pageScale="1" pageWidth="1600" pageHeight="860"><root><mxCell id="0"/><mxCell id="1" parent="0"/>
+      <mxCell id="title" value="The Evil Eval: does LOOM cause the gain?" style="text;html=1;fontSize=28;fontStyle=1;fontColor=#17212B;align=left;" vertex="1" parent="1"><mxGeometry x="70" y="30" width="900" height="50" as="geometry"/></mxCell>
+      <mxCell id="controls" value="FREEZE EVERYTHING EXCEPT THE TREATMENT&lt;br&gt;same model · same tools · same workspace · same hidden user facts · same budget · same reset schedule · ≥ 3 repeats" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#17212B;strokeColor=#17212B;fontColor=#F5F2EA;fontStyle=1;align=left;spacingLeft=24;" vertex="1" parent="1"><mxGeometry x="70" y="110" width="1460" height="90" as="geometry"/></mxCell>
+      <mxCell id="a-band" value="A · BASELINE — Normal Agent, no LOOM" style="swimlane;horizontal=1;startSize=52;rounded=1;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#C7C2B8;fontColor=#58636D;fontStyle=1;" vertex="1" parent="1"><mxGeometry x="70" y="240" width="700" height="270" as="geometry"/></mxCell>
+      <mxCell id="b-band" value="B · TREATMENT — Same Agent, LOOM available" style="swimlane;horizontal=1;startSize=52;rounded=1;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#4169E1;fontColor=#4169E1;fontStyle=1;" vertex="1" parent="1"><mxGeometry x="830" y="240" width="700" height="270" as="geometry"/></mxCell>
+      <mxCell id="a1" value="&lt;b&gt;Shape project&lt;/b&gt;&lt;br&gt;questions · decisions&lt;br&gt;plans · documents" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="105" y="335" width="175" height="85" as="geometry"/></mxCell><mxCell id="a2" value="&lt;b&gt;Force reset&lt;/b&gt;&lt;br&gt;after shaping&lt;br&gt;and mid-Task" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F9E4DE;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="330" y="335" width="175" height="85" as="geometry"/></mxCell><mxCell id="a3" value="&lt;b&gt;Fresh Agent&lt;/b&gt;&lt;br&gt;continue from disk&lt;br&gt;build vertical slice" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="555" y="335" width="175" height="85" as="geometry"/></mxCell>
+      <mxCell id="b1" value="&lt;b&gt;Shape with LOOM&lt;/b&gt;&lt;br&gt;same brief and Agent&lt;br&gt;treatment only" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="865" y="335" width="175" height="85" as="geometry"/></mxCell><mxCell id="b2" value="&lt;b&gt;Force reset&lt;/b&gt;&lt;br&gt;identical timing&lt;br&gt;identical budget" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F9E4DE;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="1090" y="335" width="175" height="85" as="geometry"/></mxCell><mxCell id="b3" value="&lt;b&gt;Fresh Agent&lt;/b&gt;&lt;br&gt;use LOOM disk truth&lt;br&gt;build vertical slice" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E8ECFA;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="1315" y="335" width="175" height="85" as="geometry"/></mxCell>
+      <mxCell id="ae1" edge="1" source="a1" target="a2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="ae2" edge="1" source="a2" target="a3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="be1" edge="1" source="b1" target="b2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="be2" edge="1" source="b2" target="b3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/>
+      <mxCell id="collect-a" value="COLLECT · questions · docs · code · tests · time · tokens · user burden" style="text;html=1;fontSize=11;fontColor=#58636D;align=left;" vertex="1" parent="1"><mxGeometry x="105" y="450" width="610" height="30" as="geometry"/></mxCell><mxCell id="collect-b" value="COLLECT · the same artifact classes, under the same stopping rule" style="text;html=1;fontSize=11;fontColor=#58636D;align=left;" vertex="1" parent="1"><mxGeometry x="865" y="450" width="610" height="30" as="geometry"/></mxCell>
+      <mxCell id="judge" value="BLIND PAIRWISE JUDGE&lt;br&gt;&lt;b&gt;Anonymize → randomize → swap order&lt;/b&gt;&lt;br&gt;Preflight the packet; repeat ≥ 3" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#E88773;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="590" y="560" width="420" height="105" as="geometry"/></mxCell>
+      <mxCell id="aj" edge="1" source="a-band" target="judge" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="bj" edge="1" source="b-band" target="judge" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/>
+      <mxCell id="score" value="&lt;b&gt;SCORE NET VALUE&lt;/b&gt;&lt;br&gt;intent · question value · buildability&lt;br&gt;continuity · burden · cost · ceremony" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="120" y="720" width="280" height="85" as="geometry"/></mxCell>
+      <mxCell id="gain" value="Reliable net gain across repeats?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="520" y="710" width="230" height="105" as="geometry"/></mxCell>
+      <mxCell id="yes" value="YES · ABLATE&lt;br&gt;&lt;b&gt;Find the causal mechanism&lt;/b&gt;&lt;br&gt;keep only what creates the gain" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E3F3ED;strokeColor=#9AD8C2;" vertex="1" parent="1"><mxGeometry x="870" y="720" width="250" height="85" as="geometry"/></mxCell>
+      <mxCell id="no" value="NO · BE EVIL&lt;br&gt;&lt;b&gt;Simplify, revise, or delete&lt;/b&gt;&lt;br&gt;ceremony gets no sympathy" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F9E4DE;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="1230" y="720" width="250" height="85" as="geometry"/></mxCell>
+      <mxCell id="js" edge="1" source="judge" target="score" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="sg" edge="1" source="score" target="gain" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="gy" value="yes" edge="1" source="gain" target="yes" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="gn" value="no" edge="1" source="gain" target="no" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="635" y="835"/><mxPoint x="1355" y="835"/></Array></mxGeometry></mxCell>
+    </root></mxGraphModel>
+  </diagram>
+</mxfile>

package/docs/loom-eval-loop.svg

@@ -0,0 +1,56 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="860" viewBox="0 0 1600 860" role="img" aria-labelledby="title desc">
+  <title id="title">LOOM Evil Eval</title>
+  <desc id="desc">A controlled comparison between the same capable Agent without a framework and with LOOM, followed by blinded judging and ablation.</desc>
+  <defs>
+    <marker id="a" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0 10 5 0 10Z" fill="#17212B"/></marker>
+    <marker id="ba" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0 10 5 0 10Z" fill="#4169E1"/></marker>
+    <style>text{font-family:Inter,Segoe UI,Arial,sans-serif;fill:#17212B}.title{font-size:34px;font-weight:760}.subtitle{font-size:16px;fill:#58636D}.eyebrow{font-size:11px;font-weight:760;letter-spacing:1.35px}.h{font-size:16px;font-weight:720}.body{font-size:12px;fill:#58636D}.small{font-size:11px;font-weight:690}.inverse{fill:#F5F2EA}.mint{fill:#9AD8C2}.edge{fill:none;stroke:#17212B;stroke-width:2.2;marker-end:url(#a)}.feedback{fill:none;stroke:#4169E1;stroke-width:2.3;stroke-dasharray:7 7;marker-end:url(#ba)}</style>
+  </defs>
+  <rect width="1600" height="860" fill="#F5F2EA"/>
+  <text class="title" x="70" y="62">The Evil Eval: does LOOM cause the gain?</text>
+  <text class="subtitle" x="70" y="92">Primary comparison: the same capable Agent, with and without the framework—not LOOM 2 versus its weaker ancestor.</text>
+
+  <rect x="70" y="128" width="1460" height="92" rx="20" fill="#17212B"/>
+  <text class="eyebrow mint" x="98" y="158">FREEZE EVERYTHING EXCEPT THE TREATMENT</text>
+  <g font-family="ui-monospace,SFMono-Regular,Consolas,monospace" font-size="13">
+    <text class="inverse" x="98" y="190">same model</text><text class="inverse" x="264" y="190">same tools</text><text class="inverse" x="416" y="190">same workspace</text><text class="inverse" x="600" y="190">same hidden user facts</text><text class="inverse" x="846" y="190">same budget</text><text class="inverse" x="996" y="190">same reset schedule</text><text class="inverse" x="1240" y="190">≥ 3 repeats</text>
+  </g>
+
+  <!-- parallel lanes -->
+  <g>
+    <rect x="70" y="258" width="702" height="276" rx="22" fill="#FBFAF6" stroke="#D8D3C8"/>
+    <rect x="70" y="258" width="10" height="276" rx="5" fill="#C7C2B8"/>
+    <rect x="828" y="258" width="702" height="276" rx="22" fill="#FBFAF6" stroke="#D8D3C8"/>
+    <rect x="828" y="258" width="10" height="276" rx="5" fill="#4169E1"/>
+    <text class="eyebrow" x="104" y="292" fill="#58636D">A · BASELINE</text><text class="h" x="104" y="320">Normal Agent, no LOOM</text>
+    <text class="eyebrow" x="862" y="292" fill="#4169E1">B · TREATMENT</text><text class="h" x="862" y="320">Same Agent, LOOM available</text>
+    <g transform="translate(104 352)"><rect width="176" height="88" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="h" x="14" y="33">Shape the project</text><text class="body" x="14" y="55">questions · decisions</text><text class="body" x="14" y="72">plans · documents</text></g>
+    <g transform="translate(332 352)"><rect width="176" height="88" rx="14" fill="#F9E4DE" stroke="#E88773"/><text class="h" x="14" y="33">Force reset</text><text class="body" x="14" y="55">after shaping</text><text class="body" x="14" y="72">and mid-Task</text></g>
+    <g transform="translate(560 352)"><rect width="176" height="88" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="h" x="14" y="33">Fresh Agent</text><text class="body" x="14" y="55">continue from disk</text><text class="body" x="14" y="72">build vertical slice</text></g>
+    <path class="edge" d="M280 396H332"/><path class="edge" d="M508 396H560"/>
+    <g transform="translate(862 352)"><rect width="176" height="88" rx="14" fill="#FFFFFF" stroke="#4169E1"/><text class="h" x="14" y="33">Shape with LOOM</text><text class="body" x="14" y="55">same brief and Agent</text><text class="body" x="14" y="72">treatment only</text></g>
+    <g transform="translate(1090 352)"><rect width="176" height="88" rx="14" fill="#F9E4DE" stroke="#E88773"/><text class="h" x="14" y="33">Force reset</text><text class="body" x="14" y="55">identical timing</text><text class="body" x="14" y="72">identical budget</text></g>
+    <g transform="translate(1318 352)"><rect width="176" height="88" rx="14" fill="#E8ECFA" stroke="#4169E1"/><text class="h" x="14" y="33">Fresh Agent</text><text class="body" x="14" y="55">use LOOM disk truth</text><text class="body" x="14" y="72">build vertical slice</text></g>
+    <path class="edge" d="M1038 396H1090"/><path class="edge" d="M1266 396H1318"/>
+    <text class="small" x="104" y="483">COLLECT</text><text class="body" x="104" y="505">questions · docs · code · tests · time · tokens · user burden · failure recovery</text>
+    <text class="small" x="862" y="483">COLLECT</text><text class="body" x="862" y="505">the same artifact classes, under the same stopping rule</text>
+  </g>
+
+  <!-- judging -->
+  <g>
+    <path class="edge" d="M421 534V580H590"/><path class="edge" d="M1179 534V580H1010"/>
+    <rect x="590" y="558" width="420" height="108" rx="20" fill="#FFFFFF" stroke="#E88773" stroke-width="1.5"/>
+    <text class="eyebrow" x="800" y="588" text-anchor="middle" fill="#A84D3C">BLIND PAIRWISE JUDGE</text>
+    <text class="h" x="800" y="617" text-anchor="middle">Anonymize → randomize → swap order</text>
+    <text class="body" x="800" y="642" text-anchor="middle">Preflight the judge packet; broken harness evidence cannot become product evidence.</text>
+  </g>
+  <g transform="translate(122 708)">
+    <rect width="278" height="84" rx="16" fill="#FFFFFF" stroke="#C7C2B8"/>
+    <text class="eyebrow" x="16" y="26" fill="#58636D">SCORE NET VALUE</text><text class="body" x="16" y="49">intent · question value · buildability</text><text class="body" x="16" y="67">continuity · burden · cost · ceremony</text>
+  </g>
+  <g transform="translate(522 698)"><path d="M114 0 228 52 114 104 0 52Z" fill="#FFFFFF" stroke="#4169E1" stroke-width="1.5"/><text class="h" x="114" y="48" text-anchor="middle">Reliable net gain?</text><text class="body" x="114" y="68" text-anchor="middle">across repeats</text></g>
+  <g transform="translate(872 708)"><rect width="250" height="84" rx="16" fill="#E3F3ED" stroke="#9AD8C2"/><text class="eyebrow" x="16" y="26" fill="#367D67">YES · ABLATE</text><text class="h" x="16" y="50">Find the causal mechanism</text><text class="body" x="16" y="69">keep only what creates the gain</text></g>
+  <g transform="translate(1234 708)"><rect width="250" height="84" rx="16" fill="#F9E4DE" stroke="#E88773"/><text class="eyebrow" x="16" y="26" fill="#A84D3C">NO · BE EVIL</text><text class="h" x="16" y="50">Simplify, revise, or delete</text><text class="body" x="16" y="69">ceremony gets no sympathy</text></g>
+  <path class="edge" d="M590 634H261V708"/><path class="edge" d="M400 750H522"/><path class="edge" d="M750 750H872"/><text class="small" x="792" y="738">YES</text><path class="edge" d="M636 802V826H1359V792"/><text class="small" x="664" y="820">NO</text>
+  <text class="body" x="70" y="842">A single pilot is directional evidence, not a statistical conclusion. Optional LOOM 1 runs are regression checks—not the primary baseline.</text>
+</svg>

package/docs/loom-production-loop.drawio

@@ -0,0 +1,41 @@
+<mxfile host="app.diagrams.net" modified="2026-08-09T22:30:00.000Z" agent="Codex" version="24.7.17">
+  <diagram id="loom-production" name="LOOM Production Loops">
+    <mxGraphModel dx="1600" dy="1000" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1600" pageHeight="1000" math="0" shadow="0">
+      <root><mxCell id="0"/><mxCell id="1" parent="0"/>
+        <mxCell id="title" value="One system. Three honest loops." style="text;html=1;fontSize=30;fontStyle=1;fontColor=#17212B;align=left;" vertex="1" parent="1"><mxGeometry x="50" y="30" width="700" height="50" as="geometry"/></mxCell>
+        <mxCell id="u-band" value="01 · UNDERSTANDING LOOP" style="swimlane;horizontal=1;startSize=52;rounded=1;arcSize=8;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#9AD8C2;fontColor=#367D67;fontStyle=1;fontSize=16;" vertex="1" parent="1"><mxGeometry x="50" y="110" width="1500" height="240" as="geometry"/></mxCell>
+        <mxCell id="u1" value="HUMAN&lt;br&gt;&lt;b&gt;Natural request&lt;/b&gt;&lt;br&gt;idea · correction · answer" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="90" y="205" width="185" height="80" as="geometry"/></mxCell>
+        <mxCell id="u2" value="AGENT&lt;br&gt;&lt;b&gt;Describe the result&lt;/b&gt;&lt;br&gt;inspect only when relevant" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="325" y="205" width="215" height="80" as="geometry"/></mxCell>
+        <mxCell id="u3" value="Material unknowns still change the whole?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="590" y="195" width="190" height="100" as="geometry"/></mxCell>
+        <mxCell id="u4" value="&lt;b&gt;Ask one dense round&lt;/b&gt;&lt;br&gt;adaptive · consequential&lt;br&gt;not a fixed questionnaire" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="830" y="205" width="205" height="80" as="geometry"/></mxCell>
+        <mxCell id="u5" value="&lt;b&gt;Update project truth&lt;/b&gt;&lt;br&gt;facts · decisions · designs&lt;br&gt;separate field dossiers" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="1085" y="205" width="215" height="80" as="geometry"/></mxCell>
+        <mxCell id="u6" value="&lt;b&gt;Build-ready&lt;/b&gt;&lt;br&gt;candidate" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E3F3ED;strokeColor=#9AD8C2;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="1350" y="205" width="150" height="80" as="geometry"/></mxCell>
+        <mxCell id="u-e1" edge="1" source="u1" target="u2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"/><mxCell id="u-e2" edge="1" source="u2" target="u3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"/><mxCell id="u-e3" value="yes" edge="1" source="u3" target="u4" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"/><mxCell id="u-e4" edge="1" source="u4" target="u5" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"/>
+        <mxCell id="u-no" value="no · local gaps only" edge="1" source="u3" target="u6" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="685" y="310"/><mxPoint x="1425" y="310"/></Array></mxGeometry></mxCell>
+        <mxCell id="u-loop" value="re-evaluate" edge="1" source="u5" target="u3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;dashed=1;dashPattern=8 8;endArrow=block;strokeColor=#4169E1;fontColor=#4169E1;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="1190" y="330"/><mxPoint x="685" y="330"/></Array></mxGeometry></mxCell>
+
+        <mxCell id="k-band" value="02 · KEEPER LOOP" style="swimlane;horizontal=1;startSize=52;rounded=1;arcSize=8;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#E88773;fontColor=#A84D3C;fontStyle=1;fontSize=16;" vertex="1" parent="1"><mxGeometry x="50" y="390" width="1500" height="240" as="geometry"/></mxCell>
+        <mxCell id="k1" value="&lt;b&gt;Validate + freeze digest&lt;/b&gt;&lt;br&gt;PROJECT · designs · dossiers&lt;br&gt;Work Map · first Task" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="90" y="485" width="220" height="80" as="geometry"/></mxCell>
+        <mxCell id="k2" value="FRESH AGENT&lt;br&gt;&lt;b&gt;Independently inspect&lt;/b&gt;&lt;br&gt;same frozen digest" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="360" y="485" width="220" height="80" as="geometry"/></mxCell>
+        <mxCell id="k3" value="Can responsibly start the first Task?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="630" y="475" width="200" height="100" as="geometry"/></mxCell>
+        <mxCell id="k4" value="&lt;b&gt;Return exact gaps&lt;/b&gt;&lt;br&gt;needs_revision / blocked&lt;br&gt;evidence · files · consequences" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F9E4DE;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="880" y="485" width="220" height="80" as="geometry"/></mxCell>
+        <mxCell id="k5" value="&lt;b&gt;Repair the source&lt;/b&gt;&lt;br&gt;new digest&lt;br&gt;different fresh Keeper" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="1150" y="485" width="180" height="80" as="geometry"/></mxCell>
+        <mxCell id="k6" value="&lt;b&gt;Passed&lt;/b&gt;&lt;br&gt;handoff once" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E3F3ED;strokeColor=#9AD8C2;" vertex="1" parent="1"><mxGeometry x="1380" y="485" width="130" height="80" as="geometry"/></mxCell>
+        <mxCell id="k-e1" edge="1" source="k1" target="k2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="k-e2" edge="1" source="k2" target="k3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="k-e3" value="no" edge="1" source="k3" target="k4" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="k-e4" edge="1" source="k4" target="k5" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="k-yes" value="yes" edge="1" source="k3" target="k6" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="730" y="450"/><mxPoint x="1445" y="450"/></Array></mxGeometry></mxCell>
+        <mxCell id="k-loop" value="new digest · new run_id · new Keeper" edge="1" source="k5" target="k2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;dashed=1;dashPattern=8 8;endArrow=block;strokeColor=#4169E1;fontColor=#4169E1;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="1240" y="600"/><mxPoint x="470" y="600"/></Array></mxGeometry></mxCell>
+
+        <mxCell id="d-band" value="03 · DELIVERY LOOP" style="swimlane;horizontal=1;startSize=52;rounded=1;arcSize=8;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#4169E1;fontColor=#4169E1;fontStyle=1;fontSize=16;" vertex="1" parent="1"><mxGeometry x="50" y="670" width="1500" height="270" as="geometry"/></mxCell>
+        <mxCell id="d1" value="&lt;b&gt;Select next Task&lt;/b&gt;&lt;br&gt;dependencies satisfied&lt;br&gt;active horizon only" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="90" y="770" width="180" height="80" as="geometry"/></mxCell>
+        <mxCell id="d2" value="&lt;b&gt;Compile exact context&lt;/b&gt;&lt;br&gt;reads · constraints&lt;br&gt;done conditions · evidence" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="315" y="770" width="205" height="80" as="geometry"/></mxCell>
+        <mxCell id="d3" value="&lt;b&gt;Build → observe&lt;/b&gt;&lt;br&gt;test → adjust&lt;br&gt;keep local failures local" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="565" y="770" width="190" height="80" as="geometry"/></mxCell>
+        <mxCell id="d4" value="Done conditions actually proven?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="800" y="760" width="180" height="100" as="geometry"/></mxCell>
+        <mxCell id="d5" value="&lt;b&gt;Record exact evidence&lt;/b&gt;&lt;br&gt;complete / block / reopen&lt;br&gt;preserve what comes next" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E8ECFA;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="1025" y="770" width="205" height="80" as="geometry"/></mxCell>
+        <mxCell id="d6" value="More Tasks or new upper gap?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="1275" y="760" width="170" height="100" as="geometry"/></mxCell>
+        <mxCell id="d7" value="DELIVER" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#17212B;strokeColor=#17212B;fontColor=#F5F2EA;fontStyle=1;" vertex="1" parent="1"><mxGeometry x="1470" y="780" width="60" height="60" as="geometry"/></mxCell>
+        <mxCell id="d-e1" edge="1" source="d1" target="d2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e2" edge="1" source="d2" target="d3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e3" edge="1" source="d3" target="d4" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e4" value="yes" edge="1" source="d4" target="d5" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e5" edge="1" source="d5" target="d6" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e6" value="done" edge="1" source="d6" target="d7" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/>
+        <mxCell id="d-local" value="local no · iterate" edge="1" source="d4" target="d3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;dashed=1;dashPattern=8 8;endArrow=block;strokeColor=#4169E1;fontColor=#4169E1;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="890" y="890"/><mxPoint x="660" y="890"/></Array></mxGeometry></mxCell>
+        <mxCell id="d-more" value="more Tasks · or block → repair upper source → reopen" edge="1" source="d6" target="d1" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;dashed=1;dashPattern=8 8;endArrow=block;strokeColor=#4169E1;fontColor=#4169E1;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="1360" y="920"/><mxPoint x="180" y="920"/></Array></mxGeometry></mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

package/docs/loom-production-loop.svg

@@ -0,0 +1,92 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1000" viewBox="0 0 1600 1000" role="img" aria-labelledby="title desc">
+  <title id="title">The LOOM production loop</title>
+  <desc id="desc">Three clean feedback loops for understanding, independent Keeper review, and restartable task delivery.</desc>
+  <defs>
+    <marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0 10 5 0 10Z" fill="#17212B"/></marker>
+    <marker id="blue-arrow" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0 10 5 0 10Z" fill="#4169E1"/></marker>
+    <style>
+      text{font-family:Inter,Segoe UI,Arial,sans-serif;fill:#17212B}.title{font-size:34px;font-weight:760}.subtitle{font-size:16px;fill:#58636D}.band-title{font-size:19px;font-weight:740}.eyebrow{font-size:11px;font-weight:750;letter-spacing:1.4px}.node-title{font-size:15px;font-weight:700}.body{font-size:12px;fill:#58636D}.label{font-size:11px;font-weight:720}.edge{fill:none;stroke:#17212B;stroke-width:2.2;marker-end:url(#arrow)}.loop{fill:none;stroke:#4169E1;stroke-width:2.4;stroke-dasharray:7 7;marker-end:url(#blue-arrow)}
+    </style>
+  </defs>
+  <rect width="1600" height="1000" fill="#F5F2EA"/>
+  <text class="title" x="70" y="64">One system. Three honest loops.</text>
+  <text class="subtitle" x="70" y="94">The human talks naturally. The Agent thinks and acts. LOOM quietly preserves state, context, and proof.</text>
+  <g transform="translate(1290 50)"><circle cx="6" cy="6" r="6" fill="#4169E1"/><text class="eyebrow" x="22" y="10">FOR AI AGENTS, NOT END USERS</text></g>
+
+  <!-- Understanding loop -->
+  <g>
+    <rect x="48" y="130" width="1504" height="246" rx="24" fill="#FBFAF6" stroke="#D8D3C8"/>
+    <rect x="48" y="130" width="12" height="246" rx="6" fill="#9AD8C2"/>
+    <text class="eyebrow" x="86" y="163" fill="#367D67">01 · UNDERSTANDING LOOP</text>
+    <text class="band-title" x="86" y="192">Find the whole before pretending to know the task.</text>
+    <g transform="translate(86 224)">
+      <rect width="190" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/>
+      <rect x="14" y="13" width="52" height="20" rx="10" fill="#E3F3ED"/><text class="eyebrow" x="40" y="27" text-anchor="middle" fill="#367D67">HUMAN</text>
+      <text class="node-title" x="14" y="54">Natural request</text><text class="body" x="14" y="71">idea · correction · answer</text>
+    </g>
+    <g transform="translate(326 224)">
+      <rect width="224" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/>
+      <rect x="14" y="13" width="48" height="20" rx="10" fill="#E8ECFA"/><text class="eyebrow" x="38" y="27" text-anchor="middle" fill="#4169E1">AGENT</text>
+      <text class="node-title" x="14" y="54">Describe the result</text><text class="body" x="14" y="71">inspect only when relevant</text>
+    </g>
+    <g transform="translate(598 214)">
+      <path d="M96 0 192 51 96 102 0 51Z" fill="#FFFFFF" stroke="#4169E1" stroke-width="1.5"/>
+      <text class="node-title" x="96" y="46" text-anchor="middle">Material unknowns</text><text class="body" x="96" y="65" text-anchor="middle">still change the whole?</text>
+    </g>
+    <g transform="translate(838 224)">
+      <rect width="210" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/>
+      <text class="node-title" x="14" y="35">Ask one dense round</text><text class="body" x="14" y="55">adaptive · consequential</text><text class="body" x="14" y="72">not a fixed questionnaire</text>
+    </g>
+    <g transform="translate(1096 224)">
+      <rect width="218" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/>
+      <text class="node-title" x="14" y="35">Update project truth</text><text class="body" x="14" y="55">facts · decisions · designs</text><text class="body" x="14" y="72">separate field dossiers</text>
+    </g>
+    <g transform="translate(1362 224)">
+      <rect width="150" height="82" rx="14" fill="#E3F3ED" stroke="#9AD8C2"/>
+      <text class="node-title" x="75" y="37" text-anchor="middle">Build-ready</text><text class="body" x="75" y="58" text-anchor="middle">candidate</text>
+    </g>
+    <path class="edge" d="M276 265H326"/><path class="edge" d="M550 265H598"/>
+    <path class="edge" d="M790 265H838"/><text class="label" x="804" y="253">YES</text>
+    <path class="edge" d="M1048 265H1096"/>
+    <path class="loop" d="M1205 306V354H694V316"/><text class="label" x="826" y="369" fill="#4169E1">RE-EVALUATE AFTER EVERY MATERIAL ANSWER</text>
+    <path class="edge" d="M694 214V205H1437V224"/><text class="label" x="814" y="198">NO · REMAINING GAPS ARE LOCAL OR USER ACCEPTS THE COST</text>
+  </g>
+
+  <!-- Keeper loop -->
+  <g>
+    <rect x="48" y="404" width="1504" height="246" rx="24" fill="#FBFAF6" stroke="#D8D3C8"/>
+    <rect x="48" y="404" width="12" height="246" rx="6" fill="#E88773"/>
+    <text class="eyebrow" x="86" y="437" fill="#A84D3C">02 · KEEPER LOOP</text>
+    <text class="band-title" x="86" y="466">A stranger must be able to start—otherwise the project is not ready.</text>
+    <g transform="translate(86 498)"><rect width="220" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="node-title" x="14" y="34">Validate + freeze digest</text><text class="body" x="14" y="55">PROJECT · designs · dossiers</text><text class="body" x="14" y="72">Work Map · first Task</text></g>
+    <g transform="translate(358 498)"><rect width="220" height="82" rx="14" fill="#FFFFFF" stroke="#E88773"/><rect x="14" y="13" width="94" height="20" rx="10" fill="#F9E4DE"/><text class="eyebrow" x="61" y="27" text-anchor="middle" fill="#A84D3C">FRESH AGENT</text><text class="node-title" x="14" y="55">Independently inspect</text><text class="body" x="14" y="72">same frozen project digest</text></g>
+    <g transform="translate(630 488)"><path d="M100 0 200 51 100 102 0 51Z" fill="#FFFFFF" stroke="#E88773" stroke-width="1.5"/><text class="node-title" x="100" y="46" text-anchor="middle">Can responsibly</text><text class="body" x="100" y="65" text-anchor="middle">start the first Task?</text></g>
+    <g transform="translate(882 498)"><rect width="220" height="82" rx="14" fill="#F9E4DE" stroke="#E88773"/><text class="node-title" x="14" y="34">Return exact gaps</text><text class="body" x="14" y="55">needs_revision / blocked</text><text class="body" x="14" y="72">evidence · files · consequences</text></g>
+    <g transform="translate(1154 498)"><rect width="180" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="node-title" x="14" y="34">Repair the source</text><text class="body" x="14" y="55">new digest</text><text class="body" x="14" y="72">different fresh Keeper</text></g>
+    <g transform="translate(1386 498)"><rect width="126" height="82" rx="14" fill="#E3F3ED" stroke="#9AD8C2"/><text class="node-title" x="63" y="37" text-anchor="middle">Passed</text><text class="body" x="63" y="58" text-anchor="middle">handoff once</text></g>
+    <path class="edge" d="M306 539H358"/><path class="edge" d="M578 539H630"/>
+    <path class="edge" d="M830 539H882"/><text class="label" x="846" y="527">NO</text><path class="edge" d="M1102 539H1154"/>
+    <path class="loop" d="M1244 580V616H468V580"/><text class="label" x="720" y="633" fill="#4169E1">REPAIR → NEW DIGEST → NEW RUN_ID → NEW KEEPER</text>
+    <path class="edge" d="M730 488V477H1449V498"/><text class="label" x="751" y="470">YES</text>
+  </g>
+
+  <!-- Delivery loop -->
+  <g>
+    <rect x="48" y="678" width="1504" height="270" rx="24" fill="#FBFAF6" stroke="#D8D3C8"/>
+    <rect x="48" y="678" width="12" height="270" rx="6" fill="#4169E1"/>
+    <text class="eyebrow" x="86" y="711" fill="#4169E1">03 · DELIVERY LOOP</text>
+    <text class="band-title" x="86" y="740">Each Task is a restartable checkpoint, not a miniature bureaucracy.</text>
+    <g transform="translate(86 772)"><rect width="180" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="node-title" x="14" y="34">Select next Task</text><text class="body" x="14" y="55">dependencies satisfied</text><text class="body" x="14" y="72">active horizon only</text></g>
+    <g transform="translate(310 772)"><rect width="210" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="node-title" x="14" y="34">Compile exact context</text><text class="body" x="14" y="55">declared reads · constraints</text><text class="body" x="14" y="72">done conditions · evidence</text></g>
+    <g transform="translate(564 772)"><rect width="190" height="82" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="node-title" x="14" y="34">Build → observe</text><text class="body" x="14" y="55">test → adjust</text><text class="body" x="14" y="72">keep local failures local</text></g>
+    <g transform="translate(798 762)"><path d="M90 0 180 51 90 102 0 51Z" fill="#FFFFFF" stroke="#4169E1" stroke-width="1.5"/><text class="node-title" x="90" y="46" text-anchor="middle">Done conditions</text><text class="body" x="90" y="65" text-anchor="middle">actually proven?</text></g>
+    <g transform="translate(1022 772)"><rect width="200" height="82" rx="14" fill="#E8ECFA" stroke="#4169E1"/><text class="node-title" x="14" y="34">Record exact evidence</text><text class="body" x="14" y="55">complete / block / reopen</text><text class="body" x="14" y="72">preserve what comes next</text></g>
+    <g transform="translate(1266 762)"><path d="M82 0 164 51 82 102 0 51Z" fill="#FFFFFF" stroke="#4169E1" stroke-width="1.5"/><text class="node-title" x="82" y="46" text-anchor="middle">More Tasks?</text><text class="body" x="82" y="65" text-anchor="middle">or new upper gap?</text></g>
+    <g transform="translate(1460 772)"><rect width="52" height="82" rx="14" fill="#17212B"/><path d="M17 41h18M28 30l11 11-11 11" fill="none" stroke="#F5F2EA" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/></g>
+    <path class="edge" d="M266 813H310"/><path class="edge" d="M520 813H564"/><path class="edge" d="M754 813H798"/>
+    <path class="edge" d="M978 813H1022"/><text class="label" x="986" y="801">YES</text><path class="edge" d="M1222 813H1266"/><path class="edge" d="M1430 813H1460"/><text class="label" x="1433" y="801">NO</text>
+    <path class="loop" d="M888 864V899H659V854"/><text class="label" x="716" y="917" fill="#4169E1">LOCAL NO · ITERATE</text>
+    <path class="loop" d="M1348 864V926H176V854"/><text class="label" x="672" y="940" fill="#4169E1">MORE TASKS · OR BLOCK → REPAIR UPPER SOURCE → REOPEN</text>
+  </g>
+  <text class="body" x="70" y="980">Solid line = forward handoff · Dashed cobalt = an explicit correction loop · Human interaction stays natural throughout.</text>
+</svg>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@haaaiawd/loom",
-  "version": "1.3.1",
-  "description": "LOOM — 哲学驱动开发框架。Agent 通过 CLI 访问 Intent Map / 哲学 / 验证记录，不直接读文件",
+  "version": "2.0.1",
+  "description": "LOOM — invisible project understanding and continuity infrastructure for AI agents",
   "type": "module",
   "bin": {
     "loom": "cli/bin/loom.js"
@@ -9,35 +9,35 @@
   "files": [
     "cli/bin",
     "cli/src",
-    "cli/help",
-    "meta",
-    "roles",
-    "templates",
-    "dimensions",
-    "README.md",
-    "CHANGELOG.md",
-    "EXTERNAL_ACQUISITION_DESIGN.md"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
+    "README.md",
+    "README.zh-CN.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "design.md",
+    "EVIL_EVAL.md",
+    "docs/**/*.md",
+    "docs/**/*.svg",
+    "docs/**/*.drawio",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "engines": {
     "node": ">=18"
   },
-  "scripts": {
-    "test": "node cli/test/run-all.js",
-    "prepublishOnly": "npm test"
+  "scripts": {
+    "test": "node cli/test/run-all.js",
+    "prepublishOnly": "npm test"
   },
   "keywords": [
     "loom",
     "agent",
-    "ai",
-    "philosophy",
-    "intent-driven",
-    "framework",
-    "cli",
-    "specification-driven"
+    "continuity",
+    "project-understanding",
+    "task-context",
+    "cli"
   ],
   "license": "MIT",
   "repository": {
@@ -45,5 +45,8 @@
     "url": "git+https://github.com/Haaaiawd/loom.git"
   },
   "homepage": "https://github.com/Haaaiawd/loom#readme",
+  "bugs": {
+    "url": "https://github.com/Haaaiawd/loom/issues"
+  },
   "author": "haaaiawd"
 }

package/EXTERNAL_ACQUISITION_DESIGN.md

@@ -1,143 +0,0 @@
-# External Acquisition Gate — 来源化能力网络设计
-
-> 状态：Implemented  
-> 目标：阻止 AI 在专业能力不足时闭门生成，并把真实外部检索编译成当前 Intent 可使用、可追溯、会随 revision 失效的核心信息组。
-
-## 1. 问题
-
-LOOM 已经能识别任务需要哪些能力，但“识别能力”不等于“获得能力”。如果 Forge 只根据模型已有知识临时生成一段设计原则，它仍可能做出结构正确、审美普通的结果，并把自洽误当成专业。
-
-本设计把能力链拆成四个不同事实：
-
-1. Capability Graph：项目为什么需要某项能力。
-2. Search Plan：本轮要用什么问题和关键词去外部寻找。
-3. Expertise Pack：实际打开来源后，哪些规则、工作流、判断门和失败模式可用于本 Intent。
-4. Quality Proof：这些判断是否真的让结果胜过基线。
-
-Graph 不保存网站、Skill 名称或固定关键词；Pack 不复制第三方 Skill 或网页正文。
-
-## 2. 核心不变量
-
-- AI 可以生成检索计划，不能把自己生成的内容登记为外部专业知识。
-- `external_required` 能力必须实际使用 Skill registry、网络、官方文档或研究资料。
-- 搜索结果标题、未打开的摘要、模型记忆和“行业通常如此”都不是来源。
-- 每个 Capability Capsule 必须直接引用至少一个已打开、可回查的外部来源。
-- Pack 绑定 `intent_revision`；Intent 修订后旧 Pack 自动失效。
-- Forge 可以使用 Pack；Keeper 不继承 Forge 的结论，必须重新打开关键来源。
-- 来源化不等于正确。CLI 证明结构与追溯，Keeper 证明来源是否真的支持判断。
-
-## 3. 触发模型
-
-Capability 节点可选：
-
-```json
-{
-  "acquisition_mode": "adaptive | external_required | project_only",
-  "acquisition_rationale": "project_only 时必填"
-}
-```
-
-有效模式按以下顺序计算：
-
-1. Graph 显式声明的模式优先。
-2. 未声明时，高影响 capability 自动提升为 `external_required`。
-3. 中低影响 capability 默认为 `adaptive`。
-
-`project_only` 只适合未公开内部协议、纯机械迁移等外部知识不会改变做法的任务，必须说明理由。外部交付依赖与只读研究访问是两件事：允许检索资料，不等于允许把外部服务写进产品架构。
-
-## 4. 运行流程
-
-```text
-Capability Graph
-  → compile acquisition requirement
-  → derive Search Plan from project signals
-  → perform real external retrieval
-  → synthesize Capability Capsules
-  → validate Expertise Pack
-  → Author / Atelier / implementation
-  → independent Keeper source check
-  → passed record binds current Pack
-```
-
-搜索词由 Forge 根据以下信号动态派生：
-
-- capability question 与 Brief；
-- Intent narrative、quality contract 和 creative scope；
-- 当前媒介、宿主、技术与许可约束；
-- 基线中已经观察到的具体缺口；
-- Authorial Stance 尚未解决的机制问题。
-
-关键词属于本轮工作证据，不回写 Graph。这样 LOOM 不会把“网页设计等于某几个灵感站”固化成框架偏见。
-
-## 5. Expertise Pack
-
-位置：
-
-```text
-.loom/vN/10_EXPERTISE_PACKS/<intent-id>.json
-```
-
-Pack 包含：
-
-- `search_plan`：决策问题、项目信号、派生查询、约束和停止条件；
-- `sources`：类型、权威层级、HTTPS 定位、获取时间、选择理由和已打开证据；
-- `capsules`：专业问题、适用时机、规则、工作流、判断门、失败模式、验证信号和来源引用；
-- `required_capability_refs` 与 `intent_revision`；
-- `status: draft | ready | blocked`。
-
-Capability Capsule 是“类似 Skill 的核心信息组”，但它有三个刻意限制：
-
-1. 只服务当前 Intent，不假装是通用知识；
-2. 只保存项目化综合，不复制来源内容；
-3. 未经多个真实任务和 Quality Proof 支持，不自动晋升为 Skill 或 Doctrine。
-
-## 6. Author 与自我更正
-
-外部获取发生在 Author/Atelier 之前。Authorial Stance 必须建立在已经来源化的机制和项目事实之上，而不是用人格、风格词或模型偏好代替研究。
-
-自我更正分三层：
-
-- Capsule 解释错误、来源不支持规则：修正 Pack，重新验证；如果已 passed，必须由 Keeper 重验。
-- 当前构图、措辞、动效或候选选择失效：写入 Atelier `corrections[]`，递增 `stance_revision`。
-- 出现新的用户结果、约束、风险或能力缺口：提交 Capability Graph proposal，由 Architect 裁决。
-
-Author 不能修改 Graph 后继续自证，也不能用一次局部修正把任务长期知识化。
-
-## 7. 强门与验证
-
-以下入口共同阻止绕过：
-
-- `loom guide`：优先引导创建或补齐 Pack；
-- `loom activate forge --intent <id>`：Pack 未 ready 时显示 OPEN 门，只允许勘察、基线和检索；
-- `loom expertise validate <id>`：检查 revision、真实外部来源、直接引用和 Capsule 完整性；
-- `loom verify pass`：强门未闭合时拒绝 passed，并把当前 Pack 的内容摘要绑定到验证记录；
-- `loom intent done`：拒绝未绑定、内容摘要变化或已经过期的 Pack；
-- `loom doctor`：报告缺失、失效和 passed 绑定漂移；
-- Keeper Context Pack：只给出证据入口，不注入 Forge 的 Capsule 结论。
-
-## 8. 搜索预算与停止条件
-
-LOOM 不规定固定网站数量，也不鼓励无限浏览。每个 Search Plan 必须写停止条件。通常在以下条件同时成立时停止：
-
-- 每个 required capability 都有直接来源化 Capsule；
-- 来源足以回答当前决策问题，而不只是提供视觉相似物；
-- 已能写出可执行的判断门、失败模式和验证信号；
-- 新来源只重复已有机制，不再改变候选或验证方法。
-
-如果来源互相冲突、关键资料不可访问或许可不清，Pack 应进入 `blocked`，而不是让模型补齐空白。
-
-## 9. 与现有系统的去重
-
-- Capability Brief 负责“项目问题与获取边界”；Pack 负责“本轮实际获得了什么”。二者不重复。
-- Authorship 负责“基于材料做什么独特选择”；Pack 负责“选择前有哪些可信材料”。二者不重复。
-- Atelier Record 保存候选与修正；Pack 保存外部能力证据。二者不合并。
-- Quality Proof 证明结果提升；Pack 只证明专业判断有来源。来源不能替代结果。
-- Doctrine 保存长期项目判断；Pack 默认短命。未经重复外部结果支持，不进入 Doctrine。
-
-## 10. 非目标
-
-- 不在 LOOM 仓库内安装、镜像或维护第三方 Skill。
-- 不建立固定网站白名单或 UI 专用关键词表。
-- 不声称只要检索就能突破基础模型的所有智能边界。
-- 不用来源数量、星标或流行度替代任务适配性。
-- 不让 CLI 自动编造 Capsule；CLI 只建模、校验、编译和阻断。

package/cli/help/asset.md

@@ -1,36 +0,0 @@
-# Asset Library Protocol
-
-Asset Library is the versioned, local-first source of truth for project materials. It stores asset bytes under `.loom/vN/08_ASSET_LIBRARY/files/` and metadata in `manifest.json`. A remote URL, successful download, or HTTP 200 is never proof that an asset is renderable in the target host.
-
-## Import
-
-```bash
-loom asset import ./approved-image.png \
-  --kind image \
-  --tags "庆祝,表情,项目名" \
-  --source "用户自有素材包" \
-  --author "作者或权利人" \
-  --license "授权说明或许可证" \
-  --approval approved
-```
-
-Import copies an explicitly named ordinary local file, computes SHA-256, derives a stable `ASSET-...` ID, and rejects symbolic links, destination/path escape, duplicate bytes, missing provenance, and unapproved assets. It does not fetch remote material.
-
-## Recoverable import transaction
-
-An evidence-linked import changes three files: the copied bytes, `manifest.json`, and `07_CAPABILITY_GRAPH.json`. Filesystems do not provide one atomic operation across those files, so Loom does not claim that they do. It first prevalidates the complete candidate, then writes same-directory temporary files and a recovery journal (flushed where the filesystem supports it). If an import errors, Loom rolls back to the recorded pre-import state; if the process is interrupted, the next `loom asset validate`, import, or library read recovers the journal before using the library. `loom asset validate` reports a recovered transaction in its JSON output.
-
-## Discover and verify
-
-```bash
-loom asset list
-loom asset search 表情
-loom asset get ASSET-<hash-prefix>
-loom asset validate
-```
-
-Tags are Unicode strings, so Chinese search works without a separate tokenizer for the small local library. Search returns only active `approval: approved` assets; `asset list` remains the audit view. Only approved assets may be used by Forge.
-
-## Evidence links
-
-When importing with `--evidence`, Loom validates the complete prospective manifest and Graph first, then writes both the asset's `evidence_refs` and the evidence node's `asset_refs` as one recoverable transaction. `loom asset validate` checks this reciprocal link plus hashes and provenance. This records bytes and traceability; Keeper must still check the real target host renders the result.

package/cli/help/atelier.md

@@ -1,37 +0,0 @@
-# Atelier
-
-Atelier 是 `quality_strategy=atelier` 的创作深路径。它让 Authorial Stance、基线、候选、
-修正和选择证据成为单个版本化记录，不替代 Intent 状态或 Keeper。
-
-## 何时启用
-
-由 Architect 在 Intent 同时声明：
-
-```json
-{
-  "quality_contract": "相对基线可观察的质量主张与证据方式",
-  "quality_strategy": "atelier",
-  "creative_scope": "允许改变什么；必须保护什么。"
-}
-```
-
-普通任务省略该字段或使用 `adaptive`，不会创建 Atelier Record。
-
-## 工作流
-
-```bash
-loom activate forge --intent INT-001
-loom atelier init INT-001
-loom atelier validate INT-001
-loom atelier get INT-001
-```
-
-记录位于 `.loom/vN/09_ATELIER/INT-001.json`，证据位于
-`.loom/vN/09_ATELIER/files/INT-001/`。
-
-每个候选必须绑定 `stance_revision`。Stance 改变后，旧候选要设置 `archived: true`，
-或在重新检查后写 `requalified_for_stance_revision`。局部创作修正写入 `corrections[]`；
-结构性新发现提交 Capability Graph proposal，由 Architect 裁决。
-
-`loom atelier validate` 只证明记录结构、新鲜度和引用合法，不证明作品优秀。最终质量仍由
-新的 Keeper task 依据 Quality Proof 独立判定。