dsh-artcraft-plugin-gridcraft 0.2.8 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-artcraft-plugin-gridcraft",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "private": false,
   "type": "module",
   "description": "DSH plugin: drive GridCraft (spreadsheets) headlessly through its own CLI and MCP server.",

package/src/kit/suite.js

@@ -0,0 +1,80 @@
+/**
+ * The ArtCraft suite graph: which applications work together.
+ *
+ * A user who installs one craft has a working tool, not the best version of the
+ * workflow they are about to attempt: a report wants a spreadsheet and a word
+ * processor, a video wants slides and a mixer. This is the one place that
+ * knowledge lives, so the installer, the doctor and the plugins agree.
+ * @module @dsh-artcraft/craft-kit/suite
+ */
+
+/** A workflow that spans several crafts. */
+                                
+                     
+                           
+                                    
+ 
+
+/** A package that is not a craft but completes the experience. */
+                                 
+                     
+                          
+                      
+ 
+
+/** Workflows that need more than one craft. */
+export const SUITE_WORKFLOWS                           = [
+  { id: 'report', delivers: 'a data-backed report as DOCX and PDF', crafts: ['gridcraft', 'wordcraft', 'pdfcraft'] },
+  { id: 'deck', delivers: 'a presentation with native charts', crafts: ['gridcraft', 'deckcraft', 'pdfcraft'] },
+  { id: 'explainer-video', delivers: 'a narrated video from slides', crafts: ['deckcraft', 'filmcraft', 'soundcraft'] },
+  { id: 'motion', delivers: 'a motion-graphics piece cut with the video', crafts: ['effectcraft', 'filmcraft'] },
+  { id: 'brand-kit', delivers: 'a design system turned into a brand book', crafts: ['figcraft', 'vectorcraft', 'designcraft'] },
+  { id: 'photo-pipeline', delivers: 'raw files developed and retouched for web and print', crafts: ['lightcraft', 'photocraft'] },
+  { id: 'print-layout', delivers: 'a print-ready layout with images and graphics', crafts: ['photocraft', 'vectorcraft', 'designcraft'] },
+  { id: 'cad-set', delivers: 'a drawing set delivered as one PDF', crafts: ['cadcraft', 'pdfcraft'] },
+  { id: 'texture-kit', delivers: 'PBR maps baked and packed for a 3D asset', crafts: ['texturecraft', 'photocraft'] },
+]
+
+/** Packages that improve every craft. */
+export const SUITE_COMPANIONS                            = [
+  {
+    id: 'preview-panel',
+    package: 'dsh-artcraft-preview-panel',
+    why: 'shows each step of the document inside the DSH Web GUI, and starts the local preview server',
+  },
+  {
+    id: 'skills',
+    package: 'dsh-artcraft-skills',
+    why: 'the workflows themselves (report, brand kit, explainer video, drawing set, conversion) as agent skills',
+  },
+]
+
+/**
+ * Missing crafts of the workflows a user has already started.
+ * @param installed - craft ids currently installed.
+ * @returns one entry per missing craft, best-completing workflow first.
+ */
+export function suggestCrafts(installed                   )                                                                                         {
+  const have = new Set(installed)
+  const missing = new Map                                                                                              ()
+  for (const workflow of SUITE_WORKFLOWS) {
+    const present = workflow.crafts.filter(craft => have.has(craft))
+    if (present.length === 0 || present.length === workflow.crafts.length) continue
+    for (const craft of workflow.crafts) {
+      if (have.has(craft)) continue
+      const existing = missing.get(craft)
+      const candidate = { craft, forWorkflow: workflow.id, delivers: workflow.delivers, has: present.length, needs: workflow.crafts.length }
+      if (existing === undefined || candidate.has / candidate.needs > existing.has / existing.needs) missing.set(craft, candidate)
+    }
+  }
+  return [...missing.values()].sort((a, b) => b.has / b.needs - a.has / a.needs || a.craft.localeCompare(b.craft))
+}
+
+/**
+ * The workflows one craft takes part in.
+ * @param craft - craft id.
+ * @returns the workflows containing it.
+ */
+export function workflowsOf(craft        )                  {
+  return SUITE_WORKFLOWS.filter(workflow => workflow.crafts.includes(craft))
+}

package/src/kit/tools.js

@@ -10,6 +10,7 @@
 
 import { craftCallView, craftResultView } from './present.js'
 import { canPreview, nextStepNumber, previewRoot, recordPreview, renderPreview, stepName } from './preview.js'
+import { workflowsOf } from './suite.js'
 import { appendJournal } from './journal.js'
 import { CraftMcpClient, renderSchema } from './mcp.js'
                                        
@@ -1157,7 +1158,14 @@ export function applyCraftPlugin(
       + (profile.mcpAttach === undefined
         ? ''
         : `When the user has ${profile.product} open, pass \`attach: <control port>\` to an mcp call to work in their window instead of a headless copy. `)
-      + `Images returned by a render or screenshot are saved and named by path; look at them with \`read_image\`.`,
+      + `Images returned by a render or screenshot are saved and named by path; look at them with \`read_image\`.`
+      + (() => {
+        const partners = [...new Set(workflowsOf(profile.id).flatMap(workflow => workflow.crafts).filter(craft => craft !== profile.id))]
+        if (partners.length === 0) return ''
+        // A half-installed workflow is the common gap: name the partners so the
+        // agent can offer the missing plugin instead of failing at the join.
+        return ` Workflows that start in ${profile.product} usually also need ${partners.join(', ')}: if one of those tools is unavailable, say which plugin provides it and offer to install it.`
+      })(),
     order: CRAFT_SECTION_ORDER,
   })
   return () => {