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

package/content/skills/timetrack/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: timetrack
+description: How to reach Jira from any repo through the running Timetrack app - look up an issue, search for one, ask which project a repo logs into, file a ticket, or add a worklog row. Read whenever a task needs Jira data or a Jira write, and never put a Jira token in a repo.
+kind: skill
+scope: both
+---
+
+# Reaching Jira through Timetrack
+
+**No repository holds a Jira token.** The Timetrack desktop app holds one set of credentials
+in this machine's keychain, and every repository asks it:
+
+```bash
+npx ethlete-agents timetrack status                 # is the app reachable, and what does it hold?
+npx ethlete-agents timetrack issue FIP-2177         # one issue: summary, type, parent, subject
+npx ethlete-agents timetrack search "password"      # open issues of the picked projects
+npx ethlete-agents timetrack project                # which project does this repo log into?
+npx ethlete-agents timetrack instance               # the instance's own levels and custom fields
+```
+
+Add `--json` to any of them when you need to read a field rather than a line.
+
+**Never ask the user for a Jira token, and never write one into a file.** If a command reports
+that the app is not running, say so and ask the user to start it. That is the whole fix -
+there is no per-repo fallback, by design: a secret copied into every checkout is a secret
+nobody can rotate.
+
+## What each command is for
+
+| Command                           | Use it when                                                             |
+| --------------------------------- | ----------------------------------------------------------------------- |
+| `status`                          | Before anything else, when a Jira command failed and you need the cause |
+| `instance`                        | A setup step needs the instance's levels or its branch-subject field    |
+| `issue <KEY>`                     | The user names a key and you need its summary, type or parent           |
+| `search [text]`                   | The user describes work but names no key                                |
+| `project [path]`                  | You need the project a repository files into                            |
+| `create --summary "…"`            | The work has no ticket and the user asked for one                       |
+| `log --issue <KEY> --minutes <n>` | The user asks to record time that nothing observed                      |
+
+`git-flow start` uses the same channel, so a branch is named from the real issue rather than
+from a key you typed - see the `git-flow` skill.
+
+## Writes
+
+Two commands write, so both need the user to have asked for them in this conversation:
+
+```bash
+npx ethlete-agents timetrack create --summary "Reset password mail is not sent" --project FIP
+npx ethlete-agents timetrack log --issue FIP-2177 --minutes 45 --description "pairing call"
+```
+
+- **`create`** files the issue with the instance's own ticket settings - its type, its parent
+  rule and its subject field all come from the app, so the ticket is shaped like every other.
+  `--project` is needed unless the app holds exactly one picked project.
+- **`log`** adds a row to the day in Timetrack. It is **not** a Tempo entry: the user reviews
+  the day and syncs it, which is what keeps an agent's row from double-booking against the
+  hours the day already observed. `--at <date>` places it; without one it starts now.
+
+## What the app decides, not you
+
+- **The projects.** The user picked them in Timetrack. `search` is scoped to them, and
+  `--project <KEY>` is how you look outside.
+- **The branch subject.** `issue` returns `subject` when the instance's subject field is set on
+  that issue. Prefer it over the summary; the summary is a paraphrase.
+- **The instance.** Its host, its issue types and its hierarchy are settings in the app. Do not
+  hardcode any of them in this repo.

package/package.json

