soloforge 1.2.20 → 1.3.1

package/dist/engine/knowledge_asset_consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_asset_consumer.js","sourceRoot":"","sources":["../../src/engine/knowledge_asset_consumer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAA8B,MAAM,8BAA8B,CAAC;AAoFhH,aAAa;AAEb;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAe;IAKxD,MAAM,MAAM,GAIP,EAAE,CAAC;IAER,MAAM,SAAS,GAAG;QAChB,2BAA2B;QAC3B,gCAAgC;QAChC,kCAAkC;QAClC,gCAAgC;QAChC,0CAA0C;QAC1C,4BAA4B;QAC5B,mCAAmC;QACnC,+BAA+B;QAC/B,oBAAoB;KACrB,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,SAAS;QACjC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;gBAC1D,MAAM,OAAO,GAAI,EAAE,CAAC,EAAa,IAAK,EAAE,CAAC,IAAe,IAAI,CAAC,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAI/B;IACA,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;QAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,eAAe,GAAG,eAAe,CAAC,EAAE,CAAC,gBAAgB,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,gBAAgB,GAAG,eAAe,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM;gBACN,gBAAgB,EAAE,eAAe;gBACjC,iBAAiB,EAAE,gBAAgB;gBACnC,WAAW;aACZ,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,UAAU,EAAG,EAAE,CAAC,IAAe,IAAI,KAAK,CAAC,QAAQ;gBACjD,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,eAAe,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,aAAa,CAAC;gBACnF,QAAQ,EAAE,eAAe;gBACzB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAIjC;IACA,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAG,EAAE,CAAC,SAAoB,IAAI,YAAY;YACnD,QAAQ,EAAG,EAAE,CAAC,QAAmB,IAAI,IAAI;YACzC,iBAAiB,EAAE,eAAe,CAAC,EAAE,CAAC,iBAA2B,CAAC;YAClE,UAAU,EAAG,EAAE,CAAC,UAAqB,IAAK,EAAE,CAAC,IAAe,IAAI,kBAAkB;SACnF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAG,EAAE,CAAC,IAAe,IAAI,KAAK,CAAC,QAAQ;YACjD,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,YAAY,CAAC;YAC7E,QAAQ,EAAE,iBAAiB;YAC3B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAIjC;IACA,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC;YACV,WAAW,EAAE,eAAe,CAAC,EAAE,CAAC,WAAqB,CAAC;YACtD,iBAAiB,EAAE,eAAe,CAAC,EAAE,CAAC,iBAA2B,CAAC;YAClE,QAAQ,EAAG,EAAE,CAAC,QAAmB,IAAI,MAAM;YAC3C,gBAAgB,EAAG,EAAE,CAAC,gBAA2B,IAAI,QAAQ;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAG,EAAE,CAAC,IAAe,IAAI,KAAK,CAAC,QAAQ;YACjD,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,eAAe,EAAE,CAAC,aAAa,EAAE,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,CAAC;YACrF,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAItC;IACA,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAG,EAAE,CAAC,IAAe,IAAI,KAAK,CAAC,QAAQ;YAC3C,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC,KAAe,CAAC;YAC1C,OAAO,EAAG,EAAE,CAAC,OAAkB,IAAI,OAAO;SAC3C,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAG,EAAE,CAAC,IAAe,IAAI,KAAK,CAAC,QAAQ;YACjD,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,eAAe,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC;YAC7C,QAAQ,EAAE,gBAAgB;YAC1B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAAe;IAChE,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAE3D,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,gBAA0B,CAAC;QACxD,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,QAAQ,GAAG,CAAC,CAAwB,EAAE,YAAoB,EAA0B,EAAE,CAAC,CAAC;QAC5F,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,QAAQ;QACtB,SAAS,EAAE,qBAAqB;QAChC,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5G,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAClH,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3G,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEtH,aAAa;IACb,MAAM,QAAQ,GAAG,CAAC,2BAA2B,EAAE,gCAAgC;QAC7E,kCAAkC,EAAE,gCAAgC,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,CAAC,CAAwB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/G,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACnC,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,gBAA0B,CAAC;QACxD,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,gBAA0B,CAAC;QACxD,OAAO,CAAC,YAAY,EAAC,OAAO,EAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAG,CAAC,CAAC,WAAW,CAAC,gBAA2B,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC;IACzG,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAC,CAAC;IAEvG,OAAO;QACL,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,eAAe,EAAE;YACf,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,UAAU,EAAG,CAAC,CAAC,WAAW,CAAC,UAAqB,IAAI,SAAS;gBAC7D,QAAQ,EAAG,CAAC,CAAC,WAAW,CAAC,QAAmB,IAAI,IAAI;aACrD,CAAC,CAAC;SACJ;QACD,gBAAgB,EAAE;YAChB,MAAM,EAAE,iBAAiB,CAAC,OAAO;YACjC,QAAQ,EAAE,mBAAmB,CAAC,OAAO;YACrC,QAAQ,EAAE,mBAAmB,CAAC,OAAO;YACrC,cAAc,EAAE,kBAAkB,CAAC,OAAO;SAC3C;QACD,0BAA0B,EAAE;YAC1B,MAAM,EAAE,aAAa;YACrB,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,eAAe;YACzB,cAAc,EAAE,cAAc;SAC/B;QACD,SAAS,EAAE;YACT,MAAM,EAAE,aAAa;YACrB,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,eAAe;YACzB,cAAc,EAAE,cAAc;SAC/B;QACD,QAAQ,EAAE;YACR,QAAQ,EAAE,eAAe,IAAI,CAAC,GAAG,EAAE,EAAE;YACrC,KAAK,EAAE,0BAA0B;YACjC,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC7C,eAAe,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YAClD,eAAe,EAAE,CAAC,GAAG,kBAAkB,EAAE,GAAG,YAAY,CAAC;YACzD,eAAe,EAAE,EAAE;YACnB,cAAc,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;YACxF,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,aAAa,EAAE,MAAM,CAAC,MAAM;YAC5B,cAAc,EAAE,UAAU,CAAC,MAAM;YACjC,cAAc,EAAE,kBAAkB,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM;YAC/D,cAAc,EAAE,CAAC;YACjB,aAAa,EAAE,UAAU,CAAC,MAAM;SACjC;QACD,oBAAoB,EAAE,MAAM,CAAC,MAAM;QACnC,qBAAqB,EAAE,UAAU,CAAC,MAAM;QACxC,mBAAmB,EAAE;YACnB,cAAc,EAAE,WAAW,CAAC,MAAM;YAClC,gBAAgB,EAAE,WAAW,CAAC,QAAQ;YACtC,gBAAgB,EAAE,WAAW,CAAC,QAAQ;YACtC,eAAe,EAAE,WAAW,CAAC,cAAc;YAC3C,aAAa,EAAE,UAAU,CAAC,MAAM;YAChC,YAAY,EAAE,UAAU,CAAC,MAAM;SAChC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;QACnG,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/engine/knowledge_asset_generation_gate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Knowledge Asset Generation Gate — 问题五十七核心机制之四。
+ *
+ * 新增或修改知识资产前必须通过准入门:
+ * - Schema 校验
+ * - 重复/冲突校验
+ * - Owner 校验
+ * - 消费路径校验
+ * - 中文质量门
+ * - 回归门
+ */
+import type { KnowledgeAssetFrontmatter } from "./knowledge_asset_schema.js";
+import type { KnowledgeAssetAuditFinding } from "./knowledge_asset_audit.js";
+/** 资产生成门输入 */
+export interface KnowledgeAssetGenerationGateInput {
+    asset: {
+        frontmatter: Partial<KnowledgeAssetFrontmatter>;
+        body: string;
+        file_path: string;
+    };
+    existing_assets: Array<{
+        frontmatter: Partial<KnowledgeAssetFrontmatter>;
+        file_path: string;
+    }>;
+    user_modified_assets: string[];
+}
+/** 资产生成门结果 */
+export interface KnowledgeAssetGenerationGateResult {
+    passed: boolean;
+    generation_gate_status: "accepted" | "rejected" | "needs_revision";
+    findings: KnowledgeAssetAuditFinding[];
+    reason_zh: string;
+}
+/**
+ * 验证知识资产生成门 — 新增资产必须通过所有检查。
+ */
+export declare function validateKnowledgeAssetGenerationGate(input: KnowledgeAssetGenerationGateInput): KnowledgeAssetGenerationGateResult;
+//# sourceMappingURL=knowledge_asset_generation_gate.d.ts.map

