@kanonak-protocol/cli 2.4.0 → 3.0.0

package/dist/transformations/CompiledTransformation.d.ts

@@ -1,155 +0,0 @@
-/**
- * Typed, parsed-once representation of a Transformation ontology
- * instance. Produced by `TransformationLoader` from a `SubjectKanonak`
- * of type `kanonak.org/transformations/Transformation`; consumed by
- * `TransformationRunner` and `ExpressionEngine`.
- *
- * Separating the compiled form from the raw SDK object model means
- * expression evaluation is a plain-data walk with no repeated
- * predicate-URI matching per step. Compilation validates shape and
- * throws with a BuilderNode path breadcrumb on first error.
- */
-import type { EntityUri } from '../capabilities/UriHelpers.js';
-export type NormalizeKindName = 'trim-end';
-export interface CompiledTransformation {
-    /** The transformation entity's own local name, for diagnostics. */
-    name: string;
-    inputPattern: CompiledInputPattern;
-    rule: CompiledExpression;
-    artifactName: CompiledExpression;
-    /**
-     * The set of OutputFormat URIs this transformation supports,
-     * keyed by the OutputFormat's local name (not its backendUri).
-     * The runner rejects requests to render in a format not in this set.
-     */
-    outputs: Set<string>;
-    /**
-     * Per-format overrides keyed by the OutputFormat's local name.
-     */
-    overrides: Map<string, CompiledFormatOverride>;
-}
-export interface CompiledInputPattern {
-    /** The class URI whose instances this transformation matches. */
-    matchesClass: EntityUri;
-    /**
-     * Property URIs that must resolve to a non-empty value on the
-     * input subject. Missing-required instances are silently skipped.
-     */
-    requires: EntityUri[];
-}
-export interface CompiledFormatOverride {
-    /**
-     * 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;
-}
-export type CompiledExpression = CompiledBuildAstNode | CompiledForEach | CompiledWhen | CompiledConcat | CompiledStringLiteral | CompiledIntegerLiteral | CompiledBooleanLiteral | CompiledVarRef | CompiledPropertyRead | CompiledTraverse | CompiledFallback | CompiledUriName | CompiledListMap | CompiledJoin | CompiledNormalize | CompiledIsSet | CompiledUriLiteral | CompiledDisplayLabel | CompiledResolveRef;
-export interface CompiledBuildAstNode {
-    kind: 'build-ast-node';
-    astClass: EntityUri;
-    set: CompiledBinding[];
-}
-export interface CompiledForEach {
-    kind: 'for-each';
-    iterate: CompiledExpression;
-    loopVar: string;
-    emit: CompiledExpression;
-}
-export interface CompiledWhen {
-    kind: 'when';
-    condition: CompiledExpression;
-    thenBuild: CompiledExpression;
-    elseBuild?: CompiledExpression;
-}
-export interface CompiledConcat {
-    kind: 'concat';
-    parts: CompiledExpression[];
-}
-export interface CompiledStringLiteral {
-    kind: 'string-literal';
-    value: string;
-}
-export interface CompiledIntegerLiteral {
-    kind: 'integer-literal';
-    value: number;
-}
-export interface CompiledBooleanLiteral {
-    kind: 'boolean-literal';
-    value: boolean;
-}
-export interface CompiledVarRef {
-    kind: 'var-ref';
-    varName: string;
-}
-export interface CompiledPropertyRead {
-    kind: 'property-read';
-    source: CompiledExpression;
-    readProp: EntityUri;
-}
-export interface CompiledTraverse {
-    kind: 'traverse';
-    source: CompiledExpression;
-    through: EntityUri;
-    step: CompiledExpression;
-}
-export interface CompiledFallback {
-    kind: 'fallback';
-    primary: CompiledExpression;
-    alternate: CompiledExpression;
-}
-export interface CompiledUriName {
-    kind: 'uri-name';
-    of: CompiledExpression;
-}
-export interface CompiledListMap {
-    kind: 'list-map';
-    source: CompiledExpression;
-    loopVar: string;
-    mapBody: CompiledExpression;
-}
-export interface CompiledJoin {
-    kind: 'join';
-    separator: string;
-    items: CompiledExpression;
-}
-export interface CompiledNormalize {
-    kind: 'normalize';
-    source: CompiledExpression;
-    normKind: NormalizeKindName;
-}
-export interface CompiledIsSet {
-    kind: 'is-set';
-    check: CompiledExpression;
-}
-export interface CompiledUriLiteral {
-    kind: 'uri-literal';
-    refTo: EntityUri;
-}
-export interface CompiledDisplayLabel {
-    kind: 'display-label';
-    /** The entity whose display label this expression resolves. */
-    labelTarget: EntityUri;
-    /** The property to read off the target for the display value. */
-    labelSource: EntityUri;
-}
-export interface CompiledResolveRef {
-    kind: 'resolve-ref';
-    /**
-     * Expression that yields a ReferenceKanonak or EntityUri. The
-     * engine dereferences it via ReferenceResolver and returns the
-     * target SubjectKanonak (or undefined on miss).
-     */
-    source: CompiledExpression;
-}
-export interface CompiledBinding {
-    /** The document-ast property URI being bound. */
-    field: EntityUri;
-    /** Expression that produces the bound value. */
-    value: CompiledExpression;
-}

