@offworld/sdk 0.3.1 → 0.3.2

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as AuthData, $t as getMetaRoot, A as pruneRepos, At as updateRepo, B as resolveFromNpm, Bt as removeGlobalMapEntry, C as RepoStatusOptions, Ct as getCommitDistance, D as discoverRepos, Dt as listRepos, E as UpdateAllResult, Et as isShallowClone, F as matchDependenciesToReferences, Ft as getMapEntry, G as AgentConfig, Gt as PathNotFoundError, H as ManifestType, Ht as writeGlobalMap, I as matchDependenciesToReferencesWithRemoteCheck, It as getProjectMapPath, J as getAgentConfig, Jt as parseRepoInput, K as agents, Kt as RepoSourceError, L as FALLBACK_MAPPINGS, Lt as resolveRepoKey, M as ReferenceMatch, Mt as MapEntry, N as ReferenceStatus, Nt as SearchMapOptions, O as gcRepos, Ot as removeRepo, P as isReferenceInstalled, Pt as SearchResult, Q as installReference, Qt as getMetaPath, R as ResolvedDep, Rt as searchMap, S as PruneResult, St as getClonedRepoPath, T as UpdateAllOptions, Tt as isRepoCloned, U as detectManifestType, Ut as writeProjectMap, V as Dependency, Vt as upsertGlobalMapEntry, W as parseDependencies, Wt as NotGitRepoError, X as InstallReferenceMeta, Xt as expandTilde, Y as getAllAgentConfigs, Yt as Paths, Z as installGlobalSkill, Zt as getConfigPath, _ as DiscoverOptions, _t as RepoExistsError, a as GlobalMap, an as toMetaDirName, at as getAuthPath, b as GcResult, bt as UpdateResult, c as ProjectMapRepoEntry, cn as DEFAULT_IGNORE_PATTERNS, ct as getTokenOrNull, d as ProviderInfo, dt as refreshAccessToken, en as getReferencePath, et as AuthError, f as ProviderWithModels, ft as saveAuthData, g as validateProviderModel, gt as RemoveOptions, h as listProvidersWithModels, ht as GitError, i as FileRole, in as saveConfig, it as clearAuthData, j as updateAllRepos, jt as GetMapEntryOptions, k as getRepoStatus, kt as unshallowRepo, l as RepoSource, ln as VERSION, lt as isLoggedIn, m as listProviders, mt as CloneOptions, n as FileIndex, nn as getRepoRoot, nt as NotLoggedInError, o as GlobalMapRepoEntry, on as toReferenceFileName, ot as getAuthStatus, p as getProvider, pt as CloneError, q as detectInstalledAgents, qt as getReferenceFileNameForSource, r as FileIndexEntry, rn as loadConfig, rt as TokenExpiredError, s as ProjectMap, sn as toReferenceName, st as getToken, t as Config, tn as getRepoPath, tt as AuthStatus, u as ModelInfo, ut as loadAuthData, v as DiscoverResult, vt as RepoNotFoundError, w as RepoStatusSummary, wt as getCommitSha, x as PruneOptions, xt as cloneRepo, y as GcOptions, yt as UpdateOptions, z as resolveDependencyRepo, zt as readGlobalMap } from "./public-Cdr8rPRd.mjs";
-export { AgentConfig, AuthData, AuthError, AuthStatus, CloneError, CloneOptions, Config, DEFAULT_IGNORE_PATTERNS, Dependency, DiscoverOptions, DiscoverResult, FALLBACK_MAPPINGS, FileIndex, FileIndexEntry, FileRole, GcOptions, GcResult, GetMapEntryOptions, GitError, GlobalMap, GlobalMapRepoEntry, InstallReferenceMeta, ManifestType, MapEntry, ModelInfo, NotGitRepoError, NotLoggedInError, PathNotFoundError, Paths, ProjectMap, ProjectMapRepoEntry, ProviderInfo, ProviderWithModels, PruneOptions, PruneResult, ReferenceMatch, ReferenceStatus, RemoveOptions, RepoExistsError, RepoNotFoundError, RepoSource, RepoSourceError, RepoStatusOptions, RepoStatusSummary, ResolvedDep, SearchMapOptions, SearchResult, TokenExpiredError, UpdateAllOptions, UpdateAllResult, UpdateOptions, UpdateResult, VERSION, agents, clearAuthData, cloneRepo, detectInstalledAgents, detectManifestType, discoverRepos, expandTilde, gcRepos, getAgentConfig, getAllAgentConfigs, getAuthPath, getAuthStatus, getClonedRepoPath, getCommitDistance, getCommitSha, getConfigPath, getMapEntry, getMetaPath, getMetaRoot, getProjectMapPath, getProvider, getReferenceFileNameForSource, getReferencePath, getRepoPath, getRepoRoot, getRepoStatus, getToken, getTokenOrNull, installGlobalSkill, installReference, isLoggedIn, isReferenceInstalled, isRepoCloned, isShallowClone, listProviders, listProvidersWithModels, listRepos, loadAuthData, loadConfig, matchDependenciesToReferences, matchDependenciesToReferencesWithRemoteCheck, parseDependencies, parseRepoInput, pruneRepos, readGlobalMap, refreshAccessToken, removeGlobalMapEntry, removeRepo, resolveDependencyRepo, resolveFromNpm, resolveRepoKey, saveAuthData, saveConfig, searchMap, toMetaDirName, toReferenceFileName, toReferenceName, unshallowRepo, updateAllRepos, updateRepo, upsertGlobalMapEntry, validateProviderModel, writeGlobalMap, writeProjectMap };
+import { $ as installReference, $t as getConfigPath, A as pruneRepos, At as removeRepo, B as resolveDependencyRepo, Bt as searchMap, C as RepoStatusOptions, Ct as cloneRepo, D as discoverRepos, Dt as isRepoCloned, E as UpdateAllResult, Et as getCommitSha, F as matchDependenciesToReferences, Ft as SearchMapOptions, G as parseDependencies, Gt as writeProjectMap, H as Dependency, Ht as removeGlobalMapEntry, I as matchDependenciesToReferencesWithRemoteCheck, It as SearchResult, J as detectInstalledAgents, Jt as RepoSourceError, K as AgentConfig, Kt as NotGitRepoError, L as FALLBACK_MAPPINGS, Lt as getMapEntry, M as ReferenceMatch, Mt as updateRepo, N as ReferenceStatus, Nt as GetMapEntryOptions, O as gcRepos, Ot as isShallowClone, P as isReferenceInstalled, Pt as MapEntry, Q as installGlobalSkill, Qt as expandTilde, R as ResolvedDep, Rt as getProjectMapPath, S as PruneResult, St as UpdateResult, T as UpdateAllOptions, Tt as getCommitDistance, U as ManifestType, Ut as upsertGlobalMapEntry, V as resolveFromNpm, Vt as readGlobalMap, W as detectManifestType, Wt as writeGlobalMap, X as getAllAgentConfigs, Xt as parseRepoInput, Y as getAgentConfig, Yt as getReferenceFileNameForSource, Z as InstallReferenceMeta, Zt as Paths, _ as DiscoverOptions, _t as GitError, a as GlobalMap, an as loadConfig, at as TokenExpiredError, b as GcResult, bt as RepoNotFoundError, c as ProjectMapRepoEntry, cn as toReferenceFileName, ct as getAuthStatus, d as ProviderInfo, dn as VERSION, dt as isLoggedIn, en as getMetaPath, et as resolveReferenceKeywords, f as ProviderWithModels, ft as loadAuthData, g as validateProviderModel, gt as CloneOptions, h as listProvidersWithModels, ht as CloneError, i as FileRole, in as getRepoRoot, it as NotLoggedInError, j as updateAllRepos, jt as unshallowRepo, k as getRepoStatus, kt as listRepos, l as RepoSource, ln as toReferenceName, lt as getToken, m as listProviders, mt as saveAuthData, n as FileIndex, nn as getReferencePath, nt as AuthError, o as GlobalMapRepoEntry, on as saveConfig, ot as clearAuthData, p as getProvider, pt as refreshAccessToken, q as agents, qt as PathNotFoundError, r as FileIndexEntry, rn as getRepoPath, rt as AuthStatus, s as ProjectMap, sn as toMetaDirName, st as getAuthPath, t as Config, tn as getMetaRoot, tt as AuthData, u as ModelInfo, un as DEFAULT_IGNORE_PATTERNS, ut as getTokenOrNull, v as DiscoverResult, vt as RemoveOptions, w as RepoStatusSummary, wt as getClonedRepoPath, x as PruneOptions, xt as UpdateOptions, y as GcOptions, yt as RepoExistsError, z as getNpmKeywords, zt as resolveRepoKey } from "./public-DzjgxrUm.mjs";
+export { AgentConfig, AuthData, AuthError, AuthStatus, CloneError, CloneOptions, Config, DEFAULT_IGNORE_PATTERNS, Dependency, DiscoverOptions, DiscoverResult, FALLBACK_MAPPINGS, FileIndex, FileIndexEntry, FileRole, GcOptions, GcResult, GetMapEntryOptions, GitError, GlobalMap, GlobalMapRepoEntry, InstallReferenceMeta, ManifestType, MapEntry, ModelInfo, NotGitRepoError, NotLoggedInError, PathNotFoundError, Paths, ProjectMap, ProjectMapRepoEntry, ProviderInfo, ProviderWithModels, PruneOptions, PruneResult, ReferenceMatch, ReferenceStatus, RemoveOptions, RepoExistsError, RepoNotFoundError, RepoSource, RepoSourceError, RepoStatusOptions, RepoStatusSummary, ResolvedDep, SearchMapOptions, SearchResult, TokenExpiredError, UpdateAllOptions, UpdateAllResult, UpdateOptions, UpdateResult, VERSION, agents, clearAuthData, cloneRepo, detectInstalledAgents, detectManifestType, discoverRepos, expandTilde, gcRepos, getAgentConfig, getAllAgentConfigs, getAuthPath, getAuthStatus, getClonedRepoPath, getCommitDistance, getCommitSha, getConfigPath, getMapEntry, getMetaPath, getMetaRoot, getNpmKeywords, getProjectMapPath, getProvider, getReferenceFileNameForSource, getReferencePath, getRepoPath, getRepoRoot, getRepoStatus, getToken, getTokenOrNull, installGlobalSkill, installReference, isLoggedIn, isReferenceInstalled, isRepoCloned, isShallowClone, listProviders, listProvidersWithModels, listRepos, loadAuthData, loadConfig, matchDependenciesToReferences, matchDependenciesToReferencesWithRemoteCheck, parseDependencies, parseRepoInput, pruneRepos, readGlobalMap, refreshAccessToken, removeGlobalMapEntry, removeRepo, resolveDependencyRepo, resolveFromNpm, resolveReferenceKeywords, resolveRepoKey, saveAuthData, saveConfig, searchMap, toMetaDirName, toReferenceFileName, toReferenceName, unshallowRepo, updateAllRepos, updateRepo, upsertGlobalMapEntry, validateProviderModel, writeGlobalMap, writeProjectMap };

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { A as getToken, B as NotGitRepoError, C as getAllAgentConfigs, D as clearAuthData, E as TokenExpiredError, F as saveAuthData, G as DEFAULT_IGNORE_PATTERNS, H as RepoSourceError, I as getMapEntry, K as VERSION, L as getProjectMapPath, M as isLoggedIn, N as loadAuthData, O as getAuthPath, P as refreshAccessToken, R as resolveRepoKey, S as getAgentConfig, T as NotLoggedInError, U as getReferenceFileNameForSource, V as PathNotFoundError, W as parseRepoInput, _ as parseDependencies, a as discoverRepos, b as agents, c as pruneRepos, d as matchDependenciesToReferences, f as matchDependenciesToReferencesWithRemoteCheck, g as detectManifestType, h as resolveFromNpm, i as validateProviderModel, j as getTokenOrNull, k as getAuthStatus, l as updateAllRepos, m as resolveDependencyRepo, n as listProviders, o as gcRepos, p as FALLBACK_MAPPINGS, r as listProvidersWithModels, s as getRepoStatus, t as getProvider, u as isReferenceInstalled, v as installGlobalSkill, w as AuthError, x as detectInstalledAgents, y as installReference, z as searchMap } from "./public-CjA2mMwu.mjs";
+import { A as getAuthPath, B as resolveRepoKey, C as detectInstalledAgents, D as NotLoggedInError, E as AuthError, F as loadAuthData, G as getReferenceFileNameForSource, H as NotGitRepoError, I as refreshAccessToken, J as VERSION, K as parseRepoInput, L as saveAuthData, M as getToken, N as getTokenOrNull, O as TokenExpiredError, P as isLoggedIn, R as getMapEntry, S as agents, T as getAllAgentConfigs, U as PathNotFoundError, V as searchMap, W as RepoSourceError, _ as resolveReferenceKeywords, a as discoverRepos, b as resolveDependencyRepo, c as pruneRepos, d as matchDependenciesToReferences, f as matchDependenciesToReferencesWithRemoteCheck, g as installReference, h as installGlobalSkill, i as validateProviderModel, j as getAuthStatus, k as clearAuthData, l as updateAllRepos, m as parseDependencies, n as listProviders, o as gcRepos, p as detectManifestType, q as DEFAULT_IGNORE_PATTERNS, r as listProvidersWithModels, s as getRepoStatus, t as getProvider, u as isReferenceInstalled, v as FALLBACK_MAPPINGS, w as getAgentConfig, x as resolveFromNpm, y as getNpmKeywords, z as getProjectMapPath } from "./public-BUgna8vR.mjs";
 import { a as getRepoPath, c as saveConfig, d as toReferenceName, f as Paths, i as getReferencePath, l as toMetaDirName, n as getMetaPath, o as getRepoRoot, p as expandTilde, r as getMetaRoot, s as loadConfig, t as getConfigPath, u as toReferenceFileName } from "./config-DW8J4gl5.mjs";
 import { _ as upsertGlobalMapEntry, a as cloneRepo, c as getCommitSha, d as listRepos, f as removeRepo, g as removeGlobalMapEntry, h as readGlobalMap, i as RepoNotFoundError, l as isRepoCloned, m as updateRepo, n as GitError, o as getClonedRepoPath, p as unshallowRepo, r as RepoExistsError, s as getCommitDistance, t as CloneError, u as isShallowClone, v as writeGlobalMap, y as writeProjectMap } from "./clone-DyLvmbJZ.mjs";
 
