adamantite 0.44.0 → 0.46.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/README.md +413 -122
  2. package/dist/index.js +638 -57
  3. package/dist/oxlint.js +1 -0
  4. package/dist/presets/analyze.js +1 -0
  5. package/dist/presets/lint/{react-doctor.d.ts → architecture.d.ts} +1 -1
  6. package/dist/presets/lint/architecture.js +8 -0
  7. package/dist/presets/lint/core.js +0 -1
  8. package/dist/presets/lint/effect.js +26 -1
  9. package/dist/presets/lint/jest.d.ts +13 -0
  10. package/dist/presets/lint/jest.js +88 -68
  11. package/dist/presets/lint/plugin/glob.d.ts +7 -0
  12. package/dist/presets/lint/plugin/glob.js +48 -0
  13. package/dist/presets/lint/plugin/imports.d.ts +4 -0
  14. package/dist/presets/lint/plugin/imports.js +4 -1
  15. package/dist/presets/lint/plugin/index.d.ts +3 -0
  16. package/dist/presets/lint/plugin/index.js +14 -8
  17. package/dist/presets/lint/plugin/options.d.ts +5 -5
  18. package/dist/presets/lint/plugin/options.js +19 -7
  19. package/dist/presets/lint/plugin/resolver.d.ts +8 -0
  20. package/dist/presets/lint/plugin/resolver.js +79 -0
  21. package/dist/presets/lint/plugin/rules/import-owners.d.ts +67 -0
  22. package/dist/presets/lint/plugin/rules/import-owners.js +310 -0
  23. package/dist/presets/lint/plugin/rules/layers.d.ts +136 -0
  24. package/dist/presets/lint/plugin/rules/layers.js +479 -0
  25. package/dist/presets/lint/plugin/rules/no-query-data-in-state.js +1 -1
  26. package/dist/presets/lint/plugin/rules/no-react-state-hooks.d.ts +0 -5
  27. package/dist/presets/lint/plugin/rules/no-react-state-hooks.js +3 -47
  28. package/dist/presets/lint/plugin/rules/query-from-loader.js +2 -2
  29. package/dist/presets/lint/plugin/rules/require-suppression-reason.d.ts +5 -0
  30. package/dist/presets/lint/plugin/rules/require-suppression-reason.js +32 -0
  31. package/dist/presets/lint/react-strict.js +22 -2
  32. package/dist/presets/lint/strict.js +35 -2
  33. package/dist/presets/lint/{antislop.d.ts → tailwind.d.ts} +1 -1
  34. package/dist/presets/lint/{shadcn.js → tailwind.js} +1 -1
  35. package/dist/presets/lint/vendor/antislop/license.md +26 -1
  36. package/dist/presets/lint/vendor/antislop/plugin.d.mts +3 -0
  37. package/dist/presets/lint/vendor/antislop/plugin.mjs +940 -31
  38. package/dist/presets/lint/vendor/antislop-effect/license.md +27 -0
  39. package/dist/presets/lint/vendor/antislop-effect/plugin.d.mts +17 -0
  40. package/dist/presets/lint/vendor/antislop-effect/plugin.mjs +579 -0
  41. package/dist/presets/lint/vitest.d.ts +13 -0
  42. package/dist/presets/lint/vitest.js +111 -91
  43. package/dist/presets/{lint → rules}/custom.d.ts +3 -20
  44. package/dist/presets/{lint → rules}/custom.js +50 -46
  45. package/dist/presets/rules/folder.d.ts +34 -0
  46. package/dist/presets/rules/folder.js +52 -0
  47. package/dist/presets/rules/index.d.ts +2 -9
  48. package/dist/presets/rules/index.js +1 -29
  49. package/dist/presets/rules/load.d.ts +8 -0
  50. package/dist/presets/rules/load.js +29 -0
  51. package/dist/presets/rules/plugin.d.ts +3 -0
  52. package/dist/presets/rules/plugin.js +1 -0
  53. package/dist/presets/rules/testing.d.ts +2 -0
  54. package/dist/presets/rules/testing.js +14 -0
  55. package/dist/presets/tsconfig.json +3 -0
  56. package/dist/runtime-CVZPDpfE.js +11 -0
  57. package/package.json +79 -18
  58. package/skills/adamantite/SKILL.md +112 -200
  59. package/skills/adamantite/references/custom-rules.md +120 -0
  60. package/skills/adamantite/references/lint-rules.md +158 -0
  61. package/skills/adamantite/references/setup.md +64 -0
  62. package/dist/presets/lint/antislop.js +0 -28
  63. package/dist/presets/lint/react-doctor.js +0 -20
  64. package/dist/presets/lint/shadcn.d.ts +0 -5