package/dist/engine/knowledge_asset_generation_gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_asset_generation_gate.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_asset_generation_gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAI7E,cAAc;AACd,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE;QACL,WAAW,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAChD,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,eAAe,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,cAAc;AACd,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB,EAAE,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAAC;IACnE,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,iCAAiC,GACvC,kCAAkC,CA6HpC"}

package/dist/engine/knowledge_asset_generation_gate.js

@@ -0,0 +1,131 @@
+/**
+ * Knowledge Asset Generation Gate — 问题五十七核心机制之四。
+ *
+ * 新增或修改知识资产前必须通过准入门:
+ * - Schema 校验
+ * - 重复/冲突校验
+ * - Owner 校验
+ * - 消费路径校验
+ * - 中文质量门
+ * - 回归门
+ */
+import { validateKnowledgeAssetFrontmatter } from "./knowledge_asset_schema.js";
+// ── 核心函数 ──
+/**
+ * 验证知识资产生成门 — 新增资产必须通过所有检查。
+ */
+export function validateKnowledgeAssetGenerationGate(input) {
+    const findings = [];
+    // 1. Schema 校验
+    const schemaFindings = validateKnowledgeAssetFrontmatter(input.asset.frontmatter, input.asset.file_path);
+    for (const sf of schemaFindings) {
+        findings.push({
+            asset_id: sf.asset_id,
+            file_path: sf.file_path,
+            severity: sf.severity === "advisory" ? "warning" : sf.severity,
+            kind: "missing_required_field",
+            detail: sf.message_zh,
+            suggested_action: "repair",
+        });
+    }
+    // 2. ID 唯一性检查
+    const id = input.asset.frontmatter.id;
+    if (id) {
+        const existingIds = new Set(input.existing_assets.map((a) => a.frontmatter.id).filter(Boolean));
+        if (existingIds.has(id)) {
+            findings.push({
+                asset_id: id,
+                file_path: input.asset.file_path,
+                severity: "hard_fail",
+                kind: "duplicate_id",
+                detail: `资产 ID ${id} 已存在 (SF-KA-5702)`,
+                suggested_action: "merge",
+            });
+        }
+    }
+    // 3. canonical 冲突检查
+    if (input.asset.frontmatter.authority === "canonical" && input.asset.frontmatter.name) {
+        const existingCanonical = input.existing_assets.filter((a) => a.frontmatter.authority === "canonical" && a.frontmatter.name === input.asset.frontmatter.name);
+        if (existingCanonical.length > 0) {
+            findings.push({
+                asset_id: id ?? "unknown",
+                file_path: input.asset.file_path,
+                severity: "hard_fail",
+                kind: "duplicate_canonical",
+                detail: `主题 "${input.asset.frontmatter.name}" 已有 canonical 定义: ${existingCanonical.map((a) => a.frontmatter.id).join(", ")} (SF-KA-5703)`,
+                suggested_action: "mark_supporting",
+            });
+        }
+    }
+    // 4. Owner 检查
+    const kind = input.asset.frontmatter.asset_kind;
+    if (kind && ["hard_rule", "workflow"].includes(kind)) {
+        if (!input.asset.frontmatter.owner_mechanism_id) {
+            findings.push({
+                asset_id: id ?? "unknown",
+                file_path: input.asset.file_path,
+                severity: "hard_fail",
+                kind: "owner_missing",
+                detail: `${kind} 必须有 owner_mechanism_id (SF-KA-5704)`,
+                suggested_action: "repair",
+            });
+        }
+    }
+    // 5. required_evidence 检查
+    if (input.asset.frontmatter.priority && ["P0", "P1"].includes(input.asset.frontmatter.priority)) {
+        if (!input.asset.frontmatter.required_evidence || input.asset.frontmatter.required_evidence.length === 0) {
+            findings.push({
+                asset_id: id ?? "unknown",
+                file_path: input.asset.file_path,
+                severity: "hard_fail",
+                kind: "required_evidence_missing",
+                detail: `P0/P1 资产必须声明 required_evidence (SF-KA-5706)`,
+                suggested_action: "repair",
+            });
+        }
+    }
+    // 6. 用户修改保护
+    if (id && input.user_modified_assets.includes(id)) {
+        findings.push({
+            asset_id: id,
+            file_path: input.asset.file_path,
+            severity: "hard_fail",
+            kind: "missing_required_field",
+            detail: `资产 ${id} 已被用户修改，不得覆盖`,
+            suggested_action: "manual_required",
+        });
+    }
+    // 7. checklist 硬规则检查
+    if (kind === "checklist" && input.asset.frontmatter.hard_blocks && input.asset.frontmatter.hard_blocks.length > 0) {
+        findings.push({
+            asset_id: id ?? "unknown",
+            file_path: input.asset.file_path,
+            severity: "hard_fail",
+            kind: "semantic_conflict",
+            detail: "checklist 不得平行定义硬规则，只能引用 canonical",
+            suggested_action: "mark_supporting",
+        });
+    }
+    // 8. when/triggers 格式检查
+    if (input.asset.frontmatter.primary_triggers && input.asset.frontmatter.primary_triggers.length > 10) {
+        findings.push({
+            asset_id: id ?? "unknown",
+            file_path: input.asset.file_path,
+            severity: "warning",
+            kind: "trigger_conflict",
+            detail: `primary_triggers 过多 (${input.asset.frontmatter.primary_triggers.length} 个)，可能导致误召回`,
+            suggested_action: "repair",
+        });
+    }
+    const hardFails = findings.filter((f) => f.severity === "hard_fail");
+    const passed = hardFails.length === 0;
+    return {
+        passed,
+        generation_gate_status: passed ? "accepted" : "rejected",
+        findings,
+        reason_zh: passed
+            ? "资产生成门通过"
+            : `资产生成门未通过: ${hardFails.map((f) => f.detail).join("; ")}`,
+    };
+}
+//# sourceMappingURL=knowledge_asset_generation_gate.js.map

