@warpgogol/forge 0.3.1

package/dist/os/werkstatt/werkstatt.module.js

@@ -0,0 +1,58 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register forge Werkstatt lock and operation validation commands with the kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement werkstatt handler logic — delegate to handlers/ inlined by RFC-0556.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial forgeWerkstattModule registering 3 werkstatt commands.</item>
+  <item>RFC-0556: removed dynamic imports of @warpgogol/site-kernel-handoff and @warpgogol/site-kernel-checks, all handlers now inlined in forge/os/werkstatt/handlers/.</item>
+</CHANGE_SUMMARY>
+*/
+import { runWerkstattLockStatus } from "./handlers/werkstatt-lock-status.js";
+import { runWerkstattLockRecover } from "./handlers/werkstatt-lock-recover.js";
+import { runWerkstattOperationValidate } from "./handlers/werkstatt-operation-validate.js";
+export const forgeWerkstattModule = {
+    name: "forge-werkstatt",
+    version: "0.1.0",
+    async register(registry) {
+        registry.registerCommand({
+            name: "werkstatt.lock.status",
+            description: "Report all Werkstatt locks, their age, owner, and staleness (RFC-0362).",
+            scope: "workspace",
+            supportsAllSites: false,
+            flags: {},
+            reads: [".werkstatt/locks/**"],
+            execute: runWerkstattLockStatus,
+        });
+        registry.registerCommand({
+            name: "werkstatt.lock.recover",
+            description: "Classify and clean stale locks and staging artifacts (RFC-0362). Flags: --scope, --purge.",
+            scope: "workspace",
+            supportsAllSites: false,
+            mutatesState: true,
+            flags: {
+                scope: { kind: "string", description: "Recover only a single lock scope." },
+                purge: {
+                    kind: "boolean",
+                    description: "Remove stale artifacts instead of classifying them.",
+                },
+            },
+            writes: [".werkstatt/locks/**", "systems/**", "missions/**", "releases/**"],
+            reads: [".werkstatt/locks/**"],
+            cacheable: false,
+            execute: runWerkstattLockRecover,
+        });
+        registry.registerCommand({
+            name: "werkstatt.operation.validate",
+            description: "Validate that mutating Werkstatt commands use shared lock/idempotency/atomic-write helpers (RFC-0362).",
+            scope: "workspace",
+            supportsAllSites: false,
+            flags: {},
+            reads: ["packages/os/site-kernel-handoff/src/**/*.ts"],
+            execute: runWerkstattOperationValidate,
+        });
+    },
+};
+//# sourceMappingURL=werkstatt.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"werkstatt.module.js","sourceRoot":"","sources":["../../../os/werkstatt/werkstatt.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAGF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,4CAA4C,CAAC;AAE3F,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,yEAAyE;YACtF,KAAK,EAAE,WAAW;YAClB,gBAAgB,EAAE,KAAK;YACvB,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,CAAC,qBAAqB,CAAC;YAC9B,OAAO,EAAE,sBAAsB;SAChC,CAAC,CAAC;QACH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EACT,2FAA2F;YAC7F,KAAK,EAAE,WAAW;YAClB,gBAAgB,EAAE,KAAK;YACvB,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;gBAC3E,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,qDAAqD;iBACnE;aACF;YACD,MAAM,EAAE,CAAC,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,CAAC;YAC3E,KAAK,EAAE,CAAC,qBAAqB,CAAC;YAC9B,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,uBAAuB;SACjC,CAAC,CAAC;QACH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,8BAA8B;YACpC,WAAW,EACT,wGAAwG;YAC1G,KAAK,EAAE,WAAW;YAClB,gBAAgB,EAAE,KAAK;YACvB,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,CAAC,6CAA6C,CAAC;YACtD,OAAO,EAAE,6BAA6B;SACvC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/os/workflow/handlers.d.ts

