docupuncture 0.1.5 → 0.1.7

package/README.md

@@ -1,10 +1,10 @@
-# Docupuncture
+# DocuPuncture
 
 Treat the document you already have.
 
 Insert precise edits without changing the theme, format, comments, or history.
 
-When an AI regenerates a Google Doc, Sheet, or deck, those things usually go with it. Docupuncture writes a small Apps Script you paste and run on the live file.
+When an AI regenerates a Google Doc, Sheet, or deck, those things usually go with it. DocuPuncture writes a small Apps Script you paste and run on the live file.
 
 ## The skills
 
@@ -44,7 +44,7 @@ The script is safe to re-run. Missing anchors are logged. It never invents a loc
 
 The other tools in the shop strike, press, or contain. A needle is still metal from the same fire, but you don't swing it. You place it.
 
-Acupuncture treats a living body in place: insert at a point, leave the rest alone. Docupuncture does that to a document you already care about.
+Acupuncture treats a living body in place: insert at a point, leave the rest alone. DocuPuncture does that to a document you already care about.
 
 Closest cousin on the shelf is [TemperPass](https://temperpass.dev): a rule set you point an agent at.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "docupuncture",
-	"version": "0.1.5",
+	"version": "0.1.7",
 	"private": false,
 	"type": "module",
 	"description": "Insert precise edits without changing the theme, format, comments, or history.",

package/skills/docupuncture-docs/SKILL.md

@@ -1,32 +1,32 @@
 ---
 name: docupuncture-docs
-description: Precise in-place edits to an existing Google Doc via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Doc (or says "docupuncture") — deliver a self-contained script that patches the live doc while preserving all formatting, instead of regenerating a new document. Prefer this over full regeneration for formatted docs. Part of the Docupuncture family (Docs, Sheets, Slides).
+description: Precise in-place edits to an existing Google Doc via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Doc (or says "DocuPuncture") — deliver a self-contained script that patches the live doc while preserving all formatting, instead of regenerating a new document. Prefer this over full regeneration for formatted docs. Part of the DocuPuncture family (Docs, Sheets, Slides).
 ---
 
-# Docupuncture for Docs
+# DocuPuncture for Docs
 
-Docupuncture = insert precise edits without changing the theme, format, comments, or history. This skill is the **Docs** implementation.
+DocuPuncture = insert precise edits without changing the theme, format, comments, or history. This skill is the **Docs** implementation.
 
-Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs, instead of regenerating a new document. In-place patching preserves all formatting (fonts, colors, images, tables, comments, theme) that API imports and full regenerations destroy. Use the name "docupuncture" when referring to this workflow with the user.
+Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs, instead of regenerating a new document. In-place patching preserves all formatting (fonts, colors, images, tables, comments, theme) that API imports and full regenerations destroy. Use the name "DocuPuncture" when referring to this workflow with the user.
 
 
 ## When to offer
 
 Whenever the user asks for edits, tweaks, or iterations to an existing Google Doc — especially repeated iteration rounds — use AskUserQuestion to offer:
 
-1. **Docupuncture: Apps Script patch** (recommended for formatted docs) — I generate a script; you run it once. Formatting preserved. First run requires a one-time authorization prompt.
+1. **DocuPuncture: Apps Script patch** (recommended for formatted docs) — I generate a script; you run it once. Formatting preserved. First run requires a one-time authorization prompt.
 2. **New generated doc** — full regeneration (warn: loses theme/logo/comments).
 3. **Manual edit checklist** — exact paste-ready text.
 
-Skip the question and go straight to the script if the user says "docupuncture" or has already established this preference in the conversation.
+Skip the question and go straight to the script if the user says "DocuPuncture" or has already established this preference in the conversation.
 
 ### Edit volume / risk guidance
 
 Before generating the script, quickly assess the size and nature of the requested changes:
 
-- **Low risk** (1–5 discrete edits, mostly text swaps or simple inserts/deletes): proceed with pure docupuncture.
-- **Medium risk** (6–10 edits or light structural work): still prefer docupuncture, but warn the user that a fresh re-read of the doc is required if they make manual changes between runs, and consider splitting into two smaller scripts if the anchors feel fragile.
-- **High risk** (>10 discrete edits, major restructuring, multi-section moves, or many interdependent changes): strongly recommend breaking into multiple sequential docupuncture rounds, or switching to a full regeneration / hybrid approach. Do not force a single massive script.
+- **Low risk** (1–5 discrete edits, mostly text swaps or simple inserts/deletes): proceed with pure DocuPuncture.
+- **Medium risk** (6–10 edits or light structural work): still prefer DocuPuncture, but warn the user that a fresh re-read of the doc is required if they make manual changes between runs, and consider splitting into two smaller scripts if the anchors feel fragile.
+- **High risk** (>10 discrete edits, major restructuring, multi-section moves, or many interdependent changes): strongly recommend breaking into multiple sequential DocuPuncture rounds, or switching to a full regeneration / hybrid approach. Do not force a single massive script.
 
 If the set of changes is high-risk, surface this explicitly to the user before writing the script.
 

package/skills/docupuncture-docs/references/sample-skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Docupuncture script skeleton (Docs)
+ * DocuPuncture script skeleton (Docs)
  *
  * Usage:
  * 1. Open the target Google Doc → Extensions → Apps Script

package/skills/docupuncture-sheets/SKILL.md

@@ -1,27 +1,27 @@
 ---
 name: docupuncture-sheets
-description: Precise in-place edits to an existing Google Sheet via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Sheet (or says "docupuncture" in a sheets context) — deliver a self-contained script that patches the live spreadsheet while preserving formatting, notes, data validation, and structure, instead of regenerating a new sheet.
+description: Precise in-place edits to an existing Google Sheet via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Sheet (or says "DocuPuncture" in a sheets context) — deliver a self-contained script that patches the live spreadsheet while preserving formatting, notes, data validation, and structure, instead of regenerating a new sheet.
 ---
 
-# Docupuncture for Sheets
+# DocuPuncture for Sheets
 
-Docupuncture applied to Google Sheets: insert precise edits without changing the theme, format, comments, or history. Notes, data validation, charts, and structure stay too. Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs.
+DocuPuncture applied to Google Sheets: insert precise edits without changing the theme, format, comments, or history. Notes, data validation, charts, and structure stay too. Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs.
 
-Use the name "docupuncture" (or "docupuncture on this sheet") when referring to this workflow.
+Use the name "DocuPuncture" (or "DocuPuncture on this sheet") when referring to this workflow.
 
 ## When to offer
 
 Whenever the user asks for edits, tweaks, or iterations to an existing Google Sheet — especially repeated rounds — offer:
 
-1. **Docupuncture: Apps Script patch** (recommended) — I generate a script; you run it once. Formatting, notes, and validation preserved.
+1. **DocuPuncture: Apps Script patch** (recommended) — I generate a script; you run it once. Formatting, notes, and validation preserved.
 2. **New generated sheet** — full regeneration (warn: loses most formatting, notes, validation, charts).
 3. **Manual edit checklist** — exact values/ranges to change.
 
-Skip the question if the user already said "docupuncture" or established the preference.
+Skip the question if the user already said "DocuPuncture" or established the preference.
 
 ### Edit volume / risk guidance
 
-- **Low risk** (1–6 discrete cell/range updates): pure docupuncture.
+- **Low risk** (1–6 discrete cell/range updates): pure DocuPuncture.
 - **Medium risk** (7–12 updates or light structural work such as inserting a few rows): still preferred, but warn about anchor drift.
 - **High risk** (large structural changes, many interdependent formulas, or wholesale table rewrites): recommend sequential smaller scripts or full regeneration.
 

package/skills/docupuncture-sheets/references/sample-skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Docupuncture for Sheets – sample skeleton
+ * DocuPuncture for Sheets – sample skeleton
  *
  * Paste into the target spreadsheet's Extensions → Apps Script, then run
  * applyEdits. With DRY_RUN = true it only logs what it WOULD change;

package/skills/docupuncture-slides/SKILL.md

@@ -1,27 +1,27 @@
 ---
 name: docupuncture-slides
-description: Precise in-place edits to an existing Google Slides presentation via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Slides deck (or says "docupuncture" in a slides context) — deliver a self-contained script that patches the live presentation while preserving layout, styles, and structure, instead of regenerating a new deck.
+description: Precise in-place edits to an existing Google Slides presentation via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Slides deck (or says "DocuPuncture" in a slides context) — deliver a self-contained script that patches the live presentation while preserving layout, styles, and structure, instead of regenerating a new deck.
 ---
 
-# Docupuncture for Slides
+# DocuPuncture for Slides
 
-Docupuncture applied to Google Slides: insert precise edits without changing the theme, format, comments, or history. Layout and speaker notes stay too. Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs.
+DocuPuncture applied to Google Slides: insert precise edits without changing the theme, format, comments, or history. Layout and speaker notes stay too. Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs.
 
-Use the name "docupuncture" (or "docupuncture on these slides") when referring to this workflow.
+Use the name "DocuPuncture" (or "DocuPuncture on these slides") when referring to this workflow.
 
 ## When to offer
 
 Whenever the user asks for edits, tweaks, or iterations to an existing Google Slides presentation — especially repeated rounds — offer:
 
-1. **Docupuncture: Apps Script patch** (recommended for content/text changes) — I generate a script; you run it once. Layout and theme preserved.
+1. **DocuPuncture: Apps Script patch** (recommended for content/text changes) — I generate a script; you run it once. Layout and theme preserved.
 2. **New generated deck** — full regeneration (warn: loses theme, precise positioning, speaker notes, etc.).
 3. **Manual edit checklist** — exact text or slide-by-slide changes.
 
-Skip the question if the user already said "docupuncture" or established the preference.
+Skip the question if the user already said "DocuPuncture" or established the preference.
 
 ### Edit volume / risk guidance
 
-- **Low risk** (1–6 text replacements or simple content updates on existing shapes): pure docupuncture.
+- **Low risk** (1–6 text replacements or simple content updates on existing shapes): pure DocuPuncture.
 - **Medium risk** (7–12 changes or light additions of text boxes): still preferred.
 - **High risk** (major layout restructuring, many new slides, complex object insertion/repositioning): recommend sequential smaller scripts or full regeneration. Positioning is fragile.
 

package/skills/docupuncture-slides/references/sample-skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Docupuncture for Slides – sample skeleton
+ * DocuPuncture for Slides – sample skeleton
  *
  * Paste into the target presentation's Extensions → Apps Script, then run
  * applyEdits. With DRY_RUN = true it only logs what it WOULD change;