@msn-control/liftoff 0.9.8 → 0.10.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.
Files changed (107) hide show
  1. package/DEVELOPER.md +142 -0
  2. package/README.md +26 -18
  3. package/assets/governance/single-maintainer-gitflow/policy.md +62 -13
  4. package/dist/args.js +21 -0
  5. package/dist/args.js.map +1 -1
  6. package/dist/artifact-lifecycle.d.ts +1 -1
  7. package/dist/artifact-lifecycle.js +5 -0
  8. package/dist/artifact-lifecycle.js.map +1 -1
  9. package/dist/commands.js +355 -13
  10. package/dist/commands.js.map +1 -1
  11. package/dist/file-system.js +100 -13
  12. package/dist/file-system.js.map +1 -1
  13. package/dist/governance-activation/activation-state.d.ts +32 -0
  14. package/dist/governance-activation/activation-state.js +165 -0
  15. package/dist/governance-activation/activation-state.js.map +1 -0
  16. package/dist/governance-activation/approvals.d.ts +188 -0
  17. package/dist/governance-activation/approvals.js +508 -0
  18. package/dist/governance-activation/approvals.js.map +1 -0
  19. package/dist/governance-activation/canonical-json.d.ts +3 -0
  20. package/dist/governance-activation/canonical-json.js +36 -0
  21. package/dist/governance-activation/canonical-json.js.map +1 -0
  22. package/dist/governance-activation/commands.d.ts +10 -0
  23. package/dist/governance-activation/commands.js +1023 -0
  24. package/dist/governance-activation/commands.js.map +1 -0
  25. package/dist/governance-activation/compatibility.d.ts +68 -0
  26. package/dist/governance-activation/compatibility.js +447 -0
  27. package/dist/governance-activation/compatibility.js.map +1 -0
  28. package/dist/governance-activation/credentials.d.ts +160 -0
  29. package/dist/governance-activation/credentials.js +403 -0
  30. package/dist/governance-activation/credentials.js.map +1 -0
  31. package/dist/governance-activation/doctor.d.ts +10 -0
  32. package/dist/governance-activation/doctor.js +379 -0
  33. package/dist/governance-activation/doctor.js.map +1 -0
  34. package/dist/governance-activation/evidence.d.ts +49 -0
  35. package/dist/governance-activation/evidence.js +246 -0
  36. package/dist/governance-activation/evidence.js.map +1 -0
  37. package/dist/governance-activation/graph.d.ts +397 -0
  38. package/dist/governance-activation/graph.js +441 -0
  39. package/dist/governance-activation/graph.js.map +1 -0
  40. package/dist/governance-activation/identity.d.ts +35 -0
  41. package/dist/governance-activation/identity.js +89 -0
  42. package/dist/governance-activation/identity.js.map +1 -0
  43. package/dist/governance-activation/index.d.ts +18 -0
  44. package/dist/governance-activation/index.js +19 -0
  45. package/dist/governance-activation/index.js.map +1 -0
  46. package/dist/governance-activation/migration.d.ts +44 -0
  47. package/dist/governance-activation/migration.js +268 -0
  48. package/dist/governance-activation/migration.js.map +1 -0
  49. package/dist/governance-activation/readiness.d.ts +23 -0
  50. package/dist/governance-activation/readiness.js +158 -0
  51. package/dist/governance-activation/readiness.js.map +1 -0
  52. package/dist/governance-activation/reconciliation.d.ts +11 -0
  53. package/dist/governance-activation/reconciliation.js +58 -0
  54. package/dist/governance-activation/reconciliation.js.map +1 -0
  55. package/dist/governance-activation/release-integrity.d.ts +11 -0
  56. package/dist/governance-activation/release-integrity.js +49 -0
  57. package/dist/governance-activation/release-integrity.js.map +1 -0
  58. package/dist/governance-activation/seed-lifecycle.d.ts +116 -0
  59. package/dist/governance-activation/seed-lifecycle.js +609 -0
  60. package/dist/governance-activation/seed-lifecycle.js.map +1 -0
  61. package/dist/governance-activation/source-of-truth.d.ts +164 -0
  62. package/dist/governance-activation/source-of-truth.js +986 -0
  63. package/dist/governance-activation/source-of-truth.js.map +1 -0
  64. package/dist/governance-activation/task-projection.d.ts +21 -0
  65. package/dist/governance-activation/task-projection.js +75 -0
  66. package/dist/governance-activation/task-projection.js.map +1 -0
  67. package/dist/governance-activation/transitions.d.ts +163 -0
  68. package/dist/governance-activation/transitions.js +2128 -0
  69. package/dist/governance-activation/transitions.js.map +1 -0
  70. package/dist/governance-activation/type-contract.d.ts +1 -0
  71. package/dist/governance-activation/type-contract.js +27 -0
  72. package/dist/governance-activation/type-contract.js.map +1 -0
  73. package/dist/governance-activation/types.d.ts +390 -0
  74. package/dist/governance-activation/types.js +108 -0
  75. package/dist/governance-activation/types.js.map +1 -0
  76. package/dist/governance-activation/validators.d.ts +17 -0
  77. package/dist/governance-activation/validators.js +1305 -0
  78. package/dist/governance-activation/validators.js.map +1 -0
  79. package/dist/init-filesystem.js +5 -1
  80. package/dist/init-filesystem.js.map +1 -1
  81. package/dist/planner.js +3 -3
  82. package/dist/planner.js.map +1 -1
  83. package/dist/power-apps-templates.js +14 -1
  84. package/dist/power-apps-templates.js.map +1 -1
  85. package/dist/process-runner.d.ts +3 -0
  86. package/dist/process-runner.js +68 -10
  87. package/dist/process-runner.js.map +1 -1
  88. package/dist/repository-governance.d.ts +13 -3
  89. package/dist/repository-governance.js +385 -52
  90. package/dist/repository-governance.js.map +1 -1
  91. package/dist/telemetry/contract.d.ts +1 -1
  92. package/dist/telemetry/contract.js +6 -0
  93. package/dist/telemetry/contract.js.map +1 -1
  94. package/dist/templates.js +320 -25
  95. package/dist/templates.js.map +1 -1
  96. package/dist/types.d.ts +14 -6
  97. package/docs/cli-reference.md +60 -12
  98. package/docs/configuration-and-manifests.md +40 -16
  99. package/docs/existing-repositories.md +22 -11
  100. package/docs/getting-started.md +46 -10
  101. package/docs/prerequisites.md +5 -0
  102. package/docs/project-structure.md +34 -5
  103. package/docs/repository-governance.md +200 -203
  104. package/docs/safety-and-consent.md +29 -2
  105. package/docs/troubleshooting.md +74 -4
  106. package/docs/workloads.md +1 -1
  107. package/package.json +2 -1
