@rsaglobaltech/specgate 0.27.9 → 1.0.0-rc.1

package/dist/scripts/lib/workspace-live.js

@@ -0,0 +1,216 @@
+"use strict";
+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.partRequirements = partRequirements;
+exports.readWorkspaceLive = readWorkspaceLive;
+exports.workspaceLiveSignature = workspaceLiveSignature;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
+const SpecParser_1 = require("../../packages/core/src/domain/SpecParser");
+const Workspace_1 = require("../../packages/core/src/domain/Workspace");
+const live_model_1 = require("./live-model");
+const in_flight_1 = require("./in-flight");
+const workspace_1 = require("./workspace");
+/** The requirements a sub-change's delta adds or modifies, with their dependencies and scenarios. */
+function partRequirements(memberDir, change) {
+    const out = [];
+    for (const d of (0, ChangeWorkspace_1.listDeltas)(memberDir, change)) {
+        let parsed;
+        try {
+            parsed = (0, SpecParser_1.parseDelta)(fs.readFileSync(d.file, "utf8"));
+        }
+        catch {
+            continue;
+        }
+        for (const r of [...(parsed.added || []), ...(parsed.modified || [])]) {
+            if (!r.id)
+                continue;
+            const raw = String((r.trace || {}).depends || "");
+            out.push({
+                id: r.id.toUpperCase(),
+                depends: raw.split(/[,;\s]+/).filter(Boolean),
+                scenarios: r.scenarios.map((s) => s.id || "").filter(Boolean),
+            });
+        }
+    }
+    return out;
+}
+/** Minutes the member's ledger recorded, for the requirements `only` names (all when absent). */
+function ledgerMinutes(memberDir, only) {
+    const runs = path.join(memberDir, ".harness", "runs");
+    let ms = 0;
+    let files = [];
+    try {
+        files = fs.readdirSync(runs).filter((f) => f.endsWith(".json"));
+    }
+    catch {
+        return 0;
+    }
+    for (const f of files) {
+        try {
+            const doc = JSON.parse(fs.readFileSync(path.join(runs, f), "utf8"));
+            for (const r of doc.results || []) {
+                if (only && !only.has(String(r.requirement)))
+                    continue;
+                if (Number(r.durationMs) > 0)
+                    ms += Number(r.durationMs);
+            }
+        }
+        catch {
+            /* a ledger being written */
+        }
+    }
+    return Math.round(ms / 60000);
+}
+function money(reqs) {
+    const costs = reqs
+        .map((r) => (r.usage && r.usage.cost !== null ? r.usage.cost : null))
+        .filter((c) => c !== null);
+    return costs.length ? Math.round(costs.reduce((a, b) => a + b, 0) * 100) / 100 : null;
+}
+function sumCost(costs) {
+    const paid = costs.map((c) => c.money).filter((m) => m !== null);
+    return {
+        money: paid.length ? Math.round(paid.reduce((a, b) => a + b, 0) * 100) / 100 : null,
+        minutes: costs.reduce((a, c) => a + c.minutes, 0),
+    };
+}
+function repoLive(ws, name, role, live) {
+    const dir = ws.dirs[name];
+    const reqs = live ? live.requirements : [];
+    const running = reqs.find((r) => r.state === "running") || null;
+    const lastStep = running
+        ? [...running.steps].reverse().find((e) => e.type === "step" && e.kind)
+        : undefined;
+    return {
+        name,
+        role,
+        exists: live !== null,
+        queue: live ? live.queue : [],
+        inFlight: running
+            ? {
+                req: running.req,
+                title: running.title,
+                attempt: running.attempt,
+                phase: running.phase,
+                elapsed: running.elapsed,
+                running: running.running,
+                agent: lastStep
+                    ? { kind: String(lastStep.kind), target: String(lastStep.target || "") }
+                    : null,
+            }
+            : null,
+        requirements: {
+            running: reqs.filter((r) => r.state === "running").length,
+            pass: reqs.filter((r) => r.state === "pass").length,
+            fail: reqs.filter((r) => r.state === "fail").length,
+        },
+        cost: { money: money(reqs), minutes: live ? ledgerMinutes(dir) : 0 },
+    };
+}
+/** The workspace's live model: every repository's harness, and every story's parts (REQ-320..322). */
+function readWorkspaceLive(ws) {
+    const lives = new Map();
+    for (const r of ws.config.repos) {
+        const dir = ws.dirs[r.name];
+        lives.set(r.name, fs.existsSync(dir) ? (0, live_model_1.readLive)(dir) : null);
+    }
+    const statuses = new Map();
+    const statusOf = (repo, req) => {
+        if (!ws.dirs[repo] || !fs.existsSync(ws.dirs[repo]))
+            return "";
+        if (!statuses.has(repo))
+            statuses.set(repo, (0, workspace_1.memberStatuses)(ws.dirs[repo]));
+        return statuses.get(repo).get(req) || "";
+    };
+    const stories = (0, workspace_1.readStories)(ws.dir).map((s) => {
+        const costs = [];
+        const subchanges = s.subchanges.map((sc) => {
+            const dir = ws.dirs[sc.repo];
+            const exists = !!dir && fs.existsSync(dir);
+            const base = exists ? (0, workspace_1.subChangeState)(dir, sc.change) : "missing";
+            const reqs = exists && base === "open" ? partRequirements(dir, sc.change) : [];
+            const ids = new Set(reqs.map((r) => r.id));
+            const live = lives.get(sc.repo);
+            const seen = live ? live.requirements.filter((r) => ids.has(r.req)) : [];
+            const blockedBy = [
+                ...new Set(reqs.flatMap((r) => r.depends.filter((d) => {
+                    const q = (0, Workspace_1.splitQualified)(d);
+                    return !!q && !in_flight_1.DELIVERED.includes(statusOf(q.repo, q.id));
+                }))),
+            ];
+            if (exists)
+                costs.push({ money: money(seen), minutes: ledgerMinutes(dir, ids) });
+            return {
+                repo: sc.repo,
+                change: sc.change,
+                state: (base === "open" && seen.length > 0 ? "building" : base),
+                requirements: [...ids],
+                blockedBy,
+            };
+        });
+        return {
+            id: s.id,
+            title: s.title,
+            done: subchanges.length > 0 && subchanges.every((p) => p.state === "archived"),
+            subchanges,
+            cost: sumCost(costs),
+        };
+    });
+    return {
+        schemaVersion: 1,
+        name: ws.config.name,
+        dir: ws.dir,
+        repos: ws.config.repos.map((r) => repoLive(ws, r.name, r.role, lives.get(r.name) || null)),
+        stories,
+    };
+}
+/** Changes whenever a member's events or the workspace's stories change. */
+function workspaceLiveSignature(ws) {
+    const parts = ws.config.repos.map((r) => fs.existsSync(ws.dirs[r.name]) ? (0, live_model_1.liveSignature)(ws.dirs[r.name]) : r.name);
+    const stories = path.join(ws.dir, Workspace_1.STORIES_DIR);
+    try {
+        for (const e of fs.readdirSync(stories)) {
+            const st = fs.statSync(path.join(stories, e, "story.yaml"));
+            parts.push(`${e}:${st.mtimeMs}`);
+        }
+    }
+    catch {
+        /* no stories yet */
+    }
+    return parts.join("|");
+}
+//# sourceMappingURL=workspace-live.js.map

