blacksmith-organization-system 1.0.0-dev.3 → 1.2.0

package/dist/procedures/proposing/_index.js

@@ -0,0 +1,9 @@
+import { Procedure } from "../../core/procedure.js";
+import { open, route, weigh } from "./steps.js";
+export { undecided } from "./context.js";
+export const proposing = new Procedure("proposing", [
+    { name: "route", run: route },
+    { name: "weigh", run: weigh },
+    { name: "open", run: open },
+]);
+//# sourceMappingURL=_index.js.map

package/dist/procedures/proposing/_index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_index.js","sourceRoot":"","sources":["../../../src/procedures/proposing/_index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAyC,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhF,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAiB,WAAW,EAAE;IAClE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE;IAC7B,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE;IAC7B,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE;CAC5B,CAAC,CAAC"}

package/dist/procedures/proposing/context.d.ts

@@ -0,0 +1,16 @@
+import type { GitHub } from "../../bridges/github.ts";
+import type { Context } from "../../core/context.ts";
+import type { Loop, LoopStep } from "../../models/_index.ts";
+export type FlowOutcome = {
+    action: "none" | "exists" | "would-open" | "opened" | "would-merge" | "merged";
+    reason: string;
+    step: LoopStep | null;
+    pullRequest: number | null;
+};
+export type ProposeContext = Context & {
+    loop: Loop;
+    github: GitHub;
+    branch: string;
+    outcome: FlowOutcome;
+};
+export declare function undecided(): FlowOutcome;

package/dist/procedures/proposing/context.js

@@ -0,0 +1,4 @@
+export function undecided() {
+    return { action: "none", reason: "", step: null, pullRequest: null };
+}
+//# sourceMappingURL=context.js.map

package/dist/procedures/proposing/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/procedures/proposing/context.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,SAAS;IACvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC"}

package/dist/procedures/proposing/steps.d.ts

@@ -0,0 +1,4 @@
+import type { ProposeContext } from "./context.ts";
+export declare function route(context: ProposeContext): void;
+export declare function weigh(context: ProposeContext): void;
+export declare function open(context: ProposeContext): void;

package/dist/procedures/proposing/steps.js

@@ -0,0 +1,46 @@
+const BUMP = /^(chore\(release\):|bump:)/;
+export function route(context) {
+    const step = context.loop.step(context.branch);
+    context.outcome.step = step;
+    if (!step)
+        context.outcome.reason = `${context.branch} is not part of the loop`;
+    else if (!context.loop.data.autocreate)
+        context.outcome.reason = "autocreate is off";
+}
+export function weigh(context) {
+    const { outcome, loop, github } = context;
+    if (outcome.reason || !outcome.step)
+        return;
+    const { from, to } = outcome.step;
+    const { aheadBy, commits } = github.compare(to, from);
+    if (aheadBy === 0)
+        outcome.reason = `${from} has nothing new for ${to}`;
+    else if (from !== loop.data.release && !commits.some((c) => c.parents === 1 && !BUMP.test(c.message)))
+        outcome.reason = `${from} has only merges and release bumps for ${to}`;
+}
+export function open(context) {
+    const { outcome, github } = context;
+    if (outcome.reason || !outcome.step)
+        return;
+    const { from, to, automerge } = outcome.step;
+    const existing = github.openPullRequest(from, to);
+    if (existing !== null) {
+        Object.assign(outcome, { action: "exists", pullRequest: existing, reason: `#${existing} is already open` });
+        return;
+    }
+    const plan = `pull request ${from} → ${to}`;
+    context.changes.push(plan);
+    if (context.dryRun) {
+        Object.assign(outcome, { action: "would-open", reason: `would open the ${plan}` });
+        return;
+    }
+    const body = [
+        `### Loop step: \`${from}\` → \`${to}\``,
+        "",
+        `Opened by the BOS craft loop (${context.loop.source === "default" ? "the default loop" : `\`${context.loop.source}\``}).`,
+        `Merges by itself once checked: **${automerge ? "yes" : "no, a person merges it"}**.`,
+    ].join("\n");
+    const number = github.createPullRequest(from, to, `Loop: ${from} → ${to}`, body);
+    Object.assign(outcome, { action: "opened", pullRequest: number, reason: `opened #${number}` });
+}
+//# sourceMappingURL=steps.js.map

package/dist/procedures/proposing/steps.js.map

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

