@inf-monkeys-tech/monkeys-cli 0.12.12 → 0.12.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/README.md +10 -0
  2. package/README.zh.md +10 -0
  3. package/dist/command/metadata.d.ts.map +1 -1
  4. package/dist/command/metadata.js +14 -1
  5. package/dist/command/metadata.js.map +1 -1
  6. package/dist/commands/data/asset/aggregate.d.ts +21 -0
  7. package/dist/commands/data/asset/aggregate.d.ts.map +1 -0
  8. package/dist/commands/data/asset/aggregate.js +96 -0
  9. package/dist/commands/data/asset/aggregate.js.map +1 -0
  10. package/dist/commands/data/asset/search.d.ts.map +1 -1
  11. package/dist/commands/data/asset/search.js +8 -1
  12. package/dist/commands/data/asset/search.js.map +1 -1
  13. package/dist/commands/group/create.d.ts +21 -0
  14. package/dist/commands/group/create.d.ts.map +1 -0
  15. package/dist/commands/group/create.js +31 -0
  16. package/dist/commands/group/create.js.map +1 -0
  17. package/dist/commands/group/delete.d.ts +22 -0
  18. package/dist/commands/group/delete.d.ts.map +1 -0
  19. package/dist/commands/group/delete.js +30 -0
  20. package/dist/commands/group/delete.js.map +1 -0
  21. package/dist/commands/group/get.d.ts +14 -0
  22. package/dist/commands/group/get.d.ts.map +1 -0
  23. package/dist/commands/group/get.js +20 -0
  24. package/dist/commands/group/get.js.map +1 -0
  25. package/dist/commands/group/list.d.ts +16 -0
  26. package/dist/commands/group/list.d.ts.map +1 -0
  27. package/dist/commands/group/list.js +18 -0
  28. package/dist/commands/group/list.js.map +1 -0
  29. package/dist/commands/group/member/add.d.ts +26 -0
  30. package/dist/commands/group/member/add.d.ts.map +1 -0
  31. package/dist/commands/group/member/add.js +29 -0
  32. package/dist/commands/group/member/add.js.map +1 -0
  33. package/dist/commands/group/member/list.d.ts +20 -0
  34. package/dist/commands/group/member/list.d.ts.map +1 -0
  35. package/dist/commands/group/member/list.js +21 -0
  36. package/dist/commands/group/member/list.js.map +1 -0
  37. package/dist/commands/group/member/remove.d.ts +27 -0
  38. package/dist/commands/group/member/remove.d.ts.map +1 -0
  39. package/dist/commands/group/member/remove.js +33 -0
  40. package/dist/commands/group/member/remove.js.map +1 -0
  41. package/dist/commands/group/permission/list.d.ts +19 -0
  42. package/dist/commands/group/permission/list.d.ts.map +1 -0
  43. package/dist/commands/group/permission/list.js +28 -0
  44. package/dist/commands/group/permission/list.js.map +1 -0
  45. package/dist/commands/group/permission/set.d.ts +24 -0
  46. package/dist/commands/group/permission/set.d.ts.map +1 -0
  47. package/dist/commands/group/permission/set.js +33 -0
  48. package/dist/commands/group/permission/set.js.map +1 -0
  49. package/dist/commands/group/update.d.ts +24 -0
  50. package/dist/commands/group/update.d.ts.map +1 -0
  51. package/dist/commands/group/update.js +33 -0
  52. package/dist/commands/group/update.js.map +1 -0
  53. package/dist/commands/permission/list.d.ts +16 -0
  54. package/dist/commands/permission/list.d.ts.map +1 -0
  55. package/dist/commands/permission/list.js +18 -0
  56. package/dist/commands/permission/list.js.map +1 -0
  57. package/dist/commands/user/get.d.ts +14 -0
  58. package/dist/commands/user/get.d.ts.map +1 -0
  59. package/dist/commands/user/get.js +20 -0
  60. package/dist/commands/user/get.js.map +1 -0
  61. package/dist/commands/user/group/add.d.ts +26 -0
  62. package/dist/commands/user/group/add.d.ts.map +1 -0
  63. package/dist/commands/user/group/add.js +29 -0
  64. package/dist/commands/user/group/add.js.map +1 -0
  65. package/dist/commands/user/group/list.d.ts +19 -0
  66. package/dist/commands/user/group/list.d.ts.map +1 -0
  67. package/dist/commands/user/group/list.js +38 -0
  68. package/dist/commands/user/group/list.js.map +1 -0
  69. package/dist/commands/user/group/remove.d.ts +26 -0
  70. package/dist/commands/user/group/remove.d.ts.map +1 -0
  71. package/dist/commands/user/group/remove.js +29 -0
  72. package/dist/commands/user/group/remove.js.map +1 -0
  73. package/dist/commands/user/list.d.ts +18 -0
  74. package/dist/commands/user/list.d.ts.map +1 -0
  75. package/dist/commands/user/list.js +27 -0
  76. package/dist/commands/user/list.js.map +1 -0
  77. package/dist/data/asset-aggregate.d.ts +68 -0
  78. package/dist/data/asset-aggregate.d.ts.map +1 -0
  79. package/dist/data/asset-aggregate.js +303 -0
  80. package/dist/data/asset-aggregate.js.map +1 -0
  81. package/dist/data/client.d.ts +1 -0
  82. package/dist/data/client.d.ts.map +1 -1
  83. package/dist/data/client.js +52 -9
  84. package/dist/data/client.js.map +1 -1
  85. package/dist/data/contracts.d.ts +3 -2
  86. package/dist/data/contracts.d.ts.map +1 -1
  87. package/dist/data/contracts.js +28 -5
  88. package/dist/data/contracts.js.map +1 -1
  89. package/dist/identity-governance/client.d.ts +217 -0
  90. package/dist/identity-governance/client.d.ts.map +1 -0
  91. package/dist/identity-governance/client.js +185 -0
  92. package/dist/identity-governance/client.js.map +1 -0
  93. package/dist/identity-governance/contracts.d.ts +142 -0
  94. package/dist/identity-governance/contracts.d.ts.map +1 -0
  95. package/dist/identity-governance/contracts.js +109 -0
  96. package/dist/identity-governance/contracts.js.map +1 -0
  97. package/dist/identity-governance/definitions.d.ts +54 -0
  98. package/dist/identity-governance/definitions.d.ts.map +1 -0
  99. package/dist/identity-governance/definitions.js +25 -0
  100. package/dist/identity-governance/definitions.js.map +1 -0
  101. package/dist/identity-governance/files.d.ts +5 -0
  102. package/dist/identity-governance/files.d.ts.map +1 -0
  103. package/dist/identity-governance/files.js +75 -0
  104. package/dist/identity-governance/files.js.map +1 -0
  105. package/dist/identity-governance/flags.d.ts +43 -0
  106. package/dist/identity-governance/flags.d.ts.map +1 -0
  107. package/dist/identity-governance/flags.js +52 -0
  108. package/dist/identity-governance/flags.js.map +1 -0
  109. package/dist/identity-governance/group-mutation.d.ts +165 -0
  110. package/dist/identity-governance/group-mutation.d.ts.map +1 -0
  111. package/dist/identity-governance/group-mutation.js +160 -0
  112. package/dist/identity-governance/group-mutation.js.map +1 -0
  113. package/dist/identity-governance/membership.d.ts +145 -0
  114. package/dist/identity-governance/membership.d.ts.map +1 -0
  115. package/dist/identity-governance/membership.js +264 -0
  116. package/dist/identity-governance/membership.js.map +1 -0
  117. package/dist/identity-governance/runtime.d.ts +16 -0
  118. package/dist/identity-governance/runtime.d.ts.map +1 -0
  119. package/dist/identity-governance/runtime.js +30 -0
  120. package/dist/identity-governance/runtime.js.map +1 -0
  121. package/oclif.manifest.json +2747 -570
  122. package/package.json +11 -2
  123. package/skills/monkeys-data/references/data-perspective.md +5 -5
  124. package/skills/monkeys-data/references/data-read.md +2 -1
  125. package/skills/monkeys-data/references/ontology-feature-search.md +47 -1
  126. package/skills/monkeys-shared/SKILL.md +2 -1
  127. package/skills/monkeys-shared/references/identity-governance.md +47 -0
  128. package/skills/monkeys-shared/references/platform-overview.md +2 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/identity-governance/files.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ export declare function identityFlags(): {
2
+ output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
3
+ subscription: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
4
+ refresh: import("@oclif/core/interfaces").BooleanFlag<boolean>;
5
+ };
6
+ export declare function mutationFlags(): {
7
+ 'page-all': import("@oclif/core/interfaces").BooleanFlag<boolean>;
8
+ 'page-delay': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
9
+ 'page-limit': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
10
+ 'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
11
+ 'page-token': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
12
+ output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
13
+ subscription: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
14
+ refresh: import("@oclif/core/interfaces").BooleanFlag<boolean>;
15
+ 'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
16
+ yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
17
+ };
18
+ export declare function membershipFlags(): {
19
+ 'page-all': import("@oclif/core/interfaces").BooleanFlag<boolean>;
20
+ 'page-delay': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
21
+ 'page-limit': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
22
+ 'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
23
+ 'page-token': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
24
+ output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
25
+ subscription: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
26
+ refresh: import("@oclif/core/interfaces").BooleanFlag<boolean>;
27
+ 'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
28
+ yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
29
+ ids: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
30
+ 'ids-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
31
+ 'plan-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
32
+ 'plan-out': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
33
+ report: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
34
+ };
35
+ export declare function bodyFlags(): {
36
+ 'input-json': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
37
+ 'input-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
38
+ };
39
+ export declare function readBody(flags: {
40
+ 'input-json'?: string | undefined;
41
+ 'input-file'?: string | undefined;
42
+ }): Promise<unknown>;
43
+ //# sourceMappingURL=flags.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/identity-governance/flags.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa;IAEzB,MAAM;IACN,YAAY;IACZ,OAAO;EAEV;AACD,wBAAgB,aAAa;;;;;;;;;;;EAO5B;AACD,wBAAgB,eAAe;;;;;;;;;;;;;;;;EAS9B;AACD,wBAAgB,SAAS;IAErB,YAAY;IACZ,YAAY;EAEf;AACD,wBAAsB,QAAQ,CAAC,KAAK,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAWhI"}
@@ -0,0 +1,52 @@
1
+ import { Flags } from '@oclif/core';
2
+ import { localOutputFlag } from '../config/local-command.js';
3
+ import { paginationFlags } from '../pagination/index.js';
4
+ import { fail } from './contracts.js';
5
+ import { MAX_IDENTITY_FILE_BYTES, readJson } from './files.js';
6
+ export function identityFlags() {
7
+ return {
8
+ output: localOutputFlag,
9
+ subscription: Flags.string({ required: true, summary: 'Explicit Kernel Subscription name (global scope, no Team)' }),
10
+ refresh: Flags.boolean({ default: false, summary: 'Refresh the published API contract' }),
11
+ };
12
+ }
13
+ export function mutationFlags() {
14
+ return {
15
+ ...identityFlags(),
16
+ ...paginationFlags({ defaultPageSize: 100 }),
17
+ 'dry-run': Flags.boolean({ default: false, exclusive: ['yes'], summary: 'Preview only; send no mutation request' }),
18
+ yes: Flags.boolean({ char: 'y', default: false, exclusive: ['dry-run'], summary: 'Confirm this privileged operation' }),
19
+ };
20
+ }
21
+ export function membershipFlags() {
22
+ return {
23
+ ...mutationFlags(),
24
+ ids: Flags.string({ multiple: true, summary: 'Exact counterpart IDs: group IDs for user scope, user IDs for group scope' }),
25
+ 'ids-file': Flags.string({ summary: 'JSON array of exact counterpart IDs' }),
26
+ 'plan-file': Flags.string({ summary: 'Reviewed frozen plan; required for bulk execution' }),
27
+ 'plan-out': Flags.string({ summary: 'New file for the dry-run frozen plan (never overwritten)' }),
28
+ report: Flags.string({ summary: 'New file for the initial recovery report; receipt paths are returned' }),
29
+ };
30
+ }
31
+ export function bodyFlags() {
32
+ return {
33
+ 'input-json': Flags.string({ exclusive: ['input-file'], summary: 'Explicit strict JSON request body' }),
34
+ 'input-file': Flags.string({ exclusive: ['input-json'], summary: 'JSON request body file (maximum 10 MiB)' }),
35
+ };
36
+ }
37
+ export async function readBody(flags) {
38
+ if ((flags['input-json'] !== undefined) === (flags['input-file'] !== undefined))
39
+ fail('IDENTITY_INPUT_REQUIRED', 'Specify exactly one of --input-json or --input-file.');
40
+ if (flags['input-file'] !== undefined)
41
+ return readJson(flags['input-file']);
42
+ const input = flags['input-json'];
43
+ if (Buffer.byteLength(input) > MAX_IDENTITY_FILE_BYTES)
44
+ fail('IDENTITY_INPUT_INVALID', 'Input exceeds 10 MiB.');
45
+ try {
46
+ return JSON.parse(input);
47
+ }
48
+ catch {
49
+ return fail('IDENTITY_INPUT_INVALID', 'Input must be valid JSON.');
50
+ }
51
+ }
52
+ //# sourceMappingURL=flags.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/identity-governance/flags.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,165 @@
1
+ import type { PaginationInput } from '../pagination/index.js';
2
+ import { IdentityClient } from './client.js';
3
+ export interface GroupMutationInput {
4
+ client: IdentityClient;
5
+ action: 'create' | 'update' | 'delete' | 'setPermissions';
6
+ id?: string | undefined;
7
+ body?: unknown;
8
+ dryRun: boolean;
9
+ yes: boolean;
10
+ snapshot?: string | undefined;
11
+ pagination: PaginationInput;
12
+ }
13
+ export declare function executeGroupMutation(input: GroupMutationInput): Promise<{
14
+ authSurface: string;
15
+ teamMode: string;
16
+ subscription: string;
17
+ deployment: string;
18
+ tenant: string;
19
+ principalId: string;
20
+ contextFingerprint: string;
21
+ schemaDigest: string | undefined;
22
+ action: "create" | "delete" | "setPermissions" | "update";
23
+ groupId: string | undefined;
24
+ before: {
25
+ id: string;
26
+ code: string;
27
+ name: string;
28
+ description?: string | null | undefined;
29
+ isSystem: boolean;
30
+ membershipEditable: boolean;
31
+ permissions: {
32
+ id: string;
33
+ code: string;
34
+ name: string;
35
+ resource: string;
36
+ action: string;
37
+ description?: string | null | undefined;
38
+ createdTimestamp?: string | number | undefined;
39
+ updatedTimestamp?: string | number | undefined;
40
+ }[];
41
+ createdTimestamp?: string | number | undefined;
42
+ updatedTimestamp?: string | number | undefined;
43
+ } | undefined;
44
+ after: {
45
+ code?: string | undefined;
46
+ name?: string | undefined;
47
+ description?: string | undefined;
48
+ } | {
49
+ permissionIds: string[];
50
+ } | undefined;
51
+ warnings: string[];
52
+ dryRun: boolean;
53
+ writeRequestSent: boolean;
54
+ serverValidated: boolean;
55
+ } | ({
56
+ authSurface: string;
57
+ teamMode: string;
58
+ subscription: string;
59
+ deployment: string;
60
+ tenant: string;
61
+ principalId: string;
62
+ contextFingerprint: string;
63
+ schemaDigest: string | undefined;
64
+ action: "create" | "delete" | "setPermissions" | "update";
65
+ groupId: string | undefined;
66
+ before: {
67
+ id: string;
68
+ code: string;
69
+ name: string;
70
+ description?: string | null | undefined;
71
+ isSystem: boolean;
72
+ membershipEditable: boolean;
73
+ permissions: {
74
+ id: string;
75
+ code: string;
76
+ name: string;
77
+ resource: string;
78
+ action: string;
79
+ description?: string | null | undefined;
80
+ createdTimestamp?: string | number | undefined;
81
+ updatedTimestamp?: string | number | undefined;
82
+ }[];
83
+ createdTimestamp?: string | number | undefined;
84
+ updatedTimestamp?: string | number | undefined;
85
+ } | undefined;
86
+ after: {
87
+ code?: string | undefined;
88
+ name?: string | undefined;
89
+ description?: string | undefined;
90
+ } | {
91
+ permissionIds: string[];
92
+ } | undefined;
93
+ warnings: string[];
94
+ dryRun: boolean;
95
+ writeRequestSent: boolean;
96
+ snapshot: string;
97
+ requestId: string | undefined;
98
+ verification: {
99
+ absent: boolean;
100
+ };
101
+ } & {
102
+ finalReport: string;
103
+ }) | ({
104
+ authSurface: string;
105
+ teamMode: string;
106
+ subscription: string;
107
+ deployment: string;
108
+ tenant: string;
109
+ principalId: string;
110
+ contextFingerprint: string;
111
+ schemaDigest: string | undefined;
112
+ action: "create" | "delete" | "setPermissions" | "update";
113
+ before: {
114
+ id: string;
115
+ code: string;
116
+ name: string;
117
+ description?: string | null | undefined;
118
+ isSystem: boolean;
119
+ membershipEditable: boolean;
120
+ permissions: {
121
+ id: string;
122
+ code: string;
123
+ name: string;
124
+ resource: string;
125
+ action: string;
126
+ description?: string | null | undefined;
127
+ createdTimestamp?: string | number | undefined;
128
+ updatedTimestamp?: string | number | undefined;
129
+ }[];
130
+ createdTimestamp?: string | number | undefined;
131
+ updatedTimestamp?: string | number | undefined;
132
+ } | undefined;
133
+ warnings: string[];
134
+ dryRun: boolean;
135
+ writeRequestSent: boolean;
136
+ snapshot: string;
137
+ requestId: string | undefined;
138
+ groupId: string;
139
+ after: {
140
+ id: string;
141
+ code: string;
142
+ name: string;
143
+ description?: string | null | undefined;
144
+ isSystem: boolean;
145
+ membershipEditable: boolean;
146
+ permissions: {
147
+ id: string;
148
+ code: string;
149
+ name: string;
150
+ resource: string;
151
+ action: string;
152
+ description?: string | null | undefined;
153
+ createdTimestamp?: string | number | undefined;
154
+ updatedTimestamp?: string | number | undefined;
155
+ }[];
156
+ createdTimestamp?: string | number | undefined;
157
+ updatedTimestamp?: string | number | undefined;
158
+ };
159
+ verification: {
160
+ matches: boolean;
161
+ };
162
+ } & {
163
+ finalReport: string;
164
+ })>;
165
+ //# sourceMappingURL=group-mutation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"group-mutation.d.ts","sourceRoot":"","sources":["../../src/identity-governance/group-mutation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAe9D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC1D,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA0EkD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAmBtG,OAAO;;;;IA2B5B"}
@@ -0,0 +1,160 @@
1
+ import { z } from 'zod';
2
+ import { CliError, EXIT_CODES } from '../errors/cli-error.js';
3
+ import { assertConfirmation } from '../policy/risk.js';
4
+ import { requireComplete } from './client.js';
5
+ import { fail, groupCreateSchema, groupSchema, groupUpdateSchema, idSchema, parse, permissionSetSchema, requireCustomGroup, } from './contracts.js';
6
+ import { digest, writeArtifact } from './files.js';
7
+ import { identityMeta } from './runtime.js';
8
+ export async function executeGroupMutation(input) {
9
+ const { client, action } = input;
10
+ if (input.dryRun && input.yes)
11
+ fail('IDENTITY_FLAG_CONFLICT', '--dry-run and --yes are mutually exclusive.');
12
+ if (!input.dryRun)
13
+ assertConfirmation({ interactive: false, risk: 'privileged', yes: input.yes });
14
+ const id = action === 'create' ? undefined : parse(idSchema, input.id);
15
+ if (action === 'create' && input.id !== undefined)
16
+ fail('IDENTITY_INPUT_INVALID', 'Create does not accept a target group ID.');
17
+ const body = action === 'create'
18
+ ? parse(groupCreateSchema, input.body)
19
+ : action === 'update'
20
+ ? parse(groupUpdateSchema, input.body)
21
+ : action === 'setPermissions'
22
+ ? parse(permissionSetSchema, input.body)
23
+ : undefined;
24
+ if (action === 'delete' && input.body !== undefined)
25
+ fail('IDENTITY_INPUT_INVALID', 'Delete does not accept a request body.');
26
+ client.validateRequest(action, id, body);
27
+ const before = id ? await client.group(id) : undefined;
28
+ if (before)
29
+ requireCustomGroup(before);
30
+ const { pageToken: _pageToken, ...pageBounds } = input.pagination;
31
+ const completePages = { ...pageBounds, pageAll: true };
32
+ const metadata = body && 'code' in body ? body : undefined;
33
+ if (metadata?.code !== undefined) {
34
+ if (['member', 'platform_admin', 'super_admin'].includes(metadata.code))
35
+ fail('IDENTITY_GROUP_PROTECTED', 'This group code is reserved.', EXIT_CODES.authorization);
36
+ const groups = requireComplete(await client.groups(completePages));
37
+ if (groups.some((group) => group.id !== id && group.code.toLowerCase() === metadata.code))
38
+ fail('IDENTITY_GROUP_CODE_EXISTS', 'An active group already uses this code.');
39
+ }
40
+ if (action === 'delete') {
41
+ const members = await client.members(id, { pageAll: false, pageSize: 1, pageLimit: 1, pageDelay: 0 });
42
+ if (members.items.length || members.pageInfo.hasMore)
43
+ fail('IDENTITY_GROUP_IN_USE', 'Remove direct members explicitly before deleting a custom group.');
44
+ }
45
+ if (action === 'setPermissions') {
46
+ const desired = body.permissionIds;
47
+ if (new Set(desired).size !== desired.length)
48
+ fail('IDENTITY_DUPLICATE_TARGET', 'Repeated permission IDs are not allowed.');
49
+ const known = new Set(requireComplete(await client.permissions(completePages)).map((permission) => permission.id));
50
+ if (desired.some((permissionId) => !known.has(permissionId)))
51
+ fail('IDENTITY_PERMISSION_NOT_FOUND', 'Every permission ID must exist in the complete permission catalog.');
52
+ const own = await client.userGroups(client.runtime.principalId);
53
+ if ([...own.direct, ...own.mapped].some((group) => group.id === id) &&
54
+ ![...own.direct, ...own.mapped].some((group) => group.code === 'super_admin' && group.protected))
55
+ fail('IDENTITY_SELF_LOCKOUT_RISK', 'Changing your own permission group requires proven independent super-administrator authority.', EXIT_CODES.authorization);
56
+ }
57
+ const warnings = action === 'setPermissions'
58
+ ? [
59
+ 'This replaces the complete permission set. An explicit [] clears it.',
60
+ 'The server uses last-writer-wins; client preflight is not atomic compare-and-swap.',
61
+ ]
62
+ : action === 'delete'
63
+ ? ['Deletion has no restore endpoint. Recreating a group will not preserve its original ID.']
64
+ : [];
65
+ const preview = { ...identityMeta(client.runtime), action, groupId: id, before, after: body, warnings };
66
+ if (input.dryRun)
67
+ return { ...preview, dryRun: true, writeRequestSent: false, serverValidated: false };
68
+ if (before && digest(await client.group(id)) !== digest(before))
69
+ fail('IDENTITY_PLAN_STALE', 'The group changed during preflight. Nothing was written; repeat the preview.');
70
+ const snapshot = await writeArtifact(preview, input.snapshot, 'group-before');
71
+ let resultId = id;
72
+ let requestId;
73
+ try {
74
+ if (action === 'delete') {
75
+ const result = await client.call('delete', z.undefined(), { id: id });
76
+ requestId = result.requestId;
77
+ try {
78
+ await client.group(id);
79
+ }
80
+ catch (cause) {
81
+ if (cause instanceof CliError && cause.code === 'HTTP_404')
82
+ return saveResult({ ...preview, dryRun: false, writeRequestSent: true, snapshot, requestId, verification: { absent: true } });
83
+ throw cause;
84
+ }
85
+ fail('IDENTITY_READBACK_MISMATCH', 'The group still exists after deletion.', EXIT_CODES.partial);
86
+ }
87
+ const result = await client.call(action, groupSchema, { ...(id === undefined ? {} : { id }), body });
88
+ requestId = result.requestId;
89
+ resultId = result.data.id;
90
+ if (id && resultId !== id)
91
+ fail('IDENTITY_READBACK_MISMATCH', 'The write returned a different group ID.', EXIT_CODES.partial);
92
+ const after = await client.group(resultId);
93
+ verifyGroupMutation(action, body, after);
94
+ return saveResult({
95
+ ...preview,
96
+ dryRun: false,
97
+ writeRequestSent: true,
98
+ snapshot,
99
+ requestId,
100
+ groupId: resultId,
101
+ after,
102
+ verification: { matches: true },
103
+ });
104
+ }
105
+ catch (cause) {
106
+ const evidence = {
107
+ groupId: resultId,
108
+ snapshot,
109
+ requestId,
110
+ originalCode: cause instanceof CliError ? cause.code : 'INTERNAL_ERROR',
111
+ requestState: 'sent',
112
+ recovery: 'Reconcile the exact target before any retry or separately authorized restoration.',
113
+ };
114
+ let failureReport;
115
+ try {
116
+ failureReport = await writeArtifact(evidence, undefined, 'group-stopped');
117
+ }
118
+ catch (reportError) {
119
+ throw new CliError('The group operation stopped and its final report could not be saved. Inspect the snapshot; do not replay.', {
120
+ cause: reportError,
121
+ code: 'IDENTITY_REPORT_WRITE_FAILED',
122
+ exitCode: EXIT_CODES.partial,
123
+ safeDetails: evidence,
124
+ });
125
+ }
126
+ throw new CliError('Group mutation did not complete verified execution. Inspect the exact target and snapshot before retrying; no write was replayed.', { cause, code: 'IDENTITY_GROUP_MUTATION_INCOMPLETE', exitCode: EXIT_CODES.partial, safeDetails: { ...evidence, failureReport } });
127
+ }
128
+ }
129
+ async function saveResult(result) {
130
+ try {
131
+ return { ...result, finalReport: await writeArtifact(result, undefined, 'group-complete') };
132
+ }
133
+ catch (cause) {
134
+ throw new CliError('The group write was verified but its final report could not be saved. Do not replay the write.', {
135
+ cause,
136
+ code: 'IDENTITY_REPORT_WRITE_FAILED',
137
+ exitCode: EXIT_CODES.partial,
138
+ safeDetails: result,
139
+ });
140
+ }
141
+ }
142
+ function verifyGroupMutation(action, body, after) {
143
+ const values = body;
144
+ if (action === 'setPermissions') {
145
+ if (digest([...values.permissionIds].sort()) !== digest(after.permissions.map((permission) => permission.id).sort()))
146
+ fail('IDENTITY_READBACK_MISMATCH', 'Group permission readback differs from the requested complete set.', EXIT_CODES.partial);
147
+ }
148
+ else {
149
+ for (const [key, expected] of Object.entries(values)) {
150
+ const actual = after[key];
151
+ if ((key === 'description' ? (actual ?? '') : actual) !== expected)
152
+ fail('IDENTITY_READBACK_MISMATCH', 'Group metadata readback differs from the requested fields.', EXIT_CODES.partial, {
153
+ field: key,
154
+ });
155
+ }
156
+ if (action === 'create' && (after.isSystem || after.permissions.length))
157
+ fail('IDENTITY_READBACK_MISMATCH', 'A newly created custom group unexpectedly has system status or permissions.', EXIT_CODES.partial);
158
+ }
159
+ }
160
+ //# sourceMappingURL=group-mutation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"group-mutation.js","sourceRoot":"","sources":["../../src/identity-governance/group-mutation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,145 @@
1
+ import { z } from 'zod';
2
+ import type { PaginationInput } from '../pagination/index.js';
3
+ import { IdentityClient } from './client.js';
4
+ import { type MembershipChange, type MembershipScope } from './contracts.js';
5
+ export declare const membershipPlanSchema: z.ZodObject<{
6
+ version: z.ZodLiteral<1>;
7
+ kind: z.ZodLiteral<"direct-group-membership">;
8
+ contextFingerprint: z.ZodString;
9
+ principalId: z.ZodString;
10
+ subscription: z.ZodString;
11
+ deployment: z.ZodString;
12
+ tenant: z.ZodString;
13
+ schemaDigest: z.ZodString;
14
+ scope: z.ZodObject<{
15
+ kind: z.ZodEnum<{
16
+ group: "group";
17
+ user: "user";
18
+ }>;
19
+ id: z.ZodString;
20
+ }, z.core.$strict>;
21
+ action: z.ZodEnum<{
22
+ add: "add";
23
+ remove: "remove";
24
+ }>;
25
+ groups: z.ZodArray<z.ZodObject<{
26
+ id: z.ZodString;
27
+ code: z.ZodString;
28
+ name: z.ZodString;
29
+ }, z.core.$strict>>;
30
+ entries: z.ZodArray<z.ZodObject<{
31
+ userId: z.ZodString;
32
+ groupId: z.ZodString;
33
+ action: z.ZodEnum<{
34
+ add: "add";
35
+ remove: "remove";
36
+ }>;
37
+ before: z.ZodBoolean;
38
+ mapped: z.ZodBoolean;
39
+ }, z.core.$strict>>;
40
+ sha256: z.ZodString;
41
+ }, z.core.$strict>;
42
+ export type MembershipPlan = z.infer<typeof membershipPlanSchema>;
43
+ type State = 'completed' | 'skipped' | 'failed' | 'unknown' | 'pending';
44
+ type Outcome = MembershipChange & {
45
+ state: State;
46
+ before: boolean;
47
+ mapped: boolean;
48
+ };
49
+ export declare function parseTargetIds(value: unknown): string[];
50
+ export declare function validateMembershipPlan(value: unknown, client: IdentityClient, scope: MembershipScope, action: 'add' | 'remove'): MembershipPlan;
51
+ export interface MembershipInput {
52
+ client: IdentityClient;
53
+ scope: MembershipScope;
54
+ action: 'add' | 'remove';
55
+ ids?: string[] | undefined;
56
+ idsFile?: string | undefined;
57
+ allMembers?: boolean | undefined;
58
+ planFile?: string | undefined;
59
+ planOut?: string | undefined;
60
+ report?: string | undefined;
61
+ dryRun: boolean;
62
+ yes: boolean;
63
+ pagination: PaginationInput;
64
+ }
65
+ export declare function executeMembership(input: MembershipInput): Promise<{
66
+ authSurface: string;
67
+ teamMode: string;
68
+ subscription: string;
69
+ deployment: string;
70
+ tenant: string;
71
+ principalId: string;
72
+ contextFingerprint: string;
73
+ schemaDigest: string | undefined;
74
+ scope: {
75
+ kind: "group" | "user";
76
+ id: string;
77
+ };
78
+ action: "add" | "remove";
79
+ targetCount: number;
80
+ planSha256: string;
81
+ warnings: string[];
82
+ dryRun: boolean;
83
+ writeRequestSent: boolean;
84
+ serverValidated: boolean;
85
+ planPath: string | undefined;
86
+ plan: {
87
+ version: 1;
88
+ kind: "direct-group-membership";
89
+ contextFingerprint: string;
90
+ principalId: string;
91
+ subscription: string;
92
+ deployment: string;
93
+ tenant: string;
94
+ schemaDigest: string;
95
+ scope: {
96
+ kind: "group" | "user";
97
+ id: string;
98
+ };
99
+ action: "add" | "remove";
100
+ groups: {
101
+ id: string;
102
+ code: string;
103
+ name: string;
104
+ }[];
105
+ entries: {
106
+ userId: string;
107
+ groupId: string;
108
+ action: "add" | "remove";
109
+ before: boolean;
110
+ mapped: boolean;
111
+ }[];
112
+ sha256: string;
113
+ };
114
+ } | {
115
+ authSurface: string;
116
+ teamMode: string;
117
+ subscription: string;
118
+ deployment: string;
119
+ tenant: string;
120
+ principalId: string;
121
+ contextFingerprint: string;
122
+ schemaDigest: string | undefined;
123
+ scope: {
124
+ kind: "group" | "user";
125
+ id: string;
126
+ };
127
+ action: "add" | "remove";
128
+ targetCount: number;
129
+ planSha256: string;
130
+ warnings: string[];
131
+ dryRun: boolean;
132
+ writeRequestSent: boolean;
133
+ snapshot: string;
134
+ report: string;
135
+ reports: string[];
136
+ outcomes: Outcome[];
137
+ inverse: {
138
+ userId: string;
139
+ groupId: string;
140
+ action: "add" | "remove";
141
+ }[];
142
+ finalReport: string;
143
+ }>;
144
+ export {};
145
+ //# sourceMappingURL=membership.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"membership.d.ts","sourceRoot":"","sources":["../../src/identity-governance/membership.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAQL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAqBxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAiF,CAAC;AACnH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,KAAK,KAAK,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AACxE,KAAK,OAAO,GAAG,gBAAgB,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAErF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAIvD;AA0ED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,KAAK,GAAG,QAAQ,GACvB,cAAc,CAoBhB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0J7D"}