@zalom/plastic 2.0.0-alpha.27 → 2.0.0-alpha.29

package/scripts/lib/stores_move.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require_relative "store_layout"
+require_relative "sqlite"
+require_relative "lock"
+
+module Plastic
+  class StoresMove
+    Refused = Class.new(StandardError)
+
+    GLOBAL_ENTRIES = %w[store INDEX.md roadmaps].freeze
+    PATH_COLUMNS = {"knowledge_graph.db" => %w[doc path], "references.db" => %w[sqlar name]}.freeze
+    LOCKS = "{store,projects/*/store}/*/delivery.lock"
+
+    def initialize(home, qmd_index:, dry_run: false)
+      @home = home
+      @qmd_index = qmd_index
+      @dry_run = dry_run
+    end
+
+    def call
+      refuse
+      plan = [["copy", copy]] + moves.map { |from, to| ["move", "#{from} -> #{to}"] } + rewrites.map { |file| ["rewrite", file] }
+      run unless @dry_run
+      plan
+    end
+
+    def copy
+      "#{@home}-before-stores-move"
+    end
+
+    private
+
+    def refuse
+      raise Refused, "#{File.join(@home, "stores")}/ exists, so this home has moved already" if StoreLayout.moved?(@home)
+      raise Refused, "a delivery lock is held: #{held.join(", ")}" unless held.empty?
+      raise Refused, "#{copy} exists; remove it or move it away first" if File.exist?(copy)
+    end
+
+    def held
+      Dir.glob(LOCKS, base: @home).select { |lock| Time.now - File.mtime(File.join(@home, lock)) < Lock::TTL_SECONDS }
+    end
+
+    def moves
+      @moves ||= GLOBAL_ENTRIES.select { |name| File.exist?(File.join(@home, name)) }.map { |name| [name, "stores/global/#{name}"] } +
+        project_entries.map { |entry| ["projects/#{entry}", "stores/#{entry}"] }
+    end
+
+    def project_entries
+      Dir.exist?(projects) ? Dir.children(projects).sort : []
+    end
+
+    def projects
+      File.join(@home, "projects")
+    end
+
+    def rewrites
+      [File.join(@home, "config.yml"), @qmd_index, *PATH_COLUMNS.keys.map { |name| File.join(@home, name) }].select { |file| File.file?(file) }
+    end
+
+    def run
+      files = rewrites
+      FileUtils.cp_r(@home, copy, preserve: true)
+      moves.each { |from, to| move(from, to) }
+      FileUtils.rmdir(projects) if Dir.exist?(projects)
+      files.each { |file| PATH_COLUMNS.key?(File.basename(file)) ? rewrite_rows(file) : rewrite_text(file) }
+    end
+
+    def move(from, to)
+      FileUtils.mkdir_p(File.dirname(File.join(@home, to)))
+      FileUtils.mv(File.join(@home, from), File.join(@home, to))
+    end
+
+    def rewrite_text(file)
+      FileUtils.cp(file, "#{file}.before-stores-move", preserve: true)
+      File.write(file, [@home, "~/.plastic"].inject(File.read(file)) { |text, base| relocate(text, base) })
+    end
+
+    def relocate(text, base)
+      text.gsub(%r{#{Regexp.escape(base)}/(store|roadmaps|INDEX\.md)\b}) { "#{base}/stores/global/#{Regexp.last_match(1)}" }
+        .gsub(%r{#{Regexp.escape(base)}/projects\b}) { "#{base}/stores" }
+    end
+
+    def rewrite_rows(file)
+      table, column = PATH_COLUMNS.fetch(File.basename(file))
+      Sqlite.call(file, <<~SQL)
+        UPDATE #{table} SET #{column} = 'stores/' || substr(#{column}, 10) WHERE #{column} LIKE 'projects/%';
+        UPDATE #{table} SET #{column} = 'stores/global/' || #{column} WHERE #{column} LIKE 'store/%';
+      SQL
+    end
+  end
+end

package/scripts/lib/verify_intent.rb

@@ -1,6 +1,7 @@
 # encoding: UTF-8
 # frozen_string_literal: true
 
+require_relative "store_layout"
 require_relative "worktree"
 require_relative "scaffold_intent"
 
@@ -96,13 +97,7 @@ module VerifyIntent
   # shapes are told apart by whether store's grandparent is literally named "projects" (the
   # StoreDiscovery convention), never by hardcoding ".plastic" as a name.
   def resolve_plastic_home_and_scope(store)
-    parent = File.dirname(store)
-    grandparent = File.dirname(parent)
-    if File.basename(grandparent) == "projects"
-      [File.dirname(grandparent), "project:#{File.basename(parent)}"]
-    else
-      [parent, "global"]
-    end
+    Plastic::StoreLayout.home_and_scope(store)
   end
 
   # --- check 1: doctor, scoped to the intent --------------------------------------

package/scripts/lib/version_number.rb

@@ -0,0 +1,48 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# VersionNumber - dotted version comparison without RubyGems (intent 363).
+#
+# The launcher starts as `ruby --disable-gems`, which saves about 26 of the 40
+# milliseconds a plain Ruby process costs, so no file a command loads may reach
+# for Gem::Version. Parses the leading run of dotted integers, ignoring a
+# leading "v" and anything after the digits, and compares two of them segment by
+# segment with the shorter one zero-padded. A string with no leading integer
+# parses to nil, so a caller answers "not found" instead of raising.
+#
+# It deliberately does not order pre-release suffixes: 2.0.0-alpha.27 and 2.0.0
+# compare equal here. A caller that needs RubyGems' pre-release order, such as
+# the release-tag reader in scripts/report-screen, keeps Gem::Version.
+class VersionNumber
+  include Comparable
+
+  LEADING_DIGITS = /\A(\d+(?:\.\d+)*)/
+
+  attr_reader :segments
+
+  def self.parse(value)
+    match = LEADING_DIGITS.match(value.to_s.strip.sub(/\Av/, ""))
+    match && new(match[1].split(".").map(&:to_i))
+  end
+
+  def initialize(segments)
+    @segments = segments
+  end
+
+  def <=>(other)
+    return nil unless other.is_a?(VersionNumber)
+
+    width = [segments.length, other.segments.length].max
+    padded(width) <=> other.padded(width)
+  end
+
+  def to_s
+    segments.join(".")
+  end
+
+  protected
+
+  def padded(width)
+    segments + Array.new(width - segments.length, 0)
+  end
+end

package/scripts/lib/work_graph.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require_relative "sqlite"
+require_relative "index_entry"
+require_relative "store_discovery"
+
+module Plastic
+  module WorkGraph
+    NAME = "work_graph.db"
+    SCHEMA = <<~SQL
+      CREATE TABLE intent(id TEXT, store TEXT, slug TEXT, status TEXT, title TEXT);
+      CREATE TABLE ledger(intent_id TEXT, store TEXT, at TEXT, stage TEXT, text TEXT);
+    SQL
+    STATUSES = %w[active future completed abandoned].freeze
+    LEDGER_LINE = /\A(\S+)\s{2,}(\S+)\s{2,}(.+)\z/
+
+    def self.path(home)
+      File.join(home, NAME)
+    end
+
+    def self.build(home)
+      draft = "#{path(home)}.tmp"
+      FileUtils.rm_f(draft)
+      rows = StoreDiscovery.discover(home)[:stores].flat_map { |store| intents(store) + ledger(store) }
+      Sqlite.call(draft, [SCHEMA, "BEGIN;", *rows, "COMMIT;"].join("\n"))
+      File.rename(draft, path(home))
+    end
+
+    def self.intents(store)
+      return [] unless File.exist?(store[:index])
+
+      status = nil
+      File.readlines(store[:index], chomp: true, encoding: "UTF-8").filter_map do |line|
+        status = line.delete_prefix("## ").downcase if line.start_with?("## ")
+        entry = STATUSES.include?(status) && IndexEntry.match(line)
+        entry && insert("intent", entry[1], store[:slug], File.basename(File.dirname(entry[3])).split("--", 2).last, status, entry[2])
+      end
+    end
+
+    def self.ledger(store)
+      Dir.glob("*/savepoint.md", base: store[:store]).sort.flat_map do |file|
+        id = file.split("--").first
+        File.readlines(File.join(store[:store], file), chomp: true, encoding: "UTF-8").filter_map do |line|
+          entry = line.match(LEDGER_LINE)
+          entry && insert("ledger", id, store[:slug], entry[1], entry[2], entry[3])
+        end
+      end
+    end
+
+    def self.insert(table, *values)
+      "INSERT INTO #{table} VALUES(#{values.map { |value| Sqlite.quote(value.to_s) }.join(", ")});"
+    end
+
+    def self.known(home)
+      Sqlite.call(path(home), "SELECT store, id FROM intent;", readonly: true).map { |row| "#{row["store"]}:#{row["id"]}" }
+    end
+  end
+end

package/scripts/lib/worktree.rb

@@ -1,6 +1,7 @@
 # encoding: UTF-8
 # frozen_string_literal: true
 
+require_relative "store_layout"
 require "json"
 require "yaml"
 require "socket"
@@ -377,14 +378,8 @@ module Worktree
   # (no project repo). Mirrors qmd_sync's slug_for_store fallback.
   def slug_for_store(store_dir, home: Dir.home)
     return nil if blank?(store_dir)
-    plastic_home = File.expand_path(File.join(home, ".plastic"))
-    store_dir = File.expand_path(store_dir)
-    return nil if store_dir == File.join(plastic_home, "store")
-
-    parts = store_dir.split(File::SEPARATOR)
-    idx = parts.rindex("projects")
-    return parts[idx + 1] if idx && parts[idx + 1] && parts[idx + 2] == "store"
-    nil
+    slug = Plastic::StoreLayout.locate(store_dir).last
+    (slug == Plastic::StoreLayout::GLOBAL) ? nil : slug
   end
 
   # Best-effort slug for the worktree dir-name from an intent dir/store path:

package/scripts/lib/worktree_sweep.rb

@@ -1,6 +1,7 @@
 # encoding: UTF-8
 # frozen_string_literal: true
 
+require_relative "store_layout"
 require_relative "worktree"
 require_relative "index_entry"
 
@@ -55,8 +56,8 @@ module WorktreeSweep
   # Matching on the full name, not just the numeric id, sidesteps id
   # collisions across projects (ids are only unique WITHIN one store).
   def resolve_intent_dir(plastic_home, name)
-    candidates = [File.join(plastic_home, "store", name)] +
-                 Dir.glob(File.join(plastic_home, "projects", "*", "store", name))
+    candidates = [File.join(Plastic::StoreLayout.global_store(plastic_home), name)] +
+                 Dir.glob(File.join(Plastic::StoreLayout.projects_root(plastic_home), "*", "store", name))
     candidates.find { |d| Dir.exist?(d) }
   end
 

package/scripts/link-suggest

@@ -26,6 +26,7 @@
 # nothing. --edge is explicit and required (sources is decided by origin, never
 # inferred); --rating is required when --edge is chain.
 
+require_relative "lib/store_layout"
 require_relative "lib/link_suggestions"
 
 module LinkSuggestCLI
@@ -69,7 +70,7 @@ module LinkSuggestCLI
         i += 1
       end
     end
-    opts[:store_dir] ||= File.join(opts[:home], "store")
+    opts[:store_dir] ||= Plastic::StoreLayout.global_store(opts[:home])
     opts
   end
 

package/scripts/migrate-to-global

@@ -17,7 +17,7 @@ GLOBAL_ROOT="$HOME/.plastic"
 LOCAL_PLASTIC="$PROJECT_PATH/.plastic"
 
 if [ ! -d "$GLOBAL_ROOT" ]; then
-  echo "Error: Global Plastic not installed. Run /plastic-install first." >&2
+  echo "Error: Global Plastic not installed. Run 'plastic install' first." >&2
   exit 1
 fi
 

package/scripts/new-intent

@@ -35,6 +35,7 @@
 # exactly one line, `created <dir>` or `joined <dir>`; exit 0 either way,
 # exit 1 on bad input or failed self-validation.
 
+require_relative "lib/store_layout"
 require "fileutils"
 require "date"
 require_relative "lib/savepoint"
@@ -167,17 +168,7 @@ end
 # [nil, "global"] only if the layout is unrecognized, in which case Links
 # projection falls back to single-store resolution rooted at this store.
 def store_context(store)
-  store = File.expand_path(store)
-  parent = File.dirname(store)               # `<home>` or `<home>/projects/<slug>`
-  if File.basename(store) == "store" && File.basename(File.dirname(parent)) == "projects"
-    slug = File.basename(parent)
-    home = File.dirname(File.dirname(parent)) # strip projects/<slug>
-    [home, "project:#{slug}"]
-  elsif File.basename(store) == "store"
-    [parent, "global"]                        # `<home>/store`
-  else
-    [parent, "global"]
-  end
+  Plastic::StoreLayout.home_and_scope(store)
 end
 
 # The in-scope stores under `plastic_home`, each { key:, store: }. Delegates to
@@ -283,7 +274,7 @@ def run_tmp(opts)
   abort "new-intent: --sources is not valid with --tmp" unless opts[:sources].empty?
   abort "new-intent: --tags is not valid with --tmp" unless opts[:tags].empty?
 
-  store = opts[:store] ? expand(opts[:store]) : expand(File.join(ENV.fetch("PLASTIC_HOME", "~/.plastic"), "store"))
+  store = opts[:store] ? expand(opts[:store]) : Plastic::StoreLayout.global_store(expand(ENV.fetch("PLASTIC_HOME", "~/.plastic")))
   templates = opts[:templates] ? expand(opts[:templates]) : default_templates_dir
   abort "new-intent: templates dir not found: #{templates}" unless Dir.exist?(templates)
 

package/scripts/plastic-lock

@@ -38,6 +38,7 @@
 # file; that path was retired in 2.0 (intent 307) and 344 G11.
 # Exit 0 on success/report; exit 1 when the verb is blocked.
 
+require_relative "lib/store_layout"
 require "json"
 require "yaml"
 require_relative "lib/lock"
@@ -96,7 +97,7 @@ if dir.nil? || dir.strip.empty?
     exit 1
   end
   roots = ActiveDelivery.project_roots(plastic_home)
-  global_store = File.join(plastic_home, "store")
+  global_store = Plastic::StoreLayout.global_store(plastic_home)
   dir = ActiveDelivery.resolve(global_store: global_store, project_roots: roots, session: session)
   if dir.nil?
     candidates = ActiveDelivery.candidate_intent_dirs(global_store: global_store, project_roots: roots).uniq
@@ -188,7 +189,7 @@ when "arm"
   end
 when "status"
   lock = Lock.read(dir)
-  resolved = ActiveDelivery.resolve(global_store: File.join(plastic_home, "store"),
+  resolved = ActiveDelivery.resolve(global_store: Plastic::StoreLayout.global_store(plastic_home),
                                     project_roots: ActiveDelivery.project_roots(plastic_home),
                                     session: key)
   delivering = !resolved.nil? && File.expand_path(resolved) == File.expand_path(dir)

package/scripts/promote-session-item

@@ -21,6 +21,7 @@
 # Exit codes: 0 promoted (prints the intent dir last), 1 new-intent failed,
 # 2 usage error or nothing to promote.
 
+require_relative "lib/store_layout"
 require "open3"
 require "yaml"
 require_relative "lib/session_ledger"
@@ -61,7 +62,7 @@ usage_abort("--day must be a real calendar date, YYYYMMDD") unless SessionLedger
 usage_abort("--match is required") if opts[:match].nil? || opts[:match].empty?
 
 plastic_home = File.expand_path(opts[:plastic_home] || ENV.fetch("PLASTIC_HOME", "~/.plastic"))
-store = opts[:store] || File.join(plastic_home, "store")
+store = opts[:store] || Plastic::StoreLayout.global_store(plastic_home)
 templates = opts[:templates] || File.expand_path("../templates", __dir__)
 session = opts[:session] ? SessionLedger.short_session_id(opts[:session]) : nil
 
@@ -69,7 +70,7 @@ target_store = store
 if opts[:project]
   projects = StoreProvisioning.load_projects(plastic_home)
   usage_abort("--project #{opts[:project]} is not a registered project") unless projects.key?(opts[:project])
-  target_store = File.join(plastic_home, "projects", opts[:project], "store")
+  target_store = File.join(Plastic::StoreLayout.project_root(plastic_home, opts[:project]), "store")
 end
 
 # --- pick the target line ---------------------------------------------------

package/scripts/release-check

@@ -13,7 +13,7 @@
 # suite.
 #
 # Usage:
-#   release-check --tag <tag> --npm-version <version>
+#   release-check (--tag <tag> | --branch <branch>) --npm-version <version>
 #                  [--github-output <path>] [--root <dir>]
 #
 # Exit codes: 0 (clean), 1 (violations; reported on stderr, one per line,
@@ -24,10 +24,10 @@ require "json"
 require_relative "lib/release_guard"
 
 NPM_FLOOR = [11, 5, 1].freeze
-KNOWN_FLAGS = %w[--tag --npm-version --github-output --root].freeze
+KNOWN_FLAGS = %w[--tag --branch --npm-version --github-output --root].freeze
 
 def usage
-  warn "usage: release-check --tag <tag> --npm-version <version> [--github-output <path>] [--root <dir>]"
+  warn "usage: release-check (--tag <tag> | --branch <branch>) --npm-version <version> [--github-output <path>] [--root <dir>]"
   exit 2
 end
 
@@ -54,7 +54,7 @@ rescue Errno::ENOENT, JSON::ParserError
 end
 
 opts = parse_args(ARGV)
-usage unless opts["--tag"] && opts["--npm-version"]
+usage unless (opts["--tag"] || opts["--branch"]) && opts["--npm-version"]
 
 root = opts["--root"] ? File.expand_path(opts["--root"]) : File.expand_path("..", __dir__)
 package_json_path = File.join(root, "package.json")
@@ -66,16 +66,20 @@ violations = []
 canonical_version = read_version(package_json_path)
 violations << "could not read a version from #{package_json_path}" if canonical_version.nil?
 
-tag = opts["--tag"].sub(%r{\Arefs/tags/}, "")
+branch = opts["--branch"]
 dist_tag = nil
 
 if canonical_version
   expected_tag = "v#{canonical_version}"
+  tag = opts.fetch("--tag", expected_tag).sub(%r{\Arefs/tags/}, "")
   if tag != expected_tag
     violations << "tag #{tag} does not match package.json version #{canonical_version} (expected #{expected_tag})"
   end
 
   dist_tag = ReleaseGuard.dist_tag(canonical_version)
+  if branch && ReleaseGuard::CHANNELS[branch] != dist_tag
+    violations << "branch #{branch} publishes #{ReleaseGuard::CHANNELS[branch] || "nothing"}, and version #{canonical_version} is #{dist_tag}"
+  end
   stable = dist_tag == "latest"
 
   result = ReleaseGuard.check(
@@ -107,6 +111,7 @@ if violations.empty?
     File.open(opts["--github-output"], "a") do |f|
       f.puts "version=#{canonical_version}"
       f.puts "dist_tag=#{dist_tag}"
+      f.puts "tag=#{tag}"
     end
   end
   puts "OK: tag #{tag}, version #{canonical_version}, dist-tag #{dist_tag}"

package/scripts/report-screen

@@ -63,7 +63,7 @@ end
 def resolve_repo(intent_dir, explicit_repo, script_dir, include_self: true)
   candidates = []
   candidates << File.expand_path(explicit_repo) if explicit_repo
-  if (m = intent_dir.match(%r{\A(.*)/projects/([^/]+)/store/[^/]+\z}))
+  if (m = intent_dir.match(%r{\A(.*)/(?:projects|stores)/([^/]+)/store/[^/]+\z}))
     home, slug = m[1], m[2]
     projects_yml = File.join(home, "projects.yml")
     if File.exist?(projects_yml)

package/scripts/session-commit

@@ -18,6 +18,7 @@
 #   0 - always, except a usage error
 #   2 - usage error (missing --cwd or --summary); nothing is written
 
+require_relative "lib/store_layout"
 require "fileutils"
 require_relative "lib/session_git"
 require_relative "lib/session_ledger"
@@ -78,7 +79,7 @@ def main(argv)
   usage_abort("--summary is required") if opts[:summary].nil?
 
   plastic_home = expand(opts[:plastic_home] || ENV.fetch("PLASTIC_HOME", "~/.plastic"))
-  store = opts[:store] ? expand(opts[:store]) : File.join(plastic_home, "store")
+  store = opts[:store] ? expand(opts[:store]) : Plastic::StoreLayout.global_store(plastic_home)
   cwd = expand(opts[:cwd])
 
   day = opts[:day] || SessionLedger.day_id

package/scripts/spawn-preamble

@@ -44,7 +44,7 @@ WORKTREE_FALLBACK_INSTRUCTION =
   "directory, cd directly to the code worktree path above before editing project code."
 
 # Verbatim completion-report contract (intent 74). Kept as one constant so the
-# contract doc (skills/auto/references/agent-report-contract.md), the role prompts,
+# contract doc (docs/help/agent-report-contract.md), the role prompts,
 # and the test assert against the exact same string. SINGLE SOURCE OF TRUTH for the
 # report wording: the work output is lifecycle artifacts, the final message is a
 # structured report about them. Both are required and they do not contradict.
@@ -64,7 +64,7 @@ REPORT_CONTRACT =
   "depends on the discovering session's file-write access. Keep the report " \
   "prose-stripped: the envelope and payload only, no greeting, no preamble, " \
   "no end-recap, no restating of the task; reasoning stays in the thinking channel. " \
-  "See skills/auto/references/agent-report-contract.md for the per-role format."
+  "See docs/help/agent-report-contract.md for the per-role format."
 
 def parse_args(argv)
   role = nil

package/scripts/update.rb

@@ -231,12 +231,33 @@ class Update < InstallerCore
     ($stdin.gets&.strip || "").downcase.start_with?("y")
   end
 
-  # Thin npx-exec glue (not unit-tested; the decision above is). Delegates the file-sync to
-  # the target version's install verb, recording the ledger action as `update`.
-  def perform_switch(target, agent_flags)
+  # Thin npx-exec glue (the decision above is unit-tested). Delegates the file-sync to
+  # the target version's install verb, recording the ledger action as `update`. On
+  # success, commits the re-synced core files and clears the update-check cache
+  # (former update skill, lines 124-125).
+  def perform_switch(target, agent_flags, switch_runner: ->(cmd) { system(*cmd) })
     cmd = ["npx", "#{PKG}@#{target}", "install", "--reinstall", "--ledger-action", "update", *agent_flags]
     puts "  $ #{cmd.join(" ")}"
-    system(*cmd) ? 0 : 1
+    return 1 unless switch_runner.call(cmd)
+
+    commit_core_files(target)
+    clear_update_check_cache
+    0
+  end
+
+  # Intent 372 (former update skill, lines 124-125): `~/.plastic` is its own git
+  # repository (install.rb's git_init_if_absent), so a successful update commits the
+  # core files it just re-synced. Empty commits are allowed: a same-version repair
+  # re-syncs nothing new, and that is still worth a ledger-adjacent commit.
+  def commit_core_files(target, runner: ->(cmd) { system(*cmd) })
+    runner.call(["git", "-C", plastic_home, "add", "PLASTIC.md", "scripts", "AGENTS.md", "VERSION",
+      "versions.json", "deprecations.yml", "config_asks.yml"])
+    runner.call(["git", "-C", plastic_home, "commit", "-m", "chore: update Plastic to #{target}",
+      "--allow-empty"])
+  end
+
+  def clear_update_check_cache
+    FileUtils.rm_f(File.join(plastic_home, ".cache", "update-check.json"))
   end
 
   def show_help

package/scripts/write-handoff

@@ -16,6 +16,7 @@
 #
 # Exit codes: 0 done; 2 usage error.
 
+require_relative "lib/store_layout"
 require_relative "lib/session_ledger"
 require_relative "lib/handoff"
 
@@ -48,7 +49,7 @@ usage_abort("--trigger is required (#{Handoff::TRIGGERS.join(', ')})") unless op
 usage_abort("--trigger must be one of #{Handoff::TRIGGERS.join(', ')}") unless Handoff::TRIGGERS.include?(opts[:trigger])
 
 plastic_home = expand(ENV.fetch("PLASTIC_HOME", "~/.plastic"))
-store = opts[:store] ? expand(opts[:store]) : File.join(plastic_home, "store")
+store = opts[:store] ? expand(opts[:store]) : Plastic::StoreLayout.global_store(plastic_home)
 templates = opts[:templates] ? expand(opts[:templates]) : File.expand_path("../templates", __dir__)
 usage_abort("templates dir not found: #{templates}") unless Dir.exist?(templates)
 

package/templates/agents.md

@@ -42,7 +42,7 @@ Active/Future/Completed placement is managed in INDEX.md, not in frontmatter.
 
 ## Creating Tactical Intents
 
-Create through the `plastic-intent-creating` skill, which scaffolds with one call:
+Create through the `plastic intent new` command, which scaffolds with one call:
 `ruby ~/.plastic/scripts/new-intent --store .plastic/store --intent "<one-line>" --slug <slug> [--sources <governing-id>]`.
 It allocates the Folgezettel ID, creates `.plastic/store/ID--slug/ID--slug.md` born
 complete, and wires the links. Never hand-author the files: `new-intent` validates the
@@ -54,11 +54,11 @@ Plastic has its own lifecycle skills. When a Plastic skill exists for the curren
 
 | Phase | Skill | Produces |
 |-------|-------|----------|
-| What | `plastic-intent-creating` | Intent file |
-| Why | `plastic-intent-speccing` | Rulings as insights, `resources/*.md`, `spec.md` |
-| How | `plastic-intent-speccing` | `actions/`, `plan.md`, `checklist.md` |
-| Exec | `plastic-intent-executing` | Code + `outcome.md` |
-| End | `plastic-intent-ending` | Lifecycle transition |
+| What | `plastic intent new` | Intent file |
+| Why | `plastic intent spec` | Rulings as insights, `resources/*.md`, `spec.md` |
+| How | `plastic intent spec` | `actions/`, `plan.md`, `checklist.md` |
+| Exec | `plastic intent step` | Code + `outcome.md` |
+| End | `plastic intent end` | Lifecycle transition |
 
 **Artifact convention:** ALL lifecycle artifacts go to the active intent directory (`store/{id}--{slug}/`). Never write specs to `docs/superpowers/specs/` or plans to `docs/superpowers/plans/`.
 

package/templates/render.css

@@ -0,0 +1,10 @@
+body { max-width: 46rem; margin: 2rem auto; padding: 0 1rem; font: 16px/1.6 system-ui, sans-serif; color: #1f2933; background: #f4f5f7; }
+h1, h2, h3 { line-height: 1.25; }
+table { border-collapse: collapse; display: block; overflow-x: auto; }
+th, td { border: 1px solid #9aa5b1; padding: 0.3rem 0.6rem; text-align: left; }
+pre { background: #e4e7eb; padding: 0.8rem; overflow-x: auto; }
+code { font-family: ui-monospace, monospace; }
+@media (prefers-color-scheme: dark) {
+  body { color: #e4e7eb; background: #1f2933; }
+  pre { background: #323f4b; }
+}

package/bin/plastic.js

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-
-// Thin shim — npx entry point that dispatches a subcommand to the matching Ruby verb script.
-// All logic lives in scripts/<verb>.rb. JS is only the distribution + dispatch mechanism.
-//
-//   npx @zalom/plastic install   [flags]
-//   npx @zalom/plastic update    [flags]
-//   npx @zalom/plastic uninstall [flags]
-//   npx @zalom/plastic rollback  [flags]
-//
-// Back-compat: a bare `--uninstall` (no subcommand) routes to uninstall with a deprecation
-// warning; no subcommand at all defaults to install (legacy behaviour, one release).
-
-import { execFileSync } from 'node:child_process'
-import { resolve } from 'node:path'
-import { existsSync } from 'node:fs'
-
-const VERBS = ['install', 'update', 'uninstall', 'rollback']
-const packageRoot = new URL('..', import.meta.url).pathname
-const argv = process.argv.slice(2)
-
-let verb
-let rest
-
-if (VERBS.includes(argv[0])) {
-  verb = argv[0]
-  rest = argv.slice(1)
-} else if (argv.includes('--uninstall')) {
-  // Deprecated: `--uninstall` as a flag instead of the `uninstall` subcommand.
-  console.error('! plastic: `--uninstall` is deprecated — use `npx @zalom/plastic uninstall`. (works for now)')
-  verb = 'uninstall'
-  rest = argv.filter((a) => a !== '--uninstall')
-} else {
-  // No subcommand: legacy default to install (one release of grace).
-  verb = 'install'
-  rest = argv
-}
-
-const script = resolve(packageRoot, 'scripts', `${verb}.rb`)
-
-if (!existsSync(script)) {
-  console.error(`Error: scripts/${verb}.rb not found in package.`)
-  process.exit(1)
-}
-
-try {
-  execFileSync('ruby', [script, ...rest], {
-    stdio: 'inherit',
-    // Clear RUBYOPT last, after the spread, so a global setting (for example --yjit)
-    // cannot reach a ruby that does not know the flag. A machine with an old ruby
-    // must get preflight's real message, not a crash.
-    env: { ...process.env, PLASTIC_PACKAGE_ROOT: packageRoot, RUBYOPT: '' },
-  })
-} catch (err) {
-  if (err.status) process.exit(err.status)
-  // We only get here when ruby could not be executed at all. A ruby that runs but is
-  // too old exits with a status, handled on the line above, and prints its own real
-  // message from scripts/lib/preflight.rb naming the version actually found.
-  if (err.code === 'ENOENT') {
-    console.error('Plastic needs Ruby 3.0.0 or newer to run its scripts (ruby was not found on PATH).')
-    console.error('Install a pinned Ruby with mise:')
-    console.error('  curl https://mise.run | sh        # only if mise is not installed yet')
-    console.error('  mise use --global ruby@3.3')
-    console.error('Then re-run the Plastic installer.')
-  } else {
-    console.error(`Plastic could not run ruby: ${err.message}`)
-    console.error('Check that `ruby -v` works in this shell, then re-run the Plastic installer.')
-  }
-  process.exit(1)
-}