@nanonets/graft 0.24.0 → 0.25.0

package/dist/cloud/workspace-sync.d.ts

@@ -1,16 +1,66 @@
 import { type ActivityEvent, type ApiError, type Cloud, type UploadedLearning } from "./workspace.js";
+/** A learning that stays off the workspace, and why, for `trail workspace` to name. */
+export interface LeftOut {
+    /** Its file name in `.trail/learnings/`. */
+    name: string;
+    /** "" when committed at HEAD, else the pushed branch it's on. */
+    ref: string;
+    /** What `secretReason` saw: "an API key", "a password in a URL". Never the secret. */
+    why: string;
+}
 /**
- * Every learning in the repo's `.trail/`, as the workspace takes them: the
- * working tree's, then the ones only a pushed branch has (from the branch
- * cache). Paths are repo-relative; nothing about this machine is sent.
+ * Every live learning in the repo's `.trail/`, as the workspace takes them:
+ * the ones committed at HEAD, then the ones only a pushed branch has (from
+ * the branch cache), then the repo's skills that git tracks (`skillItems`).
+ * Never the working tree's learnings: an uncommitted or untracked learning
+ * stays on this machine. Paths are repo-relative; nothing about this
+ * machine is sent. Null when git couldn't read HEAD: then nothing may go up,
+ * since a set without HEAD's learnings would tell the workspace they're gone.
+ *
+ * Live means what recall reads (`liveLearnings`): a retired, held or replaced
+ * learning stays behind, so the team page never shows one nobody is meant to
+ * follow. A learning on an unmerged branch replaces nothing yet.
+ *
+ * A learning or skill whose text holds a secret (`secretReason`) stays behind, every
+ * copy of it: what a sync sent is what vouches for a learning's name in a
+ * use, so its name never goes up either. It is listed in `leftOut`, so
+ * `trail workspace` can say so instead of it going missing in silence.
+ *
+ * `tree`: the working tree's learnings in place of HEAD's, for `init --pair`'s
+ * review page only, which shows the person what init just wrote before any of
+ * it is committed. A sync never reads them.
+ */
+export declare function workspaceLearnings(checkout: string, opts?: {
+    tree?: boolean;
+}): {
+    learnings: UploadedLearning[];
+    leftOut: LeftOut[];
+} | null;
+/**
+ * What `init --pair` hands its review page: the working tree's live learnings
+ * (what the person's agents start from, the ones init just wrote among them),
+ * teammates' pushed ones and the repo's tracked skills, secrets left out.
+ */
+export declare function reviewPayload(checkout: string): UploadedLearning[];
+/** The learnings a sync uploads: `workspaceLearnings` without what it left out. Null when git couldn't read HEAD. */
+export declare function learningsPayload(checkout: string): UploadedLearning[] | null;
+/**
+ * Whether the repo at `checkout` is one of the workspace's, so its learnings
+ * and uses go up. Never on a machine connected by `trail init --connect`: that
+ * one sends a repo summary only (titles and counts, no learning bodies, no
+ * searches), whatever repos the workspace lists.
  */
-export declare function learningsPayload(checkout: string): UploadedLearning[];
-/** Whether the repo at `checkout` is one of the workspace's. */
 export declare function inWorkspace(checkout: string, cloud?: Cloud | null): boolean;
 /**
  * Upload the repo's learnings now, after fetching teammates' branches. Only for
  * a repo in the workspace. Remembers what was sent so an unchanged repo isn't
- * sent again.
+ * sent again. When git can't read HEAD nothing is sent and the sync counts as
+ * failed, so it's tried again later.
+ *
+ * A learning or skill HEAD had at the last sync on this same branch, and no
+ * longer has (deleted, or now left out for a secret), is sent as removed, so
+ * it comes down from the web. On another branch a missing file says nothing,
+ * so switching branches never takes anything down.
  */
 export declare function syncRepo(checkout: string, cloud: Cloud, opts?: {
     fetch?: boolean;
@@ -20,30 +70,44 @@ export declare function syncRepo(checkout: string, cloud: Cloud, opts?: {
     learnings: number;
     added: number;
 } | ApiError>;
+/** `.claude/skills/<name>/SKILL.md` → `<name>`; "" for any other path. */
+export declare function repoSkillName(path: string): string;
 /** Sync every repo of the workspace that's on this machine. Returns what went up. */
 export declare function syncWorkspaceRepos(cloud: Cloud, fetchImpl?: typeof fetch): Promise<{
     repos: number;
     learnings: number;
 }>;
+/** Whether uses of `repo` are recorded at all: connected by `pair`/login (not `connect`) and the repo is the workspace's. */
+export declare function records(cloud: Cloud | null, repo: string): cloud is Cloud;
+/**
+ * A use as it may be queued or sent, built field by field from what was
+ * handed in. Anything else is left behind: an older trail queued the query
+ * (for the prompt hook, the person's whole prompt) and the file paths, and
+ * neither may reach the outbox or Trail. Null when it isn't a use at all.
+ */
+export declare function activityEvent(raw: unknown): ActivityEvent | null;
 /**
  * Remember one use of the learnings, to send with the next sync: only while
  * this machine is connected, and only for a repo in the workspace. Not
  * connected, or another repo, and nothing is written. Never throws.
  */
-export declare function recordActivity(e: ActivityEvent, cloud?: Cloud | null): void;
+export declare function recordActivity(use: ActivityEvent, cloud?: Cloud | null): void;
 /**
- * Forget every use waiting to go. Run when a machine connects, so nothing
- * recorded before that is ever sent.
+ * Forget every use waiting to go, and what an earlier connection was sent.
+ * Run when a machine connects, so nothing recorded before that is ever sent,
+ * and only what this connection uploads vouches for a learning's name.
  */
 export declare function dropActivity(env?: NodeJS.ProcessEnv): void;
 /**
  * Send the outbox. It's moved aside first, so events recorded while the
  * request is out land in a fresh file; on failure they're put back. A use
  * from before this connection, or for a repo the workspace doesn't have
- * (left by an older trail), is dropped, never sent.
+ * (left by an older trail), is dropped, never sent; so is the name of any
+ * learning the workspace didn't get from this machine's last upload of that
+ * repo, put back or sent.
  */
 export declare function flushActivity(cloud: Cloud, fetchImpl?: typeof fetch): Promise<number>;
-/** Whether the repo's learnings changed since they last went up, and a retry is due. */
+/** Whether the repo's learnings changed since they last went up, and a retry is due. Never while git can't read HEAD. */
 export declare function syncIsDue(checkout: string, now?: number): boolean;
 /**
  * Sync in a detached child when this machine is connected and either the

package/dist/cloud/workspace-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-sync.d.ts","sourceRoot":"","sources":["../../src/cloud/workspace-sync.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAqD,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAYzJ;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA4BrE;AAiBD,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,KAAK,GAAG,IAAkB,GAAG,OAAO,CAExF;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACvD,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAAC,CAUxE;AAED,qFAAqF;AACrF,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAY9H;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,GAAE,KAAK,GAAG,IAAkB,GAAG,IAAI,CAYxF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAMvE;AAUD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC3F;AAMD,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO,CAIrE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO,CAgB5E;AAED,qDAAqD;AACrD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7D;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD"}
+{"version":3,"file":"workspace-sync.d.ts","sourceRoot":"","sources":["../../src/cloud/workspace-sync.ts"],"names":[],"mappings":"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"}