@codyswann/lisa 4.55.10 → 4.55.12

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 (82) hide show
  1. package/dist/codex/scripts/install-pkgs.sh +1 -1
  2. package/dist/core/nightly-e2e-guard-behavior-certificate.js +2 -2
  3. package/dist/core/upstream-evidence-manifest.d.ts.map +1 -1
  4. package/dist/core/upstream-evidence-manifest.js +15 -5
  5. package/dist/core/upstream-evidence-manifest.js.map +1 -1
  6. package/dist/utils/package-manager-detect.d.ts +2 -2
  7. package/dist/utils/package-manager-detect.js +2 -2
  8. package/package.json +4 -4
  9. package/plugins/lisa/.claude-plugin/plugin.json +1 -1
  10. package/plugins/lisa/.codex-plugin/plugin.json +1 -1
  11. package/plugins/lisa/.codex-plugin/skills/lisa-generate-claude-remote-build-script/SKILL.md +1 -1
  12. package/plugins/lisa/hooks/install-pkgs.sh +1 -1
  13. package/plugins/lisa/rules/eager/00-rule-index.md +1 -0
  14. package/plugins/lisa/rules/eager/never-name-a-downstream-project.md +9 -0
  15. package/plugins/lisa/rules/reference/never-name-a-downstream-project.md +37 -0
  16. package/plugins/lisa/skills/lisa-generate-claude-remote-build-script/SKILL.md +1 -1
  17. package/plugins/lisa-agy/plugin.json +1 -1
  18. package/plugins/lisa-agy/skills/lisa-generate-claude-remote-build-script/SKILL.md +1 -1
  19. package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
  20. package/plugins/lisa-cdk/.codex-plugin/plugin.json +1 -1
  21. package/plugins/lisa-cdk-agy/plugin.json +1 -1
  22. package/plugins/lisa-cdk-copilot/.claude-plugin/plugin.json +1 -1
  23. package/plugins/lisa-cdk-cursor/.claude-plugin/plugin.json +1 -1
  24. package/plugins/lisa-copilot/.claude-plugin/plugin.json +1 -1
  25. package/plugins/lisa-copilot/hooks/install-pkgs.sh +1 -1
  26. package/plugins/lisa-copilot/rules/eager/00-rule-index.md +1 -0
  27. package/plugins/lisa-copilot/rules/eager/never-name-a-downstream-project.md +9 -0
  28. package/plugins/lisa-copilot/rules/reference/never-name-a-downstream-project.md +37 -0
  29. package/plugins/lisa-copilot/skills/lisa-generate-claude-remote-build-script/SKILL.md +1 -1
  30. package/plugins/lisa-cursor/.claude-plugin/plugin.json +1 -1
  31. package/plugins/lisa-cursor/hooks/install-pkgs.sh +1 -1
  32. package/plugins/lisa-cursor/rules/00-rule-index.mdc +1 -0
  33. package/plugins/lisa-cursor/rules/never-name-a-downstream-project-reference.mdc +42 -0
  34. package/plugins/lisa-cursor/rules/never-name-a-downstream-project.mdc +14 -0
  35. package/plugins/lisa-cursor/skills/lisa-generate-claude-remote-build-script/SKILL.md +1 -1
  36. package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
  37. package/plugins/lisa-expo/.codex-plugin/plugin.json +1 -1
  38. package/plugins/lisa-expo-agy/plugin.json +1 -1
  39. package/plugins/lisa-expo-copilot/.claude-plugin/plugin.json +1 -1
  40. package/plugins/lisa-expo-cursor/.claude-plugin/plugin.json +1 -1
  41. package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json +1 -1
  42. package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json +1 -1
  43. package/plugins/lisa-harper-fabric-agy/plugin.json +1 -1
  44. package/plugins/lisa-harper-fabric-copilot/.claude-plugin/plugin.json +1 -1
  45. package/plugins/lisa-harper-fabric-cursor/.claude-plugin/plugin.json +1 -1
  46. package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
  47. package/plugins/lisa-nestjs/.codex-plugin/plugin.json +1 -1
  48. package/plugins/lisa-nestjs-agy/plugin.json +1 -1
  49. package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json +1 -1
  50. package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json +1 -1
  51. package/plugins/lisa-openclaw/.claude-plugin/plugin.json +1 -1
  52. package/plugins/lisa-openclaw/.codex-plugin/plugin.json +1 -1
  53. package/plugins/lisa-openclaw-agy/plugin.json +1 -1
  54. package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json +1 -1
  55. package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json +1 -1
  56. package/plugins/lisa-phaser/.claude-plugin/plugin.json +1 -1
  57. package/plugins/lisa-phaser/.codex-plugin/plugin.json +1 -1
  58. package/plugins/lisa-phaser-agy/plugin.json +1 -1
  59. package/plugins/lisa-phaser-copilot/.claude-plugin/plugin.json +1 -1
  60. package/plugins/lisa-phaser-cursor/.claude-plugin/plugin.json +1 -1
  61. package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
  62. package/plugins/lisa-rails/.codex-plugin/plugin.json +1 -1
  63. package/plugins/lisa-rails-agy/plugin.json +1 -1
  64. package/plugins/lisa-rails-copilot/.claude-plugin/plugin.json +1 -1
  65. package/plugins/lisa-rails-cursor/.claude-plugin/plugin.json +1 -1
  66. package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
  67. package/plugins/lisa-typescript/.codex-plugin/plugin.json +1 -1
  68. package/plugins/lisa-typescript-agy/plugin.json +1 -1
  69. package/plugins/lisa-typescript-copilot/.claude-plugin/plugin.json +1 -1
  70. package/plugins/lisa-typescript-cursor/.claude-plugin/plugin.json +1 -1
  71. package/plugins/lisa-wiki/.claude-plugin/plugin.json +1 -1
  72. package/plugins/lisa-wiki/.codex-plugin/plugin.json +1 -1
  73. package/plugins/lisa-wiki-agy/plugin.json +1 -1
  74. package/plugins/lisa-wiki-copilot/.claude-plugin/plugin.json +1 -1
  75. package/plugins/lisa-wiki-cursor/.claude-plugin/plugin.json +1 -1
  76. package/plugins/src/base/hooks/install-pkgs.sh +1 -1
  77. package/plugins/src/base/rules/eager/00-rule-index.md +1 -0
  78. package/plugins/src/base/rules/eager/never-name-a-downstream-project.md +9 -0
  79. package/plugins/src/base/rules/reference/never-name-a-downstream-project.md +37 -0
  80. package/plugins/src/base/skills/lisa-generate-claude-remote-build-script/SKILL.md +1 -1
  81. package/scripts/claude-remote-setup.sh +1 -1
  82. package/typescript/copy-contents/.husky/pre-push +1 -1
