@squadbase/vantage-template 0.1.0-dev.47d956c → 0.1.0-dev.55898c0

package/base-template/package.json

@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "@squadbase/react": "^0.1.0",
-    "@squadbase/vantage": "^0.5.3",
+    "@squadbase/vantage": "0.6.0-dev.3cc6138",
     "@squadbase/vantage-sdk": "^0.1.0",
     "date-fns": "^4.1.0",
     "lucide-react": "^0.468.0",

package/base-template/pipelines/pyproject.toml

@@ -0,0 +1,5 @@
+[project]
+name = "pipelines"
+version = "0.1.0"
+requires-python = ">=3.11"
+dependencies = ["adamas>=0.2.0", "pandas", "requests"]

package/base-template/squadbase.yml

@@ -3,3 +3,4 @@ version: "1"
 build:
   framework: squadbase-vantage
   runtime: node20
+  package_manager: bun

package/dist/index.js

@@ -1022,27 +1022,36 @@ function initProject(options) {
     applyChartPreset(targetDir, options.chart);
     log("cyan", `  chart preset: ${options.chart}`);
   }
+  const packageManager = isBunAvailable() ? "bun" : "npm";
   if (options.skipInstall) {
     log("green", "\nProject initialized successfully!");
     log("dim", "\nNext steps:");
-    log("dim", "  npm install");
-    log("dim", "  npm run dev");
+    log("dim", `  ${packageManager} install`);
+    log("dim", `  ${packageManager} run dev`);
     return;
   }
