ws-spec-kit 0.1.0-beta.0

package/dist/adapters/connectors/github-cli.js

@@ -0,0 +1,213 @@
+import { spawnJson } from "../process/spawn-json.js";
+import { credentialLikeValue } from "../../registry/connectors/secret-detector.js";
+import { assertStableIssueIdentity, canonicalIssueText, IssueProviderError, mapIssueProcessError, stableId, validateGithubIssueTarget, validateIssueWriteAction, validateIssueProviderEnvironment, } from "../../registry/connectors/issue.js";
+const timeoutMs = 30_000;
+const maxStdoutBytes = 1024 * 1024;
+function invalid() {
+    throw new IssueProviderError("WSSPEC_ISSUE_RESPONSE_INVALID", "GitHub Issue 响应不符合受审计 Schema。");
+}
+function requiredRecord(value, keys) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)
+        || (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+        || keys.some((key) => !Object.hasOwn(value, key)))
+        return invalid();
+    return value;
+}
+function text(value, maximum, allowEmpty = false) {
+    if (typeof value !== "string" || Buffer.byteLength(value, "utf8") > maximum || value.includes("\0")
+        || (!allowEmpty && value === "") || credentialLikeValue(value))
+        return invalid();
+    return value.normalize("NFC");
+}
+function positiveInteger(value) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        return invalid();
+    return value;
+}
+function actor(value) {
+    const source = requiredRecord(value, ["login"]);
+    return text(source.login, 256);
+}
+function labels(value) {
+    if (!Array.isArray(value) || value.length > 100)
+        return invalid();
+    const result = value.map((label) => canonicalIssueText(text(requiredRecord(label, ["name"]).name, 255)));
+    if (new Set(result).size !== result.length)
+        return invalid();
+    return result;
+}
+function actors(value) {
+    if (!Array.isArray(value) || value.length > 100)
+        return invalid();
+    const result = value.map(actor);
+    if (new Set(result).size !== result.length)
+        return invalid();
+    return result;
+}
+function timestamp(value) {
+    const source = text(value, 64);
+    const parsed = Date.parse(source);
+    if (!Number.isFinite(parsed))
+        return invalid();
+    return new Date(parsed).toISOString();
+}
+function mapIssue(value, target) {
+    const source = requiredRecord(value, ["assignees", "body", "html_url", "labels", "node_id", "number", "state", "title", "updated_at", "user"]);
+    const number = positiveInteger(source.number);
+    if (number !== target.number || text(source.html_url, 2048) !== target.canonicalUrl)
+        return invalid();
+    const title = text(source.title, 512);
+    if (source.body !== null && typeof source.body !== "string")
+        return invalid();
+    const rawBody = source.body === null ? "" : text(source.body, 1024 * 1024, true).replace(/\r\n?/gu, "\n");
+    const state = source.state === "open" || source.state === "closed" ? source.state : invalid();
+    const issueLabels = labels(source.labels);
+    const author = actor(source.user);
+    const assignees = actors(source.assignees);
+    const metadata = {
+        repository: target.repository,
+        state,
+        author,
+        ...(issueLabels.length === 0 ? {} : { labels: issueLabels }),
+        ...(assignees.length === 0 ? {} : { assignees }),
+    };
+    return {
+        type: "github.issue",
+        provider: "github",
+        repository: target.repository,
+        number,
+        state,
+        labels: issueLabels,
+        stableId: stableId("github", source.node_id),
+        canonicalUrl: target.canonicalUrl,
+        title,
+        body: rawBody.trim() === "" ? title : rawBody,
+        updatedAt: timestamp(source.updated_at),
+        metadata,
+    };
+}
+async function execute(input, argv, payload) {
+    try {
+        return (await spawnJson({
+            executable: input.executable,
+            argv,
+            input: payload,
+            timeoutMs,
+            maxStdoutBytes,
+            ...(() => {
+                const environment = validateIssueProviderEnvironment(input.environment, new Set(["HOME", "XDG_CONFIG_HOME", "GH_CONFIG_DIR"]));
+                return environment === undefined ? {} : { environment };
+            })(),
+        })).value;
+    }
+    catch (error) {
+        return mapIssueProcessError(error);
+    }
+}
+async function readValidated(input, target) {
+    const value = await execute(input, ["api", "--method", "GET", target.endpoint, "--hostname", target.host], {});
+    return mapIssue(value, target);
+}
+export async function readGithubIssue(input) {
+    const target = validateGithubIssueTarget(input.target);
+    return readValidated(input, target);
+}
+function mapComment(value, expectedBody, expectedId) {
+    const source = requiredRecord(value, ["body", "id", "node_id"]);
+    const id = positiveInteger(source.id);
+    stableId("github", source.node_id);
+    const body = canonicalIssueText(text(source.body, 1024 * 1024));
+    if ((expectedId !== undefined && id !== expectedId) || body !== canonicalIssueText(expectedBody)) {
+        throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitHub comment 响应与批准内容不一致。");
+    }
+    return { stableId: `github-comment:${id}`, body };
+}
+export async function readGithubComment(input) {
+    const target = validateGithubIssueTarget(input.target);
+    const match = /^github-comment:([1-9][0-9]{0,15})$/u.exec(input.externalStableId);
+    const id = match === null ? Number.NaN : Number(match[1]);
+    if (!Number.isSafeInteger(id)) {
+        throw new IssueProviderError("WSSPEC_ISSUE_TARGET_INVALID", "GitHub comment 稳定标识无效。");
+    }
+    const value = await execute(input, ["api", "--method", "GET", `repos/${encodeURIComponent(target.owner)}/${encodeURIComponent(target.repo)}/issues/comments/${id}`, "--hostname", target.host], {});
+    const source = requiredRecord(value, ["issue_url"]);
+    let issueUrl;
+    try {
+        issueUrl = new URL(text(source.issue_url, 2_048));
+    }
+    catch {
+        return invalid();
+    }
+    const expectedPaths = new Set([`/${target.endpoint}`, `/api/v3/${target.endpoint}`]);
+    const expectedHost = issueUrl.hostname === target.host || (target.host === "github.com" && issueUrl.hostname === "api.github.com");
+    if (issueUrl.protocol !== "https:" || !expectedHost || issueUrl.port !== ""
+        || issueUrl.username !== "" || issueUrl.password !== "" || issueUrl.search !== "" || issueUrl.hash !== ""
+        || !expectedPaths.has(issueUrl.pathname)) {
+        throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitHub comment 不属于批准的 Issue。");
+    }
+    return mapComment(value, input.expectedBody, id);
+}
+function sameLabels(actual, expected) {
+    const compare = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+    const sortedActual = actual.map(canonicalIssueText).sort(compare);
+    const sortedExpected = expected.map(canonicalIssueText).sort(compare);
+    return sortedActual.length === sortedExpected.length && sortedActual.every((label, index) => label === sortedExpected[index]);
+}
+function assertActionReadback(issue, action) {
+    const expectedBody = action.type === "body" ? canonicalIssueText(action.body) : undefined;
+    if ((action.type === "body" && issue.body !== (expectedBody.trim() === "" ? issue.title : expectedBody))
+        || (action.type === "labels" && !sameLabels(issue.labels, action.labels))
+        || (action.type === "state" && issue.state !== action.state)) {
+        throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitHub Issue 回读结果与批准写入不一致。");
+    }
+}
+async function mutateIssue(input, target, method, endpoint, payload) {
+    return execute(input, ["api", "--method", method, endpoint, "--hostname", target.host, "--input", "-"], payload);
+}
+export async function writeGithubIssue(input) {
+    const target = validateGithubIssueTarget(input.target);
+    const action = validateIssueWriteAction(input.action);
+    if (action.type === "issue.close") {
+        const before = await readValidated(input, target);
+        if (before.state === "closed") {
+            await input.markDispatched?.();
+            return before;
+        }
+        await input.markDispatched?.();
+        const writeResult = mapIssue(await mutateIssue(input, target, "PATCH", target.endpoint, { state: "closed" }), target);
+        assertStableIssueIdentity(before, writeResult);
+        if (writeResult.state !== "closed") {
+            throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitHub close 写响应不是 closed。");
+        }
+        const after = await readValidated(input, target);
+        assertStableIssueIdentity(before, after);
+        if (after.state !== "closed") {
+            throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitHub close 回读状态不是 closed。");
+        }
+        return after;
+    }
+    if (action.type === "comment") {
+        await input.markDispatched?.();
+        const posted = mapComment(await mutateIssue(input, target, "POST", `${target.endpoint}/comments`, { body: action.body }), action.body);
+        const confirmed = await readGithubComment({
+            ...input,
+            externalStableId: posted.stableId,
+            expectedBody: action.body,
+        });
+        const after = await readValidated(input, target);
+        return { ...after, externalEffectId: confirmed.stableId };
+    }
+    const before = input.markDispatched === undefined ? undefined : await readValidated(input, target);
+    const payload = action.type === "body" ? { body: action.body }
+        : action.type === "labels" ? { labels: [...action.labels] }
+            : { state: action.state };
+    await input.markDispatched?.();
+    const writeResult = mapIssue(await mutateIssue(input, target, "PATCH", target.endpoint, payload), target);
+    if (before !== undefined)
+        assertStableIssueIdentity(before, writeResult);
+    const after = await readValidated(input, target);
+    assertStableIssueIdentity(writeResult, after);
+    assertActionReadback(after, action);
+    return after;
+}
+//# sourceMappingURL=github-cli.js.map

