@detergent-software/atk 0.12.1-dev.2

package/build/lib/github.js

@@ -0,0 +1,96 @@
+import { fetchWithRetry } from './fetch-retry.js';
+import { isPreRelease } from './version.js';
+export const DEFAULT_REGISTRY_REPO = 'EmergentSoftware/agentic-toolkit';
+export const DEFAULT_REGISTRY_BRANCH = 'main';
+export const DEFAULT_REGISTRY_BRANCH_DEV = 'develop';
+/**
+ * Determine the effective registry branch based on explicit override or pre-release detection.
+ * Pre-release builds (e.g., 0.4.0-dev.5) default to the develop branch.
+ */
+export function getEffectiveBranch(registryBranch) {
+    return registryBranch ?? (isPreRelease() ? DEFAULT_REGISTRY_BRANCH_DEV : DEFAULT_REGISTRY_BRANCH);
+}
+/** GitHub API version used for all API requests. */
+export const GITHUB_API_VERSION = '2022-11-28';
+/** Accept header value for standard JSON responses from GitHub API. */
+export const GITHUB_ACCEPT_JSON = 'application/vnd.github+json';
+/** Accept header value for raw file content responses from GitHub API. */
+export const GITHUB_ACCEPT_RAW = 'application/vnd.github.raw+json';
+/**
+ * Build a GitHub Contents API URL for a file or directory in the registry repo.
+ */
+export function buildGitHubContentsUrl(path, branch) {
+    const ref = branch ?? DEFAULT_REGISTRY_BRANCH;
+    return `https://api.github.com/repos/${DEFAULT_REGISTRY_REPO}/contents/${path}?ref=${ref}`;
+}
+/**
+ * Build standard GitHub API request headers.
+ *
+ * @param token - GitHub authentication token (Bearer)
+ * @param accept - Accept header value; defaults to GITHUB_ACCEPT_JSON
+ * @returns HeadersInit with Accept, Authorization, and X-GitHub-Api-Version
+ */
+export function buildGitHubHeaders(token, accept) {
+    return {
+        Accept: accept ?? GITHUB_ACCEPT_JSON,
+        Authorization: `Bearer ${token}`,
+        'X-GitHub-Api-Version': GITHUB_API_VERSION,
+    };
+}
+/**
+ * Fetch raw file content from the GitHub Contents API.
+ *
+ * @param token - GitHub authentication token
+ * @param path - Repository-relative file path (e.g. "assets/skills/my-skill/1.0.0/skill.md")
+ * @param branch - Optional branch override; defaults to the registry default branch
+ */
+export async function fetchFileContent(token, path, branch) {
+    const url = buildGitHubContentsUrl(path, branch);
+    const response = await fetchWithRetry(url, {
+        headers: buildGitHubHeaders(token, GITHUB_ACCEPT_RAW),
+    });
+    if (!response.ok) {
+        throw new Error(httpErrorMessage(response.status, `file ${path}`));
+    }
+    return response.text();
+}
+/**
+ * Return a user-friendly error message for common GitHub API HTTP status codes.
+ */
+export function httpErrorMessage(status, resource) {
+    switch (status) {
+        case 401:
+        case 403:
+            return 'Authentication failed. Check your GitHub token or run `gh auth login`.';
+        case 404:
+            return `File not found at ${resource}.`;
+        case 429:
+            return 'GitHub API rate limit exceeded. Try again later.';
+        default:
+            return `Failed to fetch ${resource}: HTTP ${status}`;
+    }
+}
+/**
+ * List installable files in an asset's versioned directory on GitHub.
+ * Filters out directories, `manifest.json`, and `README.md`.
+ *
+ * @param token - GitHub authentication token
+ * @param asset - Object with `name` and `type` identifying the asset
+ * @param version - Semver version string
+ * @param branch - Optional branch override
+ */
+export async function listAssetDirectoryFiles(token, asset, version, branch) {
+    const assetDir = `assets/${asset.type}s/${asset.name}/${version}`;
+    const url = buildGitHubContentsUrl(assetDir, branch);
+    const response = await fetchWithRetry(url, {
+        headers: buildGitHubHeaders(token),
+    });
+    if (!response.ok) {
+        throw new Error(httpErrorMessage(response.status, 'asset file list'));
+    }
+    const contents = (await response.json());
+    return contents
+        .filter((item) => item.type === 'file' && item.name !== 'manifest.json' && item.name !== 'README.md')
+        .map((item) => ({ name: item.name, path: item.path }));
+}
+//# sourceMappingURL=github.js.map

