@zalom/plastic 1.0.0-alpha.2 → 1.0.0-alpha.21

package/scripts/hook-auto-arm

@@ -0,0 +1,52 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Usage: hook-auto-arm <message>
+# UserPromptSubmit arming (intent 27). Two jobs, both additive context — never blocks:
+#   1. Detect auto-trigger phrases -> steer the agent to invoke plastic-auto.
+#   2. If auto mode is armed and the active intent hasn't reached How -> remind the agent
+#      that project-code edits are gate-blocked until plan.md + checklist.md exist.
+# Outputs UserPromptSubmit hookSpecificOutput JSON, or exits silently.
+
+require "json"
+require_relative "lib/bridge"
+
+message = (ARGV[0] || "").downcase
+parts = []
+
+# --- 1. Auto-trigger steering ---
+AUTO_TRIGGERS = ["take it from here", "deliver this", "/plastic-auto", "auto mode"].freeze
+# bare "auto" only as a standalone word to avoid matching "automatic", "automation", etc.
+triggered = AUTO_TRIGGERS.any? { |p| message.include?(p) } || message.match?(/\bauto\b/)
+if triggered
+  parts << "Auto-mode request detected. Invoke the plastic-auto skill to deliver the " \
+           "active intent autonomously — it arms the lifecycle gate so project code " \
+           "cannot be edited before plan.md + checklist.md exist."
+end
+
+# --- 2. Standing gate reminder when armed and pre-How ---
+session = ENV["CLAUDE_SESSION_ID"]
+bridge_data = (session && !session.empty? && File.exist?(Bridge.path(session))) ? Bridge.read(session) : nil
+if bridge_data && bridge_data.dig("build", "auto") == true
+  intent = bridge_data["intent"] || {}
+  store = intent["store"]; dir = intent["dir"]
+  if store && dir
+    intent_dir = File.expand_path("#{store}/#{dir}")
+    reached_how = File.exist?("#{intent_dir}/plan.md") && File.exist?("#{intent_dir}/checklist.md")
+    unless reached_how
+      parts << "Auto mode armed on intent #{intent["id"]} — produce spec -> plan -> " \
+               "checklist before editing project code. Code edits are gate-blocked until then."
+    end
+  end
+end
+
+exit 0 if parts.empty?
+
+payload = {
+  "hookSpecificOutput" => {
+    "hookEventName" => "UserPromptSubmit",
+    "additionalContext" => parts.join("\n")
+  }
+}
+puts JSON.generate(payload)

package/scripts/hook-bash-gate

@@ -0,0 +1,53 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# PreToolUse gate for Bash (intent 27a): close the Bash-edit bypass. When auto
+# mode is armed and the active intent has not reached How (plan.md + checklist.md),
+# block Bash commands that WRITE project code outside the store.
+#
+# Reads the Claude Code PreToolUse payload as JSON on STDIN:
+#   { "tool_input": { "command": "..." }, "cwd": "..." }
+# Empty / unparseable / no command => exit 0 (allow). Conservatism is the prime
+# directive: when a command's write intent is ambiguous, ALLOW.
+#
+# Exit 0 = allow. Exit 2 = block (reason on stderr, shown to the agent).
+
+require "json"
+require_relative "lib/bridge"
+
+raw = $stdin.read rescue nil
+exit 0 if raw.nil? || raw.strip.empty?
+
+payload = JSON.parse(raw) rescue nil
+exit 0 unless payload.is_a?(Hash)
+
+command = payload.dig("tool_input", "command") || payload.dig("tool_params", "command")
+exit 0 if command.nil? || command.to_s.strip.empty?
+
+cwd = payload["cwd"]
+cwd = Dir.pwd if cwd.nil? || cwd.to_s.empty?
+
+# --- Load bridge (mirror hook-code-gate resolution) ---
+session = ENV["CLAUDE_SESSION_ID"]
+bridge_data = nil
+
+if session && !session.empty?
+  bridge_data = Bridge.read(session) if File.exist?(Bridge.path(session))
+end
+
+unless bridge_data
+  candidates = Dir.glob("/tmp/plastic-*.json").reject { |f| f.end_with?(".tmp") }
+  if candidates.any?
+    newest = candidates.max_by { |f| File.mtime(f) }
+    bridge_data = JSON.parse(File.read(newest)) rescue nil
+  end
+end
+
+exit 0 unless bridge_data
+
+reason = Bridge.bash_gate_decision(bridge_data, command, cwd: cwd)
+exit 0 unless reason
+
+$stderr.puts "PLASTIC GATE — #{reason}"
+exit 2

