@cleocode/core 2026.6.7 → 2026.6.9

package/dist/docs/index.d.ts

@@ -18,6 +18,8 @@ export type { AdrAllocateErr, AdrAllocateOk, AdrAllocateResult, AllocateAdrOptio
 export { allocateAdrSlug, assembleAdrSlug, findHighestAdrNumber, MAX_ADR_ALLOCATION_ATTEMPTS, } from './adr-allocator.js';
 export type { BuildDocProvenanceGraphOptions } from './build-provenance-graph.js';
 export { buildDocProvenanceGraph, DocProvenanceRootNotFoundError, renderProvenanceGraphAsDot, } from './build-provenance-graph.js';
+export type { SetDisplayAliasParams, SetDisplayAliasResult } from './display-alias.js';
+export { SET_ALIAS_INVALID_CODE, SET_ALIAS_NOT_FOUND_CODE, SET_ALIAS_TAKEN_CODE, setDisplayAlias, } from './display-alias.js';
 export type { GenerateDocsOptions, GenerateDocsResult } from './docs-generator.js';
 export { generateDocsLlmsTxt } from './docs-generator.js';
 export type { DocsDriftItem, DocsFindSimilarHit, DocsFindSimilarResult, DocsGraphEdge, DocsGraphNode, DocsGraphResult, DocsMergeResult, DocsProjectSearchHit, DocsProjectSearchResult, DocsPublicationRecord, DocsPublishResult, DocsRankHit, DocsRankResult, DocsSearchHit, DocsSearchResult, DocsStatusResult, DocsSyncFromGitResult, DocsVersionEntry, DocsVersionsResult, } from './docs-ops.js';
@@ -52,6 +54,10 @@ export type { ListProjectDocsOpts, ResolvedDoc } from './docs-read-model.js';
 export { createDocsReadModel, DocsReadModel } from './docs-read-model.js';
 export type { ProvisionResult, PublishPrError, PublishPrOptions, PublishPrResult, PublishPrRunners, PublishPrSuccess, } from './publish-pr.js';
 export { branchForSlug, buildPublishFrontmatter, defaultPublishPrBody, defaultRun, execMsg, KNOWN_DOC_TYPES, knownDocTypesForProject, parseGhPrUrl, pickRunner, provisionPublishPrWorktree, publishDirForType, publishDocsAsPr, publishPrError, stripExistingFrontmatter, teardownPublishPrWorktree, tempWorktreeDirForSlug, validatePublishSlug, } from './publish-pr.js';
+export type { ReadDocOptions } from './read-doc.js';
+export { DocNotFoundError, readDoc } from './read-doc.js';
 export type { VersionAuditResult } from './version-ssot.js';
 export { auditVersionFields, compareCleoVersions, getCanonicalCleoVersion, resolveVersion, VERSION_SSOT_MIGRATION_SQL, versionInRange, } from './version-ssot.js';
+export type { RebuildDocsWikilinksOptions, RebuildDocsWikilinksResult, WikilinkEdge, } from './wikilinks.js';
+export { deriveWikilinkEdges, getDocsWikilinks, rebuildDocsWikilinks } from './wikilinks.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,YAAY,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,8BAA8B,EAC9B,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,YAAY,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKrD,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,EACjC,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,OAAO,EACP,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,0BAA0B,EAC1B,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/docs/index.js

@@ -16,6 +16,7 @@
  */
 export { allocateAdrSlug, assembleAdrSlug, findHighestAdrNumber, MAX_ADR_ALLOCATION_ATTEMPTS, } from './adr-allocator.js';
 export { buildDocProvenanceGraph, DocProvenanceRootNotFoundError, renderProvenanceGraphAsDot, } from './build-provenance-graph.js';
+export { SET_ALIAS_INVALID_CODE, SET_ALIAS_NOT_FOUND_CODE, SET_ALIAS_TAKEN_CODE, setDisplayAlias, } from './display-alias.js';
 export { generateDocsLlmsTxt } from './docs-generator.js';
 export { buildDocsGraph, DEFAULT_FIND_SIMILAR_LIMIT, DEFAULT_FIND_SIMILAR_THRESHOLD, findSimilarDocs, listDocVersions, listPublications, mergeDocs, publishDocs, rankDocs, recordPublication, searchAllProjectDocs, searchDocs, statusDocs, syncFromGit, } from './docs-ops.js';
 export { exportDocument } from './export-document.js';
@@ -38,5 +39,7 @@ export { countAuditEntriesForSlug, DOCS_AUDIT_FILE, readAuditLog, verifyAuditTra
 export { checkBlobFilesystem, checkDocsConsistency, } from './docs-inconsistency-detector.js';
 export { createDocsReadModel, DocsReadModel } from './docs-read-model.js';
 export { branchForSlug, buildPublishFrontmatter, defaultPublishPrBody, defaultRun, execMsg, KNOWN_DOC_TYPES, knownDocTypesForProject, parseGhPrUrl, pickRunner, provisionPublishPrWorktree, publishDirForType, publishDocsAsPr, publishPrError, stripExistingFrontmatter, teardownPublishPrWorktree, tempWorktreeDirForSlug, validatePublishSlug, } from './publish-pr.js';
+export { DocNotFoundError, readDoc } from './read-doc.js';
 export { auditVersionFields, compareCleoVersions, getCanonicalCleoVersion, resolveVersion, VERSION_SSOT_MIGRATION_SQL, versionInRange, } from './version-ssot.js';
+export { deriveWikilinkEdges, getDocsWikilinks, rebuildDocsWikilinks } from './wikilinks.js';
 //# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAsB1D,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,8BAA8B,EAC9B,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,+EAA+E;AAE/E,8EAA8E;AAC9E,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,EACjC,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,uCAAuC,CAAC;AAQ/C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,OAAO,EACP,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AASjC,gFAAgF;AAChF,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAS1E,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,0BAA0B,EAC1B,cAAc,GACf,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"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"}

package/dist/docs/numbering.d.ts

@@ -109,6 +109,35 @@ export declare function parseSlugSequence(slug: string): {
     sequence: number;
     remainder: string;
 } | null;
+/**
+ * Resolve the DISPLAY number to render for a doc, preferring the explicitly
+ * stored {@link import('../store/schema/attachments.js').attachments.displayAlias}
+ * over the number derived from the slug string.
+ *
+ * ## Why this exists (T11875 · ADR reconcile T11676)
+ *
+ * Under the slug-primary model the kebab slug is the canonical handle and the
+ * rendered number (e.g. ADR "051") is a DISPLAY ALIAS only. Historically that
+ * number was DERIVED from the slug via {@link parseSlugSequence} — so three
+ * DISTINCT ADRs slugged `adr-051-*` all rendered "051" with no way to
+ * disambiguate. T11875 added a real `display_alias` column; this resolver makes
+ * the stored alias authoritative while preserving byte-for-byte legacy
+ * behaviour for docs that never had one assigned.
+ *
+ * Precedence:
+ *   1. `storedAlias` — when a non-null positive integer is supplied, it wins
+ *      unconditionally (the alias is the decoupled SSoT).
+ *   2. Slug-derived — otherwise parse the numeric portion out of `slug` via the
+ *      canonical numbering patterns ({@link parseSlugSequence}).
+ *   3. `null` — when neither yields a number (non-numbered kind / no alias).
+ *
+ * @param slug - The doc's canonical slug (e.g. `adr-051-override-patterns`), or
+ *   `null` for slug-less docs.
+ * @param storedAlias - The value of `attachments.display_alias` for this doc, or
+ *   `null` when unset.
+ * @returns The display number to render, or `null` when none can be resolved.
+ */
+export declare function resolveDisplayNumber(slug: string | null | undefined, storedAlias: number | null | undefined): number | null;
 /** Reset in-process state — test-only escape hatch. */
 export declare function _resetNumberingCache_TESTING_ONLY(): void;
 /**

package/dist/docs/numbering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numbering.d.ts","sourceRoot":"","sources":["../../src/docs/numbering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AAQH;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAmDD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,SAAS,CAAC;AAuDjC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAY9D;AAkDD,uDAAuD;AACvD,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AA8ED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,0BAA0B,CAAC,CAOrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAID;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iCAAiC;IAChD,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,iCAAiC,CAAC,CAK5C"}
+{"version":3,"file":"numbering.d.ts","sourceRoot":"","sources":["../../src/docs/numbering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AAQH;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAmDD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,SAAS,CAAC;AAuDjC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAY9D;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,MAAM,GAAG,IAAI,CAUf;AAkDD,uDAAuD;AACvD,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AA8ED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,0BAA0B,CAAC,CAOrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAID;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iCAAiC;IAChD,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,iCAAiC,CAAC,CAK5C"}

package/dist/docs/numbering.js

@@ -180,6 +180,47 @@ export function parseSlugSequence(slug) {
     }
     return null;
 }
+// ─── Display-number resolution (T11875) ───────────────────────────────────────
+/**
+ * Resolve the DISPLAY number to render for a doc, preferring the explicitly
+ * stored {@link import('../store/schema/attachments.js').attachments.displayAlias}
+ * over the number derived from the slug string.
+ *
+ * ## Why this exists (T11875 · ADR reconcile T11676)
+ *
+ * Under the slug-primary model the kebab slug is the canonical handle and the
+ * rendered number (e.g. ADR "051") is a DISPLAY ALIAS only. Historically that
+ * number was DERIVED from the slug via {@link parseSlugSequence} — so three
+ * DISTINCT ADRs slugged `adr-051-*` all rendered "051" with no way to
+ * disambiguate. T11875 added a real `display_alias` column; this resolver makes
+ * the stored alias authoritative while preserving byte-for-byte legacy
+ * behaviour for docs that never had one assigned.
+ *
+ * Precedence:
+ *   1. `storedAlias` — when a non-null positive integer is supplied, it wins
+ *      unconditionally (the alias is the decoupled SSoT).
+ *   2. Slug-derived — otherwise parse the numeric portion out of `slug` via the
+ *      canonical numbering patterns ({@link parseSlugSequence}).
+ *   3. `null` — when neither yields a number (non-numbered kind / no alias).
+ *
+ * @param slug - The doc's canonical slug (e.g. `adr-051-override-patterns`), or
+ *   `null` for slug-less docs.
+ * @param storedAlias - The value of `attachments.display_alias` for this doc, or
+ *   `null` when unset.
+ * @returns The display number to render, or `null` when none can be resolved.
+ */
+export function resolveDisplayNumber(slug, storedAlias) {
+    // (1) Stored alias is the decoupled SSoT — it wins over the slug-derived
+    // number whenever it is a usable positive integer.
+    if (typeof storedAlias === 'number' && Number.isInteger(storedAlias) && storedAlias >= 1) {
+        return storedAlias;
+    }
+    // (2) Fall back to the slug-derived number — unchanged legacy behaviour.
+    if (typeof slug !== 'string' || slug.length === 0)
+        return null;
+    const parsed = parseSlugSequence(slug);
+    return parsed ? parsed.sequence : null;
+}
 // ─── DB inspection (atomic) ───────────────────────────────────────────────────
 /**
  * Module-level promise chain used as an in-process async Mutex around

package/dist/docs/numbering.js.map

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

package/dist/docs/read-doc.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `docs.read` core-SDK implementation — render a single CLEO doc (body + full
+ * provenance frontmatter) directly from `cleo.db`, the SOLE doc authority
+ * (saga T11778).
+ *
+ * This is the live read API the Obsidian plugin (T11827) and `cleo docs view`
+ * call. It is NOT a static export: every call reads the current DB state. The
+ * body is surfaced as UTF-8 text when decodable, else base64 (T11825 AC2), so
+ * binary blobs (images/PDFs) render without a second round-trip.
+ *
+ * Frontmatter is read straight from the `attachments` provenance columns
+ * (`slug`, `doc_version`, `owner_version`, `supersedes`, `superseded_by`,
+ * `topics`, `related_tasks`) — the same columns `docs_wikilinks` derives from —
+ * so the response is self-describing for an external consumer.
+ *
+ * @task T11825 (Epic T11781 / Saga T11778)
+ * @adr ADR-078 — Docs SSoT as provenance graph
+ * @see DocReadResponse — packages/contracts/src/docs/read.ts
+ * @see createDocsReadModel — body fetch + base64 plumbing reuse
+ */
+import type { DocReadResponse } from '@cleocode/contracts';
+/**
+ * Options for {@link readDoc}.
+ *
+ * @task T11825
+ */
+export interface ReadDocOptions {
+    /** Project root for DB resolution. Defaults to {@link getProjectRoot}(). */
+    readonly projectRoot?: string;
+}
+/**
+ * Error raised when {@link readDoc}'s slug cannot be resolved to a doc.
+ *
+ * @task T11825
+ */
+export declare class DocNotFoundError extends Error {
+    constructor(slug: string);
+}
+/**
+ * Read a single doc by slug, returning its body + full provenance frontmatter.
+ *
+ * Resolves the supersedes / superseded-by FK targets to their slugs (the
+ * external-consumer-friendly addressing) and decodes the body to UTF-8 when
+ * possible, falling back to base64 for binary content.
+ *
+ * @example
+ * ```ts
+ * const doc = await readDoc('adr-078-docs-provenance');
+ * console.log(doc.frontmatter.docVersion, doc.frontmatter.topics);
+ * if (doc.body.encoding === 'utf-8') console.log(doc.body.text);
+ * ```
+ *
+ * @param slug - The exact doc slug (case-sensitive).
+ * @param opts - Optional project-root override.
+ * @returns The typed {@link DocReadResponse}.
+ * @throws {DocNotFoundError} when no attachment carries the slug.
+ * @task T11825
+ */
+export declare function readDoc(slug: string, opts?: ReadDocOptions): Promise<DocReadResponse>;
+//# sourceMappingURL=read-doc.d.ts.map

package/dist/docs/read-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-doc.d.ts","sourceRoot":"","sources":["../../src/docs/read-doc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAA2B,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAOpF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,IAAI,EAAE,MAAM;CAIzB;AAmBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwD/F"}

package/dist/docs/read-doc.js

@@ -0,0 +1,188 @@
+/**
+ * `docs.read` core-SDK implementation — render a single CLEO doc (body + full
+ * provenance frontmatter) directly from `cleo.db`, the SOLE doc authority
+ * (saga T11778).
+ *
+ * This is the live read API the Obsidian plugin (T11827) and `cleo docs view`
+ * call. It is NOT a static export: every call reads the current DB state. The
+ * body is surfaced as UTF-8 text when decodable, else base64 (T11825 AC2), so
+ * binary blobs (images/PDFs) render without a second round-trip.
+ *
+ * Frontmatter is read straight from the `attachments` provenance columns
+ * (`slug`, `doc_version`, `owner_version`, `supersedes`, `superseded_by`,
+ * `topics`, `related_tasks`) — the same columns `docs_wikilinks` derives from —
+ * so the response is self-describing for an external consumer.
+ *
+ * @task T11825 (Epic T11781 / Saga T11778)
+ * @adr ADR-078 — Docs SSoT as provenance graph
+ * @see DocReadResponse — packages/contracts/src/docs/read.ts
+ * @see createDocsReadModel — body fetch + base64 plumbing reuse
+ */
+import { Buffer } from 'node:buffer';
+import { eq } from 'drizzle-orm';
+import { getProjectRoot } from '../paths.js';
+import { createAttachmentStore } from '../store/attachment-store.js';
+import { getDb } from '../store/sqlite.js';
+import { attachments } from '../store/tasks-schema.js';
+/**
+ * Error raised when {@link readDoc}'s slug cannot be resolved to a doc.
+ *
+ * @task T11825
+ */
+export class DocNotFoundError extends Error {
+    constructor(slug) {
+        super(`Doc not found: no attachment carries slug '${slug}'`);
+        this.name = 'DocNotFoundError';
+    }
+}
+/**
+ * Read a single doc by slug, returning its body + full provenance frontmatter.
+ *
+ * Resolves the supersedes / superseded-by FK targets to their slugs (the
+ * external-consumer-friendly addressing) and decodes the body to UTF-8 when
+ * possible, falling back to base64 for binary content.
+ *
+ * @example
+ * ```ts
+ * const doc = await readDoc('adr-078-docs-provenance');
+ * console.log(doc.frontmatter.docVersion, doc.frontmatter.topics);
+ * if (doc.body.encoding === 'utf-8') console.log(doc.body.text);
+ * ```
+ *
+ * @param slug - The exact doc slug (case-sensitive).
+ * @param opts - Optional project-root override.
+ * @returns The typed {@link DocReadResponse}.
+ * @throws {DocNotFoundError} when no attachment carries the slug.
+ * @task T11825
+ */
+export async function readDoc(slug, opts = {}) {
+    const projectRoot = opts.projectRoot ?? getProjectRoot();
+    const db = await getDb(projectRoot);
+    const row = await db
+        .select({
+        id: attachments.id,
+        sha256: attachments.sha256,
+        slug: attachments.slug,
+        type: attachments.type,
+        summary: attachments.summary,
+        lifecycleStatus: attachments.lifecycleStatus,
+        supersedes: attachments.supersedes,
+        supersededBy: attachments.supersededBy,
+        topics: attachments.topics,
+        relatedTasks: attachments.relatedTasks,
+        ownerVersion: attachments.ownerVersion,
+        docVersion: attachments.docVersion,
+        createdAt: attachments.createdAt,
+    })
+        .from(attachments)
+        .where(eq(attachments.slug, slug))
+        .get();
+    if (!row)
+        throw new DocNotFoundError(slug);
+    const frontmatterRow = row;
+    // Resolve supersession FK ids → slugs for external addressing.
+    const [supersedesSlug, supersededBySlug] = await Promise.all([
+        resolveSlugById(db, frontmatterRow.supersedes),
+        resolveSlugById(db, frontmatterRow.supersededBy),
+    ]);
+    // Fetch the RAW body bytes (not a decoded string) so binary blobs survive the
+    // base64 path with full fidelity — `TextDecoder` would lossily replace
+    // invalid sequences with U+FFFD.
+    const { bytes, mimeType } = await fetchRawBody(frontmatterRow.sha256, projectRoot);
+    const frontmatter = {
+        slug: frontmatterRow.slug ?? slug,
+        kind: frontmatterRow.type,
+        title: frontmatterRow.slug ?? slug,
+        summary: frontmatterRow.summary,
+        lifecycleStatus: frontmatterRow.lifecycleStatus,
+        docVersion: frontmatterRow.docVersion,
+        ownerVersion: frontmatterRow.ownerVersion,
+        supersedes: supersedesSlug,
+        supersededBy: supersededBySlug,
+        topics: parseStringArray(frontmatterRow.topics),
+        relatedTasks: parseStringArray(frontmatterRow.relatedTasks),
+        sha256: frontmatterRow.sha256,
+        createdAt: frontmatterRow.createdAt,
+    };
+    const body = encodeBody(bytes, mimeType);
+    return { frontmatter, body };
+}
+/**
+ * Read the raw body bytes for a doc by content hash via the content-addressed
+ * attachment store. Returns an empty buffer when the metadata row exists but
+ * the blob was purged from disk.
+ *
+ * @internal
+ */
+async function fetchRawBody(sha256, projectRoot) {
+    const store = createAttachmentStore();
+    try {
+        const result = await store.get(sha256, projectRoot);
+        if (result) {
+            const mime = result.metadata.attachment.mime;
+            return { bytes: result.bytes, mimeType: typeof mime === 'string' ? mime : null };
+        }
+    }
+    catch {
+        // Attachment store unavailable or blob purged — fall through to empty body.
+    }
+    return { bytes: Buffer.alloc(0), mimeType: null };
+}
+/**
+ * Resolve an attachment id to its slug, or null when the id is absent /
+ * unresolved / slug-less.
+ *
+ * @internal
+ */
+async function resolveSlugById(db, id) {
+    if (!id)
+        return null;
+    const row = await db
+        .select({ slug: attachments.slug })
+        .from(attachments)
+        .where(eq(attachments.id, id))
+        .get();
+    return row?.slug ?? null;
+}
+/**
+ * Encode a doc body from its raw bytes. UTF-8-decodable content (the common
+ * markdown case) is surfaced as `text`; binary content (images/PDFs/files) is
+ * surfaced as `base64` so an external consumer can render it (T11825 AC2).
+ *
+ * UTF-8 validity is detected by a lossless decode→re-encode round-trip: invalid
+ * sequences decode to U+FFFD and fail to re-encode to the original bytes.
+ *
+ * @internal
+ */
+function encodeBody(bytes, mimeType) {
+    const text = bytes.toString('utf-8');
+    const isUtf8 = Buffer.from(text, 'utf-8').equals(bytes);
+    if (isUtf8) {
+        return { encoding: 'utf-8', text, sizeBytes: bytes.length, mimeType };
+    }
+    return {
+        encoding: 'base64',
+        base64: bytes.toString('base64'),
+        sizeBytes: bytes.length,
+        mimeType,
+    };
+}
+/**
+ * Parse a JSON-array-of-strings column, tolerating null / malformed values.
+ *
+ * @internal
+ */
+function parseStringArray(raw) {
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((v) => typeof v === 'string' && v.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=read-doc.js.map

package/dist/docs/read-doc.js.map

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

package/dist/docs/wikilinks.d.ts

@@ -0,0 +1,119 @@
+/**
+ * `docs_wikilinks` — derive + query the slug-addressed docs edge table.
+ *
+ * Per the ratified Docs-SSoT model (saga T11778) `cleo.db` is the SOLE doc
+ * authority and `docs_wikilinks` is a **DERIVED, non-authoritative** edge table
+ * reconstructed from three provenance columns already on `attachments`:
+ *
+ *   - `supersedes` / `superseded_by` → doc→doc supersession edges
+ *   - `related_tasks`                → doc→T#### task edges (JSON array)
+ *   - `topics`                       → doc↔doc shared-topic edges (JSON array)
+ *
+ * No markdown body `[[link]]` parsing is performed (T11826 AC4) — the edges
+ * derive purely from structured columns. The derivation is **idempotent**: it
+ * truncates and rebuilds the whole table, so callers may re-run it after any
+ * `docs add` / `supersede` / `docs update` write to keep the graph fresh.
+ *
+ * This module is the runtime twin of the SQL backfill in
+ * `migrations/drizzle-tasks/20260605000001_t11826-docs-wikilinks/migration.sql`
+ * — the migration seeds the table on schema upgrade, this function rebuilds it
+ * on demand.
+ *
+ * @task T11826 (Epic T11781 / Saga T11778)
+ * @adr ADR-078 — Docs SSoT as provenance graph
+ * @see build-provenance-graph.ts — the on-the-fly BFS this table makes O(edges)
+ */
+import { type DocsWikilinkRelation } from '../store/schema/attachments.js';
+/**
+ * A single slug-addressed wikilink edge.
+ *
+ * @task T11826
+ */
+export interface WikilinkEdge {
+    /** Source doc slug (always a doc). */
+    readonly fromSlug: string;
+    /** Target slug — a doc slug, or a `T####` task id when {@link toIsTask}. */
+    readonly toSlug: string;
+    /** Which provenance column produced this edge. */
+    readonly relation: DocsWikilinkRelation;
+    /** True when {@link toSlug} is a task id (`related-task` edges). */
+    readonly toIsTask: boolean;
+}
+/**
+ * Options shared by {@link rebuildDocsWikilinks}.
+ *
+ * @task T11826
+ */
+export interface RebuildDocsWikilinksOptions {
+    /** Project root for DB resolution. Defaults to {@link getProjectRoot}(). */
+    readonly projectRoot?: string;
+}
+/**
+ * Outcome of a {@link rebuildDocsWikilinks} call.
+ *
+ * @task T11826
+ */
+export interface RebuildDocsWikilinksResult {
+    /** Number of edges in the table after the rebuild. */
+    readonly edgeCount: number;
+    /** Per-relation edge counts. */
+    readonly byRelation: Readonly<Record<DocsWikilinkRelation, number>>;
+}
+/** Narrow row shape read from `attachments` during derivation. */
+interface DerivationRow {
+    readonly slug: string;
+    readonly supersedesSlug: string | null;
+    readonly supersededBySlug: string | null;
+    readonly relatedTasks: string | null;
+    readonly topics: string | null;
+}
+/**
+ * Idempotently rebuild the `docs_wikilinks` edge table from the provenance
+ * columns on `attachments`.
+ *
+ * The whole table is truncated and re-derived inside a single transaction, so
+ * the function is safe to call after any doc write and always converges to the
+ * same edge set for a given `attachments` state.
+ *
+ * @example
+ * ```ts
+ * const { edgeCount, byRelation } = await rebuildDocsWikilinks();
+ * console.log(`derived ${edgeCount} edges (${byRelation['topic']} topic links)`);
+ * ```
+ *
+ * @param opts - Optional project-root override.
+ * @returns Edge totals after the rebuild.
+ * @task T11826
+ */
+export declare function rebuildDocsWikilinks(opts?: RebuildDocsWikilinksOptions): Promise<RebuildDocsWikilinksResult>;
+/**
+ * Pure derivation: turn slugged `attachments` rows into the full edge set.
+ *
+ * Exposed for unit testing the derivation rules without a database. The output
+ * is deduplicated on the (`fromSlug`, `toSlug`, `relation`) composite key.
+ *
+ * @param rows - Slugged attachment rows with their provenance columns.
+ * @returns The derived wikilink edges.
+ * @task T11826
+ */
+export declare function deriveWikilinkEdges(rows: readonly DerivationRow[]): WikilinkEdge[];
+/**
+ * Read all wikilink edges incident to a doc slug — **bidirectional** by default.
+ *
+ * Returns both outbound edges (`from_slug = slug`) and inbound backlinks
+ * (`to_slug = slug`). This is the query the Obsidian plugin (T11827) renders to
+ * show a doc's neighborhood, and what `cleo docs graph` hydrates for persisted
+ * backlinks.
+ *
+ * @param slug - The doc slug to fetch edges for.
+ * @param opts.direction - `'both'` (default), `'out'`, or `'in'`.
+ * @param opts.projectRoot - Project root override.
+ * @returns The incident edges.
+ * @task T11826
+ */
+export declare function getDocsWikilinks(slug: string, opts?: {
+    direction?: 'both' | 'out' | 'in';
+    projectRoot?: string;
+}): Promise<WikilinkEdge[]>;
+export {};
+//# sourceMappingURL=wikilinks.d.ts.map

package/dist/docs/wikilinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikilinks.d.ts","sourceRoot":"","sources":["../../src/docs/wikilinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,gCAAgC,CAAC;AAI1F;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;CACrE;AAED,kEAAkE;AAClE,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,2BAAgC,GACrC,OAAO,CAAC,0BAA0B,CAAC,CAoErC;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,YAAY,EAAE,CAoDlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,OAAO,CAAC,YAAY,EAAE,CAAC,CAmBzB"}