@passioncode-ai/passioncode 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.8 - 2026-09-29
+
+### Added
+
+- **Read the rules first.** In a passioncode-ai repository the session-start hook now prints one
+  line sending the agent to the repository's `AGENTS.md` and the organization's `CONTRIBUTING.md`
+  before its first edit; anywhere else it prints nothing, and a missing or slow git prints
+  nothing (`hooks/repo-rules.js`).
+- `working-in-passioncode` carries the names of Fabric ADR-0090 and the code region marker rule.
+
 ## 0.1.7 - 2026-09-29
 
 - Observatory Log 0.12.3 (Observatory v0.8.2) in the set: source-available license and PassionCode.ai metadata; no behaviour change.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/passioncode",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Every PassionCode.ai agent skill — Fabric Agent Adapter, Observatory Log and the organisation's working rules — for Claude Code and every other agent on the machine, updated as one set.",
   "bin": {
     "passioncode": "bin/passioncode.js"

package/payload/.claude-plugin/marketplace.json

@@ -35,7 +35,7 @@
       "name": "passioncode",
       "displayName": "PassionCode.ai",
       "source": "./plugins/passioncode",
-      "version": "0.1.7",
+      "version": "0.1.8",
       "description": "The organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check that keeps the PassionCode.ai set current.",
       "author": {
         "name": "PassionCode.ai",

package/payload/manifest.json

@@ -1,6 +1,6 @@
 {
   "family": "passioncode",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "release": true,
   "members": [
     {
@@ -61,16 +61,16 @@
       "name": "passioncode",
       "displayName": "PassionCode.ai",
       "repo": "passioncode-ai/passioncode",
-      "ref": "v0.1.7",
+      "ref": "v0.1.8",
       "commit": null,
-      "version": "0.1.7",
+      "version": "0.1.8",
       "via": "this repository",
       "skills": [
         "working-in-passioncode"
       ],
       "legacyPluginIds": [],
       "legacyMarketplaces": [],
-      "contentHash": "sha256:9c7431ba81678924da9764acfb828c1f6714c24facfc5aed69cb31eee413e7d1",
+      "contentHash": "sha256:e233f0c95abb4f060aa8428c4a1509e4ef1a3777b5597a6771d7abd2a3a439ef",
       "description": "The organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check that keeps the PassionCode.ai set current.",
       "author": {
         "name": "PassionCode.ai",

package/payload/plugins/passioncode/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "passioncode",
   "displayName": "PassionCode.ai",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "The organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check at session start that keeps the PassionCode.ai skill set current.",
   "author": {
     "name": "PassionCode.ai",

package/payload/plugins/passioncode/hooks/repo-rules.js

@@ -0,0 +1,36 @@
+'use strict';
+/**
+ * The read-first reminder. In a passioncode-ai repository an agent reads the repository's
+ * AGENTS.md and the organization's CONTRIBUTING.md before its first edit — names, landing
+ * rules, code region markers, the shared tools. A rule an agent has to remember is a rule it
+ * forgets in the one repository where it mattered, so the session start says it, in one line,
+ * and only where it applies. Anything unexpected (no git, no origin, a slow git) prints nothing:
+ * a reminder must never cost a session.
+ */
+const { execFileSync } = require('child_process');
+
+const CONTRIBUTING = 'https://github.com/passioncode-ai/.github/blob/main/CONTRIBUTING.md';
+
+/** The GitHub organization an origin URL belongs to, when it is passioncode-ai; else null. */
+function orgOf(url) {
+  const m = String(url || '').trim().match(/^(?:git@github\.com:|ssh:\/\/git@github\.com\/|https:\/\/github\.com\/)([^/]+)\//);
+  return m && m[1] === 'passioncode-ai' ? 'passioncode-ai' : null;
+}
+
+function originOf(dir) {
+  try {
+    return execFileSync('git', ['-C', dir, 'remote', 'get-url', 'origin'], {
+      encoding: 'utf8', timeout: 2000, stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim();
+  } catch (_) {
+    return '';
+  }
+}
+
+/** The one line to print at session start in `dir`, or null. */
+function rulesLine(dir) {
+  if (!orgOf(originOf(dir))) return null;
+  return `[passioncode] passioncode-ai repository: read AGENTS.md and the organization's CONTRIBUTING.md (${CONTRIBUTING}) before the first edit — names, landing rules, code region markers.`;
+}
+
+module.exports = { CONTRIBUTING, orgOf, rulesLine };

package/payload/plugins/passioncode/hooks/session-start.js

@@ -10,6 +10,7 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { decide, loadTrust } = require('./update-check');
+const { rulesLine } = require('./repo-rules');
 
 const DIR = process.env.PASSIONCODE_HOME || path.join(os.homedir(), '.passioncode');
 const STATE = path.join(DIR, 'state.json');
@@ -41,5 +42,10 @@ try {
     fs.writeFileSync(tmp, JSON.stringify(fresh, null, 2));
     fs.renameSync(tmp, STATE);
   }
+  // Claude Code passes the session's directory on stdin; the process cwd is the fallback.
+  let cwd = process.cwd();
+  try { const input = JSON.parse(fs.readFileSync(0, 'utf8') || '{}'); if (input && typeof input.cwd === 'string') cwd = input.cwd; } catch (_) { /* no stdin */ }
+  const rules = rulesLine(cwd);
+  if (rules) lines.unshift(rules);
   if (lines.length) process.stdout.write(lines.join('\n') + '\n');
 } catch (_) { /* never fail a session start */ }

package/payload/plugins/passioncode/skills/working-in-passioncode/SKILL.md

@@ -44,6 +44,18 @@ where a repository's own `AGENTS.md` is stricter, **that file wins**.
 No org-index clone: `gh repo clone passioncode-ai/org-index`. No access at all: say so,
 follow the repository's `AGENTS.md`, and name that you worked from it alone.
 
+Also, before the first edit:
+
+- **Read the organization's [CONTRIBUTING.md](https://github.com/passioncode-ai/.github/blob/main/CONTRIBUTING.md)**
+  — the session-start hook of this plugin prints that line in every passioncode-ai repository.
+- **Names** (Fabric ADR-0090): PassionCode.ai is the organization; **Fabric** is the product,
+  the CEO AI agent; Fabric's tools carry its full name before any short form (Fabric Inbox,
+  Fabric Dashboards, Fabric Switchboard); the Fabric Agent Contract and Adapter make any agent
+  Fabric-compatible; Project Observatory keeps its own name. Never "PassionCode app".
+- **Code region markers**: fence a feature, module or special condition with
+  `#region <slug> — docs: <path>#<anchor>` … `#endregion <slug>` in the file's comment syntax;
+  the reference must resolve. Repositories that ship `check-regions` fail a broken one.
+
 ## 2. Landing on main
 
 | `main` is | Land by |