reqon-dsl 0.2.0 → 0.4.0

package/.claude/skills/reqon/references/examples.md

@@ -1,206 +0,0 @@
-# Reqon Examples
-
-## Simple API Sync
-
-```
-mission SyncUsers {
-  source API {
-    auth: bearer,
-    base: "https://api.example.com"
-  }
-
-  store users: memory("users")
-
-  action FetchUsers {
-    get "/users" {
-      paginate: page(page, 50),
-      until: length(response) == 0
-    }
-    store response -> users { key: .id }
-  }
-
-  run FetchUsers
-}
-```
-
-## Multi-File Mission Structure
-
-```
-project/
-├── mission.vague        # Main: sources, stores, schemas, pipeline
-├── fetch-data.vague     # Action: FetchData
-├── transform.vague      # Action: Transform
-└── validate.vague       # Action: Validate
-```
-
-Actions in separate files are automatically merged into the mission.
-
-## Error Handling with Match
-
-```
-action FetchWithErrorHandling {
-  get "/data"
-
-  match response {
-    [DataSchema] -> {
-      store response -> data { key: .id }
-    },
-
-    RateLimitError -> retry {
-      maxAttempts: 5,
-      backoff: exponential,
-      initialDelay: 60000
-    },
-
-    AuthError -> jump RefreshToken then retry,
-
-    NotFoundError -> abort "Resource not found",
-
-    _ -> {
-      store {
-        error: "Unexpected response",
-        response: response,
-        timestamp: now()
-      } -> errors { key: now() }
-    }
-  }
-}
-```
-
-## Data Transformation Pipeline
-
-```
-action TransformData {
-  for item in raw_items {
-    map item -> NormalizedItem {
-      id: "item_" + .id,
-      title: .name,
-      description: .body,
-      status: match .state {
-        "open" => "active",
-        "closed" => "completed",
-        _ => "unknown"
-      },
-      author: .user.login,
-      created_at: .created_at,
-      synced_at: now()
-    }
-
-    validate response {
-      assume length(.title) > 0
-      assume .id != null
-    }
-
-    store response -> normalized_items {
-      key: .id,
-      upsert: true
-    }
-  }
-}
-```
-
-## Parallel Execution
-
-```
-mission ParallelSync {
-  source GitHubAPI { auth: bearer, base: "https://api.github.com" }
-
-  store issues: memory("issues")
-  store prs: memory("prs")
-  store work_items: memory("work_items")
-
-  action FetchIssues {
-    get "/repos/{owner}/{repo}/issues"
-    store response -> issues { key: .id }
-  }
-
-  action FetchPRs {
-    get "/repos/{owner}/{repo}/pulls"
-    store response -> prs { key: .id }
-  }
-
-  action Normalize {
-    // Process both issues and PRs after parallel fetch
-    for issue in issues { ... }
-    for pr in prs { ... }
-  }
-
-  // FetchIssues and FetchPRs run in parallel, then Normalize
-  run [FetchIssues, FetchPRs] then Normalize
-}
-```
-
-## Incremental Sync
-
-```
-action IncrementalFetch {
-  get "/items" {
-    body: { "updated_after": lastSync },
-    since: lastSync
-  }
-  store response -> items { key: .id, upsert: true }
-}
-```
-
-## Dead Letter Queue Pattern
-
-```
-action ProcessWithDLQ {
-  for item in pending {
-    post "/process/{item.id}"
-
-    match response {
-      SuccessSchema -> {
-        store response -> completed { key: .id }
-      },
-
-      TransientError -> retry {
-        maxAttempts: 3,
-        backoff: exponential,
-        initialDelay: 1000
-      },
-
-      // After retries exhausted or permanent error, queue for later
-      _ -> queue dead_letter_queue
-    }
-  }
-}
-```
-
-## Conditional Processing
-
-```
-action ProcessConditionally {
-  for payment in pending_payments
-    where not exists(fraud_queue[payment.id]) {
-
-    post "/payments/{payment.id}/capture"
-
-    match response {
-      PaymentSuccess -> {
-        store response -> completed { key: .id }
-      },
-      _ -> skip
-    }
-  }
-}
-```
-
-## OpenAPI Integration
-
-```
-mission OpenAPIExample {
-  source API from "./openapi.yaml" {
-    auth: bearer,
-    base: "https://api.example.com"
-  }
-
-  action FetchUsers {
-    // Use operation ID from OpenAPI spec
-    call API.listUsers { query: { limit: 100 } }
-    store response -> users { key: .id }
-  }
-
-  run FetchUsers
-}
-```

package/.claude/skills/reqon/references/syntax.md

