@warpgogol/forge 2.19.0 → 2.21.0

package/dist/os/adr/adr.module.js

@@ -1,146 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Register the Architectural Decision Record (ADR) command domain with the forge kernel registry.</purpose>
-<non-goals>
-  <item>Do not implement command logic here; implementations live in handlers/*.ts.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0366: register adr.create, adr.validate, and adr.list commands.</item>
-  <item>RFC-0521: migrated from packages/os/site-kernel/src/adr/ to packages/forge/os/adr/ as forgeAdrModule.</item>
-  <item>RFC-0727: register adr.implement.stamp command for atomic ADR status transition.</item>
-</CHANGE_SUMMARY>
-*/
-export const forgeAdrModule = {
-    name: "forge-adr",
-    version: "0.1.0",
-    runtime: "autonomous",
-    async register(registry) {
-        const { runAdrList, runAdrCreate } = await import("./handlers/list-create.js");
-        const { runAdrValidate } = await import("./handlers/validate.js");
-        const { runAdrArchive } = await import("./handlers/archive.js");
-        const { runAdrImplementStamp } = await import("./handlers/implement-stamp.js");
-        registry.registerCommand({
-            name: "adr.list",
-            description: "List all ADRs. Filter with --status, --scope, --decider flags. " +
-                "Use --json for machine-readable output. " +
-                "Parses frontmatter on the fly — no index file needed.",
-            scope: "workspace",
-            flags: {
-                status: {
-                    kind: "string",
-                    description: "Filter by ADR status (e.g. proposed, accepted, superseded).",
-                },
-                scope: {
-                    kind: "string",
-                    description: "Filter by ADR scope (package, app, workspace).",
-                },
-                decider: { kind: "string", description: "Filter by decider string." },
-            },
-            reads: ["docs/adrs/**/*.md"],
-            execute: runAdrList,
-        });
-        registry.registerCommand({
-            name: "adr.create",
-            description: "Create a new ADR draft from the template. " +
-                'Pass --title "Short title" (required). ' +
-                "Optional: --scope, --decider, --status, --related. " +
-                "Always creates status: proposed unless overridden. " +
-                "AI agents are allowed to use this command.",
-            scope: "workspace",
-            mutatesState: true,
-            writes: ["docs/adrs/adr-*.md"],
-            reads: ["docs/adrs/**/*.md"],
-            cacheable: false,
-            flags: {
-                title: { kind: "string", required: true, description: "Short imperative ADR title." },
-                scope: {
-                    kind: "string",
-                    default: "package",
-                    description: "ADR scope: package | app | workspace.",
-                },
-                decider: {
-                    kind: "string",
-                    default: "architecture",
-                    description: "ADR decider, e.g. architecture or human:<handle>.",
-                },
-                status: {
-                    kind: "string",
-                    default: "proposed",
-                    description: "ADR status: proposed | accepted | superseded | rejected.",
-                },
-                related: {
-                    kind: "string",
-                    description: "Comma-separated list of related RFC/ADR ids (e.g. RFC-0365,RFC-0001).",
-                },
-            },
-            execute: runAdrCreate,
-        });
-        registry.registerCommand({
-            name: "adr.validate",
-            description: "Validate ADR frontmatter schema, required markdown sections, " +
-                "referential integrity (supersedes/supersededBy), and id/filename consistency. " +
-                "Pass --id to validate a single file, or run without arguments for all.",
-            scope: "workspace",
-            flags: {
-                id: { kind: "string", description: "Target a single ADR by id (e.g. ADR-0003)." },
-            },
-            reads: ["docs/adrs/**/*.md"],
-            execute: runAdrValidate,
-        });
-        registry.registerCommand({
-            name: "adr.archive",
-            description: "Move terminal-status ADR files (implemented, rejected, superseded) into " +
-                "docs/adrs/archive/<status>/ subdirectories. Bidirectional: moves non-terminal " +
-                "files found in subdirectories back to root. Use --dry-run to preview. " +
-                "Use --status to filter to a single terminal status. " +
-                "Prefer the docs.archive umbrella command unless you need to archive only ADRs.",
-            scope: "workspace",
-            mutatesState: true,
-            writes: ["docs/adrs/*.md", "docs/adrs/archive/**"],
-            reads: ["docs/adrs/**/*.md"],
-            cacheable: false,
-            flags: {
-                "dry-run": {
-                    kind: "boolean",
-                    description: "Preview what would be moved without touching the filesystem.",
-                },
-                status: {
-                    kind: "string",
-                    description: "Filter to a single terminal status (implemented, rejected, superseded).",
-                },
-            },
-            execute: runAdrArchive,
-        });
-        registry.registerCommand({
-            name: "adr.implement.stamp",
-            description: "Atomically transition an ADR from accepted/proposed to implemented. " +
-                "Validates preconditions (status, implementation commit, file cleanliness, " +
-                "concurrent safety) and mutates frontmatter in one atomic write. " +
-                "Use --dry-run to preview without mutating.",
-            scope: "workspace",
-            mutatesState: true,
-            writes: ["docs/adrs/*.md"],
-            reads: ["docs/adrs/**/*.md"],
-            cacheable: false,
-            flags: {
-                id: {
-                    kind: "string",
-                    required: true,
-                    description: "Target ADR id (e.g. ADR-0003).",
-                },
-                "implementation-commit": {
-                    kind: "string",
-                    required: true,
-                    description: "SHA of the implementation commit.",
-                },
-                "dry-run": {
-                    kind: "boolean",
-                    description: "Preview without mutating the ADR file.",
-                },
-            },
-            execute: runAdrImplementStamp,
-        });
-    },
-};
-//# sourceMappingURL=adr.module.js.map

