@ybotok/loam 0.1.0-beta.3 → 0.2.0-alpha.13

package/dist/commands/gherkin.js

@@ -1,309 +0,0 @@
-import { existsSync, realpathSync } from "node:fs";
-import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
-import { dirname, join, relative } from "node:path";
-import { loadConfig } from "../core/config.js";
-import { decodeDocument, NotUtf8DocumentError } from "../core/document-bytes.js";
-import { emitJson, emitJsonError, fail, NO_SERVICE_MESSAGE, reportNoConfig } from "../core/json.js";
-import { featureSpecPaths, listFeatures, missingFeatureMessage, resolveFeature, servicePaths, SPEC_AXES, } from "../core/repo.js";
-import { parseRequirements } from "../core/spec.js";
-import { axisLabel, featureFilesUnder, gherkinRoot, parseStampedFeature, planEmission, } from "../core/gherkin.js";
-import { LOAM_VERSION } from "../core/version.js";
-import { isPathInside, resolveInside, UnsafePathError } from "../core/path-safety.js";
-export function registerGherkin(program) {
-    program
-        .command("gherkin")
-        .argument("[featureId]", "feature id — emit its ADDED/MODIFIED requirements; omit for the full living suite")
-        .description("Emit Gherkin .feature files from spec scenarios into this service repo's <gherkinDir>/loam/")
-        .option("--service <id>", "service to emit for (defaults to the configured service)")
-        .option("--dry-run", "print the plan (writes, replacements, deletions) and write nothing")
-        .option("--json", "emit the machine contract instead of the human view")
-        .action(async (featureArg, opts) => {
-        const json = opts.json === true;
-        const dryRun = opts.dryRun === true;
-        const config = await loadConfig();
-        if (!config) {
-            reportNoConfig(json);
-            return;
-        }
-        const service = opts.service ?? config.service;
-        if (service === undefined) {
-            return fail(json, "invalid-option", NO_SERVICE_MESSAGE);
-        }
-        // The emission writes into the repo loam is standing in, so it can only
-        // run where that repo is this service's — vouch's refusal, verbatim logic.
-        if (config.service !== service) {
-            const here = config.service === undefined ? "this is not a service repo" : `this repo is '${config.service}'`;
-            return fail(json, "invalid-option", `Cannot emit gherkin for '${service}' from here: ${here}. Generated .feature files land in the service's own repo — run it there.`);
-        }
-        // The repo root, not the cwd: `config.root` is the directory loam.json
-        // was actually found in, and config discovery walks upward. Taken from
-        // `process.cwd()` this emitted the whole suite into whatever directory
-        // the caller happened to stand in — `src/api/features/loam/…` inside the
-        // source tree, which the next run from the root neither finds, replaces
-        // nor deletes, and which `loam validate` grades as a suite that was never
-        // generated.
-        const repoDir = config.root ?? process.cwd();
-        let root;
-        try {
-            root = gherkinRoot(repoDir, config.gherkinDir);
-        }
-        catch (err) {
-            if (!(err instanceof UnsafePathError))
-                throw err;
-            return fail(json, "invalid-option", `Cannot emit Gherkin: ${err.message}. The output directory must stay inside the service repo.`);
-        }
-        const rel = (abs) => relative(repoDir, abs).split(/[\\/]/).join("/");
-        const feature = featureArg === undefined ? null : await resolveFeature(config.docsDir, featureArg, "exclude");
-        if (featureArg !== undefined && feature === null) {
-            return fail(json, "unknown-target", await missingFeatureMessage(config.docsDir, featureArg));
-        }
-        const scope = feature === null ? { mode: "living" } : { mode: "feature", featureId: feature.id };
-        // The requirement set, by scope. Feature mode takes ADDED and MODIFIED —
-        // a BASE requirement is the living state quoted, a REMOVED one is being
-        // retired, and neither is behaviour anybody is about to test. Living mode
-        // takes everything the living files hold.
-        //
-        // Read through `decodeDocument`, not `readFile(…, "utf8")`, and refused
-        // rather than degraded: a spec.md saved as UTF-16 decodes to a document
-        // with no requirements in it, which here is not merely a wrong answer but
-        // a destructive one — an empty plan makes every existing .feature under
-        // loam/ an orphan, and a living run DELETES its orphans. The whole
-        // generated suite would go because a docs file was written by PowerShell.
-        const byAxis = [];
-        const readSpec = async (path) => parseRequirements(decodeDocument(await readFile(path), path));
-        try {
-            if (feature !== null) {
-                const paths = featureSpecPaths(feature.dir, service);
-                for (const axis of SPEC_AXES) {
-                    const path = paths[axis.key];
-                    const reqs = existsSync(path)
-                        ? (await readSpec(path)).filter((r) => r.kind === "ADDED" || r.kind === "MODIFIED")
-                        : [];
-                    byAxis.push({ axis, reqs });
-                }
-            }
-            else {
-                const paths = servicePaths(config.docsDir, service);
-                if (!existsSync(paths.spec)) {
-                    return fail(json, "unknown-target", `No living spec at ${paths.spec}. Run \`loam adopt\` for '${service}' first.`);
-                }
-                for (const axis of SPEC_AXES) {
-                    const path = paths[axis.key];
-                    const reqs = existsSync(path) ? (await readSpec(path)).filter((r) => r.kind !== "REMOVED") : [];
-                    byAxis.push({ axis, reqs });
-                }
-            }
-        }
-        catch (err) {
-            if (!(err instanceof NotUtf8DocumentError))
-                throw err;
-            return fail(json, "repository-unavailable", `Cannot emit gherkin: ${err.message}`);
-        }
-        // `service` is not decoration: it salts every `@loam-digest-…` stamp, and
-        // it is the same string `loam verify` files the matching claims under.
-        const plan = planEmission(byAxis, {
-            service,
-            featureTag: scope.mode === "feature" ? scope.featureId : undefined,
-            version: LOAM_VERSION,
-        });
-        // Orphans of THIS scope, inside loam/ and nowhere else. Feature mode owns
-        // only its own emissions: stamped files carrying this feature's tag whose
-        // file is no longer in the plan (a requirement renamed or dropped).
-        // Living mode owns the whole suite — any .feature not in the plan goes —
-        // EXCEPT files tagged with a feature still in flight: those answer to
-        // their feature's delta until it archives, and `loam gherkin <FEAT>` is
-        // their regeneration.
-        const planned = new Set(plan.map((f) => f.fileName));
-        // Needed by BOTH modes now: living mode exempts in-flight files from
-        // deletion and replacement, and feature mode has to recognise another
-        // feature's in-flight file to refuse overwriting it.
-        const activeIds = new Set((await listFeatures(config.docsDir)).map((f) => f.id));
-        // "Inside loam/" has to hold after the links are resolved, not merely in
-        // the spelling of the path. `featureFilesUnder` FOLLOWS symlinks and
-        // recurses with the LINK's path, so a planted `<gherkinDir>/loam/sub ->
-        // /outside` hands back candidates that read as ours while `unlink`
-        // resolves them and destroys files that were never in this repo. Planned
-        // names are flat, so nothing nested is ever spared by `planned.has(...)`,
-        // and deletion is the one irreversible thing this command does: a
-        // candidate is an orphan only when its CONTAINING directory really
-        // resolves inside the owned root. The write path below refuses the same
-        // attack for the same reason.
-        //
-        // The candidate FILE is deliberately NOT resolved. A symlinked .feature
-        // sitting directly in loam/ is loam's to remove — unlinking it takes the
-        // link and leaves its target alone — so only the directory chain has to
-        // be ours.
-        const realOrNull = (p) => {
-            try {
-                return realpathSync(p);
-            }
-            catch {
-                return null;
-            }
-        };
-        // A root that does not resolve — absent, dangling, or vanished mid-run —
-        // proves nothing about what lives beneath it, so nothing is collected.
-        // Leaving an orphan behind is self-repairing (`loam validate` grades it
-        // `gherkin.orphaned` and the next run removes it); a deletion taken on an
-        // unproven path is not.
-        const rootReal = realOrNull(root);
-        const orphans = [];
-        if (rootReal !== null) {
-            for (const abs of await featureFilesUnder(root)) {
-                if (planned.has(relative(root, abs).split(/[\\/]/).join("/")))
-                    continue;
-                const holder = realOrNull(dirname(abs));
-                if (holder === null || !isPathInside(rootReal, holder))
-                    continue;
-                const stamped = parseStampedFeature(await readFile(abs, "utf8"));
-                if (scope.mode === "feature") {
-                    if (stamped !== null && stamped.tags.includes(scope.featureId))
-                        orphans.push(abs);
-                }
-                else {
-                    if (stamped !== null && stamped.tags.some((t) => activeIds.has(t)))
-                        continue;
-                    orphans.push(abs);
-                }
-            }
-        }
-        const actions = [];
-        for (const f of plan) {
-            let path;
-            try {
-                // Check the final file as well as the owned root: a pre-planted
-                // `<slug>.feature` symlink must not turn writeFile into an overwrite
-                // outside the repository.
-                path = resolveInside(repoDir, relative(repoDir, join(root, f.fileName)), `gherkin file '${f.fileName}'`);
-            }
-            catch (err) {
-                if (!(err instanceof UnsafePathError))
-                    throw err;
-                return fail(json, "invalid-option", `Cannot emit Gherkin: ${err.message}.`);
-            }
-            if (!existsSync(path)) {
-                actions.push({ ...f, path, action: "written" });
-                continue;
-            }
-            const existing = parseStampedFeature(await readFile(path, "utf8"));
-            if (scope.mode === "living") {
-                if (existing !== null && existing.tags.some((t) => activeIds.has(t))) {
-                    actions.push({ ...f, path, action: "kept", kept: existing });
-                    continue;
-                }
-            }
-            else if (existing !== null) {
-                // An unstamped file is nobody's delta — it owns nothing, so it is
-                // replaced like any other, which is what the empty owner list used
-                // to say the long way round.
-                const owners = existing.tags.filter((t) => t !== scope.featureId && activeIds.has(t));
-                if (owners.length > 0) {
-                    actions.push({ ...f, path, action: "conflict", kept: existing, owners });
-                    continue;
-                }
-            }
-            actions.push({ ...f, path, action: "replaced" });
-        }
-        // All or nothing: one conflicting file refuses the whole emission, so a
-        // half-written suite can never be the state an agent has to reason about.
-        // Only a feature run can conflict — living mode keeps the in-flight file
-        // rather than refusing — and standing inside that scope is also how the
-        // message names the feature without asserting there is one.
-        if (scope.mode === "feature") {
-            const conflicts = actions.filter((a) => a.action === "conflict");
-            if (conflicts.length > 0) {
-                const detail = conflicts
-                    .map((c) => `${rel(c.path)} is @${c.owners.join(" @")} (requirement '${c.requirement.name}')`)
-                    .join("; ");
-                const message = `Cannot emit gherkin for ${scope.featureId}: ${conflicts.length} file(s) belong to another feature still in flight — ${detail}. ` +
-                    `A .feature file carries one feature's delta; overwriting would revert that feature's wording and destroy the digest stamps \`loam verify --results\` matches on. ` +
-                    `Archive (or abandon) the owning feature first, or rename the requirement in ${scope.featureId}'s delta so the two stop sharing a file name.`;
-                if (json) {
-                    emitJsonError("gherkin-conflict", message, {
-                        conflicts: conflicts.map((c) => ({
-                            path: rel(c.path),
-                            action: "conflict",
-                            requirement: c.requirement.name,
-                            inFlight: c.owners,
-                        })),
-                    });
-                    return;
-                }
-                return fail(json, "gherkin-conflict", message);
-            }
-        }
-        const writes = actions.filter((a) => a.action !== "kept");
-        if (!dryRun) {
-            // The root is created only when something lands in it: an emission with
-            // nothing to emit must not flip the repo into "opted in" — an empty
-            // loam/ tells `loam validate` the whole living suite is missing.
-            if (writes.length > 0)
-                await mkdir(root, { recursive: true });
-            for (const a of writes)
-                await writeFile(a.path, a.content, "utf8");
-            for (const o of orphans)
-                await unlink(o);
-        }
-        if (json) {
-            emitJson({
-                mode: scope.mode,
-                ...(scope.mode === "feature" ? { feature: scope.featureId } : {}),
-                service,
-                root: rel(root),
-                written: !dryRun,
-                files: actions.map((a) => ({
-                    path: rel(a.path),
-                    action: a.action,
-                    axis: axisLabel(a.axis),
-                    requirement: a.requirement.name,
-                    // A kept file's numbers describe what STAYS on disk (the in-flight
-                    // emission), not the emission that was withheld.
-                    scenarios: a.action === "kept" ? a.kept.scenarios.length : a.digests.length,
-                    digests: a.action === "kept" ? a.kept.scenarios.map((s) => s.digest) : a.digests,
-                    ...(a.action === "kept"
-                        ? { inFlight: a.kept.tags.filter((t) => activeIds.has(t)) }
-                        : { stepless: a.stepless }),
-                })),
-                deleted: orphans.map(rel),
-            });
-            return;
-        }
-        const head = scope.mode === "feature" ? `${scope.featureId} · ${service}` : `${service} (living suite)`;
-        console.log(`gherkin ${head} → ${rel(root)}/${dryRun ? "  (dry run)" : ""}\n`);
-        if (actions.length === 0) {
-            console.log(scope.mode === "feature"
-                ? `  ${scope.featureId} has no ADDED or MODIFIED requirements for ${service} — nothing to emit.`
-                : `  the living specs hold no requirements for ${service} — nothing to emit.`);
-        }
-        // `conflict` never reaches here — the run refused above — but the map is
-        // total so a future action cannot silently print `undefined`.
-        const VERB = {
-            written: "write  ",
-            replaced: "replace",
-            kept: "keep   ",
-            conflict: "CONFLICT",
-        };
-        for (const a of actions) {
-            if (a.action === "kept") {
-                const owners = a.kept.tags.filter((t) => activeIds.has(t));
-                console.log(`  keep     ${a.fileName}  —  ${a.requirement.name}  (in flight: @${owners.join(" @")} — \`loam gherkin ${owners[0]}\` regenerates it)`);
-                continue;
-            }
-            const n = a.digests.length;
-            const arch = a.axis.key === "archSpec" ? ", arch" : "";
-            console.log(`  ${VERB[a.action]}  ${a.fileName}  —  ${a.requirement.name}  (${n} scenario${n === 1 ? "" : "s"}${arch})`);
-            for (const name of a.stepless) {
-                console.log(`      ⚠ scenario '${name}' has NO recognizable steps — cucumber runs it vacuously green and \`verify --results\` can never confirm it; reword its body as \`- **Given/When/Then**\` bullets`);
-            }
-        }
-        for (const o of orphans)
-            console.log(`  delete   ${relative(root, o).split(/[\\/]/).join("/")}  —  no longer in this scope`);
-        const wrote = `${writes.length} file(s)`;
-        const keptNote = actions.length > writes.length ? `, ${actions.length - writes.length} kept in flight` : "";
-        const dropped = orphans.length > 0 ? `, ${orphans.length} deletion(s)` : "";
-        console.log(dryRun
-            ? `\n  ${wrote}${keptNote}${dropped} — dry run, nothing was written.`
-            : `\n  ${wrote} written${keptNote}${dropped}. Write step definitions OUTSIDE ${rel(root)}/ — regeneration rewrites it.`);
-    });
-}
-//# sourceMappingURL=gherkin.js.map

