@hongmaple0820/scale-engine 0.13.0 → 0.14.0

package/dist/workflow/GovernanceLock.js

@@ -0,0 +1,58 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export function writeGovernanceLock(projectDir, input) {
+    const lock = {
+        version: 1,
+        scalePackage: '@hongmaple0820/scale-engine',
+        scaleVersion: input.scaleVersion,
+        pack: input.pack,
+        packVersion: input.packVersion,
+        generatedAt: new Date().toISOString(),
+        files: input.files
+            .filter(file => file.sha256 || existsSync(join(projectDir, file.path)))
+            .map(file => ({
+            path: file.path,
+            sha256: file.sha256 ?? hashFile(join(projectDir, file.path)),
+            owned: file.owned,
+        })),
+    };
+    const target = governanceLockPath(projectDir);
+    mkdirSync(dirname(target), { recursive: true });
+    writeFileSync(target, JSON.stringify(lock, null, 2) + '\n', 'utf-8');
+    return lock;
+}
+export function readGovernanceLock(projectDir) {
+    const target = governanceLockPath(projectDir);
+    if (!existsSync(target))
+        return null;
+    return JSON.parse(readFileSync(target, 'utf-8'));
+}
+export function computeGovernanceDrift(projectDir) {
+    const lock = readGovernanceLock(projectDir);
+    if (!lock)
+        return { lockExists: false, missing: [], changed: [], clean: [] };
+    const missing = [];
+    const changed = [];
+    const clean = [];
+    for (const entry of lock.files.filter(file => file.owned)) {
+        const target = join(projectDir, entry.path);
+        if (!existsSync(target)) {
+            missing.push(entry);
+            continue;
+        }
+        const current = hashFile(target);
+        if (current !== entry.sha256)
+            changed.push(entry);
+        else
+            clean.push(entry);
+    }
+    return { lockExists: true, missing, changed, clean };
+}
+export function governanceLockPath(projectDir) {
+    return join(projectDir, '.scale', 'governance.lock.json');
+}
+function hashFile(path) {
+    return createHash('sha256').update(readFileSync(path)).digest('hex');
+}
+//# sourceMappingURL=GovernanceLock.js.map

package/dist/workflow/GovernanceLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GovernanceLock.js","sourceRoot":"","sources":["../../src/workflow/GovernanceLock.ts"],"names":[],"mappings":"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"}

package/dist/workflow/GovernanceTemplatePacks.d.ts

@@ -0,0 +1,24 @@
+import type { GovernanceMode } from './GovernanceTemplates.js';
+import type { VerificationService } from './VerificationProfile.js';
+export type GovernancePackId = 'standard' | 'project-scaffold' | 'go-service-matrix' | 'node-library' | 'frontend-app';
+export interface GovernanceGeneratedFile {
+    path: string;
+    kind: 'doc' | 'template' | 'script' | 'config';
+    owned: boolean;
+    content: string;
+}
+export interface GovernancePackModeConfig {
+    artifactGate: 'off' | 'warn' | 'block';
+    skillRoutingMode: 'off' | 'warn' | 'block';
+}
+export interface GovernanceTemplatePack {
+    id: GovernancePackId;
+    version: number;
+    description: string;
+    modeDefaults: Record<GovernanceMode, GovernancePackModeConfig>;
+    defaultServices?: VerificationService[];
+    exclude?: string[];
+    generatedFiles: GovernanceGeneratedFile[];
+}
+export declare function listGovernanceTemplatePacks(): GovernanceTemplatePack[];
+export declare function resolveGovernanceTemplatePack(id: string | undefined): GovernanceTemplatePack;

package/dist/workflow/GovernanceTemplatePacks.js

