@launch11/srgical 0.0.1 → 0.0.2
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/README.md +4 -6
- package/docs/distribution.md +16 -14
- package/docs/product-foundation.md +1 -1
- package/package.json +4 -12
package/README.md
CHANGED
|
@@ -79,16 +79,14 @@ npm run release:pack
|
|
|
79
79
|
The release bundle lands under `.artifacts/release/`. The broader distribution path, including standalone binaries and
|
|
80
80
|
wrapper package-manager installs, is documented in `docs/distribution.md`.
|
|
81
81
|
|
|
82
|
-
For release work, add a changeset in your feature branch:
|
|
83
|
-
|
|
84
|
-
```bash
|
|
85
|
-
npm run changeset
|
|
86
|
-
```
|
|
87
|
-
|
|
88
82
|
When that branch reaches `main`, the release workflow versions the package, publishes `@launcheleven/srgical` to
|
|
89
83
|
GitHub Packages, publishes `@launch11/srgical` to npm, and opens a matching GitHub Release entry with the packaged
|
|
90
84
|
artifacts.
|
|
91
85
|
|
|
86
|
+
The repo keeps a base version line in `package.json` and CI computes the next patch version from matching git tags. For
|
|
87
|
+
example, a base version of `0.0.0` means releases flow as `0.0.1`, `0.0.2`, and so on. To move to a new minor line,
|
|
88
|
+
change the base version to something like `0.1.0`.
|
|
89
|
+
|
|
92
90
|
## Install Prerequisites
|
|
93
91
|
|
|
94
92
|
Install `srgical`, then install at least one supported local agent CLI separately.
|
package/docs/distribution.md
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
## Current Production Channel
|
|
4
4
|
|
|
5
5
|
The current production release channels are GitHub Packages for npm, the public npm registry, and GitHub Releases.
|
|
6
|
-
Versioning is
|
|
7
|
-
|
|
6
|
+
Versioning is tag-driven from git history, which means the repo carries a base major/minor line and CI computes the
|
|
7
|
+
next patch version during release instead of committing a version bump back to `main`.
|
|
8
8
|
|
|
9
9
|
The npm package does not bundle `codex` or `claude`. Users still need at least one supported local agent CLI installed
|
|
10
10
|
separately and available on `PATH`, and `srgical doctor` remains the truthful way to confirm which agents are usable on
|
|
@@ -12,17 +12,18 @@ the current machine.
|
|
|
12
12
|
|
|
13
13
|
## Release Flow
|
|
14
14
|
|
|
15
|
-
1.
|
|
16
|
-
2. When
|
|
17
|
-
3.
|
|
18
|
-
|
|
19
|
-
4. The
|
|
20
|
-
5. The workflow
|
|
21
|
-
|
|
22
|
-
|
|
15
|
+
1. `package.json` stores the release line, such as `0.0.0` or `0.1.0`.
|
|
16
|
+
2. When a commit lands on `main`, the release workflow runs `npm ci` and `npm test`.
|
|
17
|
+
3. CI reads the base version, looks for existing `v<major>.<minor>.*` tags, and computes the next patch version for
|
|
18
|
+
the current untagged commit.
|
|
19
|
+
4. The workflow stages that computed version into temporary package copies without mutating the committed repo files.
|
|
20
|
+
5. The same workflow publishes `@launcheleven/srgical` to GitHub Packages and `@launch11/srgical` to the public npm
|
|
21
|
+
registry.
|
|
22
|
+
6. After both publishes succeed, the workflow creates a `v<version>` tag and a GitHub Release with the packaged
|
|
23
|
+
artifacts attached.
|
|
23
24
|
|
|
24
|
-
This keeps the published semver repeatable
|
|
25
|
-
|
|
25
|
+
This keeps the published semver repeatable for a given commit, avoids commit-noise from release-only version bumps, and
|
|
26
|
+
still gives each published package a unique version that both registries can accept.
|
|
26
27
|
|
|
27
28
|
## Local Release Check
|
|
28
29
|
|
|
@@ -36,8 +37,9 @@ That command:
|
|
|
36
37
|
|
|
37
38
|
- builds the TypeScript CLI,
|
|
38
39
|
- runs `node dist/index.js doctor`,
|
|
39
|
-
-
|
|
40
|
-
-
|
|
40
|
+
- computes the next release version from git tags,
|
|
41
|
+
- creates GitHub Packages and npm tarballs under `.artifacts/release/`,
|
|
42
|
+
- writes `release-manifest.json` and `release-manifest.md` with the artifact paths and SHA256 hashes.
|
|
41
43
|
|
|
42
44
|
## Registry Configuration
|
|
43
45
|
|
|
@@ -45,6 +45,6 @@ time.
|
|
|
45
45
|
## Distribution Strategy
|
|
46
46
|
|
|
47
47
|
- Native packages: GitHub Packages as `@launcheleven/srgical` and npm public as `@launch11/srgical`
|
|
48
|
-
- Versioning model: semver via
|
|
48
|
+
- Versioning model: semver via git tags on GitHub Actions, with `package.json` carrying the base major/minor line
|
|
49
49
|
- Release artifacts: standalone binaries for Windows, macOS, and Linux
|
|
50
50
|
- Package-manager wrappers: `brew`, `choco`, and other ecosystems can install those release artifacts
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@launch11/srgical",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.2",
|
|
4
4
|
"description": "A polished local-first CLI for planning and executing long AI-driven delivery sequences.",
|
|
5
5
|
"files": [
|
|
6
6
|
"dist",
|
|
@@ -13,18 +13,11 @@
|
|
|
13
13
|
},
|
|
14
14
|
"scripts": {
|
|
15
15
|
"build": "tsc -p tsconfig.json",
|
|
16
|
-
"changeset": "changeset",
|
|
17
16
|
"dev": "tsx src/index.ts",
|
|
18
|
-
"release": "npm run release:pack && npm run publish:github && npm run publish:npm",
|
|
19
17
|
"start": "node dist/index.js",
|
|
20
18
|
"doctor": "tsx src/index.ts doctor",
|
|
21
19
|
"test": "tsx --test test/**/*.test.ts",
|
|
22
|
-
"test:coverage": "tsx --test --experimental-test-coverage test/**/*.test.ts"
|
|
23
|
-
"version-packages": "changeset version",
|
|
24
|
-
"release:pack": "node scripts/release-pack.mjs",
|
|
25
|
-
"publish:github": "changeset publish",
|
|
26
|
-
"publish:npm": "node scripts/publish-npm.mjs",
|
|
27
|
-
"release:version": "node scripts/read-package-version.mjs"
|
|
20
|
+
"test:coverage": "tsx --test --experimental-test-coverage test/**/*.test.ts"
|
|
28
21
|
},
|
|
29
22
|
"engines": {
|
|
30
23
|
"node": ">=20"
|
|
@@ -38,8 +31,8 @@
|
|
|
38
31
|
"url": "https://github.com/LaunchEleven/Srgical/issues"
|
|
39
32
|
},
|
|
40
33
|
"publishConfig": {
|
|
41
|
-
"
|
|
42
|
-
"
|
|
34
|
+
"registry": "https://registry.npmjs.org/",
|
|
35
|
+
"access": "public"
|
|
43
36
|
},
|
|
44
37
|
"keywords": [
|
|
45
38
|
"ai",
|
|
@@ -55,7 +48,6 @@
|
|
|
55
48
|
"commander": "^14.0.3"
|
|
56
49
|
},
|
|
57
50
|
"devDependencies": {
|
|
58
|
-
"@changesets/cli": "^2.30.0",
|
|
59
51
|
"@types/blessed": "^0.1.27",
|
|
60
52
|
"@types/node": "^25.5.0",
|
|
61
53
|
"tsx": "^4.21.0",
|