agentic-workflow-manager 2.0.1 → 2.1.1

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

@@ -9,6 +9,8 @@ const commander_1 = require("commander");
 const config_1 = require("./utils/config");
 const grouping_1 = require("./utils/grouping");
 const registry_view_1 = require("./utils/registry-view");
+const tty_1 = require("./ui/tty");
+const picker_1 = require("./ui/picker");
 const providers_1 = require("./providers");
 const executor_1 = require("./core/executor");
 const regenerate_1 = require("./core/context/regenerate");
@@ -34,6 +36,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', () => {
@@ -72,6 +75,7 @@ program.command('add [name]')
     .option('-s, --scope <scope>', 'Scope: local or global')
     .option('-m, --method <method>', 'Install method: symlink or copy')
     .option('-y, --yes', 'Skip confirmation prompts')
+    .option('--all', 'install all artifacts from all packages without prompting')
     .action(async (name, options) => {
     (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Agentic Workflow Manager ')));
     // 1. Sync the registry
@@ -141,6 +145,10 @@ program.command('add [name]')
             (0, prompts_1.outro)(`✅ Installed bundle ${picocolors_1.default.cyan(matchedBundle.name)}:\n  ${lines}${recordNote}`);
             return;
         }
+        // name given but no matching bundle found — report clearly regardless of TTY
+        console.error(picocolors_1.default.red(`Bundle "${name}" not found in registry.`));
+        console.error(picocolors_1.default.dim('Run `awm list` to see available packages.'));
+        process.exit(1);
     }
     // 2. Discover artifacts
     const skills = (0, discovery_1.discoverSkills)();
@@ -151,6 +159,103 @@ program.command('add [name]')
         process.exit(0);
     }
     const prefs = (0, config_1.getPreferences)();
