@zalom/plastic 1.0.0-alpha.14 → 1.0.0-alpha.16

package/PLASTIC.md

@@ -61,10 +61,10 @@ The connection: an intent's `## Insights` feeds the Coordinator's Observe phase.
 
 | Stage | Section | Deliverable | Detail |
 |-------|---------|-------------|--------|
-| **What** | `## Intent` | `{ID}--{slug}.md` | `plastic:creating-intent` |
-| **Why** | `## Context` + Decisions | `spec.md` | `plastic:brainstorming` |
-| **How** | Planning | `plan.md` + `actions/` + `checklist.md` | `plastic:writing-plans` |
-| **Exec** | Execution | `outcome.md` | `plastic:executing-plan` |
+| **What** | `## Intent` | `{ID}--{slug}.md` | `plastic-creating-intent` |
+| **Why** | `## Context` + Decisions | `spec.md` | `plastic-brainstorming` |
+| **How** | Planning | `plan.md` + `actions/` + `checklist.md` | `plastic-writing-plans` |
+| **Exec** | Execution | `outcome.md` | `plastic-executing-plan` |
 
 `## Insights` — append-only work log captured throughout ALL stages.
 For full lifecycle detail, the skills in the Detail column have references/.
@@ -136,7 +136,7 @@ A Zettelkasten structure note, not a table of contents. Clusters by meaning.
 
 Sections: `## Active`, `## Future`, `## Clusters`, `## Abandoned`, `## Completed`.
 
-For index maintenance, use `plastic:managing-index`.
+For index maintenance, use `plastic-managing-index`.
 
 ## Rules for Skills
 
@@ -165,16 +165,16 @@ Detailed conventions live inside the skills that use them, not in this file.
 
 | Topic | Skill | References in skill |
 |-------|-------|-------------------|
-| Creating intents, lifecycle | `plastic:creating-intent` | lifecycle, wikilinks |
-| Brainstorming, spec writing | `plastic:brainstorming` | — |
-| Planning, actions | `plastic:writing-plans` | — |
-| Execution, delivery | `plastic:executing-plan` | — |
-| Autonomous delivery | `plastic:auto` | agent architecture |
-| Save/restore state | `plastic:savepoint`, `plastic:continuing` | context management |
-| Knowledge graph, linking | `plastic:linking-intents` | zettelkasten, wikilinks |
-| Projects, hubs | `plastic:creating-project` | hubs, project stores |
-| Index maintenance | `plastic:managing-index` | — |
-| Releases, deprecations | `plastic:releasing` | deprecation process |
-| Health diagnostics | `plastic:doctor` | gate enforcement, stuck detection |
-| Writing agent instructions | `plastic:writing-instructions` | agentskills.io spec |
-| Evaluating skills, evals | `plastic:evaluating-skills` | eval methodology, convention checks |
+| Creating intents, lifecycle | `plastic-creating-intent` | lifecycle, wikilinks |
+| Brainstorming, spec writing | `plastic-brainstorming` | — |
+| Planning, actions | `plastic-writing-plans` | — |
+| Execution, delivery | `plastic-executing-plan` | — |
+| Autonomous delivery | `plastic-auto` | agent architecture |
+| Save/restore state | `plastic-savepoint`, `plastic-continuing` | context management |
+| Knowledge graph, linking | `plastic-linking-intents` | zettelkasten, wikilinks |
+| Projects, hubs | `plastic-creating-project` | hubs, project stores |
+| Index maintenance | `plastic-managing-index` | — |
+| Releases, deprecations | `plastic-releasing` | deprecation process |
+| Health diagnostics | `plastic-doctor` | gate enforcement, stuck detection |
+| Writing agent instructions | `plastic-writing-instructions` | agentskills.io spec |
+| Evaluating skills, evals | `plastic-evaluating-skills` | eval methodology, convention checks |

package/README.md

@@ -38,6 +38,13 @@ npx @zalom/plastic --claude
 Replace `--claude` with `--codex` for Codex CLI, `--hermes` for Hermes, or
 `--all` for all supported agents.
 
+Bun users can substitute `bunx` for `npx` (e.g. `bunx @zalom/plastic@alpha --claude`).
+Bun is never required.
+
+Skills install as flat, hyphen-namespaced personal skills (`plastic-doctor`,
+`plastic-auto`, …) — invoke them with a hyphen. Plastic is **not** a Claude Code
+plugin; re-running the installer auto-removes any legacy plugin registration.
+
 ### Updating
 
 From within your agent, say "update plastic" or run:
@@ -46,25 +53,25 @@ From within your agent, say "update plastic" or run:
 npx @zalom/plastic@alpha --claude
 ```
 
-The `plastic:update` command shows available versions across all channels and
+The `plastic-update` command shows available versions across all channels and
 lets you choose which to install.
 
 ## Quick Start
 
 After installation, run `/clear` to load Plastic conventions, then:
 
-1. Say "new intent" or run `/plastic:creating-intent` to create your first intent
+1. Say "new intent" or run `/plastic-creating-intent` to create your first intent
 2. Describe what you want to accomplish
-3. Use `/plastic:brainstorming` to explore the design
-4. Use `/plastic:writing-plans` to create an implementation plan
-5. Use `/plastic:executing-plan` to deliver it
+3. Use `/plastic-brainstorming` to explore the design
+4. Use `/plastic-writing-plans` to create an implementation plan
+5. Use `/plastic-executing-plan` to deliver it
 
 Or say "auto" to let the agent handle the full lifecycle autonomously.
 
 ## Conventions
 
 All conventions live in `AGENTS.md`, distributed to `~/.plastic/AGENTS.md`
-during installation. Run `plastic:doctor` to check installation health.
+during installation. Run `plastic-doctor` to check installation health.
 
 ## License
 

package/agents/future-intent-researcher.md

@@ -1,5 +1,5 @@
 ---
-name: plastic:future-intent-researcher
+name: plastic-future-intent-researcher
 description: |
   Use this agent to research future intents autonomously. Picks up parked
   intents from INDEX.md, investigates them via web search and codebase analysis,

package/agents/intent-curator.md

@@ -1,5 +1,5 @@
 ---
-name: plastic:intent-curator
+name: plastic-intent-curator
 description: |
   Use this agent when completing or reviewing intents, reorganizing the index,
   or when the intent store needs maintenance. Examples:

package/deprecations.yml

@@ -12,12 +12,13 @@
 #   link: optional URL to migration guide
 
 deprecations:
-  - id: cc-plugin-to-npx
+  - id: cc-plugin-to-hyphen-skills
     severity: warning
-    summary: "Plastic distribution is moving from Claude Code plugin to npx install"
+    summary: "Plastic now ships as flat hyphen-named personal skills (plastic-doctor), not a Claude Code plugin. Invocation changed from plastic:<name> to plastic-<name>."
     migration_steps:
-      - "Install new distribution: npx @zalom/plastic@alpha --claude"
-      - "Verify: check that ~/.plastic/ is intact and hooks work"
-      - "Remove old plugin: /plugin remove plastic"
+      - "Re-run the installer: npx @zalom/plastic@latest --claude (bunx also works)"
+      - "It auto-removes the old plugin/marketplace registration — no /plugin step needed"
+      - "Invoke skills with a hyphen now: /plastic-doctor, /plastic-auto, etc."
+      - "Run /plastic-doctor to verify"
     introduced: "1.0.0"
     removal: "2.0.0"

package/package.json

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

package/scripts/doctor.rb

@@ -12,6 +12,7 @@
 require "json"
 require "yaml"
 require "time"
+require "date"
 
 PLASTIC_HOME = File.join(Dir.home, ".plastic")
 
@@ -150,21 +151,31 @@ def parse_frontmatter(path)
   parts = content.split("---", 3)
   return nil if parts.length < 3
 
-  YAML.safe_load(parts[1]) || {}
+  # created: dates parse as Date objects, which safe_load rejects by default —
+  # permit Date/Time so valid frontmatter isn't misreported as missing.
+  YAML.safe_load(parts[1], permitted_classes: [Date, Time]) || {}
 rescue
   nil
 end
 
 # --- Collect all intent directories (global + project stores) ---
 
+# Child directories of a store, excluding dotfiles/dot-directories
+# (e.g. .obsidian, .git) which are tooling artifacts, not intents.
+def store_intent_dirs(store)
+  Dir.children(store).reject { |e| e.start_with?(".") }.select do |e|
+    File.directory?(File.join(store, e))
+  end
+end
+
 def all_intent_dirs
   dirs = []
 
   global_store = File.join(PLASTIC_HOME, "store")
   if File.directory?(global_store)
-    Dir.children(global_store).each do |entry|
+    store_intent_dirs(global_store).each do |entry|
       full = File.join(global_store, entry)
-      dirs << { path: full, name: entry, scope: "global" } if File.directory?(full)
+      dirs << { path: full, name: entry, scope: "global" }
     end
   end
 
@@ -174,9 +185,9 @@ def all_intent_dirs
       project_store = File.join(projects_root, project, "store")
       next unless File.directory?(project_store)
 
-      Dir.children(project_store).each do |entry|
+      store_intent_dirs(project_store).each do |entry|
         full = File.join(project_store, entry)
-        dirs << { path: full, name: entry, scope: "project:#{project}" } if File.directory?(full)
+        dirs << { path: full, name: entry, scope: "project:#{project}" }
       end
     end
   end
@@ -227,7 +238,7 @@ def check_global_store
   # orphaned_intents — directories in store/ not referenced in INDEX.md
   store_dir = File.join(PLASTIC_HOME, "store")
   if File.directory?(store_dir)
-    intent_dirs = Dir.children(store_dir).select { |e| File.directory?(File.join(store_dir, e)) }
+    intent_dirs = store_intent_dirs(store_dir)
     orphans = intent_dirs.reject { |d| content.include?("store/#{d}") }
 
     if orphans.empty?
@@ -459,22 +470,30 @@ def check_claude_registration(agent_dir)
     end
   end
 
-  # skills_exist
-  skills_dir = File.join(agent_dir, "skills", "plastic")
-  if File.directory?(skills_dir) && !Dir.empty?(skills_dir)
-    checks << check(
+  # skills_exist — flat, hyphen-namespaced personal skills (plastic-<name>/)
+  checks << flat_skills_check(agent_dir, "--claude")
+
+  checks
+end
+
+# Plastic skills install as ~/.claude/skills/plastic-<name>/SKILL.md. Pass if at
+# least one such skill is present.
+def flat_skills_check(agent_dir, installer_flag)
+  skills_root = File.join(agent_dir, "skills")
+  found = Dir.glob(File.join(skills_root, "plastic-*", "SKILL.md"))
+
+  if !found.empty?
+    check(
       category: "agent_registration", name: "skills_exist", status: "pass",
-      message: "Skills directory exists at #{tilde(skills_dir)}"
+      message: "#{found.size} plastic-* skill(s) installed in #{tilde(skills_root)}"
     )
   else
-    checks << check(
+    check(
       category: "agent_registration", name: "skills_exist", status: "fail",
-      message: "Skills directory missing or empty at #{tilde(skills_dir)}",
-      fixable: true, fix_hint: "Re-run the Plastic installer: npx @zalom/plastic@latest --claude"
+      message: "No plastic-* skills found in #{tilde(skills_root)}",
+      fixable: true, fix_hint: "Re-run the Plastic installer: npx @zalom/plastic@latest #{installer_flag}"
     )
   end
-
-  checks
 end
 
 def check_generic_agent_registration(agent_key, agent_dir)
@@ -482,19 +501,7 @@ def check_generic_agent_registration(agent_key, agent_dir)
   config = AGENTS[agent_key]
 
   # For codex/hermes: just check skills exist (no settings.json hooks)
-  skills_dir = File.join(agent_dir, "skills", "plastic")
-  if File.directory?(skills_dir) && !Dir.empty?(skills_dir)
-    checks << check(
-      category: "agent_registration", name: "skills_exist", status: "pass",
-      message: "Skills directory exists at #{tilde(skills_dir)}"
-    )
-  else
-    checks << check(
-      category: "agent_registration", name: "skills_exist", status: "fail",
-      message: "Skills directory missing or empty at #{tilde(skills_dir)}",
-      fixable: true, fix_hint: "Re-run the Plastic installer: npx @zalom/plastic@latest --#{agent_key}"
-    )
-  end
+  checks << flat_skills_check(agent_dir, "--#{agent_key}")
 
   checks
 end
@@ -695,7 +702,7 @@ def check_project_stores
       checks << check(
         category: "project_stores", name: "project_yml_exists", status: "warn",
         message: "project.yml missing for project '#{slug}'",
-        fixable: true, fix_hint: "Create project.yml from template — see plastic:creating-project"
+        fixable: true, fix_hint: "Create project.yml from template — see plastic-creating-project"
       )
     end
 

package/scripts/hook-auto-arm

@@ -4,7 +4,7 @@
 
 # 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.
+#   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.
@@ -16,11 +16,11 @@ message = (ARGV[0] || "").downcase
 parts = []
 
 # --- 1. Auto-trigger steering ---
-AUTO_TRIGGERS = ["take it from here", "deliver this", "/plastic:auto", "auto mode"].freeze
+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 " \
+  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

package/scripts/hook-continue

@@ -116,7 +116,7 @@ if stale.any?
   parts << ""
 end
 
-parts << "Follow the plastic:continuing skill workflow.\n"
+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"

package/scripts/hook-gate-check

@@ -102,9 +102,9 @@ if is_stage_file || is_action_file
   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"]

package/scripts/hook-session-start

@@ -168,7 +168,7 @@ 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"
+    update_notice = "Plastic update available: #{cache["current"]} -> #{cache["latest"]} — run /plastic-update"
   end
 end