🏗🔧：correct file extensions of adrs & comply w/ ruleset

.remarkrc.mjs

@@ -2,9 +2,9 @@
 // Requirements
 // -----------------------------------------------------------------------------
 
-// import { readFileSync as fsReadFileSync } from 'node:fs';
+import { readFileSync as fsReadFileSync } from 'node:fs';
 import { unified } from 'unified';
-// import strip from 'strip-comments';
+import strip from 'strip-comments';
 
 const infoStrings = [
   'ada',
@@ -48,65 +48,62 @@
   'yaml',
 ];
 
-// const projectTerms = strip(fsReadFileSync('./project-terms.txt', 'utf8'));
+const projectTerms = strip(fsReadFileSync('./project-terms.txt', 'utf8'));
 
-// const naturalLanguage = unified().use([
-//   await import('retext-english'),
-//   await import('retext-syntax-urls'),
-//   await import('retext-equality'),
-//   await import('retext-passive'),
-//   await import('retext-profanities'),
-//   [await import('retext-readability'), { age: 21, minWords: 8 }],
-//   await import('retext-repeated-words'),
-//   [
-//     await import('retext-simplify'),
-//     { ignore: ['function', 'interface', 'maintain'] },
-//   ],
-//   [await import('retext-sentence-spacing'), { preferred: 1 }],
-//   await import('retext-syntax-mentions'),
-//   [
-//     await import('retext-spell'),
-//     { dictionary: await import('dictionary-en'), personal: projectTerms },
-//   ],
-//   await import('retext-syntax-urls'),
-// ]);
+const naturalLanguage = unified().use([
+  [await import('retext-english'), {}],
+  [await import('retext-syntax-urls'), {}],
+  [await import('retext-passive'), {}],
+  [await import('retext-readability'), { age: 21, minWords: 8 }],
+  [await import('retext-repeated-words'), {}],
+  [
+    await import('retext-simplify'),
+    { ignore: ['function', 'interface', 'maintain'] },
+  ],
+  [await import('retext-sentence-spacing'), { preferred: 1 }],
+  [await import('retext-syntax-mentions'), {}],
+  [
+    await import('retext-spell'),
+    { dictionary: await import('dictionary-en'), personal: projectTerms },
+  ],
+  [await import('retext-syntax-urls')],
+]);
 
 export default {
   plugins: [
     await import('remark-lint'),
     ['remark-gfm'],
     ['remark-footnotes'],
     ['remark-frontmatter'],
-    await import('remark-preset-lint-consistent'),
+    [await import('remark-preset-lint-consistent'), {}],
     // Leave this preset at the top so that it can be overridden.
-    await import('remark-preset-lint-recommended'),
+    [await import('remark-preset-lint-recommended'), {}],
     [
       await import('remark-lint-checkbox-character-style'),
       {
         checked: 'x',
         unchecked: ' ',
       },
     ],
-    await import('remark-lint-checkbox-content-indent'),
+    [await import('remark-lint-checkbox-content-indent')],
 
     // Remark Lint Style Guide preset and overrides.
-    ['remark-preset-lint-markdown-style-guide'],
+    [await import('remark-preset-lint-markdown-style-guide')],
+    ['remark-lint-no-file-name-consecutive-dashes', false],
     ['remark-lint-fenced-code-flag', { flags: infoStrings }],
     ['remark-lint-no-heading-punctuation', ':.,;'],
     ['remark-lint-no-file-name-mixed-case', false],
     ['remark-lint-no-file-name-irregular-characters', false],
     ['remark-lint-first-heading-level', 2],
 
     // Third-party plugins.
-    await import('remark-validate-links'),
-    await import('remark-lint-maximum-line-length'),
-    // await import("remark-lint-are-links-valid"),
-    // await import("@sfdocs-internal/remark-lint-no-dead-url"),
-    await import('remark-lint-no-duplicate-headings-in-section'),
-    // [await import('remark-retext'), naturalLanguage],
+    [await import('remark-validate-links'), {}],
+    [await import('remark-lint-maximum-line-length'), {}],
+    [await import('remark-lint-no-duplicate-headings-in-section'), {}],
+    [await import('remark-retext'), naturalLanguage],
 
     // Disables all rules that conflict with Prettier. Leave this preset at the
     // bottom so that it can't be overridden.
-    await import('remark-preset-prettier'),
+    [await import('remark-preset-prettier'), {}],
   ],
 };

.vscode/settings.json

@@ -33,8 +33,8 @@
       "source.fixAll.markdownlint": "explicit"
     },
     "editor.formatOnSave": true,
