chapterhouse 0.1.1

package/dist/integrations/ado-analytics.js

@@ -0,0 +1,178 @@
+import { config } from "../config.js";
+import { ensureWikiStructure, listPages, readPage } from "../wiki/fs.js";
+const RECENT_UPDATE_DAYS = 31;
+function escapeODataString(value) {
+    return value.replace(/'/g, "''");
+}
+function encodeODataValue(value) {
+    return encodeURIComponent(value).replace(/%27/g, "'");
+}
+function buildDefaultBaseUrl(org, project) {
+    const normalizedOrg = org.trim().replace(/\/+$/, "");
+    const normalizedProject = project.trim().replace(/^\/+|\/+$/g, "");
+    return `${normalizedOrg.replace("https://dev.azure.com", "https://analytics.dev.azure.com")}/${normalizedProject}/_odata/v4.0-preview`;
+}
+function buildODataUrl(baseUrl, filter, select) {
+    return `${baseUrl.replace(/\/+$/, "")}/WorkItems?$filter=${encodeODataValue(filter)}&$select=${select.join(",")}`;
+}
+function asNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return 0;
+}
+function asInteger(value) {
+    const parsed = asNumber(value);
+    return Number.isInteger(parsed) ? parsed : null;
+}
+function asString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function toPercentComplete(currentValue, targetValue) {
+    if (!Number.isFinite(currentValue) || !Number.isFinite(targetValue) || targetValue <= 0) {
+        return 0;
+    }
+    return Math.max(0, Math.min(100, Math.round((currentValue / targetValue) * 100)));
+}
+function toRecentUpdateCutoff(now) {
+    const cutoff = new Date(now);
+    cutoff.setUTCDate(cutoff.getUTCDate() - (RECENT_UPDATE_DAYS - 1));
+    return cutoff.toISOString().slice(0, 10);
+}
+function getRecentUpdatePaths(now, listPagePaths) {
+    ensureWikiStructure();
+    const cutoff = toRecentUpdateCutoff(now);
+    return listPagePaths()
+        .filter((path) => path.startsWith("pages/okrs/updates/"))
+        .filter((path) => path.slice("pages/okrs/updates/".length).replace(/\.md$/, "") >= cutoff)
+        .sort()
+        .reverse();
+}
+function extractHighlights(content) {
+    const matches = content.matchAll(/\*\*Activity\*\*:\s*(.+?)(?:\s{2,}|\n|$)/g);
+    return Array.from(matches, (match) => (match[1] ?? "").trim()).filter(Boolean);
+}
+export class AdoAnalytics {
+    baseUrl;
+    pat;
+    fetchImpl;
+    now;
+    listPagesImpl;
+    readPageImpl;
+    constructor(options = {}) {
+        this.baseUrl = (options.baseUrl ?? buildDefaultBaseUrl(config.ADO_ORG, config.ADO_PROJECT)).trim().replace(/\/+$/, "");
+        this.pat = (options.pat ?? config.adoPat).trim();
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.now = options.now ?? (() => new Date());
+        this.listPagesImpl = options.listPages ?? listPages;
+        this.readPageImpl = options.readPage ?? readPage;
+    }
+    async getKRProgress(period) {
+        const rows = await this.getKRProgressWithParents(period);
+        return rows.map(({ parentWorkItemId: _parentWorkItemId, ...row }) => row);
+    }
+    async getObjectiveRollup(period) {
+        const [objectives, keyResults] = await Promise.all([
+            this.fetchJson(buildODataUrl(this.baseUrl, `WorkItemType eq 'Epic' and Custom_OKRPeriod eq '${escapeODataString(period)}'`, ["WorkItemId", "Title", "Custom_OKROwner"])),
+            this.getKRProgressWithParents(period),
+        ]);
+        const krsByObjective = new Map();
+        for (const kr of keyResults) {
+            if (kr.parentWorkItemId === null) {
+                continue;
+            }
+            const existing = krsByObjective.get(kr.parentWorkItemId) ?? [];
+            existing.push({
+                workItemId: kr.workItemId,
+                title: kr.title,
+                currentValue: kr.currentValue,
+                targetValue: kr.targetValue,
+                percentComplete: kr.percentComplete,
+                owner: kr.owner,
+                state: kr.state,
+            });
+            krsByObjective.set(kr.parentWorkItemId, existing);
+        }
+        return (objectives.value ?? [])
+            .map((objective) => {
+            const workItemId = asInteger(objective.WorkItemId);
+            if (workItemId === null) {
+                return null;
+            }
+            const krs = krsByObjective.get(workItemId) ?? [];
+            const percentComplete = krs.length === 0
+                ? 0
+                : Math.round(krs.reduce((sum, kr) => sum + kr.percentComplete, 0) / krs.length);
+            return {
+                workItemId,
+                title: asString(objective.Title),
+                owner: asString(objective.Custom_OKROwner),
+                percentComplete,
+                krs,
+            };
+        })
+            .filter((objective) => objective !== null);
+    }
+    async buildReportData(period) {
+        const objectives = await this.getObjectiveRollup(period);
+        const recentUpdates = getRecentUpdatePaths(this.now(), this.listPagesImpl);
+        const highlights = recentUpdates
+            .flatMap((path) => extractHighlights(this.readPageImpl(path) ?? ""))
+            .slice(0, 10);
+        const totalKRs = objectives.reduce((sum, objective) => sum + objective.krs.length, 0);
+        const completedKRs = objectives.reduce((sum, objective) => sum + objective.krs.filter((kr) => kr.percentComplete >= 100 || /^done$/i.test(kr.state)).length, 0);
+        return {
+            period,
+            generatedAt: this.now().toISOString(),
+            objectives,
+            highlights,
+            totalKRs,
+            completedKRs,
+        };
+    }
+    async getKRProgressWithParents(period) {
+        const payload = await this.fetchJson(buildODataUrl(this.baseUrl, `WorkItemType eq 'Feature' and Custom_OKRPeriod eq '${escapeODataString(period)}'`, ["WorkItemId", "Title", "Custom_CurrentValue", "Custom_TargetValue", "Custom_OKROwner", "State", "ParentWorkItemId"]));
+        return (payload.value ?? [])
+            .map((row) => {
+            const workItemId = asInteger(row.WorkItemId);
+            if (workItemId === null) {
+                return null;
+            }
+            const currentValue = asNumber(row.Custom_CurrentValue);
+            const targetValue = asNumber(row.Custom_TargetValue);
+            return {
+                workItemId,
+                title: asString(row.Title),
+                currentValue,
+                targetValue,
+                percentComplete: toPercentComplete(currentValue, targetValue),
+                owner: asString(row.Custom_OKROwner),
+                state: asString(row.State),
+                parentWorkItemId: asInteger(row.ParentWorkItemId),
+            };
+        })
+            .filter((row) => row !== null);
+    }
+    async fetchJson(url) {
+        if (this.pat.length === 0) {
+            throw new Error("ADO_PAT is not configured.");
+        }
+        const response = await this.fetchImpl(url, {
+            headers: {
+                authorization: `Basic ${Buffer.from(`:${this.pat}`).toString("base64")}`,
+                accept: "application/json",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`ADO Analytics request failed: HTTP ${response.status}`);
+        }
+        return await response.json();
+    }
+}
+//# sourceMappingURL=ado-analytics.js.map

package/dist/integrations/ado-analytics.test.js

@@ -0,0 +1,284 @@
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+const REPO_ROOT = fileURLToPath(new URL("../..", import.meta.url));
+async function loadAnalyticsModule() {
+    try {
+        return await import(new URL(`./ado-analytics.js?cachebust=${Date.now()}-${Math.random()}`, import.meta.url).href);
+    }
+    catch {
+        return null;
+    }
+}
+test("getKRProgress builds the expected OData URL and parses the response", async () => {
+    const analyticsModule = await loadAnalyticsModule();
+    assert.ok(analyticsModule, "ado analytics module should exist");
+    const requests = [];
+    const analytics = new analyticsModule.AdoAnalytics({
+        baseUrl: "https://analytics.dev.azure.com/example-org/example-project/_odata/v4.0-preview",
+        pat: "test-pat",
+        fetchImpl: async (input, init) => {
+            requests.push({ input: String(input), init });
+            return new Response(JSON.stringify({
+                value: [
+                    {
+                        WorkItemId: 101,
+                        Title: "Ship SSO to all tenants",
+                        Custom_CurrentValue: 75,
+                        Custom_TargetValue: 100,
+                        Custom_OKROwner: "ada@example.com",
+                        State: "Active",
+                    },
+                ],
+            }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        },
+    });
+    const rows = await analytics.getKRProgress("2026-Q2");
+    assert.equal(requests.length, 1);
+    const request = requests[0];
+    assert.ok(request, "request should be captured");
+    assert.equal(request.input, "https://analytics.dev.azure.com/example-org/example-project/_odata/v4.0-preview/WorkItems?$filter=WorkItemType%20eq%20'Feature'%20and%20Custom_OKRPeriod%20eq%20'2026-Q2'&$select=WorkItemId,Title,Custom_CurrentValue,Custom_TargetValue,Custom_OKROwner,State,ParentWorkItemId");
+    assert.equal((request.init?.headers).authorization, `Basic ${Buffer.from(":test-pat").toString("base64")}`);
+    assert.deepEqual(rows, [
+        {
+            workItemId: 101,
+            title: "Ship SSO to all tenants",
+            currentValue: 75,
+            targetValue: 100,
+            percentComplete: 75,
+            owner: "ada@example.com",
+            state: "Active",
+        },
+    ]);
+});
+test("getKRProgress caps percentComplete at 100", async () => {
+    const analyticsModule = await loadAnalyticsModule();
+    assert.ok(analyticsModule, "ado analytics module should exist");
+    const analytics = new analyticsModule.AdoAnalytics({
+        pat: "test-pat",
+        fetchImpl: async () => new Response(JSON.stringify({
+            value: [
+                {
+                    WorkItemId: 202,
+                    Title: "Over-achieve the KR",
+                    Custom_CurrentValue: 140,
+                    Custom_TargetValue: 100,
+                    Custom_OKROwner: "grace@example.com",
+                    State: "Done",
+                },
+            ],
+        }), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+        }),
+    });
+    const rows = await analytics.getKRProgress("2026-Q2");
+    assert.equal(rows[0]?.percentComplete, 100);
+});
+test("uses configured ADO org and project for the default analytics base URL", async () => {
+    const result = spawnSync(process.execPath, [
+        "--import",
+        "tsx",
+        "--input-type=module",
+        "--eval",
+        `
+        const mod = await import("./src/integrations/ado-analytics.ts");
+        const analytics = new mod.AdoAnalytics({
+          pat: "test-pat",
+          fetchImpl: async (input) => {
+            console.log("__RESULT__" + String(input));
+            return new Response(JSON.stringify({ value: [] }), {
+              status: 200,
+              headers: { "content-type": "application/json" },
+            });
+          },
+        });
+        await analytics.getKRProgress("2026-Q2");
+      `,
+    ], {
+        cwd: REPO_ROOT,
+        env: {
+            ...process.env,
+            ADO_ORG: "https://dev.azure.com/example-org",
+            ADO_PROJECT: "example-project",
+        },
+        encoding: "utf8",
+    });
+    assert.equal(result.status, 0, result.stderr);
+    const outputLine = result.stdout
+        .split("\n")
+        .find((line) => line.startsWith("__RESULT__"));
+    assert.ok(outputLine, "child process should print the default analytics URL");
+    assert.equal(outputLine.replace("__RESULT__", ""), "https://analytics.dev.azure.com/example-org/example-project/_odata/v4.0-preview/WorkItems?$filter=WorkItemType%20eq%20'Feature'%20and%20Custom_OKRPeriod%20eq%20'2026-Q2'&$select=WorkItemId,Title,Custom_CurrentValue,Custom_TargetValue,Custom_OKROwner,State,ParentWorkItemId");
+});
+test("getObjectiveRollup averages KR percentages for each objective", async () => {
+    const analyticsModule = await loadAnalyticsModule();
+    assert.ok(analyticsModule, "ado analytics module should exist");
+    const analytics = new analyticsModule.AdoAnalytics({
+        pat: "test-pat",
+        fetchImpl: async (input) => {
+            const url = String(input);
+            if (url.includes("WorkItemType%20eq%20'Epic'")) {
+                return new Response(JSON.stringify({
+                    value: [
+                        {
+                            WorkItemId: 7,
+                            Title: "Improve identity coverage",
+                            Custom_OKROwner: "ada@example.com",
+                        },
+                    ],
+                }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            return new Response(JSON.stringify({
+                value: [
+                    {
+                        WorkItemId: 101,
+                        Title: "Ship SSO to all tenants",
+                        Custom_CurrentValue: 75,
+                        Custom_TargetValue: 100,
+                        Custom_OKROwner: "ada@example.com",
+                        State: "Active",
+                        ParentWorkItemId: 7,
+                    },
+                    {
+                        WorkItemId: 102,
+                        Title: "Migrate legacy auth flows",
+                        Custom_CurrentValue: 20,
+                        Custom_TargetValue: 40,
+                        Custom_OKROwner: "ada@example.com",
+                        State: "Active",
+                        ParentWorkItemId: 7,
+                    },
+                ],
+            }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        },
+    });
+    const objectives = await analytics.getObjectiveRollup("2026-Q2");
+    assert.deepEqual(objectives, [
+        {
+            workItemId: 7,
+            title: "Improve identity coverage",
+            owner: "ada@example.com",
+            percentComplete: 63,
+            krs: [
+                {
+                    workItemId: 101,
+                    title: "Ship SSO to all tenants",
+                    currentValue: 75,
+                    targetValue: 100,
+                    percentComplete: 75,
+                    owner: "ada@example.com",
+                    state: "Active",
+                },
+                {
+                    workItemId: 102,
+                    title: "Migrate legacy auth flows",
+                    currentValue: 20,
+                    targetValue: 40,
+                    percentComplete: 50,
+                    owner: "ada@example.com",
+                    state: "Active",
+                },
+            ],
+        },
+    ]);
+});
+test("buildReportData combines objective rollups and recent update highlights", async () => {
+    const analyticsModule = await loadAnalyticsModule();
+    assert.ok(analyticsModule, "ado analytics module should exist");
+    const analytics = new analyticsModule.AdoAnalytics({
+        pat: "test-pat",
+        now: () => new Date("2026-05-06T00:00:00.000Z"),
+        listPages: () => [
+            "pages/okrs/updates/2026-05-02.md",
+            "pages/okrs/updates/2026-04-28.md",
+            "pages/okrs/2026-Q2.md",
+        ],
+        readPage: (path) => {
+            if (path === "pages/okrs/updates/2026-05-02.md") {
+                return [
+                    "## 2026-05-02T10:00:00.000Z — eng-1",
+                    "",
+                    "**Activity**: Finished SSO rollout dry-run  ",
+                    "**Key Result**: 101  ",
+                    "**Delta**: 10  ",
+                    "",
+                ].join("\n");
+            }
+            if (path === "pages/okrs/updates/2026-04-28.md") {
+                return [
+                    "## 2026-04-28T10:00:00.000Z — eng-2",
+                    "",
+                    "**Activity**: Removed the last auth migration blocker  ",
+                    "**Key Result**: 102  ",
+                    "**Delta**: 5  ",
+                    "",
+                ].join("\n");
+            }
+            return undefined;
+        },
+        fetchImpl: async (input) => {
+            const url = String(input);
+            if (url.includes("WorkItemType%20eq%20'Epic'")) {
+                return new Response(JSON.stringify({
+                    value: [
+                        {
+                            WorkItemId: 7,
+                            Title: "Improve identity coverage",
+                            Custom_OKROwner: "ada@example.com",
+                        },
+                    ],
+                }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            return new Response(JSON.stringify({
+                value: [
+                    {
+                        WorkItemId: 101,
+                        Title: "Ship SSO to all tenants",
+                        Custom_CurrentValue: 100,
+                        Custom_TargetValue: 100,
+                        Custom_OKROwner: "ada@example.com",
+                        State: "Done",
+                        ParentWorkItemId: 7,
+                    },
+                    {
+                        WorkItemId: 102,
+                        Title: "Migrate legacy auth flows",
+                        Custom_CurrentValue: 20,
+                        Custom_TargetValue: 40,
+                        Custom_OKROwner: "ada@example.com",
+                        State: "Active",
+                        ParentWorkItemId: 7,
+                    },
+                ],
+            }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        },
+    });
+    const reportData = await analytics.buildReportData("2026-Q2");
+    assert.equal(reportData.period, "2026-Q2");
+    assert.equal(reportData.generatedAt, "2026-05-06T00:00:00.000Z");
+    assert.equal(reportData.totalKRs, 2);
+    assert.equal(reportData.completedKRs, 1);
+    assert.deepEqual(reportData.highlights, [
+        "Finished SSO rollout dry-run",
+        "Removed the last auth migration blocker",
+    ]);
+    assert.equal(reportData.objectives[0]?.percentComplete, 75);
+});
+//# sourceMappingURL=ado-analytics.test.js.map

package/dist/integrations/ado-client.js

@@ -0,0 +1,227 @@
+import * as azureDevops from "azure-devops-node-api";
+import { config } from "../config.js";
+import { ADO_ORG, ADO_PROJECT, FIELDS, STD_FIELDS, UNIT_FIELD, WIT } from "./ado-schema.js";
+function escapeWiqlLiteral(value) {
+    return value.replace(/'/g, "''");
+}
+function getStringField(fields, fieldName) {
+    const value = fields?.[fieldName];
+    if (typeof value === "string") {
+        return value.trim();
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+    }
+    return "";
+}
+function getNumberField(fields, fieldName) {
+    const value = fields?.[fieldName];
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return 0;
+}
+function getParentId(fields) {
+    const value = fields?.[STD_FIELDS.PARENT];
+    if (typeof value === "number" && Number.isInteger(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isInteger(parsed)) {
+            return parsed;
+        }
+    }
+    return null;
+}
+function toPercentComplete(currentValue, targetValue) {
+    if (!Number.isFinite(currentValue) || !Number.isFinite(targetValue) || targetValue <= 0) {
+        return 0;
+    }
+    return Math.max(0, Math.min(100, Math.round((currentValue / targetValue) * 100)));
+}
+function buildWiql(workItemType, period) {
+    const periodClause = period
+        ? ` AND [${FIELDS.OKR_PERIOD}] = '${escapeWiqlLiteral(period)}'`
+        : "";
+    return [
+        "SELECT [System.Id]",
+        "FROM WorkItems",
+        "WHERE [System.TeamProject] = @project",
+        `AND [System.WorkItemType] = '${workItemType}'${periodClause}`,
+    ].join(" ");
+}
+function getWorkItemIds(result) {
+    return (result.workItems ?? [])
+        .map((item) => item.id)
+        .filter((id) => typeof id === "number");
+}
+export class AdoClient {
+    org;
+    project;
+    pat;
+    workItemTrackingApi;
+    constructor(options = {}) {
+        this.org = options.org?.trim() || config.adoOrg || ADO_ORG;
+        this.project = options.project?.trim() || config.adoProject || ADO_PROJECT;
+        this.pat = options.pat?.trim() || config.adoPat || "";
+        this.workItemTrackingApi = options.workItemTrackingApi;
+    }
+    async getKeyResults(period) {
+        const api = await this.getApi();
+        const result = await api.queryByWiql({ query: buildWiql(WIT.KEY_RESULT, period) }, { project: this.project });
+        const ids = getWorkItemIds(result);
+        if (ids.length === 0) {
+            return [];
+        }
+        const workItems = await api.getWorkItems(ids, [
+            STD_FIELDS.TITLE,
+            STD_FIELDS.PARENT,
+            FIELDS.CURRENT_VALUE,
+            FIELDS.TARGET_VALUE,
+            FIELDS.OKR_OWNER,
+            UNIT_FIELD,
+        ]);
+        return workItems
+            .filter((item) => typeof item.id === "number")
+            .map((item) => ({
+            id: item.id,
+            title: getStringField(item.fields, STD_FIELDS.TITLE),
+            currentValue: getNumberField(item.fields, FIELDS.CURRENT_VALUE),
+            targetValue: getNumberField(item.fields, FIELDS.TARGET_VALUE),
+            unit: getStringField(item.fields, UNIT_FIELD),
+            owner: getStringField(item.fields, FIELDS.OKR_OWNER),
+            parentId: getParentId(item.fields),
+        }));
+    }
+    async getObjectives(period) {
+        const [objectiveWorkItems, keyResults] = await Promise.all([
+            this.getObjectiveWorkItems(period),
+            this.getKeyResults(period),
+        ]);
+        const keyResultIdsByObjective = new Map();
+        for (const keyResult of keyResults) {
+            if (keyResult.parentId === null) {
+                continue;
+            }
+            const existing = keyResultIdsByObjective.get(keyResult.parentId) ?? [];
+            existing.push(keyResult.id);
+            keyResultIdsByObjective.set(keyResult.parentId, existing);
+        }
+        return objectiveWorkItems
+            .filter((item) => typeof item.id === "number")
+            .map((item) => ({
+            id: item.id,
+            title: getStringField(item.fields, STD_FIELDS.TITLE),
+            owner: getStringField(item.fields, FIELDS.OKR_OWNER),
+            keyResultIds: keyResultIdsByObjective.get(item.id) ?? [],
+        }));
+    }
+    async updateKRProgress(workItemId, currentValue, notes) {
+        const api = await this.getApi();
+        const document = [
+            { op: "add", path: `/fields/${FIELDS.CURRENT_VALUE}`, value: currentValue },
+        ];
+        await api.updateWorkItem(undefined, document, workItemId, this.project);
+        if (notes && notes.trim().length > 0) {
+            await api.addComment({ text: notes }, this.project, workItemId);
+        }
+    }
+    async getOKRSummary(period) {
+        const [objectives, keyResults] = await Promise.all([
+            this.getObjectives(period),
+            this.getKeyResults(period),
+        ]);
+        const keyResultsByObjective = new Map();
+        for (const keyResult of keyResults) {
+            if (keyResult.parentId === null) {
+                continue;
+            }
+            const withPercent = {
+                ...keyResult,
+                percentComplete: toPercentComplete(keyResult.currentValue, keyResult.targetValue),
+            };
+            const existing = keyResultsByObjective.get(keyResult.parentId) ?? [];
+            existing.push(withPercent);
+            keyResultsByObjective.set(keyResult.parentId, existing);
+        }
+        return {
+            period,
+            objectives: objectives.map((objective) => {
+                const objectiveKeyResults = keyResultsByObjective.get(objective.id) ?? [];
+                const percentComplete = objectiveKeyResults.length === 0
+                    ? 0
+                    : Math.round(objectiveKeyResults.reduce((sum, keyResult) => sum + keyResult.percentComplete, 0) / objectiveKeyResults.length);
+                return {
+                    id: objective.id,
+                    title: objective.title,
+                    owner: objective.owner,
+                    percentComplete,
+                    keyResults: objectiveKeyResults,
+                };
+            }),
+        };
+    }
+    async createKeyResult(objectiveId, kr) {
+        const api = await this.getApi();
+        const document = [
+            { op: "add", path: `/fields/${STD_FIELDS.TITLE}`, value: kr.title },
+            { op: "add", path: `/fields/${FIELDS.CURRENT_VALUE}`, value: kr.currentValue },
+            { op: "add", path: `/fields/${FIELDS.TARGET_VALUE}`, value: kr.targetValue },
+            { op: "add", path: `/fields/${FIELDS.OKR_PERIOD}`, value: kr.period },
+            { op: "add", path: `/fields/${FIELDS.OKR_OWNER}`, value: kr.owner },
+            { op: "add", path: `/fields/${UNIT_FIELD}`, value: kr.unit },
+            {
+                op: "add",
+                path: "/relations/-",
+                value: {
+                    rel: "System.LinkTypes.Hierarchy-Reverse",
+                    url: `${this.org}/_apis/wit/workItems/${objectiveId}`,
+                },
+            },
+        ];
+        if (kr.tags && kr.tags.length > 0) {
+            document.push({
+                op: "add",
+                path: `/fields/${STD_FIELDS.TAGS}`,
+                value: kr.tags.join("; "),
+            });
+        }
+        const created = await api.createWorkItem(undefined, document, this.project, WIT.KEY_RESULT);
+        if (typeof created.id !== "number") {
+            throw new Error("Azure DevOps did not return a new work item ID.");
+        }
+        return created.id;
+    }
+    async getObjectiveWorkItems(period) {
+        const api = await this.getApi();
+        const result = await api.queryByWiql({ query: buildWiql(WIT.OBJECTIVE, period) }, { project: this.project });
+        const ids = getWorkItemIds(result);
+        if (ids.length === 0) {
+            return [];
+        }
+        return await api.getWorkItems(ids, [
+            STD_FIELDS.TITLE,
+            FIELDS.OKR_OWNER,
+        ]);
+    }
+    async getApi() {
+        if (this.workItemTrackingApi) {
+            return this.workItemTrackingApi;
+        }
+        if (this.pat.trim().length === 0) {
+            throw new Error("ADO_PAT is not configured.");
+        }
+        const handler = azureDevops.getPersonalAccessTokenHandler(this.pat);
+        const connection = new azureDevops.WebApi(this.org, handler);
+        this.workItemTrackingApi = await connection.getWorkItemTrackingApi();
+        return this.workItemTrackingApi;
+    }
+}
+//# sourceMappingURL=ado-client.js.map