@specship/specship-win32-arm64 0.21.2 → 0.23.0

package/lib/dist/installer/targets/registry.d.ts

@@ -1,8 +1,11 @@
 /**
  * Registry of supported agent targets.
  *
- * Currently Claude-only. The interface is preserved so re-adding another
- * agent is one new file in `targets/` plus one entry below.
+ * Claude Code plus the one ratified exception, Gemini CLI (GEMINI-TARGET-DOC).
+ * Registration does NOT make a target install by default — `specship install`
+ * writes Claude alone unless `--target` names another (REQ-GEMINI-002.A4).
+ * Being here means the target participates in the contract suite, in
+ * `detectAll`, and in the uninstall sweep.
  */
 import { AgentTarget, Location, TargetId } from './types';
 export declare const ALL_TARGETS: readonly AgentTarget[];

package/lib/dist/installer/targets/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG1D,eAAO,MAAM,WAAW,EAAE,SAAS,WAAW,EAAkC,CAAC;AAEjF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC9C,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC9C,CAAC,CAKD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAI1D,eAAO,MAAM,WAAW,EAAE,SAAS,WAAW,EAAgD,CAAC;AAE/F,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC9C,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC9C,CAAC,CAKD"}

package/lib/dist/installer/targets/registry.js

@@ -2,8 +2,11 @@
 /**
  * Registry of supported agent targets.
  *
- * Currently Claude-only. The interface is preserved so re-adding another
- * agent is one new file in `targets/` plus one entry below.
+ * Claude Code plus the one ratified exception, Gemini CLI (GEMINI-TARGET-DOC).
+ * Registration does NOT make a target install by default — `specship install`
+ * writes Claude alone unless `--target` names another (REQ-GEMINI-002.A4).
+ * Being here means the target participates in the contract suite, in
+ * `detectAll`, and in the uninstall sweep.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ALL_TARGETS = void 0;
@@ -11,7 +14,8 @@ exports.getTarget = getTarget;
 exports.listTargetIds = listTargetIds;
 exports.detectAll = detectAll;
 const claude_1 = require("./claude");
-exports.ALL_TARGETS = Object.freeze([claude_1.claudeTarget]);
+const gemini_1 = require("./gemini");
+exports.ALL_TARGETS = Object.freeze([claude_1.claudeTarget, gemini_1.geminiTarget]);
 function getTarget(id) {
     return exports.ALL_TARGETS.find((t) => t.id === id);
 }

package/lib/dist/installer/targets/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/installer/targets/registry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAOH,8BAEC;AAED,sCAEC;AAMD,8BAQC;AAxBD,qCAAwC;AAE3B,QAAA,WAAW,GAA2B,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAY,CAAC,CAAC,CAAC;AAEjF,SAAgB,SAAS,CAAC,EAAU;IAClC,OAAO,mBAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,aAAa;IAC3B,OAAO,mBAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,GAAa;IAIrC,OAAO,mBAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/installer/targets/registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAQH,8BAEC;AAED,sCAEC;AAMD,8BAQC;AAzBD,qCAAwC;AACxC,qCAAwC;AAE3B,QAAA,WAAW,GAA2B,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAY,EAAE,qBAAY,CAAC,CAAC,CAAC;AAE/F,SAAgB,SAAS,CAAC,EAAU;IAClC,OAAO,mBAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,aAAa;IAC3B,OAAO,mBAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,GAAa;IAIrC,OAAO,mBAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/dist/installer/targets/types.d.ts

@@ -8,8 +8,12 @@
  * + one registry entry. See `targets/registry.ts`.
  */
 export type Location = 'global' | 'local';