package/dist/procedures/versioning/_index.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from "../../core/context.ts";
+import { Procedure } from "../../core/procedure.ts";
+import type { LoopEvent } from "../../core/version.ts";
+import type { Scope, Workshop } from "../../models/_index.ts";
+export type VersionContext = Context & {
+    workshop: Workshop;
+    scope: Scope;
+    event: LoopEvent;
+    result?: {
+        scope: string;
+        event: LoopEvent;
+        from: string | null;
+        to: string;
+    };
+};
+export declare const versioning: Procedure<VersionContext>;

package/dist/procedures/versioning/_index.js

@@ -0,0 +1,22 @@
+import { Procedure } from "../../core/procedure.js";
+export const versioning = new Procedure("versioning", [
+    {
+        name: "bump",
+        run: (context) => {
+            if (!context.scope.exists())
+                throw new Error(`no scope at ${context.scope.path}`);
+            const { from, to } = context.scope.bump(context.event, context);
+            context.result = { scope: context.scope.name, event: context.event, from, to };
+        },
+    },
+    {
+        name: "record",
+        run: (context) => {
+            if (context.dryRun || !context.result)
+                return;
+            const { scope, event, from, to } = context.result;
+            context.workshop.system.storylines.record({ event: "scope-bump", scope, loopEvent: event, from, to }, context);
+        },
+    },
+]);
+//# sourceMappingURL=_index.js.map

package/dist/procedures/versioning/_index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_index.js","sourceRoot":"","sources":["../../../src/procedures/versioning/_index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAWpD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,SAAS,CAAiB,YAAY,EAAE;IACpE;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;YACf,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAClF,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAChE,OAAO,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACjF,CAAC;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;YACf,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,OAAO;YAC9C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACjH,CAAC;KACF;CACF,CAAC,CAAC"}

package/dist/procedures/watching/_index.d.ts

@@ -0,0 +1,5 @@
+import { Procedure } from "../../core/procedure.ts";
+import type { WatchContext } from "./context.ts";
+export { classify, isNoise } from "./classify.ts";
+export type { WatchContext, WorkshopEvent } from "./context.ts";
+export declare const watching: Procedure<WatchContext>;

package/dist/procedures/watching/_index.js

@@ -0,0 +1,9 @@
+import { Procedure } from "../../core/procedure.js";
+import { start } from "./start.js";
+import { wait } from "./wait.js";
+export { classify, isNoise } from "./classify.js";
+export const watching = new Procedure("watching", [
+    { name: "start", run: start },
+    { name: "wait", run: wait },
+]);
+//# sourceMappingURL=_index.js.map

package/dist/procedures/watching/_index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_index.js","sourceRoot":"","sources":["../../../src/procedures/watching/_index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,SAAS,CAAe,UAAU,EAAE;IAC9D,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE;IAC7B,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE;CAC5B,CAAC,CAAC"}

package/dist/procedures/watching/classify.d.ts

@@ -0,0 +1,5 @@
+import type { Change } from "../../core/host.ts";
+import type { Workshop } from "../../models/_index.ts";
+import type { WorkshopEvent } from "./context.ts";
+export declare function isNoise(relative: string): boolean;
+export declare function classify(workshop: Workshop, change: Change): WorkshopEvent | null;

package/dist/procedures/watching/classify.js

@@ -0,0 +1,30 @@
+import { dirname, inside, join } from "../../core/paths.js";
+import { isRepository } from "../../models/project/git.js";
+import { placeOf } from "../../models/workshop/locate.js";
+const NOISE = [/(^|\/)\.git(\/|$)/, /(^|\/)node_modules(\/|$)/, /^\.BOS\/storylines(\/|$)/];
+export function isNoise(relative) {
+    return NOISE.some((pattern) => pattern.test(relative));
+}
+// the nearest git repository between the changed path and its scope
+function projectOf(workshop, scopeDir, path) {
+    let dir = workshop.host.isDirectory(path) ? path : dirname(path);
+    while (inside(scopeDir, dir)) {
+        if (isRepository(workshop.host, dir))
+            return inside(scopeDir, dir);
+        dir = dirname(dir);
+    }
+    return null;
+}
+export function classify(workshop, change) {
+    if (isNoise(change.path))
+        return null;
+    const path = join(workshop.path, change.path);
+    const place = placeOf(workshop.path, path);
+    if (!place)
+        return null;
+    const scope = place.scope ?? null;
+    const project = scope ? projectOf(workshop, join(workshop.forge.path, scope), path) : null;
+    const inner = project ? inside(join(workshop.forge.path, scope ?? "", project), path) || null : (place.inner ?? null);
+    return { unixusat: workshop.host.now(), kind: change.kind, path, area: place.area, scope, project, inner };
+}
+//# sourceMappingURL=classify.js.map

