@concordance-wiki/inference 0.1.0

package/dist/neighbourhood/types.d.ts

@@ -0,0 +1,24 @@
+/** What the accumulation needs of an occurrence: the entity it names and the paragraph it sits in. */
+export interface OccurrenceLike {
+    target: {
+        id: string;
+    };
+    source?: string;
+    /** Forward-slash path relative to the source root. */
+    path: string;
+    line: number;
+}
+export interface Neighbour {
+    id: string;
+    /** Number of paragraphs where both entities appear. */
+    count: number;
+}
+export interface Neighbourhood {
+    k: number;
+    /** Nodes in identifier order; each holds at most `k` neighbours, by count then by identifier. */
+    nodes: ReadonlyMap<string, Neighbour[]>;
+}
+export interface NeighbourhoodOptions {
+    k: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/neighbourhood/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/neighbourhood/types.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,iGAAiG;IACjG,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,EAAE,MAAM,CAAC;CACX"}

package/dist/neighbourhood/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/neighbourhood/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/neighbourhood/types.ts"],"names":[],"mappings":""}

package/dist/operations/index.d.ts

@@ -0,0 +1,30 @@
+import { type Entity, type Finding, type Link } from "@concordance-wiki/core";
+import type { Profile } from "@concordance-wiki/profile";
+export declare const OPERATION_AMBIGUOUS = "W-OPERATION-AMBIGUOUS";
+export declare const OPERATION_UNMATCHED = "W-OPERATION-UNMATCHED";
+export interface AttachOperationsInput {
+    entities: readonly Entity[];
+    /** The links recorded so far, the `exposes` links of the contract import among them. */
+    links: readonly Link[];
+    profile: Profile;
+    /** The comparison form of a text; the language pack of the project provides it. */
+    normalize: (text: string) => string;
+}
+export interface AttachOperationsResult {
+    entities: Entity[];
+    links: Link[];
+    findings: Finding[];
+}
+/**
+ * Attaches the hand-written `endpoint` notes to the operations imported from the contracts:
+ * a matched pair merges into the note, which keeps its identifier, its markdown and its frontmatter
+ * and gains the contract attributes it does not set, the contract as a representation and the rung
+ * as `grouped_by`; the imported operation disappears and every link that named it, the `exposes`
+ * link first of all, now names the note. An ambiguous match attaches nothing and is reported as
+ * `W-OPERATION-AMBIGUOUS`; a note that names an API with a contract and matches nothing is
+ * reported as `W-OPERATION-UNMATCHED`. Pure and deterministic: every output is in canonical order.
+ */
+export declare function attachOperations(input: AttachOperationsInput): AttachOperationsResult;
+export { MATCH_RUNGS, importedOperations, matchOperations, operationNotes, type Ambiguity, type ImportedOperation, type MatchResult, type MatchRung, type OperationMatch, type OperationNote, } from "./match.js";
+export { CONTRACT_REPRESENTATION, mergeOperation, redirectLinks } from "./merge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,KAAK,IAAI,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAczD,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAC3D,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAe3D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,wFAAwF;IACxF,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAyED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAuBrF;AAED,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/operations/index.js

@@ -0,0 +1,118 @@
+import { compareEntities, compareFindings, compareLinks, } from "@concordance-wiki/core";
+import { importedOperations, matchOperations, operationNotes, } from "./match.js";
+import { mergeOperation, redirectLinks } from "./merge.js";
+export const OPERATION_AMBIGUOUS = "W-OPERATION-AMBIGUOUS";
+export const OPERATION_UNMATCHED = "W-OPERATION-UNMATCHED";
+const REMEDIATION = "Give each operation note the operation_id of exactly one operation of its API, name the API in the api attribute when the source declares several contracts, or remove the note that duplicates another.";
+const UNMATCHED_REMEDIATION = "Compare the note with the contract: when the operation is gone, retire the note or point it at the operation that replaced it; when the note is ahead of the contract, keep it and give it the operation_id the next version will declare, so that it attaches then.";
+/** How a finding names the rung an ambiguity was met at. */
+const RUNG_LABELS = {
+    operation_id: "the operation identifier",
+    method_path: "the method and path",
+    title: "the title",
+};
+function ambiguityFinding(ambiguity) {
+    const rung = RUNG_LABELS[ambiguity.rung];
+    if (ambiguity.kind === "note") {
+        const { note, operations } = ambiguity;
+        const named = operations.map((operation) => operation.entity.id).join(", ");
+        return {
+            check: OPERATION_AMBIGUOUS,
+            severity: "warning",
+            message: `operation note ${note.id} matches ${String(operations.length)} operations on ${rung}: ${named}; none is attached`,
+            remediation: REMEDIATION,
+            source: note.source.name,
+            path: note.source.path,
+            line: 1,
+            entity: note.id,
+        };
+    }
+    const { operation, notes } = ambiguity;
+    const named = notes.map((note) => note.id).join(", ");
+    return {
+        check: OPERATION_AMBIGUOUS,
+        severity: "warning",
+        message: `operation ${operation.entity.id} of ${operation.api} is claimed by ${String(notes.length)} notes on ${rung}: ${named}; none is attached`,
+        remediation: REMEDIATION,
+        source: operation.entity.source.name,
+        path: operation.location,
+        entity: operation.entity.id,
+    };
+}
+/** The candidate APIs of a note with their contract, as the imported operations name it, in identifier order. */
+function candidatesOf(note, operations) {
+    const locations = new Map();
+    for (const operation of operations) {
+        if (note.apis.includes(operation.api))
+            locations.set(operation.api, operation.location);
+    }
+    return [...locations].map(([api, location]) => `${api} (${location})`).join(", ");
+}
+function unmatchedFinding(note, operations) {
+    const apis = candidatesOf(note, operations);
+    return {
+        check: OPERATION_UNMATCHED,
+        severity: "warning",
+        message: `operation note ${note.entity.id} matches no operation of ${apis}: the operation disappeared from the contract, or the note is ahead of it`,
+        remediation: UNMATCHED_REMEDIATION,
+        source: note.entity.source.name,
+        path: note.entity.source.path,
+        line: 1,
+        entity: note.entity.id,
+    };
+}
+/**
+ * The notes that name an API with an imported contract and neither matched nor took part in an
+ * ambiguity: either their operation left the contract or the note is ahead of it. A note that
+ * names no API is a candidate for every contract of its source and is not reported: it may
+ * describe an API without a contract.
+ */
+function unmatchedNotes(notes, { matches, ambiguities }) {
+    const settled = new Set();
+    for (const match of matches)
+        settled.add(match.note.id);
+    for (const ambiguity of ambiguities) {
+        if (ambiguity.kind === "note")
+            settled.add(ambiguity.note.id);
+        else
+            for (const claimant of ambiguity.notes)
+                settled.add(claimant.id);
+    }
+    return notes.filter((note) => note.declared && !settled.has(note.entity.id));
+}
+/**
+ * Attaches the hand-written `endpoint` notes to the operations imported from the contracts:
+ * a matched pair merges into the note, which keeps its identifier, its markdown and its frontmatter
+ * and gains the contract attributes it does not set, the contract as a representation and the rung
+ * as `grouped_by`; the imported operation disappears and every link that named it, the `exposes`
+ * link first of all, now names the note. An ambiguous match attaches nothing and is reported as
+ * `W-OPERATION-AMBIGUOUS`; a note that names an API with a contract and matches nothing is
+ * reported as `W-OPERATION-UNMATCHED`. Pure and deterministic: every output is in canonical order.
+ */
+export function attachOperations(input) {
+    const { entities, links, profile, normalize } = input;
+    const operations = importedOperations(entities, links);
+    const notes = operationNotes(entities, links, operations, profile);
+    const result = matchOperations(notes, operations, normalize);
+    const { matches, ambiguities } = result;
+    const merged = new Map();
+    const redirections = new Map();
+    for (const match of matches) {
+        merged.set(match.note.id, mergeOperation(match.note, match.operation, match.rung));
+        redirections.set(match.operation.entity.id, match.note.id);
+    }
+    return {
+        entities: entities
+            .filter((entity) => !redirections.has(entity.id))
+            .map((entity) => merged.get(entity.id) ?? entity)
+            .sort(compareEntities),
+        links: redirectLinks(links, redirections).sort(compareLinks),
+        findings: [
+            ...ambiguities.map(ambiguityFinding),
+            ...unmatchedNotes(notes, result).map((note) => unmatchedFinding(note, operations)),
+        ].sort(compareFindings),
+    };
+}
+export { MATCH_RUNGS, importedOperations, matchOperations, operationNotes, } from "./match.js";
+export { CONTRACT_REPRESENTATION, mergeOperation, redirectLinks } from "./merge.js";
+//# sourceMappingURL=index.js.map

package/dist/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"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"}

