@pmelab/gtd 60.1.0 → 62.0.0

package/src/wire/types.ts

@@ -10,6 +10,9 @@ export type StateName = string
 /** The three content kinds a state can carry — exactly one per state. */
 export type ContentKind = "script" | "prompt" | "message"
 
+/** What a pin or unpin beat does to the pin; a driver may do it its own way instead of running the script. */
+export type PinMark = "add" | "remove"
+
 /** The name of a steering-file mode. Not a closed vocabulary: the valid set derives from the active definition (`BUILT_IN_MODES` plus whatever `modes:` declares). */
 export type StateMode = string
 
@@ -51,4 +54,5 @@ export interface RenderedDemandSource {
   readonly judge?: string
   readonly skills?: readonly string[]
   readonly access?: StepAccess
+  readonly pin?: PinMark
 }

package/src/workflow/fingerprint.ts

@@ -7,12 +7,12 @@ export type ConfigFingerprint = Readonly<Record<string, string>>
 
 const HASH_LENGTH = 16
 
-// A path the trailer cannot carry printably is never recorded, so it can never
+// A path with a control character is never recorded, so it can never
 // reach a terminal from history.
 // eslint-disable-next-line no-control-regex -- the control range IS the point
 const CONTROL_CHARACTER = /[\x00-\x1f\x7f-\x9f]/
 
-export const contentHash = (content: string | Buffer): string =>
+const contentHash = (content: string | Buffer): string =>
   createHash("sha256").update(content).digest("hex").slice(0, HASH_LENGTH)
 
 const realOr = (path: string): string => {

package/src/workflow/index.ts

@@ -33,5 +33,5 @@ export {
   type StateMode,
   type StateName,
 } from "./Workflow.js"
-export { changedConfigFiles, contentHash, type ConfigFingerprint } from "./fingerprint.js"
-export { EngineCore, pin, readPin } from "./pin.js"
+export type { ConfigFingerprint } from "./fingerprint.js"
+export { EngineCore, pin, pinHeader, PIN_FORMAT, readPin } from "./pin.js"

package/src/workflow/load.ts

@@ -17,7 +17,7 @@ import { Host, Workspace, type WorkspaceOps } from "../platform/index.js"
 import { compileConfig, type CompiledConfig } from "./compile.js"
 import { SETTING_NAME_RULE, isSettingName } from "./vars.js"
 import { ConfigDiscovery, WORKFLOW_MODULE, type WorkflowModule } from "./discovery.js"
-import { configFingerprint, type ConfigFingerprint } from "./fingerprint.js"
+import { changedConfigFiles, configFingerprint, type ConfigFingerprint } from "./fingerprint.js"
 import { PIN_KEY } from "../install/index.js"
 import {
   dedupeDiagnostics,
@@ -50,6 +50,8 @@ export interface ConfigOperations {
   readonly warnings: readonly Diagnostic[]
   /** The content hash of every file `gtd.config.ts`'s evaluation touched — itself plus any relative import — by path relative to the root. */
   readonly fingerprint: ConfigFingerprint
+  /** Inside a pin, the files it was bundled from that differ on disk now. */
+  readonly drift: readonly string[]
 }
 
 // Everything lives in `message` (not `GtdError.detail`) — `renderFailure`
@@ -204,6 +206,17 @@ export const load: Effect.Effect<
     fingerprint:
       pinned?.fingerprint ??
       configFingerprint(loaded.file.dependencyFiles, host.root, module.read ?? readFromDisk),
+    drift:
+      pinned === undefined
+        ? []
+        : changedConfigFiles(
+            pinned.fingerprint,
+            configFingerprint(
+              Object.keys(pinned.fingerprint).map((file) => resolvePath(host.root, file)),
+              host.root,
+              readFromDisk,
+            ),
+          ),
   }
 })
 

package/src/workflow/pin.ts

@@ -7,7 +7,7 @@ import { ownPackage, pinnedWorkflowSource } from "./load.js"
 import type { WorkflowModule } from "./discovery.js"
 
 /** Bumped when a launcher could no longer run an older pin the same way. */
-const PIN_FORMAT = 1
+export const PIN_FORMAT = 1
 
 /**
  * The engine a pin carries, as ES module source. Live, the `gtd.core.mjs` the
@@ -57,16 +57,24 @@ export const pin = (
     ])
   })
 
+/** A pin's header line, read without unpacking it; undefined when the bytes are no pin. */
+export const pinHeader = (
+  bytes: Uint8Array,
+): { readonly format: number; readonly version: string } | undefined => {
+  const end = bytes.indexOf(0x0a)
+  const header =
+    end < 0 ? null : /^gtdpin (\d+) gtd (\S+)$/.exec(Buffer.from(bytes.subarray(0, end)).toString())
+  return header === null ? undefined : { format: Number(header[1]), version: header[2]! }
+}
+
 /** A pin's header and module source. */
 export const readPin = (
   bytes: Uint8Array,
 ): { readonly format: number; readonly version: string; readonly source: string } => {
-  const end = bytes.indexOf(0x0a)
-  const header = /^gtdpin (\d+) gtd (\S+)$/.exec(Buffer.from(bytes.subarray(0, end)).toString())
-  if (end < 0 || header === null) throw new Error("not a gtd pin")
+  const header = pinHeader(bytes)
+  if (header === undefined) throw new Error("not a gtd pin")
   return {
-    format: Number(header[1]),
-    version: header[2]!,
-    source: gunzipSync(bytes.subarray(end + 1)).toString("utf8"),
+    ...header,
+    source: gunzipSync(bytes.subarray(bytes.indexOf(0x0a) + 1)).toString("utf8"),
   }
 }