package/dist/transformations/ExpressionEngine.d.ts

@@ -1,28 +0,0 @@
-/**
- * Evaluates a `CompiledExpression` tree against an input binding
- * environment. Handles both value-producing kinds (property-read,
- * traverse, fallback, ...) and structure-building kinds
- * (build-ast-node, for-each, when, concat) under a single dispatch.
- *
- * All property reads walk `statement[]` by canonical predicate URI
- * (via `UriHelpers`). Reference resolution during traverse goes
- * through the shared `ReferenceResolver`. No string heuristics, no
- * YAML hand-parsing.
- */
-import { type Kanonak, type KanonakUri } from '@kanonak-protocol/sdk';
-import { ReferenceResolver } from './ReferenceResolver.js';
-import type { CompiledExpression } from './CompiledTransformation.js';
-import { DOCAST } from './UriConstants.js';
-export type EnvValue = string | number | boolean | Kanonak | Kanonak[] | KanonakUri | unknown[] | object | undefined | null;
-export type Env = Map<string, EnvValue>;
-export declare class ExpressionEvalError extends Error {
-    constructor(message: string);
-}
-export declare class ExpressionEngine {
-    private readonly resolver;
-    private readonly allKanonaks;
-    constructor(resolver: ReferenceResolver, allKanonaks: Kanonak[]);
-    evaluate(expr: CompiledExpression, env: Env): Promise<EnvValue>;
-    private buildAstNode;
-}
-export { DOCAST };

package/dist/transformations/TransformationLoader.d.ts

@@ -1,20 +0,0 @@
-/**
- * Compiles a Kanonak `Transformation` subject into a typed
- * CompiledTransformation. All property reads go through
- * `UriHelpers`; no string matching, no YAML hand-parsing. Throws
- * `TransformationLoadError` with a breadcrumb path on the first
- * shape violation.
- */
-import { SubjectKanonak, type Kanonak } from '@kanonak-protocol/sdk';
-import { type EntityUri } from '../capabilities/UriHelpers.js';
-import type { CompiledTransformation } from './CompiledTransformation.js';
-export declare class TransformationLoadError extends Error {
-    readonly path: string;
-    constructor(message: string, path: string);
-}
-export declare function compileTransformation(transformation: SubjectKanonak, allKanonaks: Kanonak[]): CompiledTransformation;
-/**
- * Reference to a transformations-ontology entity (used externally
- * to look up named Transformation instances by local name).
- */
-export declare function findTransformation(kanonaks: Kanonak[], uri: EntityUri): SubjectKanonak | undefined;

package/dist/transformations/TransformationRunner.d.ts

