@hanhnd/agent-kit 1.0.31 → 1.0.33

package/dist/utils/files.test.js

@@ -0,0 +1,81 @@
+import * as assert from 'node:assert/strict';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { afterEach, describe, test } from 'node:test';
+import { createTempDirTracker } from './temp-dir.test.js';
+import { DIGEST_LOCKFILE_REL_PATH } from '../services/digest/constants.js';
+import { releaseLock, tryAcquireProcessLock } from './files.js';
+const tempDirs = createTempDirTracker();
+afterEach(() => {
+    tempDirs.cleanup();
+});
+function lockPath(workspace) {
+    return path.join(workspace, DIGEST_LOCKFILE_REL_PATH);
+}
+function lockDir(workspace) {
+    return path.dirname(lockPath(workspace));
+}
+describe('tryAcquireProcessLock', () => {
+    test('C1: no lockfile → creates it with current PID and returns true', () => {
+        const workspace = tempDirs.makeTempDir('lockfile-c1-');
+        const acquired = tryAcquireProcessLock(lockPath(workspace));
+        assert.equal(acquired, true);
+        const lockFile = lockPath(workspace);
+        const content = JSON.parse(fs.readFileSync(lockFile, 'utf8'));
+        assert.equal(content.pid, process.pid);
+    });
+    test('C2: lockfile with live foreign PID → returns false without modifying file', () => {
+        const workspace = tempDirs.makeTempDir('lockfile-c2-');
+        const lockFile = lockPath(workspace);
+        fs.mkdirSync(lockDir(workspace), { recursive: true });
+        // Use process.pid as "live" pid (current process is definitely alive)
+        const livePid = process.pid;
+        fs.writeFileSync(lockFile, JSON.stringify({ pid: livePid }), 'utf8');
+        const originalContent = fs.readFileSync(lockFile, 'utf8');
+        const acquired = tryAcquireProcessLock(lockPath(workspace));
+        assert.equal(acquired, false);
+        // File must be unchanged
+        assert.equal(fs.readFileSync(lockFile, 'utf8'), originalContent);
+    });
+    test('C3: lockfile with dead PID (ESRCH) → deletes stale lock, creates new one, returns true', () => {
+        const workspace = tempDirs.makeTempDir('lockfile-c3-');
+        const lockFile = lockPath(workspace);
+        fs.mkdirSync(lockDir(workspace), { recursive: true });
+        // PID 999999999 is virtually guaranteed to be dead
+        fs.writeFileSync(lockFile, JSON.stringify({ pid: 999999999 }), 'utf8');
+        const acquired = tryAcquireProcessLock(lockPath(workspace));
+        assert.equal(acquired, true);
+        const content = JSON.parse(fs.readFileSync(lockFile, 'utf8'));
+        assert.equal(content.pid, process.pid);
+    });
+    test('C4: concurrent callers — only one returns true (wx atomicity)', async () => {
+        const workspace = tempDirs.makeTempDir('lockfile-c4-');
+        // Call twice in the same tick; first wins, second sees EEXIST with live PID.
+        const r1 = tryAcquireProcessLock(lockPath(workspace));
+        const r2 = tryAcquireProcessLock(lockPath(workspace));
+        assert.equal(r1, true);
+        assert.equal(r2, false);
+    });
+    test('stale unparseable lockfile → treated as stale, returns true', () => {
+        const workspace = tempDirs.makeTempDir('lockfile-stale-');
+        const lockFile = lockPath(workspace);
+        fs.mkdirSync(lockDir(workspace), { recursive: true });
+        fs.writeFileSync(lockFile, 'not-json', 'utf8');
+        const acquired = tryAcquireProcessLock(lockPath(workspace));
+        assert.equal(acquired, true);
+    });
+});
+describe('releaseLock', () => {
+    test('C5: lockfile exists → deletes it', () => {
+        const workspace = tempDirs.makeTempDir('lockfile-c5-');
+        assert.equal(tryAcquireProcessLock(lockPath(workspace)), true);
+        const lockFile = lockPath(workspace);
+        assert.equal(fs.existsSync(lockFile), true);
+        releaseLock(lockPath(workspace));
+        assert.equal(fs.existsSync(lockFile), false);
+    });
+    test('C6: no lockfile → does not throw', () => {
+        const workspace = tempDirs.makeTempDir('lockfile-c6-');
+        assert.doesNotThrow(() => releaseLock(lockPath(workspace)));
+    });
+});

