ws-spec-kit 0.1.0-beta.0

package/dist/registry/connectors/knowledge-publish.js

@@ -0,0 +1,157 @@
+import { canonicalRequirementText, MAX_REQUIREMENT_BYTES, MAX_REQUIREMENT_CHARACTERS } from "./local-requirement.js";
+import { parseExternalBinding } from "../../domain/external-receipt.js";
+import { sha256 } from "../../domain/digests.js";
+import { inspectDecodedCredentialSurface, inspectDecodedCredentialText } from "./secret-detector.js";
+import { validateFeishuDocumentTarget } from "./feishu-document.js";
+const tokenPattern = /^[A-Za-z0-9_-]{8,128}$/u;
+const spacePattern = /^(?:[1-9][0-9]{5,31}|my_library)$/u;
+const allowedKeys = new Set(["documentToken", "folderToken", "markdown", "title", "wikiNode", "wikiSpace"]);
+export class KnowledgePublishError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.name = "KnowledgePublishError";
+    }
+}
+function fail(code, message) {
+    throw new KnowledgePublishError(code, message);
+}
+function record(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)
+        || (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)) {
+        return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "知识发布目标包含不允许的字段。");
+    }
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    if (Reflect.ownKeys(value).some((key) => typeof key !== "string" || !allowedKeys.has(key))
+        || Object.values(descriptors).some((descriptor) => !descriptor.enumerable || !("value" in descriptor))) {
+        return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "知识发布目标包含不允许的属性。");
+    }
+    return value;
+}
+function title(value) {
+    if (typeof value !== "string" || value === "" || Buffer.byteLength(value, "utf8") > 3_200) {
+        return fail("WSSPEC_KNOWLEDGE_CONTENT_INVALID", "知识发布标题无效。");
+    }
+    const normalized = value.normalize("NFC").trim();
+    if (normalized === "" || [...normalized].length > 800 || /[\u0000-\u001f\u007f-\u009f]/u.test(normalized)
+        || !inspectDecodedCredentialText(value, { maximumBytes: 3_200, maximumDecodeRounds: 4 }).ok
+        || !inspectDecodedCredentialText(normalized, { maximumBytes: 3_200, maximumDecodeRounds: 4 }).ok) {
+        return fail("WSSPEC_KNOWLEDGE_CONTENT_INVALID", "知识发布标题必须是有界单行文本。");
+    }
+    return normalized;
+}
+function markdown(value) {
+    if (typeof value !== "string" || Buffer.byteLength(value, "utf8") > MAX_REQUIREMENT_BYTES || [...value].length > MAX_REQUIREMENT_CHARACTERS) {
+        return fail("WSSPEC_KNOWLEDGE_CONTENT_INVALID", "知识发布 Markdown 超过上限。");
+    }
+    try {
+        if (!inspectDecodedCredentialText(value, { maximumBytes: MAX_REQUIREMENT_BYTES, maximumDecodeRounds: 4 }).ok) {
+            return fail("WSSPEC_KNOWLEDGE_CONTENT_INVALID", "知识发布 Markdown 包含不允许的凭据或编码表面。");
+        }
+        const canonical = canonicalRequirementText(value);
+        if (!inspectDecodedCredentialText(canonical, { maximumBytes: MAX_REQUIREMENT_BYTES, maximumDecodeRounds: 4 }).ok) {
+            return fail("WSSPEC_KNOWLEDGE_CONTENT_INVALID", "知识发布 Markdown 包含不允许的凭据或编码表面。");
+        }
+        return canonical;
+    }
+    catch {
+        return fail("WSSPEC_KNOWLEDGE_CONTENT_INVALID", "知识发布 Markdown 无效。");
+    }
+}
+function decoded(value, label) {
+    if (typeof value !== "string" || value === "" || Buffer.byteLength(value, "utf8") > 2_048) {
+        return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", `${label} 无效。`);
+    }
+    const inspected = inspectDecodedCredentialSurface(value, { detectCredentialKeys: true, maximumBytes: 8_192, maximumDecodeRounds: 4 });
+    if (!inspected.ok)
+        return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", `${label} 无效或包含凭据样式内容。`);
+    return inspected.value.normalize("NFC");
+}
+function plainToken(value, label) {
+    const result = decoded(value, label);
+    if (!tokenPattern.test(result))
+        return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", `${label} 必须是规范 token。`);
+    return result;
+}
+function folderToken(value) {
+    const source = decoded(value, "folderToken");
+    if (source.includes("://")) {
+        let url;
+        try {
+            url = new URL(source);
+        }
+        catch {
+            return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "folderToken URL 无效。");
+        }
+        const parts = url.pathname.split("/").filter(Boolean);
+        const host = url.hostname.toLowerCase();
+        if (url.protocol !== "https:" || url.port !== "" || (!host.endsWith(".feishu.cn") && !host.endsWith(".larksuite.com"))
+            || parts.length !== 3 || parts[0] !== "drive" || parts[1] !== "folder"
+            || url.search !== "" || url.hash !== "" || url.username !== "" || url.password !== "") {
+            return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "folderToken URL 无效。");
+        }
+        return plainToken(parts[2], "folderToken");
+    }
+    return plainToken(source, "folderToken");
+}
+function wikiNode(value) {
+    const source = decoded(value, "wikiNode");
+    if (source.includes("://")) {
+        const target = documentTarget(source);
+        if (target.kind !== "wiki")
+            return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "wikiNode URL 无效。");
+        return target.documentToken;
+    }
+    return plainToken(source, "wikiNode");
+}
+function documentTarget(value) {
+    try {
+        return validateFeishuDocumentTarget(value);
+    }
+    catch {
+        return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "文档或 wiki 目标无效。");
+    }
+}
+function wikiSpace(value) {
+    const result = decoded(value, "wikiSpace");
+    if (!spacePattern.test(result))
+        return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "wikiSpace 无效。");
+    return result;
+}
+export function validateKnowledgePublishTarget(value) {
+    const source = record(value);
+    const normalizedTitle = title(source.title);
+    const normalizedMarkdown = markdown(source.markdown);
+    const createKeys = ["folderToken", "wikiNode", "wikiSpace"].filter((key) => source[key] !== undefined);
+    if (source.documentToken !== undefined) {
+        if (createKeys.length !== 0)
+            return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "更新文档不能同时指定创建目标。");
+        const target = documentTarget(source.documentToken);
+        if (target.kind !== "token")
+            return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "更新必须指定已解析的文档 token。");
+        return { operation: "update", documentToken: target.documentToken, title: normalizedTitle, markdown: normalizedMarkdown, stableId: `feishu:${target.documentToken}` };
+    }
+    if (createKeys.length !== 1)
+        return fail("WSSPEC_KNOWLEDGE_TARGET_INVALID", "创建文档必须在 folderToken、wikiNode、wikiSpace 中精确选择一个。");
+    const key = createKeys[0];
+    const targetToken = key === "folderToken" ? folderToken(source[key]) : key === "wikiNode" ? wikiNode(source[key]) : wikiSpace(source[key]);
+    const targetFlag = key === "folderToken" ? "--folder-token" : key === "wikiNode" ? "--wiki-node" : "--wiki-space";
+    return { operation: "create", targetFlag, targetToken, title: normalizedTitle, markdown: normalizedMarkdown, stableId: `feishu-target:${targetToken}` };
+}
+export function validateKnowledgeBinding(value, target) {
+    const binding = parseExternalBinding(value);
+    if (binding === undefined || binding.target !== "knowledge" || binding.stableId !== target.stableId
+        || binding.expectedPublishedContentDigest !== sha256(target.markdown)) {
+        return fail("WSSPEC_KNOWLEDGE_BINDING_INVALID", "知识发布必须绑定当前严格 ExternalBinding。");
+    }
+    return binding;
+}
+export function mapKnowledgeError(error, readBack) {
+    if (error instanceof KnowledgePublishError)
+        throw error;
+    if (readBack)
+        return fail("WSSPEC_KNOWLEDGE_READBACK_FAILED", "知识发布写入后的回读失败。");
+    return fail("WSSPEC_KNOWLEDGE_WRITE_FAILED", "知识发布写入失败。");
+}
+//# sourceMappingURL=knowledge-publish.js.map

