halfcycle 0.4.12 → 0.4.14

package/dist/close-phase.d.ts

@@ -26,6 +26,10 @@
  *      the runner's own configuration reader reads. Whatever the child answers, the
  *      open goes ahead: a count that could not be sent is said once by the open
  *      answer's `counted`, never by a line of this verb's own.
+ *   3a. What is left of this computer's time record is sent through the runner's
+ *      `time` verb (`time-and-usage-record` AC4, the unthrottled sender), spawned the
+ *      same way with the same credential, so a close reads every reply this computer
+ *      saw. Whatever it answers, the open goes ahead, and nothing is printed about it.
  *   4. The open request is posted, and the answer is parsed through
  *      `openReviewAnswerSchema`. Each outcome prints its own sentence (CL1–CL6, CL12,
  *      and the typed review's H1), written out below exactly as the spec words them.
@@ -45,7 +49,7 @@
  * SHIPS TO CLIENT DISK inside the CLI: every string here is a sentence a person reads,
  * and no comment sits beside an object member.
  */
-import { unfinishedStepLine, type AcceptanceOutcome, type ObserveRunResult, type OpenReviewAnswer } from '@halfcycle/events';
+import { unfinishedStepLine, type AcceptanceOutcome, type OwnerWaitDeclaration, type ObserveRunResult, type OpenReviewAnswer, type TimeRunResult, type TimeSummary } from '@halfcycle/events';
 import type { RepoCredential } from './open-phase.js';
 /**
  * Whether the commit this phase closed at could be read, and if so the full hash
@@ -157,13 +161,46 @@ export declare function observeChildEnv(credential: RepoCredential): NodeJS.Proc
  */
 export declare function readObserveLine(stdout: string): ObserveRunResult;
 /**
- * Send a fresh count by running the runner binary this package ships, as a child
- * process, in the named repository: `node <binary> observe`. Never throws, never
- * prints: a binary that cannot be found (`binary` is the error that said so), a child
- * that cannot start, runs past `OBSERVE_CHILD_DEADLINE_MS` or prints no result line
- * all read `unreachable`, and the open goes ahead.
+ * Run one verb of the runner binary this package ships, as a child process, in the
+ * named repository: `node <binary> <args…>`, with `observeChildEnv`. `change done`
+ * spawns `observe --change <id>` through it too. Never throws,
+ * never prints: a binary that cannot be found (`binary` is the error that said so), a
+ * child that cannot start, runs past `OBSERVE_CHILD_DEADLINE_MS` or prints no result
+ * line all read `fallback`.
+ */
+export declare function runRunnerChild<T>(binary: string | Error, args: readonly string[], credential: RepoCredential, repoRoot: string, readLine: (stdout: string) => T, fallback: T): Promise<T>;
+/**
+ * Send a fresh count through the runner's `observe` verb (`runRunnerChild`). Anything
+ * but a result line reads `unreachable`, and the open goes ahead.
  */
 export declare function runObserveChild(binary: string | Error, credential: RepoCredential, repoRoot: string): Promise<ObserveRunResult>;
+/**
+ * The one line the `time` child printed, read through `timeRunResultSchema`, or
+ * `unreachable` when stdout holds no such line.
+ */
+export declare function readTimeLine(stdout: string): TimeRunResult;
+/**
+ * Send what is left of this computer's time record before the close, through the
+ * runner's `time` verb (feature `time-and-usage-record` AC4, the unthrottled sender),
+ * spawned the way `observe` is and with the same credential. Whatever the child
+ * answers, the open goes ahead; nothing is printed about it.
+ */
+export declare function runTimeChild(binary: string | Error, credential: RepoCredential, repoRoot: string): Promise<TimeRunResult>;
+/**
+ * Send whatever this computer still has queued from earlier `prove` runs,
+ * through the runner's own `prove --send-queued` — spawned the way `observe`
+ * and `time` are, with the same credential. That sub-verb prints nothing and
+ * always exits 0, so there is no line to read here: this call is for its SIDE
+ * EFFECT alone, and its result is discarded on purpose.
+ *
+ * Run before the close's own count and open go out, so a check a worker proved
+ * just before closing the phase is not left stranded behind the close. Whatever
+ * happens — no vendored binary, the child killed at its own deadline, the
+ * service unreachable — the close goes ahead unchanged: a run still unsent
+ * stays queued for the next `prove` or close on this computer, exactly as
+ * `prove` itself leaves it.
+ */
+export declare function runProveQueueChild(binary: string | Error, credential: RepoCredential, repoRoot: string): Promise<void>;
 /**
  * A close step refused on this machine, before anything was sent: the request failed
  * the shared request schema. The CLI prints the message and exits as a usage error.
@@ -194,9 +231,13 @@ export type ReviewOpenAnswer = {
     kind: 'unreachable';
     why: string;
 };
-/** What one run of the close step did: the count it sent, the commit it read, the answer. */
+/**
+ * What one run of the close step did: the count it sent, what the time record's send
+ * answered, the commit it read, the answer.
+ */
 export interface ReviewOpenAttempt {
     observe: ObserveRunResult;
+    time: TimeRunResult;
     closeCommit: CloseCommitOutcome;
     open: ReviewOpenAnswer;
 }
@@ -210,7 +251,8 @@ export interface CloseStepRequest {
 export declare function reviewOpenUrl(credential: RepoCredential, phase: string): string;
 /**
  * Run the close step: check the request, read HEAD, send a fresh count through
- * `observe`, then ask the service to open the review of `phase`.
+ * `observe`, send what is left of the time record through `sendTime`, then ask the
+ * service to open the review of `phase`.
  *
  * @param observe the fresh count, run after the request is checked and before the open
  *                is sent. The CLI passes `runObserveChild` over the shipped runner
@@ -219,12 +261,15 @@ export declare function reviewOpenUrl(credential: RepoCredential, phase: string)
  * @param repoRoot the repository whose HEAD the statements carry. Optional so a caller
  *                with no repository in hand sends no commit rather than resolving the
  *                process's working directory, which would send a stranger's HEAD.
+ * @param sendTime what is left of this computer's time record, sent after the count and
+ *                before the open, so the figures the close reads hold this computer's
+ *                last reply. The CLI passes `runTimeChild`; absent, nothing is sent.
  *
- * @throws CloseRequestInvalid before anything is sent — no count and no open — when the
+ * @throws CloseRequestInvalid before anything is sent — no count, no time and no open — when the
  *         request fails the shared schema or the phase is not a phase name (the one
  *         rule, `phaseNameSchema`); nothing else is thrown — every answer is an outcome.
  */
-export declare function openPhaseReview(credential: RepoCredential, phase: string, request: CloseStepRequest, observe: () => Promise<ObserveRunResult>, repoRoot?: string): Promise<ReviewOpenAttempt>;
+export declare function openPhaseReview(credential: RepoCredential, phase: string, request: CloseStepRequest, observe: () => Promise<ObserveRunResult>, repoRoot?: string, sendTime?: () => Promise<TimeRunResult>): Promise<ReviewOpenAttempt>;
 /** CL1 — the review is open. */
 export declare function reviewOpenedLine(phase: string): string;
 /** CL2 — Halfcycle could not count what the phase changed. */
@@ -269,4 +314,62 @@ export interface CloseStepReport {
  * its own sentence and exits 1.
  */
 export declare function closeStepReport(phase: string, attempt: ReviewOpenAttempt, engagementId: string): CloseStepReport;
+/**
+ * The address of a phase's time summary: the phase is one path segment, encoded once,
+ * the same route control registers beside the time
+ * record's own two (`time-and-usage-record` AC4).
+ */
+export declare function readTimeTotalsUrl(credential: RepoCredential, phase: string): string;
+/**
+ * Ask the service where `phase`'s time went, AFTER the close step's own unthrottled send
+ * (`runTimeChild`, above) already ran — the one read AC3 names. Never throws and never
+ * changes `close-phase`'s own outcome: any way this can fail to answer with a readable
+ * `timeSummarySchema` — the service unreachable, a non-success status, or a body this
+ * version of the CLI cannot parse — reads `null`, same as a phase with no window (404
+ * `no-phase-start`), and `timeTotalsLines` prints the spec's own T6 sentence in that
+ * one case rather than treating a network hiccup as "nothing was ever recorded".
+ */
+export declare function readCloseTimeSummary(credential: RepoCredential, phase: string): Promise<TimeSummary | null>;
+/**
+ * T1–T4 and U1–U4 for the phase, then one line per task in graph order, then T5 last
+ * when the time tied to no task has anything to show (`timeUntiedHasFigures`, the same
+ * gate the console applies) — or, with nothing to read (`summary` is `null`, or
+ * `timeSummaryIsEmpty`), T1 then T6, exactly as the console shows the same case.
+ *
+ * Each task row prints `{task id} {title}` (coordinator ruling on issue #2061):
+ * `title` is attached by control's `readTimeSummary`, from the SAME stored graph the
+ * board's titles come from (control's `withTaskTitles`) —
+ * never a second source. A task no longer in the phase's stored graph carries no
+ * `title` (the field is declared-optional on the wire): that row prints the task id
+ * alone rather than a missing word.
+ */
+export declare function timeTotalsLines(summary: TimeSummary | null): string[];
+/**
+ * The address of a phase's declarations, this cycle only: `close-phase`'s own read
+ * (`fixed-list-and-one-sitting`, Component design, *Control*), the engagement
+ * credential's.
+ */
+export declare function closeOwnerWaitDeclarationsUrl(credential: RepoCredential, phase: string): string;
+/**
+ * Read the declarations made in this phase's current cycle. Never throws: anything
+ * that is not a 200 with a body `ownerWaitDeclarationsSchema` accepts — unreachable, a
+ * bad status, a body this CLI cannot read — is `null`, which `ownerWaitCloseLines`
+ * reads as a failed read (its own sentence), never as "none were made".
+ */
+export declare function readCloseOwnerWaitDeclarations(credential: RepoCredential, phase: string): Promise<readonly OwnerWaitDeclaration[] | null>;
+/**
+ * One line per declaration made in the phase, oldest first, after the time totals
+ * (`fixed-list-and-one-sitting` AC3's *At close*): `Waited for you: {item} — the agent
+ * asked: "{question}"`. A read that failed prints the one sentence that says so and
+ * stops there; with no declarations, and nothing failed, this prints nothing — a close
+ * with none of them carries on silently, exactly as the spec says.
+ */
+export declare function ownerWaitCloseLines(declarations: readonly OwnerWaitDeclaration[] | null): string[];
+/**
+ * C6, printed once the review has opened, only when it lists one or more calls — the
+ * phase's work read (`phase-work.ts`'s `readPhaseWork`) is the one count, never
+ * recomputed here. A failed read of it prints nothing: `bin.ts`'s caller never prints
+ * this line at all rather than guess at a count it could not read.
+ */
+export declare function callsListedLine(n: number): string;
 //# sourceMappingURL=close-phase.d.ts.map

package/dist/close-phase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close-phase.d.ts","sourceRoot":"","sources":["../src/close-phase.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"close-phase.d.ts","sourceRoot":"","sources":["../src/close-phase.ts"],"names":[],"mappings":"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"}

package/dist/halfcycle-monorepo.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Is `dir` the Halfcycle monorepo — the product's own source tree?
+ *
+ * ONE DEFINITION, TWO READERS. The install arm in `bin.ts` refuses every install form
+ * here except the one self-build form (`self-build-install` AC1), and the uninstaller
+ * narrows to the self-build write set here (AC8). Both must agree on which folder this
+ * is, so the test lives in this one module and neither reader carries a copy.
+ *
+ * Why it exists at all: a walk ran the bare form intending to print the verb list and
+ * installed into the platform repo itself, mutating tracked files and creating
+ * `.halfcycle/`, `test/` and two command stubs. It was restored by hand. The bare form
+ * installing into the cwd is deliberate and stays, so this does not gate installs in
+ * general — a client repo installs exactly as before.
+ *
+ * Keyed on the root `package.json` name, not on a path — a path check would miss a
+ * clone under any other directory name, which is most of them.
+ */
+export declare function isHalfcycleMonorepo(dir: string): boolean;
+/**
+ * The one install form accepted in the monorepo (`self-build-install` AC1, AC2): an
+ * explicit project id AND the word `self-build`. `install <repo> self-build` with no
+ * id reads `self-build` as the id and leaves the type to its `client` default, so it
+ * is not this form and is refused like every other.
+ */
+export declare function isSelfBuildInstallForm(engagementIdArg: string | undefined, engagementTypeArg: string | undefined): boolean;
+//# sourceMappingURL=halfcycle-monorepo.d.ts.map

package/dist/halfcycle-monorepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"halfcycle-monorepo.d.ts","sourceRoot":"","sources":["../src/halfcycle-monorepo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASxD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,EAAE,iBAAiB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE1H"}