package/build/lib/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/lib/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,kCAAkC,CAAC;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC9C,MAAM,CAAC,MAAM,2BAA2B,GAAG,SAAS,CAAC;AAErD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAAuB;IACxD,OAAO,cAAc,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;AACpG,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,6BAA6B,CAAC;AAEhE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,iCAAiC,CAAC;AAQnE;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAAe;IAClE,MAAM,GAAG,GAAG,MAAM,IAAI,uBAAuB,CAAC;IAC9C,OAAO,gCAAgC,qBAAqB,aAAa,IAAI,QAAQ,GAAG,EAAE,CAAC;AAC7F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,MAAe;IAC/D,OAAO;QACL,MAAM,EAAE,MAAM,IAAI,kBAAkB;QACpC,aAAa,EAAE,UAAU,KAAK,EAAE;QAChC,sBAAsB,EAAE,kBAAkB;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAY,EAAE,MAAe;IACjF,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE;QACzC,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,CAAC;KACtD,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,QAAgB;IAC/D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,wEAAwE,CAAC;QAClF,KAAK,GAAG;YACN,OAAO,qBAAqB,QAAQ,GAAG,CAAC;QAC1C,KAAK,GAAG;YACN,OAAO,kDAAkD,CAAC;QAC5D;YACE,OAAO,mBAAmB,QAAQ,UAAU,MAAM,EAAE,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAa,EACb,KAAqC,EACrC,OAAe,EACf,MAAe;IAEf,MAAM,QAAQ,GAAG,UAAU,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IAClE,MAAM,GAAG,GAAG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE;QACzC,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIrC,CAAC;IAEH,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;SACpG,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/build/lib/gitignore.d.ts

@@ -0,0 +1,37 @@
+import type { Adapter } from './schemas/adapter.js';
+/**
+ * Ensure that all required gitignore entries for an adapter's placements
+ * are present in the project's `.gitignore` file.
+ *
+ * - Reads `.gitignore` from `projectDir` (creates it if missing)
+ * - Determines which placement path patterns should be gitignored
+ * - Checks which patterns are already present
+ * - Appends missing entries under a `# ATK managed assets` comment header
+ *
+ * Returns which entries were added vs already present.
+ */
+export declare function ensureGitignoreEntries(projectDir: string, adapter: Adapter): Promise<{
+    added: string[];
+    alreadyPresent: string[];
+}>;
+/**
+ * Extract gitignore patterns from an adapter's placements.
+ *
+ * Includes directory-based placements where assets are placed into dedicated
+ * per-asset paths (identified by `{name}` in the path template).
+ *
+ * Excludes:
+ * - `fileless` placements (e.g., mcp-config) — no files are placed on disk
+ * - Shared-file placements without `{name}` in the path (e.g., memory-template
+ *   targeting `.claude/CLAUDE.md`) — these target user-managed files that should
+ *   not be gitignored
+ */
+export declare function getGitignorePatterns(adapter: Adapter): string[];
+/**
+ * Check if a gitignore pattern (or its equivalent) is already present
+ * in the gitignore content.
+ *
+ * Handles minor variations such as trailing slashes and leading slashes.
+ */
+export declare function isEntryPresent(gitignoreContent: string, pattern: string): boolean;
+//# sourceMappingURL=gitignore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/lib/gitignore.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6DxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CA+B/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAYjF"}

package/build/lib/gitignore.js