@@ -34,7 +34,7 @@ export declare const LOCKFILE_REGEN_PLANS: Readonly<Record<PackageManager, Lockf
34
34
  * npm-only project sets `engines.bun = "please-use-npm"`). Such a manager must
35
35
  * never have its lockfile regenerated — even if a stray lockfile for it is
36
36
  * present — because doing so re-creates the stray lockfile via that manager's
37
- * `install`. That is the SE-5221 regression: a stray `bun.lock` in an npm-only
37
+ * `install`. That is the package-manager selection regression: a stray `bun.lock` in an npm-only
38
38
  * project kept alive by `bun install`, which then misroutes the pre-push hook's
39
39
  * package-manager detection to the bun branch.
40
40
  * @param projectDir - Absolute path to the project directory
@@ -52,7 +52,7 @@ export declare function enginesForbiddenManagers(projectDir: string): ReadonlySe
52
52
  *
53
53
  * Managers opted out via an `engines` sentinel (e.g. `bun = "please-use-npm"`)
54
54
  * are dropped even when their lockfile is present, so the reconciliation never
55
- * re-creates a stray lockfile the project deliberately disallows (SE-5221).
55
+ * re-creates a stray lockfile the project deliberately disallows.
56
56
  * @param projectDir - Absolute path to the project directory
57
57
  * @returns Ordered list of detected package managers (possibly empty)
58
58
  */
@@ -55,7 +55,7 @@ export const LOCKFILE_REGEN_PLANS = {
55
55
  * npm-only project sets `engines.bun = "please-use-npm"`). Such a manager must
