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.
- package/README.md +125 -13
- package/dist/commands/output.js +2 -0
- package/dist/commands/output.js.map +1 -1
- package/dist/commands/rule.d.ts +23 -0
- package/dist/commands/rule.js +158 -0
- package/dist/commands/rule.js.map +1 -0
- package/dist/commands/sync.d.ts +19 -0
- package/dist/commands/sync.js +262 -0
- package/dist/commands/sync.js.map +1 -0
- package/dist/core/compatibility-matcher.d.ts +1 -1
- package/dist/core/compatibility-matcher.js.map +1 -1
- package/dist/core/git.d.ts +7 -0
- package/dist/core/git.js +16 -0
- package/dist/core/git.js.map +1 -0
- package/dist/core/index.d.ts +8 -2
- package/dist/core/index.js +4 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/project-environment-detector.js +1 -0
- package/dist/core/project-environment-detector.js.map +1 -1
- package/dist/core/ranker.js +23 -2
- package/dist/core/ranker.js.map +1 -1
- package/dist/core/remote-guardrail.d.ts +7 -0
- package/dist/core/remote-guardrail.js +18 -0
- package/dist/core/remote-guardrail.js.map +1 -0
- package/dist/core/rule-schema.d.ts +36 -2
- package/dist/core/rule-schema.js +20 -2
- package/dist/core/rule-schema.js.map +1 -1
- package/dist/core/search-types.d.ts +1 -0
- package/dist/core/semantic-checksum.d.ts +6 -0
- package/dist/core/semantic-checksum.js +34 -0
- package/dist/core/semantic-checksum.js.map +1 -0
- package/dist/core/stack-detector.js +1 -0
- package/dist/core/stack-detector.js.map +1 -1
- package/dist/index.d.ts +3 -2
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp/server.js +2 -1
- package/dist/mcp/server.js.map +1 -1
- package/dist/migration/applier.js +102 -17
- package/dist/migration/applier.js.map +1 -1
- package/dist/migration/manifest.d.ts +1 -0
- package/dist/migration/manifest.js +2 -0
- package/dist/migration/manifest.js.map +1 -1
- package/dist/migration/migration-report.d.ts +4 -0
- package/dist/migration/migration-report.js +4 -0
- package/dist/migration/migration-report.js.map +1 -1
- package/dist/migration/scanner.js +2 -0
- package/dist/migration/scanner.js.map +1 -1
- package/dist/migration/verifier.js +17 -21
- package/dist/migration/verifier.js.map +1 -1
- package/dist/program.js +6 -1
- package/dist/program.js.map +1 -1
- package/dist/storage/atomic-file.d.ts +1 -0
- package/dist/storage/atomic-file.js +43 -0
- package/dist/storage/atomic-file.js.map +1 -0
- package/dist/storage/index-check.d.ts +2 -0
- package/dist/storage/index-check.js +34 -12
- package/dist/storage/index-check.js.map +1 -1
- package/dist/storage/index.d.ts +1 -0
- package/dist/storage/index.js +1 -0
- package/dist/storage/index.js.map +1 -1
- package/dist/storage/indexer.js +18 -5
- package/dist/storage/indexer.js.map +1 -1
- package/dist/storage/migrations.d.ts +1 -1
- package/dist/storage/migrations.js +17 -1
- package/dist/storage/migrations.js.map +1 -1
- package/dist/storage/rulebook-home.js +3 -0
- package/dist/storage/rulebook-home.js.map +1 -1
- package/dist/storage/search-service.js +1 -0
- package/dist/storage/search-service.js.map +1 -1
- package/dist/version.d.ts +4 -0
- package/dist/version.js +33 -0
- package/dist/version.js.map +1 -0
- 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.
|
|
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
|
|
10
|
-
Darwin arm64
|
|
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
|
-
|
|
19
|
+
Run the published immutable version without a global install:
|
|
19
20
|
|
|
20
21
|
```bash
|
|
21
|
-
npx -y agent-rulebook@0.1.
|
|
22
|
-
npx -y agent-rulebook@0.1.
|
|
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.
|
|
26
|
-
|
|
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
|
|
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.
|
|
64
|
-
|
|
65
|
-
|
|
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.
|
package/dist/commands/output.js
CHANGED
|
@@ -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":"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"}
|
|
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>;
|