-    // "editor.defaultFormatter": "unifiedjs.vscode-remark"
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
+    "editor.defaultFormatter": "unifiedjs.vscode-remark"
+    // "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
   },
 
   // Render vertical rulers after a certain number of monospace characters.

README.md

@@ -1,4 +1,5 @@
 <!-- markdownlint-disable-next-line line-length -->
+
 <a href="##"><img src="https://raw.githubusercontent.com/OpenINF/openinf.github.io/live/assets/img/svg/logogram-color.svg?sanitize=true" alt="OpenINF logo" title="OpenINF" align="right" height="96" width="96" /></a>
 
 <div align="left">
@@ -117,12 +118,12 @@ how these files are expected to look.
 
 <br /><div align="center">
 
-| File name        | Title               | Description                                                              |
-| :--------------- | :------------------ | :----------------------------------------------------------------------- |
-| [`AUTHORS`][]    | The OpenINF Authors | Lists the contributors of their respective project repositories[^2][^3]  |
-| [`README.md`][]  | Homepage            | Serves as a project landing page of sorts                                |
-| [`LICENSE.md`][] | Software License(s) | The open source software license(s) associated with a project            |
-| [`VISION.md`][]  | Project Vision      | The goal(s) and/or scope of a project                                    |
+| File name        | Title               | Description                                                             |
+| :--------------- | :------------------ | :---------------------------------------------------------------------- |
+| [`AUTHORS`][]    | The OpenINF Authors | Lists the contributors of their respective project repositories[^2][^3] |
+| [`README.md`][]  | Homepage            | Serves as a project landing page of sorts                               |
+| [`LICENSE.md`][] | Software License(s) | The open source software license(s) associated with a project           |
+| [`VISION.md`][]  | Project Vision      | The goal(s) and/or scope of a project                                   |
 
 </div><br />
 