package/dist/registry/connectors/knowledge-publish.js.map

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

package/dist/registry/connectors/local-requirement.d.ts

@@ -0,0 +1,19 @@
+import type { RequirementSourceInput } from "../../protocol/application.js";
+export declare const MAX_REQUIREMENT_BYTES = 1048576;
+export declare const MAX_REQUIREMENT_CHARACTERS = 262144;
+export interface CapturedLocalRequirement {
+    type: "prompt" | "file";
+    origin: string;
+    text: string;
+    contentDigest: string;
+}
+export declare class LocalRequirementError extends Error {
+    readonly code: `WSSPEC_${string}`;
+    constructor(code: `WSSPEC_${string}`, message: string);
+}
+export declare function canonicalRequirementText(text: string): string;
+export declare function readLocalRequirementFile(repositoryRoot: string, candidate: string): Promise<{
+    path: string;
+    text: string;
+}>;
+export declare function captureLocalRequirement(root: string, source: RequirementSourceInput): Promise<CapturedLocalRequirement>;

package/dist/registry/connectors/local-requirement.js

@@ -0,0 +1,177 @@
+import { constants } from "node:fs";
+import { lstat, open, realpath } from "node:fs/promises";
+import path from "node:path";
+import { sha256 } from "../../domain/digests.js";
+export const MAX_REQUIREMENT_BYTES = 1_048_576;
+export const MAX_REQUIREMENT_CHARACTERS = 262_144;
+export class LocalRequirementError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.name = "LocalRequirementError";
+    }
+}
+function fail(code, message) {
+    throw new LocalRequirementError(code, message);
+}
+function sameIdentity(left, right) {
+    return left.dev === right.dev
+        && left.ino === right.ino
+        && left.size === right.size
+        && left.mtimeNs === right.mtimeNs
+        && left.ctimeNs === right.ctimeNs
+        && left.nlink === right.nlink;
+}
+function boundedText(text) {
+    if (Buffer.byteLength(text, "utf8") > MAX_REQUIREMENT_BYTES) {
+        return fail("WSSPEC_SOURCE_TOO_LARGE", "需求来源超过 1 MiB 字节上限。");
+    }
+    const canonical = (text.startsWith("\ufeff") ? text.slice(1) : text)
+        .replace(/\r\n?/gu, "\n")
+        .normalize("NFC");
+    if (Buffer.byteLength(canonical, "utf8") > MAX_REQUIREMENT_BYTES
+        || [...canonical].length > MAX_REQUIREMENT_CHARACTERS) {
+        return fail("WSSPEC_SOURCE_TOO_LARGE", "需求来源超过字节或 Unicode 字符上限。");
+    }
+    if (/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/u.test(canonical)) {
+        return fail("WSSPEC_SOURCE_BINARY", "需求来源包含 NUL 或二进制控制字符。");
+    }
+    if (canonical.trim() === "")
+        return fail("WSSPEC_SOURCE_EMPTY", "需求来源不能为空。");
+    return canonical;
+}
+export function canonicalRequirementText(text) {
+    return boundedText(text);
+}
+function canonicalRelativePath(candidate) {
+    if (candidate === "" || path.isAbsolute(candidate) || candidate.includes("\\")
+        || path.posix.normalize(candidate) !== candidate
+        || candidate.split("/").some((part) => part === "" || part === "." || part === "..")) {
+        return fail("WSSPEC_SOURCE_PATH_INVALID", "需求文件路径必须是规范的仓库相对 POSIX 路径。");
+    }
+    if (![".md", ".txt"].includes(path.posix.extname(candidate))) {
+        return fail("WSSPEC_SOURCE_TYPE_UNSUPPORTED", "只支持仓库内 .md 或 .txt 需求文件。");
+    }
+    return { accessPath: candidate, stablePath: candidate.normalize("NFC") };
+}
+function contained(root, target) {
+    const relative = path.relative(root, target);
+    return relative !== "" && !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+async function assertNoSymlinkComponents(root, relative) {
+    let current = root;
+    const parts = relative.split("/");
+    for (const [index, part] of parts.entries()) {
+        current = path.join(current, part);
+        let target;
+        try {
+            target = await lstat(current, { bigint: true });
+        }
+        catch (error) {
+            if (error.code === "ELOOP") {
+                return fail("WSSPEC_SOURCE_PATH_INVALID", "需求文件路径不能包含符号链接。");
+            }
+            throw error;
+        }
+        if (target.isSymbolicLink())
+            return fail("WSSPEC_SOURCE_PATH_INVALID", "需求文件路径不能包含符号链接。");
+        if (index < parts.length - 1 && !target.isDirectory()) {
+            return fail("WSSPEC_SOURCE_PATH_INVALID", "需求文件父路径必须是普通目录。");
+        }
+    }
+    return current;
+}
+export async function readLocalRequirementFile(repositoryRoot, candidate) {
+    const relative = canonicalRelativePath(candidate);
+    const root = await realpath(repositoryRoot);
+    const filename = await assertNoSymlinkComponents(root, relative.accessPath);
+    const before = await lstat(filename, { bigint: true });
+    if (!before.isFile())
+        return fail("WSSPEC_SOURCE_NOT_REGULAR_FILE", "需求来源必须是普通文件。");
+    if (before.nlink !== 1n)
+        return fail("WSSPEC_SOURCE_PATH_INVALID", "需求来源必须只有一个文件名链接。");
+    if (before.size > BigInt(MAX_REQUIREMENT_BYTES)) {
+        return fail("WSSPEC_SOURCE_TOO_LARGE", "需求来源超过 1 MiB 字节上限。");
+    }
+    let handle;
+    try {
+        handle = await open(filename, constants.O_RDONLY | constants.O_NOFOLLOW);
+    }
+    catch (error) {
+        if (["ELOOP", "EFTYPE"].includes(error.code ?? "")) {
+            return fail("WSSPEC_SOURCE_PATH_INVALID", "需求文件在打开前被替换为符号链接。");
+        }
+        throw error;
+    }
+    try {
+        const opened = await handle.stat({ bigint: true });
+        if (!opened.isFile())
+            return fail("WSSPEC_SOURCE_NOT_REGULAR_FILE", "需求来源必须是普通文件。");
+        if (opened.nlink !== 1n)
+            return fail("WSSPEC_SOURCE_CHANGED_DURING_READ", "需求文件链接数在打开期间发生变化。");
+        if (!sameIdentity(before, opened))
+            return fail("WSSPEC_SOURCE_CHANGED_DURING_READ", "需求文件在打开期间被替换。");
+        const openedPath = await realpath(filename);
+        const openedPathTarget = await lstat(openedPath, { bigint: true });
+        if (!contained(root, openedPath) || !sameIdentity(opened, openedPathTarget)) {
+            return fail("WSSPEC_SOURCE_PATH_INVALID", "需求文件打开后的真实路径或身份不匹配。");
+        }
+        if (opened.size > BigInt(MAX_REQUIREMENT_BYTES)) {
+            return fail("WSSPEC_SOURCE_TOO_LARGE", "需求来源超过 1 MiB 字节上限。");
+        }
+        const chunks = [];
+        let total = 0;
+        let position = 0;
+        while (true) {
+            const chunk = Buffer.allocUnsafe(Math.min(64 * 1024, MAX_REQUIREMENT_BYTES + 1 - total));
+            const { bytesRead } = await handle.read(chunk, 0, chunk.length, position);
+            if (bytesRead === 0)
+                break;
+            chunks.push(chunk.subarray(0, bytesRead));
+            total += bytesRead;
+            position += bytesRead;
+            if (total > MAX_REQUIREMENT_BYTES)
+                return fail("WSSPEC_SOURCE_TOO_LARGE", "需求来源超过 1 MiB 字节上限。");
+        }
+        const after = await handle.stat({ bigint: true });
+        if (after.nlink !== 1n || !sameIdentity(opened, after) || BigInt(total) !== opened.size) {
+            return fail("WSSPEC_SOURCE_CHANGED_DURING_READ", "需求文件在读取期间发生变化。");
+        }
+        try {
+            const finalPath = await realpath(filename);
+            const finalTarget = await lstat(finalPath, { bigint: true });
+            if (!contained(root, finalPath) || !sameIdentity(after, finalTarget)) {
+                return fail("WSSPEC_SOURCE_CHANGED_DURING_READ", "需求文件路径在读取期间被替换。");
+            }
+        }
+        catch (error) {
+            if (error instanceof LocalRequirementError)
+                throw error;
+            return fail("WSSPEC_SOURCE_CHANGED_DURING_READ", "需求文件路径在读取期间消失或变化。");
+        }
+        let decoded;
+        try {
+            decoded = new TextDecoder("utf-8", { fatal: true }).decode(Buffer.concat(chunks, total));
+        }
+        catch {
+            return fail("WSSPEC_SOURCE_BINARY", "需求来源不是严格 UTF-8 文本。");
+        }
+        return { path: relative.stablePath, text: boundedText(decoded) };
+    }
+    finally {
+        await handle.close();
+    }
+}
+export async function captureLocalRequirement(root, source) {
+    if (source.type === "prompt") {
+        const text = boundedText(source.text);
+        return { type: "prompt", origin: "prompt", text, contentDigest: sha256(text) };
+    }
+    if (source.type === "file") {
+        const captured = await readLocalRequirementFile(root, source.path);
+        return { type: "file", origin: captured.path, text: captured.text, contentDigest: sha256(captured.text) };
+    }
+    return fail("WSSPEC_SOURCE_TYPE_UNSUPPORTED", "当前阶段只支持 Prompt 和仓库内 Markdown/TXT 来源。");
+}
+//# sourceMappingURL=local-requirement.js.map

package/dist/registry/connectors/local-requirement.js.map

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

package/dist/registry/connectors/manifest.d.ts

@@ -0,0 +1,6 @@
+import type { ConnectorManifest } from "./types.js";
+export declare class ConnectorManifestError extends Error {
+    readonly code: `WSSPEC_${string}`;
+    constructor(code: `WSSPEC_${string}`, message: string);
+}
+export declare function defineConnectorManifest(value: unknown): ConnectorManifest;

package/dist/registry/connectors/manifest.js

@@ -0,0 +1,164 @@
+import { parseSemVer } from "./semver.js";
+const idPattern = /^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$/u;
+const securityClasses = new Set(["external-read", "external-write", "local-write"]);
+const executables = new Set(["git", "gh", "glab", "lark-cli"]);
+const environmentKeys = new Set(["HOME", "XDG_CONFIG_HOME", "GH_CONFIG_DIR", "GLAB_CONFIG_DIR", "LARK_CONFIG_DIR"]);
+const rootKeys = ["argvTemplates", "capabilities", "doctor", "envPolicy", "executable", "id", "maxStdoutBytes", "minimumVersion", "securityClass", "timeoutMs"];
+const auditedDoctorArgv = {
+    git: { version: ["--version"] },
+    gh: { version: ["--version"], auth: ["auth", "status", "--active"] },
+    glab: { version: ["--version"], auth: ["auth", "status"] },
+    "lark-cli": { version: ["--version"] },
+};
+export class ConnectorManifestError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.name = "ConnectorManifestError";
+    }
+}
+function invalid() {
+    throw new ConnectorManifestError("WSSPEC_CONNECTOR_MANIFEST_INVALID", "Connector Manifest 不符合完整安全合同。");
+}
+function record(value, keys) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return invalid();
+    const source = value;
+    if (Object.keys(source).sort().join("\0") !== [...keys].sort().join("\0"))
+        return invalid();
+    return source;
+}
+function stringValue(value, pattern) {
+    if (typeof value !== "string" || value === "" || value.includes("\0") || (pattern !== undefined && !pattern.test(value)))
+        return invalid();
+    return value;
+}
+function argv(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return invalid();
+    return value.map((part) => stringValue(part));
+}
+function sameArgv(left, right) {
+    return left.length === right.length && left.every((part, index) => part === right[index]);
+}
+function sameNumbers(left, right) {
+    return left.length === right.length && left.every((part, index) => Object.is(part, right[index]));
+}
+function exitCodeOutcomes(value) {
+    const source = record(value, ["authenticated", "unauthenticated"]);
+    if (!Array.isArray(source.authenticated) || source.authenticated.length === 0 || !source.authenticated.every(Number.isSafeInteger)
+        || !Array.isArray(source.unauthenticated) || source.unauthenticated.length === 0 || !source.unauthenticated.every(Number.isSafeInteger))
+        return invalid();
+    const authenticated = source.authenticated;
+    const unauthenticated = source.unauthenticated;
+    if (authenticated.some((item) => unauthenticated.includes(item)))
+        return invalid();
+    return { authenticated: [...authenticated], unauthenticated: [...unauthenticated] };
+}
+function freezeAuth(probe) {
+    if (probe.kind === "none")
+        return Object.freeze({ kind: "none" });
+    if (probe.kind === "unavailable")
+        return Object.freeze({ kind: "unavailable", reasonCode: probe.reasonCode });
+    return Object.freeze({
+        kind: "auth",
+        argv: Object.freeze([...probe.argv]),
+        parser: Object.freeze({ kind: "exit-code" }),
+        outcomes: Object.freeze({
+            authenticated: Object.freeze([...probe.outcomes.authenticated]),
+            unauthenticated: Object.freeze([...probe.outcomes.unauthenticated]),
+        }),
+    });
+}
+function versionProbe(value, executable) {
+    const source = record(value, ["argv", "kind", "parser"]);
+    if (source.kind !== "version")
+        return invalid();
+    const parts = argv(source.argv);
+    if (!sameArgv(parts, auditedDoctorArgv[executable].version))
+        return invalid();
+    const parser = source.parser;
+    if (parser?.kind === "text-semver" && Object.keys(parser).length === 1)
+        return { kind: "version", argv: parts, parser: { kind: "text-semver" } };
+    return invalid();
+}
+function authProbe(value, executable) {
+    if (executable === "git") {
+        const source = record(value, ["kind"]);
+        if (source.kind !== "none")
+            return invalid();
+        return { kind: "none" };
+    }
+    if (value !== null && typeof value === "object" && !Array.isArray(value)
+        && value.kind === "unavailable") {
+        const source = record(value, ["kind", "reasonCode"]);
+        if (source.reasonCode !== "WSSPEC_CONNECTOR_AUTH_PROBE_UNAVAILABLE")
+            return invalid();
+        return { kind: "unavailable", reasonCode: "WSSPEC_CONNECTOR_AUTH_PROBE_UNAVAILABLE" };
+    }
+    if (executable === "lark-cli")
+        return invalid();
+    const source = record(value, ["argv", "kind", "outcomes", "parser"]);
+    if (source.kind !== "auth")
+        return invalid();
+    const parts = argv(source.argv);
+    const audited = auditedDoctorArgv[executable].auth;
+    if (audited === undefined || !sameArgv(parts, audited))
+        return invalid();
+    const parser = source.parser;
+    if (parser?.kind === "exit-code" && Object.keys(parser).length === 1) {
+        const outcomes = exitCodeOutcomes(source.outcomes);
+        if ((executable !== "gh" && executable !== "glab")
+            || !sameNumbers(outcomes.authenticated, [0]) || !sameNumbers(outcomes.unauthenticated, [1]))
+            return invalid();
+        return {
+            kind: "auth",
+            argv: parts,
+            parser: { kind: "exit-code" },
+            outcomes,
+        };
+    }
+    return invalid();
+}
+export function defineConnectorManifest(value) {
+    const source = record(value, rootKeys);
+    const id = stringValue(source.id, idPattern);
+    if (!Array.isArray(source.capabilities) || source.capabilities.length === 0)
+        return invalid();
+    const capabilities = source.capabilities.map((capability) => stringValue(capability, idPattern));
+    if (!securityClasses.has(source.securityClass) || !executables.has(source.executable))
+        return invalid();
+    const executable = source.executable;
+    const minimumVersion = stringValue(source.minimumVersion);
+    if (parseSemVer(minimumVersion) === undefined)
+        return invalid();
+    if (!Number.isSafeInteger(source.timeoutMs) || source.timeoutMs < 1
+        || !Number.isSafeInteger(source.maxStdoutBytes) || source.maxStdoutBytes < 1
+        || !Array.isArray(source.argvTemplates) || source.argvTemplates.length === 0)
+        return invalid();
+    const argvTemplates = source.argvTemplates.map(argv);
+    const doctorSource = record(source.doctor, ["auth", "version"]);
+    const doctor = { version: versionProbe(doctorSource.version, executable), auth: authProbe(doctorSource.auth, executable) };
+    const envSource = record(source.envPolicy, ["allow"]);
+    if (!Array.isArray(envSource.allow) || !envSource.allow.every((name) => typeof name === "string" && environmentKeys.has(name)))
+        return invalid();
+    const allow = [...new Set(envSource.allow)];
+    const manifest = {
+        id,
+        capabilities: Object.freeze([...new Set(capabilities)]),
+        securityClass: source.securityClass,
+        executable,
+        minimumVersion,
+        argvTemplates: Object.freeze(argvTemplates.map((parts) => Object.freeze([...parts]))),
+        doctor: Object.freeze({
+            version: Object.freeze({ ...doctor.version, argv: Object.freeze([...doctor.version.argv]), parser: Object.freeze({ ...doctor.version.parser }) }),
+            auth: freezeAuth(doctor.auth),
+        }),
+        envPolicy: Object.freeze({ allow: Object.freeze(allow) }),
+        timeoutMs: source.timeoutMs,
+        maxStdoutBytes: source.maxStdoutBytes,
+    };
+    return Object.freeze(manifest);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/registry/connectors/manifest.js.map

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

package/dist/registry/connectors/registry.d.ts

@@ -0,0 +1,11 @@
+import type { ConnectorManifest } from "./types.js";
+export declare class ConnectorRegistryError extends Error {
+    readonly code: `WSSPEC_${string}`;
+    constructor(code: `WSSPEC_${string}`, message: string);
+}
+export declare class ConnectorRegistry {
+    #private;
+    register(input: ConnectorManifest): this;
+    resolve(capability: string, provider: string): ConnectorManifest;
+    manifests(): readonly ConnectorManifest[];
+}

package/dist/registry/connectors/registry.js

@@ -0,0 +1,34 @@
+import { defineConnectorManifest } from "./manifest.js";
+export class ConnectorRegistryError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.name = "ConnectorRegistryError";
+    }
+}
+export class ConnectorRegistry {
+    #providers = new Map();
+    register(input) {
+        const manifest = defineConnectorManifest(input);
+        if (this.#providers.has(manifest.id)) {
+            throw new ConnectorRegistryError("WSSPEC_CONNECTOR_PROVIDER_DUPLICATE", `Connector provider ${manifest.id} 已注册。`);
+        }
+        this.#providers.set(manifest.id, manifest);
+        return this;
+    }
+    resolve(capability, provider) {
+        const manifest = this.#providers.get(provider);
+        if (manifest === undefined) {
+            throw new ConnectorRegistryError("WSSPEC_CONNECTOR_PROVIDER_NOT_FOUND", `找不到 Connector provider ${provider}。`);
+        }
+        if (!manifest.capabilities.includes(capability)) {
+            throw new ConnectorRegistryError("WSSPEC_CONNECTOR_CAPABILITY_NOT_FOUND", `Connector provider ${provider} 不支持 capability ${capability}。`);
+        }
+        return manifest;
+    }
+    manifests() {
+        return [...this.#providers.values()];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry/connectors/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/registry/connectors/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGxD,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC1B;IAArB,YAAqB,IAAwB,EAAE,OAAe;QAC5D,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QADV,SAAI,GAAJ,IAAI,CAAoB;QAE3C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,iBAAiB;IACnB,UAAU,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE3D,QAAQ,CAAC,KAAwB;QAC/B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,sBAAsB,CAAC,qCAAqC,EAAE,sBAAsB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QACpH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,UAAkB,EAAE,QAAgB;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,sBAAsB,CAAC,qCAAqC,EAAE,0BAA0B,QAAQ,GAAG,CAAC,CAAC;QACjH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,sBAAsB,CAC9B,uCAAuC,EACvC,sBAAsB,QAAQ,mBAAmB,UAAU,GAAG,CAC/D,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;CACF"}