Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions .agent/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
this dir hosts the .skills and .briefs useful to any agent, human or robot, when at work in this repo

repo=.this specifies the docs that are scoped to this specific @gitroot repo

repo=$repo specifies the docs that are scoped to any rhachet repo

---

glossary

agents = actors w/ delegated authority
actors = roles w/ repl
roles = coherent collections of skills and briefs
skills = mechanisms that can be executed to produce curated effects
briefs = resources that externalize knowledge of curated concepts
brain = a human or robot imagination machine
- e.g., robot:llama:openai.o4
- e.g., robot:agent:claude.sonnet.v4_5
- e.g., human:agent:you

---

written by rhachet 🦾
3 changes: 3 additions & 0 deletions .agent/repo=.this/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
this directory contains the .skills and .briefs scoped to this specific @gitroot repository

these are resources that are specific to the current project and may not be reusable across other repositories
1 change: 1 addition & 0 deletions .agent/repo=ehmpathy/role=mechanic/briefs/.briefs
7 changes: 7 additions & 0 deletions .agent/repo=ehmpathy/role=mechanic/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
## 🔧 Mechanic

- **scale**: repo-level, implementation detail
- **focus**: maintainability, observability, readability
- **maximizes**: empathy for the 3am on-call engineer

Used to write and revise the actual logic that runs the system.
1 change: 1 addition & 0 deletions .agent/repo=ehmpathy/role=mechanic/skills/.skills
4 changes: 4 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -1,2 +1,6 @@
# exclude package-lock from git diff; https://stackoverflow.com/a/72834452/3068233
package-lock.json -diff

# exclude package locks from git diff; https://stackoverflow.com/a/72834452/3068233
pnpm-lock.json -diff
package-lock.json -diff
8 changes: 6 additions & 2 deletions .github/workflows/.declastruct.yml
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,9 @@ jobs:

- name: declastruct plan
id: plan
run: npx declastruct plan --wish ${{ inputs.wish-path }} --into ${{ inputs.wish-path }}.plan.json | tee ./plan.log
run: |
set -o pipefail
npx declastruct plan --wish ${{ inputs.wish-path }} --into ${{ inputs.wish-path }}.plan.json | tee ./plan.log
env:
GITHUB_TOKEN: ${{ secrets.github-token }} # allow specifying a github token to pass to the terraform command

Expand Down Expand Up @@ -104,6 +106,8 @@ jobs:
path: ${{ steps.extract-dir.outputs.wish-dir }}

- name: declastruct apply
run: npx declastruct apply --plan ${{ inputs.wish-path }}.plan.json | tee ./apply.log
run: |
set -o pipefail
npx declastruct apply --plan ${{ inputs.wish-path }}.plan.json | tee ./apply.log
env:
GITHUB_TOKEN: ${{ secrets.github-token }} # allow specifying a github token to pass to the terraform command
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
*.local.json
*.log
*.tsbuildinfo
.artifact
Expand Down
21 changes: 17 additions & 4 deletions biome.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@
"!**/coverage",
"!**/node_modules",
"!**/.artifact",
"!**/.generated/**"
"!**/.generated",
"!**/.test*"
]
},
"formatter": {
Expand All @@ -27,7 +28,13 @@
"trailingCommas": "all"
}
},
"assist": { "actions": { "source": { "organizeImports": "on" } } },
"assist": {
"actions": {
"source": {
"organizeImports": "on"
}
}
},
"linter": {
"enabled": true,
"rules": {
Expand All @@ -36,13 +43,19 @@
"noExcessiveCognitiveComplexity": "warn"
},
"correctness": {
"noUnusedImports": { "level": "error", "fix": "safe" },
"noUnusedImports": {
"level": "error",
"fix": "safe"
},
"noUnusedVariables": "warn",
"useExhaustiveDependencies": "off"
},
"style": {
"noDefaultExport": "error",
"noNonNullAssertion": { "level": "warn", "fix": "none" },
"noNonNullAssertion": {
"level": "warn",
"fix": "none"
},
"useImportType": "error",
"noParameterAssign": "off"
},
Expand Down
15 changes: 9 additions & 6 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@
"fix:format:biome": "biome check --write src",
"fix:format": "npm run fix:format:biome",
"fix:lint": "biome check --write src",
"fix": "npm run fix:format && npm run fix:lint",
"build:clean": "rm dist/ -rf",
"build:compile": "tsc -p ./tsconfig.build.json",
"build": "npm run build:clean && npm run build:compile",
Expand All @@ -52,13 +53,15 @@
"preversion": "npm run prepush",
"postversion": "git push origin HEAD --tags --no-verify",
"prepare:husky": "npx husky install && chmod ug+x .husky/*",
"prepare": "[ -d .git ] && npm run prepare:husky || exit 0"
"prepare": "[ -e .git ] && npm run prepare:husky || exit 0"
},
"dependencies": {
"change-case": "^4.1.2",
"domain-objects": "0.31.0",
"domain-objects": "0.31.3",
"helpful-errors": "1.5.3",
"joi": "17.4.0",
"rhachet": "^1.13.1",
"rhachet-roles-ehmpathy": "^1.13.3",
"type-fns": "1.21.0",
"uuid-fns": "^1.1.3"
},
Expand All @@ -76,10 +79,10 @@
"@types/node": "22.15.21",
"@types/yup": "^0.29.6",
"cz-conventional-changelog": "3.3.0",
"declapract": "^0.12.3",
"declapract-typescript-ehmpathy": "^0.43.6",
"declastruct": "1.4.0",
"declastruct-github": "1.0.3",
"declapract": "^0.13.0",
"declapract-typescript-ehmpathy": "^0.43.12",
"declastruct": "1.5.1",
"declastruct-github": "1.0.7",
"depcheck": "1.4.3",
"esbuild-register": "3.6.0",
"husky": "8.0.3",
Expand Down
Loading