56
56
  * never have its lockfile regenerated — even if a stray lockfile for it is
57
57
  * present — because doing so re-creates the stray lockfile via that manager's
58
- * `install`. That is the SE-5221 regression: a stray `bun.lock` in an npm-only
58
+ * `install`. That is the package-manager selection regression: a stray `bun.lock` in an npm-only
59
59
  * project kept alive by `bun install`, which then misroutes the pre-push hook's
60
60
  * package-manager detection to the bun branch.
61
61
  * @param projectDir - Absolute path to the project directory
@@ -87,7 +87,7 @@ export function enginesForbiddenManagers(projectDir) {
87
87
  *
88
88
  * Managers opted out via an `engines` sentinel (e.g. `bun = "please-use-npm"`)
89
89
  * are dropped even when their lockfile is present, so the reconciliation never
90
- * re-creates a stray lockfile the project deliberately disallows (SE-5221).
90
+ * re-creates a stray lockfile the project deliberately disallows.
91
91
  * @param projectDir - Absolute path to the project directory
92
92
  * @returns Ordered list of detected package managers (possibly empty)
93
93
  */
package/package.json CHANGED
@@ -187,7 +187,7 @@
187
187
  "zod-validation-error": "^4.0.0"
188
188
  },
189
189
  "name": "@codyswann/lisa",
190
- "version": "4.55.10",
190
+ "version": "4.55.12",
191
191
  "description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
192
192
  "main": "dist/index.js",
193
193
  "exports": {
@@ -336,7 +336,7 @@
336
336
  "test": "tests"
337
337
  },
338
338
  "types": "./dist/index.d.ts",
