@untitled-devs/wasla 1.0.0 → 1.0.1

package/README.md

@@ -121,22 +121,21 @@ The same pattern applies across every asset type:
 
 ## 🚀 Installation
 
-WaslaGenie is cross-platform via `npx` — no global install required:
+**Install globally:**
 
 ```bash
-npx @untitled-devs/wasla config --scope workspace
-npx @untitled-devs/wasla sync
+npm i -g @untitled-devs/wasla
+waslagenie config --scope workspace
+waslagenie sync
 ```
 
-Choose `workspace` or `user` once before running operational commands. This runs the CLI directly.
-It does not register helper skills inside Claude, Gemini, or other tools.
+Choose `workspace` or `user` once before running operational commands.
 
-**Or install globally:**
+**Or run via `npx` (no global installation required):**
 
 ```bash
-npm install -g @untitled-devs/wasla
-waslagenie config --scope workspace
-waslagenie sync
+npx @untitled-devs/wasla config --scope workspace
+npx @untitled-devs/wasla sync
 ```
 
 Optional helper registration:
@@ -197,7 +196,7 @@ Use `npm run ...` while developing because it runs your local code (`dist`) afte
 
 If you run through `npm run ...` in this repo: **No reinstall needed**. Just run the script again; it rebuilds.
 
-If you installed globally with `npm install -g wasla-genie`: **Yes**, reinstall (or relink) to test your latest local changes.
+If you installed globally with `npm i -g @untitled-devs/wasla`: **Yes**, reinstall (or relink) to test your latest local changes.
 
 For local development without repeated global installs:
 

package/dist/packages/adapters/src/claude.js

@@ -1,6 +1,6 @@
 import { BaseAdapter } from './base.js';
 import { fileExists, writeText, ensureDir } from '#shared/fs.js';
