@hobocode/thought-layer 0.6.1 → 0.7.0

package/extensions/thought-layer.ts

@@ -9,7 +9,7 @@ import {
   aggregateConfidence, statusFromConfidence, gradeFromConfidence,
   checkDomains, registrarSearchUrl,
   computeProjection, fmtMoney,
-  applyStateOp, runScaffold, runDeploy,
+  applyStateOp, runScaffold, runDeploy, runSync,
   type Assumptions, type StateOp,
 } from "../core/index.ts";
 
@@ -237,4 +237,35 @@ export default function (pi: ExtensionAPI) {
       return text(r.message, r.details);
     },
   });
+
+  // tl_sync: store and sync session files in the user's OWN private GitHub repo.
+  // Git is transport + history + multi-user; the kit reconciles concurrent edits
+  // itself. Collaboration is granted on GitHub (the kit never changes permissions).
+  pi.registerTool({
+    name: "tl_sync",
+    label: "Thought Layer: sync sessions",
+    description:
+      "Store and sync your Thought Layer session files in your OWN private GitHub repo (BYOK, no central account). " +
+      "ops: init (set a repo as a sessions workspace), save (snapshot the current state as a named session, commit, push), list, open (pull and resume a session), pull (reconcile remote edits), push, status. " +
+      "Each session is one .thought-layer/<name>.json in the repo; save prompts you for a human name. Git carries history and multi-user; the kit reconciles concurrent edits itself (newest wins per field, conflicts reported), so it never hand-merges JSON. " +
+      "Collaboration is granted on GitHub: you add collaborators to the repo, the kit never changes permissions. Needs git installed (gh optional, used to create a repo).",
+    parameters: Type.Object({
+      op: Type.String({ description: "init | save | list | open | pull | push | status" }),
+      name: Type.Optional(Type.String({ description: "Session name (save/open) or workspace label (init). A human name, slugged to <name>.json." })),
+      repo: Type.Optional(Type.String({ description: "init only: the private GitHub repo to use (owner/name or a URL)." })),
+      dir: Type.Optional(Type.String({ description: "Explicit clone dir for the workspace (overrides the configured one)." })),
+      workspace: Type.Optional(Type.String({ description: "Select an existing workspace by its label." })),
+      message: Type.Optional(Type.String({ description: "Commit message for save/push." })),
+      noPush: Type.Optional(Type.Boolean({ description: "save/push: commit locally without pushing." })),
+      path: Type.Optional(Type.String({ description: "save: the current working state file to snapshot (defaults to the session default)." })),
+    }),
+    async execute(_id, params): Promise<ToolResult> {
+      const p = params as { op: string; name?: string; repo?: string; dir?: string; workspace?: string; message?: string; noPush?: boolean; path?: string };
+      const r = await runSync(
+        { op: p.op, name: p.name, repo: p.repo, dir: p.dir, workspace: p.workspace, message: p.message, noPush: p.noPush, path: p.path },
+        { ts: Date.now(), exportedAt: new Date().toISOString() },
+      );
+      return text(r.message, r.details);
+    },
+  });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hobocode/thought-layer",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "The Thought Layer: rigor for building. Validate an idea, grill it into a buildable spec, then build and deploy it, inside the agent you already use. BYOK, no telemetry.",
   "license": "MIT",
   "author": "Hobocode LLC <jerm@hobocode.net>",
@@ -64,6 +64,9 @@
     "core/stage-map.ts",
     "core/state-file.ts",
     "core/state-ops.ts",
+    "core/merge.ts",
+    "core/sync.ts",
+    "core/sync-io.ts",
     "core/backend.ts",
     "core/backend-io.ts",
     "core/scaffold.ts",

package/skills/thought-layer-framework/SKILL.md

@@ -59,6 +59,15 @@ No one finishes this in one sitting. The work lives in a portable file, `.though
 
 **At session end or handoff,** run `export` to confirm the file is current, and tell the founder where it is and that they (or a collaborator) can load it into the web app or keep going with the agent.
 
+## Sync and collaborate (optional: a private GitHub repo as the home for sessions)
+
+For founders juggling several ideas, or collaborating with others, the session files can live in the user's OWN private GitHub repo instead of just locally. The `tl_sync` tool (Pi) or `tl sync` (any shell) manages it, BYOK with no central account:
+- `tl sync init --repo <owner/name>` sets a private repo as a sessions workspace (one repo for the user's own projects, a separate repo per outside founder they help, so each stays isolated).
+- `tl sync save --name <name>` snapshots the current state as a named session (photobooth, peptide, blogging), commits, and pushes. `tl sync list` lists them; `tl sync open --name <name>` pulls and resumes one (it prints the `THOUGHT_LAYER_STATE` line to point the rest of the session at that file).
+- Collaboration is granted on GitHub: the user adds collaborators to the repo themselves; the kit never changes permissions. When two people edit the same session, the kit reconciles the two copies itself (newest wins per field, any coarse tie-break is reported), so git never has to merge the JSON by hand.
+
+This is optional. The local default (`.thought-layer/state.json`) and the web-app handoff above work exactly as before without it.
+
 ## Part 1: Validate the idea
 
 Altitude: is the idea clear, honest, real, and worth pursuing? Not how it will be built.