ws-spec-kit 0.1.0-beta.0

package/dist/protocol/work-package.d.ts

@@ -0,0 +1,55 @@
+import type { WorkItemId } from "../domain/ids.js";
+export interface ArtifactReference {
+    artifactType: string;
+    outputId?: string;
+    schemaVersion: number;
+    artifactId?: string;
+    path?: string;
+    revision?: number;
+    contentHash?: string;
+    mediaType?: string;
+    contentLevel?: string;
+}
+export interface ArtifactExpectation {
+    artifactType: string;
+    outputId?: string;
+    schemaVersion: number;
+    contentLevel?: string;
+}
+export interface ResolvedSkillDescriptor {
+    ref: string;
+    version: string;
+    digest: string;
+    description: string;
+}
+export interface WorkPackageGate {
+    id: string;
+    evidence: "trusted" | "attested" | "reported";
+    required: boolean;
+}
+export interface WorkPackage {
+    version: 1;
+    workItemId: WorkItemId;
+    stepId: string;
+    attemptId: string;
+    lease: {
+        token: string;
+        expiresAt: string;
+    };
+    objective: string;
+    artifactLevel?: string;
+    skills: ResolvedSkillDescriptor[];
+    artifacts: ArtifactReference[];
+    constraints: {
+        allowedPaths: string[];
+        forbiddenActions: string[];
+    };
+    requiredOutputs: ArtifactExpectation[];
+    artifactAuthoring?: {
+        version: 1;
+        maxContentBytes: number;
+        draftRoots: string[];
+    };
+    gates: WorkPackageGate[];
+    resultSchema: "builtin.submit-result.v1";
+}

package/dist/protocol/work-package.js

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

package/dist/protocol/work-package.js.map

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

package/dist/registry/connectors/external-executor.d.ts

@@ -0,0 +1,4 @@
+import { type ExternalActionExecutor } from "../../application/external-action.js";
+import type { ExternalActionName } from "../../engine/external-effects/authorization.js";
+import type { BuiltinConnectorRuntime } from "./runtime.js";
+export declare function createBuiltinExternalExecutor(runtime: BuiltinConnectorRuntime, provider: string, action: ExternalActionName): ExternalActionExecutor;

package/dist/registry/connectors/external-executor.js

