halfcycle 0.4.8 → 0.4.9

package/dist/open-phase.d.ts

@@ -25,6 +25,7 @@
  * treats its own.
  */
 import { type MethodUpdate, type PhaseEntryDecision } from '@halfcycle/events';
+import { type HeadCommitOutcome } from './close-phase.js';
 /**
  * A local phase stamp that could not be written, on a phase that DID move.
  *
@@ -68,7 +69,30 @@ export interface OpenedPhase {
      * and writes nothing about a move, exactly as it did before this field existed.
      */
     methodUpdated: MethodUpdate | null;
+    /**
+     * Whether this open could read a HEAD commit to send as where the phase starts,
+     * and the commit or the cause when it could not (`what-halfcycle-saw` AC1). At
+     * project scope this is still whatever the local read found — `describeStartCommit`
+     * is what decides nothing is printed there.
+     */
+    startCommitSent: HeadCommitOutcome;
+    /**
+     * The start commit in force after this open, per the plane's answer — the commit
+     * the phase counts its changes from, or `null` when there is none. `undefined`
+     * when the answer carries no such field at all: an older control, read loosely the
+     * same way `methodUpdated` is.
+     */
+    startCommit: string | null | undefined;
 }
+/**
+ * O1–O2–O3 (`what-halfcycle-saw` AC1): what this open says about where Halfcycle
+ * counts the phase's changes from, printed after the existing open line
+ * (`describeOpen`). `null` when nothing more is said: at project scope; when the
+ * plane's answer carries no `startCommit` field at all (an older control); or when
+ * the answer's start is `null` after this open DID send a commit — a mismatch this
+ * CLI does not try to explain.
+ */
+export declare function describeStartCommit(phase: string | null, sent: HeadCommitOutcome, answerStartCommit: string | null | undefined): string | null;
 /**
  * The line that says what a successful open did (cp4f T-20, acceptance walk F7).
  *
@@ -189,5 +213,5 @@ export declare function writePhaseStamp(engagementId: string, phase: string | nu
  *         warns without being able to say why.
  * @throws Error on transport failure or a body that is not the expected shape.
  */
-export declare function openPhase(credential: RepoCredential, phase: string | null, entry: PhaseEntryDecision, home?: string): Promise<OpenedPhase>;
+export declare function openPhase(credential: RepoCredential, phase: string | null, entry: PhaseEntryDecision, home?: string, repoRoot?: string): Promise<OpenedPhase>;
 //# sourceMappingURL=open-phase.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"open-phase.d.ts","sourceRoot":"","sources":["../src/open-phase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAY3B;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qDAAqD;IACrD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,yEAAyE;QACzE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF;;;;;OAKG;IACH,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,eAAe,GAAG,UAAU,CAAC,GAAG,MAAM,CAUtG;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,MAAM,EAAE,MAAM;aAEd,OAAO,EAAE,MAAM,GAAG,IAAI;aACtB,aAAa,EAAE,MAAM,GAAG,IAAI;gBAH5B,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,aAAa,GAAE,MAAM,GAAG,IAAW;CAKtD;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,kFAItB,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CA4BhB;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,iBAAiB,GAAG,IAAI,CAmB1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,cAAc,EAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,kBAAkB,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CA6EtB"}
+{"version":3,"file":"open-phase.d.ts","sourceRoot":"","sources":["../src/open-phase.ts"],"names":[],"mappings":"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"}

package/dist/plan.d.ts

@@ -18,8 +18,8 @@
  * file's name is `renderPhaseSegment`'s (INV-023), and "is the file's phase the phase
  * asked for" compares the two segments it renders, because that function is where a
  * number and its decimal string become one phase. The shown record's format is
- * `@halfcycle/core`'s `serialiseShownPlans` and `parseShownPlans`; this module keeps
- * only the I/O. Whether a typed number reaches this phase is `resolvePhaseReference`
+ * `@halfcycle/core`'s, and its I/O is `./shown-record.ts`'s `updateShownRecord`, which
+ * keeps the reviews `review --show` listed. Whether a typed number reaches this phase is `resolvePhaseReference`
  * (`@halfcycle/core`). The two approval-line swaps take their sentences and the floor
  * from `client-version.ts` (`@halfcycle/events`); the switched-off swap is decided by
  * the server's `typedApprovalOffered`, never by the client's copy of the switch, and
