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
5 changes: 4 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This repository is a local TypeScript CLI plus portable Codex skills. Treat ever
- Do not commit `.env`, `.state/`, build output, local logs, tokens, temporary workspaces, or machine-specific paths.
- Do not add private tokens, internal hostnames, private repository names, or personal filesystem paths.
- Use `rg` for searches when available.
- Run `pnpm verify` before claiming a change is ready (`test:layout` + `vp check` + tests + `tsc` build + package check). Prefer `vp` for lint/fmt/test when Vite+ is installed (`pnpm exec vp …`).
- Run `pnpm verify` before claiming a change is ready (`test:layout` + `vp check` + duplicates + tests + `tsc` build + package check). Prefer `vp` for lint/fmt/test when Vite+ is installed (`pnpm exec vp …`).
- Do not claim implementation work is complete until the relevant commands pass, or until skipped commands are explained with concrete blockers.
- Update tests and documentation when behavior changes.
- `feeds.json` is the repository-maintained RSS subscription list. Update it through `rss-summary feeds ...` when possible and include intentional feed changes in the pull request.
Expand All @@ -35,6 +35,9 @@ gh repo-checks pr-body pr-body.md
pnpm fmt
pnpm lint

pnpm duplicates # Fails on any reported duplicate.
pnpm duplicates:audit # Reports duplicates without failing on findings.

# Full local gate:
pnpm verify

Expand Down
2 changes: 2 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ Useful focused commands:
```bash
pnpm test
pnpm typecheck
pnpm duplicates # Fails on any reported duplicate.
pnpm duplicates:audit # Reports duplicates without failing on findings.
pnpm build
```

Expand Down
5 changes: 4 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,10 @@ gh repo-checks pr-body pr-body.md
pnpm fmt
pnpm lint

# Full local gate (test layout + vp check + tests + build + package check):
pnpm duplicates # Fails on any reported duplicate.
pnpm duplicates:audit # Reports duplicates without failing on findings.

# Full local gate (test layout + vp check + duplicates + tests + build + package check):
pnpm verify

# Coverage:
Expand Down
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,7 +174,9 @@ rss-summary runs show <run-label>
## Development

```bash
pnpm verify # test:layout + check + test + build + package:check
pnpm verify # test:layout + check + duplicates + test + build + package:check
pnpm duplicates # 检出任何一处重复都会失败。
pnpm duplicates:audit # 只生成报告,发现重复也不会拦截。
```

`main` 受保护。在功能分支上改,开 PR,等 `Verify` + `Coverage` 通过后再合并。
Expand Down
3 changes: 2 additions & 1 deletion docs/architecture/technology-decisions.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,14 +81,15 @@ Alternatives considered and rejected:
- **Oxfmt** via `vp fmt` / included in `vp check`.
- Import direction is enforced by the architecture test (`scripts/architecture/boundaries.ts` + `tests/repo/architecture.test.ts`, zero violations), not by lint rules.
- `pnpm verify` runs `pnpm check` (`vp check`) after `test:layout`.
- The next step, `pnpm duplicates`, fails on any reported duplicate. Run `pnpm duplicates:audit` separately for a report without failing on findings.

## CI Gates

`ci.yml` runs two jobs on every PR to `main`:

| Job | Command | Fails when |
| --- | --- | --- |
| `Verify` | `pnpm verify` | layout mismatch, check (fmt/lint/type) failure, test failure, build failure, or packed-package check failure |
| `Verify` | `pnpm verify` | layout mismatch, check (fmt/lint/type) failure, any reported duplicate, test failure, build failure, or packed-package check failure |
| `Coverage` | `pnpm test:layout && pnpm test:coverage` | missing sibling tests or coverage below the thresholds in `vite.config.ts` |

Both jobs are intended to be required checks in the branch protection rule for `main` (configure in GitHub → Settings → Branches → Branch protection rules; this cannot be expressed in the workflow file itself).
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@
"test:coverage": "vp test run --coverage",
"test:layout": "node scripts/check-test-layout.mjs",
"typecheck": "tsc --noEmit",
"verify": "pnpm test:layout && pnpm check && pnpm test && pnpm build && pnpm package:check"
"verify": "pnpm test:layout && pnpm check && pnpm duplicates && pnpm test && pnpm build && pnpm package:check"
},
"devDependencies": {
"@rivus/agent": "0.18.0",
Expand Down
4 changes: 3 additions & 1 deletion tests/repo/ci-harness.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,9 @@ describe("CI harness", () => {
scripts?: Record<string, string>;
};

expect(pkg.scripts?.verify).toBe("pnpm test:layout && pnpm check && pnpm test && pnpm build && pnpm package:check");
expect(pkg.scripts?.verify).toBe(
"pnpm test:layout && pnpm check && pnpm duplicates && pnpm test && pnpm build && pnpm package:check"
);
expect(pkg.scripts?.check).toBe("vp check");
expect(pkg.scripts?.lint).toBe("vp lint");
expect(pkg.scripts?.test).toBe("vp test run");
Expand Down
4 changes: 3 additions & 1 deletion tests/repo/package-bin.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,9 @@ describe("package CLI metadata", () => {
]);
expect(pkg.scripts?.build).toBe("tsc -p tsconfig.build.json");
expect(pkg.scripts?.["package:check"]).toBe("node scripts/check-package.mjs");
expect(pkg.scripts?.verify).toBe("pnpm test:layout && pnpm check && pnpm test && pnpm build && pnpm package:check");
expect(pkg.scripts?.verify).toBe(
"pnpm test:layout && pnpm check && pnpm duplicates && pnpm test && pnpm build && pnpm package:check"
);
expect(buildConfig.compilerOptions?.declaration).toBe(true);
});

Expand Down
Loading