@skillcdn/core 0.0.0-stage → 0.1.0

package/LICENSE.md

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 KDX Labs Corp.
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -1,3 +1,60 @@
-# Temporary Holding Version
+# @skillcdn/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The contracts of [SkillCDN](https://skillcdn.ai), which turns any git repository into an MCP server: the address scheme, the skill-repo convention, the tool contracts, the REST schemas, the types of an index, and the ports the rest of the system implements. Pure TypeScript with no I/O and no Node.js APIs: it runs unchanged in the server, in tests, in a browser, and in whatever else reads or writes a SkillCDN address.
+
+```sh
+npm install @skillcdn/core
+```
+
+## What belongs here
+
+| Area | Spec |
+|---|---|
+| Address parser and formatter | [address.md](https://github.com/skillcdn/skillcdn/blob/main/docs/specs/address.md) |
+| Skill-repo convention parser (front-matter, layouts, manifests) | [skill-repo.md](https://github.com/skillcdn/skillcdn/blob/main/docs/specs/skill-repo.md) |
+| Tool contracts: names, input and output schemas | [tools.md](https://github.com/skillcdn/skillcdn/blob/main/docs/specs/tools.md) |
+| Permission rules: the decision logic, given facts fetched elsewhere | [permissions.md](https://github.com/skillcdn/skillcdn/blob/main/docs/specs/permissions.md) |
+| REST contracts: the schemas of the public API, and of what a signed-in person has (`rest/account.ts`) | [rest.md](https://github.com/skillcdn/skillcdn/blob/main/docs/specs/rest.md) |
+| The types of an index: what the reading rules produce for a commit and what the store keeps (`IndexEntry`, `SnapshotIndex`, `SkillFrontMatter`, `SnapshotDiagnostic`, `StoredTranslation`) | [ADR-0045](https://github.com/skillcdn/skillcdn/blob/main/docs/adr/0045-the-indexer-is-a-package-and-check-is-a-command.md) |
+| Ports: git host (`GitHost` for content, `GitHostLogin` for signing in and what a person can see, `GitHostDirectory` for an account's public listing, `GitHostEventSource` for what the host says happened, as the events that end what is remembered), blob store, clock and ids, `Entitlements`, `UsageSink` | [architecture.md](https://github.com/skillcdn/skillcdn/blob/main/docs/architecture.md#extension-points) |
+| The mark of the site as path data, so that the pages, the favicon and the social previews the server draws show one shape | [apps/web/README.md](https://github.com/skillcdn/skillcdn/blob/main/apps/web/README.md) |
+
+## What does not
+
+Network calls, SQL, file access, environment variables, logging setup, HTTP types. Those live in adapters that implement the ports defined here. The reading rules that turn a commit into an index are [`@skillcdn/indexer`](https://www.npmjs.com/package/@skillcdn/indexer).
+
+## Usage
+
+```ts
+import { formatAddress, parseAddress } from "@skillcdn/core";
+
+const parsed = parseAddress("/gh/acme/skills@v1.2.0/marketing");
+if (parsed.ok) {
+  parsed.value.ref; // { kind: "name", name: "v1.2.0" }
+  formatAddress(parsed.value); // the canonical spelling
+} else {
+  parsed.error.code; // a stable, typed reason
+}
+```
+
+Parsers return a `Result` and never throw. A `RepoPath` can only come from `parseRepoPath`, so a function that takes one does not need to think about traversal.
+
+`extractMarkdownReferences(sourcePath, markdown)` recognizes local `.md` links in prose and resolves them to repository-root paths. It ignores code and external URLs and bounds input size and reference count. `resolveMarkdownReference` exposes the same path resolution for a single destination. These helpers identify references; the indexer decides whether their destinations may be served.
+
+`inspectMarkdownReferences` also reports when those inspection bounds are reached. `browseCatalogFiles` builds immediate folder entries and descendant counts from already published files; both the server and the working-tree check use it.
+
+`isServedPath` combines skill declarations, the nearest repository manifest's document directories, and explicit includes. A valid `SKILL.md` can declare a skill anywhere, including a hidden directory. A declaration permits ordinary descendants; further hidden descendants need their own declaration or a Markdown link.
+
+`isSharedIncludePath` says whether a skill may include a document from outside its directory: a page served under a document directory that a manifest at or above the skill declares ([ADR-0044](https://github.com/skillcdn/skillcdn/blob/main/docs/adr/0044-a-skill-may-include-a-page-of-a-shared-document-set.md)). `resolveRepoPath` resolves a path written as a link destination is, from the repository root with a leading `/` or relative to a directory; links and include lists share it.
+
+Ancestor `exclude` paths and unreadable manifest scopes take precedence over publication. `selectReadmePaths` and `folderOverview` supply optional original-language introductions without loading their bodies or adding search results. MCP discovery summaries and serialized response budgets keep selection separate from full context loading; REST retains full metadata.
+
+For the MCP skills extension: `skillDocumentInput` and `assembleSkillDocument` turn a skill's sources into the one document it is served as, so that the indexer's digest and the reader's bytes agree; `renderSkillSections` gives the tools the same sections; `skillListingProblem` says why a skill cannot be listed; `formatSkillUri` and `parseSkillUri` implement the URI grammar; `decodeText` is the one UTF-8 decoder every adapter uses.
+
+`parseOwnerPath` and `formatOwnerPath` read and write `/gh/<owner>`, the path of the page of an account, with the owner rules of the address grammar. `rest/account.ts` also holds the paths the pages and the server share for signing in (`AUTH_ROUTES`, `loginPath`, and `SIGN_IN_PARAM` with `signInPath`, by which the server asks a page to open the sign-in dialog and tells it why a sign-in did not complete), the account pages and the consent page, so that neither side spells them on its own.
+
+Everything public is exported from `src/index.ts`. There are no deep imports.
+
+## Status
+
+Pre-1.0: the surface may change between minor versions, and the changelog says what changed. The specifications linked above describe the contracts; the code follows them.

package/dist/access.d.ts

@@ -0,0 +1,7 @@
+import type { HostRepository } from "./ports/git-host.js";
+/**
+ * Whether a repository may be served to a caller who has not authenticated. Fails closed: only a
+ * repository the host reports as public qualifies, whatever credentials fetched the answer.
+ */
+export declare function isAnonymouslyReadable(repository: HostRepository): boolean;
+//# sourceMappingURL=access.d.ts.map

package/dist/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAEzE"}

package/dist/access.js

@@ -0,0 +1,8 @@
+/**
+ * Whether a repository may be served to a caller who has not authenticated. Fails closed: only a
+ * repository the host reports as public qualifies, whatever credentials fetched the answer.
+ */
+export function isAnonymouslyReadable(repository) {
+    return repository.visibility === "public";
+}
+//# sourceMappingURL=access.js.map

package/dist/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAA0B;IAC9D,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ,CAAC;AAC5C,CAAC"}

package/dist/address.d.ts

@@ -0,0 +1,55 @@
+import { type RepoPath } from "./repo-path.js";
+import { type Result } from "./result.js";
+export declare const MAX_ADDRESS_LENGTH = 2048;
+/** Git hosts an address can name. `gh` is GitHub. */
+export declare const GIT_HOST_KEYS: readonly ["gh"];
+export type GitHostKey = (typeof GIT_HOST_KEYS)[number];
+export type AddressRef = 
+/** A full commit hash, lowercase. The address is pinned: its content never changes. */
+{
+    readonly kind: "commit";
+    readonly hash: string;
+}
+/** A branch, a tag or anything else the host resolves. The address is moving. */
+ | {
+    readonly kind: "name";
+    readonly name: string;
+};
+export interface Address {
+    readonly host: GitHostKey;
+    /** Canonical spelling: lowercase on hosts that match names case-insensitively. */
+    readonly owner: string;
+    readonly repo: string;
+    /** `undefined` means the default branch. */
+    readonly ref: AddressRef | undefined;
+    /** Directory the address mounts; the root path mounts the whole repository. */
+    readonly path: RepoPath;
+}
+export type AddressErrorCode = "not_absolute" | "too_long" | "bad_encoding" | "forbidden_character" | "empty_segment" | "dot_segment" | "unknown_host" | "missing_repo" | "invalid_owner" | "invalid_repo" | "empty_ref" | "invalid_ref" | "invalid_path";
+export interface AddressError {
+    readonly code: AddressErrorCode;
+    readonly message: string;
+}
+/**
+ * Parses the path of an endpoint URL, for example `/gh/acme/skills@v1.2.0/marketing`.
+ * Total: every input yields an address or a typed error, and nothing here touches the network.
+ */
+export declare function parseAddress(input: string): Result<Address, AddressError>;
+/** The canonical spelling of an address. `formatAddress(parseAddress(x).value)` is the canonical form of `x`. */
+export declare function formatAddress(address: Address): string;
+/** An account on a git host, as the path of its page names it. */
+export interface OwnerPath {
+    readonly host: GitHostKey;
+    /** Canonical spelling: lowercase on hosts that match names case-insensitively. */
+    readonly owner: string;
+}
+/**
+ * Parses `/gh/<owner>`: the path of the page of an account. It is one segment short of an
+ * address, serves people and never MCP. `undefined` for anything else; an owner is written with
+ * unreserved characters only, so nothing is percent-decoded.
+ */
+export declare function parseOwnerPath(input: string): OwnerPath | undefined;
+export declare function formatOwnerPath(owner: OwnerPath): string;
+/** Pinned addresses name a full commit hash and may be cached indefinitely; everything else moves. */
+export declare function isPinnedAddress(address: Address): boolean;
+//# sourceMappingURL=address.d.ts.map

package/dist/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAKnD,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,qDAAqD;AACrD,eAAO,MAAM,aAAa,YAAI,IAAI,CAAU,CAAC;AAC7C,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,MAAM,MAAM,UAAU;AACpB,uFAAuF;AACrF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACpD,iFAAiF;GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,UAAU,GACV,cAAc,GACd,qBAAqB,GACrB,eAAe,GACf,aAAa,GACb,cAAc,GACd,cAAc,GACd,eAAe,GACf,cAAc,GACd,WAAW,GACX,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAiCD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAmFzE;AASD,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAatD;AAED,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAenE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAExD;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzD"}

package/dist/address.js

@@ -0,0 +1,162 @@
+import { isFullCommitHash, isValidRefName } from "./git-ref.js";
+import { parseRepoPath } from "./repo-path.js";
+import { err, ok } from "./result.js";
+import { hasForbiddenCodePoint } from "./text-safety.js";
+// Grammar and semantics: docs/specs/address.md.
+export const MAX_ADDRESS_LENGTH = 2048;
+/** Git hosts an address can name. `gh` is GitHub. */
+export const GIT_HOST_KEYS = ["gh"];
+const HOST_NAMING_RULES = {
+    gh: {
+        // Managed-user accounts carry an underscore suffix, so "_" is allowed after the first character.
+        owner: /^[a-z0-9][a-z0-9_-]{0,38}$/i,
+        repo: /^[a-z0-9._-]{1,100}$/i,
+        caseInsensitive: true,
+    },
+};
+function fail(code, message) {
+    return err({ code, message });
+}
+function isGitHostKey(value) {
+    return GIT_HOST_KEYS.includes(value);
+}
+function decodeSegment(raw) {
+    try {
+        return decodeURIComponent(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parses the path of an endpoint URL, for example `/gh/acme/skills@v1.2.0/marketing`.
+ * Total: every input yields an address or a typed error, and nothing here touches the network.
+ */
+export function parseAddress(input) {
+    if (!input.startsWith("/")) {
+        return fail("not_absolute", 'an address starts with "/"');
+    }
+    if (input.length > MAX_ADDRESS_LENGTH) {
+        return fail("too_long", `an address is at most ${MAX_ADDRESS_LENGTH} characters`);
+    }
+    const segments = [];
+    for (const raw of input.slice(1).split("/")) {
+        if (raw.length === 0) {
+            return fail("empty_segment", "an address has no empty segments and no trailing slash");
+        }
+        const segment = decodeSegment(raw);
+        if (segment === undefined) {
+            return fail("bad_encoding", "an address must be valid percent-encoded UTF-8");
+        }
+        // An encoded slash would mean different things before and after a proxy decodes it.
+        if (segment.includes("/") || segment.includes("\\") || hasForbiddenCodePoint(segment)) {
+            return fail("forbidden_character", "an address has no encoded slashes, backslashes or control characters");
+        }
+        if (segment === "." || segment === "..") {
+            return fail("dot_segment", 'an address has no "." or ".." segments');
+        }
+        segments.push(segment);
+    }
+    const [host, owner, repoSegment, ...rest] = segments;
+    if (host === undefined || !isGitHostKey(host)) {
+        return fail("unknown_host", `unknown git host; expected one of: ${GIT_HOST_KEYS.join(", ")}`);
+    }
+    if (owner === undefined || repoSegment === undefined) {
+        return fail("missing_repo", "an address names an owner and a repository");
+    }
+    const rules = HOST_NAMING_RULES[host];
+    if (!rules.owner.test(owner)) {
+        return fail("invalid_owner", "the owner is not a valid account name on this git host");
+    }
+    const at = repoSegment.indexOf("@");
+    const repo = at < 0 ? repoSegment : repoSegment.slice(0, at);
+    if (!rules.repo.test(repo) || repo === "." || repo === ".." || /\.git$/i.test(repo)) {
+        return fail("invalid_repo", "the repository is not a valid repository name on this git host");
+    }
+    let ref;
+    let pathInput;
+    if (at < 0) {
+        pathInput = rest.join("/");
+    }
+    else {
+        // The ref ends at the first ":" if there is one, otherwise at the first "/".
+        const tail = [repoSegment.slice(at + 1), ...rest].join("/");
+        const colon = tail.indexOf(":");
+        const end = colon >= 0 ? colon : tail.indexOf("/");
+        const refText = end < 0 ? tail : tail.slice(0, end);
+        pathInput = end < 0 ? "" : tail.slice(end + 1);
+        if (refText.length === 0) {
+            return fail("empty_ref", 'a ref follows "@"');
+        }
+        if (isFullCommitHash(refText)) {
+            ref = { kind: "commit", hash: refText.toLowerCase() };
+        }
+        else if (isValidRefName(refText)) {
+            ref = { kind: "name", name: refText };
+        }
+        else {
+            return fail("invalid_ref", "the ref is not a valid git ref name");
+        }
+    }
+    const path = parseRepoPath(pathInput);
+    if (!path.ok) {
+        return fail("invalid_path", path.error.message);
+    }
+    return ok({
+        host,
+        owner: rules.caseInsensitive ? owner.toLowerCase() : owner,
+        repo: rules.caseInsensitive ? repo.toLowerCase() : repo,
+        ref,
+        path: path.value,
+    });
+}
+function encodeSlashSeparated(value) {
+    return value
+        .split("/")
+        .map((segment) => encodeURIComponent(segment).replaceAll("%40", "@").replaceAll("%3A", ":"))
+        .join("/");
+}
+/** The canonical spelling of an address. `formatAddress(parseAddress(x).value)` is the canonical form of `x`. */
+export function formatAddress(address) {
+    const repo = `/${address.host}/${address.owner}/${address.repo}`;
+    const path = encodeSlashSeparated(address.path);
+    if (address.ref === undefined) {
+        return path.length === 0 ? repo : `${repo}/${path}`;
+    }
+    const refText = address.ref.kind === "commit" ? address.ref.hash : address.ref.name;
+    const mounted = `${repo}@${encodeSlashSeparated(refText)}`;
+    // Without the explicit terminator, a "/" in the ref or a ":" in the path would be read back differently.
+    if (refText.includes("/") || address.path.includes(":")) {
+        return `${mounted}:${path}`;
+    }
+    return path.length === 0 ? mounted : `${mounted}/${path}`;
+}
+/**
+ * Parses `/gh/<owner>`: the path of the page of an account. It is one segment short of an
+ * address, serves people and never MCP. `undefined` for anything else; an owner is written with
+ * unreserved characters only, so nothing is percent-decoded.
+ */
+export function parseOwnerPath(input) {
+    if (input.length > MAX_ADDRESS_LENGTH) {
+        return undefined;
+    }
+    const [empty, host, owner, ...rest] = input.split("/");
+    if (empty !== "" || host === undefined || owner === undefined || rest.length > 0) {
+        return undefined;
+    }
+    if (!isGitHostKey(host)) {
+        return undefined;
+    }
+    const rules = HOST_NAMING_RULES[host];
+    return rules.owner.test(owner)
+        ? { host, owner: rules.caseInsensitive ? owner.toLowerCase() : owner }
+        : undefined;
+}
+export function formatOwnerPath(owner) {
+    return `/${owner.host}/${owner.owner}`;
+}
+/** Pinned addresses name a full commit hash and may be cached indefinitely; everything else moves. */
+export function isPinnedAddress(address) {
+    return address.ref?.kind === "commit";
+}
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

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

package/dist/brand.d.ts

@@ -0,0 +1,20 @@
+/** The symbol: two interlocking halves of an S, centred in a 100 by 100 box. */
+export declare const BRAND_SYMBOL_PATH = "M97.39 67.65C96.39 51.77 83.22 39.18 67.08 39.18C66.71 39.18 66.35 39.23 65.98 39.24C71.37 41.43 75.17 46.72 75.17 52.9C75.17 61.05 68.57 67.65 60.42 67.65L36.77 67.65L34.86 67.65C16.99 67.65 2.51 82.13 2.51 100L61.04 100L67.08 100C83.88 100 97.49 86.39 97.49 69.59C97.49 68.94 97.44 68.3 97.39 67.65Z M2.61 32.35C3.61 48.23 16.78 60.82 32.92 60.82C33.29 60.82 33.65 60.77 34.02 60.76C28.63 58.57 24.83 53.28 24.83 47.1C24.83 38.95 31.43 32.35 39.58 32.35L63.23 32.35L65.14 32.35C83.01 32.35 97.49 17.87 97.49 0L38.96 0L32.92 0C16.12 0 2.51 13.61 2.51 30.41C2.51 31.06 2.56 31.7 2.61 32.35Z";
+/** The symbol's own blue. It is the symbol's colour and not an interface colour: the symbol is drawn in it everywhere, on light and on dark alike. */
+export declare const BRAND_SYMBOL_COLOR = "#3a6dd4";
+/**
+ * The wordmark, in the coordinates of the lockup: the symbol's 100 by 100 box at the left, the
+ * word at the distance the brand file sets. It is drawn in black on light grounds and in white on
+ * dark ones, and in no other colour.
+ */
+export declare const BRAND_WORDMARK_PATH = "M187.74 34.15L187.74 33.73C187.74 30.09 184.72 27.07 181.08 27.07L151.54 27.07C147.89 27.07 144.88 30.09 144.88 33.73L144.88 34.15C144.88 37.78 147.89 40.8 151.54 40.8L177.75 40.8C184.51 40.8 190.55 43.71 194.71 48.29C195.02 48.6 195.23 48.92 195.54 49.23C198.76 53.18 200.74 58.28 200.74 63.79C200.74 76.48 190.44 86.78 177.75 86.78L154.97 86.78C142.28 86.78 131.98 76.48 131.98 63.79L144.98 63.79C144.98 69.3 149.45 73.78 154.97 73.78L177.75 73.78C183.26 73.78 187.84 69.3 187.84 63.79C187.84 58.28 183.26 53.8 177.75 53.8L151.54 53.8C146.23 53.8 141.44 51.72 137.91 48.29C136.97 47.36 136.14 46.32 135.41 45.17C133.23 42.05 131.98 38.2 131.98 34.04L131.98 33.62C131.98 22.8 140.72 13.96 151.54 13.96L181.08 13.96C191.9 13.96 200.74 22.8 200.74 33.62L200.74 34.04L187.74 34.15Z M252.12 43.19L283.64 86.78L267.62 86.78L242.45 52.04L224.04 68.79L224.04 86.78L211.03 86.78L211.03 13.96L224.04 13.96L224.04 51.2L234.75 41.43L244.43 32.58L264.71 13.96L283.95 13.96L252.12 43.19Z M294.35 33.75L307.36 33.75L307.36 86.78L294.35 86.78ZZ M294.35 13.11L307.36 13.11L307.36 26.12L294.35 26.12ZZ M317.76 13.96L330.76 13.96L330.76 86.78L317.76 86.78ZZ M341.16 13.96L354.17 13.96L354.17 86.78L341.16 86.78ZZ M377.57 50.37C377.57 63.27 388.08 73.78 400.98 73.78L437.39 73.78L437.39 86.78L400.98 86.78C380.9 86.78 364.57 70.45 364.57 50.37C364.57 30.29 380.9 13.96 400.98 13.96L437.39 13.96L437.39 26.97L400.98 26.97C388.08 26.97 377.57 37.47 377.57 50.37Z M460.68 73.88L484.09 73.88C496.99 73.88 507.49 63.38 507.49 50.48C507.49 37.58 496.99 27.07 484.09 27.07L460.68 27.07L460.68 73.88ZM484.09 14.07C504.17 14.07 520.5 30.29 520.5 50.37C520.5 59.32 517.27 67.54 511.86 73.88C511.24 74.61 510.51 75.34 509.78 76.07C503.23 82.72 494.18 86.78 484.19 86.78L447.78 86.78L447.78 13.96L484.09 14.07Z M603.82 14.07L603.82 86.89L590.81 76.9L544 40.8L544 86.89L531 86.89L531 14.27L544 24.26L590.81 60.36L590.81 13.96L603.82 14.07Z";
+/** The lockup, symbol and wordmark together: its width for a height of 100. */
+export declare const BRAND_LOCKUP_WIDTH = 603.82;
+/** The box the wordmark alone occupies within the lockup: x, y, width, height. */
+export declare const BRAND_WORDMARK_BOX: {
+    readonly x: 131.98;
+    readonly y: 13.11;
+    readonly width: 471.84;
+    readonly height: 73.77;
+};
+//# sourceMappingURL=brand.d.ts.map

package/dist/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAIA,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,mlBACojB,CAAC;AAEnlB,sJAAsJ;AACtJ,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,y3DACw1D,CAAC;AAEz3D,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,kFAAkF;AAClF,eAAO,MAAM,kBAAkB;aAAK,CAAC,EAAE,MAAM;aAAE,CAAC,EAAE,KAAK;aAAE,KAAK,EAAE,MAAM;aAAE,MAAM,EAAE,KAAK;CAAW,CAAC"}

package/dist/brand.js

@@ -0,0 +1,18 @@
+// The mark of the site, as path data, so that every place that draws it (the pages, the
+// favicon, the social previews the server draws) draws the same shape. The files under
+// apps/web/public/brand/ carry the same paths for whoever needs a picture; a test keeps them equal.
+/** The symbol: two interlocking halves of an S, centred in a 100 by 100 box. */
+export const BRAND_SYMBOL_PATH = "M97.39 67.65C96.39 51.77 83.22 39.18 67.08 39.18C66.71 39.18 66.35 39.23 65.98 39.24C71.37 41.43 75.17 46.72 75.17 52.9C75.17 61.05 68.57 67.65 60.42 67.65L36.77 67.65L34.86 67.65C16.99 67.65 2.51 82.13 2.51 100L61.04 100L67.08 100C83.88 100 97.49 86.39 97.49 69.59C97.49 68.94 97.44 68.3 97.39 67.65Z M2.61 32.35C3.61 48.23 16.78 60.82 32.92 60.82C33.29 60.82 33.65 60.77 34.02 60.76C28.63 58.57 24.83 53.28 24.83 47.1C24.83 38.95 31.43 32.35 39.58 32.35L63.23 32.35L65.14 32.35C83.01 32.35 97.49 17.87 97.49 0L38.96 0L32.92 0C16.12 0 2.51 13.61 2.51 30.41C2.51 31.06 2.56 31.7 2.61 32.35Z";
+/** The symbol's own blue. It is the symbol's colour and not an interface colour: the symbol is drawn in it everywhere, on light and on dark alike. */
+export const BRAND_SYMBOL_COLOR = "#3a6dd4";
+/**
+ * The wordmark, in the coordinates of the lockup: the symbol's 100 by 100 box at the left, the
+ * word at the distance the brand file sets. It is drawn in black on light grounds and in white on
+ * dark ones, and in no other colour.
+ */
+export const BRAND_WORDMARK_PATH = "M187.74 34.15L187.74 33.73C187.74 30.09 184.72 27.07 181.08 27.07L151.54 27.07C147.89 27.07 144.88 30.09 144.88 33.73L144.88 34.15C144.88 37.78 147.89 40.8 151.54 40.8L177.75 40.8C184.51 40.8 190.55 43.71 194.71 48.29C195.02 48.6 195.23 48.92 195.54 49.23C198.76 53.18 200.74 58.28 200.74 63.79C200.74 76.48 190.44 86.78 177.75 86.78L154.97 86.78C142.28 86.78 131.98 76.48 131.98 63.79L144.98 63.79C144.98 69.3 149.45 73.78 154.97 73.78L177.75 73.78C183.26 73.78 187.84 69.3 187.84 63.79C187.84 58.28 183.26 53.8 177.75 53.8L151.54 53.8C146.23 53.8 141.44 51.72 137.91 48.29C136.97 47.36 136.14 46.32 135.41 45.17C133.23 42.05 131.98 38.2 131.98 34.04L131.98 33.62C131.98 22.8 140.72 13.96 151.54 13.96L181.08 13.96C191.9 13.96 200.74 22.8 200.74 33.62L200.74 34.04L187.74 34.15Z M252.12 43.19L283.64 86.78L267.62 86.78L242.45 52.04L224.04 68.79L224.04 86.78L211.03 86.78L211.03 13.96L224.04 13.96L224.04 51.2L234.75 41.43L244.43 32.58L264.71 13.96L283.95 13.96L252.12 43.19Z M294.35 33.75L307.36 33.75L307.36 86.78L294.35 86.78ZZ M294.35 13.11L307.36 13.11L307.36 26.12L294.35 26.12ZZ M317.76 13.96L330.76 13.96L330.76 86.78L317.76 86.78ZZ M341.16 13.96L354.17 13.96L354.17 86.78L341.16 86.78ZZ M377.57 50.37C377.57 63.27 388.08 73.78 400.98 73.78L437.39 73.78L437.39 86.78L400.98 86.78C380.9 86.78 364.57 70.45 364.57 50.37C364.57 30.29 380.9 13.96 400.98 13.96L437.39 13.96L437.39 26.97L400.98 26.97C388.08 26.97 377.57 37.47 377.57 50.37Z M460.68 73.88L484.09 73.88C496.99 73.88 507.49 63.38 507.49 50.48C507.49 37.58 496.99 27.07 484.09 27.07L460.68 27.07L460.68 73.88ZM484.09 14.07C504.17 14.07 520.5 30.29 520.5 50.37C520.5 59.32 517.27 67.54 511.86 73.88C511.24 74.61 510.51 75.34 509.78 76.07C503.23 82.72 494.18 86.78 484.19 86.78L447.78 86.78L447.78 13.96L484.09 14.07Z M603.82 14.07L603.82 86.89L590.81 76.9L544 40.8L544 86.89L531 86.89L531 14.27L544 24.26L590.81 60.36L590.81 13.96L603.82 14.07Z";
+/** The lockup, symbol and wordmark together: its width for a height of 100. */
+export const BRAND_LOCKUP_WIDTH = 603.82;
+/** The box the wordmark alone occupies within the lockup: x, y, width, height. */
+export const BRAND_WORDMARK_BOX = { x: 131.98, y: 13.11, width: 471.84, height: 73.77 };
+//# sourceMappingURL=brand.js.map

package/dist/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,uFAAuF;AACvF,oGAAoG;AAEpG,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAC5B,glBAAglB,CAAC;AAEnlB,sJAAsJ;AACtJ,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,s3DAAs3D,CAAC;AAEz3D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAW,CAAC"}

package/dist/browse-tree.d.ts

@@ -0,0 +1,25 @@
+import type { LicenseFact } from "./license.js";
+import { type RepoFileKind } from "./repo-layout.js";
+import { type RepoPath } from "./repo-path.js";
+import type { BrowseEntry, FolderOverview } from "./tools/results.js";
+/** One already-published file, independent of storage or transport representation. */
+export interface CatalogFile {
+    /** A skill's license (ADR-0026). */
+    readonly license?: LicenseFact | undefined;
+    readonly path: RepoPath;
+    readonly kind: RepoFileKind;
+    readonly name?: string | undefined;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly skillDir?: RepoPath | undefined;
+    readonly searchable: boolean;
+    readonly size: number;
+    readonly linkedOnly?: boolean | undefined;
+    readonly overviewOnly?: boolean | undefined;
+    readonly language?: string | undefined;
+}
+/** Returns only overview metadata; its body is read explicitly through read_file. */
+export declare function folderOverview(files: readonly CatalogFile[], path: RepoPath): FolderOverview | undefined;
+/** Immediate canonical children, with descendant counts and inherited manifest language. */
+export declare function browseCatalogFiles(files: readonly CatalogFile[], path: RepoPath): BrowseEntry[];
+//# sourceMappingURL=browse-tree.d.ts.map

package/dist/browse-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-tree.d.ts","sourceRoot":"","sources":["../src/browse-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,IAAI,EAAE,QAAQ,GACb,cAAc,GAAG,SAAS,CAS5B;AASD,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE,CAsF/F"}

package/dist/browse-tree.js

@@ -0,0 +1,99 @@
+import { parentDirectory, SKILL_MANIFEST_FILE, selectReadmePaths, } from "./repo-layout.js";
+import { ROOT_PATH } from "./repo-path.js";
+/** Returns only overview metadata; its body is read explicitly through read_file. */
+export function folderOverview(files, path) {
+    const selected = selectReadmePaths(files.map((file) => file.path), new Set([path]));
+    const file = files.find((file) => selected.has(file.path));
+    return file === undefined
+        ? undefined
+        : { path: file.path, title: file.title, description: file.description };
+}
+/** Immediate canonical children, with descendant counts and inherited manifest language. */
+export function browseCatalogFiles(files, path) {
+    const manifests = new Map();
+    const overviews = new Map();
+    const directories = new Set(files.map((file) => parentDirectory(file.path)));
+    const overviewPaths = selectReadmePaths(files.map((file) => file.path), directories);
+    const children = new Map();
+    const prefix = path.length === 0 ? "" : `${path}/`;
+    for (const file of files) {
+        if (overviewPaths.has(file.path))
+            overviews.set(parentDirectory(file.path), file);
+        if (file.overviewOnly === true)
+            continue;
+        if (file.linkedOnly === true)
+            continue;
+        if (file.kind === "manifest")
+            manifests.set(parentDirectory(file.path), file);
+        if (!file.path.startsWith(prefix))
+            continue;
+        const relative = file.path.slice(prefix.length);
+        if (relative.length === 0)
+            continue;
+        const slash = relative.indexOf("/");
+        // This is a whole-segment prefix of an already validated canonical path.
+        const childPath = `${prefix}${slash < 0 ? relative : relative.slice(0, slash)}`;
+        let child = children.get(childPath);
+        if (child === undefined) {
+            child = { direct: undefined, skill: undefined, skillCount: 0, documentCount: 0 };
+            children.set(childPath, child);
+        }
+        if (file.path === childPath)
+            child.direct = file;
+        if (file.kind === "skill") {
+            // Counts cover what can be discovered: a hidden copy of a visible skill, or a copy that
+            // repeats one, is found by browsing its folder but is not counted (ADR-0024).
+            if (file.searchable)
+                child.skillCount += 1;
+            if (file.path === childPath || file.path === `${childPath}/${SKILL_MANIFEST_FILE}`) {
+                child.skill = file;
+            }
+        }
+        if (file.searchable &&
+            file.skillDir === undefined &&
+            (file.kind === "markdown" || file.kind === "json")) {
+            child.documentCount += 1;
+        }
+    }
+    const result = [];
+    for (const [childPath, child] of children) {
+        const { direct, skill } = child;
+        if (direct?.kind === "manifest")
+            continue;
+        const ownManifest = manifests.get(childPath);
+        const overview = overviews.get(skill === undefined ? childPath : parentDirectory(skill.path));
+        let ancestor = childPath;
+        let language = null;
+        while (true) {
+            const declared = manifests.get(ancestor)?.language;
+            if (declared !== undefined) {
+                language = declared;
+                break;
+            }
+            if (ancestor === ROOT_PATH)
+                break;
+            ancestor = parentDirectory(ancestor);
+        }
+        result.push({
+            ...(skill === undefined ? {} : { browsePath: parentDirectory(skill.path) }),
+            ...(overview === undefined ? {} : { overviewPath: overview.path }),
+            ...(skill?.license === undefined ? {} : { license: skill.license }),
+            kind: skill !== undefined ? "skill" : direct === undefined ? "directory" : "file",
+            path: skill?.path ?? childPath,
+            name: skill?.name ?? ownManifest?.name ?? direct?.title ?? overview?.title ?? null,
+            description: skill?.description ??
+                ownManifest?.description ??
+                direct?.description ??
+                overview?.description ??
+                null,
+            skillCount: child.skillCount,
+            documentCount: child.documentCount,
+            size: (skill ?? direct)?.size ?? null,
+            manifestPath: ownManifest?.path ?? null,
+            language,
+        });
+    }
+    return result.sort((a, b) => Number(a.kind === "file") - Number(b.kind === "file") ||
+        (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+}
+//# sourceMappingURL=browse-tree.js.map

package/dist/browse-tree.js.map

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