package/dist/os/adr/adr.module.js.map

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

package/dist/os/adr/frontmatter-io.d.ts

@@ -1,12 +0,0 @@
-export interface ParsedAdr {
-    frontmatter: Record<string, unknown>;
-    body: string;
-}
-export declare function parseAdrFile(source: string): ParsedAdr;
-export declare function listAdrFiles(adrDirPath: string): Promise<string[]>;
-export declare function adrFileMatchesId(fileName: string, targetId: string): boolean;
-export declare function readAndParseAdr(adrDirPath: string, fileName: string): Promise<{
-    fileName: string;
-    parsed: ParsedAdr;
-} | undefined>;
-//# sourceMappingURL=frontmatter-io.d.ts.map

package/dist/os/adr/frontmatter-io.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"frontmatter-io.d.ts","sourceRoot":"","sources":["../../../os/adr/frontmatter-io.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAStD;AAED,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BxE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG,SAAS,CAAC,CAQ9D"}

package/dist/os/adr/frontmatter-io.js

@@ -1,67 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>
-Shared ADR frontmatter file I/O — list ADR files and parse their YAML frontmatter
-without validating the shape.
-</purpose>
-<non-goals>
-  <item>Do not validate frontmatter shape — that is the validate handler.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0366: mirror the RFC frontmatter-io contract for ADRs.</item>
-  <item>RFC-0521: migrated from packages/os/site-kernel/src/adr/ to packages/forge/os/adr/.</item>
-</CHANGE_SUMMARY>
-*/
-import fs from "node:fs/promises";
-import path from "node:path";
-import YAML from "yaml";
-export function parseAdrFile(source) {
-    const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
-    if (!match) {
-        return { frontmatter: {}, body: source };
-    }
-    return {
-        frontmatter: (YAML.parse(match[1]) ?? {}),
-        body: match[2] ?? "",
-    };
-}
-export async function listAdrFiles(adrDirPath) {
-    const results = [];
-    async function scanDir(dirPath, relativePrefix) {
-        try {
-            const entries = await fs.readdir(dirPath, { withFileTypes: true });
-            for (const entry of entries) {
-                const relativePath = relativePrefix ? `${relativePrefix}/${entry.name}` : entry.name;
-                if (entry.isDirectory()) {
-                    await scanDir(path.join(dirPath, entry.name), relativePath);
-                }
-                else if (entry.isFile() &&
-                    entry.name.endsWith(".md") &&
-                    !entry.name.startsWith("adr-0000") &&
-                    entry.name !== "README.md") {
-                    results.push(relativePath);
-                }
-            }
-        }
-        catch {
-            // Directory doesn't exist or is unreadable — return empty
-        }
-    }
-    await scanDir(adrDirPath, "");
-    return results.sort();
-}
-export function adrFileMatchesId(fileName, targetId) {
-    return path.basename(fileName).toLowerCase().startsWith(targetId.toLowerCase());
-}
-export async function readAndParseAdr(adrDirPath, fileName) {
-    try {
-        const filePath = path.join(adrDirPath, fileName);
-        const content = await fs.readFile(filePath, "utf-8");
-        return { fileName, parsed: parseAdrFile(content) };
-    }
-    catch {
-        return undefined;
-    }
-}
-//# sourceMappingURL=frontmatter-io.js.map

