@ethlete/agent-rules 0.1.0-next.0 → 0.1.0-next.10

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

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitHookSettings = exports.emitHookScripts = exports.mergeHookSettings = exports.assertKnownHooks = 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': { event: 'UserPromptSubmit', file: 'context-warning.py', timeout: 10 },
+};
+const assertKnownHooks = (hooks) => {
+    const unknown = hooks.filter((name) => !(name in exports.KNOWN_HOOKS));
+    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 { 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;
+        events[definition.event] = [
+            ...((_b = events[definition.event]) !== null && _b !== void 0 ? _b : []),
+            { 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 { path, existing, hooks, hooksDir, commandFor, createWhenEmpty } = options;
+    if (existing.trim().length === 0 && hooks.length === 0 && !createWhenEmpty)
+        return [];
+    try {
+        const merged = (0, exports.mergeHookSettings)({ 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

@@ -11,14 +11,17 @@ export type EmitContext = {
     /** 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/`.
+     */
+    claudeMdImportsAgentsMd: boolean;
+    /** Opt-in Claude Code hooks from the config. */
+    hooks: string[];
 };
-export declare const NEUTRAL_DIR = ".agents/ethlete";
-export declare const neutralBodyPath: (name: string) => string;
-export declare const neutralResourcePath: (options: {
-    skillName: string;
-    fileName: string;
-}) => string;
+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.
@@ -31,7 +34,7 @@ export declare const makeLinks: (options: {
         fileName: string;
     }) => string;
 }) => LinkResolver;
-export declare const neutralLinks: (context: EmitContext) => LinkResolver;
+export declare const agentsSkillsLinks: (context: EmitContext) => LinkResolver;
 export declare const body: (options: {
     item: ContentItem;
     context: EmitContext;
@@ -49,12 +52,18 @@ export declare const resourceFiles: (options: {
     path: string;
     contents: string;
 }[];
+/**
+ * One skill in the agentskills.io layout: a `SKILL.md` with `name`/`description` frontmatter plus
+ * its resource files as siblings. The same bundle serves `.claude/skills/` and `.agents/skills/`;
+ * only the directory and the link resolver differ per target.
+ */
+export declare const skillBundle: (options: {
+    item: ContentItem;
+    context: EmitContext;
+    dir: string;
+    links: LinkResolver;
+}) => EmittedFile[];
 /** Descriptions routinely contain `:` and `-`, so always quote them rather than guess. */
 export declare const yamlString: (value: string) => string;
 /** Every generated document ends with exactly one trailing newline so Prettier stays quiet. */
 export declare const document: (parts: string[]) => string;
-export declare const pointerTable: (options: {
-    skills: ContentItem[];
-    context: EmitContext;
-    pathFor: (name: string) => string;
-}) => string;

package/src/lib/targets/shared.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pointerTable = exports.document = exports.yamlString = exports.resourceFiles = exports.description = exports.body = exports.neutralLinks = exports.makeLinks = exports.neutralResourcePath = exports.neutralBodyPath = exports.NEUTRAL_DIR = void 0;
+exports.document = exports.yamlString = exports.skillBundle = exports.resourceFiles = exports.description = exports.body = exports.agentsSkillsLinks = exports.makeLinks = exports.agentsSkillPath = exports.agentsSkillDir = exports.AGENTS_SKILLS_DIR = void 0;
 const fs_1 = require("fs");
 const render_1 = require("../render");
-exports.NEUTRAL_DIR = '.agents/ethlete';
-const neutralBodyPath = (name) => `${exports.NEUTRAL_DIR}/${name}.md`;
-exports.neutralBodyPath = neutralBodyPath;
-const neutralResourcePath = (options) => `${exports.NEUTRAL_DIR}/${options.skillName}/${options.fileName}`;
-exports.neutralResourcePath = neutralResourcePath;
+exports.AGENTS_SKILLS_DIR = '.agents/skills';
+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.
@@ -17,12 +17,12 @@ const makeLinks = (options) => ({
     resource: options.resource,
 });
 exports.makeLinks = makeLinks;
-const neutralLinks = (context) => (0, exports.makeLinks)({
+const agentsSkillsLinks = (context) => (0, exports.makeLinks)({
     context,
-    skill: (name) => `\`${(0, exports.neutralBodyPath)(name)}\``,
-    resource: (target) => `\`${(0, exports.neutralResourcePath)(target)}\``,
+    skill: (name) => `\`${(0, exports.agentsSkillPath)(name)}\``,
+    resource: (target) => `\`${(0, exports.agentsSkillDir)(target.skillName)}/${target.fileName}\``,
 });
-exports.neutralLinks = neutralLinks;
+exports.agentsSkillsLinks = agentsSkillsLinks;
 const body = (options) => (0, render_1.renderBody)({ item: options.item, vars: options.context.vars, links: options.links });
 exports.body = body;
 const description = (options) => (0, render_1.renderDescription)({ item: options.item, vars: options.context.vars });
@@ -36,15 +36,32 @@ const resourceFiles = (options) => options.item.resources.map((resource) => ({
     }),
 }));
 exports.resourceFiles = resourceFiles;
+/**
+ * One skill in the agentskills.io layout: a `SKILL.md` with `name`/`description` frontmatter plus
+ * its resource files as siblings. The same bundle serves `.claude/skills/` and `.agents/skills/`;
+ * only the directory and the link resolver differ per target.
+ */
+const skillBundle = (options) => {
+    const { item, context, dir, links } = options;
+    const frontmatter = [
+        '---',
+        `name: ethlete-${item.frontmatter.name}`,
+        `description: ${(0, exports.yamlString)((0, exports.description)({ item, context }))}`,
+        '---',
+    ].join('\n');
+    return [
+        {
+            path: `${dir}/SKILL.md`,
+            contents: (0, exports.document)([frontmatter, render_1.BANNER, (0, exports.body)({ item, context, links })]),
+        },
+        ...(0, exports.resourceFiles)({ item, context, pathFor: (fileName) => `${dir}/${fileName}` }),
+    ];
+};
+exports.skillBundle = skillBundle;
 /** Descriptions routinely contain `:` and `-`, so always quote them rather than guess. */
 const yamlString = (value) => `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
 exports.yamlString = yamlString;
 /** Every generated document ends with exactly one trailing newline so Prettier stays quiet. */
 const document = (parts) => `${parts.filter((part) => part.length > 0).join('\n\n')}\n`;
 exports.document = document;
-const pointerTable = (options) => {
-    const rows = options.skills.map((item) => `| \`${options.pathFor(item.frontmatter.name)}\` | ${(0, exports.description)({ item, context: options.context })} |`);
-    return ['| Read this file | When |', '| --- | --- |', ...rows].join('\n');
-};
-exports.pointerTable = pointerTable;
 //# sourceMappingURL=shared.js.map

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":"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"}

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>;

package/src/lib/timetrack-command.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timetrackCommand = void 0;
+const tslib_1 = require("tslib");
+const timetrack_1 = require("./timetrack");
+const FLAGS_WITH_VALUE = [
+    '--root',
+    '--project',
+    '--limit',
+    '--summary',
+    '--description',
+    '--type',
+    '--parent',
+    '--subject',
+    '--issue',
+    '--minutes',
+    '--at',
+];
+const positionalArgs = (args) => args.filter((entry, index) => { var _a; return !entry.startsWith('--') && !FLAGS_WITH_VALUE.includes((_a = args[index - 1]) !== null && _a !== void 0 ? _a : ''); });
+const flagValue = (args, flag) => {
+    const index = args.indexOf(flag);
+    return index === -1 ? undefined : args[index + 1];
+};
+const numberFlag = (args, flag) => {
+    const raw = flagValue(args, flag);
+    if (raw === undefined)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isFinite(value))
+        throw new Error(`${flag} takes a number, not ${raw}.`);
+    return value;
+};
+/** `--at` takes anything `Date` reads, so an agent may pass an ISO instant or leave it out for now. */
+const instantFlag = (args) => {
+    const raw = flagValue(args, '--at');
+    if (!raw)
+        return Date.now();
+    const at = new Date(raw);
+    if (Number.isNaN(at.getTime()))
+        throw new Error(`--at takes a date, not ${raw}.`);
+    return at.getTime();
+};
+const issueLine = (issue) => [
+    issue.key,
+    issue.issueType,
+    issue.summary,
+    ...(issue.parentKey ? [`under ${issue.parentKey}`] : []),
+    ...(issue.subject ? [`subject ${issue.subject}`] : []),
+].join('  ');
+const printed = (value, json) => {
+    if (json)
+        console.log(JSON.stringify(value, null, 2));
+    return 0;
+};
+const USAGE = `ethlete-agents timetrack — ask the running Timetrack app about Jira
+
+The app holds this machine's Jira credentials, so no repository needs a token of its own.
+
+  timetrack status              Whether the app is reachable, and which projects it holds
+  timetrack instance            The instance's own levels and its branch-subject candidates
+  timetrack issue <KEY>         One issue: its summary, type, parent and branch subject
+  timetrack search [text]       Open issues of the picked projects, most recently touched first
+  timetrack project [path]      Which Jira project a repository logs into
+  timetrack create --summary …  File a new issue with the instance's own ticket settings
+  timetrack log --issue <KEY> --minutes <n>
+                                Add a row nothing observed to the day it belongs to
+
+Options for search
+  --project <KEY>     Search this project instead of the picked ones
+  --mine              Only the issues assigned to the account
+  --limit <n>         How many issues to read (default 100)
+
+Options for create
+  --summary <text>    Required
+  --description <text>
+  --project <KEY>     Required unless the app holds exactly one picked project
+  --type <name>       Issue type by name (default: the app's configured type)
+  --parent <KEY>      The story or epic it rolls up to
+  --subject <text>    The branch subject, written to the instance's subject field
+
+Options for log
+  --issue <KEY>       Required
+  --minutes <n>       Required
+  --at <date>         When the work started (default: now)
+  --description <text>
+
+Options everywhere
+  --json              Print the raw answer instead of lines
+`;
+/**
+ * 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.
+ */
+const timetrackCommand = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { root, argv } = options;
+    const [subcommand, value] = positionalArgs(argv);
+    const json = argv.includes('--json');
+    if (subcommand === 'status') {
+        const status = yield (0, timetrack_1.timetrackStatus)();
+        if (!json) {
+            console.log(`Timetrack   ${(0, timetrack_1.timetrackDiscoveryPath)()}`);
+            console.log(`  jira      ${status.jiraReady ? 'configured' : 'not configured — set it in Timetrack Settings'}`);
+            console.log(`  projects  ${status.projects.map((project) => project.key).join(', ') || '— none picked'}`);
+            console.log(`  subject   ${status.subjectField || '— no field configured, the summary is used'}`);
+        }
+        return printed(status, json);
+    }
+    if (subcommand === 'instance') {
+        const instance = yield (0, timetrack_1.timetrackInstance)();
+        if (!json) {
+            console.log('Levels, highest first');
+            instance.levels.forEach((level) => console.log(`  ${level.hierarchyLevel}  ${level.typeNames.join(', ')}`));
+            console.log(`A parent can be named by  ${instance.suggestedParenting}`);
+            console.log(`Branch-subject candidates (${instance.subjectFieldCandidates.length})`);
+            instance.subjectFieldCandidates.forEach((field) => console.log(`  ${field.id}  ${field.name}`));
+        }
+        return printed(instance, json);
+    }
+    if (subcommand === 'issue') {
+        if (!value)
+            throw new Error('Pass an issue key, e.g. `ethlete-agents timetrack issue FIP-2177`.');
+        const issue = yield (0, timetrack_1.timetrackIssue)(value);
+        if (!json)
+            console.log(issueLine(issue));
+        return printed(issue, json);
+    }
+    if (subcommand === 'search') {
+        const issues = yield (0, timetrack_1.timetrackSearch)({
+            text: value,
+            projectKey: flagValue(argv, '--project'),
+            assignedToMe: argv.includes('--mine'),
+            limit: numberFlag(argv, '--limit'),
+        });
+        if (!json) {
+            if (issues.length === 0)
+                console.log('No issue matches.');
+            issues.forEach((issue) => console.log(issueLine(issue)));
+        }
+        return printed(issues, json);
+    }
+    if (subcommand === 'project') {
+        const found = yield (0, timetrack_1.timetrackRepoProject)(value !== null && value !== void 0 ? value : root);
+        if (!json) {
+            const where = found.inherited ? ' (from a directory above it)' : '';
+            if (found.private)
+                console.log(`${found.repoPath} is marked private — work there is logged nowhere${where}.`);
+            else if (found.projectKey)
+                console.log(`${found.repoPath} logs into ${found.projectKey}${where}.`);
+            else if (found.suggestedProjectKey) {
+                console.log(`${found.repoPath} is linked to nothing. Its name suggests ${found.suggestedProjectKey}.`);
+            }
+            else
+                console.log(`${found.repoPath} is linked to no project. Link it in Timetrack Settings.`);
+        }
+        return printed(found, json);
+    }
+    if (subcommand === 'create') {
+        const summary = flagValue(argv, '--summary');
+        if (!summary)
+            throw new Error('Pass --summary "…".');
+        const issue = yield (0, timetrack_1.timetrackCreateIssue)({
+            summary,
+            description: flagValue(argv, '--description'),
+            projectKey: flagValue(argv, '--project'),
+            issueTypeName: flagValue(argv, '--type'),
+            parentKey: flagValue(argv, '--parent'),
+            subject: flagValue(argv, '--subject'),
+        });
+        if (!json)
+            console.log(`${issue.key}  ${summary}`);
+        return printed(issue, json);
+    }
+    if (subcommand === 'log') {
+        const issueKey = flagValue(argv, '--issue');
+        const minutes = numberFlag(argv, '--minutes');
+        if (!issueKey)
+            throw new Error('Pass --issue <KEY>.');
+        if (!minutes || minutes <= 0)
+            throw new Error('Pass --minutes <n> above zero.');
+        const worklog = yield (0, timetrack_1.timetrackAddWorklog)({
+            issueKey,
+            description: flagValue(argv, '--description'),
+            fromMs: instantFlag(argv),
+            durationMs: Math.round(minutes * 60000),
+        });
+        if (!json) {
+            console.log(`${worklog.issueKey}  ${minutes}m on ${worklog.day}`);
+            console.log('It is a row on the day, not a Tempo entry — review the day in Timetrack, then sync it.');
+        }
+        return printed(worklog, json);
+    }
+    console.log(USAGE);
+    return subcommand === undefined || subcommand === '--help' || subcommand === '-h' ? 0 : 1;
+});
+exports.timetrackCommand = timetrackCommand;
+//# sourceMappingURL=timetrack-command.js.map

package/src/lib/timetrack-command.js.map

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

package/src/lib/timetrack.d.ts

@@ -0,0 +1,86 @@
+export type TimetrackIssue = {
+    key: string;
+    id: string;
+    summary: string;
+    issueType: string;
+    parentKey?: string;
+    subject?: string;
+};
+export type TimetrackStatus = {
+    version: number;
+    jiraReady: boolean;
+    projects: {
+        key: string;
+        name: string;
+    }[];
+    subjectField: string;
+};
+export type TimetrackInstance = {
+    levels: {
+        hierarchyLevel: number;
+        typeNames: string[];
+    }[];
+    suggestedParenting: 'parent-field' | 'issue-link';
+    subjectFieldCandidates: {
+        id: string;
+        name: string;
+    }[];
+};
+export type TimetrackRepoProject = {
+    repoPath: string;
+    projectKey?: string;
+    private: boolean;
+    inherited: boolean;
+    suggestedProjectKey?: string;
+};
+export type TimetrackWorklog = {
+    day: string;
+    issueKey: string;
+    description: string;
+    fromMs: number;
+    toMs: number;
+    durationMs: number;
+};
+/**
+ * Where the app writes the port and the token, which is its data directory on each platform.
+ *
+ * `TIMETRACK_AGENT_DISCOVERY` names the file directly, for a machine whose app data lives somewhere
+ * else and for a test.
+ */
+export declare const timetrackDiscoveryPath: () => string;
+/**
+ * Asks the running Timetrack app to carry out one operation.
+ *
+ * It is the only way this package reaches Jira. The token lives in the app's keychain entry and in no
+ * repository, so a checkout an agent works in holds nothing worth stealing and nothing to rotate.
+ */
+export declare const askTimetrack: <T>(request: Record<string, unknown> & {
+    op: string;
+}) => Promise<T>;
+export declare const timetrackStatus: () => Promise<TimetrackStatus>;
+export declare const timetrackInstance: () => Promise<TimetrackInstance>;
+export declare const timetrackIssue: (key: string) => Promise<TimetrackIssue>;
+export declare const timetrackSearch: (options: {
+    text?: string;
+    projectKey?: string;
+    assignedToMe?: boolean;
+    limit?: number;
+}) => Promise<TimetrackIssue[]>;
+export declare const timetrackRepoProject: (repoPath: string) => Promise<TimetrackRepoProject>;
+export declare const timetrackCreateIssue: (options: {
+    summary: string;
+    description?: string;
+    projectKey?: string;
+    issueTypeName?: string;
+    parentKey?: string;
+    subject?: string;
+}) => Promise<{
+    key: string;
+    id: string;
+}>;
+export declare const timetrackAddWorklog: (options: {
+    issueKey: string;
+    description?: string;
+    fromMs: number;
+    durationMs: number;
+}) => Promise<TimetrackWorklog>;