@form8ion/git 2.1.1 → 3.0.0-beta.1

package/README.md

@@ -105,7 +105,7 @@ $ npm test
 
 [renovate-link]: https://renovatebot.com
 
-[renovate-badge]: https://img.shields.io/badge/renovate-enabled-brightgreen.svg?logo=renovatebot
+[renovate-badge]: https://img.shields.io/badge/renovate-enabled-brightgreen.svg?logo=renovate
 
 [PRs-link]: https://makeapullrequest.com
 
@@ -117,7 +117,7 @@ $ npm test
 
 [coverage-link]: https://codecov.io/github/form8ion/git
 
-[coverage-badge]: https://img.shields.io/codecov/c/github/form8ion/git?logo=codecov
+[coverage-badge]: https://img.shields.io/codecov/c/github/form8ion/git/master?logo=codecov
 
 [slsa-badge]: https://slsa.dev/images/gh-badge-level2.svg
 

package/lib/index.js

@@ -8,7 +8,7 @@ function writeGitIgnore({projectRoot, ignores}) {
   return write({projectRoot, name: 'git', ignores});
 }
 
-function scaffoldIgnore ({projectRoot}) {
+function scaffoldeIgnore({projectRoot}) {
   return writeGitIgnore({projectRoot, ignores: []});
 }
 
@@ -30,7 +30,7 @@ async function appendToIgnoreFile({projectRoot, ignores}) {
   await writeGitIgnore({projectRoot, ignores: [...existingIgnores, ...ignores]});
 }
 
-async function liftIgnore ({projectRoot, results: {vcsIgnore}}) {
+async function liftIgnore({projectRoot, results: {vcsIgnore}}) {
   if (vcsIgnore) {
     info('Updating files and directories to be ignored from version control', {level: 'secondary'});
 
@@ -42,30 +42,30 @@ async function liftIgnore ({projectRoot, results: {vcsIgnore}}) {
   return {};
 }
 
-async function scaffolder ({projectRoot}) {
+async function scaffoldGit({projectRoot}) {
   info('Initializing Git Repository');
 
   const git = simpleGit({baseDir: projectRoot});
 
   await Promise.all([
-    scaffoldIgnore({projectRoot}),
+    scaffoldeIgnore({projectRoot}),
     git.init()
   ]);
 
   return {};
 }
 
-function tester ({projectRoot}) {
+function projectVersionedWithGit({projectRoot}) {
   const git = simpleGit({baseDir: projectRoot});
 
   return git.checkIsRepo('root');
 }
 
-function scaffoldAttributes ({projectRoot}) {
+function scaffoldAttributes({projectRoot}) {
   return promises.writeFile(`${projectRoot}/.gitattributes`, '* text=auto');
 }
 
-async function lifter ({projectRoot, results}) {
+async function liftGit({projectRoot, results}) {
   await Promise.all([
     scaffoldAttributes({projectRoot}),
     liftIgnore({projectRoot, results})
@@ -74,5 +74,5 @@ async function lifter ({projectRoot, results}) {
   return {};
 }
 
-export { lifter as lift, scaffolder as scaffold, tester as test };
+export { liftGit as lift, scaffoldGit as scaffold, projectVersionedWithGit as test };
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/ignore/writer.js","../src/ignore/scaffolder.js","../src/ignore/existence-checker.js","../src/ignore/reader.js","../src/ignore/appender.js","../src/ignore/lifter.js","../src/scaffolder.js","../src/tester.js","../src/attributes/scaffolder.js","../src/lifter.js"],"sourcesContent":["import {write} from '@form8ion/ignore-file';\n\nexport default function writeGitIgnore({projectRoot, ignores}) {\n  return write({projectRoot, name: 'git', ignores});\n}\n","import write from './writer.js';\n\nexport default function ({projectRoot}) {\n  return write({projectRoot, ignores: []});\n}\n","import {exists} from '@form8ion/ignore-file';\n\nexport default function gitignoreExists({projectRoot} = {}) {\n  return exists({projectRoot, name: 'git'});\n}\n","import {read} from '@form8ion/ignore-file';\n\nexport default function readGitIgnore({projectRoot}) {\n  return read({projectRoot, name: 'git'});\n}\n","import gitignoreExists from './existence-checker.js';\nimport readGitIgnore from './reader.js';\nimport writeGitIgnore from './writer.js';\n\nexport default async function appendToIgnoreFile({projectRoot, ignores}) {\n  let existingIgnores = [];\n\n  if (await gitignoreExists({projectRoot})) {\n    existingIgnores = await readGitIgnore({projectRoot});\n  }\n\n  await writeGitIgnore({projectRoot, ignores: [...existingIgnores, ...ignores]});\n}\n","import {info} from '@travi/cli-messages';\n\nimport appendIgnores from './appender.js';\n\nexport default async function ({projectRoot, results: {vcsIgnore}}) {\n  if (vcsIgnore) {\n    info('Updating files and directories to be ignored from version control', {level: 'secondary'});\n\n    const {directories = [], files = []} = vcsIgnore;\n\n    await appendIgnores({projectRoot, ignores: [...directories, ...files]});\n  }\n\n  return {};\n}\n","import simpleGit from 'simple-git';\nimport {info} from '@travi/cli-messages';\n\nimport {scaffold as scaffoldIgnore} from './ignore/index.js';\n\nexport default async function ({projectRoot}) {\n  info('Initializing Git Repository');\n\n  const git = simpleGit({baseDir: projectRoot});\n\n  await Promise.all([\n    scaffoldIgnore({projectRoot}),\n    git.init()\n  ]);\n\n  return {};\n}\n","import simpleGit from 'simple-git';\n\nexport default function ({projectRoot}) {\n  const git = simpleGit({baseDir: projectRoot});\n\n  return git.checkIsRepo('root');\n}\n","import {promises as fs} from 'node:fs';\n\nexport default function ({projectRoot}) {\n  return fs.writeFile(`${projectRoot}/.gitattributes`, '* text=auto');\n}\n","import {scaffold as scaffoldAttributes} from './attributes/index.js';\nimport {lift as liftIgnore} from './ignore/index.js';\n\nexport default async function ({projectRoot, results}) {\n  await Promise.all([\n    scaffoldAttributes({projectRoot}),\n    liftIgnore({projectRoot, results})\n  ]);\n\n  return {};\n}\n"],"names":["write","appendIgnores","fs"],"mappings":";;;;;;AAEe,SAAS,cAAc,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;AAC/D,EAAE,OAAO,KAAK,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACnD;;ACFe,uBAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;AACxC,EAAE,OAAOA,cAAK,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1C;;ACFe,SAAS,eAAe,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE;AAC5D,EAAE,OAAO,MAAM,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3C;;ACFe,SAAS,aAAa,CAAC,CAAC,WAAW,CAAC,EAAE;AACrD,EAAE,OAAO,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACzC;;ACAe,eAAe,kBAAkB,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;AACzE,EAAE,IAAI,eAAe,GAAG,EAAE;;AAE1B,EAAE,IAAI,MAAM,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE;AAC5C,IAAI,eAAe,GAAG,MAAM,aAAa,CAAC,CAAC,WAAW,CAAC,CAAC;AACxD;;AAEA,EAAE,MAAM,cAAc,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;AAChF;;ACRe,yBAAc,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE;AACpE,EAAE,IAAI,SAAS,EAAE;AACjB,IAAI,IAAI,CAAC,mEAAmE,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;;AAEnG,IAAI,MAAM,CAAC,WAAW,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,CAAC,GAAG,SAAS;;AAEpD,IAAI,MAAMC,kBAAa,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;AAC3E;;AAEA,EAAE,OAAO,EAAE;AACX;;ACTe,yBAAc,EAAE,CAAC,WAAW,CAAC,EAAE;AAC9C,EAAE,IAAI,CAAC,6BAA6B,CAAC;;AAErC,EAAE,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;;AAE/C,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC;AACpB,IAAI,cAAc,CAAC,CAAC,WAAW,CAAC,CAAC;AACjC,IAAI,GAAG,CAAC,IAAI;AACZ,GAAG,CAAC;;AAEJ,EAAE,OAAO,EAAE;AACX;;ACde,eAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;AACxC,EAAE,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;;AAE/C,EAAE,OAAO,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;AAChC;;ACJe,2BAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;AACxC,EAAE,OAAOC,QAAE,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;AACrE;;ACDe,qBAAc,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;AACvD,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC;AACpB,IAAI,kBAAkB,CAAC,CAAC,WAAW,CAAC,CAAC;AACrC,IAAI,UAAU,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC;AACrC,GAAG,CAAC;;AAEJ,EAAE,OAAO,EAAE;AACX;;;;"}
+{"version":3,"file":"index.js","sources":["../src/ignore/writer.js","../src/ignore/scaffolder.js","../src/ignore/existence-checker.js","../src/ignore/reader.js","../src/ignore/appender.js","../src/ignore/lifter.js","../src/scaffolder.js","../src/tester.js","../src/attributes/scaffolder.js","../src/lifter.js"],"sourcesContent":["import {write} from '@form8ion/ignore-file';\n\nexport default function writeGitIgnore({projectRoot, ignores}) {\n  return write({projectRoot, name: 'git', ignores});\n}\n","import write from './writer.js';\n\nexport default function scaffoldeIgnore({projectRoot}) {\n  return write({projectRoot, ignores: []});\n}\n","import {exists} from '@form8ion/ignore-file';\n\nexport default function gitignoreExists({projectRoot} = {}) {\n  return exists({projectRoot, name: 'git'});\n}\n","import {read} from '@form8ion/ignore-file';\n\nexport default function readGitIgnore({projectRoot}) {\n  return read({projectRoot, name: 'git'});\n}\n","import gitignoreExists from './existence-checker.js';\nimport readGitIgnore from './reader.js';\nimport writeGitIgnore from './writer.js';\n\nexport default async function appendToIgnoreFile({projectRoot, ignores}) {\n  let existingIgnores = [];\n\n  if (await gitignoreExists({projectRoot})) {\n    existingIgnores = await readGitIgnore({projectRoot});\n  }\n\n  await writeGitIgnore({projectRoot, ignores: [...existingIgnores, ...ignores]});\n}\n","import {info} from '@travi/cli-messages';\n\nimport appendIgnores from './appender.js';\n\nexport default async function liftIgnore({projectRoot, results: {vcsIgnore}}) {\n  if (vcsIgnore) {\n    info('Updating files and directories to be ignored from version control', {level: 'secondary'});\n\n    const {directories = [], files = []} = vcsIgnore;\n\n    await appendIgnores({projectRoot, ignores: [...directories, ...files]});\n  }\n\n  return {};\n}\n","import simpleGit from 'simple-git';\nimport {info} from '@travi/cli-messages';\n\nimport {scaffold as scaffoldIgnore} from './ignore/index.js';\n\nexport default async function scaffoldGit({projectRoot}) {\n  info('Initializing Git Repository');\n\n  const git = simpleGit({baseDir: projectRoot});\n\n  await Promise.all([\n    scaffoldIgnore({projectRoot}),\n    git.init()\n  ]);\n\n  return {};\n}\n","import simpleGit from 'simple-git';\n\nexport default function projectVersionedWithGit({projectRoot}) {\n  const git = simpleGit({baseDir: projectRoot});\n\n  return git.checkIsRepo('root');\n}\n","import {promises as fs} from 'node:fs';\n\nexport default function scaffoldAttributes({projectRoot}) {\n  return fs.writeFile(`${projectRoot}/.gitattributes`, '* text=auto');\n}\n","import {scaffold as scaffoldAttributes} from './attributes/index.js';\nimport {lift as liftIgnore} from './ignore/index.js';\n\nexport default async function liftGit({projectRoot, results}) {\n  await Promise.all([\n    scaffoldAttributes({projectRoot}),\n    liftIgnore({projectRoot, results})\n  ]);\n\n  return {};\n}\n"],"names":["write","appendIgnores","scaffoldIgnore","fs"],"mappings":";;;;;;AAEe,SAAS,cAAc,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;AAC/D,EAAE,OAAO,KAAK,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACnD;;ACFe,SAAS,eAAe,CAAC,CAAC,WAAW,CAAC,EAAE;AACvD,EAAE,OAAOA,cAAK,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1C;;ACFe,SAAS,eAAe,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE;AAC5D,EAAE,OAAO,MAAM,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3C;;ACFe,SAAS,aAAa,CAAC,CAAC,WAAW,CAAC,EAAE;AACrD,EAAE,OAAO,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACzC;;ACAe,eAAe,kBAAkB,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;AACzE,EAAE,IAAI,eAAe,GAAG,EAAE;;AAE1B,EAAE,IAAI,MAAM,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE;AAC5C,IAAI,eAAe,GAAG,MAAM,aAAa,CAAC,CAAC,WAAW,CAAC,CAAC;AACxD,EAAE;;AAEF,EAAE,MAAM,cAAc,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;AAChF;;ACRe,eAAe,UAAU,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE;AAC9E,EAAE,IAAI,SAAS,EAAE;AACjB,IAAI,IAAI,CAAC,mEAAmE,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;;AAEnG,IAAI,MAAM,CAAC,WAAW,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,CAAC,GAAG,SAAS;;AAEpD,IAAI,MAAMC,kBAAa,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;AAC3E,EAAE;;AAEF,EAAE,OAAO,EAAE;AACX;;ACTe,eAAe,WAAW,CAAC,CAAC,WAAW,CAAC,EAAE;AACzD,EAAE,IAAI,CAAC,6BAA6B,CAAC;;AAErC,EAAE,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;;AAE/C,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC;AACpB,IAAIC,eAAc,CAAC,CAAC,WAAW,CAAC,CAAC;AACjC,IAAI,GAAG,CAAC,IAAI;AACZ,GAAG,CAAC;;AAEJ,EAAE,OAAO,EAAE;AACX;;ACde,SAAS,uBAAuB,CAAC,CAAC,WAAW,CAAC,EAAE;AAC/D,EAAE,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;;AAE/C,EAAE,OAAO,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;AAChC;;ACJe,SAAS,kBAAkB,CAAC,CAAC,WAAW,CAAC,EAAE;AAC1D,EAAE,OAAOC,QAAE,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;AACrE;;ACDe,eAAe,OAAO,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;AAC9D,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC;AACpB,IAAI,kBAAkB,CAAC,CAAC,WAAW,CAAC,CAAC;AACrC,IAAI,UAAU,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC;AACrC,GAAG,CAAC;;AAEJ,EAAE,OAAO,EAAE;AACX;;;;"}

package/package.json

@@ -2,57 +2,62 @@
   "name": "@form8ion/git",
   "description": "form8ion plugin for managing projects versioned with git",
   "license": "MIT",
-  "version": "2.1.1",
+  "version": "3.0.0-beta.1",
   "type": "module",
   "engines": {
-    "node": "^18.19.0 || ^20.9.0 || >=22.11.0"
+    "node": "^22.22.2 || >=24.15"
   },
   "author": "Matt Travi <npm@travi.org> (https://matt.travi.org)",
-  "repository": "form8ion/git",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/form8ion/git.git"
+  },
   "bugs": "https://github.com/form8ion/git/issues",
-  "homepage": "https://npm.im/@form8ion/git",
+  "homepage": "https://www.npmjs.com/package/@form8ion/git",
   "runkitExampleFilename": "./example.js",
   "exports": "./lib/index.js",
   "main": "./lib/index.js",
   "sideEffects": false,
   "scripts": {
-    "build:js": "rollup --config",
-    "watch": "run-s 'build:js -- --watch'",
-    "clean": "rimraf ./lib",
-    "prebuild": "run-s clean",
-    "build": "npm-run-all --print-label --parallel build:*",
-    "prepack": "run-s build",
-    "pregenerate:md": "run-s build",
-    "test:unit": "cross-env NODE_ENV=test c8 run-s test:unit:base",
-    "test:unit:base": "DEBUG=any vitest run",
+    "pretest": "run-s build",
+    "test": "npm-run-all --print-label --parallel lint:* --parallel test:*",
+    "lint:engines": "ls-engines",
+    "lint:gherkin": "gherkin-lint --config=.gherkin-lintrc.json",
+    "lint:js": "eslint . --cache",
+    "lint:js:fix": "run-s 'lint:js -- --fix'",
     "lint:lockfile": "lockfile-lint",
-    "prepare": "husky",
     "lint:md": "remark . --frail",
-    "generate:md": "remark . --output",
     "lint:peer": "npm ls >/dev/null",
-    "pretest:integration:base": "run-s build",
+    "lint:publish": "publint --strict",
+    "test:unit": "run-s 'test:unit:base -- --coverage'",
+    "test:unit:base": "NODE_ENV=test DEBUG=any vitest run src/",
     "test:integration": "run-s 'test:integration:base -- --profile noWip'",
+    "pretest:integration:base": "run-s build",
     "test:integration:base": "NODE_OPTIONS=--enable-source-maps DEBUG=any cucumber-js test/integration",
     "test:integration:debug": "DEBUG=test run-s test:integration",
+    "test:integration:focus": "run-s 'test:integration:base -- --profile focus'",
     "test:integration:wip": "run-s 'test:integration:base -- --profile wip'",
     "test:integration:wip:debug": "DEBUG=test run-s 'test:integration:wip'",
-    "test:integration:focus": "run-s 'test:integration:base -- --profile focus'",
-    "lint:gherkin": "gherkin-lint --config=.gherkin-lintrc.json",
-    "lint:js": "eslint . --cache",
-    "lint:js:fix": "run-s 'lint:js -- --fix'",
-    "lint:publish": "publint --strict",
-    "test": "npm-run-all --print-label build --parallel lint:* --parallel test:*",
-    "lint:engines": "ls-engines"
+    "prebuild": "run-s clean",
+    "build": "npm-run-all --print-label --parallel build:*",
+    "build:js": "rollup --config",
+    "clean": "rimraf ./lib",
+    "pregenerate:md": "run-s build",
+    "generate:md": "remark . --output",
+    "prepack": "run-s build",
+    "prepare": "husky",
+    "watch": "run-s 'build:js -- --watch'"
   },
   "files": [
     "example.js",
-    "lib/"
+    "lib/",
+    "src/"
   ],
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "packageManager": "npm@11.1.0+sha512.acf301ad9b9ddba948fcb72341e2f0fcae477f56a95cc2a092934d133a7461062633cefbf93d5934a3dc0768674e2edee9f04dcfcc4bb4c327ff0e3a7d552a1b",
+  "packageManager": "npm@11.12.1+sha512.cdca14b85d647b3192028d02aadbe82d75f79a446aceea9874be98e6d768f20ebd3555770a48d0e9906106007877bbc690f715e9372f2e2dc644a3c3157fb14c",
   "dependencies": {
     "@form8ion/core": "^4.3.0",
     "@form8ion/ignore-file": "^1.0.0",
@@ -60,31 +65,30 @@
     "simple-git": "^3.25.0"
   },
   "devDependencies": {
-    "@cucumber/cucumber": "11.2.0",
-    "@form8ion/commitlint-config": "2.0.3",
-    "@form8ion/eslint-config": "7.0.12",
+    "@cucumber/cucumber": "11.3.0",
+    "@form8ion/commitlint-config": "2.0.11",
+    "@form8ion/eslint-config": "7.1.0-beta.1",
     "@form8ion/eslint-config-cucumber": "1.4.1",
-    "@form8ion/remark-lint-preset": "6.0.6",
-    "@travi/any": "3.1.2",
-    "c8": "10.1.3",
-    "chai": "5.1.2",
-    "cross-env": "7.0.3",
+    "@form8ion/remark-lint-preset": "6.0.7",
+    "@travi/any": "3.3.0",
+    "@vitest/coverage-v8": "4.1.4",
+    "chai": "6.2.2",
     "cz-conventional-changelog": "3.3.0",
     "gherkin-lint": "4.2.4",
     "husky": "9.1.7",
-    "lockfile-lint": "4.14.0",
-    "ls-engines": "0.9.3",
-    "mock-fs": "5.4.1",
-    "npm-run-all2": "7.0.2",
-    "publint": "0.3.2",
+    "lockfile-lint": "5.0.0",
+    "ls-engines": "0.9.4",
+    "mock-fs": "5.5.0",
+    "npm-run-all2": "8.0.4",
+    "publint": "0.3.18",
     "remark-cli": "12.0.1",
     "remark-toc": "9.0.0",
     "remark-usage": "11.0.1",
-    "rimraf": "6.0.1",
-    "rollup": "4.32.1",
+    "rimraf": "6.1.3",
+    "rollup": "4.60.1",
     "rollup-plugin-auto-external": "2.0.0",
     "testdouble": "3.20.2",
-    "vitest": "3.0.5",
-    "vitest-when": "0.6.0"
+    "vitest": "4.1.4",
+    "vitest-when": "0.10.0"
   }
 }

package/src/attributes/index.js

@@ -0,0 +1 @@
+export {default as scaffold} from './scaffolder.js';

package/src/attributes/scaffolder.js

@@ -0,0 +1,5 @@
+import {promises as fs} from 'node:fs';
+
+export default function scaffoldAttributes({projectRoot}) {
+  return fs.writeFile(`${projectRoot}/.gitattributes`, '* text=auto');
+}

package/src/attributes/scaffolder.test.js

@@ -0,0 +1,18 @@
+import {promises as fs} from 'node:fs';
+
+import {describe, expect, it, vi} from 'vitest';
+import any from '@travi/any';
+
+import scaffoldAttributes from './scaffolder.js';
+
+vi.mock('node:fs');
+
+describe('attributes scaffolder', () => {
+  it('should create the attributes file', async () => {
+    const projectRoot = any.string();
+
+    await scaffoldAttributes({projectRoot});
+
+    expect(fs.writeFile).toHaveBeenCalledWith(`${projectRoot}/.gitattributes`, '* text=auto');
+  });
+});

package/src/ignore/appender.js

@@ -0,0 +1,13 @@
+import gitignoreExists from './existence-checker.js';
+import readGitIgnore from './reader.js';
+import writeGitIgnore from './writer.js';
+
+export default async function appendToIgnoreFile({projectRoot, ignores}) {
+  let existingIgnores = [];
+
+  if (await gitignoreExists({projectRoot})) {
+    existingIgnores = await readGitIgnore({projectRoot});
+  }
+
+  await writeGitIgnore({projectRoot, ignores: [...existingIgnores, ...ignores]});
+}

package/src/ignore/appender.test.js

@@ -0,0 +1,36 @@
+import {describe, it, vi, expect} from 'vitest';
+// eslint-disable-next-line import/no-unresolved
+import {when} from 'vitest-when';
+import any from '@travi/any';
+
+import gitignoreExists from './existence-checker.js';
+import read from './reader.js';
+import write from './writer.js';
+import appendToIgnoreFile from './appender.js';
+
+vi.mock('./existence-checker.js');
+vi.mock('./reader.js');
+vi.mock('./writer.js');
+
+describe('gitignore appender', () => {
+  const projectRoot = any.string();
+  const ignores = any.listOf(any.string);
+
+  it('should add the provided ignores to the existing gitignore', async () => {
+    const existingIgnores = any.listOf(any.string);
+    when(gitignoreExists).calledWith({projectRoot}).thenResolve(true);
+    when(read).calledWith({projectRoot}).thenResolve(existingIgnores);
+
+    await appendToIgnoreFile({projectRoot, ignores});
+
+    expect(write).toHaveBeenCalledWith({projectRoot, ignores: [...existingIgnores, ...ignores]});
+  });
+
+  it('should write only the provided ignores when the ignore file does not yet exist', async () => {
+    when(gitignoreExists).calledWith({projectRoot}).thenResolve(false);
+
+    await appendToIgnoreFile({projectRoot, ignores});
+
+    expect(write).toHaveBeenCalledWith({projectRoot, ignores});
+  });
+});

package/src/ignore/existence-checker.js

@@ -0,0 +1,5 @@
+import {exists} from '@form8ion/ignore-file';
+
+export default function gitignoreExists({projectRoot} = {}) {
+  return exists({projectRoot, name: 'git'});
+}

package/src/ignore/existence-checker.test.js

@@ -0,0 +1,20 @@
+import {exists} from '@form8ion/ignore-file';
+
+import {it, describe, vi, expect} from 'vitest';
+import any from '@travi/any';
+// eslint-disable-next-line import/no-unresolved
+import {when} from 'vitest-when';
+
+import gitignoreExists from './existence-checker.js';
+
+vi.mock('@form8ion/ignore-file');
+
+describe('gitignore existence checker', () => {
+  it('should check for existence of the gitignore', async () => {
+    const projectRoot = any.string();
+    const fileExists = any.boolean();
+    when(exists).calledWith({projectRoot, name: 'git'}).thenResolve(fileExists);
+
+    expect(await gitignoreExists({projectRoot})).toBe(fileExists);
+  });
+});

package/src/ignore/index.js

@@ -0,0 +1,3 @@
+export {default as scaffold} from './scaffolder.js';
+export {default as test} from './tester.js';
+export {default as lift} from './lifter.js';

package/src/ignore/lifter.js

@@ -0,0 +1,15 @@
+import {info} from '@travi/cli-messages';
+
+import appendIgnores from './appender.js';
+
+export default async function liftIgnore({projectRoot, results: {vcsIgnore}}) {
+  if (vcsIgnore) {
+    info('Updating files and directories to be ignored from version control', {level: 'secondary'});
+
+    const {directories = [], files = []} = vcsIgnore;
+
+    await appendIgnores({projectRoot, ignores: [...directories, ...files]});
+  }
+
+  return {};
+}

package/src/ignore/lifter.test.js

@@ -0,0 +1,41 @@
+import {describe, expect, it, vi} from 'vitest';
+import any from '@travi/any';
+
+import appendToIgnores from './appender.js';
+import liftGitIgnore from './lifter.js';
+
+vi.mock('./appender.js');
+
+describe('gitignore lifter', () => {
+  const projectRoot = any.string();
+  const ignoredDirectories = any.listOf(any.word);
+  const ignoredFiles = any.listOf(any.word);
+
+  it('should append the provided ignores to the gitignore file', async () => {
+    expect(
+      await liftGitIgnore({projectRoot, results: {vcsIgnore: {directories: ignoredDirectories, files: ignoredFiles}}})
+    ).toEqual({});
+
+    expect(appendToIgnores).toHaveBeenCalledWith({projectRoot, ignores: [...ignoredDirectories, ...ignoredFiles]});
+  });
+
+  it('should append provided directories to ignore', async () => {
+    expect(await liftGitIgnore({projectRoot, results: {vcsIgnore: {directories: ignoredDirectories}}}))
+      .toEqual({});
+
+    expect(appendToIgnores).toHaveBeenCalledWith({projectRoot, ignores: ignoredDirectories});
+  });
+
+  it('should append provided directories to ignore', async () => {
+    expect(await liftGitIgnore({projectRoot, results: {vcsIgnore: {files: ignoredFiles}}}))
+      .toEqual({});
+
+    expect(appendToIgnores).toHaveBeenCalledWith({projectRoot, ignores: ignoredFiles});
+  });
+
+  it('should not update the ignore file if no additional ignores are provided', async () => {
+    expect(await liftGitIgnore({projectRoot, results: {}})).toEqual({});
+
+    expect(appendToIgnores).not.toHaveBeenCalledWith({projectRoot});
+  });
+});

package/src/ignore/reader.js

@@ -0,0 +1,5 @@
+import {read} from '@form8ion/ignore-file';
+
+export default function readGitIgnore({projectRoot}) {
+  return read({projectRoot, name: 'git'});
+}

package/src/ignore/reader.test.js

@@ -0,0 +1,20 @@
+import {read} from '@form8ion/ignore-file';
+
+import {it, describe, vi, expect} from 'vitest';
+import any from '@travi/any';
+// eslint-disable-next-line import/no-unresolved
+import {when} from 'vitest-when';
+
+import readGitIgnore from './reader.js';
+
+vi.mock('@form8ion/ignore-file');
+
+describe('gitignore reader', () => {
+  it('should read the contents of the .gitignore file', async () => {
+    const projectRoot = any.string();
+    const existingIgnores = any.listOf(any.word);
+    when(read).calledWith({projectRoot, name: 'git'}).thenResolve(existingIgnores);
+
+    expect(await readGitIgnore({projectRoot})).toEqual(existingIgnores);
+  });
+});

package/src/ignore/scaffolder.js

@@ -0,0 +1,5 @@
+import write from './writer.js';
+
+export default function scaffoldeIgnore({projectRoot}) {
+  return write({projectRoot, ignores: []});
+}

package/src/ignore/scaffolder.test.js

@@ -0,0 +1,17 @@
+import {describe, expect, it, vi} from 'vitest';
+import any from '@travi/any';
+
+import writeGitIgnore from './writer.js';
+import scaffold from './scaffolder.js';
+
+vi.mock('./writer.js');
+
+describe('ignore scaffolder', () => {
+  const projectRoot = any.string();
+
+  it('should write the directories and files', async () => {
+    await scaffold({projectRoot});
+
+    expect(writeGitIgnore).toHaveBeenCalledWith({projectRoot, ignores: []});
+  });
+});

package/src/ignore/tester.js

@@ -0,0 +1,5 @@
+import {fileExists} from '@form8ion/core';
+
+export default function ignoreExists({projectRoot}) {
+  return fileExists(`${projectRoot}/.gitignore`);
+}

package/src/ignore/tester.test.js

@@ -0,0 +1,30 @@
+import {fileExists} from '@form8ion/core';
+
+import {describe, it, expect, vi, afterEach} from 'vitest';
+import any from '@travi/any';
+// eslint-disable-next-line import/no-unresolved
+import {when} from 'vitest-when';
+
+import gitignoreExists from './tester.js';
+
+vi.mock('@form8ion/core');
+
+describe('gitignore tester', () => {
+  const projectRoot = any.string();
+
+  afterEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('should return `true` if a `.gitignore` file exists', async () => {
+    when(fileExists).calledWith(`${projectRoot}/.gitignore`).thenResolve(true);
+
+    expect(await gitignoreExists({projectRoot})).toBe(true);
+  });
+
+  it('should return `false` if a `.gitignore` file does not exist', async () => {
+    when(fileExists).calledWith(`${projectRoot}/.gitignore`).thenResolve(false);
+
+    expect(await gitignoreExists({projectRoot})).toBe(false);
+  });
+});

package/src/ignore/writer.js

@@ -0,0 +1,5 @@
+import {write} from '@form8ion/ignore-file';
+
+export default function writeGitIgnore({projectRoot, ignores}) {
+  return write({projectRoot, name: 'git', ignores});
+}

package/src/ignore/writer.test.js

@@ -0,0 +1,19 @@
+import {write} from '@form8ion/ignore-file';
+
+import {describe, it, vi, expect} from 'vitest';
+import any from '@travi/any';
+
+import writeGitIgnore from './writer.js';
+
+vi.mock('@form8ion/ignore-file');
+
+describe('gitignore writer', () => {
+  it('should write the provided ignores to the .gitignore file', async () => {
+    const projectRoot = any.string();
+    const ignores = any.listOf(any.string);
+
+    await writeGitIgnore({projectRoot, ignores});
+
+    expect(write).toHaveBeenCalledWith({projectRoot, name: 'git', ignores});
+  });
+});

package/src/index.js

@@ -0,0 +1,3 @@
+export {default as scaffold} from './scaffolder.js';
+export {default as test} from './tester.js';
+export {default as lift} from './lifter.js';

package/src/lifter.js

@@ -0,0 +1,11 @@
+import {scaffold as scaffoldAttributes} from './attributes/index.js';
+import {lift as liftIgnore} from './ignore/index.js';
+
+export default async function liftGit({projectRoot, results}) {
+  await Promise.all([
+    scaffoldAttributes({projectRoot}),
+    liftIgnore({projectRoot, results})
+  ]);
+
+  return {};
+}

package/src/lifter.test.js

@@ -0,0 +1,22 @@
+import any from '@travi/any';
+import {describe, expect, it, vi} from 'vitest';
+
+import {scaffold as scaffoldAttributes} from './attributes/index.js';
+import {lift as liftIgnore} from './ignore/index.js';
+import lift from './lifter.js';
+
+vi.mock('./attributes/index.js');
+vi.mock('./ignore/index.js');
+
+describe('git lifter', () => {
+  it('should define the attributes file', async () => {
+    const projectRoot = any.string();
+    const results = any.simpleObject();
+
+    const result = await lift({projectRoot, results});
+
+    expect(result).toEqual({});
+    expect(scaffoldAttributes).toHaveBeenCalledWith({projectRoot});
+    expect(liftIgnore).toHaveBeenCalledWith({projectRoot, results});
+  });
+});

package/src/scaffolder.js

@@ -0,0 +1,17 @@
+import simpleGit from 'simple-git';
+import {info} from '@travi/cli-messages';
+
+import {scaffold as scaffoldIgnore} from './ignore/index.js';
+
+export default async function scaffoldGit({projectRoot}) {
+  info('Initializing Git Repository');
+
+  const git = simpleGit({baseDir: projectRoot});
+
+  await Promise.all([
+    scaffoldIgnore({projectRoot}),
+    git.init()
+  ]);
+
+  return {};
+}

package/src/scaffolder.test.js

@@ -0,0 +1,27 @@
+import * as simpleGit from 'simple-git';
+
+import any from '@travi/any';
+import {describe, expect, it, vi} from 'vitest';
+// eslint-disable-next-line import/no-unresolved
+import {when} from 'vitest-when';
+
+import {scaffold as scaffoldIgnore} from './ignore/index.js';
+import scaffold from './scaffolder.js';
+
+vi.mock('touch');
+vi.mock('simple-git');
+vi.mock('./ignore/index.js');
+
+describe('scaffold', () => {
+  it('should initialize the repo', async () => {
+    const projectRoot = any.string();
+    const init = vi.fn();
+    when(simpleGit.simpleGit).calledWith({baseDir: projectRoot}).thenReturn({init});
+
+    const results = await scaffold({projectRoot});
+
+    expect(results).toEqual({});
+    expect(init).toHaveBeenCalled();
+    expect(scaffoldIgnore).toHaveBeenCalledWith({projectRoot});
+  });
+});

package/src/tester.js

@@ -0,0 +1,7 @@
+import simpleGit from 'simple-git';
+
+export default function projectVersionedWithGit({projectRoot}) {
+  const git = simpleGit({baseDir: projectRoot});
+
+  return git.checkIsRepo('root');
+}

package/src/tester.test.js

@@ -0,0 +1,35 @@
+import * as simpleGit from 'simple-git';
+
+import any from '@travi/any';
+import {beforeEach, describe, it, expect, vi} from 'vitest';
+// eslint-disable-next-line import/no-unresolved
+import {when} from 'vitest-when';
+
+import gitIsPresent from './tester.js';
+
+vi.mock('simple-git');
+
+describe('git predicate', () => {
+  let checkIsRepo;
+  const projectRoot = any.string();
+
+  beforeEach(() => {
+    checkIsRepo = vi.fn();
+
+    when(simpleGit.simpleGit)
+      .calledWith({baseDir: projectRoot})
+      .thenReturn({checkIsRepo});
+  });
+
+  it('should return `true` if a `.gitignore` file exists', async () => {
+    when(checkIsRepo).calledWith('root').thenResolve(true);
+
+    expect(await gitIsPresent({projectRoot})).toBe(true);
+  });
+
+  it('should return `false` if a `.gitignore` file does not exist', async () => {
+    when(checkIsRepo).calledWith('root').thenResolve(false);
+
+    expect(await gitIsPresent({projectRoot})).toBe(false);
+  });
+});