@ryuenn3123/agentic-senior-core 3.0.37 → 3.0.39

package/.agent-context/state/weekly-governance-report.json

@@ -1,329 +0,0 @@
-{
-  "generatedAt": "2026-04-25T09:59:20.980Z",
-  "reportName": "weekly-governance-report",
-  "methodology": {
-    "qualityTrendSource": "state-file",
-    "qualityTrendGeneratedAt": "2026-04-11T12:21:35.779Z",
-    "commitWindowDays": 7,
-    "requiredVerifiedDomains": [
-      "canonical-instructions",
-      "frontend-design-contract",
-      "frontend-architecture",
-      "backend-architecture",
-      "backend-security",
-      "backend-data-access",
-      "backend-error-handling",
-      "backend-api-contract",
-      "backend-testing",
-      "backend-performance",
-      "backend-idempotency",
-      "backend-risk-map",
-      "pr-checklist",
-      "architecture-review",
-      "mcp-server",
-      "state-continuity"
-    ]
-  },
-  "qualitySignals": {
-    "governanceHealth": {
-      "availableGateCount": 3,
-      "passedGateCount": 3,
-      "gatePassRatePercent": 100
-    },
-    "rejectionCategories": [],
-    "tokenEfficiency": {
-      "isAvailable": true,
-      "generatedAt": "2026-04-11T06:14:10.052Z",
-      "averageNativeSavingsPercent": 83.64,
-      "averageRtkSavingsPercent": 18.95,
-      "scenarioCount": 3
-    }
-  },
-  "skillTrust": {
-    "domains": [
-      {
-        "domain": "architecture-review",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/review-checklists/architecture-review.md"
-      },
-      {
-        "domain": "backend-api-contract",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/api-docs.md"
-      },
-      {
-        "domain": "backend-architecture",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/architecture.md"
-      },
-      {
-        "domain": "backend-data-access",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/database-design.md"
-      },
-      {
-        "domain": "backend-error-handling",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/error-handling.md"
-      },
-      {
-        "domain": "backend-idempotency",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/event-driven.md"
-      },
-      {
-        "domain": "backend-performance",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/performance.md"
-      },
-      {
-        "domain": "backend-risk-map",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/state/architecture-map.md"
-      },
-      {
-        "domain": "backend-security",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/security.md"
-      },
-      {
-        "domain": "backend-testing",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/testing.md"
-      },
-      {
-        "domain": "canonical-instructions",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".instructions.md"
-      },
-      {
-        "domain": "frontend-architecture",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/rules/frontend-architecture.md"
-      },
-      {
-        "domain": "frontend-design-contract",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/prompts/bootstrap-design.md"
-      },
-      {
-        "domain": "mcp-server",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": "scripts/mcp-server.mjs"
-      },
-      {
-        "domain": "pr-checklist",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/review-checklists/pr-checklist.md"
-      },
-      {
-        "domain": "state-continuity",
-        "tier": "verified",
-        "score": 100,
-        "sourcePath": ".agent-context/state"
-      }
-    ],
-    "tierCounts": {
-      "verified": 16,
-      "community": 0,
-      "experimental": 0
-    },
-    "requiredVerifiedDomains": [
-      "canonical-instructions",
-      "frontend-design-contract",
-      "frontend-architecture",
-      "backend-architecture",
-      "backend-security",
-      "backend-data-access",
-      "backend-error-handling",
-      "backend-api-contract",
-      "backend-testing",
-      "backend-performance",
-      "backend-idempotency",
-      "backend-risk-map",
-      "pr-checklist",
-      "architecture-review",
-      "mcp-server",
-      "state-continuity"
-    ],
-    "requiredVerifiedDomainFailures": [],
-    "allRequiredVerified": true
-  },
-  "backendGovernance": {
-    "status": "verified",
-    "summary": "Backend governance is verified across architecture, security, data access, error handling, API contracts, testing, performance, idempotency, and risk-map surfaces.",
-    "requiredSurfaceCount": 9,
-    "verifiedSurfaceCount": 9,
-    "missingSurfaceNames": [],
-    "coverage": [
-      {
-        "constraint": "Layered architecture and separation of concerns",
-        "status": "covered",
-        "sourcePaths": [
-          ".agent-context/rules/architecture.md",
-          ".agent-context/review-checklists/architecture-review.md"
-        ],
-        "signal": "Transport, application, domain, and infrastructure boundaries are explicit."
-      },
-      {
-        "constraint": "Global backend/API rule routing",
-        "status": "strengthened",
-        "sourcePaths": [
-          ".instructions.md",
-          ".agent-context/rules/architecture.md",
-          ".agent-context/prompts/refactor.md"
-        ],
-        "signal": "Backend/API governance routes by problem domain and stays stack-agnostic; no stack-specific governance adapters are created."
-      },
-      {
-        "constraint": "Zero-trust input validation",
-        "status": "strengthened",
-        "sourcePaths": [
-          ".agent-context/rules/security.md",
-          ".agent-context/review-checklists/pr-checklist.md"
-        ],
-        "signal": "User-controlled body, query, params, headers, cookies, files, webhooks, and job payloads must be validated before service logic."
-      },
-      {
-        "constraint": "Data access performance and integrity",
-        "status": "strengthened",
-        "sourcePaths": [
-          ".agent-context/rules/database-design.md",
-          ".agent-context/rules/performance.md",
-          ".agent-context/state/architecture-map.md"
-        ],
-        "signal": "Backend reads must avoid N+1 and unbounded list responses; multi-write mutations need transaction or recovery evidence."
-      },
-      {
-        "constraint": "Distributed consistency and outbox safety",
-        "status": "strengthened",
-        "sourcePaths": [
-          ".agent-context/rules/event-driven.md",
-          ".agent-context/rules/database-design.md",
-          ".agent-context/rules/microservices.md"
-        ],
-        "signal": "Dual-write flows need outbox or equivalent replay safety, and cross-service consistency must define saga, compensation, or recovery behavior instead of defaulting to two-phase commit."
-      },
-      {
-        "constraint": "Safe centralized API errors",
-        "status": "strengthened",
-        "sourcePaths": [
-          ".agent-context/rules/error-handling.md",
-          ".agent-context/rules/api-docs.md"
-        ],
-        "signal": "HTTP/API responses use safe machine-readable error shapes, may align with RFC 9457 Problem Details, and preserve safe trace/correlation identifiers without leaking internals."
-      },
-      {
-        "constraint": "Sensitive mutation idempotency",
-        "status": "strengthened",
-        "sourcePaths": [
-          ".agent-context/rules/api-docs.md",
-          ".agent-context/rules/testing.md",
-          ".agent-context/rules/event-driven.md"
-        ],
-        "signal": "Payments, orders, status changes, and other risky mutations must document and test duplicate-submit behavior."
-      },
-      {
-        "constraint": "API contract and behavior testing",
-        "status": "strengthened",
-        "sourcePaths": [
-          ".agent-context/rules/testing.md",
-          ".agent-context/review-checklists/pr-checklist.md"
-        ],
-        "signal": "API tests cover validation, auth, documented error shapes, pagination defaults, empty states, and mutation retry safety."
-      }
-    ],
-    "developmentFocus": [
-      {
-        "focus": "Keep backend guidance global and stack-agnostic.",
-        "reason": "The repo should enforce architecture, security, API, data, error, event, and testing thinking without building Nest, Laravel, FastAPI, Express, Go, or other stack-specific governance adapters."
-      },
-      {
-        "focus": "Use framework facts only when implementing inside an existing project.",
-        "reason": "LLMs can apply current ecosystem knowledge directly; governance should route the relevant global constraints instead of acting as a stack detector."
-      }
-    ]
-  },
-  "commitSignals": {
-    "windowDays": 7,
-    "commitCount": 30,
-    "releaseCommitCount": 18,
-    "rollbackCommitCount": 1,
-    "releaseFrequencyPercent": 60,
-    "rollbackFrequencyPercent": 3.33,
-    "error": null
-  },
-  "releaseReadiness": {
-    "isReady": true,
-    "blockers": [],
-    "summary": "Weekly governance posture is ready for maintenance releases with frontend and backend governance surfaces verified."
-  },
-  "artifact": {
-    "path": "E:\\Project\\Agentic-Senior-Core\\.agent-context\\state\\weekly-governance-report.json",
-    "writeMode": "stdout-and-file"
-  },
-  "history": [
-    {
-      "generatedAt": "2026-04-11T12:14:52.483Z",
-      "readinessStatus": "blocked",
-      "blockerCount": 1,
-      "gatePassRatePercent": 100,
-      "verifiedSkillDomainCount": 1,
-      "releaseFrequencyPercent": 38.89,
-      "rollbackFrequencyPercent": 5.56
-    },
-    {
-      "generatedAt": "2026-04-11T12:19:25.182Z",
-      "readinessStatus": "ready",
-      "blockerCount": 0,
-      "gatePassRatePercent": 100,
-      "verifiedSkillDomainCount": 5,
-      "releaseFrequencyPercent": 38.89,
-      "rollbackFrequencyPercent": 5.56
-    },
-    {
-      "generatedAt": "2026-04-11T12:21:37.776Z",
-      "readinessStatus": "ready",
-      "blockerCount": 0,
-      "gatePassRatePercent": 100,
-      "verifiedSkillDomainCount": 5,
-      "releaseFrequencyPercent": 38.89,
-      "rollbackFrequencyPercent": 5.56
-    },
-    {
-      "generatedAt": "2026-04-25T06:41:17.654Z",
-      "readinessStatus": "ready",
-      "blockerCount": 0,
-      "gatePassRatePercent": 100,
-      "verifiedSkillDomainCount": 16,
-      "backendVerifiedSurfaceCount": 9,
-      "releaseFrequencyPercent": 60,
-      "rollbackFrequencyPercent": 3.33
-    },
-    {
-      "generatedAt": "2026-04-25T09:59:20.980Z",
-      "readinessStatus": "ready",
-      "blockerCount": 0,
-      "gatePassRatePercent": 100,
-      "verifiedSkillDomainCount": 16,
-      "backendVerifiedSurfaceCount": 9,
-      "releaseFrequencyPercent": 60,
-      "rollbackFrequencyPercent": 3.33
-    }
-  ]
-}

