@zalom/plastic 1.0.0-alpha.22 → 1.0.0-alpha.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zalom/plastic",
-  "version": "1.0.0-alpha.22",
+  "version": "1.0.0-alpha.24",
   "description": "Intent-driven idea development system for AI coding agents",
   "type": "module",
   "bin": {

package/scripts/hook-session-start

@@ -7,6 +7,8 @@ require "json"
 require "date"
 require "yaml"
 require_relative "lib/bridge"
+require_relative "lib/boot_banner"
+require_relative "doctor"
 
 index_path, store_root, mode, plugin_root = ARGV
 exit 0 unless index_path && store_root && mode
@@ -172,6 +174,18 @@ if File.exist?(cache_file)
   end
 end
 
+# --- Run core health in-process (intent 36a) ---
+# Reuse Doctor's own --core checks so there is one source of truth for "core
+# health" (no second process spawn, no duplicated check list). Never blocks the
+# session: any failure or exception degrades to a banner and we continue.
+
+core_health = begin
+  Doctor.new(plastic_home: store_root).run_core_checks("claude")
+rescue
+  nil
+end
+core_banner = BootBanner.render(health: core_health, version: current_version)
+
 # --- Assemble session context ---
 
 all_active = active + project_active
@@ -184,6 +198,12 @@ all_future = future + project_future
 
 parts = []
 
+# Boot banner first: every session start surfaces that Plastic loaded, with the
+# version (clean) or the first failing core check (degraded). Owned by the hook
+# so it runs by construction — the plastic-continuing skill no longer does this.
+parts << core_banner
+parts << ""
+
 if plastic_md
   # Conventions always loaded first
   parts << plastic_md

package/scripts/lib/boot_banner.rb

@@ -0,0 +1,36 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Renders the SessionStart boot banner from a core-health result (intent 36a).
+#
+# Pure and dependency-injected: it takes the health hash (the return value of
+# Doctor#run_core_checks) and the version string, and returns a single banner
+# line. No I/O, no globals, no ENV — so it is unit-testable in isolation while
+# the hook feeds it real data.
+module BootBanner
+  module_function
+
+  # health: the Hash returned by Doctor#run_core_checks, or nil if the check
+  #         itself raised (degraded to an error banner).
+  # version: the installed Plastic version string, or nil.
+  def render(health:, version:)
+    return "Plastic Core: health check error — run /plastic-doctor" if health.nil?
+
+    if health[:status] == "pass"
+      "Plastic Core loaded — v#{version || "unknown"}"
+    else
+      bad = first_problem(health[:checks])
+      if bad
+        "Plastic Core loaded with issues — #{bad[:name]}: #{bad[:message]} — run /plastic-doctor"
+      else
+        "Plastic Core loaded with issues — run /plastic-doctor"
+      end
+    end
+  end
+
+  # First failing check, else first warning, else nil.
+  def first_problem(checks)
+    checks = checks || []
+    checks.find { |c| c[:status] == "fail" } || checks.find { |c| c[:status] == "warn" }
+  end
+end

package/scripts/lib/installer_core.rb

@@ -198,6 +198,7 @@ class InstallerCore
       "scripts/hook-bash-gate" => "scripts/hook-bash-gate",
       "scripts/hook-auto-arm" => "scripts/hook-auto-arm",
       "scripts/lib/bridge.rb" => "scripts/lib/bridge.rb",
+      "scripts/lib/boot_banner.rb" => "scripts/lib/boot_banner.rb",
       "scripts/lib/installer_core.rb" => "scripts/lib/installer_core.rb",
       "scripts/install.rb" => "scripts/install.rb",
       "scripts/update.rb" => "scripts/update.rb",

package/skills/continuing/SKILL.md

@@ -1,59 +1,37 @@
 ---
 name: plastic-continuing
-description: Use when the user says "continue", "resume", or "pick up where we left off", or when starting a new session. Boots Plastic — runtime health check, loads core context + store/project state, prints version + statusline, and lands on the right dashboard — then presents choices. Does not drive work autonomously (that is plastic-auto).
+description: Use when the user says "continue", "resume", or "pick up where we left off", or when starting a new session. Continues work with the latest project context: lands on the right dashboard, then presents choices. Boot (health check, core context, version, statusline) is owned by the SessionStart hook, not this skill. Does not drive work autonomously (that is plastic-auto).
 ---
 
 # Continuing
 
-`plastic-continuing` is a deterministic **boot orchestrator**. It loads and presents choices,
-then stops. It does NOT execute work autonomously (that is `plastic-auto`) and does NOT render
-the dashboard itself (it only invokes it).
+`plastic-continuing` continues work. It presents the latest state via the dashboard and offers
+choices, then stops. It does NOT execute work autonomously (that is `plastic-auto`) and does
+NOT render the dashboard itself (it only invokes it).
+
+**Boot is not this skill's job.** The `hook-session-start` hook already runs by construction on
+every session start: it runs the core health check (`doctor --core`), primes `PLASTIC.md` +
+store/project state, and prints the `Plastic Core loaded — v{version}` banner. The
+`plastic-statusline` hook sets the statusline. So by the time this skill runs, core is loaded
+and healthy (or the banner already warned otherwise). This skill picks up from there and
+continues work. This is the seam future continue-flags build on (see [[39]]).
 
 ## When to Use
 - UserPromptSubmit hook detects "continue" (automatic)
 - User says "continue", "resume", or "pick up where we left off"
-- Starting a new session with an existing Plastic store
+- Starting a new session and you want to resume work with the latest context
 
 ## Determine Store
 
 1. **Global store** — `~/.plastic/INDEX.md` exists → global mode.
 2. **Local store** — a project store under `~/.plastic/projects/{slug}/` whose registered
    path (in `~/.plastic/projects.yml`) matches the current working directory → project mode.
-   Project detection happens in boot step 2 below; this just records that a local store is
-   in play.
+   The SessionStart hook already detects this; here you only need the slug to scope the
+   dashboard.
 3. If neither exists → announce "No Plastic store found. Run /plastic-install."
 
-## Boot Sequence (run in this fixed order)
-
-### 1. Core doctor (health first)
-Run the fast runtime-liveness check synchronously (it returns in well under a second):
-
-```bash
-ruby ~/.plastic/scripts/doctor.rb --core
-```
-
-Print one compact health line:
-- All pass → `Plastic core: healthy`
-- Otherwise → `Plastic core: issues` followed by the failing checks (name + message).
-
-This runs first so a broken runtime (missing hooks, scripts, core files) surfaces before any
-state is loaded on top of it. For a full diagnosis, point the user at `/plastic-doctor`.
-
-### 2. Load core (context + state)
-- Prime `PLASTIC.md` and the harness docs so the conventions are in mind.
-- Load live state:
-  - Read the active store `INDEX.md` (`## Active`, `## Future`).
-  - Read `~/.plastic/projects.yml`.
-  - **Detect the current project** by matching CWD against registered project paths.
-  - If in a project: load that project's `INDEX.md`; load the governing intent (from
-    `parent` in projects.yml) and the tactical intents from
-    `~/.plastic/projects/{slug}/store/`.
-
-### 3. Version + statusline
-- Print the current Plastic version (from `~/.plastic/VERSION`).
-- Set the statusline.
+## Continue (present the dashboard)
 
