@alfe.ai/integrations 0.0.3 → 0.0.4

package/dist/index.d.ts

@@ -8,11 +8,10 @@
 interface RegistryEntry {
   /** Human-readable display name (e.g. 'Alfe Voice') */
   name?: string;
-  repo: string;
-  /** GitHub repository URL (HTTPS, no .git suffix) for public clone */
-  repository?: string;
-  /** Pinned commit SHA — when present, install uses this exact commit instead of a tag */
-  commit?: string;
+  /** GitHub repository URL (HTTPS) for public clone */
+  repository: string;
+  /** Git commit SHA — installer clones and checks out this exact commit */
+  commit: string;
   /** Subdirectory within the repo where the integration lives (for monorepos) */
   subdir?: string;
   versions: string[];
@@ -103,11 +102,10 @@ declare class Registry {
 interface ResolvedIntegration {
   id: string;
   name?: string;
-  repo: string;
+  repository: string;
   version: string;
-  tag: string;
-  /** Pinned commit SHA — when present, installer uses this instead of tag */
-  commit?: string;
+  /** Git commit SHA to checkout after clone */
+  commit: string;
   /** Subdirectory within the repo where the integration lives (for monorepos) */
   subdir?: string;
   description: string;
@@ -123,7 +121,7 @@ declare class Resolver {
    *
    * @param name - Integration name (e.g. "discord")
    * @param version - Specific version (e.g. "1.0.0") or undefined for latest
-   * @returns Resolved integration with repo URL and git tag
+   * @returns Resolved integration with repo URL and commit hash
    */
   resolve(id: string, version?: string): Promise<ResolvedIntegration>;
   /**
@@ -165,7 +163,7 @@ declare class Installer {
    */
   getClonePath(name: string): string;
   /**
-   * Install an integration by cloning its git repo and checking out the version tag.
+   * Install an integration by cloning its git repo and checking out the pinned commit.
    * Returns the effective install path (with subdir if present).
    */
   install(resolved: ResolvedIntegration): Promise<string>;
@@ -287,6 +285,8 @@ interface IntegrationManifest {
   config_schema: ConfigSchemaField[];
   capabilities: string[];
   hooks: IntegrationHooks;
+  /** Git repository URL (HTTPS, with .git suffix) — used by installer to clone */
+  repository: string;
   /**
    * Agent runtimes this integration supports.
    * If omitted or empty, the integration is considered universal (all runtimes).

package/dist/index.js

@@ -83,7 +83,7 @@ var Resolver = class {
 	*
 	* @param name - Integration name (e.g. "discord")
 	* @param version - Specific version (e.g. "1.0.0") or undefined for latest
-	* @returns Resolved integration with repo URL and git tag
+	* @returns Resolved integration with repo URL and commit hash
 	*/
 	async resolve(id, version) {
 		const entry = await this.registry.get(id);
@@ -93,9 +93,8 @@ var Resolver = class {
 		return {
 			id,
 			name: entry.name,
-			repo: entry.repository ? `${entry.repository}.git` : entry.repo,
+			repository: entry.repository,
 			version: resolvedVersion,
-			tag: `v${resolvedVersion}`,
 			commit: entry.commit,
 			subdir: entry.subdir,
 			description: entry.description
@@ -119,10 +118,10 @@ var Resolver = class {
 //#endregion
 //#region src/installer.ts
 /**
-* Installer — git clone/fetch integrations to ~/.alfe/integrations/{name}/.
+* Installer — git clone integrations to ~/.alfe/integrations/{name}/.
 *
 * Manages the local installation directory for integration repos.
-* Each integration is a shallow git clone checked out to a version tag.
+* Each integration is cloned and checked out to a pinned commit hash.
 */
 const execFileAsync$1 = promisify(execFile);
 const INTEGRATIONS_DIR = join(homedir(), ".alfe", "integrations");
@@ -160,7 +159,7 @@ var Installer = class {
 		return join(this.basePath, name);
 	}
 	/**
-	* Install an integration by cloning its git repo and checking out the version tag.
+	* Install an integration by cloning its git repo and checking out the pinned commit.
 	* Returns the effective install path (with subdir if present).
 	*/
 	async install(resolved) {
@@ -169,25 +168,15 @@ var Installer = class {
 		if (resolved.subdir) this.subdirs.set(resolved.id, resolved.subdir);
 		mkdirSync(this.basePath, { recursive: true });
 		try {
-			if (resolved.commit) {
-				await execFileAsync$1("git", [
-					"clone",
-					resolved.repo,
-					clonePath
-				], { timeout: GIT_TIMEOUT_MS });
-				await execFileAsync$1("git", ["checkout", resolved.commit], {
-					cwd: clonePath,
-					timeout: GIT_TIMEOUT_MS
-				});
-			} else await execFileAsync$1("git", [
+			await execFileAsync$1("git", [
 				"clone",
-				"--depth",
-				"1",
-				"--branch",
-				resolved.tag,
-				resolved.repo,
+				resolved.repository,
 				clonePath
 			], { timeout: GIT_TIMEOUT_MS });
+			await execFileAsync$1("git", ["checkout", resolved.commit], {
+				cwd: clonePath,
+				timeout: GIT_TIMEOUT_MS
+			});
 		} catch (err) {
 			if (existsSync(clonePath)) rmSync(clonePath, {
 				recursive: true,
@@ -208,18 +197,11 @@ var Installer = class {
 		if (resolved.subdir) this.subdirs.set(name, resolved.subdir);
 		else this.subdirs.delete(name);
 		try {
-			await execFileAsync$1("git", [
-				"fetch",
-				"--depth",
-				"1",
-				"origin",
-				`tag`,
-				resolved.tag
-			], {
+			await execFileAsync$1("git", ["fetch", "origin"], {
 				cwd: clonePath,
 				timeout: GIT_TIMEOUT_MS
 			});
-			await execFileAsync$1("git", ["checkout", resolved.tag], {
+			await execFileAsync$1("git", ["checkout", resolved.commit], {
 				cwd: clonePath,
 				timeout: GIT_TIMEOUT_MS
 			});
@@ -711,7 +693,7 @@ var IntegrationManager = class {
 		});
 		try {
 			const resolved = await this.resolver.resolve(name, version);
-			this.log.info(`Resolved ${name}@${resolved.version} from ${resolved.repo}`);
+			this.log.info(`Resolved ${name}@${resolved.version} from ${resolved.repository}`);
 			const installPath = await this.installer.install(resolved);
 			this.log.info(`Cloned to ${installPath}`);
 			const manifestPath = join(installPath, "alfe-integration.yaml");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integrations",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "@auriclabs/logger": "^0.1.1",
-    "@alfe.ai/integration-manifest": "^0.0.2"
+    "@alfe.ai/integration-manifest": "^0.0.3"
   },
   "files": [
     "dist"