package/dist/operations/match.d.ts

@@ -0,0 +1,64 @@
+import { type Entity, type Link } from "@concordance-wiki/core";
+import type { Profile } from "@concordance-wiki/profile";
+/** The three rungs of the matching, tried in this order; a note stops at the first one that matches. */
+export type MatchRung = "operation_id" | "method_path" | "title";
+export declare const MATCH_RUNGS: readonly MatchRung[];
+/** An `endpoint` entity a contract plugin produced, with what the `exposes` link says about it. */
+export interface ImportedOperation {
+    entity: Entity;
+    /** Identifier of the `api` entity that declares the contract. */
+    api: string;
+    /** The contract location as written in the API note. */
+    location: string;
+    /** The operation name as the contract writes it. */
+    name: string;
+}
+/** A hand-written `endpoint` note and the APIs whose operations it may describe. */
+export interface OperationNote {
+    entity: Entity;
+    /** Identifiers of the candidate APIs, sorted; every API of the source when the note names none. */
+    apis: readonly string[];
+    /** Whether the note names its API, in frontmatter or through a recorded link. */
+    declared: boolean;
+}
+export interface OperationMatch {
+    note: Entity;
+    operation: ImportedOperation;
+    rung: MatchRung;
+}
+/** A note that matches several operations, or an operation that several notes claim, at one rung; candidates are in identifier order. */
+export type Ambiguity = {
+    kind: "note";
+    rung: MatchRung;
+    note: Entity;
+    operations: ImportedOperation[];
+} | {
+    kind: "operation";
+    rung: MatchRung;
+    operation: ImportedOperation;
+    notes: Entity[];
+};
+export interface MatchResult {
+    matches: OperationMatch[];
+    ambiguities: Ambiguity[];
+}
+/** The imported operations of the entities: the `endpoint` entities of contract origin that an `exposes` link attaches to an API. */
+export declare function importedOperations(entities: readonly Entity[], links: readonly Link[]): ImportedOperation[];
+/**
+ * The hand-written `endpoint` notes with their candidate APIs: the API a reference attribute of
+ * the profile names, else the APIs a recorded link joins to the note, else every API of the note's
+ * source that has imported operations. Only APIs with imported operations count.
+ */
+export declare function operationNotes(entities: readonly Entity[], links: readonly Link[], operations: readonly ImportedOperation[], profile: Profile): OperationNote[];
+type Normalize = (text: string) => string;
+/**
+ * Matches the notes to the operations rung by rung: the operation identifier, then the method and
+ * path (or the port and the operation name for SOAP), then the title in comparison form. At each
+ * rung a note claims the operations of its candidate APIs whose key equals one of its own; a note
+ * claiming several operations, or an operation claimed by several notes, is an ambiguity that
+ * attaches nothing and takes its entities out of the later rungs. The rest attach one to one and
+ * leave the later rungs to the notes and operations still free.
+ */
+export declare function matchOperations(notes: readonly OperationNote[], operations: readonly ImportedOperation[], normalize: Normalize): MatchResult;
+export {};
+//# sourceMappingURL=match.d.ts.map

