feat: initial @keito-ai/sdk implementation

Auto-generated Node.js SDK for the Keito API with:
- Type generation from OpenAPI v2 spec via openapi-typescript
- Resource-based client (timeEntries, expenses, projects, clients,
  contacts, tasks, users, invoices, reports, outcomes)
- HTTP core with retries, exponential backoff, typed error hierarchy
- Auto-pagination with async iterator support
- Outcome-based billing convenience layer (F7-F9)
- Unit tests (33 passing across 5 suites)
- CI/CD: test matrix, release-please auto-versioning, npm publish
- Dual ESM + CJS output via tsup, zero runtime dependencies

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sionsmith

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci
+      - run: npm run generate
+      - run: npm run typecheck
+      - run: npm test
+      - run: npm run build

.github/workflows/generate.yml

@@ -0,0 +1,66 @@
+name: Regenerate Types
+
+on:
+  repository_dispatch:
+    types: [openapi-spec-updated]
+  workflow_dispatch:
+    inputs:
+      spec_repo:
+        description: "Repo to fetch spec from (owner/repo)"
+        default: "osodevops/keito"
+      spec_path:
+        description: "Path to spec in repo"
+        default: "docs/openapi-v2.yaml"
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  generate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+
+      - name: Fetch latest spec
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          REPO="${{ github.event.inputs.spec_repo || 'osodevops/keito' }}"
+          SPEC_PATH="${{ github.event.inputs.spec_path || 'docs/openapi-v2.yaml' }}"
+          gh api "repos/${REPO}/contents/${SPEC_PATH}" \
+            --jq '.content' | base64 -d > openapi/openapi-v2.yaml
+
+      - run: npm run generate
+      - run: npm run typecheck
+      - run: npm test
+
+      - name: Check for changes
+        id: diff
+        run: |
+          if git diff --quiet openapi/ src/generated/; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create PR
+        if: steps.diff.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          branch: chore/regenerate-types
+          commit-message: "chore: regenerate types from updated OpenAPI spec"
+          title: "chore: regenerate types from updated OpenAPI spec"
+          body: |
+            Auto-generated PR from updated OpenAPI spec.
+
+            - Fetched latest spec from upstream
+            - Regenerated `src/generated/openapi.d.ts`
+            - Type checking and tests pass
+
+            Review the diff and merge to trigger a release.

.github/workflows/release-please.yml

@@ -0,0 +1,44 @@
+name: Release Please
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          release-type: node
+
+  publish:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          registry-url: https://registry.npmjs.org
+      - run: npm ci
+      - run: npm run generate
+      - run: npm run typecheck
+      - run: npm test
+      - run: npm run build
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+.DS_Store
+*.tsbuildinfo
+.env
+.env.*

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}