@macedon-technologies/batman 1.17.2 → 1.18.0

package/.jsii

@@ -123,7 +123,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/Application.ts",
-        "line": 20
+        "line": 21
       },
       "name": "ApplicationEnvironmentConfig",
       "properties": [
@@ -135,7 +135,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/Application.ts",
-            "line": 21
+            "line": 22
           },
           "name": "githubActionRoleArn",
           "type": {
@@ -158,7 +158,7 @@
         },
         "locationInModule": {
           "filename": "src/BatmanProject.ts",
-          "line": 63
+          "line": 64
         },
         "parameters": [
           {
@@ -172,7 +172,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/BatmanProject.ts",
-        "line": 62
+        "line": 63
       },
       "name": "BatmanProject",
       "symbolId": "src/BatmanProject:BatmanProject"
@@ -190,7 +190,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/BatmanProject.ts",
-        "line": 11
+        "line": 12
       },
       "name": "BatmanProjectOptions",
       "properties": [
@@ -203,7 +203,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 16
+            "line": 17
           },
           "name": "dev",
           "type": {
@@ -219,7 +219,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 26
+            "line": 27
           },
           "name": "prod",
           "type": {
@@ -235,7 +235,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 21
+            "line": 22
           },
           "name": "staging",
           "type": {
@@ -251,7 +251,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 51
+            "line": 52
           },
           "name": "actionVersions",
           "optional": true,
@@ -268,7 +268,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 41
+            "line": 42
           },
           "name": "additionalCodeOwners",
           "optional": true,
@@ -290,7 +290,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 31
+            "line": 32
           },
           "name": "additionalTags",
           "optional": true,
@@ -313,7 +313,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 58
+            "line": 59
           },
           "name": "authorizerObjectVersion",
           "optional": true,
@@ -330,7 +330,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 36
+            "line": 37
           },
           "name": "n8nWorkflows",
           "optional": true,
@@ -347,7 +347,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/BatmanProject.ts",
-            "line": 46
+            "line": 47
           },
           "name": "websiteDeps",
           "optional": true,
@@ -376,7 +376,7 @@
         },
         "locationInModule": {
           "filename": "src/BootcampProject.ts",
-          "line": 17
+          "line": 18
         },
         "parameters": [
           {
@@ -390,7 +390,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/BootcampProject.ts",
-        "line": 16
+        "line": 17
       },
       "name": "BootcampProject",
       "symbolId": "src/BootcampProject:BootcampProject"
@@ -408,7 +408,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/BootcampProject.ts",
-        "line": 12
+        "line": 13
       },
       "name": "BootcampProjectOptions",
       "symbolId": "src/BootcampProject:BootcampProjectOptions"
@@ -780,6 +780,113 @@
       ],
       "symbolId": "src/ProductionDeployWorkflow:ProductionDeployWorkflowOptions"
     },
