drafted 1.7.16 → 1.7.18

package/agent-instructions/global.md

@@ -0,0 +1,50 @@
+<drafted>
+Drafted is the shared workspace for agent-produced consulting artifacts. Claude Code and Codex agents should use it proactively when the task benefits from persistent visual work, client-facing documents, reusable skills, or organization knowledge.
+
+Drafted terminology:
+- Wiki: durable organization knowledge. It may also be called the knowledge base or database. Save, compound, curate, and retrieve knowledge here when it should benefit the business, teammates, other agents, or future work by the same person.
+- Skills: reusable operating knowledge. Users may call them skills, procedures, SOPs, standard operating procedures, checklists, methods, protocols, playbooks, or templates for repeatable work. Use them actively before repeatable work, follow them while working, and maintain them when better methods emerge.
+- Projects: client-facing or reviewable work products, organized as frames on a shared surface. Use projects when work should be seen, reviewed, reused, or developed over time rather than left only in chat.
+
+Operating principle:
+- Do not treat Drafted as passive storage. Actively use and maintain the wiki, skills, and projects when they fit the work.
+- Default to creating or updating Drafted project frames for substantive outputs instead of leaving artifacts only in chat. If the user asks you to draft, write, plan, analyze, compare, design, document, summarize, report, spec, model, or make a deck/table, put the durable result on the Drafted surface unless the user explicitly wants chat-only output.
+- Put durable knowledge in the wiki, reusable methods in skills, and producible artifacts in projects.
+- Do not save reusable procedures, SOPs, checklists, methods, protocols, or repeatable work instructions to the wiki/knowledge base. Save them as Drafted skills.
+
+Before working:
+- Check whether Drafted MCP tools are available. If not authenticated, use auth(action="get_link") or auth(action="login") and give the user the sign-in link.
+- Select the correct organization first. Use get_org(action="get") and project(action="list") to identify the target org/project. Opening a project switches org context automatically; for wiki/skill-only work, use get_org(action="switch", orgId=...).
+- Check get_org(action="get") for googleDrive.connected. When Google Drive is connected for the active org, Google Workspace frames are available and should be the strong default for documents, spreadsheets, and presentations.
+- Never assume the current active Drafted project or organization is correct. Verify the returned project/org before writing.
+
+Wiki rules:
+- Search the org wiki before substantive work: wiki(action="search") with relevant keywords.
+- Read relevant pages before creating or changing artifacts.
+- Maintain the wiki when you discover durable knowledge, decisions, client constraints, project context, research notes, or facts that should compound for the business or future agents.
+- When creating or editing wiki pages, return a browser link the user can click.
+
+Skill rules:
+- Treat skill, procedure, SOP, checklist, method, protocol, playbook, and repeatable-work template as the same user intent.
+- Search skills before starting repeatable work: skill(action="search") or skill(action="list").
+- Load and follow relevant skills with skill(action="load"). Read supporting skill files when needed.
+- When the user asks to record, distill, create, save, install, or update a skill/procedure/SOP/checklist/method/protocol/playbook, create or update a Drafted skill for the org with skill tools.
+- Improve skills when you find a better checklist, standard, or operating method.
+
+Project/producible rules:
+- For client-facing, durable, or reviewable artifacts, produce the work inside the appropriate Drafted project instead of leaving it only in chat.
+- Prefer one visible frame per artifact or artifact section so the user can review, compare, and refine work on the surface.
+- Use project(action="open") before frame/asset/connector/layout changes. For every write/edit, confirm the response project matches the intended project.
+- Read anchored frames and existing neighboring frames before editing a layer.
+- After creating frames, documents, diagrams, or other producibles, use focus when available and return the clickable Drafted frame or project link.
+
+Google Workspace rules:
+- If get_org reports googleDrive.connected, strongly prefer Google Workspace frames for business artifacts: google-doc for memos, reports, briefs, SOPs, proposals, and long-form documents; google-sheet for tables, trackers, budgets, research matrices, and models; google-slide for decks and presentation outlines.
+- Create Google Workspace frames with frame(action="write", googleType="google-doc" | "google-sheet" | "google-slide", path="/{layer}/{lane}/{filename}", title="...") after opening the project.
+- For flowcharts, process maps, architecture diagrams, system diagrams, data-flow diagrams, visual maps, or other editable diagrams, load and follow the system skill `excalidraw-drafted` (Drafted Excalidraw Diagram) and create native Drafted Excalidraw frames. Use normal Drafted HTML/markdown frames for web/UI mockups, rich visual layouts, or non-editable presentation artifacts.
+- Use breadcrumbs in code or docs where useful: drafted:<frameId> for frames and drafted-project:<projectId> for projects.
+
+Collaboration rules:
+- Parallel agents must each open and verify their own Drafted project/org context.
+- If there is any doubt about the correct org, project, wiki location, or skill, ask a short clarifying question before writing.
+</drafted>

package/cli/drafted.mjs

@@ -2,7 +2,7 @@
 
 /**
  * Drafted CLI
- * Standalone frame canvas server for Claude agents
+ * Shared surface for agent-produced work, skills, and organization knowledge
  *
  * Extracted from Drafted VSCode extension and adapted for CLI use
  */
@@ -24,6 +24,13 @@ const DEFAULT_PROJECTS_FILE = join(DEFAULT_STATE_DIR, 'projects.json');
 const DEFAULT_PID_FILE = join(DEFAULT_STATE_DIR, 'server.pid');
 const DEFAULT_AUTH_FILE = join(DEFAULT_STATE_DIR, 'auth.json');
 const DEFAULT_PORT = 3477;
+const PACKAGE_VERSION = (() => {
+  try {
+    return JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8')).version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+})();
 
 // Ensure state directory exists
 if (!existsSync(DEFAULT_STATE_DIR)) {
@@ -390,7 +397,8 @@ program
     const { openSync } = await import('fs');
     const outLog = openSync(join(DEFAULT_STATE_DIR, 'server.log'), 'w');
     const tsxPath = join(__dirname, '../node_modules/.bin/tsx');
-    const child = spawn(tsxPath, [serverPath], {
+    const instrumentPath = join(__dirname, '../server/instrument.mjs');
+    const child = spawn(tsxPath, ['--import', instrumentPath, serverPath], {
       detached: true,
       stdio: ['ignore', outLog, outLog],
       env: {
@@ -1022,8 +1030,8 @@ program
 
 program
   .name('drafted')
-  .description('Drafted CLI - Design preview server for Claude agents')
-  .version('1.0.0');
+  .description('Drafted CLI - Shared surface for AI-human collaboration')
+  .version(PACKAGE_VERSION);
 
 program
   .command('mcp-config')