package/dist/utils/hash.d.ts

@@ -0,0 +1 @@
+export declare function sha256Hex(content: string): string;

package/dist/utils/hash.js

@@ -0,0 +1,4 @@
+import { createHash } from 'node:crypto';
+export function sha256Hex(content) {
+    return createHash('sha256').update(content).digest('hex');
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './async.js';
+export * from './files.js';
+export * from './hash.js';
+export * from './json.js';
+export * from './paths.js';
+export * from './utils.js';

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+export * from './async.js';
+export * from './files.js';
+export * from './hash.js';
+export * from './json.js';
+export * from './paths.js';
+export * from './utils.js';

package/dist/utils/json.d.ts

@@ -0,0 +1 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/utils/json.js

@@ -0,0 +1,3 @@
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/dist/utils/paths.d.ts

@@ -1,4 +1,3 @@
-export declare const AGENT_KIT_HOME: string;
 export declare const CREDENTIALS_FILE: string;
 export declare const MODEL_CACHE_DIR: string;
 export declare const FASTEMBED_CACHE_DIR: string;

package/dist/utils/paths.js

@@ -1,6 +1,6 @@
 import * as os from 'os';
 import * as path from 'path';
-export const AGENT_KIT_HOME = path.join(os.homedir(), '.agent-kit');
+const AGENT_KIT_HOME = path.join(os.homedir(), '.agent-kit');
 export const CREDENTIALS_FILE = path.join(AGENT_KIT_HOME, 'credentials');
 export const MODEL_CACHE_DIR = path.join(AGENT_KIT_HOME, 'cache', 'models');
 export const FASTEMBED_CACHE_DIR = path.join(MODEL_CACHE_DIR, 'fastembed');

package/dist/utils/temp-dir.test.d.ts

@@ -0,0 +1,4 @@
+export declare function createTempDirTracker(): {
+    makeTempDir(prefix: string): string;
+    cleanup(): void;
+};

package/dist/utils/temp-dir.test.js

@@ -0,0 +1,20 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+export function createTempDirTracker() {
+    const tempDirs = [];
+    return {
+        makeTempDir(prefix) {
+            const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+            tempDirs.push(tempDir);
+            return tempDir;
+        },
+        cleanup() {
+            while (tempDirs.length > 0) {
+                const tempDir = tempDirs.pop();
+                if (tempDir)
+                    fs.rmSync(tempDir, { recursive: true, force: true });
+            }
+        },
+    };
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@hanhnd/agent-kit",
-  "version": "1.0.31",
+  "version": "1.0.33",
   "description": "Agent Kit MCP server for software development agent workflows",
   "type": "module",
-  "main": "dist/kit-server.js",
+  "main": "dist/server.js",
   "bin": {
-    "agent-kit": "dist/kit-server.js"
+    "agent-kit": "dist/server.js",
+    "cli": "dist/cli.js"
   },
   "files": [
     "dist",
@@ -20,13 +21,14 @@
     "directory": "mcp"
   },
   "scripts": {
-    "build": "tsc && npm run bundle",
-    "bundle": "esbuild src/kit-server.ts --bundle --platform=node --format=esm --outfile=dist/kit-server.js --external:node:* --external:better-sqlite3 --external:sqlite-vec --external:fastembed --banner:js=\"import { createRequire } from 'module'; const require = createRequire(import.meta.url);\"",
+    "build": "rm -rf dist && tsc && npm run bundle",
+    "bundle": "esbuild src/entrypoints/server.ts src/entrypoints/cli.ts --bundle --platform=node --format=esm --outdir=dist --external:node:* --external:better-sqlite3 --external:sqlite-vec --external:fastembed --external:node-llama-cpp --banner:js=\"import { createRequire } from 'module'; const require = createRequire(import.meta.url);\"",
     "dev": "tsc --watch",
     "prepublishOnly": "npm run build",
-    "test": "tsc && node --test $(find dist/src/memory/__tests__ dist/src/tools/__tests__ -name '*.test.js' 2>/dev/null | tr '\\n' ' ')"
+    "test": "tsc && node --test $(find dist -name '*.test.js' | tr '\\n' ' ')"
   },
   "dependencies": {
+    "node-llama-cpp": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.13.1",
     "better-sqlite3": "^11.0.0",
     "dedent": "^1.5.3",

package/dist/memory/__tests__/embedder.test.js

@@ -1,14 +0,0 @@
-import * as assert from 'node:assert/strict';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import { describe, test } from 'node:test';
-import { DEFAULT_MODEL_CACHE_DIR, FASTEMBED_CACHE_DIR } from '../embedder.js';
-import { AGENT_KIT_HOME, CREDENTIALS_FILE } from '../../utils/paths.js';
-describe('Embedder cache paths', () => {
-    test('uses global Agent Kit home for user-level files', () => {
-        assert.equal(AGENT_KIT_HOME, path.join(os.homedir(), '.agent-kit'));
-        assert.equal(CREDENTIALS_FILE, path.join(AGENT_KIT_HOME, 'credentials'));
-        assert.equal(DEFAULT_MODEL_CACHE_DIR, path.join(AGENT_KIT_HOME, 'cache', 'models'));
-        assert.equal(FASTEMBED_CACHE_DIR, path.join(DEFAULT_MODEL_CACHE_DIR, 'fastembed'));
-    });
-});

package/dist/memory/types.js

@@ -1,9 +0,0 @@
-export const DEFAULT_MEMORY_CONFIG = {
-    enabled: false,
-    wikiDir: '',
-    topK: 5,
-    chunkSize: 1500,
-    overlapLines: 2,
-    embeddingModel: 'Xenova/bge-small-en-v1.5',
-    vectorDimension: 384,
-};

package/dist/tools/handoffs.d.ts

@@ -1,22 +0,0 @@
-export declare const HANDOFF_TYPES: readonly ["brainstorm", "clarification", "plan", "ticket", "research", "scenario", "investigation"];
-export type HandoffType = (typeof HANDOFF_TYPES)[number];
-export type CanonicalHandoffType = 'brainstorm' | 'clarification' | 'plan' | 'ticket' | 'research' | 'scenario' | 'investigation';
-export interface SavedHandoffLocation {
-    featureSlug: string;
-    canonicalType: CanonicalHandoffType;
-    filePath: string;
-    relativePath: string;
-}
-export declare function sanitizeFeatureSlug(value: string): string;
-export declare function normalizeHandoffType(type: HandoffType): CanonicalHandoffType;
-export declare function deriveFeatureSlug(input: {
-    requestedSlug: string;
-    content: string;
-    type: CanonicalHandoffType;
-}): string;
-export declare function resolveHandoffPath(input: {
-    workspaceRoot: string;
-    type: HandoffType;
-    slug: string;
-    content: string;
-}): SavedHandoffLocation;

package/dist/tools/memory.d.ts

@@ -1,16 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { MemoryIndexer } from '../memory/indexer.js';
-import { MemoryStore } from '../memory/store.js';
-import type { MemoryConfig } from '../memory/types.js';
-import { type ProjectSettings } from './config.js';
-/**
- * Registers tool handlers onto an already-constructed indexer/store pair.
- * Exported for unit testing with mocks.
- */
-export declare function registerMemoryToolHandlers(server: McpServer, indexer: MemoryIndexer, store: MemoryStore, config: MemoryConfig): void;
-/**
- * Initializes the memory subsystem and registers all memory tools.
- * Returns the MemoryIndexer so the caller can fire startupIndex() after server.connect().
- * Returns null when memory is disabled (settings.memory.enabled !== true).
- */
-export declare function registerMemoryTools(server: McpServer, settings: ProjectSettings, workspaceRoot: string): MemoryIndexer | null;