@ghl-ai/aw 0.1.39-beta.12 → 0.1.39-beta.14

package/ecc.mjs

@@ -10,7 +10,7 @@ import { applyStoredStartupPreferences } from "./startup.mjs";
 
 const AW_ECC_REPO_SSH = "git@github.com:shreyansh-ghl/aw-ecc.git";
 const AW_ECC_REPO_HTTPS = "https://github.com/shreyansh-ghl/aw-ecc.git";
-export const AW_ECC_TAG = "v1.4.36";
+export const AW_ECC_TAG = "v1.4.37";
 
 const MARKETPLACE_NAME = "aw-marketplace";
 const PLUGIN_KEY = `aw@${MARKETPLACE_NAME}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.39-beta.12",
+  "version": "0.1.39-beta.14",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": {

package/render-rules.mjs

@@ -6,7 +6,12 @@ import { homedir } from 'node:os';
 import * as fmt from './fmt.mjs';
 import { RULES_RUNTIME_DIR } from './constants.mjs';
 
-const GENERATED_HEADER = '<!-- Generated by aw — do not edit manually -->\n\n';
+// The marker is placed AFTER the YAML frontmatter so Cursor/Markdown parsers
+// see the frontmatter at byte 0. Putting an HTML comment before --- breaks
+// Cursor's alwaysApply/globs detection.
+const GENERATED_MARKER = '<!-- Generated by aw — do not edit manually -->';
+// Legacy header (pre-pattern comment first) — kept for pruning old files.
+const LEGACY_GENERATED_HEADER = '<!-- Generated by aw — do not edit manually -->\n\n';
 const STACK_OVERLAY_FLAG = 'AW_ENABLE_STACK_OVERLAY_RULES';
 
 /** Rule scope → Cursor .mdc glob patterns */
@@ -196,7 +201,8 @@ function pruneStaleGeneratedRules(outputDir, expectedFilenames) {
 
     const fullPath = join(outputDir, entry.name);
     const content = readOrNull(fullPath);
-    if (!content?.startsWith(GENERATED_HEADER)) continue;
+    // Match both new pattern (marker after frontmatter) and legacy (marker at top).
+    if (!content || (!content.includes(GENERATED_MARKER) && !content.startsWith(LEGACY_GENERATED_HEADER))) continue;
 
     try {
       unlinkSync(fullPath);
@@ -303,7 +309,9 @@ function renderCursorRules(cwd, rulesDir, options = {}) {
       }
     }
 
-    const content = GENERATED_HEADER + frontmatter.join('\n') + '\n\n' + agentsMd.trim() + '\n' + refSection;
+    // Frontmatter MUST be at byte 0 for Cursor's YAML parser.
+    // Generated marker goes on the line immediately after the closing ---.
+    const content = frontmatter.join('\n') + '\n' + GENERATED_MARKER + '\n\n' + agentsMd.trim() + '\n' + refSection;
     writeFileSync(join(cursorRulesDir, `${scopeToFilename(scope)}.mdc`), content);
     count++;
   }
@@ -314,14 +322,70 @@ function renderCursorRules(cwd, rulesDir, options = {}) {
   writeFileSync(join(cursorRulesDir, 'common-aw-routing.mdc'), routingRule);
   count++;
 
+  // Generate the prompt-response-format rule — machine-parseable trace
+  // of what skills/rules/MCPs were used during a response.
+  const traceRule = generateCursorPromptTraceRule();
+  writeFileSync(join(cursorRulesDir, 'common-prompt-trace.mdc'), traceRule);
+  count++;
+
   return count;
 }
 
+function generateCursorPromptTraceRule() {
+  // Frontmatter MUST be at byte 0. Machine-parseable JSON block at end of response.
+  return `---
+description: "Append a machine-parseable AW trace at the end of every response"
+alwaysApply: true
+---
+${GENERATED_MARKER}
+
+# AW Prompt Trace
+
+At the end of every substantive response, append a JSON-fenced block named \`aw-trace\` with the skills, rules, and MCPs that were loaded or applied during the response.
+
+## Format
+
+\`\`\`aw-trace
+{
+  "route": "/aw-plan",
+  "skills_used": ["using-aw-skills", "aw-plan", "incremental-implementation"],
+  "rules_applied": ["common-aw-routing", "universal", "security", "backend"],
+  "mcps_used": ["context7", "exa-search"],
+  "artifacts_written": [".aw_docs/features/<slug>/spec.md"]
+}
+\`\`\`
+
+## Field semantics
+
+| Field | Type | Required | Notes |
+|---|---|---|---|
+| \`route\` | string | yes | Selected AW route (e.g. \`/aw-plan\`, \`/aw-build\`) |
+| \`skills_used\` | string[] | yes | Skill names actually Read during the response. \`[]\` if none |
+| \`rules_applied\` | string[] | yes | Rule names from \`~/.cursor/rules/*.mdc\` or \`~/.aw_rules/\` that informed the response |
+| \`mcps_used\` | string[] | yes | MCP server names invoked. \`[]\` if none |
+| \`artifacts_written\` | string[] | optional | Files created or modified |
+
+## Rules
+
+- Always include the trace block — even for trivial responses (use \`[]\` for empty arrays).
+- Skill and rule names must match the on-disk basenames (no \`.mdc\` / \`.md\` extension).
+- The trace goes AFTER the substantive response, never before.
+- Do not include skills/rules that were merely "available" — only those that actually influenced this response.
+
+## Why
+
+This makes routing observable. Tools, audits, and compliance checks can parse the trace JSON to verify that the right AW routing happened (route selected → stage skill loaded → relevant rules applied) without scraping prose.
+`;
+}
+
 function generateCursorAwRoutingRule() {
-  return `${GENERATED_HEADER}---
+  // Frontmatter MUST be at byte 0 for Cursor's alwaysApply/globs detection.
+  return `---
 description: "AW global routing: select route, READ stage skill, then respond"
 alwaysApply: true
 ---
+${GENERATED_MARKER}
+
 # AW Global Routing
 
 ## Hard Gate (MUST — do not skip)
@@ -460,7 +524,8 @@ function renderClaudeRules(cwd, rulesDir, options = {}) {
       }
     }
 
-    const content = GENERATED_HEADER + frontmatter + agentsMd.trim() + '\n' + refSection;
+    // Claude Code reads .md frontmatter similarly — keep marker after frontmatter.
+    const content = frontmatter + GENERATED_MARKER + '\n\n' + agentsMd.trim() + '\n' + refSection;
     writeFileSync(join(claudeRulesDir, `${scopeToFilename(scope)}.md`), content);
     count++;
   }