-  log("green", "\nInstalling dependencies...");
-  const install = spawnSync("npm", ["install"], {
+  log("green", `
+Installing dependencies with ${packageManager}...`);
+  const install = spawnSync(packageManager, ["install"], {
     cwd: targetDir,
     stdio: "inherit",
     shell: process.platform === "win32"
   });
   if (install.error || install.status !== 0) {
     log("red", "\nDependency installation failed.");
-    log("yellow", "Run 'npm install' manually in the project directory.");
+    log("yellow", `Run '${packageManager} install' manually in the project directory.`);
     process.exit(1);
   }
   log("green", "\nProject initialized successfully!");
   log("dim", "\nNext steps:");
-  log("dim", "  npm run dev");
+  log("dim", `  ${packageManager} run dev`);
+}
+function isBunAvailable() {
+  const probe = spawnSync("bun", ["--version"], {
+    stdio: "ignore",
+    shell: process.platform === "win32"
+  });
+  return !probe.error && probe.status === 0;
 }
 
 // src/commands/list.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squadbase/vantage-template",
-  "version": "0.1.0-dev.47d956c",
+  "version": "0.1.0-dev.55898c0",
   "description": "CLI tool for initializing and customizing Squadbase Vantage projects.",
   "keywords": [
     "squadbase",
@@ -42,7 +42,7 @@
     "type-check": "tsc",
     "agents": "node scripts/build-agents.cjs",
     "agents:check": "node scripts/build-agents.cjs --check",
-    "template:install": "npm --prefix template ci",
+    "template:install": "bun install --cwd template --frozen-lockfile",
     "template:build": "npm --prefix template run build",
     "prepublishOnly": "npm run agents:check && npm run build",
     "release": "npm publish --@squadbase:registry=https://registry.npmjs.org",

package/base-template/.squadbase/skills/adamas-automation/SKILL.md

@@ -1,118 +0,0 @@
----
-name: adamas-automation
-description: automation(データパイプライン)の作り方。automation/<name>/ のファイル配置、automation.yml v1 の書き方(GitHub Actions サブセット)、adamas @task / outputs / partition の宣言 API、実行と検証の流れ(lintAutomations → runAutomation dryRun → 本実行)。外部データを定期的に取り込んで Squadbase DB に同期するパイプラインを作る・直すときに参照する。
----
-
-# Automation(adamas データパイプライン)
-
-外部データを定期取得して project の Squadbase DB へ同期するパイプライン。定義の正本は
-この repo の `automation/` ディレクトリで、コミットすると platform に自動同期される。
-ダッシュボード(`src/`)とは独立していて、互いのファイルには触れない。
-
-## ファイル配置
-
-```
-automation/
-├── pyproject.toml       # 共有 Python 環境(全 automation で 1 つ)。依存は `uv add`
-├── uv.lock
-└── <name>/              # automation 名 = ディレクトリ名 = ^[a-z0-9][a-z0-9_-]{0,63}$
-    ├── automation.yml   # 宣言(トリガ・ステップ)。1 automation = 1 ファイル
-    └── tasks.py         # adamas @task の実装(pipeline step が暗黙に読む。ファイル名固定)
-```
-
-- 初回だけ `automation/pyproject.toml` を作り `uv add adamas` する(全 automation で共有。
-  automation ごとに venv を作らない)
-- `automation/` が無いディレクトリ構成でも、上の形で新規作成すればよい
-
-## automation.yml v1 — GitHub Actions のサブセット
-
-GHA ワークフロー YAML の意味論をそのまま使う。**GHA との差分は次の 7 点だけ**。
-それ以外の書き方(`on:` / `steps:` / `- id:` / `if:` / `${{ }}` / `steps.<id>.outputs.<name>`)
-は GHA の知識どおりに書く:
-
-| # | 差分 |
-|---|---|
-| 1 | step は `uses:`/`run:` でなく型付きキー 1 個(`pipeline` / `agent` / `query` / `write` / `notify`)。v1 で実行できるのは `pipeline` のみ(他は宣言だけで UI に載る) |
-| 2 | `on.schedule` は単一オブジェクトで `timezone` / `enabled` を持つ(cron 配列は不可) |
-| 3 | 手動トリガは `on.manual`(GHA の `workflow_dispatch` の改名) |
-| 4 | inputs の `type` は `string | boolean | daterange` の 3 種 |
-| 5 | 式 `${{ }}` は dot 参照のみ(関数・演算子・パイプは不可)。context は `trigger.inputs.<name>` と `steps.<id>.outputs.<name>` だけ。前方・自己参照は不可 |
-| 6 | pipeline step のタスク実体は同ディレクトリ `tasks.py` 固定(automation 1 個につき pipeline step は最大 1) |
-| 7 | pipeline step に `destination`(取り込み先 Squadbase DB の connection uuid)を書ける。省略時は project 唯一の Squadbase DB が既定 |
-
-例(実行可能な最小形):
-
-```yaml
-version: 1
-name: Daily ad spend sync
-on:
-  schedule: { cron: "0 6 * * *", timezone: Asia/Tokyo }
-  manual:
-    inputs:
-      backfill: { type: daterange, required: false }
-steps:
-  - id: sync
-    pipeline:
-      backfill: ${{ trigger.inputs.backfill }}
-      connections:                 # ctx.connection(name) で使う接続の配線(任意)
-        warehouse: <connection-uuid>
-```
-
-- スケジュールは年 2 回以上の頻度が必要(それ未満は同期時に拒否される)
-- `agent` / `query` / `write` / `notify` step を含む automation はスケジュール実行できない
-  (宣言と UI 表示のみ)
-
-## tasks.py — adamas の宣言 API
-
-```python
-from adamas import task, output, by_date, source
-
-@task(
-    name="ad-spend",                       # 出力データセット名(省略時は関数名)
-    table="ad_spend",                      # Squadbase DB のテーブル名
-    pk=["date", "campaign_id"],            # upsert / ignore では必須
-    mode="upsert",                         # append | ignore(先勝ち) | upsert(後勝ち)
-    schema={"date": "string", "campaign_id": "string", "cost": "float64"},
-    partition=by_date("2026-01-01"),       # 1 日 1 パーティション(付けると増分実行になる)
-    inputs=[source.connection("warehouse")],
-)
-def ad_spend(ctx):
-    date = ctx.partition.inputs["date"]    # 自分のスライスは ctx.partition.inputs から読む
-    conn = ctx.connection("warehouse")     # automation.yml の connections で配線した接続
-    yield from conn.query(
-        f"SELECT ... WHERE date = '{date}'", chunk_rows=10_000
-    )
-```
-
-押さえること:
-
-- 戻り値は pandas/polars DataFrame・pyarrow Table、またはそれらの yield(チャンクで
-  メモリ有界にする)。複数出力は `outputs={...}` + `yield ("<dataset>", chunk)`
-- `schema` は Parquet 型を固定する列型宣言。**schema の無い出力は Squadbase DB へ
-  取り込まれない**ので必ず書く。pk 列は schema に含める
-- partition プランは `by_date(start)`(日次)か `by_list(keys)`(キー列挙)。
-  partition 付きタスクは単一出力
-- 1 テーブル 1 書き手(別タスクが同じテーブルを書くとエラー)
-- 抽出・再試行・冪等性(どこまで取ったか)は adamas と台帳が管理する。自前で
-  チェックポイントや重複排除を実装しない
-
-## 検証と実行の流れ
-
-1. ファイルを作成・編集したら **`lintAutomations`** で検証し、指摘を直す
-2. **`runAutomation` を `dryRun: true` で実行**(オフライン: ローカル一時ディレクトリに
-   書き、platform の台帳・ストレージには何も書かない)。まず 1 パーティションだけ
-   `partitions: ["2026-01-01"]` のように絞ると速い
-3. コミットすると宣言が platform に自動同期され、スケジュールが有効になる
-4. 本実行(`dryRun` なし)はユーザーがデータを求めたときだけ。結果の `adamasStatus` に
-   タスクごとの done / failed / outstanding と失敗の内訳(error / category)が載るので、
-   それを根拠に報告・修正する
-5. 失敗を直したら `retryFailed: true` で失敗パーティションだけ再実行。過去範囲の
-   取り直しは `backfill: "START:END"`(両端含む)
-
-## 落とし穴
-
-- automation 名にハイフンは使えるが、Python module 名には使わない(module は常に
-  `tasks.py` 固定なので気にしなくてよい)
-- `${{ }}` に式や関数を書かない(`| length > 0` などの Jinja 方言は不可)
-- cron は 5 フィールド・64 文字以内
-- `automation.yml` に未知のキーを書くと lint エラー(黙って無視されない)