@@ -1,263 +0,0 @@
-# Reqon DSL Syntax Reference
-
-## Mission Structure
-
-```
-mission MissionName {
-  // Sources (API connections)
-  source SourceName { ... }
-
-  // Stores (data persistence)
-  store storeName: type("identifier")
-
-  // Schemas (type definitions)
-  schema SchemaName { ... }
-
-  // Actions (pipeline steps)
-  action ActionName { ... }
-
-  // Pipeline execution
-  run ActionA then ActionB
-}
-```
-
-## Sources
-
-### Authentication Types
-
-```
-// Bearer token (from env var)
-source API {
-  auth: bearer,
-  base: "https://api.example.com",
-  headers: { "Accept": "application/json" }
-}
-
-// API key
-source API {
-  auth: api_key,
-  base: "https://api.example.com"
-}
-
-// Basic auth
-source API {
-  auth: basic,
-  base: "https://api.example.com"
-}
-
-// OAuth2
-source API {
-  auth: oauth2,
-  base: "https://api.example.com",
-  oauth: {
-    tokenUrl: "https://auth.example.com/token",
-    clientId: env("CLIENT_ID"),
-    clientSecret: env("CLIENT_SECRET"),
-    scopes: ["read", "write"]
-  }
-}
-```
-
-### Rate Limiting
-
-```
-source API {
-  auth: bearer,
-  base: "https://api.example.com",
-  rateLimit: {
-    strategy: "pause",    // or "queue"
-    maxWait: 60,          // seconds
-    fallbackRpm: 60       // requests per minute fallback
-  }
-}
-```
-
-## Stores
-
-```
-store items: memory("items")           // In-memory
-store items: file("./data/items.json") // File-based
-store items: sql("items_table")        // SQL database
-```
-
-## Schemas
-
-```
-schema User {
-  id: int,
-  name: string,
-  email: string?,       // Optional field
-  created_at: date,
-  tags: array,
-  metadata: object
-}
-```
-
-Supported types: `int`, `string`, `boolean`, `decimal`, `date`, `array`, `object`
-
-## HTTP Operations
-
-### Basic Fetch
-
-```
-get "/users"
-post "/users" { body: { "name": "John" } }
-put "/users/{id}" { body: { "name": "Jane" } }
-delete "/users/{id}"
-```
-
-### Full Options
-
-```
-get "/users" {
-  source: APISource,
-  body: { "status": "active" },
-  headers: { "X-Custom": "value" },
-
-  // Pagination
-  paginate: page(page, 100),           // Page-based
-  paginate: cursor(.next_cursor),      // Cursor-based
-  paginate: offset(offset, 50),        // Offset-based
-
-  until: length(response) == 0,        // Stop condition
-
-  // Retry configuration
-  retry: {
-    maxAttempts: 3,
-    backoff: "exponential",  // or "constant", "linear"
-    initialDelay: 1000,      // ms
-    maxDelay: 60000          // ms
-  },
-
-  // Incremental sync
-  since: lastSync
-}
-```
-
-## Pattern Matching
-
-```
-match response {
-  // Match array of schema type
-  [UserSchema] -> { store response -> users { key: .id } },
-
-  // Match single schema type
-  ErrorSchema -> abort "API error",
-
-  // Match with condition
-  _ where .status == "rate_limited" -> retry { maxAttempts: 3 },
-
-  // Wildcard
-  _ -> skip
-}
-```
-
-## Loops and Iteration
-
-```
-// Basic loop
-for user in users {
-  // process each user
-}
-
-// Loop with filter
-for user in users where .active == true {
-  // process only active users
-}
-
-// Loop with complex filter
-for item in items where .status == "pending" and .priority > 5 {
-  // process filtered items
-}
-```
-
-## Mapping
-
-```
-map input -> OutputSchema {
-  id: .id,
-  fullName: .firstName + " " + .lastName,
-  status: match .state {
-    "active" => "enabled",
-    "inactive" => "disabled",
-    _ => "unknown"
-  },
-  createdAt: .created_at,
-  tags: .labels
-}
-```
-
-## Validation
-
-```
-validate response {
-  assume length(.name) > 0
-  assume .age >= 0
-  assume .email contains "@"
-}
-```
-
-## Store Operations
-
-```
-// Basic store
-store response -> items { key: .id }
-
-// Upsert mode
-store response -> items { key: .id, upsert: true }
-
-// Partial update
-store response -> items { key: .id, partial: true }
-```
-
-## Pipeline Execution
-
-```
-// Sequential
-run ActionA then ActionB then ActionC
-
-// Parallel then sequential
-run [ActionA, ActionB] then ActionC
-
-// Multiple parallel groups
-run [ActionA, ActionB] then [ActionC, ActionD] then ActionE
-```
-
-## Flow Control Directives
-
-| Directive | Description |
-|-----------|-------------|
-| `continue` | Proceed to next step |
-| `skip` | Skip current loop item |
-| `abort "msg"` | Stop mission with error |
-| `retry {...}` | Retry current operation |
-| `queue storeName` | Send to dead letter queue |
-| `jump ActionName then retry` | Execute action then retry |
-
-## Built-in Functions
-
-- `length(array)` - Array length
-- `now()` - Current timestamp
-- `env("VAR_NAME")` - Environment variable
-- `exists(store[key])` - Check if key exists in store
-
-## Expressions
-
-```
-// Arithmetic
-.price * .quantity
-.total + .tax
-
-// String concatenation
-.firstName + " " + .lastName
-"prefix_" + .id
-
-// Comparisons
-.age >= 18
-.status == "active"
-.count > 0 and .count < 100
-
-// Property access
-.user.name
-.items[0].id
-```

