@wpmoo/odoo 0.8.50 → 0.8.52
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 +1 -1
- package/docs/external-resources.md +124 -0
- package/docs/generated-environment-verification.md +38 -0
- package/docs/handoff.md +29 -0
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
|
|
2
2
|
|
|
3
|
-
[](https://github.com/wpmoo-org/wpmoo-odoo/actions/workflows/ci.yml) [](https://github.com/wpmoo-org/wpmoo-odoo) [](https://www.npmjs.com/package/@wpmoo/odoo) [](https://github.com/wpmoo-org/wpmoo-odoo/actions/workflows/ci.yml) [](https://github.com/wpmoo-org/wpmoo-odoo) [](https://www.npmjs.com/package/@wpmoo/odoo) [](https://codecov.io/gh/wpmoo-org/wpmoo-odoo) [](LICENSE) [](https://github.com/wpmoo-org/wpmoo-odoo) [](https://www.buymeacoffee.com/cangir) [](https://www.patreon.com/wpmoo)
|
|
4
4
|
|
|
5
5
|
# WPMoo Odoo
|
|
6
6
|
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
# External Resources
|
|
2
|
+
|
|
3
|
+
WPMoo does not embed large Docker Compose resources or Agent Skill text inside
|
|
4
|
+
the TypeScript CLI. The CLI copies standalone external resources from their own
|
|
5
|
+
repositories/packages into generated environments, while those resources can also
|
|
6
|
+
be used independently.
|
|
7
|
+
|
|
8
|
+
## Repositories/packages
|
|
9
|
+
|
|
10
|
+
```text
|
|
11
|
+
gh:wpmoo-org/odoo-docker-compose
|
|
12
|
+
npm:@wpmoo/odoo-skills
|
|
13
|
+
gh:wpmoo-org/odoo-skills
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Compose resource
|
|
17
|
+
|
|
18
|
+
`wpmoo-org/odoo-docker-compose` uses static version-specific files:
|
|
19
|
+
|
|
20
|
+
```text
|
|
21
|
+
docker-compose_17.0.yml
|
|
22
|
+
docker-compose_18.0.yml
|
|
23
|
+
docker-compose_19.0.yml
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Standalone usage:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
git clone https://github.com/wpmoo-org/odoo-docker-compose
|
|
30
|
+
cd odoo-docker-compose
|
|
31
|
+
cp .env.example .env
|
|
32
|
+
docker compose -f docker-compose_19.0.yml up -d
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
WPMoo CLI usage with the default remote source:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
npx @wpmoo/odoo create \
|
|
39
|
+
--engine compose \
|
|
40
|
+
--product my_product \
|
|
41
|
+
--source-repo-url https://github.com/example-org/my_product.git
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
During resource development, use a local clone:
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
git clone https://github.com/wpmoo-org/odoo-docker-compose ../odoo-docker-compose
|
|
48
|
+
|
|
49
|
+
npx @wpmoo/odoo create \
|
|
50
|
+
--engine compose \
|
|
51
|
+
--compose-template-url ../odoo-docker-compose \
|
|
52
|
+
--product my_product \
|
|
53
|
+
--source-repo-url https://github.com/example-org/my_product.git
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Agent Skills resource
|
|
57
|
+
|
|
58
|
+
`@wpmoo/odoo-skills` is generic and intentionally not project-specific:
|
|
59
|
+
|
|
60
|
+
```text
|
|
61
|
+
skills/odoo-oca/SKILL.md
|
|
62
|
+
skills/odoo-open-core/SKILL.md
|
|
63
|
+
skills/odoo-porting/SKILL.md
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Standalone Pi package usage:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
pi install npm:@wpmoo/odoo-skills
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Standalone npx project-local install:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npx @wpmoo/odoo-skills --target /path/to/project
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
WPMoo CLI can also copy those skills into generated environments from the default
|
|
79
|
+
remote source:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
npx @wpmoo/odoo create \
|
|
83
|
+
--product my_product \
|
|
84
|
+
--source-repo-url https://github.com/example-org/my_product.git \
|
|
85
|
+
--agent-skills-template
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
During skill development, use a local clone:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
git clone https://github.com/wpmoo-org/odoo-skills ../odoo-skills
|
|
92
|
+
|
|
93
|
+
npx @wpmoo/odoo create \
|
|
94
|
+
--product my_product \
|
|
95
|
+
--source-repo-url https://github.com/example-org/my_product.git \
|
|
96
|
+
--agent-skills-template \
|
|
97
|
+
--agent-skills-template-url ../odoo-skills
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
Generated project-local skills are placed under:
|
|
101
|
+
|
|
102
|
+
```text
|
|
103
|
+
.agents/skills/
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
Project or module-specific guidance should live in that project/module's own
|
|
107
|
+
`AGENTS.md` or custom skill files.
|
|
108
|
+
|
|
109
|
+
## References and pins
|
|
110
|
+
|
|
111
|
+
Remote Git sources can be pinned with refs:
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
npx @wpmoo/odoo create \
|
|
115
|
+
--engine compose \
|
|
116
|
+
--compose-template-ref v0.1.0 \
|
|
117
|
+
--agent-skills-template \
|
|
118
|
+
--agent-skills-template-ref v0.1.0 \
|
|
119
|
+
--product my_product \
|
|
120
|
+
--source-repo-url https://github.com/example-org/my_product.git
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
The CLI supports local directories and Git-style resource sources such as
|
|
124
|
+
`gh:owner/repo`, HTTPS Git URLs, and SSH Git URLs.
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Generated Environment Verification
|
|
2
|
+
|
|
3
|
+
## Scope
|
|
4
|
+
|
|
5
|
+
This matrix covers disposable generated development environments only. It is for
|
|
6
|
+
local and CI verification of generated artifacts and command behavior. It does
|
|
7
|
+
not validate staging or production deployments.
|
|
8
|
+
|
|
9
|
+
## Command split
|
|
10
|
+
|
|
11
|
+
- Use `npx @wpmoo/odoo ...` for package/operator commands (`create`,
|
|
12
|
+
`add-repo`, `remove-repo`, `add-module`, `remove-module`, `doctor`, `reset`).
|
|
13
|
+
- Use `./moo ...` inside a generated environment for daily local compose
|
|
14
|
+
actions delegated to `./scripts/*.sh`.
|
|
15
|
+
|
|
16
|
+
## Verification matrix
|
|
17
|
+
|
|
18
|
+
| Area | Contract | Primary command(s) |
|
|
19
|
+
| --- | --- | --- |
|
|
20
|
+
| Scaffold files and metadata | Generated environment includes expected files and `.wpmoo/odoo.json` metadata. | `npx @wpmoo/odoo create ...` |
|
|
21
|
+
| Compose resource files | Required compose/version files, compose docs, and script set are present. | `npx @wpmoo/odoo create ...` |
|
|
22
|
+
| `./moo` delegation | `./moo` dispatches fixed daily actions to the matching script and preserves argument pass-through. | `./moo <action> ...` |
|
|
23
|
+
| Doctor checks | Metadata, compose files, scripts, source repo paths, and local tooling checks behave as expected. | `npx @wpmoo/odoo doctor` or `./moo doctor` |
|
|
24
|
+
| Source repo add/remove | Source repository registration and submodule lifecycle behave correctly. | `npx @wpmoo/odoo add-repo ...`, `npx @wpmoo/odoo remove-repo ...` |
|
|
25
|
+
| Module add/remove | Module registration changes are applied to the selected source repo config. | `npx @wpmoo/odoo add-module ...`, `npx @wpmoo/odoo remove-module ...` |
|
|
26
|
+
| Safe reset | Generated files are refreshed without deleting source module code. | `npx @wpmoo/odoo reset` |
|
|
27
|
+
| Snapshot/restore and lint/pot | These actions are delegated by `./moo` to compose scripts without extra package-side logic. | `./moo snapshot ...`, `./moo restore-snapshot ...`, `./moo lint`, `./moo pot ...` |
|
|
28
|
+
|
|
29
|
+
## Local verification commands
|
|
30
|
+
|
|
31
|
+
Run from the `wpmoo-odoo` repository root:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
npm run typecheck
|
|
35
|
+
npm test
|
|
36
|
+
npm run test:coverage
|
|
37
|
+
npm run build
|
|
38
|
+
```
|
package/docs/handoff.md
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Historical Handoff Notes
|
|
2
|
+
|
|
3
|
+
This file is an archive pointer for pre-0.8.37 handoff notes. Those notes
|
|
4
|
+
included a stale direct publish attempt and must not be used as current release
|
|
5
|
+
guidance.
|
|
6
|
+
|
|
7
|
+
Current release path:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm run release:check
|
|
11
|
+
npm run typecheck
|
|
12
|
+
npm test
|
|
13
|
+
npm run build
|
|
14
|
+
VERSION="$(node -p "require('./package.json').version")"
|
|
15
|
+
git tag -a "v$VERSION" -m "Release v$VERSION"
|
|
16
|
+
git push origin "v$VERSION"
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
If `npm run release:check` bumps `package.json` and `package-lock.json`, commit
|
|
20
|
+
and push that version bump first, then rerun the release check before tagging.
|
|
21
|
+
|
|
22
|
+
Publishing is handled by the `Publish` GitHub Actions workflow through npm
|
|
23
|
+
Trusted Publishing after the tag is pushed. Do not run `npm publish` manually
|
|
24
|
+
unless a coordinator explicitly requests a fallback.
|
|
25
|
+
|
|
26
|
+
Current command standard:
|
|
27
|
+
|
|
28
|
+
- Use `npx @wpmoo/odoo ...` for package/operator commands.
|
|
29
|
+
- Use generated environment `./moo ...` for local compose daily commands.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wpmoo/odoo",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.52",
|
|
4
4
|
"description": "WPMoo Odoo lifecycle tooling for development, staging, and production workflows.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"repository": {
|
|
@@ -31,7 +31,8 @@
|
|
|
31
31
|
},
|
|
32
32
|
"files": [
|
|
33
33
|
"dist",
|
|
34
|
-
"docs/assets"
|
|
34
|
+
"docs/assets",
|
|
35
|
+
"docs/*.md"
|
|
35
36
|
],
|
|
36
37
|
"engines": {
|
|
37
38
|
"node": ">=20.17"
|