@specship/specship-win32-arm64 0.21.2 → 0.22.0

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

@@ -0,0 +1,81 @@
+/**
+ * JIRA-side edit reconciliation (REQ-JIRATEAM-005).
+ *
+ * Pure diff: given a live JIRA issue, its published fingerprint (stored in the
+ * spec's frontmatter), and the parsed spec, report divergences without any I/O
+ * so the module is testable without MCP/JIRA plumbing. Two flavors:
+ *   - content divergence: the issue's summary/description was edited in JIRA
+ *     after publish (fingerprint mismatch);
+ *   - subtask divergence: a Sub-task was added in JIRA that has no matching
+ *     acceptance criterion — reported with a proposed `.A<N+1>` id and text
+ *     derived from the Sub-task summary.
+ *
+ * Sub-task matching reuses `subtaskSummary()` from `./publish` so the
+ * comparison uses the EXACT same one-line truncation the publisher wrote
+ * with — a Sub-task that publish wrote is never re-proposed on the way back.
+ */
+import type { JiraIssue } from './types';
+export interface SubtaskDivergence {
+    subtaskKey: string;
+    subtaskSummary: string;
+    /** Proposed `.A<N>` id (the next available under the requirement). */
+    proposedCriterionId: string;
+    /** Proposed criterion text derived from the Sub-task summary. */
+    proposedCriterionText: string;
+}
+export interface ContentDivergence {
+    issueKey: string;
+    liveSummary: string;
+    liveDescription: string;
+    storedFingerprint: string;
+    liveFingerprint: string;
+}
+export interface ReconcileReport {
+    specRelPath: string;
+    issueKey: string;
+    /** The requirement's spec id (e.g. `REQ-AUTH-001`) the divergences belong to. */
+    requirementId: string;
+    content?: ContentDivergence;
+    subtasks: SubtaskDivergence[];
+}
+/**
+ * True when the report has any divergence to show. A clean report (no content
+ * mismatch, no orphan Sub-task) is not surfaced to the user.
+ */
+export declare function reportHasDivergence(report: ReconcileReport): boolean;
+/**
+ * The next `.A<N>` id after the largest existing suffix under `requirementId`.
+ * Tolerates gaps and out-of-order ids: `[.A1, .A3]` yields `.A4`; empty → `.A1`.
+ * Non-`.A<N>` ids and ids under other requirements are ignored.
+ */
+export declare function nextAcceptanceId(requirementId: string, existingIds: readonly string[]): string;
+/**
+ * Turn a Sub-task summary into acceptance-criterion body text — one line,
+ * trailing punctuation kept, no truncation (unlike the publish-side summary,
+ * which caps at 240 for the JIRA field limit).
+ */
+export declare function proposeCriterionFromSubtask(summary: string): string;
+/**
+ * Data a caller supplies about a published spec — enough to diff. `title` and
+ * `body` are what publish would send today (kept in-memory by the caller so
+ * this module doesn't have to parse the spec file itself).
+ */
+export interface SpecViewForDiff {
+    specRelPath: string;
+    requirementId: string;
+    title: string;
+    body: string;
+    acceptance: Array<{
+        id: string;
+        text: string;
+    }>;
+}
+/**
+ * Diff a live JIRA issue against its published spec. `storedFingerprint` is the
+ * `jira_fingerprint:` recorded in the spec's frontmatter at publish time; when
+ * null, the content divergence check is skipped (we can't judge drift without
+ * a baseline). Sub-tasks whose summaries match any existing acceptance
+ * criterion under `subtaskSummary()` are considered in-sync.
+ */
+export declare function diffIssueVsSpec(issue: JiraIssue, spec: SpecViewForDiff, storedFingerprint: string | null): ReconcileReport;
+//# sourceMappingURL=reconcile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/jira/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,eAAe,EACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAC/B,eAAe,CAkDjB"}

