@intentius/chant-lexicon-forgejo 0.34.1 → 0.37.2

package/dist/codegen/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAoFA;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BjF"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AA0JA;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BjF"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "a1453a23ee7e01e5dc02b61f78446bf82ed62ac7f6497c39bbafe93bd5ec0246",
+    "manifest.json": "f66dd50d917a3468191e71bd35a81dcfa44e1ccd058b70d5dc143061780cbd5e",
     "meta.json": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
     "types/index.d.ts": "66204549b2a864ab5489e3f02c1878e73ab4b3c9d938cfb480b66f71543a43de",
     "rules/delegate-to-github.ts": "1060cda40f4b73d6cca3ba3fa13b80b4886147d4034c88584c2d80c5510dbe5e",
@@ -9,5 +9,5 @@
     "rules/wfj011.ts": "fcb8bf6685d744af20ad804ce929488257995c74b9a3353b2eacae3768d1c83e",
     "skills/chant-forgejo.md": "a1a560429db736c187e0b34cf8dd9efc6ad771afefcbf6f802d160d3d5274257"
   },
-  "composite": "fb3e1f92db7ac114fa05f515c85194f5a6fba951e0c695ed2f1f0de275d7ae7f"
+  "composite": "3b909700fad85d4139088988700172fb5fb7996cde47f0738de054fbd693d6b4"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "forgejo",
-  "version": "0.34.1",
+  "version": "0.37.2",
   "chantVersion": ">=0.1.0",
   "namespace": "Forgejo",
   "intrinsics": [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-forgejo",
-  "version": "0.34.1",
+  "version": "0.37.2",
   "description": "Forgejo / Codeberg / Gitea Actions lexicon for chant — a thin GitHub Actions dialect",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -53,8 +53,8 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.34.1",
-    "@intentius/chant-lexicon-github": "^0.34.1"
+    "@intentius/chant": "^0.37.2",
+    "@intentius/chant-lexicon-github": "^0.37.2"
   },
   "scripts": {
     "generate": "tsx src/codegen/generate-cli.ts",

package/src/codegen/docs.ts

@@ -82,6 +82,76 @@ takes a workflow file and returns per-property fates plus summary counts —
 read-only.
 `;
 
+const OVERVIEW_CONTENT = `\`@intentius/chant-lexicon-forgejo\` targets **Forgejo Actions** — the CI behind
+[Codeberg](https://codeberg.org), self-hosted [Forgejo](https://forgejo.org),
+and [Gitea](https://about.gitea.com). Forgejo runs **GitHub-Actions-compatible**
+workflows, so the lexicon is a **thin dialect of the [github lexicon](/chant/lexicons/github/)**
+(chant #338): every entity, composite, and expression helper is the same class
+you'd import from the github package. This package supplies only what is
+genuinely Forgejo-specific — the serializer dialect and a github → forgejo
+migration path. One package covers Codeberg, self-hosted Forgejo, and Gitea.
+
+Author exactly as you would for GitHub Actions, importing from the forgejo
+package; see [The Forgejo Dialect](/chant/lexicons/forgejo/dialect/) for what
+changes on the way out.
+
+## Build
+
+Forgejo reads workflows from \`.forgejo/workflows/\` (or \`.gitea/workflows/\` for
+Gitea), so point the output there — the same way the github lexicon targets
+\`.github/workflows/\`:
+
+\`\`\`sh
+chant build src -o .forgejo/workflows/ci.yml
+\`\`\`
+
+## Configuration
+
+Override the runner-label map and the actions root in \`chant.config.ts\`:
+
+\`\`\`ts
+import type { ChantConfig } from "@intentius/chant";
+
+export default {
+  lexicons: ["forgejo"],
+  forgejo: {
+    runnerLabels: {
+      "ubuntu-latest": "docker",
+      "ubuntu-22.04": "ubuntu-lts",
+    },
+    actionsRoot: "https://code.forgejo.org",
+  },
+} satisfies ChantConfig;
+\`\`\`
+
+## Read-only context tools
+
+The forgejo lexicon ships the full \`forgejo:*\` [read-only context tools](/chant/guide/agent-integration/#read-only-context-tools)
+(\`checks\`, \`workflow\`, \`references\`, \`affected\`, \`workflow-yaml\`, \`source\`,
+\`owns\`, \`compare\`). Each builds from source and returns what chant already
+computes — without touching any live forge.
+
+## Runtime observation
+
+N/A — workflow definitions are git-tracked, so drift is a \`git diff\`, the same
+rationale as the github and gitlab lexicons. The lexicon implements neither
+\`describeResources()\` nor \`listArtifacts()\` and is warn-skipped on \`--live\`.
+
+## Validating execution
+
+A runtime E2E (\`just forgejo-runtime-e2e\`) builds a workflow and **runs** the
+generated \`.forgejo/workflows/ci.yml\` in Docker via a Forgejo runner
+(\`forgejo-runner\` / \`act_runner\` / \`act\` \`exec\`), proving Forgejo Actions
+accepts and executes chant's output. On-demand — it needs Docker and a runner
+tool, and is not part of the gating CI.
+
+## Caveats
+
+Flow-style YAML (\`branches: [main]\`) is parsed by chant's lightweight core
+parser, which keeps it as a scalar — prefer block style in sources you intend to
+migrate. This is shared with the github import path.
+`;
+
 /**
  * Generate documentation site for the Forgejo lexicon.
  */
@@ -93,8 +163,7 @@ export async function generateDocs(options?: { verbose?: boolean }): Promise<voi
     distDir: "./dist",
     outDir: "./docs",
     basePath: process.env.DOCS_BASE_PATH ?? "/chant/lexicons/forgejo/",
-    overview:
-      "Forgejo Actions is a thin dialect of the GitHub Actions lexicon (chant #338): every entity, composite, and expression helper you write for a Forgejo workflow is the same class you'd import from the github lexicon — this package supplies only what's genuinely Forgejo-specific: the serializer dialect (dropped GitHub-only keys, `uses:` action resolution, runner-label mapping) and a github → forgejo migration path.",
+    overview: OVERVIEW_CONTENT,
     outputFormat:
       "The Forgejo lexicon serializes entities into the same YAML shape as GitHub Actions, then applies the Forgejo dialect (see [The Forgejo Dialect](/chant/lexicons/forgejo/dialect/)) before writing to `.forgejo/workflows/*.yml` (or `.gitea/workflows/*.yml` for Gitea).",
     extraPages: [