beth-copilot 1.0.18 → 1.1.0

package/dist/cli/commands/land.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Land Command — Partial session completion automation
+ *
+ * `npx beth-copilot land` automates the **git-mechanical** portion of the
+ * "Landing the Plane" checklist defined in AGENTS.md. It does NOT replace
+ * the full checklist — several steps require agent judgment and are left
+ * to the caller.
+ *
+ * What this command handles:
+ *   1. Verify we're on an epic branch (not main/master)
+ *   2. Run quality gates (npm test)
+ *   3. Backup beads data (bd backup)
+ *   4. Stage, commit, and push to origin
+ *   5. Report final status
+ *
+ * What this command does NOT handle (manual / agent responsibility):
+ *   - Closing beads issues          (`npx beth-copilot close <id>`)
+ *   - Creating follow-up issues     (`bd create`)
+ *   - Updating Backlog.md           (human-readable completed-work archive)
+ *   - Generating test gate report   (`npm run test:gate`)
+ *   - Creating a PR to main         (`gh pr create` or GitHub MCP)
+ *
+ * See AGENTS.md → "Landing the Plane (Session Completion)" for the full
+ * checklist. Agents should complete the manual steps before or after
+ * invoking this command.
+ *
+ * Options:
+ *   --skip-tests    Skip test execution (not recommended)
+ *   --skip-backup   Skip beads backup
+ *   --message, -m   Custom commit message (default: "<epic-id>: session work")
+ *   --force         Push even if tests fail (DANGEROUS)
+ *   --dry-run       Show what would happen without executing
+ */
+export interface LandOptions {
+    skipTests?: boolean;
+    skipBackup?: boolean;
+    message?: string;
+    force?: boolean;
+    dryRun?: boolean;
+}
+export interface LandStepResult {
+    step: string;
+    status: 'pass' | 'fail' | 'skip' | 'warn';
+    message: string;
+    details?: string;
+}
+export interface LandResult {
+    success: boolean;
+    steps: LandStepResult[];
+    branch?: string;
+    epicId?: string;
+}
+/**
+ * Parse land command arguments.
+ */
+export declare function parseLandArgs(rawArgs: string[]): LandOptions;
+/**
+ * Get the current git branch name.
+ * Returns null if not in a git repo or detached HEAD.
+ */
+export declare function getCurrentBranch(): string | null;
+/**
+ * Extract the epic ID from a branch name.
+ * e.g. "epic/beth-z9n" → "beth-z9n"
+ * Returns null if branch doesn't follow epic convention.
+ */
+export declare function extractEpicId(branch: string): string | null;
+/**
+ * Check if a branch is a protected branch (main/master).
+ */
+export declare function isProtectedBranch(branch: string): boolean;
+/**
+ * Check if there are uncommitted changes in the working tree.
+ */
+export declare function hasUncommittedChanges(): boolean;
+/**
+ * Check if there are staged changes ready to commit.
+ */
+export declare function hasStagedChanges(): boolean;
+/**
+ * Check if there are unpushed commits on the current branch.
+ */
+export declare function hasUnpushedCommits(branch: string): boolean;
+/**
+ * Run npm test and return pass/fail with output.
+ */
+export declare function runTests(): {
+    passed: boolean;
+    output: string;
+};
+/**
+ * Run beads backup (bd backup).
+ */
+export declare function runBeadsBackup(): {
+    success: boolean;
+    output: string;
+};
+/**
+ * Stage all changes (git add -A).
+ */
+export declare function gitAddAll(): boolean;
+/**
+ * Commit staged changes.
+ */
+export declare function gitCommit(message: string): boolean;
+/**
+ * Check if a remote tracking branch exists for the given branch.
+ */
+export declare function remoteBranchExists(branch: string): boolean;
+/**
+ * Abort an in-progress rebase.
+ */
+export declare function gitRebaseAbort(): void;
+/**
+ * Pull with rebase from origin.
+ */
+export declare function gitPullRebase(branch: string): {
+    success: boolean;
+    output: string;
+};
+/**
+ * Push to origin.
+ */
+export declare function gitPush(branch: string): {
+    success: boolean;
+    output: string;
+};
+/**
+ * Verify the current branch is up to date with origin.
+ */
+export declare function isUpToDateWithOrigin(branch: string): boolean;
+/**
+ * Execute the full landing sequence.
+ * Returns structured result for programmatic use.
+ */
+export declare function executeLanding(options?: LandOptions): LandResult;
+/**
+ * Main land command entry point.
+ * Called from CLI routing with raw args after 'land'.
+ */
+export declare function land(rawArgs: string[]): Promise<void>;
+//# sourceMappingURL=land.d.ts.map

package/dist/cli/commands/land.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"land.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/land.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAcH,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAsB5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAYhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAW/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAe1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAmB1D;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAc9D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAarE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAWnC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAWlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAW1D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAUrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAalF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAa5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAwB5D;AA6CD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CA8RpE;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3D"}