-import { join } from 'path';
+import { dirname, join } from 'path';
 import { getToolMarkers } from '#shared/paths.js';
 export class ClaudeAdapter extends BaseAdapter {
     constructor(scope = 'workspace') {
@@ -19,13 +19,16 @@ export class ClaudeAdapter extends BaseAdapter {
     }
     get paths() {
         const markers = getToolMarkers(this.scope);
+        const workspaceRoot = dirname(markers.claude);
         return {
             agent: join(markers.claude, 'agents'),
             skill: join(markers.claude, 'skills'),
             mcp: this.scope === 'workspace'
                 ? join(markers.claude, 'mcp.json')
                 : join(markers.claude, 'settings.json'),
-            context: join(markers.claude, 'CLAUDE.md'),
+            context: this.scope === 'workspace'
+                ? join(workspaceRoot, 'CLAUDE.md')
+                : join(markers.claude, 'CLAUDE.md'),
         };
     }
     get skillDirs() {

package/dist/packages/sync/src/index.d.ts

@@ -20,6 +20,15 @@ export declare class Syncer {
     attachAssetToTool(name: string, type: AssetType, sourceTool: string, targetTool: string): Promise<boolean>;
     detachAssetFromTool(name: string, type: AssetType, tool: string): Promise<boolean>;
     private calculateHash;
+    /**
+     * Filters discovered files, removing those that cannot be read (ENOENT).
+     * Treats read-time ENOENT as a deletion signal: if a file disappears during
+     * pruning, it is removed from sync and will be treated as a deletion in
+     * reconcileDeletedAssets. This prevents sync failures when files are deleted
+     * between scan and read phases.
+     */
+    private removeMissingFiles;
+    private isMissingFileError;
     private getTargetPath;
     private writeTarget;
     private writeMcpServer;

package/dist/packages/sync/src/index.js

@@ -27,6 +27,7 @@ export class Syncer {
         await ensureDir(join(registryDir, 'context'));
         const discovered = await this.scanner.scanAllTools();
         const grouped = this.groupByNameAndType(discovered);
+        await this.removeMissingFiles(grouped);
         const installedTools = await this.scanner.detectInstalledTools();
         let stubsWritten = 0;
         const stubsDeleted = await this.reconcileDeletedAssets(grouped, installedTools);
@@ -102,20 +103,7 @@ export class Syncer {
                     continue;
                 }
                 // Update stub info in registry
-                const existingStub = asset.stubs.find((s) => s.tool === tool);
-                if (existingStub) {
-                    existingStub.path = primaryTargetPath;
-                    existingStub.written_at = new Date().toISOString();
-                    existingStub.hash = contentHash;
-                }
-                else {
-                    asset.stubs.push({
-                        tool,
-                        path: primaryTargetPath,
-                        written_at: new Date().toISOString(),
-                        hash: contentHash,
-                    });
-                }
+                await this.upsertStub(asset, tool, primaryTargetPath, contentHash);
             }
             // Also save to canonical registry location
             const registrySubdir = type === 'agent'
@@ -166,11 +154,13 @@ export class Syncer {
         const assetTypes = ['agent', 'skill', 'mcp', 'context'];
         const discovered = await this.scanner.scanTool(sourceTool, assetTypes);
         const grouped = this.groupByNameAndType(discovered);
+        await this.removeMissingFiles(grouped);
         const deletionScan = [...discovered];
         for (const tool of targetTools.filter((tool) => tool !== sourceTool)) {
             deletionScan.push(...(await this.scanner.scanTool(tool, assetTypes)));
         }
         const deletionGrouped = this.groupByNameAndType(deletionScan);
+        await this.removeMissingFiles(deletionGrouped);
         let stubsWritten = 0;
         const stubsDeleted = await this.reconcileDeletedAssets(deletionGrouped, [...new Set([sourceTool, ...targetTools])], sourceTool);
         for (const key of Object.keys(grouped)) {
@@ -209,7 +199,7 @@ export class Syncer {
                     last_synced_at: new Date().toISOString(),
                 });
             }
-            this.upsertStub(asset, sourceTool, source.path, contentHash);
+            await this.upsertStub(asset, sourceTool, source.path, contentHash);
             // Write only to target tools
             for (const tool of targetTools) {
                 const adapter = getAdapter(tool, this.scope);
@@ -242,20 +232,7 @@ export class Syncer {
                     continue;
                 }
                 // Update stub info in registry
-                const existingStub = asset.stubs.find((s) => s.tool === tool);
-                if (existingStub) {
-                    existingStub.path = primaryTargetPath;
-                    existingStub.written_at = new Date().toISOString();
-                    existingStub.hash = contentHash;
-                }
-                else {
-                    asset.stubs.push({
-                        tool,
-                        path: primaryTargetPath,
-                        written_at: new Date().toISOString(),
-                        hash: contentHash,
-                    });
-                }
+                await this.upsertStub(asset, tool, primaryTargetPath, contentHash);
             }
             // Also save to canonical registry location
             const registrySubdir = type === 'agent'
@@ -311,7 +288,7 @@ export class Syncer {
             };
             this.registry.addAsset(asset);
         }
-        this.upsertStub(asset, source.tool, source.path, contentHash);
+        await this.upsertStub(asset, source.tool, source.path, contentHash);
         const adapter = getAdapter(targetTool, this.scope);
         const formatsRecord = adapter.formats;
         if (!adapter.paths[type] || !formatsRecord[type]) {
@@ -374,6 +351,46 @@ export class Syncer {
     calculateHash(content) {
         return createHash('sha256').update(content).digest('hex');
     }
+    /**
+     * Filters discovered files, removing those that cannot be read (ENOENT).
+     * Treats read-time ENOENT as a deletion signal: if a file disappears during
+     * pruning, it is removed from sync and will be treated as a deletion in
+     * reconcileDeletedAssets. This prevents sync failures when files are deleted
+     * between scan and read phases.
+     */
+    async removeMissingFiles(grouped) {
+        for (const key of Object.keys(grouped)) {
+            const readable = [];
+            for (const item of grouped[key]) {
+                if (item.content !== undefined) {
+                    readable.push(item);
+                    continue;
+                }
+                try {
+                    item.content = await readText(item.path);
+                    readable.push(item);
+                }
+                catch (error) {
+                    if (!this.isMissingFileError(error)) {
+                        throw error;
+                    }
+                    // ENOENT: file was deleted after scanning, treat as deletion
+                }
+            }
+            if (readable.length > 0) {
+                grouped[key] = readable;
+            }
+            else {
+                delete grouped[key];
+            }
+        }
+    }
+    isMissingFileError(error) {
+        return (typeof error === 'object' &&
+            error !== null &&
+            'code' in error &&
+            error.code === 'ENOENT');
+    }
     getTargetPath(adapter, type, name, relativePath) {
         const typeDir = adapter.paths[type];
         const format = adapter.formats[type];
@@ -436,9 +453,15 @@ export class Syncer {
         await writeJSON(targetPath, config);
         return true;
     }
-    upsertStub(asset, tool, path, hash) {
+    async upsertStub(asset, tool, path, hash) {
         const existingStub = asset.stubs.find((stub) => stub.tool === tool);
         if (existingStub) {
+            if (asset.type === 'context' &&
+                existingStub.path !== path &&
+                (await fileExists(existingStub.path)) &&
+                this.calculateHash(await readText(existingStub.path)) === existingStub.hash) {
+                await removePath(existingStub.path);
+            }
             existingStub.path = path;
             existingStub.written_at = new Date().toISOString();
             existingStub.hash = hash;

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@untitled-devs/wasla",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Universal synchronization layer for AI agent orchestrators",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Untitled-Org/wasla-genie.git"
   },
+  "homepage": "https://the-untitled-org.github.io/wasla-genie/",
+  "preferGlobal": true,
   "type": "module",
   "main": "dist/apps/cli/src/index.js",
   "bin": {
@@ -79,7 +81,7 @@
     "test:integration": "vitest run tests/integration",
     "test:validation": "vitest run tests/validation",
     "test:coverage": "vitest run --coverage",
-    "coverage:open": "open output/index.html",
+    "coverage:open": "open-cli output/index.html",
     "docs": "cd docs && npm run start",
     "docs:install": "npm --prefix docs install",
     "docs:build": "cd docs && npm run build",
@@ -127,6 +129,7 @@
     "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^1.6.1",
     "@vitest/ui": "^1.0.0",
+    "open-cli": "^9.0.0",
     "prettier": "^3.1.0",
     "typescript": "^5.3.3",
     "vitest": "^1.6.1"