-### 4. Dashboard
 Land on the Markdown board via the `plastic-dashboard` skill. Rendering belongs there, not
 here — run the data payload and fill + present the matching template:
 - Project loaded → `ruby ~/.plastic/scripts/dashboard.rb project <slug> --data`

package/skills/continuing/evals/evals.json

@@ -1,6 +1,6 @@
 {
   "skill_name": "plastic-continuing",
-  "notes": "Intent 36. Scopes: description triggering (1-8) and behavior/convention compliance of the rewritten boot orchestrator (9-14). Triggering assertions follow the plastic-auto eval style (one subagent router per case). Behavior assertions are convention checks against the rewritten SKILL.md.",
+  "notes": "Intent 36, updated for 36a (boot moved into hook-session-start; the skill is now work-continuation only). Scopes: description triggering (1-8) and behavior/convention compliance of the work-continuation skill (9-14). Triggering assertions follow the plastic-auto eval style (one subagent router per case). Behavior assertions are convention checks against the SKILL.md.",
   "results": {
     "triggering": { "cases": 8, "passed": 8, "run": "2026-06-16, one subagent per case" },
     "behavior": { "cases": 6, "passed": 6, "evidence": "convention checks against skills/continuing/SKILL.md after the intent-36 rewrite; doctor --core verified at 0.07s with 9 liveness checks and full doctor unchanged at 30 checks" }
@@ -36,7 +36,7 @@
     {
       "id": 4, "scope": "triggering", "set": "train",
       "prompt": "boot plastic and show me where things stand",
-      "expected_output": "Activates plastic-continuing (boot + present state is the skill's purpose).",
+      "expected_output": "Activates plastic-continuing (continuing work + presenting state is the skill's purpose; boot itself is hook-owned).",
       "files": [],
       "assertions": [
         { "type": "code", "check": "router CHOICE == plastic-continuing", "observed": "plastic-continuing", "result": "pass" }
@@ -80,20 +80,20 @@
     },
     {
       "id": 9, "scope": "behavior", "set": "train",
-      "prompt": "Does the skill document the four-step boot sequence in the fixed order?",
-      "expected_output": "SKILL.md lists, in order: (1) core doctor, (2) load core, (3) version + statusline, (4) dashboard.",
+      "prompt": "Does the skill defer boot to the SessionStart hook rather than running it itself?",
+      "expected_output": "SKILL.md states boot (health check, core context, version banner, statusline) is owned by hook-session-start / plastic-statusline, not this skill.",
       "files": ["skills/continuing/SKILL.md"],
       "assertions": [
-        { "type": "convention", "check": "boot steps appear in order doctor -> load core -> version/statusline -> dashboard", "observed": "headings '### 1. Core doctor', '### 2. Load core', '### 3. Version + statusline', '### 4. Dashboard'", "result": "pass" }
+        { "type": "convention", "check": "SKILL.md says boot is owned by the SessionStart hook and the skill does not run it", "observed": "'Boot is not this skill's job.' paragraph naming hook-session-start and plastic-statusline", "result": "pass" }
       ]
     },
     {
       "id": 10, "scope": "behavior", "set": "train",
-      "prompt": "Does step 1 run the fast core health check synchronously?",
-      "expected_output": "Step 1 invokes `doctor.rb --core` and prints a single health line.",
+      "prompt": "Does the skill avoid running doctor / setting the statusline itself?",
+      "expected_output": "SKILL.md does NOT instruct running doctor.rb --core or setting the statusline; it attributes those to the hooks.",
       "files": ["skills/continuing/SKILL.md"],
       "assertions": [
-        { "type": "convention", "check": "SKILL.md contains 'doctor.rb --core' and a 'Plastic core: healthy' health line", "observed": "present in '### 1. Core doctor'", "result": "pass" }
+        { "type": "convention", "check": "no in-skill boot step invokes doctor.rb --core or sets the statusline; both are attributed to hooks", "observed": "doctor --core and statusline mentioned only as hook-owned in the 'Boot is not this skill's job' note", "result": "pass" }
       ]
     },
     {
@@ -102,7 +102,7 @@
       "expected_output": "Project loaded -> `dashboard.rb project <slug>`; otherwise -> `dashboard.rb continue`. Skill only invokes, does not render.",
       "files": ["skills/continuing/SKILL.md"],
       "assertions": [
-        { "type": "convention", "check": "both dashboard invocations present and gated on project detection", "observed": "'dashboard.rb project <slug>' and 'dashboard.rb continue' in '### 4. Dashboard'", "result": "pass" }
+        { "type": "convention", "check": "both dashboard invocations present and gated on project detection", "observed": "'dashboard.rb project <slug>' and 'dashboard.rb continue' in the 'Continue (present the dashboard)' section", "result": "pass" }
       ]
     },
     {