@evref-bl/pharo-mcp 3.0.0 → 3.2.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/README.md +5 -7
- package/package.json +1 -1
- package/templates/pharo-references/pharo-coding.md +105 -0
- package/templates/pharo-references/tool-reference.md +78 -158
- package/templates/pharo-skills/pharo-ci-repro/references/pharo-smalltalkci.md +4 -28
- package/templates/pharo-skills/pharo-code-profiling/SKILL.md +19 -38
- package/templates/pharo-skills/pharo-image-sync/SKILL.md +47 -0
- package/templates/pharo-skills/pharo-image-sync/agents/openai.yaml +4 -0
- package/templates/pharo-skills/pharo-mcp-recovery/SKILL.md +1 -1
- package/templates/pharo-skills/pharo-project-load/SKILL.md +2 -1
- package/templates/pharo.AGENTS.md +16 -14
- package/templates/pharo-references/building-on-mcp.md +0 -473
- package/templates/pharo-references/debugging.md +0 -70
- package/templates/pharo-references/getting-started.md +0 -151
- package/templates/pharo-references/pharo-coding-rules.md +0 -147
- package/templates/pharo-references/pharo-coding-style.md +0 -141
- package/templates/pharo-references/safety-and-ecosystem.md +0 -323
- package/templates/pharo-references/source-vs-live-image.md +0 -75
- package/templates/pharo-references/troubleshooting.md +0 -145
- package/templates/pharo-references/using-pharo-mcp.md +0 -86
- package/templates/pharo-skills/pharo-image-git-handoff/SKILL.md +0 -40
- package/templates/pharo-skills/pharo-image-git-handoff/agents/openai.yaml +0 -4
- package/templates/pharo-skills/pharo-version-compat/SKILL.md +0 -54
- package/templates/pharo-skills/pharo-version-compat/agents/openai.yaml +0 -4
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: pharo-version-compat
|
|
3
|
-
description: Use PharoBackwardCompatibility to load and test a project developed on a later Pharo across supported older versions. Use for missing APIs, selectors, packages, notices, or semantics and reusable upstream backports.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Pharo Version Compatibility
|
|
7
|
-
|
|
8
|
-
## Model
|
|
9
|
-
|
|
10
|
-
`PharoBackwardCompatibility` backports later Pharo APIs to older supported
|
|
11
|
-
images. Develop against the newest supported Pharo and let the dependency load
|
|
12
|
-
the packages needed by the current image.
|
|
13
|
-
|
|
14
|
-
It has no source-surface group: load its default baseline.
|
|
15
|
-
|
|
16
|
-
## Workflow
|
|
17
|
-
|
|
18
|
-
1. Read the project baseline, supported-version policy, and CI matrix.
|
|
19
|
-
2. Identify the newest source Pharo version and target runtime versions.
|
|
20
|
-
3. Load PBC from the project baseline:
|
|
21
|
-
|
|
22
|
-
```smalltalk
|
|
23
|
-
spec
|
|
24
|
-
baseline: 'PharoBackwardCompatibility'
|
|
25
|
-
with: [
|
|
26
|
-
spec repository: 'github://jecisc/PharoBackwardCompatibility:v1.x.x/src' ]
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
4. Reproduce on every affected Pharo version and classify the failure: missing
|
|
30
|
-
binding, missing selector, rename, semantic change, notice behavior, or
|
|
31
|
-
native/tooling failure.
|
|
32
|
-
5. Choose the narrowest owner:
|
|
33
|
-
- transparent shim for equivalent APIs;
|
|
34
|
-
- an upstream PharoBackwardCompatibility backport for general APIs;
|
|
35
|
-
- project abstraction for irreducible semantic differences;
|
|
36
|
-
- project-local fix for library-specific behavior.
|
|
37
|
-
6. Verify both PharoBackwardCompatibility and the consuming project across the matrix.
|
|
38
|
-
|
|
39
|
-
## Extending PharoBackwardCompatibility
|
|
40
|
-
|
|
41
|
-
- Confirm the difference is general, originates in a newer Pharo API, and
|
|
42
|
-
affects an older supported runtime.
|
|
43
|
-
- Put runtime code in the matching conditional package and baseline group.
|
|
44
|
-
- Use late lookup for optional globals.
|
|
45
|
-
- Keep backports additive when possible and test the compatibility contract,
|
|
46
|
-
not only package loading.
|
|
47
|
-
|
|
48
|
-
Use `pharo-project-load` for load-path failures and `pharo-ci-repro` for
|
|
49
|
-
smalltalkCI or runner-specific failures.
|
|
50
|
-
|
|
51
|
-
## Report
|
|
52
|
-
|
|
53
|
-
Report source surface, runtimes tested, failure classification, shim owner,
|
|
54
|
-
packages changed, and matrix results.
|