@@ -185,8 +186,7 @@ The [SPDX](https://spdx.dev) license identifier for this project is
 [^2]:
     <https://docs.npmjs.com/cli/v8/configuring-npm/package-json#default-values>
 
-[^3]:
-    <https://opensource.google/documentation/reference/releasing/authors>
+[^3]: <https://opensource.google/documentation/reference/releasing/authors>
 
 [`AUTHORS`]:
   https://github.com/OpenINF/.github/blob/HEAD/AUTHORS

doc/collections/_adrs/0001--decision_for_decisions.md

@@ -0,0 +1,11 @@
+---
+adr_name: ADR 0001
+title: Decision for Recording Decisions
+date: 2023-01-03 11:14:00 -0800
+updated: 2024-02-02 13:00:00 -0800
+status: Final
+---
+
+## Context
+
+Decision: Acceptable to document reasoning of choices

doc/collections/_adrs/0002--decision_for_monorepos.jekyll → doc/collections/_adrs/0002--decision_for_monorepos.md

@@ -1,20 +1,22 @@
 ---
 adr_name: ADR 0002
-title:    Decision for Monorepos
-date:     2023-04-19 13:00:00 -0800
-updated:  2024-02-02 13:00:00 -0800
-status:   Approved
+title: Decision for Monorepos
+date: 2023-04-19 13:00:00 -0800
+updated: 2024-02-02 13:00:00 -0800
+status: Approved
 ---
 
 ## Context
 
 - Technical forces:
+
   - Monorepos makes it easier to share code and dependencies between projects.
   - Monorepos can help improve code quality by finding and fixing bugs easier.
   - Monorepos can help improve developer productivity by making it easier to
     find and use the code you need.
 
 - Business forces:
+
   - Monorepos can help to improve collaboration between teams by making it
     easier to share code and resources.
   - Monorepos can help improve team communication by making it easier to track

doc/collections/_adrs/0003--decision_for_build_dir_logic.jekyll → doc/collections/_adrs/0003--decision_for_build_dir_logic.md

@@ -1,9 +1,9 @@
 ---
 adr_name: ADR 0003
-title:    Adoption of Dedicated Top-Level “Build” Directory in Codebase Layouts
-date:     2023-05-11 13:00:00 -0800
-updated:  2024-02-02 13:00:00 -0800
-status:   Approved
+title: Adoption of Dedicated Top-Level “Build” Directory in Codebase Layouts
+date: 2023-05-11 13:00:00 -0800
+updated: 2024-02-06 13:00:00 -0800
+status: Approved
 ---
 
 ## Context
@@ -16,7 +16,7 @@ well as build artifacts (object files, binaries, etc.).
 We decided to have two directories:
 
 - A "build" directory at workspace root containing build config and scripts
-- A "dist" subdirectory in each package root to contain final build artifacts
+- A "distrib" subdirectory in each package root to contain final build artifacts
 
 #### Codebase Overview
 
@@ -25,7 +25,7 @@ We decided to have two directories:
 │   └── 📂 tasks
 └── 📁 packages
     └── 📦 inf-log
-            └── 📂 dist
+            └── 📂 distrib
 ```
 
 ### Results
@@ -47,20 +47,21 @@ build/** linguist-generated=false
 #### For `dist`
 
 - Final build artifacts clearly separated from the source code and buildsystem
-- Artifacts can be packaged or deployed directly from the "dist" directory
-- The "dist" directory can be emptied or archived without impacting source or
+- Artifacts can be packaged or deployed directly from the "distrib" directory
+- The "distrib" directory can be emptied or archived without impacting source or
   buildsystem files.
 
 We configure `.gitattributes` to be configured as seen here:[^1]
 
 ```gitattributes
-dist/** linguist-generated=true
+distrib/** linguist-generated=true
 ```
 
 ### Next Steps
 
-- Implement the decision
-- Test the implementation
-- Release after acceptable testing
+> P.1 The development of AI without a blueprint of ethical principles will have
+> dangerous, unintended consequences. P.2 We must prevent dangerous, unintended
+> consequences. C. We must develop AI with a blueprint of ethical principles to
+> prevent dangerous, unintended consequences. — OpenINF Community Effort
 
 [^1]: https://github.com/github-linguist/linguist/blob/master/docs/overrides.md

doc/collections/_adrs/0004--decision_for_tools_dir.jekyll → doc/collections/_adrs/0004--decision_for_tools_dir.md

@@ -1,9 +1,9 @@
 ---
 adr_name: ADR 0004
-title:    Adoption of Dedicated Top-Level “Tools” Directory in Codebase Layouts
-date:     2024-01-26 23:45:00 -0800
-updated:  2024-02-02 13:00:00 -0800
-status:   Approved
+title: Adoption of Dedicated Top-Level “Tools” Directory in Codebase Layouts
+date: 2024-01-26 23:45:00 -0800
+updated: 2024-02-02 13:00:00 -0800
+status: Approved
 ---
 
 ## Problem Statement
@@ -15,9 +15,13 @@ the activities involved in project maintenance, development, and delivery.
 
 <br />
 
-**Inspiration**: [@OpenINF/ATeamGrimesAI][]
-**Authors**: [@OpenINF/ATeamClaude][], [@OpenINF/ATeamDerekNonGeneric][], [@OpenINF/ATeamGrok][]
-**Editors**: [@OpenINF/ATeamGrammarly][]
+- **Inspiration**:
+  - [@OpenINF/ATeamGrimesAI][]
+- **Authors**:
+  - [@OpenINF/ATeamClaude][]
+  - [@OpenINF/ATeamDerekNonGeneric][]
+- **Editors**:
+  - [@OpenINF/ATeamGrammarly][]
 
 <br /><br />
 
@@ -129,11 +133,14 @@ unmaintainable.
 
 <!-- Credits -->
 
-[@OpenINF/ATeamClaude]: https://github.com/OpenINF/wg-a-team#ai-non-persons-roster
-[@OpenINF/ATeamGrammarly]: https://github.com/OpenINF/wg-a-team#ai-non-persons-roster
-[@OpenINF/ATeamGrimesAI]: https://github.com/OpenINF/wg-a-team#ai-non-persons-roster
-[@OpenINF/ATeamGrok]: https://github.com/OpenINF/wg-a-team#ai-non-persons-roster
-[@OpenINF/ATeamDerekNonGeneric]: https://github.com/OpenINF/wg-a-team#persons-roster
+[@OpenINF/ATeamClaude]:
+  https://github.com/OpenINF/wg-a-team#ai-non-persons-roster
+[@OpenINF/ATeamGrammarly]:
+  https://github.com/OpenINF/wg-a-team#ai-non-persons-roster
+[@OpenINF/ATeamGrimesAI]:
+  https://github.com/OpenINF/wg-a-team#ai-non-persons-roster
+[@OpenINF/ATeamDerekNonGeneric]:
+  https://github.com/OpenINF/wg-a-team#persons-roster
 
 <!-- Prior Art -->
 

package.json

@@ -99,9 +99,7 @@
     "remark-retext": "6.0.0",
     "remark-validate-links": "13.0.0",
     "retext-english": "5.0.0",
-    "retext-equality": "7.0.0",
     "retext-passive": "5.0.0",
-    "retext-profanities": "8.0.0",
     "retext-readability": "8.0.0",
     "retext-repeated-words": "5.0.0",
     "retext-sentence-spacing": "6.0.0",