-export { AuthError, CloneError, DEFAULT_IGNORE_PATTERNS, FALLBACK_MAPPINGS, GitError, NotGitRepoError, NotLoggedInError, PathNotFoundError, Paths, RepoExistsError, RepoNotFoundError, RepoSourceError, TokenExpiredError, VERSION, agents, clearAuthData, cloneRepo, detectInstalledAgents, detectManifestType, discoverRepos, expandTilde, gcRepos, getAgentConfig, getAllAgentConfigs, getAuthPath, getAuthStatus, getClonedRepoPath, getCommitDistance, getCommitSha, getConfigPath, getMapEntry, getMetaPath, getMetaRoot, getProjectMapPath, getProvider, getReferenceFileNameForSource, getReferencePath, getRepoPath, getRepoRoot, getRepoStatus, getToken, getTokenOrNull, installGlobalSkill, installReference, isLoggedIn, isReferenceInstalled, isRepoCloned, isShallowClone, listProviders, listProvidersWithModels, listRepos, loadAuthData, loadConfig, matchDependenciesToReferences, matchDependenciesToReferencesWithRemoteCheck, parseDependencies, parseRepoInput, pruneRepos, readGlobalMap, refreshAccessToken, removeGlobalMapEntry, removeRepo, resolveDependencyRepo, resolveFromNpm, resolveRepoKey, saveAuthData, saveConfig, searchMap, toMetaDirName, toReferenceFileName, toReferenceName, unshallowRepo, updateAllRepos, updateRepo, upsertGlobalMapEntry, validateProviderModel, writeGlobalMap, writeProjectMap };
+export { AuthError, CloneError, DEFAULT_IGNORE_PATTERNS, FALLBACK_MAPPINGS, GitError, NotGitRepoError, NotLoggedInError, PathNotFoundError, Paths, RepoExistsError, RepoNotFoundError, RepoSourceError, TokenExpiredError, VERSION, agents, clearAuthData, cloneRepo, detectInstalledAgents, detectManifestType, discoverRepos, expandTilde, gcRepos, getAgentConfig, getAllAgentConfigs, getAuthPath, getAuthStatus, getClonedRepoPath, getCommitDistance, getCommitSha, getConfigPath, getMapEntry, getMetaPath, getMetaRoot, getNpmKeywords, getProjectMapPath, getProvider, getReferenceFileNameForSource, getReferencePath, getRepoPath, getRepoRoot, getRepoStatus, getToken, getTokenOrNull, installGlobalSkill, installReference, isLoggedIn, isReferenceInstalled, isRepoCloned, isShallowClone, listProviders, listProvidersWithModels, listRepos, loadAuthData, loadConfig, matchDependenciesToReferences, matchDependenciesToReferencesWithRemoteCheck, parseDependencies, parseRepoInput, pruneRepos, readGlobalMap, refreshAccessToken, removeGlobalMapEntry, removeRepo, resolveDependencyRepo, resolveFromNpm, resolveReferenceKeywords, resolveRepoKey, saveAuthData, saveConfig, searchMap, toMetaDirName, toReferenceFileName, toReferenceName, unshallowRepo, updateAllRepos, updateRepo, upsertGlobalMapEntry, validateProviderModel, writeGlobalMap, writeProjectMap };

package/dist/internal.d.mts

