zuqini · Sep 25, 2026 · Sep 25, 2026 · Sep 25, 2026
diff --git a/lua/zpack/import.lua b/lua/zpack/import.lua
@@ -81,7 +81,7 @@ local normalize_source = function(spec)
   elseif type(spec.dir) == 'string' then
     return vim.fn.expand(spec.dir)
   elseif type(spec[1]) == 'string' then
-    return utils.github_url(spec[1])
+    return utils.expand_src(spec[1])
   else
     return nil, "spec must provide one of: [1], src, dir, or url"
   end

diff --git a/lua/zpack/merge.lua b/lua/zpack/merge.lua
@@ -445,7 +445,7 @@ local function fold_rank(entry, src)
   local explicit, top, dep = -1, -1, -1
   for _, spec in ipairs(entry.specs) do
     local order = spec._import_order or 0
-    if spec.dev == true and (type(spec[1]) ~= 'string' or src ~= util.github_url(spec[1])) then
+    if spec.dev == true and (type(spec[1]) ~= 'string' or src ~= util.expand_src(spec[1])) then
       return 3, order
     end
    if type(spec.src) == 'string' or type(spec.url) == 'string'
@@ -475,7 +475,7 @@ local function named_repos(entry, src)
   local repos = { [src] = true }
   for _, spec in ipairs(entry.specs) do
     if type(spec[1]) == 'string' then
-      repos[util.github_url(spec[1])] = true
+      repos[util.expand_src(spec[1])] = true
     end
   end
   return repos

diff --git a/lua/zpack/utils.lua b/lua/zpack/utils.lua
@@ -290,13 +290,17 @@ M.derive_name_from_src = function(src)
   return (basename:gsub('%.git$', ''))
 end
 
----Expand a `[1]` short name ("user/repo") to its GitHub URL. Shared by
+---Resolve a `[1]` value to a source. `user/repo` shorthand expands to its GitHub URL; full URLs and
+---paths are returned unchanged. Shared by
 ---`normalize_source` and merge.lua's coalesce fold so the two sites cannot
 ---drift on what a shorthand resolves to.
----@param short_name string
+---@param src string
 ---@return string
-M.github_url = function(short_name)
-  return 'https://github.com/' .. short_name
+M.expand_src = function(src)
+  if src:match('^%a[%w+.-]*://') or src:match('^[%w_.-]+@[^/]+:') or src:match('^[/~.]') then
+    return src
+  end
+  return 'https://github.com/' .. src
 end
 
 ---Resolve a plugin's display/pack name. lazy.nvim parity: the name derives

diff --git a/tests/utils_test.lua b/tests/utils_test.lua
@@ -192,3 +192,30 @@ describe('latch_first_call', function()
       "Subsequent calls must not invoke the inner — return nil")
   end)
 end)
+
+describe("expand_src", function()
+  local utils = require('zpack.utils')
+
+  it("expands a short name to a GitHub URL", function()
+    assert.are.equal('https://github.com/user/repo', utils.expand_src('user/repo'))
+  end)
+
+  it("returns full URLs unchanged", function()
+    local urls = {
+      'https://forge.barrettruth.com/barrettruth/canola.nvim',
+      'http://example.com/user/repo.git',
+      'ssh://git@example.com/user/repo.git',
+      'git@example.com:user/repo.git',
+      'file:///home/user/repo',
+    }
+    for _, url in ipairs(urls) do
+      assert.are.equal(url, utils.expand_src(url))
+    end
+  end)
+
+  it("returns local paths unchanged", function()
+    assert.are.equal('/home/user/repo', utils.expand_src('/home/user/repo'))
+    assert.are.equal('~/repo', utils.expand_src('~/repo'))
+    assert.are.equal('./repo', utils.expand_src('./repo'))
+  end)
+end)