package/dist/procedures/watching/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../src/procedures/watching/classify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAG1D,MAAM,KAAK,GAAG,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,0BAA0B,CAAC,CAAC;AAE5F,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,oEAAoE;AACpE,SAAS,SAAS,CAAC,QAAkB,EAAE,QAAgB,EAAE,IAAY;IACnE,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,MAAc;IACzD,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;IACtH,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC7G,CAAC"}

package/dist/procedures/watching/context.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from "../../core/context.ts";
+import type { Workshop } from "../../models/_index.ts";
+export type WorkshopEvent = {
+    unixusat: number;
+    kind: "change" | "rename";
+    path: string;
+    area: string | null;
+    scope: string | null;
+    project: string | null;
+    inner: string | null;
+};
+export type WatchContext = Context & {
+    workshop: Workshop;
+    signal: AbortSignal;
+    onEvent: (event: WorkshopEvent) => void;
+    record: boolean;
+    quietMs: number;
+    stop?: () => void;
+    failure?: Error;
+    wake?: () => void;
+};

package/dist/procedures/watching/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/procedures/watching/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/procedures/watching/context.ts"],"names":[],"mappings":""}

package/dist/procedures/watching/start.d.ts

@@ -0,0 +1,2 @@
+import type { WatchContext } from "./context.ts";
+export declare function start(context: WatchContext): void;

package/dist/procedures/watching/start.js

@@ -0,0 +1,24 @@
+import { classify, isNoise } from "./classify.js";
+export function start(context) {
+    const { workshop, host } = context;
+    if (!workshop.exists())
+        throw new Error(`${workshop.path} does not exist (bos workshop bootstrap creates it)`);
+    const lastSeen = new Map();
+    context.stop = host.watch(workshop.path, (change) => {
+        const event = classify(workshop, change);
+        if (!event)
+            return;
+        const key = `${event.kind}:${event.path}`;
+        const previous = lastSeen.get(key);
+        lastSeen.set(key, event.unixusat);
+        if (previous !== undefined && event.unixusat - previous < context.quietMs)
+            return;
+        if (context.record)
+            workshop.system.storylines.record({ event: "change", ...event }, context);
+        context.onEvent(event);
+    }, (error) => {
+        context.failure = error;
+        context.wake?.();
+    }, isNoise);
+}
+//# sourceMappingURL=start.js.map

package/dist/procedures/watching/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/procedures/watching/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,UAAU,KAAK,CAAC,OAAqB;IACzC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACnC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,qDAAqD,CAAC,CAAC;IAC/G,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CACvB,QAAQ,CAAC,IAAI,EACb,CAAC,MAAM,EAAE,EAAE;QACT,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO;YAAE,OAAO;QAClF,IAAI,OAAO,CAAC,MAAM;YAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9F,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;QACR,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QACxB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IACnB,CAAC,EACD,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/procedures/watching/wait.d.ts

@@ -0,0 +1,2 @@
+import type { WatchContext } from "./context.ts";
+export declare function wait(context: WatchContext): Promise<void>;

package/dist/procedures/watching/wait.js

@@ -0,0 +1,12 @@
+export async function wait(context) {
+    const { signal } = context;
+    if (!signal.aborted && !context.failure)
+        await new Promise((resolve) => {
+            context.wake = resolve;
+            signal.addEventListener("abort", () => resolve());
+        });
+    context.stop?.();
+    if (context.failure)
+        throw context.failure;
+}
+//# sourceMappingURL=wait.js.map

package/dist/procedures/watching/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../../src/procedures/watching/wait.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAqB;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;QACrC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;YACvB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IACjB,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,OAAO,CAAC,OAAO,CAAC;AAC7C,CAAC"}

package/dist/tools/_index.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "../core/tool.ts";
+export declare const TOOLS: Tool[];
+export declare function findTool(model: string | undefined, name: string | undefined): Tool;

package/dist/tools/_index.js

