@audiodn/agent-kit 0.1.0

package/dist/core/skill.js

@@ -0,0 +1,117 @@
+import { existsSync, readdirSync, rmSync, rmdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { SKILL_DIR } from '../paths.js';
+import { readIfExists, relativeFiles, sha256, writeFileEnsuringDir } from './fsutil.js';
+export const SKILL_TARGET_DIR = '.agents/skills/audiodn';
+const MANIFEST_NAME = '.audiodn-manifest.json';
+function manifestPath(base) {
+    return join(base, MANIFEST_NAME);
+}
+function readManifest(base) {
+    const raw = readIfExists(manifestPath(base));
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Install the Skill payload directory. Kit-owned files are tracked in a
+ * manifest so re-runs are idempotent and user edits are never clobbered.
+ */
+export function installSkill(cwd, version, opts = {}) {
+    const base = join(cwd, SKILL_TARGET_DIR);
+    const prevManifest = readManifest(base);
+    const entries = [];
+    const nextFiles = {};
+    for (const rel of relativeFiles(SKILL_DIR)) {
+        const srcContent = readIfExists(join(SKILL_DIR, rel));
+        if (srcContent === null)
+            continue;
+        const srcHash = sha256(srcContent);
+        const targetPath = join(base, rel);
+        const displayPath = `${SKILL_TARGET_DIR}/${rel}`;
+        const existing = readIfExists(targetPath);
+        if (existing === null) {
+            if (!opts.dryRun)
+                writeFileEnsuringDir(targetPath, srcContent);
+            entries.push({ path: displayPath, action: 'create' });
+            nextFiles[rel] = srcHash;
+            continue;
+        }
+        const existingHash = sha256(existing);
+        const tracked = prevManifest?.files?.[rel];
+        const userModified = tracked === undefined || tracked !== existingHash;
+        if (userModified && !opts.force) {
+            if (!opts.dryRun)
+                writeFileEnsuringDir(`${targetPath}.audiodn.new`, srcContent);
+            entries.push({ path: displayPath, action: 'conflict', note: 'wrote .audiodn.new' });
+            nextFiles[rel] = tracked ?? existingHash;
+            continue;
+        }
+        if (existingHash === srcHash) {
+            entries.push({ path: displayPath, action: 'unchanged' });
+            nextFiles[rel] = srcHash;
+            continue;
+        }
+        if (!opts.dryRun)
+            writeFileEnsuringDir(targetPath, srcContent);
+        entries.push({ path: displayPath, action: 'update' });
+        nextFiles[rel] = srcHash;
+    }
+    if (!opts.dryRun) {
+        const manifest = { version, files: nextFiles };
+        writeFileEnsuringDir(manifestPath(base), `${JSON.stringify(manifest, null, 2)}\n`);
+    }
+    return entries;
+}
+function pruneEmptyDirs(base, cwd) {
+    let dir = base;
+    while (dir.startsWith(cwd) && dir !== cwd) {
+        try {
+            if (existsSync(dir) && readdirSync(dir).length === 0) {
+                rmdirSync(dir);
+                dir = join(dir, '..');
+            }
+            else
+                break;
+        }
+        catch {
+            break;
+        }
+    }
+}
+export function uninstallSkill(cwd, opts = {}) {
+    const base = join(cwd, SKILL_TARGET_DIR);
+    const manifest = readManifest(base);
+    const entries = [];
+    if (!manifest)
+        return entries;
+    for (const [rel, hash] of Object.entries(manifest.files)) {
+        const targetPath = join(base, rel);
+        const displayPath = `${SKILL_TARGET_DIR}/${rel}`;
+        const existing = readIfExists(targetPath);
+        if (existing === null)
+            continue;
+        if (sha256(existing) !== hash) {
+            entries.push({ path: displayPath, action: 'skipped', note: 'modified by you' });
+            continue;
+        }
+        if (!opts.dryRun)
+            rmSync(targetPath);
+        entries.push({ path: displayPath, action: 'removed' });
+    }
+    if (!opts.dryRun) {
+        const mp = manifestPath(base);
+        if (existsSync(mp))
+            rmSync(mp);
+        pruneEmptyDirs(join(base, 'scripts'), cwd);
+        pruneEmptyDirs(join(base, 'references'), cwd);
+        pruneEmptyDirs(join(base, 'templates'), cwd);
+        pruneEmptyDirs(base, cwd);
+    }
+    return entries;
+}

package/dist/paths.d.ts

@@ -0,0 +1,5 @@
+export declare const PACKAGE_ROOT: string;
+export declare const ASSETS_DIR: string;
+export declare const CONTENT_DIR: string;
+export declare const SKILL_DIR: string;
+export declare const SNAPSHOTS_DIR: string;

package/dist/paths.js

@@ -0,0 +1,10 @@
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+// Resolves the package root in both dev (src/paths.ts) and build (dist/paths.js):
+// in both cases the file sits one directory below the package root.
+const here = dirname(fileURLToPath(import.meta.url));
+export const PACKAGE_ROOT = join(here, '..');
+export const ASSETS_DIR = join(PACKAGE_ROOT, 'assets');
+export const CONTENT_DIR = join(ASSETS_DIR, 'content');
+export const SKILL_DIR = join(ASSETS_DIR, 'skill');
+export const SNAPSHOTS_DIR = join(ASSETS_DIR, 'snapshots');

package/dist/version.d.ts

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

package/dist/version.js

@@ -0,0 +1,12 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { PACKAGE_ROOT } from './paths.js';
+export function getVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+        return typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@audiodn/agent-kit",
+  "version": "0.1.0",
+  "description": "Install AudioDN coding-agent guidance (AGENTS.md, CLAUDE.md, Copilot, Cursor, Skill) and validate AudioDN integrations.",
+  "type": "module",
+  "bin": {
+    "audiodn-agent-kit": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "audiodn",
+    "audio",
+    "agents",
+    "coding-agent",
+    "claude",
+    "copilot",
+    "cursor",
+    "skill",
+    "cli",
+    "scaffold"
+  ],
+  "author": {
+    "name": "AudioDN",
+    "url": "https://github.com/audiodn"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/audiodn/audiodn-agent-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/audiodn/audiodn-agent-kit/issues"
+  },
+  "homepage": "https://github.com/audiodn/audiodn-agent-kit#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "sync": "node scripts/sync-canonical.mjs",
+    "smoke": "node scripts/smoke.mjs",
+    "prepublishOnly": "npm run test && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.8"
+  }
+}