@codyswann/lisa 4.60.12 → 4.62.0

package/README.md

@@ -248,6 +248,19 @@ even if the remote has advanced. The command does not write to the starter or
 publish project changes. If setup's overlay application fails, finish repairing
 that project before deliberately adopting its baseline.
 
+Run `lisa starter sync --path .` after committing the starter configuration.
+The default opens a PR from an isolated worktree and preserves pending edits in
+the current checkout. `--base` selects the destination branch (default: the
+current branch). The PR stays open; the calling agent can use the existing
+`lisa-drive-pr-to-merge` workflow with `auto_merge=false` for review and checks.
+Set `starter.sync.strategy` to `direct-when-clean` to commit locally instead;
+this mode refuses tracked or untracked pending changes and does not push.
+Both modes run without prompts and honor normal Git hooks. Supply `--work-item`
+and `--co-author` when the project requires commit attribution. `--json` emits
+the result on stdout, with Git and hook output on stderr. Failed operations keep
+their worktree for inspection; retry creates a fresh isolated attempt or returns
+an already-open sync PR. No command writes to the starter repository.
+
 For Codex, apply emits a repository marketplace containing only the base Lisa
 plugin plus detected stacks and explicitly configured features. When Codex has
 those plugins installed, enabled, and trusted, it loads their native skills,

package/dist/cli/pr-landing.d.ts

@@ -0,0 +1,80 @@
+import { type CaptureCommand } from "./starter-provenance.js";
+/** Git writes stream their normal hooks; metadata reads remain bounded. */
+export interface LandingCommands {
+    readonly capture: CaptureCommand;
+    readonly run: (command: string, args: readonly string[], cwd: string) => Promise<void>;
+}
+/** Snapshot of the branch and every tracked/untracked pending change. */
+export interface LandingSnapshot {
+    readonly root: string;
+    readonly head: string;
+    readonly branch: string;
+    readonly status: string;
+}
+/** A new, isolated branch owned by the landing operation. */
+export interface PullRequestLanding {
+    readonly project: string;
+    readonly worktree: string;
+    readonly directory: string;
+    readonly head: string;
+    readonly branch: string;
+    readonly base: string;
+    readonly repo: string;
+}
+/** Optional attribution supplied by the caller, never fabricated by the tool. */
+export interface LandingAttribution {
+    readonly workItem?: string;
+    readonly coAuthor?: string;
+}
+/**
+ * Execute normal Git hooks without a shell or an interactive prompt.
+ * @param command - Executable name.
+ * @param args - Separate command arguments.
+ * @param cwd - Owning worktree.
+ * @returns Completion after normal hooks finish.
+ */
+export declare const runLandingCommand: LandingCommands["run"];
+export declare const LANDING_COMMANDS: LandingCommands;
+/**
+ * Inspect the exact repository root; a parent repository is not a substitute.
+ * @param project - Exact project root.
+ * @param commands - Git metadata reader.
+ * @returns Branch and working tree snapshot.
+ */
+export declare function inspectLanding(project: string, commands?: LandingCommands): Promise<LandingSnapshot>;
+/**
+ * Prepare the existing PR driver's isolated change-set worktree.
+ * @param snapshot - Original checkout snapshot.
+ * @param base - Destination branch.
+ * @param commands - Git and GitHub operations.
+ * @returns Existing PR or new isolated worktree.
+ */
+export declare function preparePullRequest(snapshot: LandingSnapshot, base?: string, commands?: LandingCommands): Promise<PullRequestLanding | {
+    readonly url: string;
+}>;
+/**
+ * Remove only a clean worktree that this operation created; never force it.
+ * @param landing - Worktree owned by this operation.
+ * @param commands - Git operations.
+ */
+export declare function releasePullRequestWorktree(landing: PullRequestLanding, commands?: LandingCommands): Promise<void>;
+/**
+ * Commit only the declared change set after checking for unrelated changes.
+ * @param before - Snapshot before applying changes.
+ * @param paths - Files belonging to this change set.
+ * @param title - Commit subject.
+ * @param attribution - Caller supplied tracker and author.
+ * @param commands - Git operations.
+ * @returns Commit identifier, or undefined when already current.
+ */
+export declare function commitLanding(before: LandingSnapshot, paths: readonly string[], title: string, attribution?: LandingAttribution, commands?: LandingCommands): Promise<string | undefined>;
+/**
+ * Publish through the existing driver's mechanical path; never arm auto-merge.
+ * @param landing - Clean change set worktree.
+ * @param title - Pull request title.
+ * @param body - Reviewable change description.
+ * @param commands - Git and GitHub operations.
+ * @returns Created pull request URL.
+ */
+export declare function publishPullRequest(landing: PullRequestLanding, title: string, body: string, commands?: LandingCommands): Promise<string>;
+//# sourceMappingURL=pr-landing.d.ts.map

