@rsaglobaltech/specgate 0.27.9 → 1.0.0-rc.1
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/CHANGELOG.md +36 -0
- package/dist/packages/core/src/application/ValidateChangeUseCase.js +19 -3
- package/dist/packages/core/src/application/ValidateChangeUseCase.js.map +1 -1
- package/dist/packages/core/src/domain/ApiContract.js +157 -0
- package/dist/packages/core/src/domain/ApiContract.js.map +1 -0
- package/dist/packages/core/src/domain/Approvals.js +127 -0
- package/dist/packages/core/src/domain/Approvals.js.map +1 -0
- package/dist/packages/core/src/domain/ChangeLayers.js +281 -0
- package/dist/packages/core/src/domain/ChangeLayers.js.map +1 -0
- package/dist/packages/core/src/domain/HarnessConfig.js.map +1 -1
- package/dist/packages/core/src/domain/HarnessGaps.js +182 -0
- package/dist/packages/core/src/domain/HarnessGaps.js.map +1 -0
- package/dist/packages/core/src/domain/HarnessReport.js +16 -1
- package/dist/packages/core/src/domain/HarnessReport.js.map +1 -1
- package/dist/packages/core/src/domain/HarnessRun.js.map +1 -1
- package/dist/packages/core/src/domain/Principles.js +119 -0
- package/dist/packages/core/src/domain/Principles.js.map +1 -0
- package/dist/packages/core/src/domain/RequirementGraph.js +12 -1
- package/dist/packages/core/src/domain/RequirementGraph.js.map +1 -1
- package/dist/packages/core/src/domain/Workspace.js +150 -0
- package/dist/packages/core/src/domain/Workspace.js.map +1 -0
- package/dist/packages/core/src/index.js +1 -0
- package/dist/packages/core/src/index.js.map +1 -1
- package/dist/packages/core/src/infrastructure/HarnessConfigFile.js +12 -0
- package/dist/packages/core/src/infrastructure/HarnessConfigFile.js.map +1 -1
- package/dist/packages/mcp-spec-driven/src/tools.js +18 -0
- package/dist/packages/mcp-spec-driven/src/tools.js.map +1 -1
- package/dist/scripts/alm/cli.js +45 -4
- package/dist/scripts/alm/cli.js.map +1 -1
- package/dist/scripts/alm/clients.js +3 -1
- package/dist/scripts/alm/clients.js.map +1 -1
- package/dist/scripts/alm/phases.js +279 -0
- package/dist/scripts/alm/phases.js.map +1 -0
- package/dist/scripts/alm/port.js +33 -5
- package/dist/scripts/alm/port.js.map +1 -1
- package/dist/scripts/alm/providers/azure.js +72 -11
- package/dist/scripts/alm/providers/azure.js.map +1 -1
- package/dist/scripts/alm/providers/github.js +67 -7
- package/dist/scripts/alm/providers/github.js.map +1 -1
- package/dist/scripts/alm/providers/index.js +8 -2
- package/dist/scripts/alm/providers/index.js.map +1 -1
- package/dist/scripts/alm/providers/jira.js +86 -8
- package/dist/scripts/alm/providers/jira.js.map +1 -1
- package/dist/scripts/alm/providers/linear.js +167 -0
- package/dist/scripts/alm/providers/linear.js.map +1 -0
- package/dist/scripts/change/artifacts.js +15 -1
- package/dist/scripts/change/artifacts.js.map +1 -1
- package/dist/scripts/change/instructions.js +39 -5
- package/dist/scripts/change/instructions.js.map +1 -1
- package/dist/scripts/cli/commands/alm/PhaseCommand.js +153 -0
- package/dist/scripts/cli/commands/alm/PhaseCommand.js.map +1 -0
- package/dist/scripts/cli/commands/alm/PullCommand.js +33 -2
- package/dist/scripts/cli/commands/alm/PullCommand.js.map +1 -1
- package/dist/scripts/cli/commands/alm/pull-back.js +104 -0
- package/dist/scripts/cli/commands/alm/pull-back.js.map +1 -0
- package/dist/scripts/cli/commands/change/ChangeCommand.js +92 -14
- package/dist/scripts/cli/commands/change/ChangeCommand.js.map +1 -1
- package/dist/scripts/cli/commands/change/TicketCommand.js +20 -7
- package/dist/scripts/cli/commands/change/TicketCommand.js.map +1 -1
- package/dist/scripts/cli/commands/harness/RunCommand.js +64 -20
- package/dist/scripts/cli/commands/harness/RunCommand.js.map +1 -1
- package/dist/scripts/cli/commands/project/AdoptCommand.js +44 -4
- package/dist/scripts/cli/commands/project/AdoptCommand.js.map +1 -1
- package/dist/scripts/cli/commands/project/MigrateCommand.js +166 -0
- package/dist/scripts/cli/commands/project/MigrateCommand.js.map +1 -0
- package/dist/scripts/cli/commands/project/OnboardCommand.js +23 -5
- package/dist/scripts/cli/commands/project/OnboardCommand.js.map +1 -1
- package/dist/scripts/cli/commands/quality/CheckCommand.js +25 -0
- package/dist/scripts/cli/commands/quality/CheckCommand.js.map +1 -1
- package/dist/scripts/cli/commands/quality/ValidateSpecsCommand.js +15 -0
- package/dist/scripts/cli/commands/quality/ValidateSpecsCommand.js.map +1 -1
- package/dist/scripts/cli/commands/spec/ContractCommand.js +117 -0
- package/dist/scripts/cli/commands/spec/ContractCommand.js.map +1 -0
- package/dist/scripts/cli/commands/spec/DraftCommand.js +22 -8
- package/dist/scripts/cli/commands/spec/DraftCommand.js.map +1 -1
- package/dist/scripts/cli/commands/spec/DriftCommand.js +128 -0
- package/dist/scripts/cli/commands/spec/DriftCommand.js.map +1 -0
- package/dist/scripts/cli/commands/spec/StatusCommand.js +12 -0
- package/dist/scripts/cli/commands/spec/StatusCommand.js.map +1 -1
- package/dist/scripts/cli/commands/spec/StudioCommand.js +43 -1
- package/dist/scripts/cli/commands/spec/StudioCommand.js.map +1 -1
- package/dist/scripts/cli/commands/workspace/WorkspaceCommand.js +485 -0
- package/dist/scripts/cli/commands/workspace/WorkspaceCommand.js.map +1 -0
- package/dist/scripts/contract.js +10 -0
- package/dist/scripts/contract.js.map +1 -0
- package/dist/scripts/docs/nav.js +16 -1
- package/dist/scripts/docs/nav.js.map +1 -1
- package/dist/scripts/draft/drafting-guide.js +6 -0
- package/dist/scripts/draft/drafting-guide.js.map +1 -1
- package/dist/scripts/draft/ticket-guide.js +5 -0
- package/dist/scripts/draft/ticket-guide.js.map +1 -1
- package/dist/scripts/drift.js +10 -0
- package/dist/scripts/drift.js.map +1 -0
- package/dist/scripts/harness/gap-evidence.js +149 -0
- package/dist/scripts/harness/gap-evidence.js.map +1 -0
- package/dist/scripts/harness/prompt.js +5 -1
- package/dist/scripts/harness/prompt.js.map +1 -1
- package/dist/scripts/harness/report.js +104 -5
- package/dist/scripts/harness/report.js.map +1 -1
- package/dist/scripts/lib/approvals.js +243 -0
- package/dist/scripts/lib/approvals.js.map +1 -0
- package/dist/scripts/lib/change-review.js +19 -11
- package/dist/scripts/lib/change-review.js.map +1 -1
- package/dist/scripts/lib/contracts.js +211 -0
- package/dist/scripts/lib/contracts.js.map +1 -0
- package/dist/scripts/lib/drift.js +80 -0
- package/dist/scripts/lib/drift.js.map +1 -0
- package/dist/scripts/lib/live-model.js +1 -0
- package/dist/scripts/lib/live-model.js.map +1 -1
- package/dist/scripts/lib/migrate.js +264 -0
- package/dist/scripts/lib/migrate.js.map +1 -0
- package/dist/scripts/lib/role-packages.js +230 -0
- package/dist/scripts/lib/role-packages.js.map +1 -0
- package/dist/scripts/lib/steering.js +180 -0
- package/dist/scripts/lib/steering.js.map +1 -0
- package/dist/scripts/lib/studio-app-page.js +28 -5
- package/dist/scripts/lib/studio-app-page.js.map +1 -1
- package/dist/scripts/lib/studio-app.js +29 -0
- package/dist/scripts/lib/studio-app.js.map +1 -1
- package/dist/scripts/lib/studio-route.js +20 -0
- package/dist/scripts/lib/studio-route.js.map +1 -1
- package/dist/scripts/lib/surface.js +55 -0
- package/dist/scripts/lib/surface.js.map +1 -1
- package/dist/scripts/lib/workspace-live-page.js +90 -0
- package/dist/scripts/lib/workspace-live-page.js.map +1 -0
- package/dist/scripts/lib/workspace-live.js +216 -0
- package/dist/scripts/lib/workspace-live.js.map +1 -0
- package/dist/scripts/lib/workspace.js +406 -0
- package/dist/scripts/lib/workspace.js.map +1 -0
- package/dist/scripts/migrate.js +10 -0
- package/dist/scripts/migrate.js.map +1 -0
- package/dist/scripts/schema/registry.js +12 -0
- package/dist/scripts/schema/registry.js.map +1 -1
- package/dist/scripts/workspace.js +10 -0
- package/dist/scripts/workspace.js.map +1 -0
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"azure.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/azure.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;
|
|
1
|
+
{"version":3,"file":"azure.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/azure.ts"],"names":[],"mappings":"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"}
|
|
@@ -27,12 +27,7 @@ const API_VERSION = "2022-11-28";
|
|
|
27
27
|
* which is what ADR-0021 asks for.
|
|
28
28
|
*/
|
|
29
29
|
class GitHubClient extends http_client_1.HttpAlmClient {
|
|
30
|
-
capabilities =
|
|
31
|
-
create: true,
|
|
32
|
-
readStatus: true,
|
|
33
|
-
close: true,
|
|
34
|
-
listIssues: true,
|
|
35
|
-
};
|
|
30
|
+
capabilities = GITHUB_CAPABILITIES;
|
|
36
31
|
headers;
|
|
37
32
|
repo;
|
|
38
33
|
constructor(cfg, fetchImpl) {
|
|
@@ -99,6 +94,54 @@ class GitHubClient extends http_client_1.HttpAlmClient {
|
|
|
99
94
|
url: issue.html_url ?? null,
|
|
100
95
|
}));
|
|
101
96
|
}
|
|
97
|
+
/**
|
|
98
|
+
* REQ-305: GitHub has two states, so a phase short of archived is a label —
|
|
99
|
+
* `specgate:proposed`, `specgate:building`, or the one `phases:` names — and
|
|
100
|
+
* the other phase's label comes off. Archived closes the issue.
|
|
101
|
+
*/
|
|
102
|
+
async setPhase(issueKey, phase, state) {
|
|
103
|
+
const n = issueNumber(issueKey);
|
|
104
|
+
if (phase === "archived") {
|
|
105
|
+
await this.closeIssue(n);
|
|
106
|
+
return "closed";
|
|
107
|
+
}
|
|
108
|
+
const label = state ?? `specgate:${phase}`;
|
|
109
|
+
const other = phase === "proposed" ? "specgate:building" : "specgate:proposed";
|
|
110
|
+
await this.request(`/repos/${this.repo}/issues/${n}/labels`, `GitHub label issue ${n}`, {
|
|
111
|
+
method: "POST",
|
|
112
|
+
headers: this.headers,
|
|
113
|
+
body: JSON.stringify({ labels: [label] }),
|
|
114
|
+
});
|
|
115
|
+
// The other phase's label may never have been set: a 404 is the answer
|
|
116
|
+
// that it is not there, which is what removing it wanted.
|
|
117
|
+
await this.fetchImpl(`${this.baseUrl}/repos/${this.repo}/issues/${n}/labels/${encodeURIComponent(other)}`, { method: "DELETE", headers: this.headers });
|
|
118
|
+
return label;
|
|
119
|
+
}
|
|
120
|
+
/** REQ-307: a new issue, attached to its parent as a sub-issue. */
|
|
121
|
+
async createSubIssue(parentKey, title) {
|
|
122
|
+
const parent = issueNumber(parentKey);
|
|
123
|
+
const created = await this.requestJson(`/repos/${this.repo}/issues`, `GitHub create a sub-issue of #${parent}`, {
|
|
124
|
+
method: "POST",
|
|
125
|
+
headers: this.headers,
|
|
126
|
+
body: JSON.stringify({ title, labels: ["spec-driven"] }),
|
|
127
|
+
});
|
|
128
|
+
await this.request(`/repos/${this.repo}/issues/${parent}/sub_issues`, `GitHub attach #${created.number} to #${parent}`, { method: "POST", headers: this.headers, body: JSON.stringify({ sub_issue_id: created.id }) });
|
|
129
|
+
return { key: String(created.number), url: created.html_url ?? null };
|
|
130
|
+
}
|
|
131
|
+
/** REQ-306: the issue's comments, oldest first. */
|
|
132
|
+
async listComments(issueKey) {
|
|
133
|
+
const comments = await this.requestJson(`/repos/${this.repo}/issues/${issueNumber(issueKey)}/comments?per_page=100`, `GitHub read the comments of #${issueKey}`, { headers: this.headers });
|
|
134
|
+
return (comments || []).map((c) => ({
|
|
135
|
+
id: String(c.id),
|
|
136
|
+
author: String(c.user?.login ?? ""),
|
|
137
|
+
body: String(c.body ?? ""),
|
|
138
|
+
}));
|
|
139
|
+
}
|
|
140
|
+
/** REQ-306: the issue's title and body. */
|
|
141
|
+
async readIssueText(issueKey) {
|
|
142
|
+
const issue = await this.requestJson(`/repos/${this.repo}/issues/${issueNumber(issueKey)}`, `GitHub read issue #${issueKey}`, { headers: this.headers });
|
|
143
|
+
return { title: String(issue.title ?? ""), body: String(issue.body ?? "") };
|
|
144
|
+
}
|
|
102
145
|
async closeIssue(issueKey) {
|
|
103
146
|
await this.request(`/repos/${this.repo}/issues/${issueKey}`, `GitHub close issue ${issueKey}`, {
|
|
104
147
|
method: "PATCH",
|
|
@@ -109,6 +152,23 @@ class GitHubClient extends http_client_1.HttpAlmClient {
|
|
|
109
152
|
});
|
|
110
153
|
}
|
|
111
154
|
}
|
|
155
|
+
/** An issue number as a path segment. */
|
|
156
|
+
function issueNumber(key) {
|
|
157
|
+
const n = String(key).replace(/^#/, "");
|
|
158
|
+
if (!/^\d+$/.test(n))
|
|
159
|
+
throw new Error(`GitHub: '${key}' is not an issue number.`);
|
|
160
|
+
return n;
|
|
161
|
+
}
|
|
162
|
+
const GITHUB_CAPABILITIES = {
|
|
163
|
+
create: true,
|
|
164
|
+
readStatus: true,
|
|
165
|
+
close: true,
|
|
166
|
+
listIssues: true,
|
|
167
|
+
phase: true,
|
|
168
|
+
subIssues: true,
|
|
169
|
+
comments: true,
|
|
170
|
+
readText: true,
|
|
171
|
+
};
|
|
112
172
|
exports.githubProvider = {
|
|
113
173
|
id: "github",
|
|
114
174
|
label: "GitHub Issues",
|
|
@@ -117,7 +177,7 @@ exports.githubProvider = {
|
|
|
117
177
|
// Only GitHub Enterprise Server needs a base URL; github.com is the default.
|
|
118
178
|
optional: ["base_url"],
|
|
119
179
|
},
|
|
120
|
-
capabilities:
|
|
180
|
+
capabilities: GITHUB_CAPABILITIES,
|
|
121
181
|
create: (cfg, fetchImpl) => new GitHubClient(cfg, fetchImpl),
|
|
122
182
|
};
|
|
123
183
|
exports.default = exports.githubProvider;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"github.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/github.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;
|
|
1
|
+
{"version":3,"file":"github.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/github.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,6 +5,7 @@ exports.getProvider = getProvider;
|
|
|
5
5
|
const jira_1 = require("./jira");
|
|
6
6
|
const azure_1 = require("./azure");
|
|
7
7
|
const github_1 = require("./github");
|
|
8
|
+
const linear_1 = require("./linear");
|
|
8
9
|
const port_1 = require("../port");
|
|
9
10
|
/**
|
|
10
11
|
* The provider registry. Adding an ALM is a row here plus a module beside it;
|
|
@@ -13,7 +14,12 @@ const port_1 = require("../port");
|
|
|
13
14
|
* The conformance kit iterates this list, so a provider that is registered is
|
|
14
15
|
* a provider that is tested — there is no way to add one quietly.
|
|
15
16
|
*/
|
|
16
|
-
exports.PROVIDERS = [
|
|
17
|
+
exports.PROVIDERS = [
|
|
18
|
+
jira_1.jiraProvider,
|
|
19
|
+
azure_1.azureProvider,
|
|
20
|
+
github_1.githubProvider,
|
|
21
|
+
linear_1.linearProvider,
|
|
22
|
+
];
|
|
17
23
|
const BY_ID = new Map(exports.PROVIDERS.map((p) => [p.id, p]));
|
|
18
24
|
/** Every registered provider id, in registration order. */
|
|
19
25
|
const providerIds = () => exports.PROVIDERS.map((p) => p.id);
|
|
@@ -25,7 +31,7 @@ exports.providerIds = providerIds;
|
|
|
25
31
|
// them here would make this repository's release cadence hostage to six
|
|
26
32
|
// vendors. Refusing them all would make the tool useless to a team on YouTrack.
|
|
27
33
|
//
|
|
28
|
-
// So: `jira`, `azure` and `
|
|
34
|
+
// So: `jira`, `azure`, `github` and `linear` are core — maintained here, exercised by the
|
|
29
35
|
// conformance kit in CI. Anything else is resolved by package name:
|
|
30
36
|
//
|
|
31
37
|
// provider: npm:specgate-alm-youtrack
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/index.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,6 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.jiraProvider = exports.SEARCH_LIMIT = void 0;
|
|
4
4
|
const http_client_1 = require("./http-client");
|
|
5
5
|
const TicketText_1 = require("../../../packages/core/src/domain/TicketText");
|
|
6
|
+
/**
|
|
7
|
+
* The status category of each phase (REQ-305). Jira's statuses are per
|
|
8
|
+
* project; its three categories are not, so they are the portable default.
|
|
9
|
+
*/
|
|
10
|
+
const PHASE_CATEGORY = {
|
|
11
|
+
proposed: "new",
|
|
12
|
+
building: "indeterminate",
|
|
13
|
+
archived: "done",
|
|
14
|
+
};
|
|
6
15
|
/** Issues per page, the most `/search/jql` returns with these fields. */
|
|
7
16
|
const PAGE_SIZE = 100;
|
|
8
17
|
/** Where a search stops: a pull of more than this is a query to narrow, not a page to read. */
|
|
@@ -19,15 +28,11 @@ const GATEWAY = "https://api.atlassian.com/ex/jira";
|
|
|
19
28
|
* `done_state` — configuring one would be read by nobody.
|
|
20
29
|
*/
|
|
21
30
|
class JiraClient extends http_client_1.HttpAlmClient {
|
|
22
|
-
capabilities =
|
|
23
|
-
create: true,
|
|
24
|
-
readStatus: true,
|
|
25
|
-
close: true,
|
|
26
|
-
listIssues: true,
|
|
27
|
-
};
|
|
31
|
+
capabilities = JIRA_CAPABILITIES;
|
|
28
32
|
headers;
|
|
29
33
|
projectKey;
|
|
30
34
|
issueType;
|
|
35
|
+
subtaskType;
|
|
31
36
|
cloudId;
|
|
32
37
|
acceptanceField;
|
|
33
38
|
gateway;
|
|
@@ -43,6 +48,7 @@ class JiraClient extends http_client_1.HttpAlmClient {
|
|
|
43
48
|
};
|
|
44
49
|
this.projectKey = String(cfg.project_key ?? "");
|
|
45
50
|
this.issueType = cfg.issue_type ?? "Task";
|
|
51
|
+
this.subtaskType = typeof cfg.subtask_type === "string" ? cfg.subtask_type : "Sub-task";
|
|
46
52
|
this.cloudId = cfg.cloud_id ? String(cfg.cloud_id).trim() : undefined;
|
|
47
53
|
this.acceptanceField = cfg.acceptance_field ? String(cfg.acceptance_field) : undefined;
|
|
48
54
|
}
|
|
@@ -165,6 +171,67 @@ class JiraClient extends http_client_1.HttpAlmClient {
|
|
|
165
171
|
body: JSON.stringify({ transition: { id: transition.id } }),
|
|
166
172
|
});
|
|
167
173
|
}
|
|
174
|
+
/**
|
|
175
|
+
* REQ-305: the transition into the state `phases:` names, or into the
|
|
176
|
+
* phase's status category. An issue already there is left alone: a workflow
|
|
177
|
+
* offers no transition from a status to itself.
|
|
178
|
+
*/
|
|
179
|
+
async setPhase(issueKey, phase, state) {
|
|
180
|
+
const wanted = (name, category) => state
|
|
181
|
+
? (name ?? "").toLowerCase() === state.toLowerCase()
|
|
182
|
+
: category === PHASE_CATEGORY[phase];
|
|
183
|
+
const current = await this.requestJson(`/rest/api/3/issue/${issueKeyPath(issueKey)}?fields=status`, `Jira read ${issueKey}`, { headers: this.headers });
|
|
184
|
+
const status = current.fields?.status;
|
|
185
|
+
if (status && wanted(status.name, status.statusCategory?.key))
|
|
186
|
+
return String(status.name);
|
|
187
|
+
const { transitions } = await this.requestJson(`/rest/api/3/issue/${issueKeyPath(issueKey)}/transitions`, `Jira list transitions for ${issueKey}`, { headers: this.headers });
|
|
188
|
+
const transition = (transitions ?? []).find((t) => wanted(t.to?.name, t.to?.statusCategory?.key) || (!!state && wanted(t.name)));
|
|
189
|
+
if (!transition) {
|
|
190
|
+
throw new Error(`Jira: ${issueKey} has no transition to ${state ? `"${state}"` : `a ${PHASE_CATEGORY[phase]} status`} from where it is.\n` +
|
|
191
|
+
`Fix: name the state of '${phase}' in phases: of alm.config.yaml, as your workflow calls it.`);
|
|
192
|
+
}
|
|
193
|
+
await this.request(`/rest/api/3/issue/${issueKeyPath(issueKey)}/transitions`, `Jira transition ${issueKey}`, {
|
|
194
|
+
method: "POST",
|
|
195
|
+
headers: this.headers,
|
|
196
|
+
body: JSON.stringify({ transition: { id: transition.id } }),
|
|
197
|
+
});
|
|
198
|
+
return String(transition.to?.name ?? state ?? PHASE_CATEGORY[phase]);
|
|
199
|
+
}
|
|
200
|
+
/** REQ-307: a sub-task of the change's ticket, one per repository. */
|
|
201
|
+
async createSubIssue(parentKey, title) {
|
|
202
|
+
issueKeyPath(parentKey);
|
|
203
|
+
const created = await this.requestJson("/rest/api/3/issue", `Jira create sub-task of ${parentKey}`, {
|
|
204
|
+
method: "POST",
|
|
205
|
+
headers: this.headers,
|
|
206
|
+
body: JSON.stringify({
|
|
207
|
+
fields: {
|
|
208
|
+
project: { key: this.projectKey },
|
|
209
|
+
issuetype: { name: this.subtaskType },
|
|
210
|
+
parent: { key: parentKey },
|
|
211
|
+
summary: title,
|
|
212
|
+
labels: ["spec-driven"],
|
|
213
|
+
},
|
|
214
|
+
}),
|
|
215
|
+
});
|
|
216
|
+
return { key: created.key, url: `${this.baseUrl}/browse/${created.key}` };
|
|
217
|
+
}
|
|
218
|
+
/** REQ-306: the ticket's comments, their bodies flattened out of ADF. */
|
|
219
|
+
async listComments(issueKey) {
|
|
220
|
+
const { comments } = await this.requestJson(`/rest/api/3/issue/${issueKeyPath(issueKey)}/comment?orderBy=created`, `Jira read the comments of ${issueKey}`, { headers: this.headers });
|
|
221
|
+
return (comments ?? []).map((c) => ({
|
|
222
|
+
id: String(c.id),
|
|
223
|
+
author: String(c.author?.displayName ?? ""),
|
|
224
|
+
body: (0, TicketText_1.documentText)(c.body),
|
|
225
|
+
}));
|
|
226
|
+
}
|
|
227
|
+
/** REQ-306: the ticket's summary and description, as text. */
|
|
228
|
+
async readIssueText(issueKey) {
|
|
229
|
+
const issue = await this.requestJson(`/rest/api/3/issue/${issueKeyPath(issueKey)}?fields=summary,description`, `Jira read ${issueKey}`, { headers: this.headers });
|
|
230
|
+
return {
|
|
231
|
+
title: String(issue.fields?.summary ?? ""),
|
|
232
|
+
body: (0, TicketText_1.documentText)(issue.fields?.description),
|
|
233
|
+
};
|
|
234
|
+
}
|
|
168
235
|
/** The workflow decides which transition means done; there may be none. */
|
|
169
236
|
async findDoneTransition(issueKey) {
|
|
170
237
|
const { transitions } = await this.requestJson(`/rest/api/3/issue/${issueKeyPath(issueKey)}/transitions`, `Jira list transitions for ${issueKey}`, { headers: this.headers });
|
|
@@ -186,6 +253,16 @@ function issueKeyPath(key) {
|
|
|
186
253
|
}
|
|
187
254
|
return encodeURIComponent(key);
|
|
188
255
|
}
|
|
256
|
+
const JIRA_CAPABILITIES = {
|
|
257
|
+
create: true,
|
|
258
|
+
readStatus: true,
|
|
259
|
+
close: true,
|
|
260
|
+
listIssues: true,
|
|
261
|
+
phase: true,
|
|
262
|
+
subIssues: true,
|
|
263
|
+
comments: true,
|
|
264
|
+
readText: true,
|
|
265
|
+
};
|
|
189
266
|
exports.jiraProvider = {
|
|
190
267
|
id: "jira",
|
|
191
268
|
label: "Jira Cloud",
|
|
@@ -196,9 +273,10 @@ exports.jiraProvider = {
|
|
|
196
273
|
// `cloud_id` routes a token created with scopes through Atlassian's
|
|
197
274
|
// gateway: a site id, or `auto` to read it from the site.
|
|
198
275
|
// `acceptance_field` and `epics` serve `propose --from-ticket` (ADR-0039).
|
|
199
|
-
|
|
276
|
+
// `subtask_type` names the sub-task type of REQ-307 when it is not "Sub-task".
|
|
277
|
+
optional: ["user_env", "issue_type", "subtask_type", "cloud_id", "acceptance_field", "epics"],
|
|
200
278
|
},
|
|
201
|
-
capabilities:
|
|
279
|
+
capabilities: JIRA_CAPABILITIES,
|
|
202
280
|
create: (cfg, fetchImpl) => new JiraClient(cfg, fetchImpl),
|
|
203
281
|
};
|
|
204
282
|
exports.default = exports.jiraProvider;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"jira.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/jira.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAC9C,6EAA4E;
|
|
1
|
+
{"version":3,"file":"jira.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/jira.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.linearProvider = void 0;
|
|
4
|
+
const http_client_1 = require("./http-client");
|
|
5
|
+
/** Linear's public API. A self-hosted Linear does not exist; `base_url` is for tests and proxies. */
|
|
6
|
+
const PUBLIC_API = "https://api.linear.app";
|
|
7
|
+
/**
|
|
8
|
+
* The state type of each phase (REQ-305). Linear's state names are the team's
|
|
9
|
+
* own; its types — backlog, unstarted, started, completed, canceled — are not.
|
|
10
|
+
*/
|
|
11
|
+
const PHASE_TYPE = {
|
|
12
|
+
proposed: "unstarted",
|
|
13
|
+
building: "started",
|
|
14
|
+
archived: "completed",
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* Linear (REQ-308), through its GraphQL API.
|
|
18
|
+
*
|
|
19
|
+
* Every operation is one POST to `/graphql`, so a failure is in the body as
|
|
20
|
+
* well as in the status: an answer with `errors` is a failed request even when
|
|
21
|
+
* it comes with a 200. The personal API key goes in `Authorization` as it is —
|
|
22
|
+
* Linear's keys are not bearer tokens — and never in a query.
|
|
23
|
+
*
|
|
24
|
+
* An issue is addressed by its identifier (`ENG-123`), which is what a person
|
|
25
|
+
* reads on the board and what `issue(id:)` accepts. A cancelled issue reads as
|
|
26
|
+
* open, as GitHub's "not planned" does: nobody delivered it.
|
|
27
|
+
*/
|
|
28
|
+
class LinearClient extends http_client_1.HttpAlmClient {
|
|
29
|
+
capabilities = LINEAR_CAPABILITIES;
|
|
30
|
+
headers;
|
|
31
|
+
teamKey;
|
|
32
|
+
team;
|
|
33
|
+
constructor(cfg, fetchImpl) {
|
|
34
|
+
super({ ...cfg, base_url: cfg.base_url ?? PUBLIC_API }, fetchImpl);
|
|
35
|
+
const token = http_client_1.HttpAlmClient.requireEnv(cfg.token_env);
|
|
36
|
+
this.headers = { Authorization: token, "Content-Type": "application/json" };
|
|
37
|
+
this.teamKey = String(cfg.team_key ?? "").trim();
|
|
38
|
+
if (!/^[A-Z][A-Z0-9]*$/.test(this.teamKey)) {
|
|
39
|
+
throw new Error(`alm.config.yaml: team_key '${this.teamKey}' is not a Linear team key.\n` +
|
|
40
|
+
"Fix: write the key that prefixes its issues, e.g. `team_key: ENG`.");
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
async graphql(what, query, variables) {
|
|
44
|
+
const res = await this.request("/graphql", what, {
|
|
45
|
+
method: "POST",
|
|
46
|
+
headers: this.headers,
|
|
47
|
+
body: JSON.stringify({ query, variables }),
|
|
48
|
+
});
|
|
49
|
+
const body = (await res.json());
|
|
50
|
+
if (body.errors && body.errors.length > 0) {
|
|
51
|
+
throw new Error(`${what} failed: ${body.errors.map((e) => e.message).join("; ")}`);
|
|
52
|
+
}
|
|
53
|
+
if (!body.data)
|
|
54
|
+
throw new Error(`${what} failed: Linear answered no data.`);
|
|
55
|
+
return body.data;
|
|
56
|
+
}
|
|
57
|
+
/** The team, with its workflow states, read once. */
|
|
58
|
+
teamOf() {
|
|
59
|
+
this.team ??= this.graphql(`Linear read team ${this.teamKey}`, "query TeamByKey($key: String!) { teams(filter: { key: { eq: $key } }) " +
|
|
60
|
+
"{ nodes { id states { nodes { id name type } } } } }", { key: this.teamKey }).then((data) => {
|
|
61
|
+
const team = data.teams?.nodes?.[0];
|
|
62
|
+
if (!team) {
|
|
63
|
+
throw new Error(`Linear: no team with key ${this.teamKey} that this key can see.\n` +
|
|
64
|
+
"Fix: check team_key, and that the API key belongs to a member of the team.");
|
|
65
|
+
}
|
|
66
|
+
return team;
|
|
67
|
+
});
|
|
68
|
+
return this.team;
|
|
69
|
+
}
|
|
70
|
+
async stateFor(phase, name) {
|
|
71
|
+
const states = (await this.teamOf()).states?.nodes ?? [];
|
|
72
|
+
const state = name
|
|
73
|
+
? states.find((s) => s.name.toLowerCase() === name.toLowerCase())
|
|
74
|
+
: states.find((s) => s.type === PHASE_TYPE[phase]);
|
|
75
|
+
if (!state) {
|
|
76
|
+
throw new Error(`Linear: team ${this.teamKey} has no ${name ? `state "${name}"` : `${PHASE_TYPE[phase]} state`}.\n` +
|
|
77
|
+
`Fix: name the state of '${phase}' in phases: of alm.config.yaml, as the team calls it.`);
|
|
78
|
+
}
|
|
79
|
+
return state;
|
|
80
|
+
}
|
|
81
|
+
async createIssue(reqId, title) {
|
|
82
|
+
return this.create(`${reqId} — ${title}`, `Linear create issue for ${reqId}`);
|
|
83
|
+
}
|
|
84
|
+
async create(title, what, parentId) {
|
|
85
|
+
const team = await this.teamOf();
|
|
86
|
+
const data = await this.graphql(what, "mutation IssueCreate($input: IssueCreateInput!) { issueCreate(input: $input) " +
|
|
87
|
+
"{ success issue { identifier url } } }", { input: { teamId: team.id, title, ...(parentId ? { parentId } : {}) } });
|
|
88
|
+
const issue = data.issueCreate?.issue;
|
|
89
|
+
if (!data.issueCreate?.success || !issue)
|
|
90
|
+
throw new Error(`${what} failed: not created.`);
|
|
91
|
+
return { key: issue.identifier, url: issue.url ?? null };
|
|
92
|
+
}
|
|
93
|
+
async issue(key) {
|
|
94
|
+
const data = await this.graphql(`Linear read ${key}`, "query IssueStatus($id: String!) { issue(id: $id) { id state { type } } }", { id: identifier(key) });
|
|
95
|
+
return data.issue;
|
|
96
|
+
}
|
|
97
|
+
async getIssueStatus(issueKey) {
|
|
98
|
+
return (await this.issue(issueKey)).state?.type === "completed" ? "done" : "open";
|
|
99
|
+
}
|
|
100
|
+
async closeIssue(issueKey) {
|
|
101
|
+
await this.setPhase(issueKey, "archived");
|
|
102
|
+
}
|
|
103
|
+
async listIssues(label) {
|
|
104
|
+
const data = await this.graphql(`Linear search for issues labelled ${label}`, "query IssuesByLabel($key: String!, $label: String!) { issues(first: 100, filter: { " +
|
|
105
|
+
'team: { key: { eq: $key } }, labels: { name: { eq: $label } }, state: { type: { nin: ["completed", "canceled"] } } }) ' +
|
|
106
|
+
"{ nodes { identifier title description url } } }", { key: this.teamKey, label });
|
|
107
|
+
return (data.issues?.nodes ?? []).map((i) => ({
|
|
108
|
+
key: i.identifier,
|
|
109
|
+
title: String(i.title ?? ""),
|
|
110
|
+
body: String(i.description ?? ""),
|
|
111
|
+
url: i.url ?? null,
|
|
112
|
+
}));
|
|
113
|
+
}
|
|
114
|
+
async setPhase(issueKey, phase, state) {
|
|
115
|
+
const target = await this.stateFor(phase, state);
|
|
116
|
+
const data = await this.graphql(`Linear move ${issueKey} to ${target.name}`, "mutation IssueUpdate($id: String!, $input: IssueUpdateInput!) { issueUpdate(id: $id, input: $input) { success } }", { id: identifier(issueKey), input: { stateId: target.id } });
|
|
117
|
+
if (!data.issueUpdate?.success)
|
|
118
|
+
throw new Error(`Linear move ${issueKey} failed.`);
|
|
119
|
+
return target.name;
|
|
120
|
+
}
|
|
121
|
+
async createSubIssue(parentKey, title) {
|
|
122
|
+
const parent = await this.issue(parentKey);
|
|
123
|
+
return this.create(title, `Linear create a sub-issue of ${parentKey}`, parent.id);
|
|
124
|
+
}
|
|
125
|
+
async listComments(issueKey) {
|
|
126
|
+
const data = await this.graphql(`Linear read the comments of ${issueKey}`, "query IssueComments($id: String!) { issue(id: $id) { comments(orderBy: createdAt) " +
|
|
127
|
+
"{ nodes { id body user { name } } } } }", { id: identifier(issueKey) });
|
|
128
|
+
return (data.issue?.comments?.nodes ?? []).map((c) => ({
|
|
129
|
+
id: String(c.id),
|
|
130
|
+
author: String(c.user?.name ?? ""),
|
|
131
|
+
body: String(c.body ?? ""),
|
|
132
|
+
}));
|
|
133
|
+
}
|
|
134
|
+
async readIssueText(issueKey) {
|
|
135
|
+
const data = await this.graphql(`Linear read ${issueKey}`, "query IssueText($id: String!) { issue(id: $id) { title description } }", { id: identifier(issueKey) });
|
|
136
|
+
return { title: String(data.issue?.title ?? ""), body: String(data.issue?.description ?? "") };
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
/** An issue identifier, checked before it is sent: `ENG-123`. */
|
|
140
|
+
function identifier(key) {
|
|
141
|
+
if (!/^[A-Z][A-Z0-9]*-\d+$/.test(key)) {
|
|
142
|
+
throw new Error(`Linear: '${key}' is not an issue identifier (TEAM-123).`);
|
|
143
|
+
}
|
|
144
|
+
return key;
|
|
145
|
+
}
|
|
146
|
+
const LINEAR_CAPABILITIES = {
|
|
147
|
+
create: true,
|
|
148
|
+
readStatus: true,
|
|
149
|
+
close: true,
|
|
150
|
+
listIssues: true,
|
|
151
|
+
phase: true,
|
|
152
|
+
subIssues: true,
|
|
153
|
+
comments: true,
|
|
154
|
+
readText: true,
|
|
155
|
+
};
|
|
156
|
+
exports.linearProvider = {
|
|
157
|
+
id: "linear",
|
|
158
|
+
label: "Linear",
|
|
159
|
+
config: {
|
|
160
|
+
required: ["team_key", "token_env"],
|
|
161
|
+
optional: ["base_url"],
|
|
162
|
+
},
|
|
163
|
+
capabilities: LINEAR_CAPABILITIES,
|
|
164
|
+
create: (cfg, fetchImpl) => new LinearClient(cfg, fetchImpl),
|
|
165
|
+
};
|
|
166
|
+
exports.default = exports.linearProvider;
|
|
167
|
+
//# sourceMappingURL=linear.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linear.js","sourceRoot":"","sources":["../../../../scripts/alm/providers/linear.ts"],"names":[],"mappings":"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"}
|
|
@@ -54,6 +54,7 @@ const fs = __importStar(require("node:fs"));
|
|
|
54
54
|
const path = __importStar(require("node:path"));
|
|
55
55
|
const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
|
|
56
56
|
const registry_1 = require("../schema/registry");
|
|
57
|
+
const ChangeLayers_1 = require("../../packages/core/src/domain/ChangeLayers");
|
|
57
58
|
/** The default graph, still exported for callers that predate schemas. */
|
|
58
59
|
exports.ARTIFACTS = [
|
|
59
60
|
{ id: "proposal", generates: "proposal.md", requires: [] },
|
|
@@ -94,6 +95,13 @@ function outputsPresent(projectDir, changeId, artifacts) {
|
|
|
94
95
|
// adds", not "the project has scenarios".
|
|
95
96
|
present[a.id] = hasAnyFile(path.join(dir, a.generates.split("*")[0]));
|
|
96
97
|
}
|
|
98
|
+
else if (a.id === "discover" || a.id === "design" || a.id === "tasks") {
|
|
99
|
+
// REQ-288: a layer still as `change new` wrote it is not written yet.
|
|
100
|
+
const file = path.join(dir, a.generates);
|
|
101
|
+
present[a.id] =
|
|
102
|
+
fs.existsSync(file) &&
|
|
103
|
+
!(0, ChangeLayers_1.isUntouchedLayer)(a.id, fs.readFileSync(file, "utf8"), changeId);
|
|
104
|
+
}
|
|
97
105
|
else {
|
|
98
106
|
present[a.id] = fs.existsSync(path.join(dir, a.generates));
|
|
99
107
|
}
|
|
@@ -115,8 +123,10 @@ function artifactState(projectDir, changeId, config) {
|
|
|
115
123
|
// creating anything — the artefact counts as done, not as missing.
|
|
116
124
|
const skipped = { specs: config.skip_specs === true };
|
|
117
125
|
// Lite rigor makes design optional in the same way.
|
|
118
|
-
|
|
126
|
+
// A layered change always has a design: it is the architect's layer.
|
|
127
|
+
if (config.rigor === "lite" && !exists.design && config.schema !== ChangeLayers_1.LAYERED_SCHEMA) {
|
|
119
128
|
skipped.design = true;
|
|
129
|
+
}
|
|
120
130
|
const satisfied = (id) => exists[id] || skipped[id];
|
|
121
131
|
return artifacts.map((a) => {
|
|
122
132
|
const missingDeps = (a.requires || []).filter((dep) => !satisfied(dep));
|
|
@@ -131,6 +141,10 @@ function artifactState(projectDir, changeId, config) {
|
|
|
131
141
|
status = "ready";
|
|
132
142
|
const entry = {
|
|
133
143
|
id: a.id,
|
|
144
|
+
...(config.schema === ChangeLayers_1.LAYERED_SCHEMA &&
|
|
145
|
+
(a.id === "discover" || a.id === "design" || a.id === "tasks")
|
|
146
|
+
? { owner: (0, ChangeLayers_1.layer)(a.id).owner }
|
|
147
|
+
: {}),
|
|
134
148
|
outputPath: a.generates,
|
|
135
149
|
status,
|
|
136
150
|
requires: a.requires || [],
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../scripts/change/artifacts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../scripts/change/artifacts.ts"],"names":[],"mappings":"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"}
|