@specship/specship-win32-arm64 0.21.2 → 0.22.0

package/lib/dist/jira/config.js

@@ -51,6 +51,7 @@ const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const shared_1 = require("../installer/targets/shared");
 const types_1 = require("./types");
+const repo_config_1 = require("./repo-config");
 /**
  * Absolute path to the user-level JIRA config. Overridable via
  * `SPECSHIP_JIRA_CONFIG` for tests. Never project-scoped.
@@ -112,8 +113,11 @@ function inferDeployment(creds) {
  *
  * SECURITY: the thrown messages never include a token or PAT value.
  */
-function resolveJiraCredentials() {
+function resolveJiraCredentials(cwd = process.cwd()) {
     const file = loadJiraConfig(); // may throw on malformed
+    // Repo-committed team-lane binding (REQ-JIRATEAM-001). Credentials NEVER
+    // come from here; the loader rejects credential-shaped fields.
+    const repo = (0, repo_config_1.loadRepoJiraBinding)(cwd);
     const baseUrl = process.env.SPECSHIP_JIRA_BASE_URL ?? file?.baseUrl;
     const email = process.env.SPECSHIP_JIRA_EMAIL ?? file?.email;
     const apiToken = process.env.SPECSHIP_JIRA_API_TOKEN ?? file?.apiToken;
@@ -140,8 +144,13 @@ function resolveJiraCredentials() {
     const done = process.env.SPECSHIP_JIRA_TRANSITION_DONE ??
         file?.transitions?.done ??
         'Done';
-    // Default publish project (REQ-JIRAPUB-001): env over file, per field.
-    const project = process.env.SPECSHIP_JIRA_PROJECT ?? file?.project;
+    // Publish project (REQ-JIRAPUB-001 / REQ-JIRATEAM-001). Precedence:
+    //   repo binding > env > user-level file.
+    // Repo binding wins for project identity even over env so every teammate
+    // and CI run targets the same project; credentials never come from repo.
+    const userProject = process.env.SPECSHIP_JIRA_PROJECT ?? file?.project;
+    const project = repo.binding?.projectKey ?? userProject;
+    const bindingSource = repo.binding ? 'repo' : 'user';
     const deployment = inferDeployment({
         deployment: explicitDeployment,
         email,
@@ -166,6 +175,8 @@ function resolveJiraCredentials() {
         caCertPath,
         insecureTls,
         project,
+        bindingSource,
+        bindingPath: repo.path ?? undefined,
     };
 }
 /**

package/lib/dist/jira/config.js.map

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

package/lib/dist/jira/coverage.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Sprint coverage report (REQ-JIRATEAM-004).
+ *
+ * Joins the bound project's active (or named) sprint issues to spec truth:
+ * each JIRA issue lists whether a spec exists, and — when it does — the
+ * rolled-up state of its spec→code links (using the existing spec-link state
+ * machine, never a new one).
+ *
+ * Pure builder: it takes an injectable JIRA read client and a spec-queries
+ * slice; it never mutates JIRA. Posting is done by the caller via
+ * `upsertWatermarkedComment` (REQ-JIRATEAM-004.A3/A4).
+ */
+import type { JiraIssueListResult } from './types';
+import type { SpecLinkState } from '../types';
+/**
+ * The per-issue rolled-up state a coverage row carries. Named to be
+ * self-explanatory in the rendered table; derived from the spec-link states
+ * on the requirement (and its acceptance children).
+ */
+export type CoverageState = 'unspecced' | 'specced' | 'implemented' | 'verified' | 'drifted' | 'broken';
+/** One row of the coverage report — one JIRA sprint issue. */
+export interface CoverageRow {
+    issueKey: string;
+    title: string;
+    jiraStatus: string;
+    specRelPath?: string;
+    state: CoverageState;
+}
+/** Rollup counts closing the report (REQ-JIRATEAM-004.A1). */
+export interface CoverageRollup {
+    total: number;
+    unspecced: number;
+    specced: number;
+    implemented: number;
+    verified: number;
+    drifted: number;
+    broken: number;
+}
+export interface CoverageReport {
+    /** The sprint label — either the explicit name or "active sprint(s)". */
+    sprintLabel: string;
+    rows: CoverageRow[];
+    rollup: CoverageRollup;
+}
+/** Read-only slice of `JiraClient` the coverage builder consumes. */
+export interface CoverageJiraClient {
+    listSprintIssues(opts: {
+        project: string;
+        sprint?: string;
+    }): Promise<JiraIssueListResult>;
+}
+/** Structural slice of SpecQueries the builder reads. */
+export interface CoverageSpecQueries {
+    getSpecById?: (id: string) => {
+        id: string;
+        kind: string;
+        sourcePath: string;
+    } | null;
+    getSpecsByParent?: (id: string) => Array<{
+        id: string;
+        kind: string;
+    }>;
+    getLinksBySpec?: (id: string) => Array<{
+        state: SpecLinkState;
+    }>;
+    /**
+     * Enumerate every spec — used to find the requirement id for a spec file
+     * whose frontmatter carries the JIRA key. The coverage builder only reads
+     * `id`, `kind`, and `sourcePath`.
+     */
+    getAllSpecs?: () => Array<{
+        id: string;
+        kind: string;
+        sourcePath: string;
+    }>;
+}
+/**
+ * Roll a requirement's spec-link states into one CoverageState (A2).
+ * Precedence — a single degraded link always wins so the report never
+ * overstates progress. Reuses the SpecLinkState enum verbatim.
+ */
+export declare function rollupCoverageState(states: SpecLinkState[]): CoverageState;
+export interface BuildCoverageDeps {
+    client: CoverageJiraClient;
+    projectRoot: string;
+    specQueries: CoverageSpecQueries;
+    project: string;
+    sprint?: string;
+}
+/**
+ * Build the sprint coverage report (REQ-JIRATEAM-004.A1/A2). Every issue in
+ * the sprint scope appears — including unspecced ones — with exactly one
+ * rolled-up state, and the rollup counts close the report. Read-only: no
+ * write to JIRA happens here (A4 is enforced by the caller).
+ */
+export declare function buildCoverageReport(deps: BuildCoverageDeps): Promise<CoverageReport>;
+/** Watermark for the single edit-in-place coverage comment (A3). */
+export declare const COVERAGE_COMMENT_WATERMARK = "<!-- specship:coverage v1 -->";
+/**
+ * Render the report as markdown (REQ-JIRATEAM-004.A1). Prefixed with the
+ * coverage watermark so `upsertWatermarkedComment` can find and edit it in
+ * place on re-post.
+ */
+export declare function formatCoverageMarkdown(report: CoverageReport): string;
+//# sourceMappingURL=coverage.d.ts.map

package/lib/dist/jira/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../src/jira/coverage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,SAAS,GACT,aAAa,GACb,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAEb,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC5F;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtF,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,KAAK,CAAC;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IACjE;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,CAO1E;AA2CD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,cAAc,CAAC,CA+CzB;AAED,oEAAoE;AACpE,eAAO,MAAM,0BAA0B,kCAAkC,CAAC;AAO1E;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAyBrE"}

package/lib/dist/jira/coverage.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Sprint coverage report (REQ-JIRATEAM-004).
+ *
+ * Joins the bound project's active (or named) sprint issues to spec truth:
+ * each JIRA issue lists whether a spec exists, and — when it does — the
+ * rolled-up state of its spec→code links (using the existing spec-link state
+ * machine, never a new one).
+ *
+ * Pure builder: it takes an injectable JIRA read client and a spec-queries
+ * slice; it never mutates JIRA. Posting is done by the caller via
+ * `upsertWatermarkedComment` (REQ-JIRATEAM-004.A3/A4).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COVERAGE_COMMENT_WATERMARK = void 0;
+exports.rollupCoverageState = rollupCoverageState;
+exports.buildCoverageReport = buildCoverageReport;
+exports.formatCoverageMarkdown = formatCoverageMarkdown;
+const published_specs_1 = require("./published-specs");
+/**
+ * Roll a requirement's spec-link states into one CoverageState (A2).
+ * Precedence — a single degraded link always wins so the report never
+ * overstates progress. Reuses the SpecLinkState enum verbatim.
+ */
+function rollupCoverageState(states) {
+    if (states.some((s) => s === 'broken'))
+        return 'broken';
+    if (states.some((s) => s === 'drifted' || s === 'orphaned'))
+        return 'drifted';
+    if (states.length === 0)
+        return 'specced';
+    if (states.every((s) => s === 'verified'))
+        return 'verified';
+    if (states.every((s) => s === 'verified' || s === 'implemented'))
+        return 'implemented';
+    return 'specced';
+}
+/**
+ * Collect the spec-link states for a requirement spec: its own links plus
+ * the links of its acceptance children (matches `deriveRequirementStatus` in
+ * spec-tools.ts — one state machine, two rollup precedences).
+ */
+function collectLinkStates(sq, specId) {
+    const states = [];
+    const own = sq.getLinksBySpec?.(specId) ?? [];
+    for (const l of own)
+        states.push(l.state);
+    const children = sq.getSpecsByParent?.(specId) ?? [];
+    for (const c of children) {
+        if (c.kind !== 'acceptance')
+            continue;
+        for (const l of sq.getLinksBySpec?.(c.id) ?? [])
+            states.push(l.state);
+    }
+    return states;
+}
+/**
+ * Find the requirement spec id for a published spec file. Frontmatter carries
+ * the JIRA key but not the SpecShip requirement id (the requirement id is
+ * derivable from the H1 markers). We look up the requirement whose sourcePath
+ * matches the published spec's file — the same "one requirement per published
+ * file" invariant the publish path relies on.
+ */
+function requirementIdForPublished(sq, pub) {
+    const all = sq.getAllSpecs?.() ?? [];
+    for (const s of all) {
+        if (s.kind !== 'requirement')
+            continue;
+        if (s.sourcePath === pub.specRelPath || s.sourcePath === pub.absPath) {
+            return s.id;
+        }
+    }
+    return null;
+}
+/**
+ * Build the sprint coverage report (REQ-JIRATEAM-004.A1/A2). Every issue in
+ * the sprint scope appears — including unspecced ones — with exactly one
+ * rolled-up state, and the rollup counts close the report. Read-only: no
+ * write to JIRA happens here (A4 is enforced by the caller).
+ */
+async function buildCoverageReport(deps) {
+    const listed = await deps.client.listSprintIssues({
+        project: deps.project,
+        sprint: deps.sprint,
+    });
+    const published = (0, published_specs_1.enumeratePublishedSpecs)(deps.projectRoot);
+    const byKey = new Map();
+    for (const p of published)
+        byKey.set(p.issueKey, p);
+    const rows = listed.issues.map((issue) => {
+        const pub = byKey.get(issue.key);
+        if (!pub) {
+            return {
+                issueKey: issue.key,
+                title: issue.summary,
+                jiraStatus: issue.status,
+                state: 'unspecced',
+            };
+        }
+        const reqId = requirementIdForPublished(deps.specQueries, pub);
+        const states = reqId ? collectLinkStates(deps.specQueries, reqId) : [];
+        return {
+            issueKey: issue.key,
+            title: pub.title || issue.summary,
+            jiraStatus: issue.status,
+            specRelPath: pub.specRelPath,
+            state: rollupCoverageState(states),
+        };
+    });
+    const rollup = {
+        total: rows.length,
+        unspecced: 0,
+        specced: 0,
+        implemented: 0,
+        verified: 0,
+        drifted: 0,
+        broken: 0,
+    };
+    for (const r of rows)
+        rollup[r.state]++;
+    return {
+        sprintLabel: deps.sprint ? deps.sprint : 'active sprint',
+        rows,
+        rollup,
+    };
+}
+/** Watermark for the single edit-in-place coverage comment (A3). */
+exports.COVERAGE_COMMENT_WATERMARK = '<!-- specship:coverage v1 -->';
+/** Escape a value so it can't break the markdown table layout. */
+function cell(s) {
+    return String(s ?? '').replace(/\r?\n/g, ' ').replace(/\|/g, '\\|').trim();
+}
+/**
+ * Render the report as markdown (REQ-JIRATEAM-004.A1). Prefixed with the
+ * coverage watermark so `upsertWatermarkedComment` can find and edit it in
+ * place on re-post.
+ */
+function formatCoverageMarkdown(report) {
+    const header = [
+        exports.COVERAGE_COMMENT_WATERMARK,
+        `# Sprint coverage — ${report.sprintLabel}`,
+        '',
+    ];
+    if (report.rows.length === 0) {
+        return [
+            ...header,
+            '_No issues in this sprint scope._',
+        ].join('\n');
+    }
+    const table = [
+        '| Key | Title | JIRA | State | Spec |',
+        '| --- | --- | --- | --- | --- |',
+        ...report.rows.map((r) => `| ${cell(r.issueKey)} | ${cell(r.title)} | ${cell(r.jiraStatus)} | ${cell(r.state)} | ${cell(r.specRelPath ?? '—')} |`),
+    ].join('\n');
+    const roll = report.rollup;
+    const rollupLine = `**Rollup:** ${roll.total} total · ${roll.verified} verified · ${roll.implemented} implemented · ` +
+        `${roll.specced} specced · ${roll.unspecced} unspecced · ${roll.drifted} drifted · ${roll.broken} broken`;
+    return [...header, table, '', rollupLine].join('\n');
+}
+//# sourceMappingURL=coverage.js.map

package/lib/dist/jira/coverage.js.map

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

package/lib/dist/jira/index.d.ts

@@ -3,6 +3,7 @@
  */
 export * from './types';
 export * from './config';
+export * from './repo-config';
 export * from './auth';
 export * from './client';
 //# sourceMappingURL=index.d.ts.map

package/lib/dist/jira/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jira/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jira/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/lib/dist/jira/index.js

@@ -19,6 +19,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types"), exports);
 __exportStar(require("./config"), exports);
+__exportStar(require("./repo-config"), exports);
 __exportStar(require("./auth"), exports);
 __exportStar(require("./client"), exports);
 //# sourceMappingURL=index.js.map

package/lib/dist/jira/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jira/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jira/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,2CAAyB;AACzB,gDAA8B;AAC9B,yCAAuB;AACvB,2CAAyB"}

package/lib/dist/jira/milestone-comment.d.ts

@@ -0,0 +1,95 @@
+/** The closed set of milestones (A4 — nothing else earns a comment). */
+export type MilestoneKind = 'spec_published' | 'plan_approved' | 'pr_raised' | 'criterion_verified' | 'drift_transition' | 'release_stamped' | 'pack_run_summary';
+/** Repo-side evidence for a milestone. Fields are kind-specific. */
+export interface MilestoneEvidence {
+    /** Requirement id (e.g. REQ-FOO-001) — always present (A2). */
+    specId: string;
+    /** PR URL for `pr_raised`. */
+    prUrl?: string;
+    /** Verified acceptance criterion id(s) for `criterion_verified`. */
+    criterionIds?: string[];
+    /** Released version for `release_stamped`. */
+    version?: string;
+    /** Prior/next drift state for `drift_transition`. */
+    driftFrom?: string;
+    driftTo?: string;
+    /** Symbol / axis for `drift_transition`. */
+    driftSymbol?: string;
+    driftAxis?: string;
+    /**
+     * Pack-run summary evidence (REQ-JIRAREG-005.A4). One comment per pack
+     * epic, edited in place on the next run — the marker keys on the epic +
+     * kind so the runId (which changes every run) is carried in the body and
+     * doesn't spawn a new comment.
+     */
+    packRun?: PackRunEvidence;
+}
+/** Pack-run summary counts + timing (REQ-JIRAREG-005.A4). */
+export interface PackRunEvidence {
+    runId: string;
+    executed: number;
+    passed: number;
+    failed: number;
+    unexecuted: number;
+    obsolete: number;
+    startedAt?: string;
+    finishedAt?: string;
+    /** Criterion ids whose case failed and need triage. */
+    triageCriterionIds?: string[];
+}
+/** Structural slice — same shape as publish.ts's watermarked client. */
+export interface MilestoneJiraClient {
+    listCommentsDetailed(key: string): Promise<Array<{
+        id: string;
+        body: string;
+    }>>;
+    addComment(key: string, body: string): Promise<{
+        id: string;
+    } | void>;
+    updateComment(key: string, commentId: string, body: string): Promise<void>;
+}
+export interface PostMilestoneOptions {
+    /** Where to write soft-fail notes. Default: `<projectRoot>/.specship/jira-notes.log`. */
+    localNoteSink?: (note: string) => void;
+    /** Project root used to derive the default note sink. */
+    projectRoot?: string;
+    /** Override the watermark version tag (defaults to reading package.json). */
+    specshipVersion?: string;
+}
+export interface PostMilestoneResult {
+    status: 'created' | 'updated' | 'skipped' | 'soft_failed';
+    commentId?: string;
+    /** When soft_failed, the reason string that went to the note sink. */
+    reason?: string;
+}
+/**
+ * Stable marker line placed at the TOP of every milestone comment.
+ * Key: kind + specId (+ criterion id for `criterion_verified`, +
+ * version for `release_stamped`, + from/to/symbol for `drift_transition`).
+ * The listComments scan finds a prior comment by this exact prefix.
+ */
+export declare function milestoneMarker(kind: MilestoneKind, ev: MilestoneEvidence): string;
+/**
+ * Render the pack-run summary table (REQ-JIRAREG-005.A4). Deterministic
+ * ordering + a stable one-column-per-count shape so the diff between two
+ * runs is small.
+ */
+export declare function renderPackRunSummary(ev: PackRunEvidence): string;
+/**
+ * A2: reject a URL that carries credentials, resolves to a private/local
+ * host, or uses a non-http(s) scheme. Any https host (github.com, GHE,
+ * GitLab, self-hosted) is acceptable evidence — enterprises don't run
+ * public GitHub.
+ */
+export declare function isPublicEvidenceUrl(url: string): boolean;
+/**
+ * Render the human-readable milestone body. Callers never construct this
+ * directly — everything flows through `postMilestoneComment` so the
+ * watermark, marker, sanitization, and URL check apply uniformly.
+ */
+export declare function renderMilestoneBody(kind: MilestoneKind, ev: MilestoneEvidence, version: string): string;
+/**
+ * Post (or upsert) a milestone comment. See file header for the invariants.
+ */
+export declare function postMilestoneComment(client: MilestoneJiraClient, issueKey: string, kind: MilestoneKind, evidence: MilestoneEvidence, opts?: PostMilestoneOptions): Promise<PostMilestoneResult>;
+//# sourceMappingURL=milestone-comment.d.ts.map

package/lib/dist/jira/milestone-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-comment.d.ts","sourceRoot":"","sources":["../../src/jira/milestone-comment.ts"],"names":[],"mappings":"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"}