feat: v0.4.7 -- search provider column, JSON url field, get command

- Add provider domain column to search text output (Python + TS CLI)
- Add url field to JSON search results (registry)
- Add `lapsh get <name>` command to download specs from registry
- 71 search tests, 1016 total passing

Co-Authored-By: Claude Opus 4.6 <[email protected]>

Author: mickmicksh

lap/__init__.py

@@ -1,3 +1,3 @@
 """LAP -- Lean API Platform. Token-efficient API specs for AI agents."""
 
-__version__ = "0.4.6"
+__version__ = "0.4.7"

lap/cli/main.py

@@ -715,6 +715,8 @@ def _format_search_results(results, total, offset):
     rows = []
     for r in results:
         name = _sanitize(r.get("name", ""))
+        prov = r.get("provider") or {}
+        prov_str = _sanitize(prov.get("domain", "") or prov.get("display_name", "") or "")
         desc = _sanitize(r.get("description", ""))
         ep = r.get("endpoints")
         ep_str = f"{ep} endpoints" if isinstance(ep, int) else ""
@@ -725,20 +727,49 @@ def _format_search_results(results, total, offset):
         else:
             ratio_str = ""
         skill = " [skill]" if r.get("has_skill") else ""
-        rows.append((name, ep_str, ratio_str, desc, skill))
+        rows.append((name, prov_str, ep_str, ratio_str, desc, skill))
 
     name_w = max((len(r[0]) for r in rows), default=0)
-    ep_w = max((len(r[1]) for r in rows), default=0)
-    ratio_w = max((len(r[2]) for r in rows), default=0)
+    prov_w = max((len(r[1]) for r in rows), default=0)
+    ep_w = max((len(r[2]) for r in rows), default=0)
+    ratio_w = max((len(r[3]) for r in rows), default=0)
 
-    for name, ep_str, ratio_str, desc, skill in rows:
-        print(f"  {name:<{name_w}}  {ep_str:>{ep_w}}  {ratio_str:>{ratio_w}}   {desc}{skill}")
+    for name, prov_str, ep_str, ratio_str, desc, skill in rows:
+        print(f"  {name:<{name_w}}  {prov_str:<{prov_w}}  {ep_str:>{ep_w}}  {ratio_str:>{ratio_w}}   {desc}{skill}")
 
     shown = offset + len(results)
     if shown < total:
         info(f"Showing {shown}/{total} results. Use --offset {shown} for more.")
 
 
+from urllib.request import urlopen, Request as _UrlRequest
+
+
+def cmd_get(args):
+    """Download a LAP spec from the registry by name."""
+    from lap.cli.auth import get_registry_url
+    from urllib.parse import quote
+
+    name = args.name
+    url = f"{get_registry_url()}/v1/apis/{quote(name, safe='')}"
+    if getattr(args, "lean", False):
+        url += "?format=lean"
+
+    try:
+        req = _UrlRequest(url, headers={"Accept": "text/lap"})
+        with urlopen(req) as resp:
+            body = resp.read().decode("utf-8")
+    except Exception as e:
+        error(f"Failed to fetch '{name}': {e}")
+
+    if args.output:
+        Path(args.output).parent.mkdir(parents=True, exist_ok=True)
+        Path(args.output).write_text(body, encoding="utf-8")
+        info(f"Saved {name} to {args.output}")
+    else:
+        print(body)
+
+
 def cmd_search(args):
     """Search the LAP registry for APIs. No auth required."""
     from lap.cli.auth import api_request
@@ -1034,6 +1065,12 @@ def main():
     p.add_argument("name", help="API name from the registry")
     p.add_argument("--dir", help="Custom install directory (default: ~/.claude/skills/)")
 
+    # get
+    p = sub.add_parser("get", help="Download a LAP spec from the registry")
+    p.add_argument("name", help="API name (e.g. stripe)")
+    p.add_argument("-o", "--output", help="Output file path")
+    p.add_argument("--lean", action="store_true", help="Download lean variant")
+
     # search
     p = sub.add_parser("search", help="Search the LAP registry for APIs")
     p.add_argument("query", nargs="+", help="Search query")
@@ -1066,6 +1103,7 @@ def main():
         "skill": cmd_skill,
         "skill-batch": cmd_skill_batch,
         "skill-install": cmd_skill_install,
+        "get": cmd_get,
         "search": cmd_search,
         "benchmark-skill": cmd_benchmark_skill,
         "benchmark-skill-all": cmd_benchmark_skill_all,

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lapsh"
-version = "0.4.6"
+version = "0.4.7"
 description = "Lean API Platform -- Token-efficient API specs for AI agents"
 readme = "README.md"
 license = "Apache-2.0"

