@codyswann/lisa 4.62.4 → 4.63.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.
Files changed (99) hide show
  1. package/dist/cli/index.d.ts.map +1 -1
  2. package/dist/cli/index.js +2 -10
  3. package/dist/cli/index.js.map +1 -1
  4. package/dist/cli/ui-cmd.d.ts +24 -0
  5. package/dist/cli/ui-cmd.d.ts.map +1 -1
  6. package/dist/cli/ui-cmd.js +40 -13
  7. package/dist/cli/ui-cmd.js.map +1 -1
  8. package/dist/cli/ui-health.d.ts.map +1 -1
  9. package/dist/cli/ui-health.js +1 -40
  10. package/dist/cli/ui-health.js.map +1 -1
  11. package/dist/cli/ui-request-origin.d.ts +8 -0
  12. package/dist/cli/ui-request-origin.d.ts.map +1 -0
  13. package/dist/cli/ui-request-origin.js +41 -0
  14. package/dist/cli/ui-request-origin.js.map +1 -0
  15. package/dist/cli/ui-starter-sync.d.ts +17 -0
  16. package/dist/cli/ui-starter-sync.d.ts.map +1 -0
  17. package/dist/cli/ui-starter-sync.js +75 -0
  18. package/dist/cli/ui-starter-sync.js.map +1 -0
  19. package/dist/core/nightly-e2e-guard-behavior-certificate.js +2 -2
  20. package/dist/core/upstream-evidence-manifest.d.ts.map +1 -1
  21. package/dist/core/upstream-evidence-manifest.js +24 -4
  22. package/dist/core/upstream-evidence-manifest.js.map +1 -1
  23. package/package.json +4 -4
  24. package/plugins/lisa/.claude-plugin/plugin.json +1 -1
  25. package/plugins/lisa/.codex-plugin/plugin.json +1 -1
  26. package/plugins/lisa/.codex-plugin/skills/lisa-setup-automations/SKILL.md +20 -0
  27. package/plugins/lisa/.codex-plugin/skills/lisa-starter-sync/SKILL.md +35 -0
  28. package/plugins/lisa/.codex-plugin/skills/lisa-starter-sync/agents/openai.yaml +4 -0
  29. package/plugins/lisa/commands/starter-sync.md +6 -0
  30. package/plugins/lisa/scripts/automation-status-expected-fleet.mjs +15 -0
  31. package/plugins/lisa/skills/lisa-setup-automations/SKILL.md +20 -0
  32. package/plugins/lisa/skills/lisa-starter-sync/SKILL.md +35 -0
  33. package/plugins/lisa/skills/lisa-starter-sync/agents/openai.yaml +4 -0
  34. package/plugins/lisa-agy/commands/lisa/starter-sync.md +6 -0
  35. package/plugins/lisa-agy/plugin.json +1 -1
  36. package/plugins/lisa-agy/scripts/automation-status-expected-fleet.mjs +15 -0
  37. package/plugins/lisa-agy/skills/lisa-setup-automations/SKILL.md +20 -0
  38. package/plugins/lisa-agy/skills/lisa-starter-sync/SKILL.md +35 -0
  39. package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
  40. package/plugins/lisa-cdk/.codex-plugin/plugin.json +1 -1
  41. package/plugins/lisa-cdk-agy/plugin.json +1 -1
  42. package/plugins/lisa-cdk-copilot/.claude-plugin/plugin.json +1 -1
  43. package/plugins/lisa-cdk-cursor/.claude-plugin/plugin.json +1 -1
  44. package/plugins/lisa-copilot/.claude-plugin/plugin.json +1 -1
  45. package/plugins/lisa-copilot/commands/lisa/starter-sync.md +6 -0
  46. package/plugins/lisa-copilot/scripts/automation-status-expected-fleet.mjs +15 -0
  47. package/plugins/lisa-copilot/skills/lisa-setup-automations/SKILL.md +20 -0
  48. package/plugins/lisa-copilot/skills/lisa-starter-sync/SKILL.md +35 -0
  49. package/plugins/lisa-cursor/.claude-plugin/plugin.json +1 -1
  50. package/plugins/lisa-cursor/commands/lisa/starter-sync.md +6 -0
  51. package/plugins/lisa-cursor/scripts/automation-status-expected-fleet.mjs +15 -0
  52. package/plugins/lisa-cursor/skills/lisa-setup-automations/SKILL.md +20 -0
  53. package/plugins/lisa-cursor/skills/lisa-starter-sync/SKILL.md +35 -0
  54. package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
  55. package/plugins/lisa-expo/.codex-plugin/plugin.json +1 -1
  56. package/plugins/lisa-expo-agy/plugin.json +1 -1
  57. package/plugins/lisa-expo-copilot/.claude-plugin/plugin.json +1 -1
  58. package/plugins/lisa-expo-cursor/.claude-plugin/plugin.json +1 -1
  59. package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json +1 -1
  60. package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json +1 -1
  61. package/plugins/lisa-harper-fabric-agy/plugin.json +1 -1
  62. package/plugins/lisa-harper-fabric-copilot/.claude-plugin/plugin.json +1 -1
  63. package/plugins/lisa-harper-fabric-cursor/.claude-plugin/plugin.json +1 -1
  64. package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
  65. package/plugins/lisa-nestjs/.codex-plugin/plugin.json +1 -1
  66. package/plugins/lisa-nestjs-agy/plugin.json +1 -1
  67. package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json +1 -1
  68. package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json +1 -1
  69. package/plugins/lisa-openclaw/.claude-plugin/plugin.json +1 -1
  70. package/plugins/lisa-openclaw/.codex-plugin/plugin.json +1 -1
  71. package/plugins/lisa-openclaw-agy/plugin.json +1 -1
  72. package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json +1 -1
  73. package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json +1 -1
  74. package/plugins/lisa-phaser/.claude-plugin/plugin.json +1 -1
  75. package/plugins/lisa-phaser/.codex-plugin/plugin.json +1 -1
  76. package/plugins/lisa-phaser-agy/plugin.json +1 -1
  77. package/plugins/lisa-phaser-copilot/.claude-plugin/plugin.json +1 -1
  78. package/plugins/lisa-phaser-cursor/.claude-plugin/plugin.json +1 -1
  79. package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
  80. package/plugins/lisa-rails/.codex-plugin/plugin.json +1 -1
  81. package/plugins/lisa-rails-agy/plugin.json +1 -1
  82. package/plugins/lisa-rails-copilot/.claude-plugin/plugin.json +1 -1
  83. package/plugins/lisa-rails-cursor/.claude-plugin/plugin.json +1 -1
  84. package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
  85. package/plugins/lisa-typescript/.codex-plugin/plugin.json +1 -1
  86. package/plugins/lisa-typescript-agy/plugin.json +1 -1
  87. package/plugins/lisa-typescript-copilot/.claude-plugin/plugin.json +1 -1
  88. package/plugins/lisa-typescript-cursor/.claude-plugin/plugin.json +1 -1
  89. package/plugins/lisa-wiki/.claude-plugin/plugin.json +1 -1
  90. package/plugins/lisa-wiki/.codex-plugin/plugin.json +1 -1
  91. package/plugins/lisa-wiki-agy/plugin.json +1 -1
  92. package/plugins/lisa-wiki-copilot/.claude-plugin/plugin.json +1 -1
  93. package/plugins/lisa-wiki-cursor/.claude-plugin/plugin.json +1 -1
  94. package/plugins/src/base/commands/starter-sync.md +6 -0
  95. package/plugins/src/base/scripts/automation-status-expected-fleet.mjs +15 -0
  96. package/plugins/src/base/skills/lisa-setup-automations/SKILL.md +20 -0
  97. package/plugins/src/base/skills/lisa-starter-sync/SKILL.md +35 -0
  98. package/ui/README.md +30 -0
  99. package/ui/index.html +129 -12
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
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.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Phaser 4 game-development rules for TypeScript projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-phaser",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Phaser 4 game-development rules for TypeScript projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-phaser",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Phaser 4 game-development rules for TypeScript projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-phaser",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Phaser 4 game-development rules for TypeScript projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-phaser",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Phaser 4 game-development rules for TypeScript projects",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-rails",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-rails",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Ruby on Rails-specific skills and hooks for RuboCop and ast-grep scanning on edit.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-rails",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-rails",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-rails",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "TypeScript-specific hooks for formatting, linting, and ast-grep scanning on edit.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "Distributable LLM Wiki kernel — ingest, query, lint, and maintain a git-native markdown knowledge base across Claude and Codex.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "4.62.4",
3
+ "version": "4.63.0",
4
4
  "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: "Run one starter sync using the project's existing landing strategy."