@@ -0,0 +1,11 @@
1
+ import*as e from"effect/Effect";import*as t from"effect/Array";import*as n from"effect/Layer";import r from"node:process";import*as i from"effect/Option";import*as a from"effect/Context";import*as o from"effect/Path";import*as s from"effect/Predicate";import{stripVTControlCharacters as c}from"node:util";import*as l from"effect/Result";import*as u from"effect/Data";import{pipe as d}from"effect/Function";import*as f from"effect/String";import{applyEdits as p,findNodeAtLocation as m,modify as ee,parse as h,parseTree as g,printParseErrorCode as _,visit as v}from"jsonc-parser";import*as y from"effect/FileSystem";import*as b from"effect/Equal";import*as x from"effect/Schema";import*as te from"effect/encoding/Yaml";import*as ne from"effect/SchemaTransformation";import*as re from"effect/Record";import{fileURLToPath as ie}from"node:url";import*as ae from"effect/Order";import{ResolverFactory as oe}from"oxc-resolver";import*as se from"effect/Match";function ce(e){return s.isError(e)?d(c(e.message),f.split(/\r\n|[\r\n]/),t.map(e=>f.trimEnd(e)),t.filter(e=>f.isNonEmpty(e))):[]}function S(e){return d(ce(e),t.head,i.map(e=>{let t=f.trim(e);return/[.!?]$/.test(t)?` Cause: ${t}`:` Cause: ${t}.`}),i.getOrElse(()=>``))}function le(e){let n=ce(e);if(!t.isReadonlyArrayNonEmpty(n))return``;let r=t.takeRight(n,20);return`\n${(r.length<n.length?[`…`,...r]:r).join(`
2
+ `)}`}function ue(e=[]){return e.length===0?`- Unknown JSON/JSONC parsing error`:e.slice(0,3).map(e=>`- ${_(e.error)} (offset: ${e.offset})`).join(`
3
+ `)}var de=class extends u.TaggedError(`AdamantiteNotInstalled`){get message(){return`\`adamantite\` is not installed in this project. Install it before running \`adamantite ${this.command}\`.`}},fe=class extends u.TaggedError(`AdamantiteNotInNodeModules`){get message(){return`\`adamantite\` is in \`package.json\` but not in \`node_modules\`. Install the dependencies before running \`adamantite ${this.command}\`.`}},pe=class extends u.TaggedError(`AdamantiteVersionMismatch`){get message(){return`This project installs Adamantite ${this.installed}, but this command is Adamantite ${this.running}. Run the project's own Adamantite, such as \`pnpm exec adamantite ${this.command}\`, or install the dependencies again.`}},me=class extends u.TaggedError(`ScopeOutsideProject`){get message(){return`\`--path\` must be a folder inside the project. \`${this.scope}\` is outside \`${this.cwd}\`.`}},he=class extends u.TaggedError(`CliNotFound`){get message(){return`The command \`${this.command}\` was not found on PATH. ${this.hint??`Install it, then run the command again.`}`}},ge=class extends u.TaggedError(`CommandFailed`){get message(){return`Command \`${this.command}\` failed with exit code ${this.exitCode}.`}},_e=class extends u.TaggedError(`CustomRuleExists`){get message(){let e=this.paths.map(e=>`\`${e}\``).join(` and `);return this.paths.length===1?`${e} already exists. Choose another name, or edit the file.`:`${e} already exist. Choose another name, or edit the files.`}},ve=class extends u.TaggedError(`CustomRuleNotFound`){get message(){return`Rule \`${this.rule}\` does not exist in \`${this.directory}\`. Create the rule before adding its test.`}},ye=class extends u.TaggedError(`EffectBuildMissing`){get message(){let e=this.supported.length===0?`has no builds of ${this.tool}`:`has builds for ${this.tool} ${this.supported.join(`, `)}`;return`The effect preset needs the @effect/tsgo build of ${this.tool} ${this.version}. @effect/tsgo ${this.effectVersion} ${e}. Run \`adamantite update\`.`}},be=class extends u.TaggedError(`EffectPlatformUnsupported`){get message(){return`@effect/tsgo has no Effect build of Oxlint for ${this.platform}, so Oxlint cannot load the effect preset here.`}},xe=class extends u.TaggedError(`EffectEditorUnavailable`){get message(){return this.reason}},Se=class extends u.TaggedError(`FailedToCreateDirectory`){get message(){return`Could not create ${this.path?`\`${this.path}\``:`the target directory`}. Check the parent directory permissions, then try again.${S(this.cause)}`}},Ce=class extends u.TaggedError(`FailedToInstallDependency`){get message(){return`Failed to install dependencies${this.packages?.length?`: ${this.packages.join(`, `)}`:``}.${le(this.cause)}`}},we=class extends u.TaggedError(`FailedToInstallExtension`){get message(){let e=this.extension?`\`${this.extension}\``:`the target extension`;return s.isNumber(this.cause)?`Failed to install ${e}. The \`code\` CLI exited with code ${this.cause}.`:`Failed to install ${e}.${S(this.cause)}`}},Te=class extends u.TaggedError(`FailedToMergeConfig`){get message(){return`Failed to merge configuration.${S(this.cause)}`}},Ee=class extends u.TaggedError(`FailedToParseFile`){get message(){return[`Failed to parse ${this.path?`\`${this.path}\``:`the target file`}.`,`Fix the JSON or JSONC syntax and run the command again.`,``,`Parse details:`,ue(this.errors)].join(`
4
+ `)}},C=class extends u.TaggedError(`FailedToParseYaml`){get message(){return`Failed to parse \`${this.path}\`.${S(this.cause)}`}},De=class extends u.TaggedError(`FailedToParseSource`){get message(){return[`Could not parse \`${this.path}\`. Fix the syntax and run the command again.`,...this.errors.map(e=>`- ${e}`)].join(`
5
+ `)}},w=class extends u.TaggedError(`FailedToReadFile`){get message(){return`Could not read ${this.path?`\`${this.path}\``:`the target file`}. Check that the file exists and is readable, then try again.${S(this.cause)}`}},Oe=class extends u.TaggedError(`FailedToWriteFile`){get message(){return`Could not write ${this.path?`\`${this.path}\``:`the target file`}. Check the directory permissions and available disk space, then try again.${S(this.cause)}`}},T=class extends u.TaggedError(`InvalidConfigFormat`){get message(){return`The config in ${this.path?`\`${this.path}\``:`the target config file`} must be a JSON object, such as {}.`}},ke=class extends u.TaggedError(`ProjectCopyFailed`){get message(){return`Could not copy the project to a temporary folder for the trial. Check the free disk space and the permissions of the temporary folder, then try again.${S(this.cause)}`}},Ae=class extends u.TaggedError(`InvalidPackageJson`){get message(){return`\`${this.path}\` is not a valid \`package.json\`. ${this.issue}`}},je=class extends u.TaggedError(`InvalidAnalyzeOptions`){get message(){return`Invalid analyze options. ${this.reason}`}},Me=class extends u.TaggedError(`InvalidCheckOptions`){get message(){return`Invalid check options. ${this.reason}`}},Ne=class extends u.TaggedError(`InvalidFixOptions`){get message(){return`Invalid fix options. ${this.reason}`}},Pe=class extends u.TaggedError(`InvalidInitOptions`){get message(){return`Invalid init options. ${this.reason}`}},Fe=class extends u.TaggedError(`InvalidTrialCase`){get message(){return`Invalid case \`${this.value}\`. ${this.reason}`}},Ie=class extends u.TaggedError(`InvalidTrialOptions`){get message(){return`Invalid trial options. ${this.reason}`}},Le=class extends u.TaggedError(`InvalidRuleName`){get message(){return`Invalid rule name \`${this.rule}\`. Use kebab-case that starts with a letter, such as \`no-process-env\`.`}},Re=class extends u.TaggedError(`NoPackageManager`){get message(){return`No package manager was found. Run this command from a project with a lockfile.${S(this.cause)}`}};u.TaggedError(`MissingPackageVersion`);var ze=class extends u.TaggedError(`OperationCancelled`){get message(){return`Operation cancelled.${this.reason?` Reason: ${this.reason}`:``}`}},Be=class extends u.TaggedError(`NativeRuntimeConflict`){get message(){let e=this.part===`Binding`?`native binding`:`type-aware backend`;return`${this.plugins.join(` and `)} both replace the Oxlint ${e}. Remove one of them.`}},E=class extends u.TaggedError(`PackageNotInstalled`){get message(){return`\`${this.packageName}\` is not installed in \`${this.project}\`. Install the dependencies, or run \`adamantite update\`.`}},Ve=class extends u.TaggedError(`PassthroughNotSupported`){get message(){return`\`adamantite ${this.command}\` does not accept arguments after \`--\`. Use the command options instead.`}},He=class extends u.TaggedError(`TrialCaseIgnored`){get message(){return`The trial could not check this case because the Oxlint config ignores \`${this.path}\`. Put the case at a path that the config lints.`}},Ue=class extends u.TaggedError(`TrialCaseUnparsable`){get message(){return[`Oxlint could not parse the trial case \`${this.path}\`. Fix the syntax and run the trial again.`,...this.errors.map(e=>`- ${e}`)].join(`
6
+ `)}},We=class extends u.TaggedError(`TrialConfigNotFound`){get message(){return`No Oxlint config applies to \`${this.path}\`. Configure linting with \`adamantite init\`, then run the trial again.`}},Ge=class extends u.TaggedError(`TrialLintFailed`){get message(){return`Oxlint could not run the trial. Fix the errors below and run it again.\n${this.output}`}},Ke=class extends u.TaggedError(`TrialProjectUnlisted`){get message(){return`The trial needs Git to list the files of \`${this.cwd}\`. Run it in a Git repository.`}},qe=class extends u.TaggedError(`TrialRuleNotFound`){get message(){return`The rule \`${this.rule}\` is not available. Check that the Oxlint config loads it. Oxlint reports: ${this.detail}`}},Je=class extends u.TaggedError(`VscodeCliNotFound`){get message(){return`VS Code's \`code\` command was not found on PATH. Add it to PATH to manage extensions.${S(this.cause)}`}};const D=(t,n)=>e.suspend(()=>{let r=[],i=h(t,r,{allowTrailingComma:!0});return r.length>0?e.fail(new Ee({errors:r,path:n})):e.succeed(i)}),Ye=x.fromJsonString(x.Unknown),Xe=x.fromJsonString(x.Unknown,{space:2}),O=x.encodeEffect(Ye),Ze=x.encodeEffect(Xe),k=e=>s.isObject(e),A=e=>Array.isArray(e);function Qe(e,t){return e===void 0?t:k(e)&&k(t)?$e(e,t):A(e)&&A(t)?[...e,...t]:e}function $e(e,t){let n=[...Object.keys(t),...Object.keys(e).filter(e=>!Object.hasOwn(t,e))];return Object.fromEntries(n.flatMap(n=>{let r=Qe(Object.hasOwn(e,n)?e[n]:void 0,Object.hasOwn(t,n)?t[n]:void 0);return r===void 0?[]:[[n,r]]}))}const et=({fallback:t,preferred:n})=>e.try({catch:e=>new Te({cause:e}),try:()=>$e(n,t)}),tt=/^([ \t]+)"/mu;function nt(e){let t=tt.exec(e)?.[1]??` `,n=e.includes(`\r
7
+ `)?`\r
8
+ `:`
9
+ `;return t.startsWith(` `)?{eol:n,insertSpaces:!1,tabSize:1}:{eol:n,insertSpaces:!0,tabSize:t.length}}function rt(e,t){return Object.hasOwn(e,t)?e[t]:void 0}function it(e,t,n){return k(e)&&k(t)?[...Object.keys(e),...Object.keys(t).filter(t=>!Object.hasOwn(e,t))].flatMap(r=>it(rt(e,r),rt(t,r),[...n,r])):b.equals(e,t)?[]:[[n,t]]}const at=/^(?<comma>[ \t]*,)?(?<comment>(?:[ \t]*(?:\/\/[^\r\n]*|\/\*[^\r\n]*?\*\/))+)/u;function ot(e,t){let n=t.at(-1),r=g(e),i=r&&m(r,t.slice(0,-1)),a=i?.type===`object`?(i.children??[]).filter(e=>e.children?.[0]?.value===n):[];return a.length>1?a[0]:void 0}function st(e,t){let n=t.offset+t.length,r;v(e,{onSeparator:(e,t)=>{r===void 0&&e===`,`&&t>=n&&(r=t)}});let i=r===void 0?e:e.slice(0,r)+e.slice(r+1),a=i.slice(0,t.offset)+i.slice(n),o=a.lastIndexOf(`
10
+ `,t.offset-1)+1,s=a.indexOf(`
11
+ `,t.offset),c=s===-1?a.length:s+1;return a.slice(o,c).trim()===``?a.slice(0,o)+a.slice(c):a}function ct(e,t){let n=e;for(let e of t.keys()){let r=t.slice(0,e+1);for(let e=ot(n,r);e;e=ot(n,r))n=st(n,e)}return n}function lt(e,t,n,r){let i=e=>p(e,ee(e,t,n,{formattingOptions:r})),a=g(e),o=t.slice(0,-1),c=a&&m(a,o)?.children?.at(-1),l=c?.children?.[0]?.value;if(n===void 0||a===void 0||m(a,t)!==void 0||c?.type!==`property`||!s.isString(l))return i(e);let u=c.offset+c.length,d=at.exec(e.slice(u));if(d?.groups?.comment===void 0)return i(e);let f=u+(d.groups.comma?.length??0),h=d.groups.comment,_=i(e.slice(0,f)+e.slice(f+h.length)),v=g(_),y=v&&m(v,[...o,l])?.parent,b=y?y.offset+y.length:f,x=b+(/^[ \t]*,/u.exec(_.slice(b))?.[0].length??0);return _.slice(0,x)+h+_.slice(x)}function j(e,t){let n=h(e,[],{allowTrailingComma:!0}),r=nt(e);return it(n,t,[]).reduce((e,[t,n])=>lt(ct(e,t),t,n,r),e)}const ut=t=>y.FileSystem.pipe(e.flatMap(e=>e.makeDirectory(t,{recursive:!0})),e.mapError(e=>new Se({cause:e,path:t}))),M=t=>y.FileSystem.pipe(e.flatMap(e=>e.readFileString(t)),e.mapError(e=>new w({cause:e,path:t}))),N=t=>y.FileSystem.pipe(e.flatMap(e=>e.readFileString(t)),e.asSome,e.catchReason(`PlatformError`,`NotFound`,()=>e.succeedNone,(n,r)=>e.fail(new w({cause:r,path:t})))),dt=t=>y.FileSystem.pipe(e.flatMap(e=>e.readFileString(t)),e.asSome,e.catchReasons(`PlatformError`,{BadResource:()=>e.succeedNone,NotFound:()=>e.succeedNone},(n,r)=>e.fail(new w({cause:r,path:t})))),ft=t=>y.FileSystem.pipe(e.flatMap(e=>e.exists(t)),e.mapError(e=>new w({cause:e,path:t}))),P=(t,n)=>y.FileSystem.pipe(e.flatMap(e=>e.readDirectory(t,n)),e.asSome,e.catchReasons(`PlatformError`,{BadResource:()=>e.succeed(i.none()),NotFound:()=>e.succeed(i.none())},(n,r)=>e.fail(new w({cause:r,path:t})))),F=(t,n)=>y.FileSystem.pipe(e.flatMap(e=>e.writeFileString(t,n)),e.mapError(e=>new Oe({cause:e,path:t}))),pt=(t,n)=>Ze(n).pipe(e.flatMap(e=>F(t,`${e}\n`))),mt=/^workspace:/,ht=/^[\^~]/,gt=/^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/,{$match:_t,Catalog:vt,Unreadable:yt,Version:bt}=u.taggedEnum();function xt(e){let t=e.trim();if(t.startsWith(`catalog:`))return vt({catalog:t.slice(8)||`default`});let n=t.replace(mt,``).replace(ht,``);return gt.test(n)?bt({version:n}):yt()}const I=x.Record(x.String,x.String),St=x.Struct({dependencies:x.optionalKey(I),devDependencies:x.optionalKey(I),name:x.optionalKey(x.String),scripts:x.optionalKey(I),version:x.optionalKey(x.String),workspaces:x.optionalKey(x.Union([x.Array(x.String),x.Struct({packages:x.optionalKey(x.Array(x.String))})]))}),L=(t=r.cwd())=>e.gen(function*(){let n=(yield*o.Path).join(t,`package.json`),r=yield*M(n),i=yield*D(r,n);return yield*x.decodeUnknownEffect(St)(i).pipe(e.mapError(e=>new Ae({issue:e.message,path:n}))),i}),Ct=(t,n)=>e.gen(function*(){let e=(yield*o.Path).join(t,`package.json`),r=yield*M(e);yield*F(e,j(r,n))}),R=[`bun`,`deno`,`npm`,`pnpm`,`yarn`],wt=x.is(x.Literals(R));function Tt(e){return new Intl.ListFormat(`en-US`,{type:e}).format(R)}const z={analyze:{ci:!0,command:`adamantite analyze`,tools:[`knip`,`sherif`]},check:{ci:!0,command:`adamantite check`,tools:[`oxfmt`,`oxlint`]},fix:{ci:!1,command:`adamantite fix`,tools:[`oxfmt`,`oxlint`]}},B=re.map(z,e=>e.command),V=[`check`,`fix`,`analyze`],Et=V.filter(e=>z[e].ci);function Dt(e){return V.filter(t=>Ot([t],e))}function Ot(e,t){return e.some(e=>z[e].tools.includes(t))}function kt(e){let n=e.scripts??{};return d(re.keys(B),t.filter(e=>n[e]===B[e]))}function At(e,n){let r=e.scripts??{};return t.filterMap(n,e=>{let t=r[e];return t!==void 0&&t!==``&&t!==B[e]?l.succeed({command:t,script:e}):l.failVoid})}const jt=x.Struct({packages:x.Array(x.String)}),Mt=x.Union([x.String,x.Finite.pipe(x.decodeTo(x.String,ne.transform({decode:String,encode:Number})))]),H=x.Record(x.String,Mt),Nt=x.Struct({catalog:x.optionalKey(H),catalogs:x.optionalKey(x.Record(x.String,H))}),U=t=>e.try({catch:e=>new C({cause:e,path:`pnpm-workspace.yaml`}),try:()=>te.parse(t)}),Pt=t=>U(t).pipe(e.flatMap(e=>x.decodeUnknownEffect(jt)(e)),e.map(({packages:e})=>e),e.orElseSucceed(()=>[])),Ft=t=>U(t).pipe(e.flatMap(e=>x.decodeUnknownEffect(Nt)(e)),e.map(({catalog:e,catalogs:t={}})=>e===void 0?t:{...t,default:e}),e.orElseSucceed(()=>({}))),W=n=>e.gen(function*(){let r=yield*o.Path,a=yield*N(r.join(n,`pnpm-workspace.yaml`)),[s,c]=i.isSome(a)?yield*e.all([Pt(a.value),Ft(a.value)]):[[],{}];if(s.length>0)return{catalogs:c,patterns:s};let{workspaces:l}=yield*L(n);return{catalogs:c,patterns:(t.isArray(l)?l:l?.packages)??[]}}),G=(t=r.cwd())=>W(t).pipe(e.map(({patterns:e})=>e.length>0));function It(e){return e.replaceAll(/[$()+.[\\\]^{|}]/gu,String.raw`\$&`)}function Lt(e){let t=e.replace(/^\.\//u,``).replace(/\/+$/u,``).split(`/`),n=``;for(let[e,r]of t.entries()){let i=e===0||t[e-1]===`**`?``:`/`;r===`**`?e<t.length-1?n+=`${i}(?:[^/]+/)*`:n+=e===0?`(?:[^/]+(?:/[^/]+)*)?`:`(?:/[^/]+)*`:n+=`${i}${It(r).replaceAll(`*`,`[^/]*`).replaceAll(`?`,`[^/]`)}`}return RegExp(`^${n}$`,`u`)}function Rt(e){let t=e.replace(/^\.\//u,``).replace(/\/+$/u,``).split(`/`),n=t.findIndex(e=>/[*?]/u.test(e));return n===-1?{base:t.join(`/`),depth:0}:{base:t.slice(0,n).join(`/`),depth:t.includes(`**`)?1/0:t.length-n}}const zt=/* @__PURE__ */ new Set([`node_modules`]),Bt=(t,n,r)=>e.gen(function*(){let a=yield*o.Path,s=yield*P(a.resolve(t,n));return i.isNone(s)?[]:r===0?[n]:[n,...(yield*e.forEach(s.value.filter(e=>!e.startsWith(`.`)&&!zt.has(e)),e=>Bt(t,n===``?e:`${n}/${e}`,r-1),{concurrency:`unbounded`})).flat()]}),Vt=(n,r)=>e.gen(function*(){let a=yield*o.Path,s=r.filter(e=>!e.startsWith(`!`)),c=r.flatMap(e=>e.startsWith(`!`)?[Lt(e.slice(1))]:[]),l=yield*e.forEach(s,t=>e.gen(function*(){let{base:e,depth:r}=Rt(t),i=Lt(t);return(yield*Bt(n,e,r)).filter(e=>e!==``&&i.test(e))}),{concurrency:`unbounded`}),u=t.dedupe(l.flat()).filter(e=>!c.some(t=>t.test(e)));return(yield*e.forEach(u,t=>N(a.join(n,t,`package.json`)).pipe(e.map(e=>i.isSome(e)?[a.resolve(n,t)]:[])),{concurrency:`unbounded`})).flat()}),Ht=t=>e.gen(function*(){let{catalogs:e,patterns:n}=yield*W(t);return{catalogs:e,isMonorepo:n.length>0,packageDirectories:yield*Vt(t,n)}}),Ut=`oxlint.js`,Wt=`node_modules/adamantite/dist/${Ut}`,Gt=ie(new URL(Ut,import.meta.url)),Kt=`ADAMANTITE_PROJECT`;function qt(e){return{args:[Gt],command:`node`,cwd:e,env:{[Kt]:e},name:`oxlint`}}function Jt(e,t,n){if(n!==void 0&&n!==``)return n;let r=[e.indexOf(`/node_modules/`),e.indexOf(`\\node_modules\\`)].filter(e=>e!==-1);return r.length===0?t:e.slice(0,Math.min(...r))}var Yt=class extends u.TaggedClass(`Binding`){},Xt=class extends u.TaggedClass(`Backend`){},Zt=class extends u.TaggedClass(`JavaScript`){},K=class extends u.TaggedClass(`Native`){};function q(e){return e}var Qt=class extends a.Service()(`ModuleResolver`){static layer=n.sync(this,()=>{let t=new oe({conditionNames:[`node`,`import`,`default`],extensionAlias:{".cjs":[`.cjs`,`.cts`],".js":[`.js`,`.ts`],".mjs":[`.mjs`,`.mts`]},extensions:[`.ts`,`.mts`,`.cts`,`.js`,`.mjs`,`.cjs`]});return{clearCache:e.sync(()=>{t.clearCache()}),resolve:(n,r)=>e.sync(()=>i.fromUndefinedOr(t.sync(n,r).path))}})};const J=e.fn(`resolvePackageDirectory`)(function*(e,t){let n=yield*o.Path,r=yield*(yield*Qt).resolve(e,`${t}/package.json`);return d(r,i.map(e=>n.dirname(e)))}),$t=`@effect/tsgo`,Y=e.fn(`readVersion`)(function*(e){let{version:t}=yield*L(e);return t??``}),en=e.fn(`findArtifact`)(function*(e,n,r,a,s){let c=yield*o.Path,l=c.join(e,`artifacts`,r),u=yield*P(c.join(l,a)),f=d(u,i.flatMap(e=>t.findFirst(e,e=>s(e))));if(i.isSome(f))return c.join(l,a,f.value);let p=yield*P(l);return yield*new ye({effectVersion:n,supported:t.sort(i.getOrElse(p,()=>[]),ae.String),tool:r,version:a})}),tn=e.fn(`resolveEffectRuntime`)(function*(t,n){let a=yield*J(t,$t);if(i.isNone(a))return[];let o=`${r.platform}-${r.arch}`,s=yield*J(a.value,`${$t}-${o}`);if(i.isNone(s))return yield*new be({platform:o});let c=yield*J(t,`tsrs`);if(i.isNone(c))return yield*new E({packageName:`tsrs`,project:t});let[l,u,d]=yield*e.all([Y(a.value),Y(c.value),Y(n)],{concurrency:`unbounded`}),f=r.platform===`win32`?`tsrs.exe`:`tsrs`,p=yield*en(s.value,l,`tsrs`,u,e=>e===f);return[new Yt({path:yield*en(s.value,l,`oxlint`,d,e=>e.endsWith(`.node`))}),new Xt({env:{EFFECT_TSGO_TSGOLINT_MODE:`tsrs`,EFFECT_TSGO_TSGOLINT_PATH:p}})]}),X=`tsconfig.json`,Z=`@effect/language-service`,Q={diagnostics:!0,name:Z},nn=`${JSON.stringify({compilerOptions:{plugins:[Q]}},null,2)}\n`;function rn(e){return A(e)?e.find(e=>k(e)&&e.name===Z):void 0}const an=e.fn(`assessTsconfigPlugin`)(function*({cwd:t,workspace:n},r){if(n.isMonorepo)return{findings:[],warnings:[`Skipping the root \`${X}\` check for \`${r}\`: in a monorepo, add \`${yield*O(Q)}\` to \`compilerOptions.plugins\` in each package's \`${X}\` or in a shared base config.`]};let a=(yield*o.Path).join(t,X),s=yield*N(a),c=i.isNone(s)?void 0:yield*D(s.value,a).pipe(e.map(e=>k(e)&&k(e.compilerOptions)?rn(e.compilerOptions.plugins):void 0));return c!==void 0&&c.diagnostics!==!1?{findings:[],warnings:[]}:{findings:[{currentState:c===void 0?`\`${X}\` does not configure the \`${Z}\` plugin.`:`The \`${Z}\` plugin in \`${X}\` disables its diagnostics, so semantic quick fixes do not work.`,goal:[`Add \`${yield*O(Q)}\` to \`compilerOptions.plugins\` in \`${X}\`, or set \`diagnostics\` to \`true\` in the existing entry. Keep every other plugin and option.`],id:`missing-effect-language-service-plugin`,integration:r,notes:["The `effecttsgo` rules read their options, such as `allowedUnstableApis`, from this entry.",`The managed editor settings hide duplicate Effect reports from the Oxlint editor service. CLI Oxlint keeps its Effect rules.`],reference:{content:nn,language:`json`},title:`Effect language service is not configured`}],warnings:[]}}),on=e.fn(`updateTsconfigPlugin`)(function*(e){if(yield*G(e))return`monorepo`;let t=(yield*o.Path).join(e,X),n=yield*N(t);if(i.isNone(n))return`missing`;let r=yield*D(n.value,t);if(!k(r))return yield*new T({path:t});let a=r.compilerOptions??{};if(!k(a))return yield*new T({path:t});let s=a.plugins??[];if(!A(s))return yield*new T({path:t});let c=rn(s),l=c?s.map(e=>e===c?{...c,diagnostics:!0}:e):[...s,Q];return yield*F(t,j(n.value,{...r,compilerOptions:{...a,plugins:l}})),`updated`}),sn=`@effect/tsgo`;var cn=q({assess:t=>e.gen(function*(){let e=yield*an(t,sn);return{findings:e.findings,warnings:e.warnings}}),name:sn,runtime:new K({resolve:tn}),update:e=>on(e)}),ln=q({name:`oxlint-plugin-react-doctor`,runtime:new Zt}),un=q({name:`@shadcn/lint`,runtime:new Zt});const $=[{hint:`Check React code, JSX accessibility, and performance.`,label:`react`,name:`react`},{hint:`Keep state, effect, and memo hooks in hook files.`,label:`react-strict`,name:`react-strict`,plugin:ln,requires:[`react`]},{hint:`Use queryOptions() and keep query data out of state.`,label:`tanstack`,name:`tanstack`},{hint:`Check Next.js scripts, fonts, images, and head usage.`,label:`next.js`,name:`nextjs`},{hint:`Check Vue 3 code for errors and deprecated APIs.`,label:`vue`,name:`vue`},{hint:`Find effects that never run.`,label:`effect`,name:`effect`,plugin:cn},{hint:`Find focused or skipped tests and check assertions.`,label:`jest`,name:`jest`},{hint:`Find focused or skipped tests and check assertions.`,label:`vitest`,name:`vitest`},{hint:`Check Node.js callbacks and CommonJS modules.`,label:`node`,name:`node`},{hint:`Check the layer maps and import owners you define.`,label:`architecture`,name:`architecture`},{hint:`Ban type assertions, unknown parameters, module mocks, and TODOs.`,label:`strict`,name:`strict`},{hint:`Check Tailwind v4 classes.`,label:`tailwind`,name:`tailwind`,plugin:un}],dn=$.map(e=>e.name),fn=[`shadcn`,`react-doctor`,`antislop`];function pn(e){let t=[...e.plugin===void 0?[]:[`installs ${e.plugin.name}`],...(e.requires??[]).map(e=>`selects the ${e} preset`)].join(` and `);return t===``?e.hint:`${e.hint} ${t.charAt(0).toUpperCase()}${t.slice(1)}.`}function mn(e){return $.flatMap(t=>e.includes(t.name)&&`requires`in t?t.requires.filter(t=>!e.includes(t)).map(e=>({required:e,requiredBy:t.name})):[])}const hn=$.flatMap(e=>`plugin`in e?[e.plugin]:[]);var gn=class extends u.TaggedClass(`Stock`){},_n=class extends u.TaggedClass(`Replaced`){},vn=class extends u.TaggedClass(`None`){},yn=class extends u.TaggedClass(`Tsrs`){},bn=class extends u.TaggedClass(`Replaced`){};function xn(e){return se.valueTags(e,{None:()=>({}),Replaced:({env:e})=>e,Tsrs:({launcher:e})=>({OXLINT_TSGOLINT_PATH:e})})}const Sn=[`tsrs-lint.cmd`,`tsrs-lint.exe`],Cn=e.fn(`findWindowsLauncher`)(function*(t){let n=yield*y.FileSystem,r=yield*o.Path,i=[];for(let e=t;i.push(...Sn.map(t=>r.join(e,`node_modules`,`.bin`,t))),r.dirname(e)!==e;e=r.dirname(e));return yield*e.findFirst(i,t=>n.exists(t).pipe(e.orElseSucceed(()=>!1)))}),wn=e.fn(`resolveDefaultBackend`)(function*(e){let t=yield*o.Path,n=yield*J(e,`tsrs`),a=i.isNone(n)?i.none():r.platform===`win32`?yield*Cn(e):i.some(t.join(n.value,`bin`,`tsrs-lint`));return i.match(a,{onNone:()=>new vn,onSome:e=>new yn({launcher:e})})}),Tn=e.fn(`resolveOxlintRuntime`)(function*(e,t=hn){let n=yield*J(e,`oxlint`);if(i.isNone(n))return yield*new E({packageName:`oxlint`,project:e});let r=new gn,a,o=/* @__PURE__ */ new Map;for(let i of t){if(!(i.runtime instanceof K))continue;let t=yield*i.runtime.resolve(e,n.value);for(let e of t){let t=o.get(e._tag);if(t!==void 0)return yield*new Be({part:e._tag,plugins:[t,i.name]});o.set(e._tag,i.name),e instanceof Yt?r=new _n({path:e.path}):a=new bn({env:e.env})}}return{backend:a??(yield*wn(e)),binding:r,oxlint:n.value}});export{de as $,kt as A,Ke as At,M as B,Et as C,Ve as Ct,wt as D,Ue as Dt,R as E,He as Et,L as F,A as G,dt as H,Ct as I,et as J,k as K,ft as L,Tt as M,Je as Mt,_t as N,Ot as O,We as Ot,xt as P,fe as Q,ut as R,Ht as S,E as St,V as T,me as Tt,F as U,N as V,pt as W,O as X,D as Y,j as Z,Wt as _,Le as _t,Tn as a,xe as at,Jt as b,Re as bt,dn as c,De as ct,mn as d,Oe as dt,pe as et,$ as f,je as ft,K as g,Pe as gt,J as h,Ne as ht,yn as i,ve as it,Dt as j,qe as jt,At as k,Ge as kt,fn as l,C as lt,Qt as m,T as mt,_n as n,ge as nt,xn as o,Ce as ot,cn as p,Me as pt,Ze as q,gn as r,_e as rt,hn as s,we as st,vn as t,he as tt,pn as u,w as ut,Kt as v,Fe as vt,B as w,ke as wt,G as x,ze as xt,qt as y,Ie as yt,P as z};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "adamantite",
3
- "version": "0.44.0",
3
+ "version": "0.46.0",
4
4
  "description": "An strict and opinionated set of presets for modern TypeScript applications",
