Skip to content

Commit 92a07ad

Browse files
committed
docs: add plan and progress ledger
1 parent 88fe7d0 commit 92a07ad

1 file changed

Lines changed: 65 additions & 0 deletions

File tree

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# Fix All Branches and Workflows Implementation Plan
2+
3+
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
4+
5+
**Goal:** Fix all syntax errors, duplicate keys, broken GitHub Actions workflows, and corrupted package-lock files across `main` and all active branches of `beer-sakthai/codeql-action`.
6+
7+
**Architecture:**
8+
1. Fix `package.json` duplicate dependency keys and regenerate a valid `package-lock.json` on `main`.
9+
2. Fix YAML syntax error in `.github/workflows/codeql.yml` on `main`.
10+
3. Fix duplicate keys in `pr-checks/checks/*.yml` and re-sync generated `.github/workflows/__*.yml` workflows on `main`.
11+
4. Rebase/merge the fixed `main` into `dependabot/npm_and_yarn/actions/core-3.0.1` (PR #13) so its dependencies, `package.json`, and `package-lock.json` are clean and valid.
12+
5. Push fixes to `main` and `dependabot/npm_and_yarn/actions/core-3.0.1`.
13+
14+
**Tech Stack:** Node.js / npm, TypeScript, GitHub Actions, YAML, Git.
15+
16+
---
17+
18+
### Global Constraints
19+
- All YAML files in `.github/workflows/` and `pr-checks/checks/` must parse cleanly with zero duplicate keys and zero syntax errors.
20+
- `package.json` and `package-lock.json` must be strictly valid JSON with zero duplicate keys.
21+
- Do not introduce breaking changes to existing action interfaces.
22+
23+
---
24+
25+
### Task 1: Fix `package.json` and regenerate `package-lock.json` on `main`
26+
- [ ] Remove duplicate keys in `package.json`:
27+
- Keep `@actions/glob: ^0.5.0`
28+
- Keep `@actions/http-client: ^4.0.1`
29+
- Keep `@types/sinon: ^22.0.2`
30+
- Keep `ava: ^6.4.1`
31+
- [ ] Rebuild clean `package-lock.json` using `npm install --package-lock-only` (or clean install).
32+
- [ ] Run validator script to ensure `package.json` and `package-lock.json` are valid JSON with 0 duplicate keys.
33+
- [ ] Commit changes to `main`.
34+
35+
### Task 2: Fix syntax error in `.github/workflows/codeql.yml` on `main`
36+
- [ ] In `analyze-javascript` step of `.github/workflows/codeql.yml`, remove the duplicate indented `- name: Checkout` block inside `upload:`.
37+
- [ ] In `analyze-other` step of `.github/workflows/codeql.yml`, remove the duplicate indented `- name: Checkout` block inside `upload:`.
38+
- [ ] Validate `.github/workflows/codeql.yml` using `yaml.safe_load`.
39+
- [ ] Commit changes to `main`.
40+
41+
### Task 3: Fix duplicate keys in `pr-checks/checks/*.yml` and sync workflows on `main`
42+
- [ ] Remove duplicate `runner-image: macos-26-xlarge` in:
43+
- `pr-checks/checks/swift-autobuild.yml`
44+
- `pr-checks/checks/swift-custom-build.yml`
45+
- `pr-checks/checks/all-platform-bundle.yml`
46+
- `pr-checks/checks/multi-language-autodetect.yml`
47+
(Keep `runner-image: macos-latest`)
48+
- [ ] In `pr-checks/checks/per-language-bundle-validation.yml`, fix duplicate `os` and `version` entries under `language: swift` (use `os: macos-latest` and `version: linked`, `build-mode: autobuild`).
49+
- [ ] Run `npx tsx pr-checks/sync.ts` to regenerate `.github/workflows/__*.yml`.
50+
- [ ] Run the repository-wide YAML validator to verify 0 syntax errors and 0 duplicate keys across all YAML files.
51+
- [ ] Commit changes to `main`.
52+
53+
### Task 4: Fix PR #13 branch (`dependabot/npm_and_yarn/actions/core-3.0.1`)
54+
- [ ] Checkout branch `dependabot/npm_and_yarn/actions/core-3.0.1`.
55+
- [ ] Merge or rebase onto updated `main`.
56+
- [ ] Verify that `@actions/core: ^3.0.1` is set cleanly in both `package.json` and `pr-checks/package.json` without duplicate keys.
57+
- [ ] Regenerate `package-lock.json` cleanly so it contains valid JSON.
58+
- [ ] Verify all YAML files and JSON files on this branch have 0 errors.
59+
- [ ] Commit changes to `dependabot/npm_and_yarn/actions/core-3.0.1`.
60+
61+
### Task 5: Final whole-branch audit, verification and push
62+
- [ ] Audit all 7 branches to confirm their status.
63+
- [ ] Push updated `main` to `origin/main`.
64+
- [ ] Push updated `dependabot/npm_and_yarn/actions/core-3.0.1` to `origin/dependabot/npm_and_yarn/actions/core-3.0.1`.
65+
- [ ] Verify that GitHub Actions trigger cleanly on the pushed branches.

0 commit comments

Comments
 (0)