-/** Stable string id for the lone supported target. */
-export type TargetId = 'claude';
+/**
+ * Stable string ids for supported targets. `gemini` (GEMINI-TARGET-DOC) is
+ * declared here from Phase 0 on, but only its `printConfig` is implemented
+ * and it is not in `ALL_TARGETS` yet — see `targets/gemini.ts`.
+ */
+export type TargetId = 'claude' | 'gemini';
 /**
  * Result of `target.detect(location)`.
  *

package/lib/dist/installer/targets/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1C,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;KAChF,CAAC,CAAC;IACH,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;IAC1D;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,oEAAoE;IACpE,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAAC;CACxC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1C;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;KAChF,CAAC,CAAC;IACH,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;IAC1D;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,oEAAoE;IACpE,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAAC;CACxC"}

package/lib/dist/jira/auto-publish.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Auto-publish specs to JIRA on sync (REQ-JIRATEAM-002).
+ *
+ * With a repo-committed JIRA project binding in `specship.config.json`
+ * (REQ-JIRATEAM-001), every cleanly-indexed requirement spec is
+ * published/refreshed to JIRA during `sync` — reusing the existing
+ * idempotent `publishSpecToJira` primitive so the fingerprint short-circuits
+ * unchanged specs, missing Sub-tasks are added, and `writeBackJiraIdentity`
+ * stamps the `jira_issue:` back into the file.
+ *
+ * A5 gate: with NO binding, this returns immediately without constructing a
+ * JIRA client or reading credentials — zero JIRA calls. Even with a binding,
+ * a repo whose user has no credentials configured degrades to a single
+ * per-sync note (never crashes, never blocks sync). Per-spec publish failures
+ * are collected as `failed` results; siblings still publish.
+ */
+import { resolveJiraCredentials } from './config';
+import { type PublishJiraClient } from './publish';
+export type AutoPublishStatus = 'published' | 'unchanged' | 'opted_out' | 'failed';
+export interface AutoPublishResultRow {
+    specId: string;
+    status: AutoPublishStatus;
+    jiraKey?: string;
+    subtasksCreated?: number;
+    note?: string;
+}
+export interface AutoPublishReport {
+    /**
+     * Present when the pass short-circuited before touching JIRA:
+     *   - 'unbound'         → no repo binding (A5)
+     *   - 'no-credentials'  → binding present but user credentials missing (A4-like)
+     */
+    skipped?: 'unbound' | 'no-credentials';
+    /** Human-readable note when `skipped` is set (surfaced by the caller). */
+    note?: string;
+    results: AutoPublishResultRow[];
+}
+/** The structural slice of SpecQueries this pass reads. */
+export interface AutoPublishSpecQueries {
+    getAllSpecs(): Array<{
+        id: string;
+        kind: string;
+        title: string;
+        body: string;
+        sourcePath: string;
+    }>;
+    getSpecsByParent(id: string): Array<{
+        id: string;
+        kind: string;
+        title: string;
+        body: string;
+    }>;
+}
+export interface AutoPublishDeps {
+    specQueries: AutoPublishSpecQueries;
+    projectRoot: string;
+    /** Test seam: build a JIRA client from resolved creds. Default: JiraClient. */
+    makeClient?: (creds: ReturnType<typeof resolveJiraCredentials>) => PublishJiraClient;
+}
+/**
+ * Publish/refresh every requirement spec to JIRA when a repo binding is
+ * present. Never throws — every failure lands in the returned report.
+ */
+export declare function autoPublishSpecsOnSync(deps: AutoPublishDeps): Promise<AutoPublishReport>;
+/** One-line summary suitable for CLI output. */
+export declare function summarizeAutoPublishReport(report: AutoPublishReport): string;
+//# sourceMappingURL=auto-publish.d.ts.map

package/lib/dist/jira/auto-publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-publish.d.ts","sourceRoot":"","sources":["../../src/jira/auto-publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGlD,OAAO,EAOL,KAAK,iBAAiB,EAEvB,MAAM,WAAW,CAAC;AAKnB,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACvC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,WAAW,IAAI,KAAK,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC;QAClC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,sBAAsB,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,KAAK,iBAAiB,CAAC;CACtF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,CA4K5B;AA8BD,gDAAgD;AAChD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAmB5E"}

