create-node-lib 2.13.3 → 2.14.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [2.14.0](https://github.com/lirantal/create-node-lib/compare/v2.13.4...v2.14.0) (2026-03-26)
+
+
+### Features
+
+* add apm manifest ([583ed58](https://github.com/lirantal/create-node-lib/commit/583ed58987e0c4644477fed879d8b55f543be69b))
+
+## [2.13.4](https://github.com/lirantal/create-node-lib/compare/v2.13.3...v2.13.4) (2026-03-26)
+
+
+### Bug Fixes
+
+* include template npmrc in npm package like gitignore ([2614557](https://github.com/lirantal/create-node-lib/commit/2614557c961c7414920ce94f20d2388aba075b97))
+* more featuredful devcontainer setup ([2645559](https://github.com/lirantal/create-node-lib/commit/26455598878ba76d6420bcbead552465a13f6179))
+
 ## [2.13.3](https://github.com/lirantal/create-node-lib/compare/v2.13.2...v2.13.3) (2026-03-26)
 
 

package/__tests__/generator.test.js

@@ -26,6 +26,7 @@ describe('all the template files are accountable for', () => {
     )
 
     expect(stream.fileList).toContain('.gitignore')
+    expect(stream.fileList).toContain('.npmrc')
     expect(stream.fileList).toContain('.prettierignore')
     expect(stream.fileList).toContain('.prettierrc.json')
     expect(stream.fileList).toContain('.github/workflows/ci.yml')
@@ -33,6 +34,7 @@ describe('all the template files are accountable for', () => {
     expect(stream.fileList).toContain('README.md')
     expect(stream.fileList).toContain('__tests__/app.test.ts')
     expect(stream.fileList).toContain('package.json')
+    expect(stream.fileList).toContain('apm.yml')
   })
 
   test('Generator input creates a valid package.json file', async () => {
@@ -62,6 +64,11 @@ describe('all the template files are accountable for', () => {
     )
 
     const pkg = JSON.parse(await stream.readFile('package.json'))
+    const apmYaml = await stream.readFile('apm.yml')
+    expect(apmYaml).toContain(`name: "${mockProjectName}"`)
+    expect(apmYaml).toContain(`description: "${mockProjectDescription}"`)
+    expect(apmYaml).toContain(`author: "${mockProjectAuthor}"`)
+
     expect(pkg.name).toBe(mockProjectName)
     expect(pkg.description).toBe(mockProjectDescription)
     expect(pkg.author.name).toBe(mockProjectAuthor)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-node-lib",
-  "version": "2.13.3",
+  "version": "2.14.0",
   "description": "Scaffolding out a Node.js library module",
   "bin": "./bin/cli.js",
   "engines": {

package/saofile.js

@@ -112,7 +112,8 @@ module.exports = {
       {
         type: 'move',
         patterns: {
-          gitignore: '.gitignore'
+          gitignore: '.gitignore',
+          npmrc: '.npmrc'
         }
       }
     ]

package/template/.devcontainer/README.md

@@ -0,0 +1,56 @@
+# Dev container
+
+Run this project in a **consistent Node.js 24 + TypeScript** environment without installing toolchains on your machine. Dependencies install automatically; your repo is the workspace inside the container.
+
+## Why use it?
+
+- **Same stack for everyone** — Node 24, pnpm, and tooling match CI and collaborators.
+- **Fast onboarding** — Open the folder in a container; `pnpm install` and local git tweaks run once after create.
+- **Host secrets, container dev** — `ANTHROPIC_API_KEY` and `SNYK_TOKEN` are passed from your Mac/Linux session into the container when set locally (see below).
+- **Optional CLI workflow** — Use `start.sh` if you prefer a terminal-driven container instead of only the editor.
+
+## What’s here
+
+| File | Role |
+|------|------|
+| `devcontainer.json` | Image, mounts (e.g. your `~/.gitconfig`), lifecycle commands, env forwarding. |
+| `post-create.sh` | Runs once after the container is created — e.g. installs [APM](https://github.com/microsoft/apm) (Agent Package Manager) for agent-related tooling. |
+| `start.sh` | Brings the dev container up with the Dev Containers CLI, then opens a shell **inside** the container. |
+
+## Usage
+
+### Editor (recommended)
+
+1. Install the **Dev Containers** extension (VS Code) or use Cursor’s dev container support.
+2. **Command Palette** → *Dev Containers: Reopen in Container* (or *Rebuild Container* after config changes).
+3. Wait for create/start; the editor attaches when ready. `pnpm run dev` runs on each start when `package.json` exists.
+
+### Terminal only
+
+From the **repository root** on your host:
+
+```bash
+bash .devcontainer/start.sh
+```
+
+Requires Docker running. Uses `npx @devcontainers/cli` to `up` the workspace, then `exec` into `bash`.
+
+## Environment variables (host → container)
+
+Set these **on your machine** before opening/rebuilding the container so they appear inside:
+
+```bash
+export ANTHROPIC_API_KEY=sk-...
+export SNYK_TOKEN=...
+```
+
+They are wired in `devcontainer.json` under `containerEnv` via `localEnv`.
+
+## Optional customization
+
+- **Agent config on the host** — Uncomment the `mounts` entries in `devcontainer.json` to bind `~/.claude`, `~/.gemini`, or `~/.codex` into the container so coding agents see your existing settings.
+- **1Password / other CLIs** — Follow the commented blocks in `devcontainer.json` and `post-create.sh` if you need them; keep the image lean by default.
+
+---
+
+After scaffolding, edit paths and secrets to match your team’s policies; this folder is yours to extend.

package/template/.devcontainer/devcontainer.json

@@ -11,7 +11,11 @@
         }
     },
     "mounts": [
-        "source=${localEnv:HOME}/.gitconfig,target=/home/node/.gitconfig,type=bind,consistency=cached"
+        "source=${localEnv:HOME}/.gitconfig,target=/home/node/.gitconfig,type=bind,consistency=cached",
+        // mount host user home directories for agents:
+        // "source=${localEnv:HOME}/.claude,target=/home/node/.claude,type=bind,consistency=cached",
+        // "source=${localEnv:HOME}/.gemini,target=/home/node/.claude,type=bind,consistency=cached",
+        // "source=${localEnv:HOME}/.codex,target=/home/node/.codex,type=bind,consistency=cached"
     ],
     // Initialize access to 1Password CLI in the container
 	// "initializeCommand": "echo OP_SERVICE_ACCOUNT_TOKEN=$(op read 'op://Private/1Password op CLI Service Account for DevContainers/password') > .env.development",
@@ -22,16 +26,18 @@
     // --
     "postCreateCommand": {
         "git-setup": "git config --local commit.gpgsign false; git config --local core.pager \"less -R\";",
-        "pnpm-install": "pnpm install --force",
+        "pnpm-install": "[ -f package.json ] && pnpm install || true",
         "post-create": "bash .devcontainer/post-create.sh"
     },
     "postStartCommand": {
-        // "rm-env-file": "rm -f ./.env.development",
-        "start-dev": "pnpm run dev"
+        // "rm-env-file": "if [ -n './.env.development' ]; then rm -f './.env.development'; fi;",
+        "start-dev": "[ -f package.json ] && pnpm run dev || true"
     },
     "remoteUser": "node",
     "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
     "containerEnv": {
-        "NODE_ENV": "development"
+        "NODE_ENV": "development",
+        "ANTHROPIC_API_KEY": "${localEnv:ANTHROPIC_API_KEY}",
+        "SNYK_TOKEN": "${localEnv:SNYK_TOKEN}"
     }
 }

package/template/.devcontainer/post-create.sh

@@ -1,6 +1,9 @@
 #!/bin/bash
 set -e
 
+# install apm (the Agent Package Manager: https://github.com/microsoft/apm)
+curl -sSL https://aka.ms/apm-unix | sh
+
 # Install OpenCode CLI
 # curl -fsSL https://opencode.ai/install | bash
 

package/template/.devcontainer/start.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+set -e
+
+WORKSPACE_FOLDER="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+echo "Starting devcontainer for: $WORKSPACE_FOLDER"
+npx --yes @devcontainers/cli@0.84.1 up --workspace-folder "$WORKSPACE_FOLDER"
+
+echo "Dropping into container shell..."
+npx --yes @devcontainers/cli@0.84.1 exec --workspace-folder "$WORKSPACE_FOLDER" bash

package/template/apm.yml

@@ -0,0 +1,9 @@
+name: "<%= projectName %>"
+version: 1.0.0
+description: "<%= description %>"
+author: "<%= author %>"
+dependencies:
+  apm:
+    - lirantal/nodejs-cli-apps-best-practices/skills/nodejs-cli-best-practices
+  mcp: []
+scripts: {}

package/template/npmrc

@@ -0,0 +1,3 @@
+ignore-scripts=true
+allow-git=none
+min-release-age=30 # 30 days