@@ -0,0 +1,12 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+import { type WorkflowLintResult, type WorkflowListEntry } from "./types.ts";
+export declare function runWorkflowList(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    command: "workflow.list";
+    workflows: WorkflowListEntry[];
+}>>;
+export declare function runWorkflowAmendList(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    command: "workflow-amend.list";
+    workflows: WorkflowListEntry[];
+}>>;
+export declare function runWorkflowLint(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<WorkflowLintResult>>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/os/workflow/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../os/workflow/handlers.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAKL,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAqKpB,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAAC,CAQ3F;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAAE,OAAO,EAAE,qBAAqB,CAAC;IAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAAC,CAQjG;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CA+EjD"}

package/dist/os/workflow/handlers.js

@@ -0,0 +1,254 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Workflow lint/list/amend handlers for forge — validates .agents/workflows frontmatter, command references, and per-chain phase links.</purpose>
+<non-goals>
+  <item>Do not execute workflow steps.</item>
+  <item>Do not edit workflow files to repair violations.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0075: Add agent workflow lint/list handlers.</item>
+  <item>RFC-0374: Migrated from packages/os/site-kernel/src/workflow/ to packages/forge/os/workflow/.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { WORKFLOW_PHASES, WORKFLOW_CHAINS, } from "./types.js";
+const WORKFLOW_DIR = ".agents/workflows";
+const WORKFLOW_AMEND_DIR = ".agents/workflows-amend";
+// RFC-0135/RFC-0136 commands (registered in site-kernel-onboarding / site-kernel-checks).
+const PENDING_AMEND_RFC_COMMANDS = new Set([
+    "amend.input.validate",
+    "amend.atoms.merge",
+    "amend.provenance.append",
+    "amend.provenance.validate",
+    "amend.phase.validate",
+    "content.coverage.delta",
+    "audit.delta.run",
+    "amend-check.author",
+    "amend-check.postbuild",
+    "amend-check.run",
+    "workflow-amend.list",
+]);
+const PENDING_ACCEPTED_RFC_COMMANDS = new Set([
+    "brief.validate",
+    "biome.tokens.derive",
+    "family.contract.validate",
+    "family.list",
+    "archetype.registry.validate",
+    "cosmic.name.pick",
+    "section.scaffold",
+    "section.contract.validate",
+    "section.similarity.report",
+    "system-md.compile",
+    "constellation.contract.validate",
+    "content.coverage.validate",
+    "content.voice.lint",
+    "pbp.content.validate",
+    "content.references.validate",
+    "audit.agent.readiness.validate",
+    "seo.technical.validate",
+    "seo.structured-data.validate",
+    "seo.internal-linking.validate",
+    "analytics.config.validate",
+    "first-party-data.validate",
+    "infra.brief.validate",
+    "audit.llm.run",
+    "app.qa.validate",
+    "kernel.wire",
+    "onboarding.scaffold",
+    "onboarding.input.validate",
+    "onboarding.phase.validate",
+    "biome.contract.validate",
+    "biome.css.generate",
+]);
+async function pathExists(target) {
+    try {
+        await fs.access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readWorkflowFiles(workspaceRoot, dir) {
+    const directory = path.join(workspaceRoot, dir);
+    const entries = await fs.readdir(directory, { withFileTypes: true }).catch(() => []);
+    return entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".md") && entry.name !== "README.md")
+        .map((entry) => path.join(directory, entry.name))
+        .sort();
+}
+function parseMarkdownFrontmatter(source) {
+    if (!source.startsWith("---\n"))
+        return undefined;
+    const end = source.indexOf("\n---", 4);
+    if (end === -1)
+        return undefined;
+    return YAML.parse(source.slice(4, end));
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isPlannedWorkflowArtifact(root, writes) {
+    return root.startsWith("onboarding/.output/") || writes.includes(root);
+}
+function validateFrontmatter(file, value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${file}: missing or invalid workflow frontmatter`);
+    }
+    const candidate = value;
+    const valid = typeof candidate.id === "string" &&
+        typeof candidate.title === "string" &&
+        WORKFLOW_PHASES.includes(candidate.phase) &&
+        (candidate.chain === undefined || WORKFLOW_CHAINS.includes(candidate.chain)) &&
+        isStringArray(candidate.reads) &&
+        isStringArray(candidate.writes) &&
+        Boolean(candidate.scope) &&
+        isStringArray(candidate.scope.allowedWriteRoots) &&
+        isStringArray(candidate.scope.forbiddenWriteRoots) &&
+        isStringArray(candidate.runs) &&
+        Array.isArray(candidate.recoveryRules) &&
+        candidate.recoveryRules.every((rule) => typeof rule?.on === "string" && typeof rule?.do === "string") &&
+        isStringArray(candidate.agentInvariants) &&
+        Boolean(candidate.selfOrchestration) &&
+        typeof candidate.selfOrchestration.autoRun === "boolean" &&
+        isStringArray(candidate.selfOrchestration.pauseFor) &&
+        isStringArray(candidate.checkpoints) &&
+        (candidate.nextWorkflow === undefined || typeof candidate.nextWorkflow === "string") &&
+        (candidate.branch === undefined ||
+            (typeof candidate.branch.on === "string" && isStringArray(candidate.branch.cases)));
+    if (!valid)
+        throw new Error(`${file}: invalid workflow frontmatter shape`);
+    return candidate;
+}
+/** Load one chain's workflow files. The chain a file belongs to is fixed by its directory. */
+async function loadWorkflows(workspaceRoot, chain = "greenfield") {
+    const dir = chain === "amend" ? WORKFLOW_AMEND_DIR : WORKFLOW_DIR;
+    const files = await readWorkflowFiles(workspaceRoot, dir);
+    const workflows = [];
+    const violations = [];
+    for (const file of files) {
+        const relativeFile = path.relative(workspaceRoot, file).replace(/\\/g, "/");
+        try {
+            const source = await fs.readFile(file, "utf8");
+            workflows.push({
+                relativeFile,
+                chain,
+                data: validateFrontmatter(relativeFile, parseMarkdownFrontmatter(source)),
+            });
+        }
+        catch (error) {
+            violations.push({
+                file: relativeFile,
+                code: "WF002",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return { workflows, violations };
+}
+function toListEntries(workflows) {
+    return workflows.map(({ relativeFile, data }) => ({
+        id: data.id,
+        title: data.title,
+        phase: data.phase,
+        file: relativeFile,
+        reads: data.reads,
+        writes: data.writes,
+        runs: data.runs,
+        nextWorkflow: data.nextWorkflow,
+    }));
+}
+export async function runWorkflowList(_input, context) {
+    const { workflows } = await loadWorkflows(context.workspaceRoot, "greenfield");
+    const entries = toListEntries(workflows);
+    return {
+        data: { command: "workflow.list", workflows: entries },
+        exitCode: 0,
+        summary: `workflow.list: ${entries.length} workflow file(s) found`,
+    };
+}
+export async function runWorkflowAmendList(_input, context) {
+    const { workflows } = await loadWorkflows(context.workspaceRoot, "amend");
+    const entries = toListEntries(workflows);
+    return {
+        data: { command: "workflow-amend.list", workflows: entries },
+        exitCode: 0,
+        summary: `workflow-amend.list: ${entries.length} amend workflow file(s) found`,
+    };
+}
+export async function runWorkflowLint(_input, context) {
+    const workflowDirectory = path.join(context.workspaceRoot, WORKFLOW_DIR);
+    const { workflows, violations } = await loadWorkflows(context.workspaceRoot);
+    const commandNames = new Set(context.commandRegistry?.listCommandNames() ?? []);
+    for (const commandName of [
+        "sites-check.run",
+        "sites-check.author",
+        "sites-check.postbuild",
+        "packages-check.run",
+        "app.contract.full",
+        "workflow.lint",
+        "workflow.list",
+    ]) {
+        commandNames.add(commandName);
+    }
+    for (const commandName of PENDING_ACCEPTED_RFC_COMMANDS)
+        commandNames.add(commandName);
+    const workflowIds = new Set(workflows.map(({ data }) => data.id));
+    for (const { relativeFile, data } of workflows) {
+        for (const runEntry of data.runs) {
+            // RFC-0075: runs entries may carry inline flags (e.g. "onboarding.phase.validate --phase=03-compose").
+            // The kernel registry stores bare command names; strip flag tokens before lookup.
+            const commandName = runEntry.split(/\s+/, 1)[0] ?? runEntry;
+            if (!commandNames.has(commandName)) {
+                violations.push({
+                    file: relativeFile,
+                    code: "WF003",
+                    message: `Unknown kernel command in runs: ${commandName}`,
+                });
+            }
+        }
+        if (!data.scope.forbiddenWriteRoots.includes("onboarding/.input/")) {
+            violations.push({
+                file: relativeFile,
+                code: "WF004",
+                message: "scope.forbiddenWriteRoots must include onboarding/.input/.",
+            });
+        }
+        if (data.nextWorkflow && !workflowIds.has(data.nextWorkflow)) {
+            violations.push({
+                file: relativeFile,
+                code: "WF005",
+                message: `nextWorkflow references missing workflow id: ${data.nextWorkflow}`,
+            });
+        }
+        for (const root of [...data.reads, ...data.writes, ...data.scope.allowedWriteRoots]) {
+            if (!root.includes("<") &&
+                !root.includes("*") &&
+                !root.endsWith("/") &&
+                !isPlannedWorkflowArtifact(root, data.writes) &&
+                !(await pathExists(path.join(context.workspaceRoot, root)))) {
+                violations.push({
+                    file: relativeFile,
+                    code: "WF007",
+                    message: `Path does not exist and is not a pattern: ${root}`,
+                });
+            }
+        }
+    }
+    return {
+        data: {
+            command: "workflow.lint",
+            workflowDirectory,
+            filesChecked: workflows.length,
+            violations,
+        },
+        exitCode: violations.length > 0 ? 1 : 0,
+        summary: violations.length > 0
+            ? `workflow.lint: ${violations.length} violation(s)`
+            : `workflow.lint: ${workflows.length} workflow file(s) valid`,
+    };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/os/workflow/handlers.js.map

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

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

@@ -0,0 +1,4 @@
+export { forgeWorkflowModule } from "./workflow.module.ts";
+export { runWorkflowLint, runWorkflowList, runWorkflowAmendList } from "./handlers.ts";
+export type { WorkflowPhase, WorkflowChain, WorkflowPreconditions, WorkflowBranch, WorkflowFrontmatter, WorkflowListEntry, WorkflowLintViolation, WorkflowLintResult, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/workflow/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EACV,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/os/workflow/index.js

@@ -0,0 +1,18 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Facilitates the export of workflow-related modules and types for use in the application.</purpose>
+ 
+ 
+<non-goals>
+  <item>Do not implement workflow execution logic.</item>
+  <item>Do not handle raw content parsing or transformation.</item>
+</non-goals>
+</MODULE_CONTRACT>
+ 
+<CHANGE_SUMMARY>
+  <item>Tidied by compass.changesummary.tidy; see git history for prior entries.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeWorkflowModule } from "./workflow.module.js";
+export { runWorkflowLint, runWorkflowList, runWorkflowAmendList } from "./handlers.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AAEF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/os/workflow/types.d.ts

@@ -0,0 +1,69 @@
+export declare const WORKFLOW_PHASES: readonly ["prepare", "synthesize", "scaffold", "compose", "author", "audit", "handoff"];
+export type WorkflowPhase = (typeof WORKFLOW_PHASES)[number];
+/** RFC-0136: which onboarding chain a workflow file belongs to. */
+export declare const WORKFLOW_CHAINS: readonly ["greenfield", "amend"];
+export type WorkflowChain = (typeof WORKFLOW_CHAINS)[number];
+/** RFC-0136: declarative, lint-checked preconditions for amend workflows. */
+export interface WorkflowPreconditions {
+    appPresent?: boolean;
+    systemManifestValid?: boolean;
+}
+/** RFC-0136: strengthen vs new-route branch, allowed only on the compose phase. */
+export interface WorkflowBranch {
+    on: string;
+    cases: string[];
+}
+export interface WorkflowScope {
+    allowedWriteRoots: string[];
+    forbiddenWriteRoots: string[];
+}
+export interface WorkflowRecoveryRule {
+    on: string;
+    do: string;
+}
+export interface WorkflowSelfOrchestration {
+    autoRun: boolean;
+    pauseFor: string[];
+}
+export interface WorkflowFrontmatter {
+    id: string;
+    title: string;
+    phase: WorkflowPhase;
+    /** RFC-0136: defaults to "greenfield" when absent. */
+    chain?: WorkflowChain;
+    /** RFC-0136: amend-only declarative preconditions (e.g. appPresent). */
+    preconditions?: WorkflowPreconditions;
+    /** RFC-0136: branch declaration, allowed only on the compose phase. */
+    branch?: WorkflowBranch;
+    reads: string[];
+    writes: string[];
+    scope: WorkflowScope;
+    runs: string[];
+    recoveryRules: WorkflowRecoveryRule[];
+    agentInvariants: string[];
+    selfOrchestration: WorkflowSelfOrchestration;
+    checkpoints: string[];
+    nextWorkflow?: string;
+}
+export interface WorkflowListEntry {
+    id: string;
+    title: string;
+    phase: WorkflowPhase;
+    file: string;
+    reads: string[];
+    writes: string[];
+    runs: string[];
+    nextWorkflow?: string;
+}
+export interface WorkflowLintViolation {
+    file: string;
+    code: string;
+    message: string;
+}
+export interface WorkflowLintResult {
+    command: "workflow.lint";
+    workflowDirectory: string;
+    filesChecked: number;
+    violations: WorkflowLintViolation[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/os/workflow/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../os/workflow/types.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,eAAe,yFAQlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,mEAAmE;AACnE,eAAO,MAAM,eAAe,kCAAmC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,wEAAwE;IACxE,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,uEAAuE;IACvE,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC"}

package/dist/os/workflow/types.js

@@ -0,0 +1,23 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Defines the RFC-0075 workflow frontmatter contract and command result types.</purpose>
+<non-goals>
+  <item>Do not execute workflows or mutate onboarding artifacts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0075: Add workflow command type contracts.</item>
+</CHANGE_SUMMARY>
+*/
+export const WORKFLOW_PHASES = [
+    "prepare",
+    "synthesize",
+    "scaffold",
+    "compose",
+    "author",
+    "audit",
+    "handoff",
+];
+/** RFC-0136: which onboarding chain a workflow file belongs to. */
+export const WORKFLOW_CHAINS = ["greenfield", "amend"];
+//# sourceMappingURL=types.js.map

package/dist/os/workflow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/workflow/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS;IACT,YAAY;IACZ,UAAU;IACV,SAAS;IACT,QAAQ;IACR,OAAO;IACP,SAAS;CACD,CAAC;AAIX,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,OAAO,CAAU,CAAC"}

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

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

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

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

package/dist/os/workflow/workflow.module.js

@@ -0,0 +1,48 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forgeWorkflowModule — registers workflow.lint, workflow.list, and workflow-amend.list commands from forge.</purpose>
+<non-goals>
+  <item>Do not register app-specific workflow commands.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0075: Add workflow command module.</item>
+  <item>RFC-0374: Migrated from packages/os/site-kernel/src/workflow/ to packages/forge/os/workflow/.</item>
+</CHANGE_SUMMARY>
+*/
+export const forgeWorkflowModule = {
+    name: "workflow",
+    version: "0.1.0",
+    async register(registry) {
+        const { runWorkflowLint, runWorkflowList, runWorkflowAmendList } = await import("./handlers.js");
+        registry.registerCommand({
+            name: "workflow.lint",
+            description: "Validate .agents/workflows AND .agents/workflows-amend markdown frontmatter, command references, " +
+                "and per-chain phase links (RFC-0075 + RFC-0136).",
+            scope: "workspace",
+            flags: {},
+            supportsAllSites: true,
+            reads: [".agents/workflows/**/*.md", ".windsurf/workflows/**/*.md"],
+            execute: runWorkflowLint,
+        });
+        registry.registerCommand({
+            name: "workflow.list",
+            description: "List .agents/workflows entries with phase, IO summary, and next workflow (RFC-0075).",
+            scope: "workspace",
+            flags: {},
+            supportsAllSites: true,
+            reads: [".agents/workflows/**/*.md", ".windsurf/workflows/**/*.md"],
+            execute: runWorkflowList,
+        });
+        registry.registerCommand({
+            name: "workflow-amend.list",
+            description: "List .agents/workflows-amend entries with phase, IO summary, and next workflow (RFC-0136).",
+            scope: "workspace",
+            flags: {},
+            supportsAllSites: true,
+            reads: [".agents/workflows-amend/**/*.md"],
+            execute: runWorkflowAmendList,
+        });
+    },
+};
+//# sourceMappingURL=workflow.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.module.js","sourceRoot":"","sources":["../../../os/workflow/workflow.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAIF,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,GAC9D,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAChC,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,mGAAmG;gBACnG,kDAAkD;YACpD,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,EAAE;YACT,gBAAgB,EAAE,IAAI;YACtB,KAAK,EAAE,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;YACnE,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;QACH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,sFAAsF;YACxF,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,EAAE;YACT,gBAAgB,EAAE,IAAI;YACtB,KAAK,EAAE,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;YACnE,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;QACH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EACT,4FAA4F;YAC9F,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,EAAE;YACT,gBAAgB,EAAE,IAAI;YACtB,KAAK,EAAE,CAAC,iCAAiC,CAAC;YAC1C,OAAO,EAAE,oBAAoB;SAC9B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/src/cli-output.d.ts

@@ -0,0 +1,5 @@
+import type { ForgeNextStep, CommandRegistry } from "./types.ts";
+export declare function renderNextSteps(steps?: ForgeNextStep[]): string;
+export declare function renderIdeRecommendation(): string;
+export declare function generateHelp(registry: CommandRegistry): string;
+//# sourceMappingURL=cli-output.d.ts.map

package/dist/src/cli-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.d.ts","sourceRoot":"","sources":["../../src/cli-output.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,MAAM,CAQ/D;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CA0B9D"}

package/dist/src/cli-output.js

@@ -0,0 +1,52 @@
+/*
+<MODULE_CONTRACT>
+<purpose>CLI output rendering helpers (RFC-0542) — renderNextSteps,
+renderIdeRecommendation, generateHelp. Pure functions, no I/O, no process.exit.
+Importable by bin/cli.ts and unit tests.</purpose>
+<non-goals>
+  <item>Do not call console.log or process.exit — callers handle output.</item>
+  <item>Do not import from bin/ — this is the portable layer.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0542: initial CLI output rendering helpers — renderNextSteps, renderIdeRecommendation, generateHelp.</item>
+</CHANGE_SUMMARY>
+*/
+export function renderNextSteps(steps) {
+    if (!steps || steps.length === 0)
+        return "";
+    const lines = ["\nNext steps:"];
+    for (const step of steps) {
+        const label = step.kind === "required" ? "[must do]" : "[can do]";
+        lines.push(`  • ${step.action}        ${label}`);
+    }
+    return lines.join("\n");
+}
+export function renderIdeRecommendation() {
+    return "\nRecommended IDE: Windsurf (tested with forge). Other IDEs (VS Code, Cursor)\nwork but are not tested.";
+}
+export function generateHelp(registry) {
+    const commands = registry.listCommands();
+    const header = `forge — autonomous project tooling
+
+Usage:
+  forge <command> [args...] [--flags...]
+  forge --help <command>    Show per-command flags and description
+
+Flags:
+  --json              Output results as JSON
+  --dry-run           Show what would happen without making changes
+  --site <name>       Target a specific site/app
+  --version           Show forge version
+  --help              Show this help (or per-command help with --help <command>)
+
+Registered commands (${commands.length}):`;
+    const commandLines = commands
+        .map((cmd) => {
+        const desc = cmd.description.length > 80 ? cmd.description.slice(0, 77) + "..." : cmd.description;
+        return `  ${cmd.name.padEnd(40)} ${desc}`;
+    })
+        .join("\n");
+    return `${header}\n${commandLines}\n`;
+}
+//# sourceMappingURL=cli-output.js.map

package/dist/src/cli-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.js","sourceRoot":"","sources":["../../src/cli-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAIF,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,WAAW,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,yGAAyG,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG;;;;;;;;;;;;;uBAaM,QAAQ,CAAC,MAAM,IAAI,CAAC;IAEzC,MAAM,YAAY,GAAG,QAAQ;SAC1B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,IAAI,GACR,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;QACvF,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,GAAG,MAAM,KAAK,YAAY,IAAI,CAAC;AACxC,CAAC"}