package/lib/dist/jira/auto-publish.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * Auto-publish specs to JIRA on sync (REQ-JIRATEAM-002).
+ *
+ * With a repo-committed JIRA project binding in `specship.config.json`
+ * (REQ-JIRATEAM-001), every cleanly-indexed requirement spec is
+ * published/refreshed to JIRA during `sync` — reusing the existing
+ * idempotent `publishSpecToJira` primitive so the fingerprint short-circuits
+ * unchanged specs, missing Sub-tasks are added, and `writeBackJiraIdentity`
+ * stamps the `jira_issue:` back into the file.
+ *
+ * A5 gate: with NO binding, this returns immediately without constructing a
+ * JIRA client or reading credentials — zero JIRA calls. Even with a binding,
+ * a repo whose user has no credentials configured degrades to a single
+ * per-sync note (never crashes, never blocks sync). Per-spec publish failures
+ * are collected as `failed` results; siblings still publish.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autoPublishSpecsOnSync = autoPublishSpecsOnSync;
+exports.summarizeAutoPublishReport = summarizeAutoPublishReport;
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const repo_config_1 = require("./repo-config");
+const client_1 = require("./client");
+const publish_1 = require("./publish");
+const spec_writer_1 = require("./spec-writer");
+const milestone_comment_1 = require("./milestone-comment");
+const fs = __importStar(require("fs"));
+/**
+ * Publish/refresh every requirement spec to JIRA when a repo binding is
+ * present. Never throws — every failure lands in the returned report.
+ */
+async function autoPublishSpecsOnSync(deps) {
+    // A5: no repo binding → do NOTHING. No client construction, no credential
+    // read, no JIRA call.
+    const binding = (0, repo_config_1.loadRepoJiraBinding)(deps.projectRoot);
+    if (!binding.binding) {
+        return { skipped: 'unbound', results: [] };
+    }
+    // Bound repo without user credentials: one per-sync note, never a crash.
+    let creds;
+    try {
+        creds = (0, config_1.resolveJiraCredentials)(deps.projectRoot);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            skipped: 'no-credentials',
+            note: msg,
+            results: [],
+        };
+    }
+    const projectKey = creds.project;
+    if (!projectKey) {
+        return {
+            skipped: 'no-credentials',
+            note: 'No JIRA project resolved from binding or user config.',
+            results: [],
+        };
+    }
+    const client = deps.makeClient
+        ? deps.makeClient(creds)
+        : new client_1.JiraClient(creds);
+    const results = [];
+    const requirements = deps.specQueries.getAllSpecs().filter((s) => s.kind === 'requirement');
+    // Requirements per file (REQ-JIRATEAM-010): a file holding >1 requirement
+    // keys each one's JIRA identity per-requirement — the plain file-level
+    // `jira_issue:` is only trusted when the file has exactly one.
+    const reqsPerFile = new Map();
+    for (const s of requirements) {
+        reqsPerFile.set(s.sourcePath, (reqsPerFile.get(s.sourcePath) ?? 0) + 1);
+    }
+    for (const spec of requirements) {
+        const absPath = path.isAbsolute(spec.sourcePath)
+            ? spec.sourcePath
+            : path.join(deps.projectRoot, spec.sourcePath);
+        // Per-spec frontmatter opt-out (A3). Note: readFrontmatterValue reads
+        // the file's leading frontmatter block only — a `jira_publish:` mention
+        // in the body cannot opt a spec out.
+        let fileContent;
+        try {
+            fileContent = fs.readFileSync(absPath, 'utf8');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            results.push({ specId: spec.id, status: 'failed', note: msg });
+            continue;
+        }
+        const optOut = (0, publish_1.readFrontmatterValue)(fileContent, 'jira_publish');
+        if (optOut !== null && optOut.toLowerCase() === 'false') {
+            results.push({ specId: spec.id, status: 'opted_out' });
+            continue;
+        }
+        const acceptance = deps.specQueries
+            .getSpecsByParent(spec.id)
+            .filter((c) => c.kind === 'acceptance')
+            .map((c) => ({ id: c.id, text: (c.title || c.body || '').trim() }))
+            .filter((c) => c.text.length > 0);
+        const source = {
+            specId: spec.id,
+            title: spec.title,
+            body: spec.body ?? '',
+            specRelPath: spec.sourcePath,
+            acceptance,
+        };
+        // REQ-JIRATEAM-010.A4: never resolve another requirement's issue. The
+        // per-requirement key wins; the plain file-level key applies only when
+        // this requirement is the file's sole one.
+        const soleRequirement = (reqsPerFile.get(spec.sourcePath) ?? 1) === 1;
+        const perKeys = (0, publish_1.perSpecFrontmatterKeys)(spec.id);
+        const existingKey = (0, publish_1.readFrontmatterValue)(fileContent, perKeys.issueKey) ??
+            (soleRequirement ? (0, spec_writer_1.readSpecJiraKey)(absPath) : null);
+        // REQ-JIRATEAM-006: resolve the epic anchor — frontmatter first, then
+        // the binding default. `requireEpic` is off here so a bound repo whose
+        // spec pre-dates board-first intake doesn't hard-fail on every sync;
+        // the intake gate is what fences new specs. A refresh with no epic and
+        // no live parent still publishes unchanged Story text.
+        const specEpicKey = (0, publish_1.readFrontmatterValue)(fileContent, 'epicKey') ??
+            binding.binding.epicKey ??
+            undefined;
+        // Fingerprint short-circuit (A1): an already-published spec whose
+        // rendered Story fields match the last-published fingerprint performs
+        // ZERO JIRA writes — no updateIssue, no getIssue, no Sub-task probe.
+        if (existingKey) {
+            const priorFp = (0, publish_1.readFrontmatterValue)(fileContent, perKeys.fingerprintKey) ??
+                (soleRequirement
+                    ? (0, publish_1.readFrontmatterValue)(fileContent, 'jira_fingerprint')
+                    : null);
+            if (priorFp) {
+                const fields = (0, publish_1.buildIssueFields)(source);
+                const nextFp = (0, publish_1.issueContentFingerprint)(fields.summary, fields.description);
+                if (priorFp === nextFp) {
+                    results.push({
+                        specId: spec.id,
+                        status: 'unchanged',
+                        jiraKey: existingKey,
+                        subtasksCreated: 0,
+                    });
+                    continue;
+                }
+            }
+        }
+        try {
+            const result = await (0, publish_1.publishSpecToJira)(client, source, {
+                projectKey,
+                // REQ-JIRATEAM-009: honor the binding's issue-type overrides — a
+                // team-managed project without a `Story` type publishes as `Task`.
+                ...(0, repo_config_1.bindingIssueTypes)(deps.projectRoot),
+                ...(specEpicKey ? { epicKey: specEpicKey } : {}),
+            }, existingKey);
+            // Frontmatter write-back stamps jira_issue: and the fingerprint. Never
+            // re-id or rename here — auto-publish runs on every sync and must be
+            // safe on files that already carry links or share a file with siblings.
+            (0, publish_1.writeBackJiraIdentity)(absPath, result.key, {
+                fingerprint: result.fingerprint,
+                reId: null,
+                renameTo: null,
+                ...(result.epicKey ? { epicKey: result.epicKey } : {}),
+                // REQ-JIRATEAM-010.A2: per-requirement keys in multi-REQ files.
+                ...(soleRequirement ? {} : { forSpecId: spec.id }),
+            });
+            const status = result.created || result.subtasksCreated > 0 ? 'published' : 'unchanged';
+            results.push({
+                specId: spec.id,
+                status,
+                jiraKey: result.key,
+                subtasksCreated: result.subtasksCreated,
+            });
+            // Milestone: spec_published (REQ-JIRATEAM-003.A1). Idempotent — the
+            // dispatcher itself skips when the marker already exists, so calling
+            // it on every publish (including refresh) is safe. Soft-fail so a
+            // milestone comment issue never breaks auto-publish (A3).
+            if (status === 'published') {
+                await postMilestoneOnSuccess(client, result.key, spec.id, deps.projectRoot);
+            }
+        }
+        catch (err) {
+            // A4: one spec's failure never blocks the sync or its siblings.
+            const msg = err instanceof Error ? err.message : String(err);
+            results.push({ specId: spec.id, status: 'failed', note: msg });
+        }
+    }
+    return { results };
+}
+/**
+ * Best-effort spec_published milestone comment. A fake `PublishJiraClient`
+ * (some tests) doesn't implement the milestone methods — probe first and
+ * silently skip when they're missing, so test seams stay narrow.
+ */
+async function postMilestoneOnSuccess(client, issueKey, specId, projectRoot) {
+    const maybe = client;
+    if (typeof maybe.listCommentsDetailed !== 'function' ||
+        typeof maybe.addComment !== 'function' ||
+        typeof maybe.updateComment !== 'function') {
+        return;
+    }
+    await (0, milestone_comment_1.postMilestoneComment)(maybe, issueKey, 'spec_published', { specId }, { projectRoot });
+}
+/** One-line summary suitable for CLI output. */
+function summarizeAutoPublishReport(report) {
+    if (report.skipped === 'unbound')
+        return '';
+    if (report.skipped === 'no-credentials') {
+        return `JIRA auto-publish skipped: ${report.note ?? 'no credentials'}`;
+    }
+    let published = 0;
+    let unchanged = 0;
+    let optedOut = 0;
+    let failed = 0;
+    for (const r of report.results) {
+        if (r.status === 'published')
+            published++;
+        else if (r.status === 'unchanged')
+            unchanged++;
+        else if (r.status === 'opted_out')
+            optedOut++;
+        else if (r.status === 'failed')
+            failed++;
+    }
+    return (`JIRA auto-publish: ${published} published, ${unchanged} unchanged, ` +
+        `${optedOut} opted out, ${failed} failed`);
+}
+//# sourceMappingURL=auto-publish.js.map