package/lib/cli/compatibility.mjs

@@ -1,124 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { platform, version } from 'node:process';
-
-import { pathExists } from './utils.mjs';
-
-export const SKILL_COMPATIBILITY_MANIFEST_FILE_NAME = 'compatibility-manifest.json';
-
-export function getCurrentPlatformLabel() {
-  if (platform === 'win32') {
-    return 'windows';
-  }
-
-  if (platform === 'darwin') {
-    return 'macos';
-  }
-
-  return 'linux';
-}
-
-export function parseNodeMajorVersion(rawVersionString = version) {
-  const normalizedVersionString = String(rawVersionString || '').trim();
-  const numericVersion = normalizedVersionString.startsWith('v')
-    ? normalizedVersionString.slice(1)
-    : normalizedVersionString;
-
-  const majorSegment = numericVersion.split('.')[0];
-  const parsedMajorVersion = Number.parseInt(majorSegment, 10);
-  return Number.isNaN(parsedMajorVersion) ? null : parsedMajorVersion;
-}
-
-export function parseNodeMinimumMajor(rawNodeMinimum) {
-  const normalizedNodeMinimum = String(rawNodeMinimum || '').trim();
-  if (!normalizedNodeMinimum) {
-    return null;
-  }
-
-  const majorSegment = normalizedNodeMinimum.split('.')[0];
-  const parsedMajorVersion = Number.parseInt(majorSegment, 10);
-  return Number.isNaN(parsedMajorVersion) ? null : parsedMajorVersion;
-}
-
-export async function readSkillDomainCompatibilityManifest(targetDirectoryPath, skillDomainName) {
-  const compatibilityManifestPath = path.join(
-    targetDirectoryPath,
-    '.agent-context',
-    'skills',
-    skillDomainName,
-    SKILL_COMPATIBILITY_MANIFEST_FILE_NAME
-  );
-
-  if (!(await pathExists(compatibilityManifestPath))) {
-    return {
-      exists: false,
-      compatibilityManifestPath,
-      parsedManifest: null,
-    };
-  }
-
-  try {
-    const compatibilityManifestContent = await fs.readFile(compatibilityManifestPath, 'utf8');
-    return {
-      exists: true,
-      compatibilityManifestPath,
-      parsedManifest: JSON.parse(compatibilityManifestContent),
-    };
-  } catch (error) {
-    return {
-      exists: true,
-      compatibilityManifestPath,
-      parsedManifest: null,
-      parseError: error instanceof Error ? error.message : String(error),
-    };
-  }
-}
-
-export async function evaluateSkillDomainCompatibility(targetDirectoryPath, skillDomainNames) {
-  const uniqueSkillDomainNames = Array.from(new Set(skillDomainNames || []));
-  const compatibilityWarnings = [];
-
-  const currentPlatformLabel = getCurrentPlatformLabel();
-  const currentNodeMajorVersion = parseNodeMajorVersion(version);
-
-  for (const skillDomainName of uniqueSkillDomainNames) {
-    const manifestResult = await readSkillDomainCompatibilityManifest(targetDirectoryPath, skillDomainName);
-
-    if (!manifestResult.exists) {
-      compatibilityWarnings.push(
-        `Domain ${skillDomainName} has no ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}; compatibility cannot be verified.`
-      );
-      continue;
-    }
-
-    if (!manifestResult.parsedManifest) {
-      compatibilityWarnings.push(
-        `Domain ${skillDomainName} has invalid ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}: ${manifestResult.parseError || 'Unknown parse error'}.`
-      );
-      continue;
-    }
-
-    const manifestPlatforms = Array.isArray(manifestResult.parsedManifest.platforms)
-      ? manifestResult.parsedManifest.platforms
-      : [];
-
-    if (manifestPlatforms.length > 0 && !manifestPlatforms.includes(currentPlatformLabel)) {
-      compatibilityWarnings.push(
-        `Domain ${skillDomainName} does not list platform ${currentPlatformLabel} in ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}.`
-      );
-    }
-
-    const minimumNodeMajorVersion = parseNodeMinimumMajor(manifestResult.parsedManifest.nodeMin);
-    if (
-      typeof minimumNodeMajorVersion === 'number'
-      && typeof currentNodeMajorVersion === 'number'
-      && currentNodeMajorVersion < minimumNodeMajorVersion
-    ) {
-      compatibilityWarnings.push(
-        `Domain ${skillDomainName} requires Node.js >= ${minimumNodeMajorVersion}, current major version is ${currentNodeMajorVersion}.`
-      );
-    }
-  }
-
-  return compatibilityWarnings;
-}

