@detergent-software/atk 0.12.1-dev.2

package/build/lib/init.js

@@ -0,0 +1,295 @@
+import { execFile } from 'node:child_process';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { loadAllAdapters } from './adapter.js';
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const SCHEMA_BASE_URL = 'https://raw.githubusercontent.com/EmergentSoftware/agentic-toolkit/main/schemas';
+export const INIT_TYPES = ['skill', 'agent', 'rule', 'hook', 'memory-template', 'mcp-config', 'bundle'];
+// ---------------------------------------------------------------------------
+// Name validation
+// ---------------------------------------------------------------------------
+/**
+ * Check if a name+type combination already exists in the registry.
+ * Checks both the assets and bundles sections.
+ */
+export function checkNameAvailability(name, type, registry) {
+    if (type === 'bundle') {
+        const bundle = (registry.bundles ?? []).find((b) => b.name === name);
+        if (bundle) {
+            return { available: false, existingVersion: bundle.version };
+        }
+        return { available: true };
+    }
+    const asset = registry.assets.find((a) => a.name === name && a.type === type);
+    if (asset) {
+        return { available: false, existingVersion: asset.latest };
+    }
+    return { available: true };
+}
+// ---------------------------------------------------------------------------
+// Registry name check
+// ---------------------------------------------------------------------------
+/**
+ * Detect which tools support the given asset type by checking all loaded adapters.
+ * For 'bundle' type, returns an empty array (bundles are not placed by adapters).
+ */
+export async function detectCompatibleTools(assetType) {
+    if (assetType === 'bundle') {
+        return [];
+    }
+    const adapters = await loadAllAdapters();
+    const tools = [];
+    for (const adapter of adapters) {
+        const placement = adapter.placements[assetType];
+        if (placement) {
+            tools.push(adapter.tool);
+        }
+    }
+    return tools;
+}
+// ---------------------------------------------------------------------------
+// Git author detection
+// ---------------------------------------------------------------------------
+/**
+ * Look up an installed asset in the lockfile and read its files from disk.
+ * Returns the manifest data and file contents for pre-filling a new scaffold.
+ * Returns undefined if the asset is not found in the lockfile.
+ */
+export async function forkFromInstalled(fromName, lockfile, projectDir) {
+    // Find the asset in the lockfile (match by name, any type)
+    const installed = (lockfile.assets ?? []).find((a) => a.name === fromName);
+    if (!installed) {
+        return undefined;
+    }
+    const files = new Map();
+    // Read each installed file from disk
+    for (const file of installed.files) {
+        const filePath = join(projectDir, file.installedPath);
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            files.set(file.sourcePath, content);
+        }
+        catch {
+            // Skip files that cannot be read (may have been manually deleted)
+        }
+    }
+    // Build a manifest-like object from the installed asset data
+    const manifest = {
+        author: '',
+        dependencies: installed.dependencies ?? [],
+        description: '',
+        name: installed.name,
+        type: installed.type,
+        version: installed.version,
+    };
+    return { files, manifest };
+}
+// ---------------------------------------------------------------------------
+// Tool compatibility detection
+// ---------------------------------------------------------------------------
+/**
+ * Generate minimal stub content for an asset entrypoint file.
+ * Returns an empty string for types that have no entrypoint (mcp-config, bundle).
+ */
+export function generateEntrypointContent(type, name, description) {
+    const displayName = toDisplayName(name);
+    switch (type) {
+        case 'agent':
+        case 'memory-template':
+        case 'rule':
+        case 'skill':
+            return `# ${displayName}\n\n${description}\n`;
+        case 'bundle':
+        case 'mcp-config':
+            return '';
+        case 'hook':
+            return `#!/usr/bin/env bash\n# ${displayName} - ${description}\n\nset -euo pipefail\n\n# TODO: Implement hook logic\n`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Entrypoint naming
+// ---------------------------------------------------------------------------
+/**
+ * Generate a manifest JSON object for the given init options.
+ * Produces a manifest.json structure for assets or bundle.json structure for bundles.
+ */
+export function generateManifest(options) {
+    const toolEntries = options.tools.map((tool) => ({ tool }));
+    if (options.type === 'bundle') {
+        const bundleManifest = {
+            $schema: `${SCHEMA_BASE_URL}/bundle.schema.json`,
+            assets: (options.bundleAssets ?? []).map((ref) => {
+                // Parse "type:name" format if provided, otherwise treat as name-only
+                const parts = ref.split(':');
+                if (parts.length === 2) {
+                    return { name: parts[1], type: parts[0] };
+                }
+                return { name: ref, type: 'skill' };
+            }),
+            author: options.author,
+            description: options.description,
+            name: options.name,
+            tags: options.tags,
+            version: '1.0.0',
+        };
+        return bundleManifest;
+    }
+    const entrypoint = getEntrypointName(options.type, options.name);
+    const manifest = {
+        $schema: `${SCHEMA_BASE_URL}/manifest.schema.json`,
+        author: options.author,
+        dependencies: [],
+        description: options.description,
+        ...(entrypoint ? { entrypoint } : {}),
+        files: [],
+        name: options.name,
+        tags: options.tags,
+        tools: toolEntries,
+        trustLevel: 'experimental',
+        type: options.type,
+        version: '1.0.0',
+    };
+    return manifest;
+}
+// ---------------------------------------------------------------------------
+// Display name conversion
+// ---------------------------------------------------------------------------
+/**
+ * Generate README.md content for an asset.
+ * Includes type-specific sections for hooks and MCP configs.
+ */
+export function generateReadmeContent(type, name, description) {
+    const displayName = toDisplayName(name);
+    let content = `# ${displayName}\n\n${description}\n\n## Usage\n\n<!-- Describe how to use this asset -->\n\n## Configuration\n\n<!-- Describe any configuration options -->\n`;
+    if (type === 'hook') {
+        content += `\n## Hook Configuration\n\nWhen installed, this hook registers the following configuration:\n\n\`\`\`json\n{\n  "hooks": {\n    "EventName": [\n      {\n        "type": "command",\n        "command": "./${name}.sh"\n      }\n    ]\n  }\n}\n\`\`\`\n`;
+    }
+    if (type === 'mcp-config') {
+        content += `\n## MCP Server Configuration\n\nThis asset registers the following MCP server configuration:\n\n\`\`\`json\n{\n  "mcpServers": {\n    "${name}": {\n      "command": "npx",\n      "args": ["-y", "${name}"]\n    }\n  }\n}\n\`\`\`\n`;
+    }
+    return content;
+}
+// ---------------------------------------------------------------------------
+// Manifest generation
+// ---------------------------------------------------------------------------
+/**
+ * Get the entrypoint filename for a given asset type and name.
+ * Returns undefined for fileless types (mcp-config) and bundles.
+ */
+export function getEntrypointName(type, name) {
+    switch (type) {
+        case 'agent':
+            return `${name}.md`;
+        case 'bundle':
+            return undefined;
+        case 'hook':
+            return `${name}.sh`;
+        case 'mcp-config':
+            return undefined;
+        case 'memory-template':
+            return `${name}.md`;
+        case 'rule':
+            return `${name}.md`;
+        case 'skill':
+            return 'SKILL.md';
+    }
+}
+// ---------------------------------------------------------------------------
+// Entrypoint content generation
+// ---------------------------------------------------------------------------
+/**
+ * Attempt to read the git user.name config value.
+ * Returns undefined if git is not available or the value is not set.
+ */
+export async function getGitUserName() {
+    try {
+        const { stdout } = await execFileAsync('git', ['config', 'user.name']);
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// README generation
+// ---------------------------------------------------------------------------
+/**
+ * Scaffold a new asset or bundle directory with manifest and starter files.
+ *
+ * Creates `${outputBaseDir}/${options.name}/` with:
+ * - manifest.json (or bundle.json for bundle type)
+ * - Entrypoint file (if applicable)
+ * - README.md
+ */
+export async function scaffoldAsset(options, outputBaseDir) {
+    const outputDir = join(outputBaseDir, options.name);
+    const filesCreated = [];
+    // Create the output directory
+    await mkdir(outputDir, { recursive: true });
+    // Write manifest (bundle.json for bundles, manifest.json for assets)
+    const manifest = generateManifest(options);
+    const manifestFileName = options.type === 'bundle' ? 'bundle.json' : 'manifest.json';
+    await writeFile(join(outputDir, manifestFileName), JSON.stringify(manifest, null, '\t') + '\n', 'utf-8');
+    filesCreated.push(manifestFileName);
+    // Write entrypoint file if applicable
+    const entrypoint = getEntrypointName(options.type, options.name);
+    if (entrypoint) {
+        const content = generateEntrypointContent(options.type, options.name, options.description);
+        await writeFile(join(outputDir, entrypoint), content, 'utf-8');
+        filesCreated.push(entrypoint);
+    }
+    // Write README.md
+    const readmeContent = generateReadmeContent(options.type, options.name, options.description);
+    await writeFile(join(outputDir, 'README.md'), readmeContent, 'utf-8');
+    filesCreated.push('README.md');
+    return {
+        filesCreated,
+        name: options.name,
+        outputDir,
+        type: options.type,
+    };
+}
+// ---------------------------------------------------------------------------
+// Scaffolding orchestration
+// ---------------------------------------------------------------------------
+/**
+ * Validate an asset name is in kebab-case format.
+ * Rules: lowercase letters, numbers, and hyphens; must start with a letter; min 2 chars.
+ */
+export function validateAssetName(name) {
+    if (name.length < 2) {
+        return { error: 'Name must be at least 2 characters long', valid: false };
+    }
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        return {
+            error: 'Name must be kebab-case (lowercase letters, numbers, hyphens) and start with a letter',
+            valid: false,
+        };
+    }
+    if (name.endsWith('-')) {
+        return { error: 'Name must not end with a hyphen', valid: false };
+    }
+    if (name.includes('--')) {
+        return { error: 'Name must not contain consecutive hyphens', valid: false };
+    }
+    return { valid: true };
+}
+// ---------------------------------------------------------------------------
+// Fork from installed asset
+// ---------------------------------------------------------------------------
+/**
+ * Convert a kebab-case name to a display name with capitalized words.
+ * Example: "my-cool-skill" -> "My Cool Skill"
+ */
+function toDisplayName(name) {
+    return name
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=init.js.map

package/build/lib/init.js.map

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

package/build/lib/installer.d.ts

@@ -0,0 +1,50 @@
+import type { InstallPlan } from './resolver.js';
+import type { Adapter } from './schemas/adapter.js';
+export interface InstallOptions {
+    /** Adapter for the target tool. */
+    adapter: Adapter;
+    /** Bundle origin metadata when installing as part of a bundle. */
+    bundleOrigin?: {
+        name: string;
+        version: string;
+    };
+    /** Skip file conflict detection, allowing overwrite of non-ATK files. */
+    force?: boolean;
+    /** Callback for progress updates. */
+    onProgress?: (message: string) => void;
+    /** Pin the asset at the installed version. */
+    pin?: boolean;
+    /** Project root directory. */
+    projectDir: string;
+    /** Override registry branch for GitHub API calls. */
+    registryBranch?: string;
+}
+export interface InstallResult {
+    bundleOrigin?: {
+        name: string;
+        version: string;
+    };
+    configEntriesCreated: Array<{
+        file: string;
+        key: string;
+    }>;
+    filesPlaced: Array<{
+        destination: string;
+        source: string;
+    }>;
+    installReason: 'dependency' | 'direct';
+    name: string;
+    type: string;
+    version: string;
+}
+export declare class InstallerError extends Error {
+    constructor(message: string);
+}
+/**
+ * Execute a full install plan — install all assets in order.
+ * On partial failure, rolls back previously installed assets (deletes placed files,
+ * reverts config entries, removes lockfile entries) so the system is not left in
+ * an inconsistent state.
+ */
+export declare function executeInstallPlan(plan: InstallPlan, options: InstallOptions): Promise<InstallResult[]>;
+//# sourceMappingURL=installer.d.ts.map

package/build/lib/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/lib/installer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAYpD,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qCAAqC;IACrC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,8CAA8C;IAC9C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,oBAAoB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,WAAW,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,aAAa,EAAE,YAAY,GAAG,QAAQ,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA8E7G"}