package/lib/dist/jira/auto-publish.js.map

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

package/lib/dist/jira/board-first.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Board-first anchor resolution (REQ-JIRATEAM-007).
+ *
+ * Every work-creating flow on a JIRA-bound repo MUST be anchored to a JIRA
+ * issue. This module answers ONE question for the CLI, MCP tool, and slash
+ * command that gate work: "given cwd + optional explicit/picked issueKey,
+ * do we have an anchor, refuse, or should we no-op (unbound)?"
+ *
+ * The return is a THREE-way discriminated union — `unbound` is first-class
+ * so callers on an unbound repo just proceed unchanged.
+ *
+ * When a bound repo refuses because no issue was picked, we ALSO surface the
+ * epic-scoped pickable work in the refusal payload so the pick can happen in
+ * the same round-trip (spec correction: A1 requires the refusal to LIST the
+ * pickable work, not just hint at it).
+ */
+import type { JiraIssue } from './types';
+export type WorkAnchor = {
+    issueKey: string;
+    summary: string;
+    source: 'explicit' | 'picked' | 'epic-child';
+};
+export type AnchorUnbound = {
+    status: 'unbound';
+};
+export type AnchorAnchored = {
+    status: 'anchored';
+    anchor: WorkAnchor;
+};
+export type AnchorRefused = {
+    status: 'refused';
+    reason: 'no-pick' | 'no-epic-no-pick';
+    fixHint: string;
+    /** Epic-scoped open stories/tasks — populated on `no-pick` so the caller can
+     *  render the picker in the same turn (A1). */
+    pickable?: JiraIssue[];
+};
+export type AnchorResolution = AnchorUnbound | AnchorAnchored | AnchorRefused;
+/** Minimal client seam so tests inject a fake and never touch a real host. */
+export interface AnchorJiraClient {
+    listMyIssues(opts?: {
+        project?: string;
+        sprint?: 'active';
+        epicKey?: string;
+    }): Promise<{
+        ok: true;
+        issues: JiraIssue[];
+    }>;
+    getIssue(key: string): Promise<{
+        ok: true;
+        issue: JiraIssue;
+    }>;
+}
+export interface ResolveWorkAnchorOptions {
+    cwd: string;
+    explicitIssueKey?: string;
+    pickedIssueKey?: string;
+    /** Test seam. Default: resolve credentials + new JiraClient. */
+    makeClient?: () => AnchorJiraClient;
+}
+export declare function resolveWorkAnchor(opts: ResolveWorkAnchorOptions): Promise<AnchorResolution>;
+/** Canonical human-facing refusal message for CLI/MCP callers. */
+export declare function formatRefusal(res: AnchorRefused): string;
+//# sourceMappingURL=board-first.d.ts.map

