@muxion/dev-config 0.2.0 → 0.3.0

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.
@@ -0,0 +1,22 @@
1
+ ---
2
+ paths:
3
+ - '**/packages/core-*/**'
4
+ - '**/packages/libp2p-*/**'
5
+ - '**/ARCHITECTURE.md'
6
+ ---
7
+
8
+ # Pluggability Rules
9
+
10
+ This layer adds to the engineering principles.
11
+
12
+ - Follow the principles, diagrams, and step registry in the muxion-core `ARCHITECTURE.md`, and in the `ARCHITECTURE.md` of the repository that you change, if it has one.
13
+ - Give each step in the workflow diagram an interface, also with one implementation.
14
+ - Put per-packet steps in Rust traits. Put I/O, clock, signing, and seed steps in host interfaces.
15
+ - Let a plug decide policy. Keep validation, limits, and replay checks in the core.
16
+ - Use `Box<dyn Trait>` for plugs. Use generics only when a benchmark shows a need.
17
+ - Use a factory for a plug with per-path or per-connection state. Do not name a concrete plug at a construction site.
18
+ - Give time to a plug as an argument. Do not let a plug own clocks, threads, I/O, or randomness.
19
+ - Add an ABI discriminator for a plug only when a second built-in implementation exists.
20
+ - Update the diagram and the registry in the commit that adds, removes, or moves a step.
21
+ - Run the contract test suite of an interface against each implementation.
22
+ - The rule "Add an abstraction only for a current need" does not apply to steps in the workflow diagram.
@@ -6,7 +6,7 @@ This layer adds to the engineering principles.
6
6
 
7
7
  - Use npm 11 workspaces and commit `package-lock.json` in repositories that contain packages.
8
8
  - Put workspace packages in `packages/`. Put runnable examples in `examples/`.
9
- - Each package directory in `packages/` ends with `-js` (cross-platform JavaScript), `-node` (Node.js), `-web` (browser), or `-rust`. The `muxion-agents check` command enforces this.
9
+ - Each package directory in `packages/` ends with `-js` (cross-platform JavaScript), `-node` (Node.js), `-web` (browser), or `-rust`, or contains `-node-` (a Node.js part, such as `core-node-native`). The `muxion-agents check` command enforces this.
10
10
  - Put shared integration tests in `tests/`. Put benchmarks or diagnostics in their named top-level directories.
11
11
  - Keep generated files in the output directory that owns them. Do not edit generated files by hand.
12
12
  - Use Turborepo for dependency-ordered `build`, `test`, and `lint` tasks.
@@ -24,6 +24,8 @@ This layer adds to the engineering principles.
24
24
  - Keep the root `.oxfmtrc.mjs` limited to the shared configuration re-export.
25
25
  - Do not copy or override shared TypeScript, Oxlint, or Oxfmt policy.
26
26
  - Link `.claude/rules/muxion` to `../../node_modules/@muxion/dev-config/agents`. Do not copy the shared rules.
27
+ - Link `.claude/skills/muxion-release` to `../../node_modules/@muxion/dev-config/skills/muxion-release`.
28
+ - Commit `.claude/settings.json` with the permissions that `muxion-agents check` requires.
27
29
 
28
30
  ## Verification
29
31
 
@@ -32,7 +34,4 @@ This layer adds to the engineering principles.
32
34
 
33
35
  ## Releases
34
36
 
35
- - Run repository verification, package dry runs, content checks, and dependency checks before a public publish.
36
- - Publish public packages only with `npm run publish` in the child repository. It runs the `muxion-publish` tool from `@muxion/dev-config`. To publish all child repositories in dependency order, run `npm run publish:all` in `muxion-all`.
37
- - Do not run `npm publish` directly.
38
- - Run the publish script with `-- --dry-run` first. If it reports a changed package, increase the version of that package before you publish.
37
+ - To publish, use the `muxion-release` skill. Do not run `npm publish` directly.
@@ -8,7 +8,6 @@ paths:
8
8
  This layer adds to the Rust layer.
9
9
 
10
10
  - Keep protocol cores deterministic and independent of runtimes and platforms.
11
- - Do not use `unsafe` outside ABI modules.
12
11
  - Use the sans-IO shape: `handle_input(bytes, now)`, `poll_transmit(now)`, and `poll_timeout()`. The host gives time and seeds.
