@specship/specship-win32-arm64 0.25.0 → 0.28.0

package/lib/dist/pulse/pulse.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Pipeline pulse (PIPETRUST-DOC, REQ-PIPETRUST-007) — surface pipeline
+ * failures instead of waiting for someone to discover them.
+ *
+ * Four checks:
+ *   - release   — conclusion of the latest release workflow run (`gh`)
+ *   - npm       — published npm version vs latest GitHub release / package.json
+ *   - jira      — failures recorded by the last JIRA auto-publish
+ *   - worktrees — workflow-run worktrees whose branch is already merged
+ *
+ * Every external command goes through an injectable {@link CommandRunner}
+ * with a per-command timeout and a total time budget. A missing tool, a
+ * timeout or a network failure turns that check into `skipped` — pulse never
+ * throws and never stalls its caller. Results are cached to
+ * `.specship/pulse.json` so a session-start summary can read them without
+ * touching the network.
+ */
+export type PulseStatus = 'ok' | 'fail' | 'skipped';
+export type PulseCheckId = 'release' | 'npm' | 'jira' | 'worktrees';
+export interface PulseItem {
+    id: PulseCheckId;
+    status: PulseStatus;
+    message: string;
+    hint?: string;
+}
+export interface PulseResult {
+    /** Epoch ms when the checks ran. */
+    checkedAt: number;
+    items: PulseItem[];
+    /** True when the result was served from `.specship/pulse.json`. */
+    fromCache: boolean;
+}
+export interface CommandResult {
+    /** Exit code 0. */
+    ok: boolean;
+    stdout: string;
+    stderr?: string;
+    /** The command was killed by its timeout. */
+    timedOut?: boolean;
+    /** The executable was not found. */
+    missing?: boolean;
+}
+export type CommandRunner = (cmd: string, args: string[], opts: {
+    cwd: string;
+    timeoutMs: number;
+}) => Promise<CommandResult>;
+export interface PulseOptions {
+    projectRoot: string;
+    /** Command runner seam (tests inject a fake; default spawns the real tool). */
+    runner?: CommandRunner;
+    /** Clock seam (epoch ms). */
+    now?: () => number;
+    /** Serve the cache when it is younger than this. Default: always recompute. */
+    maxAgeMs?: number;
+    /** Ignore the cache and recompute. */
+    refresh?: boolean;
+    /** Hard per-command timeout (ms). Default 3000. */
+    commandTimeoutMs?: number;
+    /** Total time budget for all commands (ms). Default 5000. */
+    totalBudgetMs?: number;
+    /** Persist the computed result to `.specship/pulse.json`. Default true. */
+    writeCache?: boolean;
+    /**
+     * Resolve a run worktree's path to its full workflow run id (for the purge
+     * hint). Default: the short run id parsed from the branch/dir name.
+     */
+    runIdForWorktree?: (workingPath: string, branch: string) => string | undefined;
+}
+export declare function pulseCachePath(projectRoot: string): string;
+/** Read the cached pulse without running anything. Null when absent/corrupt. */
+export declare function readCachedPulse(projectRoot: string): PulseResult | null;
+/** Default runner: execFile with a hard timeout; never rejects. */
+export declare const defaultCommandRunner: CommandRunner;
+/** Compare dotted versions numerically (pre-release suffixes ignored). */
+export declare function compareVersions(a: string, b: string): number;
+interface WorktreeEntry {
+    path: string;
+    branch?: string;
+    prunable?: boolean;
+}
+export declare function parseWorktreePorcelain(out: string): WorktreeEntry[];
+/**
+ * Compute (or serve from cache) the pipeline pulse. Never throws: every
+ * check that cannot run cleanly degrades to `skipped`.
+ */
+export declare function computePulse(opts: PulseOptions): Promise<PulseResult>;
+/**
+ * One human line per failing item; an empty array when everything is
+ * healthy or skipped (so a session-start summary stays silent).
+ */
+export declare function formatPulseLines(items: PulseItem[]): string[];
+export {};
+//# sourceMappingURL=pulse.d.ts.map

