⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
import { canSyncTask } from "../../sync/eligibility";
import { syncLatestTaskValue } from "../../github/services/sync-latest-task-value";
import db from "../../../database";
import { linkedTaskScope } from "../../github/services/integration-task-scope";
import { findExternalLinksByTask } from "../../github/services/link-manager";
import {
formatIssueBody,
formatTaskDescriptionFromIssue,
} from "../../github/utils/format";
import type { PluginContext, TaskDescriptionChangedEvent } from "../../types";
import type { GiteaConfig } from "../config";
import { createGiteaClient } from "../utils/gitea-api";
type LinkSyncState = import("../../github/utils/sync-echo").SyncStamp;
type LinkMetadata = {
lastSync?: {
description?: LinkSyncState;
};
[key: string]: unknown;
};
export async function handleTaskDescriptionChanged(
event: TaskDescriptionChangedEvent,
context: PluginContext,
): Promise<void> {
if (
!(await canSyncTask(
event.taskId,
context.integrationId,
undefined,
JSON.stringify(context.config),
))
)
return;
const config = context.config as GiteaConfig;
if (!config.baseUrl || !config.accessToken) {
return;
}
const { repositoryOwner, repositoryName } = config;
try {
const current = await db.query.taskTable.findFirst({
where: linkedTaskScope(event.taskId, context.projectId),
columns: { description: true },
});
if (
!current ||
(current.description || "") !== (event.newDescription || "")
)
return;
const links = await findExternalLinksByTask(event.taskId);
const issueLink = links.find(
(link) =>
link.integrationId === context.integrationId &&
link.resourceType === "issue",
);
if (!issueLink) {
return;
}
let metadata: LinkMetadata = {};
if (issueLink.metadata) {
try {
metadata = JSON.parse(issueLink.metadata) as LinkMetadata;
} catch (error) {
console.warn(
"Failed to parse Gitea issue link metadata for description sync",
{
issueLinkId: issueLink.id,
taskId: issueLink.taskId,
metadata: issueLink.metadata,
error,
},
);
}
}
const lastDescSync = metadata.lastSync?.description;
const newDescNormalized = event.newDescription || "";
if (lastDescSync) {
if (
lastDescSync.value === newDescNormalized &&
lastDescSync.source === "gitea"
) {
console.log("Skipping description sync - already synced from Gitea");
return;
}
}
const client = createGiteaClient(config);
const issueNumber = Number.parseInt(issueLink.externalId, 10);
if (Number.isNaN(issueNumber)) {
console.warn("Skipping Gitea description sync for invalid issue number", {
issueLinkId: issueLink.id,
externalId: issueLink.externalId,
taskId: issueLink.taskId,
});
return;
}
await syncLatestTaskValue(
event.taskId,
context.projectId,
issueLink,
"description",
newDescNormalized,
async (value) => {
const response = await client.updateIssue(
repositoryOwner,
repositoryName,
issueNumber,
{
body: formatIssueBody(value, event.taskId),
},
);
return response?.updated_at;
},
async () =>
formatTaskDescriptionFromIssue(
(await client.getIssue(repositoryOwner, repositoryName, issueNumber))
.body ?? null,
event.taskId,
),
{ type: "gitea", config: JSON.stringify(config) },
);
console.log(`Synced task description to Gitea issue #${issueNumber}`);
} catch (error) {
console.error("Failed to update Gitea issue description:", error);
}
}