package/dist/scripts/lib/workspace-live.js.map

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

package/dist/scripts/lib/workspace.js

@@ -0,0 +1,406 @@
+"use strict";
+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.LAST_CHECK_FILE = void 0;
+exports.workspaceFile = workspaceFile;
+exports.loadWorkspace = loadWorkspace;
+exports.memberRequirements = memberRequirements;
+exports.memberStatuses = memberStatuses;
+exports.memberDependencies = memberDependencies;
+exports.readStories = readStories;
+exports.subChangeState = subChangeState;
+exports.storyStates = storyStates;
+exports.workspaceModel = workspaceModel;
+exports.checkWorkspace = checkWorkspace;
+exports.recordCheck = recordCheck;
+exports.openSubChange = openSubChange;
+exports.noteNoMembers = noteNoMembers;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const Workspace_1 = require("../../packages/core/src/domain/Workspace");
+const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
+const SpecParser_1 = require("../../packages/core/src/domain/SpecParser");
+const requirement_graph_1 = require("./requirement-graph");
+const in_flight_1 = require("./in-flight");
+const project_root_1 = require("./project-root");
+const diagnostics_1 = require("./diagnostics");
+/**
+ * The repositories of a workspace, read from disk (ADR-0041). Every member is
+ * asked through the CLI itself — `status --json`, `check --json` — so the
+ * workspace sees exactly what each repository's own gate sees.
+ */
+/** Where `workspace check` writes its last result, for `workspace status`. */
+exports.LAST_CHECK_FILE = ".specgate/workspace-check.json";
+function workspaceFile(dir) {
+    return path.join(dir, Workspace_1.WORKSPACE_FILE);
+}
+/** The workspace at `dir`, or the problems that keep it from being read. */
+function loadWorkspace(dir) {
+    const file = workspaceFile(dir);
+    if (!fs.existsSync(file)) {
+        return {
+            ws: null,
+            problems: [
+                (0, diagnostics_1.error)("workspace_missing", `${dir} has no ${Workspace_1.WORKSPACE_FILE}.`, {
+                    fix: "specgate workspace init --repo fleet=../fleet --repo web=../web:web",
+                }),
+            ],
+        };
+    }
+    const read = (0, Workspace_1.readWorkspace)(fs.readFileSync(file, "utf8"));
+    if (!read.config) {
+        return {
+            ws: null,
+            problems: read.problems.map((p) => (0, diagnostics_1.error)("workspace_invalid", p, { file: Workspace_1.WORKSPACE_FILE, fix: "Correct the line it names." })),
+        };
+    }
+    const dirs = {};
+    for (const r of read.config.repos)
+        dirs[r.name] = path.resolve(dir, r.path);
+    return { ws: { dir, config: read.config, dirs }, problems: [] };
+}
+const CLI = () => path.join((0, project_root_1.findCliRoot)(__dirname), "bin", "specgate.js");
+function cli(args) {
+    const r = (0, node_child_process_1.spawnSync)(process.execPath, [CLI(), ...args], {
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+        env: { ...process.env, NO_COLOR: "1" },
+    });
+    return { status: r.status, stdout: r.stdout || "", stderr: r.stderr || "" };
+}
+function json(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+function branchOf(dir) {
+    const r = (0, node_child_process_1.spawnSync)("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd: dir, encoding: "utf8" });
+    return r.status === 0 ? r.stdout.trim() : null;
+}
+function memberRequirements(dir) {
+    const r = cli(["status", "--json", "--project-dir", dir]);
+    const doc = json(r.stdout);
+    if (!doc || !Array.isArray(doc.requirements))
+        return null;
+    const ids = doc.requirements.map((q) => String(q.id).toUpperCase());
+    const total = Number(doc.total ?? ids.length);
+    const pending = Number(doc.pending ?? 0);
+    return { total, pending, done: Math.max(0, total - pending), ids };
+}
+/**
+ * The status each requirement of a member carries: the matrix's Status column,
+ * then the open changes' deltas on top (what the gate judges in flight).
+ */
+function memberStatuses(dir) {
+    const out = new Map();
+    const matrix = path.join(dir, "docs", "specs", "traceability.md");
+    if (fs.existsSync(matrix)) {
+        for (const line of fs.readFileSync(matrix, "utf8").split(/\r?\n/)) {
+            const cells = line.split("|").map((c) => c.trim());
+            if (!/^REQ-\d+$/.test(cells[1] || ""))
+                continue;
+            const status = cells[cells.length - 2] || "";
+            out.set(cells[1], status.replace(/`/g, ""));
+        }
+    }
+    for (const r of (0, in_flight_1.inFlightRequirements)(dir))
+        out.set(r.id.toUpperCase(), r.status);
+    return out;
+}
+/** `depends=` of a member, archived and in flight, by requirement. */
+function memberDependencies(dir) {
+    const declared = { ...(0, requirement_graph_1.readDeclaredDependencies)(dir) };
+    for (const change of (0, ChangeWorkspace_1.listChangeIds)(dir)) {
+        for (const d of (0, ChangeWorkspace_1.listDeltas)(dir, change)) {
+            let parsed;
+            try {
+                parsed = (0, SpecParser_1.parseDelta)(fs.readFileSync(d.file, "utf8"));
+            }
+            catch {
+                continue;
+            }
+            for (const req of [...(parsed.added || []), ...(parsed.modified || [])]) {
+                const raw = req.id && (req.trace || {}).depends;
+                if (raw && req.id)
+                    declared[req.id.toUpperCase()] = String(raw)
+                        .split(/[,;\s]+/)
+                        .filter(Boolean);
+            }
+        }
+    }
+    return declared;
+}
+/** The files a member writes its requirements in: where a qualified id may appear. */
+function specFiles(dir) {
+    const out = [];
+    const add = (f) => fs.existsSync(f) && out.push(f);
+    add(path.join(dir, "spec.md"));
+    const caps = path.join(dir, "docs", "specs", "capabilities");
+    if (fs.existsSync(caps)) {
+        for (const e of fs.readdirSync(caps, { withFileTypes: true })) {
+            if (e.isDirectory())
+                add(path.join(caps, e.name, "spec.md"));
+        }
+    }
+    for (const change of (0, ChangeWorkspace_1.listChangeIds)(dir))
+        for (const d of (0, ChangeWorkspace_1.listDeltas)(dir, change))
+            add(d.file);
+    return out;
+}
+/** The workspace's own stories, read from `docs/stories/<id>/story.yaml`. */
+function readStories(dir) {
+    const root = path.join(dir, Workspace_1.STORIES_DIR);
+    if (!fs.existsSync(root))
+        return [];
+    const out = [];
+    for (const e of fs.readdirSync(root, { withFileTypes: true })) {
+        if (!e.isDirectory())
+            continue;
+        const file = path.join(root, e.name, "story.yaml");
+        if (!fs.existsSync(file))
+            continue;
+        const story = (0, Workspace_1.readStory)(fs.readFileSync(file, "utf8"));
+        if (story)
+            out.push({ ...story, dir: path.join(root, e.name) });
+    }
+    return out.sort((a, b) => a.id.localeCompare(b.id));
+}
+/** Where a story's sub-change stands in its member: open, archived, or not there. */
+function subChangeState(memberDir, change) {
+    if ((0, ChangeWorkspace_1.listChangeIds)(memberDir).includes(change))
+        return "open";
+    if ((0, ChangeWorkspace_1.listArchivedIds)(memberDir).some((a) => a === change || a.endsWith(`-${change}`)))
+        return "archived";
+    return "missing";
+}
+function lastCheck(dir) {
+    const file = path.join(dir, exports.LAST_CHECK_FILE);
+    if (!fs.existsSync(file))
+        return null;
+    return json(fs.readFileSync(file, "utf8"));
+}
+function storyStates(ws) {
+    return readStories(ws.dir).map((s) => {
+        const subchanges = s.subchanges.map((sc) => ({
+            repo: sc.repo,
+            change: sc.change,
+            state: (ws.dirs[sc.repo] && fs.existsSync(ws.dirs[sc.repo])
+                ? subChangeState(ws.dirs[sc.repo], sc.change)
+                : "missing"),
+        }));
+        return {
+            id: s.id,
+            title: s.title,
+            // REQ-297: done only when every repository archived its part.
+            done: subchanges.length > 0 && subchanges.every((sc) => sc.state === "archived"),
+            subchanges,
+        };
+    });
+}
+/** `workspace status`: each repository and each story, as one document. */
+function workspaceModel(ws) {
+    const last = lastCheck(ws.dir);
+    const repos = ws.config.repos.map((r) => {
+        const dir = ws.dirs[r.name];
+        const exists = fs.existsSync(dir);
+        const req = exists ? memberRequirements(dir) : null;
+        const ran = last && r.name in last.repos;
+        return {
+            name: r.name,
+            role: r.role,
+            path: r.path,
+            url: r.url || null,
+            exists,
+            branch: exists ? branchOf(dir) : null,
+            requirements: req ? { total: req.total, done: req.done, pending: req.pending } : null,
+            gate: {
+                state: ran ? (last.repos[r.name] ? "passed" : "failed") : "not run",
+                at: ran ? last.at : null,
+            },
+        };
+    });
+    return {
+        schemaVersion: 1,
+        name: ws.config.name,
+        dir: ws.dir,
+        repos,
+        stories: storyStates(ws),
+    };
+}
+/**
+ * `workspace check`: each member's own gate, then what only the workspace can
+ * judge — qualified ids that must exist (REQ-293) and cross-repository
+ * dependencies that must be delivered (REQ-295).
+ */
+function checkWorkspace(ws) {
+    const repos = [];
+    const problems = [];
+    const known = new Map();
+    const statuses = new Map();
+    for (const r of ws.config.repos) {
+        const dir = ws.dirs[r.name];
+        if (!fs.existsSync(dir)) {
+            const p = (0, diagnostics_1.error)("workspace_repo_missing", `The repo ${r.name} is not at ${r.path}.`, {
+                target: r.name,
+                fix: r.url ? `git clone ${r.url} ${r.path}` : `Correct its path in ${Workspace_1.WORKSPACE_FILE}.`,
+            });
+            repos.push({ name: r.name, ok: false, problems: [p] });
+            continue;
+        }
+        const run = cli(["check", dir, "--json"]);
+        const doc = json(run.stdout);
+        const own = Array.isArray(doc?.status)
+            ? doc.status.filter((d) => d.severity === "error")
+            : [];
+        repos.push({ name: r.name, ok: run.status === 0, problems: own });
+        known.set(r.name, new Set((memberRequirements(dir) || { ids: [] }).ids));
+        statuses.set(r.name, memberStatuses(dir));
+    }
+    // REQ-293: a qualified id names a repo of the workspace and a requirement it has.
+    const sources = [];
+    for (const s of readStories(ws.dir)) {
+        for (const f of fs.readdirSync(s.dir)) {
+            if (f.endsWith(".md"))
+                sources.push({ file: path.join(s.dir, f), rel: "" });
+        }
+    }
+    for (const r of ws.config.repos) {
+        if (!known.has(r.name))
+            continue;
+        for (const f of specFiles(ws.dirs[r.name]))
+            sources.push({ file: f, rel: r.name });
+    }
+    for (const { file, rel } of sources) {
+        const shown = rel
+            ? `${rel}/${path.relative(ws.dirs[rel], file).split(path.sep).join("/")}`
+            : path.relative(ws.dir, file).split(path.sep).join("/");
+        for (const ref of (0, Workspace_1.qualifiedRefs)(fs.readFileSync(file, "utf8"))) {
+            const ids = known.get(ref.repo);
+            if (!ws.dirs[ref.repo]) {
+                problems.push((0, diagnostics_1.error)("workspace_unknown_repo", `${shown}:${ref.line} names ${ref.repo}:${ref.id}, and ${ref.repo} is not a repo of this workspace.`, {
+                    file: shown,
+                    line: ref.line,
+                    fix: `Add ${ref.repo} to ${Workspace_1.WORKSPACE_FILE}, or correct the repo name.`,
+                }));
+            }
+            else if (ids && !ids.has(ref.id)) {
+                problems.push((0, diagnostics_1.error)("workspace_unknown_requirement", `${shown}:${ref.line} names ${ref.repo}:${ref.id}, which ${ref.repo} does not have.`, {
+                    file: shown,
+                    line: ref.line,
+                    fix: `Correct the id, or write ${ref.id} in ${ref.repo}.`,
+                }));
+            }
+        }
+    }
+    // REQ-295: a requirement that depends on another repo's waits for it.
+    for (const r of ws.config.repos) {
+        if (!known.has(r.name))
+            continue;
+        for (const [req, deps] of Object.entries(memberDependencies(ws.dirs[r.name]))) {
+            for (const dep of deps) {
+                const q = (0, Workspace_1.splitQualified)(dep);
+                if (!q)
+                    continue;
+                const theirs = statuses.get(q.repo);
+                if (!theirs) {
+                    if (!ws.dirs[q.repo]) {
+                        problems.push((0, diagnostics_1.error)("workspace_unknown_repo", `${r.name}:${req} depends on ${q.repo}:${q.id}, and ${q.repo} is not a repo of this workspace.`, {
+                            target: `${r.name}:${req}`,
+                            fix: `Add ${q.repo} to ${Workspace_1.WORKSPACE_FILE}, or correct depends= in ${req}.`,
+                        }));
+                    }
+                    continue;
+                }
+                const status = theirs.get(q.id);
+                if (status === undefined) {
+                    problems.push((0, diagnostics_1.error)("workspace_unknown_requirement", `${r.name}:${req} depends on ${q.repo}:${q.id}, which ${q.repo} does not have.`, {
+                        target: `${r.name}:${req}`,
+                        fix: `Correct depends= in ${req}, or write ${q.id} in ${q.repo}.`,
+                    }));
+                }
+                else if (!in_flight_1.DELIVERED.includes(status)) {
+                    problems.push((0, diagnostics_1.error)("workspace_dependency_pending", `${r.name}:${req} depends on ${q.repo}:${q.id}, which is ${status}, not delivered.`, {
+                        target: `${r.name}:${req}`,
+                        fix: `Deliver ${q.id} in ${q.repo} first (specgate harness run --req ${q.id} there).`,
+                    }));
+                }
+            }
+        }
+    }
+    const ok = repos.every((r) => r.ok) && problems.length === 0;
+    return { ok, repos, problems };
+}
+function recordCheck(dir, result) {
+    const file = path.join(dir, exports.LAST_CHECK_FILE);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const repos = {};
+    for (const r of result.repos)
+        repos[r.name] = r.ok;
+    fs.writeFileSync(file, JSON.stringify({ at: new Date().toISOString(), repos }, null, 2) + "\n");
+}
+// ── workspace propose ───────────────────────────────────────────────────────
+/** Open the story's change in one member, linked back to the story. */
+function openSubChange(ws, repo, story, title) {
+    const dir = ws.dirs[repo];
+    const r = cli(["change", "new", story, "--project-dir", dir]);
+    if (r.status !== 0) {
+        return (0, diagnostics_1.error)("workspace_propose_failed", `change new ${story} failed in ${repo}: ${(r.stderr || r.stdout).trim().split("\n").pop()}`, {
+            target: repo,
+            fix: `Run specgate change new ${story} in ${repo} to see why.`,
+        });
+    }
+    // A 1.0 change's Discover (ADR-0042), or a 0.27 change's proposal.
+    const changeDir = path.join(dir, "docs", "specs", "changes", story);
+    const proposal = ["discover.md", "proposal.md"]
+        .map((f) => path.join(changeDir, f))
+        .find((f) => fs.existsSync(f));
+    if (proposal) {
+        const text = fs.readFileSync(proposal, "utf8");
+        const link = `\n> Part of the workspace story \`${ws.config.name}:${story}\` — ${title}. ` +
+            `The story and its other repositories: \`${Workspace_1.STORIES_DIR}/${story}/story.md\` in the workspace repository.\n`;
+        fs.writeFileSync(proposal, text.replace(/^(# .*\n)/, `$1${link}`), "utf8");
+    }
+    return null;
+}
+function noteNoMembers() {
+    return (0, diagnostics_1.warning)("workspace_no_members", "No sibling folder holds a Specgate project.", {
+        fix: "specgate workspace init --repo fleet=../fleet --repo web=../web:web",
+    });
+}
+//# sourceMappingURL=workspace.js.map