@slats/claude-assets-sync 0.2.0 → 0.3.1

package/dist/core/hashManifest/hashManifest.cjs

@@ -1,27 +0,0 @@
-'use strict';
-
-var promises = require('node:fs/promises');
-var node_path = require('node:path');
-
-const HASH_MANIFEST_FILENAME = 'claude-hashes.json';
-async function readHashManifest(packageRoot) {
-    const primary = node_path.join(packageRoot, 'dist', HASH_MANIFEST_FILENAME);
-    const raw = await promises.readFile(primary, 'utf-8');
-    const parsed = JSON.parse(raw);
-    if (parsed.schemaVersion !== 1)
-        throw new Error(`[claude-assets-sync] Unsupported manifest schemaVersion: ${parsed.schemaVersion}`);
-    return parsed;
-}
-function computeNamespacePrefixes(manifest) {
-    const prefixes = new Set();
-    for (const relPath of Object.keys(manifest.files)) {
-        const parts = relPath.split('/');
-        if (parts.length >= 3 && parts[0] === 'skills')
-            prefixes.add(`${parts[0]}/${parts[1]}/`);
-    }
-    return [...prefixes];
-}
-
-exports.HASH_MANIFEST_FILENAME = HASH_MANIFEST_FILENAME;
-exports.computeNamespacePrefixes = computeNamespacePrefixes;
-exports.readHashManifest = readHashManifest;

package/dist/core/injectDocs/injectDocs.cjs

@@ -1,43 +0,0 @@
-'use strict';
-
-var asyncPool = require('../../utils/asyncPool.cjs');
-var logger = require('../../utils/logger.cjs');
-var buildPlan = require('../buildPlan/buildPlan.cjs');
-var hashManifest = require('../hashManifest/hashManifest.cjs');
-var scope = require('../scope/scope.cjs');
-var applyAction = require('./utils/applyAction.cjs');
-var emitCiForceList = require('./utils/emitCiForceList.cjs');
-var printPlan = require('./utils/printPlan.cjs');
-var summarize = require('./utils/summarize.cjs');
-
-async function injectDocs(opts) {
-    const manifest = await hashManifest.readHashManifest(opts.packageRoot);
-    const resolution = scope.resolveScope(opts.scope, opts.originCwd ?? process.cwd());
-    const plan = await buildPlan.buildPlan({
-        sourceHashes: manifest.files,
-        targetRoot: resolution.targetRoot,
-        namespacePrefixes: hashManifest.computeNamespacePrefixes(manifest),
-        force: opts.force,
-    });
-    logger.logger.info(`${opts.packageName}@${opts.packageVersion} → ${resolution.description}`);
-    printPlan.printPlan(plan);
-    if (plan.requiresForce && !opts.force) {
-        logger.logger.error('Re-run with --force to proceed, or inspect with --dry-run.');
-        return summarize.summarize(plan, 2);
-    }
-    if (opts.force &&
-        plan.actions.some((a) => a.kind === 'warn-diverged' || a.kind === 'warn-orphan')) {
-        if (!scope.isInteractive())
-            emitCiForceList.emitCiForceList(plan);
-        else if (opts.confirmForce && !(await opts.confirmForce(plan)))
-            return summarize.summarize(plan, 2);
-    }
-    if (opts.dryRun) {
-        logger.logger.warn('[DRY RUN] No files will be created, overwritten, or deleted.');
-        return summarize.summarize(plan, 0);
-    }
-    await asyncPool.asyncPool(8, plan.actions, (action) => applyAction.applyAction(action, opts.assetRoot));
-    return summarize.summarize(plan, 0);
-}
-
-exports.injectDocs = injectDocs;

package/dist/core/injectDocs/injectDocs.d.ts

@@ -1,2 +0,0 @@
-import type { InjectOptions, InjectReport } from './type.js';
-export declare function injectDocs(opts: InjectOptions): Promise<InjectReport>;

package/dist/core/injectDocs/injectDocs.mjs

