@hongmaple0820/scale-engine 0.12.3 → 0.13.0

package/dist/skills/routing/index.d.ts

@@ -0,0 +1,5 @@
+export * from './SkillRoutingTypes.js';
+export * from './SkillPolicy.js';
+export * from './TaskIntentClassifier.js';
+export * from './SkillPlanner.js';
+export * from './SkillGate.js';

package/dist/skills/routing/index.js

@@ -0,0 +1,6 @@
+export * from './SkillRoutingTypes.js';
+export * from './SkillPolicy.js';
+export * from './TaskIntentClassifier.js';
+export * from './SkillPlanner.js';
+export * from './SkillGate.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/routing/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}

package/dist/workflow/GovernanceTemplates.d.ts

@@ -0,0 +1,12 @@
+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 interface GovernanceTemplateOptions {
+    mode?: GovernanceMode;
+    projectName?: string;
+}
+export interface GovernanceTemplateResult {
+    created: string[];
+    skipped: string[];
+}
+export declare function writeGovernanceTemplates(projectDir?: string, options?: GovernanceTemplateOptions): GovernanceTemplateResult;
+export declare function governanceTemplateContent(name: GovernanceArtifactTemplateName): string;

package/dist/workflow/GovernanceTemplates.js

@@ -0,0 +1,515 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { skillRoutingPolicyTemplate } from '../skills/routing/SkillPolicy.js';
+export function writeGovernanceTemplates(projectDir = process.cwd(), options = {}) {
+    const mode = options.mode ?? 'standard';
+    const projectName = options.projectName ?? 'Project';
+    const result = { created: [], skipped: [] };
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'README.md'), workflowReadme(projectName, mode));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'explore.md'), governanceTemplateContent('explore.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'mini-prd.md'), governanceTemplateContent('mini-prd.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'skill-plan.md'), governanceTemplateContent('skill-plan.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'ui-spec.md'), governanceTemplateContent('ui-spec.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'visual-review.md'), governanceTemplateContent('visual-review.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'api-contract.md'), governanceTemplateContent('api-contract.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'security-review.md'), governanceTemplateContent('security-review.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'db-change-plan.md'), governanceTemplateContent('db-change-plan.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'e2e-plan.md'), governanceTemplateContent('e2e-plan.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'plan.md'), governanceTemplateContent('plan.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'verification.md'), governanceTemplateContent('verification.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'review.md'), governanceTemplateContent('review.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'summary.md'), governanceTemplateContent('summary.md'));
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'github-actions-scale-preflight.yml'), githubActionsPreflightTemplate());
+    writeIfMissing(result, join(projectDir, 'docs', 'workflow', 'templates', 'pre-push-scale-preflight.sh'), prePushPreflightTemplate());
+    writeIfMissing(result, join(projectDir, 'docs', 'worklog', 'metrics.md'), metricsTemplate());
+    writeIfMissing(result, join(projectDir, '.scale', 'verification.json'), verificationMatrixTemplate(mode));
+    writeIfMissing(result, join(projectDir, '.scale', 'skills.json'), skillRoutingPolicyTemplate(mode));
+    return result;
+}
+export function governanceTemplateContent(name) {
+    switch (name) {
+        case 'explore.md': return exploreTemplate();
+        case 'mini-prd.md': return miniPrdTemplate();
+        case 'skill-plan.md': return skillPlanTemplate();
+        case 'ui-spec.md': return uiSpecTemplate();
+        case 'visual-review.md': return visualReviewTemplate();
+        case 'api-contract.md': return apiContractTemplate();
+        case 'security-review.md': return securityReviewTemplate();
+        case 'db-change-plan.md': return dbChangePlanTemplate();
+        case 'e2e-plan.md': return e2ePlanTemplate();
+        case 'plan.md': return planTemplate();
+        case 'verification.md': return verificationTemplate();
+        case 'review.md': return reviewTemplate();
+        case 'summary.md': return summaryTemplate();
+    }
+}
+function writeIfMissing(result, path, content) {
+    if (existsSync(path)) {
+        result.skipped.push(path);
+        return;
+    }
+    const dir = path.split(/[\\/]/).slice(0, -1).join('/');
+    if (dir && !existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, content, 'utf-8');
+    result.created.push(path);
+}
+function workflowReadme(projectName, mode) {
+    return `# ${projectName} Workflow
+
+Governance mode: ${mode}
+
+## Task Levels
+
+| Level | Use for | Required artifacts |
+| --- | --- | --- |
+| S | typo, comments, small local edits | relevant validation only |
+| M | bug fixes, new APIs, 2-5 files | explore, skill plan, plan, verification, review, summary |
+| L | cross-module or architecture changes | full artifacts plus human confirmation |
+| CRITICAL | auth, permissions, migrations, production config | rollback plan, security review, full verification |
+
+## Standard Task Directory
+
+\`\`\`text
+docs/worklog/tasks/<yyyy-mm-dd>-<task-slug>/
+├── explore.md
+├── mini-prd.md
+├── plan.md
+├── verification.md
+├── review.md
+└── summary.md
+\`\`\`
+
+## Verification
+
+Use service-aware verification when configured:
+
+\`\`\`bash
+scale preflight --service all
+scale verify <task-id> --profile default
+scale verify <task-id> --service <service-name>
+scale verify <task-id> --artifact-gate warn
+scale verify <task-id> --artifact-gate block
+scale task-artifacts check --dir docs/worklog/tasks/<task-dir> --level L
+\`\`\`
+
+Keep \`.scale/verification.json\` as the source of truth for profiles and service commands.
+Keep \`.scale/skills.json\` as the source of truth for active skill routing policy.
+Use \`artifactGate: "warn"\` while introducing the workflow, then move M/L/CRITICAL work to \`"block"\` once templates and local gates are stable.
+
+## Automation Templates
+
+Optional automation templates are generated under \`docs/workflow/templates/\`:
+
+- \`github-actions-scale-preflight.yml\`: CI workflow that runs \`scale preflight --service all\`.
+- \`pre-push-scale-preflight.sh\`: local pre-push hook template for the same checks.
+
+Keep these templates advisory until \`scale preflight --service all\` is reliable locally for the project.
+`;
+}
+function exploreTemplate() {
+    return `# Explore
+
+## Files Read
+
+- 
+
+## Current Behavior
+
+
+## Main Conflict
+
+
+## Affected Modules
+
+
+## Evidence
+
+
+`;
+}
+function miniPrdTemplate() {
+    return `# Mini-PRD
+
+## Background
+
+
+## Target Users
+
+
+## Core Scenario
+
+
+## Non-Goals
+
+
+## User Path
+
+
+## Permission Rules
+
+
+## Data Impact
+
+
+## Exception Scenarios
+
+1. 
+2. 
+3. 
+
+## Acceptance Criteria
+
+- [ ] 
+
+## Rollback Or Disable Strategy
+
+
+`;
+}
+function skillPlanTemplate() {
+    return `# Skill Plan
+
+## Detected Intents
+
+| Domain | Score | Evidence |
+| --- | ---: | --- |
+|  |  |  |
+
+## Required Skills
+
+- 
+
+## Recommended Skills
+
+- 
+
+## Required Artifacts
+
+- 
+
+## Required Verification Evidence
+
+- 
+
+## Skipped Skills
+
+| Skill | Reason | Fallback Evidence |
+| --- | --- | --- |
+|  |  |  |
+`;
+}
+function uiSpecTemplate() {
+    return `# UI Spec
+
+## User Goal
+
+
+## Primary Flow
+
+
+## Interaction States
+
+- Default:
+- Loading:
+- Empty:
+- Error:
+- Success:
+
+## Responsive Behavior
+
+
+## Accessibility Requirements
+
+
+## Acceptance Criteria
+
+- [ ] 
+`;
+}
+function visualReviewTemplate() {
+    return `# Visual Review
+
+## Screenshots Or Evidence
+
+
+## Layout And Responsiveness
+
+
+## Text Fit And Overlap
+
+
+## Accessibility Notes
+
+
+## Final Verdict
+
+
+`;
+}
+function apiContractTemplate() {
+    return `# API Contract
+
+## Endpoint Or Interface
+
+
+## Request
+
+
+## Response
+
+
+## Errors
+
+
+## Permission Rules
+
+
+## Compatibility Notes
+
+
+## Acceptance Criteria
+
+- [ ] 
+`;
+}
+function securityReviewTemplate() {
+    return `# Security Review
+
+## Assets And Trust Boundaries
+
+
+## Authorization Rules
+
+
+## Abuse Cases
+
+1. 
+2. 
+3. 
+
+## Sensitive Data Impact
+
+
+## Rollback Or Disable Strategy
+
+
+## Final Verdict
+
+
+`;
+}
+function dbChangePlanTemplate() {
+    return `# DB Change Plan
+
+## Schema Or Data Change
+
+
+## Backward Compatibility
+
+
+## Migration Steps
+
+
+## Rollback Plan
+
+
+## Verification
+
+
+`;
+}
+function e2ePlanTemplate() {
+    return `# E2E Plan
+
+## User Paths
+
+
+## Browser Coverage
+
+
+## Test Data
+
+
+## Assertions
+
+
+## Evidence
+
+
+`;
+}
+function planTemplate() {
+    return `# Plan
+
+## Approach
+
+
+## Boundaries
+
+
+## Exception Contract
+
+1. 
+2. 
+3. 
+
+## Rollback Plan
+
+
+## Test Strategy
+
+
+`;
+}
+function verificationTemplate() {
+    return `# Verification
+
+## Commands Run
+
+| Command | Result | Notes |
+| --- | --- | --- |
+|  |  |  |
+
+## Output Summary
+
+
+## Failures And Fixes
+
+
+## Final Status
+
+
+`;
+}
+function reviewTemplate() {
+    return `# Review
+
+## Code Review
+
+
+## Security Review
+
+
+## Same-Pattern Scan
+
+
+## Residual Risks
+
+
+`;
+}
+function summaryTemplate() {
+    return `# Summary
+
+## Delivered Changes
+
+
+## Remaining Risks
+
+
+## Follow-Ups
+
+
+## Metric Row
+
+| Date | Task | Level | Services | Files Changed | First Verification Pass | Fix Iterations | Artifact Complete | Residual Risk | Final Gate |
+| --- | --- | --- | --- | ---: | --- | ---: | --- | --- | --- |
+|  |  |  |  |  |  |  |  |  |  |
+`;
+}
+function metricsTemplate() {
+    return `# Workflow Metrics
+
+<!-- SCALE_METRICS:START -->
+| Date | Task | Level | Services | Files Changed | First Verification Pass | Fix Iterations | Rework Needed | Artifact Complete | Residual Risk | Final Gate |
+| --- | --- | --- | --- | ---: | --- | ---: | --- | --- | --- | --- |
+|  |  |  |  |  |  |  |  |  |  |  |
+<!-- SCALE_METRICS:END -->
+
+## Monthly Review
+
+### Repeated Failure Patterns
+
+
+### Slowest Gates
+
+
+### Documentation Gaps
+
+
+### Product Design Misses
+
+
+### Proposed Workflow Changes
+
+
+`;
+}
+function verificationMatrixTemplate(mode) {
+    return JSON.stringify({
+        version: 1,
+        defaultProfile: 'default',
+        profiles: {
+            default: {
+                commands: {},
+                services: [],
+            },
+        },
+        services: [],
+        exclude: ['node_modules', 'dist', 'tmp', 'vendor'],
+        policy: {
+            mode,
+            optionalToolsWarnOnly: true,
+            artifactGate: mode === 'critical' ? 'block' : 'warn',
+            artifactGateLevels: ['M', 'L', 'CRITICAL'],
+        },
+    }, null, 2) + '\n';
+}
+function githubActionsPreflightTemplate() {
+    return `name: SCALE Preflight
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - master
+
+jobs:
+  preflight:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install project dependencies when present
+        shell: bash
+        run: |
+          if [ -f package-lock.json ]; then
+            npm ci
+          elif [ -f package.json ]; then
+            npm install
+          fi
+
+      - name: Run SCALE preflight
+        run: npx @hongmaple0820/scale-engine@latest preflight --service all
+`;
+}
+function prePushPreflightTemplate() {
+    return `#!/usr/bin/env sh
+set -eu
+
+if command -v scale >/dev/null 2>&1; then
+  scale preflight --service all
+else
+  npx @hongmaple0820/scale-engine@latest preflight --service all
+fi
+`;
+}
+//# sourceMappingURL=GovernanceTemplates.js.map