package/dist/cli/pr-landing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-landing.d.ts","sourceRoot":"","sources":["../../src/cli/pr-landing.ts"],"names":[],"mappings":"AASA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9E,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,CACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAe,CAAC,KAAK,CA2BjD,CAAC;AAEL,eAAO,MAAM,gBAAgB,EAAE,eAG9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,kBAAmB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,IAAI,GAAE,MAAwB,EAC9B,QAAQ,kBAAmB,GAC1B,OAAO,CAAC,kBAAkB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAsExD;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,kBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,kBAAuB,EACpC,QAAQ,kBAAmB,GAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwD7B;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,kBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA+BjB"}

package/dist/cli/pr-landing.js

@@ -0,0 +1,224 @@
+/** Shared mechanical landing for lisa-drive-pr-to-merge and its CLI callers. */
+import { existsSync, statSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import { createHash, randomUUID } from "node:crypto";
+import { mkdtemp, realpath, rmdir, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { env as processEnvironment } from "node:process";
+import { captureCommand } from "./starter-provenance.js";
+/**
+ * Execute normal Git hooks without a shell or an interactive prompt.
+ * @param command - Executable name.
+ * @param args - Separate command arguments.
+ * @param cwd - Owning worktree.
+ * @returns Completion after normal hooks finish.
+ */
+export const runLandingCommand = async (command, args, cwd) => await new Promise((resolve, reject) => {
+    const child = spawn(command, [...args], {
+        cwd,
+        stdio: ["ignore", 2, 2],
+        env: {
+            ...processEnvironment,
+            GIT_TERMINAL_PROMPT: "0",
+            GH_PROMPT_DISABLED: "1",
+            GIT_EDITOR: "true",
+        },
+        timeout: 30 * 60 * 1000,
+    });
+    child.once("error", reject);
+    child.once("close", (code, signal) => {
+        if (code === 0)
+            resolve();
+        else
+            reject(new Error(`${command} failed (${signal ?? code}); its output is above.`));
+    });
+});
+export const LANDING_COMMANDS = {
+    capture: captureCommand,
+    run: runLandingCommand,
+};
+/**
+ * Inspect the exact repository root; a parent repository is not a substitute.
+ * @param project - Exact project root.
+ * @param commands - Git metadata reader.
+ * @returns Branch and working tree snapshot.
+ */
+export async function inspectLanding(project, commands = LANDING_COMMANDS) {
+    const root = await realpath(project);
+    const git = (args) => commands.capture("git", args, { cwd: root });
+    if ((await realpath(await git(["rev-parse", "--show-toplevel"]))) !== root)
+        throw new Error("Run starter sync at the repository root.");
+    const branch = await git(["branch", "--show-current"]);
+    if (!branch)
+        throw new Error("Starter sync needs a checked-out branch.");
+    return {
+        root,
+        branch,
+        head: await git(["rev-parse", "HEAD"]),
+        status: await git(["status", "--porcelain=v1", "--untracked-files=all"]),
+    };
+}
+/**
+ * Prepare the existing PR driver's isolated change-set worktree.
+ * @param snapshot - Original checkout snapshot.
+ * @param base - Destination branch.
+ * @param commands - Git and GitHub operations.
+ * @returns Existing PR or new isolated worktree.
+ */
+export async function preparePullRequest(snapshot, base = snapshot.branch, commands = LANDING_COMMANDS) {
+    await commands.capture("git", ["check-ref-format", "--branch", base], {
+        cwd: snapshot.root,
+    });
+    const repo = await commands.capture("gh", ["repo", "view", "--json", "nameWithOwner", "--jq", ".nameWithOwner"], { cwd: snapshot.root });
+    const key = createHash("sha256")
+        .update(`${base}\n${snapshot.head}`)
+        .digest("hex")
+        .slice(0, 12);
+    const prefix = `chore/starter-sync-${key}-`;
+    const branch = `${prefix}${randomUUID().slice(0, 8)}`;
+    const existing = JSON.parse(await commands.capture("gh", [
+        "pr",
+        "list",
+        "--repo",
+        repo,
+        "--base",
+        base,
+        "--state",
+        "open",
+        "--json",
+        "url,headRefName",
+        "--limit",
+        "1000",
+    ], { cwd: snapshot.root }));
+    if (!Array.isArray(existing) || existing.length >= 1000)
+        throw new Error("Could not read existing starter pull requests.");
+    const match = existing.find(entry => typeof entry?.headRefName === "string" &&
+        entry.headRefName.startsWith(prefix));
+    if (match) {
+        if (typeof match.url !== "string")
+            throw new Error("Invalid PR URL.");
+        return { url: match.url };
+    }
+    const directory = await mkdtemp(path.join(tmpdir(), "lisa-starter-sync-"));
+    const worktree = path.join(directory, "worktree");
+    try {
+        await commands.run("git", ["worktree", "add", "--no-track", "-b", branch, worktree, snapshot.head], snapshot.root);
+        await bootstrapLanding(worktree, commands);
+    }
+    catch (error) {
+        throw new Error(`Could not prepare starter sync; inspect existing branch ${branch}. Temporary directory: ${directory}`, { cause: error });
+    }
+    return {
+        project: snapshot.root,
+        worktree,
+        directory,
+        head: snapshot.head,
+        branch,
+        base,
+        repo,
+    };
+}
+/**
+ * Remove only a clean worktree that this operation created; never force it.
+ * @param landing - Worktree owned by this operation.
+ * @param commands - Git operations.
+ */
+export async function releasePullRequestWorktree(landing, commands = LANDING_COMMANDS) {
+    const head = await commands.capture("git", ["rev-parse", "HEAD"], {
+        cwd: landing.worktree,
+    });
+    await commands.run("git", ["worktree", "remove", landing.worktree], landing.project);
+    await rmdir(landing.directory);
+    if (head === landing.head)
+        await commands.run("git", ["branch", "-d", landing.branch], landing.project);
+}
+/**
+ * Commit only the declared change set after checking for unrelated changes.
+ * @param before - Snapshot before applying changes.
+ * @param paths - Files belonging to this change set.
+ * @param title - Commit subject.
+ * @param attribution - Caller supplied tracker and author.
+ * @param commands - Git operations.
+ * @returns Commit identifier, or undefined when already current.
+ */
+export async function commitLanding(before, paths, title, attribution = {}, commands = LANDING_COMMANDS) {
+    const after = await inspectLanding(before.root, commands);
+    if (after.head !== before.head || after.branch !== before.branch)
+        throw new Error("The branch changed during starter sync; changes remain uncommitted.");
+    const staged = await commands.capture("git", ["diff", "--cached", "--name-only", "-z"], { cwd: before.root });
+    if (staged)
+        throw new Error("The index changed during starter sync; changes remain uncommitted.");
+    const changed = await commands.capture("git", [
+        "ls-files",
+        "--modified",
+        "--deleted",
+        "--others",
+        "--exclude-standard",
+        "-z",
+    ], { cwd: before.root });
+    if (changed
+        .split("\0")
+        .filter(Boolean)
+        .some(name => !paths.includes(name)))
+        throw new Error("Unrelated changes appeared during starter sync; nothing was committed.");
+    if (!after.status)
+        return undefined;
+    const trailers = [
+        attribution.workItem && `Work-Item: ${attribution.workItem}`,
+        attribution.coAuthor && `Co-authored-by: ${attribution.coAuthor}`,
+    ].filter(Boolean);
+    if ([attribution.workItem, attribution.coAuthor].some(value => value !== undefined && /[\r\n]/.test(value)))
+        throw new Error("Commit attribution must contain single-line values.");
+    await commands.run("git", ["add", "--", ...paths], before.root);
+    await commands.run("git", ["commit", "-m", [title, ...trailers].join("\n\n")], before.root);
+    return await commands.capture("git", ["rev-parse", "HEAD"], {
+        cwd: before.root,
+    });
+}
+/**
+ * Publish through the existing driver's mechanical path; never arm auto-merge.
+ * @param landing - Clean change set worktree.
+ * @param title - Pull request title.
+ * @param body - Reviewable change description.
+ * @param commands - Git and GitHub operations.
+ * @returns Created pull request URL.
+ */
+export async function publishPullRequest(landing, title, body, commands = LANDING_COMMANDS) {
+    const current = await inspectLanding(landing.worktree, commands);
+    if (current.branch !== landing.branch || current.status)
+        throw new Error(`Starter landing is no longer clean on ${landing.branch}; inspect ${landing.worktree}.`);
+    await commands.run("git", ["push", "origin", `HEAD:refs/heads/${landing.branch}`], landing.worktree);
+    const bodyFile = path.join(landing.directory, "pull-request.md");
+    await writeFile(bodyFile, body, { flag: "wx", mode: 0o600 });
+    return await commands.capture("gh", [
+        "pr",
+        "create",
+        "--repo",
+        landing.repo,
+        "--head",
+        landing.branch,
+        "--base",
+        landing.base,
+        "--title",
+        title,
+        "--body-file",
+        bodyFile,
+    ], { cwd: landing.worktree });
+}
+/**
+ * Reuse the native worktree bootstrap before requiring commit hooks to run.
+ * @param worktree - Newly created worktree.
+ * @param commands - Normal subprocess runner.
+ */
+async function bootstrapLanding(worktree, commands) {
+    if (existsSync(path.join(worktree, "package.json"))) {
+        const installer = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../plugins/lisa/hooks/install-pkgs.sh");
+        await commands.run("bash", [installer], worktree);
+        if (!existsSync(path.join(worktree, "node_modules")) ||
+            !statSync(path.join(worktree, "node_modules")).isDirectory())
+            throw new Error("Worktree dependency bootstrap did not produce node_modules.");
+    }
+}
+//# sourceMappingURL=pr-landing.js.map

package/dist/cli/pr-landing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-landing.js","sourceRoot":"","sources":["../../src/cli/pr-landing.ts"],"names":[],"mappings":"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"}

package/dist/cli/starter-cmd.d.ts

@@ -13,7 +13,7 @@ export interface StarterAdoptOptions {
  */
 export declare function runStarterAdopt(repo: string, options?: StarterAdoptOptions, capture?: CaptureCommand): Promise<void>;
 /**
- * Register the starter adoption command without changing default apply routing.
+ * Register the starter adoption and sync commands without changing default apply routing.
  * @param program - Commander root.
  * @param run - Adoption handler.
  */

package/dist/cli/starter-cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"starter-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/starter-cmd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAEjC,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,EACjC,OAAO,GAAE,cAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,GAAG,GAAE,OAAO,eAAiC,GAC5C,IAAI,CAeN"}
+{"version":3,"file":"starter-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/starter-cmd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAEjC,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,EACjC,OAAO,GAAE,cAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,GAAG,GAAE,OAAO,eAAiC,GAC5C,IAAI,CA2CN"}

package/dist/cli/starter-cmd.js

@@ -1,5 +1,6 @@
 import path from "node:path";
 import { readProjectConfig } from "../core/project-config.js";
+import { runStarterSync, } from "./starter-sync-command.js";
 import { captureCommand, readGitHubStarter, recordStarterProvenance, validateStarterRepo, } from "./starter-provenance.js";
 /**
  * Adopt a starter without resetting a baseline that is already tracked.
@@ -20,14 +21,15 @@ export async function runStarterAdopt(repo, options = {}, capture = captureComma
     console.log(`Adopted ${repo} at ${template.lastSync.sha}. This records a baseline for future changes; existing project files were not synchronized.`);
 }
 /**
- * Register the starter adoption command without changing default apply routing.
+ * Register the starter adoption and sync commands without changing default apply routing.
  * @param program - Commander root.
  * @param run - Adoption handler.
  */
 export function addStarterCommand(program, run = runStarterAdopt) {
-    program
+    const starter = program
         .command("starter")
-        .description("Manage the project's starter origins")
+        .description("Manage the project's starter origins");
+    starter
         .command("adopt")
         .description("Record a starter baseline for an existing project")
         .argument("<repo>", "Starter as owner/repository")
@@ -36,5 +38,25 @@ export function addStarterCommand(program, run = runStarterAdopt) {
         .action(async (repo, options) => {
         await run(repo, options);
     });
+    starter
+        .command("sync")
+        .description("Open a starter update PR, or commit with direct-when-clean")
+        .option("--path <path>", "Existing project root")
+        .option("--base <branch>", "PR base (default: current branch)")
+        .option("--work-item <ref>", "Existing tracker item for commit and PR linkage")
+        .option("--co-author <identity>", "Actual agent co-author, when applicable")
+        .option("--json", "Print the landing result as JSON")
+        .action(async (options) => {
+        const result = await runStarterSync(options);
+        if (result.worktree)
+            console.error(`PR created; inspect retained worktree: ${result.worktree}`);
+        console.log(options.json
+            ? JSON.stringify(result)
+            : result.url
+                ? `Starter update PR: ${result.url}`
+                : result.commit
+                    ? `Committed starter updates: ${result.commit}`
+                    : "Starter is already current.");
+    });
 }
 //# sourceMappingURL=starter-cmd.js.map

package/dist/cli/starter-cmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"starter-cmd.js","sourceRoot":"","sources":["../../src/cli/starter-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GAEpB,MAAM,yBAAyB,CAAC;AAQjC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,UAA+B,EAAE,EACjC,UAA0B,cAAc;IAExC,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACpD,IACE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAC7B,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CACzD,EACD,CAAC;QACD,OAAO,CAAC,GAAG,CACT,WAAW,IAAI,iDAAiD,CACjE,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,CAC1C,aAAa,EACb,OAAO,CAAC,GAAG,EACX,OAAO,CACR,CAAC;IACF,MAAM,uBAAuB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CACT,WAAW,IAAI,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,6FAA6F,CACzI,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,MAA8B,eAAe;IAE7C,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,sCAAsC,CAAC;SACnD,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,mDAAmD,CAAC;SAChE,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,CAAC;SACjD,MAAM,CAAC,eAAe,EAAE,4BAA4B,CAAC;SACrD,MAAM,CACL,aAAa,EACb,2DAA2D,CAC5D;SACA,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAA4B,EAAE,EAAE;QAC3D,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"starter-cmd.js","sourceRoot":"","sources":["../../src/cli/starter-cmd.ts"],"names":[],"mappings":"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"}

package/dist/cli/starter-sync-command.d.ts

@@ -0,0 +1,29 @@
+import { syncStarterTemplates, type StarterSyncResult } from "./starter-sync.js";
+import { type LandingCommands } from "./pr-landing.js";
+/** Headless CLI inputs and optional commit attribution. */
+export interface StarterSyncCommandOptions {
+    readonly path?: string;
+    readonly base?: string;
+    readonly workItem?: string;
+    readonly coAuthor?: string;
+}
+/** Shared landing operations and the existing sync engine. */
+export interface StarterLandingDependencies extends LandingCommands {
+    readonly sync: typeof syncStarterTemplates;
+}
+/** Observable landing outcome for terminal and automation callers. */
+export interface StarterLandingResult {
+    readonly state: "current" | "committed" | "pull-request";
+    readonly results: readonly StarterSyncResult[];
+    readonly commit?: string;
+    readonly url?: string;
+    readonly worktree?: string;
+}
+/**
+ * Sync in an isolated PR worktree by default, or commit on an explicitly clean tree.
+ * @param options - Project path and landing options.
+ * @param dependencies - Injectable engine and Git operations.
+ * @returns Observable landing outcome.
+ */
+export declare function runStarterSync(options?: StarterSyncCommandOptions, dependencies?: Partial<StarterLandingDependencies>): Promise<StarterLandingResult>;
+//# sourceMappingURL=starter-sync-command.d.ts.map

package/dist/cli/starter-sync-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-sync-command.d.ts","sourceRoot":"","sources":["../../src/cli/starter-sync-command.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAOL,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAEzB,2DAA2D;AAC3D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,8DAA8D;AAC9D,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,QAAQ,CAAC,IAAI,EAAE,OAAO,oBAAoB,CAAC;CAC5C;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,yBAA8B,EACvC,YAAY,GAAE,OAAO,CAAC,0BAA0B,CAAM,GACrD,OAAO,CAAC,oBAAoB,CAAC,CAsC/B"}

package/dist/cli/starter-sync-command.js

@@ -0,0 +1,130 @@
+import path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { fileURLToPath } from "node:url";
+import { unlink } from "node:fs/promises";
+import { readProjectConfig, validateProjectConfig, } from "../core/project-config.js";
+import { syncStarterTemplates, } from "./starter-sync.js";
+import { commitLanding, inspectLanding, LANDING_COMMANDS, preparePullRequest, publishPullRequest, releasePullRequestWorktree, } from "./pr-landing.js";
+const PULL_REQUEST = "pull-request";
+const TITLE = "chore: sync starter updates";
+const CONFIG = ".lisa.config.json";
+/**
+ * Sync in an isolated PR worktree by default, or commit on an explicitly clean tree.
+ * @param options - Project path and landing options.
+ * @param dependencies - Injectable engine and Git operations.
+ * @returns Observable landing outcome.
+ */
+export async function runStarterSync(options = {}, dependencies = {}) {
+    const deps = {
+        ...LANDING_COMMANDS,
+        sync: syncStarterTemplates,
+        ...dependencies,
+    };
+    const before = await inspectLanding(path.resolve(options.path ?? "."), deps);
+    const config = await readProjectConfig(before.root);
+    if (!config.starter?.templates?.length)
+        throw new Error("No starter is tracked. Adopt the project's starter before syncing.");
+    if (config.starter.sync?.strategy === "direct-when-clean") {
+        return await landDirect(before, options, deps);
+    }
+    const committed = validateProjectConfig(JSON.parse(await deps.capture("git", ["show", `${before.head}:${CONFIG}`], {
+        cwd: before.root,
+    })), CONFIG);
+    if (!isDeepStrictEqual(config.starter, committed.starter))
+        throw new Error("Commit the starter configuration before opening a sync PR; the isolated worktree uses committed settings.");
+    const landing = await preparePullRequest(before, options.base, deps);
+    if (!("worktree" in landing))
+        return { state: PULL_REQUEST, url: landing.url, results: [] };
+    try {
+        return await landStarterPullRequest(landing, options, deps);
+    }
+    catch (error) {
+        throw new Error(`${error instanceof Error ? error.message : String(error)}\nStarter changes retained at ${landing.worktree}.`, { cause: error });
+    }
+}
+/**
+ * Refuse publication on partial failure; retain the engine's retryable files.
+ * @param projectRoot - Destination worktree.
+ * @param deps - Sync engine dependency.
+ * @returns Successful per-template results.
+ */
+async function applyStarter(projectRoot, deps) {
+    const lisaRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+    const results = await deps.sync({ projectRoot, lisaRoot });
+    const failures = results.filter(result => result.state === "failed");
+    if (failures.length)
+        throw new Error(failures
+            .map(result => `${result.repo}: ${result.error ?? "sync failed"}`)
+            .join("\n"));
+    return results;
+}
+/**
+ * The engine reports its owned file changes; provenance is the only extra file.
+ * @param results - Successful engine results.
+ * @returns Exact paths eligible for staging.
+ */
+function changedPaths(results) {
+    return [...new Set([CONFIG, ...results.flatMap(result => result.changed)])];
+}
+/**
+ * Hand the engine's changes to the same landing functions used by the PR driver.
+ * @param landing - Isolated destination worktree.
+ * @param options - Caller attribution.
+ * @param deps - Shared operations.
+ * @returns Published PR or current outcome.
+ */
+async function landStarterPullRequest(landing, options, deps) {
+    const before = await inspectLanding(landing.worktree, deps);
+    if (before.status)
+        throw new Error("The new worktree contains changes from its checkout hook; inspect them before syncing.");
+    const results = await applyStarter(landing.worktree, deps);
+    const commit = await commitLanding(before, changedPaths(results), TITLE, options, deps);
+    if (!commit) {
+        await releasePullRequestWorktree(landing, deps);
+        return { state: "current", results };
+    }
+    const body = [
+        "Starter changes applied using Lisa's existing ownership rules. Review this pull request before merging.",
+        options.workItem
+            ? `Refs ${options.workItem}\nWork-Item: ${options.workItem}`
+            : "",
+        ...results.map(result => `- ${result.repo}: ${result.state}; ${result.changed.length} file(s) changed.`),
+        "Next: run the existing lisa-drive-pr-to-merge workflow with auto_merge=false to handle review and checks. This command does not enable auto-merge.",
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+    const url = await publishPullRequest(landing, TITLE, body, deps);
+    try {
+        await unlink(path.join(landing.directory, "pull-request.md"));
+        await releasePullRequestWorktree(landing, deps);
+    }
+    catch {
+        return {
+            state: PULL_REQUEST,
+            results,
+            commit,
+            url,
+            worktree: landing.worktree,
+        };
+    }
+    return { state: PULL_REQUEST, results, commit, url };
+}
+/**
+ * Apply and commit only after the current checkout passes the clean-tree check.
+ * @param before - Original checkout snapshot.
+ * @param options - Commit attribution.
+ * @param deps - Shared operations.
+ * @returns Direct commit or current outcome.
+ */
+async function landDirect(before, options, deps) {
+    if (before.status)
+        throw new Error("Starter sync refused: this working tree has uncommitted changes.");
+    const results = await applyStarter(before.root, deps);
+    const commit = await commitLanding(before, changedPaths(results), TITLE, options, deps);
+    return {
+        state: commit ? "committed" : "current",
+        results,
+        ...(commit ? { commit } : {}),
+    };
+}
+//# sourceMappingURL=starter-sync-command.js.map

package/dist/cli/starter-sync-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-sync-command.js","sourceRoot":"","sources":["../../src/cli/starter-sync-command.ts"],"names":[],"mappings":"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"}

package/dist/cli/starter-sync-content.d.ts

@@ -0,0 +1,25 @@
+import type { TemplateCandidate } from "../health/template-inspection.js";
+import type { StarterChange } from "./starter-sync-source.js";
+/**
+ * Resolve canonical markers; markerless copy-contents uses whole-file ownership.
+ * @param candidates - Applicable copy-contents template sources.
+ * @returns Distinct governed opening markers.
+ */
+export declare function starterBlockMarkers(candidates: readonly TemplateCandidate[]): Promise<readonly string[]>;
+/**
+ * Apply only the blocks governed by the existing canonical template sources.
+ * @param change - Exact before/after starter file.
+ * @param current - Existing consumer bytes.
+ * @param markers - Canonical opening markers for this path.
+ * @returns Updated bytes, preserving all consumer content outside those blocks.
+ */
+export declare function mergeStarterBlocks(change: StarterChange, current: Buffer | undefined, markers: readonly string[]): Promise<Buffer>;
+/**
+ * Reuse Lisa's JSON strategies for paths governed by JSON merge semantics.
+ * @param change - Pinned starter JSON file.
+ * @param current - Existing consumer bytes.
+ * @param candidates - Applicable JSON strategies in canonical order.
+ * @returns Merged bytes; source removal preserves the consumer's JSON document.
+ */
+export declare function mergeStarterJson(change: StarterChange, current: Buffer | undefined, candidates: readonly TemplateCandidate[]): Buffer | undefined;
+//# sourceMappingURL=starter-sync-content.d.ts.map

package/dist/cli/starter-sync-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-sync-content.d.ts","sourceRoot":"","sources":["../../src/cli/starter-sync-content.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAQ1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAyD9D;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,SAAS,iBAAiB,EAAE,GACvC,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAW5B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,UAAU,EAAE,SAAS,iBAAiB,EAAE,GACvC,MAAM,GAAG,SAAS,CAiBpB"}