@manhquy/flow-skill 0.2.0 → 0.2.1

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.
Files changed (4) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +17 -19
  3. package/package.json +1 -1
  4. package/skills-manifest.json +1 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,26 @@
2
2
 
3
3
  All notable changes to `@manhquy/flow-skill`. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [SemVer](https://semver.org/).
4
4
 
5
+ ## [0.2.1] — 2026-08-01 — docs sync (`@latest` canonical, `rc` retired)
6
+
7
+ Docs-only installer release. **No CLI, detection, lock, or target change** vs 0.2.0 — same
8
+ tarball behavior; this exists so npmjs.com renders the corrected README.
9
+
10
+ ### Changed
11
+ - Canonical install command is now **`npx @manhquy/flow-skill@latest`** everywhere. Bare
12
+ `npx @manhquy/flow-skill` can re-run a stale npx cache; `@latest` forces the newest release.
13
+ - Dropped the `@rc` channel from user-facing docs. The `rc` dist-tag had drifted to
14
+ `0.1.0-rc.3` (behind `latest`), so following `@rc` silently downgraded users. `rc` is
15
+ retired on the registry (`npm dist-tag rm @manhquy/flow-skill rc`); use `@next` for any
16
+ future pre-release.
17
+ - Clarified that `npm i` never installs the skill — the CLI must be **run**.
18
+
19
+ ## [0.2.0] — 2026-07-27 — ships skill v0.25.0
20
+
21
+ Skill-content release; **installer code unchanged** vs 0.1.0. Ships skill product **v0.25.0**
22
+ (graph executor, opt-in and dark until `FLOW_GRAPH_EXECUTOR=1`; see root `CHANGELOG.md`
23
+ `## 0.25.0`). Publishes to dist-tag `latest`.
24
+
5
25
  ## [0.1.0] — 2026-07-19 — GA (first stable, `latest`)
6
26
 
7
27
  First stable release of the installer. Graduates the rc.1→rc.3 line after two live OIDC
package/README.md CHANGED
@@ -10,44 +10,42 @@ One-command installer that copies the [flow](https://github.com/manhquydev/flow-
10
10
  ## Install
11
11
 
12
12
  ```
13
- # Stable (latest) — current: v0.1.0, ships skill v0.24.0
14
- npx @manhquy/flow-skill
15
-
16
- # Pre-release channel (opt-in)
17
- npx @manhquy/flow-skill@rc
13
+ # Newest GA — current: v0.2.1, ships skill v0.25.0
14
+ npx @manhquy/flow-skill@latest
18
15
  ```
19
16
 
20
17
  An interactive prompt asks which agents to install to. Pick one or more, confirm, done.
21
18
 
22
- > **Stable is on `latest`**: bare `npx @manhquy/flow-skill` (or `@0.1.x`) resolves the GA release.
23
- > Pin `@rc` only if you want the pre-release channel. See [SECURITY.md](./SECURITY.md).
19
+ > **Always use `@latest`.** npx caches by bare name, so a plain `npx @manhquy/flow-skill` can
20
+ > re-run a stale cached copy; `@latest` forces npx to fetch the newest GA release. See
21
+ > [SECURITY.md](./SECURITY.md).
24
22
  >
25
23
  > **`npm i` alone is not enough.** `npm install @manhquy/flow-skill` only adds the installer
26
- > package to `node_modules`. You must **run** it (`npx @manhquy/flow-skill` or
24
+ > package to `node_modules`. You must **run** it (`npx @manhquy/flow-skill@latest` or
27
25
  > `npx flow-skill` after install) to copy the skill into agent homes.
28
26
  >
29
- > **Two version axes:** package `version` in this folder is the **installer** (e.g. `0.1.0`).
30
- > Skill product version lives in `skills/flow/SKILL.md` (`metadata.version`, e.g. `0.24.0`).
27
+ > **Two version axes:** package `version` in this folder is the **installer** (e.g. `0.2.1`).
28
+ > Skill product version lives in `skills/flow/SKILL.md` (`metadata.version`, e.g. `0.25.0`).
31
29
  > `--help` and the JSONL `plan` event expose both (`version` + `skillVersion`).
32
30
 
33
31
  ## Non-interactive
34
32
 
35
33
  ```
36
34
  # Default selection (Claude + anything detected)
37
- npx @manhquy/flow-skill@rc --yes
35
+ npx @manhquy/flow-skill@latest --yes
38
36
 
39
37
  # Explicit targets
40
- npx @manhquy/flow-skill@rc --yes -t claude -t codex
41
- npx @manhquy/flow-skill@rc --yes -t claude,codex # comma form OK
38
+ npx @manhquy/flow-skill@latest --yes -t claude -t codex
39
+ npx @manhquy/flow-skill@latest --yes -t claude,codex # comma form OK
42
40
 
43
41
  # Force all five targets even if not detected
44
- npx @manhquy/flow-skill@rc --yes --all
42
+ npx @manhquy/flow-skill@latest --yes --all
45
43
 
46
44
  # Project scope (Claude only — see below)
47
- npx @manhquy/flow-skill@rc --yes --project --dir .
45
+ npx @manhquy/flow-skill@latest --yes --project --dir .
48
46
 
49
47
  # CI-friendly JSONL output
50
- npx @manhquy/flow-skill@rc --yes --all --dry-run --json
48
+ npx @manhquy/flow-skill@latest --yes --all --dry-run --json
51
49
  ```
52
50
 
53
51
  ## Targets
@@ -97,8 +95,8 @@ rm -rf <project>/.claude/skills/flow
97
95
 
98
96
  - **Windows `EBUSY` / `EPERM` mid-install**: an agent (Claude Code, Codex, Antigravity IDE) is holding a file inside the destination. Close the agent and re-run. The installer already retries with 100/300/900 ms backoff before surfacing the error.
99
97
  - **Stale advisory lock**: a prior run crashed. The next run detects the dead PID and reclaims the lock automatically. If it does not (very rare — the recorded PID was recycled by another live process), delete `<parent-of-dest>/.flow-skill.installing.lock`.
100
- - **`No matching version found` on `@0.24.0`**: that is the **skill product** version, not the npm package version. Install the installer by its own version (bare / `@0.1.x` / `@rc`) — skill content version is printed by `--help` as `ships skill v…`.
101
- - **Installed package but agent has no `/flow`**: `npm i` does not run the installer. Run `npx @manhquy/flow-skill@rc` (or `npx flow-skill` if already installed) and restart the agent.
98
+ - **`No matching version found` on `@0.25.0`**: that is the **skill product** version, not the npm package version. Install the installer by its own version (`@latest` / `@0.2.x`) — skill content version is printed by `--help` as `ships skill v…`.
99
+ - **Installed package but agent has no `/flow`**: `npm i` does not run the installer. Run `npx @manhquy/flow-skill@latest` (or `npx flow-skill` if already installed) and restart the agent.
102
100
  - **Node too old** (`requires Node.js >=22.14.0`): upgrade with your preferred version manager (`nvm install 22`, `fnm install 22`, or Node's official installer). Node 20 reached end-of-life April 2026; npm OIDC Trusted Publishing needs npm >=11.5.1 which bundles with Node 22.14+.
103
101
 
104
102
  ## JSONL contract
@@ -106,7 +104,7 @@ rm -rf <project>/.claude/skills/flow
106
104
  `--json` streams one JSON object per line:
107
105
 
108
106
  ```jsonl
109
- {"event":"plan","version":"0.1.0","skillVersion":"0.24.0","dryRun":false,"scope":"global","targets":["claude","codex"]}
107
+ {"event":"plan","version":"0.2.1","skillVersion":"0.25.0","dryRun":false,"scope":"global","targets":["claude","codex"]}
110
108
  {"event":"install:start","target":"claude","dests":["~/.claude/skills/flow"]}
111
109
  {"event":"install:done","target":"claude","dests":["~/.claude/skills/flow"],"result":"success","error":null,"warnings":[]}
112
110
  {"event":"summary","success":true,"total":2,"attempted":2,"installed":2,"failed":0,"skipped":0,"aborted":false}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@manhquy/flow-skill",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Install the flow skill (buildflow gated build process) into your coding agent(s) via one npx command",
5
5
  "type": "module",
6
6
  "bin": {
package/skills-manifest.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "source": "../skills/flow",
3
3
  "destRelative": "skills/flow",
4
4
  "fileCount": 82,
5
- "syncedAt": "2026-07-27T03:21:41.774Z",
5
+ "syncedAt": "2026-08-01T04:31:11.471Z",
6
6
  "fileList": [
7
7
  "SKILL.md",
8
8
  "_templates/00-idea.md",