Skip to content

Decisions & open questions

A running log of what's locked for v0 and what still needs your call.

Locked for v0 (this commit)

DecisionChoiceRationale
First deliverableSchema + spec firstThe transcript shape is the contract everything else depends on; pin it before building client/server.
AuthWeb signup issues a revocable key; no interactive login at submit timeClean revocation + scoping; supports the hiring-signal identity angle.
Privacy modelClient-side redaction, configurable per use case via named profilesLocal-first; each use case (research, hiring, strict) carries its own posture.
SourcesPluggable adapter interface, seeded with Claude Code + CodexNew agents = one adapter; no core changes.

Still open (your call before the client/server build)

  1. Where does ingestion land? Managed API + object store (S3/GCS) vs. Supabase vs. a thin serverless function. Affects the upload-init flow.
  2. Identity provider for signup — email magic-link vs. GitHub OAuth. GitHub strengthens the hiring signal but narrows the audience.
  3. Default profile shipped with the CLIstrict (safest, less useful data) vs. research (richer, still redacted). Recommendation: strict, and nudge contributors toward research interactively.
  4. Consent & licensing — what rights does a submitter grant on upload? This matters a lot for the hiring/commercial use cases and should be explicit at agentsync login time.
  5. Reasoning/thinking content — include by default? It's high-value for research but can leak intent/PII. Currently gated behind includeReasoning.
  6. Server-side re-scan posture — reject (422) vs. quarantine-and-notify on a detected secret. Recommendation: reject by default, quarantine opt-in.

Future levers the schema already accommodates (not built)

  • End-to-end encryption to consumer-held keys (store ciphertext only).
  • Aggregate-only / differential-privacy submissions for sensitive orgs.
  • Self-hosted ingestion endpoint (--endpoint), so data never touches shared infra.
  • Adapter discovery via agentsync-adapter-* npm packages.

Released under the MIT License.