arkgate 4.8.1 → 4.8.2
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 +11 -0
- package/README.md +5 -3
- package/dist/{diagnosticCatalog-CSF4N3w8.d.ts → diagnosticCatalog-CPzH-MLN.d.ts} +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.js +1 -1
- package/dist/nestjs/index.cjs +1 -1
- package/dist/nestjs/index.js +1 -1
- package/dist/runtime/index.cjs +1 -1
- package/dist/runtime/index.d.ts +1 -1
- package/dist/runtime/index.js +1 -1
- package/docs/README.md +2 -2
- package/docs/agent-guide.md +10 -9
- package/docs/package-surface.md +3 -1
- package/package.json +1 -1
- package/server.json +2 -2
- package/templates/agent-skills/README.md +1 -1
- package/templates/agent-skills/ark-adopt/SKILL.md +41 -13
- package/templates/agent-skills/ark-architect/SKILL.md +4 -4
- package/templates/agent-skills/ark-autopilot/SKILL.md +22 -4
- package/templates/agent-skills/ark-contract/SKILL.md +7 -7
- package/templates/agent-skills/ark-coverage/SKILL.md +11 -5
- package/templates/agent-skills/ark-explain/SKILL.md +10 -4
- package/templates/agent-skills/ark-explore/SKILL.md +12 -4
- package/templates/agent-skills/ark-fix/SKILL.md +3 -3
- package/templates/agent-skills/ark-loop/SKILL.md +3 -3
- package/templates/agent-skills/ark-place/SKILL.md +12 -3
- package/templates/agent-skills/ark-runtime/SKILL.md +13 -11
- package/templates/agent-skills/ark-think/SKILL.md +13 -7
- package/templates/agent-skills/ark-upgrade/SKILL.md +12 -4
- package/templates/skills/ark-adopt.md +41 -13
- package/templates/skills/ark-architect.md +4 -4
- package/templates/skills/ark-autopilot.md +22 -4
- package/templates/skills/ark-contract.md +7 -7
- package/templates/skills/ark-coverage.md +11 -5
- package/templates/skills/ark-explain.md +10 -4
- package/templates/skills/ark-explore.md +12 -4
- package/templates/skills/ark-fix.md +3 -3
- package/templates/skills/ark-loop.md +3 -3
- package/templates/skills/ark-place.md +12 -3
- package/templates/skills/ark-runtime.md +13 -11
- package/templates/skills/ark-think.md +13 -7
- package/templates/skills/ark-upgrade.md +12 -4
package/dist/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
var fo=Object.defineProperty;var i=(e,t)=>fo(e,"name",{value:t,configurable:!0});var mo="4.8.1";var go=/(^|\/)(constants|types|enums|shared-types|shared\/(?:types|constants)|test-projects)(\/|\.|$)|(?:^|\/)[^/]*(?:constants|types)(?:\.[cm]?[jt]sx?)?$/i,yo=/(^|\/)(?:kernel(?:\/|$)|events?(?:\/|\.|$)|bootstrap(?:\.[cm]?[jt]sx?)?$|emitter(?:\.[cm]?[jt]sx?)?$)|(?:^|\/)(?:intents?|publish)(?:\/|\.|$)/i,ho=/(use-?cases?|usecases?|application|orchestrat|services?|handlers?)(\/|\.|$)/i;function Ao(e,t){let n=String(e??"").replace(/\\/g,"/").trim(),r=String(t?.fromLayer??""),s=String(t?.toLayer??"");return go.test(n)?"pure-shared":r==="PersistenceAdapters"&&(yo.test(n)||/events?|intents?|kernel|bootstrap/i.test(`${s} ${n}`))?"kernel-emit":ho.test(n)||(r==="DomainModel"||r==="ApplicationOrchestration")&&s==="PersistenceAdapters"?"use-case":"unknown"}i(Ao,"classifyLayerImportKind");function Ro(e){if(e.typeOnly||e.targetTypeOnlyExports||e.namedBindingsTypeOnly)return"Move the referenced type to a mutually allowed layer, use `import type`, then preflight again.";if(e.peerIsolation)return"Extract the shared dependency to a shared layer, test at the public interface, then preflight again.";let t=Ao(typeof e.target=="string"?e.target:"",{fromLayer:typeof e.fromLayer=="string"?e.fromLayer:void 0,toLayer:typeof e.toLayer=="string"?e.toLayer:void 0});return t==="pure-shared"?"Adopt the imported constants/types/pure module into DomainModel or SharedKernel (do not inject a port). Then preflight again.":t==="kernel-emit"?"Persistence must not emit. Inject a port or move the event map to SharedTypes; do not import kernel/events/bootstrap from a repository. Then preflight again.":t==="use-case"||e.portProofEligible?`Define a port in ${e.fromLayer??"the source layer"}, inject the ${e.toLayer??"outer-layer"} implementation, test at the public interface, then preflight again.`:"Classify the import: if it is constants/types/pure, adopt into DomainModel or SharedKernel; define a port only if the target is a real use-case. Then preflight again."}i(Ro,"layerImportNextAction");function ko(e){return typeof e.target=="string"&&e.target.trim().length>0?e.target.trim():void 0}i(ko,"arkRunCallSiteName");function Eo(e){let t=ko(e),n=typeof e.fromLayer=="string"&&e.fromLayer.length>0?e.fromLayer:void 0;switch(e.ruleId){case"ARKRUN_MISSING_ROOT":return t?`Import createStrictArkKernel from arkgate/runtime and call it in composition root ${t} listed in arkRun.compositionRoots, then preflight again.`:"Import createStrictArkKernel from arkgate/runtime (same npm package; @arkgate/runtime is deprecated) and call it in a composition root listed in arkRun.compositionRoots, then preflight again. Never mechanical-safe \u2014 factory placement is a design decision.";case"ARKRUN_KERNEL_IN_DOMAIN":return t?`Move the kernel import of ${t} out of ${n??"the Domain-role layer"} into a composition root or adapter. Import from arkgate/runtime, then preflight again.`:"Move the kernel import out of the Domain-role layer into a composition root or adapter. Import from arkgate/runtime (same npm package; @arkgate/runtime is deprecated), then preflight again. Never mechanical-safe.";case"ARKRUN_DIRECT_NEW":return t?`Resolve ${t} from the kernel instead of constructing it with new, then preflight again.`:"Resolve the type from the kernel instead of constructing it with new, then preflight again. Never mechanical-safe \u2014 rewiring construction is a design decision.";case"ARKRUN_UNDECLARED_EMIT":return t?`Add ${t} to raises or sends on the managed component, then preflight again.`:"Add the existing call-site name to raises or sends on the managed component, then preflight again. Mechanical-safe only when that literal already exists and the edit is the declaration list; inventing a new emit stays judgment.";case"ARKRUN_UNDECLARED_HANDLE":return t?`Add ${t} to reactsTo on the managed component, then preflight again.`:"Add the existing call-site name to reactsTo on the managed component, then preflight again. Mechanical-safe only when that literal already exists and the edit is the declaration list; inventing a new handle stays judgment.";case"ARKRUN_UNDECLARED_DEPEND":return t?`Add ${t} to uses on the managed component, then preflight again.`:"Add the existing call-site name to uses on the managed component, then preflight again. Mechanical-safe only when that literal already exists and the edit is the declaration list; inventing a new depend stays judgment.";case"ARKRUN_TRANSPORT_BYPASS":return t?`Send through the ArkRun kernel transport instead of importing ${t}, then preflight again.`:"Send through the ArkRun kernel transport instead of importing that broker or emitter, then preflight again. Never mechanical-safe \u2014 homemade buses stay judgment.";default:return`Resolve ${typeof e.ruleId=="string"&&e.ruleId.length>0?e.ruleId:"ARK_UNKNOWN"} without weakening ark.config.json, then run Ark again.`}}i(Eo,"arkRunNextAction");function pe(e){switch(e.ruleId){case"LAYER_IMPORT_VIOLATION":return Ro(e);case"FORBIDDEN_GLOBAL":return`Inject ${e.target??"the capability"} through a port, test at the public interface, then preflight again.`;case"CAPABILITY_VIOLATION":return`Define a ${String(e.capability??"capability")} port in ${e.fromLayer??"the walled layer"}, bind the implementation outside it, test at the public interface, then preflight again.`;case"CIRCULAR_DEPENDENCY":return"Extract the shared dependency into a third module, test at the public interface, then preflight again.";case"RAW_EVENT_PUBLISH":return"Publish through a registered intent creator, then run Ark again.";case"PUBLISH_MISSING_SOURCE":return"Add metadata.source to the publish call, then run Ark again.";case"ARKRULE_STRUCTURE":case"ARKRULE_INVARIANT":case"INVARIANT_UNCOVERED":return`Fix the structure or invariant for ${typeof e.arkruleId=="string"&&e.arkruleId.length>0?e.arkruleId:"the ArkRule"} (declared in ${typeof e.arkruleSource=="string"&&e.arkruleSource.length>0?e.arkruleSource:"arkrules/<Layer>.json"}), then preflight again. Do not demote the rule without a hash-bound policy acknowledgement.`;case"ARKRUN_MISSING_ROOT":case"ARKRUN_KERNEL_IN_DOMAIN":case"ARKRUN_DIRECT_NEW":case"ARKRUN_UNDECLARED_EMIT":case"ARKRUN_UNDECLARED_HANDLE":case"ARKRUN_UNDECLARED_DEPEND":case"ARKRUN_TRANSPORT_BYPASS":return Eo(e);case"ARKORDER_MISSING_PLANE":return typeof e.target=="string"&&e.target.length>0?`Import createOrderPlane from arkgate/order and call it in plane root ${e.target} listed in arkOrder.planeRoots, then preflight again.`:"Import createOrderPlane from arkgate/order and call it in a plane root listed in arkOrder.planeRoots, then preflight again. Never mechanical-safe \u2014 factory placement is a design decision.";case"ARKORDER_KERNEL_IN_DOMAIN":return"Move the arkgate/order import out of the Domain-role layer into a plane root or adapter, then preflight again. Never mechanical-safe.";case"ARKORDER_GENERIC_UPDATE":return"Use release() to freeze \u03BE or proposeRelease() for a pattern change with blast radius, then preflight again. Never mechanical-safe.";case"ARKORDER_TOO_MANY_PARAMS":return"Cut \u03BE to the slow keys that actually slave the rest, then preflight again. Never mechanical-safe.";case"ARKORDER_INGEST_WRITES_XI":return"Keep ingest results as absorb/escalate only. Change \u03BE with proposeRelease + release. Never mechanical-safe.";default:return typeof e.ruleId=="string"&&e.ruleId.startsWith("ARKRULE_")?`Fix the ArkRule ${typeof e.arkruleId=="string"?e.arkruleId:e.ruleId}, then preflight again.`:`Resolve ${typeof e.ruleId=="string"&&e.ruleId.length>0?e.ruleId:"ARK_UNKNOWN"} without weakening ark.config.json, then run Ark again.`}}i(pe,"deterministicNextAction");var Qt="1.5",yr="docs/diagnostics.md";function C(e){return typeof e=="string"&&e.length>0?e:void 0}i(C,"text");function gr(e,t){return Number.isInteger(e)&&Number(e)>0?Number(e):t}i(gr,"positiveInteger");function en(e){let t=typeof e.ruleId=="string"?e.ruleId:typeof e.code=="string"?e.code:void 0,n=typeof e.file=="string"?e.file:void 0,r=typeof e.fromLayer=="string"?e.fromLayer:void 0,s=typeof e.toLayer=="string"?e.toLayer:void 0,o=typeof e.target=="string"?e.target:void 0;return[t,n,r??"",s??"",o??""].join("|")}i(en,"adapterFindingTargetKey");function Zt(e){let t=new Map;return e.map(n=>{let r=en(n),s=(t.get(r)??0)+1;return t.set(r,s),s===1?r:`${r}#${s}`})}i(Zt,"adapterFindingOccurrenceTargetKeys");function hr(e){let t=2166136261;for(let n=0;n<e.length;n+=1)t^=e.charCodeAt(n),t=Math.imul(t,16777619);return`fnv1a-${(t>>>0).toString(16).padStart(8,"0")}`}i(hr,"adapterFindingRefFromTargetKey");function Ar(e){return`${yr}#${e}`}i(Ar,"adapterDocsCodePath");function So(e,t,n){return pe({ruleId:e,target:C(t.target)??C(n.target)??void 0,fromLayer:C(t.fromLayer)??void 0,toLayer:C(t.toLayer)??void 0,typeOnly:t.typeOnly===!0,targetTypeOnlyExports:t.targetTypeOnlyExports===!0,namedBindingsTypeOnly:t.namedBindingsTypeOnly===!0,portProofEligible:t.portProofEligible===!0,peerIsolation:t.peerIsolation===!0,sourcePureTypeModule:t.sourcePureTypeModule===!0,edgeKind:C(t.edgeKind)??void 0,capability:C(t.capability)??C(n.capability)??void 0,arkruleId:C(t.arkruleId)??void 0,arkruleSource:C(t.arkruleSource)??void 0})}i(So,"nextActionForDiagnostic");function Xt(e,t="error",n){let r=C(e.ruleId)??C(e.code)??"ARK_UNKNOWN",s=e.severity==="warning"||e.failsStrict===!1||e.typeOnly===!0&&e.peerIsolation!==!0?"warning":t,o={...C(e.target)?{target:C(e.target)}:{},...C(e.fromLayer)?{fromLayer:C(e.fromLayer)}:{},...C(e.toLayer)?{toLayer:C(e.toLayer)}:{},...typeof e.typeOnly=="boolean"?{typeOnly:e.typeOnly}:{},...typeof e.targetTypeOnlyExports=="boolean"?{targetTypeOnlyExports:e.targetTypeOnlyExports}:{},...typeof e.sourcePureTypeModule=="boolean"?{sourcePureTypeModule:e.sourcePureTypeModule}:{},...typeof e.namedBindingsTypeOnly=="boolean"?{namedBindingsTypeOnly:e.namedBindingsTypeOnly}:{},...typeof e.portProofEligible=="boolean"?{portProofEligible:e.portProofEligible}:{},...typeof e.peerIsolation=="boolean"?{peerIsolation:e.peerIsolation}:{},...C(e.capability)?{capability:C(e.capability)}:{},...C(e.edgeKind)?{edgeKind:C(e.edgeKind)}:{},...C(e.arkruleId)?{arkruleId:C(e.arkruleId)}:{},...C(e.arkruleSource)?{arkruleSource:C(e.arkruleSource)}:{}},a=n??en(e),l=hr(a);return{ruleId:r,severity:s,message:C(e.message)??r,location:{file:C(e.file)??"<unknown>",line:gr(e.line,1),column:gr(e.column,1)},evidence:o,nextAction:C(e.nextAction)??So(r,o,e),findingRef:l,targetKey:a,docsCodePath:Ar(r)}}i(Xt,"toAdapterDiagnostic");function Io(e){let t=e.completeness??"complete",n=e.mode??"lexical-compatibility";if(t==="complete"&&(e.completenessReasons?.length??0)>0)throw new Error("completenessReasons must be empty when completeness is complete.");let r=t==="complete"?[]:e.completenessReasons&&e.completenessReasons.length>0?e.completenessReasons.map(g=>({code:C(g.code)??"ANALYSIS_EVIDENCE_INCOMPLETE",message:C(g.message)??`Analysis ${t}: required evidence is incomplete.`,...C(g.file)?{file:C(g.file)}:{}})):[{code:t==="unavailable"?"ANALYSIS_UNAVAILABLE":"ANALYSIS_EVIDENCE_INCOMPLETE",message:`Analysis ${t}: required evidence is incomplete.`}],s={...C(e.policyHash)?{policyHash:C(e.policyHash)}:{},...C(e.resolverIdentity)?{resolverIdentity:C(e.resolverIdentity)}:{},...C(e.factsHash)?{factsHash:C(e.factsHash)}:{},...C(e.candidateTreeHash)?{candidateTreeHash:C(e.candidateTreeHash)}:{}};if(n==="resolved-candidate-facts"&&t!=="unavailable"){for(let g of["policyHash","resolverIdentity","factsHash","candidateTreeHash"])if(!s[g])throw new Error(`${g} is required for resolved ${t} adapter evidence.`)}let o=e.violations??[],a=e.warnings??[],l=Zt(o),c=Zt(a),p=[...o.map((g,u)=>Xt(g,"error",l[u])),...a.map((g,u)=>Xt(g,"warning",c[u]))],m={schemaVersion:Qt,completenessReasons:r,diagnostics:p};if(n==="resolved-candidate-facts"){if(t==="unavailable")return{...m,mode:n,valid:!1,completeness:t,...s};let g={policyHash:s.policyHash,resolverIdentity:s.resolverIdentity,factsHash:s.factsHash,candidateTreeHash:s.candidateTreeHash};return t==="complete"?{...m,mode:n,valid:e.valid,completeness:t,...g}:{...m,mode:n,valid:!1,completeness:t,...g}}return t==="complete"?{...m,mode:n,valid:e.valid,completeness:t,...s}:{...m,mode:n,valid:!1,completeness:t,...s}}i(Io,"createAdapterResult");var vo={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://unpkg.com/arkgate@3/schemas/ark.analysis-result.schema.json",title:"ArkGate analysis result",type:"object",additionalProperties:!1,required:["schemaVersion","mode","valid","completeness","completenessReasons","diagnostics"],allOf:[{if:{properties:{completeness:{enum:["partial","unavailable"]}},required:["completeness"]},then:{properties:{valid:{const:!1}}}},{if:{properties:{mode:{const:"resolved-candidate-facts"},completeness:{enum:["complete","partial"]}},required:["mode","completeness"]},then:{required:["policyHash","resolverIdentity","factsHash","candidateTreeHash"]}},{if:{properties:{completeness:{const:"complete"}},required:["completeness"]},then:{properties:{completenessReasons:{maxItems:0}}},else:{properties:{completenessReasons:{minItems:1}}}}],properties:{schemaVersion:{const:Qt},mode:{enum:["lexical-compatibility","resolved-candidate-facts"]},valid:{type:"boolean"},completeness:{enum:["complete","partial","unavailable"]},completenessReasons:{type:"array",items:{type:"object",additionalProperties:!1,required:["code","message"],properties:{code:{type:"string",minLength:1},message:{type:"string",minLength:1},file:{type:"string",minLength:1}}}},policyHash:{type:"string",minLength:1},resolverIdentity:{type:"string",minLength:1},factsHash:{type:"string",minLength:1},candidateTreeHash:{type:"string",minLength:1},diagnostics:{type:"array",items:{type:"object",additionalProperties:!1,required:["ruleId","severity","message","location","evidence"],properties:{ruleId:{type:"string",minLength:1},severity:{enum:["error","warning"]},message:{type:"string",minLength:1},location:{type:"object",additionalProperties:!1,required:["file","line","column"],properties:{file:{type:"string",minLength:1},line:{type:"integer",minimum:1},column:{type:"integer",minimum:1}}},evidence:{type:"object",additionalProperties:!1,properties:{target:{type:"string"},fromLayer:{type:"string"},toLayer:{type:"string"},typeOnly:{type:"boolean"},targetTypeOnlyExports:{type:"boolean"},sourcePureTypeModule:{type:"boolean"},namedBindingsTypeOnly:{type:"boolean"},portProofEligible:{type:"boolean"},peerIsolation:{type:"boolean"},capability:{type:"string",minLength:1},edgeKind:{type:"string",minLength:1},arkruleId:{type:"string",minLength:1},arkruleSource:{type:"string",minLength:1}}},nextAction:{type:"string",minLength:1},findingRef:{type:"string",minLength:1,pattern:"^fnv1a-[0-9a-f]{8}$"},targetKey:{type:"string",minLength:1},docsCodePath:{type:"string",minLength:1}}}}}};var bo="1.0",Rr="https://unpkg.com/arkgate@4/schemas/ark.project-identity.schema.json",Rt="^sha256:[a-f0-9]{64}$",kr={type:"object",additionalProperties:!1,properties:{expectedRoot:{type:"string",minLength:1,description:"Absolute expected workspace/project directory. The initial authoritative handshake requires the exact project root; descendant calls also require expectedProjectId."},expectedProjectId:{type:"string",pattern:Rt,description:"Project id previously returned by ark_identity or ark_manifest."}}},Er={type:"object",additionalProperties:!1,required:["status","authoritative"],properties:{status:{enum:["matched","unverified","mismatch"]},authoritative:{type:"boolean"},expectedRoot:{type:"string",minLength:1},expectedProjectId:{type:"string",pattern:Rt},code:{enum:["PROJECT_ROOT_MISMATCH","PROJECT_ID_MISMATCH","INVALID_PROJECT_EXPECTATION"]},message:{type:"string",minLength:1}}},Co={$schema:"https://json-schema.org/draft/2020-12/schema",$id:Rr,title:"ArkGate MCP project identity",description:"Stable project binding plus separate runtime and architecture-contract evidence.",type:"object",additionalProperties:!1,required:["schemaVersion","projectId","resolvedRoot","resolvedConfigPath","arkgateVersion","contractHash","contractSource","runtimeId","processStartedAt"],properties:{schemaVersion:{const:"1.0"},projectId:{type:"string",pattern:Rt},resolvedRoot:{type:"string",minLength:1},resolvedConfigPath:{type:"string",minLength:1},arkgateVersion:{type:"string",minLength:1},contractHash:{type:"string",pattern:Rt},contractSource:{enum:["project","default-profile","manifest"]},runtimeId:{type:"string",minLength:1},processStartedAt:{type:"string",format:"date-time"}},$defs:{expectation:kr,binding:Er}};function _o(e,t,n){if(!e||!t)throw new Error("Project identity requires resolvedRoot and resolvedConfigPath.");let r=n(JSON.stringify({resolvedRoot:e,resolvedConfigPath:t})).toLowerCase();if(!/^[a-f0-9]{64}$/.test(r))throw new Error("Project identity hash adapter must return 64 hexadecimal SHA-256 characters.");return`sha256:${r}`}i(_o,"createProjectId");function Oo(e){return{schemaVersion:"1.0",...e}}i(Oo,"createProjectIdentity");var nn=Object.freeze(["network","filesystem","clock","randomness","environment","process","persistence"]),sn=Object.freeze({fetch:"network",XMLHttpRequest:"network",Date:"clock","Date.now":"clock","Math.random":"randomness","process.env":"environment",process:"process"}),on=Object.freeze(Object.keys(sn).sort()),tn=Object.freeze({fs:"filesystem","node:fs":"filesystem","fs/promises":"filesystem","node:fs/promises":"filesystem","fs-extra":"filesystem","graceful-fs":"filesystem",memfs:"filesystem",chokidar:"filesystem",http:"network",https:"network",http2:"network",net:"network",tls:"network",dgram:"network",dns:"network","node:http":"network","node:https":"network","node:http2":"network","node:net":"network","node:tls":"network","node:dgram":"network","node:dns":"network",axios:"network",undici:"network","node-fetch":"network",got:"network",ky:"network",superagent:"network",ws:"network",process:"process","node:process":"process",child_process:"process","node:child_process":"process","@prisma/client":"persistence",prisma:"persistence",pg:"persistence",mysql:"persistence",mysql2:"persistence",mongodb:"persistence",mongoose:"persistence",sqlite3:"persistence","better-sqlite3":"persistence",redis:"persistence",ioredis:"persistence",typeorm:"persistence",knex:"persistence","drizzle-orm":"persistence",sequelize:"persistence",kysely:"persistence","@supabase/supabase-js":"persistence"}),rn=Object.freeze({process:Object.freeze(["process","node:process"])});function Ye(e){if(!e||e.startsWith(".")||e.startsWith("/"))return null;let t=tn[e];if(t)return t;let n=e.indexOf("/");if(n<0)return null;let r=e.slice(0,n),s=tn[r];if(s)return s;let o=e.indexOf("/",n+1);return o<0?null:tn[e.slice(0,o)]??null}i(Ye,"capabilityForModuleSpecifier");function Ie(e,t){for(let n of t)if(rn[n]?.includes(e))return n;return null}i(Ie,"forbiddenGlobalForModuleSpecifier");function kt(e){let t=e.split(".");for(let n=t.length;n>=1;n-=1){let r=t.slice(0,n).join("."),s=sn[r];if(s)return s}return null}i(kt,"capabilityForAmbientName");function Le(e){if(e?.pure===!0)return[...nn].sort();let n=(e?.capabilities?.deny??[]).filter(r=>nn.includes(r));return[...new Set(n)].sort()}i(Le,"effectiveCapabilityDeny");function We(e,t){if(t.length===0)return!1;let n=new Set(t),r=e.split(".");for(let s=r.length;s>=1;s-=1)if(n.has(r.slice(0,s).join(".")))return!0;return!1}i(We,"ambientCoveredByForbiddenGlobals");function Et(e){let t=new Set,n=new Set,r=Object.keys(sn);for(let s of e?.forbiddenGlobals??[]){let o=r.filter(a=>a===s||a.startsWith(`${s}.`));if(o.length===0)n.add(s);else for(let a of o)t.add(`ambient:${a}`);for(let a of rn[s]??[])t.add(`import-exact:${a}`)}for(let s of Le(e)){if(t.add(`import:${s}`),s==="process")for(let o of rn.process)t.add(`import-exact:${o}`);for(let o of r)kt(o)===s&&t.add(`ambient:${o}`)}return{atoms:[...t].sort(),rawGlobals:[...n].sort()}}i(Et,"loweredLayerCoverage");var Sr=new Map;function Ir(e){return/[.*+?^${}()|[\]\\]/.test(e)?`\\${e}`:e}i(Ir,"escapeLiteral");function St(e){let t="";for(let n=0;n<e.length;n+=1){let r=e[n];if(r==="\\"&&n+1<e.length){let s=e[n+1];if("*?{}[],".includes(s)||s==="\\"){t+="\\"+s,n+=1;continue}t+="/";continue}t+=r}return t}i(St,"normalizeGlobSeparators");function xo(e){let t=0;for(let n=0;n<e.length;n+=1){let r=e[n];if(r==="\\"){n+=1;continue}if(r==="{")t+=1;else if(r==="}"&&(t-=1,t<0))return!1}return t===0}i(xo,"bracesBalanced");function Ce(e){let t=Sr.get(e);if(t)return t;let n=St(e),r=xo(n),s="",o=0;for(let l=0;l<n.length;l+=1){let c=n[l];c==="\\"&&l+1<n.length?(s+=Ir(n[l+1]),l+=1):c==="*"?n[l+1]==="*"?n[l+2]==="/"?(s+="(?:.*/)?",l+=2):(s+=".*",l+=1):s+="[^/]*":c==="?"?s+="[^/]":c==="{"&&r?(s+="(?:",o+=1):c==="}"&&r&&o>0?(s+=")",o-=1):c===","&&r&&o>0?s+="|":s+=Ir(c)}let a=new RegExp(`^${s}$`);return Sr.set(e,a),a}i(Ce,"globToRegExp");function To(e){return St(String(e)).split("/").filter(Boolean).filter(n=>n!=="**"&&n!=="*"&&!n.includes("*")&&!n.includes("?")&&!n.includes("{")&&!n.includes("["))}i(To,"concreteGlobSegments");function an(e,t){let n=St(String(e)),r=To(n),s=n.replace(/\*/g,"").length,o=r.length*1e4+s;if(t==null||t==="")return o;let a=String(t).split(/[/\\]/).filter(Boolean);if(r.length===0)return s;let l=0,c=-1;for(let p of r){let m=-1;for(let g=l;g<a.length;g+=1)if(a[g]===p){m=g;break}if(m<0)return o;c=m,l=m+1}return(c+1)*1e6+r.length*1e4+s}i(an,"patternSpecificity");function ie(e,t){let n=String(e).split(/[/\\]/).join("/"),r,s=-1;for(let o of t??[])if(!(o.exclude??[]).some(a=>Ce(a).test(n))){for(let a of o.patterns??[])if(Ce(a).test(n)){let l=an(a,n);l>s&&(s=l,r=o.name)}}return r}i(ie,"layerForRelativePath");function vr(e,t){if(!t?.length)return;let n=String(e).split(/[/\\]/).filter(Boolean),r=new Set(t.map(s=>String(s).toLowerCase()));for(let s=0;s<n.length-1;s+=1)if(r.has(n[s].toLowerCase()))return`${n[s].toLowerCase()}/${n[s+1].toLowerCase()}`}i(vr,"sliceIdForPath");function No(e){let t=new Set;for(let n of e??[]){let s=St(String(n)).split("/").filter(Boolean);for(let o=0;o<s.length;o+=1){let a=s[o];if((a==="**"||a==="*")&&o>0){let l=s[o-1];l&&!l.includes("*")&&!l.includes("{")&&!l.includes("}")&&t.add(l)}}}return[...t]}i(No,"inferSliceFoldersFromPatterns");function Po(e,t,n){if(Array.isArray(e.sliceFolders)&&e.sliceFolders.length>0)return e.sliceFolders.filter(s=>typeof s=="string"&&s.length>0);let r=(n??[]).find(s=>s.name===t);return No(r?.patterns)}i(Po,"resolveSliceFolders");function Lo(e){return!e.fromPath||!e.toPath||e.folderCount<=0||!e.fromSlice||!e.toSlice?!0:e.fromSlice!==e.toSlice}i(Lo,"peerIsolationMustDeny");function me(e,t,n,r){for(let s of e??[])if(!(s.from!==t||s.to!==n)&&s.allowed===!1){if(s.peerIsolation){let o=r?.fromPath,a=r?.toPath,l=Po(s,t,r?.layers),c=o&&a?vr(o,l):void 0,p=o&&a?vr(a,l):void 0;if(Lo({fromPath:o,toPath:a,folderCount:l.length,fromSlice:c,toSlice:p}))return s;continue}if(t!==n)return s}}i(me,"findDeniedEdgeRule");function we(e,t){return t&&e.isStringLiteralLike(t)?t.text:void 0}i(we,"literalText");function _r(e,t){return e.getLineAndCharacterOfPosition(t.getStart(e)).line+1}i(_r,"lineOf");function br(e,t){if(e.isImportDeclaration(t)){let r=t.importClause;if(!r)return!1;if(r.isTypeOnly)return!0;let s=r.namedBindings;return!!(s&&e.isNamedImports(s)&&s.elements.length>0&&s.elements.every(o=>o.isTypeOnly))}if(t.isTypeOnly)return!0;let n=t.exportClause;return!!(n&&e.isNamedExports(n)&&n.elements.length>0&&n.elements.every(r=>r.isTypeOnly))}i(br,"isTypeOnlyReference");function Or(e,t){let n={noLib:!0,noResolve:!0,target:e.ScriptTarget.Latest},r=e.createCompilerHost(n,!0);return r.getSourceFile=s=>s===t.fileName?t:void 0,r.fileExists=s=>s===t.fileName,r.readFile=s=>s===t.fileName?t.text:void 0,e.createProgram([t.fileName],n,r).getTypeChecker()}i(Or,"singleFileChecker");function ln(e,t){try{return e.getSymbolAtLocation(t)}catch{return}}i(ln,"symbolAt");function cn(e,t,n,r){let s=r.parent&&e.isShorthandPropertyAssignment(r.parent)&&r.parent.name===r,o;try{o=s?t.getShorthandAssignmentValueSymbol(r.parent):ln(t,r)}catch{o=void 0}return!!o?.declarations?.some(a=>a.getSourceFile().fileName===n.fileName)}i(cn,"localDeclaration");function De(e,t){let n,r=[],s=i((a,l,c,p=!1)=>r.push({specifier:c,kind:l,line:_r(t,a),typeOnly:p,unresolved:c===void 0,node:a}),"add"),o=i(a=>{if(e.isImportDeclaration(a))s(a,"import",we(e,a.moduleSpecifier),br(e,a));else if(e.isExportDeclaration(a)&&a.moduleSpecifier)s(a,"export",we(e,a.moduleSpecifier),br(e,a));else if(e.isImportEqualsDeclaration(a)&&e.isExternalModuleReference(a.moduleReference))s(a,"require",we(e,a.moduleReference.expression),a.isTypeOnly===!0);else if(e.isCallExpression(a)){let l=a.expression.kind===e.SyntaxKind.ImportKeyword,p=e.isIdentifier(a.expression)&&a.expression.text==="require"&&!cn(e,n??(n=Or(e,t)),t,a.expression);(l||p)&&s(a,p?"require":"dynamic-import",we(e,a.arguments[0]))}e.forEachChild(a,o)},"visit");return o(t),r}i(De,"extractSemanticDependencies");function wo(e,t){let n=[],r=t;for(;e.isPropertyAccessExpression(r)||e.isElementAccessExpression(r);){if(e.isPropertyAccessExpression(r))n.unshift(r.name.text);else{let s=we(e,r.argumentExpression);if(s===void 0)return;n.unshift(s)}r=r.expression}if(e.isIdentifier(r))return n.unshift(r.text),{root:r,segments:n}}i(wo,"staticAccessPath");function Do(e,t){let n=t.parent;return e.isPropertyAccessExpression(n)||e.isElementAccessExpression(n)?!1:e.isExpressionNode(t)&&!e.isInTypeQuery(t)||e.isShorthandPropertyAssignment(n)&&n.name===t}i(Do,"runtimeIdentifierReference");function Cr(e,t){let n=t[0]==="globalThis"?t.slice(1):t;for(let r=n.length;r>=1;r-=1){let s=n.slice(0,r).join(".");if(e.has(s))return s}}i(Cr,"bestForbiddenMatch");function Me(e,t,n){if(n.length===0)return[];let r=new Set(n),s=Or(e,t),o=new Map,a=new Set;for(let u of t.statements)if(e.isVariableStatement(u))for(let d of u.declarationList.declarations)e.isIdentifier(d.name)&&a.add(d.name.text);let l=i(u=>{let d=wo(e,u);if(!d)return;let f=ln(s,d.root),y=f?o.get(f):void 0;return y?[...y,...d.segments.slice(1)]:cn(e,s,t,d.root)||a.has(d.root.text)?void 0:d.segments},"resolvePath");for(let u of t.statements)if(e.isVariableStatement(u))for(let d of u.declarationList.declarations){if(!d.initializer||!e.isIdentifier(d.name))continue;let f=l(d.initializer),y=ln(s,d.name);!f||!y||o.set(y,f)}let c=[],p=new Set,m=i((u,d)=>{let f=_r(t,d),y=`${u}:${d.getStart(t)}`;p.has(y)||(p.add(y),c.push({name:u,line:f,node:d}))},"flag"),g=i(u=>{let d=u.parent&&(e.isPropertyAccessExpression(u.parent)||e.isElementAccessExpression(u.parent))&&u.parent.expression===u;if((e.isPropertyAccessExpression(u)||e.isElementAccessExpression(u))&&!d){let f=l(u),y=f?Cr(r,f):void 0;y&&m(y,u)}else e.isIdentifier(u)&&r.has(u.text)&&Do(e,u)&&!cn(e,s,t,u)&&m(u.text,u);if(e.isVariableDeclaration(u)&&e.isObjectBindingPattern(u.name)&&u.initializer){let f=l(u.initializer);if(f)for(let y of u.name.elements){if(!e.isIdentifier(y.name))continue;let I=y.propertyName?we(e,y.propertyName)??y.propertyName.text:y.name.text,N=Cr(r,[...f,I]);N&&m(N,u.initializer)}}e.forEachChild(u,g)},"visit");return g(t),c}i(Me,"collectForbiddenCapabilityUses");function dn(e,t,n){let r=[];for(let s of n?.dependencies??De(e,t)){if(s.typeOnly||!s.specifier)continue;let o=Ye(s.specifier);o&&r.push({capability:o,symbol:s.specifier,line:s.line,source:"import-based"})}for(let s of n?.ambientUses??Me(e,t,on)){let o=kt(s.name);o&&r.push({capability:o,symbol:s.name,line:s.line,source:"ambient-global"})}return r.sort((s,o)=>s.line-o.line||s.capability.localeCompare(o.capability)||s.symbol.localeCompare(o.symbol))}i(dn,"collectCapabilityUses");var un={RAW_EVENT_PUBLISH:"Publish through a registered intent creator; raw event objects or intent strings bypass Ark contracts and tooling.",PUBLISH_MISSING_SOURCE:"Strict Ark publish calls must include metadata.source."},pn=Object.freeze([{layer:"DomainModel",prefixes:["Domain."]},{layer:"ApplicationOrchestration",prefixes:["Application."]},{layer:"PersistenceAdapters",prefixes:["Adapter.Persistence.","Adapter.Repository."]},{layer:"IntegrationAdapters",prefixes:["Adapter.Integration.","Adapter.External."]},{layer:"WorkflowSagaEngine",prefixes:["Workflow."]},{layer:"BackgroundJobsScheduling",prefixes:["Job."]},{layer:"PresentationAdapters",prefixes:["Presentation.","Adapter.Presentation.","Adapter.Api."]},{layer:"ReportingReadModels",prefixes:["Reporting."]},{layer:"ExtensibilityMetadata",prefixes:["Metadata."]},{layer:"SecurityAuditObservability",prefixes:["Security.","Audit.","Observability."]},{layer:"Kernel",prefixes:["Kernel."]}]);function fn(e,t){return t.flatMap((r,s)=>(r.prefixes??r.intentPrefixes??[]).map(o=>({layer:r.name,layerIndex:s,prefix:o.endsWith(".")?o:`${o}.`}))).filter(({prefix:r})=>e.startsWith(r)).sort((r,s)=>s.prefix.length-r.prefix.length||r.layerIndex-s.layerIndex)[0]?.layer}i(fn,"resolveIntentLayer");function _e(e){return/^(Domain|Application|Adapter|Workflow|Job|Presentation|Reporting|Metadata|Security|Audit|Observability|Kernel)\.[A-Za-z0-9_.]+$/.test(e)}i(_e,"looksLikeArkIntent");function Je(e){if(!e.publishCall)return[];let t=[];return(e.rawIntentName!==void 0&&_e(e.rawIntentName)||e.objectHasIntent)&&t.push({ruleId:"RAW_EVENT_PUBLISH",message:un.RAW_EVENT_PUBLISH}),e.arkPublishCandidate&&!e.hasSource&&t.push({ruleId:"PUBLISH_MISSING_SOURCE",message:un.PUBLISH_MISSING_SOURCE}),t}i(Je,"classifyPublishFacts");function V(e,t,n){return{ruleId:e,code:e,message:t,...n}}i(V,"violation");function Fe(e,t){return e.slice(0,t).split(`
|
|
1
|
+
var fo=Object.defineProperty;var i=(e,t)=>fo(e,"name",{value:t,configurable:!0});var mo="4.8.2";var go=/(^|\/)(constants|types|enums|shared-types|shared\/(?:types|constants)|test-projects)(\/|\.|$)|(?:^|\/)[^/]*(?:constants|types)(?:\.[cm]?[jt]sx?)?$/i,yo=/(^|\/)(?:kernel(?:\/|$)|events?(?:\/|\.|$)|bootstrap(?:\.[cm]?[jt]sx?)?$|emitter(?:\.[cm]?[jt]sx?)?$)|(?:^|\/)(?:intents?|publish)(?:\/|\.|$)/i,ho=/(use-?cases?|usecases?|application|orchestrat|services?|handlers?)(\/|\.|$)/i;function Ao(e,t){let n=String(e??"").replace(/\\/g,"/").trim(),r=String(t?.fromLayer??""),s=String(t?.toLayer??"");return go.test(n)?"pure-shared":r==="PersistenceAdapters"&&(yo.test(n)||/events?|intents?|kernel|bootstrap/i.test(`${s} ${n}`))?"kernel-emit":ho.test(n)||(r==="DomainModel"||r==="ApplicationOrchestration")&&s==="PersistenceAdapters"?"use-case":"unknown"}i(Ao,"classifyLayerImportKind");function Ro(e){if(e.typeOnly||e.targetTypeOnlyExports||e.namedBindingsTypeOnly)return"Move the referenced type to a mutually allowed layer, use `import type`, then preflight again.";if(e.peerIsolation)return"Extract the shared dependency to a shared layer, test at the public interface, then preflight again.";let t=Ao(typeof e.target=="string"?e.target:"",{fromLayer:typeof e.fromLayer=="string"?e.fromLayer:void 0,toLayer:typeof e.toLayer=="string"?e.toLayer:void 0});return t==="pure-shared"?"Adopt the imported constants/types/pure module into DomainModel or SharedKernel (do not inject a port). Then preflight again.":t==="kernel-emit"?"Persistence must not emit. Inject a port or move the event map to SharedTypes; do not import kernel/events/bootstrap from a repository. Then preflight again.":t==="use-case"||e.portProofEligible?`Define a port in ${e.fromLayer??"the source layer"}, inject the ${e.toLayer??"outer-layer"} implementation, test at the public interface, then preflight again.`:"Classify the import: if it is constants/types/pure, adopt into DomainModel or SharedKernel; define a port only if the target is a real use-case. Then preflight again."}i(Ro,"layerImportNextAction");function ko(e){return typeof e.target=="string"&&e.target.trim().length>0?e.target.trim():void 0}i(ko,"arkRunCallSiteName");function Eo(e){let t=ko(e),n=typeof e.fromLayer=="string"&&e.fromLayer.length>0?e.fromLayer:void 0;switch(e.ruleId){case"ARKRUN_MISSING_ROOT":return t?`Import createStrictArkKernel from arkgate/runtime and call it in composition root ${t} listed in arkRun.compositionRoots, then preflight again.`:"Import createStrictArkKernel from arkgate/runtime (same npm package; @arkgate/runtime is deprecated) and call it in a composition root listed in arkRun.compositionRoots, then preflight again. Never mechanical-safe \u2014 factory placement is a design decision.";case"ARKRUN_KERNEL_IN_DOMAIN":return t?`Move the kernel import of ${t} out of ${n??"the Domain-role layer"} into a composition root or adapter. Import from arkgate/runtime, then preflight again.`:"Move the kernel import out of the Domain-role layer into a composition root or adapter. Import from arkgate/runtime (same npm package; @arkgate/runtime is deprecated), then preflight again. Never mechanical-safe.";case"ARKRUN_DIRECT_NEW":return t?`Resolve ${t} from the kernel instead of constructing it with new, then preflight again.`:"Resolve the type from the kernel instead of constructing it with new, then preflight again. Never mechanical-safe \u2014 rewiring construction is a design decision.";case"ARKRUN_UNDECLARED_EMIT":return t?`Add ${t} to raises or sends on the managed component, then preflight again.`:"Add the existing call-site name to raises or sends on the managed component, then preflight again. Mechanical-safe only when that literal already exists and the edit is the declaration list; inventing a new emit stays judgment.";case"ARKRUN_UNDECLARED_HANDLE":return t?`Add ${t} to reactsTo on the managed component, then preflight again.`:"Add the existing call-site name to reactsTo on the managed component, then preflight again. Mechanical-safe only when that literal already exists and the edit is the declaration list; inventing a new handle stays judgment.";case"ARKRUN_UNDECLARED_DEPEND":return t?`Add ${t} to uses on the managed component, then preflight again.`:"Add the existing call-site name to uses on the managed component, then preflight again. Mechanical-safe only when that literal already exists and the edit is the declaration list; inventing a new depend stays judgment.";case"ARKRUN_TRANSPORT_BYPASS":return t?`Send through the ArkRun kernel transport instead of importing ${t}, then preflight again.`:"Send through the ArkRun kernel transport instead of importing that broker or emitter, then preflight again. Never mechanical-safe \u2014 homemade buses stay judgment.";default:return`Resolve ${typeof e.ruleId=="string"&&e.ruleId.length>0?e.ruleId:"ARK_UNKNOWN"} without weakening ark.config.json, then run Ark again.`}}i(Eo,"arkRunNextAction");function pe(e){switch(e.ruleId){case"LAYER_IMPORT_VIOLATION":return Ro(e);case"FORBIDDEN_GLOBAL":return`Inject ${e.target??"the capability"} through a port, test at the public interface, then preflight again.`;case"CAPABILITY_VIOLATION":return`Define a ${String(e.capability??"capability")} port in ${e.fromLayer??"the walled layer"}, bind the implementation outside it, test at the public interface, then preflight again.`;case"CIRCULAR_DEPENDENCY":return"Extract the shared dependency into a third module, test at the public interface, then preflight again.";case"RAW_EVENT_PUBLISH":return"Publish through a registered intent creator, then run Ark again.";case"PUBLISH_MISSING_SOURCE":return"Add metadata.source to the publish call, then run Ark again.";case"ARKRULE_STRUCTURE":case"ARKRULE_INVARIANT":case"INVARIANT_UNCOVERED":return`Fix the structure or invariant for ${typeof e.arkruleId=="string"&&e.arkruleId.length>0?e.arkruleId:"the ArkRule"} (declared in ${typeof e.arkruleSource=="string"&&e.arkruleSource.length>0?e.arkruleSource:"arkrules/<Layer>.json"}), then preflight again. Do not demote the rule without a hash-bound policy acknowledgement.`;case"ARKRUN_MISSING_ROOT":case"ARKRUN_KERNEL_IN_DOMAIN":case"ARKRUN_DIRECT_NEW":case"ARKRUN_UNDECLARED_EMIT":case"ARKRUN_UNDECLARED_HANDLE":case"ARKRUN_UNDECLARED_DEPEND":case"ARKRUN_TRANSPORT_BYPASS":return Eo(e);case"ARKORDER_MISSING_PLANE":return typeof e.target=="string"&&e.target.length>0?`Import createOrderPlane from arkgate/order and call it in plane root ${e.target} listed in arkOrder.planeRoots, then preflight again.`:"Import createOrderPlane from arkgate/order and call it in a plane root listed in arkOrder.planeRoots, then preflight again. Never mechanical-safe \u2014 factory placement is a design decision.";case"ARKORDER_KERNEL_IN_DOMAIN":return"Move the arkgate/order import out of the Domain-role layer into a plane root or adapter, then preflight again. Never mechanical-safe.";case"ARKORDER_GENERIC_UPDATE":return"Use release() to freeze \u03BE or proposeRelease() for a pattern change with blast radius, then preflight again. Never mechanical-safe.";case"ARKORDER_TOO_MANY_PARAMS":return"Cut \u03BE to the slow keys that actually slave the rest, then preflight again. Never mechanical-safe.";case"ARKORDER_INGEST_WRITES_XI":return"Keep ingest results as absorb/escalate only. Change \u03BE with proposeRelease + release. Never mechanical-safe.";default:return typeof e.ruleId=="string"&&e.ruleId.startsWith("ARKRULE_")?`Fix the ArkRule ${typeof e.arkruleId=="string"?e.arkruleId:e.ruleId}, then preflight again.`:`Resolve ${typeof e.ruleId=="string"&&e.ruleId.length>0?e.ruleId:"ARK_UNKNOWN"} without weakening ark.config.json, then run Ark again.`}}i(pe,"deterministicNextAction");var Qt="1.5",yr="docs/diagnostics.md";function C(e){return typeof e=="string"&&e.length>0?e:void 0}i(C,"text");function gr(e,t){return Number.isInteger(e)&&Number(e)>0?Number(e):t}i(gr,"positiveInteger");function en(e){let t=typeof e.ruleId=="string"?e.ruleId:typeof e.code=="string"?e.code:void 0,n=typeof e.file=="string"?e.file:void 0,r=typeof e.fromLayer=="string"?e.fromLayer:void 0,s=typeof e.toLayer=="string"?e.toLayer:void 0,o=typeof e.target=="string"?e.target:void 0;return[t,n,r??"",s??"",o??""].join("|")}i(en,"adapterFindingTargetKey");function Zt(e){let t=new Map;return e.map(n=>{let r=en(n),s=(t.get(r)??0)+1;return t.set(r,s),s===1?r:`${r}#${s}`})}i(Zt,"adapterFindingOccurrenceTargetKeys");function hr(e){let t=2166136261;for(let n=0;n<e.length;n+=1)t^=e.charCodeAt(n),t=Math.imul(t,16777619);return`fnv1a-${(t>>>0).toString(16).padStart(8,"0")}`}i(hr,"adapterFindingRefFromTargetKey");function Ar(e){return`${yr}#${e}`}i(Ar,"adapterDocsCodePath");function So(e,t,n){return pe({ruleId:e,target:C(t.target)??C(n.target)??void 0,fromLayer:C(t.fromLayer)??void 0,toLayer:C(t.toLayer)??void 0,typeOnly:t.typeOnly===!0,targetTypeOnlyExports:t.targetTypeOnlyExports===!0,namedBindingsTypeOnly:t.namedBindingsTypeOnly===!0,portProofEligible:t.portProofEligible===!0,peerIsolation:t.peerIsolation===!0,sourcePureTypeModule:t.sourcePureTypeModule===!0,edgeKind:C(t.edgeKind)??void 0,capability:C(t.capability)??C(n.capability)??void 0,arkruleId:C(t.arkruleId)??void 0,arkruleSource:C(t.arkruleSource)??void 0})}i(So,"nextActionForDiagnostic");function Xt(e,t="error",n){let r=C(e.ruleId)??C(e.code)??"ARK_UNKNOWN",s=e.severity==="warning"||e.failsStrict===!1||e.typeOnly===!0&&e.peerIsolation!==!0?"warning":t,o={...C(e.target)?{target:C(e.target)}:{},...C(e.fromLayer)?{fromLayer:C(e.fromLayer)}:{},...C(e.toLayer)?{toLayer:C(e.toLayer)}:{},...typeof e.typeOnly=="boolean"?{typeOnly:e.typeOnly}:{},...typeof e.targetTypeOnlyExports=="boolean"?{targetTypeOnlyExports:e.targetTypeOnlyExports}:{},...typeof e.sourcePureTypeModule=="boolean"?{sourcePureTypeModule:e.sourcePureTypeModule}:{},...typeof e.namedBindingsTypeOnly=="boolean"?{namedBindingsTypeOnly:e.namedBindingsTypeOnly}:{},...typeof e.portProofEligible=="boolean"?{portProofEligible:e.portProofEligible}:{},...typeof e.peerIsolation=="boolean"?{peerIsolation:e.peerIsolation}:{},...C(e.capability)?{capability:C(e.capability)}:{},...C(e.edgeKind)?{edgeKind:C(e.edgeKind)}:{},...C(e.arkruleId)?{arkruleId:C(e.arkruleId)}:{},...C(e.arkruleSource)?{arkruleSource:C(e.arkruleSource)}:{}},a=n??en(e),l=hr(a);return{ruleId:r,severity:s,message:C(e.message)??r,location:{file:C(e.file)??"<unknown>",line:gr(e.line,1),column:gr(e.column,1)},evidence:o,nextAction:C(e.nextAction)??So(r,o,e),findingRef:l,targetKey:a,docsCodePath:Ar(r)}}i(Xt,"toAdapterDiagnostic");function Io(e){let t=e.completeness??"complete",n=e.mode??"lexical-compatibility";if(t==="complete"&&(e.completenessReasons?.length??0)>0)throw new Error("completenessReasons must be empty when completeness is complete.");let r=t==="complete"?[]:e.completenessReasons&&e.completenessReasons.length>0?e.completenessReasons.map(g=>({code:C(g.code)??"ANALYSIS_EVIDENCE_INCOMPLETE",message:C(g.message)??`Analysis ${t}: required evidence is incomplete.`,...C(g.file)?{file:C(g.file)}:{}})):[{code:t==="unavailable"?"ANALYSIS_UNAVAILABLE":"ANALYSIS_EVIDENCE_INCOMPLETE",message:`Analysis ${t}: required evidence is incomplete.`}],s={...C(e.policyHash)?{policyHash:C(e.policyHash)}:{},...C(e.resolverIdentity)?{resolverIdentity:C(e.resolverIdentity)}:{},...C(e.factsHash)?{factsHash:C(e.factsHash)}:{},...C(e.candidateTreeHash)?{candidateTreeHash:C(e.candidateTreeHash)}:{}};if(n==="resolved-candidate-facts"&&t!=="unavailable"){for(let g of["policyHash","resolverIdentity","factsHash","candidateTreeHash"])if(!s[g])throw new Error(`${g} is required for resolved ${t} adapter evidence.`)}let o=e.violations??[],a=e.warnings??[],l=Zt(o),c=Zt(a),p=[...o.map((g,u)=>Xt(g,"error",l[u])),...a.map((g,u)=>Xt(g,"warning",c[u]))],m={schemaVersion:Qt,completenessReasons:r,diagnostics:p};if(n==="resolved-candidate-facts"){if(t==="unavailable")return{...m,mode:n,valid:!1,completeness:t,...s};let g={policyHash:s.policyHash,resolverIdentity:s.resolverIdentity,factsHash:s.factsHash,candidateTreeHash:s.candidateTreeHash};return t==="complete"?{...m,mode:n,valid:e.valid,completeness:t,...g}:{...m,mode:n,valid:!1,completeness:t,...g}}return t==="complete"?{...m,mode:n,valid:e.valid,completeness:t,...s}:{...m,mode:n,valid:!1,completeness:t,...s}}i(Io,"createAdapterResult");var vo={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://unpkg.com/arkgate@3/schemas/ark.analysis-result.schema.json",title:"ArkGate analysis result",type:"object",additionalProperties:!1,required:["schemaVersion","mode","valid","completeness","completenessReasons","diagnostics"],allOf:[{if:{properties:{completeness:{enum:["partial","unavailable"]}},required:["completeness"]},then:{properties:{valid:{const:!1}}}},{if:{properties:{mode:{const:"resolved-candidate-facts"},completeness:{enum:["complete","partial"]}},required:["mode","completeness"]},then:{required:["policyHash","resolverIdentity","factsHash","candidateTreeHash"]}},{if:{properties:{completeness:{const:"complete"}},required:["completeness"]},then:{properties:{completenessReasons:{maxItems:0}}},else:{properties:{completenessReasons:{minItems:1}}}}],properties:{schemaVersion:{const:Qt},mode:{enum:["lexical-compatibility","resolved-candidate-facts"]},valid:{type:"boolean"},completeness:{enum:["complete","partial","unavailable"]},completenessReasons:{type:"array",items:{type:"object",additionalProperties:!1,required:["code","message"],properties:{code:{type:"string",minLength:1},message:{type:"string",minLength:1},file:{type:"string",minLength:1}}}},policyHash:{type:"string",minLength:1},resolverIdentity:{type:"string",minLength:1},factsHash:{type:"string",minLength:1},candidateTreeHash:{type:"string",minLength:1},diagnostics:{type:"array",items:{type:"object",additionalProperties:!1,required:["ruleId","severity","message","location","evidence"],properties:{ruleId:{type:"string",minLength:1},severity:{enum:["error","warning"]},message:{type:"string",minLength:1},location:{type:"object",additionalProperties:!1,required:["file","line","column"],properties:{file:{type:"string",minLength:1},line:{type:"integer",minimum:1},column:{type:"integer",minimum:1}}},evidence:{type:"object",additionalProperties:!1,properties:{target:{type:"string"},fromLayer:{type:"string"},toLayer:{type:"string"},typeOnly:{type:"boolean"},targetTypeOnlyExports:{type:"boolean"},sourcePureTypeModule:{type:"boolean"},namedBindingsTypeOnly:{type:"boolean"},portProofEligible:{type:"boolean"},peerIsolation:{type:"boolean"},capability:{type:"string",minLength:1},edgeKind:{type:"string",minLength:1},arkruleId:{type:"string",minLength:1},arkruleSource:{type:"string",minLength:1}}},nextAction:{type:"string",minLength:1},findingRef:{type:"string",minLength:1,pattern:"^fnv1a-[0-9a-f]{8}$"},targetKey:{type:"string",minLength:1},docsCodePath:{type:"string",minLength:1}}}}}};var bo="1.0",Rr="https://unpkg.com/arkgate@4/schemas/ark.project-identity.schema.json",Rt="^sha256:[a-f0-9]{64}$",kr={type:"object",additionalProperties:!1,properties:{expectedRoot:{type:"string",minLength:1,description:"Absolute expected workspace/project directory. The initial authoritative handshake requires the exact project root; descendant calls also require expectedProjectId."},expectedProjectId:{type:"string",pattern:Rt,description:"Project id previously returned by ark_identity or ark_manifest."}}},Er={type:"object",additionalProperties:!1,required:["status","authoritative"],properties:{status:{enum:["matched","unverified","mismatch"]},authoritative:{type:"boolean"},expectedRoot:{type:"string",minLength:1},expectedProjectId:{type:"string",pattern:Rt},code:{enum:["PROJECT_ROOT_MISMATCH","PROJECT_ID_MISMATCH","INVALID_PROJECT_EXPECTATION"]},message:{type:"string",minLength:1}}},Co={$schema:"https://json-schema.org/draft/2020-12/schema",$id:Rr,title:"ArkGate MCP project identity",description:"Stable project binding plus separate runtime and architecture-contract evidence.",type:"object",additionalProperties:!1,required:["schemaVersion","projectId","resolvedRoot","resolvedConfigPath","arkgateVersion","contractHash","contractSource","runtimeId","processStartedAt"],properties:{schemaVersion:{const:"1.0"},projectId:{type:"string",pattern:Rt},resolvedRoot:{type:"string",minLength:1},resolvedConfigPath:{type:"string",minLength:1},arkgateVersion:{type:"string",minLength:1},contractHash:{type:"string",pattern:Rt},contractSource:{enum:["project","default-profile","manifest"]},runtimeId:{type:"string",minLength:1},processStartedAt:{type:"string",format:"date-time"}},$defs:{expectation:kr,binding:Er}};function _o(e,t,n){if(!e||!t)throw new Error("Project identity requires resolvedRoot and resolvedConfigPath.");let r=n(JSON.stringify({resolvedRoot:e,resolvedConfigPath:t})).toLowerCase();if(!/^[a-f0-9]{64}$/.test(r))throw new Error("Project identity hash adapter must return 64 hexadecimal SHA-256 characters.");return`sha256:${r}`}i(_o,"createProjectId");function Oo(e){return{schemaVersion:"1.0",...e}}i(Oo,"createProjectIdentity");var nn=Object.freeze(["network","filesystem","clock","randomness","environment","process","persistence"]),sn=Object.freeze({fetch:"network",XMLHttpRequest:"network",Date:"clock","Date.now":"clock","Math.random":"randomness","process.env":"environment",process:"process"}),on=Object.freeze(Object.keys(sn).sort()),tn=Object.freeze({fs:"filesystem","node:fs":"filesystem","fs/promises":"filesystem","node:fs/promises":"filesystem","fs-extra":"filesystem","graceful-fs":"filesystem",memfs:"filesystem",chokidar:"filesystem",http:"network",https:"network",http2:"network",net:"network",tls:"network",dgram:"network",dns:"network","node:http":"network","node:https":"network","node:http2":"network","node:net":"network","node:tls":"network","node:dgram":"network","node:dns":"network",axios:"network",undici:"network","node-fetch":"network",got:"network",ky:"network",superagent:"network",ws:"network",process:"process","node:process":"process",child_process:"process","node:child_process":"process","@prisma/client":"persistence",prisma:"persistence",pg:"persistence",mysql:"persistence",mysql2:"persistence",mongodb:"persistence",mongoose:"persistence",sqlite3:"persistence","better-sqlite3":"persistence",redis:"persistence",ioredis:"persistence",typeorm:"persistence",knex:"persistence","drizzle-orm":"persistence",sequelize:"persistence",kysely:"persistence","@supabase/supabase-js":"persistence"}),rn=Object.freeze({process:Object.freeze(["process","node:process"])});function Ye(e){if(!e||e.startsWith(".")||e.startsWith("/"))return null;let t=tn[e];if(t)return t;let n=e.indexOf("/");if(n<0)return null;let r=e.slice(0,n),s=tn[r];if(s)return s;let o=e.indexOf("/",n+1);return o<0?null:tn[e.slice(0,o)]??null}i(Ye,"capabilityForModuleSpecifier");function Ie(e,t){for(let n of t)if(rn[n]?.includes(e))return n;return null}i(Ie,"forbiddenGlobalForModuleSpecifier");function kt(e){let t=e.split(".");for(let n=t.length;n>=1;n-=1){let r=t.slice(0,n).join("."),s=sn[r];if(s)return s}return null}i(kt,"capabilityForAmbientName");function Le(e){if(e?.pure===!0)return[...nn].sort();let n=(e?.capabilities?.deny??[]).filter(r=>nn.includes(r));return[...new Set(n)].sort()}i(Le,"effectiveCapabilityDeny");function We(e,t){if(t.length===0)return!1;let n=new Set(t),r=e.split(".");for(let s=r.length;s>=1;s-=1)if(n.has(r.slice(0,s).join(".")))return!0;return!1}i(We,"ambientCoveredByForbiddenGlobals");function Et(e){let t=new Set,n=new Set,r=Object.keys(sn);for(let s of e?.forbiddenGlobals??[]){let o=r.filter(a=>a===s||a.startsWith(`${s}.`));if(o.length===0)n.add(s);else for(let a of o)t.add(`ambient:${a}`);for(let a of rn[s]??[])t.add(`import-exact:${a}`)}for(let s of Le(e)){if(t.add(`import:${s}`),s==="process")for(let o of rn.process)t.add(`import-exact:${o}`);for(let o of r)kt(o)===s&&t.add(`ambient:${o}`)}return{atoms:[...t].sort(),rawGlobals:[...n].sort()}}i(Et,"loweredLayerCoverage");var Sr=new Map;function Ir(e){return/[.*+?^${}()|[\]\\]/.test(e)?`\\${e}`:e}i(Ir,"escapeLiteral");function St(e){let t="";for(let n=0;n<e.length;n+=1){let r=e[n];if(r==="\\"&&n+1<e.length){let s=e[n+1];if("*?{}[],".includes(s)||s==="\\"){t+="\\"+s,n+=1;continue}t+="/";continue}t+=r}return t}i(St,"normalizeGlobSeparators");function xo(e){let t=0;for(let n=0;n<e.length;n+=1){let r=e[n];if(r==="\\"){n+=1;continue}if(r==="{")t+=1;else if(r==="}"&&(t-=1,t<0))return!1}return t===0}i(xo,"bracesBalanced");function Ce(e){let t=Sr.get(e);if(t)return t;let n=St(e),r=xo(n),s="",o=0;for(let l=0;l<n.length;l+=1){let c=n[l];c==="\\"&&l+1<n.length?(s+=Ir(n[l+1]),l+=1):c==="*"?n[l+1]==="*"?n[l+2]==="/"?(s+="(?:.*/)?",l+=2):(s+=".*",l+=1):s+="[^/]*":c==="?"?s+="[^/]":c==="{"&&r?(s+="(?:",o+=1):c==="}"&&r&&o>0?(s+=")",o-=1):c===","&&r&&o>0?s+="|":s+=Ir(c)}let a=new RegExp(`^${s}$`);return Sr.set(e,a),a}i(Ce,"globToRegExp");function To(e){return St(String(e)).split("/").filter(Boolean).filter(n=>n!=="**"&&n!=="*"&&!n.includes("*")&&!n.includes("?")&&!n.includes("{")&&!n.includes("["))}i(To,"concreteGlobSegments");function an(e,t){let n=St(String(e)),r=To(n),s=n.replace(/\*/g,"").length,o=r.length*1e4+s;if(t==null||t==="")return o;let a=String(t).split(/[/\\]/).filter(Boolean);if(r.length===0)return s;let l=0,c=-1;for(let p of r){let m=-1;for(let g=l;g<a.length;g+=1)if(a[g]===p){m=g;break}if(m<0)return o;c=m,l=m+1}return(c+1)*1e6+r.length*1e4+s}i(an,"patternSpecificity");function ie(e,t){let n=String(e).split(/[/\\]/).join("/"),r,s=-1;for(let o of t??[])if(!(o.exclude??[]).some(a=>Ce(a).test(n))){for(let a of o.patterns??[])if(Ce(a).test(n)){let l=an(a,n);l>s&&(s=l,r=o.name)}}return r}i(ie,"layerForRelativePath");function vr(e,t){if(!t?.length)return;let n=String(e).split(/[/\\]/).filter(Boolean),r=new Set(t.map(s=>String(s).toLowerCase()));for(let s=0;s<n.length-1;s+=1)if(r.has(n[s].toLowerCase()))return`${n[s].toLowerCase()}/${n[s+1].toLowerCase()}`}i(vr,"sliceIdForPath");function No(e){let t=new Set;for(let n of e??[]){let s=St(String(n)).split("/").filter(Boolean);for(let o=0;o<s.length;o+=1){let a=s[o];if((a==="**"||a==="*")&&o>0){let l=s[o-1];l&&!l.includes("*")&&!l.includes("{")&&!l.includes("}")&&t.add(l)}}}return[...t]}i(No,"inferSliceFoldersFromPatterns");function Po(e,t,n){if(Array.isArray(e.sliceFolders)&&e.sliceFolders.length>0)return e.sliceFolders.filter(s=>typeof s=="string"&&s.length>0);let r=(n??[]).find(s=>s.name===t);return No(r?.patterns)}i(Po,"resolveSliceFolders");function Lo(e){return!e.fromPath||!e.toPath||e.folderCount<=0||!e.fromSlice||!e.toSlice?!0:e.fromSlice!==e.toSlice}i(Lo,"peerIsolationMustDeny");function me(e,t,n,r){for(let s of e??[])if(!(s.from!==t||s.to!==n)&&s.allowed===!1){if(s.peerIsolation){let o=r?.fromPath,a=r?.toPath,l=Po(s,t,r?.layers),c=o&&a?vr(o,l):void 0,p=o&&a?vr(a,l):void 0;if(Lo({fromPath:o,toPath:a,folderCount:l.length,fromSlice:c,toSlice:p}))return s;continue}if(t!==n)return s}}i(me,"findDeniedEdgeRule");function we(e,t){return t&&e.isStringLiteralLike(t)?t.text:void 0}i(we,"literalText");function _r(e,t){return e.getLineAndCharacterOfPosition(t.getStart(e)).line+1}i(_r,"lineOf");function br(e,t){if(e.isImportDeclaration(t)){let r=t.importClause;if(!r)return!1;if(r.isTypeOnly)return!0;let s=r.namedBindings;return!!(s&&e.isNamedImports(s)&&s.elements.length>0&&s.elements.every(o=>o.isTypeOnly))}if(t.isTypeOnly)return!0;let n=t.exportClause;return!!(n&&e.isNamedExports(n)&&n.elements.length>0&&n.elements.every(r=>r.isTypeOnly))}i(br,"isTypeOnlyReference");function Or(e,t){let n={noLib:!0,noResolve:!0,target:e.ScriptTarget.Latest},r=e.createCompilerHost(n,!0);return r.getSourceFile=s=>s===t.fileName?t:void 0,r.fileExists=s=>s===t.fileName,r.readFile=s=>s===t.fileName?t.text:void 0,e.createProgram([t.fileName],n,r).getTypeChecker()}i(Or,"singleFileChecker");function ln(e,t){try{return e.getSymbolAtLocation(t)}catch{return}}i(ln,"symbolAt");function cn(e,t,n,r){let s=r.parent&&e.isShorthandPropertyAssignment(r.parent)&&r.parent.name===r,o;try{o=s?t.getShorthandAssignmentValueSymbol(r.parent):ln(t,r)}catch{o=void 0}return!!o?.declarations?.some(a=>a.getSourceFile().fileName===n.fileName)}i(cn,"localDeclaration");function De(e,t){let n,r=[],s=i((a,l,c,p=!1)=>r.push({specifier:c,kind:l,line:_r(t,a),typeOnly:p,unresolved:c===void 0,node:a}),"add"),o=i(a=>{if(e.isImportDeclaration(a))s(a,"import",we(e,a.moduleSpecifier),br(e,a));else if(e.isExportDeclaration(a)&&a.moduleSpecifier)s(a,"export",we(e,a.moduleSpecifier),br(e,a));else if(e.isImportEqualsDeclaration(a)&&e.isExternalModuleReference(a.moduleReference))s(a,"require",we(e,a.moduleReference.expression),a.isTypeOnly===!0);else if(e.isCallExpression(a)){let l=a.expression.kind===e.SyntaxKind.ImportKeyword,p=e.isIdentifier(a.expression)&&a.expression.text==="require"&&!cn(e,n??(n=Or(e,t)),t,a.expression);(l||p)&&s(a,p?"require":"dynamic-import",we(e,a.arguments[0]))}e.forEachChild(a,o)},"visit");return o(t),r}i(De,"extractSemanticDependencies");function wo(e,t){let n=[],r=t;for(;e.isPropertyAccessExpression(r)||e.isElementAccessExpression(r);){if(e.isPropertyAccessExpression(r))n.unshift(r.name.text);else{let s=we(e,r.argumentExpression);if(s===void 0)return;n.unshift(s)}r=r.expression}if(e.isIdentifier(r))return n.unshift(r.text),{root:r,segments:n}}i(wo,"staticAccessPath");function Do(e,t){let n=t.parent;return e.isPropertyAccessExpression(n)||e.isElementAccessExpression(n)?!1:e.isExpressionNode(t)&&!e.isInTypeQuery(t)||e.isShorthandPropertyAssignment(n)&&n.name===t}i(Do,"runtimeIdentifierReference");function Cr(e,t){let n=t[0]==="globalThis"?t.slice(1):t;for(let r=n.length;r>=1;r-=1){let s=n.slice(0,r).join(".");if(e.has(s))return s}}i(Cr,"bestForbiddenMatch");function Me(e,t,n){if(n.length===0)return[];let r=new Set(n),s=Or(e,t),o=new Map,a=new Set;for(let u of t.statements)if(e.isVariableStatement(u))for(let d of u.declarationList.declarations)e.isIdentifier(d.name)&&a.add(d.name.text);let l=i(u=>{let d=wo(e,u);if(!d)return;let f=ln(s,d.root),y=f?o.get(f):void 0;return y?[...y,...d.segments.slice(1)]:cn(e,s,t,d.root)||a.has(d.root.text)?void 0:d.segments},"resolvePath");for(let u of t.statements)if(e.isVariableStatement(u))for(let d of u.declarationList.declarations){if(!d.initializer||!e.isIdentifier(d.name))continue;let f=l(d.initializer),y=ln(s,d.name);!f||!y||o.set(y,f)}let c=[],p=new Set,m=i((u,d)=>{let f=_r(t,d),y=`${u}:${d.getStart(t)}`;p.has(y)||(p.add(y),c.push({name:u,line:f,node:d}))},"flag"),g=i(u=>{let d=u.parent&&(e.isPropertyAccessExpression(u.parent)||e.isElementAccessExpression(u.parent))&&u.parent.expression===u;if((e.isPropertyAccessExpression(u)||e.isElementAccessExpression(u))&&!d){let f=l(u),y=f?Cr(r,f):void 0;y&&m(y,u)}else e.isIdentifier(u)&&r.has(u.text)&&Do(e,u)&&!cn(e,s,t,u)&&m(u.text,u);if(e.isVariableDeclaration(u)&&e.isObjectBindingPattern(u.name)&&u.initializer){let f=l(u.initializer);if(f)for(let y of u.name.elements){if(!e.isIdentifier(y.name))continue;let I=y.propertyName?we(e,y.propertyName)??y.propertyName.text:y.name.text,N=Cr(r,[...f,I]);N&&m(N,u.initializer)}}e.forEachChild(u,g)},"visit");return g(t),c}i(Me,"collectForbiddenCapabilityUses");function dn(e,t,n){let r=[];for(let s of n?.dependencies??De(e,t)){if(s.typeOnly||!s.specifier)continue;let o=Ye(s.specifier);o&&r.push({capability:o,symbol:s.specifier,line:s.line,source:"import-based"})}for(let s of n?.ambientUses??Me(e,t,on)){let o=kt(s.name);o&&r.push({capability:o,symbol:s.name,line:s.line,source:"ambient-global"})}return r.sort((s,o)=>s.line-o.line||s.capability.localeCompare(o.capability)||s.symbol.localeCompare(o.symbol))}i(dn,"collectCapabilityUses");var un={RAW_EVENT_PUBLISH:"Publish through a registered intent creator; raw event objects or intent strings bypass Ark contracts and tooling.",PUBLISH_MISSING_SOURCE:"Strict Ark publish calls must include metadata.source."},pn=Object.freeze([{layer:"DomainModel",prefixes:["Domain."]},{layer:"ApplicationOrchestration",prefixes:["Application."]},{layer:"PersistenceAdapters",prefixes:["Adapter.Persistence.","Adapter.Repository."]},{layer:"IntegrationAdapters",prefixes:["Adapter.Integration.","Adapter.External."]},{layer:"WorkflowSagaEngine",prefixes:["Workflow."]},{layer:"BackgroundJobsScheduling",prefixes:["Job."]},{layer:"PresentationAdapters",prefixes:["Presentation.","Adapter.Presentation.","Adapter.Api."]},{layer:"ReportingReadModels",prefixes:["Reporting."]},{layer:"ExtensibilityMetadata",prefixes:["Metadata."]},{layer:"SecurityAuditObservability",prefixes:["Security.","Audit.","Observability."]},{layer:"Kernel",prefixes:["Kernel."]}]);function fn(e,t){return t.flatMap((r,s)=>(r.prefixes??r.intentPrefixes??[]).map(o=>({layer:r.name,layerIndex:s,prefix:o.endsWith(".")?o:`${o}.`}))).filter(({prefix:r})=>e.startsWith(r)).sort((r,s)=>s.prefix.length-r.prefix.length||r.layerIndex-s.layerIndex)[0]?.layer}i(fn,"resolveIntentLayer");function _e(e){return/^(Domain|Application|Adapter|Workflow|Job|Presentation|Reporting|Metadata|Security|Audit|Observability|Kernel)\.[A-Za-z0-9_.]+$/.test(e)}i(_e,"looksLikeArkIntent");function Je(e){if(!e.publishCall)return[];let t=[];return(e.rawIntentName!==void 0&&_e(e.rawIntentName)||e.objectHasIntent)&&t.push({ruleId:"RAW_EVENT_PUBLISH",message:un.RAW_EVENT_PUBLISH}),e.arkPublishCandidate&&!e.hasSource&&t.push({ruleId:"PUBLISH_MISSING_SOURCE",message:un.PUBLISH_MISSING_SOURCE}),t}i(Je,"classifyPublishFacts");function V(e,t,n){return{ruleId:e,code:e,message:t,...n}}i(V,"violation");function Fe(e,t){return e.slice(0,t).split(`
|
|
2
2
|
`).length}i(Fe,"lineOf");function Mo(e){let t=[],n=/['"`]([A-Za-z][A-Za-z0-9_.]*)['"`]/g,r;for(;(r=n.exec(e))!==null;)t.push({value:r[1],index:r.index});return t}i(Mo,"extractQuotedStrings");function Fo(e){let t=[],n=[{kind:"import",re:/\bimport\s+(?:type\s+)?(?:[^'"]*?\s+from\s*)?['"]([^'"]+)['"]/g},{kind:"export",re:/\bexport\s+(?:type\s+)?[^'"]*?\s+from\s*['"]([^'"]+)['"]/g},{kind:"dynamic-import",re:/\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/g},{kind:"require",re:/\brequire\s*\(\s*['"]([^'"]+)['"]\s*\)/g}];for(let r of n){let s;for(;(s=r.re.exec(e))!==null;){let o=s.index+s[0].indexOf(s[1]),a=s[0],l=r.kind==="import"&&/\bimport\s+type\b/.test(a)||r.kind==="export"&&/\bexport\s+type\b/.test(a);t.push({value:s[1],index:o,kind:r.kind,typeOnly:l})}}return t.sort((r,s)=>r.index-s.index)}i(Fo,"extractModuleSpecifiers");function $o(e,t){let n=e.createSourceFile("generated.ts",t,e.ScriptTarget.Latest,!0),r=[],s=i(o=>{e.isStringLiteralLike(o)&&r.push({value:o.text,index:o.getStart(n)}),e.forEachChild(o,s)},"visit");return s(n),r}i($o,"extractQuotedStringsAst");function Ho(e){let t=e.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);return["adapter","adapters","infra","infrastructure","persistence","repository","repositories","integration","database","db"].some(n=>t.includes(n))}i(Ho,"hasInfrastructureToken");function jo(e){let t=e.toLowerCase();return["sequelize","prisma","typeorm","mongoose","knex"].some(n=>t===n||t.startsWith(`${n}/`))}i(jo,"isKnownInfrastructurePackage");function Vo(e){let t=e.toLowerCase();return["adapter","infra","persistence","repository","repositories","integration","database"].some(n=>t.includes(n))}i(Vo,"layerHasInfrastructureRole");function Xe(e,t){return t&&e.isStringLiteralLike(t)?t.text:void 0}i(Xe,"tsStringLiteralText");function Uo(e,t){if(t&&(e.isIdentifier(t)||e.isStringLiteralLike(t)))return t.text}i(Uo,"tsPropertyName");function xr(e,t,n){if(!(!t||!e.isObjectLiteralExpression(t)))return t.properties.find(r=>!e.isPropertyAssignment(r)&&!e.isShorthandPropertyAssignment(r)?!1:Uo(e,r.name)===n)}i(xr,"tsObjectProperty");function Qe(e,t,n){return xr(e,t,n)!==void 0}i(Qe,"tsObjectHasProperty");function Ze(e,t,n){let r=xr(e,t,n);return r&&e.isPropertyAssignment(r)?r.initializer:void 0}i(Ze,"tsObjectPropertyValue");function Ko(e,t){let n=Ze(e,t,"metadata");return Qe(e,n,"source")}i(Ko,"tsObjectHasMetadataSource");function Tr(e,t){return t?e.isIdentifier(t)?/^[A-Z]/.test(t.text):e.isPropertyAccessExpression(t)?Tr(e,t.name):!1:!1}i(Tr,"tsLooksLikeIntentCreatorExpression");function Go(e,t){if(!e.isCallExpression(t))return!1;let n=t.expression;return e.isPropertyAccessExpression(n)?n.name.text==="publish":e.isIdentifier(n)&&n.text==="publish"}i(Go,"tsIsPublishCall");function Bo(e,t){if(!e.isCallExpression(t))return!1;let n=t.arguments[0],r=Xe(e,n);return r!==void 0&&_e(r)||Qe(e,n,"intent")||Tr(e,n)}i(Bo,"tsIsArkPublishCandidate");function zo(e,t){if(!e.isCallExpression(t))return!1;let[n,r,s]=t.arguments;return Ko(e,n)||Qe(e,r,"source")||Qe(e,s,"source")}i(zo,"tsPublishHasSource");function qo(e,t){if(!e.isCallExpression(t))return;let[n,r,s]=t.arguments,o=Ze(e,n,"metadata");return Xe(e,Ze(e,o,"source"))??Xe(e,Ze(e,r,"source"))??Xe(e,Ze(e,s,"source"))}i(qo,"tsPublishSourceLiteral");function Yo(e,t,n,r){let s=e.createSourceFile("generated.ts",t,e.ScriptTarget.Latest,!0),o=n,a=o?.filePath,l=o?.layer,c=[],p=i(g=>s.getLineAndCharacterOfPosition(g.getStart(s)).line+1,"lineForNode"),m=i(g=>{if(Go(e,g)){let u=g.arguments[0],d=Xe(e,u);for(let y of Je({publishCall:!0,rawIntentName:d,objectHasIntent:Qe(e,u,"intent"),arkPublishCandidate:Bo(e,g),hasSource:zo(e,g)}))c.push(V(y.ruleId,y.message,{line:p(g),filePath:a}));let f=qo(e,g);if(r&&l&&f&&_e(f)){let y=r.resolveLayer(f);y&&y!==l&&c.push(V("PUBLISH_SOURCE_LAYER_MISMATCH",`Publish source "${f}" resolves to ${y}, but the target file is classified as ${l}.`,{line:p(g),filePath:a,target:f,fromLayer:l,toLayer:y}))}}e.forEachChild(g,m)},"visit");return m(s),c}i(Yo,"analyzePublishAst");function Nr(e={}){let t=new Set((e.intents||[]).map(o=>typeof o=="string"?o:o.name)),n=e.forbiddenPatterns||[],r=new Set(e.infrastructureLayers??[]),s=e.enforceIntentAllowlist??t.size>0;return{validate(o,a){let l=[],c=a,p=c?.filePath,m=c?.layer,g=e.typescript,u=g?g.createSourceFile(p??"generated.ts",o,g.ScriptTarget.Latest,!0):void 0,d=u?De(e.typescript,u):void 0,f=d?d.filter(E=>E.specifier!==void 0).map(E=>({value:E.specifier,index:E.node.getStart(u),kind:E.kind,typeOnly:E.typeOnly})):Fo(o),y=e.typescript?$o(e.typescript,o):Mo(o);if(e.typescript&&!e.allowNonLiteralDynamicImport?.(p))for(let E of d?.filter(({unresolved:k})=>k)??[]){let k=E.kind==="require";l.push(V(k?"DYNAMIC_REQUIRE_NOT_ALLOWLISTED":"DYNAMIC_IMPORT_NOT_ALLOWLISTED",`Non-literal ${k?"require call":"dynamic import"} cannot be resolved statically; add the reviewed file to dynamicImportAllowlist.`,{line:E.line,filePath:p}))}let I=m!==void 0&&(r.has(m)||Vo(m)),N=m!==void 0?` If "${m}" is an infrastructure layer, mark it in ark.config.json with "mayImportInfrastructure": true (or name it with an infra token like Adapters/Persistence/Repository).`:"";for(let E of n)if(E instanceof RegExp){E.lastIndex=0;let k=E.exec(o);E.lastIndex=0,k&&l.push(V("FORBIDDEN_PATTERN",`Forbidden pattern matched: ${E}`,{line:k.index===void 0?void 0:Fe(o,k.index),filePath:p,suggestion:"Remove infrastructure imports from domain/application layers."+N}))}else o.includes(E)&&l.push(V("FORBIDDEN_SUBSTRING",`Forbidden substring: ${E}`,{line:Fe(o,o.indexOf(E)),filePath:p}));for(let E of f){let k=e.resolveImportTarget?.(E.value,p)??(e.resolveImportLayer?{layer:e.resolveImportLayer(E.value,p)}:void 0),b=typeof p=="string"?e.resolveImportTarget?.(p)??(e.resolveImportLayer?{layer:m,relPath:void 0}:void 0):void 0,J=k?.layer;if(J&&m){let H=me(e.architectureProfile?.rules,m,J,{fromPath:b?.relPath,toPath:k?.relPath,layers:e.architectureLayers});if(H){if(E.typeOnly&&!H.peerIsolation)continue;let G=!!H.peerIsolation;l.push(V("LAYER_IMPORT_VIOLATION",H.message??(G?`Layer "${m}" must not import across slices into "${J}".`:`Layer "${m}" must not import "${J}".`),{line:Fe(o,E.index),source:E.value,target:E.value,filePath:p,fromLayer:m,toLayer:J,suggestion:G?"Extract shared code to a shared layer, or coordinate slices via events/ports \u2014 do not import across feature/context slices.":"Depend on a port/interface owned by an inner layer instead, or move this code to a layer allowed to make this import.",details:{importKind:E.kind,peerIsolation:G,...E.typeOnly?{typeOnly:!0}:{}}}));continue}continue}I||E.typeOnly||!Ho(E.value)&&!jo(E.value)||l.push(V("FORBIDDEN_IMPORT",`Forbidden ${E.kind} target: "${E.value}".`,{line:Fe(o,E.index),source:E.value,target:E.value,filePath:p,suggestion:"Route infrastructure access through an allowed adapter or port boundary."+N,details:{importKind:E.kind}}))}if(e.policies)for(let E of e.policies){let k=E.check({source:o,context:a});if(k!==!0)if(Array.isArray(k))for(let b of k)l.push(V("POLICY_VIOLATION",b.message,{filePath:p,suggestion:`Fix violation of policy "${E.name}".`}));else k===!1?l.push(V("POLICY_VIOLATION",`Policy ${E.name} failed on generated code`)):l.push(V("POLICY_VIOLATION",k.message))}if(s&&t.size>0)for(let E of y)_e(E.value)&&!t.has(E.value)&&l.push(V("UNKNOWN_INTENT",`Unknown intent reference: "${E.value}"`,{line:Fe(o,E.index),filePath:p,target:E.value,suggestion:`Register intent "${E.value}" via defineIntent() or remove the reference.`}));if(e.architectureProfile&&m)for(let E of y){if(!_e(E.value))continue;let k=e.architectureProfile.resolveLayer(E.value);if(!k)continue;let b=me(e.architectureProfile.rules,m,k);b&&l.push(V("LAYER_REFERENCE_VIOLATION",b.message??`Layer "${m}" must not reference "${k}" through "${E.value}".`,{line:Fe(o,E.index),filePath:p,target:E.value,fromLayer:m,toLayer:k,suggestion:"Route the dependency through an allowed intent, port, or event.",details:{rule:b}}))}if(e.extensions)for(let E of e.extensions)try{let k=E.analyze(o,a);l.push(...k)}catch(k){l.push(V("EXTENSION_ERROR",`Extension "${E.name}" failed: ${k instanceof Error?k.message:String(k)}`))}if(e.typescript&&u&&m&&e.forbiddenGlobals?.[m]?.length)try{let E=e.forbiddenGlobals[m];l.push(...Me(e.typescript,u,E).map(k=>V("FORBIDDEN_GLOBAL",`${m} must not use the ambient global "${k.name}".`,{line:k.line,filePath:p,target:k.name,fromLayer:m,suggestion:"Inject the capability through a port (e.g. a Clock, IdGenerator, or HttpPort) instead of reaching for the ambient global."})));for(let k of d??[]){if(k.typeOnly||!k.specifier)continue;let b=Ie(k.specifier,E);b&&l.push(V("FORBIDDEN_GLOBAL",`${m} must not use module "${k.specifier}" because it is the import form of forbidden global "${b}".`,{line:k.line,filePath:p,source:k.specifier,target:k.specifier,fromLayer:m,details:{importKind:k.kind,forbiddenGlobal:b},suggestion:"Inject the capability through a port instead of importing the ambient global module form."}))}}catch(E){l.push(V("AST_ANALYZER_ERROR",`TypeScript AST analyzer failed: ${E instanceof Error?E.message:String(E)}`))}if(e.typescript&&u&&m&&e.capabilityWalls?.[m]?.length)try{let E=new Set(e.capabilityWalls[m]),k=e.forbiddenGlobals?.[m]??[];for(let b of dn(e.typescript,u))E.has(b.capability)&&(b.source==="ambient-global"&&We(b.symbol,k)||b.source==="import-based"&&Ie(b.symbol,k)||l.push(V("CAPABILITY_VIOLATION",b.source==="import-based"?`${m} denies the ${b.capability} capability; found import of "${b.symbol}".`:`${m} denies the ${b.capability} capability; found ambient "${b.symbol}".`,{line:b.line,filePath:p,target:b.symbol,capability:b.capability,fromLayer:m,suggestion:"Define a small port (ClockPort, HttpPort, StoragePort) and bind the implementation in an adapter layer."})))}catch(E){l.push(V("AST_ANALYZER_ERROR",`TypeScript AST analyzer failed: ${E instanceof Error?E.message:String(E)}`))}if(e.typescript)try{l.push(...Yo(e.typescript,o,a,e.architectureProfile))}catch(E){l.push(V("AST_ANALYZER_ERROR",`TypeScript AST analyzer failed: ${E instanceof Error?E.message:String(E)}`))}return{mode:"lexical-compatibility",completeness:"partial",completenessReasons:["LEXICAL_EVIDENCE_INCOMPLETE"],valid:!1,lexicalValid:l.length===0,violations:l}}}}i(Nr,"createAICodeGate");var et={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Pr={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},compositionRoots:{...et,default:[]},kernelRoots:{...et},managedLayers:{...et,default:[]},requireDeclarations:{type:"boolean",default:!0},ignoreDirectNewForErrors:{type:"boolean",default:!0}}},Lr={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},planeRoots:{...et,default:[]},managedLayers:{...et,default:[]},maxXiKeys:{type:"integer",minimum:1,default:7}}};function tt(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}i(tt,"isObject");function wr(e){let t=new Set;if(!Array.isArray(e.layers))return t;for(let n of e.layers)tt(n)&&typeof n.name=="string"&&n.name.length>0&&t.add(n.name);return t}i(wr,"declaredLayerNames");function Dr(e){if(!tt(e))return e;let t={mode:e.mode===void 0?"advisory":e.mode,compositionRoots:e.compositionRoots===void 0?[]:e.compositionRoots,managedLayers:e.managedLayers===void 0?[]:e.managedLayers,requireDeclarations:e.requireDeclarations===void 0?!0:e.requireDeclarations};return e.kernelRoots!==void 0&&(t.kernelRoots=e.kernelRoots),e.ignoreDirectNewForErrors!==void 0&&(t.ignoreDirectNewForErrors=e.ignoreDirectNewForErrors),{...e,...t}}i(Dr,"defaultedArkRun");function Mr(e){if(!tt(e))return e;let t=typeof e.maxXiKeys=="number"&&e.maxXiKeys>0?e.maxXiKeys:7;return{...e,mode:e.mode===void 0?"advisory":e.mode,planeRoots:e.planeRoots===void 0?[]:e.planeRoots,managedLayers:e.managedLayers===void 0?[]:e.managedLayers,maxXiKeys:t}}i(Mr,"defaultedArkOrder");function Fr(e,t){let n=e.arkRun;if(n===void 0||!tt(n))return;let r=wr(e),s=n.managedLayers;if(Array.isArray(s)&&s.forEach((o,a)=>{typeof o=="string"&&o.length>0&&!r.has(o)&&t.push({path:`$.arkRun.managedLayers[${a}]`,message:`layer ${JSON.stringify(o)} is not declared in layers[]`})}),n.mode==="enforced"){let o=n.kernelRoots??n.compositionRoots;(!Array.isArray(o)||o.length===0)&&t.push({path:n.kernelRoots!==void 0?"$.arkRun.kernelRoots":"$.arkRun.compositionRoots",message:"ARKRUN_MISSING_ROOT: enforced mode requires at least one kernel root"}),(!Array.isArray(s)||s.length===0)&&t.push({path:"$.arkRun.managedLayers",message:"enforced mode requires at least one managed layer"})}}i(Fr,"validateArkRunExtra");function $r(e,t){let n=e.arkOrder;if(n===void 0||!tt(n))return;let r=wr(e),s=n.managedLayers;if(Array.isArray(s)&&s.forEach((o,a)=>{typeof o=="string"&&o.length>0&&!r.has(o)&&t.push({path:`$.arkOrder.managedLayers[${a}]`,message:`layer ${JSON.stringify(o)} is not declared in layers[]`})}),n.mode==="enforced"){let o=n.planeRoots;(!Array.isArray(o)||o.length===0)&&t.push({path:"$.arkOrder.planeRoots",message:"ARKORDER_MISSING_PLANE: enforced mode requires at least one plane root"}),(!Array.isArray(s)||s.length===0)&&t.push({path:"$.arkOrder.managedLayers",message:"enforced mode requires at least one managed layer"})}}i($r,"validateArkOrderExtra");var ne="1.3",vt="https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",Hr=["DomainModel","ApplicationOrchestration","PersistenceAdapters","IntegrationAdapters","WorkflowSagaEngine","BackgroundJobsScheduling","PresentationAdapters","ReportingReadModels","ExtensibilityMetadata","SecurityAuditObservability","Kernel"],Wo=new Set(["PresentationAdapters->ApplicationOrchestration","ApplicationOrchestration->DomainModel","WorkflowSagaEngine->ApplicationOrchestration","WorkflowSagaEngine->DomainModel","BackgroundJobsScheduling->ApplicationOrchestration"]);function Jo(){let e=[];for(let t of Hr)for(let n of Hr)t===n||Wo.has(`${t}->${n}`)||e.push({from:t,to:n,allowed:!1});return e}i(Jo,"createDefaultRules");var bt=Jo(),mn=[{from:"unversioned",to:"1.0"},{from:"1.0",to:"1.1"},{from:"1.1",to:"1.2"},{from:"1.2",to:"1.3"}],ge={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},gn={$schema:"https://json-schema.org/draft/2020-12/schema",$id:vt,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:vt,description:"Editor-facing URL or local path for this JSON Schema."},schemaVersion:{type:"string",const:ne,default:ne},name:{type:"string",minLength:1},include:{...ge,minItems:1,default:["src"]},exclude:{...ge,default:[]},excludeGenerated:{type:"boolean",default:!0},frameworkOverlay:{type:"string",minLength:1},layers:{type:"array",default:[],items:{$ref:"#/$defs/layer"}},rules:{type:"array",default:bt,items:{$ref:"#/$defs/rule"}},cyclePolicy:{type:"string",enum:["strict","soft","framework-soft","off"],default:"strict"},dynamicImportAllowlist:{...ge,default:[]},safety:{$ref:"#/$defs/safety",default:{maxTsSuppressions:0,maxAnyCasts:0,allowInMemory:!1,allowDisabledPeerIsolation:!1}},arkRules:{type:"object",additionalProperties:{type:"string",minLength:1},default:{}},arkRun:{$ref:"#/$defs/arkRun"},arkOrder:{$ref:"#/$defs/arkOrder"},stewards:{...ge,default:[]}},$defs:{layer:{type:"object",additionalProperties:!1,required:["name","patterns"],properties:{name:{type:"string",minLength:1},patterns:{...ge,minItems:1},exclude:ge,intentPrefixes:ge,description:{type:"string",minLength:1},forbiddenGlobals:ge,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:{...ge,minItems: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}}},arkRun:Pr,arkOrder:Lr}},ye=class extends Error{static{i(this,"ArkConfigValidationError")}issues;source;constructor(t,n){super(`Invalid ArkGate config (${t}):
|
|
3
3
|
${n.map(r=>`- ${r.path}: ${r.message}`).join(`
|
|
4
4
|
`)}`),this.name="ArkConfigValidationError",this.source=t,this.issues=n}};function jr(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}i(jr,"isObject");function It(e,t){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(t)?`${e}.${t}`:`${e}[${JSON.stringify(t)}]`}i(It,"propertyPath");function $e(e){return e===null?"null":Array.isArray(e)?"array":typeof e}i($e,"valueType");function Zo(e,t){let n="#/$defs/";if(e.startsWith(n))return t.$defs[e.slice(n.length)]}i(Zo,"resolveSchemaRef");function nt(e,t,n,r,s){if(t.$ref){let o=Zo(t.$ref,r);if(!o){s.push({path:n,message:`schema reference ${t.$ref} cannot be resolved`});return}nt(e,o,n,r,s);return}if(t.const!==void 0&&!Object.is(e,t.const)){s.push({path:n,message:`must equal ${JSON.stringify(t.const)}`});return}if(t.enum&&!t.enum.some(o=>Object.is(o,e))){s.push({path:n,message:`must be one of ${t.enum.map(String).join(", ")}`});return}if(t.type==="object"){if(!jr(e)){s.push({path:n,message:`must be an object; received ${$e(e)}`});return}let o=t.properties??{};for(let a of t.required??[])e[a]===void 0&&s.push({path:It(n,a),message:"is required"});if(t.additionalProperties===!1)for(let a of Object.keys(e))a in o||s.push({path:It(n,a),message:"unknown field"});else if(t.additionalProperties!==void 0&&t.additionalProperties!==!0&&typeof t.additionalProperties=="object"){let a=t.additionalProperties;for(let l of Object.keys(e))l in o||nt(e[l],a,It(n,l),r,s)}for(let[a,l]of Object.entries(o))e[a]!==void 0&&nt(e[a],l,It(n,a),r,s);return}if(t.type==="array"){if(!Array.isArray(e)){s.push({path:n,message:`must be an array; received ${$e(e)}`});return}if(t.minItems!==void 0&&e.length<t.minItems&&s.push({path:n,message:`must contain at least ${t.minItems} item(s)`}),t.uniqueItems){let o=e.map(a=>JSON.stringify(a));new Set(o).size!==o.length&&s.push({path:n,message:"must not contain duplicate items"})}t.items&&e.forEach((o,a)=>nt(o,t.items,`${n}[${a}]`,r,s));return}if(t.type==="string"){if(typeof e!="string"){s.push({path:n,message:`must be a string; received ${$e(e)}`});return}t.minLength!==void 0&&e.length<t.minLength&&s.push({path:n,message:`must contain at least ${t.minLength} character(s)`});return}if(t.type==="boolean"){typeof e!="boolean"&&s.push({path:n,message:`must be a boolean; received ${$e(e)}`});return}if(t.type==="integer"){if(!Number.isInteger(e)){s.push({path:n,message:`must be an integer; received ${$e(e)}`});return}t.minimum!==void 0&&e<t.minimum&&s.push({path:n,message:`must be at least ${t.minimum}`})}}i(nt,"validateNode");function Xo(e){let t={...e,$schema:e.$schema===void 0?vt:e.$schema,schemaVersion:e.schemaVersion===void 0?ne:e.schemaVersion,include:e.include===void 0?["src"]:e.include,layers:e.layers===void 0?[]:e.layers,rules:e.rules===void 0?bt.map(n=>({...n})):e.rules};return e.arkRun!==void 0&&(t.arkRun=Dr(e.arkRun)),e.arkOrder!==void 0&&(t.arkOrder=Mr(e.arkOrder)),t}i(Xo,"defaultedConfig");function Qo(e){return e===ne?null:e==="unversioned"?"unversioned":e==="1.0"||e==="1.1"||e==="1.2"?e:null}i(Qo,"migratedFromOf");function ea(){let e=new Set([ne]);for(let t of mn)t.from!=="unversioned"&&e.add(t.from),e.add(t.to);return e}i(ea,"knownInputVersions");function ta(e,t="ark.config.json"){if(!jr(e))throw new ye(t,[{path:"$",message:`must be an object; received ${$e(e)}`}]);let n=ea(),r=e.schemaVersion===void 0?"unversioned":typeof e.schemaVersion=="string"?e.schemaVersion:null;if(r===null)throw new ye(t,[{path:"$.schemaVersion",message:`unsupported version ${JSON.stringify(e.schemaVersion)}; expected ${ne}`}]);if(r!=="unversioned"&&!n.has(r))throw new ye(t,[{path:"$.schemaVersion",message:`unsupported version ${JSON.stringify(r)}; expected ${ne}`}]);let s=r,o={...e},a=0;for(;s!==ne&&a<mn.length+1;){a+=1;let l=mn.find(c=>c.from===s);if(!l)throw new ye(t,[{path:"$.schemaVersion",message:`unsupported version ${JSON.stringify(s)}; expected ${ne}`}]);s=l.to,o.schemaVersion=s}if(s!==ne)throw new ye(t,[{path:"$.schemaVersion",message:`unsupported version ${JSON.stringify(r)}; expected ${ne}`}]);return{candidate:Xo(o),migratedFrom:Qo(r)}}i(ta,"migrateArkConfig");function Ct(e,t="ark.config.json"){let{candidate:n,migratedFrom:r}=ta(e,t),s=[];if(nt(n,gn,"$",gn,s),Fr(n,s),$r(n,s),s.length>0)throw new ye(t,s);return{config:n,migratedFrom:r}}i(Ct,"loadArkConfigContract");function yn(e,t="ark.config.json"){let n;try{n=JSON.parse(e)}catch(r){throw new ye(t,[{path:"$",message:`invalid JSON: ${r instanceof Error?r.message:String(r)}`}])}return Ct(n,t)}i(yn,"parseArkConfigJson");function Vr(e){let t={$schema:typeof e.$schema=="string"&&e.$schema.length>0?e.$schema:vt,schemaVersion:ne};for(let[n,r]of Object.entries(e))n!=="$schema"&&n!=="schemaVersion"&&(t[n]=r);return t}i(Vr,"withArkConfigMetadata");function na(e){return e.endsWith(".")?e:`${e}.`}i(na,"normalizePrefix");function ra(e,t){let n=e.prefixes.length?Math.max(...e.prefixes.map(s=>s.length)):0;return(t.prefixes.length?Math.max(...t.prefixes.map(s=>s.length)):0)-n}i(ra,"byLongestPrefix");function Ot(e){let t=e.layers.map(s=>({...s,prefixes:s.prefixes.map(na)})),n=[...t].sort(ra),r=[...e.rules??[]];return{name:e.name,layers:t,rules:r,resolveLayer(s){return t.find(o=>o.match?.(s))?.name??n.find(o=>o.prefixes.some(a=>s.startsWith(a)))?.name}}}i(Ot,"createArchitectureProfile");function Ur(e,t={}){return Ot({name:t.name??e.name??"ark.config.json",layers:e.layers.map((n,r)=>({name:n.name,prefixes:n.intentPrefixes??[],description:n.description,order:r+1})),rules:e.rules??[]})}i(Ur,"createArchitectureProfileFromArkConfig");var sa=[{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}],_t=Ot({name:"Ark 11-layer Hexagonal Event-Driven Profile",layers:sa,rules:bt.map(e=>({...e}))}),oa={DomainModel:["domain"],ApplicationOrchestration:["application","app"],PersistenceAdapters:["adapters/persistence","adapters/repository","repositories","infra/persistence"],IntegrationAdapters:["adapters/integration","adapters/external","integrations"],WorkflowSagaEngine:["workflows","sagas"],BackgroundJobsScheduling:["jobs","schedules"],PresentationAdapters:["presentation","adapters/presentation","adapters/api"],ReportingReadModels:["reporting","read-models","projections"],ExtensibilityMetadata:["metadata","extensions"],SecurityAuditObservability:["security","audit","observability"],Kernel:["kernel"]};function Kr(e={}){let t=e.rootDir??"src",n=e.optionalLayers??!0,r=t==="."?"":`${t}/`;return Vr({include:e.include??[t],layers:_t.layers.map(s=>({name:s.name,patterns:(oa[s.name]??[s.name]).map(o=>`${r}${o}/**`),intentPrefixes:s.prefixes,optional:n})),rules:[..._t.rules]})}i(Kr,"createElevenLayerArkConfig");function z(e){let t=2166136261;for(let n=0;n<e.length;n+=1)t^=e.charCodeAt(n),t=Math.imul(t,16777619);return`fnv1a-${(t>>>0).toString(16).padStart(8,"0")}`}i(z,"deterministicHash");function F(e){if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(F).join(",")}]`;let t=e;return`{${Object.keys(t).sort().map(n=>`${JSON.stringify(n)}:${F(t[n])}`).join(",")}}`}i(F,"stableSerialize");var Oe="1.2";var Gr=["network","filesystem","clock","randomness","environment","process","persistence"];function Z(e,t){let n=F(e),r=F(t);return n<r?-1:n>r?1:0}i(Z,"compareCanonical");function X(e){return[...new Set(e)].sort((t,n)=>t<n?-1:t>n?1:0)}i(X,"sortedUnique");function rt(e){let t={schemaVersion:"1.2",include:X(e.include??[]),exclude:X(e.exclude??[]),excludeGenerated:e.excludeGenerated!==!1,dynamicImportAllowlist:X(e.dynamicImportAllowlist??[]),layers:e.layers.map(n=>({name:n.name,patterns:X(n.patterns??[]),exclude:X(n.exclude??[]),forbiddenGlobals:X(n.forbiddenGlobals??[]),intentPrefixes:X(n.intentPrefixes??[]),capabilityDeny:X(n.capabilities?.deny??[]),pure:n.pure===!0})).sort(Z),safety:{maxTsSuppressions:e.safety?.maxTsSuppressions??0,maxAnyCasts:e.safety?.maxAnyCasts??0,allowInMemory:e.safety?.allowInMemory===!0,allowDisabledPeerIsolation:e.safety?.allowDisabledPeerIsolation===!0},...e.arkRun?{arkRun:{mode:e.arkRun.mode,compositionRoots:X(e.arkRun.compositionRoots),managedLayers:X(e.arkRun.managedLayers),requireDeclarations:e.arkRun.requireDeclarations===!0}}:{}};return z(F(t))}i(rt,"resolvedFactsEvidenceRequirementsHash");function aa(e){let t=e.completenessReasons.map(k=>({code:k.code,message:k.message,...k.file?{file:k.file}:{}})).sort(Z),n=e.files.map(k=>({...k,typeOnlyExportNames:X(k.typeOnlyExportNames)})).sort((k,b)=>k.path<b.path?-1:k.path>b.path?1:0),r=e.dependencies.map(k=>({...k,...k.namedBindings?{namedBindings:X(k.namedBindings)}:{}})).sort(Z),s=e.capabilityUses.map(k=>({...k})).sort(Z),o=e.ambientUses.map(k=>({...k})).sort(Z),a=e.publishCalls.map(k=>({...k})).sort(Z),l=e.intentReferences.map(k=>({...k})).sort(Z),c=e.safetyUses.map(k=>({...k})).sort(Z),p=(e.classShapes??[]).map(k=>({...k,mutatingMethods:[...k.mutatingMethods??[]].map(b=>({...b}))})).sort(Z),m=(e.arkRunKernelCalls??[]).map(k=>({...k})).sort(Z),g=(e.arkRunManagedNews??[]).map(k=>({...k})).sort(Z),u=(e.arkRunCompositionRootHits??[]).map(k=>({...k})).sort(Z),d=(e.arkRunDeclarations??[]).map(k=>({...k,uses:X(k.uses),reactsTo:X(k.reactsTo),raises:X(k.raises),sends:X(k.sends)})).sort(Z),f=(e.arkOrderPlaneCalls??[]).map(k=>({...k})).sort(Z),y=(e.arkOrderGenericUpdates??[]).map(k=>({...k})).sort(Z),I=(e.arkOrderRootHits??[]).map(k=>({...k})).sort(Z),N=e.files.map(({path:k,contentHash:b})=>({path:k,contentHash:b})).sort((k,b)=>k.path<b.path?-1:k.path>b.path?1:0),E=z(F(N));return{schemaVersion:"1.2",completeness:e.completeness,completenessReasons:t,resolverIdentity:e.resolverIdentity,compilerIdentity:e.compilerIdentity,compilerOptionsHash:e.compilerOptionsHash,tsconfigHash:e.tsconfigHash,candidateTreeHash:E,evidenceRequirementsHash:e.evidenceRequirementsHash,...e.projectPackageName?{projectPackageName:e.projectPackageName}:{},files:n,dependencies:r,capabilityUses:s,ambientUses:o,publishCalls:a,intentReferences:l,safetyUses:c,classShapes:p,arkRunKernelCalls:m,arkRunManagedNews:g,arkRunCompositionRootHits:u,arkRunDeclarations:d,arkOrderPlaneCalls:f,arkOrderGenericUpdates:y,arkOrderRootHits:I}}i(aa,"canonicalResolvedFactsInput");function Br(e){let t=aa(e);return{...t,factsHash:z(F(t))}}i(Br,"createCanonicalResolvedCandidateFacts");function hn(e){return Br(qr(U(e,"$"),!1))}i(hn,"createResolvedCandidateFacts");function U(e,t){if(!e||typeof e!="object"||Array.isArray(e))throw new Error(`${t} must be an object.`);return e}i(U,"asRecord");function K(e,t,n){let r=new Set(t),s=Object.keys(e).find(o=>!r.has(o));if(s)throw new Error(`${n}.${s} is not part of schema ${"1.2"}.`)}i(K,"assertOnlyKeys");function M(e,t,n){let r=e[t];if(typeof r!="string"||r.length===0)throw new Error(`${n}.${t} must be a non-empty string.`);return r}i(M,"requiredText");function he(e,t,n){if(e[t]!==void 0)return M(e,t,n)}i(he,"optionalText");function q(e,t,n){let r=M(e,t,n),s=r.replace(/\\/g,"/");if(!s||s.startsWith("/")||/^[A-Za-z]:\//.test(s)||/[\u0000-\u001f\u007f]/.test(s))throw new Error(`${n}.${t} must be a canonical project-relative path.`);let o=[];for(let l of s.split("/"))if(!(!l||l==="."))if(l===".."){if(o.length===0)throw new Error(`${n}.${t} must be a canonical project-relative path.`);o.pop()}else o.push(l);let a=o.join("/");if(!a||a!==r)throw new Error(`${n}.${t} must be a canonical project-relative path.`);return a}i(q,"requiredProjectPath");function j(e,t,n){if(typeof e[t]!="boolean")throw new Error(`${n}.${t} must be a boolean.`);return e[t]}i(j,"requiredBoolean");function zr(e,t,n){let r=e[t];if(!Number.isInteger(r)||Number(r)<0)throw new Error(`${n}.${t} must be a non-negative integer.`);return Number(r)}i(zr,"requiredInteger");function le(e,t,n){let r=zr(e,t,n);if(r===0)throw new Error(`${n}.${t} must be a positive integer.`);return r}i(le,"requiredPositiveInteger");function Y(e,t,n){let r=e[t];if(!Array.isArray(r))throw new Error(`${n}.${t} must be an array.`);return r}i(Y,"requiredArray");function Ae(e,t,n,r){let s=e[t];if(typeof s!="string"||!n.includes(s))throw new Error(`${r}.${t} must be one of ${n.join(", ")}.`);return s}i(Ae,"enumValue");function He(e,t){if(!Array.isArray(e)||e.some(n=>typeof n!="string"||!n))throw new Error(`${t} must be an array of non-empty strings.`);return[...e]}i(He,"parseStringArray");function ia(e,t,n){let r=new Set;for(let s of e){let o=t(s);if(r.has(o))throw new Error(`${n} must not contain duplicate facts (${o}).`);r.add(o)}}i(ia,"assertUnique");function qr(e,t){K(e,["schemaVersion","completeness","completenessReasons","resolverIdentity","compilerIdentity","compilerOptionsHash","tsconfigHash","evidenceRequirementsHash","projectPackageName","files","dependencies","capabilityUses","ambientUses","publishCalls","intentReferences","safetyUses","classShapes","arkRunKernelCalls","arkRunManagedNews","arkRunCompositionRootHits","arkRunDeclarations","arkOrderPlaneCalls","arkOrderGenericUpdates","arkOrderRootHits",...t?["candidateTreeHash","factsHash"]:[]],"$");let n=Ae(e,"schemaVersion",["1.0","1.1","1.2"],"$"),r=Ae(e,"completeness",["complete","partial","unavailable"],"$"),s=Y(e,"completenessReasons","$").map((v,_)=>{let A=`$.completenessReasons[${_}]`,R=U(v,A);K(R,["code","message","file"],A);let L=R.file===void 0?void 0:q(R,"file",A);return{code:M(R,"code",A),message:M(R,"message",A),...L?{file:L}:{}}});if(r==="complete"&&s.length>0)throw new Error("$.completenessReasons must be empty when completeness is complete.");if(r!=="complete"&&s.length===0)throw new Error("$.completenessReasons must explain partial or unavailable facts.");let o=Y(e,"files","$").map((v,_)=>{let A=`$.files[${_}]`,R=U(v,A);return K(R,["path","contentHash","parseStatus","parseDiagnosticCount","exportsOnlyTypes","typeOnlyExportNames","hasTopLevelSideEffects"],A),{path:q(R,"path",A),contentHash:M(R,"contentHash",A),parseStatus:Ae(R,"parseStatus",["parsed","invalid"],A),parseDiagnosticCount:zr(R,"parseDiagnosticCount",A),exportsOnlyTypes:j(R,"exportsOnlyTypes",A),typeOnlyExportNames:He(R.typeOnlyExportNames,`${A}.typeOnlyExportNames`),hasTopLevelSideEffects:j(R,"hasTopLevelSideEffects",A)}}),a=Y(e,"dependencies","$").map((v,_)=>{let A=`$.dependencies[${_}]`,R=U(v,A);K(R,["from","specifier","kind","typeOnly","line","resolution","target","namedBindings","targetTypeOnlyExports","sourcePureTypeModule","namedBindingsTypeOnly","portProofEligible"],A);let L=he(R,"specifier",A),B=he(R,"target",A),Se=Ae(R,"resolution",["resolved-project","resolved-external","unresolved","dynamic"],A);if(Se==="resolved-project"&&!B)throw new Error(`${A}.target is required for resolved-project dependencies.`);if(Se!=="resolved-project"&&B)throw new Error(`${A}.target is only allowed for resolved-project dependencies.`);if(Se!=="dynamic"&&!L)throw new Error(`${A}.specifier is required unless resolution is dynamic.`);return{from:q(R,"from",A),...L?{specifier:L}:{},kind:Ae(R,"kind",["import","export","dynamic-import","require"],A),typeOnly:j(R,"typeOnly",A),line:le(R,"line",A),resolution:Se,...B?{target:q(R,"target",A)}:{},...R.namedBindings!==void 0?{namedBindings:He(R.namedBindings,`${A}.namedBindings`)}:{},...R.targetTypeOnlyExports!==void 0?{targetTypeOnlyExports:j(R,"targetTypeOnlyExports",A)}:{},...R.sourcePureTypeModule!==void 0?{sourcePureTypeModule:j(R,"sourcePureTypeModule",A)}:{},...R.namedBindingsTypeOnly!==void 0?{namedBindingsTypeOnly:j(R,"namedBindingsTypeOnly",A)}:{},...R.portProofEligible!==void 0?{portProofEligible:j(R,"portProofEligible",A)}:{}}}),l=Y(e,"capabilityUses","$").map((v,_)=>{let A=`$.capabilityUses[${_}]`,R=U(v,A);return K(R,["file","line","symbol","capability","source"],A),{file:q(R,"file",A),line:le(R,"line",A),symbol:M(R,"symbol",A),capability:Ae(R,"capability",Gr,A),source:Ae(R,"source",["ambient-global","import-based"],A)}}),c=Y(e,"ambientUses","$").map((v,_)=>{let A=`$.ambientUses[${_}]`,R=U(v,A);return K(R,["file","line","symbol"],A),{file:q(R,"file",A),line:le(R,"line",A),symbol:M(R,"symbol",A)}}),p=Y(e,"publishCalls","$").map((v,_)=>{let A=`$.publishCalls[${_}]`,R=U(v,A);K(R,["file","line","rawIntentName","objectHasIntent","arkPublishCandidate","hasSource","sourceIntent"],A);let L=he(R,"rawIntentName",A),B=he(R,"sourceIntent",A);return{file:q(R,"file",A),line:le(R,"line",A),...L?{rawIntentName:L}:{},objectHasIntent:j(R,"objectHasIntent",A),arkPublishCandidate:j(R,"arkPublishCandidate",A),hasSource:j(R,"hasSource",A),...B?{sourceIntent:B}:{}}}),m=Y(e,"intentReferences","$").map((v,_)=>{let A=`$.intentReferences[${_}]`,R=U(v,A);return K(R,["file","line","intent"],A),{file:q(R,"file",A),line:le(R,"line",A),intent:M(R,"intent",A)}}),g=Y(e,"safetyUses","$").map((v,_)=>{let A=`$.safetyUses[${_}]`,R=U(v,A);K(R,["file","line","kind","symbol"],A);let L=he(R,"symbol",A),B=Ae(R,"kind",["ts-suppression","any-cast","dynamic-import","dynamic-require","in-memory-store"],A);if(B==="in-memory-store"&&!L)throw new Error(`${A}.symbol is required for in-memory-store facts.`);if(B!=="in-memory-store"&&L)throw new Error(`${A}.symbol is only allowed for in-memory-store facts.`);return{file:q(R,"file",A),line:le(R,"line",A),kind:B,...L?{symbol:L}:{}}});ia(o,v=>v.path,"$.files");let u=new Set(o.map(v=>v.path));for(let v of o){if(v.parseStatus==="parsed"&&v.parseDiagnosticCount!==0)throw new Error(`$.files[${v.path}].parseDiagnosticCount must be 0 when parseStatus is parsed.`);if(v.parseStatus==="invalid"&&v.parseDiagnosticCount===0)throw new Error(`$.files[${v.path}].parseDiagnosticCount must be positive when parseStatus is invalid.`)}if(r==="complete"&&o.some(v=>v.parseStatus==="invalid"))throw new Error("$.completeness cannot be complete when a candidate file failed to parse.");for(let v of a)if(!u.has(v.from))throw new Error(`$.dependencies references missing source file ${v.from}.`);let f=(e.arkRunKernelCalls===void 0?[]:Y(e,"arkRunKernelCalls","$")).map((v,_)=>{let A=`$.arkRunKernelCalls[${_}]`,R=U(v,A);K(R,["file","line","kind","callee","viaImport","receiver","nameLiteral"],A);let L=he(R,"receiver",A),B=he(R,"nameLiteral",A);return{file:q(R,"file",A),line:le(R,"line",A),kind:Ae(R,"kind",["factory","publisher","publish","raise","send","subscribe","register-handler","resolve","resolve-singleton"],A),callee:M(R,"callee",A),viaImport:j(R,"viaImport",A),...L?{receiver:L}:{},...B?{nameLiteral:B}:{}}}),I=(e.arkRunManagedNews===void 0?[]:Y(e,"arkRunManagedNews","$")).map((v,_)=>{let A=`$.arkRunManagedNews[${_}]`,R=U(v,A);K(R,["file","line","typeName","importedFrom"],A);let L=he(R,"importedFrom",A);return{file:q(R,"file",A),line:le(R,"line",A),typeName:M(R,"typeName",A),...L?{importedFrom:L}:{}}}),E=(e.arkRunCompositionRootHits===void 0?[]:Y(e,"arkRunCompositionRootHits","$")).map((v,_)=>{let A=`$.arkRunCompositionRootHits[${_}]`,R=U(v,A);return K(R,["file","matchedRoot","hasKernelFactory"],A),{file:q(R,"file",A),matchedRoot:M(R,"matchedRoot",A),hasKernelFactory:j(R,"hasKernelFactory",A)}}),k=e.arkRunDeclarations===void 0?[]:Y(e,"arkRunDeclarations","$"),J=(e.arkOrderPlaneCalls===void 0?[]:Y(e,"arkOrderPlaneCalls","$")).map((v,_)=>{let A=`$.arkOrderPlaneCalls[${_}]`,R=U(v,A);return K(R,["file","line","callee"],A),{file:q(R,"file",A),line:le(R,"line",A),callee:M(R,"callee",A)}}),G=(e.arkOrderGenericUpdates===void 0?[]:Y(e,"arkOrderGenericUpdates","$")).map((v,_)=>{let A=`$.arkOrderGenericUpdates[${_}]`,R=U(v,A);return K(R,["file","line","method"],A),{file:q(R,"file",A),line:le(R,"line",A),method:M(R,"method",A)}}),O=(e.arkOrderRootHits===void 0?[]:Y(e,"arkOrderRootHits","$")).map((v,_)=>{let A=`$.arkOrderRootHits[${_}]`,R=U(v,A);return K(R,["file","matchedRoot","hasPlaneFactory"],A),{file:q(R,"file",A),matchedRoot:M(R,"matchedRoot",A),hasPlaneFactory:j(R,"hasPlaneFactory",A)}}),D=k.map((v,_)=>{let A=`$.arkRunDeclarations[${_}]`,R=U(v,A);return K(R,["file","line","uses","reactsTo","raises","sends"],A),{file:q(R,"file",A),line:le(R,"line",A),uses:He(R.uses,`${A}.uses`),reactsTo:He(R.reactsTo,`${A}.reactsTo`),raises:He(R.raises,`${A}.raises`),sends:He(R.sends,`${A}.sends`)}});for(let[v,_]of[["$.capabilityUses",l],["$.ambientUses",c],["$.publishCalls",p],["$.intentReferences",m],["$.safetyUses",g],["$.arkRunKernelCalls",f],["$.arkRunManagedNews",I],["$.arkRunCompositionRootHits",E],["$.arkRunDeclarations",D],["$.arkOrderPlaneCalls",J],["$.arkOrderGenericUpdates",G],["$.arkOrderRootHits",O]])for(let A of _)if(!u.has(A.file))throw new Error(`${v} references missing file ${A.file}.`);let P=he(e,"projectPackageName","$"),fe=(e.classShapes===void 0?[]:Y(e,"classShapes","$")).map((v,_)=>{let A=`$.classShapes[${_}]`,R=U(v,A);K(R,["file","className","exported","hasPublicMutableFields","hasPublicSetters","hasPublicConstructor","hasStaticFactory","mutatingMethods","dataOnly"],A);let L=Y(R,"mutatingMethods",A).map((B,Se)=>{let be=`${A}.mutatingMethods[${Se}]`,Be=U(B,be);return K(Be,["name","referencesGuardOrPublish"],be),{name:M(Be,"name",be),referencesGuardOrPublish:j(Be,"referencesGuardOrPublish",be)}});return{file:q(R,"file",A),className:M(R,"className",A),exported:j(R,"exported",A),hasPublicMutableFields:j(R,"hasPublicMutableFields",A),hasPublicSetters:j(R,"hasPublicSetters",A),hasPublicConstructor:j(R,"hasPublicConstructor",A),hasStaticFactory:j(R,"hasStaticFactory",A),mutatingMethods:L,...R.dataOnly===void 0?{}:{dataOnly:j(R,"dataOnly",A)}}});return{schemaVersion:n,completeness:r,completenessReasons:s,resolverIdentity:M(e,"resolverIdentity","$"),compilerIdentity:M(e,"compilerIdentity","$"),compilerOptionsHash:M(e,"compilerOptionsHash","$"),tsconfigHash:M(e,"tsconfigHash","$"),evidenceRequirementsHash:M(e,"evidenceRequirementsHash","$"),...P?{projectPackageName:P}:{},files:o,dependencies:a,capabilityUses:l,ambientUses:c,publishCalls:p,intentReferences:m,safetyUses:g,classShapes:fe,arkRunKernelCalls:f,arkRunManagedNews:I,arkRunCompositionRootHits:E,arkRunDeclarations:D,arkOrderPlaneCalls:J,arkOrderGenericUpdates:G,arkOrderRootHits:O}}i(qr,"parseResolvedFactsInput");function ve(e){let t=U(e,"$"),n=M(t,"factsHash","$"),r=M(t,"candidateTreeHash","$"),s=Br(qr(t,!0));if(s.factsHash!==n)throw new Error(`$.factsHash does not match the canonical payload (${s.factsHash}).`);if(r!==s.candidateTreeHash)throw new Error(`$.candidateTreeHash does not match the canonical file tree (${s.candidateTreeHash}).`);return s}i(ve,"loadResolvedCandidateFacts");var la=["network","filesystem","clock","randomness","environment","process","persistence"],x={type:"string",minLength:1},ce={type:"integer",minimum:1},W={type:"string",minLength:1,pattern:"^(?!/)(?![A-Za-z]:/)(?!.*\\\\)(?!.*//)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*[\\u0000-\\u001f\\u007f])(?!.*\\/$).+$"},An={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://unpkg.com/arkgate@3/schemas/ark.resolved-candidate-facts.schema.json",title:"ArkGate resolved candidate facts",type:"object",additionalProperties:!1,required:["schemaVersion","completeness","completenessReasons","resolverIdentity","compilerIdentity","compilerOptionsHash","tsconfigHash","candidateTreeHash","evidenceRequirementsHash","files","dependencies","capabilityUses","ambientUses","publishCalls","intentReferences","safetyUses","factsHash"],properties:{schemaVersion:{enum:["1.0","1.1","1.2"]},completeness:{enum:["complete","partial","unavailable"]},completenessReasons:{type:"array",items:{type:"object",additionalProperties:!1,required:["code","message"],properties:{code:x,message:x,file:W}}},resolverIdentity:x,compilerIdentity:x,compilerOptionsHash:x,tsconfigHash:x,candidateTreeHash:x,evidenceRequirementsHash:x,projectPackageName:x,files:{type:"array",uniqueItems:!0,items:{type:"object",additionalProperties:!1,required:["path","contentHash","parseStatus","parseDiagnosticCount","exportsOnlyTypes","typeOnlyExportNames","hasTopLevelSideEffects"],properties:{path:W,contentHash:x,parseStatus:{enum:["parsed","invalid"]},parseDiagnosticCount:{type:"integer",minimum:0},exportsOnlyTypes:{type:"boolean"},typeOnlyExportNames:{type:"array",items:x},hasTopLevelSideEffects:{type:"boolean"}},allOf:[{if:{properties:{parseStatus:{const:"parsed"}}},then:{properties:{parseDiagnosticCount:{const:0}}}},{if:{properties:{parseStatus:{const:"invalid"}}},then:{properties:{parseDiagnosticCount:{minimum:1}}}}]}},dependencies:{type:"array",items:{type:"object",additionalProperties:!1,required:["from","kind","typeOnly","line","resolution"],properties:{from:W,specifier:x,kind:{enum:["import","export","dynamic-import","require"]},typeOnly:{type:"boolean"},line:ce,resolution:{enum:["resolved-project","resolved-external","unresolved","dynamic"]},target:W,namedBindings:{type:"array",items:x},targetTypeOnlyExports:{type:"boolean"},sourcePureTypeModule:{type:"boolean"},namedBindingsTypeOnly:{type:"boolean"},portProofEligible:{type:"boolean"}},allOf:[{if:{properties:{resolution:{const:"resolved-project"}}},then:{required:["target"]},else:{not:{required:["target"]}}},{if:{properties:{resolution:{const:"dynamic"}}},else:{required:["specifier"]}}]}},capabilityUses:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","symbol","capability","source"],properties:{file:W,line:ce,symbol:x,capability:{enum:la},source:{enum:["ambient-global","import-based"]}}}},ambientUses:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","symbol"],properties:{file:W,line:ce,symbol:x}}},publishCalls:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","objectHasIntent","arkPublishCandidate","hasSource"],properties:{file:W,line:ce,rawIntentName:x,objectHasIntent:{type:"boolean"},arkPublishCandidate:{type:"boolean"},hasSource:{type:"boolean"},sourceIntent:x}}},intentReferences:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","intent"],properties:{file:W,line:ce,intent:x}}},safetyUses:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","kind"],properties:{file:W,line:ce,kind:{enum:["ts-suppression","any-cast","dynamic-import","dynamic-require","in-memory-store"]},symbol:x},allOf:[{if:{properties:{kind:{const:"in-memory-store"}}},then:{required:["symbol"]},else:{not:{required:["symbol"]}}}]}},classShapes:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","className","exported","hasPublicMutableFields","hasPublicSetters","hasPublicConstructor","hasStaticFactory","mutatingMethods"],properties:{file:W,className:x,exported:{type:"boolean"},hasPublicMutableFields:{type:"boolean"},hasPublicSetters:{type:"boolean"},hasPublicConstructor:{type:"boolean"},hasStaticFactory:{type:"boolean"},dataOnly:{type:"boolean"},mutatingMethods:{type:"array",items:{type:"object",additionalProperties:!1,required:["name","referencesGuardOrPublish"],properties:{name:x,referencesGuardOrPublish:{type:"boolean"}}}}}}},arkRunKernelCalls:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","kind","callee","viaImport"],properties:{file:W,line:ce,kind:{enum:["factory","publisher","publish","raise","send","subscribe","register-handler","resolve","resolve-singleton"]},callee:x,viaImport:{type:"boolean"},receiver:x,nameLiteral:x}}},arkRunManagedNews:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","typeName"],properties:{file:W,line:ce,typeName:x,importedFrom:x}}},arkRunCompositionRootHits:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","matchedRoot","hasKernelFactory"],properties:{file:W,matchedRoot:x,hasKernelFactory:{type:"boolean"}}}},arkRunDeclarations:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","uses","reactsTo","raises","sends"],properties:{file:W,line:ce,uses:{type:"array",items:x},reactsTo:{type:"array",items:x},raises:{type:"array",items:x},sends:{type:"array",items:x}}}},arkOrderPlaneCalls:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","callee"],properties:{file:W,line:ce,callee:x}}},arkOrderGenericUpdates:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","line","method"],properties:{file:W,line:ce,method:x}}},arkOrderRootHits:{type:"array",items:{type:"object",additionalProperties:!1,required:["file","matchedRoot","hasPlaneFactory"],properties:{file:W,matchedRoot:x,hasPlaneFactory:{type:"boolean"}}}},factsHash:x},allOf:[{if:{properties:{completeness:{const:"complete"}}},then:{properties:{completenessReasons:{maxItems:0},files:{items:{properties:{parseStatus:{const:"parsed"}}}}}}},{if:{properties:{completeness:{enum:["partial","unavailable"]}}},then:{properties:{completenessReasons:{minItems:1}}}}]};var Rn="1.0";function re(e){return`${e.from}->${e.to}`}i(re,"dependencyKey");function st(e,t,n,r="dependency"){return{id:`${e}:${r}:${re(t)}`,classification:e,subject:"dependency",from:t.from,to:t.to,message:n,...e==="missing"?{nextAction:`Add the planned dependency ${re(t)} to the candidate, then preflight again.`}:e==="contradictory"?{nextAction:`Replace the reverse dependency with ${re(t)}, then preflight again.`}:e==="unplanned"?{nextAction:r==="dependency-removed"?`Restore the removed dependency ${re(t)} in the candidate, then preflight again.`:`Remove the unplanned dependency ${re(t)} from the candidate, then preflight again.`}:{}}}i(st,"dependencyFinding");function je(e){let t=[],n=new Map(e.changeMap.map.files.map(u=>[u.path,u])),r=new Map(e.changes.map(u=>[u.path,u])),s=new Map(e.changeMap.map.dependencies.map(u=>[re(u),u])),o=new Map(e.baseDependencies.map(u=>[re(u),u])),a=new Map(e.candidateDependencies.map(u=>[re(u),u]));for(let u of[...n.values()].sort((d,f)=>d.path.localeCompare(f.path))){let d=r.get(u.path);d?d.operation!==u.operation?t.push({id:`contradictory:file:${u.path}`,classification:"contradictory",subject:"file",path:u.path,expectedOperation:u.operation,actualOperation:d.operation,message:`${u.path} was planned as ${u.operation} but the actual operation is ${d.operation}.`,nextAction:`Change ${u.path} to the planned ${u.operation} operation, then preflight again.`}):t.push({id:`satisfied:file:${u.path}`,classification:"satisfied",subject:"file",path:u.path,expectedOperation:u.operation,actualOperation:d.operation,message:`${u.path} matches the planned ${u.operation} operation.`}):t.push({id:`missing:file:${u.path}`,classification:"missing",subject:"file",path:u.path,expectedOperation:u.operation,message:`${u.path} was planned as ${u.operation} but is absent from the actual change.`,nextAction:`${u.operation[0].toUpperCase()}${u.operation.slice(1)} ${u.path} in the complete change set, then preflight again.`})}for(let u of[...r.values()].sort((d,f)=>d.path.localeCompare(f.path)))n.has(u.path)||t.push({id:`unplanned:file:${u.path}`,classification:"unplanned",subject:"file",path:u.path,actualOperation:u.operation,message:`${u.path} has an unplanned ${u.operation} operation.`,nextAction:`Remove ${u.path} from the change set, then preflight again.`});let l=new Set;for(let u of[...s.values()].sort((d,f)=>re(d).localeCompare(re(f)))){if(a.has(re(u))){t.push(st("satisfied",u,`${u.from} -> ${u.to} exists in the candidate architecture.`));continue}let d={from:u.to,to:u.from};a.has(re(d))?(l.add(re(d)),t.push(st("contradictory",u,`${u.from} -> ${u.to} was planned, but the candidate contains the reverse edge.`))):t.push(st("missing",u,`${u.from} -> ${u.to} is absent from the candidate architecture.`))}let c=new Set([...n.keys(),...r.keys()]);for(let[u,d]of[...a].sort(([f],[y])=>f.localeCompare(y)))o.has(u)||s.has(u)||l.has(u)||!c.has(d.from)&&!c.has(d.to)||t.push({...st("unplanned",d,`${d.from} -> ${d.to} was added without a matching planned dependency.`,"dependency-added"),actualOperation:"added"});let p=new Set(e.changeMap.map.files.filter(u=>u.operation==="delete").map(u=>u.path));for(let[u,d]of[...o].sort(([f],[y])=>f.localeCompare(y)))a.has(u)||p.has(d.from)||p.has(d.to)||!c.has(d.from)&&!c.has(d.to)||t.push({...st("unplanned",d,`${d.from} -> ${d.to} was removed without a planned file deletion.`,"dependency-removed"),actualOperation:"removed"});let m={satisfied:0,missing:1,contradictory:2,unplanned:3};t.sort((u,d)=>m[u.classification]-m[d.classification]||(u.subject===d.subject?0:u.subject==="file"?-1:1)||u.id.localeCompare(d.id));let g={satisfied:t.filter(u=>u.classification==="satisfied").length,missing:t.filter(u=>u.classification==="missing").length,contradictory:t.filter(u=>u.classification==="contradictory").length,unplanned:t.filter(u=>u.classification==="unplanned").length};return{schemaVersion:"1.0",readOnly:!0,changeMapHash:e.changeMap.hash,structurallyConverged:g.missing===0&&g.contradictory===0&&g.unplanned===0,behavioralCompletion:"not-evaluated",summary:g,findings:t}}i(je,"analyzeArchitectureConvergence");var ca="1.0",kn="https://unpkg.com/arkgate/schemas/ark.arkrules.schema.json",Jr=["aggregate-private-state","always-valid-factory","domain-event-on-mutation","orchestration-only","thin-adapter","no-anemic-model","invariant-coverage"],da=["no-anemic-model"],Yr={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},En={$schema:"https://json-schema.org/draft/2020-12/schema",$id:kn,title:"ArkGate ArkRules (intra-layer contract)",description:"Per-layer structure sensors and invariant catalog consumed by the ArkGate Effective Contract.",type:"object",additionalProperties:!1,required:["schemaVersion","layer"],properties:{$schema:{type:"string",minLength:1,default:kn},schemaVersion:{type:"string",const:"1.0",default:"1.0"},layer:{type:"string",minLength:1},structure:{type:"array",default:[],items:{$ref:"#/$defs/structureEntry"}},invariants:{type:"array",default:[],items:{$ref:"#/$defs/invariantEntry"}}},$defs:{structureEntry:{type:"object",additionalProperties:!1,required:["id","sensor"],properties:{id:{type:"string",minLength:1},sensor:{type:"string",enum:[...Jr]},mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},appliesTo:Yr,description:{type:"string",minLength:1}}},invariantEntry:{type:"object",additionalProperties:!1,required:["id","description"],properties:{id:{type:"string",minLength:1},description:{type:"string",minLength:1},aggregate:{type:"string",minLength:1},coverage:{type:"object",additionalProperties:!1,properties:{test:{type:"boolean"},symbol:{type:"string",minLength:1}}},mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},appliesTo:Yr}}}},xe=class extends Error{static{i(this,"ArkRulesValidationError")}issues;source;constructor(t,n){super(`Invalid ArkRules (${t}):
|
package/dist/nestjs/index.cjs
CHANGED
|
@@ -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),f=o.slice(l).concat(d);n.push(f)}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 me}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 Y=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 xi=new Y;function We(){return new Y}s(We,"createIntentRegistry");var ee={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Bt={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},compositionRoots:{...ee,default:[]},kernelRoots:{...ee},managedLayers:{...ee,default:[]},requireDeclarations:{type:"boolean",default:!0},ignoreDirectNewForErrors:{type:"boolean",default:!0}}},Ht={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},planeRoots:{...ee,default:[]},managedLayers:{...ee,default:[]},maxXiKeys:{type:"integer",minimum:1,default:7}}};var Vt="1.3",Ut="https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",Wt=["DomainModel","ApplicationOrchestration","PersistenceAdapters","IntegrationAdapters","WorkflowSagaEngine","BackgroundJobsScheduling","PresentationAdapters","ReportingReadModels","ExtensibilityMetadata","SecurityAuditObservability","Kernel"],fr=new Set(["PresentationAdapters->ApplicationOrchestration","ApplicationOrchestration->DomainModel","WorkflowSagaEngine->ApplicationOrchestration","WorkflowSagaEngine->DomainModel","BackgroundJobsScheduling->ApplicationOrchestration"]);function mr(){let t=[];for(let e of Wt)for(let n of Wt)e===n||fr.has(`${e}->${n}`)||t.push({from:e,to:n,allowed:!1});return t}s(mr,"createDefaultRules");var qe=mr();var I={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Vi={$schema:"https://json-schema.org/draft/2020-12/schema",$id:Ut,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:Ut,description:"Editor-facing URL or local path for this JSON Schema."},schemaVersion:{type:"string",const:Vt,default:Vt},name:{type:"string",minLength:1},include:{...I,minItems:1,default:["src"]},exclude:{...I,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:{...I,default:[]},safety:{$ref:"#/$defs/safety",default:{maxTsSuppressions:0,maxAnyCasts:0,allowInMemory:!1,allowDisabledPeerIsolation:!1}},arkRules:{type:"object",additionalProperties:{type:"string",minLength:1},default:{}},arkRun:{$ref:"#/$defs/arkRun"},arkOrder:{$ref:"#/$defs/arkOrder"},stewards:{...I,default:[]}},$defs:{layer:{type:"object",additionalProperties:!1,required:["name","patterns"],properties:{name:{type:"string",minLength:1},patterns:{...I,minItems:1},exclude:I,intentPrefixes:I,description:{type:"string",minLength:1},forbiddenGlobals:I,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:{...I,minItems: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}}},arkRun:Bt,arkOrder:Ht}};function gr(t){return t.endsWith(".")?t:`${t}.`}s(gr,"normalizePrefix");function yr(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(yr,"byLongestPrefix");function qt(t){let e=t.layers.map(o=>({...o,prefixes:o.prefixes.map(gr)})),n=[...e].sort(yr),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(qt,"createArchitectureProfile");var hr=[{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}],Je=qt({name:"Ark 11-layer Hexagonal Event-Driven Profile",layers:hr,rules:qe.map(t=>({...t}))});var Jt="4.8.1";function Rr(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")}s(Rr,"policyId");var ze=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(g=>({name:g.name,dependencies:e.getDependencies(g.name),productions:e.getProductions(g.name)})):[],f=e?e.getAllRelationships():[],y=n?n.getPolicies().map(g=>({id:Rr(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})):[],p=r?r.toJSON():[],m=o?o.toJSON():{nodes:[],edges:[]},h=p.filter(g=>(g.emits?.length??0)>0||(g.consumes?.length??0)>0).map(g=>({entity:g.name,emits:g.emits,consumes:g.consumes})),u=a?a.list().map(g=>({name:g.name,sourceIntents:g.sourceIntents,checkpoint:a.getCheckpoint(g.name)})):[],v={schemaVersion:"1.0",version:Jt,exportedAt:new Date().toISOString(),intents:l,relationships:f,policies:y,entities:p,graph:m,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 ze(v)}s(Qe,"createArkManifest");var ge=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 Ze(){return new ge}s(Ze,"createMetadataRegistry");function Xe(t){return`${t.from}->${t.to}`}s(Xe,"flowKey");function Qt(t){let e=new Set,n=[];for(let r of t){let o=Xe(r);e.has(o)||(e.add(o),n.push(r))}return n}s(Qt,"uniqueFlows");function Zt(t,e){let n=new Set(e.map(Xe));return t.filter(r=>!n.has(Xe(r)))}s(Zt,"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=Qt([...o,...i]),l=Qt([...a,...c]),f=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)))):[],p=e?Array.from(new Set(l.map(u=>u.to).filter(u=>!e.has(u)))):[],m=new Set(l.flatMap(u=>[u.from,u.to])),h=e?e.list().map(u=>u.name).filter(u=>!m.has(u)):[];return{generatedAt:new Date().toISOString(),declaredProductions:d,observedProductions:l,declaredButUnobserved:Zt(d,l),observedButUndeclared:Zt(l.filter(u=>u.from!=="unknown"),d),unknownSources:f,unregisteredObservedSources:y,unregisteredObservedIntents:p,registeredButNeverObserved:h}}}}s(Ye,"createObservabilityReporter");var Xt=0;function Ar(){return Xt+=1,`outbox-${Date.now()}-${Xt}`}s(Ar,"nextOutboxId");function Yt(t){return{...t,event:{...t.event,metadata:{...t.event.metadata}}}}s(Yt,"cloneRecord");var te=class{static{s(this,"InMemoryEventBuffer")}records=new Map;async enqueue(e){let n=new Date().toISOString(),r={id:Ar(),event:e,status:"pending",attempts:0,createdAt:n,updatedAt:n};return this.records.set(r.id,r),Yt(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(Yt)}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 wr(t){return typeof t.initialState=="function"?t.initialState():t.initialState}s(wr,"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)??wr(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 en=0;function Ir(t){return en+=1,`${t}-${Date.now()}-${en}`}s(Ir,"createWorkflowId");function tt(t){return t instanceof Error?t.message:String(t)}s(tt,"errorMessage");function Er(t){return new Promise(e=>{setTimeout(e,t)})}s(Er,"sleep");async function vr(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(vr,"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??Ir(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 vr(d=>Promise.resolve(n.execute(e.context,this.bus,d)),n.timeoutMs,n.name)}catch(d){if(a<i){o.delayMs&&await Er(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 Pr=new Set(["singleton","transient"]);function tn(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(tn,"cloneComponent");function Sr(t){if(t===void 0)return"singleton";if(typeof t=="string"&&Pr.has(t))return t;throw new Error('ArkRun component lifetime must be "singleton" or "transient".')}s(Sr,"closedLifetime");function nn(){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=Sr(a.lifetime),l=ve({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 f=typeof a.factory=="function"?a.factory:void 0;return t.set(c,{component:l,factory:f}),tn(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=>tn(a.component))}}}s(nn,"createComponentRegistry");ce();async function sn(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(()=>(on(),rn));return r(t,{bind:n,sseIntervalMs:e.sseIntervalMs})}s(sn,"startArkRunInspector");ie();function Dr(t){let e={...t.metadata??{}};if(t.source===void 0)return e;if(e.source&&e.source!==t.source)throw new x(t.source,e.source);return e.source=t.source,e}s(Dr,"stampMetadata");function Tr(){}s(Tr,"ignoreDetachedFailure");async function ot(t,e,n,r={}){let o=At({transport:r.transport,ephemeral:r.ephemeral??t.defaultEphemeral,brokerBound:typeof t.broker?.send=="function"}),i=Dr(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,Tr)}return o}s(ot,"sendOnArkRunTransport");var $r=1e3,an=0;function Mr(){return an+=1,`ark-kernel-${Date.now()}-${an}`}s(Mr,"nextKernelInstanceId");function cn(t={}){let e=t.strict??!0,n=t.instanceId??Mr(),r=t.profile??Je,o=t.maxHistorySize??$r,i=We(),a=Ve(),c=t.metadata??Ze(),d=t.auditTrail??Me({maxRecords:o}),l=t.eventContracts??He(),f=t.eventBuffer??t.outbox??new te,y=t.projections??et({auditTrail:d}),p=new O([Le(r),...t.policies??[]]),m=s(()=>{Ue(i,a,{requireRegisteredTargets:!0})},"syncGraph"),h=t.ephemeral??!0,u=t.broker,v=new X({intentRegistry:i,dependencyGraph:a,policyEngine:p,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:f,instanceId:n,maxHistorySize:o,onPublish:t.autoApplyProjections===!1?void 0:async k=>{await y.apply(k)}}),g=rt(v,{auditTrail:d}),we=Ye({registry:i,eventBus:v,graph:a}),b=nn(),dn=typeof u?.send=="function",it={instanceId:n,profile:r,registry:i,graph:a,metadata:c,auditTrail:d,eventContracts:l,eventBuffer:f,outbox:f,projections:y,policyEngine:p,eventBus:v,workflowEngine:g,observability:we,publisher(k){let M=v.createPublisher(k);return{source:M.source,publish:M.publish,send(Ie,ln,un={}){return ot({eventBus:v,broker:u,defaultEphemeral:h},Ie,ln,{...un,source:M.source})}}},send(k,M,Ie={}){return ot({eventBus:v,broker:u,defaultEphemeral:h},k,M,Ie)},register(k){return b.register(k)},resolve(k){return b.resolve(k)},resolveSingleton(k){return b.resolveSingleton(k)},getDependencyInformationPackage(){return P({kernelInstanceId:n,components:b.snapshotComponents()})},requestGraph(k){return Rt({kernelInstanceId:n,components:b.snapshotComponents()},k)},getInspectorSnapshot(k){return Pt({kernelInstanceId:n,host:k?.host,port:k?.port,package:{kernelInstanceId:n,components:b.snapshotComponents()},observability:we.report(),ephemeralDefault:h,brokerBound:dn})},startInspector(k){return sn(it,k)},syncGraph:m,manifest(){return m(),Qe({registry:i,policyEngine:p,metadata:c,graph:a,profile:r,projections:y,eventContracts:l,observability:we})}};return it}s(cn,"createArkKernel");var $=Symbol("ARK_KERNEL"),_r=s(()=>(0,Ae.Inject)($),"InjectArk"),E=class{static forRoot(e){let n=e&&"registry"in e?e:cn(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 l=o.indexOf(d),f=o.slice(l).concat(d);n.push(f)}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 me}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 Y=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 xi=new Y;function We(){return new Y}s(We,"createIntentRegistry");var ee={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Bt={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},compositionRoots:{...ee,default:[]},kernelRoots:{...ee},managedLayers:{...ee,default:[]},requireDeclarations:{type:"boolean",default:!0},ignoreDirectNewForErrors:{type:"boolean",default:!0}}},Ht={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},planeRoots:{...ee,default:[]},managedLayers:{...ee,default:[]},maxXiKeys:{type:"integer",minimum:1,default:7}}};var Vt="1.3",Ut="https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",Wt=["DomainModel","ApplicationOrchestration","PersistenceAdapters","IntegrationAdapters","WorkflowSagaEngine","BackgroundJobsScheduling","PresentationAdapters","ReportingReadModels","ExtensibilityMetadata","SecurityAuditObservability","Kernel"],fr=new Set(["PresentationAdapters->ApplicationOrchestration","ApplicationOrchestration->DomainModel","WorkflowSagaEngine->ApplicationOrchestration","WorkflowSagaEngine->DomainModel","BackgroundJobsScheduling->ApplicationOrchestration"]);function mr(){let t=[];for(let e of Wt)for(let n of Wt)e===n||fr.has(`${e}->${n}`)||t.push({from:e,to:n,allowed:!1});return t}s(mr,"createDefaultRules");var qe=mr();var I={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Vi={$schema:"https://json-schema.org/draft/2020-12/schema",$id:Ut,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:Ut,description:"Editor-facing URL or local path for this JSON Schema."},schemaVersion:{type:"string",const:Vt,default:Vt},name:{type:"string",minLength:1},include:{...I,minItems:1,default:["src"]},exclude:{...I,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:{...I,default:[]},safety:{$ref:"#/$defs/safety",default:{maxTsSuppressions:0,maxAnyCasts:0,allowInMemory:!1,allowDisabledPeerIsolation:!1}},arkRules:{type:"object",additionalProperties:{type:"string",minLength:1},default:{}},arkRun:{$ref:"#/$defs/arkRun"},arkOrder:{$ref:"#/$defs/arkOrder"},stewards:{...I,default:[]}},$defs:{layer:{type:"object",additionalProperties:!1,required:["name","patterns"],properties:{name:{type:"string",minLength:1},patterns:{...I,minItems:1},exclude:I,intentPrefixes:I,description:{type:"string",minLength:1},forbiddenGlobals:I,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:{...I,minItems: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}}},arkRun:Bt,arkOrder:Ht}};function gr(t){return t.endsWith(".")?t:`${t}.`}s(gr,"normalizePrefix");function yr(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(yr,"byLongestPrefix");function qt(t){let e=t.layers.map(o=>({...o,prefixes:o.prefixes.map(gr)})),n=[...e].sort(yr),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(qt,"createArchitectureProfile");var hr=[{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}],Je=qt({name:"Ark 11-layer Hexagonal Event-Driven Profile",layers:hr,rules:qe.map(t=>({...t}))});var Jt="4.8.2";function Rr(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")}s(Rr,"policyId");var ze=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(g=>({name:g.name,dependencies:e.getDependencies(g.name),productions:e.getProductions(g.name)})):[],f=e?e.getAllRelationships():[],y=n?n.getPolicies().map(g=>({id:Rr(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})):[],p=r?r.toJSON():[],m=o?o.toJSON():{nodes:[],edges:[]},h=p.filter(g=>(g.emits?.length??0)>0||(g.consumes?.length??0)>0).map(g=>({entity:g.name,emits:g.emits,consumes:g.consumes})),u=a?a.list().map(g=>({name:g.name,sourceIntents:g.sourceIntents,checkpoint:a.getCheckpoint(g.name)})):[],v={schemaVersion:"1.0",version:Jt,exportedAt:new Date().toISOString(),intents:l,relationships:f,policies:y,entities:p,graph:m,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 ze(v)}s(Qe,"createArkManifest");var ge=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 Ze(){return new ge}s(Ze,"createMetadataRegistry");function Xe(t){return`${t.from}->${t.to}`}s(Xe,"flowKey");function Qt(t){let e=new Set,n=[];for(let r of t){let o=Xe(r);e.has(o)||(e.add(o),n.push(r))}return n}s(Qt,"uniqueFlows");function Zt(t,e){let n=new Set(e.map(Xe));return t.filter(r=>!n.has(Xe(r)))}s(Zt,"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=Qt([...o,...i]),l=Qt([...a,...c]),f=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)))):[],p=e?Array.from(new Set(l.map(u=>u.to).filter(u=>!e.has(u)))):[],m=new Set(l.flatMap(u=>[u.from,u.to])),h=e?e.list().map(u=>u.name).filter(u=>!m.has(u)):[];return{generatedAt:new Date().toISOString(),declaredProductions:d,observedProductions:l,declaredButUnobserved:Zt(d,l),observedButUndeclared:Zt(l.filter(u=>u.from!=="unknown"),d),unknownSources:f,unregisteredObservedSources:y,unregisteredObservedIntents:p,registeredButNeverObserved:h}}}}s(Ye,"createObservabilityReporter");var Xt=0;function Ar(){return Xt+=1,`outbox-${Date.now()}-${Xt}`}s(Ar,"nextOutboxId");function Yt(t){return{...t,event:{...t.event,metadata:{...t.event.metadata}}}}s(Yt,"cloneRecord");var te=class{static{s(this,"InMemoryEventBuffer")}records=new Map;async enqueue(e){let n=new Date().toISOString(),r={id:Ar(),event:e,status:"pending",attempts:0,createdAt:n,updatedAt:n};return this.records.set(r.id,r),Yt(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(Yt)}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 wr(t){return typeof t.initialState=="function"?t.initialState():t.initialState}s(wr,"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)??wr(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 en=0;function Ir(t){return en+=1,`${t}-${Date.now()}-${en}`}s(Ir,"createWorkflowId");function tt(t){return t instanceof Error?t.message:String(t)}s(tt,"errorMessage");function Er(t){return new Promise(e=>{setTimeout(e,t)})}s(Er,"sleep");async function vr(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(vr,"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??Ir(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 vr(d=>Promise.resolve(n.execute(e.context,this.bus,d)),n.timeoutMs,n.name)}catch(d){if(a<i){o.delayMs&&await Er(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 Pr=new Set(["singleton","transient"]);function tn(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(tn,"cloneComponent");function Sr(t){if(t===void 0)return"singleton";if(typeof t=="string"&&Pr.has(t))return t;throw new Error('ArkRun component lifetime must be "singleton" or "transient".')}s(Sr,"closedLifetime");function nn(){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=Sr(a.lifetime),l=ve({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 f=typeof a.factory=="function"?a.factory:void 0;return t.set(c,{component:l,factory:f}),tn(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=>tn(a.component))}}}s(nn,"createComponentRegistry");ce();async function sn(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(()=>(on(),rn));return r(t,{bind:n,sseIntervalMs:e.sseIntervalMs})}s(sn,"startArkRunInspector");ie();function Dr(t){let e={...t.metadata??{}};if(t.source===void 0)return e;if(e.source&&e.source!==t.source)throw new x(t.source,e.source);return e.source=t.source,e}s(Dr,"stampMetadata");function Tr(){}s(Tr,"ignoreDetachedFailure");async function ot(t,e,n,r={}){let o=At({transport:r.transport,ephemeral:r.ephemeral??t.defaultEphemeral,brokerBound:typeof t.broker?.send=="function"}),i=Dr(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,Tr)}return o}s(ot,"sendOnArkRunTransport");var $r=1e3,an=0;function Mr(){return an+=1,`ark-kernel-${Date.now()}-${an}`}s(Mr,"nextKernelInstanceId");function cn(t={}){let e=t.strict??!0,n=t.instanceId??Mr(),r=t.profile??Je,o=t.maxHistorySize??$r,i=We(),a=Ve(),c=t.metadata??Ze(),d=t.auditTrail??Me({maxRecords:o}),l=t.eventContracts??He(),f=t.eventBuffer??t.outbox??new te,y=t.projections??et({auditTrail:d}),p=new O([Le(r),...t.policies??[]]),m=s(()=>{Ue(i,a,{requireRegisteredTargets:!0})},"syncGraph"),h=t.ephemeral??!0,u=t.broker,v=new X({intentRegistry:i,dependencyGraph:a,policyEngine:p,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:f,instanceId:n,maxHistorySize:o,onPublish:t.autoApplyProjections===!1?void 0:async k=>{await y.apply(k)}}),g=rt(v,{auditTrail:d}),we=Ye({registry:i,eventBus:v,graph:a}),b=nn(),dn=typeof u?.send=="function",it={instanceId:n,profile:r,registry:i,graph:a,metadata:c,auditTrail:d,eventContracts:l,eventBuffer:f,outbox:f,projections:y,policyEngine:p,eventBus:v,workflowEngine:g,observability:we,publisher(k){let M=v.createPublisher(k);return{source:M.source,publish:M.publish,send(Ie,ln,un={}){return ot({eventBus:v,broker:u,defaultEphemeral:h},Ie,ln,{...un,source:M.source})}}},send(k,M,Ie={}){return ot({eventBus:v,broker:u,defaultEphemeral:h},k,M,Ie)},register(k){return b.register(k)},resolve(k){return b.resolve(k)},resolveSingleton(k){return b.resolveSingleton(k)},getDependencyInformationPackage(){return P({kernelInstanceId:n,components:b.snapshotComponents()})},requestGraph(k){return Rt({kernelInstanceId:n,components:b.snapshotComponents()},k)},getInspectorSnapshot(k){return Pt({kernelInstanceId:n,host:k?.host,port:k?.port,package:{kernelInstanceId:n,components:b.snapshotComponents()},observability:we.report(),ephemeralDefault:h,brokerBound:dn})},startInspector(k){return sn(it,k)},syncGraph:m,manifest(){return m(),Qe({registry:i,policyEngine:p,metadata:c,graph:a,profile:r,projections:y,eventContracts:l,observability:we})}};return it}s(cn,"createArkKernel");var $=Symbol("ARK_KERNEL"),_r=s(()=>(0,Ae.Inject)($),"InjectArk"),E=class{static forRoot(e){let n=e&&"registry"in e?e:cn(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});
|
package/dist/nestjs/index.js
CHANGED
|
@@ -15,4 +15,4 @@ ${n}`),this.name="PolicyViolationError",this.violations=e}};var C=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),f=o.slice(l).concat(d);n.push(f)}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 He(){return new fe}s(He,"createDependencyGraph");function Ve(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(Ve,"syncRegistryToGraph");var Z=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 Ri=new Z;function Ue(){return new Z}s(Ue,"createIntentRegistry");var X={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Gt={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},compositionRoots:{...X,default:[]},kernelRoots:{...X},managedLayers:{...X,default:[]},requireDeclarations:{type:"boolean",default:!0},ignoreDirectNewForErrors:{type:"boolean",default:!0}}},Kt={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},planeRoots:{...X,default:[]},managedLayers:{...X,default:[]},maxXiKeys:{type:"integer",minimum:1,default:7}}};var Ft="1.3",jt="https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",Bt=["DomainModel","ApplicationOrchestration","PersistenceAdapters","IntegrationAdapters","WorkflowSagaEngine","BackgroundJobsScheduling","PresentationAdapters","ReportingReadModels","ExtensibilityMetadata","SecurityAuditObservability","Kernel"],ir=new Set(["PresentationAdapters->ApplicationOrchestration","ApplicationOrchestration->DomainModel","WorkflowSagaEngine->ApplicationOrchestration","WorkflowSagaEngine->DomainModel","BackgroundJobsScheduling->ApplicationOrchestration"]);function sr(){let t=[];for(let e of Bt)for(let n of Bt)e===n||ir.has(`${e}->${n}`)||t.push({from:e,to:n,allowed:!1});return t}s(sr,"createDefaultRules");var We=sr();var I={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},_i={$schema:"https://json-schema.org/draft/2020-12/schema",$id:jt,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:jt,description:"Editor-facing URL or local path for this JSON Schema."},schemaVersion:{type:"string",const:Ft,default:Ft},name:{type:"string",minLength:1},include:{...I,minItems:1,default:["src"]},exclude:{...I,default:[]},excludeGenerated:{type:"boolean",default:!0},frameworkOverlay:{type:"string",minLength:1},layers:{type:"array",default:[],items:{$ref:"#/$defs/layer"}},rules:{type:"array",default:We,items:{$ref:"#/$defs/rule"}},cyclePolicy:{type:"string",enum:["strict","soft","framework-soft","off"],default:"strict"},dynamicImportAllowlist:{...I,default:[]},safety:{$ref:"#/$defs/safety",default:{maxTsSuppressions:0,maxAnyCasts:0,allowInMemory:!1,allowDisabledPeerIsolation:!1}},arkRules:{type:"object",additionalProperties:{type:"string",minLength:1},default:{}},arkRun:{$ref:"#/$defs/arkRun"},arkOrder:{$ref:"#/$defs/arkOrder"},stewards:{...I,default:[]}},$defs:{layer:{type:"object",additionalProperties:!1,required:["name","patterns"],properties:{name:{type:"string",minLength:1},patterns:{...I,minItems:1},exclude:I,intentPrefixes:I,description:{type:"string",minLength:1},forbiddenGlobals:I,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:{...I,minItems: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}}},arkRun:Gt,arkOrder:Kt}};function ar(t){return t.endsWith(".")?t:`${t}.`}s(ar,"normalizePrefix");function cr(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(cr,"byLongestPrefix");function Ht(t){let e=t.layers.map(o=>({...o,prefixes:o.prefixes.map(ar)})),n=[...e].sort(cr),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(Ht,"createArchitectureProfile");var dr=[{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}],qe=Ht({name:"Ark 11-layer Hexagonal Event-Driven Profile",layers:dr,rules:We.map(t=>({...t}))});var Vt="4.8.1";function ur(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")}s(ur,"policyId");var Je=class{constructor(e){this.data=e}data;static{s(this,"ArkManifestImpl")}toJSON(){return{...this.data}}};function ze(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(g=>({name:g.name,dependencies:e.getDependencies(g.name),productions:e.getProductions(g.name)})):[],f=e?e.getAllRelationships():[],y=n?n.getPolicies().map(g=>({id:ur(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})):[],p=r?r.toJSON():[],m=o?o.toJSON():{nodes:[],edges:[]},h=p.filter(g=>(g.emits?.length??0)>0||(g.consumes?.length??0)>0).map(g=>({entity:g.name,emits:g.emits,consumes:g.consumes})),u=a?a.list().map(g=>({name:g.name,sourceIntents:g.sourceIntents,checkpoint:a.getCheckpoint(g.name)})):[],E={schemaVersion:"1.0",version:Vt,exportedAt:new Date().toISOString(),intents:l,relationships:f,policies:y,entities:p,graph:m,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(E)}s(ze,"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 Qe(){return new me}s(Qe,"createMetadataRegistry");function Ze(t){return`${t.from}->${t.to}`}s(Ze,"flowKey");function Wt(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(Wt,"uniqueFlows");function qt(t,e){let n=new Set(e.map(Ze));return t.filter(r=>!n.has(Ze(r)))}s(qt,"difference");function Xe(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=Wt([...o,...i]),l=Wt([...a,...c]),f=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)))):[],p=e?Array.from(new Set(l.map(u=>u.to).filter(u=>!e.has(u)))):[],m=new Set(l.flatMap(u=>[u.from,u.to])),h=e?e.list().map(u=>u.name).filter(u=>!m.has(u)):[];return{generatedAt:new Date().toISOString(),declaredProductions:d,observedProductions:l,declaredButUnobserved:qt(d,l),observedButUndeclared:qt(l.filter(u=>u.from!=="unknown"),d),unknownSources:f,unregisteredObservedSources:y,unregisteredObservedIntents:p,registeredButNeverObserved:h}}}}s(Xe,"createObservabilityReporter");var Jt=0;function pr(){return Jt+=1,`outbox-${Date.now()}-${Jt}`}s(pr,"nextOutboxId");function zt(t){return{...t,event:{...t.event,metadata:{...t.event.metadata}}}}s(zt,"cloneRecord");var Y=class{static{s(this,"InMemoryEventBuffer")}records=new Map;async enqueue(e){let n=new Date().toISOString(),r={id:pr(),event:e,status:"pending",attempts:0,createdAt:n,updatedAt:n};return this.records.set(r.id,r),zt(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(zt)}async clear(){this.records.clear()}};var ge=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 fr(t){return typeof t.initialState=="function"?t.initialState():t.initialState}s(fr,"initialState");var ye=class{static{s(this,"ProjectionRegistryImpl")}definitions=new Map;checkpoints=new Map;store;auditTrail;constructor(e={}){this.store=e.store??new ge,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)??fr(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 Ye(t){return new ye(t)}s(Ye,"createProjectionRegistry");var Qt=0;function mr(t){return Qt+=1,`${t}-${Date.now()}-${Qt}`}s(mr,"createWorkflowId");function et(t){return t instanceof Error?t.message:String(t)}s(et,"errorMessage");function gr(t){return new Promise(e=>{setTimeout(e,t)})}s(gr,"sleep");async function yr(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(yr,"withTimeout");var he=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()}},tt=class{constructor(e,n={}){this.bus=e;this.options=n;this.store=n.store??new he}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??mr(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=et(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 yr(d=>Promise.resolve(n.execute(e.context,this.bus,d)),n.timeoutMs,n.name)}catch(d){if(a<i){o.delayMs&&await gr(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:et(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:et(d)})}}}async audit(e,n,r){await this.options.auditTrail?.record({type:e,source:"Kernel.WorkflowEngine",subject:n.id,details:r})}};function nt(t,e){return new tt(t,e)}s(nt,"createWorkflowEngine");_();var hr=new Set(["singleton","transient"]);function Zt(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(Zt,"cloneComponent");function kr(t){if(t===void 0)return"singleton";if(typeof t=="string"&&hr.has(t))return t;throw new Error('ArkRun component lifetime must be "singleton" or "transient".')}s(kr,"closedLifetime");function Xt(){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=kr(a.lifetime),l=Ee({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 f=typeof a.factory=="function"?a.factory:void 0;return t.set(c,{component:l,factory:f}),Zt(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=>Zt(a.component))}}}s(Xt,"createComponentRegistry");ae();async function tn(t,e={}){let n=De({host:e.host,port:e.port,nodeEnv:e.nodeEnv,processNodeEnv:process.env.NODE_ENV}),{listenArkRunInspector:r}=await Promise.resolve().then(()=>(en(),Yt));return r(t,{bind:n,sseIntervalMs:e.sseIntervalMs})}s(tn,"startArkRunInspector");oe();function vr(t){let e={...t.metadata??{}};if(t.source===void 0)return e;if(e.source&&e.source!==t.source)throw new x(t.source,e.source);return e.source=t.source,e}s(vr,"stampMetadata");function Pr(){}s(Pr,"ignoreDetachedFailure");async function rt(t,e,n,r={}){let o=yt({transport:r.transport,ephemeral:r.ephemeral??t.defaultEphemeral,brokerBound:typeof t.broker?.send=="function"}),i=vr(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,Pr)}return o}s(rt,"sendOnArkRunTransport");var Sr=1e3,nn=0;function xr(){return nn+=1,`ark-kernel-${Date.now()}-${nn}`}s(xr,"nextKernelInstanceId");function rn(t={}){let e=t.strict??!0,n=t.instanceId??xr(),r=t.profile??qe,o=t.maxHistorySize??Sr,i=Ue(),a=He(),c=t.metadata??Qe(),d=t.auditTrail??$e({maxRecords:o}),l=t.eventContracts??Be(),f=t.eventBuffer??t.outbox??new Y,y=t.projections??Ye({auditTrail:d}),p=new C([_e(r),...t.policies??[]]),m=s(()=>{Ve(i,a,{requireRegisteredTargets:!0})},"syncGraph"),h=t.ephemeral??!0,u=t.broker,E=new Q({intentRegistry:i,dependencyGraph:a,policyEngine:p,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:f,instanceId:n,maxHistorySize:o,onPublish:t.autoApplyProjections===!1?void 0:async k=>{await y.apply(k)}}),g=nt(E,{auditTrail:d}),Re=Xe({registry:i,eventBus:E,graph:a}),b=Xt(),on=typeof u?.send=="function",ot={instanceId:n,profile:r,registry:i,graph:a,metadata:c,auditTrail:d,eventContracts:l,eventBuffer:f,outbox:f,projections:y,policyEngine:p,eventBus:E,workflowEngine:g,observability:Re,publisher(k){let T=E.createPublisher(k);return{source:T.source,publish:T.publish,send(Ae,sn,an={}){return rt({eventBus:E,broker:u,defaultEphemeral:h},Ae,sn,{...an,source:T.source})}}},send(k,T,Ae={}){return rt({eventBus:E,broker:u,defaultEphemeral:h},k,T,Ae)},register(k){return b.register(k)},resolve(k){return b.resolve(k)},resolveSingleton(k){return b.resolveSingleton(k)},getDependencyInformationPackage(){return P({kernelInstanceId:n,components:b.snapshotComponents()})},requestGraph(k){return gt({kernelInstanceId:n,components:b.snapshotComponents()},k)},getInspectorSnapshot(k){return wt({kernelInstanceId:n,host:k?.host,port:k?.port,package:{kernelInstanceId:n,components:b.snapshotComponents()},observability:Re.report(),ephemeralDefault:h,brokerBound:on})},startInspector(k){return tn(ot,k)},syncGraph:m,manifest(){return m(),ze({registry:i,policyEngine:p,metadata:c,graph:a,profile:r,projections:y,eventContracts:l,observability:Re})}};return ot}s(rn,"createArkKernel");var ee=Symbol("ARK_KERNEL"),pa=s(()=>br(ee),"InjectArk"),v=class{static forRoot(e){let n=e&&"registry"in e?e:rn(e);return{module:v,global:!0,providers:[{provide:ee,useValue:n}],exports:[ee]}}static forRootAsync(e){return{module:v,global:!0,providers:[{provide:ee,useFactory:e.useFactory,inject:e.inject??[]}],exports:[ee]}}};s(v,"ArkModule"),v=it([Cr({})],v);export{ee as ARK_KERNEL,v as ArkModule,pa as 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 l=o.indexOf(d),f=o.slice(l).concat(d);n.push(f)}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 He(){return new fe}s(He,"createDependencyGraph");function Ve(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(Ve,"syncRegistryToGraph");var Z=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 Ri=new Z;function Ue(){return new Z}s(Ue,"createIntentRegistry");var X={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},Gt={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},compositionRoots:{...X,default:[]},kernelRoots:{...X},managedLayers:{...X,default:[]},requireDeclarations:{type:"boolean",default:!0},ignoreDirectNewForErrors:{type:"boolean",default:!0}}},Kt={type:"object",additionalProperties:!1,properties:{mode:{type:"string",enum:["advisory","enforced"],default:"advisory"},planeRoots:{...X,default:[]},managedLayers:{...X,default:[]},maxXiKeys:{type:"integer",minimum:1,default:7}}};var Ft="1.3",jt="https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",Bt=["DomainModel","ApplicationOrchestration","PersistenceAdapters","IntegrationAdapters","WorkflowSagaEngine","BackgroundJobsScheduling","PresentationAdapters","ReportingReadModels","ExtensibilityMetadata","SecurityAuditObservability","Kernel"],ir=new Set(["PresentationAdapters->ApplicationOrchestration","ApplicationOrchestration->DomainModel","WorkflowSagaEngine->ApplicationOrchestration","WorkflowSagaEngine->DomainModel","BackgroundJobsScheduling->ApplicationOrchestration"]);function sr(){let t=[];for(let e of Bt)for(let n of Bt)e===n||ir.has(`${e}->${n}`)||t.push({from:e,to:n,allowed:!1});return t}s(sr,"createDefaultRules");var We=sr();var I={type:"array",items:{type:"string",minLength:1},uniqueItems:!0},_i={$schema:"https://json-schema.org/draft/2020-12/schema",$id:jt,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:jt,description:"Editor-facing URL or local path for this JSON Schema."},schemaVersion:{type:"string",const:Ft,default:Ft},name:{type:"string",minLength:1},include:{...I,minItems:1,default:["src"]},exclude:{...I,default:[]},excludeGenerated:{type:"boolean",default:!0},frameworkOverlay:{type:"string",minLength:1},layers:{type:"array",default:[],items:{$ref:"#/$defs/layer"}},rules:{type:"array",default:We,items:{$ref:"#/$defs/rule"}},cyclePolicy:{type:"string",enum:["strict","soft","framework-soft","off"],default:"strict"},dynamicImportAllowlist:{...I,default:[]},safety:{$ref:"#/$defs/safety",default:{maxTsSuppressions:0,maxAnyCasts:0,allowInMemory:!1,allowDisabledPeerIsolation:!1}},arkRules:{type:"object",additionalProperties:{type:"string",minLength:1},default:{}},arkRun:{$ref:"#/$defs/arkRun"},arkOrder:{$ref:"#/$defs/arkOrder"},stewards:{...I,default:[]}},$defs:{layer:{type:"object",additionalProperties:!1,required:["name","patterns"],properties:{name:{type:"string",minLength:1},patterns:{...I,minItems:1},exclude:I,intentPrefixes:I,description:{type:"string",minLength:1},forbiddenGlobals:I,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:{...I,minItems: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}}},arkRun:Gt,arkOrder:Kt}};function ar(t){return t.endsWith(".")?t:`${t}.`}s(ar,"normalizePrefix");function cr(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(cr,"byLongestPrefix");function Ht(t){let e=t.layers.map(o=>({...o,prefixes:o.prefixes.map(ar)})),n=[...e].sort(cr),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(Ht,"createArchitectureProfile");var dr=[{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}],qe=Ht({name:"Ark 11-layer Hexagonal Event-Driven Profile",layers:dr,rules:We.map(t=>({...t}))});var Vt="4.8.2";function ur(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")}s(ur,"policyId");var Je=class{constructor(e){this.data=e}data;static{s(this,"ArkManifestImpl")}toJSON(){return{...this.data}}};function ze(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(g=>({name:g.name,dependencies:e.getDependencies(g.name),productions:e.getProductions(g.name)})):[],f=e?e.getAllRelationships():[],y=n?n.getPolicies().map(g=>({id:ur(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})):[],p=r?r.toJSON():[],m=o?o.toJSON():{nodes:[],edges:[]},h=p.filter(g=>(g.emits?.length??0)>0||(g.consumes?.length??0)>0).map(g=>({entity:g.name,emits:g.emits,consumes:g.consumes})),u=a?a.list().map(g=>({name:g.name,sourceIntents:g.sourceIntents,checkpoint:a.getCheckpoint(g.name)})):[],E={schemaVersion:"1.0",version:Vt,exportedAt:new Date().toISOString(),intents:l,relationships:f,policies:y,entities:p,graph:m,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(E)}s(ze,"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 Qe(){return new me}s(Qe,"createMetadataRegistry");function Ze(t){return`${t.from}->${t.to}`}s(Ze,"flowKey");function Wt(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(Wt,"uniqueFlows");function qt(t,e){let n=new Set(e.map(Ze));return t.filter(r=>!n.has(Ze(r)))}s(qt,"difference");function Xe(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=Wt([...o,...i]),l=Wt([...a,...c]),f=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)))):[],p=e?Array.from(new Set(l.map(u=>u.to).filter(u=>!e.has(u)))):[],m=new Set(l.flatMap(u=>[u.from,u.to])),h=e?e.list().map(u=>u.name).filter(u=>!m.has(u)):[];return{generatedAt:new Date().toISOString(),declaredProductions:d,observedProductions:l,declaredButUnobserved:qt(d,l),observedButUndeclared:qt(l.filter(u=>u.from!=="unknown"),d),unknownSources:f,unregisteredObservedSources:y,unregisteredObservedIntents:p,registeredButNeverObserved:h}}}}s(Xe,"createObservabilityReporter");var Jt=0;function pr(){return Jt+=1,`outbox-${Date.now()}-${Jt}`}s(pr,"nextOutboxId");function zt(t){return{...t,event:{...t.event,metadata:{...t.event.metadata}}}}s(zt,"cloneRecord");var Y=class{static{s(this,"InMemoryEventBuffer")}records=new Map;async enqueue(e){let n=new Date().toISOString(),r={id:pr(),event:e,status:"pending",attempts:0,createdAt:n,updatedAt:n};return this.records.set(r.id,r),zt(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(zt)}async clear(){this.records.clear()}};var ge=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 fr(t){return typeof t.initialState=="function"?t.initialState():t.initialState}s(fr,"initialState");var ye=class{static{s(this,"ProjectionRegistryImpl")}definitions=new Map;checkpoints=new Map;store;auditTrail;constructor(e={}){this.store=e.store??new ge,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)??fr(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 Ye(t){return new ye(t)}s(Ye,"createProjectionRegistry");var Qt=0;function mr(t){return Qt+=1,`${t}-${Date.now()}-${Qt}`}s(mr,"createWorkflowId");function et(t){return t instanceof Error?t.message:String(t)}s(et,"errorMessage");function gr(t){return new Promise(e=>{setTimeout(e,t)})}s(gr,"sleep");async function yr(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(yr,"withTimeout");var he=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()}},tt=class{constructor(e,n={}){this.bus=e;this.options=n;this.store=n.store??new he}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??mr(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=et(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 yr(d=>Promise.resolve(n.execute(e.context,this.bus,d)),n.timeoutMs,n.name)}catch(d){if(a<i){o.delayMs&&await gr(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:et(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:et(d)})}}}async audit(e,n,r){await this.options.auditTrail?.record({type:e,source:"Kernel.WorkflowEngine",subject:n.id,details:r})}};function nt(t,e){return new tt(t,e)}s(nt,"createWorkflowEngine");_();var hr=new Set(["singleton","transient"]);function Zt(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(Zt,"cloneComponent");function kr(t){if(t===void 0)return"singleton";if(typeof t=="string"&&hr.has(t))return t;throw new Error('ArkRun component lifetime must be "singleton" or "transient".')}s(kr,"closedLifetime");function Xt(){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=kr(a.lifetime),l=Ee({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 f=typeof a.factory=="function"?a.factory:void 0;return t.set(c,{component:l,factory:f}),Zt(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=>Zt(a.component))}}}s(Xt,"createComponentRegistry");ae();async function tn(t,e={}){let n=De({host:e.host,port:e.port,nodeEnv:e.nodeEnv,processNodeEnv:process.env.NODE_ENV}),{listenArkRunInspector:r}=await Promise.resolve().then(()=>(en(),Yt));return r(t,{bind:n,sseIntervalMs:e.sseIntervalMs})}s(tn,"startArkRunInspector");oe();function vr(t){let e={...t.metadata??{}};if(t.source===void 0)return e;if(e.source&&e.source!==t.source)throw new x(t.source,e.source);return e.source=t.source,e}s(vr,"stampMetadata");function Pr(){}s(Pr,"ignoreDetachedFailure");async function rt(t,e,n,r={}){let o=yt({transport:r.transport,ephemeral:r.ephemeral??t.defaultEphemeral,brokerBound:typeof t.broker?.send=="function"}),i=vr(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,Pr)}return o}s(rt,"sendOnArkRunTransport");var Sr=1e3,nn=0;function xr(){return nn+=1,`ark-kernel-${Date.now()}-${nn}`}s(xr,"nextKernelInstanceId");function rn(t={}){let e=t.strict??!0,n=t.instanceId??xr(),r=t.profile??qe,o=t.maxHistorySize??Sr,i=Ue(),a=He(),c=t.metadata??Qe(),d=t.auditTrail??$e({maxRecords:o}),l=t.eventContracts??Be(),f=t.eventBuffer??t.outbox??new Y,y=t.projections??Ye({auditTrail:d}),p=new C([_e(r),...t.policies??[]]),m=s(()=>{Ve(i,a,{requireRegisteredTargets:!0})},"syncGraph"),h=t.ephemeral??!0,u=t.broker,E=new Q({intentRegistry:i,dependencyGraph:a,policyEngine:p,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:f,instanceId:n,maxHistorySize:o,onPublish:t.autoApplyProjections===!1?void 0:async k=>{await y.apply(k)}}),g=nt(E,{auditTrail:d}),Re=Xe({registry:i,eventBus:E,graph:a}),b=Xt(),on=typeof u?.send=="function",ot={instanceId:n,profile:r,registry:i,graph:a,metadata:c,auditTrail:d,eventContracts:l,eventBuffer:f,outbox:f,projections:y,policyEngine:p,eventBus:E,workflowEngine:g,observability:Re,publisher(k){let T=E.createPublisher(k);return{source:T.source,publish:T.publish,send(Ae,sn,an={}){return rt({eventBus:E,broker:u,defaultEphemeral:h},Ae,sn,{...an,source:T.source})}}},send(k,T,Ae={}){return rt({eventBus:E,broker:u,defaultEphemeral:h},k,T,Ae)},register(k){return b.register(k)},resolve(k){return b.resolve(k)},resolveSingleton(k){return b.resolveSingleton(k)},getDependencyInformationPackage(){return P({kernelInstanceId:n,components:b.snapshotComponents()})},requestGraph(k){return gt({kernelInstanceId:n,components:b.snapshotComponents()},k)},getInspectorSnapshot(k){return wt({kernelInstanceId:n,host:k?.host,port:k?.port,package:{kernelInstanceId:n,components:b.snapshotComponents()},observability:Re.report(),ephemeralDefault:h,brokerBound:on})},startInspector(k){return tn(ot,k)},syncGraph:m,manifest(){return m(),ze({registry:i,policyEngine:p,metadata:c,graph:a,profile:r,projections:y,eventContracts:l,observability:Re})}};return ot}s(rn,"createArkKernel");var ee=Symbol("ARK_KERNEL"),pa=s(()=>br(ee),"InjectArk"),v=class{static forRoot(e){let n=e&&"registry"in e?e:rn(e);return{module:v,global:!0,providers:[{provide:ee,useValue:n}],exports:[ee]}}static forRootAsync(e){return{module:v,global:!0,providers:[{provide:ee,useFactory:e.useFactory,inject:e.inject??[]}],exports:[ee]}}};s(v,"ArkModule"),v=it([Cr({})],v);export{ee as ARK_KERNEL,v as ArkModule,pa as InjectArk};
|