package/scripts/hook-code-gate

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Usage: hook-code-gate <file_path>
+# PreToolUse gate (intent 27): when auto mode is armed and the active intent has not
+# reached How (plan.md + checklist.md), block edits to project code outside the store.
+#
+# Exit 0 = allow. Exit 2 = block (reason on stderr, shown to the agent).
+# No bridge / auto not armed / How reached / path under ~/.plastic or the intent dir = allow.
+
+require_relative "lib/bridge"
+
+file_path = ARGV[0]
+exit 0 unless file_path && !file_path.empty?
+
+# --- Load bridge (mirror hook-gate-check resolution) ---
+session = ENV["CLAUDE_SESSION_ID"]
+bridge_data = nil
+
+if session && !session.empty?
+  bridge_data = Bridge.read(session) if File.exist?(Bridge.path(session))
+end
+
+unless bridge_data
+  candidates = Dir.glob("/tmp/plastic-*.json").reject { |f| f.end_with?(".tmp") }
+  if candidates.any?
+    newest = candidates.max_by { |f| File.mtime(f) }
+    bridge_data = JSON.parse(File.read(newest)) rescue nil
+  end
+end
+
+exit 0 unless bridge_data
+
+reason = Bridge.code_gate_decision(bridge_data, file_path)
+exit 0 unless reason
+
+$stderr.puts "PLASTIC GATE — #{reason}"
+exit 2

package/scripts/hook-continue

@@ -1,130 +1,31 @@
 #!/usr/bin/env ruby
 # encoding: UTF-8
 # Usage: hook-continue <index_path> <store_root> <mode>
-# Outputs hook JSON for the continue hook. Exits silently if nothing to show.
+# Renders the dashboard `continue` cockpit as UserPromptSubmit additionalContext.
+# Exits silently (no output) if the dashboard produces nothing — the bash caller
+# then falls back to a minimal notice.
 
 require "json"
-require "date"
-require "yaml"
+require "open3"
 
-index_path, store_root, mode = ARGV
-exit 0 unless index_path && store_root && mode
+index_path, _store_root, _mode = ARGV
+exit 0 unless index_path && File.exist?(index_path)
 
-# --- Parse INDEX.md ---
+dashboard = File.expand_path("dashboard.rb", __dir__)
+exit 0 unless File.exist?(dashboard)
 
-lines = File.readlines(index_path)
-active = []
-future = []
-section = nil
+cockpit, _err, status = Open3.capture3("ruby", dashboard, "continue")
+exit 0 unless status.success? && !cockpit.strip.empty?
 
-lines.each do |line|
-  if line.start_with?("## Active")
-    section = :active
-    next
-  elsif line.start_with?("## Future")
-    section = :future
-    next
-  elsif line.start_with?("## ")
-    section = nil
-    next
-  end
-
-  next unless section && line.strip.start_with?("- [")
-
-  if section == :active
-    active << line.strip
-  elsif section == :future
-    future << line.strip
-  end
-end
-
-# --- Detect stale future intents ---
-
-stale = []
-stale_days = 3
-config_path = "#{store_root}/config.yml"
-if File.exist?(config_path)
-  config = YAML.safe_load(File.read(config_path)) rescue {}
-  stale_days = config["stale_threshold_days"] || 3
-end
-
-future.each do |f|
-  if f =~ /store\/([\w-]+)\//
-    dir_name = $1
-    intent_file = "#{store_root}/store/#{dir_name}/#{dir_name}.md"
-    next unless File.exist?(intent_file)
-
-    content = File.read(intent_file)
-    if content =~ /^created:\s*['"]?(\d{4}-\d{2}-\d{2})/
-      age = (Date.today - Date.parse($1)).to_i
-      if age >= stale_days
-        name = f[/\[([^\]]+)\]/, 1] || "unknown"
-        stale << { name: name, age: age, entry: f }
-      end
-    end
-  end
-end
-
-# --- Detect current project ---
-
-current_project = nil
-if mode == "global"
-  projects_path = "#{store_root}/projects.yml"
-  if File.exist?(projects_path)
-    projects = YAML.safe_load(File.read(projects_path)) rescue {}
-    cwd = Dir.pwd
-    (projects["projects"] || {}).each do |slug, info|
-      project_path = File.expand_path(info["path"])
-      if cwd.start_with?(project_path)
-        current_project = { "slug" => slug, "parent" => info["parent"], "path" => project_path }
-        break
-      end
-    end
-  end
-end
-
-# --- Build context ---
-
-parts = []
-parts << "PLASTIC CONTINUE — The user wants to resume work.\n"
-
-if mode == "global" && current_project
-  parts << "Project: #{current_project["slug"]} (#{current_project["path"]})\n"
-  parts << "Governing intent: #{current_project["parent"]}\n" if current_project["parent"]
-end
-
-if active.any?
-  parts << "## Active Intents (work on these first)\n"
-  active.each { |a| parts << a }
-  parts << ""
-else
-  parts << "## No Active Intents\n"
-end
-
-if future.any?
-  parts << "## Future Intents (offer as next work)\n"
-  future.each { |f| parts << f }
-  parts << ""
-end
-
-if stale.any?
-  parts << "## Stale Future Intents\n"
-  parts << "These future intents have not been actioned. Ask the user what to do with each:\n"
-  stale.each do |s|
-    parts << "- #{s[:name]} (#{s[:age]} days old) — options: activate, abandon, or defer to agent (implement / research / ideate)"
-  end
-  parts << ""
-end
-
-parts << "Follow the plastic:continuing skill workflow.\n"
-parts << "1. If active intents exist: read their state and resume\n"
-parts << "2. If no active intents: present future intents as options\n"
-parts << "3. If stale intents exist: surface them and ask user to decide"
+context = cockpit.rstrip +
+  "\n\nFollow the plastic-continuing skill workflow to resume: " \
+  "if active intents exist, read their state and resume; otherwise offer the " \
+  "Value×Effort matrix items above, surfacing any stale (Nd) / ⚑ triage intents."
 
 payload = {
   "hookSpecificOutput" => {
     "hookEventName" => "UserPromptSubmit",
-    "additionalContext" => parts.join("\n")
+    "additionalContext" => context
   }
 }
 puts JSON.generate(payload)