5
5
  "keywords": [
6
6
  "adamantite",
@@ -32,7 +32,6 @@
32
32
  "!skills/_artifacts"
33
33
  ],
34
34
  "type": "module",
35
- "main": "dist/presets/lint/core.js",
36
35
  "imports": {
37
36
  "#*": "./src/*",
38
37
  "#presets/*": "./presets/*"
@@ -50,32 +49,84 @@
50
49
  "types": "./dist/presets/lint/core.d.ts",
51
50
  "default": "./dist/presets/lint/core.js"
52
51
  },
53
- "./lint/*": {
54
- "types": "./dist/presets/lint/*.d.ts",
55
- "default": "./dist/presets/lint/*.js"
52
+ "./lint/architecture": {
53
+ "types": "./dist/presets/lint/architecture.d.ts",
54
+ "default": "./dist/presets/lint/architecture.js"
55
+ },
56
+ "./lint/effect": {
57
+ "types": "./dist/presets/lint/effect.d.ts",
58
+ "default": "./dist/presets/lint/effect.js"
59
+ },
60
+ "./lint/jest": {
61
+ "types": "./dist/presets/lint/jest.d.ts",
62
+ "default": "./dist/presets/lint/jest.js"
63
+ },
64
+ "./lint/nextjs": {
65
+ "types": "./dist/presets/lint/nextjs.d.ts",
66
+ "default": "./dist/presets/lint/nextjs.js"
67
+ },
68
+ "./lint/node": {
69
+ "types": "./dist/presets/lint/node.d.ts",
70
+ "default": "./dist/presets/lint/node.js"
71
+ },
72
+ "./lint/react": {
73
+ "types": "./dist/presets/lint/react.d.ts",
74
+ "default": "./dist/presets/lint/react.js"
75
+ },
76
+ "./lint/react-strict": {
77
+ "types": "./dist/presets/lint/react-strict.d.ts",
78
+ "default": "./dist/presets/lint/react-strict.js"
79
+ },
80
+ "./lint/strict": {
81
+ "types": "./dist/presets/lint/strict.d.ts",
82
+ "default": "./dist/presets/lint/strict.js"
83
+ },
84
+ "./lint/tailwind": {
85
+ "types": "./dist/presets/lint/tailwind.d.ts",
86
+ "default": "./dist/presets/lint/tailwind.js"
87
+ },
88
+ "./lint/tanstack": {
89
+ "types": "./dist/presets/lint/tanstack.d.ts",
90
+ "default": "./dist/presets/lint/tanstack.js"
91
+ },
92
+ "./lint/vitest": {
93
+ "types": "./dist/presets/lint/vitest.d.ts",
94
+ "default": "./dist/presets/lint/vitest.js"
95
+ },
96
+ "./lint/vue": {
97
+ "types": "./dist/presets/lint/vue.d.ts",
98
+ "default": "./dist/presets/lint/vue.js"
56
99
  },
57
100
  "./rules": {
58
101
  "types": "./dist/presets/rules/index.d.ts",
59
102
  "default": "./dist/presets/rules/index.js"
60
103
  },
104
+ "./rules/plugin": {
105
+ "types": "./dist/presets/rules/plugin.d.ts",
106
+ "default": "./dist/presets/rules/plugin.js"
107
+ },
108
+ "./rules/testing": {
109
+ "types": "./dist/presets/rules/testing.d.ts",
110
+ "default": "./dist/presets/rules/testing.js"
111
+ },
61
112
  "./typescript": "./dist/presets/tsconfig.json"
62
113
  },
