@warpgogol/forge 2.8.0 → 2.8.2

package/os/workflow/handlers.ts

@@ -0,0 +1,304 @@
+/*
+<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 type {
+  ForgeCommandInput,
+  ForgeCommandResult,
+  ForgeRuntimeContext,
+} from "../../src/types.ts";
+import {
+  WORKFLOW_PHASES,
+  WORKFLOW_CHAINS,
+  type WorkflowChain,
+  type WorkflowFrontmatter,
+  type WorkflowLintResult,
+  type WorkflowLintViolation,
+  type WorkflowListEntry,
+} from "./types.ts";
+
+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: string): Promise<boolean> {
+  try {
+    await fs.access(target);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function readWorkflowFiles(workspaceRoot: string, dir: string) {
+  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: string): unknown {
+  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: unknown): value is string[] {
+  return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+
+function isPlannedWorkflowArtifact(root: string, writes: string[]): boolean {
+  return root.startsWith("onboarding/.output/") || writes.includes(root);
+}
+
+function validateFrontmatter(file: string, value: unknown): WorkflowFrontmatter {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`${file}: missing or invalid workflow frontmatter`);
+  }
+  const candidate = value as WorkflowFrontmatter;
+  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: string, chain: WorkflowChain = "greenfield") {
+  const dir = chain === "amend" ? WORKFLOW_AMEND_DIR : WORKFLOW_DIR;
+  const files = await readWorkflowFiles(workspaceRoot, dir);
+  const workflows: Array<{
+    relativeFile: string;
+    chain: WorkflowChain;
+    data: WorkflowFrontmatter;
+  }> = [];
+  const violations: WorkflowLintViolation[] = [];
+
+  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: Array<{ relativeFile: string; data: WorkflowFrontmatter }>,
+): WorkflowListEntry[] {
+  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: ForgeCommandInput,
+  context: ForgeRuntimeContext,
+): Promise<ForgeCommandResult<{ command: "workflow.list"; workflows: WorkflowListEntry[] }>> {
+  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: ForgeCommandInput,
+  context: ForgeRuntimeContext,
+): Promise<ForgeCommandResult<{ command: "workflow-amend.list"; workflows: WorkflowListEntry[] }>> {
+  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: ForgeCommandInput,
+  context: ForgeRuntimeContext,
+): Promise<ForgeCommandResult<WorkflowLintResult>> {
+  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`,
+  };
+}

package/os/workflow/index.ts

@@ -0,0 +1,28 @@
+/* 
+<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.ts";
+export { runWorkflowLint, runWorkflowList, runWorkflowAmendList } from "./handlers.ts";
+export type {
+  WorkflowPhase,
+  WorkflowChain,
+  WorkflowPreconditions,
+  WorkflowBranch,
+  WorkflowFrontmatter,
+  WorkflowListEntry,
+  WorkflowLintViolation,
+  WorkflowLintResult,
+} from "./types.ts";

package/os/workflow/types.ts

@@ -0,0 +1,99 @@
+/*
+<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",
+] as const;
+
+export type WorkflowPhase = (typeof WORKFLOW_PHASES)[number];
+
+/** RFC-0136: which onboarding chain a workflow file belongs to. */
+export const WORKFLOW_CHAINS = ["greenfield", "amend"] as const;
+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[];
+}

package/os/workflow/workflow.module.ts

@@ -0,0 +1,54 @@
+/*
+<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>
+*/
+
+import type { ForgeModule } from "../../src/forge-module.ts";
+
+export const forgeWorkflowModule: ForgeModule = {
+  name: "workflow",
+  version: "0.1.0",
+  async register(registry) {
+    const { runWorkflowLint, runWorkflowList, runWorkflowAmendList } =
+      await import("./handlers.ts");
+    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,
+    });
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "2.8.0",
+  "version": "2.8.2",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -147,8 +147,8 @@
     "bin/cli.js",
     "skills/",
     "profiles/",
-    "src/onboarding/templates/",
-    "os/rfc/rfc-0000-template.md",
+    "src/",
+    "os/",
     "AGENTS.md",
     "README.md",
     "LICENSE"

package/profiles/godot-csharp.yaml

@@ -362,7 +362,7 @@ workspace:
             "prettier": "^3.4.0",
             "@warpgogol/forge": "^2.2.0",
             "@warpgogol/werkstatt": "^1.2.0",
-            "@warpgogol/werkstatt-godot": "^0.6.0"
+            "@warpgogol/werkstatt-godot-game": "^0.6.0"
           }
         }
     - path: godot.version
@@ -613,7 +613,7 @@ workspace:
     - path: tools/kernel.config.ts
       content: |
         import { defineKernelConfig } from "@warpgogol/werkstatt/kernel/types";