+    // --all: install everything from every package headlessly
+    if (options.all) {
+        let targetAgents;
+        if (options.agent) {
+            const validAgents = Object.keys(providers_1.PROVIDERS);
+            const parsed = options.agent.split(',').map((a) => a.trim());
+            for (const a of parsed) {
+                if (!validAgents.includes(a)) {
+                    console.error(picocolors_1.default.red(`Invalid agent "${a}". Use: ${validAgents.join(', ')}.`));
+                    process.exit(1);
+                }
+            }
+            targetAgents = parsed;
+        }
+        else {
+            targetAgents = [prefs.defaultAgent];
+        }
+        let scopeVal;
+        if (options.scope) {
+            if (!['local', 'global'].includes(options.scope)) {
+                console.error(picocolors_1.default.red(`Invalid scope "${options.scope}". Use: local or global.`));
+                process.exit(1);
+            }
+            scopeVal = options.scope;
+        }
+        else {
+            scopeVal = prefs.defaultScope;
+        }
+        let methodVal;
+        if (options.method) {
+            if (!['symlink', 'copy'].includes(options.method)) {
+                console.error(picocolors_1.default.red(`Invalid method "${options.method}". Use: symlink or copy.`));
+                process.exit(1);
+            }
+            methodVal = options.method;
+        }
+        else {
+            methodVal = scopeVal === 'local' ? 'copy' : 'symlink';
+        }
+        const includeWorkflows = targetAgents.some((a) => providers_1.PROVIDERS[a].workflow !== null);
+        const includeAgents = targetAgents.some((a) => providers_1.PROVIDERS[a].agent !== null);
+        const allView = (0, registry_view_1.buildPackageView)(skills, includeWorkflows ? workflows : [], includeAgents ? agents : [], (0, bundles_1.discoverAllBundles)());
+        const allDedup = new Map();
+        for (const pkg of allView) {
+            for (const a of pkg.artifacts) {
+                allDedup.set((0, registry_view_1.artifactValue)(a), a);
+            }
+        }
+        const artifactsToInstall = Array.from(allDedup.values()).map((a) => ({
+            name: a.installName,
+            sourcePath: a.sourcePath,
+            type: a.type,
+        }));
+        if (artifactsToInstall.length === 0) {
+            (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts available.'));
+            return;
+        }
+        const installSpinner = (0, prompts_1.spinner)();
+        installSpinner.start('Installing artifacts...');
+        try {
+            const installed = [];
+            const skipped = [];
+            for (const currentAgent of targetAgents) {
+                for (const artifact of artifactsToInstall) {
+                    if (providers_1.PROVIDERS[currentAgent][artifact.type] === null) {
+                        skipped.push(`${artifact.name} (${currentAgent})`);
+                        continue;
+                    }
+                    const targetDir = (0, providers_1.getTargetPath)(artifact.type, currentAgent, scopeVal);
+                    const finalDest = path_1.default.join(targetDir, artifact.name);
+                    (0, executor_1.installArtifact)(artifact.sourcePath, finalDest, methodVal);
+                    installed.push(`${artifact.name} → ${currentAgent} (${scopeVal})`);
+                }
+            }
+            (0, config_1.savePreferences)({ defaultAgent: targetAgents[0], defaultScope: scopeVal, installMethod: methodVal });
+            installSpinner.stop('Installation complete!');
+            if (skipped.length > 0) {
+                for (const sk of skipped) {
+                    console.log(picocolors_1.default.yellow(`  ⚠️  Skipped: ${sk} (not supported by target agent)`));
+                }
+            }
+            const names = installed.map((n) => picocolors_1.default.green(n)).join('\n  ');
+            (0, prompts_1.outro)(`✅ Installed:\n  ${names}`);
+        }
+        catch (e) {
+            installSpinner.stop('Installation failed.');
+            console.error(picocolors_1.default.red(e.message));
+            process.exit(1);
+        }
+        return;
+    }
+    // Interactive selection requires a TTY. Bundle-by-name (handled above) works headless.
+    if (!(0, tty_1.isInteractive)()) {
+        console.error(picocolors_1.default.red('`awm add` needs an interactive terminal for selection.'));
+        console.error(picocolors_1.default.dim('Install a bundle non-interactively: `awm add <bundle>` (optionally with --agent/--scope).'));
+        process.exit(1);
+    }
     // 3. Agent & Scope Prompts (Moved up)
     let targetAgents;
     if (options.agent) {
@@ -206,27 +311,35 @@ program.command('add [name]')
         process.exit(0);
     }
     // 5. Level 1 — pick package(s)
-    const pkgChoice = await (0, prompts_1.multiselect)({
-        message: 'Select package(s)',
-        options: (0, registry_view_1.buildLevel1Options)(view),
-        required: true
+    const pickedPackages = await (0, picker_1.multiselectPicker)({
+        title: 'Select package(s)',
+        items: (0, registry_view_1.packagePickerItems)(view),
     });
-    handleCancel(pkgChoice);
-    const selectedPackages = pkgChoice
-        .map(name => view.find(p => p.name === name))
+    if (pickedPackages === null) {
+        (0, prompts_1.outro)('Operation cancelled.');
+        process.exit(0);
+    }
+    if (pickedPackages.length === 0) {
+        (0, prompts_1.outro)(picocolors_1.default.yellow('No packages selected.'));
+        return;
+    }
+    const selectedPackages = pickedPackages
+        .map((name) => view.find((p) => p.name === name))
         .filter(Boolean);
     // 5b. Level 2 — pick skills within each package, in sequence
     const dedup = new Map();
     for (let i = 0; i < selectedPackages.length; i++) {
         const pkg = selectedPackages[i];
-        const skillChoice = await (0, prompts_1.multiselect)({
-            message: `[${i + 1}/${selectedPackages.length}] ${pkg.name} — select artifacts`,
-            options: (0, registry_view_1.buildLevel2Options)(pkg),
-            initialValues: [registry_view_1.ALL_SENTINEL],
-            required: true
+        const picked = await (0, picker_1.multiselectPicker)({
+            title: `[${i + 1}/${selectedPackages.length}] ${pkg.name} — select artifacts`,
+            items: (0, registry_view_1.artifactPickerItems)(pkg),
+            initialSelected: [registry_view_1.ALL_SENTINEL, ...pkg.artifacts.map((a) => (0, registry_view_1.artifactValue)(a))],
         });
-        handleCancel(skillChoice);
-        for (const a of (0, registry_view_1.resolveLevel2Selection)(pkg, skillChoice)) {
+        if (picked === null) {
+            (0, prompts_1.outro)('Operation cancelled.');
+            process.exit(0);
+        }
+        for (const a of (0, registry_view_1.resolveLevel2Selection)(pkg, picked)) {
             dedup.set((0, registry_view_1.artifactValue)(a), a);
         }
     }
@@ -359,6 +472,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).'));
@@ -467,6 +581,7 @@ program.command('list [package]')
     if (packageName && options.all) {
         console.log(picocolors_1.default.dim('(Ignoring --all when a package name is provided.)'));
     }
+    const listWidth = process.stdout.isTTY ? process.stdout.columns : undefined;
     // Detail for a single package.
     if (packageName) {
         const { match, suggestion } = (0, registry_view_1.findPackage)(fullView, packageName);
@@ -478,7 +593,7 @@ program.command('list [package]')
             process.exit(1);
         }
         console.log();
-        for (const line of (0, registry_view_1.packageDetailLines)(match))
+        for (const line of (0, registry_view_1.packageDetailLines)(match, listWidth))
             console.log(line);
         console.log();
         (0, prompts_1.outro)(`Run ${picocolors_1.default.green(`awm add`)} to install artifacts from ${picocolors_1.default.cyan(match.name)}.`);
@@ -488,7 +603,7 @@ program.command('list [package]')
     if (options.all) {
         for (const pkg of view) {
             console.log();
-            for (const line of (0, registry_view_1.packageDetailLines)(pkg))
+            for (const line of (0, registry_view_1.packageDetailLines)(pkg, listWidth))
                 console.log(line);
         }
         console.log();
@@ -497,7 +612,7 @@ program.command('list [package]')
     }
     // Default: compact summary.
     console.log();
-    for (const line of (0, registry_view_1.packageSummaryLines)(view))
+    for (const line of (0, registry_view_1.packageSummaryLines)(view, listWidth))
         console.log(line);
     console.log();
     console.log(picocolors_1.default.dim(`  awm list <pkg>  ·  awm list --all`));

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/ui/picker-view.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TWO_PANE_MIN_COLUMNS = void 0;
+exports.visibleItems = visibleItems;
+exports.renderPicker = renderPicker;
+const picocolors_1 = __importDefault(require("picocolors"));
+const text_1 = require("./text");
+exports.TWO_PANE_MIN_COLUMNS = 72;
+const FOOTER = '↑↓ move · space select · tab all · ⏎ confirm · esc clear';
+function visibleItems(state) {
+    if (!state.filter)
+        return state.items;
+    const q = state.filter.toLowerCase();
+    return state.items.filter((i) => i.label.toLowerCase().includes(q));
+}
+/** Compute a scroll window [start, end) around the cursor that fits `height` rows. */
+function windowFor(cursor, total, height) {
+    if (total <= height)
+        return [0, total];
+    let start = cursor - Math.floor(height / 2);
+    start = Math.max(0, Math.min(start, total - height));
+    return [start, start + height];
+}
+function checkbox(selected) {
+    return selected ? picocolors_1.default.green('◼') : '◻';
+}
+function renderPicker(state, vp) {
+    const vis = visibleItems(state);
+    const cursor = Math.max(0, Math.min(state.cursor, vis.length - 1));
+    const selCount = state.selected.size;
+    const filterPart = state.filter ? `   filter: ${state.filter}` : '';
+    const header = picocolors_1.default.bold(state.title) + filterPart + (selCount ? picocolors_1.default.dim(`   ${selCount} sel`) : '');
+    const out = [header];
+    if (vis.length === 0) {
+        out.push(picocolors_1.default.dim('  (no matches)'));
+        out.push(FOOTER);
+        return out;
+    }
+    const bodyHeight = Math.max(3, vp.rows - 4); // header + footer + breathing room
+    const [start, end] = windowFor(cursor, vis.length, bodyHeight);
+    const twoPane = vp.columns >= exports.TWO_PANE_MIN_COLUMNS;
+    const listWidth = twoPane ? Math.floor(vp.columns * 0.5) : vp.columns - 2;
+    const rows = [];
+    for (let i = start; i < end; i++) {
+        const item = vis[i];
+        const isCursor = i === cursor;
+        const marker = isCursor ? picocolors_1.default.cyan('❯') : ' ';
+        const box = checkbox(state.selected.has(item.value));
+        const labelWidth = listWidth - 5; // wide cursor marker (2 cells) + space + checkbox + space
+        const label = (0, text_1.truncate)(item.label, labelWidth);
+        rows.push(`${marker} ${box} ${label}`);
+    }
+    if (twoPane) {
+        const detailWidth = vp.columns - listWidth - 3; // gutter " │ "
+        const detail = (0, text_1.wrap)(vis[cursor].description, detailWidth).slice(0, rows.length);
+        const height = Math.max(rows.length, detail.length);
+        for (let i = 0; i < height; i++) {
+            const leftPadded = padToWidth(rows[i] ?? '', listWidth);
+            const right = detail[i] ?? '';
+            out.push(`${leftPadded} ${picocolors_1.default.dim('│')} ${picocolors_1.default.dim(right)}`);
+        }
+    }
+    else {
+        out.push(...rows);
+        out.push(picocolors_1.default.dim('  ' + ((0, text_1.wrap)(vis[cursor].description, vp.columns - 4)[0] ?? '')));
+    }
+    out.push(FOOTER);
+    return out;
+}
+/** Pad a possibly-colored string to `width` visible cells. */
+function padToWidth(s, width) {
+    const pad = width - (0, text_1.displayWidth)(s);
+    return pad > 0 ? s + ' '.repeat(pad) : s;
+}