@@ -0,0 +1,25 @@
+import { devlogTools } from "./devlog.js";
+import { flowTools } from "./flow.js";
+import { projectTools } from "./project.js";
+import { scopeTools } from "./scope.js";
+import { versionTools } from "./version.js";
+import { workshopTools } from "./workshop.js";
+export const TOOLS = [
+    ...workshopTools,
+    ...scopeTools,
+    ...devlogTools,
+    ...flowTools,
+    ...projectTools,
+    ...versionTools,
+];
+export function findTool(model, name) {
+    const entry = TOOLS.find((t) => t.model === model && t.name === name);
+    if (entry)
+        return entry;
+    const models = [...new Set(TOOLS.map((t) => t.model))];
+    if (!models.includes(String(model)))
+        throw new Error(`unknown model "${model}" (models: ${models.join(", ")})`);
+    const names = TOOLS.filter((t) => t.model === model).map((t) => t.name);
+    throw new Error(`${model} has no tool "${name}" (tools: ${names.join(", ")})`);
+}
+//# sourceMappingURL=_index.js.map

package/dist/tools/_index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_index.js","sourceRoot":"","sources":["../../src/tools/_index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,KAAK,GAAW;IAC3B,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,GAAG,YAAY;CAChB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,KAAyB,EAAE,IAAwB;IAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACtE,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,cAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iBAAiB,IAAI,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC"}

package/dist/tools/devlog.d.ts

@@ -0,0 +1 @@
+export declare const devlogTools: import("../core/tool.ts").Tool[];

package/dist/tools/devlog.js

@@ -0,0 +1,43 @@
+// bos devlog <tool>: the devlog of the project around the current directory
+import { createContext } from "../core/context.js";
+import { tool } from "../core/tool.js";
+import { Devlog } from "../models/devlog/class.js";
+import { projectAround } from "../models/project/around.js";
+import { stateMarkdown } from "../views/devlog.js";
+const dirArg = { name: "dir", type: "string", info: "a path inside the project (default: current directory)" };
+function readState(bos, dir) {
+    const project = projectAround(bos.host, dir);
+    const devlog = project.child(Devlog);
+    const report = project.report();
+    return {
+        project: project.name,
+        branch: report.git?.branch ?? null,
+        version: report.version?.version ?? null,
+        phases: devlog.phases(),
+        questions: devlog.questions(),
+        proposals: devlog.proposals(),
+        waiting: { orders: devlog.waiting("ORDERS.md"), inquiries: devlog.waiting("INQUIRIES.md") },
+        missing: devlog.missingFiles(),
+    };
+}
+export const devlogTools = [
+    tool({
+        model: "devlog",
+        name: "state",
+        info: "where the project stands: phases of TODO.md, open questions and proposals, waiting orders",
+        args: [dirArg, { name: "write", type: "boolean", info: "write docs/devlog/STATE.md instead of printing" }],
+        run: (bos, input) => {
+            const state = readState(bos, input.dir);
+            if (input.write) {
+                const devlog = projectAround(bos.host, input.dir).child(Devlog);
+                const context = createContext(bos.host);
+                bos.host.writeText(devlog.file("STATE.md"), stateMarkdown(state));
+                context.changes.push(devlog.file("STATE.md"));
+                return { state, written: context.changes };
+            }
+            return { state, written: [] };
+        },
+        render: (result) => (result.written.length ? `wrote ${result.written.join(", ")}` : stateMarkdown(result.state)),
+    }),
+];
+//# sourceMappingURL=devlog.js.map

package/dist/tools/devlog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devlog.js","sourceRoot":"","sources":["../../src/tools/devlog.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAoB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAErE,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,wDAAwD,EAAW,CAAC;AAExH,SAAS,SAAS,CAAC,GAAQ,EAAE,GAAY;IACvC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAChC,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,IAAI;QAClC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI;QACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;QAC7B,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;QAC3F,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,CAAC;QACH,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,2FAA2F;QACjG,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gDAAgD,EAAE,CAAC;QAC1G,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAClB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,GAAyB,CAAC,CAAC;YAC9D,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,GAAyB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtF,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACxC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;gBAClE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC9C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YAC7C,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAc,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KACjH,CAAC;CACH,CAAC"}

package/dist/tools/flow.d.ts

@@ -0,0 +1 @@
+export declare const flowTools: import("../core/tool.ts").Tool[];

package/dist/tools/flow.js

