fitout 0.1.0 → 0.2.0

package/README.md

@@ -17,7 +17,7 @@ Fitout ensures your actual runtime state matches your declared configuration.
 
 1. Declare desired plugins in `.claude/fitout.toml`
 2. Run `fitout status` to see the diff
-3. Run `fitout apply` to sync
+3. Run `fitout install` to sync
 
 ## Installation
 
@@ -71,7 +71,7 @@ Context: /path/to/project
 Install missing plugins:
 
 ```bash
-fitout apply
+fitout install
 ```
 
 ## Commands
@@ -86,13 +86,13 @@ Shows the diff between desired and installed plugins.
 
 Exit code is `1` if any plugins are missing, `0` otherwise.
 
-### `fitout apply`
+### `fitout install`
 
 Installs missing plugins to sync with config.
 
 ```bash
-fitout apply           # Install missing plugins
-fitout apply --dry-run # Preview what would be installed
+fitout install           # Install missing plugins
+fitout install --dry-run # Preview what would be installed
 ```
 
 ## Profiles

package/dist/claude.d.ts

@@ -5,6 +5,7 @@ export interface InstalledPlugin {
     enabled: boolean;
     projectPath?: string;
 }
+export declare function claudeEnv(): NodeJS.ProcessEnv;
 export declare function parsePluginList(jsonOutput: string): InstalledPlugin[];
 export declare function listPlugins(): InstalledPlugin[];
 export declare function installPlugin(pluginId: string): void;

package/dist/claude.js

