azcodr 2.3.0 ā 2.5.1
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/.agents/hooks.json +15 -0
- package/.agents/hooks.json.example +15 -0
- package/.agents/lib/agent-guard-command.js +103 -0
- package/.agents/lib/agent-guard-file.js +77 -0
- package/.agents/lib/agent-guard-tdd.js +77 -0
- package/.agents/lib/agent-guard.js +80 -0
- package/.agents/scripts/agent_guard.js +35 -3
- package/.agents/skills/clean-code-refactor/SKILL.md +1 -0
- package/.agents/skills/lets-build/SKILL.md +3 -2
- package/.agents/skills/lets-build/scripts/bootstrap_workspace.sh +159 -0
- package/.agents/skills/relentless-questioner/SKILL.md +1 -1
- package/.github/workflows/ci.yml +13 -0
- package/.github/workflows/publish.yml +7 -0
- package/AGENTS.md +3 -3
- package/CODE_OF_CONDUCT.md +122 -0
- package/CONTRIBUTING.md +16 -4
- package/README.md +77 -4
- package/docs/generated-enforcement-analysis.md +141 -0
- package/docs/rules/clean_code.md +3 -2
- package/docs/rules/test_driven_development.md +8 -5
- package/lib/cli-boundaries.d.ts +18 -0
- package/lib/cli-boundaries.d.ts.map +1 -0
- package/lib/cli-boundaries.js +46 -0
- package/lib/cli-boundaries.js.map +1 -0
- package/lib/cli-parse.d.ts +2 -1
- package/lib/cli-parse.d.ts.map +1 -1
- package/lib/cli-parse.js +15 -3
- package/lib/cli-parse.js.map +1 -1
- package/lib/cli.d.ts +3 -0
- package/lib/cli.d.ts.map +1 -1
- package/lib/cli.js +18 -4
- package/lib/cli.js.map +1 -1
- package/lib/index.d.ts +1 -1
- package/lib/index.js +1 -1
- package/lib/scaffold.js +1 -1
- package/lib/scaffold.js.map +1 -1
- package/memory.md +32 -0
- package/package.json +9 -3
- package/scripts/validate/toolchain.js +60 -0
- package/scripts/validate.js +12 -2
- package/src/cli-boundaries.ts +67 -0
- package/src/cli-parse.ts +19 -5
- package/src/cli.ts +20 -4
- package/src/index.ts +1 -1
- package/src/scaffold.ts +1 -1
package/lib/cli-parse.js
CHANGED
|
@@ -15,6 +15,7 @@ export function emptyOptions() {
|
|
|
15
15
|
};
|
|
16
16
|
}
|
|
17
17
|
export const CHECK_COMMANDS = new Set(['check', 'validate', 'audit']);
|
|
18
|
+
export const BOUNDARY_COMMANDS = new Set(['boundaries', 'boundary', 'cycles']);
|
|
18
19
|
export const BOOLEAN_FLAGS = new Map([
|
|
19
20
|
['-f', 'force'],
|
|
20
21
|
['--force', 'force'],
|
|
@@ -31,6 +32,19 @@ function checkSpecialFlag(arg) {
|
|
|
31
32
|
return 'version';
|
|
32
33
|
return null;
|
|
33
34
|
}
|
|
35
|
+
function checkCommandKeyword(arg, state) {
|
|
36
|
+
if (state.targetDir !== null || state.command !== 'scaffold')
|
|
37
|
+
return false;
|
|
38
|
+
if (CHECK_COMMANDS.has(arg)) {
|
|
39
|
+
state.command = 'check';
|
|
40
|
+
return true;
|
|
41
|
+
}
|
|
42
|
+
if (BOUNDARY_COMMANDS.has(arg)) {
|
|
43
|
+
state.command = 'boundaries';
|
|
44
|
+
return true;
|
|
45
|
+
}
|
|
46
|
+
return false;
|
|
47
|
+
}
|
|
34
48
|
export function applyArg(state, arg) {
|
|
35
49
|
const special = checkSpecialFlag(arg);
|
|
36
50
|
if (special !== null)
|
|
@@ -46,10 +60,8 @@ export function applyArg(state, arg) {
|
|
|
46
60
|
message: `Unknown argument '${arg}'. Run 'npx azcodr --help' for available options.`
|
|
47
61
|
};
|
|
48
62
|
}
|
|
49
|
-
if (
|
|
50
|
-
state.command = 'check';
|
|
63
|
+
if (checkCommandKeyword(arg, state))
|
|
51
64
|
return { terminal: null };
|
|
52
|
-
}
|
|
53
65
|
if (!state.targetDir) {
|
|
54
66
|
state.targetDir = arg;
|
|
55
67
|
return { terminal: null };
|
package/lib/cli-parse.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli-parse.js","sourceRoot":"","sources":["../src/cli-parse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"cli-parse.js","sourceRoot":"","sources":["../src/cli-parse.ts"],"names":[],"mappings":"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"}
|
package/lib/cli.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { ScaffoldOptions, ScaffoldResult } from './scaffold.js';
|
|
2
|
+
import type { CliParsedOptions } from './cli-parse.js';
|
|
2
3
|
import { askQuestion } from './cli-target.js';
|
|
3
4
|
export declare function printHelp(out?: (msg: string) => void): void;
|
|
4
5
|
export declare function printVersion(out?: (msg: string) => void): void;
|
|
@@ -20,6 +21,7 @@ export interface CliIo {
|
|
|
20
21
|
errors: number;
|
|
21
22
|
warnings: number;
|
|
22
23
|
}>;
|
|
24
|
+
boundaries?: (parsed: CliParsedOptions, io: any) => Promise<void | number>;
|
|
23
25
|
}
|
|
24
26
|
export interface NormalizedCliIo {
|
|
25
27
|
out: (msg: string) => void;
|
|
@@ -39,6 +41,7 @@ export interface NormalizedCliIo {
|
|
|
39
41
|
errors: number;
|
|
40
42
|
warnings: number;
|
|
41
43
|
}>;
|
|
44
|
+
boundariesFn: (parsed: CliParsedOptions, io: any) => Promise<void | number>;
|
|
42
45
|
}
|
|
43
46
|
export declare function runCli(rawArgs?: string[], io?: CliIo): Promise<void | number>;
|
|
44
47
|
export declare function main(): Promise<void>;
|
package/lib/cli.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIrE,OAAO,EAAE,WAAW,EAA0C,MAAM,iBAAiB,CAAC;AAatF,wBAAgB,SAAS,CAAC,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAkB,GAAG,IAAI,
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAA0C,MAAM,iBAAiB,CAAC;AAatF,wBAAgB,SAAS,CAAC,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAkB,GAAG,IAAI,CA8BxE;AAED,wBAAgB,YAAY,CAAC,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAkB,GAAG,IAAI,CAE3E;AAED,MAAM,WAAW,KAAK;IACpB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,cAAc,CAAC;IACzD,QAAQ,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,KAAK;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3I,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,cAAc,CAAC;IAC1D,UAAU,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,KAAK;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5I,YAAY,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;CAC7E;AAqJD,wBAAsB,MAAM,CAC1B,OAAO,GAAE,MAAM,EAA0B,EACzC,EAAE,GAAE,KAAU,GACb,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CA2BxB;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAO1C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC;;;;;;;;AAEvB,wBAME"}
|
package/lib/cli.js
CHANGED
|
@@ -4,6 +4,7 @@ import process from 'node:process';
|
|
|
4
4
|
import { fileURLToPath } from 'node:url';
|
|
5
5
|
import { scaffold, getTemplateDir } from './scaffold.js';
|
|
6
6
|
import { validate, createSilentReporter } from './validate.js';
|
|
7
|
+
import { handleBoundariesCommand } from './cli-boundaries.js';
|
|
7
8
|
import { parseArgs } from './cli-parse.js';
|
|
8
9
|
import { askQuestion, resolveTargetDir, ensureWritableTarget } from './cli-target.js';
|
|
9
10
|
const pkg = JSON.parse(fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf-8'));
|
|
@@ -15,10 +16,12 @@ Enterprise Multi-Tenant Architecture & Agentic Engineering Starter Template
|
|
|
15
16
|
Usage:
|
|
16
17
|
npx azcodr [directory] [options]
|
|
17
18
|
npx azcodr check [directory] [options]
|
|
19
|
+
npx azcodr boundaries [directory] [options]
|
|
18
20
|
|
|
19
21
|
Commands:
|
|
20
|
-
[directory]
|
|
21
|
-
check [directory]
|
|
22
|
+
[directory] Scaffold azcodr template into directory (default: current directory)
|
|
23
|
+
check [directory] Validate architecture and governance rules (alias: validate, audit)
|
|
24
|
+
boundaries [directory] Inspect dependency cycles and layer boundaries (alias: boundary, cycles)
|
|
22
25
|
|
|
23
26
|
Options:
|
|
24
27
|
-d, --dry-run Simulate scaffolding without modifying filesystem
|
|
@@ -31,6 +34,7 @@ Options:
|
|
|
31
34
|
Examples:
|
|
32
35
|
npx azcodr my-project
|
|
33
36
|
npx azcodr check
|
|
37
|
+
npx azcodr boundaries ./src
|
|
34
38
|
npx azcodr check ./existing-repo
|
|
35
39
|
npx azcodr . --dry-run
|
|
36
40
|
`);
|
|
@@ -54,7 +58,8 @@ function normalizeIo(io) {
|
|
|
54
58
|
cwd: io.cwd ?? process.cwd(),
|
|
55
59
|
templateDir: io.templateDir ?? getTemplateDir(),
|
|
56
60
|
scaffoldFn: io.scaffold ?? scaffold,
|
|
57
|
-
validateFn: io.validate ?? validate
|
|
61
|
+
validateFn: io.validate ?? validate,
|
|
62
|
+
boundariesFn: io.boundaries ?? handleBoundariesCommand
|
|
58
63
|
};
|
|
59
64
|
}
|
|
60
65
|
function outBanner(fullIo) {
|
|
@@ -77,7 +82,13 @@ async function handleCheckCommand(parsed, fullIo) {
|
|
|
77
82
|
const checkDir = parsed.targetDir ? path.resolve(fullIo.cwd, parsed.targetDir) : fullIo.cwd;
|
|
78
83
|
const reporter = parsed.silent ? createSilentReporter() : undefined;
|
|
79
84
|
const result = await fullIo.validateFn(checkDir, reporter);
|
|
80
|
-
|
|
85
|
+
if (result.errors !== 0)
|
|
86
|
+
return fullIo.exit(1);
|
|
87
|
+
const srcDir = path.join(checkDir, 'src');
|
|
88
|
+
if (fs.existsSync(srcDir)) {
|
|
89
|
+
return fullIo.boundariesFn({ ...parsed, targetDir: srcDir }, fullIo);
|
|
90
|
+
}
|
|
91
|
+
return fullIo.exit(0);
|
|
81
92
|
}
|
|
82
93
|
function reportDryRun(result, out) {
|
|
83
94
|
for (const action of result.actions) {
|
|
@@ -163,6 +174,9 @@ export async function runCli(rawArgs = process.argv.slice(2), io = {}) {
|
|
|
163
174
|
if (parsed.command === 'check') {
|
|
164
175
|
return handleCheckCommand(parsed, fullIo);
|
|
165
176
|
}
|
|
177
|
+
if (parsed.command === 'boundaries') {
|
|
178
|
+
return fullIo.boundariesFn(parsed, fullIo);
|
|
179
|
+
}
|
|
166
180
|
if (!parsed.silent) {
|
|
167
181
|
outBanner(fullIo);
|
|
168
182
|
}
|
package/lib/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAMtF,MAAM,GAAG,GAAqB,IAAI,CAAC,KAAK,CACtC,EAAE,CAAC,YAAY,CACb,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAC7E,OAAO,CACR,CACF,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,MAA6B,OAAO,CAAC,GAAG;IAChE,GAAG,CAAC;UACI,GAAG,CAAC,OAAO
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
package/lib/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @module @azcodr/azcodr
|
|
3
|
-
*
|
|
3
|
+
* Architecture governance toolkit, with an optional starter.
|
|
4
4
|
*
|
|
5
5
|
* Provides problem-first, topology-aligned project scaffolding with strict systemic atomicity,
|
|
6
6
|
* filesystem scope guards, git worktree initialization, and multi-agent harness parity.
|
package/lib/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @module @azcodr/azcodr
|
|
3
|
-
*
|
|
3
|
+
* Architecture governance toolkit, with an optional starter.
|
|
4
4
|
*
|
|
5
5
|
* Provides problem-first, topology-aligned project scaffolding with strict systemic atomicity,
|
|
6
6
|
* filesystem scope guards, git worktree initialization, and multi-agent harness parity.
|
package/lib/scaffold.js
CHANGED
|
@@ -126,7 +126,7 @@ function starterPackageJson(resolvedTarget) {
|
|
|
126
126
|
version: '0.1.0',
|
|
127
127
|
type: 'module',
|
|
128
128
|
private: true,
|
|
129
|
-
description: 'Scaffolded with azcodr
|
|
129
|
+
description: 'Scaffolded with the azcodr architecture governance toolkit',
|
|
130
130
|
scripts: {
|
|
131
131
|
test: 'node --test',
|
|
132
132
|
'test:coverage': 'jest --coverage',
|
package/lib/scaffold.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,WAAW;IACX,WAAW;IACX,WAAW;IACX,MAAM;IACN,SAAS;IACT,SAAS;IACT,SAAS;IACT,YAAY;IACZ,eAAe;IACf,SAAS;CACV,CAAC;AA2CF,SAAS,kBAAkB,CAAC,cAAsB,EAAE,gBAAwB;IAC1E,IAAI,cAAc,KAAK,gBAAgB;QAAE,OAAO;IAChD,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,GAAG,WAAW,CAAC,oBAAoB,KAAK,cAAc,EAAE,CACzD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,cAAsB,EACtB,WAAmB,EACnB,cAAuB;IAEvB,IAAI,cAAc;QAAE,OAAO;IAC3B,IAAI,CAAC,iBAAiB,CAAC,cAAc,EAAE,EAAE,WAAW,EAAE,CAAC;QAAE,OAAO;IAChE,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,GAAG,WAAW,CAAC,qBAAqB,KAAK,cAAc,IAAI;QAC3D,oGAAoG,CACrG,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,cAAsB,EAAE,KAAc;IAClE,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK;QAAE,OAAO;IAC1C,MAAM,IAAI,aAAa,CACrB,oBAAoB,EACpB,GAAG,WAAW,CAAC,kBAAkB,KAAK,OAAO,CAAC,MAAM,iBAAiB,cAAc,KAAK;QACxF,0CAA0C,CAC3C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,UAAiC,EAAE;IACnF,MAAM,EAAE,WAAW,GAAG,cAAc,EAAE,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,cAAc,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1G,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACnD,kBAAkB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACrD,qBAAqB,CAAC,cAAc,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IACD,oBAAoB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,mBAAmB,CAAC,gBAAwB,EAAE,IAAY;IACjE,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;QACtE,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,YAAY,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;QAChE,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,GAAG,aAAa,CAAC;IAC5D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,cAAsB,EAAE,gBAAwB,EAAE,MAAe;IAC1F,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,mBAAmB,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACjD,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACxC,YAAY,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,QAAQ,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,cAAsB,EAAE,MAAe;IAClE,MAAM,KAAK,GAAgC;QACzC,CAAC,WAAW,EAAE,WAAW,CAAC;QAC1B,CAAC,WAAW,EAAE,WAAW,CAAC;QAC1B,CAAC,WAAW,EAAE,WAAW,CAAC;QAC1B,CAAC,cAAc,EAAE,WAAW,CAAC;QAC7B,CAAC,gBAAgB,EAAE,WAAW,CAAC;KAChC,CAAC;IACF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,KAAK,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,YAAY,QAAQ,OAAO,cAAc,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,cAAsB,EAAE,MAAe;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,sBAAsB,CAAC;QACrB,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,yBAAyB;QACnC,cAAc,EAAE,cAAc;QAC9B,MAAM;KACP,CAAC,CAAC;IACH,OAAO,CAAC,0DAA0D,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,kBAAkB,CAAC,cAAsB;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,YAAY,CAAC;IAClE,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,
|
|
1
|
+
{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}
|
package/memory.md
CHANGED
|
@@ -33,6 +33,10 @@
|
|
|
33
33
|
| [ADR-014](./memory.md#adr-014-author-in-typescript-with-tsc-compilation-to-native-esm) | Author in TypeScript with tsc compilation to native ESM | 2026-10-07 | ACCEPTED | [`type_safety.md`](./docs/rules/type_safety.md) |
|
|
34
34
|
| [ADR-015](./memory.md#adr-015-consolidate-testing-on-jest-with-typescript-test-migration) | Consolidate testing on Jest with TypeScript test migration | 2026-10-08 | ACCEPTED | [`test_driven_development.md`](./docs/rules/test_driven_development.md) |
|
|
35
35
|
| [ADR-016](./memory.md#adr-016-standalone-architectural-validator-agent-runtime-hooks-boundary-engine--empirical-benchmark) | Standalone Architectural Validator, Agent Runtime Hooks, Boundary Engine & Empirical Benchmark | 2026-10-08 | ACCEPTED | [`agentic_configuration.md`](./docs/rules/agentic_configuration.md) |
|
|
36
|
+
| [ADR-017](./memory.md#adr-017-continuous-mutation-and-benchmark-ci-gates-oss-governance-and-reference-example) | Continuous Mutation & Benchmark CI Gates, OSS Governance & Reference Example | 2026-10-08 | ACCEPTED | [`devops_ci_cd.md`](./docs/rules/devops_ci_cd.md) |
|
|
37
|
+
| [ADR-018](./memory.md#adr-018-first-class-architectural-boundary-and-cycle-inspection-cli-subcommand) | First-Class Architectural Boundary and Cycle Inspection CLI Subcommand | 2026-10-08 | ACCEPTED | [`clean_code.md`](./docs/rules/clean_code.md) |
|
|
38
|
+
| [ADR-019](./memory.md#adr-019-honest-claims-100-percent-all-metrics-gate-and-benchmark-limits-on-the-record) | Honest claims, 100% all-metrics gate, and benchmark limits on the record | 2026-10-08 | ACCEPTED | [`test_driven_development.md`](./docs/rules/test_driven_development.md) |
|
|
39
|
+
| [ADR-020](./memory.md#adr-020-generated-projects-get-deterministic-enforcement) | Generated projects get deterministic enforcement | 2026-10-08 | ACCEPTED | [`clean_code.md`](./docs/rules/clean_code.md) |
|
|
36
40
|
|
|
37
41
|
---
|
|
38
42
|
|
|
@@ -87,6 +91,34 @@
|
|
|
87
91
|
- **Consequences:** ā
Existing codebases can run `npx azcodr check` without scaffolding. ā
Agent sessions enforce Refactor-Before-Add and RED-before-GREEN TDD at the prompt boundary. ā
Structural circular dependencies and layer breaches are machine-checked with zero third-party dependencies. ā
Empirical drift prevention benchmark is fully specified, reproducible, and automated. ā
100.00% lines, functions, branches, and statements coverage verified across both source and scripts.
|
|
88
92
|
- **Enforced In:** `src/validate.ts`, `src/agent-guard*.ts`, `src/boundaries.ts`, `benchmark/`, `tests/cli-check.test.ts`, `tests/agent-guard.test.ts`, `tests/boundaries.test.ts`, `tests/benchmark.test.ts`
|
|
89
93
|
|
|
94
|
+
#### ADR-017: Continuous Mutation and Benchmark CI Gates, OSS Governance and Reference Example
|
|
95
|
+
- **Date:** 2026-10-08 | **Status:** ACCEPTED
|
|
96
|
+
- **Context:** Following the implementation of the empirical benchmark and native mutation testing harness (ADR-016), three operational gaps were identified: (1) Mutation score (100%) and empirical drift-reduction benchmark assertions ran only as manual workstation commands, risking silent regression during PR merges without automated CI enforcement. (2) Open-source project governance remained incomplete without an explicit Code of Conduct (Contributor Covenant v2.1) beside `SECURITY.md` and `CONTRIBUTING.md`. (3) Prospective adopters lacked a concrete, standalone reference application demonstrating how Azcodr boundary enforcement and Clean Architecture operate in a real downstream project.
|
|
97
|
+
- **Decision:** (1) Automate mutation testing (`npm run test:mutation`) and empirical drift-reduction benchmark execution (`node benchmark/run-benchmark.js`) directly within `.github/workflows/ci.yml` under the Node 24 coverage gate job, ensuring 100% mutant kill score and zero drift are verified on every push and PR. Relocate `mutation-test.js` to `benchmark/mutation-test.js` to keep `scripts/` dedicated solely to template validation. (2) Adopt the Contributor Covenant Code of Conduct v2.1 in `CODE_OF_CONDUCT.md`, reference it in `CONTRIBUTING.md`, and include it in `package.json` package files. (3) Author a standalone, zero-dependency reference implementation in `examples/clean-architecture-todo/` adhering strictly to Clean/Hexagonal Architecture (domain entity invariants, ports, use cases, and in-memory adapter), backed by regression test `tests/example-project.test.ts`. (4) Add official shields.io badges in `README.md` reflecting live npm version, JSR scope, CI passing status, 100% test coverage, 100% mutation score, and 0 dependencies.
|
|
98
|
+
- **Consequences:** ā
Every PR and push automatically verifies 100% mutation resistance and benchmark assertions. ā
Full open-source governance compliance achieved (`SECURITY.md`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`). ā
Concrete, working reference example proves downstream architectural boundaries and Clean Code limits. ā
100.00% lines, functions, statements, and branches coverage maintained across all 40 test suites and 489 tests.
|
|
99
|
+
- **Enforced In:** `.github/workflows/ci.yml`, `benchmark/mutation-test.js`, `CODE_OF_CONDUCT.md`, `examples/clean-architecture-todo/`, `tests/example-project.test.ts`, `README.md`, `package.json`
|
|
100
|
+
|
|
101
|
+
#### ADR-020: Generated Projects Get Deterministic Enforcement
|
|
102
|
+
- **Date:** 2026-10-08 | **Status:** ACCEPTED
|
|
103
|
+
- **Context:** The generated-enforcement analysis (`docs/generated-enforcement-analysis.md`) proved three defects by execution: (1) zero deterministic linter configs in any generated project (starter `lint` is an echo placeholder), (2) LANGUAGE recorded but never generative, (3) the shipped `agent_guard.js` crashed on its missing `../../lib` engine and its catch-all `exit(0)` silently allowed everything ā including `rm -rf /` ā in scaffolded projects.
|
|
104
|
+
- **Decision:** (1) Vendor the closed guard-engine set (`agent-guard{,-command,-file,-tdd}.js`) into `.agents/lib/` (byte-locked to `lib/` output by test; re-copy after every build per `CONTRIBUTING.md`); the hook resolves vendored-first, repo-layout second, `AZCODR_GUARD_ENGINE` override first. (2) Fail CLOSED (exit 2, naming every path tried) only when the engine itself cannot load ā a broken install, not an ambiguous input; unparseable tool payloads still fail open inside `inspectPreTool` per ADR-005. (3) `bootstrap_workspace.sh` emits the pinned per-language gate config (11 profiles; `generic` emits none; create-if-absent so re-runs never clobber); build manifests stay agent-authored (naming decisions), and the agent installs the tool plus proves the gate with a live block in Phase 5. (4) `hooks.json` (+`.example`) wires an `architectural-guard` PreToolUse entry, disabled by default like all hooks ā auto-enabling Stop/lint hooks in a dependency-less fresh scaffold would brick agent loops. (5) New validator phase 7 checks gate-config presence from `.azcodr/workspace-profile.env`, skipping cleanly without a profile (this repo unaffected). (6) Benchmark Arm D (`runArmD` + `auditScaffoldEnforcement`) scores a real scaffold before/after bootstrap; agent-layer state (tool installed, lint wired, hooks on) is reported, never gating.
|
|
105
|
+
- **Consequences:** ā
Same `rm -rf /` payload now BLOCKED from vendored layout; missing engine exits 2 instead of allowing. ā
Every recorded language produces its gate config; `validate` fails when one is deleted. ā
100% coverage holds on the new `scripts/validate/toolchain.js`. ā ļø Hooks still require harness opt-in; tool installation still requires network at agent time ā both recorded openly in `benchmark/RESULTS.md` §5ā8.
|
|
106
|
+
- **Enforced In:** `.agents/lib/`, `.agents/scripts/agent_guard.js`, `.agents/hooks.json`, `.agents/skills/lets-build/scripts/bootstrap_workspace.sh`, `scripts/validate/toolchain.js`, `benchmark/evaluate.js`, `benchmark/run-benchmark.js`, `tests/agent-guard.test.ts`, `tests/bootstrap-toolchain.test.ts`, `tests/validate-toolchain.test.ts`, `tests/benchmark.test.ts`
|
|
107
|
+
|
|
108
|
+
#### ADR-019: Honest Claims, 100% All-Metrics Gate, and Benchmark Limits on the Record
|
|
109
|
+
- **Date:** 2026-10-08 | **Status:** ACCEPTED
|
|
110
|
+
- **Context:** An outside consolidated review found the engineering real but several claims ahead of evidence: "Enterprise starter" positioning vs a governance toolkit, coverage badges without a linked report, and a benchmark that proved drift reduction on synthetic fixtures while reading as a live-agent trial. Separately, the Jest gate enforced 100% lines but only 97% functions / 98% branches even though actual coverage measured 100/100/100/100.
|
|
111
|
+
- **Decision:** (1) Reposition wording to "Architecture governance toolkit, with an optional starter" (`package.json`, `jsr.json`, `AGENTS.md`, `README.md`, `src/index.ts`). (2) Raise the Jest gate to 100% lines, functions, branches, AND statements, locked by `tests/coverage-config.test.ts`; badges link to the CI workflow and the `coverage-report` artifact; docs keep the 100% bar AND the mutation floor plus assertion-density rejection so the number cannot be gamed with assertion-free tests. (3) Harden the benchmark honestly instead of inflating it: `evaluate.js` adds a test-quality proxy and marks cost metrics as manual-only, `run-benchmark.js` writes timestamped JSON transcripts to `benchmark/results/` and prints limitations, `RESULTS.md` gains "Where Azcodr Loses" and "Threats to validity" sections.
|
|
112
|
+
- **Consequences:** ā
Claims match evidence; the gate is stricter than reality required (no new tests needed ā 503 already pass at 100%). ā
Every benchmark citation now ships with a transcript and a limits section. ā ļø Synthetic single-run limits remain (no multi-model variance, no token/review-minute measurement) ā recorded openly rather than fixed.
|
|
113
|
+
- **Enforced In:** `jest.config.js`, `tests/coverage-config.test.ts`, `benchmark/evaluate.js`, `benchmark/run-benchmark.js`, `benchmark/RESULTS.md`, `README.md`, `CONTRIBUTING.md`, `docs/rules/test_driven_development.md`
|
|
114
|
+
|
|
115
|
+
#### ADR-018: First-Class Architectural Boundary and Cycle Inspection CLI Subcommand
|
|
116
|
+
- **Date:** 2026-10-08 | **Status:** ACCEPTED
|
|
117
|
+
- **Context:** Following the implementation of the zero-dependency boundary and cycle engine (`src/boundaries.ts`, ADR-016), inspecting dependency cycles and Clean Architecture layer breaches required either running the empirical benchmark or importing the internal TypeScript engine programmatically. Users and CI pipelines lacked a direct, dedicated CLI entry point (`npx azcodr boundaries [dir]`) to run boundary and circular dependency inspections as a standalone architectural linter.
|
|
118
|
+
- **Decision:** (1) Integrate a dedicated `boundaries` subcommand (with aliases `boundary`, `cycles`) into `src/cli-parse.ts` and `src/cli.ts`. (2) Implement `src/cli-boundaries.ts` to inspect target directories, format colorized/iconographic violation reports, handle silent execution (`--silent`), and resolve target paths (defaulting to `./src` if present, with fallback to current working directory). (3) Author Outside-In TDD test suite `tests/cli-boundaries.test.ts` covering parse argument recognition, target resolution, cycle detection, breach reporting, silent mode, and child-process execution. (4) Maintain Clean Code limits (all files ⤠300 lines, functions ⤠30 lines, complexity ⤠10) and 100.00% full-spectrum statement, branch, function, and line coverage across all 41 test suites.
|
|
119
|
+
- **Consequences:** ā
Developers and CI workflows can run `npx azcodr boundaries [dir]` or `npx azcodr cycles [dir]` directly without third-party lint dependencies. ā
Fast, zero-dependency static analysis catches circular imports and Hexagonal layer breaches. ā
100.00% lines, functions, statements, and branches coverage preserved across 41 test suites and 501 tests.
|
|
120
|
+
- **Enforced In:** `src/cli-boundaries.ts`, `src/cli-parse.ts`, `src/cli.ts`, `tests/cli-boundaries.test.ts`, `README.md`
|
|
121
|
+
|
|
90
122
|
#### ADR-011: The Bash Scaffolder Refuses Protected Targets
|
|
91
123
|
- **Date:** 2026-10-07 | **Status:** ACCEPTED
|
|
92
124
|
- **Context:** ADR-010 closed the protected-target hole for the Node scaffolder (`lib/scaffold.js`), but the same hole existed in `.agents/skills/lets-build/scripts/bootstrap_workspace.sh`, which runs with no guard at all: invoked with `/` or `~` as the workspace root it would create `src/`, `tests/`, `deploy/`, `specs/` trees there. Its blast radius is smaller than the Node scaffolder's (every file write is create-only ā `tokens.json` and `smoke_test.sh` are written only if absent, and `memory.md` is append-only since ADR-009 ā except the explicit `AZCODR_RESET_MEMORY=1` reset), so this is pollution rather than destruction. Pollution of `/` or `~` is still unacceptable for a script agents run autonomously.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "azcodr",
|
|
3
|
-
"version": "2.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "2.5.1",
|
|
4
|
+
"description": "Architecture governance toolkit with topology-scoped scaffolding for AI-assisted development (early release)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"azcodr": "bin/azcodr.js"
|
|
@@ -31,7 +31,8 @@
|
|
|
31
31
|
".editorconfig",
|
|
32
32
|
"LICENSE",
|
|
33
33
|
"SECURITY.md",
|
|
34
|
-
"CONTRIBUTING.md"
|
|
34
|
+
"CONTRIBUTING.md",
|
|
35
|
+
"CODE_OF_CONDUCT.md"
|
|
35
36
|
],
|
|
36
37
|
"keywords": [
|
|
37
38
|
"starter-template",
|
|
@@ -63,6 +64,7 @@
|
|
|
63
64
|
"lint": "eslint .",
|
|
64
65
|
"typecheck": "tsc --noEmit",
|
|
65
66
|
"validate": "node scripts/validate-cli.js",
|
|
67
|
+
"test:mutation": "node benchmark/mutation-test.js",
|
|
66
68
|
"prepublishOnly": "npm run build && npm run lint && npm run test:coverage && npm run validate"
|
|
67
69
|
},
|
|
68
70
|
"devDependencies": {
|
|
@@ -72,5 +74,9 @@
|
|
|
72
74
|
"jest": "29.7.0",
|
|
73
75
|
"ts-jest": "29.2.6",
|
|
74
76
|
"typescript": "5.7.3"
|
|
77
|
+
},
|
|
78
|
+
"overrides": {
|
|
79
|
+
"braces": "3.0.3",
|
|
80
|
+
"sprintf-js": "1.1.3"
|
|
75
81
|
}
|
|
76
82
|
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
|
|
4
|
+
export const TOOLCHAIN_FILES = {
|
|
5
|
+
typescript: ['eslint.config.js'],
|
|
6
|
+
javascript: ['eslint.config.js'],
|
|
7
|
+
deno: ['eslint.config.js'],
|
|
8
|
+
bun: ['eslint.config.js'],
|
|
9
|
+
python: ['ruff.toml'],
|
|
10
|
+
rust: ['clippy.toml'],
|
|
11
|
+
go: ['.golangci.yml'],
|
|
12
|
+
java: ['checkstyle.xml'],
|
|
13
|
+
csharp: ['.editorconfig'],
|
|
14
|
+
cpp: ['.clang-tidy'],
|
|
15
|
+
c: ['.clang-tidy'],
|
|
16
|
+
generic: []
|
|
17
|
+
};
|
|
18
|
+
|
|
19
|
+
export function readProfileLanguage(workspaceRoot) {
|
|
20
|
+
const profile = path.join(workspaceRoot, '.azcodr', 'workspace-profile.env');
|
|
21
|
+
if (!fs.existsSync(profile)) return null;
|
|
22
|
+
const match = /^language=(.+)$/m.exec(fs.readFileSync(profile, 'utf-8'));
|
|
23
|
+
return match ? match[1].trim() : null;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export function expectedToolchainFiles(language) {
|
|
27
|
+
if (!language) return [];
|
|
28
|
+
return TOOLCHAIN_FILES[language] || [];
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function reportMissing(ctx, language, expected) {
|
|
32
|
+
let missing = 0;
|
|
33
|
+
for (const name of expected) {
|
|
34
|
+
if (!fs.existsSync(path.join(ctx.workspaceRoot, name))) {
|
|
35
|
+
ctx.fail(`Missing toolchain gate '${name}' for language '${language}'; re-run bootstrap or restore the config.`);
|
|
36
|
+
missing += 1;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
return missing;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export function phaseToolchain(ctx) {
|
|
43
|
+
ctx.log('');
|
|
44
|
+
ctx.heading('7. Checking Toolchain Enforcement...');
|
|
45
|
+
const language = readProfileLanguage(ctx.workspaceRoot);
|
|
46
|
+
if (language === null) {
|
|
47
|
+
ctx.pass('No workspace profile; toolchain check skipped.');
|
|
48
|
+
return;
|
|
49
|
+
}
|
|
50
|
+
const expected = expectedToolchainFiles(language);
|
|
51
|
+
if (expected.length === 0) {
|
|
52
|
+
ctx.pass(`Language '${language}' declares no toolchain configs; nothing to enforce.`);
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
if (reportMissing(ctx, language, expected) === 0) {
|
|
56
|
+
ctx.pass(`Toolchain gates present for language '${language}' (${expected.join(', ')}).`);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
export default { TOOLCHAIN_FILES, readProfileLanguage, expectedToolchainFiles, phaseToolchain };
|
package/scripts/validate.js
CHANGED
|
@@ -11,6 +11,7 @@ import { phaseRootConfig } from './validate/root.js';
|
|
|
11
11
|
import { phaseRules } from './validate/rules.js';
|
|
12
12
|
import { phaseSkills } from './validate/skills.js';
|
|
13
13
|
import { phaseLinks } from './validate/links.js';
|
|
14
|
+
import { phaseToolchain, readProfileLanguage, expectedToolchainFiles, TOOLCHAIN_FILES } from './validate/toolchain.js';
|
|
14
15
|
|
|
15
16
|
/**
|
|
16
17
|
* NOTE: this module is a library. It never self-executes, so importing it from
|
|
@@ -105,6 +106,7 @@ function runValidation(workspaceRoot, reporter = createReporter()) {
|
|
|
105
106
|
phaseLinks(ctx);
|
|
106
107
|
phaseMemory(ctx);
|
|
107
108
|
phaseLedger(ctx);
|
|
109
|
+
phaseToolchain(ctx);
|
|
108
110
|
reportSummary(counts, reporter);
|
|
109
111
|
return {
|
|
110
112
|
errors: counts.errors,
|
|
@@ -138,7 +140,11 @@ export {
|
|
|
138
140
|
createLowercaseParityLink,
|
|
139
141
|
stripHtmlComments,
|
|
140
142
|
stripFencedCode,
|
|
141
|
-
walkMarkdown
|
|
143
|
+
walkMarkdown,
|
|
144
|
+
phaseToolchain,
|
|
145
|
+
readProfileLanguage,
|
|
146
|
+
expectedToolchainFiles,
|
|
147
|
+
TOOLCHAIN_FILES
|
|
142
148
|
};
|
|
143
149
|
|
|
144
150
|
export default {
|
|
@@ -154,5 +160,9 @@ export default {
|
|
|
154
160
|
createLowercaseParityLink,
|
|
155
161
|
stripHtmlComments,
|
|
156
162
|
stripFencedCode,
|
|
157
|
-
walkMarkdown
|
|
163
|
+
walkMarkdown,
|
|
164
|
+
phaseToolchain,
|
|
165
|
+
readProfileLanguage,
|
|
166
|
+
expectedToolchainFiles,
|
|
167
|
+
TOOLCHAIN_FILES
|
|
158
168
|
};
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import path from 'node:path';
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import { inspectBoundaries } from './boundaries.js';
|
|
4
|
+
import type { BoundaryReport } from './boundaries.js';
|
|
5
|
+
import type { CliParsedOptions } from './cli-parse.js';
|
|
6
|
+
|
|
7
|
+
export interface BoundaryIo {
|
|
8
|
+
out: (msg: string) => void;
|
|
9
|
+
err: (msg: string) => void;
|
|
10
|
+
exit: (code: number) => void | number;
|
|
11
|
+
cwd: string;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export function resolveBoundaryTarget(targetDir: string | null, cwd: string): string {
|
|
15
|
+
if (targetDir) {
|
|
16
|
+
return path.resolve(cwd, targetDir);
|
|
17
|
+
}
|
|
18
|
+
const defaultSrc = path.join(cwd, 'src');
|
|
19
|
+
return fs.existsSync(defaultSrc) ? defaultSrc : cwd;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function printViolations(report: BoundaryReport, out: (msg: string) => void): void {
|
|
23
|
+
const total = report.cycles.length + report.violations.length;
|
|
24
|
+
out(`šØ ARCHITECTURAL VIOLATIONS DETECTED (${total}):`);
|
|
25
|
+
for (const cycle of report.cycles) {
|
|
26
|
+
out(` - Circular Dependency: ${cycle.join(' -> ')}`);
|
|
27
|
+
}
|
|
28
|
+
for (const v of report.violations) {
|
|
29
|
+
out(` - Layer Boundary Breach: ${v.file} illegally imports ${v.importedFile} (${v.fromLayer} -> ${v.toLayer})`);
|
|
30
|
+
}
|
|
31
|
+
out(' Action Required: Invert dependencies via Ports or extract shared modules.\n');
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export function formatBoundaryReport(
|
|
35
|
+
targetDir: string,
|
|
36
|
+
report: BoundaryReport,
|
|
37
|
+
out: (msg: string) => void
|
|
38
|
+
): void {
|
|
39
|
+
out(`\nš Inspecting Architectural Boundaries in: ${targetDir}`);
|
|
40
|
+
out('--------------------------------------------------------------');
|
|
41
|
+
if (report.ok) {
|
|
42
|
+
out(`ā
Analyzed ${report.moduleCount} modules: 0 circular cycles, 0 boundary violations.`);
|
|
43
|
+
out('š SUCCESS: Architecture is clean and drift-free! (0 violations)\n');
|
|
44
|
+
} else {
|
|
45
|
+
printViolations(report, out);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export async function handleBoundariesCommand(
|
|
50
|
+
parsed: CliParsedOptions,
|
|
51
|
+
io: BoundaryIo
|
|
52
|
+
): Promise<void | number> {
|
|
53
|
+
const targetDir = resolveBoundaryTarget(parsed.targetDir, io.cwd);
|
|
54
|
+
const report = inspectBoundaries(targetDir);
|
|
55
|
+
|
|
56
|
+
if (!parsed.silent) {
|
|
57
|
+
formatBoundaryReport(targetDir, report, io.out);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
return io.exit(report.ok ? 0 : 1);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export default {
|
|
64
|
+
resolveBoundaryTarget,
|
|
65
|
+
formatBoundaryReport,
|
|
66
|
+
handleBoundariesCommand
|
|
67
|
+
};
|
package/src/cli-parse.ts
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* raise the complexity of the parser itself.
|
|
6
6
|
*/
|
|
7
7
|
|
|
8
|
-
export type CliCommand = 'scaffold' | 'check';
|
|
8
|
+
export type CliCommand = 'scaffold' | 'check' | 'boundaries';
|
|
9
9
|
|
|
10
10
|
export interface CliParsedOptions {
|
|
11
11
|
command: CliCommand;
|
|
@@ -32,6 +32,7 @@ export function emptyOptions(): Omit<CliParsedOptions, 'terminal' | 'message'> {
|
|
|
32
32
|
}
|
|
33
33
|
|
|
34
34
|
export const CHECK_COMMANDS = new Set(['check', 'validate', 'audit']);
|
|
35
|
+
export const BOUNDARY_COMMANDS = new Set(['boundaries', 'boundary', 'cycles']);
|
|
35
36
|
|
|
36
37
|
export const BOOLEAN_FLAGS = new Map<string, BooleanFlagKey>([
|
|
37
38
|
['-f', 'force'],
|
|
@@ -54,6 +55,22 @@ function checkSpecialFlag(arg: string): 'help' | 'version' | null {
|
|
|
54
55
|
return null;
|
|
55
56
|
}
|
|
56
57
|
|
|
58
|
+
function checkCommandKeyword(
|
|
59
|
+
arg: string,
|
|
60
|
+
state: Omit<CliParsedOptions, 'terminal' | 'message'>
|
|
61
|
+
): boolean {
|
|
62
|
+
if (state.targetDir !== null || state.command !== 'scaffold') return false;
|
|
63
|
+
if (CHECK_COMMANDS.has(arg)) {
|
|
64
|
+
state.command = 'check';
|
|
65
|
+
return true;
|
|
66
|
+
}
|
|
67
|
+
if (BOUNDARY_COMMANDS.has(arg)) {
|
|
68
|
+
state.command = 'boundaries';
|
|
69
|
+
return true;
|
|
70
|
+
}
|
|
71
|
+
return false;
|
|
72
|
+
}
|
|
73
|
+
|
|
57
74
|
export function applyArg(
|
|
58
75
|
state: Omit<CliParsedOptions, 'terminal' | 'message'>,
|
|
59
76
|
arg: string
|
|
@@ -71,10 +88,7 @@ export function applyArg(
|
|
|
71
88
|
message: `Unknown argument '${arg}'. Run 'npx azcodr --help' for available options.`
|
|
72
89
|
};
|
|
73
90
|
}
|
|
74
|
-
if (
|
|
75
|
-
state.command = 'check';
|
|
76
|
-
return { terminal: null };
|
|
77
|
-
}
|
|
91
|
+
if (checkCommandKeyword(arg, state)) return { terminal: null };
|
|
78
92
|
if (!state.targetDir) {
|
|
79
93
|
state.targetDir = arg;
|
|
80
94
|
return { terminal: null };
|