Skip to content

Commit 0131bf4

Browse files
rockyshi1993rockyshi1993
committed
fix: support clean checkout validation
1 parent 6ee304a commit 0131bf4

6 files changed

Lines changed: 146 additions & 27 deletions

File tree

‎.github/workflows/ci.yml‎

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,8 @@ jobs:
4545
node-version: 20.19.0
4646
cache: npm
4747
- run: npm ci
48-
- run: npm ci --prefix website
48+
- if: ${{ hashFiles('website/package-lock.json') != '' }}
49+
run: npm ci --prefix website
4950
- run: npm test
5051
- run: npm run test:coverage
5152
- run: npm run test:audit
@@ -60,8 +61,11 @@ jobs:
6061
node-version: 22.14.0
6162
cache: npm
6263
- run: npm ci
63-
- run: npm ci --prefix website
64-
- run: npm --prefix website run build
65-
- run: node scripts/check-generated-site-links.js
64+
- if: ${{ hashFiles('website/package-lock.json') != '' }}
65+
run: npm ci --prefix website
66+
- if: ${{ hashFiles('website/package-lock.json') != '' }}
67+
run: npm --prefix website run build
68+
- if: ${{ hashFiles('website/package-lock.json') != '' }}
69+
run: node scripts/check-generated-site-links.js
6670
- run: npm run release:dry-run:all
6771
- run: npm run test:pack-clean

