@mmnto/cli 1.52.0 → 1.53.1

package/dist/commands/orient-coherence.test.js

@@ -0,0 +1,99 @@
+import { describe, expect, it, vi } from 'vitest';
+import { flagBoardIssueDrift, isActiveBoardItem } from './orient-coherence.js';
+describe('isActiveBoardItem', () => {
+    it.each([
+        ['Todo', false],
+        ['todo', false],
+        ['Done', false],
+        ['Closed', false],
+        ['Informs', false],
+        ['Backlog', false],
+        ['In Progress', true],
+        ['In Review', true],
+        ['Up Next', true],
+    ])('status %s → active=%s', (status, active) => {
+        expect(isActiveBoardItem({ status, title: 't' })).toBe(active);
+    });
+    it('treats an absent status as Todo (inactive)', () => {
+        expect(isActiveBoardItem({ title: 't' })).toBe(false);
+    });
+});
+describe('flagBoardIssueDrift', () => {
+    const LOCAL = 'mmnto-ai/totem';
+    /** Build a same-repo Issue card (the only kind that can drift) unless overridden. */
+    const issueCard = (over) => ({
+        status: 'In Progress',
+        title: 'Card',
+        contentRepo: LOCAL,
+        contentType: 'Issue',
+        ...over,
+    });
+    it('flags active same-repo Issue cards whose linked issue is absent from the open set', () => {
+        const board = [
+            issueCard({ title: 'Card A', contentNumber: 100 }),
+            issueCard({ title: 'Card B', contentNumber: 200, status: 'In Review' }),
+        ];
+        const open = new Set([200]); // #100 is closed/absent
+        expect(flagBoardIssueDrift(board, open, LOCAL)).toEqual([
+            {
+                boardItemTitle: 'Card A',
+                boardStatus: 'In Progress',
+                issueNumber: 100,
+                kind: 'issue-closed-or-absent',
+            },
+        ]);
+    });
+    it('never flags terminal-status cards even when their issue is absent', () => {
+        const board = [
+            issueCard({ status: 'Done', title: 'Done card', contentNumber: 1 }),
+            issueCard({ status: 'Todo', title: 'Todo card', contentNumber: 2 }),
+            issueCard({ status: 'Backlog', title: 'Backlog card', contentNumber: 3 }),
+        ];
+        expect(flagBoardIssueDrift(board, new Set(), LOCAL)).toEqual([]);
+    });
+    it('does not flag cards whose issue is still open', () => {
+        const board = [issueCard({ title: 'A', contentNumber: 5 })];
+        expect(flagBoardIssueDrift(board, new Set([5]), LOCAL)).toEqual([]);
+    });
+    it('ignores active cards with no linked issue number (draft cards)', () => {
+        const board = [
+            { status: 'In Progress', title: 'Draft card', contentType: 'DraftIssue' },
+        ];
+        expect(flagBoardIssueDrift(board, new Set(), LOCAL)).toEqual([]);
+    });
+    // Regression: org-level boards span repos. A card for ANOTHER repo's issue must
+    // NOT be flagged against this repo's open-issue set (the #2044 controller-review bug).
+    it('never flags cross-repo cards (org board spanning repos)', () => {
+        const board = [
+            issueCard({
+                title: 'Strategy card',
+                contentNumber: 433,
+                contentRepo: 'mmnto-ai/totem-strategy',
+            }),
+        ];
+        // #433 is absent from THIS repo's open set, but it's a strategy issue → not drift here.
+        expect(flagBoardIssueDrift(board, new Set(), LOCAL)).toEqual([]);
+    });
+    // A PR card's number lives in a different namespace than the open-ISSUE set;
+    // comparing it would always false-flag. PR cards are never issue-drift.
+    it('never flags PullRequest cards', () => {
+        const board = [
+            issueCard({ title: 'PR card', contentNumber: 2049, contentType: 'PullRequest' }),
+        ];
+        expect(flagBoardIssueDrift(board, new Set(), LOCAL)).toEqual([]);
+    });
+    it('derives NO coherence when the repo is undetermined (localSlug null)', () => {
+        const board = [issueCard({ title: 'A', contentNumber: 7 })];
+        expect(flagBoardIssueDrift(board, new Set(), null)).toEqual([]);
+    });
+    it('issues ZERO gh/exec calls — it is a pure function of its arguments', async () => {
+        // Spy on safeExec at the core boundary; the predicate must never touch it.
+        const core = await import('@mmnto/totem');
+        const spy = vi.spyOn(core, 'safeExec');
+        const board = [issueCard({ title: 'A', contentNumber: 9 })];
+        flagBoardIssueDrift(board, new Set(), LOCAL);
+        expect(spy).not.toHaveBeenCalled();
+        spy.mockRestore();
+    });
+});
+//# sourceMappingURL=orient-coherence.test.js.map