3
+ argument-hint: "[--work-item <ref>]"
4
+ ---
5
+
6
+ Use the /lisa-starter-sync skill for one real sync in the current project. $ARGUMENTS
@@ -41,6 +41,10 @@ export const AUTOMATION_EXPECTED_CADENCES = {
41
41
  human: "once a day",
42
42
  rrule: "FREQ=DAILY;INTERVAL=1",
43
43
  },
44
+ "starter-sync": {
45
+ human: "once a day",
46
+ rrule: "FREQ=DAILY;INTERVAL=1",
47
+ },
44
48
  "learnings-audit": {
45
49
  human: "once a week",
46
50
  rrule: "FREQ=WEEKLY;INTERVAL=1",
@@ -336,6 +340,17 @@ export function resolveExpectedAutomationFleet(input = {}) {
336
340
  );
337
341
  }
338
342
 
343
+ if (config.starter?.sync?.auto === true) {
344
+ expected.push(
345
+ createExpectedEntry(
346
+ identity,
347
+ "starter-sync",
348
+ "/lisa:starter-sync",
349
+ "opt-in"
350
+ )
351
+ );
352
+ }
353
+
339
354
  return {
340
355
  ...identity,
341
356
  expected,
@@ -197,6 +197,26 @@ closed by the next run's dedupe or the human), not mutual exclusion; manual
197
197
  runs should first confirm the cron is not due or running. Tear-down removes
198
198
  it with the rest of the `lisa-auto-<project>-*` set.
199
199
 
200
+ **Optional automation — starter sync.** Read `starter.sync.auto` from the
201
+ project's current config. Only the boolean `true` opts in (default **false**).
202
+ When true, reconcile exactly one `lisa-auto-<project>-starter-sync` registration
203
+ running `/lisa:starter-sync` once a **day** (`FREQ=DAILY;INTERVAL=1`) in the
204
+ verified durable project checkout. Use the current runtime's native scheduler
205
+ and update an existing registration by its exact name rather than duplicating
206
+ it. Its prompt must identify this as a scheduled invocation, require a fresh
207
+ check of `starter.sync.auto` before mutation, and carry the literal command on
208
+ its own line. The `lisa-starter-sync` skill calls the shipped CLI and preserves
209
+ its configured landing strategy; an open PR is not an applied update.
210
+
211
+ When false or absent, remove any exact `lisa-auto-<project>-starter-sync`
212
+ registration using that same native scheduler, leaving all other schedules
213
+ alone. Read the scheduler back after either operation and report the observed
214
+ name, target, cadence, or verified absence. Saving the console toggle only saves
215
+ config: run this reconciliation to change the registration. If scheduler access
216
+ is unavailable, report registration/removal as **unverified**, not successful;
217
+ do not write its backing files or install another scheduler. This representation
218
+ gap applies to any runtime without a native recurring-task tool.
219
+
200
220
  **Optional automation — the health cron.** When `health.schedule` in
201
221
  `.lisa.config.json` is `daily` or `weekly` (default **off**, which registers
202
222
  nothing), additionally create `lisa-auto-<project>-health-drift` running
@@ -0,0 +1,35 @@
1
+ ---
2
+ name: lisa-starter-sync
3
+ description: "Run one starter sync using Lisa's existing engine and landing command. Also used by the opt-in daily starter-sync automation."
4
+ allowed-tools: ["Bash", "Read", "Skill"]
5
+ ---
6
+
7
+ # Sync the project's starter
8
+
9
+ Run one `lisa starter sync --json` in the verified project checkout using the
10
+ installed Lisa CLI. The CLI owns diffing, ownership rules, isolated PR worktrees,
11
+ direct-when-clean refusal, and reuse of an existing PR. Do not reproduce them.
12
+
13
+ For a scheduled invocation, re-read `starter.sync.auto` from the project's
14
+ current config before any mutation. If it is not exactly `true`, report
15
+ `no-change — automatic starter sync is off` and stop. A stale registration must
16
+ not keep applying changes after the operator turns the setting off.
17
+
18
+ Use a real existing work item when supplied (`--work-item <ref>`) and the actual
19
+ runtime's identity with `--co-author <identity>`. Never invent attribution,
20
+ disable hooks, or open a ticket merely to make an empty sync pass. If project
21
+ commit policy needs attribution that is unavailable, surface that requirement.
22
+
23
+ Report the returned outcome accurately:
24
+
25
+ - `current`: **nothing to do**; no changes landed.
26
+ - `committed`: name the resulting commit.
27
+ - `pull-request`: link the existing or newly opened PR; it is awaiting review,
28
+ not merged and not an advanced consumer baseline. Continue the existing
29
+ `lisa-drive-pr-to-merge` review workflow with `auto_merge=false` when available.
30
+ - Nonzero exit or malformed output: report the actual failure and any retained
31
+ worktree location. Do not reset or delete those recovery files.
32
+
33
+ Never write to the starter repository. Never enable auto-merge as part of this
34
+ command. The same skill is distributed to all six agent runtimes; native slash
35
+ commands use `/lisa:starter-sync`, and Codex uses `$lisa-starter-sync`.
package/ui/README.md CHANGED
@@ -416,3 +416,33 @@ supplying example identifiers.
416
416
  `callout`), so adding a setting is a data edit, not a DOM edit.