package/dist/os/adr/frontmatter-io.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"frontmatter-io.js","sourceRoot":"","sources":["../../../os/adr/frontmatter-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AAEF,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAOxB,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO;QACL,WAAW,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAA4B;QACrE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB;IACnD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,cAAsB;QAC5D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrF,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;gBAC9D,CAAC;qBAAM,IACL,KAAK,CAAC,MAAM,EAAE;oBACd,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAC1B,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;oBAClC,KAAK,CAAC,IAAI,KAAK,WAAW,EAC1B,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAgB;IACjE,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/os/adr/handlers/archive.d.ts

@@ -1,24 +0,0 @@
-import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
-export declare const ADR_TERMINAL_STATUSES: readonly ["implemented", "rejected", "superseded"];
-export interface ArchiveMove {
-    id: string;
-    file: string;
-    status: string;
-    from: string;
-    to: string;
-    direction: "into-archive" | "out-of-archive";
-}
-export interface ArchiveSkip {
-    id: string;
-    file: string;
-    reason: string;
-}
-export interface AdrArchiveResult {
-    command: "adr.archive";
-    status: "ok";
-    moved: ArchiveMove[];
-    skipped: ArchiveSkip[];
-    dryRun: boolean;
-}
-export declare function runAdrArchive(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<AdrArchiveResult>>;
-//# sourceMappingURL=archive.d.ts.map

package/dist/os/adr/handlers/archive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../os/adr/handlers/archive.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,qBAAqB,oDAAqD,CAAC;AAExF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,cAAc,GAAG,gBAAgB,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAyL/C"}

package/dist/os/adr/handlers/archive.js

@@ -1,194 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>
-ADR archive handler — moves terminal-status ADR files into status-specific
-subdirectories under docs/adrs/archive/ and moves non-terminal files found
-in subdirectories back to the root.
-</purpose>
-<non-goals>
-  <item>Does not validate ADR content — use adr.validate for that.</item>
-  <item>Does not change ADR frontmatter — only moves files on disk.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0367: implement adr.archive command for terminal-status file archiving.</item>
-  <item>RFC-0521: migrated from packages/os/site-kernel/src/adr/ to packages/forge/os/adr/.</item>
-  <item>RFC-0733: add pinned-files pre-check — skip pinned files with warning instead of moving them.</item>
-</CHANGE_SUMMARY>
-*/
-import fs from "node:fs/promises";
-import path from "node:path";
-import { listAdrFiles, readAndParseAdr } from "../frontmatter-io.js";
-import { ADR_DIR } from "../types.js";
-import { loadPinnedManifest, isPinned, isIntraDirMove } from "../../core/handlers/pinned-check.js";
-export const ADR_TERMINAL_STATUSES = ["implemented", "rejected", "superseded"];
-export async function runAdrArchive(input, context) {
-    const { workspaceRoot, logger, outputFormat } = context;
-    const adrDirPath = path.join(workspaceRoot, ADR_DIR);
-    const dryRun = context.dryRun || input.flags["dry-run"] === true;
-    const statusFilter = input.flags["status"];
-    if (statusFilter && !ADR_TERMINAL_STATUSES.includes(statusFilter)) {
-        throw new Error(`Invalid --status "${statusFilter}". Must be one of: ${ADR_TERMINAL_STATUSES.join(", ")}`);
-    }
-    const files = await listAdrFiles(adrDirPath);
-    const moved = [];
-    const skipped = [];
-    // RFC-0733: Load pinned manifest once per invocation
-    let pinnedManifest = null;
-    try {
-        pinnedManifest = await loadPinnedManifest(workspaceRoot);
-    }
-    catch {
-        // Malformed manifest — skip pre-check
-    }
-    for (const fileName of files) {
-        const result = await readAndParseAdr(adrDirPath, fileName);
-        if (!result) {
-            skipped.push({
-                id: "UNKNOWN",
-                file: path.join(ADR_DIR, fileName),
-                reason: "unreadable frontmatter",
-            });
-            continue;
-        }
-        const fm = result.parsed.frontmatter;
-        const id = String(fm["id"] ?? "UNKNOWN");
-        const status = String(fm["status"] ?? "").trim();
-        const isTerminal = status === "implemented" || status === "rejected" || status === "superseded";
-        const isInArchive = fileName.includes("/");
-        const relFile = path.join(ADR_DIR, fileName);
-        const basename = path.basename(fileName);
-        if (statusFilter && status !== statusFilter) {
-            skipped.push({
-                id,
-                file: relFile,
-                reason: `status ${status} does not match --status ${statusFilter}`,
-            });
-            continue;
-        }
-        if (isTerminal && !isInArchive) {
-            const targetDir = path.join(adrDirPath, "archive", status);
-            const targetPath = path.join(targetDir, basename);
-            const targetRel = path.join(ADR_DIR, "archive", status, basename);
-            // RFC-0733: Check if file is pinned before moving
-            // Gap fix: exempt intra-directory moves (file stays within the same pinned dir)
-            if (pinnedManifest &&
-                isPinned(pinnedManifest, relFile) &&
-                !isIntraDirMove(pinnedManifest, relFile, targetRel)) {
-                skipped.push({ id, file: relFile, reason: "pinned (protected by .forge/pinned.yaml)" });
-                if (outputFormat === "pretty") {
-                    logger.warn(`  pinned: skipping ${relFile} (protected)`);
-                }
-                continue;
-            }
-            try {
-                await fs.access(targetPath);
-                skipped.push({ id, file: relFile, reason: "destination exists" });
-                continue;
-            }
-            catch {
-                // destination doesn't exist — proceed
-            }
-            if (!dryRun) {
-                await fs.mkdir(targetDir, { recursive: true });
-                try {
-                    await fs.rename(path.join(adrDirPath, fileName), targetPath);
-                }
-                catch (err) {
-                    if (err.code === "ENOENT") {
-                        skipped.push({ id, file: relFile, reason: "already moved by another process" });
-                        continue;
-                    }
-                    throw err;
-                }
-            }
-            moved.push({
-                id,
-                file: targetRel,
-                status,
-                from: relFile,
-                to: targetRel,
-                direction: "into-archive",
-            });
-        }
-        else if (!isTerminal && isInArchive) {
-            const targetPath = path.join(adrDirPath, basename);
-            const targetRel = path.join(ADR_DIR, basename);
-            // RFC-0733: Check if file is pinned before moving
-            // Gap fix: exempt intra-directory moves (file stays within the same pinned dir)
-            if (pinnedManifest &&
-                isPinned(pinnedManifest, relFile) &&
-                !isIntraDirMove(pinnedManifest, relFile, targetRel)) {
-                skipped.push({ id, file: relFile, reason: "pinned (protected by .forge/pinned.yaml)" });
-                if (outputFormat === "pretty") {
-                    logger.warn(`  pinned: skipping ${relFile} (protected)`);
-                }
-                continue;
-            }
-            try {
-                await fs.access(targetPath);
-                skipped.push({ id, file: relFile, reason: "destination exists" });
-                continue;
-            }
-            catch {
-                // destination doesn't exist — proceed
-            }
-            if (!dryRun) {
-                try {
-                    await fs.rename(path.join(adrDirPath, fileName), targetPath);
-                }
-                catch (err) {
-                    if (err.code === "ENOENT") {
-                        skipped.push({ id, file: relFile, reason: "already moved by another process" });
-                        continue;
-                    }
-                    throw err;
-                }
-            }
-            moved.push({
-                id,
-                file: targetRel,
-                status,
-                from: relFile,
-                to: targetRel,
-                direction: "out-of-archive",
-            });
-        }
-        else if (isTerminal && isInArchive) {
-            skipped.push({ id, file: relFile, reason: `already archived (${status})` });
-        }
-        else {
-            skipped.push({ id, file: relFile, reason: `status ${status} is non-terminal` });
-        }
-    }
-    if (outputFormat === "pretty") {
-        if (dryRun) {
-            logger.info(`[dry-run] adr.archive: would move ${moved.length} file(s), skip ${skipped.length}`);
-        }
-        else {
-            logger.success(`adr.archive: moved ${moved.length} file(s), skipped ${skipped.length}`);
-        }
-        for (const m of moved) {
-            logger.info(`  ${m.direction}: ${m.id} (${m.status}) ${m.from} → ${m.to}`);
-        }
-    }
-    return {
-        data: {
-            command: "adr.archive",
-            status: "ok",
-            moved,
-            skipped,
-            dryRun,
-        },
-        summary: dryRun
-            ? `[dry-run] Would move ${moved.length} file(s), skip ${skipped.length}`
-            : `Moved ${moved.length} file(s), skipped ${skipped.length}`,
-        nextSteps: [
-            {
-                action: "Run: pnpm exec werkstatt run adr.list --json to verify archive status",
-                kind: "optional",
-            },
-        ],
-    };
-}
-//# sourceMappingURL=archive.js.map

package/dist/os/adr/handlers/archive.js.map

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

package/dist/os/adr/handlers/implement-stamp.d.ts

@@ -1,4 +0,0 @@
-import type { AdrImplementStampResult } from "../types.ts";
-import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
-export declare function runAdrImplementStamp(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<AdrImplementStampResult>>;
-//# sourceMappingURL=implement-stamp.d.ts.map

package/dist/os/adr/handlers/implement-stamp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"implement-stamp.d.ts","sourceRoot":"","sources":["../../../../os/adr/handlers/implement-stamp.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAyC,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AA0H/B,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CA6JtD"}