package/dist/commands/orient-coherence.test.js.map

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

package/dist/commands/orient.d.ts

@@ -0,0 +1,97 @@
+import type { BoardIssueCoherenceFlag } from './orient-coherence.js';
+/** The `{ error }` envelope for an underivable section. The `error` key is the
+ *  external JSON-API field name (same convention as `json-output.ts`). */
+interface ErrorEnvelope {
+    error: string;
+}
+/** A section is EITHER its derived value OR an `{ error }` envelope — never silently omitted. */
+type Section<T> = T | ErrorEnvelope;
+export interface OrientParkedEntry {
+    subsystem: string;
+    since?: string;
+    reason?: string;
+    tracking?: string;
+}
+export interface OrientPr {
+    number: number;
+    title: string;
+    headRefName: string;
+    isDraft: boolean;
+}
+export interface OrientBoardItem {
+    status: string;
+    title: string;
+    contentNumber?: number;
+}
+export interface OrientEpic {
+    number: number;
+    title: string;
+    labels: string[];
+    subIssues: {
+        number: number;
+        title: string;
+    }[];
+}
+export interface OrientOtherIssue {
+    number: number;
+    title: string;
+    labels: string[];
+}
+/** Index-freshness pointer — either a derived staleness fact or an honest "not synced" absence. */
+export interface OrientIndexFreshness {
+    synced: boolean;
+    /** Relative age of the registry `lastSync` (e.g. '2h ago'), when synced. */
+    lastSync?: string;
+    stale?: boolean;
+}
+export interface OrientReport {
+    repo: Section<string>;
+    derivedAt: string;
+    indexFreshness: OrientIndexFreshness;
+    parked: Section<OrientParkedEntry[]>;
+    openPRs: Section<OrientPr[]>;
+    board: Section<OrientBoardItem[]>;
+    coherence: Section<BoardIssueCoherenceFlag[]>;
+    epics: Section<OrientEpic[]>;
+    otherOpenIssues: Section<OrientOtherIssue[]>;
+    /** Whether a board project number is configured. Distinguishes the JSON's
+     *  "no board configured" (false) from "board configured but empty" (true,
+     *  `board: []`) — without it the two collapse to the same shape (Tenet 14). */
+    boardConfigured: boolean;
+}
+/**
+ * Programmatic entry: derive the full `OrientReport` for `cwd` WITHOUT writing
+ * stdout. Identical report to `orient --json` (one derivation, two callers —
+ * cannot diverge). Reused by `orientCommand` (the CLI surface) and the
+ * SessionStart hook (`.claude/hooks/session-context.mjs`, mmnto-ai/totem#2044
+ * PR-2), which dynamic-imports this from `packages/cli/dist/commands/orient.js`
+ * — the workspace-dist pattern, deliberately NOT the global `totem` binary
+ * (sidesteps the stale-resolve trap mmnto-ai/totem#2053).
+ *
+ * Latency note: orient's gh adapters are synchronous (`safeExec`/execFileSync),
+ * so this runs ~4 sequential blocking gh calls (repo view + PRs + issues + board),
+ * each bounded by the adapter's per-call timeout. Callers on a latency-sensitive
+ * path (the hook) wrap it best-effort and degrade on failure.
+ */
+export declare function deriveOrientReport(cwd: string): Promise<OrientReport>;
+export declare function renderReport(report: OrientReport): string;
+/**
+ * Compact projection of an `OrientReport` for auto-injection at session start.
+ *
+ * Emits ONLY high-signal state — parked/frozen subsystems, open PRs, and board↔
+ * issue coherence drift — plus a one-line COUNTS pointer for epics/other-issues
+ * (NOT the full enumeration: "pointers not bodies", mmnto-ai/totem-strategy#467
+ * Tier-A discipline). An underivable section stays a `⚠ could not derive` line
+ * (Tenet 4 — never a silent omit), so the projection inherits orient's fail-loud
+ * contract. Hard-bounded by `SESSION_BLOCK_MAX_CHARS` (the guardrail above).
+ *
+ * Returns '' when there is nothing high-signal to surface (no parked, no PRs, no
+ * drift, no derivable counts) so the hook can omit the block entirely rather than
+ * inject an empty header.
+ */
+export declare function renderOrientForSession(report: OrientReport): string;
+export declare function orientCommand(opts: {
+    json?: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=orient.d.ts.map

package/dist/commands/orient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient.d.ts","sourceRoot":"","sources":["../../src/commands/orient.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAqBrE;0EAC0E;AAC1E,UAAU,aAAa;IAErB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iGAAiG;AACjG,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,oBAAoB,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC7C;;mFAE+E;IAC/E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAkUD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAG3E;AAeD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAqFzD;AAgBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA4EnE;AAID,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3E"}