@@ -1,8 +1,19 @@
 {
   "name": "@ethlete/agent-rules",
-  "version": "0.1.0-next.0",
+  "version": "0.1.0-next.10",
   "license": "MIT",
   "type": "commonjs",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./git-flow": {
+      "types": "./src/lib/git-flow/index.d.ts",
+      "default": "./src/lib/git-flow/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",
   "bin": {

package/src/index.js

@@ -5,17 +5,33 @@ const tslib_1 = require("tslib");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const config_1 = require("./lib/config");
+const git_flow_command_1 = require("./lib/git-flow-command");
+const migrate_1 = require("./lib/migrate");
+const output_style_command_1 = require("./lib/output-style-command");
 const sync_1 = require("./lib/sync");
+const timetrack_command_1 = require("./lib/timetrack-command");
 const USAGE = `ethlete-agents — compile @ethlete agent rules and skills into your repo
 
-  ethlete-agents sync    Write the generated rules/skills for every detected agent
-  ethlete-agents check   Exit non-zero when the generated files are out of date (for CI)
-  ethlete-agents init    Write a starter ${config_1.CONFIG_FILE_NAME}
+  ethlete-agents sync      Write the generated rules/skills for every detected agent
+  ethlete-agents check     Exit non-zero when the generated files are out of date (for CI)
+  ethlete-agents init      Write a starter ${config_1.CONFIG_FILE_NAME}
+  ethlete-agents git-flow  Name, check and repair branches against the repo's git flow
+                           (start, check, repair, explain)
+  ethlete-agents output-style
+                           Install an Ethlete output style into this machine's Claude Code
+                           config and switch to it (Claude Code only)
+  ethlete-agents timetrack Ask the running Timetrack app about Jira - it holds this
+                           machine's credentials, so no repo needs a token
+                           (status, instance, issue, search, project, create, log)
+  ethlete-agents migrate   Convert the repo to the AGENTS.md + .agents/skills layout:
+                           CLAUDE.md content moves into AGENTS.md (CLAUDE.md becomes an
+                           @AGENTS.md import), hand-written .claude/skills move to
+                           .agents/skills with symlinks left behind, then a sync runs
 
 Options
   --targets <list>   Comma-separated subset of: ${config_1.AGENT_TARGETS.join(', ')}
   --root <path>      Repo root to write into (default: current directory)
-  --dry-run          Print what sync would change without writing (sync only)
+  --dry-run          Print what would change without writing (sync and migrate)
 `;
 const readFlag = (args, flag) => {
     const index = args.indexOf(flag);
@@ -29,10 +45,6 @@ const parseTargets = (args) => {
         return undefined;
     return raw.split(',').map((entry) => entry.trim());
 };
-const readVersion = () => {
-    const manifest = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '..', 'package.json'), 'utf8'));
-    return manifest.version;
-};
 const init = (root) => {
     const path = (0, path_1.join)(root, config_1.CONFIG_FILE_NAME);
     if ((0, fs_1.existsSync)(path)) {
@@ -43,6 +55,7 @@ const init = (root) => {
         targets: (0, config_1.detectTargets)(root),
         vars: {},
         exclude: [],
+        hooks: [],
     };
     (0, fs_1.writeFileSync)(path, `${JSON.stringify(template, null, 2)}\n`, 'utf8');
     console.log(`Wrote ${config_1.CONFIG_FILE_NAME}. Fill in "vars" for your repo, then run \`ethlete-agents sync\`.`);
@@ -52,7 +65,7 @@ const run = (argv) => {
     var _a;
     const command = argv[0];
     const root = (_a = readFlag(argv, '--root')) !== null && _a !== void 0 ? _a : process.cwd();
-    const options = { root, version: readVersion(), targets: parseTargets(argv) };
+    const options = { root, targets: parseTargets(argv) };
     switch (command) {
         case 'sync':
             return (0, sync_1.sync)(Object.assign(Object.assign({}, options), { dryRun: argv.includes('--dry-run') }));
@@ -60,6 +73,14 @@ const run = (argv) => {
             return (0, sync_1.check)(options);
         case 'init':
             return init(root);
+        case 'git-flow':
+            return (0, git_flow_command_1.gitFlowCommand)({ root, argv: argv.slice(1) });
+        case 'output-style':
+            return (0, output_style_command_1.outputStyleCommand)({ argv: argv.slice(1) });
+        case 'timetrack':
+            return (0, timetrack_command_1.timetrackCommand)({ root, argv: argv.slice(1) });
+        case 'migrate':
+            return (0, migrate_1.migrate)(Object.assign(Object.assign({}, options), { dryRun: argv.includes('--dry-run') }));
         default:
             console.log(USAGE);
             return command === undefined || command === '--help' || command === '-h' ? 0 : 1;
@@ -68,12 +89,12 @@ const run = (argv) => {
 tslib_1.__exportStar(require("./lib"), exports);
 // Guarded so the package can also be imported as a library without running the CLI.
 if (require.main === module) {
-    try {
-        process.exit(run(process.argv.slice(2)));
-    }
-    catch (error) {
+    Promise.resolve()
+        .then(() => run(process.argv.slice(2)))
+        .then((code) => process.exit(code))
+        .catch((error) => {
         console.error(error instanceof Error ? error.message : error);
         process.exit(1);
-    }
+    });
 }
 //# sourceMappingURL=index.js.map

package/src/index.js.map

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

package/src/lib/commitlint.d.ts

@@ -0,0 +1,10 @@
+/** The file that validates commit messages, as the skill should name it, or `null` when none does. */
+export type CommitlintSource = string | null;
+export declare const findCommitlintConfig: (root: string) => CommitlintSource;
+/**
+ * The git-commit skill states where its format comes from, and whether a message can be verified,
+ * from what the repo actually has. Promising a `commitlint` run to a repo without one makes the
+ * agent narrate the contradiction it finds instead of just writing the commit — so a repo with no
+ * commitlint gets a guide that never mentions it.
+ */
+export declare const commitMessageVars: (source: CommitlintSource) => Record<string, string>;

package/src/lib/commitlint.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commitMessageVars = exports.findCommitlintConfig = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const COMMITLINT_CONFIG_FILES = [
+    'commitlint.config.js',
+    'commitlint.config.cjs',
+    'commitlint.config.mjs',
+    'commitlint.config.ts',
+    'commitlint.config.mts',
+    'commitlint.config.json',
+    'commitlint.config.yaml',
+    'commitlint.config.yml',
+    '.commitlintrc',
+    '.commitlintrc.js',
+    '.commitlintrc.cjs',
+    '.commitlintrc.mjs',
+    '.commitlintrc.ts',
+    '.commitlintrc.json',
+    '.commitlintrc.yaml',
+    '.commitlintrc.yml',
+];
+const findCommitlintConfig = (root) => {
+    const configFile = COMMITLINT_CONFIG_FILES.find((name) => (0, fs_1.existsSync)((0, path_1.join)(root, name)));
+    if (configFile)
+        return configFile;
+    const manifestPath = (0, path_1.join)(root, 'package.json');
+    if (!(0, fs_1.existsSync)(manifestPath))
+        return null;
+    const manifest = JSON.parse((0, fs_1.readFileSync)(manifestPath, 'utf8'));
+    return manifest.commitlint ? 'package.json' : null;
+};
+exports.findCommitlintConfig = findCommitlintConfig;
+/**
+ * The git-commit skill states where its format comes from, and whether a message can be verified,
+ * from what the repo actually has. Promising a `commitlint` run to a repo without one makes the
+ * agent narrate the contradiction it finds instead of just writing the commit — so a repo with no
+ * commitlint gets a guide that never mentions it.
+ */
+const commitMessageVars = (source) => source
+    ? {
+        commitRuleSource: `the **commitlint rules** in \`${source}\` - conventional commits with a required scope`,
+        commitValidation: 'When unsure a message passes, check it: `echo "<msg>" | npx commitlint`.',
+    }
+    : {
+        commitRuleSource: "this repo's **conventional-commit** convention",
+        commitValidation: 'Nothing checks the message once it is written, so get the type, scope and subject case right the first time.',
+    };
+exports.commitMessageVars = commitMessageVars;
+//# sourceMappingURL=commitlint.js.map

package/src/lib/commitlint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitlint.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/commitlint.ts"],"names":[],"mappings":";;;AAAA,2BAA8C;AAC9C,+BAA4B;AAK5B,MAAM,uBAAuB,GAAG;IAC9B,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,wBAAwB;IACxB,uBAAuB;IACvB,eAAe;IACf,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,oBAAoB;IACpB,oBAAoB;IACpB,mBAAmB;CACpB,CAAC;AAEK,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAoB,EAAE;IACrE,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAExF,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAEhD,IAAI,CAAC,IAAA,eAAU,EAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,YAAY,EAAE,MAAM,CAAC,CAA6B,CAAC;IAE5F,OAAO,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC,CAAC;AAZW,QAAA,oBAAoB,wBAY/B;AAEF;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAA0B,EAAE,CACpF,MAAM;IACJ,CAAC,CAAC;QACE,gBAAgB,EAAE,iCAAiC,MAAM,iDAAiD;QAC1G,gBAAgB,EAAE,0EAA0E;KAC7F;IACH,CAAC,CAAC;QACE,gBAAgB,EAAE,gDAAgD;QAClE,gBAAgB,EACd,8GAA8G;KACjH,CAAC;AAVK,QAAA,iBAAiB,qBAUtB"}

package/src/lib/config.d.ts

@@ -1,7 +1,17 @@
 import { ContentScope } from './frontmatter';
+import { GitFlowConfig } from './git-flow';
 export declare const AGENT_TARGETS: readonly ["claude", "codex", "cursor", "copilot"];
 export type AgentTarget = (typeof AGENT_TARGETS)[number];
 export declare const CONFIG_FILE_NAME = "ethlete-agents.config.json";
+export declare const LOCAL_CONFIG_FILE_NAME = "ethlete-agents.config.local.json";
+/**
+ * How this repo reads a Jira issue into a branch name. The instance, the credentials and the subject
+ * field are not here and cannot be: the Timetrack app holds them, and `git-flow start` asks it.
+ */
+export type JiraSettings = {
+    /** Branch type per Jira issue type, e.g. `{ "Bug": "fix" }`. Anything unlisted becomes `feat`. */
+    typeByIssueType?: Record<string, string>;
+};
 export type SyncConfig = {
     root: string;
     targets: AgentTarget[];
@@ -9,10 +19,62 @@ export type SyncConfig = {
     scopes: ContentScope[];
     vars: Record<string, string | string[]>;
     exclude: string[];
+    /**
+     * Declares that the repo's `CLAUDE.md` is an `@AGENTS.md` import (or symlink). The claude
+     * target then skips `.claude/rules/ethlete/` — the rules already reach Claude through the
+     * `AGENTS.md` marker block, and a second copy would load twice.
+     */
+    claudeMdImportsAgentsMd: boolean;
+    /** Opt-in agent hooks (they run commands on the developer's machine, so never default). */
+    hooks: string[];
+    /** Opt-in git hooks, appended to the repo's own husky hooks. Same reason they never default. */
+    gitHooks: string[];
+    /** The branch grammar, resolved against its defaults — see `@ethlete/agent-rules/git-flow`. */
+    gitFlow: GitFlowConfig;
+    jira: JiraSettings;
+};
+/**
+ * The gitignored local config holds per-machine values, read at runtime — by the generated hook
+ * scripts, and by the agent while following a skill — never by `sync`. Sync output must be
+ * identical on every machine and in CI (the generated files are committed and `check` diffs them),
+ * so nothing here may change what gets emitted:
+ *
+ * - `disableHooks: true` silences every generated hook, `["context-warning"]` just the named ones.
+ * - `disableAutoHandoffSave: true` keeps the context-warning hook's normal tiered messages (including
+ *   in auto mode), but at the critical tier in auto mode it falls back to just recommending
+ *   a handoff instead of writing the handoff file automatically.
+ * - `sdkSourcePath` points at a local `ethlete-sdk` checkout, which the SDK source and local-build
+ *   skills read when they need the SDK's own sources instead of the published package.
+ * - `apiRepoPaths` maps an app in this repo to the checkout of the API it talks to (`{ "hub":
+ *   "../fut-hub-backend" }`), which the api-source skill reads to answer a question about the
+ *   server instead of guessing it from the client.
+ *
+ * No secret belongs here any more. Jira is reached through the Timetrack app, which holds the token
+ * in the machine's keychain — one secret per machine rather than one per checkout.
+ */
+export type LocalConfig = {
+    disableHooks?: boolean | string[];
+    disableAutoHandoffSave?: boolean;
+    sdkSourcePath?: string;
+    apiRepoPaths?: Record<string, string>;
+};
+export type LocalConfigState = {
+    exists: false;
+} | {
+    exists: true;
+    valid: false;
+} | {
+    exists: true;
+    valid: true;
+    config: LocalConfig;
+    unknownKeys: string[];
 };
+export declare const readLocalConfig: (root: string) => LocalConfigState;
 /**
- * Emit for the agents a repo already uses. Everything falls back to Codex's `AGENTS.md`,
- * which Cursor, Copilot and most other agents read as well.
+ * Emit for the agents a repo already uses. `codex` is always included: `AGENTS.md` is the
+ * cross-tool standard that Cursor, Copilot and most other agents read as well, and gating it on
+ * an existing `AGENTS.md` would mean the file that triggers Codex output is the very file the
+ * sync is supposed to create.
  */
 export declare const detectTargets: (root: string) => AgentTarget[];
 export declare const loadConfig: (options: {

package/src/lib/config.js

@@ -1,32 +1,59 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfig = exports.detectTargets = exports.CONFIG_FILE_NAME = exports.AGENT_TARGETS = void 0;
+exports.loadConfig = exports.detectTargets = exports.readLocalConfig = exports.LOCAL_CONFIG_FILE_NAME = exports.CONFIG_FILE_NAME = exports.AGENT_TARGETS = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const commitlint_1 = require("./commitlint");
+const git_flow_1 = require("./git-flow");
 const load_content_1 = require("./load-content");
 exports.AGENT_TARGETS = ['claude', 'codex', 'cursor', 'copilot'];
 exports.CONFIG_FILE_NAME = 'ethlete-agents.config.json';
+exports.LOCAL_CONFIG_FILE_NAME = 'ethlete-agents.config.local.json';
 const readRawConfig = (root) => {
     const path = (0, path_1.join)(root, exports.CONFIG_FILE_NAME);
     if (!(0, fs_1.existsSync)(path))
         return {};
     return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
 };
+const LOCAL_CONFIG_KEYS = [
+    'disableHooks',
+    'disableAutoHandoffSave',
+    'sdkSourcePath',
+    'apiRepoPaths',
+];
+const readLocalConfig = (root) => {
+    const path = (0, path_1.join)(root, exports.LOCAL_CONFIG_FILE_NAME);
+    if (!(0, fs_1.existsSync)(path))
+        return { exists: false };
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return { exists: true, valid: false };
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return { exists: true, valid: false };
+    const config = parsed;
+    const unknownKeys = Object.keys(config).filter((key) => !LOCAL_CONFIG_KEYS.includes(key));
+    return { exists: true, valid: true, config, unknownKeys };
+};
+exports.readLocalConfig = readLocalConfig;
 /**
- * Emit for the agents a repo already uses. Everything falls back to Codex's `AGENTS.md`,
- * which Cursor, Copilot and most other agents read as well.
+ * Emit for the agents a repo already uses. `codex` is always included: `AGENTS.md` is the
+ * cross-tool standard that Cursor, Copilot and most other agents read as well, and gating it on
+ * an existing `AGENTS.md` would mean the file that triggers Codex output is the very file the
+ * sync is supposed to create.
  */
 const detectTargets = (root) => {
-    const detected = [];
+    const detected = ['codex'];
     if ((0, fs_1.existsSync)((0, path_1.join)(root, '.claude')))
         detected.push('claude');
-    if ((0, fs_1.existsSync)((0, path_1.join)(root, 'AGENTS.md')) || (0, fs_1.existsSync)((0, path_1.join)(root, '.codex')))
-        detected.push('codex');
     if ((0, fs_1.existsSync)((0, path_1.join)(root, '.cursor')))
         detected.push('cursor');
     if ((0, fs_1.existsSync)((0, path_1.join)(root, '.github')))
         detected.push('copilot');
-    return detected.length > 0 ? detected : ['codex'];
+    return detected;
 };
 exports.detectTargets = detectTargets;
 const assertKnownTargets = (targets) => {
@@ -35,19 +62,37 @@ const assertKnownTargets = (targets) => {
         throw new Error(`Unknown target(s): ${unknown.join(', ')}. Known targets: ${exports.AGENT_TARGETS.join(', ')}.`);
     }
 };
+/**
+ * The git-flow skill interpolates the grammar it teaches from the same `gitFlow` block the
+ * validator reads, so the documented convention cannot drift from the enforced one. A repo can
+ * still override any of these through `vars`.
+ */
+const gitFlowVars = (gitFlow) => ({
+    gitFlowDevelopmentBranch: gitFlow.baseBranches.development,
+    gitFlowProductionBranch: gitFlow.baseBranches.production,
+    gitFlowTypes: gitFlow.types,
+    gitFlowEnforcement: gitFlow.enforcement,
+    gitFlowSubPrefix: gitFlow.subPrefix,
+});
 const loadConfig = (options) => {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e, _f, _g;
     const { root, targetOverride } = options;
     const raw = readRawConfig(root);
     const configured = raw.targets && raw.targets !== 'auto' ? raw.targets : undefined;
     const targets = (_a = targetOverride !== null && targetOverride !== void 0 ? targetOverride : configured) !== null && _a !== void 0 ? _a : (0, exports.detectTargets)(root);
+    const gitFlow = (0, git_flow_1.resolveGitFlowConfig)(raw.gitFlow);
     assertKnownTargets(targets);
     return {
         root,
         targets,
         scopes: raw.profile === 'sdk' ? ['both'] : ['consumer', 'both'],
-        vars: Object.assign(Object.assign({}, (0, load_content_1.loadDefaultVars)()), ((_b = raw.vars) !== null && _b !== void 0 ? _b : {})),
+        vars: Object.assign(Object.assign(Object.assign(Object.assign({}, (0, load_content_1.loadDefaultVars)()), gitFlowVars(gitFlow)), (0, commitlint_1.commitMessageVars)((0, commitlint_1.findCommitlintConfig)(root))), ((_b = raw.vars) !== null && _b !== void 0 ? _b : {})),
         exclude: (_c = raw.exclude) !== null && _c !== void 0 ? _c : [],
+        claudeMdImportsAgentsMd: (_d = raw.claudeMdImportsAgentsMd) !== null && _d !== void 0 ? _d : false,
+        hooks: (_e = raw.hooks) !== null && _e !== void 0 ? _e : [],
+        gitHooks: (_f = raw.gitHooks) !== null && _f !== void 0 ? _f : [],
+        gitFlow,
+        jira: (_g = raw.jira) !== null && _g !== void 0 ? _g : {},
     };
 };
 exports.loadConfig = loadConfig;

package/src/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/config.ts"],"names":[],"mappings":";;;AAAA,2BAA8C;AAC9C,+BAA4B;AAE5B,iDAAiD;AAEpC,QAAA,aAAa,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAIlE,QAAA,gBAAgB,GAAG,4BAA4B,CAAC;AAkB7D,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE;IACrC,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,wBAAgB,CAAC,CAAC;IAE1C,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAc,CAAC;AAC7D,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAC,IAAY,EAAiB,EAAE;IAC3D,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpG,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEhE,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC,CAAC;AATW,QAAA,aAAa,iBASxB;AAEF,MAAM,kBAAkB,GAAG,CAAC,OAAsB,EAAE,EAAE;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,qBAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,qBAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3G,CAAC;AACH,CAAC,CAAC;AAEK,MAAM,UAAU,GAAG,CAAC,OAAyD,EAAc,EAAE;;IAClG,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,MAAM,OAAO,GAAG,MAAA,cAAc,aAAd,cAAc,cAAd,cAAc,GAAI,UAAU,mCAAI,IAAA,qBAAa,EAAC,IAAI,CAAC,CAAC;IAEpE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE5B,OAAO;QACL,IAAI;QACJ,OAAO;QACP,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC;QAC/D,IAAI,kCAAO,IAAA,8BAAe,GAAE,GAAK,CAAC,MAAA,GAAG,CAAC,IAAI,mCAAI,EAAE,CAAC,CAAE;QACnD,OAAO,EAAE,MAAA,GAAG,CAAC,OAAO,mCAAI,EAAE;KAC3B,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,UAAU,cAerB"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/config.ts"],"names":[],"mappings":"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"}

package/src/lib/git-flow/build.d.ts

@@ -0,0 +1,35 @@
+import { GitFlowConfig } from './config';
+export declare const slugifySubject: (subject: string) => string;
+/**
+ * `parent` is the full branch name the new branch nests under — `feat/FIP-2177-user-management`
+ * for a sub-feature, `release/2026.04.28` for a release fix. The nested name keeps that whole path
+ * under the config's `subPrefix`, so the parent stays derivable from the child.
+ */
+export type BranchNameSpec = {
+    kind: 'main-feature';
+    type?: string;
+    key: string;
+    subject: string;
+} | {
+    kind: 'sub-feature';
+    parent: string;
+    key: string;
+    subject: string;
+} | {
+    kind: 'release';
+    date: string;
+} | {
+    kind: 'release-fix';
+    parent: string;
+    key: string;
+    subject: string;
+} | {
+    kind: 'hotfix';
+    key: string;
+    subject: string;
+};
+/** Builds a conforming branch name from the grammar. The single naming implementation. */
+export declare const buildBranchName: (options: {
+    spec: BranchNameSpec;
+    config: GitFlowConfig;
+}) => string;

package/src/lib/git-flow/build.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBranchName = exports.slugifySubject = void 0;
+const slugifySubject = (subject) => subject
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+exports.slugifySubject = slugifySubject;
+/** Builds a conforming branch name from the grammar. The single naming implementation. */
+const buildBranchName = (options) => {
+    var _a;
+    const { spec, config } = options;
+    if (spec.kind === 'release')
+        return `${config.releasePrefix}/${spec.date}`;
+    const leaf = [spec.key.toUpperCase(), (0, exports.slugifySubject)(spec.subject)].filter(Boolean).join('-');
+    if (spec.kind === 'main-feature')
+        return `${(_a = spec.type) !== null && _a !== void 0 ? _a : 'feat'}/${leaf}`;
+    if (spec.kind === 'hotfix')
+        return `${config.hotfixPrefix}/${leaf}`;
+    return `${config.subPrefix}/${spec.parent}/${leaf}`;
+};
+exports.buildBranchName = buildBranchName;
+//# sourceMappingURL=build.js.map

package/src/lib/git-flow/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/git-flow/build.ts"],"names":[],"mappings":";;;AAEO,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,EAAE,CAChD,OAAO;KACJ,IAAI,EAAE;KACN,WAAW,EAAE;KACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;KAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AALhB,QAAA,cAAc,kBAKE;AAc7B,0FAA0F;AACnF,MAAM,eAAe,GAAG,CAAC,OAAwD,EAAE,EAAE;;IAC1F,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEjC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAE3E,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,IAAA,sBAAc,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE9F,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,GAAG,MAAA,IAAI,CAAC,IAAI,mCAAI,MAAM,IAAI,IAAI,EAAE,CAAC;IAC1E,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;IAEpE,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;AACtD,CAAC,CAAC;AAXW,QAAA,eAAe,mBAW1B"}

package/src/lib/git-flow/config.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The branch grammar as data: one config drives the parser, the validators, the CLI, the generated
+ * skill and `@ethlete/timetrack`'s correlation engine.
+ *
+ * Nothing in this folder may import `fs`, `path` or `process`, or take a dependency — it is
+ * reachable as `@ethlete/agent-rules/git-flow` and gets bundled into a browser webview.
+ */
+export declare const GIT_FLOW_RULES: readonly ["unknown-type", "missing-key", "key-case", "missing-subject", "type-alias", "deprecated-prefix", "release-date", "wrong-mr-target", "protected-push"];
+export type GitFlowRule = (typeof GIT_FLOW_RULES)[number];
+export type GitFlowSeverity = 'off' | 'warn' | 'error';
+export type GitFlowEnforcement = 'advisory' | 'gated';
+export type GitFlowBranchKind = 'main-feature' | 'sub-feature' | 'release' | 'release-fix' | 'hotfix' | 'protected' | 'unknown';
+/**
+ * A legacy spelling that means one of the known kinds. `match` is a regular expression whose
+ * `subject` and `key` named groups feed `renameTo`, in which `<subject>` and `<KEY>` are the
+ * placeholders — an unresolved `<KEY>` is left in place, because only Jira can supply it.
+ */
+export type GitFlowDeprecatedShape = {
+    match: string;
+    kind: GitFlowBranchKind;
+    renameTo: string;
+};
+export type GitFlowConfig = {
+    enforcement: GitFlowEnforcement;
+    /**
+     * The segment a nested branch is prefixed with. Git refuses a ref that is both a branch and a
+     * directory of branches, so a sub-feature cannot be spelled `<parent>/<KEY>-<subject>` while its
+     * parent exists — the push is rejected with "refname conflict". The prefix moves the whole nested
+     * tree out of the way while keeping the parent's full path inside the child's name.
+     */
+    subPrefix: string;
+    keyPattern: string;
+    /**
+     * Project prefixes a key may use, e.g. `["FIP"]`. Empty accepts anything `keyPattern` matches,
+     * which also accepts `chore/angular-22` as issue ANGULAR-22 — set this in any repo whose
+     * branch subjects can start with a word followed by a number.
+     */
+    keyPrefixes: string[];
+    baseBranches: {
+        development: string;
+        production: string;
+    };
+    types: string[];
+    typeAliases: Record<string, string>;
+    releasePrefix: string;
+    releasePattern: string;
+    hotfixPrefix: string;
+    subjectCase: 'kebab';
+    deprecatedShapes: GitFlowDeprecatedShape[];
+    severity: Record<GitFlowRule, GitFlowSeverity>;
+};
+export declare const DEFAULT_GIT_FLOW_CONFIG: GitFlowConfig;
+export type RawGitFlowConfig = Partial<Omit<GitFlowConfig, 'baseBranches' | 'typeAliases' | 'severity'>> & {
+    baseBranches?: Partial<GitFlowConfig['baseBranches']>;
+    typeAliases?: Record<string, string>;
+    severity?: Partial<Record<GitFlowRule, GitFlowSeverity>>;
+};
+/** Fills a repo's `gitFlow` config block out to a complete grammar. */
+export declare const resolveGitFlowConfig: (raw?: RawGitFlowConfig) => GitFlowConfig;