@skillctl/project-state 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xFurti, Gabry848
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './locks.js';
+export * from './state.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './locks.js';
+export * from './state.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/locks.d.ts

@@ -0,0 +1,11 @@
+export declare class OperationLockError extends Error {
+    readonly code = "E_LOCK_TIMEOUT";
+    constructor(path: string, cause?: unknown);
+}
+export interface OperationLockOptions {
+    cwd: string;
+    store: string;
+    timeoutMs?: number;
+}
+export declare function withOperationLocks<T>(options: OperationLockOptions, operation: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=locks.d.ts.map

package/dist/locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../src/locks.ts"],"names":[],"mappings":"AAIA,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,oBAAoB;gBACrB,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI1C;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/dist/locks.js

@@ -0,0 +1,50 @@
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import lockfile from 'proper-lockfile';
+export class OperationLockError extends Error {
+    code = 'E_LOCK_TIMEOUT';
+    constructor(path, cause) {
+        super(`Timed out waiting for skillctl operation lock: ${path}`, { cause });
+        this.name = 'OperationLockError';
+    }
+}
+export async function withOperationLocks(options, operation) {
+    await mkdir(options.cwd, { recursive: true });
+    await mkdir(options.store, { recursive: true });
+    const timeoutMs = options.timeoutMs ?? 10_000;
+    const retries = Math.max(1, Math.ceil(timeoutMs / 250));
+    const projectLockPath = join(options.cwd, '.skillctl-operation.lock');
+    const storeLockPath = join(options.store, '.skillctl-store.lock');
+    let releaseProject;
+    let releaseStore;
+    try {
+        releaseProject = await acquire(options.cwd, projectLockPath, retries);
+        releaseStore = await acquire(options.store, storeLockPath, retries);
+        return await operation();
+    }
+    catch (err) {
+        if (isLockError(err))
+            throw new OperationLockError(!releaseProject ? projectLockPath : storeLockPath, err);
+        throw err;
+    }
+    finally {
+        if (releaseStore)
+            await releaseStore().catch(() => { });
+        if (releaseProject)
+            await releaseProject().catch(() => { });
+    }
+}
+async function acquire(target, lockfilePath, retries) {
+    return lockfile.lock(target, {
+        realpath: false,
+        lockfilePath,
+        stale: 30_000,
+        update: 10_000,
+        retries: { retries, factor: 1, minTimeout: 250, maxTimeout: 250 },
+    });
+}
+function isLockError(err) {
+    const code = err?.code;
+    return code === 'ELOCKED' || code === 'ENOTACQUIRED';
+}
+//# sourceMappingURL=locks.js.map

package/dist/locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.js","sourceRoot":"","sources":["../src/locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,gBAAgB,CAAC;IACjC,YAAY,IAAY,EAAE,KAAe;QACvC,KAAK,CAAC,kDAAkD,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAQD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA6B,EAC7B,SAA2B;IAE3B,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IAClE,IAAI,cAAiD,CAAC;IACtD,IAAI,YAA+C,CAAC;IACpD,IAAI,CAAC;QACH,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACtE,YAAY,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACpE,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,WAAW,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC3G,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,IAAI,YAAY;YAAE,MAAM,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvD,IAAI,cAAc;YAAE,MAAM,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,YAAoB,EAAE,OAAe;IAC1E,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,KAAK;QACf,YAAY;QACZ,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;KAClE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,MAAM,IAAI,GAAI,GAA6B,EAAE,IAAI,CAAC;IAClD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,cAAc,CAAC;AACvD,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,16 @@
+import { type SkillLockfile } from '@skillctl/core';
+import { type AgentSkillsManifest } from '@skillctl/manifest';
+export interface ProjectState {
+    manifest: AgentSkillsManifest | null;
+    lockfile: SkillLockfile | null;
+}
+export declare function readProjectState(cwd: string): Promise<ProjectState>;
+export declare function updateProjectState<T>(cwd: string, mutator: (state: ProjectState) => Promise<{
+    state: ProjectState;
+    result: T;
+}> | {
+    state: ProjectState;
+    result: T;
+}): Promise<T>;
+export declare function recoverProjectState(cwd: string): Promise<boolean>;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAK1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AAcD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAIzE;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC,GAAG;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACjH,OAAO,CAAC,CAAC,CAAC,CAuCZ;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcvE"}

package/dist/state.js

@@ -0,0 +1,94 @@
+import { readFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { writeFileAtomic } from '@skillctl/core';
+import { loadManifest, saveManifest } from '@skillctl/manifest';
+import { loadLockfile, saveLockfile } from '@skillctl/lockfile';
+const JOURNAL_NAME = '.skillctl-transaction.json';
+export async function readProjectState(cwd) {
+    await recoverProjectState(cwd);
+    const [manifest, lockfile] = await Promise.all([loadManifest(cwd), loadLockfile(cwd)]);
+    return { manifest, lockfile };
+}
+export async function updateProjectState(cwd, mutator) {
+    await recoverProjectState(cwd);
+    const current = {
+        manifest: await loadManifest(cwd),
+        lockfile: await loadLockfile(cwd),
+    };
+    const next = await mutator(current);
+    const manifestPath = join(cwd, 'agent-skills.json');
+    const lockPath = join(cwd, 'agent-skills.lock');
+    const journalPath = join(cwd, JOURNAL_NAME);
+    const journal = {
+        version: 1,
+        phase: 'prepared',
+        manifest: await snapshot(manifestPath),
+        lockfile: await snapshot(lockPath),
+    };
+    await writeJournal(journalPath, journal);
+    try {
+        if (next.state.manifest)
+            await saveManifest(next.state.manifest, cwd);
+        else
+            await rm(manifestPath, { force: true });
+        journal.phase = 'manifest-written';
+        await writeJournal(journalPath, journal);
+        if (next.state.lockfile)
+            await saveLockfile(next.state.lockfile, cwd);
+        else
+            await rm(lockPath, { force: true });
+        await rm(journalPath, { force: true });
+        return next.result;
+    }
+    catch (err) {
+        try {
+            await restore(manifestPath, journal.manifest);
+            await restore(lockPath, journal.lockfile);
+            await rm(journalPath, { force: true });
+        }
+        catch (rollbackError) {
+            throw new Error('Project state update and rollback both failed', {
+                cause: { updateError: err, rollbackError },
+            });
+        }
+        throw err;
+    }
+}
+export async function recoverProjectState(cwd) {
+    const journalPath = join(cwd, JOURNAL_NAME);
+    let journal;
+    try {
+        journal = JSON.parse(await readFile(journalPath, 'utf8'));
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return false;
+        throw new Error(`Invalid project transaction journal: ${journalPath}`, { cause: err });
+    }
+    if (journal.version !== 1)
+        throw new Error(`Unsupported project transaction journal: ${journal.version}`);
+    await restore(join(cwd, 'agent-skills.json'), journal.manifest);
+    await restore(join(cwd, 'agent-skills.lock'), journal.lockfile);
+    await rm(journalPath, { force: true });
+    return true;
+}
+async function snapshot(path) {
+    try {
+        return { exists: true, content: await readFile(path, 'utf8') };
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return { exists: false };
+        throw err;
+    }
+}
+async function restore(path, value) {
+    if (value.exists)
+        await writeFileAtomic(path, value.content || '');
+    else
+        await rm(path, { force: true });
+}
+async function writeJournal(path, journal) {
+    await writeFileAtomic(path, `${JSON.stringify(journal, null, 2)}\n`);
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@skillctl/project-state",
+  "version": "0.5.0",
+  "description": "Cross-process locks and transactional project state updates for skillctl",
+  "license": "MIT",
+  "author": "xFurti & Gabry848",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "!dist/test",
+    "!dist/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "proper-lockfile": "4.1.2",
+    "@skillctl/lockfile": "0.5.0",
+    "@skillctl/core": "0.5.0",
+    "@skillctl/manifest": "0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "rimraf": "^5.0.7",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xFurti/skillctl.git",
+    "directory": "packages/project-state"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rimraf dist",
+    "lint": "tsc --noEmit",
+    "test": "node --test ./dist/test/*.test.js"
+  }
+}