@@ -1,4 +1,4 @@
-import { $ as AuthData, $t as getMetaRoot, A as pruneRepos, At as updateRepo, B as resolveFromNpm, Bt as removeGlobalMapEntry, C as RepoStatusOptions, Ct as getCommitDistance, D as discoverRepos, Dt as listRepos, E as UpdateAllResult, Et as isShallowClone, F as matchDependenciesToReferences, Ft as getMapEntry, G as AgentConfig, Gt as PathNotFoundError, H as ManifestType, Ht as writeGlobalMap, I as matchDependenciesToReferencesWithRemoteCheck, It as getProjectMapPath, J as getAgentConfig, Jt as parseRepoInput, K as agents, Kt as RepoSourceError, L as FALLBACK_MAPPINGS, Lt as resolveRepoKey, M as ReferenceMatch, Mt as MapEntry, N as ReferenceStatus, Nt as SearchMapOptions, O as gcRepos, Ot as removeRepo, P as isReferenceInstalled, Pt as SearchResult, Q as installReference, Qt as getMetaPath, R as ResolvedDep, Rt as searchMap, S as PruneResult, St as getClonedRepoPath, T as UpdateAllOptions, Tt as isRepoCloned, U as detectManifestType, Ut as writeProjectMap, V as Dependency, Vt as upsertGlobalMapEntry, W as parseDependencies, Wt as NotGitRepoError, X as InstallReferenceMeta, Xt as expandTilde, Y as getAllAgentConfigs, Yt as Paths, Z as installGlobalSkill, Zt as getConfigPath, _ as DiscoverOptions, _t as RepoExistsError, a as GlobalMap, an as toMetaDirName, at as getAuthPath, b as GcResult, bt as UpdateResult, c as ProjectMapRepoEntry, cn as DEFAULT_IGNORE_PATTERNS, ct as getTokenOrNull, d as ProviderInfo, dt as refreshAccessToken, en as getReferencePath, et as AuthError, f as ProviderWithModels, ft as saveAuthData, g as validateProviderModel, gt as RemoveOptions, h as listProvidersWithModels, ht as GitError, i as FileRole, in as saveConfig, it as clearAuthData, j as updateAllRepos, jt as GetMapEntryOptions, k as getRepoStatus, kt as unshallowRepo, l as RepoSource, ln as VERSION, lt as isLoggedIn, m as listProviders, mt as CloneOptions, n as FileIndex, nn as getRepoRoot, nt as NotLoggedInError, o as GlobalMapRepoEntry, on as toReferenceFileName, ot as getAuthStatus, p as getProvider, pt as CloneError, q as detectInstalledAgents, qt as getReferenceFileNameForSource, r as FileIndexEntry, rn as loadConfig, rt as TokenExpiredError, s as ProjectMap, sn as toReferenceName, st as getToken, t as Config, tn as getRepoPath, tt as AuthStatus, u as ModelInfo, ut as loadAuthData, v as DiscoverResult, vt as RepoNotFoundError, w as RepoStatusSummary, wt as getCommitSha, x as PruneOptions, xt as cloneRepo, y as GcOptions, yt as UpdateOptions, z as resolveDependencyRepo, zt as readGlobalMap } from "./public-Cdr8rPRd.mjs";
+import { $ as installReference, $t as getConfigPath, A as pruneRepos, At as removeRepo, B as resolveDependencyRepo, Bt as searchMap, C as RepoStatusOptions, Ct as cloneRepo, D as discoverRepos, Dt as isRepoCloned, E as UpdateAllResult, Et as getCommitSha, F as matchDependenciesToReferences, Ft as SearchMapOptions, G as parseDependencies, Gt as writeProjectMap, H as Dependency, Ht as removeGlobalMapEntry, I as matchDependenciesToReferencesWithRemoteCheck, It as SearchResult, J as detectInstalledAgents, Jt as RepoSourceError, K as AgentConfig, Kt as NotGitRepoError, L as FALLBACK_MAPPINGS, Lt as getMapEntry, M as ReferenceMatch, Mt as updateRepo, N as ReferenceStatus, Nt as GetMapEntryOptions, O as gcRepos, Ot as isShallowClone, P as isReferenceInstalled, Pt as MapEntry, Q as installGlobalSkill, Qt as expandTilde, R as ResolvedDep, Rt as getProjectMapPath, S as PruneResult, St as UpdateResult, T as UpdateAllOptions, Tt as getCommitDistance, U as ManifestType, Ut as upsertGlobalMapEntry, V as resolveFromNpm, Vt as readGlobalMap, W as detectManifestType, Wt as writeGlobalMap, X as getAllAgentConfigs, Xt as parseRepoInput, Y as getAgentConfig, Yt as getReferenceFileNameForSource, Z as InstallReferenceMeta, Zt as Paths, _ as DiscoverOptions, _t as GitError, a as GlobalMap, an as loadConfig, at as TokenExpiredError, b as GcResult, bt as RepoNotFoundError, c as ProjectMapRepoEntry, cn as toReferenceFileName, ct as getAuthStatus, d as ProviderInfo, dn as VERSION, dt as isLoggedIn, en as getMetaPath, et as resolveReferenceKeywords, f as ProviderWithModels, ft as loadAuthData, g as validateProviderModel, gt as CloneOptions, h as listProvidersWithModels, ht as CloneError, i as FileRole, in as getRepoRoot, it as NotLoggedInError, j as updateAllRepos, jt as unshallowRepo, k as getRepoStatus, kt as listRepos, l as RepoSource, ln as toReferenceName, lt as getToken, m as listProviders, mt as saveAuthData, n as FileIndex, nn as getReferencePath, nt as AuthError, o as GlobalMapRepoEntry, on as saveConfig, ot as clearAuthData, p as getProvider, pt as refreshAccessToken, q as agents, qt as PathNotFoundError, r as FileIndexEntry, rn as getRepoPath, rt as AuthStatus, s as ProjectMap, sn as toMetaDirName, st as getAuthPath, t as Config, tn as getMetaRoot, tt as AuthData, u as ModelInfo, un as DEFAULT_IGNORE_PATTERNS, ut as getTokenOrNull, v as DiscoverResult, vt as RemoveOptions, w as RepoStatusSummary, wt as getClonedRepoPath, x as PruneOptions, xt as UpdateOptions, y as GcOptions, yt as RepoExistsError, z as getNpmKeywords, zt as resolveRepoKey } from "./public-DzjgxrUm.mjs";
 
 //#region src/agents-md.d.ts
 /**
@@ -65,5 +65,5 @@ declare function getShellConfigFiles(): string[];
  */
 declare function cleanShellConfig(filePath: string): boolean;
 //#endregion
-export { AgentConfig, AuthData, AuthError, AuthStatus, CloneError, CloneOptions, Config, DEFAULT_IGNORE_PATTERNS, Dependency, DiscoverOptions, DiscoverResult, FALLBACK_MAPPINGS, FileIndex, FileIndexEntry, FileRole, GcOptions, GcResult, GetMapEntryOptions, GitError, GlobalMap, GlobalMapRepoEntry, type InstallMethod, InstallReferenceMeta, type InstalledReference, ManifestType, MapEntry, ModelInfo, NotGitRepoError, NotLoggedInError, PathNotFoundError, Paths, ProjectMap, ProjectMapRepoEntry, ProviderInfo, ProviderWithModels, PruneOptions, PruneResult, ReferenceMatch, ReferenceStatus, RemoveOptions, RepoExistsError, RepoNotFoundError, RepoSource, RepoSourceError, RepoStatusOptions, RepoStatusSummary, ResolvedDep, SearchMapOptions, SearchResult, TokenExpiredError, UpdateAllOptions, UpdateAllResult, UpdateOptions, UpdateResult, VERSION, agents, appendReferencesSection, cleanShellConfig, clearAuthData, cloneRepo, detectInstallMethod, detectInstalledAgents, detectManifestType, discoverRepos, executeUninstall, executeUpgrade, expandTilde, fetchLatestVersion, gcRepos, getAgentConfig, getAllAgentConfigs, getAuthPath, getAuthStatus, getClonedRepoPath, getCommitDistance, getCommitSha, getConfigPath, getCurrentVersion, getMapEntry, getMetaPath, getMetaRoot, getProjectMapPath, getProvider, getReferenceFileNameForSource, getReferencePath, getRepoPath, getRepoRoot, getRepoStatus, getShellConfigFiles, getToken, getTokenOrNull, installGlobalSkill, installReference, isLoggedIn, isReferenceInstalled, isRepoCloned, isShallowClone, listProviders, listProvidersWithModels, listRepos, loadAuthData, loadConfig, matchDependenciesToReferences, matchDependenciesToReferencesWithRemoteCheck, parseDependencies, parseRepoInput, pruneRepos, readGlobalMap, refreshAccessToken, removeGlobalMapEntry, removeRepo, resolveDependencyRepo, resolveFromNpm, resolveRepoKey, saveAuthData, saveConfig, searchMap, toMetaDirName, toReferenceFileName, toReferenceName, unshallowRepo, updateAgentFiles, updateAllRepos, updateRepo, upsertGlobalMapEntry, validateProviderModel, writeGlobalMap, writeProjectMap };
+export { AgentConfig, AuthData, AuthError, AuthStatus, CloneError, CloneOptions, Config, DEFAULT_IGNORE_PATTERNS, Dependency, DiscoverOptions, DiscoverResult, FALLBACK_MAPPINGS, FileIndex, FileIndexEntry, FileRole, GcOptions, GcResult, GetMapEntryOptions, GitError, GlobalMap, GlobalMapRepoEntry, type InstallMethod, InstallReferenceMeta, type InstalledReference, ManifestType, MapEntry, ModelInfo, NotGitRepoError, NotLoggedInError, PathNotFoundError, Paths, ProjectMap, ProjectMapRepoEntry, ProviderInfo, ProviderWithModels, PruneOptions, PruneResult, ReferenceMatch, ReferenceStatus, RemoveOptions, RepoExistsError, RepoNotFoundError, RepoSource, RepoSourceError, RepoStatusOptions, RepoStatusSummary, ResolvedDep, SearchMapOptions, SearchResult, TokenExpiredError, UpdateAllOptions, UpdateAllResult, UpdateOptions, UpdateResult, VERSION, agents, appendReferencesSection, cleanShellConfig, clearAuthData, cloneRepo, detectInstallMethod, detectInstalledAgents, detectManifestType, discoverRepos, executeUninstall, executeUpgrade, expandTilde, fetchLatestVersion, gcRepos, getAgentConfig, getAllAgentConfigs, getAuthPath, getAuthStatus, getClonedRepoPath, getCommitDistance, getCommitSha, getConfigPath, getCurrentVersion, getMapEntry, getMetaPath, getMetaRoot, getNpmKeywords, getProjectMapPath, getProvider, getReferenceFileNameForSource, getReferencePath, getRepoPath, getRepoRoot, getRepoStatus, getShellConfigFiles, getToken, getTokenOrNull, installGlobalSkill, installReference, isLoggedIn, isReferenceInstalled, isRepoCloned, isShallowClone, listProviders, listProvidersWithModels, listRepos, loadAuthData, loadConfig, matchDependenciesToReferences, matchDependenciesToReferencesWithRemoteCheck, parseDependencies, parseRepoInput, pruneRepos, readGlobalMap, refreshAccessToken, removeGlobalMapEntry, removeRepo, resolveDependencyRepo, resolveFromNpm, resolveReferenceKeywords, resolveRepoKey, saveAuthData, saveConfig, searchMap, toMetaDirName, toReferenceFileName, toReferenceName, unshallowRepo, updateAgentFiles, updateAllRepos, updateRepo, upsertGlobalMapEntry, validateProviderModel, writeGlobalMap, writeProjectMap };
 //# sourceMappingURL=internal.d.mts.map

package/dist/internal.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.mts","names":[],"sources":["../src/agents-md.ts","../src/installation.ts"],"mappings":";;;;;;AASA;;UAAiB,kBAAA;EAAkB;EAElC,UAAA;EAEA;EAAA,SAAA;EAEI;EAAJ,IAAA;AAAA;;;;;;;;iBAsCe,uBAAA,CAAwB,QAAA,UAAkB,UAAA,EAAY,kBAAA;AAwBtE;;;;;;;AAAA,iBAAgB,gBAAA,CAAiB,WAAA,UAAqB,UAAA,EAAY,kBAAA;;;;;;KC/DtD,aAAA;;;;iBAKI,mBAAA,CAAA,GAAuB,aAAA;;;;iBAuFvB,iBAAA,CAAA;ADrDhB;;;AAAA,iBC4DsB,kBAAA,CAAmB,MAAA,GAAS,aAAA,GAAgB,OAAA;;;;iBAkClD,cAAA,CAAe,MAAA,EAAQ,aAAA,EAAe,OAAA,WAAkB,OAAA;;ADtExE;;iBCiHgB,gBAAA,CAAiB,MAAA,EAAQ,aAAA,GAAgB,OAAA;;;;iBAkDzC,mBAAA,CAAA;;;;iBA0BA,gBAAA,CAAiB,QAAA"}
+{"version":3,"file":"internal.d.mts","names":[],"sources":["../src/agents-md.ts","../src/installation.ts"],"mappings":";;;;;;AASA;;UAAiB,kBAAA;EAAkB;EAElC,UAAA;EAEA;EAAA,SAAA;EAEI;EAAJ,IAAA;AAAA;;;;;;;;iBA2Be,uBAAA,CAAwB,QAAA,UAAkB,UAAA,EAAY,kBAAA;AAwBtE;;;;;;;AAAA,iBAAgB,gBAAA,CAAiB,WAAA,UAAqB,UAAA,EAAY,kBAAA;;;;;;KCpDtD,aAAA;;;;iBAKI,mBAAA,CAAA,GAAuB,aAAA;;;;iBAuFvB,iBAAA,CAAA;ADhEhB;;;AAAA,iBCuEsB,kBAAA,CAAmB,MAAA,GAAS,aAAA,GAAgB,OAAA;;;;iBAkClD,cAAA,CAAe,MAAA,EAAQ,aAAA,EAAe,OAAA,WAAkB,OAAA;;ADjFxE;;iBC4HgB,gBAAA,CAAiB,MAAA,EAAQ,aAAA,GAAgB,OAAA;;;;iBAkDzC,mBAAA,CAAA;;;;iBA0BA,gBAAA,CAAiB,QAAA"}