-        import { werkstattGodotPlugin } from "@warpgogol/werkstatt-godot";
+        import { werkstattGodotPlugin } from "@warpgogol/werkstatt-godot-game";
 
         export default defineKernelConfig({
           name: "__PROJECT_NAME__",
@@ -709,7 +709,7 @@ workspace:
       content: |
         # __PROJECT_NAME__
 
-        A Warpgogol workshop powered by the Werkstatt engine and the @warpgogol/werkstatt-godot plugin.
+        A Warpgogol workshop powered by the Werkstatt engine and the @warpgogol/werkstatt-godot-game plugin.
 
         ## Prerequisites
 
@@ -776,7 +776,7 @@ workspace:
         ## Stack
 
         - Engine: @warpgogol/werkstatt
-        - Plugin: @warpgogol/werkstatt-godot
+        - Plugin: @warpgogol/werkstatt-godot-game
         - Stack profile: godot-csharp
 install:
   - pnpm install

package/profiles/knowledge-typescript-turborepo.yaml

@@ -0,0 +1,110 @@
+schema: forge/stack-profile@1
+id: knowledge-typescript-turborepo
+displayName: Knowledge Base + Turborepo
+detect:
+  anyOf:
+    - knowledge/manifest.yaml
+    - knowledge.config.yaml
+workspace:
+  dirs:
+    - apps
+    - packages
+    - knowledge
+    - staging
+    - laboratory
+    - projections
+    - docs
+    - tools
+    - missions
+    - systems-cache
+  files:
+    - path: .vscode/extensions.json
+      content: |
+        {
+          "recommendations": [
+            "dbaeumer.vscode-eslint",
+            "esbenp.prettier-vscode",
+            "github.vscode-github-actions",
+            "mechatroner.rainbow-csv",
+            "redhat.vscode-yaml"
+          ]
+        }
+    - path: pnpm-workspace.yaml
+      content: |
+        packages:
+          - "apps/*"
+          - "packages/*"
+    - path: turbo.json
+      content: |
+        {
+          "$schema": "https://turbo.build/schema.json",
+          "tasks": {
+            "build": {
+              "dependsOn": ["^build"],
+              "outputs": ["dist/**", ".generated/**"]
+            },
+            "build:check": {
+              "dependsOn": ["^build:check"]
+            },
+            "test": {
+              "dependsOn": ["^build:check"]
+            }
+          }
+        }
+    - path: tsconfig.base.json
+      content: |
+        {
+          "compilerOptions": {
+            "target": "ESNext",
+            "module": "ESNext",
+            "moduleResolution": "bundler",
+            "strict": true,
+            "esModuleInterop": true,
+            "skipLibCheck": true,
+            "forceConsistentCasingInFileNames": true,
+            "resolveJsonModule": true,
+            "declaration": true,
+            "declarationMap": true,
+            "sourceMap": true
+          }
+        }
+    - path: .gitignore
+      content: |
+        node_modules/
+        dist/
+        .generated/
+        .turbo/
+        .cache/
+    - path: knowledge/manifest.yaml
+      content: |
+        # Knowledge manifest — canonical dataset identity
+        id: ""
+        name: ""
+        modelVersion: "1.0.0"
+        description: ""
+        license: ""
+    - path: knowledge/ontology/schema-registry.yaml
+      content: |
+        # Ontology schema registry
+        # Register canonical record schemas here
+        schemas: []
+    - path: knowledge.config.yaml
+      content: |
+        # Knowledge operational configuration
+        source:
+          rootPattern: "../<kb-id>-source"
+        extractors: []
+        projections:
+          - name: web
+            path: apps/web
+          - name: mcp
+            path: apps/mcp
+plugin:
+  id: werkstatt-knowledge
+  package: "@warpgogol/werkstatt-knowledge"
+agents:
+  root: |
+    # Knowledge Base Workshop
+
+    This workshop uses the **werkstatt-knowledge** plugin (`werkstatt/plugin@1`).
+    See `packages/werkstatt-knowledge/AGENTS.md` for plugin-specific rules.

package/profiles/phaser-turborepo.yaml

@@ -219,7 +219,7 @@ workspace:
     - path: tools/kernel.config.ts
       content: |
         import { defineKernelConfig } from "@warpgogol/werkstatt/kernel/types";
-        import { werkstattGamePlugin } from "@warpgogol/werkstatt-game";
+        import { werkstattPhaserPlugin } from "@warpgogol/werkstatt-phaser-game";
 
         export default defineKernelConfig({
           name: "__PROJECT_NAME__",
@@ -249,7 +249,7 @@ workspace:
             evidence: async () => (await import("@warpgogol/werkstatt/evidence-module")).createEvidenceModule(),
             "werkstatt-plugin": async () => (await import("@warpgogol/werkstatt/os/werkstatt-plugin-module")).forgeWerkstattPluginModule,
             "werkstatt-autonomy": async () => (await import("@warpgogol/werkstatt/os/werkstatt-autonomy-module")).werkstattAutonomyModule,
-            "__PROJECT_NAME__-plugin": async () => werkstattGamePlugin,
+            "__PROJECT_NAME__-plugin": async () => werkstattPhaserPlugin,
           },
         });
     - path: .npmrc
@@ -313,7 +313,7 @@ workspace:
       content: |
         # __PROJECT_NAME__
 
-        A Warpgogol workshop powered by the Werkstatt engine and the @warpgogol/werkstatt-game plugin.
+        A Warpgogol workshop powered by the Werkstatt engine and the @warpgogol/werkstatt-phaser-game plugin.
 
         ## Prerequisites
 
@@ -347,10 +347,10 @@ workspace:
         ## Stack
 
         - Engine: @warpgogol/werkstatt
-        - Plugin: @warpgogol/werkstatt-game
+        - Plugin: @warpgogol/werkstatt-phaser-game
         - Stack profile: phaser-turborepo
 install:
-  - pnpm add -wD typescript turbo @warpgogol/forge @warpgogol/werkstatt @warpgogol/werkstatt-shared @warpgogol/werkstatt-game prettier
+  - pnpm add -wD typescript turbo @warpgogol/forge @warpgogol/werkstatt @warpgogol/werkstatt-shared @warpgogol/werkstatt-phaser-game prettier
 firstWorkspace:
   path: apps/my-game
   files: