canopycms 0.0.0

package/dist/operating-mode/client-unsafe-strategy.js

@@ -0,0 +1,234 @@
+/**
+ * Client-Unsafe Operating Mode Strategies
+ *
+ * Full strategy implementations that extend client-safe base classes.
+ * INCLUDES Node.js imports (fs, path, process) - can only be imported server-side.
+ *
+ * These classes inherit all client-safe methods and add client-unsafe functionality.
+ */
+import path from 'node:path';
+import { ProdClientSafeStrategy, LocalProdSimClientSafeStrategy, LocalSimpleClientSafeStrategy, } from './client-safe-strategy';
+import { DEFAULT_PROD_WORKSPACE } from '../config';
+// ============================================================================
+// Production Mode - Full Strategy
+// ============================================================================
+class ProdStrategy extends ProdClientSafeStrategy {
+    // All client-safe methods inherited automatically from ProdClientSafeStrategy:
+    // - mode, supportsBranching(), supportsStatusBadge(), supportsComments()
+    // - supportsPullRequests(), getPermissionsFileName(), getGroupsFileName()
+    // - shouldCommit(), shouldPush()
+    // Add client-unsafe methods (use Node.js APIs)
+    getContentRoot(sourceRoot) {
+        // In prod, content is at workspace root (not project root)
+        // This is called with sourceRoot = workspace path
+        return path.resolve(sourceRoot ?? process.cwd(), 'content');
+    }
+    getContentBranchesRoot(_sourceRoot) {
+        const envWorkspace = process.env.CANOPYCMS_WORKSPACE_ROOT;
+        const workspace = path.resolve(envWorkspace ?? DEFAULT_PROD_WORKSPACE);
+        return path.join(workspace, 'content-branches');
+    }
+    getContentBranchRoot(branchName, sourceRoot) {
+        return path.resolve(this.getContentBranchesRoot(sourceRoot), branchName);
+    }
+    getGitExcludePattern() {
+        return '.canopy-meta/';
+    }
+    getPermissionsFilePath(root) {
+        return path.join(root, this.getPermissionsFileName());
+    }
+    getGroupsFilePath(root) {
+        return path.join(root, this.getGroupsFileName());
+    }
+    getRemoteUrlConfig() {
+        const envWorkspace = process.env.CANOPYCMS_WORKSPACE_ROOT;
+        const workspace = path.resolve(envWorkspace ?? DEFAULT_PROD_WORKSPACE);
+        return {
+            shouldAutoInitLocal: false,
+            defaultRemotePath: '',
+            envVarName: 'CANOPYCMS_REMOTE_URL',
+            autoDetectRemotePath: path.join(workspace, 'remote.git'),
+        };
+    }
+    requiresExistingRepo() {
+        return false; // Will clone if needed
+    }
+    getSettingsBranchName(config) {
+        if (config.settingsBranch)
+            return config.settingsBranch;
+        const deploymentName = config.deploymentName ?? 'prod';
+        return `canopycms-settings-${deploymentName}`;
+    }
+    getSettingsRoot(_sourceRoot) {
+        const envWorkspace = process.env.CANOPYCMS_WORKSPACE_ROOT;
+        const workspace = path.resolve(envWorkspace ?? DEFAULT_PROD_WORKSPACE);
+        return path.join(workspace, 'settings');
+    }
+    usesSeparateSettingsBranch() {
+        return true;
+    }
+    validateConfig(config) {
+        if (!config.gitBotAuthorName || !config.gitBotAuthorEmail) {
+            throw new Error('gitBotAuthorName and gitBotAuthorEmail are required in prod mode');
+        }
+    }
+    shouldCreateSettingsPR(config) {
+        return config.autoCreateSettingsPR ?? true;
+    }
+}
+// ============================================================================
+// Local Production Simulation - Full Strategy
+// ============================================================================
+class LocalProdSimStrategy extends LocalProdSimClientSafeStrategy {
+    // Inherits client-safe methods from LocalProdSimClientSafeStrategy
+    getProdSimRoot(sourceRoot) {
+        return path.resolve(sourceRoot ?? process.cwd(), '.canopy-prod-sim');
+    }
+    getContentRoot(sourceRoot) {
+        return path.resolve(sourceRoot ?? process.cwd(), 'content');
+    }
+    getContentBranchesRoot(sourceRoot) {
+        return path.join(this.getProdSimRoot(sourceRoot), 'content-branches');
+    }
+    getContentBranchRoot(branchName, sourceRoot) {
+        return path.resolve(this.getContentBranchesRoot(sourceRoot), branchName);
+    }
+    getGitExcludePattern() {
+        return '.canopy-meta/';
+    }
+    getPermissionsFilePath(root) {
+        return path.join(root, this.getPermissionsFileName());
+    }
+    getGroupsFilePath(root) {
+        return path.join(root, this.getGroupsFileName());
+    }
+    getRemoteUrlConfig() {
+        return {
+            shouldAutoInitLocal: true,
+            defaultRemotePath: '.canopy-prod-sim/remote.git',
+            envVarName: 'CANOPYCMS_REMOTE_URL',
+        };
+    }
+    requiresExistingRepo() {
+        return false;
+    }
+    getSettingsBranchName(config) {
+        if (config.settingsBranch)
+            return config.settingsBranch;
+        const deploymentName = config.deploymentName ?? 'prod';
+        return `canopycms-settings-${deploymentName}`;
+    }
+    getSettingsRoot(sourceRoot) {
+        return path.join(this.getProdSimRoot(sourceRoot), 'settings');
+    }
+    usesSeparateSettingsBranch() {
+        return true;
+    }
+    validateConfig(_config) {
+        // No special validation for prod-sim
+    }
+    shouldCreateSettingsPR(_config) {
+        return false; // No real GitHub in simulation
+    }
+}
+// ============================================================================
+// Local Simple Mode - Full Strategy
+// ============================================================================
+class LocalSimpleStrategy extends LocalSimpleClientSafeStrategy {
+    // Inherits: supportsBranching() returns false, getPermissionsFileName() returns 'permissions.local.json'
+    getDevConfigRoot(sourceRoot) {
+        return path.resolve(sourceRoot ?? process.cwd(), '.canopy-dev');
+    }
+    getContentRoot(sourceRoot) {
+        return path.resolve(sourceRoot ?? process.cwd(), 'content');
+    }
+    getContentBranchesRoot(_sourceRoot) {
+        throw new Error('No branching in dev mode');
+    }
+    getContentBranchRoot(_branchName, _sourceRoot) {
+        throw new Error('No branching in dev mode');
+    }
+    getGitExcludePattern() {
+        return '.canopy-meta/';
+    }
+    getPermissionsFilePath(root) {
+        // Returns: {projectRoot}/.canopy-dev/settings/permissions.json
+        return path.join(this.getDevConfigRoot(root), 'settings', 'permissions.json');
+    }
+    getGroupsFilePath(root) {
+        // Returns: {projectRoot}/.canopy-dev/settings/groups.json
+        return path.join(this.getDevConfigRoot(root), 'settings', 'groups.json');
+    }
+    getRemoteUrlConfig() {
+        return {
+            shouldAutoInitLocal: false,
+            defaultRemotePath: '',
+            envVarName: 'CANOPYCMS_REMOTE_URL',
+        };
+    }
+    requiresExistingRepo() {
+        return true; // Must have existing repo
+    }
+    getSettingsBranchName(config) {
+        // Use main branch for settings in dev (no separate settings branch)
+        return config.defaultBaseBranch ?? 'main';
+    }
+    getSettingsRoot(sourceRoot) {
+        return path.join(this.getDevConfigRoot(sourceRoot), 'settings');
+    }
+    usesSeparateSettingsBranch() {
+        return false;
+    }
+    validateConfig(_config) {
+        // No special validation for dev
+    }
+    shouldCreateSettingsPR(_config) {
+        return false; // No GitHub in dev
+    }
+}
+// ============================================================================
+// Factory with Memoization
+// ============================================================================
+const strategyCache = new Map();
+/**
+ * Get the full strategy (client-unsafe) for an operating mode.
+ *
+ * Strategies are memoized - one instance per mode for the entire process lifetime.
+ * Safe to call inline: operatingStrategy(mode).getBaseRoot()
+ *
+ * Includes all client-safe methods (inherited) plus client-unsafe methods (Node.js APIs).
+ *
+ * @param mode - The operating mode
+ * @returns Full strategy instance with client-unsafe methods
+ */
+export function operatingStrategy(mode) {
+    const cached = strategyCache.get(mode);
+    if (cached)
+        return cached;
+    let strategy;
+    switch (mode) {
+        case 'prod':
+            strategy = new ProdStrategy();
+            break;
+        case 'prod-sim':
+            strategy = new LocalProdSimStrategy();
+            break;
+        case 'dev':
+            strategy = new LocalSimpleStrategy();
+            break;
+        default: {
+            // Exhaustiveness check - TypeScript will error if a mode is not handled
+            const _exhaustive = mode;
+            throw new Error(`Unknown operating mode: ${_exhaustive}`);
+        }
+    }
+    strategyCache.set(mode, strategy);
+    return strategy;
+}
+/**
+ * Clear the strategy cache (mainly for testing)
+ */
+export function clearStrategyCache() {
+    strategyCache.clear();
+}
+//# sourceMappingURL=client-unsafe-strategy.js.map