@@ -0,0 +1,81 @@
+// bos flow <tool>: the craft loop of the project around the current directory
+import { tool } from "../core/tool.js";
+import { bumpText, explainText, outcomeText, stepText } from "../views/flow.js";
+const dirArg = { name: "dir", type: "string", info: "a path inside the project (default: current directory)" };
+const dryRunArg = { name: "dryRun", type: "boolean", info: "only say what would be done on GitHub" };
+const dir = (value) => value;
+export const flowTools = [
+    tool({
+        model: "flow",
+        name: "explain",
+        info: "the project's craft loop (.github/bos.json): every forward step, what merges by itself, the bumps",
+        args: [dirArg],
+        run: (bos, input) => {
+            const { loop, versioning } = bos.settings(dir(input.dir));
+            return { source: loop.source, steps: loop.steps(), data: loop.data, versioning };
+        },
+        render: explainText,
+    }),
+    tool({
+        model: "flow",
+        name: "next",
+        info: "the forward step of a branch in the loop (reads only, no GitHub)",
+        args: [
+            { name: "branch", type: "string", info: "a station or a contributor's branch", positional: true, required: true },
+            dirArg,
+        ],
+        run: (bos, input) => bos.loop(dir(input.dir)).loop.step(String(input.branch)),
+        render: (step, input) => (step ? stepText(step) : `${input.branch} is not part of the loop`),
+    }),
+    tool({
+        model: "flow",
+        name: "next-pr",
+        info: "open on GitHub the pull request of a branch's forward step, unless there is nothing to propose",
+        readOnly: false,
+        args: [
+            { name: "branch", type: "string", info: "the branch that moved", positional: true, required: true },
+            dirArg,
+            dryRunArg,
+        ],
+        run: (bos, input) => bos.propose(String(input.branch), { dir: dir(input.dir), dryRun: Boolean(input.dryRun) }),
+        render: outcomeText,
+    }),
+    tool({
+        model: "flow",
+        name: "automerge",
+        info: "merge a loop pull request on GitHub when the loop lets it merge by itself",
+        readOnly: false,
+        args: [
+            { name: "pr", type: "string", info: "the pull request's number", positional: true, required: true },
+            dirArg,
+            dryRunArg,
+        ],
+        run: (bos, input) => {
+            const number = Number(input.pr);
+            if (!Number.isInteger(number) || number < 1)
+                throw new Error(`not a pull request number: ${input.pr}`);
+            return bos.automerge(number, { dir: dir(input.dir), dryRun: Boolean(input.dryRun) });
+        },
+        render: outcomeText,
+    }),
+    tool({
+        model: "flow",
+        name: "bump",
+        info: "bump the project's version for work landing on a station (.github/bos.json versioning); only a released version moves",
+        readOnly: false,
+        args: [
+            {
+                name: "station",
+                type: "string",
+                info: "the branch the work landed on, e.g. revision",
+                positional: true,
+                required: true,
+            },
+            dirArg,
+            { name: "dryRun", type: "boolean", info: "only say what the version would become" },
+        ],
+        run: (bos, input) => bos.bump(String(input.station), { dir: dir(input.dir), dryRun: Boolean(input.dryRun) }),
+        render: bumpText,
+    }),
+];
+//# sourceMappingURL=flow.js.map

package/dist/tools/flow.js.map

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

package/dist/tools/project.d.ts

@@ -0,0 +1 @@
+export declare const projectTools: import("../core/tool.ts").Tool[];

package/dist/tools/project.js

@@ -0,0 +1,18 @@
+// bos project <tool>: the project around the current directory
+import { tool } from "../core/tool.js";
+import { authorsText } from "../views/project.js";
+export const projectTools = [
+    tool({
+        model: "project",
+        name: "authors",
+        info: "name every entity of the commits (people, agents, bots) in .github/AUTHORS; new ones appended",
+        readOnly: false,
+        args: [
+            { name: "dir", type: "string", info: "a path inside the project (default: current directory)" },
+            { name: "dryRun", type: "boolean", info: "only say what would be written" },
+        ],
+        run: (bos, input) => bos.authors({ dir: input.dir, dryRun: Boolean(input.dryRun) }),
+        render: authorsText,
+    }),
+];
+//# sourceMappingURL=project.js.map

package/dist/tools/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/tools/project.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,+FAA+F;QACrG,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,wDAAwD,EAAE;YAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAE;SAC5E;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAyB,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzG,MAAM,EAAE,WAAW;KACpB,CAAC;CACH,CAAC"}

package/dist/tools/scope.d.ts