package/dist/operations/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/operations/match.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,IAAI,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIzD,wGAAwG;AACxG,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;AAEjE,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAA6C,CAAC;AAE1F,mGAAmG;AACnG,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,mGAAmG;IACnG,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,iBAAiB,CAAC;IAC7B,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,yIAAyI;AACzI,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,iBAAiB,EAAE,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAC;CAC1B;AAWD,qIAAqI;AACrI,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,EAAE,SAAS,IAAI,EAAE,GACrB,iBAAiB,EAAE,CAmBrB;AA4CD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,OAAO,EAAE,OAAO,GACf,aAAa,EAAE,CA0BjB;AAOD,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAyK1C;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,SAAS,EAAE,SAAS,GACnB,WAAW,CAeb"}

package/dist/operations/match.js

@@ -0,0 +1,251 @@
+import { CONTRACT_METHOD, CONTRACT_RELATION, compareEntities, } from "@concordance-wiki/core";
+import { indexEntities, resolveReference } from "../frontmatter/resolve.js";
+export const MATCH_RUNGS = ["operation_id", "method_path", "title"];
+function byCodeUnit(a, b) {
+    return Number(a > b) - Number(a < b);
+}
+function stringAttribute(entity, key) {
+    const value = entity.attributes[key];
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : undefined;
+}
+/** The imported operations of the entities: the `endpoint` entities of contract origin that an `exposes` link attaches to an API. */
+export function importedOperations(entities, links) {
+    const exposed = new Map();
+    for (const link of links) {
+        if (link.relation === CONTRACT_RELATION)
+            exposed.set(link.to, link);
+    }
+    const operations = [];
+    for (const entity of entities) {
+        if (entity.type !== "endpoint" || entity.type_origin !== "contract")
+            continue;
+        const link = exposed.get(entity.id);
+        if (link === undefined)
+            continue;
+        const imported = link.provenance.find((provenance) => provenance.method === CONTRACT_METHOD);
+        operations.push({
+            entity,
+            api: link.from,
+            location: entity.source.path,
+            name: imported?.operation ?? entity.title,
+        });
+    }
+    return operations.sort((a, b) => compareEntities(a.entity, b.entity));
+}
+/** The names of the `endpoint` attributes that reference an `api`, `api` in the default profile. */
+function apiAttributes(profile) {
+    const attributes = profile.types["endpoint"]?.attributes ?? {};
+    return Object.entries(attributes)
+        .filter(([, definition]) => {
+        if (definition.type !== "ref" && definition.type !== "ref[]")
+            return false;
+        const { target } = definition;
+        const targets = typeof target === "string" ? [target] : (target ?? []);
+        return targets.includes("api");
+    })
+        .map(([name]) => name)
+        .sort(byCodeUnit);
+}
+function declaredApi(note, attributes, entities, apis) {
+    const index = indexEntities(entities);
+    for (const attribute of attributes) {
+        const value = stringAttribute(note, attribute);
+        if (value === undefined)
+            continue;
+        const resolution = resolveReference(value, { from: note, index });
+        if (resolution.kind === "resolved" && apis.has(resolution.entity.id)) {
+            return resolution.entity.id;
+        }
+    }
+    return undefined;
+}
+/** The APIs a recorded link joins to the note, in either direction: a markdown link to the API note, typically. */
+function linkedApis(note, links, apis) {
+    const linked = new Set();
+    for (const link of links) {
+        if (link.from === note.id && apis.has(link.to))
+            linked.add(link.to);
+        if (link.to === note.id && apis.has(link.from))
+            linked.add(link.from);
+    }
+    return [...linked].sort(byCodeUnit);
+}
+/**
+ * The hand-written `endpoint` notes with their candidate APIs: the API a reference attribute of
+ * the profile names, else the APIs a recorded link joins to the note, else every API of the note's
+ * source that has imported operations. Only APIs with imported operations count.
+ */
+export function operationNotes(entities, links, operations, profile) {
+    const apis = new Set(operations.map((operation) => operation.api));
+    const byApi = new Map(entities.filter((entity) => apis.has(entity.id)).map((entity) => [entity.id, entity]));
+    const attributes = apiAttributes(profile);
+    const notes = [];
+    for (const entity of [...entities].sort(compareEntities)) {
+        if (entity.type !== "endpoint" || entity.type_origin === "contract")
+            continue;
+        const declared = declaredApi(entity, attributes, entities, apis);
+        if (declared !== undefined) {
+            notes.push({ entity, apis: [declared], declared: true });
+            continue;
+        }
+        const linked = linkedApis(entity, links, apis);
+        if (linked.length > 0) {
+            notes.push({ entity, apis: linked, declared: true });
+            continue;
+        }
+        const sameSource = [...byApi.values()]
+            .filter((api) => api.source.name === entity.source.name)
+            .map((api) => api.id)
+            .sort(byCodeUnit);
+        notes.push({ entity, apis: sameSource, declared: false });
+    }
+    return notes;
+}
+/** The comparison form without spaces or punctuation, so that `List entities` equals `listEntities`. */
+function compact(text, normalize) {
+    return normalize(text).replace(/[^\p{L}\p{N}]+/gu, "");
+}
+/** The keys an imported operation answers to at a rung; an operation without the attributes of a rung has none. */
+function operationKeys(operation, rung, normalize) {
+    const { entity, name } = operation;
+    const id = stringAttribute(entity, "operation_id");
+    if (rung === "operation_id")
+        return id === undefined ? [] : [id];
+    if (rung === "method_path") {
+        const method = stringAttribute(entity, "method");
+        const path = stringAttribute(entity, "path");
+        const port = stringAttribute(entity, "port");
+        return [
+            ...(method !== undefined && path !== undefined
+                ? [`http ${method.toUpperCase()} ${path}`]
+                : []),
+            ...(port === undefined ? [] : [`soap ${port} ${compact(name, normalize)}`]),
+        ];
+    }
+    const titles = [entity.title, name, ...(id === undefined ? [] : [id])];
+    return [...new Set(titles.map((title) => compact(title, normalize)))].filter((key) => key !== "");
+}
+/** The keys a note offers at a rung: the operation identifier, the method and path or the port and title, the title. */
+function noteKeys(note, rung, normalize) {
+    if (rung === "operation_id") {
+        const id = stringAttribute(note, "operation_id");
+        return id === undefined ? [] : [id];
+    }
+    if (rung === "method_path") {
+        const method = stringAttribute(note, "method");
+        const path = stringAttribute(note, "path");
+        const port = stringAttribute(note, "port");
+        return [
+            ...(method !== undefined && path !== undefined
+                ? [`http ${method.toUpperCase()} ${path}`]
+                : []),
+            ...(port === undefined ? [] : [`soap ${port} ${compact(note.title, normalize)}`]),
+        ];
+    }
+    const title = compact(note.title, normalize);
+    return title === "" ? [] : [title];
+}
+/** The operations by API and key at the rung; an operation with several keys sits under each. */
+function keyedOperations(operations, rung, normalize) {
+    const keyed = new Map();
+    for (const operation of operations) {
+        for (const key of operationKeys(operation, rung, normalize)) {
+            const bucket = keyed.get(`${operation.api}\n${key}`) ?? [];
+            bucket.push(operation);
+            keyed.set(`${operation.api}\n${key}`, bucket);
+        }
+    }
+    return keyed;
+}
+/** The operations of the note's candidate APIs whose key equals one of the note's, in entity order. */
+function claimedBy(note, keyed, rung, normalize) {
+    const claimed = new Map();
+    for (const api of note.apis) {
+        for (const key of noteKeys(note.entity, rung, normalize)) {
+            for (const operation of keyed.get(`${api}\n${key}`) ?? []) {
+                claimed.set(operation.entity.id, operation);
+            }
+        }
+    }
+    return [...claimed.values()].sort((a, b) => compareEntities(a.entity, b.entity));
+}
+function claimsAt(rung, notes, operations, normalize) {
+    const keyed = keyedOperations(operations, rung, normalize);
+    const byNote = new Map();
+    const byOperation = new Map();
+    for (const note of notes) {
+        const found = claimedBy(note, keyed, rung, normalize);
+        if (found.length === 0)
+            continue;
+        byNote.set(note.entity.id, found);
+        for (const operation of found) {
+            const claimants = byOperation.get(operation.entity.id) ?? [];
+            claimants.push(note.entity);
+            byOperation.set(operation.entity.id, claimants);
+        }
+    }
+    return { byNote, byOperation };
+}
+/** A note claiming several operations is an ambiguity that settles the note and every operation it claims. */
+function hesitantNotes(rung, notes, claims, out) {
+    for (const note of notes) {
+        const claimed = claims.byNote.get(note.entity.id);
+        if (claimed !== undefined && claimed.length > 1) {
+            out.ids.add(note.entity.id);
+            for (const operation of claimed)
+                out.ids.add(operation.entity.id);
+            out.ambiguities.push({ kind: "note", rung, note: note.entity, operations: claimed });
+        }
+    }
+}
+/** An operation claimed by several notes is an ambiguity that settles the operation and every claimant. */
+function contestedOperations(rung, operations, claims, out) {
+    for (const operation of operations) {
+        const claimants = claims.byOperation.get(operation.entity.id);
+        if (claimants !== undefined && claimants.length > 1) {
+            out.ids.add(operation.entity.id);
+            for (const note of claimants)
+                out.ids.add(note.id);
+            out.ambiguities.push({ kind: "operation", rung, operation, notes: claimants });
+        }
+    }
+}
+/**
+ * A note left unsettled claims exactly one operation, which nobody else claims: the ambiguities
+ * settled every note of a contested operation and every operation of a hesitant note.
+ */
+function oneToOne(rung, notes, claims, out) {
+    for (const note of notes) {
+        const [operation] = claims.byNote.get(note.entity.id) ?? [];
+        if (operation === undefined || out.ids.has(note.entity.id))
+            continue;
+        out.ids.add(note.entity.id);
+        out.ids.add(operation.entity.id);
+        out.matches.push({ note: note.entity, operation, rung });
+    }
+}
+/**
+ * Matches the notes to the operations rung by rung: the operation identifier, then the method and
+ * path (or the port and the operation name for SOAP), then the title in comparison form. At each
+ * rung a note claims the operations of its candidate APIs whose key equals one of its own; a note
+ * claiming several operations, or an operation claimed by several notes, is an ambiguity that
+ * attaches nothing and takes its entities out of the later rungs. The rest attach one to one and
+ * leave the later rungs to the notes and operations still free.
+ */
+export function matchOperations(notes, operations, normalize) {
+    const matches = [];
+    const ambiguities = [];
+    let freeNotes = [...notes];
+    let freeOperations = [...operations];
+    for (const rung of MATCH_RUNGS) {
+        const claims = claimsAt(rung, freeNotes, freeOperations, normalize);
+        const settled = { ids: new Set(), matches, ambiguities };
+        hesitantNotes(rung, freeNotes, claims, settled);
+        contestedOperations(rung, freeOperations, claims, settled);
+        oneToOne(rung, freeNotes, claims, settled);
+        freeNotes = freeNotes.filter((note) => !settled.ids.has(note.entity.id));
+        freeOperations = freeOperations.filter((operation) => !settled.ids.has(operation.entity.id));
+    }
+    return { matches, ambiguities };
+}
+//# sourceMappingURL=match.js.map