package/scripts/validate-evidence-bundle.mjs

@@ -1,76 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-
-/**
- * Validates the structure and content of an evidence bundle for an artifact.
- * Target artifact directory must be provided as an argument.
- */
-export async function validateEvidenceBundle(artifactPath) {
-  const evidenceDirPath = path.join(artifactPath, '.evidence');
-  
-  try {
-    const stats = await fs.stat(evidenceDirPath);
-    if (!stats.isDirectory()) {
-       return { passed: false, error: '.evidence is not a directory' };
-    }
-   } catch {
-    return { passed: false, error: 'Missing .evidence directory' };
-  }
-
-  const requiredFiles = [
-    'compatibility-manifest.json',
-    'test-report.json',
-    'sbom-excerpt.json'
-  ];
-
-  for (const fileName of requiredFiles) {
-    try {
-       await fs.stat(path.join(evidenceDirPath, fileName));
-    } catch {
-       return { passed: false, error: `Missing required evidence file: ${fileName}` };
-    }
-  }
-
-  // Validate compatibility manifest structure
-  try {
-     const manifestData = JSON.parse(await fs.readFile(path.join(evidenceDirPath, 'compatibility-manifest.json'), 'utf8'));
-     if (!manifestData.ides || !Array.isArray(manifestData.ides)) {
-        return { passed: false, error: 'compatibility-manifest.json is missing the "ides" array' };
-     }
-  } catch (err) {
-     return { passed: false, error: `Invalid compatibility-manifest.json: ${err.message}` };
-  }
-
-  // Validate test report structure
-  try {
-     const testReportData = JSON.parse(await fs.readFile(path.join(evidenceDirPath, 'test-report.json'), 'utf8'));
-     if (typeof testReportData.passed !== 'boolean' || typeof testReportData.total !== 'number') {
-        return { passed: false, error: 'test-report.json must contain boolean "passed" and numeric "total"' };
-     }
-  } catch (err) {
-     return { passed: false, error: `Invalid test-report.json: ${err.message}` };
-  }
-
-  return { passed: true, error: null };
-}
-
-// Allow CLI usage
-if (process.argv[1] && process.argv[1] === new URL(import.meta.url).pathname || process.argv[1] === import.meta.filename) {
-    const targetDir = process.argv[2];
-    if (!targetDir) {
-        console.error('Usage: node validate-evidence-bundle.mjs <target-directory>');
-        process.exit(1);
-    }
-    
-    validateEvidenceBundle(path.resolve(targetDir))
-        .then(result => {
-             if (result.passed) {
-                 console.log('[OK] Evidence bundle is valid.');
-                 process.exit(0);
-             } else {
-                 console.error(`[FAIL] Evidence bundle validation failed: ${result.error}`);
-                 process.exit(1);
-             }
-        })
-        .catch(console.error);
-}