pumuki 6.3.13 → 6.3.15
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 +95 -7
- package/VERSION +1 -1
- package/bin/pumuki-mcp-enterprise.js +5 -0
- package/bin/pumuki-pre-write.js +11 -0
- package/docs/API_REFERENCE.md +2 -1
- package/docs/CORE_INTEGRATIONS_UNTESTED_INVENTORY.md +57 -0
- package/docs/INSTALLATION.md +101 -54
- package/docs/MCP_SERVERS.md +167 -74
- package/docs/PUMUKI_FULL_VALIDATION_CHECKLIST.md +46 -45
- package/docs/PUMUKI_OPENSPEC_SDD_ROADMAP.md +55 -0
- package/docs/README.md +9 -0
- package/docs/REFRACTOR_PROGRESS.md +288 -6
- package/docs/USAGE.md +115 -8
- package/docs/validation/README.md +5 -0
- package/docs/validation/mock-consumer-next-cycle-enterprise-checklist.md +68 -0
- package/docs/validation/mock-consumer-next-round-scope.md +222 -0
- package/docs/validation/mock-consumer-post-release-handoff-pack.md +486 -0
- package/docs/validation/phase12-go-no-go-report.md +73 -0
- package/docs/validation/post-phase12-next-lot-decision.md +75 -0
- package/integrations/config/skillsRuleSet.ts +53 -6
- package/integrations/evidence/buildEvidence.ts +42 -3
- package/integrations/evidence/generateEvidence.test.ts +59 -0
- package/integrations/evidence/readEvidence.test.ts +61 -0
- package/integrations/evidence/schema.test.ts +81 -0
- package/integrations/evidence/schema.ts +11 -0
- package/integrations/evidence/writeEvidence.test.ts +18 -0
- package/integrations/evidence/writeEvidence.ts +11 -0
- package/integrations/git/resolveGitRefs.ts +2 -2
- package/integrations/git/runPlatformGate.ts +64 -0
- package/integrations/git/runPlatformGateEvidence.ts +13 -0
- package/integrations/git/stageRunners.ts +10 -1
- package/integrations/lifecycle/artifacts.ts +57 -4
- package/integrations/lifecycle/cli.ts +248 -12
- package/integrations/lifecycle/constants.ts +1 -0
- package/integrations/lifecycle/gitService.ts +1 -0
- package/integrations/lifecycle/install.ts +24 -1
- package/integrations/lifecycle/openSpecBootstrap.ts +190 -0
- package/integrations/lifecycle/state.ts +57 -0
- package/integrations/lifecycle/uninstall.ts +3 -1
- package/integrations/lifecycle/update.ts +11 -0
- package/integrations/mcp/enterpriseServer.cli.ts +12 -0
- package/integrations/mcp/enterpriseServer.ts +762 -0
- package/integrations/mcp/evidenceFacets.ts +5 -2
- package/integrations/mcp/evidenceFacetsBase.ts +3 -94
- package/integrations/mcp/evidenceFacetsFindings.ts +39 -0
- package/integrations/mcp/evidenceFacetsLedger.ts +27 -0
- package/integrations/mcp/evidenceFacetsPlatforms.ts +21 -0
- package/integrations/mcp/evidenceFacetsRulesets.ts +53 -0
- package/integrations/mcp/evidenceFacetsSeverity.ts +62 -0
- package/integrations/mcp/evidenceFacetsSnapshot.ts +4 -104
- package/integrations/mcp/evidencePayloadBuilders.ts +2 -0
- package/integrations/mcp/evidencePayloadContext.ts +5 -0
- package/integrations/mcp/evidencePayloadStatus.ts +100 -0
- package/integrations/mcp/evidencePayloadSummary.ts +0 -81
- package/integrations/mcp/evidencePayloads.ts +2 -8
- package/integrations/mcp/index.ts +1 -0
- package/integrations/sdd/index.ts +11 -0
- package/integrations/sdd/openSpecCli.ts +180 -0
- package/integrations/sdd/policy.ts +190 -0
- package/integrations/sdd/sessionStore.ts +152 -0
- package/integrations/sdd/types.ts +69 -0
- package/package.json +10 -5
- package/scripts/framework-menu-runner-path-lib.ts +10 -3
- package/scripts/framework-menu.ts +86 -5
- package/scripts/package-install-smoke-gate-lib.ts +6 -1
- package/scripts/package-install-smoke-lifecycle-lib.ts +3 -0
|
@@ -6,6 +6,26 @@ export type LifecycleState = {
|
|
|
6
6
|
version?: string;
|
|
7
7
|
hooks?: string;
|
|
8
8
|
installedAt?: string;
|
|
9
|
+
openSpecManagedArtifacts?: string;
|
|
10
|
+
};
|
|
11
|
+
|
|
12
|
+
const parseManagedArtifacts = (raw: string | undefined): string[] => {
|
|
13
|
+
if (typeof raw !== 'string' || raw.trim().length === 0) {
|
|
14
|
+
return [];
|
|
15
|
+
}
|
|
16
|
+
return raw
|
|
17
|
+
.split(',')
|
|
18
|
+
.map((value) => value.trim())
|
|
19
|
+
.filter((value) => value.length > 0);
|
|
20
|
+
};
|
|
21
|
+
|
|
22
|
+
const serializeManagedArtifacts = (artifacts: ReadonlyArray<string>): string | undefined => {
|
|
23
|
+
const unique = Array.from(new Set(artifacts.map((value) => value.trim()).filter((value) => value.length > 0)))
|
|
24
|
+
.sort();
|
|
25
|
+
if (unique.length === 0) {
|
|
26
|
+
return undefined;
|
|
27
|
+
}
|
|
28
|
+
return unique.join(',');
|
|
9
29
|
};
|
|
10
30
|
|
|
11
31
|
export const readLifecycleState = (
|
|
@@ -16,18 +36,54 @@ export const readLifecycleState = (
|
|
|
16
36
|
version: git.getLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.version),
|
|
17
37
|
hooks: git.getLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.hooks),
|
|
18
38
|
installedAt: git.getLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.installedAt),
|
|
39
|
+
openSpecManagedArtifacts: git.getLocalConfig(
|
|
40
|
+
repoRoot,
|
|
41
|
+
PUMUKI_CONFIG_KEYS.openSpecManagedArtifacts
|
|
42
|
+
),
|
|
19
43
|
});
|
|
20
44
|
|
|
21
45
|
export const writeLifecycleState = (params: {
|
|
22
46
|
git: ILifecycleGitService;
|
|
23
47
|
repoRoot: string;
|
|
24
48
|
version: string;
|
|
49
|
+
openSpecManagedArtifacts?: ReadonlyArray<string>;
|
|
25
50
|
}): void => {
|
|
26
51
|
const { git, repoRoot, version } = params;
|
|
27
52
|
git.setLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.installed, 'true');
|
|
28
53
|
git.setLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.version, version);
|
|
29
54
|
git.setLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.hooks, PUMUKI_MANAGED_HOOKS.join(','));
|
|
30
55
|
git.setLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.installedAt, new Date().toISOString());
|
|
56
|
+
if (params.openSpecManagedArtifacts) {
|
|
57
|
+
const serialized = serializeManagedArtifacts(params.openSpecManagedArtifacts);
|
|
58
|
+
if (serialized) {
|
|
59
|
+
git.setLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.openSpecManagedArtifacts, serialized);
|
|
60
|
+
} else {
|
|
61
|
+
git.unsetLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.openSpecManagedArtifacts);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
};
|
|
65
|
+
|
|
66
|
+
export const readOpenSpecManagedArtifacts = (
|
|
67
|
+
git: ILifecycleGitService,
|
|
68
|
+
repoRoot: string
|
|
69
|
+
): ReadonlyArray<string> =>
|
|
70
|
+
parseManagedArtifacts(git.getLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.openSpecManagedArtifacts));
|
|
71
|
+
|
|
72
|
+
export const writeOpenSpecManagedArtifacts = (params: {
|
|
73
|
+
git: ILifecycleGitService;
|
|
74
|
+
repoRoot: string;
|
|
75
|
+
artifacts: ReadonlyArray<string>;
|
|
76
|
+
}): void => {
|
|
77
|
+
const serialized = serializeManagedArtifacts(params.artifacts);
|
|
78
|
+
if (serialized) {
|
|
79
|
+
params.git.setLocalConfig(
|
|
80
|
+
params.repoRoot,
|
|
81
|
+
PUMUKI_CONFIG_KEYS.openSpecManagedArtifacts,
|
|
82
|
+
serialized
|
|
83
|
+
);
|
|
84
|
+
return;
|
|
85
|
+
}
|
|
86
|
+
params.git.unsetLocalConfig(params.repoRoot, PUMUKI_CONFIG_KEYS.openSpecManagedArtifacts);
|
|
31
87
|
};
|
|
32
88
|
|
|
33
89
|
export const clearLifecycleState = (
|
|
@@ -38,4 +94,5 @@ export const clearLifecycleState = (
|
|
|
38
94
|
git.unsetLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.version);
|
|
39
95
|
git.unsetLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.hooks);
|
|
40
96
|
git.unsetLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.installedAt);
|
|
97
|
+
git.unsetLocalConfig(repoRoot, PUMUKI_CONFIG_KEYS.openSpecManagedArtifacts);
|
|
41
98
|
};
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { purgeUntrackedPumukiArtifacts } from './artifacts';
|
|
2
2
|
import { LifecycleGitService, type ILifecycleGitService } from './gitService';
|
|
3
3
|
import { uninstallPumukiHooks } from './hookManager';
|
|
4
|
-
import { clearLifecycleState } from './state';
|
|
4
|
+
import { clearLifecycleState, readOpenSpecManagedArtifacts } from './state';
|
|
5
5
|
|
|
6
6
|
export type LifecycleUninstallResult = {
|
|
7
7
|
repoRoot: string;
|
|
@@ -17,6 +17,7 @@ export const runLifecycleUninstall = (params?: {
|
|
|
17
17
|
const git = params?.git ?? new LifecycleGitService();
|
|
18
18
|
const cwd = params?.cwd ?? process.cwd();
|
|
19
19
|
const repoRoot = git.resolveRepoRoot(cwd);
|
|
20
|
+
const managedOpenSpecArtifacts = readOpenSpecManagedArtifacts(git, repoRoot);
|
|
20
21
|
|
|
21
22
|
const hookResult = uninstallPumukiHooks(repoRoot);
|
|
22
23
|
clearLifecycleState(git, repoRoot);
|
|
@@ -25,6 +26,7 @@ export const runLifecycleUninstall = (params?: {
|
|
|
25
26
|
? purgeUntrackedPumukiArtifacts({
|
|
26
27
|
git,
|
|
27
28
|
repoRoot,
|
|
29
|
+
managedOpenSpecArtifacts,
|
|
28
30
|
})
|
|
29
31
|
: [];
|
|
30
32
|
|
|
@@ -3,12 +3,17 @@ import { doctorHasBlockingIssues, runLifecycleDoctor } from './doctor';
|
|
|
3
3
|
import { LifecycleGitService, type ILifecycleGitService } from './gitService';
|
|
4
4
|
import { runLifecycleInstall } from './install';
|
|
5
5
|
import { LifecycleNpmService, type ILifecycleNpmService } from './npmService';
|
|
6
|
+
import {
|
|
7
|
+
runOpenSpecCompatibilityMigration,
|
|
8
|
+
type OpenSpecCompatibilityMigrationResult,
|
|
9
|
+
} from './openSpecBootstrap';
|
|
6
10
|
import { getCurrentPumukiPackageName } from './packageInfo';
|
|
7
11
|
|
|
8
12
|
export type LifecycleUpdateResult = {
|
|
9
13
|
repoRoot: string;
|
|
10
14
|
targetSpec: string;
|
|
11
15
|
reinstallHooksChanged: ReadonlyArray<string>;
|
|
16
|
+
openSpecCompatibility: OpenSpecCompatibilityMigrationResult;
|
|
12
17
|
};
|
|
13
18
|
|
|
14
19
|
const resolveTargetSpec = (explicitSpec?: string): string => {
|
|
@@ -48,14 +53,20 @@ export const runLifecycleUpdate = (params?: {
|
|
|
48
53
|
npm.runNpm(installArgs, doctorReport.repoRoot);
|
|
49
54
|
|
|
50
55
|
try {
|
|
56
|
+
const openSpecCompatibility = runOpenSpecCompatibilityMigration({
|
|
57
|
+
repoRoot: doctorReport.repoRoot,
|
|
58
|
+
npm,
|
|
59
|
+
});
|
|
51
60
|
const installResult = runLifecycleInstall({
|
|
52
61
|
cwd: doctorReport.repoRoot,
|
|
53
62
|
git,
|
|
63
|
+
bootstrapOpenSpec: false,
|
|
54
64
|
});
|
|
55
65
|
return {
|
|
56
66
|
repoRoot: installResult.repoRoot,
|
|
57
67
|
targetSpec,
|
|
58
68
|
reinstallHooksChanged: installResult.changedHooks,
|
|
69
|
+
openSpecCompatibility,
|
|
59
70
|
};
|
|
60
71
|
} catch (error) {
|
|
61
72
|
if (currentDependency.spec) {
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { startEnterpriseMcpServer } from './enterpriseServer';
|
|
2
|
+
|
|
3
|
+
const parsedPort = Number.parseInt(process.env.PUMUKI_ENTERPRISE_MCP_PORT ?? '', 10);
|
|
4
|
+
const port = Number.isFinite(parsedPort) ? parsedPort : 7391;
|
|
5
|
+
const host = process.env.PUMUKI_ENTERPRISE_MCP_HOST ?? '127.0.0.1';
|
|
6
|
+
|
|
7
|
+
const started = startEnterpriseMcpServer({
|
|
8
|
+
host,
|
|
9
|
+
port,
|
|
10
|
+
});
|
|
11
|
+
|
|
12
|
+
process.stdout.write(`Pumuki MCP enterprise running at http://${started.host}:${started.port}\n`);
|