13
12
  - Do not panic on peer input. Check bounds in all parsing (`clippy::indexing_slicing`).
14
13
  - Use `checked_`, `saturating_`, or `wrapping_` arithmetic explicitly (`clippy::arithmetic_side_effects`).
@@ -16,3 +15,4 @@ This layer adds to the Rust layer.
16
15
  - Do not iterate a hash map or hash set when the order changes the output (`clippy::iter_over_hash_type`).
17
16
  - Keep the core ready for `no_std` with `alloc`. Use `core` and `alloc` paths (`clippy::std_instead_of_core`, `clippy::std_instead_of_alloc`).
18
17
  - Give each queue, buffer, and map that peer input can grow a limit from configuration.
18
+ - Put the lints of this layer in `#![deny(...)]` at the crate root. This replaces the Rust layer rule "Do not put `#![deny]` at crate roots" for the lints of this layer only.
@@ -1,15 +1,13 @@
1
1
  ---
2
2
  paths:
3
- - '**/abi.rs'
4
- - '**/abi/**/*.rs'
3
+ - '**/src/abi.rs'
4
+ - '**/src/abi/**/*.rs'
5
5
  ---
6
6
 
7
7
  # Rust C ABI Rules
8
8
 
9
9
  This layer adds to the Rust layer. It applies to ABI modules.
10
10
 
11
- - Confine handwritten `unsafe` code to ABI or generated boundary modules.
12
- - Add a safety explanation to each handwritten `unsafe` block.
13
11
  - Give each `unsafe fn` a `# Safety` section. Put one unsafe operation in each block (`clippy::undocumented_unsafe_blocks`, `clippy::multiple_unsafe_ops_per_block`, `clippy::missing_safety_doc`).
14
12
  - Write `#[unsafe(no_mangle)]` and `unsafe extern "C"`.
15
13
  - Do not let a panic cross `extern "C"`. Catch it with `catch_unwind` and return an error code. Choose one panic strategy for the crate and state it.
@@ -17,4 +15,3 @@ This layer adds to the Rust layer. It applies to ABI modules.
17
15
  - Free memory on the side that allocated it. Export a `*_free` function for each owned output.
18
16
  - Export `abi_version()`. Use `#[repr(u32)]` enums. Reject unknown discriminants on input.
19
17
  - Return status codes. Return values through out-parameters.
20
- - Keep native results borrowed only for the current operation. Copy data before the next native call.
package/agents/rust.md CHANGED
@@ -9,6 +9,8 @@ paths:
9
9
  This layer adds to the engineering principles.
10
10
 
11
11
  - Use edition 2024.
12
+ - Confine handwritten `unsafe` code to ABI or generated boundary modules.
13
+ - Add a safety explanation to each handwritten `unsafe` block.
12
14
  - Keep `cargo fmt` and workspace Clippy settings in each repository that contains Rust.
13
15
  - Put lint policy in `[workspace.lints]`. Set `lints.workspace = true` in each crate. Do not put `#![deny]` at crate roots.
14
16
  - Suppress a lint with `#[expect(lint, reason = "...")]`. Do not use `allow` (`clippy::allow_attributes_without_reason`).
@@ -20,6 +20,7 @@ This layer adds to the engineering principles.
20
20
  - Use `bigint` for 64-bit values at TypeScript and native boundaries.
21
21
  - Trust typed values. Validate untyped input only when it enters a typed boundary.
22
22
  - Use integer discriminators across runtime and native boundaries.
23
+ - Keep native results borrowed only for the current operation. Copy data before the next native call.
23
24
  - Keep lint suppressions on the smallest item and state the reason.
24
25
 
25
26
  ## APIs
@@ -1,5 +1,8 @@
1
1
  export declare const agentsLinkPath = ".claude/rules/muxion";
2
2
  export declare const agentsLinkTarget = "../../node_modules/@muxion/dev-config/agents";
3
+ export declare const skillLinkPath = ".claude/skills/muxion-release";
4
+ export declare const skillLinkTarget = "../../node_modules/@muxion/dev-config/skills/muxion-release";
3
5
  export declare const isTargetPackageName: (name: string) => boolean;