package/dist/commands/gherkin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"gherkin.js","sourceRoot":"","sources":["../../src/commands/gherkin.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,SAAS,GAEV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAoB,MAAM,iBAAiB,CAAC;AACtE,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQtF,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,aAAa,EAAE,mFAAmF,CAAC;SAC5G,WAAW,CACV,6FAA6F,CAC9F;SACA,MAAM,CAAC,gBAAgB,EAAE,0DAA0D,CAAC;SACpF,MAAM,CAAC,WAAW,EAAE,oEAAoE,CAAC;SACzF,MAAM,CAAC,QAAQ,EAAE,qDAAqD,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,UAA8B,EAAE,IAAoB,EAAE,EAAE;QACrE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;QAEpC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,cAAc,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;QAC/C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;QAC1D,CAAC;QACD,wEAAwE;QACxE,2EAA2E;QAC3E,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,IAAI,GACR,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,OAAO,GAAG,CAAC;YACnG,OAAO,IAAI,CACT,IAAI,EACJ,gBAAgB,EAChB,4BAA4B,OAAO,gBAAgB,IAAI,2EAA2E,CACnI,CAAC;QACJ,CAAC;QAED,uEAAuE;QACvE,uEAAuE;QACvE,uEAAuE;QACvE,yEAAyE;QACzE,wEAAwE;QACxE,0EAA0E;QAC1E,aAAa;QACb,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7C,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,GAAG,YAAY,eAAe,CAAC;gBAAE,MAAM,GAAG,CAAC;YACjD,OAAO,IAAI,CACT,IAAI,EACJ,gBAAgB,EAChB,wBAAwB,GAAG,CAAC,OAAO,2DAA2D,CAC/F,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAQrF,MAAM,OAAO,GACX,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QAChG,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,KAAK,GACT,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QAErF,yEAAyE;QACzE,wEAAwE;QACxE,0EAA0E;QAC1E,0CAA0C;QAC1C,EAAE;QACF,wEAAwE;QACxE,wEAAwE;QACxE,0EAA0E;QAC1E,wEAAwE;QACxE,mEAAmE;QACnE,0EAA0E;QAC1E,MAAM,MAAM,GAAmD,EAAE,CAAC;QAClE,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAY,EAA0B,EAAE,CAC9D,iBAAiB,CAAC,cAAc,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC;YACH,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBACrD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;oBAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;wBAC3B,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;wBACnF,CAAC,CAAC,EAAE,CAAC;oBACP,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACpD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5B,OAAO,IAAI,CACT,IAAI,EACJ,gBAAgB,EAChB,qBAAqB,KAAK,CAAC,IAAI,6BAA6B,OAAO,UAAU,CAC9E,CAAC;gBACJ,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;oBAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,GAAG,YAAY,oBAAoB,CAAC;gBAAE,MAAM,GAAG,CAAC;YACtD,OAAO,IAAI,CAAC,IAAI,EAAE,wBAAwB,EAAE,wBAAwB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE;YAChC,OAAO;YACP,UAAU,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAClE,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;QAEH,0EAA0E;QAC1E,0EAA0E;QAC1E,oEAAoE;QACpE,yEAAyE;QACzE,sEAAsE;QACtE,wEAAwE;QACxE,sBAAsB;QACtB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrD,qEAAqE;QACrE,sEAAsE;QACtE,qDAAqD;QACrD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjF,yEAAyE;QACzE,qEAAqE;QACrE,wEAAwE;QACxE,mEAAmE;QACnE,yEAAyE;QACzE,0EAA0E;QAC1E,kEAAkE;QAClE,mEAAmE;QACnE,wEAAwE;QACxE,8BAA8B;QAC9B,EAAE;QACF,wEAAwE;QACxE,yEAAyE;QACzE,wEAAwE;QACxE,WAAW;QACX,MAAM,UAAU,GAAG,CAAC,CAAS,EAAiB,EAAE;YAC9C,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC,CAAC;QACF,yEAAyE;QACzE,uEAAuE;QACvE,wEAAwE;QACxE,0EAA0E;QAC1E,wBAAwB;QACxB,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,KAAK,MAAM,GAAG,IAAI,MAAM,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAAE,SAAS;gBACxE,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxC,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC;oBAAE,SAAS;gBACjE,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;gBACjE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC7B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;wBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpF,CAAC;qBAAM,CAAC;oBACN,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;wBAAE,SAAS;oBAC7E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAiCD,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,IAAY,CAAC;YACjB,IAAI,CAAC;gBACH,gEAAgE;gBAChE,qEAAqE;gBACrE,0BAA0B;gBAC1B,IAAI,GAAG,aAAa,CAClB,OAAO,EACP,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EACzC,iBAAiB,CAAC,CAAC,QAAQ,GAAG,CAC/B,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,CAAC,GAAG,YAAY,eAAe,CAAC;oBAAE,MAAM,GAAG,CAAC;gBACjD,OAAO,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,wBAAwB,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC;YAC9E,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAChD,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACnE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC7D,SAAS;gBACX,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC7B,kEAAkE;gBAClE,mEAAmE;gBACnE,6BAA6B;gBAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;oBACzE,SAAS;gBACX,CAAC;YACH,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,wEAAwE;QACxE,0EAA0E;QAC1E,yEAAyE;QACzE,wEAAwE;QACxE,4DAA4D;QAC5D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAmD,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAChF,CAAC;YACF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,SAAS;qBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;qBAC7F,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,MAAM,OAAO,GACX,2BAA2B,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,MAAM,wDAAwD,MAAM,IAAI;oBACjI,mKAAmK;oBACnK,+EAA+E,KAAK,CAAC,SAAS,+CAA+C,CAAC;gBAChJ,IAAI,IAAI,EAAE,CAAC;oBACT,aAAa,CAAC,kBAAkB,EAAE,OAAO,EAAE;wBACzC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC/B,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;4BACjB,MAAM,EAAE,UAAU;4BAClB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI;4BAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM;yBACnB,CAAC,CAAC;qBACJ,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBACD,OAAO,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAE1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,wEAAwE;YACxE,oEAAoE;YACpE,iEAAiE;YACjE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,KAAK,MAAM,CAAC,IAAI,MAAM;gBAAE,MAAM,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACnE,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,QAAQ,CAAC;gBACP,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjE,OAAO;gBACP,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC,MAAM;gBAChB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;oBACjB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;oBACvB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI;oBAC/B,mEAAmE;oBACnE,iDAAiD;oBACjD,SAAS,EAAE,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM;oBAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;oBAChF,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM;wBACrB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;wBAC3D,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;iBAC9B,CAAC,CAAC;gBACH,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;aAC1B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GACR,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,iBAAiB,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,KAAK,SAAS;gBACtB,CAAC,CAAC,KAAK,KAAK,CAAC,SAAS,8CAA8C,OAAO,qBAAqB;gBAChG,CAAC,CAAC,+CAA+C,OAAO,qBAAqB,CAChF,CAAC;QACJ,CAAC;QACD,yEAAyE;QACzE,8DAA8D;QAC9D,MAAM,IAAI,GAA2B;YACnC,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,UAAU;SACrB,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3D,OAAO,CAAC,GAAG,CACT,cAAc,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,WAAW,CAAC,IAAI,kBAAkB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,CAAC,CAAC,oBAAoB,CACxI,CAAC;gBACF,SAAS;YACX,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CACT,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAC5G,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CACT,qBAAqB,IAAI,oKAAoK,CAC9L,CAAC;YACJ,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC7H,MAAM,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,UAAU,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5G,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,CAAC,GAAG,CACT,MAAM;YACJ,CAAC,CAAC,OAAO,KAAK,GAAG,QAAQ,GAAG,OAAO,kCAAkC;YACrE,CAAC,CAAC,OAAO,KAAK,WAAW,QAAQ,GAAG,OAAO,oCAAoC,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAC1H,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["/**\n * `loam gherkin` — the third writer in the CLI (after archive and vouch), and\n * the only one that writes into the SERVICE repo, never the docs repo: the\n * docs state what must be true, the tests live with the code that makes it so.\n *\n * Two scopes, one emitter. `loam gherkin <FEAT>` emits the feature's ADDED and\n * MODIFIED requirements for this service — both spec axes — as the acceptance\n * skeleton to implement against, each file tagged with the feature id.\n * `loam gherkin --service <id>` (no feature) emits the full living suite from\n * spec.md + arch.spec.md: the regression skeleton a legacy service gets at\n * adoption. Either way the output is `<gherkinDir>/loam/` inside this repo,\n * a directory loam owns outright: the scope's files are rewritten, the scope's\n * orphans are deleted (and reported), and nothing outside `loam/` is touched —\n * except that a living run neither deletes NOR overwrites a file tagged with a\n * feature still in flight: it answers to that feature's delta until it\n * archives, and is reported as kept. A FEATURE run cannot keep — the file it\n * wants holds one feature's delta — so when the file it would write belongs to\n * a different feature still in flight, the whole run refuses (`gherkin-conflict`)\n * and names the owner rather than reverting it.\n *\n * It refuses to run anywhere but the service's own repo — vouch's discipline,\n * for vouch's reason: the output lands in the repo loam is standing in, and\n * from anywhere else that repo is somebody else's.\n */\nimport type { Command } from \"commander\";\nimport { existsSync, realpathSync } from \"node:fs\";\nimport { mkdir, readFile, unlink, writeFile } from \"node:fs/promises\";\nimport { dirname, join, relative } from \"node:path\";\nimport { loadConfig } from \"../core/config.js\";\nimport { decodeDocument, NotUtf8DocumentError } from \"../core/document-bytes.js\";\nimport { emitJson, emitJsonError, fail, NO_SERVICE_MESSAGE, reportNoConfig } from \"../core/json.js\";\nimport {\n  featureSpecPaths,\n  listFeatures,\n  missingFeatureMessage,\n  resolveFeature,\n  servicePaths,\n  SPEC_AXES,\n  type SpecAxis,\n} from \"../core/repo.js\";\nimport { parseRequirements, type Requirement } from \"../core/spec.js\";\nimport {\n  axisLabel,\n  featureFilesUnder,\n  gherkinRoot,\n  parseStampedFeature,\n  planEmission,\n  type PlannedFeature,\n  type StampedFeature,\n} from \"../core/gherkin.js\";\nimport { LOAM_VERSION } from \"../core/version.js\";\nimport { isPathInside, resolveInside, UnsafePathError } from \"../core/path-safety.js\";\n\ninterface GherkinOptions {\n  service?: string;\n  dryRun?: boolean;\n  json?: boolean;\n}\n\nexport function registerGherkin(program: Command): void {\n  program\n    .command(\"gherkin\")\n    .argument(\"[featureId]\", \"feature id — emit its ADDED/MODIFIED requirements; omit for the full living suite\")\n    .description(\n      \"Emit Gherkin .feature files from spec scenarios into this service repo's <gherkinDir>/loam/\",\n    )\n    .option(\"--service <id>\", \"service to emit for (defaults to the configured service)\")\n    .option(\"--dry-run\", \"print the plan (writes, replacements, deletions) and write nothing\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (featureArg: string | undefined, opts: GherkinOptions) => {\n      const json = opts.json === true;\n      const dryRun = opts.dryRun === true;\n\n      const config = await loadConfig();\n      if (!config) {\n        reportNoConfig(json);\n        return;\n      }\n      const service = opts.service ?? config.service;\n      if (service === undefined) {\n        return fail(json, \"invalid-option\", NO_SERVICE_MESSAGE);\n      }\n      // The emission writes into the repo loam is standing in, so it can only\n      // run where that repo is this service's — vouch's refusal, verbatim logic.\n      if (config.service !== service) {\n        const here =\n          config.service === undefined ? \"this is not a service repo\" : `this repo is '${config.service}'`;\n        return fail(\n          json,\n          \"invalid-option\",\n          `Cannot emit gherkin for '${service}' from here: ${here}. Generated .feature files land in the service's own repo — run it there.`,\n        );\n      }\n\n      // The repo root, not the cwd: `config.root` is the directory loam.json\n      // was actually found in, and config discovery walks upward. Taken from\n      // `process.cwd()` this emitted the whole suite into whatever directory\n      // the caller happened to stand in — `src/api/features/loam/…` inside the\n      // source tree, which the next run from the root neither finds, replaces\n      // nor deletes, and which `loam validate` grades as a suite that was never\n      // generated.\n      const repoDir = config.root ?? process.cwd();\n      let root: string;\n      try {\n        root = gherkinRoot(repoDir, config.gherkinDir);\n      } catch (err) {\n        if (!(err instanceof UnsafePathError)) throw err;\n        return fail(\n          json,\n          \"invalid-option\",\n          `Cannot emit Gherkin: ${err.message}. The output directory must stay inside the service repo.`,\n        );\n      }\n      const rel = (abs: string): string => relative(repoDir, abs).split(/[\\\\/]/).join(\"/\");\n\n      // The scope is one value, not a mode with an id lying beside it that only\n      // one of the modes ever fills in: the emission tag, the orphan filter,\n      // the overwrite rule and the conflict refusal all want the feature id\n      // exactly when the run is a feature run. A union states that; two\n      // variables could only be asserted to agree.\n      type Scope = { mode: \"living\" } | { mode: \"feature\"; featureId: string };\n      const feature =\n        featureArg === undefined ? null : await resolveFeature(config.docsDir, featureArg, \"exclude\");\n      if (featureArg !== undefined && feature === null) {\n        return fail(json, \"unknown-target\", await missingFeatureMessage(config.docsDir, featureArg));\n      }\n      const scope: Scope =\n        feature === null ? { mode: \"living\" } : { mode: \"feature\", featureId: feature.id };\n\n      // The requirement set, by scope. Feature mode takes ADDED and MODIFIED —\n      // a BASE requirement is the living state quoted, a REMOVED one is being\n      // retired, and neither is behaviour anybody is about to test. Living mode\n      // takes everything the living files hold.\n      //\n      // Read through `decodeDocument`, not `readFile(…, \"utf8\")`, and refused\n      // rather than degraded: a spec.md saved as UTF-16 decodes to a document\n      // with no requirements in it, which here is not merely a wrong answer but\n      // a destructive one — an empty plan makes every existing .feature under\n      // loam/ an orphan, and a living run DELETES its orphans. The whole\n      // generated suite would go because a docs file was written by PowerShell.\n      const byAxis: Array<{ axis: SpecAxis; reqs: Requirement[] }> = [];\n      const readSpec = async (path: string): Promise<Requirement[]> =>\n        parseRequirements(decodeDocument(await readFile(path), path));\n      try {\n        if (feature !== null) {\n          const paths = featureSpecPaths(feature.dir, service);\n          for (const axis of SPEC_AXES) {\n            const path = paths[axis.key];\n            const reqs = existsSync(path)\n              ? (await readSpec(path)).filter((r) => r.kind === \"ADDED\" || r.kind === \"MODIFIED\")\n              : [];\n            byAxis.push({ axis, reqs });\n          }\n        } else {\n          const paths = servicePaths(config.docsDir, service);\n          if (!existsSync(paths.spec)) {\n            return fail(\n              json,\n              \"unknown-target\",\n              `No living spec at ${paths.spec}. Run \\`loam adopt\\` for '${service}' first.`,\n            );\n          }\n          for (const axis of SPEC_AXES) {\n            const path = paths[axis.key];\n            const reqs = existsSync(path) ? (await readSpec(path)).filter((r) => r.kind !== \"REMOVED\") : [];\n            byAxis.push({ axis, reqs });\n          }\n        }\n      } catch (err) {\n        if (!(err instanceof NotUtf8DocumentError)) throw err;\n        return fail(json, \"repository-unavailable\", `Cannot emit gherkin: ${err.message}`);\n      }\n\n      // `service` is not decoration: it salts every `@loam-digest-…` stamp, and\n      // it is the same string `loam verify` files the matching claims under.\n      const plan = planEmission(byAxis, {\n        service,\n        featureTag: scope.mode === \"feature\" ? scope.featureId : undefined,\n        version: LOAM_VERSION,\n      });\n\n      // Orphans of THIS scope, inside loam/ and nowhere else. Feature mode owns\n      // only its own emissions: stamped files carrying this feature's tag whose\n      // file is no longer in the plan (a requirement renamed or dropped).\n      // Living mode owns the whole suite — any .feature not in the plan goes —\n      // EXCEPT files tagged with a feature still in flight: those answer to\n      // their feature's delta until it archives, and `loam gherkin <FEAT>` is\n      // their regeneration.\n      const planned = new Set(plan.map((f) => f.fileName));\n      // Needed by BOTH modes now: living mode exempts in-flight files from\n      // deletion and replacement, and feature mode has to recognise another\n      // feature's in-flight file to refuse overwriting it.\n      const activeIds = new Set((await listFeatures(config.docsDir)).map((f) => f.id));\n      // \"Inside loam/\" has to hold after the links are resolved, not merely in\n      // the spelling of the path. `featureFilesUnder` FOLLOWS symlinks and\n      // recurses with the LINK's path, so a planted `<gherkinDir>/loam/sub ->\n      // /outside` hands back candidates that read as ours while `unlink`\n      // resolves them and destroys files that were never in this repo. Planned\n      // names are flat, so nothing nested is ever spared by `planned.has(...)`,\n      // and deletion is the one irreversible thing this command does: a\n      // candidate is an orphan only when its CONTAINING directory really\n      // resolves inside the owned root. The write path below refuses the same\n      // attack for the same reason.\n      //\n      // The candidate FILE is deliberately NOT resolved. A symlinked .feature\n      // sitting directly in loam/ is loam's to remove — unlinking it takes the\n      // link and leaves its target alone — so only the directory chain has to\n      // be ours.\n      const realOrNull = (p: string): string | null => {\n        try {\n          return realpathSync(p);\n        } catch {\n          return null;\n        }\n      };\n      // A root that does not resolve — absent, dangling, or vanished mid-run —\n      // proves nothing about what lives beneath it, so nothing is collected.\n      // Leaving an orphan behind is self-repairing (`loam validate` grades it\n      // `gherkin.orphaned` and the next run removes it); a deletion taken on an\n      // unproven path is not.\n      const rootReal = realOrNull(root);\n      const orphans: string[] = [];\n      if (rootReal !== null) {\n        for (const abs of await featureFilesUnder(root)) {\n          if (planned.has(relative(root, abs).split(/[\\\\/]/).join(\"/\"))) continue;\n          const holder = realOrNull(dirname(abs));\n          if (holder === null || !isPathInside(rootReal, holder)) continue;\n          const stamped = parseStampedFeature(await readFile(abs, \"utf8\"));\n          if (scope.mode === \"feature\") {\n            if (stamped !== null && stamped.tags.includes(scope.featureId)) orphans.push(abs);\n          } else {\n            if (stamped !== null && stamped.tags.some((t) => activeIds.has(t))) continue;\n            orphans.push(abs);\n          }\n        }\n      }\n\n      // The in-flight exemption guards the OVERWRITE path too, not only the\n      // orphan scan above: files are named by requirement slug in both modes,\n      // so a MODIFIED requirement's living emission always collides with the\n      // active feature's file — and replacing it reverted the delta's wording\n      // mid-flight, feature tag and new digest stamps destroyed, invisibly\n      // (the reverted file grades current against the living spec). A planned\n      // path whose existing content is stamped and tagged with a feature still\n      // in flight is KEPT and reported as such; it answers to its feature's\n      // delta until the feature archives, and then living regeneration\n      // replaces it normally.\n      //\n      // FEATURE mode has the same collision and cannot solve it by keeping:\n      // two features in flight against one requirement slug want the same\n      // file, and whichever runs second used to `replace` — silently reverting\n      // the other feature's wording, feature tag and digest stamps, so its\n      // `verify --results` could never confirm a scenario again. Nothing loam\n      // can write is right here (the file holds ONE feature's delta), so the\n      // run refuses and names the owner: the two features have to be sequenced,\n      // or the requirement renamed.\n      //\n      // The row's shape follows its action instead of carrying every field any\n      // action might want: only a kept or a conflicting row has read the file\n      // that is already there, and only a conflicting one has owners. Held as\n      // one flat row with optional fields, every reader below had to assert\n      // what the writer three lines up already knew.\n      type Emission = PlannedFeature & { path: string };\n      type ActionRow =\n        | (Emission & { action: \"written\" | \"replaced\" })\n        | (Emission & { action: \"kept\"; kept: StampedFeature })\n        | (Emission & { action: \"conflict\"; kept: StampedFeature; owners: string[] });\n      type Action = ActionRow[\"action\"];\n      const actions: ActionRow[] = [];\n      for (const f of plan) {\n        let path: string;\n        try {\n          // Check the final file as well as the owned root: a pre-planted\n          // `<slug>.feature` symlink must not turn writeFile into an overwrite\n          // outside the repository.\n          path = resolveInside(\n            repoDir,\n            relative(repoDir, join(root, f.fileName)),\n            `gherkin file '${f.fileName}'`,\n          );\n        } catch (err) {\n          if (!(err instanceof UnsafePathError)) throw err;\n          return fail(json, \"invalid-option\", `Cannot emit Gherkin: ${err.message}.`);\n        }\n        if (!existsSync(path)) {\n          actions.push({ ...f, path, action: \"written\" });\n          continue;\n        }\n        const existing = parseStampedFeature(await readFile(path, \"utf8\"));\n        if (scope.mode === \"living\") {\n          if (existing !== null && existing.tags.some((t) => activeIds.has(t))) {\n            actions.push({ ...f, path, action: \"kept\", kept: existing });\n            continue;\n          }\n        } else if (existing !== null) {\n          // An unstamped file is nobody's delta — it owns nothing, so it is\n          // replaced like any other, which is what the empty owner list used\n          // to say the long way round.\n          const owners = existing.tags.filter((t) => t !== scope.featureId && activeIds.has(t));\n          if (owners.length > 0) {\n            actions.push({ ...f, path, action: \"conflict\", kept: existing, owners });\n            continue;\n          }\n        }\n        actions.push({ ...f, path, action: \"replaced\" });\n      }\n\n      // All or nothing: one conflicting file refuses the whole emission, so a\n      // half-written suite can never be the state an agent has to reason about.\n      // Only a feature run can conflict — living mode keeps the in-flight file\n      // rather than refusing — and standing inside that scope is also how the\n      // message names the feature without asserting there is one.\n      if (scope.mode === \"feature\") {\n        const conflicts = actions.filter(\n          (a): a is Extract<ActionRow, { action: \"conflict\" }> => a.action === \"conflict\",\n        );\n        if (conflicts.length > 0) {\n          const detail = conflicts\n            .map((c) => `${rel(c.path)} is @${c.owners.join(\" @\")} (requirement '${c.requirement.name}')`)\n            .join(\"; \");\n          const message =\n            `Cannot emit gherkin for ${scope.featureId}: ${conflicts.length} file(s) belong to another feature still in flight — ${detail}. ` +\n            `A .feature file carries one feature's delta; overwriting would revert that feature's wording and destroy the digest stamps \\`loam verify --results\\` matches on. ` +\n            `Archive (or abandon) the owning feature first, or rename the requirement in ${scope.featureId}'s delta so the two stop sharing a file name.`;\n          if (json) {\n            emitJsonError(\"gherkin-conflict\", message, {\n              conflicts: conflicts.map((c) => ({\n                path: rel(c.path),\n                action: \"conflict\",\n                requirement: c.requirement.name,\n                inFlight: c.owners,\n              })),\n            });\n            return;\n          }\n          return fail(json, \"gherkin-conflict\", message);\n        }\n      }\n\n      const writes = actions.filter((a) => a.action !== \"kept\");\n\n      if (!dryRun) {\n        // The root is created only when something lands in it: an emission with\n        // nothing to emit must not flip the repo into \"opted in\" — an empty\n        // loam/ tells `loam validate` the whole living suite is missing.\n        if (writes.length > 0) await mkdir(root, { recursive: true });\n        for (const a of writes) await writeFile(a.path, a.content, \"utf8\");\n        for (const o of orphans) await unlink(o);\n      }\n\n      if (json) {\n        emitJson({\n          mode: scope.mode,\n          ...(scope.mode === \"feature\" ? { feature: scope.featureId } : {}),\n          service,\n          root: rel(root),\n          written: !dryRun,\n          files: actions.map((a) => ({\n            path: rel(a.path),\n            action: a.action,\n            axis: axisLabel(a.axis),\n            requirement: a.requirement.name,\n            // A kept file's numbers describe what STAYS on disk (the in-flight\n            // emission), not the emission that was withheld.\n            scenarios: a.action === \"kept\" ? a.kept.scenarios.length : a.digests.length,\n            digests: a.action === \"kept\" ? a.kept.scenarios.map((s) => s.digest) : a.digests,\n            ...(a.action === \"kept\"\n              ? { inFlight: a.kept.tags.filter((t) => activeIds.has(t)) }\n              : { stepless: a.stepless }),\n          })),\n          deleted: orphans.map(rel),\n        });\n        return;\n      }\n\n      const head =\n        scope.mode === \"feature\" ? `${scope.featureId} · ${service}` : `${service} (living suite)`;\n      console.log(`gherkin ${head} → ${rel(root)}/${dryRun ? \"  (dry run)\" : \"\"}\\n`);\n      if (actions.length === 0) {\n        console.log(\n          scope.mode === \"feature\"\n            ? `  ${scope.featureId} has no ADDED or MODIFIED requirements for ${service} — nothing to emit.`\n            : `  the living specs hold no requirements for ${service} — nothing to emit.`,\n        );\n      }\n      // `conflict` never reaches here — the run refused above — but the map is\n      // total so a future action cannot silently print `undefined`.\n      const VERB: Record<Action, string> = {\n        written: \"write  \",\n        replaced: \"replace\",\n        kept: \"keep   \",\n        conflict: \"CONFLICT\",\n      };\n      for (const a of actions) {\n        if (a.action === \"kept\") {\n          const owners = a.kept.tags.filter((t) => activeIds.has(t));\n          console.log(\n            `  keep     ${a.fileName}  —  ${a.requirement.name}  (in flight: @${owners.join(\" @\")} — \\`loam gherkin ${owners[0]}\\` regenerates it)`,\n          );\n          continue;\n        }\n        const n = a.digests.length;\n        const arch = a.axis.key === \"archSpec\" ? \", arch\" : \"\";\n        console.log(\n          `  ${VERB[a.action]}  ${a.fileName}  —  ${a.requirement.name}  (${n} scenario${n === 1 ? \"\" : \"s\"}${arch})`,\n        );\n        for (const name of a.stepless) {\n          console.log(\n            `      ⚠ scenario '${name}' has NO recognizable steps — cucumber runs it vacuously green and \\`verify --results\\` can never confirm it; reword its body as \\`- **Given/When/Then**\\` bullets`,\n          );\n        }\n      }\n      for (const o of orphans) console.log(`  delete   ${relative(root, o).split(/[\\\\/]/).join(\"/\")}  —  no longer in this scope`);\n      const wrote = `${writes.length} file(s)`;\n      const keptNote = actions.length > writes.length ? `, ${actions.length - writes.length} kept in flight` : \"\";\n      const dropped = orphans.length > 0 ? `, ${orphans.length} deletion(s)` : \"\";\n      console.log(\n        dryRun\n          ? `\\n  ${wrote}${keptNote}${dropped} — dry run, nothing was written.`\n          : `\\n  ${wrote} written${keptNote}${dropped}. Write step definitions OUTSIDE ${rel(root)}/ — regeneration rewrites it.`,\n      );\n    });\n}\n"]}