package/lib/dist/pulse/pulse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.d.ts","sourceRoot":"","sources":["../../src/pulse/pulse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KACrC,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAChF;AAMD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAIvE;AAED,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,EAAE,aAiC/B,CAAC;AAiDL,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5D;AAuHD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAenE;AA6DD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAyC3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAI7D"}

package/lib/dist/pulse/pulse.js

@@ -0,0 +1,401 @@
+"use strict";
+/**
+ * Pipeline pulse (PIPETRUST-DOC, REQ-PIPETRUST-007) — surface pipeline
+ * failures instead of waiting for someone to discover them.
+ *
+ * Four checks:
+ *   - release   — conclusion of the latest release workflow run (`gh`)
+ *   - npm       — published npm version vs latest GitHub release / package.json
+ *   - jira      — failures recorded by the last JIRA auto-publish
+ *   - worktrees — workflow-run worktrees whose branch is already merged
+ *
+ * Every external command goes through an injectable {@link CommandRunner}
+ * with a per-command timeout and a total time budget. A missing tool, a
+ * timeout or a network failure turns that check into `skipped` — pulse never
+ * throws and never stalls its caller. Results are cached to
+ * `.specship/pulse.json` so a session-start summary can read them without
+ * touching the network.
+ */
+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.defaultCommandRunner = void 0;
+exports.pulseCachePath = pulseCachePath;
+exports.readCachedPulse = readCachedPulse;
+exports.compareVersions = compareVersions;
+exports.parseWorktreePorcelain = parseWorktreePorcelain;
+exports.computePulse = computePulse;
+exports.formatPulseLines = formatPulseLines;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const directory_1 = require("../directory");
+const paths_1 = require("../statusline/paths");
+const auto_publish_1 = require("../jira/auto-publish");
+const DEFAULT_COMMAND_TIMEOUT_MS = 3000;
+const DEFAULT_TOTAL_BUDGET_MS = 5000;
+const FAILED_CONCLUSIONS = new Set(['failure', 'timed_out', 'startup_failure', 'cancelled']);
+function pulseCachePath(projectRoot) {
+    return path.join((0, directory_1.getSpecShipDir)(projectRoot), 'pulse.json');
+}
+/** Read the cached pulse without running anything. Null when absent/corrupt. */
+function readCachedPulse(projectRoot) {
+    const raw = (0, paths_1.readJsonSafe)(pulseCachePath(projectRoot));
+    if (!raw || typeof raw.checkedAt !== 'number' || !Array.isArray(raw.items))
+        return null;
+    return { checkedAt: raw.checkedAt, items: raw.items, fromCache: true };
+}
+/** Default runner: execFile with a hard timeout; never rejects. */
+const defaultCommandRunner = (cmd, args, opts) => new Promise((resolve) => {
+    try {
+        (0, child_process_1.execFile)(cmd, args, {
+            cwd: opts.cwd,
+            timeout: Math.max(1, opts.timeoutMs),
+            windowsHide: true,
+            encoding: 'utf-8',
+            maxBuffer: 4 * 1024 * 1024,
+            // npm / gh ship as .cmd shims on Windows.
+            shell: process.platform === 'win32',
+        }, (err, stdout, stderr) => {
+            if (!err) {
+                resolve({ ok: true, stdout: String(stdout), stderr: String(stderr) });
+                return;
+            }
+            const e = err;
+            resolve({
+                ok: false,
+                stdout: String(stdout ?? ''),
+                stderr: String(stderr ?? ''),
+                missing: e.code === 'ENOENT',
+                timedOut: e.killed === true || e.signal === 'SIGTERM',
+            });
+        });
+    }
+    catch {
+        resolve({ ok: false, stdout: '', missing: true });
+    }
+});
+exports.defaultCommandRunner = defaultCommandRunner;
+/** Budget-aware wrapper around the runner. Never rejects. */
+function makeExec(runner, cwd, commandTimeoutMs, totalBudgetMs) {
+    const deadline = Date.now() + totalBudgetMs;
+    return async (cmd, args) => {
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            return { ok: false, stdout: '', timedOut: true };
+        const timeoutMs = Math.min(commandTimeoutMs, remaining);
+        try {
+            let timer;
+            const guard = new Promise((resolve) => {
+                timer = setTimeout(() => resolve({ ok: false, stdout: '', timedOut: true }), timeoutMs + 250);
+            });
+            const result = await Promise.race([runner(cmd, args, { cwd, timeoutMs }), guard]);
+            if (timer)
+                clearTimeout(timer);
+            return result;
+        }
+        catch {
+            return { ok: false, stdout: '', missing: true };
+        }
+    };
+}
+function skipReason(tool, r) {
+    if (r.missing)
+        return `${tool} not available`;
+    if (r.timedOut)
+        return `${tool} check timed out`;
+    return `${tool} check unavailable (offline or not authenticated)`;
+}
+function parseJson(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return null;
+    }
+}
+function dateOnly(iso) {
+    if (!iso)
+        return 'unknown date';
+    return iso.slice(0, 10);
+}
+/** Compare dotted versions numerically (pre-release suffixes ignored). */
+function compareVersions(a, b) {
+    const norm = (v) => (v.trim().replace(/^v/i, '').split(/[-+]/)[0] ?? '').split('.').map((n) => parseInt(n, 10) || 0);
+    const pa = norm(a);
+    const pb = norm(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d !== 0)
+            return d > 0 ? 1 : -1;
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Checks
+// ---------------------------------------------------------------------------
+async function checkRelease(projectRoot, exec) {
+    const wf = path.join(projectRoot, '.github', 'workflows', 'release.yml');
+    if (!fs.existsSync(wf)) {
+        return { id: 'release', status: 'skipped', message: 'Release: no .github/workflows/release.yml' };
+    }
+    const r = await exec('gh', [
+        'run', 'list', '--workflow=release.yml', '--limit', '1',
+        '--json', 'conclusion,createdAt,displayTitle,databaseId',
+    ]);
+    if (!r.ok) {
+        return { id: 'release', status: 'skipped', message: `Release: ${skipReason('gh', r)}` };
+    }
+    const runs = parseJson(r.stdout);
+    if (!runs)
+        return { id: 'release', status: 'skipped', message: 'Release: unreadable gh output' };
+    const run = runs[0];
+    if (!run)
+        return { id: 'release', status: 'ok', message: 'Release: no runs yet' };
+    const title = run.displayTitle ? ` (${run.displayTitle})` : '';
+    const when = dateOnly(run.createdAt);
+    if (!run.conclusion) {
+        return { id: 'release', status: 'ok', message: `Release: run in progress${title}, started ${when}` };
+    }
+    if (!FAILED_CONCLUSIONS.has(run.conclusion)) {
+        return { id: 'release', status: 'ok', message: `Release: last run ${run.conclusion}${title} on ${when}` };
+    }
+    // Failing step — one extra cheap call; omitted when unavailable.
+    let step = '';
+    if (typeof run.databaseId === 'number') {
+        const v = await exec('gh', ['run', 'view', String(run.databaseId), '--json', 'jobs']);
+        if (v.ok) {
+            const data = parseJson(v.stdout);
+            for (const job of data?.jobs ?? []) {
+                const s = (job.steps ?? []).find((x) => x.conclusion && FAILED_CONCLUSIONS.has(x.conclusion));
+                if (s?.name) {
+                    step = ` at step "${s.name}"${job.name ? ` (job ${job.name})` : ''}`;
+                    break;
+                }
+            }
+        }
+    }
+    return {
+        id: 'release',
+        status: 'fail',
+        message: `Release workflow ${run.conclusion} on ${when}${title}${step}`,
+        hint: 'gh run list --workflow=release.yml',
+    };
+}
+async function checkNpm(projectRoot, exec) {
+    const pkg = (0, paths_1.readJsonSafe)(path.join(projectRoot, 'package.json'));
+    if (!pkg?.name || pkg.private) {
+        return { id: 'npm', status: 'skipped', message: 'npm: no published package.json' };
+    }
+    const [npmRes, ghRes] = await Promise.all([
+        exec('npm', ['view', pkg.name, 'version']),
+        exec('gh', ['release', 'list', '--limit', '1', '--json', 'tagName']),
+    ]);
+    if (!npmRes.ok) {
+        return { id: 'npm', status: 'skipped', message: `npm: ${skipReason('npm', npmRes)}` };
+    }
+    const published = npmRes.stdout.trim().split(/\s+/).pop() ?? '';
+    if (!published)
+        return { id: 'npm', status: 'skipped', message: 'npm: no published version' };
+    let releaseTag;
+    if (ghRes.ok) {
+        const rel = parseJson(ghRes.stdout);
+        releaseTag = rel?.[0]?.tagName;
+    }
+    const lags = [];
+    if (releaseTag && compareVersions(releaseTag, published) > 0) {
+        lags.push(`latest GitHub release is ${releaseTag}`);
+    }
+    if (pkg.version && compareVersions(pkg.version, published) > 0) {
+        lags.push(`package.json is ${pkg.version}`);
+    }
+    if (lags.length > 0) {
+        return {
+            id: 'npm',
+            status: 'fail',
+            message: `npm ${pkg.name} is at ${published} but ${lags.join(' and ')}`,
+            hint: 'check the release workflow\'s publish step',
+        };
+    }
+    const relNote = releaseTag ? `, matches release ${releaseTag}` : ghRes.ok ? '' : ' (GitHub release not checked)';
+    return { id: 'npm', status: 'ok', message: `npm ${pkg.name} at ${published}${relNote}` };
+}
+function checkJira(projectRoot) {
+    const last = (0, auto_publish_1.readLastAutoPublishReport)(projectRoot);
+    if (!last)
+        return { id: 'jira', status: 'skipped', message: 'JIRA auto-publish: no report yet' };
+    const when = dateOnly(new Date(last.at).toISOString());
+    if (last.skipped) {
+        return { id: 'jira', status: 'skipped', message: `JIRA auto-publish skipped on ${when}: ${last.note ?? last.skipped}` };
+    }
+    if (last.counts.failed > 0) {
+        const sample = last.failures.slice(0, 3).map((f) => f.specId).join(', ');
+        const more = last.failures.length > 3 ? ', …' : '';
+        return {
+            id: 'jira',
+            status: 'fail',
+            message: `JIRA auto-publish: ${last.counts.failed} failed on ${when}${sample ? ` (${sample}${more})` : ''}`,
+            hint: 'details in .specship/jira-publish-last.json',
+        };
+    }
+    return {
+        id: 'jira',
+        status: 'ok',
+        message: `JIRA auto-publish: ${last.counts.published} published, ${last.counts.unchanged} unchanged on ${when}`,
+    };
+}
+function parseWorktreePorcelain(out) {
+    const entries = [];
+    let cur = null;
+    for (const line of out.split(/\r?\n/)) {
+        if (line.startsWith('worktree ')) {
+            if (cur)
+                entries.push(cur);
+            cur = { path: line.slice('worktree '.length) };
+        }
+        else if (cur && line.startsWith('branch ')) {
+            cur.branch = line.slice('branch '.length).replace(/^refs\/heads\//, '');
+        }
+        else if (cur && line.startsWith('prunable')) {
+            cur.prunable = true;
+        }
+    }
+    if (cur)
+        entries.push(cur);
+    return entries;
+}
+function isRunWorktree(e) {
+    if (e.branch?.startsWith('specship/wf-'))
+        return true;
+    return /[\\/]\.specship[\\/]worktrees[\\/]/.test(e.path);
+}
+function shortRunId(e) {
+    const src = e.branch ?? path.basename(e.path);
+    const m = /([0-9a-f]{8})$/i.exec(src) ?? /([0-9a-f]{8})$/i.exec(path.basename(e.path));
+    return m?.[1] ?? path.basename(e.path);
+}
+async function defaultBranch(exec) {
+    const sym = await exec('git', ['symbolic-ref', '--quiet', '--short', 'refs/remotes/origin/HEAD']);
+    if (sym.ok && sym.stdout.trim())
+        return sym.stdout.trim().replace(/^origin\//, '');
+    for (const name of ['main', 'master']) {
+        const r = await exec('git', ['rev-parse', '--verify', '--quiet', `refs/heads/${name}`]);
+        if (r.ok)
+            return name;
+    }
+    return null;
+}
+async function checkWorktrees(exec, runIdFor) {
+    const list = await exec('git', ['worktree', 'list', '--porcelain']);
+    if (!list.ok) {
+        return { id: 'worktrees', status: 'skipped', message: `Worktrees: ${skipReason('git', list)}` };
+    }
+    const runTrees = parseWorktreePorcelain(list.stdout)
+        .slice(1) // the main worktree is never a run worktree
+        .filter((e) => !e.prunable && e.branch && isRunWorktree(e));
+    if (runTrees.length === 0) {
+        return { id: 'worktrees', status: 'ok', message: 'Worktrees: no workflow-run worktrees on disk' };
+    }
+    const base = await defaultBranch(exec);
+    if (!base)
+        return { id: 'worktrees', status: 'skipped', message: 'Worktrees: default branch unknown' };
+    const merged = await exec('git', ['branch', '--merged', base, '--format=%(refname:short)']);
+    if (!merged.ok) {
+        return { id: 'worktrees', status: 'skipped', message: `Worktrees: ${skipReason('git', merged)}` };
+    }
+    const mergedSet = new Set(merged.stdout.split(/\r?\n/).map((s) => s.trim()).filter(Boolean));
+    const stale = runTrees.filter((e) => mergedSet.has(e.branch));
+    if (stale.length === 0) {
+        return { id: 'worktrees', status: 'ok', message: `Worktrees: ${runTrees.length} run worktree(s), none merged` };
+    }
+    const ids = stale.map((e) => runIdFor?.(e.path, e.branch) ?? shortRunId(e));
+    return {
+        id: 'worktrees',
+        status: 'fail',
+        message: `${stale.length} merged workflow-run worktree(s) still on disk: ${stale.map((e) => path.basename(e.path)).join(', ')}`,
+        hint: ids.map((id) => `specship workflow purge ${id}`).join('; '),
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Compute (or serve from cache) the pipeline pulse. Never throws: every
+ * check that cannot run cleanly degrades to `skipped`.
+ */
+async function computePulse(opts) {
+    const now = opts.now ?? Date.now;
+    const root = opts.projectRoot;
+    if (!opts.refresh && typeof opts.maxAgeMs === 'number') {
+        const cached = readCachedPulse(root);
+        if (cached && now() - cached.checkedAt <= opts.maxAgeMs)
+            return cached;
+    }
+    const exec = makeExec(opts.runner ?? exports.defaultCommandRunner, root, opts.commandTimeoutMs ?? DEFAULT_COMMAND_TIMEOUT_MS, opts.totalBudgetMs ?? DEFAULT_TOTAL_BUDGET_MS);
+    const safe = async (id, label, fn) => {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            return { id, status: 'skipped', message: `${label}: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    };
+    // Network checks run concurrently so the total stays within budget.
+    const items = await Promise.all([
+        safe('release', 'Release', () => checkRelease(root, exec)),
+        safe('npm', 'npm', () => checkNpm(root, exec)),
+        safe('jira', 'JIRA auto-publish', () => checkJira(root)),
+        safe('worktrees', 'Worktrees', () => checkWorktrees(exec, opts.runIdForWorktree)),
+    ]);
+    const result = { checkedAt: now(), items, fromCache: false };
+    if (opts.writeCache !== false) {
+        try {
+            (0, paths_1.writeJsonAtomic)(pulseCachePath(root), { checkedAt: result.checkedAt, items });
+        }
+        catch {
+            /* the cache is best-effort */
+        }
+    }
+    return result;
+}
+/**
+ * One human line per failing item; an empty array when everything is
+ * healthy or skipped (so a session-start summary stays silent).
+ */
+function formatPulseLines(items) {
+    return items
+        .filter((i) => i.status === 'fail')
+        .map((i) => `⚠ ${i.message}${i.hint ? ` — ${i.hint}` : ''}`);
+}
+//# sourceMappingURL=pulse.js.map

package/lib/dist/pulse/pulse.js.map

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

package/lib/dist/reflect/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/reflect/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAU7E,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmB9D;AAsBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,aAAa,CA4C1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAgCxE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CA+BtE"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/reflect/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAU7E,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmB9D;AAsBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,aAAa,CA4D1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAwCxE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAuCtE"}

package/lib/dist/reflect/apply.js

@@ -113,11 +113,26 @@ const MEMORY_INDEX = (homeDir) => path.join(homeDir, '.claude', 'memory', 'MEMOR
 function previewProposal(p) {
     const { payload, targetPath, targetKind } = p;
     const cur = readFileSafe(targetPath);
-    if (payload.kind === 'claude_md') {
+    if (payload.kind === 'claude_md' || payload.kind === 'conventions') {
         const { start, end } = (0, targets_1.learningMarkers)(payload.markerId);
         const after = previewMarkedUpsert(cur.content, start, end, payload.block);
         return { targetPath, targetKind, exists: cur.exists, before: cur.content, after, diff: lineDiff(cur.content, after) };
     }
+    if (payload.kind === 'domain_fact') {
+        // REQ-ALEARN-003.A2: an engine-written draft is recognizable by its
+        // frontmatter marker; anything else at the path is a human's file — refuse.
+        const conflict = cur.exists && !cur.content.includes((0, targets_1.domainFactMarker)(payload.slug));
+        const after = conflict ? cur.content : payload.content;
+        return {
+            targetPath,
+            targetKind,
+            exists: cur.exists,
+            before: cur.content,
+            after,
+            diff: conflict ? '(conflict: a non-SpecShip domain fact already exists here)' : lineDiff(cur.content, after),
+            conflict,
+        };
+    }
     if (payload.kind === 'memory_note') {
         const conflict = cur.exists && !cur.content.includes((0, targets_1.memoryNoteMarker)(payload.slug));
         const after = conflict ? cur.content : payload.note;
@@ -156,11 +171,20 @@ function previewProposal(p) {
  */
 function applyProposal(p, homeDir) {
     const { payload, targetPath } = p;
-    if (payload.kind === 'claude_md') {
+    if (payload.kind === 'claude_md' || payload.kind === 'conventions') {
         const { start, end } = (0, targets_1.learningMarkers)(payload.markerId);
         const res = (0, shared_1.upsertMarkedSection)(targetPath, start, end, payload.block);
         return res === 'unchanged' ? 'unchanged' : 'applied';
     }
+    if (payload.kind === 'domain_fact') {
+        const cur = readFileSafe(targetPath);
+        if (cur.exists && !cur.content.includes((0, targets_1.domainFactMarker)(payload.slug)))
+            return 'conflict';
+        if (cur.exists && cur.content === payload.content)
+            return 'unchanged';
+        (0, shared_1.atomicWriteFileSync)(targetPath, payload.content);
+        return 'applied';
+    }
     if (payload.kind === 'memory_note') {
         const cur = readFileSafe(targetPath);
         if (cur.exists && !cur.content.includes((0, targets_1.memoryNoteMarker)(payload.slug)))
@@ -193,10 +217,21 @@ function applyProposal(p, homeDir) {
  */
 function undoProposal(p, homeDir) {
     const { payload, targetPath } = p;
-    if (payload.kind === 'claude_md') {
+    if (payload.kind === 'claude_md' || payload.kind === 'conventions') {
         const { start, end } = (0, targets_1.learningMarkers)(payload.markerId);
         return (0, shared_1.removeMarkedSection)(targetPath, start, end) === 'removed' ? 'undone' : 'noop';
     }
+    if (payload.kind === 'domain_fact') {
+        const cur = readFileSafe(targetPath);
+        if (cur.exists && cur.content.includes((0, targets_1.domainFactMarker)(payload.slug))) {
+            try {
+                fs.unlinkSync(targetPath);
+                return 'undone';
+            }
+            catch { /* ignore */ }
+        }
+        return 'noop';
+    }
     if (payload.kind === 'memory_note') {
         const cur = readFileSafe(targetPath);
         let touched = false;