@really-knows-ai/foundry 3.0.1 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/README.md +8 -7
  2. package/dist/.opencode/plugins/foundry-tools/config-law-tools.js +53 -69
  3. package/dist/.opencode/plugins/foundry-tools/helpers.js +10 -19
  4. package/dist/.opencode/plugins/foundry-tools/refresh-agents-tool.js +88 -0
  5. package/dist/.opencode/plugins/foundry-tools/validate-tools.js +37 -29
  6. package/dist/.opencode/plugins/foundry.js +2 -0
  7. package/dist/CHANGELOG.md +182 -0
  8. package/dist/README.md +8 -7
  9. package/dist/agents/foundry.md +37 -0
  10. package/dist/docs/architecture.md +6 -3
  11. package/dist/docs/concepts.md +1 -1
  12. package/dist/docs/getting-started.md +57 -135
  13. package/dist/docs/tools.md +21 -1
  14. package/dist/scripts/sort.js +1 -1
  15. package/dist/skills/add-appraiser/SKILL.md +19 -34
  16. package/dist/skills/add-artefact-type/SKILL.md +47 -43
  17. package/dist/skills/add-cycle/SKILL.md +28 -37
  18. package/dist/skills/add-extractor/SKILL.md +21 -33
  19. package/dist/skills/add-flow/SKILL.md +43 -88
  20. package/dist/skills/add-law/SKILL.md +132 -26
  21. package/dist/skills/add-memory-edge-type/SKILL.md +11 -17
  22. package/dist/skills/add-memory-entity-type/SKILL.md +9 -16
  23. package/dist/skills/change-embedding-model/SKILL.md +6 -8
  24. package/dist/skills/drop-memory-edge-type/SKILL.md +6 -8
  25. package/dist/skills/drop-memory-entity-type/SKILL.md +6 -8
  26. package/dist/skills/dry-run/SKILL.md +11 -28
  27. package/dist/skills/flow/SKILL.md +1 -1
  28. package/dist/skills/init-foundry/SKILL.md +47 -27
  29. package/dist/skills/init-memory/SKILL.md +11 -22
  30. package/dist/skills/list-agents/SKILL.md +1 -1
  31. package/dist/skills/refresh-agents/SKILL.md +4 -26
  32. package/dist/skills/rename-memory-edge-type/SKILL.md +6 -8
  33. package/dist/skills/rename-memory-entity-type/SKILL.md +6 -8
  34. package/dist/skills/reset-memory/SKILL.md +10 -16
  35. package/dist/skills/upgrade-foundry/SKILL.md +1 -1
  36. package/package.json +2 -1
@@ -25,15 +25,13 @@ Before running this skill, verify all of the following:
25
25
  create one before continuing:
26
26
 
27
27
  > Foundry configuration changes must be made on a config/* branch.
28
- > From a clean main branch, call:
28
+ > If configuration changes are needed, move to a suitable `config/*`
29
+ > branch internally when the current branch is safe. If the current
30
+ > branch is `work/*` or `dry-run/*/*`, stop and explain the active
31
+ > work must be finished first.
29
32
  >
30
- > `foundry_git_branch({ kind: "config", description: "<short-name>" })`
31
- >
32
- > Then re-run this skill.
33
-
34
- If the user is on a `dry-run/*/*` branch, they must finish
35
- that dry-run first (`foundry_git_finish({ message, confirm: true })`)
36
- before re-running this skill on the parent `config/*`.
33
+ > After the prerequisite is handled, continue the user's original
34
+ > request from the current context.
37
35
 
38
36
  4. Memory is initialised. The `from` entity type must exist; the `to`
39
37
  name must be free (no existing entity or edge).
@@ -24,22 +24,16 @@ Before running this skill, verify all of the following:
24
24
  `git rev-parse --abbrev-ref HEAD` and confirm it matches
25
25
  `config/<description>`.
26
26
 
27
- 3. If the branch does not start with `config/`, instruct the user to
28
- create one before continuing:
29
-
30
- > Foundry configuration changes must be made on a config/* branch.
31
- > From a clean main branch, call:
32
- >
33
- > `foundry_git_branch({ kind: "config", description: "<short-name>" })`
34
- >
35
- > Then re-run this skill.
36
-
37
- If the user is on a `dry-run/*/*` branch, they must finish
38
- that dry-run first (`foundry_git_finish({ message, confirm: true })`)
39
- before re-running this skill on the parent `config/*`.
40
-
41
- 4. Memory is initialised (`foundry/memory/` exists; run `init-memory`
42
- if not).
27
+ 3. If the branch does not start with `config/`, move to a suitable
28
+ `config/*` branch internally when the current branch is safe. If
29
+ the current branch is `work/*` or `dry-run/*/*`, stop and explain
30
+ the active work must be finished first. When unrelated uncommitted
31
+ changes could be affected by branching or writing files, ask before
32
+ proceeding.
33
+
34
+ 4. Memory is initialised (`foundry/memory/` exists; initialise it
35
+ internally if not). After the reset completes, continue the user's
36
+ original request from context.
43
37
 
44
38
  ## Steps
45
39
 
@@ -20,7 +20,7 @@ Verify a safe base state before making changes:
20
20
 
21
21
  - The worktree is clean, or the user explicitly chooses how to handle dirty files.
22
22
  - `WORK.md` is absent from the repository root.
23
- - The upgrade runs from a config branch such as `config/upgrade-foundry`, or you create one with `foundry_git_branch({ kind: 'config', description: 'upgrade-foundry' })` before making config changes.
23
+ - The upgrade runs from a config branch such as `config/upgrade-foundry`. If configuration changes are needed, move to a suitable `config/*` branch internally when the current branch is safe. If the current branch is `work/*` or `dry-run/*/*`, stop and explain the active work must be finished first.
24
24
  - Use an isolated worktree where practical, matching the normal config-edit workflow.
25
25
 
26
26
  If `WORK.md` exists, stop and tell the user:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@really-knows-ai/foundry",
3
- "version": "3.0.1",
3
+ "version": "3.1.0",
4
4
  "description": "A skill-driven framework for governed artefact generation with AI coding tools. Define your own artefact types, laws, and flows — Foundry handles the forge → quench → appraise pipeline with deterministic routing, quality gates, and iterative refinement.",
5
5
  "type": "module",
6
6
  "main": "dist/.opencode/plugins/foundry.js",
@@ -34,6 +34,7 @@
34
34
  },
35
35
  "files": [
36
36
  "dist/.opencode/",
37
+ "dist/agents/",
37
38
  "dist/skills/",
38
39
  "dist/scripts/",
39
40
  "dist/docs/",