Repository Continuity

The homepage stays simple. This page carries the full model: how Snipara keeps developers and AI agents synchronized by turning repository activity, PRs, decisions, and code impact into actionable, source-grounded context.

Product boundary

Repository continuity is not a PR review assistant, vector database, generic RAG layer, Snipara Sandbox, or orchestrator. Those surfaces can exist underneath the product, but the user value is operational repository context that survives tools, sessions, branches, and agents. Helvabase applies the same authority model to business workflows.

The repository continuity loop

Repository continuity loop
Rendering diagram...

Snipara observes repository movement, keeps the durable parts sourced, and turns them into three daily surfaces: a brief before work starts, a filtered view of what changed, and an Answer Pack during review. The same evidence can feed AI agents, but the authority stays attached to the repository.

Three daily surfaces

Repository continuity becomes useful when the same evidence is shaped differently before editing, while resuming, and during review.

Daily surface

Start Work Brief

A pre-edit briefing for the current task: likely files, recent PRs, relevant decisions, risky contracts, tests, and collision signals.

Daily surface

What Changed For Me

A return-to-work surface that filters repository movement down to the merges, decisions, stale assumptions, and overlaps that matter to your branch.

Daily surface

PR Answer Pack

A review artifact published back to GitHub so humans and AI agents start from the same repository truth during PR review.

Core primitives

Continuity primitive

Start Work Brief

Before a developer or agent opens the editor, show the files, PRs, decisions, pitfalls, tests, and overlap risk that matter for the task.

snipara-companion team-sync start-work --summary "add team invite permissions" returns likely files, recent related PRs, relevant decisions, suggested tests, and collision risk.

Continuity primitive

What Changed For Me

Turn repository activity into a return-to-work ritual instead of a raw changelog.

Filter by current branch, recent files, touched symbols, issues, PRs, and previous work sessions.

Continuity primitive

PR Answer Packs

Attach a compact, sourced context artifact to a pull request so humans and AI agents start review from the same repository truth.

Include what changed, impacted symbols, related decisions, risky contracts, stale warnings, tests to run, reviewers, and source links.

Continuity primitive

Decision Ledger

Promote durable rules from PR discussions and reviews only when they should survive the thread.

Personal API keys remain valid for invited workspace users, sourced to PR #214, dated, reviewed, and revocable.

Continuity primitive

Context Authority

Make every context claim inspectable before it is handed to an AI client or reviewer.

Attach source_type, source_url, commit_sha, collected_at, freshness, confidence, validated_by, and stale_reason.

Continuity primitive

Overlap Risk

Show concurrent work before it becomes a merge surprise.

Medium collision risk: billing/checkout also touched in PR #182; stale assumption warning on plan checks.

Start Work Brief example

The brief is the main daily ritual. It answers: what changed before I start coding, what matters for this task, and what could conflict with my branch. It is a named artifact, not a generic search result.

Start Work Brief v1
Task
add team invite permissions
Target
snipara/web / invite-permissions
Freshness
main synced 6 minutes ago
Last relevant decisions

Reviewed decisions or durable rules that constrain the task.

Source authority/freshness

Source URLs, commit SHA, collected time, and stale warnings.

Likely files/modules

Paths, symbols, or modules that are likely to matter first.

Risks and stale assumptions

Collision risk, concurrent PRs, outdated plans, and caveats.

Suggested tests

Focused checks that should prove the task-specific surface.

Memory and context refs

Memory IDs, answer-pack refs, and docs to read before editing.

Agent handoff note

A compact instruction for the next agent or reviewer.

Context authority contract

Context is only useful when a reviewer or agent can judge whether it is safe to use. Answer Packs, briefs, and decisions should carry evidence metadata whenever the source supports it.

This contract is not code-only. The same fields can label active client truth, historical reference material, and company-wide reusable context so business AI workflows do not flatten precedent into current fact.

FieldMeaning
source_typeWhere the context came from: PR, commit, issue, review, decision, file, or manual note.
source_urlThe GitHub or Snipara URL a human can open before trusting the claim.
commit_shaThe repository state used when the context was collected or validated.
collected_atWhen Snipara observed the context.
freshnessWhether the context is fresh, aging, stale, or superseded.
confidenceHow strongly Snipara can support the claim from available evidence.
validated_byHuman, workflow, check, or agent that reviewed the context.
stale_reasonWhy the context should be treated carefully or refreshed.

Where the deeper machinery lives

Runtime execution, orchestrator proof gates, symbol-aware retrieval, MCP tools, workflow modes, and package-level commands are developer infrastructure. They should be discoverable in docs, not forced into the first marketing fold.