@@ -1,41 +0,0 @@
-import { asyncPool } from '../../utils/asyncPool.mjs';
-import { logger } from '../../utils/logger.mjs';
-import { buildPlan } from '../buildPlan/buildPlan.mjs';
-import { readHashManifest, computeNamespacePrefixes } from '../hashManifest/hashManifest.mjs';
-import { resolveScope, isInteractive } from '../scope/scope.mjs';
-import { applyAction } from './utils/applyAction.mjs';
-import { emitCiForceList } from './utils/emitCiForceList.mjs';
-import { printPlan } from './utils/printPlan.mjs';
-import { summarize } from './utils/summarize.mjs';
-
-async function injectDocs(opts) {
-    const manifest = await readHashManifest(opts.packageRoot);
-    const resolution = resolveScope(opts.scope, opts.originCwd ?? process.cwd());
-    const plan = await buildPlan({
-        sourceHashes: manifest.files,
-        targetRoot: resolution.targetRoot,
-        namespacePrefixes: computeNamespacePrefixes(manifest),
-        force: opts.force,
-    });
-    logger.info(`${opts.packageName}@${opts.packageVersion} → ${resolution.description}`);
-    printPlan(plan);
-    if (plan.requiresForce && !opts.force) {
-        logger.error('Re-run with --force to proceed, or inspect with --dry-run.');
-        return summarize(plan, 2);
-    }
-    if (opts.force &&
-        plan.actions.some((a) => a.kind === 'warn-diverged' || a.kind === 'warn-orphan')) {
-        if (!isInteractive())
-            emitCiForceList(plan);
-        else if (opts.confirmForce && !(await opts.confirmForce(plan)))
-            return summarize(plan, 2);
-    }
-    if (opts.dryRun) {
-        logger.warn('[DRY RUN] No files will be created, overwritten, or deleted.');
-        return summarize(plan, 0);
-    }
-    await asyncPool(8, plan.actions, (action) => applyAction(action, opts.assetRoot));
-    return summarize(plan, 0);
-}
-
-export { injectDocs };

package/dist/core/injectDocs/utils/applyAction.cjs

@@ -1,21 +0,0 @@
-'use strict';
-
-var promises = require('node:fs/promises');
-var node_path = require('node:path');
-var logger = require('../../../utils/logger.cjs');
-
-async function applyAction(action, assetRoot) {
-    if (action.kind === 'copy') {
-        const srcAbs = node_path.join(assetRoot, action.relPath);
-        await promises.mkdir(node_path.dirname(action.dstAbs), { recursive: true });
-        await promises.copyFile(srcAbs, action.dstAbs);
-    }
-    else if (action.kind === 'delete')
-        await promises.unlink(action.dstAbs).catch((error) => {
-            if (error?.code !== 'ENOENT') {
-                logger.logger.warn(`[claude-sync] unlink failed: ${action.dstAbs} (${error?.code ?? error})`);
-            }
-        });
-}
-
-exports.applyAction = applyAction;

package/dist/core/injectDocs/utils/emitCiForceList.cjs

@@ -1,10 +0,0 @@
-'use strict';
-
-function emitCiForceList(plan) {
-    const divergent = plan.actions.filter((a) => a.kind === 'warn-diverged' || a.kind === 'warn-orphan');
-    process.stderr.write(`[claude-assets-sync] --force overwriting ${divergent.length} file(s) in non-TTY mode:\n`);
-    for (const a of divergent)
-        process.stderr.write(`  ${a.relPath}\n`);
-}
-
-exports.emitCiForceList = emitCiForceList;

package/dist/core/injectDocs/utils/emitCiForceList.d.ts

@@ -1,2 +0,0 @@
-import type { InjectPlan } from '../../buildPlan/index.js';
-export declare function emitCiForceList(plan: InjectPlan): void;

package/dist/core/injectDocs/utils/emitCiForceList.mjs

@@ -1,8 +0,0 @@
-function emitCiForceList(plan) {
-    const divergent = plan.actions.filter((a) => a.kind === 'warn-diverged' || a.kind === 'warn-orphan');
-    process.stderr.write(`[claude-assets-sync] --force overwriting ${divergent.length} file(s) in non-TTY mode:\n`);
-    for (const a of divergent)
-        process.stderr.write(`  ${a.relPath}\n`);
-}
-
-export { emitCiForceList };

