feat: add earsyntax toolkit monorepo

.dependency-cruiser.cjs

@@ -0,0 +1,42 @@
+/**
+ * Architecture rules for earsyntax.
+ *
+ * Package boundaries (centripetal: outer packages depend inward, never outward):
+ *
+ *   @earsyntax/core          parser, AST, linter, diagnostics. No runtime deps.
+ *   @earsyntax/cli-contract  shared report output contracts. Depends on core types.
+ *   @earsyntax/extract       requirement extraction from files. Depends on core types.
+ *   @earsyntax/cli           command-line tool. Depends on core, extract, cli-contract.
+ *
+ * core must never depend on extract, cli-contract, or cli.
+ *
+ * @type {import('dependency-cruiser').IConfiguration}
+ */
+module.exports = {
+  forbidden: [
+    {
+      name: 'no-circular',
+      severity: 'error',
+      comment: 'Circular dependencies are not allowed.',
+      from: {},
+      to: { circular: true },
+    },
+    {
+      name: 'core-stays-pure',
+      severity: 'error',
+      comment:
+        'packages/core is the deterministic parser core and must not depend on the extract, cli-contract, or cli packages.',
+      from: { path: '^packages/core/src/' },
+      to: { path: '^packages/(extract|cli-contract|cli)/src/' },
+    },
+  ],
+  options: {
+    doNotFollow: { path: 'node_modules' },
+    tsConfig: { fileName: 'tsconfig.json' },
+    tsPreCompilationDeps: true,
+    enhancedResolveOptions: {
+      exportsFields: ['exports'],
+      conditionNames: ['import', 'require', 'node', 'default'],
+    },
+  },
+};

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @omermorad

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [omermorad]

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,30 @@
+---
+name: Bug report
+about: Report a problem with the earsyntax toolkit
+title: '[bug] '
+labels: bug
+assignees: ''
+---
+
+## Describe the bug
+
+A clear description of what the bug is.
+
+## Reproduction
+
+Steps or a minimal repo that reproduces the issue.
+
+## Expected behavior
+
+What you expected to happen.
+
+## Environment
+
+- earsyntax package + version (e.g. `@earsyntax/core`):
+- Node version:
+- Package manager (npm/pnpm/yarn) + version:
+- OS:
+
+## Additional context
+
+Logs, diagnostics output, or anything else relevant.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an idea for the earsyntax toolkit
+title: '[feature] '
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+What problem are you trying to solve? What is the use case?
+
+## Proposed solution
+
+What you'd like to happen.
+
+## Alternatives considered
+
+Other approaches you've thought about.
+
+## Additional context
+
+Anything else that helps explain the request.

.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: '/'
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 10
+    commit-message:
+      prefix: chore
+      include: scope
+    groups:
+      eslint:
+        patterns:
+          - 'eslint'
+          - 'eslint-*'
+          - '@typescript-eslint/*'
+          - 'typescript-eslint'
+
+  - package-ecosystem: github-actions
+    directory: '/'
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: ci

.github/pull_request_template.md

@@ -0,0 +1,28 @@
+<!--
+PR title MUST be Conventional Commits prefixed (enforced by the "PR Title" check):
+  feat(core): add catalog glob matcher
+  fix(runners/bdd): resolve catalog source for scenario specs
+Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
+-->
+
+## Summary
+
+<!-- What does this PR change and why? -->
+
+## Type of change
+
+- [ ] Bug fix (non-breaking)
+- [ ] New feature (non-breaking)
+- [ ] Breaking change
+- [ ] Docs / tooling only
+
+## Checklist
+
+- [ ] Commits follow Conventional Commits (enforced by commitlint)
+- [ ] `pnpm lint` and `pnpm typecheck` pass
+- [ ] `pnpm build` succeeds
+- [ ] Tests added or updated where relevant
+
+## Notes for reviewers
+
+<!-- Anything reviewers should pay special attention to. -->

.github/workflows/ci.yml

@@ -0,0 +1,172 @@
+name: Continuous Integration
+
+on:
+  pull_request:
+    branches:
+      - main
+      - next
+
+permissions:
+  contents: read
+
+env:
+  PNPM_VERSION: 9.15.4
+  NODE_VERSION: 22.x
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # Typed ESLint resolves @earsyntax/* imports through each package's
+      # exports map (dist/*.d.ts), which only exists after a build.
+      - name: Build
+        run: pnpm build
+
+      - name: Lint
+        run: pnpm lint
+
+  format:
+    name: Format Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Format check
+        run: pnpm format:check
+
+  typecheck:
+    name: Typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck (build)
+        run: pnpm typecheck
+
+      - name: Typecheck (tests)
+        run: pnpm typecheck:tests
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm build
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # Cross-package test imports resolve @earsyntax/* through the exports
+      # map (dist/*.d.ts), which only exists after a build.
+      - name: Build
+        run: pnpm build
+
+      - name: Test
+        run: pnpm test
+
+  deps:
+    name: Dependency Boundaries
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Check dependency boundaries
+        run: pnpm check:deps

.github/workflows/pr-title.yml

@@ -0,0 +1,50 @@
+name: PR Title
+
+# Enforces a Conventional Commits prefix on every pull request title, e.g.
+#   feat(core): add catalog glob matcher
+#   fix(extract): resolve markdown table extraction
+# PR titles become the squash-merge commit subject, which lerna reads for
+# conventional versioning, so the title must be prefixed.
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - edited
+      - synchronize
+      - reopened
+
+permissions:
+  pull-requests: read
+
+jobs:
+  validate:
+    name: Validate PR title
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check Conventional Commits prefix
+        uses: amannn/action-semantic-pull-request@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          # Allowed types (mirror @commitlint/config-conventional).
+          types: |
+            feat
+            fix
+            docs
+            style
+            refactor
+            perf
+            test
+            build
+            ci
+            chore
+            revert
+          # Scopes are optional and free-form (e.g. core, extract, cli,
+          # cli-contract).
+          requireScope: false
+          # Subject must not start with an uppercase letter.
+          subjectPattern: ^(?![A-Z]).+$
+          subjectPatternError: |
+            The subject "{subject}" must start with a lowercase letter, following
+            Conventional Commits (e.g. "feat(core): add catalog glob matcher").