+    "@macedon-technologies/batman.SoftwareFactoryFiles": {
+      "assembly": "@macedon-technologies/batman",
+      "docs": {
+        "remarks": "What swamp itself would generate (extension docs pulled via\n`swamp extension pull`, `.swamp.yaml`, the vault, and the \"swamp managed\nsection\" in CLAUDE.md) is deliberately NOT hand-templated here — those are\nproduced by the real `swamp` CLI. `swamp init` is idempotent (a no-op if\nthe repo is already initialized), so it's wired into the project's\n`install`/`install:ci` tasks and runs automatically on every install,\nguarded so it's a silent no-op on a machine without `swamp` on PATH (e.g.\nCI). The extension pulls and vault creation are one-time, not idempotent\nin a way that's safe to repeat on every install, so they stay in the\n`swamp:bootstrap` task this construct adds. Only exman's own authored\nconfig (the factory's state machine, the architecture-rule engine, the\nattestation mechanism, the OpenSpec task-completion gate, and the 3 swamp\nworkflows that wire them together) is templated.",
+        "stability": "stable",
+        "summary": "Backports exman's swamp \"software factory\" pattern (macedon-technologies/exman#13) as generated scaffolding: a `@swamp/software-factory` state machine that drives a GitHub issue from intake through an opened PR, enforcing OpenSpec usage, an architecture rule registry, and a pre-PR verification gate whose attestation is re-checked at merge time."
+      },
+      "fqn": "@macedon-technologies/batman.SoftwareFactoryFiles",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/SoftwareFactoryFiles.ts",
+          "line": 55
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.javascript.NodeProject"
+            }
+          },
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@macedon-technologies/batman.SoftwareFactoryFilesOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/SoftwareFactoryFiles.ts",
+        "line": 54
+      },
+      "name": "SoftwareFactoryFiles",
+      "symbolId": "src/SoftwareFactoryFiles:SoftwareFactoryFiles"
+    },
+    "@macedon-technologies/batman.SoftwareFactoryFilesOptions": {
+      "assembly": "@macedon-technologies/batman",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@macedon-technologies/batman.SoftwareFactoryFilesOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/SoftwareFactoryFiles.ts",
+        "line": 11
+      },
+      "name": "SoftwareFactoryFilesOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The bare repo name (e.g. `expense-tracker`), used to derive the factory's model names (`<repoName>-factory`, `<repoName>-issues`, `<repoName>-pr`, `<repoName>-shell*`) and vault name (`<repoName>-secrets`)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/SoftwareFactoryFiles.ts",
+            "line": 17
+          },
+          "name": "repoName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Overrides for the pinned action versions used by `verify-attestation.yml`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/SoftwareFactoryFiles.ts",
+            "line": 29
+          },
+          "name": "actionVersions",
+          "optional": true,
+          "type": {
+            "fqn": "@macedon-technologies/batman.WorkflowActionVersions"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'main'",
+            "stability": "stable",
+            "summary": "The branch the factory opens pull requests against."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/SoftwareFactoryFiles.ts",
+            "line": 24
+          },
+          "name": "baseBranch",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/SoftwareFactoryFiles:SoftwareFactoryFilesOptions"
+    },
     "@macedon-technologies/batman.StagingDeployWorkflow": {
       "assembly": "@macedon-technologies/batman",
       "base": "projen.YamlFile",
@@ -918,13 +1025,13 @@
       "docs": {
         "remarks": "zizmor flags unpinned `uses:` references as a high-severity finding\n(https://docs.zizmor.sh/audits/#unpinned-uses) because a mutable tag can be\nrepointed to different code after review. Every field here can be\noverridden by consumers who need a different pinned SHA (e.g. to pick up a\nnewer release before this package does).",
         "stability": "stable",
-        "summary": "SHA-pinned action references used by the generated deploy/cleanup workflows."
+        "summary": "SHA-pinned action references used by the generated deploy/cleanup workflows, and applied to the workflows AwsCdkTypeScriptApp generates on its own (upgrade.yml, pull-request-lint.yml) via `hardenProjenGeneratedWorkflows` — see `ProjenWorkflowHardening.ts`."
       },
       "fqn": "@macedon-technologies/batman.WorkflowActionVersions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/WorkflowActionVersions.ts",
-        "line": 10
+        "line": 12
       },
       "name": "WorkflowActionVersions",
       "properties": [
@@ -938,7 +1045,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/WorkflowActionVersions.ts",
-            "line": 16
+            "line": 18
           },
           "name": "checkout",
           "optional": true,
@@ -956,7 +1063,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/WorkflowActionVersions.ts",
-            "line": 30
+            "line": 32
           },
           "name": "configureAwsCredentials",
           "optional": true,
@@ -964,6 +1071,42 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1' // v8.1.1",
+            "stability": "stable",
+            "summary": "The `peter-evans/create-pull-request` action reference, used by projen's built-in dependency-upgrade workflow to open the upgrade PR."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/WorkflowActionVersions.ts",
+            "line": 54
+          },
+          "name": "createPullRequest",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c' // v8",
+            "stability": "stable",
+            "summary": "The `actions/download-artifact` action reference, used by projen's built-in dependency-upgrade workflow to pass the upgrade patch between jobs."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/WorkflowActionVersions.ts",
+            "line": 70
+          },
+          "name": "downloadArtifact",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -974,7 +1117,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/WorkflowActionVersions.ts",
-            "line": 44
+            "line": 46
           },
           "name": "githubScript",
           "optional": true,
@@ -992,7 +1135,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/WorkflowActionVersions.ts",
-            "line": 37
+            "line": 39
           },
           "name": "pnpmActionSetup",
           "optional": true,
