agent-rulebook 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/README.md +125 -13
  2. package/dist/commands/output.js +2 -0
  3. package/dist/commands/output.js.map +1 -1
  4. package/dist/commands/rule.d.ts +23 -0
  5. package/dist/commands/rule.js +158 -0
  6. package/dist/commands/rule.js.map +1 -0
  7. package/dist/commands/sync.d.ts +19 -0
  8. package/dist/commands/sync.js +262 -0
  9. package/dist/commands/sync.js.map +1 -0
  10. package/dist/core/compatibility-matcher.d.ts +1 -1
  11. package/dist/core/compatibility-matcher.js.map +1 -1
  12. package/dist/core/git.d.ts +7 -0
  13. package/dist/core/git.js +16 -0
  14. package/dist/core/git.js.map +1 -0
  15. package/dist/core/index.d.ts +8 -2
  16. package/dist/core/index.js +4 -1
  17. package/dist/core/index.js.map +1 -1
  18. package/dist/core/project-environment-detector.js +1 -0
  19. package/dist/core/project-environment-detector.js.map +1 -1
  20. package/dist/core/ranker.js +23 -2
  21. package/dist/core/ranker.js.map +1 -1
  22. package/dist/core/remote-guardrail.d.ts +7 -0
  23. package/dist/core/remote-guardrail.js +18 -0
  24. package/dist/core/remote-guardrail.js.map +1 -0
  25. package/dist/core/rule-schema.d.ts +36 -2
  26. package/dist/core/rule-schema.js +20 -2
  27. package/dist/core/rule-schema.js.map +1 -1
  28. package/dist/core/search-types.d.ts +1 -0
  29. package/dist/core/semantic-checksum.d.ts +6 -0
  30. package/dist/core/semantic-checksum.js +34 -0
  31. package/dist/core/semantic-checksum.js.map +1 -0
  32. package/dist/core/stack-detector.js +1 -0
  33. package/dist/core/stack-detector.js.map +1 -1
  34. package/dist/index.d.ts +3 -2
  35. package/dist/index.js +2 -1
  36. package/dist/index.js.map +1 -1
  37. package/dist/mcp/server.js +2 -1
  38. package/dist/mcp/server.js.map +1 -1
  39. package/dist/migration/applier.js +102 -17
  40. package/dist/migration/applier.js.map +1 -1
  41. package/dist/migration/manifest.d.ts +1 -0
  42. package/dist/migration/manifest.js +2 -0
  43. package/dist/migration/manifest.js.map +1 -1
  44. package/dist/migration/migration-report.d.ts +4 -0
  45. package/dist/migration/migration-report.js +4 -0
  46. package/dist/migration/migration-report.js.map +1 -1
  47. package/dist/migration/scanner.js +2 -0
  48. package/dist/migration/scanner.js.map +1 -1
  49. package/dist/migration/verifier.js +17 -21
  50. package/dist/migration/verifier.js.map +1 -1
  51. package/dist/program.js +6 -1
  52. package/dist/program.js.map +1 -1
  53. package/dist/storage/atomic-file.d.ts +1 -0
  54. package/dist/storage/atomic-file.js +43 -0
  55. package/dist/storage/atomic-file.js.map +1 -0
  56. package/dist/storage/index-check.d.ts +2 -0
  57. package/dist/storage/index-check.js +34 -12
  58. package/dist/storage/index-check.js.map +1 -1
  59. package/dist/storage/index.d.ts +1 -0
  60. package/dist/storage/index.js +1 -0
  61. package/dist/storage/index.js.map +1 -1
  62. package/dist/storage/indexer.js +18 -5
  63. package/dist/storage/indexer.js.map +1 -1
  64. package/dist/storage/migrations.d.ts +1 -1
  65. package/dist/storage/migrations.js +17 -1
  66. package/dist/storage/migrations.js.map +1 -1
  67. package/dist/storage/rulebook-home.js +3 -0
  68. package/dist/storage/rulebook-home.js.map +1 -1
  69. package/dist/storage/search-service.js +1 -0
  70. package/dist/storage/search-service.js.map +1 -1
  71. package/dist/version.d.ts +4 -0
  72. package/dist/version.js +33 -0
  73. package/dist/version.js.map +1 -0
  74. package/package.json +3 -2
