Skip to content

outreach(feat): move distribution tracking to Airtable#22

Merged
Ducksss merged 5 commits into
mainfrom
claude/pedantic-moore-e4e7f4
Jul 13, 2026
Merged

outreach(feat): move distribution tracking to Airtable#22
Ducksss merged 5 commits into
mainfrom
claude/pedantic-moore-e4e7f4

Conversation

@Ducksss

@Ducksss Ducksss commented Jul 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • Move outreach state from hand-edited Markdown tables to Airtable-backed Targets, append-only Log, and append-preserving Claims records.
  • Add the zero-dependency scripts/outreach-tracker.mjs helper for list, get, claim, release, upsert, status, and log operations.
  • Preserve current integrated ChatGPT-window positioning and the v0.7 promotion gate while making Airtable the sole live ledger.

Claim safety

  • Each claim is a separate lease row keyed by target, unique workflow id, and UUID.
  • Simultaneous contenders settle deterministically by Airtable creation time and key; exactly one exits successfully.
  • Release updates only the caller's claim rows, so stale or non-owner releases cannot clear another workflow's lease.
  • Expired and released claims remain as audit history without blocking future work.

Verification

  • make test
  • make lint
  • git diff --check
  • Dependency-free fake Airtable integration coverage for pagination, escaping, upserts, logs, 429 retry, API failures, token redaction, contention, release, expiry, and reclaim
  • Live Airtable smoke test: simultaneous statuses [0,3], non-owner release rejected, held target blocked, release and reclaim succeeded

The operational tracker remains excluded from the published npm package.

Copilot AI review requested due to automatic review settings July 1, 2026 18:01

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@Ducksss Ducksss force-pushed the claude/pedantic-moore-e4e7f4 branch from 33b0e63 to 903e51b Compare July 12, 2026 18:25
Ducksss and others added 2 commits July 13, 2026 01:26
Replace the hand-edited LAUNCH.md ledger with an Airtable base so multiple
outreach agents can run in parallel without racing on a shared file.

- Add scripts/outreach-tracker.mjs: zero-dependency Node helper
  (list/get/claim/release/upsert/set-status/log) with upsert-on-Key dedup, a
  15-minute claim protocol, and 429 backoff. Kept out of the npm package.
- Redirect agent.md to read and write the tracker instead of LAUNCH.md; add
  Concurrency and Owned-Listings-On-Release sections; drop the LAUNCH.md commit
  step from Durable State.
- Slim LAUNCH.md to positioning, channel copy, launch order, policy gates, and
  metrics, with a pointer to the Airtable base.
- Freeze archive/launch-ledger-history.md as the pre-Airtable record.
- Add token guards to .gitignore and a `make outreach` helper target.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Summary:
- replace mutable target claims with append-preserving lease records
- add deterministic contention, owner-scoped release, and input validation
- cover tracker behavior with a dependency-free fake Airtable server

Rationale:
- prevent stale workers from clearing another workflow's active claim
- keep parallel outreach runs deduplicated without rewriting ledger history

Tests:
- make test
- make lint
- git diff --check
- live Airtable claim, rejection, release, and reclaim smoke test
@Ducksss Ducksss force-pushed the claude/pedantic-moore-e4e7f4 branch from 903e51b to b896401 Compare July 12, 2026 18:28
@Ducksss Ducksss changed the title feat(outreach): move distribution tracking to Airtable outreach(feat): move distribution tracking to Airtable Jul 12, 2026
Ducksss added 3 commits July 14, 2026 03:30
Summary:
- validate calendar dates and required option values
- reject unknown set-status flags and redact reflected tokens
- widen the claim-expiry test margin to avoid timing flakes

Rationale:
- keep malformed operator input from reaching Airtable
- preserve the tracker token boundary in API error output
- make lease tests reliable on slower CI runners

Tests:
- make test
- make lint
- git diff --check
Summary:
- move repository skills into Codex's .agents/skills discovery path
- add exact Airtable tracker, claim, release, and handoff commands
- strengthen layout, workflow, approval, and product-contract tests

Rationale:
- ensure Codex can discover and execute each outreach phase independently
- keep concurrent target changes lease-safe and explicitly approval-gated

Tests:
- make test
- make lint
- git diff --check
- quick_validate.py for all four skills
Summary:
- reconcile duplicate submissions before closing-draft handoff
- support issue-first qualification and monitoring repair paths
- keep external observations out of shell source
- clarify approval-gated closing metadata and status mappings

Rationale:
- prevent duplicate outreach and stranded Airtable records
- make partial writes and claim cleanup explicit
- preserve platform history while repairing broken links

Tests:
- make test
- make lint
- quick_validate.py for all four skills
- plugin-eval analyze for qualification and monitoring
- fresh-context qualification and monitoring scenarios
@Ducksss Ducksss merged commit 52aa88a into main Jul 13, 2026
3 checks passed
@Ducksss Ducksss deleted the claude/pedantic-moore-e4e7f4 branch July 13, 2026 20:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants