@rsaglobaltech/specgate 0.27.9 → 1.0.0-rc.1

package/dist/scripts/alm/cli.js

@@ -10,6 +10,8 @@
  *   specgate alm link   <REQ-id> <issue-key> [--project-dir <dir>]
  *   specgate alm status [--project-dir <dir>]
  *   specgate alm pr     <change> [--no-push] [--no-check] [--project-dir <dir>]
+ *   specgate alm phase  <change> [--project-dir <dir>] [--json]
+ *   specgate alm move   <change> [<phase>] [--project-dir <dir>] [--json]
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -51,6 +53,8 @@ const clients_1 = require("./clients");
 const diagnostics_1 = require("../lib/diagnostics");
 const PullCommand_1 = require("../cli/commands/alm/PullCommand");
 const PrCommand_1 = require("../cli/commands/alm/PrCommand");
+const PhaseCommand_1 = require("../cli/commands/alm/PhaseCommand");
+const phases_1 = require("./phases");
 const ui = __importStar(require("../lib/ui"));
 function logInfo(msg) {
     process.stdout.write(ui.logLine(msg));
@@ -67,9 +71,16 @@ function usage() {
         "  specgate alm link   <REQ-id> <issue-key> [--project-dir <dir>]\n" +
         "  specgate alm status [--project-dir <dir>]\n" +
         "  specgate alm pull   [--label <name>] [--project-dir <dir>] [--dry-run]\n" +
-        "  specgate alm pr     <change> [--no-push] [--no-check] [--project-dir <dir>]\n\n" +
+        "  specgate alm pr     <change> [--no-push] [--no-check] [--project-dir <dir>]\n" +
+        "  specgate alm phase  <change> [--project-dir <dir>] [--json]\n" +
+        "  specgate alm move   <change> [<phase>] [--project-dir <dir>] [--json]\n\n" +
         "sync   Creates an ALM issue for every unlinked REQ, closes issues whose REQ\n" +
         "       is Implemented, and reports drift (issue done, REQ still open).\n" +
+        "       Moves each change's ticket to its phase (proposed, building, archived)\n" +
+        "       and creates a sub-issue per repository it names. `mirror: false` in\n" +
+        "       alm.config.yaml skips the issue per REQ when tickets are the source.\n" +
+        "phase  Where a change stands and what the board was told. No network.\n" +
+        "move   Move a change's ticket to its phase now, or to the phase named.\n" +
         "link   Manually map an existing issue to a requirement.\n" +
         "status Print the current REQ ↔ issue mapping without network access.\n" +
         "pull   Open a change per labelled issue, from its title and description;\n" +
@@ -150,8 +161,30 @@ async function main() {
                 (0, diagnostics_1.printDiagnostics)(configFindings, process.stdout);
             const client = (0, clients_1.makeClient)(cfg, undefined, projectDir);
             const map = (0, core_1.readAlmMap)(projectDir);
-            const reqs = (0, core_1.extractRequirements)(projectDir);
+            // `mirror: false`: the tickets are the source, so no issue per requirement.
+            const mirror = cfg.mirror !== false && String(cfg.mirror) !== "false";
+            const reqs = mirror ? (0, core_1.extractRequirements)(projectDir) : [];
             const actions = await (0, core_1.syncRequirements)(reqs, map, client, { dryRun: opts.dryRun });
+            // REQ-305, REQ-307: the board follows each change with a ticket.
+            const changes = (0, phases_1.boardChanges)(projectDir);
+            const phases = (0, phases_1.readPhaseMap)(projectDir);
+            const moves = await (0, phases_1.syncPhases)(changes, phases, client, cfg, { dryRun: opts.dryRun });
+            const children = await (0, phases_1.syncSubIssues)(changes, phases, client, { dryRun: opts.dryRun });
+            (0, phases_1.writePhaseMap)(projectDir, phases, opts.dryRun);
+            for (const m of moves) {
+                if (m.action === "in-sync")
+                    continue;
+                if (m.action === "phase-unsupported")
+                    logWarn(`${m.change}: ${m.detail}`);
+                else
+                    logInfo(`${m.action} ${m.change} ${m.issue} → ${m.state}`);
+            }
+            for (const c of children) {
+                if (c.detail)
+                    logWarn(`${c.change}: ${c.detail}`);
+                else
+                    logInfo(`${c.action} sub-issue ${c.change} ${c.repo}${c.issue ? ` → ${c.issue}` : ""}`);
+            }
             let drift = 0;
             for (const a of actions) {
                 if (a.action === "drift") {
@@ -162,7 +195,7 @@ async function main() {
                     logInfo(`${a.action} ${a.req}${a.issue ? ` → ${a.issue}` : ""}`);
                 }
             }
-            if (!opts.dryRun)
+            if (!opts.dryRun && mirror)
                 (0, core_1.writeAlmMap)(projectDir, map, false);
             const summary = actions.reduce((acc, a) => {
                 acc[a.action] = (acc[a.action] || 0) + 1;
@@ -186,6 +219,14 @@ async function main() {
         await (0, PrCommand_1.main)(argv.slice(1));
         return;
     }
+    if (sub === "phase") {
+        await (0, PhaseCommand_1.phaseMain)(argv.slice(1));
+        return;
+    }
+    if (sub === "move") {
+        await (0, PhaseCommand_1.moveMain)(argv.slice(1));
+        return;
+    }
     if (sub === "pull") {
         // Implemented outside `scripts/alm/` on purpose: ADR-0021 forbids this
         // subsystem from writing the spec tree, and a pull has to produce files.
@@ -193,7 +234,7 @@ async function main() {
         await (0, PullCommand_1.main)(argv.slice(1));
         return;
     }
-    logError(`Unknown alm sub-command: ${sub || "(none)"}. Expected: sync, link, status, pull, pr`);
+    logError(`Unknown alm sub-command: ${sub || "(none)"}. Expected: sync, link, status, pull, pr, phase, move`);
     usage();
     process.exit(2);
 }

package/dist/scripts/alm/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../scripts/alm/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../scripts/alm/cli.ts"],"names":[],"mappings":"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"}

package/dist/scripts/alm/clients.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.githubClient = exports.azureClient = exports.jiraClient = void 0;
+exports.linearClient = exports.githubClient = exports.azureClient = exports.jiraClient = void 0;
 exports.makeClient = makeClient;
 const providers_1 = require("./providers");
 /**
@@ -27,4 +27,6 @@ const azureClient = (cfg, fetchImpl) => (0, providers_1.getProvider)("azure").cr
 exports.azureClient = azureClient;
 const githubClient = (cfg, fetchImpl) => (0, providers_1.getProvider)("github").create(cfg, fetchImpl);
 exports.githubClient = githubClient;
+const linearClient = (cfg, fetchImpl) => (0, providers_1.getProvider)("linear").create(cfg, fetchImpl);
+exports.linearClient = linearClient;
 //# sourceMappingURL=clients.js.map

package/dist/scripts/alm/clients.js.map

@@ -1 +1 @@
-{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../../scripts/alm/clients.ts"],"names":[],"mappings":";;;AAeA,gCAEC;AAjBD,2CAA0C;AAG1C;;;;;;;;;;;GAWG;AACH,SAAgB,UAAU,CAAC,GAAc,EAAE,SAAqB,EAAE,UAAmB;IACnF,OAAO,IAAA,uBAAW,EAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACtE,CAAC;AAED,6EAA6E;AAC7E,4EAA4E;AAC5E,oCAAoC;AAC7B,MAAM,UAAU,GAAG,CAAC,GAAc,EAAE,SAAqB,EAAa,EAAE,CAC7E,IAAA,uBAAW,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AADhC,QAAA,UAAU,cACsB;AAEtC,MAAM,WAAW,GAAG,CAAC,GAAc,EAAE,SAAqB,EAAa,EAAE,CAC9E,IAAA,uBAAW,EAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AADjC,QAAA,WAAW,eACsB;AAEvC,MAAM,YAAY,GAAG,CAAC,GAAc,EAAE,SAAqB,EAAa,EAAE,CAC/E,IAAA,uBAAW,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AADlC,QAAA,YAAY,gBACsB"}
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../../scripts/alm/clients.ts"],"names":[],"mappings":";;;AAeA,gCAEC;AAjBD,2CAA0C;AAG1C;;;;;;;;;;;GAWG;AACH,SAAgB,UAAU,CAAC,GAAc,EAAE,SAAqB,EAAE,UAAmB;IACnF,OAAO,IAAA,uBAAW,EAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACtE,CAAC;AAED,6EAA6E;AAC7E,4EAA4E;AAC5E,oCAAoC;AAC7B,MAAM,UAAU,GAAG,CAAC,GAAc,EAAE,SAAqB,EAAa,EAAE,CAC7E,IAAA,uBAAW,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AADhC,QAAA,UAAU,cACsB;AAEtC,MAAM,WAAW,GAAG,CAAC,GAAc,EAAE,SAAqB,EAAa,EAAE,CAC9E,IAAA,uBAAW,EAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AADjC,QAAA,WAAW,eACsB;AAEvC,MAAM,YAAY,GAAG,CAAC,GAAc,EAAE,SAAqB,EAAa,EAAE,CAC/E,IAAA,uBAAW,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AADlC,QAAA,YAAY,gBACsB;AAExC,MAAM,YAAY,GAAG,CAAC,GAAc,EAAE,SAAqB,EAAa,EAAE,CAC/E,IAAA,uBAAW,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AADlC,QAAA,YAAY,gBACsB"}

package/dist/scripts/alm/phases.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * The board follows the change (REQ-305, REQ-307).
+ *
+ * A change's phase is read from the repository, never from the board: open
+ * and not yet built, one of its requirements being built, or archived. The
+ * board is told; it is never asked what the change is (ADR-0021). What the
+ * sync has told the board is kept in `.specops/alm-phases.json`, beside the
+ * REQ ↔ issue mapping, so a move already made is not made again and a
+ * sub-issue is never created twice.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHASES_RELPATH = void 0;
+exports.readPhaseMap = readPhaseMap;
+exports.writePhaseMap = writePhaseMap;
+exports.changeTicket = changeTicket;
+exports.boardChanges = boardChanges;
+exports.namedState = namedState;
+exports.movePhase = movePhase;
+exports.syncPhases = syncPhases;
+exports.syncSubIssues = syncSubIssues;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const YamlLite_1 = require("../../packages/core/src/domain/YamlLite");
+exports.PHASES_RELPATH = path.join(".specops", "alm-phases.json");
+const CHANGES = path.join("docs", "specs", "changes");
+// ── The map ───────────────────────────────────────────────────────────────────
+function readPhaseMap(projectDir) {
+    const mapPath = path.join(projectDir, exports.PHASES_RELPATH);
+    if (!fs.existsSync(mapPath))
+        return {};
+    return JSON.parse(fs.readFileSync(mapPath, "utf8"));
+}
+function writePhaseMap(projectDir, map, dryRun) {
+    const mapPath = path.join(projectDir, exports.PHASES_RELPATH);
+    if (dryRun)
+        return mapPath;
+    fs.mkdirSync(path.dirname(mapPath), { recursive: true });
+    fs.writeFileSync(mapPath, `${JSON.stringify(map, null, 2)}\n`, "utf8");
+    return mapPath;
+}
+// ── Changes and their phase ───────────────────────────────────────────────────
+/** The ticket a change carries: `ticket:`, or the issue `alm pull` opened it from. */
+function changeTicket(yaml) {
+    const ticket = typeof yaml.ticket === "string" ? yaml.ticket.trim() : "";
+    if (ticket)
+        return ticket;
+    const origin = typeof yaml.origin === "string" ? /^alm:(\S+)$/.exec(yaml.origin.trim()) : null;
+    return origin ? origin[1] : null;
+}
+function readYaml(file) {
+    if (!fs.existsSync(file))
+        return {};
+    return ((0, YamlLite_1.parseYamlLite)(fs.readFileSync(file, "utf8")) || {});
+}
+function deltaRequirements(changeDir) {
+    const found = new Set();
+    const walk = (dir) => {
+        if (!fs.existsSync(dir))
+            return;
+        for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else if (e.name === "spec.md") {
+                for (const m of fs
+                    .readFileSync(full, "utf8")
+                    .matchAll(/^###\s+Requirement:\s+(REQ-\d+)/gm)) {
+                    found.add(m[1]);
+                }
+            }
+        }
+    };
+    walk(path.join(changeDir, "specs"));
+    return [...found];
+}
+/** The local `harness/REQ-NNN` branches: a requirement the harness has started. */
+function harnessBranches(projectDir) {
+    const r = (0, node_child_process_1.spawnSync)("git", ["branch", "--list", "harness/REQ-*", "--format=%(refname:short)"], {
+        cwd: projectDir,
+        encoding: "utf8",
+    });
+    if (r.status !== 0)
+        return new Set();
+    return new Set(r.stdout
+        .split("\n")
+        .map((l) => l.trim().replace(/^harness\//, ""))
+        .filter(Boolean));
+}
+/** Requirements the matrix says are delivered. */
+function implementedRequirements(projectDir) {
+    const file = path.join(projectDir, "docs", "specs", "traceability.md");
+    const done = new Set();
+    if (!fs.existsSync(file))
+        return done;
+    for (const line of fs.readFileSync(file, "utf8").split("\n")) {
+        const cells = line.split("|").map((c) => c.trim());
+        const req = cells.find((c) => /^REQ-\d+$/.test(c));
+        if (req && /^(Implemented|Verified|Released)$/.test(cells[cells.length - 2] || "")) {
+            done.add(req);
+        }
+    }
+    return done;
+}
+/**
+ * Every change, open or archived, with its phase. An archived change keeps its
+ * id after the date prefix the archive gives it (`2026-10-29-alerts`).
+ */
+function boardChanges(projectDir) {
+    const root = path.join(projectDir, CHANGES);
+    if (!fs.existsSync(root))
+        return [];
+    const branches = harnessBranches(projectDir);
+    const implemented = implementedRequirements(projectDir);
+    const out = [];
+    const add = (dir, id, archived) => {
+        const yaml = readYaml(path.join(dir, "change.yaml"));
+        const requirements = deltaRequirements(dir);
+        const building = requirements.some((r) => branches.has(r) || implemented.has(r));
+        const repositories = Array.isArray(yaml.repositories)
+            ? yaml.repositories.map(String).filter(Boolean)
+            : [];
+        out.push({
+            id,
+            dir,
+            archived,
+            ticket: changeTicket(yaml),
+            repositories,
+            requirements,
+            phase: archived ? "archived" : building ? "building" : "proposed",
+        });
+    };
+    for (const e of fs.readdirSync(root, { withFileTypes: true })) {
+        if (!e.isDirectory() || e.name.startsWith("."))
+            continue;
+        if (e.name === "archive") {
+            const archive = path.join(root, "archive");
+            for (const a of fs.readdirSync(archive, { withFileTypes: true })) {
+                if (!a.isDirectory())
+                    continue;
+                add(path.join(archive, a.name), a.name.replace(/^\d{4}-\d{2}-\d{2}-/, ""), true);
+            }
+            continue;
+        }
+        add(path.join(root, e.name), e.name, false);
+    }
+    return out;
+}
+// ── Moving the board ──────────────────────────────────────────────────────────
+/** The state `phases:` names for a phase, or undefined for the provider's default. */
+function namedState(cfg, phase) {
+    const phases = cfg.phases;
+    if (!phases || typeof phases !== "object")
+        return undefined;
+    const value = phases[phase];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+/** Move one change's ticket to its phase, unless the board was already told. */
+async function movePhase(change, map, client, cfg, opts = {}) {
+    const phase = opts.phase ?? change.phase;
+    const record = (map[change.id] ??= { ticket: change.ticket });
+    record.ticket = change.ticket;
+    const named = namedState(cfg, phase);
+    if (!opts.force && record.phase === phase) {
+        return {
+            change: change.id,
+            action: "in-sync",
+            issue: change.ticket,
+            phase,
+            state: record.state,
+        };
+    }
+    if (!client.capabilities.phase || typeof client.setPhase !== "function") {
+        return {
+            change: change.id,
+            action: "phase-unsupported",
+            issue: change.ticket,
+            phase,
+            detail: `${change.ticket} should be ${phase}, but provider '${cfg.provider}' cannot move an issue — move it by hand.`,
+        };
+    }
+    if (opts.dryRun) {
+        return {
+            change: change.id,
+            action: "would-move",
+            issue: change.ticket,
+            phase,
+            state: named ?? `the ${phase} state`,
+        };
+    }
+    const state = await client.setPhase(change.ticket, phase, named);
+    record.phase = phase;
+    record.state = state;
+    return { change: change.id, action: "moved", issue: change.ticket, phase, state };
+}
+/** REQ-305: every change with a ticket, moved to its phase. */
+async function syncPhases(changes, map, client, cfg, opts = {}) {
+    const actions = [];
+    for (const change of changes) {
+        if (!change.ticket)
+            continue;
+        actions.push(await movePhase({ ...change, ticket: change.ticket }, map, client, cfg, opts));
+    }
+    return actions;
+}
+/** REQ-307: one sub-issue per repository a change names, created once. */
+async function syncSubIssues(changes, map, client, opts = {}) {
+    const actions = [];
+    for (const change of changes) {
+        if (change.archived || change.repositories.length === 0)
+            continue;
+        if (!change.ticket) {
+            actions.push({
+                change: change.id,
+                action: "no-ticket",
+                detail: `${change.id} names repositories but no ticket to hang their sub-issues on — add ticket: <KEY> to its change.yaml.`,
+            });
+            continue;
+        }
+        const record = (map[change.id] ??= { ticket: change.ticket });
+        const children = (record.children ??= {});
+        for (const repo of change.repositories) {
+            if (children[repo])
+                continue;
+            if (!client.capabilities.subIssues || typeof client.createSubIssue !== "function") {
+                actions.push({
+                    change: change.id,
+                    action: "sub-issues-unsupported",
+                    repo,
+                    detail: `${change.ticket} needs a sub-issue for ${repo}, but this provider cannot create one — create it by hand.`,
+                });
+                continue;
+            }
+            if (opts.dryRun) {
+                actions.push({ change: change.id, action: "would-create", repo });
+                continue;
+            }
+            const created = await client.createSubIssue(change.ticket, `${change.ticket} — ${repo}: ${change.id}`);
+            children[repo] = created.key;
+            actions.push({ change: change.id, action: "created", repo, issue: created.key });
+        }
+    }
+    return actions;
+}
+//# sourceMappingURL=phases.js.map

package/dist/scripts/alm/phases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.js","sourceRoot":"","sources":["../../../scripts/alm/phases.ts"],"names":[],"mappings":"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"}

package/dist/scripts/alm/port.js

@@ -33,24 +33,46 @@
  * implementation and its declaration disagree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CORE_CONFIG_KEYS = exports.CAPABILITY_METHOD = exports.CAPABILITIES = void 0;
+exports.CORE_CONFIG_KEYS = exports.CAPABILITY_METHOD = exports.OPTIONAL_CAPABILITIES = exports.CAPABILITIES = exports.PHASES = void 0;
 exports.checkProviderDeclaration = checkProviderDeclaration;
-/** Every capability name, for the checks that iterate them. */
+exports.PHASES = ["proposed", "building", "archived"];
+/** Every capability a provider must declare, for the checks that iterate them. */
 exports.CAPABILITIES = [
     "create",
     "readStatus",
     "close",
     "listIssues",
 ];
+/** The capabilities a provider may declare (REQ-305..307). */
+exports.OPTIONAL_CAPABILITIES = [
+    "phase",
+    "subIssues",
+    "comments",
+    "readText",
+];
 /** The client method each capability promises. */
 exports.CAPABILITY_METHOD = {
     create: "createIssue",
     readStatus: "getIssueStatus",
     close: "closeIssue",
     listIssues: "listIssues",
+    phase: "setPhase",
+    subIssues: "createSubIssue",
+    comments: "listComments",
+    readText: "readIssueText",
 };
-/** Config keys the core itself reads, whatever the provider. */
-exports.CORE_CONFIG_KEYS = ["alm_version", "provider", "pr"];
+/**
+ * Config keys the core itself reads, whatever the provider. `phases` names the
+ * board state of each phase (REQ-305); `mirror: false` keeps `alm sync` from
+ * creating an issue per requirement on a project whose tickets are the source.
+ */
+exports.CORE_CONFIG_KEYS = [
+    "alm_version",
+    "provider",
+    "pr",
+    "phases",
+    "mirror",
+];
 /**
  * Check a provider declaration is well formed.
  *
@@ -107,7 +129,13 @@ function checkCapabilities(candidate) {
             problems.push(`${label}: capability '${capability}' is not declared as a boolean`);
         }
     }
-    const extra = Object.keys(caps).filter((name) => !exports.CAPABILITIES.includes(name));
+    for (const capability of exports.OPTIONAL_CAPABILITIES) {
+        if (capability in caps && typeof caps[capability] !== "boolean") {
+            problems.push(`${label}: capability '${capability}' is not declared as a boolean`);
+        }
+    }
+    const known = [...exports.CAPABILITIES, ...exports.OPTIONAL_CAPABILITIES];
+    const extra = Object.keys(caps).filter((name) => !known.includes(name));
     if (extra.length > 0) {
         problems.push(`${label}: declares unknown capabilit(y/ies): ${extra.join(", ")}`);
     }

package/dist/scripts/alm/port.js.map

@@ -1 +1 @@
-{"version":3,"file":"port.js","sourceRoot":"","sources":["../../../scripts/alm/port.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../../scripts/alm/port.ts"],"names":[],"mappings":"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"}

package/dist/scripts/alm/providers/azure.js

@@ -13,16 +13,7 @@ const API_VERSION = "api-version=7.1";
  * which is why this provider, and only this one, declares `done_state`.
  */
 class AzureClient extends http_client_1.HttpAlmClient {
-    capabilities = {
-        create: true,
-        readStatus: true,
-        close: true,
-        // Azure searches with WIQL — a POST carrying a query language, then a
-        // second request to hydrate each id. That is a different shape from the
-        // other two, and declaring `false` degrades `alm pull` with a message
-        // rather than pretending and failing at the first request.
-        listIssues: false,
-    };
+    capabilities = AZURE_CAPABILITIES;
     authorization;
     projectKey;
     issueType;
@@ -57,6 +48,55 @@ class AzureClient extends http_client_1.HttpAlmClient {
         const state = item.fields?.["System.State"];
         return state !== undefined && DONE_STATES.includes(state) ? "done" : "open";
     }
+    /**
+     * REQ-305: Azure Boards' default process states — New, Active, and the
+     * configured done state — unless `phases:` names the project's own.
+     */
+    async setPhase(issueKey, phase, state) {
+        const target = state ?? (phase === "proposed" ? "New" : phase === "building" ? "Active" : this.doneState);
+        await this.request(`/_apis/wit/workitems/${workItemId(issueKey)}?${API_VERSION}`, `Azure move work item ${issueKey} to ${target}`, {
+            method: "PATCH",
+            headers: this.patchHeaders(),
+            body: JSON.stringify([{ op: "add", path: "/fields/System.State", value: target }]),
+        });
+        return target;
+    }
+    /** REQ-307: a child work item, linked to its parent by the hierarchy relation. */
+    async createSubIssue(parentKey, title) {
+        const created = await this.requestJson(`/${this.projectKey}/_apis/wit/workitems/$${encodeURIComponent(this.issueType)}?${API_VERSION}`, `Azure create child of work item ${parentKey}`, {
+            method: "POST",
+            headers: this.patchHeaders(),
+            body: JSON.stringify([
+                { op: "add", path: "/fields/System.Title", value: title },
+                { op: "add", path: "/fields/System.Tags", value: "spec-driven" },
+                {
+                    op: "add",
+                    path: "/relations/-",
+                    value: {
+                        rel: "System.LinkTypes.Hierarchy-Reverse",
+                        url: `${this.baseUrl}/_apis/wit/workItems/${workItemId(parentKey)}`,
+                    },
+                },
+            ]),
+        });
+        return { key: String(created.id), url: created._links?.html?.href ?? null };
+    }
+    /** REQ-306: the work item's title and description, its HTML flattened. */
+    async readIssueText(issueKey) {
+        const item = await this.requestJson(`/_apis/wit/workitems/${workItemId(issueKey)}?fields=System.Title,System.Description&${API_VERSION}`, `Azure read work item ${issueKey}`, { headers: { Authorization: this.authorization } });
+        const html = String(item.fields?.["System.Description"] ?? "");
+        return {
+            title: String(item.fields?.["System.Title"] ?? ""),
+            body: html
+                .replace(/<br\s*\/?>|<\/(?:p|div|li)>/gi, "\n")
+                .replace(/<[^>]+>/g, "")
+                .replace(/&nbsp;/g, " ")
+                .replace(/&amp;/g, "&")
+                .replace(/&lt;/g, "<")
+                .replace(/&gt;/g, ">")
+                .trim(),
+        };
+    }
     async closeIssue(issueKey) {
         await this.request(`/_apis/wit/workitems/${issueKey}?${API_VERSION}`, `Azure close work item ${issueKey}`, {
             method: "PATCH",
@@ -65,6 +105,27 @@ class AzureClient extends http_client_1.HttpAlmClient {
         });
     }
 }
+/** A work item id as a path segment: digits, nothing a path could be walked with. */
+function workItemId(key) {
+    if (!/^\d+$/.test(key))
+        throw new Error(`Azure: '${key}' is not a work item id.`);
+    return key;
+}
+/** Comments are a preview API on Azure Boards: not read, and `alm pull` says so. */
+const AZURE_CAPABILITIES = {
+    create: true,
+    readStatus: true,
+    close: true,
+    // Azure searches with WIQL — a POST carrying a query language, then a
+    // second request to hydrate each id. That is a different shape from the
+    // other two, and declaring `false` degrades `alm pull` with a message
+    // rather than pretending and failing at the first request.
+    listIssues: false,
+    phase: true,
+    subIssues: true,
+    comments: false,
+    readText: true,
+};
 exports.azureProvider = {
     id: "azure",
     label: "Azure Boards",
@@ -72,7 +133,7 @@ exports.azureProvider = {
         required: ["base_url", "project_key", "token_env"],
         optional: ["issue_type", "done_state"],
     },
-    capabilities: { create: true, readStatus: true, close: true, listIssues: false },
+    capabilities: AZURE_CAPABILITIES,
     create: (cfg, fetchImpl) => new AzureClient(cfg, fetchImpl),
 };
 exports.default = exports.azureProvider;