@mmnto/cli 1.17.0 → 1.18.0

package/dist/terminal-sanitize.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it } from 'vitest';
+import { sanitizeForTerminal } from './terminal-sanitize.js';
+describe('sanitizeForTerminal', () => {
+    it('strips CSI escape sequences (ESC [ … final byte)', () => {
+        expect(sanitizeForTerminal('\x1b[31mred\x1b[0m')).toBe('red');
+        expect(sanitizeForTerminal('a\x1b[1;33mb\x1b[mc')).toBe('abc');
+    });
+    it('replaces C0 control bytes with a space, preserving \\n and \\t', () => {
+        // \x07 BEL, \x08 BS, \x0b VT, \x0c FF, \x0e SO, \x1f US — all should become spaces.
+        expect(sanitizeForTerminal('a\x07b\x08c\x0bd\x0ce\x0ef\x1fg')).toBe('a b c d e f g');
+        // \n and \t survive (caller may collapse later).
+        expect(sanitizeForTerminal('line\n\twith\twhitespace')).toBe('line\n\twith\twhitespace');
+        // \x7f DEL also strips.
+        expect(sanitizeForTerminal('del\x7fhere')).toBe('del here');
+    });
+    it('strips \\r (CR) — a bare CR rewinds the terminal cursor', () => {
+        // CR mmnto-ai/totem#1739 R3 Critical: \r alone overwrites the current
+        // terminal line; preserving it would defeat the sanitizer's whole
+        // purpose. \n still survives.
+        expect(sanitizeForTerminal('safe\rrewound')).toBe('safe rewound');
+        expect(sanitizeForTerminal('safe\r\nwindows')).toBe('safe \nwindows');
+        // No CR survives anywhere in the output.
+        expect(sanitizeForTerminal('a\rb\rc\rd')).not.toContain('\r');
+    });
+    it('replaces C1 control bytes (\\x80-\\x9f) with a space — closes the original \\x7f gap', () => {
+        // \x9b is the 8-bit CSI introducer — directly equivalent to ESC [ on
+        // 8-bit-clean terminals. CR mmnto-ai/totem#1739 R2 caught the original
+        // regex stopped at \x7f leaving the C1 range open.
+        expect(sanitizeForTerminal('csi-8bit\x9bsequence')).toBe('csi-8bit sequence');
+        // Sweep the whole C1 range.
+        for (let cp = 0x80; cp <= 0x9f; cp += 1) {
+            const ctrl = String.fromCharCode(cp);
+            const out = sanitizeForTerminal(`a${ctrl}b`);
+            expect(out).toBe('a b');
+        }
+    });
+    it('passes printable text through unchanged', () => {
+        expect(sanitizeForTerminal('plain text 123 !@#$%^&*()')).toBe('plain text 123 !@#$%^&*()');
+        // Unicode above C1 is preserved.
+        expect(sanitizeForTerminal('café — naïve')).toBe('café — naïve');
+    });
+    it('returns the empty string unchanged', () => {
+        expect(sanitizeForTerminal('')).toBe('');
+    });
+});
+//# sourceMappingURL=terminal-sanitize.test.js.map

package/dist/terminal-sanitize.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-sanitize.test.js","sourceRoot":"","sources":["../src/terminal-sanitize.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,MAAM,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,oFAAoF;QACpF,MAAM,CAAC,mBAAmB,CAAC,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACrF,iDAAiD;QACjD,MAAM,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACzF,wBAAwB;QACxB,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,sEAAsE;QACtE,kEAAkE;QAClE,8BAA8B;QAC9B,MAAM,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAClE,MAAM,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACtE,yCAAyC;QACzC,MAAM,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,qEAAqE;QACrE,uEAAuE;QACvE,mDAAmD;QACnD,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC9E,4BAA4B;QAC5B,KAAK,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACrC,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,mBAAmB,CAAC,2BAA2B,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC3F,iCAAiC;QACjC,MAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/governance.d.ts