@@ -1000,6 +1143,24 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50' // v6.1.1",
+            "stability": "stable",
+            "summary": "The `amannn/action-semantic-pull-request` action reference, used by projen's built-in pull-request-lint workflow to validate PR titles."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/WorkflowActionVersions.ts",
+            "line": 78
+          },
+          "name": "semanticPullRequest",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -1010,13 +1171,31 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/WorkflowActionVersions.ts",
-            "line": 23
+            "line": 25
           },
           "name": "setupNode",
           "optional": true,
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a' // v7",
+            "stability": "stable",
+            "summary": "The `actions/upload-artifact` action reference, used by projen's built-in dependency-upgrade workflow to pass the upgrade patch between jobs."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/WorkflowActionVersions.ts",
+            "line": 62
+          },
+          "name": "uploadArtifact",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "src/WorkflowActionVersions:WorkflowActionVersions"
@@ -1068,6 +1247,6 @@
       "symbolId": "src/WorkflowAutoDiscover:WorkflowAutoDiscover"
     }
   },
-  "version": "1.17.2",
-  "fingerprint": "ZfbdZhVv86lL7QQw6Z2sxLhOGoFmUs9U2ntYWD90Xpw="
+  "version": "1.18.0",
+  "fingerprint": "JZfOtlClOJntadBGRkaeJ0IXkGuwwTH6CJrv4+kfKYI="
 }

package/.swamp.yaml

@@ -0,0 +1,6 @@
+swampVersion: 20260830.034252.0
+initializedAt: "2026-08-31T20:50:20.528Z"
+repoId: c00711dd-bd24-4a7a-ab61-38d554723f27
+tools:
+  - claude
+gitignoreManaged: true

package/API.md

@@ -10572,6 +10572,63 @@ Overrides for the pinned action versions used by this workflow.
 
 ---
 
+### SoftwareFactoryFilesOptions <a name="SoftwareFactoryFilesOptions" id="@macedon-technologies/batman.SoftwareFactoryFilesOptions"></a>
+
+#### Initializer <a name="Initializer" id="@macedon-technologies/batman.SoftwareFactoryFilesOptions.Initializer"></a>
+
+```typescript
+import { SoftwareFactoryFilesOptions } from '@macedon-technologies/batman'
+
+const softwareFactoryFilesOptions: SoftwareFactoryFilesOptions = { ... }
+```
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@macedon-technologies/batman.SoftwareFactoryFilesOptions.property.repoName">repoName</a></code> | <code>string</code> | The bare repo name (e.g. `expense-tracker`), used to derive the factory's model names (`<repoName>-factory`, `<repoName>-issues`, `<repoName>-pr`, `<repoName>-shell*`) and vault name (`<repoName>-secrets`). |
+| <code><a href="#@macedon-technologies/batman.SoftwareFactoryFilesOptions.property.actionVersions">actionVersions</a></code> | <code><a href="#@macedon-technologies/batman.WorkflowActionVersions">WorkflowActionVersions</a></code> | Overrides for the pinned action versions used by `verify-attestation.yml`. |
+| <code><a href="#@macedon-technologies/batman.SoftwareFactoryFilesOptions.property.baseBranch">baseBranch</a></code> | <code>string</code> | The branch the factory opens pull requests against. |
+
+---
+
+##### `repoName`<sup>Required</sup> <a name="repoName" id="@macedon-technologies/batman.SoftwareFactoryFilesOptions.property.repoName"></a>
+
+```typescript
+public readonly repoName: string;
+```
+
+- *Type:* string
+
+The bare repo name (e.g. `expense-tracker`), used to derive the factory's model names (`<repoName>-factory`, `<repoName>-issues`, `<repoName>-pr`, `<repoName>-shell*`) and vault name (`<repoName>-secrets`).
+
+---
+
+##### `actionVersions`<sup>Optional</sup> <a name="actionVersions" id="@macedon-technologies/batman.SoftwareFactoryFilesOptions.property.actionVersions"></a>
+
+```typescript
+public readonly actionVersions: WorkflowActionVersions;
+```
+
+- *Type:* <a href="#@macedon-technologies/batman.WorkflowActionVersions">WorkflowActionVersions</a>
+
+Overrides for the pinned action versions used by `verify-attestation.yml`.
+
+---
+
+##### `baseBranch`<sup>Optional</sup> <a name="baseBranch" id="@macedon-technologies/batman.SoftwareFactoryFilesOptions.property.baseBranch"></a>
+
+```typescript
+public readonly baseBranch: string;
+```
+
+- *Type:* string
+- *Default:* 'main'
+
+The branch the factory opens pull requests against.
+
+---
+
 ### StagingDeployWorkflowOptions <a name="StagingDeployWorkflowOptions" id="@macedon-technologies/batman.StagingDeployWorkflowOptions"></a>
 
 #### Initializer <a name="Initializer" id="@macedon-technologies/batman.StagingDeployWorkflowOptions.Initializer"></a>
