@anytio/pspm 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -9,16 +9,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- **`.pspmignore` support for publish command**: Control which files are excluded when publishing or packing skill packages
-  - If `.pspmignore` exists, use it for ignore patterns (like `.npmignore`)
-  - Otherwise, fall back to `.gitignore` if present
-  - Always ignores `node_modules`, `.git`, and `.pspm-publish` regardless
-  - Displays which ignore file is being used during publish
-
-- **Local directory support (file: protocol)**: Install skills from local directories for development and testing
-  - `pspm add file:../path/to/skill` - Install from local directory
-  - `localDependencies` field in `pspm.json` for local packages
-  - Lockfile version bumped to 4 to support `localPackages`
+- **Local directory support**: Install skills directly from local directories using the `file:` protocol
+  - `pspm add file:../my-skill` - Install from relative path
+  - `pspm add file:/absolute/path/to/skill` - Install from absolute path
+  - `pspm add ../my-skill` - Auto-detected as `file:../my-skill`
+  - Local packages are symlinked (not copied) for instant updates during development
+  - `localDependencies` section in `pspm.json`
+  - `localPackages` section in lockfile (version 5)
+  - Local packages stored as symlinks in `.pspm/skills/_local/{name}/`
+
+- **Enhanced `list` command**: Shows local packages with `[local]` indicator and path
+
+### Changed
+
+- Lockfile version bumped to 5 to support `localPackages`
+- `install` command now processes local dependencies (Phase 2.5 resolve, Phase 4.5 install)
+- `remove` command now handles local package removal
 
 ## [0.2.0] - 2026-01-23
 

package/CLI_GUIDE.md

@@ -158,6 +158,11 @@ pspm add github:owner/repo@main             # Entire repo, specific branch
 pspm add github:owner/repo/path/to/skill    # Subdirectory, default branch
 pspm add github:owner/repo/path@v1.0.0      # Subdirectory with tag/ref
 
+# Local specifier formats:
+pspm add file:../my-skill                   # Relative path (symlinked)
+pspm add file:/absolute/path/to/skill       # Absolute path
+pspm add ../my-skill                        # Auto-detected as file:../my-skill
+
 # Add multiple skills at once:
 pspm add @user/alice/skill1 @user/bob/skill2
 
@@ -196,7 +201,10 @@ pspm list --json
 #   github:owner/repo/skills/react-tips (main@abc1234)
 #     -> .claude/skills/react-tips, .cursor/skills/react-tips
 #
-# Total: 2 skill(s) (1 registry, 1 github)
+#   my-local-skill [local] <- ../my-local-skill
+#     -> .claude/skills/my-local-skill
+#
+# Total: 3 skill(s) (1 registry, 1 github, 1 local)
 ```
 
 ### Install Skills
@@ -353,7 +361,7 @@ Package manifest file (created with `pspm init`):
 
 ```json
 {
-  "lockfileVersion": 3,
+  "lockfileVersion": 5,
   "registryUrl": "https://pspm.dev",
   "packages": {
     "@user/bsheng/vite_slides": {
@@ -370,6 +378,14 @@ Package manifest file (created with `pspm init`):
       "gitCommit": "abc1234567890...",
       "gitRef": "main"
     }
+  },
+  "localPackages": {
+    "file:../my-skill": {
+      "version": "local",
+      "path": "../my-skill",
+      "resolvedPath": "/absolute/path/to/my-skill",
+      "name": "my-skill"
+    }
   }
 }
 ```
@@ -402,10 +418,12 @@ project/
 │   ├── skills/          # Installed skills
 │   │   ├── {username}/  # Registry skills
 │   │   │   └── {skillname}/
-│   │   └── _github/     # GitHub skills
-│   │       └── {owner}/
-│   │           └── {repo}/
-│   │               └── {path}/
+│   │   ├── _github/     # GitHub skills
+│   │   │   └── {owner}/
+│   │   │       └── {repo}/
+│   │   │           └── {path}/
+│   │   └── _local/      # Local skills (symlinks)
+│   │       └── {name} -> /path/to/source
 │   └── cache/           # Tarball cache
 ├── .claude/
 │   └── skills/          # Symlinks for claude-code agent

package/README.md

@@ -100,9 +100,10 @@ pspm install                                     # Install all from lockfile
 - `github:owner/repo/path/to/skill` - Subdirectory within repo
 - `github:owner/repo/path/to/skill@v1.0.0` - Subdirectory with tag
 
-**Local directory specifiers (for development):**
-- `file:../path/to/skill` - Install from local directory
-- `file:./subdir/skill` - Relative path from current directory
+**Local specifier formats:**
+- `file:../my-skill` - Relative path (symlinked, not copied)
+- `file:/absolute/path/to/skill` - Absolute path
+- `../my-skill` - Auto-detected as `file:../my-skill`
 
 **Agent symlink options:**
 ```bash
@@ -165,7 +166,7 @@ registry = https://custom-registry.example.com
 
 ```json
 {
-  "lockfileVersion": 3,
+  "lockfileVersion": 5,
   "registryUrl": "https://pspm.dev",
   "packages": {
     "@user/username/skillname": {
@@ -182,6 +183,14 @@ registry = https://custom-registry.example.com
       "gitCommit": "abc1234567890...",
       "gitRef": "main"
     }
+  },
+  "localPackages": {
+    "file:../my-skill": {
+      "version": "local",
+      "path": "../my-skill",
+      "resolvedPath": "/absolute/path/to/my-skill",
+      "name": "my-skill"
+    }
   }
 }
 ```
@@ -206,11 +215,13 @@ project/
 │   │   ├── username/    # Registry skills
 │   │   │   └── skillname/
 │   │   │       └── SKILL.md
-│   │   └── _github/     # GitHub skills
-│   │       └── owner/
-│   │           └── repo/
-│   │               └── path/
-│   │                   └── SKILL.md
+│   │   ├── _github/     # GitHub skills
+│   │   │   └── owner/
+│   │   │       └── repo/
+│   │   │           └── path/
+│   │   │               └── SKILL.md
+│   │   └── _local/      # Local skills (symlinks)
+│   │       └── my-skill -> /absolute/path/to/my-skill
 │   └── cache/           # Tarball cache
 ├── .claude/
 │   └── skills/          # Symlinks for claude-code agent
@@ -223,23 +234,6 @@ project/
 └── .pspmrc              # User config
 ```
 
-## Ignoring Files (.pspmignore)
-
-Control which files are excluded when publishing with a `.pspmignore` file:
-
-```
-# .pspmignore - exclude files from publish
-*.test.ts
-__tests__/
-.env*
-*.log
-```
-
-**Behavior:**
-- If `.pspmignore` exists, use it for ignore patterns
-- Otherwise, fall back to `.gitignore` if present
-- Always ignores `node_modules`, `.git`, and `.pspm-publish` regardless
-
 ## Creating a Skill
 
 A skill is a directory containing at minimum a `pspm.json` and `SKILL.md`: