feat: add basic-astro extractor (#30)

Astro files speak. Archlette listens.

Extract architecture from .astro components. Each file becomes a component.
Frontmatter JSDoc defines actors. Imports create relationships.

Supports:
- Component detection from file structure and JSDoc tags
- Actor extraction from @Actor annotations
- Relationship mapping from imports and @uses tags
- Code element extraction from frontmatter (classes, functions, types)

Astro components map to C4 components. Natural fit.
No special handling for islands. Pure architectural extraction.

Completes the JavaScript/TypeScript extraction trilogy:
basic-node, basic-wrangler, basic-astro.

Author: chrislyons-dev

.github/workflows/cd.yml

@@ -24,6 +24,7 @@ jobs:
       - run: npm run lint
       - run: npm run typecheck
       - run: npm test
+      - run: npm run build
       - name: Publish
         run: npm publish --access public --provenance
         env:

README.md

@@ -3,6 +3,7 @@
 > **Code speaks. Archlette listens. Architecture evolves.**
 
 [![npm version](https://img.shields.io/npm/v/@chrislyons-dev/archlette?color=blue&logo=npm)](https://www.npmjs.com/package/@chrislyons-dev/archlette)
+[![npm downloads](https://img.shields.io/npm/dm/@chrislyons-dev/archlette?color=blue)](https://www.npmjs.com/package/@chrislyons-dev/archlette)
 [![CI](https://github.com/chrislyons-dev/archlette/actions/workflows/ci.yml/badge.svg)](https://github.com/chrislyons-dev/archlette/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
@@ -35,14 +36,18 @@ See Archlette documenting itself: [architecture docs](docs/architecture/README.m
 npm install -D @chrislyons-dev/archlette
 ```
 
-**Requirements:** Node.js ≥ 18, Java ≥ 11
+**Requirements:** Node.js ≥ 18 (Node 20+ recommended), Java ≥ 11
 
 **Free and open-source** — MIT licensed. No accounts, no telemetry, no lock-in.
 
 See [Installation Guide](https://chrislyons-dev.github.io/archlette/getting-started/installation/) for platform-specific setup.
 
 ### Annotate
 
+Works with **TypeScript, JavaScript, and Astro** components:
+
+**TypeScript/JavaScript:**
+
 ```typescript
 /**
  * @module UserService
@@ -58,6 +63,31 @@ export class UserService {
 }
 ```
 
+**Astro Components:**
+
+```astro
+---
+/**
+ * @component Button
+ * Reusable button component with multiple variants
+ *
+ * @uses Icon Displays button icon
+ * @actor User {Person} {in} Clicks button to trigger action
+ */
+
+interface Props {
+  variant?: 'primary' | 'secondary';
+  disabled?: boolean;
+}
+
+const { variant = 'primary', disabled = false } = Astro.props;
+---
+
+<button class={`btn btn-${variant}`} disabled={disabled}>
+  <slot />
+</button>
+```
+
 ### Configure
 
 Create `.aac.yaml`:
@@ -69,9 +99,14 @@ project:
 extractors:
   - use: extractors/builtin/basic-node
     inputs:
-      include: ['src/**/*.ts']
+      include: ['src/**/*.ts', 'src/**/*.js']
+  - use: extractors/builtin/basic-astro
+    inputs:
+      include: ['src/**/*.astro']
 ```
 
+**Note:** Use `basic-node` for TypeScript/JavaScript files and `basic-astro` for Astro components. Both produce compatible IR for aggregation.
+
 ### Generate
 
 ```bash
@@ -118,6 +153,48 @@ npx archlette
 
 ---
 
+## Extractors
+
+Archlette includes built-in extractors for multiple languages:
+
+### basic-node
+
+Extracts architecture from **TypeScript and JavaScript** codebases using AST analysis with ts-morph.
+
+- Detects components from directory structure or explicit `@component` tags
+- Extracts classes, functions, types, and interfaces
+- Parses JSDoc annotations for actors and relationships
+- Identifies dependencies from import statements
+
+**When to use:** TypeScript/JavaScript projects, Node.js backends, frontend libraries
+
+### basic-astro
+
+Extracts architecture from **Astro components** using the Astro compiler.
+
+- Identifies components from Astro file names or `@component` tags
+- Extracts component props, slots, and client directives
+- Parses frontmatter code for additional type information
+- Detects component composition from template markup
+- Works seamlessly with basic-node for full-stack analysis
+
+**When to use:** Astro-based projects, island architecture, mixed TypeScript + Astro applications
+
+### basic-python
+
+Extracts architecture from **Python** codebases using AST parsing (no runtime required).
+
+- Supports Python 3.8+ syntax
+- Detects classes, functions, and dependencies
+
+**When to use:** Python projects, data science applications, mixed-language monorepos
+
+### custom-extractors
+
+Write your own extractor to support additional languages or frameworks. See [Plugin Development](https://chrislyons-dev.github.io/archlette/plugins/extractors/).
+
+---
+
 ## Features
 
 **Pipeline:**

THIRD_PARTY_LICENSES.md

@@ -36,7 +36,7 @@ The following packages are installed as production dependencies via `package.jso
 ### NPM Dependencies Summary
 
 ```
-├─ MIT: 76
+├─ MIT: 77
 ├─ ISC: 10
 ├─ BSD-3-Clause: 2
 ├─ Apache-2.0: 1
@@ -61,4 +61,4 @@ This script:
 
 ---
 
-**Last generated**: 2025-10-26
+**Last generated**: 2025-10-28

archlette.config.yaml

@@ -34,6 +34,22 @@ extractors:
         - '/users/chris/git/bond-math/iac/workers/pricing.toml'
         - '/users/chris/git/bond-math/iac/workers/valuation.toml'
 
+  - use: extractors/builtin/basic-astro
+    inputs:
+      include:
+        - '/users/chris/git/bond-math/ui/**/*.astro'
+      exclude:
+        - '**/*.test.astro'
+        - '**/.astro/**'
+        - '**/dist/**'
+        - '**/build/**'
+        - '**/node_modules/**'
+        - '**/*.test.*'
+        - '**/*.spec.*'
+        - '**/test/**'
+        - '**/tests/**'
+        - '**/vitest.config.ts'
+
   - use: extractors/builtin/basic-node
     inputs:
       include:
@@ -45,6 +61,8 @@ extractors:
         - '/users/chris/git/bond-math/ui/**/*.tsx'
       exclude:
         - '**/node_modules/**'
+        - '**/dist/**'
+        - '**/build/**'
         - '**/*.test.*'
         - '**/*.spec.*'
         - '**/test/**'
@@ -60,6 +78,8 @@ extractors:
         - '/users/chris/git/bond-math/services/gateway/**/*.tsx'
       exclude:
         - '**/node_modules/**'
+        - '**/dist/**'
+        - '**/build/**'
         - '**/*.test.*'
         - '**/*.spec.*'
         - '**/test/**'
@@ -75,6 +95,8 @@ extractors:
         - '/users/chris/git/bond-math/services/daycount/**/*.tsx'
       exclude:
         - '**/node_modules/**'
+        - '**/dist/**'
+        - '**/build/**'
         - '**/*.test.*'
         - '**/*.spec.*'
         - '**/test/**'
@@ -93,6 +115,10 @@ extractors:
         - '**/*.venv/***'
         - '**/test/**'
         - '**/tests/**'
+        - '**/flarelette/**'
+        - '**/dateutil/**'
+        - '**/pythonjsonlogger/**'
+        - '**/six.py'
 
 # ir json in, ir json out (or errors)
 validators: