@warpgogol/forge 2.1.0 → 2.3.0

package/dist/os/werkstatt/handlers/lock.js

@@ -0,0 +1,153 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Werkstatt lock helpers. Moved from @warpgogol/site-kernel-handoff to
+@warpgogol/forge for full autonomous mode (RFC-0556). Provides acquire, release,
+heartbeat, status, and stale-lock removal.</purpose>
+<non-goals>
+  <item>Do not implement distributed locks — local process-level only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0362: initial lock helpers (acquire, release, heartbeat, status).</item>
+  <item>RFC-0556: moved from @warpgogol/site-kernel-handoff to @warpgogol/forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { werkstattLockSchema } from "./schema.js";
+const LOCKS_DIR = path.join(".werkstatt", "locks");
+const DEFAULT_TIMEOUT_SECONDS = 900;
+function resolveLocksDir(workspaceRoot) {
+    return path.join(workspaceRoot, LOCKS_DIR);
+}
+function resolveLockPath(workspaceRoot, scope) {
+    const safeScope = scope.replace(/[^a-zA-Z0-9:_-]/g, "_");
+    return path.join(resolveLocksDir(workspaceRoot), `${safeScope}.lock.json`);
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isLockStale(lock, now = new Date()) {
+    if (!isProcessAlive(lock.pid))
+        return true;
+    const heartbeatAge = (now.getTime() - new Date(lock.heartbeatAt).getTime()) / 1000;
+    return heartbeatAge >= lock.timeoutSeconds;
+}
+export async function acquireLock(workspaceRoot, scope, operationId, command, owner, timeoutSeconds = DEFAULT_TIMEOUT_SECONDS) {
+    const lockPath = resolveLockPath(workspaceRoot, scope);
+    const locksDir = resolveLocksDir(workspaceRoot);
+    if (!existsSync(locksDir)) {
+        await fs.mkdir(locksDir, { recursive: true });
+    }
+    if (existsSync(lockPath)) {
+        const raw = await fs.readFile(lockPath, "utf8");
+        try {
+            const existing = werkstattLockSchema.parse(JSON.parse(raw));
+            if (existing.pid === process.pid && !isLockStale(existing)) {
+                const updated = {
+                    ...existing,
+                    depth: (existing.depth ?? 1) + 1,
+                    heartbeatAt: new Date().toISOString(),
+                };
+                werkstattLockSchema.parse(updated);
+                await fs.writeFile(lockPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+                return updated;
+            }
+            if (!isLockStale(existing)) {
+                throw new Error(`[werkstatt.lock] lock '${scope}' held by operation '${existing.operationId}' (pid: ${existing.pid})`);
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes("held by"))
+                throw err;
+        }
+    }
+    const now = new Date().toISOString();
+    const lock = {
+        schemaVersion: "1.0.0",
+        scope,
+        operationId,
+        command,
+        owner,
+        pid: process.pid,
+        startedAt: now,
+        heartbeatAt: now,
+        timeoutSeconds,
+    };
+    werkstattLockSchema.parse(lock);
+    await fs.writeFile(lockPath, JSON.stringify(lock, null, 2) + "\n", "utf8");
+    return lock;
+}
+export async function releaseLock(workspaceRoot, scope) {
+    const lockPath = resolveLockPath(workspaceRoot, scope);
+    if (!existsSync(lockPath))
+        return;
+    try {
+        const raw = await fs.readFile(lockPath, "utf8");
+        const lock = werkstattLockSchema.parse(JSON.parse(raw));
+        if (lock.pid === process.pid && (lock.depth ?? 1) > 1) {
+            const decremented = { ...lock, depth: (lock.depth ?? 1) - 1 };
+            werkstattLockSchema.parse(decremented);
+            await fs.writeFile(lockPath, JSON.stringify(decremented, null, 2) + "\n", "utf8");
+            return;
+        }
+        await fs.unlink(lockPath);
+    }
+    catch {
+        // corrupt or missing — try direct delete
+        try {
+            await fs.unlink(lockPath);
+        }
+        catch {
+            /* already gone */
+        }
+    }
+}
+export async function heartbeatLock(workspaceRoot, scope) {
+    const lockPath = resolveLockPath(workspaceRoot, scope);
+    if (!existsSync(lockPath))
+        return;
+    const raw = await fs.readFile(lockPath, "utf8");
+    const lock = werkstattLockSchema.parse(JSON.parse(raw));
+    lock.heartbeatAt = new Date().toISOString();
+    await fs.writeFile(lockPath, JSON.stringify(lock, null, 2) + "\n", "utf8");
+}
+export async function readAllLocks(workspaceRoot) {
+    const locksDir = resolveLocksDir(workspaceRoot);
+    if (!existsSync(locksDir))
+        return [];
+    const files = await fs.readdir(locksDir);
+    const locks = [];
+    for (const file of files) {
+        if (!file.endsWith(".lock.json"))
+            continue;
+        const raw = await fs.readFile(path.join(locksDir, file), "utf8");
+        try {
+            const lock = werkstattLockSchema.parse(JSON.parse(raw));
+            locks.push({ ...lock, stale: isLockStale(lock) });
+        }
+        catch {
+            // skip corrupt lock files
+        }
+    }
+    return locks;
+}
+export async function removeStaleLock(workspaceRoot, scope) {
+    const lockPath = resolveLockPath(workspaceRoot, scope);
+    if (!existsSync(lockPath))
+        return false;
+    const raw = await fs.readFile(lockPath, "utf8");
+    const lock = werkstattLockSchema.parse(JSON.parse(raw));
+    if (!isLockStale(lock))
+        return false;
+    await fs.unlink(lockPath);
+    return true;
+}
+//# sourceMappingURL=lock.js.map

package/dist/os/werkstatt/handlers/lock.js.map

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

package/dist/os/werkstatt/handlers/schema.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const werkstattLockSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    scope: z.ZodString;
+    operationId: z.ZodString;
+    command: z.ZodString;
+    owner: z.ZodString;
+    pid: z.ZodNumber;
+    startedAt: z.ZodString;
+    heartbeatAt: z.ZodString;
+    timeoutSeconds: z.ZodNumber;
+    depth: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const werkstattOperationRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    operationId: z.ZodString;
+    command: z.ZodString;
+    scopes: z.ZodArray<z.ZodString>;
+    state: z.ZodEnum<{
+        failed: "failed";
+        started: "started";
+        completed: "completed";
+    }>;
+    startedAt: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodString>;
+    inputHash: z.ZodString;
+    resultHash: z.ZodNullable<z.ZodString>;
+    artifacts: z.ZodArray<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type WerkstattLock = z.infer<typeof werkstattLockSchema>;
+export type WerkstattOperationRecord = z.infer<typeof werkstattOperationRecordSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/os/werkstatt/handlers/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../os/werkstatt/handlers/schema.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAW9B,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;iBAYzC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/os/werkstatt/handlers/schema.js

@@ -0,0 +1,42 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Werkstatt Zod schemas inlined from @warpgogol/werkstatt-shared/ontology/operations for
+full autonomous mode (RFC-0556). Provides werkstattLockSchema and
+werkstattOperationRecordSchema without a dependency on @warpgogol/ontology.</purpose>
+<non-goals>
+  <item>Do not perform file IO — pure shape only.</item>
+  <item>Do not define hash-chain Bordbuch format — that is RFC-0276/RFC-0355.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0362: initial Werkstatt schemas (WerkstattLock, WerkstattOperationRecord).</item>
+  <item>RFC-0556: inlined from @warpgogol/werkstatt-shared/ontology/operations into forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import { z } from "zod";
+export const werkstattLockSchema = z.object({
+    schemaVersion: z.literal("1.0.0"),
+    scope: z.string().min(1),
+    operationId: z.string().min(1),
+    command: z.string().min(1),
+    owner: z.string().min(1),
+    pid: z.number().int(),
+    startedAt: z.string().datetime(),
+    heartbeatAt: z.string().datetime(),
+    timeoutSeconds: z.number().positive(),
+    depth: z.number().int().positive().optional(),
+});
+export const werkstattOperationRecordSchema = z.object({
+    schemaVersion: z.literal("1.0.0"),
+    operationId: z.string().min(1),
+    command: z.string().min(1),
+    scopes: z.array(z.string().min(1)),
+    state: z.enum(["started", "completed", "failed"]),
+    startedAt: z.string().datetime(),
+    completedAt: z.string().datetime().nullable(),
+    inputHash: z.string().min(1),
+    resultHash: z.string().nullable(),
+    artifacts: z.array(z.string()),
+    error: z.string().nullable(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/os/werkstatt/handlers/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../os/werkstatt/handlers/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AAEF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/dist/os/werkstatt/handlers/werkstatt-lock-recover.d.ts

@@ -0,0 +1,15 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export interface WerkstattLockRecoverData {
+    recovered: Array<{
+        scope?: string;
+        artifact?: string;
+        action: string;
+    }>;
+    failed: Array<{
+        scope?: string;
+        artifact?: string;
+        error: string;
+    }>;
+}
+export declare function runWerkstattLockRecover(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<WerkstattLockRecoverData>>;
+//# sourceMappingURL=werkstatt-lock-recover.d.ts.map

package/dist/os/werkstatt/handlers/werkstatt-lock-recover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"werkstatt-lock-recover.d.ts","sourceRoot":"","sources":["../../../../os/werkstatt/handlers/werkstatt-lock-recover.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAgFD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,CAAC,CA6DvD"}

package/dist/os/werkstatt/handlers/werkstatt-lock-recover.js

@@ -0,0 +1,144 @@
+/*
+<MODULE_CONTRACT>
+<purpose>werkstatt.lock.recover command handler. Moved from
+@warpgogol/site-kernel-handoff to @warpgogol/forge for full autonomous mode (RFC-0556).
+Classifies and cleans stale locks and staging artifacts (RFC-0362 §8).</purpose>
+<non-goals>
+  <item>Do not introduce app-specific runtime composition or deployment behavior.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0362: initial lock.recover command handler.</item>
+  <item>RFC-0556: moved from @warpgogol/site-kernel-handoff to @warpgogol/forge for autonomous mode.</item>
+  <item>Replace fs.unlink/fs.rm with trashPath for artifact cleanup (trash bin for LLM-initiated deletions).</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { trashPath } from "../../../src/utils/fs-trash.js";
+import { readAllLocks, removeStaleLock, acquireLock, releaseLock } from "./lock.js";
+function flagString(input, key) {
+    const v = input.flags[key];
+    return typeof v === "string" ? v : undefined;
+}
+async function classifyArtifacts(workspaceRoot, purge) {
+    const recovered = [];
+    const failed = [];
+    const scanRoots = ["systems", "missions", "releases"];
+    for (const root of scanRoots) {
+        const rootPath = path.join(workspaceRoot, root);
+        if (!existsSync(rootPath))
+            continue;
+        let entries;
+        try {
+            entries = await fs.readdir(rootPath);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const entryPath = path.join(rootPath, entry);
+            const relPath = path.relative(workspaceRoot, entryPath).replace(/\\/g, "/");
+            if (entry.endsWith(".tmp")) {
+                if (purge) {
+                    try {
+                        await trashPath(entryPath);
+                        recovered.push({ artifact: relPath, action: "trashed-tmp" });
+                    }
+                    catch (err) {
+                        failed.push({ artifact: relPath, error: err.message });
+                    }
+                }
+                else {
+                    recovered.push({ artifact: relPath, action: "classified-tmp (use --purge to remove)" });
+                }
+            }
+            else if (entry.includes(".staging-")) {
+                if (purge) {
+                    try {
+                        await trashPath(entryPath);
+                        recovered.push({ artifact: relPath, action: "trashed-staging" });
+                    }
+                    catch (err) {
+                        failed.push({ artifact: relPath, error: err.message });
+                    }
+                }
+                else {
+                    recovered.push({
+                        artifact: relPath,
+                        action: "classified-staging (use --purge to remove)",
+                    });
+                }
+            }
+            else if (entry.includes(".incomplete")) {
+                if (purge) {
+                    const failedDir = entryPath.replace(".incomplete", `.failed-${Date.now()}`);
+                    try {
+                        await fs.rename(entryPath, failedDir);
+                        recovered.push({ artifact: relPath, action: "renamed-to-failed" });
+                    }
+                    catch (err) {
+                        failed.push({ artifact: relPath, error: err.message });
+                    }
+                }
+                else {
+                    recovered.push({
+                        artifact: relPath,
+                        action: "classified-incomplete (use --purge to rename)",
+                    });
+                }
+            }
+        }
+    }
+    return { recovered, failed };
+}
+export async function runWerkstattLockRecover(input, context) {
+    const { workspaceRoot, logger } = context;
+    const scopeFilter = flagString(input, "scope");
+    const purge = input.flags["purge"] === true;
+    const metaOperationId = `recover-${Date.now()}`;
+    try {
+        await acquireLock(workspaceRoot, "werkstatt-recovery", metaOperationId, "werkstatt.lock.recover", "system");
+    }
+    catch {
+        throw new Error("[werkstatt.lock.recover] another recovery operation is in progress");
+    }
+    try {
+        const locks = await readAllLocks(workspaceRoot);
+        const staleLocks = locks.filter((l) => l.stale && (!scopeFilter || l.scope === scopeFilter));
+        const recovered = [];
+        const failed = [];
+        for (const lock of staleLocks) {
+            try {
+                await removeStaleLock(workspaceRoot, lock.scope);
+                recovered.push({ scope: lock.scope, action: "removed-stale-lock" });
+                logger.info(`  [removed] lock '${lock.scope}'`);
+            }
+            catch (err) {
+                failed.push({ scope: lock.scope, error: err.message });
+            }
+        }
+        const { recovered: artifactRecovered, failed: artifactFailed } = await classifyArtifacts(workspaceRoot, purge);
+        for (const r of artifactRecovered) {
+            recovered.push({ artifact: r.artifact, action: r.action });
+        }
+        for (const f of artifactFailed) {
+            failed.push({ artifact: f.artifact, error: f.error });
+        }
+        if (recovered.length === 0 && failed.length === 0) {
+            logger.success("[werkstatt.lock.recover] no stale locks or artifacts found");
+        }
+        else {
+            logger.success(`[werkstatt.lock.recover] ${recovered.length} recovered, ${failed.length} failed`);
+        }
+        return {
+            data: { recovered, failed },
+            summary: `[werkstatt.lock.recover] ${recovered.length} artifact${recovered.length === 1 ? "" : "s"} recovered, ${failed.length} failure${failed.length === 1 ? "" : "s"}`,
+        };
+    }
+    finally {
+        await releaseLock(workspaceRoot, "werkstatt-recovery");
+    }
+}
+//# sourceMappingURL=werkstatt-lock-recover.js.map

package/dist/os/werkstatt/handlers/werkstatt-lock-recover.js.map

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

package/dist/os/werkstatt/handlers/werkstatt-lock-status.d.ts

@@ -0,0 +1,18 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export interface WerkstattLockStatusData {
+    locks: Array<{
+        scope: string;
+        operationId: string;
+        command: string;
+        owner: string;
+        pid: number;
+        startedAt: string;
+        heartbeatAt: string;
+        timeoutSeconds: number;
+        stale: boolean;
+    }>;
+    count: number;
+    staleCount: number;
+}
+export declare function runWerkstattLockStatus(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<WerkstattLockStatusData>>;
+//# sourceMappingURL=werkstatt-lock-status.d.ts.map

package/dist/os/werkstatt/handlers/werkstatt-lock-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"werkstatt-lock-status.d.ts","sourceRoot":"","sources":["../../../../os/werkstatt/handlers/werkstatt-lock-status.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,KAAK,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CA+BtD"}

package/dist/os/werkstatt/handlers/werkstatt-lock-status.js

@@ -0,0 +1,43 @@
+/*
+<MODULE_CONTRACT>
+<purpose>werkstatt.lock.status command handler. Moved from
+@warpgogol/site-kernel-handoff to @warpgogol/forge for full autonomous mode (RFC-0556).
+Reports all Werkstatt locks, their age, owner, and staleness (RFC-0362).</purpose>
+<non-goals>
+  <item>Do not introduce app-specific runtime composition or deployment behavior.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0362: initial lock.status command handler.</item>
+  <item>RFC-0556: moved from @warpgogol/site-kernel-handoff to @warpgogol/forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import { readAllLocks } from "./lock.js";
+export async function runWerkstattLockStatus(_input, context) {
+    const { workspaceRoot, logger } = context;
+    const locks = await readAllLocks(workspaceRoot);
+    const staleCount = locks.filter((l) => l.stale).length;
+    for (const lock of locks) {
+        const status = lock.stale ? "STALE" : "active";
+        logger.info(`  ${lock.scope.padEnd(32)} ${status.padEnd(6)} pid:${lock.pid} op:${lock.operationId}`);
+    }
+    return {
+        data: {
+            locks: locks.map((l) => ({
+                scope: l.scope,
+                operationId: l.operationId,
+                command: l.command,
+                owner: l.owner,
+                pid: l.pid,
+                startedAt: l.startedAt,
+                heartbeatAt: l.heartbeatAt,
+                timeoutSeconds: l.timeoutSeconds,
+                stale: l.stale,
+            })),
+            count: locks.length,
+            staleCount,
+        },
+        summary: `[werkstatt.lock.status] ${locks.length} lock${locks.length === 1 ? "" : "s"}, ${staleCount} stale`,
+    };
+}
+//# sourceMappingURL=werkstatt-lock-status.js.map

package/dist/os/werkstatt/handlers/werkstatt-lock-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"werkstatt-lock-status.js","sourceRoot":"","sources":["../../../../os/werkstatt/handlers/werkstatt-lock-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAOF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAkBzC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAyB,EACzB,OAA4B;IAE5B,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,CAAC;IAEhD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAEvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/C,MAAM,CAAC,IAAI,CACT,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,WAAW,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,cAAc,EAAE,CAAC,CAAC,cAAc;gBAChC,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC;YACH,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,UAAU;SACX;QACD,OAAO,EAAE,2BAA2B,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,QAAQ;KAC7G,CAAC;AACJ,CAAC"}

package/dist/os/werkstatt/handlers/werkstatt-operation-validate.d.ts

@@ -0,0 +1,11 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export interface WerkstattOperationValidateData {
+    scannedFiles: number;
+    violations: Array<{
+        file: string;
+        line: number;
+        pattern: string;
+    }>;
+}
+export declare function runWerkstattOperationValidate(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<WerkstattOperationValidateData>>;
+//# sourceMappingURL=werkstatt-operation-validate.d.ts.map

package/dist/os/werkstatt/handlers/werkstatt-operation-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"werkstatt-operation-validate.d.ts","sourceRoot":"","sources":["../../../../os/werkstatt/handlers/werkstatt-operation-validate.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAY/B,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,8BAA8B,CAAC,CAAC,CA2D7D"}

package/dist/os/werkstatt/handlers/werkstatt-operation-validate.js

@@ -0,0 +1,79 @@
+/*
+<MODULE_CONTRACT>
+<purpose>werkstatt.operation.validate command handler. Moved from
+@warpgogol/site-kernel-checks to @warpgogol/forge for full autonomous mode (RFC-0556).
+Scans command source files for direct shared-state writes outside the allowlisted
+helper module (RFC-0362 §6).</purpose>
+<non-goals>
+  <item>Does not load command implementations — reads source files with regex only.</item>
+  <item>Does not scan files outside packages/os/site-kernel-handoff/src/.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0362: initial operation.validate command handler.</item>
+  <item>RFC-0556: moved from @warpgogol/site-kernel-checks to @warpgogol/forge for autonomous mode. Uses node:fs/promises directly instead of context.io.</item>
+</CHANGE_SUMMARY>
+*/
+import { basename, join, relative } from "node:path";
+import { readFile } from "node:fs/promises";
+import { collectFiles } from "../../../src/utils/fs.js";
+const SCAN_DIR = "packages/os/site-kernel-handoff/src";
+const ALLOWLIST_DIR = "packages/os/site-kernel-handoff/src/werkstatt";
+const DIRECT_WRITE_PATTERNS = [
+    { regex: /\bwriteFile\s*\(/g, label: "writeFile" },
+    { regex: /\bappendFile\s*\(/g, label: "appendFile" },
+    { regex: /\brename\s*\(/g, label: "rename" },
+    { regex: /\bcp\s*\(/g, label: "cp" },
+];
+export async function runWerkstattOperationValidate(_input, context) {
+    const { workspaceRoot, logger } = context;
+    const scanPath = join(workspaceRoot, SCAN_DIR);
+    const allowlistPath = join(workspaceRoot, ALLOWLIST_DIR);
+    const files = await collectFiles(scanPath, {
+        ignore: (name) => name.startsWith(".") || name === "node_modules" || name === "dist" || name === "tests",
+    });
+    const violations = [];
+    const PRE_EXISTING_ALLOWLIST = new Set(["handoff-pack.ts", "materialize.ts", "bundle-io.ts"]);
+    for (const filePath of files) {
+        if (filePath.startsWith(allowlistPath) || filePath.includes("werkstatt"))
+            continue;
+        const fileName = basename(filePath);
+        if (fileName.endsWith(".test.ts") || fileName.endsWith(".spec.ts"))
+            continue;
+        if (PRE_EXISTING_ALLOWLIST.has(fileName))
+            continue;
+        const relPath = relative(workspaceRoot, filePath).replace(/\\/g, "/");
+        let content;
+        try {
+            content = await readFile(filePath, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const trimmed = line.trim();
+            if (trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*"))
+                continue;
+            for (const { regex, label } of DIRECT_WRITE_PATTERNS) {
+                const testRegex = new RegExp(regex.source, regex.flags);
+                if (testRegex.test(line)) {
+                    violations.push({ file: relPath, line: i + 1, pattern: label });
+                    logger.error(`${relPath}:${i + 1}: direct ${label} — use the shared atomic-write helper in packages/os/site-kernel-handoff/src/werkstatt/`);
+                }
+            }
+        }
+    }
+    return {
+        data: {
+            scannedFiles: files.length,
+            violations,
+        },
+        exitCode: violations.length > 0 ? 1 : 0,
+        summary: violations.length > 0
+            ? undefined
+            : `[werkstatt.operation.validate] ${files.length} files scanned, 0 violations`,
+    };
+}
+//# sourceMappingURL=werkstatt-operation-validate.js.map

package/dist/os/werkstatt/handlers/werkstatt-operation-validate.js.map

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

package/dist/os/werkstatt/index.d.ts

@@ -0,0 +1,7 @@
+export { forgeWerkstattModule } from "./werkstatt.module.ts";
+export { werkstattLockSchema, werkstattOperationRecordSchema, type WerkstattLock, type WerkstattOperationRecord, } from "./handlers/schema.ts";
+export { acquireLock, releaseLock, heartbeatLock, readAllLocks, isLockStale, removeStaleLock, } from "./handlers/lock.ts";
+export { runWerkstattLockStatus, type WerkstattLockStatusData, } from "./handlers/werkstatt-lock-status.ts";
+export { runWerkstattLockRecover, type WerkstattLockRecoverData, } from "./handlers/werkstatt-lock-recover.ts";
+export { runWerkstattOperationValidate, type WerkstattOperationValidateData, } from "./handlers/werkstatt-operation-validate.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/os/werkstatt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/werkstatt/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,KAAK,aAAa,EAClB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,6BAA6B,EAC7B,KAAK,8BAA8B,GACpC,MAAM,4CAA4C,CAAC"}

package/dist/os/werkstatt/index.js

@@ -0,0 +1,18 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Expose forge Werkstatt kernel commands through a stable package subpath.</purpose>
+<non-goals>
+  <item>Do not implement werkstatt handler logic.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial werkstatt module barrel.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeWerkstattModule } from "./werkstatt.module.js";
+export { werkstattLockSchema, werkstattOperationRecordSchema, } from "./handlers/schema.js";
+export { acquireLock, releaseLock, heartbeatLock, readAllLocks, isLockStale, removeStaleLock, } from "./handlers/lock.js";
+export { runWerkstattLockStatus, } from "./handlers/werkstatt-lock-status.js";
+export { runWerkstattLockRecover, } from "./handlers/werkstatt-lock-recover.js";
+export { runWerkstattOperationValidate, } from "./handlers/werkstatt-operation-validate.js";
+//# sourceMappingURL=index.js.map

package/dist/os/werkstatt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/werkstatt/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,mBAAmB,EACnB,8BAA8B,GAG/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,GAEvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,uBAAuB,GAExB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,6BAA6B,GAE9B,MAAM,4CAA4C,CAAC"}