pkgq 0.3.0__tar.gz → 0.3.2__tar.gz

{pkgq-0.3.0 → pkgq-0.3.2}/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pkgq",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Package Query - Find, create, and update package documentation for AI agents",
   "author": {
     "name": "Christophe VG",
@@ -17,5 +17,6 @@
     "agents",
     "pypi",
     "mcp"
-  ]
-}
+  ],
+  "skills": [ "./src/pkgq/skills" ]
+}

{pkgq-0.3.0 → pkgq-0.3.2}/HISTORY.md

@@ -1,5 +1,27 @@
 # pkgq Version History
 
+## 0.3.2 (2026-06-26)
+
+### Bug Fixes
+
+- **Package structure**: Fixed skills directory location for proper distribution
+  - Removed symlink that broke hatchling build process
+  - Configured skills path in plugin.json for local development
+  - Skills now properly included in installed package at `pkgq/skills/`
+
+---
+
+## 0.3.1 (2026-06-26)
+
+### Bug Fixes
+
+- **Package structure**: Fixed skills directory location in package
+  - Skills now correctly packaged as `pkgq/skills/` instead of root level
+  - Skills directory now properly included in distribution
+  - Removed symlink confusion that caused incorrect package structure
+
+---
+
 ## 0.3.0 (2026-06-26)
 
 ### New Features

{pkgq-0.3.0 → pkgq-0.3.2}/Makefile

@@ -73,11 +73,3 @@ clean: ## Remove build artifacts
 
 clean-all: clean ## Remove virtualenv and lock file
 	rm -rf .venv uv.lock
-
-## Help
-
-help: ## Show this help message
-	@echo "Usage: make [target]"
-	@echo ""
-	@echo "Targets:"
-	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' Makefile | grep -v "install-pythons\|sync" | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2}'

{pkgq-0.3.0 → pkgq-0.3.2}/PACKAGE.md

@@ -201,7 +201,7 @@ The plugin manifest is automatically discovered when pkgq is loaded as a yoker p
 
 ## Version Notes
 
-**Current Version:** 0.3.0
+**Current Version:** 0.3.2
 
 ### Recent Features
 

