@warpgogol/forge 2.1.0 → 2.2.0

package/dist/bin/cli.js

@@ -0,0 +1,292 @@
+#!/usr/bin/env node
+/*
+<MODULE_CONTRACT>
+<purpose>CLI bin entrypoint for @warpgogol/forge — minimal command runner that
+registers forge modules and dispatches commands. Works autonomously without
+@warpgogol/werkstatt.</purpose>
+<non-goals>
+  <item>Do not implement command logic — delegate to forge os/ modules and src/ handlers.</item>
+  <item>Do not replicate the full kernel runtime — minimal dispatch only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial CLI bin entrypoint for forge autonomy refactor.</item>
+  <item>RFC-0542: self-documenting output contract — renderNextSteps, renderIdeRecommendation, generateHelp, --help <command> flag.</item>
+  <item>RFC-0543: source VERSION from package.json at runtime instead of hardcoded constant.</item>
+</CHANGE_SUMMARY>
+*/
+import { resolve, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readFileSync } from "node:fs";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Logger
+// ---------------------------------------------------------------------------
+const logger = {
+    section(msg, details) {
+        console.log(`\n■ ${msg}`);
+        if (details)
+            console.log(details);
+    },
+    info(msg, details) {
+        console.log(`  ${msg}`);
+        if (details)
+            console.log(details);
+    },
+    warn(msg, details) {
+        console.warn(`  ⚠ ${msg}`);
+        if (details)
+            console.warn(details);
+    },
+    error(msg, details) {
+        console.error(`  ✖ ${msg}`);
+        if (details)
+            console.error(details);
+    },
+    success(msg, details) {
+        console.log(`  ✓ ${msg}`);
+        if (details)
+            console.log(details);
+    },
+};
+import { renderNextSteps, renderIdeRecommendation, generateHelp } from "../src/cli-output.js";
+class ForgeCliRegistry {
+    commands = new Map();
+    registerCommand(command) {
+        this.commands.set(command.name, command);
+    }
+    registerPipeline(_name, _steps) {
+        // CLI mode: pipelines not supported — no-op
+    }
+    listCommandNames() {
+        return [...this.commands.keys()].sort();
+    }
+    listCommands() {
+        return [...this.commands.values()].map((c) => ({
+            name: c.name,
+            description: c.description,
+            scope: c.scope,
+            provider: "workspace",
+            mutatesState: c.mutatesState,
+            requiresNetwork: c.requiresNetwork,
+            supportsAllSites: c.supportsAllSites,
+            timeoutMs: c.timeoutMs,
+            expectedDurationMs: c.expectedDurationMs,
+            longRunning: c.longRunning,
+            flags: c.flags,
+            reads: c.reads,
+            writes: c.writes,
+        }));
+    }
+    getCommand(name) {
+        return this.commands.get(name);
+    }
+}
+// ---------------------------------------------------------------------------
+// Flag parsing
+// ---------------------------------------------------------------------------
+function parseArgs(argv) {
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const eqIndex = arg.indexOf("=");
+            if (eqIndex > 0) {
+                const key = arg.slice(2, eqIndex);
+                const value = arg.slice(eqIndex + 1);
+                flags[key] = value;
+            }
+            else {
+                const key = arg.slice(2);
+                const next = argv[i + 1];
+                if (next && !next.startsWith("--")) {
+                    flags[key] = next;
+                    i++;
+                }
+                else {
+                    flags[key] = true;
+                }
+            }
+        }
+        else {
+            // RFC-0609: positional arguments are no longer collected; ignore them
+        }
+    }
+    return { flags };
+}
+// ---------------------------------------------------------------------------
+// Module registration
+// ---------------------------------------------------------------------------
+async function buildRegistry() {
+    const registry = new ForgeCliRegistry();
+    const modules = [
+        await import("../os/core/core.module.js").then((m) => m.forgeCoreModule),
+        await import("../os/rfc/rfc.module.js").then((m) => m.forgeRfcModule),
+        await import("../os/workflow/workflow.module.js").then((m) => m.forgeWorkflowModule),
+        await import("../os/naming/naming.module.js").then((m) => m.forgeNamingModule),
+        await import("../os/compass/compass.module.js").then((m) => m.forgeCompassModule),
+        await import("../os/werkstatt/werkstatt.module.js").then((m) => m.forgeWerkstattModule),
+        await import("../os/session/session.module.js").then((m) => m.forgeSessionModule),
+        await import("../os/exploration/exploration.module.js").then((m) => m.forgeExplorationModule),
+        await import("../os/notes/notes.module.js").then((m) => m.forgeNotesModule),
+    ].filter((m) => m !== null);
+    for (const mod of modules) {
+        await mod.register(registry);
+    }
+    return registry;
+}
+// ---------------------------------------------------------------------------
+// Output rendering (RFC-0542: self-documenting forge command output contract)
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Version — sourced from package.json at runtime (RFC-0543)
+// ---------------------------------------------------------------------------
+function readVersion() {
+    // Source: packages/forge/bin/cli.ts → packages/forge/package.json (one up)
+    // Compiled: dist/bin/cli.js → package.json (two up)
+    for (const up of ["..", "../.."]) {
+        const pkgPath = join(__dirname, up, "package.json");
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+            if (pkg.version)
+                return pkg.version;
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return "0.0.0-unknown";
+}
+const VERSION = readVersion();
+function resolveForgeRootFromCli() {
+    // Source: packages/forge/bin/cli.ts → packages/forge/ (one up)
+    // Compiled: dist/bin/cli.js → packages/forge/ (two up)
+    for (const up of ["..", "../.."]) {
+        const pkgPath = join(__dirname, up, "package.json");
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+            if (pkg.name === "@warpgogol/forge")
+                return join(__dirname, up);
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return undefined;
+}
+function printCommandHelp(registry, commandName) {
+    const resolved = resolveCommandName(commandName, registry);
+    const cmd = resolved ? registry.getCommand(resolved) : undefined;
+    if (!resolved || !cmd) {
+        logger.error(`Unknown command: ${commandName}`);
+        logger.info(`Run 'forge --help' for available commands.`);
+        process.exit(1);
+    }
+    const displayName = resolved.replace(/^forge\./, "");
+    console.log(`forge ${displayName}`);
+    console.log(`\n  ${cmd.description}`);
+    if (cmd.flags && Object.keys(cmd.flags).length > 0) {
+        console.log("\nFlags:");
+        for (const [flagName, flagSpec] of Object.entries(cmd.flags)) {
+            const required = flagSpec.required ? " (required)" : "";
+            console.log(`  --${flagName}${required}  ${flagSpec.description}`);
+        }
+    }
+    process.exit(0);
+}
+// ---------------------------------------------------------------------------
+// Command-name resolution (RFC-0699)
+// ---------------------------------------------------------------------------
+function resolveCommandName(commandName, registry) {
+    if (registry.getCommand(commandName)) {
+        if (commandName.startsWith("forge.")) {
+            const unqualified = commandName.slice("forge.".length);
+            logger.warn("'" + commandName + "' is deprecated; use '" + unqualified + "'");
+        }
+        return commandName;
+    }
+    if (!commandName.includes(".")) {
+        const qualified = "forge." + commandName;
+        if (registry.getCommand(qualified)) {
+            return qualified;
+        }
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    const argv = process.argv.slice(2);
+    if (argv.length === 0 || (argv[0] === "--help" && argv.length === 1) || argv[0] === "-h") {
+        const registry = await buildRegistry();
+        console.log(generateHelp(registry));
+        process.exit(0);
+    }
+    if (argv[0] === "--help" && argv.length >= 2) {
+        const registry = await buildRegistry();
+        printCommandHelp(registry, argv[1]);
+        return;
+    }
+    if (argv[0] === "--version" || argv[0] === "-v") {
+        console.log(`forge ${VERSION}`);
+        process.exit(0);
+    }
+    const commandName = argv[0];
+    const rest = argv.slice(1);
+    const { flags } = parseArgs(rest);
+    const registry = await buildRegistry();
+    const resolved = resolveCommandName(commandName, registry);
+    const command = resolved ? registry.getCommand(resolved) : undefined;
+    if (!command) {
+        logger.error(`Unknown command: ${commandName}`);
+        logger.info(`Run 'forge --help' for available commands.`);
+        process.exit(1);
+    }
+    const workspaceRoot = resolve(process.cwd());
+    const outputFormat = flags["json"] === true ? "json" : "pretty";
+    const dryRun = flags["dry-run"] === true;
+    const input = { argv: rest, flags };
+    const resolvedForgeRoot = resolveForgeRootFromCli();
+    if (outputFormat === "pretty" && commandName === "forge.create") {
+        logger.info(`forge root: ${resolvedForgeRoot ?? "(not resolved)"}`);
+    }
+    const context = {
+        workspaceRoot,
+        forgeRoot: resolvedForgeRoot,
+        logger,
+        dryRun,
+        outputFormat,
+        commandRegistry: registry,
+    };
+    try {
+        const result = (await command.execute(input, context));
+        if (result && outputFormat === "json") {
+            const output = { ...(result.data ?? {}), nextSteps: result.nextSteps ?? [] };
+            console.log(JSON.stringify(output, null, 2));
+        }
+        else if (result && outputFormat === "pretty") {
+            if (result.summary) {
+                console.log(result.summary);
+            }
+            const nextStepsText = renderNextSteps(result.nextSteps);
+            if (nextStepsText) {
+                console.log(nextStepsText);
+            }
+            if (commandName === "forge.create") {
+                console.log(renderIdeRecommendation());
+            }
+        }
+        const exitCode = result?.exitCode ?? 0;
+        process.exit(exitCode);
+    }
+    catch (error) {
+        logger.error(error instanceof Error ? error.message : String(error), error instanceof Error && error.stack ? error.stack : undefined);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    logger.error(error instanceof Error ? error.message : String(error), error instanceof Error && error.stack ? error.stack : undefined);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

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

package/dist/os/adr/adr.module.d.ts

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare const forgeAdrModule: ForgeModule;
+//# sourceMappingURL=adr.module.d.ts.map

package/dist/os/adr/adr.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.module.d.ts","sourceRoot":"","sources":["../../../os/adr/adr.module.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,cAAc,EAAE,WA6I5B,CAAC"}

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

@@ -0,0 +1,145 @@
+/*
+<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",
+    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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,67 @@
+/*
+<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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1 @@
+{"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"}