@ethlete/agent-rules 0.1.0-next.2 → 0.1.0-next.21

package/src/lib/targets/git-hooks.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitGitHooks = exports.huskyHookPath = exports.assertKnownGitHooks = exports.KNOWN_GIT_HOOKS = exports.END_MARKER = exports.START_MARKER = exports.HUSKY_DIR = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const load_content_1 = require("../load-content");
+const render_1 = require("../render");
+exports.HUSKY_DIR = '.husky';
+exports.START_MARKER = '# ethlete:git-flow:start';
+exports.END_MARKER = '# ethlete:git-flow:end';
+/**
+ * Git hooks a repo can opt into via the config's `gitHooks` array. Like the agent hooks these never
+ * default: a generated block that can reject a developer's push is a higher-stakes artifact than a
+ * markdown one, so a repo asks for it.
+ */
+exports.KNOWN_GIT_HOOKS = {
+    'pre-push': { file: 'pre-push.sh' },
+    'post-checkout': { file: 'post-checkout.sh' },
+};
+const assertKnownGitHooks = (hooks) => {
+    const unknown = hooks.filter((name) => !Object.prototype.hasOwnProperty.call(exports.KNOWN_GIT_HOOKS, name));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown git hook(s): ${unknown.join(', ')}. Known git hooks: ${Object.keys(exports.KNOWN_GIT_HOOKS).join(', ')}.`);
+    }
+};
+exports.assertKnownGitHooks = assertKnownGitHooks;
+const huskyHookPath = (name) => `${exports.HUSKY_DIR}/${name}`;
+exports.huskyHookPath = huskyHookPath;
+const SHEBANG = '#!/bin/sh\n';
+const block = (options) => {
+    const { file } = options;
+    const body = (0, fs_1.readFileSync)((0, path_1.join)((0, load_content_1.resolveContentRoot)(), 'git-hooks', file), 'utf8');
+    return [
+        '# Generated by @ethlete/agent-rules — DO NOT EDIT between the markers. Run `npx ethlete-agents sync`.',
+        '# Set ETHLETE_GIT_FLOW_SKIP=1 to silence it on this machine.',
+        body.trimEnd(),
+    ].join('\n');
+};
+/**
+ * Appends the check to whatever the repo already has in `.husky/<name>`, between markers — those
+ * files routinely hold a git-lfs hook that must keep running and must keep reading stdin first,
+ * which is why the appended block never consumes it.
+ */
+const emitGitHooks = (options) => {
+    const { gitHooks, huskyExists, existing } = options;
+    if (!huskyExists)
+        return [];
+    return Object.entries(exports.KNOWN_GIT_HOOKS).flatMap(([name, definition]) => {
+        var _a;
+        const path = (0, exports.huskyHookPath)(name);
+        const current = (_a = existing[name]) !== null && _a !== void 0 ? _a : '';
+        if (!gitHooks.includes(name)) {
+            const stripped = (0, render_1.removeMarkedBlock)({ existing: current, startMarker: exports.START_MARKER, endMarker: exports.END_MARKER });
+            return stripped === current ? [] : [{ path, contents: stripped.trim().length > 0 ? stripped : SHEBANG }];
+        }
+        return [
+            {
+                path,
+                contents: (0, render_1.replaceMarkedBlock)({
+                    existing: current.trim().length > 0 ? current : SHEBANG,
+                    block: block({ file: definition.file }),
+                    file: path,
+                    startMarker: exports.START_MARKER,
+                    endMarker: exports.END_MARKER,
+                }),
+            },
+        ];
+    });
+};
+exports.emitGitHooks = emitGitHooks;
+//# sourceMappingURL=git-hooks.js.map

package/src/lib/targets/git-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hooks.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/targets/git-hooks.ts"],"names":[],"mappings":"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"}

package/src/lib/targets/hooks-shared.d.ts

@@ -0,0 +1,58 @@
+import { EmittedFile } from './shared';
+type HookRegistration = {
+    event: string;
+    /** Tool-name pattern for a tool-scoped event, so the script is not run on every tool call. */
+    matcher?: string;
+    /** Agents that have this event. Empty means every target that registers the hook gets it. */
+    agents?: string[];
+};
+type HookDefinition = {
+    events: HookRegistration[];
+    file: string;
+    timeout: number;
+    /** Agents that have the hook at all. Empty means every target registers it. */
+    agents?: string[];
+};
+/**
+ * Hooks a repo can opt into via the config's `hooks` array. Hooks run arbitrary commands on the
+ * developer's machine, so unlike rules and skills they are never emitted by default.
+ */
+export declare const KNOWN_HOOKS: Record<string, HookDefinition>;
+/** Drops the hooks whose event the agent does not have, so neither script nor entry is emitted. */
+export declare const hooksForAgent: (options: {
+    hooks: string[];
+    agent: string;
+}) => string[];
+/** The registrations of one hook that the given agent has the event for. */
+export declare const eventsForAgent: (options: {
+    hook: string;
+    agent: string;
+}) => HookRegistration[];
+export declare const assertKnownHooks: (hooks: string[]) => void;
+/**
+ * Rewrites the generated entries declaratively: every entry whose command points into the
+ * agent's `hooks/ethlete/` directory is dropped and the currently enabled hooks are re-added, so
+ * disabling a hook in the config also unregisters it. Everything else in the file is untouched.
+ */
+export declare const mergeHookSettings: (options: {
+    agent: string;
+    existing: string;
+    hooks: string[];
+    hooksDir: string;
+    commandFor: (file: string) => string;
+}) => string;
+export declare const emitHookScripts: (options: {
+    hooks: string[];
+    hooksDir: string;
+}) => EmittedFile[];
+/** Only planned when the parsed content actually changes; an unparseable file is left alone. */
+export declare const emitHookSettings: (options: {
+    agent: string;
+    path: string;
+    existing: string;
+    hooks: string[];
+    hooksDir: string;
+    commandFor: (file: string) => string;
+    createWhenEmpty: boolean;
+}) => EmittedFile[];
+export {};

package/src/lib/targets/hooks-shared.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitHookSettings = exports.emitHookScripts = exports.mergeHookSettings = exports.assertKnownHooks = exports.eventsForAgent = exports.hooksForAgent = exports.KNOWN_HOOKS = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const load_content_1 = require("../load-content");
+const render_1 = require("../render");
+/**
+ * Hooks a repo can opt into via the config's `hooks` array. Hooks run arbitrary commands on the
+ * developer's machine, so unlike rules and skills they are never emitted by default.
+ */
+exports.KNOWN_HOOKS = {
+    'context-warning': {
+        events: [
+            { event: 'UserPromptSubmit' },
+            // Codex has none of the three below, so its registration stays prompt-only.
+            { event: 'SessionStart', agents: ['claude'] },
+            // The only event between an agent's own model requests, and the only way a warning
+            // reaches a long autonomous run before the user sends a message.
+            { event: 'PostToolBatch', agents: ['claude'] },
+            { event: 'Stop', agents: ['claude'] },
+        ],
+        file: 'context-warning.py',
+        timeout: 10,
+    },
+    'subagent-model-policy': {
+        events: [{ event: 'PreToolUse', matcher: 'Task|Agent' }],
+        file: 'subagent-model-policy.py',
+        timeout: 10,
+        agents: ['claude'],
+    },
+};
+/** Drops the hooks whose event the agent does not have, so neither script nor entry is emitted. */
+const hooksForAgent = (options) => options.hooks.filter((name) => {
+    var _a, _b;
+    const agents = (_b = (_a = exports.KNOWN_HOOKS[name]) === null || _a === void 0 ? void 0 : _a.agents) !== null && _b !== void 0 ? _b : [];
+    return agents.length === 0 || agents.includes(options.agent);
+});
+exports.hooksForAgent = hooksForAgent;
+/** The registrations of one hook that the given agent has the event for. */
+const eventsForAgent = (options) => {
+    var _a, _b;
+    return ((_b = (_a = exports.KNOWN_HOOKS[options.hook]) === null || _a === void 0 ? void 0 : _a.events) !== null && _b !== void 0 ? _b : []).filter((registration) => { var _a, _b; return ((_a = registration.agents) !== null && _a !== void 0 ? _a : []).length === 0 || ((_b = registration.agents) === null || _b === void 0 ? void 0 : _b.includes(options.agent)); });
+};
+exports.eventsForAgent = eventsForAgent;
+const assertKnownHooks = (hooks) => {
+    const unknown = hooks.filter((name) => !Object.prototype.hasOwnProperty.call(exports.KNOWN_HOOKS, name));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown hook(s): ${unknown.join(', ')}. Known hooks: ${Object.keys(exports.KNOWN_HOOKS).join(', ')}.`);
+    }
+};
+exports.assertKnownHooks = assertKnownHooks;
+/** Placed after the shebang so the file stays runnable. */
+const withBanner = (raw) => {
+    var _a;
+    const lines = raw.split('\n');
+    if ((_a = lines[0]) === null || _a === void 0 ? void 0 : _a.startsWith('#!'))
+        return [lines[0], render_1.SHELL_BANNER, ...lines.slice(1)].join('\n');
+    return `${render_1.SHELL_BANNER}\n${raw}`;
+};
+/**
+ * Rewrites the generated entries declaratively: every entry whose command points into the
+ * agent's `hooks/ethlete/` directory is dropped and the currently enabled hooks are re-added, so
+ * disabling a hook in the config also unregisters it. Everything else in the file is untouched.
+ */
+const mergeHookSettings = (options) => {
+    var _a, _b;
+    const { agent, existing, hooks, hooksDir, commandFor } = options;
+    const settings = JSON.parse(existing.trim() || '{}');
+    const events = Object.assign({}, ((_a = settings.hooks) !== null && _a !== void 0 ? _a : {}));
+    for (const [event, groups] of Object.entries(events)) {
+        const kept = groups
+            .map((group) => {
+            var _a;
+            return (Object.assign(Object.assign({}, group), { hooks: ((_a = group.hooks) !== null && _a !== void 0 ? _a : []).filter((hook) => { var _a; return !((_a = hook.command) !== null && _a !== void 0 ? _a : '').includes(hooksDir); }) }));
+        })
+            .filter((group) => group.hooks.length > 0);
+        if (kept.length > 0)
+            events[event] = kept;
+        else
+            delete events[event];
+    }
+    for (const name of hooks) {
+        const definition = exports.KNOWN_HOOKS[name];
+        if (!definition)
+            continue;
+        for (const registration of (0, exports.eventsForAgent)({ hook: name, agent })) {
+            events[registration.event] = [
+                ...((_b = events[registration.event]) !== null && _b !== void 0 ? _b : []),
+                Object.assign(Object.assign({}, (registration.matcher ? { matcher: registration.matcher } : {})), { hooks: [{ type: 'command', command: commandFor(definition.file), timeout: definition.timeout }] }),
+            ];
+        }
+    }
+    if (Object.keys(events).length > 0)
+        settings.hooks = events;
+    else
+        delete settings.hooks;
+    return `${JSON.stringify(settings, null, 2)}\n`;
+};
+exports.mergeHookSettings = mergeHookSettings;
+const emitHookScripts = (options) => {
+    const { hooks, hooksDir } = options;
+    return hooks.flatMap((name) => {
+        const definition = exports.KNOWN_HOOKS[name];
+        if (!definition)
+            return [];
+        const raw = (0, fs_1.readFileSync)((0, path_1.join)((0, load_content_1.resolveContentRoot)(), 'hooks', definition.file), 'utf8');
+        return [{ path: `${hooksDir}/${definition.file}`, contents: withBanner(raw) }];
+    });
+};
+exports.emitHookScripts = emitHookScripts;
+/** Only planned when the parsed content actually changes; an unparseable file is left alone. */
+const emitHookSettings = (options) => {
+    const { agent, path, existing, hooks, hooksDir, commandFor, createWhenEmpty } = options;
+    if (existing.trim().length === 0 && hooks.length === 0 && !createWhenEmpty)
+        return [];
+    try {
+        const merged = (0, exports.mergeHookSettings)({ agent, existing, hooks, hooksDir, commandFor });
+        if (JSON.stringify(JSON.parse(existing.trim() || '{}')) === JSON.stringify(JSON.parse(merged)))
+            return [];
+        return [{ path, contents: merged }];
+    }
+    catch (_a) {
+        return [];
+    }
+};
+exports.emitHookSettings = emitHookSettings;
+//# sourceMappingURL=hooks-shared.js.map

