@kanonak-protocol/cli 3.11.0 → 3.13.0

package/package.json

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

package/dist/capabilities/SingleDocumentRepository.d.ts

@@ -1,28 +0,0 @@
-import type { KanonakDocument, Import, DocumentReference } from '@kanonak-protocol/types/document/models/types';
-import type { IKanonakDocumentRepository } from '@kanonak-protocol/sdk';
-/**
- * A repository that exposes exactly one target document through
- * `getAllDocumentsAsync` but delegates every import-resolution lookup
- * (`getHighestCompatibleVersionAsync`, `getDocumentAsync`, etc.) to a
- * broader backing repository.
- *
- * This is what lets `KanonakObjectParser.parseKanonaks` parse a single
- * capability or skill document with full URI resolution across its
- * transitive imports, without inheriting every other cached document's
- * entities.
- */
-export declare class SingleDocumentRepository implements IKanonakDocumentRepository {
-    private readonly doc;
-    private readonly broader;
-    constructor(doc: KanonakDocument, broader: IKanonakDocumentRepository);
-    getAllDocumentsAsync(): Promise<KanonakDocument[]>;
-    getDocumentAsync(identifier: string): Promise<KanonakDocument | null>;
-    getDocumentsByNamespaceAsync(publisher: string, package_: string): Promise<KanonakDocument[]>;
-    getHighestCompatibleVersionAsync(publisher: string, import_: Import): Promise<KanonakDocument | null>;
-    saveDocumentAsync(): Promise<void>;
-    deleteDocumentAsync(): Promise<void>;
-    clearNamespaceAsync(): Promise<void>;
-    getAllDocumentReferencesAsync(): Promise<DocumentReference[]>;
-    getDocumentContentAsync(identifier: string): Promise<string | null>;
-    getDocumentUriAsync(identifier: string): Promise<string | null>;
-}

package/dist/capabilities/UriHelpers.d.ts

@@ -1,85 +0,0 @@
-import { SubjectKanonak, EmbeddedKanonak, DefinedKanonak, Kanonak, KanonakUri } from '@kanonak-protocol/sdk';
-/**
- * Canonical URI identity for an ontology entity.
- *
- * Version is intentionally omitted: the CLI compares against
- * publisher + package + name so it can accept any backwards-compatible
- * version of the ontology it was built against. If a new major version
- * breaks semantics, a separate entry (or explicit version check) is
- * added at that point.
- */
-export interface EntityUri {
-    publisher: string;
-    package_: string;
-    name: string;
-}
-/**
- * Convert a `KanonakUri` or `EntityUri` into a stable map key.
- * Version is dropped.
- */
-export declare function uriKey(uri: KanonakUri | EntityUri): string;
-/**
- * True when a resolved `KanonakUri` matches the given publisher + package
- * + local name (version ignored).
- */
-export declare function uriMatches(uri: KanonakUri, target: EntityUri): boolean;
-/**
- * True when a `Kanonak` is a `DefinedKanonak` whose `type` statement's
- * object URI matches the given class URI.
- */
-export declare function hasType(kanonak: Kanonak, target: EntityUri): boolean;
-/**
- * Filter a list of parsed kanonaks down to `SubjectKanonak`s whose type
- * matches the given class URI.
- */
-export declare function findSubjectsByType(kanonaks: Kanonak[], target: EntityUri): SubjectKanonak[];
-/**
- * Look up a `SubjectKanonak` by full URI across a list of kanonaks.
- * Used for following a reference to its definition (e.g. to read a
- * `License`'s `spdxId` or a `Tool`'s `label`).
- *
- * Version handling:
- *
- *   - When `uri.version` is present (concrete `M.m.p`), the match
- *     is STRICT — only a subject whose `namespace` is exactly
- *     `<publisher>/<package>@<M.m.p>` qualifies. This is what
- *     `tx.ResolveRef` needs when walking inner references in a
- *     multi-scope SetTransformation: a reference to
- *     `pkg@1.0.1/foo` must resolve to the 1.0.1 instance, not
- *     collapse to whichever same-named instance was loaded first
- *     across versions (kanonak-protocol/typescript#12).
- *
- *   - When `uri.version` is absent (an unversioned reference, e.g.
- *     authored as `pkg/foo` with no `@version` qualifier or coming
- *     from an `EntityUri` that carries no version), the match is
- *     LENIENT — any version of `<publisher>/<package>/<name>`
- *     qualifies. This preserves the historical behavior for
- *     callers that pass version-less URIs (UriLiteral, parsed
- *     bare-name references in single-version workspaces, etc).
- */
-export declare function findSubjectByUri(kanonaks: Kanonak[], uri: KanonakUri): SubjectKanonak | undefined;
-/**
- * Read a datatype property value (string, number, boolean) off a defined
- * kanonak, by property URI. Returns `undefined` when the property is not
- * set or not a datatype value.
- */
-export declare function getDatatypeValue(defined: DefinedKanonak, property: EntityUri): string | number | boolean | undefined;
-export declare function getStringValue(defined: DefinedKanonak, property: EntityUri): string | undefined;
-/**
- * Read the target `KanonakUri` of an ObjectProperty reference off a
- * defined kanonak, by property URI. Returns `undefined` when the
- * property is not set or not a reference statement.
- */
-export declare function getReferenceUri(defined: DefinedKanonak, property: EntityUri): KanonakUri | undefined;
-/**
- * Read an embedded kanonak off a defined kanonak, by property URI.
- * Returns `undefined` when the property is not set or not an embedded
- * statement.
- */
-export declare function getEmbeddedValue(defined: DefinedKanonak, property: EntityUri): EmbeddedKanonak | undefined;
-/**
- * Read the list values off a ListStatement property. Each item is either
- * a `ReferenceKanonak` (named reference) or an `EmbeddedKanonak` (inline).
- * Returns an empty array when the property is unset or not a list.
- */
-export declare function getListValues(defined: DefinedKanonak, property: EntityUri): Kanonak[];