package/lib/dist/jira/board-first.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-first.d.ts","sourceRoot":"","sources":["../../src/jira/board-first.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAClD,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB;mDAC+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,cAAc,GAAG,aAAa,CAAC;AAE9E,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,IAAI,CAAC,EAAE;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,gBAAgB,CAAC;CACrC;AAOD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAoD3B;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAaxD"}

package/lib/dist/jira/board-first.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Board-first anchor resolution (REQ-JIRATEAM-007).
+ *
+ * Every work-creating flow on a JIRA-bound repo MUST be anchored to a JIRA
+ * issue. This module answers ONE question for the CLI, MCP tool, and slash
+ * command that gate work: "given cwd + optional explicit/picked issueKey,
+ * do we have an anchor, refuse, or should we no-op (unbound)?"
+ *
+ * The return is a THREE-way discriminated union — `unbound` is first-class
+ * so callers on an unbound repo just proceed unchanged.
+ *
+ * When a bound repo refuses because no issue was picked, we ALSO surface the
+ * epic-scoped pickable work in the refusal payload so the pick can happen in
+ * the same round-trip (spec correction: A1 requires the refusal to LIST the
+ * pickable work, not just hint at it).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWorkAnchor = resolveWorkAnchor;
+exports.formatRefusal = formatRefusal;
+const repo_config_1 = require("./repo-config");
+const config_1 = require("./config");
+const client_1 = require("./client");
+function defaultMakeClient() {
+    const creds = (0, config_1.resolveJiraCredentials)();
+    return new client_1.JiraClient(creds);
+}
+async function resolveWorkAnchor(opts) {
+    const { binding } = (0, repo_config_1.loadRepoJiraBinding)(opts.cwd);
+    if (!binding)
+        return { status: 'unbound' };
+    const makeClient = opts.makeClient ?? defaultMakeClient;
+    const explicit = opts.explicitIssueKey?.trim();
+    const picked = opts.pickedIssueKey?.trim();
+    const key = explicit || picked;
+    if (key) {
+        const client = makeClient();
+        const res = await client.getIssue(key);
+        return {
+            status: 'anchored',
+            anchor: {
+                issueKey: res.issue.key,
+                summary: res.issue.summary,
+                source: explicit ? 'explicit' : 'picked',
+            },
+        };
+    }
+    if (!binding.epicKey) {
+        return {
+            status: 'refused',
+            reason: 'no-epic-no-pick',
+            fixHint: 'Set jira.epicKey in specship.config.json (or pick an issue with specship_jira_pick <KEY>).',
+        };
+    }
+    // Bound + epic + no pick → list the epic's open stories/tasks so the caller
+    // can render the pick in the same round-trip (A1).
+    let pickable = [];
+    try {
+        const client = makeClient();
+        const res = await client.listMyIssues({
+            project: binding.projectKey,
+            epicKey: binding.epicKey,
+        });
+        pickable = res.issues;
+    }
+    catch {
+        // Degrade to a refusal without pickable list — the fixHint still names
+        // the exact next step.
+    }
+    return {
+        status: 'refused',
+        reason: 'no-pick',
+        fixHint: 'Run specship_jira_issues to list the epic\'s open work, then specship_jira_pick <KEY> to anchor this run.',
+        pickable,
+    };
+}
+/** Canonical human-facing refusal message for CLI/MCP callers. */
+function formatRefusal(res) {
+    const header = res.reason === 'no-epic-no-pick'
+        ? 'Work refused: no JIRA anchor — no epic bound and no issue picked.'
+        : 'Work refused: no JIRA anchor — pick an issue under the bound epic.';
+    const lines = [header, res.fixHint];
+    if (res.pickable && res.pickable.length) {
+        lines.push('', 'Pickable issues:');
+        for (const i of res.pickable) {
+            lines.push(`- ${i.key} — ${i.summary} [${i.status}]`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=board-first.js.map

package/lib/dist/jira/board-first.js.map

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