package/dist/core/injectDocs/utils/printPlan.cjs

@@ -1,20 +0,0 @@
-'use strict';
-
-var logger = require('../../../utils/logger.cjs');
-
-function printPlan(plan) {
-    for (const a of plan.actions) {
-        if (a.kind === 'copy')
-            logger.logger.file('create', a.relPath);
-        else if (a.kind === 'skip-uptodate')
-            logger.logger.file('skip', `${a.relPath} (up-to-date)`);
-        else if (a.kind === 'warn-diverged')
-            logger.logger.warn(`${a.relPath} — local differs from source (user edit or version change)`);
-        else if (a.kind === 'warn-orphan')
-            logger.logger.warn(`${a.relPath} — present locally, absent in source`);
-        else if (a.kind === 'delete')
-            logger.logger.file('update', `${a.relPath} (deleting)`);
-    }
-}
-
-exports.printPlan = printPlan;

package/dist/core/injectDocs/utils/printPlan.d.ts

@@ -1,2 +0,0 @@
-import type { InjectPlan } from '../../buildPlan/index.js';
-export declare function printPlan(plan: InjectPlan): void;

package/dist/core/injectDocs/utils/printPlan.mjs

@@ -1,18 +0,0 @@
-import { logger } from '../../../utils/logger.mjs';
-
-function printPlan(plan) {
-    for (const a of plan.actions) {
-        if (a.kind === 'copy')
-            logger.file('create', a.relPath);
-        else if (a.kind === 'skip-uptodate')
-            logger.file('skip', `${a.relPath} (up-to-date)`);
-        else if (a.kind === 'warn-diverged')
-            logger.warn(`${a.relPath} — local differs from source (user edit or version change)`);
-        else if (a.kind === 'warn-orphan')
-            logger.warn(`${a.relPath} — present locally, absent in source`);
-        else if (a.kind === 'delete')
-            logger.file('update', `${a.relPath} (deleting)`);
-    }
-}
-
-export { printPlan };

package/dist/core/injectDocs/utils/summarize.cjs

@@ -1,27 +0,0 @@
-'use strict';
-
-function summarize(plan, exitCode) {
-    const report = {
-        created: [],
-        updated: [],
-        skipped: [],
-        warnings: [],
-        deleted: [],
-        exitCode,
-    };
-    for (const a of plan.actions) {
-        if (a.kind === 'copy')
-            report.created.push(a.relPath);
-        else if (a.kind === 'skip-uptodate')
-            report.skipped.push(a.relPath);
-        else if (a.kind === 'warn-diverged')
-            report.warnings.push({ relPath: a.relPath, reason: 'diverged' });
-        else if (a.kind === 'warn-orphan')
-            report.warnings.push({ relPath: a.relPath, reason: 'orphan' });
-        else if (a.kind === 'delete')
-            report.deleted.push(a.relPath);
-    }
-    return report;
-}
-
-exports.summarize = summarize;

package/dist/core/scope/scope.cjs

@@ -1,46 +0,0 @@
-'use strict';
-
-var node_os = require('node:os');
-var node_path = require('node:path');
-var isDirectory = require('./utils/isDirectory.cjs');
-
-function isValidScope(value) {
-    return value === 'user' || value === 'project';
-}
-function findNearestDotClaudeAncestor(start) {
-    let current = start;
-    while (true) {
-        if (isDirectory.isDirectory(node_path.join(current, '.claude')))
-            return current;
-        const parent = node_path.dirname(current);
-        if (parent === current)
-            return null;
-        current = parent;
-    }
-}
-function resolveScope(scope, cwd = process.cwd()) {
-    if (scope === 'user') {
-        return {
-            scope,
-            targetRoot: node_path.join(node_os.homedir(), '.claude'),
-            description: '~/.claude (user)',
-        };
-    }
-    const ancestor = findNearestDotClaudeAncestor(cwd);
-    const base = ancestor ?? cwd;
-    return {
-        scope,
-        targetRoot: node_path.join(base, '.claude'),
-        description: ancestor !== null
-            ? `${base}/.claude (project, auto-located)`
-            : `${base}/.claude (project)`,
-    };
-}
-function isInteractive() {
-    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
-}
-
-exports.findNearestDotClaudeAncestor = findNearestDotClaudeAncestor;
-exports.isInteractive = isInteractive;
-exports.isValidScope = isValidScope;
-exports.resolveScope = resolveScope;

