Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions evidence/design/native-directions/tauri-renovation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Direction: Tauri and shadcn renovation

The current Tauri shell could retain all React features while receiving a full
Evidence Bench redesign. It remains the operational fallback during migration,
but was not selected as the destination because the owner prioritized macOS,
performance, native interaction depth, and visual quality over portability or
schedule.
12 changes: 12 additions & 0 deletions evidence/design/native-directions/verification-chamber.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Direction: Verification Chamber

The setup state uses a near-black, top-navigation composition with one decisive
question, exact repository/change/task inputs, honest pre-run metrics, and a
persistent proof sequence. It removes the generic sidebar and card stack so the
verification decision—not application chrome—owns the screen.

Selected as the production direction because it has the clearest hierarchy,
the strongest macOS-scale rhythm, and a product-specific signature that cannot
be mistaken for a generic dashboard.

Rendered evidence: `artifacts/design/native-probes/chamber.png`.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/native-usage-windows-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
326 changes: 326 additions & 0 deletions evidence/design/probes/review-overhaul-directions.html

Large diffs are not rendered by default.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/product-surfaces-after-1440.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/product-surfaces-after-390.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/product-surfaces-after-768.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/product-surfaces-before-1440.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/product-surfaces-scope-1440.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/product-surfaces-scope-390.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/product-surfaces-scope-768.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/review-desktop-after-1440.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/review-desktop-final-1440.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added evidence/design/review-navigation-after-1440.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
59 changes: 59 additions & 0 deletions evidence/design/reviews/crash-recovery.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
{
"$schema": "fleet.design-review.v1",
"version": 1,
"project": "codevetter",
"target": "desktop shell crash recovery and evidence workflow",
"mode": "preserve",
"register": "product",
"context": {
"product": "PRODUCT.md",
"design": "DESIGN.md"
},
"direction": {
"references": [],
"probes": [],
"selected": "existing-design",
"approval": "not-required",
"before": "artifacts/design/crash-recovery-before-1440.png"
},
"evidence": {
"screenshots": [
{
"width": 390,
"path": "artifacts/design/crash-recovery-final-390.jpg"
},
{
"width": 768,
"path": "artifacts/design/crash-recovery-final-768.jpg"
},
{
"width": 1440,
"path": "artifacts/design/crash-recovery-final-1440.jpg"
}
],
"projectCheck": {
"command": "cd apps/desktop && pnpm exec tsc --noEmit && node --import tsx --test src/lib/ui-incident.test.ts && playwright test tests/e2e/visual-system.spec.ts --grep 'renders a local-only recovery surface'",
"status": "pass"
},
"critique": {
"score": 35,
"maximum": 40
},
"audit": {
"score": 19,
"maximum": 20
},
"unresolved": {
"p0": 0,
"p1": 0
},
"detector": {
"posture": "advisory",
"findings": []
}
},
"ownerFeedback": {
"decision": "keep",
"note": "Owner approved the final crash-recovery design with 'go for it'."
}
}
51 changes: 51 additions & 0 deletions evidence/design/reviews/desktop-navigation-clarity.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
{
"$schema": "fleet.design-review.v1",
"version": 1,
"project": "codevetter",
"target": "desktop tool navigation and command search",
"mode": "preserve",
"register": "product",
"context": {
"product": "PRODUCT.md",
"design": "DESIGN.md"
},
"direction": {
"references": [],
"probes": [],
"selected": "existing-design-distilled",
"approval": "not-required",
"before": "artifacts/design/review-desktop-final-1440.png"
},
"evidence": {
"screenshots": [
{
"width": 1440,
"path": "artifacts/design/review-navigation-after-1440.png"
}
],
"projectCheck": {
"command": "cd apps/desktop && pnpm exec tsc --noEmit && pnpm exec biome check src/App.tsx src/components/sidebar.tsx tests/e2e/smoke.spec.ts tests/e2e/visual-system.spec.ts tests/e2e/review-warm-evidence.spec.ts && pnpm exec playwright test focused navigation checks and review-warm-evidence.spec.ts",
"status": "pass"
},
"critique": {
"score": 32,
"maximum": 40
},
"audit": {
"score": 18,
"maximum": 20
},
"unresolved": {
"p0": 0,
"p1": 0
},
"detector": {
"posture": "advisory",
"findings": []
}
},
"ownerFeedback": {
"decision": "keep",
"note": "Owner confirmed the left sidebar direction and asked that the next pass focus only on review-inspector readability."
}
}
59 changes: 59 additions & 0 deletions evidence/design/reviews/focus-desktop-product-surfaces.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
{
"$schema": "fleet.design-review.v1",
"version": 1,
"project": "codevetter",
"target": "five-surface desktop shell and Performance workbench",
"mode": "preserve",
"register": "product",
"context": {
"product": "PRODUCT.md",
"design": "DESIGN.md"
},
"direction": {
"references": [],
"probes": [],
"selected": "existing-design",
"approval": "not-required",
"before": "artifacts/design/product-surfaces-before-1440.jpg"
},
"evidence": {
"screenshots": [
{
"width": 390,
"path": "artifacts/design/product-surfaces-after-390.jpg"
},
{
"width": 768,
"path": "artifacts/design/product-surfaces-after-768.jpg"
},
{
"width": 1440,
"path": "artifacts/design/product-surfaces-after-1440.jpg"
}
],
"projectCheck": {
"command": "pnpm lint; desktop tsc --noEmit; focused unit/Rust tests; vite build; bundle, complexity, cycles, duplication, dependency, docs, OpenSpec, diff, and in-app browser checks",
"status": "pass"
},
"critique": {
"score": 35,
"maximum": 40
},
"audit": {
"score": 19,
"maximum": 20
},
"unresolved": {
"p0": 0,
"p1": 0
},
"detector": {
"posture": "advisory",
"findings": []
}
},
"ownerFeedback": {
"decision": "pending",
"note": "Owner approved implementation; final rendered-surface feedback remains pending."
}
}
134 changes: 134 additions & 0 deletions evidence/design/reviews/landing-page.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,134 @@
{
"$schema": "fleet.design-review.v1",
"version": 1,
"project": "codevetter",
"target": "CodeVetter execution-backed verification landing page",
"surfaceMode": "persuade",
"mode": "overhaul",
"register": "product",
"context": {
"product": "PRODUCT.md",
"design": "DESIGN.md"
},
"direction": {
"references": [
"CodeVetter desktop review workbench",
"repository-tracked verification receipts",
"public synthetic benchmark and scorer"
],
"probes": [
{
"id": "initial-candidate",
"path": "artifacts/design/landing-audit/candidate-1440.png"
},
{
"id": "stable-document-render",
"path": "artifacts/design/landing-audit/final-1440.png"
},
{
"id": "product-proof-revision",
"path": "artifacts/design/landing-audit/final-p1-1440.png"
}
],
"selected": "product-proof-revision",
"approval": "delegated",
"before": "artifacts/design/landing-audit/candidate-1440.png",
"library": {
"strategy": "upstream-first",
"primary": "existing-project-system",
"sources": [],
"runtime": "existing",
"customReplacement": {
"used": false,
"authorization": "not-required",
"reason": ""
}
},
"contract": {
"purpose": "CodeVetter verifies whether a coding agent completed the requested task by binding the exact change to executable checks, retained evidence, explicit limitations, and a measurable verdict.",
"purposeSource": "Site Health dossier, PRODUCT.md, current CLI contract, and v1.11.0 release artifacts",
"canonicalPurpose": "Execution-backed verification and evaluation for coding-agent changes.",
"purposeAlignment": "match",
"driftNote": "",
"audience": "Engineers and teams supervising, evaluating, or accepting coding-agent changes.",
"job": "Understand the verification boundary, inspect real product and receipt evidence, run the bundled CLI against an exact repository change, or install the current local desktop workbench.",
"thesis": "A review finding is a hypothesis; only task-relevant execution evidence can produce a pass, fail, or unverified verdict.",
"system": "A dark verification instrument using the established CodeVetter tokens, evidence typography, bounded cyan accents, exact CLI commands, real workbench capture, and responsive document flow.",
"signature": "The task-change-check-evidence-limit-verdict chain connects an illustrative receipt anatomy to an actual bundled CLI invocation, real tracked receipt, and current desktop workbench.",
"risk": "The product could be mistaken for a hosted generic AI reviewer, so the page explicitly distinguishes optional provider analysis from local execution evidence and limits every availability and benchmark claim."
}
},
"evidence": {
"screenshots": [
{
"width": 390,
"path": "artifacts/design/landing-audit/final-p1-390.png"
},
{
"width": 768,
"path": "artifacts/design/landing-audit/final-p1-768.png"
},
{
"width": 1440,
"path": "artifacts/design/landing-audit/final-p1-1440.png"
}
],
"projectCheck": {
"command": "cd apps/landing-page-astro && pnpm build && node scripts/verify-agent-surfaces.mjs dist; Chromium responsive/footer/Axe acceptance against local Wrangler worker",
"status": "pass"
},
"critique": {
"score": 36,
"maximum": 40
},
"audit": {
"score": 19,
"maximum": 20
},
"unresolved": {
"p0": 0,
"p1": 0
},
"detector": {
"posture": "advisory",
"findings": []
},
"comprehension": {
"status": "pass",
"reviewer": "independent strict P1 source and responsive screenshot review",
"answers": {
"product": "CodeVetter is an execution-backed verification and evaluation system for coding-agent changes.",
"audience": "Engineers and teams that need reproducible acceptance evidence before trusting or shipping an agent result.",
"value": "It replaces plausible completion claims with an inspectable pass, fail, or unverified verdict.",
"mechanism": "It binds the requested task and exact change to repository-owned checks, evidence, provenance, and explicit limitations.",
"proof": "The page includes a supported v1.11 CLI invocation, a real immutable verification receipt, the current desktop workbench, and a bounded public benchmark.",
"nextAction": "Run the bundled verifier against a repository change or install the current Apple-silicon desktop release."
},
"purposeScore": {
"product": 25,
"audience": 15,
"value": 15,
"mechanism": 15,
"proof": 13,
"nextAction": 13,
"total": 96
},
"mismatches": []
},
"performance": {
"report": ".fleet/evidence/landing-audit/performance.html",
"weightedLcpMs": 514,
"cls": 0,
"tbtMs": 0
},
"visualQuality": {
"priority": "P1",
"score": 91,
"minimum": 90
}
},
"ownerFeedback": {
"decision": "delegated",
"note": "The owner delegated the Fleet landing-page overhaul and explicitly required P1 projects to meet the highest quality tier without repeated feedback loops."
}
}
32 changes: 32 additions & 0 deletions evidence/design/reviews/local-review-test-performance-check.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
{
"$schema": "fleet.design-review.v1",
"version": 1,
"project": "codevetter",
"target": "Local review, test, and performance check in Review setup",
"mode": "preserve",
"register": "product",
"context": { "product": "PRODUCT.md", "design": "DESIGN.md" },
"direction": {
"references": [],
"probes": [],
"selected": "existing-design",
"approval": "not-required",
"before": "artifacts/design/trex-before-1440.png"
},
"evidence": {
"screenshots": [
{ "width": 390, "path": "artifacts/design/review-agent-readiness-after-390.png" },
{ "width": 768, "path": "artifacts/design/review-agent-readiness-after-768.png" },
{ "width": 1440, "path": "artifacts/design/review-agent-readiness-after-1440.png" }
],
"projectCheck": { "command": "cd apps/desktop && pnpm exec tsc --noEmit", "status": "pass" },
"critique": { "score": 38, "maximum": 40 },
"audit": { "score": 18, "maximum": 20 },
"unresolved": { "p0": 0, "p1": 0 },
"detector": { "posture": "advisory", "findings": [] }
},
"ownerFeedback": {
"decision": "delegated",
"note": "Owner approved the exact bounded flow and asked for no extra feature or optimization work; the preserve-lane implementation follows the existing workbench language."
}
}
Loading
Loading