package/src/lib/targets/hooks-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-shared.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/targets/hooks-shared.ts"],"names":[],"mappings":"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"}

package/src/lib/targets/shared.d.ts

@@ -8,10 +8,7 @@ export type EmittedFile = {
 export type EmitContext = {
     rules: ContentItem[];
     skills: ContentItem[];
-    /** Names of the skills that actually survived filtering, so links can't point at a missing file. */
-    emittedSkills: Set<string>;
     vars: Record<string, string | string[]>;
-    version: string;
     /**
      * The repo's `CLAUDE.md` is an `@AGENTS.md` import (or symlink), so Claude already receives the
      * rules through the `AGENTS.md` marker block and must not get a second copy in `.claude/rules/`.
@@ -23,19 +20,14 @@ export type EmitContext = {
 export declare const AGENTS_SKILLS_DIR = ".agents/skills";
 export declare const agentsSkillDir: (name: string) => string;
 export declare const agentsSkillPath: (name: string) => string;
-/**
- * A guide can be filtered out of a given repo while another still references it. Degrade such a
- * link to the bare name rather than emitting a path to a file that was never written.
- */
 export declare const makeLinks: (options: {
-    context: EmitContext;
     skill: (name: string) => string;
     resource: (target: {
         skillName: string;
         fileName: string;
     }) => string;
 }) => LinkResolver;
-export declare const agentsSkillsLinks: (context: EmitContext) => LinkResolver;
+export declare const agentsSkillsLinks: () => LinkResolver;
 export declare const body: (options: {
     item: ContentItem;
     context: EmitContext;

package/src/lib/targets/shared.js

@@ -8,17 +8,12 @@ const agentsSkillDir = (name) => `${exports.AGENTS_SKILLS_DIR}/ethlete-${name}`;
 exports.agentsSkillDir = agentsSkillDir;
 const agentsSkillPath = (name) => `${(0, exports.agentsSkillDir)(name)}/SKILL.md`;
 exports.agentsSkillPath = agentsSkillPath;
-/**
- * A guide can be filtered out of a given repo while another still references it. Degrade such a
- * link to the bare name rather than emitting a path to a file that was never written.
- */
 const makeLinks = (options) => ({
-    skill: (name) => (options.context.emittedSkills.has(name) ? options.skill(name) : `\`${name}\``),
+    skill: options.skill,
     resource: options.resource,
 });
 exports.makeLinks = makeLinks;
-const agentsSkillsLinks = (context) => (0, exports.makeLinks)({
-    context,
+const agentsSkillsLinks = () => (0, exports.makeLinks)({
     skill: (name) => `\`${(0, exports.agentsSkillPath)(name)}\``,
     resource: (target) => `\`${(0, exports.agentsSkillDir)(target.skillName)}/${target.fileName}\``,
 });
@@ -47,12 +42,13 @@ const skillBundle = (options) => {
         '---',
         `name: ethlete-${item.frontmatter.name}`,
         `description: ${(0, exports.yamlString)((0, exports.description)({ item, context }))}`,
+        ...(item.frontmatter.modelInvocation ? [] : ['disable-model-invocation: true']),
         '---',
     ].join('\n');
     return [
         {
             path: `${dir}/SKILL.md`,
-            contents: (0, exports.document)([frontmatter, (0, render_1.buildBanner)(context.version), (0, exports.body)({ item, context, links })]),
+            contents: (0, exports.document)([frontmatter, render_1.BANNER, (0, exports.body)({ item, context, links })]),
         },
         ...(0, exports.resourceFiles)({ item, context, pathFor: (fileName) => `${dir}/${fileName}` }),
     ];

package/src/lib/targets/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/targets/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/targets/shared.ts"],"names":[],"mappings":";;;AAAA,2BAAkC;AAElC,sCAAgG;AAqBnF,QAAA,iBAAiB,GAAG,gBAAgB,CAAC;AAE3C,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,yBAAiB,YAAY,IAAI,EAAE,CAAC;AAA1E,QAAA,cAAc,kBAA4D;AAEhF,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,IAAA,sBAAc,EAAC,IAAI,CAAC,WAAW,CAAC;AAAvE,QAAA,eAAe,mBAAwD;AAE7E,MAAM,SAAS,GAAG,CAAC,OAGzB,EAAgB,EAAE,CAAC,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;CAC3B,CAAC,CAAC;AANU,QAAA,SAAS,aAMnB;AAEI,MAAM,iBAAiB,GAAG,GAAG,EAAE,CACpC,IAAA,iBAAS,EAAC;IACR,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAA,uBAAe,EAAC,IAAI,CAAC,IAAI;IAC/C,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,IAAA,sBAAc,EAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI;CACnF,CAAC,CAAC;AAJQ,QAAA,iBAAiB,qBAIzB;AAEE,MAAM,IAAI,GAAG,CAAC,OAAyE,EAAE,EAAE,CAChG,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AAD1E,QAAA,IAAI,QACsE;AAEhF,MAAM,WAAW,GAAG,CAAC,OAAoD,EAAE,EAAE,CAClF,IAAA,0BAAiB,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAD3D,QAAA,WAAW,eACgD;AAEjE,MAAM,aAAa,GAAG,CAAC,OAI7B,EAAE,EAAE,CACH,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACxC,QAAQ,EAAE,IAAA,uBAAc,EAAC;QACvB,IAAI,EAAE,IAAA,iBAAY,EAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QACjD,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;QAC1B,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE;KAChE,CAAC;CACH,CAAC,CAAC,CAAC;AAZO,QAAA,aAAa,iBAYpB;AAEN;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,OAK3B,EAAiB,EAAE;IAClB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,WAAW,GAAG;QAClB,KAAK;QACL,iBAAiB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE;QACxC,gBAAgB,IAAA,kBAAU,EAAC,IAAA,mBAAW,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;QAC5D,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC;QAC/E,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL;YACE,IAAI,EAAE,GAAG,GAAG,WAAW;YACvB,QAAQ,EAAE,IAAA,gBAAQ,EAAC,CAAC,WAAW,EAAE,eAAM,EAAE,IAAA,YAAI,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;SAC1E;QACD,GAAG,IAAA,qBAAa,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,QAAQ,EAAE,EAAE,CAAC;KACjF,CAAC;AACJ,CAAC,CAAC;AAtBW,QAAA,WAAW,eAsBtB;AAEF,0FAA0F;AACnF,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAAzF,QAAA,UAAU,cAA+E;AAEtG,+FAA+F;AACxF,MAAM,QAAQ,GAAG,CAAC,KAAe,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AAA5F,QAAA,QAAQ,YAAoF"}

package/src/lib/timetrack-command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The agent-facing half of Timetrack: everything here is one call into the running app.
+ *
+ * Nothing in this file knows a Jira host or a token. That is the point — an agent working in any
+ * repository asks the one process that holds them, so a machine has one secret to rotate rather than
+ * one per checkout.
+ */
+export declare const timetrackCommand: (options: {
+    root: string;
+    argv: string[];
+}) => Promise<number>;