@@ -0,0 +1,83 @@
+export function listGovernanceTemplatePacks() {
+    return PACKS;
+}
+export function resolveGovernanceTemplatePack(id) {
+    const normalized = (id || 'standard');
+    const pack = PACKS.find(candidate => candidate.id === normalized);
+    if (!pack) {
+        const supported = PACKS.map(candidate => candidate.id).join(', ');
+        throw new Error(`Unknown governance pack "${id}". Supported packs: ${supported}`);
+    }
+    return pack;
+}
+const modeDefaults = {
+    minimal: { artifactGate: 'off', skillRoutingMode: 'warn' },
+    standard: { artifactGate: 'warn', skillRoutingMode: 'warn' },
+    critical: { artifactGate: 'block', skillRoutingMode: 'block' },
+};
+const PACKS = [
+    {
+        id: 'standard',
+        version: 1,
+        description: 'Generic SCALE governance output.',
+        modeDefaults,
+        generatedFiles: [],
+    },
+    {
+        id: 'project-scaffold',
+        version: 1,
+        description: 'Reference project governance scaffold with workflow wrappers.',
+        modeDefaults,
+        generatedFiles: [
+            { path: 'scripts/workflow/new-task.sh', kind: 'script', owned: true, content: workflowWrapper('new-task', 'create-prd') },
+            { path: 'scripts/workflow/explore.sh', kind: 'script', owned: true, content: workflowWrapper('explore', 'skill scan') },
+            { path: 'scripts/workflow/resume.sh', kind: 'script', owned: true, content: workflowWrapper('resume', 'status') },
+            { path: 'scripts/workflow/verify.sh', kind: 'script', owned: true, content: workflowWrapper('verify', 'preflight') },
+            { path: 'scripts/gates/all.sh', kind: 'script', owned: true, content: workflowWrapper('gates/all', 'preflight --service all') },
+        ],
+    },
+    {
+        id: 'go-service-matrix',
+        version: 1,
+        description: 'Go multi-service repository governance.',
+        modeDefaults,
+        defaultServices: [
+            { name: 'netdisk', path: 'amdox-go-netdisk', type: 'go', required: true },
+            { name: 'auth', path: 'amdox-go-auth', type: 'go', required: true },
+            { name: 'gateway', path: 'amdox-go-gateway', type: 'go', required: true },
+        ],
+        exclude: ['OpenList', 'gfast', 'mcp-zero'],
+        generatedFiles: [],
+    },
+    {
+        id: 'node-library',
+        version: 1,
+        description: 'Node/npm library governance with build, test, diff, and pack checks.',
+        modeDefaults,
+        generatedFiles: [],
+    },
+    {
+        id: 'frontend-app',
+        version: 1,
+        description: 'Frontend app governance with UI and visual evidence requirements.',
+        modeDefaults,
+        generatedFiles: [],
+    },
+];
+function workflowWrapper(label, scaleCommand) {
+    return `#!/usr/bin/env bash
+set -euo pipefail
+
+run_scale() {
+  if command -v scale >/dev/null 2>&1; then
+    scale "$@"
+  else
+    npx @hongmaple0820/scale-engine@latest "$@"
+  fi
+}
+
+echo "[scale-engine] compatibility wrapper: scripts/${label}.sh -> scale ${scaleCommand}" >&2
+run_scale ${scaleCommand} "$@"
+`;
+}
+//# sourceMappingURL=GovernanceTemplatePacks.js.map

package/dist/workflow/GovernanceTemplatePacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GovernanceTemplatePacks.js","sourceRoot":"","sources":["../../src/workflow/GovernanceTemplatePacks.ts"],"names":[],"mappings":"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"}

package/dist/workflow/GovernanceTemplates.d.ts

@@ -1,8 +1,13 @@
+import { type GovernancePackId } from './GovernanceTemplatePacks.js';
+import type { VerificationService } from './VerificationProfile.js';
 export type GovernanceMode = 'minimal' | 'standard' | 'critical';
-export type GovernanceArtifactTemplateName = 'explore.md' | 'mini-prd.md' | 'skill-plan.md' | 'ui-spec.md' | 'visual-review.md' | 'api-contract.md' | 'security-review.md' | 'db-change-plan.md' | 'e2e-plan.md' | 'plan.md' | 'verification.md' | 'review.md' | 'summary.md';
+export type GovernanceArtifactTemplateName = 'explore.md' | 'mini-prd.md' | 'skill-plan.md' | 'skill-evidence.md' | 'ui-spec.md' | 'visual-review.md' | 'api-contract.md' | 'docs-impact.md' | 'security-review.md' | 'db-change-plan.md' | 'e2e-plan.md' | 'plan.md' | 'verification.md' | 'review.md' | 'summary.md';
 export interface GovernanceTemplateOptions {
     mode?: GovernanceMode;
     projectName?: string;
+    pack?: GovernancePackId | string;
+    services?: VerificationService[];
+    exclude?: string[];
 }
 export interface GovernanceTemplateResult {
     created: string[];