fix: multiple cleanup items

- doctor: resolve workspace main entry for npm-named adapters so minCoreVersion loads
- doctor: export resolveWorkspaceMainEntry from version-check.ts + index.ts
- AGENTS.md: fix stale npm scope @browserkit → @browserkit-dev
- CHANGELOG.md: fix header typo and rewrite to accurately separate 0.1.0 vs 0.2.0

Made-with: Cursor

Author: jonzarecki

AGENTS.md

@@ -4,7 +4,7 @@ Durable facts and correction patterns for this workspace. Updated by continual-l
 
 ## Project: browserkit
 
-- Project is named **browserkit** — decided and final. npm scope is `@browserkit`. GitHub org is `browserkit-dev` (`browserkit` org was taken on GitHub, available on npm).
+- Project is named **browserkit** — decided and final. npm scope is `@browserkit-dev`. GitHub org is `browserkit-dev` (`browserkit` org name was taken on both GitHub and npm; `@browserkit-dev` is the npm scope in use).
 - GitHub repos: `browserkit-dev/browserkit` (framework — `@browserkit-dev/core` + `@browserkit-dev/core/testing`), `browserkit-dev/adapter-hackernews`, `browserkit-dev/adapter-google-discover`, `browserkit-dev/adapter-linkedin` — all standalone public repos
 - Language is TypeScript, not Python
 - MCP transport is HTTP (`StreamableHTTPServerTransport`), not stdio — preferred for multi-agent deployment

packages/core/CHANGELOG.md

@@ -4,14 +4,21 @@
 
 ### Minor Changes
 
-- 732686d: Initial public release of @browserkit-dev/core — the framework for building site-specific MCP servers over authenticated browser sessions.
+- Adapter ecosystem hardening: `minCoreVersion` + `AdapterRequirements` on `SiteAdapter`, `version-check.ts` with `satisfies()`/`readCoreVersion()`, `browserkit doctor` CLI command, dynamic `create-adapter` scaffold versioning, cross-repo `test-adapters.yml` CI.
 
-  Key features:
+## 0.1.0
+
+### Minor Changes
+
+- Initial public release of @browserkit-dev/core — the framework for building site-specific MCP servers over authenticated browser sessions.
 
+  Key features:
   - `defineAdapter` / `SiteAdapter` interface for building adapters
   - `SessionManager` with persistent, storage-state, and CDP-attach strategies
   - `withLoginFlow` for opt-in automated form-based login
   - `waitUntil`, `fetchGetWithinPage`, `fetchPostWithinPage` and other scraping utilities
   - `preparePage` lifecycle hook for per-page configuration
   - `LockManager`, `RateLimiter`, and `withObservability` for production reliability
   - HTTP MCP transport via `StreamableHTTPServerTransport`
+  - `LockManager`, `RateLimiter`, and `withObservability` for production reliability
+  - HTTP MCP transport via `StreamableHTTPServerTransport`

packages/core/src/cli.ts

@@ -8,7 +8,7 @@ import { SessionManager, getDefaultDataDir } from "./session-manager.js";
 import { runLoginCommand } from "./human-handoff.js";import { createAdapter } from "./create-adapter.js";
 import type { FrameworkConfig, DaemonStatus, AdapterStatus } from "./types.js";
 import { getLogger } from "./logger.js";
-import { readCoreVersion, satisfies, readAdapterVersion } from "./version-check.js";
+import { readCoreVersion, satisfies, readAdapterVersion, resolveWorkspaceMainEntry } from "./version-check.js";
 
 const log = getLogger("cli");
 
@@ -449,7 +449,12 @@ async function cmdDoctor(args: string[]): Promise<void> {
     let loadError: string | undefined;
 
     try {
-      const mod = await import(key).catch(() => null);
+      // For npm package names that aren't in node_modules (workspace packages),
+      // resolve the main entry file via the workspace and import from that path.
+      const importKey = (key.startsWith("/") || key.startsWith("."))
+        ? key
+        : (resolveWorkspaceMainEntry(key) ?? key);
+      const mod = await import(importKey).catch(() => null);
       const adapter = mod?.default ?? mod;
       if (adapter && typeof adapter === "object") {
         minCoreVer = typeof adapter.minCoreVersion === "string" ? adapter.minCoreVersion : undefined;

packages/core/src/index.ts

@@ -88,7 +88,7 @@ export {
 export { withLoginFlow } from "./login-flow.js";
 
 // ─── Version utilities ────────────────────────────────────────────────────────
-export { readCoreVersion, satisfies, parseSemver, readAdapterVersion } from "./version-check.js";
+export { readCoreVersion, satisfies, parseSemver, readAdapterVersion, resolveWorkspaceMainEntry } from "./version-check.js";
 
 // ─── Observability ────────────────────────────────────────────────────────────
 export { withObservability } from "./observability.js";

packages/core/src/version-check.ts

@@ -135,3 +135,43 @@ function findInPnpmWorkspace(packageName: string): string | null {
     return null;
   }
 }
+
+/**
+ * For an npm package name, resolve its main entry file path via the pnpm
+ * workspace (for packages that are workspace members but not in node_modules).
+ * Returns null if not found in the workspace.
+ */
+export function resolveWorkspaceMainEntry(packageName: string): string | null {
+  try {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 10; i++) {
+      if (fs.existsSync(path.join(dir, "pnpm-workspace.yaml"))) {
+        const packagesDir = path.join(dir, "packages");
+        if (!fs.existsSync(packagesDir)) break;
+        for (const entry of fs.readdirSync(packagesDir)) {
+          const pkgJsonPath = path.join(packagesDir, entry, "package.json");
+          if (fs.existsSync(pkgJsonPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8")) as {
+              name?: string;
+              main?: string;
+              exports?: Record<string, unknown>;
+            };
+            if (pkg.name === packageName) {
+              // Prefer exports["."].import, fall back to main
+              const exportsDefault = (pkg.exports as { "."?: { import?: string } } | undefined)?.["."]?.import;
+              const mainEntry = exportsDefault ?? pkg.main ?? "dist/index.js";
+              return path.join(packagesDir, entry, mainEntry);
+            }
+          }
+        }
+        break;
+      }
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}