@hobocode/thought-layer 0.7.0 → 0.8.5

package/core/progress.ts

@@ -21,10 +21,10 @@ export const PROGRESS_FORMAT = 2;
 
 export const KNOWN_STATE_KEYS = [
   "version", "answers", "feedback", "bizModel", "grill",
-  "assets", "research", "swot", "prd", "naming", "brand", "kit",
+  "assets", "research", "swot", "prd", "naming", "brand", "governance", "kit",
 ] as const;
 
-export type ArtifactKey = "bizModel" | "grill" | "assets" | "research" | "swot" | "prd" | "naming" | "brand";
+export type ArtifactKey = "bizModel" | "grill" | "assets" | "research" | "swot" | "prd" | "naming" | "brand" | "governance";
 
 export interface Writer { kind: "web" | "kit"; version?: string; ts: number; }
 
@@ -81,6 +81,7 @@ export interface ProgressState {
   prd: unknown;
   naming: unknown;
   brand: unknown;
+  governance: unknown;
   kit: KitNamespace | null;
   [extra: string]: unknown;
 }
@@ -99,7 +100,7 @@ export interface ProgressPayload {
 export function emptyState(): ProgressState {
   return {
     version: 2, answers: {}, feedback: {}, bizModel: null, grill: null,
-    assets: null, research: null, swot: null, prd: null, naming: null, brand: null, kit: null,
+    assets: null, research: null, swot: null, prd: null, naming: null, brand: null, governance: null, kit: null,
   };
 }
 
@@ -132,6 +133,7 @@ export function parseProgress(text: string): ProgressPayload {
     prd: s["prd"] ?? null,
     naming: s["naming"] ?? null,
     brand: s["brand"] ?? null,
+    governance: s["governance"] ?? null,
     kit: (s["kit"] as KitNamespace | undefined) ?? null,
   };
   return {
@@ -149,7 +151,7 @@ export function parseProgress(text: string): ProgressPayload {
 export function buildProgress(state: Partial<ProgressState>, writer: Writer, exportedAt: string): ProgressPayload {
   const s = (state || {}) as Record<string, unknown>;
   const {
-    answers, feedback, bizModel, grill, assets, research, swot, prd, naming, brand, kit,
+    answers, feedback, bizModel, grill, assets, research, swot, prd, naming, brand, governance, kit,
     version: _v, exportedAt: _ea, formatNewer: _fn, ...rest
   } = s;
   return {
@@ -170,6 +172,7 @@ export function buildProgress(state: Partial<ProgressState>, writer: Writer, exp
       prd: prd ?? null,
       naming: naming ?? null,
       brand: brand ?? null,
+      governance: governance ?? null,
       kit: (kit as KitNamespace | undefined) ?? null,
       ...rest,
     },
@@ -299,7 +302,7 @@ export function summarizeState(state: ProgressState): StateSummary {
     if (s === "green" || s === "yellow" || s === "red") byStatus[s]++;
     else byStatus.ungraded++;
   }
-  const artifacts = (["bizModel", "grill", "assets", "research", "swot", "prd", "naming", "brand"] as const)
+  const artifacts = (["bizModel", "grill", "assets", "research", "swot", "prd", "naming", "brand", "governance"] as const)
     .filter((k) => state[k] != null);
   const kit = (state.kit && typeof state.kit === "object") ? state.kit : null;
   return {

package/core/state-ops.ts

@@ -12,7 +12,7 @@ import {
   type ArtifactKey, type PersonaInput, type EndState, type KitCursor,
 } from "./progress.ts";
 
-export const ARTIFACT_KEYS: ArtifactKey[] = ["bizModel", "grill", "assets", "research", "swot", "prd", "naming", "brand"];
+export const ARTIFACT_KEYS: ArtifactKey[] = ["bizModel", "grill", "assets", "research", "swot", "prd", "naming", "brand", "governance"];
 const END_STATES: EndState[] = ["open", "pass", "setAside"];
 
 export interface StateOp {

package/core/sync-io.ts

@@ -60,7 +60,7 @@ export function ghAuthed(): boolean {
 function syncConfigPath(): string {
   return process.env["THOUGHT_LAYER_SYNC_CONFIG"] || join(homedir(), ".thought-layer", "sync.json");
 }
-function loadConfig(): SyncConfig {
+export function loadConfig(): SyncConfig {
   const p = syncConfigPath();
   if (!existsSync(p)) return emptySyncConfig();
   try { return parseSyncConfig(readFileSync(p, "utf8")); }
@@ -74,12 +74,14 @@ function saveConfig(cfg: SyncConfig): void {
 
 // ---- git helpers -------------------------------------------------------------
 
-interface Run { status: number; out: string; err: string; }
-function git(dir: string | null, args: string[], timeout = 120000): Run {
+export interface Run { status: number; out: string; err: string; }
+// Exported so the artifacts delivery layer (artifacts-io.ts) reuses the exact
+// same git shell-out plumbing rather than re-implementing spawnSync.
+export function git(dir: string | null, args: string[], timeout = 120000): Run {
   const r = spawnSync("git", dir ? ["-C", dir, ...args] : args, { encoding: "utf8", timeout });
   return { status: r.status ?? 1, out: r.stdout || "", err: r.stderr || "" };
 }
-function isGitRepo(dir: string): boolean {
+export function isGitRepo(dir: string): boolean {
   return existsSync(join(dir, ".git")) && git(dir, ["rev-parse", "--is-inside-work-tree"]).status === 0;
 }
 function dirNonEmpty(dir: string): boolean {
@@ -91,7 +93,7 @@ const absDir = (d: string, cwd = process.cwd()): string => (isAbsolute(d) ? d :
 // ---- the clone scaffolding files written on init -----------------------------
 
 const GITATTRIBUTES = `# The kit reconciles session JSON itself; never let git textually merge it\n# (which would corrupt the envelope). -merge keeps our copy in the working tree\n# on a conflict; the kit then rebuilds the merged result from the clean blobs.\n.thought-layer/*.json -merge\n`;
-const GITIGNORE = `# A Thought Layer sessions repo holds session state only. Built product\n# artifacts and secrets never sync here.\nbuild.json\ndeploy.json\n*.local\n.env\n.env.*\n!.env.example\ndist/\n.netlify/\nnode_modules/\n`;
+const GITIGNORE = `# A Thought Layer sessions repo holds session state only. Built product\n# artifacts and secrets never sync here.\nbuild.json\ndeploy.json\n*.local\n.env\n.env.*\n!.env.example\ndist/\n.netlify/\nnode_modules/\n# Delivered artifacts (tl artifacts) ARE intentionally tracked, even though the\n# same filenames are ignored elsewhere in the tree.\n!artifacts/\n!artifacts/**\n`;
 const README = `# Thought Layer sessions\n\nThis private repo is the home for Thought Layer session files. Each session is one\nfile under \`.thought-layer/<name>.json\` (the portable validation and design state).\nUse the kit to work with them:\n\n    tl sync open --name <session>     pull and resume a session\n    tl sync save --name <session>     snapshot the current state, commit, and push\n    tl sync list                      list the sessions in this repo\n\nCollaboration is handled by GitHub: add a collaborator to this repo in its GitHub\nsettings, and they can clone it and run the kit against the same sessions.\nThe kit reconciles concurrent edits itself (newest wins per field, conflicts are\nreported), so git never has to merge the JSON by hand.\n`;
 
 function writeCloneScaffold(cloneDir: string): void {
@@ -136,7 +138,8 @@ export async function runSync(opts: SyncRunOptions, ctx: { ts: number; exportedA
 }
 
 // Resolve the workspace + clone dir an op targets (everything except init).
-function resolveWorkspace(opts: SyncRunOptions, cfg: SyncConfig): { cloneDir: string; ws: SyncWorkspace | null } {
+// Exported so artifacts-io.ts resolves the same sessions workspace.
+export function resolveWorkspace(opts: SyncRunOptions, cfg: SyncConfig): { cloneDir: string; ws: SyncWorkspace | null } {
   if (opts.dir && opts.dir.trim()) return { cloneDir: absDir(opts.dir), ws: null };
   const env = process.env["THOUGHT_LAYER_SESSIONS_DIR"];
   if (env && env.trim()) return { cloneDir: absDir(env), ws: null };