sdks/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lap-platform/lapsh",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "TypeScript SDK for LAP (Lean API Platform) -- Parse and work with LAP API specifications",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

sdks/typescript/src/cli.ts

@@ -70,6 +70,7 @@ Commands:
   skill-batch <dir> -o <outdir>         Batch generate skills
     [--layer 1|2] [-v]                  Layer + verbose mode
   skill-install <name> [--dir <path>]   Install skill from registry
+  get <name> [-o output] [--lean]        Download a LAP spec from the registry
   search <query> [--tag t] [--sort s]   Search the LAP registry for APIs
     [--limit n] [--offset n] [--json]   Pagination and JSON output
 
@@ -434,22 +435,24 @@ async function cmdSearch(args: string[]): Promise<void> {
 
   const rows = result.results.map(r => {
     const name = r.name || '';
+    const prov = r.provider?.domain || r.provider?.display_name || '';
     const desc = r.description || '';
     const ep = typeof r.endpoints === 'number' ? `${r.endpoints} endpoints` : '';
     const size = r.size;
     const lean = r.lean_size;
     const ratio = (typeof size === 'number' && typeof lean === 'number' && lean)
       ? `${(size / lean).toFixed(1)}x compressed` : '';
     const skill = r.has_skill ? ' [skill]' : '';
-    return { name, ep, ratio, desc, skill };
+    return { name, prov, ep, ratio, desc, skill };
   });
 
   const nameW = Math.max(...rows.map(r => r.name.length));
+  const provW = Math.max(...rows.map(r => r.prov.length));
   const epW = Math.max(...rows.map(r => r.ep.length));
   const ratioW = Math.max(...rows.map(r => r.ratio.length));
 
-  for (const { name, ep, ratio, desc, skill } of rows) {
-    console.log(`  ${name.padEnd(nameW)}  ${ep.padStart(epW)}  ${ratio.padStart(ratioW)}   ${desc}${skill}`);
+  for (const { name, prov, ep, ratio, desc, skill } of rows) {
+    console.log(`  ${name.padEnd(nameW)}  ${prov.padEnd(provW)}  ${ep.padStart(epW)}  ${ratio.padStart(ratioW)}   ${desc}${skill}`);
   }
 
   const shown = (result.offset || 0) + result.results.length;
@@ -458,6 +461,51 @@ async function cmdSearch(args: string[]): Promise<void> {
   }
 }
 
+async function cmdGet(args: string[]): Promise<void> {
+  let name = '';
+  let output = '';
+  let lean = false;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '-o' || args[i] === '--output') { output = args[++i]; }
+    else if (args[i] === '--lean') { lean = true; }
+    else if (!args[i].startsWith('-')) { name = args[i]; }
+  }
+
+  if (!name) error('Missing API name. Usage: lapsh get <name> [-o output] [--lean]');
+
+  const registryUrl = getRegistryUrl();
+  let url = `${registryUrl}/v1/apis/${encodeURIComponent(name)}`;
+  if (lean) url += '?format=lean';
+
+  const http = await import('http');
+  const https = await import('https');
+  const fetcher = url.startsWith('https') ? https : http;
+
+  const body = await new Promise<string>((resolve, reject) => {
+    const req = fetcher.get(url, { headers: { 'Accept': 'text/lap' } }, (res) => {
+      if (res.statusCode && res.statusCode >= 400) {
+        reject(new Error(`HTTP ${res.statusCode} fetching '${name}'`));
+        res.resume();
+        return;
+      }
+      const chunks: Buffer[] = [];
+      res.on('data', (chunk: Buffer) => chunks.push(chunk));
+      res.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+    });
+    req.on('error', reject);
+  });
+
+  if (output) {
+    const dir = path.dirname(output);
+    if (dir) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(output, body, 'utf-8');
+    info(`Saved ${name} to ${output}`);
+  } else {
+    console.log(body);
+  }
+}
+
 async function cmdSkillInstall(args: string[]): Promise<void> {
   let name = '';
   let dir = '';
@@ -530,6 +578,9 @@ async function main(): Promise<void> {
       case 'skill-install':
         await cmdSkillInstall(args.slice(1));
         break;
+      case 'get':
+        await cmdGet(args.slice(1));
+        break;
       case 'search':
         await cmdSearch(args.slice(1));
         break;

sdks/typescript/src/parser.ts

@@ -305,6 +305,7 @@ export interface SearchResult {
   source_url: string;
   last_updated: string;
   is_community: boolean;
+  url?: string;
 }
 
 export interface SearchResponse {

tests/test_search.py

@@ -10,7 +10,7 @@
 # Ensure project root is on path
 sys.path.insert(0, str(Path(__file__).parent.parent))
 
-from lap.cli.main import _sanitize, _validate_search_response, _format_search_results, cmd_search
+from lap.cli.main import _sanitize, _validate_search_response, _format_search_results, cmd_search, cmd_get
 
 
 # ── _sanitize ────────────────────────────────────────────────────────
@@ -166,6 +166,7 @@ def _make_result(self, **overrides):
             "size": 1000,
             "lean_size": 250,
             "has_skill": True,
+            "provider": {"slug": "stripe", "display_name": "Stripe", "domain": "stripe.com"},
         }
         base.update(overrides)
         return base
@@ -175,11 +176,30 @@ def test_basic_output(self, capsys):
         _format_search_results(results, total=1, offset=0)
         out = capsys.readouterr().out
         assert "stripe" in out
+        assert "stripe.com" in out
         assert "42 endpoints" in out
         assert "4.0x compressed" in out
         assert "Payment processing" in out
         assert "[skill]" in out
 
+    def test_provider_domain_shown(self, capsys):
+        results = [self._make_result(provider={"slug": "twilio", "display_name": "Twilio", "domain": "twilio.com"})]
+        _format_search_results(results, total=1, offset=0)
+        out = capsys.readouterr().out
+        assert "twilio.com" in out
+
+    def test_provider_fallback_to_display_name(self, capsys):
+        results = [self._make_result(provider={"slug": "x", "display_name": "MyAPI", "domain": ""})]
+        _format_search_results(results, total=1, offset=0)
+        out = capsys.readouterr().out
+        assert "MyAPI" in out
+
+    def test_provider_missing_graceful(self, capsys):
+        results = [self._make_result(provider=None)]
+        _format_search_results(results, total=1, offset=0)
+        out = capsys.readouterr().out
+        assert "stripe" in out  # name still shows
+
     def test_no_skill_marker(self, capsys):
         results = [self._make_result(has_skill=False)]
         _format_search_results(results, total=1, offset=0)
@@ -423,3 +443,53 @@ def test_results_with_skill_shown(self, capsys):
         out = capsys.readouterr().out
         assert "twilio" in out
         assert "[skill]" in out
+
+
+# ── cmd_get ──────────────────────────────────────────────────────────
+
+
+def _make_get_args(**overrides):
+    args = MagicMock()
+    args.name = "stripe"
+    args.output = None
+    args.lean = False
+    for k, v in overrides.items():
+        setattr(args, k, v)
+    return args
+
+
+class TestCmdGet:
+    def test_get_prints_to_stdout(self, capsys):
+        mock_resp = MagicMock()
+        mock_resp.read.return_value = b"@api Stripe\n@base https://api.stripe.com"
+        mock_resp.__enter__ = lambda s: s
+        mock_resp.__exit__ = MagicMock(return_value=False)
+        with patch("lap.cli.main.urlopen", return_value=mock_resp):
+            cmd_get(_make_get_args())
+        out = capsys.readouterr().out
+        assert "@api Stripe" in out
+
+    def test_get_writes_to_file(self, tmp_path):
+        out_file = str(tmp_path / "stripe.lap")
+        mock_resp = MagicMock()
+        mock_resp.read.return_value = b"@api Stripe"
+        mock_resp.__enter__ = lambda s: s
+        mock_resp.__exit__ = MagicMock(return_value=False)
+        with patch("lap.cli.main.urlopen", return_value=mock_resp):
+            cmd_get(_make_get_args(output=out_file))
+        assert Path(out_file).read_text(encoding="utf-8") == "@api Stripe"
+
+    def test_get_lean_flag_adds_query_param(self):
+        mock_resp = MagicMock()
+        mock_resp.read.return_value = b"@api Stripe"
+        mock_resp.__enter__ = lambda s: s
+        mock_resp.__exit__ = MagicMock(return_value=False)
+        with patch("lap.cli.main.urlopen", return_value=mock_resp) as mock_open:
+            cmd_get(_make_get_args(lean=True))
+        call_arg = mock_open.call_args[0][0]
+        assert "format=lean" in call_arg.full_url
+
+    def test_get_network_error_exits(self):
+        with patch("lap.cli.main.urlopen", side_effect=Exception("Connection refused")):
+            with pytest.raises(SystemExit):
+                cmd_get(_make_get_args())