package/dist/engine/knowledge_asset_generation_gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_asset_generation_gate.js","sourceRoot":"","sources":["../../src/engine/knowledge_asset_generation_gate.ts"],"names":[],"mappings":"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"}

package/dist/engine/knowledge_asset_migration.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Knowledge Asset Migration — 问题五十七核心机制之五。
+ *
+ * 管理知识资产 schema 变更时的迁移策略:
+ * - Migration dry-run（预览影响）
+ * - 兼容性报告
+ * - 用户修改保护
+ * - 迁移优先级（P0→P1→P2→P3）
+ */
+import type { KnowledgeAssetFrontmatter, KnowledgeAssetKind } from "./knowledge_asset_schema.js";
+/** 迁移硬失败发现 — 五字段缺失/无效时返回 */
+export interface MigrationHardFailFinding {
+    asset_id: string;
+    invalid_fields: string[];
+    reason_zh: string;
+}
+/** 迁移计划 */
+export interface KnowledgeAssetMigrationPlan {
+    plan_id: string;
+    created_at: string;
+    source_schema_version: string;
+    target_schema_version: string;
+    affected_assets: string[];
+    migration_steps: MigrationStep[];
+    dry_run_result?: MigrationDryRunResult;
+    compatibility_report?: MigrationCompatibilityReport;
+    /** 五字段硬契约失败发现 */
+    hard_fail_findings: MigrationHardFailFinding[];
+}
+/** 迁移步骤 */
+export interface MigrationStep {
+    priority: "P0" | "P1" | "P2" | "P3";
+    description_zh: string;
+    asset_kinds: KnowledgeAssetKind[];
+    asset_count: number;
+    automated: boolean;
+    requires_user_confirmation: boolean;
+}
+/** 迁移 dry-run 结果 */
+export interface MigrationDryRunResult {
+    total_assets: number;
+    assets_to_migrate: number;
+    assets_unchanged: number;
+    assets_skipped: number;
+    assets_with_conflicts: number;
+    estimated_breaking_changes: number;
+    per_asset_details: Array<{
+        asset_id: string;
+        will_change: boolean;
+        changes: string[];
+        breaking: boolean;
+    }>;
+}
+/** 兼容性报告 */
+export interface MigrationCompatibilityReport {
+    source_version: string;
+    target_version: string;
+    breaking_changes: string[];
+    compatible_changes: string[];
+    deprecated_fields: string[];
+    new_required_fields: string[];
+    migration_required: boolean;
+}
+/**
+ * 规划知识资产迁移。
+ */
+export declare function planKnowledgeAssetMigration(params: {
+    source_version: string;
+    target_version: string;
+    assets: Array<{
+        frontmatter: Partial<KnowledgeAssetFrontmatter>;
+        file_path: string;
+    }>;
+    schema_changes: Array<{
+        field: string;
+        change_type: "added_required" | "removed" | "renamed" | "type_changed" | "deprecated";
+        old_value?: string;
+        new_value?: string;
+    }>;
+}): KnowledgeAssetMigrationPlan;
+/**
+ * 执行迁移 dry-run — 不修改任何文件，只预览影响。
+ */
+export declare function runMigrationDryRun(params: {
+    assets: Array<{
+        frontmatter: Partial<KnowledgeAssetFrontmatter>;
+        file_path: string;
+    }>;
+    schema_changes: Array<{
+        field: string;
+        change_type: "added_required" | "removed" | "renamed" | "type_changed" | "deprecated";
+        old_value?: string;
+        new_value?: string;
+    }>;
+    user_modified_assets: string[];
+}): MigrationDryRunResult;
+/**
+ * 生成兼容性报告。
+ */
+export declare function generateCompatibilityReport(params: {
+    source_version: string;
+    target_version: string;
+    schema_changes: Array<{
+        field: string;
+        change_type: "added_required" | "removed" | "renamed" | "type_changed" | "deprecated";
+        old_value?: string;
+        new_value?: string;
+    }>;
+}): MigrationCompatibilityReport;
+/**
+ * 检查用户修改的资产是否会被迁移覆盖。
+ */
+export declare function checkUserModificationProtection(asset_id: string, user_modified_assets: string[], migration_plan: KnowledgeAssetMigrationPlan): {
+    protected: boolean;
+    reason_zh: string;
+};
+//# sourceMappingURL=knowledge_asset_migration.d.ts.map