6
+ export declare const readPackageDirectories: (root: string) => Promise<string[]>;
4
7
  export declare const checkRepository: (root: string) => Promise<string[]>;
5
8
  //# sourceMappingURL=agents-check.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"agents-check.d.ts","sourceRoot":"","sources":["../src/agents-check.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc,yBAAyB,CAAA;AACpD,eAAO,MAAM,gBAAgB,iDAAiD,CAAA;AAI9E,eAAO,MAAM,mBAAmB,SAAU,MAAM,KAAG,OACgC,CAAA;AA2FnF,eAAO,MAAM,eAAe,SAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAGpE,CAAA"}
1
+ {"version":3,"file":"agents-check.d.ts","sourceRoot":"","sources":["../src/agents-check.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,yBAAyB,CAAA;AACpD,eAAO,MAAM,gBAAgB,iDAAiD,CAAA;AAE9E,eAAO,MAAM,aAAa,kCAAkC,CAAA;AAC5D,eAAO,MAAM,eAAe,gEAAgE,CAAA;AAI5F,eAAO,MAAM,mBAAmB,SAAU,MAAM,KAAG,OACgC,CAAA;AAwDnF,eAAO,MAAM,sBAAsB,SAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAU3E,CAAA;AAqBD,eAAO,MAAM,eAAe,SAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAGpE,CAAA"}
@@ -1,26 +1,21 @@
1
1
  // oxlint-disable-next-line import/no-nodejs-modules -- The check reads the repository files.
2
- import { lstat, readdir, readFile, readlink, stat } from 'node:fs/promises';
2
+ import { lstat, readdir, readFile, readlink } from 'node:fs/promises';
3
3
  // oxlint-disable-next-line import/no-nodejs-modules -- The check makes repository paths.
4
4
  import { dirname, join } from 'node:path';
5
+ import { checkSettings } from './agents-settings.js';
6
+ import { exists, isNotFound } from './files.js';
5
7
  export const agentsLinkPath = '.claude/rules/muxion';
6
8
  export const agentsLinkTarget = '../../node_modules/@muxion/dev-config/agents';
9
+ export const skillLinkPath = '.claude/skills/muxion-release';
10
+ export const skillLinkTarget = '../../node_modules/@muxion/dev-config/skills/muxion-release';
7
11
  const targetSuffixes = ['-js', '-node', '-web', '-rust'];
8
12
  export const isTargetPackageName = (name) => targetSuffixes.some((suffix) => name.endsWith(suffix)) || name.includes('-node-');
9
- const isNotFound = (error) => error instanceof Error && 'code' in error && error.code === 'ENOENT';
10
- const exists = async (path) => {
11
- try {
12
- await stat(path);
13
- return true;
14
- }
15
- catch (error) {
16
- if (isNotFound(error)) {
17
- return false;
18
- }
19
- throw error;
20
- }
21
- };
22
- const checkLink = async (root) => {
23
- const link = join(root, agentsLinkPath);
13
+ const links = [
14
+ { path: agentsLinkPath, target: agentsLinkTarget, version: '0.2.0' },
15
+ { path: skillLinkPath, target: skillLinkTarget, version: '0.3.0' },
16
+ ];
17
+ const checkLink = async (root, { path, target, version }) => {
18
+ const link = join(root, path);
24
19
  let isLink;
25
20
  try {
26
21
  const stats = await lstat(link);
@@ -28,20 +23,20 @@ const checkLink = async (root) => {
28
23
  }
29
24
  catch (error) {
30
25
  if (isNotFound(error)) {
31
- return [`${agentsLinkPath} does not exist. Make it a symlink to ${agentsLinkTarget}.`];
26
+ return [`${path} does not exist. Make it a symlink to ${target}.`];
32
27
  }
33
28
  throw error;
34
29
  }
35
30
  if (!isLink) {
36
- return [`${agentsLinkPath} is not a symlink. Make it a symlink to ${agentsLinkTarget}.`];
31
+ return [`${path} is not a symlink. Make it a symlink to ${target}.`];
37
32
  }
38
- const target = await readlink(link);
39
- if (target !== agentsLinkTarget) {
40
- return [`${agentsLinkPath} points to ${target}. It must point to ${agentsLinkTarget}.`];
33
+ const actual = await readlink(link);
34
+ if (actual !== target) {
35
+ return [`${path} points to ${actual}. It must point to ${target}.`];
41
36
  }
42
- if (!(await exists(join(dirname(link), target)))) {
37
+ if (!(await exists(join(dirname(link), actual)))) {
43
38
  return [
44
- `${agentsLinkPath} does not resolve. Run npm install, and use @muxion/dev-config 0.2.0 or later.`,
39
+ `${path} does not resolve. Run npm install, and use @muxion/dev-config ${version} or later.`,
45
40
  ];
46
41
  }
47
42
  return [];
@@ -61,7 +56,7 @@ const readExempt = async (root) => {
61
56
  }
62
57
  return exempt;
63
58
  };
64
- const readPackageDirectories = async (root) => {
59
+ export const readPackageDirectories = async (root) => {
65
60
  try {
66
61
  const entries = await readdir(join(root, 'packages'), { withFileTypes: true });
67
62
  return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
@@ -78,7 +73,7 @@ const checkPackages = async (root) => {
78
73
  const directories = await readPackageDirectories(root);
79
74
  const errors = directories
80
75
  .filter((name) => !isTargetPackageName(name) && !exempt.includes(name))
81
- .map((name) => `packages/${name} must end with -js, -node, -web, or -rust, or be in muxionAgents.exempt.`);
76
+ .map((name) => `packages/${name} must end with -js, -node, -web, or -rust, or contain -node-, or be in muxionAgents.exempt.`);
82
77
  for (const name of exempt) {
83
78
  if (!directories.includes(name)) {
84
79
  errors.push(`The exempt package ${name} does not exist in packages/. Remove it from muxionAgents.exempt.`);
@@ -86,8 +81,8 @@ const checkPackages = async (root) => {
86
81
  }
87
82
  return errors;
88
83
  };
89
- export const checkRepository = async (root) => [
90
- ...(await checkLink(root)),
91
- ...(await checkPackages(root)),
92
- ];
84
+ export const checkRepository = async (root) => {
85
+ const linkErrors = await Promise.all(links.map((link) => checkLink(root, link)));
86
+ return [...linkErrors.flat(), ...(await checkSettings(root)), ...(await checkPackages(root))];
87
+ };
93
88
  //# sourceMappingURL=agents-check.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"agents-check.js","sourceRoot":"","sources":["../src/agents-check.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agents-check.js","sourceRoot":"","sources":["../src/agents-check.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ export type LintScope = 'core-crate' | 'oxlint' | 'workspace';
2
+ export interface LayerLint {
3
+ readonly layer: string;
4
+ readonly name: string;
5
+ readonly scope: LintScope;
6
+ }
7
+ export declare const sharedOxlintPath = "node_modules/@muxion/dev-config/oxlint.json";
8
+ export declare const parseLayerLints: (layer: string, text: string) => string[];
9
+ export declare const readLayerLints: (directory: string) => Promise<LayerLint[]>;
10
+ export declare const checkLints: (root: string, lints: readonly LayerLint[]) => Promise<string[]>;
11
+ //# sourceMappingURL=agents-lints.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents-lints.d.ts","sourceRoot":"","sources":["../src/agents-lints.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE7D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAC1B;AAED,eAAO,MAAM,gBAAgB,gDAAgD,CAAA;AAoB7E,eAAO,MAAM,eAAe,UAAW,MAAM,QAAQ,MAAM,KAAG,MAAM,EAUnE,CAAA;AAED,eAAO,MAAM,cAAc,cAAqB,MAAM,KAAG,OAAO,CAAC,SAAS,EAAE,CAsB3E,CAAA;AAyED,eAAO,MAAM,UAAU,SAAgB,MAAM,SAAS,SAAS,SAAS,EAAE,KAAG,OAAO,CAAC,MAAM,EAAE,CAiB5F,CAAA"}
@@ -0,0 +1,116 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- The check reads the layer files.
2
+ import { readdir, readFile } from 'node:fs/promises';
3
+ // oxlint-disable-next-line import/no-nodejs-modules -- The check makes repository paths.
4
+ import { join } from 'node:path';
5
+ import { parse } from 'smol-toml';
6
+ import { readPackageDirectories } from './agents-check.js';
7
+ import { readOptional } from './files.js';
8
+ import { field, isRecord } from './json.js';
9
+ export const sharedOxlintPath = 'node_modules/@muxion/dev-config/oxlint.json';
10
+ const oxlintPlugins = ['eslint', 'import', 'node', 'oxc', 'typescript', 'unicorn'];
11
+ const layerScopes = new Map([
12
+ ['rust-core.md', 'core-crate'],
13
+ ['rust-ffi.md', 'workspace'],
14
+ ['rust.md', 'workspace'],
15
+ ['ts-js.md', 'oxlint'],
16
+ ['ts-node.md', 'oxlint'],
17
+ ['ts-web.md', 'oxlint'],
18
+ ['typescript.md', 'oxlint'],
19
+ ]);
20
+ const isLintSpan = (span) => span.startsWith('clippy::') || oxlintPlugins.some((plugin) => span.startsWith(`${plugin}/`));
21
+ const isValidLintName = (span) => /^clippy::[a-z0-9_]+$/u.test(span) || /^[a-z]+\/[a-z0-9-]+$/u.test(span);
22
+ export const parseLayerLints = (layer, text) => {
23
+ const spans = [...text.matchAll(/`(?<span>[^`\n]+)`/gu)].map((match) => match.groups?.['span'] ?? '');
24
+ const lints = spans.filter((span) => isLintSpan(span));
25
+ const invalid = lints.find((span) => !isValidLintName(span));
26
+ if (invalid !== undefined) {
27
+ throw new Error(`${layer}: ${invalid} is not a valid lint name.`);
28
+ }
29
+ return lints;
30
+ };
31
+ export const readLayerLints = async (directory) => {
32
+ const entries = await readdir(directory);
33
+ // oxlint-disable-next-line unicorn/no-array-sort -- sort() on a fresh array is safe; toSorted() is not in the configured lib
34
+ const names = entries.filter((name) => name.endsWith('.md')).sort();
35
+ const layers = await Promise.all(names.map(async (layer) => ({
36
+ layer,
37
+ lints: parseLayerLints(layer, await readFile(join(directory, layer), 'utf8')),
38
+ })));
39
+ return layers.flatMap(({ layer, lints }) => {
40
+ if (lints.length === 0) {
41
+ return [];
42
+ }
43
+ const scope = layerScopes.get(layer);
44
+ if (scope === undefined) {
45
+ throw new Error(`${layer} names lints, but muxion-agents lints does not know where to check them. Add the layer to layerScopes in agents-lints.ts.`);
46
+ }
47
+ return lints.map((name) => ({ layer, name, scope }));
48
+ });
49
+ };
50
+ const namesIn = (lints, scope) => [
51
+ ...new Set(lints.filter((lint) => lint.scope === scope).map(({ name }) => name)),
52
+ ];
53
+ const clippyLevel = (entry) => {
54
+ if (isRecord(entry)) {
55
+ return entry['level'];
56
+ }
57
+ return entry;
58
+ };
59
+ const isDenied = (level) => level === 'deny' || level === 'forbid';
60
+ const checkWorkspaceLints = (manifest, names) => {
61
+ const table = field(field(field(manifest, 'workspace'), 'lints'), 'clippy');
62
+ return names
63
+ .map((name) => name.slice('clippy::'.length))
64
+ .filter((lint) => !isDenied(clippyLevel(field(table, lint))))
65
+ .map((lint) => `Cargo.toml: set ${lint} = "deny" in [workspace.lints.clippy].`);
66
+ };
67
+ const deniedAtCrateRoot = (source) => new Set([...source.matchAll(/#!\[(?:deny|forbid)\((?<list>[^\]]*)\)\]/gu)].flatMap((match) => (match.groups?.['list'] ?? '').split(',').map((lint) => lint.trim())));
68
+ const checkCoreCrate = async (root, crate, names) => {
69
+ const path = `packages/${crate}/src/lib.rs`;
70
+ const source = await readOptional(join(root, path));
71
+ if (source === undefined) {
72
+ return [`${path} does not exist. A core crate must have a crate root with the core lints.`];
73
+ }
74
+ const denied = deniedAtCrateRoot(source);
75
+ return names
76
+ .filter((name) => !denied.has(name))
77
+ .map((name) => `${path}: add ${name} to a crate-root #![deny(...)] attribute.`);
78
+ };
79
+ const oxlintLevel = (entry) => {
80
+ if (Array.isArray(entry)) {
81
+ return entry[0];
82
+ }
83
+ return entry;
84
+ };
85
+ const isError = (level) => level === 'error' || level === 'deny' || level === 2;
86
+ const checkOxlintRules = async (root, names) => {
87
+ if (names.length === 0) {
88
+ return [];
89
+ }
90
+ const text = await readOptional(join(root, sharedOxlintPath));
91
+ if (text === undefined) {
92
+ return [`${sharedOxlintPath} does not exist. Run npm install.`];
93
+ }
94
+ const config = JSON.parse(text);
95
+ const rules = field(config, 'rules');
96
+ return names
97
+ .filter((name) => !isError(oxlintLevel(field(rules, name))))
98
+ .map((name) => `${sharedOxlintPath}: set "${name}": "error" in rules. Change it in @muxion/dev-config.`);
99
+ };
100
+ export const checkLints = async (root, lints) => {
101
+ const oxlintErrors = await checkOxlintRules(root, namesIn(lints, 'oxlint'));
102
+ const cargo = await readOptional(join(root, 'Cargo.toml'));
103
+ if (cargo === undefined) {
104
+ return oxlintErrors;
105
+ }
106
+ const directories = await readPackageDirectories(root);
107
+ const crates = directories.filter((name) => name.endsWith('core-rust'));
108
+ const coreNames = namesIn(lints, 'core-crate');
109
+ const coreErrors = await Promise.all(crates.map((crate) => checkCoreCrate(root, crate, coreNames)));
110
+ return [
111
+ ...oxlintErrors,
112
+ ...checkWorkspaceLints(parse(cargo), namesIn(lints, 'workspace')),
113
+ ...coreErrors.flat(),
114
+ ];
115
+ };
116
+ //# sourceMappingURL=agents-lints.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents-lints.js","sourceRoot":"","sources":["../src/agents-lints.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export declare const settingsPath = ".claude/settings.json";
2
+ export declare const requiredPermissions: {
3
+ readonly ask: readonly ['Bash(npm deprecate:*)', 'Bash(npm run publish:*)', 'Bash(npm run publish:all:*)'];
4
+ readonly deny: readonly ['Bash(npm publish:*)', 'Bash(yarn:*)'];
5
+ };
6
+ export declare const checkSettings: (root: string) => Promise<string[]>;
7
+ //# sourceMappingURL=agents-settings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents-settings.d.ts","sourceRoot":"","sources":["../src/agents-settings.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY,0BAA0B,CAAA;AAEnD,eAAO,MAAM,mBAAmB;aAC9B,GAAG,YAAG,uBAAuB,EAAE,yBAAyB,EAAE,6BAA6B;aACvF,IAAI,YAAG,qBAAqB,EAAE,cAAc;CACpC,CAAA;AAmBV,eAAO,MAAM,aAAa,SAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAkBlE,CAAA"}
@@ -0,0 +1,44 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- The check makes repository paths.
2
+ import { join } from 'node:path';
3
+ import { readOptional } from './files.js';
4
+ import { field } from './json.js';
5
+ export const settingsPath = '.claude/settings.json';
6
+ export const requiredPermissions = {
7
+ ask: ['Bash(npm deprecate:*)', 'Bash(npm run publish:*)', 'Bash(npm run publish:all:*)'],
8
+ deny: ['Bash(npm publish:*)', 'Bash(yarn:*)'],
9
+ };
10
+ const permissionLists = ['deny', 'ask'];
11
+ const stringList = (value) => {
12
+ if (!Array.isArray(value)) {
13
+ return [];
14
+ }
15
+ return value.filter((item) => typeof item === 'string');
16
+ };
17
+ const parseJson = (text) => {
18
+ try {
19
+ return { valid: true, value: JSON.parse(text) };
20
+ }
21
+ catch {
22
+ return { valid: false, value: undefined };
23
+ }
24
+ };
25
+ export const checkSettings = async (root) => {
26
+ const text = await readOptional(join(root, settingsPath));
27
+ if (text === undefined) {
28
+ return [
29
+ `${settingsPath} does not exist. Add it with the permissions that @muxion/dev-config requires.`,
30
+ ];
31
+ }
32
+ const settings = parseJson(text);
33
+ if (!settings.valid) {
34
+ return [`${settingsPath} is not valid JSON.`];
35
+ }
36
+ const permissions = field(settings.value, 'permissions');
37
+ return permissionLists.flatMap((list) => {
38
+ const present = stringList(field(permissions, list));
39
+ return requiredPermissions[list]
40
+ .filter((entry) => !present.includes(entry))
41
+ .map((entry) => `${settingsPath}: add "${entry}" to permissions.${list}.`);
42
+ });
43
+ };
44
+ //# sourceMappingURL=agents-settings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents-settings.js","sourceRoot":"","sources":["../src/agents-settings.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAA;AAEnD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,CAAC,uBAAuB,EAAE,yBAAyB,EAAE,6BAA6B,CAAC;IACxF,IAAI,EAAE,CAAC,qBAAqB,EAAE,cAAc,CAAC;CACrC,CAAA;AAEV,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,KAAK,CAAU,CAAA;AAEhD,MAAM,UAAU,GAAG,CAAC,KAAc,EAAY,EAAE;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAA;AACzE,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAAC,IAAY,EAAwD,EAAE;IACvF,IAAI,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;IAC3C,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,IAAY,EAAqB,EAAE;IACrE,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAA;IACzD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;YACL,GAAG,YAAY,gFAAgF;SAChG,CAAA;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,YAAY,qBAAqB,CAAC,CAAA;IAC/C,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;IACxD,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAA;QACpD,OAAO,mBAAmB,CAAC,IAAI,CAAC;aAC7B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aAC3C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,YAAY,UAAU,KAAK,oBAAoB,IAAI,GAAG,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}
package/dist/agents.js CHANGED
@@ -1,13 +1,31 @@
1
1
  #!/usr/bin/env node
2
+ // oxlint-disable-next-line import/no-nodejs-modules -- The entry point finds the shipped layer files.
3
+ import { fileURLToPath } from 'node:url';
2
4
  // oxlint-disable-next-line import/no-nodejs-modules -- The entry point reads the command arguments.
3
5
  import { parseArgs } from 'node:util';
4
6
  import { checkRepository } from './agents-check.js';
7
+ import { checkLints, readLayerLints } from './agents-lints.js';
8
+ const usage = 'Usage: muxion-agents check | muxion-agents lints';
9
+ const layersDirectory = fileURLToPath(new URL('../agents/', import.meta.url));
10
+ const run = async (command) => {
11
+ switch (command) {
12
+ case 'check': {
13
+ return checkRepository(process.cwd());
14
+ }
15
+ case 'lints': {
16
+ return checkLints(process.cwd(), await readLayerLints(layersDirectory));
17
+ }
18
+ default: {
19
+ throw new Error(usage);
20
+ }
21
+ }
22
+ };
5
23
  try {
6
24
  const { positionals } = parseArgs({ allowPositionals: true, options: {} });
7
- if (positionals.length !== 1 || positionals[0] !== 'check') {
8
- throw new Error('Usage: muxion-agents check');
25
+ if (positionals.length !== 1) {
26
+ throw new Error(usage);
9
27
  }
10
- const errors = await checkRepository(process.cwd());
28
+ const errors = await run(positionals[0]);
11
29
  for (const error of errors) {
12
30
  console.error(`error: ${error}`);
13
31
  }
@@ -1 +1 @@
1
- {"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":";AACA,oGAAoG;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,IAAI,CAAC;IACH,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC/C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC,CAAA;IAClC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,CAAC;QAAA,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAA;IAClC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC"}
1
+ {"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":";AACA,sGAAsG;AACtG,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,oGAAoG;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAE9D,MAAM,KAAK,GAAG,kDAAkD,CAAA;AAChE,MAAM,eAAe,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAE7E,MAAM,GAAG,GAAG,KAAK,EAAE,OAAe,EAAqB,EAAE;IACvD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO,EAAE,CAAC;YACb,OAAO,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACvC,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;YACb,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,cAAc,CAAC,eAAe,CAAC,CAAC,CAAA;QACzE,CAAC;QACD,SAAS,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED,IAAI,CAAC;IACH,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAA;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC,CAAA;IAClC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,CAAC;QAAA,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAA;IAClC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC"}
@@ -0,0 +1,4 @@
1
+ export declare const isNotFound: (error: unknown) => boolean;
2
+ export declare const exists: (path: string) => Promise<boolean>;
3
+ export declare const readOptional: (path: string) => Promise<string | undefined>;
4
+ //# sourceMappingURL=files.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,OAC0B,CAAA;AAEtE,eAAO,MAAM,MAAM,SAAgB,MAAM,KAAG,OAAO,CAAC,OAAO,CAU1D,CAAA;AAED,eAAO,MAAM,YAAY,SAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAS3E,CAAA"}
package/dist/files.js ADDED
@@ -0,0 +1,27 @@
1
+ // oxlint-disable-next-line import/no-nodejs-modules -- The checks read repository files.
2
+ import { readFile, stat } from 'node:fs/promises';
3
+ export const isNotFound = (error) => error instanceof Error && 'code' in error && error.code === 'ENOENT';
4
+ export const exists = async (path) => {
5
+ try {
6
+ await stat(path);
7
+ return true;
8
+ }
9
+ catch (error) {
10
+ if (isNotFound(error)) {
11
+ return false;
12
+ }
13
+ throw error;
14
+ }
15
+ };
16
+ export const readOptional = async (path) => {
17
+ try {
18
+ return await readFile(path, 'utf8');
19
+ }
20
+ catch (error) {
21
+ if (isNotFound(error)) {
22
+ return undefined;
23
+ }
24
+ throw error;
25
+ }
26
+ };
27
+ //# sourceMappingURL=files.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAW,EAAE,CACpD,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAA;AAEtE,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IAC7D,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAA;QACd,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,IAAY,EAA+B,EAAE;IAC9E,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA"}
package/dist/json.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
2
+ export declare const field: (value: unknown, key: string) => unknown;
3
+ //# sourceMappingURL=json.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACH,CAAA;AAEtE,eAAO,MAAM,KAAK,UAAW,OAAO,OAAO,MAAM,KAAG,OAKnD,CAAA"}
package/dist/json.js ADDED
@@ -0,0 +1,8 @@
1
+ export const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
2
+ export const field = (value, key) => {
3
+ if (isRecord(value)) {
4
+ return value[key];
5
+ }
6
+ return undefined;
7
+ };
8
+ //# sourceMappingURL=json.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAC3E,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAEtE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,GAAW,EAAW,EAAE;IAC5D,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@muxion/dev-config",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -15,6 +15,7 @@
15
15
  "dist",
16
16
  "oxfmt.js",
17
17
  "oxlint.json",
18
+ "skills",
18
19
  "tsconfig"
19
20
  ],
20
21
  "type": "module",
@@ -38,6 +39,9 @@
38
39
  "test": "vitest run",
39
40
  "lint": "oxlint src test --tsconfig tsconfig.test.json --deny-warnings && tsc -p tsconfig.test.json"
40
41
  },
42
+ "dependencies": {
43
+ "smol-toml": "^1.9.0"
44
+ },
41
45
  "devDependencies": {
42
46
  "@types/node": "*",
43
47
  "oxlint": "*",
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: muxion-release
3
+ description: Use when you publish, release, or increase the version of a Muxion package, or when a task needs npm publish, npm deprecate, or publish:all.
4
+ ---
5
+
6
+ # Muxion Release
7
+
8
+ Use this procedure to publish packages from a Muxion repository. Do not run `npm publish` directly. The Claude Code settings refuse it.
9
+
10
+ 1. In the child repository, run `npm run verify`. If it fails, stop and fix the cause.
11
+ 2. Run `npm run publish -- --dry-run`. Read which packages it reports as changed.
12
+ 3. Increase the version of each changed package:
13
+ - Increase the patch version for a compatible change.
14
+ - Increase the minor version for a breaking change in a `0.x` version.
15
+ - Change the exact versions in the dependent packages of the same repository. Then run `npm install` to update `package-lock.json`.
16
+ 4. Run `npm run verify` again. Commit the version change.
17
+ 5. Ask the user before the real publish. Then run `npm run publish` in the child repository. To publish all child repositories in dependency order, run `npm run publish:all` in `muxion-all`.
18
+ 6. Ask the user before you run `npm deprecate`. Give the old package name and its replacement.