gswd 1.0.1 → 1.1.0

package/lib/state.ts

@@ -43,6 +43,18 @@ export interface IdRegistry {
   allocated_ranges: Record<string, IdRange[]>;
 }
 
+export interface ManualModeState {
+  enabled: boolean;
+  reruns: {
+    imagine: number;
+    specify: number;
+    audit: number;
+    compile: number;
+  };
+  last_checkpoint_stage: string | null;
+  interrupt_type: 'mid_stage' | 'between_stages' | null;
+}
+
 export interface GswdState {
   version: number;
   project_slug: string;
@@ -51,6 +63,7 @@ export interface GswdState {
   stage: 'init' | 'imagine' | 'specify' | 'audit' | 'compile' | 'done';
   stage_status: StageStatus;
   last_checkpoint: Checkpoint | null;
+  first_run_complete?: boolean;
   auto: {
     enabled: boolean;
     policy: 'strict' | 'balanced' | 'aggressive';
@@ -63,8 +76,14 @@ export interface GswdState {
     paid_integrations: PaidIntegration[];
   };
   id_registry?: IdRegistry;
+  manual_mode?: ManualModeState;
 }
 
+// ─── Stage Order ─────────────────────────────────────────────────────────────
+
+export const STAGE_ORDER = ['imagine', 'specify', 'audit', 'compile'] as const;
+export type StageName = typeof STAGE_ORDER[number];
+
 // ─── Atomic File I/O ─────────────────────────────────────────────────────────
 
 /**
@@ -137,6 +156,7 @@ export function createDefaultState(projectSlug: string): GswdState {
       compile: 'not_started',
     },
     last_checkpoint: null,
+    first_run_complete: false,
     auto: {
       enabled: false,
       policy: 'balanced',
@@ -148,6 +168,12 @@ export function createDefaultState(projectSlug: string): GswdState {
       data_store: 'unapproved',
       paid_integrations: [],
     },
+    manual_mode: {
+      enabled: false,
+      reruns: { imagine: 0, specify: 0, audit: 0, compile: 0 },
+      last_checkpoint_stage: null,
+      interrupt_type: null,
+    },
   };
 }
 
@@ -303,3 +329,92 @@ export function resetIdRegistry(statePath: string): void {
   state.id_registry = { allocated_ranges: {} };
   writeState(statePath, state);
 }
+
+// ─── Manual Mode ──────────────────────────────────────────────────────────────
+
+/**
+ * Mark all stages downstream of the re-run stage as 'not_started'.
+ * Also increments the re-run counter for the given stage.
+ * Performs a single atomic STATE.json write.
+ */
+export function cascadeInvalidate(statePath: string, fromStage: StageName): void {
+  const state = readState(statePath);
+  if (!state) {
+    throw new Error(`Cannot read STATE.json at ${statePath}`);
+  }
+
+  const idx = STAGE_ORDER.indexOf(fromStage);
+  if (idx === -1) return;
+
+  // Invalidate all downstream stages
+  for (let i = idx + 1; i < STAGE_ORDER.length; i++) {
+    (state.stage_status as unknown as Record<string, string>)[STAGE_ORDER[i]] = 'not_started';
+  }
+
+  // Ensure manual_mode exists
+  if (!state.manual_mode) {
+    state.manual_mode = {
+      enabled: false,
+      reruns: { imagine: 0, specify: 0, audit: 0, compile: 0 },
+      last_checkpoint_stage: null,
+      interrupt_type: null,
+    };
+  }
+
+  // Increment re-run counter for this stage
+  state.manual_mode.reruns[fromStage] = (state.manual_mode.reruns[fromStage] || 0) + 1;
+
+  // Single atomic write (re-run count + cascade in one operation)
+  writeState(statePath, state);
+}
+
+/**
+ * Update the manual mode checkpoint tracking in STATE.json.
+ * Called when entering or completing a stage boundary checkpoint.
+ */
+export function updateManualCheckpoint(
+  statePath: string,
+  stage: StageName | null,
+  interruptType: 'mid_stage' | 'between_stages' | null,
+): void {
+  const state = readState(statePath);
+  if (!state) {
+    throw new Error(`Cannot read STATE.json at ${statePath}`);
+  }
+
+  if (!state.manual_mode) {
+    state.manual_mode = {
+      enabled: false,
+      reruns: { imagine: 0, specify: 0, audit: 0, compile: 0 },
+      last_checkpoint_stage: null,
+      interrupt_type: null,
+    };
+  }
+
+  state.manual_mode.last_checkpoint_stage = stage;
+  state.manual_mode.interrupt_type = interruptType;
+  writeState(statePath, state);
+}
+
+/**
+ * Set manual mode enabled/disabled in STATE.json.
+ */
+export function setManualMode(statePath: string, enabled: boolean): void {
+  const state = readState(statePath);
+  if (!state) {
+    throw new Error(`Cannot read STATE.json at ${statePath}`);
+  }
+
+  if (!state.manual_mode) {
+    state.manual_mode = {
+      enabled,
+      reruns: { imagine: 0, specify: 0, audit: 0, compile: 0 },
+      last_checkpoint_stage: null,
+      interrupt_type: null,
+    };
+  } else {
+    state.manual_mode.enabled = enabled;
+  }
+
+  writeState(statePath, state);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gswd",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "type": "commonjs",
   "description": "Get Shit Well Done — CLI meta-prompting and spec-generation system",
   "bin": {
@@ -13,7 +13,8 @@
     "lib/",
     "templates/",
     "agents/",
-    "commands/"
+    "commands/",
+    "dist/"
   ],
   "scripts": {
     "postinstall": "node ./bin/install.js",

package/templates/gswd/DECISIONS.template.md

@@ -1,5 +1,8 @@
 # Decisions
 
+## Vision
+<!-- GSWD:CONTENT - Aspirational future state the product enables -->
+
 ## Frozen Decisions
 <!-- GSWD:CONTENT - Minimum 8 frozen decisions required -->