arkgate 4.8.6 → 4.8.8
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.
- package/CHANGELOG.md +55 -4
- package/README.md +37 -4
- package/bin/ark-dashboard.mjs +423 -0
- package/bin/ark-mcp-runtime.mjs +8 -2
- package/bin/ark.mjs +51 -3
- package/bin/lib/analysis-engine.mjs +5 -5
- package/bin/lib/doctor-human.mjs +9 -0
- package/bin/lib/doctor-plan.mjs +5 -1
- package/bin/lib/html-report.mjs +4 -2
- package/bin/lib/layer-description.mjs +27 -0
- package/bin/lib/prepare-write.mjs +7 -1
- package/dist/{configTypes-dy5PfTqS.d.ts → configTypes-0eHpocR3.d.ts} +4 -0
- package/dist/{diagnosticCatalog-D_DI7qrZ.d.ts → diagnosticCatalog-DxKCTBbp.d.ts} +3 -3
- package/dist/eslint/index.d.ts +1 -1
- package/dist/index.cjs +19 -19
- package/dist/index.d.ts +5 -4
- package/dist/index.js +20 -20
- package/dist/nestjs/index.cjs +5 -5
- package/dist/nestjs/index.d.ts +3 -3
- package/dist/nestjs/index.js +5 -5
- package/dist/runtime/index.cjs +15 -15
- package/dist/runtime/index.d.ts +6 -6
- package/dist/runtime/index.js +15 -15
- package/dist/{types-BuM8WNqe.d.ts → types-BK47clMl.d.ts} +1 -1
- package/dist/{types-DrqsOiTY.d.ts → types-DxvmJO-D.d.ts} +106 -2
- package/docs/README.md +12 -4
- package/docs/agent-guide.md +36 -1
- package/docs/ai-gates.md +13 -1
- package/docs/arkorder.md +11 -1
- package/docs/configuration.md +25 -3
- package/docs/develop.md +13 -6
- package/docs/enthusiast/README.md +13 -2
- package/docs/package-surface.md +21 -5
- package/docs/product-voice.md +25 -2
- package/docs/use.md +11 -3
- package/package.json +3 -1
- package/server.json +2 -2
- package/templates/agent-skills/ark-adopt/SKILL.md +19 -1
- package/templates/agent-skills/ark-autopilot/SKILL.md +1 -1
- package/templates/agent-skills/ark-contract/SKILL.md +1 -1
- package/templates/agent-skills/ark-place/SKILL.md +18 -4
- package/templates/skills/ark-adopt.md +19 -1
- package/templates/skills/ark-autopilot.md +1 -1
- package/templates/skills/ark-contract.md +1 -1
- package/templates/skills/ark-place.md +18 -4
package/dist/nestjs/index.cjs
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
"use strict";var
|
|
2
|
-
`)}function
|
|
1
|
+
"use strict";var Kn=Object.create;var _=Object.defineProperty;var At=Object.getOwnPropertyDescriptor;var Gn=Object.getOwnPropertyNames;var Fn=Object.getPrototypeOf,jn=Object.prototype.hasOwnProperty;var s=(t,e)=>_(t,"name",{value:e,configurable:!0});var H=(t,e,n)=>()=>{if(n)throw n[0];try{return t&&(e=t(t=0)),e}catch(r){throw n=[r],r}};var wt=(t,e)=>{for(var n in e)_(t,n,{get:e[n],enumerable:!0})},It=(t,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of Gn(e))!jn.call(t,o)&&o!==n&&_(t,o,{get:()=>e[o],enumerable:!(r=At(e,o))||r.enumerable});return t};var Bn=(t,e,n)=>(n=t!=null?Kn(Fn(t)):{},It(e||!t||!t.__esModule?_(n,"default",{value:t,enumerable:!0}):n,t)),Hn=t=>It(_({},"__esModule",{value:!0}),t),bt=(t,e,n,r)=>{for(var o=r>1?void 0:r?At(e,n):e,i=t.length-1,a;i>=0;i--)(a=t[i])&&(o=(r?a(e,n,o):a(o))||o);return r&&o&&_(e,n,o),o};function Me(t,e){return t<e?-1:t>e?1:0}function qn(t){return[...new Set(t)].sort(Me)}function V(t){if(!Array.isArray(t))return[];let e=[];for(let n of t)typeof n=="string"&&n.length>0&&e.push(n);return qn(e)}function zn(t){if(t===null)return null;if(typeof t=="string"||typeof t=="boolean"||typeof t=="number"&&Number.isFinite(t))return t}function Jn(t){return typeof t=="string"&&Wn.has(t)?t:"singleton"}function St(t){if(t===null||typeof t!="object"||Array.isArray(t))return;let e={};for(let n of Object.keys(t).sort(Me)){if(n.length===0)continue;let r=zn(t[n]);r!==void 0&&(e[n]=r)}return Object.keys(e).length>0?e:void 0}function Qn(t){if(t===null||typeof t!="object"||Array.isArray(t))return;let e=t,n={};typeof e.label=="string"&&e.label.length>0&&(n.label=e.label),typeof e.architectureKind=="string"&&e.architectureKind.length>0&&(n.architectureKind=e.architectureKind);let r=V(e.tags);r.length>0&&(n.tags=r),typeof e.group=="string"&&e.group.length>0&&(n.group=e.group);let o=St(e.metadata);return o&&(n.metadata=o),Object.keys(n).length>0?n:void 0}function _e(t){if(t===null||typeof t!="object"||Array.isArray(t))return;let e=t,n=typeof e.id=="string"?e.id.trim():"";if(!n)return;let r={id:n,lifetime:Jn(e.lifetime),uses:V(e.uses),reactsTo:V(e.reactsTo),raises:V(e.raises),sends:V(e.sends)},o=Qn(e.extendedInfo);return o&&(r.extendedInfo=o),r}function Zn(t){return St(t)}function Yn(t){if(t===null||typeof t!="object"||Array.isArray(t))return;let e=t,n=typeof e.xiHash=="string"?e.xiHash.trim():"";if(!n)return;let r=e.event;if(r===null||typeof r!="object"||Array.isArray(r))return;let o=r,i=typeof o.kind=="string"?o.kind.trim():"";if(!i)return;let a=e.residual;if(a===null||typeof a!="object"||Array.isArray(a))return;let c=a,d=typeof c.kind=="string"&&Xn.has(c.kind)?c.kind:void 0;if(!d)return;let u={kind:i},l=Zn(o.payload);l&&(u.payload=l);let y={kind:d};return typeof c.reasonCode=="string"&&c.reasonCode.length>0&&(y.reasonCode=c.reasonCode),typeof c.eventId=="string"&&c.eventId.length>0&&(y.eventId=c.eventId),typeof c.target=="string"&&c.target.length>0&&(y.target=c.target),{xiHash:n,event:u,residual:y}}function er(t){if(!Array.isArray(t))return[];let e=[];for(let n of t){let r=Yn(n);r&&e.push(r)}return e}function v(t){let e=typeof t.kernelInstanceId=="string"?t.kernelInstanceId:"",n=Array.isArray(t.components)?t.components:[],r=new Set,o=[];for(let a of n){let c=_e(a);!c||r.has(c.id)||(r.add(c.id),o.push(c))}o.sort((a,c)=>Me(a.id,c.id));let i=er(t.decisionTape);return{schemaVersion:"1.0",kernelInstanceId:e,components:o,...i.length>0?{decisionTape:i}:{}}}var Vn,Un,Wn,Xn,U=H(()=>{"use strict";Vn=["singleton","transient"],Un=["absorb","escalate_up","hold"],Wn=new Set(Vn);s(Me,"compare");s(qn,"uniqueSorted");s(V,"nameList");s(zn,"jsonPrimitive");s(Jn,"closedLifetime");s(St,"sanitizeMetadata");s(Qn,"sanitizeArkRunExtendedInfo");s(_e,"sanitizeArkRunComponent");Xn=new Set(Un);s(Zn,"sanitizeTapePayload");s(Yn,"sanitizeDecisionTapeRecord");s(er,"sanitizeDecisionTape");s(v,"buildDependencyInformationPackage")});function z(t,e){return t<e?-1:t>e?1:0}function Le(t){return[...new Set(t)].sort(z)}function Et(){return{tokens:[],ids:[],labels:[],tags:[],groups:[],architectureKinds:[]}}function $e(t){return t.tokens.length+t.ids.length+t.labels.length+t.tags.length+t.groups.length+t.architectureKinds.length>0}function I(t,e){if(t==null||t==="")return[];if(typeof t=="string")return Le(t.split(",").map(r=>r.trim()).filter(r=>r.length>0));if(!Array.isArray(t))throw new R(e);let n=[];for(let r of t){if(typeof r!="string")throw new R(e);let o=r.trim();o.length>0&&n.push(o)}return Le(n)}function Ct(t,e){if(e==="*")return t.length>0;if(!e.includes("*"))return t===e;let n="^";for(let r of e)r==="*"?n+=".*":/[.*+?^${}()|[\]\\]/.test(r)?n+=`\\${r}`:n+=r;return n+="$",new RegExp(n).test(t)}function W(t,e){return t?e.some(n=>Ct(t,n)):!1}function Ot(t){if(t==null||t==="")return nr;if(typeof t=="string"&&or.has(t))return t;throw new R("slice")}function Nt(t){if(t==null||t==="")return null;if(typeof t=="string"&&/^(0|[1-9]\d*)$/.test(t))return Number(t);if(typeof t=="number"&&Number.isInteger(t)&&t>=0)return t;throw new R("degreesOfSeparation")}function xt(t,e){if(t==null||t==="")return Et();if(typeof t=="string"||Array.isArray(t))return{...Et(),tokens:I(t,e)};if(typeof t!="object")throw new R(e);let n=t;for(let r of Object.keys(n))if(!sr.has(r))throw new R(e);return{tokens:[],ids:I(n.ids,e),labels:I(n.labels,e),tags:I(n.tags,e),groups:I(n.groups,e),architectureKinds:I(n.architectureKinds,e)}}function Dt(t={}){if(t==null||t==="")return Dt({});if(typeof t!="object"||Array.isArray(t))throw new R("slice","ArkRun graph query must be an object.");let e=t;for(let n of Object.keys(e))if(!ir.has(n))throw new R("slice",`ArkRun graph query key "${n}" is not closed.`);return{slice:Ot(e.slice),nodeIds:I(e.nodeIds,"nodeIds"),degreesOfSeparation:Nt(e.degreesOfSeparation),include:xt(e.include,"include"),exclude:xt(e.exclude,"exclude")}}function Tt(t){let e={};t.slice&&(e.slice=Ot(t.slice));let n=I(t.nodeIds??void 0,"nodeIds");n.length>0&&(e.nodeIds=n);let r=Nt(t.degreesOfSeparation??void 0);r!==null&&(e.degreesOfSeparation=r);let o=I(t.include??void 0,"include");o.length>0&&(e.include=o);let i=I(t.exclude??void 0,"exclude");return i.length>0&&(e.exclude=i),e}function ar(t){let e=[t.id];return t.label&&e.push(t.label),t.group&&e.push(t.group),t.architectureKind&&e.push(t.architectureKind),t.tags&&e.push(...t.tags),e}function Pt(t,e){if(!$e(e))return!0;let n=ar(t);return e.tokens.some(r=>n.some(o=>Ct(o,r)))||W(t.id,e.ids)||W(t.label,e.labels)||t.tags?.some(r=>W(r,e.tags))||W(t.group,e.groups)?!0:W(t.architectureKind,e.architectureKinds)}function cr(t){if(t&&typeof t=="object"&&!Array.isArray(t)){let e=t;return v({kernelInstanceId:e.kernelInstanceId,components:e.components})}return v({})}function dr(t){let e={id:t.id,kind:"component",lifetime:t.lifetime},n=t.extendedInfo;return n?.label&&(e.label=n.label),n?.group&&(e.group=n.group),n?.architectureKind&&(e.architectureKind=n.architectureKind),n?.tags&&n.tags.length>0&&(e.tags=[...n.tags]),e}function pe(t){return{id:t,kind:"interaction"}}function q(t,e){let n=t.get(e.id);(!n||n.kind==="interaction"&&e.kind==="component")&&t.set(e.id,e)}function fe(t,e,n,r,o){let i=`${n}\0${o}\0${r}`;e.has(i)||(e.add(i),t.push({from:n,to:r,kind:o}))}function ur(t,e){let n=new Map,r=[],o=new Set;for(let i of t){if(q(n,dr(i)),e==="technical"){for(let a of i.uses)q(n,n.get(a)??pe(a)),fe(r,o,i.id,a,"uses");continue}for(let a of i.raises)q(n,n.get(a)??pe(a)),fe(r,o,i.id,a,"raises");for(let a of i.reactsTo)q(n,n.get(a)??pe(a)),fe(r,o,a,i.id,"reactsTo");for(let a of i.sends)q(n,n.get(a)??pe(a)),fe(r,o,i.id,a,"sends")}return{nodes:n,edges:r}}function lr(t){let e=new Map,n=s((r,o)=>{let i=e.get(r);i?i.push(o):e.set(r,[o])},"push");for(let r of t)n(r.from,r.to),n(r.to,r.from);return e}function pr(t,e,n,r){let o=e.filter(c=>t.has(c));if(o.length===0)return new Set;let i=new Set,a=o.map(c=>({id:c,depth:0}));for(;a.length>0;){let c=a.shift();if(!(!c||i.has(c.id))&&(i.add(c.id),!(n!==null&&c.depth>=n)))for(let d of r.get(c.id)??[])!i.has(d)&&t.has(d)&&a.push({id:d,depth:c.depth+1})}return i}function J(t){let e=t.replace(/[^A-Za-z0-9_]/g,"_");return/^[A-Za-z_]/.test(e)?e:`n_${e}`}function vt(t){return t.replace(/\\/g,"\\\\").replace(/"/g,"#quot;").replace(/]/g,"#93;")}function fr(t){let e=new Set,n=new Map;for(let r of t){let o=J(r),i=o,a=2;for(;e.has(i);)i=`${o}_${a}`,a+=1;e.add(i),n.set(r,i)}return n}function mr(t){let e=t.slice==="technical"?"TD":"LR",n=t.nodes.map(c=>c.id),r=fr(n),o=Le(t.nodes.map(c=>c.group).filter(c=>!!c)),i=[`flowchart ${e}`],a=s((c,d)=>{let u=r.get(c.id)??J(c.id),l=vt(c.label??c.id);i.push(`${d}${u}["${l}"]`)},"emitNode");for(let c of o){let d=J(`group_${c}`);i.push(` subgraph ${d}["${vt(c)}"]`);for(let u of t.nodes)u.group===c&&a(u," ");i.push(" end")}for(let c of t.nodes)c.group||a(c," ");for(let c of t.edges){let d=r.get(c.from)??J(c.from),u=r.get(c.to)??J(c.to);i.push(` ${d} -->|${c.kind}| ${u}`)}return i.join(`
|
|
2
|
+
`)}function gr(t,e,n){let r=new Set(t.keys());if($e(n.include)&&(r=new Set([...r].filter(c=>{let d=t.get(c);return d!==void 0&&Pt(d,n.include)}))),$e(n.exclude))for(let c of[...r]){let d=t.get(c);d&&Pt(d,n.exclude)&&r.delete(c)}let o=e.filter(c=>r.has(c.from)&&r.has(c.to));n.nodeIds.length>0&&(r=pr(r,n.nodeIds,n.degreesOfSeparation,lr(o)));let i=[...r].sort(z).map(c=>t.get(c)).filter(c=>!!c),a=o.filter(c=>r.has(c.from)&&r.has(c.to)).sort((c,d)=>z(c.from,d.from)||z(c.kind,d.kind)||z(c.to,d.to));return{nodes:i,edges:a}}function Mt(t={},e={}){let n=cr(t),r=Dt(e),o=ur(n.components,r.slice),i=gr(o.nodes,o.edges,r),a={schemaVersion:tr,kernelInstanceId:n.kernelInstanceId,slice:r.slice,query:r,nodes:i.nodes,edges:i.edges,mermaid:""};return a.mermaid=mr(a),a}var tr,nr,rr,R,or,ir,sr,Ke=H(()=>{"use strict";U();tr="1.0",nr="process",rr=["process","technical"],R=class extends Error{static{s(this,"InvalidArkRunGraphQueryError")}option;constructor(e,n){super(n??(e==="slice"?'ArkRun graph slice must be "process" or "technical".':e==="degreesOfSeparation"?"ArkRun graph degreesOfSeparation must be a non-negative integer.":`ArkRun graph ${e} is not a closed query.`)),this.name="InvalidArkRunGraphQueryError",this.option=e}},or=new Set(rr),ir=new Set(["slice","nodeIds","degreesOfSeparation","include","exclude"]),sr=new Set(["ids","labels","tags","groups","architectureKinds"]);s(z,"compare");s(Le,"uniqueSorted");s(Et,"emptyMatch");s($e,"matchHasCriteria");s(I,"nameList");s(Ct,"globMatch");s(W,"anyGlob");s(Ot,"closedSlice");s(Nt,"closedDegrees");s(xt,"closedMatch");s(Dt,"closeArkRunGraphQuery");s(Tt,"arkRunGraphQueryFromSearchParams");s(ar,"nodeFields");s(Pt,"nodeMatches");s(cr,"asPackage");s(dr,"componentNode");s(pe,"interactionNode");s(q,"addNode");s(fe,"addEdge");s(ur,"buildSlice");s(lr,"adjacency");s(pr,"neighborhood");s(J,"mermaidSafeId");s(vt,"mermaidLabel");s(fr,"uniqueMermaidIds");s(mr,"formatArkRunGraphMermaid");s(gr,"filterGraph");s(Mt,"requestArkRunGraph")});function hr(t){if(t===void 0)return"local";if(typeof t=="string"&&yr.has(t))return t;throw new me("transport")}function kr(t){if(t===void 0)return!0;if(t===!0||t===!1)return t;throw new me("ephemeral")}function _t(t){let e=hr(t.transport),n=kr(t.ephemeral),r=e==="broker"&&t.brokerBound!==!0,o=e==="broker"&&!r?"broker":"local",i=e==="localBlocking";return{transport:e,ephemeral:n,deliveredVia:o,fallbackToLocal:r,notifySubscribers:o==="local",awaitHandlers:i,awaitHandoff:n||i}}var Ge,yr,me,ge=H(()=>{"use strict";Ge=["local","localBlocking","broker"],yr=new Set(Ge),me=class extends Error{static{s(this,"InvalidArkRunSendOptionError")}option;constructor(e){super(e==="transport"?'ArkRun transport must be "local", "localBlocking", or "broker".':"ArkRun ephemeral must be a boolean."),this.name="InvalidArkRunSendOptionError",this.option=e}};s(hr,"closedArkRunTransportKind");s(kr,"closedArkRunEphemeral");s(_t,"resolveArkRunSendPlan")});function $t(t){return t==="production"}function Er(t){let e=t.split(".");if(e.length!==4)return;let n=[];for(let r of e){if(!/^\d{1,3}$/.test(r))return;let o=Number(r);if(o>255)return;n.push(o)}return n}function Kt(t){if(t.startsWith("[::ffff:")&&t.endsWith("]"))return t.slice(8,-1);if(t.startsWith("::ffff:"))return t.slice(7)}function he(t){if(typeof t!="string")return!1;let e=t.trim().toLowerCase();if(e==="localhost"||e==="::1"||e==="[::1]")return!0;let n=Kt(e);if(n)return he(n);let r=Er(e);return r!==void 0&&r[0]===127}function Gt(t){if(t===void 0)return Lt;if(typeof t!="string")throw new b(String(t));let e=t.trim();if(Sr.has(e.toLowerCase())||!he(e))throw new b(e);let n=e.toLowerCase();if(n==="localhost")return Lt;if(n==="[::1]")return"::1";let r=Kt(n);return r?Gt(r):n}function xr(t){if(t===void 0)return wr;if(typeof t!="number"||!Number.isInteger(t)||t<0||t>65535)throw new b(`port:${String(t)}`);return t}function We(t={}){if($t(t.nodeEnv)||$t(t.processNodeEnv))throw new ye;return{host:Gt(t.host),port:xr(t.port)}}function C(t,e,n){return`http://${t.includes(":")?`[${t}]`:t}:${e}${n}`}function Pr(t){if(t!==void 0)try{return JSON.parse(JSON.stringify(t))}catch{return}}function vr(t){return{kinds:[...Ge],ephemeralDefault:t.ephemeralDefault===!1?!1:!0,brokerBound:t.brokerBound===!0,cloudSdksShipped:!1,fallback:br}}function x(t){if(!(!t||typeof t!="object"||Array.isArray(t)))return t}function Cr(t){let e=x(t);if(!e||typeof e.id!="string")return;let n=e.status;if(n!=="pending"&&n!=="failed")return;let r=x(e.event),o=r&&typeof r.intent=="string"?r.intent:typeof e.intent=="string"?e.intent:void 0,i={id:e.id,status:n,attempts:typeof e.attempts=="number"&&Number.isFinite(e.attempts)?e.attempts:0};return o&&(i.intent=o),typeof e.error=="string"&&e.error.length>0&&(i.error=e.error),typeof e.updatedAt=="string"&&(i.updatedAt=e.updatedAt),i}function ke(t){if(typeof t!="number"||!Number.isFinite(t))return w;let e=Math.trunc(t);return e<0?0:e>w?w:e}function Z(t,e){let n=typeof t=="string"&&t.trim().length>0?t.trim():t&&typeof t=="object"&&"constructor"in t?String(t.constructor?.name??e):e,r=/^InMemory/i.test(n)?"memory":"durable";return{role:e,id:n,kind:r}}function qe(t={}){let e=x(t),n=x(e?.durability)??e,r=Array.isArray(n?.stores)?n.stores:Array.isArray(e?.stores)?e.stores:[],o=[];for(let i of r){let a=x(i);if(!a)continue;let c=a.role;if(c!=="outbox"&&c!=="audit"&&c!=="workflow")continue;let d=typeof a.id=="string"?a.id:typeof a.name=="string"?a.name:void 0;if(!d)continue;let u=a.kind==="memory"||a.kind==="durable"?a.kind:Z(d,c).kind;o.push({role:c,id:d,kind:u})}return{durability:{stores:o}}}function Y(t=[],e={}){let n=ke(e.sampleLimit),r=Array.isArray(t)?t:[],o=[],i=[];for(let a of r){let c=Cr(a);c&&(c.status==="pending"?o.push(c):i.push(c))}return{available:!0,pendingCount:o.length,failedCount:i.length,pending:o.slice(0,n),failed:i.slice(0,n),sampleLimit:n}}function Q(){return{available:!1,pendingCount:0,failedCount:0,pending:[],failed:[],sampleLimit:w}}function Or(t){let e=x(t);if(!e||typeof e.id!="string")return;let n=typeof e.workflowName=="string"?e.workflowName:typeof e.name=="string"?e.name:void 0;if(!n)return;let r={id:e.id,name:n,status:typeof e.status=="string"?e.status:"unknown"};return typeof e.currentStep=="string"&&(r.currentStep=e.currentStep),typeof e.error=="string"&&e.error.length>0&&(r.error=e.error),r}function Nr(t){return t==="idle"||t==="waiting"}function ee(t=[],e={}){let n=ke(e.sampleLimit),r=Array.isArray(t)?t:[],o=[],i=0,a=0,c=0,d=0;for(let u of r){let l=Or(u);l&&(o.push(l),l.status==="running"?i+=1:l.status==="compensating"?a+=1:l.status==="failed"?c+=1:Nr(l.status)&&(d+=1))}return{available:!0,total:o.length,runningCount:i,compensatingCount:a,failedCount:c,pendingCount:d,workflows:o.slice(0,n),sampleLimit:n}}function X(){return{available:!1,total:0,runningCount:0,compensatingCount:0,failedCount:0,pendingCount:0,workflows:[],sampleLimit:w}}function Dr(t){if(t===void 0)return;let e=x(t);if(!e||e.available===!1)return Q();let n=ke(e.sampleLimit);if(Array.isArray(e.pending)||Array.isArray(e.failed)||Array.isArray(e.records)){let r=[...Array.isArray(e.pending)?e.pending:[],...Array.isArray(e.failed)?e.failed:[],...Array.isArray(e.records)?e.records:[]],o=Y(r,{sampleLimit:n}),i=typeof e.pendingCount=="number"&&Number.isFinite(e.pendingCount)?Math.max(0,Math.trunc(e.pendingCount)):o.pendingCount,a=typeof e.failedCount=="number"&&Number.isFinite(e.failedCount)?Math.max(0,Math.trunc(e.failedCount)):o.failedCount;return{...o,pendingCount:i,failedCount:a,sampleLimit:n}}return Q()}function Tr(t){if(t===void 0)return;let e=x(t);if(!e||e.available===!1)return X();let n=ke(e.sampleLimit);if(Array.isArray(e.workflows)){let r=ee(e.workflows,{sampleLimit:n}),o=typeof e.total=="number"&&Number.isFinite(e.total)?Math.max(0,Math.trunc(e.total)):r.total,i=typeof e.runningCount=="number"&&Number.isFinite(e.runningCount)?Math.max(0,Math.trunc(e.runningCount)):r.runningCount,a=typeof e.compensatingCount=="number"&&Number.isFinite(e.compensatingCount)?Math.max(0,Math.trunc(e.compensatingCount)):r.compensatingCount,c=typeof e.failedCount=="number"&&Number.isFinite(e.failedCount)?Math.max(0,Math.trunc(e.failedCount)):r.failedCount,d=typeof e.pendingCount=="number"&&Number.isFinite(e.pendingCount)?Math.max(0,Math.trunc(e.pendingCount)):r.pendingCount;return{...r,total:o,runningCount:i,compensatingCount:a,failedCount:c,pendingCount:d,sampleLimit:n}}return X()}function Ft(t={}){let e=We({host:t.host,port:t.port}),n=v({kernelInstanceId:t.kernelInstanceId,components:t.package&&typeof t.package=="object"&&!Array.isArray(t.package)&&Array.isArray(t.package.components)?t.package.components:[]}),r=Dr(t.outbox),o=Tr(t.workflows),i={schemaVersion:Ar,kernelInstanceId:typeof t.kernelInstanceId=="string"?t.kernelInstanceId:n.kernelInstanceId,bind:{host:e.host,port:e.port,loopback:!0},package:{...n,schemaVersion:"1.0"},transport:vr(t),observability:Pr(t.observability)??{},hardening:qe(t.hardening)};return r&&(i.outbox=r),o&&(i.workflows=o),i}function ze(t){return`event: ${Ir}
|
|
3
3
|
data: ${JSON.stringify(t)}
|
|
4
4
|
|
|
5
|
-
`}var
|
|
5
|
+
`}var Ar,Lt,wr,je,Be,He,Ve,Ue,Ir,br,w,ye,b,Sr,Re=H(()=>{"use strict";U();ge();Ar="1.0",Lt="127.0.0.1",wr=0,je="/snapshot",Be="/events",He="/graph",Ve="/outbox",Ue="/workflows",Ir="snapshot",br="in-process-local",w=32,ye=class extends Error{static{s(this,"ArkRunInspectorProductionError")}constructor(){super("ArkRun inspector refuses to start when NODE_ENV=production."),this.name="ArkRunInspectorProductionError"}},b=class extends Error{static{s(this,"ArkRunInspectorBindError")}constructor(e){super(`ArkRun inspector binds loopback only (default 127.0.0.1). Public host "${e}" is rejected.`),this.name="ArkRunInspectorBindError"}},Sr=new Set(["","*","0","0.0.0.0","::","::0","[::]","[::0]","::ffff:0.0.0.0","[::ffff:0.0.0.0]"]);s($t,"isArkRunInspectorProductionEnv");s(Er,"ipv4Octets");s(Kt,"unwrapIpv4Mapped");s(he,"isArkRunInspectorLoopbackHost");s(Gt,"closedHost");s(xr,"closedPort");s(We,"resolveArkRunInspectorBind");s(C,"arkRunInspectorUrl");s(Pr,"jsonClone");s(vr,"closedTransportFacts");s(x,"asRecord");s(Cr,"closedOutboxSummary");s(ke,"closedSampleLimit");s(Z,"classifyArkRunInspectorStoreDurability");s(qe,"buildArkRunInspectorHardening");s(Y,"buildArkRunInspectorOutboxMonitor");s(Q,"unavailableArkRunInspectorOutboxMonitor");s(Or,"closedWorkflowSummary");s(Nr,"isPendingWorkflowStatus");s(ee,"buildArkRunInspectorWorkflowsMonitor");s(X,"unavailableArkRunInspectorWorkflowsMonitor");s(Dr,"closedOutboxMonitor");s(Tr,"closedWorkflowsMonitor");s(Ft,"buildArkRunInspectorSnapshot");s(ze,"formatArkRunInspectorSseEvent")});var Pn={};wt(Pn,{listenArkRunInspector:()=>Ro});function fo(){return{"content-type":"application/json; charset=utf-8","cache-control":"no-store"}}function mo(){return{"content-type":"text/event-stream; charset=utf-8","cache-control":"no-store",connection:"keep-alive","x-accel-buffering":"no"}}function go(t){let e=t&&t.length>0?t:"/";return new URL(e,"http://127.0.0.1")}function P(t,e,n){if(!(t.writableEnded||t.destroyed))try{t.writeHead(e,fo()),t.end(JSON.stringify(n))}catch{}}function yo(t,e){let n=t.address();if(n===null||typeof n=="string")throw new b(e.host);if(!he(n.address))throw new b(n.address);return{host:e.host,port:n.port}}async function ho(t){if(typeof t.listInspectorOutbox=="function")return t.listInspectorOutbox();let e=t.outbox??t.eventBuffer;if(!e||typeof e.list!="function")return Q();let[n,r]=await Promise.all([e.list("pending"),e.list("failed")]);return Y([...n??[],...r??[]],{sampleLimit:w})}async function ko(t){return typeof t.listInspectorWorkflows=="function"?t.listInspectorWorkflows():!t.workflowEngine||typeof t.workflowEngine.list!="function"?X():ee(await t.workflowEngine.list(),{sampleLimit:w})}async function Ro(t,e){let n=await import("http"),r=new Set,o=new Set,i=typeof e.sseIntervalMs=="number"&&Number.isFinite(e.sseIntervalMs)?Math.max(0,e.sseIntervalMs):1e3,a=e.bind,c=s(()=>t.getInspectorSnapshot(a),"snapshot"),d=n.createServer((u,l)=>{let y=go(u.url),f=y.pathname;if(u.method==="GET"&&(f==="/"||f===je)){P(l,200,c());return}if(u.method==="GET"&&f===He){try{P(l,200,t.requestGraph(Tt({slice:y.searchParams.get("slice"),nodeIds:y.searchParams.get("nodeIds"),degreesOfSeparation:y.searchParams.get("degreesOfSeparation"),include:y.searchParams.get("include"),exclude:y.searchParams.get("exclude")})))}catch(m){if(m instanceof R){P(l,400,{error:m.message,option:m.option});return}throw m}return}if(u.method==="GET"&&f===Ve){ho(t).then(m=>P(l,200,m)).catch(m=>{P(l,500,{error:m instanceof Error?m.message:"outbox monitor failed"})});return}if(u.method==="GET"&&f===Ue){ko(t).then(m=>P(l,200,m)).catch(m=>{P(l,500,{error:m instanceof Error?m.message:"workflows monitor failed"})});return}if(u.method==="GET"&&f===Be){l.writeHead(200,mo()),l.flushHeaders(),l.write(ze(c())),r.add(l);let m=i>0?setInterval(()=>{l.write(ze(c()))},i):void 0;m&&o.add(m);let h=s(()=>{r.delete(l),m&&(clearInterval(m),o.delete(m))},"drop");u.on("close",h),l.on("close",h);return}P(l,404,{error:"not found"})});try{await new Promise((u,l)=>{let y=s(f=>l(f),"onError");d.once("error",y),d.listen({host:e.bind.host,port:e.bind.port},()=>{d.off("error",y);try{a=yo(d,e.bind),u()}catch(f){l(f instanceof Error?f:new b(e.bind.host))}})})}catch(u){throw await new Promise(l=>{d.close(()=>l())}),u}return{host:a.host,port:a.port,url:C(a.host,a.port,"/"),snapshotUrl:C(a.host,a.port,je),eventsUrl:C(a.host,a.port,Be),graphUrl:C(a.host,a.port,He),outboxUrl:C(a.host,a.port,Ve),workflowsUrl:C(a.host,a.port,Ue),close(){for(let u of o)clearInterval(u);o.clear();for(let u of r)u.end();return r.clear(),new Promise((u,l)=>{d.close(y=>{y?l(y):u()})})}}}var vn=H(()=>{"use strict";Ke();Re();s(fo,"jsonHeaders");s(mo,"sseHeaders");s(go,"requestUrl");s(P,"writeJson");s(yo,"boundAddress");s(ho,"resolveOutboxMonitor");s(ko,"resolveWorkflowsMonitor");s(Ro,"listenArkRunInspector")});var Eo={};wt(Eo,{ARK_KERNEL:()=>j,ArkModule:()=>E,InjectArk:()=>So});module.exports=Hn(Eo);var Oe=require("@nestjs/common");Ke();Re();U();ge();var jt=0;function Mr(){return jt+=1,`audit-${Date.now()}-${jt}`}s(Mr,"createAuditId");function _r(t,e){return!(e.type&&t.type!==e.type||e.intent&&t.intent!==e.intent||e.correlationId&&t.correlationId!==e.correlationId||e.subject&&t.subject!==e.subject||e.since&&t.timestamp<e.since||e.until&&t.timestamp>e.until)}s(_r,"matchesQuery");var Ae=class{constructor(e){this.maxRecords=e}maxRecords;static{s(this,"InMemoryAuditStore")}records=[];append(e){this.records.push(e),this.maxRecords!==void 0&&this.records.length>this.maxRecords&&this.records.splice(0,this.records.length-this.maxRecords)}query(e={}){let n=this.records.filter(r=>_r(r,e));return e.limit===void 0?[...n]:n.slice(-e.limit)}clear(){this.records.length=0}},we=class{constructor(e){this.store=e}store;static{s(this,"AuditTrailImpl")}async record(e){let n={id:Mr(),timestamp:e.timestamp??new Date().toISOString(),type:e.type,source:e.source,actor:e.actor,intent:e.intent,correlationId:e.correlationId,causationId:e.causationId,subject:e.subject,details:e.details};return await this.store.append(n),n}async query(e){return this.store.query(e)}async clear(){await this.store.clear()}};function Je(t={}){return new we(t.store??new Ae(t.maxRecords))}s(Je,"createAuditTrail");var O=class extends Error{static{s(this,"PolicyViolationError")}violations;constructor(e){let n=e.map(r=>`- ${r.policyName}: ${r.message}`).join(`
|
|
6
6
|
`);super(`Hard policy violation(s) detected:
|
|
7
|
-
${n}`),this.name="PolicyViolationError",this.violations=e}};var O=class{static{s(this,"PolicyEngine")}policies=[];constructor(e=[]){for(let n of e)this.add(n)}add(e){if(this.policies.some(n=>n.name===e.name))throw new Error(`Policy "${e.name}" is already registered in this engine.`);this.policies.push(e)}getPolicies(){return[...this.policies]}evaluate(e){let n=[];for(let i of this.policies){let a=i.check(e);if(a!==!0){if(a===!1){n.push({policyName:i.name,severity:i.severity,message:`Policy "${i.name}" was violated.`});continue}if(Array.isArray(a))for(let c of a)n.push({policyName:i.name,severity:i.severity,message:c.message,details:c.details});else n.push({policyName:i.name,severity:i.severity,message:a.message,details:a.details})}}let r=n.filter(i=>i.severity==="hard"),o=n.filter(i=>i.severity==="soft");return{passed:n.length===0,violations:n,hardViolations:r,softViolations:o}}enforce(e){let n=this.evaluate(e);if(n.hardViolations.length>0)throw new P(n.hardViolations);return n}clear(){this.policies.length=0}};function ue(t){let e=t.severity??"soft";return{name:t.name,severity:e,tags:t.tags,owner:t.owner,version:t.version,rationale:t.rationale,enforcementMode:t.enforcementMode,deprecated:t.deprecated,replacedBy:t.replacedBy,check:t.check}}s(ue,"definePolicy");function gr(t){let e=t.indexOf(".");return e>=0?t.slice(0,e):t}s(gr,"defaultLayerOf");function xt(t,e){return e.resolveLayer?.(t)??gr(t)}s(xt,"resolveLayer");function mr(t,e,n){return t===n.from&&e===n.to}s(mr,"matchesRule");function Ct(t){let e=t.name??"Layer isolation",n=t.severity??"hard";return ue({name:e,severity:n,tags:["layer"],check:s(r=>{let o=[...(r.edges??[]).filter(a=>a.kind==="declared"||a.kind==="produces").map(a=>({from:a.from,to:a.to})),...(r.relationships??[]).filter(a=>a.kind==="dependsOn").map(a=>({from:a.from,to:a.to}))],i=[];for(let a of o){let c=xt(a.from,t),d=xt(a.to,t);for(let l of t.rules)!l.allowed&&mr(c,d,l)&&i.push({policyName:e,severity:n,message:l.message??`Layer violation: ${a.from} (${c}) must not relate to ${a.to} (${d})`})}return i.length>0?i:!0},"check")})}s(Ct,"defineLayerPolicy");function Me(t){return t.tags?.includes("layer")??!1}s(Me,"isLayerPolicy");function Le(t,e={}){return Ct({name:e.name??`${t.name} layer policy`,severity:e.severity??"hard",rules:t.rules,resolveLayer:t.resolveLayer})}s(Le,"defineArchitectureProfilePolicy");function Ke(t){return e=>({event:e,relationships:t.intentRegistry?.getAllRelationships(),edges:t.dependencyGraph?.getEdges()})}s(Ke,"buildPublishPolicyContext");var U=class extends Error{static{s(this,"UnregisteredIntentError")}intentName;constructor(e){super(`Intent "${e}" is not registered. Register it with IntentRegistry.define() before publish/subscribe, including metadata.source producer intents in strict mode.`),this.name="UnregisteredIntentError",this.intentName=e}},W=class extends Error{static{s(this,"InvalidIntentNameError")}intentName;reason;constructor(e,n){super(`Invalid intent name "${e}": ${n}`),this.name="InvalidIntentNameError",this.intentName=e,this.reason=n}},q=class extends Error{static{s(this,"LayerPolicyContextError")}constructor(){super("Layer/architecture policies require intentRegistry, dependencyGraph, or a custom getPolicyContext. Without graph/registry context, layer policies cannot inspect relationships."),this.name="LayerPolicyContextError"}},z=class extends Error{static{s(this,"EventContractViolationError")}intentName;issues;constructor(e,n){super(`Event contract violation for "${e}". Register a matching event contract/version or fix the payload before publishing.`),this.name="EventContractViolationError",this.intentName=e,this.issues=n}},N=class extends Error{static{s(this,"UnknownEventSourceError")}intentName;source;constructor(e,n){super(n?`Event "${e}" metadata.source "${n}" is not registered. Register the producer intent or publish from a known source.`:`Event "${e}" must include metadata.source. Strict Ark uses source to enforce observed layer flow.`),this.name="UnknownEventSourceError",this.intentName=e,this.source=n}},b=class extends Error{static{s(this,"SourceMetadataOverrideError")}boundSource;attemptedSource;constructor(e,n){super(`Source-bound publisher for "${e}" cannot publish with metadata.source "${n}". Create a publisher for the intended source instead.`),this.name="SourceMetadataOverrideError",this.boundSource=e,this.attemptedSource=n}},J=class extends Error{static{s(this,"ObservedLayerFlowViolationError")}source;intentName;fromLayer;toLayer;constructor(e,n,r,o,i){super(i??`Observed layer violation: "${e}" (${r}) must not produce "${n}" (${o}). Route this through an allowed layer or adjust the architecture profile rule.`),this.name="ObservedLayerFlowViolationError",this.source=e,this.intentName=n,this.fromLayer=r,this.toLayer=o}};var Ot=["Domain.","Application.","Adapter.","Workflow.","Job.","Presentation.","Reporting.","Metadata.","Security.","Audit.","Observability.","Kernel."];function Ge(t){if(!t||typeof t!="string")return{valid:!1,reason:"Intent name must be a non-empty string"};if(!Ot.some(n=>t.startsWith(n)))return{valid:!1,reason:`Intent "${t}" must start with one of: ${Ot.join(", ")}`};let e=t.slice(t.indexOf(".")+1);return!e||!/^[A-Za-z][A-Za-z0-9_.]*$/.test(e)?{valid:!1,reason:`Intent "${t}" has an invalid segment after the layer prefix`}:{valid:!0}}s(Ge,"validateIntentName");function Q(t,e){if(!(!e.strictRegistry&&!e.validateIntentNaming)){if(e.validateIntentNaming){let n=Ge(t);if(!n.valid)throw new W(t,n.reason)}if(e.strictRegistry&&e.intentRegistry&&!e.intentRegistry.has(t))throw new U(t)}}s(Q,"assertIntentAllowed");function Nt(t,e){if(e.requireKnownSource){if(!t.metadata.source||t.metadata.source==="unknown")throw new N(t.intent);if(e.intentRegistry&&!e.intentRegistry.has(t.metadata.source))throw new N(t.intent,t.metadata.source)}}s(Nt,"assertSourceAllowed");function X(t,e){if(!e.eventContracts)return;let n=e.eventContracts.validate(t);if(!n.ok&&(e.strictEventContracts||n.contract))throw new z(t.intent,n.issues)}s(X,"assertContractAllowed");function D(t){if(typeof t!="object"||t===null||Array.isArray(t))return!1;let e=Object.getPrototypeOf(t);return e===Object.prototype||e===null}s(D,"isPlainRecord");function T(t){return Array.isArray(t)?t.map(T):D(t)?Object.fromEntries(Object.entries(t).map(([e,n])=>[e,T(n)])):t}s(T,"clonePatchValue");function je(t,e,n="payload"){let r={...t};for(let[o,i]of Object.entries(e)){let a=`${n}.${o}`;if(!(o in r)||r[o]===void 0){r[o]=T(i);continue}if(D(r[o])&&D(i)){r[o]=je(r[o],i,a);continue}if(Array.isArray(r[o])&&Array.isArray(i)){r[o]=Fe(r[o],i,a);continue}throw new Error(`Interceptor patch cannot overwrite existing ${a}.`)}return r}s(je,"mergeRecordPatch");function Fe(t,e,n="payload"){let r=[...t];return e.forEach((o,i)=>{let a=`${n}[${i}]`;if(i>=r.length||r[i]===void 0){r[i]=T(o);return}if(D(r[i])&&D(o)){r[i]=je(r[i],o,a);return}if(Array.isArray(r[i])&&Array.isArray(o)){r[i]=Fe(r[i],o,a);return}throw new Error(`Interceptor patch cannot overwrite existing ${a}.`)}),r}s(Fe,"mergeArrayPatch");function Dt(t,e){if(Array.isArray(e)){if(t===void 0)return T(e);if(!Array.isArray(t))throw new Error("Array interceptor patch requires an array payload.");return Fe(t,e)}if(t===void 0)return T(e);if(!D(t))throw new Error("Object interceptor patch requires an object payload.");return je(t,e)}s(Dt,"applyPayloadPatch");async function Tt(t,e){if(t.metadata.allowInterception===!1)return t;let n=[...e.interceptorsForIntent(t.intent)],r=t;for(let o of n){let i=[];try{if(await Promise.resolve(o.interceptor({event:r,intercept:s(d=>{i.push(d)},"intercept")})),i.length===0)continue;let a=new Date().toISOString(),c={...r,metadata:{...r.metadata,interceptions:[...r.metadata.interceptions??[],{interceptorId:o.interceptorId,timestamp:a}]}};for(let d of i)c={...c,payload:Dt(c.payload,d),metadata:{...c.metadata}};X(c,{eventContracts:e.eventContracts,strictEventContracts:e.strictEventContracts}),r=c,o.lastInterceptedAt=a,e.appendTrace({type:"event.intercepted",timestamp:a,intent:r.intent,correlationId:r.metadata.correlationId,traceId:r.metadata.traceId,spanId:r.metadata.spanId,details:{registrationId:o.registrationId,interceptorId:o.interceptorId,patchesApplied:i.length}}),await e.recordAudit("event.intercepted",r,{registrationId:o.registrationId,interceptorId:o.interceptorId,patchesApplied:i.length})}catch(a){await yr(o,r,a,e)}}return r}s(Tt,"applyInterceptors");async function yr(t,e,n,r){let o=n instanceof Error?n.message:String(n);r.appendTrace({type:"interceptor.error",timestamp:new Date().toISOString(),intent:e.intent,correlationId:e.metadata.correlationId,traceId:e.metadata.traceId,spanId:e.metadata.spanId,details:{registrationId:t.registrationId,interceptorId:t.interceptorId,error:o}}),await r.recordAudit("interceptor.error",e,{registrationId:t.registrationId,interceptorId:t.interceptorId,error:o})}s(yr,"recordInterceptorError");var _t=new Map;function $t(t){return/[.*+?^${}()|[\]\\]/.test(t)?`\\${t}`:t}s($t,"escapeLiteral");function Ft(t){let e="";for(let n=0;n<t.length;n+=1){let r=t[n];if(r==="\\"&&n+1<t.length){let o=t[n+1];if("*?{}[],".includes(o)||o==="\\"){e+="\\"+o,n+=1;continue}e+="/";continue}e+=r}return e}s(Ft,"normalizeGlobSeparators");function hr(t){let e=0;for(let n=0;n<t.length;n+=1){let r=t[n];if(r==="\\"){n+=1;continue}if(r==="{")e+=1;else if(r==="}"&&(e-=1,e<0))return!1}return e===0}s(hr,"bracesBalanced");function Mt(t){let e=_t.get(t);if(e)return e;let n=Ft(t),r=hr(n),o="",i=0;for(let c=0;c<n.length;c+=1){let d=n[c];d==="\\"&&c+1<n.length?(o+=$t(n[c+1]),c+=1):d==="*"?n[c+1]==="*"?n[c+2]==="/"?(o+="(?:.*/)?",c+=2):(o+=".*",c+=1):o+="[^/]*":d==="?"?o+="[^/]":d==="{"&&r?(o+="(?:",i+=1):d==="}"&&r&&i>0?(o+=")",i-=1):d===","&&r&&i>0?o+="|":o+=$t(d)}let a=new RegExp(`^${o}$`);return _t.set(t,a),a}s(Mt,"globToRegExp");function Lt(t,e){if(!e?.length)return;let n=String(t).split(/[/\\]/).filter(Boolean),r=new Set(e.map(o=>String(o).toLowerCase()));for(let o=0;o<n.length-1;o+=1)if(r.has(n[o].toLowerCase()))return`${n[o].toLowerCase()}/${n[o+1].toLowerCase()}`}s(Lt,"sliceIdForPath");function kr(t){let e=new Set;for(let n of t??[]){let o=Ft(String(n)).split("/").filter(Boolean);for(let i=0;i<o.length;i+=1){let a=o[i];if((a==="**"||a==="*")&&i>0){let c=o[i-1];c&&!c.includes("*")&&!c.includes("{")&&!c.includes("}")&&e.add(c)}}}return[...e]}s(kr,"inferSliceFoldersFromPatterns");function Rr(t,e,n){if(Array.isArray(t.sliceFolders)&&t.sliceFolders.length>0)return t.sliceFolders.filter(o=>typeof o=="string"&&o.length>0);let r=(n??[]).find(o=>o.name===e);return kr(r?.patterns)}s(Rr,"resolveSliceFolders");function Kt(t){return String(t).split(/[/\\]/).filter(e=>!!e&&e!==".").map(e=>e.toLowerCase())}s(Kt,"normalizeSegments");function Bt(t){let e=t.length;for(;e>0&&t[e-1]==="/";)e-=1;return t.slice(0,e)}s(Bt,"trimTrailingSlashes");var Ar=["src","app"];function wr(t){let e=Bt(t.replace(/^[./]+/,""));return e==="*"||e==="**"}s(wr,"isBlanketRoot");function Gt(t,e){if(!t||!e?.length)return!1;let n=String(t).split(/[/\\]/).join("/"),r=n.toLowerCase(),o=Kt(n);for(let i of e){if(typeof i!="string"||i.length===0||wr(i))continue;if(i.includes("*")){let d=Bt(i.toLowerCase());if(Mt(d).test(r)||Mt(`${d}/**`).test(r))return!0;continue}let a=Kt(i);if(a.length===0)continue;let c=Ar.includes(o[0])&&a[0]!==o[0]?[0,1]:[0];for(let d of c){if(d+a.length>o.length)continue;let l=!0;for(let p=0;p<a.length;p+=1)if(o[d+p]!==a[p]){l=!1;break}if(l)return!0}}return!1}s(Gt,"pathUnderSharedRoot");function jt(t,e){let n=String(t).split(/[/\\]/).filter(Boolean).join("/").toLowerCase();if(!n)return!1;let r=e.toLowerCase();return n===r?!0:!n.includes("/")&&r.endsWith(`/${n}`)}s(jt,"sliceMatchesDeclaration");function Ir(t,e,n){return!t?.length||!e||!n?!1:t.some(r=>r&&typeof r.from=="string"&&typeof r.to=="string"&&jt(r.from,e)&&jt(r.to,n))}s(Ir,"crossSliceEdgeAllowed");function Er(t){if(!t.fromPath||!t.toPath)return{denied:!0,reason:"missing-path"};if(t.folderCount<=0)return{denied:!0,reason:"no-slice-folders"};let e=!!t.fromSlice||t.fromShared===!0,n=!!t.toSlice||t.toShared===!0;return!e||!n?{denied:!0,reason:"unclassifiable-path"}:!t.fromSlice||!t.toSlice?{denied:!1}:t.fromSlice===t.toSlice?{denied:!1}:t.crossSliceAllowed?{denied:!1}:{denied:!0,reason:"cross-slice"}}s(Er,"peerIsolationDecision");function Ht(t,e,n,r){return Sr(t,e,n,r)?.rule}s(Ht,"findDeniedEdgeRule");function Sr(t,e,n,r){for(let o of t??[])if(!(o.from!==e||o.to!==n)&&o.allowed===!1){if(o.peerIsolation){let i=r?.fromPath,a=r?.toPath,c=Rr(o,e,r?.layers),d=i&&a?Lt(i,c):void 0,l=i&&a?Lt(a,c):void 0,p=Er({fromPath:i,toPath:a,folderCount:c.length,fromSlice:d,toSlice:l,fromShared:!d&&Gt(i,o.sharedRoots),toShared:!l&&Gt(a,o.sharedRoots),crossSliceAllowed:Ir(o.allowedCrossSlice,d,l)});if(p.denied)return{rule:o,peerIsolationReason:p.reason,fromSlice:d,toSlice:l};continue}if(e!==n)return{rule:o}}}s(Sr,"findDeniedEdgeDecision");async function Vt(t,e){if(e.mode==="off"||!e.architectureProfile)return;let n=t.metadata.source;if(!n||n==="unknown")return;let r=e.architectureProfile,o=r.resolveLayer(n),i=r.resolveLayer(t.intent);if(!o||!i)return;let a=Ht(r.rules,o,i);if(!a)return;let c=e.mode,d=a.message??`Observed layer violation: "${n}" (${o}) must not produce "${t.intent}" (${i}).`,l={source:n,intent:t.intent,fromLayer:o,toLayer:i,severity:c,message:d,rule:a};if(e.appendTrace({type:"layer.observedViolation",timestamp:new Date().toISOString(),intent:t.intent,correlationId:t.metadata.correlationId,traceId:t.metadata.traceId,spanId:t.metadata.spanId,details:l}),await e.recordAudit("layer.observedViolation",t,l),c==="hard")throw new J(n,t.intent,o,i,d)}s(Vt,"assertObservedLayerFlowAllowed");async function Ut(t,e){let n=e.getPolicyContext(t),r;try{r=e.policyEngine.enforce(n)}catch(o){throw o instanceof P&&(e.appendTrace({type:"policy.hardViolation",timestamp:new Date().toISOString(),intent:t.intent,correlationId:t.metadata.correlationId,traceId:t.metadata.traceId,spanId:t.metadata.spanId,details:{violations:o.violations}}),await e.recordAudit("policy.hardViolation",t,{violations:o.violations})),o}r.softViolations.length>0&&(e.appendTrace({type:"policy.softViolation",timestamp:new Date().toISOString(),intent:t.intent,correlationId:t.metadata.correlationId,traceId:t.metadata.traceId,spanId:t.metadata.spanId,details:{violations:r.softViolations}}),await e.recordAudit("policy.softViolation",t,{violations:r.softViolations}),e.onSoftViolation&&await e.safeHook(()=>e.onSoftViolation(r,t),"onSoftViolation",t))}s(Ut,"enforcePublishPolicy");function vr(t,e){t.history.push(e),t.maxHistorySize!==void 0&&t.history.length>t.maxHistorySize&&t.history.splice(0,t.history.length-t.maxHistorySize)}s(vr,"appendHistory");function Z(t,e){t.trace.push(e),t.maxHistorySize!==void 0&&t.trace.length>t.maxHistorySize&&t.trace.splice(0,t.trace.length-t.maxHistorySize);for(let n of t.traceSinks)try{n(e)}catch{}}s(Z,"appendTrace");async function pe(t,e,n,r){if(t.auditTrail)try{await t.auditTrail.record({type:e,source:n.metadata.source,intent:n.intent,correlationId:n.metadata.correlationId,causationId:n.metadata.causationId,subject:n.intent,details:r})}catch(o){Z(t,{type:"hook.error",timestamp:new Date().toISOString(),intent:n.intent,correlationId:n.metadata.correlationId,traceId:n.metadata.traceId,spanId:n.metadata.spanId,details:{hook:"auditTrail",error:o instanceof Error?o.message:String(o)}})}}s(pe,"recordAudit");async function Wt(t,e){let n={intent:e.intent,source:e.metadata.source,suggestion:"Publish through a registered intent creator so strict registry, contracts, and agent tooling share one source of truth."};Z(t,{type:"event.rawPublish",timestamp:new Date().toISOString(),intent:e.intent,correlationId:e.metadata.correlationId,traceId:e.metadata.traceId,spanId:e.metadata.spanId,details:n}),await pe(t,"event.rawPublish",e,n)}s(Wt,"recordRawPublishDiagnostic");async function qt(t,e,n,r){let o={event:e,publishedAt:new Date().toISOString(),subscribersNotified:n};return vr(t,o),await t.eventBuffer?.enqueue(e,r),Z(t,{type:"event.published",timestamp:o.publishedAt,intent:e.intent,correlationId:e.metadata.correlationId,traceId:e.metadata.traceId,spanId:e.metadata.spanId,details:{subscribersNotified:n}}),await pe(t,"event.published",e,{subscribersNotified:n}),o}s(qt,"recordSuccessfulPublish");function Be(t,e,n){return{...t,...e,occurredAt:e.occurredAt||t.occurredAt||new Date().toISOString(),source:e.source||t.source||"unknown",kernelInstanceId:e.kernelInstanceId??t.kernelInstanceId??n,eventVersion:e.eventVersion??t.eventVersion,schemaVersion:e.schemaVersion??t.schemaVersion,allowInterception:e.allowInterception??t.allowInterception,interceptions:e.interceptions??t.interceptions,correlationId:e.correlationId??t.correlationId,causationId:e.causationId??t.causationId,traceId:e.traceId??t.traceId,spanId:e.spanId??t.spanId,parentSpanId:e.parentSpanId??t.parentSpanId}}s(Be,"enrichMetadata");var zt=0;function Pr(){return zt+=1,`interceptor-${Date.now()}-${zt}`}s(Pr,"nextInterceptorRegistrationId");var Y=class{static{s(this,"EventBusImpl")}subscriptions=[];subscriptionsByIntent=new Map;interceptors=[];interceptorsByIntent=new Map;recording;onPublish;onSoftViolation;onHandlerError;eventContracts;strictEventContracts;requireKnownSource;architectureProfile;enforceObservedLayerFlowMode;rethrowHandlerErrors;policyEngine;getPolicyContext;intentRegistry;dependencyGraph;strictRegistry;validateIntentNaming;constructor(e={}){if(this.onPublish=e.onPublish,this.onSoftViolation=e.onSoftViolation,this.onHandlerError=e.onHandlerError,this.eventContracts=e.eventContracts,this.strictEventContracts=e.strictEventContracts??!1,this.requireKnownSource=e.requireKnownSource??!1,this.architectureProfile=e.architectureProfile,this.enforceObservedLayerFlowMode=e.enforceObservedLayerFlow??"off",this.rethrowHandlerErrors=e.rethrowHandlerErrors??!1,this.intentRegistry=e.intentRegistry,this.dependencyGraph=e.dependencyGraph,this.strictRegistry=e.strictRegistry??e.intentRegistry!==void 0,this.validateIntentNaming=e.validateIntentNaming??this.strictRegistry,this.recording={history:[],trace:[],maxHistorySize:e.maxHistorySize,traceSinks:[...e.traceSinks??[]],auditTrail:e.auditTrail,eventBuffer:e.eventBuffer??e.outbox,instanceId:e.instanceId},e.policyEngine?this.policyEngine=e.policyEngine:e.policies&&e.policies.length>0&&(this.policyEngine=new O(e.policies)),(this.policyEngine?.getPolicies()??e.policies??[]).some(Me)&&!e.intentRegistry&&!e.dependencyGraph&&!e.getPolicyContext)throw new q;e.getPolicyContext?this.getPolicyContext=e.getPolicyContext:e.intentRegistry||e.dependencyGraph?this.getPolicyContext=Ke({intentRegistry:e.intentRegistry,dependencyGraph:e.dependencyGraph}):this.getPolicyContext=r=>({event:r})}async publish(e,n,r,o){await this.dispatch(e,n,r,o)}async dispatch(e,n,r,o={}){let i=o.notifySubscribers!==!1,a=o.awaitHandlers!==!1,c=o.runOnPublish!==!1,d,l=typeof e!="function";if(l){let f=e,g=r??n??{};d={...f,metadata:Be(f.metadata,g,this.recording.instanceId)}}else{let f=e,g=n,h=r??{},u=f(g);d={...u,metadata:Be(u.metadata,h,this.recording.instanceId)}}l&&this.strictRegistry&&await Wt(this.recording,d),Q(d.intent,{strictRegistry:this.strictRegistry,validateIntentNaming:this.validateIntentNaming,intentRegistry:this.intentRegistry}),Nt(d,{requireKnownSource:this.requireKnownSource,intentRegistry:this.intentRegistry}),X(d,{eventContracts:this.eventContracts,strictEventContracts:this.strictEventContracts}),d=await Tt(d,{interceptorsForIntent:s(f=>this.interceptorsByIntent.get(f)??[],"interceptorsForIntent"),eventContracts:this.eventContracts,strictEventContracts:this.strictEventContracts,appendTrace:s(f=>this.appendTrace(f),"appendTrace"),recordAudit:s((f,g,h)=>this.recordAudit(f,g,h),"recordAudit")}),X(d,{eventContracts:this.eventContracts,strictEventContracts:this.strictEventContracts}),await Vt(d,{mode:this.enforceObservedLayerFlowMode,architectureProfile:this.architectureProfile,appendTrace:s(f=>this.appendTrace(f),"appendTrace"),recordAudit:s((f,g,h)=>this.recordAudit(f,g,h),"recordAudit")}),this.dependencyGraph?.registerEventFlow(d.metadata.source,d.intent);let p=[...this.subscriptionsByIntent.get(d.intent)??[]];this.policyEngine&&await Ut(d,{policyEngine:this.policyEngine,getPolicyContext:this.getPolicyContext,appendTrace:s(f=>this.appendTrace(f),"appendTrace"),recordAudit:s((f,g,h)=>this.recordAudit(f,g,h),"recordAudit"),onSoftViolation:this.onSoftViolation,safeHook:s((f,g,h)=>this.safeHook(f,g,h),"safeHook")}),await qt(this.recording,d,i?p.length:0,o.tx);let y=(async()=>{i&&await Promise.all(p.map(f=>this.invokeHandler(f,d))),c&&this.onPublish&&await this.safeHook(()=>this.onPublish(d),"onPublish",d)})();return a?await y:y.then(void 0,()=>{}),d}createPublisher(e){let n=typeof e=="string"?e:e.name;return Q(n,{strictRegistry:this.strictRegistry,validateIntentNaming:this.validateIntentNaming,intentRegistry:this.intentRegistry}),{source:n,publish:s(async(r,o,i={},a)=>{if(i.source&&i.source!==n)throw new b(n,i.source);await this.publish(r,o,{...i,source:n},a)},"publish")}}subscribe(e,n){let r=typeof e=="string"?e:e.name;Q(r,{strictRegistry:this.strictRegistry,validateIntentNaming:this.validateIntentNaming,intentRegistry:this.intentRegistry});let o={intentName:r,handler:n};this.subscriptions.push(o);let i=this.subscriptionsByIntent.get(r)??[];return i.push(o),this.subscriptionsByIntent.set(r,i),()=>{let a=this.subscriptions.indexOf(o);a>=0&&this.subscriptions.splice(a,1);let c=this.subscriptionsByIntent.get(r);if(!c)return;let d=c.indexOf(o);d>=0&&c.splice(d,1),c.length===0&&this.subscriptionsByIntent.delete(r)}}registerInterceptor(e,n,r){let o=typeof e=="string"?e:e.name;Q(o,{strictRegistry:this.strictRegistry,validateIntentNaming:this.validateIntentNaming,intentRegistry:this.intentRegistry});let i={registrationId:Pr(),interceptorId:r??o,intentName:o,interceptor:n,createdAt:new Date().toISOString()};this.interceptors.push(i);let a=this.interceptorsByIntent.get(o)??[];return a.push(i),this.interceptorsByIntent.set(o,a),i.registrationId}unregisterInterceptor(e){let n=this.interceptors.find(i=>i.registrationId===e);if(!n)return!1;let r=this.interceptors.indexOf(n);r>=0&&this.interceptors.splice(r,1);let o=this.interceptorsByIntent.get(n.intentName);if(o){let i=o.indexOf(n);i>=0&&o.splice(i,1),o.length===0&&this.interceptorsByIntent.delete(n.intentName)}return!0}listInterceptors(e){return this.interceptors.filter(n=>!e||n.intentName===e).map(n=>({registrationId:n.registrationId,interceptorId:n.interceptorId,intent:n.intentName,createdAt:n.createdAt,lastInterceptedAt:n.lastInterceptedAt}))}getHistory(){return[...this.recording.history]}clearHistory(){this.recording.history.length=0}getTrace(){return[...this.recording.trace]}clearTrace(){this.recording.trace.length=0}appendTrace(e){Z(this.recording,e)}async recordAudit(e,n,r){await pe(this.recording,e,n,r)}async invokeHandler(e,n){try{await Promise.resolve(e.handler(n))}catch(r){if(this.appendTrace({type:"handler.error",timestamp:new Date().toISOString(),intent:n.intent,correlationId:n.metadata.correlationId,traceId:n.metadata.traceId,spanId:n.metadata.spanId,details:{error:r instanceof Error?r.message:String(r)}}),await this.recordAudit("handler.error",n,{handlerIntent:e.intentName,error:r instanceof Error?r.message:String(r)}),this.onHandlerError&&await this.safeHook(()=>this.onHandlerError(r,n,e.intentName),"onHandlerError",n),this.rethrowHandlerErrors)throw r}}async safeHook(e,n,r){try{await Promise.resolve(e())}catch(o){this.appendTrace({type:"hook.error",timestamp:new Date().toISOString(),intent:r.intent,correlationId:r.metadata.correlationId,traceId:r.metadata.traceId,spanId:r.metadata.spanId,details:{hook:n,error:o instanceof Error?o.message:String(o)}}),await this.recordAudit("hook.error",r,{hook:n,error:o instanceof Error?o.message:String(o)})}}};function br(t){if(!(!t||t.length===0))return t.map(e=>typeof e=="object"&&e!==null&&"key"in e?String(e.key):String(e)).join(".")}s(br,"formatStandardSchemaPath");function xr(t){if(Array.isArray(t))return"array";if(t===null)return"object";let e=typeof t;return e==="string"||e==="number"||e==="boolean"||e==="object"?e:"unknown"}s(xr,"actualType");function Cr(t,e){return t?`${t}.${e}`:e}s(Cr,"formatPath");function Jt(t,e,n,r,o){let i=xr(t);if(e.type!=="unknown"&&i!==e.type){o.push({intent:r.intent,version:r.version,field:n,message:`Expected ${e.type}, received ${i}.`});return}if(e.enum&&!e.enum.some(a=>Object.is(a,t))&&o.push({intent:r.intent,version:r.version,field:n,message:"Value is not allowed by event contract enum."}),e.type==="object"&&e.fields){if(t===null||typeof t!="object"||Array.isArray(t)){o.push({intent:r.intent,version:r.version,field:n,message:"Nested object field must be a non-array object."});return}Qt(t,e.fields,r,o,n)}e.type==="array"&&e.items&&Array.isArray(t)&&t.forEach((a,c)=>{Jt(a,e.items,`${n}[${c}]`,r,o)})}s(Jt,"validateSchemaField");function Qt(t,e,n,r,o){for(let[i,a]of Object.entries(e)){let c=Cr(o,i),d=t[i];if(d===void 0){a.required&&r.push({intent:n.intent,version:n.version,field:c,message:"Required field is missing."});continue}Jt(d,a,c,n,r)}}s(Qt,"validateObjectSchema");var fe=class{static{s(this,"EventContractRegistryImpl")}contracts=new Map;register(e){let n=this.key(e.intent,e.version);if(this.contracts.has(n))throw new Error(`Event contract "${n}" is already registered.`);this.contracts.set(n,{allowAdditionalFields:!0,...e})}get(e,n){return n?this.contracts.get(this.key(e,n)):this.list(e).at(-1)}list(e){return Array.from(this.contracts.values()).filter(n=>!e||n.intent===e)}validate(e){let n=e.metadata.eventVersion,r=this.get(e.intent,n),o=[];if(!r)return{ok:!1,issues:[{intent:e.intent,version:n,message:n?`No event contract registered for version "${n}".`:"No event contract registered for intent."}]};r.deprecated&&o.push({intent:e.intent,version:r.version,message:typeof r.deprecated=="string"?r.deprecated:"Event contract is deprecated."});let i=e.payload!=null&&typeof e.payload=="object"?e.payload:void 0;if(r.schema){if(!i)o.push({intent:e.intent,version:r.version,message:"Payload must be an object for schema validation."});else if(Qt(i,r.schema,r,o),r.allowAdditionalFields===!1)for(let a of Object.keys(i))r.schema[a]||o.push({intent:e.intent,version:r.version,field:a,message:"Additional field is not allowed by event contract."})}if(r.standardSchema){let a=r.standardSchema["~standard"].validate(e.payload);if(a instanceof Promise)o.push({intent:e.intent,version:r.version,message:"Standard Schema validator returned a Promise; event contract validation is synchronous."});else if(a.issues)for(let c of a.issues)o.push({intent:e.intent,version:r.version,field:br(c.path),message:c.message})}return{ok:o.length===0,contract:r,issues:o}}clear(){this.contracts.clear()}key(e,n){return`${e}@${n}`}};function He(){return new fe}s(He,"createEventContractRegistry");var ge=class{static{s(this,"DependencyGraphImpl")}nodes=new Map;edges=[];registerDependency(e,n,r="declared"){this.ensureNode(e),this.ensureNode(n),this.addEdge({from:e,to:n,kind:r})}registerEventFlow(e,n){this.ensureNode(e),this.ensureNode(n),this.addEdge({from:e,to:n,kind:"observed"})}getNodes(){return Array.from(this.nodes.values())}getEdges(){return[...this.edges]}toJSON(){return{nodes:this.getNodes(),edges:this.getEdges()}}toMermaid(){let e=`flowchart TD
|
|
7
|
+
${n}`),this.name="PolicyViolationError",this.violations=e}};var L=class{static{s(this,"PolicyEngine")}policies=[];constructor(e=[]){for(let n of e)this.add(n)}add(e){if(this.policies.some(n=>n.name===e.name))throw new Error(`Policy "${e.name}" is already registered in this engine.`);this.policies.push(e)}getPolicies(){return[...this.policies]}evaluate(e){let n=[];for(let i of this.policies){let a=i.check(e);if(a!==!0){if(a===!1){n.push({policyName:i.name,severity:i.severity,message:`Policy "${i.name}" was violated.`});continue}if(Array.isArray(a))for(let c of a)n.push({policyName:i.name,severity:i.severity,message:c.message,details:c.details});else n.push({policyName:i.name,severity:i.severity,message:a.message,details:a.details})}}let r=n.filter(i=>i.severity==="hard"),o=n.filter(i=>i.severity==="soft");return{passed:n.length===0,violations:n,hardViolations:r,softViolations:o}}enforce(e){let n=this.evaluate(e);if(n.hardViolations.length>0)throw new O(n.hardViolations);return n}clear(){this.policies.length=0}};function Ie(t){let e=t.severity??"soft";return{name:t.name,severity:e,tags:t.tags,owner:t.owner,version:t.version,rationale:t.rationale,enforcementMode:t.enforcementMode,deprecated:t.deprecated,replacedBy:t.replacedBy,check:t.check}}s(Ie,"definePolicy");function Lr(t){let e=t.indexOf(".");return e>=0?t.slice(0,e):t}s(Lr,"defaultLayerOf");function Bt(t,e){return e.resolveLayer?.(t)??Lr(t)}s(Bt,"resolveLayer");function $r(t,e,n){return t===n.from&&e===n.to}s($r,"matchesRule");function Ht(t){let e=t.name??"Layer isolation",n=t.severity??"hard";return Ie({name:e,severity:n,tags:["layer"],check:s(r=>{let o=[...(r.edges??[]).filter(a=>a.kind==="declared"||a.kind==="produces").map(a=>({from:a.from,to:a.to})),...(r.relationships??[]).filter(a=>a.kind==="dependsOn").map(a=>({from:a.from,to:a.to}))],i=[];for(let a of o){let c=Bt(a.from,t),d=Bt(a.to,t);for(let u of t.rules)!u.allowed&&$r(c,d,u)&&i.push({policyName:e,severity:n,message:u.message??`Layer violation: ${a.from} (${c}) must not relate to ${a.to} (${d})`})}return i.length>0?i:!0},"check")})}s(Ht,"defineLayerPolicy");function Qe(t){return t.tags?.includes("layer")??!1}s(Qe,"isLayerPolicy");function Xe(t,e={}){return Ht({name:e.name??`${t.name} layer policy`,severity:e.severity??"hard",rules:t.rules,resolveLayer:t.resolveLayer})}s(Xe,"defineArchitectureProfilePolicy");function Ze(t){return e=>({event:e,relationships:t.intentRegistry?.getAllRelationships(),edges:t.dependencyGraph?.getEdges()})}s(Ze,"buildPublishPolicyContext");var te=class extends Error{static{s(this,"UnregisteredIntentError")}intentName;constructor(e){super(`Intent "${e}" is not registered. Register it with IntentRegistry.define() before publish/subscribe, including metadata.source producer intents in strict mode.`),this.name="UnregisteredIntentError",this.intentName=e}},ne=class extends Error{static{s(this,"InvalidIntentNameError")}intentName;reason;constructor(e,n){super(`Invalid intent name "${e}": ${n}`),this.name="InvalidIntentNameError",this.intentName=e,this.reason=n}},re=class extends Error{static{s(this,"LayerPolicyContextError")}constructor(){super("Layer/architecture policies require intentRegistry, dependencyGraph, or a custom getPolicyContext. Without graph/registry context, layer policies cannot inspect relationships."),this.name="LayerPolicyContextError"}},oe=class extends Error{static{s(this,"EventContractViolationError")}intentName;issues;constructor(e,n){super(`Event contract violation for "${e}". Register a matching event contract/version or fix the payload before publishing.`),this.name="EventContractViolationError",this.intentName=e,this.issues=n}},$=class extends Error{static{s(this,"UnknownEventSourceError")}intentName;source;constructor(e,n){super(n?`Event "${e}" metadata.source "${n}" is not registered. Register the producer intent or publish from a known source.`:`Event "${e}" must include metadata.source. Strict Ark uses source to enforce observed layer flow.`),this.name="UnknownEventSourceError",this.intentName=e,this.source=n}},N=class extends Error{static{s(this,"SourceMetadataOverrideError")}boundSource;attemptedSource;constructor(e,n){super(`Source-bound publisher for "${e}" cannot publish with metadata.source "${n}". Create a publisher for the intended source instead.`),this.name="SourceMetadataOverrideError",this.boundSource=e,this.attemptedSource=n}},ie=class extends Error{static{s(this,"ObservedLayerFlowViolationError")}source;intentName;fromLayer;toLayer;constructor(e,n,r,o,i){super(i??`Observed layer violation: "${e}" (${r}) must not produce "${n}" (${o}). Route this through an allowed layer or adjust the architecture profile rule.`),this.name="ObservedLayerFlowViolationError",this.source=e,this.intentName=n,this.fromLayer=r,this.toLayer=o}};var Vt=["Domain.","Application.","Adapter.","Workflow.","Job.","Presentation.","Reporting.","Metadata.","Security.","Audit.","Observability.","Kernel."];function Ye(t){if(!t||typeof t!="string")return{valid:!1,reason:"Intent name must be a non-empty string"};if(!Vt.some(n=>t.startsWith(n)))return{valid:!1,reason:`Intent "${t}" must start with one of: ${Vt.join(", ")}`};let e=t.slice(t.indexOf(".")+1);return!e||!/^[A-Za-z][A-Za-z0-9_.]*$/.test(e)?{valid:!1,reason:`Intent "${t}" has an invalid segment after the layer prefix`}:{valid:!0}}s(Ye,"validateIntentName");function se(t,e){if(!(!e.strictRegistry&&!e.validateIntentNaming)){if(e.validateIntentNaming){let n=Ye(t);if(!n.valid)throw new ne(t,n.reason)}if(e.strictRegistry&&e.intentRegistry&&!e.intentRegistry.has(t))throw new te(t)}}s(se,"assertIntentAllowed");function Ut(t,e){if(e.requireKnownSource){if(!t.metadata.source||t.metadata.source==="unknown")throw new $(t.intent);if(e.intentRegistry&&!e.intentRegistry.has(t.metadata.source))throw new $(t.intent,t.metadata.source)}}s(Ut,"assertSourceAllowed");function ae(t,e){if(!e.eventContracts)return;let n=e.eventContracts.validate(t);if(!n.ok&&(e.strictEventContracts||n.contract))throw new oe(t.intent,n.issues)}s(ae,"assertContractAllowed");function K(t){if(typeof t!="object"||t===null||Array.isArray(t))return!1;let e=Object.getPrototypeOf(t);return e===Object.prototype||e===null}s(K,"isPlainRecord");function G(t){return Array.isArray(t)?t.map(G):K(t)?Object.fromEntries(Object.entries(t).map(([e,n])=>[e,G(n)])):t}s(G,"clonePatchValue");function et(t,e,n="payload"){let r={...t};for(let[o,i]of Object.entries(e)){let a=`${n}.${o}`;if(!(o in r)||r[o]===void 0){r[o]=G(i);continue}if(K(r[o])&&K(i)){r[o]=et(r[o],i,a);continue}if(Array.isArray(r[o])&&Array.isArray(i)){r[o]=tt(r[o],i,a);continue}throw new Error(`Interceptor patch cannot overwrite existing ${a}.`)}return r}s(et,"mergeRecordPatch");function tt(t,e,n="payload"){let r=[...t];return e.forEach((o,i)=>{let a=`${n}[${i}]`;if(i>=r.length||r[i]===void 0){r[i]=G(o);return}if(K(r[i])&&K(o)){r[i]=et(r[i],o,a);return}if(Array.isArray(r[i])&&Array.isArray(o)){r[i]=tt(r[i],o,a);return}throw new Error(`Interceptor patch cannot overwrite existing ${a}.`)}),r}s(tt,"mergeArrayPatch");function Wt(t,e){if(Array.isArray(e)){if(t===void 0)return G(e);if(!Array.isArray(t))throw new Error("Array interceptor patch requires an array payload.");return tt(t,e)}if(t===void 0)return G(e);if(!K(t))throw new Error("Object interceptor patch requires an object payload.");return et(t,e)}s(Wt,"applyPayloadPatch");async function qt(t,e){if(t.metadata.allowInterception===!1)return t;let n=[...e.interceptorsForIntent(t.intent)],r=t;for(let o of n){let i=[];try{if(await Promise.resolve(o.interceptor({event:r,intercept:s(d=>{i.push(d)},"intercept")})),i.length===0)continue;let a=new Date().toISOString(),c={...r,metadata:{...r.metadata,interceptions:[...r.metadata.interceptions??[],{interceptorId:o.interceptorId,timestamp:a}]}};for(let d of i)c={...c,payload:Wt(c.payload,d),metadata:{...c.metadata}};ae(c,{eventContracts:e.eventContracts,strictEventContracts:e.strictEventContracts}),r=c,o.lastInterceptedAt=a,e.appendTrace({type:"event.intercepted",timestamp:a,intent:r.intent,correlationId:r.metadata.correlationId,traceId:r.metadata.traceId,spanId:r.metadata.spanId,details:{registrationId:o.registrationId,interceptorId:o.interceptorId,patchesApplied:i.length}}),await e.recordAudit("event.intercepted",r,{registrationId:o.registrationId,interceptorId:o.interceptorId,patchesApplied:i.length})}catch(a){await Kr(o,r,a,e)}}return r}s(qt,"applyInterceptors");async function Kr(t,e,n,r){let o=n instanceof Error?n.message:String(n);r.appendTrace({type:"interceptor.error",timestamp:new Date().toISOString(),intent:e.intent,correlationId:e.metadata.correlationId,traceId:e.metadata.traceId,spanId:e.metadata.spanId,details:{registrationId:t.registrationId,interceptorId:t.interceptorId,error:o}}),await r.recordAudit("interceptor.error",e,{registrationId:t.registrationId,interceptorId:t.interceptorId,error:o})}s(Kr,"recordInterceptorError");var zt=new Map;function Jt(t){return/[.*+?^${}()|[\]\\]/.test(t)?`\\${t}`:t}s(Jt,"escapeLiteral");function tn(t){let e="";for(let n=0;n<t.length;n+=1){let r=t[n];if(r==="\\"&&n+1<t.length){let o=t[n+1];if("*?{}[],".includes(o)||o==="\\"){e+="\\"+o,n+=1;continue}e+="/";continue}e+=r}return e}s(tn,"normalizeGlobSeparators");function Gr(t){let e=0;for(let n=0;n<t.length;n+=1){let r=t[n];if(r==="\\"){n+=1;continue}if(r==="{")e+=1;else if(r==="}"&&(e-=1,e<0))return!1}return e===0}s(Gr,"bracesBalanced");function Qt(t){let e=zt.get(t);if(e)return e;let n=tn(t),r=Gr(n),o="",i=0;for(let c=0;c<n.length;c+=1){let d=n[c];d==="\\"&&c+1<n.length?(o+=Jt(n[c+1]),c+=1):d==="*"?n[c+1]==="*"?n[c+2]==="/"?(o+="(?:.*/)?",c+=2):(o+=".*",c+=1):o+="[^/]*":d==="?"?o+="[^/]":d==="{"&&r?(o+="(?:",i+=1):d==="}"&&r&&i>0?(o+=")",i-=1):d===","&&r&&i>0?o+="|":o+=Jt(d)}let a=new RegExp(`^${o}$`);return zt.set(t,a),a}s(Qt,"globToRegExp");function Xt(t,e){if(!e?.length)return;let n=String(t).split(/[/\\]/).filter(Boolean),r=new Set(e.map(o=>String(o).toLowerCase()));for(let o=0;o<n.length-1;o+=1)if(r.has(n[o].toLowerCase()))return`${n[o].toLowerCase()}/${n[o+1].toLowerCase()}`}s(Xt,"sliceIdForPath");function Fr(t){let e=new Set;for(let n of t??[]){let o=tn(String(n)).split("/").filter(Boolean);for(let i=0;i<o.length;i+=1){let a=o[i];if((a==="**"||a==="*")&&i>0){let c=o[i-1];c&&!c.includes("*")&&!c.includes("{")&&!c.includes("}")&&e.add(c)}}}return[...e]}s(Fr,"inferSliceFoldersFromPatterns");function jr(t,e,n){if(Array.isArray(t.sliceFolders)&&t.sliceFolders.length>0)return t.sliceFolders.filter(o=>typeof o=="string"&&o.length>0);let r=(n??[]).find(o=>o.name===e);return Fr(r?.patterns)}s(jr,"resolveSliceFolders");function Zt(t){return String(t).split(/[/\\]/).filter(e=>!!e&&e!==".").map(e=>e.toLowerCase())}s(Zt,"normalizeSegments");function nn(t){let e=t.length;for(;e>0&&t[e-1]==="/";)e-=1;return t.slice(0,e)}s(nn,"trimTrailingSlashes");var Br=["src","app"];function Hr(t){let e=nn(t.replace(/^[./]+/,""));return e==="*"||e==="**"}s(Hr,"isBlanketRoot");function Yt(t,e){if(!t||!e?.length)return!1;let n=String(t).split(/[/\\]/).join("/"),r=n.toLowerCase(),o=Zt(n);for(let i of e){if(typeof i!="string"||i.length===0||Hr(i))continue;if(i.includes("*")){let d=nn(i.toLowerCase());if(Qt(d).test(r)||Qt(`${d}/**`).test(r))return!0;continue}let a=Zt(i);if(a.length===0)continue;let c=Br.includes(o[0])&&a[0]!==o[0]?[0,1]:[0];for(let d of c){if(d+a.length>o.length)continue;let u=!0;for(let l=0;l<a.length;l+=1)if(o[d+l]!==a[l]){u=!1;break}if(u)return!0}}return!1}s(Yt,"pathUnderSharedRoot");function en(t,e){let n=String(t).split(/[/\\]/).filter(Boolean).join("/").toLowerCase();if(!n)return!1;let r=e.toLowerCase();return n===r?!0:!n.includes("/")&&r.endsWith(`/${n}`)}s(en,"sliceMatchesDeclaration");function Vr(t,e,n){return!t?.length||!e||!n?!1:t.some(r=>r&&typeof r.from=="string"&&typeof r.to=="string"&&en(r.from,e)&&en(r.to,n))}s(Vr,"crossSliceEdgeAllowed");function Ur(t){if(!t.fromPath||!t.toPath)return{denied:!0,reason:"missing-path"};if(t.folderCount<=0)return{denied:!0,reason:"no-slice-folders"};let e=!!t.fromSlice||t.fromShared===!0,n=!!t.toSlice||t.toShared===!0;return!e||!n?{denied:!0,reason:"unclassifiable-path"}:!t.fromSlice||!t.toSlice?{denied:!1}:t.fromSlice===t.toSlice?{denied:!1}:t.crossSliceAllowed?{denied:!1}:{denied:!0,reason:"cross-slice"}}s(Ur,"peerIsolationDecision");function rn(t,e,n,r){return Wr(t,e,n,r)?.rule}s(rn,"findDeniedEdgeRule");function Wr(t,e,n,r){for(let o of t??[])if(!(o.from!==e||o.to!==n)&&o.allowed===!1){if(o.peerIsolation){let i=r?.fromPath,a=r?.toPath,c=jr(o,e,r?.layers),d=i&&a?Xt(i,c):void 0,u=i&&a?Xt(a,c):void 0,l=Ur({fromPath:i,toPath:a,folderCount:c.length,fromSlice:d,toSlice:u,fromShared:!d&&Yt(i,o.sharedRoots),toShared:!u&&Yt(a,o.sharedRoots),crossSliceAllowed:Vr(o.allowedCrossSlice,d,u)});if(l.denied)return{rule:o,peerIsolationReason:l.reason,fromSlice:d,toSlice:u};continue}if(e!==n)return{rule:o}}}s(Wr,"findDeniedEdgeDecision");async function on(t,e){if(e.mode==="off"||!e.architectureProfile)return;let n=t.metadata.source;if(!n||n==="unknown")return;let r=e.architectureProfile,o=r.resolveLayer(n),i=r.resolveLayer(t.intent);if(!o||!i)return;let a=rn(r.rules,o,i);if(!a)return;let c=e.mode,d=a.message??`Observed layer violation: "${n}" (${o}) must not produce "${t.intent}" (${i}).`,u={source:n,intent:t.intent,fromLayer:o,toLayer:i,severity:c,message:d,rule:a};if(e.appendTrace({type:"layer.observedViolation",timestamp:new Date().toISOString(),intent:t.intent,correlationId:t.metadata.correlationId,traceId:t.metadata.traceId,spanId:t.metadata.spanId,details:u}),await e.recordAudit("layer.observedViolation",t,u),c==="hard")throw new ie(n,t.intent,o,i,d)}s(on,"assertObservedLayerFlowAllowed");async function sn(t,e){let n=e.getPolicyContext(t),r;try{r=e.policyEngine.enforce(n)}catch(o){throw o instanceof O&&(e.appendTrace({type:"policy.hardViolation",timestamp:new Date().toISOString(),intent:t.intent,correlationId:t.metadata.correlationId,traceId:t.metadata.traceId,spanId:t.metadata.spanId,details:{violations:o.violations}}),await e.recordAudit("policy.hardViolation",t,{violations:o.violations})),o}r.softViolations.length>0&&(e.appendTrace({type:"policy.softViolation",timestamp:new Date().toISOString(),intent:t.intent,correlationId:t.metadata.correlationId,traceId:t.metadata.traceId,spanId:t.metadata.spanId,details:{violations:r.softViolations}}),await e.recordAudit("policy.softViolation",t,{violations:r.softViolations}),e.onSoftViolation&&await e.safeHook(()=>e.onSoftViolation(r,t),"onSoftViolation",t))}s(sn,"enforcePublishPolicy");function qr(t,e){t.history.push(e),t.maxHistorySize!==void 0&&t.history.length>t.maxHistorySize&&t.history.splice(0,t.history.length-t.maxHistorySize)}s(qr,"appendHistory");function ce(t,e){t.trace.push(e),t.maxHistorySize!==void 0&&t.trace.length>t.maxHistorySize&&t.trace.splice(0,t.trace.length-t.maxHistorySize);for(let n of t.traceSinks)try{n(e)}catch{}}s(ce,"appendTrace");async function be(t,e,n,r){if(t.auditTrail)try{await t.auditTrail.record({type:e,source:n.metadata.source,intent:n.intent,correlationId:n.metadata.correlationId,causationId:n.metadata.causationId,subject:n.intent,details:r})}catch(o){ce(t,{type:"hook.error",timestamp:new Date().toISOString(),intent:n.intent,correlationId:n.metadata.correlationId,traceId:n.metadata.traceId,spanId:n.metadata.spanId,details:{hook:"auditTrail",error:o instanceof Error?o.message:String(o)}})}}s(be,"recordAudit");async function an(t,e){let n={intent:e.intent,source:e.metadata.source,suggestion:"Publish through a registered intent creator so strict registry, contracts, and agent tooling share one source of truth."};ce(t,{type:"event.rawPublish",timestamp:new Date().toISOString(),intent:e.intent,correlationId:e.metadata.correlationId,traceId:e.metadata.traceId,spanId:e.metadata.spanId,details:n}),await be(t,"event.rawPublish",e,n)}s(an,"recordRawPublishDiagnostic");async function cn(t,e,n,r){let o={event:e,publishedAt:new Date().toISOString(),subscribersNotified:n};return qr(t,o),await t.eventBuffer?.enqueue(e,r),ce(t,{type:"event.published",timestamp:o.publishedAt,intent:e.intent,correlationId:e.metadata.correlationId,traceId:e.metadata.traceId,spanId:e.metadata.spanId,details:{subscribersNotified:n}}),await be(t,"event.published",e,{subscribersNotified:n}),o}s(cn,"recordSuccessfulPublish");function nt(t,e,n){return{...t,...e,occurredAt:e.occurredAt||t.occurredAt||new Date().toISOString(),source:e.source||t.source||"unknown",kernelInstanceId:e.kernelInstanceId??t.kernelInstanceId??n,eventVersion:e.eventVersion??t.eventVersion,schemaVersion:e.schemaVersion??t.schemaVersion,allowInterception:e.allowInterception??t.allowInterception,interceptions:e.interceptions??t.interceptions,correlationId:e.correlationId??t.correlationId,causationId:e.causationId??t.causationId,traceId:e.traceId??t.traceId,spanId:e.spanId??t.spanId,parentSpanId:e.parentSpanId??t.parentSpanId}}s(nt,"enrichMetadata");var dn=0;function zr(){return dn+=1,`interceptor-${Date.now()}-${dn}`}s(zr,"nextInterceptorRegistrationId");var de=class{static{s(this,"EventBusImpl")}subscriptions=[];subscriptionsByIntent=new Map;interceptors=[];interceptorsByIntent=new Map;recording;onPublish;onSoftViolation;onHandlerError;eventContracts;strictEventContracts;requireKnownSource;architectureProfile;enforceObservedLayerFlowMode;rethrowHandlerErrors;policyEngine;getPolicyContext;intentRegistry;dependencyGraph;strictRegistry;validateIntentNaming;constructor(e={}){if(this.onPublish=e.onPublish,this.onSoftViolation=e.onSoftViolation,this.onHandlerError=e.onHandlerError,this.eventContracts=e.eventContracts,this.strictEventContracts=e.strictEventContracts??!1,this.requireKnownSource=e.requireKnownSource??!1,this.architectureProfile=e.architectureProfile,this.enforceObservedLayerFlowMode=e.enforceObservedLayerFlow??"off",this.rethrowHandlerErrors=e.rethrowHandlerErrors??!1,this.intentRegistry=e.intentRegistry,this.dependencyGraph=e.dependencyGraph,this.strictRegistry=e.strictRegistry??e.intentRegistry!==void 0,this.validateIntentNaming=e.validateIntentNaming??this.strictRegistry,this.recording={history:[],trace:[],maxHistorySize:e.maxHistorySize,traceSinks:[...e.traceSinks??[]],auditTrail:e.auditTrail,eventBuffer:e.eventBuffer??e.outbox,instanceId:e.instanceId},e.policyEngine?this.policyEngine=e.policyEngine:e.policies&&e.policies.length>0&&(this.policyEngine=new L(e.policies)),(this.policyEngine?.getPolicies()??e.policies??[]).some(Qe)&&!e.intentRegistry&&!e.dependencyGraph&&!e.getPolicyContext)throw new re;e.getPolicyContext?this.getPolicyContext=e.getPolicyContext:e.intentRegistry||e.dependencyGraph?this.getPolicyContext=Ze({intentRegistry:e.intentRegistry,dependencyGraph:e.dependencyGraph}):this.getPolicyContext=r=>({event:r})}async publish(e,n,r,o){await this.dispatch(e,n,r,o)}async dispatch(e,n,r,o={}){let i=o.notifySubscribers!==!1,a=o.awaitHandlers!==!1,c=o.runOnPublish!==!1,d,u=typeof e!="function";if(u){let f=e,m=r??n??{};d={...f,metadata:nt(f.metadata,m,this.recording.instanceId)}}else{let f=e,m=n,h=r??{},p=f(m);d={...p,metadata:nt(p.metadata,h,this.recording.instanceId)}}u&&this.strictRegistry&&await an(this.recording,d),se(d.intent,{strictRegistry:this.strictRegistry,validateIntentNaming:this.validateIntentNaming,intentRegistry:this.intentRegistry}),Ut(d,{requireKnownSource:this.requireKnownSource,intentRegistry:this.intentRegistry}),ae(d,{eventContracts:this.eventContracts,strictEventContracts:this.strictEventContracts}),d=await qt(d,{interceptorsForIntent:s(f=>this.interceptorsByIntent.get(f)??[],"interceptorsForIntent"),eventContracts:this.eventContracts,strictEventContracts:this.strictEventContracts,appendTrace:s(f=>this.appendTrace(f),"appendTrace"),recordAudit:s((f,m,h)=>this.recordAudit(f,m,h),"recordAudit")}),ae(d,{eventContracts:this.eventContracts,strictEventContracts:this.strictEventContracts}),await on(d,{mode:this.enforceObservedLayerFlowMode,architectureProfile:this.architectureProfile,appendTrace:s(f=>this.appendTrace(f),"appendTrace"),recordAudit:s((f,m,h)=>this.recordAudit(f,m,h),"recordAudit")}),this.dependencyGraph?.registerEventFlow(d.metadata.source,d.intent);let l=[...this.subscriptionsByIntent.get(d.intent)??[]];this.policyEngine&&await sn(d,{policyEngine:this.policyEngine,getPolicyContext:this.getPolicyContext,appendTrace:s(f=>this.appendTrace(f),"appendTrace"),recordAudit:s((f,m,h)=>this.recordAudit(f,m,h),"recordAudit"),onSoftViolation:this.onSoftViolation,safeHook:s((f,m,h)=>this.safeHook(f,m,h),"safeHook")}),await cn(this.recording,d,i?l.length:0,o.tx);let y=(async()=>{i&&await Promise.all(l.map(f=>this.invokeHandler(f,d))),c&&this.onPublish&&await this.safeHook(()=>this.onPublish(d),"onPublish",d)})();return a?await y:y.then(void 0,()=>{}),d}createPublisher(e){let n=typeof e=="string"?e:e.name;return se(n,{strictRegistry:this.strictRegistry,validateIntentNaming:this.validateIntentNaming,intentRegistry:this.intentRegistry}),{source:n,publish:s(async(r,o,i={},a)=>{if(i.source&&i.source!==n)throw new N(n,i.source);await this.publish(r,o,{...i,source:n},a)},"publish")}}subscribe(e,n){let r=typeof e=="string"?e:e.name;se(r,{strictRegistry:this.strictRegistry,validateIntentNaming:this.validateIntentNaming,intentRegistry:this.intentRegistry});let o={intentName:r,handler:n};this.subscriptions.push(o);let i=this.subscriptionsByIntent.get(r)??[];return i.push(o),this.subscriptionsByIntent.set(r,i),()=>{let a=this.subscriptions.indexOf(o);a>=0&&this.subscriptions.splice(a,1);let c=this.subscriptionsByIntent.get(r);if(!c)return;let d=c.indexOf(o);d>=0&&c.splice(d,1),c.length===0&&this.subscriptionsByIntent.delete(r)}}registerInterceptor(e,n,r){let o=typeof e=="string"?e:e.name;se(o,{strictRegistry:this.strictRegistry,validateIntentNaming:this.validateIntentNaming,intentRegistry:this.intentRegistry});let i={registrationId:zr(),interceptorId:r??o,intentName:o,interceptor:n,createdAt:new Date().toISOString()};this.interceptors.push(i);let a=this.interceptorsByIntent.get(o)??[];return a.push(i),this.interceptorsByIntent.set(o,a),i.registrationId}unregisterInterceptor(e){let n=this.interceptors.find(i=>i.registrationId===e);if(!n)return!1;let r=this.interceptors.indexOf(n);r>=0&&this.interceptors.splice(r,1);let o=this.interceptorsByIntent.get(n.intentName);if(o){let i=o.indexOf(n);i>=0&&o.splice(i,1),o.length===0&&this.interceptorsByIntent.delete(n.intentName)}return!0}listInterceptors(e){return this.interceptors.filter(n=>!e||n.intentName===e).map(n=>({registrationId:n.registrationId,interceptorId:n.interceptorId,intent:n.intentName,createdAt:n.createdAt,lastInterceptedAt:n.lastInterceptedAt}))}getHistory(){return[...this.recording.history]}clearHistory(){this.recording.history.length=0}getTrace(){return[...this.recording.trace]}clearTrace(){this.recording.trace.length=0}appendTrace(e){ce(this.recording,e)}async recordAudit(e,n,r){await be(this.recording,e,n,r)}async invokeHandler(e,n){try{await Promise.resolve(e.handler(n))}catch(r){if(this.appendTrace({type:"handler.error",timestamp:new Date().toISOString(),intent:n.intent,correlationId:n.metadata.correlationId,traceId:n.metadata.traceId,spanId:n.metadata.spanId,details:{error:r instanceof Error?r.message:String(r)}}),await this.recordAudit("handler.error",n,{handlerIntent:e.intentName,error:r instanceof Error?r.message:String(r)}),this.onHandlerError&&await this.safeHook(()=>this.onHandlerError(r,n,e.intentName),"onHandlerError",n),this.rethrowHandlerErrors)throw r}}async safeHook(e,n,r){try{await Promise.resolve(e())}catch(o){this.appendTrace({type:"hook.error",timestamp:new Date().toISOString(),intent:r.intent,correlationId:r.metadata.correlationId,traceId:r.metadata.traceId,spanId:r.metadata.spanId,details:{hook:n,error:o instanceof Error?o.message:String(o)}}),await this.recordAudit("hook.error",r,{hook:n,error:o instanceof Error?o.message:String(o)})}}};function Jr(t){if(!(!t||t.length===0))return t.map(e=>typeof e=="object"&&e!==null&&"key"in e?String(e.key):String(e)).join(".")}s(Jr,"formatStandardSchemaPath");function Qr(t){if(Array.isArray(t))return"array";if(t===null)return"object";let e=typeof t;return e==="string"||e==="number"||e==="boolean"||e==="object"?e:"unknown"}s(Qr,"actualType");function Xr(t,e){return t?`${t}.${e}`:e}s(Xr,"formatPath");function un(t,e,n,r,o){let i=Qr(t);if(e.type!=="unknown"&&i!==e.type){o.push({intent:r.intent,version:r.version,field:n,message:`Expected ${e.type}, received ${i}.`});return}if(e.enum&&!e.enum.some(a=>Object.is(a,t))&&o.push({intent:r.intent,version:r.version,field:n,message:"Value is not allowed by event contract enum."}),e.type==="object"&&e.fields){if(t===null||typeof t!="object"||Array.isArray(t)){o.push({intent:r.intent,version:r.version,field:n,message:"Nested object field must be a non-array object."});return}ln(t,e.fields,r,o,n)}e.type==="array"&&e.items&&Array.isArray(t)&&t.forEach((a,c)=>{un(a,e.items,`${n}[${c}]`,r,o)})}s(un,"validateSchemaField");function ln(t,e,n,r,o){for(let[i,a]of Object.entries(e)){let c=Xr(o,i),d=t[i];if(d===void 0){a.required&&r.push({intent:n.intent,version:n.version,field:c,message:"Required field is missing."});continue}un(d,a,c,n,r)}}s(ln,"validateObjectSchema");var Se=class{static{s(this,"EventContractRegistryImpl")}contracts=new Map;register(e){let n=this.key(e.intent,e.version);if(this.contracts.has(n))throw new Error(`Event contract "${n}" is already registered.`);this.contracts.set(n,{allowAdditionalFields:!0,...e})}get(e,n){return n?this.contracts.get(this.key(e,n)):this.list(e).at(-1)}list(e){return Array.from(this.contracts.values()).filter(n=>!e||n.intent===e)}validate(e){let n=e.metadata.eventVersion,r=this.get(e.intent,n),o=[];if(!r)return{ok:!1,issues:[{intent:e.intent,version:n,message:n?`No event contract registered for version "${n}".`:"No event contract registered for intent."}]};r.deprecated&&o.push({intent:e.intent,version:r.version,message:typeof r.deprecated=="string"?r.deprecated:"Event contract is deprecated."});let i=e.payload!=null&&typeof e.payload=="object"?e.payload:void 0;if(r.schema){if(!i)o.push({intent:e.intent,version:r.version,message:"Payload must be an object for schema validation."});else if(ln(i,r.schema,r,o),r.allowAdditionalFields===!1)for(let a of Object.keys(i))r.schema[a]||o.push({intent:e.intent,version:r.version,field:a,message:"Additional field is not allowed by event contract."})}if(r.standardSchema){let a=r.standardSchema["~standard"].validate(e.payload);if(a instanceof Promise)o.push({intent:e.intent,version:r.version,message:"Standard Schema validator returned a Promise; event contract validation is synchronous."});else if(a.issues)for(let c of a.issues)o.push({intent:e.intent,version:r.version,field:Jr(c.path),message:c.message})}return{ok:o.length===0,contract:r,issues:o}}clear(){this.contracts.clear()}key(e,n){return`${e}@${n}`}};function rt(){return new Se}s(rt,"createEventContractRegistry");var Ee=class{static{s(this,"DependencyGraphImpl")}nodes=new Map;edges=[];registerDependency(e,n,r="declared"){this.ensureNode(e),this.ensureNode(n),this.addEdge({from:e,to:n,kind:r})}registerEventFlow(e,n){this.ensureNode(e),this.ensureNode(n),this.addEdge({from:e,to:n,kind:"observed"})}getNodes(){return Array.from(this.nodes.values())}getEdges(){return[...this.edges]}toJSON(){return{nodes:this.getNodes(),edges:this.getEdges()}}toMermaid(){let e=`flowchart TD
|
|
8
8
|
`;for(let r of this.edges){let o=r.kind?`|${r.kind}|`:"";e+=` ${this.safeId(r.from)} -->${o} ${this.safeId(r.to)}
|
|
9
9
|
`}let n=new Set(this.edges.flatMap(r=>[r.from,r.to]));for(let r of this.nodes.keys())n.has(r)||(e+=` ${this.safeId(r)}
|
|
10
10
|
`);return e.trim()}toLayerMermaid(e){let n=new Map;for(let i of this.nodes.keys()){let a=e.resolveLayer(i)??"Unclassified",c=n.get(a)??[];c.push(i),n.set(a,c)}let r=`flowchart TD
|
|
@@ -15,4 +15,4 @@ ${n}`),this.name="PolicyViolationError",this.violations=e}};var O=class{static{s
|
|
|
15
15
|
`;for(let i of o)r+=` ${this.safeId(i)}[${i}]
|
|
16
16
|
`;r+=` end
|
|
17
17
|
`}for(let i of this.edges){let a=i.kind?`|${i.kind}|`:"";r+=` ${this.safeId(i.from)} -->${a} ${this.safeId(i.to)}
|
|
18
|
-
`}return r.trim()}detectViolations(e=[]){let n=[],r=this.findSimpleCycles();r.length>0&&n.push(`Cycle detected: ${r.map(o=>o.join("->")).join(", ")}`);for(let o of e)try{let i=o(this.edges);i&&i.length&&n.push(...i)}catch(i){n.push(`Rule error: ${i.message}`)}return n}ensureNode(e){this.nodes.has(e)||this.nodes.set(e,{id:e})}addEdge(e){this.edges.some(r=>r.from===e.from&&r.to===e.to&&r.kind===e.kind)||this.edges.push(e)}findSimpleCycles(){let e=new Map;for(let c of this.edges)e.has(c.from)||e.set(c.from,[]),e.get(c.from).push(c.to);let n=[],r=new Set,o=[],i=s(c=>{r.add(c),o.push(c);for(let d of e.get(c)||[])if(!r.has(d))i(d);else if(o.includes(d)){let l=o.indexOf(d),p=o.slice(l).concat(d);n.push(p)}o.pop()},"dfs");for(let c of e.keys())r.has(c)||i(c);let a=new Set(n.map(c=>c.join("->")));return Array.from(a).map(c=>c.split("->"))}safeId(e){return e.replace(/[^a-zA-Z0-9_]/g,"_")}};function Ve(){return new ge}s(Ve,"createDependencyGraph");function Ue(t,e,n={}){let r=n.requireRegisteredTargets??!1;for(let o of t.getAllRelationships())r&&!t.has(o.to)||(o.kind==="dependsOn"?e.registerDependency(o.from,o.to,"declared"):e.registerDependency(o.from,o.to,"produces"))}s(Ue,"syncRegistryToGraph");var ee=class{static{s(this,"IntentRegistry")}intents=new Map;dependencies=new Map;productions=new Map;define(e,n){if(this.intents.has(e))throw new Error(`Intent "${e}" is already registered. Intent names must be unique within a registry.`);let r=s(i=>({intent:e,payload:i,metadata:{occurredAt:new Date().toISOString(),source:"unknown"}}),"fn");Object.defineProperty(r,"name",{value:e,enumerable:!0,configurable:!1,writable:!1});let o=r;if(this.intents.set(e,o),n?.dependsOn)for(let i of n.dependsOn)this.declareDependency(e,i);if(n?.produces)for(let i of n.produces)this.declareProduction(e,i);return o}declareDependency(e,n){this.dependencies.has(e)||this.dependencies.set(e,new Set),this.dependencies.get(e).add(n)}declareProduction(e,n){this.productions.has(e)||this.productions.set(e,new Set),this.productions.get(e).add(n)}get(e){return this.intents.get(e)}list(){return Array.from(this.intents.values())}getDependencies(e){let n=this.dependencies.get(e);return n?Array.from(n):[]}getProductions(e){let n=this.productions.get(e);return n?Array.from(n):[]}getAllRelationships(){let e=[];for(let[n,r]of this.dependencies.entries())for(let o of r)e.push({from:n,to:o,kind:"dependsOn"});for(let[n,r]of this.productions.entries())for(let o of r)e.push({from:n,to:o,kind:"produces"});return e}has(e){return this.intents.has(e)}clear(){this.intents.clear(),this.dependencies.clear(),this.productions.clear()}};var Vi=new ee;function We(){return new ee}s(We,"createIntentRegistry");var _={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Xt={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},compositionRoots:{..._,default:[]},kernelRoots:{..._},managedLayers:{..._,default:[]},requireDeclarations:{type:"boolean",default:!0},ignoreDirectNewForErrors:{type:"boolean",default:!0}}},Zt={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},planeRoots:{..._,default:[]},managedLayers:{..._,default:[]},maxXiKeys:{type:"integer",minimum:1,default:7},xiKeys:{..._,default:[]}}};var Yt="1.3",en="https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",tn=["DomainModel","ApplicationOrchestration","PersistenceAdapters","IntegrationAdapters","WorkflowSagaEngine","BackgroundJobsScheduling","PresentationAdapters","ReportingReadModels","ExtensibilityMetadata","SecurityAuditObservability","Kernel"],Or=new Set(["PresentationAdapters->ApplicationOrchestration","ApplicationOrchestration->DomainModel","WorkflowSagaEngine->ApplicationOrchestration","WorkflowSagaEngine->DomainModel","BackgroundJobsScheduling->ApplicationOrchestration"]);function Nr(){let t=[];for(let e of tn)for(let n of tn)e===n||Or.has(`${e}->${n}`)||t.push({from:e,to:n,allowed:!1});return t}s(Nr,"createDefaultRules");var qe=Nr();var A={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},as={$schema:"https://json-schema.org/draft/2020-12/schema",$id:en,title:"ArkGate architecture contract",description:"Versioned contract consumed identically by ArkGate CLI, MCP, and ESLint surfaces.",type:"object",additionalProperties:!1,required:["$schema","schemaVersion","include","layers","rules"],properties:{$schema:{type:"string",minLength:1,default:en,description:"Editor-facing URL or local path for this JSON Schema."},schemaVersion:{type:"string",const:Yt,default:Yt},name:{type:"string",minLength:1},include:{...A,minItems:1,default:["src"]},exclude:{...A,default:[]},excludeGenerated:{type:"boolean",default:!0},frameworkOverlay:{type:"string",minLength:1},layers:{type:"array",default:[],items:{$ref:"#/$defs/layer"}},rules:{type:"array",default:qe,items:{$ref:"#/$defs/rule"}},cyclePolicy:{type:"string",enum:["strict","soft","framework-soft","off"],default:"strict"},dynamicImportAllowlist:{...A,default:[]},safety:{$ref:"#/$defs/safety",default:{maxTsSuppressions:0,maxAnyCasts:0,allowInMemory:!1,allowDisabledPeerIsolation:!1}},coverage:{$ref:"#/$defs/coverage"},arkRules:{type:"object",additionalProperties:{type:"string",minLength:1},default:{}},arkRun:{$ref:"#/$defs/arkRun"},arkOrder:{$ref:"#/$defs/arkOrder"},stewards:{...A,default:[]}},$defs:{layer:{type:"object",additionalProperties:!1,required:["name","patterns"],properties:{name:{type:"string",minLength:1},patterns:{...A,minItems:1},exclude:A,intentPrefixes:A,description:{type:"string",minLength:1},forbiddenGlobals:A,capabilities:{type:"object",additionalProperties:!1,properties:{deny:{type:"array",uniqueItems:!0,items:{type:"string",enum:["network","filesystem","clock","randomness","environment","process","persistence"]}}}},pure:{type:"boolean"},mayImportInfrastructure:{type:"boolean"},optional:{type:"boolean"},reserved:{type:"boolean"},allowEmpty:{type:"boolean"}}},rule:{type:"object",additionalProperties:!1,required:["from","to","allowed"],properties:{from:{type:"string",minLength:1},to:{type:"string",minLength:1},allowed:{type:"boolean"},message:{type:"string",minLength:1},peerIsolation:{type:"boolean"},sliceFolders:{...A,minItems:1},sharedRoots:{...A,minItems:1},allowedCrossSlice:{type:"array",minItems:1,items:{type:"object",additionalProperties:!1,required:["from","to"],properties:{from:{type:"string",minLength:1},to:{type:"string",minLength:1}}}}}},safety:{type:"object",additionalProperties:!1,properties:{maxTsSuppressions:{type:"integer",minimum:0,default:0},maxAnyCasts:{type:"integer",minimum:0,default:0},allowInMemory:{type:"boolean",default:!1},allowDisabledPeerIsolation:{type:"boolean",default:!1}}},coverage:{type:"object",additionalProperties:!1,description:"Invariant coverage scan controls. testGlobs replaces the built-in test-name heuristic; maxFiles raises or lowers the evidence file budget; coverageRoots declares where the project runs its tests, so a covering test found outside them is reported instead of silently certifying an invariant.",properties:{testGlobs:{...A,minItems:1},maxFiles:{type:"integer",minimum:1},coverageRoots:{...A,minItems:1}}},arkRun:Xt,arkOrder:Zt}};function Dr(t){return t.endsWith(".")?t:`${t}.`}s(Dr,"normalizePrefix");function Tr(t,e){let n=t.prefixes.length?Math.max(...t.prefixes.map(o=>o.length)):0;return(e.prefixes.length?Math.max(...e.prefixes.map(o=>o.length)):0)-n}s(Tr,"byLongestPrefix");function nn(t){let e=t.layers.map(o=>({...o,prefixes:o.prefixes.map(Dr)})),n=[...e].sort(Tr),r=[...t.rules??[]];return{name:t.name,layers:e,rules:r,resolveLayer(o){return e.find(i=>i.match?.(o))?.name??n.find(i=>i.prefixes.some(a=>o.startsWith(a)))?.name}}}s(nn,"createArchitectureProfile");var _r=[{name:"DomainModel",prefixes:["Domain"],description:"Rich domain model, business rules, and domain events.",order:1},{name:"ApplicationOrchestration",prefixes:["Application"],description:"Use cases and command orchestration.",order:2},{name:"PersistenceAdapters",prefixes:["Adapter.Persistence","Adapter.Repository"],description:"Database, repository, and storage adapters.",order:3},{name:"IntegrationAdapters",prefixes:["Adapter.Integration","Adapter.External"],description:"External systems, APIs, and integration adapters.",order:4},{name:"WorkflowSagaEngine",prefixes:["Workflow"],description:"Sagas, workflows, and long-running processes.",order:5},{name:"BackgroundJobsScheduling",prefixes:["Job"],description:"Background jobs, scheduled work, and async processors.",order:6},{name:"PresentationAdapters",prefixes:["Presentation","Adapter.Presentation","Adapter.Api"],description:"API, UI, controller, and presentation adapters.",order:7},{name:"ReportingReadModels",prefixes:["Reporting"],description:"Read models, projections, and reporting surfaces.",order:8},{name:"ExtensibilityMetadata",prefixes:["Metadata"],description:"Metadata, extensions, and schema contracts.",order:9},{name:"SecurityAuditObservability",prefixes:["Security","Audit","Observability"],description:"Security, audit, and observability concerns.",order:10},{name:"Kernel",prefixes:["Kernel"],description:"Ark-owned governance and kernel signals.",order:11}],ze=nn({name:"Ark 11-layer Hexagonal Event-Driven Profile",layers:_r,rules:qe.map(t=>({...t}))});var rn="4.8.6";function Mr(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")}s(Mr,"policyId");var Je=class{constructor(e){this.data=e}data;static{s(this,"ArkManifestImpl")}toJSON(){return{...this.data}}};function Qe(t={}){let e=t.registry,n=t.policyEngine,r=t.metadata,o=t.graph,i=t.profile,a=t.projections,c=t.eventContracts,d=t.observability,l=e?e.list().map(m=>({name:m.name,dependencies:e.getDependencies(m.name),productions:e.getProductions(m.name)})):[],p=e?e.getAllRelationships():[],y=n?n.getPolicies().map(m=>({id:Mr(m.name),name:m.name,severity:m.severity,tags:m.tags?[...m.tags]:void 0,owner:m.owner,version:m.version,rationale:m.rationale,enforcementMode:m.enforcementMode,deprecated:m.deprecated,replacedBy:m.replacedBy,description:m.tags?.includes("layer")?"Enforces clean-architecture layer dependency rules on declared relationships.":void 0})):[],f=r?r.toJSON():[],g=o?o.toJSON():{nodes:[],edges:[]},h=f.filter(m=>(m.emits?.length??0)>0||(m.consumes?.length??0)>0).map(m=>({entity:m.name,emits:m.emits,consumes:m.consumes})),u=a?a.list().map(m=>({name:m.name,sourceIntents:m.sourceIntents,checkpoint:a.getCheckpoint(m.name)})):[],S={schemaVersion:"1.0",version:rn,exportedAt:new Date().toISOString(),intents:l,relationships:p,policies:y,entities:f,graph:g,architecture:i?{profile:i.name,layers:i.layers,rules:i.rules}:void 0,projections:u,eventContracts:c?.list()??[],observability:d?.report(),links:{entityIntents:h}};return new Je(S)}s(Qe,"createArkManifest");var me=class{static{s(this,"MetadataRegistryImpl")}entities=new Map;entity(e,n,r={}){if(this.entities.has(e)&&!r.allowOverwrite)throw new Error(`Entity metadata "${e}" is already registered.`);let o={name:e,fields:{},...n};return this.entities.set(e,o),o}getEntity(e){return this.entities.get(e)}listEntities(){return Array.from(this.entities.values())}findEntitiesByIntent(e){return this.listEntities().filter(n=>n.emits?.includes(e)||n.consumes?.includes(e))}validate(){let e=[];for(let n of this.entities.values()){n.name.trim()||e.push({entity:n.name,message:"Entity name is required."});for(let[r,o]of Object.entries(n.fields))r.trim()||e.push({entity:n.name,field:r,message:"Field name is required."}),(!o.type||typeof o.type!="string")&&e.push({entity:n.name,field:r,message:"Field type must be a non-empty string."}),o.relation&&!this.entities.has(o.relation.entity)&&e.push({entity:n.name,field:r,message:`Related entity "${o.relation.entity}" is not registered.`})}return{ok:e.length===0,issues:e}}toJSON(){return this.listEntities()}};function Xe(){return new me}s(Xe,"createMetadataRegistry");function Ze(t){return`${t.from}->${t.to}`}s(Ze,"flowKey");function sn(t){let e=new Set,n=[];for(let r of t){let o=Ze(r);e.has(o)||(e.add(o),n.push(r))}return n}s(sn,"uniqueFlows");function an(t,e){let n=new Set(e.map(Ze));return t.filter(r=>!n.has(Ze(r)))}s(an,"difference");function Ye(t){let e=t.registry,n=t.eventBus,r=t.graph;return{report(){let o=e?e.getAllRelationships().filter(u=>u.kind==="produces").map(u=>({from:u.from,to:u.to})):[],i=o.length>0||!r?[]:r.getEdges().filter(u=>u.kind==="produces").map(u=>({from:u.from,to:u.to})),a=n?.getHistory().map(u=>({from:u.event.metadata.source,to:u.event.intent}))??[],c=a.length>0||!r?[]:r.getEdges().filter(u=>u.kind==="observed").map(u=>({from:u.from,to:u.to})),d=sn([...o,...i]),l=sn([...a,...c]),p=l.filter(u=>!u.from||u.from==="unknown"),y=e?Array.from(new Set(l.map(u=>u.from).filter(u=>u&&u!=="unknown"&&!e.has(u)))):[],f=e?Array.from(new Set(l.map(u=>u.to).filter(u=>!e.has(u)))):[],g=new Set(l.flatMap(u=>[u.from,u.to])),h=e?e.list().map(u=>u.name).filter(u=>!g.has(u)):[];return{generatedAt:new Date().toISOString(),declaredProductions:d,observedProductions:l,declaredButUnobserved:an(d,l),observedButUndeclared:an(l.filter(u=>u.from!=="unknown"),d),unknownSources:p,unregisteredObservedSources:y,unregisteredObservedIntents:f,registeredButNeverObserved:h}}}}s(Ye,"createObservabilityReporter");var cn=0;function Lr(){return cn+=1,`outbox-${Date.now()}-${cn}`}s(Lr,"nextOutboxId");function dn(t){return{...t,event:{...t.event,metadata:{...t.event.metadata}}}}s(dn,"cloneRecord");var te=class{static{s(this,"InMemoryEventBuffer")}records=new Map;async enqueue(e){let n=new Date().toISOString(),r={id:Lr(),event:e,status:"pending",attempts:0,createdAt:n,updatedAt:n};return this.records.set(r.id,r),dn(r)}async markDispatched(e){let n=this.records.get(e);n&&(n.status="dispatched",n.updatedAt=new Date().toISOString())}async markFailed(e,n){let r=this.records.get(e);r&&(r.status="failed",r.attempts+=1,r.error=n instanceof Error?n.message:String(n),r.updatedAt=new Date().toISOString())}async list(e){return Array.from(this.records.values()).filter(n=>!e||n.status===e).map(dn)}async clear(){this.records.clear()}};var ye=class{static{s(this,"InMemoryReadModelStore")}states=new Map;load(e){return this.states.get(e)}save(e,n){this.states.set(e,n)}clear(e){e?this.states.delete(e):this.states.clear()}};function Kr(t){return typeof t.initialState=="function"?t.initialState():t.initialState}s(Kr,"initialState");var he=class{static{s(this,"ProjectionRegistryImpl")}definitions=new Map;checkpoints=new Map;store;auditTrail;constructor(e={}){this.store=e.store??new ye,this.auditTrail=e.auditTrail}register(e){if(this.definitions.has(e.name))throw new Error(`Projection "${e.name}" is already registered.`);this.definitions.set(e.name,e),this.checkpoints.set(e.name,{projection:e.name,appliedCount:0})}list(){return Array.from(this.definitions.values())}async apply(e){let n=[];for(let r of this.definitions.values()){if(!r.sourceIntents.includes(e.intent))continue;let o=await this.store.load(r.name)??Kr(r),i=await r.project(e,o);await this.store.save(r.name,i);let a=this.checkpoints.get(r.name);this.checkpoints.set(r.name,{projection:r.name,appliedCount:(a?.appliedCount??0)+1,lastIntent:e.intent,lastCorrelationId:e.metadata.correlationId,updatedAt:new Date().toISOString()}),await this.auditTrail?.record({type:"projection.applied",source:"Kernel.ProjectionRegistry",intent:e.intent,correlationId:e.metadata.correlationId,causationId:e.metadata.causationId,subject:r.name,details:{projection:r.name}}),n.push(r.name)}return n}async getState(e){return this.store.load(e)}getCheckpoint(e){return this.checkpoints.get(e)}getCheckpoints(){return Array.from(this.checkpoints.values())}async clear(){await this.store.clear();for(let e of this.definitions.values())this.checkpoints.set(e.name,{projection:e.name,appliedCount:0})}};function et(t){return new he(t)}s(et,"createProjectionRegistry");var ln=0;function Gr(t){return ln+=1,`${t}-${Date.now()}-${ln}`}s(Gr,"createWorkflowId");function tt(t){return t instanceof Error?t.message:String(t)}s(tt,"errorMessage");function jr(t){return new Promise(e=>{setTimeout(e,t)})}s(jr,"sleep");async function Fr(t,e,n){let r=new AbortController;if(e===void 0)return t(r.signal);let o,i=new Promise((a,c)=>{o=setTimeout(()=>{let d=new Error(`Workflow step "${n}" timed out after ${e}ms.`);r.abort(d),c(d)},e)});try{return await Promise.race([t(r.signal),i])}finally{o&&clearTimeout(o)}}s(Fr,"withTimeout");var ke=class{static{s(this,"InMemoryWorkflowStore")}snapshots=new Map;save(e,n){let r=this.snapshots.get(e.id);if(r&&r.version!==e.version)throw new Error(`Optimistic concurrency conflict for workflow ${e.id}`);let o=(e.version??0)+1;this.snapshots.set(e.id,{...e,version:o,context:{...e.context}}),e.version=o}get(e,n){let r=this.snapshots.get(e);return r?{...r,context:{...r.context}}:void 0}list(e){return Array.from(this.snapshots.values()).filter(n=>!e||n.workflowName===e).map(n=>({...n,context:{...n.context}}))}claim(e,n,r){let o=Date.now();for(let i of this.snapshots.values()){if(r&&i.workflowName!==r||i.status!=="running"&&i.status!=="compensating")continue;let a=i.expiresAt?new Date(i.expiresAt).getTime()<o:!0;if(!i.ownerId||a){i.ownerId=e,i.expiresAt=new Date(o+n).toISOString();let c=(i.version??0)+1;return i.version=c,this.snapshots.set(i.id,{...i,context:{...i.context}}),{...i,context:{...i.context}}}}}clear(){this.snapshots.clear()}},nt=class{constructor(e,n={}){this.bus=e;this.options=n;this.store=n.store??new ke}bus;options;static{s(this,"WorkflowEngineImpl")}definitions=new Map;store;register(e){if(this.definitions.has(e.name))throw new Error(`Workflow "${e.name}" is already registered.`);let n=new Set;for(let r of e.steps){if(n.has(r.name))throw new Error(`Workflow "${e.name}" has duplicate step name "${r.name}".`);n.add(r.name)}if(this.definitions.set(e.name,e),e.startOn){let r=e.startOn;this.bus.subscribe(r.intent,async o=>{await this.start(e.name,r.mapEventToPayload(o))})}}async start(e,n,r={}){let o=this.definitions.get(e);if(!o)throw new Error(`Workflow "${e}" is not registered.`);let i=new Date().toISOString(),a={id:r.id??Gr(e),version:0,workflowName:e,status:"running",context:{...n},completedSteps:[],attempts:{},startedAt:i,updatedAt:i};return await this.store.save(a,r.tx),await this.audit("workflow.started",a,{workflowName:e}),this.executeSnapshot(a,o,r.tx)}async resume(e,n={}){let r=await this.get(e,n.tx);if(!r)return;if(r.status!=="running"&&r.status!=="compensating")return r;let o=this.definitions.get(r.workflowName);if(!o)throw new Error(`Workflow "${r.workflowName}" is not registered.`);return this.executeSnapshot(r,o,n.tx)}async executeSnapshot(e,n,r){try{let o=n.steps.filter(i=>!e.completedSteps.includes(i.name));for(let i of o)await this.runStep(e,i,r);return e.status="completed",e.currentStep=void 0,e.completedAt=new Date().toISOString(),e.updatedAt=e.completedAt,await this.store.save(e,r),await this.audit("workflow.completed",e,{workflowName:e.workflowName}),{...e,context:{...e.context}}}catch(o){throw await this.compensate(e,n.steps,o,r),e.status="failed",e.currentStep=void 0,e.error=tt(o),e.updatedAt=new Date().toISOString(),await this.store.save(e,r),await this.audit("workflow.failed",e,{workflowName:e.workflowName,error:e.error,failedStep:e.failedStep}),o}}async get(e,n){return this.store.get(e,n)}async list(e){return this.store.list(e)}async runStep(e,n,r){let o=n.retry??this.options.defaultRetry??{attempts:1},i=Math.max(1,o.attempts);e.currentStep=n.name,e.updatedAt=new Date().toISOString(),await this.store.save(e,r);for(let a=1;a<=i;a+=1){e.attempts[n.name]=a,await this.store.save(e,r);let c;try{c=await Fr(d=>Promise.resolve(n.execute(e.context,this.bus,d)),n.timeoutMs,n.name)}catch(d){if(a<i){o.delayMs&&await jr(o.delayMs);continue}throw e.failedStep=n.name,e.updatedAt=new Date().toISOString(),await this.store.save(e,r),await this.audit("workflow.step.failed",e,{step:n.name,attempt:a,error:tt(d)}),d}c&&Object.assign(e.context,c),e.completedSteps.push(n.name),e.currentStep=void 0,e.updatedAt=new Date().toISOString(),await this.store.save(e,r),await this.audit("workflow.step.completed",e,{step:n.name,attempt:a});return}throw new Error(`Workflow step "${n.name}" did not complete.`)}async compensate(e,n,r,o){e.status="compensating",e.updatedAt=new Date().toISOString(),await this.store.save(e,o);let i=n.filter(a=>e.completedSteps.includes(a.name));for(let a=i.length-1;a>=0;a-=1){let c=i[a];if(c.compensate)try{await Promise.resolve(c.compensate(e.context,this.bus,r)),await this.audit("workflow.compensation.completed",e,{step:c.name})}catch(d){await this.audit("workflow.step.failed",e,{step:c.name,compensation:!0,error:tt(d)})}}}async audit(e,n,r){await this.options.auditTrail?.record({type:e,source:"Kernel.WorkflowEngine",subject:n.id,details:r})}};function rt(t,e){return new nt(t,e)}s(rt,"createWorkflowEngine");G();var Br=new Set(["singleton","transient"]);function un(t){let e={id:t.id,lifetime:t.lifetime,uses:[...t.uses],reactsTo:[...t.reactsTo],raises:[...t.raises],sends:[...t.sends]};if(t.extendedInfo){let n=t.extendedInfo;e.extendedInfo={...n.label?{label:n.label}:{},...n.architectureKind?{architectureKind:n.architectureKind}:{},...n.tags?{tags:[...n.tags]}:{},...n.group?{group:n.group}:{},...n.metadata?{metadata:{...n.metadata}}:{}}}return e}s(un,"cloneComponent");function Hr(t){if(t===void 0)return"singleton";if(typeof t=="string"&&Br.has(t))return t;throw new Error('ArkRun component lifetime must be "singleton" or "transient".')}s(Hr,"closedLifetime");function pn(){let t=new Map,e=new Map,n=new Set;function r(a){let c=t.get(a);if(!c)throw new Error(`ArkRun component "${a}" is not registered.`);return c}s(r,"mustRecord");function o(a,c){if(!c.factory)throw new Error(`ArkRun component "${a}" has no factory; declarations-only registrations cannot be resolved.`);if(n.has(a))throw new Error(`ArkRun component "${a}" has a circular resolve.`);n.add(a);try{return c.factory()}finally{n.delete(a)}}s(o,"instantiate");function i(a,c){if(e.has(a))return e.get(a);let d=o(a,c);return e.set(a,d),d}return s(i,"singleton"),{register(a){let c=typeof a?.id=="string"?a.id.trim():"";if(!c)throw new Error("ArkRun component id must be a non-empty string.");if(t.has(c))throw new Error(`ArkRun component "${c}" is already registered.`);let d=Hr(a.lifetime),l=Se({id:c,lifetime:d,uses:a.uses,reactsTo:a.reactsTo,raises:a.raises,sends:a.sends,extendedInfo:a.extendedInfo});if(!l)throw new Error("ArkRun component id must be a non-empty string.");let p=typeof a.factory=="function"?a.factory:void 0;return t.set(c,{component:l,factory:p}),un(l)},resolve(a){let c=r(a);return c.component.lifetime==="transient"?o(a,c):i(a,c)},resolveSingleton(a){let c=r(a);if(c.component.lifetime==="transient")throw new Error(`ArkRun component "${a}" is transient; resolveSingleton requires lifetime "singleton".`);return i(a,c)},snapshotComponents(){return[...t.values()].map(a=>un(a.component))}}}s(pn,"createComponentRegistry");ce();async function mn(t,e={}){let n=Te({host:e.host,port:e.port,nodeEnv:e.nodeEnv,processNodeEnv:process.env.NODE_ENV}),{listenArkRunInspector:r}=await Promise.resolve().then(()=>(gn(),fn));return r(t,{bind:n,sseIntervalMs:e.sseIntervalMs})}s(mn,"startArkRunInspector");ie();function Jr(t){let e={...t.metadata??{}};if(t.source===void 0)return e;if(e.source&&e.source!==t.source)throw new b(t.source,e.source);return e.source=t.source,e}s(Jr,"stampMetadata");function Qr(){}s(Qr,"ignoreDetachedFailure");async function ot(t,e,n,r={}){let o=wt({transport:r.transport,ephemeral:r.ephemeral??t.defaultEphemeral,brokerBound:typeof t.broker?.send=="function"}),i=Jr(r),a=await t.eventBus.dispatch(e,n,i,{notifySubscribers:o.notifySubscribers,awaitHandlers:o.awaitHandlers});if(o.deliveredVia==="broker"&&t.broker){let c=Promise.resolve(t.broker.send(a));o.awaitHandoff?await c:c.then(void 0,Qr)}return o}s(ot,"sendOnArkRunTransport");var Xr=1e3,yn=0;function Zr(){return yn+=1,`ark-kernel-${Date.now()}-${yn}`}s(Zr,"nextKernelInstanceId");function hn(t={}){let e=t.strict??!0,n=t.instanceId??Zr(),r=t.profile??ze,o=t.maxHistorySize??Xr,i=We(),a=Ve(),c=t.metadata??Xe(),d=t.auditTrail??$e({maxRecords:o}),l=t.eventContracts??He(),p=t.eventBuffer??t.outbox??new te,y=t.projections??et({auditTrail:d}),f=new O([Le(r),...t.policies??[]]),g=s(()=>{Ue(i,a,{requireRegisteredTargets:!0})},"syncGraph"),h=t.ephemeral??!0,u=t.broker,S=new Y({intentRegistry:i,dependencyGraph:a,policyEngine:f,strictRegistry:!0,validateIntentNaming:!0,auditTrail:d,eventContracts:l,strictEventContracts:t.strictEventContracts??e,requireKnownSource:t.requireKnownSource??!0,architectureProfile:r,enforceObservedLayerFlow:t.enforceObservedLayerFlow??(e?"hard":"off"),eventBuffer:p,instanceId:n,maxHistorySize:o,onPublish:t.autoApplyProjections===!1?void 0:async k=>{await y.apply(k)}}),m=rt(S,{auditTrail:d}),we=Ye({registry:i,eventBus:S,graph:a}),x=pn(),kn=typeof u?.send=="function",it={instanceId:n,profile:r,registry:i,graph:a,metadata:c,auditTrail:d,eventContracts:l,eventBuffer:p,outbox:p,projections:y,policyEngine:f,eventBus:S,workflowEngine:m,observability:we,publisher(k){let M=S.createPublisher(k);return{source:M.source,publish:M.publish,send(Ie,Rn,An={}){return ot({eventBus:S,broker:u,defaultEphemeral:h},Ie,Rn,{...An,source:M.source})}}},send(k,M,Ie={}){return ot({eventBus:S,broker:u,defaultEphemeral:h},k,M,Ie)},register(k){return x.register(k)},resolve(k){return x.resolve(k)},resolveSingleton(k){return x.resolveSingleton(k)},getDependencyInformationPackage(){return v({kernelInstanceId:n,components:x.snapshotComponents()})},requestGraph(k){return At({kernelInstanceId:n,components:x.snapshotComponents()},k)},getInspectorSnapshot(k){return Pt({kernelInstanceId:n,host:k?.host,port:k?.port,package:{kernelInstanceId:n,components:x.snapshotComponents()},observability:we.report(),ephemeralDefault:h,brokerBound:kn})},startInspector(k){return mn(it,k)},syncGraph:g,manifest(){return g(),Qe({registry:i,policyEngine:f,metadata:c,graph:a,profile:r,projections:y,eventContracts:l,observability:we})}};return it}s(hn,"createArkKernel");var $=Symbol("ARK_KERNEL"),Yr=s(()=>(0,Ae.Inject)($),"InjectArk"),E=class{static forRoot(e){let n=e&&"registry"in e?e:hn(e);return{module:E,global:!0,providers:[{provide:$,useValue:n}],exports:[$]}}static forRootAsync(e){return{module:E,global:!0,providers:[{provide:$,useFactory:e.useFactory,inject:e.inject??[]}],exports:[$]}}};s(E,"ArkModule"),E=dt([(0,Ae.Module)({})],E);0&&(module.exports={ARK_KERNEL,ArkModule,InjectArk});
|
|
18
|
+
`}return r.trim()}detectViolations(e=[]){let n=[],r=this.findSimpleCycles();r.length>0&&n.push(`Cycle detected: ${r.map(o=>o.join("->")).join(", ")}`);for(let o of e)try{let i=o(this.edges);i&&i.length&&n.push(...i)}catch(i){n.push(`Rule error: ${i.message}`)}return n}ensureNode(e){this.nodes.has(e)||this.nodes.set(e,{id:e})}addEdge(e){this.edges.some(r=>r.from===e.from&&r.to===e.to&&r.kind===e.kind)||this.edges.push(e)}findSimpleCycles(){let e=new Map;for(let c of this.edges)e.has(c.from)||e.set(c.from,[]),e.get(c.from).push(c.to);let n=[],r=new Set,o=[],i=s(c=>{r.add(c),o.push(c);for(let d of e.get(c)||[])if(!r.has(d))i(d);else if(o.includes(d)){let u=o.indexOf(d),l=o.slice(u).concat(d);n.push(l)}o.pop()},"dfs");for(let c of e.keys())r.has(c)||i(c);let a=new Set(n.map(c=>c.join("->")));return Array.from(a).map(c=>c.split("->"))}safeId(e){return e.replace(/[^a-zA-Z0-9_]/g,"_")}};function ot(){return new Ee}s(ot,"createDependencyGraph");function it(t,e,n={}){let r=n.requireRegisteredTargets??!1;for(let o of t.getAllRelationships())r&&!t.has(o.to)||(o.kind==="dependsOn"?e.registerDependency(o.from,o.to,"declared"):e.registerDependency(o.from,o.to,"produces"))}s(it,"syncRegistryToGraph");var ue=class{static{s(this,"IntentRegistry")}intents=new Map;dependencies=new Map;productions=new Map;define(e,n){if(this.intents.has(e))throw new Error(`Intent "${e}" is already registered. Intent names must be unique within a registry.`);let r=s(i=>({intent:e,payload:i,metadata:{occurredAt:new Date().toISOString(),source:"unknown"}}),"fn");Object.defineProperty(r,"name",{value:e,enumerable:!0,configurable:!1,writable:!1});let o=r;if(this.intents.set(e,o),n?.dependsOn)for(let i of n.dependsOn)this.declareDependency(e,i);if(n?.produces)for(let i of n.produces)this.declareProduction(e,i);return o}declareDependency(e,n){this.dependencies.has(e)||this.dependencies.set(e,new Set),this.dependencies.get(e).add(n)}declareProduction(e,n){this.productions.has(e)||this.productions.set(e,new Set),this.productions.get(e).add(n)}get(e){return this.intents.get(e)}list(){return Array.from(this.intents.values())}getDependencies(e){let n=this.dependencies.get(e);return n?Array.from(n):[]}getProductions(e){let n=this.productions.get(e);return n?Array.from(n):[]}getAllRelationships(){let e=[];for(let[n,r]of this.dependencies.entries())for(let o of r)e.push({from:n,to:o,kind:"dependsOn"});for(let[n,r]of this.productions.entries())for(let o of r)e.push({from:n,to:o,kind:"produces"});return e}has(e){return this.intents.has(e)}clear(){this.intents.clear(),this.dependencies.clear(),this.productions.clear()}};var ms=new ue;function st(){return new ue}s(st,"createIntentRegistry");var F={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},pn={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},compositionRoots:{...F,default:[]},kernelRoots:{...F},managedLayers:{...F,default:[]},requireDeclarations:{type:"boolean",default:!0},ignoreDirectNewForErrors:{type:"boolean",default:!0}}},fn={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},planeRoots:{...F,default:[]},managedLayers:{...F,default:[]},maxXiKeys:{type:"integer",minimum:1,default:7},xiKeys:{...F,default:[]}}};var mn="1.3",gn="https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",yn=["DomainModel","ApplicationOrchestration","PersistenceAdapters","IntegrationAdapters","WorkflowSagaEngine","BackgroundJobsScheduling","PresentationAdapters","ReportingReadModels","ExtensibilityMetadata","SecurityAuditObservability","Kernel"],Zr=new Set(["PresentationAdapters->ApplicationOrchestration","ApplicationOrchestration->DomainModel","WorkflowSagaEngine->ApplicationOrchestration","WorkflowSagaEngine->DomainModel","BackgroundJobsScheduling->ApplicationOrchestration"]);function Yr(){let t=[];for(let e of yn)for(let n of yn)e===n||Zr.has(`${e}->${n}`)||t.push({from:e,to:n,allowed:!1});return t}s(Yr,"createDefaultRules");var at=Yr();var A={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Ns={$schema:"https://json-schema.org/draft/2020-12/schema",$id:gn,title:"ArkGate architecture contract",description:"Versioned contract consumed identically by ArkGate CLI, MCP, and ESLint surfaces.",type:"object",additionalProperties:!1,required:["$schema","schemaVersion","include","layers","rules"],properties:{$schema:{type:"string",minLength:1,default:gn,description:"Editor-facing URL or local path for this JSON Schema."},schemaVersion:{type:"string",const:mn,default:mn},name:{type:"string",minLength:1},include:{...A,minItems:1,default:["src"]},exclude:{...A,default:[]},excludeGenerated:{type:"boolean",default:!0},frameworkOverlay:{type:"string",minLength:1},layers:{type:"array",default:[],items:{$ref:"#/$defs/layer"}},rules:{type:"array",default:at,items:{$ref:"#/$defs/rule"}},cyclePolicy:{type:"string",enum:["strict","soft","framework-soft","off"],default:"strict"},dynamicImportAllowlist:{...A,default:[]},safety:{$ref:"#/$defs/safety",default:{maxTsSuppressions:0,maxAnyCasts:0,allowInMemory:!1,allowDisabledPeerIsolation:!1}},coverage:{$ref:"#/$defs/coverage"},arkRules:{type:"object",additionalProperties:{type:"string",minLength:1},default:{}},arkRun:{$ref:"#/$defs/arkRun"},arkOrder:{$ref:"#/$defs/arkOrder"},stewards:{...A,default:[]}},$defs:{layer:{type:"object",additionalProperties:!1,required:["name","patterns"],properties:{name:{type:"string",minLength:1},patterns:{...A,minItems:1},exclude:A,intentPrefixes:A,description:{type:"string",minLength:1},forbiddenGlobals:A,capabilities:{type:"object",additionalProperties:!1,properties:{deny:{type:"array",uniqueItems:!0,items:{type:"string",enum:["network","filesystem","clock","randomness","environment","process","persistence"]}}}},pure:{type:"boolean"},mayImportInfrastructure:{type:"boolean"},optional:{type:"boolean"},reserved:{type:"boolean"},allowEmpty:{type:"boolean"}}},rule:{type:"object",additionalProperties:!1,required:["from","to","allowed"],properties:{from:{type:"string",minLength:1},to:{type:"string",minLength:1},allowed:{type:"boolean"},message:{type:"string",minLength:1},peerIsolation:{type:"boolean"},sliceFolders:{...A,minItems:1},sharedRoots:{...A,minItems:1},allowedCrossSlice:{type:"array",minItems:1,items:{type:"object",additionalProperties:!1,required:["from","to"],properties:{from:{type:"string",minLength:1},to:{type:"string",minLength:1}}}}}},safety:{type:"object",additionalProperties:!1,properties:{maxTsSuppressions:{type:"integer",minimum:0,default:0},maxAnyCasts:{type:"integer",minimum:0,default:0},allowInMemory:{type:"boolean",default:!1},allowDisabledPeerIsolation:{type:"boolean",default:!1}}},coverage:{type:"object",additionalProperties:!1,description:"Invariant coverage scan controls. testGlobs replaces the built-in test-name heuristic; maxFiles raises or lowers the evidence file budget; coverageRoots declares where the project runs its tests, so a covering test found outside them is reported instead of silently certifying an invariant.",properties:{testGlobs:{...A,minItems:1},maxFiles:{type:"integer",minimum:1},coverageRoots:{...A,minItems:1}}},arkRun:pn,arkOrder:fn}};function eo(t){return t.endsWith(".")?t:`${t}.`}s(eo,"normalizePrefix");function to(t,e){let n=t.prefixes.length?Math.max(...t.prefixes.map(o=>o.length)):0;return(e.prefixes.length?Math.max(...e.prefixes.map(o=>o.length)):0)-n}s(to,"byLongestPrefix");function hn(t){let e=t.layers.map(o=>({...o,prefixes:o.prefixes.map(eo)})),n=[...e].sort(to),r=[...t.rules??[]];return{name:t.name,layers:e,rules:r,resolveLayer(o){return e.find(i=>i.match?.(o))?.name??n.find(i=>i.prefixes.some(a=>o.startsWith(a)))?.name}}}s(hn,"createArchitectureProfile");var no=[{name:"DomainModel",prefixes:["Domain"],description:"Rich domain model, business rules, and domain events.",order:1},{name:"ApplicationOrchestration",prefixes:["Application"],description:"Use cases and command orchestration.",order:2},{name:"PersistenceAdapters",prefixes:["Adapter.Persistence","Adapter.Repository"],description:"Database, repository, and storage adapters.",order:3},{name:"IntegrationAdapters",prefixes:["Adapter.Integration","Adapter.External"],description:"External systems, APIs, and integration adapters.",order:4},{name:"WorkflowSagaEngine",prefixes:["Workflow"],description:"Sagas, workflows, and long-running processes.",order:5},{name:"BackgroundJobsScheduling",prefixes:["Job"],description:"Background jobs, scheduled work, and async processors.",order:6},{name:"PresentationAdapters",prefixes:["Presentation","Adapter.Presentation","Adapter.Api"],description:"API, UI, controller, and presentation adapters.",order:7},{name:"ReportingReadModels",prefixes:["Reporting"],description:"Read models, projections, and reporting surfaces.",order:8},{name:"ExtensibilityMetadata",prefixes:["Metadata"],description:"Metadata, extensions, and schema contracts.",order:9},{name:"SecurityAuditObservability",prefixes:["Security","Audit","Observability"],description:"Security, audit, and observability concerns.",order:10},{name:"Kernel",prefixes:["Kernel"],description:"Ark-owned governance and kernel signals.",order:11}],ct=hn({name:"Ark 11-layer Hexagonal Event-Driven Profile",layers:no,rules:at.map(t=>({...t}))});var kn="4.8.8";function oo(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")}s(oo,"policyId");var dt=class{constructor(e){this.data=e}data;static{s(this,"ArkManifestImpl")}toJSON(){return{...this.data}}};function ut(t={}){let e=t.registry,n=t.policyEngine,r=t.metadata,o=t.graph,i=t.profile,a=t.projections,c=t.eventContracts,d=t.observability,u=e?e.list().map(g=>({name:g.name,dependencies:e.getDependencies(g.name),productions:e.getProductions(g.name)})):[],l=e?e.getAllRelationships():[],y=n?n.getPolicies().map(g=>({id:oo(g.name),name:g.name,severity:g.severity,tags:g.tags?[...g.tags]:void 0,owner:g.owner,version:g.version,rationale:g.rationale,enforcementMode:g.enforcementMode,deprecated:g.deprecated,replacedBy:g.replacedBy,description:g.tags?.includes("layer")?"Enforces clean-architecture layer dependency rules on declared relationships.":void 0})):[],f=r?r.toJSON():[],m=o?o.toJSON():{nodes:[],edges:[]},h=f.filter(g=>(g.emits?.length??0)>0||(g.consumes?.length??0)>0).map(g=>({entity:g.name,emits:g.emits,consumes:g.consumes})),p=a?a.list().map(g=>({name:g.name,sourceIntents:g.sourceIntents,checkpoint:a.getCheckpoint(g.name)})):[],B={schemaVersion:"1.0",version:kn,exportedAt:new Date().toISOString(),intents:u,relationships:l,policies:y,entities:f,graph:m,architecture:i?{profile:i.name,layers:i.layers,rules:i.rules}:void 0,projections:p,eventContracts:c?.list()??[],observability:d?.report(),links:{entityIntents:h}};return new dt(B)}s(ut,"createArkManifest");var xe=class{static{s(this,"MetadataRegistryImpl")}entities=new Map;entity(e,n,r={}){if(this.entities.has(e)&&!r.allowOverwrite)throw new Error(`Entity metadata "${e}" is already registered.`);let o={name:e,fields:{},...n};return this.entities.set(e,o),o}getEntity(e){return this.entities.get(e)}listEntities(){return Array.from(this.entities.values())}findEntitiesByIntent(e){return this.listEntities().filter(n=>n.emits?.includes(e)||n.consumes?.includes(e))}validate(){let e=[];for(let n of this.entities.values()){n.name.trim()||e.push({entity:n.name,message:"Entity name is required."});for(let[r,o]of Object.entries(n.fields))r.trim()||e.push({entity:n.name,field:r,message:"Field name is required."}),(!o.type||typeof o.type!="string")&&e.push({entity:n.name,field:r,message:"Field type must be a non-empty string."}),o.relation&&!this.entities.has(o.relation.entity)&&e.push({entity:n.name,field:r,message:`Related entity "${o.relation.entity}" is not registered.`})}return{ok:e.length===0,issues:e}}toJSON(){return this.listEntities()}};function lt(){return new xe}s(lt,"createMetadataRegistry");function pt(t){return`${t.from}->${t.to}`}s(pt,"flowKey");function An(t){let e=new Set,n=[];for(let r of t){let o=pt(r);e.has(o)||(e.add(o),n.push(r))}return n}s(An,"uniqueFlows");function wn(t,e){let n=new Set(e.map(pt));return t.filter(r=>!n.has(pt(r)))}s(wn,"difference");function ft(t){let e=t.registry,n=t.eventBus,r=t.graph;return{report(){let o=e?e.getAllRelationships().filter(p=>p.kind==="produces").map(p=>({from:p.from,to:p.to})):[],i=o.length>0||!r?[]:r.getEdges().filter(p=>p.kind==="produces").map(p=>({from:p.from,to:p.to})),a=n?.getHistory().map(p=>({from:p.event.metadata.source,to:p.event.intent}))??[],c=a.length>0||!r?[]:r.getEdges().filter(p=>p.kind==="observed").map(p=>({from:p.from,to:p.to})),d=An([...o,...i]),u=An([...a,...c]),l=u.filter(p=>!p.from||p.from==="unknown"),y=e?Array.from(new Set(u.map(p=>p.from).filter(p=>p&&p!=="unknown"&&!e.has(p)))):[],f=e?Array.from(new Set(u.map(p=>p.to).filter(p=>!e.has(p)))):[],m=new Set(u.flatMap(p=>[p.from,p.to])),h=e?e.list().map(p=>p.name).filter(p=>!m.has(p)):[];return{generatedAt:new Date().toISOString(),declaredProductions:d,observedProductions:u,declaredButUnobserved:wn(d,u),observedButUndeclared:wn(u.filter(p=>p.from!=="unknown"),d),unknownSources:l,unregisteredObservedSources:y,unregisteredObservedIntents:f,registeredButNeverObserved:h}}}}s(ft,"createObservabilityReporter");var In=0;function io(){return In+=1,`outbox-${Date.now()}-${In}`}s(io,"nextOutboxId");function bn(t){return{...t,event:{...t.event,metadata:{...t.event.metadata}}}}s(bn,"cloneRecord");var le=class{static{s(this,"InMemoryEventBuffer")}records=new Map;async enqueue(e){let n=new Date().toISOString(),r={id:io(),event:e,status:"pending",attempts:0,createdAt:n,updatedAt:n};return this.records.set(r.id,r),bn(r)}async markDispatched(e){let n=this.records.get(e);n&&(n.status="dispatched",n.updatedAt=new Date().toISOString())}async markFailed(e,n){let r=this.records.get(e);r&&(r.status="failed",r.attempts+=1,r.error=n instanceof Error?n.message:String(n),r.updatedAt=new Date().toISOString())}async list(e){return Array.from(this.records.values()).filter(n=>!e||n.status===e).map(bn)}async clear(){this.records.clear()}};var Pe=class{static{s(this,"InMemoryReadModelStore")}states=new Map;load(e){return this.states.get(e)}save(e,n){this.states.set(e,n)}clear(e){e?this.states.delete(e):this.states.clear()}};function so(t){return typeof t.initialState=="function"?t.initialState():t.initialState}s(so,"initialState");var ve=class{static{s(this,"ProjectionRegistryImpl")}definitions=new Map;checkpoints=new Map;store;auditTrail;constructor(e={}){this.store=e.store??new Pe,this.auditTrail=e.auditTrail}register(e){if(this.definitions.has(e.name))throw new Error(`Projection "${e.name}" is already registered.`);this.definitions.set(e.name,e),this.checkpoints.set(e.name,{projection:e.name,appliedCount:0})}list(){return Array.from(this.definitions.values())}async apply(e){let n=[];for(let r of this.definitions.values()){if(!r.sourceIntents.includes(e.intent))continue;let o=await this.store.load(r.name)??so(r),i=await r.project(e,o);await this.store.save(r.name,i);let a=this.checkpoints.get(r.name);this.checkpoints.set(r.name,{projection:r.name,appliedCount:(a?.appliedCount??0)+1,lastIntent:e.intent,lastCorrelationId:e.metadata.correlationId,updatedAt:new Date().toISOString()}),await this.auditTrail?.record({type:"projection.applied",source:"Kernel.ProjectionRegistry",intent:e.intent,correlationId:e.metadata.correlationId,causationId:e.metadata.causationId,subject:r.name,details:{projection:r.name}}),n.push(r.name)}return n}async getState(e){return this.store.load(e)}getCheckpoint(e){return this.checkpoints.get(e)}getCheckpoints(){return Array.from(this.checkpoints.values())}async clear(){await this.store.clear();for(let e of this.definitions.values())this.checkpoints.set(e.name,{projection:e.name,appliedCount:0})}};function mt(t){return new ve(t)}s(mt,"createProjectionRegistry");var Sn=0;function ao(t){return Sn+=1,`${t}-${Date.now()}-${Sn}`}s(ao,"createWorkflowId");function gt(t){return t instanceof Error?t.message:String(t)}s(gt,"errorMessage");function co(t){return new Promise(e=>{setTimeout(e,t)})}s(co,"sleep");async function uo(t,e,n){let r=new AbortController;if(e===void 0)return t(r.signal);let o,i=new Promise((a,c)=>{o=setTimeout(()=>{let d=new Error(`Workflow step "${n}" timed out after ${e}ms.`);r.abort(d),c(d)},e)});try{return await Promise.race([t(r.signal),i])}finally{o&&clearTimeout(o)}}s(uo,"withTimeout");var Ce=class{static{s(this,"InMemoryWorkflowStore")}snapshots=new Map;save(e,n){let r=this.snapshots.get(e.id);if(r&&r.version!==e.version)throw new Error(`Optimistic concurrency conflict for workflow ${e.id}`);let o=(e.version??0)+1;this.snapshots.set(e.id,{...e,version:o,context:{...e.context}}),e.version=o}get(e,n){let r=this.snapshots.get(e);return r?{...r,context:{...r.context}}:void 0}list(e){return Array.from(this.snapshots.values()).filter(n=>!e||n.workflowName===e).map(n=>({...n,context:{...n.context}}))}claim(e,n,r){let o=Date.now();for(let i of this.snapshots.values()){if(r&&i.workflowName!==r||i.status!=="running"&&i.status!=="compensating")continue;let a=i.expiresAt?new Date(i.expiresAt).getTime()<o:!0;if(!i.ownerId||a){i.ownerId=e,i.expiresAt=new Date(o+n).toISOString();let c=(i.version??0)+1;return i.version=c,this.snapshots.set(i.id,{...i,context:{...i.context}}),{...i,context:{...i.context}}}}}clear(){this.snapshots.clear()}},yt=class{constructor(e,n={}){this.bus=e;this.options=n;this.store=n.store??new Ce}bus;options;static{s(this,"WorkflowEngineImpl")}definitions=new Map;store;register(e){if(this.definitions.has(e.name))throw new Error(`Workflow "${e.name}" is already registered.`);let n=new Set;for(let r of e.steps){if(n.has(r.name))throw new Error(`Workflow "${e.name}" has duplicate step name "${r.name}".`);n.add(r.name)}if(this.definitions.set(e.name,e),e.startOn){let r=e.startOn;this.bus.subscribe(r.intent,async o=>{await this.start(e.name,r.mapEventToPayload(o))})}}async start(e,n,r={}){let o=this.definitions.get(e);if(!o)throw new Error(`Workflow "${e}" is not registered.`);let i=new Date().toISOString(),a={id:r.id??ao(e),version:0,workflowName:e,status:"running",context:{...n},completedSteps:[],attempts:{},startedAt:i,updatedAt:i};return await this.store.save(a,r.tx),await this.audit("workflow.started",a,{workflowName:e}),this.executeSnapshot(a,o,r.tx)}async resume(e,n={}){let r=await this.get(e,n.tx);if(!r)return;if(r.status!=="running"&&r.status!=="compensating")return r;let o=this.definitions.get(r.workflowName);if(!o)throw new Error(`Workflow "${r.workflowName}" is not registered.`);return this.executeSnapshot(r,o,n.tx)}async executeSnapshot(e,n,r){try{let o=n.steps.filter(i=>!e.completedSteps.includes(i.name));for(let i of o)await this.runStep(e,i,r);return e.status="completed",e.currentStep=void 0,e.completedAt=new Date().toISOString(),e.updatedAt=e.completedAt,await this.store.save(e,r),await this.audit("workflow.completed",e,{workflowName:e.workflowName}),{...e,context:{...e.context}}}catch(o){throw await this.compensate(e,n.steps,o,r),e.status="failed",e.currentStep=void 0,e.error=gt(o),e.updatedAt=new Date().toISOString(),await this.store.save(e,r),await this.audit("workflow.failed",e,{workflowName:e.workflowName,error:e.error,failedStep:e.failedStep}),o}}async get(e,n){return this.store.get(e,n)}async list(e){return this.store.list(e)}async runStep(e,n,r){let o=n.retry??this.options.defaultRetry??{attempts:1},i=Math.max(1,o.attempts);e.currentStep=n.name,e.updatedAt=new Date().toISOString(),await this.store.save(e,r);for(let a=1;a<=i;a+=1){e.attempts[n.name]=a,await this.store.save(e,r);let c;try{c=await uo(d=>Promise.resolve(n.execute(e.context,this.bus,d)),n.timeoutMs,n.name)}catch(d){if(a<i){o.delayMs&&await co(o.delayMs);continue}throw e.failedStep=n.name,e.updatedAt=new Date().toISOString(),await this.store.save(e,r),await this.audit("workflow.step.failed",e,{step:n.name,attempt:a,error:gt(d)}),d}c&&Object.assign(e.context,c),e.completedSteps.push(n.name),e.currentStep=void 0,e.updatedAt=new Date().toISOString(),await this.store.save(e,r),await this.audit("workflow.step.completed",e,{step:n.name,attempt:a});return}throw new Error(`Workflow step "${n.name}" did not complete.`)}async compensate(e,n,r,o){e.status="compensating",e.updatedAt=new Date().toISOString(),await this.store.save(e,o);let i=n.filter(a=>e.completedSteps.includes(a.name));for(let a=i.length-1;a>=0;a-=1){let c=i[a];if(c.compensate)try{await Promise.resolve(c.compensate(e.context,this.bus,r)),await this.audit("workflow.compensation.completed",e,{step:c.name})}catch(d){await this.audit("workflow.step.failed",e,{step:c.name,compensation:!0,error:gt(d)})}}}async audit(e,n,r){await this.options.auditTrail?.record({type:e,source:"Kernel.WorkflowEngine",subject:n.id,details:r})}};function ht(t,e){return new yt(t,e)}s(ht,"createWorkflowEngine");U();var lo=new Set(["singleton","transient"]);function En(t){let e={id:t.id,lifetime:t.lifetime,uses:[...t.uses],reactsTo:[...t.reactsTo],raises:[...t.raises],sends:[...t.sends]};if(t.extendedInfo){let n=t.extendedInfo;e.extendedInfo={...n.label?{label:n.label}:{},...n.architectureKind?{architectureKind:n.architectureKind}:{},...n.tags?{tags:[...n.tags]}:{},...n.group?{group:n.group}:{},...n.metadata?{metadata:{...n.metadata}}:{}}}return e}s(En,"cloneComponent");function po(t){if(t===void 0)return"singleton";if(typeof t=="string"&&lo.has(t))return t;throw new Error('ArkRun component lifetime must be "singleton" or "transient".')}s(po,"closedLifetime");function xn(){let t=new Map,e=new Map,n=new Set;function r(a){let c=t.get(a);if(!c)throw new Error(`ArkRun component "${a}" is not registered.`);return c}s(r,"mustRecord");function o(a,c){if(!c.factory)throw new Error(`ArkRun component "${a}" has no factory; declarations-only registrations cannot be resolved.`);if(n.has(a))throw new Error(`ArkRun component "${a}" has a circular resolve.`);n.add(a);try{return c.factory()}finally{n.delete(a)}}s(o,"instantiate");function i(a,c){if(e.has(a))return e.get(a);let d=o(a,c);return e.set(a,d),d}return s(i,"singleton"),{register(a){let c=typeof a?.id=="string"?a.id.trim():"";if(!c)throw new Error("ArkRun component id must be a non-empty string.");if(t.has(c))throw new Error(`ArkRun component "${c}" is already registered.`);let d=po(a.lifetime),u=_e({id:c,lifetime:d,uses:a.uses,reactsTo:a.reactsTo,raises:a.raises,sends:a.sends,extendedInfo:a.extendedInfo});if(!u)throw new Error("ArkRun component id must be a non-empty string.");let l=typeof a.factory=="function"?a.factory:void 0;return t.set(c,{component:u,factory:l}),En(u)},resolve(a){let c=r(a);return c.component.lifetime==="transient"?o(a,c):i(a,c)},resolveSingleton(a){let c=r(a);if(c.component.lifetime==="transient")throw new Error(`ArkRun component "${a}" is transient; resolveSingleton requires lifetime "singleton".`);return i(a,c)},snapshotComponents(){return[...t.values()].map(a=>En(a.component))}}}s(xn,"createComponentRegistry");Re();async function Cn(t,e={}){let n=We({host:e.host,port:e.port,nodeEnv:e.nodeEnv,processNodeEnv:process.env.NODE_ENV}),{listenArkRunInspector:r}=await Promise.resolve().then(()=>(vn(),Pn));return r(t,{bind:n,sseIntervalMs:e.sseIntervalMs})}s(Cn,"startArkRunInspector");ge();function Ao(t){let e={...t.metadata??{}};if(t.source===void 0)return e;if(e.source&&e.source!==t.source)throw new N(t.source,e.source);return e.source=t.source,e}s(Ao,"stampMetadata");function wo(){}s(wo,"ignoreDetachedFailure");async function kt(t,e,n,r={}){let o=_t({transport:r.transport,ephemeral:r.ephemeral??t.defaultEphemeral,brokerBound:typeof t.broker?.send=="function"}),i=Ao(r),a=await t.eventBus.dispatch(e,n,i,{notifySubscribers:o.notifySubscribers,awaitHandlers:o.awaitHandlers});if(o.deliveredVia==="broker"&&t.broker){let c=Promise.resolve(t.broker.send(a));o.awaitHandoff?await c:c.then(void 0,wo)}return o}s(kt,"sendOnArkRunTransport");var Io=1e3,On=0;function bo(){return On+=1,`ark-kernel-${Date.now()}-${On}`}s(bo,"nextKernelInstanceId");function Nn(t,e){let n=t.constructor?.name;return typeof n=="string"&&n.length>0?n:e}s(Nn,"portConstructorId");function Dn(t={}){let e=t.strict??!0,n=t.instanceId??bo(),r=t.profile??ct,o=t.maxHistorySize??Io,i=st(),a=ot(),c=t.metadata??lt(),d=t.auditTrail===void 0,u=t.auditTrail??Je({maxRecords:o}),l=t.eventContracts??rt(),y=t.eventBuffer===void 0&&t.outbox===void 0,f=t.eventBuffer??t.outbox??new le,m=t.projections??mt({auditTrail:u}),h=new L([Xe(r),...t.policies??[]]),p=s(()=>{it(i,a,{requireRegisteredTargets:!0})},"syncGraph"),B=t.ephemeral??!0,g=t.broker,D=new de({intentRegistry:i,dependencyGraph:a,policyEngine:h,strictRegistry:!0,validateIntentNaming:!0,auditTrail:u,eventContracts:l,strictEventContracts:t.strictEventContracts??e,requireKnownSource:t.requireKnownSource??!0,architectureProfile:r,enforceObservedLayerFlow:t.enforceObservedLayerFlow??(e?"hard":"off"),eventBuffer:f,instanceId:n,maxHistorySize:o,onPublish:t.autoApplyProjections===!1?void 0:async k=>{await m.apply(k)}}),Rt=ht(D,{auditTrail:u}),Ne=ft({registry:i,eventBus:D,graph:a}),T=xn(),Tn=typeof g?.send=="function",Mn=y?"InMemoryEventBuffer":Nn(f,"EventBufferStore"),_n=d?"InMemoryAuditStore":Nn(u,"AuditTrail"),Ln=qe({stores:[Z(Mn,"outbox"),Z(_n,"audit"),Z("InMemoryWorkflowStore","workflow")]}),De={instanceId:n,profile:r,registry:i,graph:a,metadata:c,auditTrail:u,eventContracts:l,eventBuffer:f,outbox:f,projections:m,policyEngine:h,eventBus:D,workflowEngine:Rt,observability:Ne,publisher(k){let M=D.createPublisher(k);return{source:M.source,publish:M.publish,send(S,Te,$n={}){return kt({eventBus:D,broker:g,defaultEphemeral:B},S,Te,{...$n,source:M.source})}}},send(k,M,S={}){return kt({eventBus:D,broker:g,defaultEphemeral:B},k,M,S)},register(k){return T.register(k)},resolve(k){return T.resolve(k)},resolveSingleton(k){return T.resolveSingleton(k)},getDependencyInformationPackage(){return v({kernelInstanceId:n,components:T.snapshotComponents()})},requestGraph(k){return Mt({kernelInstanceId:n,components:T.snapshotComponents()},k)},getInspectorSnapshot(k){return Ft({kernelInstanceId:n,host:k?.host,port:k?.port,package:{kernelInstanceId:n,components:T.snapshotComponents()},observability:Ne.report(),ephemeralDefault:B,brokerBound:Tn,hardening:Ln})},startInspector(k){return Cn({getInspectorSnapshot:s(S=>De.getInspectorSnapshot(S),"getInspectorSnapshot"),requestGraph:s(S=>De.requestGraph(S),"requestGraph"),async listInspectorOutbox(){let[S,Te]=await Promise.all([f.list("pending"),f.list("failed")]);return Y([...S,...Te],{sampleLimit:w})},async listInspectorWorkflows(){return ee(await Rt.list(),{sampleLimit:w})}},k)},syncGraph:p,manifest(){return p(),ut({registry:i,policyEngine:h,metadata:c,graph:a,profile:r,projections:m,eventContracts:l,observability:Ne})}};return De}s(Dn,"createArkKernel");var j=Symbol("ARK_KERNEL"),So=s(()=>(0,Oe.Inject)(j),"InjectArk"),E=class{static forRoot(e){let n=e&&"registry"in e?e:Dn(e);return{module:E,global:!0,providers:[{provide:j,useValue:n}],exports:[j]}}static forRootAsync(e){return{module:E,global:!0,providers:[{provide:j,useFactory:e.useFactory,inject:e.inject??[]}],exports:[j]}}};s(E,"ArkModule"),E=bt([(0,Oe.Module)({})],E);0&&(module.exports={ARK_KERNEL,ArkModule,InjectArk});
|
package/dist/nestjs/index.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { DynamicModule, InjectionToken, OptionalFactoryDependency } from '@nestjs/common';
|
|
2
|
-
import { A as ArkKernel, C as CreateArkKernelOptions } from '../types-
|
|
3
|
-
import '../types-
|
|
4
|
-
import '../configTypes-
|
|
2
|
+
import { A as ArkKernel, C as CreateArkKernelOptions } from '../types-DxvmJO-D.js';
|
|
3
|
+
import '../types-BK47clMl.js';
|
|
4
|
+
import '../configTypes-0eHpocR3.js';
|
|
5
5
|
|
|
6
6
|
/** Injection token for the Ark kernel instance. */
|
|
7
7
|
declare const ARK_KERNEL: unique symbol;
|