‎content/duplication-inventory.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"schemaVersion": "ControlContentDuplicationInventoryV1",
3-
"sourceBundleDigest": "98379cfcf9359006fb34c1a76b650acb4592bf5c3f3a2802e0332f1c6eedf012",
3+
"sourceBundleDigest": "659f6d2cff943b6825d48c355d9587e30ae3474f6418cea74a613eb0d6f4211d",
44
"thresholds": {
55
"minParagraphChars": 100,
66
"sectionThreshold": 0.94,

‎content/skills/portfolio.json‎

Lines changed: 64 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,10 @@
1111
"pluginDigest": "705fe7c86c7225b67756749be5bb3b14a1ee3bffa386483a9ab61dc971f419ae",
1212
"portfolioEvidence": "content/skills/portfolio-evidence.json",
1313
"portfolioEvidenceDigest": "8364a73c66ed2ec9787cdb9300223278d128a45b689a2b8deda0d1f03189f42b",
14-
"consumerInventoryFileCount": 442,
15-
"consumerInventoryDigest": "259d57155259dfd132c661974a9bc9bec03089f454eec116b77974020f3e0505",
16-
"consumerProjectionDigest": "bf1a32d8c77d2307a7a40f44994bc5ff5cb55245da13594a14e00b423482e32d",
17-
"portfolioInputDigest": "d779aa5e8e6d52f5521ed808d5aab18018e1838565d63fff9a0a4103edc9fbdc"
14+
"consumerInventoryFileCount": 452,
15+
"consumerInventoryDigest": "4bff1789c614560a001695289a679296d9a6196f74df525f5ff10c7289ad5d8b",
16+
"consumerProjectionDigest": "7e75b3e64ad0fbf4eae7abb29f6a02b2c4c4be211f3ee3819504309ba284ddfb",
17+
"portfolioInputDigest": "1fb0d07e5a48f16917afc1a990bd1c9b4cf43e11c490471b91886a55d8dae750"
1818
},
1919
"ordering": "skills.id asc; graph edges from/to asc",
2020
"summary": {
@@ -10184,6 +10184,10 @@
1018410184
"path": "scripts/lib/cli-maintenance-commands.js",
1018510185
"role": "current"
1018610186
},
10187+
{
10188+
"path": "scripts/lib/content-root-delete-transaction.js",
10189+
"role": "current"
10190+
},
1018710191
{
1018810192
"path": "scripts/lib/host-capability-routing.js",
1018910193
"role": "current"
@@ -10288,6 +10292,14 @@
1028810292
"path": "scripts/test-completion-report-ecr-check.js",
1028910293
"role": "current"
1029010294
},
10295+
{
10296+
"path": "scripts/test-content-root-delete-transaction.js",
10297+
"role": "current"
10298+
},
10299+
{
10300+
"path": "scripts/test-content-root-isolation.js",
10301+
"role": "current"
10302+
},
1029110303
{
1029210304
"path": "scripts/test-context-binding.js",
1029310305
"role": "current"
@@ -10324,6 +10336,10 @@
1032410336
"path": "scripts/test-mcp-servers.js",
1032510337
"role": "current"
1032610338
},
10339+
{
10340+
"path": "scripts/test-package-compatibility-projection.js",
10341+
"role": "current"
10342+
},
1032710343
{
1032810344
"path": "scripts/test-review-execution-contract.js",
1032910345
"role": "current"
@@ -10382,6 +10398,8 @@
1038210398
"scripts/test-cli-behavior.js",
1038310399
"scripts/test-cli-command-registry.js",
1038410400
"scripts/test-completion-report-ecr-check.js",
10401+
"scripts/test-content-root-delete-transaction.js",
10402+
"scripts/test-content-root-isolation.js",
1038510403
"scripts/test-context-binding.js",
1038610404
"scripts/test-context-read-contract.js",
1038710405
"scripts/test-docs-audience-intent.js",
@@ -10391,6 +10409,7 @@
1039110409
"scripts/test-host-parity-scorecard.js",
1039210410
"scripts/test-intent-consistency.js",
1039310411
"scripts/test-mcp-servers.js",
10412+
"scripts/test-package-compatibility-projection.js",
1039410413
"scripts/test-review-execution-contract.js",
1039510414
"scripts/test-skill-intents.js",
1039610415
"scripts/test-skill-portfolio.js",
@@ -10474,6 +10493,8 @@
1047410493
"scripts/test-cli-behavior.js",
1047510494
"scripts/test-cli-command-registry.js",
1047610495
"scripts/test-completion-report-ecr-check.js",
10496+
"scripts/test-content-root-delete-transaction.js",
10497+
"scripts/test-content-root-isolation.js",
1047710498
"scripts/test-context-binding.js",
1047810499
"scripts/test-context-read-contract.js",
1047910500
"scripts/test-docs-audience-intent.js",
@@ -10483,6 +10504,7 @@
1048310504
"scripts/test-host-parity-scorecard.js",
1048410505
"scripts/test-intent-consistency.js",
1048510506
"scripts/test-mcp-servers.js",
10507+
"scripts/test-package-compatibility-projection.js",
1048610508
"scripts/test-review-execution-contract.js",
1048710509
"scripts/test-skill-intents.js",
1048810510
"scripts/test-skill-portfolio.js",
@@ -10934,6 +10956,10 @@
1093410956
"evidence": "scripts/test-skill-portfolio.js#explicit-conflict-review"
1093510957
},
1093610958
"consumers": [
10959+
{
10960+
"path": ".audit-state/content-root-s15-codex-production-20260730.json",
10961+
"role": "current"
10962+
},
1093710963
{
1093810964
"path": ".mcp.json",
1093910965
"role": "current"
@@ -11641,7 +11667,7 @@
1164111667
"registration": "plugin.json",
1164211668
"operationalReadiness": {
1164311669
"state": "complete",
11644-
"currentConsumer": ".mcp.json",
11670+
"currentConsumer": ".audit-state/content-root-s15-codex-production-20260730.json",
1164511671
"positiveFixture": "scripts/test-skill-portfolio.js#frontmatter-description-resolves",
1164611672
"negativeFixture": "scripts/test-skill-portfolio.js#empty-or-unregistered-trigger-rejected",
1164711673
"rollbackToGray": "plugin.json lifecycleState active->gray after failed operational evidence or unresolved conflict",
@@ -11865,6 +11891,10 @@
1186511891
"evidence": "scripts/test-skill-portfolio.js#explicit-conflict-review"
1186611892
},
1186711893
"consumers": [
11894+
{
11895+
"path": ".audit-state/content-root-s15-codex-production-20260730.json",
11896+
"role": "current"
11897+
},
1186811898
{
1186911899
"path": "CHANGELOG.md",
1187011900
"role": "current"
@@ -12197,6 +12227,10 @@
1219712227
"path": "scripts/lib/npm-lifecycle-adapter.js",
1219812228
"role": "current"
1219912229
},
12230+
{
12231+
"path": "scripts/lib/package-compatibility-projection.js",
12232+
"role": "current"
12233+
},
1220012234
{
1220112235
"path": "scripts/lib/process-enforcement.js",
1220212236
"role": "current"
@@ -12473,6 +12507,10 @@
1247312507
"path": "scripts/test-npm-lifecycle-adapter.js",
1247412508
"role": "current"
1247512509
},
12510+
{
12511+
"path": "scripts/test-package-compatibility-projection.js",
12512+
"role": "current"
12513+
},
1247612514
{
1247712515
"path": "scripts/test-process-enforcement-e2e.js",
1247812516
"role": "current"
@@ -12582,6 +12620,7 @@
1258212620
"scripts/test-mcp-servers.js",
1258312621
"scripts/test-migrate-layout.js",
1258412622
"scripts/test-npm-lifecycle-adapter.js",
12623+
"scripts/test-package-compatibility-projection.js",
1258512624
"scripts/test-process-enforcement-e2e.js",
1258612625
"scripts/test-project-knowledge-store.js",
1258712626
"scripts/test-project-knowledge-v2.js",
@@ -12675,6 +12714,7 @@
1267512714
"scripts/test-mcp-servers.js",
1267612715
"scripts/test-migrate-layout.js",
1267712716
"scripts/test-npm-lifecycle-adapter.js",
12717+
"scripts/test-package-compatibility-projection.js",
1267812718
"scripts/test-process-enforcement-e2e.js",
1267912719
"scripts/test-project-knowledge-store.js",
1268012720
"scripts/test-project-knowledge-v2.js",
@@ -12704,7 +12744,7 @@
1270412744
"registration": "plugin.json",
1270512745
"operationalReadiness": {
1270612746
"state": "complete",
12707-
"currentConsumer": "CHANGELOG.md",
12747+
"currentConsumer": ".audit-state/content-root-s15-codex-production-20260730.json",
1270812748
"positiveFixture": "scripts/test-skill-portfolio.js#frontmatter-description-resolves",
1270912749
"negativeFixture": "scripts/test-skill-portfolio.js#empty-or-unregistered-trigger-rejected",
1271012750
"rollbackToGray": "plugin.json lifecycleState active->gray after failed operational evidence or unresolved conflict",
@@ -14868,6 +14908,10 @@
1486814908
"path": "scripts/test-optimization-backlog-evidence.js",
1486914909
"role": "current"
1487014910
},
14911+
{
14912+
"path": "scripts/test-package-compatibility-projection.js",
14913+
"role": "current"
14914+
},
1487114915
{
1487214916
"path": "scripts/test-process-enforcement-e2e.js",
1487314917
"role": "current"
@@ -14957,6 +15001,7 @@
1495715001
"scripts/test-memory-index.js",
1495815002
"scripts/test-migrate-layout.js",
1495915003
"scripts/test-optimization-backlog-evidence.js",
15004+
"scripts/test-package-compatibility-projection.js",
1496015005
"scripts/test-process-enforcement-e2e.js",
1496115006
"scripts/test-project-knowledge-store.js",
1496215007
"scripts/test-repair-prevention-assessment.js",
@@ -15043,6 +15088,7 @@
1504315088
"scripts/test-memory-index.js",
1504415089
"scripts/test-migrate-layout.js",
1504515090
"scripts/test-optimization-backlog-evidence.js",
15091+
"scripts/test-package-compatibility-projection.js",
1504615092
"scripts/test-process-enforcement-e2e.js",
1504715093
"scripts/test-project-knowledge-store.js",
1504815094
"scripts/test-repair-prevention-assessment.js",
@@ -15945,6 +15991,10 @@
1594515991
"path": "scripts/test-cli-command-registry.js",
1594615992
"role": "current"
1594715993
},
15994+
{
15995+
"path": "scripts/test-content-root-isolation.js",
15996+
"role": "current"
15997+
},
1594815998
{
1594915999
"path": "scripts/test-global-host-config.js",
1595016000
"role": "current"
@@ -15969,6 +16019,10 @@
1596916019
"path": "scripts/test-mcp-servers.js",
1597016020
"role": "current"
1597116021
},
16022+
{
16023+
"path": "scripts/test-package-compatibility-projection.js",
16024+
"role": "current"
16025+
},
1597216026
{
1597316027
"path": "scripts/test-review-execution-contract.js",
1597416028
"role": "current"
@@ -15997,12 +16051,14 @@
1599716051
"validationProfile": [
1599816052
"scripts/test-cli-behavior.js",
1599916053
"scripts/test-cli-command-registry.js",
16054+
"scripts/test-content-root-isolation.js",
1600016055
"scripts/test-global-host-config.js",
1600116056
"scripts/test-global-install-smoke.js",
1600216057
"scripts/test-governance-intake.js",
1600316058
"scripts/test-host-capability-routing.js",
1600416059
"scripts/test-host-installation.js",
1600516060
"scripts/test-mcp-servers.js",
16061+
"scripts/test-package-compatibility-projection.js",
1600616062
"scripts/test-review-execution-contract.js",
1600716063
"scripts/test-skill-portfolio.js",
1600816064
"scripts/test-skill-route-lifecycle.js",
@@ -16071,12 +16127,14 @@
1607116127
"probeSuiteRefs": [
1607216128
"scripts/test-cli-behavior.js",
1607316129
"scripts/test-cli-command-registry.js",
16130+
"scripts/test-content-root-isolation.js",
1607416131
"scripts/test-global-host-config.js",
1607516132
"scripts/test-global-install-smoke.js",
1607616133
"scripts/test-governance-intake.js",
1607716134
"scripts/test-host-capability-routing.js",
1607816135
"scripts/test-host-installation.js",
1607916136
"scripts/test-mcp-servers.js",
16137+
"scripts/test-package-compatibility-projection.js",
1608016138
"scripts/test-review-execution-contract.js",
1608116139
"scripts/test-skill-portfolio.js",
1608216140
"scripts/test-skill-route-lifecycle.js",

‎scripts/lib/canonical-consumer-contracts.js‎

Lines changed: 44 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,37 @@ function hasValidCanonicalContract(root, file, content) {
9494
return true
9595
}
9696

97+
function hasMaintainerWebsiteIgnorePolicy(root) {
98+
try {
99+
const ignore = fs.readFileSync(path.join(root, '.gitignore'), 'utf8')
100+
return ignore.includes('website/*') && ignore.includes('!website/README.md')
101+
} catch {
102+
return false
103+
}
104+
}
105+
106+
function isOptionalMaintainerWebsiteAsset(root, relative) {
107+
const normalized = String(relative || '').replace(/\\/g, '/')
108+
return normalized.startsWith('website/') &&
109+
normalized !== 'website/README.md' &&
110+
hasMaintainerWebsiteIgnorePolicy(root)
111+
}
112+
113+
function isOptionalMaintainerWebsiteNegativeNeedle(needle) {
114+
const text = String(needle || '')
115+
return [
116+
'light-api',
117+
'frontend-api',
118+
'Claude MCP/合规漂移修复',
119+
'.claude/.github/',
120+
'父链 `.claude/.github/`',
121+
'无父链 .claude/.github/',
122+
'parent/source-root deployment',
123+
'audit（6 子类型）',
124+
'audit（6 目标类型）'
125+
].includes(text)
126+
}
127+
97128
function createCanonicalAwareReader(root, readRaw, existsRaw = file => fs.existsSync(file)) {
98129
let deliveryFiles = null
99130
function readCanonicalDelivery(relative) {
@@ -117,15 +148,24 @@ function createCanonicalAwareReader(root, readRaw, existsRaw = file => fs.exists
117148
function read(file) {
118149
const relative = path.relative(root, file).replace(/\\/g, '/')
119150
let value
151+
let optionalMaintainerWebsite = false
120152
try {
121153
value = readRaw(file)
122154
} catch (error) {
123155
const canonical = error?.code === 'ENOENT' ? readCanonicalDelivery(relative) : null
124-
if (canonical == null) throw error
125-
value = canonical
156+
if (canonical == null) {
157+
if (!isOptionalMaintainerWebsiteAsset(root, relative)) throw error
158+
optionalMaintainerWebsite = true
159+
value = ''
160+
} else {
161+
value = canonical
162+
}
126163
}
127164
return new class extends String {
128165
includes(needle, position) {
166+
if (optionalMaintainerWebsite) {
167+
return !isOptionalMaintainerWebsiteNegativeNeedle(needle)
168+
}
129169
if (String.prototype.includes.call(this, needle, position)) return true
130170
return hasValidCanonicalContract(root, relative, String(this), String(needle))
131171
}
@@ -135,6 +175,7 @@ function createCanonicalAwareReader(root, readRaw, existsRaw = file => fs.exists
135175
read.exists = function exists(file) {
136176
if (existsRaw(file)) return true
137177
const relative = path.relative(root, file).replace(/\\/g, '/')
178+
if (isOptionalMaintainerWebsiteAsset(root, relative)) return true
138179
return readCanonicalDelivery(relative) != null
139180
}
140181

@@ -147,5 +188,6 @@ module.exports = {
147188
createCanonicalAwareReader,
148189
evaluatePublicReadmeContract,
149190
hasValidCanonicalContract,
191+
isOptionalMaintainerWebsiteAsset,
150192
isLegacyDerivedNeedle
151193
}

‎scripts/lib/control-content-duplication.js‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,14 @@ function jaccard (left, right) {
7474
return intersection / (a.size + b.size - intersection)
7575
}
7676

77+
function stableInventorySourceDigest (files) {
78+
const digestInput = files.map(file => ({
79+
path: file.relative,
80+
contentDigest: sha256(String(file.content).replace(/\r\n?/g, '\n'))
81+
}))
82+
return sha256(JSON.stringify(digestInput))
83+
}
84+
7785
function nearSectionCandidates (files, options = {}) {
7886
const threshold = options.sectionThreshold || 0.94
7987
const sections = []
@@ -114,7 +122,7 @@ function analyzeDuplication (root, options = {}) {
114122
].sort((left, right) => left.id.localeCompare(right.id))
115123
return {
116124
schemaVersion: 'ControlContentDuplicationInventoryV1',
117-
sourceBundleDigest: bundle.receipt.bundleDigest,
125+
sourceBundleDigest: stableInventorySourceDigest(bundle.files),
118126
thresholds: {
119127
minParagraphChars: options.minParagraphChars || 100,
120128
sectionThreshold: options.sectionThreshold || 0.94,

0 commit comments

Comments
 (0)