package/dist/internal.mjs

@@ -1,4 +1,4 @@
-import { A as getToken, B as NotGitRepoError, C as getAllAgentConfigs, D as clearAuthData, E as TokenExpiredError, F as saveAuthData, G as DEFAULT_IGNORE_PATTERNS, H as RepoSourceError, I as getMapEntry, K as VERSION, L as getProjectMapPath, M as isLoggedIn, N as loadAuthData, O as getAuthPath, P as refreshAccessToken, R as resolveRepoKey, S as getAgentConfig, T as NotLoggedInError, U as getReferenceFileNameForSource, V as PathNotFoundError, W as parseRepoInput, _ as parseDependencies, a as discoverRepos, b as agents, c as pruneRepos, d as matchDependenciesToReferences, f as matchDependenciesToReferencesWithRemoteCheck, g as detectManifestType, h as resolveFromNpm, i as validateProviderModel, j as getTokenOrNull, k as getAuthStatus, l as updateAllRepos, m as resolveDependencyRepo, n as listProviders, o as gcRepos, p as FALLBACK_MAPPINGS, r as listProvidersWithModels, s as getRepoStatus, t as getProvider, u as isReferenceInstalled, v as installGlobalSkill, w as AuthError, x as detectInstalledAgents, y as installReference, z as searchMap } from "./public-CjA2mMwu.mjs";
+import { A as getAuthPath, B as resolveRepoKey, C as detectInstalledAgents, D as NotLoggedInError, E as AuthError, F as loadAuthData, G as getReferenceFileNameForSource, H as NotGitRepoError, I as refreshAccessToken, J as VERSION, K as parseRepoInput, L as saveAuthData, M as getToken, N as getTokenOrNull, O as TokenExpiredError, P as isLoggedIn, R as getMapEntry, S as agents, T as getAllAgentConfigs, U as PathNotFoundError, V as searchMap, W as RepoSourceError, _ as resolveReferenceKeywords, a as discoverRepos, b as resolveDependencyRepo, c as pruneRepos, d as matchDependenciesToReferences, f as matchDependenciesToReferencesWithRemoteCheck, g as installReference, h as installGlobalSkill, i as validateProviderModel, j as getAuthStatus, k as clearAuthData, l as updateAllRepos, m as parseDependencies, n as listProviders, o as gcRepos, p as detectManifestType, q as DEFAULT_IGNORE_PATTERNS, r as listProvidersWithModels, s as getRepoStatus, t as getProvider, u as isReferenceInstalled, v as FALLBACK_MAPPINGS, w as getAgentConfig, x as resolveFromNpm, y as getNpmKeywords, z as getProjectMapPath } from "./public-BUgna8vR.mjs";
 import { a as getRepoPath, c as saveConfig, d as toReferenceName, f as Paths, i as getReferencePath, l as toMetaDirName, n as getMetaPath, o as getRepoRoot, p as expandTilde, r as getMetaRoot, s as loadConfig, t as getConfigPath, u as toReferenceFileName } from "./config-DW8J4gl5.mjs";
 import { _ as upsertGlobalMapEntry, a as cloneRepo, c as getCommitSha, d as listRepos, f as removeRepo, g as removeGlobalMapEntry, h as readGlobalMap, i as RepoNotFoundError, l as isRepoCloned, m as updateRepo, n as GitError, o as getClonedRepoPath, p as unshallowRepo, r as RepoExistsError, s as getCommitDistance, t as CloneError, u as isShallowClone, v as writeGlobalMap, y as writeProjectMap } from "./clone-DyLvmbJZ.mjs";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
@@ -14,26 +14,18 @@ import { execSync, spawn } from "node:child_process";
 * Manages updating project AGENTS.md and agent-specific files with reference information.
 */
 /**
-* Generate markdown table for project references section.
+* Generate single-line project reference guidance.
 *
-* @param references - Array of installed references
-* @returns Markdown string with table
+* @param _references - Installed references (unused; reserved for future context)
+* @returns Markdown string with one-line guidance
 */