package/dist/operating-mode/client-unsafe-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-unsafe-strategy.js","sourceRoot":"","sources":["../../src/operating-mode/client-unsafe-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAElD,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;AAE/E,MAAM,YAAa,SAAQ,sBAAsB;IAC/C,+EAA+E;IAC/E,yEAAyE;IACzE,0EAA0E;IAC1E,iCAAiC;IAEjC,+CAA+C;IAE/C,cAAc,CAAC,UAAmB;QAChC,2DAA2D;QAC3D,kDAAkD;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7D,CAAC;IAED,sBAAsB,CAAC,WAAoB;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAA;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAC,CAAA;QACtE,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAA;IACjD,CAAC;IAED,oBAAoB,CAAC,UAAkB,EAAE,UAAmB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAA;IAC1E,CAAC;IAED,oBAAoB;QAClB,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,sBAAsB,CAAC,IAAY;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,iBAAiB,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAClD,CAAC;IAED,kBAAkB;QAChB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAA;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAC,CAAA;QACtE,OAAO;YACL,mBAAmB,EAAE,KAAK;YAC1B,iBAAiB,EAAE,EAAE;YACrB,UAAU,EAAE,sBAAsB;YAClC,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC;SACzD,CAAA;IACH,CAAC;IAED,oBAAoB;QAClB,OAAO,KAAK,CAAA,CAAC,uBAAuB;IACtC,CAAC;IAED,qBAAqB,CAAC,MAIrB;QACC,IAAI,MAAM,CAAC,cAAc;YAAE,OAAO,MAAM,CAAC,cAAc,CAAA;QACvD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAA;QACtD,OAAO,sBAAsB,cAAc,EAAE,CAAA;IAC/C,CAAC;IAED,eAAe,CAAC,WAAoB;QAClC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAA;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAC,CAAA;QACtE,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACzC,CAAC;IAED,0BAA0B;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,cAAc,CAAC,MAA6B;QAC1C,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;QACrF,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,MAA0C;QAC/D,OAAO,MAAM,CAAC,oBAAoB,IAAI,IAAI,CAAA;IAC5C,CAAC;CACF;AAED,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E;AAE/E,MAAM,oBAAqB,SAAQ,8BAA8B;IAC/D,mEAAmE;IAE3D,cAAc,CAAC,UAAmB;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAA;IACtE,CAAC;IAED,cAAc,CAAC,UAAmB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7D,CAAC;IAED,sBAAsB,CAAC,UAAmB;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC,CAAA;IACvE,CAAC;IAED,oBAAoB,CAAC,UAAkB,EAAE,UAAmB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAA;IAC1E,CAAC;IAED,oBAAoB;QAClB,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,sBAAsB,CAAC,IAAY;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,iBAAiB,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAClD,CAAC;IAED,kBAAkB;QAChB,OAAO;YACL,mBAAmB,EAAE,IAAI;YACzB,iBAAiB,EAAE,6BAA6B;YAChD,UAAU,EAAE,sBAAsB;SACnC,CAAA;IACH,CAAC;IAED,oBAAoB;QAClB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,qBAAqB,CAAC,MAIrB;QACC,IAAI,MAAM,CAAC,cAAc;YAAE,OAAO,MAAM,CAAC,cAAc,CAAA;QACvD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAA;QACtD,OAAO,sBAAsB,cAAc,EAAE,CAAA;IAC/C,CAAC;IAED,eAAe,CAAC,UAAmB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAA;IAC/D,CAAC;IAED,0BAA0B;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,cAAc,CAAC,OAA8B;QAC3C,qCAAqC;IACvC,CAAC;IAED,sBAAsB,CAAC,OAA2C;QAChE,OAAO,KAAK,CAAA,CAAC,+BAA+B;IAC9C,CAAC;CACF;AAED,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E,MAAM,mBAAoB,SAAQ,6BAA6B;IAC7D,yGAAyG;IAEjG,gBAAgB,CAAC,UAAmB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAA;IACjE,CAAC;IAED,cAAc,CAAC,UAAmB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7D,CAAC;IAED,sBAAsB,CAAC,WAAoB;QACzC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC7C,CAAC;IAED,oBAAoB,CAAC,WAAmB,EAAE,WAAoB;QAC5D,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC7C,CAAC;IAED,oBAAoB;QAClB,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,sBAAsB,CAAC,IAAY;QACjC,+DAA+D;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAA;IAC/E,CAAC;IAED,iBAAiB,CAAC,IAAY;QAC5B,0DAA0D;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,CAAA;IAC1E,CAAC;IAED,kBAAkB;QAChB,OAAO;YACL,mBAAmB,EAAE,KAAK;YAC1B,iBAAiB,EAAE,EAAE;YACrB,UAAU,EAAE,sBAAsB;SACnC,CAAA;IACH,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAA,CAAC,0BAA0B;IACxC,CAAC;IAED,qBAAqB,CAAC,MAIrB;QACC,oEAAoE;QACpE,OAAO,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAA;IAC3C,CAAC;IAED,eAAe,CAAC,UAAmB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAA;IACjE,CAAC;IAED,0BAA0B;QACxB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,cAAc,CAAC,OAA8B;QAC3C,gCAAgC;IAClC,CAAC;IAED,sBAAsB,CAAC,OAA2C;QAChE,OAAO,KAAK,CAAA,CAAC,mBAAmB;IAClC,CAAC;CACF;AAED,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuC,CAAA;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAmB;IACnD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,QAA8B,CAAA;IAClC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAA;YAC7B,MAAK;QACP,KAAK,UAAU;YACb,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAA;YACrC,MAAK;QACP,KAAK,KAAK;YACR,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAA;YACpC,MAAK;QACP,OAAO,CAAC,CAAC,CAAC;YACR,wEAAwE;YACxE,MAAM,WAAW,GAAU,IAAI,CAAA;YAC/B,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IAED,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACjC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,aAAa,CAAC,KAAK,EAAE,CAAA;AACvB,CAAC"}

