@zalom/plastic 1.0.0-beta.28 → 1.0.0-beta.29

package/package.json

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

package/scripts/lib/link_suggestions.rb

@@ -10,7 +10,8 @@
 #                  and surface each candidate's `## Intent` + `## Context` as the
 #                  EVIDENCE an agent reads to judge influence.
 #   - record_edge: record a CONFIRMED `sources`/`chain` frontmatter edge AND append a
-#                  line to `link-decisions.md` (utc, target, edge, rating, reason).
+#                  dated line to the subject intent file's `## Insights` section
+#                  carrying (utc, target, edge, rating, reason).
 #                  Append-only, frontmatter block only, never a `## Links` line,
 #                  never a delete. A no-op without confirm: true.
 #   - drift:       flag any `## Links` wikilink with no matching frontmatter edge.
@@ -30,6 +31,7 @@
 
 require "time"
 require_relative "intent_validator"
+require_relative "insights"
 
 class LinkSuggestions
   # One discovery candidate plus the evidence an agent reads to judge influence.
@@ -181,7 +183,7 @@ class LinkSuggestions
 
   # Record a single CONFIRMED edge from `subject_id` to `target_id`:
   #   1. append `target_id` to the subject's frontmatter `sources` or `chain`;
-  #   2. append a line to `link-decisions.md` in the subject dir capturing
+  #   2. append a dated line to the subject's `## Insights` section capturing
   #      {utc, target, edge, rating, reason}.
   # Append-only, frontmatter block only. NEVER writes a `## Links` line, NEVER
   # deletes. A no-op (returns false) without confirm: true, so a default run mutates
@@ -199,8 +201,8 @@ class LinkSuggestions
     updated = add_frontmatter_ref(content, edge.to_s, target_id)
     return false if updated == content
 
-    reader.write(subject[:path], updated)
-    append_decision(subject, target_id, edge, rating, reason, now)
+    final = append_link_insight(updated, target_id, edge, rating, reason, now)
+    reader.write(subject[:path], final)
     true
   end
 
@@ -220,20 +222,15 @@ class LinkSuggestions
 
   private
 
-  # Append one decision line to `link-decisions.md` in the subject's dir, creating the
-  # ledger with a header when absent. Append-only; never rewrites prior lines.
-  def append_decision(subject, target_id, edge, rating, reason, now)
-    ledger = File.join(subject[:dir], "link-decisions.md")
-    stamp = now.utc.strftime("%Y-%m-%dT%H:%M:%SZ")
-    line = "#{stamp} | #{target_id} | #{edge} | #{rating || "-"} | #{reason || "-"}"
-
-    if reader.exist?(ledger)
-      existing = reader.read(ledger)
-      reader.write(ledger, existing.rstrip + "\n" + line + "\n")
-    else
-      header = "# Link decisions (intent 91 D6): utc | target | edge | rating | reason\n\n"
-      reader.write(ledger, header + line + "\n")
-    end
+  # Insert one dated link-decision line at the bottom of the subject intent file's
+  # `## Insights` section (96 D3: link rationale lives IN the intent file, never a side
+  # file). Reuses the blessed Insights writer (intent 82) for section insertion; carries
+  # the five fields (utc, target, edge, rating, reason) as a readable line under the 82
+  # exact-timestamp prefix. Returns the augmented content for the single caller write.
+  def append_link_insight(content, target_id, edge, rating, reason, now)
+    prefix = "#{now.utc.iso8601} · Link · link-suggest"
+    text = "#{edge} edge to #{target_id} (rating #{rating || "-"}): #{reason || "-"}"
+    Insights.with_entry(content, "#{prefix} — #{text}")
   end
 
   # Natural sort key for ids so 2 sorts before 10 and 14a groups with 14.

package/scripts/link-suggest

@@ -5,9 +5,9 @@
 # link-suggest - support links decided by CONTEXT INFLUENCE (intent 91, D7). Links are
 # NOT graded by a script: whether one intent's context influenced another is a
 # judgement an agent makes by reading the candidate's Intent + Context. This tool
-# gathers candidates with that evidence, records a CONFIRMED edge plus its rating and
-# reason in `link-decisions.md`, and flags drift. It never writes a `## Links` line and
-# never deletes.
+# gathers candidates with that evidence, records a CONFIRMED edge in frontmatter plus a
+# dated rating/reason line in the intent's `## Insights` section, and flags drift. It
+# never writes a `## Links` line and never deletes.
 #
 # `## Links` is a DERIVED view of `sources`/`chain` (Convention over Configuration).
 # Tiers, by context influence:
@@ -42,8 +42,9 @@ module LinkSuggestCLI
 
     Links are decided by context influence, judged by an agent reading each
     candidate's Intent + Context. This tool only gathers candidates with that
-    evidence, records a confirmed edge plus its rating/reason in link-decisions.md,
-    and flags drift. It never writes a ## Links line and never deletes.
+    evidence, records a confirmed edge plus its rating/reason in the intent's
+    ## Insights section, and flags drift. It never writes a ## Links line and
+    never deletes.
 
     --edge is explicit and required (sources is decided by origin, never inferred).
     --rating is required when --edge is chain. Without --confirm, nothing is written.
@@ -132,7 +133,8 @@ module LinkSuggestCLI
                              reason: opts[:reason], confirm: true)
     if wrote
       out.puts "Recorded #{opts[:edge]} edge #{opts[:subject]} -> #{opts[:record]} " \
-               "and appended to link-decisions.md. Reproject with scripts/project-links."
+               "and appended a rating/reason line to the intent's ## Insights. " \
+               "Reproject ## Links with scripts/project-links."
       return 0
     end
     out.puts "No edge written (edge may already exist, or intent missing)."

package/skills/linking-intents/SKILL.md

@@ -38,9 +38,9 @@ Two distinct steps, do not conflate them:
 It does not wait for code to exist; it is reasoning over the candidate's context, not over a diff.
 
 **Record the call.** For every edge an agent adds, store a rating (high / medium / low) plus a
-one-line reason in `link-decisions.md` in the intent dir. Keep it out of frontmatter (graph only)
-and out of the `## Links` label (which is projected), so the audit trail never breaks the
-projection identity.
+one-line reason as a dated line under the intent file's `## Insights` section (per 96 D3, link
+rationale lives in the intent file, not a side file). It stays out of frontmatter (graph only) and
+out of the projected `## Links` label, so the audit trail never breaks the projection identity.
 
 ## `## Links` is derived (never author it by hand)