@@ -1,81 +0,0 @@
-/**
- * Top-level entry point for the generic transformation runner.
- *
- * Given a Transformation SubjectKanonak, a list of candidate input
- * instances, the broader repository (for reference resolution), and
- * the desired OutputFormat, produces a list of in-memory `Artifact`
- * records. The runner never touches the filesystem — writing is the
- * deployment handler's job.
- *
- * Pipeline per input:
- *   1. Filter by InputPattern.matchesClass + requires.
- *   2. Evaluate `rule` → DocAstDocument.
- *   3. Evaluate `artifactName` → filename stem.
- *   4. Look up backend by OutputFormat's local name.
- *   5. Apply FormatOverride for that format if present.
- *   6. Serialize → bytes → wrap as Artifact.
- */
-import { KanonakParser, KanonakObjectParser, SubjectKanonak, type Kanonak, type IKanonakDocumentRepository } from '@kanonak-protocol/sdk';
-import type { IDocumentAstBackend } from './backends/IDocumentAstBackend.js';
-export interface Artifact {
-    /** Filename stem with no directory and no extension. */
-    fileName: string;
-    /** The OutputFormat local name this artifact was serialized as. */
-    format: string;
-    /** The serialized bytes (UTF-8 string). */
-    content: string;
-    /** The source subject this artifact was produced from. */
-    sourceName: string;
-}
-/**
- * Metadata about one OutputFormat the runner knows how to serialize:
- * the canonical Kanonak URI of the OutputFormat instance itself
- * (which the runner uses as the backend-registry key) and the
- * filename extension the CLI should append when writing artifacts to
- * disk. Kept alongside the runner so callers (like the
- * `kanonak transform` command) don't have to duplicate this table.
- *
- * Note: `formatUri` is a REAL Kanonak URI — `publisher/package/name`
- * of an actual `tx.OutputFormat` instance declared in
- * `kanonak.org/transformations@2.0.0`. It is NOT a faux-path
- * identifier. Each registered IDocumentAstBackend uses the same URI
- * as its own `backendUri` so the map lookup resolves one-to-one.
- */
-export interface FormatDescriptor {
-    /**
-     * Canonical Kanonak URI of the tx.OutputFormat instance this
-     * descriptor describes. Matches IDocumentAstBackend.backendUri.
-     */
-    formatUri: string;
-    /** Filename extension including the leading dot (e.g. `.md`). */
-    extension: string;
-}
-export declare const SUPPORTED_FORMATS: Record<string, FormatDescriptor>;
-export interface RunInput {
-    transformation: SubjectKanonak;
-    /** Candidate input subjects to run the transformation against. */
-    instances: SubjectKanonak[];
-    allKanonaks: Kanonak[];
-    /**
-     * Optional: the Kanonaks of the transformation's own package
-     * (plus any packages hosting fragments the transformation calls).
-     * Used at compile time to resolve `call-fragment` references. If
-     * the transformation does not use fragments this can be left
-     * undefined — the retrofit Skill/Agent cases pass nothing.
-     */
-    transformationKanonaks?: Kanonak[];
-    repository: IKanonakDocumentRepository;
-    parser: KanonakParser;
-    objectParser: KanonakObjectParser;
-    /** The OutputFormat local name (e.g. `'markdown-with-frontmatter'`). */
-    outputFormat: string;
-}
-export declare class TransformationRunnerError extends Error {
-}
-export declare class TransformationRunner {
-    private readonly backends;
-    constructor();
-    register(backend: IDocumentAstBackend): void;
-    run(input: RunInput): Promise<Artifact[]>;
-    private findBackendForFormat;
-}

package/dist/transformations/UriConstants.d.ts