{pkgq-0.3.0 → pkgq-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pkgq
-Version: 0.3.0
+Version: 0.3.2
 Summary: Package Query - Find API information for Python packages
 Project-URL: Homepage, https://github.com/christophevg/pkgq
 Project-URL: Documentation, https://github.com/christophevg/pkgq#readme
@@ -136,7 +136,7 @@ visibility into agent operations.
 
 % pkgq cache --list
 Cached packages (3):
-  pkgq 0.3.0 (pypi)
+  pkgq 0.3.2 (pypi)
   roomz 0.2.0 (github:christophevg/roomz)
   yoker 0.5.0 (github:christophevg/yoker)
 ```

{pkgq-0.3.0 → pkgq-0.3.2}/README.md

@@ -96,7 +96,7 @@ visibility into agent operations.
 
 % pkgq cache --list
 Cached packages (3):
-  pkgq 0.3.0 (pypi)
+  pkgq 0.3.2 (pypi)
   roomz 0.2.0 (github:christophevg/roomz)
   yoker 0.5.0 (github:christophevg/yoker)
 ```

{pkgq-0.3.0 → pkgq-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pkgq"
-version = "0.3.0"
+version = "0.3.2"
 description = "Package Query - Find API information for Python packages"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -57,16 +57,6 @@ Documentation = "https://github.com/christophevg/pkgq#readme"
 Repository = "https://github.com/christophevg/pkgq"
 Issues = "https://github.com/christophevg/pkgq/issues"
 
-[tool.hatch.build.targets.wheel]
-packages = ["src/pkgq", "skills"]
-
-[tool.hatch.build.targets.sdist]
-exclude = [
-  "*.pyc",
-  "__pycache__",
-  "*.egg-info",
-]
-
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 asyncio_mode = "auto"
@@ -129,4 +119,4 @@ commands_pre = [
   ["uv", "pip", "install", "-e", "."],
   ["uv", "pip", "install", "pytest", "pytest-cov", "pytest-asyncio"],
 ]
-commands = [["pytest", "tests", "-v", "--cov=pkgq", "--cov-report=term-missing"]]
+commands = [["pytest", "tests", "-v", "--cov=pkgq", "--cov-report=term-missing"]]

{pkgq-0.3.0 → pkgq-0.3.2}/src/pkgq/__init__.py

@@ -4,7 +4,7 @@ pkgq - Package Query
 Find API information for Python packages.
 """
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 
 from pkgq.find import FindResult, find
 from pkgq.plugin import __YOKER_MANIFEST__

{pkgq-0.3.0 → pkgq-0.3.2}/src/pkgq/mcp.py

@@ -13,7 +13,7 @@ from pkgq import find
 # Create MCP server
 mcp = FastMCP(
   name="pkgq",
-  version="0.3.0",
+  version="0.3.2",
 )
 
 

pkgq-0.3.2/src/pkgq/skills/__init__.py

@@ -0,0 +1 @@
+"""Yoker plugin skills for pkgq."""

pkgq-0.3.2/src/pkgq/skills/create/__init__.py

@@ -0,0 +1 @@
+"""Create skill for generating PACKAGE.md files."""

pkgq-0.3.2/src/pkgq/skills/update/__init__.py

@@ -0,0 +1 @@
+"""Update skill for updating package documentation."""

{pkgq-0.3.0 → pkgq-0.3.2}/uv.lock

@@ -1327,7 +1327,7 @@ wheels = [
 
 [[package]]
 name = "pkgq"
-version = "0.3.0"
+version = "0.3.2"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

pkgq-0.3.0/MANIFEST.in

@@ -1,2 +0,0 @@
-recursive-include src/pkgq/skills *.md
-graft src/pkgq/skills

pkgq-0.3.0/skills/__init__.py

@@ -1 +0,0 @@
-"""Yoker plugin skills for pkgq."""

pkgq-0.3.0/skills/create/SKILL.md

@@ -1,234 +0,0 @@
----
-name: create
-description: |
-  Generate a PACKAGE.md file for a Python project. Analyzes the project structure,
-  extracts key components, patterns, and creates agent-ready documentation.
-  Use when creating documentation for your own packages.
----
-
-# Package Documentation Generator
-
-Creates PACKAGE.md files for Python packages, following the PACKAGE.md specification.
-
-## When to Use
-
-- You've created a new Python package
-- You want to document your package for AI agents
-- You're preparing a release and documentation needs updating
-
-## Input
-
-| Parameter | Required | Description |
-|-----------|----------|-------------|
-| path | No | Project path (defaults to current directory) |
-| output | No | Output path (defaults to PACKAGE.md in project root) |
-
-## Process
-
-### 1. Gather Project Metadata
-
-Read project configuration:
-
-```
-pyproject.toml
-├── [project]
-│   ├── name
-│   ├── version
-│   ├── description
-│   ├── dependencies
-│   └── urls
-├── [project.optional-dependencies]
-└── [project.readme]
-```
-
-If `pyproject.toml` missing, check:
-- `setup.py` (legacy)
-- `setup.cfg` (legacy)
-- `requirements.txt` (minimal)
-
-### 2. Analyze Source Structure
-
-Scan the package source:
-
-```
-src/{package}/
-├── __init__.py      # Exports, version
-├── {module}.py      # Key functions, classes
-└── {submodule}/     # Nested modules
-```
-
-Or:
-
-```
-{package}/
-├── __init__.py
-├── {module}.py
-└── ...
-```
-
-**Extract:**
-- Package name from `__init__.py` or `pyproject.toml`
-- Key classes (look for `class` definitions)
-- Key functions (look for `def` at module level)
-- Entry points (`__all__`, `__main__.py`)
-
-### 3. Extract Patterns from Tests
-
-Scan test files for usage patterns:
-
-```
-tests/
-├── test_{module}.py
-└── ...
-```
-
-**Extract:**
-- Import patterns
-- Initialization patterns
-- Common usage sequences
-- Configuration examples
-
-### 4. Read Existing Documentation
-
-Read for context:
-
-- `README.md` - Human documentation
-- `AGENTS.md` / `CLAUDE.md` - Development instructions
-- `docs/` - Full documentation (if exists)
-
-**Extract:**
-- Purpose statement
-- Quick start example
-- Configuration options
-- Known issues/limitations
-
-### 5. Check for Changelog
-
-Look for version history:
-
-- `CHANGELOG.md`
-- `HISTORY.md`
-- `NEWS.md`
-- GitHub releases
-- Git tags
-
-### 6. Generate PACKAGE.md
-
-Create the documentation file:
-
-```markdown
-# {Package Name}
-
-> {One-line description from pyproject.toml or README}
-
-## Overview
-
-{Extended description from README}
-
-## Installation
-
-\`\`\`
-pip install {package}
-\`\`\`
-
-## Quick Start
-
-{Minimal example from tests or README}
-
-## Key Components
-
-{Extracted from source analysis}
-
-### Classes
-
-#### `{ClassName}`
-
-{Purpose inferred from docstring or usage}
-
-\`\`\`python
-{Usage example from tests}
-\`\`\`
-
-## Common Patterns
-
-{Extracted from tests}
-
-## Dependencies
-
-{From pyproject.toml}
-
-## Version Notes
-
-{Current version from pyproject.toml}
-
-## References
-
-{Links from pyproject.toml project.urls}
-```
-
-### 7. Generate HISTORY.md
-
-If changelog information available:
-
-```markdown
-# {Package} Version History
-
-## {Current Version} ({Date})
-
-### New Features
-- {From changelog}
-
-### Breaking Changes
-- {From changelog}
-
----
-
-{Previous versions}
-```
-
-## Output
-
-Creates two files:
-
-1. **PACKAGE.md** - Agent-ready documentation
-2. **HISTORY.md** - Version history (if version info available)
-
-## Example Usage
-
-```bash
-# Generate for current project
-/pkgq:create
-
-# Generate for specific project
-/pkgq:create path=~/projects/my-package
-
-# Specify output location
-/pkgq:create output=docs/PACKAGE.md
-```
-
-## Quality Checks
-
-After generation, verify:
-
-- [ ] Purpose statement is clear
-- [ ] Quick Start example works
-- [ ] Key components are documented
-- [ ] Common patterns cover 80% use cases
-- [ ] Dependencies are accurate
-- [ ] References links are correct
-
-## Customization
-
-The generated PACKAGE.md may need manual refinement:
-
-1. **Review purpose** - Is it accurate?
-2. **Refine Quick Start** - Is it minimal and working?
-3. **Add patterns** - Are common use cases covered?
-4. **Update migration guides** - Are breaking changes documented?
-
-## Notes
-
-- Works best with well-structured Python packages
-- Legacy packages (setup.py only) have limited metadata extraction
-- Private packages (not on PyPI) should use this skill
-- Always review generated documentation before publishing

pkgq-0.3.0/skills/create/__init__.py

@@ -1 +0,0 @@
-"""Create skill for generating PACKAGE.md files."""

pkgq-0.3.0/skills/update/__init__.py

@@ -1 +0,0 @@
-"""Update skill for updating package documentation."""