package/dist/transformations/DocAst.d.ts

@@ -1,84 +0,0 @@
-/**
- * In-memory document AST types.
- *
- * Runtime-only: built by the ExpressionEngine during transformation
- * evaluation, consumed by format backends. The ontology in
- * `kanonak.org/document-ast@1.0.0` is the external contract; these
- * TypeScript types are the internal representation.
- *
- * Each node carries a `kind` discriminant whose value is the local
- * name of the document-ast Class URI (e.g. `'Document'`, `'Heading'`).
- * The discriminant is a plain string because the AST never leaves the
- * runner — no Kanonak URI comparisons happen against AST nodes, only
- * against the ontology entities that describe them.
- *
- * `escapeHint` is a full EntityUri, not a string, so backends compare
- * against `DOCAST.ESC_RAW` etc. via `uriMatches` — maintaining URI
- * equality end-to-end.
- */
-import type { EntityUri } from '../capabilities/UriHelpers.js';
-export interface DocAstDocument {
-    kind: 'Document';
-    metadata?: DocAstStructuredMap;
-    children: DocAstBlock[];
-}
-export type DocAstBlock = DocAstHeading | DocAstParagraph | DocAstRawBlock;
-export interface DocAstHeading {
-    kind: 'Heading';
-    level: number;
-    inlines: DocAstInline[];
-}
-export interface DocAstParagraph {
-    kind: 'Paragraph';
-    inlines: DocAstInline[];
-}
-/**
- * Pre-formatted content in a declared media type. Borrowed from
- * Pandoc's `RawBlock(format, content)`. The `mediaType` is a full
- * EntityUri referencing a named MediaType instance from
- * `kanonak.org/document-ast@1.0.0` (e.g. DOCAST.TEXT_MARKDOWN).
- *
- * Backends dispatch by URI: HTML runs markdown through a renderer,
- * passes HTML through verbatim, and falls back to escaped `<pre>`
- * for unknown media types. Markdown backends emit the content
- * verbatim because it's already in a text format.
- */
-export interface DocAstRawBlock {
-    kind: 'RawBlock';
-    mediaType?: EntityUri;
-    rawContent: string;
-}
-export type DocAstInline = DocAstText;
-export interface DocAstText {
-    kind: 'Text';
-    text: string;
-}
-export type DocAstStructuredValue = DocAstStructuredMap | DocAstStructuredList | DocAstStringScalar | DocAstIntegerScalar;
-export interface DocAstStructuredMap {
-    kind: 'StructuredMap';
-    entries: DocAstStructuredEntry[];
-}
-export interface DocAstStructuredEntry {
-    kind: 'StructuredEntry';
-    key: string;
-    value: DocAstStructuredValue;
-    /**
-     * Per-entry serialization hint — one of the named EscapeHint
-     * instances from `kanonak.org/document-ast@1.0.0`. Stored as a
-     * full `EntityUri` so backends compare by canonical URI, never
-     * by string local name.
-     */
-    escapeHint?: EntityUri;
-}
-export interface DocAstStructuredList {
-    kind: 'StructuredList';
-    items: DocAstStructuredValue[];
-}
-export interface DocAstStringScalar {
-    kind: 'StringScalar';
-    stringValue: string;
-}
-export interface DocAstIntegerScalar {
-    kind: 'IntegerScalar';
-    integerValue: number;
-}

package/dist/transformations/DocAstUriConstants.d.ts