@@ -1,147 +0,0 @@
-/**
- * Hardcoded canonical URIs for the document-ast and transformations
- * ontologies. Per `typescript/CLAUDE.md` rule 6, hardcoded URI
- * constants are fine and expected — they are the ontology contract.
- * String-based alias or suffix matching is NOT.
- *
- * Every comparison in the runner is KanonakUri → EntityUri equality
- * (publisher + package + name), never string manipulation of YAML
- * keys or alias prefixes.
- */
-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;
-};
-export declare const TX_PUB = "kanonak.org";
-export declare const TX_PKG = "transformations";
-export declare const TX: {
-    readonly Transformation: EntityUri;
-    readonly InputPattern: EntityUri;
-    readonly Expression: EntityUri;
-    readonly ExpressionKind: EntityUri;
-    readonly ExpressionFragment: EntityUri;
-    readonly AstFieldBinding: EntityUri;
-    readonly OutputFormat: EntityUri;
-    readonly FormatOverride: EntityUri;
-    readonly RenameEntry: EntityUri;
-    readonly Artifact: EntityUri;
-    readonly NormalizeKind: EntityUri;
-    readonly inputPattern: EntityUri;
-    readonly rule: EntityUri;
-    readonly artifactName: EntityUri;
-    readonly outputs: EntityUri;
-    readonly formatOverrides: EntityUri;
-    readonly matchesClass: EntityUri;
-    readonly requires: EntityUri;
-    readonly kind: EntityUri;
-    readonly astClass: EntityUri;
-    readonly set: EntityUri;
-    readonly iterate: EntityUri;
-    readonly loopVar: EntityUri;
-    readonly emit: EntityUri;
-    readonly condition: EntityUri;
-    readonly thenBuild: EntityUri;
-    readonly elseBuild: EntityUri;
-    readonly parts: EntityUri;
-    readonly stringLiteral: EntityUri;
-    readonly integerLiteral: EntityUri;
-    readonly booleanLiteral: EntityUri;
-    readonly varName: EntityUri;
-    readonly readSource: EntityUri;
-    readonly readProp: EntityUri;
-    readonly traverseSource: EntityUri;
-    readonly through: EntityUri;
-    readonly step: EntityUri;
-    readonly primary: EntityUri;
-    readonly alternate: EntityUri;
-    readonly uriNameOf: EntityUri;
-    readonly listMapSource: EntityUri;
-    readonly mapBody: EntityUri;
-    readonly separator: EntityUri;
-    readonly items: EntityUri;
-    readonly normSource: EntityUri;
-    readonly normKind: EntityUri;
-    readonly checkExpr: EntityUri;
-    readonly refTo: EntityUri;
-    readonly fragmentRef: EntityUri;
-    readonly expr: EntityUri;
-    readonly labelTarget: EntityUri;
-    readonly labelSource: EntityUri;
-    readonly resolveSource: EntityUri;
-    readonly field: EntityUri;
-    readonly bindValue: EntityUri;
-    readonly backendUri: EntityUri;
-    readonly formatTarget: EntityUri;
-    readonly metadataKeys: EntityUri;
-    readonly metadataRenames: EntityUri;
-    readonly trailingNewline: EntityUri;
-    readonly fromKey: EntityUri;
-    readonly toKey: EntityUri;
-    readonly KIND_BUILD_AST_NODE: EntityUri;
-    readonly KIND_FOR_EACH: EntityUri;
-    readonly KIND_WHEN: EntityUri;
-    readonly KIND_CONCAT: EntityUri;
-    readonly KIND_STRING_LITERAL: EntityUri;
-    readonly KIND_INTEGER_LITERAL: EntityUri;
-    readonly KIND_BOOLEAN_LITERAL: EntityUri;
-    readonly KIND_VAR_REF: EntityUri;
-    readonly KIND_PROPERTY_READ: EntityUri;
-    readonly KIND_TRAVERSE: EntityUri;
-    readonly KIND_FALLBACK: EntityUri;
-    readonly KIND_URI_NAME: EntityUri;
-    readonly KIND_LIST_MAP: EntityUri;
-    readonly KIND_JOIN: EntityUri;
-    readonly KIND_NORMALIZE: EntityUri;
-    readonly KIND_IS_SET: EntityUri;
-    readonly KIND_URI_LITERAL: EntityUri;
-    readonly KIND_CALL_FRAGMENT: EntityUri;
-    readonly KIND_DISPLAY_LABEL: EntityUri;
-    readonly KIND_RESOLVE_REF: EntityUri;
-    readonly NORM_TRIM_END: EntityUri;
-    readonly FMT_MARKDOWN_FRONTMATTER: EntityUri;
-    readonly FMT_TOML: EntityUri;
-    readonly FMT_JSON: EntityUri;
-    readonly FMT_PLAIN_MARKDOWN: EntityUri;
-};