@homeflare/alchemy 0.27.4 → 0.29.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 +2 -0
- package/dist/caddy/admin-address.d.ts +27 -0
- package/dist/caddy/admin-address.d.ts.map +1 -0
- package/dist/caddy/admin-calls.d.ts +25 -28
- package/dist/caddy/admin-calls.d.ts.map +1 -1
- package/dist/caddy/admin.d.ts +28 -38
- package/dist/caddy/admin.d.ts.map +1 -1
- package/dist/caddy/caddy-http-client.d.ts +25 -0
- package/dist/caddy/caddy-http-client.d.ts.map +1 -0
- package/dist/caddy/config-errors.d.ts +24 -0
- package/dist/caddy/config-errors.d.ts.map +1 -0
- package/dist/caddy/config-lifecycle.d.ts +20 -49
- package/dist/caddy/config-lifecycle.d.ts.map +1 -1
- package/dist/caddy/config-reconcile.d.ts +45 -0
- package/dist/caddy/config-reconcile.d.ts.map +1 -0
- package/dist/caddy/config.d.ts +4 -3
- package/dist/caddy/config.d.ts.map +1 -1
- package/dist/caddy/fake-caddy.d.ts +10 -2
- package/dist/caddy/fake-caddy.d.ts.map +1 -1
- package/dist/caddy/index.d.ts +3 -3
- package/dist/caddy/index.d.ts.map +1 -1
- package/dist/caddy/index.js +487 -444
- package/dist/caddy/index.js.map +16 -12
- package/dist/caddy/local-admin.d.ts +20 -34
- package/dist/caddy/local-admin.d.ts.map +1 -1
- package/dist/caddy/providers.d.ts +19 -3
- package/dist/caddy/providers.d.ts.map +1 -1
- package/dist/cloudflare/mesh-node-token.d.ts +1 -1
- package/dist/cloudflare/mesh-node-token.d.ts.map +1 -1
- package/dist/forgejo/branch-protection.d.ts +4 -4
- package/dist/forgejo/org-actions-secrets.d.ts +4 -4
- package/dist/forgejo/org-label.d.ts +4 -4
- package/dist/forgejo/org-team.d.ts +4 -4
- package/dist/forgejo/repo-webhook.d.ts +4 -4
- package/dist/forgejo/repository.d.ts +4 -4
- package/dist/forgejo/team-member.d.ts +4 -4
- package/dist/github/declare-repo-baseline.d.ts +1 -1
- package/dist/github/declare-repo-baseline.d.ts.map +1 -1
- package/dist/github/index.d.ts +9 -5
- package/dist/github/index.d.ts.map +1 -1
- package/dist/github/index.js +161 -25
- package/dist/github/index.js.map +15 -13
- package/dist/github/repo-baseline-data.d.ts +10 -1
- package/dist/github/repo-baseline-data.d.ts.map +1 -1
- package/dist/github/repo-policy.d.ts +1 -1
- package/dist/github/repo-policy.d.ts.map +1 -1
- package/dist/github/repository-ruleset-errors.d.ts +37 -3
- package/dist/github/repository-ruleset-errors.d.ts.map +1 -1
- package/dist/github/repository-ruleset-form.d.ts.map +1 -1
- package/dist/github/repository-ruleset-guards.d.ts +15 -2
- package/dist/github/repository-ruleset-guards.d.ts.map +1 -1
- package/dist/github/repository-ruleset-narrowing-guards.d.ts +39 -0
- package/dist/github/repository-ruleset-narrowing-guards.d.ts.map +1 -0
- package/dist/github/repository-ruleset-octokit.d.ts +49 -0
- package/dist/github/repository-ruleset-octokit.d.ts.map +1 -1
- package/dist/github/repository-ruleset-probe.d.ts +2 -1
- package/dist/github/repository-ruleset-probe.d.ts.map +1 -1
- package/dist/github/repository-ruleset-props.d.ts +91 -0
- package/dist/github/repository-ruleset-props.d.ts.map +1 -0
- package/dist/github/repository-ruleset-providers.d.ts +42 -0
- package/dist/github/repository-ruleset-providers.d.ts.map +1 -0
- package/dist/github/repository-ruleset-reconcile.d.ts.map +1 -1
- package/dist/github/repository-ruleset.d.ts +28 -34
- package/dist/github/repository-ruleset.d.ts.map +1 -1
- package/dist/litellm/fake-litellm.d.ts +27 -16
- package/dist/litellm/fake-litellm.d.ts.map +1 -1
- package/dist/litellm/fake-stack.d.ts +9 -4
- package/dist/litellm/fake-stack.d.ts.map +1 -1
- package/dist/litellm/index.d.ts +7 -5
- package/dist/litellm/index.d.ts.map +1 -1
- package/dist/litellm/index.js +53 -123
- package/dist/litellm/index.js.map +8 -8
- package/dist/litellm/operations.d.ts +60 -0
- package/dist/litellm/operations.d.ts.map +1 -0
- package/dist/litellm/pass-through-endpoint.d.ts +10 -28
- package/dist/litellm/pass-through-endpoint.d.ts.map +1 -1
- package/dist/litellm/pass-through-errors.d.ts +37 -0
- package/dist/litellm/pass-through-errors.d.ts.map +1 -0
- package/dist/litellm/pass-through-form.d.ts +11 -4
- package/dist/litellm/pass-through-form.d.ts.map +1 -1
- package/dist/litellm/providers.d.ts +7 -5
- package/dist/litellm/providers.d.ts.map +1 -1
- package/dist/netbox/prefix.d.ts +4 -4
- package/dist/paperless/custom-field.d.ts +21 -21
- package/dist/paperless/custom-field.d.ts.map +1 -1
- package/dist/paperless/document-type.d.ts +34 -4
- package/dist/paperless/document-type.d.ts.map +1 -1
- package/dist/paperless/fake-paperless.d.ts +36 -19
- package/dist/paperless/fake-paperless.d.ts.map +1 -1
- package/dist/paperless/index.d.ts +7 -2
- package/dist/paperless/index.d.ts.map +1 -1
- package/dist/paperless/index.js +164 -228
- package/dist/paperless/index.js.map +10 -13
- package/dist/paperless/matching-locate.d.ts +42 -20
- package/dist/paperless/matching-locate.d.ts.map +1 -1
- package/dist/paperless/matching-types.d.ts +47 -18
- package/dist/paperless/matching-types.d.ts.map +1 -1
- package/dist/paperless/matching.d.ts +30 -27
- package/dist/paperless/matching.d.ts.map +1 -1
- package/dist/paperless/providers.d.ts +13 -7
- package/dist/paperless/providers.d.ts.map +1 -1
- package/dist/paperless/storage-path.d.ts +34 -4
- package/dist/paperless/storage-path.d.ts.map +1 -1
- package/dist/paperless/tag.d.ts +43 -8
- package/dist/paperless/tag.d.ts.map +1 -1
- package/dist/proxmox/acl.d.ts +30 -23
- package/dist/proxmox/acl.d.ts.map +1 -1
- package/dist/proxmox/distilled-pve.d.ts +89 -0
- package/dist/proxmox/distilled-pve.d.ts.map +1 -0
- package/dist/proxmox/index.js +663 -609
- package/dist/proxmox/index.js.map +12 -11
- package/dist/proxmox/members.d.ts +29 -10
- package/dist/proxmox/members.d.ts.map +1 -1
- package/docs/caddy-admin.md +1 -1
- package/docs/caddy.md +3 -2
- package/docs/credentials.md +16 -0
- package/docs/litellm.md +21 -13
- package/docs/paperless.md +12 -0
- package/docs/peers.md +5 -0
- package/docs/repo-policy.md +16 -1
- package/docs/repository-ruleset.md +53 -13
- package/docs/upstream-conformance.md +126 -10
- package/package.json +9 -2
- package/src/caddy/admin-address.ts +71 -0
- package/src/caddy/admin-calls.ts +48 -100
- package/src/caddy/admin.ts +37 -41
- package/src/caddy/adopt-scope.test.ts +1 -1
- package/src/caddy/caddy-http-client.ts +229 -0
- package/src/caddy/config-adopt-provider.test.ts +139 -0
- package/src/caddy/config-adopt.test.ts +60 -126
- package/src/caddy/config-errors.ts +47 -0
- package/src/caddy/config-lifecycle.test.ts +55 -42
- package/src/caddy/config-lifecycle.ts +72 -162
- package/src/caddy/config-reconcile.ts +138 -0
- package/src/caddy/config.ts +36 -42
- package/src/caddy/fake-caddy.ts +20 -2
- package/src/caddy/index.ts +3 -8
- package/src/caddy/local-admin.test.ts +35 -21
- package/src/caddy/local-admin.ts +60 -167
- package/src/caddy/providers.test.ts +14 -6
- package/src/caddy/providers.ts +20 -4
- package/src/github/declare-repo-baseline.ts +6 -6
- package/src/github/index.ts +10 -4
- package/src/github/repo-baseline-data.test.ts +13 -0
- package/src/github/repo-baseline-data.ts +11 -2
- package/src/github/repo-policy-stack.test.ts +59 -0
- package/src/github/repo-policy.ts +3 -2
- package/src/github/repository-ruleset-errors.ts +51 -4
- package/src/github/repository-ruleset-exact-adopt-k1.test.ts +109 -0
- package/src/github/repository-ruleset-exact-adopt.test.ts +184 -0
- package/src/github/repository-ruleset-form.ts +7 -3
- package/src/github/repository-ruleset-guards.ts +11 -4
- package/src/github/repository-ruleset-narrowing-guards.ts +141 -0
- package/src/github/repository-ruleset-narrowing.test.ts +210 -0
- package/src/github/repository-ruleset-octokit.test.ts +141 -0
- package/src/github/repository-ruleset-octokit.ts +121 -30
- package/src/github/repository-ruleset-probe.ts +2 -1
- package/src/github/repository-ruleset-props.ts +95 -0
- package/src/github/repository-ruleset-providers.ts +46 -0
- package/src/github/repository-ruleset-reconcile.ts +35 -0
- package/src/github/repository-ruleset-wire.test.ts +38 -27
- package/src/github/repository-ruleset-write-refusals.test.ts +6 -26
- package/src/github/repository-ruleset.ts +53 -43
- package/src/litellm/fake-litellm.ts +83 -78
- package/src/litellm/fake-stack.ts +13 -5
- package/src/litellm/index.ts +7 -21
- package/src/litellm/operations.ts +149 -0
- package/src/litellm/pass-through-endpoint-delete-swallow.test.ts +17 -20
- package/src/litellm/pass-through-endpoint-replace.test.ts +3 -4
- package/src/litellm/pass-through-endpoint.test.ts +8 -8
- package/src/litellm/pass-through-endpoint.ts +21 -31
- package/src/litellm/pass-through-errors.ts +37 -0
- package/src/litellm/pass-through-form.ts +20 -10
- package/src/litellm/providers.ts +8 -7
- package/src/paperless/custom-field.test.ts +49 -40
- package/src/paperless/custom-field.ts +57 -33
- package/src/paperless/document-type.test.ts +48 -0
- package/src/paperless/document-type.ts +51 -22
- package/src/paperless/fake-paperless.ts +63 -72
- package/src/paperless/index.ts +7 -13
- package/src/paperless/matching-locate.test.ts +102 -0
- package/src/paperless/matching-locate.ts +80 -86
- package/src/paperless/matching-types.ts +49 -16
- package/src/paperless/matching.ts +77 -90
- package/src/paperless/providers.ts +14 -10
- package/src/paperless/storage-path.test.ts +56 -0
- package/src/paperless/storage-path.ts +53 -24
- package/src/paperless/tag-identity.test.ts +127 -0
- package/src/paperless/tag.test.ts +100 -0
- package/src/paperless/tag.ts +62 -32
- package/src/proxmox/acl.test.ts +145 -0
- package/src/proxmox/acl.ts +128 -150
- package/src/proxmox/distilled-pve.test.ts +231 -0
- package/src/proxmox/distilled-pve.ts +147 -0
- package/src/proxmox/members-timeout.test.ts +161 -0
- package/src/proxmox/members.test.ts +9 -0
- package/src/proxmox/members.ts +36 -2
- package/dist/litellm/client.d.ts +0 -76
- package/dist/litellm/client.d.ts.map +0 -1
- package/dist/litellm/credentials.d.ts +0 -48
- package/dist/litellm/credentials.d.ts.map +0 -1
- package/dist/litellm/generated/pass-through.d.ts +0 -71
- package/dist/litellm/generated/pass-through.d.ts.map +0 -1
- package/dist/paperless/client.d.ts +0 -37
- package/dist/paperless/client.d.ts.map +0 -1
- package/dist/paperless/credentials.d.ts +0 -40
- package/dist/paperless/credentials.d.ts.map +0 -1
- package/dist/paperless/errors.d.ts +0 -49
- package/dist/paperless/errors.d.ts.map +0 -1
- package/src/litellm/client.ts +0 -195
- package/src/litellm/credentials.ts +0 -73
- package/src/litellm/generated/pass-through.ts +0 -73
- package/src/paperless/client.ts +0 -88
- package/src/paperless/credentials.ts +0 -69
- package/src/paperless/errors.ts +0 -62
- package/src/paperless/matching-identity.test.ts +0 -194
- package/src/paperless/matching.test.ts +0 -128
|
@@ -19,7 +19,16 @@ export interface RepoBaselineInput {
|
|
|
19
19
|
}
|
|
20
20
|
/** `GitHub.Repository` fields this baseline owns. Every merge-automation caller across the 17
|
|
21
21
|
* tray checkouts uses `--squash` (measured 2026-09-23; the only non-squash mentions are
|
|
22
|
-
* GitLab-era comments in cliff.toml), so squash-only is not a per-repo choice.
|
|
22
|
+
* GitLab-era comments in cliff.toml), so squash-only is not a per-repo choice.
|
|
23
|
+
*
|
|
24
|
+
* ⛔ K5 (2026-09-24): `allowAutoMerge` FOLLOWS `checks.length`, NOT A HARDCODED `true`. `gh pr
|
|
25
|
+
* merge --auto` (and the ruleset's own auto-merge) is a queue only while something is
|
|
26
|
+
* outstanding — with zero required status checks there is nothing to wait for, so GitHub
|
|
27
|
+
* merges a CLEAN pull request on the spot, with no review and no green run. This is the same
|
|
28
|
+
* failure `repo-policy-guards.ts`'s `assertAutoMergeWaits` refuses on the sibling `repoPolicy`
|
|
29
|
+
* path (five doors to the same "nothing outstanding" state); this baseline has no `autoMerge`
|
|
30
|
+
* opt-out prop to refuse WITH, so the fix here is unconditional rather than a thrown refusal —
|
|
31
|
+
* a repo with an empty `checks` list simply never gets auto-merge turned on by this baseline. */
|
|
23
32
|
export declare function repoBaselineSettings(input: RepoBaselineInput): {
|
|
24
33
|
owner: string;
|
|
25
34
|
name: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repo-baseline-data.d.ts","sourceRoot":"","sources":["../../src/github/repo-baseline-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED
|
|
1
|
+
{"version":3,"file":"repo-baseline-data.d.ts","sourceRoot":"","sources":["../../src/github/repo-baseline-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;mGAWmG;AACnG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB;;;;;;;;;;;EAa5D;AAED;;mGAEmG;AACnG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB;;;;YAKhD,QAAQ;iBACH,QAAQ;;;QAEP,OAAO;QAAuB,OAAO;;;;;;YAK/C,4BAA4B;YAC5B,yBAAyB;YACzB,sBAAsB;YACtB,uBAAuB;YACvB,8BAA8B;YAC9B,mBAAmB;YACnB,mCAAmC;;;YAM7B,MAAM;;;YACN,gCAAgC;YAChC,oBAAoB;;;EAKjC;AAED;;;cAGc;AACd,eAAO,MAAM,wBAAwB,YACnC,0BAA0B,EAC1B,0CAA0C,EAC1C,0CAA0C,EAC1C,6CAA6C,CACrC,CAAC"}
|
|
@@ -17,5 +17,5 @@ export declare const declareRepoPolicy: (id: string, options: DeclareRepoPolicyO
|
|
|
17
17
|
policy: import("./repo-policy-form.ts").RepoPolicy;
|
|
18
18
|
repository: GitHub.Repository;
|
|
19
19
|
ruleset: RepositoryRuleset;
|
|
20
|
-
}, Error,
|
|
20
|
+
}, Error, import("alchemy").Provider<RepositoryRuleset> | GitHub.Providers>;
|
|
21
21
|
//# sourceMappingURL=repo-policy.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repo-policy.d.ts","sourceRoot":"","sources":["../../src/github/repo-policy.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"repo-policy.d.ts","sourceRoot":"","sources":["../../src/github/repo-policy.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,OAAQ,MAAM,WAAW,wBAAwB;;;;2EAkB3E,CAAC"}
|
|
@@ -27,6 +27,39 @@ export declare class BypassActorWidened extends BypassActorWidened_base<{
|
|
|
27
27
|
}> {
|
|
28
28
|
get message(): string;
|
|
29
29
|
}
|
|
30
|
+
declare const BypassActorNarrowed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
|
|
31
|
+
readonly _tag: "BypassActorNarrowed";
|
|
32
|
+
} & Readonly<A>;
|
|
33
|
+
/** A declared `bypassActors` drops an actor the live ruleset has, with no
|
|
34
|
+
* `acknowledgeBypassNarrowing` on the declaration. Unlike widening, narrowing is not always
|
|
35
|
+
* wrong — an exact-adopt declaration that matches live exactly narrows nothing — so this is
|
|
36
|
+
* refused only when live genuinely has more than the declaration keeps, and it is escapable
|
|
37
|
+
* (`BypassActorWidened` is not): see `bypassNarrowingRefusal` in
|
|
38
|
+
* repository-ruleset-narrowing-guards.ts. */
|
|
39
|
+
export declare class BypassActorNarrowed extends BypassActorNarrowed_base<{
|
|
40
|
+
readonly owner: string;
|
|
41
|
+
readonly repository: string;
|
|
42
|
+
readonly name: string;
|
|
43
|
+
readonly narrowed: readonly string[];
|
|
44
|
+
}> {
|
|
45
|
+
get message(): string;
|
|
46
|
+
}
|
|
47
|
+
declare const RuleNarrowed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
|
|
48
|
+
readonly _tag: "RuleNarrowed";
|
|
49
|
+
} & Readonly<A>;
|
|
50
|
+
/** A rule type the declaration explicitly marks absent (`false`) while the live ruleset still
|
|
51
|
+
* has it, with no `acknowledgeRuleNarrowing` on the declaration — see `ruleNarrowingRefusal` in
|
|
52
|
+
* repository-ruleset-narrowing-guards.ts. Distinct from `UndeclaredLiveRule`: that one fires on
|
|
53
|
+
* SILENCE (the declaration says nothing); this one fires on an EXPLICIT, but unacknowledged,
|
|
54
|
+
* removal. */
|
|
55
|
+
export declare class RuleNarrowed extends RuleNarrowed_base<{
|
|
56
|
+
readonly owner: string;
|
|
57
|
+
readonly repository: string;
|
|
58
|
+
readonly name: string;
|
|
59
|
+
readonly ruleType: string;
|
|
60
|
+
}> {
|
|
61
|
+
get message(): string;
|
|
62
|
+
}
|
|
30
63
|
declare const UndeclaredLiveRule_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
|
|
31
64
|
readonly _tag: "UndeclaredLiveRule";
|
|
32
65
|
} & Readonly<A>;
|
|
@@ -57,8 +90,9 @@ export declare class RequiredChecksOmitted extends RequiredChecksOmitted_base<{
|
|
|
57
90
|
declare const NeverReportedContext_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
|
|
58
91
|
readonly _tag: "NeverReportedContext";
|
|
59
92
|
} & Readonly<A>;
|
|
60
|
-
/** A context being ADDED to `requiredStatusChecks` has never reported success
|
|
61
|
-
* branch
|
|
93
|
+
/** A context being ADDED to `requiredStatusChecks` has never reported success anywhere this
|
|
94
|
+
* family looks (the default branch's tip, then recent merged PR heads — K2, bounded, not full
|
|
95
|
+
* history). Requiring it would leave every future pull request pending forever. */
|
|
62
96
|
export declare class NeverReportedContext extends NeverReportedContext_base<{
|
|
63
97
|
readonly owner: string;
|
|
64
98
|
readonly repository: string;
|
|
@@ -92,6 +126,6 @@ export declare class ReadbackMismatch extends ReadbackMismatch_base<{
|
|
|
92
126
|
}> {
|
|
93
127
|
get message(): string;
|
|
94
128
|
}
|
|
95
|
-
export type RepositoryRulesetError = DuplicateRuleset | BypassActorWidened | UndeclaredLiveRule | RequiredChecksOmitted | NeverReportedContext | RulesetConstraintRefused | ReadbackMismatch;
|
|
129
|
+
export type RepositoryRulesetError = DuplicateRuleset | BypassActorWidened | BypassActorNarrowed | UndeclaredLiveRule | RuleNarrowed | RequiredChecksOmitted | NeverReportedContext | RulesetConstraintRefused | ReadbackMismatch;
|
|
96
130
|
export {};
|
|
97
131
|
//# sourceMappingURL=repository-ruleset-errors.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository-ruleset-errors.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-errors.ts"],"names":[],"mappings":";;;AAQA;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,sBAAqC;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,CAAC;IACA,IAAa,OAAO,IAAI,MAAM,CAM7B;CACF;;;;AAED;6EAC6E;AAC7E,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;IACA,IAAa,OAAO,IAAI,MAAM,CAM7B;CACF;;;;AAED;;yEAEyE;AACzE,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;IACA,IAAa,OAAO,IAAI,MAAM,CAO7B;CACF;;;;AAED;6FAC6F;AAC7F,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;IACA,IAAa,OAAO,IAAI,MAAM,CAO7B;CACF;;;;AAED;
|
|
1
|
+
{"version":3,"file":"repository-ruleset-errors.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-errors.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository-ruleset-form.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,sBAAsB,EAEtB,sBAAsB,EAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;
|
|
1
|
+
{"version":3,"file":"repository-ruleset-form.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,sBAAsB,EAEtB,sBAAsB,EAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AA+DvF,wBAAgB,cAAc,CAAC,KAAK,EAAE,sBAAsB,GAAG,SAAS,GAAG,QAAQ,EAAE,CAmCpF;AAED;0BAC0B;AAC1B,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CAqBnF;AA+CD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiB/D"}
|
|
@@ -7,6 +7,14 @@ import * as Effect from 'effect/Effect';
|
|
|
7
7
|
import type { RepositoryRulesetProps } from './repository-ruleset.ts';
|
|
8
8
|
import { BypassActorWidened, NeverReportedContext, RequiredChecksOmitted, UndeclaredLiveRule } from './repository-ruleset-errors.ts';
|
|
9
9
|
import type { RulesetOctokit, RulesetRecord } from './repository-ruleset-probe.ts';
|
|
10
|
+
/** Exported: repository-ruleset-narrowing-guards.ts reuses the identical key so a widened and a
|
|
11
|
+
* narrowed actor are never computed by two independently-drifting definitions of "the same
|
|
12
|
+
* actor". */
|
|
13
|
+
export declare const bypassKey: (a: {
|
|
14
|
+
actor_type: unknown;
|
|
15
|
+
actor_id: unknown;
|
|
16
|
+
bypass_mode?: unknown;
|
|
17
|
+
}) => string;
|
|
10
18
|
/**
|
|
11
19
|
* ⛔ A CREATE REQUIRES `[]`; `undefined` on a create is the same thing (nothing live to widen
|
|
12
20
|
* from). On an update/adopt, `undefined` means unmanaged — the caller never sees this guard
|
|
@@ -20,6 +28,10 @@ export declare function bypassWideningRefusal(input: {
|
|
|
20
28
|
readonly declared: RepositoryRulesetProps['bypassActors'];
|
|
21
29
|
readonly live: RulesetRecord | undefined;
|
|
22
30
|
}): BypassActorWidened | undefined;
|
|
31
|
+
/** Exported for the same reason as `bypassKey` — repository-ruleset-narrowing-guards.ts's
|
|
32
|
+
* `ruleNarrowingRefusal` needs the identical live-type set `undeclaredLiveRuleRefusal` computes,
|
|
33
|
+
* not a second reading of `live.rules` that could disagree with this one. */
|
|
34
|
+
export declare const liveRuleTypes: (live: RulesetRecord | undefined) => Set<string>;
|
|
23
35
|
/**
|
|
24
36
|
* Refuses (a) any live rule of a REFUSED type — this resource can never represent it, and the
|
|
25
37
|
* PUT replaces `rules` wholesale, so silence would drop it; and (b) ANY live rule of a MODELED
|
|
@@ -64,7 +76,8 @@ export declare function requiredChecksOmissionRefusal(input: {
|
|
|
64
76
|
/** Every context in the declared `requiredStatusChecks` that the LIVE ruleset does not already
|
|
65
77
|
* require — i.e. being added by this plan, the only case a never-reported context can matter. */
|
|
66
78
|
export declare const newlyRequiredContexts: (declared: RepositoryRulesetProps['rules'], live: RulesetRecord | undefined) => readonly string[];
|
|
67
|
-
/** Fails on the first newly-required context that has never reported success
|
|
68
|
-
*
|
|
79
|
+
/** Fails on the first newly-required context that has never reported success anywhere this
|
|
80
|
+
* family looks (the default branch's tip, then recent merged PR heads — K2) — checked once here
|
|
81
|
+
* (reconcile's observe step) and again by the standalone checker. */
|
|
69
82
|
export declare const refuseUnreportedContexts: <R = never>(octokit: RulesetOctokit<R>, owner: string, repo: string, contexts: readonly string[]) => Effect.Effect<void, NeverReportedContext | Error, R>;
|
|
70
83
|
//# sourceMappingURL=repository-ruleset-guards.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository-ruleset-guards.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"repository-ruleset-guards.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnF;;aAEa;AACb,eAAO,MAAM,SAAS,MAAO;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,WACF,CAAC;AAE7F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;CAC1C,GAAG,kBAAkB,GAAG,SAAS,CAyBjC;AAED;;6EAE6E;AAC7E,eAAO,MAAM,aAAa,SAAU,aAAa,GAAG,SAAS,KAAG,GAAG,CAAC,MAAM,CACjB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7C,GAAG,kBAAkB,GAAG,SAAS,CAyBjC;AAED;;wFAEwF;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAgB7F;AAED;6FAC6F;AAC7F,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;CAC1C,GAAG,qBAAqB,GAAG,SAAS,CAcpC;AAED;iGACiG;AACjG,eAAO,MAAM,qBAAqB,aACtB,sBAAsB,CAAC,OAAO,CAAC,QACnC,aAAa,GAAG,SAAS,KAC9B,SAAS,MAAM,EAWjB,CAAC;AAEF;;qEAEqE;AACrE,eAAO,MAAM,wBAAwB,GAAI,CAAC,GAAG,KAAK,WACvC,cAAc,CAAC,CAAC,CAAC,SACnB,MAAM,QACP,MAAM,YACF,SAAS,MAAM,EAAE,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,KAAK,EAAE,CAAC,CAQlD,CAAC"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { BypassActorNarrowed, RuleNarrowed } from './repository-ruleset-errors.ts';
|
|
2
|
+
import type { RepositoryRulesetProps } from './repository-ruleset-props.ts';
|
|
3
|
+
import type { RulesetRecord } from './repository-ruleset-probe.ts';
|
|
4
|
+
/** `true` only for a non-empty, non-whitespace `reason` on `acknowledgeBypassNarrowing` — a bare
|
|
5
|
+
* `{}` or a blank string is not an acknowledgement (repository-ruleset.ts's `constraintRefusal`
|
|
6
|
+
* refuses the latter at plan time; this is the read `bypassNarrowingRefusal` shares). Deliberately
|
|
7
|
+
* ignorant of `acknowledgeRuleNarrowing` — see the file header. */
|
|
8
|
+
export declare const isBypassNarrowingAcknowledged: (props: RepositoryRulesetProps) => boolean;
|
|
9
|
+
/** The `rules`-side counterpart to `isBypassNarrowingAcknowledged`, reading only
|
|
10
|
+
* `acknowledgeRuleNarrowing` — see the file header. */
|
|
11
|
+
export declare const isRuleNarrowingAcknowledged: (props: RepositoryRulesetProps) => boolean;
|
|
12
|
+
/**
|
|
13
|
+
* A live bypass actor the declaration drops, unacknowledged. `undefined` `declared` never
|
|
14
|
+
* reaches here — same rule as `bypassWideningRefusal`: unmanaged means the live value is
|
|
15
|
+
* preserved unchanged (repository-ruleset-reconcile.ts), so there is nothing to narrow.
|
|
16
|
+
*/
|
|
17
|
+
export declare function bypassNarrowingRefusal(input: {
|
|
18
|
+
readonly owner: string;
|
|
19
|
+
readonly repository: string;
|
|
20
|
+
readonly name: string;
|
|
21
|
+
readonly declared: RepositoryRulesetProps['bypassActors'];
|
|
22
|
+
readonly live: RulesetRecord | undefined;
|
|
23
|
+
readonly acknowledged: boolean;
|
|
24
|
+
}): BypassActorNarrowed | undefined;
|
|
25
|
+
/**
|
|
26
|
+
* A rule the declaration explicitly marks absent (a boolean rule or `pullRequest` declared
|
|
27
|
+
* `false`, or `requiredStatusChecks: false`) while the LIVE ruleset still has it, unacknowledged
|
|
28
|
+
* — the drop `undeclaredLiveRuleRefusal` (repository-ruleset-guards.ts) never sees, because an
|
|
29
|
+
* explicit `false` IS "declared" there (see its own `declaredRuleTypes`).
|
|
30
|
+
*/
|
|
31
|
+
export declare function ruleNarrowingRefusal(input: {
|
|
32
|
+
readonly owner: string;
|
|
33
|
+
readonly repository: string;
|
|
34
|
+
readonly name: string;
|
|
35
|
+
readonly declared: RepositoryRulesetProps['rules'];
|
|
36
|
+
readonly live: RulesetRecord | undefined;
|
|
37
|
+
readonly acknowledged: boolean;
|
|
38
|
+
}): RuleNarrowed | undefined;
|
|
39
|
+
//# sourceMappingURL=repository-ruleset-narrowing-guards.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repository-ruleset-narrowing-guards.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-narrowing-guards.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAA0B,MAAM,+BAA+B,CAAC;AACpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;mEAGmE;AACnE,eAAO,MAAM,6BAA6B,UAAW,sBAAsB,KAAG,OAEnB,CAAC;AAE5D;uDACuD;AACvD,eAAO,MAAM,2BAA2B,UAAW,sBAAsB,KAAG,OAEnB,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,GAAG,mBAAmB,GAAG,SAAS,CAyBlC;AA0BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,GAAG,YAAY,GAAG,SAAS,CAiB3B"}
|
|
@@ -1,5 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The real {@link RulesetOctokit} — every wire call this family makes, built from the EXPORTED
|
|
3
|
+
* `GitHubCredentials` service via `creds.octokit()`, exactly upstream's own `octokitFor` does
|
|
4
|
+
* (`node_modules/alchemy/src/GitHub/Octokit.ts`). H15: Octokit, not `@distilled.cloud/github`
|
|
5
|
+
* — its `S.Struct` request schemas have no field for `require_extra_approval_for_unattributed_
|
|
6
|
+
* changes` and would very likely strip an unknown key on encode; Octokit's REST methods hand
|
|
7
|
+
* their `parameters` object to `@octokit/endpoint` mostly as-is, so an extra JSON body key
|
|
8
|
+
* should reach the wire. repository-ruleset-wire.test.ts MEASURES this against a real Octokit
|
|
9
|
+
* instance with a fetch shim rather than asserting it from reading the source.
|
|
10
|
+
*
|
|
11
|
+
* ★ K2 (2026-09-24): "REPORTED SUCCESS" IS THE DEFAULT BRANCH'S TIP, THEN RECENT MERGED PR
|
|
12
|
+
* HEADS — NOT FULL HISTORY. The rendered CI (`packages/config/src/repo-shape/ci.ts`) triggers
|
|
13
|
+
* on `pull_request` ONLY, deliberately (measured 2026-09-15..22: 613 of 619 main-push runs
|
|
14
|
+
* duplicated an already-green PR run, ~41% of the mini's CI load) — so `ci`/`secret scan`/
|
|
15
|
+
* `CodeQL` NEVER report on the default branch's tip itself, only on PR heads. Checking the tip
|
|
16
|
+
* alone therefore refused adding any of them everywhere, including homeflare-builds' pending
|
|
17
|
+
* first ruleset. `contextReportedSuccess` now falls back to `recentMergedHeadShas` — bounded
|
|
18
|
+
* (`RECENT_MERGED_PR_LIMIT` heads, from one `per_page`-bounded list call, never the repo's
|
|
19
|
+
* full PR history) — so a context that only ever reports on PR heads is no longer refused
|
|
20
|
+
* everywhere, while a context that has never reported ANYWHERE (not the tip, not any recent
|
|
21
|
+
* merged head) still is: `NeverReportedContext`'s whole purpose survives unchanged.
|
|
22
|
+
* ⚠️ Still not full history: a context whose only successful run predates
|
|
23
|
+
* `RECENT_MERGED_PR_LIMIT` merges ago reads as never-reported until it runs again. Widening
|
|
24
|
+
* the bound trades this guard's cost (more vendor calls per newly-required context) against
|
|
25
|
+
* its reach; `RECENT_MERGED_PR_LIMIT` is a deliberate, named number for exactly that reason,
|
|
26
|
+
* not a magic constant.
|
|
27
|
+
*/
|
|
28
|
+
import type { Octokit as OctokitClient } from '@octokit/rest';
|
|
1
29
|
import { GitHubCredentials } from 'alchemy/GitHub';
|
|
30
|
+
import * as Effect from 'effect/Effect';
|
|
2
31
|
import type { RulesetOctokit } from './repository-ruleset-probe.ts';
|
|
3
32
|
export type RealRulesetOctokit = RulesetOctokit<GitHubCredentials>;
|
|
33
|
+
/** How many of the most-recently-updated MERGED pull requests' head SHAs to check, once the
|
|
34
|
+
* default branch's own tip has no reported success — see the file header (K2). */
|
|
35
|
+
export declare const RECENT_MERGED_PR_LIMIT = 10;
|
|
36
|
+
/** Whether `context` reported success for a single ref — a branch tip or a PR head SHA, both
|
|
37
|
+
* checked the same way (checks + statuses, exactly as GitHub's own UI does). Takes a plain
|
|
38
|
+
* `OctokitClient`, not an Effect service, so it and its caller below are testable directly
|
|
39
|
+
* against a real `@octokit/rest` instance with a fetch shim (repository-ruleset-octokit.test.ts)
|
|
40
|
+
* — no `GitHubCredentials` layer needed, mirroring `desiredWireRuleset`'s pure-function seam. */
|
|
41
|
+
export declare const hasRefReportedSuccess: (octokit: OctokitClient, owner: string, repo: string, ref: string, context: string) => Effect.Effect<boolean, Error>;
|
|
42
|
+
/** The head SHAs of up to `RECENT_MERGED_PR_LIMIT` most-recently-updated MERGED pull requests
|
|
43
|
+
* against `base` — one bounded list call (`RECENT_CLOSED_PR_PAGE_SIZE` closed PRs), filtered to
|
|
44
|
+
* merged, then capped. Never paginates further: a repo whose last `RECENT_MERGED_PR_LIMIT`
|
|
45
|
+
* merges are all older than its last `RECENT_CLOSED_PR_PAGE_SIZE` closed PRs simply yields fewer
|
|
46
|
+
* than the limit, same as a repo with too little history — both are the "still refused" case. */
|
|
47
|
+
export declare const recentMergedHeadShas: (octokit: OctokitClient, owner: string, repo: string, base: string) => Effect.Effect<readonly string[], Error>;
|
|
48
|
+
/** The full K2 answer: the default branch's tip, then (only if the tip has no success) up to
|
|
49
|
+
* `RECENT_MERGED_PR_LIMIT` recent merged PR heads, short-circuiting on the first success. `false`
|
|
50
|
+
* only once every one of those has been checked and none reported — the case
|
|
51
|
+
* `NeverReportedContext` exists to refuse. */
|
|
52
|
+
export declare const contextReportedSuccess: (octokit: OctokitClient, owner: string, repo: string, context: string) => Effect.Effect<boolean, Error>;
|
|
4
53
|
export declare const makeRulesetOctokit: (baseUrl: string | undefined) => RealRulesetOctokit;
|
|
5
54
|
//# sourceMappingURL=repository-ruleset-octokit.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository-ruleset-octokit.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-octokit.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"repository-ruleset-octokit.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-octokit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,cAAc,EAAiC,MAAM,+BAA+B,CAAC;AAEnG,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;AAcnE;kFACkF;AAClF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAczC;;;;iGAIiG;AACjG,eAAO,MAAM,qBAAqB,YACvB,aAAa,SACf,MAAM,QACP,MAAM,OACP,MAAM,WACF,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAmB3B,CAAC;AAEL;;;;iGAIiG;AACjG,eAAO,MAAM,oBAAoB,YACtB,aAAa,SACf,MAAM,QACP,MAAM,QACN,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,KAAK,CAmBrC,CAAC;AAEL;;;8CAG8C;AAC9C,eAAO,MAAM,sBAAsB,YACxB,aAAa,SACf,MAAM,QACP,MAAM,WACH,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAc3B,CAAC;AAEL,eAAO,MAAM,kBAAkB,YAAa,MAAM,GAAG,SAAS,KAAG,kBA+E/D,CAAC"}
|
|
@@ -64,7 +64,8 @@ export interface RulesetOctokit<R = never> {
|
|
|
64
64
|
readonly repo: string;
|
|
65
65
|
readonly rulesetId: number;
|
|
66
66
|
}) => Effect.Effect<void, Error, R>;
|
|
67
|
-
/** Whether `context` has
|
|
67
|
+
/** Whether `context` has reported success against the repository's default branch tip OR a
|
|
68
|
+
* recent merged PR head (K2, bounded — see repository-ruleset-octokit.ts's file header) —
|
|
68
69
|
* backs the `NeverReportedContext` guard. */
|
|
69
70
|
readonly hasContextReportedSuccess: (input: {
|
|
70
71
|
readonly owner: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository-ruleset-probe.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMlE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;;wFAIwF;AACxF,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,KAAK;IACvC;sFACkF;IAClF,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACzD,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;KAClC,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;KAClC,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7C,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACpC;
|
|
1
|
+
{"version":3,"file":"repository-ruleset-probe.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-probe.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `GitHub.RepositoryRuleset`'s declared shape — split out of repository-ruleset.ts purely to
|
|
3
|
+
* keep that file (the provider wiring) under the 250-line cap; nothing here is provider logic.
|
|
4
|
+
*/
|
|
5
|
+
import type { RulesetProps } from 'alchemy/GitHub';
|
|
6
|
+
type UpstreamRules = NonNullable<RulesetProps['rules']>;
|
|
7
|
+
export interface RepositoryRulesetReviewerRule {
|
|
8
|
+
readonly filePatterns: readonly string[];
|
|
9
|
+
readonly minimumApprovals: number;
|
|
10
|
+
readonly reviewer: {
|
|
11
|
+
readonly actorId: number;
|
|
12
|
+
readonly actorType: 'Team';
|
|
13
|
+
};
|
|
14
|
+
}
|
|
15
|
+
export interface RepositoryRulesetPullRequestRule extends NonNullable<UpstreamRules['pullRequest']> {
|
|
16
|
+
/** @default every method GitHub allows — the house baseline always pins `['squash']`. */
|
|
17
|
+
readonly allowedMergeMethods?: readonly ('merge' | 'squash' | 'rebase')[];
|
|
18
|
+
readonly requiredReviewers?: readonly RepositoryRulesetReviewerRule[];
|
|
19
|
+
/** `require_extra_approval_for_unattributed_changes` — see repository-ruleset.ts's H15.
|
|
20
|
+
* Both values are modeled (K1, 2026-09-23): 8 live rulesets carry `true` (aop, cloudflareforms,
|
|
21
|
+
* doesthishelp-workeropen, homeflare-anyauth, homeflare-desktop, loggarr, magictransit,
|
|
22
|
+
* proxmox-tb4 — re-read live via `gh api repos/taslabs-net/<repo>/rulesets/<id>`,
|
|
23
|
+
* 2026-09-23), and this resource declares exactly what is live or it cannot adopt them —
|
|
24
|
+
* `undefined` stays "no opinion" (GitHub defaults an absent key to `true`). */
|
|
25
|
+
readonly extraApprovalForUnattributedChanges?: boolean;
|
|
26
|
+
}
|
|
27
|
+
export interface RepositoryRulesetStatusChecksRule extends NonNullable<UpstreamRules['requiredStatusChecks']> {
|
|
28
|
+
readonly doNotEnforceOnCreate?: boolean;
|
|
29
|
+
}
|
|
30
|
+
export interface RepositoryRulesetRules extends Omit<UpstreamRules, 'pullRequest' | 'requiredStatusChecks'> {
|
|
31
|
+
/** `undefined`: no opinion (refused if the live ruleset already has one and this is not an
|
|
32
|
+
* exact-adopt pass-through — see repository-ruleset-guards.ts's `undeclaredLiveRuleRefusal`).
|
|
33
|
+
* `false`: declare its ABSENCE — either "this repo never had one" (a create, or an adopt
|
|
34
|
+
* where live already has none, both no-ops) or a deliberate removal of a live rule, which
|
|
35
|
+
* `ruleNarrowingRefusal` gates behind `acknowledgeRuleNarrowing` (see below). Added 2026-09-23 for
|
|
36
|
+
* exact-adopt pass-through: `requiredStatusChecks` already had this `false` escape; `deletion`/
|
|
37
|
+
* `nonFastForward`/etc already have it implicitly (plain `boolean`, so `false` is already a
|
|
38
|
+
* value); `pullRequest` was the one modeled rule with NO way to express "not present at all" —
|
|
39
|
+
* a repo like `taslabs-net/taslabs-net` (measured live 2026-09-23: `rules = [deletion,
|
|
40
|
+
* non_fast_forward]`, no `pull_request`) could not be adopted through this resource without
|
|
41
|
+
* either refusing to omit the key (a type error) or silently declaring a brand-new rule. */
|
|
42
|
+
readonly pullRequest?: RepositoryRulesetPullRequestRule | false;
|
|
43
|
+
/** `undefined`: no opinion (refused if the live ruleset already has one — see
|
|
44
|
+
* repository-ruleset-guards.ts). `false`: declare its ABSENCE — removes a live one. */
|
|
45
|
+
readonly requiredStatusChecks?: RepositoryRulesetStatusChecksRule | false;
|
|
46
|
+
}
|
|
47
|
+
export interface RepositoryRulesetProps extends Omit<RulesetProps, 'rules'> {
|
|
48
|
+
readonly rules?: RepositoryRulesetRules;
|
|
49
|
+
/**
|
|
50
|
+
* An explicit, reasoned sign-off that THIS declaration deliberately drops a live bypass actor
|
|
51
|
+
* (`bypassActors` is a strict subset of what is live). Without this, `reconcile` refuses the
|
|
52
|
+
* write rather than silently loosen a ruleset that already protects something — see
|
|
53
|
+
* `bypassNarrowingRefusal` in repository-ruleset-narrowing-guards.ts. `reason` is not logged or
|
|
54
|
+
* sent to GitHub; it exists so the declaration's own diff carries WHY, for the next reader
|
|
55
|
+
* (S21: a refusal names the fact it checked — this is the human-authored counterpart for the
|
|
56
|
+
* one case a fact alone cannot settle: "is this narrowing intentional?").
|
|
57
|
+
*
|
|
58
|
+
* ⛔ SEPARATE FROM `acknowledgeRuleNarrowing` ON PURPOSE (2026-09-23 review finding: a single
|
|
59
|
+
* shared `acknowledgeNarrowing` let one reason worded for a rule drop silently also rubber-
|
|
60
|
+
* stamp an unrelated bypass-actor drop in the SAME declaration — a `bypassActors: []` left
|
|
61
|
+
* over from an unrelated edit slipped through under a reason that never mentioned bypass at
|
|
62
|
+
* all). Each prop authorizes only the narrowing its own guard checks; a declaration that
|
|
63
|
+
* narrows both needs both, each with its own reason.
|
|
64
|
+
*
|
|
65
|
+
* ⛔ ALSO A STANDING PROP, NOT A ONE-TIME TOKEN — remove it from the declaration once the
|
|
66
|
+
* narrowing it describes has landed. Left in place, it keeps disabling the bypass-narrowing
|
|
67
|
+
* guard for every future `reconcile` of this resource, not only the change it was written
|
|
68
|
+
* for — the same way `rules: { deletion: false }` stays a standing "this rule stays absent"
|
|
69
|
+
* fact rather than a one-time action, only here the standing fact is "bypass narrowing needs
|
|
70
|
+
* no review", which is a fact you want true for as short a window as possible. A reviewer
|
|
71
|
+
* reading a diff that adds a SECOND, unrelated bypass drop under an OLD
|
|
72
|
+
* `acknowledgeBypassNarrowing` left over from a prior change is the failure mode this note
|
|
73
|
+
* exists to head off.
|
|
74
|
+
*/
|
|
75
|
+
readonly acknowledgeBypassNarrowing?: {
|
|
76
|
+
readonly reason: string;
|
|
77
|
+
};
|
|
78
|
+
/**
|
|
79
|
+
* The `rules`-side counterpart to `acknowledgeBypassNarrowing` above — an explicit, reasoned
|
|
80
|
+
* sign-off that THIS declaration deliberately drops a live rule (a modeled rule type declared
|
|
81
|
+
* `false`/boolean-`false` while the live ruleset still has it). Without this, `reconcile`
|
|
82
|
+
* refuses the write — see `ruleNarrowingRefusal` in repository-ruleset-narrowing-guards.ts.
|
|
83
|
+
* Same standing-prop caution as `acknowledgeBypassNarrowing`: remove it once the rule drop it
|
|
84
|
+
* describes has landed, or it keeps excusing every later rule drop on this resource too.
|
|
85
|
+
*/
|
|
86
|
+
readonly acknowledgeRuleNarrowing?: {
|
|
87
|
+
readonly reason: string;
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
export {};
|
|
91
|
+
//# sourceMappingURL=repository-ruleset-props.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repository-ruleset-props.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-props.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,KAAK,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAExD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAED,MAAM,WAAW,gCAAiC,SAAQ,WAAW,CACnE,aAAa,CAAC,aAAa,CAAC,CAC7B;IACC,yFAAyF;IACzF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC1E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACtE;;;;;mFAK+E;IAC/E,QAAQ,CAAC,mCAAmC,CAAC,EAAE,OAAO,CAAC;CACxD;AAED,MAAM,WAAW,iCAAkC,SAAQ,WAAW,CACpE,aAAa,CAAC,sBAAsB,CAAC,CACtC;IACC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAClD,aAAa,EACb,aAAa,GAAG,sBAAsB,CACvC;IACC;;;;;;;;;;gGAU4F;IAC5F,QAAQ,CAAC,WAAW,CAAC,EAAE,gCAAgC,GAAG,KAAK,CAAC;IAChE;2FACuF;IACvF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,iCAAiC,GAAG,KAAK,CAAC;CAC3E;AAED,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,CAAC;IACxC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,CAAC,0BAA0B,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE;;;;;;;OAOG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `repoPolicyProviders` — the documented stack wiring for `RepositoryRuleset` (directly, or
|
|
3
|
+
* through `declareRepoPolicy` / `declareRepoBaseline`): `GitHub.providers()` and
|
|
4
|
+
* `RepositoryRulesetProvider()`, composed so the whole thing typechecks and needs nothing
|
|
5
|
+
* further from the stack.
|
|
6
|
+
*
|
|
7
|
+
* providers: repoPolicyProviders()
|
|
8
|
+
*
|
|
9
|
+
* ⛔ WHY THIS EXISTS — MEASURED 2026-09-24 (homeflare-builds bump PR 6, tsc). Writing the two
|
|
10
|
+
* providers side by side, `Layer.mergeAll(GitHub.providers(), RepositoryRulesetProvider())`,
|
|
11
|
+
* type-errors: `RepositoryRulesetProvider()`'s handlers call `octokitFor`, which needs
|
|
12
|
+
* `GitHubCredentials` — a requirement of the PROVIDER's layer, correctly inferred by
|
|
13
|
+
* `Provider.succeed` from `repositoryRulesetHandlers` in repository-ruleset.ts. Merging two
|
|
14
|
+
* layers does not thread one's output into the other's requirement; `RepositoryRulesetProvider()`
|
|
15
|
+
* still needs `GitHubCredentials` fed in. `GitHub.providers()` is the only thing here that
|
|
16
|
+
* resolves credentials (env, stored PAT, `gh` CLI, or OAuth — see `alchemy/src/GitHub/
|
|
17
|
+
* Providers.ts`), and — because it chains `Layer.provideMerge(Credentials.fromAuthProvider(…))`
|
|
18
|
+
* internally rather than `Layer.provide` — its own OUTPUT includes `GitHubCredentials`
|
|
19
|
+
* alongside `GitHub.Providers`. `Layer.provideMerge(github)` on `RepositoryRulesetProvider()`
|
|
20
|
+
* both supplies that requirement AND keeps `github`'s own output merged in for any
|
|
21
|
+
* `GitHub.Repository`/`GitHub.Ruleset` the caller also declares. `github` is built once and
|
|
22
|
+
* referenced twice below — Effect's layer memoization (by reference) builds it once, not
|
|
23
|
+
* twice, not twice against the auth provider either.
|
|
24
|
+
*
|
|
25
|
+
* ★ THIS IS ONLY HALF OF 2026-09-24's FIX. The other half — `RepositoryRuleset`'s own `Resource<>`
|
|
26
|
+
* declaration no longer naming `GitHubCredentials` in its 5th (`Providers`) slot — lives in
|
|
27
|
+
* repository-ruleset.ts's file header; that half is what let a stack BODY calling
|
|
28
|
+
* `declareRepoPolicy`/`declareRepoBaseline` typecheck at all. Composing the providers
|
|
29
|
+
* correctly, as this function does, does not by itself fix a body that still requires
|
|
30
|
+
* `GitHubCredentials` directly.
|
|
31
|
+
*
|
|
32
|
+
* ⚠️ DON'T ALSO MERGE A SEPARATE `GitHub.providers()` CALL IN. `github` here is one Layer
|
|
33
|
+
* object referenced twice, which Effect's layer memoization (by reference, ADVERSARIAL
|
|
34
|
+
* REVIEW 2026-09-24: confirmed against `effect@4.0.0-rc.115`'s own `MemoMap`) builds once. A
|
|
35
|
+
* stack that ALSO writes its own `GitHub.providers()` alongside this function's result is a
|
|
36
|
+
* second, distinct Layer object — a genuine second credential resolution, not shared with
|
|
37
|
+
* this one. Get every GitHub resource's providers from this one call.
|
|
38
|
+
*/
|
|
39
|
+
import * as GitHub from 'alchemy/GitHub';
|
|
40
|
+
import * as Layer from 'effect/Layer';
|
|
41
|
+
export declare const repoPolicyProviders: (options?: GitHub.ProvidersOptions) => Layer.Layer<import("alchemy/Auth/Credentials").CredentialsStore | GitHub.GitHubCredentials | import("alchemy/Auth/Profile").ProfileStore | import("alchemy").Provider<import("./repository-ruleset.ts").RepositoryRuleset> | GitHub.Providers, never, import("alchemy").AuthProviders | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
|
|
42
|
+
//# sourceMappingURL=repository-ruleset-providers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repository-ruleset-providers.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,eAAO,MAAM,mBAAmB,aAAc,MAAM,CAAC,gBAAgB,6aAGpE,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository-ruleset-reconcile.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-reconcile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEnG,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,MAAM,gCAAgC,CAAC;
|
|
1
|
+
{"version":3,"file":"repository-ruleset-reconcile.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset-reconcile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEnG,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,MAAM,gCAAgC,CAAC;AAgBxC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,+BAA+B,CAAC;AA+CvC;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,KAAK,SAAS;IACjD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,KAAK,EAAE,sBAAsB,KAC1B,wBAAwB,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,2BAA2B,CAAC;CACrE,KAAG,MAAM,CAAC,MAAM,CAAC,2BAA2B,EAAE,sBAAsB,GAAG,KAAK,EAAE,CAAC,CAoH5E,CAAC"}
|
|
@@ -38,40 +38,35 @@
|
|
|
38
38
|
* meant to allow. `octokitFor`/`GitHubCredentials` are upstream's own EXPORTED building
|
|
39
39
|
* blocks (S23's second clause: reuse Alchemy's own client construction), so the client itself
|
|
40
40
|
* is not hand-rolled — only the choice of Octokit over distilled is a recorded divergence.
|
|
41
|
+
*
|
|
42
|
+
* ⛔ CREDENTIALS BELONG TO THE PROVIDER'S LAYER, NOT THE RESOURCE'S DECLARATION — MEASURED
|
|
43
|
+
* 2026-09-24 (homeflare-builds bump PR 6, tsc TS2345). The `Resource<Type, Props, Attributes,
|
|
44
|
+
* Binding, Providers>` 5th type parameter had `GitHubCredentials` here; that puts the
|
|
45
|
+
* credential requirement on every `yield* RepositoryRuleset(...)` CALL SITE (see
|
|
46
|
+
* `alchemy/src/Resource.ts#ResourceClass`: `Req = R["Providers"] extends undefined ?
|
|
47
|
+
* Provider<R> : R["Providers"]`), so a STACK BODY that merely declares the resource would
|
|
48
|
+
* itself need `GitHubCredentials` in its own effect context — which a stack body cannot
|
|
49
|
+
* produce (`Alchemy.Stack`'s own type, `alchemy/src/Stack.ts#ProviderServices`, is a closed
|
|
50
|
+
* union of tagged marker interfaces — `ProviderCollectionLike | Provider<any> |
|
|
51
|
+
* EnvironmentLike | CredentialsLike | DockerLike` — and `GitHubCredentials` matches none of
|
|
52
|
+
* them structurally). VERIFIED against upstream `Ruleset` (`node_modules/alchemy/src/GitHub/
|
|
53
|
+
* Ruleset.ts`): its 5th slot is `GitHub.Providers`, the ProviderCollection tag `GitHub.
|
|
54
|
+
* providers()` OUTPUTS — never the raw `GitHubCredentials` service upstream's OWN provider
|
|
55
|
+
* handlers pull in via `octokitFor`. `GitHubCredentials` stays confined to the PROVIDER's
|
|
56
|
+
* layer requirement (`Provider.succeed`'s inferred `ReadReq | DiffReq | ReconcileReq |
|
|
57
|
+
* DeleteReq`, below), never the declaration's. Omitting the 5th parameter here defaults it to
|
|
58
|
+
* `undefined`, so the declaration's own requirement becomes `Provider<RepositoryRuleset>` —
|
|
59
|
+
* itself a `Provider<any>`, a real `ProviderServices` member — matching the pattern a
|
|
60
|
+
* standalone (non-collection) resource actually needs. See `repoPolicyProviders()` in
|
|
61
|
+
* repository-ruleset-providers.ts for the layer composition this now requires (the provider
|
|
62
|
+
* still needs `GitHubCredentials` fed in — that half of the fix was already correct, per
|
|
63
|
+
* `docs/repository-ruleset.md`).
|
|
41
64
|
*/
|
|
42
65
|
import { Resource } from 'alchemy';
|
|
43
|
-
import type { GitHubCredentials, RulesetProps } from 'alchemy/GitHub';
|
|
44
66
|
import * as Provider from 'alchemy/Provider';
|
|
45
67
|
import { type RulesetRecord } from './repository-ruleset-probe.ts';
|
|
46
|
-
type
|
|
47
|
-
export
|
|
48
|
-
readonly filePatterns: readonly string[];
|
|
49
|
-
readonly minimumApprovals: number;
|
|
50
|
-
readonly reviewer: {
|
|
51
|
-
readonly actorId: number;
|
|
52
|
-
readonly actorType: 'Team';
|
|
53
|
-
};
|
|
54
|
-
}
|
|
55
|
-
export interface RepositoryRulesetPullRequestRule extends NonNullable<UpstreamRules['pullRequest']> {
|
|
56
|
-
/** @default every method GitHub allows — the house baseline always pins `['squash']`. */
|
|
57
|
-
readonly allowedMergeMethods?: readonly ('merge' | 'squash' | 'rebase')[];
|
|
58
|
-
readonly requiredReviewers?: readonly RepositoryRulesetReviewerRule[];
|
|
59
|
-
/** `require_extra_approval_for_unattributed_changes` — see H15 above. Only `false` is
|
|
60
|
-
* modeled: sending `true` has no house use, and GitHub already defaults absent to `true`. */
|
|
61
|
-
readonly extraApprovalForUnattributedChanges?: false;
|
|
62
|
-
}
|
|
63
|
-
export interface RepositoryRulesetStatusChecksRule extends NonNullable<UpstreamRules['requiredStatusChecks']> {
|
|
64
|
-
readonly doNotEnforceOnCreate?: boolean;
|
|
65
|
-
}
|
|
66
|
-
export interface RepositoryRulesetRules extends Omit<UpstreamRules, 'pullRequest' | 'requiredStatusChecks'> {
|
|
67
|
-
readonly pullRequest?: RepositoryRulesetPullRequestRule;
|
|
68
|
-
/** `undefined`: no opinion (refused if the live ruleset already has one — see
|
|
69
|
-
* repository-ruleset-guards.ts). `false`: declare its ABSENCE — removes a live one. */
|
|
70
|
-
readonly requiredStatusChecks?: RepositoryRulesetStatusChecksRule | false;
|
|
71
|
-
}
|
|
72
|
-
export interface RepositoryRulesetProps extends Omit<RulesetProps, 'rules'> {
|
|
73
|
-
readonly rules?: RepositoryRulesetRules;
|
|
74
|
-
}
|
|
68
|
+
import type { RepositoryRulesetProps } from './repository-ruleset-props.ts';
|
|
69
|
+
export type { RepositoryRulesetProps, RepositoryRulesetPullRequestRule, RepositoryRulesetReviewerRule, RepositoryRulesetRules, RepositoryRulesetStatusChecksRule, } from './repository-ruleset-props.ts';
|
|
75
70
|
export interface RepositoryRulesetAttributes {
|
|
76
71
|
readonly rulesetId: number;
|
|
77
72
|
readonly nodeId: string | undefined;
|
|
@@ -79,11 +74,10 @@ export interface RepositoryRulesetAttributes {
|
|
|
79
74
|
readonly createdAt: string | undefined;
|
|
80
75
|
readonly updatedAt: string | undefined;
|
|
81
76
|
}
|
|
82
|
-
export interface RepositoryRuleset extends Resource<'GitHub.RepositoryRuleset', RepositoryRulesetProps, RepositoryRulesetAttributes, never
|
|
77
|
+
export interface RepositoryRuleset extends Resource<'GitHub.RepositoryRuleset', RepositoryRulesetProps, RepositoryRulesetAttributes, never> {
|
|
83
78
|
}
|
|
84
79
|
export declare const RepositoryRuleset: import("alchemy").ResourceClass<RepositoryRuleset>;
|
|
85
80
|
export declare const attrsOf: (r: RulesetRecord) => RepositoryRulesetAttributes;
|
|
86
|
-
export declare const repositoryRulesetHandlers: Provider.ProviderService<RepositoryRuleset, GitHubCredentials, never, never, GitHubCredentials, GitHubCredentials, never, never, never>;
|
|
87
|
-
export declare const RepositoryRulesetProvider: () => import("effect/Layer").Layer<Provider.Provider<RepositoryRuleset>, never, GitHubCredentials>;
|
|
88
|
-
export {};
|
|
81
|
+
export declare const repositoryRulesetHandlers: Provider.ProviderService<RepositoryRuleset, import("alchemy/GitHub/Credentials").GitHubCredentials, never, never, import("alchemy/GitHub/Credentials").GitHubCredentials, import("alchemy/GitHub/Credentials").GitHubCredentials, never, never, never>;
|
|
82
|
+
export declare const RepositoryRulesetProvider: () => import("effect/Layer").Layer<Provider.Provider<RepositoryRuleset>, never, import("alchemy/GitHub/Credentials").GitHubCredentials>;
|
|
89
83
|
//# sourceMappingURL=repository-ruleset.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository-ruleset.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"repository-ruleset.d.ts","sourceRoot":"","sources":["../../src/github/repository-ruleset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAQ7C,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAG5E,YAAY,EACV,sBAAsB,EACtB,gCAAgC,EAChC,6BAA6B,EAC7B,sBAAsB,EACtB,iCAAiC,GAClC,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,iBAAkB,SAAQ,QAAQ,CACjD,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,CAIN;CAAG;AAEJ,eAAO,MAAM,iBAAiB,oDAE5B,CAAC;AAEH,eAAO,MAAM,OAAO,MAAO,aAAa,KAAG,2BAMzC,CAAC;AA4CH,eAAO,MAAM,yBAAyB,wPAkEpC,CAAC;AAEH,eAAO,MAAM,yBAAyB,yIAC0B,CAAC"}
|