417
417
  - Search box filters rows/cards within the active section.
418
418
  - URL hash routes to a section (e.g. `ui/index.html#linting`).
419
+
420
+ ## Starter sync
421
+
422
+ The starters section's **Sync now** button calls the same `lisa starter sync`
423
+ landing command as the terminal. It displays **nothing to do**, the resulting
424
+ commit, the open PR link, or the actual failure. A PR remains pending review;
425
+ opening it does not advance the project's baseline. Save or discard pending
426
+ console settings first, and commit starter configuration before opening a sync
427
+ PR. Sync never writes to a starter remote.
428
+
429
+ For projects requiring commit attribution, start the console with
430
+ `lisa ui . --work-item <existing-ref> --co-author '<actual-agent-identity>'`.
431
+ Those values and the destination are bound at startup; browser requests cannot
432
+ choose another project. Git hooks remain enabled. Overlapping requests receive
433
+ an explicit already-running response.
434
+
435
+ Open the full launch link printed by `lisa ui` to authorize starter sync. Its
436
+ per-launch token travels in the URL fragment, is removed from the address bar,
437
+ and remains only in page memory. The server requires that token as well as the
438
+ same-origin check before Git mutations; plain loopback access is insufficient.
439
+ After a reload, reopen the terminal link. Do not share that link. This protects
440
+ the starter-sync route from other local users; it is not whole-console
441
+ authentication and does not protect against processes already running as you.
442
+
443
+ After saving `starter.sync.auto`, run `lisa-setup-automations` with the current
444
+ agent runtime to reconcile its optional daily `lisa-auto-<project>-starter-sync`
445
+ registration. Turning the setting off removes that registration on reconciliation;
446
+ the scheduled command also checks the setting before mutation. The console does
447
+ not claim that a saved setting proves a live schedule. Runtimes without native
448
+ scheduler access report registration/removal as unverified.