@momentiq/dark-factory-cli 0.7.0-alpha.9 → 1.0.0

package/dist/handoff/index.d.ts

@@ -1,145 +1,16 @@
-export declare const MARKER_OPEN = "<!-- agent-context:v1 -->";
-export declare const MARKER_CLOSE = "<!-- /agent-context:v1 -->";
+export { HandoffError } from "./ports.js";
+export type { GhClient, GitClient, Clock, IssueView, IssueViewSlim, IssueListItem, IssueCreated, PrView, } from "./ports.js";
+export { MARKER_OPEN, MARKER_CLOSE } from "./markers.js";
 export declare const HANDOFF_LABEL = "handoff";
-/**
- * Raised by the core for every operator-facing refusal/abort (the bash
- * `die`). Carries an optional `savedNotePath` so the CLI can echo where a
- * composed note was preserved when a push/gate blocked it (Decision D5 —
- * the reasoning is the precious artifact and is never discarded).
- */
-export declare class HandoffError extends Error {
-    readonly savedNotePath: string | undefined;
-    constructor(message: string, savedNotePath?: string);
-}
-/** Result of a `gh`/`git` invocation. `code === 0` is success. */
-export interface ExecResult {
-    readonly code: number;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-/** Run `gh <args>`. Default impl shells out; injectable for tests. */
-export type GhRunner = (args: readonly string[], options?: {
-    input?: string;
-}) => Promise<ExecResult>;
-/** Run `git <args>`. Default impl shells out; injectable for tests. */
-export type GitRunner = (args: readonly string[]) => Promise<ExecResult>;
-declare function defaultExec(bin: string, args: readonly string[], options?: {
-    input?: string;
-}): Promise<ExecResult>;
-export declare const defaultGh: GhRunner;
-export declare const defaultGit: GitRunner;
-/**
- * Test-only: the real spawn-backed runner, exposed so a test can drive a
- * REAL subprocess (e.g. `cat`) and pin that `options.input` is actually
- * delivered to the child's stdin. The hermetic gh/git fakes can't catch a
- * regression where async `input` is silently dropped (the bug this spawn
- * impl fixes); a real-subprocess round-trip can. Not part of the public API.
- */
-export declare const _execForTest: typeof defaultExec;
-/** A single line of operator feedback (stderr in the bash). */
-export type Logger = (line: string) => void;
-export interface HandoffDeps {
-    readonly gh: GhRunner;
-    readonly git: GitRunner;
-    /** Operator-facing log/warn sink (bash wrote these to stderr). */
-    readonly log: Logger;
-}
-export declare function defaultDeps(log?: Logger): HandoffDeps;
-export declare function requireTools(deps: HandoffDeps): Promise<void>;
-export declare function requirePrNumber(pr: string | undefined): void;
-export interface ScrubResult {
-    readonly clean: boolean;
-    /** 1-based line numbers that matched (never the matched content). */
-    readonly lines: readonly number[];
-}
-/**
- * Scan a note body for secret-shaped content. Returns the matching LINE
- * NUMBERS only — never the matched content (echoing it would re-surface
- * the secret in terminal/scrollback/logs). Detection is decoupled from
- * line formatting so a formatting hiccup can never cause a MISSED secret.
- */
-export declare function scrubSecrets(body: string): ScrubResult;
-/**
- * A well-formed agent-context block has an open marker that precedes a
- * close marker. Guards against posting a malformed/partial note.
- */
-export declare function validateNoteMarkers(body: string): boolean;
-export declare function stripControlChars(text: string): string;
-/**
- * Echo the MOST RECENT marked comment id on a PR, or undefined. There
- * should only ever be one (upsert maintains a single note); if more
- * exist, use the newest and warn. The issues/comments API returns
- * ascending by creation, so the last marked one is newest.
- */
-export declare function markerCommentId(deps: HandoffDeps, pr: string): Promise<number | undefined>;
-/**
- * Body of the MOST RECENT marked comment on a PR (undefined if none).
- * Fetched by id so it stays consistent with upsert's most-recent target.
- */
-export declare function markerCommentBody(deps: HandoffDeps, pr: string): Promise<string | undefined>;
-/**
- * Upsert the marked comment from a body. Returns the comment html_url.
- * If PATCH fails (e.g. HTTP 403 — the existing note was authored by
- * another identity), fall back to POSTing a fresh note + warn (spec §9).
- */
-export declare function upsertNote(deps: HandoffDeps, pr: string, body: string): Promise<string>;
-export interface HandoffInput {
-    /** Composed rehydration note body (with the v1 markers). */
-    readonly note: string;
-    /** Explicit PR number (optional). Empty/undefined → resolve from branch. */
-    readonly pr?: string;
-}
-export interface HandoffResult {
-    readonly pr: string;
-    /** html_url of the upserted note comment. */
-    readonly noteUrl: string;
-    /** True iff `git push origin HEAD` succeeded (false when gate-blocked). */
-    readonly pushed: boolean;
-    /** True iff a fresh draft PR was opened (NO-PR path). */
-    readonly createdDraftPr: boolean;
-    /** Operator-facing warnings accumulated along the way. */
-    readonly warnings: readonly string[];
-}
-export declare function runHandoff(input: HandoffInput, deps: HandoffDeps): Promise<HandoffResult>;
-export interface HandoffStackEntry {
-    readonly number: number;
-    readonly title: string;
-    readonly branch: string;
-    /** GitHub login of the current owner, or undefined when OPEN. */
-    readonly owner: string | undefined;
-    readonly updatedAt: string;
-}
-export interface HandoffsResult {
-    readonly entries: readonly HandoffStackEntry[];
-}
-export declare function runHandoffs(deps: HandoffDeps): Promise<HandoffsResult>;
-export interface RehydrateInput {
-    /** Explicit PR (optional). Empty/undefined → resolve from branch. */
-    readonly pr?: string;
-}
-export interface RehydrateResult {
-    readonly pr: string;
-    /** Script-derived live state line(s) — the AUTHORITATIVE truth. */
-    readonly liveState: string;
-    /** `gh pr checks` output (informational; non-zero == checks failing). */
-    readonly checks: string;
-    /** Most-recent note body, control-chars stripped. undefined if none. */
-    readonly note: string | undefined;
-    /** The `gh pr checkout <pr>` footer (script-resolved PR number). */
-    readonly checkoutHint: string;
-}
-export declare function runRehydrate(input: RehydrateInput, deps: HandoffDeps): Promise<RehydrateResult>;
-export interface AcceptInput {
-    readonly pr: string;
-}
-export interface AcceptResult {
-    readonly pr: string;
-    /** True iff the handoff label was present and removed. */
-    readonly removedLabel: boolean;
-    readonly warnings: readonly string[];
-    /** The contained rehydrate (accept CONTAINS rehydrate). */
-    readonly rehydrate: RehydrateResult;
-}
-export declare function runAccept(input: AcceptInput, deps: HandoffDeps): Promise<AcceptResult>;
-export {};
+export { runHandoff } from "./handoff-verb.js";
+export type { RunHandoffOptions, RunHandoffResult } from "./handoff-verb.js";
+export { runAccept } from "./accept-verb.js";
+export type { RunAcceptOptions, RunAcceptResult } from "./accept-verb.js";
+export { runRehydrate } from "./rehydrate-verb.js";
+export type { RunRehydrateOptions, RunRehydrateResult, } from "./rehydrate-verb.js";
+export { runHandoffs } from "./handoffs-verb.js";
+export type { RunHandoffsResult, HandoffStackRow } from "./handoffs-verb.js";
+export type { RehydrateData, LinkedItemDerivation } from "./rehydrate-core.js";
+export { renderRehydrateText } from "./rehydrate-render.js";
+export { SpawnGhClient, SpawnGitClient, SystemClock, } from "./real-clients.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/handoff/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,QAAQ,EACR,SAAS,EACT,KAAK,EACL,SAAS,EACT,aAAa,EACb,aAAa,EACb,YAAY,EACZ,MAAM,GACP,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMzD,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE7E,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC"}