package/README.md CHANGED
@@ -4,10 +4,11 @@ TypeScript CLI and MCP foundation for managing reusable agent rules.
4
4
 
5
5
  ## Requirements
6
6
 
7
- The `0.1.0` release candidate supports Node.js 20 and 22 through 26. Node.js 21
7
+ The packaged `0.1.2` artifact supports Node.js 20 and 22 through 26. Node.js 21
8
8
  is excluded because the pinned `better-sqlite3@12.11.1` native runtime does not
9
- declare support for it. The local artifact matrix currently covers Node 26 on
10
- Darwin arm64; Windows x64 remains a release gate before promotion to `latest`.
9
+ declare support for it. The local tarball matrix covers Node.js 20 and 22 through
10
+ 26 on Darwin arm64. Windows x64 remains a deferred gate before implementation
11
+ completion or a Windows/cross-platform support claim.
11
12
 
12
13
  Agent Rulebook keeps rule YAML and its rebuildable SQLite index outside the npm
13
14
  package in `~/.agent-rulebook` by default. Reinstalling the package or clearing
@@ -15,20 +16,132 @@ the npm cache must not remove that data.
15
16
 
16
17
  ## Run the CLI
17
18
 
18
- After the exact candidate is published, run it without a global install:
19
+ Run the published immutable version without a global install:
19
20
 
20
21
  ```bash
21
- npx -y agent-rulebook@0.1.0 --help
22
- npx -y agent-rulebook@0.1.0 mcp
22
+ npx -y agent-rulebook@0.1.2 --help
23
+ npx -y agent-rulebook@0.1.2 mcp
23
24
  ```
24
25
 
25
- `agent-rulebook@0.1.0` is currently a local release candidate, not a published
26
- registry version. The actual `next` publish is a separate release step.
26
+ `agent-rulebook@0.1.2` is an immutable package version. Production
27
+ configuration should pin this exact version. Registry tags such as `latest` are
28
+ mutable and are not asserted by this artifact.
27
29
 
28
30
  ## Documentation
29
31
 
30
32
  - [Codex adapter setup](docs/adapters/codex.md)
31
33
 