@@ -31,6 +31,27 @@
  * picture package (INV-001). `test/plan-verb.test.ts` reads that package's source and
  * holds the two equal.
  *
+ * THREE MORE ANSWERS (`close-review-and-carry-drop` AC7, ruling S-f). `removal-owed`
+ * (CL11) is a 409 naming every part `docs/system.json` must lose before a new plan is
+ * taken; `reportPhasePlan`'s answer-parsing switch is exhaustive over
+ * `phasePlanResultSchema`'s four outcomes, with a `never` default (`assertNever`), so a
+ * fifth outcome added to the wire without a matching case here is a compile error
+ * instead of a silent fall-through to "could not record the plan just now". CL10 (a
+ * carried part left out of its target's plan) is an ordinary `refused` problem at
+ * `path: ''`, so `planRefusedLines` prints it against the plan file as it prints every
+ * other problem — one more sentence, no new code. `recorded`'s optional `carriedFrom`
+ * marks a carried part "carried over from phase N" (CL13) in `--show`'s change lines,
+ * with no second read of anything.
+ *
+ * THE REDRAW LINE (`part-state-and-builds` AC7, #1742). After a recorded plan, when the
+ * project already has this phase's embedded picture under `docs/diagrams/`
+ * (`embedImageName(phaseDiagramBase(phase))`, `./draw/write.ts` — the one home of a
+ * phase's diagram names, never copied here), `runPlan` prints the sentence asking for
+ * `draw phase` to be run again: after the state sentence without `--show`, and before
+ * the approval line with it, so the redraw line is never the last thing printed. The
+ * phase is quoted for the shell (`quoteForShell`, `@halfcycle/core`), as every other
+ * printed command is.
+ *
  * WHAT LEAVES THE MACHINE. The checked description (through the shared stage), then
  * `{ descriptionVersion, plan }`. Nothing is written into the person's tree; the shown
  * record is machine state under the home folder (INV-019).
@@ -40,7 +61,7 @@
  * reads, so none names an internal register, route or setting; no comment sits beside
  * an object member.
  */
-import { type PhasePlan, type PhasePlanChange, type PhasePlanProblem, type PlannedScopeState, type SystemDescription } from '@halfcycle/events';
+import { type CarriedFromEntry, type PhasePlan, type PhasePlanChange, type PhasePlanProblem, type PlannedScopeState, type RemovalOwedPart, type SystemDescription } from '@halfcycle/events';
 import { type ShownPlanEntry } from '@halfcycle/core';
 import type { RepoCredential } from './open-phase.js';
 import { type DescriptionVerb, type SystemDeps, type SystemRun } from './system-report.js';
@@ -96,8 +117,11 @@ export type PlanFileCheck = {
 export declare function readAndCheckPlan(repoRoot: string, phase: string, description: SystemDescription, verb: DescriptionVerb): PlanFileCheck;
 /**
  * What came of reporting the plan. `recorded`: the service's answer, as its schema
- * parsed it. `refused`: the service's own problems. `no-route`: this service cannot
- * take a plan yet. `unavailable`: it could not be reported, and `why` says so.
+ * parsed it, `carriedFrom` present only when at least one part of this plan was
+ * carried in. `refused`: the service's own problems (CL10 among them, at `path: ''`).
+ * `removal-owed`: `docs/system.json` still holds a part an earlier close dropped or
+ * removed (CL11); nothing was sent. `no-route`: this service cannot take a plan yet.
+ * `unavailable`: it could not be reported, and `why` says so.
  */
 export type PlanOutcome = {
     kind: 'recorded';
@@ -106,9 +130,13 @@ export type PlanOutcome = {
     state: PlannedScopeState;
     changedParts: readonly string[];
     typedApprovalOffered: boolean;
+    carriedFrom?: readonly CarriedFromEntry[];
 } | {
     kind: 'refused';
     problems: PhasePlanProblem[];
+} | {
+    kind: 'removal-owed';
+    parts: readonly RemovalOwedPart[];
 } | {
     kind: 'no-route';
 } | {
@@ -135,20 +163,15 @@ export type ShownWrite = {
 };
 /**
  * Record on this machine that `entry` was shown: `~/.halfcycle/engagements/<id>/`
- * `shown-plans.json`, the directory composed by `engagementStateDir` (which checks the
- * id) and the filename `SHOWN_PLANS_FILENAME`. Never throws.
+ * `shown-plans.json`, through `updateShownRecord` (`./shown-record.ts`), the CLI's one
+ * writer of that file. Never throws.
  *
  * The record keeps the latest entry per phase, so the entry for this phase is
  * replaced. An entry holding this number under another phase is dropped too: the
  * service gives each phase one number and never changes it, so such an entry is
- * stale, and `serialiseShownPlans` refuses two entries with one number, which would
- * otherwise fail every later write. A missing or malformed record reads as nothing
- * shown (`parseShownPlans`).
- *
- * Written to a temporary file in the same folder, mode `0600` set on it before the
- * rename (a rename carries the source's bits), then renamed into place, so a reader
- * sees the old record or the new one and never a part of one. `chmod` is skipped on
- * Windows, where the bits mean nothing.
+ * stale, and the serialiser refuses two entries with one number, which would
+ * otherwise fail every later write. The record's listed reviews are kept as they
+ * are. A missing or malformed record reads as nothing shown.
  */
 export declare function writeShownPlan(engagementId: string, entry: ShownPlanEntry, home?: string): ShownWrite;
 /**
@@ -167,7 +190,22 @@ export declare function planRefusedLines(verb: DescriptionVerb, phase: string, p
  * The line for a phase name `isValidPhaseIdentity` refuses, prefixed by the verb that
  * is running. Nothing has been sent when it is printed.
  */
-export declare function notAPhaseNameLine(verb: DescriptionVerb, phase: string): string;
+export declare function notAPhaseNameLine(verb: DescriptionVerb | 'review', phase: string): string;
+/**
+ * CL11 — one line per part `docs/system.json` must lose before a new plan is taken
+ * (`close-review-and-carry-drop` AC7), prefixed by the verb that is running. Nothing was
+ * sent when these print.
+ */
+export declare function removalOwedLines(verb: DescriptionVerb, parts: readonly RemovalOwedPart[]): string;
+/**
+ * The redraw line (#1742, `part-state-and-builds` AC7): printed after a recorded plan
+ * when this phase already has its embedded picture under `docs/diagrams/`. `null` when
+ * there is none to redraw, so the caller prints nothing. Never throws: a phase that
+ * reaches here already passed `isValidPhaseIdentity`, but a failure composing the base
+ * name still reads as "nothing to redraw" rather than crashing the verb that recorded
+ * the plan.
+ */
+export declare function redrawLine(repoRoot: string, phase: string): string | null;
 /** The pieces `runPlan` reaches outside itself through; replaced in tests. */
 export interface PlanDeps extends SystemDeps {
     readonly reportPlan: (credential: RepoCredential, plan: PhasePlan, descriptionVersion: number) => Promise<PlanOutcome>;
@@ -188,8 +226,11 @@ export declare function planStateSentence(state: PlannedScopeState): string;
  * phase whose name is that number would otherwise take it.
  */
 export declare function approvalLine(phase: string, number: number, typedApprovalOffered: boolean, pinnedVersion: string | undefined, shown: readonly ShownPlanEntry[]): string;
-/** One line per change, in plan order: the part's name, what changes, the plan's line, and the changed mark. */
-export declare function changeLines(plan: PhasePlan, description: SystemDescription, changed: readonly string[]): string;
+/**
+ * One line per change, in plan order: the part's name, the carried mark (CL13) when
+ * `carriedFrom` names it, what changes, the plan's line, and the changed mark.
+ */
+export declare function changeLines(plan: PhasePlan, description: SystemDescription, changed: readonly string[], carriedFrom?: readonly CarriedFromEntry[]): string;
 /**
  * The whole verb, in the order the module header gives. Exit 0 only when the plan is
  * recorded and, with `--show`, the shown record is written. When that write fails the

package/dist/plan.d.ts.map

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

package/dist/pre-create-checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pre-create-checks.d.ts","sourceRoot":"","sources":["../src/pre-create-checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAWH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,QAEgC,CAAC;AAEjE,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CAKpG;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI7D;AA0BD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,IAAI,CAWzG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAU5D;AAUD,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAA+D,CAAC;AAsF9G;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUnE"}
+{"version":3,"file":"pre-create-checks.d.ts","sourceRoot":"","sources":["../src/pre-create-checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAWH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,QAEgC,CAAC;AAEjE,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CAKpG;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI7D;AA0BD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,IAAI,CAWzG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAU5D;AAUD,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAA+D,CAAC;AA6F9G;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUnE"}

package/dist/review.d.ts

@@ -0,0 +1,228 @@
+/**
+ * The client half of `npx halfcycle@latest review <phase> --show` and
+ * `review <phase> --answer <part> "<answer>"` (System view · E3, feature
+ * `typed-close-review` AC2, AC5, AC6).
+ *
+ * `--show` reads the phase's close review (`GET …/phases/:phase/review`, the control
+ * service's `readPhaseReview`), prints every part, what the agents reported beside what
+ * Halfcycle saw, and each decision so far (RV1–RV7), then records on this machine the
+ * review it listed, so a review line the owner types binds to it. `--answer` sends the
+ * agent's answer to the owner's question on one part (`POST …/review/answers`) and prints
+ * AN1, or its refusal (AN2–AN5).
+ *
+ * EVERY RV AND AN LINE LIVES HERE (AC5), and nothing else in the CLI words them. The TR
+ * lines are the runner's (`user-prompt-submit-lines.ts`), never these.
+ *
+ * ONE HOME FOR EVERYTHING THIS VERB DOES NOT WORD (INV-003). Nothing about the review is
+ * derived here; the view is the control service's one derivation, read through
+ * `phaseReviewViewSchema`, and this module only prints it:
+ * - which parts are decidable, waiting or settled is the view's (`decidable`, `waiting`,
+ *   `decision`), never recomputed;
+ * - what Halfcycle saw is `observedLines` and `observedPhaseLines`, the agents' reasons
+ *   are `agentSaid` (with `NO_TASK_SAID_LINE`), the code line is `codeLinkLine`, all
+ *   `@halfcycle/events`' and referenced, never copied;
+ * - which acts a part takes is `reviewActsFor`, which RV7 reads to list the lines a part
+ *   allows;
+ * - the answer's text rule is `reviewAnswerRequestSchema` (`statementText` at
+ *   `REVIEW_ANSWER_MAX`), and the credential screen is core's `looksLikeSecret`;
+ * - the shown record's format is core's; its I/O is `./shown-record.ts`'s
+ *   `updateShownRecord`, the CLI's one writer of that file;
+ * - the sign-in remedy is core's `HOOK_REMEDY`.
+ *
+ * WHEN NOTHING WAS COUNTED AT ALL. The view's `observed` is `null` when the control
+ * service holds no counts for the round. `observedLines` needs a value, so this verb
+ * hands it the value that means "nothing counted" (`NOTHING_COUNTED`, the counting state
+ * `cannot-count`, no part, no figure), and RV4 then reads `Changes not counted` and the
+ * checks line in that function's words, never a sentence of this module's. RV1b prints
+ * nothing then: there is no counting state to describe, and RV1a already says the phase
+ * could not be counted.
+ *
+ * WHAT LEAVES THE MACHINE. `--show` sends nothing but the read. `--answer` sends
+ * `{ part, answer }` only after the answer passed the same rule on this machine (AN3,
+ * AN4); a refused answer is never sent (INV-020).
+ *
+ * INV-001: Node builtins, the global `fetch`, `@halfcycle/events` and `@halfcycle/core`
+ * only. SHIPS TO CLIENT DISK inside the CLI: every string here is a sentence a person
+ * reads, so none names an internal register, route or setting; no comment sits beside
+ * an object member.
+ */
+import { type ShownReviewEntry } from '@halfcycle/core';
+import { type PhaseReviewView, type ReviewViewPart } from '@halfcycle/events';
+import type { RepoCredential } from './open-phase.js';
+import type { SystemRun } from './system-report.js';
+/** The usage line, printed for no phase, an extra argument, an unknown flag, or neither mode. */
+export declare const REVIEW_USAGE = "npx halfcycle@latest review <phase> (--show | --answer <part> \"<answer>\") [--repo <root>]";
+/** The view of a round: open, or the round that closed the phase. */
+export type ReviewedView = Extract<PhaseReviewView, {
+    state: 'open' | 'closed';
+}>;
+/** The view when no round is open and none closed the phase. */
+export type NoReviewView = Extract<PhaseReviewView, {
+    state: 'none';
+}>;
+/**
+ * What the arguments after `review` came to: exactly one positional (the phase), and
+ * exactly one of `--show` or `--answer <part> <answer>`, with at most one
+ * `--repo <root>`. The two values after `--answer` are taken as they are, so an answer
+ * may begin with a dash. Anything else is usage.
+ */
+export type ReviewArgs = {
+    ok: true;
+    mode: 'show';
+    phase: string;
+    repoRoot: string | undefined;
+} | {
+    ok: true;
+    mode: 'answer';
+    phase: string;
+    part: string;
+    answer: string;
+    repoRoot: string | undefined;
+} | {
+    ok: false;
+};
+export declare function parseReviewArgs(argv: readonly string[]): ReviewArgs;
+/** RV1a: printed when the view's `counted` is false. */
+export declare const RV1A_LINE = "Halfcycle could not count what this phase changed, so judge each part on what the agents reported alone.";
+/**
+ * RV2's status, exactly one of seven (S-aa). A settled part reads its decision; an
+ * unsettled one reads whether a question waits for the agent's answer, then whether it
+ * was sent back in this round, else that it waits for the owner's decision (a part
+ * whose question was answered included).
+ */
+export declare function partStatus(part: ReviewViewPart, round: number): string;
+/**
+ * THE LISTING, RV1 to RV7, in the spec's order: RV1, RV1a when Halfcycle could not
+ * count, RV1b one line each, then per part RV2–RV6 with RV4a, then RV7.
+ */
+export declare function reviewListingLines(view: ReviewedView): string[];
+/** RV8: the refusal for a view with no open review, by its state. */
+export declare function rv8Line(view: NoReviewView | Extract<PhaseReviewView, {
+    state: 'closed';
+}>): string;
+/** RV9: refused, not signed in. */
+export declare const RV9_LINE = "halfcycle review: this project is not signed in on this computer. Run \"npx halfcycle\" in the project folder to sign in.";
+/** RV10: refused, cannot reach. */
+export declare const RV10_LINE = "halfcycle review: Halfcycle could not be reached just now. Check this computer's connection, then run this again.";
+/** RV11: refused, the listing could not be recorded on this computer. */
+export declare const RV11_LINE = "halfcycle review: the list just shown could not be recorded on this computer, so a typed decision cannot use it. Run this again.";
+/** AN1: the answer is on the part. */
+export declare function an1Line(name: string): string;
+/** AN2: refused, no question waits on the part. */
+export declare function an2Line(part: string, phase: string): string;
+/** AN3: refused on this computer, the answer's shape. */
+export declare const AN3_LINE = "halfcycle review: the answer must be one paragraph of at most 1,000 characters, with no line breaks.";
+/** AN4: refused on this computer, the answer looks secret. */
+export declare const AN4_LINE = "halfcycle review: the answer looks like it holds a password or key, so it was not sent. Write it again without it.";
+/** AN5: refused by Halfcycle, the words. */
+export declare const AN5_LINE = "halfcycle review: the answer was not accepted. Reword it in plain words and run this again.";
+/**
+ * The shown record's review entry for a listed round (AC2): `decidable` is the view's;
+ * `awaitingAnswer` is true when one of the part's questions has no answer; `sentBack`
+ * is true when one of its send-backs is from the listed round.
+ */
+export declare function shownReviewEntry(view: ReviewedView, shownAt: string): ShownReviewEntry;
+/** What writing the shown review came to. */
+export type ShownReviewWrite = {
+    ok: true;
+} | {
+    ok: false;
+};
+/**
+ * Record on this machine that `entry` was listed, through `updateShownRecord`. The
+ * record keeps the latest review per phase, so this phase's review is replaced; a review
+ * holding this number under another phase is stale and dropped, as `writeShownPlan` drops
+ * a plan's. The shown plans are kept as they are. Never throws.
+ */
+export declare function writeShownReview(engagementId: string, entry: ShownReviewEntry, home?: string): ShownReviewWrite;
+/** The address of one phase's review, or of a path under it: each segment encoded once. */
+export declare function reviewUrl(credential: RepoCredential, phase: string, rest?: string): string;
+/** What reading the review came to. */
+export type ReviewRead = {
+    kind: 'view';
+    view: PhaseReviewView;
+} | {
+    kind: 'not-signed-in';
+} | {
+    kind: 'unreachable';
+};
+/**
+ * Read the phase's review. Never throws. A body that parses under
+ * `phaseReviewViewSchema` on a 200 is the view; a 401 is not signed in; anything else
+ * (no answer, a status the read does not give, a body the schema refuses) is cannot
+ * reach, never a view.
+ */
+export declare function readReview(credential: RepoCredential, phase: string): Promise<ReviewRead>;
+/** What sending the answer came to. */
+export type AnswerSend = {
+    kind: 'recorded';
+    name: string;
+} | {
+    kind: 'no-question';
+} | {
+    kind: 'refused';
+} | {
+    kind: 'not-signed-in';
+} | {
+    kind: 'unreachable';
+};
+/**
+ * Send the agent's answer. Never throws. A body that parses under
+ * `reviewAnswerResultSchema` is authoritative whatever its status, except that
+ * `unavailable` is cannot reach; a 401 is not signed in; anything else is cannot reach.
+ */
+export declare function sendReviewAnswer(credential: RepoCredential, phase: string, body: {
+    part: string;
+    answer: string;
+}): Promise<AnswerSend>;
+/** The pieces the verb reaches outside itself through; replaced in tests. */
+export interface ReviewDeps {
+    readonly readCredential: (repoRoot: string) => RepoCredential;
+    readonly readReview: (credential: RepoCredential, phase: string) => Promise<ReviewRead>;
+    readonly sendAnswer: (credential: RepoCredential, phase: string, body: {
+        part: string;
+        answer: string;
+    }) => Promise<AnswerSend>;
+    readonly recordShown: (engagementId: string, entry: ShownReviewEntry) => ShownReviewWrite;
+    readonly now: () => Date;
+}
+/**
+ * `review <phase> --show`. Exit 0 when the listing is printed and recorded. A view with
+ * no open review prints RV8 and exits 1; a failed write prints the listing, then RV11,
+ * and exits 1.
+ */
+export declare function runReviewShow(repoRoot: string, phase: string, deps: ReviewDeps): Promise<SystemRun>;
+/**
+ * What checking the answer on this computer came to: the request to send, the line for
+ * a refused answer, or `usage` for a part that is not a part id.
+ */
+export type AnswerCheck = {
+    ok: true;
+    body: {
+        part: string;
+        answer: string;
+    };
+} | {
+    ok: false;
+    line: string;
+} | {
+    ok: false;
+    usage: true;
+};
+/**
+ * Check the answer by the wire's own rule (`reviewAnswerRequestSchema`) before anything
+ * is sent (AC6). A credential-shaped answer is AN4, whatever else is wrong with it, so
+ * the person is told to take the secret out; any other problem with the answer is AN3.
+ */
+export declare function checkAnswer(part: string, answer: string): AnswerCheck;
+/**
+ * `review <phase> --answer <part> "<answer>"`. Exit 0 when the answer is recorded (AN1,
+ * naming the part from the answer's `recorded`, with no second read); exit 1 for every
+ * refusal; exit 2 for a part that is not a part id, which is usage.
+ */
+export declare function runReviewAnswer(repoRoot: string, phase: string, part: string, answer: string, deps: ReviewDeps): Promise<{
+    stdout: string;
+    stderr: string;
+    exitCode: 0 | 1 | 2;
+}>;
+//# sourceMappingURL=review.d.ts.map

package/dist/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../src/review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,EAKL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAaL,KAAK,eAAe,EAGpB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,iGAAiG;AACjG,eAAO,MAAM,YAAY,gGAA8F,CAAC;AAExH,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAC,CAAC;AAElF,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAIvE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvG;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAElB,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAkCnE;AAWD,wDAAwD;AACxD,eAAO,MAAM,SAAS,6GAA6G,CAAC;AAoBpI;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBtE;AAgGD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,CAO/D;AAED,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,GAAG,MAAM,CAQlG;AAED,mCAAmC;AACnC,eAAO,MAAM,QAAQ,8HAAqF,CAAC;AAE3G,mCAAmC;AACnC,eAAO,MAAM,SAAS,sHAC+F,CAAC;AAEtH,yEAAyE;AACzE,eAAO,MAAM,SAAS,qIAC8G,CAAC;AAIrI,sCAAsC;AACtC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,mDAAmD;AACnD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,yDAAyD;AACzD,eAAO,MAAM,QAAQ,yGAAyG,CAAC;AAE/H,8DAA8D;AAC9D,eAAO,MAAM,QAAQ,uHACiG,CAAC;AAEvH,4CAA4C;AAC5C,eAAO,MAAM,QAAQ,gGAAgG,CAAC;AAItH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAiBtF;AAED,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAa/G;AAID,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAKtF;AAED,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAIvH;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsB/F;AAED,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,cAAc,EAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC,OAAO,CAAC,UAAU,CAAC,CAiCrB;AAID,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC;IAC9D,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACxF,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAChI,QAAQ,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;IAC1F,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC;CAC1B;AAeD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAazG;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAKrE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,CAAC,CAsBlE"}

package/dist/shown-record.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The shown record's I/O on this machine — the one place the CLI writes
+ * `~/.halfcycle/engagements/<id>/shown-plans.json`.
+ *
+ * Two verbs write it: `plan <phase> --show` (a shown plan, `writeShownPlan` in
+ * `plan.ts`) and `review <phase> --show` (a listed review, `writeShownReview` in
+ * `review.ts`). Both go through `updateShownRecord`, which reads the WHOLE record,
+ * lets the caller replace its own half, and writes the whole record back, so listing
+ * a plan never drops a listed review and listing a review never drops a shown plan.
+ * A second writer with its own read-modify-write would be the way one verb erases
+ * the other's entry.
+ *
+ * The one other write is the runner's prompt hook, which may not import this module
+ * (INV-001): after a typed review line is recorded it moves THAT listed review forward
+ * (`packages/runner/src/hooks/shown-record.ts`, `typed-close-review` S-v). It is built
+ * the same way, replaces only the one review entry it was sent from, and writes nothing
+ * when that entry was listed again meanwhile.
+ *
+ * The format is `@halfcycle/core`'s (`parseShownRecord`, `serialiseShownRecord`),
+ * never restated here; this module keeps only the I/O. A missing or malformed record
+ * reads as nothing shown.
+ *
+ * Written to a temporary file in the same folder, mode `0600` set on it before the
+ * rename (a rename carries the source's bits), then renamed into place, so a reader
+ * sees the old record or the new one and never a part of one. `chmod` is skipped on
+ * Windows, where the bits mean nothing.
+ *
+ * INV-001: Node builtins and `@halfcycle/core` only. Machine state under the home
+ * folder; nothing is written into the person's project (INV-019).
+ */
+import { type ShownRecord } from '@halfcycle/core';
+/** What updating the shown record came to: on success, the whole record now written. */
+export type ShownRecordWrite = {
+    ok: true;
+    record: ShownRecord;
+} | {
+    ok: false;
+};
+/**
+ * Read the shown record for `engagementId`, pass it to `update`, and write what
+ * `update` returns. Never throws: an engagement id `engagementStateDir` refuses, a
+ * record the serialiser refuses, or any failed write answers `{ ok: false }`, and a
+ * temporary file left behind is removed.
+ */
+export declare function updateShownRecord(engagementId: string, update: (current: ShownRecord) => ShownRecord, home?: string): ShownRecordWrite;
+//# sourceMappingURL=shown-record.d.ts.map

package/dist/shown-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shown-record.d.ts","sourceRoot":"","sources":["../src/shown-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,EAAgE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGjH,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAEjF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,WAAW,EAC7C,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CA6BlB"}

package/dist/system-report.d.ts

@@ -97,14 +97,17 @@ export declare function unownedPatterns(description: SystemDescription, tracked:
 export declare function unownedPatternLines(unowned: readonly UnownedPattern[], verb: DescriptionVerb): string;
 /**
  * What came of reporting the description. `recorded`: the service holds it as
- * `version` (a description it already had returns that version). `refused`: the
- * service's own problems. `no-route`: this service cannot take a description yet.
- * `unavailable`: it could not be reported, and `why` says so.
+ * `version` (a description it already had returns that version; `unchanged` tells the
+ * two apart by the service's status, 200 for unchanged and 201 for a new version,
+ * and is absent from a stand-in that never sets it). `refused`: the service's own
+ * problems. `no-route`: this service cannot take a description yet. `unavailable`:
+ * it could not be reported, and `why` says so.
  */
 export type ReportOutcome = {
     kind: 'recorded';
     version: number;
     reportedAt: string;
+    unchanged?: boolean;
 } | {
     kind: 'refused';
     problems: SystemDescriptionProblem[];
@@ -151,6 +154,7 @@ export type DescriptionStage = {
     version: number;
     credential: RepoCredential;
     warnings: string;
+    unchanged?: boolean;
 };
 /** The verbs that report the description first. Names the prefix of every line. */
 export type DescriptionVerb = 'system' | 'draw' | 'plan';
@@ -160,6 +164,21 @@ export type DescriptionVerb = 'system' | 'draw' | 'plan';
  * description here; `draw` ignores the argument.
  */
 export type BeforeSend = (description: SystemDescription) => string | null;
+/** What reading the credential came to, or the one line every verb prints for it missing. */
+export type CredentialRead = {
+    ok: true;
+    credential: RepoCredential;
+} | {
+    ok: false;
+    line: string;
+};
+/**
+ * Read this project's credential, worded for the verb that is running. Shared by
+ * `checkAndReportDescription` and by `draw phase`'s closed arm (`part-state-and-builds`
+ * AC5), which reads it before the description stage, so the sentence for "not
+ * connected on this machine" has one home.
+ */
+export declare function readCredentialOrLine(repoRoot: string, deps: Pick<SystemDeps, 'readCredential'>, verb: DescriptionVerb): CredentialRead;
 /**
  * READ, CHECK, WARN, REPORT — the one path `system`, `draw` and `plan` take before
  * anything else (feature `diagram-files-for-docs`, step 1 and 2 of the command). The
@@ -174,6 +193,11 @@ export type BeforeSend = (description: SystemDescription) => string | null;
  * the line to print, or `null` to go on.
  */
 export declare function checkAndReportDescription(repoRoot: string, deps: SystemDeps, verb: DescriptionVerb, beforeSend?: BeforeSend): Promise<DescriptionStage>;
-/** The whole `system` verb: the shared stage, then its version printed. */
+/**
+ * The whole `system` verb: the shared stage, then its version printed. U1
+ * (feature `what-halfcycle-saw`): when the description equalled the latest
+ * version and nothing was stored, this prints that it is unchanged rather than
+ * a line that reads like a second version.
+ */
 export declare function runSystem(repoRoot: string, deps: SystemDeps): Promise<SystemRun>;
 //# sourceMappingURL=system-report.d.ts.map

package/dist/system-report.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "halfcycle",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "Your coding agents are the engineers. Halfcycle is the rest of the team: product owner, architect, planner and independent reviewer for Claude Code.",
   "keywords": [
     "claude",

package/dist/project-page.d.ts

@@ -1,24 +0,0 @@
-/**
- * The project's page on the dashboard — one address, built in one place.
- *
- * Two surfaces hand it out. The sign-in completion page sends the person's browser
- * there once a join knows the project (`loopback-signin.ts`). The committed pin records
- * it so a session reading the repository can give the person the link without guessing
- * — before the pin carried it, the only copy was a line of installer output in a
- * terminal the session never sees, and a cold session searching the repository for it
- * guessed two addresses on the wrong host.
- *
- * THE ID MUST BE AN ENGAGEMENT ID OR THERE IS NO ADDRESS. Anything `isEngagementId`
- * refuses — absent, empty, or carrying characters a UUID does not — yields `undefined`,
- * and each caller decides its own fallback. `isEngagementId` stays the shape's one home.
- *
- * The address carries no credential and never the installer's first-visit code. The
- * dashboard decides what a visitor sees: someone signed in to Halfcycle in that browser
- * reaches the project, and someone who is not is refused. It is the same for every clone
- * of the repository, because it is built from nothing but the engagement id and a
- * constant.
- *
- * INV-001: `@halfcycle/core` and `@halfcycle/events` only.
- */
-export declare function projectPageUrl(engagementId: string | undefined): string | undefined;
-//# sourceMappingURL=project-page.d.ts.map

package/dist/project-page.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"project-page.d.ts","sourceRoot":"","sources":["../src/project-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAInF"}