@@ -0,0 +1 @@
+export declare const scopeTools: import("../core/tool.ts").Tool[];

package/dist/tools/scope.js

@@ -0,0 +1,51 @@
+// bos scope <tool>
+import { tool } from "../core/tool.js";
+import { EVENTS, isLoopEvent } from "../core/version.js";
+const scopeArg = {
+    name: "scope",
+    type: "string",
+    info: "scope name in the forge",
+    positional: true,
+    required: true,
+};
+export const scopeTools = [
+    tool({
+        model: "scope",
+        name: "version",
+        info: "the scope's GRIH version (vG.R.I.H), from <scope>/.bos/scope.json",
+        args: [scopeArg],
+        run: (bos, input) => {
+            const scope = bos.workshop.forge.scope(String(input.scope));
+            if (!scope.exists())
+                throw new Error(`no scope at ${scope.path}`);
+            return { scope: scope.name, version: scope.version() };
+        },
+        render: (result) => `${result.scope}  ${result.version ? `v${result.version}` : "no version yet"}`,
+    }),
+    tool({
+        model: "scope",
+        name: "bump",
+        info: `raise the scope's GRIH version for a loop event: ${EVENTS.join(", ")}`,
+        readOnly: false,
+        args: [
+            scopeArg,
+            {
+                name: "event",
+                type: "string",
+                info: "step → H, phase → I, milestone → R, flip → G",
+                positional: true,
+                required: true,
+            },
+            { name: "dryRun", type: "boolean", info: "only show the new version" },
+        ],
+        run: async (bos, input) => {
+            const event = String(input.event);
+            if (!isLoopEvent(event))
+                throw new Error(`"${event}" is not a loop event (${EVENTS.join(", ")})`);
+            const context = await bos.bumpScope(String(input.scope), event, { dryRun: Boolean(input.dryRun) });
+            return { ...context.result, dryRun: context.dryRun };
+        },
+        render: (result) => `${result.scope}  ${result.from ? `v${result.from}` : "(none)"} → v${result.to}${result.dryRun ? "  (dry run)" : ""}`,
+    }),
+];
+//# sourceMappingURL=scope.js.map

package/dist/tools/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/tools/scope.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,yBAAyB;IAC/B,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,IAAI;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,CAAC;QACH,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,mEAAmE;QACzE,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAClB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACzD,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE;KACnG,CAAC;IACF,IAAI,CAAC;QACH,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,oDAAoD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC7E,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE;YACJ,QAAQ;YACR;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,8CAA8C;gBACpD,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;aACf;YACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,2BAA2B,EAAE;SACvE;QACD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,0BAA0B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClG,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnG,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CACjB,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE;KACxH,CAAC;CACH,CAAC"}

package/dist/tools/version.d.ts

@@ -0,0 +1 @@
+export declare const versionTools: import("../core/tool.ts").Tool[];

package/dist/tools/version.js

@@ -0,0 +1,23 @@
+// bos version <tool>: the version arithmetic of the craft loop, for scripts and CI
+import { tool } from "../core/tool.js";
+import { bumpGrih, bumpSemver, EVENTS, isLoopEvent } from "../core/version.js";
+export const versionTools = [
+    tool({
+        model: "version",
+        name: "bump",
+        info: "the next version after a loop event; semver X.Y.Z, or GRIH G.R.I.H with --grih",
+        args: [
+            { name: "version", type: "string", info: "current version, e.g. 0.6.1", positional: true, required: true },
+            { name: "event", type: "string", info: EVENTS.join(", "), positional: true, required: true },
+            { name: "grih", type: "boolean", info: "read and write GRIH instead of semver" },
+        ],
+        run: (_bos, input) => {
+            const event = String(input.event);
+            if (!isLoopEvent(event))
+                throw new Error(`"${event}" is not a loop event (${EVENTS.join(", ")})`);
+            return (input.grih ? bumpGrih : bumpSemver)(String(input.version), event);
+        },
+        render: (result) => result,
+    }),
+];
+//# sourceMappingURL=version.js.map

package/dist/tools/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/tools/version.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC;QACH,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,gFAAgF;QACtF,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,6BAA6B,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC1G,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC5F,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,uCAAuC,EAAE;SACjF;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,0BAA0B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;KAC3B,CAAC;CACH,CAAC"}

package/dist/tools/workshop.d.ts

@@ -0,0 +1 @@
+export declare const workshopTools: import("../core/tool.ts").Tool[];