bigpowers 2.86.2 → 2.86.3
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/.agents/skills/wire-ci/SKILL.md +78 -59
- package/.codebuddy/skills/wire-ci/SKILL.md +78 -59
- package/.codex/skills/wire-ci/SKILL.md +78 -59
- package/.hermes/skills/wire-ci/SKILL.md +78 -59
- package/.kilocode/rules/wire-ci.md +78 -59
- package/.mimocode/skills/wire-ci/SKILL.md +78 -59
- package/.pi/package.json +1 -1
- package/.pi/prompts/wire-ci.md +78 -59
- package/.pi/skills/wire-ci/SKILL.md +78 -59
- package/.trae/skills/wire-ci/SKILL.md +78 -59
- package/.windsurf/rules/wire-ci.md +78 -59
- package/.zcode/skills/wire-ci/SKILL.md +78 -59
- package/CHANGELOG.md +14 -0
- package/SKILL-INDEX.md +1 -1
- package/package.json +1 -1
- package/scripts/lib/__pycache__/link_utils.cpython-312.pyc +0 -0
- package/scripts/lib/__pycache__/srp_engine_links.cpython-312.pyc +0 -0
- package/scripts/lib/context-wire.sh +9 -0
- package/scripts/lib/detect-forge.sh +105 -0
- package/scripts/lib/extract-story-verify.py +102 -0
- package/scripts/lib/fail-open-detect.sh +67 -0
- package/scripts/lib/golden-suite-gates.sh +4 -0
- package/scripts/lib/plan-consistency-check.sh +26 -2
- package/scripts/lib/test-assertions.sh +11 -1
- package/scripts/run-skill-verify.sh +5 -46
- package/scripts/run-story-verify.sh +208 -0
- package/scripts/test-adapters.sh +14 -8
- package/scripts/verify-install.sh +13 -1
- package/scripts/wire-ci.sh +159 -0
- package/skills/wire-ci/REFERENCE.md +15 -4
- package/skills/wire-ci/SKILL.md +63 -55
- package/skills-lock.json +2 -2
|
@@ -1,104 +1,112 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: wire-ci
|
|
3
3
|
model: sonnet
|
|
4
|
-
description: "CI pipeline setup with
|
|
4
|
+
description: "CI pipeline setup with bundled, forge-neutral templates and local validation. Detects the forge from the git remote, generates workflows for supported forges, and skips honestly for the rest. The CI equivalent of wire-observability."
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Wire CI
|
|
8
8
|
|
|
9
|
-
> **HARD GATE** — Do not ship a project without CI. Run this skill before first merge to main
|
|
9
|
+
> **HARD GATE (supported forges only)** — Do not ship a project without CI. Run this skill before first merge to main.
|
|
10
|
+
>
|
|
11
|
+
> On a forge bigpowers ships no templates for, this skill **is not a gate**: it reports the forge, explains what it cannot do, and exits 3. A gate that cannot run must not claim it did. See § Unsupported forges.
|
|
10
12
|
>
|
|
11
13
|
> **HARD GATE** — CI that is untestable locally will break every cycle. Always run `--validate` after generating workflows and `--dry-run` before pushing.
|
|
12
14
|
|
|
13
|
-
Generate, validate, and test CI workflows. Detects
|
|
15
|
+
Generate, validate, and test CI workflows. Detects the forge and project type, copies a **bundled** template, and verifies locally before anything reaches CI.
|
|
14
16
|
|
|
15
|
-
##
|
|
17
|
+
## Forge resolution
|
|
16
18
|
|
|
17
|
-
|
|
18
|
-
2. **Deploy workflow** — `.github/workflows/deploy.yml` triggered via `workflow_run` (BigBase/Pages stacks only; CLI/library repos omit this)
|
|
19
|
-
3. **`--validate` mode** — checks YAML syntax, workflow permissions, required secrets, and common pitfalls
|
|
20
|
-
4. **`--dry-run` mode** — runs workflows locally via `act` or `gh workflow run` to prove correctness before push
|
|
21
|
-
5. **Failure pattern documentation** — common CI failure categories and their fixes
|
|
19
|
+
`scripts/lib/detect-forge.sh` resolves the forge, first match wins: `BIGPOWERS_FORGE` env var → `forge:` in `specs/forge.yaml` → the `origin` remote URL → `unknown`.
|
|
22
20
|
|
|
23
|
-
|
|
21
|
+
```bash
|
|
22
|
+
bash scripts/wire-ci.sh --detect # report forge + stack, write nothing
|
|
23
|
+
bash scripts/wire-ci.sh --plan # show the template that would be used
|
|
24
|
+
bash scripts/wire-ci.sh --apply # write the workflow
|
|
25
|
+
```
|
|
24
26
|
|
|
25
|
-
|
|
27
|
+
GitHub ships templates (`.github/workflows/`). GitLab, Bitbucket, Codeberg, and Gitea are detected but **unsupported** — `--apply` writes nothing and exits 3.
|
|
26
28
|
|
|
27
|
-
|
|
29
|
+
## Template source — configurable, bundled by default
|
|
28
30
|
|
|
29
|
-
|
|
30
|
-
|----------|------|-------------------------------------|
|
|
31
|
-
| `Cargo.toml` | Rust | `test-build-release-monorepo.yml` + `deploy-monorepo.yml` (or monorepo subset) |
|
|
32
|
-
| `package.json` | Node | `test-build-release-node.yml` + `deploy-node.yml` |
|
|
33
|
-
| `setup.py` / `pyproject.toml` | Python | `test-build-release-python.yml` + `deploy-python.yml` |
|
|
34
|
-
| `go.mod` | Go | `test-build-release-go.yml` + `deploy-go.yml` |
|
|
35
|
-
| Static site (no server) | Static | `test-build-release-static.yml` + `deploy-static.yml` |
|
|
36
|
-
| `Package.swift` | Swift | `test-build-release-swift.yml` only (no deploy yet) |
|
|
37
|
-
| Multiple detected | Polyglot | `test-build-release-monorepo.yml` + `deploy-monorepo.yml` |
|
|
31
|
+
Templates live in `docs/templates/ci/<forge>/` **inside the bigpowers package**, so there is no network dependency on any third party's repository. Override with `BIGPOWERS_CI_TEMPLATES=/path/to/your/templates`, laid out as `<root>/<forge>/test-build-release-<stack>.yml`.
|
|
38
32
|
|
|
39
|
-
|
|
33
|
+
## What this sets up
|
|
40
34
|
|
|
41
|
-
|
|
35
|
+
1. **Test Build Release workflow** — lint → test → build → release in one `needs:` chain
|
|
36
|
+
2. **`--validate` mode** — YAML syntax, workflow permissions, required secrets, common pitfalls
|
|
37
|
+
3. **`--dry-run` mode** — runs workflows locally via `act` before push
|
|
38
|
+
4. **Failure pattern documentation** — see the table below
|
|
42
39
|
|
|
43
|
-
|
|
40
|
+
Deploy workflows are **not** bundled: they are platform-specific. See [REFERENCE.md](REFERENCE.md) for a worked example.
|
|
44
41
|
|
|
45
|
-
|
|
42
|
+
## Process
|
|
43
|
+
|
|
44
|
+
### 1. Detect forge and stack
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
bash scripts/wire-ci.sh --detect
|
|
48
|
+
```
|
|
46
49
|
|
|
47
|
-
|
|
50
|
+
Stack detection reads the project root:
|
|
48
51
|
|
|
49
|
-
|
|
52
|
+
| Manifest | Stack | Bundled template |
|
|
53
|
+
|----------|-------|------------------|
|
|
54
|
+
| `Cargo.toml` | Rust | `test-build-release-rust.yml` |
|
|
55
|
+
| `package.json` | Node | `test-build-release-node.yml` |
|
|
56
|
+
| `pyproject.toml` / `setup.py` | Python | `test-build-release-python.yml` |
|
|
57
|
+
| `go.mod` | Go | `test-build-release-go.yml` |
|
|
50
58
|
|
|
51
|
-
|
|
59
|
+
No recognized manifest → exit 3 with the list of manifests it looked for. Do not guess.
|
|
52
60
|
|
|
53
|
-
|
|
61
|
+
### 2. Apply the template
|
|
54
62
|
|
|
55
63
|
```bash
|
|
56
|
-
|
|
64
|
+
bash scripts/wire-ci.sh --apply
|
|
57
65
|
```
|
|
58
66
|
|
|
59
|
-
|
|
67
|
+
**Do not rename the workflow `name:` field** — deploy listens for `"Test Build Release"`.
|
|
60
68
|
|
|
61
|
-
|
|
69
|
+
Edit placeholders after copying: language versions, `APP_TYPE`, `SITE_URL`.
|
|
62
70
|
|
|
63
|
-
###
|
|
71
|
+
### 3. Unsupported forges
|
|
64
72
|
|
|
65
|
-
|
|
73
|
+
`--apply` writes nothing and exits 3. Your options, in the order the runner prints them:
|
|
66
74
|
|
|
67
|
-
|
|
75
|
+
- point `BIGPOWERS_CI_TEMPLATES` at templates for your forge
|
|
76
|
+
- pin `forge: github` in `specs/forge.yaml` if the remote is misdetected
|
|
77
|
+
- write the CI config by hand
|
|
68
78
|
|
|
69
|
-
|
|
70
|
-
- `0` — all checks pass (no errors)
|
|
71
|
-
- `1` — YAML syntax errors found
|
|
72
|
-
- `2` — validation warnings only (missing permissions, secrets, etc.)
|
|
79
|
+
Contributing a `docs/templates/ci/gitlab/` set and adding `gitlab` to `FORGE_SUPPORTED_LIST` is the natural next slice — per-forge command mapping (`gh pr checks` → `glab ci status`) is not implemented yet.
|
|
73
80
|
|
|
74
|
-
###
|
|
81
|
+
### 4. Validate workflows (`--validate`)
|
|
75
82
|
|
|
76
|
-
|
|
83
|
+
See [REFERENCE.md](REFERENCE.md). Exit codes: `0` clean, `1` YAML syntax errors, `2` warnings only.
|
|
84
|
+
|
|
85
|
+
### 5. Dry-run workflows (`--dry-run`)
|
|
77
86
|
|
|
78
|
-
See [REFERENCE.md](REFERENCE.md)
|
|
87
|
+
See [REFERENCE.md](REFERENCE.md).
|
|
79
88
|
|
|
80
89
|
> **act** runs workflows in a local Docker environment — the most accurate pre-push validation.
|
|
81
|
-
> **gh workflow run** sends the workflow to GitHub but
|
|
90
|
+
> **gh workflow run** sends the workflow to GitHub but does not execute locally.
|
|
82
91
|
|
|
83
92
|
### 6. Document common CI failure patterns
|
|
84
93
|
|
|
85
|
-
Add the following to the project's documentation or CLAUDE.md after setup:
|
|
86
|
-
|
|
87
94
|
| Failure | Cause | Fix |
|
|
88
95
|
|---------|-------|-----|
|
|
89
|
-
| `npm publish` fails | `NPM_TOKEN` not set as repo secret | Add `NPM_TOKEN` to
|
|
90
|
-
| `semantic-release` fails on push | Missing `permissions: contents: write` | Add
|
|
91
|
-
| `cargo publish` auth fail | `CARGO_REGISTRY_TOKEN` not set | Add token to `~/.cargo/config.toml`
|
|
92
|
-
| `go vet` fails | Go version mismatch |
|
|
93
|
-
| `cargo clippy` errors | New lints
|
|
94
|
-
| `act` not found | Docker not running or act
|
|
95
|
-
| Hardcoded Node version stale | `.nvmrc` exists but workflow
|
|
96
|
-
| Deploy never runs | TBR workflow renamed | Keep `name: Test Build Release`
|
|
97
|
-
| Release rebuilds binary | Artifact not downloaded | `release`
|
|
96
|
+
| `npm publish` fails | `NPM_TOKEN` not set as repo secret | Add `NPM_TOKEN` to repo secrets |
|
|
97
|
+
| `semantic-release` fails on push | Missing `permissions: contents: write` | Add it to the release job |
|
|
98
|
+
| `cargo publish` auth fail | `CARGO_REGISTRY_TOKEN` not set | Add token to env or `~/.cargo/config.toml` |
|
|
99
|
+
| `go vet` fails | Go version mismatch | Use `go-version-file: go.mod` |
|
|
100
|
+
| `cargo clippy` errors | New nightly lints | Pin the toolchain; `cargo clippy --fix` |
|
|
101
|
+
| `act` not found | Docker not running or act missing | `brew install act`; `docker ps` |
|
|
102
|
+
| Hardcoded Node version stale | `.nvmrc` exists but workflow hardcodes | Use `node-version-file: .nvmrc` |
|
|
103
|
+
| Deploy never runs | TBR workflow renamed | Keep `name: Test Build Release` |
|
|
104
|
+
| Release rebuilds binary | Artifact not downloaded | `release` must `download-artifact` from `build` |
|
|
98
105
|
|
|
99
106
|
## Verify
|
|
100
107
|
|
|
101
|
-
→ verify: `
|
|
108
|
+
→ verify: `bash scripts/wire-ci.sh --self-test`
|
|
109
|
+
→ verify: `test -f docs/templates/ci/github/test-build-release-node.yml && test -f scripts/lib/detect-forge.sh`
|
|
102
110
|
→ verify: `grep -q wire-ci SKILL-INDEX.md`
|
|
103
111
|
|
|
104
112
|
---
|
|
@@ -121,19 +129,26 @@ Add the following to the project's documentation or CLAUDE.md after setup:
|
|
|
121
129
|
### Create CI for a Go project (TBR + optional deploy)
|
|
122
130
|
|
|
123
131
|
```bash
|
|
124
|
-
#
|
|
125
|
-
|
|
126
|
-
|
|
132
|
+
# Resolve forge + stack, then apply the bundled template
|
|
133
|
+
bash scripts/wire-ci.sh --detect
|
|
134
|
+
bash scripts/wire-ci.sh --apply
|
|
127
135
|
|
|
128
136
|
wire-ci --validate
|
|
129
137
|
wire-ci --dry-run
|
|
130
138
|
```
|
|
131
139
|
|
|
140
|
+
To use your own org templates instead of the bundled ones:
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
BIGPOWERS_CI_TEMPLATES=/path/to/your/templates bash scripts/wire-ci.sh --apply
|
|
144
|
+
```
|
|
145
|
+
|
|
132
146
|
### Create CI for a CLI tool (TBR only, no deploy)
|
|
133
147
|
|
|
134
148
|
```bash
|
|
135
|
-
|
|
149
|
+
bash scripts/wire-ci.sh --apply
|
|
136
150
|
# Edit release job to download build artifact — see big-release dogfood
|
|
151
|
+
# CLI/library repos: delete deploy.yml; the release job is terminal.
|
|
137
152
|
|
|
138
153
|
wire-ci --validate
|
|
139
154
|
```
|
|
@@ -277,6 +292,10 @@ jobs:
|
|
|
277
292
|
github-token: ${{ secrets.GITHUB_TOKEN }}
|
|
278
293
|
run-id: ${{ github.event.workflow_run.id }}
|
|
279
294
|
path: deploy-meta
|
|
295
|
+
# BigBase-specific composite action, not a bigpowers default: this deploy
|
|
296
|
+
# example targets the author's own hosting stack. Replace it with your
|
|
297
|
+
# platform's deploy step (or drop the deploy job entirely for CLI and
|
|
298
|
+
# library repos). bigpowers itself ships no deploy templates. (GH #104)
|
|
280
299
|
- uses: danielvm-git/.github/actions/bigbase-deploy@9c56ac10c629f3baa110ddb19136579e3c90d690 # v1
|
|
281
300
|
with:
|
|
282
301
|
site_id: ${{ secrets.BIGBASE_SITE_ID }}
|
|
@@ -1,104 +1,112 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: wire-ci
|
|
3
3
|
model: sonnet
|
|
4
|
-
description: "CI pipeline setup with
|
|
4
|
+
description: "CI pipeline setup with bundled, forge-neutral templates and local validation. Detects the forge from the git remote, generates workflows for supported forges, and skips honestly for the rest. The CI equivalent of wire-observability."
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Wire CI
|
|
8
8
|
|
|
9
|
-
> **HARD GATE** — Do not ship a project without CI. Run this skill before first merge to main
|
|
9
|
+
> **HARD GATE (supported forges only)** — Do not ship a project without CI. Run this skill before first merge to main.
|
|
10
|
+
>
|
|
11
|
+
> On a forge bigpowers ships no templates for, this skill **is not a gate**: it reports the forge, explains what it cannot do, and exits 3. A gate that cannot run must not claim it did. See § Unsupported forges.
|
|
10
12
|
>
|
|
11
13
|
> **HARD GATE** — CI that is untestable locally will break every cycle. Always run `--validate` after generating workflows and `--dry-run` before pushing.
|
|
12
14
|
|
|
13
|
-
Generate, validate, and test CI workflows. Detects
|
|
15
|
+
Generate, validate, and test CI workflows. Detects the forge and project type, copies a **bundled** template, and verifies locally before anything reaches CI.
|
|
14
16
|
|
|
15
|
-
##
|
|
17
|
+
## Forge resolution
|
|
16
18
|
|
|
17
|
-
|
|
18
|
-
2. **Deploy workflow** — `.github/workflows/deploy.yml` triggered via `workflow_run` (BigBase/Pages stacks only; CLI/library repos omit this)
|
|
19
|
-
3. **`--validate` mode** — checks YAML syntax, workflow permissions, required secrets, and common pitfalls
|
|
20
|
-
4. **`--dry-run` mode** — runs workflows locally via `act` or `gh workflow run` to prove correctness before push
|
|
21
|
-
5. **Failure pattern documentation** — common CI failure categories and their fixes
|
|
19
|
+
`scripts/lib/detect-forge.sh` resolves the forge, first match wins: `BIGPOWERS_FORGE` env var → `forge:` in `specs/forge.yaml` → the `origin` remote URL → `unknown`.
|
|
22
20
|
|
|
23
|
-
|
|
21
|
+
```bash
|
|
22
|
+
bash scripts/wire-ci.sh --detect # report forge + stack, write nothing
|
|
23
|
+
bash scripts/wire-ci.sh --plan # show the template that would be used
|
|
24
|
+
bash scripts/wire-ci.sh --apply # write the workflow
|
|
25
|
+
```
|
|
24
26
|
|
|
25
|
-
|
|
27
|
+
GitHub ships templates (`.github/workflows/`). GitLab, Bitbucket, Codeberg, and Gitea are detected but **unsupported** — `--apply` writes nothing and exits 3.
|
|
26
28
|
|
|
27
|
-
|
|
29
|
+
## Template source — configurable, bundled by default
|
|
28
30
|
|
|
29
|
-
|
|
30
|
-
|----------|------|-------------------------------------|
|
|
31
|
-
| `Cargo.toml` | Rust | `test-build-release-monorepo.yml` + `deploy-monorepo.yml` (or monorepo subset) |
|
|
32
|
-
| `package.json` | Node | `test-build-release-node.yml` + `deploy-node.yml` |
|
|
33
|
-
| `setup.py` / `pyproject.toml` | Python | `test-build-release-python.yml` + `deploy-python.yml` |
|
|
34
|
-
| `go.mod` | Go | `test-build-release-go.yml` + `deploy-go.yml` |
|
|
35
|
-
| Static site (no server) | Static | `test-build-release-static.yml` + `deploy-static.yml` |
|
|
36
|
-
| `Package.swift` | Swift | `test-build-release-swift.yml` only (no deploy yet) |
|
|
37
|
-
| Multiple detected | Polyglot | `test-build-release-monorepo.yml` + `deploy-monorepo.yml` |
|
|
31
|
+
Templates live in `docs/templates/ci/<forge>/` **inside the bigpowers package**, so there is no network dependency on any third party's repository. Override with `BIGPOWERS_CI_TEMPLATES=/path/to/your/templates`, laid out as `<root>/<forge>/test-build-release-<stack>.yml`.
|
|
38
32
|
|
|
39
|
-
|
|
33
|
+
## What this sets up
|
|
40
34
|
|
|
41
|
-
|
|
35
|
+
1. **Test Build Release workflow** — lint → test → build → release in one `needs:` chain
|
|
36
|
+
2. **`--validate` mode** — YAML syntax, workflow permissions, required secrets, common pitfalls
|
|
37
|
+
3. **`--dry-run` mode** — runs workflows locally via `act` before push
|
|
38
|
+
4. **Failure pattern documentation** — see the table below
|
|
42
39
|
|
|
43
|
-
|
|
40
|
+
Deploy workflows are **not** bundled: they are platform-specific. See [REFERENCE.md](REFERENCE.md) for a worked example.
|
|
44
41
|
|
|
45
|
-
|
|
42
|
+
## Process
|
|
43
|
+
|
|
44
|
+
### 1. Detect forge and stack
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
bash scripts/wire-ci.sh --detect
|
|
48
|
+
```
|
|
46
49
|
|
|
47
|
-
|
|
50
|
+
Stack detection reads the project root:
|
|
48
51
|
|
|
49
|
-
|
|
52
|
+
| Manifest | Stack | Bundled template |
|
|
53
|
+
|----------|-------|------------------|
|
|
54
|
+
| `Cargo.toml` | Rust | `test-build-release-rust.yml` |
|
|
55
|
+
| `package.json` | Node | `test-build-release-node.yml` |
|
|
56
|
+
| `pyproject.toml` / `setup.py` | Python | `test-build-release-python.yml` |
|
|
57
|
+
| `go.mod` | Go | `test-build-release-go.yml` |
|
|
50
58
|
|
|
51
|
-
|
|
59
|
+
No recognized manifest → exit 3 with the list of manifests it looked for. Do not guess.
|
|
52
60
|
|
|
53
|
-
|
|
61
|
+
### 2. Apply the template
|
|
54
62
|
|
|
55
63
|
```bash
|
|
56
|
-
|
|
64
|
+
bash scripts/wire-ci.sh --apply
|
|
57
65
|
```
|
|
58
66
|
|
|
59
|
-
|
|
67
|
+
**Do not rename the workflow `name:` field** — deploy listens for `"Test Build Release"`.
|
|
60
68
|
|
|
61
|
-
|
|
69
|
+
Edit placeholders after copying: language versions, `APP_TYPE`, `SITE_URL`.
|
|
62
70
|
|
|
63
|
-
###
|
|
71
|
+
### 3. Unsupported forges
|
|
64
72
|
|
|
65
|
-
|
|
73
|
+
`--apply` writes nothing and exits 3. Your options, in the order the runner prints them:
|
|
66
74
|
|
|
67
|
-
|
|
75
|
+
- point `BIGPOWERS_CI_TEMPLATES` at templates for your forge
|
|
76
|
+
- pin `forge: github` in `specs/forge.yaml` if the remote is misdetected
|
|
77
|
+
- write the CI config by hand
|
|
68
78
|
|
|
69
|
-
|
|
70
|
-
- `0` — all checks pass (no errors)
|
|
71
|
-
- `1` — YAML syntax errors found
|
|
72
|
-
- `2` — validation warnings only (missing permissions, secrets, etc.)
|
|
79
|
+
Contributing a `docs/templates/ci/gitlab/` set and adding `gitlab` to `FORGE_SUPPORTED_LIST` is the natural next slice — per-forge command mapping (`gh pr checks` → `glab ci status`) is not implemented yet.
|
|
73
80
|
|
|
74
|
-
###
|
|
81
|
+
### 4. Validate workflows (`--validate`)
|
|
75
82
|
|
|
76
|
-
|
|
83
|
+
See [REFERENCE.md](REFERENCE.md). Exit codes: `0` clean, `1` YAML syntax errors, `2` warnings only.
|
|
84
|
+
|
|
85
|
+
### 5. Dry-run workflows (`--dry-run`)
|
|
77
86
|
|
|
78
|
-
See [REFERENCE.md](REFERENCE.md)
|
|
87
|
+
See [REFERENCE.md](REFERENCE.md).
|
|
79
88
|
|
|
80
89
|
> **act** runs workflows in a local Docker environment — the most accurate pre-push validation.
|
|
81
|
-
> **gh workflow run** sends the workflow to GitHub but
|
|
90
|
+
> **gh workflow run** sends the workflow to GitHub but does not execute locally.
|
|
82
91
|
|
|
83
92
|
### 6. Document common CI failure patterns
|
|
84
93
|
|
|
85
|
-
Add the following to the project's documentation or CLAUDE.md after setup:
|
|
86
|
-
|
|
87
94
|
| Failure | Cause | Fix |
|
|
88
95
|
|---------|-------|-----|
|
|
89
|
-
| `npm publish` fails | `NPM_TOKEN` not set as repo secret | Add `NPM_TOKEN` to
|
|
90
|
-
| `semantic-release` fails on push | Missing `permissions: contents: write` | Add
|
|
91
|
-
| `cargo publish` auth fail | `CARGO_REGISTRY_TOKEN` not set | Add token to `~/.cargo/config.toml`
|
|
92
|
-
| `go vet` fails | Go version mismatch |
|
|
93
|
-
| `cargo clippy` errors | New lints
|
|
94
|
-
| `act` not found | Docker not running or act
|
|
95
|
-
| Hardcoded Node version stale | `.nvmrc` exists but workflow
|
|
96
|
-
| Deploy never runs | TBR workflow renamed | Keep `name: Test Build Release`
|
|
97
|
-
| Release rebuilds binary | Artifact not downloaded | `release`
|
|
96
|
+
| `npm publish` fails | `NPM_TOKEN` not set as repo secret | Add `NPM_TOKEN` to repo secrets |
|
|
97
|
+
| `semantic-release` fails on push | Missing `permissions: contents: write` | Add it to the release job |
|
|
98
|
+
| `cargo publish` auth fail | `CARGO_REGISTRY_TOKEN` not set | Add token to env or `~/.cargo/config.toml` |
|
|
99
|
+
| `go vet` fails | Go version mismatch | Use `go-version-file: go.mod` |
|
|
100
|
+
| `cargo clippy` errors | New nightly lints | Pin the toolchain; `cargo clippy --fix` |
|
|
101
|
+
| `act` not found | Docker not running or act missing | `brew install act`; `docker ps` |
|
|
102
|
+
| Hardcoded Node version stale | `.nvmrc` exists but workflow hardcodes | Use `node-version-file: .nvmrc` |
|
|
103
|
+
| Deploy never runs | TBR workflow renamed | Keep `name: Test Build Release` |
|
|
104
|
+
| Release rebuilds binary | Artifact not downloaded | `release` must `download-artifact` from `build` |
|
|
98
105
|
|
|
99
106
|
## Verify
|
|
100
107
|
|
|
101
|
-
→ verify: `
|
|
108
|
+
→ verify: `bash scripts/wire-ci.sh --self-test`
|
|
109
|
+
→ verify: `test -f docs/templates/ci/github/test-build-release-node.yml && test -f scripts/lib/detect-forge.sh`
|
|
102
110
|
→ verify: `grep -q wire-ci SKILL-INDEX.md`
|
|
103
111
|
|
|
104
112
|
---
|
|
@@ -121,19 +129,26 @@ Add the following to the project's documentation or CLAUDE.md after setup:
|
|
|
121
129
|
### Create CI for a Go project (TBR + optional deploy)
|
|
122
130
|
|
|
123
131
|
```bash
|
|
124
|
-
#
|
|
125
|
-
|
|
126
|
-
|
|
132
|
+
# Resolve forge + stack, then apply the bundled template
|
|
133
|
+
bash scripts/wire-ci.sh --detect
|
|
134
|
+
bash scripts/wire-ci.sh --apply
|
|
127
135
|
|
|
128
136
|
wire-ci --validate
|
|
129
137
|
wire-ci --dry-run
|
|
130
138
|
```
|
|
131
139
|
|
|
140
|
+
To use your own org templates instead of the bundled ones:
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
BIGPOWERS_CI_TEMPLATES=/path/to/your/templates bash scripts/wire-ci.sh --apply
|
|
144
|
+
```
|
|
145
|
+
|
|
132
146
|
### Create CI for a CLI tool (TBR only, no deploy)
|
|
133
147
|
|
|
134
148
|
```bash
|
|
135
|
-
|
|
149
|
+
bash scripts/wire-ci.sh --apply
|
|
136
150
|
# Edit release job to download build artifact — see big-release dogfood
|
|
151
|
+
# CLI/library repos: delete deploy.yml; the release job is terminal.
|
|
137
152
|
|
|
138
153
|
wire-ci --validate
|
|
139
154
|
```
|
|
@@ -277,6 +292,10 @@ jobs:
|
|
|
277
292
|
github-token: ${{ secrets.GITHUB_TOKEN }}
|
|
278
293
|
run-id: ${{ github.event.workflow_run.id }}
|
|
279
294
|
path: deploy-meta
|
|
295
|
+
# BigBase-specific composite action, not a bigpowers default: this deploy
|
|
296
|
+
# example targets the author's own hosting stack. Replace it with your
|
|
297
|
+
# platform's deploy step (or drop the deploy job entirely for CLI and
|
|
298
|
+
# library repos). bigpowers itself ships no deploy templates. (GH #104)
|
|
280
299
|
- uses: danielvm-git/.github/actions/bigbase-deploy@9c56ac10c629f3baa110ddb19136579e3c90d690 # v1
|
|
281
300
|
with:
|
|
282
301
|
site_id: ${{ secrets.BIGBASE_SITE_ID }}
|
package/.pi/package.json
CHANGED