package/dist/adapters/connectors/github-cli.js.map

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

package/dist/adapters/connectors/gitlab-cli.d.ts

@@ -0,0 +1,23 @@
+import { type GitlabIssueTarget, type IssueWriteAction, type NormalizedIssue, type NormalizedIssueWriteResult } from "../../registry/connectors/issue.js";
+type GitlabEnvironment = Readonly<Partial<Record<"HOME" | "XDG_CONFIG_HOME" | "GLAB_CONFIG_DIR", string | undefined>>>;
+export interface GitlabIssueReadInput {
+    executable: string;
+    target: GitlabIssueTarget;
+    environment?: GitlabEnvironment;
+}
+export interface GitlabIssueWriteInput extends GitlabIssueReadInput {
+    action: IssueWriteAction;
+    markDispatched?(): Promise<void>;
+}
+export interface GitlabNoteReadInput extends GitlabIssueReadInput {
+    externalStableId: string;
+    expectedBody: string;
+}
+export interface NormalizedIssueNote {
+    stableId: string;
+    body: string;
+}
+export declare function readGitlabIssue(input: GitlabIssueReadInput): Promise<NormalizedIssue>;
+export declare function readGitlabNote(input: GitlabNoteReadInput): Promise<NormalizedIssueNote>;
+export declare function writeGitlabIssue(input: GitlabIssueWriteInput): Promise<NormalizedIssueWriteResult>;
+export {};