@@ -1,57 +0,0 @@
-/**
- * Hardcoded canonical URIs for the document-ast ontology.
- *
- * Version-agnostic — docast is its own ontology and doesn't move
- * with the transformations major version. Both the v2 runtime
- * (legacy) and the v3 runtime read from this same file.
- *
- * Per the typescript repo's CLAUDE.md rule 6, hardcoded URI
- * constants are fine and expected — they are the ontology contract.
- * String-based alias or suffix matching is NOT.
- */
-import type { EntityUri } from '../capabilities/UriHelpers.js';
-export declare const DOCAST_PUB = "kanonak.org";
-export declare const DOCAST_PKG = "document-ast";
-export declare const DOCAST: {
-    readonly Document: EntityUri;
-    readonly Block: EntityUri;
-    readonly Inline: EntityUri;
-    readonly StructuredValue: EntityUri;
-    readonly Heading: EntityUri;
-    readonly Paragraph: EntityUri;
-    readonly RawBlock: EntityUri;
-    readonly Text: EntityUri;
-    readonly StructuredMap: EntityUri;
-    readonly StructuredEntry: EntityUri;
-    readonly StructuredList: EntityUri;
-    readonly StringScalar: EntityUri;
-    readonly IntegerScalar: EntityUri;
-    readonly EscapeHint: EntityUri;
-    readonly MediaType: EntityUri;
-    readonly metadata: EntityUri;
-    readonly children: EntityUri;
-    readonly level: EntityUri;
-    readonly inlines: EntityUri;
-    readonly text: EntityUri;
-    readonly entries: EntityUri;
-    readonly key: EntityUri;
-    readonly value: EntityUri;
-    readonly escapeHint: EntityUri;
-    readonly items: EntityUri;
-    readonly stringValue: EntityUri;
-    readonly integerValue: EntityUri;
-    readonly rawContent: EntityUri;
-    readonly mediaType: EntityUri;
-    readonly mimeType: EntityUri;
-    readonly ESC_RAW: EntityUri;
-    readonly ESC_YAML_SAFE: EntityUri;
-    readonly ESC_TOML_STRING: EntityUri;
-    readonly ESC_TOML_MULTILINE: EntityUri;
-    readonly ESC_JSON: EntityUri;
-    readonly TEXT_PLAIN: EntityUri;
-    readonly TEXT_MARKDOWN: EntityUri;
-    readonly TEXT_HTML: EntityUri;
-    readonly APPLICATION_JSON: EntityUri;
-    readonly TEXT_YAML: EntityUri;
-    readonly IMAGE_SVG_XML: EntityUri;
-};

package/dist/transformations/FormatOverride.d.ts

@@ -1,34 +0,0 @@
-/**
- * Backend-facing FormatOverride contract.
- *
- * Version-agnostic — backends operate on docast trees and accept
- * format-specific tweaks via this shape, regardless of which
- * transformation runtime produced it. Each runtime version compiles
- * its FormatOverride YAML into a value of this shape before handing
- * it to a backend.
- */
-export interface BackendFormatOverride {
-    /**
-     * Optional include-list of metadata entry keys the backend should
-     * emit, in order. Keys outside this list are skipped. If omitted,
-     * the backend emits all metadata entries in their AST order.
-     */
-    metadataKeys?: string[];
-    /** AST-key → emitted-key renames. */
-    metadataRenames: Map<string, string>;
-    /** Whether to append a final newline to the serialized output. */
-    trailingNewline?: boolean;
-    /**
-     * Suppress the backend's default chrome (e.g. the HTML backend's
-     * `<!DOCTYPE html><html>...<style>...</style>...</html>` wrapper
-     * and its `<dl class="metadata">` block). When true, the backend
-     * emits ONLY the rendered content from `document.children`,
-     * without any framing — useful for transformations that build
-     * the entire HTML document themselves and don't want the CLI's
-     * opinionated default getting in the way.
-     *
-     * Backends that have no chrome (e.g. JSON, plain Markdown) ignore
-     * this flag.
-     */
-    omitWrapper?: boolean;
-}

package/dist/transformations/ReferenceResolver.d.ts

@@ -1,20 +0,0 @@
-/**
- * Resolves a `KanonakUri` to its defining `SubjectKanonak`, following
- * cross-package imports through a broader repository.
- *
- * Extracted from `SkillTransformer.ts:189-235` so the transformation
- * engine and any other consumer can share a single cached resolver.
- * Behavior is identical to the original — local shadowing first,
- * then a cache-keyed lookup in the broader repository, with a final
- * name-based fallback for edge cases where the parser emits a
- * namespace string that doesn't start with the expected prefix.
- */
-import { KanonakParser, KanonakObjectParser, SubjectKanonak, type Kanonak, type KanonakUri, type IKanonakDocumentRepository } from '@kanonak-protocol/sdk';
-export declare class ReferenceResolver {
-    private readonly repository;
-    private readonly parser;
-    private readonly objectParser;
-    private readonly cache;
-    constructor(repository: IKanonakDocumentRepository, parser: KanonakParser, objectParser: KanonakObjectParser);
-    resolveSubject(uri: KanonakUri, localKanonaks: Kanonak[]): Promise<SubjectKanonak | undefined>;
-}

