agentic-workflow-manager 2.0.1 → 2.1.0

package/dist/src/commands/doctor.js

@@ -9,6 +9,7 @@ exports.registerDoctorCommand = registerDoctorCommand;
 const picocolors_1 = __importDefault(require("picocolors"));
 const context_1 = require("../core/diagnostics/context");
 const checks_1 = require("../core/diagnostics/checks");
+const paths_1 = require("../core/paths");
 function glyph(status) {
     if (status === 'ok')
         return picocolors_1.default.green('✔');
@@ -33,6 +34,7 @@ function renderReport(report) {
     lines.push(picocolors_1.default.bold('AWM · harness status'));
     lines.push('');
     lines.push('Machine (global)');
+    lines.push(picocolors_1.default.dim(`  platform: ${(0, paths_1.platformLabel)()}`));
     for (const r of report.results.filter((x) => x.level === 'machine'))
         lines.push(line(r));
     lines.push('');

package/dist/src/commands/hooks/install.js

@@ -8,6 +8,7 @@ exports.installHook = installHook;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const providers_1 = require("../../providers");
+const paths_1 = require("../../core/paths");
 function syncFile(source, dest, method) {
     try {
         fs_1.default.unlinkSync(dest);
@@ -26,8 +27,7 @@ function syncFile(source, dest, method) {
 function backupSettings(settingsPath) {
     if (!fs_1.default.existsSync(settingsPath))
         return null;
-    const awmHome = process.env.AWM_HOME || path_1.default.join(process.env.HOME, '.awm');
-    const backupDir = path_1.default.join(awmHome, 'backups');
+    const backupDir = path_1.default.join((0, paths_1.awmHome)(), 'backups');
     fs_1.default.mkdirSync(backupDir, { recursive: true });
     const ts = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '-').slice(0, 19);
     const backupPath = path_1.default.join(backupDir, `settings.json.${ts}.bak`);
@@ -57,13 +57,19 @@ function installHook(options) {
     fs_1.default.mkdirSync(config.scriptsDir, { recursive: true });
     syncFile(path_1.default.join(sourceHooks, 'session-start'), path_1.default.join(config.scriptsDir, 'session-start'), options.installMethod);
     syncFile(path_1.default.join(sourceHooks, 'run-hook.cmd'), path_1.default.join(config.scriptsDir, 'run-hook.cmd'), options.installMethod);
-    // 3. Symlink the skill (ALWAYS symlink so awm update propagates)
+    // 3. Link the skill (default: symlink so 'awm update' propagates; fall back to copy if symlink is unavailable, e.g. Windows without Developer Mode)
     const skillDest = path_1.default.join(config.scriptsDir, 'using-awm.md');
     try {
         fs_1.default.unlinkSync(skillDest);
     }
     catch { /* not exists */ }
-    fs_1.default.symlinkSync(sourceSkill, skillDest);
+    try {
+        fs_1.default.symlinkSync(sourceSkill, skillDest);
+    }
+    catch {
+        // best-effort: copy the single skill file; 'awm update' will not auto-propagate
+        fs_1.default.copyFileSync(sourceSkill, skillDest);
+    }
     // 4. Backup settings if it exists
     const backupPath = backupSettings(config.settingsPath);
     // 5. Read or initialize settings

package/dist/src/commands/hooks/uninstall.js

@@ -7,11 +7,11 @@ exports.uninstallHook = uninstallHook;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const providers_1 = require("../../providers");
+const paths_1 = require("../../core/paths");
 function backupSettings(settingsPath) {
     if (!fs_1.default.existsSync(settingsPath))
         return null;
-    const awmHome = process.env.AWM_HOME || path_1.default.join(process.env.HOME, '.awm');
-    const backupDir = path_1.default.join(awmHome, 'backups');
+    const backupDir = path_1.default.join((0, paths_1.awmHome)(), 'backups');
     fs_1.default.mkdirSync(backupDir, { recursive: true });
     const ts = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '-').slice(0, 19);
     const backupPath = path_1.default.join(backupDir, `settings.json.${ts}.bak`);

package/dist/src/commands/init.js

@@ -49,6 +49,7 @@ const bundles_1 = require("../core/bundles");
 const registries_1 = require("../core/registries");
 const orchestrator_1 = require("../core/init/orchestrator");
 const steps_1 = require("../core/init/steps");
+const paths_1 = require("../core/paths");
 // ---------------------------------------------------------------------------
 // Rendering
 // ---------------------------------------------------------------------------
@@ -170,6 +171,7 @@ function registerInitCommand(program) {
         .option('--machine-only', 'Only run machine-level steps (skip project steps)')
         .option('--json', 'Emit the InitOutcome as JSON')
         .action(async (options) => {
+        (0, paths_1.warnIfUnsupportedPlatform)((m) => console.warn(picocolors_1.default.yellow(`⚠ ${m}`)));
         const code = await runInit({
             yes: options.yes,
             agent: options.agent,

package/dist/src/commands/sensors/formatters/eslint.js

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseEslintOutput = parseEslintOutput;
+const path_1 = __importDefault(require("path"));
 function parseEslintOutput(raw) {
     let parsed;
     try {
@@ -15,7 +19,9 @@ function parseEslintOutput(raw) {
         for (const msg of file.messages) {
             if (msg.severity < 2 || msg.line == null || msg.column == null)
                 continue;
-            const rel = file.filePath.startsWith(cwd + '/') ? file.filePath.slice(cwd.length + 1) : file.filePath;
+            const rel = file.filePath.startsWith(cwd + path_1.default.sep)
+                ? path_1.default.relative(cwd, file.filePath)
+                : file.filePath;
             errors.push({
                 file: rel,
                 line: msg.line,

package/dist/src/commands/sensors/install.js

@@ -7,12 +7,12 @@ exports.installSensorHook = installSensorHook;
 exports.uninstallSensorHook = uninstallSensorHook;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
+const paths_1 = require("../../core/paths");
 const POST_TOOL_USE_EVENT = 'PostToolUse';
 const POST_TOOL_USE_MATCHER = 'Write|Edit|MultiEdit';
 const AWM_SENSOR_CMD = 'awm sensors run --fast';
 function defaultSettingsPath() {
-    return path_1.default.join(process.env.HOME ?? os_1.default.homedir(), '.claude', 'settings.json');
+    return path_1.default.join((0, paths_1.homeDir)(), '.claude', 'settings.json');
 }
 function readSettings(p) {
     if (!fs_1.default.existsSync(p))
@@ -31,8 +31,7 @@ function isAwmEntry(e) {
 function backupSettings(settingsPath) {
     if (!fs_1.default.existsSync(settingsPath))
         return undefined;
-    const awmHome = process.env.AWM_HOME || path_1.default.join(process.env.HOME ?? os_1.default.homedir(), '.awm');
-    const backupDir = path_1.default.join(awmHome, 'backups');
+    const backupDir = path_1.default.join((0, paths_1.awmHome)(), 'backups');
     fs_1.default.mkdirSync(backupDir, { recursive: true });
     const ts = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '-').slice(0, 19);
     const backupPath = path_1.default.join(backupDir, `settings.json.${ts}.sensor.bak`);

package/dist/src/core/context/materializer.js

@@ -7,14 +7,11 @@ exports.globalContextPath = globalContextPath;
 exports.materialize = materialize;
 // cli/src/core/context/materializer.ts
 const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const provider_1 = require("./provider");
-function awmHome() {
-    return process.env.AWM_HOME || path_1.default.join(process.env.HOME || os_1.default.homedir(), '.awm');
-}
+const paths_1 = require("../paths");
 function globalContextPath() {
-    return path_1.default.join(awmHome(), 'context', 'awm-context.md');
+    return path_1.default.join((0, paths_1.awmHome)(), 'context', 'awm-context.md');
 }
 function materialize(ctx, absPath, scope) {
     let onDisk = null;

package/dist/src/core/diagnostics/context.js

@@ -6,7 +6,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.gatherContext = gatherContext;
 // src/core/diagnostics/context.ts
 const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
 const providers_1 = require("../../providers");
@@ -16,8 +15,7 @@ const status_1 = require("../../commands/hooks/status");
 const profile_1 = require("../profile");
 const bundles_1 = require("../bundles");
 const skill_integrity_1 = require("../skill-integrity");
-function home() { return process.env.HOME || os_1.default.homedir(); }
-function awmHome() { return process.env.AWM_HOME || path_1.default.join(home(), '.awm'); }
+const paths_1 = require("../paths");
 // Estado de un artefacto en <dir>/<skill>: link vivo / symlink colgante / ausente.
 function linkState(dir, skill) {
     const p = path_1.default.join(dir, skill);
@@ -122,7 +120,7 @@ function gatherMachine(bundles, agent = 'claude-code') {
     // ambient (deseados desde ~/.awm/config.json)
     let wanted = [];
     try {
-        const cfg = JSON.parse(fs_1.default.readFileSync(path_1.default.join(awmHome(), 'config.json'), 'utf-8'));
+        const cfg = JSON.parse(fs_1.default.readFileSync(path_1.default.join((0, paths_1.awmHome)(), 'config.json'), 'utf-8'));
         if (Array.isArray(cfg.ambient)) {
             wanted = cfg.ambient.filter((x) => typeof x === 'string');
         }

package/dist/src/core/paths.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WINDOWS_NATIVE_WARNING = void 0;
+exports.homeDir = homeDir;
+exports.awmHome = awmHome;
+exports.platform = platform;
+exports.isWindowsNative = isWindowsNative;
+exports.platformLabel = platformLabel;
+exports.warnIfUnsupportedPlatform = warnIfUnsupportedPlatform;
+// cli/src/core/paths.ts
+//
+// Single source of truth for home / AWM_HOME resolution and platform detection.
+// Functions are evaluated at CALL TIME (not require time) so env overrides are
+// always honored and tests need no jest.resetModules().
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/** User home directory with a robust fallback. Never returns a raw, possibly-empty process.env.HOME. */
+function homeDir() {
+    return process.env.HOME || os_1.default.homedir();
+}
+/** AWM home directory (~/.awm), honoring the AWM_HOME override. */
+function awmHome() {
+    return process.env.AWM_HOME || path_1.default.join(homeDir(), '.awm');
+}
+/** Raw platform string (wrapper over process.platform for testability). */
+function platform() {
+    return process.platform;
+}
+/** True only on native Windows. WSL reports 'linux', so this returns false there. */
+function isWindowsNative() {
+    return platform() === 'win32';
+}
+/** Human-friendly platform label for diagnostics. */
+function platformLabel() {
+    switch (platform()) {
+        case 'win32':
+            return 'Windows (native — not supported yet, use WSL)';
+        case 'darwin':
+            return 'macOS';
+        case 'linux':
+            return 'Linux';
+        default:
+            return platform();
+    }
+}
+exports.WINDOWS_NATIVE_WARNING = 'AWM detected native Windows. Native support is deferred; the recommended path today is WSL.\n' +
+    '  Install WSL (https://learn.microsoft.com/windows/wsl/install) and run AWM inside your Linux distro.\n' +
+    '  Continuing in best-effort mode, but some steps (symlinks, hooks) may not work.';
+/** Emit the unsupported-platform warning via the provided logger, only on native Windows. */
+function warnIfUnsupportedPlatform(log) {
+    if (isWindowsNative())
+        log(exports.WINDOWS_NATIVE_WARNING);
+}

package/dist/src/core/registries.js

@@ -19,13 +19,13 @@ exports.verifyMinCliVersions = verifyMinCliVersions;
 // src/core/registries.ts
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
 const simple_git_1 = __importDefault(require("simple-git"));
 const registry_1 = require("./registry");
 const versioning_1 = require("./versioning");
 const cli_version_1 = require("./cli-version");
-// Evaluated at require-time — tests must use jest.resetModules() + late require() to pick up env overrides.
-const AWM_HOME = process.env.AWM_HOME || path_1.default.join(process.env.HOME || os_1.default.homedir(), '.awm');
+const paths_1 = require("./paths");
+// Computed at require-time by calling the shared resolver (single source of truth: core/paths.ts).
+const AWM_HOME = (0, paths_1.awmHome)();
 exports.REGISTRIES_DIR = path_1.default.join(AWM_HOME, 'registries');
 exports.REGISTRIES_CONFIG_PATH = path_1.default.join(AWM_HOME, 'registries.json');
 exports.CONTENT_DIR_NAMES = ['skills', 'bundles', 'workflows', 'agents'];

package/dist/src/core/update-check.js

@@ -16,17 +16,16 @@ exports.offerSelfUpdate = offerSelfUpdate;
 // `awm update`. AWM_NO_UPDATE_CHECK=1 desactiva ambas (tests, CI).
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
 const child_process_1 = require("child_process");
 const picocolors_1 = __importDefault(require("picocolors"));
 const prompts_1 = require("@clack/prompts");
 const cli_version_1 = require("./cli-version");
 const versioning_1 = require("./versioning");
+const paths_1 = require("./paths");
 const TTL_MS = 24 * 60 * 60 * 1000;
 const REGISTRY_URL = `https://registry.npmjs.org/${cli_version_1.CLI_PACKAGE_NAME}/latest`;
 function cacheFile() {
-    const home = process.env.AWM_HOME || path_1.default.join(process.env.HOME || os_1.default.homedir(), '.awm');
-    return path_1.default.join(home, 'update-check.json');
+    return path_1.default.join((0, paths_1.awmHome)(), 'update-check.json');
 }
 function readUpdateCache() {
     try {

package/dist/src/index.js

@@ -34,6 +34,7 @@ const registry_1 = require("./commands/registry");
 const pin_1 = require("./commands/pin");
 const profile_pins_1 = require("./core/profile-pins");
 const update_check_1 = require("./core/update-check");
+const paths_1 = require("./core/paths");
 const program = new commander_1.Command();
 program.name('awm').description('Agentic Workflow Manager').version((0, cli_version_1.cliVersion)());
 program.hook('postAction', () => {
@@ -359,6 +360,7 @@ program.command('sync')
     .option('-m, --method <method>', 'Install method: symlink or copy', 'symlink')
     .action(async (options) => {
     (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Sync Project Profile ')));
+    (0, paths_1.warnIfUnsupportedPlatform)((m) => console.warn(picocolors_1.default.yellow(`⚠ ${m}`)));
     const projectRoot = (0, profile_1.findProjectRoot)(process.cwd());
     if (!projectRoot) {
         console.error(picocolors_1.default.red('No project root found (need a .git/, package.json, or .awm/profile.json here).'));

package/dist/src/providers/index.js

@@ -8,10 +8,10 @@ exports.getTargetPath = getTargetPath;
 exports.getHookConfig = getHookConfig;
 exports.getInjection = getInjection;
 // src/providers/index.ts
-const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
-const homedir = process.env.HOME || os_1.default.homedir();
-const awmHome = process.env.AWM_HOME || path_1.default.join(homedir, '.awm');
+const paths_1 = require("../core/paths");
+const homedir = (0, paths_1.homeDir)();
+const awmHomeDir = (0, paths_1.awmHome)();
 exports.PROVIDERS = {
     antigravity: {
         label: 'Antigravity',
@@ -38,7 +38,7 @@ exports.PROVIDERS = {
         hooks: {
             type: 'cc-settings-merge',
             settingsPath: path_1.default.join(homedir, '.claude/settings.json'),
-            scriptsDir: path_1.default.join(awmHome, 'hooks'),
+            scriptsDir: path_1.default.join(awmHomeDir, 'hooks'),
             matcher: 'startup|clear|compact',
             eventName: 'SessionStart'
         },

package/dist/src/utils/config.js

@@ -8,14 +8,14 @@ exports.savePreferences = savePreferences;
 // src/utils/config.ts
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
+const paths_1 = require("../core/paths");
 const DEFAULT_PREFS = {
     defaultAgent: 'antigravity',
     installMethod: 'symlink',
     defaultScope: 'local'
 };
 function prefsDir() {
-    return process.env.AWM_HOME || path_1.default.join(process.env.HOME || os_1.default.homedir(), '.awm');
+    return (0, paths_1.awmHome)();
 }
 function getPreferences() {
     const file = path_1.default.join(prefsDir(), 'preferences.json');

package/dist/tests/commands/doctor-platform.test.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const doctor_1 = require("../../src/commands/doctor");
+describe('doctor renderReport — platform line', () => {
+    const realPlatform = process.platform;
+    afterEach(() => {
+        Object.defineProperty(process, 'platform', { value: realPlatform, configurable: true });
+    });
+    function emptyReport() {
+        return { overall: 'healthy', hasProject: false, projectName: undefined, results: [] };
+    }
+    it('renders the platform label under the Machine header', () => {
+        Object.defineProperty(process, 'platform', { value: 'linux', configurable: true });
+        const out = (0, doctor_1.renderReport)(emptyReport());
+        expect(out).toContain('platform: Linux');
+    });
+    it('flags native Windows with a WSL hint', () => {
+        Object.defineProperty(process, 'platform', { value: 'win32', configurable: true });
+        const out = (0, doctor_1.renderReport)(emptyReport());
+        expect(out).toContain('WSL');
+    });
+});

package/dist/tests/commands/hooks/install-symlink-fallback.test.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+describe('hooks/install — skill symlink fallback to copy', () => {
+    let tmpHome;
+    let origHome;
+    let origAwmHome;
+    let symlinkSpy;
+    beforeEach(() => {
+        tmpHome = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'awm-symlink-fb-'));
+        origHome = process.env.HOME;
+        origAwmHome = process.env.AWM_HOME;
+        process.env.HOME = tmpHome;
+        process.env.AWM_HOME = path_1.default.join(tmpHome, '.awm');
+        jest.resetModules();
+    });
+    afterEach(() => {
+        symlinkSpy?.mockRestore();
+        fs_1.default.rmSync(tmpHome, { recursive: true, force: true });
+        if (origHome === undefined)
+            delete process.env.HOME;
+        else
+            process.env.HOME = origHome;
+        if (origAwmHome === undefined)
+            delete process.env.AWM_HOME;
+        else
+            process.env.AWM_HOME = origAwmHome;
+    });
+    function seedRegistry(root) {
+        const hooksDir = path_1.default.join(root, 'hooks');
+        const skillDir = path_1.default.join(root, 'skills', 'using-awm');
+        fs_1.default.mkdirSync(hooksDir, { recursive: true });
+        fs_1.default.mkdirSync(skillDir, { recursive: true });
+        fs_1.default.writeFileSync(path_1.default.join(hooksDir, 'session-start'), '#!/bin/sh\n');
+        fs_1.default.writeFileSync(path_1.default.join(hooksDir, 'run-hook.cmd'), '#!/bin/sh\n');
+        fs_1.default.writeFileSync(path_1.default.join(skillDir, 'SKILL.md'), '# using-awm\n');
+    }
+    it('copies the skill when symlink throws (EPERM), preserving content', () => {
+        const registryRoot = path_1.default.join(tmpHome, 'registry');
+        seedRegistry(registryRoot);
+        // Force symlinkSync to fail like a platform without symlink permission.
+        symlinkSpy = jest.spyOn(fs_1.default, 'symlinkSync').mockImplementation(() => {
+            const err = new Error('EPERM: operation not permitted, symlink');
+            err.code = 'EPERM';
+            throw err;
+        });
+        const { installHook } = require('../../../src/commands/hooks/install');
+        const result = installHook({ agent: 'claude-code', registryRoot, installMethod: 'copy' });
+        const skillDest = path_1.default.join(result.scriptsDir, 'using-awm.md');
+        expect(fs_1.default.existsSync(skillDest)).toBe(true);
+        expect(fs_1.default.lstatSync(skillDest).isSymbolicLink()).toBe(false); // it was copied, not linked
+        expect(fs_1.default.readFileSync(skillDest, 'utf-8')).toContain('using-awm');
+    });
+});

package/dist/tests/commands/sensors/eslint-formatter.test.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const eslint_1 = require("../../../src/commands/sensors/formatters/eslint");
+describe('parseEslintOutput — relative path normalization', () => {
+    it('produces a cwd-relative path using the OS separator', () => {
+        const cwd = process.cwd();
+        const abs = path_1.default.join(cwd, 'src', 'foo.ts');
+        const raw = JSON.stringify([
+            { filePath: abs, messages: [{ ruleId: 'no-eval', severity: 2, message: 'no eval', line: 3, column: 1 }] },
+        ]);
+        const errors = (0, eslint_1.parseEslintOutput)(raw);
+        expect(errors).toHaveLength(1);
+        const first = errors[0];
+        if (!first)
+            throw new Error('Expected at least one error');
+        // path.join('src','foo.ts') uses the OS separator; on POSIX this is 'src/foo.ts'
+        expect(first.file).toBe(path_1.default.join('src', 'foo.ts'));
+        const file = first.file ?? '';
+        expect(file.startsWith(path_1.default.sep)).toBe(false); // genuinely relative
+    });
+    it('preserves the absolute path for files outside cwd', () => {
+        const abs = '/some/other/project/file.ts';
+        const raw = JSON.stringify([
+            { filePath: abs, messages: [{ ruleId: 'no-eval', severity: 2, message: 'no eval', line: 1, column: 1 }] },
+        ]);
+        const errors = (0, eslint_1.parseEslintOutput)(raw);
+        expect(errors).toHaveLength(1);
+        expect(errors[0]?.file).toBe(abs); // absolute path preserved, no traversal strings
+    });
+});

package/dist/tests/core/paths.test.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const paths_1 = require("../../src/core/paths");
+describe('core/paths', () => {
+    let origHome;
+    let origAwmHome;
+    const realPlatform = process.platform;
+    beforeEach(() => {
+        origHome = process.env.HOME;
+        origAwmHome = process.env.AWM_HOME;
+    });
+    afterEach(() => {
+        if (origHome === undefined)
+            delete process.env.HOME;
+        else
+            process.env.HOME = origHome;
+        if (origAwmHome === undefined)
+            delete process.env.AWM_HOME;
+        else
+            process.env.AWM_HOME = origAwmHome;
+        Object.defineProperty(process, 'platform', { value: realPlatform, configurable: true });
+    });
+    function setPlatform(p) {
+        Object.defineProperty(process, 'platform', { value: p, configurable: true });
+    }
+    it('homeDir uses process.env.HOME when set', () => {
+        process.env.HOME = '/tmp/fake-home';
+        expect((0, paths_1.homeDir)()).toBe('/tmp/fake-home');
+    });
+    it('homeDir falls back to os.homedir() when HOME is unset', () => {
+        delete process.env.HOME;
+        expect((0, paths_1.homeDir)()).toBe(os_1.default.homedir());
+    });
+    it('awmHome honors AWM_HOME override', () => {
+        process.env.AWM_HOME = '/tmp/custom-awm';
+        expect((0, paths_1.awmHome)()).toBe('/tmp/custom-awm');
+    });
+    it('awmHome defaults to <home>/.awm when AWM_HOME is unset', () => {
+        delete process.env.AWM_HOME;
+        process.env.HOME = '/tmp/fake-home';
+        expect((0, paths_1.awmHome)()).toBe(path_1.default.join('/tmp/fake-home', '.awm'));
+    });
+    it('platform reflects process.platform', () => {
+        setPlatform('linux');
+        expect((0, paths_1.platform)()).toBe('linux');
+    });
+    it('isWindowsNative is true only on win32', () => {
+        setPlatform('win32');
+        expect((0, paths_1.isWindowsNative)()).toBe(true);
+        setPlatform('linux');
+        expect((0, paths_1.isWindowsNative)()).toBe(false);
+        setPlatform('darwin');
+        expect((0, paths_1.isWindowsNative)()).toBe(false);
+    });
+    it('platformLabel describes each known platform', () => {
+        setPlatform('linux');
+        expect((0, paths_1.platformLabel)()).toBe('Linux');
+        setPlatform('darwin');
+        expect((0, paths_1.platformLabel)()).toBe('macOS');
+        setPlatform('win32');
+        expect((0, paths_1.platformLabel)()).toContain('WSL');
+    });
+    it('warnIfUnsupportedPlatform calls the logger only on win32', () => {
+        const calls = [];
+        const log = (m) => calls.push(m);
+        setPlatform('linux');
+        (0, paths_1.warnIfUnsupportedPlatform)(log);
+        expect(calls).toHaveLength(0);
+        setPlatform('win32');
+        (0, paths_1.warnIfUnsupportedPlatform)(log);
+        expect(calls).toEqual([paths_1.WINDOWS_NATIVE_WARNING]);
+    });
+});

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "agentic-workflow-manager",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "main": "dist/src/index.js",
   "bin": {
     "awm": "./dist/src/index.js"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Kodria/agentic-workflow.git",