@try-works/dsh-recursive-mode 0.1.17 → 0.2.0

package/lib/client.js

@@ -566,7 +566,6 @@ window.__ModuleLoader__.load({
 					setState(null);
 					return;
 				}
-				setState(null);
 				let disposed = false;
 				const apply = (frame) => {
 					if (!disposed) setState(frame);

package/lib/git-context.d.ts

@@ -0,0 +1,53 @@
+/** Normalized git facts about one checkout directory. */
+export interface GitRepoFacts {
+    /** SHA of HEAD^{commit}, or null when unresolvable (empty/non-git repo). */
+    headSha: string | null;
+    /** Current branch short name via `git symbolic-ref --short HEAD`, null when detached. */
+    branch: string | null;
+    /** True when HEAD is detached (no symbolic ref). */
+    detached: boolean;
+    /** True when the cwd is a linked worktree (git-dir != git-common-dir). */
+    isWorktree: boolean;
+    /** `git rev-parse --git-dir` output (may be relative). */
+    gitDir: string | null;
+    /** `git rev-parse --git-common-dir` output (may be relative). */
+    commonDir: string | null;
+    /** `git rev-parse --show-toplevel` output, or null. */
+    toplevel: string | null;
+    /** Upstream branch with remote prefix stripped (origin/main -> main), null when none/detached. */
+    upstreamBranch: string | null;
+}
+/** Run git in a repo dir; return trimmed stdout or null on any failure. */
+export declare function gitRun(repoRoot: string, ...args: string[]): string | null;
+/** True when a non-equal git-dir vs git-common-dir marks a linked worktree. */
+export declare function isLinkedWorktree(gitDir: string | null, commonDir: string | null): boolean;
+/** Strip a remote ref prefix (origin/main -> main, remotes/origin/main -> main). */
+export declare function stripRemotePrefix(ref: string | null): string | null;
+/**
+ * Gather normalized git facts about `repoRoot`. Total: any git failure
+ * degrades to neutral values (false / null), never throws.
+ */
+export declare function gitFacts(repoRoot: string): GitRepoFacts;
+/**
+ * Resolve the effective base branch for a checkout. In a linked worktree this
+ * is the branch the work is based on — best inferred from the upstream target
+ * (dev/stage/main promotion source) when one is configured; otherwise fall
+ * back to the current branch. Returns null only when no branch exists.
+ */
+export declare function resolveBaseBranch(facts: GitRepoFacts): string | null;
+/**
+ * Verify a worktree branch is (still) based on the recorded base branch.
+ * Returns { ok, reason }. Fails when the base branch no longer exists, or the
+ * worktree branch no longer contains it (merge-base --is-ancestor fails).
+ * A missing/unresolvable branch degrades to ok:false with a reason; a
+ * non-git dir degrades to ok:true (defer — nothing to verify).
+ */
+export declare function verifyBranchBase(repoRoot: string, baseBranch: string | null, worktreeBranch: string | null): {
+    ok: boolean;
+    reason: string | null;
+};
+/** Verify the recorded worktree branch matches the live HEAD branch. */
+export declare function verifyWorktreeBranch(repoRoot: string, recordedBranch: string | null): {
+    ok: boolean;
+    reason: string | null;
+};

package/lib/index.d.ts

@@ -7,6 +7,7 @@ export { createRecursiveLockTool } from './recursive_lock.tool.ts';
 export { createRecursiveLintTool } from './recursive_lint.tool.ts';
 export { createRecursiveCloseoutTool } from './recursive_closeout.tool.ts';
 export { createRecursiveScratchTool } from './recursive_scratch.tool.ts';
+export { createRecursiveWorktreeTool } from './recursive_worktree.tool.ts';
 export * from './status.ts';
 export { PHASE_SEQUENCE, OPTIONAL_PHASES, normalizeForLockHash, lockHashFromContent, phaseIndex, isCoreArtifact, getPrerequisites, getLockStatus, getPrerequisiteBlockers, receiptPath, readReceipt, writeReceipt, invalidateReceipt, getStaleDownstreamPhases, getNextLegalPhase, getAllStaleReceipts, validateChain, } from './lock.ts';
 export type { LockReceipt, LockStatus, PrerequisiteBlocker, StaleDownstream, ChainPhaseResult, LockChainResult, } from './lock.ts';