@@ -1,4 +1,16 @@
-import { execFileSync } from 'node:child_process';
+import { execFileSync, execSync } from 'node:child_process';
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+// Claude CLI sets CLAUDECODE=1 to detect nested sessions and refuses to run
+// if it's present. Fitout calls `claude plugin list/install` from SessionStart
+// hooks, which inherit this env var. These are safe metadata/management commands,
+// not nested interactive sessions, so we strip the variable.
+export function claudeEnv() {
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    return env;
+}
 export function parsePluginList(jsonOutput) {
     const parsed = JSON.parse(jsonOutput);
     if (!Array.isArray(parsed)) {
@@ -7,14 +19,27 @@ export function parsePluginList(jsonOutput) {
     return parsed;
 }
 export function listPlugins() {
-    const output = execFileSync('claude', ['plugin', 'list', '--json'], {
-        encoding: 'utf-8',
-    });
-    return parsePluginList(output);
+    // Use file redirection to work around Claude CLI stdout truncation at 64KB
+    // when piped to a non-tty. File redirection captures the full output.
+    const tmpDir = mkdtempSync(join(tmpdir(), 'fitout-'));
+    const tmpFile = join(tmpDir, 'plugins.json');
+    try {
+        execSync(`claude plugin list --json > "${tmpFile}"`, {
+            encoding: 'utf-8',
+            env: claudeEnv(),
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const output = readFileSync(tmpFile, 'utf-8');
+        return parsePluginList(output);
+    }
+    finally {
+        rmSync(tmpDir, { recursive: true, force: true });
+    }
 }
 export function installPlugin(pluginId) {
     execFileSync('claude', ['plugin', 'install', pluginId, '--scope', 'local'], {
         encoding: 'utf-8',
+        env: claudeEnv(),
         stdio: 'inherit',
     });
 }

package/dist/globalConfig.d.ts

@@ -1,10 +1,10 @@
 export { getGlobalConfigDir, getGlobalConfigPath } from './paths.js';
 export interface GlobalConfig {
-    marketplaces?: Record<string, string>;
+    marketplaces?: string[];
 }
 export declare function readGlobalConfig(): GlobalConfig;
 export declare function writeGlobalConfig(config: GlobalConfig): void;
 export declare function hasGlobalConfig(): boolean;
-export declare function getConfiguredMarketplaces(): Record<string, string>;
-export declare function getGlobalConfigContent(marketplaces?: Record<string, string>): string;
-export declare function createGlobalConfig(marketplaces?: Record<string, string>): boolean;
+export declare function getConfiguredMarketplaces(): string[];
+export declare function getGlobalConfigContent(marketplaces?: string[]): string;
+export declare function createGlobalConfig(marketplaces?: string[]): boolean;

package/dist/globalConfig.js

@@ -27,27 +27,24 @@ export function hasGlobalConfig() {
 }
 export function getConfiguredMarketplaces() {
     const config = readGlobalConfig();
-    return config.marketplaces || {};
+    return config.marketplaces || [];
 }
 export function getGlobalConfigContent(marketplaces) {
-    if (!marketplaces || Object.keys(marketplaces).length === 0) {
-        return `# Fettle global config
-# Marketplaces and their sources
+    if (!marketplaces || marketplaces.length === 0) {
+        return `# Fitout global config
+# Marketplace sources to ensure are installed
 
-[marketplaces]
-# pickled-claude-plugins = "https://github.com/technicalpickles/pickled-claude-plugins"
+marketplaces = []
 `;
     }
-    const lines = [
-        '# Fettle global config',
-        '# Marketplaces and their sources',
-        '',
-        '[marketplaces]',
-    ];
-    for (const [name, source] of Object.entries(marketplaces)) {
-        lines.push(`${name} = "${source}"`);
-    }
-    return lines.join('\n') + '\n';
+    const quotedSources = marketplaces.map((s) => `  "${s}"`).join(',\n');
+    return `# Fitout global config
+# Marketplace sources to ensure are installed
+
+marketplaces = [
+${quotedSources},
+]
+`;
 }
 export function createGlobalConfig(marketplaces) {
     const configPath = getGlobalConfigPath();

package/dist/init.d.ts

@@ -1,5 +1,7 @@
 export declare function readClaudeSettings(path: string): Record<string, unknown>;
 export type HookStatus = 'none' | 'current' | 'outdated';
+export declare const HOOK_COMMAND_DEFAULT = "npx fitout@latest install --hook";
+export declare const HOOK_COMMAND_DEV = "fitout install --hook";
 export declare function getFitoutHookStatus(settings: Record<string, unknown>): HookStatus;
 export declare function hasFitoutHook(settings: Record<string, unknown>): boolean;
 interface ClaudeSettings {

package/dist/init.js

@@ -14,17 +14,31 @@ export function readClaudeSettings(path) {
         return {};
     }
 }
+// Hook command patterns
+export const HOOK_COMMAND_DEFAULT = 'npx fitout@latest install --hook';
+export const HOOK_COMMAND_DEV = 'fitout install --hook';
+function isCurrentHook(command) {
+    if (!command)
+        return false;
+    // Match both "npx fitout@latest install --hook" and "fitout install --hook"
+    return command.includes('fitout install --hook') || command.includes('fitout@latest install --hook');
+}
+function isLegacyHook(command) {
+    if (!command)
+        return false;
+    return command.includes('fitout apply --hook') || command.includes('fitout@latest apply --hook');
+}
 export function getFitoutHookStatus(settings) {
     const hooks = settings.hooks;
     if (!hooks?.SessionStart)
         return 'none';
     const sessionStartHooks = hooks.SessionStart;
-    // Check for current command first
-    const hasCurrent = sessionStartHooks.some((matcher) => matcher.hooks?.some((hook) => hook.command?.includes('fitout install --hook')));
+    // Check for current command (matches both npx and dev versions)
+    const hasCurrent = sessionStartHooks.some((matcher) => matcher.hooks?.some((hook) => isCurrentHook(hook.command)));
     if (hasCurrent)
         return 'current';
     // Check for legacy command
-    const hasLegacy = sessionStartHooks.some((matcher) => matcher.hooks?.some((hook) => hook.command?.includes('fitout apply --hook')));
+    const hasLegacy = sessionStartHooks.some((matcher) => matcher.hooks?.some((hook) => isLegacyHook(hook.command)));
     if (hasLegacy)
         return 'outdated';
     return 'none';
@@ -43,7 +57,7 @@ export function addFitoutHook(settings) {
     }
     result.hooks.SessionStart.push({
         hooks: [
-            { type: 'command', command: 'fitout install --hook' }
+            { type: 'command', command: HOOK_COMMAND_DEFAULT }
         ]
     });
     return result;
@@ -56,8 +70,11 @@ export function upgradeFitoutHook(settings) {
     for (const matcher of result.hooks.SessionStart) {
         if (matcher.hooks) {
             for (const hook of matcher.hooks) {
-                if (hook.command?.includes('fitout apply --hook')) {
-                    hook.command = hook.command.replace('fitout apply --hook', 'fitout install --hook');
+                if (isLegacyHook(hook.command)) {
+                    // Replace both legacy patterns with the new default
+                    hook.command = hook.command
+                        .replace('fitout@latest apply --hook', HOOK_COMMAND_DEFAULT)
+                        .replace('fitout apply --hook', HOOK_COMMAND_DEFAULT);
                 }
             }
         }
@@ -107,7 +124,7 @@ Read \`~/.claude/settings.json\` and verify the Fitout hook exists:
     "SessionStart": [
       {
         "hooks": [
-          { "type": "command", "command": "fitout install --hook" }
+          { "type": "command", "command": "npx fitout@latest install --hook" }
         ]
       }
     ]
@@ -115,6 +132,8 @@ Read \`~/.claude/settings.json\` and verify the Fitout hook exists:
 }
 \`\`\`
 
+Note: Developers may use \`fitout install --hook\` (without npx) for local development.
+
 If the hook is missing, suggest running \`fitout init\`.
 
 ### 2. Check Plugin Status

package/dist/install.js

@@ -133,13 +133,13 @@ export function runInstall(cwd, options = {}) {
     }
     // Ensure configured marketplaces are installed (skip in hook mode for cleaner output)
     if (!options.hook && hasGlobalConfig()) {
-        const marketplaces = getConfiguredMarketplaces();
-        if (Object.keys(marketplaces).length > 0) {
-            const marketplaceResult = ensureMarketplaces();
+        const marketplaceSources = getConfiguredMarketplaces();
+        if (marketplaceSources.length > 0) {
+            const marketplaceResult = ensureMarketplaces(marketplaceSources);
             if (marketplaceResult.added.length > 0) {
                 console.log(colors.header('Marketplaces:'));
-                for (const name of marketplaceResult.added) {
-                    console.log(`  ${symbols.install} ${name}`);
+                for (const source of marketplaceResult.added) {
+                    console.log(`  ${symbols.install} ${source}`);
                 }
                 console.log('');
             }

package/dist/marketplace.d.ts

@@ -4,16 +4,15 @@ export interface AvailablePlugin {
     version: string;
     marketplace: string;
 }
+export interface InstalledMarketplace {
+    name: string;
+    source: 'github' | 'git' | string;
+    repo?: string;
+    url?: string;
+    installLocation: string;
+}
 export declare function listAvailablePlugins(): AvailablePlugin[];
 export declare function refreshMarketplaces(): void;
-/**
- * Get list of marketplace names that are installed locally
- */
-export declare function getInstalledMarketplaces(): string[];
-/**
- * Check if a marketplace is installed
- */
-export declare function isMarketplaceInstalled(name: string): boolean;
 /**
  * Add a marketplace from a source URL
  */
@@ -22,11 +21,19 @@ export interface EnsureMarketplacesResult {
     added: string[];
     alreadyInstalled: string[];
     failed: {
-        name: string;
+        source: string;
         error: string;
     }[];
 }
 /**
- * Ensure all configured marketplaces are installed
+ * Ensure all configured marketplace sources are installed
+ */
+export declare function ensureMarketplaces(sources: string[]): EnsureMarketplacesResult;
+/**
+ * List installed marketplaces using Claude CLI JSON output
+ */
+export declare function listInstalledMarketplaces(): InstalledMarketplace[];
+/**
+ * Check if a marketplace source URL is already installed
  */
-export declare function ensureMarketplaces(): EnsureMarketplacesResult;
+export declare function isMarketplaceSourceInstalled(source: string): boolean;

package/dist/marketplace.js

@@ -1,7 +1,6 @@
 import { execFileSync } from 'node:child_process';
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { getConfiguredMarketplaces } from './globalConfig.js';
 import { getMarketplacesDir } from './paths.js';
 export { getMarketplacesDir } from './paths.js';
 export function listAvailablePlugins() {
@@ -41,25 +40,6 @@ export function refreshMarketplaces() {
         stdio: 'inherit',
     });
 }
-/**
- * Get list of marketplace names that are installed locally
- */
-export function getInstalledMarketplaces() {
-    const marketplacesDir = getMarketplacesDir();
-    if (!existsSync(marketplacesDir)) {
-        return [];
-    }
-    return readdirSync(marketplacesDir, { withFileTypes: true })
-        .filter((d) => d.isDirectory())
-        .map((d) => d.name);
-}
-/**
- * Check if a marketplace is installed
- */
-export function isMarketplaceInstalled(name) {
-    const marketplacesDir = getMarketplacesDir();
-    return existsSync(join(marketplacesDir, name));
-}
 /**
  * Add a marketplace from a source URL
  */
@@ -70,27 +50,26 @@ export function addMarketplace(source) {
     });
 }
 /**
- * Ensure all configured marketplaces are installed
+ * Ensure all configured marketplace sources are installed
  */
-export function ensureMarketplaces() {
-    const configured = getConfiguredMarketplaces();
+export function ensureMarketplaces(sources) {
     const result = {
         added: [],
         alreadyInstalled: [],
         failed: [],
     };
-    for (const [name, source] of Object.entries(configured)) {
-        if (isMarketplaceInstalled(name)) {
-            result.alreadyInstalled.push(name);
+    for (const source of sources) {
+        if (isMarketplaceSourceInstalled(source)) {
+            result.alreadyInstalled.push(source);
         }
         else {
             try {
                 addMarketplace(source);
-                result.added.push(name);
+                result.added.push(source);
             }
             catch (err) {
                 result.failed.push({
-                    name,
+                    source,
                     error: err instanceof Error ? err.message : 'Unknown error',
                 });
             }
@@ -98,3 +77,43 @@ export function ensureMarketplaces() {
     }
     return result;
 }
+/**
+ * List installed marketplaces using Claude CLI JSON output
+ */
+export function listInstalledMarketplaces() {
+    try {
+        const output = execFileSync('claude', ['plugin', 'marketplace', 'list', '--json'], {
+            encoding: 'utf-8',
+        });
+        return JSON.parse(output);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Normalize a marketplace source URL to extract owner/repo for comparison
+ */
+function normalizeGitHubSource(source) {
+    // Match github.com URLs with or without .git suffix
+    const match = source.match(/github\.com\/([^/]+\/[^/.]+)/);
+    return match ? match[1] : null;
+}
+/**
+ * Check if a marketplace source URL is already installed
+ */
+export function isMarketplaceSourceInstalled(source) {
+    const installed = listInstalledMarketplaces();
+    const normalizedSource = normalizeGitHubSource(source);
+    return installed.some((m) => {
+        // Check github source by repo
+        if (m.source === 'github' && m.repo && normalizedSource) {
+            return m.repo === normalizedSource;
+        }
+        // Check git source by URL
+        if (m.source === 'git' && m.url) {
+            return m.url === source;
+        }
+        return false;
+    });
+}

package/dist/update.js

@@ -1,4 +1,5 @@
 import { execFileSync } from 'node:child_process';
+import { claudeEnv } from './claude.js';
 /**
  * Compare semver versions. Returns:
  * -1 if a < b
@@ -49,6 +50,7 @@ export function findOutdatedPlugins(installed, available, projectPath) {
 export function updatePlugin(pluginId, scope = 'local') {
     execFileSync('claude', ['plugin', 'update', pluginId, '--scope', scope], {
         encoding: 'utf-8',
+        env: claudeEnv(),
         stdio: 'inherit',
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fitout",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Context-aware plugin manager for Claude Code",
   "type": "module",
   "bin": {
@@ -39,6 +39,7 @@
   },
   "devDependencies": {
     "@types/node": "^25.1.0",
+    "semantic-release": "^25.0.3",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"