@doki-land/nifty-skills 0.0.11 โ†’ 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@doki-land/nifty-skills",
3
- "version": "0.0.11",
3
+ "version": "0.1.0",
4
4
  "description": "Agent Skills for Nifty gitmoji commits, npm release, and git history tooling",
5
5
  "type": "module",
6
6
  "license": "MPL-2.0",
@@ -24,10 +24,10 @@
24
24
  "typecheck": "node -e \"console.log('docs-only skill package')\""
25
25
  },
26
26
  "optionalDependencies": {
27
- "@doki-land/nifty-win32-x64": "0.0.11",
28
- "@doki-land/nifty-linux-x64": "0.0.11",
29
- "@doki-land/nifty-linux-arm64": "0.0.11",
30
- "@doki-land/nifty-darwin-arm64": "0.0.11",
31
- "@doki-land/nifty-darwin-x64": "0.0.11"
27
+ "@doki-land/nifty-win32-x64": "0.1.0",
28
+ "@doki-land/nifty-linux-x64": "0.1.0",
29
+ "@doki-land/nifty-linux-arm64": "0.1.0",
30
+ "@doki-land/nifty-darwin-arm64": "0.1.0",
31
+ "@doki-land/nifty-darwin-x64": "0.1.0"
32
32
  }
33
33
  }
@@ -14,7 +14,7 @@ workspaces. Native git work uses **gix** (Rust). Changelog tag ranges use the `g
14
14
  ## Before you act
15
15
 
16
16
  1. Confirm `@doki-land/nifty` is installed (`nifty --help`) or use `pnpm exec nifty` in the npm-tools repo.
17
- 2. Look for `nifty.config.ts` at the project root (`defineConfig`, `authorMap` path to `author-github.json`, `publish.packages`, `changelog.*`).
17
+ 2. Look for `nifty.config.ts` at the project root (`defineConfig`, `authorMap`, `trust.npm`, optional `publish.packages`, `changelog.*`).
18
18
  3. Load a focused sub-skill when the task is narrow (see table below).
19
19
 
20
20
  ## Sub-skills
@@ -37,7 +37,7 @@ workspaces. Native git work uses **gix** (Rust). Changelog tag ranges use the `g
37
37
  | `nifty publish --placeholder` | Publish never-published workspace packages as `0.0.0` |
38
38
  | `nifty trust` | Configure npm Trusted Publisher |
39
39
  | `nifty update` | Bump Cargo and npm dependencies |
40
- | `nifty format` | Format Rust via `cargo fmt` and JS/TS/JSON via `oxc_formatter` |
40
+ | `nifty format` | Format Rust via `cargo fmt` and JS/TS through Oak |
41
41
  | `nifty upload` | GitHub Release assets or GitHub Pages |
42
42
  | `nifty install-native` | Stage CI `.node` artifacts into platform packages |
43
43
  | `nifty retime` | Spread timestamps on a new branch |
@@ -18,9 +18,11 @@ Every commit **subject** (first line) must:
18
18
  Known gitmojis (Nifty default set):
19
19
 
20
20
  ```text
21
- โœจ ๐ŸŽจ ๐Ÿš€ ๐Ÿ› ๐Ÿš‘ ๐Ÿ”ฅ ๐Ÿ’ฅ โ™ป๏ธ ๐Ÿ”ง ๐Ÿ“ ๐Ÿ‘ท ๐Ÿงน โฌ†๏ธ ๐Ÿงช ๐Ÿ”จ ๐Ÿ“ฆ
21
+ โœจ ๐ŸŽจ ๐Ÿš€ ๐Ÿ› ๐Ÿš‘ ๐Ÿ”ฅ ๐Ÿ’ฅ โ™ป๏ธ ๐Ÿ”ง ๐Ÿ“ ๐Ÿ‘ท ๐Ÿงน โฌ†๏ธ ๐Ÿงช ๐Ÿ”จ ๐Ÿ“ฆ ๐Ÿ“Œ
22
22
  ```