package/lib/dist/jira/reconcile.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * JIRA-side edit reconciliation (REQ-JIRATEAM-005).
+ *
+ * Pure diff: given a live JIRA issue, its published fingerprint (stored in the
+ * spec's frontmatter), and the parsed spec, report divergences without any I/O
+ * so the module is testable without MCP/JIRA plumbing. Two flavors:
+ *   - content divergence: the issue's summary/description was edited in JIRA
+ *     after publish (fingerprint mismatch);
+ *   - subtask divergence: a Sub-task was added in JIRA that has no matching
+ *     acceptance criterion — reported with a proposed `.A<N+1>` id and text
+ *     derived from the Sub-task summary.
+ *
+ * Sub-task matching reuses `subtaskSummary()` from `./publish` so the
+ * comparison uses the EXACT same one-line truncation the publisher wrote
+ * with — a Sub-task that publish wrote is never re-proposed on the way back.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportHasDivergence = reportHasDivergence;
+exports.nextAcceptanceId = nextAcceptanceId;
+exports.proposeCriterionFromSubtask = proposeCriterionFromSubtask;
+exports.diffIssueVsSpec = diffIssueVsSpec;
+const publish_1 = require("./publish");
+/**
+ * True when the report has any divergence to show. A clean report (no content
+ * mismatch, no orphan Sub-task) is not surfaced to the user.
+ */
+function reportHasDivergence(report) {
+    return Boolean(report.content) || report.subtasks.length > 0;
+}
+/**
+ * The next `.A<N>` id after the largest existing suffix under `requirementId`.
+ * Tolerates gaps and out-of-order ids: `[.A1, .A3]` yields `.A4`; empty → `.A1`.
+ * Non-`.A<N>` ids and ids under other requirements are ignored.
+ */
+function nextAcceptanceId(requirementId, existingIds) {
+    const prefix = `${requirementId}.A`;
+    let max = 0;
+    for (const id of existingIds) {
+        if (!id.startsWith(prefix))
+            continue;
+        const n = Number(id.slice(prefix.length));
+        if (Number.isFinite(n) && n > max)
+            max = n;
+    }
+    return `${requirementId}.A${max + 1}`;
+}
+/**
+ * Turn a Sub-task summary into acceptance-criterion body text — one line,
+ * trailing punctuation kept, no truncation (unlike the publish-side summary,
+ * which caps at 240 for the JIRA field limit).
+ */
+function proposeCriterionFromSubtask(summary) {
+    return summary.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Diff a live JIRA issue against its published spec. `storedFingerprint` is the
+ * `jira_fingerprint:` recorded in the spec's frontmatter at publish time; when
+ * null, the content divergence check is skipped (we can't judge drift without
+ * a baseline). Sub-tasks whose summaries match any existing acceptance
+ * criterion under `subtaskSummary()` are considered in-sync.
+ */
+function diffIssueVsSpec(issue, spec, storedFingerprint) {
+    const report = {
+        specRelPath: spec.specRelPath,
+        issueKey: issue.key,
+        requirementId: spec.requirementId,
+        subtasks: [],
+    };
+    // Content divergence (REQ-JIRATEAM-005.A1). The publisher's fingerprint is
+    // over (summary, description); we recompute the LIVE fingerprint and compare.
+    if (storedFingerprint) {
+        const liveSummary = issue.summary ?? '';
+        const liveDescription = issue.description ?? '';
+        const liveFp = (0, publish_1.issueContentFingerprint)(liveSummary, liveDescription);
+        if (liveFp !== storedFingerprint) {
+            report.content = {
+                issueKey: issue.key,
+                liveSummary,
+                liveDescription,
+                storedFingerprint,
+                liveFingerprint: liveFp,
+            };
+        }
+    }
+    // Sub-task divergence (REQ-JIRATEAM-005.A2). Reuse subtaskSummary() so the
+    // comparison uses the EXACT same one-line truncation the publisher wrote
+    // with — a Sub-task publish itself wrote can never look "new" on the way
+    // back.
+    const knownSummaries = new Set(spec.acceptance.map((a) => (0, publish_1.subtaskSummary)(a.text)));
+    const existingIds = spec.acceptance.map((a) => a.id);
+    let nextId = nextAcceptanceId(spec.requirementId, existingIds);
+    for (const st of issue.subtasks ?? []) {
+        const summary = (0, publish_1.subtaskSummary)(st.summary ?? '');
+        if (!summary)
+            continue;
+        if (knownSummaries.has(summary))
+            continue;
+        report.subtasks.push({
+            subtaskKey: st.key,
+            subtaskSummary: st.summary,
+            proposedCriterionId: nextId,
+            proposedCriterionText: proposeCriterionFromSubtask(st.summary),
+        });
+        // Reserve the id we just proposed for the next iteration.
+        const n = Number(nextId.slice(`${spec.requirementId}.A`.length)) + 1;
+        nextId = `${spec.requirementId}.A${n}`;
+    }
+    return report;
+}
+//# sourceMappingURL=reconcile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../src/jira/reconcile.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAmCH,kDAEC;AAOD,4CAYC;AAOD,kEAEC;AAsBD,0CAsDC;AA3ID,uCAAoE;AA6BpE;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,MAAuB;IACzD,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAC9B,aAAqB,EACrB,WAA8B;IAE9B,MAAM,MAAM,GAAG,GAAG,aAAa,IAAI,CAAC;IACpC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG;YAAE,GAAG,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,aAAa,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,SAAgB,2BAA2B,CAAC,OAAe;IACzD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAeD;;;;;;GAMG;AACH,SAAgB,eAAe,CAC7B,KAAgB,EAChB,IAAqB,EACrB,iBAAgC;IAEhC,MAAM,MAAM,GAAoB;QAC9B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,KAAK,CAAC,GAAG;QACnB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,2EAA2E;IAC3E,8EAA8E;IAC9E,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QACxC,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,IAAA,iCAAuB,EAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QACrE,IAAI,MAAM,KAAK,iBAAiB,EAAE,CAAC;YACjC,MAAM,CAAC,OAAO,GAAG;gBACf,QAAQ,EAAE,KAAK,CAAC,GAAG;gBACnB,WAAW;gBACX,eAAe;gBACf,iBAAiB;gBACjB,eAAe,EAAE,MAAM;aACxB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,yEAAyE;IACzE,yEAAyE;IACzE,QAAQ;IACR,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,wBAAc,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CACnD,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrD,IAAI,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC/D,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAA,wBAAc,EAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACnB,UAAU,EAAE,EAAE,CAAC,GAAG;YAClB,cAAc,EAAE,EAAE,CAAC,OAAO;YAC1B,mBAAmB,EAAE,MAAM;YAC3B,qBAAqB,EAAE,2BAA2B,CAAC,EAAE,CAAC,OAAO,CAAC;SAC/D,CAAC,CAAC;QACH,0DAA0D;QAC1D,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}