@codyswann/lisa 2.205.0 → 2.205.1
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/package.json +1 -1
- package/plugins/lisa/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa/rules/eager/upstream-to-lisa.md +8 -3
- package/plugins/lisa/rules/reference/upstream-to-lisa.md +15 -4
- package/plugins/lisa-agy/plugin.json +1 -1
- package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk-agy/plugin.json +1 -1
- package/plugins/lisa-cdk-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-copilot/rules/eager/upstream-to-lisa.md +8 -3
- package/plugins/lisa-copilot/rules/reference/upstream-to-lisa.md +15 -4
- package/plugins/lisa-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cursor/rules/upstream-to-lisa-reference.mdc +15 -4
- package/plugins/lisa-cursor/rules/upstream-to-lisa.mdc +8 -3
- package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-expo-agy/plugin.json +1 -1
- package/plugins/lisa-expo-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-agy/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs-agy/plugin.json +1 -1
- package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw-agy/plugin.json +1 -1
- package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser-agy/plugin.json +1 -1
- package/plugins/lisa-phaser-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-rails-agy/plugin.json +1 -1
- package/plugins/lisa-rails-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript-agy/plugin.json +1 -1
- package/plugins/lisa-typescript-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki-agy/plugin.json +1 -1
- package/plugins/lisa-wiki-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/src/base/rules/eager/upstream-to-lisa.md +8 -3
- package/plugins/src/base/rules/reference/upstream-to-lisa.md +15 -4
package/package.json
CHANGED
|
@@ -95,7 +95,7 @@
|
|
|
95
95
|
"ws": ">=8.20.1"
|
|
96
96
|
},
|
|
97
97
|
"name": "@codyswann/lisa",
|
|
98
|
-
"version": "2.205.
|
|
98
|
+
"version": "2.205.1",
|
|
99
99
|
"description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
|
|
100
100
|
"main": "dist/index.js",
|
|
101
101
|
"exports": {
|
|
@@ -1,15 +1,20 @@
|
|
|
1
1
|
# Upstream To Lisa (load-bearing)
|
|
2
2
|
|
|
3
|
-
When working in a project that has Lisa installed, you will sometimes find that the **real fix belongs upstream in Lisa**, not in this project — a bug or gap in a Lisa-distributed template, rule, skill, agent, hook, or CI workflow, or a governance pattern worth generalizing back to the templates.
|
|
3
|
+
When working in a project that has Lisa installed, you will sometimes find that the **real fix belongs upstream in Lisa**, not in this project — a bug or gap in a Lisa-distributed template, rule, skill, agent, hook, or CI workflow, or a governance pattern worth generalizing back to the templates. The defining test: **does the root cause live in a Lisa-distributed artifact?** If yes, file upstream, regardless of whether your local fix survives the next `lisa apply`.
|
|
4
|
+
|
|
5
|
+
Tell-tale signs include:
|
|
6
|
+
|
|
7
|
+
- The file is Lisa-managed (carries Lisa governance markers, or lives in a path Lisa owns) and any edit you make here would be **overwritten on the next `lisa apply`**.
|
|
8
|
+
- The file was created from a Lisa `create-only` template and carries language such as `Lisa will not overwrite it`. That header is a positive upstream signal: existing repos will keep their local copy, but every newly scaffolded repo still inherits the broken template until Lisa is fixed.
|
|
4
9
|
|
|
5
10
|
When that happens, you have **two obligations — do both**:
|
|
6
11
|
|
|
7
|
-
1. **Fix it locally so you are not blocked.** Apply the stopgap in this project so you can keep working.
|
|
12
|
+
1. **Fix it locally so you are not blocked.** Apply the stopgap in this project so you can keep working. For copy-overwrite files, treat the local fix as temporary because it will be clobbered when the upstream fix ships and Lisa re-applies. For create-only files, keep the local fix because Lisa will not overwrite it, but still file upstream so new repos stop inheriting the bug.
|
|
8
13
|
2. **File an upstream issue in the Lisa repository.** Use the `github-write-issue` skill (`lisa-github-write-issue`) to create an issue **in Lisa's source repo `CodySwannGT/lisa`** (pass it as the target repo, e.g. `gh ... --repo CodySwannGT/lisa`) — **not** in this project's own repo. Capture: the root cause, the symptom you hit here, and the proposed durable fix in Lisa's templates/rules/skills.
|
|
9
14
|
|
|
10
15
|
## Do not
|
|
11
16
|
|
|
12
|
-
- Do **not** only fix it locally and move on —
|
|
17
|
+
- Do **not** only fix it locally and move on — even when a create-only local fix survives, the broken template keeps shipping to every new repo until it is fixed upstream.
|
|
13
18
|
- Do **not** try to edit Lisa's templates from inside this project — you are not in the Lisa repo; those edits don't exist upstream and get overwritten.
|
|
14
19
|
- Do **not** file the issue in this project's repo — it must land in `CodySwannGT/lisa`.
|
|
15
20
|
|
|
@@ -9,14 +9,25 @@ You are working in a downstream/host project (not the Lisa source repo) and you
|
|
|
9
9
|
- A bug or gap in a Lisa-distributed **template, rule, skill, agent, hook, or CI workflow**.
|
|
10
10
|
- A **governance pattern** discovered here that should be generalized back into Lisa's templates so every project benefits.
|
|
11
11
|
- Anything where the file you want to change is **Lisa-managed** — it carries Lisa governance markers, lives in a path Lisa owns, or any edit would be **overwritten on the next `lisa apply`**.
|
|
12
|
+
- Anything where the root cause is in a Lisa **create-only** template, even if the generated file says Lisa will not overwrite it.
|
|
12
13
|
|
|
13
|
-
The defining test:
|
|
14
|
+
The defining test: **does the root cause live in a Lisa-distributed artifact?** If yes, file upstream. The wipe-out test is a sufficient signal, not the only signal.
|
|
15
|
+
|
|
16
|
+
| Template class | Local fix survives `lisa apply`? | Why it is still upstream-worthy |
|
|
17
|
+
| --- | --- | --- |
|
|
18
|
+
| **copy-overwrite** (managed) | No — clobbered on next apply | The local fix is throwaway; without the upstream fix it re-breaks. |
|
|
19
|
+
| **create-only** (first setup) | Yes — Lisa never overwrites it | No existing repo self-heals, and every newly scaffolded repo inherits the bug. |
|
|
20
|
+
|
|
21
|
+
For create-only files, header text such as `Lisa will not overwrite it` is a **positive** upstream signal, not a reason to stay local. Keep the downstream fix because Lisa will not replace it, and still file upstream so future projects receive the corrected template.
|
|
14
22
|
|
|
15
23
|
## What to do — both steps, always
|
|
16
24
|
|
|
17
25
|
### 1. Fix it locally so you are not blocked
|
|
18
26
|
|
|
19
|
-
Apply the stopgap in this project so you can keep working. Do **not** stall waiting for an upstream fix to land.
|
|
27
|
+
Apply the stopgap in this project so you can keep working. Do **not** stall waiting for an upstream fix to land.
|
|
28
|
+
|
|
29
|
+
- For copy-overwrite files, treat the local change as temporary: it will be clobbered when the upstream fix ships and Lisa re-applies.
|
|
30
|
+
- For create-only files, keep the local change: Lisa will not overwrite it. The upstream issue is still mandatory because new projects keep inheriting the broken template until Lisa changes.
|
|
20
31
|
|
|
21
32
|
### 2. File an upstream issue in the Lisa repository
|
|
22
33
|
|
|
@@ -27,11 +38,11 @@ The issue should capture, following the skill's three-audience / acceptance-crit
|
|
|
27
38
|
- **Root cause** — which Lisa template/rule/skill/agent/hook/workflow is wrong or missing, with the path under `plugins/src/...` (or the relevant template source) if known.
|
|
28
39
|
- **Symptom** — what broke or was missing in *this* project, and how it surfaced. Reference this project so the fix can be validated against a real case.
|
|
29
40
|
- **Proposed durable fix** — the change to make in Lisa's source so it propagates to all projects on the next apply.
|
|
30
|
-
- **Local stopgap applied** — note that a
|
|
41
|
+
- **Local stopgap applied** — note that a local fix is in place here, whether it is temporary copy-overwrite work or a retained create-only patch.
|
|
31
42
|
|
|
32
43
|
## Do not
|
|
33
44
|
|
|
34
|
-
- Do **not** only fix it locally and move on.
|
|
45
|
+
- Do **not** only fix it locally and move on. For copy-overwrite files, the local fix is throwaway and re-breaks on the next apply. For create-only files, the local fix survives, but the broken template still ships to every new project.
|
|
35
46
|
- Do **not** edit Lisa's templates from inside this project. You are not in the Lisa repo; those edits don't exist upstream and get overwritten — they create the illusion of a fix while the real source stays broken.
|
|
36
47
|
- Do **not** file the issue in this project's own repo. The durable fix is tracked in `CodySwannGT/lisa`.
|
|
37
48
|
|
|
@@ -1,15 +1,20 @@
|
|
|
1
1
|
# Upstream To Lisa (load-bearing)
|
|
2
2
|
|
|
3
|
-
When working in a project that has Lisa installed, you will sometimes find that the **real fix belongs upstream in Lisa**, not in this project — a bug or gap in a Lisa-distributed template, rule, skill, agent, hook, or CI workflow, or a governance pattern worth generalizing back to the templates.
|
|
3
|
+
When working in a project that has Lisa installed, you will sometimes find that the **real fix belongs upstream in Lisa**, not in this project — a bug or gap in a Lisa-distributed template, rule, skill, agent, hook, or CI workflow, or a governance pattern worth generalizing back to the templates. The defining test: **does the root cause live in a Lisa-distributed artifact?** If yes, file upstream, regardless of whether your local fix survives the next `lisa apply`.
|
|
4
|
+
|
|
5
|
+
Tell-tale signs include:
|
|
6
|
+
|
|
7
|
+
- The file is Lisa-managed (carries Lisa governance markers, or lives in a path Lisa owns) and any edit you make here would be **overwritten on the next `lisa apply`**.
|
|
8
|
+
- The file was created from a Lisa `create-only` template and carries language such as `Lisa will not overwrite it`. That header is a positive upstream signal: existing repos will keep their local copy, but every newly scaffolded repo still inherits the broken template until Lisa is fixed.
|
|
4
9
|
|
|
5
10
|
When that happens, you have **two obligations — do both**:
|
|
6
11
|
|
|
7
|
-
1. **Fix it locally so you are not blocked.** Apply the stopgap in this project so you can keep working.
|
|
12
|
+
1. **Fix it locally so you are not blocked.** Apply the stopgap in this project so you can keep working. For copy-overwrite files, treat the local fix as temporary because it will be clobbered when the upstream fix ships and Lisa re-applies. For create-only files, keep the local fix because Lisa will not overwrite it, but still file upstream so new repos stop inheriting the bug.
|
|
8
13
|
2. **File an upstream issue in the Lisa repository.** Use the `github-write-issue` skill (`lisa-github-write-issue`) to create an issue **in Lisa's source repo `CodySwannGT/lisa`** (pass it as the target repo, e.g. `gh ... --repo CodySwannGT/lisa`) — **not** in this project's own repo. Capture: the root cause, the symptom you hit here, and the proposed durable fix in Lisa's templates/rules/skills.
|
|
9
14
|
|
|
10
15
|
## Do not
|
|
11
16
|
|
|
12
|
-
- Do **not** only fix it locally and move on —
|
|
17
|
+
- Do **not** only fix it locally and move on — even when a create-only local fix survives, the broken template keeps shipping to every new repo until it is fixed upstream.
|
|
13
18
|
- Do **not** try to edit Lisa's templates from inside this project — you are not in the Lisa repo; those edits don't exist upstream and get overwritten.
|
|
14
19
|
- Do **not** file the issue in this project's repo — it must land in `CodySwannGT/lisa`.
|
|
15
20
|
|
|
@@ -9,14 +9,25 @@ You are working in a downstream/host project (not the Lisa source repo) and you
|
|
|
9
9
|
- A bug or gap in a Lisa-distributed **template, rule, skill, agent, hook, or CI workflow**.
|
|
10
10
|
- A **governance pattern** discovered here that should be generalized back into Lisa's templates so every project benefits.
|
|
11
11
|
- Anything where the file you want to change is **Lisa-managed** — it carries Lisa governance markers, lives in a path Lisa owns, or any edit would be **overwritten on the next `lisa apply`**.
|
|
12
|
+
- Anything where the root cause is in a Lisa **create-only** template, even if the generated file says Lisa will not overwrite it.
|
|
12
13
|
|
|
13
|
-
The defining test:
|
|
14
|
+
The defining test: **does the root cause live in a Lisa-distributed artifact?** If yes, file upstream. The wipe-out test is a sufficient signal, not the only signal.
|
|
15
|
+
|
|
16
|
+
| Template class | Local fix survives `lisa apply`? | Why it is still upstream-worthy |
|
|
17
|
+
| --- | --- | --- |
|
|
18
|
+
| **copy-overwrite** (managed) | No — clobbered on next apply | The local fix is throwaway; without the upstream fix it re-breaks. |
|
|
19
|
+
| **create-only** (first setup) | Yes — Lisa never overwrites it | No existing repo self-heals, and every newly scaffolded repo inherits the bug. |
|
|
20
|
+
|
|
21
|
+
For create-only files, header text such as `Lisa will not overwrite it` is a **positive** upstream signal, not a reason to stay local. Keep the downstream fix because Lisa will not replace it, and still file upstream so future projects receive the corrected template.
|
|
14
22
|
|
|
15
23
|
## What to do — both steps, always
|
|
16
24
|
|
|
17
25
|
### 1. Fix it locally so you are not blocked
|
|
18
26
|
|
|
19
|
-
Apply the stopgap in this project so you can keep working. Do **not** stall waiting for an upstream fix to land.
|
|
27
|
+
Apply the stopgap in this project so you can keep working. Do **not** stall waiting for an upstream fix to land.
|
|
28
|
+
|
|
29
|
+
- For copy-overwrite files, treat the local change as temporary: it will be clobbered when the upstream fix ships and Lisa re-applies.
|
|
30
|
+
- For create-only files, keep the local change: Lisa will not overwrite it. The upstream issue is still mandatory because new projects keep inheriting the broken template until Lisa changes.
|
|
20
31
|
|
|
21
32
|
### 2. File an upstream issue in the Lisa repository
|
|
22
33
|
|
|
@@ -27,11 +38,11 @@ The issue should capture, following the skill's three-audience / acceptance-crit
|
|
|
27
38
|
- **Root cause** — which Lisa template/rule/skill/agent/hook/workflow is wrong or missing, with the path under `plugins/src/...` (or the relevant template source) if known.
|
|
28
39
|
- **Symptom** — what broke or was missing in *this* project, and how it surfaced. Reference this project so the fix can be validated against a real case.
|
|
29
40
|
- **Proposed durable fix** — the change to make in Lisa's source so it propagates to all projects on the next apply.
|
|
30
|
-
- **Local stopgap applied** — note that a
|
|
41
|
+
- **Local stopgap applied** — note that a local fix is in place here, whether it is temporary copy-overwrite work or a retained create-only patch.
|
|
31
42
|
|
|
32
43
|
## Do not
|
|
33
44
|
|
|
34
|
-
- Do **not** only fix it locally and move on.
|
|
45
|
+
- Do **not** only fix it locally and move on. For copy-overwrite files, the local fix is throwaway and re-breaks on the next apply. For create-only files, the local fix survives, but the broken template still ships to every new project.
|
|
35
46
|
- Do **not** edit Lisa's templates from inside this project. You are not in the Lisa repo; those edits don't exist upstream and get overwritten — they create the illusion of a fix while the real source stays broken.
|
|
36
47
|
- Do **not** file the issue in this project's own repo. The durable fix is tracked in `CodySwannGT/lisa`.
|
|
37
48
|
|
|
@@ -14,14 +14,25 @@ You are working in a downstream/host project (not the Lisa source repo) and you
|
|
|
14
14
|
- A bug or gap in a Lisa-distributed **template, rule, skill, agent, hook, or CI workflow**.
|
|
15
15
|
- A **governance pattern** discovered here that should be generalized back into Lisa's templates so every project benefits.
|
|
16
16
|
- Anything where the file you want to change is **Lisa-managed** — it carries Lisa governance markers, lives in a path Lisa owns, or any edit would be **overwritten on the next `lisa apply`**.
|
|
17
|
+
- Anything where the root cause is in a Lisa **create-only** template, even if the generated file says Lisa will not overwrite it.
|
|
17
18
|
|
|
18
|
-
The defining test:
|
|
19
|
+
The defining test: **does the root cause live in a Lisa-distributed artifact?** If yes, file upstream. The wipe-out test is a sufficient signal, not the only signal.
|
|
20
|
+
|
|
21
|
+
| Template class | Local fix survives `lisa apply`? | Why it is still upstream-worthy |
|
|
22
|
+
| --- | --- | --- |
|
|
23
|
+
| **copy-overwrite** (managed) | No — clobbered on next apply | The local fix is throwaway; without the upstream fix it re-breaks. |
|
|
24
|
+
| **create-only** (first setup) | Yes — Lisa never overwrites it | No existing repo self-heals, and every newly scaffolded repo inherits the bug. |
|
|
25
|
+
|
|
26
|
+
For create-only files, header text such as `Lisa will not overwrite it` is a **positive** upstream signal, not a reason to stay local. Keep the downstream fix because Lisa will not replace it, and still file upstream so future projects receive the corrected template.
|
|
19
27
|
|
|
20
28
|
## What to do — both steps, always
|
|
21
29
|
|
|
22
30
|
### 1. Fix it locally so you are not blocked
|
|
23
31
|
|
|
24
|
-
Apply the stopgap in this project so you can keep working. Do **not** stall waiting for an upstream fix to land.
|
|
32
|
+
Apply the stopgap in this project so you can keep working. Do **not** stall waiting for an upstream fix to land.
|
|
33
|
+
|
|
34
|
+
- For copy-overwrite files, treat the local change as temporary: it will be clobbered when the upstream fix ships and Lisa re-applies.
|
|
35
|
+
- For create-only files, keep the local change: Lisa will not overwrite it. The upstream issue is still mandatory because new projects keep inheriting the broken template until Lisa changes.
|
|
25
36
|
|
|
26
37
|
### 2. File an upstream issue in the Lisa repository
|
|
27
38
|
|
|
@@ -32,11 +43,11 @@ The issue should capture, following the skill's three-audience / acceptance-crit
|
|
|
32
43
|
- **Root cause** — which Lisa template/rule/skill/agent/hook/workflow is wrong or missing, with the path under `plugins/src/...` (or the relevant template source) if known.
|
|
33
44
|
- **Symptom** — what broke or was missing in *this* project, and how it surfaced. Reference this project so the fix can be validated against a real case.
|
|
34
45
|
- **Proposed durable fix** — the change to make in Lisa's source so it propagates to all projects on the next apply.
|
|
35
|
-
- **Local stopgap applied** — note that a
|
|
46
|
+
- **Local stopgap applied** — note that a local fix is in place here, whether it is temporary copy-overwrite work or a retained create-only patch.
|
|
36
47
|
|
|
37
48
|
## Do not
|
|
38
49
|
|
|
39
|
-
- Do **not** only fix it locally and move on.
|
|
50
|
+
- Do **not** only fix it locally and move on. For copy-overwrite files, the local fix is throwaway and re-breaks on the next apply. For create-only files, the local fix survives, but the broken template still ships to every new project.
|
|
40
51
|
- Do **not** edit Lisa's templates from inside this project. You are not in the Lisa repo; those edits don't exist upstream and get overwritten — they create the illusion of a fix while the real source stays broken.
|
|
41
52
|
- Do **not** file the issue in this project's own repo. The durable fix is tracked in `CodySwannGT/lisa`.
|
|
42
53
|
|
|
@@ -5,16 +5,21 @@ alwaysApply: true
|
|
|
5
5
|
|
|
6
6
|
# Upstream To Lisa (load-bearing)
|
|
7
7
|
|
|
8
|
-
When working in a project that has Lisa installed, you will sometimes find that the **real fix belongs upstream in Lisa**, not in this project — a bug or gap in a Lisa-distributed template, rule, skill, agent, hook, or CI workflow, or a governance pattern worth generalizing back to the templates.
|
|
8
|
+
When working in a project that has Lisa installed, you will sometimes find that the **real fix belongs upstream in Lisa**, not in this project — a bug or gap in a Lisa-distributed template, rule, skill, agent, hook, or CI workflow, or a governance pattern worth generalizing back to the templates. The defining test: **does the root cause live in a Lisa-distributed artifact?** If yes, file upstream, regardless of whether your local fix survives the next `lisa apply`.
|
|
9
|
+
|
|
10
|
+
Tell-tale signs include:
|
|
11
|
+
|
|
12
|
+
- The file is Lisa-managed (carries Lisa governance markers, or lives in a path Lisa owns) and any edit you make here would be **overwritten on the next `lisa apply`**.
|
|
13
|
+
- The file was created from a Lisa `create-only` template and carries language such as `Lisa will not overwrite it`. That header is a positive upstream signal: existing repos will keep their local copy, but every newly scaffolded repo still inherits the broken template until Lisa is fixed.
|
|
9
14
|
|
|
10
15
|
When that happens, you have **two obligations — do both**:
|
|
11
16
|
|
|
12
|
-
1. **Fix it locally so you are not blocked.** Apply the stopgap in this project so you can keep working.
|
|
17
|
+
1. **Fix it locally so you are not blocked.** Apply the stopgap in this project so you can keep working. For copy-overwrite files, treat the local fix as temporary because it will be clobbered when the upstream fix ships and Lisa re-applies. For create-only files, keep the local fix because Lisa will not overwrite it, but still file upstream so new repos stop inheriting the bug.
|
|
13
18
|
2. **File an upstream issue in the Lisa repository.** Use the `github-write-issue` skill (`lisa-github-write-issue`) to create an issue **in Lisa's source repo `CodySwannGT/lisa`** (pass it as the target repo, e.g. `gh ... --repo CodySwannGT/lisa`) — **not** in this project's own repo. Capture: the root cause, the symptom you hit here, and the proposed durable fix in Lisa's templates/rules/skills.
|
|
14
19
|
|
|
15
20
|
## Do not
|
|
16
21
|
|
|
17
|
-
- Do **not** only fix it locally and move on —
|
|
22
|
+
- Do **not** only fix it locally and move on — even when a create-only local fix survives, the broken template keeps shipping to every new repo until it is fixed upstream.
|
|
18
23
|
- Do **not** try to edit Lisa's templates from inside this project — you are not in the Lisa repo; those edits don't exist upstream and get overwritten.
|
|
19
24
|
- Do **not** file the issue in this project's repo — it must land in `CodySwannGT/lisa`.
|
|
20
25
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "2.205.
|
|
3
|
+
"version": "2.205.1",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "2.205.
|
|
3
|
+
"version": "2.205.1",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, across Claude and Codex.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "2.205.
|
|
3
|
+
"version": "2.205.1",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "2.205.
|
|
3
|
+
"version": "2.205.1",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "2.205.
|
|
3
|
+
"version": "2.205.1",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,15 +1,20 @@
|
|
|
1
1
|
# Upstream To Lisa (load-bearing)
|
|
2
2
|
|
|
3
|
-
When working in a project that has Lisa installed, you will sometimes find that the **real fix belongs upstream in Lisa**, not in this project — a bug or gap in a Lisa-distributed template, rule, skill, agent, hook, or CI workflow, or a governance pattern worth generalizing back to the templates.
|
|
3
|
+
When working in a project that has Lisa installed, you will sometimes find that the **real fix belongs upstream in Lisa**, not in this project — a bug or gap in a Lisa-distributed template, rule, skill, agent, hook, or CI workflow, or a governance pattern worth generalizing back to the templates. The defining test: **does the root cause live in a Lisa-distributed artifact?** If yes, file upstream, regardless of whether your local fix survives the next `lisa apply`.
|
|
4
|
+
|
|
5
|
+
Tell-tale signs include:
|
|
6
|
+
|
|
7
|
+
- The file is Lisa-managed (carries Lisa governance markers, or lives in a path Lisa owns) and any edit you make here would be **overwritten on the next `lisa apply`**.
|
|
8
|
+
- The file was created from a Lisa `create-only` template and carries language such as `Lisa will not overwrite it`. That header is a positive upstream signal: existing repos will keep their local copy, but every newly scaffolded repo still inherits the broken template until Lisa is fixed.
|
|
4
9
|
|
|
5
10
|
When that happens, you have **two obligations — do both**:
|
|
6
11
|
|
|
7
|
-
1. **Fix it locally so you are not blocked.** Apply the stopgap in this project so you can keep working.
|
|
12
|
+
1. **Fix it locally so you are not blocked.** Apply the stopgap in this project so you can keep working. For copy-overwrite files, treat the local fix as temporary because it will be clobbered when the upstream fix ships and Lisa re-applies. For create-only files, keep the local fix because Lisa will not overwrite it, but still file upstream so new repos stop inheriting the bug.
|
|
8
13
|
2. **File an upstream issue in the Lisa repository.** Use the `github-write-issue` skill (`lisa-github-write-issue`) to create an issue **in Lisa's source repo `CodySwannGT/lisa`** (pass it as the target repo, e.g. `gh ... --repo CodySwannGT/lisa`) — **not** in this project's own repo. Capture: the root cause, the symptom you hit here, and the proposed durable fix in Lisa's templates/rules/skills.
|
|
9
14
|
|
|
10
15
|
## Do not
|
|
11
16
|
|
|
12
|
-
- Do **not** only fix it locally and move on —
|
|
17
|
+
- Do **not** only fix it locally and move on — even when a create-only local fix survives, the broken template keeps shipping to every new repo until it is fixed upstream.
|
|
13
18
|
- Do **not** try to edit Lisa's templates from inside this project — you are not in the Lisa repo; those edits don't exist upstream and get overwritten.
|
|
14
19
|
- Do **not** file the issue in this project's repo — it must land in `CodySwannGT/lisa`.
|
|
15
20
|
|
|
@@ -9,14 +9,25 @@ You are working in a downstream/host project (not the Lisa source repo) and you
|
|
|
9
9
|
- A bug or gap in a Lisa-distributed **template, rule, skill, agent, hook, or CI workflow**.
|
|
10
10
|
- A **governance pattern** discovered here that should be generalized back into Lisa's templates so every project benefits.
|
|
11
11
|
- Anything where the file you want to change is **Lisa-managed** — it carries Lisa governance markers, lives in a path Lisa owns, or any edit would be **overwritten on the next `lisa apply`**.
|
|
12
|
+
- Anything where the root cause is in a Lisa **create-only** template, even if the generated file says Lisa will not overwrite it.
|
|
12
13
|
|
|
13
|
-
The defining test:
|
|
14
|
+
The defining test: **does the root cause live in a Lisa-distributed artifact?** If yes, file upstream. The wipe-out test is a sufficient signal, not the only signal.
|
|
15
|
+
|
|
16
|
+
| Template class | Local fix survives `lisa apply`? | Why it is still upstream-worthy |
|
|
17
|
+
| --- | --- | --- |
|
|
18
|
+
| **copy-overwrite** (managed) | No — clobbered on next apply | The local fix is throwaway; without the upstream fix it re-breaks. |
|
|
19
|
+
| **create-only** (first setup) | Yes — Lisa never overwrites it | No existing repo self-heals, and every newly scaffolded repo inherits the bug. |
|
|
20
|
+
|
|
21
|
+
For create-only files, header text such as `Lisa will not overwrite it` is a **positive** upstream signal, not a reason to stay local. Keep the downstream fix because Lisa will not replace it, and still file upstream so future projects receive the corrected template.
|
|
14
22
|
|
|
15
23
|
## What to do — both steps, always
|
|
16
24
|
|
|
17
25
|
### 1. Fix it locally so you are not blocked
|
|
18
26
|
|
|
19
|
-
Apply the stopgap in this project so you can keep working. Do **not** stall waiting for an upstream fix to land.
|
|
27
|
+
Apply the stopgap in this project so you can keep working. Do **not** stall waiting for an upstream fix to land.
|
|
28
|
+
|
|
29
|
+
- For copy-overwrite files, treat the local change as temporary: it will be clobbered when the upstream fix ships and Lisa re-applies.
|
|
30
|
+
- For create-only files, keep the local change: Lisa will not overwrite it. The upstream issue is still mandatory because new projects keep inheriting the broken template until Lisa changes.
|
|
20
31
|
|
|
21
32
|
### 2. File an upstream issue in the Lisa repository
|
|
22
33
|
|
|
@@ -27,11 +38,11 @@ The issue should capture, following the skill's three-audience / acceptance-crit
|
|
|
27
38
|
- **Root cause** — which Lisa template/rule/skill/agent/hook/workflow is wrong or missing, with the path under `plugins/src/...` (or the relevant template source) if known.
|
|
28
39
|
- **Symptom** — what broke or was missing in *this* project, and how it surfaced. Reference this project so the fix can be validated against a real case.
|
|
29
40
|
- **Proposed durable fix** — the change to make in Lisa's source so it propagates to all projects on the next apply.
|
|
30
|
-
- **Local stopgap applied** — note that a
|
|
41
|
+
- **Local stopgap applied** — note that a local fix is in place here, whether it is temporary copy-overwrite work or a retained create-only patch.
|
|
31
42
|
|
|
32
43
|
## Do not
|
|
33
44
|
|
|
34
|
-
- Do **not** only fix it locally and move on.
|
|
45
|
+
- Do **not** only fix it locally and move on. For copy-overwrite files, the local fix is throwaway and re-breaks on the next apply. For create-only files, the local fix survives, but the broken template still ships to every new project.
|
|
35
46
|
- Do **not** edit Lisa's templates from inside this project. You are not in the Lisa repo; those edits don't exist upstream and get overwritten — they create the illusion of a fix while the real source stays broken.
|
|
36
47
|
- Do **not** file the issue in this project's own repo. The durable fix is tracked in `CodySwannGT/lisa`.
|
|
37
48
|
|