@kanonak-protocol/cli 1.9.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { Command } from 'commander';
|
|
2
|
+
/**
|
|
3
|
+
* Build the `kanonak search` command.
|
|
4
|
+
*
|
|
5
|
+
* kanonak search <publisher>
|
|
6
|
+
* List all packages published under <publisher> (latest version of each).
|
|
7
|
+
*
|
|
8
|
+
* kanonak search <publisher> --type <publisher>/<package>/<Name>
|
|
9
|
+
* Run the OWL 2 RL reasoner over the publisher's catalogue and list
|
|
10
|
+
* every individual classified as the named type. Subclass relationships
|
|
11
|
+
* and declared property characteristics are honoured automatically;
|
|
12
|
+
* "transitive" is the default behaviour because saturation has
|
|
13
|
+
* already propagated `rdf:type` upward through the class hierarchy.
|
|
14
|
+
*/
|
|
15
|
+
export declare function searchCommand(): Command;
|
|
@@ -7,4 +7,24 @@
|
|
|
7
7
|
* in the CLI layer.
|
|
8
8
|
*/
|
|
9
9
|
import { Command } from 'commander';
|
|
10
|
+
import { SubjectKanonak, type Kanonak, type IKanonakDocumentRepository } from '@kanonak-protocol/sdk';
|
|
11
|
+
import { type EntityUri } from '../capabilities/UriHelpers.js';
|
|
10
12
|
export declare function transformCommand(): Command;
|
|
13
|
+
/**
|
|
14
|
+
* @internal exported for tests; not part of the public CLI API.
|
|
15
|
+
*
|
|
16
|
+
* Reasoner-backed instance lookup.
|
|
17
|
+
*
|
|
18
|
+
* Runs the OWL 2 RL / RDFS reasoner over the workspace repository
|
|
19
|
+
* (which carries the imported core-rdf / core-owl vocabulary plus
|
|
20
|
+
* any subClassOf hierarchy declared by user packages), then filters
|
|
21
|
+
* `scopeKanonaks` to the SubjectKanonaks that the saturation
|
|
22
|
+
* classifies as the target class. Subclasses of the target match
|
|
23
|
+
* automatically — this is W3C-canonical RDFS `rdfs9` propagation.
|
|
24
|
+
*
|
|
25
|
+
* Falls back to direct-type matching (`findSubjectsByType`) if the
|
|
26
|
+
* reasoner returns no instances and direct matching does — preserving
|
|
27
|
+
* compatibility for cases where the workspace lacks the vocabulary
|
|
28
|
+
* packages the reasoner needs to recognise `subClassOf` etc.
|
|
29
|
+
*/
|
|
30
|
+
export declare function findCandidateInstances(scopeKanonaks: Kanonak[], matchesClass: EntityUri, repository: IKanonakDocumentRepository): Promise<SubjectKanonak[]>;
|
package/dist/index.js
CHANGED
|
@@ -1,99 +1,99 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{Command as
|
|
3
|
-
`).some(o=>o.trim()===
|
|
4
|
-
${
|
|
5
|
-
`)}else
|
|
6
|
-
`)}getPath(e,
|
|
7
|
-
${u}:`);for(let
|
|
8
|
-
${u}:`),console.log(" ERROR: Failed to parse document"),i++;continue}let g=await a.validateAsync(
|
|
9
|
-
${$}:`);for(let
|
|
10
|
-
${c.length} file(s) validated. ${i} error(s), ${l} warning(s).`),i>0&&process.exit(1)}import{KanonakParser as
|
|
11
|
-
`;function
|
|
12
|
-
Installed ${Object.keys(s.packages).length} package(s) from lock file.`);return}let c=
|
|
13
|
-
Installed ${m.size} package(s).`)}async function
|
|
2
|
+
import{Command as Ws}from"commander";import{readFileSync as Xs}from"fs";import{fileURLToPath as Js}from"url";import{dirname as Ys,join as Zs}from"path";import{KanonakParser as Qs,PublisherIndex as ei,CredentialStore as ni,createAuthenticatedFetch as ti}from"@kanonak-protocol/sdk";import{readFileSync as Qt,statSync as er}from"fs";import{resolve as nr,dirname as tr}from"path";import{KanonakParser as rr,KanonakObjectValidator as or,ValidationSeverity as mn}from"@kanonak-protocol/sdk";import{readFileSync as zt,readdirSync as qt}from"fs";import{join as Gt,dirname as Wt,basename as pn}from"path";import{InMemoryKanonakDocumentRepository as Xt,FileSystemKanonakDocumentRepository as Jt,HttpKanonakDocumentRepository as Yt,getGlobalCachePath as Zt}from"@kanonak-protocol/sdk";import{mkdirSync as Nt,readFileSync as un,writeFileSync as dn,existsSync as Me,appendFileSync as Ft}from"fs";import{join as Mt,dirname as Bt,isAbsolute as Vt}from"path";import{getGlobalCachePath as Ht}from"@kanonak-protocol/sdk";var T=class{constructor(e=Ht()){this.cacheDir=e;this.isProjectLocal=!Vt(e)}cacheDir;gitignoreChecked=!1;isProjectLocal;get(e,t,r){let o=this.getPath(e,t,r);return Me(o)?un(o,"utf-8"):null}put(e,t,r,o){let a=this.getPath(e,t,r);Nt(Bt(a),{recursive:!0}),dn(a,o,"utf-8"),this.isProjectLocal&&this.ensureGitignore()}has(e,t,r){return Me(this.getPath(e,t,r))}ensureGitignore(){if(this.gitignoreChecked)return;this.gitignoreChecked=!0;let e=".gitignore",t=this.cacheDir;if(Me(e)){if(un(e,"utf-8").split(`
|
|
3
|
+
`).some(o=>o.trim()===t||o.trim()===t+"/"))return;Ft(e,`
|
|
4
|
+
${t}/
|
|
5
|
+
`)}else dn(e,`${t}/
|
|
6
|
+
`)}getPath(e,t,r){return Mt(this.cacheDir,e,`${t}@${r}.kan.yml`)}};function ie(n){let e=n;for(;;){let t=Wt(e);if(t===e)break;if(pn(e).includes(".")||pn(t).includes(".")){e=t;continue}break}return e}function ge(n,e){for(let t of qt(n,{withFileTypes:!0})){let r=Gt(n,t.name);t.isDirectory()&&t.name!=="node_modules"&&t.name!==".kanonak"?ge(r,e):t.name.endsWith(".kan.yml")&&e.push(r)}}var Be=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 j(n,e){let t=[];ge(n,t);let r=new Xt(e);for(let c of t)try{let i=zt(c,"utf-8"),l=e.parse(i),u=l.metadata.namespace_;if(u){let d=`${u.publisher}/${u.package_}@${u.version}`;await r.saveDocumentAsync(l,d)}}catch{}let o=new Jt(Zt(),!0,e),a=new T,s=new Yt({getFromCache:(c,i,l)=>a.get(c,i,l),onFetch:(c,i,l,u)=>a.put(c,i,l,u)});return new Be(r,o,s)}async function fn(n){let e=nr(n),t=er(e),r=t.isDirectory()?ie(e):ie(tr(e)),o=new rr,a=new or(o),s=await j(r,o),c=[];if(t.isDirectory()?ge(e,c):c.push(e),c.length===0){console.log("No .kan.yml files found.");return}let i=0,l=0;for(let u of c){let d=Qt(u,"utf-8"),m=o.parseWithErrors(d);if(m.errors&&m.errors.length>0){console.log(`
|
|
7
|
+
${u}:`);for(let h of m.errors)console.log(` ERROR (parse): ${h.message} [line ${h.line}:${h.column}]`),i++;continue}let y=m.document;if(!y){console.log(`
|
|
8
|
+
${u}:`),console.log(" ERROR: Failed to parse document"),i++;continue}let g=await a.validateAsync(y,s),k=g.errors.filter(h=>h.severity===mn.Error),b=g.errors.filter(h=>h.severity===mn.Warning);if(k.length>0||b.length>0){let h=y.metadata.namespace_,$=h?`${h.publisher}/${h.package_}@${h.version}`:u;console.log(`
|
|
9
|
+
${$}:`);for(let S of k)console.log(` ERROR: ${S.message}`),S.suggestion&&console.log(` -> ${S.suggestion}`);for(let S of b)console.log(` WARN: ${S.message}`)}i+=k.length,l+=b.length}console.log(`
|
|
10
|
+
${c.length} file(s) validated. ${i} error(s), ${l} warning(s).`),i>0&&process.exit(1)}import{KanonakParser as ur,PublisherIndex as dr,CredentialStore as pr,createAuthenticatedFetch as mr}from"@kanonak-protocol/sdk";import{readFileSync as ar,writeFileSync as sr,existsSync as ir}from"fs";import{createHash as cr}from"crypto";import gn from"js-yaml";var Ve="kanonak.lock",lr=`# This file is generated by Kanonak CLI. Do not edit manually.
|
|
11
|
+
`;function hn(){if(!ir(Ve))return null;let n=ar(Ve,"utf-8"),e=gn.load(n);return!e||typeof e!="object"||e.version!=="1"?null:{version:"1",lastUpdated:e.lastUpdated??new Date().toISOString(),packages:e.packages??{}}}function kn(n){n.lastUpdated=new Date().toISOString();let e={};for(let r of Object.keys(n.packages).sort())e[r]=n.packages[r];n.packages=e;let t=gn.dump(n,{lineWidth:-1,sortKeys:!1,quotingType:'"'});sr(Ve,lr+t,"utf-8")}function N(n){return`sha256:${cr("sha256").update(n).digest("hex")}`}function W(n){let e=n.indexOf("@"),t,r=null;e!==-1?(t=n.substring(0,e),r=n.substring(e+1)||null):t=n;let o=t.indexOf("/");if(o===-1)return null;let a=t.substring(0,o),s=t.substring(o+1);return!a||!s?null:{publisher:a,packageName:s,version:r}}async function yn(n){let e=new T,t=new ur,r=new pr,o=mr(r),a=new dr({fetchFn:o}),s=hn()??{version:"1",lastUpdated:new Date().toISOString(),packages:{}};if(!n){Object.keys(s.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(s.packages).length} package(s) from kanonak.lock...`);for(let[y,g]of Object.entries(s.packages)){let k=y.indexOf("/"),b=y.substring(0,k),h=y.substring(k+1),$=e.get(b,h,g.version);if($)console.log(` ${y}@${g.version} (cached)`);else{let S=g.resolved,A=await o(S,b);if(!A.ok)throw new Error(`Failed to fetch ${S} (${A.status} ${A.statusText})`);$=await A.text(),e.put(b,h,g.version,$),console.log(` ${y}@${g.version}`)}}console.log(`
|
|
12
|
+
Installed ${Object.keys(s.packages).length} package(s) from lock file.`);return}let c=W(n);c||(console.error(`Invalid package reference: ${n}`),console.error("Expected format: {publisher}/{package}@{version} or {publisher}/{package}"),process.exit(1));let{publisher:i,packageName:l,version:u}=c,d=u??await a.getHighestVersion(i,l);d||(console.error(`Could not resolve version for ${i}/${l}`),process.exit(1)),console.log(`Installing ${i}/${l}@${d}...`);let m=new Set;await bn(i,l,d,e,t,a,o,m,s),kn(s),console.log(`
|
|
13
|
+
Installed ${m.size} package(s).`)}async function bn(n,e,t,r,o,a,s,c,i){let l=`${n}/${e}@${t}`;if(c.has(l))return;c.add(l);let u=`${n}/${e}`,d=r.get(n,e,t),m;if(d)console.log(` ${l} (cached)`),m=await a.getPackageUrl(n,e,t);else{m=await a.getPackageUrl(n,e,t);let k=await s(m,n);if(!k.ok)throw new Error(`Failed to fetch ${m} (${k.status} ${k.statusText})`);d=await k.text(),r.put(n,e,t,d),console.log(` ${l}`)}let y={},g=o.parse(d);if(g.metadata.imports)for(let[k,b]of Object.entries(g.metadata.imports))for(let h of b){let $=await a.resolveVersion(k,h);$?(y[`${k}/${h.packageName}`]=$,await bn(k,h.packageName,$,r,o,a,s,c,i)):console.error(` WARNING: Could not resolve ${k}/${h.packageName} ${h.package_}`)}i.packages[u]={version:t,resolved:m,integrity:N(d),dependencies:y}}import{readFileSync as fr}from"fs";import{resolve as gr,dirname as hr}from"path";import{KanonakParser as kr}from"@kanonak-protocol/sdk";async function wn(n){let e=gr(n),t=fr(e,"utf-8"),r=new kr,o=r.parse(t),a=o.metadata.namespace_,s=a?`${a.publisher}/${a.package_}@${a.version}`:n;if(console.log(s),!o.metadata.imports){console.log(" (no imports)");return}let c=ie(hr(e)),i=await j(c,r),l=new Set;for(let[u,d]of Object.entries(o.metadata.imports))for(let m of d)await Sn(u,m,i,l," ")}async function Sn(n,e,t,r,o){let a=`${n}/${e.packageName}`;if(r.has(a)){console.log(`${o}${a} (${e.package_}) [circular]`);return}r.add(a);let s;try{s=await t.getHighestCompatibleVersionAsync(n,e)}catch{console.log(`${o}${a} (${e.package_}) [fetch failed]`);return}if(!s){console.log(`${o}${a} (${e.package_}) [not found]`);return}let c=s.metadata.namespace_?.version?.toString()??"?";if(console.log(`${o}${n}/${e.packageName}@${c}`),s.metadata.imports)for(let[i,l]of Object.entries(s.metadata.imports))for(let u of l)await Sn(i,u,t,r,o+" ")}import{createHash as br,randomBytes as Dn}from"crypto";import{createServer as wr}from"http";import{execFile as He}from"child_process";import{CredentialStore as Sr,generateDPoPKeyPair as $r,createDPoPProof as $n,serverSupportsDPoP as vr}from"@kanonak-protocol/sdk";import{normalizeHost as yr}from"@kanonak-protocol/sdk";var F=class{cache=new Map;async discover(e){let t=yr(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 a=`https://${t}/.well-known/openid-configuration`;o=await this.tryEndpoint(a)}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 a=o instanceof Error?o.message:String(o);return a.includes("ENOTFOUND")||a.includes("ECONNREFUSED")?(console.error(` OAuth discovery: ${e} \u2014 host unreachable (${a})`),console.error(" If the server is behind a VPN, ensure you are connected.")):a.includes("CERT")||a.includes("SSL")||a.includes("TLS")?(console.error(` OAuth discovery: ${e} \u2014 TLS error (${a})`),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: ${a}`),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:ce(r.issuer),authorizationEndpoint:ce(r.authorization_endpoint),tokenEndpoint:ce(r.token_endpoint),registrationEndpoint:ce(r.registration_endpoint),revocationEndpoint:ce(r.revocation_endpoint),scopesSupported:X(r.scopes_supported),responseTypesSupported:X(r.response_types_supported),grantTypesSupported:X(r.grant_types_supported),codeChallengeMethodsSupported:X(r.code_challenge_methods_supported),tokenEndpointAuthMethodsSupported:X(r.token_endpoint_auth_methods_supported),dpopSigningAlgValuesSupported:X(r.dpop_signing_alg_values_supported)}}};function ce(n){return typeof n=="string"?n:null}function X(n){return Array.isArray(n)?n.filter(e=>typeof e=="string"):null}var Y=class{discovery;credentialStore;constructor(e,t){this.discovery=e??new F,this.credentialStore=t??new Sr}async authorize(e,t=[]){console.log(`Starting OAuth flow for ${e}...`);let r=await this.discovery.discover(e);if(!r)return I(`No OAuth discovery endpoint found for '${e}'.
|
|
14
14
|
The server must expose one of:
|
|
15
15
|
- https://${e}/.well-known/oauth-authorization-server (RFC 8414)
|
|
16
16
|
- https://${e}/.well-known/openid-configuration (OpenID Connect)
|
|
17
17
|
Verify the hostname is correct and HTTPS is configured.
|
|
18
|
-
If using a corporate proxy, ensure it is not blocking the discovery request.`);let o=[];if(r.authorizationEndpoint||o.push("authorization_endpoint"),r.tokenEndpoint||o.push("token_endpoint"),o.length>0)return
|
|
19
|
-
Contact the IDP administrator to ensure these are included in the discovery document.`);let a=
|
|
20
|
-
Ensure your Node.js installation supports EC P-256 curves.`)}}let{redirectUri:c,port:i,waitForCallback:l,close:u}=await
|
|
18
|
+
If using a corporate proxy, ensure it is not blocking the discovery request.`);let o=[];if(r.authorizationEndpoint||o.push("authorization_endpoint"),r.tokenEndpoint||o.push("token_endpoint"),o.length>0)return I(`OAuth metadata for '${e}' is missing required fields: ${o.join(", ")}.
|
|
19
|
+
Contact the IDP administrator to ensure these are included in the discovery document.`);let a=vr(r.dpopSigningAlgValuesSupported),s=null;if(a){console.log(" Server supports DPoP (RFC 9449) \u2014 generating key pair...");try{s=$r()}catch(P){return I(`Failed to generate DPoP key pair: ${J(P)}
|
|
20
|
+
Ensure your Node.js installation supports EC P-256 curves.`)}}let{redirectUri:c,port:i,waitForCallback:l,close:u}=await _r(),d=await this.credentialStore.getCredential(e),m=d?.clientId??null,y=d?.clientSecret??null;if(!m&&r.registrationEndpoint){console.log(" Registering dynamic OAuth client (RFC 7591)...");let P=await this.registerClient(r.registrationEndpoint,c);if(!P.success)return u(),I(P.error);m=P.clientId,y=P.clientSecret??null}if(!m)return u(),I(`No OAuth client credentials for '${e}' and the server does not support dynamic client registration (no registration_endpoint in metadata).
|
|
21
21
|
You must pre-register a client with your IDP and configure the client_id.
|
|
22
22
|
Ask your IDP administrator to enable dynamic client registration (RFC 7591),
|
|
23
|
-
or add a registration_endpoint to the OAuth metadata.`);let g=
|
|
23
|
+
or add a registration_endpoint to the OAuth metadata.`);let g=Ar(),k=Kr(g),b=Cr(),h=Pr(r.authorizationEndpoint,m,c,t,b,k);console.log(` Opening browser for authorization on port ${i}...`),console.log(" If the browser doesn't open, navigate to:"),console.log(` ${h}`),Ir(h);let $=await l();if(u(),!$)return I(`Authorization timed out after 5 minutes.
|
|
24
24
|
The browser authorization was not completed in time.
|
|
25
|
-
Re-run 'kanonak login ${e}' and complete the browser authorization promptly.`);if(!$.code){let
|
|
25
|
+
Re-run 'kanonak login ${e}' and complete the browser authorization promptly.`);if(!$.code){let P=$.error?`: ${$.error}`:"";return I(`No authorization code received${P}.
|
|
26
26
|
The IDP may have rejected the authorization request.
|
|
27
|
-
Check the IDP admin console for error details.`)}if($.state!==
|
|
27
|
+
Check the IDP admin console for error details.`)}if($.state!==b)return I(`Authorization state mismatch \u2014 possible CSRF attack.
|
|
28
28
|
The response did not match the expected session.
|
|
29
|
-
Re-run 'kanonak login ${e}' to start a fresh authorization flow.`);console.log(" Exchanging authorization code for tokens...");let
|
|
29
|
+
Re-run 'kanonak login ${e}' to start a fresh authorization flow.`);console.log(" Exchanging authorization code for tokens...");let S=await this.exchangeCode(r.tokenEndpoint,m,y,$.code,c,g,s);if(!S.success)return I(S.error);let A={clientId:m,clientSecret:y,accessToken:S.tokens.accessToken,refreshToken:S.tokens.refreshToken,expiresAt:S.tokens.expiresIn?new Date(Date.now()+S.tokens.expiresIn*1e3).toISOString():null,tokenEndpoint:r.tokenEndpoint,dpopKeyPair:s};return await this.credentialStore.store(e,A),console.log(` Successfully authenticated with ${e}`),a&&console.log(" DPoP proof-of-possession is active"),{success:!0,host:e}}async refresh(e){let t=await this.credentialStore.getCredential(e);if(!t)return I(`No stored credentials for '${e}'. Run 'kanonak login ${e}' to authenticate first.`);if(!t.refreshToken)return I(`No refresh token available for '${e}'.
|
|
30
30
|
The authorization server may not issue refresh tokens for this client.
|
|
31
|
-
Run 'kanonak login ${e}' to re-authenticate.`);if(!
|
|
32
|
-
The stored credential may be corrupted. Run 'kanonak logout ${e}' then 'kanonak login ${e}'.`);let r=
|
|
31
|
+
Run 'kanonak login ${e}' to re-authenticate.`);if(!t.clientId)return I(`No client ID in stored credentials for '${e}'.
|
|
32
|
+
The stored credential may be corrupted. Run 'kanonak logout ${e}' then 'kanonak login ${e}'.`);let r=t.tokenEndpoint;if(!r){let a=await this.discovery.discover(e);if(!a?.tokenEndpoint)return I(`Cannot find token endpoint for '${e}'.
|
|
33
33
|
The OAuth discovery endpoint may be unreachable.
|
|
34
|
-
Check network connectivity and run 'kanonak login ${e}' to re-authenticate.`);r=a.tokenEndpoint}let o=await this.refreshTokenRequest(r,
|
|
35
|
-
The refresh token may have expired. Run 'kanonak login ${e}' to re-authenticate.`)}async logout(e){let
|
|
36
|
-
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&&
|
|
34
|
+
Check network connectivity and run 'kanonak login ${e}' to re-authenticate.`);r=a.tokenEndpoint}let o=await this.refreshTokenRequest(r,t.clientId,t.clientSecret,t.refreshToken,t.dpopKeyPair);return o.success?(t.accessToken=o.tokens.accessToken,o.tokens.refreshToken&&(t.refreshToken=o.tokens.refreshToken),t.expiresAt=o.tokens.expiresIn?new Date(Date.now()+o.tokens.expiresIn*1e3).toISOString():null,t.tokenEndpoint=r,await this.credentialStore.store(e,t),{success:!0,host:e}):I(`${o.error}
|
|
35
|
+
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 I(`No stored credentials for '${e}'.
|
|
36
|
+
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(s){return{success:!1,error:`Dynamic client registration request to ${e} failed: ${J(s)}
|
|
37
37
|
Ensure the IDP is reachable and HTTPS is properly configured.
|
|
38
38
|
If using a corporate proxy or custom CA, set NODE_EXTRA_CA_CERTS.`}}if(!r.ok){let s=await ze(r);return{success:!1,error:`Dynamic client registration (RFC 7591) failed.
|
|
39
39
|
Endpoint: ${e}
|
|
40
40
|
HTTP ${r.status}: ${s}
|
|
41
41
|
The IDP may not support dynamic registration for public clients.
|
|
42
42
|
Ask your IDP administrator to enable RFC 7591 support, or pre-register a client manually.`}}let o=await r.json(),a=o.client_id;return a?{success:!0,clientId:a,clientSecret:o.client_secret}:{success:!1,error:`Dynamic client registration response from ${e} did not contain a client_id.
|
|
43
|
-
The IDP response may be malformed. Contact your IDP administrator.`}}async exchangeCode(e,
|
|
44
|
-
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:i.toString()})}catch(d){return{success:!1,error:`Token exchange request to ${e} failed: ${
|
|
45
|
-
Ensure the token endpoint is reachable.`}}if(!u.ok){let d=await ze(u),m=
|
|
43
|
+
The IDP response may be malformed. Contact your IDP administrator.`}}async exchangeCode(e,t,r,o,a,s,c){let i=new URLSearchParams({grant_type:"authorization_code",client_id:t,code:o,redirect_uri:a,code_verifier:s});r&&i.set("client_secret",r);let l={"Content-Type":"application/x-www-form-urlencoded"};if(c)try{l.DPoP=$n(c.privateKey,c.publicKey,"POST",e)}catch(d){return{success:!1,error:`Failed to create DPoP proof for token exchange: ${J(d)}
|
|
44
|
+
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:i.toString()})}catch(d){return{success:!1,error:`Token exchange request to ${e} failed: ${J(d)}
|
|
45
|
+
Ensure the token endpoint is reachable.`}}if(!u.ok){let d=await ze(u),m=Dr(d);return{success:!1,error:`Token exchange failed.
|
|
46
46
|
Endpoint: ${e}
|
|
47
47
|
HTTP ${u.status}: ${d}`+(m?`
|
|
48
|
-
${m}`:"")}}return{success:!0,tokens
|
|
49
|
-
Authenticated with ${
|
|
48
|
+
${m}`:"")}}return{success:!0,tokens:vn(await u.json())}}async refreshTokenRequest(e,t,r,o,a){let s=new URLSearchParams({grant_type:"refresh_token",client_id:t,refresh_token:o});r&&s.set("client_secret",r);let c={"Content-Type":"application/x-www-form-urlencoded"};if(a)try{c.DPoP=$n(a.privateKey,a.publicKey,"POST",e)}catch(l){return{success:!1,error:`Failed to create DPoP proof for token refresh: ${J(l)}`}}let i;try{i=await fetch(e,{method:"POST",headers:c,body:s.toString()})}catch(l){return{success:!1,error:`Token refresh request to ${e} failed: ${J(l)}`}}if(!i.ok){let l=await ze(i);return{success:!1,error:`Token refresh failed \u2014 HTTP ${i.status}: ${l}`}}return{success:!0,tokens:vn(await i.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 I(n){return{success:!1,error:n}}function vn(n){return{accessToken:n.access_token,refreshToken:n.refresh_token,expiresIn:typeof n.expires_in=="number"?n.expires_in:void 0}}function J(n){return n instanceof Error?n.message:String(n)}async function ze(n){try{return await n.text()}catch{return"(could not read response body)"}}function Dr(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 Ar(){return Dn(32).toString("base64url")}function Kr(n){return br("sha256").update(n).digest("base64url")}function Cr(){return Dn(16).toString("base64url")}function Pr(n,e,t,r,o,a){let s=new URLSearchParams({client_id:e,response_type:"code",redirect_uri:t,scope:r.join(" "),state:o,code_challenge:a,code_challenge_method:"S256"});return`${n}?${s}`}var Er=300*1e3;async function _r(){return new Promise(n=>{let e=wr((o,a)=>{let s=new URL(o.url,"http://localhost"),c=s.searchParams.get("code")??void 0,i=s.searchParams.get("state")??void 0,l=s.searchParams.get("error")??s.searchParams.get("error_description")??void 0,u=l?Rr(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>";a.writeHead(200,{"Content-Type":"text/html"}),a.end(d),t({code:c,state:i,error:l})}),t,r=new Promise(o=>{t=o,setTimeout(()=>{o(null),e.close()},Er)});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 Rr(n){return n.replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""")}function Ir(n){try{process.platform==="win32"?He("cmd",["/c","start","",n]):process.platform==="darwin"?He("open",[n]):He("xdg-open",[n])}catch{console.log(" Could not open browser automatically. Please navigate to the URL above manually.")}}import{CredentialStore as Tr}from"@kanonak-protocol/sdk";async function An(n){try{let e=new F,t=new Tr,o=await new Y(e,t).authorize(n);o.success?console.log(`
|
|
49
|
+
Authenticated with ${n}.`):(console.error(`
|
|
50
50
|
Authentication failed:
|
|
51
|
-
${o.error}`),process.exit(1))}catch(e){let
|
|
51
|
+
${o.error}`),process.exit(1))}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`
|
|
52
52
|
Authentication failed unexpectedly:
|
|
53
|
-
${
|
|
54
|
-
If this persists, file an issue at https://github.com/kanonak-protocol/typescript/issues`),process.exit(1)}}import{CredentialStore as
|
|
53
|
+
${t}`),console.error(`
|
|
54
|
+
If this persists, file an issue at https://github.com/kanonak-protocol/typescript/issues`),process.exit(1)}}import{CredentialStore as jr}from"@kanonak-protocol/sdk";async function Kn(n){try{let e=new F,t=new jr,o=await new Y(e,t).logout(n);o.success?console.log(`Logged out from ${n}.`):(console.error(`
|
|
55
55
|
Logout failed:
|
|
56
|
-
${o.error}`),process.exit(1))}catch(e){let
|
|
56
|
+
${o.error}`),process.exit(1))}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`
|
|
57
57
|
Logout failed unexpectedly:
|
|
58
|
-
${
|
|
59
|
-
`;function
|
|
60
|
-
Installed capability "${
|
|
61
|
-
`);for(let[n,r]of e)console.log(` ${n} ${r.publisher}/${r.package_}@${r.version}`)}import{Command as pe}from"commander";import{readFileSync as ua,writeFileSync as da,mkdirSync as pa,existsSync as an,statSync as ma}from"fs";import{join as fa,resolve as ga}from"path";import{KanonakParser as tt,KanonakObjectParser as nt}from"@kanonak-protocol/sdk";var uo="kanonak.org",po="document-ast",b=t=>({publisher:uo,package_:po,name:t}),j={Document:b("Document"),Block:b("Block"),Inline:b("Inline"),StructuredValue:b("StructuredValue"),Heading:b("Heading"),Paragraph:b("Paragraph"),RawBlock:b("RawBlock"),Text:b("Text"),StructuredMap:b("StructuredMap"),StructuredEntry:b("StructuredEntry"),StructuredList:b("StructuredList"),StringScalar:b("StringScalar"),IntegerScalar:b("IntegerScalar"),EscapeHint:b("EscapeHint"),MediaType:b("MediaType"),metadata:b("metadata"),children:b("children"),level:b("level"),inlines:b("inlines"),text:b("text"),entries:b("entries"),key:b("key"),value:b("value"),escapeHint:b("escapeHint"),items:b("items"),stringValue:b("stringValue"),integerValue:b("integerValue"),rawContent:b("rawContent"),mediaType:b("mediaType"),mimeType:b("mimeType"),ESC_RAW:b("esc-raw"),ESC_YAML_SAFE:b("esc-yaml-safe"),ESC_TOML_STRING:b("esc-toml-string"),ESC_TOML_MULTILINE:b("esc-toml-multiline"),ESC_JSON:b("esc-json"),TEXT_PLAIN:b("text-plain"),TEXT_MARKDOWN:b("text-markdown"),TEXT_HTML:b("text-html"),APPLICATION_JSON:b("application-json"),TEXT_YAML:b("text-yaml"),IMAGE_SVG_XML:b("image-svg-xml")},mo="kanonak.org",fo="transformations",p=t=>({publisher:mo,package_:fo,name:t}),f={Transformation:p("Transformation"),InputPattern:p("InputPattern"),Expression:p("Expression"),ExpressionKind:p("ExpressionKind"),ExpressionFragment:p("ExpressionFragment"),AstFieldBinding:p("AstFieldBinding"),OutputFormat:p("OutputFormat"),FormatOverride:p("FormatOverride"),RenameEntry:p("RenameEntry"),Artifact:p("Artifact"),NormalizeKind:p("NormalizeKind"),inputPattern:p("inputPattern"),rule:p("rule"),artifactName:p("artifactName"),outputs:p("outputs"),formatOverrides:p("formatOverrides"),matchesClass:p("matchesClass"),requires:p("requires"),kind:p("kind"),astClass:p("astClass"),set:p("set"),iterate:p("iterate"),loopVar:p("loopVar"),emit:p("emit"),condition:p("condition"),thenBuild:p("thenBuild"),elseBuild:p("elseBuild"),parts:p("parts"),stringLiteral:p("stringLiteral"),integerLiteral:p("integerLiteral"),booleanLiteral:p("booleanLiteral"),varName:p("varName"),readSource:p("readSource"),readProp:p("readProp"),traverseSource:p("traverseSource"),through:p("through"),step:p("step"),primary:p("primary"),alternate:p("alternate"),uriNameOf:p("uriNameOf"),listMapSource:p("listMapSource"),mapBody:p("mapBody"),separator:p("separator"),items:p("items"),normSource:p("normSource"),normKind:p("normKind"),checkExpr:p("checkExpr"),refTo:p("refTo"),fragmentRef:p("fragmentRef"),expr:p("expr"),labelTarget:p("labelTarget"),labelSource:p("labelSource"),resolveSource:p("resolveSource"),field:p("field"),bindValue:p("bindValue"),backendUri:p("backendUri"),formatTarget:p("formatTarget"),metadataKeys:p("metadataKeys"),metadataRenames:p("metadataRenames"),trailingNewline:p("trailingNewline"),fromKey:p("fromKey"),toKey:p("toKey"),KIND_BUILD_AST_NODE:p("build-ast-node"),KIND_FOR_EACH:p("for-each"),KIND_WHEN:p("when"),KIND_CONCAT:p("concat"),KIND_STRING_LITERAL:p("string-literal"),KIND_INTEGER_LITERAL:p("integer-literal"),KIND_BOOLEAN_LITERAL:p("boolean-literal"),KIND_VAR_REF:p("var-ref"),KIND_PROPERTY_READ:p("property-read"),KIND_TRAVERSE:p("traverse"),KIND_FALLBACK:p("fallback"),KIND_URI_NAME:p("uri-name"),KIND_LIST_MAP:p("list-map"),KIND_JOIN:p("join"),KIND_NORMALIZE:p("normalize"),KIND_IS_SET:p("is-set"),KIND_URI_LITERAL:p("uri-literal"),KIND_CALL_FRAGMENT:p("call-fragment"),KIND_DISPLAY_LABEL:p("display-label"),KIND_RESOLVE_REF:p("resolve-ref"),NORM_TRIM_END:p("trim-end"),FMT_MARKDOWN_FRONTMATTER:p("markdown-with-frontmatter"),FMT_TOML:p("toml"),FMT_JSON:p("json"),FMT_PLAIN_MARKDOWN:p("plain-markdown")};import{SubjectKanonak as Nt}from"@kanonak-protocol/sdk";var ye=class{constructor(e,n,r){this.repository=e;this.parser=n;this.objectParser=r}repository;parser;objectParser;cache=new Map;async resolveSubject(e,n){let r=he(n,e);if(r)return r;let o=`${e.publisher}/${e.package_}`,a=this.cache.get(o);if(!a){let s=await this.repository.getDocumentsByNamespaceAsync(e.publisher,e.package_);if(s.length===0)return;let c=s[0],i=new D(c,this.repository);a=await this.objectParser.parseKanonaks(i),this.cache.set(o,a)}for(let s of a)if(s instanceof Nt&&s.name===e.name&&s.namespace&&s.namespace.startsWith(`${e.publisher}/${e.package_}@`))return s;for(let s of a)if(s instanceof Nt&&s.name===e.name)return s}};import{DefinedKanonak as Ft,ReferenceKanonak as be,StringStatement as go,NumberStatement as ho,BooleanStatement as ko,ReferenceStatement as yo,EmbeddedStatement as bo,ListStatement as wo}from"@kanonak-protocol/sdk";var we=class extends Error{constructor(e){super(e)}},Se=class{constructor(e,n){this.resolver=e;this.allKanonaks=n}resolver;allKanonaks;async evaluate(e,n){switch(e.kind){case"var-ref":{if(!n.has(e.varName))throw new we(`Unbound variable "${e.varName}"`);return n.get(e.varName)}case"string-literal":return e.value;case"integer-literal":return e.value;case"boolean-literal":return e.value;case"uri-literal":return{...e.refTo};case"property-read":{let r=await this.evaluate(e.source,n);return r instanceof Ft?Xe(r,e.readProp):void 0}case"traverse":{let r=await this.evaluate(e.source,n);if(!(r instanceof Ft))return;let o=Xe(r,e.through),a;if(o instanceof be?a=o.subject:Array.isArray(o)&&o.length>0&&o[0]instanceof be&&(a=o[0].subject),!a)return;let s=await this.resolver.resolveSubject(a,this.allKanonaks);if(!s)return;let c=new Map(n);return c.set("input",s),this.evaluate(e.step,c)}case"fallback":{let r=await this.evaluate(e.primary,n);return Bt(r)?r:this.evaluate(e.alternate,n)}case"uri-name":{let r=await this.evaluate(e.of,n);return r instanceof be?r.subject.name:Vt(r)?r.name:void 0}case"list-map":{let r=await this.evaluate(e.source,n),o=Je(r),a=[];for(let s of o){let c=new Map(n);c.set(e.loopVar,s),a.push(await this.evaluate(e.mapBody,c))}return a}case"join":{let r=await this.evaluate(e.items,n),o=Je(r),a=[];for(let s of o)s!=null&&a.push(String(s));return a.join(e.separator)}case"normalize":{let r=await this.evaluate(e.source,n);return typeof r!="string"?r:e.normKind==="trim-end"?r.trimEnd():r}case"is-set":{let r=await this.evaluate(e.check,n);return Bt(r)}case"when":{let r=await this.evaluate(e.condition,n);return So(r)?this.evaluate(e.thenBuild,n):e.elseBuild?this.evaluate(e.elseBuild,n):void 0}case"concat":{let r=[];for(let o of e.parts){let a=await this.evaluate(o,n);if(a!=null)if(Array.isArray(a))for(let s of a)r.push(s);else r.push(a)}return r}case"for-each":{let r=await this.evaluate(e.iterate,n),o=Je(r),a=[];for(let s of o){let c=new Map(n);c.set(e.loopVar,s);let i=await this.evaluate(e.emit,c);if(i!=null)if(Array.isArray(i))for(let l of i)a.push(l);else a.push(i)}return a}case"build-ast-node":return this.buildAstNode(e,n);case"resolve-ref":{let r=await this.evaluate(e.source,n),o;return r instanceof be?o=r.subject:Vt(r)&&(o=r),o?this.resolver.resolveSubject(o,this.allKanonaks):void 0}case"display-label":{let r={publisher:e.labelTarget.publisher,package_:e.labelTarget.package_,name:e.labelTarget.name},o=await this.resolver.resolveSubject(r,this.allKanonaks);if(o){let a=Xe(o,e.labelSource);if(typeof a=="string"&&a.length>0)return a}return e.labelTarget.name}default:{let r=e;throw new we(`Unhandled expression kind: ${JSON.stringify(r)}`)}}}async buildAstNode(e,n){let r={kind:e.astClass.name};for(let o of e.set){let a=await this.evaluate(o.value,n);if(a==null||Array.isArray(a)&&a.length===0)continue;let s=o.field.name;r[s]=a}return r}};function Xe(t,e){let n=[];for(let o of t.statement){let a=o.predicate;a?.subject&&M(a.subject,e)&&n.push(o)}if(n.length===0)return;if(n.length===1&&n[0]instanceof wo)return n[0].object;if(n.length===1)return Mt(n[0]);let r=[];for(let o of n){let a=Mt(o);a!==void 0&&r.push(a)}return r}function Mt(t){if(t instanceof go||t instanceof ho||t instanceof ko||t instanceof yo||t instanceof bo)return t.object}function Bt(t){return t==null?!1:typeof t=="string"||Array.isArray(t)?t.length>0:!0}function So(t){return t==null?!1:typeof t=="boolean"?t:typeof t=="string"?t.length>0:typeof t=="number"?t!==0:Array.isArray(t)?t.length>0:!0}function Je(t){return t==null?[]:Array.isArray(t)?t:[t]}function Vt(t){return t!==null&&typeof t=="object"&&"publisher"in t&&"package_"in t&&"name"in t}import{EmbeddedKanonak as $o,ReferenceKanonak as Ye,SubjectKanonak as vo,ListStatement as zt,StringStatement as Do,ReferenceStatement as Ze}from"@kanonak-protocol/sdk";var v=class extends Error{constructor(n,r){super(`${n} (at ${r})`);this.path=r}path},Ht=16;function Ao(t){return t.predicate?.subject}function qt(t,e){let n=[];for(let r of t.statement){let o=Ao(r);o&&M(o,e)&&n.push(r)}return n}function x(t,e){let n=B(t,e);if(n)return n;let r=Z(t,e);if(r.length===1&&r[0]instanceof Ye)return r[0].subject}function $e(t,e){let n=Z(t,e),r=[];for(let o of n)o instanceof $o&&r.push(o);return r}function Gt(t,e){let n=[];for(let r of qt(t,e))if(r instanceof Do)n.push(r.object);else if(r instanceof zt)for(let o of r.object)typeof o=="string"?n.push(o):o instanceof Ye&&n.push(o.subject.name);else r instanceof Ze&&n.push(r.object.subject.name);return n}function Co(t,e){let n=t.split("/");if(n.length<3)throw new v(`Invalid property URI "${t}" \u2014 expected publisher/package/name`,e);let[r,o,...a]=n;return{publisher:r,package_:o,name:a.join("/")}}function ee(t,e){let n=t.name,r=`transformation[${n}]`,o={catalog:e,depth:0},a=H(t,f.inputPattern);if(!a)throw new v("Transformation has no inputPattern",r);let s=Ko(a,o,`${r}.inputPattern`),c=H(t,f.rule);if(!c)throw new v("Transformation has no rule",r);let i=Q(c,o,`${r}.rule`),l=H(t,f.artifactName);if(!l)throw new v("Transformation has no artifactName",r);let u=Q(l,o,`${r}.artifactName`),d=new Set;for(let h of qt(t,f.outputs))if(h instanceof Ze)d.add(h.object.subject.name);else if(h instanceof zt)for(let g of h.object)g instanceof Ye&&d.add(g.subject.name);if(d.size===0)throw new v("Transformation has no outputs",r);let m=new Map;for(let h of $e(t,f.formatOverrides)){let g=`${r}.formatOverrides[]`,y=x(h,f.formatTarget);if(!y)throw new v("FormatOverride missing formatTarget",g);m.set(y.name,Eo(h,g))}return{name:n,inputPattern:s,rule:i,artifactName:u,outputs:d,overrides:m}}function Ko(t,e,n){let r=x(t,f.matchesClass);if(!r)throw new v("InputPattern has no matchesClass",n);let o={publisher:r.publisher,package_:r.package_,name:r.name},s=Gt(t,f.requires).map((c,i)=>Co(c,`${n}.requires[${i}]`));return{matchesClass:o,requires:s}}function Eo(t,e){let n=Gt(t,f.metadataKeys),r=n.length>0?n:void 0,o=new Map;for(let c of $e(t,f.metadataRenames)){let i=C(c,f.fromKey),l=C(c,f.toKey);i&&l&&o.set(i,l)}let a=ce(t,f.trailingNewline);return{metadataKeys:r,metadataRenames:o,trailingNewline:typeof a=="boolean"?a:void 0}}function Q(t,e,n){let r=x(t,f.kind);if(!r)throw new v("Expression has no kind",n);let o=r.name;switch(o){case"build-ast-node":return Ro(t,e,n);case"for-each":return Io(t,e,n);case"when":return To(t,e,n);case"concat":return jo(t,e,n);case"string-literal":return{kind:"string-literal",value:le(t,f.stringLiteral,n)};case"integer-literal":return{kind:"integer-literal",value:Fo(t,f.integerLiteral,n)};case"boolean-literal":return{kind:"boolean-literal",value:Mo(t,f.booleanLiteral,n)};case"var-ref":return{kind:"var-ref",varName:le(t,f.varName,n)};case"property-read":return xo(t,e,n);case"traverse":return Uo(t,e,n);case"fallback":return Oo(t,e,n);case"uri-name":return{kind:"uri-name",of:_(t,f.uriNameOf,e,`${n}.uriNameOf`)};case"list-map":return Lo(t,e,n);case"join":return{kind:"join",separator:le(t,f.separator,n),items:_(t,f.items,e,`${n}.items`)};case"normalize":return No(t,e,n);case"is-set":return{kind:"is-set",check:_(t,f.checkExpr,e,`${n}.checkExpr`)};case"uri-literal":{let a=x(t,f.refTo);if(!a)throw new v("uri-literal has no refTo",n);return{kind:"uri-literal",refTo:{publisher:a.publisher,package_:a.package_,name:a.name}}}case"display-label":{let a=x(t,f.labelTarget);if(!a)throw new v("display-label has no labelTarget",n);let s=x(t,f.labelSource);if(!s)throw new v("display-label has no labelSource",n);return{kind:"display-label",labelTarget:{publisher:a.publisher,package_:a.package_,name:a.name},labelSource:{publisher:s.publisher,package_:s.package_,name:s.name}}}case"resolve-ref":return{kind:"resolve-ref",source:_(t,f.resolveSource,e,`${n}.resolveSource`)};case"call-fragment":{if(e.depth>=Ht)throw new v(`call-fragment recursion exceeded ${Ht} levels (cycle?)`,n);let a=x(t,f.fragmentRef);if(!a)throw new v("call-fragment has no fragmentRef",n);let s=Po(e.catalog,a);if(!s)throw new v(`call-fragment: no ExpressionFragment found matching ${a.publisher}/${a.package_}/${a.name} \u2014 either the fragment is missing or its package is not in the compilation catalog`,n);let c=H(s,f.expr);if(!c)throw new v(`ExpressionFragment "${s.name}" has no expr`,n);let i={catalog:e.catalog,depth:e.depth+1};return Q(c,i,`${n}\u2192fragment[${s.name}]`)}default:throw new v(`Unknown ExpressionKind "${o}"`,n)}}function Po(t,e){for(let n of t)if(n instanceof vo&&n.name===e.name&&n.namespace&&n.namespace.startsWith(`${e.publisher}/${e.package_}@`)&&_o(n))return n}function _o(t){for(let e of t.statement){let n=e.predicate;if(!(!n||n.subject?.name!=="type")&&e instanceof Ze){let r=e.object.subject;if(r.publisher===f.ExpressionFragment.publisher&&r.package_===f.ExpressionFragment.package_&&r.name===f.ExpressionFragment.name)return!0}}return!1}function Ro(t,e,n){let r=x(t,f.astClass);if(!r)throw new v("build-ast-node has no astClass",n);let o={publisher:r.publisher,package_:r.package_,name:r.name},a=[];return $e(t,f.set).forEach((c,i)=>{let l=`${n}.set[${i}]`,u=x(c,f.field);if(!u)throw new v("AstFieldBinding has no field",l);let d=_(c,f.bindValue,e,`${l}.bindValue`);a.push({field:{publisher:u.publisher,package_:u.package_,name:u.name},value:d})}),{kind:"build-ast-node",astClass:o,set:a}}function Io(t,e,n){return{kind:"for-each",iterate:_(t,f.iterate,e,`${n}.iterate`),loopVar:le(t,f.loopVar,n),emit:_(t,f.emit,e,`${n}.emit`)}}function To(t,e,n){let r=H(t,f.elseBuild);return{kind:"when",condition:_(t,f.condition,e,`${n}.condition`),thenBuild:_(t,f.thenBuild,e,`${n}.thenBuild`),elseBuild:r?Q(r,e,`${n}.elseBuild`):void 0}}function jo(t,e,n){return{kind:"concat",parts:$e(t,f.parts).map((o,a)=>Q(o,e,`${n}.parts[${a}]`))}}function xo(t,e,n){let r=x(t,f.readProp);if(!r)throw new v("property-read has no readProp",n);return{kind:"property-read",source:_(t,f.readSource,e,`${n}.readSource`),readProp:{publisher:r.publisher,package_:r.package_,name:r.name}}}function Uo(t,e,n){let r=x(t,f.through);if(!r)throw new v("traverse has no through",n);return{kind:"traverse",source:_(t,f.traverseSource,e,`${n}.traverseSource`),through:{publisher:r.publisher,package_:r.package_,name:r.name},step:_(t,f.step,e,`${n}.step`)}}function Oo(t,e,n){return{kind:"fallback",primary:_(t,f.primary,e,`${n}.primary`),alternate:_(t,f.alternate,e,`${n}.alternate`)}}function Lo(t,e,n){return{kind:"list-map",source:_(t,f.listMapSource,e,`${n}.listMapSource`),loopVar:le(t,f.loopVar,n),mapBody:_(t,f.mapBody,e,`${n}.mapBody`)}}function No(t,e,n){let r=x(t,f.normKind);if(!r)throw new v("normalize has no normKind",n);let o=r.name;if(o!=="trim-end")throw new v(`Unknown NormalizeKind "${o}"`,n);return{kind:"normalize",source:_(t,f.normSource,e,`${n}.normSource`),normKind:o}}function _(t,e,n,r){let o=H(t,e);if(!o){let a=`${e.publisher}/${e.package_}/${e.name}`,s=t.statement.length,c=t.statement.some(u=>{let d=u.predicate?.subject;return d&&d.publisher==="kanonak.org"&&d.package_==="transformations"&&d.name==="kind"}),i=`${e.publisher}/${e.package_}`,l;throw s===0?l=" (parent Expression has no statements at all \u2014 the parser produced an empty node, which usually means the containing YAML block did not resolve to an Expression-typed embedded)":c&&s<3?l=` \u2014 expected property ${a} but the parent Expression only has ${s} statement(s) including its 'kind'. The most likely cause is a STALE local copy of the Kanonak package ${i} that declares the expression kind but not the '${e.name}' property. Refresh your workspace copy of ${i} and re-resolve imports so the runner picks up the current property definitions.`:l=` \u2014 expected property ${a}. Parent Expression has ${s} statement(s) but none match that predicate URI. Either the YAML is missing the '${e.name}' key for this expression kind, or your local copy of the Kanonak package ${i} is out of date.`,new v(`missing child expression${l}`,r)}return Q(o,n,r)}function le(t,e,n){let r=C(t,e);if(typeof r!="string")throw new v(`missing required string property "${e.name}"`,n);return r}function Fo(t,e,n){let r=ce(t,e);if(typeof r!="number")throw new v(`missing required integer property "${e.name}"`,n);return r}function Mo(t,e,n){let r=ce(t,e);if(typeof r!="boolean")throw new v(`missing required boolean property "${e.name}"`,n);return r}function Wt(t,e){return t.publisher===e.publisher&&t.package_===e.package_&&t.name===e.name}var ve=class{backendUri="kanonak.org/transformations/markdown-with-frontmatter";render(e,n){let r=Bo(e.metadata,n),o=zo(e.children),s=["---",...r,"---","",o].join(`
|
|
62
|
-
`);return
|
|
58
|
+
${t}`),process.exit(1)}}import{Command as io}from"commander";import{KanonakParser as co,KanonakObjectParser as lo,PublisherIndex as uo,CredentialStore as po,createAuthenticatedFetch as mo}from"@kanonak-protocol/sdk";import{readFileSync as xr,writeFileSync as Ur,existsSync as Or}from"fs";import{join as Lr}from"path";import Cn from"js-yaml";import{getGlobalCachePath as Nr}from"@kanonak-protocol/sdk";var Fr=`# This file is generated by Kanonak CLI. Do not edit manually.
|
|
59
|
+
`;function Pn(){let n=Nr();return Lr(n,"..","capabilities.lock")}function Z(){let n=Pn();if(!Or(n))return{version:"1",lastUpdated:new Date().toISOString(),capabilities:{}};let e=xr(n,"utf-8"),t=Cn.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 qe(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=Cn.dump(n,{lineWidth:-1,sortKeys:!1,quotingType:'"'});Ur(Pn(),Fr+t,"utf-8")}var D=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{KanonakObjectParser as Wr,EmbeddedKanonak as jn,ReferenceKanonak as xn}from"@kanonak-protocol/sdk";import{SubjectKanonak as En,DefinedKanonak as Mr,StringStatement as Br,NumberStatement as Vr,BooleanStatement as Hr,ReferenceStatement as _n,EmbeddedStatement as zr,ListStatement as qr}from"@kanonak-protocol/sdk";function L(n){return`${n.publisher}/${n.package_}/${n.name}`}function M(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}function Gr(n,e){if(!(n instanceof Mr))return!1;for(let t of n.statement)if(t.predicate?.subject?.name==="type"&&t instanceof _n){let o=t.object;if(M(o.subject,e))return!0}return!1}function K(n,e){let t=[];for(let r of n)r instanceof En&&Gr(r,e)&&t.push(r);return t}function he(n,e){for(let t of n){if(!(t instanceof En)||t.name!==e.name)continue;if((t.namespace||"").startsWith(`${e.publisher}/${e.package_}@`))return t}}function ke(n,e){for(let t of n.statement){let r=t.predicate;if(r?.subject&&M(r.subject,e))return t}}function le(n,e){let t=ke(n,e);if(t&&(t instanceof Br||t instanceof Vr||t instanceof Hr))return t.object}function C(n,e){let t=le(n,e);return typeof t=="string"?t:void 0}function B(n,e){let t=ke(n,e);if(t instanceof _n)return t.object.subject}function H(n,e){let t=ke(n,e);if(t instanceof zr)return t.object}function Q(n,e){let t=ke(n,e);return t instanceof qr?t.object??[]:[]}var E="kanonak.org",_="capabilities",Ge={publisher:E,package_:_,name:"Capability"},Xr={publisher:E,package_:_,name:"commandName"},Un={publisher:E,package_:_,name:"description"},Jr={publisher:E,package_:_,name:"managesType"},Yr={publisher:E,package_:_,name:"deploymentTarget"},Zr={publisher:E,package_:_,name:"hasCommand"},Qr={publisher:E,package_:_,name:"subcommandName"},eo={publisher:E,package_:_,name:"performs"},no={publisher:E,package_:_,name:"hasArgument"},to={publisher:E,package_:_,name:"argumentName"},Rn={publisher:E,package_:_,name:"isRequired"},In={publisher:E,package_:_,name:"isOption"},ro={publisher:E,package_:_,name:"defaultValue"};async function On(n,e,t){let r=Z(),o=new Wr,a=[];for(let[s,c]of Object.entries(r.capabilities)){let i=n.get(c.publisher,c.package_,c.version);if(!i){console.error(` WARNING: Cached content missing for capability "${s}" (${c.publisher}/${c.package_}@${c.version})`);continue}try{let l=e.parse(i),u=new D(l,t),d=await o.parseKanonaks(u),m=oo(d,c.publisher,c.package_,c.version);m?a.push(m):console.error(` WARNING: No Capability instance found in "${s}" (${c.publisher}/${c.package_}@${c.version})`)}catch(l){console.error(` WARNING: Failed to parse capability "${s}": ${l}`)}}return a}function oo(n,e,t,r){let o=K(n,Ge);if(o.length===0)return;let a=o[0],s=C(a,Xr)??"",c=C(a,Un)??"",i=B(a,Jr),l=B(a,Yr),u=[];for(let d of Q(a,Zr)){let m=ao(d,n);m&&u.push(m)}return{commandName:s,description:c,managesTypeKey:i?L(i):"",deploymentTargetKey:l?L(l):"",commands:u,publisher:e,package_:t,version:r}}function ao(n,e){let t;if(n instanceof jn)t=n;else if(n instanceof xn){let i=Ln(e,n.subject.publisher,n.subject.package_,n.subject.name);i&&(t=i)}if(!t)return;let r=C(t,Qr)??"",o=C(t,Un)??"",a=B(t,eo),s=Q(t,no),c=[];for(let i of s){let l=so(i,e);l&&c.push(l)}return{subcommandName:r,description:o,arguments:c,actionKey:a?L(a):""}}function so(n,e){let t;if(n instanceof jn)t=n;else if(n instanceof xn){let i=Ln(e,n.subject.publisher,n.subject.package_,n.subject.name);i&&(t=i)}if(!t)return;let r=C(t,to)??"",o=C(t,Rn)==="true"||Tn(t,Rn)===!0,a=C(t,In)==="true"||Tn(t,In)===!0,s=C(t,ro),c={argumentName:r,required:o,isOption:a};return s!==void 0&&(c.defaultValue=s),c}function Tn(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 Ln(n,e,t,r){for(let o of n){if(!("name"in o)||!("namespace"in o))continue;let a=o;if(a.name===r&&!(!a.namespace||typeof a.namespace!="string")&&a.namespace.startsWith(`${e}/${t}@`))return o}}var fo={publisher:E,package_:_,name:"commandName"};function Nn(){let n=new io("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 go(e)}),n.command("remove <name>").description("Remove an installed capability").action(async e=>{await ho(e)}),n.command("list").description("List installed capabilities").action(async()=>{await ko()}),n}async function go(n){let e=W(n);e||(console.error(`Invalid package reference: ${n}`),console.error("Expected format: {publisher}/{package}@{version} or {publisher}/{package}"),process.exit(1));let{publisher:t,packageName:r,version:o}=e,a=new T,s=new co,c=new lo,i=new po,l=mo(i),u=new uo({fetchFn:l}),d=o??await u.getHighestVersion(t,r);d||(console.error(`Could not resolve version for ${t}/${r}`),process.exit(1)),console.log(`Installing capability ${t}/${r}@${d}...`);let m=a.get(t,r,d);if(!m){let P=await u.getPackageUrl(t,r,d),G=await l(P,t);if(!G.ok)throw new Error(`Failed to fetch ${P} (${G.status} ${G.statusText})`);m=await G.text(),a.put(t,r,d,m)}let y=s.parse(m),g=await j(process.cwd(),s),k=new D(y,g),b=await c.parseKanonaks(k),h=K(b,Ge);h.length===0&&(console.error(`Package ${t}/${r}@${d} does not contain a ${E}/${_}/Capability instance.`),process.exit(1));let $=h[0],S=C($,fo);S||(console.error(`Capability instance in ${t}/${r}@${d} has no commandName property.`),process.exit(1));let A=Z();A.capabilities[S]={publisher:t,package_:r,version:d,resolved:await u.getPackageUrl(t,r,d),integrity:N(m)},qe(A),console.log(`
|
|
60
|
+
Installed capability "${S}".`),console.log(`Run "kanonak ${S} --help" to get started.`)}async function ho(n){let e=Z();e.capabilities[n]||(console.error(`Capability "${n}" is not installed.`),process.exit(1));let t=e.capabilities[n];delete e.capabilities[n],qe(e),console.log(`Removed capability "${n}" (${t.publisher}/${t.package_}@${t.version}).`)}async function ko(){let n=Z(),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:
|
|
61
|
+
`);for(let[t,r]of e)console.log(` ${t} ${r.publisher}/${r.package_}@${r.version}`)}import{Command as me}from"commander";import{readFileSync as Sa,writeFileSync as $a,mkdirSync as va,existsSync as st,statSync as Da}from"fs";import{join as Aa,resolve as Ka}from"path";import{KanonakParser as en,KanonakObjectParser as nn,SubjectKanonak as Ca,Reasoner as Pa,KanonakVocabulary as Ea,makeUriKey as it}from"@kanonak-protocol/sdk";var yo="kanonak.org",bo="document-ast",w=n=>({publisher:yo,package_:bo,name:n}),x={Document:w("Document"),Block:w("Block"),Inline:w("Inline"),StructuredValue:w("StructuredValue"),Heading:w("Heading"),Paragraph:w("Paragraph"),RawBlock:w("RawBlock"),Text:w("Text"),StructuredMap:w("StructuredMap"),StructuredEntry:w("StructuredEntry"),StructuredList:w("StructuredList"),StringScalar:w("StringScalar"),IntegerScalar:w("IntegerScalar"),EscapeHint:w("EscapeHint"),MediaType:w("MediaType"),metadata:w("metadata"),children:w("children"),level:w("level"),inlines:w("inlines"),text:w("text"),entries:w("entries"),key:w("key"),value:w("value"),escapeHint:w("escapeHint"),items:w("items"),stringValue:w("stringValue"),integerValue:w("integerValue"),rawContent:w("rawContent"),mediaType:w("mediaType"),mimeType:w("mimeType"),ESC_RAW:w("esc-raw"),ESC_YAML_SAFE:w("esc-yaml-safe"),ESC_TOML_STRING:w("esc-toml-string"),ESC_TOML_MULTILINE:w("esc-toml-multiline"),ESC_JSON:w("esc-json"),TEXT_PLAIN:w("text-plain"),TEXT_MARKDOWN:w("text-markdown"),TEXT_HTML:w("text-html"),APPLICATION_JSON:w("application-json"),TEXT_YAML:w("text-yaml"),IMAGE_SVG_XML:w("image-svg-xml")},wo="kanonak.org",So="transformations",p=n=>({publisher:wo,package_:So,name:n}),f={Transformation:p("Transformation"),InputPattern:p("InputPattern"),Expression:p("Expression"),ExpressionKind:p("ExpressionKind"),ExpressionFragment:p("ExpressionFragment"),AstFieldBinding:p("AstFieldBinding"),OutputFormat:p("OutputFormat"),FormatOverride:p("FormatOverride"),RenameEntry:p("RenameEntry"),Artifact:p("Artifact"),NormalizeKind:p("NormalizeKind"),inputPattern:p("inputPattern"),rule:p("rule"),artifactName:p("artifactName"),outputs:p("outputs"),formatOverrides:p("formatOverrides"),matchesClass:p("matchesClass"),requires:p("requires"),kind:p("kind"),astClass:p("astClass"),set:p("set"),iterate:p("iterate"),loopVar:p("loopVar"),emit:p("emit"),condition:p("condition"),thenBuild:p("thenBuild"),elseBuild:p("elseBuild"),parts:p("parts"),stringLiteral:p("stringLiteral"),integerLiteral:p("integerLiteral"),booleanLiteral:p("booleanLiteral"),varName:p("varName"),readSource:p("readSource"),readProp:p("readProp"),traverseSource:p("traverseSource"),through:p("through"),step:p("step"),primary:p("primary"),alternate:p("alternate"),uriNameOf:p("uriNameOf"),listMapSource:p("listMapSource"),mapBody:p("mapBody"),separator:p("separator"),items:p("items"),normSource:p("normSource"),normKind:p("normKind"),checkExpr:p("checkExpr"),refTo:p("refTo"),fragmentRef:p("fragmentRef"),expr:p("expr"),labelTarget:p("labelTarget"),labelSource:p("labelSource"),resolveSource:p("resolveSource"),field:p("field"),bindValue:p("bindValue"),backendUri:p("backendUri"),formatTarget:p("formatTarget"),metadataKeys:p("metadataKeys"),metadataRenames:p("metadataRenames"),trailingNewline:p("trailingNewline"),fromKey:p("fromKey"),toKey:p("toKey"),KIND_BUILD_AST_NODE:p("build-ast-node"),KIND_FOR_EACH:p("for-each"),KIND_WHEN:p("when"),KIND_CONCAT:p("concat"),KIND_STRING_LITERAL:p("string-literal"),KIND_INTEGER_LITERAL:p("integer-literal"),KIND_BOOLEAN_LITERAL:p("boolean-literal"),KIND_VAR_REF:p("var-ref"),KIND_PROPERTY_READ:p("property-read"),KIND_TRAVERSE:p("traverse"),KIND_FALLBACK:p("fallback"),KIND_URI_NAME:p("uri-name"),KIND_LIST_MAP:p("list-map"),KIND_JOIN:p("join"),KIND_NORMALIZE:p("normalize"),KIND_IS_SET:p("is-set"),KIND_URI_LITERAL:p("uri-literal"),KIND_CALL_FRAGMENT:p("call-fragment"),KIND_DISPLAY_LABEL:p("display-label"),KIND_RESOLVE_REF:p("resolve-ref"),NORM_TRIM_END:p("trim-end"),FMT_MARKDOWN_FRONTMATTER:p("markdown-with-frontmatter"),FMT_TOML:p("toml"),FMT_JSON:p("json"),FMT_PLAIN_MARKDOWN:p("plain-markdown")};import{SubjectKanonak as Fn}from"@kanonak-protocol/sdk";var ye=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=he(t,e);if(r)return r;let o=`${e.publisher}/${e.package_}`,a=this.cache.get(o);if(!a){let s=await this.repository.getDocumentsByNamespaceAsync(e.publisher,e.package_);if(s.length===0)return;let c=s[0],i=new D(c,this.repository);a=await this.objectParser.parseKanonaks(i),this.cache.set(o,a)}for(let s of a)if(s instanceof Fn&&s.name===e.name&&s.namespace&&s.namespace.startsWith(`${e.publisher}/${e.package_}@`))return s;for(let s of a)if(s instanceof Fn&&s.name===e.name)return s}};import{DefinedKanonak as Mn,LiteralKanonak as $o,ReferenceKanonak as be,StringStatement as vo,NumberStatement as Do,BooleanStatement as Ao,ReferenceStatement as Ko,EmbeddedStatement as Co,ListStatement as Po}from"@kanonak-protocol/sdk";var we=class extends Error{constructor(e){super(e)}},Se=class{constructor(e,t){this.resolver=e;this.allKanonaks=t}resolver;allKanonaks;async evaluate(e,t){switch(e.kind){case"var-ref":{if(!t.has(e.varName))throw new we(`Unbound variable "${e.varName}"`);return t.get(e.varName)}case"string-literal":return e.value;case"integer-literal":return e.value;case"boolean-literal":return e.value;case"uri-literal":return{...e.refTo};case"property-read":{let r=await this.evaluate(e.source,t);return r instanceof Mn?We(r,e.readProp):void 0}case"traverse":{let r=await this.evaluate(e.source,t);if(!(r instanceof Mn))return;let o=We(r,e.through),a;if(o instanceof be?a=o.subject:Array.isArray(o)&&o.length>0&&o[0]instanceof be&&(a=o[0].subject),!a)return;let s=await this.resolver.resolveSubject(a,this.allKanonaks);if(!s)return;let c=new Map(t);return c.set("input",s),this.evaluate(e.step,c)}case"fallback":{let r=await this.evaluate(e.primary,t);return Vn(r)?r:this.evaluate(e.alternate,t)}case"uri-name":{let r=await this.evaluate(e.of,t);return r instanceof be?r.subject.name:Hn(r)?r.name:void 0}case"list-map":{let r=await this.evaluate(e.source,t),o=Xe(r),a=[];for(let s of o){let c=new Map(t);c.set(e.loopVar,s),a.push(await this.evaluate(e.mapBody,c))}return a}case"join":{let r=await this.evaluate(e.items,t),o=Xe(r),a=[];for(let s of o)s!=null&&a.push(String(s));return a.join(e.separator)}case"normalize":{let r=await this.evaluate(e.source,t);return typeof r!="string"?r:e.normKind==="trim-end"?r.trimEnd():r}case"is-set":{let r=await this.evaluate(e.check,t);return Vn(r)}case"when":{let r=await this.evaluate(e.condition,t);return Io(r)?this.evaluate(e.thenBuild,t):e.elseBuild?this.evaluate(e.elseBuild,t):void 0}case"concat":{let r=[];for(let o of e.parts){let a=await this.evaluate(o,t);if(a!=null)if(Array.isArray(a))for(let s of a)r.push(s);else r.push(a)}return r}case"for-each":{let r=await this.evaluate(e.iterate,t),o=Xe(r),a=[];for(let s of o){let c=new Map(t);c.set(e.loopVar,s);let i=await this.evaluate(e.emit,c);if(i!=null)if(Array.isArray(i))for(let l of i)a.push(l);else a.push(i)}return a}case"build-ast-node":return this.buildAstNode(e,t);case"resolve-ref":{let r=await this.evaluate(e.source,t),o;return r instanceof be?o=r.subject:Hn(r)&&(o=r),o?this.resolver.resolveSubject(o,this.allKanonaks):void 0}case"display-label":{let r={publisher:e.labelTarget.publisher,package_:e.labelTarget.package_,name:e.labelTarget.name},o=await this.resolver.resolveSubject(r,this.allKanonaks);if(o){let a=We(o,e.labelSource);if(typeof a=="string"&&a.length>0)return a}return e.labelTarget.name}default:{let r=e;throw new we(`Unhandled expression kind: ${JSON.stringify(r)}`)}}}async buildAstNode(e,t){let r={kind:e.astClass.name};for(let o of e.set){let a=await this.evaluate(o.value,t);if(a==null||Array.isArray(a)&&a.length===0)continue;let s=o.field.name;Array.isArray(a)&&Eo.has(s)&&a.every(c=>_o(c))&&(a=a.map(c=>String(c)).join("")),r[s]=a}return r}},Eo=new Set(["stringValue","text","rawContent","key"]);function _o(n){return typeof n=="string"||typeof n=="number"||typeof n=="boolean"}function We(n,e){let t=[];for(let o of n.statement){let a=o.predicate;a?.subject&&M(a.subject,e)&&t.push(o)}if(t.length===0)return;if(t.length===1&&t[0]instanceof Po)return Ro(t[0].object);if(t.length===1)return Bn(t[0]);let r=[];for(let o of t){let a=Bn(o);a!==void 0&&r.push(a)}return r}function Ro(n){let e=[];for(let t of n)t instanceof $o?e.push(t.value):e.push(t);return e}function Bn(n){if(n instanceof vo||n instanceof Do||n instanceof Ao||n instanceof Ko||n instanceof Co)return n.object}function Vn(n){return n==null?!1:typeof n=="string"||Array.isArray(n)?n.length>0:!0}function Io(n){return n==null?!1:typeof n=="boolean"?n:typeof n=="string"?n.length>0:typeof n=="number"?n!==0:Array.isArray(n)?n.length>0:!0}function Xe(n){return n==null?[]:Array.isArray(n)?n:[n]}function Hn(n){return n!==null&&typeof n=="object"&&"publisher"in n&&"package_"in n&&"name"in n}import{EmbeddedKanonak as To,ReferenceKanonak as Je,SubjectKanonak as jo,ListStatement as qn,StringStatement as xo,ReferenceStatement as Ye}from"@kanonak-protocol/sdk";var v=class extends Error{constructor(t,r){super(`${t} (at ${r})`);this.path=r}path},zn=16;function Uo(n){return n.predicate?.subject}function Gn(n,e){let t=[];for(let r of n.statement){let o=Uo(r);o&&M(o,e)&&t.push(r)}return t}function U(n,e){let t=B(n,e);if(t)return t;let r=Q(n,e);if(r.length===1&&r[0]instanceof Je)return r[0].subject}function $e(n,e){let t=Q(n,e),r=[];for(let o of t)o instanceof To&&r.push(o);return r}function Wn(n,e){let t=[];for(let r of Gn(n,e))if(r instanceof xo)t.push(r.object);else if(r instanceof qn)for(let o of r.object)typeof o=="string"?t.push(o):o instanceof Je&&t.push(o.subject.name);else r instanceof Ye&&t.push(r.object.subject.name);return t}function Oo(n,e){let t=n.split("/");if(t.length<3)throw new v(`Invalid property URI "${n}" \u2014 expected publisher/package/name`,e);let[r,o,...a]=t;return{publisher:r,package_:o,name:a.join("/")}}function ne(n,e){let t=n.name,r=`transformation[${t}]`,o={catalog:e,depth:0},a=H(n,f.inputPattern);if(!a)throw new v("Transformation has no inputPattern",r);let s=Lo(a,o,`${r}.inputPattern`),c=H(n,f.rule);if(!c)throw new v("Transformation has no rule",r);let i=ee(c,o,`${r}.rule`),l=H(n,f.artifactName);if(!l)throw new v("Transformation has no artifactName",r);let u=ee(l,o,`${r}.artifactName`),d=new Set;for(let y of Gn(n,f.outputs))if(y instanceof Ye)d.add(y.object.subject.name);else if(y instanceof qn)for(let g of y.object)g instanceof Je&&d.add(g.subject.name);if(d.size===0)throw new v("Transformation has no outputs",r);let m=new Map;for(let y of $e(n,f.formatOverrides)){let g=`${r}.formatOverrides[]`,k=U(y,f.formatTarget);if(!k)throw new v("FormatOverride missing formatTarget",g);m.set(k.name,No(y,g))}return{name:t,inputPattern:s,rule:i,artifactName:u,outputs:d,overrides:m}}function Lo(n,e,t){let r=U(n,f.matchesClass);if(!r)throw new v("InputPattern has no matchesClass",t);let o={publisher:r.publisher,package_:r.package_,name:r.name},s=Wn(n,f.requires).map((c,i)=>Oo(c,`${t}.requires[${i}]`));return{matchesClass:o,requires:s}}function No(n,e){let t=Wn(n,f.metadataKeys),r=t.length>0?t:void 0,o=new Map;for(let c of $e(n,f.metadataRenames)){let i=C(c,f.fromKey),l=C(c,f.toKey);i&&l&&o.set(i,l)}let a=le(n,f.trailingNewline);return{metadataKeys:r,metadataRenames:o,trailingNewline:typeof a=="boolean"?a:void 0}}function ee(n,e,t){let r=U(n,f.kind);if(!r)throw new v("Expression has no kind",t);let o=r.name;switch(o){case"build-ast-node":return Bo(n,e,t);case"for-each":return Vo(n,e,t);case"when":return Ho(n,e,t);case"concat":return zo(n,e,t);case"string-literal":return{kind:"string-literal",value:ue(n,f.stringLiteral,t)};case"integer-literal":return{kind:"integer-literal",value:Yo(n,f.integerLiteral,t)};case"boolean-literal":return{kind:"boolean-literal",value:Zo(n,f.booleanLiteral,t)};case"var-ref":return{kind:"var-ref",varName:ue(n,f.varName,t)};case"property-read":return qo(n,e,t);case"traverse":return Go(n,e,t);case"fallback":return Wo(n,e,t);case"uri-name":return{kind:"uri-name",of:R(n,f.uriNameOf,e,`${t}.uriNameOf`)};case"list-map":return Xo(n,e,t);case"join":return{kind:"join",separator:ue(n,f.separator,t),items:R(n,f.items,e,`${t}.items`)};case"normalize":return Jo(n,e,t);case"is-set":return{kind:"is-set",check:R(n,f.checkExpr,e,`${t}.checkExpr`)};case"uri-literal":{let a=U(n,f.refTo);if(!a)throw new v("uri-literal has no refTo",t);return{kind:"uri-literal",refTo:{publisher:a.publisher,package_:a.package_,name:a.name}}}case"display-label":{let a=U(n,f.labelTarget);if(!a)throw new v("display-label has no labelTarget",t);let s=U(n,f.labelSource);if(!s)throw new v("display-label has no labelSource",t);return{kind:"display-label",labelTarget:{publisher:a.publisher,package_:a.package_,name:a.name},labelSource:{publisher:s.publisher,package_:s.package_,name:s.name}}}case"resolve-ref":return{kind:"resolve-ref",source:R(n,f.resolveSource,e,`${t}.resolveSource`)};case"call-fragment":{if(e.depth>=zn)throw new v(`call-fragment recursion exceeded ${zn} levels (cycle?)`,t);let a=U(n,f.fragmentRef);if(!a)throw new v("call-fragment has no fragmentRef",t);let s=Fo(e.catalog,a);if(!s)throw new v(`call-fragment: no ExpressionFragment found matching ${a.publisher}/${a.package_}/${a.name} \u2014 either the fragment is missing or its package is not in the compilation catalog`,t);let c=H(s,f.expr);if(!c)throw new v(`ExpressionFragment "${s.name}" has no expr`,t);let i={catalog:e.catalog,depth:e.depth+1};return ee(c,i,`${t}\u2192fragment[${s.name}]`)}default:throw new v(`Unknown ExpressionKind "${o}"`,t)}}function Fo(n,e){for(let t of n)if(t instanceof jo&&t.name===e.name&&t.namespace&&t.namespace.startsWith(`${e.publisher}/${e.package_}@`)&&Mo(t))return t}function Mo(n){for(let e of n.statement){let t=e.predicate;if(!(!t||t.subject?.name!=="type")&&e instanceof Ye){let r=e.object.subject;if(r.publisher===f.ExpressionFragment.publisher&&r.package_===f.ExpressionFragment.package_&&r.name===f.ExpressionFragment.name)return!0}}return!1}function Bo(n,e,t){let r=U(n,f.astClass);if(!r)throw new v("build-ast-node has no astClass",t);let o={publisher:r.publisher,package_:r.package_,name:r.name},a=[];return $e(n,f.set).forEach((c,i)=>{let l=`${t}.set[${i}]`,u=U(c,f.field);if(!u)throw new v("AstFieldBinding has no field",l);let d=R(c,f.bindValue,e,`${l}.bindValue`);a.push({field:{publisher:u.publisher,package_:u.package_,name:u.name},value:d})}),{kind:"build-ast-node",astClass:o,set:a}}function Vo(n,e,t){return{kind:"for-each",iterate:R(n,f.iterate,e,`${t}.iterate`),loopVar:ue(n,f.loopVar,t),emit:R(n,f.emit,e,`${t}.emit`)}}function Ho(n,e,t){let r=H(n,f.elseBuild);return{kind:"when",condition:R(n,f.condition,e,`${t}.condition`),thenBuild:R(n,f.thenBuild,e,`${t}.thenBuild`),elseBuild:r?ee(r,e,`${t}.elseBuild`):void 0}}function zo(n,e,t){return{kind:"concat",parts:$e(n,f.parts).map((o,a)=>ee(o,e,`${t}.parts[${a}]`))}}function qo(n,e,t){let r=U(n,f.readProp);if(!r)throw new v("property-read has no readProp",t);return{kind:"property-read",source:R(n,f.readSource,e,`${t}.readSource`),readProp:{publisher:r.publisher,package_:r.package_,name:r.name}}}function Go(n,e,t){let r=U(n,f.through);if(!r)throw new v("traverse has no through",t);return{kind:"traverse",source:R(n,f.traverseSource,e,`${t}.traverseSource`),through:{publisher:r.publisher,package_:r.package_,name:r.name},step:R(n,f.step,e,`${t}.step`)}}function Wo(n,e,t){return{kind:"fallback",primary:R(n,f.primary,e,`${t}.primary`),alternate:R(n,f.alternate,e,`${t}.alternate`)}}function Xo(n,e,t){return{kind:"list-map",source:R(n,f.listMapSource,e,`${t}.listMapSource`),loopVar:ue(n,f.loopVar,t),mapBody:R(n,f.mapBody,e,`${t}.mapBody`)}}function Jo(n,e,t){let r=U(n,f.normKind);if(!r)throw new v("normalize has no normKind",t);let o=r.name;if(o!=="trim-end")throw new v(`Unknown NormalizeKind "${o}"`,t);return{kind:"normalize",source:R(n,f.normSource,e,`${t}.normSource`),normKind:o}}function R(n,e,t,r){let o=H(n,e);if(!o){let a=`${e.publisher}/${e.package_}/${e.name}`,s=n.statement.length,c=n.statement.some(u=>{let d=u.predicate?.subject;return d&&d.publisher==="kanonak.org"&&d.package_==="transformations"&&d.name==="kind"}),i=`${e.publisher}/${e.package_}`,l;throw s===0?l=" (parent Expression has no statements at all \u2014 the parser produced an empty node, which usually means the containing YAML block did not resolve to an Expression-typed embedded)":c&&s<3?l=` \u2014 expected property ${a} but the parent Expression only has ${s} statement(s) including its 'kind'. The most likely cause is a STALE local copy of the Kanonak package ${i} that declares the expression kind but not the '${e.name}' property. Refresh your workspace copy of ${i} and re-resolve imports so the runner picks up the current property definitions.`:l=` \u2014 expected property ${a}. Parent Expression has ${s} statement(s) but none match that predicate URI. Either the YAML is missing the '${e.name}' key for this expression kind, or your local copy of the Kanonak package ${i} is out of date.`,new v(`missing child expression${l}`,r)}return ee(o,t,r)}function ue(n,e,t){let r=C(n,e);if(typeof r!="string")throw new v(`missing required string property "${e.name}"`,t);return r}function Yo(n,e,t){let r=le(n,e);if(typeof r!="number")throw new v(`missing required integer property "${e.name}"`,t);return r}function Zo(n,e,t){let r=le(n,e);if(typeof r!="boolean")throw new v(`missing required boolean property "${e.name}"`,t);return r}function Xn(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var ve=class{backendUri="kanonak.org/transformations/markdown-with-frontmatter";render(e,t){let r=Qo(e.metadata,t),o=ta(e.children),s=["---",...r,"---","",o].join(`
|
|
62
|
+
`);return t?.trailingNewline&&(s.endsWith(`
|
|
63
63
|
`)||(s+=`
|
|
64
|
-
`)),s}};function
|
|
64
|
+
`)),s}};function Qo(n,e){if(!n)return[];let t=new Map;for(let a of n.entries)t.set(a.key,a);let r=e?.metadataKeys??n.entries.map(a=>a.key),o=[];for(let a of r){let s=t.get(a);if(!s)continue;let c=e?.metadataRenames.get(a)??a,i=Yn(s.value,s.escapeHint);i!==void 0&&o.push(`${c}: ${i}`)}return o}function Yn(n,e){switch(n.kind){case"StringScalar":return ea(n.stringValue,e);case"IntegerScalar":return String(n.integerValue);case"StructuredList":{let t=[];for(let r of n.items){let o=Yn(r,e);o!==void 0&&t.push(o)}return t.join(", ")}case"StructuredMap":return;default:return}}function ea(n,e){return!e||Xn(e,x.ESC_RAW)?n:Xn(e,x.ESC_YAML_SAFE)?na(n):n}function na(n){return n.includes(`
|
|
65
65
|
`)?`|-
|
|
66
|
-
${
|
|
67
|
-
`).trimEnd()}`:/[:#\[\]{}&*!|>'"%@`,]/.test(
|
|
66
|
+
${n.replace(/\n/g,`
|
|
67
|
+
`).trimEnd()}`:/[:#\[\]{}&*!|>'"%@`,]/.test(n)?`"${n.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`:n}function ta(n){let e=[];for(let t of n){let r=ra(t);r&&e.push(r)}return e.join(`
|
|
68
68
|
|
|
69
|
-
`)}function
|
|
70
|
-
`);return
|
|
69
|
+
`)}function ra(n){switch(n.kind){case"Heading":return`${"#".repeat(n.level)} ${Jn(n.inlines)}`;case"Paragraph":return Jn(n.inlines);case"RawBlock":return n.rawContent;default:return""}}function Jn(n){let e=[];for(let t of n)t.kind==="Text"&&e.push(t.text);return e.join("")}function oa(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var De=class{backendUri="kanonak.org/transformations/toml";render(e,t){let o=aa(e.metadata,t).join(`
|
|
70
|
+
`);return t?.trailingNewline&&(o.endsWith(`
|
|
71
71
|
`)||(o+=`
|
|
72
|
-
`)),o}};function
|
|
73
|
-
${
|
|
74
|
-
"""`}var Ae=class{backendUri="kanonak.org/transformations/json";render(e,
|
|
72
|
+
`)),o}};function aa(n,e){if(!n)return[];let t=new Map;for(let a of n.entries)t.set(a.key,a);let r=e?.metadataKeys??n.entries.map(a=>a.key),o=[];for(let a of r){let s=t.get(a);if(!s)continue;let c=e?.metadataRenames.get(a)??a,i=Zn(s.value,s.escapeHint);i!==void 0&&o.push(`${c} = ${i}`)}return o}function Zn(n,e){switch(n.kind){case"StringScalar":return sa(n.stringValue,e);case"IntegerScalar":return String(n.integerValue);case"StructuredList":{let t=[];for(let r of n.items){let o=Zn(r,e);o!==void 0&&t.push(o)}return`[${t.join(", ")}]`}case"StructuredMap":return;default:return}}function sa(n,e){return e&&oa(e,x.ESC_TOML_MULTILINE)?ca(n):ia(n)}function ia(n){return`"${n.replace(/\\/g,"\\\\").replace(/"/g,'\\"').replace(/\n/g,"\\n")}"`}function ca(n){return`"""
|
|
73
|
+
${n.replace(/"""/g,'\\"\\"\\"')}
|
|
74
|
+
"""`}var Ae=class{backendUri="kanonak.org/transformations/json";render(e,t){let r=JSON.stringify(e,null,2);return t?.trailingNewline&&!r.endsWith(`
|
|
75
75
|
`)?r+`
|
|
76
|
-
`:r}};function
|
|
76
|
+
`:r}};function et(n){let e=n.replace(/\r\n/g,`
|
|
77
77
|
`).split(`
|
|
78
|
-
`),
|
|
79
|
-
`)),d=i?` class="language-${
|
|
78
|
+
`),t=[],r=0;for(;r<e.length;){let o=e[r];if(o.trim()===""){r++;continue}let a=/^(\s*)```(\S*)\s*$/.exec(o);if(a){let i=a[2],l=[];for(r++;r<e.length&&!/^(\s*)```\s*$/.test(e[r]);)l.push(e[r]),r++;r++;let u=nt(l.join(`
|
|
79
|
+
`)),d=i?` class="language-${tt(i)}"`:"";t.push(`<pre><code${d}>${u}</code></pre>`);continue}let s=/^(#{1,6})\s+(.*)$/.exec(o);if(s){let i=s[1].length,l=te(s[2].trim());t.push(`<h${i}>${l}</h${i}>`),r++;continue}if(o.includes("|")&&r+1<e.length&&Qn(e[r+1])){let i=Ze(o),l=la(e[r+1]);r+=2;let u=[];for(;r<e.length&&e[r].trim()!==""&&e[r].includes("|");)u.push(Ze(e[r])),r++;t.push(ua(i,l,u));continue}if(/^\s*[-*]\s+/.test(o)){let i=[];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++,i.push(`<li>${te(l.join(" ").trim())}</li>`)}t.push(`<ul>
|
|
80
80
|
${i.join(`
|
|
81
81
|
`)}
|
|
82
|
-
</ul>`);continue}if(/^\s*\d+\.\s+/.test(o)){let i=[];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++,i.push(`<li>${te(l.join(" ").trim())}</li>`)}
|
|
82
|
+
</ul>`);continue}if(/^\s*\d+\.\s+/.test(o)){let i=[];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++,i.push(`<li>${te(l.join(" ").trim())}</li>`)}t.push(`<ol>
|
|
83
83
|
${i.join(`
|
|
84
84
|
`)}
|
|
85
|
-
</ol>`);continue}let c=[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&&
|
|
86
|
-
`)}function
|
|
85
|
+
</ol>`);continue}let c=[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&&Qn(e[r+1]));)c.push(e[r]),r++;t.push(`<p>${te(c.join(" "))}</p>`)}return t.join(`
|
|
86
|
+
`)}function Qn(n){return n.includes("-")?/^[\s|:-]+$/.test(n):!1}function Ze(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 la(n){return Ze(n).map(e=>{let t=e.startsWith(":"),r=e.endsWith(":");return t&&r?"center":r?"right":t?"left":null})}function ua(n,e,t){let r=s=>{let c=e[s];return c?` style="text-align:${c}"`:""},o=n.map((s,c)=>`<th${r(c)}>${te(s)}</th>`).join(""),a=t.map(s=>`<tr>${s.map((i,l)=>`<td${r(l)}>${te(i)}</td>`).join("")}</tr>`).join(`
|
|
87
87
|
`);return`<table>
|
|
88
88
|
<thead><tr>${o}</tr></thead>
|
|
89
89
|
<tbody>
|
|
90
90
|
${a}
|
|
91
91
|
</tbody>
|
|
92
|
-
</table>`}function te(
|
|
92
|
+
</table>`}function te(n){let e=nt(n);return e=e.replace(/`([^`\n]+)`/g,(t,r)=>`<code>${r}</code>`),e=e.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g,(t,r,o)=>`<a href="${tt(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 nt(n){return n.replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""").replace(/'/g,"'")}function tt(n){return n.replace(/"/g,""").replace(/&/g,"&")}function Qe(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var Ke=class{backendUri="kanonak.org/transformations/html";render(e,t){let r=da(e.metadata)??"Untitled",o=pa(e.metadata,t),a=ma(e.children),s=`<!DOCTYPE html>
|
|
93
93
|
<html lang="en">
|
|
94
94
|
<head>
|
|
95
95
|
<meta charset="utf-8">
|
|
96
|
-
<title>${
|
|
96
|
+
<title>${de(r)}</title>
|
|
97
97
|
<style>
|
|
98
98
|
body { font-family: -apple-system, Segoe UI, Helvetica, Arial, sans-serif; max-width: 860px; margin: 2rem auto; padding: 0 1rem; color: #222; line-height: 1.55; }
|
|
99
99
|
h1, h2, h3, h4 { line-height: 1.2; }
|
|
@@ -118,18 +118,18 @@ figure.svg-figure svg { max-width: 100%; height: auto; }
|
|
|
118
118
|
${o}${a}
|
|
119
119
|
</body>
|
|
120
120
|
</html>
|
|
121
|
-
`;return
|
|
122
|
-
`)?s.slice(0,-1):s}};function
|
|
121
|
+
`;return t?.trailingNewline===!1&&s.endsWith(`
|
|
122
|
+
`)?s.slice(0,-1):s}};function da(n){if(n){for(let e of n.entries)if((e.key==="title"||e.key==="name")&&e.value.kind==="StringScalar")return e.value.stringValue}}function pa(n,e){if(!n||n.entries.length===0)return"";let t=e?.metadataKeys??n.entries.map(a=>a.key),r=new Map(n.entries.map(a=>[a.key,a])),o=[];for(let a of t){let s=r.get(a);if(!s)continue;let c=e?.metadataRenames.get(a)??a,i=ot(s.value);i!==void 0&&o.push(` <dt>${de(c)}</dt>
|
|
123
123
|
<dd>${i}</dd>`)}return o.length===0?"":`<dl class="metadata">
|
|
124
124
|
${o.join(`
|
|
125
125
|
`)}
|
|
126
126
|
</dl>
|
|
127
|
-
`}function
|
|
128
|
-
`)}function
|
|
129
|
-
${
|
|
130
|
-
</figure>`:`<pre${e?` class="media-${
|
|
127
|
+
`}function ot(n){switch(n.kind){case"StringScalar":return de(n.stringValue);case"IntegerScalar":return String(n.integerValue);case"StructuredList":{let e=[];for(let t of n.items){let r=ot(t);r!==void 0&&e.push(`<code>${r}</code>`)}return e.join(", ")}case"StructuredMap":return;default:return}}function ma(n){let e=[];for(let t of n){let r=fa(t);r&&e.push(r)}return e.join(`
|
|
128
|
+
`)}function fa(n){switch(n.kind){case"Heading":{let e=Math.max(1,Math.min(6,n.level));return`<h${e}>${rt(n.inlines)}</h${e}>`}case"Paragraph":return`<p>${rt(n.inlines)}</p>`;case"RawBlock":return ga(n);default:return""}}function ga(n){let e=n.mediaType;return e&&Qe(e,x.TEXT_MARKDOWN)?et(n.rawContent):e&&Qe(e,x.TEXT_HTML)?n.rawContent:e&&Qe(e,x.IMAGE_SVG_XML)?`<figure class="svg-figure">
|
|
129
|
+
${n.rawContent}
|
|
130
|
+
</figure>`:`<pre${e?` class="media-${ha(e.name)}"`:""}><code>${de(n.rawContent)}</code></pre>`}function rt(n){let e=[];for(let t of n)t.kind==="Text"&&e.push(de(t.text));return e.join("")}function de(n){return n.replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""").replace(/'/g,"'")}function ha(n){return n.replace(/"/g,""").replace(/&/g,"&")}function ka(n,e){return n.publisher===e.publisher&&n.package_===e.package_&&n.name===e.name}var Ce=class{backendUri="kanonak.org/transformations/svg";render(e,t){for(let r of e.children)if(r.kind==="RawBlock"&&r.mediaType&&ka(r.mediaType,x.IMAGE_SVG_XML)){let o=r.rawContent;return t?.trailingNewline&&!o.endsWith(`
|
|
131
131
|
`)&&(o+=`
|
|
132
|
-
`),o}return'<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"/>'}};var
|
|
132
|
+
`),o}return'<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"/>'}};var Pe={"markdown-with-frontmatter":{formatUri:"kanonak.org/transformations/markdown-with-frontmatter",extension:".md"},toml:{formatUri:"kanonak.org/transformations/toml",extension:".toml"},json:{formatUri:"kanonak.org/transformations/json",extension:".json"},"plain-markdown":{formatUri:"kanonak.org/transformations/plain-markdown",extension:".md"},html:{formatUri:"kanonak.org/transformations/html",extension:".html"},svg:{formatUri:"kanonak.org/transformations/svg",extension:".svg"}},re=class extends Error{},V=class{backends=new Map;constructor(){this.register(new ve),this.register(new De),this.register(new Ae),this.register(new Ke),this.register(new Ce)}register(e){this.backends.set(e.backendUri,e)}async run(e){let t=e.transformationKanonaks??e.allKanonaks,r=ne(e.transformation,t);if(!r.outputs.has(e.outputFormat))throw new re(`Transformation "${r.name}" does not support output format "${e.outputFormat}". Declared outputs: ${Array.from(r.outputs).join(", ")}`);let o=new ye(e.repository,e.parser,e.objectParser),a=new Se(o,e.allKanonaks),s=e.instances.filter(u=>ya(u,r)),c=this.findBackendForFormat(e.outputFormat);if(!c)throw new re(`No backend registered for OutputFormat "${e.outputFormat}".`);let i=r.overrides.get(e.outputFormat),l=[];for(let u of s){let d=new Map;d.set("input",u);let m=await a.evaluate(r.rule,d);if(!wa(m))throw new re(`Transformation "${r.name}" rule did not yield a Document for input "${u.name}". Got: ${at(m)}`);let y=await a.evaluate(r.artifactName,d);if(typeof y!="string")throw new re(`Transformation "${r.name}" artifactName did not yield a string for input "${u.name}". Got: ${at(y)}`);let g=c.render(m,i);l.push({fileName:y,format:e.outputFormat,content:g,sourceName:u.name})}return l}findBackendForFormat(e){let t=Pe[e];if(t)return this.backends.get(t.formatUri)}};function ya(n,e){for(let t of e.inputPattern.requires)if(!ba(n,t))return!1;return!0}function ba(n,e){for(let t of n.statement){let r=t.predicate?.subject;if(r&&M(r,e)){let o=t.object;if(o==null||typeof o=="string"&&o.length===0||Array.isArray(o)&&o.length===0)continue;return!0}}return!1}function wa(n){return typeof n=="object"&&n!==null&&n.kind==="Document"&&Array.isArray(n.children)}function at(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 ct(){let n=new me("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",`
|
|
133
133
|
Examples:
|
|
134
134
|
|
|
135
135
|
# List every Transformation available in the local workspace
|
|
@@ -158,12 +158,14 @@ Examples:
|
|
|
158
158
|
|
|
159
159
|
# List the registered format backends
|
|
160
160
|
$ kanonak transform formats
|
|
161
|
-
`);return
|
|
161
|
+
`);return n.addCommand(_a()),n.addCommand(Ta()),n.addCommand(xa()),n.addCommand(Oa()),n}function _a(){return new me("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.").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 Ra(n,e)}catch(t){console.error(`Error: ${t.message}`),process.exit(1)}})}async function Ra(n,e){let t=new en,r=new nn,o=await j(process.cwd(),t),a=await lt(n,o,r),{transformation:s,transformationKanonaks:c}=a;console.log(`Transformation: ${pe(s)}`);let i=ne(s,c),l=await La(e.scope,o,t,r),u=await Ba(l,i.inputPattern.matchesClass,o);console.log(`Scope: ${e.scope} \u2014 found ${u.length} instance(s) of ${i.inputPattern.matchesClass.publisher}/${i.inputPattern.matchesClass.package_}/${i.inputPattern.matchesClass.name}`),u.length===0&&(console.error("No matching input instances in scope. Check the transformation's inputPattern.matchesClass vs. the scope package."),process.exit(1));let d=Ia(i.outputs,e.format);console.log(`Output format: ${d}`);let m=Pe[d];if(!m)throw new Error(`Unknown format "${d}". Run \`kanonak transform formats\` to see what the runner supports.`);let g=await new V().run({transformation:s,instances:u,allKanonaks:l,transformationKanonaks:c,repository:o,parser:t,objectParser:r,outputFormat:d}),k=Ka(e.out);va(k,{recursive:!0});for(let b of g){let h=Ma(b.fileName),$=Aa(k,`${h}${m.extension}`);$a($,b.content,"utf-8"),console.log(` wrote ${$}`)}console.log(`Done. ${g.length} artifact(s) written to ${k}`)}function Ia(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 Ta(){return new me("list").description("Scan the local workspace + cache for every Transformation instance and print a one-line summary per hit.").action(async()=>{try{await ja()}catch(n){console.error(`Error: ${n.message}`),process.exit(1)}})}async function ja(){let n=new en,e=new nn,t=await j(process.cwd(),n),r=await t.getAllDocumentsAsync(),o=[];for(let a of r)try{let s=new D(a,t),c=await e.parseKanonaks(s),i=K(c,f.Transformation);for(let l of i)o.push(Fa(l,c))}catch{}if(o.length===0){console.log("No Transformation instances found in the current workspace.");return}o.sort((a,s)=>a.uri.localeCompare(s.uri));for(let a of o)console.log(`${a.uri}`),console.log(` matches: ${a.matchesClass}`),console.log(` outputs: ${a.outputs.join(", ")}`)}function xa(){return new me("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 Ua(n)}catch(e){console.error(`Error: ${e.message}`),process.exit(1)}})}async function Ua(n){let e=new en,t=new nn,r=await j(process.cwd(),e),{transformation:o,transformationKanonaks:a}=await lt(n,r,t),s=ne(o,a);if(console.log(`Transformation: ${pe(o)}`),console.log(),console.log("Input pattern:"),console.log(` Matches class: ${Ee(s.inputPattern.matchesClass)}`),s.inputPattern.requires.length>0){console.log(" Required properties:");for(let c of s.inputPattern.requires)console.log(` - ${Ee(c)}`)}else console.log(" Required properties: (none)");if(console.log(),console.log(`Outputs: ${Array.from(s.outputs).sort().join(", ")}`),console.log(),s.overrides.size>0){console.log("Format overrides:");for(let[c,i]of s.overrides){if(console.log(` ${c}:`),i.metadataKeys&&console.log(` metadata keys: ${i.metadataKeys.join(", ")}`),i.metadataRenames.size>0){let l=[];for(let[u,d]of i.metadataRenames)l.push(`${u} \u2192 ${d}`);console.log(` metadata renames: ${l.join(", ")}`)}i.trailingNewline!==void 0&&console.log(` trailing newline: ${i.trailingNewline}`)}console.log()}console.log(`Rule root kind: ${s.rule.kind}`),s.rule.kind==="build-ast-node"&&(console.log(`Rule root AST class: ${Ee(s.rule.astClass)}`),console.log(`Rule root bindings: ${s.rule.set.length} field(s)`)),console.log(`Artifact name root kind: ${s.artifactName.kind}`)}function Oa(){return new me("formats").description("List the OutputFormat names the runner can serialize to.").action(()=>{console.log("Registered format backends:");let n=Object.entries(Pe).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 lt(n,e,t){let r,o,a;if(n.includes("/")){let i=n.indexOf("@"),l=n;if(i!==-1){let d=n.indexOf("/",i);if(d===-1)throw new Error(`Transformation URI "${n}" has @version but no trailing /<name>`);l=n.substring(0,i)+n.substring(d)}let u=l.split("/");if(u.length<3)throw new Error(`Invalid transformation URI "${n}" \u2014 expected publisher/package/name or publisher/package@version/name`);r=u[0],o=u[1],a=u.slice(2).join("/")}else a=n;if(r&&o){let i=await e.getDocumentsByNamespaceAsync(r,o);if(i.length===0)throw new Error(`Package ${r}/${o} not found in the local workspace or cache.`);let l=Na(n),u=ut(i,l,`${r}/${o}`),d=new D(u,e),m=await t.parseKanonaks(d),y=he(m,{publisher:r,package_:o,name:a,version:""});if(!y){let g=K(m,f.Transformation),k=g.find(b=>b.name===a);if(!k)throw new Error(`Transformation "${a}" not found in package ${r}/${o}. Package contains ${g.length} Transformation(s): ${g.map(b=>b.name).join(", ")||"(none)"}`);return{transformation:k,transformationKanonaks:m}}return{transformation:y,transformationKanonaks:m}}let s=await e.getAllDocumentsAsync(),c=[];for(let i of s)try{let l=new D(i,e),u=await t.parseKanonaks(l),d=K(u,f.Transformation);for(let m of d)m.name===a&&c.push({tx:m,kanonaks:u})}catch{}if(c.length===0)throw new Error(`No Transformation named "${a}" found in the workspace. Try \`kanonak transform list\` to see available transformations.`);if(c.length>1){let i=c.map(l=>pe(l.tx)).join(`
|
|
162
162
|
`);throw new Error(`Multiple Transformations named "${a}" in the workspace \u2014 disambiguate with a full publisher/package/name URI:
|
|
163
|
-
${i}`)}return{transformation:c[0].tx,transformationKanonaks:c[0].kanonaks}}async function
|
|
164
|
-
`);
|
|
165
|
-
|
|
166
|
-
`);let
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
163
|
+
${i}`)}return{transformation:c[0].tx,transformationKanonaks:c[0].kanonaks}}async function La(n,e,t,r){if(/^[.\/\\]/.test(n)||/^[A-Za-z]:/.test(n)||n.endsWith(".kan.yml")||st(n)&&Da(n).isFile()){if(!st(n))throw new Error(`Scope file not found: ${n}`);let g=Sa(n,"utf-8"),k=t.parse(g),b=new D(k,e);return r.parseKanonaks(b)}let a=n.indexOf("@"),s=a===-1?n:n.substring(0,a),c=a===-1?void 0:n.substring(a+1),i=s.indexOf("/");if(i===-1)throw new Error(`Invalid scope "${n}" \u2014 expected a file path or publisher/package[@version] URI`);let l=s.substring(0,i),u=s.substring(i+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 m=ut(d,c,`${l}/${u}`),y=new D(m,e);return r.parseKanonaks(y)}function Na(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 ut(n,e,t){function r(s){let c=s.metadata.namespace_?.version;return c?`${c.major}.${c.minor}.${c.patch}`:""}if(e){let s=n.find(i=>r(i)===e);if(s)return s;let c=n.map(r).filter(Boolean).sort().join(", ");throw new Error(`${t}@${e} not found in the local workspace or cache. Available versions: ${c||"(none with parseable namespace)"}`)}if(n.length===1)return n[0];let a=[...n].sort((s,c)=>{let i=s.metadata.namespace_?.version,l=c.metadata.namespace_?.version;return!i||!l?0:i.major!==l.major?l.major-i.major:i.minor!==l.minor?l.minor-i.minor:l.patch-i.patch})[0];return console.warn(`Warning: ${t} has ${n.length} versions present (${n.map(r).filter(Boolean).join(", ")}); using @${r(a)}. Pin with ${t}@<version> to suppress this warning.`),a}function Fa(n,e){try{let t=ne(n,e);return{uri:pe(n),matchesClass:Ee(t.inputPattern.matchesClass),outputs:Array.from(t.outputs).sort()}}catch(t){return{uri:pe(n),matchesClass:`(compile error: ${t.message})`,outputs:[]}}}function pe(n){let e=n.namespace||"",t=e.indexOf("@");return`${t===-1?e:e.substring(0,t)}/${n.name}`}function Ee(n){return`${n.publisher}/${n.package_}/${n.name}`}function Ma(n){return n.replace(/[\\/:*?"<>|\s]+/g,"_").replace(/^_+|_+$/g,"")}async function Ba(n,e,t){let r=new Map;for(let s of n){if(!(s instanceof Ca))continue;let c=Va(s);c&&r.set(c,s)}let o=[];try{o=(await new Pa({vocabulary:new Ea}).reason(t)).getInstancesOfClass(it(e.publisher,e.package_,e.name))}catch{}let a=[];for(let s of o){let c=r.get(s);c&&a.push(c)}return a.length>0?a:K(n,e)}function Va(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:it(r.substring(0,o),r.substring(o+1),n.name)}import{Command as Ha}from"commander";import{KanonakParser as za,PublisherIndex as dt,CredentialStore as pt,createAuthenticatedFetch as mt,FileSystemKanonakDocumentRepository as qa,Reasoner as Ga,KanonakVocabulary as Wa,getGlobalCachePath as Xa,makeUriKey as Ja}from"@kanonak-protocol/sdk";function Ya(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 ft(){return new Ha("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 Qa(n,e.type):await Za(n)})}async function Za(n){let e=new pt,t=mt(e),r=new dt({fetchFn:t}),o;try{o=await r.listLatestPackages(n)}catch(s){console.error(`Failed to fetch publisher index for ${n}: ${s.message}`),process.exit(1)}if(o.length===0){console.log(`No packages found at ${n}.`);return}console.log(`Packages published by ${n}:
|
|
164
|
+
`);let a=o.reduce((s,c)=>Math.max(s,c.packageName.length),0);for(let{packageName:s,version:c}of o)console.log(` ${s.padEnd(a)} @${c}`)}async function Qa(n,e){let t=Ya(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 za,o=new pt,a=mt(o),s=new dt({fetchFn:a}),c=new T,i=new Set,l=[];try{l=await s.listLatestPackages(n)}catch(b){console.error(`Failed to fetch publisher index for ${n}: ${b.message}`),process.exit(1)}for(let{packageName:b,version:h}of l)i.add(`${n}|${b}|${h}`);await tn(s,c,a,"kanonak.org","core-rdf",i),await tn(s,c,a,"kanonak.org","core-owl",i),await tn(s,c,a,t.publisher,t.package_,i);for(let b of i){let[h,$,S]=b.split("|");if(!c.has(h,$,S))try{let A=await s.getPackageUrl(h,$,S),P=await a(A,h);if(!P.ok){console.error(`Warning: failed to fetch ${h}/${$}@${S}: ${P.status} ${P.statusText}`);continue}let G=await P.text();c.put(h,$,S,G)}catch(A){console.error(`Warning: failed to fetch ${h}/${$}@${S}: ${A.message}`)}}let u=new qa(Xa(),!0,r),m=await new Ga({vocabulary:new Wa}).reason(u),y=Ja(t.publisher,t.package_,t.name),k=m.getInstancesOfClass(y).filter(b=>b!==y);if(k.length===0){console.log(`No instances of ${y} found in ${n}'s catalogue.`);return}console.log(`Instances of ${y} in ${n}'s catalogue:
|
|
165
|
+
`),k.sort();for(let b of k)console.log(` ${b}`)}async function tn(n,e,t,r,o,a){try{let s=await n.getHighestVersion(r,o);if(!s)return;a.add(`${r}|${o}|${s}`)}catch{}}import{Command as gt}from"commander";function oe(n){return`${E}/${_}/${n}`}var rn={[oe("fetch-and-deploy")]:(n,e,t,r)=>n.add(e,t[0],r),[oe("remove-deployed")]:(n,e,t,r)=>n.remove(e,t[0],r),[oe("list-deployed")]:(n,e,t,r)=>n.list(e,r),[oe("update-deployed")]:(n,e,t,r)=>n.update(e,t[0],r),[oe("search-available")]:(n,e,t,r)=>n.search(e,r),[oe("show-info")]:(n,e,t,r)=>n.info(e,t[0],r)};function ht(n,e,t){for(let r of e){let o=new gt(r.commandName).description(r.description.trim());for(let a of r.commands){let s=o.command(es(a));s.description(a.description);for(let c of a.arguments)if(c.isOption){let i=c.defaultValue!=null?`--${c.argumentName} [value]`:`--${c.argumentName} <value>`;s.option(i,"",c.defaultValue)}s.action(async(...c)=>{let i=ns(c);await ts(t,r,a,c,i)})}n.addCommand(o)}}function es(n){let e=n.arguments.filter(t=>!t.isOption).map(t=>t.required?`<${t.argumentName}>`:`[${t.argumentName}]`);return[n.subcommandName,...e].join(" ")}function ns(n){for(let e=n.length-1;e>=0;e--)if(n[e]&&typeof n[e]=="object"&&!(n[e]instanceof gt))return n[e];return{}}async function ts(n,e,t,r,o){let a=[];for(let c of r)if(typeof c=="string")a.push(c);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(rn).join(", ")}.`),process.exit(1));let s=rn[t.actionKey];s||(console.error(`Capability subcommand '${t.subcommandName}' references unknown Action '${t.actionKey}'. Known actions: ${Object.keys(rn).join(", ")}.`),process.exit(1)),await s(n,e,a,o)}import{KanonakObjectParser as rs,PublisherIndex as on,PublisherConfigResolver as os}from"@kanonak-protocol/sdk";var _e=class{constructor(e,t,r,o,a,s){this.fileCache=e;this.parser=t;this.publisherIndex=r;this.fetchFn=o;this.handlerRegistry=a;this.repository=s}fileCache;parser;publisherIndex;fetchFn;handlerRegistry;repository;objectParser=new rs;async add(e,t,r){let o=W(t);o||(console.error(`Invalid package reference: ${t}`),console.error("Expected format: {publisher}/{package}@{version} or {publisher}/{package}"),process.exit(1));let{publisher:a,packageName:s,version:c}=o,i=c??await this.publisherIndex.getHighestVersion(a,s);i||(console.error(`Could not resolve version for ${a}/${s}`),process.exit(1));let l=this.fileCache.get(a,s,i);if(!l){let b=await this.publisherIndex.getPackageUrl(a,s,i),h=await this.fetchFn(b,a);if(!h.ok)throw new Error(`Failed to fetch ${b} (${h.status} ${h.statusText})`);l=await h.text(),this.fileCache.put(a,s,i,l)}let u=this.parser.parse(l),d=new D(u,this.repository),m=await this.objectParser.parseKanonaks(d),y=kt(e.managesTypeKey);y||(console.error(`Capability "${e.commandName}" has no resolved managesType.`),process.exit(1));let g=K(m,y);g.length===0&&(console.error(`Package ${a}/${s}@${i} does not contain any ${L(y)} instances.`),process.exit(1));let k=this.handlerRegistry.get(e.deploymentTargetKey);k?await k.deploy({instances:g,allKanonaks:m,repository:this.repository,options:r}):console.log(`Cached ${a}/${s}@${i} (no deployment handler for "${e.deploymentTargetKey}")`)}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}),a=e.managesTypeKey||"managed";if(o.length===0){console.log(`No ${a} instances installed.`);return}console.log(`Installed ${a} instances:
|
|
166
|
+
`);for(let s of o){let c=s.publisher?`${s.publisher}/${s.package_}@${s.version}`:"unmanaged";console.log(` ${s.name} (${c}) ${s.path}`)}}async update(e,t,r){let a=await this.requireHandler(e).list({repository:this.repository,options:r}),s=t?a.filter(i=>i.name===t):a.filter(i=>i.publisher);if(s.length===0){console.log(t?`"${t}" not found.`:"No managed instances to update.");return}let c=0;for(let i of s){let l=await this.publisherIndex.getHighestVersion(i.publisher,i.package_);!l||l===i.version||(console.log(`Updating ${i.name}: ${i.version} \u2192 ${l}`),await this.add(e,`${i.publisher}/${i.package_}@${l}`,r),c++)}console.log(c===0?"All instances are up to date.":`
|
|
167
|
+
Updated ${c} instance(s).`)}async search(e,t){let r=t.publisher??"kanonak.org",o=kt(e.managesTypeKey);if(!o){console.error("Capability has no resolved managesType; nothing to search for.");return}console.log(`Searching ${r} for ${L(o)} instances...
|
|
168
|
+
`);let a=new os,s=await a.getConfig(r),c=a.resolveIndexUrl(r,s),i=await this.fetchFn(c,r);if(!i.ok){console.error(`Failed to fetch package index from ${r}.`);return}let l=await i.text(),u=on.parseIndex(l);if(u.size===0){console.error(`No packages found for publisher "${r}".`);return}let d=new Map;for(let[g,k]of u){let b=[...k].sort((h,$)=>{let S=on.parseVersion(h),A=on.parseVersion($);return!S||!A?0:S.major!==A.major?A.major-S.major:S.minor!==A.minor?A.minor-S.minor:A.patch-S.patch});d.set(g,b[0])}let m=[],y=0;for(let[g,k]of d){let b=this.fileCache.get(r,g,k);if(!b)try{let h=await this.publisherIndex.getPackageUrl(r,g,k),$=await this.fetchFn(h,r);if(!$.ok)continue;b=await $.text(),this.fileCache.put(r,g,k,b)}catch{continue}try{let h=this.parser.parse(b),$=new D(h,this.repository),S=await this.objectParser.parseKanonaks($),A=K(S,o);for(let P of A)m.push({publisher:r,package_:g,version:k,subject:P});y++}catch{continue}}if(m.length===0){console.log(`No ${L(o)} instances found across ${y} package(s).`);return}console.log(`Found ${m.length} ${L(o)} instance(s):
|
|
169
|
+
`);for(let g of m)console.log(` ${g.publisher}/${g.package_}@${g.version}`),console.log(` ${g.subject.name}`),console.log()}async info(e,t,r){let s=(await this.requireHandler(e).list({repository:this.repository,options:r})).find(c=>c.name===t);s||(console.error(`"${t}" is not installed.`),process.exit(1)),console.log(`Name: ${s.name}`),console.log(`Type: ${e.managesTypeKey||"n/a"}`),console.log(`Publisher: ${s.publisher||"unmanaged"}`),console.log(`Package: ${s.package_||"n/a"}`),console.log(`Version: ${s.version||"n/a"}`),console.log(`Path: ${s.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 kt(n){if(!n)return;let e=n.split("/");if(e.length===3)return{publisher:e[0],package_:e[1],name:e[2]}}var Re=class{handlers=new Map;register(e,t){this.handlers.set(e,t)}get(e){return this.handlers.get(e)??null}};import{mkdirSync as ks,rmSync as ys,existsSync as je,readdirSync as bs,writeFileSync as ws}from"fs";import{join as xe}from"path";import{KanonakObjectParser as Ss,KanonakParser as $s}from"@kanonak-protocol/sdk";import{join as an}from"path";import{homedir as yt}from"os";import{KanonakObjectParser as as}from"@kanonak-protocol/sdk";var ae="kanonak.org",se="agent-skills",wt={publisher:ae,package_:se,name:"Client"},St={publisher:ae,package_:se,name:"clientId"},ss={publisher:ae,package_:se,name:"projectSkillDir"},is={publisher:ae,package_:se,name:"userSkillDir"},cs="agents";async function fe(n,e){let t=(n.client??ls()??cs).toLowerCase(),r=n.scope??"project",o=await us(t,e);if(!o){let c=await ds(e);throw new Error(`Unknown client "${t}". Known clients: ${c.join(", ")||"(none)"}. Add a Client instance to a package that imports kanonak.org/agent-skills and install that package to make it available.`)}let s=C(o,r==="user"?is:ss);if(!s)throw new Error(`Client "${t}" has no ${r==="user"?"userSkillDir":"projectSkillDir"} declared.`);return ps(s)}async function Ie(n,e,t){let r=await fe(e,t);return an(r,n)}function ls(){if(process.env.CLAUDE_CODE||process.env.CLAUDE_PROJECT_DIR)return"claude-code"}var bt=new WeakMap;async function $t(n){let e=bt.get(n);if(e)return e;let t=await n.getDocumentsByNamespaceAsync(ae,se);if(t.length===0)throw new Error(`Could not find ${ae}/${se} 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((i,l)=>{let u=i.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],a=new as,s=new D(o,n),c=await a.parseKanonaks(s);return bt.set(n,c),c}async function us(n,e){let t=await $t(e),r=K(t,wt);for(let o of r)if(C(o,St)===n)return o}async function ds(n){let e=await $t(n),t=K(e,wt),r=[];for(let o of t){let a=C(o,St);a&&r.push(a)}return r}function ps(n){return n.startsWith("~/")?an(yt(),n.slice(2)):n==="~"?yt():n.startsWith("/")||/^[A-Za-z]:[\\/]/.test(n)?n:an(process.cwd(),n)}import{readFileSync as ms,writeFileSync as fs,existsSync as gs}from"fs";import{join as vt}from"path";import Dt from"js-yaml";var At="skills.lock",hs=`# This file is generated by Kanonak CLI. Do not edit manually.
|
|
170
|
+
`;function Te(n){let e=vt(n,At);if(!gs(e))return{version:"1",lastUpdated:new Date().toISOString(),skills:{}};let t=ms(e,"utf-8"),r=Dt.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 a of Object.keys(e.skills).sort())t[a]=e.skills[a];e.skills=t;let r=vt(n,At),o=Dt.dump(e,{lineWidth:-1,sortKeys:!1,quotingType:'"'});fs(r,hs+o,"utf-8")}var Kt="kanonak.org",Ct="skill-to-skill-md",Ue=class{parser=new $s;objectParser=new Ss;runner=new V;async deploy(e){let{instances:t,allKanonaks:r,repository:o,options:a}=e;if(t.length===0){console.error("No Skill instances to deploy.");return}let s=await vs(o,this.objectParser);if(!s){console.error(`Cannot deploy: ${Kt}/${Ct}@1.0.0 is not installed in the workspace or cache.`);return}let c=await this.runner.run({transformation:s,instances:t,allKanonaks:r,repository:o,parser:this.parser,objectParser:this.objectParser,outputFormat:"markdown-with-frontmatter"});if(c.length===0){console.error("No skills could be transformed from the package.");return}let i=await fe(a,o),l=Te(i),u=t[0].namespace,{publisher:d,package_:m,version:y}=Ds(u);for(let g of c){let k=await Ie(g.fileName,a,o),b=je(xe(k,"SKILL.md"));ks(k,{recursive:!0}),ws(xe(k,"SKILL.md"),g.content,"utf-8"),l.skills[g.fileName]={publisher:d,package_:m,version:y,resolved:d?`kanonak://${d}/${m}@${y}`:"",integrity:N(g.content)},console.log(` ${b?"Updated":"Installed"} skill "${g.fileName}" \u2192 ${k}`)}sn(i,l)}async undeploy(e,t){let{repository:r,options:o}=t,a=await Ie(e,o,r);je(a)||(console.error(`Skill "${e}" is not installed at ${a}`),process.exit(1)),ys(a,{recursive:!0,force:!0});let s=await fe(o,r),c=Te(s);delete c.skills[e],sn(s,c),console.log(`Removed skill "${e}" from ${a}`)}async list(e){let{repository:t,options:r}=e,o=await fe(r,t),a=Te(o),s=[];for(let[c,i]of Object.entries(a.skills))s.push({name:c,publisher:i.publisher,package_:i.package_,version:i.version,path:await Ie(c,r,t)});if(je(o))try{let c=bs(o,{withFileTypes:!0});for(let i of c){if(!i.isDirectory()||a.skills[i.name])continue;let l=xe(o,i.name,"SKILL.md");je(l)&&s.push({name:i.name,publisher:"",package_:"",version:"",path:xe(o,i.name)})}}catch{}return s}};async function vs(n,e){let t=await n.getDocumentsByNamespaceAsync(Kt,Ct);if(t.length===0)return;let r=new D(t[0],n),o=await e.parseKanonaks(r);return K(o,f.Transformation)[0]}function Ds(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 Ls,rmSync as Ns,existsSync as ln,readdirSync as Fs,writeFileSync as Ms,statSync as Bs}from"fs";import{join as Ne}from"path";import{KanonakObjectParser as Vs,KanonakParser as Hs}from"@kanonak-protocol/sdk";import{join as Pt}from"path";import{homedir as Et}from"os";import{KanonakObjectParser as As}from"@kanonak-protocol/sdk";var z="kanonak.org",q="agent-skills",Rt={publisher:z,package_:q,name:"Client"},It={publisher:z,package_:q,name:"clientId"},Ks={publisher:z,package_:q,name:"projectAgentDir"},Cs={publisher:z,package_:q,name:"userAgentDir"},Ps={publisher:z,package_:q,name:"agentFileFormat"},Es="agents";function _s(){if(process.env.CLAUDE_CODE||process.env.CLAUDE_PROJECT_DIR)return"claude-code"}async function Oe(n,e){let t=(n.client??_s()??Es).toLowerCase(),r=n.scope??"project",o=await Rs(t,e);if(!o){let u=await Is(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 s=C(o,r==="user"?Cs:Ks);if(!s)throw new Error(`Client "${t}" has no ${r==="user"?"userAgentDir":"projectAgentDir"} declared.`);let i=B(o,Ps)?.name==="toml"?"toml":"markdown-frontmatter",l=i==="toml"?".toml":".md";return{agentsDir:Ts(s),format:i,fileExtension:l}}var _t=new WeakMap;async function Tt(n){let e=_t.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((i,l)=>{let u=i.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],a=new As,s=new D(o,n),c=await a.parseKanonaks(s);return _t.set(n,c),c}async function Rs(n,e){let t=await Tt(e),r=K(t,Rt);for(let o of r)if(C(o,It)===n)return o}async function Is(n){let e=await Tt(n),t=K(e,Rt),r=[];for(let o of t){let a=C(o,It);a&&r.push(a)}return r}function Ts(n){return n.startsWith("~/")?Pt(Et(),n.slice(2)):n==="~"?Et():n.startsWith("/")||/^[A-Za-z]:[\\/]/.test(n)?n:Pt(process.cwd(),n)}import{readFileSync as js,writeFileSync as xs,existsSync as Us}from"fs";import{join as jt}from"path";import xt from"js-yaml";var Ut="agents.lock",Os=`# This file is generated by Kanonak CLI. Do not edit manually.
|
|
171
|
+
`;function Le(n){let e=jt(n,Ut);if(!Us(e))return{version:"1",lastUpdated:new Date().toISOString(),agents:{}};let t=js(e,"utf-8"),r=xt.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 cn(n,e){e.lastUpdated=new Date().toISOString();let t={};for(let a of Object.keys(e.agents).sort())t[a]=e.agents[a];e.agents=t;let r=jt(n,Ut),o=xt.dump(e,{lineWidth:-1,sortKeys:!1,quotingType:'"'});xs(r,Os+o,"utf-8")}var Ot="kanonak.org",Lt="agent-to-agent-file",Fe=class{parser=new Hs;objectParser=new Vs;runner=new V;async deploy(e){let{instances:t,allKanonaks:r,repository:o,options:a}=e;if(t.length===0){console.error("No Agent instances to deploy.");return}let{agentsDir:s,format:c,fileExtension:i}=await Oe(a,o),l=await zs(o,this.objectParser);if(!l){console.error(`Cannot deploy: ${Ot}/${Lt}@1.0.0 is not installed in the workspace or cache.`);return}let u=c==="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}Ls(s,{recursive:!0});let m=Le(s),y=t[0].namespace,{publisher:g,package_:k,version:b}=Gs(y);for(let h of d){let $=`${h.fileName}${i}`,S=Ne(s,$),A=ln(S);Ms(S,h.content,"utf-8"),m.agents[h.fileName]={publisher:g,package_:k,version:b,resolved:g?`kanonak://${g}/${k}@${b}`:"",integrity:N(h.content),fileName:$},console.log(` ${A?"Updated":"Installed"} agent "${h.fileName}" \u2192 ${S}`)}cn(s,m)}async undeploy(e,t){let{repository:r,options:o}=t,{agentsDir:a}=await Oe(o,r),s=Le(a),c=s.agents[e];c||(console.error(`Agent "${e}" is not installed at ${a}`),process.exit(1));let i=Ne(a,c.fileName);ln(i)&&Ns(i,{force:!0}),delete s.agents[e],cn(a,s),console.log(`Removed agent "${e}" from ${i}`)}async list(e){let{repository:t,options:r}=e,{agentsDir:o}=await Oe(r,t),a=Le(o),s=[];for(let[c,i]of Object.entries(a.agents))s.push({name:c,publisher:i.publisher,package_:i.package_,version:i.version,path:Ne(o,i.fileName)});if(ln(o))try{let c=Fs(o,{withFileTypes:!0});for(let i of c){if(!i.isFile()||i.name==="agents.lock")continue;let l=Ne(o,i.name),u=qs(i.name);if(!a.agents[u]){try{if(!Bs(l).isFile())continue}catch{continue}s.push({name:u,publisher:"",package_:"",version:"",path:l})}}}catch{}return s}};async function zs(n,e){let t=await n.getDocumentsByNamespaceAsync(Ot,Lt);if(t.length===0)return;let r=new D(t[0],n),o=await e.parseKanonaks(r);return K(o,f.Transformation)[0]}function qs(n){let e=n.lastIndexOf(".");return e===-1?n:n.substring(0,e)}function Gs(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 ri=Ys(Js(import.meta.url)),oi=JSON.parse(Xs(Zs(ri,"..","package.json"),"utf-8")),O=new Ws;O.name("kanonak").description("Kanonak Protocol CLI - Validate and resolve Kanonak ontology packages").version(oi.version);O.command("validate <path>").description("Validate .kan.yml file(s). Resolves imports via HTTP from publisher domains.").action(async n=>{await fn(n)});O.command("install [package]").description("Install a package and its dependencies, or install all from kanonak.lock.").action(async n=>{await yn(n)});O.command("deps <path>").description("Show resolved dependency tree for a .kan.yml file.").action(async n=>{await wn(n)});O.command("login <publisher>").description("Authenticate with a package publisher using OAuth 2.0.").action(async n=>{await An(n)});O.command("logout <publisher>").description("Revoke tokens and remove stored credentials for a publisher.").action(async n=>{await Kn(n)});O.addCommand(Nn());O.addCommand(ct());O.addCommand(ft());async function ai(){try{let n=new T,e=new Qs,t=new ni,r=ti(t),o=new ei({fetchFn:r}),a=await j(process.cwd(),e),s=new Re;s.register("kanonak.org/capabilities/agent-skill-deployment",new Ue),s.register("kanonak.org/agent-capabilities/agent-instance-deployment",new Fe);let c=await On(n,e,a),i=new _e(n,e,o,r,s,a);ht(O,c,i)}catch{}}await ai();O.parse();
|
|
@@ -37,7 +37,7 @@ export interface Artifact {
|
|
|
37
37
|
*
|
|
38
38
|
* Note: `formatUri` is a REAL Kanonak URI — `publisher/package/name`
|
|
39
39
|
* of an actual `tx.OutputFormat` instance declared in
|
|
40
|
-
* `kanonak.org/transformations@
|
|
40
|
+
* `kanonak.org/transformations@2.0.0`. It is NOT a faux-path
|
|
41
41
|
* identifier. Each registered IDocumentAstBackend uses the same URI
|
|
42
42
|
* as its own `backendUri` so the map lookup resolves one-to-one.
|
|
43
43
|
*/
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kanonak-protocol/cli",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.0.0",
|
|
4
4
|
"description": "Kanonak Protocol CLI - Validate and resolve Kanonak ontology packages",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -35,8 +35,8 @@
|
|
|
35
35
|
"semantic-web"
|
|
36
36
|
],
|
|
37
37
|
"dependencies": {
|
|
38
|
-
"@kanonak-protocol/sdk": "^
|
|
39
|
-
"@kanonak-protocol/types": "^
|
|
38
|
+
"@kanonak-protocol/sdk": "^2.0.0",
|
|
39
|
+
"@kanonak-protocol/types": "^2.0.0",
|
|
40
40
|
"commander": "^13.0.0",
|
|
41
41
|
"js-yaml": "^4.1.1"
|
|
42
42
|
},
|