forge-template 0.3.2__tar.gz → 0.4.0__tar.gz

{forge_template-0.3.2 → forge_template-0.4.0}/.github/labels.toml

@@ -76,7 +76,7 @@ in-progress = { color = "8c959f", description = "Actively being worked on" }
 deferred = { color = "afb8c1", description = "Confirmed out of scope for now, not forgotten" }
 
 [groups.roadmap]
-description = "Which Forge Foundation roadmap stage owns the work."
+description = "Which Forge roadmap stage owns the work."
 family = "orange"
 
 [groups.roadmap.labels]
@@ -90,6 +90,11 @@ family = "orange"
 "07" = { color = "d45d1a", description = "Forge roadmap Stage 07 — Forge CLI Integration" }
 "08" = { color = "bd4914", description = "Forge roadmap Stage 08 — Reference Archetype Validation" }
 "09" = { color = "9f3610", description = "Forge roadmap Stage 09 — Blueprint Compatibility" }
+"10" = { color = "ffe2b7", description = "Forge roadmap Stage 10 — Data Science Architecture Contract" }
+"11" = { color = "ffc680", description = "Forge roadmap Stage 11 — Reusable Data Science Capabilities" }
+"12" = { color = "ffa657", description = "Forge roadmap Stage 12 — Data Science Archetype" }
+"13" = { color = "e67700", description = "Forge roadmap Stage 13 — Data Science CLI Integration" }
+"14" = { color = "b95000", description = "Forge roadmap Stage 14 — Data Science Validation and Rollout" }
 
 # Repository-wide metadata that is clearer without a namespace. GitHub
 # special-cases `good first issue` and `help wanted` in its discovery UI.

{forge_template-0.3.2 → forge_template-0.4.0}/.github/pull_request_template.md

@@ -10,7 +10,7 @@
       released projects
 - [ ] An ADR is added under `docs/adr/`, if this makes a real architectural call
 - [ ] A `_migrations` block is added, if any `template/` path was renamed or
-      deleted (see CLAUDE.md's invariant 3)
+      deleted (see docs/invariants.md's invariant 3)
 - [ ] Any conditional file I touched still ends in a real trailing newline
-      (invariant 1)
+      (docs/invariants.md's invariant 1)
 - [ ] Commit messages follow [Conventional Commits](https://www.conventionalcommits.org/)

{forge_template-0.3.2 → forge_template-0.4.0}/.github/workflows/release.yml

@@ -8,7 +8,7 @@ on:
   workflow_dispatch:
     inputs:
       dry_run:
-        description: Print the tag without creating it
+        description: Print the tag and notes without creating anything
         type: boolean
         default: false
 
@@ -22,6 +22,12 @@ jobs:
   release:
     runs-on: ubuntu-latest
     steps:
+      - name: Refuse to release from anything but main
+        if: github.ref != 'refs/heads/main'
+        run: |
+          echo "::error::Releases must be dispatched from main, not ${{ github.ref }}."
+          exit 1
+
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
@@ -55,15 +61,21 @@ jobs:
         id: notes
         run: |
           latest="${{ steps.version.outputs.latest }}"
+          if [ "$latest" = "none" ]; then
+            echo "Initial release." > release-notes.md
+          else
+            git log "${latest}..HEAD" --pretty='- %s' --no-merges > release-notes.md
+          fi
           {
             echo "notes<<EOF"
-            if [ "$latest" = "none" ]; then
-              echo "Initial release."
-            else
-              git log "${latest}..HEAD" --pretty='- %s' --no-merges
-            fi
+            cat release-notes.md
             echo "EOF"
           } >> "$GITHUB_OUTPUT"
+          {
+            echo "## Release notes"
+            echo
+            cat release-notes.md
+          } >> "$GITHUB_STEP_SUMMARY"
 
       - name: Warn on breaking template changes
         run: |

{forge_template-0.3.2 → forge_template-0.4.0}/.github/workflows/test-template.yml

@@ -40,7 +40,8 @@ jobs:
         run: uv sync --all-groups
 
       # Same gate as `uv run pre-commit run --all-files` locally: ruff,
-      # shellcheck, and the whitespace/EOF hooks that guard invariant 1.
+      # shellcheck, markdownlint, and the whitespace/EOF hooks that guard
+      # invariant 1.
       - name: Pre-commit
         run: uv run pre-commit run --all-files --show-diff-on-failure
 
@@ -119,8 +120,8 @@ jobs:
         run: uv run pytest -m combos -k c1-uvbuild-static --from-git -v
 
   # ---------------------------------------------------------------------------
-  # Real uv build/install/import proof for the production Library and CLI
-  # archetypes -- tests/test_library_build.py, tests/test_cli_build.py.
+  # Real generated-project proof for production Library/CLI archetypes and
+  # capability compositions -- tests/*_build.py.
   # ---------------------------------------------------------------------------
   archetype:
     name: Archetype builds

forge_template-0.4.0/.markdownlint-cli2.jsonc

@@ -0,0 +1,23 @@
+{
+  "config": {
+    "MD013": {
+      "line_length": 80,
+      // A table row cannot be broken across lines; a heading cannot wrap;
+      // and CLAUDE.md's validation ladder relies on column alignment.
+      "tables": false,
+      "headings": false,
+      "code_blocks": false
+    }
+  },
+  "overrides": [
+    {
+      // CONTRIBUTING.md: ADR records are immutable. 0039's H1 title is 103
+      // chars and 0007:29 is a 93-char inline code span holding a Jinja
+      // conditional filename -- neither can wrap. Structural rules still
+      // apply, so new records are still checked for shape.
+      "filter": ["docs/adr/**"],
+      "config": { "MD013": false },
+      "combine": "merge"
+    }
+  ]
+}

{forge_template-0.3.2 → forge_template-0.4.0}/.pre-commit-config.yaml

@@ -1,8 +1,8 @@
 # This repo's own lint gate -- also what CI runs (see the `lint` job in
 # .github/workflows/test-template.yml). Deliberately covers template/**: the
-# whitespace/EOF hooks are how invariant 1 in CLAUDE.md (generated output
-# must be pre-commit clean) gets enforced at the source, not just discovered
-# downstream when a scaffold's own pre-commit run fails.
+# whitespace/EOF hooks are how invariant 1 in docs/invariants.md (generated
+# output must be pre-commit clean) gets enforced at the source, not just
+# discovered downstream when a scaffold's own pre-commit run fails.
 default_install_hook_types: [pre-commit, commit-msg]
 
 repos:
@@ -27,6 +27,17 @@ repos:
       - id: shellcheck
         files: ^scripts/.*\.sh$
 
+  # Not markdownlint-cli2-docker, for the same reason shellcheck-py is used
+  # above. Scope is root *.md and docs/** -- template/'s Markdown is all
+  # .md.jinja and must never be linted or auto-fixed: it is raw Jinja, and
+  # rewriting it would risk invariant 1 (docs/invariants.md).
+  - repo: https://github.com/DavidAnson/markdownlint-cli2
+    rev: v0.23.2
+    hooks:
+      - id: markdownlint-cli2
+        args: [--fix]
+        exclude: ^(template|\.github)/
+
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.14.0
     hooks:

{forge_template-0.3.2 → forge_template-0.4.0}/AGENTS.md

@@ -1 +1,3 @@
+# Agent guidance
+
 Please read `./CLAUDE.md` for context.