package/scripts/hook-gate-check

@@ -98,13 +98,21 @@ if is_stage_file || is_action_file
 
   Bridge.write(session, bridge_data)
 
+  # Cycle-step savepoint ledger (intent 34) — record this stage-file milestone.
+  # Best-effort: the ledger is derived sugar, so a failure must never block.
+  begin
+    Bridge.append_savepoint(intent_dir_abs, file_path_abs)
+  rescue StandardError
+    # ignore — rebuildable from disk
+  end
+
   # Build transition context
   stage_labels = { "what" => "What", "why" => "Why", "how" => "How", "exec" => "Exec", "done" => "Done" }
   next_hints = {
     "why" => "write spec.md",
-    "how" => "Why complete. Invoke plastic:auto to deliver autonomously, or write plan.md manually.",
-    "exec" => "How complete. Invoke plastic:auto or plastic:executing-plan to execute, or work through the checklist manually.",
-    "done" => "Exec complete. Intent must be completed now — write outcome.md, update INDEX.md, auto-commit. Use plastic:auto or do it manually."
+    "how" => "Why complete. Invoke plastic-auto to deliver autonomously, or write plan.md manually.",
+    "exec" => "How complete. Invoke plastic-auto or plastic-executing-plan to execute, or work through the checklist manually.",
+    "done" => "Exec complete. Intent must be completed now — write outcome.md, update INDEX.md, auto-commit. Use plastic-auto or do it manually."
   }
 
   context_parts = ["PLASTIC"]
@@ -129,7 +137,14 @@ if is_stage_file || is_action_file
   puts JSON.generate(payload)
   exit 0
 else
-  # Regular file in intent dir — just update last_activity
+  # Regular file in intent dir — just update last_activity. The intent file
+  # (What milestone) lands here, so still offer it to the savepoint ledger;
+  # non-milestone files self-filter to a no-op (intent 34).
+  begin
+    Bridge.append_savepoint(intent_dir_abs, file_path_abs)
+  rescue StandardError
+    # ignore — rebuildable from disk
+  end
   bridge_data["build"]["last_activity"] = Time.now.utc.iso8601
   Bridge.write(session, bridge_data)
   exit 0

package/scripts/hook-session-start

@@ -117,15 +117,23 @@ if File.exist?(projects_path)
   end
 end
 
+# --- Load PLASTIC.md conventions ---
+
+plastic_md_path = "#{store_root}/PLASTIC.md"
+plastic_md = File.exist?(plastic_md_path) ? File.read(plastic_md_path).strip : nil
+
 # --- Load deprecations ---
 
+dep_file = if plugin_root && !plugin_root.empty?
+  "#{plugin_root}/deprecations.yml"
+else
+  "#{store_root}/deprecations.yml"
+end
+
 deprecations = []
-if plugin_root && !plugin_root.empty?
-  dep_file = "#{plugin_root}/deprecations.yml"
-  if File.exist?(dep_file)
-    dep_data = YAML.safe_load(File.read(dep_file)) rescue {}
-    deprecations = dep_data["deprecations"] || []
-  end
+if File.exist?(dep_file)
+  dep_data = YAML.safe_load(File.read(dep_file)) rescue {}
+  deprecations = dep_data["deprecations"] || []
 end
 
 dismissed_json = `"#{read_config}" deprecations_dismissed`.strip
