@mark1russell7/conventions 0.37.2 → 0.38.0
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 +1 -0
- package/build/cli.js +1 -1
- package/build/index.d.ts +1 -0
- package/build/index.d.ts.map +1 -1
- package/build/index.js +2 -2
- package/build/{run-_3JdUrzy.js → run-CWh6SR2w.js} +83 -6
- package/build/run-CWh6SR2w.js.map +1 -0
- package/package.json +1 -1
- package/build/run-_3JdUrzy.js.map +0 -1
package/README.md
CHANGED
|
@@ -70,6 +70,7 @@ The rules come from the invariants audit of 2026-10-26 (strategy item s38). The
|
|
|
70
70
|
| `security-one-job` | The security scans run in one job, the check `Security OK`, with the action `security-scan` of the template. The shared workflow `reusable-security.yml` gives three scan jobs, and its caller adds a summary job. Each job asks for its own runner, so in a full queue a run waits for four runners. On 2026-11-06 each scan job of one repository waited 23 to 40 minutes. |
|
|
71
71
|
| `service-run-main` | In a server package, only the entry `src/main.ts` starts the service with `run()`. A server package has a dependency on `@mark1russell7/service` and a file `src/main.ts`, as the preset `service` writes it. A source file that imports the service package and starts `run()` is a break. `run()` owns the process, so a module that starts it cannot be imported by a test. |
|
|
72
72
|
| `shared-ci` | The workflow `ci.yml` calls the shared workflow `reusable-ci.yml` of the template, and no workflow or action of the repository has the name of a shared one of the template. A `ci.yml` with its own steps, or a local copy, does not get the fixes and the new checks of the template. The template itself is not examined (option `home`). On 2026-11-07, 3 of 19 repositories of the account ran CI steps of their own. |
|
|
73
|
+
| `setup-cue` | No workflow or action installs the cue CLI with its own command (a download of a release asset of `cue-lang/cue`, or `go install`). A caller of `reusable-ci.yml` gives the input `cue-version`. Another job uses the action `setup-cue` of the template. The action installs the CLI from a cache, or with retries and a sha256 check. On 2026-11-08, a 504 of GitHub failed each bare `curl` of the CLI. |
|
|
73
74
|
| `gate-trigger` | No workflow has `paths` or `paths-ignore` on `on.pull_request` or `on.pull_request_target`. The ruleset needs the summary check `<Name> OK` of each gate, and a workflow with a path filter does not start on each pull request. Then its check is not there, the ruleset cannot ask for it, and a pull request can merge before the gate ends. A gate uses the actions `changes` and `gate-summary` of the template (`CI.md`, "A gate with paths"). | private `gate-trigger` (STRATEGY.md, 2026-11-02). |
|
|
74
75
|
| `license-file` | Each public package has a license field, and a license file with the same license in its own folder. A public repository, or a repository with a public package, has a license file at its root. In a GitHub Actions run, the event file tells if the repository is public, and the option `license` (MIT by default) is the license of a root with no public package. npm packs only the license file of the folder of the package, and GitHub reads only the one of the root: on 2026-11-02 five public repositories showed no license on GitHub while npm said MIT. `conventions fix` writes the missing files. | private strategy (2026-11-02). |
|
|
75
76
|
| `home-package` | A change does not add a function with a signature name of another home of the map (for example `median`, `mulberry32` or `writeFileAtomic`). A local copy drifts from the home and splits the fixes. On 2026-11-02 the repositories had 68 local statistics functions in 14 repositories. The rule examines only the lines that the change adds, so the copies that exist do not break. | private direction 18 (STRATEGY.md, 2026-11-02). |
|
package/build/cli.js
CHANGED
package/build/index.d.ts
CHANGED
|
@@ -211,6 +211,7 @@ export declare function withOneJob(text: string, commit?: string): {
|
|
|
211
211
|
reason: string;
|
|
212
212
|
};
|
|
213
213
|
export declare const securityOneJob: Rule;
|
|
214
|
+
export declare const setupCue: Rule;
|
|
214
215
|
/** The shared workflows of the template, by file name. */
|
|
215
216
|
export declare const SHARED_WORKFLOWS: readonly string[];
|
|
216
217
|
/** The shared actions of the template, by folder name under `.github/actions`. */
|
package/build/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/rule.ts","../src/config.ts","../src/rules/cue-preset.ts","../src/rules/gate-after-cancel.ts","../src/rules/gate-trigger.ts","../src/rules/security-one-job.ts","../src/rules/shared-ci.ts","../src/rules/service-run-main.ts","../src/map.ts","../src/rules/home-package.ts","../src/rules/license-file.ts","../src/rules/main-check.ts","../src/rules/no-build-output.ts","../src/private-names.ts","../src/rules/no-local-paths.ts","../src/rules/api-report-script.ts","../src/rules/pages-after-release.ts","../src/rules/pages-site.ts","../src/rules/pinned-git-deps.ts","../src/rules/pipe-fails.ts","../src/rules/push-main-only.ts","../src/rules/unreleased-change.ts","../src/rules/published-minor.ts","../src/rules/release-files.ts","../src/rules/required-scripts.ts","../src/rules/roadmap-parses.ts","../src/rules/runner-budget.ts","../src/rules/shared-docs.ts","../src/rules/source-main.ts","../src/rules/tests-required.ts","../src/rules/tsconfig-test.ts","../src/rules/typed-files.ts","../src/rules/typed-scripts.ts","../src/rules/trust-policy.ts","../src/rules/version-title.ts","../src/rules/workflow-parses.ts","../src/rules/workspace-protocol.ts","../src/rules/index.ts","../src/run.ts","../src/pre-push.ts","../src/home-exports.ts","../src/workflow.ts","../src/release-text.ts","../src/workspace.ts"],"mappings":";UASiB;WACN;WACA;WACA;;;UAIM;;WAEN;;WAEA;WACA;;WAEA;;WAEA,iBAAiB;;;;;;UAOX;;WAEN;;WAEA;;WAEA;;;wBAIK,YAAY,cAAc,cAAc;;KAQ5C;;KAGA,UAAU,SAAS,eAAe;;UAG7B;WACN;WACA,SAAS;WACT;;;KAIC,WAAW,SAAS;;UAGf;;WAEN;;WAEA;;WAEA;;WAEA;WACA,UAAU;;;UAIJ;;WAEN;;WAEA,aAAa;;WAEb,mBAAmB;;WAEnB,KAAK,SAAS;;WAEd;;EAET;;EAEA,IAAI;;;KAIM,uBAAuB;WAAqB;;;UAGvC;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,kBAAkB;;WAElB,SAAS,SAAS,eAAe;;;;;WAKjC;EACT,MAAM,SAAS,aAAa,SAAS,UAAU;;;qBAIpC;;wBAGG,aAAa,UAAU,UAAU;;wBAOjC,OAAO,cAAc,gBAAgB;;wBAOrC,QAAQ,cAAc,eAAe;;qBAMxC,WAAY,gBAAgB;;qBAG5B,YAAa;;wBAGV,WAAW,cAAc;;;;;;wBASzB,WAAW;;wBA2BX,UAAU;;wBAUV,OAAO,cAAc;;qBAOxB,UAAW,aAAa;;;;;wBAMrB,aAAa,SAAS,KAAK,oDAAoD;;UC1M9E;;WAEN;;WAEA;;;;;WAKA;;WAEA;;WAEA,SAAS;;;UAIH;;WAEN;;WAEA,OAAO,SAAS,eAAe;;;wBAW1B,eAAe,MAAM,OAAO;;;;;;;wBAU5B,YAAY,gBAAgB,gBAAgB,SAAS;;qBCxCxD;qBA4FA,WAAW;qBC5CX,iBAAiB;;UCzCb;WACN;WACA;WACA;;;wBAIK,cAAc,eAAe;;qBAoBhC;;wBAyBG,YAAY;;;;;;;wBAkBZ,YAAY,cAAc,cAAc;EAAoC;;EAAmB;;qBAwIlG,aAAa;;qBClNb;;qBAGA;;qBAGA;;UAQI;WACN;WACA;;;wBAkBK,gBAAgB,eAAe;;;;;;wBA8B/B,WAAW,cAAc;EAA0C;;EAAmB;;qBA4DzF,gBAAgB;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/rule.ts","../src/config.ts","../src/rules/cue-preset.ts","../src/rules/gate-after-cancel.ts","../src/rules/gate-trigger.ts","../src/rules/security-one-job.ts","../src/rules/setup-cue.ts","../src/rules/shared-ci.ts","../src/rules/service-run-main.ts","../src/map.ts","../src/rules/home-package.ts","../src/rules/license-file.ts","../src/rules/main-check.ts","../src/rules/no-build-output.ts","../src/private-names.ts","../src/rules/no-local-paths.ts","../src/rules/api-report-script.ts","../src/rules/pages-after-release.ts","../src/rules/pages-site.ts","../src/rules/pinned-git-deps.ts","../src/rules/pipe-fails.ts","../src/rules/push-main-only.ts","../src/rules/unreleased-change.ts","../src/rules/published-minor.ts","../src/rules/release-files.ts","../src/rules/required-scripts.ts","../src/rules/roadmap-parses.ts","../src/rules/runner-budget.ts","../src/rules/shared-docs.ts","../src/rules/source-main.ts","../src/rules/tests-required.ts","../src/rules/tsconfig-test.ts","../src/rules/typed-files.ts","../src/rules/typed-scripts.ts","../src/rules/trust-policy.ts","../src/rules/version-title.ts","../src/rules/workflow-parses.ts","../src/rules/workspace-protocol.ts","../src/rules/index.ts","../src/run.ts","../src/pre-push.ts","../src/home-exports.ts","../src/workflow.ts","../src/release-text.ts","../src/workspace.ts"],"mappings":"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"}
|
package/build/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { $ as unreleasedChangeRule, $t as mergeHomes, A as typedFiles, An as
|
|
1
|
+
import { $ as unreleasedChangeRule, $t as mergeHomes, A as typedFiles, An as codePackages, At as nameMatches, B as roadmapParses, Bn as specifiersOf, Bt as licenseFileOf, C as versionTitle, Cn as summaryName, Ct as PRIVATE_NAME_LIST, D as typedScripts, Dn as cuePreset, Dt as isCommonUse, E as trustPolicy, En as STRICT_OPTIONS, Et as isAllowedHit, F as HOME_TIMEOUT_MS, Fn as matchesAny, Ft as hasImportMetaMain, G as publishedMinor, Gn as defaultOptions, Gt as messageOf, H as releaseFiles, Hn as globToRegExp, Ht as repositoryIsPublic, I as blockHash, In as parseJsonc, It as mainCheck, J as NPM_REGISTRY, Jt as HOMES, K as publishedMinorRule, Kn as parseConfig, Kt as repoOf, L as githubFetch, Ln as readJsonc, Lt as LICENSE_TEXTS, M as isSourcePath, Mn as inFolder, Mt as pathNameHit, N as pathsOf, Nn as keyLine, Nt as noBuildOutput, O as configsOfScript, On as DEPENDENCY_FIELDS, Ot as lineNameHit, P as sourceMain, Pn as lineOf, Pt as REAL_COMPARE, Q as unreleasedChange, Qt as mapText, R as sharedDocsRule, Rn as replaceLine, Rt as authorOf, S as setVersions, Sn as prPathFilters, St as privateTextBreaks, T as TRAIN_SCOPES, Tn as readWorkflow, Tt as firstNameMatch, U as lockedVersions, Un as packageFolders, Ut as declaredName, V as requiredScripts, Vn as globFolders, Vt as mitText, W as minorOf, Wn as workspaceGlobs, Wt as homePackage, X as UNSHIPPED_FILES, Xt as findHomes, Y as SHIPPED_FIELDS, Yt as MAP_RULE, Z as npmLookup, Zt as mapMarkdown, _ as workspaceProtocol, _n as securityOneJob, _t as PRIVATE_PATTERNS_VARIABLE, a as listRules, an as hasTests, at as repositoryOfRemote, b as yamlFaults, bn as convertGate, bt as privateNamesFile, c as runCli, cn as SHARED_CI, ct as pushMainOnly, d as HOOK_MARKER, dn as sharedCi, dt as pagesSite, en as readOverlay, et as pipeFails, f as NO_READ_LINE, fn as setupCue, ft as apiReportScript, g as RULES, gn as securityCallers, gt as PRIVATE_NAMES_FILE_VARIABLE, h as prePush, hn as SECURITY_TIMEOUT_MINUTES, ht as PRIVATE_NAMES_FILE_CONFIG, i as formatResult, in as serviceRunMain, it as pagesAfterRelease, j as testsRequired, jn as hasFile, jt as parsePrivateNames, k as scriptsOf, kn as cleanPath, kt as lineNameHits, l as runFix, ln as SHARED_WORKFLOWS, lt as PAGES_WORKFLOWS, m as installHook, mn as SECURITY_SCAN_INPUTS, mt as HOME_PATTERNS, n as annotations, nn as SERVICE_PACKAGE, nt as isPinned, o as readConfig, on as tsconfigTest, ot as runnerBudget, p as PRE_PUSH_HOOK, pn as SECURITY_SCAN_COMMIT, pt as DEFAULT_ALLOWED, q as reachOf, qt as signaturesOf, r as createContext, rn as runCalls, rt as pinnedGitDeps, s as runChecks, sn as SHARED_ACTIONS, st as scheduleMinute, t as USAGE, tn as HOME_EXPORTS, tt as isGitSpecifier, u as summaryMarkdown, un as callsSharedCi, ut as pagesCalls, v as GITHUB_YAML, vn as withOneJob, vt as invalidPatternBreaks, w as IGNORE_AFTER, wn as gateAfterCancel, wt as PrivateNameListError, x as namedVersions, xn as gateTrigger, xt as privatePatterns, y as workflowParses, yn as ACTIONS_COMMIT, yt as noLocalPaths, z as roadmapOfLine, zn as runGit, zt as licenseFile } from "./run-CWh6SR2w.js";
|
|
2
2
|
// src/release-text.ts
|
|
3
3
|
/**
|
|
4
4
|
* The rule for the git tag and the text of a GitHub release of a package version.
|
|
@@ -64,6 +64,6 @@ function releaseNotes(name, version, changelog) {
|
|
|
64
64
|
if (section.length <= 1e5) return section;
|
|
65
65
|
return `${section.slice(0, MAX_NOTES)}\n\n(The CHANGELOG.md of \`${name}\` has the full text.)`;
|
|
66
66
|
}
|
|
67
|
-
export { ACTIONS_COMMIT, DEFAULT_ALLOWED, DEPENDENCY_FIELDS, GITHUB_YAML, HOMES, HOME_EXPORTS, HOME_PATTERNS, HOME_TIMEOUT_MS, HOOK_MARKER, IGNORE_AFTER, LICENSE_TEXTS, MAP_RULE, MAX_NOTES, NO_READ_LINE, NPM_REGISTRY, PAGES_WORKFLOWS, PRE_PUSH_HOOK, PRIVATE_NAMES_FILE_CONFIG, PRIVATE_NAMES_FILE_VARIABLE, PRIVATE_NAME_LIST, PRIVATE_PATTERNS_VARIABLE, PrivateNameListError, REAL_COMPARE, RULES, SECURITY_SCAN_COMMIT, SECURITY_SCAN_INPUTS, SECURITY_TIMEOUT_MINUTES, SERVICE_PACKAGE, SHARED_ACTIONS, SHARED_CI, SHARED_WORKFLOWS, SHIPPED_FIELDS, STRICT_OPTIONS, TRAIN_SCOPES, UNSHIPPED_FILES, USAGE, annotations, apiReportScript, authorOf, blockHash, callsSharedCi, changelogSection, cleanPath, codePackages, configsOfScript, convertGate, createContext, cuePreset, declaredName, defaultOptions, findHomes, firstNameMatch, formatResult, gateAfterCancel, gateTrigger, githubFetch, globFolders, globToRegExp, hasFile, hasImportMetaMain, hasTests, homePackage, inFolder, installHook, invalidPatternBreaks, isAllowedHit, isCommonUse, isGitSpecifier, isPinned, isSourcePath, keyLine, licenseFile, licenseFileOf, lineNameHit, lineNameHits, lineOf, listRules, lockedVersions, mainCheck, mapMarkdown, mapText, matchesAny, mergeHomes, messageOf, minorOf, mitText, nameMatches, namedVersions, noBuildOutput, noLocalPaths, npmLookup, npmUrl, packageFolders, pagesAfterRelease, pagesCalls, pagesSite, parseConfig, parseJsonc, parsePrivateNames, pathNameHit, pathsOf, pinnedGitDeps, pipeFails, prPathFilters, prePush, privateNamesFile, privatePatterns, privateTextBreaks, publishedMinor, publishedMinorRule, pushMainOnly, reachOf, readConfig, readJsonc, readOverlay, readWorkflow, releaseFiles, releaseNotes, replaceLine, repoOf, repositoryIsPublic, repositoryOfRemote, requiredScripts, roadmapOfLine, roadmapParses, runCalls, runChecks, runCli, runFix, runGit, runnerBudget, scheduleMinute, scriptsOf, securityCallers, securityOneJob, serviceRunMain, setVersions, sharedCi, sharedDocsRule, signaturesOf, sourceMain, specifiersOf, summaryMarkdown, summaryName, tagName, testsRequired, trustPolicy, tsconfigTest, typedFiles, typedScripts, unreleasedChange, unreleasedChangeRule, versionTitle, withOneJob, workflowParses, workspaceGlobs, workspaceProtocol, yamlFaults };
|
|
67
|
+
export { ACTIONS_COMMIT, DEFAULT_ALLOWED, DEPENDENCY_FIELDS, GITHUB_YAML, HOMES, HOME_EXPORTS, HOME_PATTERNS, HOME_TIMEOUT_MS, HOOK_MARKER, IGNORE_AFTER, LICENSE_TEXTS, MAP_RULE, MAX_NOTES, NO_READ_LINE, NPM_REGISTRY, PAGES_WORKFLOWS, PRE_PUSH_HOOK, PRIVATE_NAMES_FILE_CONFIG, PRIVATE_NAMES_FILE_VARIABLE, PRIVATE_NAME_LIST, PRIVATE_PATTERNS_VARIABLE, PrivateNameListError, REAL_COMPARE, RULES, SECURITY_SCAN_COMMIT, SECURITY_SCAN_INPUTS, SECURITY_TIMEOUT_MINUTES, SERVICE_PACKAGE, SHARED_ACTIONS, SHARED_CI, SHARED_WORKFLOWS, SHIPPED_FIELDS, STRICT_OPTIONS, TRAIN_SCOPES, UNSHIPPED_FILES, USAGE, annotations, apiReportScript, authorOf, blockHash, callsSharedCi, changelogSection, cleanPath, codePackages, configsOfScript, convertGate, createContext, cuePreset, declaredName, defaultOptions, findHomes, firstNameMatch, formatResult, gateAfterCancel, gateTrigger, githubFetch, globFolders, globToRegExp, hasFile, hasImportMetaMain, hasTests, homePackage, inFolder, installHook, invalidPatternBreaks, isAllowedHit, isCommonUse, isGitSpecifier, isPinned, isSourcePath, keyLine, licenseFile, licenseFileOf, lineNameHit, lineNameHits, lineOf, listRules, lockedVersions, mainCheck, mapMarkdown, mapText, matchesAny, mergeHomes, messageOf, minorOf, mitText, nameMatches, namedVersions, noBuildOutput, noLocalPaths, npmLookup, npmUrl, packageFolders, pagesAfterRelease, pagesCalls, pagesSite, parseConfig, parseJsonc, parsePrivateNames, pathNameHit, pathsOf, pinnedGitDeps, pipeFails, prPathFilters, prePush, privateNamesFile, privatePatterns, privateTextBreaks, publishedMinor, publishedMinorRule, pushMainOnly, reachOf, readConfig, readJsonc, readOverlay, readWorkflow, releaseFiles, releaseNotes, replaceLine, repoOf, repositoryIsPublic, repositoryOfRemote, requiredScripts, roadmapOfLine, roadmapParses, runCalls, runChecks, runCli, runFix, runGit, runnerBudget, scheduleMinute, scriptsOf, securityCallers, securityOneJob, serviceRunMain, setVersions, setupCue, sharedCi, sharedDocsRule, signaturesOf, sourceMain, specifiersOf, summaryMarkdown, summaryName, tagName, testsRequired, trustPolicy, tsconfigTest, typedFiles, typedScripts, unreleasedChange, unreleasedChangeRule, versionTitle, withOneJob, workflowParses, workspaceGlobs, workspaceProtocol, yamlFaults };
|
|
68
68
|
|
|
69
69
|
//# sourceMappingURL=index.js.map
|
|
@@ -2211,6 +2211,79 @@ const securityOneJob = {
|
|
|
2211
2211
|
return breaks;
|
|
2212
2212
|
}
|
|
2213
2213
|
};
|
|
2214
|
+
// src/rules/setup-cue.ts
|
|
2215
|
+
/**
|
|
2216
|
+
* The rule `setup-cue`: no workflow or action downloads the cue CLI with its own command. The shared action `setup-cue`
|
|
2217
|
+
* of the template installs it from a cache, or with retries and a sha256 check. A download of a release asset from
|
|
2218
|
+
* GitHub fails at times with a 504, and a bare `curl` then fails the job.
|
|
2219
|
+
*/
|
|
2220
|
+
/** The files of a composite action. */
|
|
2221
|
+
const ACTION$1 = /^\.github\/actions\/.+\/action\.ya?ml$/;
|
|
2222
|
+
/** The action of the template itself. It is the one place with the download. */
|
|
2223
|
+
const SHARED_ACTION = ".github/actions/setup-cue/action.yml";
|
|
2224
|
+
/** A hand-written install of the cue CLI: a download of a release asset, or a build with `go install`. */
|
|
2225
|
+
const DOWNLOAD = /github\.com\/cue-lang\/cue\/releases\/download\/(v[0-9][^/\s"']*)\/|cuelang\.org\/go\/cmd\/cue@(v?[0-9][^\s"']*|latest)/;
|
|
2226
|
+
/** This function gives each line of a file that installs the cue CLI with its own command. It does not read a comment line. */
|
|
2227
|
+
function cueDownloads(text) {
|
|
2228
|
+
const found = [];
|
|
2229
|
+
text.split(/\r?\n/).forEach((line, index) => {
|
|
2230
|
+
if (line.trimStart().startsWith("#")) return;
|
|
2231
|
+
const match = DOWNLOAD.exec(line);
|
|
2232
|
+
if (match === null) return;
|
|
2233
|
+
const version = match[1] ?? match[2];
|
|
2234
|
+
found.push({
|
|
2235
|
+
line: index + 1,
|
|
2236
|
+
version: version === void 0 || version === "latest" ? void 0 : version.replace(/^v/, "")
|
|
2237
|
+
});
|
|
2238
|
+
});
|
|
2239
|
+
return found;
|
|
2240
|
+
}
|
|
2241
|
+
const setupCue = {
|
|
2242
|
+
id: "setup-cue",
|
|
2243
|
+
title: "The cue CLI comes from the shared action `setup-cue`, not from a download in a workflow.",
|
|
2244
|
+
reason: "On 2026-11-08, GitHub gave a 504 for release assets on and off from 09:00Z to after 10:20Z. A bare `curl` of the cue CLI failed the CI of cue and a release of client.",
|
|
2245
|
+
fix: "A caller of `reusable-ci.yml` gives the input `cue-version: \"<version>\"` in place of the download in `setup`. Another job uses the step `uses: mark1russell7/template/.github/actions/setup-cue@<commit>` with `version: <version>`.",
|
|
2246
|
+
sources: [
|
|
2247
|
+
{
|
|
2248
|
+
repo: "cue",
|
|
2249
|
+
rule: "ci",
|
|
2250
|
+
doc: "the cue download of main CI and of #66 (2026-11-08): a 504 of github.com, and #66 passed at attempt 3"
|
|
2251
|
+
},
|
|
2252
|
+
{
|
|
2253
|
+
repo: "client",
|
|
2254
|
+
rule: "release",
|
|
2255
|
+
doc: "the 0.52.0 release (2026-11-08): a bare curl -fsSL of the cue CLI failed on a 504"
|
|
2256
|
+
},
|
|
2257
|
+
{
|
|
2258
|
+
repo: "template",
|
|
2259
|
+
rule: "security",
|
|
2260
|
+
doc: "the Security run of main daa927c (2026-11-08): the same 504 for the CodeQL bundle, another release asset"
|
|
2261
|
+
}
|
|
2262
|
+
],
|
|
2263
|
+
options: {},
|
|
2264
|
+
check(context) {
|
|
2265
|
+
const files = context.gitFiles();
|
|
2266
|
+
if (files === void 0) return { skipped: "the root is not in a git repository" };
|
|
2267
|
+
const breaks = [];
|
|
2268
|
+
for (const file of files.filter((path) => (WORKFLOW$1.test(path) || ACTION$1.test(path)) && path !== SHARED_ACTION).sort(byCode)) {
|
|
2269
|
+
let text;
|
|
2270
|
+
try {
|
|
2271
|
+
text = readFileSync(join(context.root, file), "utf8");
|
|
2272
|
+
} catch {
|
|
2273
|
+
continue;
|
|
2274
|
+
}
|
|
2275
|
+
for (const download of cueDownloads(text)) {
|
|
2276
|
+
const version = download.version === void 0 ? "" : ` ${download.version}`;
|
|
2277
|
+
breaks.push({
|
|
2278
|
+
file,
|
|
2279
|
+
line: download.line,
|
|
2280
|
+
message: `${file} installs the cue CLI${version} with its own command, with no retry. Use the action setup-cue of the template, or the input cue-version of reusable-ci.yml.`
|
|
2281
|
+
});
|
|
2282
|
+
}
|
|
2283
|
+
}
|
|
2284
|
+
return breaks;
|
|
2285
|
+
}
|
|
2286
|
+
};
|
|
2214
2287
|
// src/rules/shared-ci.ts
|
|
2215
2288
|
/**
|
|
2216
2289
|
* The rule `shared-ci`: a repository uses the shared workflows and actions of the template, and keeps no copy of them.
|
|
@@ -2239,6 +2312,7 @@ const SHARED_ACTIONS = [
|
|
|
2239
2312
|
"green-main",
|
|
2240
2313
|
"npm-publish",
|
|
2241
2314
|
"security-scan",
|
|
2315
|
+
"setup-cue",
|
|
2242
2316
|
"setup-playwright",
|
|
2243
2317
|
"site-check",
|
|
2244
2318
|
"site-pages"
|
|
@@ -8417,7 +8491,7 @@ const HOMES = [
|
|
|
8417
8491
|
{
|
|
8418
8492
|
area: "state-machines",
|
|
8419
8493
|
title: "State machines and timers",
|
|
8420
|
-
covers: "state machines as data, closed forms of their timers, failure detection, recovery and trace replay",
|
|
8494
|
+
covers: "state machines as data, closed forms of their timers, clocks (a real clock and a test clock, @mark1russell7/algebra/clock), failure detection, recovery and trace replay",
|
|
8421
8495
|
packages: ["@mark1russell7/algebra"],
|
|
8422
8496
|
repo: "mark1russell7/systems",
|
|
8423
8497
|
state: "published",
|
|
@@ -8427,14 +8501,17 @@ const HOMES = [
|
|
|
8427
8501
|
"timeout",
|
|
8428
8502
|
"heartbeat",
|
|
8429
8503
|
"failover",
|
|
8430
|
-
"detection"
|
|
8504
|
+
"detection",
|
|
8505
|
+
"clock",
|
|
8506
|
+
"test clock",
|
|
8507
|
+
"fake clock"
|
|
8431
8508
|
],
|
|
8432
8509
|
note: "The npm name @mark1russell7/algebra is this package of systems, not the algebra repository."
|
|
8433
8510
|
},
|
|
8434
8511
|
{
|
|
8435
8512
|
area: "service",
|
|
8436
8513
|
title: "Services and servers",
|
|
8437
|
-
covers: "a service declared as data, its lifecycle and checks, jittered loops,
|
|
8514
|
+
covers: "a service declared as data, its lifecycle and checks, jittered loops, backoff and retries, and concurrency on the clock of algebra: channels, select, tickers, time-outs, worker pools, pipelines, fan-in and fan-out (service); the HTTP, WebSocket and MCP host of procedures (peer)",
|
|
8438
8515
|
packages: ["@mark1russell7/service", "@procedures/peer"],
|
|
8439
8516
|
repo: "mark1russell7/systems",
|
|
8440
8517
|
state: "published",
|
|
@@ -8445,7 +8522,6 @@ const HOMES = [
|
|
|
8445
8522
|
"shutdown",
|
|
8446
8523
|
"health",
|
|
8447
8524
|
"loop",
|
|
8448
|
-
"clock",
|
|
8449
8525
|
"backoff",
|
|
8450
8526
|
"retry",
|
|
8451
8527
|
"jitter",
|
|
@@ -13507,6 +13583,7 @@ const RULES = [
|
|
|
13507
13583
|
gateTrigger,
|
|
13508
13584
|
securityOneJob,
|
|
13509
13585
|
sharedCi,
|
|
13586
|
+
setupCue,
|
|
13510
13587
|
homePackage,
|
|
13511
13588
|
licenseFile,
|
|
13512
13589
|
pagesSite,
|
|
@@ -14388,6 +14465,6 @@ function runHook(args, io) {
|
|
|
14388
14465
|
git: (gitArgs) => runGit(io.cwd, gitArgs)
|
|
14389
14466
|
}, io);
|
|
14390
14467
|
}
|
|
14391
|
-
export { unreleasedChangeRule as $, mergeHomes as $t, typedFiles as A,
|
|
14468
|
+
export { unreleasedChangeRule as $, mergeHomes as $t, typedFiles as A, codePackages as An, nameMatches as At, roadmapParses as B, specifiersOf as Bn, licenseFileOf as Bt, versionTitle as C, summaryName as Cn, PRIVATE_NAME_LIST as Ct, typedScripts as D, cuePreset as Dn, isCommonUse as Dt, trustPolicy as E, STRICT_OPTIONS as En, isAllowedHit as Et, HOME_TIMEOUT_MS as F, matchesAny as Fn, hasImportMetaMain as Ft, publishedMinor as G, defaultOptions as Gn, messageOf as Gt, releaseFiles as H, globToRegExp as Hn, repositoryIsPublic as Ht, blockHash as I, parseJsonc as In, mainCheck as It, NPM_REGISTRY as J, HOMES as Jt, publishedMinorRule as K, parseConfig as Kn, repoOf as Kt, githubFetch as L, readJsonc as Ln, LICENSE_TEXTS as Lt, isSourcePath as M, inFolder as Mn, pathNameHit as Mt, pathsOf as N, keyLine as Nn, noBuildOutput as Nt, configsOfScript as O, DEPENDENCY_FIELDS as On, lineNameHit as Ot, sourceMain as P, lineOf as Pn, REAL_COMPARE as Pt, unreleasedChange as Q, mapText as Qt, sharedDocsRule as R, replaceLine as Rn, authorOf as Rt, setVersions as S, prPathFilters as Sn, privateTextBreaks as St, TRAIN_SCOPES as T, readWorkflow as Tn, firstNameMatch as Tt, lockedVersions as U, packageFolders as Un, declaredName as Ut, requiredScripts as V, globFolders as Vn, mitText as Vt, minorOf as W, workspaceGlobs as Wn, homePackage as Wt, UNSHIPPED_FILES as X, findHomes as Xt, SHIPPED_FIELDS as Y, MAP_RULE as Yt, npmLookup as Z, mapMarkdown as Zt, workspaceProtocol as _, securityOneJob as _n, PRIVATE_PATTERNS_VARIABLE as _t, listRules as a, hasTests as an, repositoryOfRemote as at, yamlFaults as b, convertGate as bn, privateNamesFile as bt, runCli as c, SHARED_CI as cn, pushMainOnly as ct, HOOK_MARKER as d, sharedCi as dn, pagesSite as dt, readOverlay as en, pipeFails as et, NO_READ_LINE as f, setupCue as fn, apiReportScript as ft, RULES as g, securityCallers as gn, PRIVATE_NAMES_FILE_VARIABLE as gt, prePush as h, SECURITY_TIMEOUT_MINUTES as hn, PRIVATE_NAMES_FILE_CONFIG as ht, formatResult as i, serviceRunMain as in, pagesAfterRelease as it, testsRequired as j, hasFile as jn, parsePrivateNames as jt, scriptsOf as k, cleanPath as kn, lineNameHits as kt, runFix as l, SHARED_WORKFLOWS as ln, PAGES_WORKFLOWS as lt, installHook as m, SECURITY_SCAN_INPUTS as mn, HOME_PATTERNS as mt, annotations as n, SERVICE_PACKAGE as nn, isPinned as nt, readConfig as o, tsconfigTest as on, runnerBudget as ot, PRE_PUSH_HOOK as p, SECURITY_SCAN_COMMIT as pn, DEFAULT_ALLOWED as pt, reachOf as q, signaturesOf as qt, createContext as r, runCalls as rn, pinnedGitDeps as rt, runChecks as s, SHARED_ACTIONS as sn, scheduleMinute as st, USAGE as t, HOME_EXPORTS as tn, isGitSpecifier as tt, summaryMarkdown as u, callsSharedCi as un, pagesCalls as ut, GITHUB_YAML as v, withOneJob as vn, invalidPatternBreaks as vt, IGNORE_AFTER as w, gateAfterCancel as wn, PrivateNameListError as wt, namedVersions as x, gateTrigger as xn, privatePatterns as xt, workflowParses as y, ACTIONS_COMMIT as yn, noLocalPaths as yt, roadmapOfLine as z, runGit as zn, licenseFile as zt };
|
|
14392
14469
|
|
|
14393
|
-
//# sourceMappingURL=run-
|
|
14470
|
+
//# sourceMappingURL=run-CWh6SR2w.js.map
|