339
- "lisaReleaseCommit": "bbf92dbe112ba3ed753ae43cde2691f1de3c772c",
340
- "gitHead": "bbf92dbe112ba3ed753ae43cde2691f1de3c772c",
341
- "lisaReleaseTag": "v4.55.10"
339
+ "lisaReleaseCommit": "89b58b2d263fe97a8579fc54500ba188243824d3",
340
+ "gitHead": "89b58b2d263fe97a8579fc54500ba188243824d3",
341
+ "lisaReleaseTag": "v4.55.12"
342
342
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Universal governance: agents, skills, commands, hooks, and rules for all projects.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -169,7 +169,7 @@ require() { need "$1" || { echo "FATAL: required tool '$1' missing and install f
169
169
  # Resolve the PM from packageManager/engines/lockfiles — emit the manager the
170
170
  # `packageManager` inventory field reported, NEVER a hardcoded bun. An npm-only
171
171
  # project (engines.bun = "please-use-npm") must install with npm; emitting
172
- # `bun install` would create a stray bun.lock and break it (the SE-5221
172
+ # `bun install` would create a stray bun.lock and break it (the package-manager selection
173
173
  # regression). Only install/PATH-export the manager actually selected below.
174
174
  detect_package_manager() {
175
175
  _field="" _forced="" _forbidden=""
@@ -53,7 +53,7 @@ fi
53
53
  # This must NOT key on lockfile presence alone. An npm-only project
54
54
  # (engines.bun = "please-use-npm", CI runs `npm ci`) that picks up a stray
55
55
  # bun.lock would otherwise get `bun install`, re-create the bun.lock, and break
56
- # — the SE-5221 regression. The engines/packageManager signals are
56
+ # — the package-manager selection regression. The engines/packageManager signals are
57
57
  # authoritative; lockfiles are only a fallback and never override an opt-out.
58
58
  detect_package_manager() {
59
59
  _field="" _forced="" _forbidden=""
@@ -76,6 +76,7 @@ Paths are relative to this file.
76
76
  | `documentation-source-paths` | moving, absorbing, or deleting a docs-like directory | [../reference/documentation-source-paths.md](../reference/documentation-source-paths.md) |
77
77
  | `project-learnings` | you need the learnings ledger's entry schema and field semantics | [../reference/project-learnings.md](../reference/project-learnings.md) |
78
78
  | `factory-model` | you need the shape of the factory model, not its obligations | [../reference/factory-model.md](../reference/factory-model.md) |
79
+ | `never-name-a-downstream-project` | you are about to refer to a downstream project in writing | [../reference/never-name-a-downstream-project.md](../reference/never-name-a-downstream-project.md) |
79
80
 
80
81
  The obligations that follow from `factory-model` are in `base-rules`, which is
81
82
  eager. This entry is the exposition behind them.
@@ -0,0 +1,9 @@
1
+ # Never Name a Downstream Project
2
+
3
+ Refer to a downstream project by its **role in the argument** — never by organization, product, or repository name — in tracker items, pull requests, commits, rules, skills, anything that outlives the session.
4
+
5
+ Write the evidence, not the identity: "a caller repo", "repo A" / "repo B" when two are contrasted.
6
+
7
+ Default-deny: it covers names nobody listed. `block-host-name-leak` catches some of them and is a rate reduction, never a proof.
8
+
9
+ Full prose: [reference/never-name-a-downstream-project.md](../reference/never-name-a-downstream-project.md).
@@ -0,0 +1,37 @@
1
+ # Never Name a Downstream Project
2
+
3
+ ## The rule
4
+
5
+ A downstream project's identity — its organization, product, or repository name — does not belong in anything that outlives the session it was written in: tracker items (titles, descriptions, comments), pull request titles and bodies, commit messages, wiki and ingested sources, and the text of rules and skills.
6
+
7
+ ## Why the identity is never the point
8
+
9
+ An observation earns its place by being reproducible, not by its provenance. "A caller repo pinned all 64 of its call sites" and the same sentence with a name carry exactly the same engineering weight — the second just adds an obligation for whoever reads it later.
10
+
11
+ Where an argument appears to need the name, that is a signal the argument is under-specified. The fix is to state the condition that made it true — the version, the config, the shape of the tree — not to identify the place it was observed.
12
+
13
+ ## How to write it instead
14
+
15
+ | situation | write |
16
+ |---|---|
17
+ | one project | "a caller repo", "a downstream project", "the reference repository" |
18
+ | two contrasted | "repo A" / "repo B" |
19
+ | several that must stay distinct in one sentence | `<project-1>`, `<project-2>` |
20
+ | a real identifier | `<ticket>` |
21
+
22
+ Rewrite the prose rather than substituting tokens wherever a placeholder reads badly: "follow `<name>`'s serverless pattern" becomes "follow the reference serverless pattern", not "follow `<project-1>`'s serverless pattern".
23
+
24
+ ## Enforcement is partial, and must not be relied on
25
+
26
+ `block-host-name-leak` compares against a **curated denylist** and inspects **Bash tool calls only**. If the detector cannot be loaded, the hook warns and permits the write without inspecting the text. These limits follow:
27
+
28
+ - a name nobody has added to the list is invisible to it;
29
+ - a write issued by a script that reads its own body — rather than by a CLI given a `--body-file` — never reaches it at all.
30
+
31
+ When the detector is available, a clean run means "no listed name appeared", never "this text is safe". When it is unavailable, no inspection occurred. This rule is default-deny and holds independently of whether the guard fires.
32
+
33
+ Note also that the denylist cannot be the primary control: this repository is public and `dist/` ships to npm, so the entries most worth catching are the ones least safe to enumerate there.
34
+
35
+ ## Prior reference is not licence
36
+
37
+ An existing ticket, brief, or ingested source that already carries a name does not authorise repeating it, and inherited text is the most common way such names spread — ingestion carries them forward, and each new document that quotes the last one multiplies them. When you meet one, replace it in what you are writing; do not propagate it because it was already there.
@@ -169,7 +169,7 @@ require() { need "$1" || { echo "FATAL: required tool '$1' missing and install f
169
169
  # Resolve the PM from packageManager/engines/lockfiles — emit the manager the
170
170
  # `packageManager` inventory field reported, NEVER a hardcoded bun. An npm-only
171
171
  # project (engines.bun = "please-use-npm") must install with npm; emitting
172
- # `bun install` would create a stray bun.lock and break it (the SE-5221
172
+ # `bun install` would create a stray bun.lock and break it (the package-manager selection
173
173
  # regression). Only install/PATH-export the manager actually selected below.
174
174
  detect_package_manager() {
175
175
  _field="" _forced="" _forbidden=""
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -169,7 +169,7 @@ require() { need "$1" || { echo "FATAL: required tool '$1' missing and install f
169
169
  # Resolve the PM from packageManager/engines/lockfiles — emit the manager the
170
170
  # `packageManager` inventory field reported, NEVER a hardcoded bun. An npm-only
171
171
  # project (engines.bun = "please-use-npm") must install with npm; emitting
172
- # `bun install` would create a stray bun.lock and break it (the SE-5221
172
+ # `bun install` would create a stray bun.lock and break it (the package-manager selection
173
173
  # regression). Only install/PATH-export the manager actually selected below.
174
174
  detect_package_manager() {
175
175
  _field="" _forced="" _forbidden=""
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-cdk",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "AWS CDK-specific plugin",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-cdk",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "AWS CDK-specific Lisa plugin.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-cdk",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "AWS CDK-specific plugin",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-cdk",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "AWS CDK-specific plugin",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-cdk",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "AWS CDK-specific plugin",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -53,7 +53,7 @@ fi
53
53
  # This must NOT key on lockfile presence alone. An npm-only project
54
54
  # (engines.bun = "please-use-npm", CI runs `npm ci`) that picks up a stray
55
55
  # bun.lock would otherwise get `bun install`, re-create the bun.lock, and break
56
- # — the SE-5221 regression. The engines/packageManager signals are
56
+ # — the package-manager selection regression. The engines/packageManager signals are
57
57
  # authoritative; lockfiles are only a fallback and never override an opt-out.
58
58
  detect_package_manager() {
59
59
  _field="" _forced="" _forbidden=""
@@ -76,6 +76,7 @@ Paths are relative to this file.
76
76
  | `documentation-source-paths` | moving, absorbing, or deleting a docs-like directory | [../reference/documentation-source-paths.md](../reference/documentation-source-paths.md) |
77
77
  | `project-learnings` | you need the learnings ledger's entry schema and field semantics | [../reference/project-learnings.md](../reference/project-learnings.md) |
78
78
  | `factory-model` | you need the shape of the factory model, not its obligations | [../reference/factory-model.md](../reference/factory-model.md) |
79
+ | `never-name-a-downstream-project` | you are about to refer to a downstream project in writing | [../reference/never-name-a-downstream-project.md](../reference/never-name-a-downstream-project.md) |
79
80
 
80
81
  The obligations that follow from `factory-model` are in `base-rules`, which is
81
82
  eager. This entry is the exposition behind them.
@@ -0,0 +1,9 @@
1
+ # Never Name a Downstream Project
2
+
3
+ Refer to a downstream project by its **role in the argument** — never by organization, product, or repository name — in tracker items, pull requests, commits, rules, skills, anything that outlives the session.
4
+
5
+ Write the evidence, not the identity: "a caller repo", "repo A" / "repo B" when two are contrasted.
6
+
7
+ Default-deny: it covers names nobody listed. `block-host-name-leak` catches some of them and is a rate reduction, never a proof.
8
+
9
+ Full prose: [reference/never-name-a-downstream-project.md](../reference/never-name-a-downstream-project.md).
@@ -0,0 +1,37 @@
1
+ # Never Name a Downstream Project
2
+
3
+ ## The rule
4
+
5
+ A downstream project's identity — its organization, product, or repository name — does not belong in anything that outlives the session it was written in: tracker items (titles, descriptions, comments), pull request titles and bodies, commit messages, wiki and ingested sources, and the text of rules and skills.
6
+
7
+ ## Why the identity is never the point
8
+
9
+ An observation earns its place by being reproducible, not by its provenance. "A caller repo pinned all 64 of its call sites" and the same sentence with a name carry exactly the same engineering weight — the second just adds an obligation for whoever reads it later.
10
+
11
+ Where an argument appears to need the name, that is a signal the argument is under-specified. The fix is to state the condition that made it true — the version, the config, the shape of the tree — not to identify the place it was observed.
12
+
13
+ ## How to write it instead
14
+
15
+ | situation | write |
16
+ |---|---|
17
+ | one project | "a caller repo", "a downstream project", "the reference repository" |
18
+ | two contrasted | "repo A" / "repo B" |
19
+ | several that must stay distinct in one sentence | `<project-1>`, `<project-2>` |
20
+ | a real identifier | `<ticket>` |
21
+
22
+ Rewrite the prose rather than substituting tokens wherever a placeholder reads badly: "follow `<name>`'s serverless pattern" becomes "follow the reference serverless pattern", not "follow `<project-1>`'s serverless pattern".
23
+
24
+ ## Enforcement is partial, and must not be relied on
25
+
26
+ `block-host-name-leak` compares against a **curated denylist** and inspects **Bash tool calls only**. If the detector cannot be loaded, the hook warns and permits the write without inspecting the text. These limits follow:
27
+
28
+ - a name nobody has added to the list is invisible to it;
29
+ - a write issued by a script that reads its own body — rather than by a CLI given a `--body-file` — never reaches it at all.
30
+
31
+ When the detector is available, a clean run means "no listed name appeared", never "this text is safe". When it is unavailable, no inspection occurred. This rule is default-deny and holds independently of whether the guard fires.
32
+
33
+ Note also that the denylist cannot be the primary control: this repository is public and `dist/` ships to npm, so the entries most worth catching are the ones least safe to enumerate there.
34
+
35
+ ## Prior reference is not licence
36
+
37
+ An existing ticket, brief, or ingested source that already carries a name does not authorise repeating it, and inherited text is the most common way such names spread — ingestion carries them forward, and each new document that quotes the last one multiplies them. When you meet one, replace it in what you are writing; do not propagate it because it was already there.
@@ -169,7 +169,7 @@ require() { need "$1" || { echo "FATAL: required tool '$1' missing and install f
169
169
  # Resolve the PM from packageManager/engines/lockfiles — emit the manager the
170
170
  # `packageManager` inventory field reported, NEVER a hardcoded bun. An npm-only
171
171
  # project (engines.bun = "please-use-npm") must install with npm; emitting
172
- # `bun install` would create a stray bun.lock and break it (the SE-5221
172
+ # `bun install` would create a stray bun.lock and break it (the package-manager selection
173
173
  # regression). Only install/PATH-export the manager actually selected below.
174
174
  detect_package_manager() {
175
175
  _field="" _forced="" _forbidden=""
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -53,7 +53,7 @@ fi
53
53
  # This must NOT key on lockfile presence alone. An npm-only project
54
54
  # (engines.bun = "please-use-npm", CI runs `npm ci`) that picks up a stray
55
55
  # bun.lock would otherwise get `bun install`, re-create the bun.lock, and break
56
- # — the SE-5221 regression. The engines/packageManager signals are
56
+ # — the package-manager selection regression. The engines/packageManager signals are
57
57
  # authoritative; lockfiles are only a fallback and never override an opt-out.
58
58
  detect_package_manager() {
59
59
  _field="" _forced="" _forbidden=""
@@ -81,6 +81,7 @@ Paths are relative to this file.
81
81
  | `documentation-source-paths` | moving, absorbing, or deleting a docs-like directory | [../reference/documentation-source-paths.md](documentation-source-paths-reference.mdc) |
82
82
  | `project-learnings` | you need the learnings ledger's entry schema and field semantics | [../reference/project-learnings.md](project-learnings-reference.mdc) |
83
83
  | `factory-model` | you need the shape of the factory model, not its obligations | [../reference/factory-model.md](factory-model-reference.mdc) |
84
+ | `never-name-a-downstream-project` | you are about to refer to a downstream project in writing | [../reference/never-name-a-downstream-project.md](never-name-a-downstream-project-reference.mdc) |
84
85
 
85
86
  The obligations that follow from `factory-model` are in `base-rules`, which is
86
87
  eager. This entry is the exposition behind them.
@@ -0,0 +1,42 @@
1
+ ---
2
+ description: "Never Name a Downstream Project"
3
+ alwaysApply: false
4
+ ---
5
+
6
+ # Never Name a Downstream Project
7
+
8
+ ## The rule
9
+
10
+ A downstream project's identity — its organization, product, or repository name — does not belong in anything that outlives the session it was written in: tracker items (titles, descriptions, comments), pull request titles and bodies, commit messages, wiki and ingested sources, and the text of rules and skills.
11
+
12
+ ## Why the identity is never the point
13
+
14
+ An observation earns its place by being reproducible, not by its provenance. "A caller repo pinned all 64 of its call sites" and the same sentence with a name carry exactly the same engineering weight — the second just adds an obligation for whoever reads it later.
15
+
16
+ Where an argument appears to need the name, that is a signal the argument is under-specified. The fix is to state the condition that made it true — the version, the config, the shape of the tree — not to identify the place it was observed.
17
+
18
+ ## How to write it instead
19
+
20
+ | situation | write |
21
+ |---|---|
22
+ | one project | "a caller repo", "a downstream project", "the reference repository" |
23
+ | two contrasted | "repo A" / "repo B" |
24
+ | several that must stay distinct in one sentence | `<project-1>`, `<project-2>` |
25
+ | a real identifier | `<ticket>` |
26
+
27
+ Rewrite the prose rather than substituting tokens wherever a placeholder reads badly: "follow `<name>`'s serverless pattern" becomes "follow the reference serverless pattern", not "follow `<project-1>`'s serverless pattern".
28
+
29
+ ## Enforcement is partial, and must not be relied on
30
+
31
+ `block-host-name-leak` compares against a **curated denylist** and inspects **Bash tool calls only**. If the detector cannot be loaded, the hook warns and permits the write without inspecting the text. These limits follow:
32
+
33
+ - a name nobody has added to the list is invisible to it;
34
+ - a write issued by a script that reads its own body — rather than by a CLI given a `--body-file` — never reaches it at all.
35
+
36
+ When the detector is available, a clean run means "no listed name appeared", never "this text is safe". When it is unavailable, no inspection occurred. This rule is default-deny and holds independently of whether the guard fires.
37
+
38
+ Note also that the denylist cannot be the primary control: this repository is public and `dist/` ships to npm, so the entries most worth catching are the ones least safe to enumerate there.
39
+
40
+ ## Prior reference is not licence
41
+
42
+ An existing ticket, brief, or ingested source that already carries a name does not authorise repeating it, and inherited text is the most common way such names spread — ingestion carries them forward, and each new document that quotes the last one multiplies them. When you meet one, replace it in what you are writing; do not propagate it because it was already there.
@@ -0,0 +1,14 @@
1
+ ---
2
+ description: "Never Name a Downstream Project"
3
+ alwaysApply: true
4
+ ---
5
+
6
+ # Never Name a Downstream Project
7
+
8
+ Refer to a downstream project by its **role in the argument** — never by organization, product, or repository name — in tracker items, pull requests, commits, rules, skills, anything that outlives the session.
9
+
10
+ Write the evidence, not the identity: "a caller repo", "repo A" / "repo B" when two are contrasted.
11
+
12
+ Default-deny: it covers names nobody listed. `block-host-name-leak` catches some of them and is a rate reduction, never a proof.
13
+
14
+ Full prose: [reference/never-name-a-downstream-project.md](never-name-a-downstream-project-reference.mdc).
@@ -169,7 +169,7 @@ require() { need "$1" || { echo "FATAL: required tool '$1' missing and install f
169
169
  # Resolve the PM from packageManager/engines/lockfiles — emit the manager the
170
170
  # `packageManager` inventory field reported, NEVER a hardcoded bun. An npm-only
171
171
  # project (engines.bun = "please-use-npm") must install with npm; emitting
172
- # `bun install` would create a stray bun.lock and break it (the SE-5221
172
+ # `bun install` would create a stray bun.lock and break it (the package-manager selection
173
173
  # regression). Only install/PATH-export the manager actually selected below.
174
174
  detect_package_manager() {
175
175
  _field="" _forced="" _forbidden=""
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Expo and React Native-specific skills, agents, rules, and MCP servers.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Harper/Fabric-specific Lisa rules for TypeScript component apps.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "NestJS-specific skills and migration write-protection hooks.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-openclaw",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
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": "4.55.10",
3
+ "version": "4.55.12",
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": "4.55.10",
3
+ "version": "4.55.12",
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": "4.55.10",
3
+ "version": "4.55.12",
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": "4.55.10",
3
+ "version": "4.55.12",
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-phaser",
3
- "version": "4.55.10",
3
+ "version": "4.55.12",
4
4
  "description": "Phaser 4 game-development rules for TypeScript projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"