63
114
  "dependencies": {
64
115
  "@clack/prompts": "1.8.1",
65
- "@effect/platform-node": "4.0.5",
66
- "@effect/platform-node-shared": "4.0.5",
67
- "@oxlint/plugins": "1.88.0",
68
- "defu": "6.1.7",
69
- "effect": "4.0.5",
116
+ "@effect/platform-node": "4.1.2",
117
+ "@effect/platform-node-shared": "4.1.2",
118
+ "@oxlint/plugins": "1.91.0",
119
+ "effect": "4.1.2",
70
120
  "jsonc-parser": "3.3.1",
71
121
  "nypm": "0.6.10",
72
- "oxc-parser": "0.154.0"
122
+ "oxc-parser": "0.154.0",
123
+ "oxc-resolver": "11.24.2"
73
124
  },
74
125
  "devDependencies": {
75
126
  "@changesets/changelog-github": "1.0.1",
76
127
  "@changesets/cli": "3.0.3",
77
- "@effect/tsgo": "0.54.0",
78
- "@effect/vitest": "4.0.5",
128
+ "@effect/tsgo": "0.67.3",
129
+ "@effect/vitest": "4.1.2",
79
130
  "@shadcn/lint": "0.2.1",
80
131
  "@tanstack/intent": "0.5.5",
81
132
  "@types/figlet": "1.7.0",
@@ -84,20 +135,30 @@
84
135
  "@vitest/ui": "5.0.5",
85
136
  "figlet": "1.12.0",
86
137
  "knip": "6.42.0",
87
- "oxfmt": "0.73.0",
88
- "oxlint": "1.88.0",
138
+ "oxfmt": "0.76.0",
139
+ "oxlint": "1.91.0",
89
140
  "oxlint-plugin-react-doctor": "0.9.18",
90
- "oxlint-tsgolint": "7.0.2004",
91
141
  "sherif": "1.13.0",
92
142
  "tsdown": "0.23.1",
143
+ "tsrs": "0.21.0-ts7.1.0-beta",
93
144
  "type-fest": "5.10.0",
94
145
  "typescript": "7.0.2",
95
146
  "unplugin-macros": "0.23.3",
96
147
  "vitest": "5.0.5"
97
148
  },