package/dist/engine/knowledge_asset_migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_asset_migration.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_asset_migration.ts"],"names":[],"mappings":"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"}

package/dist/engine/knowledge_asset_migration.js

@@ -0,0 +1,204 @@
+/**
+ * Knowledge Asset Migration — 问题五十七核心机制之五。
+ *
+ * 管理知识资产 schema 变更时的迁移策略:
+ * - Migration dry-run（预览影响）
+ * - 兼容性报告
+ * - 用户修改保护
+ * - 迁移优先级（P0→P1→P2→P3）
+ */
+import { recordConsumptionTrace, CONSUMER_FIELD_CONTRACTS } from "./consumption_trace_store.js";
+/** 迁移优先级排序 */
+const MIGRATION_PRIORITY = {
+    hard_rule: 0,
+    workflow: 1,
+    procedure: 2,
+    pipeline: 3,
+    review_rule: 4,
+    checklist: 5,
+    pattern: 6,
+    artifact_template: 7,
+    domain_knowledge: 8,
+    product_profile: 9,
+};
+// ── 核心函数 ──
+/**
+ * 规划知识资产迁移。
+ */
+export function planKnowledgeAssetMigration(params) {
+    const planId = `ka-migration-${Date.now()}`;
+    const steps = [];
+    const affected = params.assets.filter((a) => needsMigration(a.frontmatter, params.schema_changes));
+    // 按优先级分组
+    const byKind = new Map();
+    for (const asset of affected) {
+        const kind = asset.frontmatter.asset_kind ?? "domain_knowledge";
+        const group = byKind.get(kind) ?? [];
+        group.push(asset);
+        byKind.set(kind, group);
+    }
+    // 生成步骤
+    const sortedKinds = [...byKind.keys()].sort((a, b) => (MIGRATION_PRIORITY[a] ?? 9) - (MIGRATION_PRIORITY[b] ?? 9));
+    for (const kind of sortedKinds) {
+        const assets = byKind.get(kind) ?? [];
+        steps.push({
+            priority: MIGRATION_PRIORITY[kind] <= 1 ? "P0" : MIGRATION_PRIORITY[kind] <= 4 ? "P1" : MIGRATION_PRIORITY[kind] <= 7 ? "P2" : "P3",
+            description_zh: `迁移 ${assets.length} 个 ${kind} 资产`,
+            asset_kinds: [kind],
+            asset_count: assets.length,
+            automated: MIGRATION_PRIORITY[kind] <= 7,
+            requires_user_confirmation: MIGRATION_PRIORITY[kind] <= 1,
+        });
+    }
+    // 全量五字段硬契约校验 — 所有 affected assets 缺字段都进入 hard_fail_findings
+    const hardFailFindings = [];
+    let traceCount = 0;
+    for (const asset of affected) {
+        const fm = asset.frontmatter;
+        const invalidFields = [];
+        if (fm.version === undefined || fm.version === "")
+            invalidFields.push("version");
+        if (fm.schema === undefined || fm.schema === "")
+            invalidFields.push("schema");
+        if (fm.hash === undefined || fm.hash === "")
+            invalidFields.push("hash");
+        if (fm.user_modified === undefined || typeof fm.user_modified !== "boolean")
+            invalidFields.push("user_modified");
+        if (fm.migration_note === undefined || fm.migration_note === "")
+            invalidFields.push("migration_note");
+        if (invalidFields.length > 0) {
+            hardFailFindings.push({
+                asset_id: fm.id ?? "unknown",
+                invalid_fields: invalidFields,
+                reason_zh: `资产 ${fm.id ?? "unknown"} 五字段硬契约失败: ${invalidFields.join(", ")}`,
+            });
+            continue;
+        }
+        // trace 限量避免噪声，但 hard_fail 校验不限量
+        if (traceCount < 5) {
+            recordConsumptionTrace({
+                consumer: "sync_migration",
+                asset_id: fm.id ?? "unknown",
+                fields_consumed: CONSUMER_FIELD_CONTRACTS.sync_migration,
+                matched_reason: `migration v=${fm.version} schema=${fm.schema} hash=${fm.hash} user_modified=${fm.user_modified} note=${fm.migration_note}`,
+                task_id_or_route: planId,
+                consumed_at: new Date().toISOString(),
+            });
+            traceCount++;
+        }
+    }
+    return {
+        plan_id: planId,
+        created_at: new Date().toISOString(),
+        source_schema_version: params.source_version,
+        target_schema_version: params.target_version,
+        affected_assets: affected.map((a) => a.frontmatter.id ?? "unknown"),
+        migration_steps: steps,
+        hard_fail_findings: hardFailFindings,
+    };
+}
+/**
+ * 判断资产是否需要迁移。
+ */
+function needsMigration(fm, changes) {
+    for (const change of changes) {
+        if (change.change_type === "added_required") {
+            if (fm[change.field] === undefined)
+                return true;
+        }
+        if (change.change_type === "renamed" || change.change_type === "deprecated") {
+            if (fm[change.field] !== undefined)
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * 执行迁移 dry-run — 不修改任何文件，只预览影响。
+ */
+export function runMigrationDryRun(params) {
+    const details = [];
+    let toMigrate = 0;
+    let breaking = 0;
+    for (const asset of params.assets) {
+        const id = asset.frontmatter.id ?? "unknown";
+        const changes = [];
+        let isBreaking = false;
+        // 跳过用户修改的资产
+        if (params.user_modified_assets.includes(id)) {
+            details.push({ asset_id: id, will_change: false, changes: ["用户已修改，跳过"], breaking: false });
+            continue;
+        }
+        for (const change of params.schema_changes) {
+            if (change.change_type === "added_required") {
+                if (asset.frontmatter[change.field] === undefined) {
+                    changes.push(`需添加字段: ${change.field}`);
+                    toMigrate++;
+                    isBreaking = true;
+                }
+            }
+            if (change.change_type === "deprecated") {
+                if (asset.frontmatter[change.field] !== undefined) {
+                    changes.push(`字段将废弃: ${change.field}`);
+                    toMigrate++;
+                }
+            }
+        }
+        if (changes.length > 0) {
+            if (isBreaking)
+                breaking++;
+            details.push({ asset_id: id, will_change: true, changes, breaking: isBreaking });
+        }
+        else {
+            details.push({ asset_id: id, will_change: false, changes: [], breaking: false });
+        }
+    }
+    return {
+        total_assets: params.assets.length,
+        assets_to_migrate: toMigrate,
+        assets_unchanged: params.assets.length - toMigrate - params.user_modified_assets.length,
+        assets_skipped: params.user_modified_assets.length,
+        assets_with_conflicts: 0,
+        estimated_breaking_changes: breaking,
+        per_asset_details: details,
+    };
+}
+/**
+ * 生成兼容性报告。
+ */
+export function generateCompatibilityReport(params) {
+    const breaking = params.schema_changes
+        .filter((c) => c.change_type === "added_required" || c.change_type === "removed")
+        .map((c) => `${c.change_type}: ${c.field}`);
+    const compatible = params.schema_changes
+        .filter((c) => c.change_type === "type_changed" || c.change_type === "deprecated")
+        .map((c) => `${c.change_type}: ${c.field}`);
+    const deprecated = params.schema_changes
+        .filter((c) => c.change_type === "deprecated")
+        .map((c) => c.field);
+    const newRequired = params.schema_changes
+        .filter((c) => c.change_type === "added_required")
+        .map((c) => c.field);
+    return {
+        source_version: params.source_version,
+        target_version: params.target_version,
+        breaking_changes: breaking,
+        compatible_changes: compatible,
+        deprecated_fields: deprecated,
+        new_required_fields: newRequired,
+        migration_required: breaking.length > 0,
+    };
+}
+/**
+ * 检查用户修改的资产是否会被迁移覆盖。
+ */
+export function checkUserModificationProtection(asset_id, user_modified_assets, migration_plan) {
+    if (user_modified_assets.includes(asset_id) && migration_plan.affected_assets.includes(asset_id)) {
+        return {
+            protected: true,
+            reason_zh: `资产 ${asset_id} 已被用户修改，迁移时跳过，需人工确认后迁移`,
+        };
+    }
+    return { protected: false, reason_zh: "资产未被用户修改，可安全迁移" };
+}
+//# sourceMappingURL=knowledge_asset_migration.js.map

package/dist/engine/knowledge_asset_migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_asset_migration.js","sourceRoot":"","sources":["../../src/engine/knowledge_asset_migration.ts"],"names":[],"mappings":"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"}

package/dist/engine/knowledge_asset_schema.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Knowledge Asset Schema — 问题五十七核心机制之一。
+ *
+ * 定义所有知识资产的统一 frontmatter 标准、类型枚举和校验规则。
+ * 所有 templates/knowledge/**、templates/patterns/**、项目 .soloforge/knowledge/**
+ * 和全局 patterns 必须遵守此 schema。
+ */
+/** 知识资产类型 */
+export type KnowledgeAssetKind = "hard_rule" | "workflow" | "procedure" | "pipeline" | "pattern" | "checklist" | "artifact_template" | "review_rule" | "domain_knowledge" | "product_profile";
+/** 知识权威级别 */
+export type KnowledgeAuthority = "canonical" | "supporting" | "example";
+/** 知识生命周期状态 */
+export type KnowledgeLifecycleStatus = "draft" | "active" | "deprecated" | "quarantine";
+/** 重复类型 */
+export type KnowledgeDuplicateKind = "exact_duplicate" | "semantic_overlap" | "conflict" | "legitimate_cross_reference";
+/** 知识资产优先级 */
+export type KnowledgePriority = "P0" | "P1" | "P2" | "P3";
+/** 知识资产 Frontmatter */
+export interface KnowledgeAssetFrontmatter {
+    id: string;
+    name: string;
+    asset_kind: KnowledgeAssetKind;
+    lifecycle_status: KnowledgeLifecycleStatus;
+    authority: KnowledgeAuthority;
+    owner_mechanism_id?: string;
+    scope: string[];
+    products: string[];
+    routes: string[];
+    primary_triggers: string[];
+    secondary_triggers?: string[];
+    negative_triggers?: string[];
+    priority: KnowledgePriority;
+    specificity: number;
+    consumes?: string[];
+    emits?: string[];
+    required_evidence?: string[];
+    hard_blocks?: string[];
+    fallback?: "none" | "auto_repair" | "manual_required" | "fallback_allowed";
+    supersedes?: string[];
+    related_assets?: string[];
+    version: string;
+    last_reviewed: string;
+    migration_note?: string;
+    schema?: string;
+    hash?: string;
+    user_modified?: boolean;
+}
+/** 完整的知识资产（含正文） */
+export interface KnowledgeAsset {
+    frontmatter: KnowledgeAssetFrontmatter;
+    body: string;
+    file_path: string;
+    content_hash: string;
+}
+/** Schema 校验发现 */
+export type SchemaValidationFindingKind = "missing_required_field" | "invalid_enum" | "invalid_version" | "duplicate_id" | "duplicate_canonical" | "owner_missing" | "required_evidence_missing" | "deprecated_injected" | "checklist_hard_rule_violation";
+export interface SchemaValidationFinding {
+    asset_id: string;
+    file_path: string;
+    severity: "hard_fail" | "warning" | "advisory";
+    kind: SchemaValidationFindingKind;
+    field?: string;
+    message_zh: string;
+}
+/**
+ * 校验知识资产 frontmatter 的完整性。
+ */
+export declare function validateKnowledgeAssetFrontmatter(frontmatter: Partial<KnowledgeAssetFrontmatter>, filePath: string): SchemaValidationFinding[];
+/**
+ * 批量校验知识资产注册表。
+ */
+export declare function validateKnowledgeAssets(assets: Array<{
+    frontmatter: Partial<KnowledgeAssetFrontmatter>;
+    file_path: string;
+}>): SchemaValidationFinding[];
+/**
+ * 构建知识资产注册表 — 从资产列表中建立索引。
+ */
+export declare function buildKnowledgeAssetRegistry(assets: KnowledgeAsset[]): Map<string, KnowledgeAsset>;
+/**
+ * 检测重复与冲突。
+ */
+export declare function detectDuplicateAndConflicts(assets: KnowledgeAsset[]): Array<{
+    kind: KnowledgeDuplicateKind;
+    asset_ids: string[];
+    detail_zh: string;
+    suggested_action: string;
+}>;
+/**
+ * 解析 canonical 权威 — 确定哪个资产是主题的权威定义。
+ */
+export declare function resolveCanonicalAuthority(assets: KnowledgeAsset[], subject: string): {
+    canonical_id?: string;
+    supporting_ids: string[];
+    conflicts: string[];
+};
+//# sourceMappingURL=knowledge_asset_schema.d.ts.map

package/dist/engine/knowledge_asset_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_asset_schema.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_asset_schema.ts"],"names":[],"mappings":"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"}