@vsem/ai 0.1.0 → 0.1.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 (3) hide show
  1. package/README.md +25 -0
  2. package/bin/cli.js +6 -2
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -26,3 +26,28 @@ npx @vsem/ai@latest [target-dir] [--branch <name>] [--force]
26
26
  Rerun `npx @vsem/ai@latest` (without `--force`) inside an already-bootstrapped
27
27
  workspace to pick up new roles or rule changes published in later versions — your
28
28
  `project.md`, `plan.md`, and tasks are left untouched.
29
+
30
+ ## Releasing (CI/CD)
31
+
32
+ - `.github/workflows/ci.yml` — runs on every push/PR to `main`: validates
33
+ `package.json`, dry-run `npm pack`, and a smoke test of `bin/cli.js` against a
34
+ scratch directory.
35
+ - `.github/workflows/release.yml` — on a pushed tag matching `v*.*.*`, calls the
36
+ reusable workflow in [vsem-org/.github](https://github.com/vsem-org/.github)
37
+ to run `npm publish` via **npm Trusted Publishing (OIDC)** — no long-lived
38
+ `NPM_TOKEN` secret involved. Configured once on npmjs.com (package Settings ->
39
+ Trusted Publisher -> GitHub Actions):
40
+ - Organization or user: `vsem-org`
41
+ - Repository: `-core--ai`
42
+ - Workflow filename: `release.yml` (the *calling* workflow, not the reusable
43
+ one in `vsem-org/.github` — npm validates the caller)
44
+ - Allowed actions: direct `npm publish` enabled
45
+
46
+ To ship a new version:
47
+
48
+ ```bash
49
+ npm version patch # or minor / major - bumps package.json, commits, tags
50
+ git push --follow-tags
51
+ ```
52
+
53
+ CI publishes automatically once the tag lands.
package/bin/cli.js CHANGED
@@ -167,8 +167,12 @@ function main() {
167
167
 
168
168
  if (!noChanges) {
169
169
  const msg = isRerun ? 'chore: sync vsem-framework system files' : 'chore: bootstrap vsem-framework workspace';
170
- tryGit(['commit', '-q', '-m', msg], target);
171
- console.log(`[ok] commit created: ${msg}`);
170
+ const commitResult = tryGit(['commit', '-q', '-m', msg], target);
171
+ if (commitResult.ok) {
172
+ console.log(`[ok] commit created: ${msg}`);
173
+ } else {
174
+ console.log('[warn] git commit failed (is git config user.name/user.email set?) - changes are staged but not committed.');
175
+ }
172
176
  } else {
173
177
  console.log('[skip] nothing to commit (already up to date)');
174
178
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vsem/ai",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Install or sync a vsem-framework workspace (.ai/ structure, roles, rules) via npx.",
5
5
  "bin": {
6
6
  "vsem-ai": "bin/cli.js"