package/dist/workflow/GovernanceTemplates.js.map

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

package/dist/workflow/PhaseMarkerTracker.d.ts

@@ -0,0 +1,63 @@
+export type ScalePhase = 'DEFINE' | 'PLAN' | 'EXECUTE' | 'VERIFY' | 'REVIEW' | 'SHIP';
+export interface PhaseStatus {
+    completed: boolean;
+    marker?: string;
+    details?: Record<string, string>;
+    timestamp?: number;
+}
+export interface PhaseState {
+    DEFINE: PhaseStatus;
+    PLAN: PhaseStatus;
+    EXECUTE: PhaseStatus;
+    VERIFY: PhaseStatus;
+    REVIEW: PhaseStatus;
+    SHIP: PhaseStatus;
+}
+export declare class PhaseMarkerTracker {
+    private stateDir;
+    private stateFile;
+    constructor(scaleDir?: string);
+    private ensureDir;
+    /**
+     * 解析文本中的所有 Output Markers 并更新状态
+     * @param text 包含 markers 的文本（对话输出）
+     * @returns 本次解析出的 markers 数量
+     */
+    parseAndUpdate(text: string): number;
+    /**
+     * 解析文本中的所有 Output Markers
+     * @returns 解析结果 Map<Phase, PhaseStatus>
+     */
+    parseMarkers(text: string): Partial<Record<ScalePhase, PhaseStatus>>;
+    /** 获取当前 Phase 状态 */
+    getState(): PhaseState;
+    /** 手动标记 Phase 完成 */
+    markComplete(phase: ScalePhase, details?: Record<string, string>): void;
+    /** 重置 Phase 状态 */
+    resetPhase(phase: ScalePhase): void;
+    /** 重置所有状态 */
+    resetAll(): void;
+    /** 检查单个 Phase 是否完成 */
+    isPhaseComplete(phase: ScalePhase): boolean;
+    /** 检查所有必需 Phase 是否完成 */
+    isAllComplete(): boolean;
+    /** 获取缺失的 Phase 列表 */
+    getMissingPhases(): ScalePhase[];
+    /** 获取已完成的 Phase 列表 */
+    getCompletedPhases(): ScalePhase[];
+    /** 生成状态报告 */
+    generateReport(): string;
+    /** 生成 Stop Hook 检查结果 */
+    generateStopHookResult(): {
+        pass: boolean;
+        message: string;
+        missing: string[];
+    };
+    private createDefaultState;
+    private writeState;
+}
+/** 快速解析单个 marker 行（供 CLI 和 Hook 使用） */
+export declare function parsePhaseMarker(line: string): {
+    phase: ScalePhase;
+    details: Record<string, string>;
+} | null;