@@ -0,0 +1,108 @@
1
+ export const phaseIds = [
2
+ 'seed-valid',
3
+ 'seed-verified',
4
+ 'seed-archived',
5
+ 'committed',
6
+ 'pushed',
7
+ 'phase-0-complete',
8
+ 'activation-approved',
9
+ 'credential-ready',
10
+ 'provider-ready',
11
+ 'state-path-selected',
12
+ 'existing-private-path',
13
+ 'bootstrap-local',
14
+ 'runner-ready',
15
+ 'private-backend-proof',
16
+ 'remote-import-verified',
17
+ 'remote-ready',
18
+ 'application-foundation',
19
+ 'workflow-source-ready',
20
+ 'dev-proof',
21
+ 'staging-qualified',
22
+ 'production-rehearsed',
23
+ 'green-red-proof',
24
+ 'enforcement-approved',
25
+ 'rulesets-applied',
26
+ 'live-readback',
27
+ 'bootstrap-state-disposed'
28
+ ];
29
+ export const phaseStates = [
30
+ 'pending',
31
+ 'blocked',
32
+ 'ready',
33
+ 'approved',
34
+ 'running',
35
+ 'verified',
36
+ 'failed',
37
+ 'inapplicable',
38
+ 'retained',
39
+ 'disposed'
40
+ ];
41
+ export const mutationClasses = [
42
+ 'none',
43
+ 'read-worktree',
44
+ 'write-activation-state',
45
+ 'write-evidence',
46
+ 'write-openspec-seed',
47
+ 'write-openspec-governance',
48
+ 'write-local-state',
49
+ 'delete-local-state',
50
+ 'write-workflows',
51
+ 'write-ruleset-source',
52
+ 'git-commit',
53
+ 'git-push',
54
+ 'github-read',
55
+ 'github-write',
56
+ 'github-secret-write',
57
+ 'azure-read',
58
+ 'azure-provider-register',
59
+ 'azure-network-provision',
60
+ 'azure-state-import',
61
+ 'azure-resource-provision',
62
+ 'github-ruleset-write'
63
+ ];
64
+ export const approvalGateKinds = [
65
+ 'none',
66
+ 'repository-publish',
67
+ 'activation-plan',
68
+ 'credential-enrollment',
69
+ 'infrastructure-cost',
70
+ 'enforcement',
71
+ 'destructive-disposal',
72
+ 'external-blocker'
73
+ ];
74
+ export const humanAuthorityQuestionKinds = [
75
+ 'repository-creation-initial-commit-push',
76
+ 'credential-enrollment',
77
+ 'billed-infrastructure-policy-exception-cost-ceiling',
78
+ 'final-enforcement',
79
+ 'destructive-operation',
80
+ 'external-blocker'
81
+ ];
82
+ export const invalidationInputKinds = [
83
+ 'activation-identity',
84
+ 'graph-hash',
85
+ 'baseline-sha',
86
+ 'project-files',
87
+ 'policy',
88
+ 'approval-envelope',
89
+ 'credentials',
90
+ 'provider-inventory',
91
+ 'runner-inventory',
92
+ 'remote-state',
93
+ 'workflow-source',
94
+ 'live-readback',
95
+ 'security-evidence',
96
+ 'ruleset-readback'
97
+ ];
98
+ export const rollbackKinds = ['none', 'retain', 'reverse-to', 'dispose'];
99
+ export const runnerPreflightDisplayNameTemplate = '<repo>-runner-preflight-read';
100
+ export const runnerPreflightSecretName = 'RUNNER_CONFIGURATION_READ_TOKEN';
101
+ export const runnerPreflightPatLifetimeDays = 30;
102
+ export const runnerPreflightRotationLeadDays = 7;
103
+ export const runnerPreflightRepositoryPermissions = ['metadata:read'];
104
+ export const runnerPreflightOrganizationPermissions = [
105
+ 'hosted-runners:read',
106
+ 'network-configurations:read'
107
+ ];
108
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/governance-activation/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,YAAY;IACZ,eAAe;IACf,eAAe;IACf,WAAW;IACX,QAAQ;IACR,kBAAkB;IAClB,qBAAqB;IACrB,kBAAkB;IAClB,gBAAgB;IAChB,qBAAqB;IACrB,uBAAuB;IACvB,iBAAiB;IACjB,cAAc;IACd,uBAAuB;IACvB,wBAAwB;IACxB,cAAc;IACd,wBAAwB;IACxB,uBAAuB;IACvB,WAAW;IACX,mBAAmB;IACnB,sBAAsB;IACtB,iBAAiB;IACjB,sBAAsB;IACtB,kBAAkB;IAClB,eAAe;IACf,0BAA0B;CAClB,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,SAAS;IACT,OAAO;IACP,UAAU;IACV,SAAS;IACT,UAAU;IACV,QAAQ;IACR,cAAc;IACd,UAAU;IACV,UAAU;CACF,CAAC;AAQX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,eAAe;IACf,wBAAwB;IACxB,gBAAgB;IAChB,qBAAqB;IACrB,2BAA2B;IAC3B,mBAAmB;IACnB,oBAAoB;IACpB,iBAAiB;IACjB,sBAAsB;IACtB,YAAY;IACZ,UAAU;IACV,aAAa;IACb,cAAc;IACd,qBAAqB;IACrB,YAAY;IACZ,yBAAyB;IACzB,yBAAyB;IACzB,oBAAoB;IACpB,0BAA0B;IAC1B,sBAAsB;CACd,CAAC;AAIX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,oBAAoB;IACpB,iBAAiB;IACjB,uBAAuB;IACvB,qBAAqB;IACrB,aAAa;IACb,sBAAsB;IACtB,kBAAkB;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,yCAAyC;IACzC,uBAAuB;IACvB,qDAAqD;IACrD,mBAAmB;IACnB,uBAAuB;IACvB,kBAAkB;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,qBAAqB;IACrB,YAAY;IACZ,cAAc;IACd,eAAe;IACf,QAAQ;IACR,mBAAmB;IACnB,aAAa;IACb,oBAAoB;IACpB,kBAAkB;IAClB,cAAc;IACd,iBAAiB;IACjB,eAAe;IACf,mBAAmB;IACnB,kBAAkB;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAU,CAAC;AAgWlF,MAAM,CAAC,MAAM,kCAAkC,GAAG,8BAAuC,CAAC;AAC1F,MAAM,CAAC,MAAM,yBAAyB,GAAG,iCAA0C,CAAC;AACpF,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAW,CAAC;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAU,CAAC;AAC1D,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,eAAe,CAAU,CAAC;AAC/E,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACpD,qBAAqB;IACrB,6BAA6B;CACrB,CAAC"}
@@ -0,0 +1,17 @@
1
+ import type { ActivationIdentity, ApprovalEnvelope, CredentialPolicy, EvidenceHeader, GraphReconciliationRecord, LiveReadbackProof, ManagedPhaseGraph, SavedTransitionPlan, SupersessionRecord, UserActivationState } from './types.js';
2
+ export declare function validateActivationIdentity(value: unknown): ActivationIdentity;
3
+ export declare function validateManagedPhaseGraph(value: unknown): ManagedPhaseGraph;
4
+ export declare function assertCanonicalGraphValid(): void;
5
+ export declare function validateUserActivationState(value: unknown): UserActivationState;
6
+ export declare function validateEvidenceHeader(value: unknown): EvidenceHeader;
7
+ export declare function validateLiveReadbackProof(value: unknown): LiveReadbackProof;
8
+ export declare function validateApprovalEnvelope(value: unknown, options?: {
9
+ expectedIdentity?: ActivationIdentity;
10
+ now?: Date;
11
+ requireUnexpired?: boolean;
12
+ }): ApprovalEnvelope;
13
+ export declare function validateSavedTransitionPlan(value: unknown): SavedTransitionPlan;
14
+ export declare function validateSupersessionRecord(value: unknown): SupersessionRecord;
15
+ export declare function validateGraphReconciliationRecord(value: unknown, recognizedGraphHashes?: ReadonlySet<string>): GraphReconciliationRecord;
16
+ export declare function validateCredentialPolicy(value: unknown): CredentialPolicy;
17
+ export declare function validFixtureIdentity(): ActivationIdentity;