package/dist/operations/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../src/operations/match.ts"],"names":[],"mappings":"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"}

package/dist/operations/merge.d.ts

@@ -0,0 +1,14 @@
+import type { Entity, Link } from "@concordance-wiki/core";
+import type { ImportedOperation, MatchRung } from "./match.js";
+/** The `kind` of the representation an imported operation becomes. */
+export declare const CONTRACT_REPRESENTATION = "contract";
+/**
+ * The note absorbs the operation: it keeps its identifier, its file, its title and its frontmatter,
+ * takes the contract attributes it does not set itself, the operation's aliases and its summary
+ * when it has none, and lists the contract as a representation next to its own file, the way twin
+ * resources are listed; `grouped_by` names the rung, after any criterion the note already carried.
+ */
+export declare function mergeOperation(note: Entity, operation: ImportedOperation, rung: MatchRung): Entity;
+/** Every link that named the imported operation now names the note, the `exposes` link of the API first of all. */
+export declare function redirectLinks(links: readonly Link[], redirections: ReadonlyMap<string, string>): Link[];
+//# sourceMappingURL=merge.d.ts.map

package/dist/operations/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/operations/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAwB,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/D,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAqBlD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE,SAAS,GACd,MAAM,CAwBR;AAED,mHAAmH;AACnH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,IAAI,EAAE,CAMR"}