@@ -136,7 +144,10 @@ rescue
 end
 
 current_version = nil
-if plugin_root && !plugin_root.empty?
+version_file = "#{store_root}/VERSION"
+if File.exist?(version_file)
+  current_version = File.read(version_file).strip
+elsif plugin_root && !plugin_root.empty?
   plugin_json_path = "#{plugin_root}/.claude-plugin/plugin.json"
   if File.exist?(plugin_json_path)
     pj = JSON.parse(File.read(plugin_json_path)) rescue {}
@@ -150,42 +161,68 @@ active_deprecations = deprecations.select do |dep|
   !dismissed.include?(dep["id"])
 end
 
-# --- Early exit if nothing to show ---
+# --- Check for available updates (from previous session's check) ---
+
+update_notice = nil
+cache_file = "#{store_root}/.cache/update-check.json"
+if File.exist?(cache_file)
+  cache = JSON.parse(File.read(cache_file)) rescue {}
+  if cache["updateAvailable"]
+    update_notice = "Plastic update available: #{cache["current"]} -> #{cache["latest"]} — run /plastic-update"
+  end
+end
+
+# --- Assemble session context ---
 
 all_active = active + project_active
 all_future = future + project_future
-exit 0 if all_active.empty? && stale.empty? && all_future.empty? && active_deprecations.empty?
 
 # --- Build context ---
+# PLASTIC.md conventions and intent context render only when conventions are
+# installed. Deprecation warnings and update notices render regardless, so a
+# partial install (or a missing PLASTIC.md) still surfaces critical warnings.
 
 parts = []
 
-if current_project
-  parts << "PLASTIC — Global store | Project: #{current_project["slug"]} (#{current_project["path"]})\n"
-else
-  parts << "PLASTIC — Global store loaded from ~/.plastic/\n"
-end
+if plastic_md
+  # Conventions always loaded first
+  parts << plastic_md
+  parts << "\n---\n"
 
-if all_active.any?
-  parts << "Active intents:\n"
-  all_active.each { |a| parts << a }
-  if bridge_data
-    stage = bridge_data["build"]["stage"]
-    missing = bridge_data["build"]["missing"]
-    missing_str = missing.empty? ? "none" : missing.join(", ")
-    parts << "Stage: #{stage} | Next: #{missing_str}"
+  if current_project
+    slug = current_project["slug"]
+    banner = "Project: #{slug} | Store: ~/.plastic/projects/#{slug}/store/"
+    if project_active.any? && project_active.first =~ /\[([^\]]+)\].*store\/([\w-]+)\//
+      intent_name, dir_name = $1, $2
+      intent_id = dir_name.split("--").first
+      banner += "\nActive: [#{intent_id} — #{intent_name}] | Artifacts → store/#{dir_name}/"
+    end
+    parts << banner + "\n"
+  else
+    parts << "PLASTIC — Global store loaded from ~/.plastic/\n"
   end
-  parts << ""
-else
-  parts << "No active intents. #{future.length} future intents available.\n"
-end
 
-if stale.any?
-  parts << "\nStale future intents (untouched for days):\n"
-  stale.each do |s|
-    parts << "- #{s[:name]} (#{s[:age]} days) — consider: activate, abandon, or defer to agent"
+  if all_active.any?
+    parts << "Active intents:\n"
+    all_active.each { |a| parts << a }
+    if bridge_data
+      stage = bridge_data["build"]["stage"]
+      missing = bridge_data["build"]["missing"]
+      missing_str = missing.empty? ? "none" : missing.join(", ")
+      parts << "Stage: #{stage} | Next: #{missing_str}"
+    end
+    parts << ""
+  else
+    parts << "No active intents. #{future.length} future intents available.\n"
+  end
+
+  if stale.any?
+    parts << "\nStale future intents (untouched for days):\n"
+    stale.each do |s|
+      parts << "- #{s[:name]} (#{s[:age]} days) — consider: activate, abandon, or defer to agent"
+    end
+    parts << "\nWhen appropriate, ask the user what to do with stale intents."
   end
-  parts << "\nWhen appropriate, ask the user what to do with stale intents."
 end
 
 if active_deprecations.any?
@@ -215,6 +252,14 @@ if active_deprecations.any?
   end
 end
 
+if update_notice
+  parts.unshift("! #{update_notice}\n")
+end
+
+# Emit nothing when there is genuinely nothing to surface (no conventions,
+# no deprecations, no update notice).
+exit 0 if parts.join.strip.empty?
+
 payload = {
   "hookSpecificOutput" => {
     "hookEventName" => "SessionStart",