@@ -0,0 +1,142 @@
+import { existsSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const ATK_HEADER = '# ATK managed assets';
+/**
+ * Ensure that all required gitignore entries for an adapter's placements
+ * are present in the project's `.gitignore` file.
+ *
+ * - Reads `.gitignore` from `projectDir` (creates it if missing)
+ * - Determines which placement path patterns should be gitignored
+ * - Checks which patterns are already present
+ * - Appends missing entries under a `# ATK managed assets` comment header
+ *
+ * Returns which entries were added vs already present.
+ */
+export async function ensureGitignoreEntries(projectDir, adapter) {
+    const gitignorePath = join(projectDir, '.gitignore');
+    const patterns = getGitignorePatterns(adapter);
+    if (patterns.length === 0) {
+        return { added: [], alreadyPresent: [] };
+    }
+    // Read existing content or start with empty string
+    let content = '';
+    if (existsSync(gitignorePath)) {
+        content = await readFile(gitignorePath, 'utf-8');
+    }
+    const added = [];
+    const alreadyPresent = [];
+    for (const pattern of patterns) {
+        if (isEntryPresent(content, pattern)) {
+            alreadyPresent.push(pattern);
+        }
+        else {
+            added.push(pattern);
+        }
+    }
+    if (added.length === 0) {
+        return { added, alreadyPresent };
+    }
+    // Build the new entries block
+    const newEntries = added.join('\n');
+    // Determine whether the ATK header already exists in the file
+    const hasHeader = content.includes(ATK_HEADER);
+    let updatedContent;
+    if (hasHeader) {
+        // Append new entries after the existing ATK section.
+        // Find the header and insert after the last contiguous non-empty line
+        // following it (i.e., at the end of the ATK block).
+        const lines = content.split('\n');
+        const headerIndex = lines.findIndex((line) => line.trim() === ATK_HEADER);
+        let insertIndex = headerIndex + 1;
+        // Walk past existing entries in the ATK block
+        while (insertIndex < lines.length && lines[insertIndex].trim() !== '' && !lines[insertIndex].startsWith('#')) {
+            insertIndex++;
+        }
+        lines.splice(insertIndex, 0, newEntries);
+        updatedContent = lines.join('\n');
+    }
+    else {
+        // Append a new ATK section at the end of the file
+        const separator = content.length > 0 && !content.endsWith('\n') ? '\n\n' : content.length > 0 ? '\n' : '';
+        updatedContent = `${content}${separator}${ATK_HEADER}\n${newEntries}\n`;
+    }
+    await writeFile(gitignorePath, updatedContent, 'utf-8');
+    return { added, alreadyPresent };
+}
+/**
+ * Extract gitignore patterns from an adapter's placements.
+ *
+ * Includes directory-based placements where assets are placed into dedicated
+ * per-asset paths (identified by `{name}` in the path template).
+ *
+ * Excludes:
+ * - `fileless` placements (e.g., mcp-config) — no files are placed on disk
+ * - Shared-file placements without `{name}` in the path (e.g., memory-template
+ *   targeting `.claude/CLAUDE.md`) — these target user-managed files that should
+ *   not be gitignored
+ */
+export function getGitignorePatterns(adapter) {
+    const patterns = [];
+    for (const placement of Object.values(adapter.placements ?? {})) {
+        if (!placement)
+            continue;
+        // Skip fileless placements (e.g., mcp-config)
+        if (placement.fileless)
+            continue;
+        // Skip shared-file placements that don't have a per-asset path template.
+        // These target shared config files (e.g., .claude/CLAUDE.md) that may
+        // contain user-managed content and should not be gitignored.
+        if (!placement.path.includes('{name}'))
+            continue;
+        // Extract the directory portion before the {name} template variable.
+        // For ".claude/skills/{name}/" → ".claude/skills/"
+        // For ".claude/agents/{name}.md" → ".claude/agents/"
+        const nameIndex = placement.path.indexOf('{name}');
+        const dirPath = placement.path.slice(0, nameIndex);
+        if (dirPath.length === 0)
+            continue;
+        // Normalize to forward slashes for gitignore compatibility
+        const normalized = dirPath.split('\\').join('/');
+        if (!patterns.includes(normalized)) {
+            patterns.push(normalized);
+        }
+    }
+    return patterns.sort();
+}
+/**
+ * Check if a gitignore pattern (or its equivalent) is already present
+ * in the gitignore content.
+ *
+ * Handles minor variations such as trailing slashes and leading slashes.
+ */
+export function isEntryPresent(gitignoreContent, pattern) {
+    const lines = gitignoreContent.split('\n').map((line) => line.trim());
+    // Normalize the target pattern for comparison
+    const normalized = normalizePattern(pattern);
+    return lines.some((line) => {
+        // Skip comments and empty lines
+        if (line === '' || line.startsWith('#'))
+            return false;
+        return normalizePattern(line) === normalized;
+    });
+}
+/**
+ * Normalize a gitignore pattern for comparison.
+ * Strips leading `/`, trailing whitespace, and normalizes trailing slashes.
+ */
+function normalizePattern(pattern) {
+    let normalized = pattern.trim();
+    // Normalize path separators first so trailing `\` becomes `/`
+    normalized = normalized.split('\\').join('/');
+    // Remove leading slash (gitignore treats `/foo` and `foo` similarly for root patterns)
+    if (normalized.startsWith('/')) {
+        normalized = normalized.slice(1);
+    }
+    // Remove trailing slash for comparison (`.claude/skills/` === `.claude/skills`)
+    if (normalized.endsWith('/')) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+}
+//# sourceMappingURL=gitignore.js.map

package/build/lib/gitignore.js.map

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

package/build/lib/init.d.ts

@@ -0,0 +1,100 @@
+import type { Lockfile } from './schemas/lockfile.js';
+import type { Registry } from './schemas/registry.js';
+export declare const SCHEMA_BASE_URL = "https://raw.githubusercontent.com/EmergentSoftware/agentic-toolkit/main/schemas";
+export declare const INIT_TYPES: readonly ["skill", "agent", "rule", "hook", "memory-template", "mcp-config", "bundle"];
+export interface InitOptions {
+    /** Author name. */
+    author: string;
+    /** Assets to include in a bundle (only used when type is 'bundle'). */
+    bundleAssets?: string[];
+    /** Short description. */
+    description: string;
+    /** Fork from an existing installed asset. */
+    from?: string;
+    /** Asset name (kebab-case). */
+    name: string;
+    /** Skip registry name availability check. */
+    offline: boolean;
+    /** Comma-separated tags. */
+    tags: string[];
+    /** Compatible tool identifiers. */
+    tools: string[];
+    /** Init type (asset type or 'bundle'). */
+    type: InitType;
+}
+export interface InitResult {
+    /** List of files created (relative to outputDir). */
+    filesCreated: string[];
+    /** Asset name. */
+    name: string;
+    /** Absolute path to the created directory. */
+    outputDir: string;
+    /** Init type. */
+    type: InitType;
+}
+export type InitType = (typeof INIT_TYPES)[number];
+/**
+ * Check if a name+type combination already exists in the registry.
+ * Checks both the assets and bundles sections.
+ */
+export declare function checkNameAvailability(name: string, type: InitType, registry: Registry): {
+    available: boolean;
+    existingVersion?: string;
+};
+/**
+ * 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 declare function detectCompatibleTools(assetType: InitType): Promise<string[]>;
+/**
+ * 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 declare function forkFromInstalled(fromName: string, lockfile: Lockfile, projectDir: string): Promise<undefined | {
+    files: Map<string, string>;
+    manifest: Record<string, unknown>;
+}>;
+/**
+ * Generate minimal stub content for an asset entrypoint file.
+ * Returns an empty string for types that have no entrypoint (mcp-config, bundle).
+ */
+export declare function generateEntrypointContent(type: InitType, name: string, description: string): string;
+/**
+ * Generate a manifest JSON object for the given init options.
+ * Produces a manifest.json structure for assets or bundle.json structure for bundles.
+ */
+export declare function generateManifest(options: InitOptions): Record<string, unknown>;
+/**
+ * Generate README.md content for an asset.
+ * Includes type-specific sections for hooks and MCP configs.
+ */
+export declare function generateReadmeContent(type: InitType, name: string, description: string): string;
+/**
+ * Get the entrypoint filename for a given asset type and name.
+ * Returns undefined for fileless types (mcp-config) and bundles.
+ */
+export declare function getEntrypointName(type: InitType, name: string): string | undefined;
+/**
+ * Attempt to read the git user.name config value.
+ * Returns undefined if git is not available or the value is not set.
+ */
+export declare function getGitUserName(): Promise<string | undefined>;
+/**
+ * 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 declare function scaffoldAsset(options: InitOptions, outputBaseDir: string): Promise<InitResult>;
+/**
+ * Validate an asset name is in kebab-case format.
+ * Rules: lowercase letters, numbers, and hyphens; must start with a letter; min 2 chars.
+ */
+export declare function validateAssetName(name: string): {
+    error?: string;
+    valid: boolean;
+};
+//# sourceMappingURL=init.d.ts.map

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

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