@savvy-web/mcp 1.3.4 → 1.4.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.
- package/LICENSE +21 -0
- package/README.md +1 -11
- package/bin/savvy-mcp.js +2 -11
- package/index.d.ts +4 -87
- package/package.json +2 -3
- package/server.js +3 -30
- package/tools/biome-check.js +1 -1
- package/public/content/_templates/guides.md +0 -12
- package/public/content/_templates/packages.md +0 -21
- package/public/content/_templates/standards.md +0 -17
- package/public/content/guides/api-docs-from-api-extractor.md +0 -174
- package/public/content/guides/building-a-github-action.md +0 -233
- package/public/content/guides/choosing-a-builder.md +0 -93
- package/public/content/guides/llm-friendly-json-schemas.md +0 -64
- package/public/content/manifest.json +0 -10278
- package/public/content/packages/bundler/api/function/definebuild.md +0 -18
- package/public/content/packages/bundler/api/function/parseargs.md +0 -18
- package/public/content/packages/bundler/api/function/runbuild.md +0 -18
- package/public/content/packages/bundler/api/interface/buildconfig.md +0 -147
- package/public/content/packages/bundler/api/interface/buildconfiginput.md +0 -153
- package/public/content/packages/bundler/api/interface/buildentryoverride.md +0 -86
- package/public/content/packages/bundler/api/interface/outputconfig.md +0 -34
- package/public/content/packages/bundler/api/interface/parsedargs.md +0 -44
- package/public/content/packages/bundler/api/interface/runoptions.md +0 -150
- package/public/content/packages/bundler/api.md +0 -27
- package/public/content/packages/bundler/overview.md +0 -89
- package/public/content/packages/cli/command-tree.md +0 -68
- package/public/content/packages/cli/init-and-check.md +0 -53
- package/public/content/packages/github-action-builder/api/class/actionymlmissing.md +0 -30
- package/public/content/packages/github-action-builder/api/class/actionymlpatherror.md +0 -48
- package/public/content/packages/github-action-builder/api/class/actionymlschemaerror.md +0 -45
- package/public/content/packages/github-action-builder/api/class/actionymlsyntaxerror.md +0 -57
- package/public/content/packages/github-action-builder/api/class/buildfailed.md +0 -39
- package/public/content/packages/github-action-builder/api/class/bundlefailed.md +0 -39
- package/public/content/packages/github-action-builder/api/class/cleanerror.md +0 -39
- package/public/content/packages/github-action-builder/api/class/configinvalid.md +0 -39
- package/public/content/packages/github-action-builder/api/class/configloadfailed.md +0 -39
- package/public/content/packages/github-action-builder/api/class/confignotfound.md +0 -39
- package/public/content/packages/github-action-builder/api/class/entryfilemissing.md +0 -39
- package/public/content/packages/github-action-builder/api/class/githubaction.md +0 -101
- package/public/content/packages/github-action-builder/api/class/mainentrymissing.md +0 -39
- package/public/content/packages/github-action-builder/api/class/persistlocalerror.md +0 -39
- package/public/content/packages/github-action-builder/api/class/validationfailed.md +0 -48
- package/public/content/packages/github-action-builder/api/class/workerentryinvalidname.md +0 -37
- package/public/content/packages/github-action-builder/api/class/workerentrymissing.md +0 -44
- package/public/content/packages/github-action-builder/api/class/writeerror.md +0 -39
- package/public/content/packages/github-action-builder/api/function/defineconfig.md +0 -68
- package/public/content/packages/github-action-builder/api/interface/buildservice.md +0 -83
- package/public/content/packages/github-action-builder/api/interface/configservice.md +0 -66
- package/public/content/packages/github-action-builder/api/interface/githubactionoptions.md +0 -60
- package/public/content/packages/github-action-builder/api/interface/loadconfigresult.md +0 -44
- package/public/content/packages/github-action-builder/api/interface/persistlocalservice.md +0 -37
- package/public/content/packages/github-action-builder/api/interface/validationservice.md +0 -82
- package/public/content/packages/github-action-builder/api/type/actionymlresult.md +0 -18
- package/public/content/packages/github-action-builder/api/type/apperror.md +0 -18
- package/public/content/packages/github-action-builder/api/type/builderror.md +0 -18
- package/public/content/packages/github-action-builder/api/type/buildoptions.md +0 -18
- package/public/content/packages/github-action-builder/api/type/buildresult.md +0 -18
- package/public/content/packages/github-action-builder/api/type/buildrunneroptions.md +0 -18
- package/public/content/packages/github-action-builder/api/type/bundleresult.md +0 -18
- package/public/content/packages/github-action-builder/api/type/bundlestats.md +0 -18
- package/public/content/packages/github-action-builder/api/type/config.md +0 -18
- package/public/content/packages/github-action-builder/api/type/configerror.md +0 -18
- package/public/content/packages/github-action-builder/api/type/configinput.md +0 -18
- package/public/content/packages/github-action-builder/api/type/detectedentry.md +0 -18
- package/public/content/packages/github-action-builder/api/type/detectentriesresult.md +0 -18
- package/public/content/packages/github-action-builder/api/type/entries.md +0 -18
- package/public/content/packages/github-action-builder/api/type/githubactionbuildresult.md +0 -18
- package/public/content/packages/github-action-builder/api/type/loadconfigoptions.md +0 -18
- package/public/content/packages/github-action-builder/api/type/persisterror.md +0 -18
- package/public/content/packages/github-action-builder/api/type/persistlocaloptions.md +0 -18
- package/public/content/packages/github-action-builder/api/type/persistlocalresult.md +0 -18
- package/public/content/packages/github-action-builder/api/type/persistlocalrunneroptions.md +0 -18
- package/public/content/packages/github-action-builder/api/type/validateoptions.md +0 -18
- package/public/content/packages/github-action-builder/api/type/validationerror.md +0 -20
- package/public/content/packages/github-action-builder/api/type/validationerroritem.md +0 -18
- package/public/content/packages/github-action-builder/api/type/validationoptions.md +0 -18
- package/public/content/packages/github-action-builder/api/type/validationresult.md +0 -18
- package/public/content/packages/github-action-builder/api/type/validationwarning.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/actionymlmissingbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/actionymlpatherrorbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/actionymlresultschema.md +0 -33
- package/public/content/packages/github-action-builder/api/variable/actionymlschemaerrorbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/actionymlsyntaxerrorbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/applayer.md +0 -38
- package/public/content/packages/github-action-builder/api/variable/buildfailedbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/buildlayer.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/buildoptionsschema.md +0 -31
- package/public/content/packages/github-action-builder/api/variable/buildresultschema.md +0 -32
- package/public/content/packages/github-action-builder/api/variable/buildrunneroptionsschema.md +0 -21
- package/public/content/packages/github-action-builder/api/variable/buildservice.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/bundlefailedbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/bundleresultschema.md +0 -27
- package/public/content/packages/github-action-builder/api/variable/bundlestatsschema.md +0 -23
- package/public/content/packages/github-action-builder/api/variable/cleanerrorbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/configinputschema.md +0 -41
- package/public/content/packages/github-action-builder/api/variable/configinvalidbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/configlayer.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/configloadfailedbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/confignotfoundbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/configschema.md +0 -59
- package/public/content/packages/github-action-builder/api/variable/configservice.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/detectedentryschema.md +0 -22
- package/public/content/packages/github-action-builder/api/variable/detectentriesresultschema.md +0 -25
- package/public/content/packages/github-action-builder/api/variable/entriesschema.md +0 -25
- package/public/content/packages/github-action-builder/api/variable/entryfilemissingbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/githubactionbuildresultschema.md +0 -60
- package/public/content/packages/github-action-builder/api/variable/loadconfigoptionsschema.md +0 -21
- package/public/content/packages/github-action-builder/api/variable/mainentrymissingbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/persistlocalerrorbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/persistlocallayer.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/persistlocaloptionsschema.md +0 -28
- package/public/content/packages/github-action-builder/api/variable/persistlocalresultschema.md +0 -25
- package/public/content/packages/github-action-builder/api/variable/persistlocalrunneroptionsschema.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/persistlocalservice.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/validateoptionsschema.md +0 -21
- package/public/content/packages/github-action-builder/api/variable/validationerrorschema.md +0 -23
- package/public/content/packages/github-action-builder/api/variable/validationfailedbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/validationlayer.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/validationoptionsschema.md +0 -24
- package/public/content/packages/github-action-builder/api/variable/validationresultschema.md +0 -32
- package/public/content/packages/github-action-builder/api/variable/validationservice.md +0 -18
- package/public/content/packages/github-action-builder/api/variable/validationwarningschema.md +0 -23
- package/public/content/packages/github-action-builder/api/variable/workerentryinvalidnamebase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/workerentrymissingbase.md +0 -20
- package/public/content/packages/github-action-builder/api/variable/writeerrorbase.md +0 -20
- package/public/content/packages/github-action-builder/api.md +0 -125
- package/public/content/packages/github-action-effects/api/class/actioncache.md +0 -18
- package/public/content/packages/github-action-effects/api/class/actioncacheerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/actionenvironment.md +0 -18
- package/public/content/packages/github-action-effects/api/class/actionenvironmenterror.md +0 -37
- package/public/content/packages/github-action-effects/api/class/actioninputerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/actionlogger.md +0 -18
- package/public/content/packages/github-action-effects/api/class/actionoutputerror.md +0 -37
- package/public/content/packages/github-action-effects/api/class/actionoutputs.md +0 -18
- package/public/content/packages/github-action-effects/api/class/actionstate.md +0 -18
- package/public/content/packages/github-action-effects/api/class/actionstateerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/artifact.md +0 -18
- package/public/content/packages/github-action-effects/api/class/artifacterror.md +0 -53
- package/public/content/packages/github-action-effects/api/class/attest.md +0 -18
- package/public/content/packages/github-action-effects/api/class/attesterror.md +0 -42
- package/public/content/packages/github-action-effects/api/class/blobstore.md +0 -18
- package/public/content/packages/github-action-effects/api/class/blobstoreerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/changesetanalyzer.md +0 -18
- package/public/content/packages/github-action-effects/api/class/changeseterror.md +0 -37
- package/public/content/packages/github-action-effects/api/class/checkrun.md +0 -18
- package/public/content/packages/github-action-effects/api/class/checkrunerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/commandrunner.md +0 -18
- package/public/content/packages/github-action-effects/api/class/commandrunnererror.md +0 -73
- package/public/content/packages/github-action-effects/api/class/configloader.md +0 -18
- package/public/content/packages/github-action-effects/api/class/configloadererror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/dryrun.md +0 -18
- package/public/content/packages/github-action-effects/api/class/gitbranch.md +0 -18
- package/public/content/packages/github-action-effects/api/class/gitbrancherror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/gitcommit.md +0 -18
- package/public/content/packages/github-action-effects/api/class/gitcommiterror.md +0 -37
- package/public/content/packages/github-action-effects/api/class/githubapp.md +0 -18
- package/public/content/packages/github-action-effects/api/class/githubapperror.md +0 -37
- package/public/content/packages/github-action-effects/api/class/githubartifactmetadata.md +0 -18
- package/public/content/packages/github-action-effects/api/class/githubartifactmetadataerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/githubclient.md +0 -18
- package/public/content/packages/github-action-effects/api/class/githubclienterror.md +0 -60
- package/public/content/packages/github-action-effects/api/class/githubcommit.md +0 -18
- package/public/content/packages/github-action-effects/api/class/githubcommiterror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/githubcontent.md +0 -18
- package/public/content/packages/github-action-effects/api/class/githubcontenterror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/githubgraphql.md +0 -18
- package/public/content/packages/github-action-effects/api/class/githubgraphqlerror.md +0 -48
- package/public/content/packages/github-action-effects/api/class/githubissue.md +0 -18
- package/public/content/packages/github-action-effects/api/class/githubissueerror.md +0 -51
- package/public/content/packages/github-action-effects/api/class/githubrelease.md +0 -18
- package/public/content/packages/github-action-effects/api/class/githubreleaseerror.md +0 -51
- package/public/content/packages/github-action-effects/api/class/gittag.md +0 -18
- package/public/content/packages/github-action-effects/api/class/gittagerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/glob.md +0 -18
- package/public/content/packages/github-action-effects/api/class/globerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/intotostatement.md +0 -18
- package/public/content/packages/github-action-effects/api/class/intotosubject.md +0 -18
- package/public/content/packages/github-action-effects/api/class/ioerror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/npmregistry.md +0 -18
- package/public/content/packages/github-action-effects/api/class/npmregistryerror.md +0 -50
- package/public/content/packages/github-action-effects/api/class/octokitauthapp.md +0 -18
- package/public/content/packages/github-action-effects/api/class/oidctokenerror.md +0 -42
- package/public/content/packages/github-action-effects/api/class/oidctokenissuer.md +0 -18
- package/public/content/packages/github-action-effects/api/class/packagemanageradapter.md +0 -18
- package/public/content/packages/github-action-effects/api/class/packagemanagererror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/packagepublish.md +0 -18
- package/public/content/packages/github-action-effects/api/class/packagepublisherror.md +0 -68
- package/public/content/packages/github-action-effects/api/class/pullrequest.md +0 -18
- package/public/content/packages/github-action-effects/api/class/pullrequestcomment.md +0 -18
- package/public/content/packages/github-action-effects/api/class/pullrequestcommenterror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/pullrequesterror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/ratelimiter.md +0 -18
- package/public/content/packages/github-action-effects/api/class/ratelimiterror.md +0 -51
- package/public/content/packages/github-action-effects/api/class/runtimeenvironmenterror.md +0 -37
- package/public/content/packages/github-action-effects/api/class/sbom.md +0 -18
- package/public/content/packages/github-action-effects/api/class/sbomerror.md +0 -42
- package/public/content/packages/github-action-effects/api/class/semverresolvererror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/sigstorebundle.md +0 -18
- package/public/content/packages/github-action-effects/api/class/sigstoresigner.md +0 -18
- package/public/content/packages/github-action-effects/api/class/sigstoresignererror.md +0 -42
- package/public/content/packages/github-action-effects/api/class/slsaerror.md +0 -42
- package/public/content/packages/github-action-effects/api/class/tokenpermissionchecker.md +0 -18
- package/public/content/packages/github-action-effects/api/class/tokenpermissionerror.md +0 -58
- package/public/content/packages/github-action-effects/api/class/toolinstaller.md +0 -18
- package/public/content/packages/github-action-effects/api/class/toolinstallererror.md +0 -58
- package/public/content/packages/github-action-effects/api/class/workflowdispatch.md +0 -18
- package/public/content/packages/github-action-effects/api/class/workflowdispatcherror.md +0 -44
- package/public/content/packages/github-action-effects/api/class/workspacedetector.md +0 -18
- package/public/content/packages/github-action-effects/api/class/workspacedetectorerror.md +0 -35
- package/public/content/packages/github-action-effects/api/function/attesttestfulllayer.md +0 -19
- package/public/content/packages/github-action-effects/api/function/buildslsaprovenancepredicate.md +0 -23
- package/public/content/packages/github-action-effects/api/function/buildstatement.md +0 -29
- package/public/content/packages/github-action-effects/api/function/decodejwtclaims.md +0 -18
- package/public/content/packages/github-action-effects/api/function/dryrunlive.md +0 -18
- package/public/content/packages/github-action-effects/api/function/generatepackageviewurl.md +0 -27
- package/public/content/packages/github-action-effects/api/function/getregistrydisplayname.md +0 -26
- package/public/content/packages/github-action-effects/api/function/getregistrytype.md +0 -26
- package/public/content/packages/github-action-effects/api/function/iscustomregistry.md +0 -26
- package/public/content/packages/github-action-effects/api/function/isgithubpackagesregistry.md +0 -26
- package/public/content/packages/github-action-effects/api/function/isjsrregistry.md +0 -26
- package/public/content/packages/github-action-effects/api/function/isnpmregistry.md +0 -26
- package/public/content/packages/github-action-effects/api/function/makeattestteststate.md +0 -18
- package/public/content/packages/github-action-effects/api/function/makesbomteststate.md +0 -18
- package/public/content/packages/github-action-effects/api/function/makesigstoresignerlive.md +0 -18
- package/public/content/packages/github-action-effects/api/function/npmpurl.md +0 -18
- package/public/content/packages/github-action-effects/api/function/resilienceschedule.md +0 -18
- package/public/content/packages/github-action-effects/api/function/s3blobstorelive.md +0 -18
- package/public/content/packages/github-action-effects/api/function/savetoken.md +0 -18
- package/public/content/packages/github-action-effects/api/function/serializestatement.md +0 -18
- package/public/content/packages/github-action-effects/api/function/subject.md +0 -23
- package/public/content/packages/github-action-effects/api/function/tokenpermissioncheckerlive.md +0 -18
- package/public/content/packages/github-action-effects/api/interface/accumulateresult.md +0 -35
- package/public/content/packages/github-action-effects/api/interface/actioncacheteststate.md +0 -26
- package/public/content/packages/github-action-effects/api/interface/actionloggerteststate.md +0 -59
- package/public/content/packages/github-action-effects/api/interface/actionoutputsteststate.md +0 -56
- package/public/content/packages/github-action-effects/api/interface/actionrunoptions.md +0 -28
- package/public/content/packages/github-action-effects/api/interface/actionstateteststate.md +0 -28
- package/public/content/packages/github-action-effects/api/interface/annotationproperties.md +0 -68
- package/public/content/packages/github-action-effects/api/interface/appauth.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/artifactitem.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/artifactteststate.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/attestationlistentry.md +0 -36
- package/public/content/packages/github-action-effects/api/interface/attestationrecord.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/attestinput.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/attestteststate.md +0 -111
- package/public/content/packages/github-action-effects/api/interface/blobstoreteststate.md +0 -26
- package/public/content/packages/github-action-effects/api/interface/botidentity.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/changesetanalyzerteststate.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/checkrunannotation.md +0 -56
- package/public/content/packages/github-action-effects/api/interface/checkrundata.md +0 -50
- package/public/content/packages/github-action-effects/api/interface/checkrunoutput.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/checkrunrecord.md +0 -62
- package/public/content/packages/github-action-effects/api/interface/checkrunteststate.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/commandresponse.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/commentrecord.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/commitcomparison.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/commitdetail.md +0 -28
- package/public/content/packages/github-action-effects/api/interface/commitfile.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/commitsummary.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/configloaderteststate.md +0 -28
- package/public/content/packages/github-action-effects/api/interface/dispatchrecord.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/downloadoptions.md +0 -28
- package/public/content/packages/github-action-effects/api/interface/dryrunresult.md +0 -60
- package/public/content/packages/github-action-effects/api/interface/dryrunteststate.md +0 -26
- package/public/content/packages/github-action-effects/api/interface/execoptions.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/execoutput.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/findby.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/gitbranchteststate.md +0 -26
- package/public/content/packages/github-action-effects/api/interface/gitcommitteststate.md +0 -51
- package/public/content/packages/github-action-effects/api/interface/githubappteststate.md +0 -54
- package/public/content/packages/github-action-effects/api/interface/githubartifactmetadatateststate.md +0 -36
- package/public/content/packages/github-action-effects/api/interface/githubclientteststate.md +0 -47
- package/public/content/packages/github-action-effects/api/interface/githubcommitteststate.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/githubcontentteststate.md +0 -28
- package/public/content/packages/github-action-effects/api/interface/githubgraphqlteststate.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/githubissueteststate.md +0 -53
- package/public/content/packages/github-action-effects/api/interface/githubreleaseteststate.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/gittagteststate.md +0 -41
- package/public/content/packages/github-action-effects/api/interface/globoptions.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/globteststate.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/hashfilesoptions.md +0 -36
- package/public/content/packages/github-action-effects/api/interface/idempotentpublishinput.md +0 -66
- package/public/content/packages/github-action-effects/api/interface/idempotentpublishresult.md +0 -48
- package/public/content/packages/github-action-effects/api/interface/inflightpackage.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/installoptions.md +0 -36
- package/public/content/packages/github-action-effects/api/interface/issuedata.md +0 -60
- package/public/content/packages/github-action-effects/api/interface/npmregistryteststate.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/oidcclaims.md +0 -98
- package/public/content/packages/github-action-effects/api/interface/packagemanageradapterteststate.md +0 -47
- package/public/content/packages/github-action-effects/api/interface/packagepublishteststate.md +0 -121
- package/public/content/packages/github-action-effects/api/interface/packresult.md +0 -84
- package/public/content/packages/github-action-effects/api/interface/polloptions.md +0 -36
- package/public/content/packages/github-action-effects/api/interface/provenanceattestationinput.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/provisionoptions.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/publishtarballresult.md +0 -28
- package/public/content/packages/github-action-effects/api/interface/pullrequestcommentteststate.md +0 -35
- package/public/content/packages/github-action-effects/api/interface/pullrequestfile.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/pullrequestinfo.md +0 -106
- package/public/content/packages/github-action-effects/api/interface/pullrequestlistoptions.md +0 -60
- package/public/content/packages/github-action-effects/api/interface/pullrequestrecord.md +0 -74
- package/public/content/packages/github-action-effects/api/interface/pullrequestteststate.md +0 -54
- package/public/content/packages/github-action-effects/api/interface/ratelimiterteststate.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/registrytarget.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/releaseasset.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/releasedata.md +0 -62
- package/public/content/packages/github-action-effects/api/interface/report_2.md +0 -76
- package/public/content/packages/github-action-effects/api/interface/resilienceoptions.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/resolveddependency.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/restresponse.md +0 -26
- package/public/content/packages/github-action-effects/api/interface/s3blobstoreconfig.md +0 -62
- package/public/content/packages/github-action-effects/api/interface/sbomattestationinput.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/sbomauthor.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/sbomcontact.md +0 -38
- package/public/content/packages/github-action-effects/api/interface/sbominput.md +0 -88
- package/public/content/packages/github-action-effects/api/interface/sbomsupplier.md +0 -44
- package/public/content/packages/github-action-effects/api/interface/sbomteststate.md +0 -52
- package/public/content/packages/github-action-effects/api/interface/sigstoresignerconfig.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/storagerecordinput.md +0 -68
- package/public/content/packages/github-action-effects/api/interface/tagref.md +0 -34
- package/public/content/packages/github-action-effects/api/interface/tokenpermissioncheckerteststate.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/toolinstallerteststate.md +0 -97
- package/public/content/packages/github-action-effects/api/interface/uploadoptions.md +0 -36
- package/public/content/packages/github-action-effects/api/interface/uploadresult.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/workflowdispatchteststate.md +0 -40
- package/public/content/packages/github-action-effects/api/interface/workflowrunstatus.md +0 -32
- package/public/content/packages/github-action-effects/api/interface/workspacedetectorteststate.md +0 -32
- package/public/content/packages/github-action-effects/api/namespace/step.md +0 -16
- package/public/content/packages/github-action-effects/api/type/actionloglevel.md +0 -16
- package/public/content/packages/github-action-effects/api/type/annotationlevel.md +0 -18
- package/public/content/packages/github-action-effects/api/type/bumptype.md +0 -16
- package/public/content/packages/github-action-effects/api/type/capturedoutput.md +0 -16
- package/public/content/packages/github-action-effects/api/type/changeset.md +0 -16
- package/public/content/packages/github-action-effects/api/type/changesetfile.md +0 -16
- package/public/content/packages/github-action-effects/api/type/checklistitem.md +0 -16
- package/public/content/packages/github-action-effects/api/type/checkrunconclusion.md +0 -18
- package/public/content/packages/github-action-effects/api/type/coreservices.md +0 -18
- package/public/content/packages/github-action-effects/api/type/cyclonedxbom.md +0 -18
- package/public/content/packages/github-action-effects/api/type/extrapermission.md +0 -18
- package/public/content/packages/github-action-effects/api/type/filechange.md +0 -16
- package/public/content/packages/github-action-effects/api/type/githubcontext.md +0 -18
- package/public/content/packages/github-action-effects/api/type/installationtoken.md +0 -18
- package/public/content/packages/github-action-effects/api/type/loglevelinput.md +0 -16
- package/public/content/packages/github-action-effects/api/type/npmpackageinfo.md +0 -16
- package/public/content/packages/github-action-effects/api/type/packagemanagerinfo.md +0 -18
- package/public/content/packages/github-action-effects/api/type/packagemanagername.md +0 -18
- package/public/content/packages/github-action-effects/api/type/permissioncheckresult.md +0 -18
- package/public/content/packages/github-action-effects/api/type/permissiongap.md +0 -18
- package/public/content/packages/github-action-effects/api/type/permissionlevel.md +0 -18
- package/public/content/packages/github-action-effects/api/type/ratelimitstatus.md +0 -18
- package/public/content/packages/github-action-effects/api/type/registrytype.md +0 -18
- package/public/content/packages/github-action-effects/api/type/runnercontext.md +0 -18
- package/public/content/packages/github-action-effects/api/type/status.md +0 -16
- package/public/content/packages/github-action-effects/api/type/treeentry.md +0 -16
- package/public/content/packages/github-action-effects/api/type/webhookpayload.md +0 -18
- package/public/content/packages/github-action-effects/api/type/workspaceinfo.md +0 -16
- package/public/content/packages/github-action-effects/api/type/workspacepackage.md +0 -16
- package/public/content/packages/github-action-effects/api/type/workspacetype.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/action.md +0 -41
- package/public/content/packages/github-action-effects/api/variable/actioncachelive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/actioncachetest.md +0 -29
- package/public/content/packages/github-action-effects/api/variable/actionenvironmentlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/actionenvironmenttest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/actioninput.md +0 -31
- package/public/content/packages/github-action-effects/api/variable/actionloggerlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/actionloggertest.md +0 -29
- package/public/content/packages/github-action-effects/api/variable/actionloglevel.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/actionoutputslive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/actionoutputstest.md +0 -29
- package/public/content/packages/github-action-effects/api/variable/actionsconfigprovider.md +0 -27
- package/public/content/packages/github-action-effects/api/variable/actionslogger.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/actionsruntime.md +0 -36
- package/public/content/packages/github-action-effects/api/variable/actionstatelive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/actionstatetest.md +0 -29
- package/public/content/packages/github-action-effects/api/variable/artifactlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/artifacttest.md +0 -29
- package/public/content/packages/github-action-effects/api/variable/attestlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/attesttest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/automerge.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/blobstoretest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/bumptype.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/capturedoutput.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/changeset.md +0 -25
- package/public/content/packages/github-action-effects/api/variable/changesetanalyzerlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/changesetanalyzertest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/changesetfile.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/checklistitem.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/checkrunlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/checkruntest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/commandrunnerlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/commandrunnertest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/configloaderlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/configloadertest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/cyclonedx_bom.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/dryruntest.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/erroraccumulator.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/extrapermission.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/filechange.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/filechangecontent.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/filechangedeletion.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/gitbranchlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/gitbranchtest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/gitcommitlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/gitcommittest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/github_build_type.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/githubapplive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/githubapptest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/githubartifactmetadatalive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/githubartifactmetadatatest.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/githubblobstorelive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/githubclientlive.md +0 -26
- package/public/content/packages/github-action-effects/api/variable/githubclienttest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/githubcommitlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/githubcommittest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/githubcontentlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/githubcontenttest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/githubcontext.md +0 -35
- package/public/content/packages/github-action-effects/api/variable/githubgraphqllive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/githubgraphqltest.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/githubissuelive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/githubissuetest.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/githubmarkdown.md +0 -45
- package/public/content/packages/github-action-effects/api/variable/githubreleaselive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/githubreleasetest.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/githubtoken.md +0 -27
- package/public/content/packages/github-action-effects/api/variable/gittaglive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/gittagtest.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/globlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/globtest.md +0 -30
- package/public/content/packages/github-action-effects/api/variable/in_toto_payload_type.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/in_toto_statement_v1.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/installationtoken.md +0 -28
- package/public/content/packages/github-action-effects/api/variable/ioutil.md +0 -22
- package/public/content/packages/github-action-effects/api/variable/loglevelinput.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/npmpackageinfo.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/npmregistrylive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/npmregistrytest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/octokitauthapplive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/oidctokenissuerlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/oidctokenissuertest.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/packagemanageradapterlive.md +0 -19
- package/public/content/packages/github-action-effects/api/variable/packagemanageradaptertest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/packagemanagerinfo.md +0 -22
- package/public/content/packages/github-action-effects/api/variable/packagemanagername.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/packagepublishlive.md +0 -19
- package/public/content/packages/github-action-effects/api/variable/packagepublishtest.md +0 -27
- package/public/content/packages/github-action-effects/api/variable/pathutils.md +0 -31
- package/public/content/packages/github-action-effects/api/variable/permissioncheckresult.md +0 -31
- package/public/content/packages/github-action-effects/api/variable/permissiongap.md +0 -22
- package/public/content/packages/github-action-effects/api/variable/permissionlevel.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/pullrequestcommentlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/pullrequestcommenttest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/pullrequestlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/pullrequesttest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/ratelimiterlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/ratelimitertest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/ratelimitstatus.md +0 -23
- package/public/content/packages/github-action-effects/api/variable/reportbuilder.md +0 -33
- package/public/content/packages/github-action-effects/api/variable/runnercontext.md +0 -25
- package/public/content/packages/github-action-effects/api/variable/sbomlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/sbomtest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/semverresolver.md +0 -30
- package/public/content/packages/github-action-effects/api/variable/sigstore_bundle_v0_3_media_type.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/sigstore_oidc_audience.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/sigstoresignerlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/sigstoresignertest.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/slsa_provenance_v1.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/spdx_v2_3.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/status.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/tokenpermissioncheckertest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/toolinstallerlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/toolinstallertest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/treeentry.md +0 -26
- package/public/content/packages/github-action-effects/api/variable/treeentrycontent.md +0 -22
- package/public/content/packages/github-action-effects/api/variable/treeentrydeletion.md +0 -22
- package/public/content/packages/github-action-effects/api/variable/webhookpayload.md +0 -51
- package/public/content/packages/github-action-effects/api/variable/workflowdispatchlive.md +0 -16
- package/public/content/packages/github-action-effects/api/variable/workflowdispatchtest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/workspacedetectorlive.md +0 -18
- package/public/content/packages/github-action-effects/api/variable/workspacedetectortest.md +0 -21
- package/public/content/packages/github-action-effects/api/variable/workspaceinfo.md +0 -22
- package/public/content/packages/github-action-effects/api/variable/workspacepackage.md +0 -24
- package/public/content/packages/github-action-effects/api/variable/workspacetype.md +0 -18
- package/public/content/packages/github-action-effects/api.md +0 -386
- package/public/content/packages/mcp/resource-taxonomy.md +0 -63
- package/public/content/packages/rspress-builder/api/function/defineplugin.md +0 -18
- package/public/content/packages/rspress-builder/api/interface/rspressbundleoptions.md +0 -28
- package/public/content/packages/rspress-builder/api/interface/rspresspluginoptions.md +0 -76
- package/public/content/packages/rspress-builder/api.md +0 -21
- package/public/content/packages/silk/export-map.md +0 -67
- package/public/content/packages/silk/install-and-setup.md +0 -59
- package/public/content/packages/silk-effects/api/class/analyzedworkspace.md +0 -121
- package/public/content/packages/silk-effects/api/class/biomeschemasync.md +0 -33
- package/public/content/packages/silk-effects/api/class/biomesyncerror.md +0 -41
- package/public/content/packages/silk-effects/api/class/changesetconfig.md +0 -28
- package/public/content/packages/silk-effects/api/class/changesetconfigerror.md +0 -41
- package/public/content/packages/silk-effects/api/class/changesetconfigreader.md +0 -33
- package/public/content/packages/silk-effects/api/class/configdiscovery.md +0 -33
- package/public/content/packages/silk-effects/api/class/confignotfounderror.md +0 -41
- package/public/content/packages/silk-effects/api/class/managedsection.md +0 -18
- package/public/content/packages/silk-effects/api/class/resolvedtool.md +0 -62
- package/public/content/packages/silk-effects/api/class/sectionblock.md +0 -95
- package/public/content/packages/silk-effects/api/class/sectiondefinition.md +0 -104
- package/public/content/packages/silk-effects/api/class/sectionparseerror.md +0 -41
- package/public/content/packages/silk-effects/api/class/sectionvalidationerror.md +0 -41
- package/public/content/packages/silk-effects/api/class/sectionwriteerror.md +0 -41
- package/public/content/packages/silk-effects/api/class/shellsectiondefinition.md +0 -56
- package/public/content/packages/silk-effects/api/class/silkpublishability.md +0 -46
- package/public/content/packages/silk-effects/api/class/silkpublishconfig.md +0 -18
- package/public/content/packages/silk-effects/api/class/silkworkspaceanalyzer.md +0 -33
- package/public/content/packages/silk-effects/api/class/tagformaterror.md +0 -48
- package/public/content/packages/silk-effects/api/class/tagstrategy.md +0 -32
- package/public/content/packages/silk-effects/api/class/toolcommand.md +0 -76
- package/public/content/packages/silk-effects/api/class/tooldefinition.md +0 -73
- package/public/content/packages/silk-effects/api/class/tooldiscovery.md +0 -35
- package/public/content/packages/silk-effects/api/class/toolnotfounderror.md +0 -39
- package/public/content/packages/silk-effects/api/class/toolresolutionerror.md +0 -39
- package/public/content/packages/silk-effects/api/class/toolversionmismatcherror.md +0 -46
- package/public/content/packages/silk-effects/api/class/versioningdetectionerror.md +0 -34
- package/public/content/packages/silk-effects/api/class/versioningstrategy.md +0 -34
- package/public/content/packages/silk-effects/api/class/workspaceanalysis.md +0 -94
- package/public/content/packages/silk-effects/api/class/workspaceanalysiserror.md +0 -41
- package/public/content/packages/silk-effects/api/function/buildschemaurl.md +0 -26
- package/public/content/packages/silk-effects/api/function/extractsemver.md +0 -26
- package/public/content/packages/silk-effects/api/function/readtargetsbinding.md +0 -23
- package/public/content/packages/silk-effects/api/function/savvybasepreamble.md +0 -22
- package/public/content/packages/silk-effects/api/function/savvyhookshygiene.md +0 -22
- package/public/content/packages/silk-effects/api/function/savvytoolsection.md +0 -37
- package/public/content/packages/silk-effects/api/interface/commitlintplugin.md +0 -26
- package/public/content/packages/silk-effects/api/interface/commitlintuserconfig.md +0 -76
- package/public/content/packages/silk-effects/api/interface/promptconfig.md +0 -38
- package/public/content/packages/silk-effects/api/interface/promptsettings.md +0 -32
- package/public/content/packages/silk-effects/api/interface/publishablepackage.md +0 -44
- package/public/content/packages/silk-effects/api/interface/rawpackagejson.md +0 -44
- package/public/content/packages/silk-effects/api/interface/rawpublishconfig.md +0 -44
- package/public/content/packages/silk-effects/api/interface/rawtargetobject.md +0 -44
- package/public/content/packages/silk-effects/api/interface/rulesconfig.md +0 -26
- package/public/content/packages/silk-effects/api/interface/targetbinding.md +0 -52
- package/public/content/packages/silk-effects/api/interface/targetgroupbinding.md +0 -44
- package/public/content/packages/silk-effects/api/interface/targetsbinding.md +0 -32
- package/public/content/packages/silk-effects/api/namespace/changesets.md +0 -16
- package/public/content/packages/silk-effects/api/namespace/commitlint.md +0 -16
- package/public/content/packages/silk-effects/api/namespace/lint.md +0 -16
- package/public/content/packages/silk-effects/api/namespace/turbo.md +0 -16
- package/public/content/packages/silk-effects/api/type/biomesyncoptions.md +0 -16
- package/public/content/packages/silk-effects/api/type/biomesyncresult.md +0 -16
- package/public/content/packages/silk-effects/api/type/changesetconfigfile.md +0 -16
- package/public/content/packages/silk-effects/api/type/changesetmode.md +0 -18
- package/public/content/packages/silk-effects/api/type/checkresult.md +0 -16
- package/public/content/packages/silk-effects/api/type/checkresultdefinition.md +0 -24
- package/public/content/packages/silk-effects/api/type/commentstyle.md +0 -16
- package/public/content/packages/silk-effects/api/type/configdiscoveryoptions.md +0 -16
- package/public/content/packages/silk-effects/api/type/configlocation.md +0 -16
- package/public/content/packages/silk-effects/api/type/configsource.md +0 -16
- package/public/content/packages/silk-effects/api/type/rawpublishtargets.md +0 -18
- package/public/content/packages/silk-effects/api/type/rawtargetvalue.md +0 -18
- package/public/content/packages/silk-effects/api/type/resolutionpolicy.md +0 -16
- package/public/content/packages/silk-effects/api/type/resolutionpolicydefinition.md +0 -23
- package/public/content/packages/silk-effects/api/type/ruleapplicability.md +0 -18
- package/public/content/packages/silk-effects/api/type/ruleconfigtuple.md +0 -18
- package/public/content/packages/silk-effects/api/type/ruleseverity.md +0 -18
- package/public/content/packages/silk-effects/api/type/sectiondiff.md +0 -16
- package/public/content/packages/silk-effects/api/type/sectiondiffdefinition.md +0 -24
- package/public/content/packages/silk-effects/api/type/silkchangesetconfigfile.md +0 -16
- package/public/content/packages/silk-effects/api/type/sourcerequirement.md +0 -16
- package/public/content/packages/silk-effects/api/type/sourcerequirementdefinition.md +0 -23
- package/public/content/packages/silk-effects/api/type/syncresult.md +0 -16
- package/public/content/packages/silk-effects/api/type/syncresultdefinition.md +0 -24
- package/public/content/packages/silk-effects/api/type/tagstrategytype.md +0 -16
- package/public/content/packages/silk-effects/api/type/toolsource.md +0 -16
- package/public/content/packages/silk-effects/api/type/versionextractor.md +0 -16
- package/public/content/packages/silk-effects/api/type/versionextractordefinition.md +0 -28
- package/public/content/packages/silk-effects/api/type/versioningstrategyresult.md +0 -16
- package/public/content/packages/silk-effects/api/type/versioningstrategytype.md +0 -16
- package/public/content/packages/silk-effects/api/variable/biomeschemasynclive.md +0 -18
- package/public/content/packages/silk-effects/api/variable/biomesyncoptions.md +0 -23
- package/public/content/packages/silk-effects/api/variable/biomesyncresult.md +0 -22
- package/public/content/packages/silk-effects/api/variable/changesetconfigfile.md +0 -36
- package/public/content/packages/silk-effects/api/variable/changesetconfiglive.md +0 -18
- package/public/content/packages/silk-effects/api/variable/changesetconfigreaderlive.md +0 -18
- package/public/content/packages/silk-effects/api/variable/checkresult.md +0 -70
- package/public/content/packages/silk-effects/api/variable/commentstyle.md +0 -18
- package/public/content/packages/silk-effects/api/variable/configdiscoverylive.md +0 -18
- package/public/content/packages/silk-effects/api/variable/configdiscoveryoptions.md +0 -21
- package/public/content/packages/silk-effects/api/variable/configlocation.md +0 -21
- package/public/content/packages/silk-effects/api/variable/configsource.md +0 -18
- package/public/content/packages/silk-effects/api/variable/managedsectionlive.md +0 -18
- package/public/content/packages/silk-effects/api/variable/publishabilitydetectoradaptivelive.md +0 -19
- package/public/content/packages/silk-effects/api/variable/resolutionpolicy.md +0 -92
- package/public/content/packages/silk-effects/api/variable/savvybasesection.md +0 -25
- package/public/content/packages/silk-effects/api/variable/savvyhookssection.md +0 -18
- package/public/content/packages/silk-effects/api/variable/sectiondiff.md +0 -70
- package/public/content/packages/silk-effects/api/variable/silkchangesetconfigfile.md +0 -40
- package/public/content/packages/silk-effects/api/variable/silkpublishabilitydetectorlive.md +0 -18
- package/public/content/packages/silk-effects/api/variable/silkworkspaceanalyzerlive.md +0 -20
- package/public/content/packages/silk-effects/api/variable/sourcerequirement.md +0 -92
- package/public/content/packages/silk-effects/api/variable/syncresult.md +0 -81
- package/public/content/packages/silk-effects/api/variable/tagstrategylive.md +0 -18
- package/public/content/packages/silk-effects/api/variable/tagstrategytype.md +0 -18
- package/public/content/packages/silk-effects/api/variable/tooldiscoverylive.md +0 -19
- package/public/content/packages/silk-effects/api/variable/toolsource.md +0 -18
- package/public/content/packages/silk-effects/api/variable/versionextractor.md +0 -99
- package/public/content/packages/silk-effects/api/variable/versioningstrategylive.md +0 -18
- package/public/content/packages/silk-effects/api/variable/versioningstrategyresult.md +0 -22
- package/public/content/packages/silk-effects/api/variable/versioningstrategytype.md +0 -18
- package/public/content/packages/silk-effects/api.md +0 -144
- package/public/content/packages/silk-effects/index.md +0 -76
- package/public/content/packages/silk-effects/managed-section.md +0 -84
- package/public/content/packages/silk-effects/platform-layers.md +0 -94
- package/public/content/packages/templates/api/function/createbiome.md +0 -26
- package/public/content/packages/templates/api/function/createchangeset.md +0 -26
- package/public/content/packages/templates/api/function/creategitignore.md +0 -26
- package/public/content/packages/templates/api/function/createpackagejson.md +0 -26
- package/public/content/packages/templates/api/function/createpnpmworkspace.md +0 -26
- package/public/content/packages/templates/api/function/createreadme.md +0 -26
- package/public/content/packages/templates/api/function/createtsconfig.md +0 -26
- package/public/content/packages/templates/api/function/createturboroot.md +0 -26
- package/public/content/packages/templates/api/function/createturboworkspace.md +0 -26
- package/public/content/packages/templates/api/function/createvscode.md +0 -26
- package/public/content/packages/templates/api/function/createworkspace.md +0 -26
- package/public/content/packages/templates/api/interface/templateentry.md +0 -44
- package/public/content/packages/templates/api/type/biomeoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/changesetoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/gitignoreoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/packagejsonoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/pnpmworkspaceoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/readmeoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/template.md +0 -18
- package/public/content/packages/templates/api/type/tsconfigoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/turborootoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/turboworkspaceoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/updatetemplate.md +0 -18
- package/public/content/packages/templates/api/type/vscodeoptionstype.md +0 -18
- package/public/content/packages/templates/api/type/workspaceoptionstype.md +0 -18
- package/public/content/packages/templates/api/variable/biomeoptions.md +0 -22
- package/public/content/packages/templates/api/variable/changesetoptions.md +0 -29
- package/public/content/packages/templates/api/variable/gitignoreoptions.md +0 -27
- package/public/content/packages/templates/api/variable/packagejsonoptions.md +0 -60
- package/public/content/packages/templates/api/variable/pnpmworkspaceoptions.md +0 -23
- package/public/content/packages/templates/api/variable/readmeoptions.md +0 -21
- package/public/content/packages/templates/api/variable/tsconfigoptions.md +0 -26
- package/public/content/packages/templates/api/variable/turborootoptions.md +0 -25
- package/public/content/packages/templates/api/variable/turboworkspaceoptions.md +0 -20
- package/public/content/packages/templates/api/variable/vscodeoptions.md +0 -25
- package/public/content/packages/templates/api/variable/workspaceoptions.md +0 -33
- package/public/content/packages/templates/api.md +0 -60
- package/public/content/packages/tsdown-plugins/api/class/buildcollector.md +0 -62
- package/public/content/packages/tsdown-plugins/api/class/buildcollectortag.md +0 -16
- package/public/content/packages/tsdown-plugins/api/class/buildreport.md +0 -16
- package/public/content/packages/tsdown-plugins/api/class/configvalidationerror.md +0 -41
- package/public/content/packages/tsdown-plugins/api/class/configvalidator.md +0 -18
- package/public/content/packages/tsdown-plugins/api/class/diagnosticentry.md +0 -18
- package/public/content/packages/tsdown-plugins/api/class/emittedfile.md +0 -18
- package/public/content/packages/tsdown-plugins/api/class/environmentdetector.md +0 -16
- package/public/content/packages/tsdown-plugins/api/class/executorresolver.md +0 -16
- package/public/content/packages/tsdown-plugins/api/class/formatselector.md +0 -16
- package/public/content/packages/tsdown-plugins/api/class/metagenerationerror.md +0 -41
- package/public/content/packages/tsdown-plugins/api/class/outputrenderer.md +0 -16
- package/public/content/packages/tsdown-plugins/api/class/passreport.md +0 -18
- package/public/content/packages/tsdown-plugins/api/class/reporttimings.md +0 -16
- package/public/content/packages/tsdown-plugins/api/class/targetgroupreport.md +0 -16
- package/public/content/packages/tsdown-plugins/api/class/tsconfigresolver.md +0 -84
- package/public/content/packages/tsdown-plugins/api/function/applysubdirmetaentries.md +0 -21
- package/public/content/packages/tsdown-plugins/api/function/buildemittedmanifest.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/buildmetricsplugin.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/buildresolvedtsconfig.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/buildtargetgroups.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/cjsdefaultinterop.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/computeexefilename.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/createtimer.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/createtsdownlogger.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/defaultmanifesttransform.md +0 -20
- package/public/content/packages/tsdown-plugins/api/function/deriveexportpaths.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/derivetargetgroupoptions.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/emitmanifest.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/extractentries.md +0 -16
- package/public/content/packages/tsdown-plugins/api/function/flattenissues.md +0 -21
- package/public/content/packages/tsdown-plugins/api/function/formattime.md +0 -16
- package/public/content/packages/tsdown-plugins/api/function/generatemeta.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/istargetobject.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/nodebuiltindefaultinterop.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/normalizebinpaths.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/normalizeexeoptions.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/normalizeloosefiles.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/normalizemetaoptions.md +0 -21
- package/public/content/packages/tsdown-plugins/api/function/packagejsonentries.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/readtsconfigjsx.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/removedeclarationmaps.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/renderreport.md +0 -17
- package/public/content/packages/tsdown-plugins/api/function/resolvejsxconfig.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/resolvemanifest.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/resolvenextversions.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/resolveportabletsconfig.md +0 -27
- package/public/content/packages/tsdown-plugins/api/function/resolvetargets.md +0 -21
- package/public/content/packages/tsdown-plugins/api/function/rewritemetaversions.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/runexebuild.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/runmetapass.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/serializeissues.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/syncpublicdir.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/transformbin.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/transformexports.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/transformmanifest.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/writeissuesartifact.md +0 -23
- package/public/content/packages/tsdown-plugins/api/function/writeresolvedtsconfig.md +0 -18
- package/public/content/packages/tsdown-plugins/api/function/writetargetsbinding.md +0 -18
- package/public/content/packages/tsdown-plugins/api/interface/buildemittedmanifestoptions.md +0 -69
- package/public/content/packages/tsdown-plugins/api/interface/buildgroupspec.md +0 -32
- package/public/content/packages/tsdown-plugins/api/interface/buildissues.md +0 -56
- package/public/content/packages/tsdown-plugins/api/interface/buildtargetgroupsoptions.md +0 -213
- package/public/content/packages/tsdown-plugins/api/interface/cssoptions.md +0 -36
- package/public/content/packages/tsdown-plugins/api/interface/derivedtsdownoptions.md +0 -114
- package/public/content/packages/tsdown-plugins/api/interface/deriveoptions.md +0 -108
- package/public/content/packages/tsdown-plugins/api/interface/diagnosticinput.md +0 -66
- package/public/content/packages/tsdown-plugins/api/interface/emitmanifestoptions.md +0 -71
- package/public/content/packages/tsdown-plugins/api/interface/entryoverride.md +0 -86
- package/public/content/packages/tsdown-plugins/api/interface/execonfig.md +0 -60
- package/public/content/packages/tsdown-plugins/api/interface/exerewrite.md +0 -44
- package/public/content/packages/tsdown-plugins/api/interface/exeseaconfig.md +0 -38
- package/public/content/packages/tsdown-plugins/api/interface/exetarget.md +0 -38
- package/public/content/packages/tsdown-plugins/api/interface/exetargetinput.md +0 -32
- package/public/content/packages/tsdown-plugins/api/interface/extractoptions.md +0 -32
- package/public/content/packages/tsdown-plugins/api/interface/extractresult.md +0 -34
- package/public/content/packages/tsdown-plugins/api/interface/formatter.md +0 -30
- package/public/content/packages/tsdown-plugins/api/interface/formattercontext.md +0 -30
- package/public/content/packages/tsdown-plugins/api/interface/generatemetaoptions.md +0 -124
- package/public/content/packages/tsdown-plugins/api/interface/jsxconfig.md +0 -36
- package/public/content/packages/tsdown-plugins/api/interface/loosefilespec.md +0 -36
- package/public/content/packages/tsdown-plugins/api/interface/metaoptions.md +0 -42
- package/public/content/packages/tsdown-plugins/api/interface/metaresult.md +0 -30
- package/public/content/packages/tsdown-plugins/api/interface/nextversions.md +0 -36
- package/public/content/packages/tsdown-plugins/api/interface/normalizedexe.md +0 -48
- package/public/content/packages/tsdown-plugins/api/interface/normalizedloosefile.md +0 -60
- package/public/content/packages/tsdown-plugins/api/interface/normalizedmeta.md +0 -41
- package/public/content/packages/tsdown-plugins/api/interface/packagejsonentriesoptions.md +0 -34
- package/public/content/packages/tsdown-plugins/api/interface/packagejsonlike.md +0 -30
- package/public/content/packages/tsdown-plugins/api/interface/pkgoscpu.md +0 -32
- package/public/content/packages/tsdown-plugins/api/interface/plaindiagnostic.md +0 -68
- package/public/content/packages/tsdown-plugins/api/interface/portabletsconfig.md +0 -36
- package/public/content/packages/tsdown-plugins/api/interface/publishtargetobject.md +0 -44
- package/public/content/packages/tsdown-plugins/api/interface/renderedoutput.md +0 -36
- package/public/content/packages/tsdown-plugins/api/interface/renderreportoptions.md +0 -44
- package/public/content/packages/tsdown-plugins/api/interface/resolvedcompileroptions.md +0 -26
- package/public/content/packages/tsdown-plugins/api/interface/resolvedgroup.md +0 -44
- package/public/content/packages/tsdown-plugins/api/interface/resolvedtarget.md +0 -52
- package/public/content/packages/tsdown-plugins/api/interface/resolvedtsconfig.md +0 -36
- package/public/content/packages/tsdown-plugins/api/interface/resolvedtsconfigoptions.md +0 -50
- package/public/content/packages/tsdown-plugins/api/interface/runexebuildoptions.md +0 -74
- package/public/content/packages/tsdown-plugins/api/interface/runmetapassoptions.md +0 -104
- package/public/content/packages/tsdown-plugins/api/interface/targetgroupref.md +0 -38
- package/public/content/packages/tsdown-plugins/api/interface/targetresolution.md +0 -32
- package/public/content/packages/tsdown-plugins/api/interface/timer.md +0 -30
- package/public/content/packages/tsdown-plugins/api/interface/transformmanifestoptions.md +0 -50
- package/public/content/packages/tsdown-plugins/api/interface/tsconfigjsx.md +0 -32
- package/public/content/packages/tsdown-plugins/api/interface/tsdocoptions.md +0 -32
- package/public/content/packages/tsdown-plugins/api/interface/tsdoctagdefinition.md +0 -38
- package/public/content/packages/tsdown-plugins/api/interface/tsdownlogger.md +0 -62
- package/public/content/packages/tsdown-plugins/api/interface/validationinput.md +0 -69
- package/public/content/packages/tsdown-plugins/api/interface/warningsuppressionrule.md +0 -32
- package/public/content/packages/tsdown-plugins/api/type/buildformat.md +0 -18
- package/public/content/packages/tsdown-plugins/api/type/buildplatform.md +0 -18
- package/public/content/packages/tsdown-plugins/api/type/dualexports.md +0 -18
- package/public/content/packages/tsdown-plugins/api/type/environment.md +0 -16
- package/public/content/packages/tsdown-plugins/api/type/exebuild.md +0 -18
- package/public/content/packages/tsdown-plugins/api/type/executor.md +0 -16
- package/public/content/packages/tsdown-plugins/api/type/json.md +0 -16
- package/public/content/packages/tsdown-plugins/api/type/loosefiles.md +0 -18
- package/public/content/packages/tsdown-plugins/api/type/outputformat.md +0 -16
- package/public/content/packages/tsdown-plugins/api/type/passkind.md +0 -16
- package/public/content/packages/tsdown-plugins/api/type/publishtargets.md +0 -18
- package/public/content/packages/tsdown-plugins/api/type/publishtargetvalue.md +0 -18
- package/public/content/packages/tsdown-plugins/api/type/targetgroupid.md +0 -18
- package/public/content/packages/tsdown-plugins/api/type/tsdownbuild.md +0 -18
- package/public/content/packages/tsdown-plugins/api/variable/ciannotationsformatter.md +0 -16
- package/public/content/packages/tsdown-plugins/api/variable/configvalidatorlive.md +0 -18
- package/public/content/packages/tsdown-plugins/api/variable/default_exe_node_version.md +0 -18
- package/public/content/packages/tsdown-plugins/api/variable/environmentdetectorlive.md +0 -16
- package/public/content/packages/tsdown-plugins/api/variable/executorresolverlive.md +0 -16
- package/public/content/packages/tsdown-plugins/api/variable/formatselectorlive.md +0 -16
- package/public/content/packages/tsdown-plugins/api/variable/jsonformatter.md +0 -16
- package/public/content/packages/tsdown-plugins/api/variable/markdownformatter.md +0 -16
- package/public/content/packages/tsdown-plugins/api/variable/outputrendererlive.md +0 -16
- package/public/content/packages/tsdown-plugins/api/variable/reportpipelinelive.md +0 -17
- package/public/content/packages/tsdown-plugins/api/variable/silentformatter.md +0 -16
- package/public/content/packages/tsdown-plugins/api/variable/terminalformatter.md +0 -16
- package/public/content/packages/tsdown-plugins/api.md +0 -165
- package/public/content/standards/api-model-pipeline.md +0 -64
- package/public/content/standards/catalog-usage.md +0 -48
- package/public/content/standards/changeset-discipline.md +0 -52
- package/public/content/standards/changeset-format.md +0 -132
- package/public/content/standards/commit-contract.md +0 -58
- package/public/content/standards/dependency-conventions.md +0 -82
- package/public/content/standards/linting-conventions.md +0 -47
- package/public/content/standards/publishability.md +0 -57
- package/public/content/standards/semver.md +0 -51
- package/public/content/standards/test-classification.md +0 -49
- package/public/content/standards/turbo/best-practices.md +0 -76
- package/public/content/standards/turbo/boundaries.md +0 -72
- package/public/content/standards/turbo/ci.md +0 -69
- package/public/content/standards/turbo/environment.md +0 -64
- package/public/content/standards/turbo/filtering.md +0 -72
- package/public/content/standards/turbo/watch.md +0 -64
- package/public/content/tags.json +0 -32
- package/resources/catalog.js +0 -29
- package/resources/doc-index.js +0 -112
- package/resources/index.js +0 -57
- package/resources/load.js +0 -38
- package/resources/paths.js +0 -23
- package/resources/query-log.js +0 -20
- package/resources/schema.js +0 -40
- package/tools/docs-search.js +0 -59
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/linting-conventions
|
|
3
|
-
title: Linting and formatting
|
|
4
|
-
summary: Load when writing TypeScript or markdown that must pass Biome and markdownlint.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [lint]
|
|
8
|
-
priority: 0.8
|
|
9
|
-
related: [standards/test-classification]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
TypeScript is formatted and linted with Biome; markdown with markdownlint-cli2.
|
|
15
|
-
Both run in pre-commit through `@savvy-web/lint-staged` composable handlers, so
|
|
16
|
-
code that violates these rules does not commit.
|
|
17
|
-
|
|
18
|
-
## Why
|
|
19
|
-
|
|
20
|
-
A single shared config means contributors and agents follow the project's style
|
|
21
|
-
without being told it each session, and CI enforces the same rules locally and
|
|
22
|
-
remotely. The lint-staged plugin injects the active rules into Claude Code at
|
|
23
|
-
session start for exactly this reason.
|
|
24
|
-
|
|
25
|
-
## Examples
|
|
26
|
-
|
|
27
|
-
Biome enforcements that bite most often:
|
|
28
|
-
|
|
29
|
-
- `useImportExtensions` — relative imports MUST use `.js` extensions (ESM).
|
|
30
|
-
- `useImportType` — type-only imports use `import type { Foo }`, not `import { type Foo }`.
|
|
31
|
-
- `useNodejsImportProtocol` — Node built-ins use the `node:` protocol (`node:fs`).
|
|
32
|
-
- `useConsistentTypeDefinitions` — prefer interfaces.
|
|
33
|
-
- `noUnusedVariables` and `noImportCycles` are errors. Imports auto-sort.
|
|
34
|
-
- Test files relax `noUndeclaredDependencies`.
|
|
35
|
-
|
|
36
|
-
markdownlint rules that bite most often:
|
|
37
|
-
|
|
38
|
-
- No line-length limit (MD013 disabled).
|
|
39
|
-
- Duplicate headings allowed only among siblings (MD024).
|
|
40
|
-
- HTML restricted to `br`, `details`, `summary`, `img`, `sup`, `sub`.
|
|
41
|
-
- Code fences MUST carry a language identifier (MD040).
|
|
42
|
-
- Tables use compact style — single space around cell content (MD060).
|
|
43
|
-
- Files end with a single trailing newline (MD047).
|
|
44
|
-
|
|
45
|
-
## See also
|
|
46
|
-
|
|
47
|
-
Test file naming and discovery is at `silk://standards/test-classification`.
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/publishability
|
|
3
|
-
title: Publishability rules
|
|
4
|
-
summary: Load when deciding whether a package publishes and how private vs publishConfig interact.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [publishability]
|
|
8
|
-
priority: 0.8
|
|
9
|
-
related: [packages/silk-effects/, standards/catalog-usage]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
A package's publishability is resolved from its `package.json` by applying these
|
|
15
|
-
rules in order; the first match wins:
|
|
16
|
-
|
|
17
|
-
1. `publishConfig.targets` is a non-empty array → one target per surviving entry.
|
|
18
|
-
2. `publishConfig.access` is `public` or `restricted` → a single target.
|
|
19
|
-
3. `private !== true` → a single default target.
|
|
20
|
-
4. otherwise → not publishable (empty).
|
|
21
|
-
|
|
22
|
-
`publishConfig.targets` takes precedence over the `private` flag: a package with
|
|
23
|
-
`private: true` and a `publishConfig.targets` array still publishes. The `private`
|
|
24
|
-
flag is consulted only as the last-resort default in rule 3.
|
|
25
|
-
|
|
26
|
-
## Why
|
|
27
|
-
|
|
28
|
-
In the Silk ecosystem `private: true` is the norm on source `package.json` files,
|
|
29
|
-
and `publishConfig` declares publish intent. The builder flips `private` based on
|
|
30
|
-
`publishConfig.access` at build time, so a source package with `private: true` and
|
|
31
|
-
`publishConfig.access: "public"` is publishable. Encoding intent in `publishConfig`
|
|
32
|
-
rather than the bare `private` flag lets a workspace keep packages private during
|
|
33
|
-
development and publish them deliberately.
|
|
34
|
-
|
|
35
|
-
`SilkPublishability.detect` is the pure entry point. Shorthand string targets
|
|
36
|
-
expand to registries: `"npm"` → npmjs, `"github"` → GitHub Packages, `"jsr"` →
|
|
37
|
-
jsr; an `http(s)://…` value is verbatim. String targets inherit the parent
|
|
38
|
-
`publishConfig.access`; object targets use their own access else the parent's.
|
|
39
|
-
|
|
40
|
-
## Examples
|
|
41
|
-
|
|
42
|
-
```text
|
|
43
|
-
{ private: true, publishConfig: { access: "public", targets: ["npm", "github"] } }
|
|
44
|
-
→ publishes to both npm and GitHub Packages
|
|
45
|
-
|
|
46
|
-
{ private: true }
|
|
47
|
-
→ not publishable (empty)
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
The adaptive detector additionally short-circuits changeset-ignored packages to
|
|
51
|
-
empty and dispatches on changeset mode (`none` → empty, `silk` → Silk rules,
|
|
52
|
-
`vanilla` → upstream default).
|
|
53
|
-
|
|
54
|
-
## See also
|
|
55
|
-
|
|
56
|
-
The detector services and layers are documented at `silk://packages/silk-effects/`.
|
|
57
|
-
Dependency pinning is at `silk://standards/catalog-usage`.
|
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/semver
|
|
3
|
-
title: Strict SemVer (no v-prefix)
|
|
4
|
-
summary: Strict SemVer 2.0.0 everywhere; git tags carry no leading v.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [semver]
|
|
8
|
-
priority: 0.5
|
|
9
|
-
related: [standards/changeset-discipline]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
Silk uses strict SemVer 2.0.0 for all version numbers. Git tags carry **no
|
|
15
|
-
leading `v` prefix**. This applies everywhere — package versions, git tags, and
|
|
16
|
-
version ranges authored by hand.
|
|
17
|
-
|
|
18
|
-
| Context | Correct | Incorrect |
|
|
19
|
-
| :--- | :--- | :--- |
|
|
20
|
-
| `package.json` `"version"` | `"1.2.3"` | `"v1.2.3"` |
|
|
21
|
-
| git tag for a release | `foo@1.2.3` or `1.2.3` | `vfoo@1.2.3` or `v1.2.3` |
|
|
22
|
-
| changeset bump result | `1.2.3` | `v1.2.3` |
|
|
23
|
-
|
|
24
|
-
## Why
|
|
25
|
-
|
|
26
|
-
The `v` prefix is noise that breaks strict SemVer parsers. Many tools (including
|
|
27
|
-
the Node.js SemVer library in strict mode) treat `v1.2.3` as an invalid version.
|
|
28
|
-
Consistent, tool-parseable versions across every surface — npm registry, git tags,
|
|
29
|
-
changelog entries, and API references — removes an entire class of subtle breakage
|
|
30
|
-
where one tool normalizes the prefix and another does not.
|
|
31
|
-
|
|
32
|
-
## Examples
|
|
33
|
-
|
|
34
|
-
A release of `@savvy-web/foo` at version `1.2.3` is tagged `foo@1.2.3` (or
|
|
35
|
-
`1.2.3` for single-package repos). The `package.json` carries `"version": "1.2.3"`.
|
|
36
|
-
The CHANGELOG entry title reads `1.2.3`. No `v` anywhere.
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
# correct
|
|
40
|
-
git tag foo@1.2.3
|
|
41
|
-
|
|
42
|
-
# incorrect — never do this
|
|
43
|
-
git tag vfoo@1.2.3
|
|
44
|
-
git tag v1.2.3
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
## See also
|
|
48
|
-
|
|
49
|
-
Changesets and bump mechanics are at `silk://standards/changeset-discipline`.
|
|
50
|
-
Publishability rules (which determine when a tag triggers a release) are at
|
|
51
|
-
`silk://standards/publishability`.
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/test-classification
|
|
3
|
-
title: Test classification
|
|
4
|
-
summary: Load when naming a test file or wondering why Vitest classifies it as unit, e2e, or int.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [test]
|
|
8
|
-
priority: 0.8
|
|
9
|
-
related: [standards/linting-conventions]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
`VitestConfig.create()` discovers workspace packages and classifies each test file
|
|
15
|
-
by its **filename**, not its directory. The first matching pattern wins:
|
|
16
|
-
|
|
17
|
-
- `*.e2e.(test|spec).(ts|tsx|js|jsx)` → e2e
|
|
18
|
-
- `*.int.(test|spec).(ts|tsx|js|jsx)` → integration
|
|
19
|
-
- `*.(test|spec).(ts|tsx|js|jsx)` → unit (catch-all; `*.unit.test.ts` lands here)
|
|
20
|
-
|
|
21
|
-
Files matching none are ignored. Tests live in `src/` and an optional `__test__/`
|
|
22
|
-
directory beside it; only packages with a `src/` directory are scanned.
|
|
23
|
-
|
|
24
|
-
## Why
|
|
25
|
-
|
|
26
|
-
Filename-driven classification keeps the directory layout free and the kind
|
|
27
|
-
unambiguous — `foo.e2e.test.ts` is never double-counted as a unit test because the
|
|
28
|
-
e2e pattern is checked first. A package with one test kind gets a bare project name
|
|
29
|
-
(`@scope/pkg`); two or more kinds get suffixed names (`@scope/pkg:unit`,
|
|
30
|
-
`@scope/pkg:e2e`). A package with `src/` but no tests still gets a unit project as
|
|
31
|
-
a forward-looking placeholder.
|
|
32
|
-
|
|
33
|
-
## Examples
|
|
34
|
-
|
|
35
|
-
`parser.test.ts` and `parser.unit.test.ts` → unit. `auth.e2e.test.ts` → e2e.
|
|
36
|
-
`db.int.test.ts` → integration.
|
|
37
|
-
|
|
38
|
-
Helper and fixture directories are excluded from discovery at conventional
|
|
39
|
-
locations only: `__test__/fixtures/`, `__test__/utils/`, and the same under
|
|
40
|
-
`__test__/{unit,e2e,integration}/`. A `vitest.setup.{ts,tsx,js,jsx}` at the
|
|
41
|
-
package root is auto-detected and added to `setupFiles`.
|
|
42
|
-
|
|
43
|
-
Coverage defaults to the `"strict"` level (lines 80, branches 75, functions 80,
|
|
44
|
-
statements 80). Passing `--project` flags scopes coverage to the union of the
|
|
45
|
-
matched packages.
|
|
46
|
-
|
|
47
|
-
## See also
|
|
48
|
-
|
|
49
|
-
Lint and format rules are at `silk://standards/linting-conventions`.
|
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/turbo/best-practices
|
|
3
|
-
title: Turborepo task-graph best practices
|
|
4
|
-
summary: dependsOn topology, transit tasks, declaring outputs, and the prebuild/parallel anti-patterns.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [turbo, build, workspace]
|
|
8
|
-
priority: 0.7
|
|
9
|
-
related: [standards/turbo/environment, standards/turbo/filtering, standards/dependency-conventions]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## ^build vs build in dependsOn
|
|
13
|
-
|
|
14
|
-
The caret matters and is the single most misread part of `dependsOn`:
|
|
15
|
-
|
|
16
|
-
- `"^build"` — run **build in this package's dependencies first** (topological).
|
|
17
|
-
This is what a normal build wants: `dist/dev` of upstream packages must exist
|
|
18
|
-
before this one compiles.
|
|
19
|
-
- `"build"` — run **another task in the same package first** (e.g. a `test` that
|
|
20
|
-
`dependsOn: ["build"]`). No caret means same-package only.
|
|
21
|
-
|
|
22
|
-
```jsonc
|
|
23
|
-
{
|
|
24
|
-
"tasks": {
|
|
25
|
-
"build:prod": { "dependsOn": ["^build:prod"], "outputs": ["dist/prod/**"] },
|
|
26
|
-
"test": { "dependsOn": ["build"] }
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
Mixing these up gives you either packages compiling against unbuilt dependencies
|
|
32
|
-
(forgot the caret) or a needless full-topology rebuild (added one you didn't
|
|
33
|
-
need).
|
|
34
|
-
|
|
35
|
-
## Transit tasks for parallel-but-correct invalidation
|
|
36
|
-
|
|
37
|
-
A "transit" task is a near-empty task that exists only to carry dependency edges:
|
|
38
|
-
it declares `dependsOn: ["^transit"]` and no real work. Downstream tasks depend on
|
|
39
|
-
it so they invalidate when any upstream source changes, while the actual heavy
|
|
40
|
-
tasks still run in parallel rather than serializing behind each other. Use this
|
|
41
|
-
when you want correct cache invalidation across the graph without forcing a
|
|
42
|
-
strict topological chain through every real task.
|
|
43
|
-
|
|
44
|
-
## Always declare outputs
|
|
45
|
-
|
|
46
|
-
If a task writes files but its `outputs` glob is missing or wrong, turbo caches
|
|
47
|
-
**nothing** to restore — the next "cache hit" replays the log but leaves the
|
|
48
|
-
working tree without the artifacts, and the following task fails on a missing
|
|
49
|
-
`dist/`. Every build task here declares its real output dir (`dist/dev/**`,
|
|
50
|
-
`dist/prod/**`, `meta/**`). The `build:catalog`/`build:meta` tasks are the
|
|
51
|
-
exceptions that are deliberately uncached.
|
|
52
|
-
|
|
53
|
-
## Don't over-broaden globalDependencies
|
|
54
|
-
|
|
55
|
-
Listing a frequently-touched file (a top-level `README`, a changelog) in
|
|
56
|
-
`globalDependencies` busts every package's cache on every unrelated edit. Scope
|
|
57
|
-
shared inputs to the configs that genuinely affect output.
|
|
58
|
-
|
|
59
|
-
## Avoid --parallel for ordered work
|
|
60
|
-
|
|
61
|
-
`--parallel` ignores `dependsOn` entirely and runs everything at once. It is only
|
|
62
|
-
correct for independent tasks (linting every package). Using it for builds races
|
|
63
|
-
dependencies and produces flaky, order-dependent failures — let the dependency
|
|
64
|
-
graph schedule instead.
|
|
65
|
-
|
|
66
|
-
## prebuild lifecycle scripts defeat caching
|
|
67
|
-
|
|
68
|
-
npm `prebuild`/`postbuild` lifecycle scripts run **outside** turbo's hash and
|
|
69
|
-
ordering, so their effects are neither cached nor invalidated correctly. Silk
|
|
70
|
-
forbids build-in-install hooks for exactly this reason; keep every build step as
|
|
71
|
-
a named turbo task, not a lifecycle shim.
|
|
72
|
-
|
|
73
|
-
## See also
|
|
74
|
-
|
|
75
|
-
Env-hash correctness is at `silk://standards/turbo/environment`. Dependency
|
|
76
|
-
declaration rules are at `silk://standards/dependency-conventions`.
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/turbo/boundaries
|
|
3
|
-
title: Turborepo boundaries
|
|
4
|
-
summary: Tags and allow/deny rules for enforcing package dependency layering.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [turbo, workspace, dependencies]
|
|
8
|
-
priority: 0.5
|
|
9
|
-
related: [standards/dependency-conventions, standards/turbo/best-practices]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
`turbo boundaries` enforces **who may depend on whom** by tagging packages and
|
|
15
|
-
declaring allow/deny rules between tags. It turns an architectural invariant —
|
|
16
|
-
"the CLI must not import silk," "mcp depends on neither cli nor silk" — into a
|
|
17
|
-
checked rule rather than a convention people remember.
|
|
18
|
-
|
|
19
|
-
## Tagging packages
|
|
20
|
-
|
|
21
|
-
Tag each package in its `turbo.json` (or the package's `turbo` config):
|
|
22
|
-
|
|
23
|
-
```jsonc
|
|
24
|
-
// packages/cli/turbo.json
|
|
25
|
-
{ "tags": ["app"] }
|
|
26
|
-
|
|
27
|
-
// packages/silk-effects/turbo.json
|
|
28
|
-
{ "tags": ["lib"] }
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
## Allow / deny rules
|
|
32
|
-
|
|
33
|
-
Declare the permitted dependency directions at the root:
|
|
34
|
-
|
|
35
|
-
```jsonc
|
|
36
|
-
{
|
|
37
|
-
"boundaries": {
|
|
38
|
-
"tags": {
|
|
39
|
-
"app": { "dependencies": { "allow": ["lib"] } },
|
|
40
|
-
"lib": { "dependencies": { "deny": ["app"] } }
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
Run the check with:
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
turbo boundaries
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
It fails when an import crosses a denied edge — catching, for example, a stray
|
|
53
|
-
`@savvy-web/silk` import inside `@savvy-web/cli` that would violate the cli↔silk
|
|
54
|
-
non-import invariant, or an attempt to import cli/silk from mcp.
|
|
55
|
-
|
|
56
|
-
## Why encode it
|
|
57
|
-
|
|
58
|
-
The cli↔silk↔mcp non-import invariant is load-bearing: the three packages depend
|
|
59
|
-
only on silk-effects within the repo. A reviewer can miss a new import; a
|
|
60
|
-
boundaries rule cannot. Encoding the layering also documents intent — the tag
|
|
61
|
-
graph is the dependency policy, version-controlled next to the code.
|
|
62
|
-
|
|
63
|
-
## Anti-patterns
|
|
64
|
-
|
|
65
|
-
Do not tag packages so loosely that every package can depend on every other —
|
|
66
|
-
that yields green checks with zero protection. Tag by architectural layer
|
|
67
|
-
(`app`, `lib`, `tooling`) so the deny rules actually constrain the graph.
|
|
68
|
-
|
|
69
|
-
## See also
|
|
70
|
-
|
|
71
|
-
The underlying import rules are at `silk://standards/dependency-conventions`.
|
|
72
|
-
Graph-correctness practices are at `silk://standards/turbo/best-practices`.
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/turbo/ci
|
|
3
|
-
title: Turborepo in CI
|
|
4
|
-
summary: Remote caching, --affected, turbo prune, and turbo-ignore in the Silk install→build→checks pipeline.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [turbo, ci, github-actions, build]
|
|
8
|
-
priority: 0.6
|
|
9
|
-
related: [standards/turbo/filtering, standards/turbo/environment, standards/turbo/best-practices]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
CI runs tasks through `turbo`, never by hand-iterating packages. The Silk job
|
|
15
|
-
order is fixed: **install → build → checks**. Install (`pnpm install
|
|
16
|
-
--frozen-lockfile`) never builds — there are no `prepare` build scripts — so an
|
|
17
|
-
explicit `pnpm build` (turbo `build:dev` + `build:prod`) must run before any
|
|
18
|
-
check that imports a `@savvy-web/*` package, because consumers resolve the built
|
|
19
|
-
`dist/dev` via `linkDirectory`.
|
|
20
|
-
|
|
21
|
-
## Remote caching
|
|
22
|
-
|
|
23
|
-
Set `TURBO_TOKEN` and `TURBO_TEAM` in the job environment. With those present,
|
|
24
|
-
`turbo` reads and writes the remote cache automatically. In CI use
|
|
25
|
-
`--remote-only` so the run never trusts a stale local `.turbo` directory that a
|
|
26
|
-
runner image might carry:
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
turbo run build --remote-only
|
|
30
|
-
turbo run lint test typecheck --remote-only
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
A populated remote cache turns a no-change `build:prod` into a restore, which is
|
|
34
|
-
what makes the `build:prod → generate:api-docs → build:catalog → build` chain
|
|
35
|
-
cheap on unaffected PRs.
|
|
36
|
-
|
|
37
|
-
## Only build what changed
|
|
38
|
-
|
|
39
|
-
Use `--affected` to scope a run to packages touched since the merge base. Turbo
|
|
40
|
-
auto-detects the base/head refs in GitHub Actions; locally pass them explicitly:
|
|
41
|
-
|
|
42
|
-
```bash
|
|
43
|
-
turbo run test --affected
|
|
44
|
-
turbo run test --affected --filter=...[origin/main...HEAD] # explicit refs
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
Pair this with a full-history checkout (`fetch-depth: 0` or a known base ref) so
|
|
48
|
-
the diff is accurate. A shallow clone makes `--affected` over-select.
|
|
49
|
-
|
|
50
|
-
## Docker and skipping runs
|
|
51
|
-
|
|
52
|
-
For container builds, `turbo prune <pkg> --docker` emits a pruned subset
|
|
53
|
-
(`out/json` lockfile layer + `out/full` source layer) so the image only installs
|
|
54
|
-
and builds that package's slice — keep the two layers separate to preserve Docker
|
|
55
|
-
layer caching. To skip an entire workflow when nothing relevant changed, gate the
|
|
56
|
-
job on `turbo-ignore`, which exits non-zero only when the target package (and its
|
|
57
|
-
dependencies) changed.
|
|
58
|
-
|
|
59
|
-
## Anti-patterns
|
|
60
|
-
|
|
61
|
-
Do not build inside an install hook to "warm" CI — mcp's `build:dev` pulls the
|
|
62
|
-
libraries' `build:prod`, which resolves `catalog:silkPeers` from the workspace
|
|
63
|
-
state file pnpm writes only after install scripts, so an install-time build fails
|
|
64
|
-
with `Catalog(s) not found: silkPeers`. Keep build a post-install turbo step.
|
|
65
|
-
|
|
66
|
-
## See also
|
|
67
|
-
|
|
68
|
-
Scoping syntax is at `silk://standards/turbo/filtering`. Cache-correct env
|
|
69
|
-
declarations are at `silk://standards/turbo/environment`.
|
|
@@ -1,64 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/turbo/environment
|
|
3
|
-
title: Turborepo environment hashing
|
|
4
|
-
summary: env/globalEnv, passThroughEnv, globalDependencies, and why missing declarations corrupt the cache.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [turbo, ci, build]
|
|
8
|
-
priority: 0.7
|
|
9
|
-
related: [standards/turbo/best-practices, standards/turbo/ci]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
Any environment variable that changes a task's **output** must be declared in
|
|
15
|
-
that task's `env`, or the cache will hand back output built under a different
|
|
16
|
-
value. Turbo only hashes env vars you declare; an undeclared var is invisible to
|
|
17
|
-
the cache and is the most common source of "it worked on my machine, the cache
|
|
18
|
-
gave me stale bytes" bugs.
|
|
19
|
-
|
|
20
|
-
## env vs globalEnv
|
|
21
|
-
|
|
22
|
-
- `env` (per task): vars that affect that task's output — e.g. `NODE_ENV` for a
|
|
23
|
-
build, registry tokens for a publish step.
|
|
24
|
-
- `globalEnv` (root `pipeline`/`globalEnv`): vars that affect **every** task's
|
|
25
|
-
hash. Use sparingly; an over-broad `globalEnv` busts every cache entry whenever
|
|
26
|
-
it changes.
|
|
27
|
-
|
|
28
|
-
```jsonc
|
|
29
|
-
{
|
|
30
|
-
"globalEnv": ["NODE_ENV"],
|
|
31
|
-
"tasks": {
|
|
32
|
-
"build:prod": { "env": ["TURBO_TOKEN", "TURBO_TEAM"], "outputs": ["dist/prod/**"] }
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## passThroughEnv
|
|
38
|
-
|
|
39
|
-
`passThroughEnv` / `globalPassThroughEnv` make a var **available to the task
|
|
40
|
-
process without adding it to the hash**. Use it for things that must reach the
|
|
41
|
-
process but must not invalidate the cache — e.g. `GITHUB_TOKEN` during a
|
|
42
|
-
network-only step. Pass-through is the deliberate escape hatch; reaching for it
|
|
43
|
-
to hide a genuine input is how you reintroduce the stale-cache bug.
|
|
44
|
-
|
|
45
|
-
## globalDependencies
|
|
46
|
-
|
|
47
|
-
`globalDependencies` lists files outside any package whose contents should feed
|
|
48
|
-
every task hash — `tsconfig.base.json`, the root `biome.jsonc`, `.nvmrc`. When a
|
|
49
|
-
shared config changes, every cache entry should miss; that only happens if the
|
|
50
|
-
file is declared here.
|
|
51
|
-
|
|
52
|
-
## The root .env anti-pattern
|
|
53
|
-
|
|
54
|
-
Turbo does not read a root `.env` into task hashes. A var set only in `.env`
|
|
55
|
-
silently changes output while the hash stays constant, so the cache returns bytes
|
|
56
|
-
built under the old value. If a value must affect a build, declare it in `env`
|
|
57
|
-
and let CI inject it — do not rely on a loose `.env`. Silk's install and build
|
|
58
|
-
are decoupled, so there is no install hook quietly sourcing env either; CI sets
|
|
59
|
-
exactly what each task declares.
|
|
60
|
-
|
|
61
|
-
## See also
|
|
62
|
-
|
|
63
|
-
The anti-pattern catalog is at `silk://standards/turbo/best-practices`.
|
|
64
|
-
Remote-cache env wiring is at `silk://standards/turbo/ci`.
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/turbo/filtering
|
|
3
|
-
title: Turborepo task filtering
|
|
4
|
-
summary: --filter syntax, dependency/dependent expansion, changed-since filters, and --affected.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [turbo, workspace, build]
|
|
8
|
-
priority: 0.6
|
|
9
|
-
related: [standards/turbo/ci, standards/turbo/best-practices]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
`--filter` selects which packages a task runs in. Stack filters (each `--filter`
|
|
15
|
-
is a union) and lean on the dependency-expansion operators so you never have to
|
|
16
|
-
list packages by hand.
|
|
17
|
-
|
|
18
|
-
## Package selectors
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
turbo run build --filter=@savvy-web/mcp # one package
|
|
22
|
-
turbo run build --filter='./packages/*' # by directory glob
|
|
23
|
-
turbo run build --filter='@savvy-web/*' # by name glob
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Dependency / dependent expansion
|
|
27
|
-
|
|
28
|
-
The `...` operator pulls in the rest of the graph relative to a package:
|
|
29
|
-
|
|
30
|
-
| Selector | Meaning |
|
|
31
|
-
| :--- | :--- |
|
|
32
|
-
| `@savvy-web/mcp...` | mcp **and everything it depends on** |
|
|
33
|
-
| `...@savvy-web/mcp` | mcp **and everything that depends on it** |
|
|
34
|
-
| `...@savvy-web/silk-effects...` | the package plus dependents and dependencies |
|
|
35
|
-
| `@savvy-web/mcp^...` | mcp's dependencies only (exclude mcp itself) |
|
|
36
|
-
|
|
37
|
-
`...@savvy-web/silk-effects` is the practical way to rebuild the four libraries'
|
|
38
|
-
downstream consumers (cli, silk, mcp) after a shared-library edit, without
|
|
39
|
-
naming each one.
|
|
40
|
-
|
|
41
|
-
## Changed-since filters
|
|
42
|
-
|
|
43
|
-
`[<git-ref>]` restricts to packages changed since a ref, and composes with `...`:
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
turbo run test --filter='[origin/main]' # changed vs main
|
|
47
|
-
turbo run test --filter='...[origin/main...HEAD]' # changed + their dependents
|
|
48
|
-
turbo run build --filter='@savvy-web/mcp[HEAD^1]' # mcp, only if it changed
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
## --affected
|
|
52
|
-
|
|
53
|
-
`--affected` is the ergonomic shorthand for "changed vs the merge base, plus
|
|
54
|
-
dependents," with the base/head auto-detected in CI:
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
turbo run lint test typecheck --affected
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
Prefer `--affected` in CI and reserve explicit `[<ref>]` filters for cases where
|
|
61
|
-
you need a non-default base. Both need real git history — a shallow checkout
|
|
62
|
-
over-selects.
|
|
63
|
-
|
|
64
|
-
## Anti-patterns
|
|
65
|
-
|
|
66
|
-
Do not chain `cd packages/foo && pnpm build` to scope a build; you lose turbo's
|
|
67
|
-
cache and topological ordering. Use `--filter` so dependencies still build first
|
|
68
|
-
and cache hits still count.
|
|
69
|
-
|
|
70
|
-
## See also
|
|
71
|
-
|
|
72
|
-
Using filters in CI is at `silk://standards/turbo/ci`.
|
|
@@ -1,64 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: standards/turbo/watch
|
|
3
|
-
title: Turborepo watch and persistent tasks
|
|
4
|
-
summary: turbo watch, persistent/dev tasks, interactive tasks, and watch-mode caveats.
|
|
5
|
-
tier: standards
|
|
6
|
-
source: hand
|
|
7
|
-
tags: [turbo, build, workspace]
|
|
8
|
-
priority: 0.5
|
|
9
|
-
related: [standards/turbo/best-practices, standards/turbo/filtering]
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Rule
|
|
13
|
-
|
|
14
|
-
`turbo watch <task>` re-runs a task across the workspace whenever its inputs
|
|
15
|
-
change, respecting the dependency graph — an edit in a library re-triggers its
|
|
16
|
-
dependents in topological order. This is distinct from a framework's own watcher:
|
|
17
|
-
turbo watch coordinates the **graph**, the per-package tool handles incremental
|
|
18
|
-
recompilation inside one package.
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
turbo watch build:dev # rebuild dev artifacts on change, in dep order
|
|
22
|
-
turbo watch test --filter=@savvy-web/mcp...
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Persistent (dev) tasks
|
|
26
|
-
|
|
27
|
-
A long-running process — a dev server, a `tsc --watch`, a sidecar — is a
|
|
28
|
-
**persistent** task. Mark it so turbo never treats its exit as task completion
|
|
29
|
-
and never tries to cache it:
|
|
30
|
-
|
|
31
|
-
```jsonc
|
|
32
|
-
{
|
|
33
|
-
"tasks": {
|
|
34
|
-
"dev": { "persistent": true, "cache": false }
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
A persistent task may not appear in another task's `dependsOn` (it never
|
|
40
|
-
finishes, so nothing downstream could ever start). Model a needed background
|
|
41
|
-
service as a separate persistent task you start alongside, not as a dependency
|
|
42
|
-
edge.
|
|
43
|
-
|
|
44
|
-
## Interactive tasks
|
|
45
|
-
|
|
46
|
-
Tasks that need a TTY (prompts, REPLs) must opt in with `"interactive": true` so
|
|
47
|
-
turbo gives them stdin and does not multiplex their output. Reserve this for
|
|
48
|
-
genuinely interactive tooling; most CI tasks should stay non-interactive so logs
|
|
49
|
-
stream cleanly.
|
|
50
|
-
|
|
51
|
-
## Caveats
|
|
52
|
-
|
|
53
|
-
- Watch mode shines for iteration, not validation. CI still runs discrete
|
|
54
|
-
`turbo run` tasks so every step is hashed and cacheable.
|
|
55
|
-
- Newly added or deleted files may need a watcher restart if a tool's own
|
|
56
|
-
watcher does not pick up tree changes.
|
|
57
|
-
- `cache: false` on persistent tasks is required; a cached "dev server" is
|
|
58
|
-
meaningless and turbo will warn.
|
|
59
|
-
|
|
60
|
-
## See also
|
|
61
|
-
|
|
62
|
-
The persistent-task / `dependsOn` interaction is covered under outputs and
|
|
63
|
-
parallelism at `silk://standards/turbo/best-practices`. Scoping watch to a subset
|
|
64
|
-
uses the syntax at `silk://standards/turbo/filtering`.
|
package/public/content/tags.json
DELETED
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"changeset": ["changesets"],
|
|
3
|
-
"release": [],
|
|
4
|
-
"commit": ["commits", "conventional-commits"],
|
|
5
|
-
"dco": [],
|
|
6
|
-
"tdd": [],
|
|
7
|
-
"catalog": ["version-catalog"],
|
|
8
|
-
"dependencies": ["deps", "peer-dependencies"],
|
|
9
|
-
"lint": ["linting", "biome", "markdownlint"],
|
|
10
|
-
"test": ["testing", "vitest"],
|
|
11
|
-
"publishability": ["publish", "publishConfig", "private"],
|
|
12
|
-
"silk-effects": [],
|
|
13
|
-
"effect": ["layers", "context-tag"],
|
|
14
|
-
"managed-section": ["sections", "husky"],
|
|
15
|
-
"cli": ["savvy"],
|
|
16
|
-
"init": ["setup", "scaffold"],
|
|
17
|
-
"silk": ["install"],
|
|
18
|
-
"mcp": ["resources", "savvy-mcp"],
|
|
19
|
-
"build": ["rslib", "esm"],
|
|
20
|
-
"workspace": ["monorepo", "workspaces"],
|
|
21
|
-
"api": ["api-reference", "reference"],
|
|
22
|
-
"templates": ["scaffolding"],
|
|
23
|
-
"github-action-effects": ["gha-effects"],
|
|
24
|
-
"github-action-builder": ["gha-builder"],
|
|
25
|
-
"bundler": ["tsdown", "build-orchestrator"],
|
|
26
|
-
"tsdown-plugins": ["rolldown", "plugins"],
|
|
27
|
-
"rspress-builder": ["rspress", "docs-builder"],
|
|
28
|
-
"semver": ["versioning"],
|
|
29
|
-
"github-actions": ["gha", "actions"],
|
|
30
|
-
"turbo": ["turborepo"],
|
|
31
|
-
"ci": ["continuous-integration", "remote-cache"]
|
|
32
|
-
}
|