package/dist/operating-mode/client.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Client-Safe Operating Mode Strategy - Client Bundle Entry Point
+ *
+ * This module ONLY exports client-safe functionality with NO Node.js imports.
+ * Safe to import in 'use client' React components.
+ *
+ * Usage in client components:
+ *   import { clientOperatingStrategy } from '@/operating-mode/client'
+ */
+export { clientOperatingStrategy, clearClientStrategyCache } from './client-safe-strategy';
+export type { ClientSafeStrategy } from './types';
+export type { OperatingMode } from './types';
+//# sourceMappingURL=client.d.ts.map

package/dist/operating-mode/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/operating-mode/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAC1F,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA"}

package/dist/operating-mode/client.js

@@ -0,0 +1,11 @@
+/**
+ * Client-Safe Operating Mode Strategy - Client Bundle Entry Point
+ *
+ * This module ONLY exports client-safe functionality with NO Node.js imports.
+ * Safe to import in 'use client' React components.
+ *
+ * Usage in client components:
+ *   import { clientOperatingStrategy } from '@/operating-mode/client'
+ */
+export { clientOperatingStrategy, clearClientStrategyCache } from './client-safe-strategy';
+//# sourceMappingURL=client.js.map

package/dist/operating-mode/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/operating-mode/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/operating-mode/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Operating Mode Strategy Pattern - Public API
+ *
+ * Two-layer architecture:
+ * 1. Client-safe strategies - safe for 'use client' React components (no Node.js imports)
+ * 2. Client-unsafe strategies - full server-side functionality (uses fs, path, process)
+ *
+ * Usage:
+ *
+ * Client components:
+ *   import { clientOperatingStrategy } from '@/operating-mode'
+ *   const strategy = clientOperatingStrategy(mode)
+ *   if (strategy.supportsBranching()) { ... }
+ *
+ * Server code:
+ *   import { operatingStrategy } from '@/operating-mode'
+ *   const strategy = operatingStrategy(mode)
+ *   const contentRoot = strategy.getContentRoot()
+ *   const branchesRoot = strategy.getContentBranchesRoot() // throws in dev mode
+ *   const branchRoot = strategy.getContentBranchRoot('my-branch') // throws in dev mode
+ *   const settingsRoot = strategy.getSettingsRoot()
+ *   if (strategy.supportsBranching()) { ... } // can also use client-safe methods
+ */
+export { clientOperatingStrategy, clearClientStrategyCache } from './client-safe-strategy';
+export { operatingStrategy, clearStrategyCache } from './client-unsafe-strategy';
+export type OperatingMode = 'prod' | 'prod-sim' | 'dev';
+export type { ClientSafeStrategy, ClientUnsafeStrategy, ResolveRemoteUrlOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/operating-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operating-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAG1F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAEhF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAA;AAGvD,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA"}

package/dist/operating-mode/index.js

@@ -0,0 +1,28 @@
+/**
+ * Operating Mode Strategy Pattern - Public API
+ *
+ * Two-layer architecture:
+ * 1. Client-safe strategies - safe for 'use client' React components (no Node.js imports)
+ * 2. Client-unsafe strategies - full server-side functionality (uses fs, path, process)
+ *
+ * Usage:
+ *
+ * Client components:
+ *   import { clientOperatingStrategy } from '@/operating-mode'
+ *   const strategy = clientOperatingStrategy(mode)
+ *   if (strategy.supportsBranching()) { ... }
+ *
+ * Server code:
+ *   import { operatingStrategy } from '@/operating-mode'
+ *   const strategy = operatingStrategy(mode)
+ *   const contentRoot = strategy.getContentRoot()
+ *   const branchesRoot = strategy.getContentBranchesRoot() // throws in dev mode
+ *   const branchRoot = strategy.getContentBranchRoot('my-branch') // throws in dev mode
+ *   const settingsRoot = strategy.getSettingsRoot()
+ *   if (strategy.supportsBranching()) { ... } // can also use client-safe methods
+ */
+// Client-safe factory and strategy (safe for client bundles)
+export { clientOperatingStrategy, clearClientStrategyCache } from './client-safe-strategy';
+// Client-unsafe factory and strategy (server-side only)
+export { operatingStrategy, clearStrategyCache } from './client-unsafe-strategy';
+//# sourceMappingURL=index.js.map

package/dist/operating-mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operating-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,6DAA6D;AAC7D,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAE1F,wDAAwD;AACxD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/operating-mode/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Operating Mode Strategy Types
+ *
+ * This module defines the two-layer strategy pattern for operating modes:
+ * - ClientSafeStrategy: Methods safe for client-side bundles (no Node.js APIs)
+ * - ClientUnsafeStrategy: Full strategy with Node.js APIs (server-side only)
+ */
+import type { OperatingMode as OM } from '.';
+import type { CanopyConfig } from '../config';
+export type OperatingMode = OM;
+/**
+ * Options for resolving git remote URL
+ */
+export interface ResolveRemoteUrlOptions {
+    mode: OperatingMode;
+    remoteUrl?: string;
+    defaultRemoteUrl?: string;
+    baseBranch?: string;
+    sourceRoot?: string;
+}
+/**
+ * Configuration for remote URL resolution
+ * Strategies return this data; GitManager executes the logic
+ */
+export interface RemoteUrlConfig {
+    /** Whether to auto-initialize a local remote */
+    shouldAutoInitLocal: boolean;
+    /** Default path for local remote (e.g., '.canopycms/remote.git') */
+    defaultRemotePath: string;
+    /** Environment variable name for remote URL */
+    envVarName: string;
+    /**
+     * Absolute path to check for auto-detection of a pre-existing local remote.
+     * If this path exists on disk, it's used as the remote URL (file:// protocol).
+     * Used in prod mode where the EC2 worker creates remote.git on EFS.
+     * Unlike shouldAutoInitLocal, this does NOT create the remote — just detects it.
+     */
+    autoDetectRemotePath?: string;
+}
+/**
+ * Client-Safe Strategy
+ *
+ * Methods that can be safely imported in 'use client' React components.
+ * NO Node.js APIs (fs, path, process, etc.) - only pure logic and simple data.
+ */
+export interface ClientSafeStrategy {
+    /** The operating mode this strategy represents */
+    readonly mode: OperatingMode;
+    /** Whether this mode supports multiple branch workspaces */
+    supportsBranching(): boolean;
+    /** Whether to show status badge in UI */
+    supportsStatusBadge(): boolean;
+    /** Whether comments/collaboration features are enabled */
+    supportsComments(): boolean;
+    /** Whether pull request features are available */
+    supportsPullRequests(): boolean;
+    /** Get the permissions file name (e.g., 'permissions.json' or 'permissions.local.json') */
+    getPermissionsFileName(): string;
+    /** Get the groups file name (e.g., 'groups.json' or 'groups.local.json') */
+    getGroupsFileName(): string;
+    /** Whether git commits should be made in this mode */
+    shouldCommit(): boolean;
+    /** Whether git pushes should be made in this mode */
+    shouldPush(): boolean;
+}
+/**
+ * Client-Unsafe Strategy
+ *
+ * Full strategy including Node.js APIs. Can only be imported server-side.
+ * Extends ClientSafeStrategy, so all client-safe methods are available.
+ */
+export interface ClientUnsafeStrategy extends ClientSafeStrategy {
+    /**
+     * Get the content directory path (at project/workspace root).
+     * - dev/prod-sim: {cwd}/content
+     * - prod (in workspaces): {workspaceRoot}/content
+     */
+    getContentRoot(sourceRoot?: string): string;
+    /**
+     * Get the parent directory of all content branch workspaces (contains branches.json and branch directories).
+     * - prod-sim: {cwd}/.canopy-prod-sim/content-branches
+     * - prod: $CANOPYCMS_WORKSPACE_ROOT/content-branches or /mnt/efs/workspace/content-branches
+     * @throws Error in dev mode (no branching)
+     */
+    getContentBranchesRoot(sourceRoot?: string): string;
+    /**
+     * Get individual content branch workspace directory.
+     * Returns: {contentBranchesRoot}/{branchName}
+     * @throws Error in dev mode (no branching)
+     */
+    getContentBranchRoot(branchName: string, sourceRoot?: string): string;
+    /**
+     * Get the git exclude pattern for runtime metadata (e.g., '.canopy-meta/').
+     * Used by GitManager to add to .git/info/exclude in content branch workspaces.
+     */
+    getGitExcludePattern(): string;
+    /** Get the full path to the permissions file */
+    getPermissionsFilePath(root: string): string;
+    /** Get the full path to the groups file */
+    getGroupsFilePath(root: string): string;
+    /** Get configuration for remote URL resolution (GitManager executes the logic) */
+    getRemoteUrlConfig(): RemoteUrlConfig;
+    /** Whether this mode requires an existing git repository */
+    requiresExistingRepo(): boolean;
+    /**
+     * Get the branch name to use for settings (permissions/groups).
+     * Returns: canopycms-settings-{deploymentName}
+     */
+    getSettingsBranchName(config: {
+        settingsBranch?: string;
+        deploymentName?: string;
+        defaultBaseBranch?: string;
+    }): string;
+    /**
+     * Get the root directory for settings storage.
+     * - prod: $CANOPYCMS_WORKSPACE_ROOT/settings or /mnt/efs/workspace/settings
+     * - prod-sim: {cwd}/.canopy-prod-sim/settings
+     * - dev: {cwd}/.canopy-dev/settings
+     */
+    getSettingsRoot(sourceRoot?: string): string;
+    /** Whether settings should be stored in a separate branch */
+    usesSeparateSettingsBranch(): boolean;
+    /** Validate configuration for this mode */
+    validateConfig(config: Partial<CanopyConfig>): void;
+    /** Whether PRs should be auto-created for permissions/groups changes */
+    shouldCreateSettingsPR(config: {
+        autoCreateSettingsPR?: boolean;
+    }): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/operating-mode/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/operating-mode/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,IAAI,EAAE,EAAE,MAAM,GAAG,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAG7C,MAAM,MAAM,aAAa,GAAG,EAAE,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,aAAa,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,mBAAmB,EAAE,OAAO,CAAA;IAC5B,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,CAAA;IACzB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAM5B,4DAA4D;IAC5D,iBAAiB,IAAI,OAAO,CAAA;IAE5B,yCAAyC;IACzC,mBAAmB,IAAI,OAAO,CAAA;IAE9B,0DAA0D;IAC1D,gBAAgB,IAAI,OAAO,CAAA;IAE3B,kDAAkD;IAClD,oBAAoB,IAAI,OAAO,CAAA;IAM/B,2FAA2F;IAC3F,sBAAsB,IAAI,MAAM,CAAA;IAEhC,4EAA4E;IAC5E,iBAAiB,IAAI,MAAM,CAAA;IAE3B,sDAAsD;IACtD,YAAY,IAAI,OAAO,CAAA;IAEvB,qDAAqD;IACrD,UAAU,IAAI,OAAO,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAK9D;;;;OAIG;IACH,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAE3C;;;;;OAKG;IACH,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAEnD;;;;OAIG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAErE;;;OAGG;IACH,oBAAoB,IAAI,MAAM,CAAA;IAM9B,gDAAgD;IAChD,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAE5C,2CAA2C;IAC3C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAMvC,kFAAkF;IAClF,kBAAkB,IAAI,eAAe,CAAA;IAErC,4DAA4D;IAC5D,oBAAoB,IAAI,OAAO,CAAA;IAM/B;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE;QAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAC3B,GAAG,MAAM,CAAA;IAEV;;;;;OAKG;IACH,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAE5C,6DAA6D;IAC7D,0BAA0B,IAAI,OAAO,CAAA;IAMrC,2CAA2C;IAC3C,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAA;IAMnD,wEAAwE;IACxE,sBAAsB,CAAC,MAAM,EAAE;QAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAA;CAC5E"}

package/dist/operating-mode/types.js

@@ -0,0 +1,9 @@
+/**
+ * Operating Mode Strategy Types
+ *
+ * This module defines the two-layer strategy pattern for operating modes:
+ * - ClientSafeStrategy: Methods safe for client-side bundles (no Node.js APIs)
+ * - ClientUnsafeStrategy: Full strategy with Node.js APIs (server-side only)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/operating-mode/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/operating-mode/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/paths/branch.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Branch path resolution utilities.
+ *
+ * Handles resolving branch names to workspace directories.
+ */
+import type { BranchContext } from '../types';
+import { OperatingMode } from '../operating-mode';
+import type { SanitizedBranchName } from './types';
+export interface BranchPathOptions {
+    mode: OperatingMode;
+    branchName: string;
+    basePathOverride?: string;
+}
+export interface BranchPathResult {
+    branchRoot: string;
+    baseRoot: string;
+    branchName: string;
+}
+export declare class BranchPathError extends Error {
+}
+/**
+ * Sanitize a branch name for use in filesystem paths.
+ * - Replaces invalid characters with hyphens
+ * - Collapses multiple hyphens
+ * - Trims leading/trailing dots
+ */
+export declare function sanitizeBranchName(branchName: string): SanitizedBranchName;
+/**
+ * Resolve branch name to workspace paths.
+ * Validates for path traversal attacks.
+ */
+export declare function resolveBranchPath(options: BranchPathOptions): BranchPathResult;
+/**
+ * Ensure the branch workspace directory exists.
+ */
+export declare function ensureBranchRoot(options: BranchPathOptions): Promise<BranchPathResult>;
+/**
+ * Get the default base directory for branch workspaces.
+ */
+export declare function getDefaultBranchBase(mode: OperatingMode, override?: string): string;
+/**
+ * Resolve branch paths from a branch context.
+ */
+export declare function resolveBranchPaths(branchContext: BranchContext, mode: OperatingMode, basePathOverride?: string): BranchPathResult;
+//# sourceMappingURL=branch.d.ts.map

package/dist/paths/branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/paths/branch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAqB,MAAM,mBAAmB,CAAA;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAElD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAK1E;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAuB9E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAI5F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,aAAa,EACnB,gBAAgB,CAAC,EAAE,MAAM,GACxB,gBAAgB,CAkBlB"}

package/dist/paths/branch.js

@@ -0,0 +1,84 @@
+/**
+ * Branch path resolution utilities.
+ *
+ * Handles resolving branch names to workspace directories.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { operatingStrategy } from '../operating-mode';
+export class BranchPathError extends Error {
+}
+/**
+ * Sanitize a branch name for use in filesystem paths.
+ * - Replaces invalid characters with hyphens
+ * - Collapses multiple hyphens
+ * - Trims leading/trailing dots
+ */
+export function sanitizeBranchName(branchName) {
+    const replaced = branchName.replace(/[^a-zA-Z0-9._-]/g, '-');
+    const squashed = replaced.replace(/-+/g, '-');
+    const trimmedDots = squashed.replace(/^\.+/, '').replace(/\.+$/, '');
+    return (trimmedDots || 'branch');
+}
+const resolveContentBranchesRoot = (mode, override) => {
+    return operatingStrategy(mode).getContentBranchesRoot(override);
+};
+/**
+ * Resolve branch name to workspace paths.
+ * Validates for path traversal attacks.
+ */
+export function resolveBranchPath(options) {
+    if (options.branchName.includes('..')) {
+        throw new BranchPathError('Branch name cannot contain traversal segments');
+    }
+    const safeBranch = sanitizeBranchName(options.branchName);
+    const strategy = operatingStrategy(options.mode);
+    const baseRoot = resolveContentBranchesRoot(options.mode, options.basePathOverride);
+    const normalizedBase = path.resolve(baseRoot);
+    const baseWithSep = normalizedBase.endsWith(path.sep)
+        ? normalizedBase
+        : `${normalizedBase}${path.sep}`;
+    const branchRoot = strategy.getContentBranchRoot(safeBranch, options.basePathOverride);
+    const withinBase = (target) => {
+        const resolved = path.resolve(target);
+        return resolved === normalizedBase || resolved.startsWith(baseWithSep);
+    };
+    if (!withinBase(branchRoot)) {
+        throw new BranchPathError('Branch path resolves outside the base root');
+    }
+    return { branchRoot, baseRoot: normalizedBase, branchName: safeBranch };
+}
+/**
+ * Ensure the branch workspace directory exists.
+ */
+export async function ensureBranchRoot(options) {
+    const result = resolveBranchPath(options);
+    await fs.mkdir(result.branchRoot, { recursive: true });
+    return result;
+}
+/**
+ * Get the default base directory for branch workspaces.
+ */
+export function getDefaultBranchBase(mode, override) {
+    return resolveContentBranchesRoot(mode, override);
+}
+/**
+ * Resolve branch paths from a branch context.
+ */
+export function resolveBranchPaths(branchContext, mode, basePathOverride) {
+    if (branchContext.branchRoot || branchContext.baseRoot) {
+        const baseRoot = path.resolve(branchContext.baseRoot ?? resolveContentBranchesRoot(mode, basePathOverride));
+        const branchRoot = path.resolve(branchContext.branchRoot ?? baseRoot);
+        return {
+            branchRoot,
+            baseRoot,
+            branchName: sanitizeBranchName(branchContext.branch.name),
+        };
+    }
+    return resolveBranchPath({
+        mode,
+        branchName: branchContext.branch.name,
+        basePathOverride,
+    });
+}
+//# sourceMappingURL=branch.js.map

package/dist/paths/branch.js.map

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

package/dist/paths/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Path utilities for CanopyCMS
+ *
+ * This module consolidates path handling utilities that were previously
+ * scattered across multiple files:
+ * - normalize.ts: Path normalization and creation
+ * - validation.ts: Security validation for paths
+ * - branch.ts: Branch workspace path resolution
+ * - types.ts: Branded types for type safety
+ *
+ * Usage:
+ * ```ts
+ * import { normalizeFilesystemPath, createLogicalPath, parseSlug } from '../paths'
+ * ```
+ */
+export type { LogicalPath, PhysicalPath, SanitizedBranchName, BranchName, ContentId, CollectionSlug, EntrySlug, PathValidationResult, } from './types';
+export { normalizeFilesystemPath, normalizeCollectionPath, hasTraversalSequence, createLogicalPath, createPhysicalPath, joinPath, } from './normalize';
+export { validateAndNormalizePath } from './normalize-server';
+export { validateContentPath, isValidCollectionPath, sanitizeForPath, hasEmbeddedContentId, looksLikePhysicalPath, looksLikeLogicalPath, parseLogicalPath, parsePhysicalPath, isValidContentId, parseContentId, parseBranchName, parseSlug, } from './validation';
+export { resolveLogicalPath } from './resolve';
+export { resolveBranchPath, ensureBranchRoot, getDefaultBranchBase, resolveBranchPaths, sanitizeBranchName, BranchPathError, type BranchPathOptions, type BranchPathResult, } from './branch';
+//# sourceMappingURL=index.d.ts.map