package/dist/adapters/connectors/gitlab-cli.js

@@ -0,0 +1,199 @@
+import { spawnJson } from "../process/spawn-json.js";
+import { credentialLikeValue } from "../../registry/connectors/secret-detector.js";
+import { assertStableIssueIdentity, canonicalIssueText, IssueProviderError, mapIssueProcessError, stableId, validateGitlabIssueTarget, validateIssueWriteAction, validateIssueProviderEnvironment, } from "../../registry/connectors/issue.js";
+const timeoutMs = 30_000;
+const maxStdoutBytes = 1024 * 1024;
+function invalid() {
+    throw new IssueProviderError("WSSPEC_ISSUE_RESPONSE_INVALID", "GitLab Issue 响应不符合受审计 Schema。");
+}
+function requiredRecord(value, keys) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)
+        || (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+        || keys.some((key) => !Object.hasOwn(value, key)))
+        return invalid();
+    return value;
+}
+function text(value, maximum, allowEmpty = false) {
+    if (typeof value !== "string" || Buffer.byteLength(value, "utf8") > maximum || value.includes("\0")
+        || (!allowEmpty && value === "") || credentialLikeValue(value))
+        return invalid();
+    return value.normalize("NFC");
+}
+function positiveInteger(value) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        return invalid();
+    return value;
+}
+function actor(value) {
+    return text(requiredRecord(value, ["username"]).username, 256);
+}
+function labels(value) {
+    if (!Array.isArray(value) || value.length > 100)
+        return invalid();
+    const result = value.map((label) => canonicalIssueText(text(label, 255)));
+    if (new Set(result).size !== result.length)
+        return invalid();
+    return result;
+}
+function actors(value) {
+    if (!Array.isArray(value) || value.length > 100)
+        return invalid();
+    const result = value.map(actor);
+    if (new Set(result).size !== result.length)
+        return invalid();
+    return result;
+}
+function timestamp(value) {
+    const source = text(value, 64);
+    const parsed = Date.parse(source);
+    if (!Number.isFinite(parsed))
+        return invalid();
+    return new Date(parsed).toISOString();
+}
+function mapIssue(value, target) {
+    const source = requiredRecord(value, ["assignees", "author", "description", "id", "iid", "labels", "state", "title", "updated_at", "web_url"]);
+    const iid = positiveInteger(source.iid);
+    const globalId = positiveInteger(source.id);
+    if (iid !== target.iid || text(source.web_url, 2048) !== target.canonicalUrl)
+        return invalid();
+    const title = text(source.title, 512);
+    if (source.description !== null && typeof source.description !== "string")
+        return invalid();
+    const rawBody = source.description === null ? "" : text(source.description, 1024 * 1024, true).replace(/\r\n?/gu, "\n");
+    const state = source.state === "opened" ? "open" : source.state === "closed" ? "closed" : invalid();
+    const issueLabels = labels(source.labels);
+    const author = actor(source.author);
+    const assignees = actors(source.assignees);
+    const metadata = {
+        repository: target.repository,
+        state,
+        author,
+        ...(issueLabels.length === 0 ? {} : { labels: issueLabels }),
+        ...(assignees.length === 0 ? {} : { assignees }),
+    };
+    return {
+        type: "gitlab.issue",
+        provider: "gitlab",
+        repository: target.repository,
+        number: iid,
+        state,
+        labels: issueLabels,
+        stableId: stableId("gitlab", globalId),
+        canonicalUrl: target.canonicalUrl,
+        title,
+        body: rawBody.trim() === "" ? title : rawBody,
+        updatedAt: timestamp(source.updated_at),
+        metadata,
+    };
+}
+async function execute(input, argv, payload) {
+    try {
+        return (await spawnJson({
+            executable: input.executable,
+            argv,
+            input: payload,
+            timeoutMs,
+            maxStdoutBytes,
+            ...(() => {
+                const environment = validateIssueProviderEnvironment(input.environment, new Set(["HOME", "XDG_CONFIG_HOME", "GLAB_CONFIG_DIR"]));
+                return environment === undefined ? {} : { environment };
+            })(),
+        })).value;
+    }
+    catch (error) {
+        return mapIssueProcessError(error);
+    }
+}
+async function readValidated(input, target) {
+    return mapIssue(await execute(input, ["api", "--method", "GET", target.endpoint, "--hostname", target.host], {}), target);
+}
+export async function readGitlabIssue(input) {
+    return readValidated(input, validateGitlabIssueTarget(input.target));
+}
+function mapComment(value, expectedBody, expectedId) {
+    const source = requiredRecord(value, ["body", "id"]);
+    const id = positiveInteger(source.id);
+    const body = canonicalIssueText(text(source.body, 1024 * 1024));
+    if ((expectedId !== undefined && id !== expectedId) || body !== canonicalIssueText(expectedBody)) {
+        throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitLab note 响应与批准内容不一致。");
+    }
+    return { stableId: `gitlab-note:${id}`, body };
+}
+export async function readGitlabNote(input) {
+    const target = validateGitlabIssueTarget(input.target);
+    const match = /^gitlab-note:([1-9][0-9]{0,15})$/u.exec(input.externalStableId);
+    const id = match === null ? Number.NaN : Number(match[1]);
+    if (!Number.isSafeInteger(id)) {
+        throw new IssueProviderError("WSSPEC_ISSUE_TARGET_INVALID", "GitLab note 稳定标识无效。");
+    }
+    const value = await execute(input, ["api", "--method", "GET", `${target.endpoint}/notes/${id}`, "--hostname", target.host], {});
+    const source = requiredRecord(value, ["noteable_iid", "noteable_type"]);
+    if (source.noteable_type !== "Issue" || positiveInteger(source.noteable_iid) !== target.iid) {
+        throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitLab note 不属于批准的 Issue。");
+    }
+    return mapComment(value, input.expectedBody, id);
+}
+function sameLabels(actual, expected) {
+    const compare = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+    const sortedActual = actual.map(canonicalIssueText).sort(compare);
+    const sortedExpected = expected.map(canonicalIssueText).sort(compare);
+    return sortedActual.length === sortedExpected.length && sortedActual.every((label, index) => label === sortedExpected[index]);
+}
+function assertActionReadback(issue, action) {
+    const expectedBody = action.type === "body" ? canonicalIssueText(action.body) : undefined;
+    if ((action.type === "body" && issue.body !== (expectedBody.trim() === "" ? issue.title : expectedBody))
+        || (action.type === "labels" && !sameLabels(issue.labels, action.labels))
+        || (action.type === "state" && issue.state !== action.state)) {
+        throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitLab Issue 回读结果与批准写入不一致。");
+    }
+}
+async function mutateIssue(input, target, method, endpoint, payload) {
+    return execute(input, ["api", "--method", method, endpoint, "--hostname", target.host, "--input", "-"], payload);
+}
+export async function writeGitlabIssue(input) {
+    const target = validateGitlabIssueTarget(input.target);
+    const action = validateIssueWriteAction(input.action);
+    if (action.type === "issue.close") {
+        const before = await readValidated(input, target);
+        if (before.state === "closed") {
+            await input.markDispatched?.();
+            return before;
+        }
+        await input.markDispatched?.();
+        const writeResult = mapIssue(await mutateIssue(input, target, "PUT", target.endpoint, { state_event: "close" }), target);
+        assertStableIssueIdentity(before, writeResult);
+        if (writeResult.state !== "closed") {
+            throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitLab close 写响应不是 closed。");
+        }
+        const after = await readValidated(input, target);
+        assertStableIssueIdentity(before, after);
+        if (after.state !== "closed") {
+            throw new IssueProviderError("WSSPEC_ISSUE_READBACK_MISMATCH", "GitLab close 回读状态不是 closed。");
+        }
+        return after;
+    }
+    if (action.type === "comment") {
+        await input.markDispatched?.();
+        const posted = mapComment(await mutateIssue(input, target, "POST", `${target.endpoint}/notes`, { body: action.body }), action.body);
+        const confirmed = await readGitlabNote({
+            ...input,
+            externalStableId: posted.stableId,
+            expectedBody: action.body,
+        });
+        const after = await readValidated(input, target);
+        return { ...after, externalEffectId: confirmed.stableId };
+    }
+    const before = input.markDispatched === undefined ? undefined : await readValidated(input, target);
+    const payload = action.type === "body" ? { description: action.body }
+        : action.type === "labels" ? { labels: [...action.labels] }
+            : { state_event: "reopen" };
+    await input.markDispatched?.();
+    const writeResult = mapIssue(await mutateIssue(input, target, "PUT", target.endpoint, payload), target);
+    if (before !== undefined)
+        assertStableIssueIdentity(before, writeResult);
+    const after = await readValidated(input, target);
+    assertStableIssueIdentity(writeResult, after);
+    assertActionReadback(after, action);
+    return after;
+}
+//# sourceMappingURL=gitlab-cli.js.map

