llm-api-scope 0.7.0__tar.gz → 0.8.0__tar.gz

{llm_api_scope-0.7.0/llm_api_scope.egg-info → llm_api_scope-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llm-api-scope
-Version: 0.7.0
+Version: 0.8.0
 Summary: read and cache structured documents from remote for LLM agents
 Author-email: D7x7z49 <85430783+D7x7z49@users.noreply.github.com>
 License: MIT License
@@ -79,6 +79,17 @@ read, search, and navigate RFC documents from the IETF.
 
 the metadata index is mirrored once via rsync. individual text files are fetched on demand and cached locally. you can browse the table of contents, jump to a section (XML) or page (TXT), filter the index by status or source, and run keyword searches against fulltext content.
 
+### skill
+
+output a combined command reference and strategy guide for AI agents.
+
+run `apiscope skill` to get a single document that covers every subcommand and
+how they fit together. the strategy guide classifies commands into management and
+usage groups, lists prerequisites in ABNF (RFC 5234), and provides workflow
+patterns with requirement levels (RFC 2119).
+
+agents read this output once at onboarding instead of running `--help` repeatedly.
+
 ### repo
 
 sync documentation directories from any git repository to a local cache.

{llm_api_scope-0.7.0 → llm_api_scope-0.8.0}/README.md

@@ -30,6 +30,17 @@ read, search, and navigate RFC documents from the IETF.
 
 the metadata index is mirrored once via rsync. individual text files are fetched on demand and cached locally. you can browse the table of contents, jump to a section (XML) or page (TXT), filter the index by status or source, and run keyword searches against fulltext content.
 
+### skill
+
+output a combined command reference and strategy guide for AI agents.
+
+run `apiscope skill` to get a single document that covers every subcommand and
+how they fit together. the strategy guide classifies commands into management and
+usage groups, lists prerequisites in ABNF (RFC 5234), and provides workflow
+patterns with requirement levels (RFC 2119).
+
+agents read this output once at onboarding instead of running `--help` repeatedly.
+
 ### repo
 
 sync documentation directories from any git repository to a local cache.

{llm_api_scope-0.7.0 → llm_api_scope-0.8.0}/apiscope/skill/_usage.py

@@ -69,4 +69,7 @@ USAGE_TEXT = """\
     - list # list registered repos
     - sync # sync all registered repos to cache
       + [--force]? # force re-sync ignoring cache TTL
+  - skill # output usage guide for ai agents
+    - install # install SKILL.md for code agent
+      + [TARGET]? # install directory (default: ~/.agents/skills)
 """

llm_api_scope-0.8.0/apiscope/skill/app.py

@@ -0,0 +1,50 @@
+# apiscope/skill/app.py
+
+from pathlib import Path
+
+import typer
+
+from apiscope.skill._usage import USAGE_TEXT
+from apiscope.skill.docs import INSTALL_MD, STRATEGY_GUIDE
+
+app = typer.Typer(help="output usage guide for ai agents")
+
+
+# ==============================================================================
+# callback
+# ==============================================================================
+
+
+@app.callback(invoke_without_command=True)
+def skill_callback(ctx: typer.Context) -> None:
+    if ctx.invoked_subcommand is not None:
+        return
+
+    typer.echo("=== COMMAND REFERENCE ===")
+    typer.echo()
+    typer.echo(USAGE_TEXT)
+    typer.echo()
+    typer.echo("=== STRATEGY GUIDE ===")
+    typer.echo()
+    typer.echo(STRATEGY_GUIDE)
+
+
+# ==============================================================================
+# commands
+# ==============================================================================
+
+
+@app.command(name="install", help="install SKILL.md for code agent")
+def install(
+    target: str | None = typer.Argument(None, help="install directory (default: ~/.agents/skills)"),
+) -> None:
+    if target is None:
+        target = str(Path.home() / ".agents" / "skills")
+
+    target_path = Path(target).expanduser().resolve()
+    skill_path = target_path / "apiscope" / "SKILL.md"
+
+    skill_path.parent.mkdir(parents=True, exist_ok=True)
+    skill_path.write_text(INSTALL_MD)
+
+    typer.echo(f"installed: {skill_path}")

{llm_api_scope-0.7.0 → llm_api_scope-0.8.0}/apiscope/skill/docs.py

@@ -109,3 +109,33 @@ TIPS
     first to scan endpoints, then [describe] to extract a
     specific operation in detail.
 """
+
+
+INSTALL_MD = """\
+---
+name: apiscope
+description: >-
+  Query OpenAPI specs, IETF RFCs, and synced git repo docs.
+  Use when searching API references, RFC standards,
+  or documentation of registered repos.
+---
+
+`apiscope` reads network resources to local cache.
+it covers openapi specs, ietf rfc documents, and git repo docs.
+
+discover commands with `--help`.
+  `apiscope --help`
+  `apiscope <sub> --help`
+
+read the full strategy guide.
+  `apiscope skill`
+
+find cached repo paths.
+  `apiscope repo list`
+
+search cached docs.
+  `rg <term> <cache-path>`
+
+prefer cached docs.
+use `--force` only when remote has changed.
+"""

{llm_api_scope-0.7.0 → llm_api_scope-0.8.0/llm_api_scope.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llm-api-scope
-Version: 0.7.0
+Version: 0.8.0
 Summary: read and cache structured documents from remote for LLM agents
 Author-email: D7x7z49 <85430783+D7x7z49@users.noreply.github.com>
 License: MIT License
@@ -79,6 +79,17 @@ read, search, and navigate RFC documents from the IETF.
 
 the metadata index is mirrored once via rsync. individual text files are fetched on demand and cached locally. you can browse the table of contents, jump to a section (XML) or page (TXT), filter the index by status or source, and run keyword searches against fulltext content.
 
+### skill
+
+output a combined command reference and strategy guide for AI agents.
+
+run `apiscope skill` to get a single document that covers every subcommand and
+how they fit together. the strategy guide classifies commands into management and
+usage groups, lists prerequisites in ABNF (RFC 5234), and provides workflow
+patterns with requirement levels (RFC 2119).
+
+agents read this output once at onboarding instead of running `--help` repeatedly.
+
 ### repo
 
 sync documentation directories from any git repository to a local cache.

{llm_api_scope-0.7.0 → llm_api_scope-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "llm-api-scope"
-version = "0.7.0"
+version = "0.8.0"
 description = "read and cache structured documents from remote for LLM agents"
 readme = "README.md"
 license = { file = "LICENSE" }

llm_api_scope-0.7.0/apiscope/skill/app.py

@@ -1,19 +0,0 @@
-# apiscope/skill/app.py
-
-import typer
-
-from apiscope.skill._usage import USAGE_TEXT
-from apiscope.skill.docs import STRATEGY_GUIDE
-
-app = typer.Typer(help="output usage guide for ai agents")
-
-
-@app.callback(invoke_without_command=True)
-def skill_callback() -> None:
-    typer.echo("=== COMMAND REFERENCE ===")
-    typer.echo()
-    typer.echo(USAGE_TEXT)
-    typer.echo()
-    typer.echo("=== STRATEGY GUIDE ===")
-    typer.echo()
-    typer.echo(STRATEGY_GUIDE)