@@ -0,0 +1,249 @@
+import { readGithubComment, readGithubIssue, writeGithubIssue } from "../../adapters/connectors/github-cli.js";
+import { commitGitChanges, reconcileGitCommit } from "../../adapters/connectors/git-native.js";
+import { readGitlabIssue, readGitlabNote, writeGitlabIssue } from "../../adapters/connectors/gitlab-cli.js";
+import { publishKnowledge, readFeishuDocument } from "../../adapters/connectors/lark-cli.js";
+import { ExternalActionError } from "../../application/external-action.js";
+import { loadApplicationState } from "../../application/state.js";
+import { canonicalDigest } from "../../engine/external-effects/idempotency.js";
+import { validateGitCommitApproval } from "./git-commit.js";
+import { canonicalIssueText, validateIssueWriteAction } from "./issue.js";
+import { validateKnowledgePublishTarget } from "./knowledge-publish.js";
+import { sha256 } from "../../domain/digests.js";
+import { loadBuiltinCatalog } from "../../resources/catalog.js";
+import { loadExternalActionPayload } from "../../storage/external-action-payload.js";
+import { ConnectorRegistry } from "./registry.js";
+const aliases = { git: "git-native", github: "github-cli", gitlab: "gitlab-cli", feishu: "lark-cli" };
+function providerId(provider) {
+    const normalized = aliases[provider] ?? provider;
+    if (normalized !== "git-native" && normalized !== "github-cli" && normalized !== "gitlab-cli" && normalized !== "lark-cli") {
+        throw new ExternalActionError("WSSPEC_CONNECTOR_PROVIDER_NOT_FOUND", `找不到 Connector provider ${provider}。`);
+    }
+    return normalized;
+}
+async function resolveProvider(provider, action) {
+    const registry = new ConnectorRegistry();
+    for (const manifest of (await loadBuiltinCatalog()).connectors)
+        registry.register(manifest);
+    return registry.resolve(action === "issue.update" ? "issue.write" : action, providerId(provider));
+}
+function issuePayload(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new ExternalActionError("WSSPEC_EXTERNAL_PAYLOAD_INVALID", "Issue payload 无效。");
+    }
+    return value;
+}
+function knowledgePayload(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new ExternalActionError("WSSPEC_EXTERNAL_PAYLOAD_INVALID", "Knowledge payload 无效。");
+    }
+    return value;
+}
+function sameLabels(actual, expected) {
+    const left = actual.map(canonicalIssueText).sort();
+    const right = expected.map(canonicalIssueText).sort();
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function issueMatches(actual, action) {
+    if (action.type === "comment")
+        return undefined;
+    if (action.type === "issue.close")
+        return actual.state === "closed";
+    if (action.type === "body") {
+        const expected = canonicalIssueText(action.body);
+        return actual.body === (expected.trim() === "" ? actual.title : expected);
+    }
+    if (action.type === "labels")
+        return sameLabels(actual.labels, action.labels);
+    return actual.state === action.state;
+}
+async function durablePayload(root, request) {
+    const state = await loadApplicationState(root, request.workItemId);
+    return loadExternalActionPayload({ controlPlane: state.projection.controlPlane, request });
+}
+export function createBuiltinExternalExecutor(runtime, provider, action) {
+    const normalized = providerId(provider);
+    return {
+        async execute({ root, request, payload, markDispatched }) {
+            const manifest = await resolveProvider(provider, action);
+            const durable = await durablePayload(root, request);
+            if (canonicalDigest(durable) !== canonicalDigest(payload)) {
+                throw new ExternalActionError("WSSPEC_EXTERNAL_PAYLOAD_MISMATCH", "执行 payload 与持久化授权工件不一致。");
+            }
+            let publishedContentDigest = request.expectedContentDigest;
+            let readBackContentDigest = request.expectedContentDigest;
+            let externalEffectId;
+            if (normalized === "git-native") {
+                const approval = validateGitCommitApproval(durable);
+                if (action !== "git.commit" || request.securityClass !== "local-write"
+                    || request.target.kind !== "repository" || request.provider !== "git-native"
+                    || approval.repositoryCommonDir !== request.target.stableId
+                    || approval.diffDigest !== request.expectedContentDigest
+                    || canonicalDigest(approval) !== canonicalDigest(durable)) {
+                    throw new ExternalActionError("WSSPEC_EXTERNAL_BINDING_INVALID", "Git commit approval 与持久 Request 不一致。");
+                }
+                const actual = await commitGitChanges({
+                    executable: runtime.executables.git,
+                    approval,
+                    markDispatched,
+                });
+                if (actual.provider !== "git-native" || actual.action !== "git.commit"
+                    || actual.repositoryCommonDir !== request.target.stableId
+                    || actual.baselineRevision !== approval.baselineRevision
+                    || actual.diffDigest !== request.expectedContentDigest
+                    || actual.readBackDigest !== request.expectedContentDigest
+                    || actual.status !== "verified") {
+                    throw new ExternalActionError("WSSPEC_EXTERNAL_READBACK_MISMATCH", "Git commit receipt 未绑定批准的仓库或 diff。");
+                }
+                publishedContentDigest = actual.diffDigest;
+                readBackContentDigest = actual.readBackDigest;
+            }
+            else if (normalized === "github-cli") {
+                const value = issuePayload(durable);
+                const actual = await writeGithubIssue({
+                    executable: runtime.executables[manifest.executable],
+                    target: value.target,
+                    action: value.action,
+                    ...(runtime.environments?.github === undefined ? {} : { environment: runtime.environments.github }),
+                    markDispatched,
+                });
+                if (actual.stableId !== request.target.stableId)
+                    throw new ExternalActionError("WSSPEC_EXTERNAL_READBACK_MISMATCH", "GitHub Issue 稳定身份不匹配。");
+                externalEffectId = actual.externalEffectId;
+            }
+            else if (normalized === "gitlab-cli") {
+                const value = issuePayload(durable);
+                const actual = await writeGitlabIssue({
+                    executable: runtime.executables[manifest.executable],
+                    target: value.target,
+                    action: value.action,
+                    ...(runtime.environments?.gitlab === undefined ? {} : { environment: runtime.environments.gitlab }),
+                    markDispatched,
+                });
+                if (actual.stableId !== request.target.stableId)
+                    throw new ExternalActionError("WSSPEC_EXTERNAL_READBACK_MISMATCH", "GitLab Issue 稳定身份不匹配。");
+                externalEffectId = actual.externalEffectId;
+            }
+            else {
+                const value = knowledgePayload(durable);
+                const actual = await publishKnowledge({
+                    executable: runtime.executables[manifest.executable],
+                    target: value.target,
+                    binding: value.binding,
+                    identity: runtime.larkIdentity ?? "user",
+                    ...(runtime.environments?.feishu === undefined ? {} : { environment: runtime.environments.feishu }),
+                    markDispatched,
+                });
+                if (actual.stableId !== request.target.stableId
+                    || actual.publishedContentDigest !== request.expectedContentDigest
+                    || actual.readBackContentDigest !== request.expectedContentDigest) {
+                    throw new ExternalActionError("WSSPEC_EXTERNAL_READBACK_MISMATCH", "Feishu 文档稳定身份或正文摘要不匹配。");
+                }
+                publishedContentDigest = request.expectedContentDigest;
+                readBackContentDigest = request.expectedContentDigest;
+            }
+            return {
+                targetStableId: request.target.stableId,
+                ...(externalEffectId === undefined ? {} : { externalEffectId }),
+                publishedContentDigest,
+                readBackContentDigest,
+                verifiedAt: new Date().toISOString(),
+            };
+        },
+        async reconcile({ root, request }) {
+            await resolveProvider(provider, action);
+            const payload = await durablePayload(root, request);
+            const checkedAt = new Date().toISOString();
+            if (normalized === "git-native") {
+                const approval = validateGitCommitApproval(payload);
+                if (action !== "git.commit" || request.securityClass !== "local-write"
+                    || request.target.kind !== "repository" || request.provider !== "git-native"
+                    || approval.repositoryCommonDir !== request.target.stableId
+                    || approval.diffDigest !== request.expectedContentDigest
+                    || canonicalDigest(approval) !== canonicalDigest(payload)) {
+                    throw new ExternalActionError("WSSPEC_EXTERNAL_BINDING_INVALID", "Git commit approval 与持久 Request 不一致。");
+                }
+                const actual = await reconcileGitCommit({ executable: runtime.executables.git, approval });
+                if (actual.outcome !== "verified")
+                    return { outcome: actual.outcome, checkedAt };
+                return actual.repositoryCommonDir === request.target.stableId
+                    && actual.diffDigest === request.expectedContentDigest
+                    ? { outcome: "verified", targetStableId: request.target.stableId, contentDigest: request.expectedContentDigest, checkedAt }
+                    : { outcome: "failed", checkedAt };
+            }
+            if (normalized === "github-cli" || normalized === "gitlab-cli") {
+                const value = issuePayload(payload);
+                const actual = normalized === "github-cli"
+                    ? await readGithubIssue({ executable: runtime.executables.gh, target: value.target, ...(runtime.environments?.github === undefined ? {} : { environment: runtime.environments.github }) })
+                    : await readGitlabIssue({ executable: runtime.executables.glab, target: value.target, ...(runtime.environments?.gitlab === undefined ? {} : { environment: runtime.environments.gitlab }) });
+                const matches = issueMatches(actual, value.action);
+                if (matches === undefined)
+                    return { outcome: "unknown", checkedAt };
+                return matches && actual.stableId === request.target.stableId
+                    ? { outcome: "verified", targetStableId: request.target.stableId, contentDigest: request.payloadDigest, checkedAt }
+                    : { outcome: "failed", checkedAt };
+            }
+            const value = knowledgePayload(payload);
+            const target = validateKnowledgePublishTarget(value.target);
+            if (target.operation === "create")
+                return { outcome: "unknown", checkedAt };
+            const actual = await readFeishuDocument({
+                executable: runtime.executables["lark-cli"],
+                document: target.documentToken,
+                identity: runtime.larkIdentity ?? "user",
+                ...(runtime.environments?.feishu === undefined ? {} : { environment: runtime.environments.feishu }),
+            });
+            return actual.stableId === request.target.stableId && actual.title === target.title && actual.body === target.markdown
+                && sha256(actual.body) === request.expectedContentDigest
+                ? { outcome: "verified", targetStableId: request.target.stableId, contentDigest: request.expectedContentDigest, checkedAt }
+                : { outcome: "failed", checkedAt };
+        },
+        async adopt({ root, request, externalStableId, contentDigest }) {
+            await resolveProvider(provider, action);
+            const payload = await durablePayload(root, request);
+            const checkedAt = new Date().toISOString();
+            if (contentDigest !== request.expectedContentDigest || normalized === "git-native") {
+                return { outcome: "failed", checkedAt };
+            }
+            if (normalized === "github-cli" || normalized === "gitlab-cli") {
+                const value = issuePayload(payload);
+                const writeAction = validateIssueWriteAction(value.action);
+                if (writeAction.type !== "comment")
+                    return { outcome: "failed", checkedAt };
+                const actual = normalized === "github-cli"
+                    ? await readGithubComment({
+                        executable: runtime.executables.gh,
+                        target: value.target,
+                        externalStableId,
+                        expectedBody: writeAction.body,
+                        ...(runtime.environments?.github === undefined ? {} : { environment: runtime.environments.github }),
+                    })
+                    : await readGitlabNote({
+                        executable: runtime.executables.glab,
+                        target: value.target,
+                        externalStableId,
+                        expectedBody: writeAction.body,
+                        ...(runtime.environments?.gitlab === undefined ? {} : { environment: runtime.environments.gitlab }),
+                    });
+                return actual.stableId === externalStableId
+                    ? { outcome: "verified", targetStableId: externalStableId, contentDigest: request.expectedContentDigest, checkedAt }
+                    : { outcome: "failed", checkedAt };
+            }
+            const value = knowledgePayload(payload);
+            const target = validateKnowledgePublishTarget(value.target);
+            const match = /^feishu:([A-Za-z0-9_-]{8,128})$/u.exec(externalStableId);
+            if (target.operation !== "create" || match === null)
+                return { outcome: "failed", checkedAt };
+            const actual = await readFeishuDocument({
+                executable: runtime.executables["lark-cli"],
+                document: match[1],
+                identity: runtime.larkIdentity ?? "user",
+                ...(runtime.environments?.feishu === undefined ? {} : { environment: runtime.environments.feishu }),
+            });
+            return actual.stableId === externalStableId && actual.title === target.title && actual.body === target.markdown
+                && sha256(actual.body) === request.expectedContentDigest
+                ? { outcome: "verified", targetStableId: externalStableId, contentDigest: request.expectedContentDigest, checkedAt }
+                : { outcome: "failed", checkedAt };
+        },
+    };
+}
+//# sourceMappingURL=external-executor.js.map

package/dist/registry/connectors/external-executor.js.map

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

package/dist/registry/connectors/feishu-document.d.ts

@@ -0,0 +1,21 @@
+import { ConnectorRegistry } from "./registry.js";
+import type { ConnectorManifest } from "./types.js";
+export type LarkIdentity = "user" | "bot";
+export type LarkEnvironment = Readonly<Partial<Record<"HOME" | "XDG_CONFIG_HOME" | "LARK_CONFIG_DIR", string | undefined>>>;
+export interface ValidatedFeishuDocumentTarget {
+    documentToken: string;
+    kind: "token" | "doc" | "docx" | "wiki";
+    canonicalInputUrl?: string;
+}
+export declare class FeishuDocumentError extends Error {
+    readonly code: `WSSPEC_${string}`;
+    constructor(code: `WSSPEC_${string}`, message: string);
+}
+export declare function validateFeishuDocumentTarget(value: unknown): ValidatedFeishuDocumentTarget;
+export declare function validateLarkIdentity(value: unknown): LarkIdentity;
+export declare function validateLarkEnvironment(value: unknown): LarkEnvironment | undefined;
+export declare function mapFeishuProcessError(error: unknown): never;
+export declare const larkCliManifest: ConnectorManifest;
+export declare function larkConnectorResourcesRoot(): string;
+export declare function loadLarkConnectorManifest(root?: string): Promise<ConnectorManifest>;
+export declare function registerLarkConnectorManifest(registry: ConnectorRegistry, manifest: ConnectorManifest): ConnectorRegistry;

package/dist/registry/connectors/feishu-document.js

@@ -0,0 +1,197 @@
+import { lstat, readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { isAlias, parseDocument, visit } from "yaml";
+import { ProcessJsonError } from "../../adapters/process/spawn-json.js";
+import { defineConnectorManifest } from "./manifest.js";
+import { ConnectorRegistry } from "./registry.js";
+import { credentialLikeValue, inspectDecodedCredentialSurface } from "./secret-detector.js";
+const maximumManifestBytes = 64 * 1024;
+const tokenPattern = /^[A-Za-z0-9_-]{8,128}$/u;
+const allowedHosts = ["feishu.cn", "larksuite.com"];
+const allowedEnvironment = new Set(["HOME", "XDG_CONFIG_HOME", "LARK_CONFIG_DIR"]);
+export class FeishuDocumentError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.name = "FeishuDocumentError";
+    }
+}
+function fail(code, message) {
+    throw new FeishuDocumentError(code, message);
+}
+function inspectSurface(value) {
+    const result = inspectDecodedCredentialSurface(value, {
+        detectCredentialKeys: true,
+        maximumBytes: 8_192,
+        maximumDecodeRounds: 4,
+    });
+    if (!result.ok)
+        return fail("WSSPEC_FEISHU_TARGET_INVALID", "飞书文档目标无效或包含凭据样式内容。");
+    return result.value;
+}
+function validToken(value) {
+    const decoded = inspectSurface(value).normalize("NFC");
+    if (!tokenPattern.test(decoded) || credentialLikeValue(decoded)) {
+        return fail("WSSPEC_FEISHU_TARGET_INVALID", "飞书文档 token 无效。");
+    }
+    return decoded;
+}
+function allowedHost(hostname) {
+    const lower = hostname.toLowerCase();
+    return allowedHosts.some((suffix) => lower === suffix || lower.endsWith(`.${suffix}`));
+}
+export function validateFeishuDocumentTarget(value) {
+    if (typeof value !== "string" || value === "" || Buffer.byteLength(value, "utf8") > 2_048
+        || /[\u0000-\u001f\u007f-\u009f]/u.test(value)) {
+        return fail("WSSPEC_FEISHU_TARGET_INVALID", "飞书文档目标必须是有界 URL 或 token。");
+    }
+    inspectSurface(value);
+    if (!value.includes("://")) {
+        return { documentToken: validToken(value), kind: "token" };
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return fail("WSSPEC_FEISHU_TARGET_INVALID", "飞书文档 URL 无效。");
+    }
+    if (url.protocol !== "https:" || url.username !== "" || url.password !== "" || url.port !== ""
+        || url.search !== "" || url.hash !== "" || !allowedHost(url.hostname)) {
+        return fail("WSSPEC_FEISHU_TARGET_INVALID", "飞书文档 URL 不属于受支持的安全目标。");
+    }
+    inspectSurface(url.hostname);
+    const parts = url.pathname.split("/").filter(Boolean);
+    if (parts.length !== 2 || !["doc", "docx", "wiki"].includes(parts[0])) {
+        return fail("WSSPEC_FEISHU_TARGET_INVALID", "飞书文档 URL 路径无效。");
+    }
+    const documentToken = validToken(parts[1]);
+    const kind = parts[0];
+    return {
+        documentToken,
+        kind,
+        canonicalInputUrl: `https://${url.hostname.toLowerCase()}/${kind}/${documentToken}`,
+    };
+}
+export function validateLarkIdentity(value) {
+    if (value === undefined || value === "user")
+        return "user";
+    if (value === "bot")
+        return "bot";
+    return fail("WSSPEC_FEISHU_CONFIGURATION_INVALID", "飞书身份只允许 user 或 bot。");
+}
+export function validateLarkEnvironment(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === null || typeof value !== "object" || Array.isArray(value)
+        || (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)) {
+        return fail("WSSPEC_FEISHU_CONFIGURATION_INVALID", "飞书 Provider 环境配置无效。");
+    }
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    if (Reflect.ownKeys(value).some((key) => typeof key !== "string" || !allowedEnvironment.has(key))
+        || Object.values(descriptors).some((descriptor) => !descriptor.enumerable || !("value" in descriptor))) {
+        return fail("WSSPEC_FEISHU_CONFIGURATION_INVALID", "飞书 Provider 环境包含不允许的属性。");
+    }
+    const result = {};
+    for (const [key, descriptor] of Object.entries(descriptors)) {
+        const candidate = descriptor.value;
+        if (!allowedEnvironment.has(key) || (candidate !== undefined
+            && (typeof candidate !== "string" || !path.isAbsolute(candidate) || candidate.includes("\0")))) {
+            return fail("WSSPEC_FEISHU_CONFIGURATION_INVALID", "飞书 Provider 环境只允许受审计的绝对配置目录。");
+        }
+        result[key] = candidate;
+    }
+    return result;
+}
+export function mapFeishuProcessError(error) {
+    if (error instanceof FeishuDocumentError)
+        throw error;
+    if (!(error instanceof ProcessJsonError))
+        return fail("WSSPEC_FEISHU_REQUEST_FAILED", "飞书文档请求失败。");
+    if (error.code === "WSSPEC_PROCESS_EXECUTABLE_INVALID" || error.code === "WSSPEC_PROCESS_SPAWN_FAILED") {
+        return fail("WSSPEC_FEISHU_MISSING_BINARY", "lark-cli 不存在或不可执行。");
+    }
+    if (error.code === "WSSPEC_PROCESS_OUTPUT_LIMIT") {
+        return fail("WSSPEC_FEISHU_RESPONSE_TOO_LARGE", "飞书文档响应超过上限。");
+    }
+    if (error.code === "WSSPEC_PROCESS_INVALID_JSON") {
+        return fail("WSSPEC_FEISHU_RESPONSE_INVALID", "飞书文档响应不是合法 JSON。");
+    }
+    const diagnostic = error.diagnostic.toLowerCase();
+    if (/rate[ -]?limit|too many requests|\b429\b/u.test(diagnostic)) {
+        return fail("WSSPEC_FEISHU_RATE_LIMITED", "飞书文档请求达到速率限制。");
+    }
+    if (/\b404\b|not found/u.test(diagnostic))
+        return fail("WSSPEC_FEISHU_NOT_FOUND", "飞书文档不存在。");
+    if (/\b401\b|unauthenticated|authentication required|not configured|refresh token/u.test(diagnostic)) {
+        return fail("WSSPEC_FEISHU_UNAUTHENTICATED", "lark-cli 当前身份未认证。");
+    }
+    if (/\b403\b|forbidden|permission denied/u.test(diagnostic)) {
+        return fail("WSSPEC_FEISHU_FORBIDDEN", "飞书文档访问被拒绝。");
+    }
+    return fail("WSSPEC_FEISHU_REQUEST_FAILED", "飞书文档请求失败。");
+}
+const larkManifestInput = {
+    id: "lark-cli",
+    capabilities: ["feishu.document", "document.read", "knowledge.publish"],
+    securityClass: "external-write",
+    executable: "lark-cli",
+    minimumVersion: "1.0.0",
+    argvTemplates: [
+        ["docs", "+fetch", "--doc", "{documentToken}", "--format", "json", "--as", "{identity}"],
+        ["docs", "+fetch", "--doc", "{documentToken}", "--offset", "{offset}", "--limit", "100", "--format", "json", "--as", "{identity}"],
+        ["docs", "+create", "--title", "{title}", "--folder-token", "{folderToken}", "--markdown", "{markdown}", "--as", "{identity}"],
+        ["docs", "+create", "--title", "{title}", "--wiki-node", "{wikiNode}", "--markdown", "{markdown}", "--as", "{identity}"],
+        ["docs", "+create", "--title", "{title}", "--wiki-space", "{wikiSpace}", "--markdown", "{markdown}", "--as", "{identity}"],
+        ["docs", "+update", "--doc", "{documentToken}", "--mode", "overwrite", "--markdown", "{markdown}", "--new-title", "{title}", "--as", "{identity}"],
+    ],
+    doctor: {
+        version: { kind: "version", argv: ["--version"], parser: { kind: "text-semver" } },
+        auth: { kind: "unavailable", reasonCode: "WSSPEC_CONNECTOR_AUTH_PROBE_UNAVAILABLE" },
+    },
+    envPolicy: { allow: ["HOME", "XDG_CONFIG_HOME", "LARK_CONFIG_DIR"] },
+    timeoutMs: 30_000,
+    maxStdoutBytes: 1024 * 1024,
+};
+export const larkCliManifest = defineConnectorManifest(larkManifestInput);
+function sameManifest(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+export function larkConnectorResourcesRoot() {
+    return fileURLToPath(new URL("../../../resources/connectors/", import.meta.url));
+}
+export async function loadLarkConnectorManifest(root = larkConnectorResourcesRoot()) {
+    if (!path.isAbsolute(root))
+        return fail("WSSPEC_FEISHU_MANIFEST_INVALID", "lark Connector Manifest 根目录必须是绝对路径。");
+    try {
+        const filename = path.join(root, "lark-cli.yaml");
+        const info = await lstat(filename);
+        if (!info.isFile() || info.isSymbolicLink() || info.size < 1 || info.size > maximumManifestBytes)
+            throw new Error("invalid file");
+        const document = parseDocument(await readFile(filename, "utf8"), { uniqueKeys: true, schema: "core" });
+        if (document.errors.length !== 0 || document.warnings.length !== 0)
+            throw new Error("invalid yaml");
+        let alias = false;
+        visit(document, (_key, node) => { if (isAlias(node))
+            alias = true; });
+        if (alias)
+            throw new Error("aliases forbidden");
+        const manifest = defineConnectorManifest(document.toJS({ maxAliasCount: 0 }));
+        if (!sameManifest(manifest, larkCliManifest))
+            throw new Error("contract drift");
+        return manifest;
+    }
+    catch {
+        return fail("WSSPEC_FEISHU_MANIFEST_INVALID", "lark Connector Manifest 不符合审计合同。");
+    }
+}
+export function registerLarkConnectorManifest(registry, manifest) {
+    if (!sameManifest(manifest, larkCliManifest)) {
+        return fail("WSSPEC_FEISHU_MANIFEST_INVALID", "lark Connector Manifest 与审计合同不一致。");
+    }
+    registry.register(manifest);
+    return registry;
+}
+//# sourceMappingURL=feishu-document.js.map

package/dist/registry/connectors/feishu-document.js.map

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

package/dist/registry/connectors/git-commit.d.ts

@@ -0,0 +1,32 @@
+export interface GitCommitApproval {
+    repositoryRoot: string;
+    repositoryCommonDir: string;
+    baselineRevision: string;
+    files: string[];
+    message: string;
+    diffDigest: `sha256:${string}`;
+}
+export interface GitCommitReceipt {
+    version: 1;
+    kind: "git-commit-receipt";
+    provider: "git-native";
+    action: "git.commit";
+    repositoryCommonDir: string;
+    baselineRevision: string;
+    messageDigest: `sha256:${string}`;
+    diffDigest: `sha256:${string}`;
+    commitOid: string;
+    parentOid: string;
+    treeOid: string;
+    files: string[];
+    readBackDigest: `sha256:${string}`;
+    status: "verified";
+    verifiedAt: string;
+}
+export declare class GitCommitError extends Error {
+    readonly code: `WSSPEC_${string}`;
+    constructor(code: `WSSPEC_${string}`, message: string);
+}
+export declare function failGitCommit(code: `WSSPEC_${string}`, message: string): never;
+export declare function validateGitCommitApproval(value: unknown): Readonly<GitCommitApproval>;
+export declare const gitCommitManifest: import("./types.js").ConnectorManifest;