| name | project |
| description | Defines the @samchon/lint-plugin-evidence product contract, workspace layout, package boundaries, and canonical commands. Use when orienting in the repository, working inside any package, or choosing a build, test, or format command. |
Project Outline
Product Contract
@samchon/lint-plugin-evidence is an evidence-graph lint contributor for @ttsc/lint. It exists so that a claim made in code carries its proof, and so that a missing or dangling proof fails the build rather than waiting to be noticed in review.
- Declare. An
@evidence <target> <reason> tag cites a Markdown section, Prisma model or member, Swagger/OpenAPI operation, or TypeScript symbol as the grounds for a declaration. It lives in a JSDoc block, a Markdown HTML comment, or a Prisma /// comment, depending on which artifact claims.
- Resolve. Targets resolve against Markdown, Prisma, and Swagger/OpenAPI sources loaded from configured locations and against the TypeScript program's symbols.
- Enforce. Violations surface as real compile errors, because
@ttsc/lint runs in the check stage and the exit code sums lint and type diagnostics.
- Configure. Which folders must cite what, which edges count toward coverage, and when a rule activates are the consumer's to declare in
lint.config.ts.
The contract is general-purpose. autobe-mcp proves the idea with a hardcoded, domain-specific graph; it is prior art and a validation target, not the product definition. The evidence-graph skill owns the domain model, and .wiki/references/ holds what the prior art actually does.
Layout
packages/evidence: @samchon/lint-plugin-evidence. TypeScript descriptor, plugin metadata, and config-augmentation types in src/; every lint rule as Go source in native/, with its Go unit tests co-located there as *_test.go. The published tarball must ship native alongside the compiled descriptor, or it builds nowhere but here — see the lint-rule-authoring skill.tests/test-evidence: end-to-end feature tests. Materialize a project, run the real binary, assert the diagnostics.config: shared tsconfig base that packages extend..wiki: Korean knowledge base of prior-art research and decisions. Not documentation; see the wiki skill..agents/skills: these skills.
Language Boundary
TypeScript owns the descriptor, the configuration types, and the e2e tests. Go owns every rule. This is not a preference: @ttsc/lint has no JavaScript rule runtime, and autobe-mcp/packages/lint ships the same hybrid shape. Do not attempt rule logic in TypeScript.
Commands
pnpm install
pnpm format
pnpm build
pnpm test:go
pnpm test
