@alessandroraffa/tangyr 4.0.0 → 4.1.0

package/dist/index.js

@@ -16497,7 +16497,10 @@ function resolveCopilotProfile(scope, projectRoot, mappings) {
     hooks: r(slotMap, "hooks"),
     hook_scripts: r(slotMap, "hook_scripts"),
     mcp_shared_file: r(slotMap, "mcp_shared_file"),
-    instructions
+    instructions,
+    // Project-only, like instructions: `.github/instructions` is a repository
+    // surface and has no user-level equivalent Copilot documents.
+    rules: r(slotMap, "rules")
   };
 }
 function resolveCodexProfile(scope, projectRoot, mappings) {
@@ -28327,6 +28330,36 @@ ${frontmatterYaml}${body}`;
   }
   return { agentsAppendix: "", dotRulesFiles };
 }
+function compileCopilotRules(sourceRulesDir) {
+  if (!fs39.existsSync(sourceRulesDir)) {
+    return [];
+  }
+  const files = [];
+  for (const ruleFile of ts(path38.join(sourceRulesDir, "*.md")).sort()) {
+    const name = path38.basename(ruleFile, ".md");
+    const { data } = parseMarkdownFrontmatter(ruleFile);
+    const { body } = parseRule(ruleFile);
+    const declared = data.paths;
+    const applyTo = Array.isArray(declared) ? declared.filter((p) => typeof p === "string").join(", ") : typeof declared === "string" && declared.trim() !== "" ? declared.trim() : "**";
+    const frontmatter = [
+      "---",
+      `applyTo: ${JSON.stringify(applyTo)}`,
+      "x-tangyr:",
+      `  source: rules/${path38.basename(ruleFile)}`,
+      `  hash: ${computeSourceHash(ruleFile)}`,
+      "  target: copilot",
+      "---"
+    ].join("\n");
+    files.push({
+      name: `${name}.instructions.md`,
+      content: `${frontmatter}
+
+${body.trim()}
+`
+    });
+  }
+  return files;
+}
 
 // src/adapters/codex.ts
 var skippedComponents = ["settings", "lsp", "output-styles"];
@@ -29002,12 +29035,7 @@ function promptFrontmatter(data, defaultName) {
 }
 
 // src/adapters/copilot.ts
-var skippedComponents2 = [
-  "rules",
-  "settings",
-  "lsp",
-  "output-styles"
-];
+var skippedComponents2 = ["settings", "lsp", "output-styles"];
 var legacyCopilotAgentsPath = "~/.copilot/agents";
 function syncCopilot(config, sourceRoot, mappings, extensions, options, lossReport, logger, manifest, scopePath) {
   const scope = options.scope ?? "global";
@@ -29018,6 +29046,7 @@ function syncCopilot(config, sourceRoot, mappings, extensions, options, lossRepo
   }).copilot;
   const paths = {
     agents: profile.agents,
+    rules: profile.rules,
     skills: profile.skills,
     prompts: profile.prompts,
     hooks: profile.hooks,
@@ -29051,6 +29080,36 @@ function syncCopilot(config, sourceRoot, mappings, extensions, options, lossRepo
       )
     );
   }
+  if (!shouldSkipComponent3(options, "rules") && !paths.rules) {
+    addLoss(lossReport, "copilot", "rules", {
+      source: "rules",
+      fields: [
+        {
+          field: "rules",
+          action: "rule-path-scoping",
+          severity: resolveLossSeverity(
+            "agent-field",
+            "rules",
+            "rule-path-scoping"
+          ),
+          detail: "Rules: no user-level rules surface for Copilot; `.github/instructions` is a repository path and has no global equivalent"
+        }
+      ]
+    });
+  }
+  if (!shouldSkipComponent3(options, "rules") && paths.rules) {
+    outcomes.push(
+      ...syncRules2(
+        config,
+        sourceRoot,
+        paths.rules,
+        options,
+        logger,
+        manifest,
+        scopePath
+      )
+    );
+  }
   if (!shouldSkipComponent3(options, "agents")) {
     outcomes.push(...cleanupLegacyAgents(paths, options, logger));
     outcomes.push(
@@ -29456,6 +29515,36 @@ function syncMcp3(config, sourceRoot, paths, options, lossReport, logger) {
     logger
   );
 }
+function syncRules2(config, sourceRoot, rulesSlot, options, logger, manifest, scopePath) {
+  const sourceRulesDir = path41.resolve(sourceRoot, config.source.rules);
+  if (!fs41.existsSync(sourceRulesDir)) {
+    return [skippedMissingSource3("rules", sourceRulesDir)];
+  }
+  const destinationRoot = resolveTargetPath(rulesSlot);
+  return compileCopilotRules(sourceRulesDir).map((file) => {
+    const destination = path41.join(destinationRoot, file.name);
+    if (options.dryRun) {
+      logger.info(`[dry-run] rules: compile -> ${destination}`);
+      return {
+        component: "rules",
+        status: "dry-run",
+        path: destination
+      };
+    }
+    return writeCompiledArtifact2(
+      "rules",
+      destination,
+      file.content,
+      void 0,
+      config,
+      sourceRoot,
+      options,
+      logger,
+      manifest,
+      scopePath
+    );
+  });
+}
 function writeCompiledArtifact2(component, destination, content, expectedHash, config, sourceRoot, options, logger, manifest, scopePath) {
   if (!options.force && isCompiledCurrent2(destination, content, expectedHash)) {
     return { component, status: "skipped-current", path: destination };
@@ -29614,7 +29703,7 @@ function syncCursor(config, sourceRoot, mappings, extensions, options, lossRepor
   }
   if (!shouldSkipComponent4(options, "rules")) {
     outcomes.push(
-      ...syncRules2(
+      ...syncRules3(
         config,
         sourceRoot,
         paths,
@@ -29870,7 +29959,7 @@ function syncAgents3(config, sourceRoot, paths, mappings, extensions, options, l
     );
   });
 }
-function syncRules2(config, sourceRoot, paths, mappings, options, lossReport, logger, manifest, scopePath) {
+function syncRules3(config, sourceRoot, paths, mappings, options, lossReport, logger, manifest, scopePath) {
   const sourceRulesDir = path42.join(sourceRoot, config.source.rules);
   if (!fs42.existsSync(sourceRulesDir)) {
     return [skippedMissingSource4("rules", sourceRulesDir)];
@@ -30202,7 +30291,7 @@ function syncCline(config, sourceRoot, mappings, extensions, options, lossReport
   }
   if (!shouldSkipComponent5(options, "rules")) {
     outcomes.push(
-      ...syncRules3(
+      ...syncRules4(
         config,
         sourceRoot,
         paths,
@@ -30337,7 +30426,7 @@ function syncAgents4(config, sourceRoot, mappings, extensions, options, lossRepo
     };
   });
 }
-function syncRules3(config, sourceRoot, paths, mappings, options, lossReport, logger, manifest, scopePath) {
+function syncRules4(config, sourceRoot, paths, mappings, options, lossReport, logger, manifest, scopePath) {
   const sourceRulesDir = path43.join(sourceRoot, config.source.rules);
   if (!fs43.existsSync(sourceRulesDir)) {
     return [skippedMissingSource5("rules", sourceRulesDir)];
@@ -32354,6 +32443,9 @@ function syncOutcomeToManifestKey(tool, outcome, mappings, scope = "global", pro
     const hooksRoot = resolveTargetPath(copilot.hooks);
     const mcpFile2 = resolveTargetPath(copilot.mcp_shared_file);
     const instructionsMirror = copilot.instructions !== null ? resolveTargetPath(copilot.instructions) : null;
+    if (copilot.rules !== null && outcome.path.startsWith(`${resolveTargetPath(copilot.rules)}${path45.sep}`)) {
+      return `copilot/rules/${path45.relative(resolveTargetPath(copilot.rules), outcome.path)}`;
+    }
     if (outcome.path.startsWith(`${skillsRoot2}${path45.sep}`)) {
       return `copilot/skills/${path45.relative(skillsRoot2, outcome.path)}`;
     }

package/mappings/platform-paths.yaml

@@ -52,6 +52,9 @@ targets:
       hook_scripts: ~/.agents/hooks
       mcp_shared_file: ~/.copilot/mcp-config.json
       instructions: null
+      # Null, like instructions: `.github/instructions` is a repository surface
+      # and Copilot documents no user-level equivalent for it.
+      rules: null
     project:
       agents: .github/agents
       skills: .github/skills
@@ -61,6 +64,18 @@ targets:
       mcp_shared_file: .vscode/mcp.json
       instructions: .github/copilot-instructions.md
       agents_md: AGENTS.md
+      # Copilot's own rules surface, and the only one that keeps a rule's path
+      # scope. It reads `.github/instructions/*.instructions.md`, whose
+      # frontmatter `applyTo` takes a glob, so a rule declaring `paths` survives
+      # as a rule rather than as prose folded into the instructions file
+      # (https://docs.github.com/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot,
+      # https://code.visualstudio.com/docs/agent-customization/custom-instructions).
+      # Until this entry existed Copilot received no rules at all: it recorded a
+      # `rule-path-scoping` loss whose text — "no verified global user-level
+      # rules surface" — was written for the global scope and had gone stale
+      # here, where `.github/` is Copilot's alone and nothing contends for it.
+      # Measured 2026-09-11 and reported independently: 0 of 3 rules delivered.
+      rules: .github/instructions
 
   codex:
     global:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alessandroraffa/tangyr",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "CLI for the Tangyr discipline — install and manage operating kits for AI coding tools",
   "license": "MIT",
   "engines": {