package/dist/core/scope/utils/isDirectory.cjs

@@ -1,14 +0,0 @@
-'use strict';
-
-var node_fs = require('node:fs');
-
-function isDirectory(path) {
-    try {
-        return node_fs.statSync(path).isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-
-exports.isDirectory = isDirectory;

package/dist/index.cjs

@@ -1,20 +0,0 @@
-'use strict';
-
-var runCli = require('./commands/runCli/runCli.cjs');
-require('node:crypto');
-require('node:fs/promises');
-var hashManifest = require('./core/hashManifest/hashManifest.cjs');
-var injectDocs = require('./core/injectDocs/injectDocs.cjs');
-require('node:path');
-var scope = require('./core/scope/scope.cjs');
-
-
-
-exports.runCli = runCli.runCli;
-exports.HASH_MANIFEST_FILENAME = hashManifest.HASH_MANIFEST_FILENAME;
-exports.computeNamespacePrefixes = hashManifest.computeNamespacePrefixes;
-exports.readHashManifest = hashManifest.readHashManifest;
-exports.injectDocs = injectDocs.injectDocs;
-exports.isInteractive = scope.isInteractive;
-exports.isValidScope = scope.isValidScope;
-exports.resolveScope = scope.resolveScope;

package/dist/prompts/confirmForce.cjs

@@ -1,27 +0,0 @@
-'use strict';
-
-var prompts = require('@inquirer/prompts');
-var pc = require('picocolors');
-
-async function confirmForceAsync(divergedCount, orphanCount, relPaths) {
-    const extra = Math.max(0, divergedCount + orphanCount - relPaths.length);
-    const divergedPart = pc.red(pc.bold(`${divergedCount} diverged file(s)`));
-    const orphanPart = orphanCount > 0
-        ? ` and ${pc.red(pc.bold(`delete ${orphanCount} orphan(s)`))}`
-        : '';
-    process.stderr.write(`${pc.yellow(pc.bold('!'))} This will overwrite ${divergedPart}${orphanPart}:\n`);
-    for (const p of relPaths) {
-        process.stderr.write(`  ${pc.dim('-')} ${p}\n`);
-    }
-    if (extra > 0) {
-        process.stderr.write(`  ${pc.dim(`... and ${extra} more`)}\n`);
-    }
-    process.stderr.write('\n');
-    const answer = await prompts.confirm({
-        message: pc.bold('Do you have these in git? Proceed?'),
-        default: false,
-    });
-    return answer;
-}
-
-exports.confirmForceAsync = confirmForceAsync;

package/dist/prompts/confirmForce.d.ts

@@ -1 +0,0 @@
-export declare function confirmForceAsync(divergedCount: number, orphanCount: number, relPaths: string[]): Promise<boolean>;

package/dist/prompts/confirmForce.mjs

@@ -1,25 +0,0 @@
-import { confirm } from '@inquirer/prompts';
-import pc from 'picocolors';
-
-async function confirmForceAsync(divergedCount, orphanCount, relPaths) {
-    const extra = Math.max(0, divergedCount + orphanCount - relPaths.length);
-    const divergedPart = pc.red(pc.bold(`${divergedCount} diverged file(s)`));
-    const orphanPart = orphanCount > 0
-        ? ` and ${pc.red(pc.bold(`delete ${orphanCount} orphan(s)`))}`
-        : '';
-    process.stderr.write(`${pc.yellow(pc.bold('!'))} This will overwrite ${divergedPart}${orphanPart}:\n`);
-    for (const p of relPaths) {
-        process.stderr.write(`  ${pc.dim('-')} ${p}\n`);
-    }
-    if (extra > 0) {
-        process.stderr.write(`  ${pc.dim(`... and ${extra} more`)}\n`);
-    }
-    process.stderr.write('\n');
-    const answer = await confirm({
-        message: pc.bold('Do you have these in git? Proceed?'),
-        default: false,
-    });
-    return answer;
-}
-
-export { confirmForceAsync };

package/dist/prompts/index.d.ts

@@ -1,2 +0,0 @@
-export { selectScopeAsync } from './selectScope.js';
-export { confirmForceAsync } from './confirmForce.js';

package/dist/prompts/selectScope.cjs

@@ -1,30 +0,0 @@
-'use strict';
-
-var prompts = require('@inquirer/prompts');
-var pc = require('picocolors');
-
-const CHOICES = [
-    {
-        name: 'user',
-        value: 'user',
-        description: '~/.claude (applies globally to every project)',
-    },
-    {
-        name: 'project',
-        value: 'project',
-        description: 'nearest ancestor .claude (or <cwd>/.claude)',
-    },
-];
-async function selectScopeAsync() {
-    const answer = await prompts.select({
-        message: pc.bold(pc.cyan('Select injection scope:')),
-        choices: CHOICES.map((c) => ({
-            name: c.name,
-            value: c.value,
-            description: pc.dim(c.description),
-        })),
-    });
-    return answer;
-}
-
-exports.selectScopeAsync = selectScopeAsync;

package/dist/prompts/selectScope.d.ts

@@ -1,2 +0,0 @@
-import type { Scope } from '../core/scope/index.js';
-export declare function selectScopeAsync(): Promise<Scope>;

package/dist/prompts/selectScope.mjs

@@ -1,28 +0,0 @@
-import { select } from '@inquirer/prompts';
-import pc from 'picocolors';
-
-const CHOICES = [
-    {
-        name: 'user',
-        value: 'user',
-        description: '~/.claude (applies globally to every project)',
-    },
-    {
-        name: 'project',
-        value: 'project',
-        description: 'nearest ancestor .claude (or <cwd>/.claude)',
-    },
-];
-async function selectScopeAsync() {
-    const answer = await select({
-        message: pc.bold(pc.cyan('Select injection scope:')),
-        choices: CHOICES.map((c) => ({
-            name: c.name,
-            value: c.value,
-            description: pc.dim(c.description),
-        })),
-    });
-    return answer;
-}
-
-export { selectScopeAsync };

package/dist/utils/asyncPool.cjs

@@ -1,26 +0,0 @@
-'use strict';
-
-async function asyncPool(limit, items, fn) {
-    const results = [];
-    const executing = new Set();
-    for (const [index, item] of items.entries()) {
-        const p = (async () => {
-            try {
-                const value = await fn(item);
-                results[index] = { status: 'fulfilled', value };
-            }
-            catch (reason) {
-                results[index] = { status: 'rejected', reason };
-            }
-        })();
-        executing.add(p);
-        p.then(() => executing.delete(p));
-        if (executing.size >= limit) {
-            await Promise.race(executing);
-        }
-    }
-    await Promise.all(executing);
-    return results;
-}
-
-exports.asyncPool = asyncPool;

package/dist/utils/heartbeat.cjs

@@ -1,25 +0,0 @@
-'use strict';
-
-var pc = require('picocolors');
-
-function startHeartbeat(options = {}) {
-    const intervalMs = options.intervalMs ?? 500;
-    const label = options.label ?? 'working';
-    const emit = options.emit ??
-        ((line) => {
-            process.stderr.write(line);
-        });
-    const startedAt = Date.now();
-    const timer = setInterval(() => {
-        const elapsedMs = Date.now() - startedAt;
-        const seconds = (elapsedMs / 1000).toFixed(1);
-        emit(`${pc.dim(`[${seconds}s]`)} ${pc.cyan(`${label}...`)}\n`);
-    }, intervalMs);
-    if (typeof timer.unref === 'function')
-        timer.unref();
-    return () => {
-        clearInterval(timer);
-    };
-}
-
-exports.startHeartbeat = startHeartbeat;

package/dist/utils/heartbeat.d.ts

@@ -1,16 +0,0 @@
-export interface HeartbeatOptions {
-    intervalMs?: number;
-    emit?: (line: string) => void;
-    label?: string;
-}
-export type StopHeartbeat = () => void;
-/**
- * Wall-clock heartbeat ticker for long-running async operations.
- *
- * Wraps operations at the command layer (NOT core) to provide in-flight
- * visibility when stdout is quiet for several hundred milliseconds.
- *
- * The emitted line is written via the provided `emit` (default: stderr) so
- * it never interferes with programmatic stdout output.
- */
-export declare function startHeartbeat(options?: HeartbeatOptions): StopHeartbeat;

package/dist/utils/heartbeat.mjs

@@ -1,23 +0,0 @@
-import pc from 'picocolors';
-
-function startHeartbeat(options = {}) {
-    const intervalMs = options.intervalMs ?? 500;
-    const label = options.label ?? 'working';
-    const emit = options.emit ??
-        ((line) => {
-            process.stderr.write(line);
-        });
-    const startedAt = Date.now();
-    const timer = setInterval(() => {
-        const elapsedMs = Date.now() - startedAt;
-        const seconds = (elapsedMs / 1000).toFixed(1);
-        emit(`${pc.dim(`[${seconds}s]`)} ${pc.cyan(`${label}...`)}\n`);
-    }, intervalMs);
-    if (typeof timer.unref === 'function')
-        timer.unref();
-    return () => {
-        clearInterval(timer);
-    };
-}
-
-export { startHeartbeat };

package/dist/utils/logger.cjs

@@ -1,74 +0,0 @@
-'use strict';
-
-var pc = require('picocolors');
-
-const logger = {
-    info(message) {
-        console.log(pc.blue('info'), message);
-    },
-    success(message) {
-        console.log(pc.green('success'), message);
-    },
-    warn(message) {
-        console.log(pc.yellow('warn'), message);
-    },
-    error(message) {
-        console.log(pc.red('error'), message);
-    },
-    debug(message) {
-        if (process.env.VERBOSE) {
-            console.log(pc.gray('debug'), message);
-        }
-    },
-    step(step, detail) {
-        const stepText = pc.cyan(`[${step}]`);
-        console.log(stepText, detail || '');
-    },
-    file(operation, path) {
-        const colors = {
-            create: pc.green,
-            update: pc.yellow,
-            skip: pc.gray,
-        };
-        const symbols = {
-            create: '+',
-            update: '~',
-            skip: '-',
-        };
-        console.log(`  ${colors[operation](symbols[operation])} ${path}`);
-    },
-    packageStart(packageName) {
-        console.log();
-        console.log(pc.bold(pc.cyan(`Syncing ${packageName}...`)));
-    },
-    packageEnd(_packageName, result) {
-        if (result.skipped)
-            console.log(pc.gray(`  Skipped: ${result.reason || 'Unknown reason'}`));
-        else if (result.success)
-            console.log(pc.green(`  Completed successfully`));
-        else
-            console.log(pc.red(`  Failed: ${result.reason || 'Unknown error'}`));
-    },
-    summary(results) {
-        console.log();
-        console.log(pc.bold('Summary:'));
-        console.log(`  ${pc.green('Success:')} ${results.success}`);
-        console.log(`  ${pc.gray('Skipped:')} ${results.skipped}`);
-        if (results.failed > 0)
-            console.log(`  ${pc.red('Failed:')} ${results.failed}`);
-    },
-    dryRunNotice() {
-        console.log();
-        console.log(pc.yellow(pc.bold('[DRY RUN] No files will be created or modified.')));
-        console.log();
-    },
-    heading(message) {
-        console.log();
-        console.log(pc.bold(pc.cyan(`▸ ${message}`)));
-    },
-    accent(message) {
-        return pc.cyan(pc.bold(message));
-    },
-};
-
-exports.logger = logger;

package/dist/utils/version.cjs

@@ -1,5 +0,0 @@
-'use strict';
-
-const VERSION = '0.2.0';
-
-exports.VERSION = VERSION;