-function generateReferencesTable(references) {
-	const lines = [
+function generateReferencesTable(_references) {
+	return [
 		"## Project References",
 		"",
-		"References installed for this project's dependencies:",
-		"",
-		"| Dependency | Reference | Path |",
-		"| --- | --- | --- |"
-	];
-	for (const reference of references) lines.push(`| ${reference.dependency} | ${reference.reference} | ${reference.path} |`);
-	lines.push("");
-	lines.push("To update references: `ow pull <dependency>`");
-	lines.push("To regenerate all: `ow project init --all --generate`");
-	lines.push("");
-	return lines.join("\n");
+		"Use the Offworld CLI to find and read directly from local codebases for any repo in `.offworld/map.json` whenever the user asks about a specific open source project.",
+		""
+	].join("\n");
 }
 /**
 * Update or append Project References section in a markdown file.
@@ -322,5 +314,5 @@ function cleanShellConfig(filePath) {
 }
 
 //#endregion
-export { AuthError, CloneError, DEFAULT_IGNORE_PATTERNS, FALLBACK_MAPPINGS, GitError, NotGitRepoError, NotLoggedInError, PathNotFoundError, Paths, RepoExistsError, RepoNotFoundError, RepoSourceError, TokenExpiredError, VERSION, agents, appendReferencesSection, cleanShellConfig, clearAuthData, cloneRepo, detectInstallMethod, detectInstalledAgents, detectManifestType, discoverRepos, executeUninstall, executeUpgrade, expandTilde, fetchLatestVersion, gcRepos, getAgentConfig, getAllAgentConfigs, getAuthPath, getAuthStatus, getClonedRepoPath, getCommitDistance, getCommitSha, getConfigPath, getCurrentVersion, getMapEntry, getMetaPath, getMetaRoot, getProjectMapPath, getProvider, getReferenceFileNameForSource, getReferencePath, getRepoPath, getRepoRoot, getRepoStatus, getShellConfigFiles, getToken, getTokenOrNull, installGlobalSkill, installReference, isLoggedIn, isReferenceInstalled, isRepoCloned, isShallowClone, listProviders, listProvidersWithModels, listRepos, loadAuthData, loadConfig, matchDependenciesToReferences, matchDependenciesToReferencesWithRemoteCheck, parseDependencies, parseRepoInput, pruneRepos, readGlobalMap, refreshAccessToken, removeGlobalMapEntry, removeRepo, resolveDependencyRepo, resolveFromNpm, resolveRepoKey, saveAuthData, saveConfig, searchMap, toMetaDirName, toReferenceFileName, toReferenceName, unshallowRepo, updateAgentFiles, updateAllRepos, updateRepo, upsertGlobalMapEntry, validateProviderModel, writeGlobalMap, writeProjectMap };
+export { AuthError, CloneError, DEFAULT_IGNORE_PATTERNS, FALLBACK_MAPPINGS, GitError, NotGitRepoError, NotLoggedInError, PathNotFoundError, Paths, RepoExistsError, RepoNotFoundError, RepoSourceError, TokenExpiredError, VERSION, agents, appendReferencesSection, cleanShellConfig, clearAuthData, cloneRepo, detectInstallMethod, detectInstalledAgents, detectManifestType, discoverRepos, executeUninstall, executeUpgrade, expandTilde, fetchLatestVersion, gcRepos, getAgentConfig, getAllAgentConfigs, getAuthPath, getAuthStatus, getClonedRepoPath, getCommitDistance, getCommitSha, getConfigPath, getCurrentVersion, getMapEntry, getMetaPath, getMetaRoot, getNpmKeywords, getProjectMapPath, getProvider, getReferenceFileNameForSource, getReferencePath, getRepoPath, getRepoRoot, getRepoStatus, getShellConfigFiles, getToken, getTokenOrNull, installGlobalSkill, installReference, isLoggedIn, isReferenceInstalled, isRepoCloned, isShallowClone, listProviders, listProvidersWithModels, listRepos, loadAuthData, loadConfig, matchDependenciesToReferences, matchDependenciesToReferencesWithRemoteCheck, parseDependencies, parseRepoInput, pruneRepos, readGlobalMap, refreshAccessToken, removeGlobalMapEntry, removeRepo, resolveDependencyRepo, resolveFromNpm, resolveReferenceKeywords, resolveRepoKey, saveAuthData, saveConfig, searchMap, toMetaDirName, toReferenceFileName, toReferenceName, unshallowRepo, updateAgentFiles, updateAllRepos, updateRepo, upsertGlobalMapEntry, validateProviderModel, writeGlobalMap, writeProjectMap };
 //# sourceMappingURL=internal.mjs.map

package/dist/internal.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal.mjs","names":[],"sources":["../src/agents-md.ts","../src/installation.ts"],"sourcesContent":["/**\n * AGENTS.md manipulation utilities\n *\n * Manages updating project AGENTS.md and agent-specific files with reference information.\n */\n\nimport { readFileSync, writeFileSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface InstalledReference {\n\t/** Dependency name */\n\tdependency: string;\n\t/** Reference identifier (matches reference file name without .md) */\n\treference: string;\n\t/** Absolute path to reference file */\n\tpath: string;\n}\n\n/**\n * Generate markdown table for project references section.\n *\n * @param references - Array of installed references\n * @returns Markdown string with table\n */\nfunction generateReferencesTable(references: InstalledReference[]): string {\n\tconst lines = [\n\t\t\"## Project References\",\n\t\t\"\",\n\t\t\"References installed for this project's dependencies:\",\n\t\t\"\",\n\t\t\"| Dependency | Reference | Path |\",\n\t\t\"| --- | --- | --- |\",\n\t];\n\n\tfor (const reference of references) {\n\t\tlines.push(`| ${reference.dependency} | ${reference.reference} | ${reference.path} |`);\n\t}\n\n\tlines.push(\"\");\n\tlines.push(\"To update references: `ow pull <dependency>`\");\n\tlines.push(\"To regenerate all: `ow project init --all --generate`\");\n\tlines.push(\"\");\n\n\treturn lines.join(\"\\n\");\n}\n\n/**\n * Update or append Project References section in a markdown file.\n * If the section exists, replaces its content. Otherwise, appends to end.\n *\n * @param filePath - Path to markdown file\n * @param references - Array of installed references\n */\nexport function appendReferencesSection(filePath: string, references: InstalledReference[]): void {\n\tconst content = existsSync(filePath) ? readFileSync(filePath, \"utf-8\") : \"\";\n\tconst referencesMarkdown = generateReferencesTable(references);\n\n\tconst sectionRegex = /^## Project References\\n(?:.*\\n)*?(?=^## |$)/m;\n\tconst match = content.match(sectionRegex);\n\n\tlet updatedContent: string;\n\tif (match) {\n\t\tupdatedContent = content.replace(sectionRegex, referencesMarkdown);\n\t} else {\n\t\tupdatedContent = content.trim() + \"\\n\\n\" + referencesMarkdown;\n\t}\n\n\twriteFileSync(filePath, updatedContent, \"utf-8\");\n}\n\n/**\n * Update AGENTS.md and agent-specific files with project references.\n * Creates files if they don't exist.\n *\n * @param projectRoot - Project root directory\n * @param references - Array of installed references to document\n */\nexport function updateAgentFiles(projectRoot: string, references: InstalledReference[]): void {\n\tconst agentsMdPath = join(projectRoot, \"AGENTS.md\");\n\tconst claudeMdPath = join(projectRoot, \"CLAUDE.md\");\n\n\tappendReferencesSection(agentsMdPath, references);\n\n\tif (existsSync(claudeMdPath)) {\n\t\tappendReferencesSection(claudeMdPath, references);\n\t}\n}\n","/**\n * Installation utilities for upgrade/uninstall commands\n */\n\nimport { execSync, spawn } from \"node:child_process\";\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { NpmPackageResponseSchema } from \"@offworld/types\";\nimport { VERSION } from \"./constants.js\";\n\nconst GITHUB_REPO = \"oscabriel/offworld\";\nconst NPM_PACKAGE = \"offworld\";\n\nexport type InstallMethod = \"curl\" | \"npm\" | \"pnpm\" | \"bun\" | \"brew\" | \"unknown\";\n\n/**\n * Detect how offworld was installed\n */\nexport function detectInstallMethod(): InstallMethod {\n\tconst execPath = process.execPath;\n\n\tif (execPath.includes(\".local/bin\")) return \"curl\";\n\n\tconst checks: Array<{ name: InstallMethod; test: () => boolean }> = [\n\t\t{\n\t\t\tname: \"npm\",\n\t\t\ttest: () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = execSync(\"npm list -g --depth=0 2>/dev/null\", {\n\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t});\n\t\t\t\t\treturn result.includes(NPM_PACKAGE);\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"pnpm\",\n\t\t\ttest: () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = execSync(\"pnpm list -g --depth=0 2>/dev/null\", {\n\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t});\n\t\t\t\t\treturn result.includes(NPM_PACKAGE);\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"bun\",\n\t\t\ttest: () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = execSync(\"bun pm ls -g 2>/dev/null\", {\n\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t});\n\t\t\t\t\treturn result.includes(NPM_PACKAGE);\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"brew\",\n\t\t\ttest: () => {\n\t\t\t\ttry {\n\t\t\t\t\texecSync(\"brew list --formula offworld 2>/dev/null\", {\n\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t});\n\t\t\t\t\treturn true;\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t];\n\n\tif (execPath.includes(\"npm\")) {\n\t\tconst check = checks.find((c) => c.name === \"npm\");\n\t\tif (check?.test()) return \"npm\";\n\t}\n\tif (execPath.includes(\"pnpm\")) {\n\t\tconst check = checks.find((c) => c.name === \"pnpm\");\n\t\tif (check?.test()) return \"pnpm\";\n\t}\n\tif (execPath.includes(\"bun\")) {\n\t\tconst check = checks.find((c) => c.name === \"bun\");\n\t\tif (check?.test()) return \"bun\";\n\t}\n\tif (execPath.includes(\"Cellar\") || execPath.includes(\"homebrew\")) {\n\t\tconst check = checks.find((c) => c.name === \"brew\");\n\t\tif (check?.test()) return \"brew\";\n\t}\n\n\tfor (const check of checks) {\n\t\tif (check.test()) return check.name;\n\t}\n\n\treturn \"unknown\";\n}\n\n/**\n * Get current installed version\n */\nexport function getCurrentVersion(): string {\n\treturn VERSION;\n}\n\n/**\n * Fetch latest version from appropriate source\n */\nexport async function fetchLatestVersion(method?: InstallMethod): Promise<string | null> {\n\tconst installMethod = method ?? detectInstallMethod();\n\n\ttry {\n\t\tif (installMethod === \"npm\" || installMethod === \"pnpm\" || installMethod === \"bun\") {\n\t\t\tconst response = await fetch(`https://registry.npmjs.org/${NPM_PACKAGE}/latest`);\n\t\t\tif (!response.ok) return null;\n\t\t\tconst json = await response.json();\n\t\t\tconst result = NpmPackageResponseSchema.safeParse(json);\n\t\t\tif (!result.success) return null;\n\t\t\treturn result.data.version ?? null;\n\t\t}\n\n\t\tconst response = await fetch(`https://api.github.com/repos/${GITHUB_REPO}/releases/latest`, {\n\t\t\theaders: {\n\t\t\t\tAccept: \"application/vnd.github.v3+json\",\n\t\t\t\t\"User-Agent\": \"offworld-cli\",\n\t\t\t},\n\t\t});\n\t\tif (!response.ok) return null;\n\t\tconst json = await response.json();\n\t\tconst tagName =\n\t\t\ttypeof json === \"object\" && json !== null && \"tag_name\" in json\n\t\t\t\t? String(json.tag_name)\n\t\t\t\t: null;\n\t\treturn tagName?.replace(/^v/, \"\") ?? null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Execute upgrade for given method\n */\nexport function executeUpgrade(method: InstallMethod, version: string): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tlet cmd: string;\n\t\tlet args: string[];\n\n\t\tswitch (method) {\n\t\t\tcase \"curl\":\n\t\t\t\tcmd = \"bash\";\n\t\t\t\targs = [\"-c\", `curl -fsSL https://offworld.sh/install | VERSION=${version} bash`];\n\t\t\t\tbreak;\n\t\t\tcase \"npm\":\n\t\t\t\tcmd = \"npm\";\n\t\t\t\targs = [\"install\", \"-g\", `${NPM_PACKAGE}@${version}`];\n\t\t\t\tbreak;\n\t\t\tcase \"pnpm\":\n\t\t\t\tcmd = \"pnpm\";\n\t\t\t\targs = [\"install\", \"-g\", `${NPM_PACKAGE}@${version}`];\n\t\t\t\tbreak;\n\t\t\tcase \"bun\":\n\t\t\t\tcmd = \"bun\";\n\t\t\t\targs = [\"install\", \"-g\", `${NPM_PACKAGE}@${version}`];\n\t\t\t\tbreak;\n\t\t\tcase \"brew\":\n\t\t\t\tcmd = \"brew\";\n\t\t\t\targs = [\"upgrade\", \"offworld\"];\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\treject(new Error(`Cannot upgrade: unknown installation method`));\n\t\t\t\treturn;\n\t\t}\n\n\t\tconst proc = spawn(cmd, args, { stdio: \"inherit\" });\n\t\tproc.on(\"close\", (code) => {\n\t\t\tif (code === 0) resolve();\n\t\t\telse reject(new Error(`Upgrade failed with exit code ${code}`));\n\t\t});\n\t\tproc.on(\"error\", reject);\n\t});\n}\n\n/**\n * Execute uninstall for given method\n */\nexport function executeUninstall(method: InstallMethod): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tlet cmd: string;\n\t\tlet args: string[];\n\n\t\tswitch (method) {\n\t\t\tcase \"curl\":\n\t\t\t\ttry {\n\t\t\t\t\tconst binPath = join(homedir(), \".local\", \"bin\", \"ow\");\n\t\t\t\t\tif (existsSync(binPath)) {\n\t\t\t\t\t\texecSync(`rm -f \"${binPath}\"`, { stdio: \"inherit\" });\n\t\t\t\t\t}\n\t\t\t\t\tresolve();\n\t\t\t\t} catch (err) {\n\t\t\t\t\treject(err);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\tcase \"npm\":\n\t\t\t\tcmd = \"npm\";\n\t\t\t\targs = [\"uninstall\", \"-g\", NPM_PACKAGE];\n\t\t\t\tbreak;\n\t\t\tcase \"pnpm\":\n\t\t\t\tcmd = \"pnpm\";\n\t\t\t\targs = [\"uninstall\", \"-g\", NPM_PACKAGE];\n\t\t\t\tbreak;\n\t\t\tcase \"bun\":\n\t\t\t\tcmd = \"bun\";\n\t\t\t\targs = [\"remove\", \"-g\", NPM_PACKAGE];\n\t\t\t\tbreak;\n\t\t\tcase \"brew\":\n\t\t\t\tcmd = \"brew\";\n\t\t\t\targs = [\"uninstall\", \"offworld\"];\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\treject(new Error(`Cannot uninstall: unknown installation method`));\n\t\t\t\treturn;\n\t\t}\n\n\t\tconst proc = spawn(cmd, args, { stdio: \"inherit\" });\n\t\tproc.on(\"close\", (code) => {\n\t\t\tif (code === 0) resolve();\n\t\t\telse reject(new Error(`Uninstall failed with exit code ${code}`));\n\t\t});\n\t\tproc.on(\"error\", reject);\n\t});\n}\n\n/**\n * Get shell config files to clean\n */\nexport function getShellConfigFiles(): string[] {\n\tconst home = homedir();\n\tconst configs: string[] = [];\n\n\tconst candidates = [\n\t\t\".bashrc\",\n\t\t\".bash_profile\",\n\t\t\".profile\",\n\t\t\".zshrc\",\n\t\t\".zshenv\",\n\t\t\".config/fish/config.fish\",\n\t];\n\n\tfor (const file of candidates) {\n\t\tconst path = join(home, file);\n\t\tif (existsSync(path)) {\n\t\t\tconfigs.push(path);\n\t\t}\n\t}\n\n\treturn configs;\n}\n\n/**\n * Clean PATH entries from shell config\n */\nexport function cleanShellConfig(filePath: string): boolean {\n\ttry {\n\t\tconst content = readFileSync(filePath, \"utf-8\");\n\t\tconst lines = content.split(\"\\n\");\n\t\tconst filtered: string[] = [];\n\t\tlet modified = false;\n\n\t\tfor (const line of lines) {\n\t\t\tconst trimmed = line.trim();\n\t\t\tif (\n\t\t\t\ttrimmed.includes(\".local/bin\") &&\n\t\t\t\t(trimmed.startsWith(\"export PATH=\") || trimmed.startsWith(\"fish_add_path\"))\n\t\t\t) {\n\t\t\t\tif (trimmed.includes(\"# offworld\") || trimmed === 'export PATH=\"$HOME/.local/bin:$PATH\"') {\n\t\t\t\t\tmodified = true;\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\t\t\tfiltered.push(line);\n\t\t}\n\n\t\tif (modified) {\n\t\t\twriteFileSync(filePath, filtered.join(\"\\n\"), \"utf-8\");\n\t\t}\n\n\t\treturn modified;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"internal.mjs","names":[],"sources":["../src/agents-md.ts","../src/installation.ts"],"sourcesContent":["/**\n * AGENTS.md manipulation utilities\n *\n * Manages updating project AGENTS.md and agent-specific files with reference information.\n */\n\nimport { readFileSync, writeFileSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface InstalledReference {\n\t/** Dependency name */\n\tdependency: string;\n\t/** Reference identifier (matches reference file name without .md) */\n\treference: string;\n\t/** Absolute path to reference file */\n\tpath: string;\n}\n\n/**\n * Generate single-line project reference guidance.\n *\n * @param _references - Installed references (unused; reserved for future context)\n * @returns Markdown string with one-line guidance\n */\nfunction generateReferencesTable(_references: InstalledReference[]): string {\n\tconst lines = [\n\t\t\"## Project References\",\n\t\t\"\",\n\t\t\"Use the Offworld CLI to find and read directly from local codebases for any repo in `.offworld/map.json` whenever the user asks about a specific open source project.\",\n\t\t\"\",\n\t];\n\n\treturn lines.join(\"\\n\");\n}\n\n/**\n * Update or append Project References section in a markdown file.\n * If the section exists, replaces its content. Otherwise, appends to end.\n *\n * @param filePath - Path to markdown file\n * @param references - Array of installed references\n */\nexport function appendReferencesSection(filePath: string, references: InstalledReference[]): void {\n\tconst content = existsSync(filePath) ? readFileSync(filePath, \"utf-8\") : \"\";\n\tconst referencesMarkdown = generateReferencesTable(references);\n\n\tconst sectionRegex = /^## Project References\\n(?:.*\\n)*?(?=^## |$)/m;\n\tconst match = content.match(sectionRegex);\n\n\tlet updatedContent: string;\n\tif (match) {\n\t\tupdatedContent = content.replace(sectionRegex, referencesMarkdown);\n\t} else {\n\t\tupdatedContent = content.trim() + \"\\n\\n\" + referencesMarkdown;\n\t}\n\n\twriteFileSync(filePath, updatedContent, \"utf-8\");\n}\n\n/**\n * Update AGENTS.md and agent-specific files with project references.\n * Creates files if they don't exist.\n *\n * @param projectRoot - Project root directory\n * @param references - Array of installed references to document\n */\nexport function updateAgentFiles(projectRoot: string, references: InstalledReference[]): void {\n\tconst agentsMdPath = join(projectRoot, \"AGENTS.md\");\n\tconst claudeMdPath = join(projectRoot, \"CLAUDE.md\");\n\n\tappendReferencesSection(agentsMdPath, references);\n\n\tif (existsSync(claudeMdPath)) {\n\t\tappendReferencesSection(claudeMdPath, references);\n\t}\n}\n","/**\n * Installation utilities for upgrade/uninstall commands\n */\n\nimport { execSync, spawn } from \"node:child_process\";\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { NpmPackageResponseSchema } from \"@offworld/types\";\nimport { VERSION } from \"./constants.js\";\n\nconst GITHUB_REPO = \"oscabriel/offworld\";\nconst NPM_PACKAGE = \"offworld\";\n\nexport type InstallMethod = \"curl\" | \"npm\" | \"pnpm\" | \"bun\" | \"brew\" | \"unknown\";\n\n/**\n * Detect how offworld was installed\n */\nexport function detectInstallMethod(): InstallMethod {\n\tconst execPath = process.execPath;\n\n\tif (execPath.includes(\".local/bin\")) return \"curl\";\n\n\tconst checks: Array<{ name: InstallMethod; test: () => boolean }> = [\n\t\t{\n\t\t\tname: \"npm\",\n\t\t\ttest: () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = execSync(\"npm list -g --depth=0 2>/dev/null\", {\n\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t});\n\t\t\t\t\treturn result.includes(NPM_PACKAGE);\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"pnpm\",\n\t\t\ttest: () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = execSync(\"pnpm list -g --depth=0 2>/dev/null\", {\n\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t});\n\t\t\t\t\treturn result.includes(NPM_PACKAGE);\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"bun\",\n\t\t\ttest: () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = execSync(\"bun pm ls -g 2>/dev/null\", {\n\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t});\n\t\t\t\t\treturn result.includes(NPM_PACKAGE);\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"brew\",\n\t\t\ttest: () => {\n\t\t\t\ttry {\n\t\t\t\t\texecSync(\"brew list --formula offworld 2>/dev/null\", {\n\t\t\t\t\t\tencoding: \"utf-8\",\n\t\t\t\t\t});\n\t\t\t\t\treturn true;\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t];\n\n\tif (execPath.includes(\"npm\")) {\n\t\tconst check = checks.find((c) => c.name === \"npm\");\n\t\tif (check?.test()) return \"npm\";\n\t}\n\tif (execPath.includes(\"pnpm\")) {\n\t\tconst check = checks.find((c) => c.name === \"pnpm\");\n\t\tif (check?.test()) return \"pnpm\";\n\t}\n\tif (execPath.includes(\"bun\")) {\n\t\tconst check = checks.find((c) => c.name === \"bun\");\n\t\tif (check?.test()) return \"bun\";\n\t}\n\tif (execPath.includes(\"Cellar\") || execPath.includes(\"homebrew\")) {\n\t\tconst check = checks.find((c) => c.name === \"brew\");\n\t\tif (check?.test()) return \"brew\";\n\t}\n\n\tfor (const check of checks) {\n\t\tif (check.test()) return check.name;\n\t}\n\n\treturn \"unknown\";\n}\n\n/**\n * Get current installed version\n */\nexport function getCurrentVersion(): string {\n\treturn VERSION;\n}\n\n/**\n * Fetch latest version from appropriate source\n */\nexport async function fetchLatestVersion(method?: InstallMethod): Promise<string | null> {\n\tconst installMethod = method ?? detectInstallMethod();\n\n\ttry {\n\t\tif (installMethod === \"npm\" || installMethod === \"pnpm\" || installMethod === \"bun\") {\n\t\t\tconst response = await fetch(`https://registry.npmjs.org/${NPM_PACKAGE}/latest`);\n\t\t\tif (!response.ok) return null;\n\t\t\tconst json = await response.json();\n\t\t\tconst result = NpmPackageResponseSchema.safeParse(json);\n\t\t\tif (!result.success) return null;\n\t\t\treturn result.data.version ?? null;\n\t\t}\n\n\t\tconst response = await fetch(`https://api.github.com/repos/${GITHUB_REPO}/releases/latest`, {\n\t\t\theaders: {\n\t\t\t\tAccept: \"application/vnd.github.v3+json\",\n\t\t\t\t\"User-Agent\": \"offworld-cli\",\n\t\t\t},\n\t\t});\n\t\tif (!response.ok) return null;\n\t\tconst json = await response.json();\n\t\tconst tagName =\n\t\t\ttypeof json === \"object\" && json !== null && \"tag_name\" in json\n\t\t\t\t? String(json.tag_name)\n\t\t\t\t: null;\n\t\treturn tagName?.replace(/^v/, \"\") ?? null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Execute upgrade for given method\n */\nexport function executeUpgrade(method: InstallMethod, version: string): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tlet cmd: string;\n\t\tlet args: string[];\n\n\t\tswitch (method) {\n\t\t\tcase \"curl\":\n\t\t\t\tcmd = \"bash\";\n\t\t\t\targs = [\"-c\", `curl -fsSL https://offworld.sh/install | VERSION=${version} bash`];\n\t\t\t\tbreak;\n\t\t\tcase \"npm\":\n\t\t\t\tcmd = \"npm\";\n\t\t\t\targs = [\"install\", \"-g\", `${NPM_PACKAGE}@${version}`];\n\t\t\t\tbreak;\n\t\t\tcase \"pnpm\":\n\t\t\t\tcmd = \"pnpm\";\n\t\t\t\targs = [\"install\", \"-g\", `${NPM_PACKAGE}@${version}`];\n\t\t\t\tbreak;\n\t\t\tcase \"bun\":\n\t\t\t\tcmd = \"bun\";\n\t\t\t\targs = [\"install\", \"-g\", `${NPM_PACKAGE}@${version}`];\n\t\t\t\tbreak;\n\t\t\tcase \"brew\":\n\t\t\t\tcmd = \"brew\";\n\t\t\t\targs = [\"upgrade\", \"offworld\"];\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\treject(new Error(`Cannot upgrade: unknown installation method`));\n\t\t\t\treturn;\n\t\t}\n\n\t\tconst proc = spawn(cmd, args, { stdio: \"inherit\" });\n\t\tproc.on(\"close\", (code) => {\n\t\t\tif (code === 0) resolve();\n\t\t\telse reject(new Error(`Upgrade failed with exit code ${code}`));\n\t\t});\n\t\tproc.on(\"error\", reject);\n\t});\n}\n\n/**\n * Execute uninstall for given method\n */\nexport function executeUninstall(method: InstallMethod): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tlet cmd: string;\n\t\tlet args: string[];\n\n\t\tswitch (method) {\n\t\t\tcase \"curl\":\n\t\t\t\ttry {\n\t\t\t\t\tconst binPath = join(homedir(), \".local\", \"bin\", \"ow\");\n\t\t\t\t\tif (existsSync(binPath)) {\n\t\t\t\t\t\texecSync(`rm -f \"${binPath}\"`, { stdio: \"inherit\" });\n\t\t\t\t\t}\n\t\t\t\t\tresolve();\n\t\t\t\t} catch (err) {\n\t\t\t\t\treject(err);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\tcase \"npm\":\n\t\t\t\tcmd = \"npm\";\n\t\t\t\targs = [\"uninstall\", \"-g\", NPM_PACKAGE];\n\t\t\t\tbreak;\n\t\t\tcase \"pnpm\":\n\t\t\t\tcmd = \"pnpm\";\n\t\t\t\targs = [\"uninstall\", \"-g\", NPM_PACKAGE];\n\t\t\t\tbreak;\n\t\t\tcase \"bun\":\n\t\t\t\tcmd = \"bun\";\n\t\t\t\targs = [\"remove\", \"-g\", NPM_PACKAGE];\n\t\t\t\tbreak;\n\t\t\tcase \"brew\":\n\t\t\t\tcmd = \"brew\";\n\t\t\t\targs = [\"uninstall\", \"offworld\"];\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\treject(new Error(`Cannot uninstall: unknown installation method`));\n\t\t\t\treturn;\n\t\t}\n\n\t\tconst proc = spawn(cmd, args, { stdio: \"inherit\" });\n\t\tproc.on(\"close\", (code) => {\n\t\t\tif (code === 0) resolve();\n\t\t\telse reject(new Error(`Uninstall failed with exit code ${code}`));\n\t\t});\n\t\tproc.on(\"error\", reject);\n\t});\n}\n\n/**\n * Get shell config files to clean\n */\nexport function getShellConfigFiles(): string[] {\n\tconst home = homedir();\n\tconst configs: string[] = [];\n\n\tconst candidates = [\n\t\t\".bashrc\",\n\t\t\".bash_profile\",\n\t\t\".profile\",\n\t\t\".zshrc\",\n\t\t\".zshenv\",\n\t\t\".config/fish/config.fish\",\n\t];\n\n\tfor (const file of candidates) {\n\t\tconst path = join(home, file);\n\t\tif (existsSync(path)) {\n\t\t\tconfigs.push(path);\n\t\t}\n\t}\n\n\treturn configs;\n}\n\n/**\n * Clean PATH entries from shell config\n */\nexport function cleanShellConfig(filePath: string): boolean {\n\ttry {\n\t\tconst content = readFileSync(filePath, \"utf-8\");\n\t\tconst lines = content.split(\"\\n\");\n\t\tconst filtered: string[] = [];\n\t\tlet modified = false;\n\n\t\tfor (const line of lines) {\n\t\t\tconst trimmed = line.trim();\n\t\t\tif (\n\t\t\t\ttrimmed.includes(\".local/bin\") &&\n\t\t\t\t(trimmed.startsWith(\"export PATH=\") || trimmed.startsWith(\"fish_add_path\"))\n\t\t\t) {\n\t\t\t\tif (trimmed.includes(\"# offworld\") || trimmed === 'export PATH=\"$HOME/.local/bin:$PATH\"') {\n\t\t\t\t\tmodified = true;\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\t\t\tfiltered.push(line);\n\t\t}\n\n\t\tif (modified) {\n\t\t\twriteFileSync(filePath, filtered.join(\"\\n\"), \"utf-8\");\n\t\t}\n\n\t\treturn modified;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}

package/dist/{public-CjA2mMwu.mjs → public-BUgna8vR.mjs}

@@ -12,7 +12,7 @@ import { z } from "zod";
 * SDK Constants
 */
 /** SDK version - must match package.json */
-const VERSION = "0.3.1";
+const VERSION = "0.3.2";
 /**
 * Default patterns to ignore when scanning repositories.
 * Includes directories, binary files, IDE configs, and build outputs.
@@ -742,47 +742,136 @@ function getAllAgentConfigs() {
 }
 
 //#endregion
-//#region src/reference.ts
-const PackageJsonKeywordsSchema = z.object({
-	name: z.string().optional(),
-	keywords: z.array(z.string()).optional()
-});
-function normalizeKeyword(value) {
-	const trimmed = value.trim();
-	if (!trimmed) return [];
-	const normalized = trimmed.toLowerCase();
-	const tokens = /* @__PURE__ */ new Set();
-	const addToken = (token) => {
-		const cleaned = token.trim().toLowerCase();
-		if (cleaned.length < 2) return;
-		tokens.add(cleaned);
+//#region src/dep-mappings.ts
+/**
+* Dependency name to GitHub repo resolution:
+* 1. Query npm registry for repository.url
+* 2. Fall back to FALLBACK_MAPPINGS for packages missing repository field
+* 3. Return unknown (caller handles)
+*/
+/**
+* Fallback mappings for packages where npm registry doesn't have repository.url.
+* Only add packages here that genuinely don't have the field set.
+*/
+const FALLBACK_MAPPINGS = {
+	"@convex-dev/react-query": "get-convex/convex-react-query",
+	"@opencode-ai/sdk": "anomalyco/opencode-sdk-js"
+};
+/**
+* Parse GitHub repo from various git URL formats.
+* Handles:
+* - git+https://github.com/owner/repo.git
+* - https://github.com/owner/repo
+* - git://github.com/owner/repo.git
+* - github:owner/repo
+*/
+function parseGitHubUrl(url) {
+	for (const pattern of [/github\.com[/:]([\w-]+)\/([\w.-]+?)(?:\.git)?$/, /^github:([\w-]+)\/([\w.-]+)$/]) {
+		const match = url.match(pattern);
+		if (match) return `${match[1]}/${match[2]}`;
+	}
+	return null;
+}
+async function fetchNpmPackage(packageName) {
+	try {
+		const res = await fetch(`https://registry.npmjs.org/${packageName}`);
+		if (!res.ok) return null;
+		const json = await res.json();
+		const result = NpmPackageResponseSchema.safeParse(json);
+		if (!result.success) return null;
+		return result.data;
+	} catch {
+		return null;
+	}
+}
+/**
+* Fallback to npm registry to extract repository.url.
+* Returns null if package not found, no repo field, or not a GitHub repo.
+*/
+async function resolveFromNpm(packageName) {
+	const pkg = await fetchNpmPackage(packageName);
+	if (!pkg?.repository) return null;
+	const repoUrl = typeof pkg.repository === "string" ? pkg.repository : pkg.repository.url;
+	if (!repoUrl) return null;
+	return parseGitHubUrl(repoUrl);
+}
+async function getNpmKeywords(packageName) {
+	const pkg = await fetchNpmPackage(packageName);
+	if (!pkg?.keywords || pkg.keywords.length === 0) return [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const keyword of pkg.keywords) {
+		const normalized = keyword.trim().toLowerCase();
+		if (normalized.length < 2) continue;
+		seen.add(normalized);
+	}
+	return Array.from(seen);
+}
+/**
+* Resolution order:
+* 1. Query npm registry for repository.url
+* 2. Check FALLBACK_MAPPINGS for packages missing repository field
+* 3. Return unknown
+*/
+async function resolveDependencyRepo(dep) {
+	const npmRepo = await resolveFromNpm(dep);
+	if (npmRepo) return {
+		dep,
+		repo: npmRepo,
+		source: "npm"
 	};
-	addToken(normalized);
-	addToken(normalized.replaceAll("/", "-"));
-	addToken(normalized.replaceAll("/", ""));
-	for (const token of normalized.split(/[\s/_-]+/)) addToken(token);
-	if (normalized.startsWith("@")) addToken(normalized.slice(1));
-	return Array.from(tokens);
-}
-function deriveKeywords(fullName, localPath, referenceContent) {
-	const keywords = /* @__PURE__ */ new Set();
-	const addKeywords = (value) => {
-		for (const token of normalizeKeyword(value)) keywords.add(token);
+	if (dep in FALLBACK_MAPPINGS) return {
+		dep,
+		repo: FALLBACK_MAPPINGS[dep] ?? null,
+		source: "fallback"
 	};
-	addKeywords(fullName);
-	const headingMatch = referenceContent.match(/^#\s+(.+)$/m);
-	if (headingMatch?.[1]) addKeywords(headingMatch[1]);
+	return {
+		dep,
+		repo: null,
+		source: "unknown"
+	};
+}
+
+//#endregion
+//#region src/reference.ts
+const PackageJsonNameSchema = z.object({ name: z.string().optional() });
+function normalizeKeywords(values) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const value of values) {
+		const normalized = value.trim().toLowerCase();
+		if (normalized.length < 2) continue;
+		seen.add(normalized);
+	}
+	return Array.from(seen);
+}
+function deriveMinimalKeywords(fullName) {
+	const normalized = fullName.trim().toLowerCase();
+	if (!normalized) return [];
+	return normalizeKeywords([normalized, normalized.split("/").pop() ?? normalized]);
+}
+function getPackageName(localPath) {
 	const packageJsonPath = join(localPath, "package.json");
-	if (existsSync(packageJsonPath)) try {
+	if (!existsSync(packageJsonPath)) return null;
+	try {
 		const content = readFileSync(packageJsonPath, "utf-8");
 		const json = JSON.parse(content);
-		const parsed = PackageJsonKeywordsSchema.safeParse(json);
-		if (parsed.success) {
-			if (parsed.data.name) addKeywords(parsed.data.name);
-			if (parsed.data.keywords) for (const keyword of parsed.data.keywords) addKeywords(keyword);
-		}
-	} catch {}
-	return Array.from(keywords);
+		const parsed = PackageJsonNameSchema.safeParse(json);
+		if (!parsed.success || !parsed.data.name) return null;
+		return parsed.data.name;
+	} catch {
+		return null;
+	}
+}
+/**
+* Resolve keywords with npm-first strategy.
+* - npm package: package name + npm keywords
+* - non-npm package: minimal repo-derived keywords
+*/
+async function resolveReferenceKeywords(fullName, localPath) {
+	const packageName = getPackageName(localPath);
+	if (!packageName) return deriveMinimalKeywords(fullName);
+	const npmKeywords = await getNpmKeywords(packageName);
+	if (npmKeywords.length > 0) return normalizeKeywords([packageName, ...npmKeywords]);
+	return normalizeKeywords([packageName]);
 }
 /**
 * Ensure a symlink exists, removing any existing file/directory at the path
@@ -823,33 +912,9 @@ Use \`ow\` to locate and read Offworld reference files for dependencies.
 - You want the verified reference instead of web search
 - You are about to work inside a repo clone
 
-## Prerequisites
-
-Check that the CLI is available:
-
-\`\`\`bash
-ow --version
-\`\`\`
-
-If \`ow\` is not available, install it:
-
-\`\`\`bash
-curl -fsSL https://offworld.sh/install | bash
-\`\`\`
-
-## Setup
+## Installation and Setup
 
-Initialize Offworld once per machine:
-
-\`\`\`bash
-ow init
-\`\`\`
-
-For a specific project, build a project map:
-
-\`\`\`bash
-ow project init
-\`\`\`
+If Offworld CLI or opencode is missing, read \`references/installation.md\` in this skill directory and follow it.
 
 ## Usage
 
@@ -894,6 +959,59 @@ ow project init         # scan project deps, install references
 
 - Docs: https://offworld.sh/cli
 `;
+const INSTALLATION_REFERENCE_TEMPLATE = `# Offworld Installation
+
+Use this when Offworld CLI or opencode is not installed.
+
+## 1) Check opencode
+
+\`\`\`bash
+opencode --version
+\`\`\`
+
+If missing:
+
+\`\`\`bash
+curl -fsSL https://opencode.ai/install | bash
+\`\`\`
+
+## 2) Check Offworld CLI
+
+\`\`\`bash
+ow --version
+\`\`\`
+
+If missing:
+
+\`\`\`bash
+curl -fsSL https://offworld.sh/install | bash
+\`\`\`
+
+## 3) Initialize Offworld (non-interactive)
+
+\`\`\`bash
+ow init --yes --agents "<agent-list>" --repo-root "<clone-dir>" --model "<provider/model>"
+\`\`\`
+
+Example:
+
+\`\`\`bash
+ow init --yes --agents "opencode,codex" --repo-root "~/ow" --model "anthropic/claude-sonnet-4-20250514"
+\`\`\`
+
+## 4) Initialize current project
+
+\`\`\`bash
+ow project init --yes --all --generate
+\`\`\`
+
+## 5) Verify
+
+\`\`\`bash
+ow config show
+ow list
+\`\`\`
+`;
 /**
 * Ensures the global SKILL.md exists and symlinks the offworld/ directory to all agent skill directories.
 *
@@ -910,6 +1028,8 @@ function installGlobalSkill() {
 	mkdirSync(Paths.offworldReferencesDir, { recursive: true });
 	const skillPath = join(Paths.offworldSkillDir, "SKILL.md");
 	if (!existsSync(skillPath)) writeFileSync(skillPath, GLOBAL_SKILL_TEMPLATE, "utf-8");
+	const installationReferencePath = join(Paths.offworldReferencesDir, "installation.md");
+	if (!existsSync(installationReferencePath)) writeFileSync(installationReferencePath, INSTALLATION_REFERENCE_TEMPLATE, "utf-8");
 	const configuredAgents = config.agents ?? [];
 	for (const agentName of configuredAgents) {
 		const agentConfig = agents[agentName];
@@ -958,17 +1078,12 @@ function installReference(qualifiedName, fullName, localPath, referenceContent,
 	const legacyEntry = legacyQualifiedName ? map.repos[legacyQualifiedName] : void 0;
 	const references = [...existingEntry?.references ?? [], ...legacyEntry?.references ?? []];
 	if (!references.includes(referenceFileName)) references.push(referenceFileName);
-	const derivedKeywords = keywords ?? deriveKeywords(fullName, localPath, referenceContent);
-	const keywordsSet = new Set([
-		...existingEntry?.keywords ?? [],
-		...legacyEntry?.keywords ?? [],
-		...derivedKeywords
-	]);
+	const derivedKeywords = keywords && keywords.length > 0 ? keywords : deriveMinimalKeywords(fullName);
 	map.repos[qualifiedName] = {
 		localPath,
 		references,
 		primary: referenceFileName,
-		keywords: Array.from(keywordsSet),
+		keywords: normalizeKeywords(derivedKeywords),
 		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 	};
 	if (legacyQualifiedName && legacyQualifiedName in map.repos) delete map.repos[legacyQualifiedName];
@@ -1278,80 +1393,6 @@ function parseRequirementsTxt(path) {
 	}
 }
 
-//#endregion
-//#region src/dep-mappings.ts
-/**
-* Dependency name to GitHub repo resolution:
-* 1. Query npm registry for repository.url
-* 2. Fall back to FALLBACK_MAPPINGS for packages missing repository field
-* 3. Return unknown (caller handles)
-*/
-/**
-* Fallback mappings for packages where npm registry doesn't have repository.url.
-* Only add packages here that genuinely don't have the field set.
-*/
-const FALLBACK_MAPPINGS = {
-	"@convex-dev/react-query": "get-convex/convex-react-query",
-	"@opencode-ai/sdk": "anomalyco/opencode-sdk-js"
-};
-/**
-* Parse GitHub repo from various git URL formats.
-* Handles:
-* - git+https://github.com/owner/repo.git
-* - https://github.com/owner/repo
-* - git://github.com/owner/repo.git
-* - github:owner/repo
-*/
-function parseGitHubUrl(url) {
-	for (const pattern of [/github\.com[/:]([\w-]+)\/([\w.-]+?)(?:\.git)?$/, /^github:([\w-]+)\/([\w.-]+)$/]) {
-		const match = url.match(pattern);
-		if (match) return `${match[1]}/${match[2]}`;
-	}
-	return null;
-}
-/**
-* Fallback to npm registry to extract repository.url.
-* Returns null if package not found, no repo field, or not a GitHub repo.
-*/
-async function resolveFromNpm(packageName) {
-	try {
-		const res = await fetch(`https://registry.npmjs.org/${packageName}`);
-		if (!res.ok) return null;
-		const json = await res.json();
-		const result = NpmPackageResponseSchema.safeParse(json);
-		if (!result.success) return null;
-		const repoUrl = result.data.repository?.url;
-		if (!repoUrl) return null;
-		return parseGitHubUrl(repoUrl);
-	} catch {
-		return null;
-	}
-}
-/**
-* Resolution order:
-* 1. Query npm registry for repository.url
-* 2. Check FALLBACK_MAPPINGS for packages missing repository field
-* 3. Return unknown
-*/
-async function resolveDependencyRepo(dep) {
-	const npmRepo = await resolveFromNpm(dep);
-	if (npmRepo) return {
-		dep,
-		repo: npmRepo,
-		source: "npm"
-	};
-	if (dep in FALLBACK_MAPPINGS) return {
-		dep,
-		repo: FALLBACK_MAPPINGS[dep] ?? null,
-		source: "fallback"
-	};
-	return {
-		dep,
-		repo: null,
-		source: "unknown"
-	};
-}
-
 //#endregion
 //#region src/reference-matcher.ts
 /**
@@ -1819,5 +1860,5 @@ async function validateProviderModel(providerId, modelId) {
 }
 
 //#endregion
-export { getToken as A, NotGitRepoError as B, getAllAgentConfigs as C, clearAuthData as D, TokenExpiredError as E, saveAuthData as F, DEFAULT_IGNORE_PATTERNS as G, RepoSourceError as H, getMapEntry as I, VERSION as K, getProjectMapPath as L, isLoggedIn as M, loadAuthData as N, getAuthPath as O, refreshAccessToken as P, resolveRepoKey as R, getAgentConfig as S, NotLoggedInError as T, getReferenceFileNameForSource as U, PathNotFoundError as V, parseRepoInput as W, parseDependencies as _, discoverRepos as a, agents as b, pruneRepos as c, matchDependenciesToReferences as d, matchDependenciesToReferencesWithRemoteCheck as f, detectManifestType as g, resolveFromNpm as h, validateProviderModel as i, getTokenOrNull as j, getAuthStatus as k, updateAllRepos as l, resolveDependencyRepo as m, listProviders as n, gcRepos as o, FALLBACK_MAPPINGS as p, listProvidersWithModels as r, getRepoStatus as s, getProvider as t, isReferenceInstalled as u, installGlobalSkill as v, AuthError as w, detectInstalledAgents as x, installReference as y, searchMap as z };
-//# sourceMappingURL=public-CjA2mMwu.mjs.map
+export { getAuthPath as A, resolveRepoKey as B, detectInstalledAgents as C, NotLoggedInError as D, AuthError as E, loadAuthData as F, getReferenceFileNameForSource as G, NotGitRepoError as H, refreshAccessToken as I, VERSION as J, parseRepoInput as K, saveAuthData as L, getToken as M, getTokenOrNull as N, TokenExpiredError as O, isLoggedIn as P, getMapEntry as R, agents as S, getAllAgentConfigs as T, PathNotFoundError as U, searchMap as V, RepoSourceError as W, resolveReferenceKeywords as _, discoverRepos as a, resolveDependencyRepo as b, pruneRepos as c, matchDependenciesToReferences as d, matchDependenciesToReferencesWithRemoteCheck as f, installReference as g, installGlobalSkill as h, validateProviderModel as i, getAuthStatus as j, clearAuthData as k, updateAllRepos as l, parseDependencies as m, listProviders as n, gcRepos as o, detectManifestType as p, DEFAULT_IGNORE_PATTERNS as q, listProvidersWithModels as r, getRepoStatus as s, getProvider as t, isReferenceInstalled as u, FALLBACK_MAPPINGS as v, getAgentConfig as w, resolveFromNpm as x, getNpmKeywords as y, getProjectMapPath as z };
+//# sourceMappingURL=public-BUgna8vR.mjs.map