34
+ ## Private YAML sync
35
+
36
+ Initialize `~/.agent-rulebook` as a Git repository whose tracked files are limited
37
+ to `rules/**/*.yaml`, `.gitignore`, and a safe `config.yaml` or
38
+ `config.example.yaml`. SQLite/WAL/SHM files, locks, logs, reports, and temporary
39
+ files must remain untracked. Setup documentation stays in this product repository,
40
+ not in the private data remote. If any local artifact or other non-allowlisted
41
+ file is tracked, `sync push` fails with a remediation path.
42
+
43
+ ### First machine and an empty private remote
44
+
45
+ Create an empty private repository with the Git hosting provider. Do not add a
46
+ server-generated README, license, or `.gitignore`. Then initialize and commit the
47
+ local Rulebook data:
48
+
49
+ ```bash
50
+ agent-rulebook init
51
+ git -C ~/.agent-rulebook init -b main
52
+ git -C ~/.agent-rulebook remote add origin <private-remote-url>
53
+ git -C ~/.agent-rulebook add .gitignore config.yaml
54
+ git -C ~/.agent-rulebook commit -m "Initialize private Agent Rulebook data"
55
+ ```
56
+
57
+ Verify the repository visibility with the hosting provider. Only after it is
58
+ confirmed private, record that evidence in local Git config. This marker is local
59
+ and must be configured independently on every machine:
60
+
61
+ ```bash
62
+ git -C ~/.agent-rulebook config remote.origin.agentRulebookPrivacy private
63
+ agent-rulebook sync push # preview remote URL and changed files
64
+ agent-rulebook sync push --yes # execute exactly the reviewed push
65
+ ```
66
+
67
+ The privacy marker is not inferred from the URL. A missing/unknown marker or a
68
+ `public` marker blocks push. Before invoking Git, the command also requires a
69
+ clean, conflict-free worktree and preflights every changed rule through schema
70
+ validation and secret detection. `sync pull` uses fast-forward-only Git and then
71
+ checks/rebuilds the local SQLite projection from canonical YAML.
72
+
73
+ Actual private-remote writes remain user-approved operations. Inspect the target
74
+ and commits with `git remote -v` and `git log --oneline @{upstream}..HEAD` before
75
+ the first real push.
76
+
77
+ ### Additional machine
78
+
79
+ On a new machine, clone first so `agent-rulebook init` does not create a nonempty
80
+ destination before Git:
81
+
82
+ ```bash
83
+ git clone <private-remote-url> ~/.agent-rulebook
84
+ agent-rulebook init
85
+ git -C ~/.agent-rulebook config remote.origin.agentRulebookPrivacy private
86
+ agent-rulebook sync pull
87
+ agent-rulebook index check
88
+ ```
89
+
90
+ `sync pull` is fast-forward-only. It validates the pulled rule sources and checks
91
+ the local index, rebuilding SQLite when the source count, semantic checksum, or
92
+ schema version differs. The SQLite database is created separately on every
93
+ machine and is never pulled from Git.
94
+
95
+ An intentionally empty data remote is a valid initial state. In that case,
96
+ `index check --json` should report `status: ok`, `sourceCount: 0`, and
97
+ `indexedCount: 0`; search returns no results until the first active canonical rule
98
+ is committed. Do not seed a new private remote from temporary test homes or
99
+ fixtures—wait for a real rule or migrate a reviewed permanent source.
100
+
101
+ ### Normal workflow
102
+
103
+ ```bash
104
+ agent-rulebook sync pull
105
+ # Add, verify, deprecate, or supersede rules locally.
106
+ git -C ~/.agent-rulebook add rules
107
+ git -C ~/.agent-rulebook commit -m "Update Agent Rulebook rules"
108
+ agent-rulebook sync push
109
+ agent-rulebook sync push --yes
110
+ ```
111
+
112
+ If `sync push` reports a dirty worktree, commit the reviewed canonical YAML change
113
+ first. If it reports a conflict, resolve every listed YAML field and rebuild the
114
+ index before retrying.
115
+
116
+ ## Lifecycle and recovery
117
+
118
+ Lifecycle changes preview by default; add `--yes` after reviewing the target:
119
+
120
+ ```bash
121
+ agent-rulebook rule verify <draft-id> --evidence <test-or-review-reference>
122
+ agent-rulebook rule deprecate <active-id>
123
+ agent-rulebook rule supersede <active-id> --replacement <active-replacement-id>
124
+ ```
125
+
126
+ Verification requires explicit evidence and known compatibility. Superseding
127
+ requires an existing active replacement and rejects replacement cycles. Applied
128
+ changes atomically replace one YAML source and rebuild SQLite, so default CLI/MCP
129
+ search immediately reflects the lifecycle state.
130
+
131
+ Use these local-first recovery paths:
132
+
133
+ ```bash
134
+ agent-rulebook index check
135
+ agent-rulebook index rebuild
136
+ git -C ~/.agent-rulebook status
137
+ ```
138
+
139
+ - For a corrupt, outdated, or checksum-mismatched index, rebuild from YAML.
140
+ - For Git conflicts, resolve every listed YAML file and validate it before
141
+ rebuilding or pushing; the tool never auto-merges rule conflicts.
142
+ - For a bad synced commit, create a normal `git revert <commit>` rollback, then
143
+ pull and rebuild. Do not restore or synchronize a SQLite file.
144
+
32
145
  ## Development
33
146
 
