@kanonak-protocol/cli 3.2.0 → 3.3.0

package/dist/index.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import{Command as Fi}from"commander";import{readFileSync as Vi}from"fs";import{fileURLToPath as Bi}from"url";import{dirname as Mi,join as Hi}from"path";import{KanonakParser as qi,PublisherIndex as zi,CredentialStore as Wi,createAuthenticatedFetch as Gi}from"@kanonak-protocol/sdk";import{readFileSync as Vr,statSync as Br}from"fs";import{resolve as Mr,dirname as Hr}from"path";import{KanonakParser as qr,KanonakObjectValidator as zr,ValidationSeverity as En}from"@kanonak-protocol/sdk";import{readFileSync as Tr,readdirSync as jr}from"fs";import{join as xr,dirname as Ur,basename as Cn}from"path";import{InMemoryKanonakDocumentRepository as Or,FileSystemKanonakDocumentRepository as Lr,HttpKanonakDocumentRepository as Nr,getGlobalCachePath as Fr}from"@kanonak-protocol/sdk";import{mkdirSync as Cr,readFileSync as Kn,writeFileSync as Dn,existsSync as Ye,appendFileSync as Er}from"fs";import{join as Ar,dirname as Rr,isAbsolute as Ir}from"path";import{getGlobalCachePath as _r}from"@kanonak-protocol/sdk";var U=class{constructor(e=_r()){this.cacheDir=e;this.isProjectLocal=!Ir(e)}cacheDir;gitignoreChecked=!1;isProjectLocal;get(e,t,r){let o=this.getPath(e,t,r);return Ye(o)?Kn(o,"utf-8"):null}put(e,t,r,o){let s=this.getPath(e,t,r);Cr(Rr(s),{recursive:!0}),Dn(s,o,"utf-8"),this.isProjectLocal&&this.ensureGitignore()}has(e,t,r){return Ye(this.getPath(e,t,r))}ensureGitignore(){if(this.gitignoreChecked)return;this.gitignoreChecked=!0;let e=".gitignore",t=this.cacheDir;if(Ye(e)){if(Kn(e,"utf-8").split(`
+import{Command as Vi}from"commander";import{readFileSync as Bi}from"fs";import{fileURLToPath as Mi}from"url";import{dirname as Hi,join as qi}from"path";import{KanonakParser as zi,PublisherIndex as Wi,CredentialStore as Gi,createAuthenticatedFetch as Xi}from"@kanonak-protocol/sdk";import{readFileSync as Vr,statSync as Br}from"fs";import{resolve as Mr,dirname as Hr}from"path";import{KanonakParser as qr,KanonakObjectValidator as zr,ValidationSeverity as En}from"@kanonak-protocol/sdk";import{readFileSync as Tr,readdirSync as jr}from"fs";import{join as xr,dirname as Ur,basename as Cn}from"path";import{InMemoryKanonakDocumentRepository as Or,FileSystemKanonakDocumentRepository as Lr,HttpKanonakDocumentRepository as Nr,getGlobalCachePath as Fr}from"@kanonak-protocol/sdk";import{mkdirSync as Cr,readFileSync as Kn,writeFileSync as Dn,existsSync as Je,appendFileSync as Er}from"fs";import{join as Ar,dirname as Rr,isAbsolute as Ir}from"path";import{getGlobalCachePath as _r}from"@kanonak-protocol/sdk";var U=class{constructor(e=_r()){this.cacheDir=e;this.isProjectLocal=!Ir(e)}cacheDir;gitignoreChecked=!1;isProjectLocal;get(e,t,r){let o=this.getPath(e,t,r);return Je(o)?Kn(o,"utf-8"):null}put(e,t,r,o){let s=this.getPath(e,t,r);Cr(Rr(s),{recursive:!0}),Dn(s,o,"utf-8"),this.isProjectLocal&&this.ensureGitignore()}has(e,t,r){return Je(this.getPath(e,t,r))}ensureGitignore(){if(this.gitignoreChecked)return;this.gitignoreChecked=!0;let e=".gitignore",t=this.cacheDir;if(Je(e)){if(Kn(e,"utf-8").split(`
 `).some(o=>o.trim()===t||o.trim()===t+"/"))return;Er(e,`
 ${t}/
 `)}else Dn(e,`${t}/
-`)}getPath(e,t,r){return Ar(this.cacheDir,e,`${t}@${r}.kan.yml`)}};function me(n){let e=n;for(;;){let t=Ur(e);if(t===e)break;if(Cn(e).includes(".")||Cn(t).includes(".")){e=t;continue}break}return e}function ve(n,e){for(let t of jr(n,{withFileTypes:!0})){let r=xr(n,t.name);t.isDirectory()&&t.name!=="node_modules"&&t.name!==".kanonak"?ve(r,e):t.name.endsWith(".kan.yml")&&e.push(r)}}var Ze=class{repos;constructor(...e){this.repos=e}async getHighestCompatibleVersionAsync(e,t){for(let r of this.repos)try{let o=await r.getHighestCompatibleVersionAsync(e,t);if(o)return o}catch{}return null}async getAllDocumentsAsync(){let e=[];for(let t of this.repos)try{e.push(...await t.getAllDocumentsAsync())}catch{}return e}async getDocumentAsync(e){for(let t of this.repos)try{let r=await t.getDocumentAsync(e);if(r)return r}catch{}return null}async getDocumentsByNamespaceAsync(e,t){for(let r of this.repos)try{let o=await r.getDocumentsByNamespaceAsync(e,t);if(o.length>0)return o}catch{}return[]}async saveDocumentAsync(e,t){await this.repos[0].saveDocumentAsync(e,t)}async deleteDocumentAsync(e){await this.repos[0].deleteDocumentAsync(e)}async clearNamespaceAsync(e,t){await this.repos[0].clearNamespaceAsync(e,t)}async getAllDocumentReferencesAsync(){return this.repos[0].getAllDocumentReferencesAsync()}async getDocumentContentAsync(e){for(let t of this.repos)try{let r=await t.getDocumentContentAsync(e);if(r)return r}catch{}return null}async getDocumentUriAsync(e){for(let t of this.repos)try{let r=await t.getDocumentUriAsync(e);if(r)return r}catch{}return null}};async function O(n,e){let t=[];ve(n,t);let r=new Or(e);for(let i of t)try{let c=Tr(i,"utf-8"),l=e.parse(c),u=l.metadata.namespace_;if(u){let d=`${u.publisher}/${u.package_}@${u.version}`;await r.saveDocumentAsync(l,d)}}catch{}let o=new Lr(Fr(),!0,e),s=new U,a=new Nr({getFromCache:(i,c,l)=>s.get(i,c,l),onFetch:(i,c,l,u)=>s.put(i,c,l,u)});return new Ze(r,o,a)}async function An(n){let e=Mr(n),t=Br(e),r=t.isDirectory()?me(e):me(Hr(e)),o=new qr,s=new zr(o),a=await O(r,o),i=[];if(t.isDirectory()?ve(e,i):i.push(e),i.length===0){console.log("No .kan.yml files found.");return}let c=0,l=0;for(let u of i){let d=Vr(u,"utf-8"),p=o.parseWithErrors(d);if(p.errors&&p.errors.length>0){console.log(`
+`)}getPath(e,t,r){return Ar(this.cacheDir,e,`${t}@${r}.kan.yml`)}};function me(n){let e=n;for(;;){let t=Ur(e);if(t===e)break;if(Cn(e).includes(".")||Cn(t).includes(".")){e=t;continue}break}return e}function ve(n,e){for(let t of jr(n,{withFileTypes:!0})){let r=xr(n,t.name);t.isDirectory()&&t.name!=="node_modules"&&t.name!==".kanonak"?ve(r,e):t.name.endsWith(".kan.yml")&&e.push(r)}}var Ye=class{repos;constructor(...e){this.repos=e}async getHighestCompatibleVersionAsync(e,t){for(let r of this.repos)try{let o=await r.getHighestCompatibleVersionAsync(e,t);if(o)return o}catch{}return null}async getAllDocumentsAsync(){let e=[];for(let t of this.repos)try{e.push(...await t.getAllDocumentsAsync())}catch{}return e}async getDocumentAsync(e){for(let t of this.repos)try{let r=await t.getDocumentAsync(e);if(r)return r}catch{}return null}async getDocumentsByNamespaceAsync(e,t){for(let r of this.repos)try{let o=await r.getDocumentsByNamespaceAsync(e,t);if(o.length>0)return o}catch{}return[]}async saveDocumentAsync(e,t){await this.repos[0].saveDocumentAsync(e,t)}async deleteDocumentAsync(e){await this.repos[0].deleteDocumentAsync(e)}async clearNamespaceAsync(e,t){await this.repos[0].clearNamespaceAsync(e,t)}async getAllDocumentReferencesAsync(){return this.repos[0].getAllDocumentReferencesAsync()}async getDocumentContentAsync(e){for(let t of this.repos)try{let r=await t.getDocumentContentAsync(e);if(r)return r}catch{}return null}async getDocumentUriAsync(e){for(let t of this.repos)try{let r=await t.getDocumentUriAsync(e);if(r)return r}catch{}return null}};async function O(n,e){let t=[];ve(n,t);let r=new Or(e);for(let i of t)try{let c=Tr(i,"utf-8"),l=e.parse(c),u=l.metadata.namespace_;if(u){let d=`${u.publisher}/${u.package_}@${u.version}`;await r.saveDocumentAsync(l,d)}}catch{}let o=new Lr(Fr(),!0,e),s=new U,a=new Nr({getFromCache:(i,c,l)=>s.get(i,c,l),onFetch:(i,c,l,u)=>s.put(i,c,l,u)});return new Ye(r,o,a)}async function An(n){let e=Mr(n),t=Br(e),r=t.isDirectory()?me(e):me(Hr(e)),o=new qr,s=new zr(o),a=await O(r,o),i=[];if(t.isDirectory()?ve(e,i):i.push(e),i.length===0){console.log("No .kan.yml files found.");return}let c=0,l=0;for(let u of i){let d=Vr(u,"utf-8"),p=o.parseWithErrors(d);if(p.errors&&p.errors.length>0){console.log(`
 ${u}:`);for(let h of p.errors)console.log(`  ERROR (parse): ${h.message} [line ${h.line}:${h.column}]`),c++;continue}let g=p.document;if(!g){console.log(`
 ${u}:`),console.log("  ERROR: Failed to parse document"),c++;continue}let b=await s.validateAsync(g,a),k=b.errors.filter(h=>h.severity===En.Error),y=b.errors.filter(h=>h.severity===En.Warning);if(k.length>0||y.length>0){let h=g.metadata.namespace_,w=h?`${h.publisher}/${h.package_}@${h.version}`:u;console.log(`
 ${w}:`);for(let $ of k)console.log(`  ERROR: ${$.message}`),$.suggestion&&console.log(`    -> ${$.suggestion}`);for(let $ of y)console.log(`  WARN: ${$.message}`)}c+=k.length,l+=y.length}console.log(`
 ${i.length} file(s) validated. ${c} error(s), ${l} warning(s).`),c>0&&process.exit(1)}import{KanonakParser as Wr,PublisherIndex as Gr,CredentialStore as Xr,createAuthenticatedFetch as Jr}from"@kanonak-protocol/sdk";import{loadLockFile as Yr,saveLockFile as Zr,computeIntegrity as Qr}from"@kanonak-protocol/sdk";function ee(n){if(!n)return null;let e=n.indexOf("/");if(e===-1)return null;let t=n.substring(0,e),r=n.substring(e+1);if(!t||!r)return null;let o,s=null,a=null,i=r.indexOf("@");if(i!==-1){o=r.substring(0,i);let c=r.substring(i+1),l=c.indexOf("/");l===-1?s=c||null:(s=c.substring(0,l)||null,a=c.substring(l+1)||null)}else{let c=r.indexOf("/");c===-1?o=r:(o=r.substring(0,c),a=r.substring(c+1)||null)}return!o||a&&a.includes("/")||s&&s.includes("@")?null:{publisher:t,packageName:o,version:s,instanceName:a}}async function Rn(n){let e=new U,t=new Wr,r=new Xr,o=Jr(r),s=new Gr({fetchFn:o}),a=Yr()??{version:"1",lastUpdated:new Date().toISOString(),packages:{}};if(!n){Object.keys(a.packages).length===0&&(console.error("No kanonak.lock file found or lock file is empty."),console.error("Usage: kanonak install {publisher}/{package}[@{version}]"),process.exit(1)),console.log(`Installing ${Object.keys(a.packages).length} package(s) from kanonak.lock...`);for(let[b,k]of Object.entries(a.packages)){let y=b.indexOf("/"),h=b.substring(0,y),w=b.substring(y+1),$=e.get(h,w,k.version);if($)console.log(`  ${b}@${k.version} (cached)`);else{let v=k.resolved,K=await o(v,h);if(!K.ok)throw new Error(`Failed to fetch ${v} (${K.status} ${K.statusText})`);$=await K.text(),e.put(h,w,k.version,$),console.log(`  ${b}@${k.version}`)}}console.log(`
 Installed ${Object.keys(a.packages).length} package(s) from lock file.`);return}let i=ee(n);i||(console.error(`Invalid package reference: "${n}"`),console.error("Expected format: {publisher}/{package}[@{version}]"),process.exit(1));let{publisher:c,packageName:l,version:u,instanceName:d}=i;d&&(console.error(`\`kanonak install\` works on whole packages \u2014 got an instance suffix "/${d}".`),console.error(`Try: kanonak install ${c}/${l}${u?"@"+u:""}`),console.error("(Use `kanonak <capability> add` if you want to install one named instance.)"),process.exit(1));let p=u??await s.getHighestVersion(c,l);p||(console.error(`Could not resolve version for "${c}/${l}".`),console.error("Check the spelling, or run a search to see what the publisher offers."),process.exit(1)),console.log(`Installing ${c}/${l}@${p}...`);let g=new Set;await In(c,l,p,e,t,s,o,g,a),Zr(a),console.log(`
-Installed ${g.size} package(s).`)}async function In(n,e,t,r,o,s,a,i,c){let l=`${n}/${e}@${t}`;if(i.has(l))return;i.add(l);let u=`${n}/${e}`,d=r.get(n,e,t),p;if(d)console.log(`  ${l} (cached)`),p=await s.getPackageUrl(n,e,t);else{p=await s.getPackageUrl(n,e,t);let k=await a(p,n);if(!k.ok)throw new Error(`Failed to fetch ${p} (${k.status} ${k.statusText})`);d=await k.text(),r.put(n,e,t,d),console.log(`  ${l}`)}let g={},b=o.parse(d);if(b.metadata.imports)for(let[k,y]of Object.entries(b.metadata.imports))for(let h of y){let w=await s.resolveVersion(k,h);w?(g[`${k}/${h.packageName}`]=w,await In(k,h.packageName,w,r,o,s,a,i,c)):console.error(`  WARNING: Could not resolve ${k}/${h.packageName} ${h.package_}`)}c.packages[u]={version:t,resolved:p,integrity:Qr(d),dependencies:g}}import{readFileSync as eo}from"fs";import{resolve as no,dirname as to}from"path";import{KanonakParser as ro}from"@kanonak-protocol/sdk";async function _n(n){let e=no(n),t=eo(e,"utf-8"),r=new ro,o=r.parse(t),s=o.metadata.namespace_,a=s?`${s.publisher}/${s.package_}@${s.version}`:n;if(console.log(a),!o.metadata.imports){console.log("  (no imports)");return}let i=me(to(e)),c=await O(i,r),l=new Set;for(let[u,d]of Object.entries(o.metadata.imports))for(let p of d)await Tn(u,p,c,l,"  ")}async function Tn(n,e,t,r,o){let s=`${n}/${e.packageName}`;if(r.has(s)){console.log(`${o}${s} (${e.package_}) [circular]`);return}r.add(s);let a;try{a=await t.getHighestCompatibleVersionAsync(n,e)}catch{console.log(`${o}${s} (${e.package_}) [fetch failed]`);return}if(!a){console.log(`${o}${s} (${e.package_}) [not found]`);return}let i=a.metadata.namespace_?.version?.toString()??"?";if(console.log(`${o}${n}/${e.packageName}@${i}`),a.metadata.imports)for(let[c,l]of Object.entries(a.metadata.imports))for(let u of l)await Tn(c,u,t,r,o+"  ")}import{createHash as ao,randomBytes as Un}from"crypto";import{createServer as so}from"http";import{execFile as Qe}from"child_process";import{CredentialStore as io,generateDPoPKeyPair as co,createDPoPProof as jn,serverSupportsDPoP as lo}from"@kanonak-protocol/sdk";import{normalizeHost as oo}from"@kanonak-protocol/sdk";var B=class{cache=new Map;async discover(e){let t=oo(e);if(this.cache.has(t))return this.cache.get(t);let r=`https://${t}/.well-known/oauth-authorization-server`,o=await this.tryEndpoint(r);if(!o){let s=`https://${t}/.well-known/openid-configuration`;o=await this.tryEndpoint(s)}return this.cache.set(t,o),o}async supportsOAuth(e){return await this.discover(e)!==null}static supportsPkceS256(e){return e.codeChallengeMethodsSupported?.some(t=>t.toUpperCase()==="S256")??!1}static supportsDynamicRegistration(e){return!!e.registrationEndpoint}static supportsAuthorizationCode(e){return e.responseTypesSupported?.some(t=>t.toLowerCase()==="code")??!1}async tryEndpoint(e){let t;try{t=await fetch(e)}catch(o){let s=o instanceof Error?o.message:String(o);return s.includes("ENOTFOUND")||s.includes("ECONNREFUSED")?(console.error(`  OAuth discovery: ${e} \u2014 host unreachable (${s})`),console.error("    If the server is behind a VPN, ensure you are connected.")):s.includes("CERT")||s.includes("SSL")||s.includes("TLS")?(console.error(`  OAuth discovery: ${e} \u2014 TLS error (${s})`),console.error("    If using a custom CA certificate, set NODE_EXTRA_CA_CERTS=/path/to/ca.pem")):console.error(`  OAuth discovery: ${e} \u2014 network error: ${s}`),null}if(!t.ok)return t.status===404||(t.status===403?(console.error(`  OAuth discovery: ${e} \u2014 HTTP 403 Forbidden`),console.error("    Access may be blocked by a firewall, proxy, or WAF.")):t.status>=500&&(console.error(`  OAuth discovery: ${e} \u2014 HTTP ${t.status} server error`),console.error("    The authorization server returned an internal error. Contact your IDP administrator."))),null;let r;try{r=await t.json()}catch{return console.error(`  OAuth discovery: ${e} \u2014 response is not valid JSON`),console.error("    The endpoint may be returning HTML instead of JSON. Check IDP configuration."),null}return{issuer:pe(r.issuer),authorizationEndpoint:pe(r.authorization_endpoint),tokenEndpoint:pe(r.token_endpoint),registrationEndpoint:pe(r.registration_endpoint),revocationEndpoint:pe(r.revocation_endpoint),scopesSupported:ne(r.scopes_supported),responseTypesSupported:ne(r.response_types_supported),grantTypesSupported:ne(r.grant_types_supported),codeChallengeMethodsSupported:ne(r.code_challenge_methods_supported),tokenEndpointAuthMethodsSupported:ne(r.token_endpoint_auth_methods_supported),dpopSigningAlgValuesSupported:ne(r.dpop_signing_alg_values_supported)}}};function pe(n){return typeof n=="string"?n:null}function ne(n){return Array.isArray(n)?n.filter(e=>typeof e=="string"):null}var re=class{discovery;credentialStore;constructor(e,t){this.discovery=e??new B,this.credentialStore=t??new io}async authorize(e,t=[]){console.log(`Starting OAuth flow for ${e}...`);let r=await this.discovery.discover(e);if(!r)return j(`No OAuth discovery endpoint found for '${e}'.
+Installed ${g.size} package(s).`)}async function In(n,e,t,r,o,s,a,i,c){let l=`${n}/${e}@${t}`;if(i.has(l))return;i.add(l);let u=`${n}/${e}`,d=r.get(n,e,t),p;if(d)console.log(`  ${l} (cached)`),p=await s.getPackageUrl(n,e,t);else{p=await s.getPackageUrl(n,e,t);let k=await a(p,n);if(!k.ok)throw new Error(`Failed to fetch ${p} (${k.status} ${k.statusText})`);d=await k.text(),r.put(n,e,t,d),console.log(`  ${l}`)}let g={},b=o.parse(d);if(b.metadata.imports)for(let[k,y]of Object.entries(b.metadata.imports))for(let h of y){let w=await s.resolveVersion(k,h);w?(g[`${k}/${h.packageName}`]=w,await In(k,h.packageName,w,r,o,s,a,i,c)):console.error(`  WARNING: Could not resolve ${k}/${h.packageName} ${h.package_}`)}c.packages[u]={version:t,resolved:p,integrity:Qr(d),dependencies:g}}import{readFileSync as eo}from"fs";import{resolve as no,dirname as to}from"path";import{KanonakParser as ro}from"@kanonak-protocol/sdk";async function _n(n){let e=no(n),t=eo(e,"utf-8"),r=new ro,o=r.parse(t),s=o.metadata.namespace_,a=s?`${s.publisher}/${s.package_}@${s.version}`:n;if(console.log(a),!o.metadata.imports){console.log("  (no imports)");return}let i=me(to(e)),c=await O(i,r),l=new Set;for(let[u,d]of Object.entries(o.metadata.imports))for(let p of d)await Tn(u,p,c,l,"  ")}async function Tn(n,e,t,r,o){let s=`${n}/${e.packageName}`;if(r.has(s)){console.log(`${o}${s} (${e.package_}) [circular]`);return}r.add(s);let a;try{a=await t.getHighestCompatibleVersionAsync(n,e)}catch{console.log(`${o}${s} (${e.package_}) [fetch failed]`);return}if(!a){console.log(`${o}${s} (${e.package_}) [not found]`);return}let i=a.metadata.namespace_?.version?.toString()??"?";if(console.log(`${o}${n}/${e.packageName}@${i}`),a.metadata.imports)for(let[c,l]of Object.entries(a.metadata.imports))for(let u of l)await Tn(c,u,t,r,o+"  ")}import{createHash as ao,randomBytes as Un}from"crypto";import{createServer as so}from"http";import{execFile as Ze}from"child_process";import{CredentialStore as io,generateDPoPKeyPair as co,createDPoPProof as jn,serverSupportsDPoP as lo}from"@kanonak-protocol/sdk";import{normalizeHost as oo}from"@kanonak-protocol/sdk";var B=class{cache=new Map;async discover(e){let t=oo(e);if(this.cache.has(t))return this.cache.get(t);let r=`https://${t}/.well-known/oauth-authorization-server`,o=await this.tryEndpoint(r);if(!o){let s=`https://${t}/.well-known/openid-configuration`;o=await this.tryEndpoint(s)}return this.cache.set(t,o),o}async supportsOAuth(e){return await this.discover(e)!==null}static supportsPkceS256(e){return e.codeChallengeMethodsSupported?.some(t=>t.toUpperCase()==="S256")??!1}static supportsDynamicRegistration(e){return!!e.registrationEndpoint}static supportsAuthorizationCode(e){return e.responseTypesSupported?.some(t=>t.toLowerCase()==="code")??!1}async tryEndpoint(e){let t;try{t=await fetch(e)}catch(o){let s=o instanceof Error?o.message:String(o);return s.includes("ENOTFOUND")||s.includes("ECONNREFUSED")?(console.error(`  OAuth discovery: ${e} \u2014 host unreachable (${s})`),console.error("    If the server is behind a VPN, ensure you are connected.")):s.includes("CERT")||s.includes("SSL")||s.includes("TLS")?(console.error(`  OAuth discovery: ${e} \u2014 TLS error (${s})`),console.error("    If using a custom CA certificate, set NODE_EXTRA_CA_CERTS=/path/to/ca.pem")):console.error(`  OAuth discovery: ${e} \u2014 network error: ${s}`),null}if(!t.ok)return t.status===404||(t.status===403?(console.error(`  OAuth discovery: ${e} \u2014 HTTP 403 Forbidden`),console.error("    Access may be blocked by a firewall, proxy, or WAF.")):t.status>=500&&(console.error(`  OAuth discovery: ${e} \u2014 HTTP ${t.status} server error`),console.error("    The authorization server returned an internal error. Contact your IDP administrator."))),null;let r;try{r=await t.json()}catch{return console.error(`  OAuth discovery: ${e} \u2014 response is not valid JSON`),console.error("    The endpoint may be returning HTML instead of JSON. Check IDP configuration."),null}return{issuer:pe(r.issuer),authorizationEndpoint:pe(r.authorization_endpoint),tokenEndpoint:pe(r.token_endpoint),registrationEndpoint:pe(r.registration_endpoint),revocationEndpoint:pe(r.revocation_endpoint),scopesSupported:ne(r.scopes_supported),responseTypesSupported:ne(r.response_types_supported),grantTypesSupported:ne(r.grant_types_supported),codeChallengeMethodsSupported:ne(r.code_challenge_methods_supported),tokenEndpointAuthMethodsSupported:ne(r.token_endpoint_auth_methods_supported),dpopSigningAlgValuesSupported:ne(r.dpop_signing_alg_values_supported)}}};function pe(n){return typeof n=="string"?n:null}function ne(n){return Array.isArray(n)?n.filter(e=>typeof e=="string"):null}var re=class{discovery;credentialStore;constructor(e,t){this.discovery=e??new B,this.credentialStore=t??new io}async authorize(e,t=[]){console.log(`Starting OAuth flow for ${e}...`);let r=await this.discovery.discover(e);if(!r)return j(`No OAuth discovery endpoint found for '${e}'.
   The server must expose one of:
     - https://${e}/.well-known/oauth-authorization-server (RFC 8414)
     - https://${e}/.well-known/openid-configuration (OpenID Connect)
@@ -34,17 +34,17 @@ Installed ${g.size} package(s).`)}async function In(n,e,t,r,o,s,a,i,c){let l=`${
   The refresh token may have expired. Run 'kanonak login ${e}' to re-authenticate.`)}async logout(e){let t=await this.credentialStore.getCredential(e);if(!t)return j(`No stored credentials for '${e}'.
   You may not be logged in, or credentials may be stored in a different backend.`);let r=await this.discovery.discover(e);if(r?.revocationEndpoint&&t.accessToken&&t.clientId)try{await this.revokeToken(r.revocationEndpoint,t.accessToken,t.clientId)}catch{console.warn(`  Warning: Token revocation failed for '${e}'. The token has been removed locally but may still be valid on the server until it expires.`)}return await this.credentialStore.remove(e),{success:!0,host:e}}async registerClient(e,t){let r;try{r=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({client_name:"Kanonak CLI",redirect_uris:[t],grant_types:["authorization_code","refresh_token"],response_types:["code"],token_endpoint_auth_method:"none"})})}catch(a){return{success:!1,error:`Dynamic client registration request to ${e} failed: ${te(a)}
   Ensure the IDP is reachable and HTTPS is properly configured.
-  If using a corporate proxy or custom CA, set NODE_EXTRA_CA_CERTS.`}}if(!r.ok){let a=await en(r);return{success:!1,error:`Dynamic client registration (RFC 7591) failed.
+  If using a corporate proxy or custom CA, set NODE_EXTRA_CA_CERTS.`}}if(!r.ok){let a=await Qe(r);return{success:!1,error:`Dynamic client registration (RFC 7591) failed.
   Endpoint: ${e}
   HTTP ${r.status}: ${a}
   The IDP may not support dynamic registration for public clients.
   Ask your IDP administrator to enable RFC 7591 support, or pre-register a client manually.`}}let o=await r.json(),s=o.client_id;return s?{success:!0,clientId:s,clientSecret:o.client_secret}:{success:!1,error:`Dynamic client registration response from ${e} did not contain a client_id.
   The IDP response may be malformed. Contact your IDP administrator.`}}async exchangeCode(e,t,r,o,s,a,i){let c=new URLSearchParams({grant_type:"authorization_code",client_id:t,code:o,redirect_uri:s,code_verifier:a});r&&c.set("client_secret",r);let l={"Content-Type":"application/x-www-form-urlencoded"};if(i)try{l.DPoP=jn(i.privateKey,i.publicKey,"POST",e)}catch(d){return{success:!1,error:`Failed to create DPoP proof for token exchange: ${te(d)}
   The stored key pair may be corrupted. Run 'kanonak login' to re-authenticate.`}}let u;try{u=await fetch(e,{method:"POST",headers:l,body:c.toString()})}catch(d){return{success:!1,error:`Token exchange request to ${e} failed: ${te(d)}
-  Ensure the token endpoint is reachable.`}}if(!u.ok){let d=await en(u),p=uo(d);return{success:!1,error:`Token exchange failed.
+  Ensure the token endpoint is reachable.`}}if(!u.ok){let d=await Qe(u),p=uo(d);return{success:!1,error:`Token exchange failed.
   Endpoint: ${e}
   HTTP ${u.status}: ${d}`+(p?`
-  ${p}`:"")}}return{success:!0,tokens:xn(await u.json())}}async refreshTokenRequest(e,t,r,o,s){let a=new URLSearchParams({grant_type:"refresh_token",client_id:t,refresh_token:o});r&&a.set("client_secret",r);let i={"Content-Type":"application/x-www-form-urlencoded"};if(s)try{i.DPoP=jn(s.privateKey,s.publicKey,"POST",e)}catch(l){return{success:!1,error:`Failed to create DPoP proof for token refresh: ${te(l)}`}}let c;try{c=await fetch(e,{method:"POST",headers:i,body:a.toString()})}catch(l){return{success:!1,error:`Token refresh request to ${e} failed: ${te(l)}`}}if(!c.ok){let l=await en(c);return{success:!1,error:`Token refresh failed \u2014 HTTP ${c.status}: ${l}`}}return{success:!0,tokens:xn(await c.json())}}async revokeToken(e,t,r){await fetch(e,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({token:t,client_id:r}).toString()})}};function j(n){return{success:!1,error:n}}function xn(n){return{accessToken:n.access_token,refreshToken:n.refresh_token,expiresIn:typeof n.expires_in=="number"?n.expires_in:void 0}}function te(n){return n instanceof Error?n.message:String(n)}async function en(n){try{return await n.text()}catch{return"(could not read response body)"}}function uo(n){try{let e=JSON.parse(n);switch(e.error){case"invalid_grant":return"Hint: The authorization code may have expired or already been used. Re-run the login flow.";case"invalid_client":return"Hint: The client credentials were rejected. The client_id may be invalid or the client_secret may be wrong.";case"redirect_uri_mismatch":return"Hint: The redirect_uri does not match what was registered with the IDP.";case"unsupported_grant_type":return"Hint: The IDP does not support authorization_code grants. Contact your IDP administrator.";case"invalid_scope":return"Hint: One or more requested scopes are not allowed. Check the scopes configured on the IDP.";case"use_dpop_nonce":return"Hint: The server requires a DPoP nonce. This should be handled automatically \u2014 please report this as a bug.";default:return e.error_description?`IDP says: ${e.error_description}`:null}}catch{return null}}function fo(){return Un(32).toString("base64url")}function mo(n){return ao("sha256").update(n).digest("base64url")}function po(){return Un(16).toString("base64url")}function go(n,e,t,r,o,s){let a=new URLSearchParams({client_id:e,response_type:"code",redirect_uri:t,scope:r.join(" "),state:o,code_challenge:s,code_challenge_method:"S256"});return`${n}?${a}`}var ko=300*1e3;async function yo(){return new Promise(n=>{let e=so((o,s)=>{let a=new URL(o.url,"http://localhost"),i=a.searchParams.get("code")??void 0,c=a.searchParams.get("state")??void 0,l=a.searchParams.get("error")??a.searchParams.get("error_description")??void 0,u=l?ho(l):null,d=u?`<html><body><h1>Authorization failed</h1><p>${u}</p></body></html>`:"<html><body><h1>Authorization successful!</h1><p>You can close this window.</p></body></html>";s.writeHead(200,{"Content-Type":"text/html"}),s.end(d),t({code:i,state:c,error:l})}),t,r=new Promise(o=>{t=o,setTimeout(()=>{o(null),e.close()},ko)});e.listen(0,"127.0.0.1",()=>{let o=e.address();n({redirectUri:`http://localhost:${o.port}/callback`,port:o.port,waitForCallback:()=>r,close:()=>e.close()})})})}function ho(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")}function bo(n){try{process.platform==="win32"?Qe("cmd",["/c","start","",n]):process.platform==="darwin"?Qe("open",[n]):Qe("xdg-open",[n])}catch{console.log("  Could not open browser automatically. Please navigate to the URL above manually.")}}import{CredentialStore as wo}from"@kanonak-protocol/sdk";async function On(n){try{let e=new B,t=new wo,o=await new re(e,t).authorize(n);o.success?console.log(`
+  ${p}`:"")}}return{success:!0,tokens:xn(await u.json())}}async refreshTokenRequest(e,t,r,o,s){let a=new URLSearchParams({grant_type:"refresh_token",client_id:t,refresh_token:o});r&&a.set("client_secret",r);let i={"Content-Type":"application/x-www-form-urlencoded"};if(s)try{i.DPoP=jn(s.privateKey,s.publicKey,"POST",e)}catch(l){return{success:!1,error:`Failed to create DPoP proof for token refresh: ${te(l)}`}}let c;try{c=await fetch(e,{method:"POST",headers:i,body:a.toString()})}catch(l){return{success:!1,error:`Token refresh request to ${e} failed: ${te(l)}`}}if(!c.ok){let l=await Qe(c);return{success:!1,error:`Token refresh failed \u2014 HTTP ${c.status}: ${l}`}}return{success:!0,tokens:xn(await c.json())}}async revokeToken(e,t,r){await fetch(e,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({token:t,client_id:r}).toString()})}};function j(n){return{success:!1,error:n}}function xn(n){return{accessToken:n.access_token,refreshToken:n.refresh_token,expiresIn:typeof n.expires_in=="number"?n.expires_in:void 0}}function te(n){return n instanceof Error?n.message:String(n)}async function Qe(n){try{return await n.text()}catch{return"(could not read response body)"}}function uo(n){try{let e=JSON.parse(n);switch(e.error){case"invalid_grant":return"Hint: The authorization code may have expired or already been used. Re-run the login flow.";case"invalid_client":return"Hint: The client credentials were rejected. The client_id may be invalid or the client_secret may be wrong.";case"redirect_uri_mismatch":return"Hint: The redirect_uri does not match what was registered with the IDP.";case"unsupported_grant_type":return"Hint: The IDP does not support authorization_code grants. Contact your IDP administrator.";case"invalid_scope":return"Hint: One or more requested scopes are not allowed. Check the scopes configured on the IDP.";case"use_dpop_nonce":return"Hint: The server requires a DPoP nonce. This should be handled automatically \u2014 please report this as a bug.";default:return e.error_description?`IDP says: ${e.error_description}`:null}}catch{return null}}function fo(){return Un(32).toString("base64url")}function mo(n){return ao("sha256").update(n).digest("base64url")}function po(){return Un(16).toString("base64url")}function go(n,e,t,r,o,s){let a=new URLSearchParams({client_id:e,response_type:"code",redirect_uri:t,scope:r.join(" "),state:o,code_challenge:s,code_challenge_method:"S256"});return`${n}?${a}`}var ko=300*1e3;async function yo(){return new Promise(n=>{let e=so((o,s)=>{let a=new URL(o.url,"http://localhost"),i=a.searchParams.get("code")??void 0,c=a.searchParams.get("state")??void 0,l=a.searchParams.get("error")??a.searchParams.get("error_description")??void 0,u=l?ho(l):null,d=u?`<html><body><h1>Authorization failed</h1><p>${u}</p></body></html>`:"<html><body><h1>Authorization successful!</h1><p>You can close this window.</p></body></html>";s.writeHead(200,{"Content-Type":"text/html"}),s.end(d),t({code:i,state:c,error:l})}),t,r=new Promise(o=>{t=o,setTimeout(()=>{o(null),e.close()},ko)});e.listen(0,"127.0.0.1",()=>{let o=e.address();n({redirectUri:`http://localhost:${o.port}/callback`,port:o.port,waitForCallback:()=>r,close:()=>e.close()})})})}function ho(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")}function bo(n){try{process.platform==="win32"?Ze("cmd",["/c","start","",n]):process.platform==="darwin"?Ze("open",[n]):Ze("xdg-open",[n])}catch{console.log("  Could not open browser automatically. Please navigate to the URL above manually.")}}import{CredentialStore as wo}from"@kanonak-protocol/sdk";async function On(n){try{let e=new B,t=new wo,o=await new re(e,t).authorize(n);o.success?console.log(`
 Authenticated with ${n}.`):(console.error(`
 Authentication failed:
   ${o.error}`),process.exit(1))}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`
@@ -55,9 +55,9 @@ Logout failed:
   ${o.error}`),process.exit(1))}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`
 Logout failed unexpectedly:
   ${t}`),process.exit(1)}}import{Command as Yo}from"commander";import{KanonakParser as Zo,KanonakObjectParser as Qo,PublisherIndex as ea,CredentialStore as na,createAuthenticatedFetch as ta,computeIntegrity as ra}from"@kanonak-protocol/sdk";import{readFileSync as So,writeFileSync as vo,existsSync as Po}from"fs";import{join as Ko}from"path";import Nn from"js-yaml";import{getGlobalCachePath as Do}from"@kanonak-protocol/sdk";var Co=`# This file is generated by Kanonak CLI. Do not edit manually.
-`;function Fn(){let n=Do();return Ko(n,"..","capabilities.lock")}function oe(){let n=Fn();if(!Po(n))return{version:"1",lastUpdated:new Date().toISOString(),capabilities:{}};let e=So(n,"utf-8"),t=Nn.load(e);return!t||typeof t!="object"||t.version!=="1"?{version:"1",lastUpdated:new Date().toISOString(),capabilities:{}}:{version:"1",lastUpdated:t.lastUpdated??new Date().toISOString(),capabilities:t.capabilities??{}}}function ge(n){n.lastUpdated=new Date().toISOString();let e={};for(let r of Object.keys(n.capabilities).sort())e[r]=n.capabilities[r];n.capabilities=e;let t=Nn.dump(n,{lineWidth:-1,sortKeys:!1,quotingType:'"'});vo(Fn(),Co+t,"utf-8")}var C=class{constructor(e,t){this.doc=e;this.broader=t}doc;broader;async getAllDocumentsAsync(){return[this.doc]}async getDocumentAsync(e){return this.broader.getDocumentAsync(e)}async getDocumentsByNamespaceAsync(e,t){return this.broader.getDocumentsByNamespaceAsync(e,t)}async getHighestCompatibleVersionAsync(e,t){return this.broader.getHighestCompatibleVersionAsync(e,t)}async saveDocumentAsync(){throw new Error("SingleDocumentRepository is read-only")}async deleteDocumentAsync(){throw new Error("SingleDocumentRepository is read-only")}async clearNamespaceAsync(){throw new Error("SingleDocumentRepository is read-only")}async getAllDocumentReferencesAsync(){return[]}async getDocumentContentAsync(e){return this.broader.getDocumentContentAsync(e)}async getDocumentUriAsync(e){return this.broader.getDocumentUriAsync(e)}};import{existsSync as jo,readdirSync as xo,readFileSync as Uo}from"fs";import{join as Mn}from"path";import{KanonakObjectParser as Oo,EmbeddedKanonak as Wn,ReferenceKanonak as Gn,getGlobalCachePath as Lo}from"@kanonak-protocol/sdk";import{SubjectKanonak as Vn,DefinedKanonak as Eo,StringStatement as Ao,NumberStatement as Ro,BooleanStatement as Io,ReferenceStatement as Bn,EmbeddedStatement as Zc,ListStatement as _o}from"@kanonak-protocol/sdk";function L(n){return`${n.publisher}/${n.package_}/${n.name}`}function T(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}function P(n,e){if(!(n instanceof Eo))return!1;for(let t of n.statement)if(t.predicate?.subject?.name==="type"&&t instanceof Bn){let o=t.object;if(T(o.subject,e))return!0}return!1}function A(n,e){let t=[];for(let r of n)r instanceof Vn&&P(r,e)&&t.push(r);return t}function Pe(n,e){for(let t of n){if(!(t instanceof Vn)||t.name!==e.name)continue;if((t.namespace||"").startsWith(`${e.publisher}/${e.package_}@`))return t}}function nn(n,e){for(let t of n.statement){let r=t.predicate;if(r?.subject&&T(r.subject,e))return t}}function To(n,e){let t=nn(n,e);if(t&&(t instanceof Ao||t instanceof Ro||t instanceof Io))return t.object}function R(n,e){let t=To(n,e);return typeof t=="string"?t:void 0}function ae(n,e){let t=nn(n,e);if(t instanceof Bn)return t.object.subject}function tn(n,e){let t=nn(n,e);return t instanceof _o?t.object??[]:[]}var I="kanonak.org",_="capabilities",rn={publisher:I,package_:_,name:"Capability"},No={publisher:I,package_:_,name:"commandName"},Xn={publisher:I,package_:_,name:"description"},Fo={publisher:I,package_:_,name:"managesType"},Vo={publisher:I,package_:_,name:"deploymentTarget"},Bo={publisher:I,package_:_,name:"hasCommand"},Mo={publisher:I,package_:_,name:"subcommandName"},Ho={publisher:I,package_:_,name:"performs"},qo={publisher:I,package_:_,name:"hasArgument"},zo={publisher:I,package_:_,name:"argumentName"},Hn={publisher:I,package_:_,name:"isRequired"},qn={publisher:I,package_:_,name:"isOption"},Wo={publisher:I,package_:_,name:"defaultValue"};async function Jn(n,e,t){let r=oe(),o=new Oo,s=[],a=!1;for(let[i,c]of Object.entries(r.capabilities)){let l=c,u=n.get(l.publisher,l.package_,l.version);if(!u){let d=await Go(i,l,e,o,t);if(d)console.error(`  Healed capability "${i}": ${l.publisher}/${l.package_}@${l.version} \u2192 ${d.entry.publisher}/${d.entry.package_}@${d.entry.version} (package was renamed)`),r.capabilities[i]=d.entry,l=d.entry,u=d.content,a=!0;else{console.error(`  WARNING: Cached content missing for capability "${i}" (${l.publisher}/${l.package_}@${l.version}). Reinstall it with: kanonak capability remove ${i} && kanonak capability add ${l.publisher}/${l.package_}`);continue}}try{let d=e.parse(u),p=new C(d,t),g=await o.parseKanonaks(p),b=Yn(g,l.publisher,l.package_,l.version);b?s.push(b):console.error(`  WARNING: No Capability instance found in "${i}" (${l.publisher}/${l.package_}@${l.version})`)}catch(d){console.error(`  WARNING: Failed to parse capability "${i}": ${d}`)}}return a&&ge(r),s}async function Go(n,e,t,r,o){let s=Mn(Lo(),e.publisher);if(!jo(s))return;let a=[];for(let i of xo(s)){if(!i.endsWith(".kan.yml"))continue;let c=i.slice(0,-8),l=c.lastIndexOf("@");if(l===-1)continue;let u=c.substring(0,l),d=c.substring(l+1);if(u===e.package_&&d===e.version)continue;let p;try{p=Uo(Mn(s,i),"utf-8")}catch{continue}let g;try{let b=t.parse(p),k=new C(b,o),y=await r.parseKanonaks(k);g=Yn(y,e.publisher,u,d)?.commandName}catch{continue}g===n&&a.push({entry:{publisher:e.publisher,package_:u,version:d,resolved:`kanonak://${e.publisher}/${u}@${d}`,integrity:""},content:p})}if(a.length===1)return a[0]}function Yn(n,e,t,r){let o=A(n,rn);if(o.length===0)return;let s=o[0],a=R(s,No)??"",i=R(s,Xn)??"",c=ae(s,Fo),l=ae(s,Vo),u=[];for(let d of tn(s,Bo)){let p=Xo(d,n);p&&u.push(p)}return{commandName:a,description:i,managesTypeKey:c?L(c):"",deploymentTargetKey:l?L(l):"",commands:u,publisher:e,package_:t,version:r}}function Xo(n,e){let t;if(n instanceof Wn)t=n;else if(n instanceof Gn){let c=Zn(e,n.subject.publisher,n.subject.package_,n.subject.name);c&&(t=c)}if(!t)return;let r=R(t,Mo)??"",o=R(t,Xn)??"",s=ae(t,Ho),a=tn(t,qo),i=[];for(let c of a){let l=Jo(c,e);l&&i.push(l)}return{subcommandName:r,description:o,arguments:i,actionKey:s?L(s):""}}function Jo(n,e){let t;if(n instanceof Wn)t=n;else if(n instanceof Gn){let c=Zn(e,n.subject.publisher,n.subject.package_,n.subject.name);c&&(t=c)}if(!t)return;let r=R(t,zo)??"",o=R(t,Hn)==="true"||zn(t,Hn)===!0,s=R(t,qn)==="true"||zn(t,qn)===!0,a=R(t,Wo),i={argumentName:r,required:o,isOption:s};return a!==void 0&&(i.defaultValue=a),i}function zn(n,e){for(let t of n.statement){let r=t,o=r.predicate;if(o?.subject&&o.subject.publisher===e.publisher&&o.subject.package_===e.package_&&o.subject.name===e.name)return typeof r.object=="boolean"?r.object:void 0}}function Zn(n,e,t,r){for(let o of n){if(!("name"in o)||!("namespace"in o))continue;let s=o;if(s.name===r&&!(!s.namespace||typeof s.namespace!="string")&&s.namespace.startsWith(`${e}/${t}@`))return o}}var oa={publisher:I,package_:_,name:"commandName"};function Qn(){let n=new Yo("capability").description("Manage Kanonak CLI capabilities (pluggable command groups)");return n.command("add <package>").description("Install a capability from a Kanonak publisher").action(async e=>{await aa(e)}),n.command("remove <name>").description("Remove an installed capability").action(async e=>{await sa(e)}),n.command("list").description("List installed capabilities").action(async()=>{await ia()}),n}async function aa(n){let e=ee(n);e||(console.error(`Invalid package reference: "${n}"`),console.error("Expected format: {publisher}/{package}[@{version}]"),process.exit(1));let{publisher:t,packageName:r,version:o,instanceName:s}=e;s&&(console.error(`\`kanonak capability add\` installs whole packages \u2014 got an instance suffix "/${s}".`),console.error(`Try: kanonak capability add ${t}/${r}${o?"@"+o:""}`),process.exit(1));let a=new U,i=new Zo,c=new Qo,l=new na,u=ta(l),d=new ea({fetchFn:u}),p=o??await d.getHighestVersion(t,r);p||(console.error(`Could not resolve version for "${t}/${r}".`),process.exit(1)),console.log(`Installing capability ${t}/${r}@${p}...`);let g=a.get(t,r,p);if(!g){let V=await d.getPackageUrl(t,r,p),Se=await u(V,t);if(!Se.ok)throw new Error(`Failed to fetch ${V} (${Se.status} ${Se.statusText})`);g=await Se.text(),a.put(t,r,p,g)}let b=i.parse(g),k=await O(process.cwd(),i),y=new C(b,k),h=await c.parseKanonaks(y),w=A(h,rn);w.length===0&&(console.error(`Package ${t}/${r}@${p} does not contain a ${I}/${_}/Capability instance.`),process.exit(1));let $=w[0],v=R($,oa);v||(console.error(`Capability instance in ${t}/${r}@${p} has no commandName property.`),process.exit(1));let K=oe();K.capabilities[v]={publisher:t,package_:r,version:p,resolved:await d.getPackageUrl(t,r,p),integrity:ra(g)},ge(K),console.log(`
+`;function Fn(){let n=Do();return Ko(n,"..","capabilities.lock")}function oe(){let n=Fn();if(!Po(n))return{version:"1",lastUpdated:new Date().toISOString(),capabilities:{}};let e=So(n,"utf-8"),t=Nn.load(e);return!t||typeof t!="object"||t.version!=="1"?{version:"1",lastUpdated:new Date().toISOString(),capabilities:{}}:{version:"1",lastUpdated:t.lastUpdated??new Date().toISOString(),capabilities:t.capabilities??{}}}function ge(n){n.lastUpdated=new Date().toISOString();let e={};for(let r of Object.keys(n.capabilities).sort())e[r]=n.capabilities[r];n.capabilities=e;let t=Nn.dump(n,{lineWidth:-1,sortKeys:!1,quotingType:'"'});vo(Fn(),Co+t,"utf-8")}var C=class{constructor(e,t){this.doc=e;this.broader=t}doc;broader;async getAllDocumentsAsync(){return[this.doc]}async getDocumentAsync(e){return this.broader.getDocumentAsync(e)}async getDocumentsByNamespaceAsync(e,t){return this.broader.getDocumentsByNamespaceAsync(e,t)}async getHighestCompatibleVersionAsync(e,t){return this.broader.getHighestCompatibleVersionAsync(e,t)}async saveDocumentAsync(){throw new Error("SingleDocumentRepository is read-only")}async deleteDocumentAsync(){throw new Error("SingleDocumentRepository is read-only")}async clearNamespaceAsync(){throw new Error("SingleDocumentRepository is read-only")}async getAllDocumentReferencesAsync(){return[]}async getDocumentContentAsync(e){return this.broader.getDocumentContentAsync(e)}async getDocumentUriAsync(e){return this.broader.getDocumentUriAsync(e)}};import{existsSync as jo,readdirSync as xo,readFileSync as Uo}from"fs";import{join as Mn}from"path";import{KanonakObjectParser as Oo,EmbeddedKanonak as Wn,ReferenceKanonak as Gn,getGlobalCachePath as Lo}from"@kanonak-protocol/sdk";import{SubjectKanonak as Vn,DefinedKanonak as Eo,StringStatement as Ao,NumberStatement as Ro,BooleanStatement as Io,ReferenceStatement as Bn,EmbeddedStatement as Qc,ListStatement as _o}from"@kanonak-protocol/sdk";function L(n){return`${n.publisher}/${n.package_}/${n.name}`}function T(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}function P(n,e){if(!(n instanceof Eo))return!1;for(let t of n.statement)if(t.predicate?.subject?.name==="type"&&t instanceof Bn){let o=t.object;if(T(o.subject,e))return!0}return!1}function A(n,e){let t=[];for(let r of n)r instanceof Vn&&P(r,e)&&t.push(r);return t}function Pe(n,e){for(let t of n){if(!(t instanceof Vn)||t.name!==e.name)continue;if((t.namespace||"").startsWith(`${e.publisher}/${e.package_}@`))return t}}function en(n,e){for(let t of n.statement){let r=t.predicate;if(r?.subject&&T(r.subject,e))return t}}function To(n,e){let t=en(n,e);if(t&&(t instanceof Ao||t instanceof Ro||t instanceof Io))return t.object}function R(n,e){let t=To(n,e);return typeof t=="string"?t:void 0}function ae(n,e){let t=en(n,e);if(t instanceof Bn)return t.object.subject}function nn(n,e){let t=en(n,e);return t instanceof _o?t.object??[]:[]}var I="kanonak.org",_="capabilities",tn={publisher:I,package_:_,name:"Capability"},No={publisher:I,package_:_,name:"commandName"},Xn={publisher:I,package_:_,name:"description"},Fo={publisher:I,package_:_,name:"managesType"},Vo={publisher:I,package_:_,name:"deploymentTarget"},Bo={publisher:I,package_:_,name:"hasCommand"},Mo={publisher:I,package_:_,name:"subcommandName"},Ho={publisher:I,package_:_,name:"performs"},qo={publisher:I,package_:_,name:"hasArgument"},zo={publisher:I,package_:_,name:"argumentName"},Hn={publisher:I,package_:_,name:"isRequired"},qn={publisher:I,package_:_,name:"isOption"},Wo={publisher:I,package_:_,name:"defaultValue"};async function Jn(n,e,t){let r=oe(),o=new Oo,s=[],a=!1;for(let[i,c]of Object.entries(r.capabilities)){let l=c,u=n.get(l.publisher,l.package_,l.version);if(!u){let d=await Go(i,l,e,o,t);if(d)console.error(`  Healed capability "${i}": ${l.publisher}/${l.package_}@${l.version} \u2192 ${d.entry.publisher}/${d.entry.package_}@${d.entry.version} (package was renamed)`),r.capabilities[i]=d.entry,l=d.entry,u=d.content,a=!0;else{console.error(`  WARNING: Cached content missing for capability "${i}" (${l.publisher}/${l.package_}@${l.version}). Reinstall it with: kanonak capability remove ${i} && kanonak capability add ${l.publisher}/${l.package_}`);continue}}try{let d=e.parse(u),p=new C(d,t),g=await o.parseKanonaks(p),b=Yn(g,l.publisher,l.package_,l.version);b?s.push(b):console.error(`  WARNING: No Capability instance found in "${i}" (${l.publisher}/${l.package_}@${l.version})`)}catch(d){console.error(`  WARNING: Failed to parse capability "${i}": ${d}`)}}return a&&ge(r),s}async function Go(n,e,t,r,o){let s=Mn(Lo(),e.publisher);if(!jo(s))return;let a=[];for(let i of xo(s)){if(!i.endsWith(".kan.yml"))continue;let c=i.slice(0,-8),l=c.lastIndexOf("@");if(l===-1)continue;let u=c.substring(0,l),d=c.substring(l+1);if(u===e.package_&&d===e.version)continue;let p;try{p=Uo(Mn(s,i),"utf-8")}catch{continue}let g;try{let b=t.parse(p),k=new C(b,o),y=await r.parseKanonaks(k);g=Yn(y,e.publisher,u,d)?.commandName}catch{continue}g===n&&a.push({entry:{publisher:e.publisher,package_:u,version:d,resolved:`kanonak://${e.publisher}/${u}@${d}`,integrity:""},content:p})}if(a.length===1)return a[0]}function Yn(n,e,t,r){let o=A(n,tn);if(o.length===0)return;let s=o[0],a=R(s,No)??"",i=R(s,Xn)??"",c=ae(s,Fo),l=ae(s,Vo),u=[];for(let d of nn(s,Bo)){let p=Xo(d,n);p&&u.push(p)}return{commandName:a,description:i,managesTypeKey:c?L(c):"",deploymentTargetKey:l?L(l):"",commands:u,publisher:e,package_:t,version:r}}function Xo(n,e){let t;if(n instanceof Wn)t=n;else if(n instanceof Gn){let c=Zn(e,n.subject.publisher,n.subject.package_,n.subject.name);c&&(t=c)}if(!t)return;let r=R(t,Mo)??"",o=R(t,Xn)??"",s=ae(t,Ho),a=nn(t,qo),i=[];for(let c of a){let l=Jo(c,e);l&&i.push(l)}return{subcommandName:r,description:o,arguments:i,actionKey:s?L(s):""}}function Jo(n,e){let t;if(n instanceof Wn)t=n;else if(n instanceof Gn){let c=Zn(e,n.subject.publisher,n.subject.package_,n.subject.name);c&&(t=c)}if(!t)return;let r=R(t,zo)??"",o=R(t,Hn)==="true"||zn(t,Hn)===!0,s=R(t,qn)==="true"||zn(t,qn)===!0,a=R(t,Wo),i={argumentName:r,required:o,isOption:s};return a!==void 0&&(i.defaultValue=a),i}function zn(n,e){for(let t of n.statement){let r=t,o=r.predicate;if(o?.subject&&o.subject.publisher===e.publisher&&o.subject.package_===e.package_&&o.subject.name===e.name)return typeof r.object=="boolean"?r.object:void 0}}function Zn(n,e,t,r){for(let o of n){if(!("name"in o)||!("namespace"in o))continue;let s=o;if(s.name===r&&!(!s.namespace||typeof s.namespace!="string")&&s.namespace.startsWith(`${e}/${t}@`))return o}}var oa={publisher:I,package_:_,name:"commandName"};function Qn(){let n=new Yo("capability").description("Manage Kanonak CLI capabilities (pluggable command groups)");return n.command("add <package>").description("Install a capability from a Kanonak publisher").action(async e=>{await aa(e)}),n.command("remove <name>").description("Remove an installed capability").action(async e=>{await sa(e)}),n.command("list").description("List installed capabilities").action(async()=>{await ia()}),n}async function aa(n){let e=ee(n);e||(console.error(`Invalid package reference: "${n}"`),console.error("Expected format: {publisher}/{package}[@{version}]"),process.exit(1));let{publisher:t,packageName:r,version:o,instanceName:s}=e;s&&(console.error(`\`kanonak capability add\` installs whole packages \u2014 got an instance suffix "/${s}".`),console.error(`Try: kanonak capability add ${t}/${r}${o?"@"+o:""}`),process.exit(1));let a=new U,i=new Zo,c=new Qo,l=new na,u=ta(l),d=new ea({fetchFn:u}),p=o??await d.getHighestVersion(t,r);p||(console.error(`Could not resolve version for "${t}/${r}".`),process.exit(1)),console.log(`Installing capability ${t}/${r}@${p}...`);let g=a.get(t,r,p);if(!g){let V=await d.getPackageUrl(t,r,p),Se=await u(V,t);if(!Se.ok)throw new Error(`Failed to fetch ${V} (${Se.status} ${Se.statusText})`);g=await Se.text(),a.put(t,r,p,g)}let b=i.parse(g),k=await O(process.cwd(),i),y=new C(b,k),h=await c.parseKanonaks(y),w=A(h,tn);w.length===0&&(console.error(`Package ${t}/${r}@${p} does not contain a ${I}/${_}/Capability instance.`),process.exit(1));let $=w[0],v=R($,oa);v||(console.error(`Capability instance in ${t}/${r}@${p} has no commandName property.`),process.exit(1));let K=oe();K.capabilities[v]={publisher:t,package_:r,version:p,resolved:await d.getPackageUrl(t,r,p),integrity:ra(g)},ge(K),console.log(`
 Installed capability "${v}".`),console.log(`Run "kanonak ${v} --help" to get started.`)}async function sa(n){let e=oe();e.capabilities[n]||(console.error(`Capability "${n}" is not installed.`),process.exit(1));let t=e.capabilities[n];delete e.capabilities[n],ge(e),console.log(`Removed capability "${n}" (${t.publisher}/${t.package_}@${t.version}).`)}async function ia(){let n=oe(),e=Object.entries(n.capabilities);if(e.length===0){console.log("No capabilities installed."),console.log("Install one with: kanonak capability add {publisher}/{package}");return}console.log(`Installed capabilities:
-`);for(let[t,r]of e)console.log(`  ${t}  ${r.publisher}/${r.package_}@${r.version}`)}import{Command as we}from"commander";import{readFileSync as ls,writeFileSync as us,mkdirSync as ds,existsSync as Ft,statSync as fs}from"fs";import{join as ms,resolve as ps}from"path";import{KanonakParser as pn,KanonakObjectParser as gn,SubjectKanonak as gs,Reasoner as ks,KanonakVocabulary as ys,makeUriKey as Bt,pickHighestDocument as kn,formatVersion as Mt}from"@kanonak-protocol/sdk";var ca="kanonak.org",la="transformations";var m=n=>({publisher:ca,package_:la,name:n}),f={Transformation:m("Transformation"),InstanceTransformation:m("InstanceTransformation"),SetTransformation:m("SetTransformation"),inputPattern:m("inputPattern"),rule:m("rule"),artifactName:m("artifactName"),outputs:m("outputs"),formatOverrides:m("formatOverrides"),partitionBy:m("partitionBy"),InputPattern:m("InputPattern"),matchesClass:m("matchesClass"),requires:m("requires"),sortBy:m("sortBy"),SortKey:m("SortKey"),byProperty:m("byProperty"),order:m("order"),SortOrder:m("SortOrder"),ascending:m("ascending"),descending:m("descending"),OutputFormat:m("OutputFormat"),backendUri:m("backendUri"),FormatOverride:m("FormatOverride"),formatTarget:m("formatTarget"),metadataKeys:m("metadataKeys"),metadataRenames:m("metadataRenames"),trailingNewline:m("trailingNewline"),RenameEntry:m("RenameEntry"),fromKey:m("fromKey"),toKey:m("toKey"),FMT_MARKDOWN_FRONTMATTER:m("markdown-with-frontmatter"),FMT_PLAIN_MARKDOWN:m("plain-markdown"),FMT_TOML:m("toml"),FMT_JSON:m("json"),FMT_HTML:m("html"),FMT_SVG:m("svg"),Expression:m("Expression"),ListSourcedExpression:m("ListSourcedExpression"),ListAggregate:m("ListAggregate"),IteratingExpression:m("IteratingExpression"),BuildAstNode:m("BuildAstNode"),astClass:m("astClass"),set:m("set"),AstFieldBinding:m("AstFieldBinding"),field:m("field"),bindValue:m("bindValue"),When:m("When"),condition:m("condition"),thenBuild:m("thenBuild"),elseBuild:m("elseBuild"),Concat:m("Concat"),parts:m("parts"),Fallback:m("Fallback"),primary:m("primary"),alternate:m("alternate"),StringLiteral:m("StringLiteral"),stringLiteral:m("stringLiteral"),IntegerLiteral:m("IntegerLiteral"),integerLiteral:m("integerLiteral"),DecimalLiteral:m("DecimalLiteral"),decimalLiteral:m("decimalLiteral"),BooleanLiteral:m("BooleanLiteral"),booleanLiteral:m("booleanLiteral"),VarRef:m("VarRef"),varName:m("varName"),PropertyRead:m("PropertyRead"),readSource:m("readSource"),readProp:m("readProp"),Traverse:m("Traverse"),traverseSource:m("traverseSource"),through:m("through"),step:m("step"),UriName:m("UriName"),uriNameOf:m("uriNameOf"),SubjectUri:m("SubjectUri"),subjectOf:m("subjectOf"),UriLiteral:m("UriLiteral"),refTo:m("refTo"),DisplayLabel:m("DisplayLabel"),labelTarget:m("labelTarget"),labelSource:m("labelSource"),ResolveRef:m("ResolveRef"),resolveSource:m("resolveSource"),Normalize:m("Normalize"),normSource:m("normSource"),normKind:m("normKind"),NormalizeKind:m("NormalizeKind"),NORM_TRIM_END:m("trim-end"),IsSet:m("IsSet"),checkExpr:m("checkExpr"),ExpressionFragment:m("ExpressionFragment"),body:m("body"),CallFragment:m("CallFragment"),fragmentRef:m("fragmentRef"),source:m("source"),Join:m("Join"),separator:m("separator"),Count:m("Count"),Sum:m("Sum"),Min:m("Min"),Max:m("Max"),Average:m("Average"),loopVar:m("loopVar"),ForEach:m("ForEach"),emit:m("emit"),ListMap:m("ListMap"),mapBody:m("mapBody"),Filter:m("Filter"),predicate:m("predicate"),PartitionBy:m("PartitionBy"),partitionKey:m("partitionKey"),DistinctBy:m("DistinctBy"),distinctKey:m("distinctKey"),Partition:m("Partition"),key:m("key"),members:m("members")};import{DefinedKanonak as _t,ReferenceKanonak as Tt,StringStatement as jt,NumberStatement as xt,BooleanStatement as Ut,ReferenceStatement as Ot,ListStatement as Lt}from"@kanonak-protocol/sdk";var ua="kanonak.org",da="document-ast",S=n=>({publisher:ua,package_:da,name:n}),N={Document:S("Document"),Block:S("Block"),Inline:S("Inline"),StructuredValue:S("StructuredValue"),Heading:S("Heading"),Paragraph:S("Paragraph"),RawBlock:S("RawBlock"),Text:S("Text"),StructuredMap:S("StructuredMap"),StructuredEntry:S("StructuredEntry"),StructuredList:S("StructuredList"),StringScalar:S("StringScalar"),IntegerScalar:S("IntegerScalar"),EscapeHint:S("EscapeHint"),MediaType:S("MediaType"),metadata:S("metadata"),children:S("children"),level:S("level"),inlines:S("inlines"),text:S("text"),entries:S("entries"),key:S("key"),value:S("value"),escapeHint:S("escapeHint"),items:S("items"),stringValue:S("stringValue"),integerValue:S("integerValue"),rawContent:S("rawContent"),mediaType:S("mediaType"),mimeType:S("mimeType"),ESC_RAW:S("esc-raw"),ESC_YAML_SAFE:S("esc-yaml-safe"),ESC_TOML_STRING:S("esc-toml-string"),ESC_TOML_MULTILINE:S("esc-toml-multiline"),ESC_JSON:S("esc-json"),TEXT_PLAIN:S("text-plain"),TEXT_MARKDOWN:S("text-markdown"),TEXT_HTML:S("text-html"),APPLICATION_JSON:S("application-json"),TEXT_YAML:S("text-yaml"),IMAGE_SVG_XML:S("image-svg-xml")};function et(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var De=class{backendUri="kanonak.org/transformations/markdown-with-frontmatter";render(e,t){let r=fa(e.metadata,t),o=ga(e.children),a=["---",...r,"---","",o].join(`
+`);for(let[t,r]of e)console.log(`  ${t}  ${r.publisher}/${r.package_}@${r.version}`)}import{Command as we}from"commander";import{readFileSync as ls,writeFileSync as us,mkdirSync as ds,existsSync as Ft,statSync as fs}from"fs";import{join as ms,resolve as ps}from"path";import{KanonakParser as mn,KanonakObjectParser as pn,SubjectKanonak as gs,Reasoner as ks,KanonakVocabulary as ys,makeUriKey as Bt,pickHighestDocument as gn,formatVersion as Mt}from"@kanonak-protocol/sdk";var ca="kanonak.org",la="transformations";var m=n=>({publisher:ca,package_:la,name:n}),f={Transformation:m("Transformation"),InstanceTransformation:m("InstanceTransformation"),SetTransformation:m("SetTransformation"),inputPattern:m("inputPattern"),rule:m("rule"),artifactName:m("artifactName"),outputs:m("outputs"),formatOverrides:m("formatOverrides"),partitionBy:m("partitionBy"),InputPattern:m("InputPattern"),matchesClass:m("matchesClass"),requires:m("requires"),sortBy:m("sortBy"),SortKey:m("SortKey"),byProperty:m("byProperty"),order:m("order"),SortOrder:m("SortOrder"),ascending:m("ascending"),descending:m("descending"),OutputFormat:m("OutputFormat"),backendUri:m("backendUri"),FormatOverride:m("FormatOverride"),formatTarget:m("formatTarget"),metadataKeys:m("metadataKeys"),metadataRenames:m("metadataRenames"),trailingNewline:m("trailingNewline"),RenameEntry:m("RenameEntry"),fromKey:m("fromKey"),toKey:m("toKey"),FMT_MARKDOWN_FRONTMATTER:m("markdown-with-frontmatter"),FMT_PLAIN_MARKDOWN:m("plain-markdown"),FMT_TOML:m("toml"),FMT_JSON:m("json"),FMT_HTML:m("html"),FMT_SVG:m("svg"),Expression:m("Expression"),ListSourcedExpression:m("ListSourcedExpression"),ListAggregate:m("ListAggregate"),IteratingExpression:m("IteratingExpression"),BuildAstNode:m("BuildAstNode"),astClass:m("astClass"),set:m("set"),AstFieldBinding:m("AstFieldBinding"),field:m("field"),bindValue:m("bindValue"),When:m("When"),condition:m("condition"),thenBuild:m("thenBuild"),elseBuild:m("elseBuild"),Concat:m("Concat"),parts:m("parts"),Fallback:m("Fallback"),primary:m("primary"),alternate:m("alternate"),StringLiteral:m("StringLiteral"),stringLiteral:m("stringLiteral"),IntegerLiteral:m("IntegerLiteral"),integerLiteral:m("integerLiteral"),DecimalLiteral:m("DecimalLiteral"),decimalLiteral:m("decimalLiteral"),BooleanLiteral:m("BooleanLiteral"),booleanLiteral:m("booleanLiteral"),VarRef:m("VarRef"),varName:m("varName"),PropertyRead:m("PropertyRead"),readSource:m("readSource"),readProp:m("readProp"),Traverse:m("Traverse"),traverseSource:m("traverseSource"),through:m("through"),step:m("step"),UriName:m("UriName"),uriNameOf:m("uriNameOf"),SubjectUri:m("SubjectUri"),subjectOf:m("subjectOf"),UriLiteral:m("UriLiteral"),refTo:m("refTo"),DisplayLabel:m("DisplayLabel"),labelTarget:m("labelTarget"),labelSource:m("labelSource"),ResolveRef:m("ResolveRef"),resolveSource:m("resolveSource"),Normalize:m("Normalize"),normSource:m("normSource"),normKind:m("normKind"),NormalizeKind:m("NormalizeKind"),NORM_TRIM_END:m("trim-end"),IsSet:m("IsSet"),checkExpr:m("checkExpr"),ExpressionFragment:m("ExpressionFragment"),body:m("body"),CallFragment:m("CallFragment"),fragmentRef:m("fragmentRef"),source:m("source"),Join:m("Join"),separator:m("separator"),Count:m("Count"),Sum:m("Sum"),Min:m("Min"),Max:m("Max"),Average:m("Average"),loopVar:m("loopVar"),ForEach:m("ForEach"),emit:m("emit"),ListMap:m("ListMap"),mapBody:m("mapBody"),Filter:m("Filter"),predicate:m("predicate"),PartitionBy:m("PartitionBy"),partitionKey:m("partitionKey"),DistinctBy:m("DistinctBy"),distinctKey:m("distinctKey"),Partition:m("Partition"),key:m("key"),members:m("members")};import{DefinedKanonak as _t,ReferenceKanonak as Tt,StringStatement as jt,NumberStatement as xt,BooleanStatement as Ut,ReferenceStatement as Ot,ListStatement as Lt}from"@kanonak-protocol/sdk";var ua="kanonak.org",da="document-ast",S=n=>({publisher:ua,package_:da,name:n}),N={Document:S("Document"),Block:S("Block"),Inline:S("Inline"),StructuredValue:S("StructuredValue"),Heading:S("Heading"),Paragraph:S("Paragraph"),RawBlock:S("RawBlock"),Text:S("Text"),StructuredMap:S("StructuredMap"),StructuredEntry:S("StructuredEntry"),StructuredList:S("StructuredList"),StringScalar:S("StringScalar"),IntegerScalar:S("IntegerScalar"),EscapeHint:S("EscapeHint"),MediaType:S("MediaType"),metadata:S("metadata"),children:S("children"),level:S("level"),inlines:S("inlines"),text:S("text"),entries:S("entries"),key:S("key"),value:S("value"),escapeHint:S("escapeHint"),items:S("items"),stringValue:S("stringValue"),integerValue:S("integerValue"),rawContent:S("rawContent"),mediaType:S("mediaType"),mimeType:S("mimeType"),ESC_RAW:S("esc-raw"),ESC_YAML_SAFE:S("esc-yaml-safe"),ESC_TOML_STRING:S("esc-toml-string"),ESC_TOML_MULTILINE:S("esc-toml-multiline"),ESC_JSON:S("esc-json"),TEXT_PLAIN:S("text-plain"),TEXT_MARKDOWN:S("text-markdown"),TEXT_HTML:S("text-html"),APPLICATION_JSON:S("application-json"),TEXT_YAML:S("text-yaml"),IMAGE_SVG_XML:S("image-svg-xml")};function et(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var De=class{backendUri="kanonak.org/transformations/markdown-with-frontmatter";render(e,t){let r=fa(e.metadata,t),o=ga(e.children),a=["---",...r,"---","",o].join(`
 `);return t?.trailingNewline&&(a.endsWith(`
 `)||(a+=`
 `)),a}};function fa(n,e){if(!n)return[];let t=new Map;for(let i of n.entries)t.set(Ke(i.key),i);let r=new Map;if(e?.metadataRenames)for(let[i,c]of e.metadataRenames)r.set(Ke(i),c);let s=(e?.metadataKeys??n.entries.map(i=>i.key)).map(Ke),a=[];for(let i of s){let c=t.get(i);if(!c)continue;let l=r.get(i),u=Ke(l??i),d=tt(c.value,c.escapeHint);d!==void 0&&a.push(`${u}: ${d}`)}return a}function Ke(n){let e=n.lastIndexOf(".");return e===-1?n:n.substring(e+1)||n}function tt(n,e){switch(n.kind){case"StringScalar":return ma(n.stringValue,e);case"IntegerScalar":return String(n.integerValue);case"StructuredList":{let t=[];for(let r of n.items){let o=tt(r,e);o!==void 0&&t.push(o)}return t.join(", ")}case"StructuredMap":return;default:return}}function ma(n,e){return!e||et(e,N.ESC_RAW)?n:et(e,N.ESC_YAML_SAFE)?pa(n):n}function pa(n){return n.includes(`
@@ -75,20 +75,20 @@ ${n.replace(/"""/g,'\\"\\"\\"')}
 `:r}};function at(n){let e=n.replace(/\r\n/g,`
 `).split(`
 `),t=[],r=0;for(;r<e.length;){let o=e[r];if(o.trim()===""){r++;continue}let s=/^(\s*)```(\S*)\s*$/.exec(o);if(s){let c=s[2],l=[];for(r++;r<e.length&&!/^(\s*)```\s*$/.test(e[r]);)l.push(e[r]),r++;r++;let u=st(l.join(`
-`)),d=c?` class="language-${it(c)}"`:"";t.push(`<pre><code${d}>${u}</code></pre>`);continue}let a=/^(#{1,6})\s+(.*)$/.exec(o);if(a){let c=a[1].length,l=se(a[2].trim());t.push(`<h${c}>${l}</h${c}>`),r++;continue}if(o.includes("|")&&r+1<e.length&&ot(e[r+1])){let c=on(o),l=Sa(e[r+1]);r+=2;let u=[];for(;r<e.length&&e[r].trim()!==""&&e[r].includes("|");)u.push(on(e[r])),r++;t.push(va(c,l,u));continue}if(/^\s*[-*]\s+/.test(o)){let c=[];for(;r<e.length&&/^\s*[-*]\s+/.test(e[r]);){let l=[e[r].replace(/^\s*[-*]\s+/,"")];for(r++;r<e.length&&e[r].trim()!==""&&!/^\s*[-*]\s+/.test(e[r])&&!/^\s*\d+\.\s+/.test(e[r]);)l.push(e[r]),r++;r<e.length&&e[r].trim()===""&&r++,c.push(`<li>${se(l.join(" ").trim())}</li>`)}t.push(`<ul>
+`)),d=c?` class="language-${it(c)}"`:"";t.push(`<pre><code${d}>${u}</code></pre>`);continue}let a=/^(#{1,6})\s+(.*)$/.exec(o);if(a){let c=a[1].length,l=se(a[2].trim());t.push(`<h${c}>${l}</h${c}>`),r++;continue}if(o.includes("|")&&r+1<e.length&&ot(e[r+1])){let c=rn(o),l=Sa(e[r+1]);r+=2;let u=[];for(;r<e.length&&e[r].trim()!==""&&e[r].includes("|");)u.push(rn(e[r])),r++;t.push(va(c,l,u));continue}if(/^\s*[-*]\s+/.test(o)){let c=[];for(;r<e.length&&/^\s*[-*]\s+/.test(e[r]);){let l=[e[r].replace(/^\s*[-*]\s+/,"")];for(r++;r<e.length&&e[r].trim()!==""&&!/^\s*[-*]\s+/.test(e[r])&&!/^\s*\d+\.\s+/.test(e[r]);)l.push(e[r]),r++;r<e.length&&e[r].trim()===""&&r++,c.push(`<li>${se(l.join(" ").trim())}</li>`)}t.push(`<ul>
 ${c.join(`
 `)}
 </ul>`);continue}if(/^\s*\d+\.\s+/.test(o)){let c=[];for(;r<e.length&&/^\s*\d+\.\s+/.test(e[r]);){let l=[e[r].replace(/^\s*\d+\.\s+/,"")];for(r++;r<e.length&&e[r].trim()!==""&&!/^\s*\d+\.\s+/.test(e[r])&&!/^\s*[-*]\s+/.test(e[r]);)l.push(e[r]),r++;r<e.length&&e[r].trim()===""&&r++,c.push(`<li>${se(l.join(" ").trim())}</li>`)}t.push(`<ol>
 ${c.join(`
 `)}
 </ol>`);continue}let i=[o];for(r++;r<e.length&&e[r].trim()!==""&&!/^(#{1,6})\s+/.test(e[r])&&!/^(\s*)```/.test(e[r])&&!/^\s*[-*]\s+/.test(e[r])&&!/^\s*\d+\.\s+/.test(e[r])&&!(e[r].includes("|")&&r+1<e.length&&ot(e[r+1]));)i.push(e[r]),r++;t.push(`<p>${se(i.join(" "))}</p>`)}return t.join(`
-`)}function ot(n){return n.includes("-")?/^[\s|:-]+$/.test(n):!1}function on(n){let e=n.trim();return e.startsWith("|")&&(e=e.slice(1)),e.endsWith("|")&&(e=e.slice(0,-1)),e.split("|").map(t=>t.trim())}function Sa(n){return on(n).map(e=>{let t=e.startsWith(":"),r=e.endsWith(":");return t&&r?"center":r?"right":t?"left":null})}function va(n,e,t){let r=a=>{let i=e[a];return i?` style="text-align:${i}"`:""},o=n.map((a,i)=>`<th${r(i)}>${se(a)}</th>`).join(""),s=t.map(a=>`<tr>${a.map((c,l)=>`<td${r(l)}>${se(c)}</td>`).join("")}</tr>`).join(`
+`)}function ot(n){return n.includes("-")?/^[\s|:-]+$/.test(n):!1}function rn(n){let e=n.trim();return e.startsWith("|")&&(e=e.slice(1)),e.endsWith("|")&&(e=e.slice(0,-1)),e.split("|").map(t=>t.trim())}function Sa(n){return rn(n).map(e=>{let t=e.startsWith(":"),r=e.endsWith(":");return t&&r?"center":r?"right":t?"left":null})}function va(n,e,t){let r=a=>{let i=e[a];return i?` style="text-align:${i}"`:""},o=n.map((a,i)=>`<th${r(i)}>${se(a)}</th>`).join(""),s=t.map(a=>`<tr>${a.map((c,l)=>`<td${r(l)}>${se(c)}</td>`).join("")}</tr>`).join(`
 `);return`<table>
 <thead><tr>${o}</tr></thead>
 <tbody>
 ${s}
 </tbody>
-</table>`}function se(n){let e=st(n);return e=e.replace(/`([^`\n]+)`/g,(t,r)=>`<code>${r}</code>`),e=e.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g,(t,r,o)=>`<a href="${it(o)}">${r}</a>`),e=e.replace(/\*\*([^*\n]+)\*\*/g,(t,r)=>`<strong>${r}</strong>`),e=e.replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g,(t,r,o)=>`${r}<em>${o}</em>`),e=e.replace(/(^|[\s(])_([^_\n]+)_(?=[\s).,;:!?]|$)/g,(t,r,o)=>`${r}<em>${o}</em>`),e}function st(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function it(n){return n.replace(/"/g,"&quot;").replace(/&/g,"&amp;")}function an(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var Ae=class{backendUri="kanonak.org/transformations/html";render(e,t){let r=Pa(e.metadata)??"Untitled",o=Ka(e.metadata,t),s=Da(e.children),a=`<!DOCTYPE html>
+</table>`}function se(n){let e=st(n);return e=e.replace(/`([^`\n]+)`/g,(t,r)=>`<code>${r}</code>`),e=e.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g,(t,r,o)=>`<a href="${it(o)}">${r}</a>`),e=e.replace(/\*\*([^*\n]+)\*\*/g,(t,r)=>`<strong>${r}</strong>`),e=e.replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g,(t,r,o)=>`${r}<em>${o}</em>`),e=e.replace(/(^|[\s(])_([^_\n]+)_(?=[\s).,;:!?]|$)/g,(t,r,o)=>`${r}<em>${o}</em>`),e}function st(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function it(n){return n.replace(/"/g,"&quot;").replace(/&/g,"&amp;")}function on(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var Ae=class{backendUri="kanonak.org/transformations/html";render(e,t){let r=Pa(e.metadata)??"Untitled",o=Ka(e.metadata,t),s=Da(e.children),a=`<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="utf-8">
@@ -124,11 +124,11 @@ ${o.join(`
 `)}
 </dl>
 `}function lt(n){switch(n.kind){case"StringScalar":return ke(n.stringValue);case"IntegerScalar":return String(n.integerValue);case"StructuredList":{let e=[];for(let t of n.items){let r=lt(t);r!==void 0&&e.push(`<code>${r}</code>`)}return e.join(", ")}case"StructuredMap":return;default:return}}function Da(n){let e=[];for(let t of n){let r=Ca(t);r&&e.push(r)}return e.join(`
-`)}function Ca(n){switch(n.kind){case"Heading":{let e=Math.max(1,Math.min(6,n.level));return`<h${e}>${ct(n.inlines)}</h${e}>`}case"Paragraph":return`<p>${ct(n.inlines)}</p>`;case"RawBlock":return Ea(n);default:return""}}function Ea(n){let e=n.mediaType;return e&&an(e,N.TEXT_MARKDOWN)?at(n.rawContent):e&&an(e,N.TEXT_HTML)?n.rawContent:e&&an(e,N.IMAGE_SVG_XML)?`<figure class="svg-figure">
+`)}function Ca(n){switch(n.kind){case"Heading":{let e=Math.max(1,Math.min(6,n.level));return`<h${e}>${ct(n.inlines)}</h${e}>`}case"Paragraph":return`<p>${ct(n.inlines)}</p>`;case"RawBlock":return Ea(n);default:return""}}function Ea(n){let e=n.mediaType;return e&&on(e,N.TEXT_MARKDOWN)?at(n.rawContent):e&&on(e,N.TEXT_HTML)?n.rawContent:e&&on(e,N.IMAGE_SVG_XML)?`<figure class="svg-figure">
 ${n.rawContent}
 </figure>`:`<pre${e?` class="media-${Aa(e.name)}"`:""}><code>${ke(n.rawContent)}</code></pre>`}function ct(n){let e=[];for(let t of n)t.kind==="Text"&&e.push(ke(t.text));return e.join("")}function ke(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function Aa(n){return n.replace(/"/g,"&quot;").replace(/&/g,"&amp;")}function Ra(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var Re=class{backendUri="kanonak.org/transformations/svg";render(e,t){for(let r of e.children)if(r.kind==="RawBlock"&&r.mediaType&&Ra(r.mediaType,N.IMAGE_SVG_XML)){let o=r.rawContent;return t?.trailingNewline&&!o.endsWith(`
 `)&&(o+=`
-`),o}return'<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"/>'}};import{SubjectKanonak as ut}from"@kanonak-protocol/sdk";var Ie=class{constructor(e,t,r){this.repository=e;this.parser=t;this.objectParser=r}repository;parser;objectParser;cache=new Map;async resolveSubject(e,t){let r=Pe(t,e);if(r)return r;let o=`${e.publisher}/${e.package_}`,s=this.cache.get(o);if(!s){let a=await this.repository.getDocumentsByNamespaceAsync(e.publisher,e.package_);if(a.length===0)return;let i=a[0],c=new C(i,this.repository);s=await this.objectParser.parseKanonaks(c),this.cache.set(o,s)}for(let a of s)if(a instanceof ut&&a.name===e.name&&a.namespace&&a.namespace.startsWith(`${e.publisher}/${e.package_}@`))return a;for(let a of s)if(a instanceof ut&&a.name===e.name)return a}};import{EmbeddedKanonak as he,ReferenceKanonak as kt,SubjectKanonak as Ia,ListStatement as H,ReferenceStatement as cn,EmbeddedStatement as ce,StringStatement as yt,NumberStatement as _a,BooleanStatement as Ta}from"@kanonak-protocol/sdk";var E=class extends Error{constructor(t,r){super(`${t} (at ${r})`);this.path=r}path},dt=16;function le(n,e){let t=n.name,r={catalog:e,depth:0};if(P(n,f.InstanceTransformation))return ja(n,t,r);if(P(n,f.SetTransformation))return xa(n,t,r);throw new E("Subject is not a recognized v3 transformation type \u2014 expected InstanceTransformation or SetTransformation",t)}function ja(n,e,t){return{kind:"instance",name:n.name,inputPattern:ht(n,e),rule:_e(n,f.rule,`${e}.rule`,t),artifactName:_e(n,f.artifactName,`${e}.artifactName`,t),outputs:bt(n,`${e}.outputs`),overrides:wt(n,`${e}.formatOverrides`,t)}}function xa(n,e,t){let r=q(n,f.partitionBy);return{kind:"set",name:n.name,inputPattern:ht(n,e),rule:_e(n,f.rule,`${e}.rule`,t),artifactName:_e(n,f.artifactName,`${e}.artifactName`,t),outputs:bt(n,`${e}.outputs`),overrides:wt(n,`${e}.formatOverrides`,t),partitionBy:r}}function ht(n,e){let t=be(n,f.inputPattern);if(!t)throw new E("inputPattern is required",e);return Ua(t,`${e}.inputPattern`)}function Ua(n,e){let t=q(n,f.matchesClass);if(!t)throw new E("matchesClass is required",e);let r=[];for(let a of x(n,f.requires))if(a instanceof cn)r.push(sn(a.object.subject));else if(a instanceof H)for(let i of a.object)i instanceof kt&&r.push(sn(i.subject));let o=[],s=0;for(let a of x(n,f.sortBy))if(a instanceof H)for(let i of a.object)i instanceof he&&o.push(ft(i,`${e}.sortBy[${s++}]`));else a instanceof ce&&o.push(ft(a.object,`${e}.sortBy[${s++}]`));return{matchesClass:t,requires:r,sortBy:o}}function ft(n,e){let t=q(n,f.byProperty);if(!t)throw new E("SortKey.byProperty is required",e);let r=q(n,f.order);if(!r)throw new E("SortKey.order is required",e);if(T(r,f.ascending))return{byProperty:t,order:"ascending"};if(T(r,f.descending))return{byProperty:t,order:"descending"};throw new E(`SortKey.order must reference tx.ascending or tx.descending; got ${r.publisher}/${r.package_}/${r.name}`,e)}function _e(n,e,t,r){let o=be(n,e);if(!o)throw new E("expression is required",t);return ie(o,t,r)}function ie(n,e,t){if(P(n,f.StringLiteral))return{kind:"string-literal",value:M(n,f.stringLiteral,e)};if(P(n,f.IntegerLiteral))return{kind:"integer-literal",value:gt(n,f.integerLiteral,e)};if(P(n,f.DecimalLiteral))return{kind:"decimal-literal",value:gt(n,f.decimalLiteral,e)};if(P(n,f.BooleanLiteral))return{kind:"boolean-literal",value:qa(n,f.booleanLiteral,e)};if(P(n,f.VarRef))return{kind:"var-ref",varName:M(n,f.varName,e)};if(P(n,f.PropertyRead))return{kind:"property-read",source:D(n,f.readSource,`${e}.readSource`,t),readProp:X(n,f.readProp,e,"readProp")};if(P(n,f.Traverse))return{kind:"traverse",source:D(n,f.traverseSource,`${e}.traverseSource`,t),through:X(n,f.through,e,"through"),step:D(n,f.step,`${e}.step`,t)};if(P(n,f.BuildAstNode))return{kind:"build-ast-node",astClass:X(n,f.astClass,e,"astClass"),set:Na(n,`${e}.set`,t)};if(P(n,f.When))return{kind:"when",condition:D(n,f.condition,`${e}.condition`,t),thenBuild:D(n,f.thenBuild,`${e}.thenBuild`,t),elseBuild:Oa(n,f.elseBuild,`${e}.elseBuild`,t)};if(P(n,f.Concat))return{kind:"concat",parts:La(n,f.parts,`${e}.parts`,t)};if(P(n,f.Fallback))return{kind:"fallback",primary:D(n,f.primary,`${e}.primary`,t),alternate:D(n,f.alternate,`${e}.alternate`,t)};if(P(n,f.UriName))return{kind:"uri-name",source:D(n,f.uriNameOf,`${e}.uriNameOf`,t)};if(P(n,f.SubjectUri))return{kind:"subject-uri",source:D(n,f.subjectOf,`${e}.subjectOf`,t)};if(P(n,f.UriLiteral))return{kind:"uri-literal",refTo:X(n,f.refTo,e,"refTo")};if(P(n,f.DisplayLabel))return{kind:"display-label",labelTarget:X(n,f.labelTarget,e,"labelTarget"),labelSource:X(n,f.labelSource,e,"labelSource")};if(P(n,f.ResolveRef))return{kind:"resolve-ref",source:D(n,f.resolveSource,`${e}.resolveSource`,t)};if(P(n,f.Normalize))return{kind:"normalize",source:D(n,f.normSource,`${e}.normSource`,t),normKind:Fa(n,e)};if(P(n,f.IsSet))return{kind:"is-set",check:D(n,f.checkExpr,`${e}.checkExpr`,t)};if(P(n,f.CallFragment))return Va(n,e,t);if(P(n,f.Join))return{kind:"join",source:D(n,f.source,`${e}.source`,t),separator:M(n,f.separator,e)};if(P(n,f.Count))return{kind:"count",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.Sum))return{kind:"sum",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.Min))return{kind:"min",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.Max))return{kind:"max",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.Average))return{kind:"average",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.ForEach))return{kind:"for-each",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),emit:D(n,f.emit,`${e}.emit`,t)};if(P(n,f.ListMap))return{kind:"list-map",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),mapBody:D(n,f.mapBody,`${e}.mapBody`,t)};if(P(n,f.Filter))return{kind:"filter",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),predicate:D(n,f.predicate,`${e}.predicate`,t)};if(P(n,f.PartitionBy))return{kind:"partition-by",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),partitionKey:D(n,f.partitionKey,`${e}.partitionKey`,t)};if(P(n,f.DistinctBy))return{kind:"distinct-by",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),distinctKey:D(n,f.distinctKey,`${e}.distinctKey`,t)};throw new E("Expression is not of a recognized v3 type \u2014 embedded has no matching subclass of tx.Expression",e)}function D(n,e,t,r){let o=be(n,e);if(!o)throw new E("child expression is required",t);return ie(o,t,r)}function Oa(n,e,t,r){let o=be(n,e);if(o)return ie(o,t,r)}function La(n,e,t,r){let o=[],s=0;for(let a of x(n,e))if(a instanceof H)for(let i of a.object)i instanceof he&&o.push(ie(i,`${t}[${s++}]`,r));else a instanceof ce&&o.push(ie(a.object,`${t}[${s++}]`,r));return o}function Na(n,e,t){let r=[],o=0;for(let s of x(n,f.set))if(s instanceof H)for(let a of s.object)a instanceof he&&r.push(mt(a,`${e}[${o++}]`,t));else s instanceof ce&&r.push(mt(s.object,`${e}[${o++}]`,t));return r}function mt(n,e,t){return{field:X(n,f.field,e,"field"),value:D(n,f.bindValue,`${e}.bindValue`,t)}}function Fa(n,e){let t=q(n,f.normKind);if(!t)throw new E("normKind is required",e);if(T(t,f.NORM_TRIM_END))return"trim-end";throw new E(`Unknown NormalizeKind: ${t.publisher}/${t.package_}/${t.name}`,e)}function Va(n,e,t){if(t.depth>=dt)throw new E(`Fragment recursion exceeded MAX_FRAGMENT_DEPTH (${dt})`,e);let r=q(n,f.fragmentRef);if(!r)throw new E("fragmentRef is required",e);let o=Ba(t.catalog,r);if(!o)throw new E(`ExpressionFragment not found: ${r.publisher}/${r.package_}/${r.name}`,e);let s=be(o,f.body);if(!s)throw new E(`ExpressionFragment ${r.name} has no body`,e);return{kind:"call-fragment",body:ie(s,`${e}.fragment(${r.name})`,{catalog:t.catalog,depth:t.depth+1})}}function Ba(n,e){for(let t of n)if(!(!(t instanceof Ia)||t.name!==e.name||!(t.namespace||"").startsWith(`${e.publisher}/${e.package_}@`))&&P(t,f.ExpressionFragment))return t}function bt(n,e){let t=new Set;for(let r of x(n,f.outputs))if(r instanceof cn)t.add(r.object.subject.name);else if(r instanceof H)for(let o of r.object)o instanceof kt&&t.add(o.subject.name);if(t.size===0)throw new E("outputs is required (at least one OutputFormat)",e);return t}function wt(n,e,t){let r=new Map,o=0;for(let s of x(n,f.formatOverrides))if(s instanceof H){for(let a of s.object)if(a instanceof he){let[i,c]=pt(a,`${e}[${o++}]`);r.set(i,c)}}else if(s instanceof ce){let[a,i]=pt(s.object,`${e}[${o++}]`);r.set(a,i)}return r}function pt(n,e){let t=q(n,f.formatTarget);if(!t)throw new E("formatTarget is required",e);let r=[];for(let a of x(n,f.metadataKeys))if(a instanceof yt)r.push(a.object);else if(a instanceof H)for(let i of a.object){let c=i.value;typeof c=="string"&&r.push(c)}let o=new Map;for(let a of x(n,f.metadataRenames))if(a instanceof H){for(let i of a.object)if(i instanceof he){let c=ye(i,f.fromKey),l=ye(i,f.toKey);c&&l&&o.set(c,l)}}else if(a instanceof ce){let i=a.object,c=ye(i,f.fromKey),l=ye(i,f.toKey);c&&l&&o.set(c,l)}let s=$t(n,f.trailingNewline);return[t.name,{metadataKeys:r.length>0?r:void 0,metadataRenames:o,trailingNewline:s}]}function Ma(n){return n.predicate?.subject}function x(n,e){let t=[];for(let r of n.statement){let o=Ma(r);o&&T(o,e)&&t.push(r)}return t}function be(n,e){for(let t of x(n,e))if(t instanceof ce)return t.object}function q(n,e){for(let t of x(n,e))if(t instanceof cn)return sn(t.object.subject)}function ye(n,e){for(let t of x(n,e))if(t instanceof yt)return t.object}function Ha(n,e){for(let t of x(n,e))if(t instanceof _a)return t.object}function $t(n,e){for(let t of x(n,e))if(t instanceof Ta)return t.object}function M(n,e,t){let r=ye(n,e);if(r===void 0)throw new E(`${e.name} (string) is required`,t);return r}function gt(n,e,t){let r=Ha(n,e);if(r===void 0)throw new E(`${e.name} (number) is required`,t);return r}function qa(n,e,t){let r=$t(n,e);if(r===void 0)throw new E(`${e.name} (boolean) is required`,t);return r}function X(n,e,t,r){let o=q(n,e);if(!o)throw new E(`${r} (URI reference) is required`,t);return o}function sn(n){return{publisher:n.publisher,package_:n.package_,name:n.name}}import{DefinedKanonak as xe,EmbeddedKanonak as za,ReferenceKanonak as de,SubjectKanonak as St,StringStatement as Wa,NumberStatement as Ga,BooleanStatement as Xa,ReferenceStatement as Dt,EmbeddedStatement as Ja,ListStatement as Ct}from"@kanonak-protocol/sdk";var z=class extends Error{},Te=class{constructor(e,t){this.resolver=e;this.catalog=t}resolver;catalog;async evaluate(e,t){switch(e.kind){case"string-literal":return e.value;case"integer-literal":return e.value;case"decimal-literal":return e.value;case"boolean-literal":return e.value;case"uri-literal":return{...e.refTo};case"var-ref":{if(!t.has(e.varName))throw new z(`Unbound variable "${e.varName}"`);return t.get(e.varName)}case"concat":{let r=[];for(let o of e.parts){let s=await this.evaluate(o,t);if(s!=null)if(Array.isArray(s))for(let a of s)r.push(a);else r.push(s)}return r}case"fallback":{let r=await this.evaluate(e.primary,t);return Pt(r)?r:this.evaluate(e.alternate,t)}case"when":return await this.evaluate(e.condition,t)===!0?this.evaluate(e.thenBuild,t):e.elseBuild?this.evaluate(e.elseBuild,t):void 0;case"is-set":{let r=await this.evaluate(e.check,t);return Pt(r)}case"property-read":{let r=await this.evaluate(e.source,t);return vt(r,e.readProp)}case"traverse":{let r=await this.evaluate(e.source,t);if(!(r instanceof xe))return;let o=Za(r,e.through),s=[];for(let a of o){let i=await this.resolver.resolveSubject(a,this.catalog);if(!i)continue;let c=new Map(t);c.set("input",i);let l=await this.evaluate(e.step,c);l!=null&&s.push(ln(l))}return s.join("")}case"uri-name":{let r=await this.evaluate(e.source,t);return je(r)?r.name:r instanceof de?r.subject.name:r instanceof St?r.name:r instanceof za?r.name??"":void 0}case"subject-uri":{let r=await this.evaluate(e.source,t);if(r instanceof St){let o=r.namespace??"",s=r.name??"";return!o||!s?void 0:`${o}/${s}`}if(r instanceof de){let o=r.subject,s=o.version;return s&&typeof s.major=="number"?`${o.publisher}/${o.package_}@${s.major}.${s.minor}.${s.patch}/${o.name}`:`${o.publisher}/${o.package_}/${o.name}`}return}case"display-label":{let r=await this.resolver.resolveSubject({...e.labelTarget},this.catalog);return r?vt(r,e.labelSource):void 0}case"resolve-ref":{let r=await this.evaluate(e.source,t);return r instanceof de?await this.resolver.resolveSubject(r.subject,this.catalog):je(r)?await this.resolver.resolveSubject(r,this.catalog):void 0}case"normalize":{let r=await this.evaluate(e.source,t),o=r==null?"":ln(r);return e.normKind==="trim-end"?o.replace(/[\s\r\n]+$/u,""):o}case"build-ast-node":{let r={kind:e.astClass.name};for(let o of e.set){let s=await this.evaluate(o.value,t);if(s==null||Array.isArray(s)&&s.length===0)continue;let a=o.field.name;Array.isArray(s)&&es.has(a)&&s.every(i=>ns(i))&&(s=s.map(i=>String(i)).join("")),r[a]=s}return r}case"call-fragment":return this.evaluate(e.body,t);case"join":return(await this.evaluateList(e.source,t)).map(o=>o==null?"":ln(o)).join(e.separator);case"count":return(await this.evaluateList(e.source,t)).length;case"sum":{let r=await this.evaluateList(e.source,t),o=0;for(let s of r)o+=ue(s,"Sum");return o}case"min":{let r=await this.evaluateList(e.source,t);if(r.length===0)throw new z("Min on an empty list is undefined; guard with IsSet");let o=ue(r[0],"Min");for(let s=1;s<r.length;s++){let a=ue(r[s],"Min");a<o&&(o=a)}return o}case"max":{let r=await this.evaluateList(e.source,t);if(r.length===0)throw new z("Max on an empty list is undefined; guard with IsSet");let o=ue(r[0],"Max");for(let s=1;s<r.length;s++){let a=ue(r[s],"Max");a>o&&(o=a)}return o}case"average":{let r=await this.evaluateList(e.source,t);if(r.length===0)throw new z("Average on an empty list is undefined; guard with IsSet");let o=0;for(let s of r)o+=ue(s,"Average");return o/r.length}case"for-each":{let r=await this.evaluateList(e.source,t),o=[];for(let s of r){let a=new Map(t);a.set(e.loopVar,s);let i=await this.evaluate(e.emit,a);if(i!=null)if(Array.isArray(i))for(let c of i)o.push(c);else o.push(i)}return o}case"list-map":{let r=await this.evaluateList(e.source,t),o=[];for(let s of r){let a=new Map(t);a.set(e.loopVar,s),o.push(await this.evaluate(e.mapBody,a))}return o}case"filter":{let r=await this.evaluateList(e.source,t),o=[];for(let s of r){let a=new Map(t);a.set(e.loopVar,s),await this.evaluate(e.predicate,a)===!0&&o.push(s)}return o}case"partition-by":{let r=await this.evaluateList(e.source,t),o=new Map,s=[];for(let a of r){let i=new Map(t);i.set(e.loopVar,a);let c=await this.evaluate(e.partitionKey,i),l=Kt(c),u=o.get(l);u||(u={kind:"Partition",key:c,members:[]},o.set(l,u),s.push(l)),u.members.push(a)}return s.map(a=>o.get(a))}case"distinct-by":{let r=await this.evaluateList(e.source,t),o=new Set,s=[];for(let a of r){let i=new Map(t);i.set(e.loopVar,a);let c=await this.evaluate(e.distinctKey,i),l=Kt(c);o.has(l)||(o.add(l),s.push(a))}return s}default:{let r=e;throw new z("Unknown expression kind")}}}async evaluateList(e,t){let r=await this.evaluate(e,t);return r==null?[]:Array.isArray(r)?r:[r]}};function vt(n,e){if(n instanceof xe)return Ya(n,e);if(Qa(n))return T(e,f.key)?n.key:T(e,f.members)?n.members:void 0}function Ya(n,e){for(let t of n.statement){let r=Et(t);if(!(!r||!T(r,e))&&(t instanceof Wa||t instanceof Ga||t instanceof Xa||t instanceof Dt||t instanceof Ja||t instanceof Ct))return t.object}}function Za(n,e){let t=[];for(let r of n.statement){let o=Et(r);if(!(!o||!T(o,e))){if(r instanceof Dt)t.push(r.object.subject);else if(r instanceof Ct)for(let s of r.object)s instanceof de&&t.push(s.subject)}}return t}function Et(n){return n.predicate?.subject}function ln(n){return n==null?"":typeof n=="string"?n:typeof n=="number"||typeof n=="boolean"?String(n):n instanceof xe?n.name??"":n instanceof de?n.subject.name:je(n)?n.name:""}function Pt(n){return n==null?!1:typeof n=="string"||Array.isArray(n)?n.length>0:typeof n=="boolean"?n===!0:!0}function je(n){return typeof n=="object"&&n!==null&&typeof n.publisher=="string"&&typeof n.package_=="string"&&typeof n.name=="string"}function Qa(n){return typeof n=="object"&&n!==null&&n.kind==="Partition"&&Array.isArray(n.members)}function ue(n,e){if(typeof n=="number"&&Number.isFinite(n))return n;throw new z(`${e} requires numeric elements; got ${ts(n)}`)}var es=new Set(["stringValue","text","rawContent","key"]);function ns(n){return typeof n=="string"||typeof n=="number"||typeof n=="boolean"}function ts(n){return n===void 0?"undefined":n===null?"null":Array.isArray(n)?`array(${n.length})`:typeof n}function Kt(n){if(n===void 0)return"\0undef";if(n===null)return"\0null";if(typeof n=="string")return`s:${n}`;if(typeof n=="number")return`n:${n}`;if(typeof n=="boolean")return`b:${n}`;if(n instanceof de){let e=n.subject;return`r:${e.publisher}/${e.package_}/${e.name}`}if(n instanceof xe){let e=n.name??"";return`k:${n.namespace??""}/${e}`}return je(n)?`u:${n.publisher}/${n.package_}/${n.name}`:`o:${JSON.stringify(n)}`}var Ue={"markdown-with-frontmatter":{formatUri:"kanonak.org/transformations/markdown-with-frontmatter",extension:".md"},"plain-markdown":{formatUri:"kanonak.org/transformations/plain-markdown",extension:".md"},toml:{formatUri:"kanonak.org/transformations/toml",extension:".toml"},json:{formatUri:"kanonak.org/transformations/json",extension:".json"},html:{formatUri:"kanonak.org/transformations/html",extension:".html"},svg:{formatUri:"kanonak.org/transformations/svg",extension:".svg"}},W=class extends Error{},G=class{backends=new Map;constructor(){this.register(new De),this.register(new Ce),this.register(new Ee),this.register(new Ae),this.register(new Re)}register(e){this.backends.set(e.backendUri,e)}async run(e){let t=e.transformationKanonaks??e.allKanonaks,r=le(e.transformation,t);if(!r.outputs.has(e.outputFormat))throw new W(`Transformation "${r.name}" does not declare output format "${e.outputFormat}". Declared: ${Array.from(r.outputs).join(", ")}`);let o=this.findBackend(e.outputFormat);if(!o)throw new W(`No backend registered for OutputFormat "${e.outputFormat}".`);let s=new Ie(e.repository,e.parser,e.objectParser),a=new Te(s,e.allKanonaks);return r.kind==="instance"?this.runInstance(r,e,o,a):this.runSet(r,e,o,a)}async runInstance(e,t,r,o){let s=At(t.instances,e.inputPattern.requires),a=Rt(s,e.inputPattern.sortBy),i=[];for(let c of a){let l=new Map;l.set("input",c);let u=await o.evaluate(e.rule,l);un(u,e.name,`input "${c.name}"`);let d=dn(await o.evaluate(e.artifactName,l),e.name,`input "${c.name}"`),p=e.overrides.get(t.outputFormat),g=r.render(u,p);i.push({fileName:d,format:t.outputFormat,content:g,source:{kind:"instance",sourceName:c.name}})}return i}async runSet(e,t,r,o){let s=At(t.instances,e.inputPattern.requires),a=Rt(s,e.inputPattern.sortBy);return e.partitionBy?this.runSetWithPartition(e,a,t,r,o):this.runSetSingle(e,a,t,r,o)}async runSetSingle(e,t,r,o,s){let a=new Map;a.set("inputs",t);let i=await s.evaluate(e.rule,a);un(i,e.name,"set");let c=dn(await s.evaluate(e.artifactName,a),e.name,"set"),l=e.overrides.get(r.outputFormat),u=o.render(i,l);return[{fileName:c,format:r.outputFormat,content:u,source:{kind:"set",memberCount:t.length}}]}async runSetWithPartition(e,t,r,o,s){let a=e.partitionBy,i=new Map,c=[];for(let u of t){let d=as(u,a);if(d==null)continue;let p=ss(d),g=i.get(p);g||(g={keyValue:d,keyDisplay:is(d),members:[]},i.set(p,g),c.push(p)),g.members.push(u)}let l=[];for(let u of c){let d=i.get(u),p=new Map;p.set("inputs",d.members),p.set("key",d.keyValue);let g=await s.evaluate(e.rule,p);un(g,e.name,`partition "${d.keyDisplay}"`);let b=dn(await s.evaluate(e.artifactName,p),e.name,`partition "${d.keyDisplay}"`),k=e.overrides.get(r.outputFormat),y=o.render(g,k);l.push({fileName:b,format:r.outputFormat,content:y,source:{kind:"set",memberCount:d.members.length,partitionKey:d.keyDisplay}})}return l}findBackend(e){let t=Ue[e];if(t)return this.backends.get(t.formatUri)}};function At(n,e){return e.length===0?n:n.filter(t=>{for(let r of e)if(!os(t,r))return!1;return!0})}function Rt(n,e){if(e.length===0)return n;let t=[...n];return t.sort((r,o)=>{for(let s of e){let a=It(r,s.byProperty),i=It(o,s.byProperty),c=rs(a,i,s.order);if(c!==0)return c}return 0}),t}function It(n,e){for(let t of n.statement){let r=fn(t);if(!(!r||!T(r,e))){if(t instanceof jt||t instanceof xt||t instanceof Ut)return t.object;if(t instanceof Lt)throw new W(`Sort property "${e.name}" on instance "${n.name??"?"}" resolves to a list \u2014 list-typed properties are not sortable. Use a scalar property.`);if(t instanceof Ot)throw new W(`Sort property "${e.name}" on instance "${n.name??"?"}" resolves to a reference \u2014 reference-typed properties don't have a natural total order. Use a scalar property.`)}}}function rs(n,e,t){if(n===void 0&&e===void 0)return 0;if(n===void 0)return t==="ascending"?1:-1;if(e===void 0)return t==="ascending"?-1:1;let r;return typeof n=="number"&&typeof e=="number"?r=n-e:r=String(n).localeCompare(String(e)),t==="ascending"?r:-r}function os(n,e){for(let t of n.statement){let r=fn(t);if(!r||!T(r,e))continue;let o=t.object;if(o!=null&&!(typeof o=="string"&&o.length===0)&&!(Array.isArray(o)&&o.length===0))return!0}return!1}function as(n,e){for(let t of n.statement){let r=fn(t);if(!(!r||!T(r,e))&&(t instanceof jt||t instanceof xt||t instanceof Ut||t instanceof Ot||t instanceof Lt))return t.object}}function fn(n){return n.predicate?.subject}function ss(n){if(n===void 0)return" undef";if(n===null)return" null";if(typeof n=="string")return`s:${n}`;if(typeof n=="number")return`n:${n}`;if(typeof n=="boolean")return`b:${n}`;if(n instanceof Tt){let e=n.subject;return`r:${e.publisher}/${e.package_}/${e.name}`}if(n instanceof _t){let e=n.name??"";return`k:${n.namespace??""}/${e}`}if(typeof n=="object"&&n!==null&&typeof n.name=="string"&&typeof n.publisher=="string"){let e=n;return`u:${e.publisher}/${e.package_}/${e.name}`}return`o:${JSON.stringify(n)}`}function is(n){return n==null?"":typeof n=="string"?n:typeof n=="number"||typeof n=="boolean"?String(n):n instanceof Tt?n.subject.name:n instanceof _t?n.name??"":typeof n=="object"&&n!==null&&typeof n.name=="string"?n.name:""}function un(n,e,t){if(typeof n!="object"||n===null||n.kind!=="Document")throw new W(`Transformation "${e}" rule did not yield a Document for ${t}. Got: ${Nt(n)}`)}function dn(n,e,t){if(typeof n=="string")return n;if(Array.isArray(n)&&n.every(cs))return n.map(r=>String(r)).join("");throw new W(`Transformation "${e}" artifactName did not yield a string for ${t}. Got: ${Nt(n)}`)}function cs(n){return typeof n=="string"||typeof n=="number"||typeof n=="boolean"}function Nt(n){if(n===void 0)return"undefined";if(n===null)return"null";if(Array.isArray(n))return`array(${n.length})`;if(typeof n=="object"){let e=n.kind;return e?`object(kind=${e})`:"object"}return typeof n}function mn(n){return[...A(n,f.InstanceTransformation),...A(n,f.SetTransformation)]}function Ht(){let n=new we("transform").description("Run ontology-driven transformations against Kanonak packages. Transformations are declarative YAML rules (instances of `kanonak.org/transformations/Transformation`) that convert ontology instances into output files. The runner produces one or more Artifacts per matched input; format backends serialize them to Markdown, HTML, SVG, TOML, JSON, or (with post-processing) PDF.").addHelpText("after",`
+`),o}return'<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"/>'}};import{SubjectKanonak as ut}from"@kanonak-protocol/sdk";var Ie=class{constructor(e,t,r){this.repository=e;this.parser=t;this.objectParser=r}repository;parser;objectParser;cache=new Map;async resolveSubject(e,t){let r=Pe(t,e);if(r)return r;let o=`${e.publisher}/${e.package_}`,s=this.cache.get(o);if(!s){let a=await this.repository.getDocumentsByNamespaceAsync(e.publisher,e.package_);if(a.length===0)return;let i=a[0],c=new C(i,this.repository);s=await this.objectParser.parseKanonaks(c),this.cache.set(o,s)}for(let a of s)if(a instanceof ut&&a.name===e.name&&a.namespace&&a.namespace.startsWith(`${e.publisher}/${e.package_}@`))return a;for(let a of s)if(a instanceof ut&&a.name===e.name)return a}};import{EmbeddedKanonak as he,ReferenceKanonak as kt,SubjectKanonak as Ia,ListStatement as H,ReferenceStatement as sn,EmbeddedStatement as ce,StringStatement as yt,NumberStatement as _a,BooleanStatement as Ta}from"@kanonak-protocol/sdk";var E=class extends Error{constructor(t,r){super(`${t} (at ${r})`);this.path=r}path},dt=16;function le(n,e){let t=n.name,r={catalog:e,depth:0};if(P(n,f.InstanceTransformation))return ja(n,t,r);if(P(n,f.SetTransformation))return xa(n,t,r);throw new E("Subject is not a recognized v3 transformation type \u2014 expected InstanceTransformation or SetTransformation",t)}function ja(n,e,t){return{kind:"instance",name:n.name,inputPattern:ht(n,e),rule:_e(n,f.rule,`${e}.rule`,t),artifactName:_e(n,f.artifactName,`${e}.artifactName`,t),outputs:bt(n,`${e}.outputs`),overrides:wt(n,`${e}.formatOverrides`,t)}}function xa(n,e,t){let r=q(n,f.partitionBy);return{kind:"set",name:n.name,inputPattern:ht(n,e),rule:_e(n,f.rule,`${e}.rule`,t),artifactName:_e(n,f.artifactName,`${e}.artifactName`,t),outputs:bt(n,`${e}.outputs`),overrides:wt(n,`${e}.formatOverrides`,t),partitionBy:r}}function ht(n,e){let t=be(n,f.inputPattern);if(!t)throw new E("inputPattern is required",e);return Ua(t,`${e}.inputPattern`)}function Ua(n,e){let t=q(n,f.matchesClass);if(!t)throw new E("matchesClass is required",e);let r=[];for(let a of x(n,f.requires))if(a instanceof sn)r.push(an(a.object.subject));else if(a instanceof H)for(let i of a.object)i instanceof kt&&r.push(an(i.subject));let o=[],s=0;for(let a of x(n,f.sortBy))if(a instanceof H)for(let i of a.object)i instanceof he&&o.push(ft(i,`${e}.sortBy[${s++}]`));else a instanceof ce&&o.push(ft(a.object,`${e}.sortBy[${s++}]`));return{matchesClass:t,requires:r,sortBy:o}}function ft(n,e){let t=q(n,f.byProperty);if(!t)throw new E("SortKey.byProperty is required",e);let r=q(n,f.order);if(!r)throw new E("SortKey.order is required",e);if(T(r,f.ascending))return{byProperty:t,order:"ascending"};if(T(r,f.descending))return{byProperty:t,order:"descending"};throw new E(`SortKey.order must reference tx.ascending or tx.descending; got ${r.publisher}/${r.package_}/${r.name}`,e)}function _e(n,e,t,r){let o=be(n,e);if(!o)throw new E("expression is required",t);return ie(o,t,r)}function ie(n,e,t){if(P(n,f.StringLiteral))return{kind:"string-literal",value:M(n,f.stringLiteral,e)};if(P(n,f.IntegerLiteral))return{kind:"integer-literal",value:gt(n,f.integerLiteral,e)};if(P(n,f.DecimalLiteral))return{kind:"decimal-literal",value:gt(n,f.decimalLiteral,e)};if(P(n,f.BooleanLiteral))return{kind:"boolean-literal",value:qa(n,f.booleanLiteral,e)};if(P(n,f.VarRef))return{kind:"var-ref",varName:M(n,f.varName,e)};if(P(n,f.PropertyRead))return{kind:"property-read",source:D(n,f.readSource,`${e}.readSource`,t),readProp:X(n,f.readProp,e,"readProp")};if(P(n,f.Traverse))return{kind:"traverse",source:D(n,f.traverseSource,`${e}.traverseSource`,t),through:X(n,f.through,e,"through"),step:D(n,f.step,`${e}.step`,t)};if(P(n,f.BuildAstNode))return{kind:"build-ast-node",astClass:X(n,f.astClass,e,"astClass"),set:Na(n,`${e}.set`,t)};if(P(n,f.When))return{kind:"when",condition:D(n,f.condition,`${e}.condition`,t),thenBuild:D(n,f.thenBuild,`${e}.thenBuild`,t),elseBuild:Oa(n,f.elseBuild,`${e}.elseBuild`,t)};if(P(n,f.Concat))return{kind:"concat",parts:La(n,f.parts,`${e}.parts`,t)};if(P(n,f.Fallback))return{kind:"fallback",primary:D(n,f.primary,`${e}.primary`,t),alternate:D(n,f.alternate,`${e}.alternate`,t)};if(P(n,f.UriName))return{kind:"uri-name",source:D(n,f.uriNameOf,`${e}.uriNameOf`,t)};if(P(n,f.SubjectUri))return{kind:"subject-uri",source:D(n,f.subjectOf,`${e}.subjectOf`,t)};if(P(n,f.UriLiteral))return{kind:"uri-literal",refTo:X(n,f.refTo,e,"refTo")};if(P(n,f.DisplayLabel))return{kind:"display-label",labelTarget:X(n,f.labelTarget,e,"labelTarget"),labelSource:X(n,f.labelSource,e,"labelSource")};if(P(n,f.ResolveRef))return{kind:"resolve-ref",source:D(n,f.resolveSource,`${e}.resolveSource`,t)};if(P(n,f.Normalize))return{kind:"normalize",source:D(n,f.normSource,`${e}.normSource`,t),normKind:Fa(n,e)};if(P(n,f.IsSet))return{kind:"is-set",check:D(n,f.checkExpr,`${e}.checkExpr`,t)};if(P(n,f.CallFragment))return Va(n,e,t);if(P(n,f.Join))return{kind:"join",source:D(n,f.source,`${e}.source`,t),separator:M(n,f.separator,e)};if(P(n,f.Count))return{kind:"count",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.Sum))return{kind:"sum",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.Min))return{kind:"min",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.Max))return{kind:"max",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.Average))return{kind:"average",source:D(n,f.source,`${e}.source`,t)};if(P(n,f.ForEach))return{kind:"for-each",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),emit:D(n,f.emit,`${e}.emit`,t)};if(P(n,f.ListMap))return{kind:"list-map",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),mapBody:D(n,f.mapBody,`${e}.mapBody`,t)};if(P(n,f.Filter))return{kind:"filter",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),predicate:D(n,f.predicate,`${e}.predicate`,t)};if(P(n,f.PartitionBy))return{kind:"partition-by",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),partitionKey:D(n,f.partitionKey,`${e}.partitionKey`,t)};if(P(n,f.DistinctBy))return{kind:"distinct-by",source:D(n,f.source,`${e}.source`,t),loopVar:M(n,f.loopVar,e),distinctKey:D(n,f.distinctKey,`${e}.distinctKey`,t)};throw new E("Expression is not of a recognized v3 type \u2014 embedded has no matching subclass of tx.Expression",e)}function D(n,e,t,r){let o=be(n,e);if(!o)throw new E("child expression is required",t);return ie(o,t,r)}function Oa(n,e,t,r){let o=be(n,e);if(o)return ie(o,t,r)}function La(n,e,t,r){let o=[],s=0;for(let a of x(n,e))if(a instanceof H)for(let i of a.object)i instanceof he&&o.push(ie(i,`${t}[${s++}]`,r));else a instanceof ce&&o.push(ie(a.object,`${t}[${s++}]`,r));return o}function Na(n,e,t){let r=[],o=0;for(let s of x(n,f.set))if(s instanceof H)for(let a of s.object)a instanceof he&&r.push(mt(a,`${e}[${o++}]`,t));else s instanceof ce&&r.push(mt(s.object,`${e}[${o++}]`,t));return r}function mt(n,e,t){return{field:X(n,f.field,e,"field"),value:D(n,f.bindValue,`${e}.bindValue`,t)}}function Fa(n,e){let t=q(n,f.normKind);if(!t)throw new E("normKind is required",e);if(T(t,f.NORM_TRIM_END))return"trim-end";throw new E(`Unknown NormalizeKind: ${t.publisher}/${t.package_}/${t.name}`,e)}function Va(n,e,t){if(t.depth>=dt)throw new E(`Fragment recursion exceeded MAX_FRAGMENT_DEPTH (${dt})`,e);let r=q(n,f.fragmentRef);if(!r)throw new E("fragmentRef is required",e);let o=Ba(t.catalog,r);if(!o)throw new E(`ExpressionFragment not found: ${r.publisher}/${r.package_}/${r.name}`,e);let s=be(o,f.body);if(!s)throw new E(`ExpressionFragment ${r.name} has no body`,e);return{kind:"call-fragment",body:ie(s,`${e}.fragment(${r.name})`,{catalog:t.catalog,depth:t.depth+1})}}function Ba(n,e){for(let t of n)if(!(!(t instanceof Ia)||t.name!==e.name||!(t.namespace||"").startsWith(`${e.publisher}/${e.package_}@`))&&P(t,f.ExpressionFragment))return t}function bt(n,e){let t=new Set;for(let r of x(n,f.outputs))if(r instanceof sn)t.add(r.object.subject.name);else if(r instanceof H)for(let o of r.object)o instanceof kt&&t.add(o.subject.name);if(t.size===0)throw new E("outputs is required (at least one OutputFormat)",e);return t}function wt(n,e,t){let r=new Map,o=0;for(let s of x(n,f.formatOverrides))if(s instanceof H){for(let a of s.object)if(a instanceof he){let[i,c]=pt(a,`${e}[${o++}]`);r.set(i,c)}}else if(s instanceof ce){let[a,i]=pt(s.object,`${e}[${o++}]`);r.set(a,i)}return r}function pt(n,e){let t=q(n,f.formatTarget);if(!t)throw new E("formatTarget is required",e);let r=[];for(let a of x(n,f.metadataKeys))if(a instanceof yt)r.push(a.object);else if(a instanceof H)for(let i of a.object){let c=i.value;typeof c=="string"&&r.push(c)}let o=new Map;for(let a of x(n,f.metadataRenames))if(a instanceof H){for(let i of a.object)if(i instanceof he){let c=ye(i,f.fromKey),l=ye(i,f.toKey);c&&l&&o.set(c,l)}}else if(a instanceof ce){let i=a.object,c=ye(i,f.fromKey),l=ye(i,f.toKey);c&&l&&o.set(c,l)}let s=$t(n,f.trailingNewline);return[t.name,{metadataKeys:r.length>0?r:void 0,metadataRenames:o,trailingNewline:s}]}function Ma(n){return n.predicate?.subject}function x(n,e){let t=[];for(let r of n.statement){let o=Ma(r);o&&T(o,e)&&t.push(r)}return t}function be(n,e){for(let t of x(n,e))if(t instanceof ce)return t.object}function q(n,e){for(let t of x(n,e))if(t instanceof sn)return an(t.object.subject)}function ye(n,e){for(let t of x(n,e))if(t instanceof yt)return t.object}function Ha(n,e){for(let t of x(n,e))if(t instanceof _a)return t.object}function $t(n,e){for(let t of x(n,e))if(t instanceof Ta)return t.object}function M(n,e,t){let r=ye(n,e);if(r===void 0)throw new E(`${e.name} (string) is required`,t);return r}function gt(n,e,t){let r=Ha(n,e);if(r===void 0)throw new E(`${e.name} (number) is required`,t);return r}function qa(n,e,t){let r=$t(n,e);if(r===void 0)throw new E(`${e.name} (boolean) is required`,t);return r}function X(n,e,t,r){let o=q(n,e);if(!o)throw new E(`${r} (URI reference) is required`,t);return o}function an(n){return{publisher:n.publisher,package_:n.package_,name:n.name}}import{DefinedKanonak as xe,EmbeddedKanonak as za,ReferenceKanonak as de,SubjectKanonak as St,StringStatement as Wa,NumberStatement as Ga,BooleanStatement as Xa,ReferenceStatement as Dt,EmbeddedStatement as Ja,ListStatement as Ct}from"@kanonak-protocol/sdk";var z=class extends Error{},Te=class{constructor(e,t){this.resolver=e;this.catalog=t}resolver;catalog;async evaluate(e,t){switch(e.kind){case"string-literal":return e.value;case"integer-literal":return e.value;case"decimal-literal":return e.value;case"boolean-literal":return e.value;case"uri-literal":return{...e.refTo};case"var-ref":{if(!t.has(e.varName))throw new z(`Unbound variable "${e.varName}"`);return t.get(e.varName)}case"concat":{let r=[];for(let o of e.parts){let s=await this.evaluate(o,t);if(s!=null)if(Array.isArray(s))for(let a of s)r.push(a);else r.push(s)}return r}case"fallback":{let r=await this.evaluate(e.primary,t);return Pt(r)?r:this.evaluate(e.alternate,t)}case"when":return await this.evaluate(e.condition,t)===!0?this.evaluate(e.thenBuild,t):e.elseBuild?this.evaluate(e.elseBuild,t):void 0;case"is-set":{let r=await this.evaluate(e.check,t);return Pt(r)}case"property-read":{let r=await this.evaluate(e.source,t);return vt(r,e.readProp)}case"traverse":{let r=await this.evaluate(e.source,t);if(!(r instanceof xe))return;let o=Za(r,e.through),s=[];for(let a of o){let i=await this.resolver.resolveSubject(a,this.catalog);if(!i)continue;let c=new Map(t);c.set("input",i);let l=await this.evaluate(e.step,c);l!=null&&s.push(cn(l))}return s.join("")}case"uri-name":{let r=await this.evaluate(e.source,t);return je(r)?r.name:r instanceof de?r.subject.name:r instanceof St?r.name:r instanceof za?r.name??"":void 0}case"subject-uri":{let r=await this.evaluate(e.source,t);if(r instanceof St){let o=r.namespace??"",s=r.name??"";return!o||!s?void 0:`${o}/${s}`}if(r instanceof de){let o=r.subject,s=o.version;return s&&typeof s.major=="number"?`${o.publisher}/${o.package_}@${s.major}.${s.minor}.${s.patch}/${o.name}`:`${o.publisher}/${o.package_}/${o.name}`}return}case"display-label":{let r=await this.resolver.resolveSubject({...e.labelTarget},this.catalog);return r?vt(r,e.labelSource):void 0}case"resolve-ref":{let r=await this.evaluate(e.source,t);return r instanceof de?await this.resolver.resolveSubject(r.subject,this.catalog):je(r)?await this.resolver.resolveSubject(r,this.catalog):void 0}case"normalize":{let r=await this.evaluate(e.source,t),o=r==null?"":cn(r);return e.normKind==="trim-end"?o.replace(/[\s\r\n]+$/u,""):o}case"build-ast-node":{let r={kind:e.astClass.name};for(let o of e.set){let s=await this.evaluate(o.value,t);if(s==null||Array.isArray(s)&&s.length===0)continue;let a=o.field.name;Array.isArray(s)&&es.has(a)&&s.every(i=>ns(i))&&(s=s.map(i=>String(i)).join("")),r[a]=s}return r}case"call-fragment":return this.evaluate(e.body,t);case"join":return(await this.evaluateList(e.source,t)).map(o=>o==null?"":cn(o)).join(e.separator);case"count":return(await this.evaluateList(e.source,t)).length;case"sum":{let r=await this.evaluateList(e.source,t),o=0;for(let s of r)o+=ue(s,"Sum");return o}case"min":{let r=await this.evaluateList(e.source,t);if(r.length===0)throw new z("Min on an empty list is undefined; guard with IsSet");let o=ue(r[0],"Min");for(let s=1;s<r.length;s++){let a=ue(r[s],"Min");a<o&&(o=a)}return o}case"max":{let r=await this.evaluateList(e.source,t);if(r.length===0)throw new z("Max on an empty list is undefined; guard with IsSet");let o=ue(r[0],"Max");for(let s=1;s<r.length;s++){let a=ue(r[s],"Max");a>o&&(o=a)}return o}case"average":{let r=await this.evaluateList(e.source,t);if(r.length===0)throw new z("Average on an empty list is undefined; guard with IsSet");let o=0;for(let s of r)o+=ue(s,"Average");return o/r.length}case"for-each":{let r=await this.evaluateList(e.source,t),o=[];for(let s of r){let a=new Map(t);a.set(e.loopVar,s);let i=await this.evaluate(e.emit,a);if(i!=null)if(Array.isArray(i))for(let c of i)o.push(c);else o.push(i)}return o}case"list-map":{let r=await this.evaluateList(e.source,t),o=[];for(let s of r){let a=new Map(t);a.set(e.loopVar,s),o.push(await this.evaluate(e.mapBody,a))}return o}case"filter":{let r=await this.evaluateList(e.source,t),o=[];for(let s of r){let a=new Map(t);a.set(e.loopVar,s),await this.evaluate(e.predicate,a)===!0&&o.push(s)}return o}case"partition-by":{let r=await this.evaluateList(e.source,t),o=new Map,s=[];for(let a of r){let i=new Map(t);i.set(e.loopVar,a);let c=await this.evaluate(e.partitionKey,i),l=Kt(c),u=o.get(l);u||(u={kind:"Partition",key:c,members:[]},o.set(l,u),s.push(l)),u.members.push(a)}return s.map(a=>o.get(a))}case"distinct-by":{let r=await this.evaluateList(e.source,t),o=new Set,s=[];for(let a of r){let i=new Map(t);i.set(e.loopVar,a);let c=await this.evaluate(e.distinctKey,i),l=Kt(c);o.has(l)||(o.add(l),s.push(a))}return s}default:{let r=e;throw new z("Unknown expression kind")}}}async evaluateList(e,t){let r=await this.evaluate(e,t);return r==null?[]:Array.isArray(r)?r:[r]}};function vt(n,e){if(n instanceof xe)return Ya(n,e);if(Qa(n))return T(e,f.key)?n.key:T(e,f.members)?n.members:void 0}function Ya(n,e){for(let t of n.statement){let r=Et(t);if(!(!r||!T(r,e))&&(t instanceof Wa||t instanceof Ga||t instanceof Xa||t instanceof Dt||t instanceof Ja||t instanceof Ct))return t.object}}function Za(n,e){let t=[];for(let r of n.statement){let o=Et(r);if(!(!o||!T(o,e))){if(r instanceof Dt)t.push(r.object.subject);else if(r instanceof Ct)for(let s of r.object)s instanceof de&&t.push(s.subject)}}return t}function Et(n){return n.predicate?.subject}function cn(n){return n==null?"":typeof n=="string"?n:typeof n=="number"||typeof n=="boolean"?String(n):n instanceof xe?n.name??"":n instanceof de?n.subject.name:je(n)?n.name:""}function Pt(n){return n==null?!1:typeof n=="string"||Array.isArray(n)?n.length>0:typeof n=="boolean"?n===!0:!0}function je(n){return typeof n=="object"&&n!==null&&typeof n.publisher=="string"&&typeof n.package_=="string"&&typeof n.name=="string"}function Qa(n){return typeof n=="object"&&n!==null&&n.kind==="Partition"&&Array.isArray(n.members)}function ue(n,e){if(typeof n=="number"&&Number.isFinite(n))return n;throw new z(`${e} requires numeric elements; got ${ts(n)}`)}var es=new Set(["stringValue","text","rawContent","key"]);function ns(n){return typeof n=="string"||typeof n=="number"||typeof n=="boolean"}function ts(n){return n===void 0?"undefined":n===null?"null":Array.isArray(n)?`array(${n.length})`:typeof n}function Kt(n){if(n===void 0)return"\0undef";if(n===null)return"\0null";if(typeof n=="string")return`s:${n}`;if(typeof n=="number")return`n:${n}`;if(typeof n=="boolean")return`b:${n}`;if(n instanceof de){let e=n.subject;return`r:${e.publisher}/${e.package_}/${e.name}`}if(n instanceof xe){let e=n.name??"";return`k:${n.namespace??""}/${e}`}return je(n)?`u:${n.publisher}/${n.package_}/${n.name}`:`o:${JSON.stringify(n)}`}var Ue={"markdown-with-frontmatter":{formatUri:"kanonak.org/transformations/markdown-with-frontmatter",extension:".md"},"plain-markdown":{formatUri:"kanonak.org/transformations/plain-markdown",extension:".md"},toml:{formatUri:"kanonak.org/transformations/toml",extension:".toml"},json:{formatUri:"kanonak.org/transformations/json",extension:".json"},html:{formatUri:"kanonak.org/transformations/html",extension:".html"},svg:{formatUri:"kanonak.org/transformations/svg",extension:".svg"}},W=class extends Error{},G=class{backends=new Map;constructor(){this.register(new De),this.register(new Ce),this.register(new Ee),this.register(new Ae),this.register(new Re)}register(e){this.backends.set(e.backendUri,e)}async run(e){let t=e.transformationKanonaks??e.allKanonaks,r=le(e.transformation,t);if(!r.outputs.has(e.outputFormat))throw new W(`Transformation "${r.name}" does not declare output format "${e.outputFormat}". Declared: ${Array.from(r.outputs).join(", ")}`);let o=this.findBackend(e.outputFormat);if(!o)throw new W(`No backend registered for OutputFormat "${e.outputFormat}".`);let s=new Ie(e.repository,e.parser,e.objectParser),a=new Te(s,e.allKanonaks);return r.kind==="instance"?this.runInstance(r,e,o,a):this.runSet(r,e,o,a)}async runInstance(e,t,r,o){let s=At(t.instances,e.inputPattern.requires),a=Rt(s,e.inputPattern.sortBy),i=[];for(let c of a){let l=new Map;l.set("input",c);let u=await o.evaluate(e.rule,l);ln(u,e.name,`input "${c.name}"`);let d=un(await o.evaluate(e.artifactName,l),e.name,`input "${c.name}"`),p=e.overrides.get(t.outputFormat),g=r.render(u,p);i.push({fileName:d,format:t.outputFormat,content:g,source:{kind:"instance",sourceName:c.name}})}return i}async runSet(e,t,r,o){let s=At(t.instances,e.inputPattern.requires),a=Rt(s,e.inputPattern.sortBy);return e.partitionBy?this.runSetWithPartition(e,a,t,r,o):this.runSetSingle(e,a,t,r,o)}async runSetSingle(e,t,r,o,s){let a=new Map;a.set("inputs",t);let i=await s.evaluate(e.rule,a);ln(i,e.name,"set");let c=un(await s.evaluate(e.artifactName,a),e.name,"set"),l=e.overrides.get(r.outputFormat),u=o.render(i,l);return[{fileName:c,format:r.outputFormat,content:u,source:{kind:"set",memberCount:t.length}}]}async runSetWithPartition(e,t,r,o,s){let a=e.partitionBy,i=new Map,c=[];for(let u of t){let d=as(u,a);if(d==null)continue;let p=ss(d),g=i.get(p);g||(g={keyValue:d,keyDisplay:is(d),members:[]},i.set(p,g),c.push(p)),g.members.push(u)}let l=[];for(let u of c){let d=i.get(u),p=new Map;p.set("inputs",d.members),p.set("key",d.keyValue);let g=await s.evaluate(e.rule,p);ln(g,e.name,`partition "${d.keyDisplay}"`);let b=un(await s.evaluate(e.artifactName,p),e.name,`partition "${d.keyDisplay}"`),k=e.overrides.get(r.outputFormat),y=o.render(g,k);l.push({fileName:b,format:r.outputFormat,content:y,source:{kind:"set",memberCount:d.members.length,partitionKey:d.keyDisplay}})}return l}findBackend(e){let t=Ue[e];if(t)return this.backends.get(t.formatUri)}};function At(n,e){return e.length===0?n:n.filter(t=>{for(let r of e)if(!os(t,r))return!1;return!0})}function Rt(n,e){if(e.length===0)return n;let t=[...n];return t.sort((r,o)=>{for(let s of e){let a=It(r,s.byProperty),i=It(o,s.byProperty),c=rs(a,i,s.order);if(c!==0)return c}return 0}),t}function It(n,e){for(let t of n.statement){let r=dn(t);if(!(!r||!T(r,e))){if(t instanceof jt||t instanceof xt||t instanceof Ut)return t.object;if(t instanceof Lt)throw new W(`Sort property "${e.name}" on instance "${n.name??"?"}" resolves to a list \u2014 list-typed properties are not sortable. Use a scalar property.`);if(t instanceof Ot)throw new W(`Sort property "${e.name}" on instance "${n.name??"?"}" resolves to a reference \u2014 reference-typed properties don't have a natural total order. Use a scalar property.`)}}}function rs(n,e,t){if(n===void 0&&e===void 0)return 0;if(n===void 0)return t==="ascending"?1:-1;if(e===void 0)return t==="ascending"?-1:1;let r;return typeof n=="number"&&typeof e=="number"?r=n-e:r=String(n).localeCompare(String(e)),t==="ascending"?r:-r}function os(n,e){for(let t of n.statement){let r=dn(t);if(!r||!T(r,e))continue;let o=t.object;if(o!=null&&!(typeof o=="string"&&o.length===0)&&!(Array.isArray(o)&&o.length===0))return!0}return!1}function as(n,e){for(let t of n.statement){let r=dn(t);if(!(!r||!T(r,e))&&(t instanceof jt||t instanceof xt||t instanceof Ut||t instanceof Ot||t instanceof Lt))return t.object}}function dn(n){return n.predicate?.subject}function ss(n){if(n===void 0)return" undef";if(n===null)return" null";if(typeof n=="string")return`s:${n}`;if(typeof n=="number")return`n:${n}`;if(typeof n=="boolean")return`b:${n}`;if(n instanceof Tt){let e=n.subject;return`r:${e.publisher}/${e.package_}/${e.name}`}if(n instanceof _t){let e=n.name??"";return`k:${n.namespace??""}/${e}`}if(typeof n=="object"&&n!==null&&typeof n.name=="string"&&typeof n.publisher=="string"){let e=n;return`u:${e.publisher}/${e.package_}/${e.name}`}return`o:${JSON.stringify(n)}`}function is(n){return n==null?"":typeof n=="string"?n:typeof n=="number"||typeof n=="boolean"?String(n):n instanceof Tt?n.subject.name:n instanceof _t?n.name??"":typeof n=="object"&&n!==null&&typeof n.name=="string"?n.name:""}function ln(n,e,t){if(typeof n!="object"||n===null||n.kind!=="Document")throw new W(`Transformation "${e}" rule did not yield a Document for ${t}. Got: ${Nt(n)}`)}function un(n,e,t){if(typeof n=="string")return n;if(Array.isArray(n)&&n.every(cs))return n.map(r=>String(r)).join("");throw new W(`Transformation "${e}" artifactName did not yield a string for ${t}. Got: ${Nt(n)}`)}function cs(n){return typeof n=="string"||typeof n=="number"||typeof n=="boolean"}function Nt(n){if(n===void 0)return"undefined";if(n===null)return"null";if(Array.isArray(n))return`array(${n.length})`;if(typeof n=="object"){let e=n.kind;return e?`object(kind=${e})`:"object"}return typeof n}function fn(n){return[...A(n,f.InstanceTransformation),...A(n,f.SetTransformation)]}function Ht(){let n=new we("transform").description("Run ontology-driven transformations against Kanonak packages. Transformations are declarative YAML rules (instances of `kanonak.org/transformations/Transformation`) that convert ontology instances into output files. The runner produces one or more Artifacts per matched input; format backends serialize them to Markdown, HTML, SVG, TOML, JSON, or (with post-processing) PDF.").addHelpText("after",`
 Examples:
 
   # List every Transformation available in the local workspace
@@ -166,14 +166,14 @@ Examples:
 
   # List the registered format backends
   $ kanonak transform formats
-`);return n.addCommand(hs()),n.addCommand(Ss()),n.addCommand(Ps()),n.addCommand(Ds()),n}function hs(){return new we("run").description("Run a transformation against an input scope and write the resulting Artifacts to disk.").argument("<transformation>","Transformation URI (`publisher/package/name`, optional `@version`) or just the local name if unique in the workspace.").requiredOption("--scope <scope>","Input source \u2014 either a package URI `publisher/package[@version]` (resolved via the local workspace + cache + HTTP tiers) or a file path to a `.kan.yml` document. Repeatable: pass `--scope X --scope Y` to aggregate matching instances across multiple packages, useful for index pages and other cross-package SetTransformations.",bs,[]).option("--format <name>","OutputFormat name to target (e.g. `markdown-with-frontmatter`, `html`, `svg`, `json`). If omitted and the transformation declares exactly one output, that single format is used.").option("--out <dir>","Directory to write artifacts into.",".").action(async(n,e)=>{try{await ws(n,e)}catch(t){console.error(`Error: ${t.message}`),process.exit(1)}})}function bs(n,e){return[...e,n]}async function ws(n,e){let t=new pn,r=new gn,o=await O(process.cwd(),t),s=await qt(n,o,r),{transformation:a,transformationKanonaks:i}=s;console.log(`Transformation: ${Le(a)}`);let c=le(a,i);e.scope.length===0&&(console.error("At least one --scope is required."),process.exit(1));let l=[],u=new Map;for(let w of e.scope){let $=await Cs(w,o,t,r);l.push(...$);let v=await Rs($,c.inputPattern.matchesClass,o);for(let K of v){let V=Ne(K);V&&!u.has(V)&&u.set(V,K)}console.log(`Scope: ${w} \u2014 found ${v.length} instance(s) of ${c.inputPattern.matchesClass.publisher}/${c.inputPattern.matchesClass.package_}/${c.inputPattern.matchesClass.name}`)}let d=[...u.values()],p=l;e.scope.length>1&&console.log(`Total across ${e.scope.length} scope(s): ${d.length} unique instance(s)`),d.length===0&&c.kind==="instance"&&(console.error("No matching input instances across the supplied scope(s). Check the transformation's inputPattern.matchesClass vs. the scope package(s)."),process.exit(1));let g=$s(c.outputs,e.format);console.log(`Output format: ${g}`);let b=Ue[g];if(!b)throw new Error(`Unknown format "${g}". Run \`kanonak transform formats\` to see what the runner supports.`);let y=await new G().run({transformation:a,instances:d,allKanonaks:p,transformationKanonaks:i,repository:o,parser:t,objectParser:r,outputFormat:g}),h=ps(e.out);ds(h,{recursive:!0});for(let w of y){let $=As(w.fileName),v=ms(h,`${$}${b.extension}`);us(v,w.content,"utf-8"),console.log(`  wrote ${v}`)}console.log(`Done. ${y.length} artifact(s) written to ${h}`)}function $s(n,e){if(e){if(!n.has(e))throw new Error(`Transformation does not declare --format "${e}" in its outputs. Declared outputs: ${Array.from(n).sort().join(", ")}`);return e}if(n.size===1)return Array.from(n)[0];throw new Error(`Transformation supports multiple output formats (${Array.from(n).sort().join(", ")}); pass --format <name> to select one.`)}function Ss(){return new we("list").description("Scan the local workspace + cache for every Transformation instance and print a one-line summary per hit.").action(async()=>{try{await vs()}catch(n){console.error(`Error: ${n.message}`),process.exit(1)}})}async function vs(){let n=new pn,e=new gn,t=await O(process.cwd(),n),r=await t.getAllDocumentsAsync(),o=new Map;for(let a of r)try{let i=new C(a,t),c=await e.parseKanonaks(i),l=mn(c);for(let u of l){let d=Ne(u);if(!d)continue;let p=o.get(d)??[];p.push({tx:u,kanonaks:c,doc:a}),o.set(d,p)}}catch{}let s=[];for(let a of o.values()){if(a.length===1){s.push(Vt(a[0].tx,a[0].kanonaks));continue}let i=kn(a.map(l=>l.doc));if(!i.chosen)continue;let c=a.find(l=>l.doc===i.chosen);c&&s.push(Vt(c.tx,c.kanonaks))}if(s.length===0){console.log("No Transformation instances found in the current workspace.");return}s.sort((a,i)=>a.uri.localeCompare(i.uri));for(let a of s)console.log(`${a.uri}`),console.log(`    matches: ${a.matchesClass}`),console.log(`    outputs: ${a.outputs.join(", ")}`)}function Ps(){return new we("show").description("Compile a transformation and print a human-readable summary (input pattern, outputs, format overrides, rule shape).").argument("<transformation>","Transformation URI or local name").action(async n=>{try{await Ks(n)}catch(e){console.error(`Error: ${e.message}`),process.exit(1)}})}async function Ks(n){let e=new pn,t=new gn,r=await O(process.cwd(),e),{transformation:o,transformationKanonaks:s}=await qt(n,r,t),a=le(o,s);if(console.log(`Transformation: ${Le(o)}`),console.log(),console.log("Input pattern:"),console.log(`  Matches class: ${Oe(a.inputPattern.matchesClass)}`),a.inputPattern.requires.length>0){console.log("  Required properties:");for(let i of a.inputPattern.requires)console.log(`    - ${Oe(i)}`)}else console.log("  Required properties: (none)");if(console.log(),console.log(`Outputs: ${Array.from(a.outputs).sort().join(", ")}`),console.log(),a.overrides.size>0){console.log("Format overrides:");for(let[i,c]of a.overrides){if(console.log(`  ${i}:`),c.metadataKeys&&console.log(`    metadata keys: ${c.metadataKeys.join(", ")}`),c.metadataRenames.size>0){let l=[];for(let[u,d]of c.metadataRenames)l.push(`${u} \u2192 ${d}`);console.log(`    metadata renames: ${l.join(", ")}`)}c.trailingNewline!==void 0&&console.log(`    trailing newline: ${c.trailingNewline}`)}console.log()}console.log(`Rule root kind: ${a.rule.kind}`),a.rule.kind==="build-ast-node"&&(console.log(`Rule root AST class: ${Oe(a.rule.astClass)}`),console.log(`Rule root bindings: ${a.rule.set.length} field(s)`)),console.log(`Artifact name root kind: ${a.artifactName.kind}`)}function Ds(){return new we("formats").description("List the OutputFormat names the runner can serialize to.").action(()=>{console.log("Registered format backends:");let n=Object.entries(Ue).sort(([e],[t])=>e.localeCompare(t));for(let[e,t]of n)console.log(`  ${e.padEnd(28)} ${t.extension.padEnd(6)} ${t.formatUri}`)})}async function qt(n,e,t){let r,o,s;if(n.includes("/")){let p=n.indexOf("@"),g=n;if(p!==-1){let k=n.indexOf("/",p);if(k===-1)throw new Error(`Transformation URI "${n}" has @version but no trailing /<name>`);g=n.substring(0,p)+n.substring(k)}let b=g.split("/");if(b.length<3)throw new Error(`Invalid transformation URI "${n}" \u2014 expected publisher/package/name or publisher/package@version/name`);r=b[0],o=b[1],s=b.slice(2).join("/")}else s=n;if(r&&o){let p=await e.getDocumentsByNamespaceAsync(r,o);if(p.length===0)throw new Error(`Package ${r}/${o} not found in the local workspace or cache.`);let g=Es(n),b=zt(p,g,`${r}/${o}`),k=new C(b,e),y=await t.parseKanonaks(k),h=Pe(y,{publisher:r,package_:o,name:s,version:""});if(!h){let w=mn(y),$=w.find(v=>v.name===s);if(!$)throw new Error(`Transformation "${s}" not found in package ${r}/${o}. Package contains ${w.length} Transformation(s): ${w.map(v=>v.name).join(", ")||"(none)"}`);return{transformation:$,transformationKanonaks:y}}return{transformation:h,transformationKanonaks:y}}let a=await e.getAllDocumentsAsync(),i=new Map;for(let p of a)try{let g=new C(p,e),b=await t.parseKanonaks(g),k=mn(b);for(let y of k){if(y.name!==s)continue;let h=Ne(y);if(!h)continue;let w=i.get(h)??[];w.push({tx:y,kanonaks:b,doc:p}),i.set(h,w)}}catch{}if(i.size===0)throw new Error(`No Transformation named "${s}" found in the workspace. Try \`kanonak transform list\` to see available transformations.`);if(i.size>1){let p=Array.from(i.keys()).sort().join(`
+`);return n.addCommand(hs()),n.addCommand(Ss()),n.addCommand(Ps()),n.addCommand(Ds()),n}function hs(){return new we("run").description("Run a transformation against an input scope and write the resulting Artifacts to disk.").argument("<transformation>","Transformation URI (`publisher/package/name`, optional `@version`) or just the local name if unique in the workspace.").requiredOption("--scope <scope>","Input source \u2014 either a package URI `publisher/package[@version]` (resolved via the local workspace + cache + HTTP tiers) or a file path to a `.kan.yml` document. Repeatable: pass `--scope X --scope Y` to aggregate matching instances across multiple packages, useful for index pages and other cross-package SetTransformations.",bs,[]).option("--format <name>","OutputFormat name to target (e.g. `markdown-with-frontmatter`, `html`, `svg`, `json`). If omitted and the transformation declares exactly one output, that single format is used.").option("--out <dir>","Directory to write artifacts into.",".").action(async(n,e)=>{try{await ws(n,e)}catch(t){console.error(`Error: ${t.message}`),process.exit(1)}})}function bs(n,e){return[...e,n]}async function ws(n,e){let t=new mn,r=new pn,o=await O(process.cwd(),t),s=await qt(n,o,r),{transformation:a,transformationKanonaks:i}=s;console.log(`Transformation: ${Le(a)}`);let c=le(a,i);e.scope.length===0&&(console.error("At least one --scope is required."),process.exit(1));let l=[],u=new Map;for(let w of e.scope){let $=await Cs(w,o,t,r);l.push(...$);let v=await Rs($,c.inputPattern.matchesClass,o);for(let K of v){let V=Is(K);V&&!u.has(V)&&u.set(V,K)}console.log(`Scope: ${w} \u2014 found ${v.length} instance(s) of ${c.inputPattern.matchesClass.publisher}/${c.inputPattern.matchesClass.package_}/${c.inputPattern.matchesClass.name}`)}let d=[...u.values()],p=l;e.scope.length>1&&console.log(`Total across ${e.scope.length} scope(s): ${d.length} unique instance(s)`),d.length===0&&c.kind==="instance"&&(console.error("No matching input instances across the supplied scope(s). Check the transformation's inputPattern.matchesClass vs. the scope package(s)."),process.exit(1));let g=$s(c.outputs,e.format);console.log(`Output format: ${g}`);let b=Ue[g];if(!b)throw new Error(`Unknown format "${g}". Run \`kanonak transform formats\` to see what the runner supports.`);let y=await new G().run({transformation:a,instances:d,allKanonaks:p,transformationKanonaks:i,repository:o,parser:t,objectParser:r,outputFormat:g}),h=ps(e.out);ds(h,{recursive:!0});for(let w of y){let $=As(w.fileName),v=ms(h,`${$}${b.extension}`);us(v,w.content,"utf-8"),console.log(`  wrote ${v}`)}console.log(`Done. ${y.length} artifact(s) written to ${h}`)}function $s(n,e){if(e){if(!n.has(e))throw new Error(`Transformation does not declare --format "${e}" in its outputs. Declared outputs: ${Array.from(n).sort().join(", ")}`);return e}if(n.size===1)return Array.from(n)[0];throw new Error(`Transformation supports multiple output formats (${Array.from(n).sort().join(", ")}); pass --format <name> to select one.`)}function Ss(){return new we("list").description("Scan the local workspace + cache for every Transformation instance and print a one-line summary per hit.").action(async()=>{try{await vs()}catch(n){console.error(`Error: ${n.message}`),process.exit(1)}})}async function vs(){let n=new mn,e=new pn,t=await O(process.cwd(),n),r=await t.getAllDocumentsAsync(),o=new Map;for(let a of r)try{let i=new C(a,t),c=await e.parseKanonaks(i),l=fn(c);for(let u of l){let d=kn(u);if(!d)continue;let p=o.get(d)??[];p.push({tx:u,kanonaks:c,doc:a}),o.set(d,p)}}catch{}let s=[];for(let a of o.values()){if(a.length===1){s.push(Vt(a[0].tx,a[0].kanonaks));continue}let i=gn(a.map(l=>l.doc));if(!i.chosen)continue;let c=a.find(l=>l.doc===i.chosen);c&&s.push(Vt(c.tx,c.kanonaks))}if(s.length===0){console.log("No Transformation instances found in the current workspace.");return}s.sort((a,i)=>a.uri.localeCompare(i.uri));for(let a of s)console.log(`${a.uri}`),console.log(`    matches: ${a.matchesClass}`),console.log(`    outputs: ${a.outputs.join(", ")}`)}function Ps(){return new we("show").description("Compile a transformation and print a human-readable summary (input pattern, outputs, format overrides, rule shape).").argument("<transformation>","Transformation URI or local name").action(async n=>{try{await Ks(n)}catch(e){console.error(`Error: ${e.message}`),process.exit(1)}})}async function Ks(n){let e=new mn,t=new pn,r=await O(process.cwd(),e),{transformation:o,transformationKanonaks:s}=await qt(n,r,t),a=le(o,s);if(console.log(`Transformation: ${Le(o)}`),console.log(),console.log("Input pattern:"),console.log(`  Matches class: ${Oe(a.inputPattern.matchesClass)}`),a.inputPattern.requires.length>0){console.log("  Required properties:");for(let i of a.inputPattern.requires)console.log(`    - ${Oe(i)}`)}else console.log("  Required properties: (none)");if(console.log(),console.log(`Outputs: ${Array.from(a.outputs).sort().join(", ")}`),console.log(),a.overrides.size>0){console.log("Format overrides:");for(let[i,c]of a.overrides){if(console.log(`  ${i}:`),c.metadataKeys&&console.log(`    metadata keys: ${c.metadataKeys.join(", ")}`),c.metadataRenames.size>0){let l=[];for(let[u,d]of c.metadataRenames)l.push(`${u} \u2192 ${d}`);console.log(`    metadata renames: ${l.join(", ")}`)}c.trailingNewline!==void 0&&console.log(`    trailing newline: ${c.trailingNewline}`)}console.log()}console.log(`Rule root kind: ${a.rule.kind}`),a.rule.kind==="build-ast-node"&&(console.log(`Rule root AST class: ${Oe(a.rule.astClass)}`),console.log(`Rule root bindings: ${a.rule.set.length} field(s)`)),console.log(`Artifact name root kind: ${a.artifactName.kind}`)}function Ds(){return new we("formats").description("List the OutputFormat names the runner can serialize to.").action(()=>{console.log("Registered format backends:");let n=Object.entries(Ue).sort(([e],[t])=>e.localeCompare(t));for(let[e,t]of n)console.log(`  ${e.padEnd(28)} ${t.extension.padEnd(6)} ${t.formatUri}`)})}async function qt(n,e,t){let r,o,s;if(n.includes("/")){let p=n.indexOf("@"),g=n;if(p!==-1){let k=n.indexOf("/",p);if(k===-1)throw new Error(`Transformation URI "${n}" has @version but no trailing /<name>`);g=n.substring(0,p)+n.substring(k)}let b=g.split("/");if(b.length<3)throw new Error(`Invalid transformation URI "${n}" \u2014 expected publisher/package/name or publisher/package@version/name`);r=b[0],o=b[1],s=b.slice(2).join("/")}else s=n;if(r&&o){let p=await e.getDocumentsByNamespaceAsync(r,o);if(p.length===0)throw new Error(`Package ${r}/${o} not found in the local workspace or cache.`);let g=Es(n),b=zt(p,g,`${r}/${o}`),k=new C(b,e),y=await t.parseKanonaks(k),h=Pe(y,{publisher:r,package_:o,name:s,version:""});if(!h){let w=fn(y),$=w.find(v=>v.name===s);if(!$)throw new Error(`Transformation "${s}" not found in package ${r}/${o}. Package contains ${w.length} Transformation(s): ${w.map(v=>v.name).join(", ")||"(none)"}`);return{transformation:$,transformationKanonaks:y}}return{transformation:h,transformationKanonaks:y}}let a=await e.getAllDocumentsAsync(),i=new Map;for(let p of a)try{let g=new C(p,e),b=await t.parseKanonaks(g),k=fn(b);for(let y of k){if(y.name!==s)continue;let h=kn(y);if(!h)continue;let w=i.get(h)??[];w.push({tx:y,kanonaks:b,doc:p}),i.set(h,w)}}catch{}if(i.size===0)throw new Error(`No Transformation named "${s}" found in the workspace. Try \`kanonak transform list\` to see available transformations.`);if(i.size>1){let p=Array.from(i.keys()).sort().join(`
   `);throw new Error(`Multiple Transformations named "${s}" in the workspace \u2014 disambiguate with a full publisher/package/name URI:
-  ${p}`)}let c=Array.from(i.values())[0];if(c.length===1)return{transformation:c[0].tx,transformationKanonaks:c[0].kanonaks};let l=new Map(c.map(p=>[p.doc,p])),u=kn(c.map(p=>p.doc));if(!u.chosen)throw new Error(`Could not select a Transformation version for "${s}".`);let d=l.get(u.chosen);if(u.multipleVersionsPresent){let p=k=>{let y=k.metadata.namespace_?.version;return y?Mt(y):""},g=d.tx.namespace??"",b=g.includes("@")?g.substring(0,g.indexOf("@")):g;console.warn(`Warning: Transformation "${s}" has ${c.length} versions present (${c.map(k=>p(k.doc)).filter(Boolean).join(", ")}); using @${p(u.chosen)}. Pin with ${b}@<version>/${s} to suppress this warning.`)}return{transformation:d.tx,transformationKanonaks:d.kanonaks}}async function Cs(n,e,t,r){if(/^[.\/\\]/.test(n)||/^[A-Za-z]:/.test(n)||n.endsWith(".kan.yml")||Ft(n)&&fs(n).isFile()){if(!Ft(n))throw new Error(`Scope file not found: ${n}`);let b=ls(n,"utf-8"),k=t.parse(b),y=new C(k,e);return r.parseKanonaks(y)}let s=n.indexOf("@"),a=s===-1?n:n.substring(0,s),i=s===-1?void 0:n.substring(s+1),c=a.indexOf("/");if(c===-1)throw new Error(`Invalid scope "${n}" \u2014 expected a file path or publisher/package[@version] URI`);let l=a.substring(0,c),u=a.substring(c+1),d=await e.getDocumentsByNamespaceAsync(l,u);if(d.length===0)throw new Error(`Scope package ${l}/${u} not found in the local workspace or cache.`);let p=zt(d,i,`${l}/${u}`),g=new C(p,e);return r.parseKanonaks(g)}function Es(n){let e=n.indexOf("@");if(e===-1)return;let t=n.substring(e+1),r=t.indexOf("/");return r===-1?t:t.substring(0,r)}function zt(n,e,t){let r=s=>{let a=s.metadata.namespace_?.version;return a?Mt(a):""},o=kn(n,{requestedVersion:e});if(o.exactRequestedVersionMissing){let s=n.map(r).filter(Boolean).sort().join(", ");throw new Error(`${t}@${e} not found in the local workspace or cache. Available versions: ${s||"(none with parseable namespace)"}`)}if(!o.chosen)throw new Error(`${t} not found in the local workspace or cache.`);return!e&&o.multipleVersionsPresent&&console.warn(`Warning: ${t} has ${n.length} versions present (${n.map(r).filter(Boolean).join(", ")}); using @${r(o.chosen)}. Pin with ${t}@<version> to suppress this warning.`),o.chosen}function Vt(n,e){try{let t=le(n,e);return{uri:Le(n),matchesClass:Oe(t.inputPattern.matchesClass),outputs:Array.from(t.outputs).sort()}}catch(t){return{uri:Le(n),matchesClass:`(compile error: ${t.message})`,outputs:[]}}}function Le(n){let e=n.namespace||"",t=e.indexOf("@");return`${t===-1?e:e.substring(0,t)}/${n.name}`}function Oe(n){return`${n.publisher}/${n.package_}/${n.name}`}function As(n){return n.replace(/[\\/:*?"<>|\s]+/g,"_").replace(/^_+|_+$/g,"")}async function Rs(n,e,t){let r=new Map;for(let a of n){if(!(a instanceof gs))continue;let i=Ne(a);i&&r.set(i,a)}let o=[];try{o=(await new ks({vocabulary:new ys}).reason(t)).getInstancesOfClass(Bt(e.publisher,e.package_,e.name))}catch{}let s=[];for(let a of o){let i=r.get(a);i&&s.push(i)}return s.length>0?s:A(n,e)}function Ne(n){let e=n.namespace??"",t=e.indexOf("@"),r=t===-1?e:e.substring(0,t),o=r.indexOf("/");return o===-1||!n.name?null:Bt(r.substring(0,o),r.substring(o+1),n.name)}import{Command as Is}from"commander";import{KanonakParser as _s,PublisherIndex as Wt,CredentialStore as Gt,createAuthenticatedFetch as Xt,FileSystemKanonakDocumentRepository as Ts,Reasoner as js,KanonakVocabulary as xs,getGlobalCachePath as Us,makeUriKey as Os}from"@kanonak-protocol/sdk";function Ls(n){let e=n.split("/");if(e.length!==3)return null;let[t,r,o]=e;return!t||!r||!o?null:{publisher:t,package_:r,name:o}}function Jt(){return new Is("search").description("Browse a publisher's catalogue or find instances of a class via the SDK reasoner").argument("<publisher>","Publisher domain (e.g. kanonak.org)").option("--type <uri>","Class URI to search for, in publisher/package/Name form").action(async(n,e)=>{e.type?await Fs(n,e.type):await Ns(n)})}async function Ns(n){let e=new Gt,t=Xt(e),r=new Wt({fetchFn:t}),o;try{o=await r.listLatestPackages(n)}catch(a){console.error(`Failed to fetch publisher index for ${n}: ${a.message}`),process.exit(1)}if(o.length===0){console.log(`No packages found at ${n}.`);return}console.log(`Packages published by ${n}:
-`);let s=o.reduce((a,i)=>Math.max(a,i.packageName.length),0);for(let{packageName:a,version:i}of o)console.log(`  ${a.padEnd(s)}  @${i}`)}async function Fs(n,e){let t=Ls(e);t||(console.error(`Invalid --type value: ${e}`),console.error("Expected: publisher/package/Name (e.g. kanonak.org/capabilities/Capability)"),process.exit(1));let r=new _s,o=new Gt,s=Xt(o),a=new Wt({fetchFn:s}),i=new U,c=new Set,l=[];try{l=await a.listLatestPackages(n)}catch(y){console.error(`Failed to fetch publisher index for ${n}: ${y.message}`),process.exit(1)}for(let{packageName:y,version:h}of l)c.add(`${n}|${y}|${h}`);await yn(a,i,s,"kanonak.org","core-rdf",c),await yn(a,i,s,"kanonak.org","core-owl",c),await yn(a,i,s,t.publisher,t.package_,c);for(let y of c){let[h,w,$]=y.split("|");if(!i.has(h,w,$))try{let v=await a.getPackageUrl(h,w,$),K=await s(v,h);if(!K.ok){console.error(`Warning: failed to fetch ${h}/${w}@${$}: ${K.status} ${K.statusText}`);continue}let V=await K.text();i.put(h,w,$,V)}catch(v){console.error(`Warning: failed to fetch ${h}/${w}@${$}: ${v.message}`)}}let u=new Ts(Us(),!0,r),p=await new js({vocabulary:new xs}).reason(u),g=Os(t.publisher,t.package_,t.name),k=p.getInstancesOfClass(g).filter(y=>y!==g);if(k.length===0){console.log(`No instances of ${g} found in ${n}'s catalogue.`);return}console.log(`Instances of ${g} in ${n}'s catalogue:
-`),k.sort();for(let y of k)console.log(`  ${y}`)}async function yn(n,e,t,r,o,s){try{let a=await n.getHighestVersion(r,o);if(!a)return;s.add(`${r}|${o}|${a}`)}catch{}}import{Command as Yt}from"commander";function fe(n){return`${I}/${_}/${n}`}var hn={[fe("fetch-and-deploy")]:(n,e,t,r)=>n.add(e,t[0],r),[fe("remove-deployed")]:(n,e,t,r)=>n.remove(e,t[0],r),[fe("list-deployed")]:(n,e,t,r)=>n.list(e,r),[fe("update-deployed")]:(n,e,t,r)=>n.update(e,t[0],r),[fe("search-available")]:(n,e,t,r)=>n.search(e,r),[fe("show-info")]:(n,e,t,r)=>n.info(e,t[0],r)};function Zt(n,e,t){for(let r of e){let o=new Yt(r.commandName).description(r.description.trim());for(let s of r.commands){let a=o.command(Vs(s));a.description(s.description);for(let i of s.arguments)if(i.isOption){let c=i.defaultValue!=null?`--${i.argumentName} [value]`:`--${i.argumentName} <value>`;a.option(c,"",i.defaultValue)}a.action(async(...i)=>{let c=Bs(i);await Ms(t,r,s,i,c)})}n.addCommand(o)}}function Vs(n){let e=n.arguments.filter(t=>!t.isOption).map(t=>t.required?`<${t.argumentName}>`:`[${t.argumentName}]`);return[n.subcommandName,...e].join(" ")}function Bs(n){for(let e=n.length-1;e>=0;e--)if(n[e]&&typeof n[e]=="object"&&!(n[e]instanceof Yt))return n[e];return{}}async function Ms(n,e,t,r,o){let s=[];for(let i of r)if(typeof i=="string")s.push(i);else break;t.actionKey||(console.error(`Capability subcommand '${t.subcommandName}' has no resolved \`performs:\` Action. Every CapabilityCommand must declare a performs value pointing at a named Action instance from the capabilities ontology. Known actions: ${Object.keys(hn).join(", ")}.`),process.exit(1));let a=hn[t.actionKey];a||(console.error(`Capability subcommand '${t.subcommandName}' references unknown Action '${t.actionKey}'. Known actions: ${Object.keys(hn).join(", ")}.`),process.exit(1)),await a(n,e,s,o)}import{existsSync as Qt,readFileSync as Hs,statSync as er}from"fs";import{resolve as qs}from"path";import{KanonakObjectParser as zs,PublisherIndex as bn,PublisherConfigResolver as Ws,formatVersion as nr,pickHighestDocument as Gs}from"@kanonak-protocol/sdk";var Fe=class{constructor(e,t,r,o,s,a){this.fileCache=e;this.parser=t;this.publisherIndex=r;this.fetchFn=o;this.handlerRegistry=s;this.repository=a}fileCache;parser;publisherIndex;fetchFn;handlerRegistry;repository;objectParser=new zs;async add(e,t,r){let o=this.tryLoadFromLocalFile(t);if(o){this.fileCache.put(o.publisher,o.packageName,o.version,o.content),await this.deployFromDoc(e,o.doc,o.publisher,o.packageName,o.version,void 0,`local file ${t}`,r);return}let s=ee(t);s||(console.error(`Invalid package reference: "${t}"`),console.error(""),console.error("Accepted forms:"),console.error("  publisher/package                       (install all instances, latest version)"),console.error("  publisher/package@version               (install all instances, pinned)"),console.error("  publisher/package/instance              (install one instance, latest version)"),console.error("  publisher/package@version/instance      (install one instance, pinned)"),console.error("  ./path/to/file.kan.yml                  (install all instances from a local document)"),console.error(""),console.error("Tip: copy a URI directly from `kanonak "+e.commandName+" search`."),process.exit(1));let{publisher:a,packageName:i,version:c,instanceName:l}=s,u=await this.repository.getDocumentsByNamespaceAsync(a,i);if(u.length>0){let g=Gs(u,{requestedVersion:c??void 0});if(g.chosen){let b=g.chosen.metadata.namespace_;(!b||!b.version)&&(console.error(`Document for ${a}/${i} is missing namespace metadata.`),process.exit(1));let k=nr(b.version);this.fileCache.put(a,i,k,this.parser.save(g.chosen)),await this.deployFromDoc(e,g.chosen,a,i,k,l??void 0,`${a}/${i}@${k}`,r);return}}let d=c??await this.publisherIndex.getHighestVersion(a,i);d||(console.error(`Could not resolve version for "${a}/${i}".`),await this.printPackageSuggestions(a,i,e.commandName),process.exit(1));let p=this.fileCache.get(a,i,d);if(!p){let g=await this.publisherIndex.getPackageUrl(a,i,d),b=await this.fetchFn(g,a);b.ok||(b.status===404?(console.error(`Package ${a}/${i}@${d} not found at ${g}.`),console.error(`The publisher index lists this version but the file is missing \u2014 it may have been unpublished. Try \`kanonak ${e.commandName} search\` to see the current catalogue.`)):console.error(`Failed to fetch ${g} (${b.status} ${b.statusText}).`),process.exit(1)),p=await b.text(),this.fileCache.put(a,i,d,p)}await this.deployFromDoc(e,this.parser.parse(p),a,i,d,l??void 0,`${a}/${i}@${d}`,r)}tryLoadFromLocalFile(e){if(!(/^[.\/\\]/.test(e)||/^[A-Za-z]:[\\/]/.test(e)||e.endsWith(".kan.yml")||Qt(e)&&er(e).isFile()))return;let r=qs(e);(!Qt(r)||!er(r).isFile())&&(console.error(`Local file not found: ${e}`),process.exit(1));let o=Hs(r,"utf-8"),s=this.parser.parse(o),a=s.metadata.namespace_;return(!a||!a.version)&&(console.error(`${e} has no namespace metadata; cannot determine publisher/package/version. A Kanonak document must declare \`type: Package\` with publisher and version.`),process.exit(1)),{doc:s,content:o,publisher:a.publisher,packageName:a.package_,version:nr(a.version)}}async deployFromDoc(e,t,r,o,s,a,i,c){let l=new C(t,this.repository),u=await this.objectParser.parseKanonaks(l),d=tr(e.managesTypeKey);d||(console.error(`Capability "${e.commandName}" has no resolved managesType.`),process.exit(1));let p=A(u,d);p.length===0&&(console.error(`${i} does not contain any ${L(d)} instances.`),process.exit(1));let g=p;if(a&&(g=p.filter(y=>y.name===a),g.length===0)){console.error(`Instance "${a}" not found in ${i}.`),console.error(""),console.error(`Available ${L(d)} instance(s):`);for(let y of p)console.error(`  - ${y.name}`);console.error(""),console.error("To install all of them, drop the instance suffix:"),console.error(`  kanonak ${e.commandName} add ${r}/${o}`),process.exit(1)}let b=a?`${a} from ${i}`:`${g.length} ${L(d)} instance(s) from ${i}`;console.log(`Installing ${b}...`);let k=this.handlerRegistry.get(e.deploymentTargetKey);k?await k.deploy({instances:g,allKanonaks:u,repository:this.repository,options:c}):console.log(`Cached ${r}/${o}@${s} (no deployment handler for "${e.deploymentTargetKey}")`)}async printPackageSuggestions(e,t,r){let o;try{o=await this.publisherIndex.listLatestPackages(e)}catch{return}let s=o.map(a=>({name:a.packageName,version:a.version,score:Xs(t,a.packageName)})).filter(a=>a.score>0).sort((a,i)=>i.score-a.score).slice(0,5);if(s.length!==0){console.error(""),console.error("Did you mean one of:");for(let a of s)console.error(`  kanonak ${r} add ${e}/${a.name}`)}}async remove(e,t,r){await this.requireHandler(e).undeploy(t,{repository:this.repository,options:r})}async list(e,t){let o=await this.requireHandler(e).list({repository:this.repository,options:t}),s=e.managesTypeKey||"managed";if(o.length===0){console.log(`No ${s} instances installed.`);return}console.log(`Installed ${s} instances:
+  ${p}`)}let c=Array.from(i.values())[0];if(c.length===1)return{transformation:c[0].tx,transformationKanonaks:c[0].kanonaks};let l=new Map(c.map(p=>[p.doc,p])),u=gn(c.map(p=>p.doc));if(!u.chosen)throw new Error(`Could not select a Transformation version for "${s}".`);let d=l.get(u.chosen);if(u.multipleVersionsPresent){let p=k=>{let y=k.metadata.namespace_?.version;return y?Mt(y):""},g=d.tx.namespace??"",b=g.includes("@")?g.substring(0,g.indexOf("@")):g;console.warn(`Warning: Transformation "${s}" has ${c.length} versions present (${c.map(k=>p(k.doc)).filter(Boolean).join(", ")}); using @${p(u.chosen)}. Pin with ${b}@<version>/${s} to suppress this warning.`)}return{transformation:d.tx,transformationKanonaks:d.kanonaks}}async function Cs(n,e,t,r){if(/^[.\/\\]/.test(n)||/^[A-Za-z]:/.test(n)||n.endsWith(".kan.yml")||Ft(n)&&fs(n).isFile()){if(!Ft(n))throw new Error(`Scope file not found: ${n}`);let b=ls(n,"utf-8"),k=t.parse(b),y=new C(k,e);return r.parseKanonaks(y)}let s=n.indexOf("@"),a=s===-1?n:n.substring(0,s),i=s===-1?void 0:n.substring(s+1),c=a.indexOf("/");if(c===-1)throw new Error(`Invalid scope "${n}" \u2014 expected a file path or publisher/package[@version] URI`);let l=a.substring(0,c),u=a.substring(c+1),d=await e.getDocumentsByNamespaceAsync(l,u);if(d.length===0)throw new Error(`Scope package ${l}/${u} not found in the local workspace or cache.`);let p=zt(d,i,`${l}/${u}`),g=new C(p,e);return r.parseKanonaks(g)}function Es(n){let e=n.indexOf("@");if(e===-1)return;let t=n.substring(e+1),r=t.indexOf("/");return r===-1?t:t.substring(0,r)}function zt(n,e,t){let r=s=>{let a=s.metadata.namespace_?.version;return a?Mt(a):""},o=gn(n,{requestedVersion:e});if(o.exactRequestedVersionMissing){let s=n.map(r).filter(Boolean).sort().join(", ");throw new Error(`${t}@${e} not found in the local workspace or cache. Available versions: ${s||"(none with parseable namespace)"}`)}if(!o.chosen)throw new Error(`${t} not found in the local workspace or cache.`);return!e&&o.multipleVersionsPresent&&console.warn(`Warning: ${t} has ${n.length} versions present (${n.map(r).filter(Boolean).join(", ")}); using @${r(o.chosen)}. Pin with ${t}@<version> to suppress this warning.`),o.chosen}function Vt(n,e){try{let t=le(n,e);return{uri:Le(n),matchesClass:Oe(t.inputPattern.matchesClass),outputs:Array.from(t.outputs).sort()}}catch(t){return{uri:Le(n),matchesClass:`(compile error: ${t.message})`,outputs:[]}}}function Le(n){let e=n.namespace||"",t=e.indexOf("@");return`${t===-1?e:e.substring(0,t)}/${n.name}`}function Oe(n){return`${n.publisher}/${n.package_}/${n.name}`}function As(n){return n.replace(/[\\/:*?"<>|\s]+/g,"_").replace(/^_+|_+$/g,"")}async function Rs(n,e,t){let r=new Map;for(let a of n){if(!(a instanceof gs))continue;let i=kn(a);i&&r.set(i,a)}let o=[];try{o=(await new ks({vocabulary:new ys}).reason(t)).getInstancesOfClass(Bt(e.publisher,e.package_,e.name))}catch{}let s=[];for(let a of o){let i=r.get(a);i&&s.push(i)}return s.length>0?s:A(n,e)}function kn(n){let e=n.namespace??"",t=e.indexOf("@"),r=t===-1?e:e.substring(0,t),o=r.indexOf("/");return o===-1||!n.name?null:Bt(r.substring(0,o),r.substring(o+1),n.name)}function Is(n){let e=n.namespace??"";return!e||!n.name?null:`${e}/${n.name}`}import{Command as _s}from"commander";import{KanonakParser as Ts,PublisherIndex as Wt,CredentialStore as Gt,createAuthenticatedFetch as Xt,FileSystemKanonakDocumentRepository as js,Reasoner as xs,KanonakVocabulary as Us,getGlobalCachePath as Os,makeUriKey as Ls}from"@kanonak-protocol/sdk";function Ns(n){let e=n.split("/");if(e.length!==3)return null;let[t,r,o]=e;return!t||!r||!o?null:{publisher:t,package_:r,name:o}}function Jt(){return new _s("search").description("Browse a publisher's catalogue or find instances of a class via the SDK reasoner").argument("<publisher>","Publisher domain (e.g. kanonak.org)").option("--type <uri>","Class URI to search for, in publisher/package/Name form").action(async(n,e)=>{e.type?await Vs(n,e.type):await Fs(n)})}async function Fs(n){let e=new Gt,t=Xt(e),r=new Wt({fetchFn:t}),o;try{o=await r.listLatestPackages(n)}catch(a){console.error(`Failed to fetch publisher index for ${n}: ${a.message}`),process.exit(1)}if(o.length===0){console.log(`No packages found at ${n}.`);return}console.log(`Packages published by ${n}:
+`);let s=o.reduce((a,i)=>Math.max(a,i.packageName.length),0);for(let{packageName:a,version:i}of o)console.log(`  ${a.padEnd(s)}  @${i}`)}async function Vs(n,e){let t=Ns(e);t||(console.error(`Invalid --type value: ${e}`),console.error("Expected: publisher/package/Name (e.g. kanonak.org/capabilities/Capability)"),process.exit(1));let r=new Ts,o=new Gt,s=Xt(o),a=new Wt({fetchFn:s}),i=new U,c=new Set,l=[];try{l=await a.listLatestPackages(n)}catch(y){console.error(`Failed to fetch publisher index for ${n}: ${y.message}`),process.exit(1)}for(let{packageName:y,version:h}of l)c.add(`${n}|${y}|${h}`);await yn(a,i,s,"kanonak.org","core-rdf",c),await yn(a,i,s,"kanonak.org","core-owl",c),await yn(a,i,s,t.publisher,t.package_,c);for(let y of c){let[h,w,$]=y.split("|");if(!i.has(h,w,$))try{let v=await a.getPackageUrl(h,w,$),K=await s(v,h);if(!K.ok){console.error(`Warning: failed to fetch ${h}/${w}@${$}: ${K.status} ${K.statusText}`);continue}let V=await K.text();i.put(h,w,$,V)}catch(v){console.error(`Warning: failed to fetch ${h}/${w}@${$}: ${v.message}`)}}let u=new js(Os(),!0,r),p=await new xs({vocabulary:new Us}).reason(u),g=Ls(t.publisher,t.package_,t.name),k=p.getInstancesOfClass(g).filter(y=>y!==g);if(k.length===0){console.log(`No instances of ${g} found in ${n}'s catalogue.`);return}console.log(`Instances of ${g} in ${n}'s catalogue:
+`),k.sort();for(let y of k)console.log(`  ${y}`)}async function yn(n,e,t,r,o,s){try{let a=await n.getHighestVersion(r,o);if(!a)return;s.add(`${r}|${o}|${a}`)}catch{}}import{Command as Yt}from"commander";function fe(n){return`${I}/${_}/${n}`}var hn={[fe("fetch-and-deploy")]:(n,e,t,r)=>n.add(e,t[0],r),[fe("remove-deployed")]:(n,e,t,r)=>n.remove(e,t[0],r),[fe("list-deployed")]:(n,e,t,r)=>n.list(e,r),[fe("update-deployed")]:(n,e,t,r)=>n.update(e,t[0],r),[fe("search-available")]:(n,e,t,r)=>n.search(e,r),[fe("show-info")]:(n,e,t,r)=>n.info(e,t[0],r)};function Zt(n,e,t){for(let r of e){let o=new Yt(r.commandName).description(r.description.trim());for(let s of r.commands){let a=o.command(Bs(s));a.description(s.description);for(let i of s.arguments)if(i.isOption){let c=i.defaultValue!=null?`--${i.argumentName} [value]`:`--${i.argumentName} <value>`;a.option(c,"",i.defaultValue)}a.action(async(...i)=>{let c=Ms(i);await Hs(t,r,s,i,c)})}n.addCommand(o)}}function Bs(n){let e=n.arguments.filter(t=>!t.isOption).map(t=>t.required?`<${t.argumentName}>`:`[${t.argumentName}]`);return[n.subcommandName,...e].join(" ")}function Ms(n){for(let e=n.length-1;e>=0;e--)if(n[e]&&typeof n[e]=="object"&&!(n[e]instanceof Yt))return n[e];return{}}async function Hs(n,e,t,r,o){let s=[];for(let i of r)if(typeof i=="string")s.push(i);else break;t.actionKey||(console.error(`Capability subcommand '${t.subcommandName}' has no resolved \`performs:\` Action. Every CapabilityCommand must declare a performs value pointing at a named Action instance from the capabilities ontology. Known actions: ${Object.keys(hn).join(", ")}.`),process.exit(1));let a=hn[t.actionKey];a||(console.error(`Capability subcommand '${t.subcommandName}' references unknown Action '${t.actionKey}'. Known actions: ${Object.keys(hn).join(", ")}.`),process.exit(1)),await a(n,e,s,o)}import{existsSync as Qt,readFileSync as qs,statSync as er}from"fs";import{resolve as zs}from"path";import{KanonakObjectParser as Ws,PublisherIndex as bn,PublisherConfigResolver as Gs,formatVersion as nr,pickHighestDocument as Xs}from"@kanonak-protocol/sdk";var Ne=class{constructor(e,t,r,o,s,a){this.fileCache=e;this.parser=t;this.publisherIndex=r;this.fetchFn=o;this.handlerRegistry=s;this.repository=a}fileCache;parser;publisherIndex;fetchFn;handlerRegistry;repository;objectParser=new Ws;async add(e,t,r){let o=this.tryLoadFromLocalFile(t);if(o){this.fileCache.put(o.publisher,o.packageName,o.version,o.content),await this.deployFromDoc(e,o.doc,o.publisher,o.packageName,o.version,void 0,`local file ${t}`,r);return}let s=ee(t);s||(console.error(`Invalid package reference: "${t}"`),console.error(""),console.error("Accepted forms:"),console.error("  publisher/package                       (install all instances, latest version)"),console.error("  publisher/package@version               (install all instances, pinned)"),console.error("  publisher/package/instance              (install one instance, latest version)"),console.error("  publisher/package@version/instance      (install one instance, pinned)"),console.error("  ./path/to/file.kan.yml                  (install all instances from a local document)"),console.error(""),console.error("Tip: copy a URI directly from `kanonak "+e.commandName+" search`."),process.exit(1));let{publisher:a,packageName:i,version:c,instanceName:l}=s,u=await this.repository.getDocumentsByNamespaceAsync(a,i);if(u.length>0){let g=Xs(u,{requestedVersion:c??void 0});if(g.chosen){let b=g.chosen.metadata.namespace_;(!b||!b.version)&&(console.error(`Document for ${a}/${i} is missing namespace metadata.`),process.exit(1));let k=nr(b.version);this.fileCache.put(a,i,k,this.parser.save(g.chosen)),await this.deployFromDoc(e,g.chosen,a,i,k,l??void 0,`${a}/${i}@${k}`,r);return}}let d=c??await this.publisherIndex.getHighestVersion(a,i);d||(console.error(`Could not resolve version for "${a}/${i}".`),await this.printPackageSuggestions(a,i,e.commandName),process.exit(1));let p=this.fileCache.get(a,i,d);if(!p){let g=await this.publisherIndex.getPackageUrl(a,i,d),b=await this.fetchFn(g,a);b.ok||(b.status===404?(console.error(`Package ${a}/${i}@${d} not found at ${g}.`),console.error(`The publisher index lists this version but the file is missing \u2014 it may have been unpublished. Try \`kanonak ${e.commandName} search\` to see the current catalogue.`)):console.error(`Failed to fetch ${g} (${b.status} ${b.statusText}).`),process.exit(1)),p=await b.text(),this.fileCache.put(a,i,d,p)}await this.deployFromDoc(e,this.parser.parse(p),a,i,d,l??void 0,`${a}/${i}@${d}`,r)}tryLoadFromLocalFile(e){if(!(/^[.\/\\]/.test(e)||/^[A-Za-z]:[\\/]/.test(e)||e.endsWith(".kan.yml")||Qt(e)&&er(e).isFile()))return;let r=zs(e);(!Qt(r)||!er(r).isFile())&&(console.error(`Local file not found: ${e}`),process.exit(1));let o=qs(r,"utf-8"),s=this.parser.parse(o),a=s.metadata.namespace_;return(!a||!a.version)&&(console.error(`${e} has no namespace metadata; cannot determine publisher/package/version. A Kanonak document must declare \`type: Package\` with publisher and version.`),process.exit(1)),{doc:s,content:o,publisher:a.publisher,packageName:a.package_,version:nr(a.version)}}async deployFromDoc(e,t,r,o,s,a,i,c){let l=new C(t,this.repository),u=await this.objectParser.parseKanonaks(l),d=tr(e.managesTypeKey);d||(console.error(`Capability "${e.commandName}" has no resolved managesType.`),process.exit(1));let p=A(u,d);p.length===0&&(console.error(`${i} does not contain any ${L(d)} instances.`),process.exit(1));let g=p;if(a&&(g=p.filter(y=>y.name===a),g.length===0)){console.error(`Instance "${a}" not found in ${i}.`),console.error(""),console.error(`Available ${L(d)} instance(s):`);for(let y of p)console.error(`  - ${y.name}`);console.error(""),console.error("To install all of them, drop the instance suffix:"),console.error(`  kanonak ${e.commandName} add ${r}/${o}`),process.exit(1)}let b=a?`${a} from ${i}`:`${g.length} ${L(d)} instance(s) from ${i}`;console.log(`Installing ${b}...`);let k=this.handlerRegistry.get(e.deploymentTargetKey);k?await k.deploy({instances:g,allKanonaks:u,repository:this.repository,options:c}):console.log(`Cached ${r}/${o}@${s} (no deployment handler for "${e.deploymentTargetKey}")`)}async printPackageSuggestions(e,t,r){let o;try{o=await this.publisherIndex.listLatestPackages(e)}catch{return}let s=o.map(a=>({name:a.packageName,version:a.version,score:Js(t,a.packageName)})).filter(a=>a.score>0).sort((a,i)=>i.score-a.score).slice(0,5);if(s.length!==0){console.error(""),console.error("Did you mean one of:");for(let a of s)console.error(`  kanonak ${r} add ${e}/${a.name}`)}}async remove(e,t,r){await this.requireHandler(e).undeploy(t,{repository:this.repository,options:r})}async list(e,t){let o=await this.requireHandler(e).list({repository:this.repository,options:t}),s=e.managesTypeKey||"managed";if(o.length===0){console.log(`No ${s} instances installed.`);return}console.log(`Installed ${s} instances:
 `);for(let a of o){let i=a.publisher?`${a.publisher}/${a.package_}@${a.version}`:"unmanaged";console.log(`  ${a.name}  (${i})  ${a.path}`)}}async update(e,t,r){let s=await this.requireHandler(e).list({repository:this.repository,options:r}),a=t?s.filter(c=>c.name===t):s.filter(c=>c.publisher);if(a.length===0){console.log(t?`"${t}" not found.`:"No managed instances to update.");return}let i=0;for(let c of a){let l=await this.publisherIndex.getHighestVersion(c.publisher,c.package_);!l||l===c.version||(console.log(`Updating ${c.name}: ${c.version} \u2192 ${l}`),await this.add(e,`${c.publisher}/${c.package_}@${l}`,r),i++)}console.log(i===0?"All instances are up to date.":`
 Updated ${i} instance(s).`)}async search(e,t){let r=t.publisher??"kanonak.org",o=tr(e.managesTypeKey);if(!o){console.error("Capability has no resolved managesType; nothing to search for.");return}console.log(`Searching ${r} for ${L(o)} instances...
-`);let s=new Ws,a=await s.getConfig(r),i=s.resolveIndexUrl(r,a),c=await this.fetchFn(i,r);if(!c.ok){console.error(`Failed to fetch package index from ${r}.`);return}let l=await c.text(),u=bn.parseIndex(l);if(u.size===0){console.error(`No packages found for publisher "${r}".`);return}let d=new Map;for(let[k,y]of u){let h=[...y].sort((w,$)=>{let v=bn.parseVersion(w),K=bn.parseVersion($);return!v||!K?0:v.major!==K.major?K.major-v.major:v.minor!==K.minor?K.minor-v.minor:K.patch-v.patch});d.set(k,h[0])}let p=[],g=0;for(let[k,y]of d){let h=this.fileCache.get(r,k,y);if(!h)try{let w=await this.publisherIndex.getPackageUrl(r,k,y),$=await this.fetchFn(w,r);if(!$.ok)continue;h=await $.text(),this.fileCache.put(r,k,y,h)}catch{continue}try{let w=this.parser.parse(h),$=new C(w,this.repository),v=await this.objectParser.parseKanonaks($),K=A(v,o);for(let V of K)p.push({publisher:r,package_:k,version:y,subject:V});g++}catch{continue}}if(p.length===0){console.log(`No ${L(o)} instances found across ${g} package(s).`);return}console.log(`Found ${p.length} ${L(o)} instance(s) in ${g} package(s):
-`);let b=new Map;for(let k of p){let y=`${k.publisher}/${k.package_}@${k.version}`,h=b.get(y);h?h.push(k):b.set(y,[k])}for(let[k,y]of b){let h=y[0],w=`${h.publisher}/${h.package_}`,$=y.length===1;console.log(`  ${k}`),console.log(`    ${y.length} skill${$?"":"s"}:`);for(let v of y)console.log(`      - ${v.subject.name}`);if(console.log(""),$)console.log("    install:"),console.log(`      kanonak ${e.commandName} add ${w}/${h.subject.name}`);else{console.log("    install one of them:");for(let v of y)console.log(`      kanonak ${e.commandName} add ${w}/${v.subject.name}`);console.log("    install all of them:"),console.log(`      kanonak ${e.commandName} add ${w}`)}console.log("")}}async info(e,t,r){let a=(await this.requireHandler(e).list({repository:this.repository,options:r})).find(i=>i.name===t);a||(console.error(`"${t}" is not installed.`),process.exit(1)),console.log(`Name:      ${a.name}`),console.log(`Type:      ${e.managesTypeKey||"n/a"}`),console.log(`Publisher: ${a.publisher||"unmanaged"}`),console.log(`Package:   ${a.package_||"n/a"}`),console.log(`Version:   ${a.version||"n/a"}`),console.log(`Path:      ${a.path}`)}requireHandler(e){let t=this.handlerRegistry.get(e.deploymentTargetKey);return t||(console.error(`No deployment handler registered for "${e.deploymentTargetKey}". Ensure the capability's deploymentTarget resolves to a DeploymentTarget instance whose URI is registered in the CLI at startup.`),process.exit(1)),t}};function tr(n){if(!n)return;let e=n.split("/");if(e.length===3)return{publisher:e[0],package_:e[1],name:e[2]}}function Xs(n,e){let t=n.toLowerCase(),r=e.toLowerCase();if(t===r)return 100;if(r.includes(t)||t.includes(r))return 50;let o=new Set(t.split("-").filter(Boolean)),s=new Set(r.split("-").filter(Boolean)),a=0;for(let c of o)s.has(c)&&a++;if(a>0)return a*10;let i=Js(t,r);return i===0?100:i<=2?Math.max(1,20-i*5):0}function Js(n,e){if(n===e)return 0;if(n.length===0)return e.length;if(e.length===0)return n.length;let t=new Array(e.length+1),r=new Array(e.length+1);for(let o=0;o<=e.length;o++)t[o]=o;for(let o=0;o<n.length;o++){r[0]=o+1;for(let s=0;s<e.length;s++){let a=n[o]===e[s]?0:1;r[s+1]=Math.min(r[s]+1,t[s+1]+1,t[s]+a)}for(let s=0;s<=e.length;s++)t[s]=r[s]}return t[e.length]}var Ve=class{handlers=new Map;register(e,t){this.handlers.set(e,t)}get(e){return this.handlers.get(e)??null}};import{mkdirSync as ii,rmSync as ci,existsSync as He,readdirSync as li,writeFileSync as ui}from"fs";import{join as qe}from"path";import{KanonakObjectParser as di,KanonakParser as fi,computeIntegrity as mi}from"@kanonak-protocol/sdk";import{join as wn}from"path";import{homedir as rr}from"os";import{KanonakObjectParser as Ys}from"@kanonak-protocol/sdk";var J="kanonak.org",Y="agent-skills",ar={publisher:J,package_:Y,name:"Client"},sr={publisher:J,package_:Y,name:"clientId"},Zs={publisher:J,package_:Y,name:"projectSkillDir"},Qs={publisher:J,package_:Y,name:"userSkillDir"},ei={publisher:J,package_:Y,name:"skillFileName"},ir="agents";async function $e(n,e){let t=(n.client??cr()??ir).toLowerCase(),r=n.scope??"project",o=await ur(t,e);if(!o){let i=await ni(e);throw new Error(`Unknown client "${t}". Known clients: ${i.join(", ")||"(none)"}. Add a Client instance to a package that imports kanonak.org/agent-skills and install that package to make it available.`)}let a=R(o,r==="user"?Qs:Zs);if(!a)throw new Error(`Client "${t}" has no ${r==="user"?"userSkillDir":"projectSkillDir"} declared.`);return ti(a)}async function Be(n,e,t){let r=await $e(e,t);return wn(r,n)}async function $n(n,e){let t=(n.client??cr()??ir).toLowerCase(),r=await ur(t,e);return r?R(r,ei)??"SKILL.md":"SKILL.md"}function cr(){if(process.env.CLAUDE_CODE||process.env.CLAUDE_PROJECT_DIR)return"claude-code"}var or=new WeakMap;async function lr(n){let e=or.get(n);if(e)return e;let t=await n.getDocumentsByNamespaceAsync(J,Y);if(t.length===0)throw new Error(`Could not find ${J}/${Y} in the repository. Install a skill capability (which transitively imports agent-skills) or fetch agent-skills directly to populate the cache.`);let o=[...t].sort((c,l)=>{let u=c.metadata.namespace_?.version,d=l.metadata.namespace_?.version;return!u||!d?0:u.major!==d.major?d.major-u.major:u.minor!==d.minor?d.minor-u.minor:d.patch-u.patch})[0],s=new Ys,a=new C(o,n),i=await s.parseKanonaks(a);return or.set(n,i),i}async function ur(n,e){let t=await lr(e),r=A(t,ar);for(let o of r)if(R(o,sr)===n)return o}async function ni(n){let e=await lr(n),t=A(e,ar),r=[];for(let o of t){let s=R(o,sr);s&&r.push(s)}return r}function ti(n){return n.startsWith("~/")?wn(rr(),n.slice(2)):n==="~"?rr():n.startsWith("/")||/^[A-Za-z]:[\\/]/.test(n)?n:wn(process.cwd(),n)}import{readFileSync as ri,writeFileSync as oi,existsSync as ai}from"fs";import{join as dr}from"path";import fr from"js-yaml";var mr="skills.lock",si=`# This file is generated by Kanonak CLI. Do not edit manually.
-`;function Me(n){let e=dr(n,mr);if(!ai(e))return{version:"1",lastUpdated:new Date().toISOString(),skills:{}};let t=ri(e,"utf-8"),r=fr.load(t);return!r||typeof r!="object"||r.version!=="1"?{version:"1",lastUpdated:new Date().toISOString(),skills:{}}:{version:"1",lastUpdated:r.lastUpdated??new Date().toISOString(),skills:r.skills??{}}}function Sn(n,e){e.lastUpdated=new Date().toISOString();let t={};for(let s of Object.keys(e.skills).sort())t[s]=e.skills[s];e.skills=t;let r=dr(n,mr),o=fr.dump(e,{lineWidth:-1,sortKeys:!1,quotingType:'"'});oi(r,si+o,"utf-8")}var pr="kanonak.org",gr="skill-to-skill-md",ze=class{parser=new fi;objectParser=new di;runner=new G;async deploy(e){let{instances:t,allKanonaks:r,repository:o,options:s}=e;if(t.length===0){console.error("No Skill instances to deploy.");return}let a=await pi(o,this.objectParser);if(!a){console.error(`Cannot deploy: ${pr}/${gr}@3.0.0 is not installed in the workspace or cache.`);return}let i=await this.runner.run({transformation:a,instances:t,allKanonaks:r,repository:o,parser:this.parser,objectParser:this.objectParser,outputFormat:"markdown-with-frontmatter"});if(i.length===0){console.error("No skills could be transformed from the package.");return}let c=await $e(s,o),l=await $n(s,o),u=Me(c),d=t[0].namespace,{publisher:p,package_:g,version:b}=gi(d);for(let k of i){let y=await Be(k.fileName,s,o),h=He(qe(y,l));ii(y,{recursive:!0}),ui(qe(y,l),k.content,"utf-8"),u.skills[k.fileName]={publisher:p,package_:g,version:b,resolved:p?`kanonak://${p}/${g}@${b}`:"",integrity:mi(k.content)},console.log(`  ${h?"Updated":"Installed"} skill "${k.fileName}" \u2192 ${y}`)}Sn(c,u)}async undeploy(e,t){let{repository:r,options:o}=t,s=await Be(e,o,r);He(s)||(console.error(`Skill "${e}" is not installed at ${s}`),process.exit(1)),ci(s,{recursive:!0,force:!0});let a=await $e(o,r),i=Me(a);delete i.skills[e],Sn(a,i),console.log(`Removed skill "${e}" from ${s}`)}async list(e){let{repository:t,options:r}=e,o=await $e(r,t),s=Me(o),a=[];for(let[c,l]of Object.entries(s.skills))a.push({name:c,publisher:l.publisher,package_:l.package_,version:l.version,path:await Be(c,r,t)});let i=await $n(r,t);if(He(o))try{let c=li(o,{withFileTypes:!0});for(let l of c){if(!l.isDirectory()||s.skills[l.name])continue;let u=qe(o,l.name,i);He(u)&&a.push({name:l.name,publisher:"",package_:"",version:"",path:qe(o,l.name)})}}catch{}return a}};async function pi(n,e){let t=await n.getDocumentsByNamespaceAsync(pr,gr);if(t.length===0)return;let r=new C(t[0],n),o=await e.parseKanonaks(r);return A(o,f.InstanceTransformation)[0]}function gi(n){if(!n)return{publisher:"",package_:"",version:""};let e=n.indexOf("@");if(e===-1)return{publisher:"",package_:"",version:""};let t=n.substring(0,e),r=n.substring(e+1),o=t.indexOf("/");return o===-1?{publisher:"",package_:"",version:""}:{publisher:t.substring(0,o),package_:t.substring(o+1),version:r}}import{mkdirSync as Ai,rmSync as Ri,existsSync as Pn,readdirSync as Ii,writeFileSync as _i,statSync as Ti}from"fs";import{join as Xe}from"path";import{KanonakObjectParser as ji,KanonakParser as xi,computeIntegrity as Ui}from"@kanonak-protocol/sdk";import{join as kr}from"path";import{homedir as yr}from"os";import{KanonakObjectParser as ki}from"@kanonak-protocol/sdk";var Z="kanonak.org",Q="agent-skills",br={publisher:Z,package_:Q,name:"Client"},wr={publisher:Z,package_:Q,name:"clientId"},yi={publisher:Z,package_:Q,name:"projectAgentDir"},hi={publisher:Z,package_:Q,name:"userAgentDir"},bi={publisher:Z,package_:Q,name:"agentFileFormat"},wi="agents";function $i(){if(process.env.CLAUDE_CODE||process.env.CLAUDE_PROJECT_DIR)return"claude-code"}async function We(n,e){let t=(n.client??$i()??wi).toLowerCase(),r=n.scope??"project",o=await Si(t,e);if(!o){let u=await vi(e);throw new Error(`Unknown client "${t}". Known clients: ${u.join(", ")||"(none)"}. Add a Client instance to a package that imports kanonak.org/agent-skills and install that package to make it available.`)}let a=R(o,r==="user"?hi:yi);if(!a)throw new Error(`Client "${t}" has no ${r==="user"?"userAgentDir":"projectAgentDir"} declared.`);let c=ae(o,bi)?.name==="toml"?"toml":"markdown-frontmatter",l=c==="toml"?".toml":".md";return{agentsDir:Pi(a),format:c,fileExtension:l}}var hr=new WeakMap;async function $r(n){let e=hr.get(n);if(e)return e;let t=await n.getDocumentsByNamespaceAsync(Z,Q);if(t.length===0)throw new Error(`Could not find ${Z}/${Q} in the repository. Install a capability that imports agent-skills to populate the cache.`);let o=[...t].sort((c,l)=>{let u=c.metadata.namespace_?.version,d=l.metadata.namespace_?.version;return!u||!d?0:u.major!==d.major?d.major-u.major:u.minor!==d.minor?d.minor-u.minor:d.patch-u.patch})[0],s=new ki,a=new C(o,n),i=await s.parseKanonaks(a);return hr.set(n,i),i}async function Si(n,e){let t=await $r(e),r=A(t,br);for(let o of r)if(R(o,wr)===n)return o}async function vi(n){let e=await $r(n),t=A(e,br),r=[];for(let o of t){let s=R(o,wr);s&&r.push(s)}return r}function Pi(n){return n.startsWith("~/")?kr(yr(),n.slice(2)):n==="~"?yr():n.startsWith("/")||/^[A-Za-z]:[\\/]/.test(n)?n:kr(process.cwd(),n)}import{readFileSync as Ki,writeFileSync as Di,existsSync as Ci}from"fs";import{join as Sr}from"path";import vr from"js-yaml";var Pr="agents.lock",Ei=`# This file is generated by Kanonak CLI. Do not edit manually.
-`;function Ge(n){let e=Sr(n,Pr);if(!Ci(e))return{version:"1",lastUpdated:new Date().toISOString(),agents:{}};let t=Ki(e,"utf-8"),r=vr.load(t);return!r||typeof r!="object"||r.version!=="1"?{version:"1",lastUpdated:new Date().toISOString(),agents:{}}:{version:"1",lastUpdated:r.lastUpdated??new Date().toISOString(),agents:r.agents??{}}}function vn(n,e){e.lastUpdated=new Date().toISOString();let t={};for(let s of Object.keys(e.agents).sort())t[s]=e.agents[s];e.agents=t;let r=Sr(n,Pr),o=vr.dump(e,{lineWidth:-1,sortKeys:!1,quotingType:'"'});Di(r,Ei+o,"utf-8")}var Kr="kanonak.org",Dr="agent-to-agent-file",Je=class{parser=new xi;objectParser=new ji;runner=new G;async deploy(e){let{instances:t,allKanonaks:r,repository:o,options:s}=e;if(t.length===0){console.error("No Agent instances to deploy.");return}let{agentsDir:a,format:i,fileExtension:c}=await We(s,o),l=await Oi(o,this.objectParser);if(!l){console.error(`Cannot deploy: ${Kr}/${Dr}@3.0.0 is not installed in the workspace or cache.`);return}let u=i==="toml"?"toml":"markdown-with-frontmatter",d=await this.runner.run({transformation:l,instances:t,allKanonaks:r,repository:o,parser:this.parser,objectParser:this.objectParser,outputFormat:u});if(d.length===0){console.error("No agents could be transformed from the package.");return}Ai(a,{recursive:!0});let p=Ge(a),g=t[0].namespace,{publisher:b,package_:k,version:y}=Ni(g);for(let h of d){let w=`${h.fileName}${c}`,$=Xe(a,w),v=Pn($);_i($,h.content,"utf-8"),p.agents[h.fileName]={publisher:b,package_:k,version:y,resolved:b?`kanonak://${b}/${k}@${y}`:"",integrity:Ui(h.content),fileName:w},console.log(`  ${v?"Updated":"Installed"} agent "${h.fileName}" \u2192 ${$}`)}vn(a,p)}async undeploy(e,t){let{repository:r,options:o}=t,{agentsDir:s}=await We(o,r),a=Ge(s),i=a.agents[e];i||(console.error(`Agent "${e}" is not installed at ${s}`),process.exit(1));let c=Xe(s,i.fileName);Pn(c)&&Ri(c,{force:!0}),delete a.agents[e],vn(s,a),console.log(`Removed agent "${e}" from ${c}`)}async list(e){let{repository:t,options:r}=e,{agentsDir:o}=await We(r,t),s=Ge(o),a=[];for(let[i,c]of Object.entries(s.agents))a.push({name:i,publisher:c.publisher,package_:c.package_,version:c.version,path:Xe(o,c.fileName)});if(Pn(o))try{let i=Ii(o,{withFileTypes:!0});for(let c of i){if(!c.isFile()||c.name==="agents.lock")continue;let l=Xe(o,c.name),u=Li(c.name);if(!s.agents[u]){try{if(!Ti(l).isFile())continue}catch{continue}a.push({name:u,publisher:"",package_:"",version:"",path:l})}}}catch{}return a}};async function Oi(n,e){let t=await n.getDocumentsByNamespaceAsync(Kr,Dr);if(t.length===0)return;let r=new C(t[0],n),o=await e.parseKanonaks(r);return A(o,f.InstanceTransformation)[0]}function Li(n){let e=n.lastIndexOf(".");return e===-1?n:n.substring(0,e)}function Ni(n){if(!n)return{publisher:"",package_:"",version:""};let e=n.indexOf("@");if(e===-1)return{publisher:"",package_:"",version:""};let t=n.substring(0,e),r=n.substring(e+1),o=t.indexOf("/");return o===-1?{publisher:"",package_:"",version:""}:{publisher:t.substring(0,o),package_:t.substring(o+1),version:r}}var Xi=Mi(Bi(import.meta.url)),Ji=JSON.parse(Vi(Hi(Xi,"..","package.json"),"utf-8")),F=new Fi;F.name("kanonak").description("Kanonak Protocol CLI - Validate and resolve Kanonak ontology packages").version(Ji.version);F.command("validate <path>").description("Validate .kan.yml file(s). Resolves imports via HTTP from publisher domains.").action(async n=>{await An(n)});F.command("install [package]").description("Install a package and its dependencies, or install all from kanonak.lock.").action(async n=>{await Rn(n)});F.command("deps <path>").description("Show resolved dependency tree for a .kan.yml file.").action(async n=>{await _n(n)});F.command("login <publisher>").description("Authenticate with a package publisher using OAuth 2.0.").action(async n=>{await On(n)});F.command("logout <publisher>").description("Revoke tokens and remove stored credentials for a publisher.").action(async n=>{await Ln(n)});F.addCommand(Qn());F.addCommand(Ht());F.addCommand(Jt());async function Yi(){try{let n=new U,e=new qi,t=new Wi,r=Gi(t),o=new zi({fetchFn:r}),s=await O(process.cwd(),e),a=new Ve;a.register("kanonak.org/capabilities/agent-skill-deployment",new ze),a.register("kanonak.org/agent-capabilities/agent-instance-deployment",new Je);let i=await Jn(n,e,s),c=new Fe(n,e,o,r,a,s);Zt(F,i,c)}catch{}}await Yi();F.parse();
+`);let s=new Gs,a=await s.getConfig(r),i=s.resolveIndexUrl(r,a),c=await this.fetchFn(i,r);if(!c.ok){console.error(`Failed to fetch package index from ${r}.`);return}let l=await c.text(),u=bn.parseIndex(l);if(u.size===0){console.error(`No packages found for publisher "${r}".`);return}let d=new Map;for(let[k,y]of u){let h=[...y].sort((w,$)=>{let v=bn.parseVersion(w),K=bn.parseVersion($);return!v||!K?0:v.major!==K.major?K.major-v.major:v.minor!==K.minor?K.minor-v.minor:K.patch-v.patch});d.set(k,h[0])}let p=[],g=0;for(let[k,y]of d){let h=this.fileCache.get(r,k,y);if(!h)try{let w=await this.publisherIndex.getPackageUrl(r,k,y),$=await this.fetchFn(w,r);if(!$.ok)continue;h=await $.text(),this.fileCache.put(r,k,y,h)}catch{continue}try{let w=this.parser.parse(h),$=new C(w,this.repository),v=await this.objectParser.parseKanonaks($),K=A(v,o);for(let V of K)p.push({publisher:r,package_:k,version:y,subject:V});g++}catch{continue}}if(p.length===0){console.log(`No ${L(o)} instances found across ${g} package(s).`);return}console.log(`Found ${p.length} ${L(o)} instance(s) in ${g} package(s):
+`);let b=new Map;for(let k of p){let y=`${k.publisher}/${k.package_}@${k.version}`,h=b.get(y);h?h.push(k):b.set(y,[k])}for(let[k,y]of b){let h=y[0],w=`${h.publisher}/${h.package_}`,$=y.length===1;console.log(`  ${k}`),console.log(`    ${y.length} skill${$?"":"s"}:`);for(let v of y)console.log(`      - ${v.subject.name}`);if(console.log(""),$)console.log("    install:"),console.log(`      kanonak ${e.commandName} add ${w}/${h.subject.name}`);else{console.log("    install one of them:");for(let v of y)console.log(`      kanonak ${e.commandName} add ${w}/${v.subject.name}`);console.log("    install all of them:"),console.log(`      kanonak ${e.commandName} add ${w}`)}console.log("")}}async info(e,t,r){let a=(await this.requireHandler(e).list({repository:this.repository,options:r})).find(i=>i.name===t);a||(console.error(`"${t}" is not installed.`),process.exit(1)),console.log(`Name:      ${a.name}`),console.log(`Type:      ${e.managesTypeKey||"n/a"}`),console.log(`Publisher: ${a.publisher||"unmanaged"}`),console.log(`Package:   ${a.package_||"n/a"}`),console.log(`Version:   ${a.version||"n/a"}`),console.log(`Path:      ${a.path}`)}requireHandler(e){let t=this.handlerRegistry.get(e.deploymentTargetKey);return t||(console.error(`No deployment handler registered for "${e.deploymentTargetKey}". Ensure the capability's deploymentTarget resolves to a DeploymentTarget instance whose URI is registered in the CLI at startup.`),process.exit(1)),t}};function tr(n){if(!n)return;let e=n.split("/");if(e.length===3)return{publisher:e[0],package_:e[1],name:e[2]}}function Js(n,e){let t=n.toLowerCase(),r=e.toLowerCase();if(t===r)return 100;if(r.includes(t)||t.includes(r))return 50;let o=new Set(t.split("-").filter(Boolean)),s=new Set(r.split("-").filter(Boolean)),a=0;for(let c of o)s.has(c)&&a++;if(a>0)return a*10;let i=Ys(t,r);return i===0?100:i<=2?Math.max(1,20-i*5):0}function Ys(n,e){if(n===e)return 0;if(n.length===0)return e.length;if(e.length===0)return n.length;let t=new Array(e.length+1),r=new Array(e.length+1);for(let o=0;o<=e.length;o++)t[o]=o;for(let o=0;o<n.length;o++){r[0]=o+1;for(let s=0;s<e.length;s++){let a=n[o]===e[s]?0:1;r[s+1]=Math.min(r[s]+1,t[s+1]+1,t[s]+a)}for(let s=0;s<=e.length;s++)t[s]=r[s]}return t[e.length]}var Fe=class{handlers=new Map;register(e,t){this.handlers.set(e,t)}get(e){return this.handlers.get(e)??null}};import{mkdirSync as ci,rmSync as li,existsSync as Me,readdirSync as ui,writeFileSync as di}from"fs";import{join as He}from"path";import{KanonakObjectParser as fi,KanonakParser as mi,computeIntegrity as pi}from"@kanonak-protocol/sdk";import{join as wn}from"path";import{homedir as rr}from"os";import{KanonakObjectParser as Zs}from"@kanonak-protocol/sdk";var J="kanonak.org",Y="agent-skills",ar={publisher:J,package_:Y,name:"Client"},sr={publisher:J,package_:Y,name:"clientId"},Qs={publisher:J,package_:Y,name:"projectSkillDir"},ei={publisher:J,package_:Y,name:"userSkillDir"},ni={publisher:J,package_:Y,name:"skillFileName"},ir="agents";async function $e(n,e){let t=(n.client??cr()??ir).toLowerCase(),r=n.scope??"project",o=await ur(t,e);if(!o){let i=await ti(e);throw new Error(`Unknown client "${t}". Known clients: ${i.join(", ")||"(none)"}. Add a Client instance to a package that imports kanonak.org/agent-skills and install that package to make it available.`)}let a=R(o,r==="user"?ei:Qs);if(!a)throw new Error(`Client "${t}" has no ${r==="user"?"userSkillDir":"projectSkillDir"} declared.`);return ri(a)}async function Ve(n,e,t){let r=await $e(e,t);return wn(r,n)}async function $n(n,e){let t=(n.client??cr()??ir).toLowerCase(),r=await ur(t,e);return r?R(r,ni)??"SKILL.md":"SKILL.md"}function cr(){if(process.env.CLAUDE_CODE||process.env.CLAUDE_PROJECT_DIR)return"claude-code"}var or=new WeakMap;async function lr(n){let e=or.get(n);if(e)return e;let t=await n.getDocumentsByNamespaceAsync(J,Y);if(t.length===0)throw new Error(`Could not find ${J}/${Y} in the repository. Install a skill capability (which transitively imports agent-skills) or fetch agent-skills directly to populate the cache.`);let o=[...t].sort((c,l)=>{let u=c.metadata.namespace_?.version,d=l.metadata.namespace_?.version;return!u||!d?0:u.major!==d.major?d.major-u.major:u.minor!==d.minor?d.minor-u.minor:d.patch-u.patch})[0],s=new Zs,a=new C(o,n),i=await s.parseKanonaks(a);return or.set(n,i),i}async function ur(n,e){let t=await lr(e),r=A(t,ar);for(let o of r)if(R(o,sr)===n)return o}async function ti(n){let e=await lr(n),t=A(e,ar),r=[];for(let o of t){let s=R(o,sr);s&&r.push(s)}return r}function ri(n){return n.startsWith("~/")?wn(rr(),n.slice(2)):n==="~"?rr():n.startsWith("/")||/^[A-Za-z]:[\\/]/.test(n)?n:wn(process.cwd(),n)}import{readFileSync as oi,writeFileSync as ai,existsSync as si}from"fs";import{join as dr}from"path";import fr from"js-yaml";var mr="skills.lock",ii=`# This file is generated by Kanonak CLI. Do not edit manually.
+`;function Be(n){let e=dr(n,mr);if(!si(e))return{version:"1",lastUpdated:new Date().toISOString(),skills:{}};let t=oi(e,"utf-8"),r=fr.load(t);return!r||typeof r!="object"||r.version!=="1"?{version:"1",lastUpdated:new Date().toISOString(),skills:{}}:{version:"1",lastUpdated:r.lastUpdated??new Date().toISOString(),skills:r.skills??{}}}function Sn(n,e){e.lastUpdated=new Date().toISOString();let t={};for(let s of Object.keys(e.skills).sort())t[s]=e.skills[s];e.skills=t;let r=dr(n,mr),o=fr.dump(e,{lineWidth:-1,sortKeys:!1,quotingType:'"'});ai(r,ii+o,"utf-8")}var pr="kanonak.org",gr="skill-to-skill-md",qe=class{parser=new mi;objectParser=new fi;runner=new G;async deploy(e){let{instances:t,allKanonaks:r,repository:o,options:s}=e;if(t.length===0){console.error("No Skill instances to deploy.");return}let a=await gi(o,this.objectParser);if(!a){console.error(`Cannot deploy: ${pr}/${gr}@3.0.0 is not installed in the workspace or cache.`);return}let i=await this.runner.run({transformation:a,instances:t,allKanonaks:r,repository:o,parser:this.parser,objectParser:this.objectParser,outputFormat:"markdown-with-frontmatter"});if(i.length===0){console.error("No skills could be transformed from the package.");return}let c=await $e(s,o),l=await $n(s,o),u=Be(c),d=t[0].namespace,{publisher:p,package_:g,version:b}=ki(d);for(let k of i){let y=await Ve(k.fileName,s,o),h=Me(He(y,l));ci(y,{recursive:!0}),di(He(y,l),k.content,"utf-8"),u.skills[k.fileName]={publisher:p,package_:g,version:b,resolved:p?`kanonak://${p}/${g}@${b}`:"",integrity:pi(k.content)},console.log(`  ${h?"Updated":"Installed"} skill "${k.fileName}" \u2192 ${y}`)}Sn(c,u)}async undeploy(e,t){let{repository:r,options:o}=t,s=await Ve(e,o,r);Me(s)||(console.error(`Skill "${e}" is not installed at ${s}`),process.exit(1)),li(s,{recursive:!0,force:!0});let a=await $e(o,r),i=Be(a);delete i.skills[e],Sn(a,i),console.log(`Removed skill "${e}" from ${s}`)}async list(e){let{repository:t,options:r}=e,o=await $e(r,t),s=Be(o),a=[];for(let[c,l]of Object.entries(s.skills))a.push({name:c,publisher:l.publisher,package_:l.package_,version:l.version,path:await Ve(c,r,t)});let i=await $n(r,t);if(Me(o))try{let c=ui(o,{withFileTypes:!0});for(let l of c){if(!l.isDirectory()||s.skills[l.name])continue;let u=He(o,l.name,i);Me(u)&&a.push({name:l.name,publisher:"",package_:"",version:"",path:He(o,l.name)})}}catch{}return a}};async function gi(n,e){let t=await n.getDocumentsByNamespaceAsync(pr,gr);if(t.length===0)return;let r=new C(t[0],n),o=await e.parseKanonaks(r);return A(o,f.InstanceTransformation)[0]}function ki(n){if(!n)return{publisher:"",package_:"",version:""};let e=n.indexOf("@");if(e===-1)return{publisher:"",package_:"",version:""};let t=n.substring(0,e),r=n.substring(e+1),o=t.indexOf("/");return o===-1?{publisher:"",package_:"",version:""}:{publisher:t.substring(0,o),package_:t.substring(o+1),version:r}}import{mkdirSync as Ri,rmSync as Ii,existsSync as Pn,readdirSync as _i,writeFileSync as Ti,statSync as ji}from"fs";import{join as Ge}from"path";import{KanonakObjectParser as xi,KanonakParser as Ui,computeIntegrity as Oi}from"@kanonak-protocol/sdk";import{join as kr}from"path";import{homedir as yr}from"os";import{KanonakObjectParser as yi}from"@kanonak-protocol/sdk";var Z="kanonak.org",Q="agent-skills",br={publisher:Z,package_:Q,name:"Client"},wr={publisher:Z,package_:Q,name:"clientId"},hi={publisher:Z,package_:Q,name:"projectAgentDir"},bi={publisher:Z,package_:Q,name:"userAgentDir"},wi={publisher:Z,package_:Q,name:"agentFileFormat"},$i="agents";function Si(){if(process.env.CLAUDE_CODE||process.env.CLAUDE_PROJECT_DIR)return"claude-code"}async function ze(n,e){let t=(n.client??Si()??$i).toLowerCase(),r=n.scope??"project",o=await vi(t,e);if(!o){let u=await Pi(e);throw new Error(`Unknown client "${t}". Known clients: ${u.join(", ")||"(none)"}. Add a Client instance to a package that imports kanonak.org/agent-skills and install that package to make it available.`)}let a=R(o,r==="user"?bi:hi);if(!a)throw new Error(`Client "${t}" has no ${r==="user"?"userAgentDir":"projectAgentDir"} declared.`);let c=ae(o,wi)?.name==="toml"?"toml":"markdown-frontmatter",l=c==="toml"?".toml":".md";return{agentsDir:Ki(a),format:c,fileExtension:l}}var hr=new WeakMap;async function $r(n){let e=hr.get(n);if(e)return e;let t=await n.getDocumentsByNamespaceAsync(Z,Q);if(t.length===0)throw new Error(`Could not find ${Z}/${Q} in the repository. Install a capability that imports agent-skills to populate the cache.`);let o=[...t].sort((c,l)=>{let u=c.metadata.namespace_?.version,d=l.metadata.namespace_?.version;return!u||!d?0:u.major!==d.major?d.major-u.major:u.minor!==d.minor?d.minor-u.minor:d.patch-u.patch})[0],s=new yi,a=new C(o,n),i=await s.parseKanonaks(a);return hr.set(n,i),i}async function vi(n,e){let t=await $r(e),r=A(t,br);for(let o of r)if(R(o,wr)===n)return o}async function Pi(n){let e=await $r(n),t=A(e,br),r=[];for(let o of t){let s=R(o,wr);s&&r.push(s)}return r}function Ki(n){return n.startsWith("~/")?kr(yr(),n.slice(2)):n==="~"?yr():n.startsWith("/")||/^[A-Za-z]:[\\/]/.test(n)?n:kr(process.cwd(),n)}import{readFileSync as Di,writeFileSync as Ci,existsSync as Ei}from"fs";import{join as Sr}from"path";import vr from"js-yaml";var Pr="agents.lock",Ai=`# This file is generated by Kanonak CLI. Do not edit manually.
+`;function We(n){let e=Sr(n,Pr);if(!Ei(e))return{version:"1",lastUpdated:new Date().toISOString(),agents:{}};let t=Di(e,"utf-8"),r=vr.load(t);return!r||typeof r!="object"||r.version!=="1"?{version:"1",lastUpdated:new Date().toISOString(),agents:{}}:{version:"1",lastUpdated:r.lastUpdated??new Date().toISOString(),agents:r.agents??{}}}function vn(n,e){e.lastUpdated=new Date().toISOString();let t={};for(let s of Object.keys(e.agents).sort())t[s]=e.agents[s];e.agents=t;let r=Sr(n,Pr),o=vr.dump(e,{lineWidth:-1,sortKeys:!1,quotingType:'"'});Ci(r,Ai+o,"utf-8")}var Kr="kanonak.org",Dr="agent-to-agent-file",Xe=class{parser=new Ui;objectParser=new xi;runner=new G;async deploy(e){let{instances:t,allKanonaks:r,repository:o,options:s}=e;if(t.length===0){console.error("No Agent instances to deploy.");return}let{agentsDir:a,format:i,fileExtension:c}=await ze(s,o),l=await Li(o,this.objectParser);if(!l){console.error(`Cannot deploy: ${Kr}/${Dr}@3.0.0 is not installed in the workspace or cache.`);return}let u=i==="toml"?"toml":"markdown-with-frontmatter",d=await this.runner.run({transformation:l,instances:t,allKanonaks:r,repository:o,parser:this.parser,objectParser:this.objectParser,outputFormat:u});if(d.length===0){console.error("No agents could be transformed from the package.");return}Ri(a,{recursive:!0});let p=We(a),g=t[0].namespace,{publisher:b,package_:k,version:y}=Fi(g);for(let h of d){let w=`${h.fileName}${c}`,$=Ge(a,w),v=Pn($);Ti($,h.content,"utf-8"),p.agents[h.fileName]={publisher:b,package_:k,version:y,resolved:b?`kanonak://${b}/${k}@${y}`:"",integrity:Oi(h.content),fileName:w},console.log(`  ${v?"Updated":"Installed"} agent "${h.fileName}" \u2192 ${$}`)}vn(a,p)}async undeploy(e,t){let{repository:r,options:o}=t,{agentsDir:s}=await ze(o,r),a=We(s),i=a.agents[e];i||(console.error(`Agent "${e}" is not installed at ${s}`),process.exit(1));let c=Ge(s,i.fileName);Pn(c)&&Ii(c,{force:!0}),delete a.agents[e],vn(s,a),console.log(`Removed agent "${e}" from ${c}`)}async list(e){let{repository:t,options:r}=e,{agentsDir:o}=await ze(r,t),s=We(o),a=[];for(let[i,c]of Object.entries(s.agents))a.push({name:i,publisher:c.publisher,package_:c.package_,version:c.version,path:Ge(o,c.fileName)});if(Pn(o))try{let i=_i(o,{withFileTypes:!0});for(let c of i){if(!c.isFile()||c.name==="agents.lock")continue;let l=Ge(o,c.name),u=Ni(c.name);if(!s.agents[u]){try{if(!ji(l).isFile())continue}catch{continue}a.push({name:u,publisher:"",package_:"",version:"",path:l})}}}catch{}return a}};async function Li(n,e){let t=await n.getDocumentsByNamespaceAsync(Kr,Dr);if(t.length===0)return;let r=new C(t[0],n),o=await e.parseKanonaks(r);return A(o,f.InstanceTransformation)[0]}function Ni(n){let e=n.lastIndexOf(".");return e===-1?n:n.substring(0,e)}function Fi(n){if(!n)return{publisher:"",package_:"",version:""};let e=n.indexOf("@");if(e===-1)return{publisher:"",package_:"",version:""};let t=n.substring(0,e),r=n.substring(e+1),o=t.indexOf("/");return o===-1?{publisher:"",package_:"",version:""}:{publisher:t.substring(0,o),package_:t.substring(o+1),version:r}}var Ji=Hi(Mi(import.meta.url)),Yi=JSON.parse(Bi(qi(Ji,"..","package.json"),"utf-8")),F=new Vi;F.name("kanonak").description("Kanonak Protocol CLI - Validate and resolve Kanonak ontology packages").version(Yi.version);F.command("validate <path>").description("Validate .kan.yml file(s). Resolves imports via HTTP from publisher domains.").action(async n=>{await An(n)});F.command("install [package]").description("Install a package and its dependencies, or install all from kanonak.lock.").action(async n=>{await Rn(n)});F.command("deps <path>").description("Show resolved dependency tree for a .kan.yml file.").action(async n=>{await _n(n)});F.command("login <publisher>").description("Authenticate with a package publisher using OAuth 2.0.").action(async n=>{await On(n)});F.command("logout <publisher>").description("Revoke tokens and remove stored credentials for a publisher.").action(async n=>{await Ln(n)});F.addCommand(Qn());F.addCommand(Ht());F.addCommand(Jt());async function Zi(){try{let n=new U,e=new zi,t=new Gi,r=Xi(t),o=new Wi({fetchFn:r}),s=await O(process.cwd(),e),a=new Fe;a.register("kanonak.org/capabilities/agent-skill-deployment",new qe),a.register("kanonak.org/agent-capabilities/agent-instance-deployment",new Xe);let i=await Jn(n,e,s),c=new Ne(n,e,o,r,a,s);Zt(F,i,c)}catch{}}await Zi();F.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kanonak-protocol/cli",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Kanonak Protocol CLI - Validate and resolve Kanonak ontology packages",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,8 +34,8 @@
     "semantic-web"
   ],
   "dependencies": {
-    "@kanonak-protocol/sdk": "^3.2.0",
-    "@kanonak-protocol/types": "^3.2.0",
+    "@kanonak-protocol/sdk": "^3.3.0",
+    "@kanonak-protocol/types": "^3.3.0",
     "commander": "^13.0.0",
     "js-yaml": "^4.1.1"
   },