package/dist/commands/init.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { existsSync, statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport {\n  CONFIG_FILENAME,\n  findConfigPath,\n  loadConfig,\n  localConfigPath,\n  saveConfig,\n  type LoamConfig,\n} from \"../core/config.js\";\nimport { emitJson, fail } from \"../core/json.js\";\nimport { plannedDocsFiles, scaffoldDocs } from \"../core/docs.js\";\nimport { agentsPath, docsRepoState, listServices } from \"../core/repo.js\";\nimport { InvalidIdError, assertServiceId } from \"../core/ids.js\";\nimport {\n  AGENT_TOOLS,\n  detectAgentTools,\n  plannedCommandFiles,\n  scaffoldAgentCommands,\n  type Delivery,\n} from \"../core/agent.js\";\n\ninterface InitOptions {\n  docs: string;\n  service?: string;\n  /** --create: make a new docs repo at --docs instead of joining an existing one. */\n  create?: boolean;\n  /** --force: write loam.json here even though one already governs a parent directory. */\n  force?: boolean;\n  /** commander's --no-commands: true unless the flag is passed. */\n  commands: boolean;\n  /** commander's --no-skills: true unless the flag is passed. */\n  skills: boolean;\n  /** --tools: comma-separated AGENT_TOOLS ids, or \"all\". Absent = autodetect. */\n  tools?: string;\n  json?: boolean;\n}\n\n/**\n * Resolve --tools to registry ids, or null after reporting the refusal. The\n * default (the cwd scan) lives at the call site, not in commander, so an\n * explicit `--tools` is distinguishable from none — which is what lets both the\n * autodetection fallback and the `--no-*` contradiction be decided instead of\n * silently arbitrated.\n */\nfunction resolveTools(raw: string, json: boolean): string[] | null {\n  const supported = Object.keys(AGENT_TOOLS);\n  if (raw === \"all\") return supported;\n  const ids = [...new Set(raw.split(\",\").map((t) => t.trim()).filter((t) => t !== \"\"))];\n  const unknown = ids.filter((t) => !(t in AGENT_TOOLS));\n  if (ids.length === 0 || unknown.length > 0) {\n    fail(\n      json,\n      \"invalid-option\",\n      (ids.length === 0\n        ? \"--tools names no tool.\"\n        : `--tools does not recognize: ${unknown.join(\", \")}.`) +\n        ` Supported: ${supported.join(\", \")} — or \"all\".`,\n    );\n    return null;\n  }\n  return ids;\n}\n\n/**\n * `--docs` exactly as the caller wrote it, with separators normalised.\n *\n * Stored verbatim on purpose. `init` used to resolve it and write the absolute\n * result, which meant a committed loam.json named a directory that existed on\n * one laptop: every teammate who cloned the service repo got a docsDir under\n * someone else's home directory, and `loam list` reported an empty fleet\n * instead of saying so. `loadConfig` resolves relative paths against the config\n * file's own directory, so `../docs` keeps meaning \"next to this repo\" wherever\n * the pair is checked out. An absolute `--docs` is still stored absolute — that\n * is the caller's explicit choice, and `loam doctor` warns about it.\n *\n * Backslashes become forward slashes so a config written on Windows resolves on\n * POSIX; a trailing separator is dropped so the stored spelling is stable.\n */\nfunction storedDocsDir(raw: string): string {\n  const slashed = raw.split(\"\\\\\").join(\"/\");\n  if (slashed.length <= 1) return slashed;\n  const trimmed = slashed.replace(/\\/+$/, \"\");\n  return trimmed === \"\" ? \"/\" : trimmed;\n}\n\n/**\n * Does this directory already hold a docs repo? `services/` plus `AGENTS.md` —\n * the two things every docs repo has and no service repo does. The pair is the\n * whole point: a single marker would make `init --docs ../srv` (a typo for\n * `../docs`) look like a join and adopt the service repo as the fleet.\n */\nfunction isDocsRepo(dir: string): boolean {\n  return docsRepoState(dir).kind === \"ok\" && existsSync(agentsPath(dir));\n}\n\nexport function registerInit(program: Command): void {\n  program\n    .command(\"init\")\n    .description(\"Initialize loam: create/point at the shared docs repo and write local config\")\n    .option(\"--docs <dir>\", \"path to the shared docs repo (the source of truth)\", \".loam-docs\")\n    .option(\"--service <id>\", \"canonical id of the service in this repo\")\n    .option(\"--create\", \"create a new docs repo at --docs instead of joining an existing one\")\n    .option(\"--force\", `write ${CONFIG_FILENAME} here even though one governs a parent directory`)\n    .option(\n      \"--tools <ids>\",\n      \"agent tools to generate for, overriding the scan of this directory: \" +\n        `comma-separated (${Object.keys(AGENT_TOOLS).join(\", \")}) or \"all\"`,\n    )\n    .option(\"--no-commands\", \"skip the slash commands for this repo entirely\")\n    .option(\"--no-skills\", \"skip the agent skills for this repo entirely\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (opts: InitOptions, command: Command) => {\n      const json = opts.json === true;\n      const cwd = process.cwd();\n\n      // The id becomes services/<id>/ in the shared repo, so it is validated\n      // before anything is written — by the same rule adopt, vouch and gherkin\n      // use, never by a guard invented here.\n      if (opts.service !== undefined) {\n        try {\n          assertServiceId(opts.service);\n        } catch (err) {\n          if (!(err instanceof InvalidIdError)) throw err;\n          fail(json, \"invalid-option\", err.message);\n          return;\n        }\n      }\n\n      // A loam.json in an ancestor already governs this directory: every command\n      // run from here resolves to it. Writing a second one below it would shadow\n      // the first for this subtree only — the kind of split-brain nobody\n      // discovers until two commands disagree about which docs repo is the fleet.\n      const governing = findConfigPath(cwd);\n      if (governing !== null && governing !== localConfigPath(cwd) && opts.force !== true) {\n        fail(\n          json,\n          \"already-exists\",\n          `${governing} already governs this directory. ` +\n            `Run loam from ${resolve(governing, \"..\")}, or pass --force to give this ` +\n            `subdirectory its own ${CONFIG_FILENAME}.`,\n        );\n        return;\n      }\n\n      // Only THIS directory's config is spread forward. Under --force there is\n      // a config in an ancestor too, and inheriting its `service` would bind\n      // this repo to a service somebody else's repo declared.\n      const existing = existsSync(localConfigPath(cwd)) ? await loadConfig(cwd) : null;\n\n      // A re-run must not move a committed pointer. `--docs` has a default\n      // (`.loam-docs`), so an init invoked for any OTHER reason — `--service`,\n      // a new `--tools`, the fix `doctor.agent-files-missing` prints — used to\n      // arrive here carrying a docsDir nobody typed: the default then named no\n      // docs repo, the refusal steered the caller to `--create`, and `--create`\n      // rewrote `docsDir` in the committed loam.json to a freshly scaffolded\n      // empty one. `validate --all` went green over an empty fleet, which is\n      // the exact outcome `--create` exists to prevent. So the flag wins only\n      // when it was actually passed; otherwise the file this repo already\n      // committed does.\n      const committedDocs = existing?.docsDirAsWritten;\n      const docsTyped = command.getOptionValueSource(\"docs\") !== \"default\";\n      const docsSource: \"flag\" | \"config\" | \"default\" =\n        docsTyped ? \"flag\" : committedDocs === undefined ? \"default\" : \"config\";\n      const docsOption = !docsTyped && committedDocs !== undefined ? committedDocs : opts.docs;\n      const docsDir = resolve(cwd, docsOption);\n\n      // The one predictable failure: --docs naming a file. Refused here so the\n      // caller gets a clean envelope/message instead of mkdir's ENOTDIR throw.\n      if (existsSync(docsDir) && !statSync(docsDir).isDirectory()) {\n        fail(json, \"invalid-option\", `--docs points at a file, not a directory: ${docsDir}`);\n        return;\n      }\n\n      // Joining an existing docs repo and creating a new one are different\n      // intentions, and `init` used to perform the second one whenever the first\n      // was misspelled: `--docs ../dcos` scaffolded a second, empty docs repo\n      // beside the real one, and the fleet quietly split in two. Creation is now\n      // something the caller asks for.\n      const joining = isDocsRepo(docsDir);\n      if (!joining && opts.create !== true) {\n        fail(\n          json,\n          \"invalid-option\",\n          docsRepoState(docsDir).kind === \"missing\"\n            ? `--docs points at a directory that does not exist: ${docsDir}. ` +\n              \"If that is a typo, fix it; to create a new docs repo there, pass --create.\"\n            : `--docs points at ${docsDir}, which is not a docs repo ` +\n              \"(a docs repo has services/ and AGENTS.md). \" +\n              \"Point --docs at the shared docs repo, or pass --create to make a new one here.\",\n        );\n        return;\n      }\n\n      // --tools selects the files to write; --no-commands and --no-skills each\n      // say write none of that kind. Together they contradict — refused, not\n      // arbitrated, in either combination.\n      const suppressed = [\n        ...(opts.commands ? [] : [\"--no-commands\"]),\n        ...(opts.skills ? [] : [\"--no-skills\"]),\n      ];\n      if (opts.tools !== undefined && suppressed.length > 0) {\n        fail(\n          json,\n          \"invalid-option\",\n          `--tools contradicts ${suppressed.join(\" and \")}: ` +\n            \"one selects the files to generate, the other suppresses them.\",\n        );\n        return;\n      }\n      const delivery: Delivery[] = [\n        ...(opts.commands ? ([\"commands\"] as const) : []),\n        ...(opts.skills ? ([\"skills\"] as const) : []),\n      ];\n\n      // Without --tools the repo decides: whichever tools have left their own\n      // dot-directories here. Falling back to claude keeps a bare repo behaving\n      // exactly as it did before the scan existed. `detected` is reported either\n      // way — what the scan saw is a fact about the repo, not about the flags.\n      const detected = detectAgentTools(cwd);\n      const scanned = detected.length > 0 ? detected : [\"claude\"];\n      const tools = opts.tools === undefined ? scanned : resolveTools(opts.tools, json);\n      if (tools === null) return;\n\n      // `skipped` is the other half of the never-overwrite contract: the\n      // scaffolds return only what they created, so what they left alone is\n      // probed here, before they run — in the order they would create it, so\n      // created + skipped is the same list on every repo. Both halves come from\n      // the scaffolds' own planned-file lists, so the probe cannot drift from\n      // what is actually written.\n      const agentFiles = delivery.length > 0 ? plannedCommandFiles(cwd, tools, delivery) : [];\n      const candidates = [...plannedDocsFiles(docsDir), ...agentFiles.map((f) => f.path)];\n      const skipped = candidates.filter((p) => existsSync(p));\n\n      // Joining touches the docs repo not at all: it is somebody's committed\n      // repository, and \"point at it\" must never mean \"write to it\".\n      const created = joining && opts.create !== true ? [] : (await scaffoldDocs(docsDir)).created;\n      const generatedFor = delivery.length > 0 ? tools : [];\n      if (delivery.length > 0) {\n        created.push(...(await scaffoldAgentCommands(cwd, tools, delivery)));\n      }\n\n      const stored = storedDocsDir(docsOption);\n      // Union, not replacement: this run's files join the ones earlier runs left\n      // on disk, and `agentTools` is a record of what the repo HOLDS. A run that\n      // generated nothing adds nothing and erases nothing.\n      const recordedTools = [...new Set([...(existing?.agentTools ?? []), ...generatedFor])];\n      const config: LoamConfig = {\n        ...existing,\n        docsDir: stored,\n        ...(opts.service ? { service: opts.service } : {}),\n        ...(recordedTools.length > 0 ? { agentTools: recordedTools } : {}),\n      };\n      const configFile = await saveConfig(config, cwd);\n\n      const serviceCount = (await listServices(docsDir)).length;\n\n      if (json) {\n        // `docsDir` stays the resolved absolute path — it is what a consumer\n        // needs to find the repo. `docsDirStored` is what was written to\n        // loam.json, which is the fact this command is now careful about.\n        // `tools` names what files were generated FOR — empty when every\n        // delivery was suppressed and none were. `detected` is the separate\n        // question of what the scan SAW, which `--tools` overrides without\n        // changing: an agent comparing the two learns whether its selection\n        // matches the repo.\n        emitJson({\n          docsDir,\n          docsDirStored: stored,\n          // Where the pointer came from: `flag` (a --docs somebody typed),\n          // `config` (the one this repo already committed — a re-run cannot\n          // move it), or `default` (nothing said, nothing committed).\n          docsDirSource: docsSource,\n          docsRepo: joining ? \"existing\" : \"created\",\n          services: serviceCount,\n          created,\n          skipped,\n          tools: generatedFor,\n          detected,\n        });\n        return;\n      }\n\n      console.log(\"loam initialized.\");\n      if (joining) {\n        console.log(`  docs repo: ${docsDir}`);\n        console.log(`             pointing at existing docs repo (${serviceCount} services)`);\n      } else {\n        console.log(`  docs repo: ${docsDir}  (created)`);\n      }\n      console.log(\n        `  docsDir:   ${stored}  (as stored in ${CONFIG_FILENAME}`\n        + (docsSource === \"config\" ? \" — kept; no --docs was passed\" : \"\") + \")\",\n      );\n      if (config.service) console.log(`  service:   ${config.service}`);\n      console.log(`  config:    ${configFile}`);\n      console.log(`             commit ${CONFIG_FILENAME} — docsDir is resolved relative to it`);\n      if (opts.tools === undefined && detected.length > 0) {\n        console.log(`  detected:  ${detected.join(\", \")}`);\n      }\n      if (opts.commands) console.log(`  commands:  ${tools.join(\", \")}`);\n      if (opts.skills) console.log(`  skills:    ${tools.join(\", \")}`);\n      if (created.length > 0) {\n        console.log(\"  scaffolded:\");\n        for (const c of created) console.log(`    + ${c}`);\n      }\n    });\n}\n"]}