98
149
  "peerDependencies": {
150
+ "oxlint": ">=1.88.0",
151
+ "tsrs": ">=0.21.0-ts7.1.0-beta",
99
152
  "typescript": ">=7"
100
153
  },
154
+ "peerDependenciesMeta": {
155
+ "oxlint": {
156
+ "optional": true
157
+ },
158
+ "tsrs": {
159
+ "optional": true
160
+ }
161
+ },
101
162
  "engines": {
102
163
  "bun": ">=1.0.0",
103
164
  "node": ">=22.19.0"
@@ -107,9 +168,9 @@
107
168
  "build": "tsdown",
108
169
  "build:verify": "pnpm run build && pnpm run test:build",
109
170
  "bump:deps": "pnpm update --interactive --latest",
110
- "check": "oxlint",
171
+ "check": "node src/oxlint.ts",
111
172
  "dev": "tsdown --watch",
112
- "fix": "oxlint --fix",
173
+ "fix": "node src/oxlint.ts --fix",
113
174
  "format": "oxfmt",
114
175
  "release": "changeset publish",
115
176
  "test": "vitest run",
@@ -1,214 +1,126 @@
1
1
  ---
2
2
  name: adamantite
3
- description: Configures and maintains Adamantite linting, formatting, type-safety, analysis, editor, and CI tooling in TypeScript projects. Use when initializing Adamantite, running its checks, updating managed dependencies, or following Doctor findings in an existing installation.
3
+ description: Use when setting up Adamantite, running its checks, repairing Doctor findings, updating managed dependencies, hardening coding standards, or writing and testing custom rules.
4
4
  metadata:
5
5
  type: core
6
6
  library: adamantite
7
- library_version: "0.37.0"
7
+ library_version: "0.45.0"
8
8
  sources:
9
9
  - "adelrodriguez/adamantite:src/cli.ts"
10
- - "adelrodriguez/adamantite:src/commands/*.ts"
11
- - "adelrodriguez/adamantite:src/lib/workspace/custom-rules.ts"
10
+ - "adelrodriguez/adamantite:src/commands/**/*.ts"
11
+ - "adelrodriguez/adamantite:src/lib/execution/skill.ts"
12
+ - "adelrodriguez/adamantite:src/lib/toolchain/index.ts"
13
+ - "adelrodriguez/adamantite:src/lib/integrations/tooling/oxlint/plugins/**/*.ts"
14
+ - "adelrodriguez/adamantite:src/lib/integrations/tooling/knip/config.ts"
15
+ - "adelrodriguez/adamantite:src/lib/workspace/custom-rules/*"
16
+ - "adelrodriguez/adamantite:presets/lint/*.ts"
17
+ - "adelrodriguez/adamantite:presets/rules/*.ts"
12
18
  ---
13
19
 
14
20
  # Adamantite
15
21
 
16
- Adamantite is an opinionated preset package and CLI for modern TypeScript projects. Run
17
- commands from the target project's root and use its detected package manager.
18
-
19
- ## Quick start
20
-
21
- For a human-driven setup, run `npx adamantite init`. For an agent, prefer explicit
22
- non-interactive setup. Setup flags require `--non-interactive`, and at least one
23
- `--script` is required:
24
-
25
- ```shell
26
- npx adamantite init --non-interactive --script check --script fix --typescript --agents
27
- ```
28
-
29
- Repeat `--script`, `--preset`, and `--editor` for multiple values. Available values are:
30
-
31
- - Scripts: `check`, `fix`, `analyze`. In a detected monorepo, `analyze` also installs Sherif.
32
- - Presets: `react`, `react-strict`, `react-doctor`, `tanstack`, `nextjs`, `vue`, `effect`, `jest`,
33
- `vitest`, `node`, `strict`, `antislop`, `shadcn`;
34
- editors: `vscode`, `zed`
35
- - Optional flags: `--typescript`, `--install-extensions`, `--github-actions`, `--agents`,
36
- `--overwrite-scripts`
37
-
38
- The `react-strict` preset needs no extra package. Its `adamantite/no-react-state-hooks` rule
39
- reports React state, effect, and memoization hooks outside hook modules (`useCart.ts`,
40
- `use-cart.ts`, and files under `hooks/`), and each message tells what to do instead. Do not move a hook call into
41
- a hook module only to silence the rule: follow the message. Set the rule's `allow` option
42
- when the project keeps hooks elsewhere.
43
-
44
- The `strict` preset needs no extra package either. Its `adamantite/no-overzealous-destructuring`
45
- rule reports destructuring nested more than 2 levels deep or object patterns with more than 5
46
- properties; keep the object and read its members, or split the pattern. Do not raise
47
- `maxDepth` or `maxProperties` only to silence a report. The preset also bans type assertions
48
- outside tests.
49
-
50
- The `tanstack` preset needs no extra package. Its `adamantite/query-from-loader` rule reports
51
- TanStack Query hooks in route files (files that call `createFileRoute`, `createRoute`, or another
52
- route factory from `@tanstack/react-router`) that take a plain options object or a `queryOptions()` call made inside a
53
- function; define the query once with `queryOptions()` at module scope or in an exported factory,
54
- preload it in the route loader with `ensureQueryData()`, and pass the same options to the hook. For
55
- `useInfiniteQuery` and `useSuspenseInfiniteQuery`, use `infiniteQueryOptions()` and
56
- `ensureInfiniteQueryData()`. Its
57
- `adamantite/no-query-data-in-state` rule reports `useState` initialized from query data; read the
58
- value from the query result and keep only the user's edits in state. Do not wrap options in a
59
- spread object, or move the hook out of the route file, only to silence `query-from-loader`.
60
-
61
- The `react-doctor` preset requires the `react` preset and the `oxlint-plugin-react-doctor`
62
- package, which `init` installs at a pinned version and doctor and `update` keep in sync. It
63
- enables curated React Doctor rules for React state and effect misuse, such as
64
- `no-effect-event-handler` and `no-fetch-in-effect`, and adds to `react-strict`. The package has
65
- a modified MIT license: using it as machine learning training data or selling it as a
66
- hosted product needs written permission from the copyright holder. Tell the user before you
67
- select the preset.
68
-
69
- The `effect` preset needs the `@effect/tsgo` package, which `init` installs at a pinned
70
- version and doctor and `update` keep in sync. Its rules exist only in Oxlint binaries that
71
- `adamantite prepare` patched, so the `prepare` script in `package.json` must run
72
- `adamantite prepare`; without the patch, Oxlint stops with `Unknown plugin: 'effecttsgo'`.
73
- Do not remove the patch or the preset to get past that error: run `adamantite prepare`. If a
74
- production-only install fails at `adamantite prepare`, add `--ignore-scripts` to that
75
- install instead of changing the script. `tsconfig.json` needs
76
- `{ "name": "@effect/language-service", "diagnostics": false }` in `compilerOptions.plugins`,
77
- and `knip.config.ts` needs `ignoreDependencies.effect`. To allow an unstable Effect module
78
- on purpose, add it to `allowedUnstableApis` in that tsconfig entry. Do not turn off
79
- `effecttsgo/unstable-api-usage`. In Effect 4.0.2 and later, the platform modules (such as
80
- `effect/FileSystem` and `effect/Path`), `@effect/platform-node`, and `@effect/vitest` are
81
- unstable. An entry can be a module or a full package.
82
-
83
- The `shadcn` preset needs Tailwind v4 and the `@shadcn/lint` package, which `init` installs
84
- at a pinned version and doctor and `update` keep in sync. The plugin finds components and
85
- the theme through `components.json`. Without that file it looks in `components/ui` or
86
- `src/components/ui` and discovers the stylesheet that imports Tailwind; when components
87
- live elsewhere, set `settings.shadcn` (for example `{ ui: "@/ds" }`) in `oxlint.config.ts`.
88
- The preset turns off the component-owned rules under `**/components/ui/**`; add the same
89
- override for another component directory.
90
-
91
- Adamantite requires TypeScript 7 or later as a dependency in the project's own
92
- `package.json`. Without that entry, npm cannot add or update a managed plugin.
93
-
94
- Only select options supported by the project. Presets and TypeScript require `check` or `fix`;
95
- extension installation requires an editor; `--github-actions` requires a CI-compatible script
96
- and a supported package manager (bun, deno, npm, pnpm, or yarn). Omitted boolean flags are
97
- disabled.
98
-
99
- Existing package scripts whose commands differ from Adamantite's are kept and reported,
100
- not replaced; pass `--overwrite-scripts` to replace them. Custom flags can be forwarded
101
- to the Adamantite command after `--`, e.g. `adamantite analyze -- --directory packages/app`.
102
-
103
- ## Daily workflow
104
-
105
- Use the scripts written by `init` when available. Otherwise invoke the CLI directly:
106
-
107
- ```shell
108
- adamantite check
109
- adamantite fix
110
- adamantite analyze
111
- ```
112
-
113
- - Use `check` for read-only formatting, lint, and type-error validation. `check --only lint` or `check --only format`
114
- runs one stage.
115
- - Use `fix` for automatic Oxlint fixes followed by Oxfmt formatting. Add `--suggested`, `--dangerous`, or `--all` only
116
- with explicit permission after reviewing their impact. `fix --only lint` or `fix --only format` runs one stage.
117
- - Use `analyze` for unused dependencies, exports, and files. In a monorepo it first checks
118
- workspace dependency consistency with Sherif. `analyze --only monorepo` or
119
- `analyze --only unused` runs one stage. `analyze --fix` may remove files, so inspect
120
- findings before using it. Sherif refuses to fix when `CI` is set, so in a monorepo
121
- `analyze --fix` fails there; use `analyze --only unused --fix` for the Knip fixes.
122
- - In a monorepo, `analyze --fix` needs a terminal when Sherif must choose between versions.
123
- Without a terminal, set `"sherif": { "select": "highest" }` in the root `package.json`, or
124
- use `analyze --only unused --fix` to skip Sherif.
125
- - `analyze` runs Sherif without flags. Put Sherif exceptions in the `sherif` field of the root
126
- `package.json` (camelCase CLI options, e.g. `"ignoreDependency": ["tailwindcss"]`).
127
-
128
- To pass arguments to Knip, Oxlint, or Sherif, place them after `--`. For `check` and `fix` they
129
- go to Oxlint. For `analyze` they go to Knip, or to the stage that `--only` selects, so a Sherif
130
- flag needs `--only monorepo`. For a permanent Sherif setting, use the `sherif` field instead.
131
-
132
- ```shell
133
- adamantite check src -- --deny-warnings
134
- bun run analyze -- -- --directory packages/app
135
- adamantite analyze --only monorepo -- --ignore-package package-a
136
- ```
137
-
138
- ## Diagnose and repair
139
-
140
- Run the read-only assessment:
141
-
142
- ```shell
143
- adamantite doctor
144
- ```
145
-
146
- Follow each finding. Doctor supplies the current state, the goal criteria, reference
147
- content when needed, and the verification command. In an interactive terminal, Doctor
148
- offers to hand off to an installed coding agent CLI, or to copy the combined Markdown prompt. In a
149
- non-interactive run — the path an agent uses — Doctor prints Markdown directly. Findings
150
- produce a repair prompt and exit 1. Assessment warnings alone produce a warning report
151
- and exit 0. Run `adamantite doctor` again until it exits 0.
152
-
153
- ## Update
154
-
155
- For an existing installation, run:
156
-
157
- ```shell
158
- adamantite update
159
- adamantite doctor
160
- ```
161
-
162
- `update` updates Adamantite-managed dependencies and, with the effect preset, patches Oxlint
163
- and TypeScript again. It then reports any remaining doctor findings. Follow those findings and review the resulting diff.
22
+ Use Adamantite to maintain the code-quality tools of a target project, the project that
23
+ Adamantite configures or checks.
24
+
25
+ ## Select the task
26
+
27
+ Read the target project's instructions and package scripts. Run commands from its root
28
+ with its package manager and installed Adamantite version. Use `adamantite <command> --help`
29
+ to check options that the task needs.
30
+
31
+ Use the section below that matches the request. Read a linked guide only when that case
32
+ applies. Continue when you have identified the target project, command, and requested scope.
33
+
34
+ ## Set up a target project
35
+
36
+ For a new installation, follow [How to set up Adamantite](references/setup.md).
37
+ Use Doctor for drift in an existing installation. A code-quality failure belongs in the
38
+ checks below, rather than another initialization.
39
+
40
+ Setup is complete when the selected scripts run and Doctor reports no findings.
41
+
42
+ ## Check and fix code
43
+
44
+ Use the project's managed scripts when they exist. Otherwise, run the CLI through the
45
+ project's package manager:
46
+
47
+ - Run `adamantite check` for read-only formatting, lint, and type checks. Fix warnings
48
+ instead of adding `--allow-warnings` to pass the check.
49
+ - Run `adamantite fix` for safe lint fixes and formatting. Review the effect and get explicit
50
+ permission before using `--suggested`, `--dangerous`, or `--all`.
51
+ - Run `adamantite analyze` for unused files, exports, and dependencies. In a monorepo it
52
+ runs Sherif before Knip. Inspect the findings before using `--fix`, which can remove files.
53
+
54
+ To repair preset rule reports or change their configuration, follow
55
+ [How to repair preset rule reports](references/lint-rules.md).
56
+
57
+ Pass underlying tool arguments after `--`. For `check` and `fix`, they go to Oxlint unless
58
+ `--only` selects another stage. For `analyze`, they go to Knip unless `--only` selects
59
+ Sherif. For example, use `adamantite analyze --only monorepo -- --select highest`.
60
+ When a package manager consumes a separator, add another, as in
61
+ `npm run analyze -- -- --directory packages/app`.
62
+
63
+ If Sherif needs a version choice without a terminal, set `sherif.select` to `"highest"`
64
+ in the root `package.json`, or pass `--select highest` to the monorepo stage.
65
+ Keep permanent Sherif settings in that `sherif` object, with camelCase option names.
66
+ Sherif refuses fixes when `CI` is set. Use `analyze --only unused --fix` to run only Knip fixes there.
67
+
68
+ The task is complete when the affected checks exit 0 and you have read their output.
69
+
70
+ ## Repair managed setup
71
+
72
+ Run `adamantite doctor`. It assesses managed integrations without changing files.
73
+ Without a terminal, it prints a Markdown repair prompt and exits 1 when findings remain.
74
+ Follow each finding's current state, goal, reference, and verification command.
75
+ For old layer-map declarations, use the migration step in
76
+ [Configure layer maps and import owners](references/lint-rules.md#configure-layer-maps-and-import-owners).
77
+ For a finding about the previous custom-rules API, use the migration step in
78
+ [How to write and verify custom rules](references/custom-rules.md#repair-an-existing-rules-folder).
79
+
80
+ Run Doctor again after the repair. This step is complete when Doctor exits 0 with no
81
+ findings. Report assessment warnings separately, because warnings alone also exit 0.
82
+
83
+ ## Update managed dependencies
84
+
85
+ Run `adamantite update`. It updates managed dependencies and refreshes stale skill copies
86
+ that `init` installed from the package. It reports remaining setup findings but can exit 0
87
+ with findings still present.
88
+
89
+ Follow the repair step above. The update is complete when Doctor reports no findings and
90
+ the project's checks pass.
91
+
92
+ ## Harden coding standards
93
+
94
+ Run `adamantite harden` and follow its Markdown prompt. Use `--path` to limit the scope
95
+ when the request covers one package or folder. Show the candidate standards and wait for
96
+ the user's approval before writing. If no human can approve, report the candidates and stop.
97
+
98
+ For rule trials that the prompt requests, follow the trial step in
99
+ [How to repair preset rule reports](references/lint-rules.md#try-a-rule-setting).
100
+ For approved custom rules, follow [How to write and verify custom rules](references/custom-rules.md).
101
+
102
+ A non-interactive `harden` run only prints the prompt. Its exit code does not verify the
103
+ work. Hardening is complete when the approved standards are enforced, the checks pass,
104
+ and Doctor reports no findings.
164
105
 
165
106
  ## Custom rules
166
107
 
167
- <!-- Keep this section the same as the AGENTS.md text in src/lib/workspace/custom-rules.ts. -->
168
-
169
- Each file in the rules folder, `.adamantite/rules/` by default, is an Oxlint rule that this
170
- project owns. `custom()` from `adamantite/lint/custom` loads the folder and enables each
171
- rule as `error` under the `project` plugin: `no-process-env.ts` becomes
172
- `project/no-process-env`. Add a file to add a rule. Delete the file to remove the rule.
173
- `adamantite rule add <name>` writes a correct stub.
174
-
175
- - A file that starts with `_`, such as `_helpers.ts`, is a helper, not a rule. Subfolders are
176
- not read.
177
- - Export the rule as default with `defineRule` from `adamantite/rules`. The same module exports
178
- the `Context`, `Rule`, `Visitor`, and `ESTree` node types.
179
- - Use `createOnce`. It runs one time for each lint run, not one time for each file. Reset
180
- per-file state in `before`, and report collected results in `after`. `context.filename`,
181
- `context.sourceCode`, and `context.settings` are not available in the body of
182
- `createOnce`. Read them in `before` or in a visitor.
183
- - Write erasable TypeScript only. Oxlint loads rule files with Node.js type stripping, so
184
- `enum`, a `namespace` with values, parameter properties, and `import x = require()` stop
185
- the lint run.
186
- - Rules get no type information. Use only the AST and `context.sourceCode`.
187
- - Report with a `messageId`, and put each message in `meta.messages`. Describe the options in
188
- `meta.schema`, and read them from `context.options`.
189
- - A rule that throws prints an error for each file, and the lint run still exits 0. After you
190
- change a rule, run the lint and read all of its output.
191
- - To find node names, run `adamantite rule ast <file>` on real code. It prints the same
192
- ESTree-shaped AST that rules visit.
193
- - To test a rule, use `RuleTester` from `oxlint/plugins-dev`. Adamantite does not run rule
194
- tests.
195
- - Oxlint caches the rules for each run. Restart the editor language server after you change a
196
- rule.
197
- - TypeScript does not check `.adamantite/rules/` by default, because its name starts with a dot. Add
198
- `".adamantite/rules"` to `include` in `tsconfig.json` to check it.
199
- - In a monorepo, give each rules folder its own plugin name, such as `custom({ name: "web" })`:
200
- Oxlint rejects two plugins with the same name in one run. A relative `dir` resolves from the
201
- file that calls `custom()`, so a shared tooling package can own the rules with
202
- `custom({ dir: "rules", name: "acme" })`. A nested Oxlint config replaces the root config, so
203
- a package that needs the root rules extends the root config.
204
-
205
- ## Decision guide
206
-
207
- - New target project: `init`, then run the configured checks.
208
- - Suspected drift or broken setup: run `doctor` and follow its findings.
209
- - Existing project upgrading Adamantite: `update`, then the doctor sequence.
210
- - Code-quality failure: choose `check` or `analyze` based on the failing subsystem; do not
211
- reinitialize the project.
212
- - Project-specific lint rule: add a custom rule with `adamantite rule add <name>`; do not
213
- edit Adamantite presets.
214
- - Unknown option or behavior: run `adamantite <command> --help` before guessing.
108
+ To add, change, verify, or save tests for a project-owned rule, follow
109
+ [How to write and verify custom rules](references/custom-rules.md).
110
+
111
+ The task is complete when the guide's verification and cleanup checks pass.
112
+
113
+ ## Report the result
114
+
115
+ If a required tool or source was unavailable, name it on the first line and state what you
116
+ used instead. Report the changes, commands run, results, and remaining findings or warnings.
117
+ For a custom rule, include the cases tested and whether you removed temporary verification files.
118
+
119
+ The report is complete when every result has command output or an inspected artifact as evidence.
120
+
121
+ ## Check the result
122
+
123
+ - The selected command matches the requested task and scope.
124
+ - The affected checks passed, or the report names the checks that remain unverified.
125
+ - Doctor findings and assessment warnings are reported separately.
126
+ - Every new or changed custom rule passed verification, and temporary cases are removed.