23
23
 
24
+ `๐Ÿ“Œ` is for dependency or version pins (for example locking a site to a published npm version).
25
+
24
26
  ## Commands
25
27
 
26
28
  ```bash
@@ -19,13 +19,18 @@ export default {
19
19
  releasesDir: "documentation/maintenance/releases",
20
20
  repo: "owner/name",
21
21
  },
22
- publish: {
23
- packages: ["@scope/app", "@scope/app-native"],
22
+ trust: {
23
+ npm: {
24
+ repo: "owner/name",
25
+ file: "publish-npm.yml",
26
+ environment: "NPM_PUBLISH",
27
+ },
24
28
  },
25
29
  };
26
30
  ```
27
31
 
28
- `publish.packages` lists every package name for **`nifty trust`**, including registry-only native sidecars.
32
+ `trust.npm` pins the GitHub Actions Trusted Publisher target for **`nifty trust`** (prefer over `NIFTY_TRUST_*` env vars).
33
+ Omit `publish.packages` unless you need a **narrow subset** โ€” default is every workspace package that is not `private: true`.
29
34
 
30
35
  ## Version bump
31
36
 
@@ -54,9 +59,11 @@ nifty trust
54
59
 
55
60
  **`--placeholder`**: for each publishable workspace package with **no version on the registry**, publish
56
61
  workspace contents as **`0.0.0`** (claim the name / prep Trusted Publisher). Packages that already exist on
57
- npm are skipped. Default set is non-private workspace packages. With `publish.packages` in `nifty.config.ts`
58
- (or `--package`), **private** workspace packages may be included โ€” `private` is stripped on publish (same as
59
- `publishConfig.name` rename). Prefer this over per-repo `publish-placeholder.mjs`. Then run **`nifty trust`**.
62
+ npm are skipped. Publishable means `private` is **not** set (or `false`) in `package.json`; dependents with a
63
+ required dependency on a private workspace package are skipped too. Remove `private` from packages you intend to
64
+ ship โ€” do not use `publish.packages` to override `private`. Optional `publish.packages` / `--package` only
65
+ **narrows** the non-private set. Prefer `nifty publish --placeholder` over per-repo placeholder scripts. Then run
66
+ **`nifty trust`**.
60
67
 
61
68
  Optional subset (new package only, or retry one failure):
62
69
 
@@ -66,11 +73,11 @@ nifty trust --only @doki-land/nifty-skills
66
73
  ```
67
74
 
68
75
  **First publish of a new package name** (e.g. `@doki-land/nifty-skills`): run **`nifty trust`** after `nifty publish` so
69
- GitHub Actions OIDC can publish on the next tag. `nifty trust` uses `publish.packages` from `nifty.config.ts` when set,
70
- otherwise all non-private workspace packages.
76
+ GitHub Actions OIDC can publish on the next tag. `nifty trust` uses `publish.packages` from `nifty.config.ts` when set
77
+ (subset only โ€” still respects `private`), otherwise all publishable workspace packages.
71
78
 
72
- Local auth: `NPM_TOKEN`, `--npm-token`, `--otp`, or `--totp-secret` (see `nifty publish --help`). Trust live
73
- configuration requires OTP/TOTP.
79
+ Local auth: `NPM_TOKEN`, `--npm-token`, `--otp`, or `--totp-secret` (see `nifty publish --help`). Trust uses the
80
+ registry API with bearer token from `NPM_TOKEN` or `~/.npmrc`. Add OTP/TOTP on 2FA accounts when the registry asks.
74
81
 
75
82
  **npm-tools CI**: tag `vX.Y.Z` triggers `.github/workflows/publish-npm.yml` โ†’ `scripts/ci/publish-npm.mjs` (OIDC, no
76
83
  long-lived token in YAML). Native `.node` files ship as `@doki-land/nifty-*` optional packages, not GitHub Release