package/dist/adapters/connectors/gitlab-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-cli.js","sourceRoot":"","sources":["../../../src/adapters/connectors/gitlab-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,GAMjC,MAAM,oCAAoC,CAAC;AAE5C,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;AAwBnC,SAAS,OAAO;IACd,MAAM,IAAI,kBAAkB,CAAC,+BAA+B,EAAE,+BAA+B,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,IAAuB;IAC7D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;WAClE,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;WAC5F,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAAE,OAAO,OAAO,EAAE,CAAC;IACtE,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,IAAI,CAAC,KAAc,EAAE,OAAe,EAAE,UAAU,GAAG,KAAK;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;WAC9F,CAAC,CAAC,UAAU,IAAI,KAAK,KAAK,EAAE,CAAC,IAAI,mBAAmB,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,EAAE,CAAC;IACnF,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,GAAG,CAAC;QAAE,OAAO,OAAO,EAAE,CAAC;IAC5E,OAAO,KAAe,CAAC;AACzB,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1E,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QAAE,OAAO,OAAO,EAAE,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QAAE,OAAO,OAAO,EAAE,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,EAAE,CAAC;IAC/C,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,MAA6B;IAC7D,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;IAC/I,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC,YAAY;QAAE,OAAO,OAAO,EAAE,CAAC;IAC/F,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,OAAO,EAAE,CAAC;IAC5F,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACpG,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAsC;QAClD,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK;QACL,MAAM;QACN,GAAG,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC5D,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;KACjD,CAAC;IACF,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,GAAG;QACX,KAAK;QACL,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACtC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;QAC7C,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,KAA2B,EAAE,IAAuB,EAAE,OAAgB;IAC3F,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,SAAS,CAAC;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,IAAI;YACJ,KAAK,EAAE,OAAO;YACd,SAAS;YACT,cAAc;YACd,GAAG,CAAC,GAAG,EAAE;gBACP,MAAM,WAAW,GAAG,gCAAgC,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;gBACjI,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;YAC1D,CAAC,CAAC,EAAE;SACL,CAAC,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,KAA2B,EAAE,MAA6B;IACrF,OAAO,QAAQ,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5H,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAA2B;IAC/D,OAAO,aAAa,CAAC,KAAK,EAAE,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,YAAoB,EAAE,UAAmB;IAC3E,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,KAAK,UAAU,CAAC,IAAI,IAAI,KAAK,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,EAAE,yBAAyB,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA0B;IAC7D,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC/E,MAAM,EAAE,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,EAAE,qBAAqB,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,QAAQ,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChI,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,aAAa,KAAK,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC;QAC5F,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,EAAE,2BAA2B,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,MAAyB,EAAE,QAA2B;IACxE,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtE,OAAO,YAAY,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AAChI,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAsB,EAAE,MAA0D;IAC9G,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,YAAa,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;WACpG,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;WACtE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,EAAE,4BAA4B,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,KAA2B,EAC3B,MAA6B,EAC7B,MAAsB,EACtB,QAAgB,EAChB,OAAgB;IAEhB,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACnH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA4B;IACjE,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QACzH,yBAAyB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC/C,IAAI,WAAW,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,EAAE,4BAA4B,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACjD,yBAAyB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,EAAE,6BAA6B,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,UAAU,CACvB,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAC3F,MAAM,CAAC,IAAI,CACZ,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC;YACrC,GAAG,KAAK;YACR,gBAAgB,EAAE,MAAM,CAAC,QAAQ;YACjC,YAAY,EAAE,MAAM,CAAC,IAAI;SAC1B,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE;QACnE,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE;YACzD,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAChC,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;IACxG,IAAI,MAAM,KAAK,SAAS;QAAE,yBAAyB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC9C,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/adapters/connectors/lark-cli.d.ts

@@ -0,0 +1,24 @@
+import { type ExternalReceipt } from "../../domain/external-receipt.js";
+import { type LarkEnvironment, type LarkIdentity } from "../../registry/connectors/feishu-document.js";
+import type { NormalizedRequirementSource } from "../../registry/connectors/requirement-source.js";
+import { type KnowledgePublishTarget } from "../../registry/connectors/knowledge-publish.js";
+export interface FeishuDocumentReadInput {
+    executable: string;
+    document: string;
+    identity?: LarkIdentity;
+    environment?: LarkEnvironment;
+}
+export interface NormalizedFeishuDocument extends NormalizedRequirementSource {
+    type: "feishu.document";
+    documentToken: string;
+}
+export interface PublishKnowledgeInput {
+    executable: string;
+    target: KnowledgePublishTarget;
+    binding: unknown;
+    identity?: LarkIdentity;
+    environment?: LarkEnvironment;
+    markDispatched?(): Promise<void>;
+}
+export declare function readFeishuDocument(input: FeishuDocumentReadInput): Promise<NormalizedFeishuDocument>;
+export declare function publishKnowledge(input: PublishKnowledgeInput): Promise<ExternalReceipt>;