@project-ajax/create 0.0.32 → 0.0.34

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@project-ajax/create",
-	"version": "0.0.32",
+	"version": "0.0.34",
 	"description": "Initialize a new Notion Project Ajax extensions repo.",
 	"bin": {
 		"create-ajax": "dist/index.js"
@@ -23,7 +23,8 @@
 	},
 	"files": [
 		"dist/",
-		"template/"
+		"template/",
+		"template/.gitignore"
 	],
 	"dependencies": {
 		"@inquirer/prompts": "^8.0.1",

package/template/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+workers.json
+workers.*.json

package/template/AGENTS.md

@@ -55,7 +55,6 @@ Syncs run in a "sync cycle": a back-to-back chain of `execute` calls that starts
 - `mode=replace` is simpler, and fine for smaller syncs (<10k)
 - Use `mode=incremental` when the sync could return a lot of data (>10k), eg for SaaS tools like Salesforce or Stripe
 - When using `mode=incremental`, emit delete markers as needed if easy to do (below)
-- Use `Pacer.wait` to respect upstream rate limits during `execute` calls; pick a stable key per API or endpoint.
 
 **Sync strategy (`mode`):**
 - `replace`: each sync cycle must return the full dataset. After the final `hasMore: false`, any records not seen during that cycle are deleted.
@@ -166,6 +165,32 @@ worker.sync("tasksSync", {
 - `npx workers auth login [--env=dev]`: connect to a Notion workspace.
 - `npx workers deploy`: build and publish capabilities.
 - `npx workers exec <capability>`: run a sync or tool.
+- `npx workers pack`: create a tarball; uses Git when available (respects `.gitignore`), always skips `node_modules`, `dist`, `workers.json`, `workers.*.json`, `.env`, and `.env.*`, and works in non-git repos.
+
+## Debugging & Monitoring Runs
+Use `npx workers runs` to inspect run history and logs.
+
+**List recent runs:**
+```shell
+npx workers runs list
+```
+
+**Get logs for a specific run:**
+```shell
+npx workers runs logs <runId>
+```
+
+**Get logs for the latest run (any capability):**
+```shell
+npx workers runs list --plain | head -n1 | cut -f1 | xargs npx workers runs logs
+```
+
+**Get logs for the latest run of a specific capability:**
+```shell
+npx workers runs list --plain | grep tasksSync | head -n1 | cut -f1 | xargs npx workers runs logs
+```
+
+The `--plain` flag outputs tab-separated values without formatting, making it easy to pipe to other commands.
 
 ## Coding Style & Naming Conventions
 - TypeScript with `strict` enabled; keep types explicit when shaping I/O.

package/template/CLAUDE.md

@@ -55,7 +55,6 @@ Syncs run in a "sync cycle": a back-to-back chain of `execute` calls that starts
 - `mode=replace` is simpler, and fine for smaller syncs (<10k)
 - Use `mode=incremental` when the sync could return a lot of data (>10k), eg for SaaS tools like Salesforce or Stripe
 - When using `mode=incremental`, emit delete markers as needed if easy to do (below)
-- Use `Pacer.wait` to respect upstream rate limits during `execute` calls; pick a stable key per API or endpoint.
 
 **Sync strategy (`mode`):**
 - `replace`: each sync cycle must return the full dataset. After the final `hasMore: false`, any records not seen during that cycle are deleted.
@@ -166,6 +165,32 @@ worker.sync("tasksSync", {
 - `npx workers auth login [--env=dev]`: connect to a Notion workspace.
 - `npx workers deploy`: build and publish capabilities.
 - `npx workers exec <capability>`: run a sync or tool.
+- `npx workers pack`: create a tarball; uses Git when available (respects `.gitignore`), always skips `node_modules`, `dist`, `workers.json`, `workers.*.json`, `.env`, and `.env.*`, and works in non-git repos.
+
+## Debugging & Monitoring Runs
+Use `npx workers runs` to inspect run history and logs.
+
+**List recent runs:**
+```shell
+npx workers runs list
+```
+
+**Get logs for a specific run:**
+```shell
+npx workers runs logs <runId>
+```
+
+**Get logs for the latest run (any capability):**
+```shell
+npx workers runs list --plain | head -n1 | cut -f1 | xargs npx workers runs logs
+```
+
+**Get logs for the latest run of a specific capability:**
+```shell
+npx workers runs list --plain | grep tasksSync | head -n1 | cut -f1 | xargs npx workers runs logs
+```
+
+The `--plain` flag outputs tab-separated values without formatting, making it easy to pipe to other commands.
 
 ## Coding Style & Naming Conventions
 - TypeScript with `strict` enabled; keep types explicit when shaping I/O.

package/template/README.md

@@ -171,33 +171,6 @@ changes: [
 ]
 ```
 
-#### Respect rate limits
-
-
-If the source API has a rate limit, call `Pacer.wait` inside `execute` to pace requests (for example, 10 requests per minute):
-
-```ts
-import { Pacer } from "@project-ajax/sdk/pacer";
-
-worker.sync("tasksSync", {
-  primaryKeyProperty: "ID",
-  schema: { defaultName: "Tasks", properties: { Name: Schema.title(), ID: Schema.richText() } },
-  execute: async () => {
-    const oneMinute = 60 * 1000;
-    await Pacer.wait("tasks-api", { requests: 10, intervalMs: oneMinute });
-    const items = await fetchTasks();
-    return {
-      changes: items.map((item) => ({
-        type: "upsert",
-        key: item.id,
-        properties: { Name: Builder.title(item.name), ID: Builder.richText(item.id) },
-      })),
-      hasMore: false,
-    };
-  },
-});
-```
-
 ### Tool
 
 Tools are callable by Notion custom agents.
@@ -367,6 +340,12 @@ List recent runs:
 npx workers runs list
 ```
 
+Use `--plain` for machine-readable tab-separated output:
+
+```shell
+npx workers runs list --plain
+```
+
 ### `npx workers runs logs`
 Fetch logs for a run:
 
@@ -374,6 +353,18 @@ Fetch logs for a run:
 npx workers runs logs <runId>
 ```
 
+Get logs for the latest run (any capability):
+
+```shell
+npx workers runs list --plain | head -n1 | cut -f1 | xargs npx workers runs logs
+```
+
+Get logs for the latest run of a specific capability:
+
+```shell
+npx workers runs list --plain | grep tasksSync | head -n1 | cut -f1 | xargs npx workers runs logs
+```
+
 ### `npx workers bundle download`
 Download the deployed bundle:
 

package/template/package.json

@@ -1,14 +1,10 @@
 {
 	"name": "@project-ajax/template",
 	"version": "0.0.0",
-	"main": "dist/index.js",
 	"private": true,
 	"scripts": {
 		"build": "tsc",
-		"check": "tsc --noEmit",
-		"dev": "tsx --watch src/index.ts",
-		"start": "node dist/index.js",
-		"bump-sdk": "npm install @project-ajax/sdk@latest"
+		"check": "tsc --noEmit"
 	},
 	"engines": {
 		"node": ">=22.0.0",

package/template/src/index.ts

@@ -67,7 +67,7 @@ worker.sync("tasksSync", {
 
 	// Optional: How often the sync should run. Defaults to "continuous".
 	// Use intervals like "30m", "1h", "1d" (min: 1m, max: 7d)
-	schedule: "continuous",
+	schedule: "5m",
 
 	// Sync mode:
 	// - "replace": Each sync cycle returns the complete dataset. After hasMore:false,