package/dist/operations/merge.js

@@ -0,0 +1,60 @@
+/** The `kind` of the representation an imported operation becomes. */
+export const CONTRACT_REPRESENTATION = "contract";
+function representationFormat(path) {
+    const name = path.slice(path.lastIndexOf("/") + 1);
+    const dot = name.lastIndexOf(".");
+    if (dot === -1)
+        return "file";
+    const extension = name.slice(dot + 1).toLowerCase();
+    return extension === "md" ? "markdown" : extension;
+}
+// Code-unit order, not locale order: the output must not depend on the collation data of the runtime.
+function byCodeUnit(a, b) {
+    return Number(a > b) - Number(a < b);
+}
+function sortedAttributes(attributes) {
+    const sorted = {};
+    for (const key of Object.keys(attributes).sort(byCodeUnit))
+        sorted[key] = attributes[key];
+    return sorted;
+}
+/**
+ * The note absorbs the operation: it keeps its identifier, its file, its title and its frontmatter,
+ * takes the contract attributes it does not set itself, the operation's aliases and its summary
+ * when it has none, and lists the contract as a representation next to its own file, the way twin
+ * resources are listed; `grouped_by` names the rung, after any criterion the note already carried.
+ */
+export function mergeOperation(note, operation, rung) {
+    const imported = operation.entity;
+    const summary = note.summary ?? imported.summary;
+    const aliases = [
+        ...note.aliases,
+        ...imported.aliases.filter((alias) => !note.aliases.includes(alias)),
+    ];
+    const own = note.representations ?? [
+        { path: note.source.path, format: representationFormat(note.source.path) },
+    ];
+    const contract = {
+        path: operation.location,
+        format: representationFormat(operation.location),
+        kind: CONTRACT_REPRESENTATION,
+        operation: operation.name,
+    };
+    return {
+        ...note,
+        aliases,
+        ...(summary === undefined ? {} : { summary }),
+        attributes: sortedAttributes({ ...imported.attributes, ...note.attributes }),
+        representations: [...own, contract],
+        grouped_by: note.grouped_by === undefined ? rung : `${note.grouped_by}, ${rung}`,
+    };
+}
+/** Every link that named the imported operation now names the note, the `exposes` link of the API first of all. */
+export function redirectLinks(links, redirections) {
+    return links.map((link) => {
+        const from = redirections.get(link.from) ?? link.from;
+        const to = redirections.get(link.to) ?? link.to;
+        return from === link.from && to === link.to ? link : { ...link, from, to };
+    });
+}
+//# sourceMappingURL=merge.js.map

package/dist/operations/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/operations/merge.ts"],"names":[],"mappings":"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"}

package/dist/relations/index.d.ts

@@ -0,0 +1,3 @@
+export { relationLabel, type RelationLabelOptions } from "./labels.js";
+export { FALLBACK_RELATION, RELATION_ORIGIN, typeRelations, type TypedEntity, type TypeRelationsInput, type TypeRelationsResult, } from "./type.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/relations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/relations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC"}