34
147
  ```bash
@@ -58,9 +171,8 @@ platform, and architecture so unsupported native combinations can be reported.
58
171
 
59
172
  ## Release status
60
173
 
61
- The candidate version is `0.1.0`, the package is explicitly `UNLICENSED`, and
174
+ The packaged release version is `0.1.2`, the package is explicitly `UNLICENSED`, and
62
175
  no public repository, homepage, or issue tracker is currently advertised because
63
- the source remote is not publicly accessible. The unscoped package name returned
64
- `E404` on 2026-08-19, but availability must be checked again immediately before
65
- publish; use an owned npm scope if it has been claimed. No publish or dist-tag
66
- operation is performed by the local verification scripts.
176
+ the source remote is not publicly accessible. Package availability and mutable
177
+ registry tags must be checked again immediately before publish. No publish or
178
+ dist-tag operation is performed by the local verification scripts.
@@ -26,6 +26,8 @@ export function writeIndexCheckText(result) {
26
26
  process.stdout.write(`status\t${result.status}\n`);
27
27
  process.stdout.write(`sourceCount\t${result.sourceCount}\n`);
28
28
  process.stdout.write(`indexedCount\t${result.indexedCount}\n`);
29
+ process.stdout.write(`sourceChecksum\t${result.sourceChecksum}\n`);
30
+ process.stdout.write(`indexedChecksum\t${result.indexedChecksum ?? 'unavailable'}\n`);
29
31
  process.stdout.write(`indexPath\t${result.indexPath}\n`);
30
32
  if (result.runtime !== undefined) {
31
33
  process.stdout.write(`userVersion\t${result.runtime.userVersion}\n`);
@@ -1 +1 @@
1
- {"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAwB;IACtD,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,YAAY,IAAI,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC/D,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAkC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;IAE1D,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAwB;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IAEzD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;QACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC;QACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;QACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAoB;IAC9C,OAAO;QACL,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,EAAE;QACnG,YAAY,MAAM,CAAC,OAAO,EAAE;QAC5B,QAAQ,MAAM,CAAC,GAAG,EAAE;QACpB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
1
+ {"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import type { Command } from 'commander';
2
+ type LifecycleAction = 'deprecate' | 'supersede' | 'verify';
3
+ type LifecycleIssue = {
4
+ code: string;
5
+ message: string;
6
+ ruleId?: string;
7
+ };
8
+ type LifecycleOptions = {
9
+ evidence?: string;
10
+ replacement?: string;
11
+ yes?: boolean;
12
+ json?: boolean;
13
+ };
14
+ type LifecycleResult = {
15
+ status: 'blocked' | 'preview' | 'updated';
16
+ action: LifecycleAction;
17
+ ruleId: string;
18
+ replacement?: string;
19
+ issues: LifecycleIssue[];
20
+ };
21
+ export declare function registerRuleCommand(program: Command): Command;
22
+ export declare function changeRuleLifecycle(home: string, action: LifecycleAction, ruleId: string, options: LifecycleOptions): Promise<LifecycleResult>;
23
+ export {};
@@ -0,0 +1,158 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ import { stringify } from 'yaml';
4
+ import { parseRuleYaml, resolveRulebookHome, RuleSchema, } from '../core/index.js';
5
+ import { discoverRuleFiles, rebuildRulebookIndex, replaceFileAtomically, } from '../storage/index.js';
6
+ import { writeJson } from './output.js';
7
+ export function registerRuleCommand(program) {
8
+ const rule = program.command('rule').description('Manage rule lifecycle state');
9
+ rule
10
+ .command('verify')
11
+ .argument('<id>', 'Draft rule id')
12
+ .requiredOption('--evidence <evidence>', 'Verification evidence')
13
+ .option('--yes', 'Apply the previewed lifecycle change')
14
+ .option('--json', 'Print JSON output')
15
+ .action(async (id, options) => {
16
+ emitLifecycle(await changeRuleLifecycle(resolveRulebookHome(), 'verify', id, options), options);
17
+ });
18
+ rule
19
+ .command('deprecate')
20
+ .argument('<id>', 'Active rule id')
21
+ .option('--yes', 'Apply the previewed lifecycle change')
22
+ .option('--json', 'Print JSON output')
23
+ .action(async (id, options) => {
24
+ emitLifecycle(await changeRuleLifecycle(resolveRulebookHome(), 'deprecate', id, options), options);
25
+ });
26
+ rule
27
+ .command('supersede')
28
+ .argument('<id>', 'Active rule id')
29
+ .requiredOption('--replacement <id>', 'Replacement rule id')
30
+ .option('--yes', 'Apply the previewed lifecycle change')
31
+ .option('--json', 'Print JSON output')
32
+ .action(async (id, options) => {
33
+ emitLifecycle(await changeRuleLifecycle(resolveRulebookHome(), 'supersede', id, options), options);
34
+ });
35
+ return program;
36
+ }
37
+ export async function changeRuleLifecycle(home, action, ruleId, options) {
38
+ const loaded = await loadRuleSources(home);
39
+ if (loaded.issues.length > 0) {
40
+ return { status: 'blocked', action, ruleId, issues: loaded.issues };
41
+ }
42
+ const matches = loaded.rules.filter((item) => item.rule.id === ruleId);
43
+ if (matches.length !== 1) {
44
+ return {
45
+ status: 'blocked', action, ruleId,
46
+ issues: [{ code: matches.length === 0 ? 'rule_missing' : 'duplicate_rule_id', message: `Expected exactly one source for ${ruleId}.`, ruleId }],
47
+ };
48
+ }
49
+ const target = matches[0];
50
+ const issues = validateTransition(action, target.rule, loaded.rules, options);
51
+ if (issues.length > 0) {
52
+ return { status: 'blocked', action, ruleId, replacement: options.replacement, issues };
53
+ }
54
+ if (options.yes !== true) {
55
+ return { status: 'preview', action, ruleId, replacement: options.replacement, issues: [] };
56
+ }
57
+ const now = new Date().toISOString().slice(0, 10);
58
+ const candidate = {
59
+ ...target.rule,
60
+ status: action === 'verify' ? 'active' : action === 'deprecate' ? 'deprecated' : 'superseded',
61
+ updated_at: now,
62
+ ...(action === 'verify' ? { verified_at: now } : {}),
63
+ superseded_by: action === 'supersede' ? options.replacement : null,
64
+ };
65
+ delete candidate.legacy;
66
+ const normalized = RuleSchema.safeParse(candidate);
67
+ if (!normalized.success) {
68
+ return { status: 'blocked', action, ruleId, issues: [{ code: 'invalid_rule', message: normalized.error.message, ruleId }] };
69
+ }
70
+ const yaml = stringify(normalized.data, { lineWidth: 0 });
71
+ await replaceFileAtomically(target.path, yaml);
72
+ try {
73
+ await rebuildRulebookIndex({ home });
74
+ }
75
+ catch (error) {
76
+ await replaceFileAtomically(target.path, target.source);
77
+ await rebuildRulebookIndex({ home });
78
+ throw error;
79
+ }
80
+ return { status: 'updated', action, ruleId, replacement: options.replacement, issues: [] };
81
+ }
82
+ function validateTransition(action, target, all, options) {
83
+ if (target.legacy !== undefined) {
84
+ return [{ code: 'legacy_rule', message: 'Migrate the legacy rule to schema v2 before lifecycle changes.', ruleId: target.id }];
85
+ }
86
+ if (action === 'verify') {
87
+ if (target.status !== 'draft') {
88
+ return [{ code: 'invalid_transition', message: 'Only draft rules can be verified.', ruleId: target.id }];
89
+ }
90
+ if (options.evidence === undefined || options.evidence.trim().length === 0) {
91
+ return [{ code: 'verification_evidence_missing', message: 'Verification evidence is required.', ruleId: target.id }];
92
+ }
93
+ if (target.compatibility.scope === 'unknown') {
94
+ return [{ code: 'compatibility_unknown', message: 'Resolve compatibility before verifying the rule.', ruleId: target.id }];
95
+ }
96
+ if (target.compatibility.scope === 'constrained' &&
97
+ target.compatibility.verified_with.length === 0) {
98
+ return [{ code: 'compatibility_evidence_missing', message: 'Constrained compatibility requires verified_with evidence.', ruleId: target.id }];
99
+ }
100
+ return [];
101
+ }
102
+ if (target.status !== 'active') {
103
+ return [{ code: 'invalid_transition', message: 'Only active rules can be deprecated or superseded.', ruleId: target.id }];
104
+ }
105
+ if (action === 'deprecate') {
106
+ return [];
107
+ }
108
+ const replacement = all.find((item) => item.rule.id === options.replacement);
109
+ if (replacement === undefined) {
110
+ return [{ code: 'replacement_missing', message: `Replacement ${options.replacement ?? ''} does not exist.`, ruleId: target.id }];
111
+ }
112
+ const links = new Map(all.map((item) => [item.rule.id, item.rule.superseded_by ?? undefined]));
113
+ links.set(target.id, replacement.rule.id);
114
+ const visited = new Set();
115
+ let current = target.id;
116
+ while (current !== undefined) {
117
+ if (visited.has(current)) {
118
+ return [{ code: 'replacement_cycle', message: `Replacement graph would create a cycle at ${current}.`, ruleId: target.id }];
119
+ }
120
+ visited.add(current);
121
+ current = links.get(current);
122
+ }
123
+ if (replacement.rule.status !== 'active') {
124
+ return [{ code: 'replacement_inactive', message: 'Replacement must be active.', ruleId: replacement.rule.id }];
125
+ }
126
+ return [];
127
+ }
128
+ async function loadRuleSources(home) {
129
+ const files = await discoverRuleFiles({ rulesDir: join(home, 'rules') });
130
+ const rules = [];
131
+ const issues = [];
132
+ for (const path of files) {
133
+ const source = await readFile(path, 'utf8');
134
+ const parsed = parseRuleYaml(source, { filePath: path });
135
+ if (!parsed.success) {
136
+ issues.push({ code: 'invalid_rule_source', message: `${path}: ${parsed.error.message}` });
137
+ }
138
+ else {
139
+ rules.push({ path, source, rule: parsed.rule });
140
+ }
141
+ }
142
+ return { rules, issues };
143
+ }
144
+ function emitLifecycle(result, options) {
145
+ if (options.json === true) {
146
+ writeJson(result);
147
+ }
148
+ else {
149
+ process.stdout.write(`${result.status}\t${result.action}\t${result.ruleId}\n`);
150
+ for (const issue of result.issues) {
151
+ process.stdout.write(`issue\t${issue.code}\t${issue.message}\n`);
152
+ }
153
+ }
154
+ if (result.status !== 'updated') {
155
+ process.exitCode = 1;
156
+ }
157
+ }
158
+ //# sourceMappingURL=rule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rule.js","sourceRoot":"","sources":["../../src/commands/rule.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { Command } from 'commander';
2
+ import { checkRulebookIndex } from '../storage/index.js';
3
+ export type SyncIssue = {
4
+ code: string;
5
+ message: string;
6
+ path?: string;
7
+ fields?: string[];
8
+ };
9
+ export type SyncResult = {
10
+ status: 'blocked' | 'failed' | 'preview' | 'pulled' | 'pushed';
11
+ remote: string;
12
+ remoteUrl?: string;
13
+ changedFiles: string[];
14
+ issues: SyncIssue[];
15
+ index?: Awaited<ReturnType<typeof checkRulebookIndex>>;
16
+ };
17
+ export declare function registerSyncCommand(program: Command): Command;
18
+ export declare function syncPush(home: string, remote?: string, confirmed?: boolean): Promise<SyncResult>;
19
+ export declare function syncPull(home: string, remote?: string): Promise<SyncResult>;