@codyswann/lisa 2.256.0 → 2.257.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/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/.codex-plugin/skills/lisa-exploratory-qa/SKILL.md +12 -4
- package/plugins/lisa/.codex-plugin/skills/lisa-github-validate-issue/SKILL.md +1 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-github-write-issue/SKILL.md +9 -3
- package/plugins/lisa/.codex-plugin/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa/.codex-plugin/skills/lisa-jira-validate-ticket/SKILL.md +1 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-jira-write-ticket/SKILL.md +9 -6
- package/plugins/lisa/.codex-plugin/skills/lisa-learnings-audit/SKILL.md +9 -0
- package/plugins/lisa/.codex-plugin/skills/lisa-linear-validate-issue/SKILL.md +1 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-linear-write-issue/SKILL.md +9 -3
- package/plugins/lisa/.codex-plugin/skills/lisa-monitor/SKILL.md +6 -4
- package/plugins/lisa/.codex-plugin/skills/lisa-project-ideation/SKILL.md +21 -4
- package/plugins/lisa/.codex-plugin/skills/lisa-repair-intake/SKILL.md +17 -7
- package/plugins/lisa/agents/github-agent.md +2 -2
- package/plugins/lisa/agents/jira-agent.md +2 -2
- package/plugins/lisa/agents/linear-agent.md +2 -2
- package/plugins/lisa/rules/eager/config-resolution.md +27 -8
- package/plugins/lisa/rules/eager/pre-flight-autofill.md +21 -7
- package/plugins/lisa/rules/eager/rejection-detection.md +12 -1
- package/plugins/lisa/rules/reference/config-resolution.md +55 -16
- package/plugins/lisa/rules/reference/observability-audit.md +5 -1
- package/plugins/lisa/rules/reference/pre-flight-autofill.md +23 -8
- package/plugins/lisa/rules/reference/rejection-detection.md +61 -0
- package/plugins/lisa/skills/lisa-exploratory-qa/SKILL.md +12 -4
- package/plugins/lisa/skills/lisa-github-validate-issue/SKILL.md +1 -1
- package/plugins/lisa/skills/lisa-github-write-issue/SKILL.md +9 -3
- package/plugins/lisa/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa/skills/lisa-jira-validate-ticket/SKILL.md +1 -1
- package/plugins/lisa/skills/lisa-jira-write-ticket/SKILL.md +9 -6
- package/plugins/lisa/skills/lisa-learnings-audit/SKILL.md +9 -0
- package/plugins/lisa/skills/lisa-linear-validate-issue/SKILL.md +1 -1
- package/plugins/lisa/skills/lisa-linear-write-issue/SKILL.md +9 -3
- package/plugins/lisa/skills/lisa-monitor/SKILL.md +6 -4
- package/plugins/lisa/skills/lisa-project-ideation/SKILL.md +21 -4
- package/plugins/lisa/skills/lisa-repair-intake/SKILL.md +17 -7
- package/plugins/lisa-agy/agents/github-agent.md +2 -2
- package/plugins/lisa-agy/agents/jira-agent.md +2 -2
- package/plugins/lisa-agy/agents/linear-agent.md +2 -2
- package/plugins/lisa-agy/plugin.json +1 -1
- package/plugins/lisa-agy/skills/lisa-exploratory-qa/SKILL.md +12 -4
- package/plugins/lisa-agy/skills/lisa-github-validate-issue/SKILL.md +1 -1
- package/plugins/lisa-agy/skills/lisa-github-write-issue/SKILL.md +9 -3
- package/plugins/lisa-agy/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa-agy/skills/lisa-jira-validate-ticket/SKILL.md +1 -1
- package/plugins/lisa-agy/skills/lisa-jira-write-ticket/SKILL.md +9 -6
- package/plugins/lisa-agy/skills/lisa-learnings-audit/SKILL.md +9 -0
- package/plugins/lisa-agy/skills/lisa-linear-validate-issue/SKILL.md +1 -1
- package/plugins/lisa-agy/skills/lisa-linear-write-issue/SKILL.md +9 -3
- package/plugins/lisa-agy/skills/lisa-monitor/SKILL.md +6 -4
- package/plugins/lisa-agy/skills/lisa-project-ideation/SKILL.md +21 -4
- package/plugins/lisa-agy/skills/lisa-repair-intake/SKILL.md +17 -7
- 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/agents/github-agent.agent.md +2 -2
- package/plugins/lisa-copilot/agents/jira-agent.agent.md +2 -2
- package/plugins/lisa-copilot/agents/linear-agent.agent.md +2 -2
- package/plugins/lisa-copilot/rules/eager/config-resolution.md +27 -8
- package/plugins/lisa-copilot/rules/eager/pre-flight-autofill.md +21 -7
- package/plugins/lisa-copilot/rules/eager/rejection-detection.md +12 -1
- package/plugins/lisa-copilot/rules/reference/config-resolution.md +55 -16
- package/plugins/lisa-copilot/rules/reference/observability-audit.md +5 -1
- package/plugins/lisa-copilot/rules/reference/pre-flight-autofill.md +23 -8
- package/plugins/lisa-copilot/rules/reference/rejection-detection.md +61 -0
- package/plugins/lisa-copilot/skills/lisa-exploratory-qa/SKILL.md +12 -4
- package/plugins/lisa-copilot/skills/lisa-github-validate-issue/SKILL.md +1 -1
- package/plugins/lisa-copilot/skills/lisa-github-write-issue/SKILL.md +9 -3
- package/plugins/lisa-copilot/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa-copilot/skills/lisa-jira-validate-ticket/SKILL.md +1 -1
- package/plugins/lisa-copilot/skills/lisa-jira-write-ticket/SKILL.md +9 -6
- package/plugins/lisa-copilot/skills/lisa-learnings-audit/SKILL.md +9 -0
- package/plugins/lisa-copilot/skills/lisa-linear-validate-issue/SKILL.md +1 -1
- package/plugins/lisa-copilot/skills/lisa-linear-write-issue/SKILL.md +9 -3
- package/plugins/lisa-copilot/skills/lisa-monitor/SKILL.md +6 -4
- package/plugins/lisa-copilot/skills/lisa-project-ideation/SKILL.md +21 -4
- package/plugins/lisa-copilot/skills/lisa-repair-intake/SKILL.md +17 -7
- package/plugins/lisa-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cursor/agents/github-agent.md +2 -2
- package/plugins/lisa-cursor/agents/jira-agent.md +2 -2
- package/plugins/lisa-cursor/agents/linear-agent.md +2 -2
- package/plugins/lisa-cursor/rules/config-resolution-reference.mdc +55 -16
- package/plugins/lisa-cursor/rules/config-resolution.mdc +27 -8
- package/plugins/lisa-cursor/rules/observability-audit-reference.mdc +5 -1
- package/plugins/lisa-cursor/rules/pre-flight-autofill-reference.mdc +23 -8
- package/plugins/lisa-cursor/rules/pre-flight-autofill.mdc +21 -7
- package/plugins/lisa-cursor/rules/rejection-detection-reference.mdc +61 -0
- package/plugins/lisa-cursor/rules/rejection-detection.mdc +12 -1
- package/plugins/lisa-cursor/skills/lisa-exploratory-qa/SKILL.md +12 -4
- package/plugins/lisa-cursor/skills/lisa-github-validate-issue/SKILL.md +1 -1
- package/plugins/lisa-cursor/skills/lisa-github-write-issue/SKILL.md +9 -3
- package/plugins/lisa-cursor/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa-cursor/skills/lisa-jira-validate-ticket/SKILL.md +1 -1
- package/plugins/lisa-cursor/skills/lisa-jira-write-ticket/SKILL.md +9 -6
- package/plugins/lisa-cursor/skills/lisa-learnings-audit/SKILL.md +9 -0
- package/plugins/lisa-cursor/skills/lisa-linear-validate-issue/SKILL.md +1 -1
- package/plugins/lisa-cursor/skills/lisa-linear-write-issue/SKILL.md +9 -3
- package/plugins/lisa-cursor/skills/lisa-monitor/SKILL.md +6 -4
- package/plugins/lisa-cursor/skills/lisa-project-ideation/SKILL.md +21 -4
- package/plugins/lisa-cursor/skills/lisa-repair-intake/SKILL.md +17 -7
- 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/agents/github-agent.md +2 -2
- package/plugins/src/base/agents/jira-agent.md +2 -2
- package/plugins/src/base/agents/linear-agent.md +2 -2
- package/plugins/src/base/rules/eager/config-resolution.md +27 -8
- package/plugins/src/base/rules/eager/pre-flight-autofill.md +21 -7
- package/plugins/src/base/rules/eager/rejection-detection.md +12 -1
- package/plugins/src/base/rules/reference/config-resolution.md +55 -16
- package/plugins/src/base/rules/reference/observability-audit.md +5 -1
- package/plugins/src/base/rules/reference/pre-flight-autofill.md +23 -8
- package/plugins/src/base/rules/reference/rejection-detection.md +61 -0
- package/plugins/src/base/skills/lisa-exploratory-qa/SKILL.md +12 -4
- package/plugins/src/base/skills/lisa-github-validate-issue/SKILL.md +1 -1
- package/plugins/src/base/skills/lisa-github-write-issue/SKILL.md +9 -3
- package/plugins/src/base/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/src/base/skills/lisa-jira-validate-ticket/SKILL.md +1 -1
- package/plugins/src/base/skills/lisa-jira-write-ticket/SKILL.md +9 -6
- package/plugins/src/base/skills/lisa-learnings-audit/SKILL.md +9 -0
- package/plugins/src/base/skills/lisa-linear-validate-issue/SKILL.md +1 -1
- package/plugins/src/base/skills/lisa-linear-write-issue/SKILL.md +9 -3
- package/plugins/src/base/skills/lisa-monitor/SKILL.md +6 -4
- package/plugins/src/base/skills/lisa-project-ideation/SKILL.md +21 -4
- package/plugins/src/base/skills/lisa-repair-intake/SKILL.md +17 -7
|
@@ -456,7 +456,9 @@ re-issued against an unchanged conflicting head.
|
|
|
456
456
|
follow-up, `build_ready: true` so it auto-builds. The ticket MUST name: the blocked item + its
|
|
457
457
|
PR/deploy URL, the exact blocker (conflict / which checks failed with their logs link / which
|
|
458
458
|
change requests / which deploy run), three-audience description, and Gherkin acceptance criteria
|
|
459
|
-
for "PR is mergeable / deploy is green."
|
|
459
|
+
for "PR is mergeable / deploy is green." Every created blocker fix ticket MUST end with the
|
|
460
|
+
`rejection-detection` **operator footer** as a visible prose line:
|
|
461
|
+
`To stop this from being raised again, close it as **Not planned**. Close it as **Completed** if it was fixed — a later recurrence may be re-filed as a regression.`
|
|
460
462
|
2. **Transition the stalled item `claimed → blocked`** and add an **`is blocked by`** link to the
|
|
461
463
|
new fix ticket (vendor-native: JIRA issue link `is blocked by`; GitHub/Linear `Blocked by:` line
|
|
462
464
|
+ label). Post a `[lisa-repair-intake]` note naming what it is blocked by and why. This block is
|
|
@@ -470,11 +472,19 @@ The item now sits in `blocked`; once the fix ticket reaches a terminal state, th
|
|
|
470
472
|
`blocked` → unblock if cleared** path (next section) detects the cleared `is blocked by`
|
|
471
473
|
dependency and resumes the original in place — a self-healing loop.
|
|
472
474
|
|
|
473
|
-
**Idempotency.** Before filing, check for
|
|
475
|
+
**Idempotency.** Before filing, check for a fix ticket already carrying the marker
|
|
474
476
|
`[lisa-repair-intake] blocker:<item-ref>/<blocker-key>` (blocker-key is a stable slug of the
|
|
475
|
-
blocker, e.g. `pr-1234/merge-conflict` or `pr-1234/checks-failing`).
|
|
476
|
-
|
|
477
|
-
|
|
477
|
+
blocker, e.g. `pr-1234/merge-conflict` or `pr-1234/checks-failing`). Per the `rejection-detection`
|
|
478
|
+
rule's **Proposal rejection memory** section, that marker search MUST cover **open AND closed**
|
|
479
|
+
tickets (body-enumeration fallback on search-index lag): an **open** match → reference it and ensure
|
|
480
|
+
the `is blocked by` link is present rather than creating a duplicate; a match **closed as _not
|
|
481
|
+
planned_** (GitHub `stateReason == "not_planned"`; the config-resolved equivalent on JIRA/Linear) is
|
|
482
|
+
a **human decline** of that fix ticket — do **not** re-file it unless evidence **postdates the
|
|
483
|
+
decline**, and the re-filed ticket MUST carry BOTH the machine token (`declined <date>; recurred
|
|
484
|
+
<date> in <ref>`) and the human acknowledgment sentence (`You declined this on <date>. It has
|
|
485
|
+
recurred (<date>, <ref>), so we're raising it once more for your review.`); a match closed as
|
|
486
|
+
_completed_ is a regression path, not a decline. Honor the backoff window and state fingerprint
|
|
487
|
+
(Loop prevention) so re-runs over the same unchanged blocker are no-ops.
|
|
478
488
|
|
|
479
489
|
### Build `blocked` → re-evaluate, unblock if cleared
|
|
480
490
|
|
|
@@ -985,11 +995,11 @@ to each item* — the two never merge in the one-line summary.
|
|
|
985
995
|
|
|
986
996
|
| This cycle's exit path | Run outcome |
|
|
987
997
|
|---|---|
|
|
988
|
-
| Nothing actionable — the idle case (walk step 5): examined N, all active or in backoff | `nothing-needed` |
|
|
998
|
+
| Nothing actionable — the idle case (walk step 5): examined N, all active or in backoff — including a fix ticket suppressed by a prior decline (`rejection-detection` **Proposal rejection memory**), which the summary names in its suppression count | `nothing-needed` |
|
|
989
999
|
| Repairs applied **and confirmed** this cycle — `resumed` / `resynced` / `recovered` / `unblocked` / `closed_out` / `rolled_up` / `relinked` / `normalized_ready` | `change-proved` |
|
|
990
1000
|
| Repair produced new work for a human to pick up — e.g. an unmergeable PR or failed deploy filed as a **build-ready fix ticket** and left `blocked` | `candidate-proposed` |
|
|
991
1001
|
| A repair reached an autonomy boundary needing a human (a protected-deploy approval before it can proceed) | `approval-requested` |
|
|
992
|
-
| The loop itself could not run — the queue is unreadable
|
|
1002
|
+
| The loop itself could not run — the queue is unreadable, tracker credentials are revoked, or an open-and-closed rejection-memory / blocker-marker search is unreadable and therefore must not fall through to `nothing-needed` | `recovery-required` |
|
|
993
1003
|
|
|
994
1004
|
Record **exactly one** outcome per invocation through the run-record CLI, naming this loop's runbook
|
|
995
1005
|
(the `--summary` is the operator-readable one-liner in the contract's exemplar voice — plain,
|
|
@@ -53,7 +53,7 @@ Resolve build labels from `.lisa.config.json` `github.labels.build.*` (defaults:
|
|
|
53
53
|
|
|
54
54
|
If `github-verify` returns `FAIL` on any of the above, do NOT continue to build. **Draft the missing spec content first, then block for confirmation** — never bounce a raw "go write all this" checklist back to the author:
|
|
55
55
|
|
|
56
|
-
1. **Best-effort autofill (before blocking).** Run
|
|
56
|
+
1. **Best-effort autofill (before blocking).** Run `pre-flight-autofill` for every work item. Preserve a human bare configured key or `Confirmed: <env>`; automation writes `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces the annotation with the bare key or `Confirmed: <env>`. For a legacy bare value, use managed draft markers and current ticket content only; provider edit history is not required. A marker proves automation and requires re-annotation; otherwise unknown provenance plus conflicting evidence stops for confirmation. Resolve one exact `deploy.branches` key from the human-authored title, body, and reproduction steps or URL hostname; exclude the complete `Target Backend Environment` section and other machine-authored metadata/draft blocks so annotations cannot become evidence. A reported bug environment is an example, not a restriction. Evidence supersedes only `Assumption:`. Normalize `prod` ↔ `production` only when exactly one is configured; no other aliases exist. Conflicts stop; never infer from arbitrary branch text, URL paths/query strings, or substrings. Write through `github-write-issue`, never overwrite human prose, then re-run `github-verify`.
|
|
57
57
|
2. Relabel: remove the `claimed` label, add the `blocked` label **and** the `human_needed` marker label. Even after the agent drafted what it could, a pre-flight gate failure bounces the issue back to its author because it still needs a human to **confirm the drafted assumptions** or supply something no agent can invent — real missing credentials, access, or an irreducible product/scoping decision — so the marker tells a human scanning the board which blocked issues are waiting on them. The marker is additive to `blocked`, not a replacement. (See the `config-resolution` rule's "Build markers" for when the marker applies and when it must NOT.)
|
|
58
58
|
```bash
|
|
59
59
|
_read_cfg() { local lv gv; lv=$(jq -r "$1 // empty" .lisa.config.local.json 2>/dev/null); gv=$(jq -r "$1 // empty" .lisa.config.json 2>/dev/null); echo "${lv:-${gv}}"; }
|
|
@@ -152,4 +152,4 @@ Note: `done` may be a string or an env-keyed map (`{ dev, staging, production }`
|
|
|
152
152
|
- Never create or materially edit an issue by calling `gh issue create` / `gh issue edit` directly — always delegate to `github-write-issue` (or, from a vendor-neutral caller, `tracker-write`) so relationships, Gherkin criteria, and metadata gates are enforced.
|
|
153
153
|
- If sign-in credentials are in the issue body, extract and pass them to the flow. If the issue touches an authenticated surface and credentials are missing, that is a Step 2 failure — block and reassign rather than guessing.
|
|
154
154
|
- If the issue has a `## Validation Journey` section, pass it to the verifier agent. The Validation Journey's local-verification step must point at the target backend environment named in the body.
|
|
155
|
-
-
|
|
155
|
+
- The environment handoff for every work item uses the same durable grammar: human bare configured key or `Confirmed: <env>`; automated `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. For legacy bare values, managed draft markers and current ticket content decide provenance; provider edit history is not required. A marker proves automation; otherwise unknown provenance plus conflicting evidence stops for confirmation. Human-confirmed wins, then validated `Inferred:`; otherwise one exact `deploy.branches` key from the human-authored title, body, and reproduction steps or URL hostname drives the implementation base branch. Exclude the complete `Target Backend Environment` section and other machine-authored metadata/draft blocks so annotations cannot become evidence. Evidence supersedes only `Assumption:`. Normalize `prod` ↔ `production` only when exactly one is configured; no other aliases exist. Conflicts stop. Never infer from arbitrary branch text, URL paths/query strings, or substrings. With no signal, use the remote default and record the applicable assumption without blocking on a non-unique reverse-map. Require any selected mapping and remote branch. A reported bug environment is an example of the all-work-type rule. Non-integration fixes still require the linked forward cherry-pick.
|
|
@@ -48,7 +48,7 @@ Use the `jira-verify` skill to check the ticket against organizational standards
|
|
|
48
48
|
**Gating behavior — this is the one place auto-transitioning is allowed:**
|
|
49
49
|
|
|
50
50
|
If `jira-verify` returns `FAIL` on any of the above, do NOT continue to build. **Draft the missing spec content first, then block for confirmation** — never bounce a raw "go write all this" checklist back to the reporter:
|
|
51
|
-
1. **Best-effort autofill (before blocking).** Run
|
|
51
|
+
1. **Best-effort autofill (before blocking).** Run `pre-flight-autofill` for every work item. Preserve a human bare configured key or `Confirmed: <env>`; automation writes `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces the annotation with the bare key or `Confirmed: <env>`. For a legacy bare value, use managed draft markers and current ticket content only; provider edit history is not required. A marker proves automation and requires re-annotation; otherwise unknown provenance plus conflicting evidence stops for confirmation. Resolve one exact `deploy.branches` key from the human-authored title, body, and reproduction steps or URL hostname; exclude the complete `Target Backend Environment` section and other machine-authored metadata/draft blocks so annotations cannot become evidence. A reported bug environment is an example, not a restriction. Evidence supersedes only `Assumption:`. Normalize `prod` ↔ `production` only when exactly one is configured; no other aliases exist. Conflicts stop; never infer from arbitrary branch text, URL paths/query strings, or substrings. Write through `jira-write-ticket`, never overwrite human prose, then re-run `jira-verify`.
|
|
52
52
|
2. Transition the ticket status to the configured `blocked` status (typically `Blocked` — read from `.lisa.config.json` `jira.workflow.blocked` if present, otherwise the project's standard blocked status). Use `mcp__atlassian__transitionJiraIssue` or equivalent.
|
|
53
53
|
3. **Add the `human_needed` marker label.** Even after the agent drafted what it could, a pre-flight gate failure bounces the ticket back to its reporter because the ticket still needs a human to **confirm the drafted assumptions** or supply something no agent can invent — real missing credentials, access, or an irreducible product/scoping decision. Add the configured label (`jira.labels.human_needed`, default `Human Needed`) to the ticket's `labels` field via `mcp__atlassian__editJiraIssue` — a lightweight metadata update permitted under this same gate exception. This is additive to (not a replacement for) the `blocked` status, so a human scanning the board sees at a glance which blocked tickets are waiting on them. If the label does not exist in the project, record that and proceed — the marker is best-effort. (See the `config-resolution` rule's "Build markers" for when the marker applies and when it must NOT.)
|
|
54
54
|
4. Reassign the ticket to the **Reporter** (the human who filed it — not the Creator field, which may be a bot/integration).
|
|
@@ -132,4 +132,4 @@ Note: `done` may be a string or an env-keyed map (`{ dev, staging, production }`
|
|
|
132
132
|
- Never create or materially edit a ticket by calling MCP write tools directly — always delegate to `jira-write-ticket` so relationships, Gherkin criteria, and metadata gates are enforced
|
|
133
133
|
- If sign-in credentials are in the ticket, extract and pass them to the flow. If the ticket touches an authenticated surface and credentials are missing, that is a Step 2 failure — block and reassign rather than guessing.
|
|
134
134
|
- If the ticket has a Validation Journey section, pass it to the verifier agent. The Validation Journey's local-verification step must point at the target backend environment named in the description (for FE work, that's the deployed backend QA reported against).
|
|
135
|
-
-
|
|
135
|
+
- The environment handoff for every work item uses the same durable grammar: human bare configured key or `Confirmed: <env>`; automated `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. For legacy bare values, managed draft markers and current ticket content decide provenance; provider edit history is not required. A marker proves automation; otherwise unknown provenance plus conflicting evidence stops for confirmation. Human-confirmed wins, then validated `Inferred:`; otherwise one exact `deploy.branches` key from the human-authored title, body, and reproduction steps or URL hostname drives the implementation base branch. Exclude the complete `Target Backend Environment` section and other machine-authored metadata/draft blocks so annotations cannot become evidence. Evidence supersedes only `Assumption:`. Normalize `prod` ↔ `production` only when exactly one is configured; no other aliases exist. Conflicts stop. Never infer from arbitrary branch text, URL paths/query strings, or substrings. With no signal, use the remote default and record the applicable assumption without blocking on a non-unique reverse-map. Require any selected mapping and remote branch. A reported bug environment is an example of the all-work-type rule. Non-integration fixes still require the linked forward cherry-pick.
|
|
@@ -50,7 +50,7 @@ Use the `linear-verify` skill to check the item against organizational standards
|
|
|
50
50
|
Resolve build labels from `.lisa.config.json` `linear.labels.build.*` (defaults: `status:ready` / `status:in-progress` / `status:code-review`); resolve the `blocked` label from the same section (`linear.labels.build.blocked`, default `status:blocked`) and the `human_needed` marker label from the same section (`linear.labels.build.human_needed`, default `human-needed`).
|
|
51
51
|
|
|
52
52
|
If `linear-verify` returns `FAIL` on any of the above, do NOT continue to build. **Draft the missing spec content first, then block for confirmation** — never bounce a raw "go write all this" checklist back to the creator:
|
|
53
|
-
1. **Best-effort autofill (before blocking).** Run
|
|
53
|
+
1. **Best-effort autofill (before blocking).** Run `pre-flight-autofill` for every work item. Preserve a human bare configured key or `Confirmed: <env>`; automation writes `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces the annotation with the bare key or `Confirmed: <env>`. For a legacy bare value, use managed draft markers and current ticket content only; provider edit history is not required. A marker proves automation and requires re-annotation; otherwise unknown provenance plus conflicting evidence stops for confirmation. Resolve one exact `deploy.branches` key from the human-authored title, body, and reproduction steps or URL hostname; exclude the complete `Target Backend Environment` section and other machine-authored metadata/draft blocks so annotations cannot become evidence. A reported bug environment is an example, not a restriction. Evidence supersedes only `Assumption:`. Normalize `prod` ↔ `production` only when exactly one is configured; no other aliases exist. Conflicts stop; never infer from arbitrary branch text, URL paths/query strings, or substrings. Write through `linear-write-issue`, never overwrite human prose, then re-run `linear-verify`.
|
|
54
54
|
2. Update labels via `lisa-linear-access operation: save-issue`: remove the current build label, add the configured `blocked` label **and** the configured `human_needed` marker label. (Create either label via `create_issue_label` if needed.) Even after the agent drafted what it could, a pre-flight gate failure bounces the item back to its creator because it still needs a human to **confirm the drafted assumptions** or supply something no agent can invent — real missing credentials, access, or an irreducible product/scoping decision — so the marker tells a human scanning the board which blocked items are waiting on them. The marker is additive to `blocked`, not a replacement. (See the `config-resolution` rule's "Build markers" for when the marker applies and when it must NOT.)
|
|
55
55
|
3. Reassign the item to the **Issue creator** (the human who filed it — Linear's `creator` field).
|
|
56
56
|
4. Post the **confirmation comment** from the `pre-flight-autofill` rule via `lisa-linear-access operation: save-comment`, **not** a bare remediation checklist: disclose it is a Claude draft, give one line per drafted section naming the key assumption made, list any remaining human-only item as a specific question with a recommended default, and close with *"review the drafted sections, correct anything wrong, then flip back to Ready and it builds — or reply with corrections."* Prefix with `[{repo}]`.
|
|
@@ -135,4 +135,4 @@ The label transitions ARE the canonical signal. The native `state` field stays a
|
|
|
135
135
|
- Never create or materially edit an item by calling MCP write tools directly — always delegate to `linear-write-issue` so relationships, Gherkin criteria, and metadata gates are enforced. Two explicit exceptions are permitted: (1) the Step 2 pre-flight failure path (when `linear-verify` returns `FAIL`) may call `lisa-linear-access operation: save-issue` and `lisa-linear-access operation: save-comment` directly to set `status:blocked`, add the configured `human_needed` marker label, and reassign to the creator — this narrow exception is already granted by the rule above; (2) the Step 3 triage path may call `lisa-linear-access operation: save-comment` to post triage findings and `lisa-linear-access operation: save-issue` to add the `claude-triaged-{repo}` label — these are lightweight metadata updates that do not create or materially edit ticket content and therefore do not need to route through `linear-write-issue`.
|
|
136
136
|
- If sign-in credentials are in the item, extract and pass them to the flow. If the item touches an authenticated surface and credentials are missing, that is a Step 2 failure — block and reassign rather than guessing.
|
|
137
137
|
- If the item has a Validation Journey section, pass it to the verifier agent. The Validation Journey's local-verification step must point at the target backend environment named in the description.
|
|
138
|
-
-
|
|
138
|
+
- The environment handoff for every work item uses the same durable grammar: human bare configured key or `Confirmed: <env>`; automated `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. For legacy bare values, managed draft markers and current ticket content decide provenance; provider edit history is not required. A marker proves automation; otherwise unknown provenance plus conflicting evidence stops for confirmation. Human-confirmed wins, then validated `Inferred:`; otherwise one exact `deploy.branches` key from the human-authored title, body, and reproduction steps or URL hostname drives the implementation base branch. Exclude the complete `Target Backend Environment` section and other machine-authored metadata/draft blocks so annotations cannot become evidence. Evidence supersedes only `Assumption:`. Normalize `prod` ↔ `production` only when exactly one is configured; no other aliases exist. Conflicts stop. Never infer from arbitrary branch text, URL paths/query strings, or substrings. With no signal, use the remote default and record the applicable assumption without blocking on a non-unique reverse-map. Require any selected mapping and remote branch. A reported bug environment is an example of the all-work-type rule. Non-integration fixes still require the linked forward cherry-pick.
|
|
@@ -74,7 +74,15 @@ Each finding is a flat leaf, so `build_ready` applies directly — pass it expli
|
|
|
74
74
|
|
|
75
75
|
### Idempotency — don't spam duplicates
|
|
76
76
|
|
|
77
|
-
Re-running a pass must not refile the same finding. Before creating a ticket, search the tracker for
|
|
77
|
+
Re-running a pass must not refile the same finding. Before creating a ticket, search the tracker for a ticket carrying a stable marker `[lisa-exploratory-qa] <finding-key>` in its body (the `<finding-key>` is a stable slug of surface + symptom, e.g. `settings-modal/horizontal-overflow@tablet`). Per the `rejection-detection` rule's **Proposal rejection memory** section, that marker search MUST cover **open AND closed** tickets (with a body-enumeration fallback on search-index lag), and **match by the marker, never by title.** Then split on how any prior ticket closed:
|
|
78
|
+
|
|
79
|
+
- **Open** ticket carrying the marker → reference/update it instead; do not create a second.
|
|
80
|
+
- **Closed as _completed_** → does **not** suppress. A recurrence after a fix is a genuine **regression**, so file the finding.
|
|
81
|
+
- **Closed as _not planned_** (GitHub `stateReason == "not_planned"`; the config-resolved won't-do/canceled equivalent on JIRA/Linear) → a human **declined** this finding, so **suppress it**. Re-file only with evidence that **postdates the decline**, carrying BOTH the machine token (`declined <date>; recurred <date> in <ref>`) and a human acknowledgment sentence (`You declined this on <date>. It has recurred (<date>, <ref>), so we're raising it once more for your review.`).
|
|
82
|
+
|
|
83
|
+
Every filed finding ticket MUST end with the `rejection-detection` **operator footer** as a visible prose line so the operator knows which close-reason silences it:
|
|
84
|
+
|
|
85
|
+
> To stop this from being raised again, close it as **Not planned**. Close it as **Completed** if it was fixed — a later recurrence may be re-filed as a regression.
|
|
78
86
|
|
|
79
87
|
## Output
|
|
80
88
|
|
|
@@ -94,13 +102,13 @@ and records it, so a quiet run and a broken run are never mistaken for each othe
|
|
|
94
102
|
| This cycle's exit path | Run outcome |
|
|
95
103
|
|---|---|
|
|
96
104
|
| Findings filed — one or more `Bug` / `Improvement` tickets created or referenced (§6) | `candidate-proposed` |
|
|
97
|
-
| Clean pass — explored the personas and surfaces, nothing worth filing | `nothing-needed` |
|
|
98
|
-
| Tracker unconfigured — the §1 stop path; findings cannot be filed | `recovery-required` |
|
|
105
|
+
| Clean pass — explored the personas and surfaces, nothing worth filing — **or** every candidate was suppressed by a prior decline (`rejection-detection` **Proposal rejection memory**): the summary MUST name the suppression count | `nothing-needed` |
|
|
106
|
+
| Tracker unconfigured — the §1 stop path; findings cannot be filed — **or** the open-and-closed rejection-memory marker search could not run (tracker unreachable / credentials revoked): a memory check that could not run is a broken loop, never a silent `nothing-needed` | `recovery-required` |
|
|
99
107
|
| A degradation that still let the pass explore (e.g. Kane unavailable, one persona unreachable) | the outcome it actually reached above, with the summary **leading with the degradation** — degradation never mints a seventh token |
|
|
100
108
|
|
|
101
109
|
Record **exactly one** outcome per invocation through the run-record CLI, naming this loop's runbook
|
|
102
110
|
(the `--summary` is the operator-readable one-liner in the contract's exemplar voice — plain,
|
|
103
|
-
specific, actionable, e.g. `Explored 4 personas; nothing confusing to file.` for `nothing-needed`):
|
|
111
|
+
specific, actionable, e.g. `Explored 4 personas; nothing confusing to file.` — or, when a decline suppressed the only candidates, `Explored 4 personas; 2 candidates suppressed by a prior decline — nothing new to propose.` — for `nothing-needed`; and for a `recovery-required` from an unreadable decline check, `Tracker unreachable during the decline check — restore credentials; nothing was filed this run.`):
|
|
104
112
|
|
|
105
113
|
```bash
|
|
106
114
|
node "${CLAUDE_PLUGIN_ROOT}/scripts/automation-run-record.mjs" \
|
|
@@ -154,7 +154,7 @@ When `issue_type ∉ {Bug, Epic}`, `parent_ref` must be set — **except for a b
|
|
|
154
154
|
|
|
155
155
|
#### S8 — Target Backend Environment
|
|
156
156
|
|
|
157
|
-
When `runtime_behavior_change = true`, body must contain `## Target Backend Environment
|
|
157
|
+
When `runtime_behavior_change = true`, the body must contain `## Target Backend Environment`. Read accepted environments from the exact configured keys of `.lisa.config.json` `deploy.branches`, never from a hardcoded list. Accept a human-confirmed bare exact configured key or `Confirmed: <env>`, automated `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, automated `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` when no unique reverse-map exists. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. For legacy bare values, use managed draft markers and current ticket content only; provider edit history is not required. A marker proves automation and requires re-annotation; otherwise unknown provenance plus conflicting evidence fails for confirmation. Validate the annotation shape/source and remote-default branch; validate `<env>` as an exact configured key whenever present. A valid branch-only assumption must not fail solely because its reverse-map is absent or ambiguous. Normalize built-in `prod` ↔ `production` only when exactly one of those keys is configured. No other aliases are valid. Skipped for doc-only / config-only / type-only / Epic.
|
|
158
158
|
|
|
159
159
|
#### S9 — Sign-in Required
|
|
160
160
|
|
|
@@ -38,7 +38,7 @@ Resolve `<ORG>` and `<REPO>` from the ref or from `.lisa.config.json`.
|
|
|
38
38
|
| Priority | CREATE | Label `priority:<low|medium|high|critical>`. |
|
|
39
39
|
| Acceptance criteria | Story, Task, Bug, Sub-task, Improvement | Gherkin in `## Acceptance Criteria` — see Phase 3. |
|
|
40
40
|
| Validation Journey | Runtime-behavior changes | Delegate to `/github-add-journey`. |
|
|
41
|
-
| Target backend environment | Runtime-behavior changes |
|
|
41
|
+
| Target backend environment | Runtime-behavior changes | For every work type, use an exact `deploy.branches` key when an environment is known. Human: bare key or `Confirmed: <env>`. Automation: `Inferred: <env> — evidence: <title\|body\|reproduction\|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. |
|
|
42
42
|
| Sign-in account / credentials | Authenticated-surface tickets | Recorded under `## Sign-in Required`. |
|
|
43
43
|
| Repository | Bug, Task, Sub-task | GitHub Issues live in exactly one repo by definition — record the repo name under `## Repository`, and reject any AC bullet that references a different repo. |
|
|
44
44
|
| Source Requirement | PRD-sourced issues (`prd_source` provided) | `## Source Requirement` with PRD link + verbatim requirement quote(s) — see Phase 3; enforced at every level, sub-issues included. |
|
|
@@ -91,8 +91,14 @@ Scenario: <name>
|
|
|
91
91
|
[Explicit list of what this issue does NOT cover. Forces scope discipline.]
|
|
92
92
|
|
|
93
93
|
## Target Backend Environment
|
|
94
|
-
[Required when the issue changes runtime behavior.
|
|
95
|
-
|
|
94
|
+
[Required when the issue changes runtime behavior. Use an exact
|
|
95
|
+
`deploy.branches` key. A human-confirmed value is a bare key or
|
|
96
|
+
`Confirmed: <env>`. An automated evidence write is
|
|
97
|
+
`Inferred: <env> — evidence: <title|body|reproduction|hostname>`; an automated
|
|
98
|
+
generic default is `Assumption: <env> — remote default branch <branch>`.
|
|
99
|
+
Without a unique reverse-map use `Assumption: remote default branch <branch>`.
|
|
100
|
+
Human confirmation replaces the automated annotation with a bare key or
|
|
101
|
+
`Confirmed: <env>`. Skip only for doc/config/type-only issues.]
|
|
96
102
|
|
|
97
103
|
## Sign-in Required
|
|
98
104
|
[Include this section ONLY if the work touches authenticated surfaces.
|
|
@@ -84,8 +84,12 @@ Using the general-purpose agent in Team Lead session, Determine the name of this
|
|
|
84
84
|
|
|
85
85
|
Using the general-purpose agent in Team Lead session, **determine the base branch from the ticket's target environment, then sync the working branch onto the latest of it before any work** — so implementation always builds on current target-environment code:
|
|
86
86
|
|
|
87
|
-
1. **Resolve the target environment
|
|
88
|
-
|
|
87
|
+
1. **Resolve the target environment with durable provenance.** The `## Target Backend Environment` value has this exact grammar: a human-confirmed value is either a bare configured key or `Confirmed: <env>`; automated evidence writes `Inferred: <env> — evidence: <title|body|reproduction|hostname>`; an automated fallback writes `Assumption: <env> — remote default branch <branch>` when the branch maps uniquely, or `Assumption: remote default branch <branch>` when it does not. Human confirmation replaces an automated annotation with the bare configured key or `Confirmed: <env>`. For a legacy bare value created before this grammar, use managed draft markers and current ticket content only — provider edit history is not required or assumed. A managed marker proves automation and requires rewriting to `Inferred:` or `Assumption:`; without a marker provenance is unknown, so the value may be used only when no conflicting evidence exists, and a conflict **stops for confirmation**.
|
|
88
|
+
- A human-confirmed value wins. Otherwise a validated `Inferred:` value is next.
|
|
89
|
+
- Otherwise inspect the human-authored title, body, and reproduction steps for exactly one unambiguous signal: an exact `deploy.branches` key as a complete token, or that key as a complete label in a URL hostname (`staging.<domain>`, `gql.staging.*`). Exclude the entire `Target Backend Environment` section and all other machine-authored metadata/draft blocks from this evidence scan so an `Inferred:` or `Assumption:` annotation can never validate or conflict with itself. Clear evidence may supersede only an `Assumption:` value, never a human-confirmed value.
|
|
90
|
+
- The only normalization is built-in `prod` ↔ `production`, and only when exactly one of those keys exists in `deploy.branches`; normalize to that configured key. No other aliases exist.
|
|
91
|
+
- Never infer from arbitrary branch text, URL paths or query strings, or substrings inside other words or hostname labels. Multiple conflicting signals after normalization **stop** the flow. If there are no signals, resolve the remote default branch (`gh repo view --json defaultBranchRef -q .defaultBranchRef.name`, or `git remote set-head origin -a` then `origin/HEAD`). When it reverse-maps uniquely, write the env-bearing `Assumption:` form; when the reverse-map is not unique, write the branch-only form and continue on the remote default without inventing an environment or blocking solely for that ambiguity. Record the fallback assumption in the plan/tracker artifact.
|
|
92
|
+
2. **Map the resolved environment to a base branch** through `.lisa.config.json` `deploy.branches` — the forward direction of the env-keyed `done` resolution. The selected exact configured key must map uniquely, and the mapped branch must exist on the remote. A missing/ambiguous mapping or remote branch **stops** the flow; never guess or silently fall back.
|
|
89
93
|
3. **Establish the feature branch off the latest base, conflict-free:**
|
|
90
94
|
- `git fetch origin`.
|
|
91
95
|
- Already on a feature branch with an **open PR** → reuse it. If the PR's base ≠ the resolved base branch, surface the mismatch and re-target only with confirmation — the ticket's environment is the source of truth.
|
|
@@ -155,7 +155,7 @@ When `issue_type ∉ {Bug, Epic}`, `parent_key` must be set — **except for a b
|
|
|
155
155
|
|
|
156
156
|
#### S8 — Target Backend Environment
|
|
157
157
|
|
|
158
|
-
When `runtime_behavior_change = true`, description must contain a `Target Backend Environment` section (`h2.` / `##` in proposed text, or an ADF heading in live JIRA)
|
|
158
|
+
When `runtime_behavior_change = true`, the description must contain a `Target Backend Environment` section (`h2.` / `##` in proposed text, or an ADF heading in live JIRA). Read accepted environments from the exact configured keys of `.lisa.config.json` `deploy.branches`, never from a hardcoded list. Accept a human-confirmed bare exact configured key or `Confirmed: <env>`, automated `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, automated `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` when no unique reverse-map exists. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. For legacy bare values, use managed draft markers and current ticket content only; provider edit history is not required. A marker proves automation and requires re-annotation; otherwise unknown provenance plus conflicting evidence fails for confirmation. Validate the annotation shape/source and remote-default branch; validate `<env>` as an exact configured key whenever present. A valid branch-only assumption must not fail solely because its reverse-map is absent or ambiguous. Normalize built-in `prod` ↔ `production` only when exactly one of those keys is configured. No other aliases are valid. Skipped for doc-only / config-only / type-only / Epic.
|
|
159
159
|
|
|
160
160
|
#### S9 — Sign-in Required
|
|
161
161
|
|
|
@@ -35,7 +35,7 @@ Required fields (stop and ask if missing — do not invent values):
|
|
|
35
35
|
| Priority | CREATE | Default to project default if unstated |
|
|
36
36
|
| Acceptance criteria | Story, Task, Bug, Sub-task, Improvement | Gherkin — see Phase 3 |
|
|
37
37
|
| Validation Journey | Runtime-behavior changes | Delegate to `/jira-add-journey` |
|
|
38
|
-
| Target backend environment | Runtime-behavior changes | `
|
|
38
|
+
| Target backend environment | Runtime-behavior changes | For every work type, use an exact `deploy.branches` key when an environment is known. Human: bare key or `Confirmed: <env>`. Automation: `Inferred: <env> — evidence: <title\|body\|reproduction\|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. |
|
|
39
39
|
| Sign-in account / credentials | Tickets that touch authenticated surfaces | Name the account (or source — 1Password item, env var, seeded fixture) and role; recorded in description (Phase 3). Omit when sign-in is not required. |
|
|
40
40
|
| Single-repo scope | Bug, Task, Sub-task, Improvement | These leaf work units MUST cover one repo only. If the work crosses repos, split it before creating. Epic / Spike / Story may span repos. |
|
|
41
41
|
| Source Requirement | PRD-sourced tickets (`prd_source` provided) | `h2. Source Requirement` with PRD link + verbatim requirement quote(s) — see Phase 3; enforced at every level, sub-tasks included |
|
|
@@ -83,11 +83,14 @@ h2. Out of Scope
|
|
|
83
83
|
[Explicit list of what this ticket does NOT cover. Forces scope discipline.]
|
|
84
84
|
|
|
85
85
|
h2. Target Backend Environment
|
|
86
|
-
[Required when the ticket changes runtime behavior.
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
86
|
+
[Required when the ticket changes runtime behavior. Use an exact
|
|
87
|
+
`deploy.branches` key. A human-confirmed value is a bare key or
|
|
88
|
+
`Confirmed: <env>`. An automated evidence write is
|
|
89
|
+
`Inferred: <env> — evidence: <title|body|reproduction|hostname>`; an automated
|
|
90
|
+
generic default is `Assumption: <env> — remote default branch <branch>`.
|
|
91
|
+
Without a unique reverse-map use `Assumption: remote default branch <branch>`.
|
|
92
|
+
Human confirmation replaces the automated annotation with a bare key or
|
|
93
|
+
`Confirmed: <env>`. Skip only for doc/config/type-only tickets.]
|
|
91
94
|
|
|
92
95
|
h2. Sign-in Required
|
|
93
96
|
[Include this section ONLY if the work touches authenticated surfaces.
|
|
@@ -248,6 +248,15 @@ resolved by reading the ticket, never by filing a sibling blind. Then:
|
|
|
248
248
|
|
|
249
249
|
Re-runs are quiet no-ops: same surfaces + same evidence ⇒ zero new tickets.
|
|
250
250
|
|
|
251
|
+
This open-and-closed marker search plus the "declined `<date>`; recurred `<date>` in `<ref>`"
|
|
252
|
+
re-file discipline is the shipped precedent for the **Proposal rejection memory** section of the
|
|
253
|
+
`rejection-detection` rule — the shared contract every proposing loop now consults so a
|
|
254
|
+
closed-as-not-planned proposal is never re-filed. The gardener already conforms; it is cited there,
|
|
255
|
+
not re-implemented. Like every proposing loop, each gardener-filed ticket MUST carry the
|
|
256
|
+
`rejection-detection` **operator footer** as a visible prose line so the human knows which
|
|
257
|
+
close-reason silences it: `To stop this from being raised again, close it as **Not planned**. Close
|
|
258
|
+
it as **Completed** if it was fixed — a later recurrence may be re-filed as a regression.`
|
|
259
|
+
|
|
251
260
|
## Autonomous-vs-approval boundary
|
|
252
261
|
|
|
253
262
|
**Everything is human-gated at v1 — this skill only files tickets.** The
|
|
@@ -160,7 +160,7 @@ A **build-ready leaf work unit** that is not part of an Epic context stands alon
|
|
|
160
160
|
|
|
161
161
|
#### S8 — Target Backend Environment
|
|
162
162
|
|
|
163
|
-
When `runtime_behavior_change = true`, description must contain `## Target Backend Environment
|
|
163
|
+
When `runtime_behavior_change = true`, the description must contain `## Target Backend Environment`. Read accepted environments from the exact configured keys of `.lisa.config.json` `deploy.branches`, never from a hardcoded list. Accept a human-confirmed bare exact configured key or `Confirmed: <env>`, automated `Inferred: <env> — evidence: <title|body|reproduction|hostname>`, automated `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` when no unique reverse-map exists. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. For legacy bare values, use managed draft markers and current ticket content only; provider edit history is not required. A marker proves automation and requires re-annotation; otherwise unknown provenance plus conflicting evidence fails for confirmation. Validate the annotation shape/source and remote-default branch; validate `<env>` as an exact configured key whenever present. A valid branch-only assumption must not fail solely because its reverse-map is absent or ambiguous. Normalize built-in `prod` ↔ `production` only when exactly one of those keys is configured. No other aliases are valid. Skipped for doc-only / config-only / type-only / Epic.
|
|
164
164
|
|
|
165
165
|
#### S9 — Sign-in Required
|
|
166
166
|
|
|
@@ -57,7 +57,7 @@ Required fields (stop and ask if missing — never invent values):
|
|
|
57
57
|
| Priority | CREATE | Native Linear priority: 0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low |
|
|
58
58
|
| Acceptance criteria | Story, Task, Bug, Sub-task, Improvement | Gherkin — see Phase 3 |
|
|
59
59
|
| Validation Journey | Runtime-behavior changes | Delegate to `/linear-add-journey` |
|
|
60
|
-
| Target backend environment | Runtime-behavior changes | `
|
|
60
|
+
| Target backend environment | Runtime-behavior changes | For every work type, use an exact `deploy.branches` key when an environment is known. Human: bare key or `Confirmed: <env>`. Automation: `Inferred: <env> — evidence: <title\|body\|reproduction\|hostname>`, `Assumption: <env> — remote default branch <branch>` for a unique reverse-map, or `Assumption: remote default branch <branch>` otherwise. Human confirmation replaces an automated annotation with the bare key or `Confirmed: <env>`. |
|
|
61
61
|
| Sign-in account / credentials | Items that touch authenticated surfaces | Name the account (or source — 1Password item, env var, seeded fixture) and role; recorded in description. Omit when sign-in is not required. |
|
|
62
62
|
| Single-repo scope | Bug, Task, Sub-task | These types MUST cover one repo only. If the work crosses repos, split it before creating. Epic / Spike / Story may span repos. |
|
|
63
63
|
| Source Requirement | PRD-sourced Issues (`prd_source` provided) | `## Source Requirement` with PRD link + verbatim requirement quote(s) — see Phase 3; enforced at every level, sub-issues included. |
|
|
@@ -103,8 +103,14 @@ Linear descriptions are markdown (NOT Jira wiki markup — no `h2.` headings, us
|
|
|
103
103
|
[Explicit list of what this item does NOT cover. Forces scope discipline.]
|
|
104
104
|
|
|
105
105
|
## Target Backend Environment
|
|
106
|
-
[Required when the item changes runtime behavior.
|
|
107
|
-
|
|
106
|
+
[Required when the item changes runtime behavior. Use an exact
|
|
107
|
+
`deploy.branches` key. A human-confirmed value is a bare key or
|
|
108
|
+
`Confirmed: <env>`. An automated evidence write is
|
|
109
|
+
`Inferred: <env> — evidence: <title|body|reproduction|hostname>`; an automated
|
|
110
|
+
generic default is `Assumption: <env> — remote default branch <branch>`.
|
|
111
|
+
Without a unique reverse-map use `Assumption: remote default branch <branch>`.
|
|
112
|
+
Human confirmation replaces the automated annotation with a bare key or
|
|
113
|
+
`Confirmed: <env>`. Skip only for doc/config/type-only items.]
|
|
108
114
|
|
|
109
115
|
## Sign-in Required
|
|
110
116
|
[Include this section ONLY if the work touches authenticated surfaces.
|
|
@@ -130,7 +130,8 @@ After report, file what was found — **only when run standalone**, never under
|
|
|
130
130
|
|
|
131
131
|
- **Anomalies** (live signals over the conservative bar) → `Bug` leaves. **Gaps** (in-scope MISSING rubric dimensions) → `Task`/`Improvement` leaves.
|
|
132
132
|
- Every ticket is filed via the vendor-neutral `lisa-tracker-write` shim with `build_ready: true` (never a vendor write skill directly), as a **single-repo leaf** stamped `repo:<current>`, with a real three-audience description, Gherkin AC, Target Backend Environment, and a Validation Journey + typed `[EVIDENCE: <artifact-type>: <name>]` marker (e.g. `[EVIDENCE: log-snippet: alert-cleared]`) so it passes the `tracker-validate` gates.
|
|
133
|
-
- **
|
|
133
|
+
- **Operator footer (required):** every filed ticket ends with the `rejection-detection` **operator footer** as a visible prose line — `To stop this from being raised again, close it as **Not planned**. Close it as **Completed** if it was fixed — a later recurrence may be re-filed as a regression.` — so the operator knows which close-reason silences the finding.
|
|
134
|
+
- **Idempotent + decline-aware:** embed the `<!-- lisa:monitor-finding: <fingerprint> -->` sentinel and follow the `observability-audit` rule's current fingerprint/idempotency contract for open-and-closed search, prior-decline suppression, recurrence evidence, completed-item regression handling, and tracker-read failure outcomes. Never duplicate a live or just-resolved finding.
|
|
134
135
|
- **Capped** at `max_candidates` (default 20), `core`/high-severity first; report how many were filed vs dropped.
|
|
135
136
|
- **`--dry-run`** previews would-file tickets and creates nothing. **`--all-gaps`** widens gap filing to `recommended` tiers.
|
|
136
137
|
|
|
@@ -149,8 +150,8 @@ so a quiet monitoring run and a broken one never look identical.
|
|
|
149
150
|
| This cycle's exit path | Run outcome |
|
|
150
151
|
|---|---|
|
|
151
152
|
| Anomalies or in-scope gaps filed — one or more `Bug` / `Task` / `Improvement` leaves created or referenced | `candidate-proposed` |
|
|
152
|
-
| Clean sweep — health/audit ran end to end, nothing over the bar and no in-scope gaps | `nothing-needed` |
|
|
153
|
-
| Provider/threshold resolution failure — threshold collection fails (a present-but-uninspectable config, an invalid configured threshold) or a signal provider is unreachable so the sweep could not run | `recovery-required` |
|
|
153
|
+
| Clean sweep — health/audit ran end to end, nothing over the bar and no in-scope gaps — **or** every finding was suppressed by a prior decline (`rejection-detection` **Proposal rejection memory**): the summary MUST name the suppression count | `nothing-needed` |
|
|
154
|
+
| Provider/threshold resolution failure — threshold collection fails (a present-but-uninspectable config, an invalid configured threshold) or a signal provider is unreachable so the sweep could not run — **or** the open-and-closed rejection-memory search could not read the tracker: a memory check that could not run is a broken loop, never a silent `nothing-needed` | `recovery-required` |
|
|
154
155
|
| A degradation that still let the sweep run (an optional `ops-specialist` overlay absent, Kane unavailable) | the outcome it actually reached above, with the summary **leading with the degradation** — degradation never mints a seventh token |
|
|
155
156
|
|
|
156
157
|
Only the **standalone** run records. The nested report-only modes do their own job and do not file or
|
|
@@ -161,7 +162,8 @@ invocations.
|
|
|
161
162
|
Record **exactly one** outcome per standalone invocation through the run-record CLI, naming this
|
|
162
163
|
loop's runbook (the `--summary` is the operator-readable one-liner in the contract's exemplar voice —
|
|
163
164
|
plain, specific, actionable, e.g. `Health green; audit clean — nothing to propose.` for
|
|
164
|
-
`nothing-needed`
|
|
165
|
+
`nothing-needed`; and for a `recovery-required` from an unreadable decline check, `Tracker
|
|
166
|
+
unreachable during the decline check — restore credentials; nothing was filed this run.`):
|
|
165
167
|
|
|
166
168
|
```bash
|
|
167
169
|
node "${CLAUDE_PLUGIN_ROOT}/scripts/automation-run-record.mjs" \
|
|
@@ -241,10 +241,26 @@ Each created PRD carries the marker `[lisa-project-ideation] idea=<stable-key>`.
|
|
|
241
241
|
`<stable-key>` deterministically from: repo identity (configured repo or git remote + repo-root
|
|
242
242
|
basename) + a normalized slug of the idea name + the normalized persona key(s) + the existing-fit
|
|
243
243
|
anchor. **Do not** include rank, date, confidence, or the generated PRD title (they change across
|
|
244
|
-
runs). `lisa-prd-source-write` searches the source for
|
|
244
|
+
runs). `lisa-prd-source-write` searches the source for a PRD carrying this marker before
|
|
245
245
|
creating — matching by marker, never by title — so re-running ideation updates/references the
|
|
246
246
|
existing PRD rather than duplicating it.
|
|
247
247
|
|
|
248
|
+
Per the `rejection-detection` rule's **Proposal rejection memory** section, that marker search MUST
|
|
249
|
+
cover **open AND closed** PRDs (with a body-enumeration fallback on search-index lag), and a PRD
|
|
250
|
+
**closed as _not planned_** (GitHub `stateReason == "not_planned"`; the config-resolved won't-do/
|
|
251
|
+
canceled equivalent on JIRA/Linear — never a hardcoded lane string) is a **durable human decline**
|
|
252
|
+
that **suppresses** re-proposing that idea. Re-propose only with evidence that **postdates the
|
|
253
|
+
decline**, and state it in the new PRD as BOTH the machine token (`declined <date>; recurred <date>
|
|
254
|
+
in <ref>`) and a human acknowledgment sentence (`You declined this on <date>. It has recurred
|
|
255
|
+
(<date>, <ref>), so we're raising it once more for your review.`). A PRD closed as _completed_ is
|
|
256
|
+
not a decline. This is tracker-side memory; the advisory ideation memory ledger stays advisory and
|
|
257
|
+
never overrides it.
|
|
258
|
+
|
|
259
|
+
Every created PRD MUST carry the `rejection-detection` **operator footer** as a visible prose line
|
|
260
|
+
so the operator knows which close-reason silences it:
|
|
261
|
+
|
|
262
|
+
> To stop this from being raised again, close it as **Not planned**. Close it as **Completed** if it was fixed — a later recurrence may be re-filed as a regression.
|
|
263
|
+
|
|
248
264
|
## Step 7 — Output (no report file)
|
|
249
265
|
|
|
250
266
|
Emit two distinct in-session sections (do not write a report file):
|
|
@@ -284,9 +300,9 @@ so a quiet ideation run and a broken one are never confused.
|
|
|
284
300
|
| This run's exit path | Run outcome |
|
|
285
301
|
|---|---|
|
|
286
302
|
| PRD(s) created or reused this run (Step 6/7 **PRDs Created**) | `candidate-proposed` |
|
|
287
|
-
| Nothing to ideate — no Practical Idea cleared the bar; nothing created | `nothing-needed` |
|
|
303
|
+
| Nothing to ideate — no Practical Idea cleared the bar; nothing created — **or** every idea was suppressed by a prior decline (`rejection-detection` **Proposal rejection memory**): the summary MUST name the suppression count | `nothing-needed` |
|
|
288
304
|
| The Step 5.5 **PRD-queue-pressure gate** blocked auto-ready creation — a human must drain the queue before another auto-ready PRD is added | `approval-requested` |
|
|
289
|
-
| The loop itself could not run — the PRD source reader failed or the queue is misconfigured (a source-reader failure snapshot, not queue pressure) | `recovery-required` |
|
|
305
|
+
| The loop itself could not run — the PRD source reader failed or the queue is misconfigured (a source-reader failure snapshot, not queue pressure) — **or** the open-and-closed rejection-memory marker search could not read the source: a memory check that could not run is a broken loop, never a silent `nothing-needed` | `recovery-required` |
|
|
290
306
|
| A degradation that still let ideation run (optional Codex automation memory unavailable, an inspiration source unreachable) | the outcome it actually reached above, with the summary **leading with the degradation** — degradation never mints a seventh token |
|
|
291
307
|
|
|
292
308
|
The pressure gate is `approval-requested`, **not** `recovery-required`: the loop ran fine and
|
|
@@ -296,7 +312,8 @@ broken machine. `recovery-required` is reserved for the loop failing to run at a
|
|
|
296
312
|
Record **exactly one** outcome per invocation through the run-record CLI, naming this loop's runbook
|
|
297
313
|
(the `--summary` is the operator-readable one-liner in the contract's exemplar voice — plain,
|
|
298
314
|
specific, actionable, e.g. `Reviewed evidence; no practical idea cleared the bar — nothing to
|
|
299
|
-
propose.` for `nothing-needed`
|
|
315
|
+
propose.` for `nothing-needed`; and for a `recovery-required` from an unreadable decline check,
|
|
316
|
+
`Tracker unreachable during the decline check — restore credentials; nothing was filed this run.`):
|
|
300
317
|
|
|
301
318
|
```bash
|
|
302
319
|
node "${CLAUDE_PLUGIN_ROOT}/scripts/automation-run-record.mjs" \
|
|
@@ -456,7 +456,9 @@ re-issued against an unchanged conflicting head.
|
|
|
456
456
|
follow-up, `build_ready: true` so it auto-builds. The ticket MUST name: the blocked item + its
|
|
457
457
|
PR/deploy URL, the exact blocker (conflict / which checks failed with their logs link / which
|
|
458
458
|
change requests / which deploy run), three-audience description, and Gherkin acceptance criteria
|
|
459
|
-
for "PR is mergeable / deploy is green."
|
|
459
|
+
for "PR is mergeable / deploy is green." Every created blocker fix ticket MUST end with the
|
|
460
|
+
`rejection-detection` **operator footer** as a visible prose line:
|
|
461
|
+
`To stop this from being raised again, close it as **Not planned**. Close it as **Completed** if it was fixed — a later recurrence may be re-filed as a regression.`
|
|
460
462
|
2. **Transition the stalled item `claimed → blocked`** and add an **`is blocked by`** link to the
|
|
461
463
|
new fix ticket (vendor-native: JIRA issue link `is blocked by`; GitHub/Linear `Blocked by:` line
|
|
462
464
|
+ label). Post a `[lisa-repair-intake]` note naming what it is blocked by and why. This block is
|
|
@@ -470,11 +472,19 @@ The item now sits in `blocked`; once the fix ticket reaches a terminal state, th
|
|
|
470
472
|
`blocked` → unblock if cleared** path (next section) detects the cleared `is blocked by`
|
|
471
473
|
dependency and resumes the original in place — a self-healing loop.
|
|
472
474
|
|
|
473
|
-
**Idempotency.** Before filing, check for
|
|
475
|
+
**Idempotency.** Before filing, check for a fix ticket already carrying the marker
|
|
474
476
|
`[lisa-repair-intake] blocker:<item-ref>/<blocker-key>` (blocker-key is a stable slug of the
|
|
475
|
-
blocker, e.g. `pr-1234/merge-conflict` or `pr-1234/checks-failing`).
|
|
476
|
-
|
|
477
|
-
|
|
477
|
+
blocker, e.g. `pr-1234/merge-conflict` or `pr-1234/checks-failing`). Per the `rejection-detection`
|
|
478
|
+
rule's **Proposal rejection memory** section, that marker search MUST cover **open AND closed**
|
|
479
|
+
tickets (body-enumeration fallback on search-index lag): an **open** match → reference it and ensure
|
|
480
|
+
the `is blocked by` link is present rather than creating a duplicate; a match **closed as _not
|
|
481
|
+
planned_** (GitHub `stateReason == "not_planned"`; the config-resolved equivalent on JIRA/Linear) is
|
|
482
|
+
a **human decline** of that fix ticket — do **not** re-file it unless evidence **postdates the
|
|
483
|
+
decline**, and the re-filed ticket MUST carry BOTH the machine token (`declined <date>; recurred
|
|
484
|
+
<date> in <ref>`) and the human acknowledgment sentence (`You declined this on <date>. It has
|
|
485
|
+
recurred (<date>, <ref>), so we're raising it once more for your review.`); a match closed as
|
|
486
|
+
_completed_ is a regression path, not a decline. Honor the backoff window and state fingerprint
|
|
487
|
+
(Loop prevention) so re-runs over the same unchanged blocker are no-ops.
|
|
478
488
|
|
|
479
489
|
### Build `blocked` → re-evaluate, unblock if cleared
|
|
480
490
|
|
|
@@ -985,11 +995,11 @@ to each item* — the two never merge in the one-line summary.
|
|
|
985
995
|
|
|
986
996
|
| This cycle's exit path | Run outcome |
|
|
987
997
|
|---|---|
|
|
988
|
-
| Nothing actionable — the idle case (walk step 5): examined N, all active or in backoff | `nothing-needed` |
|
|
998
|
+
| Nothing actionable — the idle case (walk step 5): examined N, all active or in backoff — including a fix ticket suppressed by a prior decline (`rejection-detection` **Proposal rejection memory**), which the summary names in its suppression count | `nothing-needed` |
|
|
989
999
|
| Repairs applied **and confirmed** this cycle — `resumed` / `resynced` / `recovered` / `unblocked` / `closed_out` / `rolled_up` / `relinked` / `normalized_ready` | `change-proved` |
|
|
990
1000
|
| Repair produced new work for a human to pick up — e.g. an unmergeable PR or failed deploy filed as a **build-ready fix ticket** and left `blocked` | `candidate-proposed` |
|
|
991
1001
|
| A repair reached an autonomy boundary needing a human (a protected-deploy approval before it can proceed) | `approval-requested` |
|
|
992
|
-
| The loop itself could not run — the queue is unreadable
|
|
1002
|
+
| The loop itself could not run — the queue is unreadable, tracker credentials are revoked, or an open-and-closed rejection-memory / blocker-marker search is unreadable and therefore must not fall through to `nothing-needed` | `recovery-required` |
|
|
993
1003
|
|
|
994
1004
|
Record **exactly one** outcome per invocation through the run-record CLI, naming this loop's runbook
|
|
995
1005
|
(the `--summary` is the operator-readable one-liner in the contract's exemplar voice — plain,
|