@@ -10648,7 +10705,7 @@ Overrides for the pinned action versions used by this workflow.
 
 ### WorkflowActionVersions <a name="WorkflowActionVersions" id="@macedon-technologies/batman.WorkflowActionVersions"></a>
 
-SHA-pinned action references used by the generated deploy/cleanup workflows.
+SHA-pinned action references used by the generated deploy/cleanup workflows, and applied to the workflows AwsCdkTypeScriptApp generates on its own (upgrade.yml, pull-request-lint.yml) via `hardenProjenGeneratedWorkflows` — see `ProjenWorkflowHardening.ts`.
 
 zizmor flags unpinned `uses:` references as a high-severity finding
 (https://docs.zizmor.sh/audits/#unpinned-uses) because a mutable tag can be
@@ -10670,9 +10727,13 @@ const workflowActionVersions: WorkflowActionVersions = { ... }
 | --- | --- | --- |
 | <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.checkout">checkout</a></code> | <code>string</code> | The `actions/checkout` action reference. |
 | <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.configureAwsCredentials">configureAwsCredentials</a></code> | <code>string</code> | The `aws-actions/configure-aws-credentials` action reference. |
+| <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.createPullRequest">createPullRequest</a></code> | <code>string</code> | The `peter-evans/create-pull-request` action reference, used by projen's built-in dependency-upgrade workflow to open the upgrade PR. |
+| <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.downloadArtifact">downloadArtifact</a></code> | <code>string</code> | The `actions/download-artifact` action reference, used by projen's built-in dependency-upgrade workflow to pass the upgrade patch between jobs. |
 | <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.githubScript">githubScript</a></code> | <code>string</code> | The `actions/github-script` action reference. |
 | <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.pnpmActionSetup">pnpmActionSetup</a></code> | <code>string</code> | The `pnpm/action-setup` action reference, used when the project's package manager is pnpm. |
+| <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.semanticPullRequest">semanticPullRequest</a></code> | <code>string</code> | The `amannn/action-semantic-pull-request` action reference, used by projen's built-in pull-request-lint workflow to validate PR titles. |
 | <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.setupNode">setupNode</a></code> | <code>string</code> | The `actions/setup-node` action reference. |
+| <code><a href="#@macedon-technologies/batman.WorkflowActionVersions.property.uploadArtifact">uploadArtifact</a></code> | <code>string</code> | The `actions/upload-artifact` action reference, used by projen's built-in dependency-upgrade workflow to pass the upgrade patch between jobs. |
 
 ---
 
@@ -10702,6 +10763,32 @@ The `aws-actions/configure-aws-credentials` action reference.
 
 ---
 
+##### `createPullRequest`<sup>Optional</sup> <a name="createPullRequest" id="@macedon-technologies/batman.WorkflowActionVersions.property.createPullRequest"></a>
+
+```typescript
+public readonly createPullRequest: string;
+```
+
+- *Type:* string
+- *Default:* 'peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1' // v8.1.1
+
+The `peter-evans/create-pull-request` action reference, used by projen's built-in dependency-upgrade workflow to open the upgrade PR.
+
+---
+
+##### `downloadArtifact`<sup>Optional</sup> <a name="downloadArtifact" id="@macedon-technologies/batman.WorkflowActionVersions.property.downloadArtifact"></a>
+
+```typescript
+public readonly downloadArtifact: string;
+```
+
+- *Type:* string
+- *Default:* 'actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c' // v8
+
+The `actions/download-artifact` action reference, used by projen's built-in dependency-upgrade workflow to pass the upgrade patch between jobs.
+
+---
+
 ##### `githubScript`<sup>Optional</sup> <a name="githubScript" id="@macedon-technologies/batman.WorkflowActionVersions.property.githubScript"></a>
 
 ```typescript
@@ -10728,6 +10815,19 @@ The `pnpm/action-setup` action reference, used when the project's package manage
 
 ---
 
+##### `semanticPullRequest`<sup>Optional</sup> <a name="semanticPullRequest" id="@macedon-technologies/batman.WorkflowActionVersions.property.semanticPullRequest"></a>
+
+```typescript
+public readonly semanticPullRequest: string;
+```
+
+- *Type:* string
+- *Default:* 'amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50' // v6.1.1
+
+The `amannn/action-semantic-pull-request` action reference, used by projen's built-in pull-request-lint workflow to validate PR titles.
+
+---
+
 ##### `setupNode`<sup>Optional</sup> <a name="setupNode" id="@macedon-technologies/batman.WorkflowActionVersions.property.setupNode"></a>
 
 ```typescript
@@ -10741,5 +10841,68 @@ The `actions/setup-node` action reference.
 
 ---
 
+##### `uploadArtifact`<sup>Optional</sup> <a name="uploadArtifact" id="@macedon-technologies/batman.WorkflowActionVersions.property.uploadArtifact"></a>
+
+```typescript
+public readonly uploadArtifact: string;
+```
+
+- *Type:* string
+- *Default:* 'actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a' // v7
+
+The `actions/upload-artifact` action reference, used by projen's built-in dependency-upgrade workflow to pass the upgrade patch between jobs.
+
+---
+
+## Classes <a name="Classes" id="Classes"></a>
+
+### SoftwareFactoryFiles <a name="SoftwareFactoryFiles" id="@macedon-technologies/batman.SoftwareFactoryFiles"></a>
+
+Backports exman's swamp "software factory" pattern (macedon-technologies/exman#13) as generated scaffolding: a `@swamp/software-factory` state machine that drives a GitHub issue from intake through an opened PR, enforcing OpenSpec usage, an architecture rule registry, and a pre-PR verification gate whose attestation is re-checked at merge time.
+
+What swamp itself would generate (extension docs pulled via
+`swamp extension pull`, `.swamp.yaml`, the vault, and the "swamp managed
+section" in CLAUDE.md) is deliberately NOT hand-templated here — those are
+produced by the real `swamp` CLI. `swamp init` is idempotent (a no-op if
+the repo is already initialized), so it's wired into the project's
+`install`/`install:ci` tasks and runs automatically on every install,
+guarded so it's a silent no-op on a machine without `swamp` on PATH (e.g.
+CI). The extension pulls and vault creation are one-time, not idempotent
+in a way that's safe to repeat on every install, so they stay in the
+`swamp:bootstrap` task this construct adds. Only exman's own authored
+config (the factory's state machine, the architecture-rule engine, the
+attestation mechanism, the OpenSpec task-completion gate, and the 3 swamp
+workflows that wire them together) is templated.
+
+#### Initializers <a name="Initializers" id="@macedon-technologies/batman.SoftwareFactoryFiles.Initializer"></a>
+
+```typescript
+import { SoftwareFactoryFiles } from '@macedon-technologies/batman'
+
+new SoftwareFactoryFiles(project: NodeProject, options: SoftwareFactoryFilesOptions)
+```
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@macedon-technologies/batman.SoftwareFactoryFiles.Initializer.parameter.project">project</a></code> | <code>projen.javascript.NodeProject</code> | *No description.* |
+| <code><a href="#@macedon-technologies/batman.SoftwareFactoryFiles.Initializer.parameter.options">options</a></code> | <code><a href="#@macedon-technologies/batman.SoftwareFactoryFilesOptions">SoftwareFactoryFilesOptions</a></code> | *No description.* |
+
+---
+
+##### `project`<sup>Required</sup> <a name="project" id="@macedon-technologies/batman.SoftwareFactoryFiles.Initializer.parameter.project"></a>
+
+- *Type:* projen.javascript.NodeProject
+
+---
+
+##### `options`<sup>Required</sup> <a name="options" id="@macedon-technologies/batman.SoftwareFactoryFiles.Initializer.parameter.options"></a>
+
+- *Type:* <a href="#@macedon-technologies/batman.SoftwareFactoryFilesOptions">SoftwareFactoryFilesOptions</a>
+
+---
+
+
+
+