package/.claude/skills/vscode-extension.md

@@ -1,113 +0,0 @@
-# VS Code Extension Skill
-
-Use this skill when creating or enhancing VS Code support for Reqon's `.vague` files.
-
-## Capabilities
-
-### TextMate Grammar
-Create syntax highlighting for `.vague` files:
-- Keywords: mission, source, store, action, fetch, map, validate, run, then, for, in, where, match, assume
-- Auth types: oauth2, bearer, basic, api_key
-- Store types: memory, sql, nosql
-- Operators: ->, =, :, |
-- Strings, numbers, identifiers
-- Comments
-
-### Language Server Protocol (LSP)
-Implement language intelligence:
-- Syntax error diagnostics
-- Hover information for keywords
-- Go to definition for actions/missions
-- Autocomplete for keywords and identifiers
-- Document symbols outline
-
-### Snippet Generation
-Create snippets for common patterns:
-- Mission template
-- Source definition
-- Store definition
-- Fetch with pagination
-- Map transformation
-- Validate block
-
-## Context Files
-When using this skill, read:
-- `src/lexer/tokens.ts` - All token types and keywords
-- `src/ast/nodes.ts` - AST structure for symbols
-- `src/parser/parser.ts` - Syntax rules
-
-## Implementation Patterns
-
-### TextMate Grammar Structure
-```json
-{
-  "name": "Vague",
-  "scopeName": "source.vague",
-  "fileTypes": ["vague"],
-  "patterns": [
-    { "include": "#keywords" },
-    { "include": "#strings" },
-    { "include": "#comments" }
-  ],
-  "repository": {
-    "keywords": {
-      "match": "\\b(mission|source|store|action|fetch|map|validate|run|then|for|in|where|match|assume)\\b",
-      "name": "keyword.control.vague"
-    }
-  }
-}
-```
-
-### Extension package.json
-```json
-{
-  "name": "vague-vscode",
-  "displayName": "Vague",
-  "contributes": {
-    "languages": [{
-      "id": "vague",
-      "extensions": [".vague"],
-      "configuration": "./language-configuration.json"
-    }],
-    "grammars": [{
-      "language": "vague",
-      "scopeName": "source.vague",
-      "path": "./syntaxes/vague.tmLanguage.json"
-    }]
-  }
-}
-```
-
-### Snippet Format
-```json
-{
-  "Mission": {
-    "prefix": "mission",
-    "body": [
-      "mission ${1:Name} {",
-      "  source ${2:api} {",
-      "    url: \"${3:https://api.example.com}\"",
-      "    auth: ${4:bearer} { token: \"${5:\\$API_TOKEN}\" }",
-      "  }",
-      "",
-      "  action ${6:FetchData} {",
-      "    fetch ${7:/endpoint}",
-      "  }",
-      "}"
-    ]
-  }
-}
-```
-
-## Directory Structure
-```
-vague-vscode/
-├── package.json
-├── language-configuration.json
-├── syntaxes/
-│   └── vague.tmLanguage.json
-├── snippets/
-│   └── vague.json
-└── src/
-    └── extension.ts  # LSP client
-```

package/.github/dependabot.yml

@@ -1,32 +0,0 @@
-version: 2
-updates:
-  # npm dependencies
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-      day: "monday"
-    open-pull-requests-limit: 10
-    commit-message:
-      prefix: "deps"
-    groups:
-      dev-dependencies:
-        dependency-type: "development"
-        patterns:
-          - "*"
-      production-dependencies:
-        dependency-type: "production"
-        patterns:
-          - "*"
-        exclude-patterns:
-          - "vague-lang"
-
-  # GitHub Actions
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-      day: "monday"
-    open-pull-requests-limit: 5
-    commit-message:
-      prefix: "ci"

package/.github/pull_request_template.md

@@ -1,21 +0,0 @@
-## Description
-
-<!-- Brief description of changes -->
-
-## Type of Change
-
-- [ ] Bug fix (non-breaking change fixing an issue)
-- [ ] New feature (non-breaking change adding functionality)
-- [ ] Breaking change (fix or feature causing existing functionality to change)
-- [ ] Documentation update
-
-## Checklist
-
-- [ ] Tests pass locally (`npm run test:run`)
-- [ ] Build succeeds (`npm run build`)
-- [ ] Code follows project conventions
-- [ ] Self-reviewed the changes
-
-## Related Issues
-
-<!-- Link any related issues: Fixes #123, Closes #456 -->