@@ -6,11 +6,18 @@
  * its context via arguments so the tests can exercise both the submodule
  * (`<totem>/.strategy/`) and the standalone (strategy-repo root) cases.
  */
+import { type StrategyResolverConfig } from '@mmnto/totem';
 export type GovernanceType = 'proposal' | 'adr';
 export interface ScaffoldOptions {
     type: GovernanceType;
     title: string;
     cwd: string;
+    /**
+     * Loaded `TotemConfig` (or any object with a `strategyRoot?: string` field).
+     * Forwarded to the strategy-root resolver so `TotemConfig.strategyRoot`
+     * wins precedence-2 over the sibling / submodule layers (mmnto-ai/totem#1710).
+     */
+    config?: StrategyResolverConfig;
 }
 export interface GovernancePaths {
     /** Directory that anchors the governance layout (strategy repo root or submodule root). */
@@ -22,20 +29,42 @@ export interface GovernancePaths {
     /** Dashboard README refreshed by `docs:inject`. */
     dashboardFile: string;
 }
+/**
+ * Best-effort `TotemConfig` load for the governance commands. Returns
+ * `undefined` when the config is missing, unparseable, OR resolves to the
+ * global `~/.totem/` profile — both missing and unparseable are legitimate
+ * states for a freshly-cloned consumer repo, and a global-profile config
+ * is intentionally NOT used as a repo-local `strategyRoot` source (that
+ * would let one user's personal pointer leak across every repo on disk).
+ * The strategy-root resolver still has env / sibling / submodule layers
+ * to fall back on (mmnto-ai/totem#1710 R3 — CR R3 global-config-leak fix).
+ *
+ * Shared by `proposalNewCommand` and `adrNewCommand` so the load idiom +
+ * its `// totem-context: intentional best-effort` annotation live in one
+ * place (mmnto-ai/totem#1710 R2).
+ */
+export declare function loadGovernanceConfig(cwd: string): Promise<StrategyResolverConfig | undefined>;
 /**
  * Resolve governance paths for the current invocation.
  *
- * Two supported contexts:
- * 1. **Submodule case** — `<gitRoot>/.strategy/` exists. Used when Totem is
- *    the parent repo and `.strategy/` is a submodule/worktree.
- * 2. **Standalone case** — `<gitRoot>` itself is the strategy repo
- *    (`proposals/active/` sits at the repo root). Used when the CLI is run
- *    from inside the strategy repo directly.
+ * Two layout shapes supported:
+ *
+ * 1. **Standalone (cwd IS the strategy repo)** — `<gitRoot>` itself contains
+ *    `proposals/` or `adr/` at the top level. Used when the CLI runs from
+ *    inside the strategy repo directly. Detected here in the helper before
+ *    delegating to the resolver because the strategy-root resolver answers
+ *    "where IS the strategy repo from somewhere else", not "are we INSIDE
+ *    one already."
+ *
+ * 2. **Resolved (cwd is in a consuming repo)** — defer to
+ *    `resolveStrategyRoot` (mmnto-ai/totem#1710). The resolver walks env →
+ *    config → sibling → submodule precedence and returns an absolute path.
+ *    Throws an actionable `TotemError` (ADR-088) when none of the layers
+ *    resolve.
  *
- * Throws `TotemError` when cwd is not inside a git repo, or when neither
- * layout can be detected.
+ * Also throws `TotemError` when cwd is not inside a git repo.
  */
-export declare function resolveGovernancePaths(cwd: string, type: GovernanceType): GovernancePaths;
+export declare function resolveGovernancePaths(cwd: string, type: GovernanceType, config?: StrategyResolverConfig): GovernancePaths;
 /**
  * Scan `targetDir` for `NNN-slug.md` files, parse the prefix to an int,
  * and return `(max + 1)` zero-padded to three digits.

package/dist/utils/governance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/utils/governance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,KAAK,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,eAAe,CAwCzF;AAOD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA0B3D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAexE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAID;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,yUAoBrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,+QAgBhC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAoB1E;AAID;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,2FAA2F;IAC3F,kBAAkB,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,MAAM,EAAE,OAAO,CAAC;CACjB;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,CA4B1F;AAID,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,SAAS,GAAE,yBAA8B,GACxC,sBAAsB,CAqExB"}
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/utils/governance.ts"],"names":[],"mappings":"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"}

package/dist/utils/governance.js

@@ -8,9 +8,37 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { resolveGitRoot, safeExec, TotemError } from '@mmnto/totem';
+import { resolveGitRoot, resolveStrategyRoot, safeExec, TotemError, } from '@mmnto/totem';
+import { sanitizeForTerminal } from '../terminal-sanitize.js';
 import { log } from '../ui.js';
-const STRATEGY_SUBDIR = '.strategy';
+/**
+ * Best-effort `TotemConfig` load for the governance commands. Returns
+ * `undefined` when the config is missing, unparseable, OR resolves to the
+ * global `~/.totem/` profile — both missing and unparseable are legitimate
+ * states for a freshly-cloned consumer repo, and a global-profile config
+ * is intentionally NOT used as a repo-local `strategyRoot` source (that
+ * would let one user's personal pointer leak across every repo on disk).
+ * The strategy-root resolver still has env / sibling / submodule layers
+ * to fall back on (mmnto-ai/totem#1710 R3 — CR R3 global-config-leak fix).
+ *
+ * Shared by `proposalNewCommand` and `adrNewCommand` so the load idiom +
+ * its `// totem-context: intentional best-effort` annotation live in one
+ * place (mmnto-ai/totem#1710 R2).
+ */
+export async function loadGovernanceConfig(cwd) {
+    try {
+        const { loadConfig, resolveConfigPath, isGlobalConfigPath } = await import('../utils.js');
+        const configPath = resolveConfigPath(cwd);
+        if (isGlobalConfigPath(configPath))
+            return undefined;
+        const config = (await loadConfig(configPath));
+        return config;
+        // totem-context: intentional best-effort load — missing/unparseable config is a legitimate state for a freshly-cloned consumer repo; resolver's other layers (env / sibling / submodule) still apply.
+    }
+    catch {
+        return undefined;
+    }
+}
 function targetSubpath(type) {
     return type === 'proposal' ? path.join('proposals', 'active') : 'adr';
 }
@@ -20,35 +48,59 @@ function templateFilename(type) {
 /**
  * Resolve governance paths for the current invocation.
  *
- * Two supported contexts:
- * 1. **Submodule case** — `<gitRoot>/.strategy/` exists. Used when Totem is
- *    the parent repo and `.strategy/` is a submodule/worktree.
- * 2. **Standalone case** — `<gitRoot>` itself is the strategy repo
- *    (`proposals/active/` sits at the repo root). Used when the CLI is run
- *    from inside the strategy repo directly.
+ * Two layout shapes supported:
+ *
+ * 1. **Standalone (cwd IS the strategy repo)** — `<gitRoot>` itself contains
+ *    `proposals/` or `adr/` at the top level. Used when the CLI runs from
+ *    inside the strategy repo directly. Detected here in the helper before
+ *    delegating to the resolver because the strategy-root resolver answers
+ *    "where IS the strategy repo from somewhere else", not "are we INSIDE
+ *    one already."
+ *
+ * 2. **Resolved (cwd is in a consuming repo)** — defer to
+ *    `resolveStrategyRoot` (mmnto-ai/totem#1710). The resolver walks env →
+ *    config → sibling → submodule precedence and returns an absolute path.
+ *    Throws an actionable `TotemError` (ADR-088) when none of the layers
+ *    resolve.
  *
- * Throws `TotemError` when cwd is not inside a git repo, or when neither
- * layout can be detected.
+ * Also throws `TotemError` when cwd is not inside a git repo.
  */
-export function resolveGovernancePaths(cwd, type) {
+export function resolveGovernancePaths(cwd, type, config) {
     const gitRoot = resolveGitRoot(cwd);
     if (gitRoot === null) {
-        throw new TotemError('CONFIG_MISSING', `Not inside a git repository: ${cwd}`, 'Run this command from inside a Totem or Totem-strategy repository checkout.');
+        // Sanitize `cwd` here too — the sister branch already does this for
+        // the resolved-but-no-layout error (mmnto-ai/totem#1710 R5). A working
+        // directory name with embedded ANSI/CR bytes would otherwise hit the
+        // CLI raw on the not-in-git-repo path (mmnto-ai/totem#1710 R6 / CR R6
+        // outside-diff Major).
+        throw new TotemError('CONFIG_MISSING', `Not inside a git repository: ${sanitizeForTerminal(cwd)}`, 'Run this command from inside a Totem or Totem-strategy repository checkout.');
     }
-    const submoduleRoot = path.join(gitRoot, STRATEGY_SUBDIR);
-    const submoduleHasProposals = fs.existsSync(path.join(submoduleRoot, 'proposals'));
-    const submoduleHasAdr = fs.existsSync(path.join(submoduleRoot, 'adr'));
-    const standaloneHasProposals = fs.existsSync(path.join(gitRoot, 'proposals'));
-    const standaloneHasAdr = fs.existsSync(path.join(gitRoot, 'adr'));
+    // Standalone detection requires BOTH the type-specific target subdir AND
+    // a `templates/` folder at the repo root. The conjunction catches the
+    // canonical strategy-repo layout (proposals/active/ + adr/ + templates/)
+    // while avoiding false positives on consumer repos that happen to ship a
+    // top-level `adr/` docs folder without a strategy substrate.
+    const standaloneHasTarget = fs.existsSync(path.join(gitRoot, targetSubpath(type)));
+    const standaloneHasTemplates = fs.existsSync(path.join(gitRoot, 'templates'));
     let rootDir;
-    if (submoduleHasProposals || submoduleHasAdr) {
-        rootDir = submoduleRoot;
-    }
-    else if (standaloneHasProposals || standaloneHasAdr) {
+    if (standaloneHasTarget && standaloneHasTemplates) {
         rootDir = gitRoot;
     }
     else {
-        throw new TotemError('CONFIG_MISSING', `No Totem-strategy layout found under ${gitRoot}.`, 'Expected either a `.strategy/` submodule or top-level `proposals/` and `adr/` directories. Clone or link the strategy repo first.');
+        const status = resolveStrategyRoot(cwd, { gitRoot, config });
+        if (!status.resolved) {
+            // Sanitize filesystem- and env-derived strings before they flow
+            // into the CLI-rendered TotemError. `cwd` and `gitRoot` are
+            // process inputs; `status.reason` carries env values
+            // (`TOTEM_STRATEGY_ROOT`, `STRATEGY_ROOT`) and config values
+            // verbatim. ANSI/CR bytes there would rewind the cursor when the
+            // error is rendered (mmnto-ai/totem#1710 R5 / CR R5 Major).
+            const safeCwd = sanitizeForTerminal(cwd);
+            const safeClonePath = sanitizeForTerminal(path.join(path.dirname(gitRoot), 'totem-strategy'));
+            const safeReason = sanitizeForTerminal(status.reason);
+            throw new TotemError('CONFIG_MISSING', `No Totem-strategy layout found from ${safeCwd}.`, `Clone the strategy repo as a sibling (e.g., \`git clone <strategy-url> ${safeClonePath}\`), set the TOTEM_STRATEGY_ROOT env var, or initialize the legacy \`.strategy/\` submodule. Resolver detail: ${safeReason}`);
+        }
+        rootDir = status.path;
     }
     const targetDir = path.join(rootDir, targetSubpath(type));
     const templatePath = path.join(rootDir, 'templates', templateFilename(type));
@@ -269,7 +321,7 @@ function todayIso() {
  * never strands a half-written artifact.
  */
 export function scaffoldGovernanceArtifact(options, internals = {}) {
-    const paths = resolveGovernancePaths(options.cwd, options.type);
+    const paths = resolveGovernancePaths(options.cwd, options.type, options.config);
     // Sanitize once at the orchestrator entry. Both the filename slug and the
     // template body render against the cleaned form so a title carrying
     // newlines, tabs, or control characters cannot inject markdown blocks

package/dist/utils/governance.js.map

@@ -1 +1 @@
-{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../src/utils/governance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../src/utils/governance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,QAAQ,EAER,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AA2B/B;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAW;IAEX,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC1F,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,kBAAkB,CAAC,UAAU,CAAC;YAAE,OAAO,SAAS,CAAC;QACrD,MAAM,MAAM,GAAG,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAA2B,CAAC;QACxE,OAAO,MAAM,CAAC;QACd,sMAAsM;IACxM,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAoB;IACzC,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACxE,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAoB;IAC5C,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,IAAoB,EACpB,MAA+B;IAE/B,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,oEAAoE;QACpE,uEAAuE;QACvE,qEAAqE;QACrE,sEAAsE;QACtE,uBAAuB;QACvB,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,gCAAgC,mBAAmB,CAAC,GAAG,CAAC,EAAE,EAC1D,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,6DAA6D;IAC7D,MAAM,mBAAmB,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,sBAAsB,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9E,IAAI,OAAe,CAAC;IACpB,IAAI,mBAAmB,IAAI,sBAAsB,EAAE,CAAC;QAClD,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,gEAAgE;YAChE,4DAA4D;YAC5D,qDAAqD;YACrD,6DAA6D;YAC7D,iEAAiE;YACjE,4DAA4D;YAC5D,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;YAC9F,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtD,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,uCAAuC,OAAO,GAAG,EACjD,0EAA0E,aAAa,iHAAiH,UAAU,EAAE,CACrN,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAEtD,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAChC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QACpC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;QAC1C,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,2DAA2D;AAE3D,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAClD,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;YAChD,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;IACzB,IAAI,IAAI,GAAG,eAAe,EAAE,CAAC;QAC3B,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,kCAAkC,SAAS,mBAAmB,OAAO,IAAI,EACzE,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAU,EAAE,KAAa;IAC9D,MAAM,IAAI,GAAG,KAAK;SACf,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,UAAU,KAAK,2BAA2B,EAC1C,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,EAAE,IAAI,IAAI,KAAK,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,CACL,KAAK;QACH,0FAA0F;SACzF,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;SACjC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CACV,CAAC;AACJ,CAAC;AAED,2DAA2D;AAE3D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;CAgBnC,CAAC;AAUF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA2B;IAChE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAErD,IAAI,QAAgB,CAAC;IACrB,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACpF,CAAC;IAED,4DAA4D;IAC5D,0EAA0E;IAC1E,yEAAyE;IACzE,yEAAyE;IACzE,0BAA0B;IAC1B,oEAAoE;IACpE,qEAAqE;IACrE,kEAAkE;IAClE,MAAM,YAAY,GAA2B,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAClF,OAAO,QAAQ,CAAC,OAAO,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAE,CAAC,CAAC;AAC3F,CAAC;AA0BD,MAAM,WAAW,GAAW,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC7C,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA6B;IAChE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;IAEzE,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9C,kBAAkB,GAAG,IAAI,CAAC,CAAC,0IAA0I;IACvK,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,GAAG,CAAC,IAAI,CACN,OAAO,EACP,oCAAoC,GAAG,kEAAkE,CAC1G,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,GAAG,IAAI,CAAC,CAAC,gIAAgI;IACjJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,GAAG,CAAC,IAAI,CACN,OAAO,EACP,mBAAmB,GAAG,yDAAyD,CAChF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAgCD,SAAS,QAAQ;IACf,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAwB,EACxB,YAAuC,EAAE;IAEzC,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhF,0EAA0E;IAC1E,oEAAoE;IACpE,sEAAsE;IACtE,gCAAgC;IAChC,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAExD,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEtD,0EAA0E;IAC1E,2EAA2E;IAC3E,0EAA0E;IAC1E,wEAAwE;IACxE,yEAAyE;IACzE,sBAAsB;IACtB,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,8BAA8B,QAAQ,GAAG,EACzC,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,sBAAsB,CAAC;QACtC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE;QACF,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,IAAI;KACL,CAAC,CAAC;IAEH,wEAAwE;IACxE,qDAAqD;IACrD,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,sEAAsE;QACtE,qEAAqE;QACrE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,8BAA8B,QAAQ,GAAG,EACzC,2HAA2H,CAC5H,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,oBAAoB,CAAC;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,QAAQ;QACrB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,IAAI,EAAE,SAAS,CAAC,IAAI;KACrB,CAAC,CAAC;IAEH,OAAO;QACL,EAAE;QACF,QAAQ;QACR,QAAQ;QACR,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;QACjD,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC"}

package/dist/utils/governance.test.js

@@ -45,9 +45,12 @@ describe('resolveGovernancePaths', () => {
     });
     it('resolves standalone strategy path when submodule prefix is missing', async () => {
         initGit(tmpDir);
-        // Standalone strategy repo — `proposals/active/` lives at the git root, no `.strategy/` prefix.
+        // Standalone strategy repo — `adr/` lives at the git root, no `.strategy/` prefix.
+        // `templates/` sentinel at the root distinguishes a real strategy repo from a
+        // consumer repo that happens to ship a top-level `adr/` docs folder.
         fs.mkdirSync(path.join(tmpDir, 'proposals', 'active'), { recursive: true });
         fs.mkdirSync(path.join(tmpDir, 'adr'), { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, 'templates'), { recursive: true });
         const { resolveGovernancePaths } = await import('./governance.js');
         const paths = resolveGovernancePaths(tmpDir, 'adr');
         expect(paths.rootDir).toBe(path.normalize(tmpDir));
@@ -55,6 +58,15 @@ describe('resolveGovernancePaths', () => {
         expect(paths.dashboardFile).toBe(path.normalize(path.join(tmpDir, 'README.md')));
         expect(paths.templatePath).toBe(path.normalize(path.join(tmpDir, 'templates', 'adr.md')));
     });
+    it('rejects standalone false-positive when a consumer repo has only adr/ without templates/', async () => {
+        initGit(tmpDir);
+        // Consumer repo with a top-level `adr/` docs folder but NO `templates/`
+        // and NO sibling/submodule strategy. Pre-tightening, this would have
+        // false-positively scaffolded into the consumer's adr/ folder.
+        fs.mkdirSync(path.join(tmpDir, 'adr'), { recursive: true });
+        const { resolveGovernancePaths } = await import('./governance.js');
+        expect(() => resolveGovernancePaths(tmpDir, 'adr')).toThrow(/strategy/i);
+    });
     it('throws TotemError when cwd is not inside a git repository', async () => {
         // tmpDir has no `.git/`; resolveGitRoot returns null.
         const { resolveGovernancePaths } = await import('./governance.js');
@@ -66,6 +78,53 @@ describe('resolveGovernancePaths', () => {
         const { resolveGovernancePaths } = await import('./governance.js');
         expect(() => resolveGovernancePaths(tmpDir, 'proposal')).toThrow(/strategy/i);
     });
+    it('error message names the canonical sibling clone path and env var (mmnto-ai/totem#1710)', async () => {
+        initGit(tmpDir);
+        const { resolveGovernancePaths } = await import('./governance.js');
+        let caught;
+        try {
+            resolveGovernancePaths(tmpDir, 'proposal');
+        }
+        catch (err) {
+            caught = err;
+        }
+        const totemErr = caught;
+        const combined = `${totemErr.message ?? ''}\n${totemErr.recoveryHint ?? ''}`;
+        expect(combined).toMatch(/totem-strategy/i);
+        expect(combined).toMatch(/TOTEM_STRATEGY_ROOT/);
+    });
+    it('resolves sibling strategy path via the resolver when ../totem-strategy exists (mmnto-ai/totem#1710)', async () => {
+        // Layout:
+        //   <parent>/repo/.git/   ← gitRoot (created via initGit)
+        //   <parent>/totem-strategy/proposals/active/
+        const repo = path.join(tmpDir, 'repo');
+        fs.mkdirSync(repo, { recursive: true });
+        initGit(repo);
+        const sibling = path.join(tmpDir, 'totem-strategy');
+        fs.mkdirSync(path.join(sibling, 'proposals', 'active'), { recursive: true });
+        const { resolveGovernancePaths } = await import('./governance.js');
+        const paths = resolveGovernancePaths(repo, 'proposal');
+        expect(paths.rootDir).toBe(path.normalize(sibling));
+        expect(paths.targetDir).toBe(path.normalize(path.join(sibling, 'proposals', 'active')));
+    });
+    it('resolves env-driven strategy path when TOTEM_STRATEGY_ROOT is set (mmnto-ai/totem#1710)', async () => {
+        initGit(tmpDir);
+        const elsewhere = path.join(tmpDir, 'elsewhere-strategy');
+        fs.mkdirSync(path.join(elsewhere, 'proposals', 'active'), { recursive: true });
+        const prev = process.env.TOTEM_STRATEGY_ROOT;
+        process.env.TOTEM_STRATEGY_ROOT = elsewhere;
+        try {
+            const { resolveGovernancePaths } = await import('./governance.js');
+            const paths = resolveGovernancePaths(tmpDir, 'proposal');
+            expect(paths.rootDir).toBe(path.normalize(elsewhere));
+        }
+        finally {
+            if (prev === undefined)
+                delete process.env.TOTEM_STRATEGY_ROOT;
+            else
+                process.env.TOTEM_STRATEGY_ROOT = prev;
+        }
+    });
 });
 describe('getNextArtifactId', () => {
     let tmpDir;
@@ -383,6 +442,7 @@ describe('scaffoldGovernanceArtifact (orchestrator)', () => {
         initGit(tmpDir);
         fs.mkdirSync(path.join(tmpDir, 'proposals', 'active'), { recursive: true });
         fs.mkdirSync(path.join(tmpDir, 'adr'), { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, 'templates'), { recursive: true });
         const calls = [];
         const exec = (cmd, args) => {
             calls.push({ cmd, args });
@@ -409,6 +469,7 @@ describe('scaffoldGovernanceArtifact (orchestrator)', () => {
         initGit(tmpDir);
         fs.mkdirSync(path.join(tmpDir, 'proposals', 'active'), { recursive: true });
         fs.mkdirSync(path.join(tmpDir, 'adr'), { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, 'templates'), { recursive: true });
         const exec = () => { };
         const { scaffoldGovernanceArtifact } = await import('./governance.js');
         const result = scaffoldGovernanceArtifact({ type: 'adr', title: 'Database Sharding', cwd: tmpDir }, { exec, date: '2026-04-21' });
@@ -425,6 +486,7 @@ describe('scaffoldGovernanceArtifact (orchestrator)', () => {
         // template body see the cleaned form.
         initGit(tmpDir);
         fs.mkdirSync(path.join(tmpDir, 'proposals', 'active'), { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, 'templates'), { recursive: true });
         const exec = () => { };
         const { scaffoldGovernanceArtifact } = await import('./governance.js');
         const result = scaffoldGovernanceArtifact({
@@ -445,6 +507,7 @@ describe('scaffoldGovernanceArtifact (orchestrator)', () => {
     it('creates file on disk even when docs:inject is missing', async () => {
         initGit(tmpDir);
         fs.mkdirSync(path.join(tmpDir, 'proposals', 'active'), { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, 'templates'), { recursive: true });
         const origWarn = console.error;
         console.error = () => { };
         try {
@@ -467,6 +530,7 @@ describe('scaffoldGovernanceArtifact (orchestrator)', () => {
         initGit(tmpDir);
         const target = path.join(tmpDir, 'proposals', 'active');
         fs.mkdirSync(target, { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, 'templates'), { recursive: true });
         fs.writeFileSync(path.join(target, '001-alpha.md'), '# a\n', 'utf-8');
         fs.writeFileSync(path.join(target, '003-beta.md'), '# b\n', 'utf-8');
         const { scaffoldGovernanceArtifact } = await import('./governance.js');
@@ -478,6 +542,7 @@ describe('scaffoldGovernanceArtifact (orchestrator)', () => {
         initGit(tmpDir);
         const target = path.join(tmpDir, 'proposals', 'active');
         fs.mkdirSync(target, { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, 'templates'), { recursive: true });
         // Seed with the exact filename the scaffolder would generate for this title:
         // id=001 + slug='collide' ⇒ '001-collide.md'. We force this by ALSO seeding a
         // higher-numbered file so getNextArtifactId returns 002, then we seed 002-collide.md
@@ -509,6 +574,7 @@ describe('scaffoldGovernanceArtifact (orchestrator)', () => {
     it('throws TotemError BEFORE touching disk when title sanitizes to empty', async () => {
         initGit(tmpDir);
         fs.mkdirSync(path.join(tmpDir, 'proposals', 'active'), { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, 'templates'), { recursive: true });
         const execCalls = [];
         const exec = (cmd) => {
             execCalls.push(cmd);
@@ -522,4 +588,61 @@ describe('scaffoldGovernanceArtifact (orchestrator)', () => {
         expect(entries).toEqual([]);
     });
 });
+describe('loadGovernanceConfig (mmnto-ai/totem#1710 R3 — global config leak)', () => {
+    let tmpDir;
+    let homeDir;
+    let originalCwd;
+    let originalHomeEnv;
+    let originalUserprofile;
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+        homeDir = makeTmpDir('totem-home-');
+        originalCwd = process.cwd();
+        // os.homedir() reads HOME on POSIX and USERPROFILE on Windows; redirect
+        // both so the test runs cross-platform without leaking a real
+        // ~/.totem/ profile into the assertion.
+        originalHomeEnv = process.env['HOME'];
+        originalUserprofile = process.env['USERPROFILE'];
+        process.env['HOME'] = homeDir;
+        process.env['USERPROFILE'] = homeDir;
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        if (originalHomeEnv === undefined) {
+            delete process.env['HOME'];
+        }
+        else {
+            process.env['HOME'] = originalHomeEnv;
+        }
+        if (originalUserprofile === undefined) {
+            delete process.env['USERPROFILE'];
+        }
+        else {
+            process.env['USERPROFILE'] = originalUserprofile;
+        }
+        cleanTmpDir(tmpDir);
+        cleanTmpDir(homeDir);
+    });
+    it('returns undefined when the resolved config lives in the global ~/.totem/ profile', async () => {
+        // No local config in tmpDir — so resolveConfigPath walks up to the
+        // global ~/.totem/ profile. A user's personal global config
+        // typically encodes tier/embedder choices, NOT a strategy pointer
+        // for one specific repo. Loading it for governance scaffolding
+        // would let one user's strategyRoot leak across every repo on disk.
+        initGit(tmpDir);
+        const globalTotemDir = path.join(homeDir, '.totem');
+        fs.mkdirSync(globalTotemDir, { recursive: true });
+        fs.writeFileSync(path.join(globalTotemDir, 'totem.config.ts'), "export default { targets: [{ glob: '**/*.ts', type: 'code', strategy: 'typescript-ast' }], strategyRoot: '/some/personal/strategy' };\n", 'utf-8');
+        const { loadGovernanceConfig } = await import('./governance.js');
+        const config = await loadGovernanceConfig(tmpDir);
+        expect(config).toBeUndefined();
+    });
+    it('returns the local config when one exists in cwd', async () => {
+        initGit(tmpDir);
+        fs.writeFileSync(path.join(tmpDir, 'totem.config.ts'), "export default { targets: [{ glob: '**/*.ts', type: 'code', strategy: 'typescript-ast' }], strategyRoot: '../totem-strategy' };\n", 'utf-8');
+        const { loadGovernanceConfig } = await import('./governance.js');
+        const config = await loadGovernanceConfig(tmpDir);
+        expect(config?.strategyRoot).toBe('../totem-strategy');
+    });
+});
 //# sourceMappingURL=governance.test.js.map