package/dist/transformations/backends/HtmlBackend.d.ts

@@ -1,7 +0,0 @@
-import type { DocAstDocument } from '../DocAst.js';
-import type { BackendFormatOverride } from '../FormatOverride.js';
-import type { IDocumentAstBackend } from './IDocumentAstBackend.js';
-export declare class HtmlBackend implements IDocumentAstBackend {
-    readonly backendUri = "kanonak.org/transformations/html";
-    render(document: DocAstDocument, override?: BackendFormatOverride): string;
-}

package/dist/transformations/backends/IDocumentAstBackend.d.ts

@@ -1,16 +0,0 @@
-/**
- * Format backend interface. Given a document-ast Document tree and
- * an optional per-transformation format override, produce the
- * serialized bytes of the artifact as a string.
- *
- * Backends are pure functions of (document, override) — they never
- * touch the filesystem or the repository. That's the deployment
- * handler's job.
- */
-import type { DocAstDocument } from '../DocAst.js';
-import type { BackendFormatOverride } from '../FormatOverride.js';
-export interface IDocumentAstBackend {
-    /** The backendUri string this backend registers under. */
-    readonly backendUri: string;
-    render(document: DocAstDocument, override?: BackendFormatOverride): string;
-}

package/dist/transformations/backends/JsonBackend.d.ts

@@ -1,12 +0,0 @@
-/**
- * Trivial JSON backend. Serializes the full Document (both channels)
- * as pretty-printed JSON. Useful as a regression-test oracle that is
- * immune to the whitespace sensitivity of the text backends.
- */
-import type { DocAstDocument } from '../DocAst.js';
-import type { BackendFormatOverride } from '../FormatOverride.js';
-import type { IDocumentAstBackend } from './IDocumentAstBackend.js';
-export declare class JsonBackend implements IDocumentAstBackend {
-    readonly backendUri = "kanonak.org/transformations/json";
-    render(document: DocAstDocument, override?: BackendFormatOverride): string;
-}

package/dist/transformations/backends/MarkdownFrontmatterBackend.d.ts

@@ -1,7 +0,0 @@
-import type { DocAstDocument } from '../DocAst.js';
-import type { BackendFormatOverride } from '../FormatOverride.js';
-import type { IDocumentAstBackend } from './IDocumentAstBackend.js';
-export declare class MarkdownFrontmatterBackend implements IDocumentAstBackend {
-    readonly backendUri = "kanonak.org/transformations/markdown-with-frontmatter";
-    render(document: DocAstDocument, override?: BackendFormatOverride): string;
-}

package/dist/transformations/backends/SimpleMarkdownRenderer.d.ts

@@ -1,17 +0,0 @@
-/**
- * Minimal CommonMark-ish markdown → HTML renderer.
- *
- * Covers the subset of markdown the Skill hasSection bodies actually
- * use: ATX headings (# through ######), paragraphs, fenced code
- * blocks (```lang\n...\n```), inline code (`code`), bold (**text**),
- * italic (*text* or _text_), unordered lists (- or * item), ordered
- * lists (1. item), links ([text](url)), and GitHub-flavored tables
- * (| header | header | ... |). Does NOT handle blockquotes,
- * reference-style links, HTML passthrough, setext headings, or
- * pipe-escape in table cells.
- *
- * Intentionally self-contained (no dependencies). If a real CommonMark
- * implementation is ever needed, swap this file out — nothing else in
- * the transformation system depends on its internals.
- */
-export declare function renderMarkdownToHtml(source: string): string;

package/dist/transformations/backends/SvgBackend.d.ts

@@ -1,7 +0,0 @@
-import type { DocAstDocument } from '../DocAst.js';
-import type { BackendFormatOverride } from '../FormatOverride.js';
-import type { IDocumentAstBackend } from './IDocumentAstBackend.js';
-export declare class SvgBackend implements IDocumentAstBackend {
-    readonly backendUri = "kanonak.org/transformations/svg";
-    render(document: DocAstDocument, override?: BackendFormatOverride): string;
-}

package/dist/transformations/backends/TomlBackend.d.ts

@@ -1,7 +0,0 @@
-import type { DocAstDocument } from '../DocAst.js';
-import type { BackendFormatOverride } from '../FormatOverride.js';
-import type { IDocumentAstBackend } from './IDocumentAstBackend.js';
-export declare class TomlBackend implements IDocumentAstBackend {
-    readonly backendUri = "kanonak.org/transformations/toml";
-    render(document: DocAstDocument, override?: BackendFormatOverride): string;
-}