@productbrain/cli 0.1.0-beta.62 → 0.1.0-beta.6201

package/dist/commands/handshake.d.ts

@@ -1,7 +1,30 @@
 /**
  * pb handshake — generate context files for AI developer tools.
- * The fourth delivery surface: context export (GLO-63, DEC-161).
+ * Context export wiring (read-only filesystem bridge; GLO-63, DEC-161) — not a product surface.
  */
+import { type HandshakeReport } from '../formatters/handshake.js';
+import type { WorkspaceHealthResult } from './workspace.js';
+import { classifyDriftBucket, type DriftBucket } from './handshakeDriftClassification.js';
+import { type StartupResolutionSignals } from '../lib/startup-resolution-signals.js';
+import { type SurfaceName } from '../surfaces/registry.js';
+/** Wire-safe alias for a single health gap — derived from the CLI mirror in workspace.ts. */
+export type HealthGap = WorkspaceHealthResult['gaps'][number];
+/** Structured result from probeStarterSetupSeeded when seeds are pending or health is unavailable. */
+export type SeedsPendingResult = {
+    status: 'seeds-pending';
+    gaps: ReadonlyArray<HealthGap>;
+} | {
+    status: 'seeds-ready';
+} | {
+    status: 'probe-failed';
+    error: string;
+};
+/** Single-shot health probe (no internal polling — caller's job, connect-context.ts). Returns
+ *  `seeds-ready`/`seeds-pending` (query ok) or `probe-failed` (query threw). */
+export declare function probeStarterSetupSeeded(): Promise<SeedsPendingResult>;
+/** Poll `probeStarterSetupSeeded` up to MAX_POLLS times (10s @ 500ms); returns the final probe
+ *  result (caller renders it). Exported for connect-context.ts's reuse. */
+export declare function pollUntilSeedsReady(): Promise<SeedsPendingResult>;
 export declare function runHandshakeInit(options?: {
     level?: string;
     dryRun?: boolean;
@@ -9,20 +32,84 @@ export declare function runHandshakeInit(options?: {
 interface HandshakeOptions {
     force?: boolean;
     dryRun?: boolean;
+    /** When true, actually write files. When false (default), show preview plan only. */
+    apply?: boolean;
     level?: string;
     /** When true, suppress all progress output. Used when handshake is called as a sub-step. */
     quiet?: boolean;
     /** When true, fetch governance entries from the Chain and merge generated rules. */
     generate?: boolean;
+    /** Optional caller-provided startup signals, merged with safe local signals. */
+    startupSignals?: Partial<StartupResolutionSignals>;
+    /** Queryable telemetry attribution for the path that invoked this handshake. */
+    invocationPath?: 'session-start' | 'session-close' | 'manual-orient' | 'handshake' | 'unknown';
     /** Target surfaces to write adapter files for. Empty = write all. */
     surfaces?: string[];
+    /** WP-421 S3 (#17): true, or non-TTY stdout, bypasses the adopt-or-revert prompt — tampered
+     *  files go to stderr, a `transition` setup_receipt records the refusal, exit non-zero. */
+    noPrompt?: boolean;
+    /** WP-439 S4: opt out of strict body-fetch mode (default: a fetchAssetBody failure exits
+     *  non-zero with a `pb setup-audit --repair` pointer); downgrades to a warning + skip. */
+    lenient?: boolean;
+}
+/** Dereference a "PR #N" ref to its changed paths via `gh pr diff <N> --name-only` (F4: server
+ *  resolver has no git/gh access). Guarded/time-boxed; `run` is injectable for tests. */
+export declare function dereferencePrRefToPaths(cwd: string, prNumber: number, run?: (cwd: string, command: string, timeoutMs: number) => string | undefined): string[];
+/** Injectable runners for deriveHandshakeStartupSignals — lets tests drive git/gh side effects
+ *  (changed paths, merge-base delta, PR-diff dereference) without real subprocesses. */
+export type HandshakeStartupSignalDeps = {
+    /** Run a read-only git command; undefined on failure. Default: runGitText. */
+    runGit: (cwd: string, command: string) => string | undefined;
+    /** Dereference a PR number to its changed paths (F4). Default: dereferencePrRefToPaths. */
+    prDiff: (cwd: string, prNumber: number) => string[];
+};
+export declare function deriveHandshakeStartupSignals(cwd: string, callerSignals?: Partial<StartupResolutionSignals>, deps?: HandshakeStartupSignalDeps): StartupResolutionSignals;
+/** Normalize volatile handshake-only timestamps before comparing generated files — keeps visible
+ *  timestamps in artifacts while avoiding meaningless rewrites when content is unchanged. */
+export declare function normalizeHandshakeContentForComparison(content: string): string;
+declare function setupAuthoringPath(cwd: string, asset: {
+    entryId: string;
+    name: string;
+    assetKind: string;
+    authoringPath?: string | null;
+}): string | null;
+type AuthoringSyncState = {
+    version: 1;
+    assets: Record<string, {
+        path: string;
+        hash: string;
+    }>;
+};
+declare function loadAuthoringSyncState(productbrainDir: string): AuthoringSyncState;
+export { classifyDriftBucket, type DriftBucket };
+export interface LeftoverProjection {
+    path: string;
+    reason: string;
 }
 /**
- * Normalize volatile handshake-only timestamps before comparing generated files.
- * This keeps the visible timestamps in generated artifacts while avoiding
- * meaningless rewrites when semantic content is unchanged.
+ * findLeftoverProjections — WP-379 S5b
+ *
+ * Lists marker-bearing files under .cursor/rules/, .claude/rules/, .claude/skills/, .codex/skills/
+ * (plus the nested .cursor/skills/<name>/SKILL.md layout) that look stale: orphan (no canonical
+ * asset), stale case/punctuation variant, or a leftover `.dormant` copy. User-owned (no MARKER)
+ * files and unselected `allowedTargets` are never reported.
+ *
+ * Round 12: stops once `LEFTOVER_FILES_MAX + 1` matches are found across the flat + merged
+ * nested-Cursor scan combined — bounds read/enumerate I/O, not just the reported list.
+ * `truncated` says more exist beyond the capped, returned `files`.
+ *
+ * @param cursorSkillNames Cursor-specific, SKILL-kind-only canon (falls back to `assetNames`).
+ * @param exactRelativePaths Round 11: exact write-plan paths (forward-slash), exempted from both
+ *   checks — covers asset-less generated files and a canonical raw name not already normalized.
  */
-export declare function normalizeHandshakeContentForComparison(content: string): string;
-export declare function runHandshake(options?: HandshakeOptions): Promise<void>;
-export {};
+export declare function findLeftoverProjections(cwd: string, assetNames: string[], allowedTargets: Set<SurfaceName>, cursorSkillNames?: string[], exactRelativePaths?: Set<string>): {
+    files: LeftoverProjection[];
+    truncated: boolean;
+};
+export declare function runHandshake(options?: HandshakeOptions): Promise<HandshakeReport | undefined>;
+export declare const __test: {
+    setupAuthoringPath: typeof setupAuthoringPath;
+    loadAuthoringSyncState: typeof loadAuthoringSyncState;
+    MARKER: string;
+};
 //# sourceMappingURL=handshake.d.ts.map

package/dist/commands/handshake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/commands/handshake.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsMH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiGxG;AACD,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO9E;AAsBD,wBAAsB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgYhF"}
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/commands/handshake.ts"],"names":[],"mappings":"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"}